@n8n/workflow-sdk 0.14.0 → 0.15.0

package/dist/codegen/emit-instance-ai.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowJSON } from '../types/base';
+export declare const SDK_FUNCTIONS: readonly ["workflow", "trigger", "node", "sticky", "placeholder", "merge", "ifElse", "switchCase", "newCredential", "languageModel", "memory", "tool", "outputParser", "embedding", "embeddings", "vectorStore", "retriever", "documentLoader", "textSplitter", "fromAi", "splitInBatches", "nextBatch", "expr"];
+export interface EmitInstanceAiOptions {
+    jsdocHeader?: string;
+}
+export declare function emitInstanceAi(workflow: WorkflowJSON, opts?: EmitInstanceAiOptions): string;
+export declare function buildImports(body: string): string;
+export declare function hoistSharedCredentials(body: string): string;
+export declare function uniqueConstName(credName: string, used: Set<string>): string;

package/dist/codegen/emit-instance-ai.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_FUNCTIONS = void 0;
+exports.emitInstanceAi = emitInstanceAi;
+exports.buildImports = buildImports;
+exports.hoistSharedCredentials = hoistSharedCredentials;
+exports.uniqueConstName = uniqueConstName;
+const code_generator_1 = require("./code-generator");
+const composite_builder_1 = require("./composite-builder");
+const graph_annotator_1 = require("./graph-annotator");
+const semantic_graph_1 = require("./semantic-graph");
+function generateWorkflowCode(workflow) {
+    const graph = (0, semantic_graph_1.buildSemanticGraph)(workflow);
+    (0, graph_annotator_1.annotateGraph)(graph);
+    const tree = (0, composite_builder_1.buildCompositeTree)(graph);
+    return (0, code_generator_1.generateCode)(tree, workflow, graph, {});
+}
+exports.SDK_FUNCTIONS = [
+    'workflow',
+    'trigger',
+    'node',
+    'sticky',
+    'placeholder',
+    'merge',
+    'ifElse',
+    'switchCase',
+    'newCredential',
+    'languageModel',
+    'memory',
+    'tool',
+    'outputParser',
+    'embedding',
+    'embeddings',
+    'vectorStore',
+    'retriever',
+    'documentLoader',
+    'textSplitter',
+    'fromAi',
+    'splitInBatches',
+    'nextBatch',
+    'expr',
+];
+function emitInstanceAi(workflow, opts = {}) {
+    const body = generateWorkflowCode(workflow);
+    const dedupedBody = hoistSharedCredentials(body);
+    const importLine = buildImports(dedupedBody);
+    const sections = [];
+    if (opts.jsdocHeader)
+        sections.push(opts.jsdocHeader.trim());
+    if (importLine)
+        sections.push(importLine);
+    sections.push(dedupedBody);
+    return sections.join('\n\n') + '\n';
+}
+function buildImports(body) {
+    const used = [];
+    for (const fn of exports.SDK_FUNCTIONS) {
+        if (containsCall(body, fn))
+            used.push(fn);
+    }
+    if (used.length === 0)
+        return '';
+    return `import { ${used.join(', ')} } from '@n8n/workflow-sdk';`;
+}
+function containsCall(body, fnName) {
+    const pattern = new RegExp(`\\b${fnName}\\(`);
+    return pattern.test(body);
+}
+function hoistSharedCredentials(body) {
+    const callPattern = /newCredential\('([^'\\]*)',\s*'([^'\\]*)'\)/g;
+    const groups = new Map();
+    let m;
+    while ((m = callPattern.exec(body)) !== null) {
+        const [match, name, id] = m;
+        const key = `${name}::${id}`;
+        const existing = groups.get(key);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            groups.set(key, { match, name, id, count: 1 });
+        }
+    }
+    const usedNames = collectExistingIdentifiers(body);
+    const hoists = [];
+    let result = body;
+    const dedupable = Array.from(groups.values())
+        .filter((g) => g.count >= 2)
+        .sort((a, b) => body.indexOf(a.match) - body.indexOf(b.match));
+    for (const group of dedupable) {
+        const constName = uniqueConstName(group.name, usedNames);
+        hoists.push(`const ${constName} = ${group.match};`);
+        result = splitJoin(result, group.match, constName);
+    }
+    if (hoists.length === 0)
+        return body;
+    return `${hoists.join('\n')}\n\n${result}`;
+}
+function splitJoin(haystack, needle, replacement) {
+    return haystack.split(needle).join(replacement);
+}
+function uniqueConstName(credName, used) {
+    const sanitised = credName
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    let camel;
+    if (sanitised.length === 0) {
+        camel = 'shared';
+    }
+    else {
+        camel =
+            sanitised[0].charAt(0).toLowerCase() +
+                sanitised[0].slice(1) +
+                sanitised
+                    .slice(1)
+                    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+                    .join('');
+    }
+    const base = `${camel}Cred`;
+    let candidate = base;
+    let i = 1;
+    while (used.has(candidate)) {
+        i++;
+        candidate = `${base}${i}`;
+    }
+    used.add(candidate);
+    return candidate;
+}
+function collectExistingIdentifiers(body) {
+    const ids = new Set();
+    const pattern = /\b([a-zA-Z_][a-zA-Z0-9_]*)\b/g;
+    let m;
+    while ((m = pattern.exec(body)) !== null)
+        ids.add(m[1]);
+    return ids;
+}
+//# sourceMappingURL=emit-instance-ai.js.map

