@gobing-ai/ts-db 0.4.62 → 0.4.64

package/README.md

@@ -265,6 +265,13 @@ const stats = await queue.getStats();
 // → { pending: 5, processing: 2, completed: 100, failed: 3 }
 ```
 
+**Delivery semantics:** the lease path is **at-least-once, never exactly-once**. A
+claimed job whose lease expires (crash, lost renewal, stalled event loop) becomes
+claimable again and will execute a second time; the attempt token only fences the
+*ack* (a stale `markCompleted`/`markFailed` from the lost owner is ignored), it
+does not fence execution. Handlers must therefore be idempotent or carry their own
+dedup key — assume any claimed job can run more than once under failure.
+
 ### InboxMessageDao — durable inter-agent messages
 
 `InboxMessageDao` persists directed messages for team-mode or multi-agent workflows. It lives on the

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

@@ -36,12 +36,20 @@ export interface FailedMessageDetail {
     error: string;
     timestamp: number;
 }
+/** Payload for a `message.requeued` event (one per row returned by `release`). */
+export interface RequeuedMessageDetail {
+    id: string;
+    fromId: string | null;
+    toId: string;
+    timestamp: number;
+}
 /** Typed event map for inbox message lifecycle transitions. */
 export type InboxMessageEvents = {
     'message.enqueued': (detail: EnqueuedMessageDetail) => void;
     'message.injected': (detail: InjectedMessageDetail) => void;
     'message.delivered': (detail: DeliveredMessageDetail) => void;
     'message.failed': (detail: FailedMessageDetail) => void;
+    'message.requeued': (detail: RequeuedMessageDetail) => void;
 };
 /**
  * Zero-dependency structural event sink.
@@ -68,6 +76,15 @@ export declare class InboxMessageDao extends EntityDao<typeof inboxMessages, typ
     }): Promise<InboxMessage[]>;
     markDelivered(msgId: string): Promise<void>;
     markFailed(msgId: string, error: string): Promise<void>;
+    /**
+     * Release claimed (`injected`) messages back to `queued` so a drain whose
+     * invocation never started stays redeliverable. Only rows currently in
+     * `status = 'injected'` are touched — a `queued` or `delivered` row is
+     * left alone, so double-release is a no-op. `injectAttempts` and
+     * `injectError` are left untouched: the claim counter IS the budget.
+     * Emits one `message.requeued` event per released row.
+     */
+    release(msgIds: string[]): Promise<number>;
     inbox(toId: string, limit?: number, offset?: number): Promise<InboxMessage[]>;
     countPending(toId: string): Promise<number>;
     getById(id: string): Promise<InboxMessage | undefined>;

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

@@ -1,4 +1,4 @@
-import { sql } from 'drizzle-orm';
+import { and, eq, inArray, sql } from 'drizzle-orm';
 import { EntityDao } from './entity-dao.js';
 import { inboxMessages } from './schema/inbox-messages.js';
 function isPromiseLike(value) {
@@ -109,6 +109,33 @@ export class InboxMessageDao extends EntityDao {
             });
         }
     }
+    /**
+     * Release claimed (`injected`) messages back to `queued` so a drain whose
+     * invocation never started stays redeliverable. Only rows currently in
+     * `status = 'injected'` are touched — a `queued` or `delivered` row is
+     * left alone, so double-release is a no-op. `injectAttempts` and
+     * `injectError` are left untouched: the claim counter IS the budget.
+     * Emits one `message.requeued` event per released row.
+     */
+    async release(msgIds) {
+        if (msgIds.length === 0)
+            return 0;
+        const now = this.now();
+        const rows = (await this.db
+            .update(inboxMessages)
+            .set({ status: 'queued', updatedAt: now })
+            .where(and(inArray(inboxMessages.id, msgIds), eq(inboxMessages.status, 'injected')))
+            .returning());
+        for (const row of rows) {
+            this.emitEvent('message.requeued', {
+                id: row.id,
+                fromId: row.fromId,
+                toId: row.toId,
+                timestamp: now,
+            });
+        }
+        return rows.length;
+    }
     async inbox(toId, limit, offset) {
         return this.list({
             where: { col: inboxMessages.toId, op: 'eq', value: toId },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-db",
-    "version": "0.4.62",
+    "version": "0.4.64",
     "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.62",
-        "@gobing-ai/ts-utils": "^0.4.62"
+        "@gobing-ai/ts-runtime": "^0.4.63",
+        "@gobing-ai/ts-utils": "^0.4.63"
     },
     "peerDependencies": {
         "drizzle-orm": ">=0.38.0",

package/src/inbox-message-dao.ts

@@ -1,4 +1,4 @@
-import { sql } from 'drizzle-orm';
+import { and, eq, inArray, sql } from 'drizzle-orm';
 import type { DbAdapter } from './adapter';
 import type { UpdateReturningDb } from './drizzle-builders';
 import { EntityDao } from './entity-dao';
@@ -48,12 +48,21 @@ export interface FailedMessageDetail {
     timestamp: number;
 }
 
+/** Payload for a `message.requeued` event (one per row returned by `release`). */
+export interface RequeuedMessageDetail {
+    id: string;
+    fromId: string | null;
+    toId: string;
+    timestamp: number;
+}
+
 /** Typed event map for inbox message lifecycle transitions. */
 export type InboxMessageEvents = {
     'message.enqueued': (detail: EnqueuedMessageDetail) => void;
     'message.injected': (detail: InjectedMessageDetail) => void;
     'message.delivered': (detail: DeliveredMessageDetail) => void;
     'message.failed': (detail: FailedMessageDetail) => void;
+    'message.requeued': (detail: RequeuedMessageDetail) => void;
 };
 
 /**
@@ -193,6 +202,35 @@ export class InboxMessageDao extends EntityDao<typeof inboxMessages, typeof inbo
         }
     }
 
+    /**
+     * Release claimed (`injected`) messages back to `queued` so a drain whose
+     * invocation never started stays redeliverable. Only rows currently in
+     * `status = 'injected'` are touched — a `queued` or `delivered` row is
+     * left alone, so double-release is a no-op. `injectAttempts` and
+     * `injectError` are left untouched: the claim counter IS the budget.
+     * Emits one `message.requeued` event per released row.
+     */
+    async release(msgIds: string[]): Promise<number> {
+        if (msgIds.length === 0) return 0;
+        const now = this.now();
+        const rows = (await (this.db as UpdateReturningDb)
+            .update(inboxMessages)
+            .set({ status: 'queued', updatedAt: now })
+            .where(and(inArray(inboxMessages.id, msgIds), eq(inboxMessages.status, 'injected')))
+            .returning()) as InboxMessage[];
+
+        for (const row of rows) {
+            this.emitEvent('message.requeued', {
+                id: row.id,
+                fromId: row.fromId,
+                toId: row.toId,
+                timestamp: now,
+            });
+        }
+
+        return rows.length;
+    }
+
     async inbox(toId: string, limit?: number, offset?: number): Promise<InboxMessage[]> {
         return this.list({
             where: { col: inboxMessages.toId, op: 'eq', value: toId },