@atscript/db 0.1.135 → 0.1.137

package/dist/column-diff-DPkbZIVE.d.mts

@@ -0,0 +1,24 @@
+import { D as TColumnDiff, R as TDbFieldMeta, rt as TExistingColumn } from "./buckets-BFG2RYRW.mjs";
+
+//#region src/schema/column-diff.d.ts
+/**
+ * Whether a live column's type differs from the type the adapter's
+ * `typeMapper` gives the field — the one rule schema sync diffs column types
+ * by (case-insensitive). Exported for adapters that must agree with it (the
+ * PostgreSQL recreate converts exactly the columns this reports changed).
+ * @since 0.1.137
+ */
+declare function isColumnTypeChanged(existingType: string, expectedType: string): boolean;
+/**
+ * Computes the difference between desired schema fields and existing database columns.
+ *
+ * @param desired - Field descriptors from the Atscript type (after flattening).
+ * @param existing - Columns currently in the database (from introspection).
+ * @param typeMapper - Optional function to map field metadata to DB-native type strings.
+ *                     Receives the full field meta (design type, annotations, PK status, etc.)
+ *                     so adapters can produce context-aware types (e.g., `VARCHAR(255)` from maxLength).
+ *                     Required for type change detection.
+ */
+declare function computeColumnDiff(desired: readonly TDbFieldMeta[], existing: TExistingColumn[], typeMapper?: (field: TDbFieldMeta) => string): TColumnDiff;
+//#endregion
+export { isColumnTypeChanged as n, computeColumnDiff as t };

package/dist/index.cjs

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_db_error = require("./db-error-DTkkeu5b.cjs");
-const require_db_view = require("./db-view-Dm7MpUGB.cjs");
+const require_column_diff = require("./column-diff-CgxgFKzx.cjs");
+const require_aggregate_fns = require("./aggregate-fns-CGBv3E8S.cjs");
+const require_nested_writer = require("./nested-writer-BZNCuqI6.cjs");
 const require_validator = require("./validator-BtZbcLN2.cjs");
 const require_consts = require("./consts-BzRfCcH2.cjs");
 const require_ops = require("./ops.cjs");
@@ -238,7 +240,7 @@ var DbSpace = class {
 		if (loggerOrOptions && typeof loggerOrOptions.error === "function") this.logger = loggerOrOptions;
 		else {
 			const options = loggerOrOptions ?? {};
-			this.logger = options.logger ?? require_db_view.NoopLogger;
+			this.logger = options.logger ?? require_column_diff.NoopLogger;
 			if (options.encryption) this._encryption = new DbEncryption(options.encryption);
 		}
 	}
