anbaric-state-machine 1.23.2 → 1.24.0

package/dist/index.d.ts

@@ -11,6 +11,10 @@ export * from "./scheduling/InMemoryQueue.js";
 export * from "./scheduling/PullConsumer.js";
 export * from "./scheduling/ConsumerFactory.js";
 export * from "./scheduling/QueueFactory.js";
+export * from "./scheduling/Schedule.js";
+export * from "./scheduling/JobRunScheduler.js";
+export * from "./scheduling/InMemoryJobRunSchedulePersistence.js";
+export * from "./scheduling/JobRunSchedulePersistenceFactory.js";
 export * from "./sessions/InMemorySessionResolver.js";
 export * from "./sessions/SessionResolverFactory.js";
 export * from "./sessions/sessionCookie.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,kDAAkD,CAAC;AACjE,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -11,6 +11,10 @@ export * from "./scheduling/InMemoryQueue.js";
 export * from "./scheduling/PullConsumer.js";
 export * from "./scheduling/ConsumerFactory.js";
 export * from "./scheduling/QueueFactory.js";
+export * from "./scheduling/Schedule.js";
+export * from "./scheduling/JobRunScheduler.js";
+export * from "./scheduling/InMemoryJobRunSchedulePersistence.js";
+export * from "./scheduling/JobRunSchedulePersistenceFactory.js";
 export * from "./sessions/InMemorySessionResolver.js";
 export * from "./sessions/SessionResolverFactory.js";
 export * from "./sessions/sessionCookie.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,kDAAkD,CAAC;AACjE,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC"}

package/dist/scheduling/InMemoryJobRunSchedulePersistence.d.ts

@@ -0,0 +1,10 @@
+import { JobRunSchedulePersistence, ScheduledRun } from "anbaric-tsapi";
+declare class InMemoryJobRunSchedulePersistence implements JobRunSchedulePersistence {
+    private runs;
+    highWaterMark(appId: string, workflowId: string): Promise<Date | undefined>;
+    plan(runs: Array<ScheduledRun>): Promise<void>;
+    claimDue(at: Date): Promise<Array<ScheduledRun>>;
+    private alreadyPlanned;
+}
+export { InMemoryJobRunSchedulePersistence };
+//# sourceMappingURL=InMemoryJobRunSchedulePersistence.d.ts.map

package/dist/scheduling/InMemoryJobRunSchedulePersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryJobRunSchedulePersistence.d.ts","sourceRoot":"","sources":["../../src/scheduling/InMemoryJobRunSchedulePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AAItE,cAAM,iCAAkC,YAAW,yBAAyB;IAExE,OAAO,CAAC,IAAI,CAA0B;IAEhC,aAAa,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAKnF;IAEK,IAAI,CAAC,IAAI,EAAG,KAAK,CAAC,YAAY,CAAC,GAAI,OAAO,CAAC,IAAI,CAAC,CAKrD;IAEK,QAAQ,CAAC,EAAE,EAAG,IAAI,GAAI,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAIvD;IAED,OAAO,CAAC,cAAc;CAOzB;AAED,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/dist/scheduling/InMemoryJobRunSchedulePersistence.js

@@ -0,0 +1,29 @@
+class InMemoryJobRunSchedulePersistence {
+    runs = [];
+    async highWaterMark(appId, workflowId) {
+        const times = this.runs
+            .filter(run => run.appId === appId && run.workflowId === workflowId)
+            .map(run => run.runAt.getTime());
+        return times.length === 0 ? undefined : new Date(Math.max(...times));
+    }
+    async plan(runs) {
+        for (const run of runs) {
+            if (this.alreadyPlanned(run))
+                continue;
+            this.runs.push({ ...run, claimed: false });
+        }
+    }
+    async claimDue(at) {
+        const due = this.runs.filter(run => !run.claimed && run.runAt.getTime() <= at.getTime());
+        for (const run of due)
+            run.claimed = true;
+        return due.map(({ appId, workflowId, runAt }) => ({ appId, workflowId, runAt }));
+    }
+    alreadyPlanned(run) {
+        return this.runs.some(planned => planned.appId === run.appId
+            && planned.workflowId === run.workflowId
+            && planned.runAt.getTime() === run.runAt.getTime());
+    }
+}
+export { InMemoryJobRunSchedulePersistence };
+//# sourceMappingURL=InMemoryJobRunSchedulePersistence.js.map

