@plusplusoneplusplus/coc 1.0.0

package/dist/server/server-log-capture.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Server Log Capture
+ *
+ * In-process ring buffer + EventEmitter for live server log streaming.
+ * All coc-server log calls are captured here so the /api/logs endpoints
+ * can serve real-time SSE streams and history without requiring a log file.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import { EventEmitter } from 'events';
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface LogEntry {
+    /** ISO 8601 timestamp */
+    ts: string;
+    /** Numeric Pino level (10=trace, 20=debug, 30=info, 40=warn, 50=error, 60=fatal) */
+    level: LogLevel;
+    /** Source component (http, websocket, queue, ai-service, coc-service, …) */
+    component?: string;
+    /** Log message */
+    msg: string;
+    /** Any extra structured fields from the log call */
+    [key: string]: unknown;
+}
+export interface LogHistoryOptions {
+    /** Minimum level to include (default: 'trace' = all) */
+    level?: LogLevel;
+    /** Only include entries from this component */
+    component?: string;
+    /** Return at most this many entries newest-first (default: 200, max: 1000) */
+    limit?: number;
+    /** Return only entries with ts < this ISO timestamp */
+    before?: string;
+    /** Free-text search (case-insensitive match on msg + component) */
+    search?: string;
+}
+export declare function levelToNum(level: LogLevel): number;
+export declare function numToLevel(num: number): LogLevel;
+/**
+ * Append a structured log entry to the ring buffer and emit it to live SSE clients.
+ * Called by the server-logger proxy wrapper.
+ */
+export declare function captureEntry(entry: LogEntry): void;
+/**
+ * Return buffered log entries (newest-last order) with optional filtering.
+ * The returned array is always a shallow copy.
+ */
+export declare function getLogHistory(opts?: LogHistoryOptions): LogEntry[];
+/**
+ * Returns the EventEmitter for live log subscriptions.
+ * Subscribers listen for 'log-entry' events with LogEntry payloads.
+ */
+export declare function getLogEmitter(): EventEmitter;
+/**
+ * Clear the in-memory ring buffer (does not delete any log files).
+ */
+export declare function clearLogBuffer(): void;
+/**
+ * Build a LogEntry from raw Pino bindings and a log call's arguments.
+ * Handles the two Pino call forms:
+ *   logger.info(msg)
+ *   logger.info({ ...mergeObj }, msg)
+ */
+export declare function buildLogEntry(pinoLevelNum: number, bindings: Record<string, unknown>, args: unknown[]): LogEntry | null;
+//# sourceMappingURL=server-log-capture.d.ts.map

package/dist/server/server-log-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-capture.d.ts","sourceRoot":"","sources":["../../src/server/server-log-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,QAAQ;IACrB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,KAAK,EAAE,QAAQ,CAAC;IAChB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAwBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEhD;AAoBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAMlD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,iBAAsB,GAAG,QAAQ,EAAE,CAqBtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,OAAO,EAAE,GAChB,QAAQ,GAAG,IAAI,CAkDjB"}

