@warlock.js/cascade 5.20.0 → 5.21.0

package/esm/validation/plugins/embed-validator-plugin.d.mts

@@ -7,8 +7,8 @@ type EmbedOptions = {
 };
 declare module "@warlock.js/seal" {
   interface ValidatorV {
-    embed(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
-    embedMany(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
+    embed(model?: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
+    embedMany(model?: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;
   }
 }
 /**

package/esm/validation/plugins/embed-validator-plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"mappings":";;;KAWK,YAAA;EACH,YAAA;EACA,KAAK;AAAA;AAAA;EAAA,UAIK,UAAA;IACR,KAAA,CAAM,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;IAChE,SAAA,CAAU,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;EAAA;AAAA"}
+{"version":3,"file":"embed-validator-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"mappings":";;;KAWK,YAAA;EACH,YAAA;EACA,KAAK;AAAA;AAAA;EAAA,UAIK,UAAA;IACR,KAAA,CAAM,KAAA,GAAQ,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;IACjE,SAAA,CAAU,KAAA,GAAQ,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;EAAA;AAAA"}

package/esm/validation/plugins/embed-validator-plugin.mjs

@@ -10,8 +10,14 @@ const embedValidator = {
 	version: "1.0.0",
 	description: "Adds embed validation (v.embed())",
 	install() {
-		v.embed = (model, options) => new EmbedModelValidator().model(model).embed(options?.embed);
-		v.embedMany = (model, options) => new EmbedModelValidator().models(model).embed(options?.embed);
+		v.embed = (model, options) => {
+			const validator = new EmbedModelValidator();
+			return (model ? validator.model(model, options?.errorMessage) : validator).embed(options?.embed);
+		};
+		v.embedMany = (model, options) => {
+			const validator = new EmbedModelValidator();
+			return (model ? validator.models(model, options?.errorMessage) : validator).embed(options?.embed);
+		};
 	}
 };
 

package/esm/validation/plugins/embed-validator-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"sourcesContent":["/**\n * Embed Validator Plugin\n *\n * Adds embed validation to Seal v factory\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { v } from \"@warlock.js/seal\";\nimport type { ChildModel } from \"../../model/model\";\nimport { EmbedModelValidator } from \"../validators/embed-validator\";\n\ntype EmbedOptions = {\n  errorMessage?: string;\n  embed?: string | string[];\n};\n\ndeclare module \"@warlock.js/seal\" {\n  interface ValidatorV {\n    embed(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n    embedMany(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n  }\n}\n\n/**\n * File validation plugin for Seal\n */\nexport const embedValidator: SealPlugin = {\n  name: \"embed\",\n  version: \"1.0.0\",\n  description: \"Adds embed validation (v.embed())\",\n\n  install() {\n    // Inject embed() method into v factory\n    v.embed = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().model(model).embed(options?.embed);\n    v.embedMany = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().models(model).embed(options?.embed);\n  },\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,iBAA6B;CACxC,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EAER,EAAE,SAAS,OAAiC,YAC1C,IAAI,oBAAoB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;EAC7D,EAAE,aAAa,OAAiC,YAC9C,IAAI,oBAAoB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;CAChE;AACF"}
+{"version":3,"file":"embed-validator-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"sourcesContent":["/**\n * Embed Validator Plugin\n *\n * Adds embed validation to Seal v factory\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { v } from \"@warlock.js/seal\";\nimport type { ChildModel } from \"../../model/model\";\nimport { EmbedModelValidator } from \"../validators/embed-validator\";\n\ntype EmbedOptions = {\n  errorMessage?: string;\n  embed?: string | string[];\n};\n\ndeclare module \"@warlock.js/seal\" {\n  interface ValidatorV {\n    embed(model?: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n    embedMany(model?: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n  }\n}\n\n/**\n * File validation plugin for Seal\n */\nexport const embedValidator: SealPlugin = {\n  name: \"embed\",\n  version: \"1.0.0\",\n  description: \"Adds embed validation (v.embed())\",\n\n  install() {\n    // Inject embed() method into v factory\n    // without a model, a bare validator is returned (call .model()/.models() later)\n    v.embed = (model?: ChildModel<any> | string, options?: EmbedOptions) => {\n      const validator = new EmbedModelValidator();\n\n      return (model ? validator.model(model, options?.errorMessage) : validator).embed(\n        options?.embed,\n      );\n    };\n    v.embedMany = (model?: ChildModel<any> | string, options?: EmbedOptions) => {\n      const validator = new EmbedModelValidator();\n\n      return (model ? validator.models(model, options?.errorMessage) : validator).embed(\n        options?.embed,\n      );\n    };\n  },\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,iBAA6B;CACxC,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EAGR,EAAE,SAAS,OAAkC,YAA2B;GACtE,MAAM,YAAY,IAAI,oBAAoB;GAE1C,QAAQ,QAAQ,UAAU,MAAM,OAAO,SAAS,YAAY,IAAI,UAAS,CAAE,MACzE,SAAS,KACX;EACF;EACA,EAAE,aAAa,OAAkC,YAA2B;GAC1E,MAAM,YAAY,IAAI,oBAAoB;GAE1C,QAAQ,QAAQ,UAAU,OAAO,OAAO,SAAS,YAAY,IAAI,UAAS,CAAE,MAC1E,SAAS,KACX;EACF;CACF;AACF"}

package/esm/validation/rules/database-model-rule.mjs

@@ -1,4 +1,4 @@
-import { getModelFromRegistry } from "../../model/register-model.mjs";
+import { requireModelClass } from "../../model/register-model.mjs";
 import { Model } from "../../model/model.mjs";
 import { VALID_RULE, invalidRule } from "@warlock.js/seal";
 
@@ -8,7 +8,8 @@ const databaseModelRule = {
 	defaultErrorMessage: "The :input must be a valid :model model",
 	async validate(value, context) {
 		if (value instanceof Model === false) {
-			this.context.attributesList.model = this.context.options.model?.name;
+			const { model } = this.context.options;
+			this.context.attributesList.model = typeof model === "string" ? model : model?.name;
 			return invalidRule(this, context);
 		}
 		return VALID_RULE;
@@ -18,9 +19,9 @@ const databaseModelsRule = {
 	name: "databaseModels",
 	defaultErrorMessage: "The :input must be a list of valid :model",
 	async validate(value, context) {
-		let { model } = this.context.options;
-		if (typeof model === "string") model = getModelFromRegistry(model);
-		this.context.attributesList.model = model.name;
+		const { model } = this.context.options;
+		const ModelClass = requireModelClass(model);
+		this.context.attributesList.model = typeof model === "string" ? model : ModelClass.name;
 		if (!Array.isArray(value)) return invalidRule(this, context);
 		if (value.every((item) => item instanceof Model)) return VALID_RULE;
 		return invalidRule(this, context);

package/esm/validation/rules/database-model-rule.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-model-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/database-model-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\r\nimport { type ChildModel, Model } from \"./../../model/model\";\r\nimport { getModelFromRegistry } from \"./../../model/register-model\";\r\n\r\nexport const databaseModelRule: SchemaRule = {\r\n  name: \"databaseModel\",\r\n  defaultErrorMessage: \"The :input must be a valid :model model\",\r\n  async validate(value, context) {\r\n    if (value instanceof Model === false) {\r\n      this.context.attributesList.model = this.context.options.model?.name;\r\n      return invalidRule(this, context);\r\n    }\r\n\r\n    return VALID_RULE;\r\n  },\r\n};\r\n\r\nexport const databaseModelsRule: SchemaRule<{ model: ChildModel<any> | string }> = {\r\n  name: \"databaseModels\",\r\n  defaultErrorMessage: \"The :input must be a list of valid :model\",\r\n  async validate(value, context) {\r\n    let { model } = this.context.options;\r\n    if (typeof model === \"string\") {\r\n      model = getModelFromRegistry(model)!;\r\n    }\r\n\r\n    this.context.attributesList.model = model.name;\r\n\r\n    if (!Array.isArray(value)) return invalidRule(this, context);\r\n\r\n    if (value.every((item) => item instanceof Model)) return VALID_RULE;\r\n\r\n    return invalidRule(this, context);\r\n  },\r\n};\r\n"],"mappings":";;;;;AAIA,MAAa,oBAAgC;CAC3C,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,iBAAiB,UAAU,OAAO;GACpC,KAAK,QAAQ,eAAe,QAAQ,KAAK,QAAQ,QAAQ,OAAO;GAChE,OAAO,YAAY,MAAM,OAAO;EAClC;EAEA,OAAO;CACT;AACF;AAEA,MAAa,qBAAsE;CACjF,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,EAAE,UAAU,KAAK,QAAQ;EAC7B,IAAI,OAAO,UAAU,UACnB,QAAQ,qBAAqB,KAAK;EAGpC,KAAK,QAAQ,eAAe,QAAQ,MAAM;EAE1C,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,YAAY,MAAM,OAAO;EAE3D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;EAEzD,OAAO,YAAY,MAAM,OAAO;CAClC;AACF"}
+{"version":3,"file":"database-model-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/database-model-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\nimport { type ChildModel, Model } from \"./../../model/model\";\nimport { requireModelClass } from \"./../../model/register-model\";\n\nexport const databaseModelRule: SchemaRule = {\n  name: \"databaseModel\",\n  defaultErrorMessage: \"The :input must be a valid :model model\",\n  async validate(value, context) {\n    if (value instanceof Model === false) {\n      const { model } = this.context.options;\n\n      this.context.attributesList.model = typeof model === \"string\" ? model : model?.name;\n      return invalidRule(this, context);\n    }\n\n    return VALID_RULE;\n  },\n};\n\nexport const databaseModelsRule: SchemaRule<{ model: ChildModel<any> | string }> = {\n  name: \"databaseModels\",\n  defaultErrorMessage: \"The :input must be a list of valid :model\",\n  async validate(value, context) {\n    const { model } = this.context.options;\n\n    // keep the original name for messages; throws when a string ref is unregistered\n    const ModelClass = requireModelClass(model);\n\n    this.context.attributesList.model = typeof model === \"string\" ? model : ModelClass.name;\n\n    if (!Array.isArray(value)) return invalidRule(this, context);\n\n    if (value.every((item) => item instanceof Model)) return VALID_RULE;\n\n    return invalidRule(this, context);\n  },\n};\n"],"mappings":";;;;;AAIA,MAAa,oBAAgC;CAC3C,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,iBAAiB,UAAU,OAAO;GACpC,MAAM,EAAE,UAAU,KAAK,QAAQ;GAE/B,KAAK,QAAQ,eAAe,QAAQ,OAAO,UAAU,WAAW,QAAQ,OAAO;GAC/E,OAAO,YAAY,MAAM,OAAO;EAClC;EAEA,OAAO;CACT;AACF;AAEA,MAAa,qBAAsE;CACjF,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,MAAM,EAAE,UAAU,KAAK,QAAQ;EAG/B,MAAM,aAAa,kBAAkB,KAAK;EAE1C,KAAK,QAAQ,eAAe,QAAQ,OAAO,UAAU,WAAW,QAAQ,WAAW;EAEnF,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,YAAY,MAAM,OAAO;EAE3D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;EAEzD,OAAO,YAAY,MAAM,OAAO;CAClC;AACF"}

package/esm/validation/rules/exists-rule.mjs

@@ -1,4 +1,4 @@
-import { resolveModelClass } from "../../model/register-model.mjs";
+import { requireModelClass } from "../../model/register-model.mjs";
 import { VALID_RULE, invalidRule } from "@warlock.js/seal";
 
 //#region ../cascade/src/validation/rules/exists-rule.ts
@@ -12,9 +12,11 @@ const existsRule = {
 	name: "exists",
 	defaultErrorMessage: "The :input must exist",
 	async validate(value, context) {
-		const { Model, query, column = context.key } = this.context.options;
-		const dbQuery = resolveModelClass(Model).query();
-		dbQuery.where(column, value);
+		const { Model, query, column } = this.context.options;
+		const ResolvedModelClass = requireModelClass(Model);
+		const lookupColumn = column ?? ResolvedModelClass.primaryKey;
+		const dbQuery = ResolvedModelClass.query();
+		dbQuery.where(lookupColumn, value);
 		if (query) await query({
 			query: dbQuery,
 			value,

package/esm/validation/rules/exists-rule.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"exists-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/exists-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\nimport { resolveModelClass } from \"../../model/register-model\";\nimport type { ExistsRuleOptions } from \"../types\";\n\n/**\n * Validates that a record exists in the database for the given column/value.\n *\n * @example\n * v.string().exists(Organization, { column: \"id\" });\n */\nexport const existsRule: SchemaRule<ExistsRuleOptions> = {\n  name: \"exists\",\n  defaultErrorMessage: \"The :input must exist\",\n  async validate(value: any, context) {\n    const { Model, query, column = context.key } = this.context.options;\n\n    const ResolvedModelClass = resolveModelClass(Model);\n\n    const dbQuery = ResolvedModelClass.query();\n\n    dbQuery.where(column, value);\n\n    if (query) {\n      await query({\n        query: dbQuery,\n        value,\n        allValues: context.allValues,\n      });\n    }\n\n    const document = await dbQuery.first();\n\n    return document ? VALID_RULE : invalidRule(this, context);\n  },\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,aAA4C;CACvD,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAY,SAAS;EAClC,MAAM,EAAE,OAAO,OAAO,SAAS,QAAQ,QAAQ,KAAK,QAAQ;EAI5D,MAAM,UAFqB,kBAAkB,KAEZ,CAAC,CAAC,MAAM;EAEzC,QAAQ,MAAM,QAAQ,KAAK;EAE3B,IAAI,OACF,MAAM,MAAM;GACV,OAAO;GACP;GACA,WAAW,QAAQ;EACrB,CAAC;EAKH,OAAO,MAFgB,QAAQ,MAAM,IAEnB,aAAa,YAAY,MAAM,OAAO;CAC1D;AACF"}
+{"version":3,"file":"exists-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/exists-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\nimport { requireModelClass } from \"../../model/register-model\";\nimport type { ExistsRuleOptions } from \"../types\";\n\n/**\n * Validates that a record exists in the database for the given column/value.\n *\n * @example\n * v.string().exists(Organization, { column: \"id\" });\n */\nexport const existsRule: SchemaRule<ExistsRuleOptions> = {\n  name: \"exists\",\n  defaultErrorMessage: \"The :input must exist\",\n  async validate(value: any, context) {\n    const { Model, query, column } = this.context.options;\n\n    const ResolvedModelClass = requireModelClass(Model);\n\n    // Explicit column wins, otherwise look up by the related model's primary key\n    const lookupColumn = column ?? ResolvedModelClass.primaryKey;\n\n    const dbQuery = ResolvedModelClass.query();\n\n    dbQuery.where(lookupColumn, value);\n\n    if (query) {\n      await query({\n        query: dbQuery,\n        value,\n        allValues: context.allValues,\n      });\n    }\n\n    const document = await dbQuery.first();\n\n    return document ? VALID_RULE : invalidRule(this, context);\n  },\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,aAA4C;CACvD,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAY,SAAS;EAClC,MAAM,EAAE,OAAO,OAAO,WAAW,KAAK,QAAQ;EAE9C,MAAM,qBAAqB,kBAAkB,KAAK;EAGlD,MAAM,eAAe,UAAU,mBAAmB;EAElD,MAAM,UAAU,mBAAmB,MAAM;EAEzC,QAAQ,MAAM,cAAc,KAAK;EAEjC,IAAI,OACF,MAAM,MAAM;GACV,OAAO;GACP;GACA,WAAW,QAAQ;EACrB,CAAC;EAKH,OAAO,MAFgB,QAAQ,MAAM,IAEnB,aAAa,YAAY,MAAM,OAAO;CAC1D;AACF"}

package/esm/validation/rules/unique-rule.mjs

@@ -1,4 +1,4 @@
-import { resolveModelClass } from "../../model/register-model.mjs";
+import { requireModelClass } from "../../model/register-model.mjs";
 import { get } from "@mongez/reinforcements";
 import { VALID_RULE, invalidRule } from "@warlock.js/seal";
 
@@ -22,12 +22,15 @@ const uniqueRule = {
 	defaultErrorMessage: "The :input must be unique",
 	async validate(value, context) {
 		const { Model, except, column = context.key, exceptColumnName, exceptValue, query } = this.context.options;
-		const dbQuery = resolveModelClass(Model).query();
+		const ResolvedModelClass = requireModelClass(Model);
+		const dbQuery = ResolvedModelClass.query();
 		dbQuery.where(column, value);
 		if (except) {
 			const exceptVal = get(context.allValues, except);
 			if (exceptVal !== void 0) dbQuery.where(except, "!=", exceptVal);
 		}
+		const currentModel = context.rootContext?.model;
+		if (currentModel && currentModel.isNew === false && currentModel.constructor === ResolvedModelClass && currentModel.trustedPrimaryKey !== void 0) dbQuery.where(ResolvedModelClass.primaryKey || "id", "!=", currentModel.trustedPrimaryKey);
 		if (exceptColumnName !== void 0) dbQuery.where(exceptColumnName, "!=", exceptValue);
 		if (query) await query({
 			query: dbQuery,

package/esm/validation/rules/unique-rule.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"unique-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/unique-rule.ts"],"sourcesContent":["import { get } from \"@mongez/reinforcements\";\nimport { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\nimport { resolveModelClass } from \"../../model/register-model\";\nimport type { UniqueRuleOptions } from \"../types\";\n\n/**\n * Validates that a value is unique against a database column.\n *\n * Supports three exclusion modes:\n * - `except`: read a sibling input's value and exclude rows where that\n *   column equals the sibling's value\n * - `exceptColumnName` + `exceptValue`: exclude rows where the named\n *   column equals the supplied value (used by request-aware wrappers)\n * - Custom `query` callback for anything more involved\n *\n * @example\n * v.email().unique(\"User\");\n * v.string().unique(\"User\", { except: \"id\" });\n */\nexport const uniqueRule: SchemaRule<UniqueRuleOptions> = {\n  name: \"unique\",\n  defaultErrorMessage: \"The :input must be unique\",\n  async validate(value: any, context) {\n    const {\n      Model,\n      except,\n      column = context.key,\n      exceptColumnName,\n      exceptValue,\n      query,\n    } = this.context.options;\n\n    const ResolvedModelClass = resolveModelClass(Model);\n\n    const dbQuery = ResolvedModelClass.query();\n\n    dbQuery.where(column, value);\n\n    if (except) {\n      const exceptVal = get(context.allValues, except);\n\n      if (exceptVal !== undefined) {\n        dbQuery.where(except, \"!=\", exceptVal);\n      }\n    }\n\n    if (exceptColumnName !== undefined) {\n      dbQuery.where(exceptColumnName, \"!=\", exceptValue);\n    }\n\n    if (query) {\n      await query({\n        query: dbQuery,\n        value,\n        allValues: context.allValues,\n      });\n    }\n\n    const document = await dbQuery.first();\n\n    return document ? invalidRule(this, context) : VALID_RULE;\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,aAA4C;CACvD,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAY,SAAS;EAClC,MAAM,EACJ,OACA,QACA,SAAS,QAAQ,KACjB,kBACA,aACA,UACE,KAAK,QAAQ;EAIjB,MAAM,UAFqB,kBAAkB,KAEZ,CAAC,CAAC,MAAM;EAEzC,QAAQ,MAAM,QAAQ,KAAK;EAE3B,IAAI,QAAQ;GACV,MAAM,YAAY,IAAI,QAAQ,WAAW,MAAM;GAE/C,IAAI,cAAc,QAChB,QAAQ,MAAM,QAAQ,MAAM,SAAS;EAEzC;EAEA,IAAI,qBAAqB,QACvB,QAAQ,MAAM,kBAAkB,MAAM,WAAW;EAGnD,IAAI,OACF,MAAM,MAAM;GACV,OAAO;GACP;GACA,WAAW,QAAQ;EACrB,CAAC;EAKH,OAAO,MAFgB,QAAQ,MAAM,IAEnB,YAAY,MAAM,OAAO,IAAI;CACjD;AACF"}
+{"version":3,"file":"unique-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/unique-rule.ts"],"sourcesContent":["import { get } from \"@mongez/reinforcements\";\nimport { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\nimport { requireModelClass } from \"../../model/register-model\";\nimport type { UniqueRuleOptions } from \"../types\";\n\n/**\n * Validates that a value is unique against a database column.\n *\n * Supports three exclusion modes:\n * - `except`: read a sibling input's value and exclude rows where that\n *   column equals the sibling's value\n * - `exceptColumnName` + `exceptValue`: exclude rows where the named\n *   column equals the supplied value (used by request-aware wrappers)\n * - Custom `query` callback for anything more involved\n *\n * @example\n * v.email().unique(\"User\");\n * v.string().unique(\"User\", { except: \"id\" });\n */\nexport const uniqueRule: SchemaRule<UniqueRuleOptions> = {\n  name: \"unique\",\n  defaultErrorMessage: \"The :input must be unique\",\n  async validate(value: any, context) {\n    const {\n      Model,\n      except,\n      column = context.key,\n      exceptColumnName,\n      exceptValue,\n      query,\n    } = this.context.options;\n\n    const ResolvedModelClass = requireModelClass(Model);\n\n    const dbQuery = ResolvedModelClass.query();\n\n    dbQuery.where(column, value);\n\n    if (except) {\n      const exceptVal = get(context.allValues, except);\n\n      if (exceptVal !== undefined) {\n        dbQuery.where(except, \"!=\", exceptVal);\n      }\n    }\n\n    // A persisted model never collides with its own row on update.\n    const currentModel = context.rootContext?.model;\n\n    if (\n      currentModel &&\n      currentModel.isNew === false &&\n      currentModel.constructor === ResolvedModelClass &&\n      currentModel.trustedPrimaryKey !== undefined\n    ) {\n      dbQuery.where(\n        (ResolvedModelClass as any).primaryKey || \"id\",\n        \"!=\",\n        currentModel.trustedPrimaryKey,\n      );\n    }\n\n    if (exceptColumnName !== undefined) {\n      dbQuery.where(exceptColumnName, \"!=\", exceptValue);\n    }\n\n    if (query) {\n      await query({\n        query: dbQuery,\n        value,\n        allValues: context.allValues,\n      });\n    }\n\n    const document = await dbQuery.first();\n\n    return document ? invalidRule(this, context) : VALID_RULE;\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,aAA4C;CACvD,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAY,SAAS;EAClC,MAAM,EACJ,OACA,QACA,SAAS,QAAQ,KACjB,kBACA,aACA,UACE,KAAK,QAAQ;EAEjB,MAAM,qBAAqB,kBAAkB,KAAK;EAElD,MAAM,UAAU,mBAAmB,MAAM;EAEzC,QAAQ,MAAM,QAAQ,KAAK;EAE3B,IAAI,QAAQ;GACV,MAAM,YAAY,IAAI,QAAQ,WAAW,MAAM;GAE/C,IAAI,cAAc,QAChB,QAAQ,MAAM,QAAQ,MAAM,SAAS;EAEzC;EAGA,MAAM,eAAe,QAAQ,aAAa;EAE1C,IACE,gBACA,aAAa,UAAU,SACvB,aAAa,gBAAgB,sBAC7B,aAAa,sBAAsB,QAEnC,QAAQ,MACL,mBAA2B,cAAc,MAC1C,MACA,aAAa,iBACf;EAGF,IAAI,qBAAqB,QACvB,QAAQ,MAAM,kBAAkB,MAAM,WAAW;EAGnD,IAAI,OACF,MAAM,MAAM;GACV,OAAO;GACP;GACA,WAAW,QAAQ;EACrB,CAAC;EAKH,OAAO,MAFgB,QAAQ,MAAM,IAEnB,YAAY,MAAM,OAAO,IAAI;CACjD;AACF"}

package/esm/validation/validators/embed-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/validators/embed-validator.ts"],"mappings":";;;;cAMa,mBAAA,SAA4B,aAAA;;;AAAzC;EAIS,WAAA,CAAY,KAAA;;;;EAWZ,KAAA,CAAM,KAAA,EAAO,UAAA,gBAA0B,YAAA,YAAwB,mBAAA;EAaC;;;EAAhE,MAAA,CAAO,KAAA,EAAO,UAAA,gBAA0B,YAAA,YAAwB,mBAAA;EA5BnB;;;EA6C7C,KAAA,CAAM,KAAA,uBAA4B,mBAAA;AAAA"}
+{"version":3,"file":"embed-validator.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/validators/embed-validator.ts"],"mappings":";;;;cAMa,mBAAA,SAA4B,aAAA;;;AAAzC;EAIS,WAAA,CAAY,KAAA;;;;EAYZ,KAAA,CAAM,KAAA,EAAO,UAAA,gBAA0B,YAAA,YAAwB,mBAAA;EAaC;;;EAAhE,MAAA,CAAO,KAAA,EAAO,UAAA,gBAA0B,YAAA,YAAwB,mBAAA;EA7BnB;;;EA8C7C,KAAA,CAAM,KAAA,uBAA4B,mBAAA;AAAA"}

package/esm/validation/validators/embed-validator.mjs

@@ -10,7 +10,7 @@ var EmbedModelValidator = class extends BaseValidator {
 	* Check if value is a string type
 	*/
 	matchesType(value) {
-		return value instanceof Model || typeof value === "number" || Array.isArray(value) && value.every((item) => item instanceof Model);
+		return value instanceof Model || typeof value === "number" || typeof value === "string" || Array.isArray(value) && value.every((item) => item instanceof Model);
 	}
 	/**
 	* Mutate the value to be a model, also fail if the mutated value is not a valid model

package/esm/validation/validators/embed-validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/validators/embed-validator.ts"],"sourcesContent":["import { arrayRule, BaseValidator } from \"@warlock.js/seal\";\nimport { Model, type ChildModel } from \"../../model/model\";\nimport { databaseModelMutator, databaseModelsMutator } from \"../mutators/embed-mutator\";\nimport { databaseModelRule, databaseModelsRule } from \"../rules/database-model-rule\";\nimport { databaseModelTransformer } from \"../transformers/embed-model-transformer\";\n\nexport class EmbedModelValidator extends BaseValidator {\n  /**\n   * Check if value is a string type\n   */\n  public matchesType(value: any): boolean {\n    return (\n      value instanceof Model ||\n      typeof value === \"number\" ||\n      (Array.isArray(value) && value.every((item) => item instanceof Model))\n    );\n  }\n\n  /**\n   * Mutate the value to be a model, also fail if the mutated value is not a valid model\n   */\n  public model(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator {\n    this.addMutator(databaseModelMutator, {\n      model,\n    });\n\n    return this.addRule(databaseModelRule, errorMessage, {\n      model,\n    });\n  }\n\n  /**\n   * Validate the value is a list of models\n   */\n  public models(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator {\n    const instance = this.instance;\n    instance.addMutator(databaseModelsMutator, {\n      model,\n    });\n\n    instance.addMutableRule(arrayRule);\n    instance.addMutableRule(databaseModelsRule, errorMessage, {\n      model,\n    });\n\n    return instance;\n  }\n\n  /**\n   * Determine how the data will be stored as an embedded document\n   */\n  public embed(embed?: string | string[]): EmbedModelValidator {\n    return this.addTransformer(databaseModelTransformer, {\n      embed,\n    });\n  }\n}\n"],"mappings":";;;;;;;AAMA,IAAa,sBAAb,cAAyC,cAAc;;;;CAIrD,AAAO,YAAY,OAAqB;EACtC,OACE,iBAAiB,SACjB,OAAO,UAAU,YAChB,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,gBAAgB,KAAK;CAExE;;;;CAKA,AAAO,MAAM,OAAiC,cAA4C;EACxF,KAAK,WAAW,sBAAsB,EACpC,MACF,CAAC;EAED,OAAO,KAAK,QAAQ,mBAAmB,cAAc,EACnD,MACF,CAAC;CACH;;;;CAKA,AAAO,OAAO,OAAiC,cAA4C;EACzF,MAAM,WAAW,KAAK;EACtB,SAAS,WAAW,uBAAuB,EACzC,MACF,CAAC;EAED,SAAS,eAAe,SAAS;EACjC,SAAS,eAAe,oBAAoB,cAAc,EACxD,MACF,CAAC;EAED,OAAO;CACT;;;;CAKA,AAAO,MAAM,OAAgD;EAC3D,OAAO,KAAK,eAAe,0BAA0B,EACnD,MACF,CAAC;CACH;AACF"}
+{"version":3,"file":"embed-validator.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/validators/embed-validator.ts"],"sourcesContent":["import { arrayRule, BaseValidator } from \"@warlock.js/seal\";\nimport { Model, type ChildModel } from \"../../model/model\";\nimport { databaseModelMutator, databaseModelsMutator } from \"../mutators/embed-mutator\";\nimport { databaseModelRule, databaseModelsRule } from \"../rules/database-model-rule\";\nimport { databaseModelTransformer } from \"../transformers/embed-model-transformer\";\n\nexport class EmbedModelValidator extends BaseValidator {\n  /**\n   * Check if value is a string type\n   */\n  public matchesType(value: any): boolean {\n    return (\n      value instanceof Model ||\n      typeof value === \"number\" ||\n      typeof value === \"string\" ||\n      (Array.isArray(value) && value.every((item) => item instanceof Model))\n    );\n  }\n\n  /**\n   * Mutate the value to be a model, also fail if the mutated value is not a valid model\n   */\n  public model(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator {\n    this.addMutator(databaseModelMutator, {\n      model,\n    });\n\n    return this.addRule(databaseModelRule, errorMessage, {\n      model,\n    });\n  }\n\n  /**\n   * Validate the value is a list of models\n   */\n  public models(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator {\n    const instance = this.instance;\n    instance.addMutator(databaseModelsMutator, {\n      model,\n    });\n\n    instance.addMutableRule(arrayRule);\n    instance.addMutableRule(databaseModelsRule, errorMessage, {\n      model,\n    });\n\n    return instance;\n  }\n\n  /**\n   * Determine how the data will be stored as an embedded document\n   */\n  public embed(embed?: string | string[]): EmbedModelValidator {\n    return this.addTransformer(databaseModelTransformer, {\n      embed,\n    });\n  }\n}\n"],"mappings":";;;;;;;AAMA,IAAa,sBAAb,cAAyC,cAAc;;;;CAIrD,AAAO,YAAY,OAAqB;EACtC,OACE,iBAAiB,SACjB,OAAO,UAAU,YACjB,OAAO,UAAU,YAChB,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,gBAAgB,KAAK;CAExE;;;;CAKA,AAAO,MAAM,OAAiC,cAA4C;EACxF,KAAK,WAAW,sBAAsB,EACpC,MACF,CAAC;EAED,OAAO,KAAK,QAAQ,mBAAmB,cAAc,EACnD,MACF,CAAC;CACH;;;;CAKA,AAAO,OAAO,OAAiC,cAA4C;EACzF,MAAM,WAAW,KAAK;EACtB,SAAS,WAAW,uBAAuB,EACzC,MACF,CAAC;EAED,SAAS,eAAe,SAAS;EACjC,SAAS,eAAe,oBAAoB,cAAc,EACxD,MACF,CAAC;EAED,OAAO;CACT;;;;CAKA,AAAO,MAAM,OAAgD;EAC3D,OAAO,KAAK,eAAe,0BAA0B,EACnD,MACF,CAAC;CACH;AACF"}

package/esm/writer/database-writer.d.mts

@@ -39,6 +39,8 @@ import { WriterContract, WriterOptions, WriterResult } from "../contracts/databa
 declare class DatabaseWriter implements WriterContract {
   /** The model instance being persisted */
   private readonly model;
+  /** Dirty columns an update validation dropped (strip mode); never written. */
+  private readonly unvalidatedColumns;
   /** Model constructor reference */
   private readonly ctor;
   /** Data source containing driver and ID generator */
@@ -85,6 +87,13 @@ declare class DatabaseWriter implements WriterContract {
    * @private
    */
   private validateAndCast;
+  /**
+   * Validate, cast and id-generate a not-yet-persisted model for `upsert()`.
+   *
+   * Runs the insert-mode pipeline (schema, casts, strictMode, Mongo `id`) but
+   * does not write; the caller sends the resulting data through the driver.
+   */
+  prepareForUpsert(): Promise<void>;
   /**
    * Perform an insert operation.
    *
@@ -93,6 +102,18 @@ declare class DatabaseWriter implements WriterContract {
    * @private
    */
   private performInsert;
+  /**
+   * Run the insert pipeline (validation, casting, id generation, timestamps,
+   * `validating`/`validated`/`creating` hooks) WITHOUT writing.
+   *
+   * `save()` uses this for its insert path, so bulk inserts and single inserts
+   * cannot drift. The caller is responsible for sending the returned document
+   * to the driver.
+   *
+   * @param options - Save options (e.g. `skipEvents`, `skipValidation`)
+   * @returns The prepared document to insert
+   */
+  prepareForInsert(options?: WriterOptions): Promise<Record<string, unknown>>;
   /**
    * Perform an update operation.
    *
@@ -101,6 +122,12 @@ declare class DatabaseWriter implements WriterContract {
    * @private
    */
   private performUpdate;
+  /**
+   * Map a driver unique-constraint violation (Postgres 23505, MongoDB 11000)
+   * to a field validation error, so a lost `unique` race never surfaces as a
+   * 500. Any other error is returned untouched.
+   */
+  private mapUniqueViolation;
   /**
    * Build the filter that pins a write to the row this model was loaded from.
    *

package/esm/writer/database-writer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer.d.mts","names":[],"sources":["../../../../../../../cascade/src/writer/database-writer.ts"],"mappings":";;;;;;AAuDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,cAAA,YAA0B,cAAA;EA+UN;EAAA,iBA7Ud,KAAA;EA6aT;EAAA,iBA1aS,IAAA;EAydT;EAAA,iBAtdS,UAAA;EAmeQ;EAAA,iBAheR,MAAA;;mBAGA,KAAA;;mBAGA,UAAA;;mBAGA,MAAA;;mBAGA,UAAA;;;;;;;;;;;;;cAcE,KAAA,EAAO,KAAA;;;;;;;;EAkBb,IAAA,CAAK,OAAA,GAAS,aAAA,GAAqB,OAAA,CAAQ,YAAA;;;;;;;;;;;UAsE1C,eAAA;;;;;;;;UA8FA,aAAA;;;;;;;;UAqDA,aAAA;;;;;;;;;;;;UAsDN,qBAAA;;;;;;EASK,cAAA,IAAkB,OAAA;;;;;;;;;;;;;;;;;;;;;;UA6CvB,qBAAA;;;;;;;;;;;;UAmDA,gBAAA;;;;;;;;;;;;UAyBA,kBAAA;;;;;;;;;UAsBA,SAAA;;;;;;;;;;UAaM,WAAA;AAAA"}
+{"version":3,"file":"database-writer.d.mts","names":[],"sources":["../../../../../../../cascade/src/writer/database-writer.ts"],"mappings":";;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,cAAA,YAA0B,cAAA;EA+HvB;EAAA,iBA7HG,KAAA;EAkPgB;EAAA,iBA/OhB,kBAAA;EA8RJ;EAAA,iBA3RI,IAAA;EA2Ra;EAAA,iBAxRb,UAAA;EAwRmD;EAAA,iBArRnD,MAAA;EAqXT;EAAA,iBAlXS,KAAA;EA8aJ;EAAA,iBA3aI,UAAA;EAwdT;EAAA,iBArdS,MAAA;EAiiBT;EAAA,iBA9hBS,UAAA;EAikBH;;AAAW;;;;;;;;;;cAnjBN,KAAA,EAAO,KAAA;;;;;;;;EAkBb,IAAA,CAAK,OAAA,GAAS,aAAA,GAAqB,OAAA,CAAQ,YAAA;;;;;;;;;;;UAqE1C,eAAA;;;;;;;EAqHD,gBAAA,IAAoB,OAAA;;;;;;;;UAYnB,aAAA;;;;;;;;;;;;EAmCD,gBAAA,CAAiB,OAAA,GAAS,aAAA,GAAqB,OAAA,CAAQ,MAAA;;;;;;;;UA4CtD,aAAA;;;;;;UAoDN,kBAAA;;;;;;;;;;;;UAmDA,qBAAA;;;;;;EASK,cAAA,IAAkB,OAAA;;;;;;;;;;;;;;;;;;;;;;UA6CvB,qBAAA;;;;;;;;;;;;UAmDA,gBAAA;;;;;;;;;;;;UAyBA,kBAAA;;;;;;;;;UAsBA,SAAA;;;;;;;;;;UAaM,WAAA;AAAA"}

package/esm/writer/database-writer.mjs

@@ -1,9 +1,10 @@
-import { getModelUpdatedEvent } from "../sync/model-events.mjs";
+import { afterCommit } from "../transactions/after-commit.mjs";
+import { triggerModelEvent } from "../sync/model-events.mjs";
 import { mergeDriverFields } from "../model/methods/accessor-methods.mjs";
 import { DatabaseWriterValidationError } from "../validation/database-writer-validation-error.mjs";
 import "../validation/index.mjs";
+import { log } from "@warlock.js/logger";
 import { when } from "@mongez/reinforcements";
-import events from "@mongez/events";
 import { getSealConfig, v } from "@warlock.js/seal";
 
 //#region ../cascade/src/writer/database-writer.ts
@@ -44,6 +45,8 @@ import { getSealConfig, v } from "@warlock.js/seal";
 var DatabaseWriter = class {
 	/** The model instance being persisted */
 	model;
+	/** Dirty columns an update validation dropped (strip mode); never written. */
+	unvalidatedColumns = /* @__PURE__ */ new Set();
 	/** Model constructor reference */
 	ctor;
 	/** Data source containing driver and ID generator */
@@ -100,10 +103,12 @@ var DatabaseWriter = class {
 			options,
 			mode: isInsert ? "insert" : "update"
 		});
-		await this.validateAndCast(isInsert, options);
 		let result;
 		if (isInsert) result = await this.performInsert(options);
-		else result = await this.performUpdate(options);
+		else {
+			await this.validateAndCast(false, options);
+			result = await this.performUpdate(options);
+		}
 		const changedFields = isInsert ? [] : this.model.getDirtyColumns();
 		this.model.dirtyTracker.reset();
 		this.model.isNew = false;
@@ -111,7 +116,7 @@ var DatabaseWriter = class {
 			await this.model.emitEvent("saved");
 			await this.model.emitEvent(isInsert ? "created" : "updated");
 		}
-		if (!options.skipSync && !isInsert) this.triggerSync(changedFields);
+		if (!options.skipSync && !isInsert) afterCommit(() => this.triggerSync(changedFields));
 		return {
 			success: true,
 			document: this.model.data,
@@ -143,16 +148,16 @@ var DatabaseWriter = class {
 			...when(this.ctor.updatedAtColumn, () => ({ [this.ctor.updatedAtColumn]: v.date().optional() })),
 			...when(this.ctor.deletedAtColumn, () => ({ [this.ctor.deletedAtColumn]: v.date().optional() }))
 		};
-		const validationSchema = isInsert ? this.schema.clone().extend(systemColumns) : this.schema.clone(Object.keys(this.model.data)).extend(systemColumns);
+		const dataToValidate = isInsert ? this.model.data : Object.fromEntries(this.model.getDirtyColumns().filter((column) => column in this.model.data).map((column) => [column, this.model.data[column]]));
+		const validationSchema = isInsert ? this.schema.clone().extend(systemColumns) : this.schema.clone(Object.keys(dataToValidate)).extend(systemColumns);
 		if (this.strictMode === "strip") validationSchema.stripUnknown();
 		else if (this.strictMode === "fail") validationSchema.allowUnknown(false);
 		else if (this.strictMode === "allow") validationSchema.allowUnknown(true);
-		const result = await v.validate(validationSchema, this.model.data, {
+		const result = await v.validate(validationSchema, dataToValidate, {
 			context: { model: this.model },
 			...getSealConfig()
 		});
 		if (!result.isValid) {
-			console.trace(result.errors);
 			const error = new DatabaseWriterValidationError(`[${this.model.constructor.name} Model] ${isInsert ? "Insert" : "Update"} Validation failed`, result.errors);
 			if (!options.skipEvents) await this.model.emitEvent("validated", {
 				result,
@@ -160,10 +165,25 @@ var DatabaseWriter = class {
 			});
 			throw error;
 		}
-		this.model.replaceData(result.data);
+		if (isInsert) this.model.replaceData(result.data);
+		else {
+			const validated = result.data;
+			for (const column of Object.keys(dataToValidate)) if (column in validated) this.model.set(column, validated[column]);
+			else this.unvalidatedColumns.add(column);
+		}
 		if (!options.skipEvents) await this.model.emitEvent("validated", { result });
 	}
 	/**
+	* Validate, cast and id-generate a not-yet-persisted model for `upsert()`.
+	*
+	* Runs the insert-mode pipeline (schema, casts, strictMode, Mongo `id`) but
+	* does not write; the caller sends the resulting data through the driver.
+	*/
+	async prepareForUpsert() {
+		await this.validateAndCast(true, {});
+		await this.generateNextId();
+	}
+	/**
 	* Perform an insert operation.
 	*
 	* @param options - Save options
@@ -171,6 +191,30 @@ var DatabaseWriter = class {
 	* @private
 	*/
 	async performInsert(options) {
+		const dataToInsert = await this.prepareForInsert(options);
+		let result;
+		try {
+			result = await this.driver.insert(this.table, dataToInsert);
+		} catch (error) {
+			throw this.mapUniqueViolation(error, true);
+		}
+		mergeDriverFields(this.model, result.document);
+		this.model.dirtyTracker.reset();
+		return result;
+	}
+	/**
+	* Run the insert pipeline (validation, casting, id generation, timestamps,
+	* `validating`/`validated`/`creating` hooks) WITHOUT writing.
+	*
+	* `save()` uses this for its insert path, so bulk inserts and single inserts
+	* cannot drift. The caller is responsible for sending the returned document
+	* to the driver.
+	*
+	* @param options - Save options (e.g. `skipEvents`, `skipValidation`)
+	* @returns The prepared document to insert
+	*/
+	async prepareForInsert(options = {}) {
+		await this.validateAndCast(true, options);
 		await this.generateNextId();
 		const dataToInsert = this.model.data;
 		const createdAtColumn = this.ctor.createdAtColumn;
@@ -178,10 +222,7 @@ var DatabaseWriter = class {
 		const updatedAtColumn = this.ctor.updatedAtColumn;
 		if (updatedAtColumn) dataToInsert[updatedAtColumn] = /* @__PURE__ */ new Date();
 		if (!options.skipEvents) await this.model.emitEvent("creating");
-		const result = await this.driver.insert(this.table, dataToInsert);
-		mergeDriverFields(this.model, result.document);
-		this.model.dirtyTracker.reset();
-		return result;
+		return dataToInsert;
 	}
 	/**
 	* Perform an update operation.
@@ -201,7 +242,29 @@ var DatabaseWriter = class {
 		}
 		const operations = this.buildUpdateOperations();
 		if (Object.keys(operations).length === 0) return { modifiedCount: 0 };
-		return await this.driver.update(this.table, this.buildPrimaryKeyFilter(), operations);
+		try {
+			return await this.driver.update(this.table, this.buildPrimaryKeyFilter(), operations);
+		} catch (error) {
+			throw this.mapUniqueViolation(error, false);
+		}
+	}
+	/**
+	* Map a driver unique-constraint violation (Postgres 23505, MongoDB 11000)
+	* to a field validation error, so a lost `unique` race never surfaces as a
+	* 500. Any other error is returned untouched.
+	*/
+	mapUniqueViolation(error, isInsert) {
+		const err = error;
+		if (err?.code !== "23505" && err?.code !== 11e3 && err?.code !== "11000") return error;
+		let field;
+		if (err.keyPattern) field = Object.keys(err.keyPattern)[0];
+		else field = /Key \(([^)]+)\)=/.exec(err.detail ?? "")?.[1]?.split(",")[0]?.trim();
+		if (!field) field = /index: (\S+?)_-?1\b/.exec(err.message ?? "")?.[1];
+		return new DatabaseWriterValidationError(`[${this.model.constructor.name} Model] ${isInsert ? "Insert" : "Update"} Validation failed`, [{
+			type: "unique",
+			error: `The ${field ?? "value"} must be unique`,
+			input: field ?? "id"
+		}]);
 	}
 	/**
 	* Build the filter that pins a write to the row this model was loaded from.
@@ -263,7 +326,7 @@ var DatabaseWriter = class {
 			"id",
 			"_id"
 		]);
-		const dirtyColumns = this.model.getDirtyColumns().filter((column) => !identityColumns.has(column));
+		const dirtyColumns = this.model.getDirtyColumns().filter((column) => !identityColumns.has(column) && !this.unvalidatedColumns.has(column));
 		if (dirtyColumns.length > 0) {
 			operations.$set = {};
 			for (const column of dirtyColumns) {
@@ -306,8 +369,8 @@ var DatabaseWriter = class {
 	* @private
 	*/
 	resolveIncrementBy() {
-		if (this.ctor.incrementIdBy) return this.ctor.incrementIdBy;
 		if (this.ctor.randomIncrement) return typeof this.ctor.randomIncrement === "function" ? this.ctor.randomIncrement() : this.randomInt(1, 10);
+		if (this.ctor.incrementIdBy) return this.ctor.incrementIdBy;
 		return 1;
 	}
 	/**
@@ -331,7 +394,11 @@ var DatabaseWriter = class {
 	* @private
 	*/
 	async triggerSync(changedFields) {
-		await events.triggerAll(getModelUpdatedEvent(this.ctor), this.model, changedFields);
+		try {
+			await triggerModelEvent(this.ctor, "updated", this.model, changedFields);
+		} catch (error) {
+			log.error("database", "sync.failed", `[cascade] sync failed for ${this.ctor.name}: ${error}`);
+		}
 	}
 };
 

package/esm/writer/database-writer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer.mjs","names":[],"sources":["../../../../../../../cascade/src/writer/database-writer.ts"],"sourcesContent":["import events from \"@mongez/events\";\r\nimport { when } from \"@mongez/reinforcements\";\r\nimport { getSealConfig, v, type ObjectValidator } from \"@warlock.js/seal\";\r\nimport type {\r\n  DriverContract,\r\n  InsertResult,\r\n  UpdateOperations,\r\n  UpdateResult,\r\n} from \"../contracts/database-driver.contract\";\r\nimport type {\r\n  WriterContract,\r\n  WriterOptions,\r\n  WriterResult,\r\n} from \"../contracts/database-writer.contract\";\r\nimport { mergeDriverFields } from \"../model/methods/accessor-methods\";\r\nimport type { ChildModel, Model } from \"../model/model\";\r\nimport { getModelUpdatedEvent } from \"../sync/model-events\";\r\nimport type { StrictMode } from \"../types\";\r\nimport { DatabaseWriterValidationError } from \"../validation\";\r\nimport type { DataSource } from \"./../data-source/data-source\";\r\n\r\n/**\r\n * Database writer service that orchestrates model persistence.\r\n *\r\n * Handles the complete save pipeline:\r\n * 1. Check for changes (skip if no changes and not new)\r\n * 2. Emit `saving` event (for data enrichment)\r\n * 3. Emit `validating` event\r\n * 4. Validate and cast data via @warlock.js/seal schema\r\n * 5. Emit `validated` event\r\n * 6. Generate ID (for new NoSQL records)\r\n * 7. Emit `creating`/`updating` events\r\n * 8. Execute insert or update via driver\r\n * 9. Merge returned data into model\r\n * 10. Reset dirty tracker and update `isNew` flag\r\n * 11. Emit `saved` and `created`/`updated` events\r\n *\r\n * @example\r\n * ```typescript\r\n * const user = new User({ name: \"Alice\", email: \"alice@example.com\" });\r\n * const writer = new DatabaseWriter(user);\r\n * await writer.save();\r\n *\r\n * console.log(user.get(\"id\")); // 1 (auto-generated)\r\n * console.log(user.get(\"_id\")); // ObjectId(\"...\")\r\n *\r\n * // Update existing record\r\n * user.set(\"name\", \"Alice Smith\");\r\n * await writer.save();\r\n * // Only updates the \"name\" field (partial update)\r\n *\r\n * // Silent save (no events)\r\n * await writer.save({ skipEvents: true });\r\n * ```\r\n */\r\nexport class DatabaseWriter implements WriterContract {\r\n  /** The model instance being persisted */\r\n  private readonly model: Model;\r\n\r\n  /** Model constructor reference */\r\n  private readonly ctor: ChildModel<Model>;\r\n\r\n  /** Data source containing driver and ID generator */\r\n  private readonly dataSource: DataSource;\r\n\r\n  /** Database driver for executing queries */\r\n  private readonly driver: DriverContract;\r\n\r\n  /** Table/collection name */\r\n  private readonly table: string;\r\n\r\n  /** Primary key field name */\r\n  private readonly primaryKey: string;\r\n\r\n  /** Validation schema (if defined) */\r\n  private readonly schema?: ObjectValidator;\r\n\r\n  /** Strict mode configuration */\r\n  private readonly strictMode: StrictMode;\r\n\r\n  /**\r\n   * Create a new writer instance for a model.\r\n   *\r\n   * @param model - The model instance to persist\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const user = new User({ name: \"Alice\" });\r\n   * const writer = new DatabaseWriter(user);\r\n   * await writer.save();\r\n   * ```\r\n   */\r\n  public constructor(model: Model) {\r\n    this.model = model;\r\n    this.ctor = model.constructor as ChildModel<Model>;\r\n    this.dataSource = this.ctor.getDataSource();\r\n    this.driver = this.dataSource.driver;\r\n    this.table = this.ctor.table;\r\n    this.primaryKey = this.ctor.primaryKey;\r\n    this.schema = this.ctor.schema;\r\n    this.strictMode = this.ctor.strictMode;\r\n  }\r\n\r\n  /**\r\n   * Save the model instance to the database.\r\n   *\r\n   * @param options - Save options\r\n   * @returns Result with success status, document, and metadata\r\n   * @throws {ValidationError} If validation fails\r\n   */\r\n  public async save(options: WriterOptions = {}): Promise<WriterResult> {\r\n    const isInsert = this.model.isNew;\r\n\r\n    // 1. Check if model has changes (skip if no changes and not new)\r\n    if (!isInsert && !this.model.hasChanges()) {\r\n      return {\r\n        success: true,\r\n        document: this.model.data,\r\n        isNew: false,\r\n        modifiedCount: 0,\r\n      };\r\n    }\r\n\r\n    // 2. Emit saving event (before validation for data enrichment)\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"saving\", {\r\n        isInsert,\r\n        options,\r\n        mode: isInsert ? \"insert\" : \"update\",\r\n      });\r\n    }\r\n\r\n    // 3. Validate and cast data\r\n    await this.validateAndCast(isInsert, options);\r\n\r\n    // 4. Execute insert or update\r\n    let result: InsertResult | UpdateResult;\r\n\r\n    if (isInsert) {\r\n      result = await this.performInsert(options);\r\n    } else {\r\n      result = await this.performUpdate(options);\r\n    }\r\n\r\n    // 5. Reset dirty tracker and update isNew flag\r\n    const changedFields = isInsert ? [] : this.model.getDirtyColumns();\r\n    this.model.dirtyTracker.reset();\r\n    this.model.isNew = false;\r\n\r\n    // 6. Emit post-save events\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"saved\");\r\n      await this.model.emitEvent(isInsert ? \"created\" : \"updated\");\r\n    }\r\n\r\n    // 7. Trigger sync operations (fire-and-forget, non-blocking)\r\n    if (!options.skipSync && !isInsert) {\r\n      void this.triggerSync(changedFields);\r\n    }\r\n\r\n    return {\r\n      success: true,\r\n      document: this.model.data,\r\n      isNew: isInsert,\r\n      modifiedCount: isInsert\r\n        ? undefined\r\n        : (result as UpdateResult).modifiedCount,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Validate and cast model data using the schema.\r\n   *\r\n   * Updates the model's data in-place with validated/casted values.\r\n   *\r\n   * @param isInsert - Whether this is an insert operation\r\n   * @param options - Save options\r\n   * @throws {ValidationError} If validation fails\r\n   * @private\r\n   */\r\n  private async validateAndCast(\r\n    isInsert: boolean,\r\n    options: WriterOptions,\r\n  ): Promise<void> {\r\n    // Emit validating event\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"validating\", {\r\n        isInsert,\r\n        options,\r\n        mode: isInsert ? \"insert\" : \"update\",\r\n      });\r\n    }\r\n\r\n    // Skip validation if requested or no schema defined\r\n    if (options.skipValidation || !this.schema) {\r\n      return;\r\n    }\r\n\r\n    // Whitelist the framework-managed system columns so a model carrying them\r\n    // (id / _id / timestamps / soft-delete deletedAt) validates cleanly instead\r\n    // of being stripped (strictMode \"strip\") or rejected (strictMode \"fail\").\r\n    // `when(...)` adds each timestamp/soft-delete column only when configured\r\n    // (truthy) — the lazy factory means a disabled column (`false`) never even\r\n    // builds a bogus schema key.\r\n    //\r\n    // The whitelist must apply to BOTH insert and update: on insert a caller may\r\n    // supply a backdated createdAt (e.g. data migrations / imports), and without\r\n    // the whitelist strictMode \"strip\" silently drops it before it reaches the\r\n    // writer, while \"fail\" rejects the whole insert.\r\n    const systemColumns = {\r\n      id: v.scalar().optional(),\r\n      _id: v.any().optional(),\r\n      ...when(this.ctor.createdAtColumn, () => ({\r\n        [this.ctor.createdAtColumn as string]: v.date().optional(),\r\n      })),\r\n      ...when(this.ctor.updatedAtColumn, () => ({\r\n        [this.ctor.updatedAtColumn as string]: v.date().optional(),\r\n      })),\r\n      ...when(this.ctor.deletedAtColumn, () => ({\r\n        [this.ctor.deletedAtColumn as string]: v.date().optional(),\r\n      })),\r\n    };\r\n\r\n    // Clone full schema for insert, partial (dirty keys only) for updates.\r\n    const validationSchema = isInsert\r\n      ? this.schema.clone().extend(systemColumns)\r\n      : this.schema.clone(Object.keys(this.model.data)).extend(systemColumns);\r\n\r\n    // Apply strict mode\r\n    if (this.strictMode === \"strip\") {\r\n      validationSchema.stripUnknown();\r\n    } else if (this.strictMode === \"fail\") {\r\n      validationSchema.allowUnknown(false);\r\n    } else if (this.strictMode === \"allow\") {\r\n      validationSchema.allowUnknown(true);\r\n    }\r\n\r\n    // Run validation\r\n    const result = await v.validate(validationSchema, this.model.data, {\r\n      context: {\r\n        model: this.model,\r\n      },\r\n      ...getSealConfig(),\r\n    });\r\n\r\n    if (!result.isValid) {\r\n      console.trace(result.errors);\r\n\r\n      const error = new DatabaseWriterValidationError(\r\n        `[${this.model.constructor.name} Model] ${isInsert ? \"Insert\" : \"Update\"} Validation failed`,\r\n        result.errors,\r\n      );\r\n      if (!options.skipEvents) {\r\n        await this.model.emitEvent(\"validated\", { result, error });\r\n      }\r\n      throw error;\r\n    }\r\n\r\n    // Update model data with validated/casted data\r\n    this.model.replaceData(result.data);\r\n\r\n    // Emit validated event\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"validated\", { result });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an insert operation.\r\n   *\r\n   * @param options - Save options\r\n   * @returns Insert result\r\n   * @private\r\n   */\r\n  private async performInsert(options: WriterOptions): Promise<InsertResult> {\r\n    // Generate ID if needed (NoSQL only)\r\n    await this.generateNextId();\r\n\r\n    // Get data to insert (already validated and casted)\r\n    const dataToInsert = this.model.data;\r\n\r\n    // Add createdAt and updatedAt to the data (using resolved column names)\r\n    // The column names are already resolved through the hierarchy:\r\n    // Model static property > Database config > Driver defaults > undefined\r\n    //\r\n    // Only stamp createdAt when the caller did NOT supply one, so a backdated\r\n    // value (e.g. data migrations / imports) is honored instead of overwritten.\r\n    // This mirrors the upsert path's guard. updatedAt is always stamped to\r\n    // reflect the moment the record is persisted.\r\n    const createdAtColumn = this.ctor.createdAtColumn;\r\n\r\n    if (createdAtColumn && dataToInsert[createdAtColumn] == null) {\r\n      dataToInsert[createdAtColumn] = new Date();\r\n    }\r\n\r\n    const updatedAtColumn = this.ctor.updatedAtColumn;\r\n    if (updatedAtColumn) {\r\n      dataToInsert[updatedAtColumn] = new Date();\r\n    }\r\n\r\n    // Emit creating event\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"creating\");\r\n    }\r\n\r\n    // INSERT: use full validated data\r\n    const result = await this.driver.insert(this.table, dataToInsert);\r\n\r\n    // Merge returned data (e.g., generated _id, timestamps)\r\n    // Note: We use merge here because the result might not include all fields\r\n    // (e.g., our generated 'id' field), and we don't want to lose them\r\n    mergeDriverFields(this.model, result.document as Record<string, unknown>);\r\n\r\n    // Reset dirty tracker immediately after merge to prevent\r\n    // database-generated fields (like _id) from being marked as dirty\r\n    this.model.dirtyTracker.reset();\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Perform an update operation.\r\n   *\r\n   * @param options - Save options\r\n   * @returns Update result\r\n   * @private\r\n   */\r\n  private async performUpdate(options: WriterOptions): Promise<UpdateResult> {\r\n    // Emit updating event\r\n    if (!options.skipEvents) {\r\n      await this.model.emitEvent(\"updating\");\r\n    }\r\n\r\n    // Update the updatedAt timestamp (using resolved column name)\r\n    const updatedAtColumn = this.ctor.updatedAtColumn;\r\n    if (updatedAtColumn) {\r\n      this.model.set(updatedAtColumn, new Date());\r\n    }\r\n\r\n    if (options.replace) {\r\n      const document = await this.driver.replace(\r\n        this.table,\r\n        this.buildPrimaryKeyFilter(),\r\n        this.model.data,\r\n      );\r\n\r\n      if (document) {\r\n        this.model.replaceData(document as Record<string, unknown>);\r\n      }\r\n\r\n      return { modifiedCount: document ? 1 : 0 };\r\n    }\r\n\r\n    // Build operations from dirty tracker\r\n    const operations = this.buildUpdateOperations();\r\n\r\n    // Nothing left to write once identity columns are excluded — don't hand the\r\n    // driver an empty update document (MongoDB rejects one).\r\n    if (Object.keys(operations).length === 0) {\r\n      return { modifiedCount: 0 };\r\n    }\r\n\r\n    // Execute update with operations\r\n    return await this.driver.update(\r\n      this.table,\r\n      this.buildPrimaryKeyFilter(),\r\n      operations,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Build the filter that pins a write to the row this model was loaded from.\r\n   *\r\n   * It reads `model.trustedPrimaryKey` — the value captured when the instance\r\n   * became persisted — NOT the current value in `model.data`. The current value\r\n   * is reachable by mass assignment (`model.merge(req.body)`), so deriving the\r\n   * filter from it let a request body redirect the UPDATE to another document.\r\n   *\r\n   * @returns Filter matching the originally loaded record\r\n   * @private\r\n   */\r\n  private buildPrimaryKeyFilter(): Record<string, unknown> {\r\n    return { [this.primaryKey]: this.model.trustedPrimaryKey };\r\n  }\r\n\r\n  /**\r\n   * Generate ID for the model if auto-generation is enabled.\r\n   *\r\n   * @private\r\n   */\r\n  public async generateNextId(): Promise<void> {\r\n    if (!this.ctor.autoGenerateId || this.model.get(\"id\")) {\r\n      return;\r\n    }\r\n\r\n    const idGenerator = this.dataSource.idGenerator;\r\n    if (!idGenerator) {\r\n      return;\r\n    }\r\n\r\n    // Resolve ID generation options from model configuration\r\n    const initialId = this.resolveInitialId();\r\n\r\n    const incrementIdBy = this.resolveIncrementBy();\r\n\r\n    const id = await idGenerator.generateNextId({\r\n      table: this.table,\r\n      initialId,\r\n      incrementIdBy,\r\n    });\r\n\r\n    this.model.set(\"id\", id);\r\n  }\r\n\r\n  /**\r\n   * Build update operations from the model's dirty tracker.\r\n   *\r\n   * Handles both modified fields ($set) and removed fields ($unset).\r\n   *\r\n   * @returns Update operations for the driver\r\n   * @private\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * // Model with changes\r\n   * user.set(\"name\", \"Alice\");\r\n   * user.unset(\"tempField\");\r\n   *\r\n   * const operations = this.buildUpdateOperations();\r\n   * // {\r\n   * //   $set: { name: \"Alice\" },\r\n   * //   $unset: { tempField: 1 }\r\n   * // }\r\n   * ```\r\n   */\r\n  private buildUpdateOperations(): UpdateOperations {\r\n    const operations: UpdateOperations = {};\r\n\r\n    // Identity columns are never written by an update. The filter pins the row\r\n    // by its captured primary key, so a dirty `id`/`_id` can only come from\r\n    // mass assignment or an explicit set() — either way, rewriting the key of\r\n    // an existing row corrupts identity (and `_id` is immutable in MongoDB).\r\n    // Changing a primary key is a deliberate operation: use the atomic/raw APIs.\r\n    const identityColumns = new Set([this.primaryKey, \"id\", \"_id\"]);\r\n\r\n    // Get dirty columns (modified fields)\r\n    const dirtyColumns = this.model\r\n      .getDirtyColumns()\r\n      .filter(column => !identityColumns.has(column));\r\n\r\n    if (dirtyColumns.length > 0) {\r\n      operations.$set = {};\r\n      for (const column of dirtyColumns) {\r\n        const value = this.model.get(column);\r\n        if (value === undefined) continue;\r\n\r\n        operations.$set[column] = this.model.get(column);\r\n      }\r\n    }\r\n\r\n    // Get removed columns\r\n    const removedColumns = this.model\r\n      .getRemovedColumns()\r\n      .filter(column => !identityColumns.has(column));\r\n\r\n    if (removedColumns.length > 0) {\r\n      operations.$unset = {};\r\n      for (const column of removedColumns) {\r\n        operations.$unset[column] = 1;\r\n      }\r\n    }\r\n\r\n    return operations;\r\n  }\r\n\r\n  /**\r\n   * Resolve the initial ID from model configuration.\r\n   *\r\n   * Priority:\r\n   * 1. Model.initialId (explicit value)\r\n   * 2. Model.randomInitialId (random or function)\r\n   * 3. Default: 1\r\n   *\r\n   * @returns The initial ID value\r\n   * @private\r\n   */\r\n  private resolveInitialId(): number {\r\n    if (this.ctor.initialId) {\r\n      return this.ctor.initialId;\r\n    }\r\n\r\n    if (this.ctor.randomInitialId) {\r\n      return typeof this.ctor.randomInitialId === \"function\"\r\n        ? this.ctor.randomInitialId()\r\n        : this.randomInt(10000, 499999);\r\n    }\r\n\r\n    return 1; // Default initial ID\r\n  }\r\n\r\n  /**\r\n   * Resolve the increment value from model configuration.\r\n   *\r\n   * Priority:\r\n   * 1. Model.incrementIdBy (explicit value)\r\n   * 2. Model.randomIncrement (random or function)\r\n   * 3. Default: 1\r\n   *\r\n   * @returns The increment value\r\n   * @private\r\n   */\r\n  private resolveIncrementBy(): number {\r\n    if (this.ctor.incrementIdBy) {\r\n      return this.ctor.incrementIdBy;\r\n    }\r\n\r\n    if (this.ctor.randomIncrement) {\r\n      return typeof this.ctor.randomIncrement === \"function\"\r\n        ? this.ctor.randomIncrement()\r\n        : this.randomInt(1, 10);\r\n    }\r\n\r\n    return 1; // Default increment\r\n  }\r\n\r\n  /**\r\n   * Generate a random integer between min and max (inclusive).\r\n   *\r\n   * @param min - Minimum value\r\n   * @param max - Maximum value\r\n   * @returns Random integer\r\n   * @private\r\n   */\r\n  private randomInt(min: number, max: number): number {\r\n    return Math.floor(Math.random() * (max - min + 1)) + min;\r\n  }\r\n\r\n  /**\r\n   * Trigger sync operations after successful save.\r\n   *\r\n   * Emits a model.updated event that ModelSyncOperation listens to.\r\n   * The sync is handled by registered sync operations, not directly here.\r\n   *\r\n   * @param changedFields - Fields that were changed (for filtering)\r\n   * @private\r\n   */\r\n  private async triggerSync(changedFields: string[]): Promise<void> {\r\n    // Emit model.updated event - ModelSyncOperation listens to these\r\n    await events.triggerAll(\r\n      getModelUpdatedEvent(this.ctor),\r\n      this.model,\r\n      changedFields,\r\n    );\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"database-writer.mjs","names":[],"sources":["../../../../../../../cascade/src/writer/database-writer.ts"],"sourcesContent":["import { when } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { getSealConfig, v, type ObjectValidator } from \"@warlock.js/seal\";\nimport type {\n  DriverContract,\n  InsertResult,\n  UpdateOperations,\n  UpdateResult,\n} from \"../contracts/database-driver.contract\";\nimport type {\n  WriterContract,\n  WriterOptions,\n  WriterResult,\n} from \"../contracts/database-writer.contract\";\nimport { mergeDriverFields } from \"../model/methods/accessor-methods\";\nimport type { ChildModel, Model } from \"../model/model\";\nimport { triggerModelEvent } from \"../sync/model-events\";\nimport type { StrictMode } from \"../types\";\nimport { DatabaseWriterValidationError } from \"../validation\";\nimport { afterCommit } from \"../transactions/after-commit\";\nimport type { DataSource } from \"./../data-source/data-source\";\n\n/**\n * Database writer service that orchestrates model persistence.\n *\n * Handles the complete save pipeline:\n * 1. Check for changes (skip if no changes and not new)\n * 2. Emit `saving` event (for data enrichment)\n * 3. Emit `validating` event\n * 4. Validate and cast data via @warlock.js/seal schema\n * 5. Emit `validated` event\n * 6. Generate ID (for new NoSQL records)\n * 7. Emit `creating`/`updating` events\n * 8. Execute insert or update via driver\n * 9. Merge returned data into model\n * 10. Reset dirty tracker and update `isNew` flag\n * 11. Emit `saved` and `created`/`updated` events\n *\n * @example\n * ```typescript\n * const user = new User({ name: \"Alice\", email: \"alice@example.com\" });\n * const writer = new DatabaseWriter(user);\n * await writer.save();\n *\n * console.log(user.get(\"id\")); // 1 (auto-generated)\n * console.log(user.get(\"_id\")); // ObjectId(\"...\")\n *\n * // Update existing record\n * user.set(\"name\", \"Alice Smith\");\n * await writer.save();\n * // Only updates the \"name\" field (partial update)\n *\n * // Silent save (no events)\n * await writer.save({ skipEvents: true });\n * ```\n */\nexport class DatabaseWriter implements WriterContract {\n  /** The model instance being persisted */\n  private readonly model: Model;\n\n  /** Dirty columns an update validation dropped (strip mode); never written. */\n  private readonly unvalidatedColumns = new Set<string>();\n\n  /** Model constructor reference */\n  private readonly ctor: ChildModel<Model>;\n\n  /** Data source containing driver and ID generator */\n  private readonly dataSource: DataSource;\n\n  /** Database driver for executing queries */\n  private readonly driver: DriverContract;\n\n  /** Table/collection name */\n  private readonly table: string;\n\n  /** Primary key field name */\n  private readonly primaryKey: string;\n\n  /** Validation schema (if defined) */\n  private readonly schema?: ObjectValidator;\n\n  /** Strict mode configuration */\n  private readonly strictMode: StrictMode;\n\n  /**\n   * Create a new writer instance for a model.\n   *\n   * @param model - The model instance to persist\n   *\n   * @example\n   * ```typescript\n   * const user = new User({ name: \"Alice\" });\n   * const writer = new DatabaseWriter(user);\n   * await writer.save();\n   * ```\n   */\n  public constructor(model: Model) {\n    this.model = model;\n    this.ctor = model.constructor as ChildModel<Model>;\n    this.dataSource = this.ctor.getDataSource();\n    this.driver = this.dataSource.driver;\n    this.table = this.ctor.table;\n    this.primaryKey = this.ctor.primaryKey;\n    this.schema = this.ctor.schema;\n    this.strictMode = this.ctor.strictMode;\n  }\n\n  /**\n   * Save the model instance to the database.\n   *\n   * @param options - Save options\n   * @returns Result with success status, document, and metadata\n   * @throws {ValidationError} If validation fails\n   */\n  public async save(options: WriterOptions = {}): Promise<WriterResult> {\n    const isInsert = this.model.isNew;\n\n    // 1. Check if model has changes (skip if no changes and not new)\n    if (!isInsert && !this.model.hasChanges()) {\n      return {\n        success: true,\n        document: this.model.data,\n        isNew: false,\n        modifiedCount: 0,\n      };\n    }\n\n    // 2. Emit saving event (before validation for data enrichment)\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"saving\", {\n        isInsert,\n        options,\n        mode: isInsert ? \"insert\" : \"update\",\n      });\n    }\n\n    // 3-4. Execute insert or update (validation happens inside each path)\n    let result: InsertResult | UpdateResult;\n\n    if (isInsert) {\n      result = await this.performInsert(options);\n    } else {\n      await this.validateAndCast(false, options);\n      result = await this.performUpdate(options);\n    }\n\n    // 5. Reset dirty tracker and update isNew flag\n    const changedFields = isInsert ? [] : this.model.getDirtyColumns();\n    this.model.dirtyTracker.reset();\n    this.model.isNew = false;\n\n    // 6. Emit post-save events\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"saved\");\n      await this.model.emitEvent(isInsert ? \"created\" : \"updated\");\n    }\n\n    // 7. Trigger sync operations after COMMIT (inside a transaction they are\n    // queued, so a rolled-back write never fans out). Failures are logged.\n    if (!options.skipSync && !isInsert) {\n      afterCommit(() => this.triggerSync(changedFields));\n    }\n\n    return {\n      success: true,\n      document: this.model.data,\n      isNew: isInsert,\n      modifiedCount: isInsert\n        ? undefined\n        : (result as UpdateResult).modifiedCount,\n    };\n  }\n\n  /**\n   * Validate and cast model data using the schema.\n   *\n   * Updates the model's data in-place with validated/casted values.\n   *\n   * @param isInsert - Whether this is an insert operation\n   * @param options - Save options\n   * @throws {ValidationError} If validation fails\n   * @private\n   */\n  private async validateAndCast(\n    isInsert: boolean,\n    options: WriterOptions,\n  ): Promise<void> {\n    // Emit validating event\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"validating\", {\n        isInsert,\n        options,\n        mode: isInsert ? \"insert\" : \"update\",\n      });\n    }\n\n    // Skip validation if requested or no schema defined\n    if (options.skipValidation || !this.schema) {\n      return;\n    }\n\n    // Whitelist the framework-managed system columns so a model carrying them\n    // (id / _id / timestamps / soft-delete deletedAt) validates cleanly instead\n    // of being stripped (strictMode \"strip\") or rejected (strictMode \"fail\").\n    // `when(...)` adds each timestamp/soft-delete column only when configured\n    // (truthy) — the lazy factory means a disabled column (`false`) never even\n    // builds a bogus schema key.\n    //\n    // The whitelist must apply to BOTH insert and update: on insert a caller may\n    // supply a backdated createdAt (e.g. data migrations / imports), and without\n    // the whitelist strictMode \"strip\" silently drops it before it reaches the\n    // writer, while \"fail\" rejects the whole insert.\n    const systemColumns = {\n      id: v.scalar().optional(),\n      _id: v.any().optional(),\n      ...when(this.ctor.createdAtColumn, () => ({\n        [this.ctor.createdAtColumn as string]: v.date().optional(),\n      })),\n      ...when(this.ctor.updatedAtColumn, () => ({\n        [this.ctor.updatedAtColumn as string]: v.date().optional(),\n      })),\n      ...when(this.ctor.deletedAtColumn, () => ({\n        [this.ctor.deletedAtColumn as string]: v.date().optional(),\n      })),\n    };\n\n    // Clone full schema for insert, partial (dirty keys only) for updates.\n    //\n    // An update validates ONLY the dirty columns and merges back only those\n    // keys: columns the schema does not list (migration-added, withCount, ...)\n    // are never touched, so they can no longer be turned into `$unset`.\n    const dataToValidate: Record<string, unknown> = isInsert\n      ? this.model.data\n      : Object.fromEntries(\n          this.model\n            .getDirtyColumns()\n            .filter(column => column in this.model.data)\n            .map(column => [column, this.model.data[column]]),\n        );\n\n    const validationSchema = isInsert\n      ? this.schema.clone().extend(systemColumns)\n      : this.schema.clone(Object.keys(dataToValidate)).extend(systemColumns);\n\n    // Apply strict mode\n    if (this.strictMode === \"strip\") {\n      validationSchema.stripUnknown();\n    } else if (this.strictMode === \"fail\") {\n      validationSchema.allowUnknown(false);\n    } else if (this.strictMode === \"allow\") {\n      validationSchema.allowUnknown(true);\n    }\n\n    // Run validation\n    const result = await v.validate(validationSchema, dataToValidate, {\n      context: {\n        model: this.model,\n      },\n      ...getSealConfig(),\n    });\n\n    if (!result.isValid) {\n      const error = new DatabaseWriterValidationError(\n        `[${this.model.constructor.name} Model] ${isInsert ? \"Insert\" : \"Update\"} Validation failed`,\n        result.errors,\n      );\n      if (!options.skipEvents) {\n        await this.model.emitEvent(\"validated\", { result, error });\n      }\n      throw error;\n    }\n\n    // Update model data with validated/casted data\n    if (isInsert) {\n      this.model.replaceData(result.data);\n    } else {\n      const validated = result.data as Record<string, unknown>;\n\n      for (const column of Object.keys(dataToValidate)) {\n        if (column in validated) {\n          this.model.set(column, validated[column]);\n        } else {\n          // Dropped by strictMode \"strip\": never write an unvalidated column.\n          this.unvalidatedColumns.add(column);\n        }\n      }\n    }\n\n    // Emit validated event\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"validated\", { result });\n    }\n  }\n\n  /**\n   * Validate, cast and id-generate a not-yet-persisted model for `upsert()`.\n   *\n   * Runs the insert-mode pipeline (schema, casts, strictMode, Mongo `id`) but\n   * does not write; the caller sends the resulting data through the driver.\n   */\n  public async prepareForUpsert(): Promise<void> {\n    await this.validateAndCast(true, {});\n    await this.generateNextId();\n  }\n\n  /**\n   * Perform an insert operation.\n   *\n   * @param options - Save options\n   * @returns Insert result\n   * @private\n   */\n  private async performInsert(options: WriterOptions): Promise<InsertResult> {\n    const dataToInsert = await this.prepareForInsert(options);\n\n    // INSERT: use full validated data\n    let result: InsertResult;\n\n    try {\n      result = await this.driver.insert(this.table, dataToInsert);\n    } catch (error) {\n      throw this.mapUniqueViolation(error, true);\n    }\n\n    // Merge returned data (e.g., generated _id, timestamps)\n    // Note: We use merge here because the result might not include all fields\n    // (e.g., our generated 'id' field), and we don't want to lose them\n    mergeDriverFields(this.model, result.document as Record<string, unknown>);\n\n    // Reset dirty tracker immediately after merge to prevent\n    // database-generated fields (like _id) from being marked as dirty\n    this.model.dirtyTracker.reset();\n\n    return result;\n  }\n\n  /**\n   * Run the insert pipeline (validation, casting, id generation, timestamps,\n   * `validating`/`validated`/`creating` hooks) WITHOUT writing.\n   *\n   * `save()` uses this for its insert path, so bulk inserts and single inserts\n   * cannot drift. The caller is responsible for sending the returned document\n   * to the driver.\n   *\n   * @param options - Save options (e.g. `skipEvents`, `skipValidation`)\n   * @returns The prepared document to insert\n   */\n  public async prepareForInsert(options: WriterOptions = {}): Promise<Record<string, unknown>> {\n    // Validate and cast data\n    await this.validateAndCast(true, options);\n\n    // Generate ID if needed (NoSQL only)\n    await this.generateNextId();\n\n    // Get data to insert (already validated and casted)\n    const dataToInsert = this.model.data;\n\n    // Add createdAt and updatedAt to the data (using resolved column names)\n    // The column names are already resolved through the hierarchy:\n    // Model static property > Database config > Driver defaults > undefined\n    //\n    // Only stamp createdAt when the caller did NOT supply one, so a backdated\n    // value (e.g. data migrations / imports) is honored instead of overwritten.\n    // This mirrors the upsert path's guard. updatedAt is always stamped to\n    // reflect the moment the record is persisted.\n    const createdAtColumn = this.ctor.createdAtColumn;\n\n    if (createdAtColumn && dataToInsert[createdAtColumn] == null) {\n      dataToInsert[createdAtColumn] = new Date();\n    }\n\n    const updatedAtColumn = this.ctor.updatedAtColumn;\n    if (updatedAtColumn) {\n      dataToInsert[updatedAtColumn] = new Date();\n    }\n\n    // Emit creating event\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"creating\");\n    }\n\n    return dataToInsert;\n  }\n\n  /**\n   * Perform an update operation.\n   *\n   * @param options - Save options\n   * @returns Update result\n   * @private\n   */\n  private async performUpdate(options: WriterOptions): Promise<UpdateResult> {\n    // Emit updating event\n    if (!options.skipEvents) {\n      await this.model.emitEvent(\"updating\");\n    }\n\n    // Update the updatedAt timestamp (using resolved column name)\n    const updatedAtColumn = this.ctor.updatedAtColumn;\n    if (updatedAtColumn) {\n      this.model.set(updatedAtColumn, new Date());\n    }\n\n    if (options.replace) {\n      const document = await this.driver.replace(\n        this.table,\n        this.buildPrimaryKeyFilter(),\n        this.model.data,\n      );\n\n      if (document) {\n        this.model.replaceData(document as Record<string, unknown>);\n      }\n\n      return { modifiedCount: document ? 1 : 0 };\n    }\n\n    // Build operations from dirty tracker\n    const operations = this.buildUpdateOperations();\n\n    // Nothing left to write once identity columns are excluded — don't hand the\n    // driver an empty update document (MongoDB rejects one).\n    if (Object.keys(operations).length === 0) {\n      return { modifiedCount: 0 };\n    }\n\n    // Execute update with operations\n    try {\n      return await this.driver.update(\n        this.table,\n        this.buildPrimaryKeyFilter(),\n        operations,\n      );\n    } catch (error) {\n      throw this.mapUniqueViolation(error, false);\n    }\n  }\n\n  /**\n   * Map a driver unique-constraint violation (Postgres 23505, MongoDB 11000)\n   * to a field validation error, so a lost `unique` race never surfaces as a\n   * 500. Any other error is returned untouched.\n   */\n  private mapUniqueViolation(error: unknown, isInsert: boolean): unknown {\n    const err = error as\n      | {\n          code?: string | number;\n          detail?: string;\n          keyPattern?: Record<string, unknown>;\n          message?: string;\n        }\n      | undefined;\n\n    if (err?.code !== \"23505\" && err?.code !== 11000 && err?.code !== \"11000\") {\n      return error;\n    }\n\n    let field: string | undefined;\n\n    if (err.keyPattern) {\n      field = Object.keys(err.keyPattern)[0];\n    } else {\n      // Postgres: \"Key (email)=(x) already exists.\"\n      field = /Key \\(([^)]+)\\)=/.exec(err.detail ?? \"\")?.[1]?.split(\",\")[0]?.trim();\n    }\n\n    if (!field) {\n      // Mongo: \"index: email_1 dup key\"\n      field = /index: (\\S+?)_-?1\\b/.exec(err.message ?? \"\")?.[1];\n    }\n\n    return new DatabaseWriterValidationError(\n      `[${this.model.constructor.name} Model] ${isInsert ? \"Insert\" : \"Update\"} Validation failed`,\n      [\n        {\n          type: \"unique\",\n          error: `The ${field ?? \"value\"} must be unique`,\n          input: field ?? \"id\",\n        },\n      ],\n    );\n  }\n\n  /**\n   * Build the filter that pins a write to the row this model was loaded from.\n   *\n   * It reads `model.trustedPrimaryKey` — the value captured when the instance\n   * became persisted — NOT the current value in `model.data`. The current value\n   * is reachable by mass assignment (`model.merge(req.body)`), so deriving the\n   * filter from it let a request body redirect the UPDATE to another document.\n   *\n   * @returns Filter matching the originally loaded record\n   * @private\n   */\n  private buildPrimaryKeyFilter(): Record<string, unknown> {\n    return { [this.primaryKey]: this.model.trustedPrimaryKey };\n  }\n\n  /**\n   * Generate ID for the model if auto-generation is enabled.\n   *\n   * @private\n   */\n  public async generateNextId(): Promise<void> {\n    if (!this.ctor.autoGenerateId || this.model.get(\"id\")) {\n      return;\n    }\n\n    const idGenerator = this.dataSource.idGenerator;\n    if (!idGenerator) {\n      return;\n    }\n\n    // Resolve ID generation options from model configuration\n    const initialId = this.resolveInitialId();\n\n    const incrementIdBy = this.resolveIncrementBy();\n\n    const id = await idGenerator.generateNextId({\n      table: this.table,\n      initialId,\n      incrementIdBy,\n    });\n\n    this.model.set(\"id\", id);\n  }\n\n  /**\n   * Build update operations from the model's dirty tracker.\n   *\n   * Handles both modified fields ($set) and removed fields ($unset).\n   *\n   * @returns Update operations for the driver\n   * @private\n   *\n   * @example\n   * ```typescript\n   * // Model with changes\n   * user.set(\"name\", \"Alice\");\n   * user.unset(\"tempField\");\n   *\n   * const operations = this.buildUpdateOperations();\n   * // {\n   * //   $set: { name: \"Alice\" },\n   * //   $unset: { tempField: 1 }\n   * // }\n   * ```\n   */\n  private buildUpdateOperations(): UpdateOperations {\n    const operations: UpdateOperations = {};\n\n    // Identity columns are never written by an update. The filter pins the row\n    // by its captured primary key, so a dirty `id`/`_id` can only come from\n    // mass assignment or an explicit set() — either way, rewriting the key of\n    // an existing row corrupts identity (and `_id` is immutable in MongoDB).\n    // Changing a primary key is a deliberate operation: use the atomic/raw APIs.\n    const identityColumns = new Set([this.primaryKey, \"id\", \"_id\"]);\n\n    // Get dirty columns (modified fields)\n    const dirtyColumns = this.model\n      .getDirtyColumns()\n      .filter(column => !identityColumns.has(column) && !this.unvalidatedColumns.has(column));\n\n    if (dirtyColumns.length > 0) {\n      operations.$set = {};\n      for (const column of dirtyColumns) {\n        const value = this.model.get(column);\n        if (value === undefined) continue;\n\n        operations.$set[column] = this.model.get(column);\n      }\n    }\n\n    // Get removed columns\n    const removedColumns = this.model\n      .getRemovedColumns()\n      .filter(column => !identityColumns.has(column));\n\n    if (removedColumns.length > 0) {\n      operations.$unset = {};\n      for (const column of removedColumns) {\n        operations.$unset[column] = 1;\n      }\n    }\n\n    return operations;\n  }\n\n  /**\n   * Resolve the initial ID from model configuration.\n   *\n   * Priority:\n   * 1. Model.initialId (explicit value)\n   * 2. Model.randomInitialId (random or function)\n   * 3. Default: 1\n   *\n   * @returns The initial ID value\n   * @private\n   */\n  private resolveInitialId(): number {\n    if (this.ctor.initialId) {\n      return this.ctor.initialId;\n    }\n\n    if (this.ctor.randomInitialId) {\n      return typeof this.ctor.randomInitialId === \"function\"\n        ? this.ctor.randomInitialId()\n        : this.randomInt(10000, 499999);\n    }\n\n    return 1; // Default initial ID\n  }\n\n  /**\n   * Resolve the increment value from model configuration.\n   *\n   * Priority:\n   * 1. Model.incrementIdBy (explicit value)\n   * 2. Model.randomIncrement (random or function)\n   * 3. Default: 1\n   *\n   * @returns The increment value\n   * @private\n   */\n  private resolveIncrementBy(): number {\n    if (this.ctor.randomIncrement) {\n      return typeof this.ctor.randomIncrement === \"function\"\n        ? this.ctor.randomIncrement()\n        : this.randomInt(1, 10);\n    }\n\n    if (this.ctor.incrementIdBy) {\n      return this.ctor.incrementIdBy;\n    }\n\n    return 1; // Default increment\n  }\n\n  /**\n   * Generate a random integer between min and max (inclusive).\n   *\n   * @param min - Minimum value\n   * @param max - Maximum value\n   * @returns Random integer\n   * @private\n   */\n  private randomInt(min: number, max: number): number {\n    return Math.floor(Math.random() * (max - min + 1)) + min;\n  }\n\n  /**\n   * Trigger sync operations after successful save.\n   *\n   * Emits a model.updated event that ModelSyncOperation listens to.\n   * The sync is handled by registered sync operations, not directly here.\n   *\n   * @param changedFields - Fields that were changed (for filtering)\n   * @private\n   */\n  private async triggerSync(changedFields: string[]): Promise<void> {\n    try {\n      // Emit model.updated event - ModelSyncOperation listens to these\n      await triggerModelEvent(this.ctor, \"updated\", this.model, changedFields);\n    } catch (error) {\n      log.error(\"database\", \"sync.failed\", `[cascade] sync failed for ${this.ctor.name}: ${error}`);\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -13,9 +13,9 @@
     "@mongez/events": "^2.2.7",
     "@mongez/reinforcements": "^4.0.2",
     "@mongez/supportive-is": "^2.1.5",
-    "@warlock.js/context": "5.20.0",
-    "@warlock.js/logger": "5.20.0",
-    "@warlock.js/seal": "5.20.0",
+    "@warlock.js/context": "5.21.0",
+    "@warlock.js/logger": "5.21.0",
+    "@warlock.js/seal": "5.21.0",
     "citty": "^0.2.2",
     "fast-glob": "^3.3.3"
   },
@@ -51,7 +51,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.20.0",
+  "version": "5.21.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",