@atscript/db 0.1.146 → 0.1.148

package/dist/sync.mjs

@@ -1,5 +1,5 @@
-import { r as DbError } from "./db-error-D5uilS_A.mjs";
-import { a as hasForeignKeyChanges, c as computeTableHash, d as snapshotToExistingColumns, f as snapshotToExistingTableOptions, i as fkKey, l as computeTableSnapshot, o as canonicalizeQueryNode, p as viewSnapshotSources, r as computeForeignKeyDiff, s as computeSchemaHash, st as NoopLogger, t as computeColumnDiff, tt as aliasTargetOf, u as computeViewSnapshot } from "./column-diff-e2oHc71_.mjs";
+import { r as DbError } from "./db-error-Az85UhTX.mjs";
+import { a as computeTableHash, at as aliasTargetOf, c as snapshotToExistingColumns, d as computeForeignKeyDiff, dt as NoopLogger, f as fkColumns, i as computeSchemaHash, l as snapshotToExistingTableOptions, m as hasForeignKeyChanges, o as computeTableSnapshot, p as fkKey, r as canonicalizeQueryNode, s as computeViewSnapshot, t as computeColumnDiff, u as viewSnapshotSources } from "./column-diff-Cp6ZoyRE.mjs";
 //#region src/schema/table-option-diff.ts
 /**
 * Computes the difference between desired and existing table options.
@@ -744,7 +744,7 @@ async function executeSyncTable(facts, safe, deps, exec) {
 					};
 				} else {
 					if (hasFkChanges && fkDiff && adapter.dropForeignKeys) {
-						const keysToDrop = [...fkDiff.removed.map((fk) => fkKey(fk.fields)), ...fkDiff.changed.map((fk) => fkKey(fk.desired.fields))];
+						const keysToDrop = [...fkDiff.removed.map((fk) => fkKey(fk.fields)), ...fkDiff.changed.map((fk) => fkKey(fkColumns(fk.desired).fields))];
 						if (keysToDrop.length > 0) {
 							await adapter.dropForeignKeys(keysToDrop);
 							droppedFks.push(...keysToDrop);
@@ -1610,7 +1610,7 @@ var SchemaSync = class {
 			const fkDiff = facts.fkDiff;
 			init.status = "alter";
 			init.fkAdded = fkDiff.added.map((fk) => ({
-				fields: fk.fields,
+				fields: fkColumns(fk).fields,
 				targetTable: fk.targetTable
 			}));
 			init.fkRemoved = fkDiff.removed.map((fk) => ({
@@ -1618,9 +1618,12 @@ var SchemaSync = class {
 				targetTable: fk.targetTable
 			}));
 			init.fkChanged = fkDiff.changed.map((fk) => ({
-				fields: fk.desired.fields,
+				fields: fkColumns(fk.desired).fields,
 				targetTable: fk.desired.targetTable,
-				details: buildFkChangeDetails(fk.desired, fk.existing)
+				details: buildFkChangeDetails({
+					...fk.desired,
+					targetFields: fkColumns(fk.desired).targetFields
+				}, fk.existing)
 			}));
 		}
 		if (facts.diff?.primaryKeyChanged) facts.populated = await adapter.hasRows(pendingRename ? dbName : void 0) ?? "unknown";
@@ -1658,7 +1661,7 @@ var SchemaSync = class {
 							addRefusal(refusals, t.name, `Primary key of "${t.name}" changed ${label} but the referencing table "${child.name}" is renamed in the same run (from "${child.pendingRename}") — rename it in a separate run first, then retarget the foreign key and re-run.`);
 							continue;
 						}
-						if (!(child !== void 0 && [...child.readable.foreignKeys.values()].some((desired) => desired.targetTable === t.name && fkKey(desired.fields) === fkKey(fk.fields) && fkKey(desired.targetFields) === fkKey(pk.to)))) addRefusal(refusals, t.name, `Primary key of "${t.name}" changed ${label} but "${fk.table}.${fk.fields.join(",")}" still references the old key — retarget the foreign key (or migrate manually) and re-run.`);
+						if (!(child !== void 0 && [...child.readable.foreignKeys.values()].some((desired) => desired.targetTable === t.name && fkKey(fkColumns(desired).fields) === fkKey(fk.fields) && fkKey(fkColumns(desired).targetFields) === fkKey(pk.to)))) addRefusal(refusals, t.name, `Primary key of "${t.name}" changed ${label} but "${fk.table}.${fk.fields.join(",")}" still references the old key — retarget the foreign key (or migrate manually) and re-run.`);
 					}
 					for (const f of t.readable.fieldDescriptors) if (!f.ignored && !f.isPrimaryKey && f.defaultValue?.kind === "fn" && f.defaultValue.fn === "increment") addRefusal(refusals, t.name, `"${t.name}.${f.physicalName}" is auto-increment but no longer part of the primary key; auto-increment columns must be primary-key columns.`);
 				}
@@ -1673,6 +1676,7 @@ var SchemaSync = class {
 			if (d.viewObjectKinds.get(view.tableName) === "table") addRefusal(refusals, view.tableName, `A physical table "${view.tableName}" exists where managed view "${view.tableName}" is declared — drop or rename it`);
 			const fns = view.dbAdapter.aggregateFns();
 			for (const col of view.getViewColumnMappings()) if (col.aggFn && !fns.has(col.aggFn)) addRefusal(refusals, view.tableName, `View "${view.tableName}" field "${col.viewPath}": aggregate "${col.aggFn}" is not supported by this adapter (aggregateFns())`);
+			for (const problem of view.viewCapabilityProblems()) addRefusal(refusals, view.tableName, problem);
 			for (const source of d.viewSources.get(view.tableName)) if (d.externalTargets.get(source) === false) addRefusal(refusals, view.tableName, `View "${view.tableName}" reads "${source}" which is neither in the sync inventory nor present in the database`);
 		}
 		if (!safe) for (const r of d.removed) {

package/dist/{validation-utils-DOsB4e6G.cjs → validation-utils-Da2GjobR.cjs}

@@ -344,44 +344,55 @@ function hasAnyViewAnnotation(node) {
 	return viewAnnotationNames.some((name) => node.countAnnotations(name) > 0);
 }
 /**
-* Validate that all field refs in a query expression are within `scope` —
-* the same {@link TQueryScope} the editor completes (`lsp-scopes`):
+* Every field ref of a backtick argument — a predicate (`queryNode`), an
+* arithmetic expression (`exprNode`) or an ordering (`orderNode`) — in source
+* order. `[]` when the argument did not parse.
+* @since 0.1.147
+*/
+function backtickFieldRefs(token) {
+	if (token.queryNode) {
+		const refs = [];
+		forEachFieldRef(token.queryNode.expression, (ref) => refs.push(ref));
+		return refs;
+	}
+	return (token.exprNode ?? token.orderNode)?.fieldRefs() ?? [];
+}
+/**
+* Validate that all field refs in a backtick argument (a query, an `expr` or
+* an `order`) are within `scope` — the same {@link TQueryScope} the editor
+* completes (`lsp-scopes`):
 * qualified refs must name one of `scope.allowedTypes`; an unqualified ref
 * (a dotted path included) must be a field of `scope.unqualifiedTarget`, or
 * is rejected outright when that is `null`.
 *
-* @param queryToken - The query arg token (must have .queryNode)
+* @param queryToken - The backtick arg token (with `.queryNode`, `.exprNode` or `.orderNode`)
 * @param scope - The scope of the argument
 * @param doc - The document for type lookups
 * @param scopeHint - Replaces the default "expected 'A' or 'B'" tail of the out-of-scope message
 */
 function validateQueryScope(queryToken, scope, doc, scopeHint) {
 	const errors = [];
-	const queryNode = queryToken.queryNode;
-	if (!queryNode) return errors;
 	const { allowedTypes, unqualifiedTarget } = scope;
-	forEachFieldRef(queryNode.expression, (ref) => {
-		if (ref.typeRef) {
-			const typeName = ref.typeRef.text;
-			if (!allowedTypes.includes(typeName)) errors.push({
-				message: `Query references '${typeName}' which is not in scope — ${scopeHint ?? `expected ${allowedTypes.map((t) => `'${t}'`).join(" or ")}`}`,
-				severity: 1,
-				range: ref.typeRef.range
-			});
-		} else if (unqualifiedTarget === null) errors.push({
-			message: `Unqualified field reference '${ref.fieldRef.text}' — use qualified form (e.g., Type.${ref.fieldRef.text})`,
+	for (const ref of backtickFieldRefs(queryToken)) if (ref.typeRef) {
+		const typeName = ref.typeRef.text;
+		if (!allowedTypes.includes(typeName)) errors.push({
+			message: `Query references '${typeName}' which is not in scope — ${scopeHint ?? `expected ${allowedTypes.map((t) => `'${t}'`).join(" or ")}`}`,
 			severity: 1,
-			range: ref.fieldRef.range
+			range: ref.typeRef.range
 		});
-		else {
-			const targetDef = doc.unwindType(unqualifiedTarget)?.def;
-			if (targetDef && ((0, _atscript_core.isInterface)(targetDef) || (0, _atscript_core.isStructure)(targetDef)) && !doc.unwindType(unqualifiedTarget, ref.fieldRef.text.split("."))) errors.push({
-				message: `Field '${ref.fieldRef.text}' does not exist on '${unqualifiedTarget}'`,
-				severity: 1,
-				range: ref.fieldRef.range
-			});
-		}
+	} else if (unqualifiedTarget === null) errors.push({
+		message: `Unqualified field reference '${ref.fieldRef.text}' — use qualified form (e.g., Type.${ref.fieldRef.text})`,
+		severity: 1,
+		range: ref.fieldRef.range
 	});
+	else {
+		const targetDef = doc.unwindType(unqualifiedTarget)?.def;
+		if (targetDef && ((0, _atscript_core.isInterface)(targetDef) || (0, _atscript_core.isStructure)(targetDef)) && !doc.unwindType(unqualifiedTarget, ref.fieldRef.text.split("."))) errors.push({
+			message: `Field '${ref.fieldRef.text}' does not exist on '${unqualifiedTarget}'`,
+			severity: 1,
+			range: ref.fieldRef.range
+		});
+	}
 	return errors;
 }
 /**

package/dist/{validation-utils-CMR4fe2M.mjs → validation-utils-Dq0uZ7ef.mjs}

@@ -344,44 +344,55 @@ function hasAnyViewAnnotation(node) {
 	return viewAnnotationNames.some((name) => node.countAnnotations(name) > 0);
 }
 /**
-* Validate that all field refs in a query expression are within `scope` —
-* the same {@link TQueryScope} the editor completes (`lsp-scopes`):
+* Every field ref of a backtick argument — a predicate (`queryNode`), an
+* arithmetic expression (`exprNode`) or an ordering (`orderNode`) — in source
+* order. `[]` when the argument did not parse.
+* @since 0.1.147
+*/
+function backtickFieldRefs(token) {
+	if (token.queryNode) {
+		const refs = [];
+		forEachFieldRef(token.queryNode.expression, (ref) => refs.push(ref));
+		return refs;
+	}
+	return (token.exprNode ?? token.orderNode)?.fieldRefs() ?? [];
+}
+/**
+* Validate that all field refs in a backtick argument (a query, an `expr` or
+* an `order`) are within `scope` — the same {@link TQueryScope} the editor
+* completes (`lsp-scopes`):
 * qualified refs must name one of `scope.allowedTypes`; an unqualified ref
 * (a dotted path included) must be a field of `scope.unqualifiedTarget`, or
 * is rejected outright when that is `null`.
 *
-* @param queryToken - The query arg token (must have .queryNode)
+* @param queryToken - The backtick arg token (with `.queryNode`, `.exprNode` or `.orderNode`)
 * @param scope - The scope of the argument
 * @param doc - The document for type lookups
 * @param scopeHint - Replaces the default "expected 'A' or 'B'" tail of the out-of-scope message
 */
 function validateQueryScope(queryToken, scope, doc, scopeHint) {
 	const errors = [];
-	const queryNode = queryToken.queryNode;
-	if (!queryNode) return errors;
 	const { allowedTypes, unqualifiedTarget } = scope;
-	forEachFieldRef(queryNode.expression, (ref) => {
-		if (ref.typeRef) {
-			const typeName = ref.typeRef.text;
-			if (!allowedTypes.includes(typeName)) errors.push({
-				message: `Query references '${typeName}' which is not in scope — ${scopeHint ?? `expected ${allowedTypes.map((t) => `'${t}'`).join(" or ")}`}`,
-				severity: 1,
-				range: ref.typeRef.range
-			});
-		} else if (unqualifiedTarget === null) errors.push({
-			message: `Unqualified field reference '${ref.fieldRef.text}' — use qualified form (e.g., Type.${ref.fieldRef.text})`,
+	for (const ref of backtickFieldRefs(queryToken)) if (ref.typeRef) {
+		const typeName = ref.typeRef.text;
+		if (!allowedTypes.includes(typeName)) errors.push({
+			message: `Query references '${typeName}' which is not in scope — ${scopeHint ?? `expected ${allowedTypes.map((t) => `'${t}'`).join(" or ")}`}`,
 			severity: 1,
-			range: ref.fieldRef.range
+			range: ref.typeRef.range
 		});
-		else {
-			const targetDef = doc.unwindType(unqualifiedTarget)?.def;
-			if (targetDef && (isInterface(targetDef) || isStructure(targetDef)) && !doc.unwindType(unqualifiedTarget, ref.fieldRef.text.split("."))) errors.push({
-				message: `Field '${ref.fieldRef.text}' does not exist on '${unqualifiedTarget}'`,
-				severity: 1,
-				range: ref.fieldRef.range
-			});
-		}
+	} else if (unqualifiedTarget === null) errors.push({
+		message: `Unqualified field reference '${ref.fieldRef.text}' — use qualified form (e.g., Type.${ref.fieldRef.text})`,
+		severity: 1,
+		range: ref.fieldRef.range
 	});
+	else {
+		const targetDef = doc.unwindType(unqualifiedTarget)?.def;
+		if (targetDef && (isInterface(targetDef) || isStructure(targetDef)) && !doc.unwindType(unqualifiedTarget, ref.fieldRef.text.split("."))) errors.push({
+			message: `Field '${ref.fieldRef.text}' does not exist on '${unqualifiedTarget}'`,
+			severity: 1,
+			range: ref.fieldRef.range
+		});
+	}
 	return errors;
 }
 /**

package/dist/{validator-Clu2q_7z.mjs → validator-BTiIOTKP.mjs}

@@ -1,5 +1,5 @@
-import { i as DepthLimitExceededError } from "./db-error-D5uilS_A.mjs";
-import { isDbFieldOp } from "./ops.mjs";
+import { i as DepthLimitExceededError } from "./db-error-Az85UhTX.mjs";
+import { getDbFieldOp } from "./ops.mjs";
 import { flattenAnnotatedType } from "@atscript/typescript/utils";
 //#region src/patch/patch-types.ts
 /**
@@ -83,7 +83,8 @@ function createDbValidatorPlugin() {
 			}
 		}
 		if (dbCtx.mode === "patch") {
-			if (isDbFieldOp(value)) {
+			const fieldOp = getDbFieldOp(value);
+			if (fieldOp) {
 				if (def.metadata.has("db.column.derived")) {
 					ctx.error("Field operations ($inc/$dec/$mul) are not allowed on a @db.column.derived field — it is computed from its @db.json source; patch the source leaf instead");
 					return false;
@@ -96,6 +97,11 @@ function createDbValidatorPlugin() {
 					ctx.error("Field operations ($inc/$dec/$mul) can only be applied to numeric fields");
 					return false;
 				}
+				const operand = fieldOp.value;
+				if (!Number.isFinite(operand)) {
+					ctx.error(`Field operation operand must be a finite number, got ${operand}`);
+					return false;
+				}
 				return true;
 			}
 			if (def.type.kind === "array" && dbCtx.flatMap) {

package/dist/{validator-CVS-onRg.cjs → validator-UcuJxHNT.cjs}

@@ -1,4 +1,4 @@
-const require_db_error = require("./db-error-DTkkeu5b.cjs");
+const require_db_error = require("./db-error-DRQH4sLY.cjs");
 const require_ops = require("./ops.cjs");
 let _atscript_typescript_utils = require("@atscript/typescript/utils");
 //#region src/patch/patch-types.ts
@@ -83,7 +83,8 @@ function createDbValidatorPlugin() {
 			}
 		}
 		if (dbCtx.mode === "patch") {
-			if (require_ops.isDbFieldOp(value)) {
+			const fieldOp = require_ops.getDbFieldOp(value);
+			if (fieldOp) {
 				if (def.metadata.has("db.column.derived")) {
 					ctx.error("Field operations ($inc/$dec/$mul) are not allowed on a @db.column.derived field — it is computed from its @db.json source; patch the source leaf instead");
 					return false;
@@ -96,6 +97,11 @@ function createDbValidatorPlugin() {
 					ctx.error("Field operations ($inc/$dec/$mul) can only be applied to numeric fields");
 					return false;
 				}
+				const operand = fieldOp.value;
+				if (!Number.isFinite(operand)) {
+					ctx.error(`Field operation operand must be a finite number, got ${operand}`);
+					return false;
+				}
 				return true;
 			}
 			if (def.type.kind === "array" && dbCtx.flatMap) {

package/dist/{validator-Bw6ks9Hy.d.mts → validator-tBNvM1qc.d.cts}

@@ -1,7 +1,20 @@
 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" | "CAS_MISMATCH" | "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" /** The adapter's `calendarBucketUnits()` lacks the requested unit (moost-db: 400). */ | "BUCKET_NOT_SUPPORTED" /** The engine cannot resolve the bucket's time zone — a store-configuration condition (moost-db: 501). */ | "BUCKET_TZ_UNAVAILABLE" /** A known aggregate function the adapter's `aggregateFns()` lacks (moost-db: 400). @since 0.1.136 */ | "AGG_FN_NOT_SUPPORTED" | "TX_WAIT_TIMEOUT";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED" | "CAS_MISMATCH" | "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" /** The adapter's `calendarBucketUnits()` lacks the requested unit (moost-db: 400). */ | "BUCKET_NOT_SUPPORTED" /** The engine cannot resolve the bucket's time zone — a store-configuration condition (moost-db: 501). */ | "BUCKET_TZ_UNAVAILABLE" /** A known aggregate function the adapter's `aggregateFns()` lacks (moost-db: 400). @since 0.1.136 */ | "AGG_FN_NOT_SUPPORTED"
+/**
+ * The adapter's `supportsAggregateExpressions()` is false and the query uses
+ * arithmetic (`{ $expr }`, `{ $fn, $expr }`) in an aggregate `$select`
+ * (moost-db: 400). @since 0.1.148
+ */
+| "AGG_EXPR_NOT_SUPPORTED"
+/**
+ * The adapter (or the table's wiring) cannot run a relational predicate:
+ * `supportsRelationFilters()` is false for the read/write mode, the related
+ * table lives on a different adapter, or the table was built without a
+ * `DbSpace` (moost-db: 400). @since 0.1.147
+ */
+| "REL_FILTER_NOT_SUPPORTED" /** The `DbSpace` was closed; the table/view handle can no longer be used (moost-db: 503). @since 0.1.148 */ | "SPACE_CLOSED" /** The adapter does not implement `insertManyIgnore` (moost-db: 400). @since 0.1.148 */ | "ON_CONFLICT_NOT_SUPPORTED" | "TX_WAIT_TIMEOUT";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{
@@ -14,6 +27,14 @@ declare class DbError extends Error {
     message: string;
   }>, message?: string);
 }
+/** Whether `error` is a `DbError` with code `CONFLICT` (unique / primary-key violation). */
+declare function isConflict(error: unknown): error is DbError;
+/**
+ * Collapses the failures of a multi-step shutdown into one `AggregateError`
+ * (message lists every failure).
+ * @internal
+ */
+declare function aggregateFailure(label: string, errors: unknown[]): AggregateError;
 /**
  * Thrown by {@link withOptimisticRetry} when `maxAttempts` is reached
  * without a successful CAS commit — the target row kept changing under
@@ -39,11 +60,7 @@ declare class CasMismatchError extends DbError {
   /** Keys passed to `touchMany`. */
   readonly expected: number;
   name: string;
-  constructor(/** Rows whose primary key + version matched. */
-
-  matched: number, /** Keys passed to `touchMany`. */
-
-  expected: number);
+  constructor(/** Rows whose primary key + version matched. */matched: number, /** Keys passed to `touchMany`. */expected: number);
 }
 /**
  * The engine cannot resolve a calendar bucket's time zone (`BUCKET_TZ_UNAVAILABLE`,
@@ -52,6 +69,13 @@ declare class CasMismatchError extends DbError {
  * missing server time zone database — never a malformed query. Since 0.1.132.
  */
 declare function bucketTimeZoneUnavailable(message: string): DbError;
+/**
+ * The adapter's `supportsAggregateExpressions()` is false (or its SQL dialect
+ * cannot cast to a double) and the query uses arithmetic in an aggregate
+ * `$select` (`AGG_EXPR_NOT_SUPPORTED`, `path` `$select`; moost-db: 400).
+ * @since 0.1.148
+ */
+declare function aggregateExpressionsNotSupported(): DbError;
 //#endregion
 //#region src/patch/patch-types.d.ts
 interface TArrayPatch<A extends readonly unknown[]> {
@@ -138,4 +162,4 @@ interface ValidationContext {
  */
 declare function buildValidationContext(type: TAtscriptAnnotatedType<TAtscriptTypeObject>): ValidationContext;
 //#endregion
-export { buildValidationContext as a, isNavRelation as c, getKeyProps as d, CasExhaustedError as f, bucketTimeZoneUnavailable as g, DbErrorCode as h, buildPatchPartial as i, TArrayPatch as l, DbError as m, ValidatorMode as n, dbPlugin as o, CasMismatchError as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u };
+export { aggregateFailure as _, buildValidationContext as a, isNavRelation as c, getKeyProps as d, CasExhaustedError as f, aggregateExpressionsNotSupported as g, DbErrorCode as h, buildPatchPartial as i, TArrayPatch as l, DbError as m, ValidatorMode as n, dbPlugin as o, CasMismatchError as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u, bucketTimeZoneUnavailable as v, isConflict as y };

package/dist/{validator-Bw6ks9Hy.d.cts → validator-tBNvM1qc.d.mts}

@@ -1,7 +1,20 @@
 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" | "CAS_MISMATCH" | "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" /** The adapter's `calendarBucketUnits()` lacks the requested unit (moost-db: 400). */ | "BUCKET_NOT_SUPPORTED" /** The engine cannot resolve the bucket's time zone — a store-configuration condition (moost-db: 501). */ | "BUCKET_TZ_UNAVAILABLE" /** A known aggregate function the adapter's `aggregateFns()` lacks (moost-db: 400). @since 0.1.136 */ | "AGG_FN_NOT_SUPPORTED" | "TX_WAIT_TIMEOUT";
+type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" | "INVALID_QUERY" | "DEPTH_EXCEEDED" | "VERSION_COLUMN_WRITE" | "CAS_EXHAUSTED" | "CAS_MISMATCH" | "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" /** The adapter's `calendarBucketUnits()` lacks the requested unit (moost-db: 400). */ | "BUCKET_NOT_SUPPORTED" /** The engine cannot resolve the bucket's time zone — a store-configuration condition (moost-db: 501). */ | "BUCKET_TZ_UNAVAILABLE" /** A known aggregate function the adapter's `aggregateFns()` lacks (moost-db: 400). @since 0.1.136 */ | "AGG_FN_NOT_SUPPORTED"
+/**
+ * The adapter's `supportsAggregateExpressions()` is false and the query uses
+ * arithmetic (`{ $expr }`, `{ $fn, $expr }`) in an aggregate `$select`
+ * (moost-db: 400). @since 0.1.148
+ */
+| "AGG_EXPR_NOT_SUPPORTED"
+/**
+ * The adapter (or the table's wiring) cannot run a relational predicate:
+ * `supportsRelationFilters()` is false for the read/write mode, the related
+ * table lives on a different adapter, or the table was built without a
+ * `DbSpace` (moost-db: 400). @since 0.1.147
+ */
+| "REL_FILTER_NOT_SUPPORTED" /** The `DbSpace` was closed; the table/view handle can no longer be used (moost-db: 503). @since 0.1.148 */ | "SPACE_CLOSED" /** The adapter does not implement `insertManyIgnore` (moost-db: 400). @since 0.1.148 */ | "ON_CONFLICT_NOT_SUPPORTED" | "TX_WAIT_TIMEOUT";
 declare class DbError extends Error {
   readonly code: DbErrorCode;
   readonly errors: Array<{
@@ -14,6 +27,14 @@ declare class DbError extends Error {
     message: string;
   }>, message?: string);
 }
+/** Whether `error` is a `DbError` with code `CONFLICT` (unique / primary-key violation). */
+declare function isConflict(error: unknown): error is DbError;
+/**
+ * Collapses the failures of a multi-step shutdown into one `AggregateError`
+ * (message lists every failure).
+ * @internal
+ */
+declare function aggregateFailure(label: string, errors: unknown[]): AggregateError;
 /**
  * Thrown by {@link withOptimisticRetry} when `maxAttempts` is reached
  * without a successful CAS commit — the target row kept changing under
@@ -39,11 +60,7 @@ declare class CasMismatchError extends DbError {
   /** Keys passed to `touchMany`. */
   readonly expected: number;
   name: string;
-  constructor(/** Rows whose primary key + version matched. */
-
-  matched: number, /** Keys passed to `touchMany`. */
-
-  expected: number);
+  constructor(/** Rows whose primary key + version matched. */matched: number, /** Keys passed to `touchMany`. */expected: number);
 }
 /**
  * The engine cannot resolve a calendar bucket's time zone (`BUCKET_TZ_UNAVAILABLE`,
@@ -52,6 +69,13 @@ declare class CasMismatchError extends DbError {
  * missing server time zone database — never a malformed query. Since 0.1.132.
  */
 declare function bucketTimeZoneUnavailable(message: string): DbError;
+/**
+ * The adapter's `supportsAggregateExpressions()` is false (or its SQL dialect
+ * cannot cast to a double) and the query uses arithmetic in an aggregate
+ * `$select` (`AGG_EXPR_NOT_SUPPORTED`, `path` `$select`; moost-db: 400).
+ * @since 0.1.148
+ */
+declare function aggregateExpressionsNotSupported(): DbError;
 //#endregion
 //#region src/patch/patch-types.d.ts
 interface TArrayPatch<A extends readonly unknown[]> {
@@ -138,4 +162,4 @@ interface ValidationContext {
  */
 declare function buildValidationContext(type: TAtscriptAnnotatedType<TAtscriptTypeObject>): ValidationContext;
 //#endregion
-export { buildValidationContext as a, isNavRelation as c, getKeyProps as d, CasExhaustedError as f, bucketTimeZoneUnavailable as g, DbErrorCode as h, buildPatchPartial as i, TArrayPatch as l, DbError as m, ValidatorMode as n, dbPlugin as o, CasMismatchError as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u };
+export { aggregateFailure as _, buildValidationContext as a, isNavRelation as c, getKeyProps as d, CasExhaustedError as f, aggregateExpressionsNotSupported as g, DbErrorCode as h, buildPatchPartial as i, TArrayPatch as l, DbError as m, ValidatorMode as n, dbPlugin as o, CasMismatchError as p, buildDbValidator as r, forceNavNonOptional as s, ValidationContext as t, TDbPatch as u, bucketTimeZoneUnavailable as v, isConflict as y };

package/dist/validator.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_db_error = require("./db-error-DTkkeu5b.cjs");
+const require_db_error = require("./db-error-DRQH4sLY.cjs");
 const require_object = require("./object-Djg28csK.cjs");
 const require_ops = require("./ops.cjs");
-const require_validator = require("./validator-CVS-onRg.cjs");
+const require_validator = require("./validator-UcuJxHNT.cjs");
 exports.$cas = require_ops.$cas;
 exports.$dec = require_ops.$dec;
 exports.$inc = require_ops.$inc;

package/dist/validator.d.cts

@@ -1,5 +1,5 @@
 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 isPlainObject, i as isEmptyObject } from "./object-CtPYTIvy.cjs";
-import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, m as DbError, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-Bw6ks9Hy.cjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, m as DbError, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-tBNvM1qc.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
 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,5 +1,5 @@
 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 isPlainObject, i as isEmptyObject } from "./object-CtPYTIvy.mjs";
-import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, m as DbError, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-Bw6ks9Hy.mjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, i as buildPatchPartial, l as TArrayPatch, m as DbError, n as ValidatorMode, o as dbPlugin, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-tBNvM1qc.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
 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,5 +1,5 @@
-import { r as DbError } from "./db-error-D5uilS_A.mjs";
+import { r as DbError } from "./db-error-Az85UhTX.mjs";
 import { a as isPlainObject, i as isEmptyObject } from "./object-TkiJQ-Dp.mjs";
 import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, isDbFieldOp, reconcileCas, separateCas } 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-Clu2q_7z.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-BTiIOTKP.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.146",
+  "version": "0.1.148",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",
@@ -71,15 +71,15 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.98",
-    "@atscript/typescript": "^0.1.98",
-    "@uniqu/core": "^0.1.11",
-    "unplugin-atscript": "^0.1.98"
+    "@atscript/core": "^0.1.100",
+    "@atscript/typescript": "^0.1.100",
+    "@uniqu/core": "^0.1.13",
+    "unplugin-atscript": "^0.1.100"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.98",
-    "@atscript/typescript": "^0.1.98",
-    "@uniqu/core": "^0.1.11"
+    "@atscript/core": "^0.1.100",
+    "@atscript/typescript": "^0.1.100",
+    "@uniqu/core": "^0.1.13"
   },
   "scripts": {
     "postinstall": "asc -f dts",