@atscript/db 0.1.150 → 0.1.152

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { $ as TDbReferentialAction, $t as TDbSpaceOptions, A as TCrudOp, An as andFilters, At as TRowResolveOptions, B as TDbDefaultValue, Bn as TReadControls, Bt as TypedWithRelation, C as NavPropsOf, Cn as REL_FILTER_MAX_DEPTH, Ct as TIdentification, D as TCascadeResolver, Dn as TRelationFilterJunction, Dt as TPrimaryKeyChange, E as PrimaryKeyOf, En as TRelGuardState, Et as TMetadataOverrides, F as TDbActionProcessor, Fn as relationStaticFilter, Ft as TTouchManyOptions, G as TDbIndexField, Gn as TRowOrderKey, Gt as isGeoIndexableType, H as TDbFieldMeta, Hn as TGenericLogger, Ht as UniqueryControls, I as TDbActionTargetSummary, In as DbEncryption, It as TValueFormatterPair, J as TDbInsertIgnoreSlot, Jt as ALL_VIEW_CAPABILITIES, K as TDbIndexType, Kn as UniquSelect, Kt as isGeoPointType, L as TDbAvailableActions, Ln as TDbEncryptionOptions, Lt as TViewJsonType, M as TDbActionInfo, Mn as forEachResolvedRelation, Mt as TSyncColumnResult, N as TDbActionIntent, Nn as hasRelationOp, Nt as TTableOptionDiff, O as TCascadeTarget, On as TRelationFilterTable, Ot as TReferencingForeignKey, P as TDbActionLevel, Pn as isResolvedRelationFilter, Pt as TTableResolver, Q as TDbObjectKind, Qt as TAdapterFactory, R as TDbCollation, Rn as DocumentFieldMapper, Rt as TWriteOptions, S as FlatOf, Sn as resolveDesignType, St as TIdResolveOptions, T as OwnPropsOf, Tn as ResolvedRelationFilter, Tt as TMetaResponse, U as TDbForeignKey, Un as TExprAggregate, Ut as WithRelation, V as TDbDeleteResult, Vn as NoopLogger, Vt as Uniquery, W as TDbIndex, Wn as TFirstLast, Wt as TableMetadata, X as TDbInsertManyResult, Xt as TViewCapability, Y as TDbInsertManyIgnoreResult, Yt as BaseDbAdapter, Z as TDbInsertResult, Zt as DbSpace, _ as DbPatch, _n as IntegrityStrategy, _t as TExistingTableOption, a as isJsonValueField, an as AtscriptExprNode, at as TDbUpdateResult, b as FieldOpsFor, bn as AtscriptDbReadable, bt as TFkLookupTarget, c as resolveCalendarBuckets, cn as AtscriptQueryFieldRef, ct as TDbWriteCheckContext, d as AggregateFn, dn as TViewJoin, dt as TDeleteOptions, en as AtscriptDbView, et as TDbRelation, f as AggregateQuery, fn as TViewPlan, ft as TDerivedChangeReason, g as DbControls, gn as AtscriptDbTable, gt as TExistingForeignKey, h as AtscriptDbWritable, hn as translateQueryTree, ht as TExistingColumn, i as isBucketableField, in as aliasTargetOf, it as TDbUpdateOptions, j as TCrudPermissions, jn as containsRelationFilter, jt as TSearchIndexInfo, k as TColumnDiff, kn as TRelationStaticFilter, kt as TRelationInfo, l as AggregateControls, ln as AtscriptQueryNode, lt as TDbWriteGuard, mn as isFieldRef, mt as TEnsureTableOptions, n as TComputedSelect, nn as isAtscriptDbView, nt as TDbRemoveGuardContext, o as jsonValueAncestor, on as AtscriptOrderItem, ot as TDbWriteAction, p as AggregateResult, pn as evaluateExpr, pt as TDerivedColumn, q as TDbInsertIgnoreResult, qt as ALL_BUCKET_UNITS, r as TResolvedBucket, rn as isViewType, rt as TDbStorageType, s as normalizeComputedSelect, sn as AtscriptQueryComparison, st as TDbWriteCheck, t as TBucketFieldSource, tn as TViewColumnMapping, tt as TDbRemoveGuard, u as AggregateExpr, un as AtscriptRef, ut as TDbWriteGuardContext, v as DbQuery, vn as NativeIntegrity, vt as TFieldMeta, w as NullableOptional, wn as REL_FILTER_MAX_NODES, wt as TInsertOptions, x as FilterExpr, xn as DbResponse, xt as TIdDescriptor, y as DbRow, yn as TCascadePin, yt as TFkLookupResolver, z as TDbDefaultFn, zn as FieldMappingStrategy, zt as TWriteTableResolver } from "./buckets-24Ac4sIS.cjs";
+import { $ as TDbReferentialAction, $t as TDbSpaceOptions, A as TCrudOp, An as andFilters, At as TRowResolveOptions, B as TDbDefaultValue, Bn as TReadControls, Bt as TypedWithRelation, C as NavPropsOf, Cn as REL_FILTER_MAX_DEPTH, Ct as TIdentification, D as TCascadeResolver, Dn as TRelationFilterJunction, Dt as TPrimaryKeyChange, E as PrimaryKeyOf, En as TRelGuardState, Et as TMetadataOverrides, F as TDbActionProcessor, Fn as relationStaticFilter, Ft as TTouchManyOptions, G as TDbIndexField, Gn as TRowOrderKey, Gt as isGeoIndexableType, H as TDbFieldMeta, Hn as TGenericLogger, Ht as UniqueryControls, I as TDbActionTargetSummary, In as DbEncryption, It as TValueFormatterPair, J as TDbInsertIgnoreSlot, Jt as ALL_VIEW_CAPABILITIES, K as TDbIndexType, Kn as UniquSelect, Kt as isGeoPointType, L as TDbAvailableActions, Ln as TDbEncryptionOptions, Lt as TViewJsonType, M as TDbActionInfo, Mn as forEachResolvedRelation, Mt as TSyncColumnResult, N as TDbActionIntent, Nn as hasRelationOp, Nt as TTableOptionDiff, O as TCascadeTarget, On as TRelationFilterTable, Ot as TReferencingForeignKey, P as TDbActionLevel, Pn as isResolvedRelationFilter, Pt as TTableResolver, Q as TDbObjectKind, Qt as TAdapterFactory, R as TDbCollation, Rn as DocumentFieldMapper, Rt as TWriteOptions, S as FlatOf, Sn as resolveDesignType, St as TIdResolveOptions, T as OwnPropsOf, Tn as ResolvedRelationFilter, Tt as TMetaResponse, U as TDbForeignKey, Un as TExprAggregate, Ut as WithRelation, V as TDbDeleteResult, Vn as NoopLogger, Vt as Uniquery, W as TDbIndex, Wn as TFirstLast, Wt as TableMetadata, X as TDbInsertManyResult, Xt as TViewCapability, Y as TDbInsertManyIgnoreResult, Yt as BaseDbAdapter, Z as TDbInsertResult, Zt as DbSpace, _ as DbPatch, _n as IntegrityStrategy, _t as TExistingTableOption, a as isJsonValueField, an as AtscriptExprNode, at as TDbUpdateResult, b as FieldOpsFor, bn as AtscriptDbReadable, bt as TFkLookupTarget, c as resolveCalendarBuckets, cn as AtscriptQueryFieldRef, ct as TDbWriteCheckContext, d as AggregateFn, dn as TViewJoin, dt as TDeleteOptions, en as AtscriptDbView, et as TDbRelation, f as AggregateQuery, fn as TViewPlan, ft as TDerivedChangeReason, g as DbControls, gn as AtscriptDbTable, gt as TExistingForeignKey, h as AtscriptDbWritable, hn as translateQueryTree, ht as TExistingColumn, i as isBucketableField, in as aliasTargetOf, it as TDbUpdateOptions, j as TCrudPermissions, jn as containsRelationFilter, jt as TSearchIndexInfo, k as TColumnDiff, kn as TRelationStaticFilter, kt as TRelationInfo, l as AggregateControls, ln as AtscriptQueryNode, lt as TDbWriteGuard, mn as isFieldRef, mt as TEnsureTableOptions, n as TComputedSelect, nn as isAtscriptDbView, nt as TDbRemoveGuardContext, o as jsonValueAncestor, on as AtscriptOrderItem, ot as TDbWriteAction, p as AggregateResult, pn as evaluateExpr, pt as TDerivedColumn, q as TDbInsertIgnoreResult, qt as ALL_BUCKET_UNITS, r as TResolvedBucket, rn as isViewType, rt as TDbStorageType, s as normalizeComputedSelect, sn as AtscriptQueryComparison, st as TDbWriteCheck, t as TBucketFieldSource, tn as TViewColumnMapping, tt as TDbRemoveGuard, u as AggregateExpr, un as AtscriptRef, ut as TDbWriteGuardContext, v as DbQuery, vn as NativeIntegrity, vt as TFieldMeta, w as NullableOptional, wn as REL_FILTER_MAX_NODES, wt as TInsertOptions, x as FilterExpr, xn as DbResponse, xt as TIdDescriptor, y as DbRow, yn as TCascadePin, yt as TFkLookupResolver, z as TDbDefaultFn, zn as FieldMappingStrategy, zt as TWriteTableResolver } from "./buckets-tzd8iIM2.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 { 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, 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-tBNvM1qc.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-CCLiJ9sJ.cjs";
-import { i as tableNameOf } from "./relation-helpers-DjVJN2ng.cjs";
+import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-Bw26lwSc.cjs";
+import { i as tableNameOf } from "./relation-helpers-DxIZKvnJ.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";
 
