@voltro/database 0.65.0 → 0.66.1

package/dist/sql.d.ts

@@ -402,6 +402,15 @@ declare interface ColumnDefinition<TsType, Type extends ColumnType = ColumnType,
     readonly computed?: (row: Readonly<Record<string, unknown>>) => unknown;
     readonly onUpdate?: 'now' | (() => unknown);
     readonly references?: () => TableLike;
+    /**
+     * Physical/TypeScript representation of a foreign key. The default is
+     * `text`, matching Voltro's default TypeID primary key. `numeric` is for a
+     * target declared with `id({ scheme: 'numeric' })`; it renders as the
+     * dialect's 64-bit integer type and decodes as a JavaScript number.
+     */
+    readonly referenceStorage?: 'text' | 'numeric';
+    /** Target key; defaults to the framework convention `id`. */
+    readonly referenceColumn?: string;
     /**
      * Cascade-on-delete behavior for a `reference()` column. Default
      * `'restrict'` — Postgres / MySQL / MariaDB / MSSQL / SQLite all block
@@ -852,6 +861,8 @@ export declare interface ColumnSnapshot {
          */
         readonly orphanPolicy?: 'fail' | 'null' | 'delete';
     };
+    /** Physical representation for `reference()`; defaults to `text`. */
+    readonly referenceStorage?: 'text' | 'numeric';
     /** `oneOf(['a','b'])` → CHECK constraint values. */
     readonly oneOf?: ReadonlyArray<string>;
     /**
@@ -1480,6 +1491,10 @@ export declare interface IndexSnapshot {
     readonly table: string;
     readonly columns: ReadonlyArray<string>;
     readonly unique: boolean;
+    /** SQL predicate for a partial/filtered index; never a full UNIQUE constraint. */
+    readonly where?: string;
+    /** False for an invalid PostgreSQL index left by an interrupted online build. */
+    readonly valid?: boolean;
     /**
      * Expression / json-path index (`expressionIndex(...)` / `jsonIndex(...)`),
      * i.e. at least one key is a SQL expression rather than a bare column. The
@@ -2927,8 +2942,8 @@ declare interface Table<Name extends string, Fields extends Record<string, Colum
      */
     readonly previousTableName?: string;
     /**
-     * Composite PRIMARY KEY column set, declared via `.primaryKey(['a','b'])`.
-     * When set it REPLACES the single-column `id()` PK assumption: no column
+     * Explicit PRIMARY KEY column set, declared via `.primaryKey(['key'])` or
+     * `.primaryKey(['a','b'])`. When set it REPLACES the `id()` PK assumption: no column
      * emits an inline `PRIMARY KEY`, and the table gets a table-level
      * `PRIMARY KEY (a, b)` constraint instead. Empty (the default) means the
      * `id()` column carries the PK inline, as before.
@@ -3237,12 +3252,12 @@ declare interface Table<Name extends string, Fields extends Record<string, Colum
         weights?: Record<string, 'A' | 'B' | 'C' | 'D'>;
     }) => Table<Name, Fields, Reactive, IxNames>;
     /**
-     * Declare a COMPOSITE PRIMARY KEY across two or more columns. Replaces the
+     * Declare an explicit PRIMARY KEY across one or more columns. Replaces the
      * default single-column `id()` primary key: the listed columns become the
      * table's PK, emitted as a table-level `PRIMARY KEY (a, b)` constraint on
      * every dialect (no column carries an inline `PRIMARY KEY`).
      *
-     * Use for natural composite keys — a join table keyed on both its FKs, a
+     * Use for a shared one-to-one FK key or natural composite keys — a join table keyed on both its FKs, a
      * time-series table keyed on `(deviceId, ts)`, a per-tenant sequence keyed
      * on `(tenantId, seq)`.
      *
@@ -3255,12 +3270,12 @@ declare interface Table<Name extends string, Fields extends Record<string, Colum
      * // → PRIMARY KEY ("userId", "orgId")
      * ```
      *
-     * The columns are type-checked against the row. A composite PK implies
+     * The columns are type-checked against the row. An explicit PK implies
      * NOT NULL on each member column (the DB enforces it). Don't also declare an
      * `id()` column — the composite key is THE key; a stray `id()` would emit a
      * second inline PK and the DDL would be rejected.
      */
-    primaryKey: <const F extends readonly [keyof Fields & string, keyof Fields & string, ...Array<keyof Fields & string>]>(fields: F) => Table<Name, Fields, Reactive, IxNames>;
+    primaryKey: <const F extends readonly [keyof Fields & string, ...Array<keyof Fields & string>]>(fields: F) => Table<Name, Fields, Reactive, IxNames>;
     /**
      * Turn reactivity OFF for this table.
      *