@gobing-ai/ts-db 0.2.8 → 0.3.0

package/README.md

@@ -22,6 +22,7 @@ Application code imports only `@gobing-ai/ts-db` — never `drizzle-orm`. drizzl
 | `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` |
+| `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 |
 | `SpanContext` | Re-exported from `@gobing-ai/ts-runtime` for telemetry |
@@ -102,6 +103,15 @@ classDiagram
         +getStats() QueueStats
     }
 
+    class InboxMessageDao {
+        +enqueue(fromId, toId, body, inReplyTo?) string
+        +drainPending(toId) InboxMessage[]
+        +markDelivered(msgId) void
+        +markFailed(msgId, error) void
+        +inbox(toId, limit?, offset?) InboxMessage[]
+        +countPending(toId) number
+    }
+
     class ColumnHelpers {
         +standardColumns
         +standardColumnsWithSoftDelete
@@ -112,6 +122,10 @@ classDiagram
         +queueJobs
     }
 
+    class InboxMessagesTable {
+        +inboxMessages
+    }
+
     class MigrationRunner {
         +applyMigrations(adapter, opts?) void
     }
@@ -124,7 +138,9 @@ classDiagram
     DbAdapter <|.. D1Adapter : implements
     BaseDao <|-- EntityDao : extends
     EntityDao <|-- QueueJobDao : extends
+    EntityDao <|-- InboxMessageDao : extends
     QueueJobDao --> QueueJobsTable : "uses"
+    InboxMessageDao --> InboxMessagesTable : "uses"
     MigrationRunner --> EmbeddedMigrations : "uses"
     MigrationRunner --> BunSqliteAdapter : "requires"
 ```
@@ -233,6 +249,39 @@ const stats = await queue.getStats();
 // → { pending: 5, processing: 2, completed: 100, failed: 3 }
 ```
 
+### InboxMessageDao — durable inter-agent messages
+
+`InboxMessageDao` persists directed messages for team-mode or multi-agent workflows. It lives on the
+`@gobing-ai/ts-db/inbox` subpath so consumers can depend on the inbox surface without pulling schema
+helpers.
+
+```ts
+import { InboxMessageDao } from '@gobing-ai/ts-db/inbox';
+
+const inbox = new InboxMessageDao(adapter);
+
+// Operator sends a task to an agent.
+const msgId = await inbox.enqueue(null, 'coder', 'Please inspect packages/db');
+
+// Agent process startup/live-injection path atomically drains queued work.
+const pending = await inbox.drainPending('coder');
+for (const msg of pending) {
+    try {
+        await injectIntoAgentStdin(`[task from=${msg.fromId ?? 'operator'} id=${msg.id}] ${msg.body}`);
+        await inbox.markDelivered(msg.id);
+    } catch (error) {
+        await inbox.markFailed(msg.id, String(error));
+    }
+}
+
+const history = await inbox.inbox('coder', 20);
+const queued = await inbox.countPending('coder');
+```
+
+The `inbox_messages` table is additive and included in embedded migrations. It stores `from_id`,
+`to_id`, `body`, `status`, optional reply linkage, delivery timestamp, injection attempts, and the
+last injection error. The indexed access path is `(to_id, status)` for efficient pending drains.
+
 ### Migrations
 
 ```ts
@@ -252,7 +301,7 @@ await applyMigrations(adapter);
 
 ```ts
 import { sqliteTable, text } from 'drizzle-orm/sqlite-core';
-import { standardColumns, standardColumnsWithSoftDelete, queueJobs } from '@gobing-ai/ts-db';
+import { standardColumns, standardColumnsWithSoftDelete, queueJobs, inboxMessages } from '@gobing-ai/ts-db';
 
 // Standard columns (createdAt, updatedAt)
 const docs = sqliteTable('docs', {
@@ -269,6 +318,8 @@ const projects = sqliteTable('projects', {
 });
 
 // queue_jobs table is pre-built for use with QueueJobDao
+
+// inbox_messages table is pre-built for use with InboxMessageDao
 ```
 
 ## Usage

