@atscript/db 0.1.164 → 0.1.165

package/dist/agg.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_aggregate_fns = require("./aggregate-fns-DupYzFD7.cjs");
+const require_aggregate_fns = require("./aggregate-fns-CNtrSxGH.cjs");
 let _uniqu_core = require("@uniqu/core");
 //#region src/agg.ts
 /**

package/dist/agg.d.cts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-B8UOod-v.cjs";
+import { r as TResolvedBucket } from "./buckets-BDxKfCNo.cjs";
 import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-42CSpGDR.cjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/agg.d.mts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-CHyspjYP.mjs";
+import { r as TResolvedBucket } from "./buckets-CHUgky8T.mjs";
 import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-Wo-smrYV.mjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/agg.mjs

@@ -1,4 +1,4 @@
-import { s as assertAggregateFn } from "./aggregate-fns-DsS9UQVB.mjs";
+import { s as assertAggregateFn } from "./aggregate-fns-CmtSNIHm.mjs";
 import { isAggregateExpr, isBucketExpr, resolveAlias } from "@uniqu/core";
 //#region src/agg.ts
 /**

package/dist/{aggregate-fns-DupYzFD7.cjs → aggregate-fns-CNtrSxGH.cjs}

@@ -1,4 +1,4 @@
-const require_db_error = require("./db-error-DmF1_xrz.cjs");
+const require_db_error = require("./db-error-G3sgvL87.cjs");
 let _uniqu_core = require("@uniqu/core");
 //#region src/query/aggregate-fns.ts
 /**

package/dist/{aggregate-fns-DsS9UQVB.mjs → aggregate-fns-CmtSNIHm.mjs}

@@ -1,4 +1,4 @@
-import { r as DbError } from "./db-error-hraC12B9.mjs";
+import { r as DbError } from "./db-error-BMy4-OWq.mjs";
 import { ROW_ORDER_FNS, isAggregateExpr } from "@uniqu/core";
 //#region src/query/aggregate-fns.ts
 /**

package/dist/{buckets-B8UOod-v.d.cts → buckets-BDxKfCNo.d.cts}

@@ -1,4 +1,4 @@
-import { r as DbError } from "./db-error-B_DRL1E9.cjs";
+import { r as DbError } from "./db-error-DQUw2cED.cjs";
 import { f as TFieldOps } from "./ops-AqhV7s9o.cjs";
 import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery, AggregateQuery as AggregateQuery$1, AggregateResult, BucketUnit, FieldOpsFor, FilterExpr, FilterExpr as FilterExpr$1, NullsPlacement, NullsPlacement as NullsPlacement$1, RelationOp, ResolvedBucket, ResolvedRowOrderKey, ResolvedSelectExpr, TypedWithRelation, Uniquery, Uniquery as Uniquery$1, UniqueryControls, UniqueryControls as UniqueryControls$1, UniqueryInsights, WithRelation, WithRelation as WithRelation$1 } from "@uniqu/core";
 import { AtscriptExprNode, AtscriptExprNode as AtscriptExprNode$1, AtscriptOrderItem, AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, FlatOf as FlatOf$1, NavPropsOf, NavPropsOf as NavPropsOf$1, OwnPropsOf, OwnPropsOf as OwnPropsOf$1, PrimaryKeyOf, PrimaryKeyOf as PrimaryKeyOf$1, TAtscriptAnnotatedType, TAtscriptDataType, TAtscriptTypeObject, TMetadataMap, TSerializedAnnotatedType, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
@@ -568,16 +568,17 @@ declare function relationStaticFilter(relation: TDbRelation, name?: string): TRe
 //#endregion
 //#region src/table/db-readable.d.ts
 /**
- * Extracts nav prop names from a query's `$with` array.
+ * Extracts nav prop names from a query's `$with` array — mutable or readonly
+ * (`as const`, since 0.1.165), object entries or the string shorthand.
  * Returns `never` when `$with` is absent → all nav props stripped from response.
  */
 type ExtractWith<Q> = Q extends {
   controls: {
-    $with: Array<{
-      name: infer N extends string;
-    }>;
+    $with: ReadonlyArray<infer E>;
   };
-} ? N : never;
+} ? E extends {
+  name: infer N extends string;
+} ? N : E extends string ? E : never : never;
 /**
  * Computes the response type for a query:
  * - Strips all nav props from the base DataType
@@ -770,6 +771,17 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    */
   get onUpdateIncPhysical(): readonly string[];
   private _onUpdateIncPhysical?;