package/dist/scheduling/InMemoryJobRunSchedulePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryJobRunSchedulePersistence.js","sourceRoot":"","sources":["../../src/scheduling/InMemoryJobRunSchedulePersistence.ts"],"names":[],"mappings":"AAIA,MAAM,iCAAiC;IAE3B,IAAI,GAAuB,EAAE,CAAC;IAEtC,KAAK,CAAC,aAAa,CAAC,KAAc,EAAE,UAAmB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI;aAClB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC;aACnE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAA0B;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAS;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACzF,KAAK,MAAM,GAAG,IAAI,GAAG;YAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAEO,cAAc,CAAC,GAAkB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC5B,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;eACxB,OAAO,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU;eACrC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CAEJ;AAED,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/dist/scheduling/JobRunSchedulePersistenceFactory.d.ts

@@ -0,0 +1,6 @@
+import { JobRunSchedulePersistence } from "anbaric-tsapi";
+declare const JobRunSchedulePersistenceFactory: {
+    instance(): JobRunSchedulePersistence;
+};
+export { JobRunSchedulePersistenceFactory };
+//# sourceMappingURL=JobRunSchedulePersistenceFactory.d.ts.map

package/dist/scheduling/JobRunSchedulePersistenceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobRunSchedulePersistenceFactory.d.ts","sourceRoot":"","sources":["../../src/scheduling/JobRunSchedulePersistenceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAAC,MAAM,eAAe,CAAC;AAIxD,QAAA,MAAM,gCAAgC;IAClC,QAAQ,IAAK,yBAAyB;CASzC,CAAA;AAED,OAAO,EAAE,gCAAgC,EAAE,CAAC"}

package/dist/scheduling/JobRunSchedulePersistenceFactory.js

@@ -0,0 +1,15 @@
+import { CloudJobRunSchedulePersistence } from "anbaric-impl-cloud";
+import { InMemoryJobRunSchedulePersistence } from "./InMemoryJobRunSchedulePersistence.js";
+const JobRunSchedulePersistenceFactory = {
+    instance() {
+        switch (process.env.ANBARIC_JOB_RUN_SCHEDULE_PERSISTENCE_TYPE) {
+            case "cloud":
+                return new CloudJobRunSchedulePersistence();
+            case "memory":
+            default:
+                return new InMemoryJobRunSchedulePersistence();
+        }
+    }
+};
+export { JobRunSchedulePersistenceFactory };
+//# sourceMappingURL=JobRunSchedulePersistenceFactory.js.map

package/dist/scheduling/JobRunSchedulePersistenceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobRunSchedulePersistenceFactory.js","sourceRoot":"","sources":["../../src/scheduling/JobRunSchedulePersistenceFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,8BAA8B,EAAC,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAC,iCAAiC,EAAC,MAAM,wCAAwC,CAAC;AAEzF,MAAM,gCAAgC,GAAG;IACrC,QAAQ;QACJ,QAAQ,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE,CAAC;YAC5D,KAAK,OAAO;gBACR,OAAO,IAAI,8BAA8B,EAAE,CAAC;YAChD,KAAK,QAAQ,CAAC;YACd;gBACI,OAAO,IAAI,iCAAiC,EAAE,CAAC;QACvD,CAAC;IACL,CAAC;CACJ,CAAA;AAED,OAAO,EAAE,gCAAgC,EAAE,CAAC"}