package/dist/drizzle-builders.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Shared structural types for drizzle's fluent query builders.
+ *
+ * `InternalDb` is typed as the bare drizzle union (ADR-005 keeps drizzle internal),
+ * so its fluent builders (`insert().values().returning()`, `update().set().where()`,
+ * `select(proj).from()...`) are not surfaced as call-shapes. Each DAO previously
+ * re-declared these narrowings inline — three files independently describing the
+ * same `update → set → where → returning` chain. Centralising them here means the
+ * cast shape lives in one place: when drizzle's builder surface shifts, this file
+ * changes, not every DAO.
+ *
+ * These are deliberately minimal — each type narrows only the chain a DAO actually
+ * invokes. Table-specific projections (`select({ status, count })`) stay local to
+ * their DAO; only the recurring chain skeletons live here.
+ *
+ * @internal
+ */
+/** Terminal `.returning()` returning the written rows. */
+export interface ReturningRows {
+    returning: () => Promise<unknown[]>;
+}
+/** `insert(table).values(record)` → returning, with optional upsert. */
+export interface InsertBuilder {
+    values: (record: unknown) => ReturningRows & {
+        onConflictDoUpdate: (cfg: {
+            target: unknown;
+            set: unknown;
+        }) => ReturningRows;
+    };
+}
+/** `update(table).set(data).where(cond)` → `.returning()` rows. */
+export interface UpdateReturningDb {
+    update: (table: unknown) => {
+        set: (data: unknown) => {
+            where: (cond: unknown) => ReturningRows;
+        };
+    };
+}
+/** `update(table).set(data).where(cond)` → void (no rows). */
+export interface UpdateVoidDb {
+    update: (table: unknown) => {
+        set: (data: unknown) => {
+            where: (cond: unknown) => Promise<unknown>;
+        };
+    };
+}
+/** `update(table).set(data).where(cond)` → `{ changes }` (affected-row count). */
+export interface UpdateChangesDb {
+    update: (table: unknown) => {
+        set: (data: unknown) => {
+            where: (cond: unknown) => Promise<{
+                changes: number;
+            }>;
+        };
+    };
+}
+/** `update(table).set(data).where(cond)` → arbitrary single condition (no projection). */
+export interface SimpleUpdateDb {
+    update: (table: unknown) => {
+        set: (data: unknown) => {
+            where: (cond: unknown) => ReturningRows;
+        };
+    };
+}
+/** `select(projection).from(table)` exposing `.where(...)` and `.groupBy(...)` terminals. */
+export interface SelectProjectionDb {
+    select: (projection: unknown) => {
+        from: (table: unknown) => {
+            where: (cond: unknown) => Promise<unknown[]>;
+            groupBy: (group: unknown) => Promise<unknown[]>;
+        };
+    };
+}
+/** `select().from(table).where(cond).orderBy(o).limit(n)` — the ready-rows read chain. */
+export interface SelectOrderedLimitDb {
+    select: () => {
+        from: (table: unknown) => {
+            where: (cond: unknown) => {
+                orderBy: (order: unknown) => {
+                    limit: (limit: number) => Promise<unknown[]>;
+                };
+            };
+        };
+    };
+}
+/** `select(count).from(table)` that is awaitable and chainable with `.where(...)`. */
+export type CountQuery = Promise<unknown[]> & {
+    where: (condition: unknown) => Promise<unknown[]>;
+};
+/** `select({ value: count() }).from(table)` → awaitable count, optionally filtered. */
+export interface CountSelectDb {
+    select: (projection: unknown) => {
+        from: (table: unknown) => CountQuery;
+    };
+}
+//# sourceMappingURL=drizzle-builders.d.ts.map

package/dist/drizzle-builders.d.ts.map

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

package/dist/drizzle-builders.js

