@archlast/server 0.0.1

package/dist/jobs/worker.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = exports.handlers = void 0;
+exports.registerHandler = registerHandler;
+exports.removeHandler = removeHandler;
+exports.getHandlers = getHandlers;
+exports.setEngineDispatcher = setEngineDispatcher;
+exports.initWorker = initWorker;
+const logger_js_1 = require("../logging/logger.js");
+const worker_thread_js_1 = require("./worker-thread.js");
+/**
+ * Register job handlers here. Example:
+ * {
+ *   sendEmail: async (payload) => { ... },
+ *   generateReport: async (payload) => { ... },
+ * }
+ */
+exports.handlers = {};
+function registerHandler(name, handler) {
+    exports.handlers[name] = handler;
+}
+function removeHandler(name) {
+    delete exports.handlers[name];
+}
+function getHandlers() {
+    return exports.handlers;
+}
+let engineDispatcher = null;
+function setEngineDispatcher(dispatcher) {
+    engineDispatcher = dispatcher;
+}
+// Job queue will be set by init()
+let queue = null;
+let ipc = null;
+/**
+ * Initialize the worker with a job queue.
+ * Must be called before start().
+ */
+function initWorker(jobQueue, ipcClient) {
+    queue = jobQueue;
+    ipc = ipcClient ?? null;
+}
+/** Worker configuration */
+const POLL_INTERVAL_MS = 500;
+const MAX_CONCURRENCY = Number(process.env.JOB_WORKER_CONCURRENCY ?? 5);
+const THREAD_POOL_SIZE = Number(process.env.JOB_WORKER_THREADS ?? 1);
+let active = 0;
+let shuttingDown = false;
+const threadPool = THREAD_POOL_SIZE > 0 ? new worker_thread_js_1.WorkerPool(THREAD_POOL_SIZE) : null;
+const revalidationMetrics = { success: 0, failure: 0 };
+/** Sleep helper */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function notifyRevalidation(data) {
+    const queries = data.queries ? Array.from(data.queries) : [];
+    const keys = data.keys ? Array.from(data.keys) : [];
+    if (queries.length === 0 && keys.length === 0) {
+        return;
+    }
+    // Send REACTIVE_TRIGGER via IPC to broadcast to main server
+    if (ipc && ipc.isConnected()) {
+        try {
+            await ipc.request("REACTIVE_TRIGGER", { keys });
+        }
+        catch (err) {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: "[Worker] Failed to send reactivity trigger:",
+                context: { err },
+            });
+        }
+    }
+}
+/** Process a single claimed job */
+async function processJob(job) {
+    if (!queue) {
+        throw new Error("Worker not initialized - call initWorker() first");
+    }
+    const handler = exports.handlers[job.name];
+    if (!handler) {
+        if (threadPool) {
+            try {
+                const payload = (job.payload ?? {});
+                const res = await threadPool.run(job._id, job.name, payload);
+                if (!res.ok) {
+                    await queue.fail(job, new Error(res.error));
+                    return;
+                }
+                await queue.complete(job._id);
+                const queriesSet = res.affectedQueries ? new Set(res.affectedQueries) : undefined;
+                const keysSet = res.affectedKeys ? new Set(res.affectedKeys) : undefined;
+                if (queriesSet || keysSet) {
+                    await notifyRevalidation({ queries: queriesSet, keys: keysSet });
+                }
+            }
+            catch (err) {
+                await queue.fail(job, err);
+            }
+            return;
+        }
+        if (engineDispatcher) {
+            try {
+                const payload = (job.payload ?? {});
+                const auth = { userId: payload.__authUserId ?? null };
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "info",
+                    kind: "system",
+                    message: "[Worker] Executing job via engineDispatcher",
+                    context: { data: [{ jobName: job.name, payload }] },
+                });
+                const result = await engineDispatcher.runFunction(job.name, payload, auth);
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "info",
+                    kind: "system",
+                    message: "[Worker] Job completed, result:",
+                    context: {
+                        data: [
+                            {
+                                jobName: job.name,
+                                hasResult: !!result,
+                                affectedKeysSize: result?.affectedKeys?.size ?? 0,
+                                affectedQueriesSize: result?.affectedQueries?.size ?? 0,
+                                affectedKeys: result?.affectedKeys
+                                    ? Array.from(result.affectedKeys)
+                                    : [],
+                                affectedQueries: result?.affectedQueries
+                                    ? Array.from(result.affectedQueries)
+                                    : [],
+                            },
+                        ],
+                    },
+                });
+                // Debug logging (non-blocking)
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "debug",
+                    kind: "system",
+                    message: "Job completed with result metadata",
+                    context: {
+                        jobName: job.name,
+                        hasResult: !!result,
+                        affectedKeysSize: result?.affectedKeys?.size ?? 0,
+                        affectedQueriesSize: result?.affectedQueries?.size ?? 0,
+                        affectedKeys: result?.affectedKeys ? Array.from(result.affectedKeys) : [],
+                    },
+                });
+                // Notify reactivity BEFORE completing the job
+                await notifyRevalidation({
+                    queries: result?.affectedQueries instanceof Set && result.affectedQueries.size > 0
+                        ? result.affectedQueries
+                        : undefined,
+                    keys: result?.affectedKeys instanceof Set && result.affectedKeys.size > 0
+                        ? result.affectedKeys
+                        : undefined,
+                });
+                // Mark job as complete AFTER reactivity
+                await queue.complete(job._id);
+            }
+            catch (err) {
+                await queue.fail(job, err);
+            }
+        }
+        else {
+            await queue.fail(job, new Error(`No handler for job '${job.name}'`));
+        }
+        return;
+    }
+    try {
+        const res = await handler(job.payload);
+        await queue.complete(job._id);
+        if (res && typeof res === "object") {
+            const queriesRaw = res.affectedQueries;
+            const keysRaw = res.affectedKeys;
+            const queriesSet = queriesRaw instanceof Set
+                ? queriesRaw
+                : Array.isArray(queriesRaw)
+                    ? new Set(queriesRaw)
+                    : undefined;
+            const keysSet = keysRaw instanceof Set
+                ? keysRaw
+                : Array.isArray(keysRaw)
+                    ? new Set(keysRaw)
+                    : undefined;
+            if (queriesSet || keysSet) {
+                await notifyRevalidation({
+                    queries: queriesSet,
+                    keys: keysSet,
+                });
+            }
+        }
+    }
+    catch (err) {
+        await queue.fail(job, err);
+    }
+}
+/** Worker loop */
+async function runLoop() {
+    if (!queue) {
+        throw new Error("Worker not initialized - call initWorker() first");
+    }
+    while (!shuttingDown) {
+        if (active >= MAX_CONCURRENCY) {
+            await sleep(POLL_INTERVAL_MS);
+            continue;
+        }
+        const job = await queue.claimNext();
+        if (!job) {
+            await sleep(POLL_INTERVAL_MS);
+            continue;
+        }
+        active++;
+        void (async () => {
+            try {
+                await processJob(job);
+            }
+            finally {
+                active--;
+            }
+        })();
+    }
+}
+/** Graceful shutdown */
+async function shutdown() {
+    shuttingDown = true;
+    logger_js_1.logger.log({
+        timestamp: Date.now(),
+        level: "info",
+        kind: "system",
+        message: "Job worker shutting down",
+    });
+    while (active > 0) {
+        await sleep(100);
+    }
+    threadPool?.dispose();
+    queue?.dispose();
+}
+/** Entrypoint */
+async function main() {
+    if (!queue) {
+        throw new Error("Worker not initialized - call initWorker() first");
+    }
+    logger_js_1.logger.log({
+        timestamp: Date.now(),
+        level: "info",
+        kind: "system",
+        message: "Job worker started",
+        context: { concurrency: MAX_CONCURRENCY, threads: THREAD_POOL_SIZE },
+    });
+    // Handle signals for graceful shutdown
+    const signals = ["SIGINT", "SIGTERM"];
+    signals.forEach((sig) => process.on(sig, () => {
+        void shutdown().then(() => process.exit(0));
+    }));
+    await runLoop();
+}
+exports.start = main;
+//# sourceMappingURL=worker.js.map

