@portel/photon 1.23.1 → 1.25.0

package/dist/daemon/cron.js

@@ -0,0 +1,216 @@
+/**
+ * Cron parser and scheduling helpers.
+ *
+ * Five-field POSIX-style cron (minute hour day-of-month month day-of-week).
+ * Supports wildcards (*), lists (a,b,c), ranges (a-b), steps (*\/n), and
+ * Sunday-as-7 normalization. Minute granularity only.
+ *
+ * Extracted from daemon/server.ts so it can be shared with the boot loader
+ * and exercised by focused tests.
+ */
+export function parseCronField(field, min, max) {
+    if (field === '*') {
+        const values = [];
+        for (let i = min; i <= max; i++)
+            values.push(i);
+        return values;
+    }
+    // Comma-separated list
+    if (field.includes(',')) {
+        const values = new Set();
+        for (const part of field.split(',')) {
+            const partValues = parseCronField(part, min, max);
+            if (!partValues)
+                return null;
+            partValues.forEach((v) => values.add(v));
+        }
+        return Array.from(values).sort((a, b) => a - b);
+    }
+    // Step values: */n, start/n, start-end/n
+    if (field.includes('/')) {
+        const slashIdx = field.indexOf('/');
+        const range = field.slice(0, slashIdx);
+        const step = parseInt(field.slice(slashIdx + 1));
+        if (isNaN(step) || step <= 0)
+            return null;
+        let start = min;
+        let end = max;
+        if (range !== '*') {
+            if (range.includes('-')) {
+                const [s, e] = range.split('-').map(Number);
+                if (isNaN(s) || isNaN(e))
+                    return null;
+                start = s;
+                end = e;
+            }
+            else {
+                start = parseInt(range);
+                if (isNaN(start))
+                    return null;
+            }
+        }
+        const values = [];
+        for (let i = start; i <= end; i += step)
+            values.push(i);
+        return values;
+    }
+    // Range: n-m
+    if (field.includes('-')) {
+        const [s, e] = field.split('-').map(Number);
+        if (isNaN(s) || isNaN(e) || s < min || e > max)
+            return null;
+        const values = [];
+        for (let i = s; i <= e; i++)
+            values.push(i);
+        return values;
+    }
+    // Single value
+    const value = parseInt(field);
+    if (isNaN(value) || value < min || value > max)
+        return null;
+    return [value];
+}
+function parse(cron) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return null;
+    const [minuteField, hourField, domField, monthField, dowField] = parts;
+    const minutes = parseCronField(minuteField, 0, 59);
+    const hours = parseCronField(hourField, 0, 23);
+    const doms = parseCronField(domField, 1, 31);
+    const months = parseCronField(monthField, 1, 12);
+    const dows = parseCronField(dowField, 0, 7);
+    if (!minutes || !hours || !doms || !months || !dows)
+        return null;
+    return {
+        minuteSet: new Set(minutes),
+        hourSet: new Set(hours),
+        domSet: new Set(doms),
+        monthSet: new Set(months),
+        // Normalize: 7 maps to 0 (both mean Sunday)
+        dowSet: new Set(dows.map((d) => (d === 7 ? 0 : d))),
+        domIsWild: domField === '*',
+        dowIsWild: dowField === '*',
+    };
+}
+function matches(parsed, date) {
+    if (!parsed.monthSet.has(date.getMonth() + 1))
+        return false;
+    let dayMatch;
+    if (parsed.domIsWild && parsed.dowIsWild)
+        dayMatch = true;
+    else if (parsed.domIsWild)
+        dayMatch = parsed.dowSet.has(date.getDay());
+    else if (parsed.dowIsWild)
+        dayMatch = parsed.domSet.has(date.getDate());
+    else
+        dayMatch = parsed.domSet.has(date.getDate()) || parsed.dowSet.has(date.getDay());
+    if (!dayMatch)
+        return false;
+    if (!parsed.hourSet.has(date.getHours()))
+        return false;
+    return parsed.minuteSet.has(date.getMinutes());
+}
+/**
+ * Compute the next cron occurrence strictly after `fromTime` (defaults to
+ * now). Returns `{isValid: false, nextRun: 0}` on malformed cron or if no
+ * occurrence is found within four years.
+ */
+export function parseCron(cron, fromTime) {
+    const parsed = parse(cron);
+    if (!parsed)
+        return { isValid: false, nextRun: 0 };
+    const base = fromTime !== undefined ? new Date(fromTime) : new Date();
+    const candidate = new Date(base);
+    candidate.setSeconds(0);
+    candidate.setMilliseconds(0);
+    candidate.setMinutes(candidate.getMinutes() + 1);
+    const limit = new Date(candidate);
+    limit.setFullYear(limit.getFullYear() + 4);
+    while (candidate < limit) {
+        if (!parsed.monthSet.has(candidate.getMonth() + 1)) {
+            candidate.setMonth(candidate.getMonth() + 1);
+            candidate.setDate(1);
+            candidate.setHours(0);
+            candidate.setMinutes(0);
+            continue;
+        }
+        let dayMatch;
+        if (parsed.domIsWild && parsed.dowIsWild)
+            dayMatch = true;
+        else if (parsed.domIsWild)
+            dayMatch = parsed.dowSet.has(candidate.getDay());
+        else if (parsed.dowIsWild)
+            dayMatch = parsed.domSet.has(candidate.getDate());
+        else
+            dayMatch = parsed.domSet.has(candidate.getDate()) || parsed.dowSet.has(candidate.getDay());
+        if (!dayMatch) {
+            candidate.setDate(candidate.getDate() + 1);
+            candidate.setHours(0);
+            candidate.setMinutes(0);
+            continue;
+        }
+        if (!parsed.hourSet.has(candidate.getHours())) {
+            const nextHour = [...parsed.hourSet].find((h) => h > candidate.getHours());
+            if (nextHour !== undefined) {
+                candidate.setHours(nextHour);
+                candidate.setMinutes(0);
+            }
+            else {
+                candidate.setDate(candidate.getDate() + 1);
+                candidate.setHours(0);
+                candidate.setMinutes(0);
+            }
+            continue;
+        }
+        if (!parsed.minuteSet.has(candidate.getMinutes())) {
+            const nextMinute = [...parsed.minuteSet].find((m) => m > candidate.getMinutes());
+            if (nextMinute !== undefined) {
+                candidate.setMinutes(nextMinute);
+            }
+            else {
+                candidate.setHours(candidate.getHours() + 1);
+                candidate.setMinutes(0);
+            }
+            continue;
+        }
+        return { isValid: true, nextRun: candidate.getTime() };
+    }
+    return { isValid: false, nextRun: 0 };
+}
+/**
+ * Find the most recent cron occurrence strictly after `lastRunAt` and at or
+ * before `now`. Returns `null` if no occurrence fits the window, the cron is
+ * malformed, or `lastRunAt` is not in the past.
+ *
+ * Used at daemon boot: if a schedule was supposed to fire while the daemon
+ * was down, this identifies the most recent missed occurrence so the caller
+ * can trigger one catch-up run. Older missed occurrences are intentionally
+ * dropped to avoid a flood of invocations after a long outage.
+ *
+ * Complexity: iterates backward minute-by-minute from `now` to `lastRunAt`,
+ * bounded at 14 days. For typical schedules the first matching minute is
+ * found within a few hundred iterations.
+ */
+export function computeMissedRun(cron, lastRunAt, now) {
+    if (!Number.isFinite(lastRunAt) || lastRunAt <= 0 || lastRunAt >= now)
+        return null;
+    const parsed = parse(cron);
+    if (!parsed)
+        return null;
+    const FOURTEEN_DAYS_MINUTES = 14 * 24 * 60;
+    const windowMinutes = Math.ceil((now - lastRunAt) / 60_000) + 1;
+    const maxIter = Math.min(windowMinutes, FOURTEEN_DAYS_MINUTES);
+    const candidate = new Date(now);
+    candidate.setSeconds(0);
+    candidate.setMilliseconds(0);
+    for (let i = 0; i < maxIter; i++) {
+        if (candidate.getTime() <= lastRunAt)
+            return null;
+        if (matches(parsed, candidate))
+            return candidate.getTime();
+        candidate.setMinutes(candidate.getMinutes() - 1);
+    }
+    return null;
+}
+//# sourceMappingURL=cron.js.map

