@warlock.js/cascade 5.20.0 → 5.21.0

package/esm/model/methods/write-methods.mjs

@@ -1,4 +1,5 @@
 import { mergeDriverFields } from "./accessor-methods.mjs";
+import { sanitizeFilter } from "../../utils/sanitize-filter.mjs";
 import { emitModelEvent } from "./instance-event-methods.mjs";
 import { DatabaseWriter } from "../../writer/database-writer.mjs";
 
@@ -132,11 +133,9 @@ async function assignIdBlock(ModelClass, models) {
 * touching the database, then flush each chunk with a single
 * `driver.insertMany` call.
 *
-* The writer reuse is achieved by swapping the driver's single-row `insert`
-* for a capturing stub for the lifetime of the bulk operation: running
-* `writer.save({ skipEvents, skipSync })` exercises the real prep but records
-* the prepared document instead of issuing N single-row inserts. The original
-* `insert` is always restored in `finally`.
+* The writer reuse goes through `DatabaseWriter.prepareForInsert()`, the same
+* pipeline `save()` uses for an insert, so the shared driver is never mutated
+* and concurrent `save()` calls are unaffected.
 *
 * @param ModelClass - The model class to create records for.
 * @param chunks - Pre-chunked rows.
@@ -145,33 +144,24 @@ async function assignIdBlock(ModelClass, models) {
 async function createManyBulk(ModelClass, chunks) {
 	const driver = ModelClass.getDataSource().driver;
 	const table = ModelClass.table;
-	const originalInsert = driver.insert;
-	driver.insert = (async (_table, document) => {
-		return { document };
-	});
 	const created = [];
-	try {
-		for (const chunk of chunks) {
-			const models = chunk.map((item) => new ModelClass(item));
-			await assignIdBlock(ModelClass, models);
-			const preparedDocuments = await Promise.all(models.map(async (model) => {
-				await new DatabaseWriter(model).save({
-					skipEvents: true,
-					skipSync: true
-				});
-				return { ...model.data };
-			}));
-			const results = await driver.insertMany(table, preparedDocuments);
-			models.forEach((model, index) => {
-				const result = results[index];
-				if (result) mergeDriverFields(model, "document" in result ? result.document : result);
-				model.dirtyTracker.reset();
-				model.isNew = false;
-			});
-			created.push(...models);
-		}
-	} finally {
-		driver.insert = originalInsert;
+	for (const chunk of chunks) {
+		const models = chunk.map((item) => new ModelClass(item));
+		await assignIdBlock(ModelClass, models);
+		const preparedDocuments = await Promise.all(models.map(async (model) => {
+			return { ...await new DatabaseWriter(model).prepareForInsert({
+				skipEvents: true,
+				skipSync: true
+			}) };
+		}));
+		const results = await driver.insertMany(table, preparedDocuments);
+		models.forEach((model, index) => {
+			const result = results[index];
+			if (result) mergeDriverFields(model, "document" in result ? result.document : result);
+			model.dirtyTracker.reset();
+			model.isNew = false;
+		});
+		created.push(...models);
 	}
 	return created;
 }
@@ -185,38 +175,48 @@ async function findOrCreateRecord(ModelClass, filter, data) {
 }
 async function upsertRecord(ModelClass, filter, data, options) {
 	const driver = ModelClass.getDriver();
-	const mergedData = {
-		...filter,
+	const safeFilter = sanitizeFilter(filter);
+	const tempModel = new ModelClass({
+		...safeFilter,
 		...data
-	};
-	const tempModel = new ModelClass(mergedData);
+	});
 	tempModel.isNew = true;
 	await emitModelEvent(tempModel, "saving", {
 		isInsert: true,
 		options,
 		mode: "upsert"
 	});
-	const createdAtColumn = ModelClass.createdAtColumn;
-	const updatedAtColumn = ModelClass.updatedAtColumn;
-	if (createdAtColumn !== false && createdAtColumn !== void 0) {
-		const createdAtKey = createdAtColumn;
-		if (!mergedData[createdAtKey]) mergedData[createdAtKey] = /* @__PURE__ */ new Date();
+	await new DatabaseWriter(tempModel).prepareForUpsert();
+	const setData = { ...tempModel.data };
+	const setOnInsert = {};
+	const now = /* @__PURE__ */ new Date();
+	for (const key of new Set([
+		"id",
+		"_id",
+		ModelClass.primaryKey
+	])) if (key in setData) {
+		setOnInsert[key] = setData[key];
+		delete setData[key];
 	}
-	if (updatedAtColumn !== false && updatedAtColumn !== void 0) {
-		const updatedAtKey = updatedAtColumn;
-		mergedData[updatedAtKey] = /* @__PURE__ */ new Date();
+	const createdAtColumn = ModelClass.createdAtColumn;
+	if (createdAtColumn) {
+		setOnInsert[createdAtColumn] = setData[createdAtColumn] ?? now;
+		delete setData[createdAtColumn];
 	}
-	await emitModelEvent(tempModel, "saving", {
-		filter,
-		data: mergedData,
-		options,
-		mode: "upsert"
+	const updatedAtColumn = ModelClass.updatedAtColumn;
+	if (updatedAtColumn) setData[updatedAtColumn] = now;
+	const result = await driver.findOneAndUpdate(ModelClass.table, safeFilter, {
+		$set: setData,
+		$setOnInsert: setOnInsert
+	}, {
+		...options,
+		upsert: true,
+		returnDocument: "after"
 	});
-	const result = await driver.upsert(ModelClass.table, filter, mergedData, options);
 	const model = ModelClass.hydrate(result);
 	model.dirtyTracker.reset();
 	await emitModelEvent(model, "saved", {
-		filter,
+		filter: safeFilter,
 		data: result,
 		options,
 		mode: "upsert"

package/esm/model/methods/write-methods.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"write-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/write-methods.ts"],"sourcesContent":["import { DatabaseWriter } from \"../../writer/database-writer\";\r\nimport type { InsertResult, WriterOptions } from \"../../contracts\";\r\nimport type { ChildModel, Model, ModelSchema } from \"../model\";\r\nimport { mergeDriverFields } from \"./accessor-methods\";\r\nimport { emitModelEvent } from \"./instance-event-methods\";\r\n\r\n/**\r\n * Default number of rows processed per chunk by {@link createManyRecords}.\r\n *\r\n * Chunking keeps a single huge `createMany` call from flooding the driver:\r\n * the default path runs each chunk's `save()` calls under one `Promise.all`,\r\n * and the bulk path emits one multi-row `insertMany` per chunk so the\r\n * generated `INSERT ... VALUES (...),(...)` stays under the database's bind\r\n * parameter ceiling.\r\n */\r\nexport const DEFAULT_CREATE_MANY_BATCH_SIZE = 500;\r\n\r\n/**\r\n * Options for {@link createManyRecords} (and `Model.createMany`).\r\n */\r\nexport type CreateManyOptions = {\r\n  /**\r\n   * Number of rows processed per chunk.\r\n   *\r\n   * @default 500 ({@link DEFAULT_CREATE_MANY_BATCH_SIZE})\r\n   */\r\n  batchSize?: number;\r\n\r\n  /**\r\n   * Route each chunk through the driver's native multi-row insert\r\n   * (`insertMany`) instead of per-row `save()`.\r\n   *\r\n   * **Tradeoff:** the bulk path is 10–100× faster for large arrays but\r\n   * SKIPS the per-row lifecycle: `saving` / `creating` / `created` / `saved`\r\n   * events, instance hooks, and sync operations are NOT emitted. Casts,\r\n   * timestamps, defaults and id-generation that the writer normally applies\r\n   * ARE still applied (the rows are prepped through the same writer pipeline),\r\n   * so persisted columns match the default path.\r\n   *\r\n   * @default false\r\n   */\r\n  bulk?: boolean;\r\n};\r\n\r\nexport async function saveModel<TModel extends Model>(\r\n  model: TModel,\r\n  options?: WriterOptions & { merge?: Partial<ModelSchema> },\r\n): Promise<TModel> {\r\n  if (options?.merge) {\r\n    model.merge(options.merge);\r\n  }\r\n  const writer = new DatabaseWriter(model);\r\n  await writer.save(options);\r\n  return model;\r\n}\r\n\r\nexport async function createRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, data: Partial<TSchema>): Promise<TModel> {\r\n  const model = new ModelClass(data);\r\n  await model.save();\r\n  return model;\r\n}\r\n\r\n/**\r\n * Split an array into sequential chunks of at most `size` elements.\r\n *\r\n * @param items - The array to split.\r\n * @param size - Maximum chunk length (callers pass a value `>= 1`).\r\n * @returns An array of chunks preserving the original order.\r\n */\r\nfunction chunkArray<TItem>(items: TItem[], size: number): TItem[][] {\r\n  const chunks: TItem[][] = [];\r\n\r\n  for (let index = 0; index < items.length; index += size) {\r\n    chunks.push(items.slice(index, index + size));\r\n  }\r\n\r\n  return chunks;\r\n}\r\n\r\n/**\r\n * Create many records, chunking the work so a huge array can't overwhelm the\r\n * driver.\r\n *\r\n * Two strategies are available via `options.bulk`:\r\n *\r\n * - **Default (`bulk` falsy):** each row is persisted through `save()`, so\r\n *   model hooks, lifecycle events, casts and generated ids are all preserved.\r\n *   Rows are processed in sequential chunks of `batchSize`, each chunk running\r\n *   under a single `Promise.all`, so an array of millions of rows can't open\r\n *   millions of concurrent inserts at once.\r\n *\r\n * - **Bulk (`bulk: true`):** each chunk is routed to the driver's native\r\n *   multi-row insert (`insertMany`) for 10–100× throughput. This SKIPS the\r\n *   per-row save lifecycle (no `saving` / `creating` / `created` / `saved`\r\n *   events, hooks, or sync). Rows are still prepped through the writer\r\n *   pipeline (validation, casting, timestamps, defaults, id-generation) so the\r\n *   persisted columns match the default path, and the values returned by the\r\n *   driver (generated `_id`, timestamps, SQL `RETURNING *`) are merged back\r\n *   onto the returned models.\r\n *\r\n * Both strategies return the created model instances (an empty array is a\r\n * no-op that never touches the driver).\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param data - The rows to insert.\r\n * @param options - Chunking / bulk options.\r\n * @returns The created model instances.\r\n *\r\n * @example\r\n * ```typescript\r\n * // Default: per-row save(), chunked in batches of 500\r\n * const users = await User.createMany(rows);\r\n *\r\n * // Bulk: one multi-row INSERT per 1000-row chunk (skips per-row hooks)\r\n * const users = await User.createMany(rows, { bulk: true, batchSize: 1000 });\r\n * ```\r\n */\r\nexport async function createManyRecords<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  data: Partial<TSchema>[],\r\n  options: CreateManyOptions = {},\r\n): Promise<TModel[]> {\r\n  if (data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const batchSize =\r\n    options.batchSize && options.batchSize > 0\r\n      ? options.batchSize\r\n      : DEFAULT_CREATE_MANY_BATCH_SIZE;\r\n\r\n  const chunks = chunkArray(data, batchSize);\r\n\r\n  if (options.bulk === true) {\r\n    return await createManyBulk(ModelClass, chunks);\r\n  }\r\n\r\n  const created: TModel[] = [];\r\n\r\n  for (const chunk of chunks) {\r\n    const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n    // Reserve one contiguous id block for the whole chunk (1 counter op instead\r\n    // of N), pre-seeding each id-less model so its per-row save() no-ops id-gen.\r\n    await assignIdBlock(ModelClass, models);\r\n\r\n    const chunkModels = await Promise.all(\r\n      models.map(async (model) => {\r\n        await model.save();\r\n        return model;\r\n      }),\r\n    );\r\n\r\n    created.push(...chunkModels);\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\n/**\r\n * Reserve a single contiguous id block for one chunk and pre-assign the ids to\r\n * the models that don't already carry one, so the per-row writer's id\r\n * generation no-ops (its `model.get(\"id\")` guard short-circuits). This turns N\r\n * per-row counter round-trips into ONE per chunk.\r\n *\r\n * Falls back to per-row generation (a no-op here) when:\r\n * - the model disables auto-generation (`autoGenerateId === false`) — e.g. SQL,\r\n *   which uses native `SERIAL`;\r\n * - the data source's id generator has no batch API (`generateNextIds`) — the\r\n *   optional contract member is feature-detected;\r\n * - the model uses a random initial id / increment — a random stride can't form\r\n *   a contiguous block, so those models keep per-row generation.\r\n *\r\n * Only models WITHOUT a caller-supplied id consume a block slot, so a chunk\r\n * mixing supplied and auto ids allocates exactly the right number (no gaps).\r\n *\r\n * @param ModelClass - The model class being inserted.\r\n * @param models - The freshly-constructed (unsaved) models for one chunk.\r\n */\r\nasync function assignIdBlock<TModel extends Model>(\r\n  ModelClass: ChildModel<TModel>,\r\n  models: TModel[],\r\n): Promise<void> {\r\n  if (!ModelClass.autoGenerateId || ModelClass.randomInitialId || ModelClass.randomIncrement) {\r\n    return;\r\n  }\r\n\r\n  const idGenerator = ModelClass.getDataSource().idGenerator;\r\n\r\n  if (!idGenerator || typeof idGenerator.generateNextIds !== \"function\") {\r\n    return;\r\n  }\r\n\r\n  const idLessModels = models.filter((model) => !model.get(\"id\"));\r\n\r\n  if (idLessModels.length === 0) {\r\n    return;\r\n  }\r\n\r\n  const ids = await idGenerator.generateNextIds({\r\n    table: ModelClass.table,\r\n    initialId: ModelClass.initialId || 1,\r\n    incrementIdBy: ModelClass.incrementIdBy || 1,\r\n    count: idLessModels.length,\r\n  });\r\n\r\n  // Enforce the contract at this pluggable, feature-detected boundary: a\r\n  // non-conforming generator returning the wrong count would otherwise set\r\n  // `id = undefined` on the unmatched rows, the per-row writer would silently\r\n  // re-generate single ids, and the reserved block would no longer match what\r\n  // is persisted. Fail loud instead of corrupting the sequence.\r\n  if (ids.length !== idLessModels.length) {\r\n    throw new Error(\r\n      `generateNextIds returned ${ids.length} id(s) for ${idLessModels.length} row(s) on ` +\r\n        `\"${ModelClass.table}\" — a batch id generator must return exactly the requested count.`,\r\n    );\r\n  }\r\n\r\n  idLessModels.forEach((model, index) => {\r\n    model.set(\"id\", ids[index]);\r\n  });\r\n}\r\n\r\n/**\r\n * Bulk variant of {@link createManyRecords}: prep each row through the writer\r\n * pipeline (validation, casting, timestamps, defaults, id-generation) without\r\n * touching the database, then flush each chunk with a single\r\n * `driver.insertMany` call.\r\n *\r\n * The writer reuse is achieved by swapping the driver's single-row `insert`\r\n * for a capturing stub for the lifetime of the bulk operation: running\r\n * `writer.save({ skipEvents, skipSync })` exercises the real prep but records\r\n * the prepared document instead of issuing N single-row inserts. The original\r\n * `insert` is always restored in `finally`.\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param chunks - Pre-chunked rows.\r\n * @returns The created model instances with driver-returned values merged in.\r\n */\r\nasync function createManyBulk<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, chunks: Partial<TSchema>[][]): Promise<TModel[]> {\r\n  const dataSource = ModelClass.getDataSource();\r\n  const driver = dataSource.driver;\r\n  const table = ModelClass.table;\r\n  // Keep the exact original reference so it can be restored verbatim (binding a\r\n  // copy would, for a spied driver, replace the spy with a non-spy wrapper).\r\n  const originalInsert = driver.insert;\r\n\r\n  // Capture the prepared (validated/casted/timestamped/id-generated) document\r\n  // instead of inserting it per row, so the writer's prep runs exactly once\r\n  // per model while the actual write is deferred to a single insertMany.\r\n  driver.insert = (async (\r\n    _table: string,\r\n    document: Record<string, unknown>,\r\n  ): Promise<InsertResult> => {\r\n    return { document };\r\n  }) as typeof driver.insert;\r\n\r\n  const created: TModel[] = [];\r\n\r\n  try {\r\n    for (const chunk of chunks) {\r\n      const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n      // Reserve one contiguous id block for the whole chunk (1 counter op\r\n      // instead of N), pre-seeding each id-less model so the per-row writer's\r\n      // id generation no-ops.\r\n      await assignIdBlock(ModelClass, models);\r\n\r\n      // Prep every model through the real writer pipeline. The captured\r\n      // `insert` keeps this off the wire while still mutating each model's\r\n      // data with casts/timestamps/defaults/generated ids.\r\n      const preparedDocuments = await Promise.all(\r\n        models.map(async (model) => {\r\n          const writer = new DatabaseWriter(model);\r\n          await writer.save({ skipEvents: true, skipSync: true });\r\n          return { ...model.data } as Record<string, unknown>;\r\n        }),\r\n      );\r\n\r\n      const results = await driver.insertMany(table, preparedDocuments);\r\n\r\n      // Merge driver-returned values (generated _id, timestamps, RETURNING *)\r\n      // back onto each model so the returned instances reflect persisted state.\r\n      models.forEach((model, index) => {\r\n        const result = results[index] as InsertResult | Record<string, unknown> | undefined;\r\n\r\n        if (result) {\r\n          const returnedDocument =\r\n            \"document\" in (result as Record<string, unknown>)\r\n              ? (result as InsertResult).document\r\n              : result;\r\n\r\n          // Driver-returned identity (generated _id / RETURNING *) — merged\r\n          // through the framework-internal path so it is not treated as mass\r\n          // assignment on a model the writer has already marked persisted.\r\n          mergeDriverFields(model, returnedDocument as Record<string, unknown>);\r\n        }\r\n\r\n        model.dirtyTracker.reset();\r\n        model.isNew = false;\r\n      });\r\n\r\n      created.push(...models);\r\n    }\r\n  } finally {\r\n    driver.insert = originalInsert;\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\nexport async function findOrCreateRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n): Promise<TModel> {\r\n  const existing = await ModelClass.first(filter as Record<string, unknown>);\r\n\r\n  if (existing) {\r\n    return existing;\r\n  }\r\n\r\n  return await createRecord(ModelClass, { ...filter, ...data } as Partial<TSchema>);\r\n}\r\n\r\nexport async function upsertRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n  options?: Record<string, unknown>,\r\n): Promise<TModel> {\r\n  const driver = ModelClass.getDriver();\r\n  const mergedData = { ...filter, ...data } as Record<string, unknown>;\r\n\r\n  const tempModel = new ModelClass(mergedData as Partial<TSchema>);\r\n  tempModel.isNew = true;\r\n\r\n  await emitModelEvent(tempModel, \"saving\", {\r\n    isInsert: true,\r\n    options,\r\n    mode: \"upsert\",\r\n  });\r\n\r\n  const createdAtColumn = ModelClass.createdAtColumn;\r\n  const updatedAtColumn = ModelClass.updatedAtColumn;\r\n\r\n  if (createdAtColumn !== false && createdAtColumn !== undefined) {\r\n    const createdAtKey = createdAtColumn as string;\r\n    if (!mergedData[createdAtKey]) {\r\n      mergedData[createdAtKey] = new Date();\r\n    }\r\n  }\r\n\r\n  if (updatedAtColumn !== false && updatedAtColumn !== undefined) {\r\n    const updatedAtKey = updatedAtColumn as string;\r\n    mergedData[updatedAtKey] = new Date();\r\n  }\r\n\r\n  await emitModelEvent(tempModel, \"saving\", { filter, data: mergedData, options, mode: \"upsert\" });\r\n\r\n  const result = await driver.upsert(ModelClass.table, filter as Record<string, unknown>, mergedData, options);\r\n\r\n  const model = ModelClass.hydrate(result as Record<string, unknown>) as TModel;\r\n  model.dirtyTracker.reset();\r\n\r\n  await emitModelEvent(model, \"saved\", { filter, data: result, options, mode: \"upsert\" });\r\n\r\n  return model;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAa,iCAAiC;AA6B9C,eAAsB,UACpB,OACA,SACiB;CACjB,IAAI,SAAS,OACX,MAAM,MAAM,QAAQ,KAAK;CAG3B,MAAM,IADa,eAAe,KACvB,CAAC,CAAC,KAAK,OAAO;CACzB,OAAO;AACT;AAEA,eAAsB,aAGpB,YAAgC,MAAyC;CACzE,MAAM,QAAQ,IAAI,WAAW,IAAI;CACjC,MAAM,MAAM,KAAK;CACjB,OAAO;AACT;;;;;;;;AASA,SAAS,WAAkB,OAAgB,MAAyB;CAClE,MAAM,SAAoB,CAAC;CAE3B,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,MACjD,OAAO,KAAK,MAAM,MAAM,OAAO,QAAQ,IAAI,CAAC;CAG9C,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,eAAsB,kBAIpB,YACA,MACA,UAA6B,CAAC,GACX;CACnB,IAAI,KAAK,WAAW,GAClB,OAAO,CAAC;CAQV,MAAM,SAAS,WAAW,MAJxB,QAAQ,aAAa,QAAQ,YAAY,IACrC,QAAQ,eAG2B;CAEzC,IAAI,QAAQ,SAAS,MACnB,OAAO,MAAM,eAAe,YAAY,MAAM;CAGhD,MAAM,UAAoB,CAAC;CAE3B,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,SAAS,MAAM,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC;EAIvD,MAAM,cAAc,YAAY,MAAM;EAEtC,MAAM,cAAc,MAAM,QAAQ,IAChC,OAAO,IAAI,OAAO,UAAU;GAC1B,MAAM,MAAM,KAAK;GACjB,OAAO;EACT,CAAC,CACH;EAEA,QAAQ,KAAK,GAAG,WAAW;CAC7B;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;AAsBA,eAAe,cACb,YACA,QACe;CACf,IAAI,CAAC,WAAW,kBAAkB,WAAW,mBAAmB,WAAW,iBACzE;CAGF,MAAM,cAAc,WAAW,cAAc,CAAC,CAAC;CAE/C,IAAI,CAAC,eAAe,OAAO,YAAY,oBAAoB,YACzD;CAGF,MAAM,eAAe,OAAO,QAAQ,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC;CAE9D,IAAI,aAAa,WAAW,GAC1B;CAGF,MAAM,MAAM,MAAM,YAAY,gBAAgB;EAC5C,OAAO,WAAW;EAClB,WAAW,WAAW,aAAa;EACnC,eAAe,WAAW,iBAAiB;EAC3C,OAAO,aAAa;CACtB,CAAC;CAOD,IAAI,IAAI,WAAW,aAAa,QAC9B,MAAM,IAAI,MACR,4BAA4B,IAAI,OAAO,aAAa,aAAa,OAAO,cAClE,WAAW,MAAM,kEACzB;CAGF,aAAa,SAAS,OAAO,UAAU;EACrC,MAAM,IAAI,MAAM,IAAI,MAAM;CAC5B,CAAC;AACH;;;;;;;;;;;;;;;;;AAkBA,eAAe,eAGb,YAAgC,QAAiD;CAEjF,MAAM,SADa,WAAW,cACN,CAAC,CAAC;CAC1B,MAAM,QAAQ,WAAW;CAGzB,MAAM,iBAAiB,OAAO;CAK9B,OAAO,UAAU,OACf,QACA,aAC0B;EAC1B,OAAO,EAAE,SAAS;CACpB;CAEA,MAAM,UAAoB,CAAC;CAE3B,IAAI;EACF,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,SAAS,MAAM,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC;GAKvD,MAAM,cAAc,YAAY,MAAM;GAKtC,MAAM,oBAAoB,MAAM,QAAQ,IACtC,OAAO,IAAI,OAAO,UAAU;IAE1B,MAAM,IADa,eAAe,KACvB,CAAC,CAAC,KAAK;KAAE,YAAY;KAAM,UAAU;IAAK,CAAC;IACtD,OAAO,EAAE,GAAG,MAAM,KAAK;GACzB,CAAC,CACH;GAEA,MAAM,UAAU,MAAM,OAAO,WAAW,OAAO,iBAAiB;GAIhE,OAAO,SAAS,OAAO,UAAU;IAC/B,MAAM,SAAS,QAAQ;IAEvB,IAAI,QASF,kBAAkB,OAPhB,cAAe,SACV,OAAwB,WACzB,MAK8D;IAGtE,MAAM,aAAa,MAAM;IACzB,MAAM,QAAQ;GAChB,CAAC;GAED,QAAQ,KAAK,GAAG,MAAM;EACxB;CACF,UAAU;EACR,OAAO,SAAS;CAClB;CAEA,OAAO;AACT;AAEA,eAAsB,mBAIpB,YACA,QACA,MACiB;CACjB,MAAM,WAAW,MAAM,WAAW,MAAM,MAAiC;CAEzE,IAAI,UACF,OAAO;CAGT,OAAO,MAAM,aAAa,YAAY;EAAE,GAAG;EAAQ,GAAG;CAAK,CAAqB;AAClF;AAEA,eAAsB,aAIpB,YACA,QACA,MACA,SACiB;CACjB,MAAM,SAAS,WAAW,UAAU;CACpC,MAAM,aAAa;EAAE,GAAG;EAAQ,GAAG;CAAK;CAExC,MAAM,YAAY,IAAI,WAAW,UAA8B;CAC/D,UAAU,QAAQ;CAElB,MAAM,eAAe,WAAW,UAAU;EACxC,UAAU;EACV;EACA,MAAM;CACR,CAAC;CAED,MAAM,kBAAkB,WAAW;CACnC,MAAM,kBAAkB,WAAW;CAEnC,IAAI,oBAAoB,SAAS,oBAAoB,QAAW;EAC9D,MAAM,eAAe;EACrB,IAAI,CAAC,WAAW,eACd,WAAW,gCAAgB,IAAI,KAAK;CAExC;CAEA,IAAI,oBAAoB,SAAS,oBAAoB,QAAW;EAC9D,MAAM,eAAe;EACrB,WAAW,gCAAgB,IAAI,KAAK;CACtC;CAEA,MAAM,eAAe,WAAW,UAAU;EAAE;EAAQ,MAAM;EAAY;EAAS,MAAM;CAAS,CAAC;CAE/F,MAAM,SAAS,MAAM,OAAO,OAAO,WAAW,OAAO,QAAmC,YAAY,OAAO;CAE3G,MAAM,QAAQ,WAAW,QAAQ,MAAiC;CAClE,MAAM,aAAa,MAAM;CAEzB,MAAM,eAAe,OAAO,SAAS;EAAE;EAAQ,MAAM;EAAQ;EAAS,MAAM;CAAS,CAAC;CAEtF,OAAO;AACT"}
+{"version":3,"file":"write-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/write-methods.ts"],"sourcesContent":["import { DatabaseWriter } from \"../../writer/database-writer\";\r\nimport type { InsertResult, WriterOptions } from \"../../contracts\";\r\nimport type { ChildModel, Model, ModelSchema } from \"../model\";\r\nimport { mergeDriverFields } from \"./accessor-methods\";\r\nimport { sanitizeFilter } from \"../../utils/sanitize-filter\";\r\nimport { emitModelEvent } from \"./instance-event-methods\";\r\n\r\n/**\r\n * Default number of rows processed per chunk by {@link createManyRecords}.\r\n *\r\n * Chunking keeps a single huge `createMany` call from flooding the driver:\r\n * the default path runs each chunk's `save()` calls under one `Promise.all`,\r\n * and the bulk path emits one multi-row `insertMany` per chunk so the\r\n * generated `INSERT ... VALUES (...),(...)` stays under the database's bind\r\n * parameter ceiling.\r\n */\r\nexport const DEFAULT_CREATE_MANY_BATCH_SIZE = 500;\r\n\r\n/**\r\n * Options for {@link createManyRecords} (and `Model.createMany`).\r\n */\r\nexport type CreateManyOptions = {\r\n  /**\r\n   * Number of rows processed per chunk.\r\n   *\r\n   * @default 500 ({@link DEFAULT_CREATE_MANY_BATCH_SIZE})\r\n   */\r\n  batchSize?: number;\r\n\r\n  /**\r\n   * Route each chunk through the driver's native multi-row insert\r\n   * (`insertMany`) instead of per-row `save()`.\r\n   *\r\n   * **Tradeoff:** the bulk path is 10–100× faster for large arrays but\r\n   * SKIPS the per-row lifecycle: `saving` / `creating` / `created` / `saved`\r\n   * events, instance hooks, and sync operations are NOT emitted. Casts,\r\n   * timestamps, defaults and id-generation that the writer normally applies\r\n   * ARE still applied (the rows are prepped through the same writer pipeline),\r\n   * so persisted columns match the default path.\r\n   *\r\n   * @default false\r\n   */\r\n  bulk?: boolean;\r\n};\r\n\r\nexport async function saveModel<TModel extends Model>(\r\n  model: TModel,\r\n  options?: WriterOptions & { merge?: Partial<ModelSchema> },\r\n): Promise<TModel> {\r\n  if (options?.merge) {\r\n    model.merge(options.merge);\r\n  }\r\n  const writer = new DatabaseWriter(model);\r\n  await writer.save(options);\r\n  return model;\r\n}\r\n\r\nexport async function createRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, data: Partial<TSchema>): Promise<TModel> {\r\n  const model = new ModelClass(data);\r\n  await model.save();\r\n  return model;\r\n}\r\n\r\n/**\r\n * Split an array into sequential chunks of at most `size` elements.\r\n *\r\n * @param items - The array to split.\r\n * @param size - Maximum chunk length (callers pass a value `>= 1`).\r\n * @returns An array of chunks preserving the original order.\r\n */\r\nfunction chunkArray<TItem>(items: TItem[], size: number): TItem[][] {\r\n  const chunks: TItem[][] = [];\r\n\r\n  for (let index = 0; index < items.length; index += size) {\r\n    chunks.push(items.slice(index, index + size));\r\n  }\r\n\r\n  return chunks;\r\n}\r\n\r\n/**\r\n * Create many records, chunking the work so a huge array can't overwhelm the\r\n * driver.\r\n *\r\n * Two strategies are available via `options.bulk`:\r\n *\r\n * - **Default (`bulk` falsy):** each row is persisted through `save()`, so\r\n *   model hooks, lifecycle events, casts and generated ids are all preserved.\r\n *   Rows are processed in sequential chunks of `batchSize`, each chunk running\r\n *   under a single `Promise.all`, so an array of millions of rows can't open\r\n *   millions of concurrent inserts at once.\r\n *\r\n * - **Bulk (`bulk: true`):** each chunk is routed to the driver's native\r\n *   multi-row insert (`insertMany`) for 10–100× throughput. This SKIPS the\r\n *   per-row save lifecycle (no `saving` / `creating` / `created` / `saved`\r\n *   events, hooks, or sync). Rows are still prepped through the writer\r\n *   pipeline (validation, casting, timestamps, defaults, id-generation) so the\r\n *   persisted columns match the default path, and the values returned by the\r\n *   driver (generated `_id`, timestamps, SQL `RETURNING *`) are merged back\r\n *   onto the returned models.\r\n *\r\n * Both strategies return the created model instances (an empty array is a\r\n * no-op that never touches the driver).\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param data - The rows to insert.\r\n * @param options - Chunking / bulk options.\r\n * @returns The created model instances.\r\n *\r\n * @example\r\n * ```typescript\r\n * // Default: per-row save(), chunked in batches of 500\r\n * const users = await User.createMany(rows);\r\n *\r\n * // Bulk: one multi-row INSERT per 1000-row chunk (skips per-row hooks)\r\n * const users = await User.createMany(rows, { bulk: true, batchSize: 1000 });\r\n * ```\r\n */\r\nexport async function createManyRecords<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  data: Partial<TSchema>[],\r\n  options: CreateManyOptions = {},\r\n): Promise<TModel[]> {\r\n  if (data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const batchSize =\r\n    options.batchSize && options.batchSize > 0\r\n      ? options.batchSize\r\n      : DEFAULT_CREATE_MANY_BATCH_SIZE;\r\n\r\n  const chunks = chunkArray(data, batchSize);\r\n\r\n  if (options.bulk === true) {\r\n    return await createManyBulk(ModelClass, chunks);\r\n  }\r\n\r\n  const created: TModel[] = [];\r\n\r\n  for (const chunk of chunks) {\r\n    const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n    // Reserve one contiguous id block for the whole chunk (1 counter op instead\r\n    // of N), pre-seeding each id-less model so its per-row save() no-ops id-gen.\r\n    await assignIdBlock(ModelClass, models);\r\n\r\n    const chunkModels = await Promise.all(\r\n      models.map(async (model) => {\r\n        await model.save();\r\n        return model;\r\n      }),\r\n    );\r\n\r\n    created.push(...chunkModels);\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\n/**\r\n * Reserve a single contiguous id block for one chunk and pre-assign the ids to\r\n * the models that don't already carry one, so the per-row writer's id\r\n * generation no-ops (its `model.get(\"id\")` guard short-circuits). This turns N\r\n * per-row counter round-trips into ONE per chunk.\r\n *\r\n * Falls back to per-row generation (a no-op here) when:\r\n * - the model disables auto-generation (`autoGenerateId === false`) — e.g. SQL,\r\n *   which uses native `SERIAL`;\r\n * - the data source's id generator has no batch API (`generateNextIds`) — the\r\n *   optional contract member is feature-detected;\r\n * - the model uses a random initial id / increment — a random stride can't form\r\n *   a contiguous block, so those models keep per-row generation.\r\n *\r\n * Only models WITHOUT a caller-supplied id consume a block slot, so a chunk\r\n * mixing supplied and auto ids allocates exactly the right number (no gaps).\r\n *\r\n * @param ModelClass - The model class being inserted.\r\n * @param models - The freshly-constructed (unsaved) models for one chunk.\r\n */\r\nasync function assignIdBlock<TModel extends Model>(\r\n  ModelClass: ChildModel<TModel>,\r\n  models: TModel[],\r\n): Promise<void> {\r\n  if (!ModelClass.autoGenerateId || ModelClass.randomInitialId || ModelClass.randomIncrement) {\r\n    return;\r\n  }\r\n\r\n  const idGenerator = ModelClass.getDataSource().idGenerator;\r\n\r\n  if (!idGenerator || typeof idGenerator.generateNextIds !== \"function\") {\r\n    return;\r\n  }\r\n\r\n  const idLessModels = models.filter((model) => !model.get(\"id\"));\r\n\r\n  if (idLessModels.length === 0) {\r\n    return;\r\n  }\r\n\r\n  const ids = await idGenerator.generateNextIds({\r\n    table: ModelClass.table,\r\n    initialId: ModelClass.initialId || 1,\r\n    incrementIdBy: ModelClass.incrementIdBy || 1,\r\n    count: idLessModels.length,\r\n  });\r\n\r\n  // Enforce the contract at this pluggable, feature-detected boundary: a\r\n  // non-conforming generator returning the wrong count would otherwise set\r\n  // `id = undefined` on the unmatched rows, the per-row writer would silently\r\n  // re-generate single ids, and the reserved block would no longer match what\r\n  // is persisted. Fail loud instead of corrupting the sequence.\r\n  if (ids.length !== idLessModels.length) {\r\n    throw new Error(\r\n      `generateNextIds returned ${ids.length} id(s) for ${idLessModels.length} row(s) on ` +\r\n        `\"${ModelClass.table}\" — a batch id generator must return exactly the requested count.`,\r\n    );\r\n  }\r\n\r\n  idLessModels.forEach((model, index) => {\r\n    model.set(\"id\", ids[index]);\r\n  });\r\n}\r\n\r\n/**\r\n * Bulk variant of {@link createManyRecords}: prep each row through the writer\r\n * pipeline (validation, casting, timestamps, defaults, id-generation) without\r\n * touching the database, then flush each chunk with a single\r\n * `driver.insertMany` call.\r\n *\r\n * The writer reuse goes through `DatabaseWriter.prepareForInsert()`, the same\r\n * pipeline `save()` uses for an insert, so the shared driver is never mutated\r\n * and concurrent `save()` calls are unaffected.\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param chunks - Pre-chunked rows.\r\n * @returns The created model instances with driver-returned values merged in.\r\n */\r\nasync function createManyBulk<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, chunks: Partial<TSchema>[][]): Promise<TModel[]> {\r\n  const dataSource = ModelClass.getDataSource();\r\n  const driver = dataSource.driver;\r\n  const table = ModelClass.table;\r\n\r\n  const created: TModel[] = [];\r\n\r\n  {\r\n    for (const chunk of chunks) {\r\n      const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n      // Reserve one contiguous id block for the whole chunk (1 counter op\r\n      // instead of N), pre-seeding each id-less model so the per-row writer's\r\n      // id generation no-ops.\r\n      await assignIdBlock(ModelClass, models);\r\n\r\n      // Prep every model through the real writer pipeline. The captured\r\n      // `insert` keeps this off the wire while still mutating each model's\r\n      // data with casts/timestamps/defaults/generated ids.\r\n      const preparedDocuments = await Promise.all(\r\n        models.map(async (model) => {\r\n          const document = await new DatabaseWriter(model).prepareForInsert({\r\n            skipEvents: true,\r\n            skipSync: true,\r\n          });\r\n          return { ...document } as Record<string, unknown>;\r\n        }),\r\n      );\r\n\r\n      const results = await driver.insertMany(table, preparedDocuments);\r\n\r\n      // Merge driver-returned values (generated _id, timestamps, RETURNING *)\r\n      // back onto each model so the returned instances reflect persisted state.\r\n      models.forEach((model, index) => {\r\n        const result = results[index] as InsertResult | Record<string, unknown> | undefined;\r\n\r\n        if (result) {\r\n          const returnedDocument =\r\n            \"document\" in (result as Record<string, unknown>)\r\n              ? (result as InsertResult).document\r\n              : result;\r\n\r\n          // Driver-returned identity (generated _id / RETURNING *) — merged\r\n          // through the framework-internal path so it is not treated as mass\r\n          // assignment on a model the writer has already marked persisted.\r\n          mergeDriverFields(model, returnedDocument as Record<string, unknown>);\r\n        }\r\n\r\n        model.dirtyTracker.reset();\r\n        model.isNew = false;\r\n      });\r\n\r\n      created.push(...models);\r\n    }\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\nexport async function findOrCreateRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n): Promise<TModel> {\r\n  const existing = await ModelClass.first(filter as Record<string, unknown>);\r\n\r\n  if (existing) {\r\n    return existing;\r\n  }\r\n\r\n  return await createRecord(ModelClass, { ...filter, ...data } as Partial<TSchema>);\r\n}\r\n\r\nexport async function upsertRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n  options?: Record<string, unknown>,\r\n): Promise<TModel> {\r\n  const driver = ModelClass.getDriver();\r\n  const safeFilter = sanitizeFilter(filter as Record<string, unknown>);\r\n  const mergedData = { ...safeFilter, ...data } as Record<string, unknown>;\r\n\r\n  const tempModel = new ModelClass(mergedData as Partial<TSchema>);\r\n  tempModel.isNew = true;\r\n\r\n  // One `saving` run against the model itself, so listener changes (slug,\r\n  // createdBy, ...) land in the data that is written.\r\n  await emitModelEvent(tempModel, \"saving\", {\r\n    isInsert: true,\r\n    options,\r\n    mode: \"upsert\",\r\n  });\r\n\r\n  // Validation, casting and Mongo id generation, same as `create()`.\r\n  await new DatabaseWriter(tempModel).prepareForUpsert();\r\n\r\n  const setData: Record<string, unknown> = { ...tempModel.data };\r\n  const setOnInsert: Record<string, unknown> = {};\r\n  const now = new Date();\r\n\r\n  // Identity and creation time belong to the insert only; an existing row\r\n  // keeps its own.\r\n  for (const key of new Set([\"id\", \"_id\", ModelClass.primaryKey])) {\r\n    if (key in setData) {\r\n      setOnInsert[key] = setData[key];\r\n      delete setData[key];\r\n    }\r\n  }\r\n\r\n  const createdAtColumn = ModelClass.createdAtColumn;\r\n  if (createdAtColumn) {\r\n    setOnInsert[createdAtColumn] = setData[createdAtColumn] ?? now;\r\n    delete setData[createdAtColumn];\r\n  }\r\n\r\n  const updatedAtColumn = ModelClass.updatedAtColumn;\r\n  if (updatedAtColumn) {\r\n    setData[updatedAtColumn] = now;\r\n  }\r\n\r\n  const result = await driver.findOneAndUpdate(\r\n    ModelClass.table,\r\n    safeFilter,\r\n    { $set: setData, $setOnInsert: setOnInsert },\r\n    { ...options, upsert: true, returnDocument: \"after\" },\r\n  );\r\n\r\n  const model = ModelClass.hydrate(result as Record<string, unknown>) as TModel;\r\n  model.dirtyTracker.reset();\r\n\r\n  await emitModelEvent(model, \"saved\", { filter: safeFilter, data: result, options, mode: \"upsert\" });\r\n\r\n  return model;\r\n}\r\n"],"mappings":"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"}

package/esm/model/model.d.mts

@@ -522,12 +522,27 @@ declare abstract class Model<TSchema extends ModelSchema = ModelSchema> {
    */
   isLoaded(relationName: string): boolean;
   /**
-   * Set relation manually
+   * Set relation manually.
+   *
+   * For a `belongsTo` relation this also writes the foreign-key column on
+   * this model (the declared `foreignKey`, else the inferred `<relation>_id`)
+   * from the related model's owner key, so `post.setRelation("author", user)`
+   * followed by `save()` persists `author_id`. Passing `null` clears the FK.
+   * The FK is left untouched when the related model carries no owner key yet.
+   *
+   * For `hasOne`, `hasMany`, `belongsToMany` and undeclared relations only the
+   * in-memory relation is set; no foreign key is written (the key lives on the
+   * other side or in a pivot table).
    *
    * @param relationName
    * @param relationData
    */
   setRelation(relationName: string, relationData: LoadedRelationResult): void;
+  /**
+   * Relation conventions of this model's data source, or undefined when none
+   * are configured or no data source resolves.
+   */
+  private relationDefaultsOrUndefined;
   /**
    * Get a loaded relation by name.
    *

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.mts","names":[],"sources":["../../../../../../../cascade/src/model/model.ts"],"mappings":"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"}
+{"version":3,"file":"model.d.mts","names":[],"sources":["../../../../../../../cascade/src/model/model.ts"],"mappings":"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"}

package/esm/model/model.mjs

@@ -1,4 +1,5 @@
 import { ModelEvents } from "../events/model-events.mjs";
+import { inferBelongsToForeignKey } from "../relations/key-conventions.mjs";
 import { getAllModelsFromRegistry, getModelFromRegistry } from "./register-model.mjs";
 import { RelationLoader, attachLoadedRelation } from "../relations/relation-loader.mjs";
 import { modelSync } from "../sync/model-sync.mjs";
@@ -6,6 +7,7 @@ import { decrementField, getBooleanField, getFieldValue, getNumberField, getOnly
 import { deleteOneRecord, deleteRecords, destroyModel } from "./methods/delete-methods.mjs";
 import { checkHasChanges, checkIsDirty, getDirtyColumns, getDirtyColumnsWithValues, getRemovedColumns } from "./methods/dirty-methods.mjs";
 import { cloneModel, deepFreezeObject, hydrateModel, modelFromSnapshot, modelToSnapshot, replaceModelData, serializeModel } from "./methods/hydration-methods.mjs";
+import { cleanupModelEvents, getGlobalEvents, getModelEvents, offStaticEvent, onStaticEvent, onceStaticEvent } from "./methods/static-event-methods.mjs";
 import { emitModelEvent, offModelEvent, onModelEvent, onceModelEvent } from "./methods/instance-event-methods.mjs";
 import { applyDefaultsToModel, generateModelNextId, performAtomicDecrement, performAtomicIncrement, performAtomicUpdate } from "./methods/meta-methods.mjs";
 import { attachPivotRelation, detachPivotRelation, pivotRelation } from "./methods/pivot-methods.mjs";
@@ -13,7 +15,6 @@ import { modelToJSON } from "./methods/serialization-methods.mjs";
 import { buildNewQueryBuilder, buildQuery, countRecords, decreaseField, findAll, findAndReplaceRecord, findAndUpdateRecords, findById, findFirst, findLast, findLatest, findOneAndDeleteRecord, findOneAndUpdateRecord, increaseField, paginateRecords, performAtomic, resolveDataSource, updateById } from "./methods/query-methods.mjs";
 import { restoreAllRecords, restoreRecord } from "./methods/restore-methods.mjs";
 import { addGlobalModelScope, addLocalModelScope, removeGlobalModelScope, removeLocalModelScope } from "./methods/scope-methods.mjs";
-import { cleanupModelEvents, getGlobalEvents, getModelEvents, offStaticEvent, onStaticEvent, onceStaticEvent } from "./methods/static-event-methods.mjs";
 import { createManyRecords, createRecord, findOrCreateRecord, saveModel, upsertRecord } from "./methods/write-methods.mjs";
 
 //#region ../cascade/src/model/model.ts
@@ -265,7 +266,7 @@ var Model = class Model {
 	* }
 	* ```
 	*/
-	static incrementIdBy = 1;
+	static incrementIdBy;
 	/**
 	* Randomly generate the increment amount.
 	*
@@ -545,15 +546,47 @@ var Model = class Model {
 		return this.loadedRelations.has(relationName);
 	}
 	/**
-	* Set relation manually
+	* Set relation manually.
+	*
+	* For a `belongsTo` relation this also writes the foreign-key column on
+	* this model (the declared `foreignKey`, else the inferred `<relation>_id`)
+	* from the related model's owner key, so `post.setRelation("author", user)`
+	* followed by `save()` persists `author_id`. Passing `null` clears the FK.
+	* The FK is left untouched when the related model carries no owner key yet.
+	*
+	* For `hasOne`, `hasMany`, `belongsToMany` and undeclared relations only the
+	* in-memory relation is set; no foreign key is written (the key lives on the
+	* other side or in a pivot table).
 	*
 	* @param relationName
 	* @param relationData
 	*/
 	setRelation(relationName, relationData) {
+		const definition = this.self().relations?.[relationName];
+		if (definition?.type === "belongsTo" && !Array.isArray(relationData)) {
+			const foreignKey = definition.foreignKey ?? inferBelongsToForeignKey(relationName, this.relationDefaultsOrUndefined());
+			if (relationData === null) this.set(foreignKey, null);
+			else if (relationData) {
+				const related = relationData;
+				const ownerKey = definition.localKey ?? related.self().primaryKey ?? "id";
+				const ownerValue = related.get(ownerKey);
+				if (ownerValue !== void 0 && ownerValue !== null) this.set(foreignKey, ownerValue);
+			}
+		}
 		attachLoadedRelation(this, relationName, relationData);
 	}
 	/**
+	* Relation conventions of this model's data source, or undefined when none
+	* are configured or no data source resolves.
+	*/
+	relationDefaultsOrUndefined() {
+		try {
+			return this.self().getDataSource()?.relationDefaults;
+		} catch {
+			return;
+		}
+	}
+	/**
 	* Get a loaded relation by name.
 	*
 	* Returns undefined if the relation has not been loaded.
@@ -651,7 +684,7 @@ var Model = class Model {
 	* Get model id
 	*/
 	get id() {
-		return this.get("id");
+		return this.get(this.self().primaryKey);
 	}
 	/**
 	* String-typed accessor for the model's primary id.
@@ -673,7 +706,8 @@ var Model = class Model {
 	* ```
 	*/
 	get uuid() {
-		return this.get("id");
+		const value = this.get(this.self().primaryKey);
+		return value === void 0 || value === null ? value : String(value);
 	}
 	get(field, defaultValue) {
 		return getFieldValue(this, field, defaultValue);