@atscript/db 0.1.155 → 0.1.157

package/dist/{column-diff-DMkGYAGM.cjs → column-diff-DpeUbhEI.cjs}

@@ -1,8 +1,8 @@
 const require_db_error = require("./db-error-JcfJqqpk.cjs");
 const require_aggregate_fns = require("./aggregate-fns-DFtKAv7Q.cjs");
 const require_nested_writer = require("./nested-writer-Bl1SZS7x.cjs");
-const require_validator = require("./validator-DHwSyBej.cjs");
-const require_search_fields = require("./search-fields-DwrsJUC1.cjs");
+const require_validator = require("./validator-B4YDLUkj.cjs");
+const require_search_fields = require("./search-fields-CT_UZ9fg.cjs");
 const require_object = require("./object-Djg28csK.cjs");
 require("./agg.cjs");
 const require_aggregate_rules = require("./aggregate-rules-D_bsCpUI.cjs");
@@ -503,6 +503,12 @@ var TableMetadata = class {
 	/** Adapter-contributed multi-field unique keys (logical paths) — see `TMetadataOverrides.addUniqueKeys`. */
 	uniqueKeys = [];
 	defaults = /* @__PURE__ */ new Map();
+	/**
+	* Logical paths annotated with `@db.onUpdate.now` (`number.timestamp.updated`
+	* applies it): set to the current time by every update and replace.
+	* @since 0.1.156
+	*/
+	onUpdateNow = /* @__PURE__ */ new Set();
 	/** Logical path → `@db.column` override (top-level keys only on document storage). */
 	columnMap = /* @__PURE__ */ new Map();
 	dimensions = [];
@@ -827,6 +833,7 @@ var TableMetadata = class {
 		if (columnFrom && renamable) this._columnFromMap.set(fieldName, columnFrom);
 		const resolvedDefault = resolveDefaultFromMetadata(metadata);
 		if (resolvedDefault) this.defaults.set(fieldName, resolvedDefault);
+		if (metadata.has("db.onUpdate.now")) this.onUpdateNow.add(fieldName);
 		if (metadata.has("db.ignore")) this.ignoredFields.add(fieldName);
 		if (isNavRelation(metadata)) {
 			this.navFields.add(fieldName);
@@ -996,6 +1003,7 @@ var TableMetadata = class {
 		if (metadata.has("db.search.vector") || metadata.has("db.search.filter")) reject("@db.search.*", "search over ciphertext is impossible");
 		if (metadata.has("db.mongo.search.text") || metadata.has("db.mongo.search.autocomplete")) reject("@db.mongo.search.*", "Atlas Search over ciphertext is impossible");
 		if (metadata.has("db.column.version")) reject("@db.column.version", "the OCC filter needs cleartext equality");
+		if (metadata.has("db.onUpdate.now")) reject("@db.onUpdate.now", "the update time is set after the encryption transform");
 		if (metadata.has("db.default.increment") || metadata.has("db.default.now")) reject("@db.default.increment / @db.default.now", "engine-side defaults bypass the encryption transform");
 		if (metadata.get("db.patch.strategy") === "merge") reject("@db.patch.strategy \"merge\"", "ciphertext is opaque — partial merges would silently drop omitted keys");
 	}
@@ -6809,10 +6817,11 @@ function assertNoVersionWrites(data, versionColumn) {
 * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
 * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
 * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
-* (keep the two side by side): PK keys are skipped; an exempt path (or one
-* under an exempt ancestor) is covered whatever its value (scalar, field op,
-* array ops, object); a non-exempt merge-strategy object recurses (only the
-* supplied children are written); anything else is a non-exempt write.
+* (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+* skipped; an exempt path (or one under an exempt ancestor) is covered
+* whatever its value (scalar, field op, array ops, object); a non-exempt
+* merge-strategy object recurses (only the supplied children are written);
+* anything else is a non-exempt write.
 * True iff at least one key is covered and none is not.
 * @since 0.1.150
 */
@@ -6821,11 +6830,12 @@ function isVersionExemptPatch(data, table) {
 	if (meta.versionExemptPaths.size === 0) return false;
 	const primaryKeys = meta.primaryKeys;
 	const flatMap = meta.flatMap;
+	const stamps = meta.onUpdateNow;
 	const walk = (obj, prefix) => {
 		let result = "none";
 		for (const [k, value] of Object.entries(obj)) {
 			const key = prefix ? `${prefix}.${k}` : k;
-			if (primaryKeys.includes(key)) continue;
+			if (primaryKeys.includes(key) || stamps.has(key)) continue;
 			if (meta.isVersionExemptPath(key)) {
 				result = "exempt";
 				continue;
@@ -7138,7 +7148,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const singleStatement = !ignore && this._isSingleStatementWrite(payloads, depth, guard, check);
 		return require_nested_writer.enrichFkViolation(this._meta, () => this._inWriteTransaction(singleStatement, async () => {
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
-			let items = payloads.map((p) => this._applyDefaults(clone(p)));
+			const now = Date.now();
+			let items = payloads.map((p) => this._applyDefaults(clone(p), now));
 			if (ignore) this._linkToByKeyInIgnoreMode(items);
 			let originals = canNest ? items.map((item) => ({ ...item })) : [];
 			const validator = this.getValidator("insert");
@@ -7214,10 +7225,12 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			const versionColumn = this.versionColumn;
 			const expectedVersions = Array.from({ length: payloads.length });
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
+			const now = Date.now();
 			const items = payloads.map((p, i) => {
 				const c = clone(p);
 				expectedVersions[i] = require_ops.separateCas(c, versionColumn);
-				return this._applyDefaults(c);
+				this._stampOnUpdate(c, now, true);
+				return this._applyDefaults(c, now);
 			});
 			const originals = canNest ? items.map((item) => ({ ...item })) : [];
 			const validator = this.getValidator("bulkReplace");
@@ -7301,9 +7314,11 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			const versionColumn = this.versionColumn;
 			const expectedVersions = Array.from({ length: payloads.length });
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
+			const now = Date.now();
 			const cloned = payloads.map((p, i) => {
 				const c = clone(p);
 				expectedVersions[i] = require_ops.separateCas(c, versionColumn);
+				this._stampOnUpdate(c, now, false);
 				return c;
 			});
 			const validator = this.getValidator("bulkUpdate");
@@ -7350,6 +7365,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 					continue;
 				}
 				const updateOpts = expectedVersion === void 0 && versionColumn !== void 0 && isVersionExemptPatch(data, this) ? [KEEP_VERSION] : [];
+				this._stampTopLevel(data, now);
 				let result;
 				if (this.adapter.supportsNativePatch()) {
 					const ops = require_ops.separateFieldOps(data);
@@ -7509,6 +7525,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver, true);
 		const dataCopy = _cloneWritePayload(data);
 		this._meta.stripDerived(dataCopy);
+		const now = Date.now();
+		this._stampOnUpdate(dataCopy, now, false);
 		const versionColumn = this.versionColumn;
 		if ("$cas" in dataCopy) throw new require_db_error.DbError("INVALID_QUERY", [{
 			path: "$cas",
@@ -7516,6 +7534,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		}]);
 		if (versionColumn !== void 0) assertNoVersionWrites(dataCopy, versionColumn);
 		const updateOpts = versionColumn !== void 0 && isVersionExemptPatch(dataCopy, this) ? [KEEP_VERSION] : [];
+		this._stampTopLevel(dataCopy, now);
 		await this._encryptItems([dataCopy], "patch");
 		const update = decomposePatch(dataCopy, this);
 		const ops = require_ops.separateFieldOps(update);
@@ -7536,6 +7555,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		this._guardMutationFilter(filter);
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver);
 		const dataCopy = _cloneWritePayload(data);
+		this._stampOnUpdate(dataCopy, Date.now(), true);
 		await this._encryptItems([dataCopy], "write");
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.replaceMany(this._fieldMapper.translateFilter(filter, this._meta), this._fieldMapper.prepareForWrite(dataCopy, this._meta, this.adapter)));
 	}
@@ -7910,8 +7930,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	* that object is present (an absent or `null` embedded object stays so), and
 	* in every object of an array on the way; a field inside a JSON value or an
 	* array has no column default, so the SDK fills its function default too.
+	* Every `now` default the SDK fills gets the one time `now` (one per write
+	* call, so `createdAt` / `updatedAt` of a new row are equal).
 	*/
-	_applyDefaults(data) {
+	_applyDefaults(data, now = Date.now()) {
 		const nativeFns = this.adapter.nativeDefaultFns();
 		const versionField = this._meta.versionField;
 		for (const [field, def] of this._meta.defaults.entries()) {
@@ -7919,7 +7941,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			let make;
 			if (def.kind === "value") make = () => this._valueDefault(field, def.value);
 			else if (def.kind === "fn" && (!nativeFns.has(def.fn) || require_object.findAncestorInSet(field, this._meta.jsonParents) !== void 0)) {
-				if (def.fn === "now") make = Date.now;
+				if (def.fn === "now") make = () => now;
 				else if (def.fn === "uuid") make = () => crypto.randomUUID();
 			}
 			if (!make) continue;
@@ -7929,6 +7951,26 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		}
 		return data;
 	}
+	/**
+	* `@db.onUpdate.now` (since 0.1.156): sets each such field of a replace /
+	* patch payload to `now`, overriding the caller's value. A nested field
+	* (`audit.updatedAt`) is set inside its object only when the payload
+	* carries that object — in every item of an array on the way and of the
+	* items an array patch operator adds or updates — like
+	* {@link _applyDefaults}. `topLevel: false` (a patch) instead drops the
+	* caller's values of the table's own columns: {@link _stampTopLevel} sets
+	* them once the patch is known to write something.
+	*/
+	_stampOnUpdate(data, now, topLevel) {
+		for (const field of this._meta.onUpdateNow) if (!field.includes(".")) if (topLevel) data[field] = now;
+		else delete data[field];
+		else if (this._nestedDefaultFillable(field)) stampNested(data, field.split("."), 0, now);
+	}
+	/** Sets the top-level `@db.onUpdate.now` columns of a non-empty patch to `now`. */
+	_stampTopLevel(data, now) {
+		if (require_object.isEmptyObject(data)) return;
+		for (const field of this._meta.onUpdateNow) if (!field.includes(".")) data[field] = now;
+	}
 	/** {@link _nestedDefaultFillable} per nested default path. */
 	_fillableDefaults;
 	/**
@@ -8122,6 +8164,27 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	}
 };
 /**
+* Sets `segs` below `value` to `now` (see `_stampOnUpdate`), through
+* arrays and the item lists of array patch operators (`$insert`, `$upsert`,
+* `$replace`, `$update` — not `$remove`).
+*/
+function stampNested(value, segs, i, now) {
+	if (Array.isArray(value)) {
+		for (const item of value) stampNested(item, segs, i, now);
+		return;
+	}
+	if (!require_object.isPlainObject(value)) return;
+	const key = segs[i];
+	if (i === segs.length - 1) {
+		value[key] = now;
+		return;
+	}
+	const next = value[key];
+	if (require_object.isPlainObject(next) && Object.keys(next).some((k) => k.startsWith("$"))) {
+		for (const [op, items] of Object.entries(next)) if (op !== "$remove") stampNested(items, segs, i + 1, now);
+	} else stampNested(next, segs, i + 1, now);
+}
+/**
 * Sets `segs[i..]` to `make()` where it is `undefined`, inside present plain
 * objects only — fanned out over the objects of every array on the way.
 */

package/dist/{fk-diff-BYLNWoF9.d.mts → fk-diff-5gX42hBt.d.mts}

@@ -1,4 +1,4 @@
-import { A as TColumnDiff, B as TDbDefaultFn, Tn as AtscriptDbReadable, U as TDbFieldMeta, V as TDbDefaultValue, W as TDbForeignKey, _t as TExistingColumn, at as TDbStorageType, ht as TDerivedColumn, in as AtscriptDbView, mn as AtscriptQueryNode, pn as AtscriptQueryFieldRef, yt as TExistingTableOption, z as TDbCollation } from "./buckets-goCoky8v.mjs";
+import { A as TColumnDiff, B as TDbDefaultFn, En as AtscriptDbReadable, U as TDbFieldMeta, V as TDbDefaultValue, W as TDbForeignKey, _t as TExistingColumn, an as AtscriptDbView, at as TDbStorageType, hn as AtscriptQueryNode, ht as TDerivedColumn, mn as AtscriptQueryFieldRef, yt as TExistingTableOption, z as TDbCollation } from "./buckets-8mG67Mtw.mjs";
 
 //#region src/schema/schema-hash.d.ts
 interface TFieldSnapshot {

package/dist/{fk-diff-DblOPBLS.d.cts → fk-diff-BWdQ7kRZ.d.cts}

@@ -1,4 +1,4 @@
-import { A as TColumnDiff, B as TDbDefaultFn, Tn as AtscriptDbReadable, U as TDbFieldMeta, V as TDbDefaultValue, W as TDbForeignKey, _t as TExistingColumn, at as TDbStorageType, ht as TDerivedColumn, in as AtscriptDbView, mn as AtscriptQueryNode, pn as AtscriptQueryFieldRef, yt as TExistingTableOption, z as TDbCollation } from "./buckets-DcWm3SLt.cjs";
+import { A as TColumnDiff, B as TDbDefaultFn, En as AtscriptDbReadable, U as TDbFieldMeta, V as TDbDefaultValue, W as TDbForeignKey, _t as TExistingColumn, an as AtscriptDbView, at as TDbStorageType, hn as AtscriptQueryNode, ht as TDerivedColumn, mn as AtscriptQueryFieldRef, yt as TExistingTableOption, z as TDbCollation } from "./buckets-B4T_alUe.cjs";
 
 //#region src/schema/schema-hash.d.ts
 interface TFieldSnapshot {

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_db_error = require("./db-error-JcfJqqpk.cjs");
-const require_column_diff = require("./column-diff-DMkGYAGM.cjs");
+const require_column_diff = require("./column-diff-DpeUbhEI.cjs");
 const require_aggregate_fns = require("./aggregate-fns-DFtKAv7Q.cjs");
 const require_nested_writer = require("./nested-writer-Bl1SZS7x.cjs");
-const require_validator = require("./validator-DHwSyBej.cjs");
-const require_search_fields = require("./search-fields-DwrsJUC1.cjs");
+const require_validator = require("./validator-B4YDLUkj.cjs");
+const require_search_fields = require("./search-fields-CT_UZ9fg.cjs");
 const require_object = require("./object-Djg28csK.cjs");
 const require_consts = require("./consts-BzRfCcH2.cjs");
 const require_ops = require("./ops.cjs");

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { $ as TDbInsertResult, $t as BaseDbAdapter, A as TColumnDiff, An as ResolvedRelationFilter, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as relationStaticFilter, Bt as TViewJsonType, C as NavPropsOf, Cn as NativeIntegrity, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as resolveDesignType, Dt as TJsonCopyTarget, E as OwnPropsOf, En as DbResponse, Et as TInsertOptions, F as TDbActionLevel, Fn as andFilters, Ft as TSyncColumnResult, G as TDbIndex, Gn as TReadControls, Gt as UniqueryControls, H as TDbDeleteResult, Hn as TDbEncryptionOptions, Ht as TWriteTableResolver, I as TDbActionProcessor, In as containsRelationFilter, It as TTableOptionDiff, J as TDbInsertIgnoreOptions, Jn as TExprAggregate, Jt as isGeoIndexableType, K as TDbIndexField, Kn as NoopLogger, Kt as WithRelation, L as TDbActionTargetSummary, Ln as forEachResolvedRelation, Lt as TTableResolver, M as TCrudPermissions, Mn as TRelationFilterJunction, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterTable, Nt as TRowResolveOptions, O as TCascadeResolver, On as REL_FILTER_MAX_DEPTH, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationStaticFilter, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qt as ALL_VIEW_CAPABILITIES, R as TDbAvailableActions, Rn as hasRelationOp, Rt as TTouchManyOptions, S as FlatOf, Sn as IntegrityStrategy, St as TFkLookupTarget, T as NullsPlacement, Tn as AtscriptDbReadable, Tt as TIdentification, U as TDbFieldMeta, Un as DocumentFieldMapper, Ut as TypedWithRelation, V as TDbDefaultValue, Vn as DbEncryption, Vt as TWriteOptions, W as TDbForeignKey, Wn as FieldMappingStrategy, Wt as Uniquery, X as TDbInsertIgnoreSlot, Xn as TRowOrderKey, Xt as TPathPresence, Y as TDbInsertIgnoreResult, Yn as TFirstLast, Yt as isGeoPointType, Z as TDbInsertManyIgnoreResult, Zn as UniquSelect, Zt as ALL_BUCKET_UNITS, _ as DbPatch, _n as TViewPlan, _t as TExistingColumn, a as isJsonValueField, an as TViewColumnMapping, at as TDbStorageType, b as FieldOpsFor, bn as translateQueryTree, bt as TFieldMeta, c as resolveCalendarBuckets, cn as TViewReadPlan, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptOrderItem, dt as TDbWriteGuard, en as TViewCapability, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptQueryComparison, ft as TDbWriteGuardContext, g as DbControls, gn as TViewJoin, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptRef, ht as TDerivedColumn, i as isBucketableField, in as AtscriptDbView, it as TDbRemoveGuardContext, j as TCrudOp, jn as TRelGuardState, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_NODES, kt as TMetadataOverrides, l as AggregateControls, ln as aliasTargetOf, lt as TDbWriteCheck, mn as AtscriptQueryNode, mt as TDerivedChangeReason, n as TComputedSelect, nn as TAdapterFactory, nt as TDbRelation, o as jsonValueAncestor, on as isAtscriptDbView, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryFieldRef, pt as TDeleteOptions, q as TDbIndexType, qn as TGenericLogger, qt as TableMetadata, r as TResolvedBucket, rn as TDbSpaceOptions, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isViewType, st as TDbUpdateResult, t as TBucketFieldSource, tn as DbSpace, tt as TDbReferentialAction, u as AggregateExpr, un as AtscriptExprNode, ut as TDbWriteCheckContext, v as DbQuery, vn as evaluateExpr, vt as TExistingForeignKey, w as NullableOptional, wn as TCascadePin, wt as TIdResolveOptions, x as FilterExpr, xn as AtscriptDbTable, xt as TFkLookupResolver, y as DbRow, yn as isFieldRef, yt as TExistingTableOption, z as TDbCollation, zn as isResolvedRelationFilter, zt as TValueFormatterPair } from "./buckets-DcWm3SLt.cjs";
+import { $ as TDbInsertResult, $t as ALL_VIEW_CAPABILITIES, A as TColumnDiff, An as REL_FILTER_MAX_NODES, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as isResolvedRelationFilter, Bt as TValueFormatterPair, C as NavPropsOf, Cn as IntegrityStrategy, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as DbResponse, Dt as TJsonCopyTarget, E as OwnPropsOf, En as AtscriptDbReadable, Et as TInsertOptions, F as TDbActionLevel, Fn as TRelationStaticFilter, Ft as TSyncColumnResult, G as TDbIndex, Gn as FieldMappingStrategy, Gt as Uniquery, H as TDbDeleteResult, Hn as DbEncryption, Ht as TWriteOptions, I as TDbActionProcessor, In as andFilters, It as TSyncIndexesOptions, J as TDbInsertIgnoreOptions, Jn as TGenericLogger, Jt as TableMetadata, K as TDbIndexField, Kn as TReadControls, Kt as UniqueryControls, L as TDbActionTargetSummary, Ln as containsRelationFilter, Lt as TTableOptionDiff, M as TCrudPermissions, Mn as TRelGuardState, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterJunction, Nt as TRowResolveOptions, O as TCascadeResolver, On as resolveDesignType, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationFilterTable, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qn as UniquSelect, Qt as ALL_BUCKET_UNITS, R as TDbAvailableActions, Rn as forEachResolvedRelation, Rt as TTableResolver, S as FlatOf, Sn as AtscriptDbTable, St as TFkLookupTarget, T as NullsPlacement, Tn as TCascadePin, Tt as TIdentification, U as TDbFieldMeta, Un as TDbEncryptionOptions, Ut as TWriteTableResolver, V as TDbDefaultValue, Vn as relationStaticFilter, Vt as TViewJsonType, W as TDbForeignKey, Wn as DocumentFieldMapper, Wt as TypedWithRelation, X as TDbInsertIgnoreSlot, Xn as TFirstLast, Xt as isGeoPointType, Y as TDbInsertIgnoreResult, Yn as TExprAggregate, Yt as isGeoIndexableType, Z as TDbInsertManyIgnoreResult, Zn as TRowOrderKey, Zt as TPathPresence, _ as DbPatch, _n as TViewJoin, _t as TExistingColumn, a as isJsonValueField, an as AtscriptDbView, at as TDbStorageType, b as FieldOpsFor, bn as isFieldRef, bt as TFieldMeta, c as resolveCalendarBuckets, cn as isViewType, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptExprNode, dt as TDbWriteGuard, en as BaseDbAdapter, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptOrderItem, ft as TDbWriteGuardContext, g as DbControls, gn as AtscriptRef, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptQueryNode, ht as TDerivedColumn, i as isBucketableField, in as TDbSpaceOptions, it as TDbRemoveGuardContext, j as TCrudOp, jn as ResolvedRelationFilter, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_DEPTH, kt as TMetadataOverrides, l as AggregateControls, ln as TViewReadPlan, lt as TDbWriteCheck, mn as AtscriptQueryFieldRef, mt as TDerivedChangeReason, n as TComputedSelect, nn as DbSpace, nt as TDbRelation, o as jsonValueAncestor, on as TViewColumnMapping, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryComparison, pt as TDeleteOptions, q as TDbIndexType, qn as NoopLogger, qt as WithRelation, r as TResolvedBucket, rn as TAdapterFactory, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isAtscriptDbView, st as TDbUpdateResult, t as TBucketFieldSource, tn as TViewCapability, tt as TDbReferentialAction, u as AggregateExpr, un as aliasTargetOf, ut as TDbWriteCheckContext, v as DbQuery, vn as TViewPlan, vt as TExistingForeignKey, w as NullableOptional, wn as NativeIntegrity, wt as TIdResolveOptions, x as FilterExpr, xn as translateQueryTree, xt as TFkLookupResolver, y as DbRow, yn as evaluateExpr, yt as TExistingTableOption, z as TDbCollation, zn as hasRelationOp, zt as TTouchManyOptions } from "./buckets-B4T_alUe.cjs";
 import { _ as separateFieldOps, a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateCas, h as reconcileCas, 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-AqhV7s9o.cjs";
 import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-CtPYTIvy.cjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-42CSpGDR.cjs";
 import { _ as aggregateFailure, a as buildValidationContext, b as isRetryableDbError, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as aggregateExpressionsNotSupported, h as DbErrorCode, l as TArrayPatch, m as DbError, n as ValidatorMode, p as CasMismatchError, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch, v as bucketTimeZoneUnavailable, y as isConflict } from "./validator-B3xlbrWf.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-DblOPBLS.cjs";
-import { i as tableNameOf } from "./relation-helpers-D9kMFfum.cjs";
+import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-BWdQ7kRZ.cjs";
+import { i as tableNameOf } from "./relation-helpers-BLBrLQYi.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 import { AtscriptExprNode as AtscriptExprNode$1, TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
@@ -641,10 +641,11 @@ declare function assertNoVersionWrites(data: Record<string, unknown>, versionCol
  * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
  * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
  * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
- * (keep the two side by side): PK keys are skipped; an exempt path (or one
- * under an exempt ancestor) is covered whatever its value (scalar, field op,
- * array ops, object); a non-exempt merge-strategy object recurses (only the
- * supplied children are written); anything else is a non-exempt write.
+ * (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+ * skipped; an exempt path (or one under an exempt ancestor) is covered
+ * whatever its value (scalar, field op, array ops, object); a non-exempt
+ * merge-strategy object recurses (only the supplied children are written);
+ * anything else is a non-exempt write.
  * True iff at least one key is covered and none is not.
  * @since 0.1.150
  */
@@ -691,4 +692,4 @@ declare function createFailureCollector(what: string): {
  */
 declare function numericOperandProblem(fd: TDbFieldMeta): string | undefined;
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { $ as TDbInsertResult, $t as BaseDbAdapter, A as TColumnDiff, An as ResolvedRelationFilter, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as relationStaticFilter, Bt as TViewJsonType, C as NavPropsOf, Cn as NativeIntegrity, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as resolveDesignType, Dt as TJsonCopyTarget, E as OwnPropsOf, En as DbResponse, Et as TInsertOptions, F as TDbActionLevel, Fn as andFilters, Ft as TSyncColumnResult, G as TDbIndex, Gn as TReadControls, Gt as UniqueryControls, H as TDbDeleteResult, Hn as TDbEncryptionOptions, Ht as TWriteTableResolver, I as TDbActionProcessor, In as containsRelationFilter, It as TTableOptionDiff, J as TDbInsertIgnoreOptions, Jn as TExprAggregate, Jt as isGeoIndexableType, K as TDbIndexField, Kn as NoopLogger, Kt as WithRelation, L as TDbActionTargetSummary, Ln as forEachResolvedRelation, Lt as TTableResolver, M as TCrudPermissions, Mn as TRelationFilterJunction, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterTable, Nt as TRowResolveOptions, O as TCascadeResolver, On as REL_FILTER_MAX_DEPTH, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationStaticFilter, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qt as ALL_VIEW_CAPABILITIES, R as TDbAvailableActions, Rn as hasRelationOp, Rt as TTouchManyOptions, S as FlatOf, Sn as IntegrityStrategy, St as TFkLookupTarget, T as NullsPlacement, Tn as AtscriptDbReadable, Tt as TIdentification, U as TDbFieldMeta, Un as DocumentFieldMapper, Ut as TypedWithRelation, V as TDbDefaultValue, Vn as DbEncryption, Vt as TWriteOptions, W as TDbForeignKey, Wn as FieldMappingStrategy, Wt as Uniquery, X as TDbInsertIgnoreSlot, Xn as TRowOrderKey, Xt as TPathPresence, Y as TDbInsertIgnoreResult, Yn as TFirstLast, Yt as isGeoPointType, Z as TDbInsertManyIgnoreResult, Zn as UniquSelect, Zt as ALL_BUCKET_UNITS, _ as DbPatch, _n as TViewPlan, _t as TExistingColumn, a as isJsonValueField, an as TViewColumnMapping, at as TDbStorageType, b as FieldOpsFor, bn as translateQueryTree, bt as TFieldMeta, c as resolveCalendarBuckets, cn as TViewReadPlan, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptOrderItem, dt as TDbWriteGuard, en as TViewCapability, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptQueryComparison, ft as TDbWriteGuardContext, g as DbControls, gn as TViewJoin, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptRef, ht as TDerivedColumn, i as isBucketableField, in as AtscriptDbView, it as TDbRemoveGuardContext, j as TCrudOp, jn as TRelGuardState, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_NODES, kt as TMetadataOverrides, l as AggregateControls, ln as aliasTargetOf, lt as TDbWriteCheck, mn as AtscriptQueryNode, mt as TDerivedChangeReason, n as TComputedSelect, nn as TAdapterFactory, nt as TDbRelation, o as jsonValueAncestor, on as isAtscriptDbView, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryFieldRef, pt as TDeleteOptions, q as TDbIndexType, qn as TGenericLogger, qt as TableMetadata, r as TResolvedBucket, rn as TDbSpaceOptions, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isViewType, st as TDbUpdateResult, t as TBucketFieldSource, tn as DbSpace, tt as TDbReferentialAction, u as AggregateExpr, un as AtscriptExprNode, ut as TDbWriteCheckContext, v as DbQuery, vn as evaluateExpr, vt as TExistingForeignKey, w as NullableOptional, wn as TCascadePin, wt as TIdResolveOptions, x as FilterExpr, xn as AtscriptDbTable, xt as TFkLookupResolver, y as DbRow, yn as isFieldRef, yt as TExistingTableOption, z as TDbCollation, zn as isResolvedRelationFilter, zt as TValueFormatterPair } from "./buckets-goCoky8v.mjs";
+import { $ as TDbInsertResult, $t as ALL_VIEW_CAPABILITIES, A as TColumnDiff, An as REL_FILTER_MAX_NODES, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as isResolvedRelationFilter, Bt as TValueFormatterPair, C as NavPropsOf, Cn as IntegrityStrategy, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as DbResponse, Dt as TJsonCopyTarget, E as OwnPropsOf, En as AtscriptDbReadable, Et as TInsertOptions, F as TDbActionLevel, Fn as TRelationStaticFilter, Ft as TSyncColumnResult, G as TDbIndex, Gn as FieldMappingStrategy, Gt as Uniquery, H as TDbDeleteResult, Hn as DbEncryption, Ht as TWriteOptions, I as TDbActionProcessor, In as andFilters, It as TSyncIndexesOptions, J as TDbInsertIgnoreOptions, Jn as TGenericLogger, Jt as TableMetadata, K as TDbIndexField, Kn as TReadControls, Kt as UniqueryControls, L as TDbActionTargetSummary, Ln as containsRelationFilter, Lt as TTableOptionDiff, M as TCrudPermissions, Mn as TRelGuardState, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterJunction, Nt as TRowResolveOptions, O as TCascadeResolver, On as resolveDesignType, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationFilterTable, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qn as UniquSelect, Qt as ALL_BUCKET_UNITS, R as TDbAvailableActions, Rn as forEachResolvedRelation, Rt as TTableResolver, S as FlatOf, Sn as AtscriptDbTable, St as TFkLookupTarget, T as NullsPlacement, Tn as TCascadePin, Tt as TIdentification, U as TDbFieldMeta, Un as TDbEncryptionOptions, Ut as TWriteTableResolver, V as TDbDefaultValue, Vn as relationStaticFilter, Vt as TViewJsonType, W as TDbForeignKey, Wn as DocumentFieldMapper, Wt as TypedWithRelation, X as TDbInsertIgnoreSlot, Xn as TFirstLast, Xt as isGeoPointType, Y as TDbInsertIgnoreResult, Yn as TExprAggregate, Yt as isGeoIndexableType, Z as TDbInsertManyIgnoreResult, Zn as TRowOrderKey, Zt as TPathPresence, _ as DbPatch, _n as TViewJoin, _t as TExistingColumn, a as isJsonValueField, an as AtscriptDbView, at as TDbStorageType, b as FieldOpsFor, bn as isFieldRef, bt as TFieldMeta, c as resolveCalendarBuckets, cn as isViewType, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptExprNode, dt as TDbWriteGuard, en as BaseDbAdapter, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptOrderItem, ft as TDbWriteGuardContext, g as DbControls, gn as AtscriptRef, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptQueryNode, ht as TDerivedColumn, i as isBucketableField, in as TDbSpaceOptions, it as TDbRemoveGuardContext, j as TCrudOp, jn as ResolvedRelationFilter, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_DEPTH, kt as TMetadataOverrides, l as AggregateControls, ln as TViewReadPlan, lt as TDbWriteCheck, mn as AtscriptQueryFieldRef, mt as TDerivedChangeReason, n as TComputedSelect, nn as DbSpace, nt as TDbRelation, o as jsonValueAncestor, on as TViewColumnMapping, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryComparison, pt as TDeleteOptions, q as TDbIndexType, qn as NoopLogger, qt as WithRelation, r as TResolvedBucket, rn as TAdapterFactory, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isAtscriptDbView, st as TDbUpdateResult, t as TBucketFieldSource, tn as TViewCapability, tt as TDbReferentialAction, u as AggregateExpr, un as aliasTargetOf, ut as TDbWriteCheckContext, v as DbQuery, vn as TViewPlan, vt as TExistingForeignKey, w as NullableOptional, wn as NativeIntegrity, wt as TIdResolveOptions, x as FilterExpr, xn as translateQueryTree, xt as TFkLookupResolver, y as DbRow, yn as evaluateExpr, yt as TExistingTableOption, z as TDbCollation, zn as hasRelationOp, zt as TTouchManyOptions } from "./buckets-8mG67Mtw.mjs";
 import { _ as separateFieldOps, a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateCas, h as reconcileCas, 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-AqhV7s9o.mjs";
 import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-CtPYTIvy.mjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-Wo-smrYV.mjs";
 import { _ as aggregateFailure, a as buildValidationContext, b as isRetryableDbError, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as aggregateExpressionsNotSupported, h as DbErrorCode, l as TArrayPatch, m as DbError, n as ValidatorMode, p as CasMismatchError, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch, v as bucketTimeZoneUnavailable, y as isConflict } from "./validator-B3xlbrWf.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-BYLNWoF9.mjs";
-import { i as tableNameOf } from "./relation-helpers-B9MVBrtx.mjs";
+import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-5gX42hBt.mjs";
+import { i as tableNameOf } from "./relation-helpers-17_2f5hX.mjs";
 import { AtscriptExprNode as AtscriptExprNode$1, TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 
@@ -641,10 +641,11 @@ declare function assertNoVersionWrites(data: Record<string, unknown>, versionCol
  * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
  * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
  * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
- * (keep the two side by side): PK keys are skipped; an exempt path (or one
- * under an exempt ancestor) is covered whatever its value (scalar, field op,
- * array ops, object); a non-exempt merge-strategy object recurses (only the
- * supplied children are written); anything else is a non-exempt write.
+ * (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+ * skipped; an exempt path (or one under an exempt ancestor) is covered
+ * whatever its value (scalar, field op, array ops, object); a non-exempt
+ * merge-strategy object recurses (only the supplied children are written);
+ * anything else is a non-exempt write.
  * True iff at least one key is covered and none is not.
  * @since 0.1.150
  */
@@ -691,4 +692,4 @@ declare function createFailureCollector(what: string): {
  */
 declare function numericOperandProblem(fd: TDbFieldMeta): string | undefined;
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { a as aggregateExpressionsNotSupported, c as isConflict, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError, u as spaceClosedError } from "./db-error-eSsQX7rt.mjs";
-import { $ as RelationalFieldMapper, A as AtscriptDbReadable, B as canFilterLeaf, C as ApplicationIntegrity, D as createFailureCollector, E as BaseDbAdapter, F as ADAPTER_FILTER_REASON, G as guardAggregate, H as classifyQueryPath, I as ENCRYPTED_REASON, J as guardPaths, K as guardFilter, L as acceptedOperatorsHint, M as geoIndexNotFoundMessage, N as searchIndexNotFoundMessage, O as IntegrityStrategy, P as vectorIndexNotFoundMessage, Q as unsupportedOperatorMessage, R as assertGeoPoint, S as decomposePatch, T as ALL_VIEW_CAPABILITIES, U as collectQueryPaths, V as checkHavingKeys, W as groupSourceVerdict, X as narrowerFilterOps, Y as guardQuery, Z as sortFieldNames, _ as isAtscriptDbView, _t as normalizeComputedSelect, at as defaultFulltextIndex, b as isVersionExemptPatch, ct as splitFulltextFields, dt as isGeoPointType, et as DocumentFieldMapper, g as AtscriptDbView, gt as jsonValueAncestor, ht as isJsonValueField, it as INTEGER_REGEX_OP, j as resolveDesignType, k as NativeIntegrity, lt as TableMetadata, mt as isBucketableField, n as isColumnTypeChanged, nt as UniquSelect, ot as describeFulltext, p as fkColumns, pt as aliasTargetOf, q as guardPath, rt as numericOperandProblem, st as searchTermInteger, tt as FieldMappingStrategy, ut as isGeoIndexableType, v as isViewType, vt as resolveCalendarBuckets, w as ALL_BUCKET_UNITS, x as assertNoVersionWrites, y as AtscriptDbTable, yt as NoopLogger, z as bucketSourceVerdict } from "./column-diff-C68V_eYM.mjs";
+import { $ as RelationalFieldMapper, A as AtscriptDbReadable, B as canFilterLeaf, C as ApplicationIntegrity, D as createFailureCollector, E as BaseDbAdapter, F as ADAPTER_FILTER_REASON, G as guardAggregate, H as classifyQueryPath, I as ENCRYPTED_REASON, J as guardPaths, K as guardFilter, L as acceptedOperatorsHint, M as geoIndexNotFoundMessage, N as searchIndexNotFoundMessage, O as IntegrityStrategy, P as vectorIndexNotFoundMessage, Q as unsupportedOperatorMessage, R as assertGeoPoint, S as decomposePatch, T as ALL_VIEW_CAPABILITIES, U as collectQueryPaths, V as checkHavingKeys, W as groupSourceVerdict, X as narrowerFilterOps, Y as guardQuery, Z as sortFieldNames, _ as isAtscriptDbView, _t as normalizeComputedSelect, at as defaultFulltextIndex, b as isVersionExemptPatch, ct as splitFulltextFields, dt as isGeoPointType, et as DocumentFieldMapper, g as AtscriptDbView, gt as jsonValueAncestor, ht as isJsonValueField, it as INTEGER_REGEX_OP, j as resolveDesignType, k as NativeIntegrity, lt as TableMetadata, mt as isBucketableField, n as isColumnTypeChanged, nt as UniquSelect, ot as describeFulltext, p as fkColumns, pt as aliasTargetOf, q as guardPath, rt as numericOperandProblem, st as searchTermInteger, tt as FieldMappingStrategy, ut as isGeoIndexableType, v as isViewType, vt as resolveCalendarBuckets, w as ALL_BUCKET_UNITS, x as assertNoVersionWrites, y as AtscriptDbTable, yt as NoopLogger, z as bucketSourceVerdict } from "./column-diff-DR1glykD.mjs";
 import { n as ALL_AGGREGATE_FNS } from "./aggregate-fns-B_sgl4mB.mjs";
 import { A as hasRelationOp, C as REL_FILTER_MAX_DEPTH, D as containsRelationFilter, E as andFilters, G as evaluateExpr, H as tableNameOf, K as isFieldRef, P as relationStaticFilter, S as uniqueKeyTuple, T as ResolvedRelationFilter, j as isResolvedRelationFilter, k as forEachResolvedRelation, q as translateQueryTree, w as REL_FILTER_MAX_NODES } from "./nested-writer-BOj_c_lI.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-BC3nwFi4.mjs";
-import { i as DB_ENTITY_ANNOTATIONS, n as searchMemberKind } from "./search-fields-DBIZKwyb.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-B3fPJjS1.mjs";
+import { i as DB_ENTITY_ANNOTATIONS, n as searchMemberKind } from "./search-fields-CE8cmj9X.mjs";
 import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-TkiJQ-Dp.mjs";
 import { t as DEFAULT_DB_SPACE } from "./consts-C_-5_pFq.mjs";
 import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, reconcileCas, separateCas, separateFieldOps } from "./ops.mjs";

package/dist/plugin.cjs

@@ -34,9 +34,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 const require_aggregate_fns = require("./aggregate-fns-DFtKAv7Q.cjs");
-const require_search_fields = require("./search-fields-DwrsJUC1.cjs");
+const require_search_fields = require("./search-fields-CT_UZ9fg.cjs");
 require("./consts-BzRfCcH2.cjs");
-const require_validation_utils = require("./validation-utils-_PA7iSLm.cjs");
+const require_validation_utils = require("./validation-utils-CtLNlBtB.cjs");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 let node_url = require("node:url");
@@ -873,6 +873,21 @@ const dbColumnAnnotations = {
 			}
 		})
 	},
+	onUpdate: { now: new _atscript_core.AnnotationSpec({
+		description: "Sets the field to the current time (epoch ms) on every update: patches (`updateOne`, `bulkUpdate`, `updateMany`, HTTP `PATCH`) and replaces (`replaceOne`, `bulkReplace`, `replaceMany`, HTTP `PUT`). The value is written by the SDK in the same statement on every adapter and overrides a value the payload carries. Inserts are not affected — combine with `@db.default.now` (`number.timestamp.updated` applies both). Writes outside the SDK (raw SQL) do not set it.\n\n**Example:**\n```atscript\n@db.default.now\n@db.onUpdate.now\nupdatedAt: number.timestamp\n```\n",
+		nodeType: ["prop"],
+		passedWhenReferred: false,
+		validate(token, args, doc) {
+			const errors = require_validation_utils.validateFieldBaseType(token, doc, "@db.onUpdate.now", "number");
+			const field = token.parentNode;
+			for (const [name, why] of [["meta.id", "the primary key identifies the row and is never updated"], ["db.column.version", "the version column is adapter-managed"]]) if (field.countAnnotations(name) > 0) errors.push({
+				message: `@db.onUpdate.now cannot coexist with @${name} — ${why}`,
+				severity: 1,
+				range: token.range
+			});
+			return errors;
+		}
+	}) },
 	json: new _atscript_core.AnnotationSpec({
 		description: "Forces a field to be stored as a single JSON column instead of being flattened into separate columns. Use on nested object fields that should remain as JSON in the database.\n\n**Example:**\n```atscript\n@db.json\nmetadata: { key: string, value: string }\n```\n",
 		nodeType: ["prop"],
@@ -925,6 +940,7 @@ const dbColumnAnnotations = {
 				["db.column.version", "the OCC filter needs cleartext equality"],
 				["db.default.increment", "engine-side defaults bypass the encryption transform"],
 				["db.default.now", "engine-side defaults bypass the encryption transform"],
+				["db.onUpdate.now", "the update time is set after the encryption transform"],
 				["db.mongo.search.text", "Atlas Search over ciphertext is impossible"],
 				["db.mongo.search.autocomplete", "Atlas Search over ciphertext is impossible"]
 			]) if (field.countAnnotations(name) > 0) errors.push({
@@ -2319,6 +2335,7 @@ const dbPlugin = (options) => ({
 				index: dbIndexAnnotations.index,
 				column: dbColumnAnnotations.column,
 				default: dbColumnAnnotations.default,
+				onUpdate: dbColumnAnnotations.onUpdate,
 				json: dbColumnAnnotations.json,
 				ignore: dbColumnAnnotations.ignore,
 				encrypted: dbColumnAnnotations.encrypted,

package/dist/plugin.mjs

@@ -1,7 +1,7 @@
 import { i as NULL_WHEN_EMPTY_AGGREGATE_FNS, o as SUPPORTED_AGGREGATE_FNS, t as AGG_ANNOTATIONS } from "./aggregate-fns-B_sgl4mB.mjs";
-import { a as DERIVED_INCOMPATIBLE, i as DB_ENTITY_ANNOTATIONS, o as JSON_LEAF_TYPES, r as numericTypeProblem } from "./search-fields-DBIZKwyb.mjs";
+import { a as DERIVED_INCOMPATIBLE, i as DB_ENTITY_ANNOTATIONS, o as JSON_LEAF_TYPES, r as numericTypeProblem } from "./search-fields-CE8cmj9X.mjs";
 import "./consts-C_-5_pFq.mjs";
-import { C as validateExclusiveWith, S as searchFieldVerdict, T as validateSiblingStringField, _ as getParentTypeName, a as hasAnyViewAnnotation, b as primitiveBaseType, d as viewJoins, f as viewScopeTypes, g as getParentStruct, h as getNavTargetTypeName, i as forEachFieldRef, l as validateQueryScope, m as getDbTableOwner, n as findFKFieldsPointingTo, o as isAliasDecl, p as getAnnotationAlias, r as findViewCycle, s as isDbSourceDecl, t as earlierJoinTargets, u as validateRefArgument, v as integerMemberIndexProblem, w as validateFieldBaseType, x as refActionAnnotation, y as isNullableUnion } from "./validation-utils-DxHIqa36.mjs";
+import { C as validateExclusiveWith, S as searchFieldVerdict, T as validateSiblingStringField, _ as getParentTypeName, a as hasAnyViewAnnotation, b as primitiveBaseType, d as viewJoins, f as viewScopeTypes, g as getParentStruct, h as getNavTargetTypeName, i as forEachFieldRef, l as validateQueryScope, m as getDbTableOwner, n as findFKFieldsPointingTo, o as isAliasDecl, p as getAnnotationAlias, r as findViewCycle, s as isDbSourceDecl, t as earlierJoinTargets, u as validateRefArgument, v as integerMemberIndexProblem, w as validateFieldBaseType, x as refActionAnnotation, y as isNullableUnion } from "./validation-utils-BGjqc2jU.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { AnnotationSpec, DEFAULT_FORMAT, getFieldsForType, isArray, isInterface, isPrimitive, isProp, isQueryComparison, isQueryLogical, isRef, isStructure } from "@atscript/core";
@@ -837,6 +837,21 @@ const dbColumnAnnotations = {
 			}
 		})
 	},
+	onUpdate: { now: new AnnotationSpec({
+		description: "Sets the field to the current time (epoch ms) on every update: patches (`updateOne`, `bulkUpdate`, `updateMany`, HTTP `PATCH`) and replaces (`replaceOne`, `bulkReplace`, `replaceMany`, HTTP `PUT`). The value is written by the SDK in the same statement on every adapter and overrides a value the payload carries. Inserts are not affected — combine with `@db.default.now` (`number.timestamp.updated` applies both). Writes outside the SDK (raw SQL) do not set it.\n\n**Example:**\n```atscript\n@db.default.now\n@db.onUpdate.now\nupdatedAt: number.timestamp\n```\n",
+		nodeType: ["prop"],
+		passedWhenReferred: false,
+		validate(token, args, doc) {
+			const errors = validateFieldBaseType(token, doc, "@db.onUpdate.now", "number");
+			const field = token.parentNode;
+			for (const [name, why] of [["meta.id", "the primary key identifies the row and is never updated"], ["db.column.version", "the version column is adapter-managed"]]) if (field.countAnnotations(name) > 0) errors.push({
+				message: `@db.onUpdate.now cannot coexist with @${name} — ${why}`,
+				severity: 1,
+				range: token.range
+			});
+			return errors;
+		}
+	}) },
 	json: new AnnotationSpec({
 		description: "Forces a field to be stored as a single JSON column instead of being flattened into separate columns. Use on nested object fields that should remain as JSON in the database.\n\n**Example:**\n```atscript\n@db.json\nmetadata: { key: string, value: string }\n```\n",
 		nodeType: ["prop"],
@@ -889,6 +904,7 @@ const dbColumnAnnotations = {
 				["db.column.version", "the OCC filter needs cleartext equality"],
 				["db.default.increment", "engine-side defaults bypass the encryption transform"],
 				["db.default.now", "engine-side defaults bypass the encryption transform"],
+				["db.onUpdate.now", "the update time is set after the encryption transform"],
 				["db.mongo.search.text", "Atlas Search over ciphertext is impossible"],
 				["db.mongo.search.autocomplete", "Atlas Search over ciphertext is impossible"]
 			]) if (field.countAnnotations(name) > 0) errors.push({
@@ -2283,6 +2299,7 @@ const dbPlugin = (options) => ({
 				index: dbIndexAnnotations.index,
 				column: dbColumnAnnotations.column,
 				default: dbColumnAnnotations.default,
+				onUpdate: dbColumnAnnotations.onUpdate,
 				json: dbColumnAnnotations.json,
 				ignore: dbColumnAnnotations.ignore,
 				encrypted: dbColumnAnnotations.encrypted,

package/dist/rel.d.cts

@@ -1,6 +1,6 @@
-import { $t as BaseDbAdapter, Ht as TWriteTableResolver, Lt as TTableResolver, W as TDbForeignKey, h as AtscriptDbWritable, m as AtscriptDbTableLike, nt as TDbRelation, qn as TGenericLogger, qt as TableMetadata } from "./buckets-DcWm3SLt.cjs";
+import { Jn as TGenericLogger, Jt as TableMetadata, Rt as TTableResolver, Ut as TWriteTableResolver, W as TDbForeignKey, en as BaseDbAdapter, h as AtscriptDbWritable, m as AtscriptDbTableLike, nt as TDbRelation } from "./buckets-B4T_alUe.cjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-D9kMFfum.cjs";
+import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-BLBrLQYi.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";
 

package/dist/rel.d.mts

@@ -1,6 +1,6 @@
-import { $t as BaseDbAdapter, Ht as TWriteTableResolver, Lt as TTableResolver, W as TDbForeignKey, h as AtscriptDbWritable, m as AtscriptDbTableLike, nt as TDbRelation, qn as TGenericLogger, qt as TableMetadata } from "./buckets-goCoky8v.mjs";
+import { Jn as TGenericLogger, Jt as TableMetadata, Rt as TTableResolver, Ut as TWriteTableResolver, W as TDbForeignKey, en as BaseDbAdapter, h as AtscriptDbWritable, m as AtscriptDbTableLike, nt as TDbRelation } from "./buckets-8mG67Mtw.mjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-B9MVBrtx.mjs";
+import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-17_2f5hX.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 

package/dist/{relation-helpers-B9MVBrtx.d.mts → relation-helpers-17_2f5hX.d.mts}

@@ -1,4 +1,4 @@
-import { W as TDbForeignKey, nt as TDbRelation } from "./buckets-goCoky8v.mjs";
+import { W as TDbForeignKey, nt as TDbRelation } from "./buckets-8mG67Mtw.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/rel/relation-helpers.d.ts

package/dist/{relation-helpers-D9kMFfum.d.cts → relation-helpers-BLBrLQYi.d.cts}

@@ -1,4 +1,4 @@
-import { W as TDbForeignKey, nt as TDbRelation } from "./buckets-DcWm3SLt.cjs";
+import { W as TDbForeignKey, nt as TDbRelation } from "./buckets-B4T_alUe.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/rel/relation-helpers.d.ts

package/dist/{search-fields-DBIZKwyb.mjs → search-fields-CE8cmj9X.mjs}

@@ -29,6 +29,7 @@ const DERIVED_INCOMPATIBLE = [
 	["db.default.increment", "the value is computed, never defaulted"],
 	["db.default.uuid", "the value is computed, never defaulted"],
 	["db.default.now", "the value is computed, never defaulted"],
+	["db.onUpdate.now", "a derived column is never written"],
 	["db.column.version", "the version column is adapter-managed"],
 	["db.column.version.exempt", "a derived column is never written"],
 	["db.encrypted", "the value is a cleartext extraction of its source"],

package/dist/{search-fields-DwrsJUC1.cjs → search-fields-CT_UZ9fg.cjs}

@@ -29,6 +29,7 @@ const DERIVED_INCOMPATIBLE = [
 	["db.default.increment", "the value is computed, never defaulted"],
 	["db.default.uuid", "the value is computed, never defaulted"],
 	["db.default.now", "the value is computed, never defaulted"],
+	["db.onUpdate.now", "a derived column is never written"],
 	["db.column.version", "the version column is adapter-managed"],
 	["db.column.version.exempt", "a derived column is never written"],
 	["db.encrypted", "the value is a cleartext extraction of its source"],

package/dist/shared.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_aggregate_rules = require("./aggregate-rules-D_bsCpUI.cjs");
-const require_validation_utils = require("./validation-utils-_PA7iSLm.cjs");
+const require_validation_utils = require("./validation-utils-CtLNlBtB.cjs");
 exports.NOT_DIMENSION_REASON = require_aggregate_rules.NOT_DIMENSION_REASON;
 exports.earlierJoinTargets = require_validation_utils.earlierJoinTargets;
 exports.findFKFieldsPointingTo = require_validation_utils.findFKFieldsPointingTo;

package/dist/shared.mjs

@@ -1,3 +1,3 @@
 import { n as isStrictAggregateStruct, t as NOT_DIMENSION_REASON } from "./aggregate-rules-jdPrxqWa.mjs";
-import { C as validateExclusiveWith, S as searchFieldVerdict, T as validateSiblingStringField, _ as getParentTypeName, a as hasAnyViewAnnotation, b as primitiveBaseType, c as joinTargets, d as viewJoins, f as viewScopeTypes, g as getParentStruct, h as getNavTargetTypeName, i as forEachFieldRef, l as validateQueryScope, m as getDbTableOwner, n as findFKFieldsPointingTo, o as isAliasDecl, p as getAnnotationAlias, r as findViewCycle, s as isDbSourceDecl, t as earlierJoinTargets, u as validateRefArgument, v as integerMemberIndexProblem, w as validateFieldBaseType, x as refActionAnnotation, y as isNullableUnion } from "./validation-utils-DxHIqa36.mjs";
+import { C as validateExclusiveWith, S as searchFieldVerdict, T as validateSiblingStringField, _ as getParentTypeName, a as hasAnyViewAnnotation, b as primitiveBaseType, c as joinTargets, d as viewJoins, f as viewScopeTypes, g as getParentStruct, h as getNavTargetTypeName, i as forEachFieldRef, l as validateQueryScope, m as getDbTableOwner, n as findFKFieldsPointingTo, o as isAliasDecl, p as getAnnotationAlias, r as findViewCycle, s as isDbSourceDecl, t as earlierJoinTargets, u as validateRefArgument, v as integerMemberIndexProblem, w as validateFieldBaseType, x as refActionAnnotation, y as isNullableUnion } from "./validation-utils-BGjqc2jU.mjs";
 export { NOT_DIMENSION_REASON, earlierJoinTargets, findFKFieldsPointingTo, findViewCycle, forEachFieldRef, getAnnotationAlias, getDbTableOwner, getNavTargetTypeName, getParentStruct, getParentTypeName, hasAnyViewAnnotation, integerMemberIndexProblem, isAliasDecl, isDbSourceDecl, isNullableUnion, isStrictAggregateStruct, joinTargets, primitiveBaseType, refActionAnnotation, searchFieldVerdict, validateExclusiveWith, validateFieldBaseType, validateQueryScope, validateRefArgument, validateSiblingStringField, viewJoins, viewScopeTypes };