@hasna/loops 0.1.0

package/dist/lib/executor.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutorResult, Loop, LoopRun } from "../types.js";
+export interface ExecuteOptions {
+    maxOutputBytes?: number;
+    env?: NodeJS.ProcessEnv;
+    log?: (message: string) => void;
+}
+export declare function executeLoop(loop: Loop, run: LoopRun, opts?: ExecuteOptions): Promise<ExecutorResult>;

package/dist/lib/format.d.ts

@@ -0,0 +1,4 @@
+import type { Loop, LoopRun } from "../types.js";
+export declare function redact(value: string | undefined, visible?: number): string | undefined;
+export declare function publicLoop(loop: Loop): Record<string, unknown>;
+export declare function publicRun(run: LoopRun, showOutput?: boolean): Record<string, unknown>;

package/dist/lib/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function genId(length?: number): string;
+export declare function nowIso(): string;

package/dist/lib/paths.d.ts

@@ -0,0 +1,7 @@
+export declare function dataDir(): string;
+export declare function ensureDataDir(): string;
+export declare function dbPath(): string;
+export declare function pidFilePath(): string;
+export declare function daemonLogPath(): string;
+export declare function systemdServicePath(): string;
+export declare function launchdPlistPath(): string;

package/dist/lib/schedule.d.ts

@@ -0,0 +1,21 @@
+import type { Loop, ScheduleSpec } from "../types.js";
+interface ParsedCron {
+    minute: Set<number>;
+    hour: Set<number>;
+    dom: Set<number>;
+    month: Set<number>;
+    dow: Set<number>;
+    domRestricted: boolean;
+    dowRestricted: boolean;
+}
+export declare function parseCron(expr: string): ParsedCron;
+export declare function nextCronRun(expr: string, from: Date): Date;
+export declare function initialNextRun(schedule: ScheduleSpec, from?: Date): string;
+export declare function computeNextAfter(schedule: ScheduleSpec, scheduledFor: Date, finishedAt: Date): string | undefined;
+export interface DuePlan {
+    slots: string[];
+    skippedToNextRunAt?: string;
+}
+export declare function dueSlots(loop: Loop, now: Date): DuePlan;
+export declare function parseDuration(input: string): number;
+export {};

package/dist/lib/scheduler.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutorResult, Loop, LoopRun } from "../types.js";
+import type { Store } from "./store.js";
+export interface SchedulerDeps {
+    store: Store;
+    runnerId: string;
+    now?: () => Date;
+    execute?: (loop: Loop, run: LoopRun) => Promise<ExecutorResult>;
+    onError?: (loop: Loop, error: unknown) => void;
+    onRun?: (run: LoopRun) => void;
+}
+export interface TickResult {
+    claimed: LoopRun[];
+    completed: LoopRun[];
+    skipped: LoopRun[];
+    recovered: LoopRun[];
+    expired: Loop[];
+}
+export declare function tick(deps: SchedulerDeps): Promise<TickResult>;

package/dist/lib/store.d.ts

@@ -0,0 +1,56 @@
+import type { CreateLoopInput, Loop, LoopRun, LoopStatus, RunStatus } from "../types.js";
+export interface DaemonLease {
+    id: string;
+    pid: number;
+    hostname: string;
+    heartbeatAt: string;
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ClaimRunResult {
+    run: LoopRun;
+    loop: Loop;
+}
+export declare class Store {
+    private db;
+    constructor(path?: string);
+    private migrate;
+    createLoop(input: CreateLoopInput, from?: Date): Loop;
+    getLoop(id: string): Loop | undefined;
+    findLoopByName(name: string): Loop | undefined;
+    requireLoop(idOrName: string): Loop;
+    listLoops(opts?: {
+        status?: LoopStatus;
+        limit?: number;
+    }): Loop[];
+    dueLoops(now: Date): Loop[];
+    updateLoop(id: string, patch: Partial<Pick<Loop, "status" | "nextRunAt" | "retryScheduledFor" | "expiresAt">>): Loop;
+    deleteLoop(idOrName: string): boolean;
+    hasRunningRun(loopId: string): boolean;
+    createSkippedRun(loop: Loop, scheduledFor: string, reason: string): LoopRun;
+    getRun(id: string): LoopRun | undefined;
+    getRunBySlot(loopId: string, scheduledFor: string): LoopRun | undefined;
+    claimRun(loop: Loop, scheduledFor: string, runnerId: string, now?: Date): ClaimRunResult | undefined;
+    finalizeRun(id: string, patch: Pick<LoopRun, "status" | "finishedAt" | "durationMs" | "stdout" | "stderr"> & Partial<Pick<LoopRun, "exitCode" | "error" | "pid">>): LoopRun;
+    listRuns(opts?: {
+        loopId?: string;
+        status?: RunStatus;
+        limit?: number;
+    }): LoopRun[];
+    recoverExpiredRunLeases(now?: Date): LoopRun[];
+    expireLoops(now?: Date): Loop[];
+    countLoops(status?: LoopStatus): number;
+    countRuns(status?: RunStatus): number;
+    acquireDaemonLease(input: {
+        id: string;
+        pid: number;
+        hostname: string;
+        ttlMs: number;
+        now?: Date;
+    }): DaemonLease | undefined;
+    heartbeatDaemonLease(id: string, ttlMs: number, now?: Date): DaemonLease | undefined;
+    releaseDaemonLease(id: string): void;
+    getDaemonLease(): DaemonLease | undefined;
+    close(): void;
+}