@@ -50,19 +50,13 @@ declare class RelationalFieldMapper extends FieldMappingStrategy {
    */
   private translateControls;
   /**
-   * Flattens nested object fields into __-separated keys and
-   * JSON-stringifies @db.json / array fields.
+   * Flattens nested objects into __-separated keys and JSON-stringifies
+   * @db.json / array fields — with `prepareCommon` folded in: primary-key
+   * values prepared (`adapter.prepareId`), top-level ignored fields (skipped
+   * by {@link writeFlattenedField}) and derived fields left out. `payload`
+   * itself is not modified.
    */
-  private flattenPayload;
-  /**
-   * Classifies and writes a single field to the result object.
-   * Recurses into nested objects that should be flattened.
-   */
-  private writeFlattenedField;
-  /**
-   * When a parent object is null/undefined, set all its flattened children to null.
-   */
-  private setFlattenedChildrenNull;
+  private flattenWritePayload;
 }
 //#endregion
 //#region src/strategies/application-integrity.d.ts
@@ -93,7 +87,12 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
    * leave the parent behind). Any other filter → `undefined`.
    */
   cascadeBeforeDelete(filter: FilterExpr$1, tableName: string, meta: TableMetadata, cascadeResolver: TCascadeResolver, translateFilter: (f: FilterExpr$1) => FilterExpr$1, adapter: BaseDbAdapter): Promise<TCascadePin>;