+  /**
+   * Physical column names of the insert-only fields (`number.timestamp.created`,
+   * since 0.1.165): a full replace keeps their stored values. Empty when
+   * there are none.
+   *
+   * @internal Adapter-facing surface; not part of the consumer API.
+   */
+  get insertOnlyPhysical(): readonly string[];
+  private _insertOnlyPhysical?;
+  /** The physical columns of a set of top-level logical fields. */
+  private _physicalNames;
   /**
    * Logical paths of the `@db.column.version.exempt` fields, including objects
    * whose direct children are all exempt. A patch that writes only these (and
@@ -1327,6 +1339,14 @@ declare class NativeIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/table/db-table.d.ts
+/**
+ * The filter of `updateMany` / `replaceMany` / `deleteMany` (since 0.1.165):
+ * the flat field paths with the nav keys taking relational predicates
+ * (`$some` / `$none`), as in the read filter. Before, a nav key was typed as
+ * the flat type's empty value, so a predicate failed to typecheck. A table
+ * without nav props keeps the plain flat filter.
+ */
+type MutationFilter<FlatType, NavType extends Record<string, unknown>> = string extends keyof NavType ? FilterExpr<FlatType> : FilterExpr<Omit<FlatType, keyof NavType>, NavType>;
 declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>, FlatType = NullableOptional<FlatOf<T>>, A extends BaseDbAdapter = BaseDbAdapter, IdType = PrimaryKeyOf<T>, OwnProps = NullableOptional<OwnPropsOf<T>>, NavType extends Record<string, unknown> = NavPropsOf<T>> extends AtscriptDbReadable<T, DataType, FlatType, A, IdType, OwnProps, NavType> {
   protected _cascadeResolver?: TCascadeResolver;
   protected _fkLookupResolver?: TFkLookupResolver;
@@ -1352,14 +1372,67 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * Adapters may define additional purposes.
    */
   getValidator(purpose: string): Validator<T, DataType>;
+  /**
+   * A standard purpose's validator called WITHOUT a context validates in that
+   * purpose's write mode (since 0.1.165): `getValidator("insert").validate(row, true)`
+   * accepts what an insert accepts — omitted primary key, defaulted, FK and
+   * navigation fields. Before, the db plugin saw no mode and ran inert while
+   * navigation fields were forced required. An explicit context still wins.
+   */
+  private _withDefaultContext;
+  /** A fresh validation context of a write `mode` — the one its write paths build. */
+  private _validationCtx;
+  /** {@link normalizeWriteErrors} for this table: its constraint errors normalized against its metadata. */
+  private _normalizeWrite;
+  /**
+   * Validates rows exactly as a write in `mode` would, without writing
+   * (since 0.1.165): each row is cloned, given the defaults / stamps that
+   * write applies, and validated with that write's validator and context.
+   * Returns one `{ index, path, message }` per problem — `[]` when every row
+   * is valid; the caller's rows are not modified.
+   *
+   * `fk: true` also checks that every foreign key names an existing row
+   * (by lookup, on every adapter — native-FK adapters otherwise leave that to
+   * the engine at write time); a missing target is reported on each of the
+   * key's fields. Rows that fail type validation are not looked up.
+   *
+   * @param mode - `'insert'` (default), `'replace'` or `'patch'`.
+   */
+  validateRows(rows: ReadonlyArray<Record<string, unknown>>, mode?: "insert" | "replace" | "patch", opts?: {
+    fk?: boolean;
+  }): Promise<TValidateRowsError[]>;
+  /**
+   * {@link validateRows}' FK lookup: one entry per FK field of each row naming
+   * a missing target. Distinct key tuples are looked up in chunks of
+   * {@link FK_LOOKUP_CHUNK} — reading the target keys that exist (`$in` for a
+   * single-column key, `$or` for a composite one) and diffing in memory, so a
+   * batch never exceeds a bind-parameter limit and a miss costs no extra
+   * query. A lookup target without `find` (a custom resolver) is counted per
+   * chunk, and per tuple only in a chunk that comes up short.
+   */
+  private _missingForeignKeys;
+  /** How {@link _missingForeignKeys} reads an FK's target table, if it can. */
+  private _fkTargetReader;
   /**
    * Inserts a single record. Delegates to {@link insertMany} for unified
    * nested creation support.
    */
-  insertOne(payload: DbPatch<DataType>, opts: TInsertOptions<DataType> & {
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
+    onConflict: "ignore";
+    returning: true | readonly (keyof DataType & string)[];
+  }): Promise<TDbInsertIgnoreResult & {
+    row?: DataType;
+  }>;
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
     onConflict: "ignore";
   }): Promise<TDbInsertIgnoreResult>;
-  insertOne(payload: DbPatch<DataType>, opts?: TInsertOptions<DataType>): Promise<TDbInsertResult>;
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
+    returning: true | readonly (keyof DataType & string)[];
+  }): Promise<TDbInsertResult & {
+    row: DataType;
+  }>;
+  insertOne(payload: DbPatch<DataType>, opts?: TInsertOneOptions<DataType>): Promise<TDbInsertResult>;
+  private _insertOneRow;
   /**
    * Inserts multiple records with batch-optimized nested creation.
    *
@@ -1480,14 +1553,14 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * always breaks ties). Loop until `matchedCount === 0` to process every
    * match in batches. Not exposed over HTTP.
    */
