@cogitator-ai/workflows 0.1.0

package/dist/timers/timer-store.js

@@ -0,0 +1,357 @@
+/**
+ * Timer Store implementations for workflow timers
+ *
+ * Features:
+ * - In-memory and file-based storage
+ * - Timer persistence across restarts
+ * - Efficient lookup by due time
+ * - Cancellation support
+ * - Fire event callbacks
+ */
+import { nanoid } from 'nanoid';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+/**
+ * In-memory timer store
+ */
+export class InMemoryTimerStore {
+    timers = new Map();
+    fireCallbacks = [];
+    async schedule(entry) {
+        const id = `timer_${nanoid(12)}`;
+        const timer = {
+            ...entry,
+            id,
+            cancelled: false,
+            fired: false,
+            createdAt: Date.now(),
+        };
+        this.timers.set(id, timer);
+        return id;
+    }
+    async get(id) {
+        return this.timers.get(id) ?? null;
+    }
+    async cancel(id) {
+        const timer = this.timers.get(id);
+        if (timer && !timer.cancelled && !timer.fired) {
+            timer.cancelled = true;
+        }
+    }
+    async getByWorkflow(workflowId) {
+        const results = [];
+        for (const timer of this.timers.values()) {
+            if (timer.workflowId === workflowId) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getByRun(runId) {
+        const results = [];
+        for (const timer of this.timers.values()) {
+            if (timer.runId === runId) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getPending() {
+        const results = [];
+        for (const timer of this.timers.values()) {
+            if (!timer.cancelled && !timer.fired) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getOverdue() {
+        const now = Date.now();
+        const results = [];
+        for (const timer of this.timers.values()) {
+            if (!timer.cancelled && !timer.fired && timer.firesAt <= now) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async markFired(id) {
+        const timer = this.timers.get(id);
+        if (timer && !timer.cancelled && !timer.fired) {
+            timer.fired = true;
+            for (const callback of this.fireCallbacks) {
+                try {
+                    callback(timer);
+                }
+                catch {
+                }
+            }
+        }
+    }
+    async cleanup(olderThan) {
+        const cutoff = Date.now() - olderThan;
+        let count = 0;
+        for (const [id, timer] of this.timers) {
+            if ((timer.fired || timer.cancelled) && timer.createdAt < cutoff) {
+                this.timers.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+    onFire(callback) {
+        this.fireCallbacks.push(callback);
+        return () => {
+            const idx = this.fireCallbacks.indexOf(callback);
+            if (idx !== -1) {
+                this.fireCallbacks.splice(idx, 1);
+            }
+        };
+    }
+    /**
+     * List timers with filtering
+     */
+    async list(options = {}) {
+        let results = [];
+        for (const timer of this.timers.values()) {
+            if (options.workflowId && timer.workflowId !== options.workflowId)
+                continue;
+            if (options.runId && timer.runId !== options.runId)
+                continue;
+            if (options.nodeId && timer.nodeId !== options.nodeId)
+                continue;
+            if (options.firesBefore !== undefined && timer.firesAt > options.firesBefore)
+                continue;
+            if (options.firesAfter !== undefined && timer.firesAt < options.firesAfter)
+                continue;
+            if (options.status) {
+                if (options.status === 'pending' && (timer.fired || timer.cancelled))
+                    continue;
+                if (options.status === 'fired' && !timer.fired)
+                    continue;
+                if (options.status === 'cancelled' && !timer.cancelled)
+                    continue;
+            }
+            results.push(timer);
+        }
+        results.sort((a, b) => a.firesAt - b.firesAt);
+        if (options.offset) {
+            results = results.slice(options.offset);
+        }
+        if (options.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    /**
+     * Count timers matching options
+     */
+    async count(options = {}) {
+        const list = await this.list(options);
+        return list.length;
+    }
+    /**
+     * Clear all timers
+     */
+    async clear() {
+        this.timers.clear();
+    }
+}
+/**
+ * File-based timer store for persistence
+ */
+export class FileTimerStore {
+    directory;
+    indexFile;
+    initialized = false;
+    cache = new Map();
+    fireCallbacks = [];
+    constructor(directory) {
+        this.directory = directory;
+        this.indexFile = join(directory, 'timers.json');
+    }
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        try {
+            await fs.mkdir(this.directory, { recursive: true });
+            try {
+                const content = await fs.readFile(this.indexFile, 'utf-8');
+                const timers = JSON.parse(content);
+                for (const timer of timers) {
+                    this.cache.set(timer.id, timer);
+                }
+            }
+            catch {
+            }
+        }
+        catch {
+        }
+        this.initialized = true;
+    }
+    async persist() {
+        const timers = Array.from(this.cache.values());
+        await fs.writeFile(this.indexFile, JSON.stringify(timers, null, 2));
+    }
+    async schedule(entry) {
+        await this.ensureInitialized();
+        const id = `timer_${nanoid(12)}`;
+        const timer = {
+            ...entry,
+            id,
+            cancelled: false,
+            fired: false,
+            createdAt: Date.now(),
+        };
+        this.cache.set(id, timer);
+        await this.persist();
+        return id;
+    }
+    async get(id) {
+        await this.ensureInitialized();
+        return this.cache.get(id) ?? null;
+    }
+    async cancel(id) {
+        await this.ensureInitialized();
+        const timer = this.cache.get(id);
+        if (timer && !timer.cancelled && !timer.fired) {
+            timer.cancelled = true;
+            await this.persist();
+        }
+    }
+    async getByWorkflow(workflowId) {
+        await this.ensureInitialized();
+        const results = [];
+        for (const timer of this.cache.values()) {
+            if (timer.workflowId === workflowId) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getByRun(runId) {
+        await this.ensureInitialized();
+        const results = [];
+        for (const timer of this.cache.values()) {
+            if (timer.runId === runId) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getPending() {
+        await this.ensureInitialized();
+        const results = [];
+        for (const timer of this.cache.values()) {
+            if (!timer.cancelled && !timer.fired) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async getOverdue() {
+        await this.ensureInitialized();
+        const now = Date.now();
+        const results = [];
+        for (const timer of this.cache.values()) {
+            if (!timer.cancelled && !timer.fired && timer.firesAt <= now) {
+                results.push(timer);
+            }
+        }
+        return results.sort((a, b) => a.firesAt - b.firesAt);
+    }
+    async markFired(id) {
+        await this.ensureInitialized();
+        const timer = this.cache.get(id);
+        if (timer && !timer.cancelled && !timer.fired) {
+            timer.fired = true;
+            await this.persist();
+            for (const callback of this.fireCallbacks) {
+                try {
+                    callback(timer);
+                }
+                catch {
+                }
+            }
+        }
+    }
+    async cleanup(olderThan) {
+        await this.ensureInitialized();
+        const cutoff = Date.now() - olderThan;
+        let count = 0;
+        for (const [id, timer] of this.cache) {
+            if ((timer.fired || timer.cancelled) && timer.createdAt < cutoff) {
+                this.cache.delete(id);
+                count++;
+            }
+        }
+        if (count > 0) {
+            await this.persist();
+        }
+        return count;
+    }
+    onFire(callback) {
+        this.fireCallbacks.push(callback);
+        return () => {
+            const idx = this.fireCallbacks.indexOf(callback);
+            if (idx !== -1) {
+                this.fireCallbacks.splice(idx, 1);
+            }
+        };
+    }
+    async list(options = {}) {
+        await this.ensureInitialized();
+        let results = [];
+        for (const timer of this.cache.values()) {
+            if (options.workflowId && timer.workflowId !== options.workflowId)
+                continue;
+            if (options.runId && timer.runId !== options.runId)
+                continue;
+            if (options.nodeId && timer.nodeId !== options.nodeId)
+                continue;
+            if (options.firesBefore !== undefined && timer.firesAt > options.firesBefore)
+                continue;
+            if (options.firesAfter !== undefined && timer.firesAt < options.firesAfter)
+                continue;
+            if (options.status) {
+                if (options.status === 'pending' && (timer.fired || timer.cancelled))
+                    continue;
+                if (options.status === 'fired' && !timer.fired)
+                    continue;
+                if (options.status === 'cancelled' && !timer.cancelled)
+                    continue;
+            }
+            results.push(timer);
+        }
+        results.sort((a, b) => a.firesAt - b.firesAt);
+        if (options.offset) {
+            results = results.slice(options.offset);
+        }
+        if (options.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    async count(options = {}) {
+        const list = await this.list(options);
+        return list.length;
+    }
+    async clear() {
+        await this.ensureInitialized();
+        this.cache.clear();
+        await this.persist();
+    }
+}
+/**
+ * Create an in-memory timer store
+ */
+export function createInMemoryTimerStore() {
+    return new InMemoryTimerStore();
+}
+/**
+ * Create a file-based timer store
+ */
+export function createFileTimerStore(directory) {
+    return new FileTimerStore(directory);
+}
+//# sourceMappingURL=timer-store.js.map

package/dist/timers/timer-store.js.map

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

package/dist/triggers/cron-trigger.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Cron Trigger
+ *
+ * Cron-based workflow scheduling with timezone support,
+ * catch-up for missed runs, and concurrency control.
+ */
+import type { CronTriggerConfig, TriggerContext, WorkflowTrigger } from '@cogitator-ai/types';
+/**
+ * Cron trigger state
+ */
+export interface CronTriggerState {
+    triggerId: string;
+    workflowName: string;
+    config: CronTriggerConfig;
+    lastRun?: number;
+    nextRun?: number;
+    runCount: number;
+    errorCount: number;
+    lastError?: string;
+    activeRuns: number;
+    enabled: boolean;
+}
+/**
+ * Cron trigger handler result
+ */
+export interface CronTriggerResult {
+    triggered: boolean;
+    runId?: string;
+    skipped?: boolean;
+    reason?: string;
+    nextRun?: number;
+}
+/**
+ * Cron trigger executor
+ */
+export declare class CronTriggerExecutor {
+    private triggers;
+    private intervals;
+    private onFire?;
+    constructor(options?: {
+        onFire?: (trigger: WorkflowTrigger, context: TriggerContext) => Promise<string>;
+    });
+    /**
+     * Register a cron trigger
+     */
+    register(workflowName: string, config: CronTriggerConfig, externalId?: string): string;
+    /**
+     * Unregister a trigger
+     */
+    unregister(triggerId: string): void;
+    /**
+     * Enable a trigger
+     */
+    enable(triggerId: string): void;
+    /**
+     * Disable a trigger
+     */
+    disable(triggerId: string): void;
+    /**
+     * Get trigger state
+     */
+    getState(triggerId: string): CronTriggerState | undefined;
+    /**
+     * Get all triggers for a workflow
+     */
+    getTriggersForWorkflow(workflowName: string): CronTriggerState[];
+    /**
+     * Get all enabled triggers
+     */
+    getEnabledTriggers(): CronTriggerState[];
+    /**
+     * Manually fire a trigger
+     */
+    fire(triggerId: string): Promise<CronTriggerResult>;
+    /**
+     * Check for catch-up runs (missed scheduled runs)
+     */
+    catchUp(triggerId: string, since: number): Promise<CronTriggerResult[]>;
+    /**
+     * Get all triggers
+     */
+    getAll(): CronTriggerState[];
+    /**
+     * Dispose all triggers
+     */
+    dispose(): void;
+    private scheduleNext;
+    private calculateNextRun;
+    private calculateCheckInterval;
+    private toWorkflowTrigger;
+}
+/**
+ * Create a cron trigger executor
+ */
+export declare function createCronTrigger(options?: {
+    onFire?: (trigger: WorkflowTrigger, context: TriggerContext) => Promise<string>;
+}): CronTriggerExecutor;
+/**
+ * Validate a cron trigger config
+ */
+export declare function validateCronTriggerConfig(config: CronTriggerConfig): string[];
+//# sourceMappingURL=cron-trigger.d.ts.map

package/dist/triggers/cron-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-trigger.d.ts","sourceRoot":"","sources":["../../src/triggers/cron-trigger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAO7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,MAAM,CAAC,CAAyE;gBAE5E,OAAO,GAAE;QACnB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KAC5E;IAIN;;OAEG;IACH,QAAQ,CACN,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,iBAAiB,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM;IAkCT;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASnC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAU/B;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAchC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIzD;;OAEG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMhE;;OAEG;IACH,kBAAkB,IAAI,gBAAgB,EAAE;IAIxC;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+EzD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B7E;;OAEG;IACH,MAAM,IAAI,gBAAgB,EAAE;IAI5B;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,iBAAiB;CAe1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IACzC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E,GAAG,mBAAmB,CAE3B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAsB7E"}