@classytic/arc 2.10.3 → 2.11.0

package/dist/integrations/streamline.mjs

@@ -1,6 +1,49 @@
 //#region src/integrations/streamline.ts
+/**
+* Full event list published on a streamline workflow's internal `eventBus`
+* (tracks streamline 2.2's `EventPayloadMap` in
+* `@classytic/streamline/src/core/events.ts`).
+*
+* Hardcoded here by design — arc subscribes via structural
+* `eventBus.on(name, handler)`, which is a no-op for events the running
+* streamline version doesn't emit. New events a future streamline release
+* adds can be bridged by updating this list; arc never breaks just
+* because streamline extended its bus.
+*/
+const STREAMLINE_BUS_EVENTS = [
+	"step:started",
+	"step:completed",
+	"step:failed",
+	"step:waiting",
+	"step:skipped",
+	"step:retry-scheduled",
+	"step:compensated",
+	"workflow:started",
+	"workflow:completed",
+	"workflow:failed",
+	"workflow:waiting",
+	"workflow:resumed",
+	"workflow:cancelled",
+	"workflow:recovered",
+	"workflow:retry",
+	"workflow:compensating",
+	"engine:error",
+	"scheduler:error",
+	"scheduler:circuit-open"
+];
+/**
+* Workflow events that should auto-close an SSE stream when observed.
+* Recovered / waiting / resumed / retry / compensating are NOT terminal —
+* the run is still active after them.
+*/
+const STREAMLINE_TERMINAL_EVENTS = [
+	"workflow:completed",
+	"workflow:failed",
+	"workflow:cancelled"
+];
 const streamlinePluginImpl = async (fastify, options) => {
-	const { workflows, prefix = "/workflows", auth = true, bridgeEvents = true, bridgeStepEvents = false, enableStreaming = false, permissions: perms } = options;
+	const { workflows, prefix = "/workflows", auth = true, bridgeEvents = true, enableStreaming = false, permissions: perms } = options;
+	const bridgeBus = options.bridgeBusEvents ?? options.bridgeStepEvents ?? false;
 	const registry = /* @__PURE__ */ new Map();
 	for (const wf of workflows) {
 		const id = wf.definition.id;
@@ -148,13 +191,7 @@ const streamlinePluginImpl = async (fastify, options) => {
 				data: await wf.engine.rewindTo?.(runId, stepId)
 			};
 		});
