@warlock.js/cascade 5.30.0 → 5.32.0

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

@@ -1 +1 @@
-{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../../packages/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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"}
+{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../../packages/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\"\n  | \"default-registered\"\n  | \"connected\"\n  | \"disconnected\"\n  | \"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/data-source/data-source.d.mts

@@ -1,13 +1,17 @@
 import { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from "../types.mjs";
 import { DriverContract, RawQueryResult } from "../contracts/database-driver.contract.mjs";
 import { IdGeneratorContract } from "../contracts/database-id-generator.contract.mjs";
+import "../contracts/index.mjs";
 //#region ../../packages/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. */
+export 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.
@@ -109,7 +113,7 @@ type DataSourceOptions = {
  * const idGenerator = dataSource.idGenerator;
  * ```
  */
-declare class DataSource {
+export declare class DataSource {
   /** Unique name identifying this data source. */
   readonly name: string;
   /** Database driver for executing queries. */
@@ -176,5 +180,4 @@ declare class DataSource {
   raw<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<RawQueryResult<T>>;
 }
 //#endregion
-export { DataSource, DataSourceOptions };
 //# sourceMappingURL=data-source.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"data-source.d.mts","names":[],"sources":["../../../../../../../../packages/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;EAgKV;;;;;;;;;EArJV,gBAAA,GAAmB,gBAAA;EAuEqB;;;EAlExC,UAAA;IAwEmC;;;;;;;;;;;IA5DjC,aAAA;IAkIA;;;;;IA3HA,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,IAAe,mBAAA;;;;;;;;;;;;;;;;;;;;EA4BnB,GAAA,KAAQ,MAAA,mBACb,GAAA,UACA,MAAA,eACC,OAAA,CAAQ,cAAA,CAAe,CAAA;AAAA"}
+{"version":3,"file":"data-source.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/data-source/data-source.ts"],"mappings":";;;;;;;;YAMY;;EAEV;;EAEA,QAAQ;;EAER;;;;;;;;;;;EAWA,wBAAwB;;;;;;;;;;;EAYxB;;;;;;;;;EAUA,gBAAgB,QAAQ;;;;;;;;;EAUxB,oBAAoB;;;;;;;;;;EAWpB,mBAAmB;;;;EAKnB;;;;;;;;;;;;IAYE;;;;;;IAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8BS;;WAEK;;WAGA,QAAQ;;WAGR;;WAGA,wBAAwB;;WAGxB;;WAGA,gBAAgB,QAAQ;;WAGxB,oBAAoB;;WAGpB,mBAAmB;;WAGnB;IACd;IACA;;;;;;;EAQF,YAAmB,SAAS;;;;;;;;;;;;;;;;;MA4BjB,eAAe;;;;;;;;;;;;;;;;;;;;EA4BnB,IAAI,IAAI,yBACb,aACA,qBACC,QAAQ,eAAe"}

package/esm/database-dirty-tracker.d.mts

@@ -26,7 +26,7 @@ type DirtyColumnValues = {
  * // { age: { oldValue: 30, newValue: 31 } }
  * ```
  */
-declare class DatabaseDirtyTracker {
+export declare class DatabaseDirtyTracker {
   /**
    * The initial raw data snapshot taken at construction or last reset.
    * Used as the baseline for comparison.
@@ -302,5 +302,5 @@ declare class DatabaseDirtyTracker {
   protected cloneData<T>(data: T): T;
 }
 //#endregion
-export { DatabaseDirtyTracker };
+export {};
 //# sourceMappingURL=database-dirty-tracker.d.mts.map

package/esm/database-dirty-tracker.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-dirty-tracker.d.mts","names":[],"sources":["../../../../../../../packages/cascade/src/database-dirty-tracker.ts"],"mappings":";;;;KAgDK,UAAA,GAAa,MAAM;;AAAA;AAAA;KAKnB,iBAAA;EAAsB,QAAA;EAAmB,QAAQ;AAAA;AAkBtD;;;;;;;;;;;;;;;;AAAA,cAAa,oBAAA;EA2W2C;;;;EAAA,UAtW5C,UAAA,EAAY,MAAA;EAogBY;;;EAAA,UA/fxB,UAAA,EAAY,MAAA;EAAZ;;;;EAAA,UAMA,gBAAA,EAAkB,UAAA;EAKA;;;EAAA,UAAlB,gBAAA,EAAkB,UAAA;EAUK;;;EAAA,mBALd,YAAA,EAAY,GAAA;EAeN;;;EAAA,mBAVN,cAAA,EAAc,GAAA;EA+F1B;;;;;;EAAA,mBAvFY,aAAA,EAAa,GAAA;cAEb,IAAA,EAAM,MAAA;EAwMlB;;;;;;;;;;;;;EAjLA,eAAA;EA2SG;;;;;;;;;;;;EA3RH,eAAA;EAiakB;;;;;;;;AAwBS;;;;;;;;;EA3Y3B,kBAAA;;;;;;;;;;;;;;;;;;EAsCA,UAAA;;;;EAOA,OAAA,CAAQ,MAAA;;;;;;;;;;;;;;;;EAmBR,iBAAA;;;;;;;;;;;;;;;;;EAoBA,yBAAA,IAA6B,MAAA,SAAe,iBAAA;;;;;;;;;;;;;;;;EA+B5C,kBAAA,CAAmB,IAAA,EAAM,MAAA;;;;;;;;;;;;;;;;;EAsBzB,YAAA,CAAa,OAAA,EAAS,MAAA;;;;;EAUtB,SAAA,CAAU,IAAA,UAAc,KAAA;;;;;;;;;;;;;;;;EAsCxB,KAAA,CAAM,OAAA;;;;;;;;;;;;;;;;;;;;;EAmCN,KAAA,CAAM,IAAA,GAAO,MAAA;;;;;YAiBV,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,UAAA;;;;;;;;;;YAa5C,gBAAA;;;;;;;;;;;;;;;;;;;;YA6CA,YAAA,CAAa,MAAA,EAAQ,MAAA,mBAAyB,MAAA,EAAQ,MAAA;;;;;;;;;;YAoBtD,aAAA,CAAc,IAAA;;;;;;;;;;;YAwDd,cAAA,CAAe,SAAA,WAAoB,OAAA;;;;;;;;YAwBnC,SAAA,IAAa,IAAA,EAAM,CAAA,GAAI,CAAA;AAAA"}
+{"version":3,"file":"database-dirty-tracker.d.mts","names":[],"sources":["../../../../../../../packages/cascade/src/database-dirty-tracker.ts"],"mappings":";;;;KAgDK,aAAa;;;;KAKb;EAAsB;EAAmB;;;;;;;;;;;;;;;;;;qBAkBjC;;;;;YAKD,YAAY;;;;YAKZ,YAAY;;;;;YAMZ,kBAAkB;;;;YAKlB,kBAAkB;;;;qBAKT,cAAY;;;;qBAKZ,gBAAc;;;;;;;qBAQd,eAAa;EAEhC,YAAmB,MAAM;;;;;;;;;;;;;;EAuBlB;;;;;;;;;;;;;EAgBA;;;;;;;;;;;;;;;;;;EA8CA;;;;;;;;;;;;;;;;;;EAsCA;;;;EAOA,QAAQ;;;;;;;;;;;;;;;;EAmBR;;;;;;;;;;;;;;;;;EAoBA,6BAA6B,eAAe;;;;;;;;;;;;;;;;EA+B5C,mBAAmB,MAAM;;;;;;;;;;;;;;;;;EAsBzB,aAAa,SAAS;;;;;EAUtB,UAAU,cAAc;;;;;;;;;;;;;;;;EAsCxB,MAAM;;;;;;;;;;;;;;;;;;;;;EAmCN,MAAM,OAAO;;;;;YAiBV,YAAY,MAAM,0BAA0B;;;;;;;;;;YAa5C;;;;;;;;;;;;;;;;;;;;YA6CA,aAAa,QAAQ,yBAAyB,QAAQ;;;;;;;;;;YAoBtD,cAAc;;;;;;;;;;;YAwDd,eAAe,oBAAoB;;;;;;;;YAwBnC,UAAU,GAAG,MAAM,IAAI"}

package/esm/database-dirty-tracker.mjs

@@ -355,13 +355,14 @@ var DatabaseDirtyTracker = class {
 	updateDirtyState() {
 		this.dirtyColumns.clear();
 		this.removedColumns.clear();
-		const keys = new Set([...Object.keys(this.initialFlattened), ...Object.keys(this.currentFlattened)]);
+		const keys = /* @__PURE__ */ new Set([...Object.keys(this.initialFlattened), ...Object.keys(this.currentFlattened)]);
 		for (const key of keys) {
 			const hasCurrent = this.currentFlattened[key] !== void 0 || key in this.currentFlattened;
 			const hasInitial = this.initialFlattened[key] !== void 0 || key in this.initialFlattened;
 			if (!hasCurrent && hasInitial) this.removedColumns.add(key);
 			const initialValue = this.initialFlattened[key];
-			if (!areEqual(initialValue, hasCurrent ? this.currentFlattened[key] : void 0)) this.dirtyColumns.add(key);
+			const currentValue = hasCurrent ? this.currentFlattened[key] : void 0;
+			if (!areEqual(initialValue, currentValue)) this.dirtyColumns.add(key);
 		}
 	}
 	/**

package/esm/database-dirty-tracker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-dirty-tracker.mjs","names":[],"sources":["../../../../../../../packages/cascade/src/database-dirty-tracker.ts"],"sourcesContent":["import { areEqual, clone } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport { pruneEmptyParents } from \"./utils/prune-empty-parents\";\n\nfunction canBeFlatten(object: unknown): boolean {\n  return isPlainObject(object);\n}\n\n/**\n * A fix for flatten as non-plain object is being flatten as well which it should not be\n */\nfunction flatten(\n  object: Record<string, unknown>,\n  separator = \".\",\n  keepNestedOriginalObject = false,\n  parent?: string,\n  root: Record<string, unknown> = {},\n) {\n  if (canBeFlatten(object) === false) {\n    return object;\n  }\n  // object = toPlainObject(object);\n  for (const key of Object.keys(object)) {\n    const value = object[key];\n    const keyChain = parent ? parent + separator + key : key;\n    if ((Array.isArray(value) && value.length === 0) || typeof value === \"function\") {\n      root[keyChain] = value;\n    } else if (canBeFlatten(value)) {\n      if (keepNestedOriginalObject) {\n        root[keyChain] = value;\n      }\n      flatten(\n        value as Record<string, unknown>,\n        separator,\n        keepNestedOriginalObject,\n        keyChain,\n        root,\n      );\n    } else {\n      root[keyChain] = value;\n    }\n  }\n  return root;\n}\n\n/**\n * Flattened record type representing dot-notation paths mapped to their values.\n */\ntype FlatRecord = Record<string, unknown>;\n\n/**\n * Represents the old and new values of a dirty column.\n */\ntype DirtyColumnValues = { oldValue: unknown; newValue: unknown };\n\n/**\n * Tracks changes to model data by maintaining snapshots of initial and current state.\n *\n * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data\n * to accurately detect modifications, additions, and removals at any nesting level.\n *\n * @example\n * ```typescript\n * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n * tracker.mergeChanges({ age: 31 });\n * console.log(tracker.hasChanges()); // true\n * console.log(tracker.getDirtyColumns()); // [\"age\"]\n * console.log(tracker.getDirtyColumnsWithValues());\n * // { age: { oldValue: 30, newValue: 31 } }\n * ```\n */\nexport class DatabaseDirtyTracker {\n  /**\n   * The initial raw data snapshot taken at construction or last reset.\n   * Used as the baseline for comparison.\n   */\n  protected initialRaw: Record<string, unknown>;\n\n  /**\n   * The current raw data snapshot reflecting all changes made via merge/unset.\n   */\n  protected currentRaw: Record<string, unknown>;\n\n  /**\n   * Flattened version of the initial data using dot-notation keys.\n   * Example: { \"address.city\": \"NYC\" }\n   */\n  protected initialFlattened: FlatRecord;\n\n  /**\n   * Flattened version of the current data using dot-notation keys.\n   */\n  protected currentFlattened: FlatRecord;\n\n  /**\n   * Set of column names (dot-notation paths) that have been modified.\n   */\n  protected readonly dirtyColumns = new Set<string>();\n\n  /**\n   * Set of column names (dot-notation paths) that existed initially but have been removed.\n   */\n  protected readonly removedColumns = new Set<string>();\n\n  /**\n   * Top-level fields that were assigned or unset as a whole (`set(\"nested\", obj)`,\n   * `unset(\"nested\")`) since the last reset. Dotted-path writes\n   * (`set(\"nested.a\", v)`) and `mergeChanges` are partial by intent and never\n   * land here. See {@link getReplacedColumns}.\n   */\n  protected readonly replacedRoots = new Set<string>();\n\n  public constructor(data: Record<string, unknown>) {\n    this.initialRaw = this.cloneData(data);\n    this.currentRaw = this.cloneData(data);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = { ...this.initialFlattened };\n\n    this.updateDirtyState();\n  }\n\n  /**\n   * Returns the list of dirty columns using dot-notation.\n   *\n   * A column is considered dirty if its value has changed compared to the initial snapshot.\n   *\n   * @returns An array of column names (dot-notation paths) that have been modified\n   *\n   * @example\n   * ```typescript\n   * tracker.mergeChanges({ name: \"Bob\", \"address.city\": \"LA\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"address.city\"]\n   * ```\n   */\n  public getDirtyColumns(): string[] {\n    return Array.from(this.dirtyColumns);\n  }\n\n  /**\n   * Removed columns collapsed to the highest path that no longer exists.\n   *\n   * `getRemovedColumns()` reports leaves (`\"a.b.c\"`). Unsetting just that leaf\n   * would keep `a` and `a.b` in the stored document as empty objects whenever\n   * the unset emptied them (and `unset()` prunes those parents). This returns\n   * the path to actually `$unset`: the shortest prefix that is gone from the\n   * current data, which is the leaf itself when its parents still hold other\n   * keys.\n   *\n   * @returns Distinct paths to remove\n   */\n  public getRemovedPaths(): string[] {\n    const paths = new Set<string>();\n\n    for (const column of this.removedColumns) {\n      const segments = column.split(\".\");\n      let container: unknown = this.currentRaw;\n      let path = column;\n\n      for (let index = 0; index < segments.length; index += 1) {\n        const segment = segments[index] as string;\n\n        if (\n          container === null ||\n          typeof container !== \"object\" ||\n          !(segment in (container as Record<string, unknown>))\n        ) {\n          path = segments.slice(0, index + 1).join(\".\");\n          break;\n        }\n\n        container = (container as Record<string, unknown>)[segment];\n      }\n\n      paths.add(path);\n    }\n\n    return Array.from(paths);\n  }\n\n  /**\n   * Top-level fields whose nested object must be written as a WHOLE value.\n   *\n   * Per-leaf diffing cannot express \"this object is now exactly this\": it only\n   * reports the leaves that changed or vanished, so a key removed from a nested\n   * object leaves its (now empty) parents behind in the stored document. A field\n   * that was assigned or unset as a whole therefore reports here, and the writer\n   * sends one `$set` (or `$unset`) for it instead of per-leaf operations.\n   *\n   * A field is reported only when it was replaced via `set(\"field\", value)` /\n   * `unset(\"field\")`, either its old or new value is a plain object, and the\n   * value actually differs from the baseline. Dotted-path writes\n   * (`set(\"field.a\", v)`) and `mergeChanges` stay per-leaf, so partial updates\n   * keep working. Scalars and arrays are already whole-value leaves in the diff.\n   *\n   * @returns Top-level column names to write as a whole\n   */\n  public getReplacedColumns(): string[] {\n    const columns: string[] = [];\n\n    for (const root of this.replacedRoots) {\n      const initial = this.initialRaw[root];\n      const current = this.currentRaw[root];\n\n      if (!isPlainObject(initial) && !isPlainObject(current)) {\n        continue;\n      }\n\n      if (areEqual(initial, current)) {\n        continue;\n      }\n\n      columns.push(root);\n    }\n\n    return columns;\n  }\n\n  /**\n   * Determines whether there are any tracked changes.\n   *\n   * Returns `true` if any columns have been modified or removed since the initial snapshot.\n   *\n   * @returns `true` if there are changes, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.hasChanges(); // false\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.unset(\"name\");\n   * tracker.hasChanges(); // true (removed column counts as a change)\n   * ```\n   */\n  public hasChanges(): boolean {\n    return this.dirtyColumns.size > 0 || this.removedColumns.size > 0;\n  }\n\n  /**\n   * Check if the given column is dirty (changed)\n   */\n  public isDirty(column: string): boolean {\n    return this.dirtyColumns.has(column);\n  }\n\n  /**\n   * Returns the set of columns that have been removed compared to the baseline.\n   *\n   * A column is considered removed if it existed in the initial snapshot but has been\n   * explicitly unset or deleted from the current data.\n   *\n   * @returns An array of column names (dot-notation paths) that have been removed\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", temp: \"value\" });\n   * tracker.unset(\"temp\");\n   * tracker.getRemovedColumns(); // [\"temp\"]\n   * ```\n   */\n  public getRemovedColumns(): string[] {\n    return Array.from(this.removedColumns);\n  }\n\n  /**\n   * Provides a mapping of dirty columns to their previous and current values.\n   *\n   * This is useful for generating audit logs, building partial update payloads,\n   * or displaying change summaries to users.\n   *\n   * @returns A record mapping each dirty column to an object containing oldValue and newValue\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n   * tracker.mergeChanges({ age: 31 });\n   * tracker.getDirtyColumnsWithValues();\n   * // { age: { oldValue: 30, newValue: 31 } }\n   * ```\n   */\n  public getDirtyColumnsWithValues(): Record<string, DirtyColumnValues> {\n    const result: Record<string, DirtyColumnValues> = {};\n\n    for (const column of this.dirtyColumns) {\n      const hasCurrent =\n        this.currentFlattened[column] !== undefined || column in this.currentFlattened;\n\n      result[column] = {\n        oldValue: this.initialFlattened[column],\n        newValue: hasCurrent ? this.currentFlattened[column] : undefined,\n      };\n    }\n\n    return result;\n  }\n\n  /**\n   * Replaces the current data snapshot entirely and recomputes the diff.\n   *\n   * This is useful when you want to replace all current data with a new set,\n   * while keeping the initial baseline for comparison.\n   *\n   * @param data - The new data to set as the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.replaceCurrentData({ name: \"Bob\", email: \"bob@example.com\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"email\"]\n   * ```\n   */\n  public replaceCurrentData(data: Record<string, unknown>): void {\n    this.currentRaw = this.cloneData(data);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Merges a partial payload into the current snapshot and recomputes the diff.\n   *\n   * This performs a deep merge, preserving existing nested structures while\n   * updating only the specified fields.\n   *\n   * @param partial - Partial data to merge into the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", address: { city: \"NYC\" } });\n   * tracker.mergeChanges({ address: { zip: \"10001\" } });\n   * // Current data: { name: \"Alice\", address: { city: \"NYC\", zip: \"10001\" } }\n   * tracker.getDirtyColumns(); // [\"address.zip\"]\n   * ```\n   */\n  public mergeChanges(partial: Record<string, unknown>): void {\n    this.mergeIntoRaw(this.currentRaw, partial);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Replaces the value at a dot-notation path (no deep merge), mirroring\n   * `model.set()` so stale nested keys are detected as removed.\n   */\n  public setAtPath(path: string, value: unknown): void {\n    const segments = path.split(\".\");\n    let container = this.currentRaw as Record<string, unknown>;\n\n    if (segments.length === 1) {\n      this.replacedRoots.add(path);\n    }\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      const segment = segments[index] as string;\n\n      if (!isPlainObject(container[segment]) && !Array.isArray(container[segment])) {\n        container[segment] = {};\n      }\n\n      container = container[segment] as Record<string, unknown>;\n    }\n\n    container[segments[segments.length - 1] as string] = this.cloneData(value);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Explicitly removes one or more columns from the current data.\n   *\n   * Supports both single column names and arrays of column names.\n   * Columns can be specified using dot-notation for nested paths.\n   *\n   * @param columns - A single column name or an array of column names to remove\n   *\n   * @example\n   * ```typescript\n   * tracker.unset(\"tempField\");\n   * tracker.unset([\"field1\", \"field2\", \"nested.field\"]);\n   * tracker.getRemovedColumns(); // [\"tempField\", \"field1\", \"field2\", \"nested.field\"]\n   * ```\n   */\n  public unset(columns: string | string[]): void {\n    const targets = Array.isArray(columns) ? columns : [columns];\n\n    for (const path of targets) {\n      if (!path.includes(\".\")) {\n        this.replacedRoots.add(path);\n      }\n\n      this.deleteFromRaw(path);\n    }\n\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Resets both the initial and current snapshots to the provided data.\n   *\n   * If no data is provided, the current snapshot becomes the new baseline.\n   * This clears all tracked changes and removed columns.\n   *\n   * @param data - Optional new data to use as the baseline. If omitted, uses current data.\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.reset(); // Make current state the new baseline\n   * tracker.hasChanges(); // false\n   *\n   * // Or reset to entirely new data:\n   * tracker.reset({ name: \"Charlie\", age: 25 });\n   * ```\n   */\n  public reset(data?: Record<string, unknown>): void {\n    const source = data ?? this.currentRaw;\n    this.initialRaw = this.cloneData(source);\n    this.currentRaw = this.cloneData(source);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n    this.replacedRoots.clear();\n  }\n\n  /**\n   * Flattens the given data object.\n   * Can be overridden by subclasses to change flattening behavior.\n   */\n  protected flattenData(data: Record<string, unknown>): FlatRecord {\n    return flatten(data);\n  }\n\n  /**\n   * Recomputes the dirty and removed column sets by comparing initial and current snapshots.\n   *\n   * This method is called internally after any operation that modifies the current data.\n   * It iterates through all keys in both flattened snapshots and determines which columns\n   * have been modified or removed.\n   *\n   * @protected\n   */\n  protected updateDirtyState(): void {\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n\n    const keys = new Set([\n      ...Object.keys(this.initialFlattened),\n      ...Object.keys(this.currentFlattened),\n    ]);\n\n    for (const key of keys) {\n      const hasCurrent = this.currentFlattened[key] !== undefined || key in this.currentFlattened;\n      const hasInitial = this.initialFlattened[key] !== undefined || key in this.initialFlattened;\n\n      if (!hasCurrent && hasInitial) {\n        this.removedColumns.add(key);\n      }\n\n      const initialValue = this.initialFlattened[key];\n      const currentValue = hasCurrent ? this.currentFlattened[key] : undefined;\n\n      if (!areEqual(initialValue, currentValue)) {\n        this.dirtyColumns.add(key);\n      }\n    }\n  }\n\n  /**\n   * Recursively merges source object into target object, performing a deep merge.\n   *\n   * Only **plain** objects are merged recursively. Everything else — arrays,\n   * primitives, and class instances such as `Date` / `Map` / `Set` / `RegExp` —\n   * replaces the target value. All values are cloned to prevent reference sharing.\n   *\n   * The plain-object guard is load-bearing, not tidiness. A bare\n   * `typeof value === \"object\"` also matches a `Date`, and `Object.entries(date)`\n   * is `[]` — so merging a `Date` over a column that already held a `Date`\n   * recursed into it, copied nothing, and left the old value in the snapshot.\n   * The column then never went dirty and `save()` returned\n   * `{ success: true, modifiedCount: 0 }` without issuing an `UPDATE`. This is\n   * the same lesson `canBeFlatten` above already encodes.\n   *\n   * @param target - The object to merge into\n   * @param source - The object to merge from\n   * @private\n   */\n  protected mergeIntoRaw(target: Record<string, unknown>, source: Record<string, unknown>): void {\n    for (const [key, value] of Object.entries(source)) {\n      if (isPlainObject(value) && isPlainObject(target[key])) {\n        this.mergeIntoRaw(target[key] as Record<string, unknown>, value as Record<string, unknown>);\n        continue;\n      }\n\n      target[key] = this.cloneData(value);\n    }\n  }\n\n  /**\n   * Deletes a field from the current raw data using a dot-notation path.\n   *\n   * Supports nested paths (e.g., \"address.city\") and array indices (e.g., \"items.0\").\n   * If any segment in the path doesn't exist, the operation is a no-op.\n   *\n   * @param path - The dot-notation path to the field to delete\n   * @private\n   */\n  protected deleteFromRaw(path: string): void {\n    const segments = path.split(\".\");\n    let container: unknown = this.currentRaw;\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      if (container === undefined || container === null) {\n        return;\n      }\n\n      const segment = segments[index] as string;\n      if (segment === undefined) {\n        return;\n      }\n\n      container = this.resolveSegment(container, segment);\n    }\n\n    if (container === undefined || container === null) {\n      return;\n    }\n\n    const lastSegment = segments[segments.length - 1];\n    if (lastSegment === undefined) {\n      return;\n    }\n    if (Array.isArray(container)) {\n      const numericIndex = Number(lastSegment);\n      if (!Number.isNaN(numericIndex)) {\n        container.splice(numericIndex, 1);\n      }\n      return;\n    }\n\n    if (typeof container === \"object\") {\n      const existed = lastSegment in (container as Record<string, unknown>);\n\n      delete (container as Record<string, unknown>)[lastSegment];\n\n      // Drop parents this unset just emptied; a parent that was already `{}` is\n      // left alone because nothing was removed from it.\n      if (existed) {\n        pruneEmptyParents(this.currentRaw, path);\n      }\n    }\n  }\n\n  /**\n   * Resolves a single segment of a dot-notation path within a container.\n   *\n   * Handles both object property access and array index access.\n   *\n   * @param container - The object or array to access\n   * @param segment - The property name or array index as a string\n   * @returns The value at the specified segment, or undefined if not found\n   * @private\n   */\n  protected resolveSegment(container: unknown, segment: string): unknown {\n    if (Array.isArray(container)) {\n      const numericIndex = Number(segment);\n      if (Number.isNaN(numericIndex)) {\n        return undefined;\n      }\n\n      return container[numericIndex];\n    }\n\n    if (container && typeof container === \"object\") {\n      return (container as Record<string, unknown>)[segment];\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Creates a deep clone of the provided data.\n   *\n   * @param data - The data to clone\n   * @returns A deep clone of the data\n   * @private\n   */\n  protected cloneData<T>(data: T): T {\n    return clone(data);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"database-dirty-tracker.mjs","names":[],"sources":["../../../../../../../packages/cascade/src/database-dirty-tracker.ts"],"sourcesContent":["import { areEqual, clone } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport { pruneEmptyParents } from \"./utils/prune-empty-parents\";\n\nfunction canBeFlatten(object: unknown): boolean {\n  return isPlainObject(object);\n}\n\n/**\n * A fix for flatten as non-plain object is being flatten as well which it should not be\n */\nfunction flatten(\n  object: Record<string, unknown>,\n  separator = \".\",\n  keepNestedOriginalObject = false,\n  parent?: string,\n  root: Record<string, unknown> = {},\n) {\n  if (canBeFlatten(object) === false) {\n    return object;\n  }\n  // object = toPlainObject(object);\n  for (const key of Object.keys(object)) {\n    const value = object[key];\n    const keyChain = parent ? parent + separator + key : key;\n    if ((Array.isArray(value) && value.length === 0) || typeof value === \"function\") {\n      root[keyChain] = value;\n    } else if (canBeFlatten(value)) {\n      if (keepNestedOriginalObject) {\n        root[keyChain] = value;\n      }\n      flatten(\n        value as Record<string, unknown>,\n        separator,\n        keepNestedOriginalObject,\n        keyChain,\n        root,\n      );\n    } else {\n      root[keyChain] = value;\n    }\n  }\n  return root;\n}\n\n/**\n * Flattened record type representing dot-notation paths mapped to their values.\n */\ntype FlatRecord = Record<string, unknown>;\n\n/**\n * Represents the old and new values of a dirty column.\n */\ntype DirtyColumnValues = { oldValue: unknown; newValue: unknown };\n\n/**\n * Tracks changes to model data by maintaining snapshots of initial and current state.\n *\n * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data\n * to accurately detect modifications, additions, and removals at any nesting level.\n *\n * @example\n * ```typescript\n * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n * tracker.mergeChanges({ age: 31 });\n * console.log(tracker.hasChanges()); // true\n * console.log(tracker.getDirtyColumns()); // [\"age\"]\n * console.log(tracker.getDirtyColumnsWithValues());\n * // { age: { oldValue: 30, newValue: 31 } }\n * ```\n */\nexport class DatabaseDirtyTracker {\n  /**\n   * The initial raw data snapshot taken at construction or last reset.\n   * Used as the baseline for comparison.\n   */\n  protected initialRaw: Record<string, unknown>;\n\n  /**\n   * The current raw data snapshot reflecting all changes made via merge/unset.\n   */\n  protected currentRaw: Record<string, unknown>;\n\n  /**\n   * Flattened version of the initial data using dot-notation keys.\n   * Example: { \"address.city\": \"NYC\" }\n   */\n  protected initialFlattened: FlatRecord;\n\n  /**\n   * Flattened version of the current data using dot-notation keys.\n   */\n  protected currentFlattened: FlatRecord;\n\n  /**\n   * Set of column names (dot-notation paths) that have been modified.\n   */\n  protected readonly dirtyColumns = new Set<string>();\n\n  /**\n   * Set of column names (dot-notation paths) that existed initially but have been removed.\n   */\n  protected readonly removedColumns = new Set<string>();\n\n  /**\n   * Top-level fields that were assigned or unset as a whole (`set(\"nested\", obj)`,\n   * `unset(\"nested\")`) since the last reset. Dotted-path writes\n   * (`set(\"nested.a\", v)`) and `mergeChanges` are partial by intent and never\n   * land here. See {@link getReplacedColumns}.\n   */\n  protected readonly replacedRoots = new Set<string>();\n\n  public constructor(data: Record<string, unknown>) {\n    this.initialRaw = this.cloneData(data);\n    this.currentRaw = this.cloneData(data);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = { ...this.initialFlattened };\n\n    this.updateDirtyState();\n  }\n\n  /**\n   * Returns the list of dirty columns using dot-notation.\n   *\n   * A column is considered dirty if its value has changed compared to the initial snapshot.\n   *\n   * @returns An array of column names (dot-notation paths) that have been modified\n   *\n   * @example\n   * ```typescript\n   * tracker.mergeChanges({ name: \"Bob\", \"address.city\": \"LA\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"address.city\"]\n   * ```\n   */\n  public getDirtyColumns(): string[] {\n    return Array.from(this.dirtyColumns);\n  }\n\n  /**\n   * Removed columns collapsed to the highest path that no longer exists.\n   *\n   * `getRemovedColumns()` reports leaves (`\"a.b.c\"`). Unsetting just that leaf\n   * would keep `a` and `a.b` in the stored document as empty objects whenever\n   * the unset emptied them (and `unset()` prunes those parents). This returns\n   * the path to actually `$unset`: the shortest prefix that is gone from the\n   * current data, which is the leaf itself when its parents still hold other\n   * keys.\n   *\n   * @returns Distinct paths to remove\n   */\n  public getRemovedPaths(): string[] {\n    const paths = new Set<string>();\n\n    for (const column of this.removedColumns) {\n      const segments = column.split(\".\");\n      let container: unknown = this.currentRaw;\n      let path = column;\n\n      for (let index = 0; index < segments.length; index += 1) {\n        const segment = segments[index] as string;\n\n        if (\n          container === null ||\n          typeof container !== \"object\" ||\n          !(segment in (container as Record<string, unknown>))\n        ) {\n          path = segments.slice(0, index + 1).join(\".\");\n          break;\n        }\n\n        container = (container as Record<string, unknown>)[segment];\n      }\n\n      paths.add(path);\n    }\n\n    return Array.from(paths);\n  }\n\n  /**\n   * Top-level fields whose nested object must be written as a WHOLE value.\n   *\n   * Per-leaf diffing cannot express \"this object is now exactly this\": it only\n   * reports the leaves that changed or vanished, so a key removed from a nested\n   * object leaves its (now empty) parents behind in the stored document. A field\n   * that was assigned or unset as a whole therefore reports here, and the writer\n   * sends one `$set` (or `$unset`) for it instead of per-leaf operations.\n   *\n   * A field is reported only when it was replaced via `set(\"field\", value)` /\n   * `unset(\"field\")`, either its old or new value is a plain object, and the\n   * value actually differs from the baseline. Dotted-path writes\n   * (`set(\"field.a\", v)`) and `mergeChanges` stay per-leaf, so partial updates\n   * keep working. Scalars and arrays are already whole-value leaves in the diff.\n   *\n   * @returns Top-level column names to write as a whole\n   */\n  public getReplacedColumns(): string[] {\n    const columns: string[] = [];\n\n    for (const root of this.replacedRoots) {\n      const initial = this.initialRaw[root];\n      const current = this.currentRaw[root];\n\n      if (!isPlainObject(initial) && !isPlainObject(current)) {\n        continue;\n      }\n\n      if (areEqual(initial, current)) {\n        continue;\n      }\n\n      columns.push(root);\n    }\n\n    return columns;\n  }\n\n  /**\n   * Determines whether there are any tracked changes.\n   *\n   * Returns `true` if any columns have been modified or removed since the initial snapshot.\n   *\n   * @returns `true` if there are changes, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.hasChanges(); // false\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.unset(\"name\");\n   * tracker.hasChanges(); // true (removed column counts as a change)\n   * ```\n   */\n  public hasChanges(): boolean {\n    return this.dirtyColumns.size > 0 || this.removedColumns.size > 0;\n  }\n\n  /**\n   * Check if the given column is dirty (changed)\n   */\n  public isDirty(column: string): boolean {\n    return this.dirtyColumns.has(column);\n  }\n\n  /**\n   * Returns the set of columns that have been removed compared to the baseline.\n   *\n   * A column is considered removed if it existed in the initial snapshot but has been\n   * explicitly unset or deleted from the current data.\n   *\n   * @returns An array of column names (dot-notation paths) that have been removed\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", temp: \"value\" });\n   * tracker.unset(\"temp\");\n   * tracker.getRemovedColumns(); // [\"temp\"]\n   * ```\n   */\n  public getRemovedColumns(): string[] {\n    return Array.from(this.removedColumns);\n  }\n\n  /**\n   * Provides a mapping of dirty columns to their previous and current values.\n   *\n   * This is useful for generating audit logs, building partial update payloads,\n   * or displaying change summaries to users.\n   *\n   * @returns A record mapping each dirty column to an object containing oldValue and newValue\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n   * tracker.mergeChanges({ age: 31 });\n   * tracker.getDirtyColumnsWithValues();\n   * // { age: { oldValue: 30, newValue: 31 } }\n   * ```\n   */\n  public getDirtyColumnsWithValues(): Record<string, DirtyColumnValues> {\n    const result: Record<string, DirtyColumnValues> = {};\n\n    for (const column of this.dirtyColumns) {\n      const hasCurrent =\n        this.currentFlattened[column] !== undefined || column in this.currentFlattened;\n\n      result[column] = {\n        oldValue: this.initialFlattened[column],\n        newValue: hasCurrent ? this.currentFlattened[column] : undefined,\n      };\n    }\n\n    return result;\n  }\n\n  /**\n   * Replaces the current data snapshot entirely and recomputes the diff.\n   *\n   * This is useful when you want to replace all current data with a new set,\n   * while keeping the initial baseline for comparison.\n   *\n   * @param data - The new data to set as the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.replaceCurrentData({ name: \"Bob\", email: \"bob@example.com\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"email\"]\n   * ```\n   */\n  public replaceCurrentData(data: Record<string, unknown>): void {\n    this.currentRaw = this.cloneData(data);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Merges a partial payload into the current snapshot and recomputes the diff.\n   *\n   * This performs a deep merge, preserving existing nested structures while\n   * updating only the specified fields.\n   *\n   * @param partial - Partial data to merge into the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", address: { city: \"NYC\" } });\n   * tracker.mergeChanges({ address: { zip: \"10001\" } });\n   * // Current data: { name: \"Alice\", address: { city: \"NYC\", zip: \"10001\" } }\n   * tracker.getDirtyColumns(); // [\"address.zip\"]\n   * ```\n   */\n  public mergeChanges(partial: Record<string, unknown>): void {\n    this.mergeIntoRaw(this.currentRaw, partial);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Replaces the value at a dot-notation path (no deep merge), mirroring\n   * `model.set()` so stale nested keys are detected as removed.\n   */\n  public setAtPath(path: string, value: unknown): void {\n    const segments = path.split(\".\");\n    let container = this.currentRaw as Record<string, unknown>;\n\n    if (segments.length === 1) {\n      this.replacedRoots.add(path);\n    }\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      const segment = segments[index] as string;\n\n      if (!isPlainObject(container[segment]) && !Array.isArray(container[segment])) {\n        container[segment] = {};\n      }\n\n      container = container[segment] as Record<string, unknown>;\n    }\n\n    container[segments[segments.length - 1] as string] = this.cloneData(value);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Explicitly removes one or more columns from the current data.\n   *\n   * Supports both single column names and arrays of column names.\n   * Columns can be specified using dot-notation for nested paths.\n   *\n   * @param columns - A single column name or an array of column names to remove\n   *\n   * @example\n   * ```typescript\n   * tracker.unset(\"tempField\");\n   * tracker.unset([\"field1\", \"field2\", \"nested.field\"]);\n   * tracker.getRemovedColumns(); // [\"tempField\", \"field1\", \"field2\", \"nested.field\"]\n   * ```\n   */\n  public unset(columns: string | string[]): void {\n    const targets = Array.isArray(columns) ? columns : [columns];\n\n    for (const path of targets) {\n      if (!path.includes(\".\")) {\n        this.replacedRoots.add(path);\n      }\n\n      this.deleteFromRaw(path);\n    }\n\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Resets both the initial and current snapshots to the provided data.\n   *\n   * If no data is provided, the current snapshot becomes the new baseline.\n   * This clears all tracked changes and removed columns.\n   *\n   * @param data - Optional new data to use as the baseline. If omitted, uses current data.\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.reset(); // Make current state the new baseline\n   * tracker.hasChanges(); // false\n   *\n   * // Or reset to entirely new data:\n   * tracker.reset({ name: \"Charlie\", age: 25 });\n   * ```\n   */\n  public reset(data?: Record<string, unknown>): void {\n    const source = data ?? this.currentRaw;\n    this.initialRaw = this.cloneData(source);\n    this.currentRaw = this.cloneData(source);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n    this.replacedRoots.clear();\n  }\n\n  /**\n   * Flattens the given data object.\n   * Can be overridden by subclasses to change flattening behavior.\n   */\n  protected flattenData(data: Record<string, unknown>): FlatRecord {\n    return flatten(data);\n  }\n\n  /**\n   * Recomputes the dirty and removed column sets by comparing initial and current snapshots.\n   *\n   * This method is called internally after any operation that modifies the current data.\n   * It iterates through all keys in both flattened snapshots and determines which columns\n   * have been modified or removed.\n   *\n   * @protected\n   */\n  protected updateDirtyState(): void {\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n\n    const keys = new Set([\n      ...Object.keys(this.initialFlattened),\n      ...Object.keys(this.currentFlattened),\n    ]);\n\n    for (const key of keys) {\n      const hasCurrent = this.currentFlattened[key] !== undefined || key in this.currentFlattened;\n      const hasInitial = this.initialFlattened[key] !== undefined || key in this.initialFlattened;\n\n      if (!hasCurrent && hasInitial) {\n        this.removedColumns.add(key);\n      }\n\n      const initialValue = this.initialFlattened[key];\n      const currentValue = hasCurrent ? this.currentFlattened[key] : undefined;\n\n      if (!areEqual(initialValue, currentValue)) {\n        this.dirtyColumns.add(key);\n      }\n    }\n  }\n\n  /**\n   * Recursively merges source object into target object, performing a deep merge.\n   *\n   * Only **plain** objects are merged recursively. Everything else — arrays,\n   * primitives, and class instances such as `Date` / `Map` / `Set` / `RegExp` —\n   * replaces the target value. All values are cloned to prevent reference sharing.\n   *\n   * The plain-object guard is load-bearing, not tidiness. A bare\n   * `typeof value === \"object\"` also matches a `Date`, and `Object.entries(date)`\n   * is `[]` — so merging a `Date` over a column that already held a `Date`\n   * recursed into it, copied nothing, and left the old value in the snapshot.\n   * The column then never went dirty and `save()` returned\n   * `{ success: true, modifiedCount: 0 }` without issuing an `UPDATE`. This is\n   * the same lesson `canBeFlatten` above already encodes.\n   *\n   * @param target - The object to merge into\n   * @param source - The object to merge from\n   * @private\n   */\n  protected mergeIntoRaw(target: Record<string, unknown>, source: Record<string, unknown>): void {\n    for (const [key, value] of Object.entries(source)) {\n      if (isPlainObject(value) && isPlainObject(target[key])) {\n        this.mergeIntoRaw(target[key] as Record<string, unknown>, value as Record<string, unknown>);\n        continue;\n      }\n\n      target[key] = this.cloneData(value);\n    }\n  }\n\n  /**\n   * Deletes a field from the current raw data using a dot-notation path.\n   *\n   * Supports nested paths (e.g., \"address.city\") and array indices (e.g., \"items.0\").\n   * If any segment in the path doesn't exist, the operation is a no-op.\n   *\n   * @param path - The dot-notation path to the field to delete\n   * @private\n   */\n  protected deleteFromRaw(path: string): void {\n    const segments = path.split(\".\");\n    let container: unknown = this.currentRaw;\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      if (container === undefined || container === null) {\n        return;\n      }\n\n      const segment = segments[index] as string;\n      if (segment === undefined) {\n        return;\n      }\n\n      container = this.resolveSegment(container, segment);\n    }\n\n    if (container === undefined || container === null) {\n      return;\n    }\n\n    const lastSegment = segments[segments.length - 1];\n    if (lastSegment === undefined) {\n      return;\n    }\n    if (Array.isArray(container)) {\n      const numericIndex = Number(lastSegment);\n      if (!Number.isNaN(numericIndex)) {\n        container.splice(numericIndex, 1);\n      }\n      return;\n    }\n\n    if (typeof container === \"object\") {\n      const existed = lastSegment in (container as Record<string, unknown>);\n\n      delete (container as Record<string, unknown>)[lastSegment];\n\n      // Drop parents this unset just emptied; a parent that was already `{}` is\n      // left alone because nothing was removed from it.\n      if (existed) {\n        pruneEmptyParents(this.currentRaw, path);\n      }\n    }\n  }\n\n  /**\n   * Resolves a single segment of a dot-notation path within a container.\n   *\n   * Handles both object property access and array index access.\n   *\n   * @param container - The object or array to access\n   * @param segment - The property name or array index as a string\n   * @returns The value at the specified segment, or undefined if not found\n   * @private\n   */\n  protected resolveSegment(container: unknown, segment: string): unknown {\n    if (Array.isArray(container)) {\n      const numericIndex = Number(segment);\n      if (Number.isNaN(numericIndex)) {\n        return undefined;\n      }\n\n      return container[numericIndex];\n    }\n\n    if (container && typeof container === \"object\") {\n      return (container as Record<string, unknown>)[segment];\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Creates a deep clone of the provided data.\n   *\n   * @param data - The data to clone\n   * @returns A deep clone of the data\n   * @private\n   */\n  protected cloneData<T>(data: T): T {\n    return clone(data);\n  }\n}\n"],"mappings":"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"}

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

@@ -7,18 +7,18 @@ import { QueryBuilderContract } from "../../contracts/query-builder.contract.mjs
 import { SyncAdapterContract } from "../../contracts/sync-adapter.contract.mjs";
 import { AtomicUpdate, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, InsertResult, RawQueryResult, TransactionContext, UpdateOperations, UpdateResult } from "../../contracts/database-driver.contract.mjs";
 import { IdGeneratorContract } from "../../contracts/database-id-generator.contract.mjs";
+import "../../contracts/index.mjs";
 import { MongoDriverOptions } from "./types.mjs";
 import { ClientSession, Db, MongoClient, MongoClientOptions } from "mongodb";
-
 //#region ../../packages/cascade/src/drivers/mongodb/mongodb-driver.d.ts
-declare function isMongoDBDriverLoaded(): boolean | null;
+export declare function isMongoDBDriverLoaded(): boolean | null;
 /**
  * MongoDB driver implementation that fulfils the Cascade driver contract.
  *
  * It encapsulates the native Mongo client, exposes lifecycle events, and
  * provides helpers for CRUD, transactions, atomic updates, and sync adapters.
  */
-declare class MongoDbDriver implements DriverContract {
+export declare class MongoDbDriver implements DriverContract {
   private readonly config;
   private readonly driverOptions?;
   private readonly events;
@@ -364,5 +364,4 @@ declare class MongoDbDriver implements DriverContract {
   dropAllTables(): Promise<void>;
 }
 //#endregion
-export { MongoDbDriver, isMongoDBDriverLoaded };
 //# sourceMappingURL=mongodb-driver.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":"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"}
+{"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":";;;;;;;;;;;;;wBAyGgB;;;;;;;qBA2BH,yBAAyB;mBA6DjB;mBAWA;mBAvEF;EACV,SAAS;EACT,WAAW;UACV;UACA;UACA;mBACS;UACT;UACA;mBACS;MAKN,aAAa;;;;WAWR;;;;YAKN;;;;;;;;;;WAWM,eAAe,QAAQ;;;;;;;EAkBvC,YACmB;IACf;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,gBAAgB;KAED,gBAAgB;;;;MAWxB;;;;UAWH;;;;MAWG;;;;;;;;;;;;;EAgBJ,eAAe;;;;;;;;;;;;;;;;EAwBf,kBAAkB;;;;;EAkBZ,WAAW;;;;EA4GX,cAAc;;;;EAgBpB,GAAG,OAAO,aAAa,UAAU;;EAKjC,IAAI,OAAO,aAAa,UAAU;;;;EAO5B,OACX,eACA,UAAU,yBACV,UAAU,0BACT,QAAQ;;;;EAgBE,WACX,eACA,WAAW,2BACX,UAAU,0BACT,QAAQ;;;;EAuBE,OACX,eACA,QAAQ,yBACR,QAAQ,yBACR,UAAU,0BACT,QAAQ;;;;EAeE,QAAQ,aACnB,eACA,QAAQ,yBACR,UAAU,yBACV,UAAU,0BACT,QAAQ;;;;;;;EAiBE,iBAAiB,aAC5B,eACA,QAAQ,yBACR,QAAQ,cACR,UAAU,4BACT,QAAQ;;;;;;;;;;;;EA0BE,OAAO,aAClB,eACA,QAAQ,yBACR,UAAU,yBACV,UAAU,0BACT,QAAQ;;;;;;;;;EAwBE,iBAAiB,aAC5B,eACA,QAAQ,yBACR,UAAU,0BACT,QAAQ;;;;EAYE,WACX,eACA,QAAQ,yBACR,QAAQ,kBACR,UAAU,0BACT,QAAQ;;;;EAeE,OACX,eACA,SAAQ,yBACR,UAAU,0BACT;;;;EAWU,WACX,eACA,SAAQ,yBACR,UAAU,0BACT;;;;;;;;EAgBU,cAAc,eAAe,UAAU,0BAA0B;;;;EAWvE,UAAU,MAAM,0BAA0B;;;;EA4B1C,gBAAgB,MAAM,0BAA0B;;;;EAOhD,YAAY,MAAM,0BAA0B;;;;EAkB5C,aAAa,aAAa,gBAAgB,qBAAqB;;;;EAOzD,oBAAoB,QAAQ,0BAA0B;;;;;;;;;;;;;;;;EAgEtD,YAAY,GACvB,KAAK,KAAK,uBAAuB,QAAQ,IACzC,UAAU,0BACT,QAAQ;;;;;;;EAoEE,OACX,eACA,QAAQ,yBACR,YAAY,cACZ,UAAU,4BACT,QAAQ;;;;;;EAkBJ,eAAe;;;;;EAYf,mBAAmB;;;;EAWnB,UAAU,SAAS,gBAAgB;;;;UAOlC;;;;;UAYA;;;;UAWA;;;;UAcA;;;;UA4BA;UAIA;UAqBA;UAiBA;;;;;;UAkBA;UAQA;;;;;;UAiBA;UAEM;;;;;;UAmCN;;;;;UAcA;;;;UASA;;;;;WAwBQ;;;;;EAMT,oBAAoB;;;;;EAQd,MAAM,IAAI,yBACrB,cACA,sBACC,QAAQ,eAAe;;;;;;;;;;EAiBb,eAAe,eAAe;;;;;;;EA6B9B,aAAa,eAAe;;;;;;;EAwB5B,eAAe,eAAe;;;;;;EAY9B,iBAAiB;;;;;;;EAmBjB,UAAU,eAAe;;;;;;EAWzB,kBAAkB,eAAe;;;;;;EAWjC,iBAAiB"}