metal-orm 1.1.20 → 1.1.21

package/dist/index.d.cts

@@ -4230,14 +4230,14 @@ declare class RelationChangeProcessor {
      * Inserts a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      */
     private insertPivotRow;
     /**
      * Updates a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      * @param pivotPayload - The pivot columns to update
      */
     private updatePivotRow;
@@ -4245,16 +4245,15 @@ declare class RelationChangeProcessor {
      * Deletes a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      */
     private deletePivotRow;
     /**
-     * Resolves the primary key value from an entity.
-     * @param entity - The entity
-     * @param table - The table definition
-     * @returns The primary key value or null
+     * Resolves the target-side key value used by a belongs-to-many relation.
+     * The declared targetKey is part of the relation contract and takes
+     * precedence over the target table primary key.
      */
-    private resolvePrimaryKeyValue;
+    private resolveBelongsToManyTargetValue;
     private buildPivotPayload;
     private handleMorphOneChange;
     private handleMorphManyChange;

package/dist/index.d.ts

@@ -4230,14 +4230,14 @@ declare class RelationChangeProcessor {
      * Inserts a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      */
     private insertPivotRow;
     /**
      * Updates a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      * @param pivotPayload - The pivot columns to update
      */
     private updatePivotRow;
@@ -4245,16 +4245,15 @@ declare class RelationChangeProcessor {
      * Deletes a pivot row for belongs-to-many relations.
      * @param relation - The belongs-to-many relation
      * @param rootId - The root entity's primary key value
-     * @param targetId - The target entity's primary key value
+     * @param targetId - The target entity's relation key value
      */
     private deletePivotRow;
     /**
-     * Resolves the primary key value from an entity.
-     * @param entity - The entity
-     * @param table - The table definition
-     * @returns The primary key value or null
+     * Resolves the target-side key value used by a belongs-to-many relation.
+     * The declared targetKey is part of the relation contract and takes
+     * precedence over the target table primary key.
      */
-    private resolvePrimaryKeyValue;
+    private resolveBelongsToManyTargetValue;
     private buildPivotPayload;
     private handleMorphOneChange;
     private handleMorphManyChange;

package/dist/index.js

@@ -14629,7 +14629,10 @@ var RelationChangeProcessor = class {
     const rootKey = relation.localKey || findPrimaryKey(entry.rootTable);
     const rootId = entry.root[rootKey];
     if (rootId === void 0 || rootId === null) return;
-    const targetId = this.resolvePrimaryKeyValue(entry.change.entity, relation.target);
+    const targetId = this.resolveBelongsToManyTargetValue(
+      entry.change.entity,
+      relation
+    );
     if (targetId === null) return;
     const pivotPayload = this.buildPivotPayload(relation, entry.change.pivot);
     if (entry.change.kind === "update") {
@@ -14701,7 +14704,7 @@ var RelationChangeProcessor = class {
    * Inserts a pivot row for belongs-to-many relations.
    * @param relation - The belongs-to-many relation
    * @param rootId - The root entity's primary key value
-   * @param targetId - The target entity's primary key value
+   * @param targetId - The target entity's relation key value
    */
   async insertPivotRow(relation, rootId, targetId, pivotPayload) {
     const payload = {
@@ -14717,7 +14720,7 @@ var RelationChangeProcessor = class {
    * Updates a pivot row for belongs-to-many relations.
    * @param relation - The belongs-to-many relation
    * @param rootId - The root entity's primary key value
-   * @param targetId - The target entity's primary key value
+   * @param targetId - The target entity's relation key value
    * @param pivotPayload - The pivot columns to update
    */
   async updatePivotRow(relation, rootId, targetId, pivotPayload) {
@@ -14732,7 +14735,7 @@ var RelationChangeProcessor = class {
    * Deletes a pivot row for belongs-to-many relations.
    * @param relation - The belongs-to-many relation
    * @param rootId - The root entity's primary key value
-   * @param targetId - The target entity's primary key value
+   * @param targetId - The target entity's relation key value
    */
   async deletePivotRow(relation, rootId, targetId) {
     const rootCol = relation.pivotTable.columns[relation.pivotForeignKeyToRoot];
@@ -14745,14 +14748,13 @@ var RelationChangeProcessor = class {
     await this.executor.executeSql(compiled.sql, compiled.params);
   }
   /**
-   * Resolves the primary key value from an entity.
-   * @param entity - The entity
-   * @param table - The table definition
-   * @returns The primary key value or null
+   * Resolves the target-side key value used by a belongs-to-many relation.
+   * The declared targetKey is part of the relation contract and takes
+   * precedence over the target table primary key.
    */
-  resolvePrimaryKeyValue(entity, table) {
+  resolveBelongsToManyTargetValue(entity, relation) {
     if (!entity) return null;
-    const key = findPrimaryKey(table);
+    const key = relation.targetKey || findPrimaryKey(relation.target);
     const value = entity[key];
     if (value === void 0 || value === null) return null;
     return value ?? null;