@cogitator-ai/workflows 0.1.0

package/dist/triggers/rate-limiter.js

@@ -0,0 +1,294 @@
+/**
+ * Rate Limiter
+ *
+ * Token bucket algorithm implementation for rate limiting
+ * with support for burst limits and sliding windows.
+ */
+/**
+ * Token bucket rate limiter
+ */
+export class TokenBucket {
+    tokens;
+    lastRefill;
+    capacity;
+    refillRate;
+    burstLimit;
+    constructor(config) {
+        this.capacity = config.capacity;
+        this.burstLimit = config.burstLimit ?? config.capacity;
+        this.tokens = config.initialTokens ?? config.capacity;
+        this.lastRefill = Date.now();
+        this.refillRate = config.capacity / config.window;
+    }
+    /**
+     * Try to consume tokens
+     */
+    consume(count = 1) {
+        this.refill();
+        if (count > this.burstLimit) {
+            return {
+                allowed: false,
+                remaining: Math.floor(this.tokens),
+                resetAt: this.calculateResetAt(),
+                retryAfter: undefined,
+            };
+        }
+        if (this.tokens >= count) {
+            this.tokens -= count;
+            return {
+                allowed: true,
+                remaining: Math.floor(this.tokens),
+                resetAt: this.calculateResetAt(),
+            };
+        }
+        const tokensNeeded = count - this.tokens;
+        const retryAfter = Math.ceil(tokensNeeded / this.refillRate);
+        return {
+            allowed: false,
+            remaining: Math.floor(this.tokens),
+            resetAt: this.calculateResetAt(),
+            retryAfter,
+        };
+    }
+    /**
+     * Check if tokens are available without consuming
+     */
+    check(count = 1) {
+        this.refill();
+        if (this.tokens >= count) {
+            return {
+                allowed: true,
+                remaining: Math.floor(this.tokens),
+                resetAt: this.calculateResetAt(),
+            };
+        }
+        const tokensNeeded = count - this.tokens;
+        const retryAfter = Math.ceil(tokensNeeded / this.refillRate);
+        return {
+            allowed: false,
+            remaining: Math.floor(this.tokens),
+            resetAt: this.calculateResetAt(),
+            retryAfter,
+        };
+    }
+    /**
+     * Get current token count
+     */
+    getTokens() {
+        this.refill();
+        return Math.floor(this.tokens);
+    }
+    /**
+     * Reset the bucket to full capacity
+     */
+    reset() {
+        this.tokens = this.capacity;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const tokensToAdd = elapsed * this.refillRate;
+        this.tokens = Math.min(this.capacity, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    calculateResetAt() {
+        const tokensNeeded = this.capacity - this.tokens;
+        const timeToFull = tokensNeeded / this.refillRate;
+        return Date.now() + timeToFull;
+    }
+}
+/**
+ * Rate limiter that manages multiple buckets by key
+ */
+export class RateLimiter {
+    buckets = new Map();
+    config;
+    cleanupInterval;
+    constructor(config, cleanupIntervalMs = 60000) {
+        this.config = config;
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, cleanupIntervalMs);
+    }
+    /**
+     * Check rate limit for a key
+     */
+    check(key, count = 1) {
+        const bucket = this.getBucket(key);
+        return bucket.check(count);
+    }
+    /**
+     * Consume tokens for a key
+     */
+    consume(key, count = 1) {
+        const bucket = this.getBucket(key);
+        return bucket.consume(count);
+    }
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key) {
+        const bucket = this.buckets.get(key);
+        if (bucket) {
+            bucket.reset();
+        }
+    }
+    /**
+     * Remove a key's bucket
+     */
+    remove(key) {
+        this.buckets.delete(key);
+    }
+    /**
+     * Get all tracked keys
+     */
+    getKeys() {
+        return Array.from(this.buckets.keys());
+    }
+    /**
+     * Dispose the rate limiter
+     */
+    dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.buckets.clear();
+    }
+    getBucket(key) {
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = new TokenBucket(this.config);
+            this.buckets.set(key, bucket);
+        }
+        return bucket;
+    }
+    cleanup() {
+        for (const [key, bucket] of this.buckets) {
+            if (bucket.getTokens() >= this.config.capacity) {
+                this.buckets.delete(key);
+            }
+        }
+    }
+}
+/**
+ * Sliding window rate limiter
+ * More accurate than token bucket for some use cases
+ */
+export class SlidingWindowRateLimiter {
+    windows = new Map();
+    maxRequests;
+    windowMs;
+    cleanupInterval;
+    constructor(maxRequests, windowMs, cleanupIntervalMs = 60000) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, cleanupIntervalMs);
+    }
+    /**
+     * Check if request is allowed and record it
+     */
+    consume(key) {
+        const now = Date.now();
+        const window = this.getWindow(key);
+        const cutoff = now - this.windowMs;
+        window.timestamps = window.timestamps.filter(t => t > cutoff);
+        if (window.timestamps.length >= this.maxRequests) {
+            const oldestInWindow = window.timestamps[0];
+            const resetAt = oldestInWindow + this.windowMs;
+            return {
+                allowed: false,
+                remaining: 0,
+                resetAt,
+                retryAfter: resetAt - now,
+            };
+        }
+        window.timestamps.push(now);
+        return {
+            allowed: true,
+            remaining: this.maxRequests - window.timestamps.length,
+            resetAt: now + this.windowMs,
+        };
+    }
+    /**
+     * Check without consuming
+     */
+    check(key) {
+        const now = Date.now();
+        const window = this.windows.get(key);
+        if (!window) {
+            return {
+                allowed: true,
+                remaining: this.maxRequests,
+                resetAt: now + this.windowMs,
+            };
+        }
+        const cutoff = now - this.windowMs;
+        const validTimestamps = window.timestamps.filter(t => t > cutoff);
+        if (validTimestamps.length >= this.maxRequests) {
+            const oldestInWindow = validTimestamps[0];
+            const resetAt = oldestInWindow + this.windowMs;
+            return {
+                allowed: false,
+                remaining: 0,
+                resetAt,
+                retryAfter: resetAt - now,
+            };
+        }
+        return {
+            allowed: true,
+            remaining: this.maxRequests - validTimestamps.length,
+            resetAt: now + this.windowMs,
+        };
+    }
+    /**
+     * Reset a key's window
+     */
+    reset(key) {
+        this.windows.delete(key);
+    }
+    /**
+     * Dispose the rate limiter
+     */
+    dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.windows.clear();
+    }
+    getWindow(key) {
+        let window = this.windows.get(key);
+        if (!window) {
+            window = { timestamps: [] };
+            this.windows.set(key, window);
+        }
+        return window;
+    }
+    cleanup() {
+        const now = Date.now();
+        const cutoff = now - this.windowMs;
+        for (const [key, window] of this.windows) {
+            window.timestamps = window.timestamps.filter(t => t > cutoff);
+            if (window.timestamps.length === 0) {
+                this.windows.delete(key);
+            }
+        }
+    }
+}
+/**
+ * Create a token bucket rate limiter
+ */
+export function createRateLimiter(config) {
+    return new RateLimiter(config);
+}
+/**
+ * Create a sliding window rate limiter
+ */
+export function createSlidingWindowLimiter(maxRequests, windowMs) {
+    return new SlidingWindowRateLimiter(maxRequests, windowMs);
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/triggers/rate-limiter.js.map

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

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

@@ -0,0 +1,166 @@
+/**
+ * Trigger Manager
+ *
+ * Central management for all workflow triggers (cron, webhook, event).
+ * Coordinates trigger registration, firing, and lifecycle.
+ */
+import type { WorkflowTrigger, TriggerContext, TriggerManager as ITriggerManager, CronTriggerConfig, WebhookTriggerConfig, EventTriggerConfig, Workflow, WorkflowState } from '@cogitator-ai/types';
+import { type WebhookRequest } from './webhook-trigger';
+/**
+ * Trigger store interface
+ */
+export interface TriggerStore {
+    save(trigger: WorkflowTrigger): Promise<void>;
+    get(id: string): Promise<WorkflowTrigger | null>;
+    update(id: string, updates: Partial<WorkflowTrigger>): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(workflowName?: string): Promise<WorkflowTrigger[]>;
+    listEnabled(): Promise<WorkflowTrigger[]>;
+    listByType(type: 'cron' | 'webhook' | 'event'): Promise<WorkflowTrigger[]>;
+}
+/**
+ * In-memory trigger store
+ */
+export declare class InMemoryTriggerStore implements TriggerStore {
+    private triggers;
+    save(trigger: WorkflowTrigger): Promise<void>;
+    get(id: string): Promise<WorkflowTrigger | null>;
+    update(id: string, updates: Partial<WorkflowTrigger>): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(workflowName?: string): Promise<WorkflowTrigger[]>;
+    listEnabled(): Promise<WorkflowTrigger[]>;
+    listByType(type: 'cron' | 'webhook' | 'event'): Promise<WorkflowTrigger[]>;
+    clear(): void;
+}
+/**
+ * Event emitter for triggers
+ */
+export interface TriggerEventEmitter {
+    emit(eventType: string, payload: unknown): void;
+    on(eventType: string, callback: (payload: unknown) => void): () => void;
+}
+/**
+ * Simple event emitter implementation
+ */
+export declare class SimpleTriggerEventEmitter implements TriggerEventEmitter {
+    private listeners;
+    emit(eventType: string, payload: unknown): void;
+    on(eventType: string, callback: (payload: unknown) => void): () => void;
+    clear(): void;
+}
+/**
+ * Trigger manager configuration
+ */
+export interface TriggerManagerConfig {
+    store?: TriggerStore;
+    eventEmitter?: TriggerEventEmitter;
+    onTriggerFire?: (trigger: WorkflowTrigger, context: TriggerContext) => Promise<string>;
+}
+/**
+ * Default trigger manager implementation
+ */
+export declare class DefaultTriggerManager implements ITriggerManager {
+    private store;
+    private eventEmitter;
+    private cronExecutor;
+    private webhookExecutor;
+    private triggerCallbacks;
+    private eventListeners;
+    private _started;
+    constructor(config?: TriggerManagerConfig);
+    /**
+     * Start the trigger manager
+     */
+    start(): void;
+    /**
+     * Stop the trigger manager
+     */
+    stop(): void;
+    /**
+     * Check if the manager is running
+     */
+    get isRunning(): boolean;
+    /**
+     * Register a trigger
+     */
+    register(trigger: Omit<WorkflowTrigger, 'id' | 'createdAt' | 'triggerCount' | 'errorCount'>): Promise<string>;
+    /**
+     * Unregister a trigger
+     */
+    unregister(id: string): Promise<void>;
+    /**
+     * Enable a trigger
+     */
+    enable(id: string): Promise<void>;
+    /**
+     * Disable a trigger
+     */
+    disable(id: string): Promise<void>;
+    /**
+     * Get a trigger
+     */
+    get(id: string): Promise<WorkflowTrigger | null>;
+    /**
+     * List triggers
+     */
+    list(workflowName?: string): Promise<WorkflowTrigger[]>;
+    /**
+     * List enabled triggers
+     */
+    listEnabled(): Promise<WorkflowTrigger[]>;
+    /**
+     * Manually fire a trigger
+     */
+    fire(id: string, partialContext?: Partial<TriggerContext>): Promise<string>;
+    /**
+     * Subscribe to trigger events
+     */
+    onTrigger(callback: (trigger: WorkflowTrigger, context: TriggerContext) => void): () => void;
+    /**
+     * Handle incoming webhook request
+     */
+    handleWebhook(request: WebhookRequest): Promise<import("./webhook-trigger").WebhookHandlerResult | null>;
+    /**
+     * Emit an event (for event triggers)
+     */
+    emitEvent(eventType: string, payload: unknown): void;
+    /**
+     * Register a workflow with triggers
+     */
+    registerWorkflow<S extends WorkflowState>(workflow: Workflow<S>, triggers: {
+        type: 'cron' | 'webhook' | 'event';
+        config: CronTriggerConfig | WebhookTriggerConfig | EventTriggerConfig;
+    }[]): Promise<string[]>;
+    /**
+     * Get trigger stats
+     */
+    getStats(): Promise<{
+        total: number;
+        enabled: number;
+        byType: Record<string, number>;
+        totalFired: number;
+        totalErrors: number;
+    }>;
+    /**
+     * Dispose the manager
+     */
+    dispose(): void;
+    private registerEventTrigger;
+}
+/**
+ * Create a trigger manager
+ */
+export declare function createTriggerManager(config?: TriggerManagerConfig): DefaultTriggerManager;
+/**
+ * Helper to create a cron trigger config
+ */
+export declare function cronTrigger(expression: string, options?: Partial<Omit<CronTriggerConfig, 'expression'>>): CronTriggerConfig;
+/**
+ * Helper to create a webhook trigger config
+ */
+export declare function webhookTrigger(path: string, method?: WebhookTriggerConfig['method'], options?: Partial<Omit<WebhookTriggerConfig, 'path' | 'method'>>): WebhookTriggerConfig;
+/**
+ * Helper to create an event trigger config
+ */
+export declare function eventTrigger(eventType: string, options?: Partial<Omit<EventTriggerConfig, 'eventType'>>): EventTriggerConfig;
+//# sourceMappingURL=trigger-manager.d.ts.map

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

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