@invect/core 0.0.1

package/dist/services/database/database.service.d.cts

@@ -0,0 +1,162 @@
+import { InvectDatabaseConfig, Logger } from "../../types/schemas-fresh/invect-config.cjs";
+import { InvectAdapter } from "../../database/adapter.cjs";
+import { InvectPlugin } from "../../types/plugin.types.cjs";
+import { SchemaVerificationOptions } from "../../database/schema-verification.cjs";
+import { FlowRunsModel } from "../flow-runs/flow-runs.model.cjs";
+import { FlowsModel } from "../flows/flows.model.cjs";
+import { BatchJobsModel } from "../batch-jobs/batch-jobs.model.cjs";
+import { FlowVersionsModel } from "../flow-versions/flow-versions.model.cjs";
+import { NodeExecutionsModel } from "../node-executions/node-executions.model.cjs";
+import { AgentToolExecutionsModel } from "../agent-tool-executions/agent-tool-executions.model.cjs";
+import { FlowTriggersModel } from "../triggers/flow-triggers.model.cjs";
+import { ChatMessagesModel } from "../chat/chat-messages.model.cjs";
+import { DatabaseConnection } from "../../database/connection.cjs";
+
+//#region src/services/database/database.service.d.ts
+/**
+ * Describes tables that a plugin needs checked at startup.
+ */
+interface PluginTableRequirement {
+  pluginId: string;
+  pluginName: string;
+  tables: string[];
+  setupInstructions?: string;
+}
+/**
+ * Core database service implementation
+ */
+declare class DatabaseService {
+  private readonly hostDbConfig;
+  private readonly logger;
+  private connection;
+  private _database;
+  private _adapter;
+  private schemaVerificationOptions?;
+  private pluginTableRequirements;
+  constructor(hostDbConfig: InvectDatabaseConfig, logger?: Logger, schemaVerification?: SchemaVerificationOptions, plugins?: InvectPlugin[]);
+  /**
+   * Get the Database instance with all model classes
+   */
+  get database(): Database;
+  /**
+   * Get the InvectAdapter instance for direct adapter access
+   */
+  get adapter(): InvectAdapter;
+  /**
+   * Direct access to flows model
+   */
+  get flows(): FlowsModel;
+  /**
+   * Direct access to flow versions model
+   */
+  get flowVersions(): FlowVersionsModel;
+  /**
+   * Direct access to flow executions model
+   */
+  get flowRuns(): FlowRunsModel;
+  /**
+   * Direct access to execution traces model
+   */
+  get nodeExecutions(): NodeExecutionsModel;
+  /**
+   * Direct access to batch jobs model
+   */
+  get batchJobs(): BatchJobsModel;
+  /**
+   * Direct access to agent tool executions model
+   */
+  get agentToolExecutions(): AgentToolExecutionsModel;
+  /**
+   * Direct access to flow triggers model
+   */
+  get flowTriggers(): FlowTriggersModel;
+  /**
+   * Direct access to chat messages model
+   */
+  get chatMessages(): ChatMessagesModel;
+  /**
+   * Initialize the database connection and models
+   */
+  initialize(): Promise<void>;
+  /**
+   * Get the database connection for sharing with other services
+   */
+  getConnection(): DatabaseConnection;
+  /**
+   * Execute a SQL query on a provided queryDatabase
+   */
+  executeQuery(query: string, queryDBConfig: InvectDatabaseConfig): Promise<Record<string, unknown>[]>;
+  /**
+   * Health check method
+   */
+  healthCheck(): Promise<void>;
+  /**
+   * Close the database connection
+   */
+  close(): Promise<void>;
+  /**
+   * 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: InvectPlugin[]): PluginTableRequirement[];
+  /**
+   * Run a simple `SELECT 1` query to verify the database is reachable.
+   */
+  private runConnectivityCheck;
+  /**
+   * 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).
+   */
+  private runCoreTableCheck;
+  /**
+   * 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.
+   */
+  private runPluginTableChecks;
+  /**
+   * Get a set of table names from the database.
+   */
+  private listTableNames;
+  /**
+   * Log a helpful error when the database connection itself fails.
+   */
+  private logConnectionError;
+  /**
+   * Log a helpful error when the connectivity probe (SELECT 1) fails.
+   */
+  private logConnectivityError;
+  /**
+   * Redact credentials from a connection string for safe logging.
+   */
+  private redactConnectionString;
+}
+/**
+ * Database Models Factory - Creates all model instances with shared connection and logger
+ */
+declare class Database {
+  readonly flows: FlowsModel;
+  readonly flowVersions: FlowVersionsModel;
+  readonly flowRuns: FlowRunsModel;
+  readonly executionTraces: NodeExecutionsModel;
+  readonly batchJobs: BatchJobsModel;
+  readonly agentToolExecutions: AgentToolExecutionsModel;
+  readonly flowTriggers: FlowTriggersModel;
+  readonly chatMessages: ChatMessagesModel;
+  constructor(_connection: DatabaseConnection, logger: Logger, adapter: InvectAdapter);
+}
+//#endregion
+export { DatabaseService };
+//# sourceMappingURL=database.service.d.cts.map

