obsyncd 1.0.0

package/dist/sync/watchMode.js

@@ -0,0 +1,364 @@
+/**
+ * WatchModeSync - Orchestrates continuous file watching and automatic synchronization.
+ * Coordinates between FileWatcher and SyncEngine for real-time vault synchronization.
+ */
+import path from 'path';
+import { EventEmitter } from 'events';
+import { v4 as uuidv4 } from 'uuid';
+import { SyncEngine } from './index.js';
+import { BatchFileWatcher } from './watcher.js';
+export class WatchModeSync extends EventEmitter {
+    watcher = null;
+    syncEngine;
+    options;
+    state = 'idle';
+    syncCount = 0;
+    totalFilesSynced = 0;
+    lastSyncTime = null;
+    lastSyncResult = null;
+    currentError = null;
+    isSyncing = false;
+    pendingSyncRequest = false;
+    session = null;
+    maxWaitTimer = null;
+    pendingChangesCount = 0;
+    constructor(options) {
+        super();
+        this.syncEngine = new SyncEngine();
+        this.options = {
+            source: path.resolve(options.source),
+            destination: path.resolve(options.destination),
+            conflictResolution: options.conflictResolution ?? 'newest',
+            remoteMode: options.remoteMode ?? false,
+            debounceMs: options.debounceMs ?? 300,
+            batchDelayMs: options.batchDelayMs ?? 500,
+            maxWaitMs: options.maxWaitMs ?? 5000,
+            initialSync: options.initialSync ?? true,
+            onSync: options.onSync,
+            onError: options.onError,
+            onStatusChange: options.onStatusChange,
+        };
+    }
+    /**
+     * Start watch mode synchronization
+     */
+    async start() {
+        if (this.state === 'watching' || this.state === 'syncing') {
+            throw new Error('Watch mode is already running');
+        }
+        // Initialize session
+        this.session = {
+            sessionId: uuidv4(),
+            startTime: new Date(),
+            endTime: null,
+            syncCount: 0,
+            errorCount: 0,
+            syncHistory: [],
+        };
+        // Reset state
+        this.syncCount = 0;
+        this.totalFilesSynced = 0;
+        this.lastSyncTime = null;
+        this.lastSyncResult = null;
+        this.currentError = null;
+        // Perform initial sync if enabled
+        if (this.options.initialSync) {
+            this.setState('syncing');
+            try {
+                await this.performSync('Initial sync');
+            }
+            catch (error) {
+                this.handleError(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+        }
+        // Create and start the file watcher
+        this.watcher = new BatchFileWatcher({
+            debounceMs: this.options.debounceMs,
+            batchDelayMs: this.options.batchDelayMs,
+            ignorePatterns: [
+                '.obsidian/**',
+                '.trash/**',
+                '.git/**',
+                '.obsync/**',
+                '.DS_Store',
+                'Thumbs.db',
+                '*.tmp',
+                '*.temp',
+            ],
+        });
+        // Listen for batched changes
+        this.watcher.on('batch', (events) => {
+            this.handleBatchChanges(events);
+        });
+        // Listen for individual changes for UI updates
+        this.watcher.on('change', () => {
+            this.pendingChangesCount++;
+            this.emitStatusChange();
+            // Set max wait timer if not already set
+            if (!this.maxWaitTimer && !this.isSyncing) {
+                this.maxWaitTimer = setTimeout(() => {
+                    this.maxWaitTimer = null;
+                    if (this.pendingChangesCount > 0) {
+                        this.triggerSync('Max wait timeout');
+                    }
+                }, this.options.maxWaitMs);
+            }
+        });
+        this.watcher.on('error', (error) => {
+            this.handleError(error);
+        });
+        // Wait for watcher to be ready
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Watcher initialization timeout'));
+            }, 10000);
+            this.watcher.once('ready', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+            // Start watching both directories
+            this.watcher.watchMultiple([this.options.source, this.options.destination]);
+        });
+        this.setState('watching');
+        this.emitEvent({ type: 'status_change', timestamp: new Date(), data: this.getStatus() });
+    }
+    /**
+     * Stop watch mode synchronization
+     */
+    async stop() {
+        if (this.state === 'stopped' || this.state === 'idle') {
+            return;
+        }
+        // Clear max wait timer
+        if (this.maxWaitTimer) {
+            clearTimeout(this.maxWaitTimer);
+            this.maxWaitTimer = null;
+        }
+        // Stop the watcher
+        if (this.watcher) {
+            await this.watcher.stop();
+            this.watcher = null;
+        }
+        // Update session
+        if (this.session) {
+            this.session.endTime = new Date();
+        }
+        this.setState('stopped');
+        this.emitEvent({ type: 'status_change', timestamp: new Date(), data: this.getStatus() });
+    }
+    /**
+     * Pause watch mode (stop watching but keep state)
+     */
+    async pause() {
+        if (this.watcher) {
+            await this.watcher.stop();
+            this.watcher = null;
+        }
+        this.setState('idle');
+        this.emitStatusChange();
+    }
+    /**
+     * Resume watch mode after pause
+     */
+    async resume() {
+        if (this.state !== 'idle') {
+            throw new Error('Can only resume from idle state');
+        }
+        // Recreate watcher
+        this.watcher = new BatchFileWatcher({
+            debounceMs: this.options.debounceMs,
+            batchDelayMs: this.options.batchDelayMs,
+        });
+        this.watcher.on('batch', (events) => {
+            this.handleBatchChanges(events);
+        });
+        this.watcher.on('change', () => {
+            this.pendingChangesCount++;
+            this.emitStatusChange();
+        });
+        this.watcher.on('error', (error) => {
+            this.handleError(error);
+        });
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Watcher initialization timeout'));
+            }, 10000);
+            this.watcher.once('ready', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+            this.watcher.watchMultiple([this.options.source, this.options.destination]);
+        });
+        this.setState('watching');
+        this.emitStatusChange();
+    }
+    /**
+     * Force an immediate sync
+     */
+    async forceSync() {
+        return this.performSync('Manual trigger');
+    }
+    /**
+     * Get current status
+     */
+    getStatus() {
+        return {
+            state: this.state,
+            isActive: this.state === 'watching' || this.state === 'syncing',
+            pendingChanges: this.pendingChangesCount,
+            lastSyncTime: this.lastSyncTime,
+            lastSyncResult: this.lastSyncResult,
+            syncCount: this.syncCount,
+            totalFilesSynced: this.totalFilesSynced,
+            currentError: this.currentError,
+            watchedPaths: [this.options.source, this.options.destination],
+        };
+    }
+    /**
+     * Get current session information
+     */
+    getSession() {
+        return this.session;
+    }
+    /**
+     * Handle batched file changes
+     */
+    handleBatchChanges(events) {
+        if (events.length === 0)
+            return;
+        // Clear pending changes count since we're processing them
+        this.pendingChangesCount = 0;
+        this.emitStatusChange();
+        // Clear max wait timer
+        if (this.maxWaitTimer) {
+            clearTimeout(this.maxWaitTimer);
+            this.maxWaitTimer = null;
+        }
+        this.triggerSync(`${events.length} file(s) changed`);
+    }
+    /**
+     * Trigger a sync operation
+     */
+    triggerSync(reason) {
+        if (this.isSyncing) {
+            this.pendingSyncRequest = true;
+            return;
+        }
+        this.performSync(reason).catch((error) => {
+            this.handleError(error instanceof Error ? error : new Error(String(error)));
+        });
+    }
+    /**
+     * Perform the actual sync operation
+     */
+    async performSync(_reason) {
+        if (this.isSyncing) {
+            throw new Error('Sync already in progress');
+        }
+        this.isSyncing = true;
+        const previousState = this.state;
+        this.setState('syncing');
+        this.emitEvent({ type: 'sync_start', timestamp: new Date() });
+        const startTime = Date.now();
+        try {
+            const result = await this.syncEngine.sync({
+                source: this.options.source,
+                destination: this.options.destination,
+                conflictResolution: this.options.conflictResolution,
+                dryRun: false,
+                remoteMode: this.options.remoteMode,
+            });
+            const duration = Date.now() - startTime;
+            // Update state
+            this.syncCount++;
+            this.lastSyncTime = new Date();
+            this.lastSyncResult = result;
+            this.totalFilesSynced += result.filesAdded + result.filesUpdated + result.filesDeleted;
+            this.currentError = null;
+            // Update session
+            if (this.session) {
+                this.session.syncCount++;
+                this.session.syncHistory.push({
+                    timestamp: new Date(),
+                    result,
+                    duration,
+                });
+            }
+            // Emit events
+            this.emitEvent({ type: 'sync_complete', timestamp: new Date(), data: result });
+            this.options.onSync?.(result);
+            this.isSyncing = false;
+            // Check for pending sync request
+            if (this.pendingSyncRequest) {
+                this.pendingSyncRequest = false;
+                // Schedule another sync
+                setImmediate(() => {
+                    this.triggerSync('Pending changes');
+                });
+            }
+            else {
+                // Restore to watching state if we were watching before
+                if (previousState === 'watching' || this.watcher) {
+                    this.setState('watching');
+                }
+                else {
+                    this.setState('idle');
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            this.isSyncing = false;
+            this.pendingSyncRequest = false;
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.handleError(err);
+            // Update session
+            if (this.session) {
+                this.session.errorCount++;
+            }
+            this.emitEvent({ type: 'sync_error', timestamp: new Date(), data: err });
+            throw err;
+        }
+    }
+    /**
+     * Handle errors
+     */
+    handleError(error) {
+        this.currentError = error;
+        this.setState('error');
+        this.options.onError?.(error);
+        this.emit('error', error);
+    }
+    /**
+     * Set state and emit status change
+     */
+    setState(newState) {
+        if (this.state !== newState) {
+            this.state = newState;
+            this.emitStatusChange();
+        }
+    }
+    /**
+     * Emit status change event
+     */
+    emitStatusChange() {
+        const status = this.getStatus();
+        this.options.onStatusChange?.(status);
+        this.emit('statusChange', status);
+    }
+    /**
+     * Emit an event
+     */
+    emitEvent(event) {
+        this.emit('event', event);
+        this.emit(event.type, event.data);
+    }
+}
+/**
+ * Create a watch mode sync instance with default options
+ */
+export function createWatchModeSync(options) {
+    return new WatchModeSync(options);
+}
+//# sourceMappingURL=watchMode.js.map

package/dist/sync/watchMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchMode.js","sourceRoot":"","sources":["../../src/sync/watchMode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAWjE,MAAM,OAAO,aAAc,SAAQ,YAAY;IACrC,OAAO,GAA4B,IAAI,CAAC;IACxC,UAAU,CAAa;IACvB,OAAO,CAIb;IACM,KAAK,GAAmB,MAAM,CAAC;IAC/B,SAAS,GAAW,CAAC,CAAC;IACtB,gBAAgB,GAAW,CAAC,CAAC;IAC7B,YAAY,GAAgB,IAAI,CAAC;IACjC,cAAc,GAAsB,IAAI,CAAC;IACzC,YAAY,GAAiB,IAAI,CAAC;IAClC,SAAS,GAAY,KAAK,CAAC;IAC3B,kBAAkB,GAAY,KAAK,CAAC;IACpC,OAAO,GAAgC,IAAI,CAAC;IAC5C,YAAY,GAA0B,IAAI,CAAC;IAC3C,mBAAmB,GAAW,CAAC,CAAC;IAExC,YAAY,OAAyB;QACnC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YACpC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;YAC9C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,QAAQ;YAC1D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;YACvC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,GAAG;YACzC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;YACxC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,OAAO,GAAG;YACb,SAAS,EAAE,MAAM,EAAE;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,EAAE;SAChB,CAAC;QAEF,cAAc;QACd,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,kCAAkC;QAClC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5E,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAClC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACvC,cAAc,EAAE;gBACd,cAAc;gBACd,WAAW;gBACX,SAAS;gBACT,YAAY;gBACZ,WAAW;gBACX,WAAW;gBACX,OAAO;gBACP,QAAQ;aACT;SACF,CAAC,CAAC;QAEH,6BAA6B;QAC7B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAyB,EAAE,EAAE;YACrD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC7B,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAExB,wCAAwC;YACxC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1C,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;oBAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;oBACzB,IAAI,IAAI,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;wBACjC,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;oBACvC,CAAC;gBACH,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACxC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;YACtD,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC/B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,kCAAkC;YAClC,IAAI,CAAC,OAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,iBAAiB;QACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAClC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAyB,EAAE,EAAE;YACrD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC7B,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACxC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;YACtD,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,IAAI,CAAC,OAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC/B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAC/D,cAAc,EAAE,IAAI,CAAC,mBAAmB;YACxC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,MAAyB;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEhC,0DAA0D;QAC1D,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,uBAAuB;QACvB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,kBAAkB,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,MAAc;QAChC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACvC,IAAI,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,OAAe;QACvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACxC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC3B,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;gBACrC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAsC;gBACvE,MAAM,EAAE,KAAK;gBACb,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;aACpC,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,eAAe;YACf,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;YAC7B,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YACvF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAEzB,iBAAiB;YACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;oBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE;oBACrB,MAAM;oBACN,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;YAED,cAAc;YACd,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;YAE9B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YAEvB,iCAAiC;YACjC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;gBAChC,wBAAwB;gBACxB,YAAY,CAAC,GAAG,EAAE;oBAChB,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;gBACtC,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,uDAAuD;gBACvD,IAAI,aAAa,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;YAEhC,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAEtB,iBAAiB;YACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5B,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAEzE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAY;QAC9B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,QAAwB;QACvC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,KAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CAGF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC3D,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/sync/watcher.d.ts

@@ -0,0 +1,114 @@
+/**
+ * FileWatcher - Watches directories for file changes with debouncing.
+ * Uses chokidar for cross-platform file watching.
+ */
+import { EventEmitter } from 'events';
+export interface WatcherOptions {
+    /** Debounce delay in milliseconds (default: 300) */
+    debounceMs?: number;
+    /** Patterns to ignore (glob patterns) */
+    ignorePatterns?: string[];
+    /** Whether to ignore initial scan events (default: true) */
+    ignoreInitial?: boolean;
+    /** Whether to use polling (slower but more compatible) */
+    usePolling?: boolean;
+    /** Polling interval in milliseconds (only if usePolling is true) */
+    pollInterval?: number;
+    /** Depth to watch (undefined = infinite) */
+    depth?: number;
+}
+export interface FileChangeEvent {
+    type: 'add' | 'change' | 'unlink';
+    path: string;
+    relativePath: string;
+    watchedPath: string;
+}
+export interface WatcherStatus {
+    isWatching: boolean;
+    watchedPaths: string[];
+    pendingChanges: number;
+    lastEventTime: Date | null;
+}
+export declare class FileWatcher extends EventEmitter {
+    private watchers;
+    private pendingChanges;
+    private debounceTimers;
+    private debounceMs;
+    private ignorePatterns;
+    private ignoreMatchers;
+    private ignoreInitial;
+    private usePolling;
+    private pollInterval;
+    private depth;
+    private isReady;
+    private lastEventTime;
+    private isStopped;
+    constructor(options?: WatcherOptions);
+    /**
+     * Start watching a directory for file changes
+     */
+    watch(watchPath: string): void;
+    /**
+     * Watch multiple directories
+     */
+    watchMultiple(paths: string[]): void;
+    /**
+     * Stop watching a specific directory
+     */
+    unwatch(watchPath: string): Promise<void>;
+    /**
+     * Stop watching all directories and clean up
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current watcher status
+     */
+    getStatus(): WatcherStatus;
+    /**
+     * Check if all watchers are ready
+     */
+    areAllWatchersReady(): boolean;
+    /**
+     * Force flush all pending changes immediately
+     */
+    flushPendingChanges(): FileChangeEvent[];
+    /**
+     * Get count of pending changes
+     */
+    getPendingCount(): number;
+    /**
+     * Handle file system events with debouncing
+     */
+    private handleEvent;
+    /**
+     * Check if a path should be ignored (for the ignored option passed to chokidar)
+     */
+    private shouldIgnore;
+    /**
+     * Check if an event should be skipped (for internal filtering)
+     */
+    private shouldSkipEvent;
+}
+/**
+ * Create a debounced batch watcher that collects multiple changes
+ * and emits them as a batch after a delay
+ */
+export declare class BatchFileWatcher extends FileWatcher {
+    private batchTimer;
+    private batchedChanges;
+    private batchDelayMs;
+    constructor(options?: WatcherOptions & {
+        batchDelayMs?: number;
+    });
+    private scheduleBatchEmit;
+    /**
+     * Get current batch
+     */
+    getCurrentBatch(): FileChangeEvent[];
+    /**
+     * Force emit current batch immediately
+     */
+    flushBatch(): FileChangeEvent[];
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/sync/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/sync/watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;CAC5B;AAGD,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,cAAmB;IAuBxC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA8C9B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAMpC;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;OAEG;IACH,SAAS,IAAI,aAAa;IAS1B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAK9B;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAaxC;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,eAAe;CAYxB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,cAAc,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAYpE,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,eAAe,IAAI,eAAe,EAAE;IAIpC;;OAEG;IACH,UAAU,IAAI,eAAe,EAAE;IAWzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAU5B"}