@atscript/db 0.1.129 → 0.1.131

package/dist/agg.cjs

@@ -4,5 +4,36 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 function resolveAlias(expr) {
 	return expr.$as ?? `${expr.$fn}_${expr.$field}`;
 }
+/**
+* Reads the `$search` / `$index` controls of an aggregate query.
+*
+* Search and grouping are orthogonal: `$search` narrows the ROWS, `$groupBy`
+* shapes what is left. Every adapter must therefore apply the search predicate
+* BEFORE grouping, so the groups — and `$count`, which counts them — only ever
+* describe rows that matched. An adapter that silently ignored the term would
+* report totals for rows the same search excludes from the leaf list.
+*
+* Two rules the leaf search path applies and the grouped path must NOT:
+* - **No implicit relevance ordering.** Relevance is a property of a row, not
+*   of a group; after `$group` there is no per-row score left to sort on.
+*   Grouped results order by `$sort` or not at all.
+* - **No implicit row cap.** The leaf runners cap an unbounded search at 1000
+*   rows; applying that before `$group` would silently truncate group counts.
+*
+* Returns `undefined` when there is nothing to search for, so callers fall
+* straight through to the plain grouped path.
+*/
+function resolveAggregateSearch(controls) {
+	const raw = controls?.$search;
+	if (typeof raw !== "string") return;
+	const text = raw.trim();
+	if (!text) return;
+	const index = controls?.$index;
+	return {
+		text,
+		indexName: typeof index === "string" && index ? index : void 0
+	};
+}
 //#endregion
+exports.resolveAggregateSearch = resolveAggregateSearch;
 exports.resolveAlias = resolveAlias;

package/dist/agg.d.cts

@@ -3,5 +3,34 @@ import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, Agg
 //#region src/agg.d.ts
 /** Resolves output alias: $as if provided, otherwise `{fn}_{field}`. */
 declare function resolveAlias(expr: AggregateExpr$1): string;
+/** The text-search request a grouped query carries, once normalised. */
+interface TAggregateSearch {
+  /** Non-empty, trimmed search term. */
+  text: string;
+  /** Named search index to target, when the caller picked one. */
+  indexName?: string;
+}
+/**
+ * Reads the `$search` / `$index` controls of an aggregate query.
+ *
+ * Search and grouping are orthogonal: `$search` narrows the ROWS, `$groupBy`
+ * shapes what is left. Every adapter must therefore apply the search predicate
+ * BEFORE grouping, so the groups — and `$count`, which counts them — only ever
+ * describe rows that matched. An adapter that silently ignored the term would
+ * report totals for rows the same search excludes from the leaf list.
+ *
+ * Two rules the leaf search path applies and the grouped path must NOT:
+ * - **No implicit relevance ordering.** Relevance is a property of a row, not
+ *   of a group; after `$group` there is no per-row score left to sort on.
+ *   Grouped results order by `$sort` or not at all.
+ * - **No implicit row cap.** The leaf runners cap an unbounded search at 1000
+ *   rows; applying that before `$group` would silently truncate group counts.
+ *
+ * Returns `undefined` when there is nothing to search for, so callers fall
+ * straight through to the plain grouped path.
+ */
+declare function resolveAggregateSearch(controls: {
+  [key: `$${string}`]: unknown;
+} | undefined): TAggregateSearch | undefined;
 //#endregion
-export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, resolveAlias };
+export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, resolveAggregateSearch, resolveAlias };

package/dist/agg.d.mts

@@ -3,5 +3,34 @@ import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, Agg
 //#region src/agg.d.ts
 /** Resolves output alias: $as if provided, otherwise `{fn}_{field}`. */
 declare function resolveAlias(expr: AggregateExpr$1): string;