package/dist/server/server-log-capture.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Server Log Capture
+ *
+ * In-process ring buffer + EventEmitter for live server log streaming.
+ * All coc-server log calls are captured here so the /api/logs endpoints
+ * can serve real-time SSE streams and history without requiring a log file.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.levelToNum = levelToNum;
+exports.numToLevel = numToLevel;
+exports.captureEntry = captureEntry;
+exports.getLogHistory = getLogHistory;
+exports.getLogEmitter = getLogEmitter;
+exports.clearLogBuffer = clearLogBuffer;
+exports.buildLogEntry = buildLogEntry;
+const events_1 = require("events");
+// ============================================================================
+// Level utilities
+// ============================================================================
+const LEVEL_NUM = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+const NUM_LEVEL = {
+    10: 'trace',
+    20: 'debug',
+    30: 'info',
+    40: 'warn',
+    50: 'error',
+    60: 'fatal',
+};
+function levelToNum(level) {
+    return LEVEL_NUM[level] ?? 30;
+}
+function numToLevel(num) {
+    return NUM_LEVEL[num] ?? 'info';
+}
+// ============================================================================
+// Ring Buffer
+// ============================================================================
+const MAX_BUFFER = 1000;
+const buffer = [];
+// ============================================================================
+// EventEmitter
+// ============================================================================
+const emitter = new events_1.EventEmitter();
+emitter.setMaxListeners(200);
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Append a structured log entry to the ring buffer and emit it to live SSE clients.
+ * Called by the server-logger proxy wrapper.
+ */
+function captureEntry(entry) {
+    buffer.push(entry);
+    if (buffer.length > MAX_BUFFER) {
+        buffer.shift();
+    }
+    emitter.emit('log-entry', entry);
+}
+/**
+ * Return buffered log entries (newest-last order) with optional filtering.
+ * The returned array is always a shallow copy.
+ */
+function getLogHistory(opts = {}) {
+    const minLevel = opts.level ? levelToNum(opts.level) : 0;
+    const limit = Math.min(opts.limit ?? 200, 1000);
+    const beforeMs = opts.before ? Date.parse(opts.before) : Infinity;
+    const search = opts.search?.toLowerCase();
+    // Filter newest-first
+    const results = [];
+    for (let i = buffer.length - 1; i >= 0 && results.length < limit; i--) {
+        const e = buffer[i];
+        if (levelToNum(e.level) < minLevel)
+            continue;
+        if (opts.component && e.component !== opts.component)
+            continue;
+        const entryMs = Date.parse(e.ts);
+        if (entryMs >= beforeMs)
+            continue;
+        if (search) {
+            const hay = (e.msg + ' ' + (e.component ?? '')).toLowerCase();
+            if (!hay.includes(search))
+                continue;
+        }
+        results.push(e);
+    }
+    return results;
+}
+/**
+ * Returns the EventEmitter for live log subscriptions.
+ * Subscribers listen for 'log-entry' events with LogEntry payloads.
+ */
+function getLogEmitter() {
+    return emitter;
+}
+/**
+ * Clear the in-memory ring buffer (does not delete any log files).
+ */
+function clearLogBuffer() {
+    buffer.splice(0, buffer.length);
+}
+/**
+ * Build a LogEntry from raw Pino bindings and a log call's arguments.
+ * Handles the two Pino call forms:
+ *   logger.info(msg)
+ *   logger.info({ ...mergeObj }, msg)
+ */
+function buildLogEntry(pinoLevelNum, bindings, args) {
+    if (args.length === 0)
+        return null;
+    let msg = '';
+    let extra = {};
+    if (typeof args[0] === 'string') {
+        // logger.info(msg, ...formatArgs)
+        msg = args[0];
+    }
+    else if (args[0] !== null && typeof args[0] === 'object' && !Buffer.isBuffer(args[0])) {
+        // logger.info({ ...mergeObj }, msg)
+        const mergeObj = args[0];
+        msg = typeof args[1] === 'string' ? args[1] : '';
+        // Copy merge obj fields (excluding internal Pino keys)
+        for (const [k, v] of Object.entries(mergeObj)) {
+            if (k !== 'level' && k !== 'time' && k !== 'pid' && k !== 'hostname') {
+                extra[k] = v;
+            }
+        }
+    }
+    else {
+        return null;
+    }
+    const level = numToLevel(pinoLevelNum);
+    const component = bindings.component
+        ?? extra.component;
+    const entry = {
+        ts: new Date().toISOString(),
+        level,
+        msg,
+    };
+    if (component !== undefined) {
+        entry.component = component;
+    }
+    // Copy remaining bindings (excluding internal fields & component already applied)
+    for (const [k, v] of Object.entries(bindings)) {
+        if (k !== 'component' && k !== 'store') {
+            entry[k] = v;
+        }
+    }
+    for (const [k, v] of Object.entries(extra)) {
+        if (k !== 'component') {
+            entry[k] = v;
+        }
+    }
+    return entry;
+}
+//# sourceMappingURL=server-log-capture.js.map

package/dist/server/server-log-capture.js.map

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

