${esc(baseName)} — API Documentation

{ "edges": [ { "to": "8655873a-3376-45e4-8311-68a646570e47", "from": "e74de2b2-e2bf-4e9f-b191-e703a914cb15", "toPort": "0", "fromPort": "0" }, { "to": "0b63f327-e409-4fe9-8716-bf4d53697441", "from": "f7a197b7-3470-4ad5-a2bb-fa913c461969", "toPort": "0", "fromPort": "0" }, { "to": "e350754f-4db4-407b-a6d0-ce199df685bd", "from": "477c9a71-e6b8-4125-8dca-9987320fda1a", "toPort": "0", "fromPort": "0" }, { "to": "8e43b277-9554-43e2-bc04-db84eadb6b51", "from": "8655873a-3376-45e4-8311-68a646570e47", "toPort": "0", "fromPort": "0" }, { "to": "f7a197b7-3470-4ad5-a2bb-fa913c461969", "from": "f463a4fa-5996-4e9d-8f10-bc2f9c54d4ad", "toPort": "0", "fromPort": "0" }, { "to": "b2362399-2709-42d6-a294-5d834562a4b7", "from": "14c89229-0249-4e47-a46c-1480e961b59c", "toPort": "0", "fromPort": "0" }, { "to": "b2362399-2709-42d6-a294-5d834562a4b7", "from": "0b63f327-e409-4fe9-8716-bf4d53697441", "toPort": "0", "fromPort": "0" }, { "to": "14c89229-0249-4e47-a46c-1480e961b59c", "from": "f63de4ea-6d88-4f10-a195-feb2f7b5f3ea", "toPort": "0", "fromPort": "0" }, { "to": "477c9a71-e6b8-4125-8dca-9987320fda1a", "from": "b2362399-2709-42d6-a294-5d834562a4b7", "toPort": "0", "fromPort": "0" }, { "to": "e74de2b2-e2bf-4e9f-b191-e703a914cb15", "from": "b2362399-2709-42d6-a294-5d834562a4b7", "toPort": "0", "fromPort": "1" }, { "to": "f463a4fa-5996-4e9d-8f10-bc2f9c54d4ad", "from": "8e43b277-9554-43e2-bc04-db84eadb6b51", "toPort": "0", "fromPort": "0" }, { "to": "f63de4ea-6d88-4f10-a195-feb2f7b5f3ea", "from": "a0edb4ab-f3e6-4ff0-be75-a7ef3d6bfb39", "toPort": "0", "fromPort": "0" } ], "nodes": [ { "id": "8655873a-3376-45e4-8311-68a646570e47", "name": "Extract from File2", "type": "passthrough", "params": { "mode": "noOp", "options": {}, "operation": "text" }, "position": [ -208, 544 ] }, { "id": "a0edb4ab-f3e6-4ff0-be75-a7ef3d6bfb39", "name": "When clicking ‘Execute workflow’", "type": "manualTrigger", "params": {}, "position": [ -1520, 448 ] }, { "id": "f63de4ea-6d88-4f10-a195-feb2f7b5f3ea", "name": "Get all files from folder", "type": "integration", "params": { "filter": {}, "options": {}, "service": "googleDrive", "resource": "fileFolder", "operation": "read", "returnAll": true, "queryString": "'YOUR_FOLDER_ID' in parents and trashed=false", "searchMethod": "query" }, "position": [ -1328, 448 ] }, { "id": "14c89229-0249-4e47-a46c-1480e961b59c", "name": "Filter .h files only", "type": "code", "params": { "jsCode": "const items = $input.all();\nconst results = [];\nfor (const item of items) {\n const name = (item.json.name || '').toLowerCase();\n if (name.endsWith('.h')) {\n results.push({ json: { id: item.json.id, fileName: item.json.name } });\n }\n}\nif (results.length === 0) throw new Error('No .h header files found.');\nreturn results;" }, "position": [ -1104, 448 ] }, { "id": "b2362399-2709-42d6-a294-5d834562a4b7", "name": "Process one file at a time", "type": "passthrough", "params": { "mode": "noOp", "options": {} }, "position": [ -768, 528 ] }, { "id": "e74de2b2-e2bf-4e9f-b191-e703a914cb15", "name": "Download file", "type": "integration", "params": { "fileId": { "__rl": true, "mode": "", "value": "={{ $json.id }}" }, "options": {}, "service": "googleDrive", "operation": "download" }, "position": [ -432, 544 ] }, { "id": "477c9a71-e6b8-4125-8dca-9987320fda1a", "name": "Build email body", "type": "code", "params": { "jsCode": "const items = $input.all();\nfor (const item of items) {\n const fileName = item.json.pdfName || item.json.name || 'DOC.pdf';\n item.json.subject = 'API Documentation PDF Ready — XYZ Technologies';\n item.json.message = `Hello,\n\nYour C header file API documentation PDF has been generated by XYZ Technologies.\n\nFile: ${fileName}\nUploaded to: Output folder in Google Drive\nGenerated: ${new Date().toUTCString()}\n\nThe PDF includes:\n - Overview\n - Functions (signatures, parameters, return values, examples)\n - Enumerators\n - Data Types & Structures\n - Constants\n - Notes\n\nBest regards,\nXYZ Technologies Automation`;\n}\nreturn items;" }, "position": [ -400, 160 ] }, { "id": "e350754f-4db4-407b-a6d0-ce199df685bd", "name": "Send completion email", "type": "integration", "params": { "sendTo": "your@email.com", "message": "={{ $json.message }}", "options": {}, "service": "gmail", "subject": "={{ $json.subject }}", "operation": "read" }, "position": [ -192, 160 ] }, { "id": "8e43b277-9554-43e2-bc04-db84eadb6b51", "name": "Extract structured docs (GPT-4o)", "type": "llm", "params": { "modelId": { "__rl": true, "mode": "list", "value": "gpt-4o", "cachedResultName": "GPT-4O" }, "options": {}, "provider": "openai", "responses": { "values": [ { "role": "system", "content": "You are a senior technical writer for embedded systems at XYZ Technologies. Given a C header (.h) file, extract and document everything as strict JSON — no markdown, no explanation, raw JSON only.\n\nReturn exactly this structure:\n{\n \"overview\": \"<2-3 sentence summary>\",\n \"functions\": [\n {\n \"name\": \"\",\n \"signature\": \"\",\n \"description\": \"\",\n \"parameters\": [\n { \"name\": \"\", \"type\": \"\", \"description\": \"\" }\n ],\n \"returns\": \"\",\n \"example\": \"\"\n }\n ],\n \"enumerators\": [\n {\n \"name\": \"\",\n \"description\": \"\",\n \"values\": [\n { \"name\": \"\", \"value\": \"\", \"description\": \"\" }\n ]\n }\n ],\n \"data_types\": [\n {\n \"name\": \"\",\n \"kind\": \"\",\n \"description\": \"\",\n \"members\": [\n { \"name\": \"\", \"type\": \"\", \"description\": \"\" }\n ]\n }\n ],\n \"constants\": [\n { \"name\": \"\", \"value\": \"\", \"description\": \"\" }\n ],\n \"notes\": \"\"\n}\n\nIf a section has no items return []. Return ONLY the JSON object." }, { "content": "=File: {{ $('Process one file at a time').item.json.fileName }}\n\n{{ $('Extract from File2').item.json.data }}" } ] }, "builtInTools": {} }, "position": [ 16, 544 ] }, { "id": "f463a4fa-5996-4e9d-8f10-bc2f9c54d4ad", "name": "Parse JSON response", "type": "code", "params": { "jsCode": "// ── Parse JSON response — handles all known OpenAI/n8n response shapes ──────\nconst item = $input.first();\n\n// Log the full response so you can inspect it in n8n's output panel\n// (remove once working)\nconsole.log('RAW ITEM KEYS:', JSON.stringify(Object.keys(item.json || {})));\n\nconst raw =\n // n8n OpenAI node (AI Agent / Chat Model)\n item.json?.choices?.[0]?.message?.content ||\n // OpenAI Responses API shape\n item.json?.output?.[0]?.content?.[0]?.text ||\n // Fallback: sometimes n8n wraps it under .text or .message\n item.json?.message?.content ||\n item.json?.text ||\n // Last resort: if the whole json IS the parsed object already\n (item.json?.overview ? JSON.stringify(item.json) : '{}');\n\nlet parsed;\ntry {\n const cleaned = raw\n .replace(/^```(?:json)?\\r?\\n?/, '')\n .replace(/\\r?\\n?```$/, '')\n .trim();\n parsed = JSON.parse(cleaned);\n} catch (e) {\n // If JSON parse fails, put the raw text in overview so you can see what GPT returned\n parsed = {\n overview: 'JSON parse failed. Raw response: ' + raw.slice(0, 500),\n functions: [],\n enumerators: [],\n data_types: [],\n constants: [],\n notes: ''\n };\n}\n\n// Try multiple places for fileName\nconst fileName =\n $('Process one file at a time')?.item?.json?.fileName ||\n $('Process one file at a time1')?.item?.json?.fileName ||\n item.json?.fileName ||\n 'unknown.h';\n\nreturn [{ json: { ...parsed, fileName } }];\n" }, "position": [ 352, 544 ] }, { "id": "f7a197b7-3470-4ad5-a2bb-fa913c461969", "name": "Generate HTML", "type": "code", "params": { "jsCode": "// ═══════════════════════════════════════════════════════════════════════════\n// GENERATE HTML FILE — outputs binary HTML file → save directly to Google Drive\n// Replace \"Generate PDF (zero dependencies)1\" with this node.\n// Then wire: this node → Save to Google Drive (upload file)\n// ═══════════════════════════════════════════════════════════════════════════\n\nconst doc = $input.first().json;\nconst fileName = doc.fileName || 'unknown.h';\nconst baseName = fileName.replace(/\\.[^/.]+$/, '');\nconst htmlName = 'DOC_' + baseName + '.html';\nconst today = new Date().toISOString().slice(0, 10);\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\nconst esc = s => String(s || '')\n .replace(/&/g,'&').replace(//g,'>');\n\nfunction funcBlock(fn) {\n const params = fn.parameters || [];\n const paramRows = params.map(p => `\n \n ${esc(p.name)}\n ${esc(p.type)}\n ${esc(p.description)}\n `).join('');\n\n return `\n

${esc(fn.name || '')}

${esc(fn.description || '')}

\n ${fn.signature ? `

Signature

${esc(fn.signature)}

` : ''}\n ${params.length ? `\n

Parameters

\n \n ${paramRows}\n

Parameter	Type	Description

` : ''}\n ${fn.returns ? `

Returns

${esc(fn.returns)}

` : ''}\n ${fn.example ? `

Example

${esc(fn.example)}

` : ''}\n

`;\n}\n\nfunction dtBlock(dt) {\n const members = dt.members || [];\n const rows = members.map(m => `\n \n ${esc(m.name)}\n ${esc(m.type)}\n ${esc(m.description)}\n `).join('');\n return `\n

${esc(dt.name || '')} ${esc(dt.kind || '')}

${esc(dt.description || '')}

\n ${members.length ? `\n

Members

\n \n ${rows}\n

Member	Type	Description

` : ''}\n

`;\n}\n\nfunction enumBlock(en) {\n const vals = en.values || [];\n const rows = vals.map(v => `\n \n ${esc(v.name)}\n ${esc(v.value)}\n ${esc(v.description)}\n `).join('');\n return `\n

${esc(en.name || '')}

${esc(en.description || '')}

\n ${vals.length ? `\n

\n \n ${rows}\n

Enumerator	Value	Description

` : ''}\n

`;\n}\n\nconst fns = doc.functions || [];\nconst enums = doc.enumerators || [];\nconst dts = doc.data_types || [];\nconst consts = doc.constants || [];\n\nconst empty = label => `

No ${label} found in this header file.

`;\n\nconst fnHtml = fns.length ? fns.map(funcBlock).join('') : empty('functions');\nconst enumHtml = enums.length ? enums.map(enumBlock).join('') : empty('enumerators');\nconst dtHtml = dts.length ? dts.map(dtBlock).join('') : empty('data types');\nconst constHtml = consts.length ? `\n

\n \n ${consts.map(c=>``).join('')}\n

Constant Name	Value	Description
`${esc(c.name)}`	${esc(c.value)}	${esc(c.description)}

` : empty('constants');\n\nconst tocItems = [\n ['1','Overview'],['2','Functions'],['3','Enumerators'],\n ['4','Data Types & Structures'],['5','Constants'],['6','Notes']\n];\n\nconst html = `\n\n\n\n\n${esc(baseName)} — API Documentation\n\n\n\n\n\n\n\n\n\n\n

\n\n \n \n\n \n

XYZ Technologies · Header File Documentation

${esc(baseName.toUpperCase())}

C Embedded Systems Interface Reference

Source${esc(fileName)}

Prepared byXYZ Technologies

Date${today}

Version1.0

ClassificationInternal

\n\n \n

\n 01\n Overview\n

${esc(doc.overview || 'No overview available.')}

\n\n \n

\n 02\n Functions\n

\n ${fnHtml}\n

\n\n \n

\n 03\n Enumerators\n

\n ${enumHtml}\n

\n\n \n

\n 04\n Data Types & Structures\n

\n ${dtHtml}\n

\n\n \n

\n 05\n Constants\n

\n ${constHtml}\n

\n\n \n

\n 06\n Notes\n

${esc(doc.notes || 'No additional notes.')}

This document was automatically generated by XYZ Technologies.

\n\n

\n\n\n`;\n\n// Convert HTML string to base64 binary for Google Drive upload\nconst b64 = Buffer.from(html, 'utf8').toString('base64');\n\nreturn [{\n json: {\n htmlName,\n fileName,\n timestamp: today\n },\n binary: {\n data: {\n data: b64,\n mimeType: 'text/html',\n fileName: htmlName,\n fileExtension: 'html'\n }\n }\n}];\n" }, "position": [ 608, 544 ] }, { "id": "0b63f327-e409-4fe9-8716-bf4d53697441", "name": "Save PDF to Google Drive", "type": "integration", "params": { "name": "={{ $json.pdfName }}", "driveId": { "__rl": true, "mode": "list", "value": "MyDrive" }, "options": {}, "service": "googleDrive", "folderId": { "__rl": true, "mode": "id", "value": "YOUR_OUTPUT_FOLDER_ID" }, "operation": "read" }, "position": [ 928, 544 ] } ] }

Generate C API HTML docs from Google Drive headers with GPT-4o and Gmail