@gobing-ai/ts-db 0.4.27 → 0.4.30

package/README.md

@@ -6,7 +6,9 @@ A **drizzle-free database facade**: typed DAOs over Bun SQLite / Cloudflare D1,
 
 ## Overview
 
-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:
+Data-access code imports the main `@gobing-ai/ts-db` facade; schema definitions import
+`@gobing-ai/ts-db/schema`. Consumer code never imports `drizzle-orm` directly, 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.
@@ -16,15 +18,15 @@ Application code imports only `@gobing-ai/ts-db` — never `drizzle-orm`. drizzl
 |-----------|---------|
 | `createDbAdapter` / `DbAdapter` | Construction + lifecycle + string-SQL escape + atomic batch; exposes an internal typed db to the DAO layer only |
 | `BunSqliteAdapter` | Bun SQLite implementation with statement caching and WAL pragmas (`@gobing-ai/ts-db/bun-sqlite`) |
-| `D1Adapter` | Cloudflare D1 implementation (no `@cloudflare/workers-types` dependency) |
+| `D1Adapter` | Cloudflare D1 implementation (`@gobing-ai/ts-db/d1`; no `@cloudflare/workers-types` dependency) |
 | `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) |
+| `defineTable` | Single source of truth — one table → drizzle table + derived zod insert/select schemas (`@gobing-ai/ts-db/schema`; optional peers) |
 | `Predicate` / `ListSpec` / `OrderTerm` | The drizzle-free query vocabulary |
 | `QueueJobDao` | Job queue persistence — `enqueue`, `claimReady`, `markCompleted`, `failExpiredJobs` |
 | `InboxMessageDao` | Durable inter-agent message persistence (`@gobing-ai/ts-db/inbox`) |
 | `applyMigrations` | Drizzle migration runner (file-based + embedded fallback) |
-| `schema` helpers | `standardColumns`, `appendOnlyColumns`, soft-delete columns |
+| `schema` helpers | `standardColumns`, `appendOnlyColumns`, soft-delete columns (`@gobing-ai/ts-db/schema`) |
 | `SpanContext` | Re-exported from `@gobing-ai/ts-runtime` for telemetry |
 
 ### Optional peers (validation)
@@ -187,18 +189,18 @@ await adapter.batch([
 ```
 ### EntityDao — CRUD with soft delete
 
-Define a Drizzle table, extend `EntityDao`, get full CRUD for free:
+Define a table through the schema subpath, extend `EntityDao`, get full CRUD for free:
 
 ```ts
-import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core';
-import { EntityDao, standardColumns } from '@gobing-ai/ts-db';
+import { type DbAdapter, EntityDao } from '@gobing-ai/ts-db';
+import { defineTable, standardColumns, text } from '@gobing-ai/ts-db/schema';
 
-const users = sqliteTable('users', {
+const users = defineTable('users', {
     id: text('id').primaryKey(),
     name: text('name').notNull(),
     email: text('email').notNull(),
     ...standardColumns,
-});
+}).table;
 
 class UsersDao extends EntityDao<typeof users, typeof users.id> {
     constructor(adapter: DbAdapter) {
@@ -347,22 +349,28 @@ await applyMigrations(adapter);
 ### Schema helpers
 
 ```ts
-import { sqliteTable, text } from 'drizzle-orm/sqlite-core';
-import { standardColumns, standardColumnsWithSoftDelete, queueJobs, inboxMessages } from '@gobing-ai/ts-db';
+import {
+    defineTable,
+    inboxMessages,
+    queueJobs,
+    standardColumns,
+    standardColumnsWithSoftDelete,
+    text,
+} from '@gobing-ai/ts-db/schema';
 
 // Standard columns (createdAt, updatedAt)
-const docs = sqliteTable('docs', {
+const docs = defineTable('docs', {
     id: text('id').primaryKey(),
     title: text('title').notNull(),
     ...standardColumns,
-});
+}).table;
 
 // With soft delete (adds inUsed column)
-const projects = sqliteTable('projects', {
+const projects = defineTable('projects', {
     id: text('id').primaryKey(),
     name: text('name').notNull(),
     ...standardColumnsWithSoftDelete,
-});
+}).table;
 
 // queue_jobs table is pre-built for use with QueueJobDao
 