package/dist/server/server-logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Server-scoped Pino logger for coc-server.
+ *
+ * Provides a set/get pair for injecting a Pino logger from the outside
+ * (e.g., the `coc` CLI serve command) while keeping coc-server self-contained
+ * and testable — tests can inject a silent logger or a captured stream.
+ *
+ * Falls back to a silent logger when `setServerLogger()` has not been called,
+ * so no crash or output occurs when used without configuration.
+ *
+ * When a logger is injected via setServerLogger(), it is wrapped in a lightweight
+ * proxy that intercepts log calls and feeds them into the in-process log capture
+ * ring buffer (server-log-capture.ts). This enables /api/logs/stream without
+ * requiring log files to be configured.
+ */
+import pino from 'pino';
+/**
+ * Inject a Pino logger for use across all coc-server modules.
+ * The logger is wrapped in a capture proxy before storage so all log calls
+ * are also forwarded to the in-process log buffer.
+ * Call this once from the `coc serve` command before the HTTP server starts.
+ */
+export declare function setServerLogger(logger: pino.Logger): void;
+/**
+ * Returns the active server logger.
+ * Falls back to a silent (no-op) logger if `setServerLogger()` was not called.
+ */
+export declare function getServerLogger(): pino.Logger;
+/** Create a child logger bound to the HTTP request pipeline. */
+export declare function createRequestLogger(): pino.Logger;
+/** Create a child logger bound to the WebSocket subsystem. */
+export declare function createWSLogger(): pino.Logger;
+/** Create a child logger bound to the task queue subsystem. */
+export declare function createQueueLogger(): pino.Logger;
+//# sourceMappingURL=server-logger.d.ts.map

package/dist/server/server-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-logger.d.ts","sourceRoot":"","sources":["../../src/server/server-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAgExB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAAC,MAAM,CAQ7C;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAEjD;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,IAAI,IAAI,CAAC,MAAM,CAE5C;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAE/C"}

package/dist/server/server-logger.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Server-scoped Pino logger for coc-server.
+ *
+ * Provides a set/get pair for injecting a Pino logger from the outside
+ * (e.g., the `coc` CLI serve command) while keeping coc-server self-contained
+ * and testable — tests can inject a silent logger or a captured stream.
+ *
+ * Falls back to a silent logger when `setServerLogger()` has not been called,
+ * so no crash or output occurs when used without configuration.
+ *
+ * When a logger is injected via setServerLogger(), it is wrapped in a lightweight
+ * proxy that intercepts log calls and feeds them into the in-process log capture
+ * ring buffer (server-log-capture.ts). This enables /api/logs/stream without
+ * requiring log files to be configured.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setServerLogger = setServerLogger;
+exports.getServerLogger = getServerLogger;
+exports.createRequestLogger = createRequestLogger;
+exports.createWSLogger = createWSLogger;
+exports.createQueueLogger = createQueueLogger;
+const pino_1 = __importDefault(require("pino"));
+const server_log_capture_1 = require("./server-log-capture");
+// ── Level number lookup ────────────────────────────────────────────────────
+const PINO_LEVELS = [
+    ['trace', 10],
+    ['debug', 20],
+    ['info', 30],
+    ['warn', 40],
+    ['error', 50],
+    ['fatal', 60],
+];
+// ── Proxy factory ──────────────────────────────────────────────────────────
+/**
+ * Wrap a Pino logger so every log call is also forwarded to the capture buffer.
+ * The original logger is called first (preserving all Pino behaviour); capture
+ * is best-effort (errors are silently swallowed).
+ *
+ * @param logger  - The real Pino logger to wrap.
+ * @param bindings - Accumulated child bindings (component, store, …).
+ */
+function wrapForCapture(logger, bindings = {}) {
+    return new Proxy(logger, {
+        get(target, prop) {
+            // Intercept log-level methods
+            const levelEntry = PINO_LEVELS.find(([name]) => name === prop);
+            if (levelEntry) {
+                const [, levelNum] = levelEntry;
+                return (...args) => {
+                    // Call original first
+                    target[prop](...args);
+                    // Capture for ring buffer
+                    try {
+                        const entry = (0, server_log_capture_1.buildLogEntry)(levelNum, bindings, args);
+                        if (entry)
+                            (0, server_log_capture_1.captureEntry)(entry);
+                    }
+                    catch { /* ignore capture errors */ }
+                };
+            }
+            // Intercept child() so child loggers are also wrapped
+            if (prop === 'child') {
+                return (childBindings) => {
+                    const childLogger = target.child(childBindings);
+                    return wrapForCapture(childLogger, { ...bindings, ...childBindings });
+                };
+            }
+            return target[prop];
+        },
+    });
+}
+// ── Module-level state ─────────────────────────────────────────────────────
+let serverLogger = null;
+// Cache the silent fallback so it's not recreated on every call
+let silentFallback = null;
+/**
+ * Inject a Pino logger for use across all coc-server modules.
+ * The logger is wrapped in a capture proxy before storage so all log calls
+ * are also forwarded to the in-process log buffer.
+ * Call this once from the `coc serve` command before the HTTP server starts.
+ */
+function setServerLogger(logger) {
+    serverLogger = wrapForCapture(logger, {});
+}
+/**
+ * Returns the active server logger.
+ * Falls back to a silent (no-op) logger if `setServerLogger()` was not called.
+ */
+function getServerLogger() {
+    if (serverLogger) {
+        return serverLogger;
+    }
+    if (!silentFallback) {
+        silentFallback = (0, pino_1.default)({ level: 'silent' });
+    }
+    return silentFallback;
+}
+/** Create a child logger bound to the HTTP request pipeline. */
+function createRequestLogger() {
+    return getServerLogger().child({ component: 'http' });
+}
+/** Create a child logger bound to the WebSocket subsystem. */
+function createWSLogger() {
+    return getServerLogger().child({ component: 'websocket' });
+}
+/** Create a child logger bound to the task queue subsystem. */
+function createQueueLogger() {
+    return getServerLogger().child({ component: 'queue' });
+}
+//# sourceMappingURL=server-logger.js.map

