@warlock.js/cascade 5.23.2 → 5.25.0

package/esm/contracts/database-driver.contract.d.mts

@@ -12,6 +12,25 @@ import { SyncAdapterContract } from "./sync-adapter.contract.mjs";
 type DriverEvent = "connected" | "disconnected" | string;
 /** Listener signature for driver lifecycle events. */
 type DriverEventListener = (...args: unknown[]) => void;
+/**
+ * Details of a database command after it has settled.
+ *
+ * `connection` is the driver name when emitted by a driver directly, and the
+ * registered data-source name when forwarded by `dataSourceRegistry`.
+ */
+type QueryEvent = {
+  connection: string;
+  driver: "postgres" | "mongodb";
+  sql?: string;
+  bindings?: unknown[];
+  collection?: string;
+  command?: string;
+  pipeline?: unknown;
+  durationMs: number;
+  startedAt: number;
+  rowCount?: number;
+  error?: unknown;
+};
 /** Representation of an opened transaction (manual pattern). */
 interface DriverTransactionContract<TContext = unknown> {
   /** Driver-specific transaction context (session, connection, ...). */
@@ -208,6 +227,8 @@ interface DriverContract {
   getDirtyTracker(data: Record<string, unknown>): DatabaseDirtyTracker;
   /** Register event listeners (connected/disconnected/custom). */
   on(event: DriverEvent, listener: DriverEventListener): void;
+  /** Remove a previously registered event listener. */
+  off(event: DriverEvent, listener: DriverEventListener): void;
   /** Insert a single document/row into the given table. */
   insert(table: string, document: Record<string, unknown>, options?: Record<string, unknown>): Promise<InsertResult>;
   /** Insert multiple documents/rows into the given table. */
@@ -507,5 +528,5 @@ type DropDatabaseOptions = {
   ifExists?: boolean;
 };
 //#endregion
-export { AtomicUpdate, AtomicUpdateOptions, CreateDatabaseOptions, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, FindOneAndUpdateOptions, InsertResult, RawQueryResult, TransactionContext, UpdateOperations, UpdatePipeline, UpdateResult };
+export { AtomicUpdate, AtomicUpdateOptions, CreateDatabaseOptions, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, FindOneAndUpdateOptions, InsertResult, QueryEvent, RawQueryResult, TransactionContext, UpdateOperations, UpdatePipeline, UpdateResult };
 //# sourceMappingURL=database-driver.contract.d.mts.map

package/esm/contracts/database-driver.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-driver.contract.d.mts","names":[],"sources":["../../../../../../../cascade/src/contracts/database-driver.contract.ts"],"mappings":"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"}
+{"version":3,"file":"database-driver.contract.d.mts","names":[],"sources":["../../../../../../../cascade/src/contracts/database-driver.contract.ts"],"mappings":"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"}

package/esm/contracts/index.d.mts

@@ -2,7 +2,7 @@ import { DriverBlueprintContract, TableIndexInformation } from "./driver-bluepri
 import { ColumnDefinition, ColumnType, ForeignKeyDefinition, FullTextIndexOptions, GeoIndexOptions, IndexDefinition, MigrationDriverContract, MigrationDriverFactory, VectorIndexOptions } from "./migration-driver.contract.mjs";
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, LeanDocument, LockForUpdateOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, UnwindOptions, WhereCallback, WhereObject, WhereOperator } from "./query-builder.contract.mjs";
 import { SyncAdapterContract, SyncInstruction } from "./sync-adapter.contract.mjs";
-import { AtomicUpdate, AtomicUpdateOptions, CreateDatabaseOptions, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, FindOneAndUpdateOptions, InsertResult, RawQueryResult, TransactionContext, UpdateOperations, UpdatePipeline, UpdateResult } from "./database-driver.contract.mjs";
+import { AtomicUpdate, AtomicUpdateOptions, CreateDatabaseOptions, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, FindOneAndUpdateOptions, InsertResult, QueryEvent, RawQueryResult, TransactionContext, UpdateOperations, UpdatePipeline, UpdateResult } from "./database-driver.contract.mjs";
 import { GenerateIdOptions, IdGeneratorContract } from "./database-id-generator.contract.mjs";
 import { RemoverContract, RemoverOptions, RemoverResult } from "./database-remover.contract.mjs";
 import { RestorerContract, RestorerOptions, RestorerResult } from "./database-restorer.contract.mjs";

package/esm/data-source/data-source-registry.d.mts

@@ -1,3 +1,4 @@
+import { QueryEvent } from "../contracts/database-driver.contract.mjs";
 import { DataSource, DataSourceOptions } from "./data-source.mjs";
 
 //#region ../cascade/src/data-source/data-source-registry.d.ts
@@ -8,19 +9,20 @@ import { DataSource, DataSourceOptions } from "./data-source.mjs";
  * - `default-registered`: Emitted when a default data source is registered
  * - `connected`: Emitted when a data source's driver connects
  * - `disconnected`: Emitted when a data source's driver disconnects
+ * - `query`: Emitted when a registered driver's query settles
  */
-type DataSourceRegistryEvent = "registered" | "default-registered" | "connected" | "disconnected";
+type DataSourceRegistryEvent = "registered" | "default-registered" | "connected" | "disconnected" | "query";
 /**
  * Callback signature for registry events.
  */
-type DataSourceRegistryListener = (dataSource: DataSource) => void;
+type DataSourceRegistryListener<E extends DataSourceRegistryEvent = DataSourceRegistryEvent> = (data: E extends "query" ? QueryEvent : DataSource) => void;
 /** Maintains registry of named data sources. */
 declare class DataSourceRegistry {
   private readonly sources;
   private defaultSource?;
   private defaultIsExplicit;
   private readonly events;
-  /** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */
+  /** Replaced sources; their forwarded driver events are ignored. */
   private readonly detached;
   /** In-flight `getOrRegister` factories, so concurrent callers share one creation. */
   private readonly pending;
@@ -100,7 +102,7 @@ declare class DataSourceRegistry {
    * });
    * ```
    */
-  on(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void;
+  on<E extends DataSourceRegistryEvent>(event: E, listener: DataSourceRegistryListener<E>): void;
   /**
    * Listen for a data source registration event once.
    *
@@ -109,14 +111,14 @@ declare class DataSourceRegistry {
    * @param event - The event to listen for
    * @param listener - Callback to execute when event fires
    */
-  once(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void;
+  once<E extends DataSourceRegistryEvent>(event: E, listener: DataSourceRegistryListener<E>): void;
   /**
    * Remove a listener for a data source registration event.
    *
    * @param event - The event to stop listening for
    * @param listener - The listener to remove
    */
-  off(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void;
+  off<E extends DataSourceRegistryEvent>(event: E, listener: DataSourceRegistryListener<E>): void;
   /** Retrieve a data source either by name or the default one. */
   get(name?: string): DataSource;
   /**

package/esm/data-source/data-source-registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-registry.d.mts","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"mappings":";;;;;AAaA;;;;AAAmC;AASnC;KATY,uBAAA;;;AASoD;KAApD,0BAAA,IAA8B,UAAsB,EAAV,UAAU;;cAG1D,kBAAA;EAAA,iBACa,OAAA;EAAA,QACT,aAAA;EAAA,QACA,iBAAA;EAAA,iBACS,MAAA;EAiH4B;EAAA,iBA/G5B,QAAA;EAgHN;EAAA,iBA9GM,OAAA;EAoLA;;;;;;;;;;;;;;;;;;;;;;;EA3JV,QAAA,CACL,OAAA,EAAS,iBAAA,EACT,IAAA;IAAS,eAAA;IAA2B,OAAA;EAAA,IACnC,UAAA;EAgFD;;;;EAnBK,UAAA,CAAW,MAAA,EAAQ,UAAA;EAqBvB;;;;;;EAHI,aAAA,CACL,IAAA,UACA,OAAA,QAAe,iBAAA,GAAoB,OAAA,CAAQ,iBAAA,IAC1C,OAAA,CAAQ,UAAA;EAsEyC;;;EA3C7C,UAAA;EAuDK;;;EAhDL,KAAA;EA0DW;;;;;;;;;;AAwDoB;AAKxC;;;;AAA0D;;;;;;;;;;;;;;EAnFjD,EAAA,CAAG,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;;;EAY7C,IAAA,CAAK,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;EAU/C,GAAA,CAAI,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;EAK9C,GAAA,CAAI,IAAA,YAAgB,UAAA;;;;;;;;;;;;;;;;;EAmDpB,iBAAA,IAAqB,UAAA;AAAA;AAAA,cAKjB,kBAAA,EAAkB,kBAA2B"}
+{"version":3,"file":"data-source-registry.d.mts","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"mappings":";;;;;;AAeA;;;;AAAmC;AAMnC;;KANY,uBAAA;;;;KAMA,0BAAA,WACA,uBAAA,GAA0B,uBAAA,KACjC,IAAA,EAAM,CAAA,mBAAoB,UAAA,GAAa,UAAA;;cAGtC,kBAAA;EAAA,iBACa,OAAA;EAAA,QACT,aAAA;EAAA,QACA,iBAAA;EAAA,iBACS,MAAA;EAPR;EAAA,iBASQ,QAAA;EATyB;EAAA,iBAWzB,OAAA;EAXmC;AAAA;AAAU;;;;;;;;;;;;;;;;;;;;;EAoCvD,QAAA,CACL,OAAA,EAAS,iBAAA,EACT,IAAA;IAAS,eAAA;IAA2B,OAAA;EAAA,IACnC,UAAA;EAqPmC;;;;EAlL/B,UAAA,CAAW,MAAA,EAAQ,UAAA;EAnGT;;;;;;EAqHV,aAAA,CACL,IAAA,UACA,OAAA,QAAe,iBAAA,GAAoB,OAAA,CAAQ,iBAAA,IAC1C,OAAA,CAAQ,UAAA;EAzF2B;;;EAoH/B,UAAA;EAhDmB;;;EAuDnB,KAAA;EAnCU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuEV,EAAA,WAAa,uBAAA,EAClB,KAAA,EAAO,CAAA,EACP,QAAA,EAAU,0BAAA,CAA2B,CAAA;EA4BA;;;;;;;;EAfhC,IAAA,WAAe,uBAAA,EACpB,KAAA,EAAO,CAAA,EACP,QAAA,EAAU,0BAAA,CAA2B,CAAA;EA2E5B;;;;AAA6C;;EAhEjD,GAAA,WAAc,uBAAA,EACnB,KAAA,EAAO,CAAA,EACP,QAAA,EAAU,0BAAA,CAA2B,CAAA;;EAMhC,GAAA,CAAI,IAAA,YAAgB,UAAA;;;;;;;;;;;;;;;;;EAmDpB,iBAAA,IAAqB,UAAA;AAAA;AAAA,cAKjB,kBAAA,EAAkB,kBAA2B"}

package/esm/data-source/data-source-registry.mjs

@@ -10,7 +10,7 @@ var DataSourceRegistry = class {
 	defaultSource;
 	defaultIsExplicit = false;
 	events = new EventEmitter();
-	/** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */
+	/** Replaced sources; their forwarded driver events are ignored. */
 	detached = /* @__PURE__ */ new WeakSet();
 	/** In-flight `getOrRegister` factories, so concurrent callers share one creation. */
 	pending = /* @__PURE__ */ new Map();
@@ -61,6 +61,12 @@ var DataSourceRegistry = class {
 		source.driver.on("disconnected", () => {
 			if (!this.detached.has(source)) this.events.emit("disconnected", source);
 		});
+		source.driver.on("query", (event) => {
+			if (!this.detached.has(source)) this.events.emit("query", {
+				...event,
+				connection: source.name
+			});
+		});
 		return source;
 	}
 	/**

package/esm/data-source/data-source-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { databaseDataSourceContext } from \"../context/database-data-source-context\";\nimport { MissingDataSourceError } from \"../errors/missing-data-source.error\";\nimport { DataSource, type DataSourceOptions } from \"./data-source\";\n\n/**\n * Event types emitted by the DataSourceRegistry.\n *\n * - `registered`: Emitted when any data source is registered\n * - `default-registered`: Emitted when a default data source is registered\n * - `connected`: Emitted when a data source's driver connects\n * - `disconnected`: Emitted when a data source's driver disconnects\n */\nexport type DataSourceRegistryEvent =\n  | \"registered\"\n  | \"default-registered\"\n  | \"connected\"\n  | \"disconnected\";\n\n/**\n * Callback signature for registry events.\n */\nexport type DataSourceRegistryListener = (dataSource: DataSource) => void;\n\n/** Maintains registry of named data sources. */\nclass DataSourceRegistry {\n  private readonly sources = new Map<string, DataSource>();\n  private defaultSource?: DataSource;\n  private defaultIsExplicit = false;\n  private readonly events = new EventEmitter();\n  /** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */\n  private readonly detached = new WeakSet<DataSource>();\n  /** In-flight `getOrRegister` factories, so concurrent callers share one creation. */\n  private readonly pending = new Map<string, Promise<DataSource>>();\n\n  /**\n   * Register a new data source definition.\n   *\n   * Sets up event forwarding from the driver to the registry, allowing\n   * centralized listening for connection state changes.\n   *\n   * **Emits:**\n   * - `registered` - When the data source is registered\n   * - `default-registered` - If this becomes the default data source\n   * - `connected` - When the driver connects (forwarded from driver)\n   * - `disconnected` - When the driver disconnects (forwarded from driver)\n   *\n   * The first registered source becomes the default. Later sources become the default\n   * only when they explicitly claim it, and two explicit claims throw.\n   *\n   * @param options - Data source configuration\n   * @param meta - `explicitDefault` tells whether the caller explicitly requested `isDefault: true`\n   *  (defaults to `options.isDefault`), as opposed to it being implied by being the first source.\n   *  `replace: true` also disconnects the previously registered source of the same name (in the\n   *  background). Either way the old source's events stop being forwarded and, if it was the\n   *  default, the new source takes its place.\n   * @returns The registered data source instance\n   */\n  public register(\n    options: DataSourceOptions,\n    meta?: { explicitDefault?: boolean; replace?: boolean },\n  ): DataSource {\n    const source = new DataSource(options);\n    const explicitDefault = meta?.explicitDefault ?? source.isDefault;\n\n    if (\n      explicitDefault &&\n      this.defaultIsExplicit &&\n      this.defaultSource &&\n      this.defaultSource.name !== source.name\n    ) {\n      throw new Error(\n        `Data source \"${source.name}\" cannot be the default: \"${this.defaultSource.name}\" is already the default data source.`,\n      );\n    }\n\n    const previous = this.sources.get(source.name);\n\n    this.sources.set(source.name, source);\n\n    if (previous) {\n      this.detached.add(previous);\n\n      if (meta?.replace) {\n        previous.driver.disconnect().catch(() => undefined);\n      }\n    }\n\n    // A replaced default hands the default over to its replacement, otherwise get()\n    // would keep returning the stale source.\n    const replacesDefault = previous !== undefined && previous === this.defaultSource;\n    const isNewDefault = explicitDefault || !this.defaultSource || replacesDefault;\n\n    if (isNewDefault) {\n      this.defaultSource = source;\n      this.defaultIsExplicit = replacesDefault\n        ? this.defaultIsExplicit || explicitDefault\n        : explicitDefault;\n    }\n\n    // Emit registration events\n    this.events.emit(\"registered\", source);\n\n    if (isNewDefault) {\n      this.events.emit(\"default-registered\", source);\n    }\n\n    source.driver.on(\"connected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"connected\", source);\n    });\n\n    source.driver.on(\"disconnected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"disconnected\", source);\n    });\n\n    return source;\n  }\n\n  /**\n   * Remove a registered source (only if it is still the one registered under its name).\n   * If it was the default, the registry has no default until another source claims it.\n   */\n  public unregister(source: DataSource): void {\n    if (this.sources.get(source.name) !== source) return;\n\n    this.sources.delete(source.name);\n    this.detached.add(source);\n\n    if (this.defaultSource === source) {\n      this.defaultSource = undefined;\n      this.defaultIsExplicit = false;\n    }\n  }\n\n  /**\n   * Return the registered source for `name`, or create and register it via `factory`.\n   *\n   * Concurrent callers for the same name share one in-flight factory call, so only one\n   * driver/pool is created. A failed factory is not cached.\n   */\n  public getOrRegister(\n    name: string,\n    factory: () => DataSourceOptions | Promise<DataSourceOptions>,\n  ): Promise<DataSource> {\n    const existing = this.sources.get(name);\n\n    if (existing) return Promise.resolve(existing);\n\n    const inFlight = this.pending.get(name);\n\n    if (inFlight) return inFlight;\n\n    const promise = (async () => {\n      try {\n        const options = await factory();\n\n        return this.sources.get(name) ?? this.register({ ...options, name });\n      } finally {\n        this.pending.delete(name);\n      }\n    })();\n\n    this.pending.set(name, promise);\n\n    return promise;\n  }\n\n  /**\n   * Determine whether a default data source is already registered.\n   */\n  public hasDefault(): boolean {\n    return this.defaultSource !== undefined;\n  }\n\n  /**\n   * Clean up all data sources and default one\n   */\n  public clear() {\n    this.defaultSource = undefined;\n    this.defaultIsExplicit = false;\n    this.sources.clear();\n    this.pending.clear();\n  }\n\n  /**\n   * Listen for data source registry events.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   *\n   * @example\n   * ```typescript\n   * // Listen for registration\n   * dataSourceRegistry.on(\"registered\", (ds) => {\n   *   console.log(`Data source \"${ds.name}\" registered`);\n   *   console.log(`Driver: ${ds.driver.name}`); // e.g., \"mongodb\"\n   * });\n   *\n   * // Listen for default data source\n   * dataSourceRegistry.on(\"default-registered\", (ds) => {\n   *   console.log(`Default data source set to \"${ds.name}\"`);\n   * });\n   *\n   * // Listen for connection events (forwarded from drivers)\n   * dataSourceRegistry.on(\"connected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" connected`);\n   * });\n   *\n   * dataSourceRegistry.on(\"disconnected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" disconnected`);\n   * });\n   * ```\n   */\n  public on(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.on(event, listener);\n  }\n\n  /**\n   * Listen for a data source registration event once.\n   *\n   * The listener is automatically removed after being called once.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   */\n  public once(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.once(event, listener);\n  }\n\n  /**\n   * Remove a listener for a data source registration event.\n   *\n   * @param event - The event to stop listening for\n   * @param listener - The listener to remove\n   */\n  public off(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.off(event, listener);\n  }\n\n  /** Retrieve a data source either by name or the default one. */\n  public get(name?: string): DataSource {\n    const contextSource = name == null ? databaseDataSourceContext.getDataSource() : null;\n\n    if (contextSource) {\n      if (contextSource instanceof DataSource) {\n        return contextSource;\n      }\n\n      const override = this.sources.get(contextSource);\n\n      if (!override) {\n        throw new MissingDataSourceError(\n          `Data source \"${contextSource}\" is not registered (context override).`,\n          contextSource,\n        );\n      }\n\n      return override;\n    }\n\n    if (name != null) {\n      const source = this.sources.get(name);\n      if (!source) {\n        throw new MissingDataSourceError(`Data source \"${name}\" is not registered.`, name);\n      }\n      return source;\n    }\n\n    if (!this.defaultSource) {\n      throw new MissingDataSourceError(\"No default data source registered.\");\n    }\n\n    return this.defaultSource;\n  }\n\n  /**\n   * Get all registered data sources.\n   *\n   * Useful for operations that need to iterate over all sources,\n   * such as shutting down all connections.\n   *\n   * @returns Array of all registered data sources\n   *\n   * @example\n   * ```typescript\n   * // Shutdown all data sources\n   * for (const dataSource of dataSourceRegistry.getAllDataSources()) {\n   *   await dataSource.driver.disconnect();\n   * }\n   * ```\n   */\n  public getAllDataSources(): DataSource[] {\n    return Array.from(this.sources.values());\n  }\n}\n\nexport const dataSourceRegistry = new DataSourceRegistry();\n"],"mappings":"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"}
+{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { databaseDataSourceContext } from \"../context/database-data-source-context\";\nimport { MissingDataSourceError } from \"../errors/missing-data-source.error\";\nimport { DataSource, type DataSourceOptions } from \"./data-source\";\nimport type { QueryEvent } from \"../contracts/database-driver.contract\";\n\n/**\n * Event types emitted by the DataSourceRegistry.\n *\n * - `registered`: Emitted when any data source is registered\n * - `default-registered`: Emitted when a default data source is registered\n * - `connected`: Emitted when a data source's driver connects\n * - `disconnected`: Emitted when a data source's driver disconnects\n * - `query`: Emitted when a registered driver's query settles\n */\nexport type DataSourceRegistryEvent =\n  \"registered\" | \"default-registered\" | \"connected\" | \"disconnected\" | \"query\";\n\n/**\n * Callback signature for registry events.\n */\nexport type DataSourceRegistryListener<\n  E extends DataSourceRegistryEvent = DataSourceRegistryEvent,\n> = (data: E extends \"query\" ? QueryEvent : DataSource) => void;\n\n/** Maintains registry of named data sources. */\nclass DataSourceRegistry {\n  private readonly sources = new Map<string, DataSource>();\n  private defaultSource?: DataSource;\n  private defaultIsExplicit = false;\n  private readonly events = new EventEmitter();\n  /** Replaced sources; their forwarded driver events are ignored. */\n  private readonly detached = new WeakSet<DataSource>();\n  /** In-flight `getOrRegister` factories, so concurrent callers share one creation. */\n  private readonly pending = new Map<string, Promise<DataSource>>();\n\n  /**\n   * Register a new data source definition.\n   *\n   * Sets up event forwarding from the driver to the registry, allowing\n   * centralized listening for connection state changes.\n   *\n   * **Emits:**\n   * - `registered` - When the data source is registered\n   * - `default-registered` - If this becomes the default data source\n   * - `connected` - When the driver connects (forwarded from driver)\n   * - `disconnected` - When the driver disconnects (forwarded from driver)\n   *\n   * The first registered source becomes the default. Later sources become the default\n   * only when they explicitly claim it, and two explicit claims throw.\n   *\n   * @param options - Data source configuration\n   * @param meta - `explicitDefault` tells whether the caller explicitly requested `isDefault: true`\n   *  (defaults to `options.isDefault`), as opposed to it being implied by being the first source.\n   *  `replace: true` also disconnects the previously registered source of the same name (in the\n   *  background). Either way the old source's events stop being forwarded and, if it was the\n   *  default, the new source takes its place.\n   * @returns The registered data source instance\n   */\n  public register(\n    options: DataSourceOptions,\n    meta?: { explicitDefault?: boolean; replace?: boolean },\n  ): DataSource {\n    const source = new DataSource(options);\n    const explicitDefault = meta?.explicitDefault ?? source.isDefault;\n\n    if (\n      explicitDefault &&\n      this.defaultIsExplicit &&\n      this.defaultSource &&\n      this.defaultSource.name !== source.name\n    ) {\n      throw new Error(\n        `Data source \"${source.name}\" cannot be the default: \"${this.defaultSource.name}\" is already the default data source.`,\n      );\n    }\n\n    const previous = this.sources.get(source.name);\n\n    this.sources.set(source.name, source);\n\n    if (previous) {\n      this.detached.add(previous);\n\n      if (meta?.replace) {\n        previous.driver.disconnect().catch(() => undefined);\n      }\n    }\n\n    // A replaced default hands the default over to its replacement, otherwise get()\n    // would keep returning the stale source.\n    const replacesDefault = previous !== undefined && previous === this.defaultSource;\n    const isNewDefault = explicitDefault || !this.defaultSource || replacesDefault;\n\n    if (isNewDefault) {\n      this.defaultSource = source;\n      this.defaultIsExplicit = replacesDefault\n        ? this.defaultIsExplicit || explicitDefault\n        : explicitDefault;\n    }\n\n    // Emit registration events\n    this.events.emit(\"registered\", source);\n\n    if (isNewDefault) {\n      this.events.emit(\"default-registered\", source);\n    }\n\n    source.driver.on(\"connected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"connected\", source);\n    });\n\n    source.driver.on(\"disconnected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"disconnected\", source);\n    });\n\n    source.driver.on(\"query\", (event) => {\n      if (!this.detached.has(source)) {\n        this.events.emit(\"query\", { ...(event as QueryEvent), connection: source.name });\n      }\n    });\n\n    return source;\n  }\n\n  /**\n   * Remove a registered source (only if it is still the one registered under its name).\n   * If it was the default, the registry has no default until another source claims it.\n   */\n  public unregister(source: DataSource): void {\n    if (this.sources.get(source.name) !== source) return;\n\n    this.sources.delete(source.name);\n    this.detached.add(source);\n\n    if (this.defaultSource === source) {\n      this.defaultSource = undefined;\n      this.defaultIsExplicit = false;\n    }\n  }\n\n  /**\n   * Return the registered source for `name`, or create and register it via `factory`.\n   *\n   * Concurrent callers for the same name share one in-flight factory call, so only one\n   * driver/pool is created. A failed factory is not cached.\n   */\n  public getOrRegister(\n    name: string,\n    factory: () => DataSourceOptions | Promise<DataSourceOptions>,\n  ): Promise<DataSource> {\n    const existing = this.sources.get(name);\n\n    if (existing) return Promise.resolve(existing);\n\n    const inFlight = this.pending.get(name);\n\n    if (inFlight) return inFlight;\n\n    const promise = (async () => {\n      try {\n        const options = await factory();\n\n        return this.sources.get(name) ?? this.register({ ...options, name });\n      } finally {\n        this.pending.delete(name);\n      }\n    })();\n\n    this.pending.set(name, promise);\n\n    return promise;\n  }\n\n  /**\n   * Determine whether a default data source is already registered.\n   */\n  public hasDefault(): boolean {\n    return this.defaultSource !== undefined;\n  }\n\n  /**\n   * Clean up all data sources and default one\n   */\n  public clear() {\n    this.defaultSource = undefined;\n    this.defaultIsExplicit = false;\n    this.sources.clear();\n    this.pending.clear();\n  }\n\n  /**\n   * Listen for data source registry events.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   *\n   * @example\n   * ```typescript\n   * // Listen for registration\n   * dataSourceRegistry.on(\"registered\", (ds) => {\n   *   console.log(`Data source \"${ds.name}\" registered`);\n   *   console.log(`Driver: ${ds.driver.name}`); // e.g., \"mongodb\"\n   * });\n   *\n   * // Listen for default data source\n   * dataSourceRegistry.on(\"default-registered\", (ds) => {\n   *   console.log(`Default data source set to \"${ds.name}\"`);\n   * });\n   *\n   * // Listen for connection events (forwarded from drivers)\n   * dataSourceRegistry.on(\"connected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" connected`);\n   * });\n   *\n   * dataSourceRegistry.on(\"disconnected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" disconnected`);\n   * });\n   * ```\n   */\n  public on<E extends DataSourceRegistryEvent>(\n    event: E,\n    listener: DataSourceRegistryListener<E>,\n  ): void {\n    this.events.on(event, listener);\n  }\n\n  /**\n   * Listen for a data source registration event once.\n   *\n   * The listener is automatically removed after being called once.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   */\n  public once<E extends DataSourceRegistryEvent>(\n    event: E,\n    listener: DataSourceRegistryListener<E>,\n  ): void {\n    this.events.once(event, listener);\n  }\n\n  /**\n   * Remove a listener for a data source registration event.\n   *\n   * @param event - The event to stop listening for\n   * @param listener - The listener to remove\n   */\n  public off<E extends DataSourceRegistryEvent>(\n    event: E,\n    listener: DataSourceRegistryListener<E>,\n  ): void {\n    this.events.off(event, listener);\n  }\n\n  /** Retrieve a data source either by name or the default one. */\n  public get(name?: string): DataSource {\n    const contextSource = name == null ? databaseDataSourceContext.getDataSource() : null;\n\n    if (contextSource) {\n      if (contextSource instanceof DataSource) {\n        return contextSource;\n      }\n\n      const override = this.sources.get(contextSource);\n\n      if (!override) {\n        throw new MissingDataSourceError(\n          `Data source \"${contextSource}\" is not registered (context override).`,\n          contextSource,\n        );\n      }\n\n      return override;\n    }\n\n    if (name != null) {\n      const source = this.sources.get(name);\n      if (!source) {\n        throw new MissingDataSourceError(`Data source \"${name}\" is not registered.`, name);\n      }\n      return source;\n    }\n\n    if (!this.defaultSource) {\n      throw new MissingDataSourceError(\"No default data source registered.\");\n    }\n\n    return this.defaultSource;\n  }\n\n  /**\n   * Get all registered data sources.\n   *\n   * Useful for operations that need to iterate over all sources,\n   * such as shutting down all connections.\n   *\n   * @returns Array of all registered data sources\n   *\n   * @example\n   * ```typescript\n   * // Shutdown all data sources\n   * for (const dataSource of dataSourceRegistry.getAllDataSources()) {\n   *   await dataSource.driver.disconnect();\n   * }\n   * ```\n   */\n  public getAllDataSources(): DataSource[] {\n    return Array.from(this.sources.values());\n  }\n}\n\nexport const dataSourceRegistry = new DataSourceRegistry();\n"],"mappings":"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"}

