@n8n/workflow-sdk 0.2.0

package/dist/validation/display-options.js

@@ -0,0 +1,194 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkConditions = checkConditions;
+exports.getPropertyValue = getPropertyValue;
+exports.matchesDisplayOptions = matchesDisplayOptions;
+const get_1 = __importDefault(require("lodash/get"));
+const isEqual_1 = __importDefault(require("lodash/isEqual"));
+function isDisplayCondition(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        '_cnd' in value &&
+        Object.keys(value).length === 1);
+}
+function isRegexPath(path) {
+    return path.includes('|') || path.includes('(');
+}
+function getAllPaths(obj, prefix = '') {
+    if (obj === null || obj === undefined || typeof obj !== 'object') {
+        return prefix ? [prefix] : [];
+    }
+    const paths = [];
+    if (prefix)
+        paths.push(prefix);
+    for (const key of Object.keys(obj)) {
+        const newPrefix = prefix ? `${prefix}.${key}` : key;
+        paths.push(...getAllPaths(obj[key], newPrefix));
+    }
+    return paths;
+}
+function getMatchingPathValues(context, regexPath) {
+    const rootParams = context.rootParameters ?? context.parameters;
+    const pattern = regexPath.startsWith('/') ? regexPath.slice(1) : regexPath;
+    const regexPattern = '^' + pattern.replace(/\./g, '\\.').replace(/\\\.\(/g, '.(') + '$';
+    const regex = new RegExp(regexPattern);
+    const allPaths = getAllPaths(rootParams);
+    const matchingValues = [];
+    for (const path of allPaths) {
+        if (regex.test(path)) {
+            const value = (0, get_1.default)(rootParams, path);
+            if (value !== undefined) {
+                matchingValues.push(Array.isArray(value) ? value : [value]);
+            }
+        }
+    }
+    return matchingValues;
+}
+function checkConditions(conditions, actualValues) {
+    return conditions.some((condition) => {
+        if (isDisplayCondition(condition)) {
+            const [key, targetValue] = Object.entries(condition._cnd)[0];
+            if (actualValues.length === 0) {
+                if (key === 'not')
+                    return true;
+                return false;
+            }
+            return actualValues.every((propertyValue) => {
+                if (key === 'eq') {
+                    return (0, isEqual_1.default)(propertyValue, targetValue);
+                }
+                if (key === 'not') {
+                    return !(0, isEqual_1.default)(propertyValue, targetValue);
+                }
+                if (key === 'gte') {
+                    return propertyValue >= targetValue;
+                }
+                if (key === 'lte') {
+                    return propertyValue <= targetValue;
+                }
+                if (key === 'gt') {
+                    return propertyValue > targetValue;
+                }
+                if (key === 'lt') {
+                    return propertyValue < targetValue;
+                }
+                if (key === 'between') {
+                    const { from, to } = targetValue;
+                    return propertyValue >= from && propertyValue <= to;
+                }
+                if (key === 'includes') {
+                    return propertyValue.includes(targetValue);
+                }
+                if (key === 'startsWith') {
+                    return propertyValue.startsWith(targetValue);
+                }
+                if (key === 'endsWith') {
+                    return propertyValue.endsWith(targetValue);
+                }
+                if (key === 'regex') {
+                    return new RegExp(targetValue).test(propertyValue);
+                }
+                if (key === 'exists') {
+                    return propertyValue !== null && propertyValue !== undefined && propertyValue !== '';
+                }
+                return false;
+            });
+        }
+        return actualValues.includes(condition);
+    });
+}
+function getPropertyValue(context, propertyName) {
+    let value;
+    if (propertyName.charAt(0) === '/') {
+        const rootParams = context.rootParameters ?? context.parameters;
+        value = (0, get_1.default)(rootParams, propertyName.slice(1));
+        if (value === undefined && context.defaults) {
+            value = (0, get_1.default)(context.defaults, propertyName.slice(1));
+        }
+    }
+    else if (propertyName === '@version') {
+        value = context.nodeVersion ?? 0;
+    }
+    else if (propertyName === '@tool') {
+        value = context.isToolNode ?? false;
+    }
+    else {
+        value = (0, get_1.default)(context.parameters, propertyName);
+        if (value === undefined && context.defaults) {
+            value = (0, get_1.default)(context.defaults, propertyName);
+        }
+    }
+    if (value && typeof value === 'object' && '__rl' in value) {
+        const rlValue = value;
+        if (rlValue.__rl === true && 'value' in rlValue) {
+            value = rlValue.value;
+        }
+    }
+    if (!Array.isArray(value)) {
+        return [value];
+    }
+    return value;
+}
+function getRawPropertyValue(context, propertyName) {
+    if (propertyName.charAt(0) === '/') {
+        const rootParams = context.rootParameters ?? context.parameters;
+        return (0, get_1.default)(rootParams, propertyName.slice(1));
+    }
+    if (propertyName === '@version' || propertyName === '@tool') {
+        return undefined;
+    }
+    return (0, get_1.default)(context.parameters, propertyName);
+}
+function isUnselectedResourceLocator(value) {
+    if (!value || typeof value !== 'object' || !('__rl' in value))
+        return false;
+    const rl = value;
+    return rl.__rl === true && rl.value === '';
+}
+function matchesDisplayOptions(context, displayOptions) {
+    const { show, hide } = displayOptions;
+    if (show) {
+        for (const propertyName of Object.keys(show)) {
+            const conditions = show[propertyName];
+            if (isRegexPath(propertyName)) {
+                const matchingPathValues = getMatchingPathValues(context, propertyName);
+                if (matchingPathValues.length === 0) {
+                    return false;
+                }
+                const anyMatch = matchingPathValues.some((values) => {
+                    if (values.some((v) => typeof v === 'string' && v.charAt(0) === '=')) {
+                        return true;
+                    }
+                    return checkConditions(conditions, values);
+                });
+                if (!anyMatch) {
+                    return false;
+                }
+                continue;
+            }
+            const values = getPropertyValue(context, propertyName);
+            if (values.some((v) => typeof v === 'string' && v.charAt(0) === '=')) {
+                return true;
+            }
+            if (!checkConditions(conditions, values)) {
+                return false;
+            }
+        }
+    }
+    if (hide) {
+        for (const propertyName of Object.keys(hide)) {
+            if (isUnselectedResourceLocator(getRawPropertyValue(context, propertyName))) {
+                continue;
+            }
+            const values = getPropertyValue(context, propertyName);
+            if (values.length !== 0 && checkConditions(hide[propertyName], values)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=display-options.js.map

package/dist/validation/display-options.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,34 @@
+import type { INodeTypes } from 'n8n-workflow';
+import type { WorkflowBuilder, WorkflowJSON } from '../types/base';
+export { setSchemaBaseDirs } from './schema-validator';
+export type ValidationErrorCode = 'NO_NODES' | 'MISSING_TRIGGER' | 'DISCONNECTED_NODE' | 'MISSING_PARAMETER' | 'INVALID_CONNECTION' | 'CIRCULAR_REFERENCE' | 'INVALID_EXPRESSION' | 'AGENT_STATIC_PROMPT' | 'AGENT_NO_SYSTEM_MESSAGE' | 'HARDCODED_CREDENTIALS' | 'SET_CREDENTIAL_FIELD' | 'MERGE_SINGLE_INPUT' | 'TOOL_NO_PARAMETERS' | 'FROM_AI_IN_NON_TOOL' | 'MISSING_EXPRESSION_PREFIX' | 'INVALID_PARAMETER' | 'INVALID_INPUT_INDEX' | 'SUBNODE_NOT_CONNECTED' | 'SUBNODE_PARAMETER_MISMATCH' | 'UNSUPPORTED_SUBNODE_INPUT' | 'MAX_NODES_EXCEEDED' | 'INVALID_EXPRESSION_PATH' | 'PARTIAL_EXPRESSION_PATH' | 'INVALID_DATE_METHOD';
+export declare class ValidationError {
+    readonly code: ValidationErrorCode;
+    readonly message: string;
+    readonly nodeName?: string;
+    readonly parameterName?: string;
+    readonly violationLevel?: 'critical' | 'major' | 'minor';
+    constructor(code: ValidationErrorCode, message: string, nodeName?: string, parameterName?: string, violationLevel?: 'critical' | 'major' | 'minor');
+}
+export declare class ValidationWarning {
+    readonly code: ValidationErrorCode;
+    readonly message: string;
+    readonly nodeName?: string;
+    readonly parameterPath?: string;
+    readonly originalName?: string;
+    readonly violationLevel?: 'critical' | 'major' | 'minor';
+    constructor(code: ValidationErrorCode, message: string, nodeName?: string, parameterPath?: string, originalName?: string, violationLevel?: 'critical' | 'major' | 'minor');
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationOptions {
+    strictMode?: boolean;
+    allowDisconnectedNodes?: boolean;
+    allowNoTrigger?: boolean;
+    validateSchema?: boolean;
+    nodeTypesProvider?: INodeTypes;
+}
+export declare function validateWorkflow(workflowOrJson: WorkflowBuilder | WorkflowJSON, options?: ValidationOptions): ValidationResult;

package/dist/validation/index.js

@@ -0,0 +1,428 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationWarning = exports.ValidationError = exports.setSchemaBaseDirs = void 0;
+exports.validateWorkflow = validateWorkflow;
+const n8n_workflow_1 = require("n8n-workflow");
+const display_options_1 = require("./display-options");
+const input_resolver_1 = require("./input-resolver");
+const schema_validator_1 = require("./schema-validator");
+const node_types_1 = require("../constants/node-types");
+var schema_validator_2 = require("./schema-validator");
+Object.defineProperty(exports, "setSchemaBaseDirs", { enumerable: true, get: function () { return schema_validator_2.setSchemaBaseDirs; } });
+class ValidationError {
+    constructor(code, message, nodeName, parameterName, violationLevel) {
+        this.code = code;
+        this.message = message;
+        this.nodeName = nodeName;
+        this.parameterName = parameterName;
+        this.violationLevel = violationLevel;
+    }
+}
+exports.ValidationError = ValidationError;
+class ValidationWarning {
+    constructor(code, message, nodeName, parameterPath, originalName, violationLevel) {
+        this.code = code;
+        this.message = message;
+        this.nodeName = nodeName;
+        this.parameterPath = parameterPath;
+        this.originalName = originalName;
+        this.violationLevel = violationLevel;
+    }
+}
+exports.ValidationWarning = ValidationWarning;
+function isTriggerNode(type) {
+    return (type.includes('Trigger') ||
+        type.includes('trigger') ||
+        type.includes('Webhook') ||
+        type.includes('webhook') ||
+        type.includes('Schedule') ||
+        type.includes('schedule') ||
+        type.includes('Poll') ||
+        type.includes('poll'));
+}
+const AI_CONNECTION_TYPES = [
+    'ai_languageModel',
+    'ai_memory',
+    'ai_tool',
+    'ai_outputParser',
+    'ai_embedding',
+    'ai_vectorStore',
+    'ai_retriever',
+    'ai_document',
+    'ai_textSplitter',
+    'ai_reranker',
+];
+const AI_CONNECTION_TO_SUBNODE_FIELD = {
+    ai_languageModel: 'model',
+    ai_memory: 'memory',
+    ai_tool: 'tools',
+    ai_outputParser: 'outputParser',
+    ai_embedding: 'embedding',
+    ai_vectorStore: 'vectorStore',
+    ai_retriever: 'retriever',
+    ai_document: 'documentLoader',
+    ai_textSplitter: 'textSplitter',
+    ai_reranker: 'reranker',
+};
+const AI_ARRAY_TYPES = new Set(['ai_tool']);
+function reconstructSubnodesFromConnections(targetNodeName, json) {
+    const subnodes = {};
+    const nodesByName = new Map();
+    for (const node of json.nodes) {
+        if (node.name) {
+            nodesByName.set(node.name, node);
+        }
+    }
+    for (const [sourceNodeName, nodeConnections] of Object.entries(json.connections)) {
+        for (const connType of AI_CONNECTION_TYPES) {
+            const aiConns = nodeConnections[connType];
+            if (!aiConns || !Array.isArray(aiConns))
+                continue;
+            for (const outputs of aiConns) {
+                if (!outputs)
+                    continue;
+                for (const conn of outputs) {
+                    if (conn.node === targetNodeName) {
+                        const subnodeField = AI_CONNECTION_TO_SUBNODE_FIELD[connType];
+                        if (!subnodeField)
+                            continue;
+                        const sourceNode = nodesByName.get(sourceNodeName);
+                        if (!sourceNode)
+                            continue;
+                        const subnodeConfig = {
+                            type: sourceNode.type,
+                            version: sourceNode.typeVersion,
+                            parameters: sourceNode.parameters ?? {},
+                        };
+                        if (AI_ARRAY_TYPES.has(connType)) {
+                            const existing = subnodes[subnodeField];
+                            if (Array.isArray(existing)) {
+                                existing.push(subnodeConfig);
+                            }
+                            else {
+                                subnodes[subnodeField] = [subnodeConfig];
+                            }
+                        }
+                        else {
+                            subnodes[subnodeField] = subnodeConfig;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return Object.keys(subnodes).length > 0 ? subnodes : undefined;
+}
+function hasAiConnectionToParent(nodeName, json) {
+    const nodeConnections = json.connections[nodeName];
+    if (!nodeConnections)
+        return false;
+    for (const connType of AI_CONNECTION_TYPES) {
+        const aiConns = nodeConnections[connType];
+        if (aiConns && Array.isArray(aiConns)) {
+            for (const outputs of aiConns) {
+                if (outputs && outputs.length > 0) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+function isToolSubnode(nodeName, json) {
+    const nodeConnections = json.connections[nodeName];
+    if (!nodeConnections)
+        return false;
+    const toolConns = nodeConnections.ai_tool;
+    if (toolConns && Array.isArray(toolConns)) {
+        for (const outputs of toolConns) {
+            if (outputs && outputs.length > 0) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function findDisconnectedNodes(json) {
+    const hasIncoming = new Set();
+    for (const [_sourceName, nodeConnections] of Object.entries(json.connections)) {
+        if (nodeConnections.main) {
+            for (const outputs of nodeConnections.main) {
+                if (outputs) {
+                    for (const connection of outputs) {
+                        hasIncoming.add(connection.node);
+                    }
+                }
+            }
+        }
+    }
+    const disconnected = [];
+    for (const node of json.nodes) {
+        if (!node.name)
+            continue;
+        if (hasIncoming.has(node.name))
+            continue;
+        if (isTriggerNode(node.type))
+            continue;
+        if ((0, node_types_1.isStickyNoteType)(node.type))
+            continue;
+        if (hasAiConnectionToParent(node.name, json))
+            continue;
+        disconnected.push(node.name);
+    }
+    return disconnected;
+}
+function validateWorkflow(workflowOrJson, options = {}) {
+    const json = 'toJSON' in workflowOrJson ? workflowOrJson.toJSON() : workflowOrJson;
+    const errors = [];
+    const warnings = [];
+    if (!options.allowNoTrigger) {
+        const hasTrigger = json.nodes.some((node) => isTriggerNode(node.type));
+        if (!hasTrigger) {
+            warnings.push(new ValidationWarning('MISSING_TRIGGER', 'Workflow has no trigger node. It will need to be started manually.'));
+        }
+    }
+    if (!options.allowDisconnectedNodes) {
+        const disconnected = findDisconnectedNodes(json);
+        for (const nodeName of disconnected) {
+            warnings.push(new ValidationWarning('DISCONNECTED_NODE', `Node '${nodeName}' is not connected to any input. It will not receive data.`, nodeName));
+        }
+    }
+    if (options.strictMode) {
+        for (const node of json.nodes) {
+            if ((0, node_types_1.isHttpRequestType)(node.type)) {
+                if (!node.parameters?.url && !node.parameters?.requestUrl) {
+                    warnings.push(new ValidationWarning('MISSING_PARAMETER', `HTTP Request node '${node.name}' may be missing URL parameter`, node.name));
+                }
+            }
+        }
+    }
+    if (options.validateSchema !== false) {
+        for (const node of json.nodes) {
+            const version = typeof node.typeVersion === 'string'
+                ? parseFloat(node.typeVersion)
+                : (node.typeVersion ?? 1);
+            const config = {};
+            if (node.parameters !== undefined) {
+                config.parameters = node.parameters;
+            }
+            const nodeWithSubnodes = node;
+            if (nodeWithSubnodes.subnodes !== undefined) {
+                config.subnodes = nodeWithSubnodes.subnodes;
+            }
+            else if (node.name) {
+                const reconstructed = reconstructSubnodesFromConnections(node.name, json);
+                if (reconstructed) {
+                    config.subnodes = reconstructed;
+                }
+            }
+            const isToolNode = node.name ? isToolSubnode(node.name, json) : false;
+            const schemaResult = (0, schema_validator_1.validateNodeConfig)(node.type, version, config, { isToolNode });
+            if (!schemaResult.valid) {
+                for (const error of schemaResult.errors) {
+                    let message = error.message;
+                    if (error.path === 'subnodes' &&
+                        message.includes('Unknown field') &&
+                        options.nodeTypesProvider) {
+                        const nodeType = options.nodeTypesProvider.getByNameAndVersion(node.type, version);
+                        const validInputs = nodeType?.description?.builderHint?.inputs;
+                        if (validInputs) {
+                            const validSubnodes = Object.keys(validInputs)
+                                .map((k) => AI_CONNECTION_TO_SUBNODE_FIELD[k])
+                                .filter(Boolean);
+                            if (validSubnodes.length > 0) {
+                                message = message.replace(/Unknown field\(s\) at "subnodes": (.+)\./, `Invalid subnode(s) $1. This node only accepts: ${validSubnodes.join(', ')}.`);
+                            }
+                        }
+                    }
+                    warnings.push(new ValidationWarning('INVALID_PARAMETER', `Node "${node.name}": ${message}`, node.name));
+                }
+            }
+        }
+    }
+    if (options.nodeTypesProvider) {
+        checkNodeInputIndices(json, options.nodeTypesProvider, warnings);
+        validateSubnodeParameters(json, options.nodeTypesProvider, warnings);
+        validateParentSupportsInputs(json, options.nodeTypesProvider, warnings);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+const AI_CONNECTION_TO_SDK_FUNCTION = {
+    ai_languageModel: 'languageModel()',
+    ai_memory: 'memory()',
+    ai_tool: 'tool()',
+    ai_outputParser: 'outputParser()',
+    ai_embedding: 'embeddings()',
+    ai_vectorStore: 'vectorStore()',
+    ai_retriever: 'retriever()',
+    ai_document: 'documentLoader()',
+    ai_textSplitter: 'textSplitter()',
+    ai_reranker: 'reranker()',
+};
+function checkDisplayOptionsMatch(subnodeParams, displayOptions) {
+    const mismatches = [];
+    if (!displayOptions.show)
+        return { matches: true, mismatches };
+    for (const [paramName, expectedValues] of Object.entries(displayOptions.show)) {
+        if (!expectedValues)
+            continue;
+        const actualValue = subnodeParams[paramName];
+        if (!expectedValues.includes(actualValue)) {
+            mismatches.push({
+                param: paramName,
+                expected: expectedValues,
+                actual: actualValue,
+            });
+        }
+    }
+    return { matches: mismatches.length === 0, mismatches };
+}
+function validateSubnodeParameters(json, nodeTypesProvider, warnings) {
+    const nodesByName = new Map();
+    for (const node of json.nodes) {
+        if (node.name) {
+            nodesByName.set(node.name, node);
+        }
+    }
+    const connectionsByDest = (0, n8n_workflow_1.mapConnectionsByDestination)(json.connections);
+    for (const parentNode of json.nodes) {
+        if (!parentNode.name)
+            continue;
+        const parentNodeType = nodeTypesProvider.getByNameAndVersion(parentNode.type, typeof parentNode.typeVersion === 'string'
+            ? parseFloat(parentNode.typeVersion)
+            : (parentNode.typeVersion ?? 1));
+        const builderHintInputs = parentNodeType?.description?.builderHint?.inputs;
+        if (!builderHintInputs)
+            continue;
+        for (const [connectionType, inputConfig] of Object.entries(builderHintInputs)) {
+            if (!connectionType.startsWith('ai_'))
+                continue;
+            if (!inputConfig?.displayOptions?.show)
+                continue;
+            const incomingConnections = connectionsByDest[parentNode.name]?.[connectionType];
+            if (!incomingConnections)
+                continue;
+            for (const connList of incomingConnections) {
+                if (!connList)
+                    continue;
+                for (const conn of connList) {
+                    const subnodeName = conn.node;
+                    const subnode = nodesByName.get(subnodeName);
+                    if (!subnode?.parameters)
+                        continue;
+                    const { matches, mismatches } = checkDisplayOptionsMatch(subnode.parameters, inputConfig.displayOptions);
+                    if (!matches) {
+                        const sdkFn = AI_CONNECTION_TO_SDK_FUNCTION[connectionType] || connectionType;
+                        const mismatchDetails = mismatches
+                            .map((m) => `${m.param}='${String(m.actual)}' (expected: ${m.expected.map((v) => `'${String(v)}'`).join(' or ')})`)
+                            .join(', ');
+                        warnings.push(new ValidationWarning('SUBNODE_PARAMETER_MISMATCH', `'${subnodeName}' is connected to '${parentNode.name}' using ${sdkFn} but has ${mismatchDetails}. Update parameters to match the SDK function used.`, subnodeName, mismatches[0]?.param));
+                    }
+                }
+            }
+        }
+    }
+}
+function buildConditionSummary(displayOptions, parentParams) {
+    if (!displayOptions.show)
+        return '';
+    const parts = [];
+    for (const [paramName, expectedValues] of Object.entries(displayOptions.show)) {
+        if (!expectedValues)
+            continue;
+        const actual = parentParams[paramName];
+        const expectedStr = expectedValues.map((v) => `'${String(v)}'`).join(' or ');
+        parts.push(`${paramName} should be ${expectedStr} (currently '${String(actual)}')`);
+    }
+    return parts.length > 0 ? `Required: ${parts.join(', ')}.` : '';
+}
+function validateParentSupportsInputs(json, nodeTypesProvider, warnings) {
+    const nodesByName = new Map();
+    for (const node of json.nodes) {
+        if (node.name) {
+            nodesByName.set(node.name, node);
+        }
+    }
+    const connectionsByDest = (0, n8n_workflow_1.mapConnectionsByDestination)(json.connections);
+    for (const parentNode of json.nodes) {
+        if (!parentNode.name)
+            continue;
+        const version = typeof parentNode.typeVersion === 'string'
+            ? parseFloat(parentNode.typeVersion)
+            : (parentNode.typeVersion ?? 1);
+        const parentNodeType = nodeTypesProvider.getByNameAndVersion(parentNode.type, version);
+        const builderHintInputs = parentNodeType?.description?.builderHint?.inputs;
+        if (!builderHintInputs)
+            continue;
+        const parentContext = {
+            parameters: (parentNode.parameters ?? {}),
+            nodeVersion: version,
+            rootParameters: (parentNode.parameters ?? {}),
+        };
+        for (const [connectionType, inputConfig] of Object.entries(builderHintInputs)) {
+            if (!connectionType.startsWith('ai_'))
+                continue;
+            if (!inputConfig?.displayOptions)
+                continue;
+            const parentSupportsInput = (0, display_options_1.matchesDisplayOptions)(parentContext, inputConfig.displayOptions);
+            if (parentSupportsInput)
+                continue;
+            const incomingConnections = connectionsByDest[parentNode.name]?.[connectionType];
+            if (!incomingConnections)
+                continue;
+            for (const connList of incomingConnections) {
+                if (!connList)
+                    continue;
+                for (const conn of connList) {
+                    const subnodeName = conn.node;
+                    const subnodeField = AI_CONNECTION_TO_SUBNODE_FIELD[connectionType] || connectionType;
+                    const conditionDetails = buildConditionSummary(inputConfig.displayOptions, (parentNode.parameters ?? {}));
+                    warnings.push(new ValidationWarning('UNSUPPORTED_SUBNODE_INPUT', `'${subnodeName}' is connected to '${parentNode.name}' as ${subnodeField}, but '${parentNode.name}' does not support ${subnodeField} in its current configuration. ${conditionDetails}`, parentNode.name, undefined, undefined, 'major'));
+                }
+            }
+        }
+    }
+}
+function checkNodeInputIndices(json, nodeTypesProvider, warnings) {
+    const nodesByName = new Map();
+    for (const node of json.nodes) {
+        if (node.name) {
+            nodesByName.set(node.name, node);
+        }
+    }
+    const warnedInputs = new Set();
+    for (const [_sourceName, nodeConnections] of Object.entries(json.connections)) {
+        const mainConnections = nodeConnections.main;
+        if (!mainConnections || !Array.isArray(mainConnections))
+            continue;
+        for (const outputs of mainConnections) {
+            if (!outputs)
+                continue;
+            for (const conn of outputs) {
+                const targetNodeName = conn.node;
+                const targetInputIndex = conn.index;
+                const targetNode = nodesByName.get(targetNodeName);
+                if (!targetNode)
+                    continue;
+                const version = typeof targetNode.typeVersion === 'string'
+                    ? parseFloat(targetNode.typeVersion)
+                    : (targetNode.typeVersion ?? 1);
+                const mainInputCount = (0, input_resolver_1.resolveMainInputCount)(nodeTypesProvider, targetNode.type, version);
+                if (mainInputCount === undefined)
+                    continue;
+                if (targetInputIndex >= mainInputCount) {
+                    const warnKey = `${targetNodeName}:${targetInputIndex}`;
+                    if (!warnedInputs.has(warnKey)) {
+                        warnedInputs.add(warnKey);
+                        warnings.push(new ValidationWarning('INVALID_INPUT_INDEX', `Connection to '${targetNodeName}' uses input index ${targetInputIndex}, but node only has ${mainInputCount} input(s) (indices 0-${mainInputCount - 1})`, targetNodeName));
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map