@atscript/db 0.1.54 → 0.1.55

package/dist/{db-space-DpaXOdRp.d.mts → db-space-D3QSKx2B.d.mts}

@@ -1,4 +1,4 @@
-import { F as TDbInsertResult, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TTableResolver, S as TCascadeResolver, U as TFkLookupResolver, et as TWriteTableResolver, l as TGenericLogger, o as BaseDbAdapter, s as TableMetadata, t as AtscriptDbReadable, z as TDbUpdateResult } from "./db-readable-GBjlsJXR.mjs";
+import { B as TFkLookupResolver, I as TDbUpdateResult, M as TDbInsertResult, T as TDbDeleteResult, Y as TTableResolver, Z as TWriteTableResolver, it as TGenericLogger, j as TDbInsertManyResult, nt as TableMetadata, o as BaseDbAdapter, t as AtscriptDbReadable, y as TCascadeResolver } from "./db-readable-RTtqL7H4.mjs";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 import { FilterExpr } from "@uniqu/core";
 
@@ -29,6 +29,7 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
   protected _fkLookupResolver?: TFkLookupResolver;
   protected readonly _integrity: IntegrityStrategy;
   protected readonly validators: Map<string, Validator<T, DataType>>;
+  private _fromDepthMap?;
   constructor(_type: T, adapter: A, logger?: TGenericLogger, _tableResolver?: TTableResolver, _writeTableResolver?: TWriteTableResolver);
   /**
    * Sets the cascade resolver for application-level cascade deletes.
@@ -141,6 +142,18 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    */
   protected _extractRecordFilter(payload: Record<string, unknown>): FilterExpr;
   private _prepareFilterValue;
+  /**
+   * Lazy — builds a `normalized-path → from-depth` map from `this._meta.flatMap`
+   * on first use. Only paths reachable through an unbroken chain of `db.rel.from`
+   * nav fields from the root are included (chains crossing `to`/`via` are excluded).
+   */
+  private _getFromDepthMap;
+  /**
+   * Populate the depth-limit bundle on a `DbValidationContext`. Only the root
+   * write call (`depth === 0`) enforces — nested re-entries leave `depthCheck`
+   * unset so the full tree is validated once at the root.
+   */
+  private _applyDepthCtx;
   /**
    * Pre-validate items (type validation + FK constraints) without inserting them.
    * Used by parent tables to validate FROM children before the main insert,

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

@@ -7,6 +7,16 @@ interface DbValidationContext {
   flatMap?: Map<string, TAtscriptAnnotatedType>;
   /** Precomputed nav field names — used to skip field-op validation inside TO/FROM/VIA relations. */
   navFields?: ReadonlySet<string>;
+  /**
+   * Depth-limit enforcement bundle. Set only on the root write call; nested
+   * re-entries leave it unset so the root's check isn't repeated. `limit` is
+   * `@db.depth.limit N`; `fromDepthMap` maps normalized paths (no array
+   * indices) to from-chain depth.
+   */
+  depthCheck?: {
+    limit: number;
+    fromDepthMap: ReadonlyMap<string, number>;
+  };
 }
 /**
  * Validator plugin for database operations.

package/dist/{db-validator-plugin-KC4aNIQq.d.mts → db-validator-plugin-DRGMCEn3.d.cts}

@@ -7,6 +7,16 @@ interface DbValidationContext {
   flatMap?: Map<string, TAtscriptAnnotatedType>;
   /** Precomputed nav field names — used to skip field-op validation inside TO/FROM/VIA relations. */
   navFields?: ReadonlySet<string>;
