@docspring/node-red-docspring 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DocSpring, Inc.
+
+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,61 @@
+# @docspring/node-red-docspring
+
+[Node-RED](https://nodered.org) nodes for [DocSpring](https://docspring.com) — turn
+structured data into filled, downloadable, and **signable** PDFs from your flows.
+
+## Install
+
+From the Node-RED editor: **Menu → Manage palette → Install**, search for
+`@docspring/node-red-docspring`. Or from your Node-RED user directory:
+
+```bash
+cd ~/.node-red
+npm install @docspring/node-red-docspring
+```
+
+Restart Node-RED. The **DocSpring** node appears in the palette.
+
+## Credentials
+
+Add a **DocSpring** configuration (on the node, or via the config-nodes list):
+choose your **Region** (US / EU / Self-hosted), and paste the **Token ID** and
+**Token Secret** from the DocSpring web app (**Settings → API Tokens**). Click
+**Test connection** to confirm it works. Credentials are stored encrypted by
+Node-RED and never leave your instance.
+
+## Usage
+
+Drop a **DocSpring** node into a flow, pick an **Operation**, and pass its parameters
+in `msg.payload`. The API response is written back to `msg.payload`; errors are sent
+to a **Catch** node. You can override the operation per message with `msg.operation`.
+
+| Operation | `msg.payload` in | out |
+|---|---|---|
+| **Generate PDF** | `{ template_id, data: {…}, test?, password?, expires_in?, … }` | the processed submission (+ `download_url`) |
+| **Combine PDFs** | `{ source_pdfs: [{ type, id\|url, template_version? }], … }` | the combined submission |
+| **Create Data Request** | `{ template_id, data_requests: [{ email, name?, fields?, auth_type? }], … }` | submission + a `signing_url` per recipient |
+| **Create Signing Link** | `{ data_request_id, token_type?: "email"\|"api" }` | the `signing_url` |
+| **Find Template** | `{ query?, limit? }` | array of templates |
+| **Find Submission** | `{ submission_id }` or `{ type?, created_after?, created_before?, limit? }` | submission(s) |
+
+### Example — generate a PDF
+
+An **inject** node with this payload, wired into a **DocSpring** node (Operation:
+*Generate PDF*):
+
+```json
+{ "template_id": "tpl_xxxxxxxxxxxxxxxxxxxx",
+  "data": { "first_name": "Jane", "last_name": "Doe" },
+  "test": true }
+```
+
+`msg.payload` then contains the submission, including `download_url`.
+
+## Resources
+
+- [DocSpring documentation](https://docspring.com/docs)
+- [Node-RED community nodes](https://flows.nodered.org)
+
+## License
+
+[MIT](LICENSE.md)

package/icons/docspring.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 325 375" width="325" height="375">
+  <path fill="#3C8EE0" d="M82.7708709,9.04533917 C86.4749789,5.03737303 89.622499,2.53280823 92.2134313,1.53164477 C95.1943105,0.379801744 98.0002807,-0.12237578 100.631342,0.0251121959 L107,0.0251121959 L325.000002,0 L325.000002,337.5 C325.000002,358.210678 308.21068,375 287.500002,375 L0,375 L0.048844333,110 L0.048844333,105.626194 C-0.125483604,104.504595 0.16682749,102.922738 0.925777616,100.880623 C1.68472774,98.8385079 3.42554643,96.4605452 6.14823367,93.7467348 L82.7708709,9.04533917 Z"/>
+</svg>

package/lib/docspring.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const { resolveBaseUrl } = require('./regions');
+
+// Authenticated DocSpring API request. `conn` = { region, customHost, tokenId,
+// tokenSecret }. Uses the global fetch (Node 18+, which Node-RED 3.1+/4 require) so
+// the package ships with zero runtime dependencies. Surfaces DocSpring's
+// `{ status: 'error', errors: [...] }` payloads (and non-2xx) as a thrown Error.
+async function docSpringRequest(conn, method, path, options) {
+	options = options || {};
+	const base = resolveBaseUrl(conn.region, conn.customHost, options.sync);
+	const url = new URL(base + '/api/v1' + path);
+
+	if (options.qs) {
+		for (const [k, v] of Object.entries(options.qs)) {
+			if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, v);
+		}
+	}
+
+	const headers = {
+		Authorization: 'Basic ' + Buffer.from(conn.tokenId + ':' + conn.tokenSecret).toString('base64'),
+		Accept: 'application/json',
+	};
+	let body;
+	if (options.body !== undefined) {
+		headers['Content-Type'] = 'application/json';
+		body = JSON.stringify(options.body);
+	}
+
+	const res = await fetch(url, { method, headers, body });
+	const text = await res.text();
+	let data;
+	try {
+		data = text ? JSON.parse(text) : {};
+	} catch (_e) {
+		data = text;
+	}
+
+	if (!res.ok || (data && typeof data === 'object' && data.status === 'error')) {
+		const message =
+			(data && Array.isArray(data.errors) && data.errors.join(', ')) ||
+			(data && data.error) ||
+			'DocSpring API error (HTTP ' + res.status + ')';
+		const err = new Error(message);
+		err.statusCode = res.status;
+		err.body = data;
+		throw err;
+	}
+	return data;
+}
+
+// Split a comma/newline-separated list of field names into a clean array.
+function parseFields(value) {
+	if (value === undefined || value === null || value === '') return undefined;
+	const arr = (Array.isArray(value) ? value : String(value).split(/[\n,]/))
+		.map((s) => String(s).trim())
+		.filter(Boolean);
+	return arr.length ? arr : undefined;
+}
+
+module.exports = { docSpringRequest, parseFields };

package/lib/operations.js

@@ -0,0 +1,155 @@
+'use strict';
+
+const { docSpringRequest, parseFields } = require('./docspring');
+
+// Each handler takes (conn, params) where params come from msg.payload, and returns
+// the value written to msg.payload. Mirrors the Zapier/Make/n8n implementations.
+
+async function generatePdf(conn, p) {
+	if (!p.template_id) throw new Error('template_id is required');
+	const body = { data: p.data || {}, test: p.test || false };
+	if (p.metadata) body.metadata = p.metadata;
+	if (p.password) body.password = p.password;
+	if (p.editable !== undefined) body.editable = p.editable;
+	if (p.expires_in) body.expires_in = p.expires_in;
+	if (p.version) body.version = p.version;
+	const result = await docSpringRequest(conn, 'POST', '/templates/' + p.template_id + '/submissions', {
+		body,
+		qs: { wait: true },
+		sync: true,
+	});
+	return result.submission || result;
+}
+
+async function combinePdfs(conn, p) {
+	const sourcePdfs = (p.source_pdfs || []).map((row) => {
+		const entry = { type: row.type || 'submission' };
+		if (row.type === 'url') entry.url = row.url;
+		else entry.id = row.id;
+		if (row.template_version) entry.template_version = row.template_version;
+		return entry;
+	});
+	const body = { source_pdfs: sourcePdfs };
+	if (p.password) body.password = p.password;
+	if (p.expires_in) body.expires_in = p.expires_in;
+	if (p.metadata) body.metadata = p.metadata;
+	const result = await docSpringRequest(conn, 'POST', '/combined_submissions', {
+		body,
+		qs: { wait: true },
+		sync: true,
+	});
+	return result.combined_submission || result;
+}
+
+async function createSigningLink(conn, p) {
+	if (!p.data_request_id) throw new Error('data_request_id is required');
+	const result = await docSpringRequest(conn, 'POST', '/data_requests/' + p.data_request_id + '/tokens', {
+		qs: { type: p.token_type || 'email' },
+	});
+	const token = result.token || result;
+	return { id: token.id, signing_url: token.data_request_url, expires_at: token.expires_at };
+}
+
+async function createDataRequest(conn, p) {
+	if (!p.template_id) throw new Error('template_id is required');
+	const rows = (p.data_requests || []).filter((r) => r && r.email);
+	if (!rows.length) throw new Error('At least one recipient with an email address is required');
+	const dataRequests = rows.map((r) => {
+		const e = { email: r.email, auth_type: r.auth_type || 'email_link' };
+		if (r.name) e.name = r.name;
+		const fields = parseFields(r.fields);
+		if (fields) e.fields = fields;
+		return e;
+	});
+	const body = { data: p.data || {}, data_requests: dataRequests, test: p.test || false };
+	if (p.metadata) body.metadata = p.metadata;
+	if (p.expires_in) body.expires_in = p.expires_in;
+	if (p.version) body.version = p.version;
+
+	const result = await docSpringRequest(conn, 'POST', '/templates/' + p.template_id + '/submissions', { body });
+	const submission = result.submission || result;
+	const created = submission.data_requests || [];
+
+	// Mint a 30-day email signing link per recipient (one failure shouldn't fail all).
+	const enriched = [];
+	for (const dr of created) {
+		let signingUrl = null;
+		if (dr.id && dr.state !== 'completed') {
+			try {
+				const tok = await docSpringRequest(conn, 'POST', '/data_requests/' + dr.id + '/tokens', {
+					qs: { type: 'email' },
+				});
+				signingUrl = (tok.token && tok.token.data_request_url) || null;
+			} catch (_e) {
+				signingUrl = null;
+			}
+		}
+		enriched.push(Object.assign({}, dr, { signing_url: signingUrl }));
+	}
+	const first = enriched[0] || {};
+	return Object.assign({}, submission, {
+		data_requests: enriched,
+		first_data_request_id: first.id || null,
+		first_signing_url: first.signing_url || null,
+	});
+}
+
+async function findTemplate(conn, p) {
+	const results = [];
+	const limit = p.limit || 20;
+	let page = 1;
+	let hasMore = true;
+	while (hasMore) {
+		const qs = { per_page: 50, page };
+		if (p.query) qs.query = p.query;
+		const batch = await docSpringRequest(conn, 'GET', '/templates', { qs });
+		const list = Array.isArray(batch) ? batch : [];
+		results.push.apply(results, list);
+		hasMore = list.length >= 50 && results.length < limit;
+		page += 1;
+	}
+	return results.slice(0, limit);
+}
+
+async function findSubmission(conn, p) {
+	if (p.submission_id) {
+		return await docSpringRequest(conn, 'GET', '/submissions/' + p.submission_id);
+	}
+	const results = [];
+	const limit = p.limit || 20;
+	let cursor;
+	do {
+		const qs = { limit: 50, include_data: true };
+		if (p.type) qs.type = p.type;
+		if (p.created_after) qs.created_after = p.created_after;
+		if (p.created_before) qs.created_before = p.created_before;
+		if (cursor) qs.cursor = cursor;
+		const pageData = await docSpringRequest(conn, 'GET', '/submissions', { qs });
+		const subs = pageData.submissions || [];
+		results.push.apply(results, subs);
+		cursor = pageData.next_cursor;
+		if (!subs.length) break;
+	} while (cursor && results.length < limit);
+	return results.slice(0, limit);
+}
+
+const OPERATIONS = {
+	generatePdf,
+	combinePdfs,
+	createDataRequest,
+	createSigningLink,
+	findTemplate,
+	findSubmission,
+};
+
+// Labels for the editor dropdown (value → display).
+const OPERATION_LABELS = {
+	generatePdf: 'Generate PDF',
+	combinePdfs: 'Combine PDFs',
+	createDataRequest: 'Create Data Request',
+	createSigningLink: 'Create Signing Link',
+	findTemplate: 'Find Template',
+	findSubmission: 'Find Submission',
+};
+
+module.exports = { OPERATIONS, OPERATION_LABELS };

package/lib/regions.js

@@ -0,0 +1,28 @@
+'use strict';
+
+// Region → API host. `sync` selects the low-latency host used for synchronous PDF
+// generation (Generate PDF / Combine PDFs with ?wait=true). Self-hosted installs use
+// a single custom origin for both.
+function resolveBaseUrl(region, customHost, sync) {
+	region = (region || 'us').toLowerCase();
+
+	if (region === 'self_hosted') {
+		const host = (customHost || '').trim();
+		if (!host) {
+			throw new Error(
+				'A Self-Hosted Host is required for the Self-Hosted / Enterprise region ' +
+					'(e.g. https://docspring.example.com).',
+			);
+		}
+		return host.includes('://') ? host : 'https://' + host;
+	}
+
+	const hosts = {
+		us: { host: 'api.docspring.com', sync: 'sync.api.docspring.com' },
+		eu: { host: 'api-eu.docspring.com', sync: 'sync.api-eu.docspring.com' },
+	};
+	const entry = hosts[region] || hosts.us;
+	return 'https://' + (sync ? entry.sync : entry.host);
+}
+
+module.exports = { resolveBaseUrl };

package/nodes/docspring-config.html

@@ -0,0 +1,96 @@
+<script type="text/javascript">
+	RED.nodes.registerType('docspring-config', {
+		category: 'config',
+		defaults: {
+			name: { value: '' },
+			region: { value: 'us', required: true },
+			customHost: { value: '' },
+		},
+		credentials: {
+			tokenId: { type: 'text' },
+			tokenSecret: { type: 'password' },
+		},
+		label: function () {
+			return this.name || 'DocSpring';
+		},
+		oneditprepare: function () {
+			var node = this;
+
+			var toggleHost = function () {
+				if ($('#node-config-input-region').val() === 'self_hosted') {
+					$('#docspring-host-row').show();
+				} else {
+					$('#docspring-host-row').hide();
+				}
+			};
+			$('#node-config-input-region').on('change', toggleHost);
+			toggleHost();
+
+			$('#docspring-test-btn').on('click', function () {
+				var payload = {
+					region: $('#node-config-input-region').val(),
+					customHost: $('#node-config-input-customHost').val(),
+					tokenId: $('#node-config-input-tokenId').val(),
+					tokenSecret: $('#node-config-input-tokenSecret').val(),
+				};
+				$('#docspring-test-result').text('Testing…').css('color', '#888');
+				$.ajax({
+					url: 'docspring-config/' + (node.id || '_new') + '/test',
+					type: 'POST',
+					contentType: 'application/json',
+					data: JSON.stringify(payload),
+					success: function (res) {
+						$('#docspring-test-result')
+							.text(res.message)
+							.css('color', res.ok ? '#2ea44f' : '#d1242f');
+					},
+					error: function (jqXHR) {
+						$('#docspring-test-result')
+							.text('Test failed: ' + (jqXHR.responseText || jqXHR.statusText))
+							.css('color', '#d1242f');
+					},
+				});
+			});
+		},
+	});
+</script>
+
+<script type="text/html" data-template-name="docspring-config">
+	<div class="form-row">
+		<label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+		<input type="text" id="node-config-input-name" placeholder="My DocSpring account" />
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-region"><i class="fa fa-globe"></i> Region</label>
+		<select id="node-config-input-region" style="width:70%">
+			<option value="us">United States</option>
+			<option value="eu">Europe</option>
+			<option value="self_hosted">Self-hosted / Enterprise</option>
+		</select>
+	</div>
+	<div class="form-row" id="docspring-host-row">
+		<label for="node-config-input-customHost"><i class="fa fa-server"></i> Host</label>
+		<input type="text" id="node-config-input-customHost" placeholder="https://docspring.example.com" />
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-tokenId"><i class="fa fa-user"></i> Token ID</label>
+		<input type="text" id="node-config-input-tokenId" placeholder="api_..." />
+	</div>
+	<div class="form-row">
+		<label for="node-config-input-tokenSecret"><i class="fa fa-lock"></i> Token Secret</label>
+		<input type="password" id="node-config-input-tokenSecret" />
+	</div>
+	<div class="form-row">
+		<button type="button" class="red-ui-button" id="docspring-test-btn">Test connection</button>
+		<span id="docspring-test-result" style="margin-left:10px;"></span>
+	</div>
+</script>
+
+<script type="text/html" data-help-name="docspring-config">
+	<p>Holds your DocSpring API connection, shared by the DocSpring action nodes.</p>
+	<p>
+		Create a token in the DocSpring web app under <b>Settings → API Tokens</b>, then enter the
+		<b>Token ID</b> and <b>Token Secret</b> here and pick your <b>Region</b>. Use
+		<b>Test connection</b> to confirm the credentials work.
+	</p>
+</script>

package/nodes/docspring-config.js

@@ -0,0 +1,68 @@
+module.exports = function (RED) {
+	'use strict';
+
+	// Config node holding the DocSpring connection: region + custom host (non-secret)
+	// and the API token id/secret (stored encrypted as Node-RED credentials).
+	function DocSpringConfigNode(n) {
+		RED.nodes.createNode(this, n);
+		this.name = n.name;
+		this.region = n.region || 'us';
+		this.customHost = n.customHost || '';
+	}
+
+	RED.nodes.registerType('docspring-config', DocSpringConfigNode, {
+		credentials: {
+			tokenId: { type: 'text' },
+			tokenSecret: { type: 'password' },
+		},
+	});
+
+	// Admin endpoint for the "Test connection" button in the config editor.
+	// Hits GET /authentication with the entered (or already-saved) credentials.
+	RED.httpAdmin.post(
+		'/docspring-config/:id/test',
+		RED.auth.needsPermission('docspring-config.read'),
+		function (req, res) {
+			const { resolveBaseUrl } = require('../lib/regions');
+			const body = req.body || {};
+			const node = RED.nodes.getNode(req.params.id);
+
+			const tokenId = body.tokenId || (node && node.credentials && node.credentials.tokenId);
+			const tokenSecret =
+				body.tokenSecret || (node && node.credentials && node.credentials.tokenSecret);
+			const region = body.region || (node && node.region) || 'us';
+			const customHost = body.customHost || (node && node.customHost) || '';
+
+			if (!tokenId || !tokenSecret) {
+				res.json({ ok: false, message: 'Enter a Token ID and Token Secret first.' });
+				return;
+			}
+
+			let baseUrl;
+			try {
+				baseUrl = resolveBaseUrl(region, customHost, false);
+			} catch (e) {
+				res.json({ ok: false, message: e.message });
+				return;
+			}
+
+			const headers = {
+				Authorization: 'Basic ' + Buffer.from(tokenId + ':' + tokenSecret).toString('base64'),
+				Accept: 'application/json',
+			};
+			fetch(baseUrl + '/api/v1/authentication', { headers })
+				.then((r) => r.json().then((d) => ({ status: r.status, d })))
+				.then(({ status, d }) => {
+					if (status === 200 && d && d.status === 'success') {
+						res.json({ ok: true, message: 'Connection successful.' });
+					} else {
+						res.json({
+							ok: false,
+							message: '[' + status + '] Invalid DocSpring API token. Check your ID, secret, and region.',
+						});
+					}
+				})
+				.catch((err) => res.json({ ok: false, message: err.message }));
+		},
+	);
+};

package/nodes/docspring.html

@@ -0,0 +1,77 @@
+<script type="text/javascript">
+	RED.nodes.registerType('docspring', {
+		category: 'DocSpring',
+		color: '#87b7e8',
+		defaults: {
+			name: { value: '' },
+			operation: { value: 'generatePdf', required: true },
+			server: { value: '', type: 'docspring-config', required: true },
+		},
+		inputs: 1,
+		outputs: 1,
+		icon: 'docspring.svg',
+		paletteLabel: 'DocSpring',
+		label: function () {
+			var labels = {
+				generatePdf: 'Generate PDF',
+				combinePdfs: 'Combine PDFs',
+				createDataRequest: 'Create Data Request',
+				createSigningLink: 'Create Signing Link',
+				findTemplate: 'Find Template',
+				findSubmission: 'Find Submission',
+			};
+			return this.name || 'DocSpring: ' + (labels[this.operation] || this.operation);
+		},
+	});
+</script>
+
+<script type="text/html" data-template-name="docspring">
+	<div class="form-row">
+		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+		<input type="text" id="node-input-name" placeholder="Name" />
+	</div>
+	<div class="form-row">
+		<label for="node-input-server"><i class="fa fa-cloud"></i> Connection</label>
+		<input type="text" id="node-input-server" />
+	</div>
+	<div class="form-row">
+		<label for="node-input-operation"><i class="fa fa-cogs"></i> Operation</label>
+		<select id="node-input-operation" style="width:70%">
+			<option value="generatePdf">Generate PDF</option>
+			<option value="combinePdfs">Combine PDFs</option>
+			<option value="createDataRequest">Create Data Request</option>
+			<option value="createSigningLink">Create Signing Link</option>
+			<option value="findTemplate">Find Template</option>
+			<option value="findSubmission">Find Submission</option>
+		</select>
+	</div>
+</script>
+
+<script type="text/html" data-help-name="docspring">
+	<p>
+		Calls the <a href="https://docspring.com/docs" target="_blank">DocSpring API</a>. Choose an
+		<b>Operation</b>; pass its parameters in <code>msg.payload</code>. The API response is written
+		back to <code>msg.payload</code>. Errors are sent to a <b>Catch</b> node.
+	</p>
+	<p>You can override the configured operation per message with <code>msg.operation</code>.</p>
+
+	<h3>Generate PDF</h3>
+	<p><code>msg.payload = { template_id, data: { field: value, ... }, test?, metadata?, password?, editable?, expires_in?, version? }</code></p>
+	<p>Returns the processed submission (with <code>download_url</code>).</p>
+
+	<h3>Combine PDFs</h3>
+	<p><code>msg.payload = { source_pdfs: [ { type: "submission"|"template"|"combined_submission"|"custom_file"|"url", id?, url?, template_version? } ], password?, expires_in?, metadata? }</code></p>
+
+	<h3>Create Data Request</h3>
+	<p><code>msg.payload = { template_id, data?, data_requests: [ { email, name?, fields?, auth_type? } ], test?, expires_in?, version? }</code></p>
+	<p>Returns a submission awaiting data requests, plus a 30-day <code>signing_url</code> per recipient.</p>
+
+	<h3>Create Signing Link</h3>
+	<p><code>msg.payload = { data_request_id, token_type?: "email"|"api" }</code> → returns the <code>signing_url</code>.</p>
+
+	<h3>Find Template</h3>
+	<p><code>msg.payload = { query?, limit? }</code> → an array of templates.</p>
+
+	<h3>Find Submission</h3>
+	<p><code>msg.payload = { submission_id }</code> (single) or <code>{ type?, created_after?, created_before?, limit? }</code> (list).</p>
+</script>

package/nodes/docspring.js

@@ -0,0 +1,66 @@
+module.exports = function (RED) {
+	'use strict';
+
+	const { OPERATIONS, OPERATION_LABELS } = require('../lib/operations');
+
+	// One action node with an Operation selector. Request parameters come from
+	// msg.payload (or msg.operation overrides the configured operation); the API
+	// response is written back to msg.payload.
+	function DocSpringNode(config) {
+		RED.nodes.createNode(this, config);
+		const node = this;
+		node.operation = config.operation;
+		node.server = RED.nodes.getNode(config.server);
+
+		node.on('input', function (msg, send, done) {
+			send =
+				send ||
+				function () {
+					node.send.apply(node, arguments);
+				};
+			const fail = function (err) {
+				node.status({ fill: 'red', shape: 'ring', text: String(err.message || err).slice(0, 20) });
+				if (done) done(err);
+				else node.error(err, msg);
+			};
+
+			const operation = msg.operation || node.operation;
+			const handler = OPERATIONS[operation];
+			if (!handler) {
+				fail(new Error('Unknown DocSpring operation: ' + operation));
+				return;
+			}
+			if (!node.server || !node.server.credentials || !node.server.credentials.tokenId) {
+				fail(new Error('DocSpring connection is not configured (set the credential).'));
+				return;
+			}
+
+			const conn = {
+				region: node.server.region,
+				customHost: node.server.customHost,
+				tokenId: node.server.credentials.tokenId,
+				tokenSecret: node.server.credentials.tokenSecret,
+			};
+			const params =
+				msg.payload && typeof msg.payload === 'object' && !Array.isArray(msg.payload)
+					? msg.payload
+					: {};
+
+			node.status({ fill: 'blue', shape: 'dot', text: OPERATION_LABELS[operation] || operation });
+			Promise.resolve(handler(conn, params))
+				.then(function (result) {
+					msg.payload = result;
+					node.status({ fill: 'green', shape: 'dot', text: 'done' });
+					send(msg);
+					if (done) done();
+				})
+				.catch(fail);
+		});
+
+		node.on('close', function () {
+			node.status({});
+		});
+	}
+
+	RED.nodes.registerType('docspring', DocSpringNode);
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@docspring/node-red-docspring",
+  "version": "0.1.0",
+  "description": "Node-RED nodes for DocSpring — generate, combine, and sign PDFs from your templates.",
+  "keywords": [
+    "node-red",
+    "docspring",
+    "pdf",
+    "documents",
+    "esignature"
+  ],
+  "license": "MIT",
+  "homepage": "https://docspring.com",
+  "author": {
+    "name": "DocSpring",
+    "email": "support@docspring.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DocSpring/node-red_integration.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "node-red": {
+    "version": ">=3.0.0",
+    "nodes": {
+      "docspring-config": "nodes/docspring-config.js",
+      "docspring": "nodes/docspring.js"
+    }
+  },
+  "scripts": {
+    "test": "mocha \"test/**/*_spec.js\""
+  },
+  "files": [
+    "nodes",
+    "lib",
+    "icons"
+  ],
+  "devDependencies": {
+    "mocha": "^10.7.3",
+    "node-red": "^4.0.9",
+    "node-red-node-test-helper": "^0.3.4",
+    "should": "^13.2.3"
+  }
+}