-  needsCascade(cascadeResolver: TCascadeResolver | undefined): boolean;
+  /**
+   * A resolver is set and — when `tableName` is given (since 0.1.151) — some
+   * table references `tableName` with an `onDelete` action: a delete from a
+   * table nothing references needs no cascade pass (nor its transaction).
+   */
+  needsCascade(cascadeResolver: TCascadeResolver | undefined, tableName?: string): boolean;
   private recordKey;
   /**
    * Builds a filter for child records whose FK matches the deleted parent's PK values.

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { $ as TDbReferentialAction, $t as TDbSpaceOptions, A as TCrudOp, An as andFilters, At as TRowResolveOptions, B as TDbDefaultValue, Bn as TReadControls, Bt as TypedWithRelation, C as NavPropsOf, Cn as REL_FILTER_MAX_DEPTH, Ct as TIdentification, D as TCascadeResolver, Dn as TRelationFilterJunction, Dt as TPrimaryKeyChange, E as PrimaryKeyOf, En as TRelGuardState, Et as TMetadataOverrides, F as TDbActionProcessor, Fn as relationStaticFilter, Ft as TTouchManyOptions, G as TDbIndexField, Gn as TRowOrderKey, Gt as isGeoIndexableType, H as TDbFieldMeta, Hn as TGenericLogger, Ht as UniqueryControls, I as TDbActionTargetSummary, In as DbEncryption, It as TValueFormatterPair, J as TDbInsertIgnoreSlot, Jt as ALL_VIEW_CAPABILITIES, K as TDbIndexType, Kn as UniquSelect, Kt as isGeoPointType, L as TDbAvailableActions, Ln as TDbEncryptionOptions, Lt as TViewJsonType, M as TDbActionInfo, Mn as forEachResolvedRelation, Mt as TSyncColumnResult, N as TDbActionIntent, Nn as hasRelationOp, Nt as TTableOptionDiff, O as TCascadeTarget, On as TRelationFilterTable, Ot as TReferencingForeignKey, P as TDbActionLevel, Pn as isResolvedRelationFilter, Pt as TTableResolver, Q as TDbObjectKind, Qt as TAdapterFactory, R as TDbCollation, Rn as DocumentFieldMapper, Rt as TWriteOptions, S as FlatOf, Sn as resolveDesignType, St as TIdResolveOptions, T as OwnPropsOf, Tn as ResolvedRelationFilter, Tt as TMetaResponse, U as TDbForeignKey, Un as TExprAggregate, Ut as WithRelation, V as TDbDeleteResult, Vn as NoopLogger, Vt as Uniquery, W as TDbIndex, Wn as TFirstLast, Wt as TableMetadata, X as TDbInsertManyResult, Xt as TViewCapability, Y as TDbInsertManyIgnoreResult, Yt as BaseDbAdapter, Z as TDbInsertResult, Zt as DbSpace, _ as DbPatch, _n as IntegrityStrategy, _t as TExistingTableOption, a as isJsonValueField, an as AtscriptExprNode, at as TDbUpdateResult, b as FieldOpsFor, bn as AtscriptDbReadable, bt as TFkLookupTarget, c as resolveCalendarBuckets, cn as AtscriptQueryFieldRef, ct as TDbWriteCheckContext, d as AggregateFn, dn as TViewJoin, dt as TDeleteOptions, en as AtscriptDbView, et as TDbRelation, f as AggregateQuery, fn as TViewPlan, ft as TDerivedChangeReason, g as DbControls, gn as AtscriptDbTable, gt as TExistingForeignKey, h as AtscriptDbWritable, hn as translateQueryTree, ht as TExistingColumn, i as isBucketableField, in as aliasTargetOf, it as TDbUpdateOptions, j as TCrudPermissions, jn as containsRelationFilter, jt as TSearchIndexInfo, k as TColumnDiff, kn as TRelationStaticFilter, kt as TRelationInfo, l as AggregateControls, ln as AtscriptQueryNode, lt as TDbWriteGuard, mn as isFieldRef, mt as TEnsureTableOptions, n as TComputedSelect, nn as isAtscriptDbView, nt as TDbRemoveGuardContext, o as jsonValueAncestor, on as AtscriptOrderItem, ot as TDbWriteAction, p as AggregateResult, pn as evaluateExpr, pt as TDerivedColumn, q as TDbInsertIgnoreResult, qt as ALL_BUCKET_UNITS, r as TResolvedBucket, rn as isViewType, rt as TDbStorageType, s as normalizeComputedSelect, sn as AtscriptQueryComparison, st as TDbWriteCheck, t as TBucketFieldSource, tn as TViewColumnMapping, tt as TDbRemoveGuard, u as AggregateExpr, un as AtscriptRef, ut as TDbWriteGuardContext, v as DbQuery, vn as NativeIntegrity, vt as TFieldMeta, w as NullableOptional, wn as REL_FILTER_MAX_NODES, wt as TInsertOptions, x as FilterExpr, xn as DbResponse, xt as TIdDescriptor, y as DbRow, yn as TCascadePin, yt as TFkLookupResolver, z as TDbDefaultFn, zn as FieldMappingStrategy, zt as TWriteTableResolver } from "./buckets-XOz0Bw5x.mjs";
+import { $ as TDbReferentialAction, $t as TDbSpaceOptions, A as TCrudOp, An as andFilters, At as TRowResolveOptions, B as TDbDefaultValue, Bn as TReadControls, Bt as TypedWithRelation, C as NavPropsOf, Cn as REL_FILTER_MAX_DEPTH, Ct as TIdentification, D as TCascadeResolver, Dn as TRelationFilterJunction, Dt as TPrimaryKeyChange, E as PrimaryKeyOf, En as TRelGuardState, Et as TMetadataOverrides, F as TDbActionProcessor, Fn as relationStaticFilter, Ft as TTouchManyOptions, G as TDbIndexField, Gn as TRowOrderKey, Gt as isGeoIndexableType, H as TDbFieldMeta, Hn as TGenericLogger, Ht as UniqueryControls, I as TDbActionTargetSummary, In as DbEncryption, It as TValueFormatterPair, J as TDbInsertIgnoreSlot, Jt as ALL_VIEW_CAPABILITIES, K as TDbIndexType, Kn as UniquSelect, Kt as isGeoPointType, L as TDbAvailableActions, Ln as TDbEncryptionOptions, Lt as TViewJsonType, M as TDbActionInfo, Mn as forEachResolvedRelation, Mt as TSyncColumnResult, N as TDbActionIntent, Nn as hasRelationOp, Nt as TTableOptionDiff, O as TCascadeTarget, On as TRelationFilterTable, Ot as TReferencingForeignKey, P as TDbActionLevel, Pn as isResolvedRelationFilter, Pt as TTableResolver, Q as TDbObjectKind, Qt as TAdapterFactory, R as TDbCollation, Rn as DocumentFieldMapper, Rt as TWriteOptions, S as FlatOf, Sn as resolveDesignType, St as TIdResolveOptions, T as OwnPropsOf, Tn as ResolvedRelationFilter, Tt as TMetaResponse, U as TDbForeignKey, Un as TExprAggregate, Ut as WithRelation, V as TDbDeleteResult, Vn as NoopLogger, Vt as Uniquery, W as TDbIndex, Wn as TFirstLast, Wt as TableMetadata, X as TDbInsertManyResult, Xt as TViewCapability, Y as TDbInsertManyIgnoreResult, Yt as BaseDbAdapter, Z as TDbInsertResult, Zt as DbSpace, _ as DbPatch, _n as IntegrityStrategy, _t as TExistingTableOption, a as isJsonValueField, an as AtscriptExprNode, at as TDbUpdateResult, b as FieldOpsFor, bn as AtscriptDbReadable, bt as TFkLookupTarget, c as resolveCalendarBuckets, cn as AtscriptQueryFieldRef, ct as TDbWriteCheckContext, d as AggregateFn, dn as TViewJoin, dt as TDeleteOptions, en as AtscriptDbView, et as TDbRelation, f as AggregateQuery, fn as TViewPlan, ft as TDerivedChangeReason, g as DbControls, gn as AtscriptDbTable, gt as TExistingForeignKey, h as AtscriptDbWritable, hn as translateQueryTree, ht as TExistingColumn, i as isBucketableField, in as aliasTargetOf, it as TDbUpdateOptions, j as TCrudPermissions, jn as containsRelationFilter, jt as TSearchIndexInfo, k as TColumnDiff, kn as TRelationStaticFilter, kt as TRelationInfo, l as AggregateControls, ln as AtscriptQueryNode, lt as TDbWriteGuard, mn as isFieldRef, mt as TEnsureTableOptions, n as TComputedSelect, nn as isAtscriptDbView, nt as TDbRemoveGuardContext, o as jsonValueAncestor, on as AtscriptOrderItem, ot as TDbWriteAction, p as AggregateResult, pn as evaluateExpr, pt as TDerivedColumn, q as TDbInsertIgnoreResult, qt as ALL_BUCKET_UNITS, r as TResolvedBucket, rn as isViewType, rt as TDbStorageType, s as normalizeComputedSelect, sn as AtscriptQueryComparison, st as TDbWriteCheck, t as TBucketFieldSource, tn as TViewColumnMapping, tt as TDbRemoveGuard, u as AggregateExpr, un as AtscriptRef, ut as TDbWriteGuardContext, v as DbQuery, vn as NativeIntegrity, vt as TFieldMeta, w as NullableOptional, wn as REL_FILTER_MAX_NODES, wt as TInsertOptions, x as FilterExpr, xn as DbResponse, xt as TIdDescriptor, y as DbRow, yn as TCascadePin, yt as TFkLookupResolver, z as TDbDefaultFn, zn as FieldMappingStrategy, zt as TWriteTableResolver } from "./buckets-Cb0zmhDc.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 { 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, 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-tBNvM1qc.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-R8eU7gq-.mjs";
-import { i as tableNameOf } from "./relation-helpers-H7UEVkHs.mjs";
+import { r as fkColumns, s as isColumnTypeChanged } from "./fk-diff-lcAnwvm9.mjs";
+import { i as tableNameOf } from "./relation-helpers-Bdo4NHPC.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";
 
@@ -50,19 +50,13 @@ declare class RelationalFieldMapper extends FieldMappingStrategy {
    */
   private translateControls;
   /**
-   * Flattens nested object fields into __-separated keys and
-   * JSON-stringifies @db.json / array fields.
+   * Flattens nested objects into __-separated keys and JSON-stringifies
+   * @db.json / array fields — with `prepareCommon` folded in: primary-key
+   * values prepared (`adapter.prepareId`), top-level ignored fields (skipped
+   * by {@link writeFlattenedField}) and derived fields left out. `payload`
+   * itself is not modified.
    */
