@atscript/db 0.1.140 → 0.1.141

package/dist/index.d.cts

@@ -1,11 +1,13 @@
-import { $ as TDbWriteGuard, $t as AtscriptDbReadable, A as TDbActionInfo, At as findAncestorInSet, B as TDbIndex, Bt as TViewJsonType, C as OwnPropsOf, Ct as TWriteOptions, D as TColumnDiff, Dt as UniqueryControls, E as TCascadeTarget, Et as Uniquery, F as TDbDefaultFn, Ft as DbSpace, G as TDbObjectKind, Gt as AtscriptRef, H as TDbIndexType, Ht as AtscriptQueryComparison, I as TDbDefaultValue, It as TAdapterFactory, J as TDbRemoveGuard, Jt as isFieldRef, K as TDbReferentialAction, Kt as TViewJoin, L as TDbDeleteResult, Lt as TDbSpaceOptions, M as TDbActionLevel, Mt as isGeoPointType, N as TDbActionProcessor, Nt as ALL_BUCKET_UNITS, O as TCrudOp, Ot as WithRelation, P as TDbCollation, Pt as BaseDbAdapter, Q as TDbWriteAction, Qt as NativeIntegrity, R as TDbFieldMeta, Rt as AtscriptDbView, S as NullableOptional, St as TValueFormatterPair, T as TCascadeResolver, Tt as TypedWithRelation, U as TDbInsertManyResult, Ut as AtscriptQueryFieldRef, V as TDbIndexField, Vt as isAtscriptDbView, W as TDbInsertResult, Wt as AtscriptQueryNode, X as TDbStorageType, Xt as AtscriptDbTable, Y as TDbRemoveGuardContext, Yt as translateQueryTree, Z as TDbUpdateResult, Zt as IntegrityStrategy, _ as DbRow, _t as TSearchIndexInfo, a as jsonValueAncestor, an as FieldMappingStrategy, at as TExistingTableOption, b as FlatOf, bt as TTableResolver, c as AggregateControls, cn as UniquSelect, ct as TFkLookupTarget, d as AggregateQuery, dt as TIdentification, en as DbResponse, et as TDbWriteGuardContext, f as AggregateResult, ft as TMetaResponse, g as DbQuery, gt as TRelationInfo, h as DbPatch, ht as TReferencingForeignKey, i as isJsonValueField, in as DocumentFieldMapper, it as TExistingForeignKey, j as TDbActionIntent, jt as isGeoIndexableType, k as TCrudPermissions, kt as TableMetadata, l as AggregateExpr, lt as TIdDescriptor, m as DbControls, mt as TPrimaryKeyChange, n as TResolvedBucket, nn as DbEncryption, nt as TEnsureTableOptions, o as normalizeComputedSelect, on as NoopLogger, ot as TFieldMeta, p as AtscriptDbWritable, pt as TMetadataOverrides, q as TDbRelation, qt as TViewPlan, r as isBucketableField, rn as TDbEncryptionOptions, rt as TExistingColumn, s as resolveCalendarBuckets, sn as TGenericLogger, st as TFkLookupResolver, t as TBucketFieldSource, tn as resolveDesignType, tt as TDeleteOptions, u as AggregateFn, ut as TIdResolveOptions, v as FieldOpsFor, vt as TSyncColumnResult, w as PrimaryKeyOf, wt as TWriteTableResolver, x as NavPropsOf, xt as TTouchManyOptions, y as FilterExpr, yt as TTableOptionDiff, z as TDbForeignKey, zt as TViewColumnMapping } from "./buckets-C-27xmtq.cjs";
+import { $ as TDbWriteGuard, $t as IntegrityStrategy, A as TDbActionInfo, At as UniqueryControls, B as TDbIndex, Bt as AtscriptDbView, C as OwnPropsOf, Ct as TTouchManyOptions, D as TColumnDiff, Dt as TWriteTableResolver, E as TCascadeTarget, Et as TWriteOptions, F as TDbDefaultFn, Ft as ALL_BUCKET_UNITS, G as TDbObjectKind, Gt as AtscriptQueryFieldRef, H as TDbIndexType, Ht as isAtscriptDbView, I as TDbDefaultValue, It as BaseDbAdapter, J as TDbRemoveGuard, Jt as TViewJoin, K as TDbReferentialAction, Kt as AtscriptQueryNode, L as TDbDeleteResult, Lt as DbSpace, M as TDbActionLevel, Mt as TableMetadata, N as TDbActionProcessor, Nt as isGeoIndexableType, O as TCrudOp, Ot as TypedWithRelation, P as TDbCollation, Pt as isGeoPointType, Q as TDbWriteAction, Qt as AtscriptDbTable, R as TDbFieldMeta, Rt as TAdapterFactory, S as NullableOptional, St as TTableResolver, T as TCascadeResolver, Tt as TViewJsonType, U as TDbInsertManyResult, Ut as aliasTargetOf, V as TDbIndexField, Vt as TViewColumnMapping, W as TDbInsertResult, Wt as AtscriptQueryComparison, X as TDbStorageType, Xt as isFieldRef, Y as TDbRemoveGuardContext, Yt as TViewPlan, Z as TDbUpdateResult, Zt as translateQueryTree, _ as DbRow, _t as TReferencingForeignKey, a as jsonValueAncestor, an as TDbEncryptionOptions, at as TExistingColumn, b as FlatOf, bt as TSyncColumnResult, c as AggregateControls, cn as TReadControls, ct as TFieldMeta, d as AggregateQuery, dn as UniquSelect, dt as TIdDescriptor, en as NativeIntegrity, et as TDbWriteGuardContext, f as AggregateResult, ft as TIdResolveOptions, g as DbQuery, gt as TPrimaryKeyChange, h as DbPatch, ht as TMetadataOverrides, i as isJsonValueField, in as DbEncryption, it as TEnsureTableOptions, j as TDbActionIntent, jt as WithRelation, k as TCrudPermissions, kt as Uniquery, l as AggregateExpr, ln as NoopLogger, lt as TFkLookupResolver, m as DbControls, mt as TMetaResponse, n as TResolvedBucket, nn as DbResponse, nt as TDerivedChangeReason, o as normalizeComputedSelect, on as DocumentFieldMapper, ot as TExistingForeignKey, p as AtscriptDbWritable, pt as TIdentification, q as TDbRelation, qt as AtscriptRef, r as isBucketableField, rn as resolveDesignType, rt as TDerivedColumn, s as resolveCalendarBuckets, sn as FieldMappingStrategy, st as TExistingTableOption, t as TBucketFieldSource, tn as AtscriptDbReadable, tt as TDeleteOptions, u as AggregateFn, un as TGenericLogger, ut as TFkLookupTarget, v as FieldOpsFor, vt as TRelationInfo, w as PrimaryKeyOf, wt as TValueFormatterPair, x as NavPropsOf, xt as TTableOptionDiff, y as FilterExpr, yt as TSearchIndexInfo, z as TDbForeignKey, zt as TDbSpaceOptions } from "./buckets-Bv4pah66.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, r as getPath, t as deletePath } from "./object-DSN0h9lB.cjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-CV7y8nC6.cjs";
-import { _ as DbErrorCode, a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, g as DbError, h as CasMismatchError, l as isEmptyObject, m as CasExhaustedError, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject, v as bucketTimeZoneUnavailable } from "./validator-Drb2N-YL.cjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as bucketTimeZoneUnavailable, 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 } from "./validator-Bw6ks9Hy.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.cjs";
-import { n as isColumnTypeChanged } from "./column-diff-BmqvgBWw.cjs";
-import { i as tableNameOf } from "./relation-helpers-DxrvS6ar.cjs";
+import { n as isColumnTypeChanged } from "./column-diff-DiBbXyLA.cjs";
+import { i as tableNameOf } from "./relation-helpers-DQ_nRsV9.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, ResolvedBucket as ResolvedBucket$1, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
+import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/shared/consts.d.ts
 /**
@@ -23,7 +25,7 @@ declare const DEFAULT_DB_SPACE = "default";
  * for queries, filters, and controls.
  */
 declare class RelationalFieldMapper extends FieldMappingStrategy {
-  reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
+  reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata, _controls?: TReadControls): Record<string, unknown>;
   translateQuery(query: Uniquery$1, meta: TableMetadata): DbQuery;
   /** The flattened column of a logical path (`contact.email` → `contact__email`). */
   protected physicalPath(logical: string, meta: TableMetadata): string;