+/** The text-search request a grouped query carries, once normalised. */
+interface TAggregateSearch {
+  /** Non-empty, trimmed search term. */
+  text: string;
+  /** Named search index to target, when the caller picked one. */
+  indexName?: string;
+}
+/**
+ * Reads the `$search` / `$index` controls of an aggregate query.
+ *
+ * Search and grouping are orthogonal: `$search` narrows the ROWS, `$groupBy`
+ * shapes what is left. Every adapter must therefore apply the search predicate
+ * BEFORE grouping, so the groups — and `$count`, which counts them — only ever
+ * describe rows that matched. An adapter that silently ignored the term would
+ * report totals for rows the same search excludes from the leaf list.
+ *
+ * Two rules the leaf search path applies and the grouped path must NOT:
+ * - **No implicit relevance ordering.** Relevance is a property of a row, not
+ *   of a group; after `$group` there is no per-row score left to sort on.
+ *   Grouped results order by `$sort` or not at all.
+ * - **No implicit row cap.** The leaf runners cap an unbounded search at 1000
+ *   rows; applying that before `$group` would silently truncate group counts.
+ *
+ * Returns `undefined` when there is nothing to search for, so callers fall
+ * straight through to the plain grouped path.
+ */
+declare function resolveAggregateSearch(controls: {
+  [key: `$${string}`]: unknown;
+} | undefined): TAggregateSearch | undefined;
 //#endregion
-export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, resolveAlias };
+export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, resolveAggregateSearch, resolveAlias };

package/dist/agg.mjs

@@ -3,5 +3,35 @@
 function resolveAlias(expr) {
 	return expr.$as ?? `${expr.$fn}_${expr.$field}`;
 }
+/**
+* Reads the `$search` / `$index` controls of an aggregate query.
+*
+* Search and grouping are orthogonal: `$search` narrows the ROWS, `$groupBy`
+* shapes what is left. Every adapter must therefore apply the search predicate
+* BEFORE grouping, so the groups — and `$count`, which counts them — only ever
+* describe rows that matched. An adapter that silently ignored the term would
+* report totals for rows the same search excludes from the leaf list.
+*
+* Two rules the leaf search path applies and the grouped path must NOT:
+* - **No implicit relevance ordering.** Relevance is a property of a row, not
+*   of a group; after `$group` there is no per-row score left to sort on.
+*   Grouped results order by `$sort` or not at all.
+* - **No implicit row cap.** The leaf runners cap an unbounded search at 1000
+*   rows; applying that before `$group` would silently truncate group counts.
+*
+* Returns `undefined` when there is nothing to search for, so callers fall
+* straight through to the plain grouped path.
+*/
+function resolveAggregateSearch(controls) {
+	const raw = controls?.$search;
+	if (typeof raw !== "string") return;
+	const text = raw.trim();
+	if (!text) return;
+	const index = controls?.$index;
+	return {
+		text,
+		indexName: typeof index === "string" && index ? index : void 0
+	};
+}
 //#endregion
-export { resolveAlias };
+export { resolveAggregateSearch, resolveAlias };

package/dist/{db-readable-B7eYWS5q.d.cts → db-readable-Cmrg9aLU.d.cts}

