@cogitator-ai/workflows 0.1.0

package/dist/triggers/trigger-manager.js

@@ -0,0 +1,436 @@
+/**
+ * Trigger Manager
+ *
+ * Central management for all workflow triggers (cron, webhook, event).
+ * Coordinates trigger registration, firing, and lifecycle.
+ */
+import { nanoid } from 'nanoid';
+import { createCronTrigger } from './cron-trigger';
+import { createWebhookTrigger } from './webhook-trigger';
+/**
+ * In-memory trigger store
+ */
+export class InMemoryTriggerStore {
+    triggers = new Map();
+    async save(trigger) {
+        this.triggers.set(trigger.id, { ...trigger });
+    }
+    async get(id) {
+        return this.triggers.get(id) ?? null;
+    }
+    async update(id, updates) {
+        const existing = this.triggers.get(id);
+        if (existing) {
+            this.triggers.set(id, { ...existing, ...updates });
+        }
+    }
+    async delete(id) {
+        this.triggers.delete(id);
+    }
+    async list(workflowName) {
+        const all = Array.from(this.triggers.values());
+        if (workflowName) {
+            return all.filter(t => t.workflowName === workflowName);
+        }
+        return all;
+    }
+    async listEnabled() {
+        return Array.from(this.triggers.values()).filter(t => t.enabled);
+    }
+    async listByType(type) {
+        return Array.from(this.triggers.values()).filter(t => t.type === type);
+    }
+    clear() {
+        this.triggers.clear();
+    }
+}
+/**
+ * Simple event emitter implementation
+ */
+export class SimpleTriggerEventEmitter {
+    listeners = new Map();
+    emit(eventType, payload) {
+        const callbacks = this.listeners.get(eventType);
+        if (callbacks) {
+            for (const callback of callbacks) {
+                try {
+                    callback(payload);
+                }
+                catch {
+                }
+            }
+        }
+    }
+    on(eventType, callback) {
+        let callbacks = this.listeners.get(eventType);
+        if (!callbacks) {
+            callbacks = new Set();
+            this.listeners.set(eventType, callbacks);
+        }
+        callbacks.add(callback);
+        return () => {
+            callbacks?.delete(callback);
+            if (callbacks?.size === 0) {
+                this.listeners.delete(eventType);
+            }
+        };
+    }
+    clear() {
+        this.listeners.clear();
+    }
+}
+/**
+ * Default trigger manager implementation
+ */
+export class DefaultTriggerManager {
+    store;
+    eventEmitter;
+    cronExecutor;
+    webhookExecutor;
+    triggerCallbacks = new Set();
+    eventListeners = new Map();
+    _started = false;
+    constructor(config = {}) {
+        this.store = config.store ?? new InMemoryTriggerStore();
+        this.eventEmitter = config.eventEmitter ?? new SimpleTriggerEventEmitter();
+        const onFire = async (trigger, context) => {
+            for (const callback of this.triggerCallbacks) {
+                try {
+                    callback(trigger, context);
+                }
+                catch {
+                }
+            }
+            await this.store.update(trigger.id, {
+                lastTriggered: context.timestamp,
+                triggerCount: trigger.triggerCount + 1,
+            });
+            if (config.onTriggerFire) {
+                return config.onTriggerFire(trigger, context);
+            }
+            return nanoid();
+        };
+        this.cronExecutor = createCronTrigger({ onFire });
+        this.webhookExecutor = createWebhookTrigger({ onFire });
+    }
+    /**
+     * Start the trigger manager
+     */
+    start() {
+        this._started = true;
+    }
+    /**
+     * Stop the trigger manager
+     */
+    stop() {
+        this._started = false;
+        this.cronExecutor.dispose();
+        this.webhookExecutor.dispose();
+    }
+    /**
+     * Check if the manager is running
+     */
+    get isRunning() {
+        return this._started;
+    }
+    /**
+     * Register a trigger
+     */
+    async register(trigger) {
+        const id = nanoid();
+        const now = Date.now();
+        const fullTrigger = {
+            ...trigger,
+            id,
+            createdAt: now,
+            triggerCount: 0,
+            errorCount: 0,
+        };
+        await this.store.save(fullTrigger);
+        switch (trigger.type) {
+            case 'cron': {
+                const config = trigger.config;
+                this.cronExecutor.register(trigger.workflowName, config, id);
+                break;
+            }
+            case 'webhook': {
+                const config = trigger.config;
+                this.webhookExecutor.register(trigger.workflowName, config, id);
+                break;
+            }
+            case 'event': {
+                const config = trigger.config;
+                this.registerEventTrigger(id, trigger.workflowName, config);
+                break;
+            }
+        }
+        return id;
+    }
+    /**
+     * Unregister a trigger
+     */
+    async unregister(id) {
+        const trigger = await this.store.get(id);
+        if (!trigger)
+            return;
+        switch (trigger.type) {
+            case 'cron':
+                this.cronExecutor.unregister(id);
+                break;
+            case 'webhook':
+                this.webhookExecutor.unregister(id);
+                break;
+            case 'event': {
+                const unsubscribe = this.eventListeners.get(id);
+                if (unsubscribe) {
+                    unsubscribe();
+                    this.eventListeners.delete(id);
+                }
+                break;
+            }
+        }
+        await this.store.delete(id);
+    }
+    /**
+     * Enable a trigger
+     */
+    async enable(id) {
+        const trigger = await this.store.get(id);
+        if (!trigger)
+            throw new Error(`Trigger not found: ${id}`);
+        await this.store.update(id, { enabled: true });
+        switch (trigger.type) {
+            case 'cron':
+                this.cronExecutor.enable(id);
+                break;
+            case 'webhook':
+                this.webhookExecutor.enable(id);
+                break;
+            case 'event':
+                this.registerEventTrigger(id, trigger.workflowName, trigger.config);
+                break;
+        }
+    }
+    /**
+     * Disable a trigger
+     */
+    async disable(id) {
+        const trigger = await this.store.get(id);
+        if (!trigger)
+            throw new Error(`Trigger not found: ${id}`);
+        await this.store.update(id, { enabled: false });
+        switch (trigger.type) {
+            case 'cron':
+                this.cronExecutor.disable(id);
+                break;
+            case 'webhook':
+                this.webhookExecutor.disable(id);
+                break;
+            case 'event': {
+                const unsubscribe = this.eventListeners.get(id);
+                if (unsubscribe) {
+                    unsubscribe();
+                    this.eventListeners.delete(id);
+                }
+                break;
+            }
+        }
+    }
+    /**
+     * Get a trigger
+     */
+    async get(id) {
+        return this.store.get(id);
+    }
+    /**
+     * List triggers
+     */
+    async list(workflowName) {
+        return this.store.list(workflowName);
+    }
+    /**
+     * List enabled triggers
+     */
+    async listEnabled() {
+        return this.store.listEnabled();
+    }
+    /**
+     * Manually fire a trigger
+     */
+    async fire(id, partialContext) {
+        const trigger = await this.store.get(id);
+        if (!trigger)
+            throw new Error(`Trigger not found: ${id}`);
+        const context = {
+            triggerId: id,
+            triggerType: partialContext?.triggerType ?? 'manual',
+            timestamp: Date.now(),
+            ...partialContext,
+        };
+        for (const callback of this.triggerCallbacks) {
+            try {
+                callback(trigger, context);
+            }
+            catch {
+            }
+        }
+        await this.store.update(id, {
+            lastTriggered: context.timestamp,
+            triggerCount: trigger.triggerCount + 1,
+        });
+        return nanoid();
+    }
+    /**
+     * Subscribe to trigger events
+     */
+    onTrigger(callback) {
+        this.triggerCallbacks.add(callback);
+        return () => {
+            this.triggerCallbacks.delete(callback);
+        };
+    }
+    /**
+     * Handle incoming webhook request
+     */
+    async handleWebhook(request) {
+        return this.webhookExecutor.handle(request);
+    }
+    /**
+     * Emit an event (for event triggers)
+     */
+    emitEvent(eventType, payload) {
+        this.eventEmitter.emit(eventType, payload);
+    }
+    /**
+     * Register a workflow with triggers
+     */
+    async registerWorkflow(workflow, triggers) {
+        const ids = [];
+        for (const trigger of triggers) {
+            const id = await this.register({
+                workflowName: workflow.name,
+                type: trigger.type,
+                config: trigger.config,
+                enabled: true,
+            });
+            ids.push(id);
+        }
+        return ids;
+    }
+    /**
+     * Get trigger stats
+     */
+    async getStats() {
+        const all = await this.store.list();
+        const enabled = all.filter(t => t.enabled);
+        const byType = { cron: 0, webhook: 0, event: 0 };
+        let totalFired = 0;
+        let totalErrors = 0;
+        for (const trigger of all) {
+            byType[trigger.type] = (byType[trigger.type] ?? 0) + 1;
+            totalFired += trigger.triggerCount;
+            totalErrors += trigger.errorCount;
+        }
+        return {
+            total: all.length,
+            enabled: enabled.length,
+            byType,
+            totalFired,
+            totalErrors,
+        };
+    }
+    /**
+     * Dispose the manager
+     */
+    dispose() {
+        this.stop();
+        this.triggerCallbacks.clear();
+        for (const unsubscribe of this.eventListeners.values()) {
+            unsubscribe();
+        }
+        this.eventListeners.clear();
+        if (this.eventEmitter instanceof SimpleTriggerEventEmitter) {
+            this.eventEmitter.clear();
+        }
+    }
+    registerEventTrigger(id, _workflowName, config) {
+        const existing = this.eventListeners.get(id);
+        if (existing) {
+            existing();
+        }
+        const unsubscribe = this.eventEmitter.on(config.eventType, async (payload) => {
+            if (config.source) {
+                const eventSource = payload?.source;
+                if (eventSource !== config.source)
+                    return;
+            }
+            if (config.filter && !config.filter(payload)) {
+                return;
+            }
+            const transformedPayload = config.transform
+                ? config.transform(payload)
+                : payload;
+            const trigger = await this.store.get(id);
+            if (!trigger?.enabled)
+                return;
+            const context = {
+                triggerId: id,
+                triggerType: 'event',
+                timestamp: Date.now(),
+                payload: transformedPayload,
+                metadata: {
+                    eventType: config.eventType,
+                    source: config.source,
+                },
+            };
+            for (const callback of this.triggerCallbacks) {
+                try {
+                    callback(trigger, context);
+                }
+                catch {
+                }
+            }
+            await this.store.update(id, {
+                lastTriggered: context.timestamp,
+                triggerCount: trigger.triggerCount + 1,
+            });
+        });
+        this.eventListeners.set(id, unsubscribe);
+    }
+}
+/**
+ * Create a trigger manager
+ */
+export function createTriggerManager(config = {}) {
+    return new DefaultTriggerManager(config);
+}
+/**
+ * Helper to create a cron trigger config
+ */
+export function cronTrigger(expression, options = {}) {
+    return {
+        expression,
+        enabled: true,
+        ...options,
+    };
+}
+/**
+ * Helper to create a webhook trigger config
+ */
+export function webhookTrigger(path, method = 'POST', options = {}) {
+    return {
+        path,
+        method,
+        ...options,
+    };
+}
+/**
+ * Helper to create an event trigger config
+ */
+export function eventTrigger(eventType, options = {}) {
+    return {
+        eventType,
+        ...options,
+    };
+}
+//# sourceMappingURL=trigger-manager.js.map

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

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

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

