@archlast/server 0.0.1

package/dist/jobs/scheduler.js

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scheduler = exports.SchedulePreset = void 0;
+exports.intervalToCron = intervalToCron;
+const logger_js_1 = require("../logging/logger.js");
+var SchedulePreset;
+(function (SchedulePreset) {
+    SchedulePreset["RunNow"] = "RUN_NOW";
+    SchedulePreset["EveryMinute"] = "EVERY_MINUTE";
+    SchedulePreset["Every5Minutes"] = "EVERY_5_MINUTES";
+    SchedulePreset["Every10Minutes"] = "EVERY_10_MINUTES";
+    SchedulePreset["Every30Minutes"] = "EVERY_30_MINUTES";
+    SchedulePreset["Hourly"] = "HOURLY";
+    SchedulePreset["Every8Hours"] = "EVERY_8_HOURS";
+    SchedulePreset["Every16Hours"] = "EVERY_16_HOURS";
+    SchedulePreset["DailyMidnight"] = "DAILY_MIDNIGHT";
+    SchedulePreset["Weekly"] = "WEEKLY";
+    SchedulePreset["Monthly"] = "MONTHLY";
+    SchedulePreset["Quarterly"] = "QUARTERLY";
+})(SchedulePreset || (exports.SchedulePreset = SchedulePreset = {}));
+const PRESET_CRONS = {
+    [SchedulePreset.RunNow]: "",
+    [SchedulePreset.EveryMinute]: "* * * * *",
+    [SchedulePreset.Every5Minutes]: "*/5 * * * *",
+    [SchedulePreset.Every10Minutes]: "*/10 * * * *",
+    [SchedulePreset.Every30Minutes]: "*/30 * * * *",
+    [SchedulePreset.Hourly]: "0 * * * *",
+    [SchedulePreset.Every8Hours]: "0 */8 * * *",
+    [SchedulePreset.Every16Hours]: "0 */16 * * *",
+    [SchedulePreset.DailyMidnight]: "0 0 * * *",
+    [SchedulePreset.Weekly]: "0 0 * * 0",
+    [SchedulePreset.Monthly]: "0 0 1 * *",
+    [SchedulePreset.Quarterly]: "0 0 1 */3 *",
+};
+function intervalToCron(options) {
+    const entries = Object.entries(options).filter(([, value]) => value !== undefined);
+    if (entries.length !== 1) {
+        throw new Error("Provide exactly one interval unit (minutes, hours, days, weeks, months, or years).");
+    }
+    const [unit, raw] = entries[0];
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`Invalid interval for ${unit}: must be a positive integer.`);
+    }
+    switch (unit) {
+        case "minutes":
+            if (value > 59)
+                throw new Error("Minutes interval must be <= 59.");
+            return `*/${value} * * * *`;
+        case "hours":
+            if (value === 24)
+                return "0 0 * * *";
+            if (value > 23)
+                throw new Error("Hours interval must be <= 23 or exactly 24 for daily.");
+            return `0 */${value} * * *`;
+        case "days":
+            if (value > 31)
+                throw new Error("Days interval must be <= 31.");
+            return `0 0 */${value} * *`;
+        case "weeks":
+            if (value !== 1)
+                throw new Error("Only a weekly interval of 1 is supported; use days for custom week multiples.");
+            return "0 0 * * 0";
+        case "months":
+            if (value > 12)
+                throw new Error("Months interval must be <= 12.");
+            return `0 0 1 */${value} *`;
+        case "years":
+            if (value !== 1)
+                throw new Error("Only a yearly interval of 1 is supported.");
+            return "0 0 1 1 *";
+        default:
+            throw new Error(`Unsupported interval unit: ${unit}`);
+    }
+}
+function resolvePreset(preset) {
+    const cron = PRESET_CRONS[preset];
+    if (!cron)
+        throw new Error(`Unknown schedule preset '${preset}'.`);
+    return cron;
+}
+function validateJobConfig(job) {
+    const name = typeof job.name === "string" ? job.name.trim() : "";
+    if (!name)
+        throw new Error("Scheduled job name is required.");
+    const payload = job.payload;
+    const maxAttempts = job.maxAttempts;
+    if ("preset" in job) {
+        if (job.preset === SchedulePreset.RunNow) {
+            return { cron: "", name, payload, maxAttempts, runNow: true };
+        }
+        const cronFromPreset = resolvePreset(job.preset);
+        if (!cronFromPreset)
+            throw new Error("Cron expression is required.");
+        return { cron: cronFromPreset, name, payload, maxAttempts };
+    }
+    const cron = typeof job.cron === "string" ? job.cron.trim() : "";
+    if (!cron)
+        throw new Error("Cron expression is required.");
+    return { cron, name, payload, maxAttempts };
+}
+class Scheduler {
+    queue;
+    scheduled = new Map();
+    constructor(queue) {
+        this.queue = queue;
+    }
+    /**
+     * Schedule a job by cron expression or preset.
+     */
+    add(job) {
+        const { cron, name: key, payload, maxAttempts, runNow } = validateJobConfig(job);
+        if (runNow) {
+            void (async () => {
+                try {
+                    await this.queue.enqueue(key, payload, { maxAttempts });
+                    logger_js_1.logger.log({
+                        timestamp: Date.now(),
+                        level: "info",
+                        kind: "system",
+                        message: "One-off scheduled job enqueued",
+                        context: { name: key, preset: SchedulePreset.RunNow },
+                    });
+                }
+                catch (err) {
+                    logger_js_1.logger.log({
+                        timestamp: Date.now(),
+                        level: "error",
+                        kind: "system",
+                        message: "Failed to enqueue one-off scheduled job",
+                        context: {
+                            name: key,
+                            preset: SchedulePreset.RunNow,
+                            error: err instanceof Error ? err.message : String(err),
+                        },
+                    });
+                }
+            })();
+            return;
+        }
+        const cronParsed = parseCron(cron);
+        const scheduleNext = async () => {
+            const next = nextRun(cronParsed, new Date());
+            const delay = Math.max(0, next.getTime() - Date.now());
+            const handle = setTimeout(async () => {
+                try {
+                    await this.queue.enqueue(key, payload, { maxAttempts });
+                    logger_js_1.logger.log({
+                        timestamp: Date.now(),
+                        level: "info",
+                        kind: "system",
+                        message: "Scheduled job enqueued",
+                        context: { name: key, cron },
+                    });
+                }
+                catch (err) {
+                    logger_js_1.logger.log({
+                        timestamp: Date.now(),
+                        level: "error",
+                        kind: "system",
+                        message: "Failed to enqueue scheduled job",
+                        context: {
+                            name: key,
+                            cron,
+                            error: err instanceof Error ? err.message : String(err),
+                        },
+                    });
+                }
+                finally {
+                    scheduleNext();
+                }
+            }, delay);
+            this.scheduled.set(key, handle);
+        };
+        // Clear existing timer if present
+        this.cancel(key);
+        void scheduleNext();
+    }
+    /**
+     * Alias to schedule by functionName to align with function contexts.
+     */
+    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) {
+        const handle = this.scheduled.get(name);
+        if (handle) {
+            clearTimeout(handle);
+            this.scheduled.delete(name);
+        }
+    }
+    /**
+     * Stop all scheduled jobs.
+     */
+    stopAll() {
+        for (const [name, handle] of this.scheduled.entries()) {
+            clearTimeout(handle);
+            this.scheduled.delete(name);
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Scheduled job cancelled",
+                context: { name },
+            });
+        }
+    }
+}
+exports.Scheduler = Scheduler;
+/**
+ * Minimal cron parser supporting 5 fields: minute hour day month dayOfWeek.
+ * Supports: "*", "star-slash-n" (every n), "a-b", "a,b,c", numbers.
+ */
+function parseCron(expr) {
+    const parts = expr.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error(`Invalid cron expression '${expr}'. Expected 5 fields.`);
+    }
+    const [min, hour, dom, mon, dow] = parts;
+    return [
+        parseField(min, 0, 59),
+        parseField(hour, 0, 23),
+        parseField(dom, 1, 31),
+        parseField(mon, 1, 12),
+        parseField(dow, 0, 6),
+    ];
+}
+function parseField(field, min, max) {
+    const set = new Set();
+    const applyRange = (start, end, step = 1) => {
+        for (let v = start; v <= end; v += step)
+            set.add(v);
+    };
+    if (field === "*") {
+        applyRange(min, max);
+        return set;
+    }
+    const segments = field.split(",");
+    for (const seg of segments) {
+        if (seg.includes("/")) {
+            const [rangePart, stepPart] = seg.split("/");
+            const step = Number(stepPart);
+            if (!Number.isInteger(step) || step <= 0)
+                throw new Error(`Invalid step '${seg}'`);
+            if (rangePart === "*") {
+                applyRange(min, max, step);
+            }
+            else if (rangePart.includes("-")) {
+                const [a, b] = rangePart.split("-").map(Number);
+                applyRange(a, b, step);
+            }
+            else {
+                const base = Number(rangePart);
+                applyRange(base, max, step);
+            }
+        }
+        else if (seg.includes("-")) {
+            const [a, b] = seg.split("-").map(Number);
+            applyRange(a, b);
+        }
+        else {
+            const v = Number(seg);
+            if (Number.isNaN(v))
+                throw new Error(`Invalid cron token '${seg}'`);
+            set.add(v);
+        }
+    }
+    return set;
+}
+function nextRun(parsed, from) {
+    const [mins, hours, doms, mons, dows] = parsed;
+    let dt = new Date(from.getTime() + 60 * 1000); // start at next minute
+    dt.setSeconds(0, 0);
+    while (true) {
+        if (mons.has(dt.getMonth() + 1) &&
+            doms.has(dt.getDate()) &&
+            dows.has(dt.getDay()) &&
+            hours.has(dt.getHours()) &&
+            mins.has(dt.getMinutes())) {
+            return dt;
+        }
+        dt = new Date(dt.getTime() + 60 * 1000); // advance 1 minute
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/jobs/scheduler.js.map

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

package/dist/jobs/worker-thread.d.ts

@@ -0,0 +1,27 @@
+type WorkerResponse = {
+    kind: "result";
+    jobId: string;
+    ok: true;
+    result?: any;
+    affectedQueries?: string[];
+    affectedKeys?: string[];
+} | {
+    kind: "result";
+    jobId: string;
+    ok: false;
+    error: string;
+};
+export declare class WorkerPool {
+    private readonly pool;
+    private readonly queue;
+    private readonly workerUrl;
+    constructor(size: number);
+    run(jobId: string, name: string, payload: any): Promise<WorkerResponse>;
+    dispose(): void;
+    private spawn;
+    private inflight;
+    private drain;
+    private markIdle;
+}
+export {};
+//# sourceMappingURL=worker-thread.d.ts.map

package/dist/jobs/worker-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-thread.d.ts","sourceRoot":"","sources":["../../src/jobs/worker-thread.ts"],"names":[],"mappings":"AAgCA,KAAK,cAAc,GACb;IACI,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GACD;IACI,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAmFR,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,MAAM;IAQlB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7E,OAAO;IAUP,OAAO,CAAC,KAAK;IA6Bb,OAAO,CAAC,QAAQ,CAA8C;IAE9D,OAAO,CAAC,KAAK;IAoBb,OAAO,CAAC,QAAQ;CAKnB"}

package/dist/jobs/worker-thread.js

@@ -0,0 +1,173 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerPool = void 0;
+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 runner_js_1 = require("../engine/runner.js");
+const runtime_loader_js_1 = require("./runtime-loader.js");
+const logger_js_1 = require("../logging/logger.js");
+const manager_js_1 = require("../storage/manager.js");
+const fs_backend_js_1 = __importDefault(require("../storage/fs-backend.js"));
+const s3_backend_js_1 = __importDefault(require("../storage/s3-backend.js"));
+const paths_js_1 = require("../config/paths.js");
+const index_js_1 = require("../config/index.js");
+const queue_js_1 = require("./queue.js");
+const config = (0, index_js_1.loadServerConfig)();
+(0, paths_js_1.ensureAllDbDirectories)(config.paths);
+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 isWorkerThread = !Bun.isMainThread;
+/* ---------------------- Worker-side implementation ---------------------- */
+async function workerMain() {
+    let engine = null;
+    const bootstrap = async () => {
+        if (engine)
+            return engine;
+        // 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);
+        const storageManager = new manager_js_1.StorageManager({
+            backend: storageBackend,
+            db,
+            stagingDir: config.paths.storageStagingDir,
+            logger: logger_js_1.logger,
+        });
+        const jobQueue = new queue_js_1.JobQueue({ db });
+        const graph = new graph_js_1.DependencyGraph();
+        engine = new runner_js_1.ExecutionEngine(db, graph, storageManager, jobQueue, null, null);
+        await (0, runtime_loader_js_1.loadRuntime)(engine, db);
+        return engine;
+    };
+    self.onmessage = async (evt) => {
+        const msg = evt.data;
+        if (!msg)
+            return;
+        if (msg.kind !== "exec")
+            return;
+        try {
+            const engineInstance = await bootstrap();
+            const auth = { userId: (msg.payload && msg.payload.__authUserId) ?? null };
+            const result = await engineInstance.runFunction(msg.name, msg.payload, auth);
+            const affectedQueries = result?.affectedQueries
+                ? Array.from(result.affectedQueries)
+                : undefined;
+            const affectedKeys = result?.affectedKeys
+                ? Array.from(result.affectedKeys)
+                : undefined;
+            self.postMessage({
+                kind: "result",
+                jobId: msg.jobId,
+                ok: true,
+                result,
+                affectedQueries,
+                affectedKeys,
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            self.postMessage({
+                kind: "result",
+                jobId: msg.jobId,
+                ok: false,
+                error,
+            });
+        }
+    };
+}
+if (isWorkerThread) {
+    void workerMain();
+}
+/* ---------------------- Main-thread pool ---------------------- */
+class WorkerPool {
+    pool = [];
+    queue = [];
+    workerUrl;
+    constructor(size) {
+        this.workerUrl = "./src/jobs/worker-thread.ts";
+        const count = Math.max(1, size);
+        for (let i = 0; i < count; i++) {
+            this.pool.push({ worker: this.spawn(), busy: false });
+        }
+    }
+    async run(jobId, name, payload) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ jobId, name, payload, resolve, reject });
+            this.drain();
+        });
+    }
+    dispose() {
+        for (const h of this.pool) {
+            try {
+                h.worker.terminate();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    spawn() {
+        const worker = new Worker(this.workerUrl, { ref: false });
+        worker.onmessage = (evt) => {
+            const res = evt.data;
+            // Find the promise resolver by matching jobId in the queue of in-flight jobs handled via closure.
+            const pendingIndex = this.inflight.findIndex((p) => p.jobId === res.jobId);
+            if (pendingIndex >= 0) {
+                const pending = this.inflight[pendingIndex];
+                this.inflight.splice(pendingIndex, 1);
+                pending.resolve(res);
+            }
+            this.markIdle(worker);
+        };
+        worker.onerror = async (err) => {
+            logger_js_1.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: "Worker thread error",
+                context: { error: err.message },
+            });
+            this.markIdle(worker);
+        };
+        worker.onmessageerror = () => {
+            this.markIdle(worker);
+        };
+        return worker;
+    }
+    inflight = [];
+    drain() {
+        for (const handle of this.pool) {
+            if (this.queue.length === 0)
+                break;
+            if (handle.busy)
+                continue;
+            const job = this.queue.shift();
+            if (!job)
+                break;
+            handle.busy = true;
+            const msg = {
+                kind: "exec",
+                jobId: job.jobId,
+                name: job.name,
+                payload: job.payload,
+            };
+            this.inflight.push({ ...job, worker: handle.worker });
+            handle.worker.postMessage(msg);
+        }
+    }
+    markIdle(worker) {
+        const handle = this.pool.find((h) => h.worker === worker);
+        if (handle)
+            handle.busy = false;
+        this.drain();
+    }
+}
+exports.WorkerPool = WorkerPool;
+//# sourceMappingURL=worker-thread.js.map

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

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

