@atscript/db 0.1.57 → 0.1.59

package/dist/{db-readable-BCoBlULR.d.cts → db-readable-CKQHMqVH.d.cts}

@@ -1,6 +1,6 @@
 import { u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
 import { AggregateControls, AggregateExpr, AggregateExpr as AggregateExpr$1, AggregateFn, AggregateQuery, AggregateQuery as AggregateQuery$1, AggregateResult, FieldOpsFor, FilterExpr, FilterExpr as FilterExpr$1, TypedWithRelation, Uniquery, Uniquery as Uniquery$1, UniqueryControls, UniqueryControls as UniqueryControls$1, UniqueryInsights, WithRelation, WithRelation as WithRelation$1 } from "@uniqu/core";
-import { FlatOf, NavPropsOf, NavPropsOf as NavPropsOf$1, OwnPropsOf, OwnPropsOf as OwnPropsOf$1, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, TAtscriptTypeObject, TMetadataMap, TSerializedAnnotatedType, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
+import { 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";
 
 //#region src/query/uniqu-select.d.ts
 /**
@@ -71,6 +71,7 @@ declare class TableMetadata {
   flatMap: Map<string, TAtscriptAnnotatedType>;
   fieldDescriptors: readonly TDbFieldMeta[];
   primaryKeys: string[];
+  preferredId: string[];
   originalMetaIdFields: string[];
   indexes: Map<string, TDbIndex>;
   foreignKeys: Map<string, TDbForeignKey>;
@@ -102,6 +103,7 @@ declare class TableMetadata {
   /** Leaf field descriptors indexed by logical path (write/patch/filter paths). */
   leafByLogical: Map<string, TDbFieldMeta>;
   private _built;
+  private _identifications?;
   private _collateMap;
   private _columnFromMap;
   constructor(nestedObjects: boolean);
@@ -156,6 +158,16 @@ declare class TableMetadata {
    */
   private _resolveFkTargetFields;
   private _finalizeIndexes;
+  /**
+   * Captures legitimate row-identifier shapes from the metadata: primary key
+   * (when present) followed by every unique index. Must run BEFORE
+   * `_finalizeIndexes` rewrites `index.fields[i].name` from logical to
+   * physical, so the field lists stay logical.
+   */
+  private _buildIdentifications;
+  /** Legitimate row-identifier shapes — primary key first, then each unique index. */
+  getIdentifications(): readonly TIdentification[];
+  private _resolvePreferredId;
 }
 //#endregion
 //#region src/types.d.ts
@@ -205,6 +217,7 @@ interface TMetaResponse {
   vectorSearchable: boolean;
   searchIndexes: TSearchIndexInfo[];
   primaryKeys: string[];
+  preferredId: string[];
   relations: TRelationInfo[];
   fields: Record<string, TFieldMeta>;
   type: TSerializedAnnotatedType;
@@ -213,8 +226,16 @@ interface TMetaResponse {
 }
 /** Where the action applies on the UI. */
 type TDbActionLevel = "table" | "row" | "rows";
-/** Semantic intent the UI maps to its own visual language (color, prominence). */
-type TDbActionIntent = "positive" | "negative" | "primary" | "secondary";
+/**
+ * Semantic intent the UI maps to its own visual language (color, prominence).
+ *
+ * Suggested visual prominence (most → least): `negative` > `warning` > `primary`
+ * > `positive` > `secondary`. Use `negative` for destructive ops (delete, purge),
+ * `warning` for risky-but-non-destructive ops (retry payment, force recompute,
+ * reset state), `primary` for the headline action, `positive` for benign
+ * confirmations (approve, publish), `secondary` for everything else.
+ */
+type TDbActionIntent = "positive" | "negative" | "warning" | "primary" | "secondary";
 /** How the UI client should handle the action when invoked. */
 type TDbActionProcessor = "backend" | "navigate" | "custom";
 /**
@@ -236,7 +257,35 @@ interface TDbActionInfo {
   description?: string;
   order?: number;
   default?: boolean;
-  promptText?: string;
+  /**
+   * Confirmation prompt copy. String form is shown verbatim. Tuple form is
+   * `[singular, plural]`: the UI picks `[0]` when the action will execute
+   * against a single PK (always for `'row'`-level; for `'rows'`-level when the
+   * current selection has exactly one PK) and `[1]` otherwise.
+   *
+   * Placeholder substitution is UI-resolved, not server-parsed. Conventional
+   * placeholders: `$1` for the single PK (singular form) and `$N` for the
+   * count (plural form), e.g. `['Delete order $1?', 'Delete $N orders?']`.
+   */
+  promptText?: string | [string, string];
+  /**
+   * Single-character keyboard shortcut hint. The server stores this verbatim
+   * — choice of modifier prefix (Alt+, Ctrl+, bare key) and activation scope
+   * (e.g. only when an actions dropdown is open) are UI/UX concerns. Conflict
+   * resolution between actions sharing the same key is also up to the UI;
+   * the server does no dedup.
+   */
+  shortcut?: string;
+  /**
+   * Stringified gate predicate (`fn.toString()`). Present only for `'row'`
+   * and `'rows'` level actions whose decorator declared a `disabled` function.
+   * The function is the batch shape `(rows: TRow[]) => boolean[]` (sync). The
+   * UI evaluates against a level-specific scope to grey-out / hide the
+   * button. The server has already enforced this predicate before the
+   * action's handler ran — the server is authoritative; this field is purely
+   * a UI hint.
+   */
+  disabled?: string;
 }
 interface TDbInsertResult {
   insertedId: unknown;
@@ -284,6 +333,13 @@ interface TIdDescriptor {
   /** Whether this is a composite key (multiple fields). */
   isComposite: boolean;
 }
+/** A legitimate row-identifier shape: primary key or a unique index. */
+interface TIdentification {
+  /** Logical (path) field names that form this identifier. */
+  fields: readonly string[];
+  /** `'primaryKey'` for the PK; the unique-index name otherwise. */
+  source: string;
+}
 type TDbStorageType = "column" | "flattened" | "json";
 interface TDbFieldMeta {
   /** The dot-notation path to this field (logical name). */
@@ -433,12 +489,13 @@ interface TMetadataOverrides {
  *
  * Typically provided by the driver/registry (e.g. `DbSpace.getTable`).
  */
-type TTableResolver = (type: TAtscriptAnnotatedType) => Pick<AtscriptDbTableLike, "findMany" | "loadRelations" | "primaryKeys" | "relations" | "foreignKeys"> | undefined;
+type TTableResolver = (type: TAtscriptAnnotatedType) => Pick<AtscriptDbTableLike, "findMany" | "loadRelations" | "primaryKeys" | "preferredId" | "relations" | "foreignKeys"> | undefined;
 /** Minimal table interface used by the table resolver. Avoids circular dependency with AtscriptDbTable. */
 interface AtscriptDbTableLike {
   findMany(query: unknown): Promise<Array<Record<string, unknown>>>;
   loadRelations(rows: Array<Record<string, unknown>>, withRelations: WithRelation[]): Promise<void>;
   primaryKeys: readonly string[];
+  preferredId: readonly string[];
   relations: ReadonlyMap<string, TDbRelation>;
   foreignKeys: ReadonlyMap<string, TDbForeignKey>;
   getMetadata(): TableMetadata;
@@ -553,12 +610,6 @@ interface TDbRelation {
  */
 declare abstract class BaseDbAdapter {
   protected _table: AtscriptDbReadable<any, any, any, any, any, any, any>;
-  private _metaIdPhysical;
-  /**
-   * Returns the physical column name of the single @meta.id field (if any).
-   * Used to return the user's logical ID instead of the DB-generated ID on insert.
-   */
-  protected _getMetaIdPhysical(): string | null;
   /**
    * Resolves the correct insertedId: prefers the user-supplied PK value
    * from the data over the DB-generated fallback (e.g. rowid, _id).
@@ -1141,6 +1192,7 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   /** Strategy for mapping between logical field shapes and physical storage. */
   protected readonly _fieldMapper: FieldMappingStrategy;
   protected _writeTableResolver?: TWriteTableResolver;
+  private _metaIdPhysical;
   constructor(_type: T, adapter: A, logger?: TGenericLogger, _tableResolver?: TTableResolver | undefined);
   /** Ensures metadata is built. Called before any metadata access. */
   protected _ensureBuilt(): void;
@@ -1163,8 +1215,18 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   get indexes(): Map<string, TDbIndex>;
   /** Primary key field names from `@meta.id`. */
   get primaryKeys(): readonly string[];
-  /** Original `@meta.id` field names as declared in the schema (before adapter manipulation). */
-  get originalMetaIdFields(): readonly string[];
+  /** Preferred row identifier field names. Defaults to primary keys. */
+  get preferredId(): readonly string[];
+  /** Legitimate row-identifier shapes (primary key + every unique index). */
+  get identifications(): readonly TIdentification[];
+  /**
+   * Physical column name of the single `@meta.id` field, or `null` when the
+   * schema has zero or multiple `@meta.id` fields. Used by adapters to return
+   * the user's logical ID instead of the DB-generated one on insert.
+   *
+   * @internal Adapter-facing surface; not part of the consumer API.
+   */
+  get metaIdPhysical(): string | null;
   /** Dimension fields from `@db.column.dimension`. */
   get dimensions(): readonly string[];
   /** Measure fields from `@db.column.measure`. */
@@ -1324,4 +1386,4 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   }, thisTableName: string, alias?: string): TDbForeignKey | undefined;
 }
 //#endregion
-export { TSyncColumnResult as $, TDbDefaultValue as A, TDbRelation as B, TCrudPermissions as C, TDbActionProcessor as D, TDbActionLevel as E, TDbIndexField as F, TFieldMeta as G, TDbUpdateResult as H, TDbIndexType as I, TIdDescriptor as J, TFkLookupResolver as K, TDbInsertManyResult as L, TDbFieldMeta as M, TDbForeignKey as N, TDbCollation as O, TDbIndex as P, TSearchIndexInfo as Q, TDbInsertResult as R, TCrudOp as S, TDbActionIntent as T, TExistingColumn as U, TDbStorageType as V, TExistingTableOption as W, TMetadataOverrides as X, TMetaResponse as Y, TRelationInfo as Z, NavPropsOf$1 as _, FieldMappingStrategy as a, Uniquery$1 as at, TCascadeTarget as b, AggregateExpr$1 as c, TableMetadata as ct, AggregateResult as d, UniquSelect as dt, TTableOptionDiff as et, AtscriptDbWritable as f, FilterExpr$1 as g, FieldOpsFor as h, DocumentFieldMapper as i, TypedWithRelation as it, TDbDeleteResult as j, TDbDefaultFn as k, AggregateFn as l, NoopLogger as lt, DbQuery as m, DbResponse as n, TValueFormatterPair as nt, BaseDbAdapter as o, UniqueryControls$1 as ot, DbControls as p, TFkLookupTarget as q, resolveDesignType as r, TWriteTableResolver as rt, AggregateControls as s, WithRelation$1 as st, AtscriptDbReadable as t, TTableResolver as tt, AggregateQuery$1 as u, TGenericLogger as ut, OwnPropsOf$1 as v, TDbActionInfo as w, TColumnDiff as x, TCascadeResolver as y, TDbReferentialAction as z };
+export { TMetadataOverrides as $, TDbCollation as A, TDbInsertResult as B, TColumnDiff as C, TDbActionIntent as D, TDbActionInfo as E, TDbForeignKey as F, TExistingColumn as G, TDbRelation as H, TDbIndex as I, TFkLookupResolver as J, TExistingTableOption as K, TDbIndexField as L, TDbDefaultValue as M, TDbDeleteResult as N, TDbActionLevel as O, TDbFieldMeta as P, TMetaResponse as Q, TDbIndexType as R, TCascadeTarget as S, TCrudPermissions as T, TDbStorageType as U, TDbReferentialAction as V, TDbUpdateResult as W, TIdDescriptor as X, TFkLookupTarget as Y, TIdentification as Z, FlatOf$1 as _, FieldMappingStrategy as a, TValueFormatterPair as at, PrimaryKeyOf$1 as b, AggregateExpr$1 as c, Uniquery$1 as ct, AggregateResult as d, TableMetadata as dt, TRelationInfo as et, AtscriptDbWritable as f, NoopLogger as ft, FilterExpr$1 as g, FieldOpsFor as h, DocumentFieldMapper as i, TTableResolver as it, TDbDefaultFn as j, TDbActionProcessor as k, AggregateFn as l, UniqueryControls$1 as lt, DbQuery as m, UniquSelect as mt, DbResponse as n, TSyncColumnResult as nt, BaseDbAdapter as o, TWriteTableResolver as ot, DbControls as p, TGenericLogger as pt, TFieldMeta as q, resolveDesignType as r, TTableOptionDiff as rt, AggregateControls as s, TypedWithRelation as st, AtscriptDbReadable as t, TSearchIndexInfo as tt, AggregateQuery$1 as u, WithRelation$1 as ut, NavPropsOf$1 as v, TCrudOp as w, TCascadeResolver as x, OwnPropsOf$1 as y, TDbInsertManyResult as z };

package/dist/{db-readable-CrNX04nI.d.mts → db-readable-CkeVx10t.d.mts}

@@ -1,5 +1,5 @@
 import { u as TFieldOps } from "./ops-C61kelof.mjs";
-import { FlatOf, NavPropsOf, NavPropsOf as NavPropsOf$1, OwnPropsOf, OwnPropsOf as OwnPropsOf$1, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, TAtscriptTypeObject, TMetadataMap, TSerializedAnnotatedType, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
+import { 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, AggregateQuery, AggregateQuery as AggregateQuery$1, AggregateResult, FieldOpsFor, FilterExpr, FilterExpr as FilterExpr$1, TypedWithRelation, Uniquery, Uniquery as Uniquery$1, UniqueryControls, UniqueryControls as UniqueryControls$1, UniqueryInsights, WithRelation, WithRelation as WithRelation$1 } from "@uniqu/core";
 
 //#region src/query/uniqu-select.d.ts
@@ -71,6 +71,7 @@ declare class TableMetadata {
   flatMap: Map<string, TAtscriptAnnotatedType>;
   fieldDescriptors: readonly TDbFieldMeta[];
   primaryKeys: string[];
+  preferredId: string[];
   originalMetaIdFields: string[];
   indexes: Map<string, TDbIndex>;
   foreignKeys: Map<string, TDbForeignKey>;
@@ -102,6 +103,7 @@ declare class TableMetadata {
   /** Leaf field descriptors indexed by logical path (write/patch/filter paths). */
   leafByLogical: Map<string, TDbFieldMeta>;
   private _built;
+  private _identifications?;
   private _collateMap;
   private _columnFromMap;
   constructor(nestedObjects: boolean);
@@ -156,6 +158,16 @@ declare class TableMetadata {
    */
   private _resolveFkTargetFields;
   private _finalizeIndexes;
+  /**
+   * Captures legitimate row-identifier shapes from the metadata: primary key
+   * (when present) followed by every unique index. Must run BEFORE
+   * `_finalizeIndexes` rewrites `index.fields[i].name` from logical to
+   * physical, so the field lists stay logical.
+   */
+  private _buildIdentifications;
+  /** Legitimate row-identifier shapes — primary key first, then each unique index. */
+  getIdentifications(): readonly TIdentification[];
+  private _resolvePreferredId;
 }
 //#endregion
 //#region src/types.d.ts
@@ -205,6 +217,7 @@ interface TMetaResponse {
   vectorSearchable: boolean;
   searchIndexes: TSearchIndexInfo[];
   primaryKeys: string[];
+  preferredId: string[];
   relations: TRelationInfo[];
   fields: Record<string, TFieldMeta>;
   type: TSerializedAnnotatedType;
@@ -213,8 +226,16 @@ interface TMetaResponse {
 }
 /** Where the action applies on the UI. */
 type TDbActionLevel = "table" | "row" | "rows";
-/** Semantic intent the UI maps to its own visual language (color, prominence). */
-type TDbActionIntent = "positive" | "negative" | "primary" | "secondary";
+/**
+ * Semantic intent the UI maps to its own visual language (color, prominence).
+ *
+ * Suggested visual prominence (most → least): `negative` > `warning` > `primary`
+ * > `positive` > `secondary`. Use `negative` for destructive ops (delete, purge),
+ * `warning` for risky-but-non-destructive ops (retry payment, force recompute,
+ * reset state), `primary` for the headline action, `positive` for benign
+ * confirmations (approve, publish), `secondary` for everything else.
+ */
+type TDbActionIntent = "positive" | "negative" | "warning" | "primary" | "secondary";
 /** How the UI client should handle the action when invoked. */
 type TDbActionProcessor = "backend" | "navigate" | "custom";
 /**
@@ -236,7 +257,35 @@ interface TDbActionInfo {
   description?: string;
   order?: number;
   default?: boolean;
-  promptText?: string;
+  /**
+   * Confirmation prompt copy. String form is shown verbatim. Tuple form is
+   * `[singular, plural]`: the UI picks `[0]` when the action will execute
+   * against a single PK (always for `'row'`-level; for `'rows'`-level when the
+   * current selection has exactly one PK) and `[1]` otherwise.
+   *
+   * Placeholder substitution is UI-resolved, not server-parsed. Conventional
+   * placeholders: `$1` for the single PK (singular form) and `$N` for the
+   * count (plural form), e.g. `['Delete order $1?', 'Delete $N orders?']`.
+   */
+  promptText?: string | [string, string];
+  /**
+   * Single-character keyboard shortcut hint. The server stores this verbatim
+   * — choice of modifier prefix (Alt+, Ctrl+, bare key) and activation scope
+   * (e.g. only when an actions dropdown is open) are UI/UX concerns. Conflict
+   * resolution between actions sharing the same key is also up to the UI;
+   * the server does no dedup.
+   */
+  shortcut?: string;
+  /**
+   * Stringified gate predicate (`fn.toString()`). Present only for `'row'`
+   * and `'rows'` level actions whose decorator declared a `disabled` function.
+   * The function is the batch shape `(rows: TRow[]) => boolean[]` (sync). The
+   * UI evaluates against a level-specific scope to grey-out / hide the
+   * button. The server has already enforced this predicate before the
+   * action's handler ran — the server is authoritative; this field is purely
+   * a UI hint.
+   */
+  disabled?: string;
 }
 interface TDbInsertResult {
   insertedId: unknown;
@@ -284,6 +333,13 @@ interface TIdDescriptor {
   /** Whether this is a composite key (multiple fields). */
   isComposite: boolean;
 }
+/** A legitimate row-identifier shape: primary key or a unique index. */
+interface TIdentification {
+  /** Logical (path) field names that form this identifier. */
+  fields: readonly string[];
+  /** `'primaryKey'` for the PK; the unique-index name otherwise. */
+  source: string;
+}
 type TDbStorageType = "column" | "flattened" | "json";
 interface TDbFieldMeta {
   /** The dot-notation path to this field (logical name). */
@@ -433,12 +489,13 @@ interface TMetadataOverrides {
  *
  * Typically provided by the driver/registry (e.g. `DbSpace.getTable`).
  */
-type TTableResolver = (type: TAtscriptAnnotatedType) => Pick<AtscriptDbTableLike, "findMany" | "loadRelations" | "primaryKeys" | "relations" | "foreignKeys"> | undefined;
+type TTableResolver = (type: TAtscriptAnnotatedType) => Pick<AtscriptDbTableLike, "findMany" | "loadRelations" | "primaryKeys" | "preferredId" | "relations" | "foreignKeys"> | undefined;
 /** Minimal table interface used by the table resolver. Avoids circular dependency with AtscriptDbTable. */
 interface AtscriptDbTableLike {
   findMany(query: unknown): Promise<Array<Record<string, unknown>>>;
   loadRelations(rows: Array<Record<string, unknown>>, withRelations: WithRelation[]): Promise<void>;
   primaryKeys: readonly string[];
+  preferredId: readonly string[];
   relations: ReadonlyMap<string, TDbRelation>;
   foreignKeys: ReadonlyMap<string, TDbForeignKey>;
   getMetadata(): TableMetadata;
@@ -553,12 +610,6 @@ interface TDbRelation {
  */
 declare abstract class BaseDbAdapter {
   protected _table: AtscriptDbReadable<any, any, any, any, any, any, any>;
-  private _metaIdPhysical;
-  /**
-   * Returns the physical column name of the single @meta.id field (if any).
-   * Used to return the user's logical ID instead of the DB-generated ID on insert.
-   */
-  protected _getMetaIdPhysical(): string | null;
   /**
    * Resolves the correct insertedId: prefers the user-supplied PK value
    * from the data over the DB-generated fallback (e.g. rowid, _id).
@@ -1141,6 +1192,7 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   /** Strategy for mapping between logical field shapes and physical storage. */
   protected readonly _fieldMapper: FieldMappingStrategy;
   protected _writeTableResolver?: TWriteTableResolver;
+  private _metaIdPhysical;
   constructor(_type: T, adapter: A, logger?: TGenericLogger, _tableResolver?: TTableResolver | undefined);
   /** Ensures metadata is built. Called before any metadata access. */
   protected _ensureBuilt(): void;
@@ -1163,8 +1215,18 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   get indexes(): Map<string, TDbIndex>;
   /** Primary key field names from `@meta.id`. */
   get primaryKeys(): readonly string[];
-  /** Original `@meta.id` field names as declared in the schema (before adapter manipulation). */
-  get originalMetaIdFields(): readonly string[];
+  /** Preferred row identifier field names. Defaults to primary keys. */
+  get preferredId(): readonly string[];
+  /** Legitimate row-identifier shapes (primary key + every unique index). */
+  get identifications(): readonly TIdentification[];
+  /**
+   * Physical column name of the single `@meta.id` field, or `null` when the
+   * schema has zero or multiple `@meta.id` fields. Used by adapters to return
+   * the user's logical ID instead of the DB-generated one on insert.
+   *
+   * @internal Adapter-facing surface; not part of the consumer API.
+   */
+  get metaIdPhysical(): string | null;
   /** Dimension fields from `@db.column.dimension`. */
   get dimensions(): readonly string[];
   /** Measure fields from `@db.column.measure`. */
@@ -1324,4 +1386,4 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
   }, thisTableName: string, alias?: string): TDbForeignKey | undefined;
 }
 //#endregion
-export { TSyncColumnResult as $, TDbDefaultValue as A, TDbRelation as B, TCrudPermissions as C, TDbActionProcessor as D, TDbActionLevel as E, TDbIndexField as F, TFieldMeta as G, TDbUpdateResult as H, TDbIndexType as I, TIdDescriptor as J, TFkLookupResolver as K, TDbInsertManyResult as L, TDbFieldMeta as M, TDbForeignKey as N, TDbCollation as O, TDbIndex as P, TSearchIndexInfo as Q, TDbInsertResult as R, TCrudOp as S, TDbActionIntent as T, TExistingColumn as U, TDbStorageType as V, TExistingTableOption as W, TMetadataOverrides as X, TMetaResponse as Y, TRelationInfo as Z, NavPropsOf$1 as _, FieldMappingStrategy as a, Uniquery$1 as at, TCascadeTarget as b, AggregateExpr$1 as c, TableMetadata as ct, AggregateResult as d, UniquSelect as dt, TTableOptionDiff as et, AtscriptDbWritable as f, FilterExpr$1 as g, FieldOpsFor as h, DocumentFieldMapper as i, TypedWithRelation as it, TDbDeleteResult as j, TDbDefaultFn as k, AggregateFn as l, NoopLogger as lt, DbQuery as m, DbResponse as n, TValueFormatterPair as nt, BaseDbAdapter as o, UniqueryControls$1 as ot, DbControls as p, TFkLookupTarget as q, resolveDesignType as r, TWriteTableResolver as rt, AggregateControls as s, WithRelation$1 as st, AtscriptDbReadable as t, TTableResolver as tt, AggregateQuery$1 as u, TGenericLogger as ut, OwnPropsOf$1 as v, TDbActionInfo as w, TColumnDiff as x, TCascadeResolver as y, TDbReferentialAction as z };
+export { TMetadataOverrides as $, TDbCollation as A, TDbInsertResult as B, TColumnDiff as C, TDbActionIntent as D, TDbActionInfo as E, TDbForeignKey as F, TExistingColumn as G, TDbRelation as H, TDbIndex as I, TFkLookupResolver as J, TExistingTableOption as K, TDbIndexField as L, TDbDefaultValue as M, TDbDeleteResult as N, TDbActionLevel as O, TDbFieldMeta as P, TMetaResponse as Q, TDbIndexType as R, TCascadeTarget as S, TCrudPermissions as T, TDbStorageType as U, TDbReferentialAction as V, TDbUpdateResult as W, TIdDescriptor as X, TFkLookupTarget as Y, TIdentification as Z, FlatOf$1 as _, FieldMappingStrategy as a, TValueFormatterPair as at, PrimaryKeyOf$1 as b, AggregateExpr$1 as c, Uniquery$1 as ct, AggregateResult as d, TableMetadata as dt, TRelationInfo as et, AtscriptDbWritable as f, NoopLogger as ft, FilterExpr$1 as g, FieldOpsFor as h, DocumentFieldMapper as i, TTableResolver as it, TDbDefaultFn as j, TDbActionProcessor as k, AggregateFn as l, UniqueryControls$1 as lt, DbQuery as m, UniquSelect as mt, DbResponse as n, TSyncColumnResult as nt, BaseDbAdapter as o, TWriteTableResolver as ot, DbControls as p, TGenericLogger as pt, TFieldMeta as q, resolveDesignType as r, TTableOptionDiff as rt, AggregateControls as s, TypedWithRelation as st, AtscriptDbReadable as t, TSearchIndexInfo as tt, AggregateQuery$1 as u, WithRelation$1 as ut, NavPropsOf$1 as v, TCrudOp as w, TCascadeResolver as x, OwnPropsOf$1 as y, TDbInsertManyResult as z };

package/dist/{db-space-BvBklm9J.d.cts → db-space-BAfXlRiV.d.mts}

@@ -1,6 +1,6 @@
-import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-BCoBlULR.cjs";
-import { FilterExpr } from "@uniqu/core";
+import { B as TDbInsertResult, J as TFkLookupResolver, N as TDbDeleteResult, W as TDbUpdateResult, dt as TableMetadata, it as TTableResolver, o as BaseDbAdapter, ot as TWriteTableResolver, pt as TGenericLogger, t as AtscriptDbReadable, x as TCascadeResolver, z as TDbInsertManyResult } from "./db-readable-CkeVx10t.mjs";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { FilterExpr } from "@uniqu/core";
 
 //#region src/strategies/integrity.d.ts
 /**

package/dist/{db-space-CsgCjSMH.d.mts → db-space-Dycn4usM.d.cts}

@@ -1,6 +1,6 @@
-import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-CrNX04nI.mjs";
-import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
+import { B as TDbInsertResult, J as TFkLookupResolver, N as TDbDeleteResult, W as TDbUpdateResult, dt as TableMetadata, it as TTableResolver, o as BaseDbAdapter, ot as TWriteTableResolver, pt as TGenericLogger, t as AtscriptDbReadable, x as TCascadeResolver, z as TDbInsertManyResult } from "./db-readable-CKQHMqVH.cjs";
 import { FilterExpr } from "@uniqu/core";
+import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 
 //#region src/strategies/integrity.d.ts
 /**

package/dist/{db-view-DIGN4079.cjs → db-view-CuPkKCnU.cjs}

@@ -52,6 +52,7 @@ var TableMetadata = class {
 	flatMap;
 	fieldDescriptors;
 	primaryKeys = [];
+	preferredId = [];
 	originalMetaIdFields = [];
 	indexes = /* @__PURE__ */ new Map();
 	foreignKeys = /* @__PURE__ */ new Map();
@@ -83,6 +84,7 @@ var TableMetadata = class {
 	/** Leaf field descriptors indexed by logical path (write/patch/filter paths). */
 	leafByLogical = /* @__PURE__ */ new Map();
 	_built = false;
+	_identifications;
 	_collateMap = /* @__PURE__ */ new Map();
 	_columnFromMap = /* @__PURE__ */ new Map();
 	constructor(nestedObjects) {
@@ -133,6 +135,8 @@ var TableMetadata = class {
 		if (overrides) this._applyOverrides(overrides);
 		this._buildFieldDescriptors(adapter);
 		if (!this.nestedObjects) this._buildLeafIndexes();
+		this._buildIdentifications();
+		this._resolvePreferredId(type);
 		this._finalizeIndexes();
 		this._collateMap.clear();
 		this._columnFromMap.clear();
@@ -440,6 +444,38 @@ var TableMetadata = class {
 		for (const index of this.indexes.values()) if (index.type === "unique" && index.fields.length === 1) this.uniqueProps.add(index.fields[0].name);
 		for (const index of this.indexes.values()) for (const field of index.fields) field.name = this.pathToPhysical.get(field.name) ?? this.columnMap.get(field.name) ?? field.name;
 	}
+	/**
+	* Captures legitimate row-identifier shapes from the metadata: primary key
+	* (when present) followed by every unique index. Must run BEFORE
+	* `_finalizeIndexes` rewrites `index.fields[i].name` from logical to
+	* physical, so the field lists stay logical.
+	*/
+	_buildIdentifications() {
+		const out = [];
+		if (this.primaryKeys.length > 0) out.push({
+			fields: [...this.primaryKeys],
+			source: "primaryKey"
+		});
+		for (const index of this.indexes.values()) if (index.type === "unique") out.push({
+			fields: index.fields.map((field) => field.name),
+			source: index.name
+		});
+		this._identifications = out;
+	}
+	/** Legitimate row-identifier shapes — primary key first, then each unique index. */
+	getIdentifications() {
+		return this._identifications ?? [];
+	}
+	_resolvePreferredId(type) {
+		const preferred = type.metadata.get("db.table.preferredId.uniqueIndex");
+		if (preferred === void 0) {
+			this.preferredId = [...this.primaryKeys];
+			return;
+		}
+		const requestedName = typeof preferred === "string" ? preferred : void 0;
+		const selected = this.getIdentifications().find((id) => id.source !== "primaryKey" && (requestedName === void 0 || id.source === requestedName));
+		this.preferredId = selected ? [...selected.fields] : [...this.primaryKeys];
+	}
 };
 //#endregion
 //#region src/query/uniqu-select.ts
@@ -1073,6 +1109,7 @@ var AtscriptDbReadable = class {
 	/** Strategy for mapping between logical field shapes and physical storage. */
 	_fieldMapper;
 	_writeTableResolver;
+	_metaIdPhysical;
 	constructor(_type, adapter, logger = NoopLogger, _tableResolver) {
 		this._type = _type;
 		this.adapter = adapter;
@@ -1139,10 +1176,33 @@ var AtscriptDbReadable = class {
 		this._ensureBuilt();
 		return this._meta.primaryKeys;
 	}
-	/** Original `@meta.id` field names as declared in the schema (before adapter manipulation). */
-	get originalMetaIdFields() {
+	/** Preferred row identifier field names. Defaults to primary keys. */
+	get preferredId() {
+		this._ensureBuilt();
+		return this._meta.preferredId;
+	}
+	/** Legitimate row-identifier shapes (primary key + every unique index). */
+	get identifications() {
 		this._ensureBuilt();
-		return this._meta.originalMetaIdFields;
+		return this._meta.getIdentifications();
+	}
+	/**
+	* Physical column name of the single `@meta.id` field, or `null` when the
+	* schema has zero or multiple `@meta.id` fields. Used by adapters to return
+	* the user's logical ID instead of the DB-generated one on insert.
+	*
+	* @internal Adapter-facing surface; not part of the consumer API.
+	*/
+	get metaIdPhysical() {
+		this._ensureBuilt();
+		if (this._metaIdPhysical === void 0) {
+			const fields = this._meta.originalMetaIdFields;
+			if (fields.length === 1) {
+				const field = fields[0];
+				this._metaIdPhysical = this._meta.columnMap.get(field) ?? field;
+			} else this._metaIdPhysical = null;
+		}
+		return this._metaIdPhysical;
 	}
 	/** Dimension fields from `@db.column.dimension`. */
 	get dimensions() {
@@ -1593,27 +1653,12 @@ const txStorage = new node_async_hooks.AsyncLocalStorage();
 */
 var BaseDbAdapter = class {
 	_table;
-	_metaIdPhysical;
-	/**
-	* Returns the physical column name of the single @meta.id field (if any).
-	* Used to return the user's logical ID instead of the DB-generated ID on insert.
-	*/
-	_getMetaIdPhysical() {
-		if (this._metaIdPhysical === void 0) {
-			const fields = this._table.originalMetaIdFields;
-			if (fields.length === 1) {
-				const field = fields[0];
-				this._metaIdPhysical = this._table.columnMap.get(field) ?? field;
-			} else this._metaIdPhysical = null;
-		}
-		return this._metaIdPhysical;
-	}
 	/**
 	* Resolves the correct insertedId: prefers the user-supplied PK value
 	* from the data over the DB-generated fallback (e.g. rowid, _id).
 	*/
 	_resolveInsertedId(data, dbGeneratedId) {
-		const metaIdPhysical = this._getMetaIdPhysical();
+		const metaIdPhysical = this._table.metaIdPhysical;
 		return metaIdPhysical ? data[metaIdPhysical] ?? dbGeneratedId : dbGeneratedId;
 	}
 	/** Logger instance — set via {@link registerReadable} from the readable's logger. */

package/dist/{db-view-DNwX6_4x.mjs → db-view-cBN0YqrV.mjs}

@@ -52,6 +52,7 @@ var TableMetadata = class {
 	flatMap;
 	fieldDescriptors;
 	primaryKeys = [];
+	preferredId = [];
 	originalMetaIdFields = [];
 	indexes = /* @__PURE__ */ new Map();
 	foreignKeys = /* @__PURE__ */ new Map();
@@ -83,6 +84,7 @@ var TableMetadata = class {
 	/** Leaf field descriptors indexed by logical path (write/patch/filter paths). */
 	leafByLogical = /* @__PURE__ */ new Map();
 	_built = false;
+	_identifications;
 	_collateMap = /* @__PURE__ */ new Map();
 	_columnFromMap = /* @__PURE__ */ new Map();
 	constructor(nestedObjects) {
@@ -133,6 +135,8 @@ var TableMetadata = class {
 		if (overrides) this._applyOverrides(overrides);
 		this._buildFieldDescriptors(adapter);
 		if (!this.nestedObjects) this._buildLeafIndexes();
+		this._buildIdentifications();
+		this._resolvePreferredId(type);
 		this._finalizeIndexes();
 		this._collateMap.clear();
 		this._columnFromMap.clear();
@@ -440,6 +444,38 @@ var TableMetadata = class {
 		for (const index of this.indexes.values()) if (index.type === "unique" && index.fields.length === 1) this.uniqueProps.add(index.fields[0].name);
 		for (const index of this.indexes.values()) for (const field of index.fields) field.name = this.pathToPhysical.get(field.name) ?? this.columnMap.get(field.name) ?? field.name;
 	}
+	/**
+	* Captures legitimate row-identifier shapes from the metadata: primary key
+	* (when present) followed by every unique index. Must run BEFORE
+	* `_finalizeIndexes` rewrites `index.fields[i].name` from logical to
+	* physical, so the field lists stay logical.
+	*/
+	_buildIdentifications() {
+		const out = [];
+		if (this.primaryKeys.length > 0) out.push({
+			fields: [...this.primaryKeys],
+			source: "primaryKey"
+		});
+		for (const index of this.indexes.values()) if (index.type === "unique") out.push({
+			fields: index.fields.map((field) => field.name),
+			source: index.name
+		});
+		this._identifications = out;
+	}
+	/** Legitimate row-identifier shapes — primary key first, then each unique index. */
+	getIdentifications() {
+		return this._identifications ?? [];
+	}
+	_resolvePreferredId(type) {
+		const preferred = type.metadata.get("db.table.preferredId.uniqueIndex");
+		if (preferred === void 0) {
+			this.preferredId = [...this.primaryKeys];
+			return;
+		}
+		const requestedName = typeof preferred === "string" ? preferred : void 0;
+		const selected = this.getIdentifications().find((id) => id.source !== "primaryKey" && (requestedName === void 0 || id.source === requestedName));
+		this.preferredId = selected ? [...selected.fields] : [...this.primaryKeys];
+	}
 };
 //#endregion
 //#region src/query/uniqu-select.ts
@@ -1073,6 +1109,7 @@ var AtscriptDbReadable = class {
 	/** Strategy for mapping between logical field shapes and physical storage. */
 	_fieldMapper;
 	_writeTableResolver;
+	_metaIdPhysical;
 	constructor(_type, adapter, logger = NoopLogger, _tableResolver) {
 		this._type = _type;
 		this.adapter = adapter;
@@ -1139,10 +1176,33 @@ var AtscriptDbReadable = class {
 		this._ensureBuilt();
 		return this._meta.primaryKeys;
 	}
-	/** Original `@meta.id` field names as declared in the schema (before adapter manipulation). */
-	get originalMetaIdFields() {
+	/** Preferred row identifier field names. Defaults to primary keys. */
+	get preferredId() {
+		this._ensureBuilt();
+		return this._meta.preferredId;
+	}
+	/** Legitimate row-identifier shapes (primary key + every unique index). */
+	get identifications() {
 		this._ensureBuilt();
-		return this._meta.originalMetaIdFields;
+		return this._meta.getIdentifications();
+	}
+	/**
+	* Physical column name of the single `@meta.id` field, or `null` when the
+	* schema has zero or multiple `@meta.id` fields. Used by adapters to return
+	* the user's logical ID instead of the DB-generated one on insert.
+	*
+	* @internal Adapter-facing surface; not part of the consumer API.
+	*/
+	get metaIdPhysical() {
+		this._ensureBuilt();
+		if (this._metaIdPhysical === void 0) {
+			const fields = this._meta.originalMetaIdFields;
+			if (fields.length === 1) {
+				const field = fields[0];
+				this._metaIdPhysical = this._meta.columnMap.get(field) ?? field;
+			} else this._metaIdPhysical = null;
+		}
+		return this._metaIdPhysical;
 	}
 	/** Dimension fields from `@db.column.dimension`. */
 	get dimensions() {
@@ -1593,27 +1653,12 @@ const txStorage = new AsyncLocalStorage();
 */
 var BaseDbAdapter = class {
 	_table;
-	_metaIdPhysical;
-	/**
-	* Returns the physical column name of the single @meta.id field (if any).
-	* Used to return the user's logical ID instead of the DB-generated ID on insert.
-	*/
-	_getMetaIdPhysical() {
-		if (this._metaIdPhysical === void 0) {
-			const fields = this._table.originalMetaIdFields;
-			if (fields.length === 1) {
-				const field = fields[0];
-				this._metaIdPhysical = this._table.columnMap.get(field) ?? field;
-			} else this._metaIdPhysical = null;
-		}
-		return this._metaIdPhysical;
-	}
 	/**
 	* Resolves the correct insertedId: prefers the user-supplied PK value
 	* from the data over the DB-generated fallback (e.g. rowid, _id).
 	*/
 	_resolveInsertedId(data, dbGeneratedId) {
-		const metaIdPhysical = this._getMetaIdPhysical();
+		const metaIdPhysical = this._table.metaIdPhysical;
 		return metaIdPhysical ? data[metaIdPhysical] ?? dbGeneratedId : dbGeneratedId;
 	}
 	/** Logger instance — set via {@link registerReadable} from the readable's logger. */

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_db_error = require("./db-error-D8tQhNgM.cjs");
-const require_db_view = require("./db-view-DIGN4079.cjs");
+const require_db_view = require("./db-view-CuPkKCnU.cjs");
 const require_ops = require("./ops.cjs");
 const require_validator = require("./validator-BIuw_T0k.cjs");
 require("./nested-writer-v_LPR1yJ.cjs");

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-BCoBlULR.cjs";
+import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-CKQHMqVH.cjs";
 import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-BvBklm9J.cjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-Dycn4usM.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-_z_A3cKa.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
@@ -114,4 +114,4 @@ declare class DbError extends Error {
  */
 declare function decomposePatch(payload: Record<string, unknown>, table: AtscriptDbTable): Record<string, unknown>;
 //#endregion
-export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, 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 DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };
+export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, 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 DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-CrNX04nI.mjs";
+import { $ as TMetadataOverrides, A as TDbCollation, B as TDbInsertResult, C as TColumnDiff, D as TDbActionIntent, E as TDbActionInfo, F as TDbForeignKey, G as TExistingColumn, H as TDbRelation, I as TDbIndex, J as TFkLookupResolver, K as TExistingTableOption, L as TDbIndexField, M as TDbDefaultValue, N as TDbDeleteResult, O as TDbActionLevel, P as TDbFieldMeta, Q as TMetaResponse, R as TDbIndexType, S as TCascadeTarget, T as TCrudPermissions, U as TDbStorageType, V as TDbReferentialAction, W as TDbUpdateResult, X as TIdDescriptor, Y as TFkLookupTarget, Z as TIdentification, _ as FlatOf, a as FieldMappingStrategy, at as TValueFormatterPair, b as PrimaryKeyOf, c as AggregateExpr, ct as Uniquery, d as AggregateResult, dt as TableMetadata, et as TRelationInfo, f as AtscriptDbWritable, ft as NoopLogger, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TTableResolver, j as TDbDefaultFn, k as TDbActionProcessor, l as AggregateFn, lt as UniqueryControls, m as DbQuery, mt as UniquSelect, n as DbResponse, nt as TSyncColumnResult, o as BaseDbAdapter, ot as TWriteTableResolver, p as DbControls, pt as TGenericLogger, q as TFieldMeta, r as resolveDesignType, rt as TTableOptionDiff, s as AggregateControls, st as TypedWithRelation, t as AtscriptDbReadable, tt as TSearchIndexInfo, u as AggregateQuery, ut as WithRelation, v as NavPropsOf, w as TCrudOp, x as TCascadeResolver, y as OwnPropsOf, z as TDbInsertManyResult } from "./db-readable-CkeVx10t.mjs";
 import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-C61kelof.mjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-CsgCjSMH.mjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-BAfXlRiV.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-DttN2e5_.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
@@ -114,4 +114,4 @@ declare class DbError extends Error {
  */
 declare function decomposePatch(payload: Record<string, unknown>, table: AtscriptDbTable): Record<string, unknown>;
 //#endregion
-export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, 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 DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };
+export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, 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 DbControls, DbError, type DbErrorCode, type DbQuery, type DbResponse, DbSpace, type DbValidationContext, DocumentFieldMapper, FieldMappingStrategy, type FieldOpsFor, type FilterExpr, type FilterVisitor, type FlatOf, IntegrityStrategy, NativeIntegrity, type NavPropsOf, NoopLogger, type OwnPropsOf, type PrimaryKeyOf, RelationalFieldMapper, type TAdapterFactory, type TArrayPatch, type TCascadeResolver, type TCascadeTarget, type TColumnDiff, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbCollation, type TDbDefaultFn, type TDbDefaultValue, type TDbDeleteResult, type TDbFieldMeta, type TDbFieldOp, type TDbForeignKey, type TDbIndex, type TDbIndexField, type TDbIndexType, type TDbInsertManyResult, type TDbInsertResult, type TDbPatch, type TDbReferentialAction, type TDbRelation, type TDbStorageType, type TDbUpdateResult, type TExistingColumn, type TExistingTableOption, type TFieldMeta, type TFieldOps, type TFkLookupResolver, type TFkLookupTarget, type TGenericLogger, type TIdDescriptor, type TIdentification, type TMetaResponse, type TMetadataOverrides, type TRelationInfo, type TSearchIndexInfo, type TSyncColumnResult, type TTableOptionDiff, type TTableResolver, type TValueFormatterPair, type TViewColumnMapping, type TViewJoin, type TViewPlan, type TWriteTableResolver, TableMetadata, type TypedWithRelation, UniquSelect, type Uniquery, type UniqueryControls, type ValidationContext, type ValidatorMode, type WithRelation, buildDbValidator, buildValidationContext, computeInsights, createDbValidatorPlugin, decomposePatch, forceNavNonOptional, getDbFieldOp, getKeyProps, isDbFieldOp, isNavRelation, isPrimitive, resolveDesignType, separateFieldOps, translateQueryTree, walkFilter };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as DbError } from "./db-error-Cepx-RsQ.mjs";
-import { a as BaseDbAdapter, c as AtscriptDbReadable, d as DocumentFieldMapper, f as FieldMappingStrategy, h as NoopLogger, i as ApplicationIntegrity, l as resolveDesignType, m as TableMetadata, n as AtscriptDbTable, o as IntegrityStrategy, p as UniquSelect, r as decomposePatch, s as NativeIntegrity, t as AtscriptDbView, u as RelationalFieldMapper } from "./db-view-DNwX6_4x.mjs";
+import { a as BaseDbAdapter, c as AtscriptDbReadable, d as DocumentFieldMapper, f as FieldMappingStrategy, h as NoopLogger, i as ApplicationIntegrity, l as resolveDesignType, m as TableMetadata, n as AtscriptDbTable, o as IntegrityStrategy, p as UniquSelect, r as decomposePatch, s as NativeIntegrity, t as AtscriptDbView, u as RelationalFieldMapper } from "./db-view-cBN0YqrV.mjs";
 import { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, separateFieldOps } from "./ops.mjs";
 import { a as isNavRelation, i as forceNavNonOptional, n as buildValidationContext, o as createDbValidatorPlugin, s as getKeyProps, t as buildDbValidator } from "./validator-BB5h1Le3.mjs";
 import "./nested-writer-CT2rLURx.mjs";

package/dist/plugin.cjs

@@ -764,7 +764,53 @@ const dbTableAnnotations = {
 				});
 				return errors;
 			}
-		})
+		}),
+		preferredId: { uniqueIndex: new _atscript_core.AnnotationSpec({
+			description: "Selects a unique index as the table's preferred row identifier. When the unique-index name is omitted, the first declared unique-index group wins.\n\n**Example:**\n```atscript\n@db.table\n@db.table.preferredId.uniqueIndex \"by_slug\"\nexport interface Post {\n  @db.index.unique \"by_slug\"\n  slug: string\n}\n```\n",
+			nodeType: ["interface"],
+			multiple: false,
+			argument: {
+				optional: true,
+				name: "name",
+				type: "string",
+				description: "Unique-index group name. If omitted, the first declared group is used."
+			},
+			validate(token, args, _doc) {
+				const errors = [];
+				const owner = token.parentNode;
+				if (require_validation_utils.hasAnyViewAnnotation(owner)) errors.push({
+					message: "@db.table.preferredId.uniqueIndex is not supported on @db.view interfaces (views have no unique-index declarations).",
+					severity: 1,
+					range: token.range
+				});
+				if (owner.countAnnotations("db.table") === 0) errors.push({
+					message: "@db.table.preferredId.uniqueIndex requires @db.table on the same interface",
+					severity: 1,
+					range: token.range
+				});
+				const groups = collectUniqueIndexGroups(owner);
+				if (groups.length === 0) {
+					errors.push({
+						message: "@db.table.preferredId.uniqueIndex requires at least one @db.index.unique on a prop of this interface.",
+						severity: 1,
+						range: token.range
+					});
+					return errors;
+				}
+				const requestedName = args[0]?.text;
+				if (requestedName !== void 0 && !groups.some((group) => group === requestedName)) errors.push({
+					message: `@db.table.preferredId.uniqueIndex("${requestedName}") does not match any declared @db.index.unique on this interface; declared groups: ${JSON.stringify(groups)}.`,
+					severity: 1,
+					range: args[0].range
+				});
+				if (requestedName === void 0 && groups.length >= 2) errors.push({
+					message: "@db.table.preferredId.uniqueIndex without a name uses the first declared unique-index group; this can shift if props are reordered.",
+					severity: 2,
+					range: token.range
+				});
+				return errors;
+			}
+		}) }
 	},
 	schema: new _atscript_core.AnnotationSpec({
 		description: "Assigns the entity to a database schema/namespace.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.schema \"auth\"\nexport interface User { ... }\n```\n",
@@ -829,6 +875,24 @@ const dbTableAnnotations = {
 		}
 	}) }
 };
+function collectUniqueIndexGroups(owner) {
+	if (!(0, _atscript_core.isInterface)(owner)) return [];
+	const definition = owner.getDefinition();
+	if (!(0, _atscript_core.isStructure)(definition)) return [];
+	const groups = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [propName, prop] of definition.props) {
+		const annotations = prop.annotations?.filter((ann) => ann.name === "db.index.unique") ?? [];
+		for (const ann of annotations) {
+			const groupName = ann.args[0]?.text ?? propName;
+			if (!seen.has(groupName)) {
+				seen.add(groupName);
+				groups.push(groupName);
+			}
+		}
+	}
+	return groups;
+}
 function tableCapability(capability) {
 	const example = capability === "filterable" ? "  @db.column.filterable\n  email: string\n  // other fields not filterable via the controller\n" : "  @db.column.sortable\n  createdAt: number.timestamp\n  // other fields not sortable via the controller\n";
 	const verb = capability === "filterable" ? "filter" : "sort";

package/dist/plugin.mjs

@@ -760,7 +760,53 @@ const dbTableAnnotations = {
 				});
 				return errors;
 			}
-		})
+		}),
+		preferredId: { uniqueIndex: new AnnotationSpec({
+			description: "Selects a unique index as the table's preferred row identifier. When the unique-index name is omitted, the first declared unique-index group wins.\n\n**Example:**\n```atscript\n@db.table\n@db.table.preferredId.uniqueIndex \"by_slug\"\nexport interface Post {\n  @db.index.unique \"by_slug\"\n  slug: string\n}\n```\n",
+			nodeType: ["interface"],
+			multiple: false,
+			argument: {
+				optional: true,
+				name: "name",
+				type: "string",
+				description: "Unique-index group name. If omitted, the first declared group is used."
+			},
+			validate(token, args, _doc) {
+				const errors = [];
+				const owner = token.parentNode;
+				if (hasAnyViewAnnotation(owner)) errors.push({
+					message: "@db.table.preferredId.uniqueIndex is not supported on @db.view interfaces (views have no unique-index declarations).",
+					severity: 1,
+					range: token.range
+				});
+				if (owner.countAnnotations("db.table") === 0) errors.push({
+					message: "@db.table.preferredId.uniqueIndex requires @db.table on the same interface",
+					severity: 1,
+					range: token.range
+				});
+				const groups = collectUniqueIndexGroups(owner);
+				if (groups.length === 0) {
+					errors.push({
+						message: "@db.table.preferredId.uniqueIndex requires at least one @db.index.unique on a prop of this interface.",
+						severity: 1,
+						range: token.range
+					});
+					return errors;
+				}
+				const requestedName = args[0]?.text;
+				if (requestedName !== void 0 && !groups.some((group) => group === requestedName)) errors.push({
+					message: `@db.table.preferredId.uniqueIndex("${requestedName}") does not match any declared @db.index.unique on this interface; declared groups: ${JSON.stringify(groups)}.`,
+					severity: 1,
+					range: args[0].range
+				});
+				if (requestedName === void 0 && groups.length >= 2) errors.push({
+					message: "@db.table.preferredId.uniqueIndex without a name uses the first declared unique-index group; this can shift if props are reordered.",
+					severity: 2,
+					range: token.range
+				});
+				return errors;
+			}
+		}) }
 	},
 	schema: new AnnotationSpec({
 		description: "Assigns the entity to a database schema/namespace.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.schema \"auth\"\nexport interface User { ... }\n```\n",
@@ -825,6 +871,24 @@ const dbTableAnnotations = {
 		}
 	}) }
 };
+function collectUniqueIndexGroups(owner) {
+	if (!isInterface(owner)) return [];
+	const definition = owner.getDefinition();
+	if (!isStructure(definition)) return [];
+	const groups = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [propName, prop] of definition.props) {
+		const annotations = prop.annotations?.filter((ann) => ann.name === "db.index.unique") ?? [];
+		for (const ann of annotations) {
+			const groupName = ann.args[0]?.text ?? propName;
+			if (!seen.has(groupName)) {
+				seen.add(groupName);
+				groups.push(groupName);
+			}
+		}
+	}
+	return groups;
+}
 function tableCapability(capability) {
 	const example = capability === "filterable" ? "  @db.column.filterable\n  email: string\n  // other fields not filterable via the controller\n" : "  @db.column.sortable\n  createdAt: number.timestamp\n  // other fields not sortable via the controller\n";
 	const verb = capability === "filterable" ? "filter" : "sort";

package/dist/rel.d.cts

@@ -1,4 +1,4 @@
-import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-BCoBlULR.cjs";
+import { F as TDbForeignKey, H as TDbRelation, dt as TableMetadata, it as TTableResolver, o as BaseDbAdapter, ot as TWriteTableResolver, pt as TGenericLogger } from "./db-readable-CKQHMqVH.cjs";
 import { t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";

package/dist/rel.d.mts

@@ -1,4 +1,4 @@
-import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-CrNX04nI.mjs";
+import { F as TDbForeignKey, H as TDbRelation, dt as TableMetadata, it as TTableResolver, o as BaseDbAdapter, ot as TWriteTableResolver, pt as TGenericLogger } from "./db-readable-CkeVx10t.mjs";
 import { t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";

package/dist/sync.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_db_view = require("./db-view-DIGN4079.cjs");
+const require_db_view = require("./db-view-CuPkKCnU.cjs");
 require("./validator-BIuw_T0k.cjs");
 require("./nested-writer-v_LPR1yJ.cjs");
 //#region src/schema/schema-hash.ts

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-BCoBlULR.cjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-BvBklm9J.cjs";
+import { C as TColumnDiff, F as TDbForeignKey, G as TExistingColumn, K as TExistingTableOption, M as TDbDefaultValue, P as TDbFieldMeta, U as TDbStorageType, pt as TGenericLogger, rt as TTableOptionDiff, t as AtscriptDbReadable } from "./db-readable-CKQHMqVH.cjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-Dycn4usM.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-CrNX04nI.mjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-CsgCjSMH.mjs";
+import { C as TColumnDiff, F as TDbForeignKey, G as TExistingColumn, K as TExistingTableOption, M as TDbDefaultValue, P as TDbFieldMeta, U as TDbStorageType, pt as TGenericLogger, rt as TTableOptionDiff, t as AtscriptDbReadable } from "./db-readable-CkeVx10t.mjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-BAfXlRiV.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.mjs

@@ -1,4 +1,4 @@
-import { h as NoopLogger } from "./db-view-DNwX6_4x.mjs";
+import { h as NoopLogger } from "./db-view-cBN0YqrV.mjs";
 import "./validator-BB5h1Le3.mjs";
 import "./nested-writer-CT2rLURx.mjs";
 //#region src/schema/schema-hash.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db",
-  "version": "0.1.57",
+  "version": "0.1.59",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",