package/dist/codegen/emit-instance-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-instance-ai.js","sourceRoot":"","sources":["../../src/codegen/emit-instance-ai.ts"],"names":[],"mappings":"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"}

package/dist/codegen/index.d.ts

@@ -16,5 +16,6 @@ export { buildSemanticGraph } from './semantic-graph';
 export { annotateGraph } from './graph-annotator';
 export { buildCompositeTree } from './composite-builder';
 export { generateCode } from './code-generator';
+export { emitInstanceAi, type EmitInstanceAiOptions } from './emit-instance-ai';
 export { getOutputName, getInputName, getCompositeType, getNodeSemantics, isCycleOutput, } from './semantic-registry';
 export declare function generateWorkflowCode(input: WorkflowJSON | GenerateWorkflowCodeOptions): string;

package/dist/codegen/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCycleOutput = exports.getNodeSemantics = exports.getCompositeType = exports.getInputName = exports.getOutputName = exports.generateCode = exports.buildCompositeTree = exports.annotateGraph = exports.buildSemanticGraph = void 0;
+exports.isCycleOutput = exports.getNodeSemantics = exports.getCompositeType = exports.getInputName = exports.getOutputName = exports.emitInstanceAi = exports.generateCode = exports.buildCompositeTree = exports.annotateGraph = exports.buildSemanticGraph = void 0;
 exports.generateWorkflowCode = generateWorkflowCode;
 const code_generator_1 = require("./code-generator");
 const composite_builder_1 = require("./composite-builder");
@@ -16,6 +16,8 @@ var composite_builder_2 = require("./composite-builder");
 Object.defineProperty(exports, "buildCompositeTree", { enumerable: true, get: function () { return composite_builder_2.buildCompositeTree; } });
 var code_generator_2 = require("./code-generator");
 Object.defineProperty(exports, "generateCode", { enumerable: true, get: function () { return code_generator_2.generateCode; } });
+var emit_instance_ai_1 = require("./emit-instance-ai");
+Object.defineProperty(exports, "emitInstanceAi", { enumerable: true, get: function () { return emit_instance_ai_1.emitInstanceAi; } });
 var semantic_registry_1 = require("./semantic-registry");
 Object.defineProperty(exports, "getOutputName", { enumerable: true, get: function () { return semantic_registry_1.getOutputName; } });
 Object.defineProperty(exports, "getInputName", { enumerable: true, get: function () { return semantic_registry_1.getInputName; } });