@@ -0,0 +1,17 @@
+/**
+ * Shared structural types for drizzle's fluent query builders.
+ *
+ * `InternalDb` is typed as the bare drizzle union (ADR-005 keeps drizzle internal),
+ * so its fluent builders (`insert().values().returning()`, `update().set().where()`,
+ * `select(proj).from()...`) are not surfaced as call-shapes. Each DAO previously
+ * re-declared these narrowings inline — three files independently describing the
+ * same `update → set → where → returning` chain. Centralising them here means the
+ * cast shape lives in one place: when drizzle's builder surface shifts, this file
+ * changes, not every DAO.
+ *
+ * These are deliberately minimal — each type narrows only the chain a DAO actually
+ * invokes. Table-specific projections (`select({ status, count })`) stay local to
+ * their DAO; only the recurring chain skeletons live here.
+ *
+ * @internal
+ */

package/dist/embedded-migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedded-migrations.d.ts","sourceRoot":"","sources":["../src/embedded-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAgBjD,CAAC"}
+{"version":3,"file":"embedded-migrations.d.ts","sourceRoot":"","sources":["../src/embedded-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EA0BjD,CAAC"}

package/dist/embedded-migrations.js

@@ -22,4 +22,14 @@ export const embeddedMigrations = [
         sql: 'ALTER TABLE `queue_jobs` ADD `expires_at` integer;',
         hash: '7380f8c162352a61b15205af5a87e0e7313a499203dae98fe62151a1dc7fec0e',
     },
+    {
+        tag: '0003_inbox_messages',
+        sql: "CREATE TABLE `inbox_messages` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`from_id` text,\n\t`to_id` text NOT NULL,\n\t`body` text NOT NULL,\n\t`status` text DEFAULT 'queued' NOT NULL,\n\t`in_reply_to` text,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL,\n\t`delivered_at` integer,\n\t`inject_attempts` integer DEFAULT 0 NOT NULL,\n\t`inject_error` text\n);",
+        hash: 'c4ba569172d1be276c42b5c164c668404e6229dcf48b41d7fb2bc93e8d29d11b',
+    },
+    {
+        tag: '0004_inbox_messages_to_status_idx',
+        sql: 'CREATE INDEX `idx_inbox_messages_to_status` ON `inbox_messages` (`to_id`,`status`);',
+        hash: '3c00f1bce4f569e442f3142df31ff478d6c9b3d460824d46575f50a324bfae61',
+    },
 ];

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

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

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

@@ -0,0 +1,19 @@
+import type { DbAdapter } from './adapter';
+import { EntityDao } from './entity-dao';
+import { inboxMessages } from './schema/inbox-messages';
+/** Row type inferred from the inbox_messages Drizzle schema. */
+export type InboxMessage = typeof inboxMessages.$inferSelect;
+/**
+ * DAO for durable inter-agent inbox messages.
+ */
+export declare class InboxMessageDao extends EntityDao<typeof inboxMessages, typeof inboxMessages.id> {
+    constructor(adapter: DbAdapter);
+    enqueue(fromId: string | null, toId: string, body: string, inReplyTo?: string): Promise<string>;
+    drainPending(toId: string): Promise<InboxMessage[]>;
+    markDelivered(msgId: string): Promise<void>;
+    markFailed(msgId: string, error: string): Promise<void>;
+    inbox(toId: string, limit?: number, offset?: number): Promise<InboxMessage[]>;
+    countPending(toId: string): Promise<number>;
+    getById(id: string): Promise<InboxMessage | undefined>;
+}
+//# sourceMappingURL=inbox-message-dao.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-message-dao.d.ts","sourceRoot":"","sources":["../src/inbox-message-dao.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAE7D;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS,CAAC,OAAO,aAAa,EAAE,OAAO,aAAa,CAAC,EAAE,CAAC;gBAC7E,OAAO,EAAE,SAAS;IAIxB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/F,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwBnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAS7E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;CAG/D"}

package/dist/inbox-message-dao.js

