@invect/core 0.0.1

package/dist/services/execution-event-bus.d.cts

@@ -0,0 +1,57 @@
+import { FlowRun } from "./flow-runs/flow-runs.model.cjs";
+import { NodeExecution } from "./node-executions/node-executions.model.cjs";
+
+//#region src/services/execution-event-bus.d.ts
+type ExecutionSnapshotEvent = {
+  type: 'snapshot';
+  flowRun: FlowRun;
+  nodeExecutions: NodeExecution[];
+};
+type FlowRunUpdatedEvent = {
+  type: 'flow_run.updated';
+  flowRun: FlowRun;
+};
+type NodeExecutionCreatedEvent = {
+  type: 'node_execution.created';
+  nodeExecution: NodeExecution;
+};
+type NodeExecutionUpdatedEvent = {
+  type: 'node_execution.updated';
+  nodeExecution: NodeExecution;
+};
+type HeartbeatEvent = {
+  type: 'heartbeat';
+};
+type EndEvent = {
+  type: 'end';
+  flowRun: FlowRun;
+};
+type ExecutionStreamEvent = ExecutionSnapshotEvent | FlowRunUpdatedEvent | NodeExecutionCreatedEvent | NodeExecutionUpdatedEvent | HeartbeatEvent | EndEvent;
+/**
+ * Lightweight event bus scoped to flow-run IDs.
+ *
+ * Consumers call `subscribe(flowRunId, callback)` and receive all events for
+ * that run. Producers call `emitFlowRunUpdate`, `emitNodeExecutionCreate`, etc.
+ */
+declare class ExecutionEventBus {
+  private emitter;
+  constructor();
+  emitFlowRunUpdate(flowRun: FlowRun): void;
+  emitNodeExecutionCreate(nodeExecution: NodeExecution): void;
+  emitNodeExecutionUpdate(nodeExecution: NodeExecution): void;
+  /**
+   * Subscribe to events for a specific flow run.
+   * Returns an unsubscribe function.
+   */
+  subscribe(flowRunId: string, callback: (event: ExecutionStreamEvent) => void): () => void;
+  /**
+   * Subscribe to all run-level events for a specific flow (e.g. runs list updates).
+   */
+  subscribeFlow(flowId: string, callback: (event: ExecutionStreamEvent) => void): () => void;
+}
+declare function getExecutionEventBus(): ExecutionEventBus;
+/** Reset for tests */
+declare function resetExecutionEventBus(): void;
+//#endregion
+export { EndEvent, ExecutionEventBus, ExecutionSnapshotEvent, ExecutionStreamEvent, FlowRunUpdatedEvent, HeartbeatEvent, NodeExecutionCreatedEvent, NodeExecutionUpdatedEvent, getExecutionEventBus, resetExecutionEventBus };
+//# sourceMappingURL=execution-event-bus.d.cts.map

package/dist/services/execution-event-bus.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-event-bus.d.cts","names":[],"sources":["../../src/services/execution-event-bus.ts"],"mappings":";;;;KAeY,sBAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;EACT,cAAA,EAAgB,aAAA;AAAA;AAAA,KAGN,mBAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,yBAAA;EACV,IAAA;EACA,aAAA,EAAe,aAAA;AAAA;AAAA,KAGL,yBAAA;EACV,IAAA;EACA,aAAA,EAAe,aAAA;AAAA;AAAA,KAGL,cAAA;EACV,IAAA;AAAA;AAAA,KAGU,QAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,oBAAA,GACR,sBAAA,GACA,mBAAA,GACA,yBAAA,GACA,yBAAA,GACA,cAAA,GACA,QAAA;;;;;;;cAYS,iBAAA;EAAA,QACH,OAAA;;EASR,iBAAA,CAAkB,OAAA,EAAS,OAAA;EAQ3B,uBAAA,CAAwB,aAAA,EAAe,aAAA;EAQvC,uBAAA,CAAwB,aAAA,EAAe,aAAA;EAxDxB;;;AAGjB;EAmEE,SAAA,CAAU,SAAA,UAAmB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;EAW/C,aAAA,CAAc,MAAA,UAAgB,QAAA,GAAW,KAAA,EAAO,oBAAA;AAAA;AAAA,iBAelC,oBAAA,CAAA,GAAwB,iBAAA;;iBAQxB,sBAAA,CAAA"}

package/dist/services/execution-event-bus.d.ts