package/dist/codegen/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":";;;AA+FA,oDAqDC;AAtID,qDAAgD;AAChD,2DAAyD;AACzD,yDAA0F;AAC1F,iEAAoE;AACpE,uDAAkD;AAClD,qDAAsD;AAkCtD,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA;AAC3B,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,yDAM6B;AAL5B,kHAAA,aAAa,OAAA;AACb,iHAAA,YAAY,OAAA;AACZ,qHAAA,gBAAgB,OAAA;AAChB,qHAAA,gBAAgB,OAAA;AAChB,kHAAA,aAAa,OAAA;AAMd,SAAS,eAAe,CACvB,KAAiD;IAEjD,OAAO,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;AAC5D,CAAC;AAuBD,SAAgB,oBAAoB,CAAC,KAAiD;IAErF,MAAM,EACL,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,GACX,GAAG,eAAe,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACA,QAAQ,EAAE,KAAK;YACf,eAAe,EAAE,SAAS;YAC1B,gBAAgB,EAAE,SAAS;YAC3B,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,SAAS;SACtB,CAAC;IAGJ,MAAM,KAAK,GAAG,IAAA,mCAAkB,EAAC,QAAQ,CAAC,CAAC;IAG3C,IAAA,+BAAa,EAAC,KAAK,CAAC,CAAC;IAGrB,MAAM,IAAI,GAAG,IAAA,sCAAkB,EAAC,KAAK,CAAC,CAAC;IAGvC,MAAM,qBAAqB,GAAG,IAAA,iDAA0B,EAAC,gBAAgB,CAAC,CAAC;IAC3E,MAAM,mBAAmB,GAAG,IAAA,2CAAwB,EAAC,aAAa,CAAC,CAAC;IAGpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACpD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAGD,MAAM,mBAAmB,GAAG,IAAA,6CAA0B,EAAC,aAAa,CAAC,CAAC;IAGtE,OAAO,IAAA,6BAAY,EAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,qBAAqB,EAAE,qBAAqB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;QACzF,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS;QACnF,WAAW,EAAE,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAC3D,mBAAmB,EAAE,mBAAmB,IAAI,SAAS;QACrD,cAAc;QACd,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":";;;AAgGA,oDAqDC;AAvID,qDAAgD;AAChD,2DAAyD;AACzD,yDAA0F;AAC1F,iEAAoE;AACpE,uDAAkD;AAClD,qDAAsD;AAkCtD,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA;AAC3B,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,uDAAgF;AAAvE,kHAAA,cAAc,OAAA;AACvB,yDAM6B;AAL5B,kHAAA,aAAa,OAAA;AACb,iHAAA,YAAY,OAAA;AACZ,qHAAA,gBAAgB,OAAA;AAChB,qHAAA,gBAAgB,OAAA;AAChB,kHAAA,aAAa,OAAA;AAMd,SAAS,eAAe,CACvB,KAAiD;IAEjD,OAAO,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;AAC5D,CAAC;AAuBD,SAAgB,oBAAoB,CAAC,KAAiD;IAErF,MAAM,EACL,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,GACX,GAAG,eAAe,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACA,QAAQ,EAAE,KAAK;YACf,eAAe,EAAE,SAAS;YAC1B,gBAAgB,EAAE,SAAS;YAC3B,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,SAAS;SACtB,CAAC;IAGJ,MAAM,KAAK,GAAG,IAAA,mCAAkB,EAAC,QAAQ,CAAC,CAAC;IAG3C,IAAA,+BAAa,EAAC,KAAK,CAAC,CAAC;IAGrB,MAAM,IAAI,GAAG,IAAA,sCAAkB,EAAC,KAAK,CAAC,CAAC;IAGvC,MAAM,qBAAqB,GAAG,IAAA,iDAA0B,EAAC,gBAAgB,CAAC,CAAC;IAC3E,MAAM,mBAAmB,GAAG,IAAA,2CAAwB,EAAC,aAAa,CAAC,CAAC;IAGpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACpD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAGD,MAAM,mBAAmB,GAAG,IAAA,6CAA0B,EAAC,aAAa,CAAC,CAAC;IAGtE,OAAO,IAAA,6BAAY,EAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,qBAAqB,EAAE,qBAAqB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;QACzF,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS;QACnF,WAAW,EAAE,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAC3D,mBAAmB,EAAE,mBAAmB,IAAI,SAAS;QACrD,cAAc;QACd,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/examples-loader.d.ts

@@ -0,0 +1,10 @@
+export interface ExampleFile {
+    filename: string;
+    content: string;
+}
+export interface ExampleFilesBundle {
+    files: ExampleFile[];
+    indexTxt: string;
+}
+export declare function getExampleFiles(): ExampleFilesBundle;
+export declare function resetExampleFilesCache(): void;

