@n8n-as-code/core 0.2.0 → 0.3.1

package/dist/services/workflow-sanitizer.js

@@ -1,21 +1,4 @@
 export class WorkflowSanitizer {
-    /**
-     * Recursively sorts object keys to ensure deterministic JSON output.
-     */
-    static sortKeys(obj) {
-        if (Array.isArray(obj)) {
-            return obj.map(this.sortKeys.bind(this));
-        }
-        else if (obj !== null && typeof obj === 'object') {
-            return Object.keys(obj)
-                .sort()
-                .reduce((acc, key) => {
-                acc[key] = this.sortKeys(obj[key]);
-                return acc;
-            }, {});
-        }
-        return obj;
-    }
     /**
      * Prepares a workflow JSON for storage on disk (GIT).
      * Removes dynamic IDs, execution URLs, and standardizes key order.
@@ -30,34 +13,71 @@ export class WorkflowSanitizer {
             'saveDataErrorExecution',
             'saveManualExecutions',
             'saveExecutionProgress',
-            'executionOrder'
+            'executionOrder',
+            'trialStartedAt'
         ];
         keysToRemove.forEach(k => delete settings[k]);
+        // Clean nodes
+        const nodes = (workflow.nodes || []).map(node => {
+            const newNode = { ...node };
+            // Remove node-level metadata that might vary
+            delete newNode.id; // n8n 2.x often adds node IDs
+            // Standardize parameters
+            if (newNode.parameters && Object.keys(newNode.parameters).length === 0) {
+                newNode.parameters = {};
+            }
+            return newNode;
+        });
+        // Build cleaned object with ONLY the fields we want to keep
+        // Explicitly exclude version-related fields that n8n auto-generates:
+        // - versionId: UUID that changes on every update
+        // - activeVersionId: Version tracking field
+        // - versionCounter: Increments on every update
+        // - pinData: Execution pin data (not part of workflow definition)
+        // These fields cause false conflicts if included in hashing
+        //
+        // IMPORTANT: We build the object with a deterministic key order
+        // (id, name, nodes, connections, settings, tags, active)
+        // No need to call sortKeys() which would recursively sort ALL keys
+        // including inside nodes, which can cause massive diffs
         const cleaned = {
+            id: workflow.id,
             name: workflow.name,
-            nodes: workflow.nodes || [],
+            nodes: nodes,
             connections: workflow.connections || {},
             settings: settings,
             tags: workflow.tags || [],
-            active: workflow.active
+            active: !!workflow.active
         };
-        // Ensure deterministic key order for hashing consistency
-        return this.sortKeys(cleaned);
+        return cleaned;
     }
     /**
      * Prepares a local workflow JSON for pushing to n8n API.
      * Removes read-only fields or fields that shouldn't be overwritten blindly (like tags if needed).
+     *
+     * n8n API v1 PUT /workflows/{id} expects a very specific schema.
+     * Based on n8n 2.2.6 API documentation, the allowed fields are:
+     * - name (string, required)
+     * - nodes (array, required)
+     * - connections (object, required)
+     * - settings (object, optional but with strict schema)
+     * - staticData (object, optional)
+     * - triggerCount (number, optional)
      */
     static cleanForPush(workflow) {
+        // Start with cleanForStorage to get basic structure
         const clean = this.cleanForStorage(workflow);
-        // n8n public API v1 (PUT /workflows/{id})
-        // 1. 'active' is read-only and will cause a 400 error if included
-        delete clean.active;
-        // 2. Tags are often problematic and not always supported in the same way via Public API
-        delete clean.tags;
-        // 3. Settings must be strictly filtered (Whitelist)
-        // Public API schema for settings is very restrictive
-        if (clean.settings) {
+        // Remove all fields that are not in the n8n API v1 PUT schema
+        // Keep only: name, nodes, connections, settings, staticData, triggerCount
+        const allowedFields = ['name', 'nodes', 'connections', 'settings', 'staticData', 'triggerCount'];
+        const result = {};
+        for (const key of allowedFields) {
+            if (clean[key] !== undefined) {
+                result[key] = clean[key];
+            }
+        }
+        // Ensure settings is properly filtered
+        if (result.settings) {
             const allowedSettings = [
                 'errorWorkflow',
                 'timezone',
@@ -67,14 +87,14 @@ export class WorkflowSanitizer {
                 'executionOrder'
             ];
             const filteredSettings = {};
-            for (const key of allowedSettings) {
-                if (clean.settings[key] !== undefined) {
-                    filteredSettings[key] = clean.settings[key];
+            for (const settingKey of allowedSettings) {
+                if (result.settings[settingKey] !== undefined) {
+                    filteredSettings[settingKey] = result.settings[settingKey];
                 }
             }
-            clean.settings = filteredSettings;
+            result.settings = filteredSettings;
         }
-        return clean;
+        return result;
     }
 }
 //# sourceMappingURL=workflow-sanitizer.js.map

package/dist/services/workflow-sanitizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-sanitizer.js","sourceRoot":"","sources":["../../src/services/workflow-sanitizer.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC1B;;OAEG;IACK,MAAM,CAAC,QAAQ,CAAC,GAAQ;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACjD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;iBAClB,IAAI,EAAE;iBACN,MAAM,CAAC,CAAC,GAAQ,EAAE,GAAG,EAAE,EAAE;gBACtB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnC,OAAO,GAAG,CAAC;YACf,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,QAAmB;QACtC,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QAElD,oCAAoC;QACpC,MAAM,YAAY,GAAG;YACjB,cAAc;YACd,gBAAgB;YAChB,cAAc;YACd,wBAAwB;YACxB,sBAAsB;YACtB,uBAAuB;YACvB,gBAAgB;SACnB,CAAC;QAEF,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG;YACZ,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;YACvC,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;SAC1B,CAAC;QAEF,yDAAyD;QACzD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAA4B;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAqB,CAAC,CAAC;QAE1D,0CAA0C;QAC1C,kEAAkE;QAClE,OAAO,KAAK,CAAC,MAAM,CAAC;QAEpB,wFAAwF;QACxF,OAAO,KAAK,CAAC,IAAI,CAAC;QAElB,oDAAoD;QACpD,qDAAqD;QACrD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,eAAe,GAAG;gBACpB,eAAe;gBACf,UAAU;gBACV,sBAAsB;gBACtB,wBAAwB;gBACxB,uBAAuB;gBACvB,gBAAgB;aACnB,CAAC;YACF,MAAM,gBAAgB,GAAQ,EAAE,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBACpC,gBAAgB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAChD,CAAC;YACL,CAAC;YACD,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;QACtC,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}
+{"version":3,"file":"workflow-sanitizer.js","sourceRoot":"","sources":["../../src/services/workflow-sanitizer.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -18,11 +18,14 @@ export interface ITag {
     name: string;
 }
 export declare enum WorkflowSyncStatus {
-    SYNCED = "SYNCED",
-    LOCAL_MODIFIED = "LOCAL_MODIFIED",
-    REMOTE_MODIFIED = "REMOTE_MODIFIED",// Note: Hard to detect without polling
-    MISSING_LOCAL = "MISSING_LOCAL",// On n8n but not on disk (should not happen after syncDown)
-    MISSING_REMOTE = "MISSING_REMOTE"
+    EXIST_ONLY_LOCALLY = "EXIST_ONLY_LOCALLY",
+    EXIST_ONLY_REMOTELY = "EXIST_ONLY_REMOTELY",
+    IN_SYNC = "IN_SYNC",
+    MODIFIED_LOCALLY = "MODIFIED_LOCALLY",
+    MODIFIED_REMOTELY = "MODIFIED_REMOTELY",
+    CONFLICT = "CONFLICT",
+    DELETED_LOCALLY = "DELETED_LOCALLY",
+    DELETED_REMOTELY = "DELETED_REMOTELY"
 }
 export interface IWorkflowStatus {
     id: string;
@@ -37,5 +40,7 @@ export interface ISyncConfig {
     syncInactive: boolean;
     ignoredTags: string[];
     instanceIdentifier?: string;
+    instanceConfigPath?: string;
+    syncMode?: 'auto' | 'manual';
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,WAAW,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,oBAAY,kBAAkB;IAC1B,MAAM,WAAW;IACjB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB,CAAE,uCAAuC;IAC5E,aAAa,kBAAkB,CAAE,4DAA4D;IAC7F,cAAc,mBAAmB;CACpC;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,WAAW,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,oBAAY,kBAAkB;IAC1B,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,QAAQ,aAAa;IACrB,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;CACxC;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC"}

package/dist/types.js

@@ -1,9 +1,12 @@
 export var WorkflowSyncStatus;
 (function (WorkflowSyncStatus) {
-    WorkflowSyncStatus["SYNCED"] = "SYNCED";
-    WorkflowSyncStatus["LOCAL_MODIFIED"] = "LOCAL_MODIFIED";
-    WorkflowSyncStatus["REMOTE_MODIFIED"] = "REMOTE_MODIFIED";
-    WorkflowSyncStatus["MISSING_LOCAL"] = "MISSING_LOCAL";
-    WorkflowSyncStatus["MISSING_REMOTE"] = "MISSING_REMOTE"; // On disk but not on n8n
+    WorkflowSyncStatus["EXIST_ONLY_LOCALLY"] = "EXIST_ONLY_LOCALLY";
+    WorkflowSyncStatus["EXIST_ONLY_REMOTELY"] = "EXIST_ONLY_REMOTELY";
+    WorkflowSyncStatus["IN_SYNC"] = "IN_SYNC";
+    WorkflowSyncStatus["MODIFIED_LOCALLY"] = "MODIFIED_LOCALLY";
+    WorkflowSyncStatus["MODIFIED_REMOTELY"] = "MODIFIED_REMOTELY";
+    WorkflowSyncStatus["CONFLICT"] = "CONFLICT";
+    WorkflowSyncStatus["DELETED_LOCALLY"] = "DELETED_LOCALLY";
+    WorkflowSyncStatus["DELETED_REMOTELY"] = "DELETED_REMOTELY";
 })(WorkflowSyncStatus || (WorkflowSyncStatus = {}));
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC1B,uCAAiB,CAAA;IACjB,uDAAiC,CAAA;IACjC,yDAAmC,CAAA;IACnC,qDAA+B,CAAA;IAC/B,uDAAiC,CAAA,CAAC,yBAAyB;AAC/D,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC1B,+DAAyC,CAAA;IACzC,iEAA2C,CAAA;IAC3C,yCAAmB,CAAA;IACnB,2DAAqC,CAAA;IACrC,6DAAuC,CAAA;IACvC,2CAAqB,CAAA;IACrB,yDAAmC,CAAA;IACnC,2DAAqC,CAAA;AACzC,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@n8n-as-code/core",
-    "version": "0.2.0",
+    "version": "0.3.1",
     "description": "Core library for n8n-as-code ecosystem",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -16,9 +16,11 @@
         "validate-schema": "node ../../scripts/validate-schema.js --schema ./src/assets/n8n-nodes-index.json"
     },
     "dependencies": {
+        "@types/json-stable-stringify": "^1.1.0",
         "axios": "^1.6.0",
         "chokidar": "^5.0.0",
         "deep-equal": "^2.2.3",
+        "json-stable-stringify": "^1.3.0",
         "zod": "^3.22.4"
     },
     "devDependencies": {
@@ -38,4 +40,4 @@
     "publishConfig": {
         "access": "public"
     }
-}
+}