package/dist/server/server-logger.js.map

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

package/dist/server/shared/debounced-watcher-registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * DebouncedWatcherRegistry
+ *
+ * Generic registry that manages a set of `fs.FSWatcher` instances keyed by
+ * an arbitrary string key. Each key gets its own debounce timer and
+ * accumulated set of changed file paths. After the debounce window passes
+ * without a new event the `onChange` callback fires with the collected paths.
+ *
+ * Supports an optional per-watch `shouldIgnore` predicate and `onError`
+ * callback. Falls back to non-recursive `fs.watch` on platforms that do not
+ * support the `{ recursive: true }` option (Linux + Node < 19).
+ *
+ * Zero external dependencies. Cross-platform compatible.
+ */
+export interface WatchOptions {
+    /** Override the instance-level default debounce interval. */
+    debounceMs?: number;
+    /** Return true for filenames that should be ignored. Called before buffering. */
+    shouldIgnore?: (filename: string) => boolean;
+    /**
+     * Called when the underlying `fs.FSWatcher` emits an 'error' event or
+     * when `fs.watch` itself throws. After this callback the key is automatically
+     * removed from the registry (`unwatch` is called for you).
+     */
+    onError?: (key: string, err: Error) => void;
+}
+export declare class DebouncedWatcherRegistry<K extends string = string> {
+    private readonly watchers;
+    private readonly timers;
+    private readonly changedFiles;
+    private readonly defaultDebounceMs;
+    constructor(defaultDebounceMs?: number);
+    /**
+     * Start watching `watchPath` under the given key.
+     * No-op if the key is already being watched.
+     */
+    watch(key: K, watchPath: string, onChange: (key: K, changedFiles: string[]) => void, options?: WatchOptions): void;
+    /**
+     * Stop watching the path associated with the given key.
+     * Clears any pending debounce timer and accumulated file list.
+     */
+    unwatch(key: K): void;
+    /** Stop all watchers (e.g. on server shutdown). */
+    closeAll(): void;
+    /** Returns `true` if the key is currently being watched. */
+    isWatching(key: K): boolean;
+    /** Returns all keys that currently have an active watcher. */
+    getWatchedKeys(): K[];
+}
+//# sourceMappingURL=debounced-watcher-registry.d.ts.map

package/dist/server/shared/debounced-watcher-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounced-watcher-registry.d.ts","sourceRoot":"","sources":["../../../src/server/shared/debounced-watcher-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,MAAM,WAAW,YAAY;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/C;AAMD,qBAAa,wBAAwB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,iBAAiB,SAAM;IAInC;;;OAGG;IACH,KAAK,CACD,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,EAClD,OAAO,CAAC,EAAE,YAAY,GACvB,IAAI;IAkDP;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAoBrB,mDAAmD;IACnD,QAAQ,IAAI,IAAI;IAMhB,4DAA4D;IAC5D,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAI3B,8DAA8D;IAC9D,cAAc,IAAI,CAAC,EAAE;CAGxB"}

