arkormx 2.0.0-next.20 → 2.0.0-next.21

package/dist/index.cjs

@@ -9154,6 +9154,277 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 			conditions: [baseCondition, this.pivotWhere]
 		};
 	}
+	buildPivotTarget() {
+		return {
+			table: this.throughDelegate,
+			primaryKey: this.relatedPivotKey
+		};
+	}
+	buildRelatedPivotCondition(relatedValues) {
+		const normalizedValues = relatedValues.filter((value) => value != null);
+		if (normalizedValues.length === 0) return null;
+		if (normalizedValues.length === 1) return {
+			type: "comparison",
+			column: this.relatedPivotKey,
+			operator: "=",
+			value: normalizedValues[0]
+		};
+		return {
+			type: "comparison",
+			column: this.relatedPivotKey,
+			operator: "in",
+			value: normalizedValues
+		};
+	}
+	buildPivotMutationWhere(relatedValues = []) {
+		const baseCondition = this.buildPivotWhere(this.resolveParentPivotValue());
+		const relatedCondition = this.buildRelatedPivotCondition(relatedValues);
+		if (!relatedCondition) return baseCondition;
+		return {
+			type: "group",
+			operator: "and",
+			conditions: [baseCondition, relatedCondition]
+		};
+	}
+	normalizeIdentifierValue(value) {
+		if (typeof value === "string" && /^-?\d+$/.test(value)) return Number(value);
+		return value;
+	}
+	isPlainObject(value) {
+		return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+	}
+	isModelLike(value) {
+		return this.isPlainObject(value) && typeof value.getAttribute === "function";
+	}
+	normalizeRelatedItems(related) {
+		return Array.isArray(related) ? related : [related];
+	}
+	normalizeSyncEntries(related, pivotAttributes = {}) {
+		if (Array.isArray(related)) return related.map((item) => ({
+			related: item,
+			attributes: { ...pivotAttributes }
+		}));
+		if (this.isPlainObject(related) && !this.isModelLike(related)) return Object.entries(related).map(([key, attributes]) => ({
+			related: this.normalizeIdentifierValue(key),
+			attributes: this.isPlainObject(attributes) ? attributes : {}
+		}));
+		return [{
+			related,
+			attributes: { ...pivotAttributes }
+		}];
+	}
+	resolveParentPivotValue() {
+		return this.parent.getAttribute(this.parentKey);
+	}
+	resolveRelatedPivotValue(related) {
+		if (related && typeof related === "object" && "getAttribute" in related) return related.getAttribute(this.relatedKey);
+		return related;
+	}
+	buildPivotInsertValues(related, attributes = {}) {
+		const values = {
+			...attributes,
+			[this.foreignPivotKey]: this.resolveParentPivotValue(),
+			[this.relatedPivotKey]: this.resolveRelatedPivotValue(related)
+		};
+		if (this.pivotCreatedAtColumn && !(this.pivotCreatedAtColumn in values)) values[this.pivotCreatedAtColumn] = /* @__PURE__ */ new Date();
+		if (this.pivotUpdatedAtColumn && !(this.pivotUpdatedAtColumn in values)) values[this.pivotUpdatedAtColumn] = /* @__PURE__ */ new Date();
+		return values;
+	}
+	attachPivotToSingleResult(related, pivotRow) {
+		if (!this.shouldAttachPivotAttributes()) return related;
+		related.setAttribute(this.pivotAccessor, this.createPivotRecord(pivotRow));
+		return related;
+	}
+	async insertPivotRow(values, adapter = this.getRelationAdapter()) {
+		await adapter.insert({
+			target: this.buildPivotTarget(),
+			values
+		});
+	}
+	async selectPivotRows(where, adapter = this.getRelationAdapter()) {
+		return await adapter.select({
+			target: this.buildPivotTarget(),
+			where
+		});
+	}
+	async deletePivotRows(where, adapter = this.getRelationAdapter()) {
+		if (typeof adapter.deleteMany === "function") return await adapter.deleteMany({
+			target: this.buildPivotTarget(),
+			where
+		});
+		const rows = await this.selectPivotRows(where, adapter);
+		await Promise.all(rows.map(async (row) => {
+			await adapter.delete({
+				target: this.buildPivotTarget(),
+				where: {
+					type: "group",
+					operator: "and",
+					conditions: Object.entries(row).map(([column, value]) => ({
+						type: "comparison",
+						column,
+						operator: "=",
+						value
+					}))
+				}
+			});
+		}));
+		return rows.length;
+	}
+	buildPivotUpdateValues(attributes = {}) {
+		const values = { ...attributes };
+		if (this.pivotUpdatedAtColumn && !(this.pivotUpdatedAtColumn in values)) values[this.pivotUpdatedAtColumn] = /* @__PURE__ */ new Date();
+		return values;
+	}
+	async updatePivotRows(related, attributes, adapter = this.getRelationAdapter()) {
+		const values = this.buildPivotUpdateValues(attributes);
+		if (Object.keys(values).length === 0) return 0;
+		const where = this.buildPivotMutationWhere([this.resolveRelatedPivotValue(related)]);
+		if (typeof adapter.updateMany === "function") return await adapter.updateMany({
+			target: this.buildPivotTarget(),
+			where,
+			values
+		});
+		const rows = await this.selectPivotRows(where, adapter);
+		await Promise.all(rows.map(async (row) => {
+			await adapter.update({
+				target: this.buildPivotTarget(),
+				where: {
+					type: "group",
+					operator: "and",
+					conditions: Object.entries(row).map(([column, value]) => ({
+						type: "comparison",
+						column,
+						operator: "=",
+						value
+					}))
+				},
+				values
+			});
+		}));
+		return rows.length;
+	}
+	/**
+	* Creates a new instance of the related model with the given attributes and attaches 
+	* pivot attributes if pivot attributes should be included.
+	* 
+	* @param attributes    The attributes to initialize the related model with.
+	* @returns             A new instance of the related model.
+	*/
+	make(attributes = {}) {
+		return this.related.hydrate(attributes);
+	}
+	/**
+	* Creates a new related model record with the given attributes, creates a pivot record 
+	* with the given pivot attributes, and attaches pivot attributes if pivot attributes 
+	* should be included.
+	* 
+	* @param attributes        The attributes to initialize the related model with.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 A new instance of the related model with pivot attributes attached.
+	*/
+	async create(attributes = {}, pivotAttributes = {}) {
+		const related = await this.related.query().create(attributes);
+		const pivotRow = this.buildPivotInsertValues(related, pivotAttributes);
+		await this.insertPivotRow(pivotRow);
+		return this.attachPivotToSingleResult(related, pivotRow);
+	}
+	/**
+	* Saves a related model record, creates a pivot record with the given pivot attributes 
+	* if the related model was not previously persisted, and attaches pivot attributes if 
+	* pivot attributes should be included.
+	* 
+	* @param related           The related model instance to save.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 A new instance of the related model with pivot attributes attached.
+	*/
+	async save(related, pivotAttributes = {}) {
+		const saveable = related;
+		let persisted = related;
+		if (typeof saveable.save === "function") try {
+			persisted = await saveable.save();
+		} catch (error) {
+			if (!(typeof error === "object" && error !== null && "code" in error && error.code === "MODEL_NOT_FOUND")) throw error;
+			const attributes = typeof saveable.getRawAttributes === "function" ? saveable.getRawAttributes() : {};
+			persisted = await this.related.query().create(attributes);
+		}
+		const pivotRow = this.buildPivotInsertValues(persisted, pivotAttributes);
+		await this.insertPivotRow(pivotRow);
+		return this.attachPivotToSingleResult(persisted, pivotRow);
+	}
+	/**
+	* Attaches one or more related model records to the parent model by creating pivot 
+	* records with the given pivot attributes if pivot attributes should be included.
+	* 
+	* @param related           The related model instance(s) to attach.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 The number of related model records attached.
+	*/
+	async attach(related, pivotAttributes = {}) {
+		const items = Array.isArray(related) ? related : [related];
+		await Promise.all(items.map(async (item) => {
+			await this.insertPivotRow(this.buildPivotInsertValues(item, pivotAttributes));
+		}));
+		return items.length;
+	}
+	/**
+	* Detaches one or more related model records from the parent model by deleting
+	* matching pivot rows. When no related value is provided, all matching pivot rows
+	* for the parent are removed.
+	*
+	* @param related
+	* @returns
+	*/
+	async detach(related) {
+		const where = related === void 0 ? this.buildPivotWhere(this.resolveParentPivotValue()) : this.buildPivotMutationWhere(this.normalizeRelatedItems(related).map((item) => this.resolveRelatedPivotValue(item)));
+		return await this.deletePivotRows(where);
+	}
+	/**
+	* Synchronizes the pivot table so only the provided related values remain attached.
+	* Existing matching rows can receive updated pivot attributes during the operation.
+	*
+	* @param related
+	* @param pivotAttributes
+	* @returns
+	*/
+	async sync(related, pivotAttributes = {}) {
+		return await this.getRelationAdapter().transaction(async (transaction) => {
+			const existingRows = await this.selectPivotRows(this.buildPivotWhere(this.resolveParentPivotValue()), transaction);
+			const desiredEntries = /* @__PURE__ */ new Map();
+			this.normalizeSyncEntries(related, pivotAttributes).forEach((entry) => {
+				const relatedValue = this.resolveRelatedPivotValue(entry.related);
+				if (relatedValue == null) return;
+				desiredEntries.set(String(relatedValue), {
+					related: relatedValue,
+					attributes: entry.attributes
+				});
+			});
+			let detached = 0;
+			let attached = 0;
+			let updated = 0;
+			const existingKeys = /* @__PURE__ */ new Set();
+			for (const row of existingRows) {
+				const relatedValue = row[this.relatedPivotKey];
+				if (relatedValue == null) continue;
+				const relatedKey = String(relatedValue);
+				existingKeys.add(relatedKey);
+				if (!desiredEntries.has(relatedKey)) detached += await this.deletePivotRows(this.buildPivotMutationWhere([relatedValue]), transaction);
+			}
+			for (const [relatedKey, entry] of desiredEntries) {
+				if (!existingKeys.has(relatedKey)) {
+					await this.insertPivotRow(this.buildPivotInsertValues(entry.related, entry.attributes), transaction);
+					attached += 1;
+					continue;
+				}
+				if (Object.keys(entry.attributes).length === 0) continue;
+				updated += await this.updatePivotRows(entry.related, entry.attributes, transaction);
+			}
+			return {
+				attached,
+				detached,
+				updated
+			};
+		});
+	}
 	shouldAttachPivotAttributes() {
 		return this.shouldAttachPivot || this.pivotColumns.size > 0 || Boolean(this.pivotCreatedAtColumn) || Boolean(this.pivotUpdatedAtColumn) || Boolean(this.pivotModel);
 	}
