flint-orm 0.1.0

package/dist/query/aggregates.d.ts

@@ -0,0 +1,47 @@
+import type { Database } from 'bun:sqlite';
+import type { ColumnDef } from '../schema/columns';
+import type { AnyTable } from '../schema/table';
+import type { Condition } from './conditions';
+/**
+ * Count all rows in a table, optionally filtered by a condition.
+ *
+ * @example
+ * const total = db.count(users);
+ * const active = db.count(users, eq(users.active, true));
+ */
+export declare function count<T extends AnyTable>(client: Database, table: T, condition?: Condition): number;
+/**
+ * Count non-null values of a column, optionally filtered by a condition.
+ *
+ * @example
+ * const count = db.countColumn(users, users.email);
+ */
+export declare function countColumn<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number;
+/**
+ * Sum non-null values of a column, optionally filtered by a condition.
+ *
+ * @example
+ * const total = db.sum(orders, orders.amount);
+ */
+export declare function sum<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
+/**
+ * Average non-null values of a column, optionally filtered by a condition.
+ *
+ * @example
+ * const avgAge = db.avg(users, users.age);
+ */
+export declare function avg<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
+/**
+ * Find the minimum non-null value of a column, optionally filtered by a condition.
+ *
+ * @example
+ * const minAge = db.min(users, users.age);
+ */
+export declare function min<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;
+/**
+ * Find the maximum non-null value of a column, optionally filtered by a condition.
+ *
+ * @example
+ * const maxAge = db.max(users, users.age);
+ */
+export declare function max<T extends AnyTable, C extends ColumnDef<any, any>>(client: Database, table: T, column: C, condition?: Condition): number | null;

package/dist/query/builder.d.ts

