@invect/core 0.0.1

package/dist/services/database/database.service.js

@@ -0,0 +1,469 @@
+import { DatabaseError } from "../../types/common/errors.types.js";
+import { DatabaseConnectionFactory } from "../../database/connection.js";
+import { CORE_SCHEMA } from "../../database/core-schema.js";
+import { verifySchema } from "../../database/schema-verification.js";
+import { FlowRunsModel } from "../flow-runs/flow-runs.model.js";
+import { FlowsModel } from "../flows/flows.model.js";
+import { BatchJobsModel } from "../batch-jobs/batch-jobs.model.js";
+import { FlowVersionsModel } from "../flow-versions/flow-versions.model.js";
+import { NodeExecutionsModel } from "../node-executions/node-executions.model.js";
+import { AgentToolExecutionsModel } from "../agent-tool-executions/agent-tool-executions.model.js";
+import { FlowTriggersModel } from "../triggers/flow-triggers.model.js";
+import { ChatMessagesModel } from "../chat/chat-messages.model.js";
+import { createAdapterFromConnection } from "../../database/adapters/connection-bridge.js";
+//#region src/services/database/database.service.ts
+/**
+* Core database service implementation
+*/
+var DatabaseService = class DatabaseService {
+	connection = null;
+	_database = null;
+	_adapter = null;
+	schemaVerificationOptions;
+	pluginTableRequirements = [];
+	constructor(hostDbConfig, logger = console, schemaVerification, plugins) {
+		this.hostDbConfig = hostDbConfig;
+		this.logger = logger;
+		this.schemaVerificationOptions = schemaVerification;
+		this.pluginTableRequirements = DatabaseService.extractPluginTableRequirements(plugins ?? []);
+	}
+	/**
+	* Get the Database instance with all model classes
+	*/
+	get database() {
+		if (!this._database) throw new DatabaseError("Database not initialized - call initialize() first");
+		return this._database;
+	}
+	/**
+	* Get the InvectAdapter instance for direct adapter access
+	*/
+	get adapter() {
+		if (!this._adapter) throw new DatabaseError("Database not initialized - call initialize() first");
+		return this._adapter;
+	}
+	/**
+	* Direct access to flows model
+	*/
+	get flows() {
+		return this.database.flows;
+	}
+	/**
+	* Direct access to flow versions model
+	*/
+	get flowVersions() {
+		return this.database.flowVersions;
+	}
+	/**
+	* Direct access to flow executions model
+	*/
+	get flowRuns() {
+		return this.database.flowRuns;
+	}
+	/**
+	* Direct access to execution traces model
+	*/
+	get nodeExecutions() {
+		return this.database.executionTraces;
+	}
+	/**
+	* Direct access to batch jobs model
+	*/
+	get batchJobs() {
+		return this.database.batchJobs;
+	}
+	/**
+	* Direct access to agent tool executions model
+	*/
+	get agentToolExecutions() {
+		return this.database.agentToolExecutions;
+	}
+	/**
+	* Direct access to flow triggers model
+	*/
+	get flowTriggers() {
+		return this.database.flowTriggers;
+	}
+	/**
+	* Direct access to chat messages model
+	*/
+	get chatMessages() {
+		return this.database.chatMessages;
+	}
+	/**
+	* Initialize the database connection and models
+	*/
+	async initialize() {
+		if (this.connection) {
+			this.logger.debug("Database connection already initialized");
+			return;
+		}
+		try {
+			this.connection = await DatabaseConnectionFactory.createHostDBConnection(this.hostDbConfig, this.logger);
+		} catch (error) {
+			this.logConnectionError(error);
+			throw new DatabaseError(`Failed to connect to the database: ${error instanceof Error ? error.message : error}`, {
+				error,
+				originalStack: error instanceof Error ? error.stack : void 0
+			});
+		}
+		try {
+			await this.runConnectivityCheck(this.connection);
+		} catch (error) {
+			this.logConnectivityError(error);
+			throw new DatabaseError(`Database connectivity check failed: ${error instanceof Error ? error.message : error}`, { error });
+		}
+		await this.runCoreTableCheck(this.connection);
+		await this.runPluginTableChecks(this.connection);
+		this._adapter = createAdapterFromConnection(this.connection);
+		this._database = new Database(this.connection, this.logger, this._adapter);
+		if (this.schemaVerificationOptions) await verifySchema(this.connection, this.logger, this.schemaVerificationOptions);
+		this.logger.info("Database service initialized successfully");
+	}
+	/**
+	* Get the database connection for sharing with other services
+	*/
+	getConnection() {
+		if (!this.connection) throw new DatabaseError("Database not initialized - call initialize() first");
+		return this.connection;
+	}
+	/**
+	* Execute a SQL query on a provided queryDatabase
+	*/
+	async executeQuery(query, queryDBConfig) {
+		try {
+			this.logger.debug("Executing query on external database", {
+				query,
+				dbType: queryDBConfig.type,
+				dbId: queryDBConfig.id
+			});
+			const queryConnection = await DatabaseConnectionFactory.createQueryDbConnection(queryDBConfig, this.logger);
+			let result = [];
+			switch (queryDBConfig.type) {
+				case "postgresql": {
+					const client = queryConnection.db.$client;
+					result = await client(query);
+					break;
+				}
+				case "sqlite":
+					result = queryConnection.db.$client.prepare(query).all();
+					break;
+				case "mysql": {
+					const [rows] = await queryConnection.db.$client.execute(query);
+					result = Array.isArray(rows) ? rows : [];
+					break;
+				}
+				default: throw new DatabaseError(`Unsupported database type: ${queryDBConfig.type}`);
+			}
+			this.logger.debug("Query executed successfully", {
+				rowCount: Array.isArray(result) ? result.length : "unknown",
+				dbType: queryDBConfig.type,
+				dbId: queryDBConfig.id
+			});
+			return result;
+		} catch (error) {
+			this.logger.error("Failed to execute query on external database", {
+				error: error instanceof Error ? error.message : error,
+				query,
+				dbType: queryDBConfig.type,
+				dbId: queryDBConfig.id,
+				stack: error instanceof Error ? error.stack : void 0
+			});
+			throw new DatabaseError(`Query execution failed on ${queryDBConfig.type} database (${queryDBConfig.id}): ${error instanceof Error ? error.message : error}`, {
+				error,
+				query,
+				dbConfig: queryDBConfig,
+				originalStack: error instanceof Error ? error.stack : void 0
+			});
+		}
+	}
+	/**
+	* Health check method
+	*/
+	async healthCheck() {
+		this.logger.debug("Performing database health check");
+		if (!this.connection) throw new DatabaseError("Database not initialized - call initialize() first");
+		try {
+			switch (this.connection.type) {
+				case "postgresql":
+					await this.connection.db.$client`SELECT 1 as health`;
+					break;
+				case "sqlite":
+					this.connection.db.$client.prepare("SELECT 1 as health").get();
+					break;
+				case "mysql":
+					await this.connection.db.$client.execute("SELECT 1 as health");
+					break;
+				default: throw new DatabaseError("Unsupported database type for health check");
+			}
+			this.logger.debug("Database health check passed");
+		} catch (error) {
+			this.logger.error("Database health check failed", error);
+			throw new DatabaseError("Database health check failed", { error });
+		}
+	}
+	/**
+	* Close the database connection
+	*/
+	async close() {
+		if (this.connection) {
+			this.logger.debug("Closing database connection");
+			this.connection = null;
+			this._database = null;
+			this.logger.info("Database connection closed");
+		}
+	}
+	/**
+	* Extract table requirements from plugin declarations.
+	*
+	* A plugin can declare required tables via:
+	* 1. `requiredTables: string[]` — explicit list (preferred)
+	* 2. `schema: { tableName: ... }` — inferred from abstract schema definitions
+	*
+	* If both are present, `requiredTables` takes precedence.
+	*/
+	static extractPluginTableRequirements(plugins) {
+		const requirements = [];
+		for (const plugin of plugins) {
+			let tables = [];
+			if (plugin.requiredTables && plugin.requiredTables.length > 0) tables = [...plugin.requiredTables];
+			else if (plugin.schema) for (const [key, def] of Object.entries(plugin.schema)) {
+				const tableName = def.tableName ?? key;
+				if (!def.disableMigration) tables.push(tableName);
+			}
+			if (tables.length > 0) requirements.push({
+				pluginId: plugin.id,
+				pluginName: plugin.name ?? plugin.id,
+				tables,
+				setupInstructions: plugin.setupInstructions
+			});
+		}
+		return requirements;
+	}
+	/**
+	* Run a simple `SELECT 1` query to verify the database is reachable.
+	*/
+	async runConnectivityCheck(connection) {
+		switch (connection.type) {
+			case "postgresql":
+				await connection.db.$client`SELECT 1 as health`;
+				break;
+			case "sqlite":
+				connection.db.$client.prepare("SELECT 1 as health").get();
+				break;
+			case "mysql":
+				await connection.db.$client.execute("SELECT 1 as health");
+				break;
+		}
+	}
+	/**
+	* Check that the essential Invect tables exist in the database.
+	* This catches the most common developer mistake: running the app
+	* before applying the database schema.
+	*
+	* Only checks for table *existence*, not column correctness (that's
+	* what the opt-in `schemaVerification` does).
+	*/
+	async runCoreTableCheck(connection) {
+		const expectedTables = [];
+		for (const def of Object.values(CORE_SCHEMA)) {
+			const tableDef = def;
+			if (tableDef.disableMigration) continue;
+			if (tableDef.tableName) expectedTables.push(tableDef.tableName);
+		}
+		let actualTableNames;
+		try {
+			actualTableNames = await this.listTableNames(connection);
+		} catch (error) {
+			this.logger.warn("Could not introspect database tables. Skipping startup table check.", { error: error instanceof Error ? error.message : error });
+			return;
+		}
+		const missingTables = expectedTables.filter((t) => !actualTableNames.has(t));
+		if (missingTables.length === 0) {
+			this.logger.debug("Core table check passed", { tablesFound: expectedTables.length });
+			return;
+		}
+		const allMissing = missingTables.length === expectedTables.length;
+		const lines = [
+			"",
+			"╔══════════════════════════════════════════════════════════════╗",
+			"║              ⚠  INVECT — DATABASE NOT READY  ⚠            ║",
+			"╚══════════════════════════════════════════════════════════════╝",
+			""
+		];
+		if (allMissing) lines.push("Your database exists but has no Invect tables.", "This usually means you haven't pushed the schema yet.");
+		else lines.push(`Your database is missing ${missingTables.length} of ${expectedTables.length} required Invect tables:`, `  Missing: ${missingTables.join(", ")}`, "", "This usually means your schema is out of date.");
+		lines.push("");
+		lines.push("To fix this, run:", "", "  npx invect generate   # generate schema files (core + plugins)", "  npx drizzle-kit push   # push schema to the database", "", "Or if you use migrations:", "", "  npx invect generate   # generate schema files", "  npx drizzle-kit generate", "  npx invect migrate    # apply migrations", "", "The Invect CLI reads your invect.config.ts to discover installed", "plugins and generates the correct schema for all of them.", "");
+		const message = lines.join("\n");
+		this.logger.error(message);
+		throw new DatabaseError(`Database is missing ${allMissing ? "all" : missingTables.length} required Invect table(s). Run schema migrations before starting the server. See logs above for instructions.`, { missingTables });
+	}
+	/**
+	* Check that tables required by plugins exist in the database.
+	*
+	* Each plugin can declare `requiredTables` (explicit list) or have them
+	* inferred from its `schema` definition. This method checks all of them
+	* in a single pass and produces a clear, attributed error message so the
+	* developer knows exactly which plugin needs which tables.
+	*/
+	async runPluginTableChecks(connection) {
+		if (this.pluginTableRequirements.length === 0) return;
+		let actualTableNames;
+		try {
+			actualTableNames = await this.listTableNames(connection);
+		} catch {
+			return;
+		}
+		const pluginsWithMissing = [];
+		for (const req of this.pluginTableRequirements) {
+			const missing = req.tables.filter((t) => !actualTableNames.has(t));
+			if (missing.length > 0) pluginsWithMissing.push({
+				pluginId: req.pluginId,
+				pluginName: req.pluginName,
+				missingTables: missing,
+				setupInstructions: req.setupInstructions
+			});
+		}
+		if (pluginsWithMissing.length === 0) {
+			const totalTables = this.pluginTableRequirements.reduce((sum, r) => sum + r.tables.length, 0);
+			this.logger.debug("Plugin table check passed", {
+				plugins: this.pluginTableRequirements.length,
+				tablesChecked: totalTables
+			});
+			return;
+		}
+		const totalMissing = pluginsWithMissing.reduce((sum, p) => sum + p.missingTables.length, 0);
+		const lines = [
+			"",
+			"╔══════════════════════════════════════════════════════════════╗",
+			"║          ⚠  INVECT — PLUGIN TABLES MISSING  ⚠             ║",
+			"╚══════════════════════════════════════════════════════════════╝",
+			"",
+			`${totalMissing} table(s) required by ${pluginsWithMissing.length} plugin(s) are missing from the database:`,
+			""
+		];
+		for (const plugin of pluginsWithMissing) {
+			lines.push(`  Plugin: ${plugin.pluginName} (${plugin.pluginId})`, `  Missing tables: ${plugin.missingTables.join(", ")}`);
+			if (plugin.setupInstructions) lines.push(`  Fix: ${plugin.setupInstructions}`);
+			lines.push("");
+		}
+		if (!pluginsWithMissing.some((p) => p.setupInstructions)) lines.push("To fix this, run:", "", "  npx invect generate   # generate schema files (core + plugins)", "  npx drizzle-kit push   # push schema to the database", "", "The Invect CLI reads your invect.config.ts, discovers all plugins", "and their required tables, and generates the complete schema.");
+		lines.push("", "If a plugin defines a schema, `npx invect generate` will include it", "automatically. For plugins with externally-managed tables, see the", "plugin's README for additional schema setup instructions.", "");
+		const message = lines.join("\n");
+		this.logger.error(message);
+		throw new DatabaseError(`Database is missing ${totalMissing} table(s) required by plugin(s): ` + pluginsWithMissing.map((p) => `${p.pluginName} (${p.missingTables.join(", ")})`).join("; ") + `. Push the schema before starting the server. See logs above for instructions.`, { pluginsWithMissing: pluginsWithMissing.map((p) => ({
+			pluginId: p.pluginId,
+			missingTables: p.missingTables
+		})) });
+	}
+	/**
+	* Get a set of table names from the database.
+	*/
+	async listTableNames(connection) {
+		const names = /* @__PURE__ */ new Set();
+		switch (connection.type) {
+			case "sqlite": {
+				const rows = connection.db.$client.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite\\_%' ESCAPE '\\' AND name NOT LIKE '\\_\\_%' ESCAPE '\\'`).all();
+				for (const row of rows) names.add(row.name);
+				break;
+			}
+			case "postgresql": {
+				const rows = await connection.db.$client`
+          SELECT table_name FROM information_schema.tables
+          WHERE table_schema = 'public' AND table_type = 'BASE TABLE'
+        `;
+				for (const row of rows) names.add(row.table_name);
+				break;
+			}
+			case "mysql": {
+				const [rows] = await connection.db.$client.execute(`SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_TYPE = 'BASE TABLE'`);
+				for (const row of rows) names.add(row["TABLE_NAME"]);
+				break;
+			}
+		}
+		return names;
+	}
+	/**
+	* Log a helpful error when the database connection itself fails.
+	*/
+	logConnectionError(error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		const dbType = this.hostDbConfig.type;
+		const connStr = this.hostDbConfig.connectionString;
+		const lines = [
+			"",
+			"╔══════════════════════════════════════════════════════════════╗",
+			"║             ⚠  INVECT — DATABASE CONNECTION FAILED  ⚠     ║",
+			"╚══════════════════════════════════════════════════════════════╝",
+			"",
+			`Database type:       ${dbType}`,
+			`Connection string:   ${this.redactConnectionString(connStr)}`,
+			`Error:               ${msg}`,
+			""
+		];
+		if (dbType === "sqlite") if (msg.includes("SQLITE_CANTOPEN") || msg.includes("unable to open")) lines.push("The SQLite database file could not be opened.", "Check that the path is correct and the directory exists.", "", `  Configured path: ${connStr}`);
+		else lines.push("Could not connect to the SQLite database.", "Make sure the connection string in your config is valid.", "", "Common formats:", "  file:./dev.db          (relative path)", "  file:/absolute/path.db (absolute path)");
+		else if (dbType === "postgresql") if (msg.includes("ECONNREFUSED") || msg.includes("connect")) lines.push("Could not reach the PostgreSQL server.", "Make sure PostgreSQL is running and the connection string is correct.", "", "Common causes:", "  • PostgreSQL is not running (start with: pg_ctl start)", "  • Wrong host/port in connection string", "  • Firewall blocking the connection");
+		else if (msg.includes("authentication") || msg.includes("password")) lines.push("PostgreSQL authentication failed.", "Check that the username and password in your connection string are correct.");
+		else if (msg.includes("does not exist")) lines.push("The PostgreSQL database does not exist.", "Create it with: createdb <database_name>");
+		else lines.push("Could not connect to PostgreSQL. Verify your DATABASE_URL is correct.");
+		else if (dbType === "mysql") if (msg.includes("ECONNREFUSED") || msg.includes("connect")) lines.push("Could not reach the MySQL server.", "Make sure MySQL is running and the connection string is correct.");
+		else lines.push("Could not connect to MySQL. Verify your connection string.");
+		lines.push("");
+		this.logger.error(lines.join("\n"));
+	}
+	/**
+	* Log a helpful error when the connectivity probe (SELECT 1) fails.
+	*/
+	logConnectivityError(error) {
+		const lines = [
+			"",
+			"╔══════════════════════════════════════════════════════════════╗",
+			"║        ⚠  INVECT — DATABASE CONNECTIVITY CHECK FAILED ⚠   ║",
+			"╚══════════════════════════════════════════════════════════════╝",
+			"",
+			"A connection was established but a simple SELECT query failed.",
+			`Error: ${error instanceof Error ? error.message : String(error)}`,
+			"",
+			"This may indicate:",
+			"  • The database server dropped the connection",
+			"  • Insufficient permissions for the database user",
+			"  • The database file is corrupted (SQLite)",
+			""
+		];
+		this.logger.error(lines.join("\n"));
+	}
+	/**
+	* Redact credentials from a connection string for safe logging.
+	*/
+	redactConnectionString(connStr) {
+		return connStr.replace(/:([^/:@]+)@/, ":***@");
+	}
+};
+/**
+* Database Models Factory - Creates all model instances with shared connection and logger
+*/
+var Database = class {
+	flows;
+	flowVersions;
+	flowRuns;
+	executionTraces;
+	batchJobs;
+	agentToolExecutions;
+	flowTriggers;
+	chatMessages;
+	constructor(_connection, logger, adapter) {
+		this.flows = new FlowsModel(adapter, logger);
+		this.flowVersions = new FlowVersionsModel(adapter, logger);
+		this.flowRuns = new FlowRunsModel(adapter, logger);
+		this.executionTraces = new NodeExecutionsModel(adapter, logger);
+		this.batchJobs = new BatchJobsModel(adapter, logger);
+		this.agentToolExecutions = new AgentToolExecutionsModel(adapter, logger);
+		this.flowTriggers = new FlowTriggersModel(adapter, logger);
+		this.chatMessages = new ChatMessagesModel(adapter, logger);
+	}
+};
+//#endregion
+export { DatabaseService };
+
+//# sourceMappingURL=database.service.js.map

