@lhi/n8m 0.2.1 → 0.2.3

package/dist/commands/test.d.ts

@@ -10,19 +10,78 @@ export default class Test extends Command {
         'no-brand': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'validate-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'ai-scenarios': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        fixture: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     /**
      * Extract clean error message from n8n API responses
      */
     private cleanErrorMsg;
-    /**
-     * Normalize error messages to catch "similar" errors (masking IDs/numbers)
-     */
-    private normalizeError;
     private sanitizeWorkflow;
     private stripShim;
     private saveWorkflows;
     private handlePostTestActions;
+    /**
+     * Test a workflow that already exists on the n8n instance, using its real credentials
+     * and configured triggers — no ephemeral copy, no credential stripping, no shim injection.
+     */
+    private testRemoteWorkflowDirectly;
+    /**
+     * Scan a workflow's expressions to find all field names accessed via $json.body.FIELD.
+     * These become required keys in the test POST payload because n8n wraps the body
+     * automatically — a downstream expression $json.body.content needs {"content": ...} in the POST.
+     */
+    private extractRequiredBodyFields;
+    /**
+     * Load a pre-defined test payload fixture for a specific workflow.
+     * Checks (in order): ./workflow-test-fixtures.json, ./workflows/test-fixtures.json,
+     * and the bundled src/resources/workflow-test-fixtures.json.
+     * Returns null if no matching fixture is found.
+     */
+    private loadWorkflowFixture;
+    /**
+     * Load node-test-hints.json and build a context string describing what
+     * data format each node type in the workflow expects.  Used to inform
+     * generateMockData so the AI sends correctly-shaped values (e.g. Block Kit
+     * JSON for a Slack blocksUi parameter instead of a plain string).
+     */
+    private extractNodeTypeHints;
+    /**
+     * Find nodes that feed binary data into upload-type nodes.
+     * Returns node names whose outputs should be pinned with a test binary
+     * so downstream file-upload steps receive real content instead of empty buffers.
+     */
+    private findBinarySourceNodes;
+    /**
+     * Detect webhook body fields that are used as image/file URLs by HTTP Request
+     * nodes that sit immediately upstream of binary-upload nodes.
+     *
+     * When n8n fetches a real image URL (supplied via the webhook payload) it gets
+     * actual binary bytes, which then flow into the upload step.  Returning these
+     * field names lets the prompt instruct the AI to use a real hosted image URL
+     * (e.g. placehold.co) instead of a placeholder string — so the upload step
+     * receives real binary data without needing pinData API support.
+     */
+    private findBinaryUrlFields;
+    /**
+     * Deep-scan all node parameter values and strip control characters
+     * (U+0000–U+001F, U+007F).  Returns the sanitized nodes array and a flag
+     * indicating whether any changes were made.
+     *
+     * Control chars in node params (e.g. a literal newline inside a Slack
+     * blocksUi JSON string) are workflow configuration bugs — they cause n8n to
+     * throw "could not be parsed" at execution time regardless of the test payload.
+     */
+    private sanitizeWorkflowNodeParams;
+    /**
+     * Strip control characters (U+0000–U+001F, except tab/LF/CR) from all
+     * string values in a generated mock payload.  AI-generated Block Kit JSON
+     * and other rich-text fields sometimes contain raw control chars that cause
+     * n8n's parameter parser to throw "Bad control character in string literal".
+     */
+    private sanitizeMockPayload;
     private deployWorkflows;
+    private offerSaveFixture;
+    private testWithFixture;
+    private findPredecessorNode;
 }