package/esm/drivers/mongodb/mongodb-driver.d.mts

@@ -30,6 +30,7 @@ declare class MongoDbDriver implements DriverContract {
   private readonly transactionOptions;
   private idGeneratorInstance?;
   private _blueprint?;
+  private readonly monitoredCommands;
   get blueprint(): DriverBlueprintContract;
   /**
    * The name of this driver.
@@ -120,6 +121,8 @@ declare class MongoDbDriver implements DriverContract {
    * Subscribe to driver lifecycle events.
    */
   on(event: DriverEvent, listener: DriverEventListener): void;
+  /** Remove a previously registered driver event listener. */
+  off(event: DriverEvent, listener: DriverEventListener): void;
   /**
    * Insert a single document into the given collection.
    */
@@ -263,6 +266,16 @@ declare class MongoDbDriver implements DriverContract {
    * Emit a driver lifecycle event.
    */
   private emit;
+  private commandStarted;
+  private commandSucceeded;
+  private commandFailed;
+  /**
+   * Emit a `query` event. It runs inside the MongoDB client's own monitoring
+   * callback, and an observer must never break the client, so a throwing
+   * listener is swallowed here.
+   */
+  private emitQueryEvent;
+  private ignoredCommand;
   /**
    * Ensure MongoDB is running as a replica set (required for transactions).
    *

package/esm/drivers/mongodb/mongodb-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":"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"}
+{"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":"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"}

package/esm/drivers/mongodb/mongodb-driver.mjs

@@ -87,6 +87,7 @@ var MongoDbDriver = class {
 	transactionOptions;
 	idGeneratorInstance;
 	_blueprint;
+	monitoredCommands = /* @__PURE__ */ new Map();
 	get blueprint() {
 		if (!this._blueprint) this._blueprint = new MongoDBBlueprint(this.database);
 		return this._blueprint;
@@ -214,13 +215,18 @@ var MongoDbDriver = class {
 					log.warn("database.mongodb", "connection", "Disconnected from database");
 				}
 			});
+			client.on("commandStarted", (event) => this.commandStarted(event));
+			client.on("commandSucceeded", (event) => this.commandSucceeded(event));
+			client.on("commandFailed", (event) => this.commandFailed(event));
 			if (this.config.logging) {
 				const ignoredCommands = [
 					"isMaster",
 					"hello",
 					"ping",
 					"saslStart",
-					"saslContinue"
+					"saslContinue",
+					"endSessions",
+					"buildInfo"
 				];
 				client.on("commandStarted", (event) => {
 					if (ignoredCommands.includes(event.commandName)) return;
@@ -277,6 +283,10 @@ var MongoDbDriver = class {
 	on(event, listener) {
 		this.events.on(event, listener);
 	}
+	/** Remove a previously registered driver event listener. */
+	off(event, listener) {
+		this.events.off(event, listener);
+	}
 	/**
 	* Insert a single document into the given collection.
 	*/
@@ -593,7 +603,7 @@ var MongoDbDriver = class {
 	*/
 	buildClientOptions() {
 		const baseOptions = { ...this.config.clientOptions ?? {} };
-		if (this.config.logging) baseOptions.monitorCommands = true;
+		if (baseOptions.monitorCommands === void 0) baseOptions.monitorCommands = true;
 		if (this.config.username && !baseOptions.auth) baseOptions.auth = {
 			username: this.config.username,
 			password: this.config.password
@@ -607,6 +617,65 @@ var MongoDbDriver = class {
 	emit(event, ...args) {
 		this.events.emit(event, ...args);
 	}
+	commandStarted(event) {
+		if (this.ignoredCommand(event.commandName) || this.events.listenerCount("query") === 0) return;
+		const started = performance.now();
+		const { lsid: _lsid, $clusterTime: _clusterTime, $db: _database, ...pipeline } = event.command;
+		const collection = event.command[event.commandName];
+		this.monitoredCommands.set(event.requestId, {
+			connection: this.name,
+			driver: "mongodb",
+			command: event.commandName,
+			collection: typeof collection === "string" ? collection : void 0,
+			pipeline,
+			started,
+			startedAt: performance.timeOrigin + started
+		});
+	}
+	commandSucceeded(event) {
+		const command = this.monitoredCommands.get(event.requestId);
+		if (!command) return;
+		this.monitoredCommands.delete(event.requestId);
+		const { started, ...query } = command;
+		const rowCount = event.reply?.n ?? event.reply?.cursor?.firstBatch?.length;
+		this.emitQueryEvent({
+			...query,
+			durationMs: performance.now() - started,
+			...typeof rowCount === "number" ? { rowCount } : {}
+		});
+	}
+	commandFailed(event) {
+		const command = this.monitoredCommands.get(event.requestId);
+		if (!command) return;
+		this.monitoredCommands.delete(event.requestId);
+		const { started, ...query } = command;
+		this.emitQueryEvent({
+			...query,
+			durationMs: performance.now() - started,
+			error: event.failure
+		});
+	}
+	/**
+	* Emit a `query` event. It runs inside the MongoDB client's own monitoring
+	* callback, and an observer must never break the client, so a throwing
+	* listener is swallowed here.
+	*/
+	emitQueryEvent(event) {
+		try {
+			this.emit("query", event);
+		} catch {}
+	}
+	ignoredCommand(command) {
+		return [
+			"isMaster",
+			"hello",
+			"ping",
+			"saslStart",
+			"saslContinue",
+			"endSessions",
+			"buildInfo"
+		].includes(command);
+	}
 	/**
 	* Ensure MongoDB is running as a replica set (required for transactions).
 	*