@warlock.js/cascade 5.1.0 → 5.2.3

package/esm/relations/relation-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"relation-loader.mjs","names":[],"sources":["../../../../../../../cascade/src/relations/relation-loader.ts"],"sourcesContent":["/**\n * @fileoverview Core relation loading logic for the Cascade ORM.\n *\n * The RelationLoader is responsible for efficiently loading related models\n * while preventing N+1 query problems through batch loading strategies.\n *\n * @module @warlock.js/cascade/relations/relation-loader\n */\n\nimport { isLazy, type Lazy } from \"@mongez/reinforcements\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelFromRegistry, resolveModelName } from \"../model/register-model\";\nimport {\n  inferBelongsToForeignKey,\n  inferHasForeignKey,\n  inferPivotKey,\n  inferPivotTable,\n} from \"./key-conventions\";\nimport type {\n  LoadedRelationResult,\n  RelationConstraintCallback,\n  RelationConstraints,\n  RelationDefinition,\n} from \"./types\";\n\n// ============================================================================\n// SHARED HELPER — SINGLE SOURCE OF TRUTH FOR LOADED RELATIONS\n// ============================================================================\n\n/**\n * Attach a loaded relation onto a model instance, keeping the\n * `loadedRelations` Map and the direct property access in sync.\n *\n * The property is installed as a `defineProperty` getter/setter façade over\n * the Map — `model.posts` reads from `loadedRelations.get(\"posts\")`, and\n * assigning `model.posts = newPosts` writes back to the Map. Eliminates the\n * historical drift between the two storage slots: any mutation visible via\n * one path is visible via the other.\n *\n * Used by both `RelationLoader` (the `with()` path) and the Postgres\n * driver's `attachJoinedRelations` (the `joinWith()` path).\n *\n * @example\n *   attachLoadedRelation(user, \"posts\", postsArray);\n *   user.posts === user.loadedRelations.get(\"posts\"); // always true\n */\nexport function attachLoadedRelation(\n  model: object,\n  name: string,\n  value: LoadedRelationResult,\n): void {\n  const modelWithRelations = model as {\n    loadedRelations?: Map<string, LoadedRelationResult>;\n  };\n\n  if (!modelWithRelations.loadedRelations) {\n    modelWithRelations.loadedRelations = new Map();\n  }\n\n  const relations = modelWithRelations.loadedRelations;\n  relations.set(name, value);\n\n  // Install a getter/setter on the instance so direct property access reads\n  // from (and writes to) the Map. `configurable: true` lets a later reload\n  // re-define the property; `enumerable: true` so JSON.stringify and\n  // Object.keys see the relation.\n  Object.defineProperty(model, name, {\n    configurable: true,\n    enumerable: true,\n    get(): LoadedRelationResult | undefined {\n      return relations.get(name);\n    },\n    set(next: LoadedRelationResult): void {\n      relations.set(name, next);\n    },\n  });\n}\n\n// ============================================================================\n// RELATION LOADER CLASS\n// ============================================================================\n\n/**\n * Efficiently loads relationships for one or more model instances.\n *\n * The RelationLoader handles:\n * - Batch loading to prevent N+1 query problems\n * - Nested relation loading via dot notation\n * - Constrained loading with query callbacks\n * - All relation types (hasOne, hasMany, belongsTo, belongsToMany)\n *\n * @template TModel - The type of model being loaded\n *\n * @example\n * ```typescript\n * const users = await User.query().get();\n * const loader = new RelationLoader(users, User);\n *\n * // Load single relation\n * await loader.load(\"posts\");\n *\n * // Load multiple relations\n * await loader.load([\"posts\", \"organization\"]);\n *\n * // Load nested relations\n * await loader.load(\"posts.comments.author\");\n *\n * // Load with constraints\n * await loader.load(\"posts\", {\n *   posts: (query) => query.where(\"isPublished\", true),\n * });\n * ```\n */\nexport class RelationLoader<TModel extends Model = Model> {\n  // ==========================================================================\n  // PRIVATE PROPERTIES\n  // ==========================================================================\n\n  /**\n   * The model instances to load relations for.\n   */\n  private readonly models: TModel[];\n\n  /**\n   * The model class constructor.\n   */\n  private readonly modelClass: ChildModel<TModel>;\n\n  // ==========================================================================\n  // CONSTRUCTOR\n  // ==========================================================================\n\n  /**\n   * Creates a new RelationLoader instance.\n   *\n   * @param models - The model instances to load relations for\n   * @param modelClass - The model class constructor\n   */\n  public constructor(models: TModel[], modelClass: ChildModel<TModel>) {\n    this.models = models;\n    this.modelClass = modelClass;\n  }\n\n  /**\n   * Read the configured relation conventions from this model's data\n   * source. Returns `undefined` when no overrides are set — the inference\n   * helpers fall back to framework defaults in that case.\n   */\n  private get relationDefaults() {\n    try {\n      return this.modelClass.getDataSource()?.relationDefaults;\n    } catch {\n      return undefined;\n    }\n  }\n\n  // ==========================================================================\n  // PUBLIC METHODS\n  // ==========================================================================\n\n  /**\n   * Loads one or more relations for all model instances.\n   *\n   * @param relations - A single relation name, array of names, or constraints object\n   * @param constraints - Optional constraints to apply to the loading query\n   *\n   * @example\n   * ```typescript\n   * // Single relation\n   * await loader.load(\"posts\");\n   *\n   * // Multiple relations\n   * await loader.load([\"posts\", \"organization\"]);\n   *\n   * // With constraints\n   * await loader.load(\"posts\", {\n   *   posts: (query) => query.where(\"status\", \"active\"),\n   * });\n   * ```\n   */\n  public async load(\n    relations: string | string[],\n    constraints?: RelationConstraints,\n  ): Promise<void> {\n    // If no models, nothing to load\n    if (this.models.length === 0) {\n      return;\n    }\n\n    // Normalize to array\n    const relationNames = Array.isArray(relations) ? relations : [relations];\n\n    // Load each relation\n    for (const relationName of relationNames) {\n      const constraint = constraints?.[relationName];\n      const callbackConstraint = typeof constraint === \"function\" ? constraint : undefined;\n\n      await this.loadRelation(relationName, callbackConstraint);\n    }\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - RELATION LOADING\n  // ==========================================================================\n\n  /**\n   * Loads a single relation, handling nested relations via dot notation.\n   *\n   * @param name - The relation name, possibly with dot notation for nesting\n   * @param constraint - Optional constraint callback\n   */\n  private async loadRelation(name: string, constraint?: RelationConstraintCallback): Promise<void> {\n    const path = this.parseNestedRelation(name);\n    const rootRelation = path[0];\n\n    // Get the relation definition from the model class\n    const definition = this.getRelationDefinition(rootRelation);\n\n    if (!definition) {\n      throw new Error(\n        `Relation \"${rootRelation}\" is not defined on model \"${this.modelClass.name}\". ` +\n          `Make sure to define it in the static 'relations' property.`,\n      );\n    }\n\n    // Load based on relation type\n    switch (definition.type) {\n      case \"hasMany\":\n        await this.loadHasMany(rootRelation, definition, constraint);\n        break;\n\n      case \"hasOne\":\n        await this.loadHasOne(rootRelation, definition, constraint);\n        break;\n\n      case \"belongsTo\":\n        await this.loadBelongsTo(rootRelation, definition, constraint);\n        break;\n\n      case \"belongsToMany\":\n        await this.loadBelongsToMany(rootRelation, definition, constraint);\n        break;\n    }\n\n    // If there are nested relations, load them recursively\n    if (path.length > 1) {\n      await this.loadNestedRelations(rootRelation, path.slice(1), constraint);\n    }\n  }\n\n  /**\n   * Loads a hasMany relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadHasMany(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const localKey = definition.localKey ?? this.modelClass.primaryKey ?? \"id\";\n    const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      // No values to query, set empty arrays\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Group by foreign key and assign to models\n    const recordsByForeignKey = this.groupBy(relatedRecords as Model[], foreignKey);\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return recordsByForeignKey.get(keyValue) ?? [];\n    });\n  }\n\n  /**\n   * Loads a hasOne relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadHasOne(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const localKey = definition.localKey ?? this.modelClass.primaryKey ?? \"id\";\n    const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => null);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Index by foreign key\n    const recordsByForeignKey = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      const fkValue = record.get(foreignKey);\n      // For hasOne, take the first match only\n      if (!recordsByForeignKey.has(fkValue)) {\n        recordsByForeignKey.set(fkValue, record);\n      }\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return recordsByForeignKey.get(keyValue) ?? null;\n    });\n  }\n\n  /**\n   * Loads a belongsTo relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadBelongsTo(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const foreignKey = definition.foreignKey ?? inferBelongsToForeignKey(name, this.relationDefaults);\n    const ownerKey = definition.localKey ?? RelatedModel.primaryKey ?? \"id\";\n\n    // Collect all foreign key values from the models\n    const foreignKeyValues = this.collectKeyValues(foreignKey);\n\n    if (foreignKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => null);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(ownerKey, foreignKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Index by owner key\n    const recordsByOwnerKey = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      const keyValue = record.get(ownerKey);\n      recordsByOwnerKey.set(keyValue, record);\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const fkValue = model.get(foreignKey);\n      return recordsByOwnerKey.get(fkValue) ?? null;\n    });\n  }\n\n  /**\n   * Loads a belongsToMany relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadBelongsToMany(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const relatedModelName = resolveModelName(definition.model);\n    const pivotTable =\n      definition.pivot ??\n      inferPivotTable(this.modelClass.name, relatedModelName, this.relationDefaults);\n    const localKey = definition.pivotLocalKey ?? this.modelClass.primaryKey ?? \"id\";\n    const pivotLocalKey =\n      definition.localKey ?? inferPivotKey(this.modelClass.name, this.relationDefaults);\n    const pivotForeignKey =\n      definition.foreignKey ?? inferPivotKey(relatedModelName, this.relationDefaults);\n    const relatedKey = definition.pivotForeignKey ?? RelatedModel.primaryKey ?? \"id\";\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Step 1: Query the pivot table to get the relationships\n    const dataSource = this.modelClass.getDataSource();\n    const pivotQuery = dataSource.driver\n      .queryBuilder(pivotTable)\n      .whereIn(pivotLocalKey, localKeyValues);\n\n    const pivotRecords = (await pivotQuery.get()) as Record<string, unknown>[];\n\n    if (pivotRecords.length === 0) {\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Step 2: Collect related model IDs from pivot\n    const relatedIds = [...new Set(pivotRecords.map((p) => p[pivotForeignKey]))];\n\n    // Step 3: Query the related model\n    const relatedQuery = RelatedModel.query().whereIn(relatedKey, relatedIds);\n\n    if (constraint) {\n      constraint(relatedQuery);\n    }\n\n    const relatedRecords = await relatedQuery.get();\n\n    // Step 4: Index related records by their key\n    const relatedById = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      relatedById.set(record.get(relatedKey), record);\n    }\n\n    // Step 5: Build the relationship map from pivot data\n    const relationshipMap = new Map<unknown, Model[]>();\n\n    for (const pivot of pivotRecords) {\n      const localValue = pivot[pivotLocalKey];\n      const foreignValue = pivot[pivotForeignKey];\n      const relatedRecord = relatedById.get(foreignValue);\n\n      if (relatedRecord) {\n        if (!relationshipMap.has(localValue)) {\n          relationshipMap.set(localValue, []);\n        }\n        relationshipMap.get(localValue)!.push(relatedRecord);\n      }\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return relationshipMap.get(keyValue) ?? [];\n    });\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - NESTED RELATIONS\n  // ==========================================================================\n\n  /**\n   * Loads nested relations recursively.\n   *\n   * @param parentRelation - The name of the parent relation\n   * @param remainingPath - The remaining path segments to load\n   * @param constraint - Optional constraint callback\n   */\n  private async loadNestedRelations(\n    parentRelation: string,\n    remainingPath: string[],\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    // Collect all loaded related models from the parent relation\n    const relatedModels: Model[] = [];\n\n    for (const model of this.models) {\n      const loaded = this.getLoadedRelation(model, parentRelation);\n\n      if (Array.isArray(loaded)) {\n        relatedModels.push(...loaded);\n      } else if (loaded) {\n        relatedModels.push(loaded);\n      }\n    }\n\n    if (relatedModels.length === 0) {\n      return;\n    }\n\n    // Get the related model class\n    const parentDefinition = this.getRelationDefinition(parentRelation);\n    if (!parentDefinition) return;\n\n    const RelatedModelClass = this.resolveModelClass(parentDefinition.model);\n\n    // Create a new loader for the nested relation\n    const nestedLoader = new RelationLoader(relatedModels, RelatedModelClass as ChildModel<Model>);\n\n    // Load the next level\n    const nextRelation = remainingPath.join(\".\");\n    await nestedLoader.load(nextRelation, constraint ? { [nextRelation]: constraint } : undefined);\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - UTILITIES\n  // ==========================================================================\n\n  /**\n   * Parses a dot-notation relation path into segments.\n   *\n   * @param path - The relation path (e.g., \"posts.comments.author\")\n   * @returns An array of relation names\n   */\n  private parseNestedRelation(path: string): string[] {\n    return path.split(\".\");\n  }\n\n  /**\n   * Resolves a model class from the registry by name.\n   *\n   * @param name - The registered model name\n   * @returns The model class constructor\n   * @throws Error if the model is not found in the registry\n   */\n  private resolveModelClass(\n    model: string | ChildModel<Model> | Lazy<unknown>,\n  ): ChildModel<Model> {\n    if (typeof model === \"function\") return model;\n    if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n    const ModelClass = getModelFromRegistry(model);\n\n    if (!ModelClass) {\n      const callerName = this.modelClass.name || \"unknown\";\n      throw new Error(\n        `Cannot resolve relation target — model \"${model}\" is not registered.\\n` +\n          `  Caller: ${callerName} (relation target reference)\\n` +\n          `  Common causes:\\n` +\n          `    - The target model is missing the @RegisterModel() decorator\\n` +\n          `    - The target model's module is not imported anywhere at startup\\n` +\n          `    - Circular import between the caller and target — one of them sees\\n` +\n          `      the other as undefined during module load\\n` +\n          `  Fix: add an explicit \\`import \"<path-to-${model}-model>\";\\` to your app's\\n` +\n          `  entry point so the decorator runs before any query consults this relation.\\n` +\n          `  Alternative: declare the relation with \\`lazy(() => ${model})\\` instead of a string\\n` +\n          `  to bind directly to the class (no registry lookup needed).`,\n      );\n    }\n\n    return ModelClass;\n  }\n\n  /**\n   * Gets the relation definition from the model class.\n   *\n   * @param name - The relation name\n   * @returns The relation definition or undefined\n   */\n  private getRelationDefinition(name: string): RelationDefinition | undefined {\n    const relations = (\n      this.modelClass as unknown as { relations?: Record<string, RelationDefinition> }\n    ).relations;\n    return relations?.[name];\n  }\n\n  /**\n   * Collects unique key values from all models.\n   *\n   * @param key - The key to collect values for\n   * @returns An array of unique key values\n   */\n  private collectKeyValues(key: string): unknown[] {\n    const values = new Set<unknown>();\n\n    for (const model of this.models) {\n      const value = model.get(key);\n      if (value !== undefined && value !== null) {\n        values.add(value);\n      }\n    }\n\n    return [...values];\n  }\n\n  /**\n   * Groups records by a key value.\n   *\n   * @param records - The records to group\n   * @param key - The key to group by\n   * @returns A map of key values to records\n   */\n  private groupBy(records: Model[], key: string): Map<unknown, Model[]> {\n    const groups = new Map<unknown, Model[]>();\n\n    for (const record of records) {\n      const keyValue = record.get(key);\n\n      if (!groups.has(keyValue)) {\n        groups.set(keyValue, []);\n      }\n\n      groups.get(keyValue)!.push(record);\n    }\n\n    return groups;\n  }\n\n  /**\n   * Sets a relation value on all models using a getter function.\n   *\n   * @param name - The relation name\n   * @param getter - Function that returns the relation value for each model\n   */\n  private setRelationOnModels(name: string, getter: (model: TModel) => LoadedRelationResult): void {\n    for (const model of this.models) {\n      const value = getter(model);\n      this.setLoadedRelation(model, name, value);\n    }\n  }\n\n  /**\n   * Gets a loaded relation from a model instance.\n   *\n   * @param model - The model instance\n   * @param name - The relation name\n   * @returns The loaded relation value or undefined\n   */\n  private getLoadedRelation(model: TModel, name: string): LoadedRelationResult | undefined {\n    const loadedRelations = (\n      model as unknown as { loadedRelations?: Map<string, LoadedRelationResult> }\n    ).loadedRelations;\n    return loadedRelations?.get(name);\n  }\n\n  /**\n   * Sets a loaded relation on a model instance.\n   *\n   * @param model - The model instance\n   * @param name - The relation name\n   * @param value - The relation value\n   */\n  private setLoadedRelation(model: TModel, name: string, value: LoadedRelationResult): void {\n    attachLoadedRelation(model as object, name, value);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"relation-loader.mjs","names":[],"sources":["../../../../../../../cascade/src/relations/relation-loader.ts"],"sourcesContent":["/**\n * @fileoverview Core relation loading logic for the Cascade ORM.\n *\n * The RelationLoader is responsible for efficiently loading related models\n * while preventing N+1 query problems through batch loading strategies.\n *\n * @module @warlock.js/cascade/relations/relation-loader\n */\n\nimport { isLazy, type Lazy } from \"@mongez/reinforcements\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelFromRegistry, resolveModelName } from \"../model/register-model\";\nimport {\n  inferBelongsToForeignKey,\n  inferHasForeignKey,\n  inferPivotKey,\n  inferPivotTable,\n} from \"./key-conventions\";\nimport type {\n  LoadedRelationResult,\n  RelationConstraintCallback,\n  RelationConstraints,\n  RelationDefinition,\n} from \"./types\";\n\n// ============================================================================\n// SHARED HELPER — SINGLE SOURCE OF TRUTH FOR LOADED RELATIONS\n// ============================================================================\n\n/**\n * Attach a loaded relation onto a model instance, keeping the\n * `loadedRelations` Map and the direct property access in sync.\n *\n * The property is installed as a `defineProperty` getter/setter façade over\n * the Map — `model.posts` reads from `loadedRelations.get(\"posts\")`, and\n * assigning `model.posts = newPosts` writes back to the Map. Eliminates the\n * historical drift between the two storage slots: any mutation visible via\n * one path is visible via the other.\n *\n * Used by both `RelationLoader` (the `with()` path) and the Postgres\n * driver's `attachJoinedRelations` (the `joinWith()` path).\n *\n * @example\n *   attachLoadedRelation(user, \"posts\", postsArray);\n *   user.posts === user.loadedRelations.get(\"posts\"); // always true\n */\nexport function attachLoadedRelation(\n  model: object,\n  name: string,\n  value: LoadedRelationResult,\n): void {\n  const modelWithRelations = model as {\n    loadedRelations?: Map<string, LoadedRelationResult>;\n  };\n\n  if (!modelWithRelations.loadedRelations) {\n    modelWithRelations.loadedRelations = new Map();\n  }\n\n  const relations = modelWithRelations.loadedRelations;\n  relations.set(name, value);\n\n  // Install a getter/setter on the instance so direct property access reads\n  // from (and writes to) the Map. `configurable: true` lets a later reload\n  // re-define the property; `enumerable: true` so JSON.stringify and\n  // Object.keys see the relation.\n  Object.defineProperty(model, name, {\n    configurable: true,\n    enumerable: true,\n    get(): LoadedRelationResult | undefined {\n      return relations.get(name);\n    },\n    set(next: LoadedRelationResult): void {\n      relations.set(name, next);\n    },\n  });\n}\n\n// ============================================================================\n// RELATION LOADER CLASS\n// ============================================================================\n\n/**\n * Efficiently loads relationships for one or more model instances.\n *\n * The RelationLoader handles:\n * - Batch loading to prevent N+1 query problems\n * - Nested relation loading via dot notation\n * - Constrained loading with query callbacks\n * - All relation types (hasOne, hasMany, belongsTo, belongsToMany)\n *\n * @template TModel - The type of model being loaded\n *\n * @example\n * ```typescript\n * const users = await User.query().get();\n * const loader = new RelationLoader(users, User);\n *\n * // Load single relation\n * await loader.load(\"posts\");\n *\n * // Load multiple relations\n * await loader.load([\"posts\", \"organization\"]);\n *\n * // Load nested relations\n * await loader.load(\"posts.comments.author\");\n *\n * // Load with constraints\n * await loader.load(\"posts\", {\n *   posts: (query) => query.where(\"isPublished\", true),\n * });\n * ```\n */\nexport class RelationLoader<TModel extends Model = Model> {\n  // ==========================================================================\n  // PRIVATE PROPERTIES\n  // ==========================================================================\n\n  /**\n   * The model instances to load relations for.\n   */\n  private readonly models: TModel[];\n\n  /**\n   * The model class constructor.\n   */\n  private readonly modelClass: ChildModel<TModel>;\n\n  // ==========================================================================\n  // CONSTRUCTOR\n  // ==========================================================================\n\n  /**\n   * Creates a new RelationLoader instance.\n   *\n   * @param models - The model instances to load relations for\n   * @param modelClass - The model class constructor\n   */\n  public constructor(models: TModel[], modelClass: ChildModel<TModel>) {\n    this.models = models;\n    this.modelClass = modelClass;\n  }\n\n  /**\n   * Read the configured relation conventions from this model's data\n   * source. Returns `undefined` when no overrides are set — the inference\n   * helpers fall back to framework defaults in that case.\n   */\n  private get relationDefaults() {\n    try {\n      return this.modelClass.getDataSource()?.relationDefaults;\n    } catch {\n      return undefined;\n    }\n  }\n\n  // ==========================================================================\n  // PUBLIC METHODS\n  // ==========================================================================\n\n  /**\n   * Loads one or more relations for all model instances.\n   *\n   * @param relations - A single relation name, array of names, or constraints object\n   * @param constraints - Optional constraints to apply to the loading query\n   *\n   * @example\n   * ```typescript\n   * // Single relation\n   * await loader.load(\"posts\");\n   *\n   * // Multiple relations\n   * await loader.load([\"posts\", \"organization\"]);\n   *\n   * // With constraints\n   * await loader.load(\"posts\", {\n   *   posts: (query) => query.where(\"status\", \"active\"),\n   * });\n   * ```\n   */\n  public async load(\n    relations: string | string[],\n    constraints?: RelationConstraints,\n  ): Promise<void> {\n    // If no models, nothing to load\n    if (this.models.length === 0) {\n      return;\n    }\n\n    // Normalize to array\n    const relationNames = Array.isArray(relations) ? relations : [relations];\n\n    // Load each relation\n    for (const relationName of relationNames) {\n      const constraint = constraints?.[relationName];\n      const callbackConstraint = typeof constraint === \"function\" ? constraint : undefined;\n\n      await this.loadRelation(relationName, callbackConstraint);\n    }\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - RELATION LOADING\n  // ==========================================================================\n\n  /**\n   * Loads a single relation, handling nested relations via dot notation.\n   *\n   * @param name - The relation name, possibly with dot notation for nesting\n   * @param constraint - Optional constraint callback\n   */\n  private async loadRelation(name: string, constraint?: RelationConstraintCallback): Promise<void> {\n    const path = this.parseNestedRelation(name);\n    const rootRelation = path[0];\n\n    // Get the relation definition from the model class\n    const definition = this.getRelationDefinition(rootRelation);\n\n    if (!definition) {\n      throw new Error(\n        `Relation \"${rootRelation}\" is not defined on model \"${this.modelClass.name}\". ` +\n          `Make sure to define it in the static 'relations' property.`,\n      );\n    }\n\n    // Load based on relation type\n    switch (definition.type) {\n      case \"hasMany\":\n        await this.loadHasMany(rootRelation, definition, constraint);\n        break;\n\n      case \"hasOne\":\n        await this.loadHasOne(rootRelation, definition, constraint);\n        break;\n\n      case \"belongsTo\":\n        await this.loadBelongsTo(rootRelation, definition, constraint);\n        break;\n\n      case \"belongsToMany\":\n        await this.loadBelongsToMany(rootRelation, definition, constraint);\n        break;\n    }\n\n    // If there are nested relations, load them recursively\n    if (path.length > 1) {\n      await this.loadNestedRelations(rootRelation, path.slice(1), constraint);\n    }\n  }\n\n  /**\n   * Loads a hasMany relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadHasMany(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const localKey = definition.localKey ?? this.modelClass.primaryKey ?? \"id\";\n    const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      // No values to query, set empty arrays\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Group by foreign key and assign to models\n    const recordsByForeignKey = this.groupBy(relatedRecords as Model[], foreignKey);\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return recordsByForeignKey.get(keyValue) ?? [];\n    });\n  }\n\n  /**\n   * Loads a hasOne relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadHasOne(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const localKey = definition.localKey ?? this.modelClass.primaryKey ?? \"id\";\n    const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => null);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Index by foreign key\n    const recordsByForeignKey = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      const fkValue = record.get(foreignKey);\n      // For hasOne, take the first match only\n      if (!recordsByForeignKey.has(fkValue)) {\n        recordsByForeignKey.set(fkValue, record);\n      }\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return recordsByForeignKey.get(keyValue) ?? null;\n    });\n  }\n\n  /**\n   * Loads a belongsTo relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadBelongsTo(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const foreignKey = definition.foreignKey ?? inferBelongsToForeignKey(name, this.relationDefaults);\n    const ownerKey = definition.localKey ?? RelatedModel.primaryKey ?? \"id\";\n\n    // Collect all foreign key values from the models\n    const foreignKeyValues = this.collectKeyValues(foreignKey);\n\n    if (foreignKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => null);\n      return;\n    }\n\n    // Build and execute query\n    const query = RelatedModel.query().whereIn(ownerKey, foreignKeyValues);\n\n    if (constraint) {\n      constraint(query);\n    }\n\n    const relatedRecords = await query.get();\n\n    // Index by owner key\n    const recordsByOwnerKey = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      const keyValue = record.get(ownerKey);\n      recordsByOwnerKey.set(keyValue, record);\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const fkValue = model.get(foreignKey);\n      return recordsByOwnerKey.get(fkValue) ?? null;\n    });\n  }\n\n  /**\n   * Loads a belongsToMany relation for all models.\n   *\n   * @param name - The relation name\n   * @param definition - The relation definition\n   * @param constraint - Optional constraint callback\n   */\n  private async loadBelongsToMany(\n    name: string,\n    definition: RelationDefinition,\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    const RelatedModel = this.resolveModelClass(definition.model);\n    const relatedModelName = resolveModelName(definition.model);\n    const pivotTable =\n      definition.pivot ??\n      inferPivotTable(this.modelClass.name, relatedModelName, this.relationDefaults);\n    const localKey = definition.pivotLocalKey ?? this.modelClass.primaryKey ?? \"id\";\n    const pivotLocalKey =\n      definition.localKey ?? inferPivotKey(this.modelClass.name, this.relationDefaults);\n    const pivotForeignKey =\n      definition.foreignKey ?? inferPivotKey(relatedModelName, this.relationDefaults);\n    const relatedKey = definition.pivotForeignKey ?? RelatedModel.primaryKey ?? \"id\";\n\n    // Collect all local key values\n    const localKeyValues = this.collectKeyValues(localKey);\n\n    if (localKeyValues.length === 0) {\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Step 1: Query the pivot table to get the relationships\n    const dataSource = this.modelClass.getDataSource();\n    const pivotQuery = dataSource.driver\n      .queryBuilder(pivotTable)\n      .whereIn(pivotLocalKey, localKeyValues);\n\n    const pivotRecords = (await pivotQuery.get()) as Record<string, unknown>[];\n\n    if (pivotRecords.length === 0) {\n      this.setRelationOnModels(name, () => []);\n      return;\n    }\n\n    // Step 2: Collect related model IDs from pivot\n    const relatedIds = [...new Set(pivotRecords.map((p) => p[pivotForeignKey]))];\n\n    // Step 3: Query the related model\n    const relatedQuery = RelatedModel.query().whereIn(relatedKey, relatedIds);\n\n    if (constraint) {\n      constraint(relatedQuery);\n    }\n\n    const relatedRecords = await relatedQuery.get();\n\n    // Step 4: Index related records by their key\n    const relatedById = new Map<unknown, Model>();\n    for (const record of relatedRecords as Model[]) {\n      relatedById.set(record.get(relatedKey), record);\n    }\n\n    // Step 5: Build the relationship map from pivot data\n    const relationshipMap = new Map<unknown, Model[]>();\n\n    for (const pivot of pivotRecords) {\n      const localValue = pivot[pivotLocalKey];\n      const foreignValue = pivot[pivotForeignKey];\n      const relatedRecord = relatedById.get(foreignValue);\n\n      if (relatedRecord) {\n        if (!relationshipMap.has(localValue)) {\n          relationshipMap.set(localValue, []);\n        }\n        relationshipMap.get(localValue)!.push(relatedRecord);\n      }\n    }\n\n    this.setRelationOnModels(name, (model) => {\n      const keyValue = model.get(localKey);\n      return relationshipMap.get(keyValue) ?? [];\n    });\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - NESTED RELATIONS\n  // ==========================================================================\n\n  /**\n   * Loads nested relations recursively.\n   *\n   * @param parentRelation - The name of the parent relation\n   * @param remainingPath - The remaining path segments to load\n   * @param constraint - Optional constraint callback\n   */\n  private async loadNestedRelations(\n    parentRelation: string,\n    remainingPath: string[],\n    constraint?: RelationConstraintCallback,\n  ): Promise<void> {\n    // Collect all loaded related models from the parent relation\n    const relatedModels: Model[] = [];\n\n    for (const model of this.models) {\n      const loaded = this.getLoadedRelation(model, parentRelation);\n\n      if (Array.isArray(loaded)) {\n        relatedModels.push(...loaded);\n      } else if (loaded) {\n        relatedModels.push(loaded);\n      }\n    }\n\n    if (relatedModels.length === 0) {\n      return;\n    }\n\n    // Get the related model class\n    const parentDefinition = this.getRelationDefinition(parentRelation);\n    if (!parentDefinition) return;\n\n    const RelatedModelClass = this.resolveModelClass(parentDefinition.model);\n\n    // Create a new loader for the nested relation\n    const nestedLoader = new RelationLoader(relatedModels, RelatedModelClass as ChildModel<Model>);\n\n    // Load the next level\n    const nextRelation = remainingPath.join(\".\");\n    await nestedLoader.load(nextRelation, constraint ? { [nextRelation]: constraint } : undefined);\n  }\n\n  // ==========================================================================\n  // PRIVATE METHODS - UTILITIES\n  // ==========================================================================\n\n  /**\n   * Parses a dot-notation relation path into segments.\n   *\n   * @param path - The relation path (e.g., \"posts.comments.author\")\n   * @returns An array of relation names\n   */\n  private parseNestedRelation(path: string): string[] {\n    return path.split(\".\");\n  }\n\n  /**\n   * Resolves a model class from the registry by name.\n   *\n   * @param name - The registered model name\n   * @returns The model class constructor\n   * @throws Error if the model is not found in the registry\n   */\n  private resolveModelClass(\n    model: string | ChildModel<Model> | Lazy<unknown>,\n  ): ChildModel<Model> {\n    if (typeof model === \"function\") return model;\n    if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n    const ModelClass = getModelFromRegistry(model);\n\n    if (!ModelClass) {\n      const callerName = this.modelClass.name || \"unknown\";\n      throw new Error(\n        `Cannot resolve relation target — model \"${model}\" is not registered.\\n` +\n          `  Caller: ${callerName} (relation target reference)\\n` +\n          `  Common causes:\\n` +\n          `    - The target model is missing the @RegisterModel() decorator\\n` +\n          `    - The target model's module is not imported anywhere at startup\\n` +\n          `    - Circular import between the caller and target — one of them sees\\n` +\n          `      the other as undefined during module load\\n` +\n          `  Fix: add an explicit \\`import \"<path-to-${model}-model>\";\\` to your app's\\n` +\n          `  entry point so the decorator runs before any query consults this relation.\\n` +\n          `  Alternative: declare the relation with \\`lazy(() => ${model})\\` instead of a string\\n` +\n          `  to bind directly to the class (no registry lookup needed).`,\n      );\n    }\n\n    return ModelClass;\n  }\n\n  /**\n   * Gets the relation definition from the model class.\n   *\n   * @param name - The relation name\n   * @returns The relation definition or undefined\n   */\n  private getRelationDefinition(name: string): RelationDefinition | undefined {\n    const relations = (\n      this.modelClass as unknown as { relations?: Record<string, RelationDefinition> }\n    ).relations;\n    return relations?.[name];\n  }\n\n  /**\n   * Collects unique key values from all models.\n   *\n   * @param key - The key to collect values for\n   * @returns An array of unique key values\n   */\n  private collectKeyValues(key: string): unknown[] {\n    const values = new Set<unknown>();\n\n    for (const model of this.models) {\n      const value = model.get(key);\n      if (value !== undefined && value !== null) {\n        values.add(value);\n      }\n    }\n\n    return [...values];\n  }\n\n  /**\n   * Groups records by a key value.\n   *\n   * @param records - The records to group\n   * @param key - The key to group by\n   * @returns A map of key values to records\n   */\n  private groupBy(records: Model[], key: string): Map<unknown, Model[]> {\n    const groups = new Map<unknown, Model[]>();\n\n    for (const record of records) {\n      const keyValue = record.get(key);\n\n      if (!groups.has(keyValue)) {\n        groups.set(keyValue, []);\n      }\n\n      groups.get(keyValue)!.push(record);\n    }\n\n    return groups;\n  }\n\n  /**\n   * Sets a relation value on all models using a getter function.\n   *\n   * @param name - The relation name\n   * @param getter - Function that returns the relation value for each model\n   */\n  private setRelationOnModels(name: string, getter: (model: TModel) => LoadedRelationResult): void {\n    for (const model of this.models) {\n      const value = getter(model);\n      this.setLoadedRelation(model, name, value);\n    }\n  }\n\n  /**\n   * Gets a loaded relation from a model instance.\n   *\n   * @param model - The model instance\n   * @param name - The relation name\n   * @returns The loaded relation value or undefined\n   */\n  private getLoadedRelation(model: TModel, name: string): LoadedRelationResult | undefined {\n    const loadedRelations = (\n      model as unknown as { loadedRelations?: Map<string, LoadedRelationResult> }\n    ).loadedRelations;\n    return loadedRelations?.get(name);\n  }\n\n  /**\n   * Sets a loaded relation on a model instance.\n   *\n   * @param model - The model instance\n   * @param name - The relation name\n   * @param value - The relation value\n   */\n  private setLoadedRelation(model: TModel, name: string, value: LoadedRelationResult): void {\n    attachLoadedRelation(model as object, name, value);\n  }\n}\n"],"mappings":"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"}