package/dist/examples-loader.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExampleFiles = getExampleFiles;
+exports.resetExampleFilesCache = resetExampleFilesCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const emit_instance_ai_1 = require("./codegen/emit-instance-ai");
+const examples_zip_1 = require("./examples-zip");
+const EXAMPLES_DIR = path.resolve(__dirname, '..', 'examples');
+const MANIFEST_PATH = path.join(EXAMPLES_DIR, 'manifest.json');
+const NODES_INLINE_LIMIT = 5;
+const INDEX_NODE_SEPARATOR = ',';
+let cached = null;
+function getExampleFiles() {
+    if (cached !== null)
+        return cached;
+    cached = loadFromDisk();
+    return cached;
+}
+function resetExampleFilesCache() {
+    cached = null;
+}
+function loadFromDisk() {
+    if (!fs.existsSync(MANIFEST_PATH))
+        return { files: [], indexTxt: '' };
+    (0, examples_zip_1.ensureExtracted)();
+    const manifest = JSON.parse(fs.readFileSync(MANIFEST_PATH, 'utf-8'));
+    const entries = (manifest.workflows ?? [])
+        .filter((e) => e.success && !e.skip)
+        .sort((a, b) => b.score - a.score);
+    const files = [];
+    const indexLines = [];
+    for (const entry of entries) {
+        const wfPath = path.join(examples_zip_1.WORKFLOWS_CACHE_DIR, `${entry.slug}.json`);
+        if (!fs.existsSync(wfPath))
+            continue;
+        const wf = JSON.parse(fs.readFileSync(wfPath, 'utf-8'));
+        const header = buildJsdocHeader(entry);
+        const code = (0, emit_instance_ai_1.emitInstanceAi)(wf, { jsdocHeader: header });
+        files.push({ filename: `${entry.slug}.ts`, content: code });
+        indexLines.push(buildIndexLine(entry));
+    }
+    const indexTxt = indexLines.join('\n') + (indexLines.length > 0 ? '\n' : '');
+    return { files, indexTxt };
+}
+function buildJsdocHeader(entry) {
+    return [
+        '/**',
+        ' * @template',
+        ` * @name ${entry.name}`,
+        ` * @nodes ${entry.nodes.join(', ')}`,
+        ` * @tags ${entry.tags.join(', ')}`,
+        ` * @source ${entry.source}`,
+        ` * @author ${entry.author}`,
+        ' */',
+    ].join('\n');
+}
+function buildIndexLine(entry) {
+    const truncatedNodes = truncateNodes(entry.nodes);
+    return [
+        `${entry.slug}.ts`,
+        entry.name,
+        truncatedNodes,
+        entry.tags.join(','),
+        `n8n:${entry.id}`,
+    ].join(' | ');
+}
+function truncateNodes(nodes) {
+    if (nodes.length <= NODES_INLINE_LIMIT)
+        return nodes.join(INDEX_NODE_SEPARATOR);
+    const head = nodes.slice(0, NODES_INLINE_LIMIT).join(INDEX_NODE_SEPARATOR);
+    const remaining = nodes.length - NODES_INLINE_LIMIT;
+    return `${head} +${remaining} more`;
+}
+//# sourceMappingURL=examples-loader.js.map

package/dist/examples-loader.js.map

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

package/dist/examples-zip.d.ts

@@ -0,0 +1,5 @@
+export declare const WORKFLOWS_CACHE_DIR: string;
+export declare function zipExists(): boolean;
+export declare function needsExtraction(): boolean;
+export declare function extractFromZip(): void;
+export declare function ensureExtracted(): void;

package/dist/examples-zip.js

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOWS_CACHE_DIR = void 0;
+exports.zipExists = zipExists;
+exports.needsExtraction = needsExtraction;
+exports.extractFromZip = extractFromZip;
+exports.ensureExtracted = ensureExtracted;
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const EXAMPLES_DIR = path.resolve(__dirname, '..', 'examples');
+const ZIP_PATH = path.join(EXAMPLES_DIR, 'templates.zip');
+const MANIFEST_PATH = path.join(EXAMPLES_DIR, 'manifest.json');
+function sdkVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, '..', 'package.json');
+        return (JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version ??
+            'unversioned');
+    }
+    catch {
+        return 'unversioned';
+    }
+}
+exports.WORKFLOWS_CACHE_DIR = path.join(os.tmpdir(), 'n8n-workflow-sdk', sdkVersion(), 'workflows');
+function zipExists() {
+    return fs.existsSync(ZIP_PATH);
+}
+function needsExtraction() {
+    if (!fs.existsSync(ZIP_PATH))
+        return false;
+    if (!fs.existsSync(MANIFEST_PATH))
+        return false;
+    const manifest = JSON.parse(fs.readFileSync(MANIFEST_PATH, 'utf-8'));
+    for (const entry of manifest.workflows ?? []) {
+        if (!entry.success || entry.skip)
+            continue;
+        const filePath = path.join(exports.WORKFLOWS_CACHE_DIR, `${entry.slug}.json`);
+        if (!fs.existsSync(filePath))
+            return true;
+    }
+    return false;
+}
+function extractFromZip() {
+    if (!fs.existsSync(ZIP_PATH)) {
+        throw new Error(`Examples zip not found: ${ZIP_PATH}`);
+    }
+    if (!fs.existsSync(exports.WORKFLOWS_CACHE_DIR)) {
+        fs.mkdirSync(exports.WORKFLOWS_CACHE_DIR, { recursive: true });
+    }
+    const zip = new adm_zip_1.default(ZIP_PATH);
+    for (const entry of zip.getEntries()) {
+        if (entry.isDirectory)
+            continue;
+        zip.extractEntryTo(entry, exports.WORKFLOWS_CACHE_DIR, false, true);
+    }
+}
+function ensureExtracted() {
+    if (needsExtraction()) {
+        extractFromZip();
+    }
+}
+//# sourceMappingURL=examples-zip.js.map