@@ -9239,7 +9510,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return query;
 	}
 	async loadPivotRowsForParent() {
-		const parentValue = this.parent.getAttribute(this.parentKey);
+		const parentValue = this.resolveParentPivotValue();
 		return await this.createRelationTableLoader().selectRows({
 			table: this.throughDelegate,
 			where: this.buildPivotWhere(parentValue),

package/dist/index.d.cts

@@ -791,6 +791,82 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   private addPivotWhere;
   private makePivotComparison;
   private buildPivotWhere;
+  private buildPivotTarget;
+  private buildRelatedPivotCondition;
+  private buildPivotMutationWhere;
+  private normalizeIdentifierValue;
+  private isPlainObject;
+  private isModelLike;
+  private normalizeRelatedItems;
+  private normalizeSyncEntries;
+  private resolveParentPivotValue;
+  private resolveRelatedPivotValue;
+  private buildPivotInsertValues;
+  private attachPivotToSingleResult;
+  private insertPivotRow;
+  private selectPivotRows;
+  private deletePivotRows;
+  private buildPivotUpdateValues;
+  private updatePivotRows;
+  /**
+   * Creates a new instance of the related model with the given attributes and attaches
+   * pivot attributes if pivot attributes should be included.
+   *
+   * @param attributes    The attributes to initialize the related model with.
+   * @returns             A new instance of the related model.
+   */
+  make(attributes?: Record<string, unknown>): TRelated;
+  /**
+   * Creates a new related model record with the given attributes, creates a pivot record
+   * with the given pivot attributes, and attaches pivot attributes if pivot attributes
+   * should be included.
+   *
+   * @param attributes        The attributes to initialize the related model with.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 A new instance of the related model with pivot attributes attached.
+   */
+  create(attributes?: Record<string, unknown>, pivotAttributes?: Record<string, unknown>): Promise<TRelated>;
+  /**
+   * Saves a related model record, creates a pivot record with the given pivot attributes
+   * if the related model was not previously persisted, and attaches pivot attributes if
+   * pivot attributes should be included.
+   *
+   * @param related           The related model instance to save.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 A new instance of the related model with pivot attributes attached.
+   */
+  save(related: TRelated, pivotAttributes?: Record<string, unknown>): Promise<TRelated>;
+  /**
+   * Attaches one or more related model records to the parent model by creating pivot
+   * records with the given pivot attributes if pivot attributes should be included.
+   *
+   * @param related           The related model instance(s) to attach.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 The number of related model records attached.
+   */
+  attach(related: TRelated | unknown | Array<TRelated | unknown>, pivotAttributes?: Record<string, unknown>): Promise<number>;
+  /**
+   * Detaches one or more related model records from the parent model by deleting
+   * matching pivot rows. When no related value is provided, all matching pivot rows
+   * for the parent are removed.
+   *
+   * @param related
+   * @returns
+   */
+  detach(related?: TRelated | unknown | Array<TRelated | unknown>): Promise<number>;
+  /**
+   * Synchronizes the pivot table so only the provided related values remain attached.
+   * Existing matching rows can receive updated pivot attributes during the operation.
+   *
+   * @param related
+   * @param pivotAttributes
+   * @returns
+   */
+  sync(related: TRelated | unknown | Array<TRelated | unknown> | Record<string, Record<string, unknown>>, pivotAttributes?: Record<string, unknown>): Promise<{
+    attached: number;
+    detached: number;
+    updated: number;
+  }>;
   private shouldAttachPivotAttributes;
   private getPivotColumnSelection;
   /**
@@ -1343,7 +1419,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param this
    * @returns
    */
-  static query<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static query<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Boot hook for subclasses to register scopes or perform one-time setup.
    */
@@ -1358,14 +1434,14 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param this
    * @returns
    */
-  static withTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static withTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Get a query builder instance that only includes soft-deleted records.
    *
    * @param this
    * @returns
    */
-  static onlyTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static onlyTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Get a query builder instance that excludes soft-deleted records.
    * This is the default behavior of the query builder, but this method can be used
@@ -1376,7 +1452,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param args
    * @returns
    */
-  static scope<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis, name: string, ...args: unknown[]): QueryBuilder<TModel, TDelegate>;
+  static scope<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis, name: string, ...args: unknown[]): QueryBuilder<TModel, TDelegate>;
   /**
    * Get the soft delete configuration for the model, including whether
    * soft deletes are enabled and the name of the deleted at column.
@@ -1431,9 +1507,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param key
    * @returns
    */
-  getAttribute<TKey extends ModelRelationshipKey<this>>(key: TKey): ModelRelationshipResult<this, TKey>;
-  getAttribute<TKey extends keyof this & string>(key: TKey): this[TKey] extends ((...args: any[]) => any) ? unknown : this[TKey];
-  getAttribute<TKey extends keyof TAttributes & string>(key: TKey): TAttributes[TKey];
+  getAttribute<TSelf extends this, TKey extends string>(this: TSelf, key: TKey): ModelAttributeValue<TSelf, TAttributes, TKey>;
   getAttribute(key: string): unknown;
   /**
    * Set the value of an attribute, applying any set mutators or casts if defined.
@@ -1442,9 +1516,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param value
    * @returns
    */
-  setAttribute<TKey extends ModelRelationshipKey<this>>(key: TKey, value: ModelRelationshipResult<this, TKey>): this;
-  setAttribute<TKey extends keyof this & string>(key: TKey, value: this[TKey] extends ((...args: any[]) => any) ? never : this[TKey]): this;
-  setAttribute<TKey extends keyof TAttributes & string>(key: TKey, value: TAttributes[TKey]): this;
+  setAttribute<TSelf extends this, TKey extends string>(this: TSelf, key: TKey, value: ModelAttributeValue<TSelf, TAttributes, TKey>): this;
   setAttribute(key: string, value: unknown): this;
   /**
    * Save the model to the database.
@@ -1869,11 +1941,14 @@ interface AttributeSchemaDelegate<TAttributes extends Record<string, unknown>> e
 type DelegateForModelSchema<TSchema extends PrismaDelegateLike | Record<string, unknown> | string, TAttributes extends Record<string, unknown> = ModelAttributesOf<TSchema>> = TSchema extends PrismaDelegateLike ? TSchema : TSchema extends string ? DelegateFromPrismaClient<TSchema> extends PrismaDelegateLike ? DelegateFromPrismaClient<TSchema> : PrismaDelegateLike : AttributeSchemaDelegate<TAttributes>;
 type ModelAttributesOf<TSchema extends PrismaDelegateLike | Record<string, unknown> | string> = TSchema extends PrismaDelegateLike ? DelegateRow<TSchema> extends Record<string, unknown> ? DelegateRow<TSchema> : Record<string, any> : TSchema extends string ? DelegateFromPrismaClient<TSchema> extends PrismaDelegateLike ? DelegateRow<DelegateFromPrismaClient<TSchema>> extends Record<string, unknown> ? DelegateRow<DelegateFromPrismaClient<TSchema>> : Record<string, any> : Record<string, any> : TSchema extends Record<string, unknown> ? TSchema : Record<string, any>;
 type ModelAttributes<TModel> = TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>;
+type BaseModelInstance = Model<any, any>;
+type ModelDeclaredAttributeKey<TModel> = { [TKey in keyof TModel & string]: TKey extends keyof BaseModelInstance ? never : TModel[TKey] extends ((...args: any[]) => any) ? never : TKey }[keyof TModel & string];
 type RelationshipResultProvider<TResult = unknown> = {
   getResults: (...args: any[]) => Promise<TResult>;
 };
-type ModelRelationshipKey<TModel> = { [TKey in keyof TModel & string]: TModel[TKey] extends ((...args: any[]) => infer TReturn) ? TReturn extends RelationshipResultProvider<any> ? TKey : never : never }[keyof TModel & string];
+type ModelRelationshipKey<TModel> = { [TKey in keyof TModel & string]: TKey extends keyof BaseModelInstance ? never : TModel[TKey] extends ((...args: any[]) => infer TReturn) ? Parameters<TModel[TKey]> extends [] ? TReturn extends RelationshipResultProvider<any> ? TKey : never : never : never }[keyof TModel & string];
 type ModelRelationshipResult<TModel, TKey extends ModelRelationshipKey<TModel>> = TModel[TKey] extends ((...args: any[]) => infer TReturn) ? TReturn extends RelationshipResultProvider<infer TResult> ? TResult : never : never;
+type ModelAttributeValue<TModel, TAttributes extends Record<string, unknown>, TKey extends string> = TKey extends ModelRelationshipKey<TModel> ? ModelRelationshipResult<TModel, TKey> : TKey extends ModelDeclaredAttributeKey<TModel> ? TModel[TKey] : TKey extends keyof TAttributes & string ? TAttributes[TKey] : unknown;
 type ModelCreateData<TModel, TDelegate extends PrismaDelegateLike> = TModel extends Model<any, infer TAttributes> ? TDelegate extends AttributeSchemaDelegate<TAttributes> ? AttributeCreateInput<TAttributes> : DelegateCreateData<TDelegate> : DelegateCreateData<TDelegate>;
 type ModelUpdateData<TModel, TDelegate extends PrismaDelegateLike> = TModel extends Model<any, infer TAttributes> ? TDelegate extends AttributeSchemaDelegate<TAttributes> ? AttributeUpdateInput<TAttributes> : DelegateUpdateData<TDelegate> : DelegateUpdateData<TDelegate>;
 type RelatedModelClass<TInstance = unknown> = (abstract new (attributes?: Record<string, unknown>) => TInstance) & RelationshipModelStatic;
@@ -4983,4 +5058,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { AdapterBindableModel, AdapterCapabilities, AdapterCapability, AdapterInspectionRequest, AdapterModelFieldStructure, AdapterModelIntrospectionOptions, AdapterModelStructure, AdapterQueryInspection, AdapterQueryOperation, AdapterTransactionContext, AggregateOperation, AggregateSelection, AggregateSpec, AppliedMigrationEntry, AppliedMigrationRun, AppliedMigrationsState, ArkormBootContext, ArkormCollection, ArkormConfig, ArkormDebugEvent, ArkormDebugHandler, ArkormErrorContext, ArkormException, Attribute, AttributeCreateInput, AttributeOptions, AttributeOrderBy, AttributeSchemaDelegate, AttributeSelect, AttributeUpdateInput, AttributeWhereInput, BelongsToManyRelationMetadata, BelongsToRelationMetadata, CastDefinition, CastHandler, CastMap, CastType, CliApp, ClientResolver, ColumnMap, DB, DatabaseAdapter, DatabasePrimitive, DatabaseRow, DatabaseRows, DatabaseTableOptions, DatabaseTablePersistedMetadataOptions, DatabaseValue, DelegateCreateData, DelegateFindManyArgs, DelegateForModelSchema, DelegateInclude, DelegateOrderBy, DelegateRow, DelegateRows, DelegateSelect, DelegateUniqueWhere, DelegateUpdateArgs, DelegateUpdateData, DelegateWhere, DeleteManySpec, DeleteSpec, EagerLoadConstraint, EagerLoadMap, EnumBuilder, FactoryAttributes, FactoryDefinition, FactoryModelConstructor, FactoryState, ForeignKeyBuilder, GenerateMigrationOptions, GeneratedMigrationFile, GetUserConfig, GlobalScope, HasManyRelationMetadata, HasManyThroughRelationMetadata, HasOneRelationMetadata, HasOneThroughRelationMetadata, InitCommand, InlineFactory, InsertManySpec, InsertSpec, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationClass, MigrationHistoryCommand, MigrationInstanceLike, MissingDelegateException, Model, ModelAttributes, ModelAttributesOf, ModelCreateData, ModelEventDispatcher, ModelEventHandler, ModelEventHandlerConstructor, ModelEventListener, ModelEventName, ModelFactory, ModelLifecycleState, ModelMetadata, ModelNotFoundException, ModelRelationshipKey, ModelRelationshipResult, ModelStatic, ModelUpdateData, ModelsSyncCommand, MorphManyRelationMetadata, MorphOneRelationMetadata, MorphToManyRelationMetadata, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, PaginationCurrentPageResolver, PaginationMeta, PaginationOptions, PaginationURLDriver, PaginationURLDriverFactory, Paginator, PersistedColumnMappingsState, PersistedMetadataFeatures, PersistedPrimaryKeyGeneration, PersistedTableMetadata, PersistedTimestampColumn, PivotModel, PivotModelStatic, PrimaryKeyGeneration, PrimaryKeyGenerationPlanner, PrismaClientLike, PrismaDatabaseAdapter, PrismaDelegateLike, PrismaDelegateMap, PrismaDelegateNameMapping, PrismaFindManyArgsLike, PrismaLikeInclude, PrismaLikeOrderBy, PrismaLikeScalarFilter, PrismaLikeSelect, PrismaLikeSortOrder, PrismaLikeWhereInput, PrismaMigrationWorkflowOptions, PrismaSchemaSyncOptions, PrismaTransactionCallback, PrismaTransactionCapableClient, PrismaTransactionOptions, QueryBuilder, QueryComparisonCondition, QueryComparisonOperator, QueryCondition, QueryConstraintException, QueryExecutionException, QueryExecutionExceptionContext, QueryGroupCondition, QueryLogicalOperator, QueryNotCondition, QueryOrderBy, QueryRawCondition, QuerySelectColumn, QueryTarget, RelatedModelClass, RelationAggregateSpec, RelationColumnLookupSpec, RelationConstraint, RelationDefaultResolver, RelationDefaultValue, RelationFilterSpec, RelationLoadPlan, RelationLoadSpec, RelationMetadata, RelationMetadataProvider, RelationMetadataType, RelationResolutionException, RelationTableLookupSpec, RelationshipModelStatic, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, SchemaColumn, SchemaColumnType, SchemaForeignKey, SchemaForeignKeyAction, SchemaIndex, SchemaOperation, SchemaTableAlterOperation, SchemaTableCreateOperation, SchemaTableDropOperation, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, SelectSpec, Serializable, SimplePaginationMeta, SoftDeleteConfig, SoftDeleteQueryMode, SortDirection, TableBuilder, TimestampColumnBehavior, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, UpdateManySpec, UpdateSpec, UpsertSpec, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRuntimeAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, validatePersistedMetadataFeaturesForMigrations, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };
+export { AdapterBindableModel, AdapterCapabilities, AdapterCapability, AdapterInspectionRequest, AdapterModelFieldStructure, AdapterModelIntrospectionOptions, AdapterModelStructure, AdapterQueryInspection, AdapterQueryOperation, AdapterTransactionContext, AggregateOperation, AggregateSelection, AggregateSpec, AppliedMigrationEntry, AppliedMigrationRun, AppliedMigrationsState, ArkormBootContext, ArkormCollection, ArkormConfig, ArkormDebugEvent, ArkormDebugHandler, ArkormErrorContext, ArkormException, Attribute, AttributeCreateInput, AttributeOptions, AttributeOrderBy, AttributeSchemaDelegate, AttributeSelect, AttributeUpdateInput, AttributeWhereInput, BelongsToManyRelationMetadata, BelongsToRelationMetadata, CastDefinition, CastHandler, CastMap, CastType, CliApp, ClientResolver, ColumnMap, DB, DatabaseAdapter, DatabasePrimitive, DatabaseRow, DatabaseRows, DatabaseTableOptions, DatabaseTablePersistedMetadataOptions, DatabaseValue, DelegateCreateData, DelegateFindManyArgs, DelegateForModelSchema, DelegateInclude, DelegateOrderBy, DelegateRow, DelegateRows, DelegateSelect, DelegateUniqueWhere, DelegateUpdateArgs, DelegateUpdateData, DelegateWhere, DeleteManySpec, DeleteSpec, EagerLoadConstraint, EagerLoadMap, EnumBuilder, FactoryAttributes, FactoryDefinition, FactoryModelConstructor, FactoryState, ForeignKeyBuilder, GenerateMigrationOptions, GeneratedMigrationFile, GetUserConfig, GlobalScope, HasManyRelationMetadata, HasManyThroughRelationMetadata, HasOneRelationMetadata, HasOneThroughRelationMetadata, InitCommand, InlineFactory, InsertManySpec, InsertSpec, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationClass, MigrationHistoryCommand, MigrationInstanceLike, MissingDelegateException, Model, ModelAttributeValue, ModelAttributes, ModelAttributesOf, ModelCreateData, ModelDeclaredAttributeKey, ModelEventDispatcher, ModelEventHandler, ModelEventHandlerConstructor, ModelEventListener, ModelEventName, ModelFactory, ModelLifecycleState, ModelMetadata, ModelNotFoundException, ModelRelationshipKey, ModelRelationshipResult, ModelStatic, ModelUpdateData, ModelsSyncCommand, MorphManyRelationMetadata, MorphOneRelationMetadata, MorphToManyRelationMetadata, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, PaginationCurrentPageResolver, PaginationMeta, PaginationOptions, PaginationURLDriver, PaginationURLDriverFactory, Paginator, PersistedColumnMappingsState, PersistedMetadataFeatures, PersistedPrimaryKeyGeneration, PersistedTableMetadata, PersistedTimestampColumn, PivotModel, PivotModelStatic, PrimaryKeyGeneration, PrimaryKeyGenerationPlanner, PrismaClientLike, PrismaDatabaseAdapter, PrismaDelegateLike, PrismaDelegateMap, PrismaDelegateNameMapping, PrismaFindManyArgsLike, PrismaLikeInclude, PrismaLikeOrderBy, PrismaLikeScalarFilter, PrismaLikeSelect, PrismaLikeSortOrder, PrismaLikeWhereInput, PrismaMigrationWorkflowOptions, PrismaSchemaSyncOptions, PrismaTransactionCallback, PrismaTransactionCapableClient, PrismaTransactionOptions, QueryBuilder, QueryComparisonCondition, QueryComparisonOperator, QueryCondition, QueryConstraintException, QueryExecutionException, QueryExecutionExceptionContext, QueryGroupCondition, QueryLogicalOperator, QueryNotCondition, QueryOrderBy, QueryRawCondition, QuerySelectColumn, QueryTarget, RelatedModelClass, RelationAggregateSpec, RelationColumnLookupSpec, RelationConstraint, RelationDefaultResolver, RelationDefaultValue, RelationFilterSpec, RelationLoadPlan, RelationLoadSpec, RelationMetadata, RelationMetadataProvider, RelationMetadataType, RelationResolutionException, RelationTableLookupSpec, RelationshipModelStatic, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, SchemaColumn, SchemaColumnType, SchemaForeignKey, SchemaForeignKeyAction, SchemaIndex, SchemaOperation, SchemaTableAlterOperation, SchemaTableCreateOperation, SchemaTableDropOperation, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, SelectSpec, Serializable, SimplePaginationMeta, SoftDeleteConfig, SoftDeleteQueryMode, SortDirection, TableBuilder, TimestampColumnBehavior, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, UpdateManySpec, UpdateSpec, UpsertSpec, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRuntimeAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, validatePersistedMetadataFeaturesForMigrations, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };

package/dist/index.d.mts

@@ -791,6 +791,82 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   private addPivotWhere;
   private makePivotComparison;
   private buildPivotWhere;
+  private buildPivotTarget;
+  private buildRelatedPivotCondition;
+  private buildPivotMutationWhere;
+  private normalizeIdentifierValue;
+  private isPlainObject;
+  private isModelLike;
+  private normalizeRelatedItems;
+  private normalizeSyncEntries;
+  private resolveParentPivotValue;
+  private resolveRelatedPivotValue;
+  private buildPivotInsertValues;
+  private attachPivotToSingleResult;
+  private insertPivotRow;
+  private selectPivotRows;
+  private deletePivotRows;
+  private buildPivotUpdateValues;
+  private updatePivotRows;
+  /**
+   * Creates a new instance of the related model with the given attributes and attaches
+   * pivot attributes if pivot attributes should be included.
+   *
+   * @param attributes    The attributes to initialize the related model with.
+   * @returns             A new instance of the related model.
+   */
+  make(attributes?: Record<string, unknown>): TRelated;
+  /**
+   * Creates a new related model record with the given attributes, creates a pivot record
+   * with the given pivot attributes, and attaches pivot attributes if pivot attributes
+   * should be included.
+   *
+   * @param attributes        The attributes to initialize the related model with.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 A new instance of the related model with pivot attributes attached.
+   */
+  create(attributes?: Record<string, unknown>, pivotAttributes?: Record<string, unknown>): Promise<TRelated>;
+  /**
+   * Saves a related model record, creates a pivot record with the given pivot attributes
+   * if the related model was not previously persisted, and attaches pivot attributes if
+   * pivot attributes should be included.
+   *
+   * @param related           The related model instance to save.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 A new instance of the related model with pivot attributes attached.
+   */
+  save(related: TRelated, pivotAttributes?: Record<string, unknown>): Promise<TRelated>;
+  /**
+   * Attaches one or more related model records to the parent model by creating pivot
+   * records with the given pivot attributes if pivot attributes should be included.
+   *
+   * @param related           The related model instance(s) to attach.
+   * @param pivotAttributes   The attributes to initialize the pivot record with.
+   * @returns                 The number of related model records attached.
+   */
+  attach(related: TRelated | unknown | Array<TRelated | unknown>, pivotAttributes?: Record<string, unknown>): Promise<number>;
+  /**
+   * Detaches one or more related model records from the parent model by deleting
+   * matching pivot rows. When no related value is provided, all matching pivot rows
+   * for the parent are removed.
+   *
+   * @param related
+   * @returns
+   */
+  detach(related?: TRelated | unknown | Array<TRelated | unknown>): Promise<number>;
+  /**
+   * Synchronizes the pivot table so only the provided related values remain attached.
+   * Existing matching rows can receive updated pivot attributes during the operation.
+   *
+   * @param related
+   * @param pivotAttributes
+   * @returns
+   */
+  sync(related: TRelated | unknown | Array<TRelated | unknown> | Record<string, Record<string, unknown>>, pivotAttributes?: Record<string, unknown>): Promise<{
+    attached: number;
+    detached: number;
+    updated: number;
+  }>;
   private shouldAttachPivotAttributes;
   private getPivotColumnSelection;
   /**
@@ -1343,7 +1419,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param this
    * @returns
    */
-  static query<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static query<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Boot hook for subclasses to register scopes or perform one-time setup.
    */
@@ -1358,14 +1434,14 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param this
    * @returns
    */
-  static withTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static withTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Get a query builder instance that only includes soft-deleted records.
    *
    * @param this
    * @returns
    */
-  static onlyTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
+  static onlyTrashed<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis): QueryBuilder<TModel, TDelegate>;
   /**
    * Get a query builder instance that excludes soft-deleted records.
    * This is the default behavior of the query builder, but this method can be used
@@ -1376,7 +1452,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param args
    * @returns
    */