@@ -0,0 +1,75 @@
+import { sql } from 'drizzle-orm';
+import { EntityDao } from './entity-dao.js';
+import { inboxMessages } from './schema/inbox-messages.js';
+/**
+ * DAO for durable inter-agent inbox messages.
+ */
+export class InboxMessageDao extends EntityDao {
+    constructor(adapter) {
+        super(adapter, inboxMessages, [inboxMessages.id], 'inbox_messages');
+    }
+    async enqueue(fromId, toId, body, inReplyTo) {
+        const id = crypto.randomUUID();
+        await this.create({
+            id,
+            fromId,
+            toId,
+            body,
+            status: 'queued',
+            injectAttempts: 0,
+            ...(inReplyTo !== undefined ? { inReplyTo } : {}),
+        });
+        return id;
+    }
+    async drainPending(toId) {
+        const now = this.now();
+        const rows = await this.db
+            .update(inboxMessages)
+            .set({
+            status: 'injected',
+            injectAttempts: sql `${inboxMessages.injectAttempts} + 1`,
+            updatedAt: now,
+        })
+            .where(sql `${inboxMessages.id} IN (
+                    SELECT id
+                    FROM ${inboxMessages}
+                    WHERE to_id = ${toId}
+                      AND status = 'queued'
+                    ORDER BY created_at
+                )
+                AND ${inboxMessages.status} = 'queued'`)
+            .returning();
+        return rows;
+    }
+    async markDelivered(msgId) {
+        await this.update(msgId, {
+            status: 'delivered',
+            deliveredAt: this.now(),
+        });
+    }
+    async markFailed(msgId, error) {
+        await this.update(msgId, {
+            status: 'failed',
+            injectError: error,
+        });
+    }
+    async inbox(toId, limit, offset) {
+        return this.list({
+            where: { col: inboxMessages.toId, op: 'eq', value: toId },
+            orderBy: [{ col: inboxMessages.createdAt, dir: 'desc' }],
+            ...(limit !== undefined ? { limit } : {}),
+            ...(offset !== undefined ? { offset } : {}),
+        });
+    }
+    async countPending(toId) {
+        return this.count({
+            and: [
+                { col: inboxMessages.toId, op: 'eq', value: toId },
+                { col: inboxMessages.status, op: 'eq', value: 'queued' },
+            ],
+        });
+    }
+    async getById(id) {
+        return this.findBy(inboxMessages.id, id);
+    }
+}

package/dist/inbox.d.ts

@@ -0,0 +1,3 @@
+export { type InboxMessage, InboxMessageDao } from './inbox-message-dao';
+export { inboxMessages } from './schema/inbox-messages';
+//# sourceMappingURL=inbox.d.ts.map

package/dist/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/inbox.js

@@ -0,0 +1,2 @@
+export { InboxMessageDao } from './inbox-message-dao.js';
+export { inboxMessages } from './schema/inbox-messages.js';

package/dist/index.d.ts

@@ -3,10 +3,12 @@ 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';
-export { applyMigrations, type MigrationOptions } from './migrate';
+export { type InboxMessage, InboxMessageDao } from './inbox-message-dao';
+export { applyMigrations, type MigrationLogger, type MigrationOptions } from './migrate';
 export { type ColRef, type ComparisonOp, compileOrderBy, compilePredicate, type ListSpec, type OrderTerm, type Predicate, } from './query-spec';
 export { QueueJobDao, type QueueJobRecord, type QueueStats } from './queue-job-dao';
 export { appendOnlyColumns, buildAppendOnlyColumns, buildStandardColumns, buildStandardColumnsWithSoftDelete, nowTimestamp, standardColumns, standardColumnsWithSoftDelete, } from './schema/common';