@@ -0,0 +1,256 @@
+import type { ColumnDef } from '../schema/columns';
+import type { Condition } from './conditions';
+import type { AnyTable, InferRow, InsertRow } from '../schema/table';
+/**
+ * Narrow a row type to specific columns using a mapped type.
+ * Unlike Pick, TypeScript eagerly evaluates { [K in C]: T[K] } to a concrete
+ * shape in hover info: { id: string; name: string } instead of Pick<...>.
+ */
+export type NarrowRow<T, C extends keyof T> = {
+    [K in C]: T[K];
+};
+/**
+ * Force TypeScript to expand intersection/mapped types into a flat object
+ * in hover info: Prettify<{ id: string } & { name: string }> → { id: string; name: string }.
+ */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Anything that can produce SQL — used by `db.batch()`. */
+export interface Executable {
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+}
+/** Phase 1 of a SELECT — only `.from()` is available. */
+export interface SelectStage1 {
+    from<U extends AnyTable>(table: U): SelectBuilder<U>;
+}
+/**
+ * Full SELECT builder — available after `.from()`.
+ * Returns `InferRow<T>[]` (all columns) from `execute()`.
+ * Call `.columns()` to narrow — returns a `NarrowedSelectBuilder`.
+ */
+export declare class SelectBuilder<T extends AnyTable> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, conditions?: Condition[], selectedColumns?: (keyof InferRow<T>)[] | null, orderByClauses?: {
+        column: ColumnDef<any, any>;
+        direction: 'asc' | 'desc';
+    }[], limitValue?: number | null, offsetValue?: number | null, distinct?: boolean);
+    /** Add a WHERE condition. Multiple calls stack. */
+    where(condition: Condition): SelectBuilder<T>;
+    /**
+     * Narrow which columns appear in the result.
+     * Returns a `NarrowedSelectBuilder` with a clean `{ id: string; name: string }` return type.
+     *
+     * @example
+     * db.select().from(users).columns(["id", "name"]).execute()
+     * // ^? { id: string; name: string }[]
+     */
+    columns<K extends keyof InferRow<T>>(keys: K[]): NarrowedSelectBuilder<T, K>;
+    /** Return a single row or null instead of an array. Adds `LIMIT 1` to the SQL. */
+    single(): SingleSelectBuilder<T>;
+    /** Return only distinct (unique) rows. */
+    distinct(): SelectBuilder<T>;
+    /** Add an ORDER BY clause. Multiple calls stack. */
+    orderBy<K extends keyof InferRow<T>>(key: K, direction?: 'asc' | 'desc'): SelectBuilder<T>;
+    /** Limit the number of results. */
+    limit(n: number): SelectBuilder<T>;
+    /** Skip N rows before returning results. */
+    offset(n: number): SelectBuilder<T>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    /** Execute the query and return all matching rows. */
+    execute(): InferRow<T>[];
+}
+/**
+ * Narrowed SELECT builder — after `.columns()` has been called.
+ * Returns `NarrowRow<InferRow<T>, C>[]` from `execute()` — a clean
+ * `{ id: string; name: string }` shape, no Pick wrapper.
+ */
+export declare class NarrowedSelectBuilder<T extends AnyTable, C extends keyof InferRow<T>> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, conditions: Condition[], selectedColumns: C[], orderByClauses: {
+        column: ColumnDef<any, any>;
+        direction: 'asc' | 'desc';
+    }[], limitValue: number | null, offsetValue: number | null, distinct: boolean);
+    where(condition: Condition): NarrowedSelectBuilder<T, C>;
+    distinct(): NarrowedSelectBuilder<T, C>;
+    single(): NarrowedSingleSelectBuilder<T, C>;
+    orderBy<K extends keyof InferRow<T>>(key: K, direction?: 'asc' | 'desc'): NarrowedSelectBuilder<T, C>;
+    limit(n: number): NarrowedSelectBuilder<T, C>;
+    offset(n: number): NarrowedSelectBuilder<T, C>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    /** Execute the query and return narrowed rows. */
+    execute(): Prettify<NarrowRow<InferRow<T>, C>>[];
+}
+/**
+ * Single-row SELECT builder — after `.single()` on a `SelectBuilder`.
+ * Returns `InferRow<T> | null` from `execute()`.
+ */
+export declare class SingleSelectBuilder<T extends AnyTable> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, conditions: Condition[], selectedColumns?: (keyof InferRow<T>)[] | null, orderByClauses?: {
+        column: ColumnDef<any, any>;
+        direction: 'asc' | 'desc';
+    }[], offsetValue?: number | null, distinct?: boolean);
+    where(condition: Condition): SingleSelectBuilder<T>;
+    orderBy<K extends keyof InferRow<T>>(key: K, direction?: 'asc' | 'desc'): SingleSelectBuilder<T>;
+    offset(n: number): SingleSelectBuilder<T>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    /** Returns a single row or null, never throws on empty results. */
+    execute(): InferRow<T> | null;
+}
+/**
+ * Narrowed single-row SELECT builder — after `.single()` on a `NarrowedSelectBuilder`.
+ * Returns `NarrowRow<InferRow<T>, C> | null` from `execute()`.
+ */
+export declare class NarrowedSingleSelectBuilder<T extends AnyTable, C extends keyof InferRow<T>> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, conditions: Condition[], selectedColumns: C[], orderByClauses: {
+        column: ColumnDef<any, any>;
+        direction: 'asc' | 'desc';
+    }[], offsetValue: number | null, distinct: boolean);
+    where(condition: Condition): NarrowedSingleSelectBuilder<T, C>;
+    orderBy<K extends keyof InferRow<T>>(key: K, direction?: 'asc' | 'desc'): NarrowedSingleSelectBuilder<T, C>;
+    offset(n: number): NarrowedSingleSelectBuilder<T, C>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    /** Returns a single narrowed row or null. */
+    execute(): Prettify<NarrowRow<InferRow<T>, C>> | null;
+}
+/** Phase 1 of a JOIN — only `.on()` is available. */
+export interface JoinSelectStage1<Parent extends AnyTable> {
+    on<Child extends AnyTable>(child: Child, condition: Condition): JoinBuilder<Parent, [Child]>;
+    /** Auto-join: infer condition from foreign key references. */
+    on<Child extends AnyTable>(child: Child): JoinBuilder<Parent, [Child]>;
+}
+/** Full join builder — chain more `.on()` calls or call `.execute()`. */
+export interface JoinBuilder<Parent extends AnyTable, Joined extends AnyTable[], ParentCols extends keyof InferRow<Parent> = keyof InferRow<Parent>> {
+    on<NewChild extends AnyTable>(child: NewChild, condition: Condition): JoinBuilder<Parent, [...Joined, NewChild], ParentCols>;
+    /** Auto-join: infer condition from foreign key references. */
+    on<NewChild extends AnyTable>(child: NewChild): JoinBuilder<Parent, [...Joined, NewChild], ParentCols>;
+    columns<K extends keyof InferRow<Parent>>(keys: K[]): JoinBuilder<Parent, Joined, K>;
+    where(condition: Condition): JoinBuilder<Parent, Joined, ParentCols>;
+    orderBy<K extends keyof InferRow<Parent>>(key: K, direction?: 'asc' | 'desc'): JoinBuilder<Parent, Joined, ParentCols>;
+    limit(n: number): JoinBuilder<Parent, Joined, ParentCols>;
+    offset(n: number): JoinBuilder<Parent, Joined, ParentCols>;
+    single(): SingleJoinBuilder<Parent, Joined, ParentCols>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    execute(): JoinResult<Parent, Joined, ParentCols>[];
+}
+/** The result type for joined queries. Parent fields are narrowed by `.columns()`; each joined table's data is nested under its table name. */
+export type JoinResult<Parent extends AnyTable, _Joined extends AnyTable[], ParentCols extends keyof InferRow<Parent> = keyof InferRow<Parent>> = Prettify<Pick<InferRow<Parent>, ParentCols>> & Record<string, unknown>;
+/** Phase 1 of an INSERT — only `.values()` is available. */
+export interface InsertStage1<T extends AnyTable> {
+    values(row: InsertRow<T>): InsertBuilder<T>;
+    values(rows: InsertRow<T>[]): InsertBuilder<T>;
+}
+type OnConflictDoUpdate<T extends AnyTable> = {
+    mode: 'update';
+    target: ColumnDef<any, any> | ColumnDef<any, any>[];
+    set: Partial<InferRow<T>>;
+};
+type OnConflictStrategy<T extends AnyTable> = OnConflictDoNothing | OnConflictDoUpdate<T>;
+/** Full INSERT builder — available after `.values()` has been called. */
+export declare class InsertBuilder<T extends AnyTable, R extends boolean = false, K extends keyof InferRow<T> = keyof InferRow<T>> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, rowOrRows: InsertRow<T> | InsertRow<T>[], returning?: boolean | K[], onConflict?: OnConflictStrategy<T>);
+    /**
+     * Return the inserted row(s) instead of void.
+     * Pass an array of column names to narrow the result shape.
+     *
+     * @example
+     * db.insert(users).values({ id: "u1", name: "Alice" }).returning()
+     * db.insert(users).values({ id: "u1", name: "Alice" }).returning(["id", "name"])
+     */
+    returning(): InsertBuilder<T, true>;
+    returning<NewK extends keyof InferRow<T>>(keys: NewK[]): InsertBuilder<T, true, NewK>;
+    /**
+     * On conflict, do nothing (ignore the insert).
+     *
+     * @example
+     * db.insert(users).values(row).onConflictDoNothing()
+     */
+    onConflictDoNothing(): InsertBuilder<T, R, K>;
+    /**
+     * On conflict, update specified columns with the proposed values.
+     *
+     * @example
+     * db.insert(users).values(row).onConflictDoUpdate({
+     *   target: users.id,
+     *   set: { name: "Alice" },
+     * })
+     */
+    onConflictDoUpdate<C extends ColumnDef<any, any>>(options: {
+        target: C | C[];
+        set: Partial<InferRow<T>>;
+    }): InsertBuilder<T, R, K>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    execute(): R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void;
+}
+/** Phase 1 of an UPDATE — only `.set()` is available. */
+export interface UpdateStage1<T extends AnyTable> {
+    set(partial: Partial<InferRow<T>>): UpdateBuilder<T>;
+}
+/** Full UPDATE builder — available after `.set()` has been called. */
+export declare class UpdateBuilder<T extends AnyTable, R extends boolean = false, K extends keyof InferRow<T> = keyof InferRow<T>> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, set: Partial<InferRow<T>>, conditions?: Condition[], returning?: boolean | K[]);
+    set(partial: Partial<InferRow<T>>): UpdateBuilder<T, R, K>;
+    where(condition: Condition): UpdateBuilder<T, R, K>;
+    /**
+     * Return the updated row(s) instead of void.
+     * Pass an array of column names to narrow the result shape.
+     *
+     * @example
+     * db.update(users).set({ name: "Bob" }).where(eq(users.id, "u1")).returning()
+     * db.update(users).set({ name: "Bob" }).where(eq(users.id, "u1")).returning(["id", "name"])
+     */
+    returning(): UpdateBuilder<T, true>;
+    returning<NewK extends keyof InferRow<T>>(keys: NewK[]): UpdateBuilder<T, true, NewK>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    execute(): R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void;
+}
+/** Full DELETE builder — chain `.where()` calls then `.execute()`. */
+export declare class DeleteBuilder<T extends AnyTable, R extends boolean = false, K extends keyof InferRow<T> = keyof InferRow<T>> implements Executable {
+    #private;
+    constructor(client: DatabaseClient, tableName: string, table: T, conditions?: Condition[], returning?: boolean | K[]);
+    where(condition: Condition): DeleteBuilder<T, R, K>;
+    /**
+     * Return the deleted row(s) instead of void.
+     * Pass an array of column names to narrow the result shape.
+     *
+     * @example
+     * db.delete(users).where(eq(users.id, "u1")).returning()
+     * db.delete(users).where(eq(users.id, "u1")).returning(["id", "name"])
+     */
+    returning(): DeleteBuilder<T, true>;
+    returning<NewK extends keyof InferRow<T>>(keys: NewK[]): DeleteBuilder<T, true, NewK>;
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    execute(): R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void;
+}
+export {};