@@ -0,0 +1,57 @@
+import { FlowRun } from "./flow-runs/flow-runs.model.js";
+import { NodeExecution } from "./node-executions/node-executions.model.js";
+
+//#region src/services/execution-event-bus.d.ts
+type ExecutionSnapshotEvent = {
+  type: 'snapshot';
+  flowRun: FlowRun;
+  nodeExecutions: NodeExecution[];
+};
+type FlowRunUpdatedEvent = {
+  type: 'flow_run.updated';
+  flowRun: FlowRun;
+};
+type NodeExecutionCreatedEvent = {
+  type: 'node_execution.created';
+  nodeExecution: NodeExecution;
+};
+type NodeExecutionUpdatedEvent = {
+  type: 'node_execution.updated';
+  nodeExecution: NodeExecution;
+};
+type HeartbeatEvent = {
+  type: 'heartbeat';
+};
+type EndEvent = {
+  type: 'end';
+  flowRun: FlowRun;
+};
+type ExecutionStreamEvent = ExecutionSnapshotEvent | FlowRunUpdatedEvent | NodeExecutionCreatedEvent | NodeExecutionUpdatedEvent | HeartbeatEvent | EndEvent;
+/**
+ * Lightweight event bus scoped to flow-run IDs.
+ *
+ * Consumers call `subscribe(flowRunId, callback)` and receive all events for
+ * that run. Producers call `emitFlowRunUpdate`, `emitNodeExecutionCreate`, etc.
+ */
+declare class ExecutionEventBus {
+  private emitter;
+  constructor();
+  emitFlowRunUpdate(flowRun: FlowRun): void;
+  emitNodeExecutionCreate(nodeExecution: NodeExecution): void;
+  emitNodeExecutionUpdate(nodeExecution: NodeExecution): void;
+  /**
+   * Subscribe to events for a specific flow run.
+   * Returns an unsubscribe function.
+   */
+  subscribe(flowRunId: string, callback: (event: ExecutionStreamEvent) => void): () => void;
+  /**
+   * Subscribe to all run-level events for a specific flow (e.g. runs list updates).
+   */
+  subscribeFlow(flowId: string, callback: (event: ExecutionStreamEvent) => void): () => void;
+}
+declare function getExecutionEventBus(): ExecutionEventBus;
+/** Reset for tests */
+declare function resetExecutionEventBus(): void;
+//#endregion
+export { EndEvent, ExecutionEventBus, ExecutionSnapshotEvent, ExecutionStreamEvent, FlowRunUpdatedEvent, HeartbeatEvent, NodeExecutionCreatedEvent, NodeExecutionUpdatedEvent, getExecutionEventBus, resetExecutionEventBus };
+//# sourceMappingURL=execution-event-bus.d.ts.map

package/dist/services/execution-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-event-bus.d.ts","names":[],"sources":["../../src/services/execution-event-bus.ts"],"mappings":";;;;KAeY,sBAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;EACT,cAAA,EAAgB,aAAA;AAAA;AAAA,KAGN,mBAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,yBAAA;EACV,IAAA;EACA,aAAA,EAAe,aAAA;AAAA;AAAA,KAGL,yBAAA;EACV,IAAA;EACA,aAAA,EAAe,aAAA;AAAA;AAAA,KAGL,cAAA;EACV,IAAA;AAAA;AAAA,KAGU,QAAA;EACV,IAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,oBAAA,GACR,sBAAA,GACA,mBAAA,GACA,yBAAA,GACA,yBAAA,GACA,cAAA,GACA,QAAA;;;;;;;cAYS,iBAAA;EAAA,QACH,OAAA;;EASR,iBAAA,CAAkB,OAAA,EAAS,OAAA;EAQ3B,uBAAA,CAAwB,aAAA,EAAe,aAAA;EAQvC,uBAAA,CAAwB,aAAA,EAAe,aAAA;EAxDxB;;;AAGjB;EAmEE,SAAA,CAAU,SAAA,UAAmB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;EAW/C,aAAA,CAAc,MAAA,UAAgB,QAAA,GAAW,KAAA,EAAO,oBAAA;AAAA;AAAA,iBAelC,oBAAA,CAAA,GAAwB,iBAAA;;iBAQxB,sBAAA,CAAA"}

package/dist/services/execution-event-bus.js

