@palbase/backend 2.0.2 → 3.0.0

package/dist/schema-BqfEhIC0.d.cts

@@ -1,133 +0,0 @@
-/** On delete action for foreign key references. */
-type OnDeleteAction = 'cascade' | 'set null' | 'restrict' | 'no action';
-/** Column type identifiers. */
-type ColumnType = 'uuid' | 'text' | 'integer' | 'boolean' | 'timestamp' | 'jsonb' | 'enum';
-/** Base column definition shared by all column types. */
-interface ColumnDef {
-    type: ColumnType;
-    nullable: boolean;
-    primaryKey: boolean;
-    defaultValue?: unknown;
-    defaultRandom?: boolean;
-    defaultNow?: boolean;
-    references?: {
-        table: string;
-        column: string;
-    };
-    onDeleteAction?: OnDeleteAction;
-    enumName?: string;
-    enumValues?: string[];
-}
-declare const __colKind: unique symbol;
-declare const __colNullable: unique symbol;
-declare const __colHasDefault: unique symbol;
-declare const __colEnumValues: unique symbol;
-/**
- * Fluent column builder with phantom type params:
- *  K — ColumnType literal (e.g. "text", "integer")
- *  N — boolean: true when nullable() has been called last (false = NOT NULL)
- *  D — boolean: true when a default has been set
- *  E — enum value union (never for non-enum columns)
- *
- * All four params have defaults so bare `ColumnBuilder` (no args) still
- * satisfies `Record<string, ColumnBuilder>` in schema.ts without modification.
- *
- * The four `declare readonly` brand fields carry the phantom types into the
- * structural shape so that conditional types like ColValue<C> can discriminate
- * on K without requiring runtime values on those fields.
- */
-declare class ColumnBuilder<K extends ColumnType = ColumnType, N extends boolean = boolean, D extends boolean = boolean, E = unknown> {
-    readonly [__colKind]: K;
-    readonly [__colNullable]: N;
-    readonly [__colHasDefault]: D;
-    readonly [__colEnumValues]: E;
-    readonly _def: ColumnDef;
-    constructor(type: K, existingDef?: ColumnDef);
-    /** Mark this column as the primary key. */
-    primaryKey(): ColumnBuilder<K, N, D, E>;
-    /** Mark this column as NOT NULL (default). */
-    notNull(): ColumnBuilder<K, false, D, E>;
-    /** Allow NULL values. */
-    nullable(): ColumnBuilder<K, true, D, E>;
-    /** Set a default value. */
-    default(value: unknown): ColumnBuilder<K, N, true, E>;
-    /** UUID: generate a random default (gen_random_uuid()). */
-    defaultRandom(): ColumnBuilder<K, N, true, E>;
-    /** Timestamp: default to now(). */
-    defaultNow(): ColumnBuilder<K, N, true, E>;
-    /** Add a foreign key reference. */
-    references(table: string, column: string): ColumnBuilder<K, N, D, E>;
-    /** Set the ON DELETE action for a foreign key reference. */
-    onDelete(action: OnDeleteAction): ColumnBuilder<K, N, D, E>;
-}
-/**
- * Extracts the TypeScript value type for a column, respecting nullability.
- * - "uuid" | "text" | "timestamp" → string (or string | null when N = true)
- * - "integer" → number
- * - "boolean" → boolean
- * - "jsonb" → unknown (opaque JSON)
- * - "enum" → E (the union of literal values)
- */
-type ColValue<C> = C extends ColumnBuilder<'uuid' | 'text' | 'timestamp', infer N, infer _D, infer _E> ? N extends true ? string | null : string : C extends ColumnBuilder<'integer', infer N, infer _D, infer _E> ? N extends true ? number | null : number : C extends ColumnBuilder<'boolean', infer N, infer _D, infer _E> ? N extends true ? boolean | null : boolean : C extends ColumnBuilder<'jsonb', infer _N, infer _D, infer _E> ? unknown : C extends ColumnBuilder<'enum', infer N, infer _D, infer E> ? N extends true ? E | null : E : never;
-/**
- * True when a column is optional on INSERT:
- *  - nullable columns (N = true) — the DB allows NULL so the field may be omitted
- *  - columns with a default (D = true) — the DB fills in the value when absent
- */
-type ColIsOptionalOnInsert<C> = C extends ColumnBuilder<infer _K, true, infer _D, infer _E> ? true : C extends ColumnBuilder<infer _K, infer _N, true, infer _E> ? true : false;
-/** Create a UUID column. */
-declare function uuid(): ColumnBuilder<'uuid', false, false, never>;
-/** Create a TEXT column. */
-declare function text(): ColumnBuilder<'text', false, false, never>;
-/** Create an INTEGER column. */
-declare function integer(): ColumnBuilder<'integer', false, false, never>;
-/** Create a BOOLEAN column. */
-declare function boolean(): ColumnBuilder<'boolean', false, false, never>;
-/** Create a TIMESTAMP column. */
-declare function timestamp(): ColumnBuilder<'timestamp', false, false, never>;
-/** Create a JSONB column. */
-declare function jsonb(): ColumnBuilder<'jsonb', false, false, never>;
-/**
- * Create an ENUM column.
- * @param name   The PostgreSQL enum type name (used in DDL).
- * @param values A readonly tuple of valid string values — kept `const` so the
- *               union `V[number]` is as narrow as possible.
- */
-declare function enumType<const V extends readonly string[]>(name: string, values: V): ColumnBuilder<'enum', false, false, V[number]>;
-
-/**
- * A table definition with its columns.
- *
- * The `C` type parameter preserves the precise per-column phantom types so
- * that downstream mapped types (InsertShape, RowShape) can discriminate on
- * them. The default `Record<string, ColumnBuilder>` keeps all existing call
- * sites that use `TableDef` without a type argument (generator.ts, etc.)
- * compiling unchanged.
- */
-interface TableDef<C extends Record<string, ColumnBuilder> = Record<string, ColumnBuilder>> {
-    name: string;
-    columns: C;
-}
-/**
- * A schema definition containing multiple tables.
- *
- * The `T` type parameter preserves the exact `TableDef<...>` type for each
- * table so that `SchemaDef["tables"]["rooms"]` resolves to the precise
- * `TableDef<{ id: ColumnBuilder<'uuid', false, true, never>; ... }>`.
- */
-interface SchemaDef<T extends Record<string, TableDef> = Record<string, TableDef>> {
-    tables: T;
-}
-/**
- * Define a table with a name and columns.
- *
- * The generic parameter `C` preserves each column's phantom type params so
- * that `InsertShape<T>` and `RowShape<T>` can derive precise TypeScript types
- * from the column builders. The runtime return shape is identical to before —
- * only the static type is widened.
- */
-declare function table<C extends Record<string, ColumnBuilder>>(name: string, columns: C): TableDef<C>;
-/** Define a schema containing multiple tables. */
-declare function defineSchema<T extends Record<string, TableDef>>(tables: T): SchemaDef<T>;
-
-export { type ColIsOptionalOnInsert as C, type OnDeleteAction as O, type SchemaDef as S, type TableDef as T, type ColValue as a, ColumnBuilder as b, type ColumnDef as c, type ColumnType as d, boolean as e, defineSchema as f, enumType as g, text as h, integer as i, jsonb as j, timestamp as k, table as t, uuid as u };

