@warlock.js/cascade 4.0.171 → 4.1.1

package/esm/contracts/query-builder.contract.d.mts.map

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

package/esm/contracts/sync-adapter.contract.d.mts

@@ -0,0 +1,49 @@
+//#region ../../@warlock.js/cascade/src/contracts/sync-adapter.contract.d.ts
+/**
+ * Instruction for a sync operation.
+ * Contains all information needed to perform a sync update.
+ */
+type SyncInstruction = {
+  /** Target table/collection name */targetTable: string; /** Target model name */
+  targetModel: string; /** Filter to identify documents to update */
+  filter: Record<string, unknown>; /** Update operations to apply */
+  update: Record<string, unknown>; /** Current depth in the sync chain */
+  depth: number; /** Chain of model names leading to this instruction */
+  chain: string[]; /** Source model name */
+  sourceModel: string; /** Source model ID */
+  sourceId: string | number; /** Whether this is an array update (requires positional operator) */
+  isArrayUpdate?: boolean; /** Array field path for positional updates */
+  arrayField?: string; /** Identifier field for array matching */
+  identifierField?: string; /** Identifier value for array matching */
+  identifierValue?: string | number;
+};
+/**
+ * Contract for database-specific sync adapters.
+ * Handles the execution of sync operations at the driver level.
+ */
+interface SyncAdapterContract {
+  /**
+   * Executes a batch of sync instructions.
+   *
+   * @param instructions - Array of sync instructions to execute
+   * @returns Number of documents affected
+   */
+  executeBatch(instructions: SyncInstruction[]): Promise<number>;
+  /**
+   * Executes a single sync instruction.
+   *
+   * @param instruction - The sync instruction to execute
+   * @returns Number of documents affected
+   */
+  executeOne(instruction: SyncInstruction): Promise<number>;
+  /**
+   * Executes an array update instruction with positional operators.
+   *
+   * @param instruction - The sync instruction with array update info
+   * @returns Number of documents affected
+   */
+  executeArrayUpdate(instruction: SyncInstruction): Promise<number>;
+}
+//#endregion
+export { SyncAdapterContract, SyncInstruction };
+//# sourceMappingURL=sync-adapter.contract.d.mts.map

package/esm/contracts/sync-adapter.contract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-adapter.contract.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/contracts/sync-adapter.contract.ts"],"mappings":";;AAIA;;;KAAY,eAAA;EAEV,mCAAA,WAAA,UAMA;EAHA,WAAA,UAMA;EAHA,MAAA,EAAQ,MAAA,mBAMR;EAHA,MAAA,EAAQ,MAAM,mBASd;EANA,KAAA,UAYA;EATA,KAAA,YAeA;EAZA,WAAA,UAee;EAZf,QAAA,mBAmBe;EAhBf,aAAA;EAGA,UAAA,WAoB+C;EAjB/C,eAAA,WAyB0C;EAtB1C,eAAA;AAAA;;;;;UAOe,mBAAA;EAOgC;;;;;;EAA/C,YAAA,CAAa,YAAA,EAAc,eAAA,KAAoB,OAAA;EAgB5B;;;AAAsC;;;EARzD,UAAA,CAAW,WAAA,EAAa,eAAA,GAAkB,OAAA;;;;;;;EAQ1C,kBAAA,CAAmB,WAAA,EAAa,eAAA,GAAkB,OAAA;AAAA"}

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

