@atscript/db 0.1.161 → 0.1.162

package/dist/index.d.cts

@@ -1,11 +1,13 @@
-import { $ as TDbInsertResult, $t as ALL_VIEW_CAPABILITIES, A as TColumnDiff, An as REL_FILTER_MAX_NODES, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as isResolvedRelationFilter, Bt as TValueFormatterPair, C as NavPropsOf, Cn as IntegrityStrategy, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as DbResponse, Dt as TJsonCopyTarget, E as OwnPropsOf, En as AtscriptDbReadable, Et as TInsertOptions, F as TDbActionLevel, Fn as TRelationStaticFilter, Ft as TSyncColumnResult, G as TDbIndex, Gn as FieldMappingStrategy, Gt as Uniquery, H as TDbDeleteResult, Hn as DbEncryption, Ht as TWriteOptions, I as TDbActionProcessor, In as andFilters, It as TSyncIndexesOptions, J as TDbInsertIgnoreOptions, Jn as TGenericLogger, Jt as TableMetadata, K as TDbIndexField, Kn as TReadControls, Kt as UniqueryControls, L as TDbActionTargetSummary, Ln as containsRelationFilter, Lt as TTableOptionDiff, M as TCrudPermissions, Mn as TRelGuardState, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterJunction, Nt as TRowResolveOptions, O as TCascadeResolver, On as resolveDesignType, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationFilterTable, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qn as UniquSelect, Qt as ALL_BUCKET_UNITS, R as TDbAvailableActions, Rn as forEachResolvedRelation, Rt as TTableResolver, S as FlatOf, Sn as AtscriptDbTable, St as TFkLookupTarget, T as NullsPlacement, Tn as TCascadePin, Tt as TIdentification, U as TDbFieldMeta, Un as TDbEncryptionOptions, Ut as TWriteTableResolver, V as TDbDefaultValue, Vn as relationStaticFilter, Vt as TViewJsonType, W as TDbForeignKey, Wn as DocumentFieldMapper, Wt as TypedWithRelation, X as TDbInsertIgnoreSlot, Xn as TFirstLast, Xt as isGeoPointType, Y as TDbInsertIgnoreResult, Yn as TExprAggregate, Yt as isGeoIndexableType, Z as TDbInsertManyIgnoreResult, Zn as TRowOrderKey, Zt as TPathPresence, _ as DbPatch, _n as TViewJoin, _t as TExistingColumn, a as isJsonValueField, an as AtscriptDbView, at as TDbStorageType, b as FieldOpsFor, bn as isFieldRef, bt as TFieldMeta, c as resolveCalendarBuckets, cn as isViewType, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptExprNode, dt as TDbWriteGuard, en as BaseDbAdapter, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptOrderItem, ft as TDbWriteGuardContext, g as DbControls, gn as AtscriptRef, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptQueryNode, ht as TDerivedColumn, i as isBucketableField, in as TDbSpaceOptions, it as TDbRemoveGuardContext, j as TCrudOp, jn as ResolvedRelationFilter, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_DEPTH, kt as TMetadataOverrides, l as AggregateControls, ln as TViewReadPlan, lt as TDbWriteCheck, mn as AtscriptQueryFieldRef, mt as TDerivedChangeReason, n as TComputedSelect, nn as DbSpace, nt as TDbRelation, o as jsonValueAncestor, on as TViewColumnMapping, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryComparison, pt as TDeleteOptions, q as TDbIndexType, qn as NoopLogger, qt as WithRelation, r as TResolvedBucket, rn as TAdapterFactory, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isAtscriptDbView, st as TDbUpdateResult, t as TBucketFieldSource, tn as TViewCapability, tt as TDbReferentialAction, u as AggregateExpr, un as aliasTargetOf, ut as TDbWriteCheckContext, v as DbQuery, vn as TViewPlan, vt as TExistingForeignKey, w as NullableOptional, wn as NativeIntegrity, wt as TIdResolveOptions, x as FilterExpr, xn as translateQueryTree, xt as TFkLookupResolver, y as DbRow, yn as evaluateExpr, yt as TExistingTableOption, z as TDbCollation, zn as hasRelationOp, zt as TTouchManyOptions } from "./buckets-B4T_alUe.cjs";
+import { $ as TDbInsertManyIgnoreResult, $n as hasRelationOp, $t as TWriteOptions, A as TCascadeTarget, An as AtscriptRef, At as TForeignKeyChange, B as TDbCollation, Bn as AtscriptDbReadable, Bt as TReadLockOptions, C as NavPropsOf, Cn as TViewReadPlan, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as AtscriptQueryComparison, Dt as TFieldMeta, E as OwnPropsOf, En as AtscriptOrderItem, Et as TExistingTableOption, F as TDbActionIntent, Fn as translateQueryTree, Ft as TInsertOptions, G as TDbFieldMeta, Gn as ResolvedRelationFilter, Gt as TSyncColumnResult, H as TDbDefaultValue, Hn as resolveDesignType, Ht as TRelationInfo, I as TDbActionLevel, In as AtscriptDbTable, It as TJsonCopyTarget, J as TDbIndexField, Jn as TRelationFilterTable, Jt as TTableResolver, K as TDbForeignKey, Kn as TRelGuardState, Kt as TSyncIndexesOptions, L as TDbActionProcessor, Ln as IntegrityStrategy, Lt as TMetaResponse, M as TCrudOp, Mn as TViewPlan, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as evaluateExpr, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptQueryFieldRef, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as isFieldRef, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as forEachResolvedRelation, Qt as TViewJsonType, R as TDbActionTargetSummary, Rn as NativeIntegrity, Rt as TMetadataOverrides, S as FlatOf, Sn as isViewType, St as TDerivedColumn, T as NullsPlacement, Tn as AtscriptExprNode, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as REL_FILTER_MAX_DEPTH, Ut as TRowResolveOptions, V as TDbDefaultFn, Vn as DbResponse, Vt as TReferencingForeignKey, W as TDbDeleteResult, Wn as REL_FILTER_MAX_NODES, Wt as TSearchIndexInfo, X as TDbInsertIgnoreOptions, Xn as andFilters, Xt as TTransactionOptions, Y as TDbIndexType, Yn as TRelationStaticFilter, Yt as TTouchManyOptions, Z as TDbInsertIgnoreResult, Zn as containsRelationFilter, Zt as TValueFormatterPair, _ as DbPatch, _n as TAdapterFactory, _t as TDbWriteGuard, a as isJsonValueField, an as TableMetadata, ar as FieldMappingStrategy, at as TDbObjectKind, b as FieldOpsFor, bn as TViewColumnMapping, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as TPathPresence, cr as TGenericLogger, ct as TDbRelation, d as AggregateFn, dn as ALL_VIEW_CAPABILITIES, dr as TRowOrderKey, dt as TDbStorageType, en as TWriteTableResolver, er as isResolvedRelationFilter, et as TDbInsertManyResult, f as AggregateQuery, fn as BaseDbAdapter, fr as UniquSelect, ft as TDbUpdateOptions, g as DbControls, gn as DbSpace, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as TViewCapability, ht as TDbWriteCheck, i as isBucketableField, in as WithRelation, ir as DocumentFieldMapper, it as TDbLockWait, j as TColumnDiff, jn as TViewJoin, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptQueryNode, kt as TFkLookupTarget, l as AggregateControls, ln as ALL_BUCKET_UNITS, lr as TExprAggregate, lt as TDbRemoveGuard, mn as TIndexDiffOptions, mt as TDbWriteAction, n as TComputedSelect, nn as Uniquery, nr as DbEncryption, nt as TDbIsolationLevel, o as jsonValueAncestor, on as isGeoIndexableType, or as TReadControls, ot as TDbReadLock, p as AggregateResult, pn as TForeignKeyDiffOptions, pt as TDbUpdateResult, q as TDbIndex, qn as TRelationFilterJunction, qt as TTableOptionDiff, r as TResolvedBucket, rn as UniqueryControls, rr as TDbEncryptionOptions, rt as TDbLockMode, s as normalizeComputedSelect, sn as isGeoPointType, sr as NoopLogger, st as TDbReferentialAction, t as TBucketFieldSource, tn as TypedWithRelation, tr as relationStaticFilter, tt as TDbInsertResult, u as AggregateExpr, un as ALL_ISOLATION_LEVELS, ur as TFirstLast, ut as TDbRemoveGuardContext, v as DbQuery, vn as TDbSpaceOptions, vt as TDbWriteGuardContext, w as NullableOptional, wn as aliasTargetOf, wt as TExistingColumn, x as FilterExpr, xn as isAtscriptDbView, xt as TDerivedChangeReason, y as DbRow, yn as AtscriptDbView, yt as TDbWriteLimit, z as TDbAvailableActions, zn as TCascadePin, zt as TPrimaryKeyChange } from "./buckets-_iZV39Z3.cjs";
+import { a as aggregateExpressionsNotSupported, c as isConflict, i as DbErrorCode, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-B_DRL1E9.cjs";
 import { _ as separateFieldOps, a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateCas, h as reconcileCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, p as getDbFieldOp, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-AqhV7s9o.cjs";
-import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-CtPYTIvy.cjs";
+import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, s as stableJson, t as deletePath } from "./object-Czia_qD4.cjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-42CSpGDR.cjs";
-import { _ as aggregateFailure, a as buildValidationContext, b as isRetryableDbError, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as aggregateExpressionsNotSupported, h as DbErrorCode, l as TArrayPatch, m as DbError, n as ValidatorMode, p as CasMismatchError, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch, v as bucketTimeZoneUnavailable, y as isConflict } from "./validator-B3xlbrWf.cjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-BWdQ7kRZ.cjs";
-import { i as tableNameOf } from "./relation-helpers-BLBrLQYi.cjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-wRqMYNBI.cjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, l as TArrayPatch, n as ValidatorMode, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-BcBtg8yW.cjs";
+import { i as searchMemberKind, r as TSearchMemberKind } from "./search-fields-CHqqcC3W.cjs";
+import { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-B5jW68T3.cjs";
+import { i as tableNameOf } from "./relation-helpers-BAEkP4bH.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 import { AtscriptExprNode as AtscriptExprNode$1, TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
@@ -557,18 +559,6 @@ declare function describeFulltext(index: Pick<TDbIndex, "fields">, textLabel: (n
  */
 declare function defaultFulltextIndex<T extends Pick<TDbIndex, "fields">>(indexes: readonly T[]): T | undefined;
 //#endregion
-//#region src/shared/search-fields.d.ts
-/** How a field takes part in `$search`: matched as text, or by whole-number equality / decimal text. */
-type TSearchMemberKind = "text" | "integer";
-/**
- * Runtime mirror of the plugin's verdict: how the annotated type takes part
- * in `$search`. Structures, arrays, unions and unresolved types keep their
- * legacy `"text"` treatment.
- */
-declare function searchMemberKind(type: TAtscriptAnnotatedType | undefined): TSearchMemberKind | {
-  problem: string;
-};
-//#endregion
 //#region src/query/read-columns.d.ts
 /**
  * What a read renders: rows (`findOne` / `findMany` / per-partition pages),
@@ -641,7 +631,7 @@ declare function assertNoVersionWrites(data: Record<string, unknown>, versionCol
  * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
  * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
  * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
- * (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+ * (keep the two side by side): PK keys and `@db.onUpdate.now` / `.inc` fields are
  * skipped; an exempt path (or one under an exempt ancestor) is covered
  * whatever its value (scalar, field op, array ops, object); a non-exempt
  * merge-strategy object recurses (only the supplied children are written);
@@ -676,9 +666,22 @@ declare function isDbEntityType(value: unknown): value is TAtscriptAnnotatedType
  * hash, and the next boot retries.
  */
 declare function createFailureCollector(what: string): {
-  attempt: (label: string, op: () => Promise<unknown>) => Promise<void>;
+  /** Runs `op`; `true` when it succeeded, `false` when its failure was collected. */attempt: (label: string, op: () => Promise<unknown>) => Promise<boolean>;
   throwIfAny: () => void;
 };
+/**
+ * Records the changes a sync pass makes — or, in a dry run, would make — so
+ * planning and syncing share one code path. `apply(change, label, op)`
+ * records `change` straight away in a dry run; otherwise it runs `op` first:
+ * through `attempt` when given (a {@link createFailureCollector} collector —
+ * a failure is collected and the change not recorded), else directly (a
+ * failure throws).
+ * @since 0.1.162
+ */
+declare function createChangeRecorder<C>(dryRun: boolean, attempt?: (label: string, op: () => Promise<unknown>) => Promise<boolean>): {
+  /** The changes recorded so far, in order. */changes: C[];
+  apply: (change: C, label: string, op: () => unknown) => Promise<void>;
+};
 //#endregion
 //#region src/query/aggregate-expr.d.ts
 /**
@@ -692,4 +695,4 @@ declare function createFailureCollector(what: string): {
  */
 declare function numericOperandProblem(fd: TDbFieldMeta): string | undefined;
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, 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 TDbActionTargetSummary, type TDbAvailableActions, 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 TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_ISOLATION_LEVELS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteManyOptions, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDbWriteLimit, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReadLockOptions, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TTransactionOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, stableJson, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,11 +1,13 @@
-import { $ as TDbInsertResult, $t as ALL_VIEW_CAPABILITIES, A as TColumnDiff, An as REL_FILTER_MAX_NODES, At as TPrimaryKeyChange, B as TDbDefaultFn, Bn as isResolvedRelationFilter, Bt as TValueFormatterPair, C as NavPropsOf, Cn as IntegrityStrategy, Ct as TIdDescriptor, D as PrimaryKeyOf, Dn as DbResponse, Dt as TJsonCopyTarget, E as OwnPropsOf, En as AtscriptDbReadable, Et as TInsertOptions, F as TDbActionLevel, Fn as TRelationStaticFilter, Ft as TSyncColumnResult, G as TDbIndex, Gn as FieldMappingStrategy, Gt as Uniquery, H as TDbDeleteResult, Hn as DbEncryption, Ht as TWriteOptions, I as TDbActionProcessor, In as andFilters, It as TSyncIndexesOptions, J as TDbInsertIgnoreOptions, Jn as TGenericLogger, Jt as TableMetadata, K as TDbIndexField, Kn as TReadControls, Kt as UniqueryControls, L as TDbActionTargetSummary, Ln as containsRelationFilter, Lt as TTableOptionDiff, M as TCrudPermissions, Mn as TRelGuardState, Mt as TRelationInfo, N as TDbActionInfo, Nn as TRelationFilterJunction, Nt as TRowResolveOptions, O as TCascadeResolver, On as resolveDesignType, Ot as TMetaResponse, P as TDbActionIntent, Pn as TRelationFilterTable, Pt as TSearchIndexInfo, Q as TDbInsertManyResult, Qn as UniquSelect, Qt as ALL_BUCKET_UNITS, R as TDbAvailableActions, Rn as forEachResolvedRelation, Rt as TTableResolver, S as FlatOf, Sn as AtscriptDbTable, St as TFkLookupTarget, T as NullsPlacement, Tn as TCascadePin, Tt as TIdentification, U as TDbFieldMeta, Un as TDbEncryptionOptions, Ut as TWriteTableResolver, V as TDbDefaultValue, Vn as relationStaticFilter, Vt as TViewJsonType, W as TDbForeignKey, Wn as DocumentFieldMapper, Wt as TypedWithRelation, X as TDbInsertIgnoreSlot, Xn as TFirstLast, Xt as isGeoPointType, Y as TDbInsertIgnoreResult, Yn as TExprAggregate, Yt as isGeoIndexableType, Z as TDbInsertManyIgnoreResult, Zn as TRowOrderKey, Zt as TPathPresence, _ as DbPatch, _n as TViewJoin, _t as TExistingColumn, a as isJsonValueField, an as AtscriptDbView, at as TDbStorageType, b as FieldOpsFor, bn as isFieldRef, bt as TFieldMeta, c as resolveCalendarBuckets, cn as isViewType, ct as TDbWriteAction, d as AggregateFn, dn as AtscriptExprNode, dt as TDbWriteGuard, en as BaseDbAdapter, et as TDbObjectKind, f as AggregateQuery, fn as AtscriptOrderItem, ft as TDbWriteGuardContext, g as DbControls, gn as AtscriptRef, gt as TEnsureTableOptions, h as AtscriptDbWritable, hn as AtscriptQueryNode, ht as TDerivedColumn, i as isBucketableField, in as TDbSpaceOptions, it as TDbRemoveGuardContext, j as TCrudOp, jn as ResolvedRelationFilter, jt as TReferencingForeignKey, k as TCascadeTarget, kn as REL_FILTER_MAX_DEPTH, kt as TMetadataOverrides, l as AggregateControls, ln as TViewReadPlan, lt as TDbWriteCheck, mn as AtscriptQueryFieldRef, mt as TDerivedChangeReason, n as TComputedSelect, nn as DbSpace, nt as TDbRelation, o as jsonValueAncestor, on as TViewColumnMapping, ot as TDbUpdateOptions, p as AggregateResult, pn as AtscriptQueryComparison, pt as TDeleteOptions, q as TDbIndexType, qn as NoopLogger, qt as WithRelation, r as TResolvedBucket, rn as TAdapterFactory, rt as TDbRemoveGuard, s as normalizeComputedSelect, sn as isAtscriptDbView, st as TDbUpdateResult, t as TBucketFieldSource, tn as TViewCapability, tt as TDbReferentialAction, u as AggregateExpr, un as aliasTargetOf, ut as TDbWriteCheckContext, v as DbQuery, vn as TViewPlan, vt as TExistingForeignKey, w as NullableOptional, wn as NativeIntegrity, wt as TIdResolveOptions, x as FilterExpr, xn as translateQueryTree, xt as TFkLookupResolver, y as DbRow, yn as evaluateExpr, yt as TExistingTableOption, z as TDbCollation, zn as hasRelationOp, zt as TTouchManyOptions } from "./buckets-8mG67Mtw.mjs";
+import { $ as TDbInsertManyIgnoreResult, $n as hasRelationOp, $t as TWriteOptions, A as TCascadeTarget, An as AtscriptRef, At as TForeignKeyChange, B as TDbCollation, Bn as AtscriptDbReadable, Bt as TReadLockOptions, C as NavPropsOf, Cn as TViewReadPlan, Ct as TEnsureTableOptions, D as PrimaryKeyOf, Dn as AtscriptQueryComparison, Dt as TFieldMeta, E as OwnPropsOf, En as AtscriptOrderItem, Et as TExistingTableOption, F as TDbActionIntent, Fn as translateQueryTree, Ft as TInsertOptions, G as TDbFieldMeta, Gn as ResolvedRelationFilter, Gt as TSyncColumnResult, H as TDbDefaultValue, Hn as resolveDesignType, Ht as TRelationInfo, I as TDbActionLevel, In as AtscriptDbTable, It as TJsonCopyTarget, J as TDbIndexField, Jn as TRelationFilterTable, Jt as TTableResolver, K as TDbForeignKey, Kn as TRelGuardState, Kt as TSyncIndexesOptions, L as TDbActionProcessor, Ln as IntegrityStrategy, Lt as TMetaResponse, M as TCrudOp, Mn as TViewPlan, Mt as TIdResolveOptions, N as TCrudPermissions, Nn as evaluateExpr, Nt as TIdentification, O as TBulkWriteOptions, On as AtscriptQueryFieldRef, Ot as TFkLookupResolver, P as TDbActionInfo, Pn as isFieldRef, Pt as TIndexChange, Q as TDbInsertIgnoreSlot, Qn as forEachResolvedRelation, Qt as TViewJsonType, R as TDbActionTargetSummary, Rn as NativeIntegrity, Rt as TMetadataOverrides, S as FlatOf, Sn as isViewType, St as TDerivedColumn, T as NullsPlacement, Tn as AtscriptExprNode, Tt as TExistingForeignKey, U as TDbDeleteManyOptions, Un as REL_FILTER_MAX_DEPTH, Ut as TRowResolveOptions, V as TDbDefaultFn, Vn as DbResponse, Vt as TReferencingForeignKey, W as TDbDeleteResult, Wn as REL_FILTER_MAX_NODES, Wt as TSearchIndexInfo, X as TDbInsertIgnoreOptions, Xn as andFilters, Xt as TTransactionOptions, Y as TDbIndexType, Yn as TRelationStaticFilter, Yt as TTouchManyOptions, Z as TDbInsertIgnoreResult, Zn as containsRelationFilter, Zt as TValueFormatterPair, _ as DbPatch, _n as TAdapterFactory, _t as TDbWriteGuard, a as isJsonValueField, an as TableMetadata, ar as FieldMappingStrategy, at as TDbObjectKind, b as FieldOpsFor, bn as TViewColumnMapping, bt as TDeleteOptions, c as resolveCalendarBuckets, cn as TPathPresence, cr as TGenericLogger, ct as TDbRelation, d as AggregateFn, dn as ALL_VIEW_CAPABILITIES, dr as TRowOrderKey, dt as TDbStorageType, en as TWriteTableResolver, er as isResolvedRelationFilter, et as TDbInsertManyResult, f as AggregateQuery, fn as BaseDbAdapter, fr as UniquSelect, ft as TDbUpdateOptions, g as DbControls, gn as DbSpace, gt as TDbWriteCheckContext, h as AtscriptDbWritable, hn as TViewCapability, ht as TDbWriteCheck, i as isBucketableField, in as WithRelation, ir as DocumentFieldMapper, it as TDbLockWait, j as TColumnDiff, jn as TViewJoin, jt as TIdDescriptor, k as TCascadeResolver, kn as AtscriptQueryNode, kt as TFkLookupTarget, l as AggregateControls, ln as ALL_BUCKET_UNITS, lr as TExprAggregate, lt as TDbRemoveGuard, mn as TIndexDiffOptions, mt as TDbWriteAction, n as TComputedSelect, nn as Uniquery, nr as DbEncryption, nt as TDbIsolationLevel, o as jsonValueAncestor, on as isGeoIndexableType, or as TReadControls, ot as TDbReadLock, p as AggregateResult, pn as TForeignKeyDiffOptions, pt as TDbUpdateResult, q as TDbIndex, qn as TRelationFilterJunction, qt as TTableOptionDiff, r as TResolvedBucket, rn as UniqueryControls, rr as TDbEncryptionOptions, rt as TDbLockMode, s as normalizeComputedSelect, sn as isGeoPointType, sr as NoopLogger, st as TDbReferentialAction, t as TBucketFieldSource, tn as TypedWithRelation, tr as relationStaticFilter, tt as TDbInsertResult, u as AggregateExpr, un as ALL_ISOLATION_LEVELS, ur as TFirstLast, ut as TDbRemoveGuardContext, v as DbQuery, vn as TDbSpaceOptions, vt as TDbWriteGuardContext, w as NullableOptional, wn as aliasTargetOf, wt as TExistingColumn, x as FilterExpr, xn as isAtscriptDbView, xt as TDerivedChangeReason, y as DbRow, yn as AtscriptDbView, yt as TDbWriteLimit, z as TDbAvailableActions, zn as TCascadePin, zt as TPrimaryKeyChange } from "./buckets-DUTcrT4Z.mjs";
+import { a as aggregateExpressionsNotSupported, c as isConflict, i as DbErrorCode, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-B_DRL1E9.mjs";
 import { _ as separateFieldOps, a as $mul, c as $update, d as TDbFieldOp, f as TFieldOps, g as separateCas, h as reconcileCas, i as $insert, l as $upsert, m as isDbFieldOp, n as $dec, o as $remove, p as getDbFieldOp, r as $inc, s as $replace, t as $cas, u as TDbCas } from "./ops-AqhV7s9o.mjs";
-import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-CtPYTIvy.mjs";
+import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, s as stableJson, t as deletePath } from "./object-Czia_qD4.mjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-Wo-smrYV.mjs";
-import { _ as aggregateFailure, a as buildValidationContext, b as isRetryableDbError, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as aggregateExpressionsNotSupported, h as DbErrorCode, l as TArrayPatch, m as DbError, n as ValidatorMode, p as CasMismatchError, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch, v as bucketTimeZoneUnavailable, y as isConflict } from "./validator-B3xlbrWf.mjs";
-import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-5gX42hBt.mjs";
-import { i as tableNameOf } from "./relation-helpers-17_2f5hX.mjs";
+import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-wRqMYNBI.mjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, l as TArrayPatch, n as ValidatorMode, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as TDbPatch } from "./validator-BcBtg8yW.mjs";
+import { i as searchMemberKind, r as TSearchMemberKind } from "./search-fields-CHqqcC3W.mjs";
+import { c as isColumnTypeChanged, i as fkKey, r as fkColumns } from "./fk-diff-PhVBYohc.mjs";
+import { i as tableNameOf } from "./relation-helpers-BSYwxOSA.mjs";
 import { AtscriptExprNode as AtscriptExprNode$1, TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, RELATION_OPS, RelationOp, RelationOp as RelationOp$1, ResolvedRowOrderKey, ResolvedSelectExpr, Uniquery as Uniquery$1, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 
@@ -557,18 +559,6 @@ declare function describeFulltext(index: Pick<TDbIndex, "fields">, textLabel: (n
  */
 declare function defaultFulltextIndex<T extends Pick<TDbIndex, "fields">>(indexes: readonly T[]): T | undefined;
 //#endregion
-//#region src/shared/search-fields.d.ts
-/** How a field takes part in `$search`: matched as text, or by whole-number equality / decimal text. */
-type TSearchMemberKind = "text" | "integer";
-/**
- * Runtime mirror of the plugin's verdict: how the annotated type takes part
- * in `$search`. Structures, arrays, unions and unresolved types keep their
- * legacy `"text"` treatment.
- */
-declare function searchMemberKind(type: TAtscriptAnnotatedType | undefined): TSearchMemberKind | {
-  problem: string;
-};
-//#endregion
 //#region src/query/read-columns.d.ts
 /**
  * What a read renders: rows (`findOne` / `findMany` / per-partition pages),
@@ -641,7 +631,7 @@ declare function assertNoVersionWrites(data: Record<string, unknown>, versionCol
  * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
  * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
  * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
- * (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+ * (keep the two side by side): PK keys and `@db.onUpdate.now` / `.inc` fields are
  * skipped; an exempt path (or one under an exempt ancestor) is covered
  * whatever its value (scalar, field op, array ops, object); a non-exempt
  * merge-strategy object recurses (only the supplied children are written);
@@ -676,9 +666,22 @@ declare function isDbEntityType(value: unknown): value is TAtscriptAnnotatedType
  * hash, and the next boot retries.
  */
 declare function createFailureCollector(what: string): {
-  attempt: (label: string, op: () => Promise<unknown>) => Promise<void>;
+  /** Runs `op`; `true` when it succeeded, `false` when its failure was collected. */attempt: (label: string, op: () => Promise<unknown>) => Promise<boolean>;
   throwIfAny: () => void;
 };
+/**
+ * Records the changes a sync pass makes — or, in a dry run, would make — so
+ * planning and syncing share one code path. `apply(change, label, op)`
+ * records `change` straight away in a dry run; otherwise it runs `op` first:
+ * through `attempt` when given (a {@link createFailureCollector} collector —
+ * a failure is collected and the change not recorded), else directly (a
+ * failure throws).
+ * @since 0.1.162
+ */
+declare function createChangeRecorder<C>(dryRun: boolean, attempt?: (label: string, op: () => Promise<unknown>) => Promise<boolean>): {
+  /** The changes recorded so far, in order. */changes: C[];
+  apply: (change: C, label: string, op: () => unknown) => Promise<void>;
+};
 //#endregion
 //#region src/query/aggregate-expr.d.ts
 /**
@@ -692,4 +695,4 @@ declare function createFailureCollector(what: string): {
  */
 declare function numericOperandProblem(fd: TDbFieldMeta): string | undefined;
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, 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 TDbActionTargetSummary, type TDbAvailableActions, 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 TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_ISOLATION_LEVELS, ALL_VIEW_CAPABILITIES, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptExprNode, type AtscriptOrderItem, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type NullsPlacement, type OwnPropsOf, type PrimaryKeyOf, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, type RelationOp, RelationalFieldMapper, type ResolvedBucket, ResolvedRelationFilter, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TBulkWriteOptions, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbActionTargetSummary, type TDbAvailableActions, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteManyOptions, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertIgnoreOptions, type TDbInsertIgnoreResult, type TDbInsertIgnoreSlot, type TDbInsertManyIgnoreResult, type TDbInsertManyResult, type TDbInsertResult, type TDbIsolationLevel, type TDbLockMode, type TDbLockWait, type TDbObjectKind, type TDbPatch, type TDbReadLock, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateOptions, type TDbUpdateResult, type TDbWriteAction, type TDbWriteCheck, type TDbWriteCheckContext, type TDbWriteGuard, type TDbWriteGuardContext, type TDbWriteLimit, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TExprAggregate, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFirstLast, type TFkLookupResolver, type TFkLookupTarget, type TForeignKeyChange, type TForeignKeyDiffOptions, type TGenericLogger, type TGroupSourceVerdict, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TIndexChange, type TIndexDiffOptions, type TInsertOptions, type TJsonCopyTarget, type TMetaResponse, type TMetadataOverrides, type TPathPresence, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadColumnsKind, type TReadControls, type TReadLockOptions, type TReferencingForeignKey, type TRelationFilterJunction, type TRelationFilterTable, type TRelationInfo, type TRelationStaticFilter, type TResolvedBucket, type TRowOrderKey, type TRowResolveOptions, type TSearchIndexInfo, type TSearchMemberKind, type TSyncColumnResult, type TSyncIndexesOptions, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TTransactionOptions, type TValueFormatterPair, type TViewCapability, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TViewReadPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, stableJson, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import { a as aggregateExpressionsNotSupported, c as isConflict, l as isRetryableDbError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError, u as spaceClosedError } from "./db-error-eSsQX7rt.mjs";
-import { $ as RelationalFieldMapper, A as AtscriptDbReadable, B as canFilterLeaf, C as ApplicationIntegrity, D as createFailureCollector, E as BaseDbAdapter, F as ADAPTER_FILTER_REASON, G as guardAggregate, H as classifyQueryPath, I as ENCRYPTED_REASON, J as guardPaths, K as guardFilter, L as acceptedOperatorsHint, M as geoIndexNotFoundMessage, N as searchIndexNotFoundMessage, O as IntegrityStrategy, P as vectorIndexNotFoundMessage, Q as unsupportedOperatorMessage, R as assertGeoPoint, S as decomposePatch, T as ALL_VIEW_CAPABILITIES, U as collectQueryPaths, V as checkHavingKeys, W as groupSourceVerdict, X as narrowerFilterOps, Y as guardQuery, Z as sortFieldNames, _ as isAtscriptDbView, _t as normalizeComputedSelect, at as defaultFulltextIndex, b as isVersionExemptPatch, ct as splitFulltextFields, dt as isGeoPointType, et as DocumentFieldMapper, g as AtscriptDbView, gt as jsonValueAncestor, ht as isJsonValueField, it as INTEGER_REGEX_OP, j as resolveDesignType, k as NativeIntegrity, lt as TableMetadata, mt as isBucketableField, n as isColumnTypeChanged, nt as UniquSelect, ot as describeFulltext, p as fkColumns, pt as aliasTargetOf, q as guardPath, rt as numericOperandProblem, st as searchTermInteger, tt as FieldMappingStrategy, ut as isGeoIndexableType, v as isViewType, vt as resolveCalendarBuckets, w as ALL_BUCKET_UNITS, x as assertNoVersionWrites, y as AtscriptDbTable, yt as NoopLogger, z as bucketSourceVerdict } from "./column-diff-DR1glykD.mjs";
-import { n as ALL_AGGREGATE_FNS } from "./aggregate-fns-B_sgl4mB.mjs";
-import { A as hasRelationOp, C as REL_FILTER_MAX_DEPTH, D as containsRelationFilter, E as andFilters, G as evaluateExpr, H as tableNameOf, K as isFieldRef, P as relationStaticFilter, S as uniqueKeyTuple, T as ResolvedRelationFilter, j as isResolvedRelationFilter, k as forEachResolvedRelation, q as translateQueryTree, w as REL_FILTER_MAX_NODES } from "./nested-writer-BOj_c_lI.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-B3fPJjS1.mjs";
-import { i as DB_ENTITY_ANNOTATIONS, n as searchMemberKind } from "./search-fields-CE8cmj9X.mjs";
-import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-TkiJQ-Dp.mjs";
+import { a as aggregateExpressionsNotSupported, c as invalidQuery, d as spaceClosedError, l as isConflict, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError, u as isRetryableDbError } from "./db-error-hraC12B9.mjs";
+import { $ as narrowerFilterOps, B as acceptedOperatorsHint, C as ALL_VIEW_CAPABILITIES, E as createFailureCollector, F as geoIndexNotFoundMessage, G as classifyQueryPath, H as bucketSourceVerdict, I as searchIndexNotFoundMessage, J as guardAggregate, K as collectQueryPaths, L as vectorIndexNotFoundMessage, M as NativeIntegrity, N as AtscriptDbReadable, O as fkColumns, P as resolveDesignType, Q as guardQuery, R as ADAPTER_FILTER_REASON, S as ALL_ISOLATION_LEVELS, St as NoopLogger, T as createChangeRecorder, U as canFilterLeaf, V as assertGeoPoint, W as checkHavingKeys, X as guardPath, Y as guardFilter, Z as guardPaths, _ as isVersionExemptPatch, _t as isBucketableField, at as UniquSelect, b as ApplicationIntegrity, bt as normalizeComputedSelect, ct as defaultFulltextIndex, dt as splitFulltextFields, et as sortFieldNames, ft as TableMetadata, g as AtscriptDbTable, gt as aliasTargetOf, h as isViewType, it as FieldMappingStrategy, j as IntegrityStrategy, k as fkKey, lt as describeFulltext, m as isAtscriptDbView, mt as isGeoPointType, n as isColumnTypeChanged, nt as RelationalFieldMapper, ot as numericOperandProblem, p as AtscriptDbView, pt as isGeoIndexableType, q as groupSourceVerdict, rt as DocumentFieldMapper, st as INTEGER_REGEX_OP, tt as unsupportedOperatorMessage, ut as searchTermInteger, v as assertNoVersionWrites, vt as isJsonValueField, w as BaseDbAdapter, x as ALL_BUCKET_UNITS, xt as resolveCalendarBuckets, y as decomposePatch, yt as jsonValueAncestor, z as ENCRYPTED_REASON } from "./column-diff-pdn53AIj.mjs";
+import { n as ALL_AGGREGATE_FNS } from "./aggregate-fns-DsS9UQVB.mjs";
+import { A as hasRelationOp, C as REL_FILTER_MAX_DEPTH, D as containsRelationFilter, E as andFilters, G as evaluateExpr, H as tableNameOf, K as isFieldRef, P as relationStaticFilter, S as uniqueKeyTuple, T as ResolvedRelationFilter, j as isResolvedRelationFilter, k as forEachResolvedRelation, q as translateQueryTree, w as REL_FILTER_MAX_NODES } from "./nested-writer-ClUX0DB0.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-DuDWsIdQ.mjs";
+import { a as searchMemberKind, s as DB_ENTITY_ANNOTATIONS } from "./search-fields-0U0FAFGj.mjs";
+import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, s as stableJson, t as deletePath } from "./object-PQ1J8jri.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";
 import { isAnnotatedType } from "@atscript/typescript/utils";
@@ -174,10 +174,7 @@ var DbEncryption = class {
 */
 async function withOptimisticRetry(table, filter, mutator, opts) {
 	const versionColumn = table.versionColumn;
-	if (versionColumn === void 0) throw new DbError("INVALID_QUERY", [{
-		path: "$cas",
-		message: `withOptimisticRetry: table "${table.tableName}" has no @db.column.version column — CAS cannot be applied`
-	}]);
+	if (versionColumn === void 0) throw invalidQuery("$cas", `withOptimisticRetry: table "${table.tableName}" has no @db.column.version column — CAS cannot be applied`);
 	const maxAttempts = opts?.maxAttempts ?? 5;
 	let lastSeenVersion;
 	for (let attempt = 1; attempt <= maxAttempts; attempt++) {
@@ -560,4 +557,4 @@ function isDbEntityType(value) {
 	return DB_ENTITY_ANNOTATIONS.some((name) => value.metadata.has(name));
 }
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, NoopLogger, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, RelationalFieldMapper, ResolvedRelationFilter, TableMetadata, UniquSelect, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_ISOLATION_LEVELS, ALL_VIEW_CAPABILITIES, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, INTEGER_REGEX_OP, IntegrityStrategy, NativeIntegrity, NoopLogger, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, RelationalFieldMapper, ResolvedRelationFilter, TableMetadata, UniquSelect, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createChangeRecorder, createDbValidatorPlugin, createFailureCollector, decomposePatch, defaultFulltextIndex, deletePath, describeFulltext, evaluateExpr, findAncestorInSet, fkColumns, fkKey, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isRetryableDbError, isVersionExemptPatch, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, queryReadColumns, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, searchMemberKind, searchTermInteger, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, splitFulltextFields, stableJson, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };

package/dist/{nested-writer-BOj_c_lI.mjs → nested-writer-ClUX0DB0.mjs}

@@ -1,5 +1,5 @@
-import { i as DepthLimitExceededError, r as DbError } from "./db-error-eSsQX7rt.mjs";
-import { a as isPlainObject, r as getPath } from "./object-TkiJQ-Dp.mjs";
+import { c as invalidQuery, i as DepthLimitExceededError, r as DbError } from "./db-error-hraC12B9.mjs";
+import { a as isPlainObject, r as getPath } from "./object-PQ1J8jri.mjs";
 import { ValidatorError } from "@atscript/typescript/utils";
 import { isRelationOp } from "@uniqu/core";
 //#region src/query/query-tree.ts
@@ -351,12 +351,6 @@ function relGuardState(write = false) {
 		path: ""
 	};
 }
-function invalid(path, message) {
-	return new DbError("INVALID_QUERY", [{
-		path,
-		message
-	}]);
-}
 function notSupported(path, message) {
 	return new DbError("REL_FILTER_NOT_SUPPORTED", [{
 		path,
@@ -395,7 +389,7 @@ function relationStaticFilter(relation, name = "") {
 		const type = ref.type?.();
 		if (!type || type === targetType || tableNameOf(type) === targetName) return "target";
 		if (junctionType && (type === junctionType || tableNameOf(type) === junctionName)) return "junction";
-		throw invalid(name, `@db.rel.filter on "${name}" references a type other than the related type` + (junctionType ? " and the junction" : "") + " — only those can be referenced");
+		throw invalidQuery(name, `@db.rel.filter on "${name}" references a type other than the related type` + (junctionType ? " and the junction" : "") + " — only those can be referenced");
 	};
 	const target = [];
 	const junction = [];
@@ -403,7 +397,7 @@ function relationStaticFilter(relation, name = "") {
 	for (const conjunct of conjuncts) {
 		const sides = /* @__PURE__ */ new Set();
 		collectSides(conjunct, (ref) => sides.add(sideOf(ref)), name);
-		if (sides.size > 1) throw invalid(name, `@db.rel.filter on "${name}" has a condition reading both the junction and the related type — split it into separate "and" conditions`);
+		if (sides.size > 1) throw invalidQuery(name, `@db.rel.filter on "${name}" has a condition reading both the junction and the related type — split it into separate "and" conditions`);
 		const filter = translateQueryTree(conjunct, (ref) => ref.field);
 		(sides.has("junction") ? junction : target).push(filter);
 	}
@@ -428,7 +422,7 @@ function collectSides(node, visit, name) {
 		return;
 	}
 	visit(node.left);
-	if (isFieldRef(node.right)) throw invalid(name, `@db.rel.filter on "${name}" compares two fields — only field-to-value conditions are supported`);
+	if (isFieldRef(node.right)) throw invalidQuery(name, `@db.rel.filter on "${name}" compares two fields — only field-to-value conditions are supported`);
 }
 function zip(left, right, a, b) {
 	return left.map((value, i) => ({
@@ -452,14 +446,14 @@ function createRelationFilterHost(owner, resolve) {
 		if (cached) return cached;
 		const meta = owner.getMetadata();
 		const relation = meta.relations.get(nav);
-		if (!relation) throw invalid(path, `"$some" / "$none" are only valid on a navigation relation — "${nav}" is not one`);
+		if (!relation) throw invalidQuery(path, `"$some" / "$none" are only valid on a navigation relation — "${nav}" is not one`);
 		const target = resolve(relation.targetType());
 		if (!target) throw notSupported(path, `Relational predicate on "${path}": the related table is not available`);
 		sameAdapter(target, path, "related");
 		let plan;
 		if (relation.direction === "to") {
 			const fk = findFKEntryForRelation(relation, meta.foreignKeys);
-			if (!fk) throw invalid(path, `Relation "${nav}" has no foreign key to filter by`);
+			if (!fk) throw invalidQuery(path, `Relation "${nav}" has no foreign key to filter by`);
 			plan = {
 				kind: "to",
 				relation,
@@ -468,7 +462,7 @@ function createRelationFilterHost(owner, resolve) {
 			};
 		} else if (relation.direction === "from") {
 			const fk = findRemoteFK(target.getMetadata(), owner.tableName, relation.alias);
-			if (!fk) throw invalid(path, `Relation "${nav}" has no foreign key to filter by`);
+			if (!fk) throw invalidQuery(path, `Relation "${nav}" has no foreign key to filter by`);
 			plan = {
 				kind: "from",
 				relation,
@@ -483,8 +477,8 @@ function createRelationFilterHost(owner, resolve) {
 			const junctionMeta = junction.getMetadata();
 			const fkToThis = findRemoteFK(junctionMeta, owner.tableName);
 			const fkToTarget = findRemoteFK(junctionMeta, tableNameOf(relation.targetType()));
-			if (!fkToThis || !fkToTarget) throw invalid(path, `Relation "${nav}" has no junction foreign keys to filter by`);
-			if (fkToThis === fkToTarget) throw invalid(path, `Relation "${nav}" is a self-referencing many-to-many — relational predicates cannot tell its two junction keys apart`);
+			if (!fkToThis || !fkToTarget) throw invalidQuery(path, `Relation "${nav}" has no junction foreign keys to filter by`);
+			if (fkToThis === fkToTarget) throw invalidQuery(path, `Relation "${nav}" is a self-referencing many-to-many — relational predicates cannot tell its two junction keys apart`);
 			plan = {
 				kind: "via",
 				relation,
@@ -512,9 +506,9 @@ function createRelationFilterHost(owner, resolve) {
 		guard(nav, op, inner, state) {
 			const path = state.path ? `${state.path}.${nav}` : nav;
 			const depth = state.depth + 1;
-			if (depth > 4) throw invalid("", `Relational predicates nest at most 4 levels deep`);
-			if (++state.counter.nodes > 16) throw invalid("", `At most 16 relational predicates per query`);
-			if (!isPlainObject(inner)) throw invalid(path, `"${op}" on "${path}" expects a filter object`);
+			if (depth > 4) throw invalidQuery("", `Relational predicates nest at most 4 levels deep`);
+			if (++state.counter.nodes > 16) throw invalidQuery("", `At most 16 relational predicates per query`);
+			if (!isPlainObject(inner)) throw invalidQuery(path, `"${op}" on "${path}" expects a filter object`);
 			const plan = planOf(nav, path);
 			relationStaticFilter(plan.relation, path);
 			try {
@@ -528,7 +522,7 @@ function createRelationFilterHost(owner, resolve) {
 			}
 		},
 		resolve(nav, _op, inner, depth) {
-			if (depth > 4) throw invalid("", `Relational predicates nest at most 4 levels deep`);
+			if (depth > 4) throw invalidQuery("", `Relational predicates nest at most 4 levels deep`);
 			const plan = planOf(nav, nav);
 			const ownerMeta = owner.getMetadata();
 			const targetMeta = plan.target.getMetadata();
@@ -616,12 +610,12 @@ function resolveRelationFilterTree(filter, meta, depth) {
 function resolvePredicateMap(key, value, meta, depth) {
 	const host = meta.relationFilters;
 	if (!host) {
-		if (!meta.navFields.has(key)) throw invalid(key, `"$some" / "$none" are only valid on a navigation relation — "${key}" is not one`);
+		if (!meta.navFields.has(key)) throw invalidQuery(key, `"$some" / "$none" are only valid on a navigation relation — "${key}" is not one`);
 		throw notSupported(key, `Relational predicate on "${key}" needs the table to come from a DbSpace (no table resolver)`);
 	}
 	const ops = {};
 	for (const [op, operand] of Object.entries(value)) {
-		if (!isRelationOp(op)) throw invalid(key, `Cannot mix "$some" / "$none" with "${op}" on "${key}"`);
+		if (!isRelationOp(op)) throw invalidQuery(key, `Cannot mix "$some" / "$none" with "${op}" on "${key}"`);
 		ops[op] = isResolvedRelationFilter(operand) ? operand : host.resolve(key, op, operand, depth + 1);
 	}
 	return ops;

package/dist/{nested-writer-Bl1SZS7x.cjs → nested-writer-yCy6wGuN.cjs}

@@ -1,5 +1,5 @@
-const require_db_error = require("./db-error-JcfJqqpk.cjs");
-const require_object = require("./object-Djg28csK.cjs");
+const require_db_error = require("./db-error-DmF1_xrz.cjs");
+const require_object = require("./object-GjsuPNqo.cjs");
 let _atscript_typescript_utils = require("@atscript/typescript/utils");
 let _uniqu_core = require("@uniqu/core");
 //#region src/query/query-tree.ts
@@ -351,12 +351,6 @@ function relGuardState(write = false) {
 		path: ""
 	};
 }
-function invalid(path, message) {
-	return new require_db_error.DbError("INVALID_QUERY", [{
-		path,
-		message
-	}]);
-}
 function notSupported(path, message) {
 	return new require_db_error.DbError("REL_FILTER_NOT_SUPPORTED", [{
 		path,
@@ -395,7 +389,7 @@ function relationStaticFilter(relation, name = "") {
 		const type = ref.type?.();
 		if (!type || type === targetType || tableNameOf(type) === targetName) return "target";
 		if (junctionType && (type === junctionType || tableNameOf(type) === junctionName)) return "junction";
-		throw invalid(name, `@db.rel.filter on "${name}" references a type other than the related type` + (junctionType ? " and the junction" : "") + " — only those can be referenced");
+		throw require_db_error.invalidQuery(name, `@db.rel.filter on "${name}" references a type other than the related type` + (junctionType ? " and the junction" : "") + " — only those can be referenced");
 	};
 	const target = [];
 	const junction = [];
@@ -403,7 +397,7 @@ function relationStaticFilter(relation, name = "") {
 	for (const conjunct of conjuncts) {
 		const sides = /* @__PURE__ */ new Set();
 		collectSides(conjunct, (ref) => sides.add(sideOf(ref)), name);
-		if (sides.size > 1) throw invalid(name, `@db.rel.filter on "${name}" has a condition reading both the junction and the related type — split it into separate "and" conditions`);
+		if (sides.size > 1) throw require_db_error.invalidQuery(name, `@db.rel.filter on "${name}" has a condition reading both the junction and the related type — split it into separate "and" conditions`);
 		const filter = translateQueryTree(conjunct, (ref) => ref.field);
 		(sides.has("junction") ? junction : target).push(filter);
 	}
@@ -428,7 +422,7 @@ function collectSides(node, visit, name) {
 		return;
 	}
 	visit(node.left);
-	if (isFieldRef(node.right)) throw invalid(name, `@db.rel.filter on "${name}" compares two fields — only field-to-value conditions are supported`);
+	if (isFieldRef(node.right)) throw require_db_error.invalidQuery(name, `@db.rel.filter on "${name}" compares two fields — only field-to-value conditions are supported`);
 }
 function zip(left, right, a, b) {
 	return left.map((value, i) => ({
@@ -452,14 +446,14 @@ function createRelationFilterHost(owner, resolve) {
 		if (cached) return cached;
 		const meta = owner.getMetadata();
 		const relation = meta.relations.get(nav);
-		if (!relation) throw invalid(path, `"$some" / "$none" are only valid on a navigation relation — "${nav}" is not one`);
+		if (!relation) throw require_db_error.invalidQuery(path, `"$some" / "$none" are only valid on a navigation relation — "${nav}" is not one`);
 		const target = resolve(relation.targetType());
 		if (!target) throw notSupported(path, `Relational predicate on "${path}": the related table is not available`);
 		sameAdapter(target, path, "related");
 		let plan;
 		if (relation.direction === "to") {
 			const fk = findFKEntryForRelation(relation, meta.foreignKeys);
-			if (!fk) throw invalid(path, `Relation "${nav}" has no foreign key to filter by`);
+			if (!fk) throw require_db_error.invalidQuery(path, `Relation "${nav}" has no foreign key to filter by`);
 			plan = {
 				kind: "to",
 				relation,
@@ -468,7 +462,7 @@ function createRelationFilterHost(owner, resolve) {
 			};
 		} else if (relation.direction === "from") {
 			const fk = findRemoteFK(target.getMetadata(), owner.tableName, relation.alias);
-			if (!fk) throw invalid(path, `Relation "${nav}" has no foreign key to filter by`);
+			if (!fk) throw require_db_error.invalidQuery(path, `Relation "${nav}" has no foreign key to filter by`);
 			plan = {
 				kind: "from",
 				relation,
@@ -483,8 +477,8 @@ function createRelationFilterHost(owner, resolve) {
 			const junctionMeta = junction.getMetadata();
 			const fkToThis = findRemoteFK(junctionMeta, owner.tableName);
 			const fkToTarget = findRemoteFK(junctionMeta, tableNameOf(relation.targetType()));
-			if (!fkToThis || !fkToTarget) throw invalid(path, `Relation "${nav}" has no junction foreign keys to filter by`);
-			if (fkToThis === fkToTarget) throw invalid(path, `Relation "${nav}" is a self-referencing many-to-many — relational predicates cannot tell its two junction keys apart`);
+			if (!fkToThis || !fkToTarget) throw require_db_error.invalidQuery(path, `Relation "${nav}" has no junction foreign keys to filter by`);
+			if (fkToThis === fkToTarget) throw require_db_error.invalidQuery(path, `Relation "${nav}" is a self-referencing many-to-many — relational predicates cannot tell its two junction keys apart`);
 			plan = {
 				kind: "via",
 				relation,
@@ -512,9 +506,9 @@ function createRelationFilterHost(owner, resolve) {
 		guard(nav, op, inner, state) {
 			const path = state.path ? `${state.path}.${nav}` : nav;
 			const depth = state.depth + 1;
-			if (depth > 4) throw invalid("", `Relational predicates nest at most 4 levels deep`);
-			if (++state.counter.nodes > 16) throw invalid("", `At most 16 relational predicates per query`);
-			if (!require_object.isPlainObject(inner)) throw invalid(path, `"${op}" on "${path}" expects a filter object`);
+			if (depth > 4) throw require_db_error.invalidQuery("", `Relational predicates nest at most 4 levels deep`);
+			if (++state.counter.nodes > 16) throw require_db_error.invalidQuery("", `At most 16 relational predicates per query`);
+			if (!require_object.isPlainObject(inner)) throw require_db_error.invalidQuery(path, `"${op}" on "${path}" expects a filter object`);
 			const plan = planOf(nav, path);
 			relationStaticFilter(plan.relation, path);
 			try {
@@ -528,7 +522,7 @@ function createRelationFilterHost(owner, resolve) {
 			}
 		},
 		resolve(nav, _op, inner, depth) {
-			if (depth > 4) throw invalid("", `Relational predicates nest at most 4 levels deep`);
+			if (depth > 4) throw require_db_error.invalidQuery("", `Relational predicates nest at most 4 levels deep`);
 			const plan = planOf(nav, nav);
 			const ownerMeta = owner.getMetadata();
 			const targetMeta = plan.target.getMetadata();
@@ -616,12 +610,12 @@ function resolveRelationFilterTree(filter, meta, depth) {
 function resolvePredicateMap(key, value, meta, depth) {
 	const host = meta.relationFilters;
 	if (!host) {
-		if (!meta.navFields.has(key)) throw invalid(key, `"$some" / "$none" are only valid on a navigation relation — "${key}" is not one`);
+		if (!meta.navFields.has(key)) throw require_db_error.invalidQuery(key, `"$some" / "$none" are only valid on a navigation relation — "${key}" is not one`);
 		throw notSupported(key, `Relational predicate on "${key}" needs the table to come from a DbSpace (no table resolver)`);
 	}
 	const ops = {};
 	for (const [op, operand] of Object.entries(value)) {
-		if (!(0, _uniqu_core.isRelationOp)(op)) throw invalid(key, `Cannot mix "$some" / "$none" with "${op}" on "${key}"`);
+		if (!(0, _uniqu_core.isRelationOp)(op)) throw require_db_error.invalidQuery(key, `Cannot mix "$some" / "$none" with "${op}" on "${key}"`);
 		ops[op] = isResolvedRelationFilter(operand) ? operand : host.resolve(key, op, operand, depth + 1);
 	}
 	return ops;

package/dist/{object-CtPYTIvy.d.cts → object-Czia_qD4.d.cts}

@@ -28,5 +28,11 @@ declare function getPath(row: Record<string, unknown>, path: string | readonly s
  * @since 0.1.141
  */
 declare function deletePath(target: Record<string, unknown>, path: string | readonly string[]): void;
+/**
+ * `JSON.stringify` with object keys sorted at every level — one string per
+ * JSON value, whatever its key order (`{"b":1,"a":2}` = `{"a":2,"b":1}`).
+ * @since 0.1.162
+ */
+declare function stableJson(value: unknown): string;
 //#endregion
-export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, selfOrAncestor as o, getPath as r, deletePath as t };
+export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, selfOrAncestor as o, getPath as r, stableJson as s, deletePath as t };

package/dist/{object-CtPYTIvy.d.mts → object-Czia_qD4.d.mts}

@@ -28,5 +28,11 @@ declare function getPath(row: Record<string, unknown>, path: string | readonly s
  * @since 0.1.141
  */
 declare function deletePath(target: Record<string, unknown>, path: string | readonly string[]): void;
+/**
+ * `JSON.stringify` with object keys sorted at every level — one string per
+ * JSON value, whatever its key order (`{"b":1,"a":2}` = `{"a":2,"b":1}`).
+ * @since 0.1.162
+ */
+declare function stableJson(value: unknown): string;
 //#endregion
-export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, selfOrAncestor as o, getPath as r, deletePath as t };
+export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, selfOrAncestor as o, getPath as r, stableJson as s, deletePath as t };

package/dist/{object-Djg28csK.cjs → object-GjsuPNqo.cjs}

@@ -62,6 +62,19 @@ function deletePath(target, path) {
 	}
 	if (current !== null && typeof current === "object" && !Array.isArray(current)) delete current[segments[segments.length - 1]];
 }
+/**
+* `JSON.stringify` with object keys sorted at every level — one string per
+* JSON value, whatever its key order (`{"b":1,"a":2}` = `{"a":2,"b":1}`).
+* @since 0.1.162
+*/
+function stableJson(value) {
+	return JSON.stringify(value, (_key, v) => {
+		if (v === null || typeof v !== "object" || Array.isArray(v)) return v;
+		const sorted = {};
+		for (const k of Object.keys(v).toSorted()) sorted[k] = v[k];
+		return sorted;
+	});
+}
 //#endregion
 Object.defineProperty(exports, "deletePath", {
 	enumerable: true,
@@ -99,3 +112,9 @@ Object.defineProperty(exports, "selfOrAncestor", {
 		return selfOrAncestor;
 	}
 });
+Object.defineProperty(exports, "stableJson", {
+	enumerable: true,
+	get: function() {
+		return stableJson;
+	}
+});