package/dist/jobs/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":";;;AAmBA,0CAEC;AAED,sCAEC;AAED,kCAEC;AAMD,kDAIC;AAUD,gCAGC;AAnDD,oDAA8C;AAC9C,yDAAgD;AAQhD;;;;;;GAMG;AACU,QAAA,QAAQ,GAAoC,EAAE,CAAC;AAE5D,SAAgB,eAAe,CAAgB,IAAY,EAAE,OAA4B;IACrF,gBAAQ,CAAC,IAAI,CAAC,GAAG,OAA0B,CAAC;AAChD,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACtC,OAAO,gBAAQ,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,WAAW;IACvB,OAAO,gBAAQ,CAAC;AACpB,CAAC;AAED,IAAI,gBAAgB,GAET,IAAI,CAAC;AAEhB,SAAgB,mBAAmB,CAAC,UAEnC;IACG,gBAAgB,GAAG,UAAU,CAAC;AAClC,CAAC;AAED,kCAAkC;AAClC,IAAI,KAAK,GAAoB,IAAI,CAAC;AAClC,IAAI,GAAG,GAAqB,IAAI,CAAC;AAEjC;;;GAGG;AACH,SAAgB,UAAU,CAAC,QAAkB,EAAE,SAAqB;IAChE,KAAK,GAAG,QAAQ,CAAC;IACjB,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,2BAA2B;AAC3B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,CAAC,CAAC;AACxE,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC;AAErE,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,UAAU,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,6BAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,MAAM,mBAAmB,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAEvD,mBAAmB;AACnB,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAAmD;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO;IACX,CAAC;IAED,4DAA4D;IAC5D,IAAI,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,MAAM,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,6CAA6C;gBACtD,OAAO,EAAE,EAAE,GAAG,EAAE;aACnB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;AACL,CAAC;AAED,mCAAmC;AACnC,KAAK,UAAU,UAAU,CAAC,GAAc;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,gBAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,IAAI,UAAU,EAAE,CAAC;YACb,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAQ,CAAC;gBAC3C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACV,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC5C,OAAO;gBACX,CAAC;gBACD,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAClF,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzE,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,kBAAkB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrE,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO;QACX,CAAC;QAED,IAAI,gBAAgB,EAAE,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAQ,CAAC;gBAC3C,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,EAAS,CAAC;gBAE7D,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,6CAA6C;oBACtD,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE;iBACtD,CAAC,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAE3E,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,iCAAiC;oBAC1C,OAAO,EAAE;wBACL,IAAI,EAAE;4BACF;gCACI,OAAO,EAAE,GAAG,CAAC,IAAI;gCACjB,SAAS,EAAE,CAAC,CAAC,MAAM;gCACnB,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC;gCACjD,mBAAmB,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,IAAI,CAAC;gCACvD,YAAY,EAAE,MAAM,EAAE,YAAY;oCAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;oCACjC,CAAC,CAAC,EAAE;gCACR,eAAe,EAAE,MAAM,EAAE,eAAe;oCACpC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;oCACpC,CAAC,CAAC,EAAE;6BACX;yBACJ;qBACJ;iBACJ,CAAC,CAAC;gBACH,+BAA+B;gBAC/B,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,oCAAoC;oBAC7C,OAAO,EAAE;wBACL,OAAO,EAAE,GAAG,CAAC,IAAI;wBACjB,SAAS,EAAE,CAAC,CAAC,MAAM;wBACnB,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC;wBACjD,mBAAmB,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,IAAI,CAAC;wBACvD,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE;qBAC5E;iBACJ,CAAC,CAAC;gBAEH,8CAA8C;gBAC9C,MAAM,kBAAkB,CAAC;oBACrB,OAAO,EACH,MAAM,EAAE,eAAe,YAAY,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC;wBACrE,CAAC,CAAC,MAAM,CAAC,eAAe;wBACxB,CAAC,CAAC,SAAS;oBACnB,IAAI,EACA,MAAM,EAAE,YAAY,YAAY,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;wBAC/D,CAAC,CAAC,MAAM,CAAC,YAAY;wBACrB,CAAC,CAAC,SAAS;iBACtB,CAAC,CAAC;gBAEH,wCAAwC;gBACxC,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,UAAU,GAAI,GAAW,CAAC,eAAe,CAAC;YAChD,MAAM,OAAO,GAAI,GAAW,CAAC,YAAY,CAAC;YAE1C,MAAM,UAAU,GACZ,UAAU,YAAY,GAAG;gBACrB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;oBACzB,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;oBACrB,CAAC,CAAC,SAAS,CAAC;YAEtB,MAAM,OAAO,GACT,OAAO,YAAY,GAAG;gBAClB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;oBACtB,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC;oBAClB,CAAC,CAAC,SAAS,CAAC;YAEtB,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,kBAAkB,CAAC;oBACrB,OAAO,EAAE,UAAU;oBACnB,IAAI,EAAE,OAAO;iBAChB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACL,CAAC;AAED,kBAAkB;AAClB,KAAK,UAAU,OAAO;IAClB,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,CAAC,YAAY,EAAE,CAAC;QACnB,IAAI,MAAM,IAAI,eAAe,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC9B,SAAS;QACb,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC9B,SAAS;QACb,CAAC;QAED,MAAM,EAAE,CAAC;QACT,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,IAAI,CAAC;gBACD,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACP,MAAM,EAAE,CAAC;YACb,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;AACL,CAAC;AAED,wBAAwB;AACxB,KAAK,UAAU,QAAQ;IACnB,YAAY,GAAG,IAAI,CAAC;IACpB,kBAAM,CAAC,GAAG,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,0BAA0B;KACtC,CAAC,CAAC;IAEH,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,iBAAiB;AACjB,KAAK,UAAU,IAAI;IACf,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,kBAAM,CAAC,GAAG,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE;KACvE,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;QACjB,KAAK,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,OAAO,EAAE,CAAC;AACpB,CAAC;AAEY,QAAA,KAAK,GAAG,IAAI,CAAC"}