package/dist/services/database/database.service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.service.d.cts","names":[],"sources":["../../../src/services/database/database.service.ts"],"mappings":";;;;;;;;;;;;;;;;;AAuDA;UAAiB,sBAAA;EACf,QAAA;EACA,UAAA;EACA,MAAA;EACA,iBAAA;AAAA;;;;cAMW,eAAA;EAAA,iBAQQ,YAAA;EAAA,iBACA,MAAA;EAAA,QARX,UAAA;EAAA,QACA,SAAA;EAAA,QACA,QAAA;EAAA,QACA,yBAAA;EAAA,QACA,uBAAA;cAGW,YAAA,EAAc,oBAAA,EACd,MAAA,GAAQ,MAAA,EACzB,kBAAA,GAAqB,yBAAA,EACrB,OAAA,GAAU,YAAA;EA6BH;;;EAAA,IApBL,QAAA,CAAA,GAAY,QAAA;EAgDH;;;EAAA,IAtCT,OAAA,CAAA,GAAW,aAAA;EAkEK;;;EAAA,IAxDhB,KAAA,CAAA,GAAK,UAAA;EA8HN;;;EAAA,IAvHC,YAAA,CAAA,GAAY,iBAAA;EA8PgD;;;EAAA,IAvP5D,QAAA,CAAA,GAAQ,aAAA;EA7CO;;;EAAA,IAoDf,cAAA,CAAA,GAAc,mBAAA;EAzDV;;;EAAA,IAgEJ,SAAA,CAAA,GAAS,cAAA;EA5DM;;;EAAA,IAmEf,mBAAA,CAAA,GAAmB,wBAAA;EAjErB;;;EAAA,IAwEE,YAAA,CAAA,GAAY,iBAAA;EA9DA;;;EAAA,IAqEZ,YAAA,CAAA,GAAY,iBAAA;EAjDP;;;EAwDH,UAAA,CAAA,GAAc,OAAA;EA1CR;;;EAmGZ,aAAA,CAAA,GAAiB,kBAAA;EArFJ;;;EA+FP,YAAA,CACJ,KAAA,UACA,aAAA,EAAe,oBAAA,GACd,OAAA,CAAQ,MAAA;EApFK;;;EA8JV,WAAA,CAAA,GAAe,OAAA;EAhJD;;;EAuLd,KAAA,CAAA,GAAS,OAAA;EAnHb;;;;;;;;;EAAA,OAyIK,8BAAA,CAA+B,OAAA,EAAS,YAAA,KAAiB,sBAAA;EAAjB;;;EAAA,QAwCjC,oBAAA;EA4BA;;;;;;;;EAAA,QAAA,iBAAA;EAiXF;;;;;;;;EAAA,QA9QE,oBAAA;EAsRgB;;;EAAA,QApKhB,cAAA;EAsKqE;;;EAAA,QAzH3E,kBAAA;EAiHQ;;;EAAA,QApCR,oBAAA;EAsCQ;;;EAAA,QAbR,sBAAA;AAAA;;;;cASJ,QAAA;EAAA,SACY,KAAA,EAAO,UAAA;EAAA,SACP,YAAA,EAAc,iBAAA;EAAA,SACd,QAAA,EAAU,aAAA;EAAA,SACV,eAAA,EAAiB,mBAAA;EAAA,SACjB,SAAA,EAAW,cAAA;EAAA,SACX,mBAAA,EAAqB,wBAAA;EAAA,SACrB,YAAA,EAAc,iBAAA;EAAA,SACd,YAAA,EAAc,iBAAA;cAElB,WAAA,EAAa,kBAAA,EAAoB,MAAA,EAAQ,MAAA,EAAQ,OAAA,EAAS,aAAA;AAAA"}