@@ -475,6 +477,21 @@ declare function decomposePatch(payload: Record<string, unknown>, table: Atscrip
  */
 declare function assertNoVersionWrites(data: Record<string, unknown>, versionColumn: string): void;
 //#endregion
+//#region src/table/db-entity.d.ts
+/**
+ * Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
+ * whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
+ * A `@db.alias` type is not one, and neither is a plain `export type X = Table`
+ * or a field typed with a table (`customer: Customer`) — since 0.1.141 the
+ * entity annotations stay on the declaring interface instead of travelling
+ * with every reference.
+ *
+ * Filters a module namespace before a sync:
+ * `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
+ * @since 0.1.141
+ */
+declare function isDbEntityType(value: unknown): value is TAtscriptAnnotatedType;
+//#endregion
 //#region src/shared/failure-collector.d.ts
 /**
  * Collects failures from a batch of independent operations so one failing
@@ -489,4 +506,4 @@ declare function createFailureCollector(what: string): {
   throwIfAny: () => void;
 };
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadControls, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aliasTargetOf, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, deletePath, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, getPath, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

package/dist/index.d.mts

@@ -1,10 +1,12 @@
-import { $ as TDbWriteGuard, $t as AtscriptDbReadable, A as TDbActionInfo, At as findAncestorInSet, B as TDbIndex, Bt as TViewJsonType, C as OwnPropsOf, Ct as TWriteOptions, D as TColumnDiff, Dt as UniqueryControls, E as TCascadeTarget, Et as Uniquery, F as TDbDefaultFn, Ft as DbSpace, G as TDbObjectKind, Gt as AtscriptRef, H as TDbIndexType, Ht as AtscriptQueryComparison, I as TDbDefaultValue, It as TAdapterFactory, J as TDbRemoveGuard, Jt as isFieldRef, K as TDbReferentialAction, Kt as TViewJoin, L as TDbDeleteResult, Lt as TDbSpaceOptions, M as TDbActionLevel, Mt as isGeoPointType, N as TDbActionProcessor, Nt as ALL_BUCKET_UNITS, O as TCrudOp, Ot as WithRelation, P as TDbCollation, Pt as BaseDbAdapter, Q as TDbWriteAction, Qt as NativeIntegrity, R as TDbFieldMeta, Rt as AtscriptDbView, S as NullableOptional, St as TValueFormatterPair, T as TCascadeResolver, Tt as TypedWithRelation, U as TDbInsertManyResult, Ut as AtscriptQueryFieldRef, V as TDbIndexField, Vt as isAtscriptDbView, W as TDbInsertResult, Wt as AtscriptQueryNode, X as TDbStorageType, Xt as AtscriptDbTable, Y as TDbRemoveGuardContext, Yt as translateQueryTree, Z as TDbUpdateResult, Zt as IntegrityStrategy, _ as DbRow, _t as TSearchIndexInfo, a as jsonValueAncestor, an as FieldMappingStrategy, at as TExistingTableOption, b as FlatOf, bt as TTableResolver, c as AggregateControls, cn as UniquSelect, ct as TFkLookupTarget, d as AggregateQuery, dt as TIdentification, en as DbResponse, et as TDbWriteGuardContext, f as AggregateResult, ft as TMetaResponse, g as DbQuery, gt as TRelationInfo, h as DbPatch, ht as TReferencingForeignKey, i as isJsonValueField, in as DocumentFieldMapper, it as TExistingForeignKey, j as TDbActionIntent, jt as isGeoIndexableType, k as TCrudPermissions, kt as TableMetadata, l as AggregateExpr, lt as TIdDescriptor, m as DbControls, mt as TPrimaryKeyChange, n as TResolvedBucket, nn as DbEncryption, nt as TEnsureTableOptions, o as normalizeComputedSelect, on as NoopLogger, ot as TFieldMeta, p as AtscriptDbWritable, pt as TMetadataOverrides, q as TDbRelation, qt as TViewPlan, r as isBucketableField, rn as TDbEncryptionOptions, rt as TExistingColumn, s as resolveCalendarBuckets, sn as TGenericLogger, st as TFkLookupResolver, t as TBucketFieldSource, tn as resolveDesignType, tt as TDeleteOptions, u as AggregateFn, ut as TIdResolveOptions, v as FieldOpsFor, vt as TSyncColumnResult, w as PrimaryKeyOf, wt as TWriteTableResolver, x as NavPropsOf, xt as TTouchManyOptions, y as FilterExpr, yt as TTableOptionDiff, z as TDbForeignKey, zt as TViewColumnMapping } from "./buckets-BFG2RYRW.mjs";
+import { $ as TDbWriteGuard, $t as IntegrityStrategy, A as TDbActionInfo, At as UniqueryControls, B as TDbIndex, Bt as AtscriptDbView, C as OwnPropsOf, Ct as TTouchManyOptions, D as TColumnDiff, Dt as TWriteTableResolver, E as TCascadeTarget, Et as TWriteOptions, F as TDbDefaultFn, Ft as ALL_BUCKET_UNITS, G as TDbObjectKind, Gt as AtscriptQueryFieldRef, H as TDbIndexType, Ht as isAtscriptDbView, I as TDbDefaultValue, It as BaseDbAdapter, J as TDbRemoveGuard, Jt as TViewJoin, K as TDbReferentialAction, Kt as AtscriptQueryNode, L as TDbDeleteResult, Lt as DbSpace, M as TDbActionLevel, Mt as TableMetadata, N as TDbActionProcessor, Nt as isGeoIndexableType, O as TCrudOp, Ot as TypedWithRelation, P as TDbCollation, Pt as isGeoPointType, Q as TDbWriteAction, Qt as AtscriptDbTable, R as TDbFieldMeta, Rt as TAdapterFactory, S as NullableOptional, St as TTableResolver, T as TCascadeResolver, Tt as TViewJsonType, U as TDbInsertManyResult, Ut as aliasTargetOf, V as TDbIndexField, Vt as TViewColumnMapping, W as TDbInsertResult, Wt as AtscriptQueryComparison, X as TDbStorageType, Xt as isFieldRef, Y as TDbRemoveGuardContext, Yt as TViewPlan, Z as TDbUpdateResult, Zt as translateQueryTree, _ as DbRow, _t as TReferencingForeignKey, a as jsonValueAncestor, an as TDbEncryptionOptions, at as TExistingColumn, b as FlatOf, bt as TSyncColumnResult, c as AggregateControls, cn as TReadControls, ct as TFieldMeta, d as AggregateQuery, dn as UniquSelect, dt as TIdDescriptor, en as NativeIntegrity, et as TDbWriteGuardContext, f as AggregateResult, ft as TIdResolveOptions, g as DbQuery, gt as TPrimaryKeyChange, h as DbPatch, ht as TMetadataOverrides, i as isJsonValueField, in as DbEncryption, it as TEnsureTableOptions, j as TDbActionIntent, jt as WithRelation, k as TCrudPermissions, kt as Uniquery, l as AggregateExpr, ln as NoopLogger, lt as TFkLookupResolver, m as DbControls, mt as TMetaResponse, n as TResolvedBucket, nn as DbResponse, nt as TDerivedChangeReason, o as normalizeComputedSelect, on as DocumentFieldMapper, ot as TExistingForeignKey, p as AtscriptDbWritable, pt as TIdentification, q as TDbRelation, qt as AtscriptRef, r as isBucketableField, rn as resolveDesignType, rt as TDerivedColumn, s as resolveCalendarBuckets, sn as FieldMappingStrategy, st as TExistingTableOption, t as TBucketFieldSource, tn as AtscriptDbReadable, tt as TDeleteOptions, u as AggregateFn, un as TGenericLogger, ut as TFkLookupTarget, v as FieldOpsFor, vt as TRelationInfo, w as PrimaryKeyOf, wt as TValueFormatterPair, x as NavPropsOf, xt as TTableOptionDiff, y as FilterExpr, yt as TSearchIndexInfo, z as TDbForeignKey, zt as TDbSpaceOptions } from "./buckets-CjL7F-hp.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, r as getPath, t as deletePath } from "./object-DSN0h9lB.mjs";
 import { c as CalendarBucketLabel, d as WeekStart, g as ALL_AGGREGATE_FNS, l as ComputedExpr, o as BucketExpr, s as BucketUnit, u as ResolvedBucket } from "./agg-D5DHsAby.mjs";
-import { _ as DbErrorCode, a as buildValidationContext, c as isNavRelation, d as TArrayPatch, f as TDbPatch, g as DbError, h as CasMismatchError, l as isEmptyObject, m as CasExhaustedError, n as ValidatorMode, p as getKeyProps, r as buildDbValidator, s as forceNavNonOptional, t as ValidationContext, u as isPlainObject, v as bucketTimeZoneUnavailable } from "./validator-Drb2N-YL.mjs";
+import { a as buildValidationContext, c as isNavRelation, d as getKeyProps, f as CasExhaustedError, g as bucketTimeZoneUnavailable, 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 } from "./validator-Bw6ks9Hy.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-BWy60OvG.mjs";
-import { n as isColumnTypeChanged } from "./column-diff-DPkbZIVE.mjs";
-import { i as tableNameOf } from "./relation-helpers-D3Zu0Mta.mjs";
+import { n as isColumnTypeChanged } from "./column-diff-n-k5KY0u.mjs";
+import { i as tableNameOf } from "./relation-helpers-B59to_dG.mjs";
+import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, ResolvedBucket as ResolvedBucket$1, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 
 //#region src/shared/consts.d.ts
@@ -23,7 +25,7 @@ declare const DEFAULT_DB_SPACE = "default";
  * for queries, filters, and controls.
  */
 declare class RelationalFieldMapper extends FieldMappingStrategy {
-  reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata): Record<string, unknown>;
+  reconstructFromRead(row: Record<string, unknown>, meta: TableMetadata, _controls?: TReadControls): Record<string, unknown>;
   translateQuery(query: Uniquery$1, meta: TableMetadata): DbQuery;
   /** The flattened column of a logical path (`contact.email` → `contact__email`). */
   protected physicalPath(logical: string, meta: TableMetadata): string;
@@ -475,6 +477,21 @@ declare function decomposePatch(payload: Record<string, unknown>, table: Atscrip
  */
 declare function assertNoVersionWrites(data: Record<string, unknown>, versionColumn: string): void;
 //#endregion
+//#region src/table/db-entity.d.ts
+/**
+ * Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
+ * whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
+ * A `@db.alias` type is not one, and neither is a plain `export type X = Table`
+ * or a field typed with a table (`customer: Customer`) — since 0.1.141 the
+ * entity annotations stay on the declaring interface instead of travelling
+ * with every reference.
+ *
+ * Filters a module namespace before a sync:
+ * `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
+ * @since 0.1.141
+ */
+declare function isDbEntityType(value: unknown): value is TAtscriptAnnotatedType;
+//#endregion
 //#region src/shared/failure-collector.d.ts
 /**
  * Collects failures from a batch of independent operations so one failing
@@ -489,4 +506,4 @@ declare function createFailureCollector(what: string): {
   throwIfAny: () => void;
 };
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, type AtscriptDbWritable, type AtscriptQueryComparison, type AtscriptQueryFieldRef, type AtscriptQueryNode, type AtscriptRef, BaseDbAdapter, type BucketExpr, type BucketUnit, type CalendarBucketLabel, CasExhaustedError, CasMismatchError, type ComputedExpr, DEFAULT_DB_SPACE, type DbControls, DbEncryption, DbError, type DbErrorCode, type DbPatch, type DbQuery, type DbResponse, type DbRow, DbSpace, type DbValidationContext, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type NullableOptional, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type ResolvedBucket, type TAdapterFactory, type TArrayPatch, type TBucketFieldSource, type TBucketSourceTable, type TBucketSourceVerdict, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCas, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbEncryptionOptions, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbObjectKind, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbRemoveGuard, type TDbRemoveGuardContext, type TDbSpaceOptions, type TDbStorageType, type TDbUpdateResult, type TDbWriteAction, type TDbWriteGuard, type TDbWriteGuardContext, type TDeleteOptions, type TDerivedChangeReason, type TDerivedColumn, type TEnsureTableOptions, type TExistingColumn, type TExistingForeignKey, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFilterPredicate, type TFilterRef, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TGuardedQuery, type TIdDescriptor, type TIdResolveOptions, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TPrimaryKeyChange, type TQueryPathKind, type TQueryPathOp, type TQueryPathRefs, type TQueryPathSource, type TReadControls, type TReferencingForeignKey, type TRelationInfo, type TResolvedBucket, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TTouchManyOptions, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewJsonType, type TViewPlan, type TWriteOptions, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WeekStart, type WithOptimisticRetryOptions, type WithRelation, acceptedOperatorsHint, aliasTargetOf, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, deletePath, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, getPath, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

package/dist/index.mjs

@@ -1,10 +1,12 @@
 import { a as bucketTimeZoneUnavailable, n as CasMismatchError, r as DbError, t as CasExhaustedError } from "./db-error-D5uilS_A.mjs";
-import { $ as jsonValueAncestor, A as bucketSourceVerdict, B as narrowerFilterOps, C as NativeIntegrity, D as ENCRYPTED_REASON, E as ADAPTER_FILTER_REASON, F as guardAggregate, G as FieldMappingStrategy, H as unsupportedOperatorMessage, I as guardFilter, J as findAncestorInSet, K as UniquSelect, L as guardPath, M as checkHavingKeys, N as classifyQueryPath, O as acceptedOperatorsHint, P as collectQueryPaths, Q as isJsonValueField, R as guardPaths, S as IntegrityStrategy, T as resolveDesignType, U as RelationalFieldMapper, V as sortFieldNames, W as DocumentFieldMapper, X as isGeoPointType, Y as isGeoIndexableType, Z as isBucketableField, _ as decomposePatch, b as BaseDbAdapter, et as normalizeComputedSelect, g as assertNoVersionWrites, h as AtscriptDbTable, j as canFilterLeaf, k as assertGeoPoint, m as isAtscriptDbView, n as isColumnTypeChanged, nt as NoopLogger, p as AtscriptDbView, q as TableMetadata, tt as resolveCalendarBuckets, v as ApplicationIntegrity, w as AtscriptDbReadable, x as createFailureCollector, y as ALL_BUCKET_UNITS, z as guardQuery } from "./column-diff-BwOA5101.mjs";
+import { $ as isJsonValueField, A as assertGeoPoint, B as guardQuery, C as IntegrityStrategy, D as ADAPTER_FILTER_REASON, E as resolveDesignType, F as collectQueryPaths, G as DocumentFieldMapper, H as sortFieldNames, I as guardAggregate, J as TableMetadata, K as FieldMappingStrategy, L as guardFilter, M as canFilterLeaf, N as checkHavingKeys, O as ENCRYPTED_REASON, P as classifyQueryPath, Q as isBucketableField, R as guardPath, S as createFailureCollector, T as AtscriptDbReadable, U as unsupportedOperatorMessage, V as narrowerFilterOps, W as RelationalFieldMapper, X as isGeoPointType, Y as isGeoIndexableType, Z as aliasTargetOf, _ as assertNoVersionWrites, b as ALL_BUCKET_UNITS, et as jsonValueAncestor, g as AtscriptDbTable, h as isAtscriptDbView, j as bucketSourceVerdict, k as acceptedOperatorsHint, m as AtscriptDbView, n as isColumnTypeChanged, nt as resolveCalendarBuckets, q as UniquSelect, rt as NoopLogger, tt as normalizeComputedSelect, v as decomposePatch, w as NativeIntegrity, x as BaseDbAdapter, y as ApplicationIntegrity, z as guardPaths } from "./column-diff-CmFNXV8C.mjs";
 import { t as ALL_AGGREGATE_FNS } from "./aggregate-fns-CfsveE1w.mjs";
-import { v as tableNameOf } from "./nested-writer-FWD5oOYh.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, l as isEmptyObject, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator, u as isPlainObject } from "./validator-Ch7UIQl9.mjs";
+import { v as tableNameOf } from "./nested-writer-BO3vhbkP.mjs";
+import { t as DB_ENTITY_ANNOTATIONS } from "./derived-rules-0sKn4f5C.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, d as getPath, f as isEmptyObject, l as deletePath, o as isNavRelation, p as isPlainObject, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator, u as findAncestorInSet } from "./validator-D8bPsXPN.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";
 import { computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
 //#region src/encryption.ts
@@ -202,6 +204,14 @@ async function withOptimisticRetry(table, filter, mutator, opts) {
 //#endregion
 //#region src/table/db-space.ts
 /**
+* A `@db.alias` type only names a join scope inside a view definition — it
+* is never a table or view of its own (since 0.1.141).
+*/
+function assertNotAlias(type) {
+	const target = aliasTargetOf(type);
+	if (target) throw new Error(`"${type.id ?? ""}" is a @db.alias of "${target.id ?? ""}" — a join scope, not a table or view; register "${target.id ?? ""}" instead`);
+}
+/**
 * A database space — a registry of tables and views sharing the same adapter type and driver.
 *
 * `DbSpace` solves the cross-table discovery problem: when table A has a relation
@@ -258,6 +268,7 @@ var DbSpace = class {
 	getTable(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
+			assertNotAlias(type);
 			readable = new AtscriptDbTable(type, this._createAdapter(), logger || this.logger, (t) => this.get(t), (t) => {
 				const resolved = this.get(t);
 				return resolved instanceof AtscriptDbTable ? resolved : void 0;
@@ -277,6 +288,7 @@ var DbSpace = class {
 	getView(type, logger) {
 		let readable = this._readables.get(type);
 		if (!readable) {
+			assertNotAlias(type);
 			readable = new AtscriptDbView(type, this._createAdapter(), logger || this.logger, (t) => this.get(t));
 			readable.setEncryption(this._encryption);
 			this._readables.set(type, readable);
@@ -391,4 +403,22 @@ function translateQueryTree(node, resolveField) {
 	return { [leftField]: { [comp.op]: comp.right } };
 }
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RelationalFieldMapper, TableMetadata, UniquSelect, acceptedOperatorsHint, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };
+//#region src/table/db-entity.ts
+/**
+* Whether `value` is a compiled type a `DbSpace` accepts: an annotated type
+* whose own declaration carries `@db.table`, `@db.view` or `@db.view.for`.
+* A `@db.alias` type is not one, and neither is a plain `export type X = Table`
+* or a field typed with a table (`customer: Customer`) — since 0.1.141 the
+* entity annotations stay on the declaring interface instead of travelling
+* with every reference.
+*
+* Filters a module namespace before a sync:
+* `syncSchema(db, Object.values(models).filter(isDbEntityType))`.
+* @since 0.1.141
+*/
+function isDbEntityType(value) {
+	if (!isAnnotatedType(value)) return false;
+	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, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RelationalFieldMapper, TableMetadata, UniquSelect, acceptedOperatorsHint, aliasTargetOf, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, deletePath, findAncestorInSet, forceNavNonOptional, getDbFieldOp, getKeyProps, getPath, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, walkFilter, withOptimisticRetry };

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

@@ -26,13 +26,17 @@ function findRemoteFK(targetTable, thisTableName, alias) {
 	}
 }
 /**
-* Table name of an annotated type — its `@db.table`, else its type id (`""`
-* when neither is set). The rule relations, foreign keys and view plans use
-* to name a referenced table.
+* Physical name of an annotated type — its `@db.table`, else its `@db.view`
+* name (a view is a readable source too, since 0.1.141), else its type id
+* (`""` when none is set). The rule relations, foreign keys and view plans
+* use to name a referenced table or view.
 * @since 0.1.136
 */
 function tableNameOf(type) {
-	return type?.metadata?.get("db.table") || type?.id || "";
+	const table = type?.metadata?.get("db.table");
+	if (table) return table;
+	const view = type?.metadata?.get("db.view");
+	return typeof view === "string" && view || type?.id || "";
 }
 /**
 * Resolves the target table name from a relation's target type metadata.

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

@@ -26,13 +26,17 @@ function findRemoteFK(targetTable, thisTableName, alias) {
 	}
 }
 /**
-* Table name of an annotated type — its `@db.table`, else its type id (`""`
-* when neither is set). The rule relations, foreign keys and view plans use
-* to name a referenced table.
+* Physical name of an annotated type — its `@db.table`, else its `@db.view`
+* name (a view is a readable source too, since 0.1.141), else its type id
+* (`""` when none is set). The rule relations, foreign keys and view plans
+* use to name a referenced table or view.
 * @since 0.1.136
 */
 function tableNameOf(type) {
-	return type?.metadata?.get("db.table") || type?.id || "";
+	const table = type?.metadata?.get("db.table");
+	if (table) return table;
+	const view = type?.metadata?.get("db.view");
+	return typeof view === "string" && view || type?.id || "";
 }
 /**
 * Resolves the target table name from a relation's target type metadata.

package/dist/object-DSN0h9lB.d.cts

@@ -0,0 +1,30 @@
+//#region src/shared/object.d.ts
+/**
+ * Plain object: prototype is `Object.prototype` or `null` — never a class
+ * instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+ * Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+declare function isEmptyObject(obj: Record<string, unknown>): boolean;
+/**
+ * Finds the nearest ancestor of `path` that belongs to `set`.
+ * Used by both the build pipeline (in `_classifyFields`) and
+ * runtime reconstruction on the Readable.
+ */
+declare function findAncestorInSet(path: string, set: ReadonlySet<string>): string | undefined;
+/**
+ * Reads a dot-path (or its segments) off a nested plain object: `undefined`
+ * past a missing step, or a step that is not a plain object (arrays are not
+ * descended into — no positional indexing).
+ * @since 0.1.141
+ */
+declare function getPath(row: Record<string, unknown>, path: string | readonly string[]): unknown;
+/**
+ * Deletes a dot-path (or its segments) from a nested plain object; a no-op
+ * when an intermediate step is missing or not a plain object.
+ * @since 0.1.141
+ */
+declare function deletePath(target: Record<string, unknown>, path: string | readonly string[]): void;
+//#endregion
+export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, getPath as r, deletePath as t };

