@atscript/db 0.1.83 → 0.1.85

package/dist/{db-view-Bf5P3_7k.cjs → db-view-da5OTSRH.cjs}

@@ -1,9 +1,9 @@
-const require_db_error = require("./db-error-D8tQhNgM.cjs");
+const require_db_error = require("./db-error-CrtPzaZ-.cjs");
 const require_agg = require("./agg.cjs");
 const require_relation_helpers = require("./relation-helpers-BYvsE1tR.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-BIuw_T0k.cjs");
-const require_nested_writer = require("./nested-writer-v_LPR1yJ.cjs");
+const require_validator = require("./validator-DrmUaZA3.cjs");
+const require_nested_writer = require("./nested-writer-Chl_zySG.cjs");
 let _atscript_typescript_utils = require("@atscript/typescript/utils");
 let node_async_hooks = require("node:async_hooks");
 //#region src/logger.ts
@@ -64,6 +64,8 @@ var TableMetadata = class {
 	columnMap = /* @__PURE__ */ new Map();
 	dimensions = [];
 	measures = [];
+	/** Logical field name annotated with `@db.column.version`, if any. */
+	versionField;
 	/** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
 	quantityRefByField = /* @__PURE__ */ new Map();
 	pathToPhysical = /* @__PURE__ */ new Map();
@@ -258,6 +260,14 @@ var TableMetadata = class {
 			if (!hasExplicitIndex) this._addIndexField("plain", fieldName, fieldName);
 		}
 		if (metadata.has("db.column.measure")) this.measures.push(fieldName);
+		if (metadata.has("db.column.version")) if (this.versionField !== void 0) logger.warn(`@db.column.version declared on multiple fields ("${this.versionField}" and "${fieldName}") — only one is allowed; using "${this.versionField}"`);
+		else {
+			this.versionField = fieldName;
+			if (!this.defaults.has(fieldName)) this.defaults.set(fieldName, {
+				kind: "value",
+				value: "0"
+			});
+		}
 	}
 	_addIndexField(type, name, field, opts) {
 		const key = indexKey(type, name);
@@ -1249,6 +1259,17 @@ var AtscriptDbReadable = class {
 		}
 		return this._metaIdPhysical;
 	}
