flint-orm 0.5.0 → 0.7.0

package/API.md

@@ -30,7 +30,7 @@ const users = table('users', {
 const db = flint({ url: './app.db' });
 
 // Query
-const user = await db.select().from(users).where(eq(users.id, 'u1')).single().execute();
+const user = await db.selectFrom(users).where(eq(users.id, 'u1')).single().execute();
 // { id: "u1", name: "Alice", email: "alice@example.com", age: 30, createdAt: Date }
 ```
 
@@ -177,12 +177,12 @@ const users = table(
 
 All `execute()` methods return `Promise<T>` — always `await` regardless of driver.
 
-### `db.select().from(table)`
+### `db.selectFrom(table)`
 
-Start a SELECT query. Two-phase: `.from()` is required before anything else.
+Start a SELECT query. Call `.columns()` to narrow, `.where()` to filter, `.execute()` to run.
 
 ```ts
-await db.select().from(users).execute();
+await db.selectFrom(users).execute();
 // SELECT * FROM users
 ```
 
@@ -191,7 +191,7 @@ await db.select().from(users).execute();
 Narrow which columns appear in the result.
 
 ```ts
-await db.select().from(users).columns(['id', 'name']).execute();
+await db.selectFrom(users).columns(['id', 'name']).execute();
 // SELECT id, name FROM users
 // Returns: { id: string; name: string }[]
 ```
@@ -201,7 +201,7 @@ await db.select().from(users).columns(['id', 'name']).execute();
 Filter rows.
 
 ```ts
-await db.select().from(users).where(eq(users.active, true)).execute();
+await db.selectFrom(users).where(eq(users.active, true)).execute();
 // SELECT * FROM users WHERE active = 1
 ```
 
@@ -210,7 +210,7 @@ await db.select().from(users).where(eq(users.active, true)).execute();
 Return one row or null instead of an array. Adds `LIMIT 1`.
 
 ```ts
-await db.select().from(users).where(eq(users.id, 'u1')).single().execute();
+await db.selectFrom(users).where(eq(users.id, 'u1')).single().execute();
 // SELECT * FROM users WHERE id = ? LIMIT 1
 // Returns: UserRow | null
 ```
@@ -220,7 +220,7 @@ await db.select().from(users).where(eq(users.id, 'u1')).single().execute();
 Sort results. Default direction is `"asc"`.
 
 ```ts
-await db.select().from(users).orderBy('name', 'desc').execute();
+await db.selectFrom(users).orderBy('name', 'desc').execute();
 // SELECT * FROM users ORDER BY name DESC
 ```
 
@@ -229,7 +229,7 @@ await db.select().from(users).orderBy('name', 'desc').execute();
 Limit the number of results.
 
 ```ts
-await db.select().from(users).limit(10).execute();
+await db.selectFrom(users).limit(10).execute();
 // SELECT * FROM users LIMIT 10
 ```
 
@@ -238,7 +238,7 @@ await db.select().from(users).limit(10).execute();
 Skip N rows.
 
 ```ts
-await db.select().from(users).limit(10).offset(20).execute();
+await db.selectFrom(users).limit(10).offset(20).execute();
 // SELECT * FROM users LIMIT 10 OFFSET 20
 ```
 
@@ -247,7 +247,7 @@ await db.select().from(users).limit(10).offset(20).execute();
 Return unique rows.
 
 ```ts
-await db.select().from(users).columns(['name']).distinct().execute();
+await db.selectFrom(users).columns(['name']).distinct().execute();
 // SELECT DISTINCT name FROM users
 ```
 
@@ -536,7 +536,7 @@ import { sql } from 'flint-orm';
 const expr = sql`name = ${'Alice'} AND age > ${18}`;
 // { sql: "name = ? AND age > ?", params: ["Alice", 18] }
 
-const result = await db.select().from(users).where(expr).execute();
+const result = await db.selectFrom(users).where(expr).execute();
 ```
 
 ---
@@ -595,7 +595,7 @@ import { addTable, dropTable, renameTable, addColumn, dropColumn, renameColumn,
 | `dropIndex`    | `DROP INDEX ...`                       |
 | `modifyColumn` | `ALTER TABLE ... ALTER COLUMN ...`     |
 | `modifyIndex`  | `DROP INDEX IF EXISTS ...; CREATE ...` |
-| `rebuildTable` | Temp table → copy → drop → rename     |
+| `rebuildTable` | Temp table → copy → drop → rename      |
 
 ---
 

package/README.md

@@ -42,11 +42,11 @@ const db = flint({ url: './app.db' });
 await db.insert(users).values({ id: 'u1', name: 'Alice', email: 'alice@example.com' }).execute();
 
 // Query
-const adults = await db.select().from(users).where(eq(users.age, 18)).execute();
+const adults = await db.selectFrom(users).where(eq(users.age, 18)).execute();
 //    ^? { id: string; name: string; email: string; age: number; createdAt: Date }[]
 
 // Single row
-const alice = await db.select().from(users).where(eq(users.id, 'u1')).single().execute();
+const alice = await db.selectFrom(users).where(eq(users.id, 'u1')).single().execute();
 //    ^? { id: string; name: string; email: string; age: number; createdAt: Date } | null
 ```
 
@@ -118,24 +118,24 @@ type NewUser = InsertRow<typeof users>;
 
 ```ts
 // All rows
-const all = await db.select().from(users).execute();
+const all = await db.selectFrom(users).execute();
 
 // With conditions
-const active = await db.select().from(users).where(eq(users.active, true)).execute();
+const active = await db.selectFrom(users).where(eq(users.active, true)).execute();
 
 // Narrow columns
-const names = await db.select().from(users).columns(['id', 'name']).execute();
+const names = await db.selectFrom(users).columns(['id', 'name']).execute();
 //    ^? { id: string; name: string }[]
 
 // Single row
-const user = await db.select().from(users).where(eq(users.id, 'u1')).single().execute();
+const user = await db.selectFrom(users).where(eq(users.id, 'u1')).single().execute();
 //    ^? { ... } | null
 
 // Ordering and pagination
-const page = await db.select().from(users).orderBy('name', 'asc').limit(10).offset(20).execute();
+const page = await db.selectFrom(users).orderBy('name', 'asc').limit(10).offset(20).execute();
 
 // Distinct
-const unique = await db.select().from(users).columns(['email']).distinct().execute();
+const unique = await db.selectFrom(users).columns(['email']).distinct().execute();
 ```
 
 ### INSERT
@@ -236,7 +236,7 @@ await db.batch([db.insert(users).values({ id: 'u1', name: 'Alice' }), db.insert(
 import { sql } from 'flint-orm';
 
 const expr = sql`name = ${'Alice'} AND age > ${18}`;
-const result = await db.select().from(users).where(expr).execute();
+const result = await db.selectFrom(users).where(expr).execute();
 
 // Direct execution
 await db.$run('CREATE TABLE test (id INTEGER PRIMARY KEY, name TEXT)');

package/dist/drivers/better-sqlite3.d.ts

@@ -6,7 +6,9 @@ export declare class BetterSqlite3Executor implements Executor {
     constructor(client: Database.Database);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
@@ -20,7 +22,7 @@ export declare class BetterSqlite3Executor implements Executor {
 export declare function flint(options: {
     url: string;
 } & Database.Options): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -33,6 +35,8 @@ export declare function flint(options: {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/drivers/bun-sqlite.d.ts

@@ -7,7 +7,9 @@ export declare class BunSqliteExecutor implements Executor {
     constructor(client: Database);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
@@ -21,7 +23,7 @@ export declare class BunSqliteExecutor implements Executor {
 export declare function flint(options: {
     url: string;
 } & DatabaseOptions): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -34,6 +36,8 @@ export declare function flint(options: {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/drivers/lazy-executor.d.ts

@@ -8,7 +8,9 @@ export declare class LazyExecutor implements Executor {
     constructor(factory: () => Promise<Executor>);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }

package/dist/drivers/libsql-web.d.ts

@@ -6,7 +6,9 @@ export declare class LibsqlWebExecutor implements Executor {
     constructor(client: Client);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
@@ -21,7 +23,7 @@ export declare class LibsqlWebExecutor implements Executor {
  * const db = flint({ url: 'libsql://your-db.turso.io', authToken: '...' })
  */
 export declare function flint(options: Config): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -34,6 +36,8 @@ export declare function flint(options: Config): {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/drivers/libsql.d.ts

@@ -6,7 +6,9 @@ export declare class LibsqlExecutor implements Executor {
     constructor(client: Client);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
@@ -18,7 +20,7 @@ export declare class LibsqlExecutor implements Executor {
  * const db = flint({ url: 'libsql://your-db.turso.io', authToken: '...' })
  */
 export declare function flint(options: Config): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -31,6 +33,8 @@ export declare function flint(options: Config): {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/drivers/turso-sync.d.ts

@@ -6,14 +6,16 @@ export declare class TursoSyncExecutor implements Executor {
     constructor(db: Database);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
 export interface TursoSyncOptions extends Omit<DatabaseOpts, 'path' | 'url' | 'authToken'> {
-    /** Local path for the synced database files. */
+    /** Local path for the synced database files (maps to `path` in `@tursodatabase/sync`). */
     url: string;
-    /** Remote Turso database URL (libsql://...). */
+    /** Remote Turso database URL (maps to `url` in `@tursodatabase/sync`). */
     syncUrl?: string;
     /** Auth token for the remote database. */
     authToken?: DatabaseOpts['authToken'];
@@ -28,7 +30,7 @@ export interface TursoSyncOptions extends Omit<DatabaseOpts, 'path' | 'url' | 'a
  * const db = flint({ url: './local.db', syncUrl: 'libsql://db.turso.io', authToken: '...' })
  */
 export declare function flint(options: TursoSyncOptions): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -41,6 +43,8 @@ export declare function flint(options: TursoSyncOptions): {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/drivers/turso.d.ts

@@ -7,7 +7,9 @@ export declare class TursoExecutor implements Executor {
     constructor(db: Database);
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     get(sql: string, params: unknown[]): Promise<unknown>;
-    run(sql: string, params: unknown[]): Promise<void>;
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
@@ -23,7 +25,7 @@ export declare class TursoExecutor implements Executor {
 export declare function flint(options: {
     url: string;
 } & Parameters<typeof connect>[1]): {
-    select: () => import("..").SelectStage1;
+    selectFrom: <T extends import("..").AnyTable>(table: T) => import("..").SelectBuilder<T>;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
     delete: <T extends import("..").AnyTable>(table: T) => import("../query/builder").DeleteBuilder<T, false, keyof import("..").InferRow<T>>;
@@ -36,6 +38,8 @@ export declare function flint(options: {
     avg: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     min: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     $executor: Executor;
 };

package/dist/executor.d.ts

@@ -7,8 +7,10 @@ export interface Executor {
     all(sql: string, params: unknown[]): Promise<unknown[]>;
     /** Execute a query and return a single row or null. */
     get(sql: string, params: unknown[]): Promise<unknown>;
-    /** Execute a statement (INSERT, UPDATE, DELETE, DDL). */
-    run(sql: string, params: unknown[]): Promise<void>;
+    /** Execute a statement (INSERT, UPDATE, DELETE, DDL) and return affected row count. */
+    run(sql: string, params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     /** Run a callback inside a transaction. */
     transaction(fn: () => void | Promise<void>): Promise<void>;
     /** Close the underlying database connection. No-op if already closed. */

package/dist/flint.d.ts

@@ -1,10 +1,10 @@
 import type { Executor } from './executor';
-import { DeleteBuilder } from './query/builder';
-import type { Executable, SelectStage1, InsertStage1, UpdateStage1, JoinSelectStage1 } from './query/builder';
+import { SelectBuilder, DeleteBuilder } from './query/builder';
+import type { Executable, InsertStage1, UpdateStage1, JoinSelectStage1 } from './query/builder';
 import type { AnyTable } from './schema/table';
 import type { Condition } from './query/conditions';
 import type { ColumnDef } from './schema/columns';
-export type { Executable, SelectStage1, InsertStage1, UpdateStage1, JoinSelectStage1, JoinBuilder, SingleJoinBuilder } from './query/builder';
+export type { Executable, SelectBuilder, InsertStage1, UpdateStage1, JoinSelectStage1, JoinBuilder, SingleJoinBuilder } from './query/builder';
 export type { JoinResult } from './query/builder';
 /**
  * A raw SQL expression with parameters.
@@ -29,12 +29,12 @@ export interface SQLExpression {
  */
 export declare function createClient(executor: Executor): {
     /**
-     * Start a SELECT query — call `.from(table)` next.
+     * Start a SELECT query — pass a table definition.
      *
      * @example
-     * const rows = db.select().from(users).execute()
+     * const rows = db.selectFrom(users).execute()
      */
-    select: () => SelectStage1;
+    selectFrom: <T extends AnyTable>(table: T) => SelectBuilder<T>;
     /**
      * Start an INSERT — call `.values(row)` next.
      *
@@ -107,7 +107,9 @@ export declare function createClient(executor: Executor): {
     /**
      * Execute raw SQL directly against the database.
      */
-    $run(query: string, ...params: unknown[]): Promise<void>;
+    $run(query: string, ...params: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
     /** Direct access to the underlying executor. */
     $executor: Executor;
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { sql, createClient } from './flint';
-export type { SQLExpression, Executable, SelectStage1, InsertStage1, UpdateStage1 } from './flint';
+export type { SQLExpression, Executable, SelectBuilder, InsertStage1, UpdateStage1 } from './flint';
 export type { Executor } from './executor';
 export { text, integer, boolean, json, date, real } from './schema/columns';
 export type { ColumnDef, IntegerColumnDef, DateColumnDef, DateColumnDefWithDefault } from './schema/columns';

package/dist/query/builder.d.ts

@@ -24,12 +24,9 @@ export interface Executable {
         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()`.
+ * Full SELECT builder — created directly via `db.selectFrom(table)`.
+ * Entry point: `db.selectFrom(table)`.
  * Returns `InferRow<T>[]` (all columns) from `execute()`.
  * Call `.columns()` to narrow — returns a `NarrowedSelectBuilder`.
  */
@@ -46,7 +43,7 @@ export declare class SelectBuilder<T extends AnyTable> implements Executable {
      * Returns a `NarrowedSelectBuilder` with a clean `{ id: string; name: string }` return type.
      *
      * @example
-     * db.select().from(users).columns(["id", "name"]).execute()
+     * db.selectFrom(users).columns(["id", "name"]).execute()
      * // ^? { id: string; name: string }[]
      */
     columns<K extends keyof InferRow<T>>(keys: K[]): NarrowedSelectBuilder<T, K>;
@@ -205,7 +202,9 @@ export declare class InsertBuilder<T extends AnyTable, R extends boolean = false
         sql: string;
         params: unknown[];
     };
-    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void>;
+    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : {
+        rowsAffected: number;
+    }>;
 }
 /** Phase 1 of an UPDATE — only `.set()` is available. */
 export interface UpdateStage1<T extends AnyTable> {
@@ -231,7 +230,9 @@ export declare class UpdateBuilder<T extends AnyTable, R extends boolean = false
         sql: string;
         params: unknown[];
     };
-    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void>;
+    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : {
+        rowsAffected: number;
+    }>;
 }
 /** 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 {
@@ -252,6 +253,8 @@ export declare class DeleteBuilder<T extends AnyTable, R extends boolean = false
         sql: string;
         params: unknown[];
     };
-    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : void>;
+    execute(): Promise<R extends true ? Prettify<NarrowRow<InferRow<T>, K>>[] : {
+        rowsAffected: number;
+    }>;
 }
 export {};

package/dist/src/cli.js

@@ -1376,18 +1376,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c3]) => prefix ? `${prefix}.${c3.name}` : c3.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -2066,8 +2054,7 @@ class InsertBuilder {
         }
         return records.map((r2) => decodeRow(r2, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2151,8 +2138,7 @@ class UpdateBuilder {
         }
         return records.map((r2) => decodeRow(r2, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2206,8 +2192,7 @@ class DeleteBuilder {
         }
         return records.map((r2) => decodeRow(r2, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2284,7 +2269,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -2347,8 +2332,8 @@ class BunSqliteExecutor {
     return Promise.resolve(this.#client.prepare(sql2).get(...params));
   }
   run(sql2, params) {
-    this.#client.prepare(sql2).run(...params);
-    return Promise.resolve();
+    const result = this.#client.prepare(sql2).run(...params);
+    return Promise.resolve({ rowsAffected: result.changes });
   }
   transaction(fn) {
     this.#client.run("BEGIN");
@@ -3166,8 +3151,8 @@ class BetterSqlite3Executor {
     return Promise.resolve(this.#client.prepare(sql2).get(...params));
   }
   run(sql2, params) {
-    this.#client.prepare(sql2).run(...params);
-    return Promise.resolve();
+    const result = this.#client.prepare(sql2).run(...params);
+    return Promise.resolve({ rowsAffected: result.changes });
   }
   transaction(fn) {
     this.#client.exec("BEGIN");
@@ -9153,7 +9138,8 @@ class LibsqlExecutor {
     return result.rows[0] ?? null;
   }
   async run(sql2, params) {
-    await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    const result = await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    return { rowsAffected: result.rowsAffected };
   }
   async transaction(fn) {
     await this.#client.execute("BEGIN");
@@ -9231,7 +9217,8 @@ class LibsqlWebExecutor {
     return result.rows[0] ?? null;
   }
   async run(sql2, params) {
-    await this.#client.execute({ sql: sql2, args: sanitize2(params) });
+    const result = await this.#client.execute({ sql: sql2, args: sanitize2(params) });
+    return { rowsAffected: result.rowsAffected };
   }
   async transaction(fn) {
     await this.#client.execute("BEGIN");
@@ -11540,7 +11527,8 @@ class TursoSyncExecutor {
     return this.#db.get(sql2, ...sanitize3(params)) ?? null;
   }
   async run(sql2, params) {
-    await this.#db.run(sql2, ...sanitize3(params));
+    const result = await this.#db.run(sql2, ...sanitize3(params));
+    return { rowsAffected: result.changes };
   }
   async transaction(fn) {
     await this.#db.exec("BEGIN");
@@ -12130,7 +12118,8 @@ class TursoExecutor {
     return this.#db.get(sql2, ...sanitize4(params)) ?? null;
   }
   async run(sql2, params) {
-    await this.#db.run(sql2, ...sanitize4(params));
+    const result = await this.#db.run(sql2, ...sanitize4(params));
+    return { rowsAffected: result.changes };
   }
   async transaction(fn) {
     await this.#db.exec("BEGIN");

package/dist/src/entries/better-sqlite3.js

@@ -1037,18 +1037,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -1727,8 +1715,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1812,8 +1799,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1867,8 +1853,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1945,7 +1930,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -2007,8 +1992,8 @@ class BetterSqlite3Executor {
     return Promise.resolve(this.#client.prepare(sql2).get(...params));
   }
   run(sql2, params) {
-    this.#client.prepare(sql2).run(...params);
-    return Promise.resolve();
+    const result = this.#client.prepare(sql2).run(...params);
+    return Promise.resolve({ rowsAffected: result.changes });
   }
   transaction(fn) {
     this.#client.exec("BEGIN");

package/dist/src/entries/bun-sqlite.js

@@ -272,18 +272,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -962,8 +950,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1047,8 +1034,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1102,8 +1088,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1180,7 +1165,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -1243,8 +1228,8 @@ class BunSqliteExecutor {
     return Promise.resolve(this.#client.prepare(sql2).get(...params));
   }
   run(sql2, params) {
-    this.#client.prepare(sql2).run(...params);
-    return Promise.resolve();
+    const result = this.#client.prepare(sql2).run(...params);
+    return Promise.resolve({ rowsAffected: result.changes });
   }
   transaction(fn) {
     this.#client.run("BEGIN");

package/dist/src/entries/expressions.js

@@ -272,18 +272,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -962,8 +950,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1047,8 +1034,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1102,8 +1088,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1180,7 +1165,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),

package/dist/src/entries/libsql-web.js

@@ -5058,18 +5058,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -5748,8 +5736,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -5833,8 +5820,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -5888,8 +5874,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -5966,7 +5951,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient2(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -6033,7 +6018,8 @@ class LibsqlWebExecutor {
     return result.rows[0] ?? null;
   }
   async run(sql2, params) {
-    await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    const result = await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    return { rowsAffected: result.rowsAffected };
   }
   async transaction(fn) {
     await this.#client.execute("BEGIN");

package/dist/src/entries/libsql.js

@@ -6192,18 +6192,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -6882,8 +6870,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -6967,8 +6954,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -7022,8 +7008,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -7100,7 +7085,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient2(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -7173,7 +7158,8 @@ class LibsqlExecutor {
     return result.rows[0] ?? null;
   }
   async run(sql2, params) {
-    await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    const result = await this.#client.execute({ sql: sql2, args: sanitize(params) });
+    return { rowsAffected: result.rowsAffected };
   }
   async transaction(fn) {
     await this.#client.execute("BEGIN");

package/dist/src/entries/turso-sync.js

@@ -2493,18 +2493,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -3183,8 +3171,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -3268,8 +3255,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -3323,8 +3309,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -3401,7 +3386,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -3507,7 +3492,8 @@ class TursoSyncExecutor {
     return this.#db.get(sql2, ...sanitize(params)) ?? null;
   }
   async run(sql2, params) {
-    await this.#db.run(sql2, ...sanitize(params));
+    const result = await this.#db.run(sql2, ...sanitize(params));
+    return { rowsAffected: result.changes };
   }
   async transaction(fn) {
     await this.#db.exec("BEGIN");

package/dist/src/entries/turso.js

@@ -1374,18 +1374,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -2064,8 +2052,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2149,8 +2136,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2204,8 +2190,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -2282,7 +2267,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),
@@ -2387,7 +2372,8 @@ class TursoExecutor {
     return this.#db.get(sql2, ...sanitize(params)) ?? null;
   }
   async run(sql2, params) {
-    await this.#db.run(sql2, ...sanitize(params));
+    const result = await this.#db.run(sql2, ...sanitize(params));
+    return { rowsAffected: result.changes };
   }
   async transaction(fn) {
     await this.#db.exec("BEGIN");

package/dist/src/index.js

@@ -272,18 +272,6 @@ function resolveColumns(table, selectedColumns, prefix) {
   return entries.map(([, c]) => prefix ? `${prefix}.${c.name}` : c.name).join(", ");
 }
 
-class SelectFromBuilder {
-  #executor;
-  #conditions;
-  constructor(executor, conditions = []) {
-    this.#executor = executor;
-    this.#conditions = conditions;
-  }
-  from(table) {
-    return new SelectBuilder(this.#executor, table._.name, table, this.#conditions);
-  }
-}
-
 class SelectBuilder {
   #executor;
   #tableName;
@@ -962,8 +950,7 @@ class InsertBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1047,8 +1034,7 @@ class UpdateBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1102,8 +1088,7 @@ class DeleteBuilder {
         }
         return records.map((r) => decodeRow(r, this.#table));
       }
-      await this.#executor.run(sql, params);
-      return;
+      return await this.#executor.run(sql, params);
     } catch (e) {
       throw new FlintQueryError(`Failed to execute query: ${sql}`, e);
     }
@@ -1180,7 +1165,7 @@ var init_aggregates = () => {};
 // src/flint.ts
 function createClient(executor) {
   return {
-    select: () => new SelectFromBuilder(executor),
+    selectFrom: (table) => new SelectBuilder(executor, table._.name, table),
     insert: (table) => new InsertValuesBuilder(executor, table._.name, table),
     update: (table) => new UpdateSetBuilder(executor, table._.name, table),
     delete: (table) => new DeleteBuilder(executor, table._.name, table),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flint-orm",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "bin": {
     "flint": "./dist/src/cli.js"
   },
@@ -87,9 +87,17 @@
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {
-    "@libsql/client": { "optional": true },
-    "@tursodatabase/database": { "optional": true },
-    "@tursodatabase/sync": { "optional": true },
-    "better-sqlite3": { "optional": true }
+    "@libsql/client": {
+      "optional": true
+    },
+    "@tursodatabase/database": {
+      "optional": true
+    },
+    "@tursodatabase/sync": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    }
   }
 }