package/dist/scheduling/JobRunScheduler.d.ts

@@ -0,0 +1,24 @@
+import { JobRunSchedulePersistence } from "anbaric-tsapi";
+import { StateMachine } from "../StateMachine.js";
+import { Schedule } from "./Schedule.js";
+declare class JobRunScheduler {
+    private persistence;
+    private static singleton?;
+    private machines;
+    private ticker?;
+    private ticking;
+    constructor(persistence?: JobRunSchedulePersistence);
+    static instance(): JobRunScheduler;
+    schedule(machine: StateMachine, at: Schedule, lookaheadMs?: number, randomRunOffsetMs?: [number, number]): void;
+    tick(now?: Date): Promise<void>;
+    cleanUp(): Promise<void>;
+    private start;
+    private tickOnce;
+    private planAhead;
+    private startDue;
+    private withOffset;
+    private propertiesFor;
+    private key;
+}
+export { JobRunScheduler };
+//# sourceMappingURL=JobRunScheduler.d.ts.map

package/dist/scheduling/JobRunScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobRunScheduler.d.ts","sourceRoot":"","sources":["../../src/scheduling/JobRunScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAAe,MAAM,eAAe,CAAC;AACtE,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAuBvC,cAAM,eAAe;IAQL,OAAO,CAAC,WAAW;IAN/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAmB;IAE5C,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAS;IAExB,YAAoB,WAAW,GAAG,yBAAuE,EAAI;IAE7G,MAAM,CAAC,QAAQ,IAAK,eAAe,CAGlC;IAED,QAAQ,CAAC,OAAO,EAAG,YAAY,EAAE,EAAE,EAAG,QAAQ,EAAE,WAAW,GAAG,MAA6B,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAyB,GAAI,IAAI,CAIhK;IAGK,IAAI,CAAC,GAAG,GAAG,IAAiB,GAAI,OAAO,CAAC,IAAI,CAAC,CAGlD;IAEK,OAAO,IAAK,OAAO,CAAC,IAAI,CAAC,CAI9B;IAED,OAAO,CAAC,KAAK;YAOC,QAAQ;YAYR,SAAS;YAkBT,QAAQ;IAWtB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,GAAG;CAId;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/scheduling/JobRunScheduler.js