package/dist/services/database/database.service.d.ts

@@ -0,0 +1,162 @@
+import { InvectDatabaseConfig, Logger } from "../../types/schemas-fresh/invect-config.js";
+import { InvectAdapter } from "../../database/adapter.js";
+import { InvectPlugin } from "../../types/plugin.types.js";
+import { SchemaVerificationOptions } 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 { DatabaseConnection } from "../../database/connection.js";
+
+//#region src/services/database/database.service.d.ts
+/**
+ * Describes tables that a plugin needs checked at startup.
+ */
+interface PluginTableRequirement {
+  pluginId: string;
+  pluginName: string;
+  tables: string[];
+  setupInstructions?: string;
+}
+/**
+ * Core database service implementation
+ */
+declare class DatabaseService {
+  private readonly hostDbConfig;
+  private readonly logger;
+  private connection;
+  private _database;
+  private _adapter;
+  private schemaVerificationOptions?;
+  private pluginTableRequirements;
+  constructor(hostDbConfig: InvectDatabaseConfig, logger?: Logger, schemaVerification?: SchemaVerificationOptions, plugins?: InvectPlugin[]);
+  /**
+   * Get the Database instance with all model classes
+   */
+  get database(): Database;
+  /**
+   * Get the InvectAdapter instance for direct adapter access
+   */
+  get adapter(): InvectAdapter;
+  /**
+   * Direct access to flows model
+   */
+  get flows(): FlowsModel;
+  /**
+   * Direct access to flow versions model
+   */
+  get flowVersions(): FlowVersionsModel;
+  /**
+   * Direct access to flow executions model
+   */
+  get flowRuns(): FlowRunsModel;
+  /**
+   * Direct access to execution traces model
+   */
+  get nodeExecutions(): NodeExecutionsModel;
+  /**
+   * Direct access to batch jobs model
+   */
+  get batchJobs(): BatchJobsModel;
+  /**
+   * Direct access to agent tool executions model
+   */
+  get agentToolExecutions(): AgentToolExecutionsModel;
+  /**
+   * Direct access to flow triggers model
+   */
+  get flowTriggers(): FlowTriggersModel;
+  /**
+   * Direct access to chat messages model
+   */
+  get chatMessages(): ChatMessagesModel;
+  /**
+   * Initialize the database connection and models
+   */
+  initialize(): Promise<void>;
+  /**
+   * Get the database connection for sharing with other services
+   */
+  getConnection(): DatabaseConnection;
+  /**
+   * Execute a SQL query on a provided queryDatabase
+   */
+  executeQuery(query: string, queryDBConfig: InvectDatabaseConfig): Promise<Record<string, unknown>[]>;
+  /**
+   * Health check method
+   */
+  healthCheck(): Promise<void>;
+  /**
+   * Close the database connection
+   */
+  close(): Promise<void>;
+  /**
+   * 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: InvectPlugin[]): PluginTableRequirement[];
+  /**
+   * Run a simple `SELECT 1` query to verify the database is reachable.
+   */
+  private runConnectivityCheck;
+  /**
+   * 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).
+   */
+  private runCoreTableCheck;
+  /**
+   * 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.
+   */
+  private runPluginTableChecks;
+  /**
+   * Get a set of table names from the database.
+   */
+  private listTableNames;
+  /**
+   * Log a helpful error when the database connection itself fails.
+   */
+  private logConnectionError;
+  /**
+   * Log a helpful error when the connectivity probe (SELECT 1) fails.
+   */
+  private logConnectivityError;
+  /**
+   * Redact credentials from a connection string for safe logging.
+   */
+  private redactConnectionString;
+}
+/**
+ * Database Models Factory - Creates all model instances with shared connection and logger
+ */
+declare class Database {
+  readonly flows: FlowsModel;
+  readonly flowVersions: FlowVersionsModel;
+  readonly flowRuns: FlowRunsModel;
+  readonly executionTraces: NodeExecutionsModel;
+  readonly batchJobs: BatchJobsModel;
+  readonly agentToolExecutions: AgentToolExecutionsModel;
+  readonly flowTriggers: FlowTriggersModel;
+  readonly chatMessages: ChatMessagesModel;
+  constructor(_connection: DatabaseConnection, logger: Logger, adapter: InvectAdapter);
+}
+//#endregion
+export { DatabaseService };
+//# sourceMappingURL=database.service.d.ts.map