package/dist/examples-zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples-zip.js","sourceRoot":"","sources":["../src/examples-zip.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,8BAEC;AAMD,0CAYC;AAMD,wCAaC;AAED,0CAIC;AAvFD,sDAA6B;AAC7B,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAE/D,SAAS,UAAU;IAClB,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAE9D,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAA0B,CAAC,OAAO;YAC/E,aAAa,CACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,aAAa,CAAC;IACtB,CAAC;AACF,CAAC;AAKY,QAAA,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAC3C,EAAE,CAAC,MAAM,EAAE,EACX,kBAAkB,EAClB,UAAU,EAAE,EACZ,WAAW,CACX,CAAC;AAYF,SAAgB,SAAS;IACxB,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAMD,SAAgB,eAAe;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAGhD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAiB,CAAC;IACrF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI;YAAE,SAAS;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,2BAAmB,EAAE,GAAG,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAMD,SAAgB,cAAc;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,2BAAmB,CAAC,EAAE,CAAC;QACzC,EAAE,CAAC,SAAS,CAAC,2BAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,iBAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW;YAAE,SAAS;QAChC,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,2BAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,SAAgB,eAAe;IAC9B,IAAI,eAAe,EAAE,EAAE,CAAC;QACvB,cAAc,EAAE,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/generate-types/generate-types.d.ts

@@ -1,3 +1,10 @@
+export interface BuilderHintVariation {
+    content: string;
+    displayOptions?: {
+        show?: Record<string, unknown[]>;
+        hide?: Record<string, unknown[]>;
+    };
+}
 export interface ParameterBuilderHint {
     propertyHint: string;
     placeholderSupported?: boolean;

package/dist/generate-types/generate-types.js

@@ -235,6 +235,63 @@ const AI_TYPE_TO_SUBNODE_FIELD = {
         canBeMultiple: false,
     },
 };
