@atscript/db 0.1.163 → 0.1.165

package/dist/{db-error-B_DRL1E9.d.cts → db-error-DQUw2cED.d.cts}

@@ -50,17 +50,64 @@ type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" |
  * `isolationLevels()` lacks it.
  */
 | "ISOLATION_NOT_SUPPORTED";
+/**
+ * Per-entry reasons of a constraint violation (since 0.1.165), stable
+ * UPPER_SNAKE keys a client can translate (with {@link TDbErrorEntry.params}):
+ * - `UNIQUE` — a unique key (or the primary key) already holds the value;
+ *   params `{ index, fields }` (`index` is the declared unique-index name, or
+ *   `"primaryKey"`);
+ * - `FK_MISSING` — a foreign key names a row that does not exist; params
+ *   `{ fields, target }` (+ `ambiguous: true` when the engine could not tell
+ *   which foreign key failed and every one is listed);
+ * - `FK_RESTRICT` — a delete is blocked by referencing rows; params
+ *   `{ table, referencedBy? }`.
+ */
+type TDbErrorEntryCode = "UNIQUE" | "FK_MISSING" | "FK_RESTRICT";
+/** One entry of {@link DbError.errors}. */
+interface TDbErrorEntry {
+  /** Logical field path the entry is about (`""` when it concerns the whole row / table). */
+  path: string;
+  /** Human-readable English message. */
+  message: string;
+  /**
+   * Machine-readable reason of this entry (since 0.1.165) — see
+   * {@link TDbErrorEntryCode}. Absent on entries whose reason is the
+   * error's own {@link DbError.code}.
+   */
+  code?: TDbErrorEntryCode | (string & {});
+  /** The values {@link message} names, for rendering it in another language (since 0.1.165). */
+  params?: Record<string, unknown>;
+  /**
+   * The engine's raw text, kept for logs when the message was normalized
+   * (since 0.1.165). Never sent to HTTP clients.
+   */
+  details?: string;
+}
+/**
+ * What an adapter could tell about a violated constraint (since 0.1.165) —
+ * the core resolves it against the table's metadata into logical paths
+ * (see {@link constraintViolation}). Physical names throughout.
+ */
+interface TDbConstraintHint {
+  /** The violated columns, when the engine names them. */
+  columns?: readonly string[];
+  /** The violated constraint / index name, when the engine names it. */
+  name?: string;
+  /** On a blocked delete: the table holding the referencing rows. */
+  referencedBy?: string;
+  /** The violation is the primary key's. */
+  primaryKey?: boolean;
+}
 declare class DbError extends Error {
   readonly code: DbErrorCode;
-  readonly errors: Array<{
-    path: string;
-    message: string;
-  }>;
+  readonly errors: TDbErrorEntry[];
   name: string;
-  constructor(code: DbErrorCode, errors: Array<{
-    path: string;
-    message: string;
-  }>, message?: string);
+  /**
+   * Set by {@link constraintViolation}: what the adapter could tell about the
+   * violated constraint, for the table layer to normalize. @internal
+   */
+  hint?: TDbConstraintHint;
+  constructor(code: DbErrorCode, errors: TDbErrorEntry[], message?: string);
   /**
    * `true` when retrying the whole transaction may succeed — a transient
    * concurrency condition (`DEADLOCK`, `LOCK_TIMEOUT`,
@@ -77,6 +124,15 @@ declare class DbError extends Error {
 declare function isRetryableDbError(error: unknown): error is DbError;
 /** Whether `error` is a `DbError` with code `CONFLICT` (unique / primary-key violation). */
 declare function isConflict(error: unknown): error is DbError;
+/**
+ * The error an adapter throws for an engine unique / foreign-key violation
+ * (since 0.1.165): `CONFLICT` (unique, primary key, blocked delete) or
+ * `FK_VIOLATION`, carrying the engine's `raw` text and whatever `hint` the
+ * engine gave. The table layer rewrites it into one entry per logical field
+ * of the violated constraint, with `code` / `params` and the raw text in
+ * `details`.
+ */
+declare function constraintViolation(code: "CONFLICT" | "FK_VIOLATION", hint: TDbConstraintHint, raw: string): DbError;
 /**
  * Collapses the failures of a multi-step shutdown into one `AggregateError`
  * (message lists every failure).
@@ -125,4 +181,4 @@ declare function bucketTimeZoneUnavailable(message: string): DbError;
  */
 declare function aggregateExpressionsNotSupported(): DbError;
 //#endregion
-export { aggregateExpressionsNotSupported as a, isConflict as c, DbErrorCode as i, isRetryableDbError as l, CasMismatchError as n, aggregateFailure as o, DbError as r, bucketTimeZoneUnavailable as s, CasExhaustedError as t };
+export { TDbConstraintHint as a, aggregateExpressionsNotSupported as c, constraintViolation as d, isConflict as f, DbErrorCode as i, aggregateFailure as l, CasMismatchError as n, TDbErrorEntry as o, isRetryableDbError as p, DbError as r, TDbErrorEntryCode as s, CasExhaustedError as t, bucketTimeZoneUnavailable as u };

package/dist/{db-error-B_DRL1E9.d.mts → db-error-DQUw2cED.d.mts}

@@ -50,17 +50,64 @@ type DbErrorCode = "CONFLICT" | "FK_VIOLATION" | "NOT_FOUND" | "CASCADE_CYCLE" |
  * `isolationLevels()` lacks it.
  */
 | "ISOLATION_NOT_SUPPORTED";
+/**
+ * Per-entry reasons of a constraint violation (since 0.1.165), stable
+ * UPPER_SNAKE keys a client can translate (with {@link TDbErrorEntry.params}):
+ * - `UNIQUE` — a unique key (or the primary key) already holds the value;
+ *   params `{ index, fields }` (`index` is the declared unique-index name, or
+ *   `"primaryKey"`);
+ * - `FK_MISSING` — a foreign key names a row that does not exist; params
+ *   `{ fields, target }` (+ `ambiguous: true` when the engine could not tell
+ *   which foreign key failed and every one is listed);
+ * - `FK_RESTRICT` — a delete is blocked by referencing rows; params
+ *   `{ table, referencedBy? }`.
+ */
+type TDbErrorEntryCode = "UNIQUE" | "FK_MISSING" | "FK_RESTRICT";
+/** One entry of {@link DbError.errors}. */
+interface TDbErrorEntry {
+  /** Logical field path the entry is about (`""` when it concerns the whole row / table). */
+  path: string;
+  /** Human-readable English message. */
+  message: string;
+  /**
+   * Machine-readable reason of this entry (since 0.1.165) — see
+   * {@link TDbErrorEntryCode}. Absent on entries whose reason is the
+   * error's own {@link DbError.code}.
+   */
+  code?: TDbErrorEntryCode | (string & {});
+  /** The values {@link message} names, for rendering it in another language (since 0.1.165). */
+  params?: Record<string, unknown>;
+  /**
+   * The engine's raw text, kept for logs when the message was normalized
+   * (since 0.1.165). Never sent to HTTP clients.
+   */
+  details?: string;
+}
+/**
+ * What an adapter could tell about a violated constraint (since 0.1.165) —
+ * the core resolves it against the table's metadata into logical paths
+ * (see {@link constraintViolation}). Physical names throughout.
+ */
+interface TDbConstraintHint {
+  /** The violated columns, when the engine names them. */
+  columns?: readonly string[];
+  /** The violated constraint / index name, when the engine names it. */
+  name?: string;
+  /** On a blocked delete: the table holding the referencing rows. */
+  referencedBy?: string;
+  /** The violation is the primary key's. */
+  primaryKey?: boolean;
+}
 declare class DbError extends Error {
   readonly code: DbErrorCode;
-  readonly errors: Array<{
-    path: string;
-    message: string;
-  }>;
+  readonly errors: TDbErrorEntry[];
   name: string;
-  constructor(code: DbErrorCode, errors: Array<{
-    path: string;
-    message: string;
-  }>, message?: string);
+  /**
+   * Set by {@link constraintViolation}: what the adapter could tell about the
+   * violated constraint, for the table layer to normalize. @internal
+   */
+  hint?: TDbConstraintHint;
+  constructor(code: DbErrorCode, errors: TDbErrorEntry[], message?: string);
   /**
    * `true` when retrying the whole transaction may succeed — a transient
    * concurrency condition (`DEADLOCK`, `LOCK_TIMEOUT`,
@@ -77,6 +124,15 @@ declare class DbError extends Error {
 declare function isRetryableDbError(error: unknown): error is DbError;
 /** Whether `error` is a `DbError` with code `CONFLICT` (unique / primary-key violation). */
 declare function isConflict(error: unknown): error is DbError;
+/**
+ * The error an adapter throws for an engine unique / foreign-key violation
+ * (since 0.1.165): `CONFLICT` (unique, primary key, blocked delete) or
+ * `FK_VIOLATION`, carrying the engine's `raw` text and whatever `hint` the
+ * engine gave. The table layer rewrites it into one entry per logical field
+ * of the violated constraint, with `code` / `params` and the raw text in
+ * `details`.
+ */
+declare function constraintViolation(code: "CONFLICT" | "FK_VIOLATION", hint: TDbConstraintHint, raw: string): DbError;
 /**
  * Collapses the failures of a multi-step shutdown into one `AggregateError`
  * (message lists every failure).
@@ -125,4 +181,4 @@ declare function bucketTimeZoneUnavailable(message: string): DbError;
  */
 declare function aggregateExpressionsNotSupported(): DbError;
 //#endregion
-export { aggregateExpressionsNotSupported as a, isConflict as c, DbErrorCode as i, isRetryableDbError as l, CasMismatchError as n, aggregateFailure as o, DbError as r, bucketTimeZoneUnavailable as s, CasExhaustedError as t };
+export { TDbConstraintHint as a, aggregateExpressionsNotSupported as c, constraintViolation as d, isConflict as f, DbErrorCode as i, aggregateFailure as l, CasMismatchError as n, TDbErrorEntry as o, isRetryableDbError as p, DbError as r, TDbErrorEntryCode as s, CasExhaustedError as t, bucketTimeZoneUnavailable as u };

package/dist/{db-error-DmF1_xrz.cjs → db-error-G3sgvL87.cjs}

@@ -9,6 +9,11 @@ var DbError = class extends Error {
 	code;
 	errors;
 	name = "DbError";
+	/**
+	* Set by {@link constraintViolation}: what the adapter could tell about the
+	* violated constraint, for the table layer to normalize. @internal
+	*/
+	hint;
 	constructor(code, errors, message) {
 		super(message ?? errors[0]?.message ?? "Database error");
 		this.code = code;
@@ -37,6 +42,23 @@ function isRetryableDbError(error) {
 function isConflict(error) {
 	return error instanceof DbError && error.code === "CONFLICT";
 }
+/**
+* The error an adapter throws for an engine unique / foreign-key violation
+* (since 0.1.165): `CONFLICT` (unique, primary key, blocked delete) or
+* `FK_VIOLATION`, carrying the engine's `raw` text and whatever `hint` the
+* engine gave. The table layer rewrites it into one entry per logical field
+* of the violated constraint, with `code` / `params` and the raw text in
+* `details`.
+*/
+function constraintViolation(code, hint, raw) {
+	const error = new DbError(code, [{
+		path: hint.columns?.[0] ?? "",
+		message: raw,
+		details: raw
+	}]);
+	error.hint = hint;
+	return error;
+}
 /** @internal An `INVALID_QUERY` error with a single `{ path, message }` entry. */
 function invalidQuery(path, message) {
 	return new DbError("INVALID_QUERY", [{
@@ -187,6 +209,12 @@ Object.defineProperty(exports, "bucketTimeZoneUnavailable", {
 		return bucketTimeZoneUnavailable;
 	}
 });
+Object.defineProperty(exports, "constraintViolation", {
+	enumerable: true,
+	get: function() {
+		return constraintViolation;
+	}
+});
 Object.defineProperty(exports, "invalidQuery", {
 	enumerable: true,
 	get: function() {

package/dist/{fk-diff-BNGawZi9.d.cts → fk-diff-DSM7O7hs.d.cts}

@@ -1,4 +1,4 @@
-import { B as TDbCollation, Bn as AtscriptDbReadable, Et as TExistingTableOption, G as TDbFieldMeta, H as TDbDefaultValue, K as TDbForeignKey, On as AtscriptQueryFieldRef, St as TDerivedColumn, V as TDbDefaultFn, dt as TDbStorageType, j as TColumnDiff, kn as AtscriptQueryNode, wt as TExistingColumn, yn as AtscriptDbView } from "./buckets-B8UOod-v.cjs";
+import { B as TDbCollation, Et as TExistingTableOption, G as TDbFieldMeta, H as TDbDefaultValue, K as TDbForeignKey, Mn as AtscriptQueryNode, Sn as AtscriptDbView, St as TDerivedColumn, V as TDbDefaultFn, Wn as AtscriptDbReadable, dt as TDbStorageType, j as TColumnDiff, jn as AtscriptQueryFieldRef, wt as TExistingColumn } from "./buckets-BDxKfCNo.cjs";
 
 //#region src/schema/schema-hash.d.ts
 interface TFieldSnapshot {

package/dist/{fk-diff-rj9N2QLw.d.mts → fk-diff-Dapr5Dk-.d.mts}

@@ -1,4 +1,4 @@
-import { B as TDbCollation, Bn as AtscriptDbReadable, Et as TExistingTableOption, G as TDbFieldMeta, H as TDbDefaultValue, K as TDbForeignKey, On as AtscriptQueryFieldRef, St as TDerivedColumn, V as TDbDefaultFn, dt as TDbStorageType, j as TColumnDiff, kn as AtscriptQueryNode, wt as TExistingColumn, yn as AtscriptDbView } from "./buckets-CHyspjYP.mjs";
+import { B as TDbCollation, Et as TExistingTableOption, G as TDbFieldMeta, H as TDbDefaultValue, K as TDbForeignKey, Mn as AtscriptQueryNode, Sn as AtscriptDbView, St as TDerivedColumn, V as TDbDefaultFn, Wn as AtscriptDbReadable, dt as TDbStorageType, j as TColumnDiff, jn as AtscriptQueryFieldRef, wt as TExistingColumn } from "./buckets-CHUgky8T.mjs";
 
 //#region src/schema/schema-hash.d.ts
 interface TFieldSnapshot {

package/dist/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_db_error = require("./db-error-DmF1_xrz.cjs");
-const require_column_diff = require("./column-diff-BIGX3sRH.cjs");
-const require_aggregate_fns = require("./aggregate-fns-DupYzFD7.cjs");
-const require_nested_writer = require("./nested-writer-yCy6wGuN.cjs");
-const require_validator = require("./validator-DK9Ijpo7.cjs");
+const require_column_diff = require("./column-diff-DjeUj9kb.cjs");
+const require_db_error = require("./db-error-G3sgvL87.cjs");
+const require_aggregate_fns = require("./aggregate-fns-CNtrSxGH.cjs");
+const require_nested_writer = require("./nested-writer-DOvdbYG-.cjs");
+const require_validator = require("./validator-D7E7T0Oy.cjs");
 const require_server_stamped = require("./server-stamped-B6XbUQ4p.cjs");
 const require_search_fields = require("./search-fields-B49-RCWd.cjs");
 const require_object = require("./object-GjsuPNqo.cjs");
@@ -534,7 +534,7 @@ var DbSpace = class {
 		return target;
 	}
 	_scanFkLookupTarget(tableName) {
-		for (const table of this._allTables) if (table.tableName === tableName) return { count: (filter) => table.count({ filter }) };
+		for (const table of this._allTables) if (table.tableName === tableName) return require_column_diff.fkLookupTargetOf(table);
 	}
 };
 if (typeof Symbol.asyncDispose === "symbol") DbSpace.prototype[Symbol.asyncDispose] = function() {
@@ -545,12 +545,14 @@ if (typeof Symbol.asyncDispose === "symbol") DbSpace.prototype[Symbol.asyncDispo
 /**
 * Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
 * whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
-* A `@db.alias` type is not one, and neither is a plain `export type X = Table`
-* or a field typed with a table (`customer: Customer`) — since 0.1.141 the
-* entity annotations stay on the declaring interface instead of travelling
-* with every reference.
+* A `@db.alias` type is not one, and neither is a field typed with a table
+* (`customer: Customer`) — since 0.1.141 the entity annotations stay on the
+* declaring interface instead of travelling with every reference. A plain
+* `export type X = Table` is `Table` itself (@atscript/typescript 0.2), so it
+* passes.
 *
-* Filters a module namespace before a sync:
+* Filters a module namespace before a sync (a type listed under two export
+* names is synced once):
 * `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
 * @since 0.1.141
 */
@@ -625,6 +627,7 @@ Object.defineProperty(exports, "computeInsights", {
 		return _uniqu_core.computeInsights;
 	}
 });
+exports.constraintViolation = require_db_error.constraintViolation;
 exports.containsRelationFilter = require_nested_writer.containsRelationFilter;
 exports.createChangeRecorder = require_column_diff.createChangeRecorder;
 exports.createDbValidatorPlugin = require_validator.createDbValidatorPlugin;
@@ -682,6 +685,7 @@ exports.isVersionExemptPatch = require_column_diff.isVersionExemptPatch;
 exports.isViewType = require_column_diff.isViewType;
 exports.jsonValueAncestor = require_column_diff.jsonValueAncestor;
 exports.narrowerFilterOps = require_column_diff.narrowerFilterOps;
+exports.nestDottedWith = require_column_diff.nestDottedWith;
 exports.normalizeComputedSelect = require_column_diff.normalizeComputedSelect;
 exports.numericOperandProblem = require_column_diff.numericOperandProblem;
 exports.queryReadColumns = queryReadColumns;
@@ -689,12 +693,14 @@ exports.reconcileCas = require_ops.reconcileCas;
 exports.relationStaticFilter = require_nested_writer.relationStaticFilter;
 exports.resolveCalendarBuckets = require_column_diff.resolveCalendarBuckets;
 exports.resolveDesignType = require_column_diff.resolveDesignType;
+exports.resolveFulltextIndex = require_column_diff.resolveFulltextIndex;
 exports.searchIndexNotFoundMessage = require_column_diff.searchIndexNotFoundMessage;
 exports.searchMemberKind = require_search_fields.searchMemberKind;
 exports.searchTermInteger = require_column_diff.searchTermInteger;
 exports.selfOrAncestor = require_object.selfOrAncestor;
 exports.separateCas = require_ops.separateCas;
 exports.separateFieldOps = require_ops.separateFieldOps;
+exports.soleUnionMember = require_validator.soleUnionMember;
 exports.sortFieldNames = require_column_diff.sortFieldNames;
 exports.splitFulltextFields = require_column_diff.splitFulltextFields;
 exports.stableJson = require_object.stableJson;

package/dist/index.d.cts

@@ -1,14 +1,14 @@
-import { $ as TDbInsertManyIgnoreResult, $n as hasRelationOp, $t as TWriteOptions, A as TCascadeTarget, An as AtscriptRef, At as TForeignKeyChange, B as TDbCollation, Bn as AtscriptDbReadable, Bt as TReadLockOptions, C as NavPropsOf, Cn as TViewReadPlan, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as AtscriptQueryComparison, Dt as TFieldMeta, E as OwnPropsOf, En as AtscriptOrderItem, Et as TExistingTableOption, F as TDbActionIntent, Fn as translateQueryTree, Ft as TInsertOptions, G as TDbFieldMeta, Gn as ResolvedRelationFilter, Gt as TSyncColumnResult, H as TDbDefaultValue, Hn as resolveDesignType, Ht as TRelationInfo, I as TDbActionLevel, In as AtscriptDbTable, It as TJsonCopyTarget, J as TDbIndexField, Jn as TRelationFilterTable, Jt as TTableResolver, K as TDbForeignKey, Kn as TRelGuardState, Kt as TSyncIndexesOptions, L as TDbActionProcessor, Ln as IntegrityStrategy, Lt as TMetaResponse, M as TCrudOp, Mn as TViewPlan, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as evaluateExpr, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptQueryFieldRef, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as isFieldRef, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as forEachResolvedRelation, Qt as TViewJsonType, R as TDbActionTargetSummary, Rn as NativeIntegrity, Rt as TMetadataOverrides, S as FlatOf, Sn as isViewType, St as TDerivedColumn, T as NullsPlacement, Tn as AtscriptExprNode, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as REL_FILTER_MAX_DEPTH, Ut as TRowResolveOptions, V as TDbDefaultFn, Vn as DbResponse, Vt as TReferencingForeignKey, W as TDbDeleteResult, Wn as REL_FILTER_MAX_NODES, Wt as TSearchIndexInfo, X as TDbInsertIgnoreOptions, Xn as andFilters, Xt as TTransactionOptions, Y as TDbIndexType, Yn as TRelationStaticFilter, Yt as TTouchManyOptions, Z as TDbInsertIgnoreResult, Zn as containsRelationFilter, Zt as TValueFormatterPair, _ as DbPatch, _n as TAdapterFactory, _t as TDbWriteGuard, a as isJsonValueField, an as TableMetadata, ar as FieldMappingStrategy, at as TDbObjectKind, b as FieldOpsFor, bn as TViewColumnMapping, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as TPathPresence, cr as TGenericLogger, ct as TDbRelation, d as AggregateFn, dn as ALL_VIEW_CAPABILITIES, dr as TRowOrderKey, dt as TDbStorageType, en as TWriteTableResolver, er as isResolvedRelationFilter, et as TDbInsertManyResult, f as AggregateQuery, fn as BaseDbAdapter, fr as UniquSelect, ft as TDbUpdateOptions, g as DbControls, gn as DbSpace, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as TViewCapability, ht as TDbWriteCheck, i as isBucketableField, in as WithRelation, ir as DocumentFieldMapper, it as TDbLockWait, j as TColumnDiff, jn as TViewJoin, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptQueryNode, kt as TFkLookupTarget, l as AggregateControls, ln as ALL_BUCKET_UNITS, lr as TExprAggregate, lt as TDbRemoveGuard, mn as TIndexDiffOptions, mt as TDbWriteAction, n as TComputedSelect, nn as Uniquery, nr as DbEncryption, nt as TDbIsolationLevel, o as jsonValueAncestor, on as isGeoIndexableType, or as TReadControls, ot as TDbReadLock, p as AggregateResult, pn as TForeignKeyDiffOptions, pt as TDbUpdateResult, q as TDbIndex, qn as TRelationFilterJunction, qt as TTableOptionDiff, r as TResolvedBucket, rn as UniqueryControls, rr as TDbEncryptionOptions, rt as TDbLockMode, s as normalizeComputedSelect, sn as isGeoPointType, sr as NoopLogger, st as TDbReferentialAction, t as TBucketFieldSource, tn as TypedWithRelation, tr as relationStaticFilter, tt as TDbInsertResult, u as AggregateExpr, un as ALL_ISOLATION_LEVELS, ur as TFirstLast, ut as TDbRemoveGuardContext, v as DbQuery, vn as TDbSpaceOptions, vt as TDbWriteGuardContext, w as NullableOptional, wn as aliasTargetOf, wt as TExistingColumn, x as FilterExpr, xn as isAtscriptDbView, xt as TDerivedChangeReason, y as DbRow, yn as AtscriptDbView, yt as TDbWriteLimit, z as TDbAvailableActions, zn as TCascadePin, zt as TPrimaryKeyChange } from "./buckets-B8UOod-v.cjs";
-import { a as aggregateExpressionsNotSupported, c as isConflict, i as DbErrorCode, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-B_DRL1E9.cjs";
+import { $ as TDbInsertManyIgnoreResult, $n as TRelationStaticFilter, $t as TValueFormatterPair, A as TCascadeTarget, An as AtscriptQueryComparison, At as TForeignKeyChange, B as TDbCollation, Bn as MutationFilter, Bt as TPrimaryKeyChange, C as NavPropsOf, Cn as TViewColumnMapping, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as aliasTargetOf, Dt as TFieldMeta, E as OwnPropsOf, En as TViewReadPlan, Et as TExistingTableOption, F as TDbActionIntent, Fn as TViewPlan, Ft as TInsertOneOptions, G as TDbFieldMeta, Gn as DbResponse, Gt as TSearchIndexInfo, H as TDbDefaultValue, Hn as NativeIntegrity, Ht as TReferencingForeignKey, I as TDbActionLevel, In as evaluateExpr, It as TInsertOptions, J as TDbIndexField, Jn as REL_FILTER_MAX_NODES, Jt as TTableOptionDiff, K as TDbForeignKey, Kn as resolveDesignType, Kt as TSyncColumnResult, L as TDbActionProcessor, Ln as isFieldRef, Lt as TJsonCopyTarget, M as TCrudOp, Mn as AtscriptQueryNode, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as AtscriptRef, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptExprNode, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as TViewJoin, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as TRelationFilterTable, Qt as TValidateRowsError, R as TDbActionTargetSummary, Rn as translateQueryTree, Rt as TMetaResponse, S as FlatOf, Sn as AtscriptDbView, St as TDerivedColumn, T as NullsPlacement, Tn as isViewType, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as TCascadePin, Ut as TRelationInfo, V as TDbDefaultFn, Vn as IntegrityStrategy, Vt as TReadLockOptions, W as TDbDeleteResult, Wn as AtscriptDbReadable, Wt as TRowResolveOptions, X as TDbInsertIgnoreOptions, Xn as TRelGuardState, Xt as TTouchManyOptions, Y as TDbIndexType, Yn as ResolvedRelationFilter, Yt as TTableResolver, Z as TDbInsertIgnoreResult, Zn as TRelationFilterJunction, Zt as TTransactionOptions, _ as DbPatch, _n as TIndexDiffOptions, _t as TDbWriteGuard, a as isJsonValueField, an as UniqueryControls, ar as relationStaticFilter, at as TDbObjectKind, b as FieldOpsFor, bn as TAdapterFactory, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as isGeoIndexableType, cr as DocumentFieldMapper, ct as TDbRelation, d as AggregateFn, dn as soleUnionMember, dr as NoopLogger, dt as TDbStorageType, en as TViewJsonType, er as andFilters, et as TDbInsertManyResult, f as AggregateQuery, fn as ALL_BUCKET_UNITS, fr as TGenericLogger, ft as TDbUpdateOptions, g as DbControls, gn as TForeignKeyDiffOptions, gr as UniquSelect, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as BaseDbAdapter, hr as TRowOrderKey, ht as TDbWriteCheck, i as isBucketableField, in as Uniquery, ir as isResolvedRelationFilter, it as TDbLockWait, j as TColumnDiff, jn as AtscriptQueryFieldRef, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptOrderItem, kt as TFkLookupTarget, l as AggregateControls, ln as isGeoPointType, lr as FieldMappingStrategy, lt as TDbRemoveGuard, mn as ALL_VIEW_CAPABILITIES, mr as TFirstLast, mt as TDbWriteAction, n as TComputedSelect, nn as TWriteTableResolver, nr as forEachResolvedRelation, nt as TDbIsolationLevel, o as jsonValueAncestor, on as WithRelation, or as DbEncryption, ot as TDbReadLock, p as AggregateResult, pn as ALL_ISOLATION_LEVELS, pr as TExprAggregate, pt as TDbUpdateResult, q as TDbIndex, qn as REL_FILTER_MAX_DEPTH, qt as TSyncIndexesOptions, r as TResolvedBucket, rn as TypedWithRelation, rr as hasRelationOp, rt as TDbLockMode, s as normalizeComputedSelect, sn as TableMetadata, sr as TDbEncryptionOptions, st as TDbReferentialAction, t as TBucketFieldSource, tn as TWriteOptions, tr as containsRelationFilter, tt as TDbInsertResult, u as AggregateExpr, un as TPathPresence, ur as TReadControls, ut as TDbRemoveGuardContext, v as DbQuery, vn as TViewCapability, vt as TDbWriteGuardContext, w as NullableOptional, wn as isAtscriptDbView, wt as TExistingColumn, x as FilterExpr, xn as TDbSpaceOptions, xt as TDerivedChangeReason, y as DbRow, yn as DbSpace, yt as TDbWriteLimit, z as TDbAvailableActions, zn as AtscriptDbTable, zt as TMetadataOverrides } from "./buckets-BDxKfCNo.cjs";
+import { a as TDbConstraintHint, c as aggregateExpressionsNotSupported, d as constraintViolation, f as isConflict, i as DbErrorCode, l as aggregateFailure, n as CasMismatchError, o as TDbErrorEntry, p as isRetryableDbError, r as DbError, s as TDbErrorEntryCode, t as CasExhaustedError, u as bucketTimeZoneUnavailable } from "./db-error-DQUw2cED.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, s as stableJson, t as deletePath } from "./object-Czia_qD4.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 { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-wRqMYNBI.cjs";
 import { a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, l as SERVER_STAMPED_ON_UPDATE_KEYS, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isServerStampedOnUpdate } from "./validator-DX97RzC2.cjs";
 import { i as searchMemberKind, r as TSearchMemberKind } from "./search-fields-CHqqcC3W.cjs";
-import { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-BNGawZi9.cjs";
-import { i as tableNameOf } from "./relation-helpers-DloMywNs.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 { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-DSM7O7hs.cjs";
+import { i as tableNameOf } from "./relation-helpers-C4UNWYQu.cjs";
+import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, WithRelation as WithRelation$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 import { AtscriptExprNode as AtscriptExprNode$1, TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/shared/consts.d.ts
@@ -558,6 +558,30 @@ declare function describeFulltext(index: Pick<TDbIndex, "fields">, textLabel: (n
  * integer members only answers exact-number terms).
  */
 declare function defaultFulltextIndex<T extends Pick<TDbIndex, "fields">>(indexes: readonly T[]): T | undefined;
+/**
+ * The fulltext index a search names (since 0.1.165): the one DECLARED with
+ * that name (`@db.index.fulltext 'name'`), else the one whose internal key
+ * (`atscript__fulltext__<name>`) it is — a deprecated alias kept for callers
+ * that copied the key from an older `getSearchIndexes()`. `undefined` when
+ * none matches; a search naming no index uses {@link defaultFulltextIndex}.
+ */
+declare function resolveFulltextIndex<T extends Pick<TDbIndex, "name" | "key">>(indexes: readonly T[], indexName: string): T | undefined;
+//#endregion
+//#region src/shared/with-nesting.d.ts
+/**
+ * Rewrites dotted `$with` names into nesting (since 0.1.165):
+ * `{ name: "a.b", filter, controls }` becomes
+ * `{ name: "a", controls: { $with: [{ name: "b", filter, controls }] } }`,
+ * at every depth. Entries naming the same relation at one level are merged
+ * into one — the first one's `filter` / `controls` win, the nested `$with`
+ * lists are concatenated — so `$with=a($select=x),a.b` loads `a` once with
+ * `b` nested in it. Before, a dotted name was silently skipped.
+ *
+ * Returns the input array itself when no entry at any level is dotted or a
+ * string (the common case allocates nothing). String entries (`"a"`, `"a.b"`
+ * — the shorthand the `$with` type admits) are read as `{ name }`.
+ */
+declare function nestDottedWith<T extends WithRelation$1 | string>(withRelations: readonly T[]): T[];
 //#endregion
 //#region src/query/read-columns.d.ts
 /**
@@ -645,12 +669,14 @@ declare function isVersionExemptPatch(data: Record<string, unknown>, table: Atsc
 /**
  * Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
  * whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
- * A `@db.alias` type is not one, and neither is a plain `export type X = Table`
- * or a field typed with a table (`customer: Customer`) — since 0.1.141 the
- * entity annotations stay on the declaring interface instead of travelling
- * with every reference.
- *
- * Filters a module namespace before a sync:
+ * A `@db.alias` type is not one, and neither is a field typed with a table
+ * (`customer: Customer`) — since 0.1.141 the entity annotations stay on the
+ * declaring interface instead of travelling with every reference. A plain
+ * `export type X = Table` is `Table` itself (@atscript/typescript 0.2), so it
+ * passes.
+ *
+ * Filters a module namespace before a sync (a type listed under two export
+ * names is synced once):
  * `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
  * @since 0.1.141
  */
@@ -695,4 +721,4 @@ declare function createChangeRecorder<C>(dryRun: boolean, attempt?: (label: stri
  */
 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_ISOLATION_LEVELS, 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, SERVER_STAMPED_ON_UPDATE_KEYS, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, 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 TDbDeleteManyOptions, 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 TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, 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 TDbWriteLimit, 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 TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, 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 TReadLockOptions, 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 TTransactionOptions, 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, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, 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, isServerStampedOnUpdate, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, stableJson, 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_ISOLATION_LEVELS, 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, type MutationFilter, 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, SERVER_STAMPED_ON_UPDATE_KEYS, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, 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 TDbConstraintHint, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteManyOptions, type TDbDeleteResult, type TDbEncryptionOptions, type TDbErrorEntry, type TDbErrorEntryCode, 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 TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, 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 TDbWriteLimit, 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 TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, type TInsertOneOptions, 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 TReadLockOptions, 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 TTransactionOptions, type TValidateRowsError, 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, constraintViolation, containsRelationFilter, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, 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, isServerStampedOnUpdate, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, nestDottedWith, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, resolveFulltextIndex, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, soleUnionMember, sortFieldNames, splitFulltextFields, stableJson, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,15 +1,15 @@
-import { $ as TDbInsertManyIgnoreResult, $n as hasRelationOp, $t as TWriteOptions, A as TCascadeTarget, An as AtscriptRef, At as TForeignKeyChange, B as TDbCollation, Bn as AtscriptDbReadable, Bt as TReadLockOptions, C as NavPropsOf, Cn as TViewReadPlan, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as AtscriptQueryComparison, Dt as TFieldMeta, E as OwnPropsOf, En as AtscriptOrderItem, Et as TExistingTableOption, F as TDbActionIntent, Fn as translateQueryTree, Ft as TInsertOptions, G as TDbFieldMeta, Gn as ResolvedRelationFilter, Gt as TSyncColumnResult, H as TDbDefaultValue, Hn as resolveDesignType, Ht as TRelationInfo, I as TDbActionLevel, In as AtscriptDbTable, It as TJsonCopyTarget, J as TDbIndexField, Jn as TRelationFilterTable, Jt as TTableResolver, K as TDbForeignKey, Kn as TRelGuardState, Kt as TSyncIndexesOptions, L as TDbActionProcessor, Ln as IntegrityStrategy, Lt as TMetaResponse, M as TCrudOp, Mn as TViewPlan, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as evaluateExpr, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptQueryFieldRef, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as isFieldRef, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as forEachResolvedRelation, Qt as TViewJsonType, R as TDbActionTargetSummary, Rn as NativeIntegrity, Rt as TMetadataOverrides, S as FlatOf, Sn as isViewType, St as TDerivedColumn, T as NullsPlacement, Tn as AtscriptExprNode, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as REL_FILTER_MAX_DEPTH, Ut as TRowResolveOptions, V as TDbDefaultFn, Vn as DbResponse, Vt as TReferencingForeignKey, W as TDbDeleteResult, Wn as REL_FILTER_MAX_NODES, Wt as TSearchIndexInfo, X as TDbInsertIgnoreOptions, Xn as andFilters, Xt as TTransactionOptions, Y as TDbIndexType, Yn as TRelationStaticFilter, Yt as TTouchManyOptions, Z as TDbInsertIgnoreResult, Zn as containsRelationFilter, Zt as TValueFormatterPair, _ as DbPatch, _n as TAdapterFactory, _t as TDbWriteGuard, a as isJsonValueField, an as TableMetadata, ar as FieldMappingStrategy, at as TDbObjectKind, b as FieldOpsFor, bn as TViewColumnMapping, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as TPathPresence, cr as TGenericLogger, ct as TDbRelation, d as AggregateFn, dn as ALL_VIEW_CAPABILITIES, dr as TRowOrderKey, dt as TDbStorageType, en as TWriteTableResolver, er as isResolvedRelationFilter, et as TDbInsertManyResult, f as AggregateQuery, fn as BaseDbAdapter, fr as UniquSelect, ft as TDbUpdateOptions, g as DbControls, gn as DbSpace, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as TViewCapability, ht as TDbWriteCheck, i as isBucketableField, in as WithRelation, ir as DocumentFieldMapper, it as TDbLockWait, j as TColumnDiff, jn as TViewJoin, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptQueryNode, kt as TFkLookupTarget, l as AggregateControls, ln as ALL_BUCKET_UNITS, lr as TExprAggregate, lt as TDbRemoveGuard, mn as TIndexDiffOptions, mt as TDbWriteAction, n as TComputedSelect, nn as Uniquery, nr as DbEncryption, nt as TDbIsolationLevel, o as jsonValueAncestor, on as isGeoIndexableType, or as TReadControls, ot as TDbReadLock, p as AggregateResult, pn as TForeignKeyDiffOptions, pt as TDbUpdateResult, q as TDbIndex, qn as TRelationFilterJunction, qt as TTableOptionDiff, r as TResolvedBucket, rn as UniqueryControls, rr as TDbEncryptionOptions, rt as TDbLockMode, s as normalizeComputedSelect, sn as isGeoPointType, sr as NoopLogger, st as TDbReferentialAction, t as TBucketFieldSource, tn as TypedWithRelation, tr as relationStaticFilter, tt as TDbInsertResult, u as AggregateExpr, un as ALL_ISOLATION_LEVELS, ur as TFirstLast, ut as TDbRemoveGuardContext, v as DbQuery, vn as TDbSpaceOptions, vt as TDbWriteGuardContext, w as NullableOptional, wn as aliasTargetOf, wt as TExistingColumn, x as FilterExpr, xn as isAtscriptDbView, xt as TDerivedChangeReason, y as DbRow, yn as AtscriptDbView, yt as TDbWriteLimit, z as TDbAvailableActions, zn as TCascadePin, zt as TPrimaryKeyChange } from "./buckets-CHyspjYP.mjs";
-import { a as aggregateExpressionsNotSupported, c as isConflict, i as DbErrorCode, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-B_DRL1E9.mjs";
+import { $ as TDbInsertManyIgnoreResult, $n as TRelationStaticFilter, $t as TValueFormatterPair, A as TCascadeTarget, An as AtscriptQueryComparison, At as TForeignKeyChange, B as TDbCollation, Bn as MutationFilter, Bt as TPrimaryKeyChange, C as NavPropsOf, Cn as TViewColumnMapping, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as aliasTargetOf, Dt as TFieldMeta, E as OwnPropsOf, En as TViewReadPlan, Et as TExistingTableOption, F as TDbActionIntent, Fn as TViewPlan, Ft as TInsertOneOptions, G as TDbFieldMeta, Gn as DbResponse, Gt as TSearchIndexInfo, H as TDbDefaultValue, Hn as NativeIntegrity, Ht as TReferencingForeignKey, I as TDbActionLevel, In as evaluateExpr, It as TInsertOptions, J as TDbIndexField, Jn as REL_FILTER_MAX_NODES, Jt as TTableOptionDiff, K as TDbForeignKey, Kn as resolveDesignType, Kt as TSyncColumnResult, L as TDbActionProcessor, Ln as isFieldRef, Lt as TJsonCopyTarget, M as TCrudOp, Mn as AtscriptQueryNode, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as AtscriptRef, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptExprNode, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as TViewJoin, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as TRelationFilterTable, Qt as TValidateRowsError, R as TDbActionTargetSummary, Rn as translateQueryTree, Rt as TMetaResponse, S as FlatOf, Sn as AtscriptDbView, St as TDerivedColumn, T as NullsPlacement, Tn as isViewType, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as TCascadePin, Ut as TRelationInfo, V as TDbDefaultFn, Vn as IntegrityStrategy, Vt as TReadLockOptions, W as TDbDeleteResult, Wn as AtscriptDbReadable, Wt as TRowResolveOptions, X as TDbInsertIgnoreOptions, Xn as TRelGuardState, Xt as TTouchManyOptions, Y as TDbIndexType, Yn as ResolvedRelationFilter, Yt as TTableResolver, Z as TDbInsertIgnoreResult, Zn as TRelationFilterJunction, Zt as TTransactionOptions, _ as DbPatch, _n as TIndexDiffOptions, _t as TDbWriteGuard, a as isJsonValueField, an as UniqueryControls, ar as relationStaticFilter, at as TDbObjectKind, b as FieldOpsFor, bn as TAdapterFactory, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as isGeoIndexableType, cr as DocumentFieldMapper, ct as TDbRelation, d as AggregateFn, dn as soleUnionMember, dr as NoopLogger, dt as TDbStorageType, en as TViewJsonType, er as andFilters, et as TDbInsertManyResult, f as AggregateQuery, fn as ALL_BUCKET_UNITS, fr as TGenericLogger, ft as TDbUpdateOptions, g as DbControls, gn as TForeignKeyDiffOptions, gr as UniquSelect, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as BaseDbAdapter, hr as TRowOrderKey, ht as TDbWriteCheck, i as isBucketableField, in as Uniquery, ir as isResolvedRelationFilter, it as TDbLockWait, j as TColumnDiff, jn as AtscriptQueryFieldRef, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptOrderItem, kt as TFkLookupTarget, l as AggregateControls, ln as isGeoPointType, lr as FieldMappingStrategy, lt as TDbRemoveGuard, mn as ALL_VIEW_CAPABILITIES, mr as TFirstLast, mt as TDbWriteAction, n as TComputedSelect, nn as TWriteTableResolver, nr as forEachResolvedRelation, nt as TDbIsolationLevel, o as jsonValueAncestor, on as WithRelation, or as DbEncryption, ot as TDbReadLock, p as AggregateResult, pn as ALL_ISOLATION_LEVELS, pr as TExprAggregate, pt as TDbUpdateResult, q as TDbIndex, qn as REL_FILTER_MAX_DEPTH, qt as TSyncIndexesOptions, r as TResolvedBucket, rn as TypedWithRelation, rr as hasRelationOp, rt as TDbLockMode, s as normalizeComputedSelect, sn as TableMetadata, sr as TDbEncryptionOptions, st as TDbReferentialAction, t as TBucketFieldSource, tn as TWriteOptions, tr as containsRelationFilter, tt as TDbInsertResult, u as AggregateExpr, un as TPathPresence, ur as TReadControls, ut as TDbRemoveGuardContext, v as DbQuery, vn as TViewCapability, vt as TDbWriteGuardContext, w as NullableOptional, wn as isAtscriptDbView, wt as TExistingColumn, x as FilterExpr, xn as TDbSpaceOptions, xt as TDerivedChangeReason, y as DbRow, yn as DbSpace, yt as TDbWriteLimit, z as TDbAvailableActions, zn as AtscriptDbTable, zt as TMetadataOverrides } from "./buckets-CHUgky8T.mjs";
+import { a as TDbConstraintHint, c as aggregateExpressionsNotSupported, d as constraintViolation, f as isConflict, i as DbErrorCode, l as aggregateFailure, n as CasMismatchError, o as TDbErrorEntry, p as isRetryableDbError, r as DbError, s as TDbErrorEntryCode, t as CasExhaustedError, u as bucketTimeZoneUnavailable } from "./db-error-DQUw2cED.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, s as stableJson, t as deletePath } from "./object-Czia_qD4.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 { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-wRqMYNBI.mjs";
 import { a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, l as SERVER_STAMPED_ON_UPDATE_KEYS, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isServerStampedOnUpdate } from "./validator-DX97RzC2.mjs";
 import { i as searchMemberKind, r as TSearchMemberKind } from "./search-fields-CHqqcC3W.mjs";
-import { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-rj9N2QLw.mjs";
-import { i as tableNameOf } from "./relation-helpers-zwt19E7r.mjs";
+import { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-Dapr5Dk-.mjs";
+import { i as tableNameOf } from "./relation-helpers-hdbuqwjV.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";
+import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, WithRelation as WithRelation$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 
 //#region src/shared/consts.d.ts
 /**
@@ -558,6 +558,30 @@ declare function describeFulltext(index: Pick<TDbIndex, "fields">, textLabel: (n
  * integer members only answers exact-number terms).
  */
 declare function defaultFulltextIndex<T extends Pick<TDbIndex, "fields">>(indexes: readonly T[]): T | undefined;
+/**
+ * The fulltext index a search names (since 0.1.165): the one DECLARED with
+ * that name (`@db.index.fulltext 'name'`), else the one whose internal key
+ * (`atscript__fulltext__<name>`) it is — a deprecated alias kept for callers
+ * that copied the key from an older `getSearchIndexes()`. `undefined` when
+ * none matches; a search naming no index uses {@link defaultFulltextIndex}.
+ */
+declare function resolveFulltextIndex<T extends Pick<TDbIndex, "name" | "key">>(indexes: readonly T[], indexName: string): T | undefined;
+//#endregion
+//#region src/shared/with-nesting.d.ts
+/**
+ * Rewrites dotted `$with` names into nesting (since 0.1.165):
+ * `{ name: "a.b", filter, controls }` becomes
+ * `{ name: "a", controls: { $with: [{ name: "b", filter, controls }] } }`,
+ * at every depth. Entries naming the same relation at one level are merged
+ * into one — the first one's `filter` / `controls` win, the nested `$with`
+ * lists are concatenated — so `$with=a($select=x),a.b` loads `a` once with
+ * `b` nested in it. Before, a dotted name was silently skipped.
+ *
+ * Returns the input array itself when no entry at any level is dotted or a
+ * string (the common case allocates nothing). String entries (`"a"`, `"a.b"`
+ * — the shorthand the `$with` type admits) are read as `{ name }`.
+ */
+declare function nestDottedWith<T extends WithRelation$1 | string>(withRelations: readonly T[]): T[];
 //#endregion
 //#region src/query/read-columns.d.ts
 /**
@@ -645,12 +669,14 @@ declare function isVersionExemptPatch(data: Record<string, unknown>, table: Atsc
 /**
  * Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
  * whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
- * A `@db.alias` type is not one, and neither is a plain `export type X = Table`
- * or a field typed with a table (`customer: Customer`) — since 0.1.141 the
- * entity annotations stay on the declaring interface instead of travelling
- * with every reference.
- *
- * Filters a module namespace before a sync:
+ * A `@db.alias` type is not one, and neither is a field typed with a table
+ * (`customer: Customer`) — since 0.1.141 the entity annotations stay on the
+ * declaring interface instead of travelling with every reference. A plain
+ * `export type X = Table` is `Table` itself (@atscript/typescript 0.2), so it
+ * passes.
+ *
+ * Filters a module namespace before a sync (a type listed under two export
+ * names is synced once):
  * `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
  * @since 0.1.141
  */
@@ -695,4 +721,4 @@ declare function createChangeRecorder<C>(dryRun: boolean, attempt?: (label: stri
  */
 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_ISOLATION_LEVELS, 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, SERVER_STAMPED_ON_UPDATE_KEYS, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, 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 TDbDeleteManyOptions, 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 TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, 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 TDbWriteLimit, 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 TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, 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 TReadLockOptions, 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 TTransactionOptions, 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, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, 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, isServerStampedOnUpdate, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, stableJson, 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_ISOLATION_LEVELS, 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, type MutationFilter, 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, SERVER_STAMPED_ON_UPDATE_KEYS, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, 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 TDbConstraintHint, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteManyOptions, type TDbDeleteResult, type TDbEncryptionOptions, type TDbErrorEntry, type TDbErrorEntryCode, 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 TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, 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 TDbWriteLimit, 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 TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, type TInsertOneOptions, 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 TReadLockOptions, 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 TTransactionOptions, type TValidateRowsError, 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, constraintViolation, containsRelationFilter, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, 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, isServerStampedOnUpdate, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, nestDottedWith, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, resolveFulltextIndex, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, soleUnionMember, sortFieldNames, splitFulltextFields, stableJson, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };