@trokky/trokky 2.0.3

package/dist/core/events/event-bus.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Trokky Event Bus Implementation
+ *
+ * Central event system that handles event emission, listener management,
+ * webhook dispatching, and event storage.
+ */
+import { EventEmitter } from 'events';
+import type { TrokkyEvent, EventListenerConfig, EventFilter, EventQueryResult, EventStorage, EventStats, WebhookConfig, WebhookDeliveryResult, WebhookStorage } from './types.js';
+/**
+ * Configuration options for the EventBus
+ */
+export interface EventBusConfig {
+    /** Maximum number of events to keep in memory */
+    maxHistorySize?: number;
+    /** Whether to store events persistently */
+    enablePersistence?: boolean;
+    /** Event storage adapter */
+    storage?: EventStorage;
+    /** Whether to enable webhook functionality */
+    enableWebhooks?: boolean;
+    /** Maximum number of concurrent webhook deliveries */
+    maxConcurrentWebhooks?: number;
+    /** Data storage adapter for webhook persistence (optional) */
+    dataStorage?: WebhookStorage;
+}
+/**
+ * Main EventBus class that orchestrates the entire event system
+ */
+export declare class TrokkyEventBus extends EventEmitter {
+    private config;
+    private logger;
+    private eventHistory;
+    private storage?;
+    private webhookRegistry;
+    private webhookDeliveries;
+    private dataStorage?;
+    private customListeners;
+    private stats;
+    constructor(config?: EventBusConfig);
+    /**
+     * Emit a Trokky event
+     */
+    emitEvent(event: Omit<TrokkyEvent, 'id' | 'timestamp'>): Promise<string>;
+    /**
+     * Emit a complete Trokky event (internal use)
+     */
+    emitFullEvent(event: TrokkyEvent): Promise<string>;
+    /**
+     * Add custom event listener
+     */
+    addCustomListener(config: Omit<EventListenerConfig, 'invocations'>): void;
+    /**
+     * Remove custom event listener
+     */
+    removeCustomListener(id: string): boolean;
+    /**
+     * Register a webhook
+     */
+    registerWebhook(config: Omit<WebhookConfig, 'createdAt' | 'updatedAt'>): Promise<void>;
+    /**
+     * Update a webhook
+     */
+    updateWebhook(id: string, updates: Partial<Omit<WebhookConfig, 'id' | 'createdAt' | 'updatedAt'>>): Promise<boolean>;
+    /**
+     * Remove a webhook
+     */
+    unregisterWebhook(id: string): Promise<boolean>;
+    /**
+     * Get all registered webhooks
+     */
+    getWebhooks(): WebhookConfig[];
+    /**
+     * Get webhook by ID
+     */
+    getWebhook(id: string): WebhookConfig | null;
+    /**
+     * Get webhook delivery history
+     */
+    getWebhookDeliveries(webhookId: string): WebhookDeliveryResult[];
+    /**
+     * Query events from memory history
+     */
+    queryEvents(filter?: EventFilter): TrokkyEvent[];
+    /**
+     * Query events from persistent storage (if available)
+     */
+    queryEventsFromStorage(filter?: EventFilter): Promise<EventQueryResult>;
+    /**
+     * Get event statistics
+     */
+    getEventStats(): Promise<EventStats & {
+        runtime: any;
+    }>;
+    /**
+     * Release the event storage. The bus itself holds no handles, but its storage may — the
+     * default `MemoryEventStorage` runs a cleanup interval that keeps the process alive — and
+     * the storage is private here, so the shutdown path needs this to reach it.
+     */
+    close(): Promise<void>;
+    private setupInternalHandlers;
+    private addToHistory;
+    private executeCustomListeners;
+    private shouldExecuteListener;
+    private dispatchWebhooks;
+    private shouldDispatchToWebhook;
+    private dispatchToWebhook;
+    private sendWebhookWithRetry;
+    private sendWebhookRequest;
+    private generateWebhookSignature;
+    private calculateRetryDelay;
+    private sleep;
+    private recordWebhookDelivery;
+    private matchesPattern;
+    private chunkArray;
+    private calculateMemoryStats;
+    /**
+     * Load webhooks from persistent storage into memory
+     */
+    private loadWebhooksFromStorage;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/events/event-bus.d.ts.map

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