package/dist/services/database/database.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.service.js","names":[],"sources":["../../../src/services/database/database.service.ts"],"sourcesContent":["// Framework-agnostic Database Service for Invect core\n\nimport { DatabaseConnectionFactory, type DatabaseConnection } from '../../database/connection';\nimport { verifySchema, type SchemaVerificationOptions } from '../../database/schema-verification';\nimport { CORE_SCHEMA } from '../../database/core-schema';\nimport { DatabaseError } from 'src/types/common/errors.types';\nimport { FlowRunsModel } from '../flow-runs/flow-runs.model';\nimport { FlowsModel } from '../flows/flows.model';\nimport { BatchJobsModel } from '../batch-jobs/batch-jobs.model';\nimport { FlowVersionsModel } from '../flow-versions/flow-versions.model';\nimport { NodeExecutionsModel } from '../node-executions/node-executions.model';\nimport { AgentToolExecutionsModel } from '../agent-tool-executions/agent-tool-executions.model';\nimport { FlowTriggersModel } from '../triggers/flow-triggers.model';\nimport { ChatMessagesModel } from '../chat/chat-messages.model';\nimport { InvectDatabaseConfig, Logger } from 'src/types/schemas';\nimport type { InvectPlugin } from 'src/types/plugin.types';\nimport type { InvectAdapter } from '../../database/adapter';\nimport { createAdapterFromConnection } from '../../database/adapters/connection-bridge';\n\ntype PostgreSqlClientLike = {\n  <T = Record<string, unknown>>(query: string): Promise<T[]>;\n  (strings: TemplateStringsArray, ...values: unknown[]): Promise<unknown[]>;\n};\n\ntype SqliteClientLike = {\n  prepare(sql: string): {\n    all(...params: unknown[]): Record<string, unknown>[];\n    run(...params: unknown[]): { changes: number };\n    get(...params: unknown[]): Record<string, unknown> | undefined;\n  };\n  exec(sql: string): void;\n};\n\ntype MysqlClientLike = {\n  execute<T = Record<string, unknown>>(\n    query: string,\n    params?: unknown[],\n  ): Promise<[T[] | unknown, unknown]>;\n};\n\ntype PostgreSqlDbLike = {\n  $client: PostgreSqlClientLike;\n};\n\ntype SqliteDbLike = {\n  $client: SqliteClientLike;\n};\n\ntype MysqlDbLike = {\n  $client: MysqlClientLike;\n};\n\n/**\n * Describes tables that a plugin needs checked at startup.\n */\nexport interface PluginTableRequirement {\n  pluginId: string;\n  pluginName: string;\n  tables: string[];\n  setupInstructions?: string;\n}\n\n/**\n * Core database service implementation\n */\nexport class DatabaseService {\n  private connection: DatabaseConnection | null = null;\n  private _database: Database | null = null;\n  private _adapter: InvectAdapter | null = null;\n  private schemaVerificationOptions?: SchemaVerificationOptions;\n  private pluginTableRequirements: PluginTableRequirement[] = [];\n\n  constructor(\n    private readonly hostDbConfig: InvectDatabaseConfig,\n    private readonly logger: Logger = console,\n    schemaVerification?: SchemaVerificationOptions,\n    plugins?: InvectPlugin[],\n  ) {\n    this.schemaVerificationOptions = schemaVerification;\n    this.pluginTableRequirements = DatabaseService.extractPluginTableRequirements(plugins ?? []);\n  }\n\n  /**\n   * Get the Database instance with all model classes\n   */\n  get database(): Database {\n    if (!this._database) {\n      throw new DatabaseError('Database not initialized - call initialize() first');\n    }\n    return this._database;\n  }\n\n  /**\n   * Get the InvectAdapter instance for direct adapter access\n   */\n  get adapter(): InvectAdapter {\n    if (!this._adapter) {\n      throw new DatabaseError('Database not initialized - call initialize() first');\n    }\n    return this._adapter;\n  }\n\n  /**\n   * Direct access to flows model\n   */\n  get flows() {\n    return this.database.flows;\n  }\n\n  /**\n   * Direct access to flow versions model\n   */\n  get flowVersions() {\n    return this.database.flowVersions;\n  }\n\n  /**\n   * Direct access to flow executions model\n   */\n  get flowRuns() {\n    return this.database.flowRuns;\n  }\n\n  /**\n   * Direct access to execution traces model\n   */\n  get nodeExecutions() {\n    return this.database.executionTraces;\n  }\n\n  /**\n   * Direct access to batch jobs model\n   */\n  get batchJobs() {\n    return this.database.batchJobs;\n  }\n\n  /**\n   * Direct access to agent tool executions model\n   */\n  get agentToolExecutions() {\n    return this.database.agentToolExecutions;\n  }\n\n  /**\n   * Direct access to flow triggers model\n   */\n  get flowTriggers() {\n    return this.database.flowTriggers;\n  }\n\n  /**\n   * Direct access to chat messages model\n   */\n  get chatMessages() {\n    return this.database.chatMessages;\n  }\n\n  /**\n   * Initialize the database connection and models\n   */\n  async initialize(): Promise<void> {\n    if (this.connection) {\n      this.logger.debug('Database connection already initialized');\n      return;\n    }\n\n    // --- Step 1: Establish the database connection ---\n    try {\n      this.connection = await DatabaseConnectionFactory.createHostDBConnection(\n        this.hostDbConfig,\n        this.logger,\n      );\n    } catch (error) {\n      this.logConnectionError(error);\n      throw new DatabaseError(\n        `Failed to connect to the database: ${error instanceof Error ? error.message : error}`,\n        { error, originalStack: error instanceof Error ? error.stack : undefined },\n      );\n    }\n\n    // --- Step 2: Verify connectivity with a simple query ---\n    try {\n      await this.runConnectivityCheck(this.connection);\n    } catch (error) {\n      this.logConnectivityError(error);\n      throw new DatabaseError(\n        `Database connectivity check failed: ${error instanceof Error ? error.message : error}`,\n        { error },\n      );\n    }\n\n    // --- Step 3: Check that core Invect tables exist ---\n    // This always runs (regardless of schemaVerification config) to catch\n    // the common case of a fresh database that hasn't had migrations applied.\n    await this.runCoreTableCheck(this.connection);\n\n    // --- Step 3b: Check that plugin-required tables exist ---\n    // Each plugin can declare requiredTables to get a clear error at startup\n    // instead of a cryptic runtime crash when a table is missing.\n    await this.runPluginTableChecks(this.connection);\n\n    // --- Step 4: Initialize the database models ---\n    this._adapter = createAdapterFromConnection(this.connection);\n    this._database = new Database(this.connection, this.logger, this._adapter);\n\n    // --- Step 5: Run detailed schema verification (opt-in) ---\n    // This checks columns, not just tables. Controlled by config.schemaVerification.\n    if (this.schemaVerificationOptions) {\n      await verifySchema(this.connection, this.logger, this.schemaVerificationOptions);\n    }\n\n    this.logger.info('Database service initialized successfully');\n  }\n\n  /**\n   * Get the database connection for sharing with other services\n   */\n  getConnection(): DatabaseConnection {\n    if (!this.connection) {\n      throw new DatabaseError('Database not initialized - call initialize() first');\n    }\n    return this.connection;\n  }\n\n  /**\n   * Execute a SQL query on a provided queryDatabase\n   */\n  async executeQuery(\n    query: string,\n    queryDBConfig: InvectDatabaseConfig,\n  ): Promise<Record<string, unknown>[]> {\n    try {\n      this.logger.debug('Executing query on external database', {\n        query,\n        dbType: queryDBConfig.type,\n        dbId: queryDBConfig.id,\n      });\n\n      // Create or get existing query database connection\n      const queryConnection = await DatabaseConnectionFactory.createQueryDbConnection(\n        queryDBConfig,\n        this.logger,\n      );\n\n      // Execute the query based on database type and return results\n      let result: Record<string, unknown>[] = [];\n\n      switch (queryDBConfig.type) {\n        case 'postgresql': {\n          // PostgreSQL query execution using postgres.js client directly\n          const client = (queryConnection.db as unknown as PostgreSqlDbLike).$client;\n          result = await client<Record<string, unknown>>(query);\n          break;\n        }\n        case 'sqlite': {\n          // SQLite query execution using better-sqlite3 synchronous API\n          const sqliteClient = (queryConnection.db as unknown as SqliteDbLike).$client;\n          result = sqliteClient.prepare(query).all() as Record<string, unknown>[];\n          break;\n        }\n        case 'mysql': {\n          // MySQL query execution using mysql2 client directly\n          const client = (queryConnection.db as unknown as MysqlDbLike).$client;\n          const [rows] = await client.execute<Record<string, unknown>>(query);\n          result = Array.isArray(rows) ? rows : [];\n          break;\n        }\n        default:\n          throw new DatabaseError(`Unsupported database type: ${queryDBConfig.type}`);\n      }\n\n      this.logger.debug('Query executed successfully', {\n        rowCount: Array.isArray(result) ? result.length : 'unknown',\n        dbType: queryDBConfig.type,\n        dbId: queryDBConfig.id,\n      });\n\n      return result;\n    } catch (error) {\n      this.logger.error('Failed to execute query on external database', {\n        error: error instanceof Error ? error.message : error,\n        query,\n        dbType: queryDBConfig.type,\n        dbId: queryDBConfig.id,\n        stack: error instanceof Error ? error.stack : undefined,\n      });\n\n      throw new DatabaseError(\n        `Query execution failed on ${queryDBConfig.type} database (${queryDBConfig.id}): ${\n          error instanceof Error ? error.message : error\n        }`,\n        {\n          error,\n          query,\n          dbConfig: queryDBConfig,\n          originalStack: error instanceof Error ? error.stack : undefined,\n        },\n      );\n    }\n  }\n\n  /**\n   * Health check method\n   */\n  async healthCheck(): Promise<void> {\n    this.logger.debug('Performing database health check');\n\n    if (!this.connection) {\n      throw new DatabaseError('Database not initialized - call initialize() first');\n    }\n\n    try {\n      // Simple connectivity test using host database connection\n      switch (this.connection.type) {\n        case 'postgresql': {\n          const client = (this.connection.db as unknown as PostgreSqlDbLike).$client;\n          await client`SELECT 1 as health`;\n          break;\n        }\n        case 'sqlite': {\n          const client = (this.connection.db as unknown as SqliteDbLike).$client;\n          client.prepare('SELECT 1 as health').get();\n          break;\n        }\n        case 'mysql': {\n          const client = (this.connection.db as unknown as MysqlDbLike).$client;\n          await client.execute('SELECT 1 as health');\n          break;\n        }\n        default:\n          throw new DatabaseError('Unsupported database type for health check');\n      }\n\n      this.logger.debug('Database health check passed');\n    } catch (error) {\n      this.logger.error('Database health check failed', error);\n      throw new DatabaseError('Database health check failed', { error });\n    }\n  }\n\n  /**\n   * Close the database connection\n   */\n  async close(): Promise<void> {\n    if (this.connection) {\n      this.logger.debug('Closing database connection');\n      this.connection = null;\n      this._database = null;\n      this.logger.info('Database connection closed');\n    }\n  }\n\n  // ===========================================================================\n  // Plugin table requirement extraction\n  // ===========================================================================\n\n  /**\n   * Extract table requirements from plugin declarations.\n   *\n   * A plugin can declare required tables via:\n   * 1. `requiredTables: string[]` — explicit list (preferred)\n   * 2. `schema: { tableName: ... }` — inferred from abstract schema definitions\n   *\n   * If both are present, `requiredTables` takes precedence.\n   */\n  static extractPluginTableRequirements(plugins: InvectPlugin[]): PluginTableRequirement[] {\n    const requirements: PluginTableRequirement[] = [];\n\n    for (const plugin of plugins) {\n      let tables: string[] = [];\n\n      if (plugin.requiredTables && plugin.requiredTables.length > 0) {\n        // Explicit declaration takes priority\n        tables = [...plugin.requiredTables];\n      } else if (plugin.schema) {\n        // Infer from abstract schema — each entry's tableName (or snake_case key)\n        for (const [key, def] of Object.entries(plugin.schema)) {\n          const tableName = (def as { tableName?: string }).tableName ?? key;\n          const disabled = (def as { disableMigration?: boolean }).disableMigration;\n          if (!disabled) {\n            tables.push(tableName);\n          }\n        }\n      }\n\n      if (tables.length > 0) {\n        requirements.push({\n          pluginId: plugin.id,\n          pluginName: plugin.name ?? plugin.id,\n          tables,\n          setupInstructions: plugin.setupInstructions,\n        });\n      }\n    }\n\n    return requirements;\n  }\n\n  // ===========================================================================\n  // Startup check helpers\n  // ===========================================================================\n\n  /**\n   * Run a simple `SELECT 1` query to verify the database is reachable.\n   */\n  private async runConnectivityCheck(connection: DatabaseConnection): Promise<void> {\n    switch (connection.type) {\n      case 'postgresql': {\n        const client = (connection.db as unknown as PostgreSqlDbLike).$client;\n        await client`SELECT 1 as health`;\n        break;\n      }\n      case 'sqlite': {\n        const client = (connection.db as unknown as SqliteDbLike).$client;\n        client.prepare('SELECT 1 as health').get();\n        break;\n      }\n      case 'mysql': {\n        const client = (connection.db as unknown as MysqlDbLike).$client;\n        await client.execute('SELECT 1 as health');\n        break;\n      }\n    }\n  }\n\n  /**\n   * Check that the essential Invect tables exist in the database.\n   * This catches the most common developer mistake: running the app\n   * before applying the database schema.\n   *\n   * Only checks for table *existence*, not column correctness (that's\n   * what the opt-in `schemaVerification` does).\n   */\n  private async runCoreTableCheck(connection: DatabaseConnection): Promise<void> {\n    // Collect the expected core table names from the abstract schema\n    const expectedTables: string[] = [];\n    for (const def of Object.values(CORE_SCHEMA)) {\n      const tableDef = def as { tableName?: string; disableMigration?: boolean };\n      if (tableDef.disableMigration) {\n        continue;\n      }\n      if (tableDef.tableName) {\n        expectedTables.push(tableDef.tableName);\n      }\n    }\n\n    // Get actual table names from the database\n    let actualTableNames: Set<string>;\n    try {\n      actualTableNames = await this.listTableNames(connection);\n    } catch (error) {\n      // If we can't even list tables, the database is probably unreachable\n      // or misconfigured — the connectivity check should have caught this,\n      // but log and proceed gracefully.\n      this.logger.warn('Could not introspect database tables. Skipping startup table check.', {\n        error: error instanceof Error ? error.message : error,\n      });\n      return;\n    }\n\n    const missingTables = expectedTables.filter((t) => !actualTableNames.has(t));\n\n    if (missingTables.length === 0) {\n      this.logger.debug('Core table check passed', {\n        tablesFound: expectedTables.length,\n      });\n      return;\n    }\n\n    // --- Build a helpful error message ---\n    const allMissing = missingTables.length === expectedTables.length;\n\n    const lines: string[] = [\n      '',\n      '╔══════════════════════════════════════════════════════════════╗',\n      '║              ⚠  INVECT — DATABASE NOT READY  ⚠            ║',\n      '╚══════════════════════════════════════════════════════════════╝',\n      '',\n    ];\n\n    if (allMissing) {\n      lines.push(\n        'Your database exists but has no Invect tables.',\n        \"This usually means you haven't pushed the schema yet.\",\n      );\n    } else {\n      lines.push(\n        `Your database is missing ${missingTables.length} of ${expectedTables.length} required Invect tables:`,\n        `  Missing: ${missingTables.join(', ')}`,\n        '',\n        'This usually means your schema is out of date.',\n      );\n    }\n\n    lines.push('');\n\n    // Fix instructions — point users to the Invect CLI\n    lines.push(\n      'To fix this, run:',\n      '',\n      '  npx invect generate   # generate schema files (core + plugins)',\n      '  npx drizzle-kit push   # push schema to the database',\n      '',\n      'Or if you use migrations:',\n      '',\n      '  npx invect generate   # generate schema files',\n      '  npx drizzle-kit generate',\n      '  npx invect migrate    # apply migrations',\n      '',\n      'The Invect CLI reads your invect.config.ts to discover installed',\n      'plugins and generates the correct schema for all of them.',\n      '',\n    );\n\n    const message = lines.join('\\n');\n    this.logger.error(message);\n\n    throw new DatabaseError(\n      `Database is missing ${allMissing ? 'all' : missingTables.length} required Invect table(s). ` +\n        `Run schema migrations before starting the server. See logs above for instructions.`,\n      { missingTables },\n    );\n  }\n\n  /**\n   * Check that tables required by plugins exist in the database.\n   *\n   * Each plugin can declare `requiredTables` (explicit list) or have them\n   * inferred from its `schema` definition. This method checks all of them\n   * in a single pass and produces a clear, attributed error message so the\n   * developer knows exactly which plugin needs which tables.\n   */\n  private async runPluginTableChecks(connection: DatabaseConnection): Promise<void> {\n    if (this.pluginTableRequirements.length === 0) {\n      return; // No plugins declared required tables\n    }\n\n    // Get actual table names from the database\n    let actualTableNames: Set<string>;\n    try {\n      actualTableNames = await this.listTableNames(connection);\n    } catch {\n      // If introspection fails, skip gracefully (core check already warned)\n      return;\n    }\n\n    // Collect all missing tables grouped by plugin\n    const pluginsWithMissing: Array<{\n      pluginId: string;\n      pluginName: string;\n      missingTables: string[];\n      setupInstructions?: string;\n    }> = [];\n\n    for (const req of this.pluginTableRequirements) {\n      const missing = req.tables.filter((t) => !actualTableNames.has(t));\n      if (missing.length > 0) {\n        pluginsWithMissing.push({\n          pluginId: req.pluginId,\n          pluginName: req.pluginName,\n          missingTables: missing,\n          setupInstructions: req.setupInstructions,\n        });\n      }\n    }\n\n    if (pluginsWithMissing.length === 0) {\n      const totalTables = this.pluginTableRequirements.reduce((sum, r) => sum + r.tables.length, 0);\n      this.logger.debug('Plugin table check passed', {\n        plugins: this.pluginTableRequirements.length,\n        tablesChecked: totalTables,\n      });\n      return;\n    }\n\n    // --- Build a helpful, plugin-attributed error message ---\n    const totalMissing = pluginsWithMissing.reduce((sum, p) => sum + p.missingTables.length, 0);\n\n    const lines: string[] = [\n      '',\n      '╔══════════════════════════════════════════════════════════════╗',\n      '║          ⚠  INVECT — PLUGIN TABLES MISSING  ⚠             ║',\n      '╚══════════════════════════════════════════════════════════════╝',\n      '',\n      `${totalMissing} table(s) required by ${pluginsWithMissing.length} plugin(s) are missing from the database:`,\n      '',\n    ];\n\n    for (const plugin of pluginsWithMissing) {\n      lines.push(\n        `  Plugin: ${plugin.pluginName} (${plugin.pluginId})`,\n        `  Missing tables: ${plugin.missingTables.join(', ')}`,\n      );\n\n      if (plugin.setupInstructions) {\n        lines.push(`  Fix: ${plugin.setupInstructions}`);\n      }\n\n      lines.push('');\n    }\n\n    // Check if any plugin provided custom instructions\n    const hasCustomInstructions = pluginsWithMissing.some((p) => p.setupInstructions);\n\n    if (!hasCustomInstructions) {\n      // Generic fix instructions — point to the CLI\n      lines.push(\n        'To fix this, run:',\n        '',\n        '  npx invect generate   # generate schema files (core + plugins)',\n        '  npx drizzle-kit push   # push schema to the database',\n        '',\n        'The Invect CLI reads your invect.config.ts, discovers all plugins',\n        'and their required tables, and generates the complete schema.',\n      );\n    }\n\n    lines.push(\n      '',\n      'If a plugin defines a schema, `npx invect generate` will include it',\n      'automatically. For plugins with externally-managed tables, see the',\n      \"plugin's README for additional schema setup instructions.\",\n      '',\n    );\n\n    const message = lines.join('\\n');\n    this.logger.error(message);\n\n    throw new DatabaseError(\n      `Database is missing ${totalMissing} table(s) required by plugin(s): ` +\n        pluginsWithMissing\n          .map((p) => `${p.pluginName} (${p.missingTables.join(', ')})`)\n          .join('; ') +\n        `. Push the schema before starting the server. See logs above for instructions.`,\n      {\n        pluginsWithMissing: pluginsWithMissing.map((p) => ({\n          pluginId: p.pluginId,\n          missingTables: p.missingTables,\n        })),\n      },\n    );\n  }\n\n  /**\n   * Get a set of table names from the database.\n   */\n  private async listTableNames(connection: DatabaseConnection): Promise<Set<string>> {\n    const names = new Set<string>();\n\n    switch (connection.type) {\n      case 'sqlite': {\n        const db = connection.db as unknown as SqliteDbLike;\n        // Note: In SQL LIKE, '_' is a single-char wildcard. We must escape it\n        // with ESCAPE '\\' so 'sqlite\\_%' matches literal 'sqlite_*' and\n        // '\\\\_\\\\_%' matches literal names starting with '__'.\n        const query = `SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite\\\\_%' ESCAPE '\\\\' AND name NOT LIKE '\\\\_\\\\_%' ESCAPE '\\\\'`;\n        const rows = db.$client.prepare(query).all() as Array<{ name: string }>;\n        for (const row of rows) {\n          names.add(row.name);\n        }\n        break;\n      }\n      case 'postgresql': {\n        const db = connection.db as unknown as PostgreSqlDbLike;\n        const rows = (await db.$client`\n          SELECT table_name FROM information_schema.tables\n          WHERE table_schema = 'public' AND table_type = 'BASE TABLE'\n        `) as Array<{ table_name: string }>;\n        for (const row of rows) {\n          names.add(row.table_name);\n        }\n        break;\n      }\n      case 'mysql': {\n        const db = connection.db as unknown as MysqlDbLike;\n        const [rows] = await db.$client.execute(\n          `SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_TYPE = 'BASE TABLE'`,\n        );\n        for (const row of rows as Array<Record<string, string>>) {\n          names.add(row['TABLE_NAME']);\n        }\n        break;\n      }\n    }\n\n    return names;\n  }\n\n  /**\n   * Log a helpful error when the database connection itself fails.\n   */\n  private logConnectionError(error: unknown): void {\n    const msg = error instanceof Error ? error.message : String(error);\n    const dbType = this.hostDbConfig.type;\n    const connStr = this.hostDbConfig.connectionString;\n\n    const lines: string[] = [\n      '',\n      '╔══════════════════════════════════════════════════════════════╗',\n      '║             ⚠  INVECT — DATABASE CONNECTION FAILED  ⚠     ║',\n      '╚══════════════════════════════════════════════════════════════╝',\n      '',\n      `Database type:       ${dbType}`,\n      `Connection string:   ${this.redactConnectionString(connStr)}`,\n      `Error:               ${msg}`,\n      '',\n    ];\n\n    if (dbType === 'sqlite') {\n      if (msg.includes('SQLITE_CANTOPEN') || msg.includes('unable to open')) {\n        lines.push(\n          'The SQLite database file could not be opened.',\n          'Check that the path is correct and the directory exists.',\n          '',\n          `  Configured path: ${connStr}`,\n        );\n      } else {\n        lines.push(\n          'Could not connect to the SQLite database.',\n          'Make sure the connection string in your config is valid.',\n          '',\n          'Common formats:',\n          '  file:./dev.db          (relative path)',\n          '  file:/absolute/path.db (absolute path)',\n        );\n      }\n    } else if (dbType === 'postgresql') {\n      if (msg.includes('ECONNREFUSED') || msg.includes('connect')) {\n        lines.push(\n          'Could not reach the PostgreSQL server.',\n          'Make sure PostgreSQL is running and the connection string is correct.',\n          '',\n          'Common causes:',\n          '  • PostgreSQL is not running (start with: pg_ctl start)',\n          '  • Wrong host/port in connection string',\n          '  • Firewall blocking the connection',\n        );\n      } else if (msg.includes('authentication') || msg.includes('password')) {\n        lines.push(\n          'PostgreSQL authentication failed.',\n          'Check that the username and password in your connection string are correct.',\n        );\n      } else if (msg.includes('does not exist')) {\n        lines.push(\n          'The PostgreSQL database does not exist.',\n          'Create it with: createdb <database_name>',\n        );\n      } else {\n        lines.push('Could not connect to PostgreSQL. Verify your DATABASE_URL is correct.');\n      }\n    } else if (dbType === 'mysql') {\n      if (msg.includes('ECONNREFUSED') || msg.includes('connect')) {\n        lines.push(\n          'Could not reach the MySQL server.',\n          'Make sure MySQL is running and the connection string is correct.',\n        );\n      } else {\n        lines.push('Could not connect to MySQL. Verify your connection string.');\n      }\n    }\n\n    lines.push('');\n    this.logger.error(lines.join('\\n'));\n  }\n\n  /**\n   * Log a helpful error when the connectivity probe (SELECT 1) fails.\n   */\n  private logConnectivityError(error: unknown): void {\n    const msg = error instanceof Error ? error.message : String(error);\n\n    const lines: string[] = [\n      '',\n      '╔══════════════════════════════════════════════════════════════╗',\n      '║        ⚠  INVECT — DATABASE CONNECTIVITY CHECK FAILED ⚠   ║',\n      '╚══════════════════════════════════════════════════════════════╝',\n      '',\n      'A connection was established but a simple SELECT query failed.',\n      `Error: ${msg}`,\n      '',\n      'This may indicate:',\n      '  • The database server dropped the connection',\n      '  • Insufficient permissions for the database user',\n      '  • The database file is corrupted (SQLite)',\n      '',\n    ];\n\n    this.logger.error(lines.join('\\n'));\n  }\n\n  /**\n   * Redact credentials from a connection string for safe logging.\n   */\n  private redactConnectionString(connStr: string): string {\n    // Hide passwords in postgres/mysql URLs: postgres://user:PASS@host → postgres://user:***@host\n    return connStr.replace(/:([^/:@]+)@/, ':***@');\n  }\n}\n\n/**\n * Database Models Factory - Creates all model instances with shared connection and logger\n */\nclass Database {\n  public readonly flows: FlowsModel;\n  public readonly flowVersions: FlowVersionsModel;\n  public readonly flowRuns: FlowRunsModel;\n  public readonly executionTraces: NodeExecutionsModel;\n  public readonly batchJobs: BatchJobsModel;\n  public readonly agentToolExecutions: AgentToolExecutionsModel;\n  public readonly flowTriggers: FlowTriggersModel;\n  public readonly chatMessages: ChatMessagesModel;\n\n  constructor(_connection: DatabaseConnection, logger: Logger, adapter: InvectAdapter) {\n    this.flows = new FlowsModel(adapter, logger);\n    this.flowVersions = new FlowVersionsModel(adapter, logger);\n    this.flowRuns = new FlowRunsModel(adapter, logger);\n    this.executionTraces = new NodeExecutionsModel(adapter, logger);\n    this.batchJobs = new BatchJobsModel(adapter, logger);\n    this.agentToolExecutions = new AgentToolExecutionsModel(adapter, logger);\n    this.flowTriggers = new FlowTriggersModel(adapter, logger);\n    this.chatMessages = new ChatMessagesModel(adapter, logger);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,80 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let events = require("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 events.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
+exports.ExecutionEventBus = ExecutionEventBus;
+exports.getExecutionEventBus = getExecutionEventBus;
+exports.resetExecutionEventBus = resetExecutionEventBus;
+
+//# sourceMappingURL=execution-event-bus.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-event-bus.cjs","names":["EventEmitter"],"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,IAAIA,OAAAA,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"}