+  /**
+   * Depth-limit enforcement bundle. Set only on the root write call; nested
+   * re-entries leave it unset so the root's check isn't repeated. `limit` is
+   * `@db.depth.limit N`; `fromDepthMap` maps normalized paths (no array
+   * indices) to from-chain depth.
+   */
+  depthCheck?: {
+    limit: number;
+    fromDepthMap: ReadonlyMap<string, number>;
+  };
 }
 /**
  * Validator plugin for database operations.

package/dist/{db-view-DjDKgytJ.cjs → db-view-DIGN4079.cjs}

@@ -1,8 +1,9 @@
-const require_nested_writer = require("./nested-writer-BIQ6EfaR.cjs");
+const require_db_error = require("./db-error-D8tQhNgM.cjs");
 const require_agg = require("./agg.cjs");
 const require_relation_helpers = require("./relation-helpers-BYvsE1tR.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-0iGuvGOD.cjs");
+const require_validator = require("./validator-BIuw_T0k.cjs");
+const require_nested_writer = require("./nested-writer-v_LPR1yJ.cjs");
 let _atscript_typescript_utils = require("@atscript/typescript/utils");
 let node_async_hooks = require("node:async_hooks");
 //#region src/logger.ts
@@ -1096,8 +1097,17 @@ var AtscriptDbReadable = class {
 	_ensureBuilt() {
 		if (!this._meta.isBuilt) this._meta.build(this.type, this.adapter, this.logger);
 	}
+	/**
+	* Built table metadata. Triggers a lazy build on first access — safe to call
+	* from peer tables that need this one's relations / nav fields before any
+	* operation has run against it directly.
+	*/
+	getMetadata() {
+		this._ensureBuilt();
+		return this._meta;
+	}
 	_ensureSearchable() {
-		if (!this.adapter.isSearchable()) throw new require_nested_writer.DbError("INVALID_QUERY", [{
+		if (!this.adapter.isSearchable()) throw new require_db_error.DbError("INVALID_QUERY", [{
 			path: "$search",
 			message: `Table "${this.tableName}" has no search indexes defined`
 		}]);
@@ -1295,7 +1305,7 @@ var AtscriptDbReadable = class {
 		const { $groupBy, $select } = query.controls;
 		if ($select) {
 			const groupBySet = new Set($groupBy);
-			for (const item of $select) if (typeof item === "string" && !groupBySet.has(item)) throw new require_nested_writer.DbError("INVALID_QUERY", [{
+			for (const item of $select) if (typeof item === "string" && !groupBySet.has(item)) throw new require_db_error.DbError("INVALID_QUERY", [{
 				path: "$select",
 				message: `Plain field "${item}" in $select must also appear in $groupBy`
 			}]);
@@ -1304,12 +1314,12 @@ var AtscriptDbReadable = class {
 		if (dimensions.length > 0 || measures.length > 0) {
 			const dimSet = new Set(dimensions);
 			const measSet = new Set(measures);
-			for (const field of $groupBy) if (!dimSet.has(field)) throw new require_nested_writer.DbError("INVALID_QUERY", [{
+			for (const field of $groupBy) if (!dimSet.has(field)) throw new require_db_error.DbError("INVALID_QUERY", [{
 				path: "$groupBy",
 				message: `Field "${field}" is not a dimension`
 			}]);
 			if ($select) {
-				for (const item of $select) if (typeof item !== "string" && item.$field !== "*" && !measSet.has(item.$field)) throw new require_nested_writer.DbError("INVALID_QUERY", [{
+				for (const item of $select) if (typeof item !== "string" && item.$field !== "*" && !measSet.has(item.$field)) throw new require_db_error.DbError("INVALID_QUERY", [{
 					path: "$select",
 					message: `Aggregate field "${item.$field}" is not a measure`
 				}]);
@@ -1977,7 +1987,7 @@ var ApplicationIntegrity = class extends IntegrityStrategy {
 				if (await target.count(filter) < expectedCount) {
 					const sample = firstValues.slice(0, 3).join(", ");
 					const suffix = firstValues.length > 3 ? `, ... (${firstValues.length} total)` : "";
-					throw new require_nested_writer.DbError("FK_VIOLATION", [{
+					throw new require_db_error.DbError("FK_VIOLATION", [{
 						path: fk.fields.join(", "),
 						message: `FK constraint violation: "${fk.fields.join(", ")}" references non-existent record in "${fk.targetTable}" (values: ${sample}${suffix})`
 					}]);
@@ -1998,7 +2008,7 @@ var ApplicationIntegrity = class extends IntegrityStrategy {
 		const parentCtx = cascadeStorage.getStore();
 		const visited = parentCtx?.visited ?? /* @__PURE__ */ new Set();
 		const depth = (parentCtx?.depth ?? 0) + 1;
-		if (depth > MAX_CASCADE_DEPTH) throw new require_nested_writer.DbError("CASCADE_CYCLE", [{
+		if (depth > MAX_CASCADE_DEPTH) throw new require_db_error.DbError("CASCADE_CYCLE", [{
 			path: tableName,
 			message: `Cascade delete aborted: chain exceeded ${MAX_CASCADE_DEPTH} levels, likely caused by a circular or deeply nested cascade relationship`
 		}]);
@@ -2046,7 +2056,7 @@ var ApplicationIntegrity = class extends IntegrityStrategy {
 					const childFilter = this.buildCascadeChildFilter(records, target.fk);
 					if (!childFilter) continue;
 					restrictChecks.push(target.count(childFilter).then((count) => {
-						if (count > 0) throw new require_nested_writer.DbError("CONFLICT", [{
+						if (count > 0) throw new require_db_error.DbError("CONFLICT", [{
 							path: tableName,
 							message: `Cannot delete from "${tableName}": ${count} record(s) in "${target.childTable}" (${target.fk.fields.join(", ")}) reference it (RESTRICT)`
 						}]);
@@ -2358,6 +2368,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	_fkLookupResolver;
 	_integrity;
 	validators = /* @__PURE__ */ new Map();
+	_fromDepthMap;
 	constructor(_type, adapter, logger, _tableResolver, _writeTableResolver) {
 		super(_type, adapter, logger, _tableResolver);
 		if (_writeTableResolver) this._writeTableResolver = _writeTableResolver;
@@ -2411,16 +2422,20 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	*/
 	async insertMany(payloads, opts) {
 		this._ensureBuilt();
-		const maxDepth = opts?.maxDepth ?? 3;
-		const depth = opts?._depth ?? 0;
+		const { _depth, maxDepth: userMax } = opts ?? {};
+		const maxDepth = userMax ?? 3;
+		const depth = _depth ?? 0;
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		if (!canNest && this._meta.navFields.size > 0) require_nested_writer.checkDepthOverflow(payloads, maxDepth, this._meta);
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
-			require_nested_writer.validateBatch(this.getValidator("insert"), items, {
+			const validator = this.getValidator("insert");
+			const ctx = {
 				mode: "insert",
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			require_nested_writer.validateBatch(validator, items, ctx);
 			const host = this;
 			if (canNest) await require_nested_writer.batchInsertNestedTo(host, items, maxDepth, depth);
 			const prepared = [];
@@ -2460,10 +2475,13 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
-			require_nested_writer.validateBatch(this.getValidator("bulkReplace"), items, {
+			const validator = this.getValidator("bulkReplace");
+			const ctx = {
 				mode: "replace",
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			require_nested_writer.validateBatch(validator, items, ctx);
 			const host = this;
 			if (canNest) await require_nested_writer.batchReplaceNestedTo(host, items, maxDepth, depth);
 			await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver);
@@ -2507,11 +2525,14 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		if (!canNest && this._meta.navFields.size > 0) require_nested_writer.checkDepthOverflow(payloads, maxDepth, this._meta);
 		return require_nested_writer.enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
-			require_nested_writer.validateBatch(this.getValidator("bulkUpdate"), payloads, {
+			const validator = this.getValidator("bulkUpdate");
+			const ctx = {
 				mode: "patch",
 				flatMap: this.flatMap,
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			require_nested_writer.validateBatch(validator, payloads, ctx);
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
 			const host = this;
 			if (canNest) await require_nested_writer.batchPatchNestedTo(host, payloads, maxDepth, depth);
@@ -2673,11 +2694,11 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 				return filter;
 			}
 		}
-		if (pkFields.length === 0) throw new require_nested_writer.DbError("NOT_FOUND", [{
+		if (pkFields.length === 0) throw new require_db_error.DbError("NOT_FOUND", [{
 			path: "",
 			message: "No primary key defined — cannot extract filter"
 		}]);
-		throw new require_nested_writer.DbError("NOT_FOUND", [{
+		throw new require_db_error.DbError("NOT_FOUND", [{
 			path: pkFields[0],
 			message: `Missing primary key field "${pkFields[0]}" in payload`
 		}]);
@@ -2687,6 +2708,47 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return fieldType ? this.adapter.prepareId(value, fieldType) : value;
 	}
 	/**
+	* Lazy — builds a `normalized-path → from-depth` map from `this._meta.flatMap`
+	* on first use. Only paths reachable through an unbroken chain of `db.rel.from`
+	* nav fields from the root are included (chains crossing `to`/`via` are excluded).
+	*/
+	_getFromDepthMap() {
+		if (!this._fromDepthMap) {
+			const out = /* @__PURE__ */ new Map();
+			for (const [path, def] of this._meta.flatMap) {
+				if (!def.metadata?.has("db.rel.from")) continue;
+				const segments = path.split(".");
+				let prefix = "";
+				let depth = 0;
+				let valid = true;
+				for (let i = 0; i < segments.length; i++) {
+					prefix = prefix ? `${prefix}.${segments[i]}` : segments[i];
+					const pmd = this._meta.flatMap.get(prefix)?.metadata;
+					if (pmd?.has("db.rel.to") || pmd?.has("db.rel.via")) {
+						valid = false;
+						break;
+					}
+					if (pmd?.has("db.rel.from")) depth++;
+				}
+				if (valid) out.set(path, depth);
+			}
+			this._fromDepthMap = out;
+		}
+		return this._fromDepthMap;
+	}
+	/**
+	* Populate the depth-limit bundle on a `DbValidationContext`. Only the root
+	* write call (`depth === 0`) enforces — nested re-entries leave `depthCheck`
+	* unset so the full tree is validated once at the root.
+	*/
+	_applyDepthCtx(ctx, depth) {
+		if (depth !== 0 || this._meta.navFields.size === 0) return;
+		ctx.depthCheck = {
+			limit: this.type.metadata.get("db.depth.limit") ?? 0,
+			fromDepthMap: this._getFromDepthMap()
+		};
+	}
+	/**
 	* Pre-validate items (type validation + FK constraints) without inserting them.
 	* Used by parent tables to validate FROM children before the main insert,
 	* ensuring errors are caught before the parent is committed.

package/dist/{db-view-B1j_IKSf.mjs → db-view-DNwX6_4x.mjs}

@@ -1,8 +1,9 @@
-import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, h as DbError, i as batchPatchNestedFrom, l as batchReplaceNestedVia, m as remapDeleteFkViolation, n as batchInsertNestedTo, o as batchPatchNestedVia, p as enrichFkViolation, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-CNDyhg2L.mjs";
+import { t as DbError } from "./db-error-Cepx-RsQ.mjs";
 import { resolveAlias } from "./agg.mjs";
 import { n as findRemoteFK, t as findFKForRelation } from "./relation-helpers-CLasawQq.mjs";
 import { separateFieldOps } from "./ops.mjs";
-import { i as forceNavNonOptional, r as dbPlugin, s as getKeyProps, t as buildDbValidator } from "./validator-D_7Fqzs4.mjs";
+import { i as forceNavNonOptional, r as dbPlugin, s as getKeyProps, t as buildDbValidator } from "./validator-BB5h1Le3.mjs";
+import { a as batchPatchNestedTo, c as batchReplaceNestedTo, d as preValidateNestedFrom, f as validateBatch, i as batchPatchNestedFrom, l as batchReplaceNestedVia, m as remapDeleteFkViolation, n as batchInsertNestedTo, o as batchPatchNestedVia, p as enrichFkViolation, r as batchInsertNestedVia, s as batchReplaceNestedFrom, t as batchInsertNestedFrom, u as checkDepthOverflow } from "./nested-writer-CT2rLURx.mjs";
 import { flattenAnnotatedType, isAnnotatedType } from "@atscript/typescript/utils";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/logger.ts
@@ -1096,6 +1097,15 @@ var AtscriptDbReadable = class {
 	_ensureBuilt() {
 		if (!this._meta.isBuilt) this._meta.build(this.type, this.adapter, this.logger);
 	}
+	/**
+	* Built table metadata. Triggers a lazy build on first access — safe to call
+	* from peer tables that need this one's relations / nav fields before any
+	* operation has run against it directly.
+	*/
+	getMetadata() {
+		this._ensureBuilt();
+		return this._meta;
+	}
 	_ensureSearchable() {
 		if (!this.adapter.isSearchable()) throw new DbError("INVALID_QUERY", [{
 			path: "$search",
@@ -2358,6 +2368,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	_fkLookupResolver;
 	_integrity;
 	validators = /* @__PURE__ */ new Map();
+	_fromDepthMap;
 	constructor(_type, adapter, logger, _tableResolver, _writeTableResolver) {
 		super(_type, adapter, logger, _tableResolver);
 		if (_writeTableResolver) this._writeTableResolver = _writeTableResolver;
@@ -2411,16 +2422,20 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	*/
 	async insertMany(payloads, opts) {
 		this._ensureBuilt();
-		const maxDepth = opts?.maxDepth ?? 3;
-		const depth = opts?._depth ?? 0;
+		const { _depth, maxDepth: userMax } = opts ?? {};
+		const maxDepth = userMax ?? 3;
+		const depth = _depth ?? 0;
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		if (!canNest && this._meta.navFields.size > 0) checkDepthOverflow(payloads, maxDepth, this._meta);
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
-			validateBatch(this.getValidator("insert"), items, {
+			const validator = this.getValidator("insert");
+			const ctx = {
 				mode: "insert",
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			validateBatch(validator, items, ctx);
 			const host = this;
 			if (canNest) await batchInsertNestedTo(host, items, maxDepth, depth);
 			const prepared = [];
@@ -2460,10 +2475,13 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
 			const items = payloads.map((p) => this._applyDefaults({ ...p }));
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
-			validateBatch(this.getValidator("bulkReplace"), items, {
+			const validator = this.getValidator("bulkReplace");
+			const ctx = {
 				mode: "replace",
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			validateBatch(validator, items, ctx);
 			const host = this;
 			if (canNest) await batchReplaceNestedTo(host, items, maxDepth, depth);
 			await this._integrity.validateForeignKeys(items, this._meta, this._fkLookupResolver, this._writeTableResolver);
@@ -2507,11 +2525,14 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const canNest = depth < maxDepth && this._writeTableResolver && this._meta.navFields.size > 0;
 		if (!canNest && this._meta.navFields.size > 0) checkDepthOverflow(payloads, maxDepth, this._meta);
 		return enrichFkViolation(this._meta, () => this.adapter.withTransaction(async () => {
-			validateBatch(this.getValidator("bulkUpdate"), payloads, {
+			const validator = this.getValidator("bulkUpdate");
+			const ctx = {
 				mode: "patch",
 				flatMap: this.flatMap,
 				navFields: this._meta.navFields
-			});
+			};
+			this._applyDepthCtx(ctx, depth);
+			validateBatch(validator, payloads, ctx);
 			const originals = canNest ? payloads.map((p) => ({ ...p })) : [];
 			const host = this;
 			if (canNest) await batchPatchNestedTo(host, payloads, maxDepth, depth);
@@ -2687,6 +2708,47 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		return fieldType ? this.adapter.prepareId(value, fieldType) : value;
 	}
 	/**
+	* Lazy — builds a `normalized-path → from-depth` map from `this._meta.flatMap`
+	* on first use. Only paths reachable through an unbroken chain of `db.rel.from`
+	* nav fields from the root are included (chains crossing `to`/`via` are excluded).
+	*/
+	_getFromDepthMap() {
+		if (!this._fromDepthMap) {
+			const out = /* @__PURE__ */ new Map();
+			for (const [path, def] of this._meta.flatMap) {
+				if (!def.metadata?.has("db.rel.from")) continue;
+				const segments = path.split(".");
+				let prefix = "";
+				let depth = 0;
+				let valid = true;
+				for (let i = 0; i < segments.length; i++) {
+					prefix = prefix ? `${prefix}.${segments[i]}` : segments[i];
+					const pmd = this._meta.flatMap.get(prefix)?.metadata;
+					if (pmd?.has("db.rel.to") || pmd?.has("db.rel.via")) {
+						valid = false;
+						break;
+					}
+					if (pmd?.has("db.rel.from")) depth++;
+				}
+				if (valid) out.set(path, depth);
+			}
+			this._fromDepthMap = out;
+		}
+		return this._fromDepthMap;
+	}
+	/**
+	* Populate the depth-limit bundle on a `DbValidationContext`. Only the root
+	* write call (`depth === 0`) enforces — nested re-entries leave `depthCheck`
+	* unset so the full tree is validated once at the root.
+	*/
+	_applyDepthCtx(ctx, depth) {
+		if (depth !== 0 || this._meta.navFields.size === 0) return;
+		ctx.depthCheck = {
+			limit: this.type.metadata.get("db.depth.limit") ?? 0,
+			fromDepthMap: this._getFromDepthMap()
+		};
+	}
+	/**
 	* Pre-validate items (type validation + FK constraints) without inserting them.
 	* Used by parent tables to validate FROM children before the main insert,
 	* ensuring errors are caught before the parent is committed.

package/dist/index.cjs

@@ -1,8 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_nested_writer = require("./nested-writer-BIQ6EfaR.cjs");
-const require_db_view = require("./db-view-DjDKgytJ.cjs");
+const require_db_error = require("./db-error-D8tQhNgM.cjs");
+const require_db_view = require("./db-view-DIGN4079.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-0iGuvGOD.cjs");
+const require_validator = require("./validator-BIuw_T0k.cjs");
+require("./nested-writer-v_LPR1yJ.cjs");
 let _uniqu_core = require("@uniqu/core");
 //#region src/table/db-space.ts
 /**
@@ -152,7 +153,7 @@ exports.AtscriptDbReadable = require_db_view.AtscriptDbReadable;
 exports.AtscriptDbTable = require_db_view.AtscriptDbTable;
 exports.AtscriptDbView = require_db_view.AtscriptDbView;
 exports.BaseDbAdapter = require_db_view.BaseDbAdapter;
-exports.DbError = require_nested_writer.DbError;
+exports.DbError = require_db_error.DbError;
 exports.DbSpace = DbSpace;
 exports.DocumentFieldMapper = require_db_view.DocumentFieldMapper;
 exports.FieldMappingStrategy = require_db_view.FieldMappingStrategy;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { $ as TValueFormatterPair, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TIdDescriptor, H as TFieldMeta, I as TDbReferentialAction, J as TRelationInfo, K as TMetaResponse, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TTableResolver, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupResolver, V as TExistingTableOption, W as TFkLookupTarget, X as TSyncColumnResult, Y as TSearchIndexInfo, Z as TTableOptionDiff, _ as DbQuery, a as FieldMappingStrategy, at as UniquSelect, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as TWriteTableResolver, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, it as WithRelation, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as Uniquery, o as BaseDbAdapter, p as AggregateQuery, q as TMetadataOverrides, r as resolveDesignType, rt as UniqueryControls, s as TableMetadata, t as AtscriptDbReadable, tt as TypedWithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-ktHqF277.cjs";
+import { $ as Uniquery, A as TDbIndexType, B as TFkLookupResolver, C as TDbDefaultFn, D as TDbForeignKey, E as TDbFieldMeta, F as TDbStorageType, G as TRelationInfo, H as TIdDescriptor, I as TDbUpdateResult, J as TTableOptionDiff, K as TSearchIndexInfo, L as TExistingColumn, M as TDbInsertResult, N as TDbReferentialAction, O as TDbIndex, P as TDbRelation, Q as TypedWithRelation, R as TExistingTableOption, S as TDbCollation, T as TDbDeleteResult, U as TMetaResponse, V as TFkLookupTarget, W as TMetadataOverrides, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as NavPropsOf, a as FieldMappingStrategy, at as UniquSelect, b as TCascadeTarget, c as AggregateExpr, d as AggregateResult, et as UniqueryControls, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TGenericLogger, j as TDbInsertManyResult, k as TDbIndexField, l as AggregateFn, m as DbQuery, n as DbResponse, nt as TableMetadata, o as BaseDbAdapter, p as DbControls, q as TSyncColumnResult, r as resolveDesignType, rt as NoopLogger, s as AggregateControls, t as AtscriptDbReadable, tt as WithRelation, u as AggregateQuery, v as OwnPropsOf, w as TDbDefaultValue, x as TColumnDiff, y as TCascadeResolver, z as TFieldMeta } from "./db-readable-DtrC0BGF.cjs";
 import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-DB0MT6B3.cjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-Cz4QoDWg.cjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-BqVLHVq7.cjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-_z_A3cKa.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
@@ -81,7 +81,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/db-error.d.ts
-type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { $ as TValueFormatterPair, A as TDbForeignKey, B as TExistingColumn, C as TCascadeTarget, D as TDbDefaultValue, E as TDbDefaultFn, F as TDbInsertResult, G as TIdDescriptor, H as TFieldMeta, I as TDbReferentialAction, J as TRelationInfo, K as TMetaResponse, L as TDbRelation, M as TDbIndexField, N as TDbIndexType, O as TDbDeleteResult, P as TDbInsertManyResult, Q as TTableResolver, R as TDbStorageType, S as TCascadeResolver, T as TDbCollation, U as TFkLookupResolver, V as TExistingTableOption, W as TFkLookupTarget, X as TSyncColumnResult, Y as TSearchIndexInfo, Z as TTableOptionDiff, _ as DbQuery, a as FieldMappingStrategy, at as UniquSelect, b as NavPropsOf, c as NoopLogger, d as AggregateExpr, et as TWriteTableResolver, f as AggregateFn, g as DbControls, h as AtscriptDbWritable, i as DocumentFieldMapper, it as WithRelation, j as TDbIndex, k as TDbFieldMeta, l as TGenericLogger, m as AggregateResult, n as DbResponse, nt as Uniquery, o as BaseDbAdapter, p as AggregateQuery, q as TMetadataOverrides, r as resolveDesignType, rt as UniqueryControls, s as TableMetadata, t as AtscriptDbReadable, tt as TypedWithRelation, u as AggregateControls, v as FieldOpsFor, w as TColumnDiff, x as OwnPropsOf, y as FilterExpr, z as TDbUpdateResult } from "./db-readable-GBjlsJXR.mjs";
-import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-DcHDxrjX.mjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-DpaXOdRp.mjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-KC4aNIQq.mjs";
-import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-BeXlQISk.mjs";
+import { $ as Uniquery, A as TDbIndexType, B as TFkLookupResolver, C as TDbDefaultFn, D as TDbForeignKey, E as TDbFieldMeta, F as TDbStorageType, G as TRelationInfo, H as TIdDescriptor, I as TDbUpdateResult, J as TTableOptionDiff, K as TSearchIndexInfo, L as TExistingColumn, M as TDbInsertResult, N as TDbReferentialAction, O as TDbIndex, P as TDbRelation, Q as TypedWithRelation, R as TExistingTableOption, S as TDbCollation, T as TDbDeleteResult, U as TMetaResponse, V as TFkLookupTarget, W as TMetadataOverrides, X as TValueFormatterPair, Y as TTableResolver, Z as TWriteTableResolver, _ as NavPropsOf, a as FieldMappingStrategy, at as UniquSelect, b as TCascadeTarget, c as AggregateExpr, d as AggregateResult, et as UniqueryControls, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TGenericLogger, j as TDbInsertManyResult, k as TDbIndexField, l as AggregateFn, m as DbQuery, n as DbResponse, nt as TableMetadata, o as BaseDbAdapter, p as DbControls, q as TSyncColumnResult, r as resolveDesignType, rt as NoopLogger, s as AggregateControls, t as AtscriptDbReadable, tt as WithRelation, u as AggregateQuery, v as OwnPropsOf, w as TDbDefaultValue, x as TColumnDiff, y as TCascadeResolver, z as TFieldMeta } from "./db-readable-RTtqL7H4.mjs";
+import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-C61kelof.mjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-D3QSKx2B.mjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
+import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-DttN2e5_.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
 //#region src/strategies/relational-field-mapper.d.ts
@@ -81,7 +81,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/db-error.d.ts
-type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{

package/dist/index.mjs

@@ -1,7 +1,8 @@
-import { h as DbError } from "./nested-writer-CNDyhg2L.mjs";
-import { a as BaseDbAdapter, c as AtscriptDbReadable, d as DocumentFieldMapper, f as FieldMappingStrategy, h as NoopLogger, i as ApplicationIntegrity, l as resolveDesignType, m as TableMetadata, n as AtscriptDbTable, o as IntegrityStrategy, p as UniquSelect, r as decomposePatch, s as NativeIntegrity, t as AtscriptDbView, u as RelationalFieldMapper } from "./db-view-B1j_IKSf.mjs";
+import { t as DbError } from "./db-error-Cepx-RsQ.mjs";
+import { a as BaseDbAdapter, c as AtscriptDbReadable, d as DocumentFieldMapper, f as FieldMappingStrategy, h as NoopLogger, i as ApplicationIntegrity, l as resolveDesignType, m as TableMetadata, n as AtscriptDbTable, o as IntegrityStrategy, p as UniquSelect, r as decomposePatch, s as NativeIntegrity, t as AtscriptDbView, u as RelationalFieldMapper } from "./db-view-DNwX6_4x.mjs";
 import { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, separateFieldOps } from "./ops.mjs";
-import { a as isNavRelation, i as forceNavNonOptional, n as buildValidationContext, o as createDbValidatorPlugin, s as getKeyProps, t as buildDbValidator } from "./validator-D_7Fqzs4.mjs";
+import { a as isNavRelation, i as forceNavNonOptional, n as buildValidationContext, o as createDbValidatorPlugin, s as getKeyProps, t as buildDbValidator } from "./validator-BB5h1Le3.mjs";
+import "./nested-writer-CT2rLURx.mjs";
 import { computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 //#region src/table/db-space.ts
 /**

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

@@ -1,16 +1,6 @@
+import { n as DepthLimitExceededError, t as DbError } from "./db-error-Cepx-RsQ.mjs";
 import { r as resolveRelationTargetTable } from "./relation-helpers-CLasawQq.mjs";
 import { ValidatorError } from "@atscript/typescript/utils";
-//#region src/db-error.ts
-var DbError = class extends Error {
-	name = "DbError";
-	constructor(code, errors, message) {
-		super(message ?? errors[0]?.message ?? "Database error");
-		this.code = code;
-		this.errors = errors;
-		this.stack = void 0;
-	}
-};
-//#endregion
 //#region src/table/error-utils.ts
 /**
 * Prefixes error paths with a nav field context.
@@ -89,10 +79,13 @@ function validateBatch(validator, items, ctx) {
 	for (let i = 0; i < items.length; i++) try {
 		validator.validate(items[i], false, ctx);
 	} catch (error) {
-		if (error instanceof ValidatorError && items.length > 1) throw new ValidatorError(error.errors.map((err) => ({
-			...err,
-			path: `[${i}].${err.path}`
-		})));
+		if (items.length > 1) {
+			if (error instanceof ValidatorError) throw new ValidatorError(error.errors.map((err) => ({
+				...err,
+				path: `[${i}].${err.path}`
+			})));
+			if (error instanceof DepthLimitExceededError) throw new DepthLimitExceededError(`[${i}].${error.field}`, error.declared, error.actual);
+		}
 		throw error;
 	}
 }
@@ -621,4 +614,4 @@ async function viaReplace(targetTable, junctionTable, targets, parentPK, targetP
 	}
 }
 //#endregion
-export { batchPatchNestedTo as a, batchReplaceNestedTo as c, preValidateNestedFrom as d, validateBatch as f, DbError as h, batchPatchNestedFrom as i, batchReplaceNestedVia as l, remapDeleteFkViolation as m, batchInsertNestedTo as n, batchPatchNestedVia as o, enrichFkViolation as p, batchInsertNestedVia as r, batchReplaceNestedFrom as s, batchInsertNestedFrom as t, checkDepthOverflow as u };
+export { batchPatchNestedTo as a, batchReplaceNestedTo as c, preValidateNestedFrom as d, validateBatch as f, batchPatchNestedFrom as i, batchReplaceNestedVia as l, remapDeleteFkViolation as m, batchInsertNestedTo as n, batchPatchNestedVia as o, enrichFkViolation as p, batchInsertNestedVia as r, batchReplaceNestedFrom as s, batchInsertNestedFrom as t, checkDepthOverflow as u };