@archlast/server 0.0.1

package/dist/jobs/run-worker.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const runtime_loader_js_1 = require("./runtime-loader.js");
+const runner_js_1 = require("../engine/runner.js");
+const graph_js_1 = require("../reactivity/graph.js");
+const factory_js_1 = require("../db/factory.js");
+const cachedclient_js_1 = require("../db/cachedclient.js");
+const worker_js_1 = require("./worker.js");
+const manager_js_1 = require("../storage/manager.js");
+const queue_js_1 = require("./queue.js");
+const fs_backend_js_1 = __importDefault(require("../storage/fs-backend.js"));
+const s3_backend_js_1 = __importDefault(require("../storage/s3-backend.js"));
+const socket_bridge_js_1 = require("../ipc/socket-bridge.js");
+const client_js_1 = require("../cache/client.js");
+const logger_js_1 = require("../logging/logger.js");
+const paths_js_1 = require("../config/paths.js");
+const index_js_1 = require("../config/index.js");
+const path_1 = require("path");
+const config = (0, index_js_1.loadServerConfig)();
+(0, paths_js_1.ensureAllDbDirectories)(config.paths);
+/**
+ * Worker entrypoint.
+ *
+ * This process hydrates the ExecutionEngine with the persisted deployment
+ * (same as the main server) so jobs can invoke deployed functions by name.
+ */
+async function bootstrapAndStart() {
+    // Initialize IPC client for worker logger
+    const ipcSocketPath = (0, path_1.join)(process.cwd(), config.paths.root, "ipc.sock");
+    let ipcClient = null;
+    let cacheClient = null;
+    try {
+        ipcClient = new socket_bridge_js_1.IpcClient(ipcSocketPath);
+        await ipcClient.connect();
+        logger_js_1.logger.setIpcClient(ipcClient);
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "[Worker] Connected to IPC sidecar",
+        });
+        // Subscribe to deployment events
+        await ipcClient.subscribe("sys:deployment", async (payload) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "deployment",
+                message: "[Worker] 📦 Deployment event received, restarting...",
+                context: payload,
+            });
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Received deployment event, restarting worker",
+                context: payload,
+            });
+            // Restart the worker process
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "[Worker] Exiting to allow restart...",
+            });
+            process.exit(0);
+        });
+        // Create cache client for engine
+        cacheClient = new client_js_1.CacheClient(ipcClient);
+        await cacheClient.connect();
+    }
+    catch (err) {
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "warn",
+            kind: "system",
+            message: "Failed to connect to IPC sidecar, continuing without IPC",
+            context: { err },
+        });
+    }
+    // Use database client from factory (supports both SQLite and document store)
+    const rawDb = (0, factory_js_1.createDatabaseClient)();
+    const db = new cachedclient_js_1.CachedDatabaseClient(rawDb, cacheClient);
+    // Set rawDb on logger for persistence (uncached to avoid cache invalidation)
+    logger_js_1.logger.setDb(rawDb);
+    // Initialize storage backend
+    const storageBackend = config.storage.s3Enabled
+        ? new s3_backend_js_1.default()
+        : new fs_backend_js_1.default({
+            root: config.storage.root,
+            signingSecret: config.storage.signingSecret,
+        });
+    const storageManager = new manager_js_1.StorageManager({
+        backend: storageBackend,
+        db: db,
+        stagingDir: `${config.paths.root}/storage/.staging`,
+        logger: logger_js_1.logger,
+    });
+    // Initialize JobQueue with database
+    const jobQueue = new queue_js_1.JobQueue({
+        db: rawDb,
+        cacheClient: cacheClient || undefined,
+    });
+    // Initialize worker module with the queue
+    (0, worker_js_1.initWorker)(jobQueue, ipcClient || undefined);
+    const graph = new graph_js_1.DependencyGraph();
+    const engine = new runner_js_1.ExecutionEngine(db, graph, storageManager, jobQueue, cacheClient, ipcClient);
+    // Load persisted deployment into this process
+    await (0, runtime_loader_js_1.loadRuntime)(engine, db);
+    // Register engine dispatcher so unnamed jobs can call functions
+    (0, worker_js_1.setEngineDispatcher)({
+        runFunction: (name, payload, auth, queryId) => engine.runFunction(name, payload, auth, queryId),
+    });
+    // Optionally register job handlers that map directly to functions
+    (0, worker_js_1.registerHandler)("__invokeFunction", async (payload) => {
+        await engine.runFunction(payload.name, payload.args ?? {}, payload.auth ?? { userId: null });
+    });
+    await (0, worker_js_1.start)();
+}
+void bootstrapAndStart();
+//# sourceMappingURL=run-worker.js.map