package/dist/daemon/cron.js.map

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

package/dist/daemon/schedule-loader.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Boot-time persisted-schedule loader.
+ *
+ * Extracted from server.ts so the logic can be imported by tests
+ * without triggering the daemon's bootstrap IIFE. The loader handles
+ * BOTH on-disk formats:
+ *
+ *   - IPC (`source: 'ipc'`): written by `photon ps enable` and similar
+ *     CLI hooks. Carries `photonName`, `args`, and `workingDir` on the
+ *     task itself. TTL-swept after 30 days of inactivity.
+ *   - ScheduleProvider: written by `this.schedule.create()` at runtime
+ *     from photon code. Carries `params` (mapped to args) and `status`.
+ *     The photon name is inferred from the directory path and passed
+ *     in as `photonNameHint`. NOT TTL-swept — lifecycle is owned by
+ *     the photon that created it.
+ *
+ * Before this unification, the boot scanner only handled IPC and every
+ * ScheduleProvider file was silently skipped (`source !== 'ipc'`). That
+ * caused schedules to stay dormant across daemon restarts until the
+ * owning photon happened to be invoked and triggered the lazy
+ * `autoRegisterFromMetadata` path.
+ */
+export interface PersistedScheduleJob {
+    id: string;
+    method: string;
+    args: Record<string, unknown>;
+    cron: string;
+    runCount: number;
+    createdAt: number;
+    createdBy: string;
+    photonName: string;
+    workingDir?: string;
+    photonPath?: string;
+    /**
+     * Absolute path of the backing JSON file this job was loaded from.
+     * The fire handler uses it to drop phantom registrations whose
+     * backing file has been unlinked (e.g. via
+     * `this.schedule.cancel()`) out from under the in-memory cron map.
+     */
+    sourceFile?: string;
+    /**
+     * Epoch-ms of the last successful execution, read from the persisted
+     * `lastExecutionAt` field. Used by the daemon boot path to detect fire
+     * windows that elapsed while the daemon was down and schedule one
+     * catch-up run for the most recent missed occurrence.
+     */
+    lastRun?: number;
+}
+export interface LoadScheduleCallbacks {
+    /** Called for every valid job. Return `true` if the engine accepted it. */
+    register: (job: PersistedScheduleJob) => boolean;
+    /** True if the given job id is already known to the cron engine. */
+    alreadyRegistered: (jobId: string) => boolean;
+    /** Optional logger hooks — no-op by default. */
+    warn?: (msg: string, ctx?: Record<string, unknown>) => void;
+    info?: (msg: string, ctx?: Record<string, unknown>) => void;
+}
+/**
+ * Scan one directory of schedule JSON files and hand every valid job
+ * to `cb.register`. Returns counts of loaded + skipped for logging.
+ *
+ * @param schedulesPath Directory containing {taskId}.json files.
+ * @param ttlMs Age in ms above which untouched IPC jobs are deleted.
+ *              ScheduleProvider jobs ignore TTL (photon owns them).
+ * @param photonNameHint Used when task doesn't carry its own
+ *                       `photonName` (ScheduleProvider case — photon
+ *                       name is the parent directory's basename).
+ * @param workingDirHint Fallback working dir when task lacks one
+ *                       (the base dir that owns this schedule tree).
+ * @param cb Engine hooks.
+ */
+export declare function loadPersistedSchedulesFromDir(schedulesPath: string, ttlMs: number, photonNameHint: string | null, workingDirHint: string | undefined, cb: LoadScheduleCallbacks): {
+    loaded: number;
+    skipped: number;
+};
+//# sourceMappingURL=schedule-loader.d.ts.map