@@ -1195,8 +1195,15 @@ declare abstract class BaseDbAdapter {
    */
   getSearchIndexes(): TSearchIndexInfo[];
   /**
-   * Whether this adapter supports text search.
-   * Default: `true` when {@link getSearchIndexes} returns any entries.
+   * Whether this adapter can run TEXT search — `search()`, `searchWithCount()`
+   * and the grouped `$search` path all gate on it. Vector capability is a
+   * separate predicate, {@link isVectorSearchable}.
+   *
+   * Default: `true` when {@link getSearchIndexes} lists at least one non-vector
+   * index. Vector entries are published there for the index picker, but a
+   * vector index answers {@link vectorSearch} and nothing else, so counting one
+   * here would claim a capability the adapter does not have. An entry without
+   * `type` counts as text — adapters predating the field only listed text.
    */
   isSearchable(): boolean;
   /**

package/dist/{db-readable-Bn1bV_eC.d.mts → db-readable-D8aa-wfP.d.mts}

@@ -1195,8 +1195,15 @@ declare abstract class BaseDbAdapter {
    */
   getSearchIndexes(): TSearchIndexInfo[];
   /**
-   * Whether this adapter supports text search.
-   * Default: `true` when {@link getSearchIndexes} returns any entries.
+   * Whether this adapter can run TEXT search — `search()`, `searchWithCount()`
+   * and the grouped `$search` path all gate on it. Vector capability is a
+   * separate predicate, {@link isVectorSearchable}.
+   *
+   * Default: `true` when {@link getSearchIndexes} lists at least one non-vector
+   * index. Vector entries are published there for the index picker, but a
+   * vector index answers {@link vectorSearch} and nothing else, so counting one
+   * here would claim a capability the adapter does not have. An entry without
+   * `type` counts as text — adapters predating the field only listed text.
    */
   isSearchable(): boolean;
   /**

package/dist/{db-space-C2UCnGHd.d.cts → db-space-B4MjNjY4.d.mts}

@@ -1,6 +1,6 @@
-import { C as NullableOptional, Ct as TWriteOptions, E as TCascadeResolver, G as TDbInsertResult, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, W as TDbInsertManyResult, a as TDbEncryptionOptions, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, g as DbPatch, ht as TReferencingForeignKey, i as DbEncryption, kt as TableMetadata, nt as TDeleteOptions, t as AtscriptDbReadable, v as DbRow, wt as TWriteTableResolver, xt as TTouchManyOptions } from "./db-readable-B7eYWS5q.cjs";
-import { FilterExpr } from "@uniqu/core";
+import { C as NullableOptional, Ct as TWriteOptions, E as TCascadeResolver, G as TDbInsertResult, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, W as TDbInsertManyResult, a as TDbEncryptionOptions, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, g as DbPatch, ht as TReferencingForeignKey, i as DbEncryption, kt as TableMetadata, nt as TDeleteOptions, t as AtscriptDbReadable, v as DbRow, wt as TWriteTableResolver, xt as TTouchManyOptions } from "./db-readable-D8aa-wfP.mjs";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { FilterExpr } from "@uniqu/core";
 
 //#region src/strategies/integrity.d.ts
 /**

package/dist/{db-space-DdIPYD0Q.d.mts → db-space-rQFgz3-k.d.cts}

@@ -1,6 +1,6 @@
-import { C as NullableOptional, Ct as TWriteOptions, E as TCascadeResolver, G as TDbInsertResult, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, W as TDbInsertManyResult, a as TDbEncryptionOptions, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, g as DbPatch, ht as TReferencingForeignKey, i as DbEncryption, kt as TableMetadata, nt as TDeleteOptions, t as AtscriptDbReadable, v as DbRow, wt as TWriteTableResolver, xt as TTouchManyOptions } from "./db-readable-Bn1bV_eC.mjs";
-import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { C as NullableOptional, Ct as TWriteOptions, E as TCascadeResolver, G as TDbInsertResult, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, W as TDbInsertManyResult, a as TDbEncryptionOptions, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, g as DbPatch, ht as TReferencingForeignKey, i as DbEncryption, kt as TableMetadata, nt as TDeleteOptions, t as AtscriptDbReadable, v as DbRow, wt as TWriteTableResolver, xt as TTouchManyOptions } from "./db-readable-Cmrg9aLU.cjs";
 import { FilterExpr } from "@uniqu/core";
+import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 
 //#region src/strategies/integrity.d.ts
 /**

package/dist/{db-view-Dl0aDTiT.mjs → db-view-BYH4HJ-U.mjs}

@@ -1027,13 +1027,11 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 		return {
 			filter,
 			controls: {
+				...controls,
 				$groupBy: groupBy,
 				$select: select ? new UniquSelect(select, meta.allPhysicalFields) : void 0,
 				$sort: sort,
-				$having: having,
-				$skip: controls.$skip,
-				$limit: controls.$limit,
-				$count: controls.$count
+				$having: having
 			},
 			insights: query.insights
 		};
@@ -1682,9 +1680,11 @@ var AtscriptDbReadable = class {
 		return this._meta;
 	}
 	_ensureSearchable() {
-		if (!this.adapter.isSearchable()) throw new DbError("INVALID_QUERY", [{
+		if (this.adapter.isSearchable()) return;
+		const hasVectorIndex = this.adapter.getSearchIndexes().some((i) => i.type === "vector");
+		throw new DbError("INVALID_QUERY", [{
 			path: "$search",
-			message: `Table "${this.tableName}" has no search indexes defined`
+			message: `Table "${this.tableName}" has no text search index` + (hasVectorIndex ? " — a @db.search.vector index only answers vectorSearch()" : "")
 		}]);
 	}
 	/** Engine-agnostic query-time guards (encrypted-field refs, $geoWithin shape). */
@@ -2047,6 +2047,11 @@ var AtscriptDbReadable = class {
 				}]);
 			}
 		}
