@atscript/db 0.1.127 → 0.1.128

package/dist/{validator-CSGug4vg.cjs → validator-BNUHCXIE.cjs}

@@ -1,6 +1,23 @@
 const require_db_error = require("./db-error-DXwEzmYJ.cjs");
 const require_ops = require("./ops.cjs");
 let _atscript_typescript_utils = require("@atscript/typescript/utils");
+//#region src/shared/object.ts
+/**
+* Plain object: prototype is `Object.prototype` or `null` — never a class
+* instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+* Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+*/
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+function isEmptyObject(obj) {
+	for (const _ in obj) return false;
+	return true;
+}
+//#endregion
 //#region src/patch/patch-types.ts
 /**
 * Extracts `@expect.array.key` properties from an array-of-objects type.
@@ -75,9 +92,9 @@ function createDbValidatorPlugin() {
 		if (isTo || isFrom || isVia) return handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia);
 		if (value === void 0 && (dbCtx.mode === "insert" || dbCtx.mode === "replace")) {
 			const meta = def.metadata;
-			const hasDefault = meta.has("db.default") || meta.has("db.default.increment") || meta.has("db.default.uuid") || meta.has("db.default.now");
+			const serverManaged = meta.has("db.default") || meta.has("db.default.increment") || meta.has("db.default.uuid") || meta.has("db.default.now") || meta.has("db.column.version");
 			const hasFK = meta.has("db.rel.FK");
-			if (hasDefault || hasFK) {
+			if (serverManaged || hasFK) {
 				if (dbCtx.mode === "replace" && meta.has("meta.id") && !isInsideNavField(ctx.path, dbCtx.navFields)) return;
 				return true;
 			}
@@ -425,9 +442,21 @@ Object.defineProperty(exports, "getKeyProps", {
 		return getKeyProps;
 	}
 });
+Object.defineProperty(exports, "isEmptyObject", {
+	enumerable: true,
+	get: function() {
+		return isEmptyObject;
+	}
+});
 Object.defineProperty(exports, "isNavRelation", {
 	enumerable: true,
 	get: function() {
 		return isNavRelation;
 	}
 });
+Object.defineProperty(exports, "isPlainObject", {
+	enumerable: true,
+	get: function() {
+		return isPlainObject;
+	}
+});

package/dist/{validator-BcBtg8yW.d.cts → validator-DuAmWc8L.d.cts}

@@ -1,5 +1,32 @@
 import { TAtscriptAnnotatedType, TAtscriptTypeArray, TAtscriptTypeObject, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
 
+//#region src/db-error.d.ts
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED" | "ENC_CONFIG_MISSING" | "ENC_KEY_INVALID" | "ENC_NOT_ENCRYPTED" | "ENC_DECRYPT_FAILED" | "ENC_FIELD_FILTER" | "ENC_FIELD_SORT" | "ENC_FIELD_AGG" | "ENC_FIELD_PATCH_OP" | "GEO_INDEX_MISSING" | "GEO_NOT_SUPPORTED" | "FILTER_TYPE_MISMATCH" | "TX_WAIT_TIMEOUT";
+declare class DbError extends Error {
+  readonly code: DbErrorCode;
+  readonly errors: Array<{
+    path: string;
+    message: string;
+  }>;
+  name: string;
+  constructor(code: DbErrorCode, errors: Array<{
+    path: string;
+    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/patch/patch-types.d.ts
 interface TArrayPatch<A extends readonly unknown[]> {
   $replace?: A;
@@ -25,6 +52,16 @@ type TDbPatch<T> = { [K in keyof T]?: T[K] extends Array<infer _> ? TArrayPatch<
  */
 declare function getKeyProps(def: TAtscriptAnnotatedType<TAtscriptTypeArray>): Set<string>;
 //#endregion
+//#region src/shared/object.d.ts
+/**
+ * Plain object: prototype is `Object.prototype` or `null` — never a class
+ * instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+ * Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+declare function isEmptyObject(obj: Record<string, unknown>): boolean;
+//#endregion
 //#region src/validator.d.ts
 /** Write operation mode for validator configuration. */
 type ValidatorMode = "insert" | "patch" | "replace";
@@ -85,4 +122,4 @@ interface ValidationContext {
  */
 declare function buildValidationContext(type: TAtscriptAnnotatedType<TAtscriptTypeObject>): ValidationContext;
 //#endregion
-export { buildValidationContext as a, isNavRelation as c, getKeyProps as d, buildPatchPartial as i, TArrayPatch as l, ValidatorMode as n, dbPlugin as o, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u };
+export { buildValidationContext as a, isNavRelation as c, TArrayPatch as d, TDbPatch as f, DbErrorCode as g, DbError as h, buildPatchPartial as i, isEmptyObject as l, CasExhaustedError as m, ValidatorMode as n, dbPlugin as o, getKeyProps as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, isPlainObject as u };

package/dist/{validator-BcBtg8yW.d.mts → validator-DuAmWc8L.d.mts}

@@ -1,5 +1,32 @@
 import { TAtscriptAnnotatedType, TAtscriptTypeArray, TAtscriptTypeObject, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
 
+//#region src/db-error.d.ts
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED" | "ENC_CONFIG_MISSING" | "ENC_KEY_INVALID" | "ENC_NOT_ENCRYPTED" | "ENC_DECRYPT_FAILED" | "ENC_FIELD_FILTER" | "ENC_FIELD_SORT" | "ENC_FIELD_AGG" | "ENC_FIELD_PATCH_OP" | "GEO_INDEX_MISSING" | "GEO_NOT_SUPPORTED" | "FILTER_TYPE_MISMATCH" | "TX_WAIT_TIMEOUT";
+declare class DbError extends Error {
+  readonly code: DbErrorCode;
+  readonly errors: Array<{
+    path: string;
+    message: string;
+  }>;
+  name: string;
+  constructor(code: DbErrorCode, errors: Array<{
+    path: string;
+    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/patch/patch-types.d.ts
 interface TArrayPatch<A extends readonly unknown[]> {
   $replace?: A;
@@ -25,6 +52,16 @@ type TDbPatch<T> = { [K in keyof T]?: T[K] extends Array<infer _> ? TArrayPatch<
  */
 declare function getKeyProps(def: TAtscriptAnnotatedType<TAtscriptTypeArray>): Set<string>;
 //#endregion
+//#region src/shared/object.d.ts
+/**
+ * Plain object: prototype is `Object.prototype` or `null` — never a class
+ * instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+ * Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+declare function isEmptyObject(obj: Record<string, unknown>): boolean;
+//#endregion
 //#region src/validator.d.ts
 /** Write operation mode for validator configuration. */
 type ValidatorMode = "insert" | "patch" | "replace";
@@ -85,4 +122,4 @@ interface ValidationContext {
  */
 declare function buildValidationContext(type: TAtscriptAnnotatedType<TAtscriptTypeObject>): ValidationContext;
 //#endregion
-export { buildValidationContext as a, isNavRelation as c, getKeyProps as d, buildPatchPartial as i, TArrayPatch as l, ValidatorMode as n, dbPlugin as o, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u };
+export { buildValidationContext as a, isNavRelation as c, TArrayPatch as d, TDbPatch as f, DbErrorCode as g, DbError as h, buildPatchPartial as i, isEmptyObject as l, CasExhaustedError as m, ValidatorMode as n, dbPlugin as o, getKeyProps as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, isPlainObject as u };

package/dist/{validator-0vRXN51D.mjs → validator-eKYWf3xf.mjs}

@@ -1,6 +1,23 @@
 import { r as DepthLimitExceededError } from "./db-error-BHPXOKzc.mjs";
 import { isDbFieldOp } from "./ops.mjs";
 import { flattenAnnotatedType } from "@atscript/typescript/utils";
+//#region src/shared/object.ts
+/**
+* Plain object: prototype is `Object.prototype` or `null` — never a class
+* instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+* Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+*/
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+function isEmptyObject(obj) {
+	for (const _ in obj) return false;
+	return true;
+}
+//#endregion
 //#region src/patch/patch-types.ts
 /**
 * Extracts `@expect.array.key` properties from an array-of-objects type.
@@ -75,9 +92,9 @@ function createDbValidatorPlugin() {
 		if (isTo || isFrom || isVia) return handleNavField(ctx, def, value, dbCtx, isTo, isFrom, isVia);
 		if (value === void 0 && (dbCtx.mode === "insert" || dbCtx.mode === "replace")) {
 			const meta = def.metadata;
-			const hasDefault = meta.has("db.default") || meta.has("db.default.increment") || meta.has("db.default.uuid") || meta.has("db.default.now");
+			const serverManaged = meta.has("db.default") || meta.has("db.default.increment") || meta.has("db.default.uuid") || meta.has("db.default.now") || meta.has("db.column.version");
 			const hasFK = meta.has("db.rel.FK");
-			if (hasDefault || hasFK) {
+			if (serverManaged || hasFK) {
 				if (dbCtx.mode === "replace" && meta.has("meta.id") && !isInsideNavField(ctx.path, dbCtx.navFields)) return;
 				return true;
 			}
@@ -383,4 +400,4 @@ function buildValidationContext(type) {
 	};
 }
 //#endregion
-export { forceNavNonOptional as a, getKeyProps as c, dbPlugin as i, buildPatchPartial as n, isNavRelation as o, buildValidationContext as r, createDbValidatorPlugin as s, buildDbValidator as t };
+export { forceNavNonOptional as a, getKeyProps as c, dbPlugin as i, isEmptyObject as l, buildPatchPartial as n, isNavRelation as o, buildValidationContext as r, createDbValidatorPlugin as s, buildDbValidator as t, isPlainObject as u };

package/dist/validator.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_db_error = require("./db-error-DXwEzmYJ.cjs");
+const require_validator = require("./validator-BNUHCXIE.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-CSGug4vg.cjs");
 exports.$cas = require_ops.$cas;
 exports.$dec = require_ops.$dec;
 exports.$inc = require_ops.$inc;
@@ -10,6 +11,7 @@ exports.$remove = require_ops.$remove;
 exports.$replace = require_ops.$replace;
 exports.$update = require_ops.$update;
 exports.$upsert = require_ops.$upsert;
+exports.DbError = require_db_error.DbError;
 exports.buildDbValidator = require_validator.buildDbValidator;
 exports.buildPatchPartial = require_validator.buildPatchPartial;
 exports.buildValidationContext = require_validator.buildValidationContext;
@@ -18,4 +20,8 @@ exports.dbPlugin = require_validator.dbPlugin;
 exports.forceNavNonOptional = require_validator.forceNavNonOptional;
 exports.getKeyProps = require_validator.getKeyProps;
 exports.isDbFieldOp = require_ops.isDbFieldOp;
+exports.isEmptyObject = require_validator.isEmptyObject;
 exports.isNavRelation = require_validator.isNavRelation;
+exports.isPlainObject = require_validator.isPlainObject;
+exports.reconcileCas = require_ops.reconcileCas;
+exports.separateCas = require_ops.separateCas;

package/dist/validator.d.cts

@@ -1,4 +1,4 @@
-import { a as $mul, c as $update, d as TDbFieldOp, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-DJRnNTVo.cjs";
+import { a as $mul, c as $update, d as TDbFieldOp, g as separateCas, h as reconcileCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-AqhV7s9o.cjs";
+import { a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, h as DbError, i as buildPatchPartial, l as isEmptyObject, n as ValidatorMode, o as dbPlugin, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject } from "./validator-DuAmWc8L.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-BcBtg8yW.cjs";
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type DbValidationContext, type TArrayPatch, type TDbCas, type TDbFieldOp, type TDbPatch, ValidationContext, ValidatorMode, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isNavRelation };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, DbError, type DbValidationContext, type TArrayPatch, type TDbCas, type TDbFieldOp, type TDbPatch, ValidationContext, ValidatorMode, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isEmptyObject, isNavRelation, isPlainObject, reconcileCas, separateCas };

package/dist/validator.d.mts

@@ -1,4 +1,4 @@
-import { a as $mul, c as $update, d as TDbFieldOp, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-DJRnNTVo.mjs";
+import { a as $mul, c as $update, d as TDbFieldOp, g as separateCas, h as reconcileCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-AqhV7s9o.mjs";
+import { a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, h as DbError, i as buildPatchPartial, l as isEmptyObject, n as ValidatorMode, o as dbPlugin, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject } from "./validator-DuAmWc8L.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-BcBtg8yW.mjs";
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, type DbValidationContext, type TArrayPatch, type TDbCas, type TDbFieldOp, type TDbPatch, ValidationContext, ValidatorMode, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isNavRelation };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, DbError, type DbValidationContext, type TArrayPatch, type TDbCas, type TDbFieldOp, type TDbPatch, ValidationContext, ValidatorMode, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isEmptyObject, isNavRelation, isPlainObject, reconcileCas, separateCas };

package/dist/validator.mjs

@@ -1,3 +1,4 @@
-import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, isDbFieldOp } from "./ops.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, i as dbPlugin, n as buildPatchPartial, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-0vRXN51D.mjs";
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isNavRelation };
+import { n as DbError } from "./db-error-BHPXOKzc.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, i as dbPlugin, l as isEmptyObject, n as buildPatchPartial, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator, u as isPlainObject } from "./validator-eKYWf3xf.mjs";
+import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, isDbFieldOp, reconcileCas, separateCas } from "./ops.mjs";
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, DbError, buildDbValidator, buildPatchPartial, buildValidationContext, createDbValidatorPlugin, dbPlugin, forceNavNonOptional, getKeyProps, isDbFieldOp, isEmptyObject, isNavRelation, isPlainObject, reconcileCas, separateCas };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db",
-  "version": "0.1.127",
+  "version": "0.1.128",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",
@@ -71,15 +71,15 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.89",
-    "@atscript/typescript": "^0.1.89",
-    "@uniqu/core": "^0.1.7",
-    "unplugin-atscript": "^0.1.89"
+    "@atscript/core": "^0.1.92",
+    "@atscript/typescript": "^0.1.92",
+    "@uniqu/core": "^0.1.8",
+    "unplugin-atscript": "^0.1.92"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.89",
-    "@atscript/typescript": "^0.1.89",
-    "@uniqu/core": "^0.1.7"
+    "@atscript/core": "^0.1.92",
+    "@atscript/typescript": "^0.1.92",
+    "@uniqu/core": "^0.1.8"
   },
   "scripts": {
     "postinstall": "asc -f dts",