@atscript/db 0.1.40 → 0.1.42

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://atscript.dev/logo.svg" alt="Atscript" width="120" />
+  <img src="https://db.atscript.dev/logo.svg" alt="Atscript" width="120" />
 </p>
 
 <h1 align="center">@atscript/db</h1>

package/dist/{db-readable-BQQzfguJ.d.cts → db-readable-C3C-qPcP.d.cts}

@@ -399,7 +399,11 @@ declare class TableMetadata {
   booleanFields: Set<string>;
   decimalFields: Set<string>;
   allPhysicalFields: string[];
+  /** Precomputed parent path → child physical column names for fast null-setting. */
+  childrenByParent: Map<string, string[]>;
   requiresMappings: boolean;
+  /** True when the only mappings needed are simple `@db.column` renames (no nesting/JSON). */
+  onlyColumnRenames: boolean;
   toStorageFormatters?: Map<string, (value: unknown) => unknown>;
   fromStorageFormatters?: Map<string, (value: unknown) => unknown>;
   /** Leaf field descriptors indexed by physical column name (read path). */
@@ -958,13 +962,20 @@ declare abstract class FieldMappingStrategy {
   abstract translateQuery(query: Uniquery, meta: TableMetadata): DbQuery;
   abstract translateAggregateQuery(query: AggregateQuery, meta: TableMetadata): DbQuery;
   /**
-   * Recursively walks a filter expression, applying adapter-specific value
-   * formatting via `formatFilterValue`. Shared by both document and relational
-   * mappers (relational adds key-renaming via `translateFilterWithRename`).
+   * Recursively walks a filter expression, applying `@db.column` key renames
+   * via `columnMap` and adapter-specific value formatting via `formatFilterValue`.
+   *
+   * The relational mapper overrides this to use `leafByLogical` for deeper
+   * key resolution (flattened nested paths).
    */
   translateFilter(filter: FilterExpr, meta: TableMetadata): FilterExpr;
   abstract prepareForWrite(payload: Record<string, unknown>, meta: TableMetadata, adapter: BaseDbAdapter): Record<string, unknown>;
   abstract translatePatchKeys(update: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
+  /**
+   * Reverse-maps `@db.column` renames on a row read from storage.
+   * Renames physical keys back to logical names in-place.
+   */
+  protected reverseColumnRenames(row: Record<string, unknown>, meta: TableMetadata): void;
   /**
    * Coerces field values from storage representation to JS types
    * (booleans from 0/1, decimals from number to string).

package/dist/{db-readable-Bbr4CjMb.d.mts → db-readable-Cc868K54.d.mts}

@@ -399,7 +399,11 @@ declare class TableMetadata {
   booleanFields: Set<string>;
   decimalFields: Set<string>;
   allPhysicalFields: string[];
+  /** Precomputed parent path → child physical column names for fast null-setting. */
+  childrenByParent: Map<string, string[]>;
   requiresMappings: boolean;
+  /** True when the only mappings needed are simple `@db.column` renames (no nesting/JSON). */
+  onlyColumnRenames: boolean;
   toStorageFormatters?: Map<string, (value: unknown) => unknown>;
   fromStorageFormatters?: Map<string, (value: unknown) => unknown>;
   /** Leaf field descriptors indexed by physical column name (read path). */
@@ -958,13 +962,20 @@ declare abstract class FieldMappingStrategy {
   abstract translateQuery(query: Uniquery, meta: TableMetadata): DbQuery;
   abstract translateAggregateQuery(query: AggregateQuery, meta: TableMetadata): DbQuery;
   /**
-   * Recursively walks a filter expression, applying adapter-specific value
-   * formatting via `formatFilterValue`. Shared by both document and relational
-   * mappers (relational adds key-renaming via `translateFilterWithRename`).
+   * Recursively walks a filter expression, applying `@db.column` key renames
+   * via `columnMap` and adapter-specific value formatting via `formatFilterValue`.
+   *
+   * The relational mapper overrides this to use `leafByLogical` for deeper
+   * key resolution (flattened nested paths).
    */
   translateFilter(filter: FilterExpr, meta: TableMetadata): FilterExpr;
   abstract prepareForWrite(payload: Record<string, unknown>, meta: TableMetadata, adapter: BaseDbAdapter): Record<string, unknown>;
   abstract translatePatchKeys(update: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
+  /**
+   * Reverse-maps `@db.column` renames on a row read from storage.
+   * Renames physical keys back to logical names in-place.
+   */
+  protected reverseColumnRenames(row: Record<string, unknown>, meta: TableMetadata): void;
   /**
    * Coerces field values from storage representation to JS types
    * (booleans from 0/1, decimals from number to string).

package/dist/{db-space-BUrQ5BFm.d.mts → db-space-Dgf-CphX.d.cts}

@@ -1,6 +1,6 @@
-import { F as TDbInsertResult, H as TFkLookupResolver, O as TDbDeleteResult, P as TDbInsertManyResult, S as TCascadeResolver, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata, t as AtscriptDbReadable, z as TDbUpdateResult } from "./db-readable-Bbr4CjMb.mjs";
-import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { F as TDbInsertResult, H as TFkLookupResolver, O as TDbDeleteResult, P as TDbInsertManyResult, S as TCascadeResolver, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata, t as AtscriptDbReadable, z as TDbUpdateResult } from "./db-readable-C3C-qPcP.cjs";
 import { FilterExpr } from "@uniqu/core";
+import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 
 //#region src/strategies/integrity.d.ts
 /**
@@ -130,9 +130,17 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    */
   protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
   /**
-   * Extracts primary key field(s) from a payload to build a filter.
+   * Extracts a record-identifying filter from a payload.
+   *
+   * Resolution order:
+   * 1. Primary key field(s) — if all PK fields are present in the payload.
+   * 2. Single-field unique index — first `@db.index.unique` field found.
+   * 3. Compound unique index — first compound unique index whose fields are all present.
+   *
+   * Throws when no identifying fields can be found.
    */
-  protected _extractPrimaryKeyFilter(payload: Record<string, unknown>): FilterExpr;
+  protected _extractRecordFilter(payload: Record<string, unknown>): FilterExpr;
+  private _prepareFilterValue;
   /**
    * Pre-validate items (type validation + FK constraints) without inserting them.
    * Used by parent tables to validate FROM children before the main insert,

package/dist/{db-space-Vxpcnyt5.d.cts → db-space-crCFv3DF.d.mts}

@@ -1,6 +1,6 @@
-import { F as TDbInsertResult, H as TFkLookupResolver, O as TDbDeleteResult, P as TDbInsertManyResult, S as TCascadeResolver, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata, t as AtscriptDbReadable, z as TDbUpdateResult } from "./db-readable-BQQzfguJ.cjs";
-import { FilterExpr } from "@uniqu/core";
+import { F as TDbInsertResult, H as TFkLookupResolver, O as TDbDeleteResult, P as TDbInsertManyResult, S as TCascadeResolver, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata, t as AtscriptDbReadable, z as TDbUpdateResult } from "./db-readable-Cc868K54.mjs";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { FilterExpr } from "@uniqu/core";
 
 //#region src/strategies/integrity.d.ts
 /**
@@ -130,9 +130,17 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    */
   protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
   /**
-   * Extracts primary key field(s) from a payload to build a filter.
+   * Extracts a record-identifying filter from a payload.
+   *
+   * Resolution order:
+   * 1. Primary key field(s) — if all PK fields are present in the payload.
+   * 2. Single-field unique index — first `@db.index.unique` field found.
+   * 3. Compound unique index — first compound unique index whose fields are all present.
+   *
+   * Throws when no identifying fields can be found.
    */
-  protected _extractPrimaryKeyFilter(payload: Record<string, unknown>): FilterExpr;
+  protected _extractRecordFilter(payload: Record<string, unknown>): FilterExpr;
+  private _prepareFilterValue;
   /**
    * Pre-validate items (type validation + FK constraints) without inserting them.
    * Used by parent tables to validate FROM children before the main insert,

package/dist/{db-validator-plugin-07kDiis2.d.cts → db-validator-plugin-BLMVdi9z.d.mts}

@@ -5,6 +5,8 @@ interface DbValidationContext {
   mode: "insert" | "replace" | "patch";
   /** Flat map from the table — used to check if an array is a top-level array. */
   flatMap?: Map<string, TAtscriptAnnotatedType>;
+  /** Precomputed nav field names — used to skip field-op validation inside TO/FROM/VIA relations. */
+  navFields?: ReadonlySet<string>;
 }
 /**
  * Validator plugin for database operations.

package/dist/{db-validator-plugin-CiqsHTI_.d.mts → db-validator-plugin-Cz4QoDWg.d.cts}

@@ -5,6 +5,8 @@ interface DbValidationContext {
   mode: "insert" | "replace" | "patch";
   /** Flat map from the table — used to check if an array is a top-level array. */
   flatMap?: Map<string, TAtscriptAnnotatedType>;
+  /** Precomputed nav field names — used to skip field-op validation inside TO/FROM/VIA relations. */
+  navFields?: ReadonlySet<string>;
 }
 /**
  * Validator plugin for database operations.

package/dist/{db-view-BntnAmXO.cjs → db-view-CcUjETIF.cjs}

@@ -1,4 +1,4 @@
-const require_nested_writer = require("./nested-writer-BDXsDMPP.cjs");
+const require_nested_writer = require("./nested-writer-BIQ6EfaR.cjs");
 const require_agg = require("./agg.cjs");
 const require_relation_helpers = require("./relation-helpers-BYvsE1tR.cjs");
 const require_ops = require("./ops.cjs");
@@ -69,7 +69,11 @@ var TableMetadata = class {
 	booleanFields = /* @__PURE__ */ new Set();
 	decimalFields = /* @__PURE__ */ new Set();
 	allPhysicalFields = [];
+	/** Precomputed parent path → child physical column names for fast null-setting. */
+	childrenByParent = /* @__PURE__ */ new Map();
 	requiresMappings = false;
+	/** True when the only mappings needed are simple `@db.column` renames (no nesting/JSON). */
+	onlyColumnRenames = false;
 	toStorageFormatters;
 	fromStorageFormatters;
 	/** Leaf field descriptors indexed by physical column name (read path). */
@@ -300,7 +304,8 @@ var TableMetadata = class {
 			for (const [path, physical] of this.pathToPhysical) if (path.startsWith(prefix)) leaves.push(physical);
 			if (leaves.length > 0) this.selectExpansion.set(parentPath, leaves);
 		}
-		this.requiresMappings = this.flattenedParents.size > 0 || this.jsonFields.size > 0;
+		this.onlyColumnRenames = this.columnMap.size > 0 && this.flattenedParents.size === 0 && this.jsonFields.size === 0;
+		this.requiresMappings = this.flattenedParents.size > 0 || this.jsonFields.size > 0 || this.onlyColumnRenames;
 	}
 	/** Returns the `__`-separated parent prefix for a dot-separated path, or empty string for top-level paths. */
 	_flattenedPrefix(path) {
@@ -317,6 +322,12 @@ var TableMetadata = class {
 			this.leafByPhysical.set(fd.physicalName, fd);
 			this.leafByLogical.set(fd.path, fd);
 		}
+		for (const parentPath of this.flattenedParents) {
+			const prefix = `${parentPath}.`;
+			const children = [];
+			for (const [path, fd] of this.leafByLogical.entries()) if (path.startsWith(prefix)) children.push(fd.physicalName);
+			if (children.length > 0) this.childrenByParent.set(parentPath, children);
+		}
 	}
 	/**
 	* Builds field descriptors, physical-name lookup, and value formatters.
@@ -540,21 +551,36 @@ function toDecimalString(value) {
 */
 var FieldMappingStrategy = class {
 	/**
-	* Recursively walks a filter expression, applying adapter-specific value
-	* formatting via `formatFilterValue`. Shared by both document and relational
-	* mappers (relational adds key-renaming via `translateFilterWithRename`).
+	* Recursively walks a filter expression, applying `@db.column` key renames
+	* via `columnMap` and adapter-specific value formatting via `formatFilterValue`.
+	*
+	* The relational mapper overrides this to use `leafByLogical` for deeper
+	* key resolution (flattened nested paths).
 	*/
 	translateFilter(filter, meta) {
 		if (!filter || typeof filter !== "object") return filter;
-		if (!meta.toStorageFormatters) return filter;
+		if (!meta.toStorageFormatters && meta.columnMap.size === 0) return filter;
 		const result = {};
 		for (const [key, value] of Object.entries(filter)) if (key === "$and" || key === "$or") result[key] = value.map((f) => this.translateFilter(f, meta));
 		else if (key === "$not") result[key] = this.translateFilter(value, meta);
 		else if (key.startsWith("$")) result[key] = value;
-		else result[key] = this.formatFilterValue(key, value, meta);
+		else {
+			const physical = meta.columnMap.get(key) ?? key;
+			result[physical] = this.formatFilterValue(physical, value, meta);
+		}
 		return result;
 	}
 	/**
+	* Reverse-maps `@db.column` renames on a row read from storage.
+	* Renames physical keys back to logical names in-place.
+	*/
+	reverseColumnRenames(row, meta) {
+		for (const [logical, physical] of meta.columnMap.entries()) if (physical in row) {
+			row[logical] = row[physical];
+			delete row[physical];
+		}
+	}
+	/**
 	* Coerces field values from storage representation to JS types
 	* (booleans from 0/1, decimals from number to string).
 	*/
@@ -662,12 +688,15 @@ var FieldMappingStrategy = class {
 */
 var DocumentFieldMapper = class extends FieldMappingStrategy {
 	reconstructFromRead(row, meta) {
-		return this.applyFromStorageFormatters(this.coerceFieldValues(row, meta), meta);
+		this.coerceFieldValues(row, meta);
+		this.applyFromStorageFormatters(row, meta);
+		if (meta.columnMap.size > 0) this.reverseColumnRenames(row, meta);
+		return row;
 	}
 	translateQuery(query, meta) {
 		const controls = query.controls;
 		return {
-			filter: meta.toStorageFormatters ? this.translateFilter(query.filter, meta) : query.filter,
+			filter: this.translateFilter(query.filter, meta),
 			controls: {
 				...controls,
 				$with: void 0,
@@ -679,7 +708,7 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 	translateAggregateQuery(query, meta) {
 		const controls = query.controls;
 		return {
-			filter: meta.toStorageFormatters ? this.translateFilter(query.filter, meta) : query.filter ?? {},
+			filter: this.translateFilter(query.filter ?? {}, meta),
 			controls: {
 				...controls,
 				$with: void 0,
@@ -698,6 +727,11 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 		return this.formatWriteValues(data, meta);
 	}
 	translatePatchKeys(update, meta) {
+		if (meta.columnMap.size > 0) {
+			const result = {};
+			for (const key of Object.keys(update)) result[meta.columnMap.get(key) ?? key] = update[key];
+			return this.formatWriteValues(result, meta);
+		}
 		return this.formatWriteValues(update, meta);
 	}
 };
@@ -712,6 +746,12 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 var RelationalFieldMapper = class extends FieldMappingStrategy {
 	reconstructFromRead(row, meta) {
 		if (!meta.requiresMappings) return this.applyFromStorageFormatters(this.coerceFieldValues(row, meta), meta);
+		if (meta.onlyColumnRenames) {
+			this.coerceFieldValues(row, meta);
+			this.applyFromStorageFormatters(row, meta);
+			this.reverseColumnRenames(row, meta);
+			return row;
+		}
 		const result = {};
 		const fromFmts = meta.fromStorageFormatters;
 		for (const physical of Object.keys(row)) {
@@ -794,6 +834,15 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 		};
 	}
 	/**
+	* Overrides the base `translateFilter` to use `leafByLogical` for key resolution
+	* (handles flattened nested paths like `contact.email` → `contact__email`).
+	*/
+	translateFilter(filter, meta) {
+		if (!filter || typeof filter !== "object") return filter;
+		if (!meta.requiresMappings && !meta.toStorageFormatters) return filter;
+		return this.translateFilterWithRename(filter, meta);
+	}
+	/**
 	* Translates filter with key renaming from logical to physical names.
 	* Used by the relational query path where field paths must be mapped
 	* to `__`-separated column names.
@@ -813,7 +862,8 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	prepareForWrite(payload, meta, adapter) {
 		const data = { ...payload };
 		this.prepareCommon(data, meta, adapter);
-		if (!meta.requiresMappings) {
+		if (!meta.requiresMappings) return this.formatWriteValues(data, meta);
+		if (meta.onlyColumnRenames) {
 			for (const [logical, physical] of meta.columnMap.entries()) if (logical in data) {
 				data[physical] = data[logical];
 				delete data[logical];
@@ -824,6 +874,11 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	}
 	translatePatchKeys(update, meta) {
 		if (!meta.requiresMappings && !meta.toStorageFormatters) return update;
+		if (meta.onlyColumnRenames && !meta.toStorageFormatters) {
+			const result = {};
+			for (const key of Object.keys(update)) result[meta.leafByLogical.get(key)?.physicalName ?? key] = update[key];
+			return result;
+		}
 		const result = {};
 		const updateKeys = Object.keys(update);
 		for (const key of updateKeys) {
@@ -921,8 +976,8 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	* When a parent object is null/undefined, set all its flattened children to null.
 	*/
 	setFlattenedChildrenNull(parentPath, result, meta) {
-		const prefix = `${parentPath}.`;
-		for (const [path, fd] of meta.leafByLogical.entries()) if (path.startsWith(prefix)) result[fd.physicalName] = null;
+		const children = meta.childrenByParent.get(parentPath);
+		if (children) for (const physical of children) result[physical] = null;
 	}
 };
 //#endregion
@@ -2108,16 +2163,52 @@ function createDbValidatorPlugin() {
 		const isFrom = def.metadata.has("db.rel.from");
 		const isVia = def.metadata.has("db.rel.via");
 		if (isTo || isFrom || isVia) return handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia);
-		if (dbCtx.mode === "patch" && require_ops.isDbFieldOp(value)) return true;
-		if (dbCtx.mode === "patch" && def.type.kind === "array" && dbCtx.flatMap) {
-			const flatEntry = dbCtx.flatMap.get(ctx.path);
-			if (flatEntry?.metadata?.has("db.__topLevelArray") && !flatEntry.metadata.has("db.json")) return handleArrayPatch(ctx, def, value);
+		if (dbCtx.mode === "patch") {
+			if (require_ops.isDbFieldOp(value)) {
+				if (dbCtx.flatMap && !isFieldOpAllowed(ctx.path, dbCtx.flatMap, dbCtx.navFields)) {
+					ctx.error("Field operations ($inc/$dec/$mul) are not supported inside @db.json fields or nested objects without @db.patch.strategy \"merge\"");
+					return false;
+				}
+				if (!(def.type.kind === "" && def.type.designType === "number")) {
+					ctx.error("Field operations ($inc/$dec/$mul) can only be applied to numeric fields");
+					return false;
+				}
+				return true;
+			}
+			if (def.type.kind === "array" && dbCtx.flatMap) {
+				const flatEntry = dbCtx.flatMap.get(ctx.path);
+				if (flatEntry?.metadata?.has("db.__topLevelArray") && !flatEntry.metadata.has("db.json")) return handleArrayPatch(ctx, def, value);
+			}
 		}
 	};
 }
+/**
+* Checks whether a field op is valid at `path`.
+*
+* Rejects when:
+* - The field itself is `@db.json` (ops on opaque blobs are meaningless).
+* - Any ancestor is `@db.json`.
+* - Any ancestor is a nested object without `@db.patch.strategy "merge"`.
+*
+* Accepts immediately when an ancestor is a navigation field (TO/FROM/VIA) —
+* the nested data is extracted and validated against its own table separately.
+*/
+function isFieldOpAllowed(path, flatMap, navFields) {
+	if (flatMap.get(path)?.metadata.has("db.json")) return false;
+	let pos = path.length;
+	while ((pos = path.lastIndexOf(".", pos - 1)) !== -1) {
+		const ancestor = path.slice(0, pos);
+		if (navFields?.has(ancestor)) return true;
+		const entry = flatMap.get(ancestor);
+		if (!entry) continue;
+		if (entry.metadata.has("db.json")) return false;
+		if (entry.type.kind === "object" && entry.metadata.get("db.patch.strategy") !== "merge") return false;
+	}
+	return true;
+}
 function handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia) {
-	const pathParts = ctx.path.split(".");
-	const fieldName = pathParts[pathParts.length - 1] || ctx.path;
+	const dotIdx = ctx.path.lastIndexOf(".");
+	const fieldName = dotIdx === -1 ? ctx.path : ctx.path.slice(dotIdx + 1);
 	if (value === null) {
 		ctx.error(`Cannot process null navigation property '${fieldName}'`);
 		return false;
@@ -2554,7 +2645,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		if (!canNest && this._meta.navFields.size > 0) require_nested_writer.checkDepthOverflow(payloads, maxDepth, this._meta);
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
-			require_nested_writer.validateBatch(this.getValidator("insert"), items, { mode: "insert" });
+			require_nested_writer.validateBatch(this.getValidator("insert"), items, {
+				mode: "insert",
+				navFields: this._meta.navFields
+			});
 			const host = this;
 			if (canNest) await require_nested_writer.batchInsertNestedTo(host, items, maxDepth, depth);
 			const prepared = [];
@@ -2594,7 +2688,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
-			require_nested_writer.validateBatch(this.getValidator("bulkReplace"), items, { mode: "replace" });
+			require_nested_writer.validateBatch(this.getValidator("bulkReplace"), items, {
+				mode: "replace",
+				navFields: this._meta.navFields
+			});
 			const host = this;
 			if (canNest) await require_nested_writer.batchReplaceNestedTo(host, items, maxDepth, depth);
 			await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver);
@@ -2603,7 +2700,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			let modifiedCount = 0;
 			for (const data of items) {
 				for (const navField of this._meta.navFields) delete data[navField];
-				const filter = this._extractPrimaryKeyFilter(data);
+				const filter = this._extractRecordFilter(data);
 				const prepared = this._fieldMapper.prepareForWrite(data, this._meta, this.adapter);
 				const result = await this.adapter.replaceOne(this._fieldMapper.translateFilter(filter, this._meta), prepared);
 				matchedCount += result.matchedCount;
@@ -2640,7 +2737,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			require_nested_writer.validateBatch(this.getValidator("bulkUpdate"), payloads, {
 				mode: "patch",
-				flatMap: this.flatMap
+				flatMap: this.flatMap,
+				navFields: this._meta.navFields
 			});
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
 			const host = this;
@@ -2651,20 +2749,24 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			for (const payload of payloads) {
 				const data = { ...payload };
 				for (const navField of this._meta.navFields) delete data[navField];
-				const filter = this._extractPrimaryKeyFilter(data);
-				for (const pk of this._meta.primaryKeys) delete data[pk];
-				const ops = require_ops.separateFieldOps(data);
-				if (_isEmptyObj(data) && !ops) {
+				const filter = this._extractRecordFilter(data);
+				for (const key of Object.keys(filter)) delete data[key];
+				if (_isEmptyObj(data)) {
 					matchedCount += 1;
 					modifiedCount += 0;
 					continue;
 				}
 				let result;
 				const translatedFilter = this._fieldMapper.translateFilter(filter, this._meta);
-				const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
-				if (this.adapter.supportsNativePatch()) result = await this.adapter.nativePatch(translatedFilter, data, translatedOps);
-				else {
+				if (this.adapter.supportsNativePatch()) {
+					const ops = require_ops.separateFieldOps(data);
+					const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
+					const translatedData = this._fieldMapper.translatePatchKeys(data, this._meta);
+					result = await this.adapter.nativePatch(translatedFilter, translatedData, translatedOps);
+				} else {
 					const update = decomposePatch(data, this);
+					const ops = require_ops.separateFieldOps(update);
+					const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
 					const translatedUpdate = this._fieldMapper.translatePatchKeys(update, this._meta);
 					if (getArrayOpsFields(translatedUpdate).size > 0) {
 						const resolved = resolveArrayOps(translatedUpdate, await this.adapter.findOne({
@@ -2705,10 +2807,11 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	async updateMany(filter, data) {
 		this._ensureBuilt();
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver, true);
-		const dataCopy = { ...data };
-		const ops = require_ops.separateFieldOps(dataCopy);
+		const update = decomposePatch({ ...data }, this);
+		const ops = require_ops.separateFieldOps(update);
 		const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
-		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.updateMany(this._fieldMapper.translateFilter(filter, this._meta), this._fieldMapper.prepareForWrite(dataCopy, this._meta, this.adapter), translatedOps));
+		const translatedUpdate = this._fieldMapper.translatePatchKeys(update, this._meta);
+		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.updateMany(this._fieldMapper.translateFilter(filter, this._meta), translatedUpdate, translatedOps));
 	}
 	async replaceMany(filter, data) {
 		this._ensureBuilt();
@@ -2761,24 +2864,55 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return data;
 	}
 	/**
-	* Extracts primary key field(s) from a payload to build a filter.
+	* Extracts a record-identifying filter from a payload.
+	*
+	* Resolution order:
+	* 1. Primary key field(s) — if all PK fields are present in the payload.
+	* 2. Single-field unique index — first `@db.index.unique` field found.
+	* 3. Compound unique index — first compound unique index whose fields are all present.
+	*
+	* Throws when no identifying fields can be found.
 	*/
-	_extractPrimaryKeyFilter(payload) {
+	_extractRecordFilter(payload) {
 		const pkFields = this.primaryKeys;
+		if (pkFields.length > 0) {
+			let allPresent = true;
+			for (const field of pkFields) if (payload[field] === void 0) {
+				allPresent = false;
+				break;
+			}
+			if (allPresent) {
+				const filter = {};
+				for (const field of pkFields) filter[field] = this._prepareFilterValue(field, payload[field]);
+				return filter;
+			}
+		}
+		for (const prop of this.uniqueProps) if (payload[prop] !== void 0) return { [prop]: this._prepareFilterValue(prop, payload[prop]) };
+		for (const index of this._meta.indexes.values()) {
+			if (index.type !== "unique" || index.fields.length < 2) continue;
+			let allPresent = true;
+			for (const indexField of index.fields) if (payload[indexField.name] === void 0) {
+				allPresent = false;
+				break;
+			}
+			if (allPresent) {
+				const filter = {};
+				for (const indexField of index.fields) filter[indexField.name] = this._prepareFilterValue(indexField.name, payload[indexField.name]);
+				return filter;
+			}
+		}
 		if (pkFields.length === 0) throw new require_nested_writer.DbError("NOT_FOUND", [{
 			path: "",
 			message: "No primary key defined — cannot extract filter"
 		}]);
-		const filter = {};
-		for (const field of pkFields) {
-			if (payload[field] === void 0) throw new require_nested_writer.DbError("NOT_FOUND", [{
-				path: field,
-				message: `Missing primary key field "${field}" in payload`
-			}]);
-			const fieldType = this.flatMap.get(field);
-			filter[field] = fieldType ? this.adapter.prepareId(payload[field], fieldType) : payload[field];
-		}
-		return filter;
+		throw new require_nested_writer.DbError("NOT_FOUND", [{
+			path: pkFields[0],
+			message: `Missing primary key field "${pkFields[0]}" in payload`
+		}]);
+	}
+	_prepareFilterValue(field, value) {
+		const fieldType = this.flatMap.get(field);
+		return fieldType ? this.adapter.prepareId(value, fieldType) : value;
 	}
 	/**
 	* Pre-validate items (type validation + FK constraints) without inserting them.
@@ -2789,7 +2923,12 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	*/
 	async preValidateItems(items, opts) {
 		this._ensureBuilt();
-		require_nested_writer.validateBatch(this.getValidator("insert"), items.map((raw) => this._applyDefaults({ ...raw })), { mode: "insert" });
+		const validator = this.getValidator("insert");
+		const ctx = {
+			mode: "insert",
+			navFields: this._meta.navFields
+		};
+		require_nested_writer.validateBatch(validator, items.map((raw) => this._applyDefaults({ ...raw })), ctx);
 		await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver, false, opts?.excludeFkTargetTable);
 	}
 	/**

package/dist/{db-view-ZsoN91-q.mjs → db-view-DSK76uc9.mjs}

@@ -1,4 +1,4 @@
-import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, h as DbError, i as batchPatchNestedFrom, l as batchReplaceNestedVia, m as remapDeleteFkViolation, n as batchInsertNestedTo, o as batchPatchNestedVia, p as enrichFkViolation, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-Dmm1gbZV.mjs";
+import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, h as DbError, i as batchPatchNestedFrom, l as batchReplaceNestedVia, m as remapDeleteFkViolation, n as batchInsertNestedTo, o as batchPatchNestedVia, p as enrichFkViolation, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-CNDyhg2L.mjs";
 import { resolveAlias } from "./agg.mjs";
 import { n as findRemoteFK, t as findFKForRelation } from "./relation-helpers-CLasawQq.mjs";
 import { isDbFieldOp, separateFieldOps } from "./ops.mjs";
@@ -69,7 +69,11 @@ var TableMetadata = class {
 	booleanFields = /* @__PURE__ */ new Set();
 	decimalFields = /* @__PURE__ */ new Set();
 	allPhysicalFields = [];
+	/** Precomputed parent path → child physical column names for fast null-setting. */
+	childrenByParent = /* @__PURE__ */ new Map();
 	requiresMappings = false;
+	/** True when the only mappings needed are simple `@db.column` renames (no nesting/JSON). */
+	onlyColumnRenames = false;
 	toStorageFormatters;
 	fromStorageFormatters;
 	/** Leaf field descriptors indexed by physical column name (read path). */
@@ -300,7 +304,8 @@ var TableMetadata = class {
 			for (const [path, physical] of this.pathToPhysical) if (path.startsWith(prefix)) leaves.push(physical);
 			if (leaves.length > 0) this.selectExpansion.set(parentPath, leaves);
 		}
-		this.requiresMappings = this.flattenedParents.size > 0 || this.jsonFields.size > 0;
+		this.onlyColumnRenames = this.columnMap.size > 0 && this.flattenedParents.size === 0 && this.jsonFields.size === 0;
+		this.requiresMappings = this.flattenedParents.size > 0 || this.jsonFields.size > 0 || this.onlyColumnRenames;
 	}
 	/** Returns the `__`-separated parent prefix for a dot-separated path, or empty string for top-level paths. */
 	_flattenedPrefix(path) {
@@ -317,6 +322,12 @@ var TableMetadata = class {
 			this.leafByPhysical.set(fd.physicalName, fd);
 			this.leafByLogical.set(fd.path, fd);
 		}
+		for (const parentPath of this.flattenedParents) {
+			const prefix = `${parentPath}.`;
+			const children = [];
+			for (const [path, fd] of this.leafByLogical.entries()) if (path.startsWith(prefix)) children.push(fd.physicalName);
+			if (children.length > 0) this.childrenByParent.set(parentPath, children);
+		}
 	}
 	/**
 	* Builds field descriptors, physical-name lookup, and value formatters.
@@ -540,21 +551,36 @@ function toDecimalString(value) {
 */
 var FieldMappingStrategy = class {
 	/**
-	* Recursively walks a filter expression, applying adapter-specific value
-	* formatting via `formatFilterValue`. Shared by both document and relational
-	* mappers (relational adds key-renaming via `translateFilterWithRename`).
+	* Recursively walks a filter expression, applying `@db.column` key renames
+	* via `columnMap` and adapter-specific value formatting via `formatFilterValue`.
+	*
+	* The relational mapper overrides this to use `leafByLogical` for deeper
+	* key resolution (flattened nested paths).
 	*/
 	translateFilter(filter, meta) {
 		if (!filter || typeof filter !== "object") return filter;
-		if (!meta.toStorageFormatters) return filter;
+		if (!meta.toStorageFormatters && meta.columnMap.size === 0) return filter;
 		const result = {};
 		for (const [key, value] of Object.entries(filter)) if (key === "$and" || key === "$or") result[key] = value.map((f) => this.translateFilter(f, meta));
 		else if (key === "$not") result[key] = this.translateFilter(value, meta);
 		else if (key.startsWith("$")) result[key] = value;
-		else result[key] = this.formatFilterValue(key, value, meta);
+		else {
+			const physical = meta.columnMap.get(key) ?? key;
+			result[physical] = this.formatFilterValue(physical, value, meta);
+		}
 		return result;
 	}
 	/**
+	* Reverse-maps `@db.column` renames on a row read from storage.
+	* Renames physical keys back to logical names in-place.
+	*/
+	reverseColumnRenames(row, meta) {
+		for (const [logical, physical] of meta.columnMap.entries()) if (physical in row) {
+			row[logical] = row[physical];
+			delete row[physical];
+		}
+	}
+	/**
 	* Coerces field values from storage representation to JS types
 	* (booleans from 0/1, decimals from number to string).
 	*/
@@ -662,12 +688,15 @@ var FieldMappingStrategy = class {
 */
 var DocumentFieldMapper = class extends FieldMappingStrategy {
 	reconstructFromRead(row, meta) {
-		return this.applyFromStorageFormatters(this.coerceFieldValues(row, meta), meta);
+		this.coerceFieldValues(row, meta);
+		this.applyFromStorageFormatters(row, meta);
+		if (meta.columnMap.size > 0) this.reverseColumnRenames(row, meta);
+		return row;
 	}
 	translateQuery(query, meta) {
 		const controls = query.controls;
 		return {
-			filter: meta.toStorageFormatters ? this.translateFilter(query.filter, meta) : query.filter,
+			filter: this.translateFilter(query.filter, meta),
 			controls: {
 				...controls,
 				$with: void 0,
@@ -679,7 +708,7 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 	translateAggregateQuery(query, meta) {
 		const controls = query.controls;
 		return {
-			filter: meta.toStorageFormatters ? this.translateFilter(query.filter, meta) : query.filter ?? {},
+			filter: this.translateFilter(query.filter ?? {}, meta),
 			controls: {
 				...controls,
 				$with: void 0,
@@ -698,6 +727,11 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 		return this.formatWriteValues(data, meta);
 	}
 	translatePatchKeys(update, meta) {
+		if (meta.columnMap.size > 0) {
+			const result = {};
+			for (const key of Object.keys(update)) result[meta.columnMap.get(key) ?? key] = update[key];
+			return this.formatWriteValues(result, meta);
+		}
 		return this.formatWriteValues(update, meta);
 	}
 };
@@ -712,6 +746,12 @@ var DocumentFieldMapper = class extends FieldMappingStrategy {
 var RelationalFieldMapper = class extends FieldMappingStrategy {
 	reconstructFromRead(row, meta) {
 		if (!meta.requiresMappings) return this.applyFromStorageFormatters(this.coerceFieldValues(row, meta), meta);
+		if (meta.onlyColumnRenames) {
+			this.coerceFieldValues(row, meta);
+			this.applyFromStorageFormatters(row, meta);
+			this.reverseColumnRenames(row, meta);
+			return row;
+		}
 		const result = {};
 		const fromFmts = meta.fromStorageFormatters;
 		for (const physical of Object.keys(row)) {
@@ -794,6 +834,15 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 		};
 	}
 	/**
+	* Overrides the base `translateFilter` to use `leafByLogical` for key resolution
+	* (handles flattened nested paths like `contact.email` → `contact__email`).
+	*/
+	translateFilter(filter, meta) {
+		if (!filter || typeof filter !== "object") return filter;
+		if (!meta.requiresMappings && !meta.toStorageFormatters) return filter;
+		return this.translateFilterWithRename(filter, meta);
+	}
+	/**
 	* Translates filter with key renaming from logical to physical names.
 	* Used by the relational query path where field paths must be mapped
 	* to `__`-separated column names.
@@ -813,7 +862,8 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	prepareForWrite(payload, meta, adapter) {
 		const data = { ...payload };
 		this.prepareCommon(data, meta, adapter);
-		if (!meta.requiresMappings) {
+		if (!meta.requiresMappings) return this.formatWriteValues(data, meta);
+		if (meta.onlyColumnRenames) {
 			for (const [logical, physical] of meta.columnMap.entries()) if (logical in data) {
 				data[physical] = data[logical];
 				delete data[logical];
@@ -824,6 +874,11 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	}
 	translatePatchKeys(update, meta) {
 		if (!meta.requiresMappings && !meta.toStorageFormatters) return update;
+		if (meta.onlyColumnRenames && !meta.toStorageFormatters) {
+			const result = {};
+			for (const key of Object.keys(update)) result[meta.leafByLogical.get(key)?.physicalName ?? key] = update[key];
+			return result;
+		}
 		const result = {};
 		const updateKeys = Object.keys(update);
 		for (const key of updateKeys) {
@@ -921,8 +976,8 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 	* When a parent object is null/undefined, set all its flattened children to null.
 	*/
 	setFlattenedChildrenNull(parentPath, result, meta) {
-		const prefix = `${parentPath}.`;
-		for (const [path, fd] of meta.leafByLogical.entries()) if (path.startsWith(prefix)) result[fd.physicalName] = null;
+		const children = meta.childrenByParent.get(parentPath);
+		if (children) for (const physical of children) result[physical] = null;
 	}
 };
 //#endregion
@@ -2108,16 +2163,52 @@ function createDbValidatorPlugin() {
 		const isFrom = def.metadata.has("db.rel.from");
 		const isVia = def.metadata.has("db.rel.via");
 		if (isTo || isFrom || isVia) return handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia);
-		if (dbCtx.mode === "patch" && isDbFieldOp(value)) return true;
-		if (dbCtx.mode === "patch" && def.type.kind === "array" && dbCtx.flatMap) {
-			const flatEntry = dbCtx.flatMap.get(ctx.path);
-			if (flatEntry?.metadata?.has("db.__topLevelArray") && !flatEntry.metadata.has("db.json")) return handleArrayPatch(ctx, def, value);
+		if (dbCtx.mode === "patch") {
+			if (isDbFieldOp(value)) {
+				if (dbCtx.flatMap && !isFieldOpAllowed(ctx.path, dbCtx.flatMap, dbCtx.navFields)) {
+					ctx.error("Field operations ($inc/$dec/$mul) are not supported inside @db.json fields or nested objects without @db.patch.strategy \"merge\"");
+					return false;
+				}
+				if (!(def.type.kind === "" && def.type.designType === "number")) {
+					ctx.error("Field operations ($inc/$dec/$mul) can only be applied to numeric fields");
+					return false;
+				}
+				return true;
+			}
+			if (def.type.kind === "array" && dbCtx.flatMap) {
+				const flatEntry = dbCtx.flatMap.get(ctx.path);
+				if (flatEntry?.metadata?.has("db.__topLevelArray") && !flatEntry.metadata.has("db.json")) return handleArrayPatch(ctx, def, value);
+			}
 		}
 	};
 }
+/**
+* Checks whether a field op is valid at `path`.
+*
+* Rejects when:
+* - The field itself is `@db.json` (ops on opaque blobs are meaningless).
+* - Any ancestor is `@db.json`.
+* - Any ancestor is a nested object without `@db.patch.strategy "merge"`.
+*
+* Accepts immediately when an ancestor is a navigation field (TO/FROM/VIA) —
+* the nested data is extracted and validated against its own table separately.
+*/
+function isFieldOpAllowed(path, flatMap, navFields) {
+	if (flatMap.get(path)?.metadata.has("db.json")) return false;
+	let pos = path.length;
+	while ((pos = path.lastIndexOf(".", pos - 1)) !== -1) {
+		const ancestor = path.slice(0, pos);
+		if (navFields?.has(ancestor)) return true;
+		const entry = flatMap.get(ancestor);
+		if (!entry) continue;
+		if (entry.metadata.has("db.json")) return false;
+		if (entry.type.kind === "object" && entry.metadata.get("db.patch.strategy") !== "merge") return false;
+	}
+	return true;
+}
 function handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia) {
-	const pathParts = ctx.path.split(".");
-	const fieldName = pathParts[pathParts.length - 1] || ctx.path;
+	const dotIdx = ctx.path.lastIndexOf(".");
+	const fieldName = dotIdx === -1 ? ctx.path : ctx.path.slice(dotIdx + 1);
 	if (value === null) {
 		ctx.error(`Cannot process null navigation property '${fieldName}'`);
 		return false;
@@ -2554,7 +2645,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		if (!canNest && this._meta.navFields.size > 0) checkDepthOverflow(payloads, maxDepth, this._meta);
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
-			validateBatch(this.getValidator("insert"), items, { mode: "insert" });
+			validateBatch(this.getValidator("insert"), items, {
+				mode: "insert",
+				navFields: this._meta.navFields
+			});
 			const host = this;
 			if (canNest) await batchInsertNestedTo(host, items, maxDepth, depth);
 			const prepared = [];
@@ -2594,7 +2688,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
-			validateBatch(this.getValidator("bulkReplace"), items, { mode: "replace" });
+			validateBatch(this.getValidator("bulkReplace"), items, {
+				mode: "replace",
+				navFields: this._meta.navFields
+			});
 			const host = this;
 			if (canNest) await batchReplaceNestedTo(host, items, maxDepth, depth);
 			await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver);
@@ -2603,7 +2700,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			let modifiedCount = 0;
 			for (const data of items) {
 				for (const navField of this._meta.navFields) delete data[navField];
-				const filter = this._extractPrimaryKeyFilter(data);
+				const filter = this._extractRecordFilter(data);
 				const prepared = this._fieldMapper.prepareForWrite(data, this._meta, this.adapter);
 				const result = await this.adapter.replaceOne(this._fieldMapper.translateFilter(filter, this._meta), prepared);
 				matchedCount += result.matchedCount;
@@ -2640,7 +2737,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			validateBatch(this.getValidator("bulkUpdate"), payloads, {
 				mode: "patch",
-				flatMap: this.flatMap
+				flatMap: this.flatMap,
+				navFields: this._meta.navFields
 			});
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
 			const host = this;
@@ -2651,20 +2749,24 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			for (const payload of payloads) {
 				const data = { ...payload };
 				for (const navField of this._meta.navFields) delete data[navField];
-				const filter = this._extractPrimaryKeyFilter(data);
-				for (const pk of this._meta.primaryKeys) delete data[pk];
-				const ops = separateFieldOps(data);
-				if (_isEmptyObj(data) && !ops) {
+				const filter = this._extractRecordFilter(data);
+				for (const key of Object.keys(filter)) delete data[key];
+				if (_isEmptyObj(data)) {
 					matchedCount += 1;
 					modifiedCount += 0;
 					continue;
 				}
 				let result;
 				const translatedFilter = this._fieldMapper.translateFilter(filter, this._meta);
-				const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
-				if (this.adapter.supportsNativePatch()) result = await this.adapter.nativePatch(translatedFilter, data, translatedOps);
-				else {
+				if (this.adapter.supportsNativePatch()) {
+					const ops = separateFieldOps(data);
+					const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
+					const translatedData = this._fieldMapper.translatePatchKeys(data, this._meta);
+					result = await this.adapter.nativePatch(translatedFilter, translatedData, translatedOps);
+				} else {
 					const update = decomposePatch(data, this);
+					const ops = separateFieldOps(update);
+					const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
 					const translatedUpdate = this._fieldMapper.translatePatchKeys(update, this._meta);
 					if (getArrayOpsFields(translatedUpdate).size > 0) {
 						const resolved = resolveArrayOps(translatedUpdate, await this.adapter.findOne({
@@ -2705,10 +2807,11 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	async updateMany(filter, data) {
 		this._ensureBuilt();
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver, true);
-		const dataCopy = { ...data };
-		const ops = separateFieldOps(dataCopy);
+		const update = decomposePatch({ ...data }, this);
+		const ops = separateFieldOps(update);
 		const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
-		return enrichFkViolation(this._meta, () => this.adapter.updateMany(this._fieldMapper.translateFilter(filter, this._meta), this._fieldMapper.prepareForWrite(dataCopy, this._meta, this.adapter), translatedOps));
+		const translatedUpdate = this._fieldMapper.translatePatchKeys(update, this._meta);
+		return enrichFkViolation(this._meta, () => this.adapter.updateMany(this._fieldMapper.translateFilter(filter, this._meta), translatedUpdate, translatedOps));
 	}
 	async replaceMany(filter, data) {
 		this._ensureBuilt();
@@ -2761,24 +2864,55 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return data;
 	}
 	/**
-	* Extracts primary key field(s) from a payload to build a filter.
+	* Extracts a record-identifying filter from a payload.
+	*
+	* Resolution order:
+	* 1. Primary key field(s) — if all PK fields are present in the payload.
+	* 2. Single-field unique index — first `@db.index.unique` field found.
+	* 3. Compound unique index — first compound unique index whose fields are all present.
+	*
+	* Throws when no identifying fields can be found.
 	*/
-	_extractPrimaryKeyFilter(payload) {
+	_extractRecordFilter(payload) {
 		const pkFields = this.primaryKeys;
+		if (pkFields.length > 0) {
+			let allPresent = true;
+			for (const field of pkFields) if (payload[field] === void 0) {
+				allPresent = false;
+				break;
+			}
+			if (allPresent) {
+				const filter = {};
+				for (const field of pkFields) filter[field] = this._prepareFilterValue(field, payload[field]);
+				return filter;
+			}
+		}
+		for (const prop of this.uniqueProps) if (payload[prop] !== void 0) return { [prop]: this._prepareFilterValue(prop, payload[prop]) };
+		for (const index of this._meta.indexes.values()) {
+			if (index.type !== "unique" || index.fields.length < 2) continue;
+			let allPresent = true;
+			for (const indexField of index.fields) if (payload[indexField.name] === void 0) {
+				allPresent = false;
+				break;
+			}
+			if (allPresent) {
+				const filter = {};
+				for (const indexField of index.fields) filter[indexField.name] = this._prepareFilterValue(indexField.name, payload[indexField.name]);
+				return filter;
+			}
+		}
 		if (pkFields.length === 0) throw new DbError("NOT_FOUND", [{
 			path: "",
 			message: "No primary key defined — cannot extract filter"
 		}]);
-		const filter = {};
-		for (const field of pkFields) {
-			if (payload[field] === void 0) throw new DbError("NOT_FOUND", [{
-				path: field,
-				message: `Missing primary key field "${field}" in payload`
-			}]);
-			const fieldType = this.flatMap.get(field);
-			filter[field] = fieldType ? this.adapter.prepareId(payload[field], fieldType) : payload[field];
-		}
-		return filter;
+		throw new DbError("NOT_FOUND", [{
+			path: pkFields[0],
+			message: `Missing primary key field "${pkFields[0]}" in payload`
+		}]);
+	}
+	_prepareFilterValue(field, value) {
+		const fieldType = this.flatMap.get(field);
+		return fieldType ? this.adapter.prepareId(value, fieldType) : value;
 	}
 	/**
 	* Pre-validate items (type validation + FK constraints) without inserting them.
@@ -2789,7 +2923,12 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	*/
 	async preValidateItems(items, opts) {
 		this._ensureBuilt();
-		validateBatch(this.getValidator("insert"), items.map((raw) => this._applyDefaults({ ...raw })), { mode: "insert" });
+		const validator = this.getValidator("insert");
+		const ctx = {
+			mode: "insert",
+			navFields: this._meta.navFields
+		};
+		validateBatch(validator, items.map((raw) => this._applyDefaults({ ...raw })), ctx);
 		await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver, false, opts?.excludeFkTargetTable);
 	}
 	/**

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_nested_writer = require("./nested-writer-BDXsDMPP.cjs");
-const require_db_view = require("./db-view-BntnAmXO.cjs");
+const require_nested_writer = require("./nested-writer-BIQ6EfaR.cjs");
+const require_db_view = require("./db-view-CcUjETIF.cjs");
 const require_ops = require("./ops.cjs");
 let _uniqu_core = require("@uniqu/core");
 //#region src/table/db-space.ts

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { $ as Uniquery, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TMetadataOverrides, H as TFkLookupResolver, I as TDbReferentialAction, J as TTableOptionDiff, K as TSearchIndexInfo, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TypedWithRelation, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupTarget, V as TExistingTableOption, W as TIdDescriptor, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as DbQuery, a as FieldMappingStrategy, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as UniqueryControls, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as UniquSelect, o as BaseDbAdapter, p as AggregateQuery, q as TSyncColumnResult, r as resolveDesignType, s as TableMetadata, t as AtscriptDbReadable, tt as WithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-BQQzfguJ.cjs";
+import { $ as Uniquery, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TMetadataOverrides, H as TFkLookupResolver, I as TDbReferentialAction, J as TTableOptionDiff, K as TSearchIndexInfo, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TypedWithRelation, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupTarget, V as TExistingTableOption, W as TIdDescriptor, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as DbQuery, a as FieldMappingStrategy, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as UniqueryControls, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as UniquSelect, o as BaseDbAdapter, p as AggregateQuery, q as TSyncColumnResult, r as resolveDesignType, s as TableMetadata, t as AtscriptDbReadable, tt as WithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-C3C-qPcP.cjs";
 import { d as getDbFieldOp, f as isDbFieldOp, l as TDbFieldOp, p as separateFieldOps, u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-Vxpcnyt5.cjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-07kDiis2.cjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-Dgf-CphX.cjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-Cz4QoDWg.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 import { TAtscriptAnnotatedType, TAtscriptTypeArray } from "@atscript/typescript/utils";
 
@@ -16,6 +16,11 @@ declare class RelationalFieldMapper extends FieldMappingStrategy {
   reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
   translateQuery(query: Uniquery$1, meta: TableMetadata): DbQuery;
   translateAggregateQuery(query: AggregateQuery$1, meta: TableMetadata): DbQuery;
+  /**
+   * Overrides the base `translateFilter` to use `leafByLogical` for key resolution
+   * (handles flattened nested paths like `contact.email` → `contact__email`).
+   */
+  translateFilter(filter: FilterExpr$1, meta: TableMetadata): FilterExpr$1;
   /**
    * Translates filter with key renaming from logical to physical names.
    * Used by the relational query path where field paths must be mapped

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { $ as Uniquery, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TMetadataOverrides, H as TFkLookupResolver, I as TDbReferentialAction, J as TTableOptionDiff, K as TSearchIndexInfo, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TypedWithRelation, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupTarget, V as TExistingTableOption, W as TIdDescriptor, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as DbQuery, a as FieldMappingStrategy, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as UniqueryControls, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as UniquSelect, o as BaseDbAdapter, p as AggregateQuery, q as TSyncColumnResult, r as resolveDesignType, s as TableMetadata, t as AtscriptDbReadable, tt as WithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-Bbr4CjMb.mjs";
+import { $ as Uniquery, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TMetadataOverrides, H as TFkLookupResolver, I as TDbReferentialAction, J as TTableOptionDiff, K as TSearchIndexInfo, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TypedWithRelation, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupTarget, V as TExistingTableOption, W as TIdDescriptor, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as DbQuery, a as FieldMappingStrategy, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as UniqueryControls, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as UniquSelect, o as BaseDbAdapter, p as AggregateQuery, q as TSyncColumnResult, r as resolveDesignType, s as TableMetadata, t as AtscriptDbReadable, tt as WithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-Cc868K54.mjs";
 import { d as getDbFieldOp, f as isDbFieldOp, l as TDbFieldOp, p as separateFieldOps, u as TFieldOps } from "./ops-BdRAFLKY.mjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-BUrQ5BFm.mjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-CiqsHTI_.mjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-crCFv3DF.mjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BLMVdi9z.mjs";
 import { TAtscriptAnnotatedType, TAtscriptTypeArray } from "@atscript/typescript/utils";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
@@ -16,6 +16,11 @@ declare class RelationalFieldMapper extends FieldMappingStrategy {
   reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
   translateQuery(query: Uniquery$1, meta: TableMetadata): DbQuery;
   translateAggregateQuery(query: AggregateQuery$1, meta: TableMetadata): DbQuery;
+  /**
+   * Overrides the base `translateFilter` to use `leafByLogical` for key resolution
+   * (handles flattened nested paths like `contact.email` → `contact__email`).
+   */
+  translateFilter(filter: FilterExpr$1, meta: TableMetadata): FilterExpr$1;
   /**
    * Translates filter with key renaming from logical to physical names.
    * Used by the relational query path where field paths must be mapped

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { h as DbError } from "./nested-writer-Dmm1gbZV.mjs";
-import { _ as NoopLogger, a as getKeyProps, c as IntegrityStrategy, d as resolveDesignType, f as RelationalFieldMapper, g as TableMetadata, h as UniquSelect, i as createDbValidatorPlugin, l as NativeIntegrity, m as FieldMappingStrategy, n as AtscriptDbTable, o as ApplicationIntegrity, p as DocumentFieldMapper, r as decomposePatch, s as BaseDbAdapter, t as AtscriptDbView, u as AtscriptDbReadable } from "./db-view-ZsoN91-q.mjs";
+import { h as DbError } from "./nested-writer-CNDyhg2L.mjs";
+import { _ as NoopLogger, a as getKeyProps, c as IntegrityStrategy, d as resolveDesignType, f as RelationalFieldMapper, g as TableMetadata, h as UniquSelect, i as createDbValidatorPlugin, l as NativeIntegrity, m as FieldMappingStrategy, n as AtscriptDbTable, o as ApplicationIntegrity, p as DocumentFieldMapper, r as decomposePatch, s as BaseDbAdapter, t as AtscriptDbView, u as AtscriptDbReadable } from "./db-view-DSK76uc9.mjs";
 import { getDbFieldOp, isDbFieldOp, separateFieldOps } from "./ops.mjs";
 import { computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 //#region src/table/db-space.ts

package/dist/{nested-writer-BDXsDMPP.cjs → nested-writer-BIQ6EfaR.cjs}

@@ -316,7 +316,7 @@ async function batchPatchNestedTo(host, items, maxDepth, depth) {
 			const patch = { ...nested };
 			let fkValue = fk.localFields.length === 1 ? item[fk.localFields[0]] : void 0;
 			if (fkValue === void 0) {
-				const pkFilter = host._extractPrimaryKeyFilter(item);
+				const pkFilter = host._extractRecordFilter(item);
 				const current = await host.findOne({
 					filter: pkFilter,
 					controls: {}

package/dist/{nested-writer-Dmm1gbZV.mjs → nested-writer-CNDyhg2L.mjs}

@@ -316,7 +316,7 @@ async function batchPatchNestedTo(host, items, maxDepth, depth) {
 			const patch = { ...nested };
 			let fkValue = fk.localFields.length === 1 ? item[fk.localFields[0]] : void 0;
 			if (fkValue === void 0) {
-				const pkFilter = host._extractPrimaryKeyFilter(item);
+				const pkFilter = host._extractRecordFilter(item);
 				const current = await host.findOne({
 					filter: pkFilter,
 					controls: {}

package/dist/rel.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_relation_loader = require("./relation-loader-CRC5LcqM.cjs");
-const require_nested_writer = require("./nested-writer-BDXsDMPP.cjs");
+const require_nested_writer = require("./nested-writer-BIQ6EfaR.cjs");
 const require_relation_helpers = require("./relation-helpers-BYvsE1tR.cjs");
 exports.batchInsertNestedFrom = require_nested_writer.batchInsertNestedFrom;
 exports.batchInsertNestedTo = require_nested_writer.batchInsertNestedTo;

package/dist/rel.d.cts

@@ -1,5 +1,5 @@
-import { A as TDbForeignKey, L as TDbRelation, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata } from "./db-readable-BQQzfguJ.cjs";
-import { t as DbValidationContext } from "./db-validator-plugin-07kDiis2.cjs";
+import { A as TDbForeignKey, L as TDbRelation, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata } from "./db-readable-C3C-qPcP.cjs";
+import { t as DbValidationContext } from "./db-validator-plugin-Cz4QoDWg.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";
 
@@ -55,7 +55,7 @@ interface TNestedWriterHost {
   _findRemoteFK(targetTable: {
     foreignKeys: ReadonlyMap<string, TDbForeignKey>;
   }, thisTableName: string, alias?: string): TDbForeignKey | undefined;
-  _extractPrimaryKeyFilter(payload: Record<string, unknown>): FilterExpr;
+  _extractRecordFilter(payload: Record<string, unknown>): FilterExpr;
   findOne(query: {
     filter: FilterExpr;
     controls: Record<string, never>;

package/dist/rel.d.mts

@@ -1,5 +1,5 @@
-import { A as TDbForeignKey, L as TDbRelation, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata } from "./db-readable-Bbr4CjMb.mjs";
-import { t as DbValidationContext } from "./db-validator-plugin-CiqsHTI_.mjs";
+import { A as TDbForeignKey, L as TDbRelation, Y as TTableResolver, Z as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata } from "./db-readable-Cc868K54.mjs";
+import { t as DbValidationContext } from "./db-validator-plugin-BLMVdi9z.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 
@@ -55,7 +55,7 @@ interface TNestedWriterHost {
   _findRemoteFK(targetTable: {
     foreignKeys: ReadonlyMap<string, TDbForeignKey>;
   }, thisTableName: string, alias?: string): TDbForeignKey | undefined;
-  _extractPrimaryKeyFilter(payload: Record<string, unknown>): FilterExpr;
+  _extractRecordFilter(payload: Record<string, unknown>): FilterExpr;
   findOne(query: {
     filter: FilterExpr;
     controls: Record<string, never>;

package/dist/rel.mjs

@@ -1,4 +1,4 @@
 import { t as loadRelationsImpl } from "./relation-loader-BEOTXNcq.mjs";
-import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, i as batchPatchNestedFrom, l as batchReplaceNestedVia, n as batchInsertNestedTo, o as batchPatchNestedVia, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-Dmm1gbZV.mjs";
+import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, i as batchPatchNestedFrom, l as batchReplaceNestedVia, n as batchInsertNestedTo, o as batchPatchNestedVia, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-CNDyhg2L.mjs";
 import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-CLasawQq.mjs";
 export { batchInsertNestedFrom, batchInsertNestedTo, batchInsertNestedVia, batchPatchNestedFrom, batchPatchNestedTo, batchPatchNestedVia, batchReplaceNestedFrom, batchReplaceNestedTo, batchReplaceNestedVia, checkDepthOverflow, findFKForRelation, findRemoteFK, loadRelationsImpl, preValidateNestedFrom, resolveRelationTargetTable, validateBatch };

package/dist/sync.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./nested-writer-BDXsDMPP.cjs");
-const require_db_view = require("./db-view-BntnAmXO.cjs");
+require("./nested-writer-BIQ6EfaR.cjs");
+const require_db_view = require("./db-view-CcUjETIF.cjs");
 //#region src/schema/schema-hash.ts
 /** Extracts sorted field snapshots from a readable's field descriptors. */
 function extractFieldSnapshots(fields, typeMapper) {

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { A as TDbForeignKey, B as TExistingColumn, D as TDbDefaultValue, J as TTableOptionDiff, R as TDbStorageType, V as TExistingTableOption, k as TDbFieldMeta, l as TGenericLogger, t as AtscriptDbReadable, w as TColumnDiff } from "./db-readable-BQQzfguJ.cjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-Vxpcnyt5.cjs";
+import { A as TDbForeignKey, B as TExistingColumn, D as TDbDefaultValue, J as TTableOptionDiff, R as TDbStorageType, V as TExistingTableOption, k as TDbFieldMeta, l as TGenericLogger, t as AtscriptDbReadable, w as TColumnDiff } from "./db-readable-C3C-qPcP.cjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-Dgf-CphX.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { A as TDbForeignKey, B as TExistingColumn, D as TDbDefaultValue, J as TTableOptionDiff, R as TDbStorageType, V as TExistingTableOption, k as TDbFieldMeta, l as TGenericLogger, t as AtscriptDbReadable, w as TColumnDiff } from "./db-readable-Bbr4CjMb.mjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-BUrQ5BFm.mjs";
+import { A as TDbForeignKey, B as TExistingColumn, D as TDbDefaultValue, J as TTableOptionDiff, R as TDbStorageType, V as TExistingTableOption, k as TDbFieldMeta, l as TGenericLogger, t as AtscriptDbReadable, w as TColumnDiff } from "./db-readable-Cc868K54.mjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-crCFv3DF.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.mjs

@@ -1,4 +1,4 @@
-import { _ as NoopLogger } from "./db-view-ZsoN91-q.mjs";
+import { _ as NoopLogger } from "./db-view-DSK76uc9.mjs";
 //#region src/schema/schema-hash.ts
 /** Extracts sorted field snapshots from a readable's field descriptors. */
 function extractFieldSnapshots(fields, typeMapper) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",
@@ -62,14 +62,14 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.39",
-    "@atscript/typescript": "^0.1.39",
+    "@atscript/core": "^0.1.41",
+    "@atscript/typescript": "^0.1.41",
     "@uniqu/core": "^0.1.2",
-    "unplugin-atscript": "^0.1.39"
+    "unplugin-atscript": "^0.1.41"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.39",
-    "@atscript/typescript": "^0.1.39",
+    "@atscript/core": "^0.1.41",
+    "@atscript/typescript": "^0.1.41",
     "@uniqu/core": "^0.1.2"
   },
   "scripts": {