+		const searchTerm = query.controls.$search;
+		if (typeof searchTerm === "string" && searchTerm) {
+			this._ensureSearchable();
+			if (!searchTerm.trim()) return query.controls.$count ? [{ count: 0 }] : [];
+		}
 		guardAggregate(this._meta, this.adapter, query);
 		const dbQuery = this._fieldMapper.translateAggregateQuery(query, this._meta);
 		return (await this.adapter.aggregate(dbQuery)).map((row) => this._fieldMapper.reconstructFromRead(row, this._meta));
@@ -2771,11 +2776,18 @@ var BaseDbAdapter = class {
 		return [];
 	}
 	/**
-	* Whether this adapter supports text search.
-	* Default: `true` when {@link getSearchIndexes} returns any entries.
+	* Whether this adapter can run TEXT search — `search()`, `searchWithCount()`
+	* and the grouped `$search` path all gate on it. Vector capability is a
+	* separate predicate, {@link isVectorSearchable}.
+	*
+	* Default: `true` when {@link getSearchIndexes} lists at least one non-vector
+	* index. Vector entries are published there for the index picker, but a
+	* vector index answers {@link vectorSearch} and nothing else, so counting one
+	* here would claim a capability the adapter does not have. An entry without
+	* `type` counts as text — adapters predating the field only listed text.
 	*/
 	isSearchable() {
-		return this.getSearchIndexes().length > 0;
+		return this.getSearchIndexes().some((index) => index.type !== "vector");
 	}
 	/**
 	* Whether this adapter supports vector similarity search.

package/dist/{db-view-CRBgkEp0.cjs → db-view-DUDnyQ3b.cjs}

@@ -1027,13 +1027,11 @@ var RelationalFieldMapper = class extends FieldMappingStrategy {
 		return {
 			filter,
 			controls: {
+				...controls,
 				$groupBy: groupBy,
 				$select: select ? new UniquSelect(select, meta.allPhysicalFields) : void 0,
 				$sort: sort,
-				$having: having,
-				$skip: controls.$skip,
-				$limit: controls.$limit,
-				$count: controls.$count
+				$having: having
 			},
 			insights: query.insights
 		};
@@ -1682,9 +1680,11 @@ var AtscriptDbReadable = class {
 		return this._meta;
 	}
 	_ensureSearchable() {
-		if (!this.adapter.isSearchable()) throw new require_db_error.DbError("INVALID_QUERY", [{
+		if (this.adapter.isSearchable()) return;
+		const hasVectorIndex = this.adapter.getSearchIndexes().some((i) => i.type === "vector");
+		throw new require_db_error.DbError("INVALID_QUERY", [{
 			path: "$search",
-			message: `Table "${this.tableName}" has no search indexes defined`
+			message: `Table "${this.tableName}" has no text search index` + (hasVectorIndex ? " — a @db.search.vector index only answers vectorSearch()" : "")
 		}]);
 	}
 	/** Engine-agnostic query-time guards (encrypted-field refs, $geoWithin shape). */
@@ -2047,6 +2047,11 @@ var AtscriptDbReadable = class {
 				}]);
 			}
 		}
+		const searchTerm = query.controls.$search;
+		if (typeof searchTerm === "string" && searchTerm) {
+			this._ensureSearchable();
+			if (!searchTerm.trim()) return query.controls.$count ? [{ count: 0 }] : [];
+		}
 		guardAggregate(this._meta, this.adapter, query);
 		const dbQuery = this._fieldMapper.translateAggregateQuery(query, this._meta);
 		return (await this.adapter.aggregate(dbQuery)).map((row) => this._fieldMapper.reconstructFromRead(row, this._meta));