-  static scope<TThis extends abstract new (attributes?: Record<string, unknown>) => Model<any>, TModel extends InstanceType<TThis> = InstanceType<TThis>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis, name: string, ...args: unknown[]): QueryBuilder<TModel, TDelegate>;
+  static scope<TThis extends abstract new (attributes?: Record<string, unknown>) => unknown, TModel extends Model<any, any> = InstanceType<TThis> & Model<any, any>, TDelegate extends PrismaDelegateLike = DelegateForModelSchema<TModel extends Model<infer TSchema, any> ? TSchema : Record<string, any>, TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>>>(this: TThis, name: string, ...args: unknown[]): QueryBuilder<TModel, TDelegate>;
   /**
    * Get the soft delete configuration for the model, including whether
    * soft deletes are enabled and the name of the deleted at column.
@@ -1431,9 +1507,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param key
    * @returns
    */
-  getAttribute<TKey extends ModelRelationshipKey<this>>(key: TKey): ModelRelationshipResult<this, TKey>;
-  getAttribute<TKey extends keyof this & string>(key: TKey): this[TKey] extends ((...args: any[]) => any) ? unknown : this[TKey];
-  getAttribute<TKey extends keyof TAttributes & string>(key: TKey): TAttributes[TKey];
+  getAttribute<TSelf extends this, TKey extends string>(this: TSelf, key: TKey): ModelAttributeValue<TSelf, TAttributes, TKey>;
   getAttribute(key: string): unknown;
   /**
    * Set the value of an attribute, applying any set mutators or casts if defined.
@@ -1442,9 +1516,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param value
    * @returns
    */
