n8n-nodes-emboss 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emboss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# n8n-nodes-emboss
+
+An [n8n](https://n8n.io) community node for [Emboss](https://getemboss.ai) — turn flat PDFs into fillable forms and fill them from context.
+
+## Operations
+- **Create Fillable Form** — a flat PDF in, a fillable PDF out.
+- **Fill From PDF + Context** — a PDF plus context (text or a file), the filled PDF out.
+- **Fill Existing Form** — fill a form you already created in Emboss, by ID.
+
+## Credentials
+An Emboss API key (`Authorization: Bearer`). Create one at https://getemboss.ai/dashboard.
+
+## Installation
+Settings → Community Nodes → Install `n8n-nodes-emboss`.

package/dist/credentials/EmbossApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class EmbossApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/EmbossApi.credentials.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbossApi = void 0;
+class EmbossApi {
+    constructor() {
+        this.name = 'embossApi';
+        this.displayName = 'Emboss API';
+        this.documentationUrl = 'https://getemboss.ai/dashboard';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: { headers: { Authorization: '=Bearer {{$credentials.apiKey}}' } },
+        };
+        this.test = {
+            request: { baseURL: 'https://api.getemboss.ai', url: '/forms', method: 'GET' },
+        };
+    }
+}
+exports.EmbossApi = EmbossApi;

package/dist/nodes/Emboss/Emboss.node.d.ts

