@n8n-as-code/sync 0.5.0

package/README.md

@@ -0,0 +1,22 @@
+# @n8n-as-code/sync
+
+The logical sync of the **n8n-as-code** ecosystem.
+
+## 🛠 Purpose
+
+This package contains the shared logic used by the CLI, the Skills CLI, and the VS Code extension:
+- **API Client**: Communication with the n8n REST API.
+- **Synchronization**: Logic for pulling, pushing, and detecting changes.
+- **Sanitization**: Cleaning up n8n JSONs for better Git versioning (removing IDs, timestamps, etc.).
+- **State Management**: Tracking local vs. remote state to detect conflicts.
+
+## 🚀 Usage
+
+This is internal tooling primarily intended to be consumed by other `@n8n-as-code` packages.
+
+```bash
+npm install @n8n-as-code/sync
+```
+
+## 📄 License
+MIT

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './services/n8n-api-client.js';
+export * from './services/workflow-sanitizer.js';
+export * from './services/sync-manager.js';
+export * from './services/sync-engine.js';
+export * from './services/watcher.js';
+export * from './services/resolution-manager.js';
+export * from './services/state-manager.js';
+export * from './services/directory-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './services/n8n-api-client.js';
+export * from './services/workflow-sanitizer.js';
+export * from './services/sync-manager.js';
+export * from './services/sync-engine.js';
+export * from './services/watcher.js';
+export * from './services/resolution-manager.js';
+export * from './services/state-manager.js';
+export * from './services/directory-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/dist/services/directory-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Creates a user-friendly host slug for directory naming
+ * @param host The host URL
+ * @returns Cleaned host slug (e.g., "local_5678", "etiennel_cloud")
+ */
+export declare function createHostSlug(host: string): string;
+/**
+ * Creates a user-friendly slug from user information
+ * @param user User object with email, firstName, lastName
+ * @returns User slug (e.g., "etienne_l", "john_d")
+ */
+export declare function createUserSlug(user: {
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+}): string;
+/**
+ * Creates an instance identifier for directory naming
+ * @param host The host URL
+ * @param user User information (optional)
+ * @returns Instance identifier (e.g., "local_5678_etienne_l")
+ */
+export declare function createInstanceIdentifier(host: string, user?: {
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+}): string;
+/**
+ * Creates a fallback instance identifier using API key hash when user info is unavailable
+ * @param host The host URL
+ * @param apiKey The API key for uniqueness
+ * @returns Fallback instance identifier (e.g., "local_5678_abc123")
+ */
+export declare function createFallbackInstanceIdentifier(host: string, apiKey: string): string;
+//# sourceMappingURL=directory-utils.d.ts.map

package/dist/services/directory-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-utils.d.ts","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoBtG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK/H;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrF"}

package/dist/services/directory-utils.js

