@gobing-ai/ts-db 0.1.8 → 0.2.2

package/README.md

@@ -1,30 +1,52 @@
 # @gobing-ai/ts-db
 
-Database abstraction layer — adapter pattern with Drizzle ORM, generic CRUD DAOs, job queue persistence, and migration tooling. Supports Bun SQLite (in-memory and file-based) and Cloudflare D1.
+A **drizzle-free database facade**: typed DAOs over Bun SQLite / Cloudflare D1, a small predicate query spec, single-source-of-truth tables, and migration tooling. Drizzle ORM powers it internally but never appears in your application code — so the storage layer is swappable without touching call sites.
+
+> **v0.2.0 is a breaking redesign.** The public `DbClient` interface and `adapter.getDb()` are removed; DAOs now take a `DbAdapter`; `where`/`orderBy` use a ts-db predicate spec instead of drizzle expressions. See [Migrating from 0.1.x](#migrating-from-01x).
 
 ## Overview
 
-`ts-db` provides a typed database layer decoupled from any specific storage engine. The `DbAdapter` interface abstracts Bun SQLite and Cloudflare D1 behind a common API, while `BaseDao`, `EntityDao`, and `QueueJobDao` provide progressively richer data access patterns.
+Application code imports only `@gobing-ai/ts-db` — never `drizzle-orm`. drizzle is an internal implementation detail, which keeps the storage engine swappable and the query surface small and auditable. Two tiers, your choice:
+
+- **Structured tier** (`EntityDao`) — typed `create`/`createMany`/`upsert`/`findById`/`findBy`/`update`/`delete`/`list`/`listByCursor`/`count`, filtered by a small predicate spec (`{ col, op, value }`).
+- **Raw tier** (`BaseDao`) — `query`/`one`/`tx` for table-agnostic access; ETL/analytics/reporting DAOs extend this directly.
+- **String-SQL escape** (`adapter.exec`/`run`/`queryFirst`/`queryAll`) — for DDL and dynamic identifiers only.
 
 | Component | Purpose |
 |-----------|---------|
-| `DbAdapter` | Unified interface across Bun SQLite and D1 |
+| `createDbAdapter` / `DbAdapter` | Construction + lifecycle + string-SQL escape; exposes an internal typed db to the DAO layer only |
 | `BunSqliteAdapter` | Bun SQLite implementation with statement caching and WAL pragmas |
 | `D1Adapter` | Cloudflare D1 implementation (no `@cloudflare/workers-types` dependency) |
-| `BaseDao` | Transaction + timestamp utilities for all DAOs |
-| `EntityDao` | Generic CRUD with soft delete, pagination, and `count()` |
+| `BaseDao` | Raw tier — `query`/`one`/`tx`, drizzle-free signatures |
+| `EntityDao` | Structured CRUD — predicate filters, soft delete, RETURNING, batch, upsert, cursor pagination, composite PK |
+| `defineTable` | Single source of truth — one table → drizzle table + derived zod insert/select schemas (optional peers) |
+| `Predicate` / `ListSpec` / `OrderTerm` | The drizzle-free query vocabulary |
 | `QueueJobDao` | Job queue persistence — `enqueue`, `claimReady`, `markCompleted`, `failExpiredJobs` |
 | `applyMigrations` | Drizzle migration runner (file-based + embedded fallback) |
-| `schema` | Reusable Drizzle column helpers + `queue_jobs` table definition |
+| `schema` helpers | `standardColumns`, `appendOnlyColumns`, soft-delete columns |
 | `SpanContext` | Re-exported from `@gobing-ai/ts-runtime` for telemetry |
 
+### Optional peers (validation)
+
+`defineTable`'s `insertSchema`/`selectSchema` and DAO validation require the **optional** peers `zod` and `drizzle-zod`. Install them only if you use validation; the DAOs and queries work without them.
+
+### Migrating from 0.1.x
+
+- `adapter.getDb()` → `adapter.db` (internal typed db; rarely needed directly).
+- `new SomeDao(adapter.getDb())` → `new SomeDao(adapter)` — DAOs now take the adapter, not a db handle.
+- `EntityDao` PK arg accepts an array: `super(adapter, table, [table.id], 'name')` (enables composite PKs).
+- `BaseDao.withTransaction` → `tx`.
+- `list({ where: eq(col, v) })` → `list({ where: { col, op: 'eq', value: v } })`.
+- `count(eq(col, v))` → `count({ col, op: 'eq', value: v })`.
+- `create`/`update` use `RETURNING`, so returned rows include DB-defaulted columns.
+
 ## Architecture
 
 ```mermaid
 classDiagram
     class DbAdapter {
         <<interface>>
-        +getDb() DbClient
+        +db InternalDb (internal)
         +exec(sql) void
         +run(sql, ...params) void
         +queryFirst(sql, ...params) T?
@@ -49,21 +71,22 @@ classDiagram
         <<abstract>>
         #db
         +now() number
-        +withTransaction(fn) T
+        +tx(fn) T
+        +query(table, spec) T[]
+        +one(table, where) T?
     }
 
     class EntityDao {
         +create(data) TSelect
+        +createMany(rows) TSelect[]
+        +upsert(data, conflict) TSelect
         +findById(id) TSelect?
-        +findAll() TSelect[]
         +update(id, data) TSelect?
         +delete(id, soft?) TSelect?
         +findBy(column, value) TSelect?
-        +findAllBy(column, value) TSelect[]
-        +list(opts) TSelect[]
+        +list(spec) TSelect[]
+        +listByCursor(spec) Page
         +count(where?) number
-        #hasSoftDelete boolean
-        #activeCondition SQL?
     }
 
     class QueueJobDao {
@@ -154,8 +177,8 @@ const users = sqliteTable('users', {
 });
 
 class UsersDao extends EntityDao<typeof users, typeof users.id> {
-    constructor(db: DbClient) {
-        super(db, users, users.id, 'users');
+    constructor(adapter: DbAdapter) {
+        super(adapter, users, [users.id], 'users');
     }
 
     async findByEmail(email: string) {
@@ -164,7 +187,7 @@ class UsersDao extends EntityDao<typeof users, typeof users.id> {
 }
 
 // Usage
-const dao = new UsersDao(adapter.getDb());
+const dao = new UsersDao(adapter);
 const user = await dao.create({ id: 'u1', name: 'Alice', email: 'a@test.com' });
 const found = await dao.findById('u1');
 const updated = await dao.update('u1', { name: 'Alice Updated' });
@@ -180,7 +203,7 @@ await dao.delete('u1'); // soft delete if table has `inUsed` column
 ```ts
 import { QueueJobDao } from '@gobing-ai/ts-db';
 
-const queue = new QueueJobDao(adapter.getDb());
+const queue = new QueueJobDao(adapter);
 
 // Enqueue
 const jobId = await queue.enqueue('send-email', { to: 'user@test.com' }, { maxRetries: 5 });
@@ -275,13 +298,13 @@ export const todos = sqliteTable('todos', {
 
 ```ts
 // src/todos-dao.ts
-import type { DbClient } from '@gobing-ai/ts-db';
+import type { DbAdapter } from '@gobing-ai/ts-db';
 import { EntityDao } from '@gobing-ai/ts-db';
 import { todos } from './schema';
 
 export class TodosDao extends EntityDao<typeof todos, typeof todos.id> {
-    constructor(db: DbClient) {
-        super(db, todos, todos.id, 'todos');
+    constructor(adapter: DbAdapter) {
+        super(adapter, todos, [todos.id], 'todos');
     }
 
     async findPending() {
@@ -304,7 +327,7 @@ import { TodosDao } from './todos-dao';
 const adapter = await createDbAdapter({ driver: 'bun-sqlite', url: ':memory:' });
 await applyMigrations(adapter);
 
-const todos = new TodosDao(adapter.getDb());
+const todos = new TodosDao(adapter);
 
 await todos.create({ id: '1', title: 'Learn ts-db' });
 await todos.create({ id: '2', title: 'Build something' });

package/dist/adapter.d.ts

@@ -1,3 +1,5 @@
+import type { BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
+import type { DrizzleD1Database } from 'drizzle-orm/d1';
 /**
  * Minimal D1 binding interface — avoids depending on @cloudflare/workers-types.
  */
@@ -6,61 +8,39 @@ interface D1Binding {
     exec(sql: string): Promise<void>;
 }
 /**
- * Generic database table descriptor carrying select and insert type info.
+ * Internal typed drizzle database handle.
+ *
+ * This is the REAL drizzle database (bun:sqlite or D1 flavour), fully typed.
+ * It is `@internal` — ts-db's DAO base classes use it to build queries, but it
+ * is never part of the public API. Consumers depend only on the ts-db facade
+ * (DAOs, the predicate spec), never on drizzle types directly. (G1)
+ *
+ * @internal
  */
-export interface DbTable<TSelect, TInsert = TSelect> {
-    readonly $inferSelect: TSelect;
-    readonly $inferInsert: TInsert;
-}
-type DbInsertBuilder<TTable extends DbTable<unknown, unknown>> = {
-    values(values: TTable['$inferInsert'] | TTable['$inferInsert'][]): PromiseLike<unknown>;
-};
-interface DbSelectWhereResult<TTable extends DbTable<unknown, unknown>> extends PromiseLike<TTable['$inferSelect'][]> {
-    limit(value: number): DbSelectWhereResult<TTable>;
-    offset(value: number): DbSelectWhereResult<TTable>;
-    orderBy(column: unknown): DbSelectWhereResult<TTable>;
-}
-type DbSelectFromResult<TTable extends DbTable<unknown, unknown>> = DbSelectWhereResult<TTable> & {
-    where(condition: unknown): DbSelectWhereResult<TTable>;
-};
-type DbSelectBuilder = {
-    from<TTable extends DbTable<unknown, unknown>>(table: TTable): DbSelectFromResult<TTable>;
-};
-type DbProjectionSelectBuilder<TProjection> = {
-    from(table: DbTable<unknown, unknown>): PromiseLike<TProjection[]> & {
-        where(condition: unknown): PromiseLike<TProjection[]>;
-    };
-};
-interface DbUpdateResult {
-    changes: number;
-}
-interface DbUpdateBuilder<TTable extends DbTable<unknown, unknown>> {
-    set(values: Partial<TTable['$inferInsert']>): {
-        where(condition: unknown): PromiseLike<DbUpdateResult>;
-    };
-}
-/**
- * Abstract database client with insert/select/update/delete query builders.
- */
-export interface DbClient {
-    insert<TTable extends DbTable<unknown, unknown>>(table: TTable): DbInsertBuilder<TTable>;
-    select(): DbSelectBuilder;
-    select<TProjection>(projection: Record<string, unknown>): DbProjectionSelectBuilder<TProjection>;
-    update<TTable extends DbTable<unknown, unknown>>(table: TTable): DbUpdateBuilder<TTable>;
-    delete<TTable extends DbTable<unknown, unknown>>(table: TTable): {
-        where(condition: unknown): PromiseLike<DbUpdateResult>;
-    };
-}
+export type InternalDb = BunSQLiteDatabase<Record<string, unknown>> | DrizzleD1Database<Record<string, unknown>>;
 /**
- * Database adapter providing a unified client, raw SQL exec, and lifecycle management.
+ * Database adapter: construction, lifecycle, the internal typed drizzle db, and a
+ * raw string-SQL escape for DDL / dynamic identifiers.
+ *
+ * The internal drizzle db (`db`) is exposed only to ts-db's own DAO layer; the
+ * string-SQL methods are the sole raw escape, intended for DDL and dynamic
+ * identifiers and gated to DAO files by a consumer-side lint rule.
  */
 export interface DbAdapter {
-    getDb(): DbClient;
+    /**
+     * The internal typed drizzle database. ts-db DAO layer only — not public API.
+     * @internal
+     */
+    readonly db: InternalDb;
+    /** Run a raw SQL statement with no parameters (DDL). */
     exec(sql: string): Promise<void>;
     /** Parameterized write (INSERT/UPDATE/DELETE) that returns no rows. */
     run(sql: string, ...params: unknown[]): Promise<void>;
+    /** Parameterized read returning the first row, or undefined. */
     queryFirst<T>(sql: string, ...params: unknown[]): Promise<T | undefined>;
+    /** Parameterized read returning all rows. */
     queryAll<T>(sql: string, ...params: unknown[]): Promise<T[]>;
+    /** Close the underlying connection. */
     close(): void;
 }
 /**

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,SAAS;IACf,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAC/C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAClC;AAED,KAAK,eAAe,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI;IAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CAC3F,CAAC;AAEF,UAAU,mBAAmB,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAE,SAAQ,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;IACjH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;CACzD;AAED,KAAK,kBAAkB,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,GAAG;IAC9F,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;CAC1D,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,IAAI,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;CAC7F,CAAC;AAEF,KAAK,yBAAyB,CAAC,WAAW,IAAI;IAC1C,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,GAAG;QACjE,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;KACzD,CAAC;CACL,CAAC;AAEF,UAAU,cAAc;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC;IAC9D,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC;CAC5G;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACzF,MAAM,IAAI,eAAe,CAAC;IAC1B,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACjG,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACzF,MAAM,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAC3C,KAAK,EAAE,MAAM,GACd;QACC,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;KAC1D,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,KAAK,IAAI,QAAQ,CAAC;IAClB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uEAAuE;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB;IACI,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL,GACD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAcjF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,UAAU,SAAS;IACf,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjH;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,wDAAwD;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uEAAuE;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,gEAAgE;IAChE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzE,6CAA6C;IAC7C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,uCAAuC;IACvC,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB;IACI,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL,GACD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAcjF"}

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

@@ -1,5 +1,5 @@
 import { type BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
-import type { DbAdapter, DbClient } from '../adapter';
+import type { DbAdapter, InternalDb } from '../adapter';
 import * as schema from '../schema/index';
 /**
  * Configuration options for the bun:sqlite adapter (path, pragmas).
@@ -28,7 +28,8 @@ export declare class BunSqliteAdapter implements DbAdapter {
     private readonly stmtCache;
     private getStatement;
     constructor(options?: BunSqliteOptions);
-    getDb(): DbClient;
+    /** The internal typed drizzle database (ts-db DAO layer + migrations only). */
+    get db(): InternalDb;
     /** Returns the underlying drizzle instance for migration operations. */
     getDrizzleDb(): BunSQLiteDatabase<typeof schema>;
     exec(sql: string): Promise<void>;

package/dist/adapters/bun-sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../src/adapters/bun-sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAW,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAS1C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAUD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAmC;IACpD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,OAAO,CAAC,YAAY;gBAUR,OAAO,CAAC,EAAE,gBAAgB;IAkBtC,KAAK,IAAI,QAAQ;IAIjB,wEAAwE;IACxE,YAAY,IAAI,iBAAiB,CAAC,OAAO,MAAM,CAAC;IAI1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKxE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKlE,KAAK,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../src/adapters/bun-sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAW,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAS1C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAUD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAmC;IACpD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,OAAO,CAAC,YAAY;gBAUR,OAAO,CAAC,EAAE,gBAAgB;IAkBtC,+EAA+E;IAC/E,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,wEAAwE;IACxE,YAAY,IAAI,iBAAiB,CAAC,OAAO,MAAM,CAAC;IAI1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKxE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKlE,KAAK,IAAI,IAAI;CAGhB"}

package/dist/adapters/bun-sqlite.js

@@ -42,7 +42,8 @@ export class BunSqliteAdapter {
         this.sqlite.run(pragmas.foreignKeys);
         this.drizzleDb = drizzle({ client: this.sqlite, schema });
     }
-    getDb() {
+    /** The internal typed drizzle database (ts-db DAO layer + migrations only). */
+    get db() {
         return this.drizzleDb;
     }
     /** Returns the underlying drizzle instance for migration operations. */

package/dist/adapters/d1.d.ts

@@ -1,4 +1,6 @@
-import type { DbAdapter, DbClient } from '../adapter';
+import { type DrizzleD1Database } from 'drizzle-orm/d1';
+import type { DbAdapter, InternalDb } from '../adapter';
+import * as schema from '../schema/index';
 /**
  * Minimal D1 binding interface — avoids depending on @cloudflare/workers-types.
  */
@@ -35,7 +37,10 @@ export declare class D1Adapter implements DbAdapter {
     private binding;
     private drizzleDb;
     constructor(binding: D1Binding);
-    getDb(): DbClient;
+    /** The internal typed drizzle database (ts-db DAO layer only). */
+    get db(): InternalDb;
+    /** Returns the underlying drizzle instance for migration operations. */
+    getDrizzleDb(): DrizzleD1Database<typeof schema>;
     /** Returns the non-mutating binding for advanced direct D1 calls. */
     getBinding(): D1Binding;
     exec(sql: string): Promise<void>;

package/dist/adapters/d1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d1.d.ts","sourceRoot":"","sources":["../../src/adapters/d1.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAClB,IAAI,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC;QAC7C,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAC7D,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,UAAU,gBAAgB;IACtB,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvB,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,SAAS;IACvC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAmC;gBAExC,OAAO,EAAE,SAAS;IAK9B,KAAK,IAAI,QAAQ;IAIjB,qEAAqE;IACrE,UAAU,IAAI,SAAS;IAIjB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAQxE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOlE,KAAK,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"d1.d.ts","sourceRoot":"","sources":["../../src/adapters/d1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAW,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAClB,IAAI,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC;QAC7C,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAC7D,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,UAAU,gBAAgB;IACtB,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvB,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,SAAS;IACvC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAmC;gBAExC,OAAO,EAAE,SAAS;IAK9B,kEAAkE;IAClE,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,wEAAwE;IACxE,YAAY,IAAI,iBAAiB,CAAC,OAAO,MAAM,CAAC;IAIhD,qEAAqE;IACrE,UAAU,IAAI,SAAS;IAIjB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAQxE,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOlE,KAAK,IAAI,IAAI;CAGhB"}

package/dist/adapters/d1.js

@@ -13,7 +13,12 @@ export class D1Adapter {
         this.binding = binding;
         this.drizzleDb = drizzle(this.binding, { schema });
     }
-    getDb() {
+    /** The internal typed drizzle database (ts-db DAO layer only). */
+    get db() {
+        return this.drizzleDb;
+    }
+    /** Returns the underlying drizzle instance for migration operations. */
+    getDrizzleDb() {
         return this.drizzleDb;
     }
     /** Returns the non-mutating binding for advanced direct D1 calls. */

package/dist/base-dao.d.ts

@@ -1,27 +1,47 @@
-import type { DbClient } from './adapter';
+import type { SQLiteTable } from 'drizzle-orm/sqlite-core';
+import type { DbAdapter, InternalDb } from './adapter';
+import { type ListSpec, type Predicate } from './query-spec';
 /**
- * Abstract base DAO providing transaction and timestamp utilities to all entity DAOs.
+ * A transaction-scoped handle passed to {@link BaseDao.tx} callbacks.
+ *
+ * Drizzle-free by design — exposes the same internal db shape DAOs use, so a
+ * transactional block can run the same structured/raw operations. (G3)
+ *
+ * @internal
+ */
+export type TxHandle = InternalDb;
+/**
+ * Abstract base DAO — the RAW tier of the ts-db facade.
+ *
+ * Owns the adapter and provides generic, table-agnostic data access:
+ * transactions and parameterized queries expressed through the ts-db predicate
+ * spec (never drizzle's `sql` tag). ETL / analytics / reporting DAOs extend this
+ * directly; {@link EntityDao} extends it to add typed CRUD over a single table.
+ *
+ * All signatures are ts-db's own vocabulary — drizzle never leaks to consumers. (G1)
  */
 export declare abstract class BaseDao {
-    protected readonly db: DbClient;
-    /**
-     * DB transaction utility for subclasses.
-     *
-     * Constructor is `protected` — instantiate through concrete DAO subclasses,
-     * not BaseDao directly. Tests must declare an explicit public constructor
-     * that calls `super(db)` to expose the protected constructor publicly.
-     */
-    protected constructor(db: DbClient);
+    protected readonly adapter: DbAdapter;
+    protected constructor(adapter: DbAdapter);
+    /** The internal typed drizzle db. Subclasses use it to build queries. @internal */
+    protected get db(): InternalDb;
+    /** Current timestamp in milliseconds (audit columns, etc.). */
     protected now(): number;
     /**
      * Execute a function within a database transaction.
      *
-     * Works uniformly on both D1 (async) and bun:sqlite (sync wrapped in promise).
-     * The callback receives a transaction-scoped DbClient.
+     * Works uniformly on bun:sqlite (sync, wrapped in a promise) and D1 (async).
+     * The callback receives a transaction-scoped db handle.
+     */
+    protected tx<T>(fn: (tx: TxHandle) => Promise<T>): Promise<T>;
+    /**
+     * Run a SELECT against a table, filtered/ordered/paged by a {@link ListSpec}.
      *
-     * @param fn - Function to execute within the transaction.
-     * @returns The return value of `fn`.
+     * The raw-tier read primitive: drizzle-free input, typed rows out. Subclasses
+     * pass their table; `EntityDao` builds on this for `list`.
      */
-    protected withTransaction<T>(fn: (tx: DbClient) => Promise<T>): Promise<T>;
+    protected query<T>(table: SQLiteTable, spec?: ListSpec): Promise<T[]>;
+    /** Run a SELECT and return the first matching row, or undefined. */
+    protected one<T>(table: SQLiteTable, where: Predicate): Promise<T | undefined>;
 }
 //# sourceMappingURL=base-dao.d.ts.map

package/dist/base-dao.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-dao.d.ts","sourceRoot":"","sources":["../src/base-dao.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;GAEG;AACH,8BAAsB,OAAO;IAQH,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ;IAPrD;;;;;;OAMG;IACH,SAAS,aAAgC,EAAE,EAAE,QAAQ;IAErD,SAAS,CAAC,GAAG,IAAI,MAAM;IAIvB;;;;;;;;OAQG;cACa,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQnF"}
+{"version":3,"file":"base-dao.d.ts","sourceRoot":"","sources":["../src/base-dao.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAoC,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/F;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC;;;;;;;;;GASG;AACH,8BAAsB,OAAO;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS;IAA3D,SAAS,aAAgC,OAAO,EAAE,SAAS;IAE3D,mFAAmF;IACnF,SAAS,KAAK,EAAE,IAAI,UAAU,CAE7B;IAED,+DAA+D;IAC/D,SAAS,CAAC,GAAG,IAAI,MAAM;IAIvB;;;;;OAKG;cACa,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMnE;;;;;OAKG;cACa,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAkB/E,oEAAoE;cACpD,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAIvF"}

package/dist/base-dao.js

@@ -1,34 +1,60 @@
+import { compileOrderBy, compilePredicate } from './query-spec.js';
 /**
- * Abstract base DAO providing transaction and timestamp utilities to all entity DAOs.
+ * Abstract base DAO — the RAW tier of the ts-db facade.
+ *
+ * Owns the adapter and provides generic, table-agnostic data access:
+ * transactions and parameterized queries expressed through the ts-db predicate
+ * spec (never drizzle's `sql` tag). ETL / analytics / reporting DAOs extend this
+ * directly; {@link EntityDao} extends it to add typed CRUD over a single table.
+ *
+ * All signatures are ts-db's own vocabulary — drizzle never leaks to consumers. (G1)
  */
 export class BaseDao {
-    db;
-    /**
-     * DB transaction utility for subclasses.
-     *
-     * Constructor is `protected` — instantiate through concrete DAO subclasses,
-     * not BaseDao directly. Tests must declare an explicit public constructor
-     * that calls `super(db)` to expose the protected constructor publicly.
-     */
-    constructor(db) {
-        this.db = db;
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    /** The internal typed drizzle db. Subclasses use it to build queries. @internal */
+    get db() {
+        return this.adapter.db;
     }
+    /** Current timestamp in milliseconds (audit columns, etc.). */
     now() {
         return Date.now();
     }
     /**
      * Execute a function within a database transaction.
      *
-     * Works uniformly on both D1 (async) and bun:sqlite (sync wrapped in promise).
-     * The callback receives a transaction-scoped DbClient.
+     * Works uniformly on bun:sqlite (sync, wrapped in a promise) and D1 (async).
+     * The callback receives a transaction-scoped db handle.
+     */
+    async tx(fn) {
+        return this.db.transaction((tx) => fn(tx));
+    }
+    /**
+     * Run a SELECT against a table, filtered/ordered/paged by a {@link ListSpec}.
      *
-     * @param fn - Function to execute within the transaction.
-     * @returns The return value of `fn`.
+     * The raw-tier read primitive: drizzle-free input, typed rows out. Subclasses
+     * pass their table; `EntityDao` builds on this for `list`.
      */
-    async withTransaction(fn) {
-        // Drizzle's .transaction() works on both backends:
-        // - bun:sqlite: sync wrapped in a promise
-        // - D1: native async
-        return this.db.transaction(async (tx) => fn(tx));
+    async query(table, spec = {}) {
+        const condition = spec.where ? compilePredicate(spec.where) : undefined;
+        const order = spec.orderBy ? compileOrderBy(spec.orderBy) : [];
+        // drizzle's fluent builder is internal here; the public input is the spec.
+        let q = this.db.select().from(table);
+        if (condition)
+            q = q.where(condition);
+        if (order.length > 0)
+            q = q.orderBy(...order);
+        if (spec.limit !== undefined)
+            q = q.limit(spec.limit);
+        if (spec.offset !== undefined)
+            q = q.offset(spec.offset);
+        return (await q) ?? [];
+    }
+    /** Run a SELECT and return the first matching row, or undefined. */
+    async one(table, where) {
+        const rows = await this.query(table, { where, limit: 1 });
+        return rows[0];
     }
 }

package/dist/define-table.d.ts

@@ -0,0 +1,40 @@
+import { type SQLiteColumnBuilderBase, sqliteTable } from 'drizzle-orm/sqlite-core';
+import type { ZodType } from 'zod';
+/**
+ * A table definition bundled with its drizzle-zod validation schemas.
+ *
+ * The single source of truth (G2): one table authored once yields the drizzle
+ * table (for queries/migrations) plus insert/select zod schemas (for boundary
+ * validation), with no parallel re-authoring.
+ *
+ * The zod schemas are derived lazily — only materialised the first time they are
+ * read — so a consumer that only needs the table pays nothing extra.
+ *
+ * `defineTable`, `insertSchema`, and `selectSchema` require the optional peers
+ * `zod` and `drizzle-zod`. Consumers that never validate need not install them
+ * and simply use `createDbAdapter` + raw `sqliteTable` + the column helpers.
+ */
+export interface DefinedTable<TTable> {
+    /** The underlying drizzle table — pass to DAOs, migrations, queries. */
+    readonly table: TTable;
+    /** Zod schema validating a row for insertion. */
+    readonly insertSchema: ZodType;
+    /** Zod schema validating a selected row. */
+    readonly selectSchema: ZodType;
+}
+/**
+ * Define a SQLite table and derive its validation schemas in one place (G2).
+ *
+ * @example
+ * ```ts
+ * export const users = defineTable('users', {
+ *     id: text('id').primaryKey(),
+ *     email: text('email').notNull().unique(),
+ *     ...standardColumns,
+ * });
+ * users.table          // drizzle table for DAOs/migrations
+ * users.insertSchema   // zod schema derived from the table
+ * ```
+ */
+export declare function defineTable<TName extends string, TColumns extends Record<string, SQLiteColumnBuilderBase>>(name: TName, columns: TColumns): DefinedTable<ReturnType<typeof sqliteTable<TName, TColumns>>>;
+//# sourceMappingURL=define-table.d.ts.map

package/dist/define-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-table.d.ts","sourceRoot":"","sources":["../src/define-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM;IAChC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,EACtG,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,GAClB,YAAY,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAqB/D"}

package/dist/define-table.js

@@ -0,0 +1,36 @@
+import { sqliteTable } from 'drizzle-orm/sqlite-core';
+import { createInsertSchema, createSelectSchema } from 'drizzle-zod';
+/**
+ * Define a SQLite table and derive its validation schemas in one place (G2).
+ *
+ * @example
+ * ```ts
+ * export const users = defineTable('users', {
+ *     id: text('id').primaryKey(),
+ *     email: text('email').notNull().unique(),
+ *     ...standardColumns,
+ * });
+ * users.table          // drizzle table for DAOs/migrations
+ * users.insertSchema   // zod schema derived from the table
+ * ```
+ */
+export function defineTable(name, columns) {
+    const table = sqliteTable(name, columns);
+    let insert;
+    let select;
+    return {
+        table,
+        get insertSchema() {
+            if (insert === undefined) {
+                insert = createInsertSchema(table);
+            }
+            return insert;
+        },
+        get selectSchema() {
+            if (select === undefined) {
+                select = createSelectSchema(table);
+            }
+            return select;
+        },
+    };
+}