+export { inboxMessages } from './schema/inbox-messages';
 export { queueJobs } from './schema/queue-jobs';
 export type { SpanContext } from './span-context';
 //# sourceMappingURL=index.d.ts.map

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,UAAU,EAAE,MAAM,WAAW,CAAC;AACnG,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,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnE,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,OAAO,EACH,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kCAAkC,EAClC,YAAY,EACZ,eAAe,EACf,6BAA6B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,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,UAAU,EAAE,MAAM,WAAW,CAAC;AACnG,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,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,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,OAAO,EACH,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kCAAkC,EAClC,YAAY,EACZ,eAAe,EACf,6BAA6B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -3,8 +3,10 @@ export { D1Adapter } from './adapters/d1.js';
 export { BaseDao } from './base-dao.js';
 export { embeddedMigrations } from './embedded-migrations.js';
 export { EntityDao, } from './entity-dao.js';
+export { InboxMessageDao } from './inbox-message-dao.js';
 export { applyMigrations } from './migrate.js';
 export { compileOrderBy, compilePredicate, } from './query-spec.js';
 export { QueueJobDao } from './queue-job-dao.js';
 export { appendOnlyColumns, buildAppendOnlyColumns, buildStandardColumns, buildStandardColumnsWithSoftDelete, nowTimestamp, standardColumns, standardColumnsWithSoftDelete, } from './schema/common.js';
+export { inboxMessages } from './schema/inbox-messages.js';
 export { queueJobs } from './schema/queue-jobs.js';

package/dist/migrate.d.ts

@@ -1,12 +1,17 @@
 import type { FileSystem } from '@gobing-ai/ts-runtime';
 import type { DbAdapter } from './adapter';
 /**
- * Find project root by walking up looking for bun.lock.
- * @deprecated Use `FileSystem.getProjectRoot()` instead.
- * @internal — only used for backward compatibility.
+ * Minimal structural logger for migration progress.
+ *
+ * Structurally compatible with `@gobing-ai/ts-infra`'s `Logger` so consumers can
+ * pass theirs directly — ts-db never imports ts-infra (keeps the package
+ * boundary). Defaults to `console` when absent.
  */
-/** @internal */
-export declare function findProjectRoot(_startDir: string): string;
+export interface MigrationLogger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+}
 /**
  * Options for configuring migration behaviour (folder path, table name).
  */
@@ -17,6 +22,8 @@ export interface MigrationOptions {
     migrationsTable?: string;
     /** File system abstraction for path resolution. */
     fs?: FileSystem;
+    /** Logger for migration progress. Default: `console`. */
+    logger?: MigrationLogger;
 }
 /**
  * Apply pending migrations using drizzle-orm's built-in migrator.

package/dist/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;GAIG;AACH,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,EAAE,CAAC,EAAE,UAAU,CAAC;CACnB;AA0ED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CnG"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B;AA8ED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDnG"}

package/dist/migrate.js

@@ -1,14 +1,5 @@
 import { resolve } from 'node:path';
 import { embeddedMigrations } from './embedded-migrations.js';
-/**
- * Find project root by walking up looking for bun.lock.
- * @deprecated Use `FileSystem.getProjectRoot()` instead.
- * @internal — only used for backward compatibility.
- */
-/** @internal */
-export function findProjectRoot(_startDir) {
-    return process.cwd();
-}
 /**
  * Ensure the migration tracking table exists with proper SQLite types.
  *
@@ -35,7 +26,7 @@ function validateMigrationTableName(table) {
  * Checks the journal table and applies only migrations that haven't run yet.
  * Each migration is executed with adapter.exec() for file-based or adapter.run() for journal tracking.
  */