package/dist/jobs/run-worker.js.map

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

package/dist/jobs/runtime-loader.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionEngine } from "../engine/runner.js";
+type DbLike = {
+    applySchema?: (schema: any) => Promise<void> | void;
+};
+/**
+ * Hydrate an ExecutionEngine (and optional db) from the persisted deployment state in .archlast-deploy.
+ * Used by background worker/scheduler processes to load the same function set as the main server.
+ */
+export declare function loadRuntime(engine: ExecutionEngine, db?: DbLike): Promise<{
+    functions: number;
+    schema: boolean;
+}>;
+export {};
+//# sourceMappingURL=runtime-loader.d.ts.map

package/dist/jobs/runtime-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loader.d.ts","sourceRoot":"","sources":["../../src/jobs/runtime-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,KAAK,MAAM,GAAG;IACV,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,eAAe,EACvB,EAAE,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA6FjD"}

package/dist/jobs/runtime-loader.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRuntime = loadRuntime;
+const path_1 = require("path");
+const logger_js_1 = require("../logging/logger.js");
+const promises_1 = __importDefault(require("fs/promises"));
+const persistence_js_1 = require("../deployment/persistence.js");
+/**
+ * Hydrate an ExecutionEngine (and optional db) from the persisted deployment state in .archlast-deploy.
+ * Used by background worker/scheduler processes to load the same function set as the main server.
+ */
+async function loadRuntime(engine, db) {
+    try {
+        const persistence = new persistence_js_1.DeploymentPersistence();
+        const state = await persistence.load();
+        if (!state) {
+            return { functions: 0, schema: false };
+        }
+        const deployDir = (0, path_1.join)(process.cwd(), ".archlast-deploy");
+        await promises_1.default.mkdir(deployDir, { recursive: true });
+        await materializeFiles(state, deployDir);
+        let functionsRegistered = 0;
+        let schemaApplied = false;
+        // First, look for DI registration
+        const diFile = state.files.find((f) => f.filePath.endsWith("_generated/di.ts") || f.filePath.endsWith("_generated/di.js"));
+        if (diFile) {
+            try {
+                const diPath = (0, path_1.join)(deployDir, diFile.filePath);
+                const diMod = await import(diPath + `?t=${Date.now()}`);
+                if (diMod && typeof diMod.registerProviders === "function") {
+                    // Dynamically import container to avoid circular deps or early init issues
+                    const { globalContainer } = await import("../di/container.js");
+                    diMod.registerProviders(globalContainer);
+                    logger_js_1.logger.log({
+                        timestamp: Date.now(),
+                        level: "info",
+                        kind: "system",
+                        message: `[RuntimeLoader] Registered DI providers from ${diFile.filePath}`,
+                    });
+                }
+            }
+            catch (err) {
+                logger_js_1.logger.log({
+                    timestamp: Date.now(),
+                    level: "error",
+                    kind: "system",
+                    message: "[RuntimeLoader] Failed to register DI providers:",
+                    context: { err },
+                });
+            }
+        }
+        console.error(`[RUNTIME LOADER] Loading module: ${state.files[0]?.filePath} at ${new Date().toISOString()}`);
+        for (const file of state.files) {
+            const fullPath = (0, path_1.join)(deployDir, file.filePath);
+            const fileName = file.filePath.split(/[\\/]/).pop() || "unknown.ts";
+            const moduleName = fileName.replace(/\.(ts|js)$/, "");
+            const cacheBust = Date.now();
+            console.error(`[RUNTIME LOADER] Loading: ${file.filePath} with cache bust ${cacheBust}`);
+            const mod = await import(fullPath + `?t=${cacheBust}`);
+            if (file.filePath.endsWith("schema.ts")) {
+                if (db?.applySchema && mod.default && mod.default.tables) {
+                    await db.applySchema(mod.default);
+                    schemaApplied = true;
+                }
+                continue;
+            }
+            for (const [key, value] of Object.entries(mod)) {
+                if (value && typeof value === "object" && "type" in value && "handler" in value) {
+                    const fnName = `${moduleName}.${key}`;
+                    engine.registerFunction(fnName, value);
+                    functionsRegistered++;
+                }
+            }
+        }
+        return { functions: functionsRegistered, schema: schemaApplied };
+    }
+    catch (err) {
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "error",
+            kind: "system",
+            message: "[runtime-loader] failed to load runtime",
+            context: {
+                error: err instanceof Error ? err.message : String(err),
+                stack: err instanceof Error ? err.stack : undefined,
+            },
+        });
+        console.error("[runtime-loader] Detailed error:", err);
+        return { functions: 0, schema: false };
+    }
+}
+/**
+ * Writes the persisted deployment files to the .archlast-deploy directory, rewriting imports as needed.
+ */
+async function materializeFiles(state, deployDir) {
+    for (const file of state.files) {
+        const filePath = (0, path_1.join)(deployDir, file.filePath);
+        const dir = (0, path_1.dirname)(filePath);
+        await promises_1.default.mkdir(dir, { recursive: true });
+        const code = file.filePath.startsWith("src/")
+            ? rewriteImports(file.code, deployDir)
+            : file.code;
+        await promises_1.default.writeFile(filePath, code, "utf8");
+    }
+}
+/**
+ * Minimal import rewriter to make persisted function files resolvable from the .archlast-deploy folder.
+ */
+function rewriteImports(code, deployDir) {
+    let rewritten = code
+        .replace(/from\s+["']\. {1,2}\/_generated\/server["']/g, 'from "@archlast/server/functions/definition"')
+        .replace(/from\s+["']@archlast\/server\/schema\/definition["']/g, 'from "@archlast/server/schema/definition"');
+    rewritten = rewritten.replace(/from\s+["']\. {1,2}\/((modules|src)\/[^"']+)["']/g, (_match, modulePath) => {
+        const absolutePath = (0, path_1.join)(deployDir, modulePath).replace(/\\/g, "/");
+        return `from "${absolutePath}"`;
+    });
+    return rewritten;
+}
+//# sourceMappingURL=runtime-loader.js.map

package/dist/jobs/runtime-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loader.js","sourceRoot":"","sources":["../../src/jobs/runtime-loader.ts"],"names":[],"mappings":";;;;;AAeA,kCAgGC;AA/GD,+BAAqC;AACrC,oDAA8C;AAE9C,2DAA6B;AAC7B,iEAA2F;AAO3F;;;GAGG;AACI,KAAK,UAAU,WAAW,CAC7B,MAAuB,EACvB,EAAW;IAEX,IAAI,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,sCAAqB,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC1D,MAAM,kBAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAEzC,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,kCAAkC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CACF,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CACzF,CAAC;QACF,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxD,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;oBACzD,2EAA2E;oBAC3E,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;oBAC/D,KAAK,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;oBACzC,kBAAM,CAAC,GAAG,CAAC;wBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;wBACrB,KAAK,EAAE,MAAM;wBACb,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,gDAAgD,MAAM,CAAC,QAAQ,EAAE;qBAC7E,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,kBAAM,CAAC,GAAG,CAAC;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,kDAAkD;oBAC3D,OAAO,EAAE,EAAE,GAAG,EAAE;iBACnB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,OAAO,CAAC,KAAK,CACT,oCAAoC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAChG,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,YAAY,CAAC;YACpE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAEtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CACT,6BAA6B,IAAI,CAAC,QAAQ,oBAAoB,SAAS,EAAE,CAC5E,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC,CAAC;YAEvD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACtC,IAAI,EAAE,EAAE,WAAW,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACvD,MAAM,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAClC,aAAa,GAAG,IAAI,CAAC;gBACzB,CAAC;gBACD,SAAS;YACb,CAAC;YAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;oBAC9E,MAAM,MAAM,GAAG,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC;oBACtC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAY,CAAC,CAAC;oBAC9C,mBAAmB,EAAE,CAAC;gBAC1B,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,kBAAM,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yCAAyC;YAClD,OAAO,EAAE;gBACL,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACtD;SACJ,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,KAAsB,EAAE,SAAiB;IACrE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,kBAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YACzC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEhB,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,SAAiB;IACnD,IAAI,SAAS,GAAG,IAAI;SACf,OAAO,CACJ,8CAA8C,EAC9C,8CAA8C,CACjD;SACA,OAAO,CACJ,uDAAuD,EACvD,2CAA2C,CAC9C,CAAC;IAEN,SAAS,GAAG,SAAS,CAAC,OAAO,CACzB,mDAAmD,EACnD,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;QACnB,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrE,OAAO,SAAS,YAAY,GAAG,CAAC;IACpC,CAAC,CACJ,CAAC;IAEF,OAAO,SAAS,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,33 @@
+import { IpcClient } from "../ipc/socket-bridge.js";
+import { SchedulePreset, ScheduledJob } from "./scheduler.js";
+/**
+ * Client-side scheduler that offloads actual scheduling to the Scheduler process via IPC.
+ * Used by the ExecutionEngine in the main server and worker processes.
+ */
+export declare class SchedulerClient {
+    private ipcClient;
+    constructor(ipcClient: IpcClient | null);
+    /**
+     * Schedule a job by cron expression or preset via IPC.
+     */
+    add(job: ScheduledJob): void;
+    /**
+     * Alias to schedule by functionName.
+     */
+    schedule(config: {
+        functionName: string;
+        payload?: unknown;
+        maxAttempts?: number;
+    } & ({
+        preset: SchedulePreset;
+        cron?: never;
+    } | {
+        cron: string;
+        preset?: never;
+    })): void;
+    /**
+     * Cancel a scheduled job by name.
+     */
+    cancel(name: string): void;
+}
+//# sourceMappingURL=scheduler-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-client.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,SAAS,CAAmB;gBAExB,SAAS,EAAE,SAAS,GAAG,IAAI;IAIvC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,YAAY;IAyBrB;;OAEG;IACH,QAAQ,CACJ,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CACtE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,CACrC;IAeL;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM;CAQtB"}

package/dist/jobs/scheduler-client.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedulerClient = void 0;
+const logger_js_1 = require("../logging/logger.js");
+/**
+ * Client-side scheduler that offloads actual scheduling to the Scheduler process via IPC.
+ * Used by the ExecutionEngine in the main server and worker processes.
+ */
+class SchedulerClient {
+    ipcClient;
+    constructor(ipcClient) {
+        this.ipcClient = ipcClient;
+    }
+    /**
+     * Schedule a job by cron expression or preset via IPC.
+     */
+    add(job) {
+        // We can't validate fully here without dragging in more deps,
+        // but we can pass it along.
+        const payload = {
+            type: "ADD_JOB",
+            name: job.name,
+            cron: "cron" in job ? job.cron : undefined,
+            preset: "preset" in job ? job.preset : undefined,
+            payload: job.payload,
+            maxAttempts: job.maxAttempts,
+        };
+        if (this.ipcClient && this.ipcClient.isConnected()) {
+            this.ipcClient.send("SCHEDULE_COMMAND", payload);
+        }
+        else {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "warn",
+                kind: "system",
+                message: "[SchedulerClient] IPC not connected, cannot schedule job:",
+                context: { data: [job.name] },
+            });
+        }
+    }
+    /**
+     * Alias to schedule by functionName.
+     */
+    schedule(config) {
+        const { functionName, payload, cron, preset, maxAttempts } = config;
+        const job = preset !== undefined
+            ? { name: functionName, preset, payload: payload ?? {}, maxAttempts }
+            : {
+                name: functionName,
+                cron: cron ?? "* * * * *",
+                payload: payload ?? {},
+                maxAttempts,
+            };
+        this.add(job);
+    }
+    /**
+     * Cancel a scheduled job by name.
+     */
+    cancel(name) {
+        if (this.ipcClient && this.ipcClient.isConnected()) {
+            this.ipcClient.send("SCHEDULE_COMMAND", {
+                type: "CANCEL_JOB",
+                jobId: name,
+            });
+        }
+    }
+}
+exports.SchedulerClient = SchedulerClient;
+//# sourceMappingURL=scheduler-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-client.js","sourceRoot":"","sources":["../../src/jobs/scheduler-client.ts"],"names":[],"mappings":";;;AACA,oDAA8C;AAI9C;;;GAGG;AACH,MAAa,eAAe;IAChB,SAAS,CAAmB;IAEpC,YAAY,SAA2B;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAiB;QACjB,8DAA8D;QAC9D,4BAA4B;QAC5B,MAAM,OAAO,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC1C,MAAM,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAChD,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;SAC/B,CAAC;QAEF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACJ,kBAAM,CAAC,GAAG,CAAC;gBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,2DAA2D;gBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;aAChC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CACJ,MAGC;QAED,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QACpE,MAAM,GAAG,GACL,MAAM,KAAK,SAAS;YAChB,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,WAAW,EAAE;YACrE,CAAC,CAAC;gBACI,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,IAAI,IAAI,WAAW;gBACzB,OAAO,EAAE,OAAO,IAAI,EAAE;gBACtB,WAAW;aACd,CAAC;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBACpC,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACJ;AApED,0CAoEC"}

package/dist/jobs/scheduler.d.ts

@@ -0,0 +1,73 @@
+import { JobQueue } from "./queue.js";
+export declare enum SchedulePreset {
+    RunNow = "RUN_NOW",
+    EveryMinute = "EVERY_MINUTE",
+    Every5Minutes = "EVERY_5_MINUTES",
+    Every10Minutes = "EVERY_10_MINUTES",
+    Every30Minutes = "EVERY_30_MINUTES",
+    Hourly = "HOURLY",
+    Every8Hours = "EVERY_8_HOURS",
+    Every16Hours = "EVERY_16_HOURS",
+    DailyMidnight = "DAILY_MIDNIGHT",
+    Weekly = "WEEKLY",
+    Monthly = "MONTHLY",
+    Quarterly = "QUARTERLY"
+}
+export declare function intervalToCron(options: {
+    minutes?: number;
+    hours?: number;
+    days?: number;
+    weeks?: number;
+    months?: number;
+    years?: number;
+}): string;
+type ScheduledJobCronConfig = {
+    name: string;
+    cron: string;
+    payload: unknown;
+    maxAttempts?: number;
+};
+type ScheduledJobPresetConfig = {
+    name: string;
+    preset: SchedulePreset;
+    payload: unknown;
+    maxAttempts?: number;
+};
+export type ScheduledJob = ScheduledJobCronConfig | ScheduledJobPresetConfig;
+/**
+ * Public-facing scheduler service type used in generated contexts.
+ */
+export type SchedulerService = Scheduler;
+export declare class Scheduler {
+    private readonly queue;
+    private readonly scheduled;
+    constructor(queue: JobQueue);
+    /**
+     * Schedule a job by cron expression or preset.
+     */
+    add(job: ScheduledJob): void;
+    /**
+     * Alias to schedule by functionName to align with function contexts.
+     */
+    schedule(config: {
+        functionName: string;
+        payload?: unknown;
+        maxAttempts?: number;
+    } & ({
+        preset: SchedulePreset;
+        cron?: never;
+    } | {
+        cron: string;
+        preset?: never;
+    })): void;
+    /**
+     * Cancel a scheduled job by name.
+     */
+    cancel(name: string): void;
+    /**
+     * Stop all scheduled jobs.
+     */
+    stopAll(): void;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/jobs/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,oBAAY,cAAc;IACtB,MAAM,YAAY;IAClB,WAAW,iBAAiB;IAC5B,aAAa,oBAAoB;IACjC,cAAc,qBAAqB;IACnC,cAAc,qBAAqB;IACnC,MAAM,WAAW;IACjB,WAAW,kBAAkB;IAC7B,YAAY,mBAAmB;IAC/B,aAAa,mBAAmB;IAChC,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,SAAS,cAAc;CAC1B;AAiBD,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAyCT;AAED,KAAK,sBAAsB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,sBAAsB,GAAG,wBAAwB,CAAC;AAoC7E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;gBAExD,KAAK,EAAE,QAAQ;IAI3B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,YAAY;IAuErB;;OAEG;IACH,QAAQ,CACJ,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CACtE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,CACrC;IAeL;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM;IAQnB;;OAEG;IACH,OAAO;CAaV"}