package/esm/remover/database-remover.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-remover.mjs","names":[],"sources":["../../../../../../../cascade/src/remover/database-remover.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type {\n  DriverContract,\n  UpdateOperations,\n} from \"../contracts/database-driver.contract\";\nimport type {\n  RemoverContract,\n  RemoverOptions,\n  RemoverResult,\n} from \"../contracts/database-remover.contract\";\nimport type { OnDeletedEventContext } from \"../events/model-events\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelDeletedEvent } from \"../sync/model-events\";\nimport type { DataSource } from \"./../data-source/data-source\";\n\n/**\n * Database remover service that orchestrates model deletion.\n *\n * Handles the complete deletion pipeline:\n * 1. Strategy resolution (options → model static → data source default)\n * 2. Validation (check if model is new, has primary key)\n * 3. Event emission (deleting, deleted)\n * 4. Driver execution (based on strategy: trash, permanent, or soft)\n * 5. Post-deletion cleanup (mark as new, reset state)\n *\n * @example\n * ```typescript\n * const user = await User.find(1);\n * const remover = new DatabaseRemover(user);\n * const result = await remover.destroy();\n *\n * console.log(result.success); // true\n * console.log(result.strategy); // \"trash\" | \"permanent\" | \"soft\"\n * ```\n */\nexport class DatabaseRemover implements RemoverContract {\n  /** The model instance being deleted */\n  private readonly model: Model;\n\n  /** Model constructor reference */\n  private readonly ctor: ChildModel<Model>;\n\n  /** Data source containing driver */\n  private readonly dataSource: DataSource;\n\n  /** Database driver for executing queries */\n  private readonly driver: DriverContract;\n\n  /** Table/collection name */\n  private readonly table: string;\n\n  /** Primary key field name */\n  private readonly primaryKey: string;\n\n  /**\n   * Create a new remover instance for a model.\n   *\n   * @param model - The model instance to delete\n   *\n   * @example\n   * ```typescript\n   * const user = await User.find(1);\n   * const remover = new DatabaseRemover(user);\n   * await remover.destroy();\n   * ```\n   */\n  public constructor(model: Model) {\n    this.model = model;\n    this.ctor = model.constructor as ChildModel<Model>;\n    this.dataSource = this.ctor.getDataSource();\n    this.driver = this.dataSource.driver;\n    this.table = this.ctor.table;\n    this.primaryKey = this.ctor.primaryKey;\n  }\n\n  /**\n   * Destroy (delete) the model instance from the database.\n   *\n   * @param options - Remover options\n   * @returns Result containing success status, strategy used, and metadata\n   * @throws {Error} If model is new (not saved) or if deletion fails\n   */\n  public async destroy(options: RemoverOptions = {}): Promise<RemoverResult> {\n    // 1. Resolve strategy (options → model static → data source default → permanent)\n    const strategy =\n      options.strategy ??\n      this.ctor.deleteStrategy ??\n      this.dataSource.defaultDeleteStrategy ??\n      \"permanent\";\n\n    // 2. Validate model is not new and has primary key\n    if (this.model.isNew) {\n      throw new Error(\n        `Cannot destroy ${this.ctor.name} instance that hasn't been saved to the database.`,\n      );\n    }\n\n    // The value captured when the model became persisted, never the current\n    // (mass-assignable) one — a delete must not be retargetable by a payload\n    // carrying `{ id: \"<victim-id>\" }`. Same rule as the writer's update filter.\n    const primaryKeyValue = this.model.trustedPrimaryKey;\n    if (!primaryKeyValue) {\n      throw new Error(\n        `Cannot destroy ${this.ctor.name} instance: primary key (${this.primaryKey}) is missing.`,\n      );\n    }\n\n    // 3. Emit deleting event (unless skipEvents)\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"deleting\", {\n        strategy,\n        primaryKeyValue,\n        primaryKey: this.primaryKey,\n      });\n    }\n\n    // 4. Execute deletion based on strategy\n    let deletedCount = 0;\n    let trashRecord: Record<string, unknown> | undefined;\n\n    const filter = { [this.primaryKey]: primaryKeyValue };\n\n    const context: Partial<OnDeletedEventContext> = {\n      strategy,\n      primaryKeyValue,\n      primaryKey: this.primaryKey,\n    };\n\n    switch (strategy) {\n      case \"trash\": {\n        // Move to trash table, then delete\n        const trashTable = this.resolveTrashTable();\n        const documentData = { ...this.model.data };\n\n        // Prepare trash record with metadata and handle ID conflicts\n        const trashData = this.prepareTrashRecord(documentData);\n\n        // Insert into trash table\n        const insertResult = await this.driver.insert(trashTable, trashData);\n        trashRecord = insertResult.document as Record<string, unknown>;\n\n        context.trashRecord = trashRecord;\n\n        // Delete original\n        const result = await this.driver.delete(this.table, filter);\n        deletedCount = result > 0 ? 1 : 0;\n        break;\n      }\n\n      case \"permanent\": {\n        // Direct deletion\n        const result = await this.driver.delete(this.table, filter);\n        deletedCount = result > 0 ? 1 : 0;\n        break;\n      }\n\n      case \"soft\": {\n        // Set deletedAt timestamp (using resolved column name)\n        const deletedAtColumn = this.ctor.deletedAtColumn;\n\n        // Only proceed if deletedAtColumn is configured (not false or undefined)\n        if (deletedAtColumn === false || deletedAtColumn === undefined) {\n          throw new Error(\n            `Cannot perform soft delete on ${this.ctor.name}: deletedAtColumn is not configured. ` +\n              `Set a column name or use a different delete strategy.`,\n          );\n        }\n\n        const deletedAt = new Date();\n        const updateOperations: UpdateOperations = {\n          $set: { [deletedAtColumn]: deletedAt },\n        };\n        const updateResult = await this.driver.update(\n          this.table,\n          filter,\n          updateOperations,\n        );\n        deletedCount = updateResult.modifiedCount > 0 ? 1 : 0;\n\n        // The row stays (unlike trash/permanent), so reflect the persisted\n        // timestamp on the in-memory model — otherwise the instance is stale\n        // and `model.get(deletedAtColumn)` stays undefined after destroy().\n        if (deletedCount > 0) {\n          this.model.set(deletedAtColumn, deletedAt);\n        }\n        break;\n      }\n    }\n\n    if (deletedCount === 0) {\n      throw new Error(\n        `Failed to destroy ${this.ctor.name} instance: record not found.`,\n      );\n    }\n\n    context.deletedCount = deletedCount;\n\n    // 5. Post-deletion cleanup\n    // Only mark as new for permanent and trash (soft delete keeps the record)\n    if (strategy !== \"soft\") {\n      this.model.isNew = true;\n    }\n\n    // 6. Emit deleted event (unless skipEvents)\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"deleted\", context);\n    }\n\n    // 7. Trigger sync operations (fire-and-forget, non-blocking)\n    if (!options.skipSync) {\n      void this.triggerSync();\n    }\n\n    return {\n      success: true,\n      deletedCount,\n      strategy,\n      trashRecord,\n    };\n  }\n\n  /**\n   * Prepare the trash record by preserving all original fields and adding deletion metadata.\n   *\n   * Keeps all original fields intact for easy restoration and adds:\n   * - `deletedAt`: Timestamp when the record was deleted\n   * - `originalTable`: The table/collection the record came from (for filtering in restoreAll)\n   *\n   * **ID Handling:**\n   * - MongoDB with `_id`: Keeps `_id` as-is (unique across database)\n   * - MongoDB with auto-increment `id`: Keeps `id` as a regular field (not primary key)\n   * - SQL: Keeps original `id` as a regular field (trash table uses its own auto-increment primary key)\n   *\n   * The trash table should use its own primary key structure:\n   * - MongoDB: Uses `_id` (ObjectId) as primary key, original `id` is just a field\n   * - SQL: Uses auto-increment `trashId` as primary key, original `id` is just a field\n   *\n   * @param documentData - The original document data\n   * @returns Prepared trash record data with all original fields + deletedAt + originalTable\n   * @private\n   */\n  private prepareTrashRecord(\n    documentData: Record<string, unknown>,\n  ): Record<string, unknown> {\n    // Preserve all original fields and add deletion metadata\n    return {\n      ...documentData,\n      deletedAt: new Date(),\n      originalTable: this.table,\n    };\n  }\n\n  /**\n   * Resolve the trash table/collection name.\n   *\n   * Priority:\n   * 1. Model.trashTable (if set)\n   * 2. Data source defaultTrashTable (e.g., \"RecycleBin\" for MongoDB)\n   * 3. Default pattern: `{table}Trash`\n   *\n   * @returns The trash table/collection name\n   * @private\n   */\n  private resolveTrashTable(): string {\n    if (this.ctor.trashTable) {\n      return this.ctor.trashTable;\n    }\n\n    if (this.dataSource.defaultTrashTable) {\n      return this.dataSource.defaultTrashTable;\n    }\n\n    return `${this.table}Trash`;\n  }\n\n  /**\n   * Trigger sync operations after successful deletion.\n   *\n   * Emits a model.deleted event that ModelSyncOperation listens to.\n   * The sync is handled by registered sync operations, not directly here.\n   *\n   * @private\n   */\n  private async triggerSync(): Promise<void> {\n    // Emit model.deleted event - ModelSyncOperation listens to these\n    await events.triggerAll(getModelDeletedEvent(this.ctor), this.model);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"database-remover.mjs","names":[],"sources":["../../../../../../../cascade/src/remover/database-remover.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type {\n  DriverContract,\n  UpdateOperations,\n} from \"../contracts/database-driver.contract\";\nimport type {\n  RemoverContract,\n  RemoverOptions,\n  RemoverResult,\n} from \"../contracts/database-remover.contract\";\nimport type { OnDeletedEventContext } from \"../events/model-events\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelDeletedEvent } from \"../sync/model-events\";\nimport type { DataSource } from \"./../data-source/data-source\";\n\n/**\n * Database remover service that orchestrates model deletion.\n *\n * Handles the complete deletion pipeline:\n * 1. Strategy resolution (options → model static → data source default)\n * 2. Validation (check if model is new, has primary key)\n * 3. Event emission (deleting, deleted)\n * 4. Driver execution (based on strategy: trash, permanent, or soft)\n * 5. Post-deletion cleanup (mark as new, reset state)\n *\n * @example\n * ```typescript\n * const user = await User.find(1);\n * const remover = new DatabaseRemover(user);\n * const result = await remover.destroy();\n *\n * console.log(result.success); // true\n * console.log(result.strategy); // \"trash\" | \"permanent\" | \"soft\"\n * ```\n */\nexport class DatabaseRemover implements RemoverContract {\n  /** The model instance being deleted */\n  private readonly model: Model;\n\n  /** Model constructor reference */\n  private readonly ctor: ChildModel<Model>;\n\n  /** Data source containing driver */\n  private readonly dataSource: DataSource;\n\n  /** Database driver for executing queries */\n  private readonly driver: DriverContract;\n\n  /** Table/collection name */\n  private readonly table: string;\n\n  /** Primary key field name */\n  private readonly primaryKey: string;\n\n  /**\n   * Create a new remover instance for a model.\n   *\n   * @param model - The model instance to delete\n   *\n   * @example\n   * ```typescript\n   * const user = await User.find(1);\n   * const remover = new DatabaseRemover(user);\n   * await remover.destroy();\n   * ```\n   */\n  public constructor(model: Model) {\n    this.model = model;\n    this.ctor = model.constructor as ChildModel<Model>;\n    this.dataSource = this.ctor.getDataSource();\n    this.driver = this.dataSource.driver;\n    this.table = this.ctor.table;\n    this.primaryKey = this.ctor.primaryKey;\n  }\n\n  /**\n   * Destroy (delete) the model instance from the database.\n   *\n   * @param options - Remover options\n   * @returns Result containing success status, strategy used, and metadata\n   * @throws {Error} If model is new (not saved) or if deletion fails\n   */\n  public async destroy(options: RemoverOptions = {}): Promise<RemoverResult> {\n    // 1. Resolve strategy (options → model static → data source default → permanent)\n    const strategy =\n      options.strategy ??\n      this.ctor.deleteStrategy ??\n      this.dataSource.defaultDeleteStrategy ??\n      \"permanent\";\n\n    // 2. Validate model is not new and has primary key\n    if (this.model.isNew) {\n      throw new Error(\n        `Cannot destroy ${this.ctor.name} instance that hasn't been saved to the database.`,\n      );\n    }\n\n    // The value captured when the model became persisted, never the current\n    // (mass-assignable) one — a delete must not be retargetable by a payload\n    // carrying `{ id: \"<victim-id>\" }`. Same rule as the writer's update filter.\n    const primaryKeyValue = this.model.trustedPrimaryKey;\n    if (!primaryKeyValue) {\n      throw new Error(\n        `Cannot destroy ${this.ctor.name} instance: primary key (${this.primaryKey}) is missing.`,\n      );\n    }\n\n    // 3. Emit deleting event (unless skipEvents)\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"deleting\", {\n        strategy,\n        primaryKeyValue,\n        primaryKey: this.primaryKey,\n      });\n    }\n\n    // 4. Execute deletion based on strategy\n    let deletedCount = 0;\n    let trashRecord: Record<string, unknown> | undefined;\n\n    const filter = { [this.primaryKey]: primaryKeyValue };\n\n    const context: Partial<OnDeletedEventContext> = {\n      strategy,\n      primaryKeyValue,\n      primaryKey: this.primaryKey,\n    };\n\n    switch (strategy) {\n      case \"trash\": {\n        // Move to trash table, then delete\n        const trashTable = this.resolveTrashTable();\n        const documentData = { ...this.model.data };\n\n        // Prepare trash record with metadata and handle ID conflicts\n        const trashData = this.prepareTrashRecord(documentData);\n\n        // Insert into trash table\n        const insertResult = await this.driver.insert(trashTable, trashData);\n        trashRecord = insertResult.document as Record<string, unknown>;\n\n        context.trashRecord = trashRecord;\n\n        // Delete original\n        const result = await this.driver.delete(this.table, filter);\n        deletedCount = result > 0 ? 1 : 0;\n        break;\n      }\n\n      case \"permanent\": {\n        // Direct deletion\n        const result = await this.driver.delete(this.table, filter);\n        deletedCount = result > 0 ? 1 : 0;\n        break;\n      }\n\n      case \"soft\": {\n        // Set deletedAt timestamp (using resolved column name)\n        const deletedAtColumn = this.ctor.deletedAtColumn;\n\n        // Only proceed if deletedAtColumn is configured (not false or undefined)\n        if (deletedAtColumn === false || deletedAtColumn === undefined) {\n          throw new Error(\n            `Cannot perform soft delete on ${this.ctor.name}: deletedAtColumn is not configured. ` +\n              `Set a column name or use a different delete strategy.`,\n          );\n        }\n\n        const deletedAt = new Date();\n        const updateOperations: UpdateOperations = {\n          $set: { [deletedAtColumn]: deletedAt },\n        };\n        const updateResult = await this.driver.update(\n          this.table,\n          filter,\n          updateOperations,\n        );\n        deletedCount = updateResult.modifiedCount > 0 ? 1 : 0;\n\n        // The row stays (unlike trash/permanent), so reflect the persisted\n        // timestamp on the in-memory model — otherwise the instance is stale\n        // and `model.get(deletedAtColumn)` stays undefined after destroy().\n        if (deletedCount > 0) {\n          this.model.set(deletedAtColumn, deletedAt);\n        }\n        break;\n      }\n    }\n\n    if (deletedCount === 0) {\n      throw new Error(\n        `Failed to destroy ${this.ctor.name} instance: record not found.`,\n      );\n    }\n\n    context.deletedCount = deletedCount;\n\n    // 5. Post-deletion cleanup\n    // Only mark as new for permanent and trash (soft delete keeps the record)\n    if (strategy !== \"soft\") {\n      this.model.isNew = true;\n    }\n\n    // 6. Emit deleted event (unless skipEvents)\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"deleted\", context);\n    }\n\n    // 7. Trigger sync operations (fire-and-forget, non-blocking)\n    if (!options.skipSync) {\n      void this.triggerSync();\n    }\n\n    return {\n      success: true,\n      deletedCount,\n      strategy,\n      trashRecord,\n    };\n  }\n\n  /**\n   * Prepare the trash record by preserving all original fields and adding deletion metadata.\n   *\n   * Keeps all original fields intact for easy restoration and adds:\n   * - `deletedAt`: Timestamp when the record was deleted\n   * - `originalTable`: The table/collection the record came from (for filtering in restoreAll)\n   *\n   * **ID Handling:**\n   * - MongoDB with `_id`: Keeps `_id` as-is (unique across database)\n   * - MongoDB with auto-increment `id`: Keeps `id` as a regular field (not primary key)\n   * - SQL: Keeps original `id` as a regular field (trash table uses its own auto-increment primary key)\n   *\n   * The trash table should use its own primary key structure:\n   * - MongoDB: Uses `_id` (ObjectId) as primary key, original `id` is just a field\n   * - SQL: Uses auto-increment `trashId` as primary key, original `id` is just a field\n   *\n   * @param documentData - The original document data\n   * @returns Prepared trash record data with all original fields + deletedAt + originalTable\n   * @private\n   */\n  private prepareTrashRecord(\n    documentData: Record<string, unknown>,\n  ): Record<string, unknown> {\n    // Preserve all original fields and add deletion metadata\n    return {\n      ...documentData,\n      deletedAt: new Date(),\n      originalTable: this.table,\n    };\n  }\n\n  /**\n   * Resolve the trash table/collection name.\n   *\n   * Priority:\n   * 1. Model.trashTable (if set)\n   * 2. Data source defaultTrashTable (e.g., \"RecycleBin\" for MongoDB)\n   * 3. Default pattern: `{table}Trash`\n   *\n   * @returns The trash table/collection name\n   * @private\n   */\n  private resolveTrashTable(): string {\n    if (this.ctor.trashTable) {\n      return this.ctor.trashTable;\n    }\n\n    if (this.dataSource.defaultTrashTable) {\n      return this.dataSource.defaultTrashTable;\n    }\n\n    return `${this.table}Trash`;\n  }\n\n  /**\n   * Trigger sync operations after successful deletion.\n   *\n   * Emits a model.deleted event that ModelSyncOperation listens to.\n   * The sync is handled by registered sync operations, not directly here.\n   *\n   * @private\n   */\n  private async triggerSync(): Promise<void> {\n    // Emit model.deleted event - ModelSyncOperation listens to these\n    await events.triggerAll(getModelDeletedEvent(this.ctor), this.model);\n  }\n}\n"],"mappings":"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"}