package/dist/services/database/database.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.service.d.ts","names":[],"sources":["../../../src/services/database/database.service.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAuDiB,sBAAA;EACf,QAAA;EACA,UAAA;EACA,MAAA;EACA,iBAAA;AAAA;;;;cAMW,eAAA;EAAA,iBAQQ,YAAA;EAAA,iBACA,MAAA;EAAA,QARX,UAAA;EAAA,QACA,SAAA;EAAA,QACA,QAAA;EAAA,QACA,yBAAA;EAAA,QACA,uBAAA;cAGW,YAAA,EAAc,oBAAA,EACd,MAAA,GAAQ,MAAA,EACzB,kBAAA,GAAqB,yBAAA,EACrB,OAAA,GAAU,YAAA;EAmBG;;;EAAA,IAVX,QAAA,CAAA,GAAY,QAAA;EAyCE;;;EAAA,IA/Bd,OAAA,CAAA,GAAW,aAAA;EA2DC;;;EAAA,IAjDZ,KAAA,CAAA,GAAK,UAAA;EA8HE;;;EAAA,IAvHP,YAAA,CAAA,GAAY,iBAAA;EA8P+B;;;EAAA,IAvP3C,QAAA,CAAA,GAAQ,aAAA;EA9CO;;;EAAA,IAqDf,cAAA,CAAA,GAAc,mBAAA;EA1DV;;;EAAA,IAiEJ,SAAA,CAAA,GAAS,cAAA;EA5DoB;;;EAAA,IAmE7B,mBAAA,CAAA,GAAmB,wBAAA;EAjEA;;;EAAA,IAwEnB,YAAA,CAAA,GAAY,iBAAA;EA9DZ;;;EAAA,IAqEA,YAAA,CAAA,GAAY,iBAAA;EAjDZ;;;EAwDE,UAAA,CAAA,GAAc,OAAA;EA1ChB;;;EAmGJ,aAAA,CAAA,GAAiB,kBAAA;EArFb;;;EA+FE,YAAA,CACJ,KAAA,UACA,aAAA,EAAe,oBAAA,GACd,OAAA,CAAQ,MAAA;EApFP;;;EA8JE,WAAA,CAAA,GAAe,OAAA;EAhJf;;;EAuLA,KAAA,CAAA,GAAS,OAAA;EApHT;;;;;;;;;EAAA,OA0IC,8BAAA,CAA+B,OAAA,EAAS,YAAA,KAAiB,sBAAA;EAAzD;;;EAAA,QAwCO,oBAAA;EAAA;;;;;;;;EAAA,QA4BA,iBAAA;EAiXV;;;;;;;;EAAA,QA9QU,oBAAA;EAqRgB;;;EAAA,QAnKhB,cAAA;EAsKwD;;;EAAA,QAzH9D,kBAAA;EAgHe;;;EAAA,QAnCf,oBAAA;EAqCkB;;;EAAA,QAZlB,sBAAA;AAAA;;;;cASJ,QAAA;EAAA,SACY,KAAA,EAAO,UAAA;EAAA,SACP,YAAA,EAAc,iBAAA;EAAA,SACd,QAAA,EAAU,aAAA;EAAA,SACV,eAAA,EAAiB,mBAAA;EAAA,SACjB,SAAA,EAAW,cAAA;EAAA,SACX,mBAAA,EAAqB,wBAAA;EAAA,SACrB,YAAA,EAAc,iBAAA;EAAA,SACd,YAAA,EAAc,iBAAA;cAElB,WAAA,EAAa,kBAAA,EAAoB,MAAA,EAAQ,MAAA,EAAQ,OAAA,EAAS,aAAA;AAAA"}