-  private flattenPayload;
-  /**
-   * Classifies and writes a single field to the result object.
-   * Recurses into nested objects that should be flattened.
-   */
-  private writeFlattenedField;
-  /**
-   * When a parent object is null/undefined, set all its flattened children to null.
-   */
-  private setFlattenedChildrenNull;
+  private flattenWritePayload;
 }
 //#endregion
 //#region src/strategies/application-integrity.d.ts
@@ -93,7 +87,12 @@ declare class ApplicationIntegrity extends IntegrityStrategy {
    * leave the parent behind). Any other filter → `undefined`.
    */
   cascadeBeforeDelete(filter: FilterExpr$1, tableName: string, meta: TableMetadata, cascadeResolver: TCascadeResolver, translateFilter: (f: FilterExpr$1) => FilterExpr$1, adapter: BaseDbAdapter): Promise<TCascadePin>;
-  needsCascade(cascadeResolver: TCascadeResolver | undefined): boolean;
+  /**
+   * A resolver is set and — when `tableName` is given (since 0.1.151) — some
+   * table references `tableName` with an `onDelete` action: a delete from a
+   * table nothing references needs no cascade pass (nor its transaction).
+   */
+  needsCascade(cascadeResolver: TCascadeResolver | undefined, tableName?: string): boolean;
   private recordKey;
   /**
    * Builds a filter for child records whose FK matches the deleted parent's PK values.

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { a as aggregateExpressionsNotSupported, c as isConflict, l as spaceClosedError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-Az85UhTX.mjs";
-import { $ as DocumentFieldMapper, A as resolveDesignType, B as checkHavingKeys, C as ALL_BUCKET_UNITS, D as IntegrityStrategy, E as createFailureCollector, F as ENCRYPTED_REASON, G as guardFilter, H as collectQueryPaths, I as acceptedOperatorsHint, J as guardQuery, K as guardPath, L as assertGeoPoint, M as searchIndexNotFoundMessage, N as vectorIndexNotFoundMessage, O as NativeIntegrity, P as ADAPTER_FILTER_REASON, Q as RelationalFieldMapper, R as bucketSourceVerdict, S as ApplicationIntegrity, T as BaseDbAdapter, U as groupSourceVerdict, V as classifyQueryPath, W as guardAggregate, X as sortFieldNames, Y as narrowerFilterOps, Z as unsupportedOperatorMessage, _ as isViewType, _t as NoopLogger, at as describeFulltext, b as assertNoVersionWrites, ct as TableMetadata, dt as aliasTargetOf, et as FieldMappingStrategy, f as fkColumns, ft as isBucketableField, g as isAtscriptDbView, gt as resolveCalendarBuckets, h as AtscriptDbView, ht as normalizeComputedSelect, it as defaultFulltextIndex, j as geoIndexNotFoundMessage, k as AtscriptDbReadable, lt as isGeoIndexableType, mt as jsonValueAncestor, n as isColumnTypeChanged, nt as numericOperandProblem, ot as searchTermInteger, pt as isJsonValueField, q as guardPaths, rt as INTEGER_REGEX_OP, st as splitFulltextFields, tt as UniquSelect, ut as isGeoPointType, v as AtscriptDbTable, w as ALL_VIEW_CAPABILITIES, x as decomposePatch, y as isVersionExemptPatch, z as canFilterLeaf } from "./column-diff-CKLDWBbo.mjs";
+import { $ as DocumentFieldMapper, A as resolveDesignType, B as checkHavingKeys, C as ALL_BUCKET_UNITS, D as IntegrityStrategy, E as createFailureCollector, F as ENCRYPTED_REASON, G as guardFilter, H as collectQueryPaths, I as acceptedOperatorsHint, J as guardQuery, K as guardPath, L as assertGeoPoint, M as searchIndexNotFoundMessage, N as vectorIndexNotFoundMessage, O as NativeIntegrity, P as ADAPTER_FILTER_REASON, Q as RelationalFieldMapper, R as bucketSourceVerdict, S as ApplicationIntegrity, T as BaseDbAdapter, U as groupSourceVerdict, V as classifyQueryPath, W as guardAggregate, X as sortFieldNames, Y as narrowerFilterOps, Z as unsupportedOperatorMessage, _ as isViewType, _t as NoopLogger, at as describeFulltext, b as assertNoVersionWrites, ct as TableMetadata, dt as aliasTargetOf, et as FieldMappingStrategy, f as fkColumns, ft as isBucketableField, g as isAtscriptDbView, gt as resolveCalendarBuckets, h as AtscriptDbView, ht as normalizeComputedSelect, it as defaultFulltextIndex, j as geoIndexNotFoundMessage, k as AtscriptDbReadable, lt as isGeoIndexableType, mt as jsonValueAncestor, n as isColumnTypeChanged, nt as numericOperandProblem, ot as searchTermInteger, pt as isJsonValueField, q as guardPaths, rt as INTEGER_REGEX_OP, st as splitFulltextFields, tt as UniquSelect, ut as isGeoPointType, v as AtscriptDbTable, w as ALL_VIEW_CAPABILITIES, x as decomposePatch, y as isVersionExemptPatch, z as canFilterLeaf } from "./column-diff-CnyLjbQ8.mjs";
 import { n as ALL_AGGREGATE_FNS } from "./aggregate-fns-CyaZyb9I.mjs";
-import { A as isResolvedRelationFilter, C as REL_FILTER_MAX_NODES, E as containsRelationFilter, G as isFieldRef, K as translateQueryTree, N as relationStaticFilter, O as forEachResolvedRelation, S as REL_FILTER_MAX_DEPTH, T as andFilters, V as tableNameOf, W as evaluateExpr, k as hasRelationOp, w as ResolvedRelationFilter, x as uniqueKeyTuple } from "./nested-writer-CUBoq1ZO.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-cvbVAkNo.mjs";
 import { i as DB_ENTITY_ANNOTATIONS, n as searchMemberKind } from "./search-fields-DBIZKwyb.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 { t as DEFAULT_DB_SPACE } from "./consts-C_-5_pFq.mjs";
@@ -235,6 +235,12 @@ var DbSpace = class {
 	_readables = /* @__PURE__ */ new WeakMap();
 	/** All tables created in this space — used for reverse FK lookup during cascade. */
 	_allTables = /* @__PURE__ */ new Set();