@@ -0,0 +1,106 @@
+import { JobRunSchedulePersistenceFactory } from "./JobRunSchedulePersistenceFactory.js";
+const TICK_INTERVAL_MS = 1000;
+const DEFAULT_LOOKAHEAD_MS = 1000 * 60 * 60 * 24;
+const DEFAULT_RUN_OFFSET_MS = [0, 1000 * 60 * 2];
+/* Starts jobs on a timetable. Runs are planned ahead of time and stored, so
+   the plan survives a restart and a machine that was down does not silently
+   skip its runs; each tick plans further ahead and starts whatever has come
+   due. Planning and starting are separate on purpose - a run is a record long
+   before it is a job.
+
+   How safely two schedulers can share a plan is the persistence's business:
+   the in-memory one claims within a single process, while the platform-backed
+   one claims atomically, so a deployed app can run several instances and each
+   due run still starts exactly once. */
+class JobRunScheduler {
+    persistence;
+    static singleton;
+    machines = new Map();
+    ticker;
+    ticking = false;
+    constructor(persistence = JobRunSchedulePersistenceFactory.instance()) {
+        this.persistence = persistence;
+    }
+    static instance() {
+        if (!JobRunScheduler.singleton)
+            JobRunScheduler.singleton = new JobRunScheduler();
+        return JobRunScheduler.singleton;
+    }
+    schedule(machine, at, lookaheadMs = DEFAULT_LOOKAHEAD_MS, randomRunOffsetMs = DEFAULT_RUN_OFFSET_MS) {
+        this.machines.set(this.key(machine.getAppId(), machine.workflowId), { machine, schedule: at, lookaheadMs, randomRunOffsetMs });
+        this.start();
+    }
+    // Plans and starts everything owed as at `now`, without waiting for a tick.
+    async tick(now = new Date()) {
+        for (const scheduled of this.machines.values())
+            await this.planAhead(scheduled, now);
+        await this.startDue(now);
+    }
+    async cleanUp() {
+        if (this.ticker)
+            clearInterval(this.ticker);
+        this.ticker = undefined;
+        this.machines.clear();
+    }
+    start() {
+        if (this.ticker)
+            return;
+        this.ticker = setInterval(() => void this.tickOnce(), TICK_INTERVAL_MS);
+        // Scheduling alone should not hold a process open.
+        this.ticker.unref?.();
+    }
+    async tickOnce() {
+        if (this.ticking)
+            return;
+        this.ticking = true;
+        try {
+            await this.tick();
+        }
+        catch {
+            // A failing tick must not kill the timer; the next one retries.
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+    async planAhead(scheduled, now) {
+        const appId = scheduled.machine.getAppId();
+        const workflowId = scheduled.machine.workflowId;
+        const planned = await this.persistence.highWaterMark(appId, workflowId);
+        const from = planned && planned.getTime() > now.getTime() ? planned : now;
+        const to = new Date(now.getTime() + scheduled.lookaheadMs);
+        if (to.getTime() <= from.getTime())
+            return;
+        const runs = scheduled.schedule.getRuns(from, to).map(runAt => ({
+            appId,
+            workflowId,
+            runAt: this.withOffset(runAt, scheduled.randomRunOffsetMs),
+        }));
+        if (runs.length > 0)
+            await this.persistence.plan(runs);
+    }
+    async startDue(now) {
+        for (const run of await this.persistence.claimDue(now)) {
+            const scheduled = this.machines.get(this.key(run.appId, run.workflowId));
+            if (!scheduled)
+                continue;
+            await scheduled.machine.startJob(this.propertiesFor(run));
+        }
+    }
+    // Spreads runs that would otherwise all fire on the same second. Applied
+    // when the run is planned, not when it starts, so the time that was stored
+    // is the time it actually runs.
+    withOffset(runAt, [lowest, highest]) {
+        if (highest <= lowest)
+            return runAt;
+        return new Date(runAt.getTime() + Math.round(Math.random() * (highest - lowest)) + lowest);
+    }
+    propertiesFor(run) {
+        return new Map([["scheduledFor", run.runAt.toISOString()]]);
+    }
+    key(appId, workflowId) {
+        return JSON.stringify([appId, workflowId]);
+    }
+}
+export { JobRunScheduler };
+//# sourceMappingURL=JobRunScheduler.js.map

package/dist/scheduling/JobRunScheduler.js.map

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

package/dist/scheduling/Schedule.d.ts

@@ -0,0 +1,16 @@
+type TimeOfDay = {
+    hours: number;
+    minutes: number;
+};
+declare class Schedule {
+    private dayTest;
+    private times;
+    constructor(dayTest: (date: Date) => boolean, times: Array<TimeOfDay>);
+    getRuns(from: Date, to: Date): Array<Date>;
+    static daysOfWeek(days: Array<number>): (date: Date) => boolean;
+    static daysOfMonth(days: Array<number>): (date: Date) => boolean;
+    static everyDay(): (_date: Date) => boolean;
+}
+export { Schedule };
+export type { TimeOfDay };
+//# sourceMappingURL=Schedule.d.ts.map

package/dist/scheduling/Schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.d.ts","sourceRoot":"","sources":["../../src/scheduling/Schedule.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG;IAAE,KAAK,EAAG,MAAM,CAAC;IAAC,OAAO,EAAG,MAAM,CAAA;CAAE,CAAC;AAKtD,cAAM,QAAQ;IAEE,OAAO,CAAC,OAAO;IAA6B,OAAO,CAAC,KAAK;IAArE,YAAoB,OAAO,EAAG,CAAC,IAAI,EAAG,IAAI,KAAK,OAAO,EAAU,KAAK,EAAG,KAAK,CAAC,SAAS,CAAC,EAAI;IAG5F,OAAO,CAAC,IAAI,EAAG,IAAI,EAAE,EAAE,EAAG,IAAI,GAAI,KAAK,CAAC,IAAI,CAAC,CAiB5C;IAED,MAAM,CAAC,UAAU,CAAC,IAAI,EAAG,KAAK,CAAC,MAAM,CAAC,UACnB,IAAI,aACtB;IAED,MAAM,CAAC,WAAW,CAAC,IAAI,EAAG,KAAK,CAAC,MAAM,CAAC,UACpB,IAAI,aACtB;IAED,MAAM,CAAC,QAAQ,YACK,IAAI,aACvB;CAEJ;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/scheduling/Schedule.js

@@ -0,0 +1,39 @@
+/* Which days a machine runs on and at what times. The day test and the times
+   are separate so "weekdays at 09:00 and 17:00" and "the 1st of the month at
+   midnight" are the same shape. */
+class Schedule {
+    dayTest;
+    times;
+    constructor(dayTest, times) {
+        this.dayTest = dayTest;
+        this.times = times;
+    }
+    // Runs strictly after `from` and up to and including `to`, in order.
+    getRuns(from, to) {
+        const runs = [];
+        const day = new Date(from);
+        day.setHours(0, 0, 0, 0);
+        for (; day.getTime() <= to.getTime(); day.setDate(day.getDate() + 1)) {
+            if (!this.dayTest(day))
+                continue;
+            for (const time of this.times) {
+                const run = new Date(day);
+                run.setHours(time.hours, time.minutes, 0, 0);
+                if (run.getTime() > from.getTime() && run.getTime() <= to.getTime())
+                    runs.push(run);
+            }
+        }
+        return runs.sort((left, right) => left.getTime() - right.getTime());
+    }
+    static daysOfWeek(days) {
+        return (date) => days.includes(date.getDay());
+    }
+    static daysOfMonth(days) {
+        return (date) => days.includes(date.getDate());
+    }
+    static everyDay() {
+        return (_date) => true;
+    }
+}
+export { Schedule };
+//# sourceMappingURL=Schedule.js.map

package/dist/scheduling/Schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../../src/scheduling/Schedule.ts"],"names":[],"mappings":"AAEA;;mCAEmC;AACnC,MAAM,QAAQ;IAEU,OAAO;IAAqC,KAAK;IAArE,YAAoB,OAAkC,EAAU,KAAwB;uBAApE,OAAO;qBAAqC,KAAK;IAAsB,CAAC;IAE5F,qEAAqE;IACrE,OAAO,CAAC,IAAW,EAAE,EAAS;QAC1B,MAAM,IAAI,GAAiB,EAAE,CAAC;QAE9B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEzB,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,SAAS;YAEjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7C,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;oBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxF,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,IAAoB;QAClC,OAAO,CAAC,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAoB;QACnC,OAAO,CAAC,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,QAAQ;QACX,OAAO,CAAC,KAAY,EAAE,EAAE,CAAC,IAAI,CAAC;IAClC,CAAC;CAEJ;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anbaric-state-machine",
-  "version": "1.23.2",
+  "version": "1.24.0",
   "description": "This is the state machine library that one can use to add state management to an application. It will, by default, be locally runnable but can deployed to the Anbaric Cloud via the CLI",
   "license": "MIT",
   "author": "chris@anbaric.ai",
@@ -24,8 +24,8 @@
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "anbaric-impl-cloud": "^1.23.2",
-    "anbaric-tsapi": "^1.23.2"
+    "anbaric-impl-cloud": "^1.24.0",
+    "anbaric-tsapi": "^1.24.0"
   },
   "files": [
     "dist"