package/dist/daemon/schedule-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-loader.d.ts","sourceRoot":"","sources":["../../src/daemon/schedule-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC;IACjD,oEAAoE;IACpE,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,gDAAgD;IAChD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,EAAE,EAAE,qBAAqB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAyFrC"}

package/dist/daemon/schedule-loader.js

@@ -0,0 +1,124 @@
+/**
+ * Boot-time persisted-schedule loader.
+ *
+ * Extracted from server.ts so the logic can be imported by tests
+ * without triggering the daemon's bootstrap IIFE. The loader handles
+ * BOTH on-disk formats:
+ *
+ *   - IPC (`source: 'ipc'`): written by `photon ps enable` and similar
+ *     CLI hooks. Carries `photonName`, `args`, and `workingDir` on the
+ *     task itself. TTL-swept after 30 days of inactivity.
+ *   - ScheduleProvider: written by `this.schedule.create()` at runtime
+ *     from photon code. Carries `params` (mapped to args) and `status`.
+ *     The photon name is inferred from the directory path and passed
+ *     in as `photonNameHint`. NOT TTL-swept — lifecycle is owned by
+ *     the photon that created it.
+ *
+ * Before this unification, the boot scanner only handled IPC and every
+ * ScheduleProvider file was silently skipped (`source !== 'ipc'`). That
+ * caused schedules to stay dormant across daemon restarts until the
+ * owning photon happened to be invoked and triggered the lazy
+ * `autoRegisterFromMetadata` path.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Scan one directory of schedule JSON files and hand every valid job
+ * to `cb.register`. Returns counts of loaded + skipped for logging.
+ *
+ * @param schedulesPath Directory containing {taskId}.json files.
+ * @param ttlMs Age in ms above which untouched IPC jobs are deleted.
+ *              ScheduleProvider jobs ignore TTL (photon owns them).
+ * @param photonNameHint Used when task doesn't carry its own
+ *                       `photonName` (ScheduleProvider case — photon
+ *                       name is the parent directory's basename).
+ * @param workingDirHint Fallback working dir when task lacks one
+ *                       (the base dir that owns this schedule tree).
+ * @param cb Engine hooks.
+ */
+export function loadPersistedSchedulesFromDir(schedulesPath, ttlMs, photonNameHint, workingDirHint, cb) {
+    let loaded = 0;
+    let skipped = 0;
+    let files;
+    try {
+        files = fs.readdirSync(schedulesPath).filter((f) => f.endsWith('.json'));
+    }
+    catch {
+        return { loaded, skipped };
+    }
+    for (const file of files) {
+        const filePath = path.join(schedulesPath, file);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const task = JSON.parse(content);
+            const isIpc = task.source === 'ipc';
+            const photonName = task.photonName || photonNameHint;
+            if (!task.id || !task.method || !task.cron || !photonName) {
+                cb.warn?.('Skipping invalid persisted schedule', { file: filePath });
+                skipped++;
+                continue;
+            }
+            // Respect explicit pause/complete from ScheduleProvider tasks.
+            if (!isIpc && task.status && task.status !== 'active') {
+                skipped++;
+                continue;
+            }
+            // TTL applies only to IPC jobs — ScheduleProvider files are owned
+            // by the photon that created them and must persist until that
+            // photon removes them.
+            const lastExec = task.lastExecutionAt ? new Date(task.lastExecutionAt).getTime() : 0;
+            const created = task.createdAt ? new Date(task.createdAt).getTime() : 0;
+            const lastActivity = Math.max(lastExec, created);
+            if (isIpc && lastActivity > 0 && Date.now() - lastActivity > ttlMs) {
+                cb.info?.('Removing expired schedule (TTL)', {
+                    jobId: task.id,
+                    lastActivity: new Date(lastActivity).toISOString(),
+                });
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch {
+                    /* ignore */
+                }
+                skipped++;
+                continue;
+            }
+            // ScheduleProvider ids are namespaced so they can't collide with
+            // raw IPC ids, and they read `params` where IPC reads `args`.
+            const jobId = isIpc ? task.id : `${photonName}:sched:${task.id}`;
+            const jobArgs = isIpc ? task.args || {} : task.params || {};
+            const jobWorkingDir = task.workingDir || workingDirHint;
+            if (cb.alreadyRegistered(jobId))
+                continue;
+            const job = {
+                id: jobId,
+                method: task.method,
+                args: jobArgs,
+                cron: task.cron,
+                runCount: task.executionCount || 0,
+                createdAt: created || Date.now(),
+                createdBy: task.createdBy || (isIpc ? 'ipc' : 'schedule-provider'),
+                photonName,
+                workingDir: jobWorkingDir,
+                sourceFile: filePath,
+                lastRun: lastExec > 0 ? lastExec : undefined,
+            };
+            if (cb.register(job)) {
+                loaded++;
+            }
+            else {
+                cb.warn?.('Failed to schedule persisted job (invalid cron?)', { jobId });
+                skipped++;
+            }
+        }
+        catch (err) {
+            cb.warn?.('Failed to load persisted schedule file', {
+                file: filePath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            skipped++;
+        }
+    }
+    return { loaded, skipped };
+}
+//# sourceMappingURL=schedule-loader.js.map

package/dist/daemon/schedule-loader.js.map

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