@@ -0,0 +1,111 @@
+import { DataSource, DataSourceOptions } from "./data-source.mjs";
+
+//#region ../../@warlock.js/cascade/src/data-source/data-source-registry.d.ts
+/**
+ * Event types emitted by the DataSourceRegistry.
+ *
+ * - `registered`: Emitted when any data source is registered
+ * - `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
+ */
+type DataSourceRegistryEvent = "registered" | "default-registered" | "connected" | "disconnected";
+/**
+ * Callback signature for registry events.
+ */
+type DataSourceRegistryListener = (dataSource: DataSource) => void;
+/** Maintains registry of named data sources. */
+declare class DataSourceRegistry {
+  private readonly sources;
+  private defaultSource?;
+  private readonly events;
+  /**
+   * Register a new data source definition.
+   *
+   * Sets up event forwarding from the driver to the registry, allowing
+   * centralized listening for connection state changes.
+   *
+   * **Emits:**
+   * - `registered` - When the data source is registered
+   * - `default-registered` - If this becomes the default data source
+   * - `connected` - When the driver connects (forwarded from driver)
+   * - `disconnected` - When the driver disconnects (forwarded from driver)
+   *
+   * @param options - Data source configuration
+   * @returns The registered data source instance
+   */
+  register(options: DataSourceOptions): DataSource;
+  /**
+   * Clean up all data sources and default one
+   */
+  clear(): void;
+  /**
+   * Listen for data source registry events.
+   *
+   * @param event - The event to listen for
+   * @param listener - Callback to execute when event fires
+   *
+   * @example
+   * ```typescript
+   * // Listen for registration
+   * dataSourceRegistry.on("registered", (ds) => {
+   *   console.log(`Data source "${ds.name}" registered`);
+   *   console.log(`Driver: ${ds.driver.name}`); // e.g., "mongodb"
+   * });
+   *
+   * // Listen for default data source
+   * dataSourceRegistry.on("default-registered", (ds) => {
+   *   console.log(`Default data source set to "${ds.name}"`);
+   * });
+   *
+   * // Listen for connection events (forwarded from drivers)
+   * dataSourceRegistry.on("connected", (ds) => {
+   *   console.log(`${ds.driver.name} data source "${ds.name}" connected`);
+   * });
+   *
+   * dataSourceRegistry.on("disconnected", (ds) => {
+   *   console.log(`${ds.driver.name} data source "${ds.name}" disconnected`);
+   * });
+   * ```
+   */
+  on(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void;
+  /**
+   * Listen for a data source registration event once.
+   *
+   * The listener is automatically removed after being called once.
+   *
+   * @param event - The event to listen for
+   * @param listener - Callback to execute when event fires
+   */
+  once(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): 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;
+  /** Retrieve a data source either by name or the default one. */
+  get(name?: string): DataSource;
+  /**
+   * Get all registered data sources.
+   *
+   * Useful for operations that need to iterate over all sources,
+   * such as shutting down all connections.
+   *
+   * @returns Array of all registered data sources
+   *
+   * @example
+   * ```typescript
+   * // Shutdown all data sources
+   * for (const dataSource of dataSourceRegistry.getAllDataSources()) {
+   *   await dataSource.driver.disconnect();
+   * }
+   * ```
+   */
+  getAllDataSources(): DataSource[];
+}
+declare const dataSourceRegistry: DataSourceRegistry;
+//#endregion
+export { DataSourceRegistryEvent, DataSourceRegistryListener, dataSourceRegistry };
+//# sourceMappingURL=data-source-registry.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-registry.d.mts","names":[],"sources":["../../../../../../@warlock.js/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,iBACS,MAAA;EAkFmC;;;;;;;;;;;;;;;EAjE7C,QAAA,CAAS,OAAA,EAAS,iBAAA,GAAoB,UAAA;EA+BtC;;;EAAA,KAAA,CAAA;EAkC6C;;;;;;;;;;;;;;;;;;AA8Ed;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,CAAA,GAAqB,UAAA;AAAA;AAAA,cAKjB,kBAAA,EAAkB,kBAA2B"}

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

@@ -0,0 +1,142 @@
+import { databaseDataSourceContext } from "../context/database-data-source-context.mjs";
+import { DataSource } from "./data-source.mjs";
+import { MissingDataSourceError } from "../errors/missing-data-source.error.mjs";
+import { EventEmitter } from "node:events";
+
+//#region ../../@warlock.js/cascade/src/data-source/data-source-registry.ts
+/** Maintains registry of named data sources. */
+var DataSourceRegistry = class {
+	sources = /* @__PURE__ */ new Map();
+	defaultSource;
+	events = new EventEmitter();
+	/**
+	* Register a new data source definition.
+	*
+	* Sets up event forwarding from the driver to the registry, allowing
+	* centralized listening for connection state changes.
+	*
+	* **Emits:**
+	* - `registered` - When the data source is registered
+	* - `default-registered` - If this becomes the default data source
+	* - `connected` - When the driver connects (forwarded from driver)
+	* - `disconnected` - When the driver disconnects (forwarded from driver)
+	*
+	* @param options - Data source configuration
+	* @returns The registered data source instance
+	*/
+	register(options) {
+		const source = new DataSource(options);
+		this.sources.set(source.name, source);
+		const isNewDefault = source.isDefault || !this.defaultSource;
+		if (isNewDefault) this.defaultSource = source;
+		this.events.emit("registered", source);
+		if (isNewDefault) this.events.emit("default-registered", source);
+		source.driver.on("connected", () => {
+			this.events.emit("connected", source);
+		});
+		source.driver.on("disconnected", () => {
+			this.events.emit("disconnected", source);
+		});
+		return source;
+	}
+	/**
+	* Clean up all data sources and default one
+	*/
+	clear() {
+		this.defaultSource = void 0;
+		this.sources.clear();
+	}
+	/**
+	* Listen for data source registry events.
+	*
+	* @param event - The event to listen for
+	* @param listener - Callback to execute when event fires
+	*
+	* @example
+	* ```typescript
+	* // Listen for registration
+	* dataSourceRegistry.on("registered", (ds) => {
+	*   console.log(`Data source "${ds.name}" registered`);
+	*   console.log(`Driver: ${ds.driver.name}`); // e.g., "mongodb"
+	* });
+	*
+	* // Listen for default data source
+	* dataSourceRegistry.on("default-registered", (ds) => {
+	*   console.log(`Default data source set to "${ds.name}"`);
+	* });
+	*
+	* // Listen for connection events (forwarded from drivers)
+	* dataSourceRegistry.on("connected", (ds) => {
+	*   console.log(`${ds.driver.name} data source "${ds.name}" connected`);
+	* });
+	*
+	* dataSourceRegistry.on("disconnected", (ds) => {
+	*   console.log(`${ds.driver.name} data source "${ds.name}" disconnected`);
+	* });
+	* ```
+	*/
+	on(event, listener) {
+		this.events.on(event, listener);
+	}
+	/**
+	* Listen for a data source registration event once.
+	*
+	* The listener is automatically removed after being called once.
+	*
+	* @param event - The event to listen for
+	* @param listener - Callback to execute when event fires
+	*/
+	once(event, listener) {
+		this.events.once(event, listener);
+	}
+	/**
+	* 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, listener) {
+		this.events.off(event, listener);
+	}
+	/** Retrieve a data source either by name or the default one. */
+	get(name) {
+		const contextSource = name == null ? databaseDataSourceContext.getDataSource() : null;
+		if (contextSource) {
+			if (contextSource instanceof DataSource) return contextSource;
+			const override = this.sources.get(contextSource);
+			if (!override) throw new MissingDataSourceError(`Data source "${contextSource}" is not registered (context override).`, contextSource);
+			return override;
+		}
+		if (name != null) {
+			const source = this.sources.get(name);
+			if (!source) throw new MissingDataSourceError(`Data source "${name}" is not registered.`, name);
+			return source;
+		}
+		if (!this.defaultSource) throw new MissingDataSourceError("No default data source registered.");
+		return this.defaultSource;
+	}
+	/**
+	* Get all registered data sources.
+	*
+	* Useful for operations that need to iterate over all sources,
+	* such as shutting down all connections.
+	*
+	* @returns Array of all registered data sources
+	*
+	* @example
+	* ```typescript
+	* // Shutdown all data sources
+	* for (const dataSource of dataSourceRegistry.getAllDataSources()) {
+	*   await dataSource.driver.disconnect();
+	* }
+	* ```
+	*/
+	getAllDataSources() {
+		return Array.from(this.sources.values());
+	}
+};
+const dataSourceRegistry = new DataSourceRegistry();
+
+//#endregion
+export { dataSourceRegistry };
+//# sourceMappingURL=data-source-registry.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../@warlock.js/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 readonly events = new EventEmitter();\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   * @param options - Data source configuration\n   * @returns The registered data source instance\n   */\n  public register(options: DataSourceOptions): DataSource {\n    const source = new DataSource(options);\n    this.sources.set(source.name, source);\n\n    const isNewDefault = source.isDefault || !this.defaultSource;\n\n    if (isNewDefault) {\n      this.defaultSource = source;\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      this.events.emit(\"connected\", source);\n    });\n\n    source.driver.on(\"disconnected\", () => {\n      this.events.emit(\"disconnected\", source);\n    });\n\n    return source;\n  }\n\n  /**\n   * Clean up all data sources and default one\n   */\n  public clear() {\n    this.defaultSource = undefined;\n    this.sources.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":";;;;;;;AAyBA,IAAM,qBAAN,MAAyB;CACvB,AAAiB,0BAAU,IAAI,IAAwB;CACvD,AAAQ;CACR,AAAiB,SAAS,IAAI,aAAa;;;;;;;;;;;;;;;;CAiB3C,AAAO,SAAS,SAAwC;EACtD,MAAM,SAAS,IAAI,WAAW,OAAO;EACrC,KAAK,QAAQ,IAAI,OAAO,MAAM,MAAM;EAEpC,MAAM,eAAe,OAAO,aAAa,CAAC,KAAK;EAE/C,IAAI,cACF,KAAK,gBAAgB;EAIvB,KAAK,OAAO,KAAK,cAAc,MAAM;EAErC,IAAI,cACF,KAAK,OAAO,KAAK,sBAAsB,MAAM;EAG/C,OAAO,OAAO,GAAG,mBAAmB;GAClC,KAAK,OAAO,KAAK,aAAa,MAAM;EACtC,CAAC;EAED,OAAO,OAAO,GAAG,sBAAsB;GACrC,KAAK,OAAO,KAAK,gBAAgB,MAAM;EACzC,CAAC;EAED,OAAO;CACT;;;;CAKA,AAAO,QAAQ;EACb,KAAK,gBAAgB;EACrB,KAAK,QAAQ,MAAM;CACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BA,AAAO,GAAG,OAAgC,UAA4C;EACpF,KAAK,OAAO,GAAG,OAAO,QAAQ;CAChC;;;;;;;;;CAUA,AAAO,KAAK,OAAgC,UAA4C;EACtF,KAAK,OAAO,KAAK,OAAO,QAAQ;CAClC;;;;;;;CAQA,AAAO,IAAI,OAAgC,UAA4C;EACrF,KAAK,OAAO,IAAI,OAAO,QAAQ;CACjC;;CAGA,AAAO,IAAI,MAA2B;EACpC,MAAM,gBAAgB,QAAQ,OAAO,0BAA0B,cAAc,IAAI;EAEjF,IAAI,eAAe;GACjB,IAAI,yBAAyB,YAC3B,OAAO;GAGT,MAAM,WAAW,KAAK,QAAQ,IAAI,aAAa;GAE/C,IAAI,CAAC,UACH,MAAM,IAAI,uBACR,gBAAgB,cAAc,0CAC9B,aACF;GAGF,OAAO;EACT;EAEA,IAAI,QAAQ,MAAM;GAChB,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;GACpC,IAAI,CAAC,QACH,MAAM,IAAI,uBAAuB,gBAAgB,KAAK,uBAAuB,IAAI;GAEnF,OAAO;EACT;EAEA,IAAI,CAAC,KAAK,eACR,MAAM,IAAI,uBAAuB,oCAAoC;EAGvE,OAAO,KAAK;CACd;;;;;;;;;;;;;;;;;CAkBA,AAAO,oBAAkC;EACvC,OAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,CAAC;CACzC;AACF;AAEA,MAAa,qBAAqB,IAAI,mBAAmB"}

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

@@ -0,0 +1,160 @@
+import { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from "../types.mjs";
+import { DriverContract } from "../contracts/database-driver.contract.mjs";
+import { IdGeneratorContract } from "../contracts/database-id-generator.contract.mjs";
+//#region ../../@warlock.js/cascade/src/data-source/data-source.d.ts
+/**
+ * Configuration options used when registering a data source.
+ */
+type DataSourceOptions = {
+  /** Unique name identifying the data source. */name: string; /** Driver bound to the data source. */
+  driver: DriverContract; /** Whether this data source should be considered the default one. */
+  isDefault?: boolean;
+  /**
+   * Default delete strategy for models using this data source.
+   *
+   * - MongoDB: Typically `"trash"` (uses RecycleBin collection)
+   * - PostgreSQL: Typically `"permanent"` or `"soft"`
+   *
+   * Can be overridden by model static property or destroy() options.
+   *
+   * @default undefined (falls back to "permanent")
+   */
+  defaultDeleteStrategy?: DeleteStrategy;
+  /**
+   * Default trash table/collection name for "trash" delete strategy.
+   *
+   * - MongoDB: Typically `"RecycleBin"`
+   * - If not set, defaults to `{table}Trash` pattern
+   *
+   * Can be overridden by Model.trashTable static property.
+   *
+   * @default undefined (uses {table}Trash pattern)
+   */
+  defaultTrashTable?: string;
+  /**
+   * Default model configuration for all models using this data source.
+   *
+   * These defaults override driver defaults but are overridden by
+   * individual model static properties.
+   *
+   * @default undefined
+   */
+  modelDefaults?: Partial<ModelDefaults>;
+  /**
+   * Migration-level defaults (UUID strategy, etc.).
+   *
+   * These defaults override driver migration defaults but can be
+   * overridden by individual migration calls.
+   *
+   * @default undefined (uses driver defaults)
+   */
+  migrationDefaults?: MigrationDefaults;
+  /**
+   * Default relation conventions (FK suffix, pivot-table naming order).
+   *
+   * Consumed by the runtime convention helpers in
+   * `relations/key-conventions.ts` whenever a relation definition omits
+   * an explicit `foreignKey` / `pivot` / pivot-column override.
+   *
+   * @default undefined (uses framework defaults)
+   */
+  relationDefaults?: RelationDefaults;
+  /**
+   * Migration configuration options.
+   */
+  migrations?: {
+    /**
+     * Whether to wrap migrations in database transactions.
+     *
+     * Overrides driver defaults:
+     * - PostgreSQL default: `true` (DDL is transactional)
+     * - MongoDB default: `false` (DDL cannot be transactional)
+     *
+     * Individual migrations can override this with their own `transactional` property.
+     *
+     * @default undefined (uses driver default)
+     */
+    transactional?: boolean;
+    /**
+     * Name of the migrations tracking table/collection.
+     *
+     * @default "_migrations"
+     */
+    table?: string;
+  };
+};
+/**
+ * Wrapper that couples a driver with its metadata.
+ *
+ * A data source represents a database connection with all its associated services.
+ * The ID generator (if needed) is provided by the driver itself.
+ *
+ * @example
+ * ```typescript
+ * // MongoDB with auto ID generation
+ * const mongoDriver = new MongoDbDriver({
+ *   host: "localhost",
+ *   port: 27017,
+ *   database: "myapp",
+ *   autoGenerateId: true, // Driver creates its own ID generator
+ * });
+ *
+ * const dataSource = new DataSource({
+ *   name: "primary",
+ *   driver: mongoDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Access ID generator from driver
+ * const idGenerator = dataSource.idGenerator;
+ * ```
+ */
+declare class DataSource {
+  /** Unique name identifying this data source. */
+  readonly name: string;
+  /** Database driver for executing queries. */
+  readonly driver: DriverContract;
+  /** Whether this is the default data source. */
+  readonly isDefault: boolean;
+  /** Default delete strategy for models using this data source. */
+  readonly defaultDeleteStrategy?: DeleteStrategy;
+  /** Default trash table/collection name for "trash" delete strategy. */
+  readonly defaultTrashTable?: string;
+  /** Default model configuration for all models using this data source. */
+  readonly modelDefaults?: Partial<ModelDefaults>;
+  /** Migration-level defaults (UUID strategy, etc.). */
+  readonly migrationDefaults?: MigrationDefaults;
+  /** Default relation conventions (FK suffix, pivot ordering). */
+  readonly relationDefaults?: RelationDefaults;
+  /** Migration configuration options. */
+  readonly migrations?: {
+    transactional?: boolean;
+    table?: string;
+  };
+  /**
+   * Create a new data source.
+   *
+   * @param options - Configuration options
+   */
+  constructor(options: DataSourceOptions);
+  /**
+   * Get the ID generator from the driver (if available).
+   *
+   * NoSQL drivers like MongoDB can provide their own ID generator.
+   * SQL drivers return undefined as they use native AUTO_INCREMENT.
+   *
+   * @returns The ID generator instance, or undefined
+   *
+   * @example
+   * ```typescript
+   * const idGenerator = dataSource.idGenerator;
+   * if (idGenerator) {
+   *   const id = await idGenerator.generateNextId({ table: "users" });
+   * }
+   * ```
+   */
+  get idGenerator(): IdGeneratorContract | undefined;
+}
+//#endregion
+export { DataSource, DataSourceOptions };
+//# sourceMappingURL=data-source.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/data-source/data-source.ts"],"mappings":";;;;;;;KAMY,iBAAA;EAAA,+CAEV,IAAA;EAEA,MAAA,EAAQ,cAAA,EAagB;EAXxB,SAAA;EAiCgB;;;;;;;;;;EAtBhB,qBAAA,GAAwB,cAAA;EAYxB;;;;;;;;;;EAAA,iBAAA;EAuDO;AAAA;AA8BT;;;;;;EA3EE,aAAA,GAAgB,OAAA,CAAQ,aAAA;EA+FY;;;;;;;;EArFpC,iBAAA,GAAoB,iBAAA;EAyEJ;;;;;;;;;EA9DhB,gBAAA,GAAmB,gBAAA;EA6EgB;;;EAxEnC,UAAA;;;;;;;AAiH6C;;;;;IArG3C,aAAA;;;;;;IAOA,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BS,UAAA;;WAEK,IAAA;;WAGA,MAAA,EAAQ,cAAA;;WAGR,SAAA;;WAGA,qBAAA,GAAwB,cAAA;;WAGxB,iBAAA;;WAGA,aAAA,GAAgB,OAAA,CAAQ,aAAA;;WAGxB,iBAAA,GAAoB,iBAAA;;WAGpB,gBAAA,GAAmB,gBAAA;;WAGnB,UAAA;IACd,aAAA;IACA,KAAA;EAAA;;;;;;cAQiB,OAAA,EAAS,iBAAA;;;;;;;;;;;;;;;;;MA4BjB,WAAA,CAAA,GAAe,mBAAA;AAAA"}

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

@@ -0,0 +1,87 @@
+//#region ../../@warlock.js/cascade/src/data-source/data-source.ts
+/**
+* Wrapper that couples a driver with its metadata.
+*
+* A data source represents a database connection with all its associated services.
+* The ID generator (if needed) is provided by the driver itself.
+*
+* @example
+* ```typescript
+* // MongoDB with auto ID generation
+* const mongoDriver = new MongoDbDriver({
+*   host: "localhost",
+*   port: 27017,
+*   database: "myapp",
+*   autoGenerateId: true, // Driver creates its own ID generator
+* });
+*
+* const dataSource = new DataSource({
+*   name: "primary",
+*   driver: mongoDriver,
+*   isDefault: true,
+* });
+*
+* // Access ID generator from driver
+* const idGenerator = dataSource.idGenerator;
+* ```
+*/
+var DataSource = class {
+	/** Unique name identifying this data source. */
+	name;
+	/** Database driver for executing queries. */
+	driver;
+	/** Whether this is the default data source. */
+	isDefault;
+	/** Default delete strategy for models using this data source. */
+	defaultDeleteStrategy;
+	/** Default trash table/collection name for "trash" delete strategy. */
+	defaultTrashTable;
+	/** Default model configuration for all models using this data source. */
+	modelDefaults;
+	/** Migration-level defaults (UUID strategy, etc.). */
+	migrationDefaults;
+	/** Default relation conventions (FK suffix, pivot ordering). */
+	relationDefaults;
+	/** Migration configuration options. */
+	migrations;
+	/**
+	* Create a new data source.
+	*
+	* @param options - Configuration options
+	*/
+	constructor(options) {
+		this.name = options.name;
+		this.driver = options.driver;
+		this.isDefault = Boolean(options.isDefault);
+		this.defaultDeleteStrategy = options.defaultDeleteStrategy;
+		this.defaultTrashTable = options.defaultTrashTable;
+		this.modelDefaults = options.modelDefaults;
+		this.migrationDefaults = options.migrationDefaults;
+		this.relationDefaults = options.relationDefaults;
+		this.migrations = options.migrations;
+	}
+	/**
+	* Get the ID generator from the driver (if available).
+	*
+	* NoSQL drivers like MongoDB can provide their own ID generator.
+	* SQL drivers return undefined as they use native AUTO_INCREMENT.
+	*
+	* @returns The ID generator instance, or undefined
+	*
+	* @example
+	* ```typescript
+	* const idGenerator = dataSource.idGenerator;
+	* if (idGenerator) {
+	*   const id = await idGenerator.generateNextId({ table: "users" });
+	* }
+	* ```
+	*/
+	get idGenerator() {
+		const driver = this.driver;
+		if (typeof driver.getIdGenerator === "function") return driver.getIdGenerator();
+	}
+};
+
+//#endregion
+export { DataSource };
+//# sourceMappingURL=data-source.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/data-source/data-source.ts"],"sourcesContent":["import type { DriverContract, IdGeneratorContract } from \"../contracts\";\nimport type { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from \"../types\";\n\n/**\n * Configuration options used when registering a data source.\n */\nexport type DataSourceOptions = {\n  /** Unique name identifying the data source. */\n  name: string;\n  /** Driver bound to the data source. */\n  driver: DriverContract;\n  /** Whether this data source should be considered the default one. */\n  isDefault?: boolean;\n  /**\n   * Default delete strategy for models using this data source.\n   *\n   * - MongoDB: Typically `\"trash\"` (uses RecycleBin collection)\n   * - PostgreSQL: Typically `\"permanent\"` or `\"soft\"`\n   *\n   * Can be overridden by model static property or destroy() options.\n   *\n   * @default undefined (falls back to \"permanent\")\n   */\n  defaultDeleteStrategy?: DeleteStrategy;\n\n  /**\n   * Default trash table/collection name for \"trash\" delete strategy.\n   *\n   * - MongoDB: Typically `\"RecycleBin\"`\n   * - If not set, defaults to `{table}Trash` pattern\n   *\n   * Can be overridden by Model.trashTable static property.\n   *\n   * @default undefined (uses {table}Trash pattern)\n   */\n  defaultTrashTable?: string;\n\n  /**\n   * Default model configuration for all models using this data source.\n   *\n   * These defaults override driver defaults but are overridden by\n   * individual model static properties.\n   *\n   * @default undefined\n   */\n  modelDefaults?: Partial<ModelDefaults>;\n\n  /**\n   * Migration-level defaults (UUID strategy, etc.).\n   *\n   * These defaults override driver migration defaults but can be\n   * overridden by individual migration calls.\n   *\n   * @default undefined (uses driver defaults)\n   */\n  migrationDefaults?: MigrationDefaults;\n\n  /**\n   * Default relation conventions (FK suffix, pivot-table naming order).\n   *\n   * Consumed by the runtime convention helpers in\n   * `relations/key-conventions.ts` whenever a relation definition omits\n   * an explicit `foreignKey` / `pivot` / pivot-column override.\n   *\n   * @default undefined (uses framework defaults)\n   */\n  relationDefaults?: RelationDefaults;\n\n  /**\n   * Migration configuration options.\n   */\n  migrations?: {\n    /**\n     * Whether to wrap migrations in database transactions.\n     *\n     * Overrides driver defaults:\n     * - PostgreSQL default: `true` (DDL is transactional)\n     * - MongoDB default: `false` (DDL cannot be transactional)\n     *\n     * Individual migrations can override this with their own `transactional` property.\n     *\n     * @default undefined (uses driver default)\n     */\n    transactional?: boolean;\n\n    /**\n     * Name of the migrations tracking table/collection.\n     *\n     * @default \"_migrations\"\n     */\n    table?: string;\n  };\n};\n\n/**\n * Wrapper that couples a driver with its metadata.\n *\n * A data source represents a database connection with all its associated services.\n * The ID generator (if needed) is provided by the driver itself.\n *\n * @example\n * ```typescript\n * // MongoDB with auto ID generation\n * const mongoDriver = new MongoDbDriver({\n *   host: \"localhost\",\n *   port: 27017,\n *   database: \"myapp\",\n *   autoGenerateId: true, // Driver creates its own ID generator\n * });\n *\n * const dataSource = new DataSource({\n *   name: \"primary\",\n *   driver: mongoDriver,\n *   isDefault: true,\n * });\n *\n * // Access ID generator from driver\n * const idGenerator = dataSource.idGenerator;\n * ```\n */\nexport class DataSource {\n  /** Unique name identifying this data source. */\n  public readonly name: string;\n\n  /** Database driver for executing queries. */\n  public readonly driver: DriverContract;\n\n  /** Whether this is the default data source. */\n  public readonly isDefault: boolean;\n\n  /** Default delete strategy for models using this data source. */\n  public readonly defaultDeleteStrategy?: DeleteStrategy;\n\n  /** Default trash table/collection name for \"trash\" delete strategy. */\n  public readonly defaultTrashTable?: string;\n\n  /** Default model configuration for all models using this data source. */\n  public readonly modelDefaults?: Partial<ModelDefaults>;\n\n  /** Migration-level defaults (UUID strategy, etc.). */\n  public readonly migrationDefaults?: MigrationDefaults;\n\n  /** Default relation conventions (FK suffix, pivot ordering). */\n  public readonly relationDefaults?: RelationDefaults;\n\n  /** Migration configuration options. */\n  public readonly migrations?: {\n    transactional?: boolean;\n    table?: string;\n  };\n\n  /**\n   * Create a new data source.\n   *\n   * @param options - Configuration options\n   */\n  public constructor(options: DataSourceOptions) {\n    this.name = options.name;\n    this.driver = options.driver;\n    this.isDefault = Boolean(options.isDefault);\n    this.defaultDeleteStrategy = options.defaultDeleteStrategy;\n    this.defaultTrashTable = options.defaultTrashTable;\n    this.modelDefaults = options.modelDefaults;\n    this.migrationDefaults = options.migrationDefaults;\n    this.relationDefaults = options.relationDefaults;\n    this.migrations = options.migrations;\n  }\n\n  /**\n   * Get the ID generator from the driver (if available).\n   *\n   * NoSQL drivers like MongoDB can provide their own ID generator.\n   * SQL drivers return undefined as they use native AUTO_INCREMENT.\n   *\n   * @returns The ID generator instance, or undefined\n   *\n   * @example\n   * ```typescript\n   * const idGenerator = dataSource.idGenerator;\n   * if (idGenerator) {\n   *   const id = await idGenerator.generateNextId({ table: \"users\" });\n   * }\n   * ```\n   */\n  public get idGenerator(): IdGeneratorContract | undefined {\n    // Check if driver has a getIdGenerator method (duck typing)\n    const driver = this.driver as any;\n    if (typeof driver.getIdGenerator === \"function\") {\n      return driver.getIdGenerator();\n    }\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwHA,IAAa,aAAb,MAAwB;;CAEtB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;CAGhB,AAAgB;;;;;;CAUhB,AAAO,YAAY,SAA4B;EAC7C,KAAK,OAAO,QAAQ;EACpB,KAAK,SAAS,QAAQ;EACtB,KAAK,YAAY,QAAQ,QAAQ,SAAS;EAC1C,KAAK,wBAAwB,QAAQ;EACrC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,gBAAgB,QAAQ;EAC7B,KAAK,oBAAoB,QAAQ;EACjC,KAAK,mBAAmB,QAAQ;EAChC,KAAK,aAAa,QAAQ;CAC5B;;;;;;;;;;;;;;;;;CAkBA,IAAW,cAA+C;EAExD,MAAM,SAAS,KAAK;EACpB,IAAI,OAAO,OAAO,mBAAmB,YACnC,OAAO,OAAO,eAAe;CAGjC;AACF"}