-		if (bridgeStepEvents && wf.container?.eventBus && fastify.events?.publish) for (const eventName of [
-			"step:started",
-			"step:completed",
-			"step:failed",
-			"step:skipped",
-			"step:retry-scheduled"
-		]) wf.container.eventBus.on(eventName, (payload) => {
+		if (bridgeBus && wf.container?.eventBus && fastify.events?.publish) for (const eventName of STREAMLINE_BUS_EVENTS) wf.container.eventBus.on(eventName, (payload) => {
 			const p = payload;
 			fastify.events.publish(`workflow.${id}.${eventName}`, {
 				runId: p?.runId,
@@ -183,15 +220,7 @@ const streamlinePluginImpl = async (fastify, options) => {
 				"Cache-Control": "no-cache",
 				Connection: "keep-alive"
 			});
-			const events = [
-				"step:started",
-				"step:completed",
-				"step:failed",
-				"step:skipped",
-				"workflow:completed",
-				"workflow:failed",
-				"workflow:cancelled"
-			];
+			const terminalEvents = new Set(STREAMLINE_TERMINAL_EVENTS);
 			const listeners = [];
 			let closed = false;
 			const send = (event, data) => {
@@ -211,12 +240,12 @@ const streamlinePluginImpl = async (fastify, options) => {
 					reply.raw.end();
 				} catch {}
 			};
-			for (const eventName of events) {
+			for (const eventName of STREAMLINE_BUS_EVENTS) {
 				const fn = (payload) => {
 					const p = payload;
-					if (p?.runId !== runId) return;
+					if (typeof p?.runId === "string" && p.runId !== runId) return;
 					send(eventName, p);
-					if (eventName === "workflow:completed" || eventName === "workflow:failed" || eventName === "workflow:cancelled") cleanup();
+					if (terminalEvents.has(eventName) && p?.runId === runId) cleanup();
 				};
 				wf.container.eventBus.on(eventName, fn);
 				listeners.push({
@@ -244,4 +273,4 @@ const streamlinePluginImpl = async (fastify, options) => {
 /** Pluggable streamline integration for Arc */
 const streamlinePlugin = streamlinePluginImpl;
 //#endregion
-export { streamlinePlugin };
+export { STREAMLINE_BUS_EVENTS, STREAMLINE_TERMINAL_EVENTS, streamlinePlugin };

package/dist/integrations/websocket-redis.d.mts

@@ -1,4 +1,4 @@
-import { WebSocketAdapter } from "./websocket.mjs";
+import { c as WebSocketAdapter } from "../websocket-CyJ1VIFI.mjs";
 
 //#region src/integrations/websocket-redis.d.ts
 interface RedisLike {

package/dist/integrations/websocket.d.mts

@@ -1,154 +1,2 @@
-import { FastifyPluginAsync } from "fastify";
-
-//#region src/integrations/websocket.d.ts
-interface WebSocketClient {
-  id: string;
-  socket: {
-    send(data: string): void;
-    close(): void;
-    readyState: number;
-  };
-  subscriptions: Set<string>;
-  userId?: string;
-  organizationId?: string;
-  /** OAuth client ID — present for service/machine-to-machine connections */
-  clientId?: string;
-  /** OAuth scopes — present for service/machine-to-machine connections */
-  scopes?: readonly string[];
-  metadata?: Record<string, unknown>;
-}
-interface WebSocketMessage {
-  type: string;
-  resource?: string;
-  channel?: string;
-  data?: unknown;
-}
-interface WebSocketPluginOptions {
-  /** WebSocket endpoint path (default: '/ws') */
-  path?: string;
-  /** Require authentication for WebSocket connections (default: true) */
-  auth?: boolean;
-  /** Resources to auto-broadcast CRUD events for */
-  resources?: string[];
-  /** Heartbeat interval in ms (default: 30000). Set 0 to disable. */
-  heartbeatInterval?: number;
-  /** Custom authentication function for WebSocket upgrade */
-  authenticate?: (request: unknown) => Promise<{
-    userId?: string;
-    organizationId?: string; /** Set for machine-to-machine / service account auth */
-    clientId?: string; /** OAuth scopes for service accounts */
-    scopes?: readonly string[];
-  } | null>;
-  /** Max clients per resource subscription (default: 10000) */
-  maxClientsPerRoom?: number;
-  /**
-   * Expose a stats endpoint at `{path}/stats`.
-   * - `false` (default): stats endpoint is not registered
-   * - `true`: registered without auth
-   * - `'authenticated'`: guarded by `fastify.authenticate` if available
-   */
-  exposeStats?: boolean | "authenticated";
-  /**
-   * Authorize room subscriptions. Return true to allow, false to deny.
-   * Called before every subscribe. If not provided, all rooms are allowed.
-   */
-  roomPolicy?: (client: WebSocketClient, room: string) => boolean | Promise<boolean>;
-  /** Maximum message size in bytes from client (default: 16384 = 16KB). Messages exceeding this are dropped. */
-  maxMessageBytes?: number;
-  /** Maximum subscriptions per client (default: 100). Prevents resource exhaustion. */
-  maxSubscriptionsPerClient?: number;
-  /**
-   * Periodic re-authentication interval in ms (default: 0 = disabled).
-   * When set, the server periodically re-validates the client's auth token.
-   * If the token is expired/revoked, the client is disconnected with code 4003.
-   *
-   * Recommended: 300000 (5 minutes) for production.
-   *
-   * @example
-   * ```typescript
-   * websocketPlugin({ reauthInterval: 5 * 60 * 1000 }) // re-check every 5 min
-   * ```
-   */
-  reauthInterval?: number;
-  /** Custom message handler */
-  onMessage?: (client: WebSocketClient, message: WebSocketMessage) => void | Promise<void>;
-  /** Called when a client connects */
-  onConnect?: (client: WebSocketClient) => void | Promise<void>;
-  /** Called when a client disconnects */
-  onDisconnect?: (client: WebSocketClient) => void | Promise<void>;
-  /**
-   * Cross-instance broadcast adapter (default: LocalWebSocketAdapter — single-instance only).
-   * Provide a RedisWebSocketAdapter for multi-instance deployments.
-   *
-   * @example
-   * ```typescript
-   * import { RedisWebSocketAdapter } from '@classytic/arc/integrations/websocket';
-   * adapter: new RedisWebSocketAdapter(redis, { channel: 'arc-ws' })
-   * ```
-   */
-  adapter?: WebSocketAdapter;
-}
-/**
- * Adapter interface for cross-instance WebSocket broadcast.
- *
- * - `publish()`: Send a message to all instances (via Redis, NATS, etc.)
- * - `subscribe()`: Receive messages from other instances
- * - `close()`: Clean up connections
- *
- * The adapter is NOT used for local broadcasts — RoomManager handles those.
- * The adapter only handles the cross-instance relay.
- */
-interface WebSocketAdapter {
-  /** Adapter name for logging */
-  readonly name: string;
-  /** Publish a room broadcast to all other instances */
-  publish(room: string, message: string): Promise<void>;
-  /** Subscribe to broadcasts from other instances */
-  subscribe(callback: (room: string, message: string) => void): Promise<void>;
-  /** Close adapter connections */
-  close(): Promise<void>;
-}
-/**
- * Default adapter — no cross-instance broadcast (single-instance only).
- * All methods are no-ops. Used when no adapter is configured.
- */
-declare class LocalWebSocketAdapter implements WebSocketAdapter {
-  readonly name = "local";
-  publish(): Promise<void>;
-  subscribe(): Promise<void>;
-  close(): Promise<void>;
-}
-declare class RoomManager {
-  private rooms;
-  private clients;
-  private maxPerRoom;
-  private adapter?;
-  constructor(maxPerRoom?: number, adapter?: WebSocketAdapter);
-  addClient(client: WebSocketClient): void;
-  removeClient(clientId: string): void;
-  subscribe(clientId: string, room: string): boolean;
-  unsubscribe(clientId: string, room: string): void;
-  broadcast(room: string, message: string, excludeClientId?: string): void;
-  broadcastToOrg(organizationId: string, room: string, message: string): void;
-  /**
-   * Broadcast locally AND through adapter (for cross-instance delivery).
-   * Use this instead of broadcast() when multi-instance is possible.
-   */
-  broadcastWithAdapter(room: string, message: string, excludeClientId?: string): Promise<void>;
-  /**
-   * Org-scoped broadcast locally AND through adapter.
-   * Uses a namespaced room key for the adapter so other instances
-   * can filter by org when delivering locally.
-   */
-  broadcastToOrgWithAdapter(organizationId: string, room: string, message: string): Promise<void>;
-  getClient(clientId: string): WebSocketClient | undefined;
-  getStats(): {
-    clients: number;
-    rooms: number;
-    subscriptions: Record<string, number>;
-  };
-}
-/** Pluggable WebSocket integration for Arc */
-declare const websocketPlugin: FastifyPluginAsync<WebSocketPluginOptions>;
-//#endregion
-export { LocalWebSocketAdapter, RoomManager, WebSocketAdapter, WebSocketClient, WebSocketMessage, WebSocketPluginOptions, websocketPlugin };
+import { a as WebSocketMessage, c as WebSocketAdapter, i as WebSocketClient, n as websocketPlugin, o as WebSocketPluginOptions, r as AuthResult, s as LocalWebSocketAdapter, t as RoomManager } from "../websocket-CyJ1VIFI.mjs";
+export { AuthResult, LocalWebSocketAdapter, RoomManager, WebSocketAdapter, WebSocketClient, WebSocketMessage, WebSocketPluginOptions, websocketPlugin };