@@ -257,9 +259,9 @@ var DbSpace = class {
 	getTable(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
-			readable = new require_db_view.AtscriptDbTable(type, this.adapterFactory(), logger || this.logger, (t) => this.get(t), (t) => {
+			readable = new require_column_diff.AtscriptDbTable(type, this._createAdapter(), logger || this.logger, (t) => this.get(t), (t) => {
 				const resolved = this.get(t);
-				return resolved instanceof require_db_view.AtscriptDbTable ? resolved : void 0;
+				return resolved instanceof require_column_diff.AtscriptDbTable ? resolved : void 0;
 			});
 			this._allTables.add(readable);
 			readable.setCascadeResolver((tableName) => this._getCascadeTargets(tableName));
@@ -276,7 +278,7 @@ var DbSpace = class {
 	getView(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
-			readable = new require_db_view.AtscriptDbView(type, this.adapterFactory(), logger || this.logger, (t) => this.get(t));
+			readable = new require_column_diff.AtscriptDbView(type, this._createAdapter(), logger || this.logger, (t) => this.get(t));
 			readable.setEncryption(this._encryption);
 			this._readables.set(type, readable);
 		}
@@ -291,17 +293,17 @@ var DbSpace = class {
 	}
 	/**
 	* Drops a table by name. Used by schema sync to remove tables no longer in the schema.
+	* See `BaseDbAdapter.dropTableByName` for an adapter that does not support it.
 	*/
 	async dropTableByName(tableName) {
-		const adapter = this._getAdminAdapter();
-		if (adapter.dropTableByName) await adapter.dropTableByName(tableName);
+		await this._getAdminAdapter().dropTableByName(tableName);
 	}
 	/**
 	* Drops a view by name. Used by schema sync to remove views no longer in the schema.
+	* See `BaseDbAdapter.dropViewByName` for an adapter that does not support it.
 	*/
 	async dropViewByName(viewName) {
-		const adapter = this._getAdminAdapter();
-		if (adapter.dropViewByName) await adapter.dropViewByName(viewName);
+		await this._getAdminAdapter().dropViewByName(viewName);
 	}
 	/**
 	* Drops a group of mutually referencing tables as one operation.
@@ -327,7 +329,16 @@ var DbSpace = class {
 	* schema for those from the driver/connection, not from a bound table.
 	*/
 	_getAdminAdapter() {
-		return this._adminAdapter ??= this.adapterFactory();
+		return this._adminAdapter ??= this._createAdapter();
+	}
+	/**
+	* A factory-fresh adapter that knows its space (see `BaseDbAdapter.registerSpace`).
+	* Optional call: an adapter built against an older `@atscript/db` copy lacks it.
+	*/
+	_createAdapter() {
+		const adapter = this.adapterFactory();
+		adapter.registerSpace?.(this);
+		return adapter;
 	}
 	/**
 	* Finds all child tables with FKs pointing to the given parent table name.
@@ -355,6 +366,14 @@ var DbSpace = class {
 //#endregion
 //#region src/query/query-tree.ts
 /**
+* `true` when a query-tree operand is a field reference (`{ field, type? }`)
+* rather than a literal — e.g. the right side of a field-to-field comparison.
+* @since 0.1.136
+*/
+function isFieldRef(value) {
+	return value !== null && typeof value === "object" && "field" in value;
+}
+/**
 * Translates a JS-emitted query tree into a FilterExpr.
 * Resolves field references (type + field path) to physical column names
 * via the provided resolver function.
@@ -365,11 +384,11 @@ function translateQueryTree(node, resolveField) {
 	if ("$not" in node) return { $not: translateQueryTree(node.$not, resolveField) };
 	const comp = node;
 	const leftField = resolveField(comp.left);
-	if (comp.right && typeof comp.right === "object" && "field" in comp.right) {
+	if (isFieldRef(comp.right)) {
 		const rightField = resolveField(comp.right);
 		return { [leftField]: { [comp.op]: { $field: rightField } } };
 	}
-	if (comp.op === "$exists") return { [leftField]: { $exists: true } };
+	if (comp.op === "$exists") return { [leftField]: { $exists: comp.right !== false } };
 	return { [leftField]: { [comp.op]: comp.right } };
 }
 //#endregion
@@ -382,39 +401,40 @@ exports.$remove = require_ops.$remove;
 exports.$replace = require_ops.$replace;
 exports.$update = require_ops.$update;
 exports.$upsert = require_ops.$upsert;
-exports.ADAPTER_FILTER_REASON = require_db_view.ADAPTER_FILTER_REASON;
-exports.ALL_BUCKET_UNITS = require_db_view.ALL_BUCKET_UNITS;
-exports.ApplicationIntegrity = require_db_view.ApplicationIntegrity;
-exports.AtscriptDbReadable = require_db_view.AtscriptDbReadable;
-exports.AtscriptDbTable = require_db_view.AtscriptDbTable;
-exports.AtscriptDbView = require_db_view.AtscriptDbView;
-exports.BaseDbAdapter = require_db_view.BaseDbAdapter;
+exports.ADAPTER_FILTER_REASON = require_column_diff.ADAPTER_FILTER_REASON;
+exports.ALL_AGGREGATE_FNS = require_aggregate_fns.ALL_AGGREGATE_FNS;
+exports.ALL_BUCKET_UNITS = require_column_diff.ALL_BUCKET_UNITS;
+exports.ApplicationIntegrity = require_column_diff.ApplicationIntegrity;
+exports.AtscriptDbReadable = require_column_diff.AtscriptDbReadable;
+exports.AtscriptDbTable = require_column_diff.AtscriptDbTable;
+exports.AtscriptDbView = require_column_diff.AtscriptDbView;
+exports.BaseDbAdapter = require_column_diff.BaseDbAdapter;
 exports.CasExhaustedError = require_db_error.CasExhaustedError;
 exports.CasMismatchError = require_db_error.CasMismatchError;
 exports.DEFAULT_DB_SPACE = require_consts.DEFAULT_DB_SPACE;
 exports.DbEncryption = DbEncryption;
 exports.DbError = require_db_error.DbError;
 exports.DbSpace = DbSpace;
-exports.DocumentFieldMapper = require_db_view.DocumentFieldMapper;
-exports.ENCRYPTED_REASON = require_db_view.ENCRYPTED_REASON;
-exports.FieldMappingStrategy = require_db_view.FieldMappingStrategy;
-exports.IntegrityStrategy = require_db_view.IntegrityStrategy;
-exports.NativeIntegrity = require_db_view.NativeIntegrity;
-exports.NoopLogger = require_db_view.NoopLogger;
-exports.RelationalFieldMapper = require_db_view.RelationalFieldMapper;
-exports.TableMetadata = require_db_view.TableMetadata;
-exports.UniquSelect = require_db_view.UniquSelect;
-exports.acceptedOperatorsHint = require_db_view.acceptedOperatorsHint;
-exports.assertGeoPoint = require_db_view.assertGeoPoint;
-exports.assertNoVersionWrites = require_db_view.assertNoVersionWrites;
-exports.bucketSourceVerdict = require_db_view.bucketSourceVerdict;
+exports.DocumentFieldMapper = require_column_diff.DocumentFieldMapper;
+exports.ENCRYPTED_REASON = require_column_diff.ENCRYPTED_REASON;
+exports.FieldMappingStrategy = require_column_diff.FieldMappingStrategy;
+exports.IntegrityStrategy = require_column_diff.IntegrityStrategy;
+exports.NativeIntegrity = require_column_diff.NativeIntegrity;
+exports.NoopLogger = require_column_diff.NoopLogger;
+exports.RelationalFieldMapper = require_column_diff.RelationalFieldMapper;
+exports.TableMetadata = require_column_diff.TableMetadata;
+exports.UniquSelect = require_column_diff.UniquSelect;
+exports.acceptedOperatorsHint = require_column_diff.acceptedOperatorsHint;
+exports.assertGeoPoint = require_column_diff.assertGeoPoint;
+exports.assertNoVersionWrites = require_column_diff.assertNoVersionWrites;
+exports.bucketSourceVerdict = require_column_diff.bucketSourceVerdict;
 exports.bucketTimeZoneUnavailable = require_db_error.bucketTimeZoneUnavailable;
 exports.buildDbValidator = require_validator.buildDbValidator;
 exports.buildValidationContext = require_validator.buildValidationContext;
-exports.canFilterLeaf = require_db_view.canFilterLeaf;
-exports.checkHavingKeys = require_db_view.checkHavingKeys;
-exports.classifyQueryPath = require_db_view.classifyQueryPath;
-exports.collectQueryPaths = require_db_view.collectQueryPaths;
+exports.canFilterLeaf = require_column_diff.canFilterLeaf;
+exports.checkHavingKeys = require_column_diff.checkHavingKeys;
+exports.classifyQueryPath = require_column_diff.classifyQueryPath;
+exports.collectQueryPaths = require_column_diff.collectQueryPaths;
 Object.defineProperty(exports, "computeInsights", {
 	enumerable: true,
 	get: function() {
@@ -422,24 +442,26 @@ Object.defineProperty(exports, "computeInsights", {
 	}
 });
 exports.createDbValidatorPlugin = require_validator.createDbValidatorPlugin;
-exports.createFailureCollector = require_db_view.createFailureCollector;
-exports.decomposePatch = require_db_view.decomposePatch;
-exports.findAncestorInSet = require_db_view.findAncestorInSet;
+exports.createFailureCollector = require_column_diff.createFailureCollector;
+exports.decomposePatch = require_column_diff.decomposePatch;
+exports.findAncestorInSet = require_column_diff.findAncestorInSet;
 exports.forceNavNonOptional = require_validator.forceNavNonOptional;
 exports.getDbFieldOp = require_ops.getDbFieldOp;
 exports.getKeyProps = require_validator.getKeyProps;
-exports.guardAggregate = require_db_view.guardAggregate;
-exports.guardFilter = require_db_view.guardFilter;
-exports.guardPath = require_db_view.guardPath;
-exports.guardPaths = require_db_view.guardPaths;
-exports.guardQuery = require_db_view.guardQuery;
-exports.isAtscriptDbView = require_db_view.isAtscriptDbView;
-exports.isBucketableField = require_db_view.isBucketableField;
+exports.guardAggregate = require_column_diff.guardAggregate;
+exports.guardFilter = require_column_diff.guardFilter;
+exports.guardPath = require_column_diff.guardPath;
+exports.guardPaths = require_column_diff.guardPaths;
+exports.guardQuery = require_column_diff.guardQuery;
+exports.isAtscriptDbView = require_column_diff.isAtscriptDbView;
+exports.isBucketableField = require_column_diff.isBucketableField;
+exports.isColumnTypeChanged = require_column_diff.isColumnTypeChanged;
 exports.isDbFieldOp = require_ops.isDbFieldOp;
 exports.isEmptyObject = require_validator.isEmptyObject;
-exports.isGeoIndexableType = require_db_view.isGeoIndexableType;
-exports.isGeoPointType = require_db_view.isGeoPointType;
-exports.isJsonValueField = require_db_view.isJsonValueField;
+exports.isFieldRef = isFieldRef;
+exports.isGeoIndexableType = require_column_diff.isGeoIndexableType;
+exports.isGeoPointType = require_column_diff.isGeoPointType;
+exports.isJsonValueField = require_column_diff.isJsonValueField;
 exports.isNavRelation = require_validator.isNavRelation;
 exports.isPlainObject = require_validator.isPlainObject;
 Object.defineProperty(exports, "isPrimitive", {
@@ -448,16 +470,18 @@ Object.defineProperty(exports, "isPrimitive", {
 		return _uniqu_core.isPrimitive;
 	}
 });
-exports.jsonValueAncestor = require_db_view.jsonValueAncestor;
-exports.narrowerFilterOps = require_db_view.narrowerFilterOps;
+exports.jsonValueAncestor = require_column_diff.jsonValueAncestor;
+exports.narrowerFilterOps = require_column_diff.narrowerFilterOps;
+exports.normalizeComputedSelect = require_column_diff.normalizeComputedSelect;
 exports.reconcileCas = require_ops.reconcileCas;
-exports.resolveCalendarBuckets = require_db_view.resolveCalendarBuckets;
-exports.resolveDesignType = require_db_view.resolveDesignType;
+exports.resolveCalendarBuckets = require_column_diff.resolveCalendarBuckets;
+exports.resolveDesignType = require_column_diff.resolveDesignType;
 exports.separateCas = require_ops.separateCas;
 exports.separateFieldOps = require_ops.separateFieldOps;
-exports.sortFieldNames = require_db_view.sortFieldNames;
+exports.sortFieldNames = require_column_diff.sortFieldNames;
+exports.tableNameOf = require_nested_writer.tableNameOf;
 exports.translateQueryTree = translateQueryTree;
-exports.unsupportedOperatorMessage = require_db_view.unsupportedOperatorMessage;
+exports.unsupportedOperatorMessage = require_column_diff.unsupportedOperatorMessage;
 Object.defineProperty(exports, "walkFilter", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.cts

@@ -1,9 +1,10 @@
-import { $ as TDbWriteGuardContext, A as TDbActionIntent, At as isGeoIndexableType, B as TDbIndexField, Bt as FieldMappingStrategy, C as PrimaryKeyOf, Ct as TWriteTableResolver, D as TCrudOp, Dt as WithRelation, E as TColumnDiff, Et as UniqueryControls, F as TDbDefaultValue, Ft as DbResponse, G as TDbReferentialAction, H as TDbInsertManyResult, Ht as TGenericLogger, I as TDbDeleteResult, It as resolveDesignType, J as TDbRemoveGuardContext, K as TDbRelation, L as TDbFieldMeta, Lt as DbEncryption, M as TDbActionProcessor, Mt as ALL_BUCKET_UNITS, N as TDbCollation, Nt as BaseDbAdapter, O as TCrudPermissions, Ot as TableMetadata, P as TDbDefaultFn, Pt as AtscriptDbReadable, Q as TDbWriteGuard, R as TDbForeignKey, Rt as TDbEncryptionOptions, S as OwnPropsOf, St as TWriteOptions, T as TCascadeTarget, Tt as Uniquery, U as TDbInsertResult, Ut as UniquSelect, V as TDbIndexType, Vt as NoopLogger, W as TDbObjectKind, X as TDbUpdateResult, Y as TDbStorageType, Z as TDbWriteAction, _ as FieldOpsFor, _t as TSyncColumnResult, a as jsonValueAncestor, at as TFieldMeta, b as NavPropsOf, bt as TTouchManyOptions, c as AggregateExpr, ct as TIdDescriptor, d as AggregateResult, dt as TMetaResponse, et as TDeleteOptions, f as AtscriptDbWritable, ft as TMetadataOverrides, g as DbRow, gt as TSearchIndexInfo, h as DbQuery, ht as TRelationInfo, i as isJsonValueField, it as TExistingTableOption, j as TDbActionLevel, jt as isGeoPointType, k as TDbActionInfo, kt as findAncestorInSet, l as AggregateFn, lt as TIdResolveOptions, m as DbPatch, mt as TReferencingForeignKey, n as TResolvedBucket, nt as TExistingColumn, o as resolveCalendarBuckets, ot as TFkLookupResolver, p as DbControls, pt as TPrimaryKeyChange, q as TDbRemoveGuard, r as isBucketableField, rt as TExistingForeignKey, s as AggregateControls, st as TFkLookupTarget, t as TBucketFieldSource, tt as TEnsureTableOptions, u as AggregateQuery, ut as TIdentification, v as FilterExpr, vt as TTableOptionDiff, w as TCascadeResolver, wt as TypedWithRelation, x as NullableOptional, xt as TValueFormatterPair, y as FlatOf, yt as TTableResolver, z as TDbIndex, zt as DocumentFieldMapper } from "./buckets-D6PBXKRJ.cjs";
+import { $ as TDbWriteGuard, $t as AtscriptDbReadable, A as TDbActionInfo, At as findAncestorInSet, B as TDbIndex, Bt as TViewJsonType, C as OwnPropsOf, Ct as TWriteOptions, D as TColumnDiff, Dt as UniqueryControls, E as TCascadeTarget, Et as Uniquery, F as TDbDefaultFn, Ft as DbSpace, G as TDbObjectKind, Gt as AtscriptRef, H as TDbIndexType, Ht as AtscriptQueryComparison, I as TDbDefaultValue, It as TAdapterFactory, J as TDbRemoveGuard, Jt as isFieldRef, K as TDbReferentialAction, Kt as TViewJoin, L as TDbDeleteResult, Lt as TDbSpaceOptions, M as TDbActionLevel, Mt as isGeoPointType, N as TDbActionProcessor, Nt as ALL_BUCKET_UNITS, O as TCrudOp, Ot as WithRelation, P as TDbCollation, Pt as BaseDbAdapter, Q as TDbWriteAction, Qt as NativeIntegrity, R as TDbFieldMeta, Rt as AtscriptDbView, S as NullableOptional, St as TValueFormatterPair, T as TCascadeResolver, Tt as TypedWithRelation, U as TDbInsertManyResult, Ut as AtscriptQueryFieldRef, V as TDbIndexField, Vt as isAtscriptDbView, W as TDbInsertResult, Wt as AtscriptQueryNode, X as TDbStorageType, Xt as AtscriptDbTable, Y as TDbRemoveGuardContext, Yt as translateQueryTree, Z as TDbUpdateResult, Zt as IntegrityStrategy, _ as DbRow, _t as TSearchIndexInfo, a as jsonValueAncestor, an as FieldMappingStrategy, at as TExistingTableOption, b as FlatOf, bt as TTableResolver, c as AggregateControls, cn as UniquSelect, ct as TFkLookupTarget, d as AggregateQuery, dt as TIdentification, en as DbResponse, et as TDbWriteGuardContext, f as AggregateResult, ft as TMetaResponse, g as DbQuery, gt as TRelationInfo, h as DbPatch, ht as TReferencingForeignKey, i as isJsonValueField, in as DocumentFieldMapper, it as TExistingForeignKey, j as TDbActionIntent, jt as isGeoIndexableType, k as TCrudPermissions, kt as TableMetadata, l as AggregateExpr, lt as TIdDescriptor, m as DbControls, mt as TPrimaryKeyChange, n as TResolvedBucket, nn as DbEncryption, nt as TEnsureTableOptions, o as normalizeComputedSelect, on as NoopLogger, ot as TFieldMeta, p as AtscriptDbWritable, pt as TMetadataOverrides, q as TDbRelation, qt as TViewPlan, r as isBucketableField, rn as TDbEncryptionOptions, rt as TExistingColumn, s as resolveCalendarBuckets, sn as TGenericLogger, st as TFkLookupResolver, t as TBucketFieldSource, tn as resolveDesignType, tt as TDeleteOptions, u as AggregateFn, ut as TIdResolveOptions, v as FieldOpsFor, vt as TSyncColumnResult, w as PrimaryKeyOf, wt as TWriteTableResolver, x as NavPropsOf, xt as TTouchManyOptions, y as FilterExpr, yt as TTableOptionDiff, z as TDbForeignKey, zt as TViewColumnMapping } from "./buckets-C-27xmtq.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 { c as CalendarBucketLabel, d as WeekStart, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-DKuf_v2L.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-BdtBNTeH.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, v as bucketTimeZoneUnavailable } from "./validator-CewfnGZj.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-CV7y8nC6.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, v as bucketTimeZoneUnavailable } from "./validator-Drb2N-YL.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
+import { n as isColumnTypeChanged } from "./column-diff-BmqvgBWw.cjs";
+import { i as tableNameOf } from "./relation-helpers-DxrvS6ar.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, ResolvedBucket as ResolvedBucket$1, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
 //#region src/shared/consts.d.ts
@@ -105,7 +106,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
  * - `$exists` with a non-boolean operand → `INVALID_QUERY`
  * - malformed `$select` computed entries / `$groupBy` entries, calendar
  *   buckets outside grouped queries or with a bad unit / zone / alias →
- *   `INVALID_QUERY` (the shared normalizer, `resolveCalendarBuckets`)
+ *   `INVALID_QUERY` (the shared normalizer, `normalizeComputedSelect`)
  * - a calendar bucket over a field that is not a bucket source
  *   (`bucketSourceVerdict`) → `INVALID_QUERY`, or `BUCKET_NOT_SUPPORTED`
  *   when the adapter has no calendar buckets at all; a unit the adapter's
@@ -283,7 +284,7 @@ interface TQueryPathRefs {
  * `$sort` / `$having`; a bucket alias is also dropped from `groupBy`, which
  * lists grouped fields only.
  *
- * Entry shapes are not checked here — see `resolveCalendarBuckets`.
+ * Entry shapes are not checked here — see `normalizeComputedSelect`.
  */
 declare function collectQueryPaths(query: TGuardedQuery, aggregate?: boolean): TQueryPathRefs;
 /** What a logical path is on THIS readable / adapter (since 0.1.128). */
@@ -346,7 +347,7 @@ declare function guardPath(meta: TableMetadata, adapter: BaseDbAdapter, path: st
  * {@link guardPath}). Adapters may therefore assume every path they receive
  * is physical.
  *
- * Entry shapes are the caller's to normalize first (`resolveCalendarBuckets`
+ * Entry shapes are the caller's to normalize first (`normalizeComputedSelect`
  * — {@link guardQuery} / {@link guardAggregate} do).
  *
  * In aggregate mode (`aggregate = true`) `$select` computed entries have
@@ -380,13 +381,14 @@ declare function checkHavingKeys(refs: TQueryPathRefs): {
 } | undefined;
 /**
  * Aggregate-path guard: $groupBy / $select / $having encryption refs + filter
- * + $sort, then the path guard, then the adapter's calendar-bucket units
+ * + $sort, then the path guard, then the adapter's aggregate functions
+ * (`AGG_FN_NOT_SUPPORTED`) and calendar-bucket units
  * (`BUCKET_NOT_SUPPORTED`), then the `$having` key rule
  * ({@link checkHavingKeys} — after the path guard so an unknown key still
  * reads `Unknown field`).
  *
  * `buckets` are the query's resolved calendar buckets when the caller already
- * ran `resolveCalendarBuckets` (resolved here otherwise).
+ * ran `normalizeComputedSelect` (resolved here otherwise).
  */
 declare function guardAggregate(meta: TableMetadata, adapter: BaseDbAdapter, query: AggregateQuery$1, resolved?: readonly ResolvedBucket$1[]): void;
 //#endregion
@@ -487,4 +489,4 @@ declare function createFailureCollector(what: string): {
   throwIfAny: () => void;
 };
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, 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, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isDbFieldOp, isEmptyObject, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, 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, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-import { $ as TDbWriteGuardContext, A as TDbActionIntent, At as isGeoIndexableType, B as TDbIndexField, Bt as FieldMappingStrategy, C as PrimaryKeyOf, Ct as TWriteTableResolver, D as TCrudOp, Dt as WithRelation, E as TColumnDiff, Et as UniqueryControls, F as TDbDefaultValue, Ft as DbResponse, G as TDbReferentialAction, H as TDbInsertManyResult, Ht as TGenericLogger, I as TDbDeleteResult, It as resolveDesignType, J as TDbRemoveGuardContext, K as TDbRelation, L as TDbFieldMeta, Lt as DbEncryption, M as TDbActionProcessor, Mt as ALL_BUCKET_UNITS, N as TDbCollation, Nt as BaseDbAdapter, O as TCrudPermissions, Ot as TableMetadata, P as TDbDefaultFn, Pt as AtscriptDbReadable, Q as TDbWriteGuard, R as TDbForeignKey, Rt as TDbEncryptionOptions, S as OwnPropsOf, St as TWriteOptions, T as TCascadeTarget, Tt as Uniquery, U as TDbInsertResult, Ut as UniquSelect, V as TDbIndexType, Vt as NoopLogger, W as TDbObjectKind, X as TDbUpdateResult, Y as TDbStorageType, Z as TDbWriteAction, _ as FieldOpsFor, _t as TSyncColumnResult, a as jsonValueAncestor, at as TFieldMeta, b as NavPropsOf, bt as TTouchManyOptions, c as AggregateExpr, ct as TIdDescriptor, d as AggregateResult, dt as TMetaResponse, et as TDeleteOptions, f as AtscriptDbWritable, ft as TMetadataOverrides, g as DbRow, gt as TSearchIndexInfo, h as DbQuery, ht as TRelationInfo, i as isJsonValueField, it as TExistingTableOption, j as TDbActionLevel, jt as isGeoPointType, k as TDbActionInfo, kt as findAncestorInSet, l as AggregateFn, lt as TIdResolveOptions, m as DbPatch, mt as TReferencingForeignKey, n as TResolvedBucket, nt as TExistingColumn, o as resolveCalendarBuckets, ot as TFkLookupResolver, p as DbControls, pt as TPrimaryKeyChange, q as TDbRemoveGuard, r as isBucketableField, rt as TExistingForeignKey, s as AggregateControls, st as TFkLookupTarget, t as TBucketFieldSource, tt as TEnsureTableOptions, u as AggregateQuery, ut as TIdentification, v as FilterExpr, vt as TTableOptionDiff, w as TCascadeResolver, wt as TypedWithRelation, x as NullableOptional, xt as TValueFormatterPair, y as FlatOf, yt as TTableResolver, z as TDbIndex, zt as DocumentFieldMapper } from "./buckets-GruoVxH5.mjs";
+import { $ as TDbWriteGuard, $t as AtscriptDbReadable, A as TDbActionInfo, At as findAncestorInSet, B as TDbIndex, Bt as TViewJsonType, C as OwnPropsOf, Ct as TWriteOptions, D as TColumnDiff, Dt as UniqueryControls, E as TCascadeTarget, Et as Uniquery, F as TDbDefaultFn, Ft as DbSpace, G as TDbObjectKind, Gt as AtscriptRef, H as TDbIndexType, Ht as AtscriptQueryComparison, I as TDbDefaultValue, It as TAdapterFactory, J as TDbRemoveGuard, Jt as isFieldRef, K as TDbReferentialAction, Kt as TViewJoin, L as TDbDeleteResult, Lt as TDbSpaceOptions, M as TDbActionLevel, Mt as isGeoPointType, N as TDbActionProcessor, Nt as ALL_BUCKET_UNITS, O as TCrudOp, Ot as WithRelation, P as TDbCollation, Pt as BaseDbAdapter, Q as TDbWriteAction, Qt as NativeIntegrity, R as TDbFieldMeta, Rt as AtscriptDbView, S as NullableOptional, St as TValueFormatterPair, T as TCascadeResolver, Tt as TypedWithRelation, U as TDbInsertManyResult, Ut as AtscriptQueryFieldRef, V as TDbIndexField, Vt as isAtscriptDbView, W as TDbInsertResult, Wt as AtscriptQueryNode, X as TDbStorageType, Xt as AtscriptDbTable, Y as TDbRemoveGuardContext, Yt as translateQueryTree, Z as TDbUpdateResult, Zt as IntegrityStrategy, _ as DbRow, _t as TSearchIndexInfo, a as jsonValueAncestor, an as FieldMappingStrategy, at as TExistingTableOption, b as FlatOf, bt as TTableResolver, c as AggregateControls, cn as UniquSelect, ct as TFkLookupTarget, d as AggregateQuery, dt as TIdentification, en as DbResponse, et as TDbWriteGuardContext, f as AggregateResult, ft as TMetaResponse, g as DbQuery, gt as TRelationInfo, h as DbPatch, ht as TReferencingForeignKey, i as isJsonValueField, in as DocumentFieldMapper, it as TExistingForeignKey, j as TDbActionIntent, jt as isGeoIndexableType, k as TCrudPermissions, kt as TableMetadata, l as AggregateExpr, lt as TIdDescriptor, m as DbControls, mt as TPrimaryKeyChange, n as TResolvedBucket, nn as DbEncryption, nt as TEnsureTableOptions, o as normalizeComputedSelect, on as NoopLogger, ot as TFieldMeta, p as AtscriptDbWritable, pt as TMetadataOverrides, q as TDbRelation, qt as TViewPlan, r as isBucketableField, rn as TDbEncryptionOptions, rt as TExistingColumn, s as resolveCalendarBuckets, sn as TGenericLogger, st as TFkLookupResolver, t as TBucketFieldSource, tn as resolveDesignType, tt as TDeleteOptions, u as AggregateFn, ut as TIdResolveOptions, v as FieldOpsFor, vt as TSyncColumnResult, w as PrimaryKeyOf, wt as TWriteTableResolver, x as NavPropsOf, xt as TTouchManyOptions, y as FilterExpr, yt as TTableOptionDiff, z as TDbForeignKey, zt as TViewColumnMapping } from "./buckets-BFG2RYRW.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 { c as CalendarBucketLabel, d as WeekStart, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-BtlGeRfj.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-9CH5neN7.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, v as bucketTimeZoneUnavailable } from "./validator-CewfnGZj.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-D5DHsAby.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, v as bucketTimeZoneUnavailable } from "./validator-Drb2N-YL.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
+import { n as isColumnTypeChanged } from "./column-diff-DPkbZIVE.mjs";
+import { i as tableNameOf } from "./relation-helpers-D3Zu0Mta.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, ResolvedBucket as ResolvedBucket$1, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
 //#region src/shared/consts.d.ts
@@ -105,7 +106,7 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
  * - `$exists` with a non-boolean operand → `INVALID_QUERY`
  * - malformed `$select` computed entries / `$groupBy` entries, calendar
  *   buckets outside grouped queries or with a bad unit / zone / alias →
- *   `INVALID_QUERY` (the shared normalizer, `resolveCalendarBuckets`)
+ *   `INVALID_QUERY` (the shared normalizer, `normalizeComputedSelect`)
  * - a calendar bucket over a field that is not a bucket source
  *   (`bucketSourceVerdict`) → `INVALID_QUERY`, or `BUCKET_NOT_SUPPORTED`
  *   when the adapter has no calendar buckets at all; a unit the adapter's
@@ -283,7 +284,7 @@ interface TQueryPathRefs {
  * `$sort` / `$having`; a bucket alias is also dropped from `groupBy`, which
  * lists grouped fields only.
  *
- * Entry shapes are not checked here — see `resolveCalendarBuckets`.
+ * Entry shapes are not checked here — see `normalizeComputedSelect`.
  */
 declare function collectQueryPaths(query: TGuardedQuery, aggregate?: boolean): TQueryPathRefs;
 /** What a logical path is on THIS readable / adapter (since 0.1.128). */
@@ -346,7 +347,7 @@ declare function guardPath(meta: TableMetadata, adapter: BaseDbAdapter, path: st
  * {@link guardPath}). Adapters may therefore assume every path they receive
  * is physical.
  *
- * Entry shapes are the caller's to normalize first (`resolveCalendarBuckets`
+ * Entry shapes are the caller's to normalize first (`normalizeComputedSelect`
  * — {@link guardQuery} / {@link guardAggregate} do).
  *
  * In aggregate mode (`aggregate = true`) `$select` computed entries have
@@ -380,13 +381,14 @@ declare function checkHavingKeys(refs: TQueryPathRefs): {
 } | undefined;
 /**
  * Aggregate-path guard: $groupBy / $select / $having encryption refs + filter
- * + $sort, then the path guard, then the adapter's calendar-bucket units
+ * + $sort, then the path guard, then the adapter's aggregate functions
+ * (`AGG_FN_NOT_SUPPORTED`) and calendar-bucket units
  * (`BUCKET_NOT_SUPPORTED`), then the `$having` key rule
  * ({@link checkHavingKeys} — after the path guard so an unknown key still
  * reads `Unknown field`).
  *
  * `buckets` are the query's resolved calendar buckets when the caller already
- * ran `resolveCalendarBuckets` (resolved here otherwise).
+ * ran `normalizeComputedSelect` (resolved here otherwise).
  */
 declare function guardAggregate(meta: TableMetadata, adapter: BaseDbAdapter, query: AggregateQuery$1, resolved?: readonly ResolvedBucket$1[]): void;
 //#endregion
@@ -487,4 +489,4 @@ declare function createFailureCollector(what: string): {
   throwIfAny: () => void;
 };
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, 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, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isDbFieldOp, isEmptyObject, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, 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, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

package/dist/index.mjs

@@ -1,5 +1,7 @@
 import { a as bucketTimeZoneUnavailable, n as CasMismatchError, r as DbError, t as CasExhaustedError } from "./db-error-D5uilS_A.mjs";
-import { A as unsupportedOperatorMessage, B as isJsonValueField, C as guardAggregate, D as guardQuery, E as guardPaths, F as TableMetadata, H as resolveCalendarBuckets, I as findAncestorInSet, L as isGeoIndexableType, M as DocumentFieldMapper, N as FieldMappingStrategy, O as narrowerFilterOps, P as UniquSelect, R as isGeoPointType, S as collectQueryPaths, T as guardPath, U as NoopLogger, V as jsonValueAncestor, _ as assertGeoPoint, a as decomposePatch, b as checkHavingKeys, c as BaseDbAdapter, d as NativeIntegrity, f as AtscriptDbReadable, g as acceptedOperatorsHint, h as ENCRYPTED_REASON, i as assertNoVersionWrites, j as RelationalFieldMapper, k as sortFieldNames, l as createFailureCollector, m as ADAPTER_FILTER_REASON, n as isAtscriptDbView, o as ApplicationIntegrity, p as resolveDesignType, r as AtscriptDbTable, s as ALL_BUCKET_UNITS, t as AtscriptDbView, u as IntegrityStrategy, v as bucketSourceVerdict, w as guardFilter, x as classifyQueryPath, y as canFilterLeaf, z as isBucketableField } from "./db-view-Doh8vPg3.mjs";
+import { $ as jsonValueAncestor, A as bucketSourceVerdict, B as narrowerFilterOps, C as NativeIntegrity, D as ENCRYPTED_REASON, E as ADAPTER_FILTER_REASON, F as guardAggregate, G as FieldMappingStrategy, H as unsupportedOperatorMessage, I as guardFilter, J as findAncestorInSet, K as UniquSelect, L as guardPath, M as checkHavingKeys, N as classifyQueryPath, O as acceptedOperatorsHint, P as collectQueryPaths, Q as isJsonValueField, R as guardPaths, S as IntegrityStrategy, T as resolveDesignType, U as RelationalFieldMapper, V as sortFieldNames, W as DocumentFieldMapper, X as isGeoPointType, Y as isGeoIndexableType, Z as isBucketableField, _ as decomposePatch, b as BaseDbAdapter, et as normalizeComputedSelect, g as assertNoVersionWrites, h as AtscriptDbTable, j as canFilterLeaf, k as assertGeoPoint, m as isAtscriptDbView, n as isColumnTypeChanged, nt as NoopLogger, p as AtscriptDbView, q as TableMetadata, tt as resolveCalendarBuckets, v as ApplicationIntegrity, w as AtscriptDbReadable, x as createFailureCollector, y as ALL_BUCKET_UNITS, z as guardQuery } from "./column-diff-BwOA5101.mjs";
+import { t as ALL_AGGREGATE_FNS } from "./aggregate-fns-CfsveE1w.mjs";
+import { v as tableNameOf } from "./nested-writer-FWD5oOYh.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-Ch7UIQl9.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";
@@ -256,7 +258,7 @@ var DbSpace = class {
 	getTable(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
-			readable = new AtscriptDbTable(type, this.adapterFactory(), logger || this.logger, (t) => this.get(t), (t) => {
+			readable = new AtscriptDbTable(type, this._createAdapter(), logger || this.logger, (t) => this.get(t), (t) => {
 				const resolved = this.get(t);
 				return resolved instanceof AtscriptDbTable ? resolved : void 0;
 			});
@@ -275,7 +277,7 @@ var DbSpace = class {
 	getView(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
-			readable = new AtscriptDbView(type, this.adapterFactory(), logger || this.logger, (t) => this.get(t));
+			readable = new AtscriptDbView(type, this._createAdapter(), logger || this.logger, (t) => this.get(t));
 			readable.setEncryption(this._encryption);
 			this._readables.set(type, readable);
 		}
@@ -290,17 +292,17 @@ var DbSpace = class {
 	}
 	/**
 	* Drops a table by name. Used by schema sync to remove tables no longer in the schema.
+	* See `BaseDbAdapter.dropTableByName` for an adapter that does not support it.
 	*/
 	async dropTableByName(tableName) {
-		const adapter = this._getAdminAdapter();
-		if (adapter.dropTableByName) await adapter.dropTableByName(tableName);
+		await this._getAdminAdapter().dropTableByName(tableName);
 	}
 	/**
 	* Drops a view by name. Used by schema sync to remove views no longer in the schema.
+	* See `BaseDbAdapter.dropViewByName` for an adapter that does not support it.
 	*/
 	async dropViewByName(viewName) {
-		const adapter = this._getAdminAdapter();
-		if (adapter.dropViewByName) await adapter.dropViewByName(viewName);
+		await this._getAdminAdapter().dropViewByName(viewName);
 	}
 	/**
 	* Drops a group of mutually referencing tables as one operation.
@@ -326,7 +328,16 @@ var DbSpace = class {
 	* schema for those from the driver/connection, not from a bound table.
 	*/
 	_getAdminAdapter() {
-		return this._adminAdapter ??= this.adapterFactory();
+		return this._adminAdapter ??= this._createAdapter();
+	}
+	/**
+	* A factory-fresh adapter that knows its space (see `BaseDbAdapter.registerSpace`).
+	* Optional call: an adapter built against an older `@atscript/db` copy lacks it.
+	*/
+	_createAdapter() {
+		const adapter = this.adapterFactory();
+		adapter.registerSpace?.(this);
+		return adapter;
 	}
 	/**
 	* Finds all child tables with FKs pointing to the given parent table name.
@@ -354,6 +365,14 @@ var DbSpace = class {
 //#endregion
 //#region src/query/query-tree.ts
 /**
+* `true` when a query-tree operand is a field reference (`{ field, type? }`)
+* rather than a literal — e.g. the right side of a field-to-field comparison.
+* @since 0.1.136
+*/
+function isFieldRef(value) {
+	return value !== null && typeof value === "object" && "field" in value;
+}
+/**
 * Translates a JS-emitted query tree into a FilterExpr.
 * Resolves field references (type + field path) to physical column names
 * via the provided resolver function.
@@ -364,12 +383,12 @@ function translateQueryTree(node, resolveField) {
 	if ("$not" in node) return { $not: translateQueryTree(node.$not, resolveField) };
 	const comp = node;
 	const leftField = resolveField(comp.left);
-	if (comp.right && typeof comp.right === "object" && "field" in comp.right) {
+	if (isFieldRef(comp.right)) {
 		const rightField = resolveField(comp.right);
 		return { [leftField]: { [comp.op]: { $field: rightField } } };
 	}
-	if (comp.op === "$exists") return { [leftField]: { $exists: true } };
+	if (comp.op === "$exists") return { [leftField]: { $exists: comp.right !== false } };
 	return { [leftField]: { [comp.op]: comp.right } };
 }
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_BUCKET_UNITS, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RelationalFieldMapper, TableMetadata, UniquSelect, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isDbFieldOp, isEmptyObject, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RelationalFieldMapper, TableMetadata, UniquSelect, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

package/dist/{nested-writer-wk1EFUNY.cjs → nested-writer-BZNCuqI6.cjs}

@@ -26,11 +26,19 @@ function findRemoteFK(targetTable, thisTableName, alias) {
 	}
 }
 /**
+* Table name of an annotated type — its `@db.table`, else its type id (`""`
+* when neither is set). The rule relations, foreign keys and view plans use
+* to name a referenced table.
+* @since 0.1.136
+*/
+function tableNameOf(type) {
+	return type?.metadata?.get("db.table") || type?.id || "";
+}
+/**
 * Resolves the target table name from a relation's target type metadata.
 */
 function resolveRelationTargetTable(relation) {
-	const targetType = relation.targetType();
-	return targetType?.metadata?.get("db.table") || targetType?.id || "";
+	return tableNameOf(relation.targetType());
 }
 //#endregion
 //#region src/table/error-utils.ts
@@ -742,6 +750,12 @@ Object.defineProperty(exports, "resolveRelationTargetTable", {
 		return resolveRelationTargetTable;
 	}
 });
+Object.defineProperty(exports, "tableNameOf", {
+	enumerable: true,
+	get: function() {
+		return tableNameOf;
+	}
+});
 Object.defineProperty(exports, "validateBatch", {
 	enumerable: true,
 	get: function() {

package/dist/{nested-writer-CqL24ojl.mjs → nested-writer-FWD5oOYh.mjs}

@@ -26,11 +26,19 @@ function findRemoteFK(targetTable, thisTableName, alias) {
 	}
 }
 /**
+* Table name of an annotated type — its `@db.table`, else its type id (`""`
+* when neither is set). The rule relations, foreign keys and view plans use
+* to name a referenced table.
+* @since 0.1.136
+*/
+function tableNameOf(type) {
+	return type?.metadata?.get("db.table") || type?.id || "";
+}
+/**
 * Resolves the target table name from a relation's target type metadata.
 */
 function resolveRelationTargetTable(relation) {
-	const targetType = relation.targetType();
-	return targetType?.metadata?.get("db.table") || targetType?.id || "";
+	return tableNameOf(relation.targetType());
 }
 //#endregion
 //#region src/table/error-utils.ts
@@ -646,4 +654,4 @@ async function viaReplace(targetTable, junctionTable, targets, parentPK, targetP
 	}
 }
 //#endregion
-export { resolveRelationTargetTable as _, batchPatchNestedTo as a, batchReplaceNestedTo as c, preValidateNestedFrom as d, validateBatch as f, findRemoteFK as g, findFKForRelation as h, batchPatchNestedFrom as i, batchReplaceNestedVia as l, remapDeleteFkViolation as m, batchInsertNestedTo as n, batchPatchNestedVia as o, enrichFkViolation as p, batchInsertNestedVia as r, batchReplaceNestedFrom as s, batchInsertNestedFrom as t, checkDepthOverflow as u };
+export { resolveRelationTargetTable as _, batchPatchNestedTo as a, batchReplaceNestedTo as c, preValidateNestedFrom as d, validateBatch as f, findRemoteFK as g, findFKForRelation as h, batchPatchNestedFrom as i, batchReplaceNestedVia as l, remapDeleteFkViolation as m, batchInsertNestedTo as n, batchPatchNestedVia as o, enrichFkViolation as p, batchInsertNestedVia as r, batchReplaceNestedFrom as s, batchInsertNestedFrom as t, checkDepthOverflow as u, tableNameOf as v };