package/esm/restorer/database-restorer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-restorer.mjs","names":[],"sources":["../../../../../../../cascade/src/restorer/database-restorer.ts"],"sourcesContent":["import type { DriverContract, UpdateOperations } from \"../contracts/database-driver.contract\";\nimport type {\n  RestorerContract,\n  RestorerOptions,\n  RestorerResult,\n} from \"../contracts/database-restorer.contract\";\nimport type { DataSource } from \"../data-source/data-source\";\nimport type { Model } from \"../model/model\";\nimport type { DeleteStrategy } from \"../types\";\n\n/**\n * Database restorer service that orchestrates model restoration.\n *\n * Handles the complete restoration pipeline:\n * 1. Strategy detection (trash vs soft delete)\n * 2. Record retrieval from trash table or soft-deleted records\n * 3. ID conflict resolution\n * 4. Event emission (restoring, restored)\n * 5. Driver execution (insert back to original table, remove from trash/clear deletedAt)\n *\n * @example\n * ```typescript\n * const restorer = new DatabaseRestorer(User);\n * const result = await restorer.restore(123);\n *\n * console.log(result.success); // true\n * console.log(result.strategy); // \"trash\" | \"soft\"\n * ```\n */\nexport class DatabaseRestorer implements RestorerContract {\n  /** Model constructor reference */\n  private readonly ctor: typeof Model;\n\n  /** Data source containing driver */\n  private readonly dataSource: DataSource;\n\n  /** Database driver for executing queries */\n  private readonly driver: DriverContract;\n\n  /** Table/collection name */\n  private readonly table: string;\n\n  /** Primary key field name */\n  private readonly primaryKey: string;\n\n  /**\n   * Create a new restorer instance for a model class.\n   *\n   * @param modelClass - The model class (static context)\n   *\n   * @example\n   * ```typescript\n   * const restorer = new DatabaseRestorer(User);\n   * await restorer.restore(123);\n   * ```\n   */\n  public constructor(modelClass: typeof Model) {\n    this.ctor = modelClass;\n    this.dataSource = modelClass.getDataSource();\n    this.driver = this.dataSource.driver;\n    this.table = modelClass.table;\n    this.primaryKey = modelClass.primaryKey;\n  }\n\n  /**\n   * Restore a single deleted record by its ID.\n   *\n   * @param id - The primary key value of the record to restore\n   * @param options - Restorer options\n   * @returns Result containing success status, strategy used, and restored record\n   * @throws {Error} If record not found in trash or soft-deleted records\n   * @throws {Error} If ID conflict and onIdConflict is \"fail\"\n   */\n  public async restore(\n    id: string | number,\n    options: RestorerOptions = {},\n  ): Promise<RestorerResult> {\n    const onIdConflict = options.onIdConflict ?? \"assignNew\";\n    const skipEvents = options.skipEvents ?? false;\n\n    // 1. Resolve strategy (options → model static → data source default)\n    const strategy = this.resolveStrategy(options.strategy);\n\n    // 2. Validate strategy (cannot restore permanent deletes)\n    if (strategy === \"permanent\") {\n      throw new Error(\n        `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: permanently deleted records cannot be restored.`,\n      );\n    }\n\n    // 3. Fetch record based on strategy\n    const recordData = await this.fetchRecordByStrategy(id, strategy);\n\n    if (!recordData) {\n      throw new Error(\n        `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: record not found in ${strategy === \"trash\" ? \"trash table\" : \"soft-deleted records\"}.`,\n      );\n    }\n\n    // 4. Prepare record data (remove metadata fields)\n    const restoredData = { ...recordData };\n    delete restoredData.deletedAt;\n    delete restoredData.originalTable;\n\n    // 5. Check for ID conflict and handle\n    const finalData = await this.handleIdConflict(restoredData, id, onIdConflict);\n\n    // 6. Create temporary model instance for event emission\n    // Note: Model is abstract, but at runtime this.ctor is a concrete subclass\n    const model = new (this.ctor as any)(finalData) as Model;\n\n    // 7. Emit restoring event (unless skipEvents)\n    if (!skipEvents) {\n      await model.emitEvent(\"restoring\");\n    }\n\n    // 8. Restore based on strategy\n    if (strategy === \"trash\") {\n      // Insert record back into original table (was moved to trash)\n      await this.driver.insert(this.table, finalData);\n      model.isNew = false;\n\n      // Remove from trash table\n      await this.driver.delete(this.resolveTrashTable(), {\n        [this.primaryKey]: id,\n      });\n    } else if (strategy === \"soft\") {\n      // Record still exists, just unset deletedAt (don't insert - would create duplicate!)\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (deletedAtColumn) {\n        const filter = { [this.primaryKey]: id };\n        const updateOperations: UpdateOperations = {\n          $unset: { [deletedAtColumn]: 1 },\n        };\n\n        await this.driver.update(this.table, filter, updateOperations);\n        model.isNew = false;\n      }\n    }\n\n    // 10. Emit restored event (unless skipEvents)\n    if (!skipEvents) {\n      await model.emitEvent(\"restored\");\n    }\n\n    return {\n      success: true,\n      restoredCount: 1,\n      strategy,\n      restoredRecord: model,\n    };\n  }\n\n  /**\n   * Restore all deleted records for the model's table.\n   *\n   * @param options - Restorer options\n   * @returns Result containing success status, strategy used, and aggregate counts\n   */\n  public async restoreAll(options: RestorerOptions = {}): Promise<RestorerResult> {\n    const onIdConflict = options.onIdConflict ?? \"assignNew\";\n    const skipEvents = options.skipEvents ?? false;\n\n    // 1. Resolve strategy (options → model static → data source default)\n    const strategy = this.resolveStrategy(options.strategy);\n\n    // 2. Validate strategy (cannot restore permanent deletes)\n    if (strategy === \"permanent\") {\n      throw new Error(\n        `Cannot restore all ${this.ctor.name} records: permanently deleted records cannot be restored.`,\n      );\n    }\n\n    // 3. Fetch all records based on strategy\n    const recordsToRestore = await this.fetchAllRecordsByStrategy(strategy);\n\n    if (recordsToRestore.length === 0) {\n      return {\n        success: true,\n        restoredCount: 0,\n        strategy,\n      };\n    }\n\n    // 4. Restore each record\n    let restoredCount = 0;\n    const conflicts: Array<{ id: string | number; reason: string }> = [];\n\n    const restoredRecords: Model[] = [];\n\n    for (const recordData of recordsToRestore) {\n      const id = recordData[this.primaryKey] as string | number;\n\n      try {\n        // Prepare record data (remove metadata fields)\n        const restoredData = { ...recordData };\n        delete restoredData.deletedAt;\n        delete restoredData.originalTable;\n\n        // Check for ID conflict\n        const idExists = await this.checkIdExists(id);\n        if (idExists) {\n          if (onIdConflict === \"fail\") {\n            throw new Error(\n              `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: ID already exists in target table.`,\n            );\n          }\n\n          // Assign new ID\n          const finalData = await this.assignNewId(restoredData);\n          conflicts.push({\n            id,\n            reason: `ID ${id} already exists, assigned new ID ${finalData[this.primaryKey]}`,\n          });\n\n          // Create temporary model for events\n          const model = new (this.ctor as any)(finalData) as Model;\n\n          // Emit restoring event\n          if (!skipEvents) {\n            await model.emitEvent(\"restoring\");\n          }\n\n          // Restore based on strategy\n          if (strategy === \"trash\") {\n            // Insert with new ID (was moved to trash)\n            await this.driver.insert(this.table, finalData);\n            model.isNew = false;\n          } else if (strategy === \"soft\") {\n            // Record still exists, just unset deletedAt\n            const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n            if (deletedAtColumn) {\n              const filter = { [this.primaryKey]: id };\n              const updateOperations: UpdateOperations = {\n                $unset: { [deletedAtColumn]: 1 },\n              };\n              await this.driver.update(this.table, filter, updateOperations);\n              model.isNew = false;\n            }\n          }\n\n          restoredRecords.push(model);\n\n          // Emit restored event\n          if (!skipEvents) {\n            await model.emitEvent(\"restored\");\n          }\n        } else {\n          // No conflict, restore with original ID\n          const model = new (this.ctor as any)(restoredData) as Model;\n\n          // Emit restoring event\n          if (!skipEvents) {\n            await model.emitEvent(\"restoring\");\n          }\n\n          // Restore based on strategy\n          if (strategy === \"trash\") {\n            // Insert with original ID (was moved to trash)\n            await this.driver.insert(this.table, restoredData);\n            model.isNew = false;\n          } else if (strategy === \"soft\") {\n            // Record still exists, just unset deletedAt\n            const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n            if (deletedAtColumn) {\n              const filter = { [this.primaryKey]: id };\n              const updateOperations: UpdateOperations = {\n                $unset: { [deletedAtColumn]: 1 },\n              };\n              await this.driver.update(this.table, filter, updateOperations);\n              model.isNew = false;\n            }\n          }\n\n          restoredRecords.push(model);\n\n          // Emit restored event\n          if (!skipEvents) {\n            await model.emitEvent(\"restored\");\n          }\n        }\n\n        // Remove from trash (only for trash strategy)\n        if (strategy === \"trash\") {\n          const trashTable = this.resolveTrashTable();\n          const trashFilter = { [this.primaryKey]: id };\n          await this.driver.delete(trashTable, trashFilter);\n        }\n\n        restoredCount++;\n      } catch (error) {\n        if (onIdConflict === \"fail\") {\n          throw error;\n        }\n        // Continue with next record if assignNew mode\n        conflicts.push({\n          id,\n          reason: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    return {\n      success: true,\n      restoredCount,\n      restoredRecords,\n      strategy,\n      conflicts: conflicts.length > 0 ? conflicts : undefined,\n    };\n  }\n\n  /**\n   * Resolve the delete strategy.\n   *\n   * Priority: options → model static → data source default → \"permanent\"\n   *\n   * @param strategyOption - Optional strategy override from options\n   * @returns The resolved delete strategy\n   * @private\n   */\n  private resolveStrategy(strategyOption?: \"trash\" | \"soft\"): DeleteStrategy {\n    return (\n      strategyOption ??\n      this.ctor.deleteStrategy ??\n      this.dataSource.defaultDeleteStrategy ??\n      \"permanent\"\n    );\n  }\n\n  /**\n   * Fetch a record by ID based on the delete strategy.\n   *\n   * @param id - The primary key value\n   * @param strategy - The delete strategy to use\n   * @returns The record data, or null if not found\n   * @private\n   */\n  private async fetchRecordByStrategy(id: string | number, strategy: \"trash\" | \"soft\") {\n    if (strategy === \"trash\") {\n      const trashTable = this.resolveTrashTable();\n      try {\n        const trashQuery = await this.driver\n          .queryBuilder(trashTable)\n          .where(this.primaryKey, id)\n          .first<Record<string, unknown>>();\n\n        return trashQuery;\n      } catch {\n        return null;\n      }\n    } else if (strategy === \"soft\") {\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (!deletedAtColumn) {\n        return null;\n      }\n\n      try {\n        const softDeletedQuery = await this.driver\n          .queryBuilder(this.table)\n          .where(this.primaryKey, id)\n          .whereNotNull(deletedAtColumn)\n          .first<Record<string, unknown>>();\n\n        return softDeletedQuery;\n      } catch {\n        return null;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Fetch all records based on the delete strategy.\n   *\n   * @param strategy - The delete strategy to use\n   * @returns Array of record data\n   * @private\n   */\n  private async fetchAllRecordsByStrategy(\n    strategy: \"trash\" | \"soft\",\n  ): Promise<Record<string, unknown>[]> {\n    if (strategy === \"trash\") {\n      const trashTable = this.resolveTrashTable();\n      try {\n        const trashQuery = this.driver\n          .queryBuilder(trashTable)\n          .where(\"originalTable\", this.table)\n          .get();\n\n        return (await trashQuery) as Record<string, unknown>[];\n      } catch {\n        return [];\n      }\n    } else if (strategy === \"soft\") {\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (!deletedAtColumn) {\n        return [];\n      }\n\n      try {\n        const softDeletedQuery = this.driver\n          .queryBuilder(this.table)\n          .whereNotNull(deletedAtColumn)\n          .get();\n\n        return (await softDeletedQuery) as Record<string, unknown>[];\n      } catch {\n        return [];\n      }\n    }\n\n    return [];\n  }\n\n  /**\n   * Handle ID conflict by checking if ID exists and assigning new one if needed.\n   *\n   * @param recordData - The record data to restore\n   * @param originalId - The original ID value\n   * @param onIdConflict - Conflict resolution strategy\n   * @returns Record data with potentially new ID\n   * @private\n   */\n  private async handleIdConflict(\n    recordData: Record<string, unknown>,\n    originalId: string | number,\n    onIdConflict: \"fail\" | \"assignNew\",\n  ): Promise<Record<string, unknown>> {\n    const idExists = await this.checkIdExists(originalId);\n\n    if (idExists) {\n      if (onIdConflict === \"fail\") {\n        throw new Error(\n          `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${originalId}: ID already exists in target table.`,\n        );\n      }\n\n      // Assign new ID\n      return await this.assignNewId(recordData);\n    }\n\n    return recordData;\n  }\n\n  /**\n   * Check if an ID already exists in the target table.\n   *\n   * @param id - The ID to check\n   * @returns True if ID exists, false otherwise\n   * @private\n   */\n  private async checkIdExists(id: string | number): Promise<boolean> {\n    try {\n      const query = this.driver.queryBuilder(this.table).where(this.primaryKey, id).exists();\n\n      return await query;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Assign a new ID to the record data.\n   *\n   * For MongoDB: Generates new ObjectId for `_id`, keeps `id` if it exists\n   * For SQL: Removes `id` to let database auto-increment\n   *\n   * @param recordData - The record data\n   * @returns Record data with new ID assigned\n   * @private\n   */\n  private async assignNewId(recordData: Record<string, unknown>): Promise<Record<string, unknown>> {\n    const isMongoDb = this.driver.name === \"mongodb\";\n    const newData = { ...recordData };\n\n    if (isMongoDb) {\n      // MongoDB: Generate new ObjectId for _id\n      if (this.primaryKey === \"_id\") {\n        // Remove _id to let MongoDB generate new one\n        delete newData._id;\n      } else if (this.primaryKey === \"id\") {\n        // Remove id to let ID generator create new one\n        delete newData.id;\n      }\n    } else {\n      // SQL: Remove primary key to let database auto-increment\n      delete newData[this.primaryKey];\n    }\n\n    return newData;\n  }\n\n  /**\n   * Resolve the trash table/collection name.\n   *\n   * Priority:\n   * 1. Model.trashTable (if set)\n   * 2. Data source defaultTrashTable (e.g., \"RecycleBin\" for MongoDB)\n   * 3. Default pattern: `{table}Trash`\n   *\n   * @returns The trash table/collection name\n   * @private\n   */\n  private resolveTrashTable(): string {\n    if (this.ctor.trashTable) {\n      return this.ctor.trashTable;\n    }\n\n    if (this.dataSource.defaultTrashTable) {\n      return this.dataSource.defaultTrashTable;\n    }\n\n    return `${this.table}Trash`;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"database-restorer.mjs","names":[],"sources":["../../../../../../../cascade/src/restorer/database-restorer.ts"],"sourcesContent":["import type { DriverContract, UpdateOperations } from \"../contracts/database-driver.contract\";\nimport type {\n  RestorerContract,\n  RestorerOptions,\n  RestorerResult,\n} from \"../contracts/database-restorer.contract\";\nimport type { DataSource } from \"../data-source/data-source\";\nimport type { Model } from \"../model/model\";\nimport type { DeleteStrategy } from \"../types\";\n\n/**\n * Database restorer service that orchestrates model restoration.\n *\n * Handles the complete restoration pipeline:\n * 1. Strategy detection (trash vs soft delete)\n * 2. Record retrieval from trash table or soft-deleted records\n * 3. ID conflict resolution\n * 4. Event emission (restoring, restored)\n * 5. Driver execution (insert back to original table, remove from trash/clear deletedAt)\n *\n * @example\n * ```typescript\n * const restorer = new DatabaseRestorer(User);\n * const result = await restorer.restore(123);\n *\n * console.log(result.success); // true\n * console.log(result.strategy); // \"trash\" | \"soft\"\n * ```\n */\nexport class DatabaseRestorer implements RestorerContract {\n  /** Model constructor reference */\n  private readonly ctor: typeof Model;\n\n  /** Data source containing driver */\n  private readonly dataSource: DataSource;\n\n  /** Database driver for executing queries */\n  private readonly driver: DriverContract;\n\n  /** Table/collection name */\n  private readonly table: string;\n\n  /** Primary key field name */\n  private readonly primaryKey: string;\n\n  /**\n   * Create a new restorer instance for a model class.\n   *\n   * @param modelClass - The model class (static context)\n   *\n   * @example\n   * ```typescript\n   * const restorer = new DatabaseRestorer(User);\n   * await restorer.restore(123);\n   * ```\n   */\n  public constructor(modelClass: typeof Model) {\n    this.ctor = modelClass;\n    this.dataSource = modelClass.getDataSource();\n    this.driver = this.dataSource.driver;\n    this.table = modelClass.table;\n    this.primaryKey = modelClass.primaryKey;\n  }\n\n  /**\n   * Restore a single deleted record by its ID.\n   *\n   * @param id - The primary key value of the record to restore\n   * @param options - Restorer options\n   * @returns Result containing success status, strategy used, and restored record\n   * @throws {Error} If record not found in trash or soft-deleted records\n   * @throws {Error} If ID conflict and onIdConflict is \"fail\"\n   */\n  public async restore(\n    id: string | number,\n    options: RestorerOptions = {},\n  ): Promise<RestorerResult> {\n    const onIdConflict = options.onIdConflict ?? \"assignNew\";\n    const skipEvents = options.skipEvents ?? false;\n\n    // 1. Resolve strategy (options → model static → data source default)\n    const strategy = this.resolveStrategy(options.strategy);\n\n    // 2. Validate strategy (cannot restore permanent deletes)\n    if (strategy === \"permanent\") {\n      throw new Error(\n        `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: permanently deleted records cannot be restored.`,\n      );\n    }\n\n    // 3. Fetch record based on strategy\n    const recordData = await this.fetchRecordByStrategy(id, strategy);\n\n    if (!recordData) {\n      throw new Error(\n        `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: record not found in ${strategy === \"trash\" ? \"trash table\" : \"soft-deleted records\"}.`,\n      );\n    }\n\n    // 4. Prepare record data (remove metadata fields)\n    const restoredData = { ...recordData };\n    delete restoredData.deletedAt;\n    delete restoredData.originalTable;\n\n    // 5. Check for ID conflict and handle\n    const finalData = await this.handleIdConflict(restoredData, id, onIdConflict);\n\n    // 6. Create temporary model instance for event emission\n    // Note: Model is abstract, but at runtime this.ctor is a concrete subclass\n    const model = new (this.ctor as any)(finalData) as Model;\n\n    // 7. Emit restoring event (unless skipEvents)\n    if (!skipEvents) {\n      await model.emitEvent(\"restoring\");\n    }\n\n    // 8. Restore based on strategy\n    if (strategy === \"trash\") {\n      // Insert record back into original table (was moved to trash)\n      await this.driver.insert(this.table, finalData);\n      model.isNew = false;\n\n      // Remove from trash table\n      await this.driver.delete(this.resolveTrashTable(), {\n        [this.primaryKey]: id,\n      });\n    } else if (strategy === \"soft\") {\n      // Record still exists, just unset deletedAt (don't insert - would create duplicate!)\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (deletedAtColumn) {\n        const filter = { [this.primaryKey]: id };\n        const updateOperations: UpdateOperations = {\n          $unset: { [deletedAtColumn]: 1 },\n        };\n\n        await this.driver.update(this.table, filter, updateOperations);\n        model.isNew = false;\n      }\n    }\n\n    // 10. Emit restored event (unless skipEvents)\n    if (!skipEvents) {\n      await model.emitEvent(\"restored\");\n    }\n\n    return {\n      success: true,\n      restoredCount: 1,\n      strategy,\n      restoredRecord: model,\n    };\n  }\n\n  /**\n   * Restore all deleted records for the model's table.\n   *\n   * @param options - Restorer options\n   * @returns Result containing success status, strategy used, and aggregate counts\n   */\n  public async restoreAll(options: RestorerOptions = {}): Promise<RestorerResult> {\n    const onIdConflict = options.onIdConflict ?? \"assignNew\";\n    const skipEvents = options.skipEvents ?? false;\n\n    // 1. Resolve strategy (options → model static → data source default)\n    const strategy = this.resolveStrategy(options.strategy);\n\n    // 2. Validate strategy (cannot restore permanent deletes)\n    if (strategy === \"permanent\") {\n      throw new Error(\n        `Cannot restore all ${this.ctor.name} records: permanently deleted records cannot be restored.`,\n      );\n    }\n\n    // 3. Fetch all records based on strategy\n    const recordsToRestore = await this.fetchAllRecordsByStrategy(strategy);\n\n    if (recordsToRestore.length === 0) {\n      return {\n        success: true,\n        restoredCount: 0,\n        strategy,\n      };\n    }\n\n    // 4. Restore each record\n    let restoredCount = 0;\n    const conflicts: Array<{ id: string | number; reason: string }> = [];\n\n    const restoredRecords: Model[] = [];\n\n    for (const recordData of recordsToRestore) {\n      const id = recordData[this.primaryKey] as string | number;\n\n      try {\n        // Prepare record data (remove metadata fields)\n        const restoredData = { ...recordData };\n        delete restoredData.deletedAt;\n        delete restoredData.originalTable;\n\n        // Check for ID conflict\n        const idExists = await this.checkIdExists(id);\n        if (idExists) {\n          if (onIdConflict === \"fail\") {\n            throw new Error(\n              `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: ID already exists in target table.`,\n            );\n          }\n\n          // Assign new ID\n          const finalData = await this.assignNewId(restoredData);\n          conflicts.push({\n            id,\n            reason: `ID ${id} already exists, assigned new ID ${finalData[this.primaryKey]}`,\n          });\n\n          // Create temporary model for events\n          const model = new (this.ctor as any)(finalData) as Model;\n\n          // Emit restoring event\n          if (!skipEvents) {\n            await model.emitEvent(\"restoring\");\n          }\n\n          // Restore based on strategy\n          if (strategy === \"trash\") {\n            // Insert with new ID (was moved to trash)\n            await this.driver.insert(this.table, finalData);\n            model.isNew = false;\n          } else if (strategy === \"soft\") {\n            // Record still exists, just unset deletedAt\n            const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n            if (deletedAtColumn) {\n              const filter = { [this.primaryKey]: id };\n              const updateOperations: UpdateOperations = {\n                $unset: { [deletedAtColumn]: 1 },\n              };\n              await this.driver.update(this.table, filter, updateOperations);\n              model.isNew = false;\n            }\n          }\n\n          restoredRecords.push(model);\n\n          // Emit restored event\n          if (!skipEvents) {\n            await model.emitEvent(\"restored\");\n          }\n        } else {\n          // No conflict, restore with original ID\n          const model = new (this.ctor as any)(restoredData) as Model;\n\n          // Emit restoring event\n          if (!skipEvents) {\n            await model.emitEvent(\"restoring\");\n          }\n\n          // Restore based on strategy\n          if (strategy === \"trash\") {\n            // Insert with original ID (was moved to trash)\n            await this.driver.insert(this.table, restoredData);\n            model.isNew = false;\n          } else if (strategy === \"soft\") {\n            // Record still exists, just unset deletedAt\n            const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n            if (deletedAtColumn) {\n              const filter = { [this.primaryKey]: id };\n              const updateOperations: UpdateOperations = {\n                $unset: { [deletedAtColumn]: 1 },\n              };\n              await this.driver.update(this.table, filter, updateOperations);\n              model.isNew = false;\n            }\n          }\n\n          restoredRecords.push(model);\n\n          // Emit restored event\n          if (!skipEvents) {\n            await model.emitEvent(\"restored\");\n          }\n        }\n\n        // Remove from trash (only for trash strategy)\n        if (strategy === \"trash\") {\n          const trashTable = this.resolveTrashTable();\n          const trashFilter = { [this.primaryKey]: id };\n          await this.driver.delete(trashTable, trashFilter);\n        }\n\n        restoredCount++;\n      } catch (error) {\n        if (onIdConflict === \"fail\") {\n          throw error;\n        }\n        // Continue with next record if assignNew mode\n        conflicts.push({\n          id,\n          reason: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    return {\n      success: true,\n      restoredCount,\n      restoredRecords,\n      strategy,\n      conflicts: conflicts.length > 0 ? conflicts : undefined,\n    };\n  }\n\n  /**\n   * Resolve the delete strategy.\n   *\n   * Priority: options → model static → data source default → \"permanent\"\n   *\n   * @param strategyOption - Optional strategy override from options\n   * @returns The resolved delete strategy\n   * @private\n   */\n  private resolveStrategy(strategyOption?: \"trash\" | \"soft\"): DeleteStrategy {\n    return (\n      strategyOption ??\n      this.ctor.deleteStrategy ??\n      this.dataSource.defaultDeleteStrategy ??\n      \"permanent\"\n    );\n  }\n\n  /**\n   * Fetch a record by ID based on the delete strategy.\n   *\n   * @param id - The primary key value\n   * @param strategy - The delete strategy to use\n   * @returns The record data, or null if not found\n   * @private\n   */\n  private async fetchRecordByStrategy(id: string | number, strategy: \"trash\" | \"soft\") {\n    if (strategy === \"trash\") {\n      const trashTable = this.resolveTrashTable();\n      try {\n        const trashQuery = await this.driver\n          .queryBuilder(trashTable)\n          .where(this.primaryKey, id)\n          .first<Record<string, unknown>>();\n\n        return trashQuery;\n      } catch {\n        return null;\n      }\n    } else if (strategy === \"soft\") {\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (!deletedAtColumn) {\n        return null;\n      }\n\n      try {\n        const softDeletedQuery = await this.driver\n          .queryBuilder(this.table)\n          .where(this.primaryKey, id)\n          .whereNotNull(deletedAtColumn)\n          .first<Record<string, unknown>>();\n\n        return softDeletedQuery;\n      } catch {\n        return null;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Fetch all records based on the delete strategy.\n   *\n   * @param strategy - The delete strategy to use\n   * @returns Array of record data\n   * @private\n   */\n  private async fetchAllRecordsByStrategy(\n    strategy: \"trash\" | \"soft\",\n  ): Promise<Record<string, unknown>[]> {\n    if (strategy === \"trash\") {\n      const trashTable = this.resolveTrashTable();\n      try {\n        const trashQuery = this.driver\n          .queryBuilder(trashTable)\n          .where(\"originalTable\", this.table)\n          .get();\n\n        return (await trashQuery) as Record<string, unknown>[];\n      } catch {\n        return [];\n      }\n    } else if (strategy === \"soft\") {\n      const deletedAtColumn = this.ctor.deletedAtColumn ?? \"deletedAt\";\n      if (!deletedAtColumn) {\n        return [];\n      }\n\n      try {\n        const softDeletedQuery = this.driver\n          .queryBuilder(this.table)\n          .whereNotNull(deletedAtColumn)\n          .get();\n\n        return (await softDeletedQuery) as Record<string, unknown>[];\n      } catch {\n        return [];\n      }\n    }\n\n    return [];\n  }\n\n  /**\n   * Handle ID conflict by checking if ID exists and assigning new one if needed.\n   *\n   * @param recordData - The record data to restore\n   * @param originalId - The original ID value\n   * @param onIdConflict - Conflict resolution strategy\n   * @returns Record data with potentially new ID\n   * @private\n   */\n  private async handleIdConflict(\n    recordData: Record<string, unknown>,\n    originalId: string | number,\n    onIdConflict: \"fail\" | \"assignNew\",\n  ): Promise<Record<string, unknown>> {\n    const idExists = await this.checkIdExists(originalId);\n\n    if (idExists) {\n      if (onIdConflict === \"fail\") {\n        throw new Error(\n          `Cannot restore ${this.ctor.name} with ${this.primaryKey} ${originalId}: ID already exists in target table.`,\n        );\n      }\n\n      // Assign new ID\n      return await this.assignNewId(recordData);\n    }\n\n    return recordData;\n  }\n\n  /**\n   * Check if an ID already exists in the target table.\n   *\n   * @param id - The ID to check\n   * @returns True if ID exists, false otherwise\n   * @private\n   */\n  private async checkIdExists(id: string | number): Promise<boolean> {\n    try {\n      const query = this.driver.queryBuilder(this.table).where(this.primaryKey, id).exists();\n\n      return await query;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Assign a new ID to the record data.\n   *\n   * For MongoDB: Generates new ObjectId for `_id`, keeps `id` if it exists\n   * For SQL: Removes `id` to let database auto-increment\n   *\n   * @param recordData - The record data\n   * @returns Record data with new ID assigned\n   * @private\n   */\n  private async assignNewId(recordData: Record<string, unknown>): Promise<Record<string, unknown>> {\n    const isMongoDb = this.driver.name === \"mongodb\";\n    const newData = { ...recordData };\n\n    if (isMongoDb) {\n      // MongoDB: Generate new ObjectId for _id\n      if (this.primaryKey === \"_id\") {\n        // Remove _id to let MongoDB generate new one\n        delete newData._id;\n      } else if (this.primaryKey === \"id\") {\n        // Remove id to let ID generator create new one\n        delete newData.id;\n      }\n    } else {\n      // SQL: Remove primary key to let database auto-increment\n      delete newData[this.primaryKey];\n    }\n\n    return newData;\n  }\n\n  /**\n   * Resolve the trash table/collection name.\n   *\n   * Priority:\n   * 1. Model.trashTable (if set)\n   * 2. Data source defaultTrashTable (e.g., \"RecycleBin\" for MongoDB)\n   * 3. Default pattern: `{table}Trash`\n   *\n   * @returns The trash table/collection name\n   * @private\n   */\n  private resolveTrashTable(): string {\n    if (this.ctor.trashTable) {\n      return this.ctor.trashTable;\n    }\n\n    if (this.dataSource.defaultTrashTable) {\n      return this.dataSource.defaultTrashTable;\n    }\n\n    return `${this.table}Trash`;\n  }\n}\n"],"mappings":"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"}