package/dist/jobs/ws-client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lightweight WebSocket client for background processes (scheduler/worker)
+ * to invoke mutations on the main server as if they were frontend clients.
+ *
+ * Protocol matches the server's WebSocket handler:
+ * - First send a "connect" message with optional auth payload.
+ * - Send "mutation" messages with unique mutationId, name, args.
+ * - Receive "mutationResponse" messages keyed by mutationId.
+ */
+export declare class WsJobClient {
+    private url;
+    private ws?;
+    private pending;
+    private isConnected;
+    private authPayload;
+    constructor(url?: string, auth?: Record<string, unknown>);
+    connect(): Promise<void>;
+    callMutation<TArgs = any, TResult = any>(name: string, args: TArgs): Promise<TResult>;
+    close(): void;
+    private sendRaw;
+    private handleMessage;
+}
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/jobs/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../../src/jobs/ws-client.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA0B;gBAEjC,GAAG,SAAwB,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BxB,YAAY,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB3F,KAAK;IASL,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,aAAa;CAoBxB"}

package/dist/jobs/ws-client.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WsJobClient = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Lightweight WebSocket client for background processes (scheduler/worker)
+ * to invoke mutations on the main server as if they were frontend clients.
+ *
+ * Protocol matches the server's WebSocket handler:
+ * - First send a "connect" message with optional auth payload.
+ * - Send "mutation" messages with unique mutationId, name, args.
+ * - Receive "mutationResponse" messages keyed by mutationId.
+ */
+class WsJobClient {
+    url;
+    ws;
+    pending = new Map();
+    isConnected = false;
+    authPayload;
+    constructor(url = "ws://localhost:4000", auth = {}) {
+        this.url = url;
+        this.authPayload = auth;
+    }
+    async connect() {
+        if (this.isConnected)
+            return;
+        await new Promise((resolve, reject) => {
+            this.ws = new WebSocket(this.url);
+            this.ws.onopen = () => {
+                this.isConnected = true;
+                this.sendRaw({
+                    type: "connect",
+                    auth: this.authPayload,
+                });
+                resolve();
+            };
+            this.ws.onerror = (err) => {
+                reject(err instanceof Error ? err : new Error("WebSocket error"));
+            };
+            this.ws.onmessage = (event) => this.handleMessage(event.data);
+            this.ws.onclose = () => {
+                this.isConnected = false;
+                // Reject all pending requests on unexpected close
+                for (const [, { reject }] of this.pending) {
+                    reject(new Error("WebSocket closed"));
+                }
+                this.pending.clear();
+            };
+        });
+    }
+    async callMutation(name, args) {
+        if (!this.isConnected || !this.ws) {
+            await this.connect();
+        }
+        const mutationId = (0, crypto_1.randomUUID)();
+        const payload = {
+            type: "mutation",
+            mutationId,
+            name,
+            args,
+        };
+        const promise = new Promise((resolve, reject) => {
+            this.pending.set(mutationId, { resolve, reject });
+        });
+        this.sendRaw(payload);
+        return promise;
+    }
+    close() {
+        this.pending.clear();
+        if (this.ws && this.isConnected) {
+            this.ws.close();
+        }
+        this.ws = undefined;
+        this.isConnected = false;
+    }
+    sendRaw(message) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error("WebSocket is not open");
+        }
+        this.ws.send(JSON.stringify(message));
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = typeof raw === "string" ? JSON.parse(raw) : JSON.parse(String(raw));
+        }
+        catch {
+            return;
+        }
+        if (msg.type === "mutationResponse") {
+            const entry = this.pending.get(msg.mutationId);
+            if (entry) {
+                this.pending.delete(msg.mutationId);
+                if (msg.success === false) {
+                    entry.reject(new Error(msg.error ?? "Mutation failed"));
+                }
+                else {
+                    entry.resolve(msg.data);
+                }
+            }
+        }
+    }
+}
+exports.WsJobClient = WsJobClient;
+//# sourceMappingURL=ws-client.js.map