@@ -382,15 +390,14 @@ bun add -D drizzle-kit
 
 ```ts
 // src/schema.ts
-import { sqliteTable, text } from 'drizzle-orm/sqlite-core';
-import { standardColumns } from '@gobing-ai/ts-db';
+import { defineTable, standardColumns, text } from '@gobing-ai/ts-db/schema';
 
-export const todos = sqliteTable('todos', {
+export const todos = defineTable('todos', {
     id: text('id').primaryKey(),
     title: text('title').notNull(),
     done: text('done').notNull().default('0'),
     ...standardColumns,
-});
+}).table;
 ```
 
 ### Create a DAO

package/dist/inbox-message-dao.d.ts

@@ -63,7 +63,9 @@ export declare class InboxMessageDao extends EntityDao<typeof inboxMessages, typ
     private readonly events?;
     constructor(adapter: DbAdapter, options?: InboxMessageDaoOptions);
     enqueue(fromId: string | null, toId: string, body: string, inReplyTo?: string): Promise<string>;
-    drainPending(toId: string): Promise<InboxMessage[]>;
+    drainPending(toId: string, options?: {
+        limit?: number;
+    }): Promise<InboxMessage[]>;
     markDelivered(msgId: string): Promise<void>;
     markFailed(msgId: string, error: string): Promise<void>;
     inbox(toId: string, limit?: number, offset?: number): Promise<InboxMessage[]>;

package/dist/inbox-message-dao.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-message-dao.d.ts","sourceRoot":"","sources":["../src/inbox-message-dao.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inbox-message-dao.d.ts","sourceRoot":"","sources":["../src/inbox-message-dao.ts"],"names":[],"mappings":"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"}

package/dist/inbox-message-dao.js

@@ -41,7 +41,13 @@ export class InboxMessageDao extends EntityDao {
         });
         return id;
     }