package/dist/server/shared/debounced-watcher-registry.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * DebouncedWatcherRegistry
+ *
+ * Generic registry that manages a set of `fs.FSWatcher` instances keyed by
+ * an arbitrary string key. Each key gets its own debounce timer and
+ * accumulated set of changed file paths. After the debounce window passes
+ * without a new event the `onChange` callback fires with the collected paths.
+ *
+ * Supports an optional per-watch `shouldIgnore` predicate and `onError`
+ * callback. Falls back to non-recursive `fs.watch` on platforms that do not
+ * support the `{ recursive: true }` option (Linux + Node < 19).
+ *
+ * Zero external dependencies. Cross-platform compatible.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebouncedWatcherRegistry = void 0;
+const fs = __importStar(require("fs"));
+// ============================================================================
+// DebouncedWatcherRegistry
+// ============================================================================
+class DebouncedWatcherRegistry {
+    constructor(defaultDebounceMs = 300) {
+        this.watchers = new Map();
+        this.timers = new Map();
+        this.changedFiles = new Map();
+        this.defaultDebounceMs = defaultDebounceMs;
+    }
+    /**
+     * Start watching `watchPath` under the given key.
+     * No-op if the key is already being watched.
+     */
+    watch(key, watchPath, onChange, options) {
+        if (this.watchers.has(key))
+            return;
+        const ms = options?.debounceMs ?? this.defaultDebounceMs;
+        const shouldIgnore = options?.shouldIgnore;
+        const onError = options?.onError;
+        this.changedFiles.set(key, new Set());
+        const fire = () => {
+            this.timers.delete(key);
+            const files = Array.from(this.changedFiles.get(key) ?? []);
+            this.changedFiles.get(key)?.clear();
+            if (this.watchers.has(key)) {
+                onChange(key, files);
+            }
+        };
+        const changeHandler = (_eventType, filename) => {
+            if (!filename)
+                return;
+            if (shouldIgnore?.(filename))
+                return;
+            this.changedFiles.get(key)?.add(filename);
+            const existing = this.timers.get(key);
+            if (existing)
+                clearTimeout(existing);
+            this.timers.set(key, setTimeout(fire, ms));
+        };
+        try {
+            let watcher;
+            try {
+                watcher = fs.watch(watchPath, { recursive: true }, changeHandler);
+            }
+            catch {
+                watcher = fs.watch(watchPath, changeHandler);
+            }
+            watcher.on('error', (err) => {
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.unwatch(key);
+                onError?.(key, error);
+            });
+            this.watchers.set(key, watcher);
+        }
+        catch (err) {
+            this.changedFiles.delete(key);
+            onError?.(key, err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * Stop watching the path associated with the given key.
+     * Clears any pending debounce timer and accumulated file list.
+     */
+    unwatch(key) {
+        const timer = this.timers.get(key);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(key);
+        }
+        const watcher = this.watchers.get(key);
+        if (watcher) {
+            try {
+                watcher.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.watchers.delete(key);
+        }
+        this.changedFiles.delete(key);
+    }
+    /** Stop all watchers (e.g. on server shutdown). */
+    closeAll() {
+        for (const key of [...this.watchers.keys()]) {
+            this.unwatch(key);
+        }
+    }
+    /** Returns `true` if the key is currently being watched. */
+    isWatching(key) {
+        return this.watchers.has(key);
+    }
+    /** Returns all keys that currently have an active watcher. */
+    getWatchedKeys() {
+        return [...this.watchers.keys()];
+    }
+}
+exports.DebouncedWatcherRegistry = DebouncedWatcherRegistry;
+//# sourceMappingURL=debounced-watcher-registry.js.map

package/dist/server/shared/debounced-watcher-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounced-watcher-registry.js","sourceRoot":"","sources":["../../../src/server/shared/debounced-watcher-registry.ts"],"names":[],"mappings":"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"}

package/dist/server/shared/fs-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared filesystem utilities.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+/**
+ * Write data to a file atomically using a temp-file + rename pattern.
+ * Ensures the parent directory exists. Throws on failure.
+ */
+export declare function atomicWriteJson(filePath: string, data: unknown): void;
+/**
+ * Async variant of atomicWriteJson. Ensures the parent directory exists.
+ * Cleans up the temp file on failure and rethrows.
+ */
+export declare function atomicWriteJSON(filePath: string, data: unknown): Promise<void>;
+/**
+ * Safely extract a human-readable message from an unknown thrown value.
+ * Returns err.message for Error instances, String(err) otherwise.
+ */
+export declare function getErrorMessage(err: unknown, fallback?: string): string;
+/**
+ * If `destPath` already exists on disk, returns a non-colliding variant by
+ * appending `-<timestamp>` before the extension. Otherwise returns `destPath`
+ * unchanged.
+ */
+export declare function resolveCollision(destPath: string): Promise<string>;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/server/shared/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../../src/server/shared/fs-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAQrE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAIhF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxE"}