package/dist/query/conditions.d.ts

@@ -0,0 +1,176 @@
+import type { ColumnDef } from '../schema/columns';
+/** A condition node used in WHERE clauses. */
+export type Condition = {
+    type: 'eq';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'eqColumn';
+    left: ColumnDef<any, any>;
+    right: ColumnDef<any, any>;
+} | {
+    type: 'gt';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'gte';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'lt';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'lte';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'neq';
+    column: ColumnDef<any, any>;
+    value: unknown;
+} | {
+    type: 'in';
+    column: ColumnDef<any, any>;
+    values: unknown[];
+} | {
+    type: 'notIn';
+    column: ColumnDef<any, any>;
+    values: unknown[];
+} | {
+    type: 'isNull';
+    column: ColumnDef<any, any>;
+} | {
+    type: 'isNotNull';
+    column: ColumnDef<any, any>;
+} | {
+    type: 'like';
+    column: ColumnDef<any, any>;
+    pattern: string;
+} | {
+    type: 'glob';
+    column: ColumnDef<any, any>;
+    pattern: string;
+} | {
+    type: 'between';
+    column: ColumnDef<any, any>;
+    low: unknown;
+    high: unknown;
+} | {
+    type: 'and';
+    conditions: Condition[];
+} | {
+    type: 'or';
+    conditions: Condition[];
+};
+/**
+ * Check if a column equals a value, or if two columns are equal.
+ *
+ * @example
+ * // Value comparison
+ * where(eq(users.name, "Alice"))
+ *
+ * // Column-to-column comparison
+ * where(eq(orders.userId, users.id))
+ */
+export declare function eq<T>(column: ColumnDef<T, any>, value: T): Condition;
+export declare function eq<T>(left: ColumnDef<T, any>, right: ColumnDef<T, any>): Condition;
+/**
+ * Combine conditions with AND.
+ *
+ * @example
+ * where(and(eq(users.name, "Alice"), eq(users.active, true)))
+ */
+export declare function and(...conditions: Condition[]): Condition;
+/**
+ * Combine conditions with OR.
+ *
+ * @example
+ * where(or(eq(users.role, "admin"), eq(users.role, "moderator")))
+ */
+export declare function or(...conditions: Condition[]): Condition;
+/**
+ * Check if a column's value is in the given array.
+ *
+ * @example
+ * where(isIn(users.id, ["u1", "u2", "u3"]))
+ */
+export declare function isIn<T>(column: ColumnDef<T, any>, values: T[]): Condition;
+/**
+ * Check if a column's value is not in the given array.
+ *
+ * @example
+ * where(isNotIn(users.id, ["u4", "u5"]))
+ */
+export declare function isNotIn<T>(column: ColumnDef<T, any>, values: T[]): Condition;
+/**
+ * Check if a column is NULL.
+ *
+ * @example
+ * where(isNull(users.deletedAt))
+ */
+export declare function isNull(column: ColumnDef<any, any>): Condition;
+/**
+ * Check if a column is NOT NULL.
+ *
+ * @example
+ * where(isNotNull(users.name))
+ */
+export declare function isNotNull(column: ColumnDef<any, any>): Condition;
+/**
+ * Pattern match using SQL `LIKE`. Use `%` for any sequence of characters, `_` for a single character.
+ *
+ * @example
+ * where(like(users.name, "A%"))
+ */
+export declare function like(column: ColumnDef<any, any>, pattern: string): Condition;
+/**
+ * Pattern match using SQL `GLOB`. Use `*` for any sequence of characters, `?` for a single character.
+ *
+ * @example
+ * where(glob(users.name, "A*"))
+ */
+export declare function glob(column: ColumnDef<any, any>, pattern: string): Condition;
+/**
+ * Check if a column's value is between `low` and `high` (inclusive).
+ *
+ * @example
+ * where(between(users.age, 18, 65))
+ */
+export declare function between<T>(column: ColumnDef<T, any>, low: T, high: T): Condition;
+/**
+ * Check if a column's value is greater than a value.
+ *
+ * @example
+ * where(gt(users.age, 18))
+ */
+export declare function gt<T>(column: ColumnDef<T, any>, value: T): Condition;
+/**
+ * Check if a column's value is greater than or equal to a value.
+ *
+ * @example
+ * where(gte(users.age, 18))
+ */
+export declare function gte<T>(column: ColumnDef<T, any>, value: T): Condition;
+/**
+ * Check if a column's value is less than a value.
+ *
+ * @example
+ * where(lt(users.age, 65))
+ */
+export declare function lt<T>(column: ColumnDef<T, any>, value: T): Condition;
+/**
+ * Check if a column's value is less than or equal to a value.
+ *
+ * @example
+ * where(lte(users.age, 65))
+ */
+export declare function lte<T>(column: ColumnDef<T, any>, value: T): Condition;
+/**
+ * Check if a column's value is not equal to a value.
+ *
+ * @example
+ * where(neq(users.id, "u1"))
+ */
+export declare function neq<T>(column: ColumnDef<T, any>, value: T): Condition;
+export declare function compileCondition(cond: Condition, params: unknown[]): string;
+export declare function compileConditions(conditions: Condition[], params: unknown[]): string;

