@cogitator-ai/workflows 0.1.0

package/dist/timers/timer-node.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Timer node factories for workflow delays
+ *
+ * Features:
+ * - Fixed delay nodes
+ * - Dynamic delay from state
+ * - Cron-based wait nodes
+ * - Cancellation support
+ * - Integration with timer store
+ */
+import type { TimerEntry, TimerStore } from '@cogitator-ai/types';
+/**
+ * Timer node type
+ */
+export type TimerNodeType = 'fixed' | 'dynamic' | 'cron' | 'until';
+/**
+ * Base timer node config
+ */
+export interface TimerNodeConfig<S> {
+    name: string;
+    type: TimerNodeType;
+    persist?: boolean;
+    onScheduled?: (entry: TimerEntry) => void;
+    onFired?: (entry: TimerEntry) => void;
+    onCancelled?: (entry: TimerEntry) => void;
+    /** Phantom type for state */
+    _state?: S;
+}
+/**
+ * Fixed delay node config
+ */
+export interface FixedDelayConfig<S> extends TimerNodeConfig<S> {
+    type: 'fixed';
+    delay: number;
+}
+/**
+ * Dynamic delay node config
+ */
+export interface DynamicDelayConfig<S> extends TimerNodeConfig<S> {
+    type: 'dynamic';
+    getDelay: (state: S) => number;
+}
+/**
+ * Cron wait node config
+ */
+export interface CronWaitConfig<S> extends TimerNodeConfig<S> {
+    type: 'cron';
+    expression: string;
+    timezone?: string;
+    waitForNext?: boolean;
+}
+/**
+ * Until date node config
+ */
+export interface UntilDateConfig<S> extends TimerNodeConfig<S> {
+    type: 'until';
+    getDate: (state: S) => Date | number;
+    skipIfPast?: boolean;
+}
+/**
+ * Union of all timer node configs
+ */
+export type AnyTimerNodeConfig<S> = FixedDelayConfig<S> | DynamicDelayConfig<S> | CronWaitConfig<S> | UntilDateConfig<S>;
+/**
+ * Timer node result
+ */
+export interface TimerNodeResult {
+    timerId: string;
+    scheduledAt: number;
+    firesAt: number;
+    waited: number;
+    cancelled: boolean;
+}
+/**
+ * Timer execution context
+ */
+export interface TimerExecutionContext {
+    workflowId: string;
+    runId: string;
+    nodeId: string;
+    timerStore?: TimerStore;
+    signal?: AbortSignal;
+}
+/**
+ * Create a fixed delay node
+ */
+export declare function delayNode<S>(name: string, delay: number, options?: Partial<Omit<FixedDelayConfig<S>, 'type' | 'delay'>>): FixedDelayConfig<S>;
+/**
+ * Create a dynamic delay node
+ */
+export declare function dynamicDelayNode<S>(name: string, getDelay: (state: S) => number, options?: Partial<Omit<DynamicDelayConfig<S>, 'type' | 'getDelay'>>): DynamicDelayConfig<S>;
+/**
+ * Create a cron wait node
+ */
+export declare function cronWaitNode<S>(name: string, expression: string, options?: Partial<Omit<CronWaitConfig<S>, 'type' | 'expression'>>): CronWaitConfig<S>;
+/**
+ * Create an until-date node
+ */
+export declare function untilNode<S>(name: string, getDate: (state: S) => Date | number, options?: Partial<Omit<UntilDateConfig<S>, 'type' | 'getDate'>>): UntilDateConfig<S>;
+/**
+ * Calculate the delay for a timer node
+ */
+export declare function calculateTimerDelay<S>(config: AnyTimerNodeConfig<S>, state: S): number;
+/**
+ * Execute a timer node
+ */
+export declare function executeTimerNode<S>(config: AnyTimerNodeConfig<S>, state: S, context: TimerExecutionContext): Promise<TimerNodeResult>;
+/**
+ * Abort error for timer cancellation
+ */
+export declare class AbortError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Create timer node helpers with bound store
+ */
+export declare function createTimerNodeHelpers(timerStore: TimerStore): {
+    delayNode: <S>(name: string, delay: number, options?: Partial<Omit<FixedDelayConfig<S>, "type" | "delay">>) => FixedDelayConfig<S>;
+    dynamicDelayNode: <S>(name: string, getDelay: (state: S) => number, options?: Partial<Omit<DynamicDelayConfig<S>, "type" | "getDelay">>) => DynamicDelayConfig<S>;
+    cronWaitNode: <S>(name: string, expression: string, options?: Partial<Omit<CronWaitConfig<S>, "type" | "expression">>) => CronWaitConfig<S>;
+    untilNode: <S>(name: string, getDate: (state: S) => Date | number, options?: Partial<Omit<UntilDateConfig<S>, "type" | "getDate">>) => UntilDateConfig<S>;
+    executeTimerNode: <S>(config: AnyTimerNodeConfig<S>, state: S, context: Omit<TimerExecutionContext, "timerStore">) => Promise<TimerNodeResult>;
+};
+/**
+ * Duration helpers for readable delays
+ */
+export declare const Duration: {
+    readonly milliseconds: (n: number) => number;
+    readonly seconds: (n: number) => number;
+    readonly minutes: (n: number) => number;
+    readonly hours: (n: number) => number;
+    readonly days: (n: number) => number;
+    readonly weeks: (n: number) => number;
+};
+/**
+ * Parse duration string to milliseconds
+ * Supports: "1s", "5m", "2h", "1d", "1w"
+ */
+export declare function parseDuration(duration: string): number;
+/**
+ * Format duration to human-readable string
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=timer-node.d.ts.map

package/dist/timers/timer-node.d.ts.map

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

package/dist/timers/timer-node.js

@@ -0,0 +1,246 @@
+/**
+ * Timer node factories for workflow delays
+ *
+ * Features:
+ * - Fixed delay nodes
+ * - Dynamic delay from state
+ * - Cron-based wait nodes
+ * - Cancellation support
+ * - Integration with timer store
+ */
+import { getNextCronOccurrence, isValidCronExpression } from './cron-parser';
+/**
+ * Create a fixed delay node
+ */
+export function delayNode(name, delay, options = {}) {
+    return {
+        name,
+        type: 'fixed',
+        delay,
+        ...options,
+    };
+}
+/**
+ * Create a dynamic delay node
+ */
+export function dynamicDelayNode(name, getDelay, options = {}) {
+    return {
+        name,
+        type: 'dynamic',
+        getDelay,
+        ...options,
+    };
+}
+/**
+ * Create a cron wait node
+ */
+export function cronWaitNode(name, expression, options = {}) {
+    if (!isValidCronExpression(expression)) {
+        throw new Error(`Invalid cron expression: ${expression}`);
+    }
+    return {
+        name,
+        type: 'cron',
+        expression,
+        ...options,
+    };
+}
+/**
+ * Create an until-date node
+ */
+export function untilNode(name, getDate, options = {}) {
+    return {
+        name,
+        type: 'until',
+        getDate,
+        ...options,
+    };
+}
+/**
+ * Calculate the delay for a timer node
+ */
+export function calculateTimerDelay(config, state) {
+    const now = Date.now();
+    switch (config.type) {
+        case 'fixed':
+            return config.delay;
+        case 'dynamic':
+            return config.getDelay(state);
+        case 'cron': {
+            const next = getNextCronOccurrence(config.expression, {
+                currentDate: config.waitForNext ? new Date(now + 1000) : new Date(now),
+                timezone: config.timezone,
+            });
+            return Math.max(0, next.getTime() - now);
+        }
+        case 'until': {
+            const target = config.getDate(state);
+            const targetTime = target instanceof Date ? target.getTime() : target;
+            const delay = targetTime - now;
+            if (delay < 0 && config.skipIfPast) {
+                return 0;
+            }
+            return Math.max(0, delay);
+        }
+    }
+}
+/**
+ * Execute a timer node
+ */
+export async function executeTimerNode(config, state, context) {
+    const now = Date.now();
+    const delay = calculateTimerDelay(config, state);
+    const firesAt = now + delay;
+    let timerId;
+    if (config.persist && context.timerStore) {
+        timerId = await context.timerStore.schedule({
+            workflowId: context.workflowId,
+            runId: context.runId,
+            nodeId: context.nodeId,
+            firesAt,
+            type: config.type === 'cron' ? 'cron' : config.type === 'dynamic' ? 'dynamic' : 'fixed',
+            metadata: { nodeType: config.type, delay },
+        });
+        const entry = await context.timerStore.get(timerId);
+        if (entry) {
+            config.onScheduled?.(entry);
+        }
+    }
+    else {
+        timerId = `timer_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+    }
+    const startWait = Date.now();
+    let cancelled = false;
+    try {
+        await waitWithAbort(delay, context.signal);
+    }
+    catch (error) {
+        if (error instanceof AbortError) {
+            cancelled = true;
+            if (config.persist && context.timerStore && timerId) {
+                await context.timerStore.cancel(timerId);
+                const entry = await context.timerStore.get(timerId);
+                if (entry) {
+                    config.onCancelled?.(entry);
+                }
+            }
+        }
+        else {
+            throw error;
+        }
+    }
+    const waited = Date.now() - startWait;
+    if (!cancelled && config.persist && context.timerStore && timerId) {
+        await context.timerStore.markFired(timerId);
+        const entry = await context.timerStore.get(timerId);
+        if (entry) {
+            config.onFired?.(entry);
+        }
+    }
+    return {
+        timerId,
+        scheduledAt: now,
+        firesAt,
+        waited,
+        cancelled,
+    };
+}
+/**
+ * Abort error for timer cancellation
+ */
+export class AbortError extends Error {
+    constructor(message = 'Timer aborted') {
+        super(message);
+        this.name = 'AbortError';
+    }
+}
+/**
+ * Wait with abort signal support
+ */
+function waitWithAbort(delay, signal) {
+    if (delay <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new AbortError());
+            return;
+        }
+        const timeout = setTimeout(resolve, delay);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            reject(new AbortError());
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Create timer node helpers with bound store
+ */
+export function createTimerNodeHelpers(timerStore) {
+    return {
+        delayNode: (name, delay, options = {}) => delayNode(name, delay, { ...options, persist: true }),
+        dynamicDelayNode: (name, getDelay, options = {}) => dynamicDelayNode(name, getDelay, { ...options, persist: true }),
+        cronWaitNode: (name, expression, options = {}) => cronWaitNode(name, expression, { ...options, persist: true }),
+        untilNode: (name, getDate, options = {}) => untilNode(name, getDate, { ...options, persist: true }),
+        executeTimerNode: (config, state, context) => executeTimerNode(config, state, { ...context, timerStore }),
+    };
+}
+/**
+ * Duration helpers for readable delays
+ */
+export const Duration = {
+    milliseconds: (n) => n,
+    seconds: (n) => n * 1000,
+    minutes: (n) => n * 60 * 1000,
+    hours: (n) => n * 60 * 60 * 1000,
+    days: (n) => n * 24 * 60 * 60 * 1000,
+    weeks: (n) => n * 7 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Parse duration string to milliseconds
+ * Supports: "1s", "5m", "2h", "1d", "1w"
+ */
+export function parseDuration(duration) {
+    const match = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d|w)$/i.exec(duration);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    const value = parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    switch (unit) {
+        case 'ms':
+            return Duration.milliseconds(value);
+        case 's':
+            return Duration.seconds(value);
+        case 'm':
+            return Duration.minutes(value);
+        case 'h':
+            return Duration.hours(value);
+        case 'd':
+            return Duration.days(value);
+        case 'w':
+            return Duration.weeks(value);
+        default:
+            throw new Error(`Unknown duration unit: ${unit}`);
+    }
+}
+/**
+ * Format duration to human-readable string
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    if (ms < 3600000) {
+        return `${(ms / 60000).toFixed(1)}m`;
+    }
+    if (ms < 86400000) {
+        return `${(ms / 3600000).toFixed(1)}h`;
+    }
+    return `${(ms / 86400000).toFixed(1)}d`;
+}
+//# sourceMappingURL=timer-node.js.map

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

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

package/dist/timers/timer-store.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 type { TimerEntry, TimerStore } from '@cogitator-ai/types';
+/**
+ * Timer query options
+ */
+export interface TimerQueryOptions {
+    workflowId?: string;
+    runId?: string;
+    nodeId?: string;
+    status?: 'pending' | 'fired' | 'cancelled';
+    firesBefore?: number;
+    firesAfter?: number;
+    limit?: number;
+    offset?: number;
+}
+type FireCallback = (entry: TimerEntry) => void;
+/**
+ * In-memory timer store
+ */
+export declare class InMemoryTimerStore implements TimerStore {
+    private timers;
+    private fireCallbacks;
+    schedule(entry: Omit<TimerEntry, 'id' | 'cancelled' | 'fired' | 'createdAt'>): Promise<string>;
+    get(id: string): Promise<TimerEntry | null>;
+    cancel(id: string): Promise<void>;
+    getByWorkflow(workflowId: string): Promise<TimerEntry[]>;
+    getByRun(runId: string): Promise<TimerEntry[]>;
+    getPending(): Promise<TimerEntry[]>;
+    getOverdue(): Promise<TimerEntry[]>;
+    markFired(id: string): Promise<void>;
+    cleanup(olderThan: number): Promise<number>;
+    onFire(callback: FireCallback): () => void;
+    /**
+     * List timers with filtering
+     */
+    list(options?: TimerQueryOptions): Promise<TimerEntry[]>;
+    /**
+     * Count timers matching options
+     */
+    count(options?: TimerQueryOptions): Promise<number>;
+    /**
+     * Clear all timers
+     */
+    clear(): Promise<void>;
+}
+/**
+ * File-based timer store for persistence
+ */
+export declare class FileTimerStore implements TimerStore {
+    private directory;
+    private indexFile;
+    private initialized;
+    private cache;
+    private fireCallbacks;
+    constructor(directory: string);
+    private ensureInitialized;
+    private persist;
+    schedule(entry: Omit<TimerEntry, 'id' | 'cancelled' | 'fired' | 'createdAt'>): Promise<string>;
+    get(id: string): Promise<TimerEntry | null>;
+    cancel(id: string): Promise<void>;
+    getByWorkflow(workflowId: string): Promise<TimerEntry[]>;
+    getByRun(runId: string): Promise<TimerEntry[]>;
+    getPending(): Promise<TimerEntry[]>;
+    getOverdue(): Promise<TimerEntry[]>;
+    markFired(id: string): Promise<void>;
+    cleanup(olderThan: number): Promise<number>;
+    onFire(callback: FireCallback): () => void;
+    list(options?: TimerQueryOptions): Promise<TimerEntry[]>;
+    count(options?: TimerQueryOptions): Promise<number>;
+    clear(): Promise<void>;
+}
+/**
+ * Create an in-memory timer store
+ */
+export declare function createInMemoryTimerStore(): InMemoryTimerStore;
+/**
+ * Create a file-based timer store
+ */
+export declare function createFileTimerStore(directory: string): FileTimerStore;
+export {};
+//# sourceMappingURL=timer-store.d.ts.map

package/dist/timers/timer-store.d.ts.map

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