n8n-nodes-speedtest-net 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Dolezal
+
+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

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# n8n-nodes-speedtest-net
+TypeScript n8n community node with its own wrapper around the **official Ookla Speedtest CLI**. The npm `speedtest-net` dependency has been removed: this package launches the installed CLI directly, captures diagnostics, and produces structured errors.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## Requirements
+- Self-hosted n8n and Node.js 22 or newer. Not a verified n8n Cloud node.
+- Install the official Ookla CLI on every worker that executes this node: https://www.speedtest.net/apps/cli
+- The executable must be available as `speedtest` on PATH. Administrators can instead set `N8N_SPEEDTEST_BINARY` to its absolute path. Restart n8n after changing the environment.
+- Do not install the unrelated Python `speedtest-cli`: it has different flags and output.
+- No automatic executable downloads or npm native-dependency overrides are required anymore.
+- For containers, bake the official CLI into a compatible image. A host installation is not automatically accessible inside the container. Check Ookla platform/runtime compatibility, particularly Alpine/musl.
+
+Tests measure the **n8n worker/container connection**, not your browser. They consume bandwidth and may use significant data. Tests are sequential within one node execution, but separate workflows/workers can still overlap. One input item causes one test.
+
+Review [Ookla's EULA](https://www.speedtest.net/about/eula), [Terms](https://www.speedtest.net/about/terms), and [Privacy Policy](https://www.speedtest.net/about/privacy). Both consent switches are disabled by default and must be explicitly enabled. Ookla's licensing restrictions apply independently of this package's MIT license.
+
+## Build and install
+```bash
+npm ci
+npm test
+npm run typecheck
+npm run build
+npm pack
+```
+
+Install the generated `n8n-nodes-speedtest-net-0.2.0.tgz` into your self-hosted n8n community-package directory (typically `~/.n8n/nodes`) with npm, using the n8n file owner's account, then restart n8n. Install on all workers in queue mode. The official CLI must be installed separately in each execution environment.
+
+For local development, point `N8N_CUSTOM_EXTENSIONS` at the built `dist/nodes` directory and make the project's dependencies available alongside it. Real n8n discovery and real Ookla requests still require verification in your environment.
+
+## Usage
+1. Connect **Manual Trigger → Speedtest**.
+2. Review and enable both Ookla consent switches if you agree.
+3. Optionally choose **Server ID**, **Source IP**, or **Timeout (Seconds)** (default 120).
+4. Execute and use `{{ $json.downloadMbps }}`, `{{ $json.uploadMbps }}`, or `{{ $json.ping.latency }}`.
+
+Success preserves the CLI JSON result and adds decimal `downloadMbps` and `uploadMbps`. Original bandwidth fields remain in bytes/second. All output items are linked to their input items.
+
+## Structured errors (default)
+**Return Errors as Data is enabled by default.** Failures return JSON on the regular output instead of failing the node. Route errors with an IF node using `{{ $json.success === false }}`. Disable the switch to use normal n8n failure handling; n8n's continue-on-fail setting also produces structured JSON.
+
+Example for the reported Ookla rate limit:
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "RATE_LIMITED",
+    "message": "Limit reached: Too many requests received.",
+    "rateLimited": true,
+    "retryAfterSeconds": null,
+    "retryAt": null,
+    "retrySource": null,
+    "stdout": "",
+    "stderr": "[2026-10-30 14:30:58.565] [error] Limit reached: Too many requests received.",
+    "exitCode": 1,
+    "signal": null
+  }
+}
+```
+
+### What we can and cannot know
+The wrapper preserves raw stdout/stderr, exit code, and termination signal when available. It can classify rate limits and recognize an explicit `retry after N seconds` or `retry in N seconds` message if the CLI emits one. This is parsed CLI text, not an HTTP header or a documented promise from Ookla.
+
+**A direct CLI wrapper cannot expose hidden HTTP response headers.** If Ookla does not print a retry duration, it remains `null`. `retryAt` is currently always `null`; a log timestamp is never treated as a quota reset. No fabricated cooldown, automatic retries, or rate-limit bypass is implemented. A rate-limit/licensing error can require more than simply waiting.
+
+Error codes include `RATE_LIMITED`, `TIMEOUT`, `BINARY_NOT_FOUND`, `SPAWN_ERROR`, `CLI_ERROR`, `INVALID_RESULT`, `OUTPUT_LIMIT`, and `INVALID_CONFIGURATION`.
+
+Timeout and output-limit failures kill the direct child and wait for process termination before returning. Captured stdout/stderr is limited to 1 MiB total. Diagnostics can contain network addresses or other sensitive information: restrict access to execution data and avoid publishing raw logs.
+
+## Tests and layout
+- `nodes/Speedtest/Speedtest.node.ts`: n8n UI and per-item integration.
+- `nodes/Speedtest/runSpeedtest.ts`: shell-free CLI execution, timeout, output bounds, and result conversion.
+- `nodes/Speedtest/speedtestError.ts`: structured diagnostics and rate-limit classification.
+- `tests/`: mocked process tests, n8n integration unit tests, and local fixture-process tests; no real Ookla requests.
+
+Tests do not prove deployment compatibility or verify a real Ookla quota reset. The package is MIT licensed; see `LICENSE`.

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

@@ -0,0 +1,5 @@
+import { type IExecuteFunctions, type INodeExecutionData, type INodeType, type INodeTypeDescription } from 'n8n-workflow';
+export declare class Speedtest implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Speedtest/Speedtest.node.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Speedtest = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const runSpeedtest_1 = require("./runSpeedtest");
+const speedtestError_1 = require("./speedtestError");
+class Speedtest {
+    description = {
+        displayName: 'Speedtest',
+        name: 'speedtest',
+        icon: 'file:speedtest.svg',
+        group: ['transform'],
+        version: 1,
+        description: 'Measure internet download, upload, and latency using Ookla Speedtest',
+        defaults: { name: 'Speedtest' },
+        inputs: ['main'],
+        outputs: ['main'],
+        properties: [
+            {
+                displayName: 'Tests run on the n8n worker, not your browser. They can consume substantial bandwidth. Ookla terms apply.',
+                name: 'notice',
+                type: 'notice',
+                default: '',
+            },
+            {
+                displayName: 'Accept Ookla License',
+                name: 'acceptLicense',
+                type: 'boolean',
+                default: false,
+                description: 'Whether you accept the Ookla EULA, Terms of Use, and Privacy Policy (speedtest.net/about/eula, /terms, /privacy)',
+            },
+            {
+                displayName: 'Accept Ookla GDPR Terms',
+                name: 'acceptGdpr',
+                type: 'boolean',
+                default: false,
+                description: 'Whether you accept the Ookla GDPR terms and consent to the processing described by Ookla',
+            },
+            {
+                displayName: 'Return Errors as Data',
+                name: 'returnErrors',
+                type: 'boolean',
+                default: true,
+                description: 'Whether to return structured errors on the regular output instead of failing the node. Diagnostics can contain network information.',
+            },
+            {
+                displayName: 'Options',
+                name: 'options',
+                type: 'collection',
+                placeholder: 'Add Option',
+                default: {},
+                options: [
+                    {
+                        displayName: 'Server ID',
+                        name: 'serverId',
+                        type: 'string',
+                        default: '',
+                        description: 'Ookla server ID. Leave empty to select a server automatically.',
+                    },
+                    {
+                        displayName: 'Source IP',
+                        name: 'sourceIp',
+                        type: 'string',
+                        default: '',
+                        description: 'Local IP address of the interface to test. Leave empty for the default route.',
+                    },
+                    {
+                        displayName: 'Timeout (Seconds)',
+                        name: 'timeout',
+                        type: 'number',
+                        default: 120,
+                        typeOptions: { minValue: 1, maxValue: 3600, numberPrecision: 0 },
+                        description: 'Maximum time to wait for a result before cancelling the test',
+                    },
+                ],
+            },
+        ],
+    };
+    async execute() {
+        const items = this.getInputData();
+        const output = [];
+        // Run sequentially: parallel speed tests would distort each other's results.
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const acceptLicense = this.getNodeParameter('acceptLicense', itemIndex);
+                const acceptGdpr = this.getNodeParameter('acceptGdpr', itemIndex);
+                if (!acceptLicense || !acceptGdpr) {
+                    throw new Error('Review and enable both Ookla consent options before running a speed test');
+                }
+                const options = this.getNodeParameter('options', itemIndex, {});
+                const timeout = options.timeout ?? 120;
+                if (!Number.isInteger(timeout) || timeout < 1 || timeout > 3600) {
+                    throw new Error('Timeout must be an integer between 1 and 3600 seconds');
+                }
+                const serverId = options.serverId?.trim();
+                const sourceIp = options.sourceIp?.trim();
+                const json = await (0, runSpeedtest_1.runSpeedtest)({
+                    acceptLicense,
+                    acceptGdpr,
+                    ...(serverId ? { serverId } : {}),
+                    ...(sourceIp ? { sourceIp } : {}),
+                }, timeout);
+                output.push({ json, pairedItem: { item: itemIndex } });
+            }
+            catch (error) {
+                const cause = error instanceof Error ? error : new Error(String(error));
+                if (this.getNodeParameter('returnErrors', itemIndex, true) || this.continueOnFail()) {
+                    output.push({ json: { success: false, error: (0, speedtestError_1.structuredError)(cause) }, pairedItem: { item: itemIndex } });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), cause, { itemIndex });
+            }
+        }
+        return [output];
+    }
+}
+exports.Speedtest = Speedtest;
+//# sourceMappingURL=Speedtest.node.js.map

package/dist/nodes/Speedtest/Speedtest.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Speedtest.node.js","sourceRoot":"","sources":["../../../nodes/Speedtest/Speedtest.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Speedtest/runSpeedtest.d.ts

@@ -0,0 +1,8 @@
+import type { IDataObject } from 'n8n-workflow';
+export interface SpeedtestOptions {
+    acceptLicense: boolean;
+    acceptGdpr: boolean;
+    serverId?: string;
+    sourceIp?: string;
+}
+export declare function runSpeedtest(options: SpeedtestOptions, timeoutSeconds: number): Promise<IDataObject>;

package/dist/nodes/Speedtest/runSpeedtest.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSpeedtest = runSpeedtest;
+const node_child_process_1 = require("node:child_process");
+const node_net_1 = require("node:net");
+const speedtestError_1 = require("./speedtestError");
+// Bound process output so a faulty executable cannot exhaust the worker's memory.
+const MAX_OUTPUT_BYTES = 1024 * 1024;
+async function runSpeedtest(options, timeoutSeconds) {
+    if (!options.acceptLicense || !options.acceptGdpr) {
+        throw new speedtestError_1.SpeedtestError('Both Ookla consent options are required', 'INVALID_CONFIGURATION');
+    }
+    if (!Number.isInteger(timeoutSeconds) || timeoutSeconds < 1 || timeoutSeconds > 3600) {
+        throw new speedtestError_1.SpeedtestError('Timeout must be between 1 and 3600 seconds', 'INVALID_CONFIGURATION');
+    }
+    if (options.serverId && !/^\d+$/.test(options.serverId)) {
+        throw new speedtestError_1.SpeedtestError('Server ID must contain only digits', 'INVALID_CONFIGURATION');
+    }
+    if (options.sourceIp && !(0, node_net_1.isIP)(options.sourceIp)) {
+        throw new speedtestError_1.SpeedtestError('Source IP must be a valid IP address', 'INVALID_CONFIGURATION');
+    }
+    const args = ['--format=json', '--progress=no', '--accept-license', '--accept-gdpr'];
+    if (options.serverId)
+        args.push('--server-id=' + options.serverId);
+    if (options.sourceIp)
+        args.push('--ip=' + options.sourceIp);
+    return new Promise((resolve, reject) => {
+        // Deliberately not configurable by workflow input: executable selection belongs to the administrator.
+        const child = (0, node_child_process_1.spawn)(process.env.N8N_SPEEDTEST_BINARY || 'speedtest', args, {
+            shell: false, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let totalBytes = 0;
+        let failure;
+        const stop = (message, code) => {
+            if (failure)
+                return;
+            failure = { message, code };
+            // Ookla is the direct child; no shell or intermediary process is involved.
+            child.kill('SIGKILL');
+        };
+        const timer = setTimeout(() => stop(`Speed test timed out after ${timeoutSeconds} seconds`, 'TIMEOUT'), timeoutSeconds * 1000);
+        const collect = (stream, chunk) => {
+            const remaining = Math.max(0, MAX_OUTPUT_BYTES - totalBytes);
+            totalBytes += chunk.length;
+            const text = chunk.subarray(0, remaining).toString('utf8');
+            if (stream === 'stdout')
+                stdout += text;
+            else
+                stderr += text;
+            if (totalBytes > MAX_OUTPUT_BYTES)
+                stop('Speedtest output exceeded 1 MiB', 'OUTPUT_LIMIT');
+        };
+        child.stdout.on('data', (chunk) => collect('stdout', chunk));
+        child.stderr.on('data', (chunk) => collect('stderr', chunk));
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            reject(new speedtestError_1.SpeedtestError(error.message, error.code === 'ENOENT' ? 'BINARY_NOT_FOUND' : 'SPAWN_ERROR', { stdout, stderr }));
+        });
+        child.on('close', (exitCode, signal) => {
+            clearTimeout(timer);
+            const diagnostics = { stdout, stderr, exitCode, signal };
+            if (failure || exitCode !== 0) {
+                reject(new speedtestError_1.SpeedtestError(failure?.message || stderr.trim() || `Speedtest exited with code ${exitCode}`, failure?.code || 'CLI_ERROR', diagnostics));
+                return;
+            }
+            try {
+                // Accept a single JSON result or newline-delimited CLI diagnostics followed by a result.
+                let result;
+                for (const line of stdout.split(/\r?\n/)) {
+                    try {
+                        const value = JSON.parse(line);
+                        if (value && typeof value === 'object' && value.type === 'result')
+                            result = value;
+                    }
+                    catch { /* Non-JSON diagnostics are retained in errors. */ }
+                }
+                const download = result?.download;
+                const upload = result?.upload;
+                if (typeof download?.bandwidth !== 'number' || !Number.isFinite(download.bandwidth) || download.bandwidth < 0 ||
+                    typeof upload?.bandwidth !== 'number' || !Number.isFinite(upload.bandwidth) || upload.bandwidth < 0) {
+                    throw new Error('Speedtest returned no valid download/upload result');
+                }
+                resolve({ ...result, downloadMbps: download.bandwidth * 8 / 1_000_000, uploadMbps: upload.bandwidth * 8 / 1_000_000 });
+            }
+            catch (error) {
+                reject(new speedtestError_1.SpeedtestError(error.message, 'INVALID_RESULT', diagnostics));
+            }
+        });
+    });
+}
+//# sourceMappingURL=runSpeedtest.js.map

package/dist/nodes/Speedtest/runSpeedtest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSpeedtest.js","sourceRoot":"","sources":["../../../nodes/Speedtest/runSpeedtest.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Speedtest/speedtest.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="12" fill="#182b49"/><path d="M12 46a23 23 0 1 1 40 0" fill="none" stroke="#40c9a2" stroke-width="6"/><path d="m32 36 14-15" stroke="white" stroke-width="5" stroke-linecap="round"/><circle cx="32" cy="36" r="5" fill="white"/></svg>

package/dist/nodes/Speedtest/speedtestError.d.ts

@@ -0,0 +1,14 @@
+import type { IDataObject } from 'n8n-workflow';
+export interface CliDiagnostics {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+    signal?: string | null;
+}
+export declare class SpeedtestError extends Error {
+    readonly code: string;
+    readonly diagnostics: CliDiagnostics;
+    constructor(message: string, code: string, diagnostics?: CliDiagnostics);
+    toJSON(): IDataObject;
+}
+export declare function structuredError(error: Error): IDataObject;

package/dist/nodes/Speedtest/speedtestError.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpeedtestError = void 0;
+exports.structuredError = structuredError;
+class SpeedtestError extends Error {
+    code;
+    diagnostics;
+    constructor(message, code, diagnostics = {}) {
+        super(message);
+        this.code = code;
+        this.diagnostics = diagnostics;
+        this.name = 'SpeedtestError';
+    }
+    toJSON() {
+        const raw = [this.message, this.diagnostics.stderr, this.diagnostics.stdout].filter(Boolean).join('\n');
+        const rateLimited = /limit reached|too many requests|rate.?limit/i.test(raw);
+        // Only accept an explicit CLI retry duration, never infer a reset from a log timestamp.
+        const retry = raw.match(/retry\s+(?:after|in)\s+(\d+)\s*seconds?\b/i);
+        const seconds = rateLimited && retry ? Number(retry[1]) : null;
+        const retryAfterSeconds = seconds !== null && Number.isSafeInteger(seconds) ? seconds : null;
+        return {
+            code: rateLimited ? 'RATE_LIMITED' : this.code,
+            message: this.message,
+            rateLimited,
+            retryAfterSeconds,
+            retryAt: null,
+            retrySource: retryAfterSeconds === null ? null : 'cli_message',
+            ...this.diagnostics,
+        };
+    }
+}
+exports.SpeedtestError = SpeedtestError;
+function structuredError(error) {
+    return error instanceof SpeedtestError
+        ? error.toJSON()
+        : new SpeedtestError(error.message, 'INVALID_CONFIGURATION').toJSON();
+}
+//# sourceMappingURL=speedtestError.js.map

package/dist/nodes/Speedtest/speedtestError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speedtestError.js","sourceRoot":"","sources":["../../../nodes/Speedtest/speedtestError.ts"],"names":[],"mappings":";;;;AASA,oBAA4B,SAAQ,KAAK;IAGvB,IAAI;IACJ,WAAW;IAH5B,YACC,OAAe,EACC,IAAY,EACZ,WAAW,GAAmB,EAAE;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHC,IAAI;2BACJ,WAAW;QAG3B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;IAED,MAAM;QACL,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxG,MAAM,WAAW,GAAG,8CAA8C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,wFAAwF;QACxF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,MAAM,iBAAiB,GAAG,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,OAAO;YACN,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW;YACX,iBAAiB;YACjB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa;YAC9D,GAAG,IAAI,CAAC,WAAW;SACnB,CAAC;IACH,CAAC;CACD;;AAED,yBAAgC,KAAY;IAC3C,OAAO,KAAK,YAAY,cAAc;QACrC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;QAChB,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,MAAM,EAAE,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "n8n-nodes-speedtest-net",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Run Ookla internet speed tests in n8n with structured CLI diagnostics",
+  "license": "MIT",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "speedtest",
+    "speedtest-net"
+  ],
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/copy-assets.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "dist/nodes/Speedtest/Speedtest.node.js"
+    ]
+  },
+  "allowScripts": {
+    "esbuild": true
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "n8n-workflow": "stable",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
+}