package/dist/jobs/worker.d.ts

@@ -0,0 +1,30 @@
+import { JobQueue } from "./queue.js";
+import type { IpcClient } from "../ipc/socket-bridge.js";
+type JobHandler<Payload = any> = (payload: Payload) => Promise<void | {
+    affectedQueries?: Set<string> | string[];
+    affectedKeys?: Set<string> | string[];
+}>;
+/**
+ * Register job handlers here. Example:
+ * {
+ *   sendEmail: async (payload) => { ... },
+ *   generateReport: async (payload) => { ... },
+ * }
+ */
+export declare const handlers: Record<string, JobHandler<any>>;
+export declare function registerHandler<Payload = any>(name: string, handler: JobHandler<Payload>): void;
+export declare function removeHandler(name: string): void;
+export declare function getHandlers(): Record<string, JobHandler<any>>;
+export declare function setEngineDispatcher(dispatcher: {
+    runFunction: (name: string, payload: any, auth: any, queryId?: string) => Promise<any>;
+}): void;
+/**
+ * Initialize the worker with a job queue.
+ * Must be called before start().
+ */
+export declare function initWorker(jobQueue: JobQueue, ipcClient?: IpcClient): void;
+/** Entrypoint */
+declare function main(): Promise<void>;
+export declare const start: typeof main;
+export type { JobHandler };
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,KAAK,UAAU,CAAC,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,GAAG;IAClE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAM,CAAC;AAE5D,wBAAgB,eAAe,CAAC,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,QAExF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,QAEzC;AAED,wBAAgB,WAAW,oCAE1B;AAMD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE;IAC5C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC1F,QAEA;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,SAAS,QAGnE;AAgOD,iBAAiB;AACjB,iBAAe,IAAI,kBAsBlB;AAED,eAAO,MAAM,KAAK,aAAO,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,CAAC"}