package/dist/jobs/ws-client.js.map

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

package/dist/linq/async-enumerable.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AsyncEnumerable Implementation
+ *
+ * Provides async streaming capabilities for query results without loading
+ * the entire set into memory. Implements IAsyncEnumerable<T> with
+ * LINQ-style methods for async operations.
+ *
+ * @module linq/async-enumerable
+ */
+import type { IAsyncEnumerable } from "./index";
+type AsyncGeneratorSource<T> = AsyncGenerator<T> | (() => AsyncGenerator<T>);
+/**
+ * AsyncEnumerable<T> - Provides async iteration and LINQ operations
+ *
+ * Benefits:
+ * - O(1) memory usage vs O(n) for ToArrayAsync
+ * - Early termination support (break statement stops iteration)
+ * - Lazy evaluation of chained LINQ operations
+ *
+ * @example
+ * ```ts
+ * for await (const item of repository.tasks.AsAsyncEnumerable()) {
+ *   await processItem(item);
+ *   // Can break early without loading remaining items
+ * }
+ * ```
+ */
+export declare class AsyncEnumerable<T> implements IAsyncEnumerable<T> {
+    private readonly _source;
+    constructor(_source: AsyncGeneratorSource<T>);
+    /**
+     * Async iterator implementation
+     * Enables for await...of iteration
+     */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /**
+     * Create AsyncEnumerable from any async iterable
+     */
+    static from<T>(source: AsyncIterable<T>): AsyncEnumerable<T>;
+    /**
+     * Create AsyncEnumerable from a promise of array
+     */
+    static fromPromise<T>(promise: Promise<T[]>): AsyncEnumerable<T>;
+    /**
+     * Filter items based on predicate
+     * @example
+     * enumerable.Where(x => x.active)
+     */
+    Where(predicate: (item: T) => boolean): AsyncEnumerable<T>;
+    /**
+     * Project items to new form
+     * @example
+     * enumerable.Select(x => x.name)
+     */
+    Select<R>(selector: (item: T) => R): AsyncEnumerable<R>;
+    /**
+     * Take first n items
+     * @example
+     * enumerable.Take(10)
+     */
+    Take(count: number): AsyncEnumerable<T>;
+    /**
+     * Skip first n items
+     * @example
+     * enumerable.Skip(5)
+     */
+    Skip(count: number): AsyncEnumerable<T>;
+    /**
+     * Materialize all items to array
+     * Note: This loads entire set into memory
+     */
+    ToArrayAsync(): Promise<T[]>;
+    /**
+     * Get first item or throw if empty
+     */
+    FirstAsync(): Promise<T>;
+    /**
+     * Get first item or undefined if empty
+     */
+    FirstOrDefaultAsync(): Promise<T | undefined>;
+    /**
+     * Count items in sequence
+     */
+    CountAsync(): Promise<number>;
+    /**
+     * Check if any item exists
+     */
+    AnyAsync(): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=async-enumerable.d.ts.map

package/dist/linq/async-enumerable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-enumerable.d.ts","sourceRoot":"","sources":["../../src/linq/async-enumerable.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,oBAAoB,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,gBAAgB,CAAC,CAAC,CAAC;IAEtD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAGrD;;;OAGG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAKjD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAM5D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAShE;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC;IAU1D;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAUvD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAYvC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAcvC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAQlC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC;IAO9B;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAOnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAQnC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;CAMrC"}

package/dist/linq/async-enumerable.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * AsyncEnumerable Implementation
+ *
+ * Provides async streaming capabilities for query results without loading
+ * the entire set into memory. Implements IAsyncEnumerable<T> with
+ * LINQ-style methods for async operations.
+ *
+ * @module linq/async-enumerable
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncEnumerable = void 0;
+/**
+ * AsyncEnumerable<T> - Provides async iteration and LINQ operations
+ *
+ * Benefits:
+ * - O(1) memory usage vs O(n) for ToArrayAsync
+ * - Early termination support (break statement stops iteration)
+ * - Lazy evaluation of chained LINQ operations
+ *
+ * @example
+ * ```ts
+ * for await (const item of repository.tasks.AsAsyncEnumerable()) {
+ *   await processItem(item);
+ *   // Can break early without loading remaining items
+ * }
+ * ```
+ */
+class AsyncEnumerable {
+    _source;
+    constructor(_source) {
+        this._source = _source;
+    }
+    /**
+     * Async iterator implementation
+     * Enables for await...of iteration
+     */
+    async *[Symbol.asyncIterator]() {
+        const source = typeof this._source === "function" ? this._source() : this._source;
+        yield* source;
+    }
+    /**
+     * Create AsyncEnumerable from any async iterable
+     */
+    static from(source) {
+        return new AsyncEnumerable(async function* () {
+            for await (const item of source)
+                yield item;
+        });
+    }
+    /**
+     * Create AsyncEnumerable from a promise of array
+     */
+    static fromPromise(promise) {
+        return new AsyncEnumerable(async function* () {
+            const items = await promise;
+            for (const item of items)
+                yield item;
+        });
+    }
+    // ==================== LINQ Methods (lazy) ====================
+    /**
+     * Filter items based on predicate
+     * @example
+     * enumerable.Where(x => x.active)
+     */
+    Where(predicate) {
+        const self = this;
+        return new AsyncEnumerable(async function* () {
+            const source = typeof self._source === "function" ? self._source() : self._source;
+            for await (const item of source) {
+                if (predicate(item))
+                    yield item;
+            }
+        });
+    }
+    /**
+     * Project items to new form
+     * @example
+     * enumerable.Select(x => x.name)
+     */
+    Select(selector) {
+        const self = this;
+        return new AsyncEnumerable(async function* () {
+            const source = typeof self._source === "function" ? self._source() : self._source;
+            for await (const item of source) {
+                yield selector(item);
+            }
+        });
+    }
+    /**
+     * Take first n items
+     * @example
+     * enumerable.Take(10)
+     */
+    Take(count) {
+        const self = this;
+        return new AsyncEnumerable(async function* () {
+            let taken = 0;
+            const source = typeof self._source === "function" ? self._source() : self._source;
+            for await (const item of source) {
+                if (taken++ >= count)
+                    break;
+                yield item;
+            }
+        });
+    }
+    /**
+     * Skip first n items
+     * @example
+     * enumerable.Skip(5)
+     */
+    Skip(count) {
+        const self = this;
+        return new AsyncEnumerable(async function* () {
+            let skipped = 0;
+            const source = typeof self._source === "function" ? self._source() : self._source;
+            for await (const item of source) {
+                if (skipped++ < count)
+                    continue;
+                yield item;
+            }
+        });
+    }
+    // ==================== Terminal Methods ====================
+    /**
+     * Materialize all items to array
+     * Note: This loads entire set into memory
+     */
+    async ToArrayAsync() {
+        const result = [];
+        for await (const item of this) {
+            result.push(item);
+        }
+        return result;
+    }
+    /**
+     * Get first item or throw if empty
+     */
+    async FirstAsync() {
+        for await (const item of this) {
+            return item;
+        }
+        throw new Error("AsyncEnumerable: No elements in sequence");
+    }
+    /**
+     * Get first item or undefined if empty
+     */
+    async FirstOrDefaultAsync() {
+        for await (const item of this) {
+            return item;
+        }
+        return undefined;
+    }
+    /**
+     * Count items in sequence
+     */
+    async CountAsync() {
+        let count = 0;
+        for await (const _ of this) {
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Check if any item exists
+     */
+    async AnyAsync() {
+        for await (const _ of this) {
+            return true;
+        }
+        return false;
+    }
+}
+exports.AsyncEnumerable = AsyncEnumerable;
+//# sourceMappingURL=async-enumerable.js.map