+	/**
+	* Physical column name of the field annotated with `@db.column.version`, or
+	* `undefined` when the table has no version column. Used by adapters and the
+	* REST integration to drive optimistic concurrency control (OCC).
+	*/
+	get versionColumn() {
+		this._ensureBuilt();
+		const field = this._meta.versionField;
+		if (field === void 0) return void 0;
+		return this._meta.columnMap.get(field) ?? field;
+	}
 	/** Dimension fields from `@db.column.dimension`. */
 	get dimensions() {
 		this._ensureBuilt();
@@ -1940,7 +1961,7 @@ var BaseDbAdapter = class {
 	* @param patch - The patch payload with array operations.
 	* @returns Update result.
 	*/
-	async nativePatch(_filter, _patch, _ops) {
+	async nativePatch(_filter, _patch, _ops, _expectedVersion) {
 		throw new Error("Native patch not supported by this adapter");
 	}
 	/**
@@ -2473,6 +2494,37 @@ function decomposeArrayPatch(key, value, fieldType, update, _table) {
 	if (value.$remove !== void 0) update[`${key}.__$remove`] = value.$remove;
 	if (keyProps.size > 0 && (value.$upsert !== void 0 || value.$update !== void 0 || value.$remove !== void 0)) update[`${key}.__$keys`] = [...keyProps];
 }
+/**
+* Throws if the payload attempts to write the version column directly.
+*
+* The version column is server-managed: the adapter auto-increments it
+* on every update. Direct writes (plain SET, `$inc`, `$mul`) would
+* either silently no-op (overwritten by the auto-bump) or corrupt the
+* OCC invariant. Reject them at the patch layer so the failure is
+* loud and adapter-agnostic.
+*
+* Inspects the payload AFTER `separateCas` has stripped `$cas` (so
+* that the legitimate `$cas` → expectedVersion path is not flagged).
+*
+* The check is intentionally narrow: only the physical column name at
+* the top level of the (already-decomposed) payload. Nested objects
+* cannot reach the version column through dot-paths because the
+* decomposer flattens those into top-level dot-keys; the version
+* column, being a scalar at the root, cannot be nested.
+*
+* Zero-allocation when the version column is not present.
+*
+* @throws {DbError} with code `VERSION_COLUMN_WRITE` when the version
+*   column appears as a top-level key in `data` or as the target of a
+*   `$inc`/`$mul` field op.
+*/
+function assertNoVersionWrites(data, versionColumn) {
+	if (!(versionColumn in data)) return;
+	throw new require_db_error.DbError("VERSION_COLUMN_WRITE", [{
+		path: versionColumn,
+		message: `Cannot write to version column "${versionColumn}" directly; omit it from the payload or use $cas for conflict detection`
+	}]);
+}
 //#endregion
 //#region src/table/db-table.ts
 /**
@@ -2619,7 +2671,13 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		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 }));
+			const versionColumn = this.versionColumn;
+			const expectedVersions = Array.from({ length: payloads.length });
+			const items = payloads.map((p, i) => {
+				const clone = { ...p };
+				expectedVersions[i] = require_ops.separateCas(clone, versionColumn);
+				return this._applyDefaults(clone);
+			});
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
 			const validator = this.getValidator("bulkReplace");
 			const ctx = {
@@ -2634,11 +2692,13 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			if (canNest) await require_nested_writer.preValidateNestedFrom(host, originals);
 			let matchedCount = 0;
 			let modifiedCount = 0;
-			for (const data of items) {
+			for (let i = 0; i < items.length; i++) {
+				const data = items[i];
 				for (const navField of this._meta.navFields) delete data[navField];
+				if (versionColumn !== void 0) assertNoVersionWrites(data, versionColumn);
 				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);
+				const result = await this.adapter.replaceOne(this._fieldMapper.translateFilter(filter, this._meta), prepared, expectedVersions[i]);
 				matchedCount += result.matchedCount;
 				modifiedCount += result.modifiedCount;
 			}
@@ -2671,6 +2731,13 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		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 versionColumn = this.versionColumn;
+			const expectedVersions = Array.from({ length: payloads.length });
+			const cloned = payloads.map((p, i) => {
+				const c = { ...p };
+				expectedVersions[i] = require_ops.separateCas(c, versionColumn);
+				return c;
+			});
 			const validator = this.getValidator("bulkUpdate");
 			const ctx = {
 				mode: "patch",
@@ -2678,18 +2745,21 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 				navFields: this._meta.navFields
 			};
 			this._applyDepthCtx(ctx, depth);
-			require_nested_writer.validateBatch(validator, payloads, ctx);
-			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
+			require_nested_writer.validateBatch(validator, cloned, ctx);
+			const originals = canNest ? cloned.map((p) => ({ ...p })) : [];
 			const host = this;
-			if (canNest) await require_nested_writer.batchPatchNestedTo(host, payloads, maxDepth, depth);
-			await this._integrity.validateForeignKeys(payloads, this._meta, this._fkLookupResolver, this._writeTableResolver, true);
+			if (canNest) await require_nested_writer.batchPatchNestedTo(host, cloned, maxDepth, depth);
+			await this._integrity.validateForeignKeys(cloned, this._meta, this._fkLookupResolver, this._writeTableResolver, true);
 			let matchedCount = 0;
 			let modifiedCount = 0;
-			for (const payload of payloads) {
+			for (let i = 0; i < cloned.length; i++) {
+				const payload = cloned[i];
+				const expectedVersion = expectedVersions[i];
 				const data = { ...payload };
 				for (const navField of this._meta.navFields) delete data[navField];
 				const filter = this._extractRecordFilter(data);
 				for (const key of Object.keys(filter)) delete data[key];
+				if (versionColumn !== void 0) assertNoVersionWrites(data, versionColumn);
 				if (_isEmptyObj(data)) {
 					matchedCount += 1;
 					modifiedCount += 0;
@@ -2701,7 +2771,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 					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);
+					result = await this.adapter.nativePatch(translatedFilter, translatedData, translatedOps, expectedVersion);
 				} else {
 					const update = decomposePatch(data, this);
 					const ops = require_ops.separateFieldOps(update);
@@ -2712,8 +2782,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 							filter: translatedFilter,
 							controls: {}
 						}), this);
-						result = await this.adapter.updateOne(translatedFilter, resolved, translatedOps);
-					} else result = await this.adapter.updateOne(translatedFilter, translatedUpdate, translatedOps);
+						result = await this.adapter.updateOne(translatedFilter, resolved, translatedOps, expectedVersion);
+					} else result = await this.adapter.updateOne(translatedFilter, translatedUpdate, translatedOps, expectedVersion);
 				}
 				matchedCount += result.matchedCount;
 				modifiedCount += result.modifiedCount;
@@ -2746,7 +2816,14 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	async updateMany(filter, data) {
 		this._ensureBuilt();
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver, true);
-		const update = decomposePatch({ ...data }, this);
+		const dataCopy = { ...data };
+		const versionColumn = this.versionColumn;
+		if ("$cas" in dataCopy) throw new require_db_error.DbError("INVALID_QUERY", [{
+			path: "$cas",
+			message: "$cas is not supported on updateMany — use bulkUpdate with per-row $cas for version-locked batch updates"
+		}]);
+		if (versionColumn !== void 0) assertNoVersionWrites(dataCopy, versionColumn);
+		const update = decomposePatch(dataCopy, this);
 		const ops = require_ops.separateFieldOps(update);
 		const translatedOps = ops ? _translateOpsKeys(ops, this._meta) : void 0;
 		const translatedUpdate = this._fieldMapper.translatePatchKeys(update, this._meta);
@@ -2787,17 +2864,21 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	_applyDefaults(data) {
 		const nativeValues = this.adapter.supportsNativeValueDefaults();
 		const nativeFns = this.adapter.nativeDefaultFns();
-		for (const [field, def] of this._meta.defaults.entries()) if (data[field] === void 0) {
-			if (def.kind === "value" && !nativeValues) {
-				const fieldType = this._meta.flatMap?.get(field);
-				data[field] = (fieldType?.type.kind === "" && fieldType.type.designType) === "string" ? def.value : JSON.parse(def.value);
-			} else if (def.kind === "fn" && !nativeFns.has(def.fn)) switch (def.fn) {
-				case "now":
-					data[field] = Date.now();
-					break;
-				case "uuid":
-					data[field] = crypto.randomUUID();
-					break;
+		const versionField = this._meta.versionField;
+		for (const [field, def] of this._meta.defaults.entries()) {
+			if (field === versionField) continue;
+			if (data[field] === void 0) {
+				if (def.kind === "value" && !nativeValues) {
+					const fieldType = this._meta.flatMap?.get(field);
+					data[field] = (fieldType?.type.kind === "" && fieldType.type.designType) === "string" ? def.value : JSON.parse(def.value);
+				} else if (def.kind === "fn" && !nativeFns.has(def.fn)) switch (def.fn) {
+					case "now":
+						data[field] = Date.now();
+						break;
+					case "uuid":
+						data[field] = crypto.randomUUID();
+						break;
+				}
 			}
 		}
 		return data;
@@ -2922,6 +3003,22 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const adapterPlugins = this.adapter.getValidatorPlugins();
 		if (purpose === "insert" || purpose === "patch" || purpose === "bulkReplace") {
 			const mode = purpose === "bulkReplace" ? "replace" : purpose;
+			const versionField = this._meta.versionField;
+			if (versionField !== void 0) {
+				const plugins = adapterPlugins.length ? [...adapterPlugins, require_validator.dbPlugin] : [require_validator.dbPlugin];
+				return this.createValidator({
+					plugins,
+					partial: mode === "patch",
+					replace: (def, path) => {
+						const transformed = require_validator.forceNavNonOptional(def);
+						if (path === versionField && !transformed.optional) return {
+							...transformed,
+							optional: true
+						};
+						return transformed;
+					}
+				});
+			}
 			return require_validator.buildDbValidator(this.type, mode, adapterPlugins);
 		}
 		if (purpose === "bulkUpdate") {
@@ -3156,6 +3253,12 @@ Object.defineProperty(exports, "UniquSelect", {
 		return UniquSelect;
 	}
 });
+Object.defineProperty(exports, "assertNoVersionWrites", {
+	enumerable: true,
+	get: function() {
+		return assertNoVersionWrites;
+	}
+});
 Object.defineProperty(exports, "decomposePatch", {
 	enumerable: true,
 	get: function() {

package/dist/index.cjs

@@ -1,9 +1,58 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_db_error = require("./db-error-D8tQhNgM.cjs");
-const require_db_view = require("./db-view-Bf5P3_7k.cjs");
+const require_db_error = require("./db-error-CrtPzaZ-.cjs");
+const require_db_view = require("./db-view-da5OTSRH.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-BIuw_T0k.cjs");
+const require_validator = require("./validator-DrmUaZA3.cjs");
 let _uniqu_core = require("@uniqu/core");
+//#region src/with-optimistic-retry.ts
+/**
+* Runs a read-modify-write loop under optimistic concurrency control (OCC).
+*
+* Reads the row via `findOne({ filter })`, hands it to `mutator`, then applies
+* the returned patch with `$cas: { [versionColumn]: row[versionColumn] }`. On
+* a version conflict (`matchedCount === 0`) it re-reads the row, calls the
+* mutator with the fresh state, and retries — up to `maxAttempts` times.
+*
+* The filter (typically the primary key) is threaded into the update payload
+* so the table layer can extract the row identity. If `mutator` returns
+* fields that overlap with the filter, the patch wins (last-write semantics
+* inside a single object spread).
+*
+* @throws {DbError} with code `INVALID_QUERY` if `table` has no
+*   `@db.column.version` column — the helper would have no version to thread
+*   into `$cas` and would silently degrade to last-write-wins.
+* @throws {DbError} with code `NOT_FOUND` if the initial `findOne` returns
+*   `null`. The mutator is not invoked with a fabricated row.
+* @throws {CasExhaustedError} if `maxAttempts` is reached without a
+*   successful commit.
+*/
+async function withOptimisticRetry(table, filter, mutator, opts) {
+	const versionColumn = table.versionColumn;
+	if (versionColumn === void 0) throw new require_db_error.DbError("INVALID_QUERY", [{
+		path: "$cas",
+		message: `withOptimisticRetry: table "${table.tableName}" has no @db.column.version column — CAS cannot be applied`
+	}]);
+	const maxAttempts = opts?.maxAttempts ?? 5;
+	let lastSeenVersion;
+	for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+		const row = await table.findOne({ filter });
+		if (row === null) throw new require_db_error.DbError("NOT_FOUND", [{
+			path: "$cas",
+			message: `withOptimisticRetry: row not found in "${table.tableName}" for filter ${JSON.stringify(filter)}`
+		}]);
+		lastSeenVersion = row[versionColumn];
+		const patch = await mutator(row);
+		const result = await table.updateOne({
+			...filter,
+			...patch,
+			$cas: { [versionColumn]: lastSeenVersion }
+		});
+		if (result.matchedCount > 0) return result;
+		if (attempt < maxAttempts && opts?.delay !== void 0) await opts.delay(attempt);
+	}
+	throw new require_db_error.CasExhaustedError(maxAttempts, lastSeenVersion);
+}
+//#endregion
 //#region src/table/db-space.ts
 /**
 * A database space — a registry of tables and views sharing the same adapter type and driver.
@@ -139,6 +188,7 @@ function translateQueryTree(node, resolveField) {
 	return { [leftField]: { [comp.op]: comp.right } };
 }
 //#endregion
+exports.$cas = require_ops.$cas;
 exports.$dec = require_ops.$dec;
 exports.$inc = require_ops.$inc;
 exports.$insert = require_ops.$insert;
@@ -152,6 +202,7 @@ exports.AtscriptDbReadable = require_db_view.AtscriptDbReadable;
 exports.AtscriptDbTable = require_db_view.AtscriptDbTable;
 exports.AtscriptDbView = require_db_view.AtscriptDbView;
 exports.BaseDbAdapter = require_db_view.BaseDbAdapter;
+exports.CasExhaustedError = require_db_error.CasExhaustedError;
 exports.DbError = require_db_error.DbError;
 exports.DbSpace = DbSpace;
 exports.DocumentFieldMapper = require_db_view.DocumentFieldMapper;
@@ -162,6 +213,7 @@ exports.NoopLogger = require_db_view.NoopLogger;
 exports.RelationalFieldMapper = require_db_view.RelationalFieldMapper;
 exports.TableMetadata = require_db_view.TableMetadata;
 exports.UniquSelect = require_db_view.UniquSelect;
+exports.assertNoVersionWrites = require_db_view.assertNoVersionWrites;
 exports.buildDbValidator = require_validator.buildDbValidator;
 exports.buildValidationContext = require_validator.buildValidationContext;
 Object.defineProperty(exports, "computeInsights", {
@@ -184,6 +236,7 @@ Object.defineProperty(exports, "isPrimitive", {
 	}
 });
 exports.resolveDesignType = require_db_view.resolveDesignType;
+exports.separateCas = require_ops.separateCas;
 exports.separateFieldOps = require_ops.separateFieldOps;
 exports.translateQueryTree = translateQueryTree;
 Object.defineProperty(exports, "walkFilter", {
@@ -192,3 +245,4 @@ Object.defineProperty(exports, "walkFilter", {
 		return _uniqu_core.walkFilter;
 	}
 });
+exports.withOptimisticRetry = withOptimisticRetry;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-BSrIy08e.cjs";
-import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, 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-Dx8x-Ke1.cjs";
+import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-DgIxrEVQ.cjs";
+import { a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateFieldOps, h as separateCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, p as getDbFieldOp, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-lzmfzuY9.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-DiErv7Q1.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-_z_A3cKa.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
@@ -81,7 +81,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/db-error.d.ts
-type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{
@@ -94,6 +94,52 @@ declare class DbError extends Error {
     message: string;
   }>, message?: string);
 }
+/**
+ * Thrown by {@link withOptimisticRetry} when `maxAttempts` is reached
+ * without a successful CAS commit — the target row kept changing under
+ * the read-modify-write loop. Surfaces the attempt count and the
+ * last-observed version so callers can log/report the contention.
+ */
+declare class CasExhaustedError extends DbError {
+  readonly attempts: number;
+  readonly lastSeenVersion: number | undefined;
+  name: string;
+  constructor(attempts: number, lastSeenVersion: number | undefined);
+}
+//#endregion
+//#region src/with-optimistic-retry.d.ts
+interface WithOptimisticRetryOptions {
+  /** Maximum number of attempts before giving up. Defaults to `5`. */
+  maxAttempts?: number;
+  /**
+   * Optional hook invoked between failed attempts. Receives the 1-based
+   * attempt number that just failed. Useful for exponential backoff with
+   * jitter. Default behavior is to retry immediately.
+   */
+  delay?: (attempt: number) => Promise<void>;
+}
+/**
+ * Runs a read-modify-write loop under optimistic concurrency control (OCC).
+ *
+ * Reads the row via `findOne({ filter })`, hands it to `mutator`, then applies
+ * the returned patch with `$cas: { [versionColumn]: row[versionColumn] }`. On
+ * a version conflict (`matchedCount === 0`) it re-reads the row, calls the
+ * mutator with the fresh state, and retries — up to `maxAttempts` times.
+ *
+ * The filter (typically the primary key) is threaded into the update payload
+ * so the table layer can extract the row identity. If `mutator` returns
+ * fields that overlap with the filter, the patch wins (last-write semantics
+ * inside a single object spread).
+ *
+ * @throws {DbError} with code `INVALID_QUERY` if `table` has no
+ *   `@db.column.version` column — the helper would have no version to thread
+ *   into `$cas` and would silently degrade to last-write-wins.
+ * @throws {DbError} with code `NOT_FOUND` if the initial `findOne` returns
+ *   `null`. The mutator is not invoked with a fabricated row.
+ * @throws {CasExhaustedError} if `maxAttempts` is reached without a
+ *   successful commit.
+ */
+declare function withOptimisticRetry<TRow extends Record<string, unknown>>(table: AtscriptDbTable, filter: Record<string, unknown>, mutator: (row: TRow) => Promise<Record<string, unknown>> | Record<string, unknown>, opts?: WithOptimisticRetryOptions): Promise<TDbUpdateResult>;
 //#endregion
 //#region src/patch/patch-decomposer.d.ts
 /**
@@ -113,5 +159,30 @@ declare class DbError extends Error {
  * @returns A flat update object suitable for a basic `updateOne` call.
  */
 declare function decomposePatch(payload: Record<string, unknown>, table: AtscriptDbTable): Record<string, unknown>;
+/**
+ * Throws if the payload attempts to write the version column directly.
+ *
+ * The version column is server-managed: the adapter auto-increments it
+ * on every update. Direct writes (plain SET, `$inc`, `$mul`) would
+ * either silently no-op (overwritten by the auto-bump) or corrupt the
+ * OCC invariant. Reject them at the patch layer so the failure is
+ * loud and adapter-agnostic.
+ *
+ * Inspects the payload AFTER `separateCas` has stripped `$cas` (so
+ * that the legitimate `$cas` → expectedVersion path is not flagged).
+ *
+ * The check is intentionally narrow: only the physical column name at
+ * the top level of the (already-decomposed) payload. Nested objects
+ * cannot reach the version column through dot-paths because the
+ * decomposer flattens those into top-level dot-keys; the version
+ * column, being a scalar at the root, cannot be nested.
+ *
+ * Zero-allocation when the version column is not present.
+ *
+ * @throws {DbError} with code `VERSION_COLUMN_WRITE` when the version
+ *   column appears as a top-level key in `data` or as the target of a
+ *   `$inc`/`$mul` field op.
+ */
+declare function assertNoVersionWrites(data: Record<string, unknown>, versionColumn: string): void;
 //#endregion
-export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, CasExhaustedError, type DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithOptimisticRetryOptions, type WithRelation, assertNoVersionWrites, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateCas, separateFieldOps, translateQueryTree, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-B2TRNZHv.mjs";
-import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-C61kelof.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-SUFqMvKz.mjs";
+import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-BUUVDkLf.mjs";
+import { a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateFieldOps, h as separateCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, p as getDbFieldOp, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-Blqr0ipy.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-CZooARt_.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-DttN2e5_.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
@@ -81,7 +81,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/db-error.d.ts
-type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{
@@ -94,6 +94,52 @@ declare class DbError extends Error {
     message: string;
   }>, message?: string);
 }
+/**
+ * Thrown by {@link withOptimisticRetry} when `maxAttempts` is reached
+ * without a successful CAS commit — the target row kept changing under
+ * the read-modify-write loop. Surfaces the attempt count and the
+ * last-observed version so callers can log/report the contention.
+ */
+declare class CasExhaustedError extends DbError {
+  readonly attempts: number;
+  readonly lastSeenVersion: number | undefined;
+  name: string;
+  constructor(attempts: number, lastSeenVersion: number | undefined);
+}
+//#endregion
+//#region src/with-optimistic-retry.d.ts
+interface WithOptimisticRetryOptions {
+  /** Maximum number of attempts before giving up. Defaults to `5`. */
+  maxAttempts?: number;
+  /**
+   * Optional hook invoked between failed attempts. Receives the 1-based
+   * attempt number that just failed. Useful for exponential backoff with
+   * jitter. Default behavior is to retry immediately.
+   */
+  delay?: (attempt: number) => Promise<void>;
+}
+/**
+ * Runs a read-modify-write loop under optimistic concurrency control (OCC).
+ *
+ * Reads the row via `findOne({ filter })`, hands it to `mutator`, then applies
+ * the returned patch with `$cas: { [versionColumn]: row[versionColumn] }`. On
+ * a version conflict (`matchedCount === 0`) it re-reads the row, calls the
+ * mutator with the fresh state, and retries — up to `maxAttempts` times.
+ *
+ * The filter (typically the primary key) is threaded into the update payload
+ * so the table layer can extract the row identity. If `mutator` returns
+ * fields that overlap with the filter, the patch wins (last-write semantics
+ * inside a single object spread).
+ *
+ * @throws {DbError} with code `INVALID_QUERY` if `table` has no
+ *   `@db.column.version` column — the helper would have no version to thread
+ *   into `$cas` and would silently degrade to last-write-wins.
+ * @throws {DbError} with code `NOT_FOUND` if the initial `findOne` returns
+ *   `null`. The mutator is not invoked with a fabricated row.
+ * @throws {CasExhaustedError} if `maxAttempts` is reached without a
+ *   successful commit.
+ */
+declare function withOptimisticRetry<TRow extends Record<string, unknown>>(table: AtscriptDbTable, filter: Record<string, unknown>, mutator: (row: TRow) => Promise<Record<string, unknown>> | Record<string, unknown>, opts?: WithOptimisticRetryOptions): Promise<TDbUpdateResult>;
 //#endregion
 //#region src/patch/patch-decomposer.d.ts
 /**
@@ -113,5 +159,30 @@ declare class DbError extends Error {
  * @returns A flat update object suitable for a basic `updateOne` call.
  */
 declare function decomposePatch(payload: Record<string, unknown>, table: AtscriptDbTable): Record<string, unknown>;
+/**
+ * Throws if the payload attempts to write the version column directly.
+ *
+ * The version column is server-managed: the adapter auto-increments it
+ * on every update. Direct writes (plain SET, `$inc`, `$mul`) would
+ * either silently no-op (overwritten by the auto-bump) or corrupt the
+ * OCC invariant. Reject them at the patch layer so the failure is
+ * loud and adapter-agnostic.
+ *
+ * Inspects the payload AFTER `separateCas` has stripped `$cas` (so
+ * that the legitimate `$cas` → expectedVersion path is not flagged).
+ *
+ * The check is intentionally narrow: only the physical column name at
+ * the top level of the (already-decomposed) payload. Nested objects
+ * cannot reach the version column through dot-paths because the
+ * decomposer flattens those into top-level dot-keys; the version
+ * column, being a scalar at the root, cannot be nested.
+ *
+ * Zero-allocation when the version column is not present.
+ *
+ * @throws {DbError} with code `VERSION_COLUMN_WRITE` when the version
+ *   column appears as a top-level key in `data` or as the target of a
+ *   `$inc`/`$mul` field op.
+ */
+declare function assertNoVersionWrites(data: Record<string, unknown>, versionColumn: string): void;
 //#endregion
-export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, CasExhaustedError, type DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithOptimisticRetryOptions, type WithRelation, assertNoVersionWrites, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateCas, separateFieldOps, translateQueryTree, walkFilter, withOptimisticRetry };