@@ -2771,11 +2776,18 @@ var BaseDbAdapter = class {
 		return [];
 	}
 	/**
-	* Whether this adapter supports text search.
-	* Default: `true` when {@link getSearchIndexes} returns any entries.
+	* Whether this adapter can run TEXT search — `search()`, `searchWithCount()`
+	* and the grouped `$search` path all gate on it. Vector capability is a
+	* separate predicate, {@link isVectorSearchable}.
+	*
+	* Default: `true` when {@link getSearchIndexes} lists at least one non-vector
+	* index. Vector entries are published there for the index picker, but a
+	* vector index answers {@link vectorSearch} and nothing else, so counting one
+	* here would claim a capability the adapter does not have. An entry without
+	* `type` counts as text — adapters predating the field only listed text.
 	*/
 	isSearchable() {
-		return this.getSearchIndexes().length > 0;
+		return this.getSearchIndexes().some((index) => index.type !== "vector");
 	}
 	/**
 	* Whether this adapter supports vector similarity search.

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_db_error = require("./db-error-C4JuLcvb.cjs");
-const require_db_view = require("./db-view-CRBgkEp0.cjs");
+const require_db_view = require("./db-view-DUDnyQ3b.cjs");
 const require_validator = require("./validator-lkCJKuoo.cjs");
 const require_consts = require("./consts-BzRfCcH2.cjs");
 const require_ops = require("./ops.cjs");

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { $ as TDbWriteAction, A as TCrudPermissions, At as findAncestorInSet, B as TDbForeignKey, C as NullableOptional, Ct as TWriteOptions, D as TCascadeTarget, Dt as UniqueryControls, E as TCascadeResolver, Et as Uniquery, F as TDbCollation, Ft as UniquSelect, G as TDbInsertResult, H as TDbIndexField, I as TDbDefaultFn, J as TDbRelation, K as TDbObjectKind, L as TDbDefaultValue, M as TDbActionIntent, Mt as isGeoPointType, N as TDbActionLevel, Nt as NoopLogger, O as TColumnDiff, Ot as WithRelation, P as TDbActionProcessor, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, S as NavPropsOf, St as TValueFormatterPair, T as PrimaryKeyOf, Tt as TypedWithRelation, U as TDbIndexType, V as TDbIndex, W as TDbInsertManyResult, X as TDbRemoveGuardContext, Y as TDbRemoveGuard, Z as TDbStorageType, _ as DbQuery, _t as TSearchIndexInfo, a as TDbEncryptionOptions, at as TExistingForeignKey, b as FilterExpr, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, d as AggregateFn, dt as TIdentification, et as TDbWriteGuard, f as AggregateQuery, ft as TMetaResponse, g as DbPatch, gt as TRelationInfo, h as DbControls, ht as TReferencingForeignKey, i as DbEncryption, it as TExistingColumn, j as TDbActionInfo, jt as isGeoIndexableType, k as TCrudOp, kt as TableMetadata, l as AggregateControls, lt as TFkLookupTarget, m as AtscriptDbWritable, mt as TPrimaryKeyChange, n as DbResponse, nt as TDeleteOptions, o as DocumentFieldMapper, ot as TExistingTableOption, p as AggregateResult, pt as TMetadataOverrides, q as TDbReferentialAction, r as resolveDesignType, rt as TEnsureTableOptions, s as FieldMappingStrategy, st as TFieldMeta, t as AtscriptDbReadable, tt as TDbWriteGuardContext, u as AggregateExpr, ut as TIdDescriptor, v as DbRow, vt as TSyncColumnResult, w as OwnPropsOf, wt as TWriteTableResolver, x as FlatOf, xt as TTouchManyOptions, y as FieldOpsFor, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-B7eYWS5q.cjs";
+import { $ as TDbWriteAction, A as TCrudPermissions, At as findAncestorInSet, B as TDbForeignKey, C as NullableOptional, Ct as TWriteOptions, D as TCascadeTarget, Dt as UniqueryControls, E as TCascadeResolver, Et as Uniquery, F as TDbCollation, Ft as UniquSelect, G as TDbInsertResult, H as TDbIndexField, I as TDbDefaultFn, J as TDbRelation, K as TDbObjectKind, L as TDbDefaultValue, M as TDbActionIntent, Mt as isGeoPointType, N as TDbActionLevel, Nt as NoopLogger, O as TColumnDiff, Ot as WithRelation, P as TDbActionProcessor, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, S as NavPropsOf, St as TValueFormatterPair, T as PrimaryKeyOf, Tt as TypedWithRelation, U as TDbIndexType, V as TDbIndex, W as TDbInsertManyResult, X as TDbRemoveGuardContext, Y as TDbRemoveGuard, Z as TDbStorageType, _ as DbQuery, _t as TSearchIndexInfo, a as TDbEncryptionOptions, at as TExistingForeignKey, b as FilterExpr, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, d as AggregateFn, dt as TIdentification, et as TDbWriteGuard, f as AggregateQuery, ft as TMetaResponse, g as DbPatch, gt as TRelationInfo, h as DbControls, ht as TReferencingForeignKey, i as DbEncryption, it as TExistingColumn, j as TDbActionInfo, jt as isGeoIndexableType, k as TCrudOp, kt as TableMetadata, l as AggregateControls, lt as TFkLookupTarget, m as AtscriptDbWritable, mt as TPrimaryKeyChange, n as DbResponse, nt as TDeleteOptions, o as DocumentFieldMapper, ot as TExistingTableOption, p as AggregateResult, pt as TMetadataOverrides, q as TDbReferentialAction, r as resolveDesignType, rt as TEnsureTableOptions, s as FieldMappingStrategy, st as TFieldMeta, t as AtscriptDbReadable, tt as TDbWriteGuardContext, u as AggregateExpr, ut as TIdDescriptor, v as DbRow, vt as TSyncColumnResult, w as OwnPropsOf, wt as TWriteTableResolver, x as FlatOf, xt as TTouchManyOptions, y as FieldOpsFor, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-Cmrg9aLU.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 TViewColumnMapping, c as AtscriptQueryFieldRef, d as TViewJoin, f as TViewPlan, g as NativeIntegrity, h as IntegrityStrategy, i as AtscriptDbView, l as AtscriptQueryNode, m as AtscriptDbTable, n as TAdapterFactory, o as isAtscriptDbView, p as translateQueryTree, r as TDbSpaceOptions, s as AtscriptQueryComparison, t as DbSpace, u as AtscriptRef } from "./db-space-C2UCnGHd.cjs";
+import { a as TViewColumnMapping, c as AtscriptQueryFieldRef, d as TViewJoin, f as TViewPlan, g as NativeIntegrity, h as IntegrityStrategy, i as AtscriptDbView, l as AtscriptQueryNode, m as AtscriptDbTable, n as TAdapterFactory, o as isAtscriptDbView, p as translateQueryTree, r as TDbSpaceOptions, s as AtscriptQueryComparison, t as DbSpace, u as AtscriptRef } from "./db-space-rQFgz3-k.cjs";
 import { _ as DbErrorCode, a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, g as DbError, h as CasMismatchError, l as isEmptyObject, m as CasExhaustedError, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject } from "./validator-wBARmD68.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as TDbWriteAction, A as TCrudPermissions, At as findAncestorInSet, B as TDbForeignKey, C as NullableOptional, Ct as TWriteOptions, D as TCascadeTarget, Dt as UniqueryControls, E as TCascadeResolver, Et as Uniquery, F as TDbCollation, Ft as UniquSelect, G as TDbInsertResult, H as TDbIndexField, I as TDbDefaultFn, J as TDbRelation, K as TDbObjectKind, L as TDbDefaultValue, M as TDbActionIntent, Mt as isGeoPointType, N as TDbActionLevel, Nt as NoopLogger, O as TColumnDiff, Ot as WithRelation, P as TDbActionProcessor, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, S as NavPropsOf, St as TValueFormatterPair, T as PrimaryKeyOf, Tt as TypedWithRelation, U as TDbIndexType, V as TDbIndex, W as TDbInsertManyResult, X as TDbRemoveGuardContext, Y as TDbRemoveGuard, Z as TDbStorageType, _ as DbQuery, _t as TSearchIndexInfo, a as TDbEncryptionOptions, at as TExistingForeignKey, b as FilterExpr, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, d as AggregateFn, dt as TIdentification, et as TDbWriteGuard, f as AggregateQuery, ft as TMetaResponse, g as DbPatch, gt as TRelationInfo, h as DbControls, ht as TReferencingForeignKey, i as DbEncryption, it as TExistingColumn, j as TDbActionInfo, jt as isGeoIndexableType, k as TCrudOp, kt as TableMetadata, l as AggregateControls, lt as TFkLookupTarget, m as AtscriptDbWritable, mt as TPrimaryKeyChange, n as DbResponse, nt as TDeleteOptions, o as DocumentFieldMapper, ot as TExistingTableOption, p as AggregateResult, pt as TMetadataOverrides, q as TDbReferentialAction, r as resolveDesignType, rt as TEnsureTableOptions, s as FieldMappingStrategy, st as TFieldMeta, t as AtscriptDbReadable, tt as TDbWriteGuardContext, u as AggregateExpr, ut as TIdDescriptor, v as DbRow, vt as TSyncColumnResult, w as OwnPropsOf, wt as TWriteTableResolver, x as FlatOf, xt as TTouchManyOptions, y as FieldOpsFor, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-Bn1bV_eC.mjs";
+import { $ as TDbWriteAction, A as TCrudPermissions, At as findAncestorInSet, B as TDbForeignKey, C as NullableOptional, Ct as TWriteOptions, D as TCascadeTarget, Dt as UniqueryControls, E as TCascadeResolver, Et as Uniquery, F as TDbCollation, Ft as UniquSelect, G as TDbInsertResult, H as TDbIndexField, I as TDbDefaultFn, J as TDbRelation, K as TDbObjectKind, L as TDbDefaultValue, M as TDbActionIntent, Mt as isGeoPointType, N as TDbActionLevel, Nt as NoopLogger, O as TColumnDiff, Ot as WithRelation, P as TDbActionProcessor, Pt as TGenericLogger, Q as TDbUpdateResult, R as TDbDeleteResult, S as NavPropsOf, St as TValueFormatterPair, T as PrimaryKeyOf, Tt as TypedWithRelation, U as TDbIndexType, V as TDbIndex, W as TDbInsertManyResult, X as TDbRemoveGuardContext, Y as TDbRemoveGuard, Z as TDbStorageType, _ as DbQuery, _t as TSearchIndexInfo, a as TDbEncryptionOptions, at as TExistingForeignKey, b as FilterExpr, bt as TTableResolver, c as BaseDbAdapter, ct as TFkLookupResolver, d as AggregateFn, dt as TIdentification, et as TDbWriteGuard, f as AggregateQuery, ft as TMetaResponse, g as DbPatch, gt as TRelationInfo, h as DbControls, ht as TReferencingForeignKey, i as DbEncryption, it as TExistingColumn, j as TDbActionInfo, jt as isGeoIndexableType, k as TCrudOp, kt as TableMetadata, l as AggregateControls, lt as TFkLookupTarget, m as AtscriptDbWritable, mt as TPrimaryKeyChange, n as DbResponse, nt as TDeleteOptions, o as DocumentFieldMapper, ot as TExistingTableOption, p as AggregateResult, pt as TMetadataOverrides, q as TDbReferentialAction, r as resolveDesignType, rt as TEnsureTableOptions, s as FieldMappingStrategy, st as TFieldMeta, t as AtscriptDbReadable, tt as TDbWriteGuardContext, u as AggregateExpr, ut as TIdDescriptor, v as DbRow, vt as TSyncColumnResult, w as OwnPropsOf, wt as TWriteTableResolver, x as FlatOf, xt as TTouchManyOptions, y as FieldOpsFor, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-D8aa-wfP.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 TViewColumnMapping, c as AtscriptQueryFieldRef, d as TViewJoin, f as TViewPlan, g as NativeIntegrity, h as IntegrityStrategy, i as AtscriptDbView, l as AtscriptQueryNode, m as AtscriptDbTable, n as TAdapterFactory, o as isAtscriptDbView, p as translateQueryTree, r as TDbSpaceOptions, s as AtscriptQueryComparison, t as DbSpace, u as AtscriptRef } from "./db-space-DdIPYD0Q.mjs";
+import { a as TViewColumnMapping, c as AtscriptQueryFieldRef, d as TViewJoin, f as TViewPlan, g as NativeIntegrity, h as IntegrityStrategy, i as AtscriptDbView, l as AtscriptQueryNode, m as AtscriptDbTable, n as TAdapterFactory, o as isAtscriptDbView, p as translateQueryTree, r as TDbSpaceOptions, s as AtscriptQueryComparison, t as DbSpace, u as AtscriptRef } from "./db-space-B4MjNjY4.mjs";
 import { _ as DbErrorCode, a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, g as DbError, h as CasMismatchError, l as isEmptyObject, m as CasExhaustedError, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject } from "./validator-wBARmD68.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { n as CasMismatchError, r as DbError, t as CasExhaustedError } from "./db-error-COrO58t5.mjs";
-import { A as isGeoIndexableType, C as unsupportedOperatorMessage, D as UniquSelect, E as FieldMappingStrategy, M as NoopLogger, O as TableMetadata, S as sortFieldNames, T as DocumentFieldMapper, _ as guardAggregate, a as decomposePatch, b as guardPaths, c as createFailureCollector, d as AtscriptDbReadable, f as resolveDesignType, g as collectQueryPaths, h as classifyQueryPath, i as assertNoVersionWrites, j as isGeoPointType, k as findAncestorInSet, l as IntegrityStrategy, m as checkHavingKeys, n as isAtscriptDbView, o as ApplicationIntegrity, p as assertGeoPoint, r as AtscriptDbTable, s as BaseDbAdapter, t as AtscriptDbView, u as NativeIntegrity, v as guardFilter, w as RelationalFieldMapper, x as guardQuery, y as guardPath } from "./db-view-Dl0aDTiT.mjs";
+import { A as isGeoIndexableType, C as unsupportedOperatorMessage, D as UniquSelect, E as FieldMappingStrategy, M as NoopLogger, O as TableMetadata, S as sortFieldNames, T as DocumentFieldMapper, _ as guardAggregate, a as decomposePatch, b as guardPaths, c as createFailureCollector, d as AtscriptDbReadable, f as resolveDesignType, g as collectQueryPaths, h as classifyQueryPath, i as assertNoVersionWrites, j as isGeoPointType, k as findAncestorInSet, l as IntegrityStrategy, m as checkHavingKeys, n as isAtscriptDbView, o as ApplicationIntegrity, p as assertGeoPoint, r as AtscriptDbTable, s as BaseDbAdapter, t as AtscriptDbView, u as NativeIntegrity, v as guardFilter, w as RelationalFieldMapper, x as guardQuery, y as guardPath } from "./db-view-BYH4HJ-U.mjs";
 import { a as forceNavNonOptional, c as getKeyProps, l as isEmptyObject, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator, u as isPlainObject } from "./validator-CeD_fqyW.mjs";
 import { t as DEFAULT_DB_SPACE } from "./consts-C_-5_pFq.mjs";
 import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, reconcileCas, separateCas, separateFieldOps } from "./ops.mjs";

package/dist/rel.d.cts

@@ -1,4 +1,4 @@
-import { B as TDbForeignKey, J as TDbRelation, Pt as TGenericLogger, bt as TTableResolver, c as BaseDbAdapter, kt as TableMetadata, wt as TWriteTableResolver } from "./db-readable-B7eYWS5q.cjs";
+import { B as TDbForeignKey, J as TDbRelation, Pt as TGenericLogger, bt as TTableResolver, c as BaseDbAdapter, kt as TableMetadata, wt as TWriteTableResolver } from "./db-readable-Cmrg9aLU.cjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";

package/dist/rel.d.mts

@@ -1,4 +1,4 @@
-import { B as TDbForeignKey, J as TDbRelation, Pt as TGenericLogger, bt as TTableResolver, c as BaseDbAdapter, kt as TableMetadata, wt as TWriteTableResolver } from "./db-readable-Bn1bV_eC.mjs";
+import { B as TDbForeignKey, J as TDbRelation, Pt as TGenericLogger, bt as TTableResolver, c as BaseDbAdapter, kt as TableMetadata, wt as TWriteTableResolver } from "./db-readable-D8aa-wfP.mjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";

package/dist/sync.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_db_view = require("./db-view-CRBgkEp0.cjs");
+const require_db_view = require("./db-view-DUDnyQ3b.cjs");
 //#region src/schema/schema-hash.ts
 /** Extracts sorted field snapshots from a readable's field descriptors. */
 function extractFieldSnapshots(fields, typeMapper) {

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-B7eYWS5q.cjs";
-import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-C2UCnGHd.cjs";
+import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-Cmrg9aLU.cjs";
+import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-rQFgz3-k.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-Bn1bV_eC.mjs";
-import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-DdIPYD0Q.mjs";
+import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-D8aa-wfP.mjs";
+import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-B4MjNjY4.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.mjs

@@ -1,4 +1,4 @@
-import { M as NoopLogger } from "./db-view-Dl0aDTiT.mjs";
+import { M as NoopLogger } from "./db-view-BYH4HJ-U.mjs";
 //#region src/schema/schema-hash.ts
 /** Extracts sorted field snapshots from a readable's field descriptors. */
 function extractFieldSnapshots(fields, typeMapper) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db",
-  "version": "0.1.129",
+  "version": "0.1.131",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",