package/esm/sync/model-sync-operation.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model-sync-operation.d.mts","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync-operation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAiCa,kBAAA,YAA8B,0BAAA;EA2BvC;;;EAAA,iBAvBe,MAAA;EA0EV;;;EAAA,iBArEU,aAAA;EAsGV;;;EAAA,QAjGC,YAAA;EA4IA;;;;;;;;cAjIN,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,WAAA,UACA,MAAA;EAkSkB;;;AAAwB;;;;;;;;EAjQrC,KAAA,CAAM,MAAA;;;;;;;;;;;;;EAiBN,UAAA,CAAW,KAAA;;;;;;;;;;;;EAgBX,QAAA,CAAS,KAAA;;;;;;;;;;;;;EAiBT,WAAA,CAAY,MAAA;;;;;;;;;;;EAeZ,aAAA;;;;;;;;;;;EAeA,cAAA;;;;;UAaC,SAAA;;;;;EAwBD,WAAA;;;;EAYA,QAAA;;;;;UAYC,kBAAA;;;;;UAsCA,kBAAA;;;;UAuCA,UAAA;;;;UAWA,eAAA;;;;UAiBM,qBAAA;;;;EAWP,SAAA,IAAa,QAAA,CAAS,eAAA;AAAA"}
+{"version":3,"file":"model-sync-operation.d.mts","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync-operation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAiCa,kBAAA,YAA8B,0BAAA;EA2BvC;;;EAAA,iBAvBe,MAAA;EA0EV;;;EAAA,iBArEU,aAAA;EAsGV;;;EAAA,QAjGC,YAAA;EA4IA;;;;;;;;cAjIN,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,WAAA,UACA,MAAA;EAkSkB;;;AAAwB;;;;;;;;EAjQrC,KAAA,CAAM,MAAA;;;;;;;;;;;;;EAiBN,UAAA,CAAW,KAAA;;;;;;;;;;;;EAgBX,QAAA,CAAS,KAAA;;;;;;;;;;;;;EAiBT,WAAA,CAAY,MAAA;;;;;;;;;;;EAeZ,aAAA,CAAA;;;;;;;;;;;EAeA,cAAA,CAAA;;;;;UAaC,SAAA;;;;;EAwBD,WAAA,CAAA;;;;EAYA,QAAA,CAAA;;;;;UAYC,kBAAA;;;;;UAsCA,kBAAA;;;;UAuCA,UAAA;;;;UAWA,eAAA;;;;UAiBM,qBAAA;;;;EAWP,SAAA,CAAA,GAAa,QAAA,CAAS,eAAA;AAAA"}

package/esm/sync/model-sync-operation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"model-sync-operation.mjs","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync-operation.ts"],"sourcesContent":["/**\n * Model sync operation class.\n *\n * Manages a single sync relationship between a source and target model.\n * Subscribes to source model events and triggers sync operations when\n * the source is updated or deleted.\n *\n * @module cascade-next/sync/model-sync-operation\n */\n\nimport events, { type EventSubscription } from \"@mongez/events\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelDeletedEvent, getModelUpdatedEvent } from \"./model-events\";\nimport { DEFAULT_MAX_SYNC_DEPTH } from \"./sync-context\";\nimport { SyncManager } from \"./sync-manager\";\nimport type { ModelSyncConfig, ModelSyncOperationContract } from \"./types\";\n\n/**\n * Manages a single model sync operation.\n *\n * Subscribes to source model events (updated, deleted) and triggers\n * sync operations to update embedded data in target models.\n *\n * @example\n * ```typescript\n * // Created via modelSync.sync() or Model.sync()\n * const operation = new ModelSyncOperation(Category, Product, \"category\", false);\n * operation\n *   .embed(\"embedMinimal\")\n *   .watchFields([\"name\", \"slug\"])\n *   .unsetOnDelete();\n * ```\n */\nexport class ModelSyncOperation implements ModelSyncOperationContract {\n  /**\n   * Configuration for this sync operation.\n   */\n  private readonly config: ModelSyncConfig;\n\n  /**\n   * Active event subscriptions for cleanup.\n   */\n  private readonly subscriptions: EventSubscription[] = [];\n\n  /**\n   * Whether this operation is currently subscribed to events.\n   */\n  private isSubscribed = false;\n\n  /**\n   * Create a new model sync operation.\n   *\n   * @param sourceModel - Source model class that triggers sync\n   * @param targetModel - Target model class that receives data\n   * @param targetField - Field path in target model\n   * @param isMany - Whether this syncs to an array field\n   */\n  public constructor(\n    sourceModelClass: ChildModel<Model>,\n    targetModelClass: ChildModel<Model>,\n    targetField: string,\n    isMany: boolean,\n  ) {\n    this.config = {\n      sourceModel: sourceModelClass,\n      targetModel: targetModelClass,\n      targetField,\n      isMany,\n      embedKey: \"embedData\",\n      identifierField: \"id\",\n      maxSyncDepth: DEFAULT_MAX_SYNC_DEPTH,\n      watchFields: [],\n      unsetOnDelete: false,\n      removeOnDelete: false,\n    };\n\n    this.subscribe();\n  }\n\n  // ============================================================================\n  // FLUENT CONFIGURATION\n  // ============================================================================\n\n  /**\n   * Set the embed method to call on source model.\n   *\n   * @param embed - getter property name (e.g., \"embedData\", \"embedMinimal\") Or Array of fields\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").embed(\"embedMinimal\");\n   * ```\n   */\n  public embed(method: string | string[]): this {\n    this.config.embedKey = method;\n    return this;\n  }\n\n  /**\n   * Set the identifier field for array matching.\n   * Required when syncing to array fields (syncMany).\n   *\n   * @param field - Field name used as identifier (default: \"id\")\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Tag.syncMany(Post, \"tags\").identifyBy(\"tagId\");\n   * ```\n   */\n  public identifyBy(field: string): this {\n    this.config.identifierField = field;\n    return this;\n  }\n\n  /**\n   * Set the maximum sync depth for chained operations.\n   *\n   * @param depth - Maximum depth (default: 3)\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").maxDepth(2);\n   * ```\n   */\n  public maxDepth(depth: number): this {\n    this.config.maxSyncDepth = depth;\n    return this;\n  }\n\n  /**\n   * Set which fields to watch for changes.\n   * Sync only triggers when these fields change.\n   *\n   * @param fields - Array of field names to watch (empty = all)\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").watchFields([\"name\", \"slug\"]);\n   * ```\n   */\n  public watchFields(fields: string[]): this {\n    this.config.watchFields = fields;\n    return this;\n  }\n\n  /**\n   * Unset the target field when source is deleted.\n   *\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").unsetOnDelete();\n   * ```\n   */\n  public unsetOnDelete(): this {\n    this.config.unsetOnDelete = true;\n    return this;\n  }\n\n  /**\n   * Delete target documents when source is deleted.\n   *\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * User.sync(Profile, \"user\").removeOnDelete();\n   * ```\n   */\n  public removeOnDelete(): this {\n    this.config.removeOnDelete = true;\n    return this;\n  }\n\n  // ============================================================================\n  // LIFECYCLE\n  // ============================================================================\n\n  /**\n   * Subscribe to source model events.\n   * Called automatically in constructor.\n   */\n  private subscribe(): void {\n    if (this.isSubscribed) {\n      return;\n    }\n\n    const sourceModel = this.config.sourceModel;\n\n    // Subscribe to model.updated event\n    this.subscriptions.push(\n      events.subscribe(getModelUpdatedEvent(sourceModel), this.handleModelUpdated),\n    );\n\n    // Subscribe to model.deleted event\n    this.subscriptions.push(\n      events.subscribe(getModelDeletedEvent(sourceModel), this.handleModelDeleted),\n    );\n\n    this.isSubscribed = true;\n  }\n\n  /**\n   * Unsubscribe from all events and cleanup.\n   * Called automatically when using modelSync.register().\n   */\n  public unsubscribe(): void {\n    for (const subscription of this.subscriptions) {\n      subscription.unsubscribe?.();\n    }\n\n    this.subscriptions.length = 0;\n    this.isSubscribed = false;\n  }\n\n  /**\n   * Cleanup the sync operations\n   */\n  public $cleanup() {\n    return this.unsubscribe();\n  }\n\n  // ============================================================================\n  // EVENT HANDLERS\n  // ============================================================================\n\n  /**\n   * Handle model updated event.\n   * Triggers sync to update embedded data in target models.\n   */\n  private handleModelUpdated = async (model: Model, changedFields: string[]): Promise<void> => {\n    // Check if we should sync based on watched fields\n    if (!this.shouldSync(changedFields)) {\n      return;\n    }\n\n    try {\n      const primaryKey = (this.config.sourceModel as any).primaryKey || \"id\";\n      const sourceId = model.get(primaryKey) as string | number;\n\n      if (!sourceId) {\n        return;\n      }\n\n      // Get the driver from the source model's data source\n      const dataSource = this.config.sourceModel.getDataSource();\n      const driver = dataSource.driver;\n\n      // Create sync manager and execute\n      const syncManager = new SyncManager(this.config.sourceModel, driver);\n      await syncManager.syncUpdateWithConfig(\n        sourceId,\n        model,\n        changedFields,\n        this.buildSyncConfig(),\n      );\n    } catch (error) {\n      console.error(\n        `[ModelSync] Failed to sync ${this.config.sourceModel.name} -> ${this.config.targetModel.name}:`,\n        error,\n      );\n    }\n  };\n\n  /**\n   * Handle model deleted event.\n   * Triggers unset or remove based on configuration.\n   */\n  private handleModelDeleted = async (model: Model): Promise<void> => {\n    if (!this.config.unsetOnDelete && !this.config.removeOnDelete) {\n      return;\n    }\n\n    try {\n      const primaryKey = (this.config.sourceModel as any).primaryKey || \"id\";\n      const sourceId = model.get(primaryKey) as string | number;\n\n      if (!sourceId) {\n        return;\n      }\n\n      const dataSource = this.config.sourceModel.getDataSource();\n      const driver = dataSource.driver;\n\n      if (this.config.removeOnDelete) {\n        // Delete all target documents that reference this source\n        await this.removeTargetDocuments(sourceId, driver);\n      } else if (this.config.unsetOnDelete) {\n        // Unset the field in target documents\n        const syncManager = new SyncManager(this.config.sourceModel, driver);\n        await syncManager.syncDeleteWithConfig(sourceId, this.buildSyncConfig());\n      }\n    } catch (error) {\n      console.error(\n        `[ModelSync] Failed to handle delete for ${this.config.sourceModel.name}:`,\n        error,\n      );\n    }\n  };\n\n  // ============================================================================\n  // HELPERS\n  // ============================================================================\n\n  /**\n   * Check if sync should proceed based on watched fields.\n   */\n  private shouldSync(changedFields: string[]): boolean {\n    if (this.config.watchFields.length === 0) {\n      return true; // Watch all fields\n    }\n\n    return this.config.watchFields.some((field) => changedFields.includes(field));\n  }\n\n  /**\n   * Build sync config compatible with SyncManager.\n   */\n  private buildSyncConfig(): any {\n    return {\n      targetField: this.config.targetField,\n      isMany: this.config.isMany,\n      embedKey: this.config.embedKey,\n      identifierField: this.config.identifierField,\n      maxSyncDepth: this.config.maxSyncDepth,\n      preventCircularSync: true,\n      watchFields: this.config.watchFields,\n      unsetOnDelete: this.config.unsetOnDelete,\n      targetModelClass: this.config.targetModel,\n    };\n  }\n\n  /**\n   * Remove target documents that reference the deleted source.\n   */\n  private async removeTargetDocuments(sourceId: string | number, driver: any): Promise<void> {\n    const filter = this.config.isMany\n      ? { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId }\n      : { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId };\n\n    await driver.deleteMany(this.config.targetModel.table, filter);\n  }\n\n  /**\n   * Get the current configuration (for debugging/testing).\n   */\n  public getConfig(): Readonly<ModelSyncConfig> {\n    return { ...this.config };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"model-sync-operation.mjs","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync-operation.ts"],"sourcesContent":["/**\n * Model sync operation class.\n *\n * Manages a single sync relationship between a source and target model.\n * Subscribes to source model events and triggers sync operations when\n * the source is updated or deleted.\n *\n * @module cascade-next/sync/model-sync-operation\n */\n\nimport events, { type EventSubscription } from \"@mongez/events\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { getModelDeletedEvent, getModelUpdatedEvent } from \"./model-events\";\nimport { DEFAULT_MAX_SYNC_DEPTH } from \"./sync-context\";\nimport { SyncManager } from \"./sync-manager\";\nimport type { ModelSyncConfig, ModelSyncOperationContract } from \"./types\";\n\n/**\n * Manages a single model sync operation.\n *\n * Subscribes to source model events (updated, deleted) and triggers\n * sync operations to update embedded data in target models.\n *\n * @example\n * ```typescript\n * // Created via modelSync.sync() or Model.sync()\n * const operation = new ModelSyncOperation(Category, Product, \"category\", false);\n * operation\n *   .embed(\"embedMinimal\")\n *   .watchFields([\"name\", \"slug\"])\n *   .unsetOnDelete();\n * ```\n */\nexport class ModelSyncOperation implements ModelSyncOperationContract {\n  /**\n   * Configuration for this sync operation.\n   */\n  private readonly config: ModelSyncConfig;\n\n  /**\n   * Active event subscriptions for cleanup.\n   */\n  private readonly subscriptions: EventSubscription[] = [];\n\n  /**\n   * Whether this operation is currently subscribed to events.\n   */\n  private isSubscribed = false;\n\n  /**\n   * Create a new model sync operation.\n   *\n   * @param sourceModel - Source model class that triggers sync\n   * @param targetModel - Target model class that receives data\n   * @param targetField - Field path in target model\n   * @param isMany - Whether this syncs to an array field\n   */\n  public constructor(\n    sourceModelClass: ChildModel<Model>,\n    targetModelClass: ChildModel<Model>,\n    targetField: string,\n    isMany: boolean,\n  ) {\n    this.config = {\n      sourceModel: sourceModelClass,\n      targetModel: targetModelClass,\n      targetField,\n      isMany,\n      embedKey: \"embedData\",\n      identifierField: \"id\",\n      maxSyncDepth: DEFAULT_MAX_SYNC_DEPTH,\n      watchFields: [],\n      unsetOnDelete: false,\n      removeOnDelete: false,\n    };\n\n    this.subscribe();\n  }\n\n  // ============================================================================\n  // FLUENT CONFIGURATION\n  // ============================================================================\n\n  /**\n   * Set the embed method to call on source model.\n   *\n   * @param embed - getter property name (e.g., \"embedData\", \"embedMinimal\") Or Array of fields\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").embed(\"embedMinimal\");\n   * ```\n   */\n  public embed(method: string | string[]): this {\n    this.config.embedKey = method;\n    return this;\n  }\n\n  /**\n   * Set the identifier field for array matching.\n   * Required when syncing to array fields (syncMany).\n   *\n   * @param field - Field name used as identifier (default: \"id\")\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Tag.syncMany(Post, \"tags\").identifyBy(\"tagId\");\n   * ```\n   */\n  public identifyBy(field: string): this {\n    this.config.identifierField = field;\n    return this;\n  }\n\n  /**\n   * Set the maximum sync depth for chained operations.\n   *\n   * @param depth - Maximum depth (default: 3)\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").maxDepth(2);\n   * ```\n   */\n  public maxDepth(depth: number): this {\n    this.config.maxSyncDepth = depth;\n    return this;\n  }\n\n  /**\n   * Set which fields to watch for changes.\n   * Sync only triggers when these fields change.\n   *\n   * @param fields - Array of field names to watch (empty = all)\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").watchFields([\"name\", \"slug\"]);\n   * ```\n   */\n  public watchFields(fields: string[]): this {\n    this.config.watchFields = fields;\n    return this;\n  }\n\n  /**\n   * Unset the target field when source is deleted.\n   *\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * Category.sync(Product, \"category\").unsetOnDelete();\n   * ```\n   */\n  public unsetOnDelete(): this {\n    this.config.unsetOnDelete = true;\n    return this;\n  }\n\n  /**\n   * Delete target documents when source is deleted.\n   *\n   * @returns This operation for chaining\n   *\n   * @example\n   * ```typescript\n   * User.sync(Profile, \"user\").removeOnDelete();\n   * ```\n   */\n  public removeOnDelete(): this {\n    this.config.removeOnDelete = true;\n    return this;\n  }\n\n  // ============================================================================\n  // LIFECYCLE\n  // ============================================================================\n\n  /**\n   * Subscribe to source model events.\n   * Called automatically in constructor.\n   */\n  private subscribe(): void {\n    if (this.isSubscribed) {\n      return;\n    }\n\n    const sourceModel = this.config.sourceModel;\n\n    // Subscribe to model.updated event\n    this.subscriptions.push(\n      events.subscribe(getModelUpdatedEvent(sourceModel), this.handleModelUpdated),\n    );\n\n    // Subscribe to model.deleted event\n    this.subscriptions.push(\n      events.subscribe(getModelDeletedEvent(sourceModel), this.handleModelDeleted),\n    );\n\n    this.isSubscribed = true;\n  }\n\n  /**\n   * Unsubscribe from all events and cleanup.\n   * Called automatically when using modelSync.register().\n   */\n  public unsubscribe(): void {\n    for (const subscription of this.subscriptions) {\n      subscription.unsubscribe?.();\n    }\n\n    this.subscriptions.length = 0;\n    this.isSubscribed = false;\n  }\n\n  /**\n   * Cleanup the sync operations\n   */\n  public $cleanup() {\n    return this.unsubscribe();\n  }\n\n  // ============================================================================\n  // EVENT HANDLERS\n  // ============================================================================\n\n  /**\n   * Handle model updated event.\n   * Triggers sync to update embedded data in target models.\n   */\n  private handleModelUpdated = async (model: Model, changedFields: string[]): Promise<void> => {\n    // Check if we should sync based on watched fields\n    if (!this.shouldSync(changedFields)) {\n      return;\n    }\n\n    try {\n      const primaryKey = (this.config.sourceModel as any).primaryKey || \"id\";\n      const sourceId = model.get(primaryKey) as string | number;\n\n      if (!sourceId) {\n        return;\n      }\n\n      // Get the driver from the source model's data source\n      const dataSource = this.config.sourceModel.getDataSource();\n      const driver = dataSource.driver;\n\n      // Create sync manager and execute\n      const syncManager = new SyncManager(this.config.sourceModel, driver);\n      await syncManager.syncUpdateWithConfig(\n        sourceId,\n        model,\n        changedFields,\n        this.buildSyncConfig(),\n      );\n    } catch (error) {\n      console.error(\n        `[ModelSync] Failed to sync ${this.config.sourceModel.name} -> ${this.config.targetModel.name}:`,\n        error,\n      );\n    }\n  };\n\n  /**\n   * Handle model deleted event.\n   * Triggers unset or remove based on configuration.\n   */\n  private handleModelDeleted = async (model: Model): Promise<void> => {\n    if (!this.config.unsetOnDelete && !this.config.removeOnDelete) {\n      return;\n    }\n\n    try {\n      const primaryKey = (this.config.sourceModel as any).primaryKey || \"id\";\n      const sourceId = model.get(primaryKey) as string | number;\n\n      if (!sourceId) {\n        return;\n      }\n\n      const dataSource = this.config.sourceModel.getDataSource();\n      const driver = dataSource.driver;\n\n      if (this.config.removeOnDelete) {\n        // Delete all target documents that reference this source\n        await this.removeTargetDocuments(sourceId, driver);\n      } else if (this.config.unsetOnDelete) {\n        // Unset the field in target documents\n        const syncManager = new SyncManager(this.config.sourceModel, driver);\n        await syncManager.syncDeleteWithConfig(sourceId, this.buildSyncConfig());\n      }\n    } catch (error) {\n      console.error(\n        `[ModelSync] Failed to handle delete for ${this.config.sourceModel.name}:`,\n        error,\n      );\n    }\n  };\n\n  // ============================================================================\n  // HELPERS\n  // ============================================================================\n\n  /**\n   * Check if sync should proceed based on watched fields.\n   */\n  private shouldSync(changedFields: string[]): boolean {\n    if (this.config.watchFields.length === 0) {\n      return true; // Watch all fields\n    }\n\n    return this.config.watchFields.some((field) => changedFields.includes(field));\n  }\n\n  /**\n   * Build sync config compatible with SyncManager.\n   */\n  private buildSyncConfig(): any {\n    return {\n      targetField: this.config.targetField,\n      isMany: this.config.isMany,\n      embedKey: this.config.embedKey,\n      identifierField: this.config.identifierField,\n      maxSyncDepth: this.config.maxSyncDepth,\n      preventCircularSync: true,\n      watchFields: this.config.watchFields,\n      unsetOnDelete: this.config.unsetOnDelete,\n      targetModelClass: this.config.targetModel,\n    };\n  }\n\n  /**\n   * Remove target documents that reference the deleted source.\n   */\n  private async removeTargetDocuments(sourceId: string | number, driver: any): Promise<void> {\n    const filter = this.config.isMany\n      ? { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId }\n      : { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId };\n\n    await driver.deleteMany(this.config.targetModel.table, filter);\n  }\n\n  /**\n   * Get the current configuration (for debugging/testing).\n   */\n  public getConfig(): Readonly<ModelSyncConfig> {\n    return { ...this.config };\n  }\n}\n"],"mappings":"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"}