-async function applyEmbeddedMigrations(adapter, journalTable) {
+async function applyEmbeddedMigrations(adapter, journalTable, logger) {
     // Validate journal table name — this is an internal constant, never user input.
     if (!/^__[a-z_]+$/.test(journalTable)) {
         throw new Error(`Invalid migration journal table name: ${journalTable}`);
@@ -55,7 +46,7 @@ async function applyEmbeddedMigrations(adapter, journalTable) {
     for (const migration of embeddedMigrations) {
         if (appliedHashes.has(migration.hash))
             continue;
-        console.info(`Applying embedded migration: ${migration.tag}`);
+        logger.info(`Applying embedded migration: ${migration.tag}`);
         // Split on semicolons and execute each non-empty statement
         const statements = migration.sql
             .split(';')
@@ -69,7 +60,7 @@ async function applyEmbeddedMigrations(adapter, journalTable) {
         applied++;
     }
     if (applied > 0) {
-        console.info(`Applied ${applied} embedded migration(s)`);
+        logger.info(`Applied ${applied} embedded migration(s)`);
     }
 }
 /**
@@ -89,43 +80,46 @@ async function applyEmbeddedMigrations(adapter, journalTable) {
  * @param options - Optional migration folder and table name overrides.
  */
 export async function applyMigrations(adapter, options) {
+    const logger = options?.logger ?? console;
     const { BunSqliteAdapter } = await import('./adapters/bun-sqlite.js');
     if (!(adapter instanceof BunSqliteAdapter)) {
-        console.warn('Skipping in-app migrations: only supported for bun-sqlite adapter');
+        logger.warn('Skipping in-app migrations: only supported for bun-sqlite adapter');
         return;
     }
     const table = validateMigrationTableName(options?.migrationsTable ?? '__drizzle_migrations');
     await ensureJournalTable(adapter, table);
-    const folder = options?.migrationsFolder ?? resolve(findProjectRoot(process.cwd()), 'drizzle');
-    // File-based migrations: attempt if drizzle/ folder is accessible.
-    // Use FileSystem.exists when available, otherwise try and fall back to embedded.
+    const folder = options?.migrationsFolder ?? resolve(process.cwd(), 'drizzle');
+    // File-based migrations: attempt only if the drizzle/ folder is present.
+    // With an injected fs we get a definitive answer (await the Promise — a bare
+    // `fs.exists(...)` is always truthy and silently disables the check); without
+    // one we attempt optimistically and fall back on the migrator's own error.
     const fs = options?.fs;
-    const tryFileBased = fs?.exists(folder) ?? true; // optimistic when no fs
+    const tryFileBased = fs ? await fs.exists(folder) : true;
     if (tryFileBased) {
         try {
             const { migrate: drizzleMigrate } = await import('drizzle-orm/bun-sqlite/migrator');
-            console.info(`Applying database migrations from ${folder}`);
+            logger.info(`Applying database migrations from ${folder}`);
             await drizzleMigrate(adapter.getDrizzleDb(), {
                 migrationsFolder: folder,
                 ...(options?.migrationsTable !== undefined ? { migrationsTable: options.migrationsTable } : {}),
             });
-            console.info('Database migrations complete');
+            logger.info('Database migrations complete');
             return;
         }
         catch (error) {
-            // If folder doesn't exist, fall through to embedded migrations.
-            // Any other error should be thrown.
+            // A missing/empty migrations folder is expected in compiled binaries —
+            // fall through to embedded. Any other failure is real; rethrow it.
             const message = error instanceof Error ? error.message : String(error);
             if (message.includes('journal') || message.includes('ENOENT') || message.includes('meta')) {
-                console.info(`File-based migrations unavailable, using embedded: ${message}`);
+                logger.info(`File-based migrations unavailable, using embedded: ${message}`);
             }
             else {
-                console.error(`[MIGRATE] drizzleMigrate failed: ${message}`);
+                logger.error(`[MIGRATE] drizzleMigrate failed: ${message}`);
                 throw error;
             }
         }
     }
     // Fallback: embedded migrations (for compiled binaries)
-    console.info('No drizzle/ folder found — applying embedded migrations');
-    await applyEmbeddedMigrations(adapter, table);
+    logger.info('No drizzle/ folder found — applying embedded migrations');
+    await applyEmbeddedMigrations(adapter, table, logger);
 }

package/dist/queue-job-dao.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-job-dao.d.ts","sourceRoot":"","sources":["../src/queue-job-dao.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAsDhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,OAAO,SAAS,EAAE,OAAO,SAAS,CAAC,EAAE,CAAC;gBACjE,OAAO,EAAE,SAAS;IAI9B;;OAEG;IACG,OAAO,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;IACG,YAAY,CACd,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1G,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BpB;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI9D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAoBrC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASpD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAe/D;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyB9D;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1G;;OAEG;IACG,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAahE;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAkB3C"}
+{"version":3,"file":"queue-job-dao.d.ts","sourceRoot":"","sources":["../src/queue-job-dao.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQ3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,OAAO,SAAS,EAAE,OAAO,SAAS,CAAC,EAAE,CAAC;gBACjE,OAAO,EAAE,SAAS;IAI9B;;OAEG;IACG,OAAO,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;IACG,YAAY,CACd,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1G,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BpB;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI9D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAoBrC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASpD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAe/D;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyB9D;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1G;;OAEG;IACG,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAahE;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAkB3C"}

package/dist/schema/ddl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../../src/schema/ddl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAuE3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsFjE"}
+{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../../src/schema/ddl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAmC3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsFjE"}

package/dist/schema/ddl.js

@@ -1,29 +1,11 @@
 import { getTableConfig } from 'drizzle-orm/sqlite-core';
+import { getDrizzleTableName, sqlExpressionToText } from './drizzle-internals.js';
 /**
  * Quote an identifier for use in SQL (double-quoted for SQLite compatibility).
  */
 function quoteIdent(name) {
     return `"${name.replace(/"/g, '""')}"`;
 }
-/**
- * Extract the SQL string from a drizzle-orm SQL expression by walking its
- * internal `queryChunks` — StringChunk values plus Param placeholders.
- */
-function sqlToString(chunks) {
-    return chunks
-        .map((chunk) => {
-        // StringChunk — the literal SQL fragment
-        if ('value' in chunk && typeof chunk.value === 'string') {
-            return chunk.value;
-        }
-        // Param — use the input value if available
-        if ('input' in chunk && chunk.input !== undefined) {
-            return String(chunk.input);
-        }
-        return String(chunk.value ?? '?');
-    })
-        .join('');
-}
 /**
  * Map a column default value to its SQL literal representation.
  *
@@ -45,22 +27,8 @@ function defaultToSql(value) {
     if (typeof value === 'boolean') {
         return value ? '1' : '0';
     }
-    // drizzle-orm SQL expression (has queryChunks)
-    if (typeof value === 'object' && value !== null && 'queryChunks' in value) {
-        const chunks = value.queryChunks;
-        if (chunks) {
-            return sqlToString(chunks);
-        }
-    }
-    return String(value);
-}
-/**
- * Resolve a drizzle table object to its string name.
- */
-function getTableName(table) {
-    // Drizzle tables store name at Symbol.for('drizzle:Name')
-    const nameSym = Symbol.for('drizzle:Name');
-    return String(table[nameSym]);
+    // drizzle-orm SQL expression (sql`...`) — rendered via the internals quarantine.
+    return sqlExpressionToText(value) ?? String(value);
 }
 /**
  * Generate a `CREATE TABLE IF NOT EXISTS` DDL statement from a Drizzle SQLite table.
@@ -141,7 +109,7 @@ export function generateCreateTableSql(table) {
         const ref = fk.reference();
         const localCols = ref.columns.map((c) => quoteIdent(c.name)).join(', ');
         const foreignCols = ref.foreignColumns.map((c) => quoteIdent(c.name)).join(', ');
-        const foreignTableName = getTableName(ref.foreignTable);
+        const foreignTableName = getDrizzleTableName(ref.foreignTable);
         let constraint = `FOREIGN KEY (${localCols}) REFERENCES ${quoteIdent(foreignTableName)} (${foreignCols})`;
         if (fk.onDelete) {
             constraint += ` ON DELETE ${fk.onDelete}`;