package/dist/schema/columns.d.ts

@@ -0,0 +1,137 @@
+/**
+ * A column definition with chainable modifiers.
+ *
+ * @example
+ * const name = text("name").notNull().default("unnamed");
+ */
+export interface ColumnDef<T, S extends string = string> {
+    readonly name: string;
+    primaryKey(): ColumnDef<T, S>;
+    notNull(): ColumnDef<T, S>;
+    unique(): ColumnDef<T, S>;
+    /** Set a static default value used when the value is omitted during insert. */
+    default(value: T): ColumnDef<T, S>;
+    /** Set a dynamic default function called when the value is omitted during insert. */
+    defaultFn(fn: () => T): ColumnDef<T, S>;
+    /**
+     * Define a foreign key reference to another table's column.
+     *
+     * @example
+     * text("userId").references(users.id)
+     */
+    references(target: ColumnDef<any, any>): ColumnDef<T, S>;
+    readonly __internal: {
+        /** Phantom — exists only at the type level, never accessed at runtime. */
+        readonly _type: T;
+        /** SQLite storage class: "text" | "integer" | "real" | "blob". */
+        readonly sqlType: S;
+        /** Column constraint flags — set via modifiers, read by migration generator. */
+        readonly isPrimaryKey: boolean;
+        readonly isNotNull: boolean;
+        readonly isUnique: boolean;
+        readonly hasDefault: boolean;
+        readonly defaultValue: T | undefined;
+        readonly defaultFn: (() => T) | undefined;
+        readonly isAutoIncrement: boolean;
+        readonly hasDefaultNow: boolean;
+        readonly hasOnUpdate: boolean;
+        /** Foreign key reference — table and column names. */
+        readonly referencesTable: string | null;
+        readonly referencesColumn: string | null;
+        /** Converts logical value → storage value. Called by the builder. */
+        readonly encode: (value: T) => unknown;
+        /** Converts storage value → logical value. Called by the builder. */
+        readonly decode: (value: unknown) => T;
+        /** Table name — set by table() when the column is attached. Used for join disambiguation. */
+        readonly tableName: string | null;
+    };
+}
+/** An integer column definition with auto-increment support. */
+export interface IntegerColumnDef<S extends string = 'integer'> extends ColumnDef<number, S> {
+    primaryKey(): IntegerColumnDef<S>;
+    notNull(): IntegerColumnDef<S>;
+    unique(): IntegerColumnDef<S>;
+    default(value: number): IntegerColumnDef<S>;
+    defaultFn(fn: () => number): IntegerColumnDef<S>;
+    /**
+     * Mark as auto-increment (SQLite ROWID alias).
+     *
+     * @example
+     * const id = integer("id").primaryKey().autoIncrement();
+     */
+    autoIncrement(): IntegerColumnDef<S>;
+}
+/** A date column that stores a unix timestamp (milliseconds) in SQLite. Nullable in results unless `.defaultNow()` is called. */
+export interface DateColumnDef extends ColumnDef<Date, 'integer'> {
+    primaryKey(): DateColumnDef;
+    notNull(): DateColumnDef;
+    unique(): DateColumnDef;
+    default(value: Date): DateColumnDef;
+    defaultFn(fn: () => Date): DateColumnDef;
+    /**
+     * Use `Date.now()` as the default when the value is omitted during insert.
+     *
+     * @example
+     * const createdAt = date("created_at").defaultNow();
+     */
+    defaultNow(): DateColumnDefWithDefault;
+    /**
+     * Always set to `Date.now()` on update, regardless of the provided value.
+     *
+     * @example
+     * const updatedAt = date("updated_at").onUpdate();
+     */
+    onUpdate(): DateColumnDef;
+}
+/** A date column with a guaranteed default value, making it non-nullable in query results. */
+export interface DateColumnDefWithDefault extends DateColumnDef {
+    primaryKey(): DateColumnDefWithDefault;
+    notNull(): DateColumnDefWithDefault;
+    unique(): DateColumnDefWithDefault;
+    default(value: Date): DateColumnDefWithDefault;
+    defaultFn(fn: () => Date): DateColumnDefWithDefault;
+    defaultNow(): DateColumnDefWithDefault;
+    onUpdate(): DateColumnDefWithDefault;
+}
+/**
+ * Create a text column.
+ *
+ * @example
+ * const name = text("name").notNull();
+ */
+export declare function text(name?: string): ColumnDef<string, 'text'>;
+/**
+ * Create an integer column.
+ *
+ * @example
+ * const id = integer("id").primaryKey().autoIncrement();
+ */
+export declare function integer(name?: string): IntegerColumnDef<'integer'>;
+/**
+ * Create a boolean column. Stores `0`/`1` in SQLite, exposed as `boolean` in TypeScript.
+ *
+ * @example
+ * const active = boolean("active").notNull().default(true);
+ */
+export declare function boolean(name?: string): ColumnDef<boolean, 'integer'>;
+/**
+ * Create a JSON column. Stores JSON text in SQLite, exposed as `T` in TypeScript.
+ *
+ * @example
+ * const meta = json<Record<string, unknown>>("meta").default({});
+ */
+export declare function json<T>(name?: string): ColumnDef<T, 'text'>;
+/**
+ * Create a date column. Stores a unix timestamp (milliseconds) in SQLite, exposed as `Date` in TypeScript.
+ *
+ * @example
+ * const createdAt = date("created_at").defaultNow().notNull();
+ */
+export declare function date(name?: string): DateColumnDef;
+/**
+ * Create a real (floating-point) column.
+ *
+ * @example
+ * const price = real("price").notNull();
+ */
+export declare function real(name?: string): ColumnDef<number, 'real'>;