-    async drainPending(toId) {
+    async drainPending(toId, options) {
+        // A backed-up inbox is claimed in pages of at most `limit` (default 100) so one
+        // recipient's queue cannot be monopolised by a single drain (task 0060 F10).
+        const limit = options?.limit ?? 100;
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new RangeError(`drainPending limit must be a positive integer; received ${limit}`);
+        }
         const now = this.now();
         const rows = (await this.db
             .update(inboxMessages)
@@ -56,6 +62,7 @@ export class InboxMessageDao extends EntityDao {
                     WHERE to_id = ${toId}
                       AND status = 'queued'
                     ORDER BY created_at
+                    LIMIT ${limit}
                 )
                 AND ${inboxMessages.status} = 'queued'`)
             .returning());

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { createDbAdapter, type DbAdapter, type DbAdapterConfig, type DbBatchOp, type InternalDb } from './adapter';
-export { D1Adapter } from './adapters/d1';
 export { BaseDao, type TxHandle } from './base-dao';
 export { type EmbeddedMigration, embeddedMigrations } from './embedded-migrations';
 export { type CursorListSpec, type DaoValidator, EntityDao, type EntityDaoOptions, type EntityListSpec, type EntityTable, type PKColumn, type PKValue, type SoftDeletableTable, } from './entity-dao';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACnH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,KAAK,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,kBAAkB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EACH,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,KAAK,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,kBAAkB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EACH,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
 export { createDbAdapter } from './adapter.js';
-export { D1Adapter } from './adapters/d1.js';
 export { BaseDao } from './base-dao.js';
 export { embeddedMigrations } from './embedded-migrations.js';
 export { EntityDao, } from './entity-dao.js';

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

@@ -12,11 +12,8 @@ import type { ZodType } from 'zod';
  * time they are read — so a consumer that only needs the table pays nothing
  * extra.
  *
- * `defineTable`, `insertSchema`, `selectSchema`, and `createTableSql` require
- * the optional peers `zod` and `drizzle-zod`. Consumers that never validate and
- * don't need generated DDL can use `createDbAdapter` + raw `sqliteTable` +
- * column helpers without installing those peers. Import from
- * `@gobing-ai/ts-db/schema` to opt in.
+ * The `/schema` subpath requires the optional peers `zod` and `drizzle-zod`.
+ * Consumers using only the main facade do not need them.
  */
 export interface DefinedTable<TTable> {
     /** The underlying drizzle table — pass to DAOs, migrations, queries. */
@@ -33,7 +30,7 @@ export interface DefinedTable<TTable> {
  *
  * @example
  * ```ts
- * import { defineTable } from '@gobing-ai/ts-db/schema';
+ * import { defineTable, standardColumns, text } from '@gobing-ai/ts-db/schema';
  *
  * export const users = defineTable('users', {
  *     id: text('id').primaryKey(),

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

@@ -1 +1 @@
-{"version":3,"file":"define-table.d.ts","sourceRoot":"","sources":["../../src/schema/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;AAGnC;;;;;;;;;;;;;;;;;GAiBG;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;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;GAgBG;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,CA4B/D"}
+{"version":3,"file":"define-table.d.ts","sourceRoot":"","sources":["../../src/schema/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;AAGnC;;;;;;;;;;;;;;GAcG;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;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;GAgBG;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,CA4B/D"}

package/dist/schema/define-table.js

@@ -6,7 +6,7 @@ import { generateCreateTableSql } from './ddl.js';
  *
  * @example
  * ```ts
- * import { defineTable } from '@gobing-ai/ts-db/schema';
+ * import { defineTable, standardColumns, text } from '@gobing-ai/ts-db/schema';
  *
  * export const users = defineTable('users', {
  *     id: text('id').primaryKey(),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-db",
-    "version": "0.4.27",
+    "version": "0.4.30",
     "description": "@gobing-ai/ts-db — a drizzle-free database facade: typed DAOs over Bun SQLite / Cloudflare D1, a small predicate query spec, single-source-of-truth tables, and migrations. Drizzle stays an internal detail.",
     "keywords": [
         "typescript",
@@ -66,8 +66,8 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-db-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-runtime": "^0.4.27",
-        "@gobing-ai/ts-utils": "^0.4.27"
+        "@gobing-ai/ts-runtime": "^0.4.30",
+        "@gobing-ai/ts-utils": "^0.4.30"
     },
     "peerDependencies": {
         "drizzle-orm": ">=0.38.0",

package/src/inbox-message-dao.ts

@@ -118,7 +118,13 @@ export class InboxMessageDao extends EntityDao<typeof inboxMessages, typeof inbo
         return id;
     }
 
-    async drainPending(toId: string): Promise<InboxMessage[]> {
+    async drainPending(toId: string, options?: { limit?: number }): Promise<InboxMessage[]> {
+        // A backed-up inbox is claimed in pages of at most `limit` (default 100) so one
+        // recipient's queue cannot be monopolised by a single drain (task 0060 F10).
+        const limit = options?.limit ?? 100;
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new RangeError(`drainPending limit must be a positive integer; received ${limit}`);
+        }
         const now = this.now();
         const rows = (await (this.db as UpdateReturningDb)
             .update(inboxMessages)
@@ -134,6 +140,7 @@ export class InboxMessageDao extends EntityDao<typeof inboxMessages, typeof inbo
                     WHERE to_id = ${toId}
                       AND status = 'queued'
                     ORDER BY created_at
+                    LIMIT ${limit}
                 )
                 AND ${inboxMessages.status} = 'queued'`,
             )

package/src/index.ts

@@ -1,5 +1,4 @@
 export { createDbAdapter, type DbAdapter, type DbAdapterConfig, type DbBatchOp, type InternalDb } from './adapter';
-export { D1Adapter } from './adapters/d1';
 export { BaseDao, type TxHandle } from './base-dao';
 
 export { type EmbeddedMigration, embeddedMigrations } from './embedded-migrations';

package/src/schema/define-table.ts

@@ -15,11 +15,8 @@ import { generateCreateTableSql } from './ddl';
  * time they are read — so a consumer that only needs the table pays nothing
  * extra.
  *
- * `defineTable`, `insertSchema`, `selectSchema`, and `createTableSql` require
- * the optional peers `zod` and `drizzle-zod`. Consumers that never validate and
- * don't need generated DDL can use `createDbAdapter` + raw `sqliteTable` +
- * column helpers without installing those peers. Import from
- * `@gobing-ai/ts-db/schema` to opt in.
+ * The `/schema` subpath requires the optional peers `zod` and `drizzle-zod`.
+ * Consumers using only the main facade do not need them.
  */
 export interface DefinedTable<TTable> {
     /** The underlying drizzle table — pass to DAOs, migrations, queries. */
@@ -37,7 +34,7 @@ export interface DefinedTable<TTable> {
  *
  * @example
  * ```ts
- * import { defineTable } from '@gobing-ai/ts-db/schema';
+ * import { defineTable, standardColumns, text } from '@gobing-ai/ts-db/schema';
  *
  * export const users = defineTable('users', {
  *     id: text('id').primaryKey(),