@n8n/ai-utilities 0.16.1 → 0.18.0

package/dist/esm/node-catalog/discriminator-utils.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractModeDiscriminator = extractModeDiscriminator;
+exports.extractOperationOnlyDiscriminator = extractOperationOnlyDiscriminator;
+function extractModeDiscriminator(nodeType, nodeVersion) {
+    const properties = nodeType.properties;
+    if (!properties || properties.length === 0) {
+        return null;
+    }
+    const modeProperty = properties.find((prop) => prop.name === 'mode' &&
+        prop.type === 'options' &&
+        isPropertyVisibleForVersion(prop, nodeVersion) &&
+        !prop.displayOptions?.show?.operation &&
+        !prop.displayOptions?.show?.resource);
+    if (!modeProperty?.options) {
+        return null;
+    }
+    const modes = modeProperty.options
+        .filter((opt) => typeof opt === 'object' && opt !== null && 'value' in opt && typeof opt.value === 'string')
+        .map((opt) => ({
+        value: opt.value,
+        displayName: opt.name,
+        outputConnectionType: opt.outputConnectionType,
+        description: opt.description,
+        builderHint: opt.builderHint,
+    }));
+    if (modes.length === 0) {
+        return null;
+    }
+    return { modes };
+}
+function extractOperationOnlyDiscriminator(nodeType, nodeVersion) {
+    const properties = nodeType.properties;
+    if (!properties || properties.length === 0) {
+        return null;
+    }
+    const hasResource = properties.some((prop) => prop.name === 'resource' &&
+        prop.type === 'options' &&
+        isPropertyVisibleForVersion(prop, nodeVersion));
+    if (hasResource) {
+        return null;
+    }
+    const operationProperty = properties.find((prop) => prop.name === 'operation' &&
+        prop.type === 'options' &&
+        isPropertyVisibleForVersion(prop, nodeVersion));
+    if (!operationProperty?.options) {
+        return null;
+    }
+    const operations = operationProperty.options
+        .filter((opt) => typeof opt === 'object' && opt !== null && 'value' in opt && typeof opt.value === 'string')
+        .map((opt) => ({
+        value: opt.value,
+        displayName: opt.name,
+        description: opt.description,
+        builderHint: opt.builderHint,
+    }));
+    if (operations.length === 0) {
+        return null;
+    }
+    return { operations };
+}
+function isPropertyVisibleForVersion(property, nodeVersion) {
+    const displayOptions = property.displayOptions;
+    if (!displayOptions) {
+        return true;
+    }
+    const showVersion = displayOptions.show?.['@version'];
+    if (showVersion) {
+        if (Array.isArray(showVersion)) {
+            if (!showVersion.includes(nodeVersion)) {
+                return false;
+            }
+        }
+    }
+    const hideVersion = displayOptions.hide?.['@version'];
+    if (hideVersion) {
+        if (Array.isArray(hideVersion)) {
+            if (hideVersion.includes(nodeVersion)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=discriminator-utils.js.map

package/dist/esm/node-catalog/discriminator-utils.js.map

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

package/dist/esm/node-catalog/get.d.ts

@@ -0,0 +1,18 @@
+export declare function isValidPathComponent(component: string): boolean;
+export declare function validatePathWithinBase(filePath: string, baseDir: string): boolean;
+export declare function toSnakeCase(str: string): string;
+export declare function parseNodeId(nodeId: string): {
+    packageName: string;
+    nodeName: string;
+} | null;
+export type NodeRequest = string | {
+    nodeId: string;
+    version?: string;
+    resource?: string;
+    operation?: string;
+    mode?: string;
+};
+export interface CodeBuilderGetToolOptions {
+    nodeDefinitionDirs?: string[];
+}
+export declare function getNodeTypes(nodeIds: NodeRequest[], options?: CodeBuilderGetToolOptions): string;

package/dist/esm/node-catalog/get.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidPathComponent = isValidPathComponent;
+exports.validatePathWithinBase = validatePathWithinBase;
+exports.toSnakeCase = toSnakeCase;
+exports.parseNodeId = parseNodeId;
+exports.getNodeTypes = getNodeTypes;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function isValidPathComponent(component) {
+    if (!component || component.trim() === '') {
+        return false;
+    }
+    if (component.includes('\0')) {
+        return false;
+    }
+    if (component.includes('/') || component.includes('\\')) {
+        return false;
+    }
+    if (component === '..' || component.startsWith('..')) {
+        return false;
+    }
+    return true;
+}
+function validatePathWithinBase(filePath, baseDir) {
+    const resolvedPath = (0, node_path_1.resolve)(filePath);
+    const resolvedBase = (0, node_path_1.resolve)(baseDir);
+    const separator = process.platform === 'win32' ? '\\' : '/';
+    return resolvedPath.startsWith(resolvedBase + separator) || resolvedPath === resolvedBase;
+}
+function getGeneratedNodesPaths(nodeDefinitionDirs) {
+    if (nodeDefinitionDirs && nodeDefinitionDirs.length > 0) {
+        return nodeDefinitionDirs.map((dir) => (0, node_path_1.join)(dir, 'nodes'));
+    }
+    return [];
+}
+function findNodeDir(parsed, nodesPaths) {
+    const candidates = [parsed.nodeName];
+    const baseName = parsed.nodeName.replace(/(?:HitlTool|Tool)$/, '');
+    if (baseName !== parsed.nodeName)
+        candidates.push(baseName);
+    for (const candidate of candidates) {
+        for (const nodesPath of nodesPaths) {
+            const nodeDir = (0, node_path_1.join)(nodesPath, parsed.packageName, candidate);
+            if ((0, node_fs_1.existsSync)(nodeDir)) {
+                return { nodesPath, nodeDir };
+            }
+        }
+    }
+    return null;
+}
+function toSnakeCase(str) {
+    return str
+        .replace(/([A-Z])/g, '_$1')
+        .toLowerCase()
+        .replace(/^_/, '')
+        .replace(/[-\s]+/g, '_');
+}
+function isSplitVersionStructure(nodeDir, versionStr) {
+    const versionDir = (0, node_path_1.join)(nodeDir, versionStr);
+    return (0, node_fs_1.existsSync)(versionDir) && (0, node_fs_1.statSync)(versionDir).isDirectory();
+}
+function getAvailableDiscriminators(nodeDir, versionStr) {
+    const versionDir = (0, node_path_1.join)(nodeDir, versionStr);
+    if (!(0, node_fs_1.existsSync)(versionDir)) {
+        return {};
+    }
+    try {
+        const entries = (0, node_fs_1.readdirSync)(versionDir, { withFileTypes: true });
+        const resources = [];
+        const modes = [];
+        for (const entry of entries) {
+            if (entry.isDirectory() && entry.name.startsWith('resource_')) {
+                resources.push(entry.name.replace('resource_', ''));
+            }
+            else if (entry.isFile() && entry.name.startsWith('mode_') && entry.name.endsWith('.ts')) {
+                modes.push(entry.name.replace('mode_', '').replace('.ts', ''));
+            }
+        }
+        return {
+            resources: resources.length > 0 ? resources : undefined,
+            modes: modes.length > 0 ? modes : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function parseNodeId(nodeId) {
+    if (nodeId.startsWith('@n8n/')) {
+        const withoutPrefix = nodeId.slice(5);
+        const dotIndex = withoutPrefix.indexOf('.');
+        if (dotIndex === -1) {
+            return null;
+        }
+        return {
+            packageName: withoutPrefix.slice(0, dotIndex),
+            nodeName: withoutPrefix.slice(dotIndex + 1),
+        };
+    }
+    const dotIndex = nodeId.indexOf('.');
+    if (dotIndex === -1) {
+        return null;
+    }
+    return {
+        packageName: nodeId.slice(0, dotIndex),
+        nodeName: nodeId.slice(dotIndex + 1),
+    };
+}
+function getNodeVersions(nodeId, nodeDefinitionDirs) {
+    const parsed = parseNodeId(nodeId);
+    if (!parsed) {
+        return [];
+    }
+    const nodesPaths = getGeneratedNodesPaths(nodeDefinitionDirs);
+    const found = findNodeDir(parsed, nodesPaths);
+    if (!found) {
+        return [];
+    }
+    const { nodeDir } = found;
+    try {
+        const entries = (0, node_fs_1.readdirSync)(nodeDir, { withFileTypes: true });
+        const versions = [];
+        for (const entry of entries) {
+            if (entry.isFile() &&
+                entry.name.startsWith('v') &&
+                entry.name.endsWith('.ts') &&
+                entry.name !== 'index.ts' &&
+                !entry.name.endsWith('.schema.js')) {
+                versions.push(entry.name.replace('.ts', ''));
+            }
+            else if (entry.isDirectory() && /^v\d+$/.test(entry.name)) {
+                versions.push(entry.name);
+            }
+        }
+        versions.sort((a, b) => {
+            const aNum = parseInt(a.slice(1), 10);
+            const bNum = parseInt(b.slice(1), 10);
+            return bNum - aNum;
+        });
+        return versions;
+    }
+    catch {
+        return [];
+    }
+}
+function resolveResourceOperationPath(nodeDir, targetVersion, nodeId, available, discriminators) {
+    if (!discriminators?.resource || !discriminators?.operation) {
+        return {
+            error: `Error: Node '${nodeId}' requires resource and operation discriminators. Available resources: ${available.resources?.join(', ')}. Use search_nodes to see all options.`,
+            requiresDiscriminators: true,
+            availableDiscriminators: available,
+        };
+    }
+    if (!isValidPathComponent(discriminators.resource)) {
+        return {
+            error: `Error: Invalid resource value '${discriminators.resource}' - contains invalid characters`,
+        };
+    }
+    if (!isValidPathComponent(discriminators.operation)) {
+        return {
+            error: `Error: Invalid operation value '${discriminators.operation}' - contains invalid characters`,
+        };
+    }
+    const resourcePath = `resource_${toSnakeCase(discriminators.resource)}`;
+    const resourceDir = (0, node_path_1.join)(nodeDir, targetVersion, resourcePath);
+    if (!(0, node_fs_1.existsSync)(resourceDir)) {
+        return {
+            error: `Error: Invalid resource '${discriminators.resource}' for node '${nodeId}'. Available: ${available.resources?.join(', ')}`,
+        };
+    }
+    const operationFile = `operation_${toSnakeCase(discriminators.operation)}.ts`;
+    const filePath = (0, node_path_1.join)(resourceDir, operationFile);
+    if (!validatePathWithinBase(filePath, nodeDir)) {
+        return {
+            error: 'Error: Invalid path - path traversal detected',
+        };
+    }
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        try {
+            const ops = (0, node_fs_1.readdirSync)(resourceDir)
+                .filter((f) => f.startsWith('operation_') && f.endsWith('.ts'))
+                .map((f) => f.replace('operation_', '').replace('.ts', ''));
+            return {
+                error: `Error: Invalid operation '${discriminators.operation}' for resource '${discriminators.resource}'. Available: ${ops.join(', ')}`,
+            };
+        }
+        catch {
+            return {
+                error: `Error: Could not read operations for resource '${discriminators.resource}'`,
+            };
+        }
+    }
+    return { filePath };
+}
+function resolveModePath(nodeDir, targetVersion, nodeId, available, mode) {
+    if (!mode) {
+        return {
+            error: `Error: Node '${nodeId}' requires mode discriminator. Available modes: ${available.modes?.join(', ')}. Use search_nodes to see all options.`,
+            requiresDiscriminators: true,
+            availableDiscriminators: available,
+        };
+    }
+    if (!isValidPathComponent(mode)) {
+        return {
+            error: `Error: Invalid mode value '${mode}' - contains invalid characters`,
+        };
+    }
+    const modeFile = `mode_${toSnakeCase(mode)}.ts`;
+    const filePath = (0, node_path_1.join)(nodeDir, targetVersion, modeFile);
+    if (!validatePathWithinBase(filePath, nodeDir)) {
+        return {
+            error: 'Error: Invalid path - path traversal detected',
+        };
+    }
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        return {
+            error: `Error: Invalid mode '${mode}' for node '${nodeId}'. Available: ${available.modes?.join(', ')}`,
+        };
+    }
+    return { filePath };
+}
+function getNodeFilePath(nodeId, version, nodeDefinitionDirs, discriminators) {
+    const parsed = parseNodeId(nodeId);
+    if (!parsed) {
+        return { error: `Invalid node ID format: '${nodeId}'` };
+    }
+    if (!isValidPathComponent(parsed.packageName)) {
+        return {
+            error: `Error: Invalid package name in node ID '${nodeId}' - contains invalid characters`,
+        };
+    }
+    if (!isValidPathComponent(parsed.nodeName)) {
+        return {
+            error: `Error: Invalid node name in node ID '${nodeId}' - contains invalid characters`,
+        };
+    }
+    const nodesPaths = getGeneratedNodesPaths(nodeDefinitionDirs);
+    const found = findNodeDir(parsed, nodesPaths);
+    if (!found) {
+        return {
+            error: `Node type '${nodeId}' not found. Use search_node to find the correct node ID.`,
+        };
+    }
+    const { nodesPath, nodeDir } = found;
+    if (!validatePathWithinBase(nodeDir, nodesPath)) {
+        return { error: 'Error: Invalid path - path traversal detected' };
+    }
+    let targetVersion = version;
+    if (!targetVersion) {
+        const versions = getNodeVersions(nodeId, nodeDefinitionDirs);
+        if (versions.length === 0) {
+            return { error: `No versions found for node '${nodeId}'` };
+        }
+        targetVersion = versions[0];
+    }
+    if (!targetVersion.startsWith('v')) {
+        targetVersion = `v${targetVersion.replace('.', '')}`;
+    }
+    else {
+        targetVersion = `v${targetVersion.slice(1).replace('.', '')}`;
+    }
+    if (isSplitVersionStructure(nodeDir, targetVersion)) {
+        const available = getAvailableDiscriminators(nodeDir, targetVersion);
+        if (available.resources && available.resources.length > 0) {
+            return resolveResourceOperationPath(nodeDir, targetVersion, nodeId, available, discriminators);
+        }
+        if (available.modes && available.modes.length > 0) {
+            return resolveModePath(nodeDir, targetVersion, nodeId, available, discriminators?.mode);
+        }
+        return {
+            error: `Error: Node '${nodeId}' has split structure but no recognized discriminators found`,
+        };
+    }
+    const filePath = (0, node_path_1.join)(nodeDir, `${targetVersion}.ts`);
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        return { error: `Version '${version}' not found for node '${nodeId}'` };
+    }
+    return { filePath };
+}
+function getNodeTypeDefinition(nodeId, version, nodeDefinitionDirs, discriminators) {
+    const nodesPaths = getGeneratedNodesPaths(nodeDefinitionDirs);
+    const anyDirExists = nodesPaths.some((p) => (0, node_fs_1.existsSync)(p));
+    if (!anyDirExists) {
+        const errorMsg = nodeDefinitionDirs
+            ? 'Node types directory not found in any of the configured dirs. Types may not have been generated yet.'
+            : 'Node types not found. The generated types directory does not exist. Ensure the application has started properly and types have been generated.';
+        return {
+            nodeId,
+            content: '',
+            error: errorMsg,
+        };
+    }
+    const pathResult = getNodeFilePath(nodeId, version, nodeDefinitionDirs, discriminators);
+    if (pathResult.error) {
+        const availableVersions = getNodeVersions(nodeId, nodeDefinitionDirs);
+        return {
+            nodeId,
+            version,
+            content: '',
+            availableVersions: availableVersions.length > 0 ? availableVersions : undefined,
+            error: pathResult.error,
+        };
+    }
+    if (!pathResult.filePath) {
+        return {
+            nodeId,
+            content: '',
+            error: `Node type '${nodeId}' not found. Use search_node to find the correct node ID.`,
+        };
+    }
+    try {
+        const content = (0, node_fs_1.readFileSync)(pathResult.filePath, 'utf-8');
+        const actualVersion = pathResult.filePath.match(/\/(v\d+)(?:\/|\.ts)/)?.[1];
+        return { nodeId, version: actualVersion, content };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            nodeId,
+            content: '',
+            error: `Error reading node definition for '${nodeId}': ${errorMessage}`,
+        };
+    }
+}
+function getNodeTypes(nodeIds, options = {}) {
+    const { nodeDefinitionDirs } = options;
+    const results = [];
+    const errors = [];
+    for (const nodeRequest of nodeIds) {
+        const nodeId = typeof nodeRequest === 'string' ? nodeRequest : nodeRequest.nodeId;
+        const version = typeof nodeRequest === 'string' ? undefined : nodeRequest.version;
+        const discriminators = typeof nodeRequest === 'string'
+            ? undefined
+            : {
+                resource: nodeRequest.resource,
+                operation: nodeRequest.operation,
+                mode: nodeRequest.mode,
+            };
+        const result = getNodeTypeDefinition(nodeId, version, nodeDefinitionDirs, discriminators);
+        if (result.error) {
+            errors.push(result.error);
+        }
+        else {
+            const versionLabel = result.version ? ` (${result.version})` : '';
+            results.push(`## ${nodeId}${versionLabel}\n\n\`\`\`typescript\n${result.content}\n\`\`\``);
+        }
+    }
+    let response = '';
+    if (results.length > 0) {
+        response += `# TypeScript Type Definitions\n\n${results.join('\n\n---\n\n')}`;
+    }
+    if (errors.length > 0) {
+        response += `\n\n# Errors\n\n${errors.join('\n')}`;
+    }
+    return response;
+}
+//# sourceMappingURL=get.js.map

package/dist/esm/node-catalog/get.js.map

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

package/dist/esm/node-catalog/index.d.ts

@@ -0,0 +1,14 @@
+export { NodeTypeParser } from './node-type-parser';
+export type { ParsedNodeType } from './node-type-parser';
+export { CodeBuilderNodeSearchEngine, SCORE_WEIGHTS } from './search-engine';
+export { searchCodeBuilderNodes, formatNodeResult } from './search';
+export type { CodeBuilderSearchResult, CodeBuilderSearchToolOptions, } from './search';
+export { getNodeTypes, isValidPathComponent, validatePathWithinBase, parseNodeId, toSnakeCase, } from './get';
+export type { NodeRequest, CodeBuilderGetToolOptions } from './get';
+export { getSuggestedNodes, categoryList } from './suggested';
+export { suggestedNodesData, type CategoryData, type CategorySuggestedNode, } from './suggested-nodes-data';
+export { extractModeDiscriminator, extractOperationOnlyDiscriminator, } from './discriminator-utils';
+export type { ModeInfo, ModeDiscriminatorInfo, OperationOnlyInfo, OperationOnlyDiscriminatorInfo, } from './discriminator-utils';
+export { extractResourceOperations, createResourceCacheKey, formatResourceOperationsForPrompt, } from './resource-operation-extractor';
+export type { OperationInfo, ResourceInfo, ResourceOperationInfo, ExtractOptions, } from './resource-operation-extractor';
+export type { SubnodeRequirement, CodeBuilderNodeSearchResult } from './types';

package/dist/esm/node-catalog/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatResourceOperationsForPrompt = exports.createResourceCacheKey = exports.extractResourceOperations = exports.extractOperationOnlyDiscriminator = exports.extractModeDiscriminator = exports.suggestedNodesData = exports.categoryList = exports.getSuggestedNodes = exports.toSnakeCase = exports.parseNodeId = exports.validatePathWithinBase = exports.isValidPathComponent = exports.getNodeTypes = exports.formatNodeResult = exports.searchCodeBuilderNodes = exports.SCORE_WEIGHTS = exports.CodeBuilderNodeSearchEngine = exports.NodeTypeParser = void 0;
+var node_type_parser_1 = require("./node-type-parser");
+Object.defineProperty(exports, "NodeTypeParser", { enumerable: true, get: function () { return node_type_parser_1.NodeTypeParser; } });
+var search_engine_1 = require("./search-engine");
+Object.defineProperty(exports, "CodeBuilderNodeSearchEngine", { enumerable: true, get: function () { return search_engine_1.CodeBuilderNodeSearchEngine; } });
+Object.defineProperty(exports, "SCORE_WEIGHTS", { enumerable: true, get: function () { return search_engine_1.SCORE_WEIGHTS; } });
+var search_1 = require("./search");
+Object.defineProperty(exports, "searchCodeBuilderNodes", { enumerable: true, get: function () { return search_1.searchCodeBuilderNodes; } });
+Object.defineProperty(exports, "formatNodeResult", { enumerable: true, get: function () { return search_1.formatNodeResult; } });
+var get_1 = require("./get");
+Object.defineProperty(exports, "getNodeTypes", { enumerable: true, get: function () { return get_1.getNodeTypes; } });
+Object.defineProperty(exports, "isValidPathComponent", { enumerable: true, get: function () { return get_1.isValidPathComponent; } });
+Object.defineProperty(exports, "validatePathWithinBase", { enumerable: true, get: function () { return get_1.validatePathWithinBase; } });
+Object.defineProperty(exports, "parseNodeId", { enumerable: true, get: function () { return get_1.parseNodeId; } });
+Object.defineProperty(exports, "toSnakeCase", { enumerable: true, get: function () { return get_1.toSnakeCase; } });
+var suggested_1 = require("./suggested");
+Object.defineProperty(exports, "getSuggestedNodes", { enumerable: true, get: function () { return suggested_1.getSuggestedNodes; } });
+Object.defineProperty(exports, "categoryList", { enumerable: true, get: function () { return suggested_1.categoryList; } });
+var suggested_nodes_data_1 = require("./suggested-nodes-data");
+Object.defineProperty(exports, "suggestedNodesData", { enumerable: true, get: function () { return suggested_nodes_data_1.suggestedNodesData; } });
+var discriminator_utils_1 = require("./discriminator-utils");
+Object.defineProperty(exports, "extractModeDiscriminator", { enumerable: true, get: function () { return discriminator_utils_1.extractModeDiscriminator; } });
+Object.defineProperty(exports, "extractOperationOnlyDiscriminator", { enumerable: true, get: function () { return discriminator_utils_1.extractOperationOnlyDiscriminator; } });
+var resource_operation_extractor_1 = require("./resource-operation-extractor");
+Object.defineProperty(exports, "extractResourceOperations", { enumerable: true, get: function () { return resource_operation_extractor_1.extractResourceOperations; } });
+Object.defineProperty(exports, "createResourceCacheKey", { enumerable: true, get: function () { return resource_operation_extractor_1.createResourceCacheKey; } });
+Object.defineProperty(exports, "formatResourceOperationsForPrompt", { enumerable: true, get: function () { return resource_operation_extractor_1.formatResourceOperationsForPrompt; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/node-catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node-catalog/index.ts"],"names":[],"mappings":";;;AAUA,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AAGvB,iDAA6E;AAApE,4HAAA,2BAA2B,OAAA;AAAE,8GAAA,aAAa,OAAA;AAEnD,mCAAoE;AAA3D,gHAAA,sBAAsB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAMjD,6BAMe;AALd,mGAAA,YAAY,OAAA;AACZ,2GAAA,oBAAoB,OAAA;AACpB,6GAAA,sBAAsB,OAAA;AACtB,kGAAA,WAAW,OAAA;AACX,kGAAA,WAAW,OAAA;AAIZ,yCAA8D;AAArD,8GAAA,iBAAiB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAExC,+DAIgC;AAH/B,0HAAA,kBAAkB,OAAA;AAKnB,6DAG+B;AAF9B,+HAAA,wBAAwB,OAAA;AACxB,wIAAA,iCAAiC,OAAA;AASlC,+EAIwC;AAHvC,yIAAA,yBAAyB,OAAA;AACzB,sIAAA,sBAAsB,OAAA;AACtB,iJAAA,iCAAiC,OAAA"}

package/dist/esm/node-catalog/lean-node-type.d.ts

@@ -0,0 +1,27 @@
+import type { INodeTypeDescription, IRelatedNode } from 'n8n-workflow';
+import { type ModeDiscriminatorInfo, type OperationOnlyDiscriminatorInfo } from './discriminator-utils';
+import { type ResourceOperationInfo } from './resource-operation-extractor';
+export interface VersionDiscriminators {
+    resourceOperations: ResourceOperationInfo | null;
+    modeDiscriminator: ModeDiscriminatorInfo | null;
+    operationDiscriminator: OperationOnlyDiscriminatorInfo | null;
+}
+export interface LeanNodeTypeDescription {
+    name: string;
+    displayName: string;
+    description: string;
+    version: number | number[];
+    group: INodeTypeDescription['group'];
+    inputs: INodeTypeDescription['inputs'];
+    outputs: INodeTypeDescription['outputs'];
+    codex?: {
+        alias?: string[];
+    };
+    builderHint?: {
+        searchHint?: string;
+        relatedNodes?: IRelatedNode[];
+        inputs?: NonNullable<INodeTypeDescription['builderHint']>['inputs'];
+    };
+    discriminatorsByVersion: Map<number, VersionDiscriminators>;
+}
+export declare function toLeanNodeType(node: INodeTypeDescription): LeanNodeTypeDescription;

package/dist/esm/node-catalog/lean-node-type.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLeanNodeType = toLeanNodeType;
+const discriminator_utils_1 = require("./discriminator-utils");
+const resource_operation_extractor_1 = require("./resource-operation-extractor");
+function getVersions(node) {
+    return Array.isArray(node.version) ? node.version : [node.version];
+}
+function buildVersionDiscriminators(node) {
+    const out = new Map();
+    for (const version of getVersions(node)) {
+        out.set(version, {
+            resourceOperations: (0, resource_operation_extractor_1.extractResourceOperations)(node, version, undefined, {
+                fields: { description: true, builderHint: true },
+            }),
+            modeDiscriminator: (0, discriminator_utils_1.extractModeDiscriminator)(node, version),
+            operationDiscriminator: (0, discriminator_utils_1.extractOperationOnlyDiscriminator)(node, version),
+        });
+    }
+    return out;
+}
+function toLeanNodeType(node) {
+    const lean = {
+        name: node.name,
+        displayName: node.displayName,
+        description: node.description,
+        version: node.version,
+        group: node.group,
+        inputs: node.inputs,
+        outputs: node.outputs,
+        discriminatorsByVersion: buildVersionDiscriminators(node),
+    };
+    if (node.codex?.alias) {
+        lean.codex = { alias: node.codex.alias };
+    }
+    if (node.builderHint) {
+        const { searchHint, relatedNodes, inputs } = node.builderHint;
+        const hint = {};
+        if (searchHint !== undefined)
+            hint.searchHint = searchHint;
+        if (relatedNodes !== undefined)
+            hint.relatedNodes = relatedNodes;
+        if (inputs !== undefined)
+            hint.inputs = inputs;
+        if (Object.keys(hint).length > 0)
+            lean.builderHint = hint;
+    }
+    return lean;
+}
+//# sourceMappingURL=lean-node-type.js.map

package/dist/esm/node-catalog/lean-node-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lean-node-type.js","sourceRoot":"","sources":["../../../src/node-catalog/lean-node-type.ts"],"names":[],"mappings":";;AAuFA,wCA0BC;AAhGD,+DAK+B;AAC/B,iFAGwC;AAmCxC,SAAS,WAAW,CAAC,IAA0B;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,0BAA0B,CAClC,IAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiC,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE;YAChB,kBAAkB,EAAE,IAAA,wDAAyB,EAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE;gBACvE,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;aAChD,CAAC;YACF,iBAAiB,EAAE,IAAA,8CAAwB,EAAC,IAAI,EAAE,OAAO,CAAC;YAC1D,sBAAsB,EAAE,IAAA,uDAAiC,EAAC,IAAI,EAAE,OAAO,CAAC;SACxE,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAQD,SAAgB,cAAc,CAAC,IAA0B;IACxD,MAAM,IAAI,GAA4B;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,uBAAuB,EAAE,0BAA0B,CAAC,IAAI,CAAC;KACzD,CAAC;IAEF,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAC9D,MAAM,IAAI,GAA2C,EAAE,CAAC;QACxD,IAAI,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC3D,IAAI,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjE,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/esm/node-catalog/node-type-parser.d.ts

@@ -0,0 +1,20 @@
+import type { INodeTypeDescription } from 'n8n-workflow';
+import { type LeanNodeTypeDescription, type VersionDiscriminators } from './lean-node-type';
+export interface ParsedNodeType {
+    id: string;
+    displayName: string;
+    description: string;
+    version: number;
+    isTrigger: boolean;
+}
+export declare class NodeTypeParser {
+    private nodeTypes;
+    private nodeTypeIndex;
+    private searchEngine;
+    constructor(nodeTypes: INodeTypeDescription[]);
+    private buildIndex;
+    private isTriggerNode;
+    searchNodeTypes(query: string, limit?: number, nodeFilter?: (nodeId: string) => boolean): ParsedNodeType[];
+    getLeanNodeType(nodeId: string, version?: number): LeanNodeTypeDescription | null;
+    getVersionDiscriminators(nodeId: string, version: number): VersionDiscriminators | null;
+}