package/dist/schema/table.d.ts

@@ -0,0 +1,44 @@
+import type { ColumnDef, DateColumnDef, DateColumnDefWithDefault } from './columns';
+/** A table definition mapping column names to their `ColumnDef`s. */
+export type TableDef<T> = T & {
+    readonly _: {
+        readonly name: string;
+    };
+};
+export declare function table<T extends Record<string, ColumnDef<any, any>>>(name: string, columns: T): TableDef<T>;
+/**
+ * Derive the row shape from a table's column definitions.
+ * DateColumnDef → Date | null (nullable unless defaultNow() was called)
+ * DateColumnDefWithDefault → Date (non-nullable, has a guaranteed default)
+ * All other columns → their _type as-is.
+ *
+ * Uses `infer C` to extract the column record from TableDef<T> so TypeScript
+ * evaluates the mapped type against the concrete columns, not the intersection.
+ * This produces cleaner hover info: { id: string; name: string } instead of
+ * Pick<InferRow<TableDef<{...}>>, ...>.
+ */
+export type InferRow<T extends TableDef<any>> = T extends TableDef<infer C> ? {
+    [K in keyof Omit<C, '_'>]: C[K] extends DateColumnDefWithDefault ? Date : C[K] extends DateColumnDef ? Date | null : C[K] extends ColumnDef<any, any> ? C[K]['__internal']['_type'] : never;
+} : never;
+/** The row type for inserts — columns with auto-defaults (integer, date) are optional. */
+export type InsertRow<T extends TableDef<any>> = {
+    [K in keyof Omit<T, '_'> as HasAutoDefault<T[K]> extends true ? never : K]: T[K] extends ColumnDef<any, any> ? T[K]['__internal']['_type'] : never;
+} & {
+    [K in keyof Omit<T, '_'> as HasAutoDefault<T[K]> extends true ? K : never]?: T[K] extends ColumnDef<any, any> ? T[K]['__internal']['_type'] : never;
+};
+/**
+ * Define a table with auto snake_case column names.
+ * Column names are inferred from object keys and converted to snake_case.
+ * Column constructors can be called without a name.
+ *
+ * @example
+ * const users = snakeCase.table("users", {
+ *   id: text().primaryKey(),
+ *   firstName: text(),
+ * });
+ */
+export declare function snakeCaseTable<T extends Record<string, ColumnDef<any, any>>>(tableName: string, columns: T): TableDef<T>;
+/** Provides `snakeCase.table()` for auto snake_case column naming. */
+export declare const snakeCase: {
+    table: typeof snakeCaseTable;
+};

package/dist/src/entries/expressions.d.ts

@@ -0,0 +1,5 @@
+export { eq, and, or, gt, gte, lt, lte, neq, isIn, isNotIn, isNull, isNotNull, like, glob, between } from '../query/conditions';
+export type { Condition } from '../query/conditions';
+export { sql } from '../flint';
+export type { SQLExpression } from '../flint';
+export { count, countColumn, sum, avg, min, max } from '../query/aggregates';

package/dist/src/entries/table.d.ts

@@ -0,0 +1,4 @@
+export { text, integer, boolean, json, date, real } from '../schema/columns';
+export type { ColumnDef, IntegerColumnDef, DateColumnDef, DateColumnDefWithDefault } from '../schema/columns';
+export { table, snakeCase } from '../schema/table';
+export type { InferRow, InsertRow, TableDef, AnyTable } from '../schema/table';