-  updateMany(filter: FilterExpr<FlatType>, data: DbPatch<DataType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbUpdateResult>;
+  updateMany(filter: MutationFilter<FlatType, NavType>, data: DbPatch<DataType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbUpdateResult>;
   /**
    * Replaces the own fields of every row matching `filter` with `data`. The
    * payload is validated in `replace` mode (since 0.1.162) — every required
    * field must be present — except the primary key, which the filter
    * replaces as a row picker.
    */
-  replaceMany(filter: FilterExpr<FlatType>, data: DbRow<DataType>): Promise<TDbUpdateResult>;
+  replaceMany(filter: MutationFilter<FlatType, NavType>, data: DbRow<DataType>): Promise<TDbUpdateResult>;
   /**
    * Deletes every row matching `filter` (application-level cascades run first
    * where the adapter has no native foreign keys).
@@ -1499,7 +1572,7 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * `limit`: a concurrent writer can make one round delete fewer rows while
    * matches remain. Not exposed over HTTP.
    */
-  deleteMany(filter: FilterExpr<FlatType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbDeleteResult>;
+  deleteMany(filter: MutationFilter<FlatType, NavType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbDeleteResult>;
   /**
    * Runs a bounded write. `native` (default: `supportsWriteLimit()`) hands
    * `write` the physical filter and the bound; otherwise the primary keys of
@@ -1749,6 +1822,8 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * Used by parent tables to validate FROM children before the main insert,
    * ensuring errors are caught before the parent is committed.
    *
+   * @internal Nested-write plumbing — its FK step is a no-op on native-FK
+   * adapters. To validate rows yourself, use {@link validateRows}.
    * @param opts.excludeFkTargetTable - Skip FK validation to this table (the parent).
    */
   preValidateItems(items: Array<Record<string, unknown>>, opts?: {
@@ -3371,6 +3446,12 @@ declare abstract class BaseDbAdapter {
 }
 //#endregion
 //#region src/shared/union-shape.d.ts
+/**
+ * The one value member of a union (`T | null` → `T`), or `undefined` when
+ * `type` is no union or has several value members. A column of a nullable
+ * union is the column `T` alone would get (its type tags, size, precision).
+ */
+declare function soleUnionMember(type: TAtscriptAnnotatedType): TAtscriptAnnotatedType | undefined;
 /**
  * Whether a value at a path is always there (`"required"`), may be NULL /
  * missing (`"nullable"` — the path or an ancestor object is optional or a
@@ -3438,6 +3519,12 @@ declare class TableMetadata {
    * @since 0.1.156
    */
   onUpdateNow: Set<string>;
+  /**
+   * Top-level `number.timestamp.created` fields (since 0.1.165): set by the
+   * insert only — a replace keeps the stored value, a replace or patch
+   * payload's value is dropped.
+   */
+  insertOnly: Set<string>;
   /**
    * Top-level fields annotated with `@db.onUpdate.inc`: `0` on insert, `+1` in
    * the same statement on every update and replace.
@@ -3797,8 +3884,20 @@ interface TTransactionOptions {
 }
 /** Describes an available search index exposed by a database adapter. */
 interface TSearchIndexInfo {
-  /** Index name. Empty string or 'DEFAULT' for the default index. */
+  /**
+   * Index name — the name declared in the model (`@db.index.fulltext 'name'`).
+   * An index with no declared name (a MongoDB dynamic Atlas mapping) is
+   * `'DEFAULT'`.
+   */
   name: string;
+  /**
+   * Other names that resolve to the same index (`$index` / `search(…, name)`),
+   * kept for compatibility: the internal key (`atscript__fulltext__<name>`) on
+   * PostgreSQL and MySQL, and `'DEFAULT'` for MongoDB's default text index.
+   * Deprecated — address an index by {@link name}.
+   * @since 0.1.165
+   */
+  aliases?: string[];
   /** Human-readable label for UI display. */
   description?: string;
   /** Index type: text search or vector similarity search. */
@@ -4285,6 +4384,15 @@ interface TDbIndexField {
    */
   integer?: boolean;
 }
+/**
+ * One problem {@link AtscriptDbTable.validateRows} found: the row's position
+ * in the input, the field path and the message (since 0.1.165).
+ */
+interface TValidateRowsError {
+  index: number;
+  path: string;
+  message: string;
+}
 interface TDbIndex {
   /** Unique key used for identity/diffing (e.g., "atscript__plain__email") */
   key: string;
@@ -4356,6 +4464,12 @@ interface TDbFieldMeta {
   ignored: boolean;
   /** Default value from @db.default.* */
   defaultValue?: TDbDefaultValue;
+  /**
+   * Set by the insert only — a top-level `number.timestamp.created` (since
+   * 0.1.165). A replace keeps the stored value: SQL adapters leave the
+   * column out of the replace's assignment, document adapters carry it over.
+   */
+  insertOnly?: boolean;
   /**
    * How this field is stored in the database.
    * - 'column': a standard scalar column (default for primitives)
@@ -4797,6 +4911,12 @@ type TCascadeResolver = (tableName: string) => TCascadeTarget[];
  */
 interface TFkLookupTarget {
   count(filter: Record<string, unknown>): Promise<number>;
+  /**
+   * The rows matching `filter`, projected to `fields` (since 0.1.165) — lets
+   * `validateRows({ fk: true })` diff existing keys in memory. Optional: a
+   * target without it is counted instead.
+   */
+  find?(filter: Record<string, unknown>, fields: readonly string[]): Promise<Array<Record<string, unknown>>>;
 }
 /**
  * Callback that resolves a table name to a queryable target for FK validation.
@@ -4980,6 +5100,16 @@ interface TInsertOptions<Row = Record<string, unknown>> extends TWriteOptions<Ro
    */
   lockConflicts?: boolean;
 }
+/**
+ * Options of `insertOne` (since 0.1.165): {@link TInsertOptions} plus
+ * `returning` — read the stored row back by its primary key in the insert's
+ * transaction (`true`: every field, server defaults and stamps included; a
+ * field list: those fields) and answer it as `row`. A row skipped by
+ * `onConflict: 'ignore'` answers no `row`.
+ */
+interface TInsertOneOptions<Row = Record<string, unknown>> extends TInsertOptions<Row> {
+  returning?: true | readonly (keyof Row & string)[];
+}
 /**
  * Context handed to a write {@link TWriteOptions.check} (since 0.1.143) — and
  * through it to `AsDbController.checkWrite()`. Lets a permission layer verify
@@ -5156,4 +5286,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbInsertManyIgnoreResult as $, hasRelationOp as $n, TWriteOptions as $t, TCascadeTarget as A, AtscriptRef as An, TForeignKeyChange as At, TDbCollation as B, AtscriptDbReadable as Bn, TReadLockOptions as Bt, NavPropsOf$1 as C, TViewReadPlan as Cn, TEnsureTableOptions as Ct, PrimaryKeyOf$1 as D, AtscriptQueryComparison as Dn, TFieldMeta as Dt, OwnPropsOf$1 as E, AtscriptOrderItem as En, TExistingTableOption as Et, TDbActionIntent as F, translateQueryTree as Fn, TInsertOptions as Ft, TDbFieldMeta as G, ResolvedRelationFilter as Gn, TSyncColumnResult as Gt, TDbDefaultValue as H, resolveDesignType as Hn, TRelationInfo as Ht, TDbActionLevel as I, AtscriptDbTable as In, TJsonCopyTarget as It, TDbIndexField as J, TRelationFilterTable as Jn, TTableResolver as Jt, TDbForeignKey as K, TRelGuardState as Kn, TSyncIndexesOptions as Kt, TDbActionProcessor as L, IntegrityStrategy as Ln, TMetaResponse as Lt, TCrudOp as M, TViewPlan as Mn, TIdResolveOptions as Mt, TCrudPermissions as N, evaluateExpr as Nn, TIdentification as Nt, TBulkWriteOptions as O, AtscriptQueryFieldRef$1 as On, TFkLookupResolver as Ot, TDbActionInfo as P, isFieldRef as Pn, TIndexChange as Pt, TDbInsertIgnoreSlot as Q, forEachResolvedRelation as Qn, TViewJsonType as Qt, TDbActionTargetSummary as R, NativeIntegrity as Rn, TMetadataOverrides as Rt, FlatOf$1 as S, isViewType as Sn, TDerivedColumn as St, NullsPlacement$1 as T, AtscriptExprNode$1 as Tn, TExistingForeignKey as Tt, TDbDeleteManyOptions as U, REL_FILTER_MAX_DEPTH as Un, TRowResolveOptions as Ut, TDbDefaultFn as V, DbResponse as Vn, TReferencingForeignKey as Vt, TDbDeleteResult as W, REL_FILTER_MAX_NODES as Wn, TSearchIndexInfo as Wt, TDbInsertIgnoreOptions as X, andFilters as Xn, TTransactionOptions as Xt, TDbIndexType as Y, TRelationStaticFilter as Yn, TTouchManyOptions as Yt, TDbInsertIgnoreResult as Z, containsRelationFilter as Zn, TValueFormatterPair as Zt, DbPatch as _, TAdapterFactory as _n, TDbWriteGuard as _t, isJsonValueField as a, TableMetadata as an, FieldMappingStrategy as ar, TDbObjectKind as at, FieldOpsFor as b, TViewColumnMapping as bn, TDeleteOptions as bt, resolveCalendarBuckets as c, TPathPresence as cn, TGenericLogger as cr, TDbRelation as ct, AggregateFn$1 as d, ALL_VIEW_CAPABILITIES as dn, TRowOrderKey as dr, TDbStorageType as dt, TWriteTableResolver as en, isResolvedRelationFilter as er, TDbInsertManyResult as et, AggregateQuery$1 as f, BaseDbAdapter as fn, UniquSelect as fr, TDbUpdateOptions as ft, DbControls as g, DbSpace as gn, TDbWriteCheckContext as gt, AtscriptDbWritable as h, TViewCapability as hn, TDbWriteCheck as ht, isBucketableField as i, WithRelation$1 as in, DocumentFieldMapper as ir, TDbLockWait as it, TColumnDiff as j, TViewJoin as jn, TIdDescriptor as jt, TCascadeResolver as k, AtscriptQueryNode$1 as kn, TFkLookupTarget as kt, AggregateControls as l, ALL_BUCKET_UNITS as ln, TExprAggregate as lr, TDbRemoveGuard as lt, AtscriptDbTableLike as m, TIndexDiffOptions as mn, TDbWriteAction as mt, TComputedSelect as n, Uniquery$1 as nn, DbEncryption as nr, TDbIsolationLevel as nt, jsonValueAncestor as o, isGeoIndexableType as on, TReadControls as or, TDbReadLock as ot, AggregateResult as p, TForeignKeyDiffOptions as pn, TDbUpdateResult as pt, TDbIndex as q, TRelationFilterJunction as qn, TTableOptionDiff as qt, TResolvedBucket as r, UniqueryControls$1 as rn, TDbEncryptionOptions as rr, TDbLockMode as rt, normalizeComputedSelect as s, isGeoPointType as sn, NoopLogger as sr, TDbReferentialAction as st, TBucketFieldSource as t, TypedWithRelation as tn, relationStaticFilter as tr, TDbInsertResult as tt, AggregateExpr$1 as u, ALL_ISOLATION_LEVELS as un, TFirstLast as ur, TDbRemoveGuardContext as ut, DbQuery as v, TDbSpaceOptions as vn, TDbWriteGuardContext as vt, NullableOptional as w, aliasTargetOf as wn, TExistingColumn as wt, FilterExpr$1 as x, isAtscriptDbView as xn, TDerivedChangeReason as xt, DbRow as y, AtscriptDbView as yn, TDbWriteLimit as yt, TDbAvailableActions as z, TCascadePin as zn, TPrimaryKeyChange as zt };
+export { TDbInsertManyIgnoreResult as $, TRelationStaticFilter as $n, TValueFormatterPair as $t, TCascadeTarget as A, AtscriptQueryComparison as An, TForeignKeyChange as At, TDbCollation as B, MutationFilter as Bn, TPrimaryKeyChange as Bt, NavPropsOf$1 as C, TViewColumnMapping as Cn, TEnsureTableOptions as Ct, PrimaryKeyOf$1 as D, aliasTargetOf as Dn, TFieldMeta as Dt, OwnPropsOf$1 as E, TViewReadPlan as En, TExistingTableOption as Et, TDbActionIntent as F, TViewPlan as Fn, TInsertOneOptions as Ft, TDbFieldMeta as G, DbResponse as Gn, TSearchIndexInfo as Gt, TDbDefaultValue as H, NativeIntegrity as Hn, TReferencingForeignKey as Ht, TDbActionLevel as I, evaluateExpr as In, TInsertOptions as It, TDbIndexField as J, REL_FILTER_MAX_NODES as Jn, TTableOptionDiff as Jt, TDbForeignKey as K, resolveDesignType as Kn, TSyncColumnResult as Kt, TDbActionProcessor as L, isFieldRef as Ln, TJsonCopyTarget as Lt, TCrudOp as M, AtscriptQueryNode$1 as Mn, TIdResolveOptions as Mt, TCrudPermissions as N, AtscriptRef as Nn, TIdentification as Nt, TBulkWriteOptions as O, AtscriptExprNode$1 as On, TFkLookupResolver as Ot, TDbActionInfo as P, TViewJoin as Pn, TIndexChange as Pt, TDbInsertIgnoreSlot as Q, TRelationFilterTable as Qn, TValidateRowsError as Qt, TDbActionTargetSummary as R, translateQueryTree as Rn, TMetaResponse as Rt, FlatOf$1 as S, AtscriptDbView as Sn, TDerivedColumn as St, NullsPlacement$1 as T, isViewType as Tn, TExistingForeignKey as Tt, TDbDeleteManyOptions as U, TCascadePin as Un, TRelationInfo as Ut, TDbDefaultFn as V, IntegrityStrategy as Vn, TReadLockOptions as Vt, TDbDeleteResult as W, AtscriptDbReadable as Wn, TRowResolveOptions as Wt, TDbInsertIgnoreOptions as X, TRelGuardState as Xn, TTouchManyOptions as Xt, TDbIndexType as Y, ResolvedRelationFilter as Yn, TTableResolver as Yt, TDbInsertIgnoreResult as Z, TRelationFilterJunction as Zn, TTransactionOptions as Zt, DbPatch as _, TIndexDiffOptions as _n, TDbWriteGuard as _t, isJsonValueField as a, UniqueryControls$1 as an, relationStaticFilter as ar, TDbObjectKind as at, FieldOpsFor as b, TAdapterFactory as bn, TDeleteOptions as bt, resolveCalendarBuckets as c, isGeoIndexableType as cn, DocumentFieldMapper as cr, TDbRelation as ct, AggregateFn$1 as d, soleUnionMember as dn, NoopLogger as dr, TDbStorageType as dt, TViewJsonType as en, andFilters as er, TDbInsertManyResult as et, AggregateQuery$1 as f, ALL_BUCKET_UNITS as fn, TGenericLogger as fr, TDbUpdateOptions as ft, DbControls as g, TForeignKeyDiffOptions as gn, UniquSelect as gr, TDbWriteCheckContext as gt, AtscriptDbWritable as h, BaseDbAdapter as hn, TRowOrderKey as hr, TDbWriteCheck as ht, isBucketableField as i, Uniquery$1 as in, isResolvedRelationFilter as ir, TDbLockWait as it, TColumnDiff as j, AtscriptQueryFieldRef$1 as jn, TIdDescriptor as jt, TCascadeResolver as k, AtscriptOrderItem as kn, TFkLookupTarget as kt, AggregateControls as l, isGeoPointType as ln, FieldMappingStrategy as lr, TDbRemoveGuard as lt, AtscriptDbTableLike as m, ALL_VIEW_CAPABILITIES as mn, TFirstLast as mr, TDbWriteAction as mt, TComputedSelect as n, TWriteTableResolver as nn, forEachResolvedRelation as nr, TDbIsolationLevel as nt, jsonValueAncestor as o, WithRelation$1 as on, DbEncryption as or, TDbReadLock as ot, AggregateResult as p, ALL_ISOLATION_LEVELS as pn, TExprAggregate as pr, TDbUpdateResult as pt, TDbIndex as q, REL_FILTER_MAX_DEPTH as qn, TSyncIndexesOptions as qt, TResolvedBucket as r, TypedWithRelation as rn, hasRelationOp as rr, TDbLockMode as rt, normalizeComputedSelect as s, TableMetadata as sn, TDbEncryptionOptions as sr, TDbReferentialAction as st, TBucketFieldSource as t, TWriteOptions as tn, containsRelationFilter as tr, TDbInsertResult as tt, AggregateExpr$1 as u, TPathPresence as un, TReadControls as ur, TDbRemoveGuardContext as ut, DbQuery as v, TViewCapability as vn, TDbWriteGuardContext as vt, NullableOptional as w, isAtscriptDbView as wn, TExistingColumn as wt, FilterExpr$1 as x, TDbSpaceOptions as xn, TDerivedChangeReason as xt, DbRow as y, DbSpace as yn, TDbWriteLimit as yt, TDbAvailableActions as z, AtscriptDbTable as zn, TMetadataOverrides as zt };

package/dist/{buckets-CHyspjYP.d.mts → buckets-CHUgky8T.d.mts}

@@ -1,4 +1,4 @@
-import { r as DbError } from "./db-error-B_DRL1E9.mjs";
+import { r as DbError } from "./db-error-DQUw2cED.mjs";
 import { f as TFieldOps } from "./ops-AqhV7s9o.mjs";
 import { AtscriptExprNode, AtscriptExprNode as AtscriptExprNode$1, AtscriptOrderItem, AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, FlatOf as FlatOf$1, NavPropsOf, NavPropsOf as NavPropsOf$1, OwnPropsOf, OwnPropsOf as OwnPropsOf$1, PrimaryKeyOf, PrimaryKeyOf as PrimaryKeyOf$1, TAtscriptAnnotatedType, TAtscriptDataType, TAtscriptTypeObject, TMetadataMap, TSerializedAnnotatedType, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
 import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateFn as AggregateFn$1, AggregateQuery, AggregateQuery as AggregateQuery$1, AggregateResult, BucketUnit, FieldOpsFor, FilterExpr, FilterExpr as FilterExpr$1, NullsPlacement, NullsPlacement as NullsPlacement$1, RelationOp, ResolvedBucket, ResolvedRowOrderKey, ResolvedSelectExpr, TypedWithRelation, Uniquery, Uniquery as Uniquery$1, UniqueryControls, UniqueryControls as UniqueryControls$1, UniqueryInsights, WithRelation, WithRelation as WithRelation$1 } from "@uniqu/core";
@@ -568,16 +568,17 @@ declare function relationStaticFilter(relation: TDbRelation, name?: string): TRe
 //#endregion
 //#region src/table/db-readable.d.ts
 /**
- * Extracts nav prop names from a query's `$with` array.
+ * Extracts nav prop names from a query's `$with` array — mutable or readonly
+ * (`as const`, since 0.1.165), object entries or the string shorthand.
  * Returns `never` when `$with` is absent → all nav props stripped from response.
  */
 type ExtractWith<Q> = Q extends {
   controls: {
-    $with: Array<{
-      name: infer N extends string;
-    }>;
+    $with: ReadonlyArray<infer E>;
   };
-} ? N : never;
+} ? E extends {
+  name: infer N extends string;
+} ? N : E extends string ? E : never : never;
 /**
  * Computes the response type for a query:
  * - Strips all nav props from the base DataType
@@ -770,6 +771,17 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    */
   get onUpdateIncPhysical(): readonly string[];
   private _onUpdateIncPhysical?;
+  /**
+   * Physical column names of the insert-only fields (`number.timestamp.created`,
+   * since 0.1.165): a full replace keeps their stored values. Empty when
+   * there are none.
+   *
+   * @internal Adapter-facing surface; not part of the consumer API.
+   */
+  get insertOnlyPhysical(): readonly string[];
+  private _insertOnlyPhysical?;
+  /** The physical columns of a set of top-level logical fields. */
+  private _physicalNames;
   /**
    * Logical paths of the `@db.column.version.exempt` fields, including objects
    * whose direct children are all exempt. A patch that writes only these (and
@@ -1327,6 +1339,14 @@ declare class NativeIntegrity extends IntegrityStrategy {
 }
 //#endregion
 //#region src/table/db-table.d.ts
+/**
+ * The filter of `updateMany` / `replaceMany` / `deleteMany` (since 0.1.165):
+ * the flat field paths with the nav keys taking relational predicates
+ * (`$some` / `$none`), as in the read filter. Before, a nav key was typed as
+ * the flat type's empty value, so a predicate failed to typecheck. A table
+ * without nav props keeps the plain flat filter.
+ */
+type MutationFilter<FlatType, NavType extends Record<string, unknown>> = string extends keyof NavType ? FilterExpr<FlatType> : FilterExpr<Omit<FlatType, keyof NavType>, NavType>;
 declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>, FlatType = NullableOptional<FlatOf<T>>, A extends BaseDbAdapter = BaseDbAdapter, IdType = PrimaryKeyOf<T>, OwnProps = NullableOptional<OwnPropsOf<T>>, NavType extends Record<string, unknown> = NavPropsOf<T>> extends AtscriptDbReadable<T, DataType, FlatType, A, IdType, OwnProps, NavType> {
   protected _cascadeResolver?: TCascadeResolver;
   protected _fkLookupResolver?: TFkLookupResolver;
@@ -1352,14 +1372,67 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * Adapters may define additional purposes.
    */
   getValidator(purpose: string): Validator<T, DataType>;
+  /**
+   * A standard purpose's validator called WITHOUT a context validates in that
+   * purpose's write mode (since 0.1.165): `getValidator("insert").validate(row, true)`
+   * accepts what an insert accepts — omitted primary key, defaulted, FK and
+   * navigation fields. Before, the db plugin saw no mode and ran inert while
+   * navigation fields were forced required. An explicit context still wins.
+   */
+  private _withDefaultContext;
+  /** A fresh validation context of a write `mode` — the one its write paths build. */
+  private _validationCtx;
+  /** {@link normalizeWriteErrors} for this table: its constraint errors normalized against its metadata. */
+  private _normalizeWrite;
+  /**
+   * Validates rows exactly as a write in `mode` would, without writing
+   * (since 0.1.165): each row is cloned, given the defaults / stamps that
+   * write applies, and validated with that write's validator and context.
+   * Returns one `{ index, path, message }` per problem — `[]` when every row
+   * is valid; the caller's rows are not modified.
+   *
+   * `fk: true` also checks that every foreign key names an existing row
+   * (by lookup, on every adapter — native-FK adapters otherwise leave that to
+   * the engine at write time); a missing target is reported on each of the
+   * key's fields. Rows that fail type validation are not looked up.
+   *
+   * @param mode - `'insert'` (default), `'replace'` or `'patch'`.
+   */
+  validateRows(rows: ReadonlyArray<Record<string, unknown>>, mode?: "insert" | "replace" | "patch", opts?: {
+    fk?: boolean;
+  }): Promise<TValidateRowsError[]>;
+  /**
+   * {@link validateRows}' FK lookup: one entry per FK field of each row naming
+   * a missing target. Distinct key tuples are looked up in chunks of
+   * {@link FK_LOOKUP_CHUNK} — reading the target keys that exist (`$in` for a
+   * single-column key, `$or` for a composite one) and diffing in memory, so a
+   * batch never exceeds a bind-parameter limit and a miss costs no extra
+   * query. A lookup target without `find` (a custom resolver) is counted per
+   * chunk, and per tuple only in a chunk that comes up short.
+   */
+  private _missingForeignKeys;
+  /** How {@link _missingForeignKeys} reads an FK's target table, if it can. */
+  private _fkTargetReader;
   /**
    * Inserts a single record. Delegates to {@link insertMany} for unified
    * nested creation support.
    */
-  insertOne(payload: DbPatch<DataType>, opts: TInsertOptions<DataType> & {
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
+    onConflict: "ignore";
+    returning: true | readonly (keyof DataType & string)[];
+  }): Promise<TDbInsertIgnoreResult & {
+    row?: DataType;
+  }>;
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
     onConflict: "ignore";
   }): Promise<TDbInsertIgnoreResult>;
-  insertOne(payload: DbPatch<DataType>, opts?: TInsertOptions<DataType>): Promise<TDbInsertResult>;
+  insertOne(payload: DbPatch<DataType>, opts: TInsertOneOptions<DataType> & {
+    returning: true | readonly (keyof DataType & string)[];
+  }): Promise<TDbInsertResult & {
+    row: DataType;
+  }>;
+  insertOne(payload: DbPatch<DataType>, opts?: TInsertOneOptions<DataType>): Promise<TDbInsertResult>;
+  private _insertOneRow;
   /**
    * Inserts multiple records with batch-optimized nested creation.
    *
@@ -1480,14 +1553,14 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * always breaks ties). Loop until `matchedCount === 0` to process every
    * match in batches. Not exposed over HTTP.
    */
-  updateMany(filter: FilterExpr<FlatType>, data: DbPatch<DataType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbUpdateResult>;
+  updateMany(filter: MutationFilter<FlatType, NavType>, data: DbPatch<DataType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbUpdateResult>;
   /**
    * Replaces the own fields of every row matching `filter` with `data`. The
    * payload is validated in `replace` mode (since 0.1.162) — every required
    * field must be present — except the primary key, which the filter
    * replaces as a row picker.
    */
-  replaceMany(filter: FilterExpr<FlatType>, data: DbRow<DataType>): Promise<TDbUpdateResult>;
+  replaceMany(filter: MutationFilter<FlatType, NavType>, data: DbRow<DataType>): Promise<TDbUpdateResult>;
   /**
    * Deletes every row matching `filter` (application-level cascades run first
    * where the adapter has no native foreign keys).
@@ -1499,7 +1572,7 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * `limit`: a concurrent writer can make one round delete fewer rows while
    * matches remain. Not exposed over HTTP.
    */
-  deleteMany(filter: FilterExpr<FlatType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbDeleteResult>;
+  deleteMany(filter: MutationFilter<FlatType, NavType>, opts?: TBulkWriteOptions<FlatType>): Promise<TDbDeleteResult>;
   /**
    * Runs a bounded write. `native` (default: `supportsWriteLimit()`) hands
    * `write` the physical filter and the bound; otherwise the primary keys of
@@ -1749,6 +1822,8 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * Used by parent tables to validate FROM children before the main insert,
    * ensuring errors are caught before the parent is committed.
    *
+   * @internal Nested-write plumbing — its FK step is a no-op on native-FK
+   * adapters. To validate rows yourself, use {@link validateRows}.
    * @param opts.excludeFkTargetTable - Skip FK validation to this table (the parent).
    */
   preValidateItems(items: Array<Record<string, unknown>>, opts?: {
@@ -3371,6 +3446,12 @@ declare abstract class BaseDbAdapter {
 }
 //#endregion
 //#region src/shared/union-shape.d.ts
+/**
+ * The one value member of a union (`T | null` → `T`), or `undefined` when
+ * `type` is no union or has several value members. A column of a nullable
+ * union is the column `T` alone would get (its type tags, size, precision).
+ */
+declare function soleUnionMember(type: TAtscriptAnnotatedType): TAtscriptAnnotatedType | undefined;
 /**
  * Whether a value at a path is always there (`"required"`), may be NULL /
  * missing (`"nullable"` — the path or an ancestor object is optional or a
@@ -3438,6 +3519,12 @@ declare class TableMetadata {
    * @since 0.1.156
    */
   onUpdateNow: Set<string>;
+  /**
+   * Top-level `number.timestamp.created` fields (since 0.1.165): set by the
+   * insert only — a replace keeps the stored value, a replace or patch
+   * payload's value is dropped.
+   */
+  insertOnly: Set<string>;
   /**
    * Top-level fields annotated with `@db.onUpdate.inc`: `0` on insert, `+1` in
    * the same statement on every update and replace.
@@ -3797,8 +3884,20 @@ interface TTransactionOptions {
 }
 /** Describes an available search index exposed by a database adapter. */
 interface TSearchIndexInfo {
-  /** Index name. Empty string or 'DEFAULT' for the default index. */
+  /**
+   * Index name — the name declared in the model (`@db.index.fulltext 'name'`).
+   * An index with no declared name (a MongoDB dynamic Atlas mapping) is
+   * `'DEFAULT'`.
+   */
   name: string;
+  /**
+   * Other names that resolve to the same index (`$index` / `search(…, name)`),
+   * kept for compatibility: the internal key (`atscript__fulltext__<name>`) on
+   * PostgreSQL and MySQL, and `'DEFAULT'` for MongoDB's default text index.
+   * Deprecated — address an index by {@link name}.
+   * @since 0.1.165
+   */
+  aliases?: string[];
   /** Human-readable label for UI display. */
   description?: string;
   /** Index type: text search or vector similarity search. */
@@ -4285,6 +4384,15 @@ interface TDbIndexField {
    */
   integer?: boolean;
 }
+/**
+ * One problem {@link AtscriptDbTable.validateRows} found: the row's position
+ * in the input, the field path and the message (since 0.1.165).
+ */
+interface TValidateRowsError {
+  index: number;
+  path: string;
+  message: string;
+}
 interface TDbIndex {
   /** Unique key used for identity/diffing (e.g., "atscript__plain__email") */
   key: string;
@@ -4356,6 +4464,12 @@ interface TDbFieldMeta {
   ignored: boolean;
   /** Default value from @db.default.* */
   defaultValue?: TDbDefaultValue;
+  /**
+   * Set by the insert only — a top-level `number.timestamp.created` (since
+   * 0.1.165). A replace keeps the stored value: SQL adapters leave the
+   * column out of the replace's assignment, document adapters carry it over.
+   */
+  insertOnly?: boolean;
   /**
    * How this field is stored in the database.
    * - 'column': a standard scalar column (default for primitives)
@@ -4797,6 +4911,12 @@ type TCascadeResolver = (tableName: string) => TCascadeTarget[];
  */
 interface TFkLookupTarget {
   count(filter: Record<string, unknown>): Promise<number>;
+  /**
+   * The rows matching `filter`, projected to `fields` (since 0.1.165) — lets
+   * `validateRows({ fk: true })` diff existing keys in memory. Optional: a
+   * target without it is counted instead.
+   */
+  find?(filter: Record<string, unknown>, fields: readonly string[]): Promise<Array<Record<string, unknown>>>;
 }
 /**
  * Callback that resolves a table name to a queryable target for FK validation.
@@ -4980,6 +5100,16 @@ interface TInsertOptions<Row = Record<string, unknown>> extends TWriteOptions<Ro
    */
   lockConflicts?: boolean;
 }
+/**
+ * Options of `insertOne` (since 0.1.165): {@link TInsertOptions} plus
+ * `returning` — read the stored row back by its primary key in the insert's
+ * transaction (`true`: every field, server defaults and stamps included; a
+ * field list: those fields) and answer it as `row`. A row skipped by
+ * `onConflict: 'ignore'` answers no `row`.
+ */
+interface TInsertOneOptions<Row = Record<string, unknown>> extends TInsertOptions<Row> {
+  returning?: true | readonly (keyof Row & string)[];
+}
 /**
  * Context handed to a write {@link TWriteOptions.check} (since 0.1.143) — and
  * through it to `AsDbController.checkWrite()`. Lets a permission layer verify
@@ -5156,4 +5286,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbInsertManyIgnoreResult as $, hasRelationOp as $n, TWriteOptions as $t, TCascadeTarget as A, AtscriptRef as An, TForeignKeyChange as At, TDbCollation as B, AtscriptDbReadable as Bn, TReadLockOptions as Bt, NavPropsOf$1 as C, TViewReadPlan as Cn, TEnsureTableOptions as Ct, PrimaryKeyOf$1 as D, AtscriptQueryComparison as Dn, TFieldMeta as Dt, OwnPropsOf$1 as E, AtscriptOrderItem as En, TExistingTableOption as Et, TDbActionIntent as F, translateQueryTree as Fn, TInsertOptions as Ft, TDbFieldMeta as G, ResolvedRelationFilter as Gn, TSyncColumnResult as Gt, TDbDefaultValue as H, resolveDesignType as Hn, TRelationInfo as Ht, TDbActionLevel as I, AtscriptDbTable as In, TJsonCopyTarget as It, TDbIndexField as J, TRelationFilterTable as Jn, TTableResolver as Jt, TDbForeignKey as K, TRelGuardState as Kn, TSyncIndexesOptions as Kt, TDbActionProcessor as L, IntegrityStrategy as Ln, TMetaResponse as Lt, TCrudOp as M, TViewPlan as Mn, TIdResolveOptions as Mt, TCrudPermissions as N, evaluateExpr as Nn, TIdentification as Nt, TBulkWriteOptions as O, AtscriptQueryFieldRef$1 as On, TFkLookupResolver as Ot, TDbActionInfo as P, isFieldRef as Pn, TIndexChange as Pt, TDbInsertIgnoreSlot as Q, forEachResolvedRelation as Qn, TViewJsonType as Qt, TDbActionTargetSummary as R, NativeIntegrity as Rn, TMetadataOverrides as Rt, FlatOf$1 as S, isViewType as Sn, TDerivedColumn as St, NullsPlacement$1 as T, AtscriptExprNode$1 as Tn, TExistingForeignKey as Tt, TDbDeleteManyOptions as U, REL_FILTER_MAX_DEPTH as Un, TRowResolveOptions as Ut, TDbDefaultFn as V, DbResponse as Vn, TReferencingForeignKey as Vt, TDbDeleteResult as W, REL_FILTER_MAX_NODES as Wn, TSearchIndexInfo as Wt, TDbInsertIgnoreOptions as X, andFilters as Xn, TTransactionOptions as Xt, TDbIndexType as Y, TRelationStaticFilter as Yn, TTouchManyOptions as Yt, TDbInsertIgnoreResult as Z, containsRelationFilter as Zn, TValueFormatterPair as Zt, DbPatch as _, TAdapterFactory as _n, TDbWriteGuard as _t, isJsonValueField as a, TableMetadata as an, FieldMappingStrategy as ar, TDbObjectKind as at, FieldOpsFor as b, TViewColumnMapping as bn, TDeleteOptions as bt, resolveCalendarBuckets as c, TPathPresence as cn, TGenericLogger as cr, TDbRelation as ct, AggregateFn$1 as d, ALL_VIEW_CAPABILITIES as dn, TRowOrderKey as dr, TDbStorageType as dt, TWriteTableResolver as en, isResolvedRelationFilter as er, TDbInsertManyResult as et, AggregateQuery$1 as f, BaseDbAdapter as fn, UniquSelect as fr, TDbUpdateOptions as ft, DbControls as g, DbSpace as gn, TDbWriteCheckContext as gt, AtscriptDbWritable as h, TViewCapability as hn, TDbWriteCheck as ht, isBucketableField as i, WithRelation$1 as in, DocumentFieldMapper as ir, TDbLockWait as it, TColumnDiff as j, TViewJoin as jn, TIdDescriptor as jt, TCascadeResolver as k, AtscriptQueryNode$1 as kn, TFkLookupTarget as kt, AggregateControls as l, ALL_BUCKET_UNITS as ln, TExprAggregate as lr, TDbRemoveGuard as lt, AtscriptDbTableLike as m, TIndexDiffOptions as mn, TDbWriteAction as mt, TComputedSelect as n, Uniquery$1 as nn, DbEncryption as nr, TDbIsolationLevel as nt, jsonValueAncestor as o, isGeoIndexableType as on, TReadControls as or, TDbReadLock as ot, AggregateResult as p, TForeignKeyDiffOptions as pn, TDbUpdateResult as pt, TDbIndex as q, TRelationFilterJunction as qn, TTableOptionDiff as qt, TResolvedBucket as r, UniqueryControls$1 as rn, TDbEncryptionOptions as rr, TDbLockMode as rt, normalizeComputedSelect as s, isGeoPointType as sn, NoopLogger as sr, TDbReferentialAction as st, TBucketFieldSource as t, TypedWithRelation as tn, relationStaticFilter as tr, TDbInsertResult as tt, AggregateExpr$1 as u, ALL_ISOLATION_LEVELS as un, TFirstLast as ur, TDbRemoveGuardContext as ut, DbQuery as v, TDbSpaceOptions as vn, TDbWriteGuardContext as vt, NullableOptional as w, aliasTargetOf as wn, TExistingColumn as wt, FilterExpr$1 as x, isAtscriptDbView as xn, TDerivedChangeReason as xt, DbRow as y, AtscriptDbView as yn, TDbWriteLimit as yt, TDbAvailableActions as z, TCascadePin as zn, TPrimaryKeyChange as zt };
+export { TDbInsertManyIgnoreResult as $, TRelationStaticFilter as $n, TValueFormatterPair as $t, TCascadeTarget as A, AtscriptQueryComparison as An, TForeignKeyChange as At, TDbCollation as B, MutationFilter as Bn, TPrimaryKeyChange as Bt, NavPropsOf$1 as C, TViewColumnMapping as Cn, TEnsureTableOptions as Ct, PrimaryKeyOf$1 as D, aliasTargetOf as Dn, TFieldMeta as Dt, OwnPropsOf$1 as E, TViewReadPlan as En, TExistingTableOption as Et, TDbActionIntent as F, TViewPlan as Fn, TInsertOneOptions as Ft, TDbFieldMeta as G, DbResponse as Gn, TSearchIndexInfo as Gt, TDbDefaultValue as H, NativeIntegrity as Hn, TReferencingForeignKey as Ht, TDbActionLevel as I, evaluateExpr as In, TInsertOptions as It, TDbIndexField as J, REL_FILTER_MAX_NODES as Jn, TTableOptionDiff as Jt, TDbForeignKey as K, resolveDesignType as Kn, TSyncColumnResult as Kt, TDbActionProcessor as L, isFieldRef as Ln, TJsonCopyTarget as Lt, TCrudOp as M, AtscriptQueryNode$1 as Mn, TIdResolveOptions as Mt, TCrudPermissions as N, AtscriptRef as Nn, TIdentification as Nt, TBulkWriteOptions as O, AtscriptExprNode$1 as On, TFkLookupResolver as Ot, TDbActionInfo as P, TViewJoin as Pn, TIndexChange as Pt, TDbInsertIgnoreSlot as Q, TRelationFilterTable as Qn, TValidateRowsError as Qt, TDbActionTargetSummary as R, translateQueryTree as Rn, TMetaResponse as Rt, FlatOf$1 as S, AtscriptDbView as Sn, TDerivedColumn as St, NullsPlacement$1 as T, isViewType as Tn, TExistingForeignKey as Tt, TDbDeleteManyOptions as U, TCascadePin as Un, TRelationInfo as Ut, TDbDefaultFn as V, IntegrityStrategy as Vn, TReadLockOptions as Vt, TDbDeleteResult as W, AtscriptDbReadable as Wn, TRowResolveOptions as Wt, TDbInsertIgnoreOptions as X, TRelGuardState as Xn, TTouchManyOptions as Xt, TDbIndexType as Y, ResolvedRelationFilter as Yn, TTableResolver as Yt, TDbInsertIgnoreResult as Z, TRelationFilterJunction as Zn, TTransactionOptions as Zt, DbPatch as _, TIndexDiffOptions as _n, TDbWriteGuard as _t, isJsonValueField as a, UniqueryControls$1 as an, relationStaticFilter as ar, TDbObjectKind as at, FieldOpsFor as b, TAdapterFactory as bn, TDeleteOptions as bt, resolveCalendarBuckets as c, isGeoIndexableType as cn, DocumentFieldMapper as cr, TDbRelation as ct, AggregateFn$1 as d, soleUnionMember as dn, NoopLogger as dr, TDbStorageType as dt, TViewJsonType as en, andFilters as er, TDbInsertManyResult as et, AggregateQuery$1 as f, ALL_BUCKET_UNITS as fn, TGenericLogger as fr, TDbUpdateOptions as ft, DbControls as g, TForeignKeyDiffOptions as gn, UniquSelect as gr, TDbWriteCheckContext as gt, AtscriptDbWritable as h, BaseDbAdapter as hn, TRowOrderKey as hr, TDbWriteCheck as ht, isBucketableField as i, Uniquery$1 as in, isResolvedRelationFilter as ir, TDbLockWait as it, TColumnDiff as j, AtscriptQueryFieldRef$1 as jn, TIdDescriptor as jt, TCascadeResolver as k, AtscriptOrderItem as kn, TFkLookupTarget as kt, AggregateControls as l, isGeoPointType as ln, FieldMappingStrategy as lr, TDbRemoveGuard as lt, AtscriptDbTableLike as m, ALL_VIEW_CAPABILITIES as mn, TFirstLast as mr, TDbWriteAction as mt, TComputedSelect as n, TWriteTableResolver as nn, forEachResolvedRelation as nr, TDbIsolationLevel as nt, jsonValueAncestor as o, WithRelation$1 as on, DbEncryption as or, TDbReadLock as ot, AggregateResult as p, ALL_ISOLATION_LEVELS as pn, TExprAggregate as pr, TDbUpdateResult as pt, TDbIndex as q, REL_FILTER_MAX_DEPTH as qn, TSyncIndexesOptions as qt, TResolvedBucket as r, TypedWithRelation as rn, hasRelationOp as rr, TDbLockMode as rt, normalizeComputedSelect as s, TableMetadata as sn, TDbEncryptionOptions as sr, TDbReferentialAction as st, TBucketFieldSource as t, TWriteOptions as tn, containsRelationFilter as tr, TDbInsertResult as tt, AggregateExpr$1 as u, TPathPresence as un, TReadControls as ur, TDbRemoveGuardContext as ut, DbQuery as v, TViewCapability as vn, TDbWriteGuardContext as vt, NullableOptional as w, isAtscriptDbView as wn, TExistingColumn as wt, FilterExpr$1 as x, TDbSpaceOptions as xn, TDerivedChangeReason as xt, DbRow as y, DbSpace as yn, TDbWriteLimit as yt, TDbAvailableActions as z, AtscriptDbTable as zn, TMetadataOverrides as zt };