package/esm/sync/model-sync.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model-sync.d.mts","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA6BM,eAAA,YAA2B,iBAAA;EAuC7B;;;EAAA,iBAnCe,UAAA;EAqCf;;;;EAAA,iBA/Be,iBAAA;EAwDf;;;;;;;;;;;;AAkFoB;AA0BxB;;;;AAA8C;;;;;EAxIrC,IAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;EAuBI,QAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;;;;EA0BI,QAAA,CAAS,QAAA;;;;;EA+BT,KAAA;;;;;MAWI,KAAA;;;;UAWH,cAAA;AAAA;;;;;;;;;;;;;;;cA0BG,SAAA,EAAS,eAAwB"}
+{"version":3,"file":"model-sync.d.mts","names":[],"sources":["../../../../../../../cascade/src/sync/model-sync.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA6BM,eAAA,YAA2B,iBAAA;EAuC7B;;;EAAA,iBAnCe,UAAA;EAqCf;;;;EAAA,iBA/Be,iBAAA;EAwDf;;;;;;;;;;;;AAkFoB;AA0BxB;;;;AAA8C;;;;;EAxIrC,IAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;EAuBI,QAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;;;;EA0BI,QAAA,CAAS,QAAA;;;;;EA+BT,KAAA,CAAA;;;;;MAWI,KAAA,CAAA;;;;UAWH,cAAA;AAAA;;;;;;;;;;;;;;;cA0BG,SAAA,EAAS,eAAwB"}

package/esm/sync/sync-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sync-manager.mjs","names":[],"sources":["../../../../../../../cascade/src/sync/sync-manager.ts"],"sourcesContent":["/**\n * Sync manager service for handling multi-level sync operations.\n *\n * @module cascade-next/sync/sync-manager\n */\n\nimport type { DriverContract } from \"../contracts/database-driver.contract\";\nimport { ChildModel, Model } from \"../model/model\";\nimport { DEFAULT_MAX_SYNC_DEPTH, SyncContextManager } from \"./sync-context\";\nimport type {\n  CollectInstructionsPayload,\n  SyncConfig,\n  SyncEventPayload,\n  SyncInstruction,\n  SyncInstructionOptions,\n  SyncResult,\n} from \"./types\";\n\n/**\n * Manages sync operations across models with multi-level support.\n */\nexport class SyncManager {\n  private readonly sourceModel: ChildModel<Model>;\n  private readonly driver: DriverContract;\n\n  /**\n   * Creates a new sync manager.\n   *\n   * @param sourceModel - The source model class\n   * @param driver - The database driver\n   */\n  public constructor(sourceModel: ChildModel<Model>, driver: DriverContract) {\n    this.sourceModel = sourceModel;\n    this.driver = driver;\n  }\n\n  /**\n   * Executes sync operations for a model update.\n   *\n   * @param sourceId - The source model ID\n   * @param updatedData - The updated data to sync (Model instance or plain data)\n   * @param changedFields - Fields that were changed (for filtering)\n   * @returns Sync result with success status and details\n   */\n  public async syncUpdate(\n    sourceId: string | number,\n    updatedData: Record<string, unknown> | Model,\n    changedFields: string[],\n  ): Promise<SyncResult> {\n    try {\n      const syncConfigs = this.getSyncConfigs();\n\n      if (syncConfigs.length === 0) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: DEFAULT_MAX_SYNC_DEPTH,\n        preventCircular: true,\n      };\n\n      const instructions = await this.collectInstructions({\n        sourceId,\n        updatedData,\n        changedFields,\n        syncConfigs,\n        options,\n      });\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      // Catch-all error handler for unexpected failures\n      console.error(`Sync update failed for ${this.sourceModel.name}#${sourceId}:`, error);\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync operations for a model update with a specific config.\n   * Used by ModelSyncOperation for event-based sync.\n   *\n   * @param sourceId - The source model ID\n   * @param updatedData - The updated data to sync\n   * @param changedFields - Fields that were changed\n   * @param config - The sync configuration to use\n   * @returns Sync result with success status and details\n   */\n  public async syncUpdateWithConfig(\n    sourceId: string | number,\n    updatedData: Record<string, unknown> | Model,\n    changedFields: string[],\n    config: SyncConfig,\n  ): Promise<SyncResult> {\n    try {\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: config.maxSyncDepth,\n        preventCircular: config.preventCircularSync,\n      };\n\n      const instructions = await this.collectInstructions({\n        sourceId,\n        updatedData,\n        changedFields,\n        syncConfigs: [config],\n        options,\n      });\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      console.error(\n        `Sync update with config failed for ${this.sourceModel.name}#${sourceId}:`,\n        error,\n      );\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync delete operations with a specific config.\n   * Used by ModelSyncOperation for event-based sync.\n   *\n   * @param sourceId - The source model ID\n   * @param config - The sync configuration to use\n   * @returns Sync result with success status and details\n   */\n  public async syncDeleteWithConfig(\n    sourceId: string | number,\n    config: SyncConfig,\n  ): Promise<SyncResult> {\n    try {\n      if (!config.unsetOnDelete) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: config.maxSyncDepth,\n        preventCircular: config.preventCircularSync,\n      };\n\n      const instructions = await this.collectDeleteInstructions(sourceId, [config], options);\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      console.error(\n        `Sync delete with config failed for ${this.sourceModel.name}#${sourceId}:`,\n        error,\n      );\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync operations for a model deletion.\n   *\n   * @param sourceId - The source model ID\n   * @returns Sync result with success status and details\n   */\n  public async syncDelete(sourceId: string | number): Promise<SyncResult> {\n    try {\n      const syncConfigs = this.getSyncConfigs();\n\n      if (syncConfigs.length === 0) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: DEFAULT_MAX_SYNC_DEPTH,\n        preventCircular: true,\n      };\n\n      const instructions = await this.collectDeleteInstructions(sourceId, syncConfigs, options);\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      // Catch-all error handler for unexpected failures\n      console.error(`Sync delete failed for ${this.sourceModel.name}#${sourceId}:`, error);\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Collects sync instructions recursively with depth limiting.\n   *\n   * @param payload - Data payload\n   * @returns Array of sync instructions\n   */\n  private async collectInstructions(\n    payload: CollectInstructionsPayload,\n  ): Promise<SyncInstruction[]> {\n    const { sourceId, updatedData, changedFields, syncConfigs, options } = payload;\n    const instructions: SyncInstruction[] = [];\n\n    for (const config of syncConfigs) {\n      // Check if we should sync based on watched fields\n      if (!this.shouldSync(config, changedFields)) {\n        continue;\n      }\n\n      // Validate depth and circular references\n      const validation = SyncContextManager.validate(\n        options.currentDepth,\n        options.syncChain,\n        config.targetModelClass.name,\n        config.maxSyncDepth,\n        config.preventCircularSync,\n      );\n\n      if (!validation.valid) {\n        console.warn(`Sync validation failed: ${validation.error}`);\n        continue;\n      }\n\n      // Get embedded data (handle both Model instance and plain data)\n      const embedData = await this.getEmbedData(updatedData, config);\n\n      // Build instruction\n      const instruction = this.buildUpdateInstruction(sourceId, config, embedData, options);\n\n      instructions.push(instruction);\n\n      // Emit syncing event\n      await this.emitSyncingEvent(instruction);\n\n      // Recursively collect instructions for next level\n      if (SyncContextManager.canSyncDeeper(options.currentDepth, config.maxSyncDepth)) {\n        const nextLevelInstructions = await this.collectNextLevelInstructions(\n          instruction,\n          embedData,\n          changedFields,\n          config,\n          options,\n        );\n        instructions.push(...nextLevelInstructions);\n      }\n    }\n\n    return instructions;\n  }\n\n  /**\n   * Collects delete sync instructions.\n   *\n   * @param sourceId - Source model ID\n   * @param syncConfigs - Sync configurations\n   * @param options - Instruction options\n   * @returns Array of sync instructions\n   */\n  private async collectDeleteInstructions(\n    sourceId: string | number,\n    syncConfigs: SyncConfig[],\n    options: SyncInstructionOptions,\n  ): Promise<SyncInstruction[]> {\n    const instructions: SyncInstruction[] = [];\n\n    for (const config of syncConfigs) {\n      if (!config.unsetOnDelete) {\n        continue;\n      }\n\n      const validation = SyncContextManager.validate(\n        options.currentDepth,\n        options.syncChain,\n        config.targetModelClass.name,\n        config.maxSyncDepth,\n        config.preventCircularSync,\n      );\n\n      if (!validation.valid) {\n        continue;\n      }\n\n      const instruction = this.buildDeleteInstruction(sourceId, config, options);\n      instructions.push(instruction);\n\n      await this.emitSyncingEvent(instruction);\n    }\n\n    return instructions;\n  }\n\n  /**\n   * Collects instructions for the next level in the sync chain.\n   *\n   * @param parentInstruction - The parent instruction\n   * @param embedData - Embedded data from parent\n   * @param changedFields - Changed fields\n   * @param parentConfig - Parent sync config\n   * @param parentOptions - Parent instruction options\n   * @returns Array of next-level sync instructions\n   */\n  private async collectNextLevelInstructions(\n    parentInstruction: SyncInstruction,\n    embedData: Record<string, unknown>,\n    changedFields: string[],\n    parentConfig: SyncConfig,\n    parentOptions: SyncInstructionOptions,\n  ): Promise<SyncInstruction[]> {\n    const targetModelClass = parentConfig.targetModelClass;\n    const targetSyncConfigs = this.getSyncConfigsForModel(targetModelClass);\n\n    if (targetSyncConfigs.length === 0) {\n      return [];\n    }\n\n    const nextOptions: SyncInstructionOptions = {\n      currentDepth: parentOptions.currentDepth + 1,\n      syncChain: SyncContextManager.extendChain(parentOptions.syncChain, targetModelClass.name),\n      maxDepth: Math.min(parentConfig.maxSyncDepth, parentOptions.maxDepth),\n      preventCircular: parentOptions.preventCircular && parentConfig.preventCircularSync,\n    };\n\n    // Get the ID from embed data for next level\n    const sourceId = embedData[parentConfig.identifierField] as string | number;\n\n    return await this.collectInstructions({\n      sourceId,\n      updatedData: embedData,\n      changedFields,\n      syncConfigs: targetSyncConfigs,\n      options: nextOptions,\n    });\n  }\n\n  /**\n   * Builds an update sync instruction.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @param embedData - Embedded data to sync\n   * @param options - Instruction options\n   * @returns Sync instruction\n   */\n  private buildUpdateInstruction(\n    sourceId: string | number,\n    config: SyncConfig,\n    embedData: Record<string, unknown>,\n    options: SyncInstructionOptions,\n  ): SyncInstruction {\n    const targetModelClass = config.targetModelClass;\n    const filter = this.buildFilter(sourceId, config);\n    const update = this.buildUpdate(embedData, config);\n\n    const instruction: SyncInstruction = {\n      targetTable: targetModelClass.table,\n      targetModel: targetModelClass.name,\n      filter,\n      update,\n      depth: options.currentDepth,\n      chain: [...options.syncChain],\n      sourceModel: this.sourceModel.name,\n      sourceId,\n    };\n\n    // Add array update metadata if needed\n    if (config.isMany) {\n      instruction.isArrayUpdate = true;\n      instruction.arrayField = config.targetField;\n      instruction.identifierField = config.identifierField;\n      instruction.identifierValue = sourceId;\n    }\n\n    return instruction;\n  }\n\n  /**\n   * Builds a delete sync instruction.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @param options - Instruction options\n   * @returns Sync instruction\n   */\n  private buildDeleteInstruction(\n    sourceId: string | number,\n    config: SyncConfig,\n    options: SyncInstructionOptions,\n  ): SyncInstruction {\n    const targetModelClass = config.targetModelClass;\n    const filter = this.buildFilter(sourceId, config);\n    const update = { $unset: { [config.targetField]: 1 } };\n\n    return {\n      targetTable: targetModelClass.table,\n      targetModel: targetModelClass.name,\n      filter,\n      update,\n      depth: options.currentDepth,\n      chain: [...options.syncChain],\n      sourceModel: this.sourceModel.name,\n      sourceId,\n    };\n  }\n\n  /**\n   * Builds a filter for identifying target documents.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @returns Filter object\n   */\n  private buildFilter(sourceId: string | number, config: SyncConfig): Record<string, unknown> {\n    if (config.isMany) {\n      // For arrays: { \"products.id\": productId }\n      return { [`${config.targetField}.${config.identifierField}`]: sourceId };\n    } else {\n      // For single: { \"category.id\": categoryId }\n      return { [`${config.targetField}.${config.identifierField}`]: sourceId };\n    }\n  }\n\n  /**\n   * Builds an update operation for syncing data.\n   *\n   * @param embedData - Embedded data to sync\n   * @param config - Sync configuration\n   * @returns Update operation object\n   */\n  private buildUpdate(\n    embedData: Record<string, unknown>,\n    config: SyncConfig,\n  ): Record<string, unknown> {\n    if (config.isMany) {\n      // For arrays: use positional operator $\n      return { $set: { [`${config.targetField}.$`]: embedData } };\n    } else {\n      // For single: direct set\n      return { $set: { [config.targetField]: embedData } };\n    }\n  }\n\n  /**\n   * Executes sync instructions with batch optimization.\n   * Groups by depth and target table for optimal batching.\n   *\n   * @param instructions - Array of sync instructions\n   * @returns Sync result\n   */\n  private async executeInstructions(instructions: SyncInstruction[]): Promise<SyncResult> {\n    const result: SyncResult = {\n      success: true,\n      attempted: instructions.length,\n      succeeded: 0,\n      failed: 0,\n      errors: [],\n      depthReached: 0,\n      contexts: [],\n    };\n\n    if (instructions.length === 0) {\n      return result;\n    }\n\n    // Group instructions by depth for sequential execution\n    const instructionsByDepth = this.groupByDepth(instructions);\n\n    for (const [depth, depthInstructions] of instructionsByDepth) {\n      result.depthReached = Math.max(result.depthReached, depth);\n\n      // Further group by target table for better batching\n      const instructionsByTable = this.groupByTable(depthInstructions);\n\n      for (const [table, tableInstructions] of instructionsByTable) {\n        try {\n          // Try batch execution first (all instructions for this table)\n          await this.executeBatch(tableInstructions, result);\n        } catch (batchError) {\n          // Fallback to individual execution on batch failure\n          console.warn(\n            `Batch execution failed for table ${table} at depth ${depth}, falling back to individual execution`,\n          );\n          await this.executeIndividual(tableInstructions, result);\n        }\n      }\n    }\n\n    result.success = result.failed === 0;\n    return result;\n  }\n\n  /**\n   * Executes instructions in batch.\n   *\n   * @param instructions - Instructions to execute\n   * @param result - Result object to update\n   */\n  private async executeBatch(instructions: SyncInstruction[], result: SyncResult): Promise<void> {\n    for (const instruction of instructions) {\n      try {\n        const updateResult = await this.driver.updateMany(\n          instruction.targetTable,\n          instruction.filter,\n          instruction.update,\n        );\n\n        const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);\n        result.contexts.push(context);\n        result.succeeded++;\n\n        await this.emitSyncedEvent(context);\n      } catch (error) {\n        throw error; // Re-throw for batch fallback\n      }\n    }\n  }\n\n  /**\n   * Executes instructions individually (fallback).\n   * Provides detailed error reporting for each failed instruction.\n   *\n   * @param instructions - Instructions to execute\n   * @param result - Result object to update\n   */\n  private async executeIndividual(\n    instructions: SyncInstruction[],\n    result: SyncResult,\n  ): Promise<void> {\n    for (const instruction of instructions) {\n      try {\n        const updateResult = await this.driver.updateMany(\n          instruction.targetTable,\n          instruction.filter,\n          instruction.update,\n        );\n\n        const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);\n        result.contexts.push(context);\n        result.succeeded++;\n\n        await this.emitSyncedEvent(context);\n      } catch (error) {\n        result.failed++;\n\n        const errorMessage = this.formatSyncError(instruction, error);\n        const syncError = new Error(errorMessage);\n\n        // Preserve original error stack if available\n        if (error instanceof Error && error.stack) {\n          syncError.stack = error.stack;\n        }\n\n        result.errors.push({\n          instruction,\n          error: syncError,\n        });\n\n        // Log detailed error for debugging\n        console.error(`Sync operation failed:`, {\n          sourceModel: instruction.sourceModel,\n          sourceId: instruction.sourceId,\n          targetModel: instruction.targetModel,\n          targetTable: instruction.targetTable,\n          depth: instruction.depth,\n          chain: SyncContextManager.formatChain(instruction.chain),\n          filter: instruction.filter,\n          error: errorMessage,\n        });\n      }\n    }\n  }\n\n  /**\n   * Formats a sync error with detailed context.\n   *\n   * @param instruction - The failed instruction\n   * @param error - The error that occurred\n   * @returns Formatted error message\n   */\n  private formatSyncError(instruction: SyncInstruction, error: unknown): string {\n    const baseMessage = error instanceof Error ? error.message : String(error);\n    const chain = SyncContextManager.formatChain(instruction.chain);\n\n    return [\n      `Sync failed at depth ${instruction.depth}:`,\n      `Chain: ${chain} → ${instruction.targetModel}`,\n      `Source: ${instruction.sourceModel}#${instruction.sourceId}`,\n      `Target: ${instruction.targetTable}`,\n      `Error: ${baseMessage}`,\n    ].join(\" | \");\n  }\n\n  /**\n   * Groups instructions by depth for batch processing.\n   *\n   * @param instructions - Instructions to group\n   * @returns Map of depth to instructions (sorted ascending)\n   */\n  private groupByDepth(instructions: SyncInstruction[]): Map<number, SyncInstruction[]> {\n    const grouped = new Map<number, SyncInstruction[]>();\n\n    for (const instruction of instructions) {\n      const depth = instruction.depth;\n      if (!grouped.has(depth)) {\n        grouped.set(depth, []);\n      }\n      grouped.get(depth)!.push(instruction);\n    }\n\n    // Sort by depth (ascending) for sequential execution\n    return new Map([...grouped.entries()].sort((a, b) => a[0] - b[0]));\n  }\n\n  /**\n   * Groups instructions by target table for batch optimization.\n   *\n   * @param instructions - Instructions to group\n   * @returns Map of table name to instructions\n   */\n  private groupByTable(instructions: SyncInstruction[]): Map<string, SyncInstruction[]> {\n    const grouped = new Map<string, SyncInstruction[]>();\n\n    for (const instruction of instructions) {\n      const table = instruction.targetTable;\n      if (!grouped.has(table)) {\n        grouped.set(table, []);\n      }\n      grouped.get(table)!.push(instruction);\n    }\n\n    return grouped;\n  }\n\n  /**\n   * Checks if sync should proceed based on watched fields.\n   *\n   * @param config - Sync configuration\n   * @param changedFields - Fields that changed\n   * @returns True if sync should proceed\n   */\n  private shouldSync(config: SyncConfig, changedFields: string[]): boolean {\n    if (config.watchFields.length === 0) {\n      return true; // Watch all fields\n    }\n\n    return config.watchFields.some((field) => changedFields.includes(field));\n  }\n\n  /**\n   * Gets embedded data from the source model.\n   *\n   * @param data - Source model data or Model instance\n   * @param config - Sync configuration\n   * @returns Embedded data\n   */\n  private async getEmbedData(\n    data: Record<string, unknown> | Model,\n    config: SyncConfig,\n  ): Promise<Record<string, unknown>> {\n    // If data is a Model instance, call the embed method on it\n    if (data instanceof Model) {\n      if (Array.isArray(config.embedKey)) {\n        return data.only(config.embedKey);\n      }\n\n      if (typeof data[config.embedKey as keyof Model] !== \"function\") {\n        return data[config.embedKey as keyof Model] as Record<string, unknown>;\n      }\n      // Fallback: use embedData() if available\n      if (typeof data.embedData === \"function\") {\n        return data.embedData;\n      }\n      // Last resort: return model data\n      return data.data;\n    }\n\n    // Otherwise, return the data as-is\n    return data as Record<string, unknown>;\n  }\n\n  /**\n   * Gets sync configurations from the source model.\n   *\n   * @returns Array of sync configurations\n   */\n  private getSyncConfigs(): SyncConfig[] {\n    const syncWith = (this.sourceModel as any).syncWith;\n\n    if (!syncWith || !Array.isArray(syncWith)) {\n      return [];\n    }\n\n    return syncWith.map((builder: any) =>\n      typeof builder.build === \"function\" ? builder.build() : builder,\n    );\n  }\n\n  /**\n   * Gets sync configurations for a specific model.\n   *\n   * @param modelClass - The model class\n   * @returns Array of sync configurations\n   */\n  private getSyncConfigsForModel(modelClass: ChildModel<Model>): SyncConfig[] {\n    const syncWith = (modelClass as any).syncWith;\n\n    if (!syncWith || !Array.isArray(syncWith)) {\n      return [];\n    }\n\n    return syncWith.map((builder: any) =>\n      typeof builder.build === \"function\" ? builder.build() : builder,\n    );\n  }\n\n  /**\n   * Emits a syncing event.\n   *\n   * @param instruction - The sync instruction\n   */\n  private async emitSyncingEvent(instruction: SyncInstruction): Promise<void> {\n    const payload: SyncEventPayload = {\n      sourceModel: instruction.sourceModel,\n      sourceId: instruction.sourceId,\n      targetModel: instruction.targetModel,\n      filter: instruction.filter,\n      update: instruction.update,\n      affectedCount: 0, // Not yet known\n      depth: instruction.depth,\n      chain: instruction.chain,\n    };\n\n    // Emit on source model\n    if (typeof (this.sourceModel as any).emitSyncEvent === \"function\") {\n      await (this.sourceModel as any).emitSyncEvent(\"syncing\", payload);\n    }\n  }\n\n  /**\n   * Emits a synced event.\n   *\n   * @param context - The sync context\n   */\n  private async emitSyncedEvent(context: any): Promise<void> {\n    const payload: SyncEventPayload = {\n      sourceModel: context.sourceModel,\n      sourceId: context.sourceId,\n      targetModel: context.targetModel,\n      filter: context.filter,\n      update: context.update,\n      affectedCount: context.affectedCount,\n      depth: context.currentDepth,\n      chain: context.syncChain,\n    };\n\n    // Emit on source model\n    if (typeof (this.sourceModel as any).emitSyncEvent === \"function\") {\n      await (this.sourceModel as any).emitSyncEvent(\"synced\", payload);\n    }\n  }\n\n  /**\n   * Creates an empty sync result.\n   *\n   * @returns Empty sync result\n   */\n  private createEmptyResult(): SyncResult {\n    return {\n      success: true,\n      attempted: 0,\n      succeeded: 0,\n      failed: 0,\n      errors: [],\n      depthReached: 0,\n      contexts: [],\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sync-manager.mjs","names":[],"sources":["../../../../../../../cascade/src/sync/sync-manager.ts"],"sourcesContent":["/**\n * Sync manager service for handling multi-level sync operations.\n *\n * @module cascade-next/sync/sync-manager\n */\n\nimport type { DriverContract } from \"../contracts/database-driver.contract\";\nimport { type ChildModel, Model } from \"../model/model\";\nimport { DEFAULT_MAX_SYNC_DEPTH, SyncContextManager } from \"./sync-context\";\nimport type {\n  CollectInstructionsPayload,\n  SyncConfig,\n  SyncEventPayload,\n  SyncInstruction,\n  SyncInstructionOptions,\n  SyncResult,\n} from \"./types\";\n\n/**\n * Manages sync operations across models with multi-level support.\n */\nexport class SyncManager {\n  private readonly sourceModel: ChildModel<Model>;\n  private readonly driver: DriverContract;\n\n  /**\n   * Creates a new sync manager.\n   *\n   * @param sourceModel - The source model class\n   * @param driver - The database driver\n   */\n  public constructor(sourceModel: ChildModel<Model>, driver: DriverContract) {\n    this.sourceModel = sourceModel;\n    this.driver = driver;\n  }\n\n  /**\n   * Executes sync operations for a model update.\n   *\n   * @param sourceId - The source model ID\n   * @param updatedData - The updated data to sync (Model instance or plain data)\n   * @param changedFields - Fields that were changed (for filtering)\n   * @returns Sync result with success status and details\n   */\n  public async syncUpdate(\n    sourceId: string | number,\n    updatedData: Record<string, unknown> | Model,\n    changedFields: string[],\n  ): Promise<SyncResult> {\n    try {\n      const syncConfigs = this.getSyncConfigs();\n\n      if (syncConfigs.length === 0) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: DEFAULT_MAX_SYNC_DEPTH,\n        preventCircular: true,\n      };\n\n      const instructions = await this.collectInstructions({\n        sourceId,\n        updatedData,\n        changedFields,\n        syncConfigs,\n        options,\n      });\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      // Catch-all error handler for unexpected failures\n      console.error(`Sync update failed for ${this.sourceModel.name}#${sourceId}:`, error);\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync operations for a model update with a specific config.\n   * Used by ModelSyncOperation for event-based sync.\n   *\n   * @param sourceId - The source model ID\n   * @param updatedData - The updated data to sync\n   * @param changedFields - Fields that were changed\n   * @param config - The sync configuration to use\n   * @returns Sync result with success status and details\n   */\n  public async syncUpdateWithConfig(\n    sourceId: string | number,\n    updatedData: Record<string, unknown> | Model,\n    changedFields: string[],\n    config: SyncConfig,\n  ): Promise<SyncResult> {\n    try {\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: config.maxSyncDepth,\n        preventCircular: config.preventCircularSync,\n      };\n\n      const instructions = await this.collectInstructions({\n        sourceId,\n        updatedData,\n        changedFields,\n        syncConfigs: [config],\n        options,\n      });\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      console.error(\n        `Sync update with config failed for ${this.sourceModel.name}#${sourceId}:`,\n        error,\n      );\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync delete operations with a specific config.\n   * Used by ModelSyncOperation for event-based sync.\n   *\n   * @param sourceId - The source model ID\n   * @param config - The sync configuration to use\n   * @returns Sync result with success status and details\n   */\n  public async syncDeleteWithConfig(\n    sourceId: string | number,\n    config: SyncConfig,\n  ): Promise<SyncResult> {\n    try {\n      if (!config.unsetOnDelete) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: config.maxSyncDepth,\n        preventCircular: config.preventCircularSync,\n      };\n\n      const instructions = await this.collectDeleteInstructions(sourceId, [config], options);\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      console.error(\n        `Sync delete with config failed for ${this.sourceModel.name}#${sourceId}:`,\n        error,\n      );\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Executes sync operations for a model deletion.\n   *\n   * @param sourceId - The source model ID\n   * @returns Sync result with success status and details\n   */\n  public async syncDelete(sourceId: string | number): Promise<SyncResult> {\n    try {\n      const syncConfigs = this.getSyncConfigs();\n\n      if (syncConfigs.length === 0) {\n        return this.createEmptyResult();\n      }\n\n      const options: SyncInstructionOptions = {\n        currentDepth: 1,\n        syncChain: [this.sourceModel.name],\n        maxDepth: DEFAULT_MAX_SYNC_DEPTH,\n        preventCircular: true,\n      };\n\n      const instructions = await this.collectDeleteInstructions(sourceId, syncConfigs, options);\n\n      return await this.executeInstructions(instructions);\n    } catch (error) {\n      // Catch-all error handler for unexpected failures\n      console.error(`Sync delete failed for ${this.sourceModel.name}#${sourceId}:`, error);\n\n      return {\n        success: false,\n        attempted: 0,\n        succeeded: 0,\n        failed: 1,\n        errors: [\n          {\n            instruction: {\n              targetTable: \"\",\n              targetModel: \"\",\n              filter: {},\n              update: {},\n              depth: 0,\n              chain: [this.sourceModel.name],\n              sourceModel: this.sourceModel.name,\n              sourceId,\n            },\n            error: error instanceof Error ? error : new Error(String(error)),\n          },\n        ],\n        depthReached: 0,\n        contexts: [],\n      };\n    }\n  }\n\n  /**\n   * Collects sync instructions recursively with depth limiting.\n   *\n   * @param payload - Data payload\n   * @returns Array of sync instructions\n   */\n  private async collectInstructions(\n    payload: CollectInstructionsPayload,\n  ): Promise<SyncInstruction[]> {\n    const { sourceId, updatedData, changedFields, syncConfigs, options } = payload;\n    const instructions: SyncInstruction[] = [];\n\n    for (const config of syncConfigs) {\n      // Check if we should sync based on watched fields\n      if (!this.shouldSync(config, changedFields)) {\n        continue;\n      }\n\n      // Validate depth and circular references\n      const validation = SyncContextManager.validate(\n        options.currentDepth,\n        options.syncChain,\n        config.targetModelClass.name,\n        config.maxSyncDepth,\n        config.preventCircularSync,\n      );\n\n      if (!validation.valid) {\n        console.warn(`Sync validation failed: ${validation.error}`);\n        continue;\n      }\n\n      // Get embedded data (handle both Model instance and plain data)\n      const embedData = await this.getEmbedData(updatedData, config);\n\n      // Build instruction\n      const instruction = this.buildUpdateInstruction(sourceId, config, embedData, options);\n\n      instructions.push(instruction);\n\n      // Emit syncing event\n      await this.emitSyncingEvent(instruction);\n\n      // Recursively collect instructions for next level\n      if (SyncContextManager.canSyncDeeper(options.currentDepth, config.maxSyncDepth)) {\n        const nextLevelInstructions = await this.collectNextLevelInstructions(\n          instruction,\n          embedData,\n          changedFields,\n          config,\n          options,\n        );\n        instructions.push(...nextLevelInstructions);\n      }\n    }\n\n    return instructions;\n  }\n\n  /**\n   * Collects delete sync instructions.\n   *\n   * @param sourceId - Source model ID\n   * @param syncConfigs - Sync configurations\n   * @param options - Instruction options\n   * @returns Array of sync instructions\n   */\n  private async collectDeleteInstructions(\n    sourceId: string | number,\n    syncConfigs: SyncConfig[],\n    options: SyncInstructionOptions,\n  ): Promise<SyncInstruction[]> {\n    const instructions: SyncInstruction[] = [];\n\n    for (const config of syncConfigs) {\n      if (!config.unsetOnDelete) {\n        continue;\n      }\n\n      const validation = SyncContextManager.validate(\n        options.currentDepth,\n        options.syncChain,\n        config.targetModelClass.name,\n        config.maxSyncDepth,\n        config.preventCircularSync,\n      );\n\n      if (!validation.valid) {\n        continue;\n      }\n\n      const instruction = this.buildDeleteInstruction(sourceId, config, options);\n      instructions.push(instruction);\n\n      await this.emitSyncingEvent(instruction);\n    }\n\n    return instructions;\n  }\n\n  /**\n   * Collects instructions for the next level in the sync chain.\n   *\n   * @param parentInstruction - The parent instruction\n   * @param embedData - Embedded data from parent\n   * @param changedFields - Changed fields\n   * @param parentConfig - Parent sync config\n   * @param parentOptions - Parent instruction options\n   * @returns Array of next-level sync instructions\n   */\n  private async collectNextLevelInstructions(\n    parentInstruction: SyncInstruction,\n    embedData: Record<string, unknown>,\n    changedFields: string[],\n    parentConfig: SyncConfig,\n    parentOptions: SyncInstructionOptions,\n  ): Promise<SyncInstruction[]> {\n    const targetModelClass = parentConfig.targetModelClass;\n    const targetSyncConfigs = this.getSyncConfigsForModel(targetModelClass);\n\n    if (targetSyncConfigs.length === 0) {\n      return [];\n    }\n\n    const nextOptions: SyncInstructionOptions = {\n      currentDepth: parentOptions.currentDepth + 1,\n      syncChain: SyncContextManager.extendChain(parentOptions.syncChain, targetModelClass.name),\n      maxDepth: Math.min(parentConfig.maxSyncDepth, parentOptions.maxDepth),\n      preventCircular: parentOptions.preventCircular && parentConfig.preventCircularSync,\n    };\n\n    // Get the ID from embed data for next level\n    const sourceId = embedData[parentConfig.identifierField] as string | number;\n\n    return await this.collectInstructions({\n      sourceId,\n      updatedData: embedData,\n      changedFields,\n      syncConfigs: targetSyncConfigs,\n      options: nextOptions,\n    });\n  }\n\n  /**\n   * Builds an update sync instruction.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @param embedData - Embedded data to sync\n   * @param options - Instruction options\n   * @returns Sync instruction\n   */\n  private buildUpdateInstruction(\n    sourceId: string | number,\n    config: SyncConfig,\n    embedData: Record<string, unknown>,\n    options: SyncInstructionOptions,\n  ): SyncInstruction {\n    const targetModelClass = config.targetModelClass;\n    const filter = this.buildFilter(sourceId, config);\n    const update = this.buildUpdate(embedData, config);\n\n    const instruction: SyncInstruction = {\n      targetTable: targetModelClass.table,\n      targetModel: targetModelClass.name,\n      filter,\n      update,\n      depth: options.currentDepth,\n      chain: [...options.syncChain],\n      sourceModel: this.sourceModel.name,\n      sourceId,\n    };\n\n    // Add array update metadata if needed\n    if (config.isMany) {\n      instruction.isArrayUpdate = true;\n      instruction.arrayField = config.targetField;\n      instruction.identifierField = config.identifierField;\n      instruction.identifierValue = sourceId;\n    }\n\n    return instruction;\n  }\n\n  /**\n   * Builds a delete sync instruction.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @param options - Instruction options\n   * @returns Sync instruction\n   */\n  private buildDeleteInstruction(\n    sourceId: string | number,\n    config: SyncConfig,\n    options: SyncInstructionOptions,\n  ): SyncInstruction {\n    const targetModelClass = config.targetModelClass;\n    const filter = this.buildFilter(sourceId, config);\n    const update = { $unset: { [config.targetField]: 1 } };\n\n    return {\n      targetTable: targetModelClass.table,\n      targetModel: targetModelClass.name,\n      filter,\n      update,\n      depth: options.currentDepth,\n      chain: [...options.syncChain],\n      sourceModel: this.sourceModel.name,\n      sourceId,\n    };\n  }\n\n  /**\n   * Builds a filter for identifying target documents.\n   *\n   * @param sourceId - Source model ID\n   * @param config - Sync configuration\n   * @returns Filter object\n   */\n  private buildFilter(sourceId: string | number, config: SyncConfig): Record<string, unknown> {\n    if (config.isMany) {\n      // For arrays: { \"products.id\": productId }\n      return { [`${config.targetField}.${config.identifierField}`]: sourceId };\n    } else {\n      // For single: { \"category.id\": categoryId }\n      return { [`${config.targetField}.${config.identifierField}`]: sourceId };\n    }\n  }\n\n  /**\n   * Builds an update operation for syncing data.\n   *\n   * @param embedData - Embedded data to sync\n   * @param config - Sync configuration\n   * @returns Update operation object\n   */\n  private buildUpdate(\n    embedData: Record<string, unknown>,\n    config: SyncConfig,\n  ): Record<string, unknown> {\n    if (config.isMany) {\n      // For arrays: use positional operator $\n      return { $set: { [`${config.targetField}.$`]: embedData } };\n    } else {\n      // For single: direct set\n      return { $set: { [config.targetField]: embedData } };\n    }\n  }\n\n  /**\n   * Executes sync instructions with batch optimization.\n   * Groups by depth and target table for optimal batching.\n   *\n   * @param instructions - Array of sync instructions\n   * @returns Sync result\n   */\n  private async executeInstructions(instructions: SyncInstruction[]): Promise<SyncResult> {\n    const result: SyncResult = {\n      success: true,\n      attempted: instructions.length,\n      succeeded: 0,\n      failed: 0,\n      errors: [],\n      depthReached: 0,\n      contexts: [],\n    };\n\n    if (instructions.length === 0) {\n      return result;\n    }\n\n    // Group instructions by depth for sequential execution\n    const instructionsByDepth = this.groupByDepth(instructions);\n\n    for (const [depth, depthInstructions] of instructionsByDepth) {\n      result.depthReached = Math.max(result.depthReached, depth);\n\n      // Further group by target table for better batching\n      const instructionsByTable = this.groupByTable(depthInstructions);\n\n      for (const [table, tableInstructions] of instructionsByTable) {\n        try {\n          // Try batch execution first (all instructions for this table)\n          await this.executeBatch(tableInstructions, result);\n        } catch (batchError) {\n          // Fallback to individual execution on batch failure\n          console.warn(\n            `Batch execution failed for table ${table} at depth ${depth}, falling back to individual execution`,\n          );\n          await this.executeIndividual(tableInstructions, result);\n        }\n      }\n    }\n\n    result.success = result.failed === 0;\n    return result;\n  }\n\n  /**\n   * Executes instructions in batch.\n   *\n   * @param instructions - Instructions to execute\n   * @param result - Result object to update\n   */\n  private async executeBatch(instructions: SyncInstruction[], result: SyncResult): Promise<void> {\n    for (const instruction of instructions) {\n      try {\n        const updateResult = await this.driver.updateMany(\n          instruction.targetTable,\n          instruction.filter,\n          instruction.update,\n        );\n\n        const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);\n        result.contexts.push(context);\n        result.succeeded++;\n\n        await this.emitSyncedEvent(context);\n      } catch (error) {\n        throw error; // Re-throw for batch fallback\n      }\n    }\n  }\n\n  /**\n   * Executes instructions individually (fallback).\n   * Provides detailed error reporting for each failed instruction.\n   *\n   * @param instructions - Instructions to execute\n   * @param result - Result object to update\n   */\n  private async executeIndividual(\n    instructions: SyncInstruction[],\n    result: SyncResult,\n  ): Promise<void> {\n    for (const instruction of instructions) {\n      try {\n        const updateResult = await this.driver.updateMany(\n          instruction.targetTable,\n          instruction.filter,\n          instruction.update,\n        );\n\n        const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);\n        result.contexts.push(context);\n        result.succeeded++;\n\n        await this.emitSyncedEvent(context);\n      } catch (error) {\n        result.failed++;\n\n        const errorMessage = this.formatSyncError(instruction, error);\n        const syncError = new Error(errorMessage);\n\n        // Preserve original error stack if available\n        if (error instanceof Error && error.stack) {\n          syncError.stack = error.stack;\n        }\n\n        result.errors.push({\n          instruction,\n          error: syncError,\n        });\n\n        // Log detailed error for debugging\n        console.error(`Sync operation failed:`, {\n          sourceModel: instruction.sourceModel,\n          sourceId: instruction.sourceId,\n          targetModel: instruction.targetModel,\n          targetTable: instruction.targetTable,\n          depth: instruction.depth,\n          chain: SyncContextManager.formatChain(instruction.chain),\n          filter: instruction.filter,\n          error: errorMessage,\n        });\n      }\n    }\n  }\n\n  /**\n   * Formats a sync error with detailed context.\n   *\n   * @param instruction - The failed instruction\n   * @param error - The error that occurred\n   * @returns Formatted error message\n   */\n  private formatSyncError(instruction: SyncInstruction, error: unknown): string {\n    const baseMessage = error instanceof Error ? error.message : String(error);\n    const chain = SyncContextManager.formatChain(instruction.chain);\n\n    return [\n      `Sync failed at depth ${instruction.depth}:`,\n      `Chain: ${chain} → ${instruction.targetModel}`,\n      `Source: ${instruction.sourceModel}#${instruction.sourceId}`,\n      `Target: ${instruction.targetTable}`,\n      `Error: ${baseMessage}`,\n    ].join(\" | \");\n  }\n\n  /**\n   * Groups instructions by depth for batch processing.\n   *\n   * @param instructions - Instructions to group\n   * @returns Map of depth to instructions (sorted ascending)\n   */\n  private groupByDepth(instructions: SyncInstruction[]): Map<number, SyncInstruction[]> {\n    const grouped = new Map<number, SyncInstruction[]>();\n\n    for (const instruction of instructions) {\n      const depth = instruction.depth;\n      if (!grouped.has(depth)) {\n        grouped.set(depth, []);\n      }\n      grouped.get(depth)!.push(instruction);\n    }\n\n    // Sort by depth (ascending) for sequential execution\n    return new Map([...grouped.entries()].sort((a, b) => a[0] - b[0]));\n  }\n\n  /**\n   * Groups instructions by target table for batch optimization.\n   *\n   * @param instructions - Instructions to group\n   * @returns Map of table name to instructions\n   */\n  private groupByTable(instructions: SyncInstruction[]): Map<string, SyncInstruction[]> {\n    const grouped = new Map<string, SyncInstruction[]>();\n\n    for (const instruction of instructions) {\n      const table = instruction.targetTable;\n      if (!grouped.has(table)) {\n        grouped.set(table, []);\n      }\n      grouped.get(table)!.push(instruction);\n    }\n\n    return grouped;\n  }\n\n  /**\n   * Checks if sync should proceed based on watched fields.\n   *\n   * @param config - Sync configuration\n   * @param changedFields - Fields that changed\n   * @returns True if sync should proceed\n   */\n  private shouldSync(config: SyncConfig, changedFields: string[]): boolean {\n    if (config.watchFields.length === 0) {\n      return true; // Watch all fields\n    }\n\n    return config.watchFields.some((field) => changedFields.includes(field));\n  }\n\n  /**\n   * Gets embedded data from the source model.\n   *\n   * @param data - Source model data or Model instance\n   * @param config - Sync configuration\n   * @returns Embedded data\n   */\n  private async getEmbedData(\n    data: Record<string, unknown> | Model,\n    config: SyncConfig,\n  ): Promise<Record<string, unknown>> {\n    // If data is a Model instance, call the embed method on it\n    if (data instanceof Model) {\n      if (Array.isArray(config.embedKey)) {\n        return data.only(config.embedKey);\n      }\n\n      if (typeof data[config.embedKey as keyof Model] !== \"function\") {\n        return data[config.embedKey as keyof Model] as Record<string, unknown>;\n      }\n      // Fallback: use embedData() if available\n      if (typeof data.embedData === \"function\") {\n        return data.embedData;\n      }\n      // Last resort: return model data\n      return data.data;\n    }\n\n    // Otherwise, return the data as-is\n    return data as Record<string, unknown>;\n  }\n\n  /**\n   * Gets sync configurations from the source model.\n   *\n   * @returns Array of sync configurations\n   */\n  private getSyncConfigs(): SyncConfig[] {\n    const syncWith = (this.sourceModel as any).syncWith;\n\n    if (!syncWith || !Array.isArray(syncWith)) {\n      return [];\n    }\n\n    return syncWith.map((builder: any) =>\n      typeof builder.build === \"function\" ? builder.build() : builder,\n    );\n  }\n\n  /**\n   * Gets sync configurations for a specific model.\n   *\n   * @param modelClass - The model class\n   * @returns Array of sync configurations\n   */\n  private getSyncConfigsForModel(modelClass: ChildModel<Model>): SyncConfig[] {\n    const syncWith = (modelClass as any).syncWith;\n\n    if (!syncWith || !Array.isArray(syncWith)) {\n      return [];\n    }\n\n    return syncWith.map((builder: any) =>\n      typeof builder.build === \"function\" ? builder.build() : builder,\n    );\n  }\n\n  /**\n   * Emits a syncing event.\n   *\n   * @param instruction - The sync instruction\n   */\n  private async emitSyncingEvent(instruction: SyncInstruction): Promise<void> {\n    const payload: SyncEventPayload = {\n      sourceModel: instruction.sourceModel,\n      sourceId: instruction.sourceId,\n      targetModel: instruction.targetModel,\n      filter: instruction.filter,\n      update: instruction.update,\n      affectedCount: 0, // Not yet known\n      depth: instruction.depth,\n      chain: instruction.chain,\n    };\n\n    // Emit on source model\n    if (typeof (this.sourceModel as any).emitSyncEvent === \"function\") {\n      await (this.sourceModel as any).emitSyncEvent(\"syncing\", payload);\n    }\n  }\n\n  /**\n   * Emits a synced event.\n   *\n   * @param context - The sync context\n   */\n  private async emitSyncedEvent(context: any): Promise<void> {\n    const payload: SyncEventPayload = {\n      sourceModel: context.sourceModel,\n      sourceId: context.sourceId,\n      targetModel: context.targetModel,\n      filter: context.filter,\n      update: context.update,\n      affectedCount: context.affectedCount,\n      depth: context.currentDepth,\n      chain: context.syncChain,\n    };\n\n    // Emit on source model\n    if (typeof (this.sourceModel as any).emitSyncEvent === \"function\") {\n      await (this.sourceModel as any).emitSyncEvent(\"synced\", payload);\n    }\n  }\n\n  /**\n   * Creates an empty sync result.\n   *\n   * @returns Empty sync result\n   */\n  private createEmptyResult(): SyncResult {\n    return {\n      success: true,\n      attempted: 0,\n      succeeded: 0,\n      failed: 0,\n      errors: [],\n      depthReached: 0,\n      contexts: [],\n    };\n  }\n}\n"],"mappings":"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"}

