@marktoflow/core 2.0.4 → 2.0.5

package/dist/event-source.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Event sources for event-driven workflows.
+ *
+ * Provides persistent connections to external services (Discord, Slack, WebSocket, etc.)
+ * that emit events to trigger workflow steps or restart workflows.
+ *
+ * Event sources:
+ * - websocket: Connect to any WebSocket endpoint
+ * - discord: Listen for Discord events via bot gateway
+ * - slack: Listen for Slack events via Socket Mode
+ * - cron: Emit events on a schedule (wraps the existing scheduler)
+ * - http-stream: SSE (Server-Sent Events) listener
+ * - rss: Poll RSS/Atom feeds for new items
+ */
+import { EventEmitter } from "node:events";
+export interface EventSourceEvent {
+    /** Source identifier (e.g., "discord", "slack", "websocket") */
+    source: string;
+    /** Event type (e.g., "message", "reaction", "connected", "disconnected") */
+    type: string;
+    /** Event payload (source-specific) */
+    data: Record<string, unknown>;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Raw event data (for debugging) */
+    raw?: unknown;
+}
+export interface EventSourceConfig {
+    /** Source type */
+    kind: "websocket" | "discord" | "slack" | "cron" | "http-stream" | "rss";
+    /** Unique id for this source */
+    id: string;
+    /** Source-specific configuration */
+    options: Record<string, unknown>;
+    /** Optional filter: only emit events matching these types */
+    filter?: string[];
+    /** Reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Reconnect delay in ms (default: 5000) */
+    reconnectDelay?: number;
+    /** Max reconnect attempts (default: Infinity) */
+    maxReconnectAttempts?: number;
+}
+export type EventSourceStatus = "disconnected" | "connecting" | "connected" | "error" | "stopped";
+export interface EventSourceStats {
+    id: string;
+    kind: string;
+    status: EventSourceStatus;
+    eventsReceived: number;
+    lastEventAt?: string | undefined;
+    connectedAt?: string | undefined;
+    reconnectAttempts: number;
+}
+export declare abstract class BaseEventSource extends EventEmitter {
+    readonly id: string;
+    readonly kind: string;
+    protected config: EventSourceConfig;
+    protected _status: EventSourceStatus;
+    protected _eventsReceived: number;
+    protected _lastEventAt: string | undefined;
+    protected _connectedAt: string | undefined;
+    protected _reconnectAttempts: number;
+    private _reconnectTimer;
+    constructor(config: EventSourceConfig);
+    get status(): EventSourceStatus;
+    get stats(): EventSourceStats;
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+    /** Emit an event through the source */
+    protected emitEvent(type: string, data: Record<string, unknown>, raw?: unknown): void;
+    /** Handle disconnection with optional reconnect */
+    protected handleDisconnect(reason?: string): void;
+    /** Stop the source (no reconnect) */
+    stop(): Promise<void>;
+}
+export declare class WebSocketEventSource extends BaseEventSource {
+    private ws;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Send a message through the WebSocket */
+    send(data: string | Record<string, unknown>): void;
+}
+/**
+ * Discord event source via the Discord Gateway (WebSocket).
+ * Uses the Discord Bot Gateway API directly — no external library needed.
+ *
+ * Required options:
+ * - token: Discord bot token
+ * - intents: Gateway intents bitmask (e.g., 513 for GUILDS + GUILD_MESSAGES)
+ *
+ * Optional:
+ * - filter: Array of event types to listen for (e.g., ["MESSAGE_CREATE"])
+ */
+export declare class DiscordEventSource extends BaseEventSource {
+    private ws;
+    private heartbeatInterval;
+    private lastSequence;
+    private sessionId;
+    private resumeGatewayUrl;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+/**
+ * Slack event source via Socket Mode (WebSocket).
+ *
+ * Required options:
+ * - appToken: Slack app-level token (xapp-...)
+ *
+ * Optional:
+ * - filter: Array of event types (e.g., ["message", "reaction_added"])
+ */
+export declare class SlackEventSource extends BaseEventSource {
+    private ws;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+/**
+ * Cron event source — emits events on a schedule.
+ *
+ * Options:
+ * - schedule: Cron expression or interval string (e.g., "30m", "1h")
+ * - payload: Optional static payload to include with each event
+ */
+export declare class CronEventSource extends BaseEventSource {
+    private timer;
+    private intervalMs;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private tick;
+}
+/**
+ * HTTP Server-Sent Events listener.
+ *
+ * Options:
+ * - url: SSE endpoint URL
+ * - headers: Optional headers
+ */
+export declare class SSEEventSource extends BaseEventSource {
+    private controller;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+/**
+ * RSS/Atom feed event source — polls a feed and emits events for new items.
+ *
+ * Options:
+ * - url: Feed URL (required)
+ * - interval: Polling interval as duration string (default: "5m")
+ * - immediate: Poll immediately on connect (default: false)
+ * - headers: Custom HTTP headers for feed requests
+ * - maxItems: Max new items to emit per poll (default: unlimited)
+ */
+export declare class RssEventSource extends BaseEventSource {
+    private timer;
+    private intervalMs;
+    private seenIds;
+    private firstPoll;
+    private static readonly MAX_SEEN_IDS;
+    constructor(config: EventSourceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private poll;
+}
+export declare function createEventSource(config: EventSourceConfig): BaseEventSource;
+/**
+ * Manages multiple event sources and provides a unified event stream.
+ */
+export declare class EventSourceManager extends EventEmitter {
+    private sources;
+    /** Add and connect an event source */
+    add(config: EventSourceConfig): Promise<BaseEventSource>;
+    /** Remove and disconnect an event source */
+    remove(id: string): Promise<void>;
+    /** Get a source by id */
+    get(id: string): BaseEventSource | undefined;
+    /** Get stats for all sources */
+    stats(): EventSourceStats[];
+    /** Wait for the next event from any source, with optional filter */
+    waitForEvent(options?: {
+        source?: string;
+        type?: string;
+        timeout?: number;
+        filter?: (event: EventSourceEvent) => boolean;
+    }): Promise<EventSourceEvent>;
+    /** Stop all sources */
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=event-source.d.ts.map

package/dist/event-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-source.d.ts","sourceRoot":"","sources":["../src/event-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC;IACzE,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAElG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID,8BAAsB,eAAgB,SAAQ,YAAY;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACpC,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAkB;IACtD,SAAS,CAAC,eAAe,SAAK;IAC9B,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,kBAAkB,SAAK;IACjC,OAAO,CAAC,eAAe,CAA4C;gBAEvD,MAAM,EAAE,iBAAiB;IAOrC,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,IAAI,KAAK,IAAI,gBAAgB,CAU5B;IAED,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC,uCAAuC;IACvC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI;IAgBrF,mDAAmD;IACnD,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BjD,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B;AAID,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,OAAO,CAAC,EAAE,CAAwB;gBAEtB,MAAM,EAAE,iBAAiB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,2CAA2C;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAOnD;AAID;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,gBAAgB,CAAqB;gBAEjC,MAAM,EAAE,iBAAiB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8FxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;CAMtB;AAID;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,OAAO,CAAC,EAAE,CAAwB;gBAEtB,MAAM,EAAE,iBAAiB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC;AAID;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,iBAAiB;IAK/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,OAAO,CAAC,IAAI;CAIb;AAID;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD,OAAO,CAAC,UAAU,CAA8B;gBAEpC,MAAM,EAAE,iBAAiB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0ExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAElC,MAAM,EAAE,iBAAiB;IAM/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,IAAI;CA0DnB;AAgFD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAiB5E;AAID;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,OAAO,CAA2C;IAE1D,sCAAsC;IAChC,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB9D,4CAA4C;IACtC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,yBAAyB;IACzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,gCAAgC;IAChC,KAAK,IAAI,gBAAgB,EAAE;IAI3B,oEAAoE;IACpE,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC;KAC/C,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB7B,uBAAuB;IACjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}