@@ -0,0 +1,75 @@
+import crypto from 'crypto';
+/**
+ * Creates a user-friendly host slug for directory naming
+ * @param host The host URL
+ * @returns Cleaned host slug (e.g., "local_5678", "etiennel_cloud")
+ */
+export function createHostSlug(host) {
+    // Remove protocol and trailing slashes
+    let cleanHost = host.replace(/^https?:\/\//, '').replace(/\/$/, '');
+    // Handle localhost with port
+    if (cleanHost.startsWith('localhost:')) {
+        const port = cleanHost.split(':')[1];
+        return `local_${port}`;
+    }
+    // For domains, extract main parts
+    // etiennel.app.n8n.cloud -> etiennel_cloud
+    // prod.example.com -> prod_example
+    cleanHost = cleanHost
+        .replace(/\.app\.n8n\.cloud$/, '_cloud')
+        .replace(/\.example\.com$/, '_example')
+        .replace(/\.com$/, '')
+        .replace(/\.io$/, '')
+        .replace(/\.net$/, '')
+        .replace(/\.org$/, '');
+    // Replace remaining dots and hyphens with underscores
+    return cleanHost
+        .replace(/[.-]/g, '_')
+        .toLowerCase();
+}
+/**
+ * Creates a user-friendly slug from user information
+ * @param user User object with email, firstName, lastName
+ * @returns User slug (e.g., "etienne_l", "john_d")
+ */
+export function createUserSlug(user) {
+    // Prefer first name + last name initial if available
+    if (user.firstName && user.lastName) {
+        return `${user.firstName.toLowerCase()}_${user.lastName.charAt(0).toLowerCase()}`;
+    }
+    // Fallback to first name only
+    if (user.firstName) {
+        return user.firstName.toLowerCase();
+    }
+    // Fallback to email username part
+    if (user.email) {
+        return user.email.split('@')[0]
+            .replace(/[^a-zA-Z0-9]/g, '_')
+            .toLowerCase();
+    }
+    // Final fallback
+    return 'user';
+}
+/**
+ * Creates an instance identifier for directory naming
+ * @param host The host URL
+ * @param user User information (optional)
+ * @returns Instance identifier (e.g., "local_5678_etienne_l")
+ */
+export function createInstanceIdentifier(host, user) {
+    const hostSlug = createHostSlug(host);
+    const userSlug = user ? createUserSlug(user) : 'user';
+    return `${hostSlug}_${userSlug}`;
+}
+/**
+ * Creates a fallback instance identifier using API key hash when user info is unavailable
+ * @param host The host URL
+ * @param apiKey The API key for uniqueness
+ * @returns Fallback instance identifier (e.g., "local_5678_abc123")
+ */
+export function createFallbackInstanceIdentifier(host, apiKey) {
+    const hostSlug = createHostSlug(host);
+    const apiKeyHash = crypto.createHash('sha256').update(apiKey).digest('hex').substring(0, 6);
+    return `${hostSlug}_${apiKeyHash}`;
+}
+//# sourceMappingURL=directory-utils.js.map

package/dist/services/directory-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-utils.js","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,uCAAuC;IACvC,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,IAAI,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO,SAAS,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,2CAA2C;IAC3C,mCAAmC;IACnC,SAAS,GAAG,SAAS;SAChB,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC;SACvC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE3B,sDAAsD;IACtD,OAAO,SAAS;SACX,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+D;IAC1F,qDAAqD;IACrD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACtF,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC1B,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;aAC7B,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,iBAAiB;IACjB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,IAAgE;IACnH,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtD,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAAY,EAAE,MAAc;IACzE,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5F,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACvC,CAAC"}

package/dist/services/hash-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Hash Utilities for canonical hashing
+ *
+ * Provides consistent SHA-256 hashing of JSON content with stable stringification.
+ * Used by all components to ensure hash consistency.
+ */
+export declare class HashUtils {
+    /**
+     * Computes a stable, canonical hash for any object (usually a workflow).
+     * Non-functional metadata should be removed before calling this.
+     */
+    static computeHash(content: any): string;
+    /**
+     * Compares two objects by computing their canonical hashes
+     */
+    static areEqual(obj1: any, obj2: any): boolean;
+    /**
+     * Short hash for display purposes
+     */
+    static shortHash(hash: string, length?: number): string;
+}
+//# sourceMappingURL=hash-utils.d.ts.map

package/dist/services/hash-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.d.ts","sourceRoot":"","sources":["../../src/services/hash-utils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,SAAS;IAClB;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM;IAKxC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM;CAG7D"}

package/dist/services/hash-utils.js

@@ -0,0 +1,31 @@
+import crypto from 'crypto';
+import stringify from 'json-stable-stringify';
+/**
+ * Hash Utilities for canonical hashing
+ *
+ * Provides consistent SHA-256 hashing of JSON content with stable stringification.
+ * Used by all components to ensure hash consistency.
+ */
+export class HashUtils {
+    /**
+     * Computes a stable, canonical hash for any object (usually a workflow).
+     * Non-functional metadata should be removed before calling this.
+     */
+    static computeHash(content) {
+        const canonicalString = stringify(content) || '';
+        return crypto.createHash('sha256').update(canonicalString).digest('hex');
+    }
+    /**
+     * Compares two objects by computing their canonical hashes
+     */
+    static areEqual(obj1, obj2) {
+        return this.computeHash(obj1) === this.computeHash(obj2);
+    }
+    /**
+     * Short hash for display purposes
+     */
+    static shortHash(hash, length = 8) {
+        return hash.substring(0, length);
+    }
+}
+//# sourceMappingURL=hash-utils.js.map

package/dist/services/hash-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.js","sourceRoot":"","sources":["../../src/services/hash-utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IAClB;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAY;QAC3B,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAS,EAAE,IAAS;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY,EAAE,SAAiB,CAAC;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;CACJ"}

package/dist/services/n8n-api-client.d.ts

@@ -0,0 +1,23 @@
+import { IN8nCredentials, IWorkflow } from '../types.js';
+export declare class N8nApiClient {
+    private client;
+    constructor(credentials: IN8nCredentials);
+    testConnection(): Promise<boolean>;
+    getCurrentUser(): Promise<{
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+    } | null>;
+    getAllWorkflows(): Promise<IWorkflow[]>;
+    getWorkflow(id: string): Promise<IWorkflow | null>;
+    createWorkflow(payload: Partial<IWorkflow>): Promise<IWorkflow>;
+    updateWorkflow(id: string, payload: Partial<IWorkflow>): Promise<IWorkflow>;
+    deleteWorkflow(id: string): Promise<boolean>;
+    activateWorkflow(id: string, active: boolean): Promise<boolean>;
+    getHealth(): Promise<{
+        version: string;
+    }>;
+    getNodeTypes(): Promise<any[]>;
+}
+//# sourceMappingURL=n8n-api-client.d.ts.map

package/dist/services/n8n-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-api-client.d.ts","sourceRoot":"","sources":["../../src/services/n8n-api-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAgB;gBAElB,WAAW,EAAE,eAAe;IAoBlC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUlC,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAAE,GAAG,IAAI,CAAC;IA2CvG,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAWvC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAclD,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAK/D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAoB3E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5C,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCzC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAUvC"}

package/dist/services/n8n-api-client.js

@@ -0,0 +1,193 @@
+import axios from 'axios';
+import * as https from 'https';
+export class N8nApiClient {
+    client;
+    constructor(credentials) {
+        let host = credentials.host;
+        if (host.endsWith('/')) {
+            host = host.slice(0, -1);
+        }
+        this.client = axios.create({
+            baseURL: host,
+            headers: {
+                'X-N8N-API-KEY': credentials.apiKey,
+                'Content-Type': 'application/json',
+                'User-Agent': 'n8n-as-code'
+            },
+            // Allow self-signed certificates by default to avoid issues in local environments
+            httpsAgent: new https.Agent({
+                rejectUnauthorized: false
+            })
+        });
+    }
+    async testConnection() {
+        try {
+            await this.client.get('/api/v1/users'); // Simple endpoint to test auth
+            return true;
+        }
+        catch (error) {
+            console.error('Connection test failed:', error);
+            return false;
+        }
+    }
+    async getCurrentUser() {
+        // Try /me first (modern n8n)
+        try {
+            const res = await this.client.get('/api/v1/users/me');
+            console.debug('[N8nApiClient] getCurrentUser: Successfully retrieved user from /me endpoint');
+            if (res.data && res.data.id) {
+                return {
+                    id: res.data.id,
+                    email: res.data.email,
+                    firstName: res.data.firstName,
+                    lastName: res.data.lastName
+                };
+            }
+        }
+        catch (error) {
+            console.debug('[N8nApiClient] getCurrentUser: /me endpoint failed:', error.message);
+            // If it's a connection error, throw immediately
+            if (!error.response)
+                throw error;
+        }
+        // Fallback: get all users and take the first one (assuming the API key belongs to an admin or the only user)
+        console.debug('[N8nApiClient] getCurrentUser: Trying /api/v1/users endpoint');
+        try {
+            const res = await this.client.get('/api/v1/users');
+            if (res.data && res.data.data && res.data.data.length > 0) {
+                console.debug('[N8nApiClient] getCurrentUser: Found', res.data.data.length, 'users');
+                const user = res.data.data[0];
+                return {
+                    id: user.id,
+                    email: user.email,
+                    firstName: user.firstName,
+                    lastName: user.lastName
+                };
+            }
+        }
+        catch (error) {
+            console.debug('[N8nApiClient] getCurrentUser: /api/v1/users endpoint failed:', error.message);
+            // If it's a connection error, throw immediately
+            if (!error.response)
+                throw error;
+        }
+        console.debug('[N8nApiClient] getCurrentUser: All attempts failed, returning null');
+        return null;
+    }
+    async getAllWorkflows() {
+        try {
+            const res = await this.client.get('/api/v1/workflows');
+            return res.data.data;
+        }
+        catch (error) {
+            console.error('Failed to get workflows:', error.message);
+            // Re-throw so the caller (Watcher) can distinguish between "no workflows" and "connection error"
+            throw error;
+        }
+    }
+    async getWorkflow(id) {
+        try {
+            const res = await this.client.get(`/api/v1/workflows/${id}`);
+            return res.data;
+        }
+        catch (error) {
+            // 404 is expected if workflow deleted remotely
+            if (error.response && error.response.status === 404) {
+                return null;
+            }
+            // Re-throw other errors (connection, 500, etc.)
+            throw error;
+        }
+    }
+    async createWorkflow(payload) {
+        const res = await this.client.post('/api/v1/workflows', payload);
+        return res.data;
+    }
+    async updateWorkflow(id, payload) {
+        // Use console.warn to be more visible in some environments
+        console.warn(`[N8nApiClient] Starting PUT /api/v1/workflows/${id}`);
+        const startTime = Date.now();
+        try {
+            const res = await this.client.put(`/api/v1/workflows/${id}`, payload);
+            const duration = Date.now() - startTime;
+            console.warn(`[N8nApiClient] PUT finished in ${duration}ms. Status: ${res.status}`);
+            return res.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            console.error(`[N8nApiClient] PUT failed after ${duration}ms: ${error.message}`);
+            if (error.response) {
+                console.error(`[N8nApiClient] Error data:`, error.response.data);
+            }
+            throw error;
+        }
+    }
+    async deleteWorkflow(id) {
+        try {
+            await this.client.delete(`/api/v1/workflows/${id}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to delete workflow ${id}:`, error);
+            return false;
+        }
+    }
+    async activateWorkflow(id, active) {
+        try {
+            await this.client.post(`/api/v1/workflows/${id}/activate`, { active });
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async getHealth() {
+        try {
+            // 1. Try public endpoint if available (some versions)
+            try {
+                const res = await this.client.get('/healthz');
+                if (res.data && res.data.version)
+                    return { version: res.data.version };
+            }
+            catch { }
+            // 2. Scraping Root Page as fallback (Using raw axios to avoid API headers)
+            const baseURL = this.client.defaults.baseURL;
+            const res = await axios.get(`${baseURL}/`);
+            const html = res.data;
+            // Look for "release":"n8n@X.Y.Z" probably inside n8n:config:sentry meta (Base64 encoded)
+            const sentryMatch = html.match(/name="n8n:config:sentry"\s+content="([^"]+)"/);
+            if (sentryMatch && sentryMatch[1]) {
+                const decoded = Buffer.from(sentryMatch[1], 'base64').toString('utf-8');
+                const releaseMatch = decoded.match(/"release":"n8n@([^"]+)"/);
+                if (releaseMatch && releaseMatch[1]) {
+                    return { version: releaseMatch[1] };
+                }
+            }
+            // Fallback: Check plain text just in case
+            const releaseRegex = /"release":"n8n@([^"]+)"/;
+            const plainMatch = html.match(releaseRegex);
+            if (plainMatch && plainMatch[1])
+                return { version: plainMatch[1] };
+            // Look for other common patterns
+            const metaMatch = html.match(/n8n version: ([0-9.]+)/i);
+            if (metaMatch && metaMatch[1])
+                return { version: metaMatch[1] };
+            return { version: '1.0+' };
+        }
+        catch {
+            return { version: 'Unknown' };
+        }
+    }
+    async getNodeTypes() {
+        try {
+            // Unofficial/Internal endpoint often used by frontend
+            const res = await this.client.get('/rest/node-types');
+            return res.data;
+        }
+        catch {
+            // Fallback: If REST API not accessible, return empty
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=n8n-api-client.js.map

package/dist/services/n8n-api-client.js.map

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

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

@@ -0,0 +1,73 @@
+import { SyncEngine } from './sync-engine.js';
+import { Watcher } from './watcher.js';
+import { WorkflowSyncStatus } from '../types.js';
+import { N8nApiClient } from './n8n-api-client.js';
+/**
+ * Resolution & Validation Manager
+ *
+ * Responsibilities:
+ * 1. Conflict Resolution (6.1 from spec)
+ * 2. Deletion Validation (6.2 from spec)
+ *
+ * Bridges user intent with Sync Engine operations
+ */
+export declare class ResolutionManager {
+    private syncEngine;
+    private watcher;
+    private client;
+    private directory;
+    constructor(syncEngine: SyncEngine, watcher: Watcher, client: N8nApiClient);
+    /**
+     * 6.1 Conflict Resolution - KEEP LOCAL
+     *
+     * Action: Force PUSH (Overwrite Remote with Local)
+     * Commit: Update lastSyncedHash = LocalHash. Status becomes IN_SYNC.
+     */
+    keepLocal(workflowId: string, filename: string): Promise<string>;
+    /**
+     * 6.1 Conflict Resolution - KEEP REMOTE
+     *
+     * Action: Force PULL (Overwrite Local with Remote)
+     * Commit: Update lastSyncedHash = RemoteHash. Status becomes IN_SYNC.
+     */
+    keepRemote(workflowId: string, filename: string): Promise<void>;
+    /**
+     * 6.1 Conflict Resolution - SHOW DIFF
+     *
+     * Opens diff editor (implementation depends on UI layer)
+     * Returns diff data for UI to display
+     */
+    showDiff(workflowId: string, filename: string): Promise<{
+        localContent: any;
+        remoteContent: any;
+        localHash: string;
+        remoteHash: string;
+    }>;
+    /**
+     * 6.2 Deletion Validation - CONFIRM DELETION
+     *
+     * Case Deleted Locally: Send DELETE to API -> Remove from state
+     * Case Deleted Remotely: Move local file to _archive/ -> Remove from state
+     */
+    confirmDeletion(workflowId: string, filename: string, deletionType: 'local' | 'remote'): Promise<void>;
+    /**
+     * 6.2 Deletion Validation - RESTORE WORKFLOW
+     *
+     * Case Deleted Locally: Move file from _archive/ to workflows/
+     * Case Deleted Remotely: Force PUSH (Re-create on Remote)
+     */
+    restoreWorkflow(workflowId: string, filename: string, deletionType: 'local' | 'remote'): Promise<string>;
+    /**
+     * Get current status for a workflow
+     */
+    getWorkflowStatus(workflowId: string, filename: string): Promise<{
+        status: WorkflowSyncStatus;
+        localExists: boolean;
+        remoteExists: boolean;
+        lastSyncedHash?: string;
+        localHash?: string;
+        remoteHash?: string;
+    }>;
+    private readJsonFile;
+}
+//# sourceMappingURL=resolution-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-manager.d.ts","sourceRoot":"","sources":["../../src/services/resolution-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY;IAQ1E;;;;;OAKG;IACU,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7E;;;;;OAKG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;;;;OAKG;IACU,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACjE,YAAY,EAAE,GAAG,CAAC;QAClB,aAAa,EAAE,GAAG,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IA4BF;;;;;OAKG;IACU,eAAe,CACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,GAAG,QAAQ,GACjC,OAAO,CAAC,IAAI,CAAC;IAchB;;;;;OAKG;IACU,eAAe,CACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,GAAG,QAAQ,GACjC,OAAO,CAAC,MAAM,CAAC;IAgBlB;;OAEG;IACU,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1E,MAAM,EAAE,kBAAkB,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAwBF,OAAO,CAAC,YAAY;CAOvB"}