@@ -0,0 +1,77 @@
+import { EventEmitter } from "events";
+//#region src/services/execution-event-bus.ts
+/**
+* Execution Event Bus
+*
+* In-process pub/sub for flow-run and node-execution state changes.
+* Services emit events when they write to the database; SSE endpoints
+* subscribe per flow-run ID and forward events to connected clients.
+*/
+/**
+* Lightweight event bus scoped to flow-run IDs.
+*
+* Consumers call `subscribe(flowRunId, callback)` and receive all events for
+* that run. Producers call `emitFlowRunUpdate`, `emitNodeExecutionCreate`, etc.
+*/
+var ExecutionEventBus = class {
+	emitter = new EventEmitter();
+	constructor() {
+		this.emitter.setMaxListeners(0);
+	}
+	emitFlowRunUpdate(flowRun) {
+		const event = {
+			type: "flow_run.updated",
+			flowRun
+		};
+		this.emitter.emit(`run:${flowRun.id}`, event);
+		this.emitter.emit(`flow:${flowRun.flowId}`, event);
+	}
+	emitNodeExecutionCreate(nodeExecution) {
+		const event = {
+			type: "node_execution.created",
+			nodeExecution
+		};
+		this.emitter.emit(`run:${nodeExecution.flowRunId}`, event);
+	}
+	emitNodeExecutionUpdate(nodeExecution) {
+		const event = {
+			type: "node_execution.updated",
+			nodeExecution
+		};
+		this.emitter.emit(`run:${nodeExecution.flowRunId}`, event);
+	}
+	/**
+	* Subscribe to events for a specific flow run.
+	* Returns an unsubscribe function.
+	*/
+	subscribe(flowRunId, callback) {
+		const channel = `run:${flowRunId}`;
+		this.emitter.on(channel, callback);
+		return () => {
+			this.emitter.off(channel, callback);
+		};
+	}
+	/**
+	* Subscribe to all run-level events for a specific flow (e.g. runs list updates).
+	*/
+	subscribeFlow(flowId, callback) {
+		const channel = `flow:${flowId}`;
+		this.emitter.on(channel, callback);
+		return () => {
+			this.emitter.off(channel, callback);
+		};
+	}
+};
+let globalBus = null;
+function getExecutionEventBus() {
+	if (!globalBus) globalBus = new ExecutionEventBus();
+	return globalBus;
+}
+/** Reset for tests */
+function resetExecutionEventBus() {
+	globalBus = null;
+}
+//#endregion
+export { ExecutionEventBus, getExecutionEventBus, resetExecutionEventBus };
+
+//# sourceMappingURL=execution-event-bus.js.map

