npm - @warlock.js/cascade - Versions diffs - 5.29.0 → 5.31.0 - Mend

@warlock.js/cascade 5.29.0 → 5.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (392) hide show

package/esm/relations/relation-hydrator.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"relation-hydrator.mjs","names":[],"sources":["~~../../../../../../../~~cascade/src/relations/relation-hydrator.ts"],"sourcesContent":["/*\n @fileoverview Restores relation data onto model instances from a plain object snapshot.\n \n This is the cache-restoration counterpart to RelationLoader (which loads from the DB).\n * It is intentionally decoupled from query execution — it only deals with instantiating\n * related models from already-serialized data.\n \n @module @warlock.js/cascade/relations/relation-hydrator\n \n @example\n * ```typescript\n * // Restoring a model + its relations from a cache snapshot:\n * const snapshot = await cache.get(key);\n * const chat = Chat.fromSnapshot(snapshot);\n * // chat.unit, chat.organization etc. are fully hydrated Model instances.\n * ```\n /\n\nimport type { ChildModel, Model } from \"../model/model\";\nimport { resolveModelClass } from \"../model/register-model\";\nimport type { RelationDefinition } from \"./types\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\n/\n The serialized shape of a single relation entry inside a model snapshot.\n * Each value is either:\n * - `null` — the relation was loaded and resolved to nothing (e.g. belongsTo with no match)\n * - A nested snapshot object `{ data, relations }` — a single related model\n * - An array of nested snapshot objects — a collection relation\n /\nexport type SerializedRelation = null \| ModelSnapshot \| ModelSnapshot[];\n\n/\n The plain-object shape produced by `model.toSnapshot()` and consumed by\n * `Model.fromSnapshot()`. The `relations` map uses the same relation names\n * defined in the model's static `relations` property.\n /\nexport type ModelSnapshot = {\n data: Record<string, unknown>;\n relations: Record<string, SerializedRelation>;\n};\n\n// ============================================================================\n// RELATION HYDRATOR CLASS\n// ============================================================================\n\n/\n Restores eager-loaded relations from a plain snapshot onto a model instance.\n \n Mirrors the interface of RelationLoader but instead of issuing DB queries,\n * it recursively instantiates related models from serialized snapshot data.\n \n @example\n * ```typescript\n * // Used internally by Model.fromSnapshot():\n * const model = new Chat(snapshot.data);\n * RelationHydrator.hydrate(model, Chat.relations, snapshot.relations);\n * ```\n /\nexport class RelationHydrator {\n /\n Hydrate all relations from a snapshot onto `model`.\n \n - Looks up each relation name in `relationDefs` to find the target model class.\n * - Recursively calls `fromSnapshot` on nested snapshots so deeply nested\n * relations are fully hydrated as well.\n * - Sets each relation on both `model.loadedRelations` (Map) and as a direct\n * property (`model[name]`) to match the behaviour of RelationLoader.\n * - Intentionally preserves `null` entries — a null relation was explicitly\n * loaded and resolved to nothing; this is different from a missing relation.\n \n @param model - The model instance to attach relations to\n * @param relationDefs - The static `relations` map from the model class\n * @param relationsSnapshot - The `relations` portion of a `ModelSnapshot`\n */\n public static hydrate(\n model: Model,\n relationDefs: Record<string, RelationDefinition>,\n relationsSnapshot: Record<string, SerializedRelation> \| undefined,\n ): void {\n if (!relationsSnapshot) return;\n\n for (const [name, snapshot] of Object.entries(relationsSnapshot)) {\n const def = relationDefs[name];\n\n // Relation name not in definition — skip gracefully rather than throwing,\n // since the snapshot could be from an older schema version.\n if (!def) continue;\n\n const RelModel = resolveModelClass(def.model) as ChildModel<Model> \| undefined;\n if (!RelModel) continue;\n\n let hydrated: Model \| Model[] \| null;\n\n if (snapshot === null) {\n // Explicitly loaded relation that resolved to nothing — keep as null.\n hydrated = null;\n } else if (Array.isArray(snapshot)) {\n // Collection relation (hasMany / belongsToMany)\n hydrated = snapshot.map((item) => RelModel.fromSnapshot(item));\n } else {\n // Single relation (belongsTo / hasOne)\n hydrated = RelModel.fromSnapshot(snapshot);\n }\n\n // Set on the Map for getRelation() / isLoaded() API\n model.loadedRelations.set(name, hydrated);\n\n // Set as direct property for convenient access (model.unit, model.posts, …)\n (model as unknown as Record<string, unknown>)[name] = hydrated;\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA8DA,IAAa,mBAAb,MAA8B;;;;;;;;;;;;;;;;CAgB5B,OAAc,QACZ,OACA,cACA,mBACM;EACN,IAAI,CAAC,mBAAmB;EAExB,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,iBAAiB,GAAG;GAChE,MAAM,MAAM,aAAa;GAIzB,IAAI,CAAC,KAAK;GAEV,MAAM,WAAW,kBAAkB,IAAI,KAAK;GAC5C,IAAI,CAAC,UAAU;GAEf,IAAI;GAEJ,IAAI,aAAa,MAEf,WAAW;QACN,IAAI,MAAM,QAAQ,QAAQ,GAE/B,WAAW,SAAS,KAAK,SAAS,SAAS,aAAa,IAAI,CAAC;QAG7D,WAAW,SAAS,aAAa,QAAQ;GAI3C,MAAM,gBAAgB,IAAI,MAAM,QAAQ;GAGxC,AAAC,MAA6C,QAAQ;EACxD;CACF;AACF"}
1	+ {"version":3,"file":"relation-hydrator.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/relations/relation-hydrator.ts"],"sourcesContent":["/*\n @fileoverview Restores relation data onto model instances from a plain object snapshot.\n \n This is the cache-restoration counterpart to RelationLoader (which loads from the DB).\n * It is intentionally decoupled from query execution — it only deals with instantiating\n * related models from already-serialized data.\n \n @module @warlock.js/cascade/relations/relation-hydrator\n \n @example\n * ```typescript\n * // Restoring a model + its relations from a cache snapshot:\n * const snapshot = await cache.get(key);\n * const chat = Chat.fromSnapshot(snapshot);\n * // chat.unit, chat.organization etc. are fully hydrated Model instances.\n * ```\n /\n\nimport type { ChildModel, Model } from \"../model/model\";\nimport { resolveModelClass } from \"../model/register-model\";\nimport type { RelationDefinition } from \"./types\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\n/\n The serialized shape of a single relation entry inside a model snapshot.\n * Each value is either:\n * - `null` — the relation was loaded and resolved to nothing (e.g. belongsTo with no match)\n * - A nested snapshot object `{ data, relations }` — a single related model\n * - An array of nested snapshot objects — a collection relation\n /\nexport type SerializedRelation = null \| ModelSnapshot \| ModelSnapshot[];\n\n/\n The plain-object shape produced by `model.toSnapshot()` and consumed by\n * `Model.fromSnapshot()`. The `relations` map uses the same relation names\n * defined in the model's static `relations` property.\n /\nexport type ModelSnapshot = {\n data: Record<string, unknown>;\n relations: Record<string, SerializedRelation>;\n};\n\n// ============================================================================\n// RELATION HYDRATOR CLASS\n// ============================================================================\n\n/\n Restores eager-loaded relations from a plain snapshot onto a model instance.\n \n Mirrors the interface of RelationLoader but instead of issuing DB queries,\n * it recursively instantiates related models from serialized snapshot data.\n \n @example\n * ```typescript\n * // Used internally by Model.fromSnapshot():\n * const model = new Chat(snapshot.data);\n * RelationHydrator.hydrate(model, Chat.relations, snapshot.relations);\n * ```\n /\nexport class RelationHydrator {\n /\n Hydrate all relations from a snapshot onto `model`.\n \n - Looks up each relation name in `relationDefs` to find the target model class.\n * - Recursively calls `fromSnapshot` on nested snapshots so deeply nested\n * relations are fully hydrated as well.\n * - Sets each relation on both `model.loadedRelations` (Map) and as a direct\n * property (`model[name]`) to match the behaviour of RelationLoader.\n * - Intentionally preserves `null` entries — a null relation was explicitly\n * loaded and resolved to nothing; this is different from a missing relation.\n \n @param model - The model instance to attach relations to\n * @param relationDefs - The static `relations` map from the model class\n * @param relationsSnapshot - The `relations` portion of a `ModelSnapshot`\n */\n public static hydrate(\n model: Model,\n relationDefs: Record<string, RelationDefinition>,\n relationsSnapshot: Record<string, SerializedRelation> \| undefined,\n ): void {\n if (!relationsSnapshot) return;\n\n for (const [name, snapshot] of Object.entries(relationsSnapshot)) {\n const def = relationDefs[name];\n\n // Relation name not in definition — skip gracefully rather than throwing,\n // since the snapshot could be from an older schema version.\n if (!def) continue;\n\n const RelModel = resolveModelClass(def.model) as ChildModel<Model> \| undefined;\n if (!RelModel) continue;\n\n let hydrated: Model \| Model[] \| null;\n\n if (snapshot === null) {\n // Explicitly loaded relation that resolved to nothing — keep as null.\n hydrated = null;\n } else if (Array.isArray(snapshot)) {\n // Collection relation (hasMany / belongsToMany)\n hydrated = snapshot.map((item) => RelModel.fromSnapshot(item));\n } else {\n // Single relation (belongsTo / hasOne)\n hydrated = RelModel.fromSnapshot(snapshot);\n }\n\n // Set on the Map for getRelation() / isLoaded() API\n model.loadedRelations.set(name, hydrated);\n\n // Set as direct property for convenient access (model.unit, model.posts, …)\n (model as unknown as Record<string, unknown>)[name] = hydrated;\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA8DA,IAAa,mBAAb,MAA8B;;;;;;;;;;;;;;;;CAgB5B,OAAc,QACZ,OACA,cACA,mBACM;EACN,IAAI,CAAC,mBAAmB;EAExB,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,iBAAiB,GAAG;GAChE,MAAM,MAAM,aAAa;GAIzB,IAAI,CAAC,KAAK;GAEV,MAAM,WAAW,kBAAkB,IAAI,KAAK;GAC5C,IAAI,CAAC,UAAU;GAEf,IAAI;GAEJ,IAAI,aAAa,MAEf,WAAW;QACN,IAAI,MAAM,QAAQ,QAAQ,GAE/B,WAAW,SAAS,KAAK,SAAS,SAAS,aAAa,IAAI,CAAC;QAG7D,WAAW,SAAS,aAAa,QAAQ;GAI3C,MAAM,gBAAgB,IAAI,MAAM,QAAQ;GAGxC,AAAC,MAA6C,QAAQ;EACxD;CACF;AACF"}