@@ -0,0 +1,10 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeListSearchResult, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Emboss implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: {
+            getForms(this: ILoadOptionsFunctions): Promise<INodeListSearchResult>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Emboss/Emboss.node.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Emboss = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const poll_1 = require("./poll");
+const context_1 = require("./context");
+const BASE = 'https://api.getemboss.ai';
+class Emboss {
+    constructor() {
+        this.description = {
+            displayName: 'Emboss',
+            name: 'emboss',
+            icon: 'file:emboss.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Create fillable PDFs and fill forms from context via Emboss',
+            defaults: { name: 'Emboss' },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'embossApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Operation', name: 'operation', type: 'options', noDataExpression: true,
+                    options: [
+                        { name: 'Create Fillable Form', value: 'createForm', description: 'Turn a flat PDF into a fillable form', action: 'Create a fillable form' },
+                        { name: 'Fill From PDF + Context', value: 'fillFromPdf', description: 'Upload a PDF and context; get the filled PDF', action: 'Fill a form from a PDF and context' },
+                        { name: 'Fill Existing Form', value: 'fillExisting', description: 'Fill a form already created in Emboss', action: 'Fill an existing form' },
+                    ],
+                    default: 'createForm',
+                },
+                {
+                    displayName: 'Input PDF Field', name: 'binaryProperty', type: 'string', default: 'data',
+                    required: true, displayOptions: { show: { operation: ['createForm', 'fillFromPdf'] } },
+                    description: 'Name of the binary property holding the input PDF',
+                },
+                {
+                    displayName: 'Form', name: 'formId', type: 'resourceLocator', default: { mode: 'list', value: '' },
+                    required: true, displayOptions: { show: { operation: ['fillExisting'] } },
+                    modes: [
+                        { displayName: 'From List', name: 'list', type: 'list', typeOptions: { searchListMethod: 'getForms', searchable: true } },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'form-uuid' },
+                    ],
+                },
+                {
+                    displayName: 'Context (Text)', name: 'contextText', type: 'string', default: '',
+                    typeOptions: { rows: 3 }, displayOptions: { show: { operation: ['fillFromPdf', 'fillExisting'] } },
+                    description: 'Information to fill the form with',
+                },
+                {
+                    displayName: 'Context File Field', name: 'contextBinary', type: 'string', default: '',
+                    displayOptions: { show: { operation: ['fillFromPdf', 'fillExisting'] } },
+                    description: 'Optional: name of a binary property holding a context document (PDF, DOCX, CSV, image, text)',
+                },
+            ],
+        };
+        this.methods = {
+            listSearch: {
+                async getForms() {
+                    const resp = await this.helpers.httpRequestWithAuthentication.call(this, 'embossApi', { url: `${BASE}/forms` });
+                    const forms = (resp && resp.forms) || [];
+                    return { results: forms.map((f) => ({ name: f.title || f.id, value: f.id })) };
+                },
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const out = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                let resultUrl = '';
+                let json = {};
+                const readContextFile = async () => {
+                    const cprop = this.getNodeParameter('contextBinary', i, '');
+                    if (!cprop)
+                        return undefined;
+                    const meta = items[i].binary?.[cprop];
+                    const cbuf = await this.helpers.getBinaryDataBuffer(i, cprop);
+                    return { buffer: cbuf, filename: meta?.fileName || 'context', mimeType: meta?.mimeType || 'application/octet-stream' };
+                };
+                if (operation === 'createForm') {
+                    const prop = this.getNodeParameter('binaryProperty', i);
+                    const buf = await this.helpers.getBinaryDataBuffer(i, prop);
+                    const form = new FormData();
+                    form.append('file', new Blob([buf], { type: 'application/pdf' }), 'form.pdf');
+                    const created = await this.helpers.httpRequestWithAuthentication.call(this, 'embossApi', { method: 'POST', url: `${BASE}/forms`, body: form });
+                    const formId = created.form_id;
+                    await (0, poll_1.pollUntilReady)(this, `${BASE}/forms/${formId}`);
+                    resultUrl = `${BASE}/forms/${formId}/fillable`;
+                    json = { form_id: formId, status: 'ready' };
+                }
+                else if (operation === 'fillFromPdf') {
+                    const prop = this.getNodeParameter('binaryProperty', i);
+                    const fileBuf = await this.helpers.getBinaryDataBuffer(i, prop);
+                    const text = this.getNodeParameter('contextText', i, '');
+                    const cf = await readContextFile();
+                    const form = new FormData();
+                    form.append('file', new Blob([fileBuf], { type: 'application/pdf' }), 'form.pdf');
+                    for (const p of (0, context_1.contextParts)(text, cf)) {
+                        form.append('context', new Blob([p.value], { type: p.contentType }), p.filename);
+                    }
+                    const created = await this.helpers.httpRequestWithAuthentication.call(this, 'embossApi', { method: 'POST', url: `${BASE}/forms/with-context`, body: form });
+                    const ready = await (0, poll_1.pollUntilReady)(this, `${BASE}/forms/with-context/${created.job_id}`);
+                    resultUrl = `${BASE}/sessions/${ready.session_id}/pdf`;
+                    json = { session_id: ready.session_id, report: ready.report || {} };
+                }
+                else if (operation === 'fillExisting') {
+                    const formId = this.getNodeParameter('formId', i).value;
+                    const text = this.getNodeParameter('contextText', i, '');
+                    const cf = await readContextFile();
+                    const form = new FormData();
+                    for (const p of (0, context_1.contextParts)(text, cf)) {
+                        form.append('context', new Blob([p.value], { type: p.contentType }), p.filename);
+                    }
+                    const created = await this.helpers.httpRequestWithAuthentication.call(this, 'embossApi', { method: 'POST', url: `${BASE}/forms/${formId}/with-context`, body: form });
+                    const ready = await (0, poll_1.pollUntilReady)(this, `${BASE}/forms/with-context/${created.job_id}`);
+                    resultUrl = `${BASE}/sessions/${ready.session_id}/pdf`;
+                    json = { session_id: ready.session_id, report: ready.report || {} };
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unsupported operation: ${operation}`);
+                }
+                const pdf = await this.helpers.httpRequestWithAuthentication.call(this, 'embossApi', { url: resultUrl, encoding: 'arraybuffer' });
+                const binary = await this.helpers.prepareBinaryData(Buffer.from(pdf), 'emboss.pdf', 'application/pdf');
+                out.push({ json, binary: { data: binary }, pairedItem: { item: i } });
+            }
+            catch (err) {
+                if (this.continueOnFail()) {
+                    out.push({ json: { error: err.message }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw err;
+            }
+        }
+        return [out];
+    }
+}
+exports.Emboss = Emboss;

package/dist/nodes/Emboss/context.d.ts

@@ -0,0 +1,11 @@
+export interface ContextFile {
+    buffer: Buffer;
+    filename: string;
+    mimeType: string;
+}
+export interface ContextPart {
+    value: Buffer;
+    filename: string;
+    contentType: string;
+}
+export declare function contextParts(contextText?: string, contextFile?: ContextFile): ContextPart[];

package/dist/nodes/Emboss/context.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextParts = contextParts;
+// Build the `context` multipart file parts. The Emboss endpoints take `context` as a FILE list (a
+// bare text form field 422s), so typed text is wrapped as a context.txt part, and an optional context
+// file carries its real filename + mime so the backend's _resolve_kind accepts it. Both may be present.
+function contextParts(contextText, contextFile) {
+    const parts = [];
+    if (contextText) {
+        parts.push({ value: Buffer.from(contextText, 'utf8'), filename: 'context.txt', contentType: 'text/plain' });
+    }
+    if (contextFile && contextFile.buffer) {
+        parts.push({ value: contextFile.buffer, filename: contextFile.filename || 'context', contentType: contextFile.mimeType || 'application/octet-stream' });
+    }
+    return parts;
+}

package/dist/nodes/Emboss/emboss.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <rect width="60" height="60" rx="12" fill="#ee5a18"/>
+  <text x="30" y="44" font-family="Arial, Helvetica, sans-serif" font-size="40" font-weight="700" fill="#ffffff" text-anchor="middle">E</text>
+</svg>

package/dist/nodes/Emboss/poll.d.ts

@@ -0,0 +1,6 @@
+import type { IExecuteFunctions } from 'n8n-workflow';
+export interface PollOpts {
+    intervalMs?: number;
+    maxAttempts?: number;
+}
+export declare function pollUntilReady(ctx: IExecuteFunctions, url: string, opts?: PollOpts): Promise<any>;

package/dist/nodes/Emboss/poll.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pollUntilReady = pollUntilReady;
+const n8n_workflow_1 = require("n8n-workflow");
+// Poll a status URL until the payload reports status 'ready'. Throws a clean NodeOperationError
+// on status 'failed' (surfacing the Emboss error code/message) or after maxAttempts (~5 min default).
+async function pollUntilReady(ctx, url, opts = {}) {
+    const intervalMs = opts.intervalMs ?? 3000;
+    const maxAttempts = opts.maxAttempts ?? 100; // 3s * 100 ≈ 5 min
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        if (intervalMs > 0)
+            await new Promise((r) => setTimeout(r, intervalMs));
+        const payload = await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'embossApi', { url });
+        if (payload.status === 'failed') {
+            const e = payload.error;
+            const detail = typeof e === 'string' ? e : (e && (e.message || e.code)) || 'no detail';
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Emboss fill failed: ${detail}`);
+        }
+        if (payload.status === 'ready')
+            return payload;
+    }
+    throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), "Emboss job didn't finish within ~5 minutes. Re-run, or check the Emboss dashboard.");
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "n8n-nodes-emboss",
+  "version": "1.0.0",
+  "description": "n8n node for Emboss — create fillable PDFs and fill forms from context.",
+  "license": "MIT",
+  "author": "Emboss",
+  "homepage": "https://getemboss.ai",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "emboss",
+    "pdf",
+    "forms"
+  ],
+  "scripts": {
+    "build": "tsc && cp nodes/Emboss/emboss.svg dist/nodes/Emboss/emboss.svg",
+    "test": "jest",
+    "lint": "eslint nodes credentials --ext .ts"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/EmbossApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Emboss/Emboss.node.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.7",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.0",
+    "eslint-plugin-n8n-nodes-base": "^1.16.0",
+    "jest": "^29.7.0",
+    "n8n-workflow": "^1.55.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.5"
+  }
+}