@warlock.js/cascade 4.0.174 → 4.1.2

package/esm/relations/relation-loader.mjs

@@ -0,0 +1,416 @@
+import { getModelFromRegistry, resolveModelName } from "../model/register-model.mjs";
+import { inferBelongsToForeignKey, inferHasForeignKey, inferPivotKey, inferPivotTable } from "./key-conventions.mjs";
+import { isLazy } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/cascade/src/relations/relation-loader.ts
+/**
+* @fileoverview Core relation loading logic for the Cascade ORM.
+*
+* The RelationLoader is responsible for efficiently loading related models
+* while preventing N+1 query problems through batch loading strategies.
+*
+* @module @warlock.js/cascade/relations/relation-loader
+*/
+/**
+* Attach a loaded relation onto a model instance, keeping the
+* `loadedRelations` Map and the direct property access in sync.
+*
+* The property is installed as a `defineProperty` getter/setter façade over
+* the Map — `model.posts` reads from `loadedRelations.get("posts")`, and
+* assigning `model.posts = newPosts` writes back to the Map. Eliminates the
+* historical drift between the two storage slots: any mutation visible via
+* one path is visible via the other.
+*
+* Used by both `RelationLoader` (the `with()` path) and the Postgres
+* driver's `attachJoinedRelations` (the `joinWith()` path).
+*
+* @example
+*   attachLoadedRelation(user, "posts", postsArray);
+*   user.posts === user.loadedRelations.get("posts"); // always true
+*/
+function attachLoadedRelation(model, name, value) {
+	const modelWithRelations = model;
+	if (!modelWithRelations.loadedRelations) modelWithRelations.loadedRelations = /* @__PURE__ */ new Map();
+	const relations = modelWithRelations.loadedRelations;
+	relations.set(name, value);
+	Object.defineProperty(model, name, {
+		configurable: true,
+		enumerable: true,
+		get() {
+			return relations.get(name);
+		},
+		set(next) {
+			relations.set(name, next);
+		}
+	});
+}
+/**
+* Efficiently loads relationships for one or more model instances.
+*
+* The RelationLoader handles:
+* - Batch loading to prevent N+1 query problems
+* - Nested relation loading via dot notation
+* - Constrained loading with query callbacks
+* - All relation types (hasOne, hasMany, belongsTo, belongsToMany)
+*
+* @template TModel - The type of model being loaded
+*
+* @example
+* ```typescript
+* const users = await User.query().get();
+* const loader = new RelationLoader(users, User);
+*
+* // Load single relation
+* await loader.load("posts");
+*
+* // Load multiple relations
+* await loader.load(["posts", "organization"]);
+*
+* // Load nested relations
+* await loader.load("posts.comments.author");
+*
+* // Load with constraints
+* await loader.load("posts", {
+*   posts: (query) => query.where("isPublished", true),
+* });
+* ```
+*/
+var RelationLoader = class RelationLoader {
+	/**
+	* The model instances to load relations for.
+	*/
+	models;
+	/**
+	* The model class constructor.
+	*/
+	modelClass;
+	/**
+	* Creates a new RelationLoader instance.
+	*
+	* @param models - The model instances to load relations for
+	* @param modelClass - The model class constructor
+	*/
+	constructor(models, modelClass) {
+		this.models = models;
+		this.modelClass = modelClass;
+	}
+	/**
+	* Read the configured relation conventions from this model's data
+	* source. Returns `undefined` when no overrides are set — the inference
+	* helpers fall back to framework defaults in that case.
+	*/
+	get relationDefaults() {
+		try {
+			return this.modelClass.getDataSource()?.relationDefaults;
+		} catch {
+			return;
+		}
+	}
+	/**
+	* Loads one or more relations for all model instances.
+	*
+	* @param relations - A single relation name, array of names, or constraints object
+	* @param constraints - Optional constraints to apply to the loading query
+	*
+	* @example
+	* ```typescript
+	* // Single relation
+	* await loader.load("posts");
+	*
+	* // Multiple relations
+	* await loader.load(["posts", "organization"]);
+	*
+	* // With constraints
+	* await loader.load("posts", {
+	*   posts: (query) => query.where("status", "active"),
+	* });
+	* ```
+	*/
+	async load(relations, constraints) {
+		if (this.models.length === 0) return;
+		const relationNames = Array.isArray(relations) ? relations : [relations];
+		for (const relationName of relationNames) {
+			const constraint = constraints?.[relationName];
+			const callbackConstraint = typeof constraint === "function" ? constraint : void 0;
+			await this.loadRelation(relationName, callbackConstraint);
+		}
+	}
+	/**
+	* Loads a single relation, handling nested relations via dot notation.
+	*
+	* @param name - The relation name, possibly with dot notation for nesting
+	* @param constraint - Optional constraint callback
+	*/
+	async loadRelation(name, constraint) {
+		const path = this.parseNestedRelation(name);
+		const rootRelation = path[0];
+		const definition = this.getRelationDefinition(rootRelation);
+		if (!definition) throw new Error(`Relation "${rootRelation}" is not defined on model "${this.modelClass.name}". Make sure to define it in the static 'relations' property.`);
+		switch (definition.type) {
+			case "hasMany":
+				await this.loadHasMany(rootRelation, definition, constraint);
+				break;
+			case "hasOne":
+				await this.loadHasOne(rootRelation, definition, constraint);
+				break;
+			case "belongsTo":
+				await this.loadBelongsTo(rootRelation, definition, constraint);
+				break;
+			case "belongsToMany":
+				await this.loadBelongsToMany(rootRelation, definition, constraint);
+				break;
+		}
+		if (path.length > 1) await this.loadNestedRelations(rootRelation, path.slice(1), constraint);
+	}
+	/**
+	* Loads a hasMany relation for all models.
+	*
+	* @param name - The relation name
+	* @param definition - The relation definition
+	* @param constraint - Optional constraint callback
+	*/
+	async loadHasMany(name, definition, constraint) {
+		const RelatedModel = this.resolveModelClass(definition.model);
+		const localKey = definition.localKey ?? this.modelClass.primaryKey ?? "id";
+		const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);
+		const localKeyValues = this.collectKeyValues(localKey);
+		if (localKeyValues.length === 0) {
+			this.setRelationOnModels(name, () => []);
+			return;
+		}
+		const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);
+		if (constraint) constraint(query);
+		const relatedRecords = await query.get();
+		const recordsByForeignKey = this.groupBy(relatedRecords, foreignKey);
+		this.setRelationOnModels(name, (model) => {
+			const keyValue = model.get(localKey);
+			return recordsByForeignKey.get(keyValue) ?? [];
+		});
+	}
+	/**
+	* Loads a hasOne relation for all models.
+	*
+	* @param name - The relation name
+	* @param definition - The relation definition
+	* @param constraint - Optional constraint callback
+	*/
+	async loadHasOne(name, definition, constraint) {
+		const RelatedModel = this.resolveModelClass(definition.model);
+		const localKey = definition.localKey ?? this.modelClass.primaryKey ?? "id";
+		const foreignKey = definition.foreignKey ?? inferHasForeignKey(this.modelClass.name, this.relationDefaults);
+		const localKeyValues = this.collectKeyValues(localKey);
+		if (localKeyValues.length === 0) {
+			this.setRelationOnModels(name, () => null);
+			return;
+		}
+		const query = RelatedModel.query().whereIn(foreignKey, localKeyValues);
+		if (constraint) constraint(query);
+		const relatedRecords = await query.get();
+		const recordsByForeignKey = /* @__PURE__ */ new Map();
+		for (const record of relatedRecords) {
+			const fkValue = record.get(foreignKey);
+			if (!recordsByForeignKey.has(fkValue)) recordsByForeignKey.set(fkValue, record);
+		}
+		this.setRelationOnModels(name, (model) => {
+			const keyValue = model.get(localKey);
+			return recordsByForeignKey.get(keyValue) ?? null;
+		});
+	}
+	/**
+	* Loads a belongsTo relation for all models.
+	*
+	* @param name - The relation name
+	* @param definition - The relation definition
+	* @param constraint - Optional constraint callback
+	*/
+	async loadBelongsTo(name, definition, constraint) {
+		const RelatedModel = this.resolveModelClass(definition.model);
+		const foreignKey = definition.foreignKey ?? inferBelongsToForeignKey(name, this.relationDefaults);
+		const ownerKey = definition.localKey ?? RelatedModel.primaryKey ?? "id";
+		const foreignKeyValues = this.collectKeyValues(foreignKey);
+		if (foreignKeyValues.length === 0) {
+			this.setRelationOnModels(name, () => null);
+			return;
+		}
+		const query = RelatedModel.query().whereIn(ownerKey, foreignKeyValues);
+		if (constraint) constraint(query);
+		const relatedRecords = await query.get();
+		const recordsByOwnerKey = /* @__PURE__ */ new Map();
+		for (const record of relatedRecords) {
+			const keyValue = record.get(ownerKey);
+			recordsByOwnerKey.set(keyValue, record);
+		}
+		this.setRelationOnModels(name, (model) => {
+			const fkValue = model.get(foreignKey);
+			return recordsByOwnerKey.get(fkValue) ?? null;
+		});
+	}
+	/**
+	* Loads a belongsToMany relation for all models.
+	*
+	* @param name - The relation name
+	* @param definition - The relation definition
+	* @param constraint - Optional constraint callback
+	*/
+	async loadBelongsToMany(name, definition, constraint) {
+		const RelatedModel = this.resolveModelClass(definition.model);
+		const relatedModelName = resolveModelName(definition.model);
+		const pivotTable = definition.pivot ?? inferPivotTable(this.modelClass.name, relatedModelName, this.relationDefaults);
+		const localKey = definition.pivotLocalKey ?? this.modelClass.primaryKey ?? "id";
+		const pivotLocalKey = definition.localKey ?? inferPivotKey(this.modelClass.name, this.relationDefaults);
+		const pivotForeignKey = definition.foreignKey ?? inferPivotKey(relatedModelName, this.relationDefaults);
+		const relatedKey = definition.pivotForeignKey ?? RelatedModel.primaryKey ?? "id";
+		const localKeyValues = this.collectKeyValues(localKey);
+		if (localKeyValues.length === 0) {
+			this.setRelationOnModels(name, () => []);
+			return;
+		}
+		const pivotRecords = await this.modelClass.getDataSource().driver.queryBuilder(pivotTable).whereIn(pivotLocalKey, localKeyValues).get();
+		if (pivotRecords.length === 0) {
+			this.setRelationOnModels(name, () => []);
+			return;
+		}
+		const relatedIds = [...new Set(pivotRecords.map((p) => p[pivotForeignKey]))];
+		const relatedQuery = RelatedModel.query().whereIn(relatedKey, relatedIds);
+		if (constraint) constraint(relatedQuery);
+		const relatedRecords = await relatedQuery.get();
+		const relatedById = /* @__PURE__ */ new Map();
+		for (const record of relatedRecords) relatedById.set(record.get(relatedKey), record);
+		const relationshipMap = /* @__PURE__ */ new Map();
+		for (const pivot of pivotRecords) {
+			const localValue = pivot[pivotLocalKey];
+			const foreignValue = pivot[pivotForeignKey];
+			const relatedRecord = relatedById.get(foreignValue);
+			if (relatedRecord) {
+				if (!relationshipMap.has(localValue)) relationshipMap.set(localValue, []);
+				relationshipMap.get(localValue).push(relatedRecord);
+			}
+		}
+		this.setRelationOnModels(name, (model) => {
+			const keyValue = model.get(localKey);
+			return relationshipMap.get(keyValue) ?? [];
+		});
+	}
+	/**
+	* Loads nested relations recursively.
+	*
+	* @param parentRelation - The name of the parent relation
+	* @param remainingPath - The remaining path segments to load
+	* @param constraint - Optional constraint callback
+	*/
+	async loadNestedRelations(parentRelation, remainingPath, constraint) {
+		const relatedModels = [];
+		for (const model of this.models) {
+			const loaded = this.getLoadedRelation(model, parentRelation);
+			if (Array.isArray(loaded)) relatedModels.push(...loaded);
+			else if (loaded) relatedModels.push(loaded);
+		}
+		if (relatedModels.length === 0) return;
+		const parentDefinition = this.getRelationDefinition(parentRelation);
+		if (!parentDefinition) return;
+		const nestedLoader = new RelationLoader(relatedModels, this.resolveModelClass(parentDefinition.model));
+		const nextRelation = remainingPath.join(".");
+		await nestedLoader.load(nextRelation, constraint ? { [nextRelation]: constraint } : void 0);
+	}
+	/**
+	* Parses a dot-notation relation path into segments.
+	*
+	* @param path - The relation path (e.g., "posts.comments.author")
+	* @returns An array of relation names
+	*/
+	parseNestedRelation(path) {
+		return path.split(".");
+	}
+	/**
+	* Resolves a model class from the registry by name.
+	*
+	* @param name - The registered model name
+	* @returns The model class constructor
+	* @throws Error if the model is not found in the registry
+	*/
+	resolveModelClass(model) {
+		if (typeof model === "function") return model;
+		if (isLazy(model)) return model.resolve();
+		const ModelClass = getModelFromRegistry(model);
+		if (!ModelClass) {
+			const callerName = this.modelClass.name || "unknown";
+			throw new Error(`Cannot resolve relation target — model "${model}" is not registered.\n  Caller: ${callerName} (relation target reference)\n  Common causes:\n    - The target model is missing the @RegisterModel() decorator\n    - The target model's module is not imported anywhere at startup\n    - Circular import between the caller and target — one of them sees\n      the other as undefined during module load\n  Fix: add an explicit \`import "<path-to-${model}-model>";\` to your app's\n  entry point so the decorator runs before any query consults this relation.\n  Alternative: declare the relation with \`lazy(() => ${model})\` instead of a string\n  to bind directly to the class (no registry lookup needed).`);
+		}
+		return ModelClass;
+	}
+	/**
+	* Gets the relation definition from the model class.
+	*
+	* @param name - The relation name
+	* @returns The relation definition or undefined
+	*/
+	getRelationDefinition(name) {
+		return this.modelClass.relations?.[name];
+	}
+	/**
+	* Collects unique key values from all models.
+	*
+	* @param key - The key to collect values for
+	* @returns An array of unique key values
+	*/
+	collectKeyValues(key) {
+		const values = /* @__PURE__ */ new Set();
+		for (const model of this.models) {
+			const value = model.get(key);
+			if (value !== void 0 && value !== null) values.add(value);
+		}
+		return [...values];
+	}
+	/**
+	* Groups records by a key value.
+	*
+	* @param records - The records to group
+	* @param key - The key to group by
+	* @returns A map of key values to records
+	*/
+	groupBy(records, key) {
+		const groups = /* @__PURE__ */ new Map();
+		for (const record of records) {
+			const keyValue = record.get(key);
+			if (!groups.has(keyValue)) groups.set(keyValue, []);
+			groups.get(keyValue).push(record);
+		}
+		return groups;
+	}
+	/**
+	* Sets a relation value on all models using a getter function.
+	*
+	* @param name - The relation name
+	* @param getter - Function that returns the relation value for each model
+	*/
+	setRelationOnModels(name, getter) {
+		for (const model of this.models) {
+			const value = getter(model);
+			this.setLoadedRelation(model, name, value);
+		}
+	}
+	/**
+	* Gets a loaded relation from a model instance.
+	*
+	* @param model - The model instance
+	* @param name - The relation name
+	* @returns The loaded relation value or undefined
+	*/
+	getLoadedRelation(model, name) {
+		return model.loadedRelations?.get(name);
+	}
+	/**
+	* Sets a loaded relation on a model instance.
+	*
+	* @param model - The model instance
+	* @param name - The relation name
+	* @param value - The relation value
+	*/
+	setLoadedRelation(model, name, value) {
+		attachLoadedRelation(model, name, value);
+	}
+};
+
+//#endregion
+export { RelationLoader, attachLoadedRelation };
+//# sourceMappingURL=relation-loader.mjs.map

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

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