+function variationApplies(variation, combo) {
+    const opts = variation.displayOptions;
+    if (!combo)
+        return !opts;
+    if (!opts)
+        return false;
+    if (opts.show) {
+        for (const [key, conditions] of Object.entries(opts.show)) {
+            const value = combo[key];
+            if (value === undefined)
+                return false;
+            if (!(0, display_options_1.checkConditions)(conditions, [value]))
+                return false;
+        }
+    }
+    if (opts.hide) {
+        for (const [key, conditions] of Object.entries(opts.hide)) {
+            const value = combo[key];
+            if (value === undefined)
+                continue;
+            if ((0, display_options_1.checkConditions)(conditions, [value]))
+                return false;
+        }
+    }
+    return true;
+}
+function emitBuilderHint(lines, indent, hint, combo) {
+    if (hint.propertyHint) {
+        const safePropertyHint = hint.propertyHint
+            .replace(/\*\//g, '*\\/')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;');
+        lines.push(`${indent} * @builderHint ${safePropertyHint}`);
+    }
+    if (!hint.extraTypeDefContent)
+        return;
+    for (const variation of hint.extraTypeDefContent) {
+        if (!variationApplies(variation, combo))
+            continue;
+        const safe = variation.content.replace(/\*\//g, '*\\/');
+        for (const line of safe.split('\n')) {
+            lines.push(`${indent} * ${line}`);
+        }
+    }
+}
+function getNodeBuilderHint(node) {
+    return node.builderHint;
+}
+function emitNodeHintForCombo(lines, node, combo) {
+    const hint = getNodeBuilderHint(node);
+    if (!hint?.extraTypeDefContent?.some((v) => variationApplies(v, combo)))
+        return;
+    const hintLines = [`${INDENT}/**`];
+    emitBuilderHint(hintLines, INDENT, { extraTypeDefContent: hint.extraTypeDefContent }, combo);
+    hintLines.push(`${INDENT} */`);
+    lines.push(...hintLines);
+}
 const schemaCache = new Map();
 function findNestedSchemaDir(dir, targetNames) {
     let entries;
@@ -585,11 +642,7 @@ function generateNestedPropertyJSDoc(prop, indent, discriminatorContext) {
         lines.push(`${indent} * @hint ${safeHint}`);
     }
     if (prop.builderHint) {
-        const safeBuilderHint = prop.builderHint.propertyHint
-            .replace(/\*\//g, '*\\/')
-            .replace(/</g, '&lt;')
-            .replace(/>/g, '&gt;');
-        lines.push(`${indent} * @builderHint ${safeBuilderHint}`);
+        emitBuilderHint(lines, indent, prop.builderHint);
     }
     if (prop.builderHint?.placeholderSupported === false) {
         lines.push(`${indent} * @placeholderSupported false`);
@@ -711,14 +764,10 @@ function generateFixedCollectionType(prop, discriminatorContext) {
                 groupJsDocLines.push(`${INDENT.repeat(2)}/** ${desc}`);
             }
             if (group.builderHint) {
-                const safeBuilderHint = group.builderHint.propertyHint
-                    .replace(/\*\//g, '*\\/')
-                    .replace(/</g, '&lt;')
-                    .replace(/>/g, '&gt;');
                 if (groupJsDocLines.length === 0) {
                     groupJsDocLines.push(`${INDENT.repeat(2)}/**`);
                 }
-                groupJsDocLines.push(`${INDENT.repeat(2)} * @builderHint ${safeBuilderHint}`);
+                emitBuilderHint(groupJsDocLines, INDENT.repeat(2), group.builderHint);
             }
             if (isMultipleValues && hasMinRequired) {
                 if (groupJsDocLines.length === 0) {
@@ -1213,6 +1262,7 @@ function generateDiscriminatedUnion(node) {
             lines.push(`/** ${description} */`);
         }
         lines.push(`export type ${configName} = {`);
+        emitNodeHintForCombo(lines, node, combo);
         for (const [key, value] of Object.entries(combo)) {
             if (value !== undefined) {
                 lines.push(`${INDENT}${key}: '${value}';`);
@@ -1243,11 +1293,7 @@ function generatePropertyJSDoc(prop, discriminatorContext) {
         lines.push(` * @hint ${safeHint}`);
     }
     if (prop.builderHint) {
-        const safeBuilderHint = prop.builderHint.propertyHint
-            .replace(/\*\//g, '*\\/')
-            .replace(/</g, '&lt;')
-            .replace(/>/g, '&gt;');
-        lines.push(` * @builderHint ${safeBuilderHint}`);
+        emitBuilderHint(lines, '', prop.builderHint);
     }
     if (prop.builderHint?.placeholderSupported === false) {
         lines.push(' * @placeholderSupported false');
@@ -1329,6 +1375,13 @@ function generateNodeJSDoc(node) {
     if (subnodeType) {
         lines.push(` * @subnodeType ${subnodeType}`);
     }
+    const nodeHint = getNodeBuilderHint(node);
+    if (nodeHint && (nodeHint.searchHint || nodeHint.extraTypeDefContent?.length)) {
+        emitBuilderHint(lines, '', {
+            propertyHint: nodeHint.searchHint,
+            extraTypeDefContent: nodeHint.extraTypeDefContent,
+        });
+    }
     lines.push(' */');
     return lines.join('\n');
 }
@@ -1629,6 +1682,7 @@ function generateDiscriminatorFile(node, version, combo, props, schema, _importD
         lines.push(`/** ${description} */`);
     }
     lines.push(`export type ${configName} = {`);
+    emitNodeHintForCombo(lines, node, combo);
     for (const [key, value] of Object.entries(combo)) {
         if (value !== undefined) {
             lines.push(`${INDENT}${key}: '${value}';`);
@@ -2177,6 +2231,7 @@ function generateDiscriminatedUnionForEntry(node, nodeName, versionSuffix) {
             lines.push(`/** ${description} */`);
         }
         lines.push(`export type ${configName} = {`);
+        emitNodeHintForCombo(lines, node, combo);
         for (const [key, value] of Object.entries(combo)) {
             if (value !== undefined) {
                 lines.push(`${INDENT}${key}: '${value}';`);