package/dist/services/execution-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-event-bus.js","names":[],"sources":["../../src/services/execution-event-bus.ts"],"sourcesContent":["/**\n * Execution Event Bus\n *\n * In-process pub/sub for flow-run and node-execution state changes.\n * Services emit events when they write to the database; SSE endpoints\n * subscribe per flow-run ID and forward events to connected clients.\n */\nimport { EventEmitter } from 'events';\nimport type { FlowRun } from './flow-runs/flow-runs.model';\nimport type { NodeExecution } from './node-executions/node-executions.model';\n\n// ---------------------------------------------------------------------------\n// Event types\n// ---------------------------------------------------------------------------\n\nexport type ExecutionSnapshotEvent = {\n  type: 'snapshot';\n  flowRun: FlowRun;\n  nodeExecutions: NodeExecution[];\n};\n\nexport type FlowRunUpdatedEvent = {\n  type: 'flow_run.updated';\n  flowRun: FlowRun;\n};\n\nexport type NodeExecutionCreatedEvent = {\n  type: 'node_execution.created';\n  nodeExecution: NodeExecution;\n};\n\nexport type NodeExecutionUpdatedEvent = {\n  type: 'node_execution.updated';\n  nodeExecution: NodeExecution;\n};\n\nexport type HeartbeatEvent = {\n  type: 'heartbeat';\n};\n\nexport type EndEvent = {\n  type: 'end';\n  flowRun: FlowRun;\n};\n\nexport type ExecutionStreamEvent =\n  | ExecutionSnapshotEvent\n  | FlowRunUpdatedEvent\n  | NodeExecutionCreatedEvent\n  | NodeExecutionUpdatedEvent\n  | HeartbeatEvent\n  | EndEvent;\n\n// ---------------------------------------------------------------------------\n// Bus implementation\n// ---------------------------------------------------------------------------\n\n/**\n * Lightweight event bus scoped to flow-run IDs.\n *\n * Consumers call `subscribe(flowRunId, callback)` and receive all events for\n * that run. Producers call `emitFlowRunUpdate`, `emitNodeExecutionCreate`, etc.\n */\nexport class ExecutionEventBus {\n  private emitter = new EventEmitter();\n\n  constructor() {\n    // Allow many concurrent SSE listeners per flow-run\n    this.emitter.setMaxListeners(0);\n  }\n\n  // ---- emit helpers -------------------------------------------------------\n\n  emitFlowRunUpdate(flowRun: FlowRun): void {\n    const event: FlowRunUpdatedEvent = { type: 'flow_run.updated', flowRun };\n    this.emitter.emit(`run:${flowRun.id}`, event);\n\n    // Also emit on the flow-level channel so the runs-list can update\n    this.emitter.emit(`flow:${flowRun.flowId}`, event);\n  }\n\n  emitNodeExecutionCreate(nodeExecution: NodeExecution): void {\n    const event: NodeExecutionCreatedEvent = {\n      type: 'node_execution.created',\n      nodeExecution,\n    };\n    this.emitter.emit(`run:${nodeExecution.flowRunId}`, event);\n  }\n\n  emitNodeExecutionUpdate(nodeExecution: NodeExecution): void {\n    const event: NodeExecutionUpdatedEvent = {\n      type: 'node_execution.updated',\n      nodeExecution,\n    };\n    this.emitter.emit(`run:${nodeExecution.flowRunId}`, event);\n  }\n\n  // ---- subscription -------------------------------------------------------\n\n  /**\n   * Subscribe to events for a specific flow run.\n   * Returns an unsubscribe function.\n   */\n  subscribe(flowRunId: string, callback: (event: ExecutionStreamEvent) => void): () => void {\n    const channel = `run:${flowRunId}`;\n    this.emitter.on(channel, callback);\n    return () => {\n      this.emitter.off(channel, callback);\n    };\n  }\n\n  /**\n   * Subscribe to all run-level events for a specific flow (e.g. runs list updates).\n   */\n  subscribeFlow(flowId: string, callback: (event: ExecutionStreamEvent) => void): () => void {\n    const channel = `flow:${flowId}`;\n    this.emitter.on(channel, callback);\n    return () => {\n      this.emitter.off(channel, callback);\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Singleton\n// ---------------------------------------------------------------------------\n\nlet globalBus: ExecutionEventBus | null = null;\n\nexport function getExecutionEventBus(): ExecutionEventBus {\n  if (!globalBus) {\n    globalBus = new ExecutionEventBus();\n  }\n  return globalBus;\n}\n\n/** Reset for tests */\nexport function resetExecutionEventBus(): void {\n  globalBus = null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+DA,IAAa,oBAAb,MAA+B;CAC7B,UAAkB,IAAI,cAAc;CAEpC,cAAc;AAEZ,OAAK,QAAQ,gBAAgB,EAAE;;CAKjC,kBAAkB,SAAwB;EACxC,MAAM,QAA6B;GAAE,MAAM;GAAoB;GAAS;AACxE,OAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,MAAM;AAG7C,OAAK,QAAQ,KAAK,QAAQ,QAAQ,UAAU,MAAM;;CAGpD,wBAAwB,eAAoC;EAC1D,MAAM,QAAmC;GACvC,MAAM;GACN;GACD;AACD,OAAK,QAAQ,KAAK,OAAO,cAAc,aAAa,MAAM;;CAG5D,wBAAwB,eAAoC;EAC1D,MAAM,QAAmC;GACvC,MAAM;GACN;GACD;AACD,OAAK,QAAQ,KAAK,OAAO,cAAc,aAAa,MAAM;;;;;;CAS5D,UAAU,WAAmB,UAA6D;EACxF,MAAM,UAAU,OAAO;AACvB,OAAK,QAAQ,GAAG,SAAS,SAAS;AAClC,eAAa;AACX,QAAK,QAAQ,IAAI,SAAS,SAAS;;;;;;CAOvC,cAAc,QAAgB,UAA6D;EACzF,MAAM,UAAU,QAAQ;AACxB,OAAK,QAAQ,GAAG,SAAS,SAAS;AAClC,eAAa;AACX,QAAK,QAAQ,IAAI,SAAS,SAAS;;;;AASzC,IAAI,YAAsC;AAE1C,SAAgB,uBAA0C;AACxD,KAAI,CAAC,UACH,aAAY,IAAI,mBAAmB;AAErC,QAAO;;;AAIT,SAAgB,yBAA+B;AAC7C,aAAY"}