-  setAttribute<TKey extends ModelRelationshipKey<this>>(key: TKey, value: ModelRelationshipResult<this, TKey>): this;
-  setAttribute<TKey extends keyof this & string>(key: TKey, value: this[TKey] extends ((...args: any[]) => any) ? never : this[TKey]): this;
-  setAttribute<TKey extends keyof TAttributes & string>(key: TKey, value: TAttributes[TKey]): this;
+  setAttribute<TSelf extends this, TKey extends string>(this: TSelf, key: TKey, value: ModelAttributeValue<TSelf, TAttributes, TKey>): this;
   setAttribute(key: string, value: unknown): this;
   /**
    * Save the model to the database.
@@ -1869,11 +1941,14 @@ interface AttributeSchemaDelegate<TAttributes extends Record<string, unknown>> e
 type DelegateForModelSchema<TSchema extends PrismaDelegateLike | Record<string, unknown> | string, TAttributes extends Record<string, unknown> = ModelAttributesOf<TSchema>> = TSchema extends PrismaDelegateLike ? TSchema : TSchema extends string ? DelegateFromPrismaClient<TSchema> extends PrismaDelegateLike ? DelegateFromPrismaClient<TSchema> : PrismaDelegateLike : AttributeSchemaDelegate<TAttributes>;
 type ModelAttributesOf<TSchema extends PrismaDelegateLike | Record<string, unknown> | string> = TSchema extends PrismaDelegateLike ? DelegateRow<TSchema> extends Record<string, unknown> ? DelegateRow<TSchema> : Record<string, any> : TSchema extends string ? DelegateFromPrismaClient<TSchema> extends PrismaDelegateLike ? DelegateRow<DelegateFromPrismaClient<TSchema>> extends Record<string, unknown> ? DelegateRow<DelegateFromPrismaClient<TSchema>> : Record<string, any> : Record<string, any> : TSchema extends Record<string, unknown> ? TSchema : Record<string, any>;
 type ModelAttributes<TModel> = TModel extends Model<any, infer TAttributes> ? TAttributes : Record<string, any>;
+type BaseModelInstance = Model<any, any>;
+type ModelDeclaredAttributeKey<TModel> = { [TKey in keyof TModel & string]: TKey extends keyof BaseModelInstance ? never : TModel[TKey] extends ((...args: any[]) => any) ? never : TKey }[keyof TModel & string];
 type RelationshipResultProvider<TResult = unknown> = {
   getResults: (...args: any[]) => Promise<TResult>;
 };
-type ModelRelationshipKey<TModel> = { [TKey in keyof TModel & string]: TModel[TKey] extends ((...args: any[]) => infer TReturn) ? TReturn extends RelationshipResultProvider<any> ? TKey : never : never }[keyof TModel & string];
+type ModelRelationshipKey<TModel> = { [TKey in keyof TModel & string]: TKey extends keyof BaseModelInstance ? never : TModel[TKey] extends ((...args: any[]) => infer TReturn) ? Parameters<TModel[TKey]> extends [] ? TReturn extends RelationshipResultProvider<any> ? TKey : never : never : never }[keyof TModel & string];
 type ModelRelationshipResult<TModel, TKey extends ModelRelationshipKey<TModel>> = TModel[TKey] extends ((...args: any[]) => infer TReturn) ? TReturn extends RelationshipResultProvider<infer TResult> ? TResult : never : never;
+type ModelAttributeValue<TModel, TAttributes extends Record<string, unknown>, TKey extends string> = TKey extends ModelRelationshipKey<TModel> ? ModelRelationshipResult<TModel, TKey> : TKey extends ModelDeclaredAttributeKey<TModel> ? TModel[TKey] : TKey extends keyof TAttributes & string ? TAttributes[TKey] : unknown;
 type ModelCreateData<TModel, TDelegate extends PrismaDelegateLike> = TModel extends Model<any, infer TAttributes> ? TDelegate extends AttributeSchemaDelegate<TAttributes> ? AttributeCreateInput<TAttributes> : DelegateCreateData<TDelegate> : DelegateCreateData<TDelegate>;
 type ModelUpdateData<TModel, TDelegate extends PrismaDelegateLike> = TModel extends Model<any, infer TAttributes> ? TDelegate extends AttributeSchemaDelegate<TAttributes> ? AttributeUpdateInput<TAttributes> : DelegateUpdateData<TDelegate> : DelegateUpdateData<TDelegate>;
 type RelatedModelClass<TInstance = unknown> = (abstract new (attributes?: Record<string, unknown>) => TInstance) & RelationshipModelStatic;
@@ -4983,4 +5058,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { AdapterBindableModel, AdapterCapabilities, AdapterCapability, AdapterInspectionRequest, AdapterModelFieldStructure, AdapterModelIntrospectionOptions, AdapterModelStructure, AdapterQueryInspection, AdapterQueryOperation, AdapterTransactionContext, AggregateOperation, AggregateSelection, AggregateSpec, AppliedMigrationEntry, AppliedMigrationRun, AppliedMigrationsState, ArkormBootContext, ArkormCollection, ArkormConfig, ArkormDebugEvent, ArkormDebugHandler, ArkormErrorContext, ArkormException, Attribute, AttributeCreateInput, AttributeOptions, AttributeOrderBy, AttributeSchemaDelegate, AttributeSelect, AttributeUpdateInput, AttributeWhereInput, BelongsToManyRelationMetadata, BelongsToRelationMetadata, CastDefinition, CastHandler, CastMap, CastType, CliApp, ClientResolver, ColumnMap, DB, DatabaseAdapter, DatabasePrimitive, DatabaseRow, DatabaseRows, DatabaseTableOptions, DatabaseTablePersistedMetadataOptions, DatabaseValue, DelegateCreateData, DelegateFindManyArgs, DelegateForModelSchema, DelegateInclude, DelegateOrderBy, DelegateRow, DelegateRows, DelegateSelect, DelegateUniqueWhere, DelegateUpdateArgs, DelegateUpdateData, DelegateWhere, DeleteManySpec, DeleteSpec, EagerLoadConstraint, EagerLoadMap, EnumBuilder, FactoryAttributes, FactoryDefinition, FactoryModelConstructor, FactoryState, ForeignKeyBuilder, GenerateMigrationOptions, GeneratedMigrationFile, GetUserConfig, GlobalScope, HasManyRelationMetadata, HasManyThroughRelationMetadata, HasOneRelationMetadata, HasOneThroughRelationMetadata, InitCommand, InlineFactory, InsertManySpec, InsertSpec, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationClass, MigrationHistoryCommand, MigrationInstanceLike, MissingDelegateException, Model, ModelAttributes, ModelAttributesOf, ModelCreateData, ModelEventDispatcher, ModelEventHandler, ModelEventHandlerConstructor, ModelEventListener, ModelEventName, ModelFactory, ModelLifecycleState, ModelMetadata, ModelNotFoundException, ModelRelationshipKey, ModelRelationshipResult, ModelStatic, ModelUpdateData, ModelsSyncCommand, MorphManyRelationMetadata, MorphOneRelationMetadata, MorphToManyRelationMetadata, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, PaginationCurrentPageResolver, PaginationMeta, PaginationOptions, PaginationURLDriver, PaginationURLDriverFactory, Paginator, PersistedColumnMappingsState, PersistedMetadataFeatures, PersistedPrimaryKeyGeneration, PersistedTableMetadata, PersistedTimestampColumn, PivotModel, PivotModelStatic, PrimaryKeyGeneration, PrimaryKeyGenerationPlanner, PrismaClientLike, PrismaDatabaseAdapter, PrismaDelegateLike, PrismaDelegateMap, PrismaDelegateNameMapping, PrismaFindManyArgsLike, PrismaLikeInclude, PrismaLikeOrderBy, PrismaLikeScalarFilter, PrismaLikeSelect, PrismaLikeSortOrder, PrismaLikeWhereInput, PrismaMigrationWorkflowOptions, PrismaSchemaSyncOptions, PrismaTransactionCallback, PrismaTransactionCapableClient, PrismaTransactionOptions, QueryBuilder, QueryComparisonCondition, QueryComparisonOperator, QueryCondition, QueryConstraintException, QueryExecutionException, QueryExecutionExceptionContext, QueryGroupCondition, QueryLogicalOperator, QueryNotCondition, QueryOrderBy, QueryRawCondition, QuerySelectColumn, QueryTarget, RelatedModelClass, RelationAggregateSpec, RelationColumnLookupSpec, RelationConstraint, RelationDefaultResolver, RelationDefaultValue, RelationFilterSpec, RelationLoadPlan, RelationLoadSpec, RelationMetadata, RelationMetadataProvider, RelationMetadataType, RelationResolutionException, RelationTableLookupSpec, RelationshipModelStatic, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, SchemaColumn, SchemaColumnType, SchemaForeignKey, SchemaForeignKeyAction, SchemaIndex, SchemaOperation, SchemaTableAlterOperation, SchemaTableCreateOperation, SchemaTableDropOperation, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, SelectSpec, Serializable, SimplePaginationMeta, SoftDeleteConfig, SoftDeleteQueryMode, SortDirection, TableBuilder, TimestampColumnBehavior, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, UpdateManySpec, UpdateSpec, UpsertSpec, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRuntimeAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, validatePersistedMetadataFeaturesForMigrations, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };
+export { AdapterBindableModel, AdapterCapabilities, AdapterCapability, AdapterInspectionRequest, AdapterModelFieldStructure, AdapterModelIntrospectionOptions, AdapterModelStructure, AdapterQueryInspection, AdapterQueryOperation, AdapterTransactionContext, AggregateOperation, AggregateSelection, AggregateSpec, AppliedMigrationEntry, AppliedMigrationRun, AppliedMigrationsState, ArkormBootContext, ArkormCollection, ArkormConfig, ArkormDebugEvent, ArkormDebugHandler, ArkormErrorContext, ArkormException, Attribute, AttributeCreateInput, AttributeOptions, AttributeOrderBy, AttributeSchemaDelegate, AttributeSelect, AttributeUpdateInput, AttributeWhereInput, BelongsToManyRelationMetadata, BelongsToRelationMetadata, CastDefinition, CastHandler, CastMap, CastType, CliApp, ClientResolver, ColumnMap, DB, DatabaseAdapter, DatabasePrimitive, DatabaseRow, DatabaseRows, DatabaseTableOptions, DatabaseTablePersistedMetadataOptions, DatabaseValue, DelegateCreateData, DelegateFindManyArgs, DelegateForModelSchema, DelegateInclude, DelegateOrderBy, DelegateRow, DelegateRows, DelegateSelect, DelegateUniqueWhere, DelegateUpdateArgs, DelegateUpdateData, DelegateWhere, DeleteManySpec, DeleteSpec, EagerLoadConstraint, EagerLoadMap, EnumBuilder, FactoryAttributes, FactoryDefinition, FactoryModelConstructor, FactoryState, ForeignKeyBuilder, GenerateMigrationOptions, GeneratedMigrationFile, GetUserConfig, GlobalScope, HasManyRelationMetadata, HasManyThroughRelationMetadata, HasOneRelationMetadata, HasOneThroughRelationMetadata, InitCommand, InlineFactory, InsertManySpec, InsertSpec, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateFreshCommand, MigrateRollbackCommand, Migration, MigrationClass, MigrationHistoryCommand, MigrationInstanceLike, MissingDelegateException, Model, ModelAttributeValue, ModelAttributes, ModelAttributesOf, ModelCreateData, ModelDeclaredAttributeKey, ModelEventDispatcher, ModelEventHandler, ModelEventHandlerConstructor, ModelEventListener, ModelEventName, ModelFactory, ModelLifecycleState, ModelMetadata, ModelNotFoundException, ModelRelationshipKey, ModelRelationshipResult, ModelStatic, ModelUpdateData, ModelsSyncCommand, MorphManyRelationMetadata, MorphOneRelationMetadata, MorphToManyRelationMetadata, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, PaginationCurrentPageResolver, PaginationMeta, PaginationOptions, PaginationURLDriver, PaginationURLDriverFactory, Paginator, PersistedColumnMappingsState, PersistedMetadataFeatures, PersistedPrimaryKeyGeneration, PersistedTableMetadata, PersistedTimestampColumn, PivotModel, PivotModelStatic, PrimaryKeyGeneration, PrimaryKeyGenerationPlanner, PrismaClientLike, PrismaDatabaseAdapter, PrismaDelegateLike, PrismaDelegateMap, PrismaDelegateNameMapping, PrismaFindManyArgsLike, PrismaLikeInclude, PrismaLikeOrderBy, PrismaLikeScalarFilter, PrismaLikeSelect, PrismaLikeSortOrder, PrismaLikeWhereInput, PrismaMigrationWorkflowOptions, PrismaSchemaSyncOptions, PrismaTransactionCallback, PrismaTransactionCapableClient, PrismaTransactionOptions, QueryBuilder, QueryComparisonCondition, QueryComparisonOperator, QueryCondition, QueryConstraintException, QueryExecutionException, QueryExecutionExceptionContext, QueryGroupCondition, QueryLogicalOperator, QueryNotCondition, QueryOrderBy, QueryRawCondition, QuerySelectColumn, QueryTarget, RelatedModelClass, RelationAggregateSpec, RelationColumnLookupSpec, RelationConstraint, RelationDefaultResolver, RelationDefaultValue, RelationFilterSpec, RelationLoadPlan, RelationLoadSpec, RelationMetadata, RelationMetadataProvider, RelationMetadataType, RelationResolutionException, RelationTableLookupSpec, RelationshipModelStatic, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, SchemaColumn, SchemaColumnType, SchemaForeignKey, SchemaForeignKeyAction, SchemaIndex, SchemaOperation, SchemaTableAlterOperation, SchemaTableCreateOperation, SchemaTableDropOperation, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, SelectSpec, Serializable, SimplePaginationMeta, SoftDeleteConfig, SoftDeleteQueryMode, SortDirection, TableBuilder, TimestampColumnBehavior, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, UpdateManySpec, UpdateSpec, UpsertSpec, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToDatabase, applyMigrationRollbackToPrismaSchema, applyMigrationToDatabase, applyMigrationToPrismaSchema, applyOperationsToPersistedColumnMappingsState, applyOperationsToPrismaSchema, bindAdapterToModels, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createEmptyAppliedMigrationsState, createEmptyPersistedColumnMappingsState, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deleteAppliedMigrationsStateFromStore, deletePersistedColumnMappingsState, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, emitRuntimeDebugEvent, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getPersistedColumnMap, getPersistedEnumMap, getPersistedEnumTsType, getPersistedPrimaryKeyGeneration, getPersistedTableMetadata, getPersistedTimestampColumns, getRuntimeAdapter, getRuntimeDebugHandler, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, readAppliedMigrationsStateFromStore, readPersistedColumnMappingsState, rebuildPersistedColumnMappingsState, removeAppliedMigration, resetArkormRuntimeForTests, resetPersistedColumnMappingsCache, resolveCast, resolveColumnMappingsFilePath, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePersistedMetadataFeatures, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, stripPrismaSchemaModelsAndEnums, supportsDatabaseMigrationExecution, supportsDatabaseMigrationState, supportsDatabaseReset, syncPersistedColumnMappingsFromState, toMigrationFileSlug, toModelName, validatePersistedMetadataFeaturesForMigrations, writeAppliedMigrationsState, writeAppliedMigrationsStateToStore, writePersistedColumnMappingsState };

package/dist/index.mjs

@@ -9125,6 +9125,277 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 			conditions: [baseCondition, this.pivotWhere]
 		};
 	}
+	buildPivotTarget() {
+		return {
+			table: this.throughDelegate,
+			primaryKey: this.relatedPivotKey
+		};
+	}
+	buildRelatedPivotCondition(relatedValues) {
+		const normalizedValues = relatedValues.filter((value) => value != null);
+		if (normalizedValues.length === 0) return null;
+		if (normalizedValues.length === 1) return {
+			type: "comparison",
+			column: this.relatedPivotKey,
+			operator: "=",
+			value: normalizedValues[0]
+		};
+		return {
+			type: "comparison",
+			column: this.relatedPivotKey,
+			operator: "in",
+			value: normalizedValues
+		};
+	}
+	buildPivotMutationWhere(relatedValues = []) {
+		const baseCondition = this.buildPivotWhere(this.resolveParentPivotValue());
+		const relatedCondition = this.buildRelatedPivotCondition(relatedValues);
+		if (!relatedCondition) return baseCondition;
+		return {
+			type: "group",
+			operator: "and",
+			conditions: [baseCondition, relatedCondition]
+		};
+	}
+	normalizeIdentifierValue(value) {
+		if (typeof value === "string" && /^-?\d+$/.test(value)) return Number(value);
+		return value;
+	}
+	isPlainObject(value) {
+		return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+	}
+	isModelLike(value) {
+		return this.isPlainObject(value) && typeof value.getAttribute === "function";
+	}
+	normalizeRelatedItems(related) {
+		return Array.isArray(related) ? related : [related];
+	}
+	normalizeSyncEntries(related, pivotAttributes = {}) {
+		if (Array.isArray(related)) return related.map((item) => ({
+			related: item,
+			attributes: { ...pivotAttributes }
+		}));
+		if (this.isPlainObject(related) && !this.isModelLike(related)) return Object.entries(related).map(([key, attributes]) => ({
+			related: this.normalizeIdentifierValue(key),
+			attributes: this.isPlainObject(attributes) ? attributes : {}
+		}));
+		return [{
+			related,
+			attributes: { ...pivotAttributes }
+		}];
+	}
+	resolveParentPivotValue() {
+		return this.parent.getAttribute(this.parentKey);
+	}
+	resolveRelatedPivotValue(related) {
+		if (related && typeof related === "object" && "getAttribute" in related) return related.getAttribute(this.relatedKey);
+		return related;
+	}
+	buildPivotInsertValues(related, attributes = {}) {
+		const values = {
+			...attributes,
+			[this.foreignPivotKey]: this.resolveParentPivotValue(),
+			[this.relatedPivotKey]: this.resolveRelatedPivotValue(related)
+		};
+		if (this.pivotCreatedAtColumn && !(this.pivotCreatedAtColumn in values)) values[this.pivotCreatedAtColumn] = /* @__PURE__ */ new Date();
+		if (this.pivotUpdatedAtColumn && !(this.pivotUpdatedAtColumn in values)) values[this.pivotUpdatedAtColumn] = /* @__PURE__ */ new Date();
+		return values;
+	}
+	attachPivotToSingleResult(related, pivotRow) {
+		if (!this.shouldAttachPivotAttributes()) return related;
+		related.setAttribute(this.pivotAccessor, this.createPivotRecord(pivotRow));
+		return related;
+	}
+	async insertPivotRow(values, adapter = this.getRelationAdapter()) {
+		await adapter.insert({
+			target: this.buildPivotTarget(),
+			values
+		});
+	}
+	async selectPivotRows(where, adapter = this.getRelationAdapter()) {
+		return await adapter.select({
+			target: this.buildPivotTarget(),
+			where
+		});
+	}
+	async deletePivotRows(where, adapter = this.getRelationAdapter()) {
+		if (typeof adapter.deleteMany === "function") return await adapter.deleteMany({
+			target: this.buildPivotTarget(),
+			where
+		});
+		const rows = await this.selectPivotRows(where, adapter);
+		await Promise.all(rows.map(async (row) => {
+			await adapter.delete({
+				target: this.buildPivotTarget(),
+				where: {
+					type: "group",
+					operator: "and",
+					conditions: Object.entries(row).map(([column, value]) => ({
+						type: "comparison",
+						column,
+						operator: "=",
+						value
+					}))
+				}
+			});
+		}));
+		return rows.length;
+	}
+	buildPivotUpdateValues(attributes = {}) {
+		const values = { ...attributes };
+		if (this.pivotUpdatedAtColumn && !(this.pivotUpdatedAtColumn in values)) values[this.pivotUpdatedAtColumn] = /* @__PURE__ */ new Date();
+		return values;
+	}
+	async updatePivotRows(related, attributes, adapter = this.getRelationAdapter()) {
+		const values = this.buildPivotUpdateValues(attributes);
+		if (Object.keys(values).length === 0) return 0;
+		const where = this.buildPivotMutationWhere([this.resolveRelatedPivotValue(related)]);
+		if (typeof adapter.updateMany === "function") return await adapter.updateMany({
+			target: this.buildPivotTarget(),
+			where,
+			values
+		});
+		const rows = await this.selectPivotRows(where, adapter);
+		await Promise.all(rows.map(async (row) => {
+			await adapter.update({
+				target: this.buildPivotTarget(),
+				where: {
+					type: "group",
+					operator: "and",
+					conditions: Object.entries(row).map(([column, value]) => ({
+						type: "comparison",
+						column,
+						operator: "=",
+						value
+					}))
+				},
+				values
+			});
+		}));
+		return rows.length;
+	}
+	/**
+	* Creates a new instance of the related model with the given attributes and attaches 
+	* pivot attributes if pivot attributes should be included.
+	* 
+	* @param attributes    The attributes to initialize the related model with.
+	* @returns             A new instance of the related model.
+	*/
+	make(attributes = {}) {
+		return this.related.hydrate(attributes);
+	}
+	/**
+	* Creates a new related model record with the given attributes, creates a pivot record 
+	* with the given pivot attributes, and attaches pivot attributes if pivot attributes 
+	* should be included.
+	* 
+	* @param attributes        The attributes to initialize the related model with.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 A new instance of the related model with pivot attributes attached.
+	*/
+	async create(attributes = {}, pivotAttributes = {}) {
+		const related = await this.related.query().create(attributes);
+		const pivotRow = this.buildPivotInsertValues(related, pivotAttributes);
+		await this.insertPivotRow(pivotRow);
+		return this.attachPivotToSingleResult(related, pivotRow);
+	}
+	/**
+	* Saves a related model record, creates a pivot record with the given pivot attributes 
+	* if the related model was not previously persisted, and attaches pivot attributes if 
+	* pivot attributes should be included.
+	* 
+	* @param related           The related model instance to save.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 A new instance of the related model with pivot attributes attached.
+	*/
+	async save(related, pivotAttributes = {}) {
+		const saveable = related;
+		let persisted = related;
+		if (typeof saveable.save === "function") try {
+			persisted = await saveable.save();
+		} catch (error) {
+			if (!(typeof error === "object" && error !== null && "code" in error && error.code === "MODEL_NOT_FOUND")) throw error;
+			const attributes = typeof saveable.getRawAttributes === "function" ? saveable.getRawAttributes() : {};
+			persisted = await this.related.query().create(attributes);
+		}
+		const pivotRow = this.buildPivotInsertValues(persisted, pivotAttributes);
+		await this.insertPivotRow(pivotRow);
+		return this.attachPivotToSingleResult(persisted, pivotRow);
+	}
+	/**
+	* Attaches one or more related model records to the parent model by creating pivot 
+	* records with the given pivot attributes if pivot attributes should be included.
+	* 
+	* @param related           The related model instance(s) to attach.
+	* @param pivotAttributes   The attributes to initialize the pivot record with.
+	* @returns                 The number of related model records attached.
+	*/
+	async attach(related, pivotAttributes = {}) {
+		const items = Array.isArray(related) ? related : [related];
+		await Promise.all(items.map(async (item) => {
+			await this.insertPivotRow(this.buildPivotInsertValues(item, pivotAttributes));
+		}));
+		return items.length;
+	}
+	/**
+	* Detaches one or more related model records from the parent model by deleting
+	* matching pivot rows. When no related value is provided, all matching pivot rows
+	* for the parent are removed.
+	*
+	* @param related
+	* @returns
+	*/
+	async detach(related) {
+		const where = related === void 0 ? this.buildPivotWhere(this.resolveParentPivotValue()) : this.buildPivotMutationWhere(this.normalizeRelatedItems(related).map((item) => this.resolveRelatedPivotValue(item)));
+		return await this.deletePivotRows(where);
+	}
+	/**
+	* Synchronizes the pivot table so only the provided related values remain attached.
+	* Existing matching rows can receive updated pivot attributes during the operation.
+	*
+	* @param related
+	* @param pivotAttributes
+	* @returns
+	*/
+	async sync(related, pivotAttributes = {}) {
+		return await this.getRelationAdapter().transaction(async (transaction) => {
+			const existingRows = await this.selectPivotRows(this.buildPivotWhere(this.resolveParentPivotValue()), transaction);
+			const desiredEntries = /* @__PURE__ */ new Map();
+			this.normalizeSyncEntries(related, pivotAttributes).forEach((entry) => {
+				const relatedValue = this.resolveRelatedPivotValue(entry.related);
+				if (relatedValue == null) return;
+				desiredEntries.set(String(relatedValue), {
+					related: relatedValue,
+					attributes: entry.attributes
+				});
+			});
+			let detached = 0;
+			let attached = 0;
+			let updated = 0;
+			const existingKeys = /* @__PURE__ */ new Set();
+			for (const row of existingRows) {
+				const relatedValue = row[this.relatedPivotKey];
+				if (relatedValue == null) continue;
+				const relatedKey = String(relatedValue);
+				existingKeys.add(relatedKey);
+				if (!desiredEntries.has(relatedKey)) detached += await this.deletePivotRows(this.buildPivotMutationWhere([relatedValue]), transaction);
+			}
+			for (const [relatedKey, entry] of desiredEntries) {
+				if (!existingKeys.has(relatedKey)) {
+					await this.insertPivotRow(this.buildPivotInsertValues(entry.related, entry.attributes), transaction);
+					attached += 1;
+					continue;
+				}
+				if (Object.keys(entry.attributes).length === 0) continue;
+				updated += await this.updatePivotRows(entry.related, entry.attributes, transaction);
+			}
+			return {
+				attached,
+				detached,
+				updated
+			};
+		});
+	}
 	shouldAttachPivotAttributes() {
 		return this.shouldAttachPivot || this.pivotColumns.size > 0 || Boolean(this.pivotCreatedAtColumn) || Boolean(this.pivotUpdatedAtColumn) || Boolean(this.pivotModel);
 	}
@@ -9210,7 +9481,7 @@ var BelongsToManyRelation = class BelongsToManyRelation extends Relation {
 		return query;
 	}
 	async loadPivotRowsForParent() {
-		const parentValue = this.parent.getAttribute(this.parentKey);
+		const parentValue = this.resolveParentPivotValue();
 		return await this.createRelationTableLoader().selectRows({
 			table: this.throughDelegate,
 			where: this.buildPivotWhere(parentValue),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.0.0-next.20",
+  "version": "2.0.0-next.21",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",