package/dist/object-DSN0h9lB.d.mts

@@ -0,0 +1,30 @@
+//#region src/shared/object.d.ts
+/**
+ * Plain object: prototype is `Object.prototype` or `null` — never a class
+ * instance (`Date`, `Uint8Array`, `ObjectId`, …) and never an array.
+ * Browser-safe; shared by the write paths, the HTTP shape gate and the client.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** Zero-allocation emptiness check for a plain object (`{}` → `true`). */
+declare function isEmptyObject(obj: Record<string, unknown>): boolean;
+/**
+ * Finds the nearest ancestor of `path` that belongs to `set`.
+ * Used by both the build pipeline (in `_classifyFields`) and
+ * runtime reconstruction on the Readable.
+ */
+declare function findAncestorInSet(path: string, set: ReadonlySet<string>): string | undefined;
+/**
+ * Reads a dot-path (or its segments) off a nested plain object: `undefined`
+ * past a missing step, or a step that is not a plain object (arrays are not
+ * descended into — no positional indexing).
+ * @since 0.1.141
+ */
+declare function getPath(row: Record<string, unknown>, path: string | readonly string[]): unknown;
+/**
+ * Deletes a dot-path (or its segments) from a nested plain object; a no-op
+ * when an intermediate step is missing or not a plain object.
+ * @since 0.1.141
+ */
+declare function deletePath(target: Record<string, unknown>, path: string | readonly string[]): void;
+//#endregion
+export { isPlainObject as a, isEmptyObject as i, findAncestorInSet as n, getPath as r, deletePath as t };