@cogitator-ai/workflows 0.1.0

package/dist/triggers/cron-trigger.js

@@ -0,0 +1,309 @@
+/**
+ * Cron Trigger
+ *
+ * Cron-based workflow scheduling with timezone support,
+ * catch-up for missed runs, and concurrency control.
+ */
+import { nanoid } from 'nanoid';
+import { parseCronExpression, getNextCronOccurrence, isValidCronExpression, } from '../timers/cron-parser';
+/**
+ * Cron trigger executor
+ */
+export class CronTriggerExecutor {
+    triggers = new Map();
+    intervals = new Map();
+    onFire;
+    constructor(options = {}) {
+        this.onFire = options.onFire;
+    }
+    /**
+     * Register a cron trigger
+     */
+    register(workflowName, config, externalId) {
+        const triggerId = externalId ?? nanoid();
+        if (!isValidCronExpression(config.expression)) {
+            throw new Error(`Invalid cron expression: ${config.expression}`);
+        }
+        const nextRun = this.calculateNextRun(config);
+        const state = {
+            triggerId,
+            workflowName,
+            config,
+            nextRun,
+            runCount: 0,
+            errorCount: 0,
+            activeRuns: 0,
+            enabled: config.enabled,
+        };
+        this.triggers.set(triggerId, state);
+        if (config.enabled) {
+            this.scheduleNext(triggerId);
+            if (config.runImmediately) {
+                this.fire(triggerId).catch(() => {
+                });
+            }
+        }
+        return triggerId;
+    }
+    /**
+     * Unregister a trigger
+     */
+    unregister(triggerId) {
+        const interval = this.intervals.get(triggerId);
+        if (interval) {
+            clearInterval(interval);
+            this.intervals.delete(triggerId);
+        }
+        this.triggers.delete(triggerId);
+    }
+    /**
+     * Enable a trigger
+     */
+    enable(triggerId) {
+        const state = this.triggers.get(triggerId);
+        if (!state)
+            throw new Error(`Trigger not found: ${triggerId}`);
+        state.enabled = true;
+        state.config.enabled = true;
+        state.nextRun = this.calculateNextRun(state.config);
+        this.scheduleNext(triggerId);
+    }
+    /**
+     * Disable a trigger
+     */
+    disable(triggerId) {
+        const state = this.triggers.get(triggerId);
+        if (!state)
+            throw new Error(`Trigger not found: ${triggerId}`);
+        state.enabled = false;
+        state.config.enabled = false;
+        const interval = this.intervals.get(triggerId);
+        if (interval) {
+            clearInterval(interval);
+            this.intervals.delete(triggerId);
+        }
+    }
+    /**
+     * Get trigger state
+     */
+    getState(triggerId) {
+        return this.triggers.get(triggerId);
+    }
+    /**
+     * Get all triggers for a workflow
+     */
+    getTriggersForWorkflow(workflowName) {
+        return Array.from(this.triggers.values()).filter(t => t.workflowName === workflowName);
+    }
+    /**
+     * Get all enabled triggers
+     */
+    getEnabledTriggers() {
+        return Array.from(this.triggers.values()).filter(t => t.enabled);
+    }
+    /**
+     * Manually fire a trigger
+     */
+    async fire(triggerId) {
+        const state = this.triggers.get(triggerId);
+        if (!state) {
+            return {
+                triggered: false,
+                reason: 'Trigger not found',
+            };
+        }
+        const now = Date.now();
+        if (state.config.maxConcurrent !== undefined &&
+            state.activeRuns >= state.config.maxConcurrent) {
+            return {
+                triggered: false,
+                skipped: true,
+                reason: `Max concurrent runs reached: ${state.config.maxConcurrent}`,
+                nextRun: state.nextRun,
+            };
+        }
+        const context = {
+            triggerId,
+            triggerType: 'cron',
+            timestamp: now,
+            metadata: {
+                expression: state.config.expression,
+                timezone: state.config.timezone,
+                scheduled: state.nextRun,
+            },
+        };
+        if (state.config.condition && !state.config.condition(context)) {
+            return {
+                triggered: false,
+                skipped: true,
+                reason: 'Condition not met',
+                nextRun: state.nextRun,
+            };
+        }
+        const input = typeof state.config.input === 'function'
+            ? state.config.input(context)
+            : state.config.input;
+        if (input) {
+            context.payload = input;
+        }
+        state.activeRuns++;
+        state.lastRun = now;
+        try {
+            const trigger = this.toWorkflowTrigger(state);
+            const runId = await this.onFire?.(trigger, context);
+            state.runCount++;
+            state.activeRuns--;
+            state.nextRun = this.calculateNextRun(state.config);
+            return {
+                triggered: true,
+                runId,
+                nextRun: state.nextRun,
+            };
+        }
+        catch (error) {
+            state.errorCount++;
+            state.activeRuns--;
+            state.lastError = error instanceof Error ? error.message : String(error);
+            return {
+                triggered: false,
+                reason: state.lastError,
+                nextRun: state.nextRun,
+            };
+        }
+    }
+    /**
+     * Check for catch-up runs (missed scheduled runs)
+     */
+    async catchUp(triggerId, since) {
+        const state = this.triggers.get(triggerId);
+        if (!state?.config.catchUp) {
+            return [];
+        }
+        const results = [];
+        const now = Date.now();
+        let currentTime = since;
+        while (currentTime < now) {
+            const nextRun = getNextCronOccurrence(state.config.expression, { timezone: state.config.timezone, currentDate: new Date(currentTime) });
+            if (!nextRun || nextRun.getTime() >= now) {
+                break;
+            }
+            const result = await this.fire(triggerId);
+            results.push(result);
+            currentTime = nextRun.getTime() + 1;
+        }
+        return results;
+    }
+    /**
+     * Get all triggers
+     */
+    getAll() {
+        return Array.from(this.triggers.values());
+    }
+    /**
+     * Dispose all triggers
+     */
+    dispose() {
+        for (const interval of this.intervals.values()) {
+            clearInterval(interval);
+        }
+        this.intervals.clear();
+        this.triggers.clear();
+    }
+    scheduleNext(triggerId) {
+        const state = this.triggers.get(triggerId);
+        if (!state?.enabled)
+            return;
+        const existingInterval = this.intervals.get(triggerId);
+        if (existingInterval) {
+            clearInterval(existingInterval);
+        }
+        const now = Date.now();
+        const nextRun = state.nextRun ?? this.calculateNextRun(state.config);
+        if (!nextRun)
+            return;
+        const delay = Math.max(0, nextRun - now);
+        const timeoutId = setTimeout(async () => {
+            if (!this.triggers.has(triggerId))
+                return;
+            await this.fire(triggerId);
+            const checkInterval = this.calculateCheckInterval(state.config);
+            const interval = setInterval(async () => {
+                const currentState = this.triggers.get(triggerId);
+                if (!currentState?.enabled) {
+                    clearInterval(interval);
+                    return;
+                }
+                const currentNow = Date.now();
+                if (currentState.nextRun && currentNow >= currentState.nextRun) {
+                    await this.fire(triggerId);
+                }
+            }, checkInterval);
+            this.intervals.set(triggerId, interval);
+        }, delay);
+        this.intervals.set(triggerId, timeoutId);
+    }
+    calculateNextRun(config) {
+        try {
+            const next = getNextCronOccurrence(config.expression, {
+                timezone: config.timezone,
+            });
+            return next?.getTime();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    calculateCheckInterval(config) {
+        const parsed = parseCronExpression(config.expression);
+        if (parsed.fields.second && parsed.fields.second.length < 60) {
+            return 1000;
+        }
+        return 60000;
+    }
+    toWorkflowTrigger(state) {
+        return {
+            id: state.triggerId,
+            workflowName: state.workflowName,
+            type: 'cron',
+            config: state.config,
+            enabled: state.enabled,
+            createdAt: Date.now(),
+            lastTriggered: state.lastRun,
+            nextTrigger: state.nextRun,
+            triggerCount: state.runCount,
+            errorCount: state.errorCount,
+            lastError: state.lastError,
+        };
+    }
+}
+/**
+ * Create a cron trigger executor
+ */
+export function createCronTrigger(options = {}) {
+    return new CronTriggerExecutor(options);
+}
+/**
+ * Validate a cron trigger config
+ */
+export function validateCronTriggerConfig(config) {
+    const errors = [];
+    if (!config.expression) {
+        errors.push('Cron expression is required');
+    }
+    else if (!isValidCronExpression(config.expression)) {
+        errors.push(`Invalid cron expression: ${config.expression}`);
+    }
+    if (config.timezone) {
+        try {
+            Intl.DateTimeFormat(undefined, { timeZone: config.timezone });
+        }
+        catch {
+            errors.push(`Invalid timezone: ${config.timezone}`);
+        }
+    }
+    if (config.maxConcurrent !== undefined && config.maxConcurrent < 1) {
+        errors.push('maxConcurrent must be at least 1');
+    }
+    return errors;
+}
+//# sourceMappingURL=cron-trigger.js.map

package/dist/triggers/cron-trigger.js.map

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

package/dist/triggers/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Trigger System
+ *
+ * Workflow triggers for cron scheduling, webhooks, and events.
+ */
+export { TokenBucket, RateLimiter, SlidingWindowRateLimiter, createRateLimiter, createSlidingWindowLimiter, } from './rate-limiter';
+export type { TokenBucketConfig, RateLimitResult, } from './rate-limiter';
+export { CronTriggerExecutor, createCronTrigger, validateCronTriggerConfig, } from './cron-trigger';
+export type { CronTriggerState, CronTriggerResult, } from './cron-trigger';
+export { WebhookTriggerExecutor, WebhookAuthError, WebhookRateLimitError, createWebhookTrigger, validateWebhookTriggerConfig, } from './webhook-trigger';
+export type { WebhookRequest, WebhookResponse, WebhookTriggerState, WebhookHandlerResult, } from './webhook-trigger';
+export { InMemoryTriggerStore, SimpleTriggerEventEmitter, DefaultTriggerManager, createTriggerManager, cronTrigger, webhookTrigger, eventTrigger, } from './trigger-manager';
+export type { TriggerStore, TriggerEventEmitter, TriggerManagerConfig, } from './trigger-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/triggers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/triggers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/triggers/index.js

@@ -0,0 +1,10 @@
+/**
+ * Trigger System
+ *
+ * Workflow triggers for cron scheduling, webhooks, and events.
+ */
+export { TokenBucket, RateLimiter, SlidingWindowRateLimiter, createRateLimiter, createSlidingWindowLimiter, } from './rate-limiter';
+export { CronTriggerExecutor, createCronTrigger, validateCronTriggerConfig, } from './cron-trigger';
+export { WebhookTriggerExecutor, WebhookAuthError, WebhookRateLimitError, createWebhookTrigger, validateWebhookTriggerConfig, } from './webhook-trigger';
+export { InMemoryTriggerStore, SimpleTriggerEventEmitter, DefaultTriggerManager, createTriggerManager, cronTrigger, webhookTrigger, eventTrigger, } from './trigger-manager';
+//# sourceMappingURL=index.js.map

package/dist/triggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/triggers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/triggers/rate-limiter.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Rate Limiter
+ *
+ * Token bucket algorithm implementation for rate limiting
+ * with support for burst limits and sliding windows.
+ */
+/**
+ * Token bucket configuration
+ */
+export interface TokenBucketConfig {
+    /** Maximum number of tokens (requests per window) */
+    capacity: number;
+    /** Window size in milliseconds */
+    window: number;
+    /** Burst limit - maximum tokens that can be consumed at once */
+    burstLimit?: number;
+    /** Initial token count (defaults to capacity) */
+    initialTokens?: number;
+}
+/**
+ * Rate limit check result
+ */
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+    retryAfter?: number;
+}
+/**
+ * Token bucket rate limiter
+ */
+export declare class TokenBucket {
+    private tokens;
+    private lastRefill;
+    private readonly capacity;
+    private readonly refillRate;
+    private readonly burstLimit;
+    constructor(config: TokenBucketConfig);
+    /**
+     * Try to consume tokens
+     */
+    consume(count?: number): RateLimitResult;
+    /**
+     * Check if tokens are available without consuming
+     */
+    check(count?: number): RateLimitResult;
+    /**
+     * Get current token count
+     */
+    getTokens(): number;
+    /**
+     * Reset the bucket to full capacity
+     */
+    reset(): void;
+    private refill;
+    private calculateResetAt;
+}
+/**
+ * Rate limiter that manages multiple buckets by key
+ */
+export declare class RateLimiter {
+    private buckets;
+    private readonly config;
+    private cleanupInterval?;
+    constructor(config: TokenBucketConfig, cleanupIntervalMs?: number);
+    /**
+     * Check rate limit for a key
+     */
+    check(key: string, count?: number): RateLimitResult;
+    /**
+     * Consume tokens for a key
+     */
+    consume(key: string, count?: number): RateLimitResult;
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key: string): void;
+    /**
+     * Remove a key's bucket
+     */
+    remove(key: string): void;
+    /**
+     * Get all tracked keys
+     */
+    getKeys(): string[];
+    /**
+     * Dispose the rate limiter
+     */
+    dispose(): void;
+    private getBucket;
+    private cleanup;
+}
+/**
+ * Sliding window rate limiter
+ * More accurate than token bucket for some use cases
+ */
+export declare class SlidingWindowRateLimiter {
+    private windows;
+    private readonly maxRequests;
+    private readonly windowMs;
+    private cleanupInterval?;
+    constructor(maxRequests: number, windowMs: number, cleanupIntervalMs?: number);
+    /**
+     * Check if request is allowed and record it
+     */
+    consume(key: string): RateLimitResult;
+    /**
+     * Check without consuming
+     */
+    check(key: string): RateLimitResult;
+    /**
+     * Reset a key's window
+     */
+    reset(key: string): void;
+    /**
+     * Dispose the rate limiter
+     */
+    dispose(): void;
+    private getWindow;
+    private cleanup;
+}
+/**
+ * Create a token bucket rate limiter
+ */
+export declare function createRateLimiter(config: TokenBucketConfig): RateLimiter;
+/**
+ * Create a sliding window rate limiter
+ */
+export declare function createSlidingWindowLimiter(maxRequests: number, windowMs: number): SlidingWindowRateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/triggers/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/triggers/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,iBAAiB;IAQrC;;OAEG;IACH,OAAO,CAAC,KAAK,SAAI,GAAG,eAAe;IAgCnC;;OAEG;IACH,KAAK,CAAC,KAAK,SAAI,GAAG,eAAe;IAsBjC;;OAEG;IACH,SAAS,IAAI,MAAM;IAKnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,gBAAgB;CAKzB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,eAAe,CAAC,CAAiC;gBAE7C,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,SAAQ;IAQhE;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,eAAe;IAK9C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,eAAe;IAKhD;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOxB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,OAAO;CAOhB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,eAAe,CAAC,CAAiC;gBAE7C,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,SAAQ;IAS5E;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IA2BrC;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAiCnC;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,OAAO;CAWhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,wBAAwB,CAE1B"}