package/dist/schema-BqfEhIC0.d.ts

@@ -1,133 +0,0 @@
-/** On delete action for foreign key references. */
-type OnDeleteAction = 'cascade' | 'set null' | 'restrict' | 'no action';
-/** Column type identifiers. */
-type ColumnType = 'uuid' | 'text' | 'integer' | 'boolean' | 'timestamp' | 'jsonb' | 'enum';
-/** Base column definition shared by all column types. */
-interface ColumnDef {
-    type: ColumnType;
-    nullable: boolean;
-    primaryKey: boolean;
-    defaultValue?: unknown;
-    defaultRandom?: boolean;
-    defaultNow?: boolean;
-    references?: {
-        table: string;
-        column: string;
-    };
-    onDeleteAction?: OnDeleteAction;
-    enumName?: string;
-    enumValues?: string[];
-}
-declare const __colKind: unique symbol;
-declare const __colNullable: unique symbol;
-declare const __colHasDefault: unique symbol;
-declare const __colEnumValues: unique symbol;
-/**
- * Fluent column builder with phantom type params:
- *  K — ColumnType literal (e.g. "text", "integer")
- *  N — boolean: true when nullable() has been called last (false = NOT NULL)
- *  D — boolean: true when a default has been set
- *  E — enum value union (never for non-enum columns)
- *
- * All four params have defaults so bare `ColumnBuilder` (no args) still
- * satisfies `Record<string, ColumnBuilder>` in schema.ts without modification.
- *
- * The four `declare readonly` brand fields carry the phantom types into the
- * structural shape so that conditional types like ColValue<C> can discriminate
- * on K without requiring runtime values on those fields.
- */
-declare class ColumnBuilder<K extends ColumnType = ColumnType, N extends boolean = boolean, D extends boolean = boolean, E = unknown> {
-    readonly [__colKind]: K;
-    readonly [__colNullable]: N;
-    readonly [__colHasDefault]: D;
-    readonly [__colEnumValues]: E;
-    readonly _def: ColumnDef;
-    constructor(type: K, existingDef?: ColumnDef);
-    /** Mark this column as the primary key. */
-    primaryKey(): ColumnBuilder<K, N, D, E>;
-    /** Mark this column as NOT NULL (default). */
-    notNull(): ColumnBuilder<K, false, D, E>;
-    /** Allow NULL values. */
-    nullable(): ColumnBuilder<K, true, D, E>;
-    /** Set a default value. */
-    default(value: unknown): ColumnBuilder<K, N, true, E>;
-    /** UUID: generate a random default (gen_random_uuid()). */
-    defaultRandom(): ColumnBuilder<K, N, true, E>;
-    /** Timestamp: default to now(). */
-    defaultNow(): ColumnBuilder<K, N, true, E>;
-    /** Add a foreign key reference. */
-    references(table: string, column: string): ColumnBuilder<K, N, D, E>;
-    /** Set the ON DELETE action for a foreign key reference. */
-    onDelete(action: OnDeleteAction): ColumnBuilder<K, N, D, E>;
-}
-/**
- * Extracts the TypeScript value type for a column, respecting nullability.
- * - "uuid" | "text" | "timestamp" → string (or string | null when N = true)
- * - "integer" → number
- * - "boolean" → boolean
- * - "jsonb" → unknown (opaque JSON)
- * - "enum" → E (the union of literal values)
- */
-type ColValue<C> = C extends ColumnBuilder<'uuid' | 'text' | 'timestamp', infer N, infer _D, infer _E> ? N extends true ? string | null : string : C extends ColumnBuilder<'integer', infer N, infer _D, infer _E> ? N extends true ? number | null : number : C extends ColumnBuilder<'boolean', infer N, infer _D, infer _E> ? N extends true ? boolean | null : boolean : C extends ColumnBuilder<'jsonb', infer _N, infer _D, infer _E> ? unknown : C extends ColumnBuilder<'enum', infer N, infer _D, infer E> ? N extends true ? E | null : E : never;
-/**
- * True when a column is optional on INSERT:
- *  - nullable columns (N = true) — the DB allows NULL so the field may be omitted
- *  - columns with a default (D = true) — the DB fills in the value when absent
- */
-type ColIsOptionalOnInsert<C> = C extends ColumnBuilder<infer _K, true, infer _D, infer _E> ? true : C extends ColumnBuilder<infer _K, infer _N, true, infer _E> ? true : false;
-/** Create a UUID column. */
-declare function uuid(): ColumnBuilder<'uuid', false, false, never>;
-/** Create a TEXT column. */
-declare function text(): ColumnBuilder<'text', false, false, never>;
-/** Create an INTEGER column. */
-declare function integer(): ColumnBuilder<'integer', false, false, never>;
-/** Create a BOOLEAN column. */
-declare function boolean(): ColumnBuilder<'boolean', false, false, never>;
-/** Create a TIMESTAMP column. */
-declare function timestamp(): ColumnBuilder<'timestamp', false, false, never>;
-/** Create a JSONB column. */
-declare function jsonb(): ColumnBuilder<'jsonb', false, false, never>;
-/**
- * Create an ENUM column.
- * @param name   The PostgreSQL enum type name (used in DDL).
- * @param values A readonly tuple of valid string values — kept `const` so the
- *               union `V[number]` is as narrow as possible.
- */
-declare function enumType<const V extends readonly string[]>(name: string, values: V): ColumnBuilder<'enum', false, false, V[number]>;
-
-/**
- * A table definition with its columns.
- *
- * The `C` type parameter preserves the precise per-column phantom types so
- * that downstream mapped types (InsertShape, RowShape) can discriminate on
- * them. The default `Record<string, ColumnBuilder>` keeps all existing call
- * sites that use `TableDef` without a type argument (generator.ts, etc.)
- * compiling unchanged.
- */
-interface TableDef<C extends Record<string, ColumnBuilder> = Record<string, ColumnBuilder>> {
-    name: string;
-    columns: C;
-}
-/**
- * A schema definition containing multiple tables.
- *
- * The `T` type parameter preserves the exact `TableDef<...>` type for each
- * table so that `SchemaDef["tables"]["rooms"]` resolves to the precise
- * `TableDef<{ id: ColumnBuilder<'uuid', false, true, never>; ... }>`.
- */
-interface SchemaDef<T extends Record<string, TableDef> = Record<string, TableDef>> {
-    tables: T;
-}
-/**
- * Define a table with a name and columns.
- *
- * The generic parameter `C` preserves each column's phantom type params so
- * that `InsertShape<T>` and `RowShape<T>` can derive precise TypeScript types
- * from the column builders. The runtime return shape is identical to before —
- * only the static type is widened.
- */
-declare function table<C extends Record<string, ColumnBuilder>>(name: string, columns: C): TableDef<C>;
-/** Define a schema containing multiple tables. */
-declare function defineSchema<T extends Record<string, TableDef>>(tables: T): SchemaDef<T>;
-
-export { type ColIsOptionalOnInsert as C, type OnDeleteAction as O, type SchemaDef as S, type TableDef as T, type ColValue as a, ColumnBuilder as b, type ColumnDef as c, type ColumnType as d, boolean as e, defineSchema as f, enumType as g, text as h, integer as i, jsonb as j, timestamp as k, table as t, uuid as u };