@n8n-as-code/core 0.2.0

package/dist/services/state-manager.js

@@ -0,0 +1,99 @@
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+export class StateManager {
+    stateFilePath;
+    constructor(directory) {
+        this.stateFilePath = path.join(directory, '.n8n-state.json');
+    }
+    load() {
+        if (fs.existsSync(this.stateFilePath)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(this.stateFilePath, 'utf-8'));
+                // Ensure workflows object exists
+                if (!data.workflows) {
+                    data.workflows = {};
+                }
+                return data;
+            }
+            catch (e) {
+                console.warn('Could not read state file, using empty state');
+            }
+        }
+        return { workflows: {} };
+    }
+    save(state) {
+        fs.writeFileSync(this.stateFilePath, JSON.stringify(state, null, 2));
+    }
+    /**
+     * Computes a stable hash for a workflow object.
+     */
+    static computeHash(workflow) {
+        // We use the cleaned version to ensure stable hashing (no dynamic IDs or timestamps)
+        const content = typeof workflow === 'string' ? workflow : JSON.stringify(workflow);
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Gets the last known state for a workflow.
+     */
+    getWorkflowState(id) {
+        const state = this.load();
+        return state.workflows[id];
+    }
+    /**
+     * Updates the last known state for a workflow.
+     */
+    updateWorkflowState(id, workflow) {
+        const state = this.load();
+        const hash = StateManager.computeHash(workflow);
+        state.workflows[id] = {
+            lastSyncedHash: hash,
+            lastSyncedAt: new Date().toISOString()
+        };
+        this.save(state);
+    }
+    /**
+     * Removes a workflow from state.
+     */
+    removeWorkflowState(id) {
+        const state = this.load();
+        delete state.workflows[id];
+        this.save(state);
+    }
+    /**
+     * Gets all tracked workflow IDs.
+     */
+    getTrackedWorkflowIds() {
+        const state = this.load();
+        return Object.keys(state.workflows);
+    }
+    /**
+     * Checks if a local content matches the last synced state.
+     */
+    isLocalSynced(id, localContent) {
+        const state = this.getWorkflowState(id);
+        if (!state)
+            return true; // If no state, we assume it's new
+        const currentHash = StateManager.computeHash(localContent);
+        const result = state.lastSyncedHash === currentHash;
+        if (!result) {
+            // Changed from console.log to silent for production
+        }
+        return result;
+    }
+    /**
+     * Checks if a remote workflow matches the last synced state.
+     */
+    isRemoteSynced(id, remoteWorkflow) {
+        const state = this.getWorkflowState(id);
+        if (!state)
+            return true;
+        const remoteHash = StateManager.computeHash(remoteWorkflow);
+        const result = state.lastSyncedHash === remoteHash;
+        if (!result) {
+            // Changed from console.log to silent for production
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/services/state-manager.js.map

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

package/dist/services/sync-manager.d.ts

@@ -0,0 +1,101 @@
+import EventEmitter from 'events';
+import { N8nApiClient } from './n8n-api-client.js';
+import { ISyncConfig, IWorkflowStatus } from '../types.js';
+export declare class SyncManager extends EventEmitter {
+    private client;
+    private config;
+    private fileToIdMap;
+    private selfWrittenCache;
+    private isWriting;
+    private pendingDeletions;
+    private watcher;
+    private pollInterval;
+    private stateManager;
+    private trashService;
+    constructor(client: N8nApiClient, config: ISyncConfig);
+    /**
+     * Get the path to the instance configuration file
+     */
+    private getInstanceConfigPath;
+    /**
+     * Load instance configuration from disk
+     */
+    private loadInstanceConfig;
+    /**
+     * Save instance configuration to disk
+     */
+    private saveInstanceConfig;
+    /**
+     * Ensure instance identifier is set and persistent
+     */
+    private ensureInstanceIdentifier;
+    private initializeInstanceIdentifier;
+    getInstanceDirectory(): string;
+    private getFilePath;
+    private safeName;
+    private normalizeContent;
+    private markAsSelfWritten;
+    private isSelfWritten;
+    loadRemoteState(): Promise<void>;
+    /**
+     * Retrieves the status of all workflows (local and remote)
+     */
+    getWorkflowsStatus(): Promise<IWorkflowStatus[]>;
+    private formatSummary;
+    /**
+     * Scans n8n instance and updates local files (Downstream Sync)
+     */
+    syncDown(): Promise<void>;
+    /**
+     * Identifies and handles workflows deleted on n8n but still present locally and tracked in state
+     */
+    private processRemoteDeletions;
+    /**
+     * Scans n8n instance and updates local files with conflict resolution
+     */
+    syncDownWithConflictResolution(): Promise<void>;
+    /**
+     * Pulls a single workflow by ID and writes to filename
+     * @param force If true, overwrites local changes without checking for conflicts
+     */
+    pullWorkflow(filename: string, id: string, force?: boolean): Promise<void>;
+    /**
+     * Pulls a single workflow with conflict resolution
+     * @returns 'updated' if file was updated, 'skipped' if no change or conflict, 'new' if file was created
+     */
+    pullWorkflowWithConflictResolution(filename: string, id: string, remoteUpdatedAt?: string): Promise<'updated' | 'skipped' | 'new' | 'up-to-date' | 'conflict'>;
+    /**
+     * Writes file to disk only if changed
+     */
+    private writeLocalFile;
+    private shouldIgnore;
+    /**
+     * Uploads local files that don't exist remotely (Upstream Sync - Init)
+     */
+    syncUpMissing(): Promise<void>;
+    /**
+     * Full Upstream Sync: Updates existing and Creates new.
+     */
+    syncUp(): Promise<void>;
+    /**
+     * Handles local file deletion (detected by watcher)
+     */
+    handleLocalFileDeletion(filePath: string): Promise<void>;
+    /**
+     * Actually deletes the remote workflow and cleans up local state
+     */
+    deleteRemoteWorkflow(id: string, filename: string): Promise<boolean>;
+    /**
+     * Restore a deleted local file from remote
+     */
+    restoreLocalFile(id: string, filename: string): Promise<boolean>;
+    /**
+     * Handle FS watcher events
+     */
+    handleLocalFileChange(filePath: string, silent?: boolean): Promise<'updated' | 'created' | 'up-to-date' | 'conflict' | 'skipped'>;
+    private readLocalFile;
+    private readRawFile;
+    startWatch(): Promise<void>;
+    stopWatch(): void;
+}
+//# sourceMappingURL=sync-manager.d.ts.map

package/dist/services/sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../src/services/sync-manager.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAE,WAAW,EAAiC,eAAe,EAAE,MAAM,aAAa,CAAC;AAO1F,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;IAWrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,wBAAwB;YA+BxB,4BAA4B;IAkBnC,oBAAoB,IAAI,MAAM;IAarC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAOf,eAAe;IAarB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA8DtD,OAAO,CAAC,aAAa;IASrB;;OAEG;IACG,QAAQ;IAmCd;;OAEG;YACW,sBAAsB;IAoCpC;;OAEG;IACG,8BAA8B;IAkCpC;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe;IA4BvE;;;OAGG;IACG,kCAAkC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,CAAC;IA8CpK;;OAEG;YACW,cAAc;IAqC5B,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,aAAa;IAenB;;OAEG;IACG,MAAM;IAqBZ;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM;IAiB9C;;OAEG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB1E;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IA0F9I,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAIb,UAAU;IAwChB,SAAS;CAWZ"}