package/esm/utils/connect-to-database.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"connect-to-database.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"mappings":";;;;;;;;KAUY,cAAA;;;;AAAc;AAmB1B;;;;AAAsD;AAwCtD;;;;;;;;KAxCY,kBAAA,GAAqB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0RhC;AAgDT;;;KAlSY,iBAAA;EAmSiC;;;;EA1R3C,MAAA,GAAS,cAAA;EA2RD;;;;;EApRR,IAAA;EAmRA;;;;EA7QA,SAAA;EA2Wc;;;EAtWd,QAAA;EAsWgC;;;;AAAoC;AAUtE;EAxWE,OAAA;EAwW+B;;;;;;;EA3V/B,GAAA;EA8VQ;;;;EAxVR,IAAA;EAsVyC;;;;EAhVzC,IAAA;EAkVS;;AAAC;EA7UV,QAAA;;;;EAKA,QAAA;;;;;EAMA,UAAA;;;;;;;EAYA,aAAA,GAAgB,cAAA;;;;;;;EAYhB,aAAA,GAAgB,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB,YAAA,GAAe,kBAAA;;;;;;;;;;;;;;;;EAiBf,gBAAA,GAAmB,iBAAA;;;;;;;;;;;;;;;;;EAkBnB,eAAA,GAAkB,gBAAA;;;;;;;;;;;EAgBlB,qBAAA,GAAwB,cAAA;;;;;;;;;;;EAYxB,iBAAA;;;;EASA,UAAA;;;;;;;;;;;;IAYE,aAAA;;;;;;IAOA,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDkB,iBAAA,6CACpB,OAAA,EAAS,iBAAA,CAAkB,cAAA,EAAgB,cAAA,IAC1C,OAAA,CAAQ,UAAA;;;;;;;;;;;;iBA6FK,iBAAA,WAA4B,cAAA,WAAyB,CAAC;;;;;iBAUhD,WAAA,UACpB,EAAA,GAAK,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,GACzC,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"connect-to-database.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"mappings":";;;;;;;;KAUY,cAAA;;;;AAAc;AAmB1B;;;;AAAsD;AAwCtD;;;;;;;;KAxCY,kBAAA,GAAqB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0RhC;AAgDT;;;KAlSY,iBAAA;EAmSiC;;;;EA1R3C,MAAA,GAAS,cAAA;EA2RD;;;;;EApRR,IAAA;EAmRA;;;;EA7QA,SAAA;EA2Wc;;;EAtWd,QAAA;EAsWgC;;;;AAAoC;AAUtE;EAxWE,OAAA;EAwW+B;;;;;;;EA3V/B,GAAA;EA8VQ;;;;EAxVR,IAAA;EAsVyC;;;;EAhVzC,IAAA;EAkVS;;AAAC;EA7UV,QAAA;;;;EAKA,QAAA;;;;;EAMA,UAAA;;;;;;;EAYA,aAAA,GAAgB,cAAA;;;;;;;EAYhB,aAAA,GAAgB,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB,YAAA,GAAe,kBAAA;;;;;;;;;;;;;;;;EAiBf,gBAAA,GAAmB,iBAAA;;;;;;;;;;;;;;;;;EAkBnB,eAAA,GAAkB,gBAAA;;;;;;;;;;;EAgBlB,qBAAA,GAAwB,cAAA;;;;;;;;;;;EAYxB,iBAAA;;;;EASA,UAAA;;;;;;;;;;;;IAYE,aAAA;;;;;;IAOA,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDkB,iBAAA,4CAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,cAAA,EAAgB,cAAA,IAC1C,OAAA,CAAQ,UAAA;;;;;;;;;;;;iBA6FK,iBAAA,WAA4B,cAAA,OAAA,CAAA,GAAyB,CAAC;;;;;iBAUhD,WAAA,SAAA,CACpB,EAAA,GAAK,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,GACzC,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA"}