@@ -0,0 +1,150 @@
+/**
+ * Webhook Trigger
+ *
+ * HTTP-based workflow triggers with authentication,
+ * rate limiting, payload validation, and deduplication.
+ */
+import type { WebhookTriggerConfig, TriggerContext, WorkflowTrigger } from '@cogitator-ai/types';
+/**
+ * Incoming webhook request
+ */
+export interface WebhookRequest {
+    method: string;
+    path: string;
+    headers: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    query?: Record<string, string>;
+    ip?: string;
+}
+/**
+ * Webhook response
+ */
+export interface WebhookResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+/**
+ * Webhook trigger state
+ */
+export interface WebhookTriggerState {
+    triggerId: string;
+    workflowName: string;
+    config: WebhookTriggerConfig;
+    triggerCount: number;
+    errorCount: number;
+    lastTriggered?: number;
+    lastError?: string;
+    enabled: boolean;
+    createdAt: number;
+}
+/**
+ * Webhook handler result
+ */
+export interface WebhookHandlerResult {
+    triggered: boolean;
+    runId?: string;
+    response: WebhookResponse;
+}
+/**
+ * Authentication error
+ */
+export declare class WebhookAuthError extends Error {
+    constructor(message: string);
+}
+/**
+ * Rate limit error
+ */
+export declare class WebhookRateLimitError extends Error {
+    readonly retryAfter: number;
+    readonly remaining: number;
+    readonly resetAt: number;
+    constructor(retryAfter: number, remaining: number, resetAt: number);
+}
+/**
+ * Webhook trigger executor
+ */
+export declare class WebhookTriggerExecutor {
+    private triggers;
+    private triggersByPath;
+    private rateLimiters;
+    private deduplicationCache;
+    private cleanupInterval?;
+    private onFire?;
+    constructor(options?: {
+        onFire?: (trigger: WorkflowTrigger, context: TriggerContext) => Promise<string>;
+        cleanupIntervalMs?: number;
+    });
+    /**
+     * Register a webhook trigger
+     */
+    register(workflowName: string, config: WebhookTriggerConfig, externalId?: string): string;
+    /**
+     * Unregister a trigger
+     */
+    unregister(triggerId: string): void;
+    /**
+     * Enable a trigger
+     */
+    enable(triggerId: string): void;
+    /**
+     * Disable a trigger
+     */
+    disable(triggerId: string): void;
+    /**
+     * Handle an incoming webhook request
+     */
+    handle(request: WebhookRequest): Promise<WebhookHandlerResult | null>;
+    /**
+     * Handle a specific trigger
+     */
+    handleTrigger(state: WebhookTriggerState, request: WebhookRequest): Promise<WebhookHandlerResult>;
+    /**
+     * Get trigger state
+     */
+    getState(triggerId: string): WebhookTriggerState | undefined;
+    /**
+     * Get all triggers for a workflow
+     */
+    getTriggersForWorkflow(workflowName: string): WebhookTriggerState[];
+    /**
+     * Get all enabled triggers
+     */
+    getEnabledTriggers(): WebhookTriggerState[];
+    /**
+     * Get all triggers
+     */
+    getAll(): WebhookTriggerState[];
+    /**
+     * Get registered paths
+     */
+    getRegisteredPaths(): {
+        path: string;
+        method: string;
+        triggerId: string;
+    }[];
+    /**
+     * Dispose the executor
+     */
+    dispose(): void;
+    private authenticate;
+    private checkRateLimit;
+    private isDuplicate;
+    private cleanupDeduplicationCache;
+    private normalizePathKey;
+    private getClientKey;
+    private getHeader;
+    private normalizeHeaders;
+    private toWorkflowTrigger;
+}
+/**
+ * Create a webhook trigger executor
+ */
+export declare function createWebhookTrigger(options?: {
+    onFire?: (trigger: WorkflowTrigger, context: TriggerContext) => Promise<string>;
+}): WebhookTriggerExecutor;
+/**
+ * Validate a webhook trigger config
+ */
+export declare function validateWebhookTriggerConfig(config: WebhookTriggerConfig): string[];
+//# sourceMappingURL=webhook-trigger.d.ts.map

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

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