package/esm/relations/relation-loader.d.mts CHANGED Viewed

@@ -2,7 +2,7 @@ import { ChildModel } from "../model/model.types.mjs";
 import { RelationConstraints } from "./types.mjs";
 import { Model } from "../model/model.mjs";
-//#region ../cascade/src/relations/relation-loader.d.ts
+//#region ../../packages/cascade/src/relations/relation-loader.d.ts
 /**
  * Efficiently loads relationships for one or more model instances.
  *

package/esm/relations/relation-loader.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"relation-loader.d.mts","names":[],"sources":["~~../../../../../../../~~cascade/src/relations/relation-loader.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;~~AAsuB2B~~;;;;;;;;;~~cArnBd~~,cAAA,gBAA8B,KAAA,GAAQ,KAAA;;;;mBAQhC,MAAA;;;;mBAKA,UAAA;;;;;;;cAYE,MAAA,EAAQ,MAAA,IAAU,UAAA,EAAY,UAAA,CAAW,MAAA;;;;;;cAUhD,gBAAA;;;;;;;;;;;;;;;;;;;;;EAwCC,IAAA,CACX,SAAA,qBACA,WAAA,GAAc,mBAAA,GACb,OAAA;;;;;;;;;;UAkEW,YAAA;;;;;;;;UA6DA,WAAA;;;;;;;;~~UA6CA~~,UAAA;;;;;;;;~~UAmDA~~,aAAA;;;;;;;;~~UAgDA~~,iBAAA;;;;;;;;UA2FA,mBAAA;;;;;;;UA6CN,mBAAA;;;;;;;;UAWA,iBAAA;;;;;;;~~UAkCA~~,WAAA;;;;;;;UAgBA,qBAAA;;;;;;;UAaA,gBAAA;;;;;;;;UAoBA,OAAA;;;;;;;UAsBA,mBAAA;;;;;;;;UAcA,iBAAA;;;;;;;;UAcA,iBAAA;AAAA"}
1	+ {"version":3,"file":"relation-loader.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/relations/relation-loader.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuuB2B;;;;;;;;;cAtnBd,cAAA,gBAA8B,KAAA,GAAQ,KAAA;;;;mBAQhC,MAAA;;;;mBAKA,UAAA;;;;;;;cAYE,MAAA,EAAQ,MAAA,IAAU,UAAA,EAAY,UAAA,CAAW,MAAA;;;;;;cAUhD,gBAAA;;;;;;;;;;;;;;;;;;;;;EAwCC,IAAA,CACX,SAAA,qBACA,WAAA,GAAc,mBAAA,GACb,OAAA;;;;;;;;;;UAkEW,YAAA;;;;;;;;UA6DA,WAAA;;;;;;;;UA8CA,UAAA;;;;;;;;UAoDA,aAAA;;;;;;;;UAiDA,iBAAA;;;;;;;;UA2FA,mBAAA;;;;;;;UA6CN,mBAAA;;;;;;;;UAWA,iBAAA;;;;;;;UAgCA,WAAA;;;;;;;UAgBA,qBAAA;;;;;;;UAaA,gBAAA;;;;;;;;UAoBA,OAAA;;;;;;;UAsBA,mBAAA;;;;;;;;UAcA,iBAAA;;;;;;;;UAcA,iBAAA;AAAA"}

package/esm/relations/relation-loader.mjs CHANGED Viewed

@@ -2,7 +2,7 @@ import { inferBelongsToForeignKey, inferHasForeignKey, inferPivotKey, inferPivot
 import { getModelFromRegistry, resolveModelName } from "../model/register-model.mjs";
 import { isLazy } from "@mongez/reinforcements";
-//#region ../cascade/src/relations/relation-loader.ts
+//#region ../../packages/cascade/src/relations/relation-loader.ts
 /**
 * @fileoverview Core relation loading logic for the Cascade ORM.
 *

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

	@@ -1 +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 const dataSource = this.modelClass.getDataSource();\n\n if (!dataSource) return undefined;\n\n const namingConvention =\n dataSource.modelDefaults?.namingConvention ??\n dataSource.driver?.modelDefaults?.namingConvention;\n\n return { ...dataSource.relationDefaults, namingConvention };\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 // Group the paths into a tree keyed by root relation, so a shared prefix\n // (\"posts.comments\", \"posts.tags\") is loaded ONCE and every child path is\n // loaded onto those same instances instead of overwriting them.\n const nodes = new Map<\n string,\n {\n constraint?: RelationConstraintCallback;\n children: string[];\n childConstraints: RelationConstraints;\n }\n >();\n\n for (const relationName of relationNames) {\n const [root, ...rest] = this.parseNestedRelation(relationName);\n const key = root ?? relationName;\n\n if (!nodes.has(key)) {\n nodes.set(key, { children: [], childConstraints: {} });\n }\n\n const node = nodes.get(key)!;\n const constraint = constraints?.[relationName];\n const callbackConstraint = typeof constraint === \"function\" ? constraint : undefined;\n\n if (rest.length === 0) {\n // A constraint belongs to the LAST segment of its path only.\n if (callbackConstraint) node.constraint = callbackConstraint;\n continue;\n }\n\n const childPath = rest.join(\".\");\n\n if (!node.children.includes(childPath)) {\n node.children.push(childPath);\n }\n\n if (callbackConstraint) node.childConstraints[childPath] = callbackConstraint;\n }\n\n for (const [root, node] of nodes) {\n await this.loadRelation(root, node.constraint, node.children, node.childConstraints);\n }\n }\n\n // ==========================================================================\n // PRIVATE METHODS - RELATION LOADING\n // ==========================================================================\n\n /\n Loads a single (root) relation once, then its child paths onto the same\n * loaded instances.\n \n @param name - The root relation name\n * @param constraint - Optional constraint callback, applied to this relation only\n * @param children - Remaining dot paths below this relation\n * @param childConstraints - Constraints keyed by the remaining dot paths\n /\n private async loadRelation(\n name: string,\n constraint?: RelationConstraintCallback,\n children: string[] = [],\n childConstraints: RelationConstraints = {},\n ): Promise<void> {\n const rootRelation: string \| undefined = name \|\| undefined;\n\n // An empty parse would otherwise reach `getRelationDefinition(undefined)`\n // and fail as `Relation \"undefined\" is not defined on model \"X\"` — a\n // message that sends the reader looking for a relation they never wrote,\n // instead of at the name they passed. Same failure, named correctly.\n if (rootRelation === undefined) {\n throw new Error(\n `Relation name \"${name}\" could not be parsed into a relation path on model ` +\n `\"${this.modelClass.name}\".`,\n );\n }\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 (children.length > 0) {\n await this.loadNestedRelations(rootRelation, children, childConstraints);\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 this.applySelect(query, definition, [foreignKey]);\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 this.applySelect(query, definition, [foreignKey]);\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 this.applySelect(query, definition, [ownerKey]);\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 this.applySelect(relatedQuery, definition, [relatedKey]);\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 remainingPaths - The remaining dot paths to load below the parent\n * @param constraints - Constraints keyed by those remaining paths\n /\n private async loadNestedRelations(\n parentRelation: string,\n remainingPaths: string[],\n constraints: RelationConstraints,\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 await nestedLoader.load(remainingPaths, constraints);\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 Applies the relation definition's `select` columns to the related query.\n * Runs before the constraint callback so an explicit constraint can still\n * override it. The key columns used to match records back to their owners\n * are always included.\n /\n private applySelect(\n query: { select: (columns: string[]) => unknown },\n definition: RelationDefinition,\n requiredKeys: string[],\n ): void {\n if (!definition.select \|\| definition.select.length === 0) return;\n\n query.select([...new Set([...definition.select, ...requiredKeys])]);\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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"}
1	+ {"version":3,"file":"relation-loader.mjs","names":[],"sources":["../../../../../../../../packages/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 const dataSource = this.modelClass.getDataSource();\n\n if (!dataSource) return undefined;\n\n const namingConvention =\n dataSource.modelDefaults?.namingConvention ??\n dataSource.driver?.modelDefaults?.namingConvention;\n\n return { ...dataSource.relationDefaults, namingConvention };\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 // Group the paths into a tree keyed by root relation, so a shared prefix\n // (\"posts.comments\", \"posts.tags\") is loaded ONCE and every child path is\n // loaded onto those same instances instead of overwriting them.\n const nodes = new Map<\n string,\n {\n constraint?: RelationConstraintCallback;\n children: string[];\n childConstraints: RelationConstraints;\n }\n >();\n\n for (const relationName of relationNames) {\n const [root, ...rest] = this.parseNestedRelation(relationName);\n const key = root ?? relationName;\n\n if (!nodes.has(key)) {\n nodes.set(key, { children: [], childConstraints: {} });\n }\n\n const node = nodes.get(key)!;\n const constraint = constraints?.[relationName];\n const callbackConstraint = typeof constraint === \"function\" ? constraint : undefined;\n\n if (rest.length === 0) {\n // A constraint belongs to the LAST segment of its path only.\n if (callbackConstraint) node.constraint = callbackConstraint;\n continue;\n }\n\n const childPath = rest.join(\".\");\n\n if (!node.children.includes(childPath)) {\n node.children.push(childPath);\n }\n\n if (callbackConstraint) node.childConstraints[childPath] = callbackConstraint;\n }\n\n for (const [root, node] of nodes) {\n await this.loadRelation(root, node.constraint, node.children, node.childConstraints);\n }\n }\n\n // ==========================================================================\n // PRIVATE METHODS - RELATION LOADING\n // ==========================================================================\n\n /\n Loads a single (root) relation once, then its child paths onto the same\n * loaded instances.\n \n @param name - The root relation name\n * @param constraint - Optional constraint callback, applied to this relation only\n * @param children - Remaining dot paths below this relation\n * @param childConstraints - Constraints keyed by the remaining dot paths\n /\n private async loadRelation(\n name: string,\n constraint?: RelationConstraintCallback,\n children: string[] = [],\n childConstraints: RelationConstraints = {},\n ): Promise<void> {\n const rootRelation: string \| undefined = name \|\| undefined;\n\n // An empty parse would otherwise reach `getRelationDefinition(undefined)`\n // and fail as `Relation \"undefined\" is not defined on model \"X\"` — a\n // message that sends the reader looking for a relation they never wrote,\n // instead of at the name they passed. Same failure, named correctly.\n if (rootRelation === undefined) {\n throw new Error(\n `Relation name \"${name}\" could not be parsed into a relation path on model ` +\n `\"${this.modelClass.name}\".`,\n );\n }\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 (children.length > 0) {\n await this.loadNestedRelations(rootRelation, children, childConstraints);\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 =\n 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 this.applySelect(query, definition, [foreignKey]);\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 =\n 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 this.applySelect(query, definition, [foreignKey]);\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 =\n 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 this.applySelect(query, definition, [ownerKey]);\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 this.applySelect(relatedQuery, definition, [relatedKey]);\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 remainingPaths - The remaining dot paths to load below the parent\n * @param constraints - Constraints keyed by those remaining paths\n /\n private async loadNestedRelations(\n parentRelation: string,\n remainingPaths: string[],\n constraints: RelationConstraints,\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 await nestedLoader.load(remainingPaths, constraints);\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(model: string \| ChildModel<Model> \| Lazy<unknown>): 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 Applies the relation definition's `select` columns to the related query.\n * Runs before the constraint callback so an explicit constraint can still\n * override it. The key columns used to match records back to their owners\n * are always included.\n /\n private applySelect(\n query: { select: (columns: string[]) => unknown },\n definition: RelationDefinition,\n requiredKeys: string[],\n ): void {\n if (!definition.select \|\| definition.select.length === 0) return;\n\n query.select([...new Set([...definition.select, ...requiredKeys])]);\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/relations/types.d.mts CHANGED Viewed

@@ -3,7 +3,7 @@ import { Model } from "../model/model.mjs";
 import { QueryBuilderContract } from "../contracts/query-builder.contract.mjs";
 import { Lazy } from "@mongez/reinforcements";
-//#region ../cascade/src/relations/types.d.ts
+//#region ../../packages/cascade/src/relations/types.d.ts
 /**
  * The type of relationship between models.
  *

package/esm/relations/types.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.mts","names":[],"sources":["~~../../../../../../../~~cascade/src/relations/types.ts"],"mappings":";;;;;;AAiCwB;AAsBxB;;;;;;;;;;;;;;;AAtBwB,KAAZ,YAAA;;;;;;;AAkFK;AAkBjB;;;;;;;;AAoBiB;KAlGL,kBAAA;EAgHa;;;EAAA,SA5Gd,IAAA,EAAM,YAAA;EAyHN;;;AAOM;AAcjB;;;;;;;;AAkBiB;AAkBjB;;EAzDW,SAxGA,KAAA,WAAgB,UAAA,CAAW,KAAA,IAAS,IAAA;EAiKf;;;;;;EAAA,SAzJrB,UAAA;EAiMM;AAAA;AAiBjB;;;EAjBiB,SA1LN,QAAA;EA2M0D;AAkBrE;;EAlBqE,SAtM1D,KAAA;EAwNuB;AAAmD;AAYrF;;EAZkC,SAlNvB,aAAA;EA8NwB;AAAa;AAYhD;;EAZmC,SAxNxB,eAAA;EAoOsB;AAAgC;AAsBjE;;;EAtBiC,SA7NtB,MAAA;AAAA;AAiQX;;;;AAA8B;AAM9B;;;;AAAoB;;AANpB,KA/OY,cAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;;;WAOA,MAAA;AAAA;;;;;;;;;;;;KAcC,aAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;;;WAOA,MAAA;AAAA;;;;;;;;;;;;KAcC,gBAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;WAKA,MAAA;AAAA;;;;;;;;;;;;;;;;KAkBC,oBAAA;;;;;;;WAOD,KAAA;;;;;;WAOA,QAAA;;;;;;WAOA,UAAA;;;;;;WAOA,aAAA;;;;;;WAOA,eAAA;;;;WAKA,MAAA;AAAA;;;;;;;;;;;KAiBC,0BAAA,IAA8B,KAA2B,EAApB,oBAAoB;;;;;;;;;;;;;;;;;KAkBzD,mBAAA,GAAsB,MAAM,mBAAmB,0BAAA;;;;;;;KAY/C,oBAAA,GAAuB,KAAA,GAAQ,KAAK;;;;;;;;;;;KAYpC,kBAAA,GAAqB,GAAG,SAAS,oBAAA;;;;;;;;;;;;;;;;;KAsBjC,mBAAA,GAAsB,MAAM,SAAS,kBAAA;;;;;;;;;KAcrC,SAAA,GAAY,MAAM;;;;;KAMlB,QAAA"}
1	+ {"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/relations/types.ts"],"mappings":";;;;;;AAiCwB;AAsBxB;;;;;;;;;;;;;;;AAtBwB,KAAZ,YAAA;;;;;;;AAkFK;AAkBjB;;;;;;;;AAoBiB;KAlGL,kBAAA;EAgHa;;;EAAA,SA5Gd,IAAA,EAAM,YAAA;EAyHN;;;AAOM;AAcjB;;;;;;;;AAkBiB;AAkBjB;;EAzDW,SAxGA,KAAA,WAAgB,UAAA,CAAW,KAAA,IAAS,IAAA;EAiKf;;;;;;EAAA,SAzJrB,UAAA;EAiMM;AAAA;AAiBjB;;;EAjBiB,SA1LN,QAAA;EA2M0D;AAkBrE;;EAlBqE,SAtM1D,KAAA;EAwNuB;AAAmD;AAYrF;;EAZkC,SAlNvB,aAAA;EA8NwB;AAAa;AAYhD;;EAZmC,SAxNxB,eAAA;EAoOsB;AAAgC;AAsBjE;;;EAtBiC,SA7NtB,MAAA;AAAA;AAiQX;;;;AAA8B;AAM9B;;;;AAAoB;;AANpB,KA/OY,cAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;;;WAOA,MAAA;AAAA;;;;;;;;;;;;KAcC,aAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;;;WAOA,MAAA;AAAA;;;;;;;;;;;;KAcC,gBAAA;;;;;;WAMD,UAAA;;;;;;WAOA,QAAA;;;;WAKA,MAAA;AAAA;;;;;;;;;;;;;;;;KAkBC,oBAAA;;;;;;;WAOD,KAAA;;;;;;WAOA,QAAA;;;;;;WAOA,UAAA;;;;;;WAOA,aAAA;;;;;;WAOA,eAAA;;;;WAKA,MAAA;AAAA;;;;;;;;;;;KAiBC,0BAAA,IAA8B,KAA2B,EAApB,oBAAoB;;;;;;;;;;;;;;;;;KAkBzD,mBAAA,GAAsB,MAAM,mBAAmB,0BAAA;;;;;;;KAY/C,oBAAA,GAAuB,KAAA,GAAQ,KAAK;;;;;;;;;;;KAYpC,kBAAA,GAAqB,GAAG,SAAS,oBAAA;;;;;;;;;;;;;;;;;KAsBjC,mBAAA,GAAsB,MAAM,SAAS,kBAAA;;;;;;;;;KAcrC,SAAA,GAAY,MAAM;;;;;KAMlB,QAAA"}

package/esm/remover/database-remover.d.mts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { Model } from "../model/model.mjs";
 import { RemoverContract, RemoverOptions, RemoverResult } from "../contracts/database-remover.contract.mjs";
-//#region ../cascade/src/remover/database-remover.d.ts
+//#region ../../packages/cascade/src/remover/database-remover.d.ts
 /**
  * Database remover service that orchestrates model deletion.
  *

package/esm/remover/database-remover.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"database-remover.d.mts","names":[],"sources":["~~../../../../../../../~~cascade/src/remover/database-remover.ts"],"mappings":";;;;;;~~AAoCA~~;;;;;;;;;;;;;;;;;;cAAa,eAAA,YAA2B,eAAA;EA+BnB;EAAA,iBA7BF,KAAA;EA6Ca;EAAA,iBA1Cb,IAAA;EA0CmC;EAAA,iBAvCnC,UAAA;~~EAmNT~~;EAAA,~~iBAhNS~~,MAAA;~~EA6PT~~;EAAA,~~iBA1PS~~,KAAA;~~EA0PE~~;EAAA,~~iBAvPF~~,UAAA;;;;;;;;;;;;;cAcE,KAAA,EAAO,KAAA;;;;;;;;EAgBb,OAAA,CAAQ,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,aAAA;;;;;;;;;;;;;;;;;;;;;~~UA4KpD~~,kBAAA;;;;;;;;;;;;~~UAyBA~~,iBAAA;;;;;;;;;UAoBA,WAAA;AAAA"}
1	+ {"version":3,"file":"database-remover.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/remover/database-remover.ts"],"mappings":";;;;;;AAiCA;;;;;;;;;;;;;;;;;;cAAa,eAAA,YAA2B,eAAA;EA+BnB;EAAA,iBA7BF,KAAA;EA6Ca;EAAA,iBA1Cb,IAAA;EA0CmC;EAAA,iBAvCnC,UAAA;EA2MT;EAAA,iBAxMS,MAAA;EAkPT;EAAA,iBA/OS,KAAA;EA+OE;EAAA,iBA5OF,UAAA;;;;;;;;;;;;;cAcE,KAAA,EAAO,KAAA;;;;;;;;EAgBb,OAAA,CAAQ,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,aAAA;;;;;;;;;;;;;;;;;;;;;UAoKpD,kBAAA;;;;;;;;;;;;UAsBA,iBAAA;;;;;;;;;UAoBA,WAAA;AAAA"}

package/esm/remover/database-remover.mjs CHANGED Viewed

@@ -2,7 +2,7 @@ import { afterCommit } from "../transactions/after-commit.mjs";
 import { triggerModelEvent } from "../sync/model-events.mjs";
 import { enqueueSyncFanout } from "../sync/sync-fanout.mjs";
-//#region ../cascade/src/remover/database-remover.ts
+//#region ../../packages/cascade/src/remover/database-remover.ts
 /**
 * Database remover service that orchestrates model deletion.
 *

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

	@@ -1 +1 @@
1	- {"version":3,"file":"database-remover.mjs","names":[],"sources":["../../../../../../../cascade/src/remover/database-remover.ts"],"sourcesContent":["import 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 { enqueueSyncFanout } from \"../sync/sync-fanout\";\nimport { triggerModelEvent } from \"../sync/model-events\";\nimport { afterCommit } from \"../transactions/after-commit\";\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 // Guard: an already soft-deleted row must keep its original timestamp\n const softFilter = { ...filter, [deletedAtColumn]: null };\n const updateResult = await this.driver.update(\n this.table,\n softFilter,\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 // The timestamp is already persisted, so it must not stay dirty.\n // Re-baseline only when it is the sole pending change, so unsaved\n // edits to other columns keep their dirty state.\n const dirty = this.model.dirtyTracker.getDirtyColumns();\n if (dirty.length === 1 && dirty[0] === deletedAtColumn) {\n this.model.dirtyTracker.reset(\n this.model.data as Record<string, unknown>,\n );\n }\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. Queue sync operations after COMMIT. A soft delete keeps the row, so\n // embedded copies must stay: only permanent/trash fire a delete sync.\n if (!options.skipSync && strategy !== \"soft\") {\n afterCommit(() => 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 const deletedAtColumn = this.ctor.deletedAtColumn;\n\n return {\n ...documentData,\n [typeof deletedAtColumn === \"string\" ? deletedAtColumn : \"deletedAt\"]:\n 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 triggerSync(): void {\n enqueueSyncFanout({\n sourceModel: this.ctor.name,\n operation: \"delete\",\n execute: () => triggerModelEvent(this.ctor, \"deleted\", this.model),\n });\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"database-remover.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/remover/database-remover.ts"],"sourcesContent":["import type { DriverContract, UpdateOperations } 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 { enqueueSyncFanout } from \"../sync/sync-fanout\";\nimport { triggerModelEvent } from \"../sync/model-events\";\nimport { afterCommit } from \"../transactions/after-commit\";\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 // Guard: an already soft-deleted row must keep its original timestamp\n const softFilter = { ...filter, [deletedAtColumn]: null };\n const updateResult = await this.driver.update(this.table, softFilter, updateOperations);\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 // The timestamp is already persisted, so it must not stay dirty.\n // Re-baseline only when it is the sole pending change, so unsaved\n // edits to other columns keep their dirty state.\n const dirty = this.model.dirtyTracker.getDirtyColumns();\n if (dirty.length === 1 && dirty[0] === deletedAtColumn) {\n this.model.dirtyTracker.reset(this.model.data as Record<string, unknown>);\n }\n }\n break;\n }\n }\n\n if (deletedCount === 0) {\n throw new Error(`Failed to destroy ${this.ctor.name} instance: record not found.`);\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. Queue sync operations after COMMIT. A soft delete keeps the row, so\n // embedded copies must stay: only permanent/trash fire a delete sync.\n if (!options.skipSync && strategy !== \"soft\") {\n afterCommit(() => 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(documentData: Record<string, unknown>): Record<string, unknown> {\n // Preserve all original fields and add deletion metadata\n const deletedAtColumn = this.ctor.deletedAtColumn;\n\n return {\n ...documentData,\n [typeof deletedAtColumn === \"string\" ? deletedAtColumn : \"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 triggerSync(): void {\n enqueueSyncFanout({\n sourceModel: this.ctor.name,\n operation: \"delete\",\n execute: () => triggerModelEvent(this.ctor, \"deleted\", this.model),\n });\n }\n}\n"],"mappings":"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"}

package/esm/restorer/database-restorer.d.mts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { Model } from "../model/model.mjs";
 import { RestorerContract, RestorerOptions, RestorerResult } from "../contracts/database-restorer.contract.mjs";
-//#region ../cascade/src/restorer/database-restorer.d.ts
+//#region ../../packages/cascade/src/restorer/database-restorer.d.ts
 /**
  * Database restorer service that orchestrates model restoration.
  *

package/esm/restorer/database-restorer.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"database-restorer.d.mts","names":[],"sources":["~~../../../../../../../~~cascade/src/restorer/database-restorer.ts"],"mappings":";;;;;;AAgCA;;;;;;;;;;;;;;;;;cAAa,gBAAA,YAA4B,gBAAA;EActB;EAAA,iBAZA,IAAA;EAyBqB;EAAA,iBAtBrB,UAAA;EAuCJ;EAAA,iBApCI,MAAA;EAsCN;EAAA,iBAnCM,KAAA;EAoCd;EAAA,iBAjCc,UAAA;EA4HJ;;;;;;;;;;;cA/GM,UAAA,SAAmB,KAAA;EAoe9B;;AAAW;;;;;;;EAndN,OAAA,CACX,EAAA,mBACA,OAAA,GAAS,eAAA,GACR,OAAA,CAAQ,cAAA;;;;;;;EA2FE,UAAA,CAAW,OAAA,GAAS,eAAA,GAAuB,OAAA,CAAQ,cAAA;;;;;;;;;;UAsKxD,eAAA;;;;;;;;;UAiBM,qBAAA;;;;;;;;UA2CA,yBAAA;;;;;;;;;;UA6CA,gBAAA;;;;;;;;UA4BA,aAAA;;;;;;;;;;;;;UAsBA,WAAA;;;;;;;;;;;;UAkCN,iBAAA;;;;;;;UAkBA,WAAA;AAAA"}
1	+ {"version":3,"file":"database-restorer.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/restorer/database-restorer.ts"],"mappings":";;;;;;AAgCA;;;;;;;;;;;;;;;;;cAAa,gBAAA,YAA4B,gBAAA;EActB;EAAA,iBAZA,IAAA;EAyBqB;EAAA,iBAtBrB,UAAA;EAuCJ;EAAA,iBApCI,MAAA;EAsCN;EAAA,iBAnCM,KAAA;EAoCd;EAAA,iBAjCc,UAAA;EA4HJ;;;;;;;;;;;cA/GM,UAAA,SAAmB,KAAA;EAoe9B;;AAAW;;;;;;;EAndN,OAAA,CACX,EAAA,mBACA,OAAA,GAAS,eAAA,GACR,OAAA,CAAQ,cAAA;;;;;;;EA2FE,UAAA,CAAW,OAAA,GAAS,eAAA,GAAuB,OAAA,CAAQ,cAAA;;;;;;;;;;UAsKxD,eAAA;;;;;;;;;UAiBM,qBAAA;;;;;;;;UA2CA,yBAAA;;;;;;;;;;UA6CA,gBAAA;;;;;;;;UA4BA,aAAA;;;;;;;;;;;;;UAsBA,WAAA;;;;;;;;;;;;UAkCN,iBAAA;;;;;;;UAkBA,WAAA;AAAA"}

package/esm/restorer/database-restorer.mjs CHANGED Viewed

@@ -2,7 +2,7 @@ import { triggerModelEvent } from "../sync/model-events.mjs";
 import { enqueueSyncFanout } from "../sync/sync-fanout.mjs";
 import { DatabaseWriter } from "../writer/database-writer.mjs";
-//#region ../cascade/src/restorer/database-restorer.ts
+//#region ../../packages/cascade/src/restorer/database-restorer.ts
 /**
 * Database restorer service that orchestrates model restoration.
 *

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

	@@ -1 +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\";\nimport { enqueueSyncFanout } from \"../sync/sync-fanout\";\nimport { triggerModelEvent } from \"../sync/model-events\";\nimport { DatabaseWriter } from \"../writer/database-writer\";\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. A soft-deleted row never left the\n // table, so it would \"conflict\" with itself: it keeps its id and is\n // updated in place.\n const finalData =\n strategy === \"trash\"\n ? await this.handleIdConflict(restoredData, id, onIdConflict)\n : restoredData;\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 originalTable: this.table,\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 await this.triggerSync(model);\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 // Soft rows never left the table; only trash restores can conflict.\n const idExists = strategy === \"trash\" && (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\n await this.triggerSync(model);\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 await this.triggerSync(model);\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, originalTable: this.table };\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 .where(\"originalTable\", this.table)\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: drops the old `_id` and `id`, then runs the record through the\n * writer's insert preparation so the new `id` comes from the same generator\n * a normal save uses (validation and events are skipped; this is a restore)\n * For SQL: Removes the primary key 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 newData = { ...recordData };\n\n if (this.driver.name !== \"mongodb\") {\n // SQL: Remove primary key to let database auto-increment\n delete newData[this.primaryKey];\n\n return newData;\n }\n\n // MongoDB: let the driver mint a new _id and the writer generate a new id.\n // The generator skips records that already carry an `id`, so drop both.\n delete newData._id;\n delete newData.id;\n\n const model = new (this.ctor as any)(newData) as Model;\n\n return await new DatabaseWriter(model).prepareForInsert({\n skipEvents: true,\n skipValidation: true,\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 Queue sync for a restored record so embedded copies come back up to date.\n * The restore has already succeeded, so queued failures are retried separately.\n \n @private\n */\n private triggerSync(model: Model): void {\n enqueueSyncFanout({\n sourceModel: this.ctor.name,\n operation: \"restore\",\n execute: () =>\n triggerModelEvent(\n this.ctor as any,\n \"updated\",\n model,\n Object.keys(model.data as Record<string, unknown>),\n ),\n });\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"database-restorer.mjs","names":[],"sources":["../../../../../../../../packages/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\";\nimport { enqueueSyncFanout } from \"../sync/sync-fanout\";\nimport { triggerModelEvent } from \"../sync/model-events\";\nimport { DatabaseWriter } from \"../writer/database-writer\";\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. A soft-deleted row never left the\n // table, so it would \"conflict\" with itself: it keeps its id and is\n // updated in place.\n const finalData =\n strategy === \"trash\"\n ? await this.handleIdConflict(restoredData, id, onIdConflict)\n : restoredData;\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 originalTable: this.table,\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 await this.triggerSync(model);\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 // Soft rows never left the table; only trash restores can conflict.\n const idExists = strategy === \"trash\" && (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\n await this.triggerSync(model);\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 await this.triggerSync(model);\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, originalTable: this.table };\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 .where(\"originalTable\", this.table)\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: drops the old `_id` and `id`, then runs the record through the\n * writer's insert preparation so the new `id` comes from the same generator\n * a normal save uses (validation and events are skipped; this is a restore)\n * For SQL: Removes the primary key 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 newData = { ...recordData };\n\n if (this.driver.name !== \"mongodb\") {\n // SQL: Remove primary key to let database auto-increment\n delete newData[this.primaryKey];\n\n return newData;\n }\n\n // MongoDB: let the driver mint a new _id and the writer generate a new id.\n // The generator skips records that already carry an `id`, so drop both.\n delete newData._id;\n delete newData.id;\n\n const model = new (this.ctor as any)(newData) as Model;\n\n return await new DatabaseWriter(model).prepareForInsert({\n skipEvents: true,\n skipValidation: true,\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 Queue sync for a restored record so embedded copies come back up to date.\n * The restore has already succeeded, so queued failures are retried separately.\n \n @private\n */\n private triggerSync(model: Model): void {\n enqueueSyncFanout({\n sourceModel: this.ctor.name,\n operation: \"restore\",\n execute: () =>\n triggerModelEvent(\n this.ctor as any,\n \"updated\",\n model,\n Object.keys(model.data as Record<string, unknown>),\n ),\n });\n }\n}\n"],"mappings":"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"}

package/esm/sql-database-dirty-tracker.d.mts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { DatabaseDirtyTracker } from "./database-dirty-tracker.mjs";
-//#region ../cascade/src/sql-database-dirty-tracker.d.ts
+//#region ../../packages/cascade/src/sql-database-dirty-tracker.d.ts
 /**
  * A dirty tracker designed for SQL databases where nested objects shouldn't be flattened.
  * Since SQL drivers (like Postgres) replace the entire JSON column when updated,

package/esm/sql-database-dirty-tracker.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"sql-database-dirty-tracker.d.mts","names":[],"sources":["~~../../../../../../~~cascade/src/sql-database-dirty-tracker.ts"],"mappings":";;;;;AAOA;;;cAAa,uBAAA,SAAgC,oBAAA;EAIoB;;;EAAA,UAA5C,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,MAAA;AAAA"}
1	+ {"version":3,"file":"sql-database-dirty-tracker.d.mts","names":[],"sources":["../../../../../../../packages/cascade/src/sql-database-dirty-tracker.ts"],"mappings":";;;;;AAOA;;;cAAa,uBAAA,SAAgC,oBAAA;EAIoB;;;EAAA,UAA5C,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,MAAA;AAAA"}

package/esm/sql-database-dirty-tracker.mjs CHANGED Viewed

@@ -1,6 +1,6 @@
 import { DatabaseDirtyTracker } from "./database-dirty-tracker.mjs";
-//#region ../cascade/src/sql-database-dirty-tracker.ts
+//#region ../../packages/cascade/src/sql-database-dirty-tracker.ts
 /**
 * A dirty tracker designed for SQL databases where nested objects shouldn't be flattened.
 * Since SQL drivers (like Postgres) replace the entire JSON column when updated,

package/esm/sql-database-dirty-tracker.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"sql-database-dirty-tracker.mjs","names":[],"sources":["~~../../../../../../~~cascade/src/sql-database-dirty-tracker.ts"],"sourcesContent":["import { DatabaseDirtyTracker } from \"./database-dirty-tracker\";\n\n/*\n A dirty tracker designed for SQL databases where nested objects shouldn't be flattened.\n * Since SQL drivers (like Postgres) replace the entire JSON column when updated,\n * we keep the object intact instead of using dot-notation keys.\n /\nexport class SqlDatabaseDirtyTracker extends DatabaseDirtyTracker {\n /\n Overrides the default flattening behavior to keep the raw data structure.\n */\n protected override flattenData(data: Record<string, unknown>): Record<string, unknown> {\n // Return a shallow copy of the data without flattening nested objects\n return { ...data };\n }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,0BAAb,cAA6C,qBAAqB;;;;CAIhE,AAAmB,YAAY,MAAwD;EAErF,OAAO,EAAE,GAAG,KAAK;CACnB;AACF"}
1	+ {"version":3,"file":"sql-database-dirty-tracker.mjs","names":[],"sources":["../../../../../../../packages/cascade/src/sql-database-dirty-tracker.ts"],"sourcesContent":["import { DatabaseDirtyTracker } from \"./database-dirty-tracker\";\n\n/*\n A dirty tracker designed for SQL databases where nested objects shouldn't be flattened.\n * Since SQL drivers (like Postgres) replace the entire JSON column when updated,\n * we keep the object intact instead of using dot-notation keys.\n /\nexport class SqlDatabaseDirtyTracker extends DatabaseDirtyTracker {\n /\n Overrides the default flattening behavior to keep the raw data structure.\n */\n protected override flattenData(data: Record<string, unknown>): Record<string, unknown> {\n // Return a shallow copy of the data without flattening nested objects\n return { ...data };\n }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,0BAAb,cAA6C,qBAAqB;;;;CAIhE,AAAmB,YAAY,MAAwD;EAErF,OAAO,EAAE,GAAG,KAAK;CACnB;AACF"}

package/esm/sync/model-events.mjs CHANGED Viewed

@@ -1,6 +1,6 @@
 import events from "@mongez/events";
-//#region ../cascade/src/sync/model-events.ts
+//#region ../../packages/cascade/src/sync/model-events.ts
 /**
 * Model sync event name helpers.
 *

package/esm/sync/model-events.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"model-events.mjs","names":[],"sources":["~~../../../../../../../~~cascade/src/sync/model-events.ts"],"sourcesContent":["/*\n Model sync event name helpers.\n \n Provides type-safe event names for model sync operations.\n * Avoids hardcoded string literals throughout the codebase.\n \n @module cascade-next/sync/model-events\n /\n\nimport events from \"@mongez/events\";\nimport type { ChildModel, Model } from \"../model/model\";\n\n/\n Event name prefix for all model sync events.\n /\nexport const MODEL_EVENT_PREFIX = \"model\";\n\n/\n Model sync event types.\n /\nexport const ModelSyncEventType = {\n UPDATED: \"updated\",\n DELETED: \"deleted\",\n} as const;\n\nexport type ModelSyncEventTypeName = (typeof ModelSyncEventType)[keyof typeof ModelSyncEventType];\n\n/\n Resolve the identity used in event names.\n \n Class names collide across packages (e.g. auth's `User` and an app `User`),\n * so key on the table plus the data source when available and fall back to\n * the class name only for models without a table.\n /\nfunction getModelEventKey(modelClass: ChildModel<Model>): string {\n const table = modelClass.table;\n\n if (!table) {\n return modelClass.name;\n }\n\n const source = modelClass.dataSource;\n const sourceName = typeof source === \"string\" ? source : source?.name;\n\n return sourceName ? `${sourceName}:${table}` : table;\n}\n\n/\n Get the event name for a model update.\n \n @param modelClass - The model class\n * @returns Event name string (e.g., \"model.Category.updated\")\n \n @example\n * ```typescript\n * const eventName = getModelUpdatedEvent(Category);\n * // Returns: \"model.Category.updated\"\n * ```\n /\nexport function getModelUpdatedEvent(modelClass: ChildModel<Model>): string {\n return `${MODEL_EVENT_PREFIX}.${getModelEventKey(modelClass)}.${ModelSyncEventType.UPDATED}`;\n}\n\n/\n Get the event name for a model deletion.\n \n @param modelClass - The model class\n * @returns Event name string (e.g., \"model.Category.deleted\")\n \n @example\n * ```typescript\n * const eventName = getModelDeletedEvent(Category);\n * // Returns: \"model.Category.deleted\"\n * ```\n /\nexport function getModelDeletedEvent(modelClass: ChildModel<Model>): string {\n return `${MODEL_EVENT_PREFIX}.${getModelEventKey(modelClass)}.${ModelSyncEventType.DELETED}`;\n}\n\n/\n Get the event name for a model by name string.\n \n @param modelName - The model class name\n * @param eventType - The event type\n * @returns Event name string\n \n @example\n * ```typescript\n * const eventName = getModelEvent(\"Category\", \"updated\");\n * // Returns: \"model.Category.updated\"\n * ```\n /\nexport function getModelEvent(modelName: string, eventType: ModelSyncEventTypeName): string {\n return `${MODEL_EVENT_PREFIX}.${modelName}.${eventType}`;\n}\n\n/\n Legacy event name for a model: `model.<ClassName>.<event>`.\n \n @deprecated Use the table-keyed name from `getModelUpdatedEvent` / `getModelDeletedEvent`.\n * The class-name form is still emitted in 5.21 for compatibility and will be removed later.\n /\nexport function getLegacyModelEvent(\n modelClass: ChildModel<Model>,\n eventType: ModelSyncEventTypeName,\n): string {\n return getModelEvent(modelClass.name, eventType);\n}\n\n/\n Trigger a model sync event under both names: the deprecated class-name form first,\n * then the table-keyed form. The second is skipped when both names are identical,\n * so a listener on either form fires exactly once.\n */\nexport async function triggerModelEvent(\n modelClass: ChildModel<Model>,\n eventType: ModelSyncEventTypeName,\n ...args: unknown[]\n): Promise<void> {\n const legacy = getLegacyModelEvent(modelClass, eventType);\n const current = getModelEvent(getModelEventKey(modelClass), eventType);\n\n // Deprecated class-name form, kept for 5.21 compatibility.\n await events.triggerAll(legacy, ...args);\n\n if (current !== legacy) {\n await events.triggerAll(current, ...args);\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAa,qBAAqB;;;;AAKlC,MAAa,qBAAqB;CAChC,SAAS;CACT,SAAS;AACX;;;;;;;;AAWA,SAAS,iBAAiB,YAAuC;CAC/D,MAAM,QAAQ,WAAW;CAEzB,IAAI,CAAC,OACH,OAAO,WAAW;CAGpB,MAAM,SAAS,WAAW;CAC1B,MAAM,aAAa,OAAO,WAAW,WAAW,SAAS,QAAQ;CAEjE,OAAO,aAAa,GAAG,WAAW,GAAG,UAAU;AACjD;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,YAAuC;CAC1E,OAAO,GAAG,mBAAmB,GAAG,iBAAiB,UAAU,EAAE,GAAG,mBAAmB;AACrF;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,YAAuC;CAC1E,OAAO,GAAG,mBAAmB,GAAG,iBAAiB,UAAU,EAAE,GAAG,mBAAmB;AACrF;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,WAAmB,WAA2C;CAC1F,OAAO,GAAG,mBAAmB,GAAG,UAAU,GAAG;AAC/C;;;;;;;AAQA,SAAgB,oBACd,YACA,WACQ;CACR,OAAO,cAAc,WAAW,MAAM,SAAS;AACjD;;;;;;AAOA,eAAsB,kBACpB,YACA,WACA,GAAG,MACY;CACf,MAAM,SAAS,oBAAoB,YAAY,SAAS;CACxD,MAAM,UAAU,cAAc,iBAAiB,UAAU,GAAG,SAAS;CAGrE,MAAM,OAAO,WAAW,QAAQ,GAAG,IAAI;CAEvC,IAAI,YAAY,QACd,MAAM,OAAO,WAAW,SAAS,GAAG,IAAI;AAE5C"}
1	+ {"version":3,"file":"model-events.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/sync/model-events.ts"],"sourcesContent":["/*\n Model sync event name helpers.\n \n Provides type-safe event names for model sync operations.\n * Avoids hardcoded string literals throughout the codebase.\n \n @module cascade-next/sync/model-events\n /\n\nimport events from \"@mongez/events\";\nimport type { ChildModel, Model } from \"../model/model\";\n\n/\n Event name prefix for all model sync events.\n /\nexport const MODEL_EVENT_PREFIX = \"model\";\n\n/\n Model sync event types.\n /\nexport const ModelSyncEventType = {\n UPDATED: \"updated\",\n DELETED: \"deleted\",\n} as const;\n\nexport type ModelSyncEventTypeName = (typeof ModelSyncEventType)[keyof typeof ModelSyncEventType];\n\n/\n Resolve the identity used in event names.\n \n Class names collide across packages (e.g. auth's `User` and an app `User`),\n * so key on the table plus the data source when available and fall back to\n * the class name only for models without a table.\n /\nfunction getModelEventKey(modelClass: ChildModel<Model>): string {\n const table = modelClass.table;\n\n if (!table) {\n return modelClass.name;\n }\n\n const source = modelClass.dataSource;\n const sourceName = typeof source === \"string\" ? source : source?.name;\n\n return sourceName ? `${sourceName}:${table}` : table;\n}\n\n/\n Get the event name for a model update.\n \n @param modelClass - The model class\n * @returns Event name string (e.g., \"model.Category.updated\")\n \n @example\n * ```typescript\n * const eventName = getModelUpdatedEvent(Category);\n * // Returns: \"model.Category.updated\"\n * ```\n /\nexport function getModelUpdatedEvent(modelClass: ChildModel<Model>): string {\n return `${MODEL_EVENT_PREFIX}.${getModelEventKey(modelClass)}.${ModelSyncEventType.UPDATED}`;\n}\n\n/\n Get the event name for a model deletion.\n \n @param modelClass - The model class\n * @returns Event name string (e.g., \"model.Category.deleted\")\n \n @example\n * ```typescript\n * const eventName = getModelDeletedEvent(Category);\n * // Returns: \"model.Category.deleted\"\n * ```\n /\nexport function getModelDeletedEvent(modelClass: ChildModel<Model>): string {\n return `${MODEL_EVENT_PREFIX}.${getModelEventKey(modelClass)}.${ModelSyncEventType.DELETED}`;\n}\n\n/\n Get the event name for a model by name string.\n \n @param modelName - The model class name\n * @param eventType - The event type\n * @returns Event name string\n \n @example\n * ```typescript\n * const eventName = getModelEvent(\"Category\", \"updated\");\n * // Returns: \"model.Category.updated\"\n * ```\n /\nexport function getModelEvent(modelName: string, eventType: ModelSyncEventTypeName): string {\n return `${MODEL_EVENT_PREFIX}.${modelName}.${eventType}`;\n}\n\n/\n Legacy event name for a model: `model.<ClassName>.<event>`.\n \n @deprecated Use the table-keyed name from `getModelUpdatedEvent` / `getModelDeletedEvent`.\n * The class-name form is still emitted in 5.21 for compatibility and will be removed later.\n /\nexport function getLegacyModelEvent(\n modelClass: ChildModel<Model>,\n eventType: ModelSyncEventTypeName,\n): string {\n return getModelEvent(modelClass.name, eventType);\n}\n\n/\n Trigger a model sync event under both names: the deprecated class-name form first,\n * then the table-keyed form. The second is skipped when both names are identical,\n * so a listener on either form fires exactly once.\n */\nexport async function triggerModelEvent(\n modelClass: ChildModel<Model>,\n eventType: ModelSyncEventTypeName,\n ...args: unknown[]\n): Promise<void> {\n const legacy = getLegacyModelEvent(modelClass, eventType);\n const current = getModelEvent(getModelEventKey(modelClass), eventType);\n\n // Deprecated class-name form, kept for 5.21 compatibility.\n await events.triggerAll(legacy, ...args);\n\n if (current !== legacy) {\n await events.triggerAll(current, ...args);\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAa,qBAAqB;;;;AAKlC,MAAa,qBAAqB;CAChC,SAAS;CACT,SAAS;AACX;;;;;;;;AAWA,SAAS,iBAAiB,YAAuC;CAC/D,MAAM,QAAQ,WAAW;CAEzB,IAAI,CAAC,OACH,OAAO,WAAW;CAGpB,MAAM,SAAS,WAAW;CAC1B,MAAM,aAAa,OAAO,WAAW,WAAW,SAAS,QAAQ;CAEjE,OAAO,aAAa,GAAG,WAAW,GAAG,UAAU;AACjD;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,YAAuC;CAC1E,OAAO,GAAG,mBAAmB,GAAG,iBAAiB,UAAU,EAAE,GAAG,mBAAmB;AACrF;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,YAAuC;CAC1E,OAAO,GAAG,mBAAmB,GAAG,iBAAiB,UAAU,EAAE,GAAG,mBAAmB;AACrF;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,WAAmB,WAA2C;CAC1F,OAAO,GAAG,mBAAmB,GAAG,UAAU,GAAG;AAC/C;;;;;;;AAQA,SAAgB,oBACd,YACA,WACQ;CACR,OAAO,cAAc,WAAW,MAAM,SAAS;AACjD;;;;;;AAOA,eAAsB,kBACpB,YACA,WACA,GAAG,MACY;CACf,MAAM,SAAS,oBAAoB,YAAY,SAAS;CACxD,MAAM,UAAU,cAAc,iBAAiB,UAAU,GAAG,SAAS;CAGrE,MAAM,OAAO,WAAW,QAAQ,GAAG,IAAI;CAEvC,IAAI,YAAY,QACd,MAAM,OAAO,WAAW,SAAS,GAAG,IAAI;AAE5C"}

package/esm/sync/model-sync-operation.d.mts CHANGED Viewed

@@ -2,7 +2,7 @@ import { ChildModel } from "../model/model.types.mjs";
 import { ModelSyncConfig, ModelSyncOperationContract } from "./types.mjs";
 import { Model } from "../model/model.mjs";
-//#region ../cascade/src/sync/model-sync-operation.d.ts
+//#region ../../packages/cascade/src/sync/model-sync-operation.d.ts
 /**
  * Manages a single model sync operation.
  *

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

	@@ -1 +1 @@
1	- {"version":3,"file":"model-sync-operation.d.mts","names":[],"sources":["~~../../../../../../../~~cascade/src/sync/model-sync-operation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAkCa,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;EAoSkB;;;AAAwB;;;;;;;;EAnQrC,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;;;;;UAuCA,kBAAA;;;;UAwCA,UAAA;;;;UAWA,eAAA;;;;UAiBM,qBAAA;;;;EAWP,SAAA,IAAa,QAAA,CAAS,eAAA;AAAA"}
1	+ {"version":3,"file":"model-sync-operation.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/sync/model-sync-operation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAkCa,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;EAoSkB;;;AAAwB;;;;;;;;EAnQrC,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;;;;;UAuCA,kBAAA;;;;UAwCA,UAAA;;;;UAWA,eAAA;;;;UAiBM,qBAAA;;;;EAWP,SAAA,IAAa,QAAA,CAAS,eAAA;AAAA"}

package/esm/sync/model-sync-operation.mjs CHANGED Viewed

@@ -4,7 +4,7 @@ import { SyncManager } from "./sync-manager.mjs";
 import { log } from "@warlock.js/logger";
 import events from "@mongez/events";
-//#region ../cascade/src/sync/model-sync-operation.ts
+//#region ../../packages/cascade/src/sync/model-sync-operation.ts
 /**
 * Model sync operation class.
 *