+	/**
+	* Per-table-name memo of {@link _getCascadeTargets} / {@link _getFkLookupTarget}
+	* (since 0.1.151) — both scan every table; cleared whenever a table is added.
+	*/
+	_cascadeTargets = /* @__PURE__ */ new Map();
+	_fkLookupTargets = /* @__PURE__ */ new Map();
 	/** Every table / view handle the space created — flagged closed on {@link close}. */
 	_handles = /* @__PURE__ */ new Set();
 	/** Lazily created adapter for administrative ops (drop table/view) that don't need a registered readable. */
@@ -284,6 +290,8 @@ var DbSpace = class {
 				return resolved instanceof AtscriptDbTable ? resolved : void 0;
 			});
 			this._allTables.add(readable);
+			this._cascadeTargets.clear();
+			this._fkLookupTargets.clear();
 			readable.setCascadeResolver((tableName) => this._getCascadeTargets(tableName));
 			readable.setFkLookupResolver((tableName) => this._getFkLookupTarget(tableName));
 			readable.setEncryption(this._encryption);
@@ -412,6 +420,14 @@ var DbSpace = class {
 	* Accesses `table.foreignKeys` which triggers `_flatten()` if needed.
 	*/
 	_getCascadeTargets(tableName) {
+		let targets = this._cascadeTargets.get(tableName);
+		if (targets === void 0) {
+			targets = this._scanCascadeTargets(tableName);
+			this._cascadeTargets.set(tableName, targets);
+		}
+		return targets;
+	}
+	_scanCascadeTargets(tableName) {
 		const targets = [];
 		for (const table of this._allTables) for (const fk of table.foreignKeys.values()) if (fk.targetTable === tableName && fk.onDelete) targets.push({
 			fk,
@@ -427,6 +443,12 @@ var DbSpace = class {
 	* Searches all registered tables for one with the matching table name.
 	*/
 	_getFkLookupTarget(tableName) {
+		if (this._fkLookupTargets.has(tableName)) return this._fkLookupTargets.get(tableName);
+		const target = this._scanFkLookupTarget(tableName);
+		this._fkLookupTargets.set(tableName, target);
+		return target;
+	}
+	_scanFkLookupTarget(tableName) {
 		for (const table of this._allTables) if (table.tableName === tableName) return { count: (filter) => table.count({ filter }) };
 	}
 };

package/dist/{nested-writer-BUQvk6QT.cjs → nested-writer-BzbOPSUp.cjs}

@@ -676,6 +676,68 @@ function uniqueKeyTuple(row, fields) {
 	}
 	return JSON.stringify(parts);
 }
+/**
+* For every equality `filters[i]`, the FIRST row of `rows` that
+* {@link rowMatchesKey} matches it — `rows.find(…)` per filter, answered from
+* one hash index per distinct filter key set instead of a scan per filter.
+* A filter holding a `null` / `undefined` value (where {@link sameKey}
+* differs from string identity) is matched by the scan. `undefined` = no row.
+* @since 0.1.151
+*/
+function findRowsByKeys(rows, filters) {
+	const out = Array.from({ length: filters.length });
+	if (rows.length * filters.length <= 64) {
+		for (let i = 0; i < filters.length; i++) out[i] = rows.find((r) => rowMatchesKey(r, filters[i]));
+		return out;
+	}
+	const indexes = /* @__PURE__ */ new Map();
+	for (let i = 0; i < filters.length; i++) {
+		const filter = filters[i];
+		const fields = Object.keys(filter);
+		let indexable = fields.length > 0;
+		for (const field of fields) {
+			const value = filter[field];
+			if (value === null || value === void 0) {
+				indexable = false;
+				break;
+			}
+		}
+		if (!indexable) {
+			out[i] = rows.find((r) => rowMatchesKey(r, filter));
+			continue;
+		}
+		const signature = JSON.stringify(fields);
+		let index = indexes.get(signature);
+		if (index === void 0) {
+			index = /* @__PURE__ */ new Map();
+			for (const row of rows) {
+				const key = keyTupleString(row, fields);
+				if (key !== void 0 && !index.has(key)) index.set(key, row);
+			}
+			indexes.set(signature, index);
+		}
+		out[i] = index.get(keyTupleString(filter, fields, true));
+	}
+	return out;
+}
+/**
+* The {@link keyString} tuple of `fields` of `source` (dot-paths read nested
+* for a row, plain keys for a filter); `undefined` when a component is null /
+* missing (it can only equal a null filter value, which is never indexed).
+*/
+function keyTupleString(source, fields, plain = false) {
+	if (fields.length === 1) {
+		const value = plain ? source[fields[0]] : require_object.getPath(source, fields[0]);
+		return value === null || value === void 0 ? void 0 : keyString(value);
+	}
+	const parts = [];
+	for (const field of fields) {
+		const value = plain ? source[field] : require_object.getPath(source, field);
+		if (value === null || value === void 0) return void 0;
+		parts.push(keyString(value));
+	}
+	return JSON.stringify(parts);
+}
 //#endregion
 //#region src/table/error-utils.ts
 /**
@@ -944,10 +1006,11 @@ async function batchReplaceNestedFrom(host, originals, maxDepth, depth, plan) {
 		if (relation.direction !== "from" || !hasNavValue(originals, navField)) continue;
 		const target = fromWriteTarget(host, relation, navField, plan, maxDepth, depth);
 		if (!target) continue;
-		for (const original of originals) {
-			const children = original[navField];
+		const replacing = originals.filter((original) => Array.isArray(original[navField]) && original[parentPKField] !== void 0);
+		const current = await currentChildrenOf(target, replacing.map((original) => original[parentPKField]), replacing.flatMap((original) => original[navField]));
+		for (const original of replacing) {
 			const parentPK = original[parentPKField];
-			if (Array.isArray(children) && parentPK !== void 0) await fromReplace(target, children, parentPK);
+			await fromReplace(target, original[navField], parentPK, current?.get(keyString(parentPK)));
 		}
 	}
 }
@@ -1105,12 +1168,24 @@ async function batchPatchNestedFrom(host, originals, maxDepth, depth, plan) {
 		const target = fromWriteTarget(host, relation, navField, plan, maxDepth, depth);
 		if (!target) continue;
 		const { targetTable, fkField, childPKs } = target;
+		const patching = [];
 		for (const original of originals) {
 			const navValue = original[navField];
 			const parentPK = original[parentPKField];
 			if (navValue === void 0 || navValue === null || parentPK === void 0) continue;
-			const ops = extractNavPatchOps(navValue);
-			if (ops.replace) await fromReplace(target, ops.replace, parentPK);
+			patching.push({
+				parentPK,
+				ops: extractNavPatchOps(navValue)
+			});
+		}
+		const current = new Set(patching.map(({ parentPK }) => keyString(parentPK))).size < patching.length ? void 0 : await currentChildrenOf(target, patching.filter(({ ops }) => ops.replace).map(({ parentPK }) => parentPK), patching.flatMap(({ ops }) => [
+			...ops.replace ?? [],
+			...ops.update ?? [],
+			...ops.upsert ?? [],
+			...ops.insert ?? []
+		]));
+		for (const { parentPK, ops } of patching) {
+			if (ops.replace) await fromReplace(target, ops.replace, parentPK, current?.get(keyString(parentPK)));
 			if (ops.remove && ops.remove.length > 0) {
 				const removeFilters = ops.remove.map((child) => {
 					const rec = child;
@@ -1395,7 +1470,7 @@ async function fromUpdate(target, items) {
 * FROM $replace helper: delete the parent's orphans, replace its keyed
 * children, insert the rest.
 */
-async function fromReplace(target, children, parentPK) {
+async function fromReplace(target, children, parentPK, current) {
 	const { targetTable, navField, fkField, childPKs, maxDepth, depth } = target;
 	const toReplace = [];
 	const toInsert = [];
@@ -1410,7 +1485,7 @@ async function fromReplace(target, children, parentPK) {
 			toReplace.push(childData);
 		} else toInsert.push(childData);
 	}
-	const existing = await targetTable.findMany({
+	const existing = current ?? await targetTable.findMany({
 		filter: { [fkField]: parentPK },
 		controls: childPKs.length > 0 ? { $select: [...childPKs] } : {}
 	});
@@ -1427,6 +1502,47 @@ async function fromReplace(target, children, parentPK) {
 	}));
 }
 /**
+* The current (keyed) children of several parents in ONE read — what
+* {@link fromReplace} reads per parent, grouped by parent key (since 0.1.151).
+* The writes stay per parent and in order; only this read is shared, which is
+* safe because each parent's writes are pinned to its own children (the
+* foreign key is filtered on and never SET) and no child entry of the batch
+* (`entries`) carries nested navigation data (no nested write of a child can
+* reach another parent's children); a row removed meanwhile by a delete cascade is a no-op orphan
+* delete or the same `CONFLICT` either way. Done only where grouping cannot
+* differ from the store's own matching: two or more DISTINCT integer parent
+* keys (no collation can merge two of them) and a child table with a primary
+* key; a fetched row that maps to no parent key (a representation the
+* grouping does not know) also falls back. `undefined` → read per parent.
+*/
+async function currentChildrenOf(target, parentPKs, entries) {
+	const { targetTable, fkField, childPKs } = target;
+	if (parentPKs.length < 2 || childPKs.length === 0) return void 0;
+	const childNav = targetTable.getMetadata().navFields;
+	if (childNav.size > 0) for (const entry of entries) for (const navField of childNav) {
+		const value = entry?.[navField];
+		if (value !== void 0 && value !== null) return void 0;
+	}
+	const groups = /* @__PURE__ */ new Map();
+	for (const pk of parentPKs) {
+		if (!(typeof pk === "number" && Number.isInteger(pk)) && typeof pk !== "bigint") return;
+		const key = keyString(pk);
+		if (groups.has(key)) return void 0;
+		groups.set(key, []);
+	}
+	const rows = await targetTable.findMany({
+		filter: { [fkField]: { $in: parentPKs } },
+		controls: { $select: [...new Set([...childPKs, fkField])] }
+	});
+	for (const row of rows) {
+		const value = row[fkField];
+		const group = value === null || value === void 0 ? void 0 : groups.get(keyString(value));
+		if (!group) return void 0;
+		group.push(row);
+	}
+	return groups;
+}
+/**
 * Links `targets` to the parent: keyed entries by their key, unkeyed ones
 * inserted first — then one junction insert.
 */
@@ -1621,6 +1737,12 @@ Object.defineProperty(exports, "findRemoteFK", {
 		return findRemoteFK;
 	}
 });
+Object.defineProperty(exports, "findRowsByKeys", {
+	enumerable: true,
+	get: function() {
+		return findRowsByKeys;
+	}
+});
 Object.defineProperty(exports, "forEachResolvedRelation", {
 	enumerable: true,
 	get: function() {

package/dist/{nested-writer-CUBoq1ZO.mjs → nested-writer-cvbVAkNo.mjs}

@@ -676,6 +676,68 @@ function uniqueKeyTuple(row, fields) {
 	}
 	return JSON.stringify(parts);
 }
+/**
+* For every equality `filters[i]`, the FIRST row of `rows` that
+* {@link rowMatchesKey} matches it — `rows.find(…)` per filter, answered from
+* one hash index per distinct filter key set instead of a scan per filter.
+* A filter holding a `null` / `undefined` value (where {@link sameKey}
+* differs from string identity) is matched by the scan. `undefined` = no row.
+* @since 0.1.151
+*/
+function findRowsByKeys(rows, filters) {
+	const out = Array.from({ length: filters.length });
+	if (rows.length * filters.length <= 64) {
+		for (let i = 0; i < filters.length; i++) out[i] = rows.find((r) => rowMatchesKey(r, filters[i]));
+		return out;
+	}
+	const indexes = /* @__PURE__ */ new Map();
+	for (let i = 0; i < filters.length; i++) {
+		const filter = filters[i];
+		const fields = Object.keys(filter);
+		let indexable = fields.length > 0;
+		for (const field of fields) {
+			const value = filter[field];
+			if (value === null || value === void 0) {
+				indexable = false;
+				break;
+			}
+		}
+		if (!indexable) {
+			out[i] = rows.find((r) => rowMatchesKey(r, filter));
+			continue;
+		}
+		const signature = JSON.stringify(fields);
+		let index = indexes.get(signature);
+		if (index === void 0) {
+			index = /* @__PURE__ */ new Map();
+			for (const row of rows) {
+				const key = keyTupleString(row, fields);
+				if (key !== void 0 && !index.has(key)) index.set(key, row);
+			}
+			indexes.set(signature, index);
+		}
+		out[i] = index.get(keyTupleString(filter, fields, true));
+	}
+	return out;
+}
+/**
+* The {@link keyString} tuple of `fields` of `source` (dot-paths read nested
+* for a row, plain keys for a filter); `undefined` when a component is null /
+* missing (it can only equal a null filter value, which is never indexed).
+*/
+function keyTupleString(source, fields, plain = false) {
+	if (fields.length === 1) {
+		const value = plain ? source[fields[0]] : getPath(source, fields[0]);
+		return value === null || value === void 0 ? void 0 : keyString(value);
+	}
+	const parts = [];
+	for (const field of fields) {
+		const value = plain ? source[field] : getPath(source, field);
+		if (value === null || value === void 0) return void 0;
+		parts.push(keyString(value));
+	}
+	return JSON.stringify(parts);
+}
 //#endregion
 //#region src/table/error-utils.ts
 /**
@@ -944,10 +1006,11 @@ async function batchReplaceNestedFrom(host, originals, maxDepth, depth, plan) {
 		if (relation.direction !== "from" || !hasNavValue(originals, navField)) continue;
 		const target = fromWriteTarget(host, relation, navField, plan, maxDepth, depth);
 		if (!target) continue;
-		for (const original of originals) {
-			const children = original[navField];
+		const replacing = originals.filter((original) => Array.isArray(original[navField]) && original[parentPKField] !== void 0);
+		const current = await currentChildrenOf(target, replacing.map((original) => original[parentPKField]), replacing.flatMap((original) => original[navField]));
+		for (const original of replacing) {
 			const parentPK = original[parentPKField];
-			if (Array.isArray(children) && parentPK !== void 0) await fromReplace(target, children, parentPK);
+			await fromReplace(target, original[navField], parentPK, current?.get(keyString(parentPK)));
 		}
 	}
 }
@@ -1105,12 +1168,24 @@ async function batchPatchNestedFrom(host, originals, maxDepth, depth, plan) {
 		const target = fromWriteTarget(host, relation, navField, plan, maxDepth, depth);
 		if (!target) continue;
 		const { targetTable, fkField, childPKs } = target;
+		const patching = [];
 		for (const original of originals) {
 			const navValue = original[navField];
 			const parentPK = original[parentPKField];
 			if (navValue === void 0 || navValue === null || parentPK === void 0) continue;
-			const ops = extractNavPatchOps(navValue);
-			if (ops.replace) await fromReplace(target, ops.replace, parentPK);
+			patching.push({
+				parentPK,
+				ops: extractNavPatchOps(navValue)
+			});
+		}
+		const current = new Set(patching.map(({ parentPK }) => keyString(parentPK))).size < patching.length ? void 0 : await currentChildrenOf(target, patching.filter(({ ops }) => ops.replace).map(({ parentPK }) => parentPK), patching.flatMap(({ ops }) => [
+			...ops.replace ?? [],
+			...ops.update ?? [],
+			...ops.upsert ?? [],
+			...ops.insert ?? []
+		]));
+		for (const { parentPK, ops } of patching) {
+			if (ops.replace) await fromReplace(target, ops.replace, parentPK, current?.get(keyString(parentPK)));
 			if (ops.remove && ops.remove.length > 0) {
 				const removeFilters = ops.remove.map((child) => {
 					const rec = child;
@@ -1395,7 +1470,7 @@ async function fromUpdate(target, items) {
 * FROM $replace helper: delete the parent's orphans, replace its keyed
 * children, insert the rest.
 */
-async function fromReplace(target, children, parentPK) {
+async function fromReplace(target, children, parentPK, current) {
 	const { targetTable, navField, fkField, childPKs, maxDepth, depth } = target;
 	const toReplace = [];
 	const toInsert = [];
@@ -1410,7 +1485,7 @@ async function fromReplace(target, children, parentPK) {
 			toReplace.push(childData);
 		} else toInsert.push(childData);
 	}
-	const existing = await targetTable.findMany({
+	const existing = current ?? await targetTable.findMany({
 		filter: { [fkField]: parentPK },
 		controls: childPKs.length > 0 ? { $select: [...childPKs] } : {}
 	});
@@ -1427,6 +1502,47 @@ async function fromReplace(target, children, parentPK) {
 	}));
 }
 /**
+* The current (keyed) children of several parents in ONE read — what
+* {@link fromReplace} reads per parent, grouped by parent key (since 0.1.151).
+* The writes stay per parent and in order; only this read is shared, which is
+* safe because each parent's writes are pinned to its own children (the
+* foreign key is filtered on and never SET) and no child entry of the batch
+* (`entries`) carries nested navigation data (no nested write of a child can
+* reach another parent's children); a row removed meanwhile by a delete cascade is a no-op orphan
+* delete or the same `CONFLICT` either way. Done only where grouping cannot
+* differ from the store's own matching: two or more DISTINCT integer parent
+* keys (no collation can merge two of them) and a child table with a primary
+* key; a fetched row that maps to no parent key (a representation the
+* grouping does not know) also falls back. `undefined` → read per parent.
+*/
+async function currentChildrenOf(target, parentPKs, entries) {
+	const { targetTable, fkField, childPKs } = target;
+	if (parentPKs.length < 2 || childPKs.length === 0) return void 0;
+	const childNav = targetTable.getMetadata().navFields;
+	if (childNav.size > 0) for (const entry of entries) for (const navField of childNav) {
+		const value = entry?.[navField];
+		if (value !== void 0 && value !== null) return void 0;
+	}
+	const groups = /* @__PURE__ */ new Map();
+	for (const pk of parentPKs) {
+		if (!(typeof pk === "number" && Number.isInteger(pk)) && typeof pk !== "bigint") return;
+		const key = keyString(pk);
+		if (groups.has(key)) return void 0;
+		groups.set(key, []);
+	}
+	const rows = await targetTable.findMany({
+		filter: { [fkField]: { $in: parentPKs } },
+		controls: { $select: [...new Set([...childPKs, fkField])] }
+	});
+	for (const row of rows) {
+		const value = row[fkField];
+		const group = value === null || value === void 0 ? void 0 : groups.get(keyString(value));
+		if (!group) return void 0;
+		group.push(row);
+	}
+	return groups;
+}
+/**
 * Links `targets` to the parent: keyed entries by their key, unkeyed ones
 * inserted first — then one junction insert.
 */
@@ -1471,4 +1587,4 @@ async function viaReplace(via, targets, parentPK, maxDepth, depth) {
 	await viaLinkTargets(via, targets, parentPK, maxDepth, depth);
 }
 //#endregion
-export { isResolvedRelationFilter as A, slicePerGroup as B, REL_FILTER_MAX_NODES as C, createRelationFilterHost as D, containsRelationFilter as E, compositeKey as F, isFieldRef as G, computeOf as H, findFKEntryForRelation as I, walkViewExpr as J, translateQueryTree as K, findFKForRelation as L, relGuardState as M, relationStaticFilter as N, forEachResolvedRelation as O, resolveRelationFilterTree as P, findRemoteFK as R, REL_FILTER_MAX_DEPTH as S, andFilters as T, computedOperands as U, tableNameOf as V, evaluateExpr as W, remapDeleteFkViolation as _, batchPatchNestedFrom as a, sameKey as b, batchReplaceNestedFrom as c, checkDepthOverflow as d, planNestedFromVia as f, enrichFkViolation as g, validateBatch as h, batchInsertNestedVia as i, noteRelationFilter as j, hasRelationOp as k, batchReplaceNestedTo as l, preValidateNestedFrom as m, batchInsertNestedFrom as n, batchPatchNestedTo as o, planPatchNestedTo as p, viewExprNullable as q, batchInsertNestedTo as r, batchPatchNestedVia as s, applyPatchNestedTo as t, batchReplaceNestedVia as u, pkTupleKey as v, ResolvedRelationFilter as w, uniqueKeyTuple as x, rowMatchesKey as y, resolveRelationTargetTable as z };
+export { hasRelationOp as A, resolveRelationTargetTable as B, REL_FILTER_MAX_DEPTH as C, containsRelationFilter as D, andFilters as E, resolveRelationFilterTree as F, evaluateExpr as G, tableNameOf as H, compositeKey as I, viewExprNullable as J, isFieldRef as K, findFKEntryForRelation as L, noteRelationFilter as M, relGuardState as N, createRelationFilterHost as O, relationStaticFilter as P, findFKForRelation as R, uniqueKeyTuple as S, ResolvedRelationFilter as T, computeOf as U, slicePerGroup as V, computedOperands as W, walkViewExpr as Y, remapDeleteFkViolation as _, batchPatchNestedFrom as a, rowMatchesKey as b, batchReplaceNestedFrom as c, checkDepthOverflow as d, planNestedFromVia as f, enrichFkViolation as g, validateBatch as h, batchInsertNestedVia as i, isResolvedRelationFilter as j, forEachResolvedRelation as k, batchReplaceNestedTo as l, preValidateNestedFrom as m, batchInsertNestedFrom as n, batchPatchNestedTo as o, planPatchNestedTo as p, translateQueryTree as q, batchInsertNestedTo as r, batchPatchNestedVia as s, applyPatchNestedTo as t, batchReplaceNestedVia as u, findRowsByKeys as v, REL_FILTER_MAX_NODES as w, sameKey as x, pkTupleKey as y, findRemoteFK as z };

package/dist/rel.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_nested_writer = require("./nested-writer-BUQvk6QT.cjs");
-const require_relation_loader = require("./relation-loader-D8OrdH-r.cjs");
+const require_nested_writer = require("./nested-writer-BzbOPSUp.cjs");
+const require_relation_loader = require("./relation-loader-fNjHgBMs.cjs");
 exports.applyPatchNestedTo = require_nested_writer.applyPatchNestedTo;
 exports.batchInsertNestedFrom = require_nested_writer.batchInsertNestedFrom;
 exports.batchInsertNestedTo = require_nested_writer.batchInsertNestedTo;

package/dist/rel.d.cts

@@ -1,6 +1,6 @@
-import { Hn as TGenericLogger, Pt as TTableResolver, U as TDbForeignKey, Wt as TableMetadata, Yt as BaseDbAdapter, et as TDbRelation, h as AtscriptDbWritable, m as AtscriptDbTableLike, zt as TWriteTableResolver } from "./buckets-24Ac4sIS.cjs";
+import { Hn as TGenericLogger, Pt as TTableResolver, U as TDbForeignKey, Wt as TableMetadata, Yt as BaseDbAdapter, et as TDbRelation, h as AtscriptDbWritable, m as AtscriptDbTableLike, zt as TWriteTableResolver } from "./buckets-tzd8iIM2.cjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-DjVJN2ng.cjs";
+import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-DxIZKvnJ.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";
 

package/dist/rel.d.mts

@@ -1,6 +1,6 @@
-import { Hn as TGenericLogger, Pt as TTableResolver, U as TDbForeignKey, Wt as TableMetadata, Yt as BaseDbAdapter, et as TDbRelation, h as AtscriptDbWritable, m as AtscriptDbTableLike, zt as TWriteTableResolver } from "./buckets-XOz0Bw5x.mjs";
+import { Hn as TGenericLogger, Pt as TTableResolver, U as TDbForeignKey, Wt as TableMetadata, Yt as BaseDbAdapter, et as TDbRelation, h as AtscriptDbWritable, m as AtscriptDbTableLike, zt as TWriteTableResolver } from "./buckets-Cb0zmhDc.mjs";
 import { t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-H7UEVkHs.mjs";
+import { n as findRemoteFK, r as resolveRelationTargetTable, t as findFKForRelation } from "./relation-helpers-Bdo4NHPC.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 

package/dist/rel.mjs

@@ -1,3 +1,3 @@
-import { t as loadRelationsImpl } from "./relation-loader-ByY1Byrl.mjs";
-import { L as findFKForRelation, R as findRemoteFK, a as batchPatchNestedFrom, c as batchReplaceNestedFrom, d as checkDepthOverflow, f as planNestedFromVia, h as validateBatch, i as batchInsertNestedVia, l as batchReplaceNestedTo, m as preValidateNestedFrom, n as batchInsertNestedFrom, o as batchPatchNestedTo, p as planPatchNestedTo, r as batchInsertNestedTo, s as batchPatchNestedVia, t as applyPatchNestedTo, u as batchReplaceNestedVia, z as resolveRelationTargetTable } from "./nested-writer-CUBoq1ZO.mjs";
+import { t as loadRelationsImpl } from "./relation-loader-DYab07lw.mjs";
+import { B as resolveRelationTargetTable, R as findFKForRelation, a as batchPatchNestedFrom, c as batchReplaceNestedFrom, d as checkDepthOverflow, f as planNestedFromVia, h as validateBatch, i as batchInsertNestedVia, l as batchReplaceNestedTo, m as preValidateNestedFrom, n as batchInsertNestedFrom, o as batchPatchNestedTo, p as planPatchNestedTo, r as batchInsertNestedTo, s as batchPatchNestedVia, t as applyPatchNestedTo, u as batchReplaceNestedVia, z as findRemoteFK } from "./nested-writer-cvbVAkNo.mjs";
 export { applyPatchNestedTo, batchInsertNestedFrom, batchInsertNestedTo, batchInsertNestedVia, batchPatchNestedFrom, batchPatchNestedTo, batchPatchNestedVia, batchReplaceNestedFrom, batchReplaceNestedTo, batchReplaceNestedVia, checkDepthOverflow, findFKForRelation, findRemoteFK, loadRelationsImpl, planNestedFromVia, planPatchNestedTo, preValidateNestedFrom, resolveRelationTargetTable, validateBatch };

package/dist/{relation-helpers-DjVJN2ng.d.cts → relation-helpers-Bdo4NHPC.d.mts}

@@ -1,4 +1,4 @@
-import { U as TDbForeignKey, et as TDbRelation } from "./buckets-24Ac4sIS.cjs";
+import { U as TDbForeignKey, et as TDbRelation } from "./buckets-Cb0zmhDc.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/rel/relation-helpers.d.ts

package/dist/{relation-helpers-H7UEVkHs.d.mts → relation-helpers-DxIZKvnJ.d.cts}

@@ -1,4 +1,4 @@
-import { U as TDbForeignKey, et as TDbRelation } from "./buckets-XOz0Bw5x.mjs";
+import { U as TDbForeignKey, et as TDbRelation } from "./buckets-tzd8iIM2.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/rel/relation-helpers.d.ts

package/dist/{relation-loader-ByY1Byrl.mjs → relation-loader-DYab07lw.mjs}

@@ -1,4 +1,4 @@
-import { B as slicePerGroup, F as compositeKey, L as findFKForRelation, N as relationStaticFilter, R as findRemoteFK, T as andFilters, z as resolveRelationTargetTable } from "./nested-writer-CUBoq1ZO.mjs";
+import { B as resolveRelationTargetTable, E as andFilters, I as compositeKey, P as relationStaticFilter, R as findFKForRelation, V as slicePerGroup, z as findRemoteFK } from "./nested-writer-cvbVAkNo.mjs";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {