yepanywhere 0.1.0

package/dist/uploads/manager.d.ts

@@ -0,0 +1,84 @@
+import { type WriteStream } from "node:fs";
+import type { UploadedFile } from "@yep-anywhere/shared";
+/** Root directory for uploads (uses dataDir from config for profile support) */
+export declare const UPLOADS_DIR: string;
+/**
+ * State machine for a single upload operation.
+ * Handles streaming chunks to disk with proper cleanup on error.
+ */
+export interface UploadState {
+    id: string;
+    originalName: string;
+    sanitizedName: string;
+    filePath: string;
+    expectedSize: number;
+    bytesReceived: number;
+    mimeType: string;
+    writeStream: WriteStream | null;
+    status: "pending" | "streaming" | "complete" | "error" | "cancelled";
+}
+/**
+ * Sanitize filename to prevent path traversal and invalid characters.
+ *
+ * - Strips directory components (handles both Unix and Windows paths)
+ * - Replaces dangerous characters
+ * - Adds UUID prefix to prevent collisions
+ */
+export declare function sanitizeFilename(original: string): {
+    id: string;
+    sanitized: string;
+};
+/**
+ * Get the upload directory for a project+session.
+ * Creates the directory if it doesn't exist.
+ *
+ * @param encodedProjectPath - base64url encoded project path
+ * @param sessionId - Session identifier
+ * @param uploadsDir - Base uploads directory (defaults to UPLOADS_DIR)
+ */
+export declare function getUploadDir(encodedProjectPath: string, sessionId: string, uploadsDir?: string): Promise<string>;
+export interface UploadManagerOptions {
+    uploadsDir?: string;
+    /** Maximum upload file size in bytes. 0 = unlimited */
+    maxUploadSizeBytes?: number;
+}
+/**
+ * Manages file upload operations with streaming to disk.
+ */
+export declare class UploadManager {
+    private uploads;
+    private uploadsDir;
+    private maxUploadSizeBytes;
+    constructor(options?: UploadManagerOptions);
+    /**
+     * Start a new upload.
+     *
+     * @returns Upload ID for tracking this upload
+     * @throws Error if file size exceeds maxUploadSizeBytes limit
+     */
+    startUpload(encodedProjectPath: string, sessionId: string, originalName: string, expectedSize: number, mimeType: string): Promise<{
+        uploadId: string;
+        state: UploadState;
+    }>;
+    /**
+     * Write a chunk of data to the upload.
+     * Opens the write stream on first chunk (lazy initialization).
+     * @throws Error if writing would exceed maxUploadSizeBytes limit
+     */
+    writeChunk(uploadId: string, chunk: Buffer): Promise<number>;
+    /**
+     * Complete an upload.
+     * Closes the write stream and verifies the file.
+     */
+    completeUpload(uploadId: string): Promise<UploadedFile>;
+    /**
+     * Cancel or cleanup a failed upload.
+     * Closes stream and removes partial file.
+     */
+    cancelUpload(uploadId: string): Promise<void>;
+    /**
+     * Get current state of an upload.
+     */
+    getState(uploadId: string): UploadState | undefined;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/uploads/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/uploads/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,SAAS,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAgC,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;CACtE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB,CAsCA;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,OAAO,GAAE,oBAAyB;IAK9C;;;;;OAKG;IACG,WAAW,CACf,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IA+BpD;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmDlE;;;OAGG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoC7D;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAGpD"}

package/dist/uploads/manager.js

@@ -0,0 +1,215 @@
+import { randomUUID } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { mkdir, rm, stat } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { getDataDir } from "../config.js";
+/** Root directory for uploads (uses dataDir from config for profile support) */
+export const UPLOADS_DIR = join(getDataDir(), "uploads");
+/**
+ * Sanitize filename to prevent path traversal and invalid characters.
+ *
+ * - Strips directory components (handles both Unix and Windows paths)
+ * - Replaces dangerous characters
+ * - Adds UUID prefix to prevent collisions
+ */
+export function sanitizeFilename(original) {
+    const id = randomUUID();
+    // Extract just the filename (handle both Unix and Windows path separators)
+    // On Linux, basename() doesn't handle Windows paths, so we manually split first
+    let baseFilename = original;
+    const lastSlash = Math.max(original.lastIndexOf("/"), original.lastIndexOf("\\"));
+    if (lastSlash >= 0) {
+        baseFilename = original.slice(lastSlash + 1);
+    }
+    // Remove null bytes and other dangerous characters
+    let sanitized = baseFilename
+        .replace(/\0/g, "")
+        .replace(/[<>:"/\\|?*]/g, "_") // Windows-invalid chars (includes path separators)
+        .replace(/\.\./g, "_") // path traversal
+        .trim();
+    // Handle empty or only-underscore/dot names
+    if (!sanitized || /^[_.\s]*$/.test(sanitized)) {
+        sanitized = "unnamed";
+    }
+    // Ensure reasonable length (keep extension)
+    const ext = extname(sanitized);
+    const nameWithoutExt = sanitized.slice(0, sanitized.length - ext.length);
+    if (nameWithoutExt.length > 200) {
+        sanitized = nameWithoutExt.slice(0, 200) + ext;
+    }
+    // Prefix with UUID
+    return {
+        id,
+        sanitized: `${id}_${sanitized}`,
+    };
+}
+/**
+ * Get the upload directory for a project+session.
+ * Creates the directory if it doesn't exist.
+ *
+ * @param encodedProjectPath - base64url encoded project path
+ * @param sessionId - Session identifier
+ * @param uploadsDir - Base uploads directory (defaults to UPLOADS_DIR)
+ */
+export async function getUploadDir(encodedProjectPath, sessionId, uploadsDir = UPLOADS_DIR) {
+    const dir = join(uploadsDir, encodedProjectPath, sessionId);
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Manages file upload operations with streaming to disk.
+ */
+export class UploadManager {
+    uploads = new Map();
+    uploadsDir;
+    maxUploadSizeBytes;
+    constructor(options = {}) {
+        this.uploadsDir = options.uploadsDir ?? UPLOADS_DIR;
+        this.maxUploadSizeBytes = options.maxUploadSizeBytes ?? 0;
+    }
+    /**
+     * Start a new upload.
+     *
+     * @returns Upload ID for tracking this upload
+     * @throws Error if file size exceeds maxUploadSizeBytes limit
+     */
+    async startUpload(encodedProjectPath, sessionId, originalName, expectedSize, mimeType) {
+        // Check file size limit
+        if (this.maxUploadSizeBytes > 0 && expectedSize > this.maxUploadSizeBytes) {
+            const maxMB = Math.round(this.maxUploadSizeBytes / (1024 * 1024));
+            throw new Error(`File size exceeds maximum allowed size of ${maxMB}MB`);
+        }
+        const uploadDir = await getUploadDir(encodedProjectPath, sessionId, this.uploadsDir);
+        const { id, sanitized } = sanitizeFilename(originalName);
+        const filePath = join(uploadDir, sanitized);
+        const state = {
+            id,
+            originalName,
+            sanitizedName: sanitized,
+            filePath,
+            expectedSize,
+            bytesReceived: 0,
+            mimeType,
+            writeStream: null,
+            status: "pending",
+        };
+        this.uploads.set(id, state);
+        return { uploadId: id, state };
+    }
+    /**
+     * Write a chunk of data to the upload.
+     * Opens the write stream on first chunk (lazy initialization).
+     * @throws Error if writing would exceed maxUploadSizeBytes limit
+     */
+    async writeChunk(uploadId, chunk) {
+        const state = this.uploads.get(uploadId);
+        if (!state) {
+            throw new Error(`Upload not found: ${uploadId}`);
+        }
+        if (state.status === "cancelled" || state.status === "error") {
+            throw new Error(`Upload is ${state.status}`);
+        }
+        // Check if this chunk would exceed the size limit
+        if (this.maxUploadSizeBytes > 0) {
+            const newTotal = state.bytesReceived + chunk.length;
+            if (newTotal > this.maxUploadSizeBytes) {
+                const maxMB = Math.round(this.maxUploadSizeBytes / (1024 * 1024));
+                throw new Error(`Upload exceeds maximum allowed size of ${maxMB}MB`);
+            }
+        }
+        // Lazy-create write stream on first chunk
+        if (!state.writeStream) {
+            state.writeStream = createWriteStream(state.filePath);
+            state.status = "streaming";
+            // Handle stream errors
+            state.writeStream.on("error", () => {
+                state.status = "error";
+            });
+        }
+        // Write chunk and track bytes
+        return new Promise((resolve, reject) => {
+            const canContinue = state.writeStream?.write(chunk, (err) => {
+                if (err) {
+                    state.status = "error";
+                    reject(err);
+                }
+                else {
+                    state.bytesReceived += chunk.length;
+                    resolve(state.bytesReceived);
+                }
+            });
+            // Handle backpressure - wait for drain if buffer is full
+            if (!canContinue) {
+                state.writeStream?.once("drain", () => {
+                    // Already resolved in callback above
+                });
+            }
+        });
+    }
+    /**
+     * Complete an upload.
+     * Closes the write stream and verifies the file.
+     */
+    async completeUpload(uploadId) {
+        const state = this.uploads.get(uploadId);
+        if (!state) {
+            throw new Error(`Upload not found: ${uploadId}`);
+        }
+        if (state.status !== "streaming" && state.status !== "pending") {
+            throw new Error(`Cannot complete upload in status: ${state.status}`);
+        }
+        // Close the write stream
+        if (state.writeStream) {
+            await new Promise((resolve, reject) => {
+                state.writeStream?.end((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+        // Verify file exists and get actual size
+        const stats = await stat(state.filePath);
+        state.status = "complete";
+        this.uploads.delete(uploadId);
+        return {
+            id: state.id,
+            originalName: state.originalName,
+            name: state.sanitizedName,
+            path: state.filePath,
+            size: stats.size,
+            mimeType: state.mimeType,
+        };
+    }
+    /**
+     * Cancel or cleanup a failed upload.
+     * Closes stream and removes partial file.
+     */
+    async cancelUpload(uploadId) {
+        const state = this.uploads.get(uploadId);
+        if (!state) {
+            return; // Already cleaned up
+        }
+        state.status = "cancelled";
+        // Close the write stream
+        if (state.writeStream) {
+            state.writeStream.destroy();
+        }
+        // Remove partial file
+        try {
+            await rm(state.filePath, { force: true });
+        }
+        catch {
+            // Ignore - file may not exist yet
+        }
+        this.uploads.delete(uploadId);
+    }
+    /**
+     * Get current state of an upload.
+     */
+    getState(uploadId) {
+        return this.uploads.get(uploadId);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/uploads/manager.js.map

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

package/dist/utils/fileLock.d.ts

@@ -0,0 +1,57 @@
+/**
+ * File locking utilities for coordinating access to shared data files
+ * across multiple yep-anywhere server instances.
+ *
+ * Uses proper-lockfile which:
+ * - Uses mkdir for atomic lock acquisition (works on local + network FS)
+ * - Periodically updates mtime to detect stale locks from crashed processes
+ * - Pure JS, no native dependencies
+ */
+export interface FileLockOptions {
+    /** Number of retries if lock is held (default: 3) */
+    retries?: number;
+    /** Lock considered stale after this many ms (default: 10000) */
+    stale?: number;
+}
+/**
+ * Execute a function while holding an exclusive lock on a file.
+ * Use this for read-modify-write operations on shared files.
+ *
+ * @example
+ * await withFileLock(metadataPath, async () => {
+ *   const data = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+ *   data.starred = true;
+ *   await fs.writeFile(metadataPath, JSON.stringify(data, null, 2));
+ * });
+ */
+export declare function withFileLock<T>(filePath: string, fn: () => Promise<T>, options?: FileLockOptions): Promise<T>;
+export interface CacheWriterOptions {
+    /** Lock considered stale after this many ms (default: 30000) */
+    stale?: number;
+    /** Heartbeat interval in ms (default: 10000) */
+    update?: number;
+}
+/**
+ * Try to claim exclusive cache writer rights for this process.
+ * Only one process should write cache/index files to avoid conflicts.
+ *
+ * Returns a release function if lock acquired, null if another process holds it.
+ * The lock is maintained via periodic heartbeat until released or process exits.
+ *
+ * @example
+ * const release = await tryClaimCacheWriter(dataDir);
+ * if (release) {
+ *   console.log('I am the cache writer');
+ *   // Write cache files...
+ *   // On shutdown: await release();
+ * } else {
+ *   console.log('Another process is the cache writer');
+ * }
+ */
+export declare function tryClaimCacheWriter(dataDir: string, options?: CacheWriterOptions): Promise<(() => Promise<void>) | null>;
+/**
+ * Check if a file is currently locked.
+ * Useful for diagnostics/testing.
+ */
+export declare function isFileLocked(filePath: string): Promise<boolean>;
+//# sourceMappingURL=fileLock.d.ts.map

package/dist/utils/fileLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLock.d.ts","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAyBvC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMrE"}

package/dist/utils/fileLock.js

@@ -0,0 +1,91 @@
+/**
+ * File locking utilities for coordinating access to shared data files
+ * across multiple yep-anywhere server instances.
+ *
+ * Uses proper-lockfile which:
+ * - Uses mkdir for atomic lock acquisition (works on local + network FS)
+ * - Periodically updates mtime to detect stale locks from crashed processes
+ * - Pure JS, no native dependencies
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import lockfile from "proper-lockfile";
+/**
+ * Execute a function while holding an exclusive lock on a file.
+ * Use this for read-modify-write operations on shared files.
+ *
+ * @example
+ * await withFileLock(metadataPath, async () => {
+ *   const data = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+ *   data.starred = true;
+ *   await fs.writeFile(metadataPath, JSON.stringify(data, null, 2));
+ * });
+ */
+export async function withFileLock(filePath, fn, options) {
+    const release = await lockfile.lock(filePath, {
+        stale: options?.stale ?? 10000,
+        retries: options?.retries ?? 3,
+    });
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+/**
+ * Try to claim exclusive cache writer rights for this process.
+ * Only one process should write cache/index files to avoid conflicts.
+ *
+ * Returns a release function if lock acquired, null if another process holds it.
+ * The lock is maintained via periodic heartbeat until released or process exits.
+ *
+ * @example
+ * const release = await tryClaimCacheWriter(dataDir);
+ * if (release) {
+ *   console.log('I am the cache writer');
+ *   // Write cache files...
+ *   // On shutdown: await release();
+ * } else {
+ *   console.log('Another process is the cache writer');
+ * }
+ */
+export async function tryClaimCacheWriter(dataDir, options) {
+    const sentinelPath = path.join(dataDir, "cache-writer.sentinel");
+    // Ensure data dir and sentinel file exist (lockfile needs the file to exist)
+    await fs.mkdir(dataDir, { recursive: true });
+    try {
+        await fs.writeFile(sentinelPath, "", { flag: "wx" }); // create only if not exists
+    }
+    catch (e) {
+        // File already exists, that's fine
+        if (e.code !== "EEXIST") {
+            throw e;
+        }
+    }
+    try {
+        const release = await lockfile.lock(sentinelPath, {
+            stale: options?.stale ?? 30000,
+            update: options?.update ?? 10000,
+            retries: 0, // Don't wait, fail immediately if held
+        });
+        return release;
+    }
+    catch {
+        // Lock held by another process (or other error - treat as "can't acquire")
+        return null;
+    }
+}
+/**
+ * Check if a file is currently locked.
+ * Useful for diagnostics/testing.
+ */
+export async function isFileLocked(filePath) {
+    try {
+        return await lockfile.check(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fileLock.js.map

package/dist/utils/fileLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLock.js","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AASvC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,EAAoB,EACpB,OAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE;QAC5C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;QAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,OAA4B;IAE5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAEjE,6EAA6E;IAC7E,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,4BAA4B;IACpF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mCAAmC;QACnC,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE;YAChD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;YAC9B,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;YAChC,OAAO,EAAE,CAAC,EAAE,uCAAuC;SACpD,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/watcher/BatchProcessor.d.ts

@@ -0,0 +1,58 @@
+/**
+ * BatchProcessor collects async tasks and processes them with limited concurrency.
+ *
+ * Designed to prevent memory spikes from processing many file change events simultaneously.
+ * Tasks are deduplicated by key - if the same key is enqueued multiple times before
+ * the batch flushes, only the last task runs.
+ */
+type Task<T> = () => Promise<T>;
+export interface BatchProcessorOptions<T> {
+    /** Max concurrent tasks (default: 5) */
+    concurrency?: number;
+    /** Batch window in ms - wait this long to collect events before processing (default: 300) */
+    batchMs?: number;
+    /** Called for each successful result */
+    onResult?: (key: string, result: T) => void;
+    /** Called on task error */
+    onError?: (key: string, error: Error) => void;
+}
+export declare class BatchProcessor<T> {
+    private pending;
+    private processing;
+    private flushTimeout;
+    private concurrency;
+    private batchMs;
+    private onResult?;
+    private onError?;
+    constructor(options?: BatchProcessorOptions<T>);
+    /**
+     * Queue a task for processing.
+     * If the same key is queued again before the batch flushes, the previous task is replaced.
+     */
+    enqueue(key: string, task: Task<T>): void;
+    /**
+     * Get the number of pending tasks waiting to be processed.
+     */
+    get pendingCount(): number;
+    /**
+     * Check if the processor is currently processing a batch.
+     */
+    get isProcessing(): boolean;
+    /**
+     * Force immediate processing of pending tasks.
+     * Useful for testing or shutdown scenarios.
+     */
+    flush(): Promise<void>;
+    /**
+     * Cancel all pending tasks and clear the queue.
+     */
+    clear(): void;
+    /**
+     * Dispose of the processor, clearing all pending tasks.
+     */
+    dispose(): void;
+    private scheduleFlush;
+    private processBatch;
+}
+export {};
+//# sourceMappingURL=BatchProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchProcessor.d.ts","sourceRoot":"","sources":["../../src/watcher/BatchProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,IAAI,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhC,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/C;AAED,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAmC;IACpD,OAAO,CAAC,OAAO,CAAC,CAAsC;gBAE1C,OAAO,GAAE,qBAAqB,CAAC,CAAC,CAAM;IAOlD;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAKzC;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,aAAa;YASP,YAAY;CAgC3B"}

package/dist/watcher/BatchProcessor.js

@@ -0,0 +1,105 @@
+/**
+ * BatchProcessor collects async tasks and processes them with limited concurrency.
+ *
+ * Designed to prevent memory spikes from processing many file change events simultaneously.
+ * Tasks are deduplicated by key - if the same key is enqueued multiple times before
+ * the batch flushes, only the last task runs.
+ */
+export class BatchProcessor {
+    pending = new Map();
+    processing = false;
+    flushTimeout = null;
+    concurrency;
+    batchMs;
+    onResult;
+    onError;
+    constructor(options = {}) {
+        this.concurrency = options.concurrency ?? 5;
+        this.batchMs = options.batchMs ?? 300;
+        this.onResult = options.onResult;
+        this.onError = options.onError;
+    }
+    /**
+     * Queue a task for processing.
+     * If the same key is queued again before the batch flushes, the previous task is replaced.
+     */
+    enqueue(key, task) {
+        this.pending.set(key, task);
+        this.scheduleFlush();
+    }
+    /**
+     * Get the number of pending tasks waiting to be processed.
+     */
+    get pendingCount() {
+        return this.pending.size;
+    }
+    /**
+     * Check if the processor is currently processing a batch.
+     */
+    get isProcessing() {
+        return this.processing;
+    }
+    /**
+     * Force immediate processing of pending tasks.
+     * Useful for testing or shutdown scenarios.
+     */
+    async flush() {
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        await this.processBatch();
+    }
+    /**
+     * Cancel all pending tasks and clear the queue.
+     */
+    clear() {
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        this.pending.clear();
+    }
+    /**
+     * Dispose of the processor, clearing all pending tasks.
+     */
+    dispose() {
+        this.clear();
+    }
+    scheduleFlush() {
+        if (this.flushTimeout)
+            return;
+        this.flushTimeout = setTimeout(() => {
+            this.flushTimeout = null;
+            this.processBatch();
+        }, this.batchMs);
+    }
+    async processBatch() {
+        if (this.processing || this.pending.size === 0)
+            return;
+        this.processing = true;
+        // Grab current batch and clear pending
+        const batch = new Map(this.pending);
+        this.pending.clear();
+        const entries = Array.from(batch.entries());
+        // Process in chunks of `concurrency` size
+        for (let i = 0; i < entries.length; i += this.concurrency) {
+            const chunk = entries.slice(i, i + this.concurrency);
+            await Promise.all(chunk.map(async ([key, task]) => {
+                try {
+                    const result = await task();
+                    this.onResult?.(key, result);
+                }
+                catch (err) {
+                    this.onError?.(key, err);
+                }
+            }));
+        }
+        this.processing = false;
+        // If more events arrived during processing, schedule another flush
+        if (this.pending.size > 0) {
+            this.scheduleFlush();
+        }
+    }
+}
+//# sourceMappingURL=BatchProcessor.js.map

package/dist/watcher/BatchProcessor.js.map

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