@beignet/provider-drizzle-turso 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @beignet/provider-drizzle-turso
 
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [3160184]
+- Updated dependencies [254ef6d]
+- Updated dependencies [4cb1784]
+- Updated dependencies [8bd9085]
+  - @beignet/core@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- 90b29ad: Add pagination primitives and generate list responses with `items` and `page`.
+- 07fa19c: Add durable outbox primitives for transactionally recording events and jobs, plus a Drizzle/Turso outbox adapter.
+- Updated dependencies [90b29ad]
+- Updated dependencies [07fa19c]
+- Updated dependencies [08bae67]
+- Updated dependencies [730a818]
+- Updated dependencies [a79f60c]
+  - @beignet/core@0.0.2
+
 ## 0.0.1
 
 - Initial Beignet release under the `@beignet` npm scope.

package/README.md

@@ -113,7 +113,8 @@ infrastructure, then wire the repository into `ctx.ports`.
 
 ```ts
 // infra/todos/drizzle-todo-repository.ts
-import { desc } from "drizzle-orm";
+import { count, desc } from "drizzle-orm";
+import { offsetPageResult } from "@beignet/core/pagination";
 import type { DrizzleTursoDatabase } from "@beignet/provider-drizzle-turso";
 import type { TodoRepository } from "@/features/todos/ports";
 import * as schema from "@/infra/db/schema";
@@ -123,12 +124,15 @@ export function createTodoRepository(
 ): TodoRepository {
   return {
     async list(input) {
-      return db
+      const rows = await db
         .select()
         .from(schema.todos)
         .orderBy(desc(schema.todos.createdAt))
         .limit(input.limit)
         .offset(input.offset);
+      const [{ total }] = await db.select({ total: count() }).from(schema.todos);
+
+      return offsetPageResult(rows, input, total);
     },
   };
 }
@@ -151,8 +155,12 @@ export function createRepositories(db: DrizzleTursoDatabase<typeof schema>) {
 
 ```ts
 // features/todos/use-cases/list-todos.ts
+import { normalizeOffsetPage } from "@beignet/core/pagination";
+
 export const listTodos = useCase.query("todos.list").run(async ({ ctx }) => {
-  return ctx.ports.todos.list({ limit: 20, offset: 0 });
+  const page = normalizeOffsetPage({}, { defaultLimit: 20, maxLimit: 100 });
+
+  return ctx.ports.todos.list(page);
 });
 ```
 
@@ -265,6 +273,62 @@ throws, events are not flushed. If event publishing fails after commit,
 `transaction(...)` rejects but the database transaction is already committed;
 use an outbox when events or jobs need durable delivery guarantees.
 
+## Durable outbox
+
+Use `createDrizzleTursoOutboxPort(...)` when events or jobs must be recorded in
+the same database transaction as the business write, then drained after commit:
+
+```ts
+import {
+  createOutboxEventRecorder,
+  drainOutbox,
+} from "@beignet/core/outbox";
+import {
+  createDrizzleTursoOutboxPort,
+  createDrizzleTursoOutboxSetupStatements,
+  createDrizzleTursoUnitOfWork,
+} from "@beignet/provider-drizzle-turso";
+```
+
+Add Beignet's outbox table to your app-owned migration or bootstrap flow:
+
+```ts
+for (const statement of createDrizzleTursoOutboxSetupStatements()) {
+  await client.execute(statement);
+}
+```
+
+Then expose transaction-scoped outbox-backed event recording:
+
+```ts
+uow: createDrizzleTursoUnitOfWork({
+  db: ports.db.db,
+  createTransactionPorts: (tx) => {
+    const outbox = createDrizzleTursoOutboxPort(tx);
+
+    return {
+      ...createRepositories(tx),
+      events: createOutboxEventRecorder(outbox),
+      outbox,
+    };
+  },
+});
+```
+
+Drain from a worker, cron route, or scheduled task:
+
+```ts
+await drainOutbox({
+  outbox: ports.outbox,
+  registry: outboxRegistry,
+  eventBus: ports.eventBus,
+  jobs: ports.jobs,
+});
+```
+
+The default table is `outbox_messages`; pass `tableName` to both setup and port
+creation if your app uses a different table name.
+
 ## Configuration
 
 The provider reads configuration from environment variables with the `TURSO_` prefix:
@@ -410,6 +474,22 @@ Factory function to create a transaction-backed `UnitOfWorkPort`.
 **Returns:** A `UnitOfWorkPort<TxPorts>` that runs work inside
 `db.transaction(...)`.
 
+### `createDrizzleTursoOutboxPort<TSchema>(db, options?)`
+
+Factory function to create a SQL-backed `OutboxPort` from a root Drizzle
+database or transaction client.
+
+**Parameters:**
+- `db` (required): A `DrizzleTursoDatabase<TSchema>` root database or transaction
+- `options.tableName` (optional): Outbox table name, defaults to `"outbox_messages"`
+- `options.now` (optional): Test clock
+
+### `createDrizzleTursoOutboxSetupStatements(options?)`
+
+Returns SQL setup statements for the app-owned outbox table and indexes. Run
+these through your migration/bootstrap flow or translate them into your normal
+Drizzle migrations.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -25,9 +25,10 @@
  * const todos = createDrizzleTodoRepository(ctx.ports.db.db);
  * ```
  */
+import { type OutboxPort } from "@beignet/core/outbox";
 import { type BufferedDomainEventRecorder, type EventBusPort, type UnitOfWorkPort } from "@beignet/core/ports";
 import { type Client } from "@libsql/client";
-import type { ExtractTablesWithRelations } from "drizzle-orm";
+import { type ExtractTablesWithRelations } from "drizzle-orm";
 import { type LibSQLDatabase } from "drizzle-orm/libsql";
 import type { LibSQLTransaction } from "drizzle-orm/libsql/session";
 import type { SQLiteTransactionConfig } from "drizzle-orm/sqlite-core";
@@ -58,6 +59,9 @@ export type DrizzleTursoDatabase<TSchema extends Record<string, unknown> = Recor
  * Drizzle transaction client passed to Unit of Work repository factories.
  */
 export type DrizzleTursoTransaction<TSchema extends Record<string, unknown> = Record<string, unknown>> = LibSQLTransaction<TSchema, ExtractTablesWithRelations<TSchema>>;
+/**
+ * Options for creating a Drizzle/Turso-backed Unit of Work port.
+ */
 export interface DrizzleTursoUnitOfWorkOptions<TSchema extends Record<string, unknown>, TxPorts> {
     /**
      * The root Drizzle database instance from `ctx.ports.db.db`.
@@ -87,6 +91,35 @@ export interface DrizzleTursoUnitOfWorkOptions<TSchema extends Record<string, un
  * decides which transaction-scoped ports to create.
  */
 export declare function createDrizzleTursoUnitOfWork<TSchema extends Record<string, unknown>, TxPorts>(options: DrizzleTursoUnitOfWorkOptions<TSchema, TxPorts>): UnitOfWorkPort<TxPorts>;
+/**
+ * Options for a Drizzle/Turso-backed outbox port.
+ */
+export interface DrizzleTursoOutboxOptions {
+    /**
+     * Table that stores outbox messages.
+     *
+     * Default: "outbox_messages".
+     */
+    tableName?: string;
+    /**
+     * Clock used by tests and deterministic environments.
+     */
+    now?: () => Date;
+}
+/**
+ * Create idempotent SQL statements for the Drizzle/Turso outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleTursoOutboxPort(...)`.
+ */
+export declare function createDrizzleTursoOutboxSetupStatements(options?: DrizzleTursoOutboxOptions): readonly string[];
+/**
+ * Create a Beignet outbox port backed by a Drizzle/Turso database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages.
+ */
+export declare function createDrizzleTursoOutboxPort<TSchema extends Record<string, unknown>>(db: DrizzleTursoDatabase<TSchema>, adapterOptions?: DrizzleTursoOutboxOptions): OutboxPort;
 /**
  * Configuration schema for the Drizzle Turso provider.
  * Validates environment variables with TURSO_ prefix.
@@ -96,7 +129,7 @@ declare const TursoConfigSchema: z.ZodObject<{
     DB_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Inferred configuration type for Turso provider.
+ * Turso provider config loaded from `TURSO_*` env vars.
  */
 export type TursoConfig = z.infer<typeof TursoConfigSchema>;
 /**

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -25,9 +25,11 @@
  * const todos = createDrizzleTodoRepository(ctx.ports.db.db);
  * ```
  */
+import { createOutboxMessage, DEFAULT_OUTBOX_LEASE_MS, OutboxClaimError, serializeOutboxError, } from "@beignet/core/outbox";
 import { createDomainEventRecorder, } from "@beignet/core/ports";
 import { createProvider, createProviderInstrumentation, } from "@beignet/core/providers";
 import { createClient } from "@libsql/client";
+import { sql } from "drizzle-orm";
 import { drizzle } from "drizzle-orm/libsql";
 import { z } from "zod";
 /**
@@ -52,6 +54,276 @@ export function createDrizzleTursoUnitOfWork(options) {
         },
     };
 }
+function assertSafeIdentifier(name) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+        throw new Error(`Unsafe SQL identifier "${name}".`);
+    }
+}
+function quoteIdentifier(name) {
+    assertSafeIdentifier(name);
+    return `"${name.replaceAll('"', '""')}"`;
+}
+function outboxTable(options = {}) {
+    const tableName = options.tableName ?? "outbox_messages";
+    return sql.raw(quoteIdentifier(tableName));
+}
+function nowFrom(options) {
+    return options.now?.() ?? new Date();
+}
+function parseNullableDate(value) {
+    return value ? new Date(value) : null;
+}
+function parseLastError(value) {
+    return value ? JSON.parse(value) : null;
+}
+function rowToMessage(row) {
+    return {
+        id: row.id,
+        kind: row.kind,
+        name: row.name,
+        payload: JSON.parse(row.payload_json),
+        status: row.status,
+        attempts: row.attempts,
+        maxAttempts: row.max_attempts,
+        availableAt: new Date(row.available_at),
+        claimedAt: parseNullableDate(row.claimed_at),
+        lockedUntil: parseNullableDate(row.locked_until),
+        claimToken: row.claim_token,
+        deliveredAt: parseNullableDate(row.delivered_at),
+        lastError: parseLastError(row.last_error_json),
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at),
+    };
+}
+function rowToClaimedMessage(row) {
+    const message = rowToMessage(row);
+    if (message.status !== "claimed" ||
+        !message.claimToken ||
+        !message.claimedAt ||
+        !message.lockedUntil) {
+        throw new OutboxClaimError({
+            id: message.id,
+            message: `Outbox message "${message.id}" is not claimed.`,
+        });
+    }
+    return {
+        ...message,
+        status: "claimed",
+        claimToken: message.claimToken,
+        claimedAt: message.claimedAt,
+        lockedUntil: message.lockedUntil,
+    };
+}
+function createClaimToken() {
+    return crypto.randomUUID();
+}
+async function getOutboxRow(db, tableName, id) {
+    return db.get(sql `select * from ${tableName} where id = ${id}`);
+}
+function assertClaimMutationSucceeded(input, result) {
+    const rowsAffected = result.rowsAffected;
+    if (typeof rowsAffected === "number" && rowsAffected <= 0) {
+        throw new OutboxClaimError({
+            id: input.id,
+            message: `Outbox message "${input.id}" is not claimed by this worker.`,
+        });
+    }
+}
+function assertClaimedRowSucceeded(row, input) {
+    if (!row || row.status !== input.expectedStatus || row.claim_token !== null) {
+        throw new OutboxClaimError({
+            id: input.id,
+            message: `Outbox message "${input.id}" is not claimed by this worker.`,
+        });
+    }
+}
+/**
+ * Create idempotent SQL statements for the Drizzle/Turso outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleTursoOutboxPort(...)`.
+ */
+export function createDrizzleTursoOutboxSetupStatements(options = {}) {
+    const tableName = options.tableName ?? "outbox_messages";
+    const table = quoteIdentifier(tableName);
+    const indexPrefix = tableName.replaceAll(/[^A-Za-z0-9_]/g, "_");
+    return [
+        `CREATE TABLE IF NOT EXISTS ${table} (
+      id text PRIMARY KEY NOT NULL,
+      kind text NOT NULL,
+      name text NOT NULL,
+      payload_json text NOT NULL,
+      status text NOT NULL,
+      attempts integer DEFAULT 0 NOT NULL,
+      max_attempts integer DEFAULT 3 NOT NULL,
+      available_at text NOT NULL,
+      claimed_at text,
+      locked_until text,
+      claim_token text,
+      delivered_at text,
+      last_error_json text,
+      created_at text NOT NULL,
+      updated_at text NOT NULL
+    )`,
+        `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${indexPrefix}_available_idx`)} ON ${table} (status, available_at)`,
+        `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${indexPrefix}_locked_idx`)} ON ${table} (status, locked_until)`,
+    ];
+}
+/**
+ * Create a Beignet outbox port backed by a Drizzle/Turso database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages.
+ */
+export function createDrizzleTursoOutboxPort(db, adapterOptions = {}) {
+    const table = outboxTable(adapterOptions);
+    async function claimWith(tx, input) {
+        const nowIso = input.now.toISOString();
+        const lockedUntilIso = new Date(input.now.getTime() + input.leaseMs).toISOString();
+        const rows = await tx.all(sql `select * from ${table}
+      where (
+        (status = 'pending' and available_at <= ${nowIso})
+        or (status = 'claimed' and locked_until is not null and locked_until <= ${nowIso})
+      )
+      order by available_at asc, created_at asc
+      limit ${input.limit}`);
+        const claimed = [];
+        for (const row of rows) {
+            const claimToken = createClaimToken();
+            const updateResult = await tx.run(sql `update ${table}
+        set
+          status = 'claimed',
+          attempts = attempts + 1,
+          claimed_at = ${nowIso},
+          locked_until = ${lockedUntilIso},
+          claim_token = ${claimToken},
+          updated_at = ${nowIso}
+        where id = ${row.id}
+          and (
+            (status = 'pending' and available_at <= ${nowIso})
+            or (status = 'claimed' and locked_until is not null and locked_until <= ${nowIso})
+          )`);
+            const rowsAffected = updateResult
+                .rowsAffected;
+            if (typeof rowsAffected === "number" && rowsAffected <= 0) {
+                continue;
+            }
+            const claimedRow = await tx.get(sql `select * from ${table} where id = ${row.id} and claim_token = ${claimToken}`);
+            if (claimedRow) {
+                claimed.push(rowToClaimedMessage(claimedRow));
+            }
+        }
+        return claimed;
+    }
+    return {
+        async enqueue(input) {
+            const message = createOutboxMessage(input, {
+                now: nowFrom(adapterOptions),
+            });
+            const nowIso = message.createdAt.toISOString();
+            await db.run(sql `insert into ${table} (
+        id,
+        kind,
+        name,
+        payload_json,
+        status,
+        attempts,
+        max_attempts,
+        available_at,
+        claimed_at,
+        locked_until,
+        claim_token,
+        delivered_at,
+        last_error_json,
+        created_at,
+        updated_at
+      ) values (
+        ${message.id},
+        ${message.kind},
+        ${message.name},
+        ${JSON.stringify(message.payload)},
+        ${message.status},
+        ${message.attempts},
+        ${message.maxAttempts},
+        ${message.availableAt.toISOString()},
+        null,
+        null,
+        null,
+        null,
+        null,
+        ${nowIso},
+        ${nowIso}
+      )`);
+            return message;
+        },
+        async claimBatch(input) {
+            const limit = input.limit;
+            if (!Number.isInteger(limit) || limit <= 0) {
+                throw new Error("limit must be a positive integer");
+            }
+            const now = input.now ?? nowFrom(adapterOptions);
+            const leaseMs = input.leaseMs ?? DEFAULT_OUTBOX_LEASE_MS;
+            if (!Number.isInteger(leaseMs) || leaseMs <= 0) {
+                throw new Error("leaseMs must be a positive integer");
+            }
+            const claimInput = { limit, now, leaseMs };
+            if ("transaction" in db && typeof db.transaction === "function") {
+                return db.transaction((tx) => claimWith(tx, claimInput));
+            }
+            return claimWith(db, claimInput);
+        },
+        async markDelivered(input) {
+            const nowIso = (input.now ?? nowFrom(adapterOptions)).toISOString();
+            const result = await db.run(sql `update ${table}
+        set
+          status = 'delivered',
+          delivered_at = ${nowIso},
+          claimed_at = null,
+          locked_until = null,
+          claim_token = null,
+          updated_at = ${nowIso}
+        where id = ${input.id}
+          and status = 'claimed'
+          and claim_token = ${input.claimToken}`);
+            assertClaimMutationSucceeded({
+                id: input.id,
+                expectedStatus: "delivered",
+            }, result);
+            assertClaimedRowSucceeded(await getOutboxRow(db, table, input.id), {
+                id: input.id,
+                expectedStatus: "delivered",
+            });
+        },
+        async markFailed(input) {
+            const now = input.now ?? nowFrom(adapterOptions);
+            const nowIso = now.toISOString();
+            const status = input.deadLetter
+                ? "deadLettered"
+                : "pending";
+            const availableAt = input.retryAt ?? now;
+            const result = await db.run(sql `update ${table}
+        set
+          status = ${status},
+          available_at = ${availableAt.toISOString()},
+          claimed_at = null,
+          locked_until = null,
+          claim_token = null,
+          last_error_json = ${JSON.stringify(serializeOutboxError(input.error))},
+          updated_at = ${nowIso}
+        where id = ${input.id}
+          and status = 'claimed'
+          and claim_token = ${input.claimToken}`);
+            assertClaimMutationSucceeded({
+                id: input.id,
+                expectedStatus: status,
+            }, result);
+            assertClaimedRowSucceeded(await getOutboxRow(db, table, input.id), {
+                id: input.id,
+                expectedStatus: status,
+            });
+        },
+    };
+}
 /**
  * Configuration schema for the Drizzle Turso provider.
  * Validates environment variables with TURSO_ prefix.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAEL,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAQhB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,yBAAyB,GAI1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAe,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAmC,GAAG,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,OAAO,EAAuB,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0ExB;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAI1C,OAAwD;IAExD,OAAO;QACL,KAAK,CAAC,WAAW,CACf,IAAyC;YAEzC,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;YAE3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBACvD,MAAM,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAC5C,EAAsC,EACtC,MAAM,CACP,CAAC;gBACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAE9B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAqCD,SAAS,oBAAoB,CAAC,IAAY;IACxC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,IAAI,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,UAAqC,EAAE;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACzD,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,OAAO,CAAC,OAAkC;IACjD,OAAO,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAoB;IAC7C,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,KAAoB;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,SAAS,YAAY,CAAC,GAA0B;IAC9C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAoB;QACxD,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;QACvC,SAAS,EAAE,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC5C,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;QAChD,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;QAChD,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC;QAC9C,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QACnC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,GAA0B;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC5B,CAAC,OAAO,CAAC,UAAU;QACnB,CAAC,OAAO,CAAC,SAAS;QAClB,CAAC,OAAO,CAAC,WAAW,EACpB,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC;YACzB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,mBAAmB,OAAO,CAAC,EAAE,mBAAmB;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,EAAiC,EACjC,SAAyC,EACzC,EAAU;IAEV,OAAO,EAAE,CAAC,GAAG,CACX,GAAG,CAAA,iBAAiB,SAAS,eAAe,EAAE,EAAE,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,KAA0D,EAC1D,MAAe;IAEf,MAAM,YAAY,GAAI,MAAqC,CAAC,YAAY,CAAC;IACzE,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,gBAAgB,CAAC;YACzB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,OAAO,EAAE,mBAAmB,KAAK,CAAC,EAAE,kCAAkC;SACvE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,GAAsC,EACtC,KAA0D;IAE1D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,cAAc,IAAI,GAAG,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC5E,MAAM,IAAI,gBAAgB,CAAC;YACzB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,OAAO,EAAE,mBAAmB,KAAK,CAAC,EAAE,kCAAkC;SACvE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uCAAuC,CACrD,UAAqC,EAAE;IAEvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAEhE,OAAO;QACL,8BAA8B,KAAK;;;;;;;;;;;;;;;;MAgBjC;QACF,8BAA8B,eAAe,CAAC,GAAG,WAAW,gBAAgB,CAAC,OAAO,KAAK,yBAAyB;QAClH,8BAA8B,eAAe,CAAC,GAAG,WAAW,aAAa,CAAC,OAAO,KAAK,yBAAyB;KAChH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAG1C,EAAiC,EACjC,iBAA4C,EAAE;IAE9C,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAE1C,KAAK,UAAU,SAAS,CACtB,EAAiC,EACjC,KAAoD;QAEpD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,cAAc,GAAG,IAAI,IAAI,CAC7B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CACpC,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAwB,GAAG,CAAA,iBAAiB,KAAK;;kDAE5B,MAAM;kFAC0B,MAAM;;;cAG1E,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACzB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAA,UAAU,KAAK;;;;yBAIjC,MAAM;2BACJ,cAAc;0BACf,UAAU;yBACX,MAAM;qBACV,GAAG,CAAC,EAAE;;sDAE2B,MAAM;sFAC0B,MAAM;YAChF,CAAC,CAAC;YACR,MAAM,YAAY,GAAI,YAA2C;iBAC9D,YAAY,CAAC;YAChB,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;gBAC1D,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAC7B,GAAG,CAAA,iBAAiB,KAAK,eAAe,GAAG,CAAC,EAAE,sBAAsB,UAAU,EAAE,CACjF,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAyB;YACrC,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE;gBACzC,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC;aAC7B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAE/C,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAA,eAAe,KAAK;;;;;;;;;;;;;;;;;UAiBhC,OAAO,CAAC,EAAE;UACV,OAAO,CAAC,IAAI;UACZ,OAAO,CAAC,IAAI;UACZ,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;UAC/B,OAAO,CAAC,MAAM;UACd,OAAO,CAAC,QAAQ;UAChB,OAAO,CAAC,WAAW;UACnB,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE;;;;;;UAMjC,MAAM;UACN,MAAM;QACR,CAAC,CAAC;YAEJ,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,uBAAuB,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAE3C,IAAI,aAAa,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBAChE,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAC3B,SAAS,CAAC,EAAmC,EAAE,UAAU,CAAC,CAC3D,CAAC;YACJ,CAAC;YAED,OAAO,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAA,UAAU,KAAK;;;2BAGzB,MAAM;;;;yBAIR,MAAM;qBACV,KAAK,CAAC,EAAE;;8BAEC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAE5C,4BAA4B,CAC1B;gBACE,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,cAAc,EAAE,WAAW;aAC5B,EACD,MAAM,CACP,CAAC;YACF,yBAAyB,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE;gBACjE,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,cAAc,EAAE,WAAW;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,MAAM,GAAwB,KAAK,CAAC,UAAU;gBAClD,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC;YAEzC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAA,UAAU,KAAK;;qBAE/B,MAAM;2BACA,WAAW,CAAC,WAAW,EAAE;;;;8BAItB,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;yBACtD,MAAM;qBACV,KAAK,CAAC,EAAE;;8BAEC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAE5C,4BAA4B,CAC1B;gBACE,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,cAAc,EAAE,MAAM;aACvB,EACD,MAAM,CACP,CAAC;YACF,yBAAyB,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE;gBACjE,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,cAAc,EAAE,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC;;;OAGG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QACvE,OAAO,EACL,6GAA6G;KAChH,CAAC;IAEJ;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAOH,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,OAAO,UAAU,CAAC,MAAM,GAAG,GAAG;QAC5B,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;QAClC,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAwBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,0BAA0B,CAGxC,OAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE5C,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,eAAe;QAErB,MAAM,EAAE;YACN,MAAM,EAAE,iBAAiB;YACzB,SAAS,EAAE,QAAQ;SACpB;QAED,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;YACJ,CAAC;YAED,yBAAyB;YACzB,MAAM,MAAM,GAAW,YAAY,CAAC;gBAClC,GAAG,EAAE,MAAM,CAAC,MAAM;gBAClB,SAAS,EAAE,MAAM,CAAC,aAAa;aAChC,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,6BAA6B,CAAC,KAAK,EAAE;gBAC3D,YAAY,EAAE,eAAe;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE;gBACxC,CAAC,CAAC;oBACE,QAAQ,CAAC,KAAa,EAAE,MAAiB;wBACvC,eAAe,CAAC,MAAM,CAAC;4BACrB,IAAI,EAAE,UAAU;4BAChB,KAAK,EAAE,gBAAgB;4BACvB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC;4BAC9B,OAAO,EAAE;gCACP,KAAK;gCACL,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;gCAC7C,WAAW,EAAE,MAAM,CAAC,MAAM;gCAC1B,QAAQ;6BACT;yBACF,CAAC,CAAC;oBACL,CAAC;iBACF;gBACH,CAAC,CAAC,SAAS,CAAC;YAEd,mCAAmC;YACnC,MAAM,EAAE,GAA4B,MAAM;gBACxC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBACrC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAEhC,0BAA0B;YAC1B,MAAM,MAAM,GAAoB,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;YAE/C,OAAO;gBACL,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAuC;gBAClE,KAAK,CAAC,IAAI;oBACR,2CAA2C;oBAC3C,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC9B,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,yDAAyD;wBACzD,OAAO,CAAC,KAAK,CACX,2DAA2D,EAC3D,KAAK,CACN,CAAC;oBACJ,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-drizzle-turso",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "Drizzle ORM + Turso/libSQL provider for Beignet - adds typed DbPort using drizzle-orm",
   "main": "./dist/index.js",

package/src/index.ts

@@ -26,6 +26,20 @@
  * ```
  */
 
+import {
+  type ClaimedOutboxMessage,
+  createOutboxMessage,
+  DEFAULT_OUTBOX_LEASE_MS,
+  OutboxClaimError,
+  type OutboxEnqueueInput,
+  type OutboxErrorInfo,
+  type OutboxJsonValue,
+  type OutboxMessage,
+  type OutboxMessageKind,
+  type OutboxMessageStatus,
+  type OutboxPort,
+  serializeOutboxError,
+} from "@beignet/core/outbox";
 import {
   type BufferedDomainEventRecorder,
   createDomainEventRecorder,
@@ -38,7 +52,7 @@ import {
   createProviderInstrumentation,
 } from "@beignet/core/providers";
 import { type Client, createClient } from "@libsql/client";
-import type { ExtractTablesWithRelations } from "drizzle-orm";
+import { type ExtractTablesWithRelations, sql } from "drizzle-orm";
 import { drizzle, type LibSQLDatabase } from "drizzle-orm/libsql";
 import type { LibSQLTransaction } from "drizzle-orm/libsql/session";
 import type { SQLiteTransactionConfig } from "drizzle-orm/sqlite-core";
@@ -82,6 +96,9 @@ export type DrizzleTursoTransaction<
   TSchema extends Record<string, unknown> = Record<string, unknown>,
 > = LibSQLTransaction<TSchema, ExtractTablesWithRelations<TSchema>>;
 
+/**
+ * Options for creating a Drizzle/Turso-backed Unit of Work port.
+ */
 export interface DrizzleTursoUnitOfWorkOptions<
   TSchema extends Record<string, unknown>,
   TxPorts,
@@ -149,6 +166,378 @@ export function createDrizzleTursoUnitOfWork<
   };
 }
 
+/**
+ * Options for a Drizzle/Turso-backed outbox port.
+ */
+export interface DrizzleTursoOutboxOptions {
+  /**
+   * Table that stores outbox messages.
+   *
+   * Default: "outbox_messages".
+   */
+  tableName?: string;
+
+  /**
+   * Clock used by tests and deterministic environments.
+   */
+  now?: () => Date;
+}
+
+interface DrizzleTursoOutboxRow {
+  id: string;
+  kind: OutboxMessageKind;
+  name: string;
+  payload_json: string;
+  status: OutboxMessageStatus;
+  attempts: number;
+  max_attempts: number;
+  available_at: string;
+  claimed_at: string | null;
+  locked_until: string | null;
+  claim_token: string | null;
+  delivered_at: string | null;
+  last_error_json: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+function assertSafeIdentifier(name: string): void {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+    throw new Error(`Unsafe SQL identifier "${name}".`);
+  }
+}
+
+function quoteIdentifier(name: string): string {
+  assertSafeIdentifier(name);
+  return `"${name.replaceAll('"', '""')}"`;
+}
+
+function outboxTable(options: DrizzleTursoOutboxOptions = {}) {
+  const tableName = options.tableName ?? "outbox_messages";
+  return sql.raw(quoteIdentifier(tableName));
+}
+
+function nowFrom(options: DrizzleTursoOutboxOptions): Date {
+  return options.now?.() ?? new Date();
+}
+
+function parseNullableDate(value: string | null): Date | null {
+  return value ? new Date(value) : null;
+}
+
+function parseLastError(value: string | null): OutboxErrorInfo | null {
+  return value ? (JSON.parse(value) as OutboxErrorInfo) : null;
+}
+
+function rowToMessage(row: DrizzleTursoOutboxRow): OutboxMessage {
+  return {
+    id: row.id,
+    kind: row.kind,
+    name: row.name,
+    payload: JSON.parse(row.payload_json) as OutboxJsonValue,
+    status: row.status,
+    attempts: row.attempts,
+    maxAttempts: row.max_attempts,
+    availableAt: new Date(row.available_at),
+    claimedAt: parseNullableDate(row.claimed_at),
+    lockedUntil: parseNullableDate(row.locked_until),
+    claimToken: row.claim_token,
+    deliveredAt: parseNullableDate(row.delivered_at),
+    lastError: parseLastError(row.last_error_json),
+    createdAt: new Date(row.created_at),
+    updatedAt: new Date(row.updated_at),
+  };
+}
+
+function rowToClaimedMessage(row: DrizzleTursoOutboxRow): ClaimedOutboxMessage {
+  const message = rowToMessage(row);
+  if (
+    message.status !== "claimed" ||
+    !message.claimToken ||
+    !message.claimedAt ||
+    !message.lockedUntil
+  ) {
+    throw new OutboxClaimError({
+      id: message.id,
+      message: `Outbox message "${message.id}" is not claimed.`,
+    });
+  }
+
+  return {
+    ...message,
+    status: "claimed",
+    claimToken: message.claimToken,
+    claimedAt: message.claimedAt,
+    lockedUntil: message.lockedUntil,
+  };
+}
+
+function createClaimToken(): string {
+  return crypto.randomUUID();
+}
+
+async function getOutboxRow<TSchema extends Record<string, unknown>>(
+  db: DrizzleTursoDatabase<TSchema>,
+  tableName: ReturnType<typeof outboxTable>,
+  id: string,
+): Promise<DrizzleTursoOutboxRow | undefined> {
+  return db.get<DrizzleTursoOutboxRow>(
+    sql`select * from ${tableName} where id = ${id}`,
+  );
+}
+
+function assertClaimMutationSucceeded(
+  input: { id: string; expectedStatus: OutboxMessageStatus },
+  result: unknown,
+): void {
+  const rowsAffected = (result as { rowsAffected?: unknown }).rowsAffected;
+  if (typeof rowsAffected === "number" && rowsAffected <= 0) {
+    throw new OutboxClaimError({
+      id: input.id,
+      message: `Outbox message "${input.id}" is not claimed by this worker.`,
+    });
+  }
+}
+
+function assertClaimedRowSucceeded(
+  row: DrizzleTursoOutboxRow | undefined,
+  input: { id: string; expectedStatus: OutboxMessageStatus },
+): void {
+  if (!row || row.status !== input.expectedStatus || row.claim_token !== null) {
+    throw new OutboxClaimError({
+      id: input.id,
+      message: `Outbox message "${input.id}" is not claimed by this worker.`,
+    });
+  }
+}
+
+/**
+ * Create idempotent SQL statements for the Drizzle/Turso outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleTursoOutboxPort(...)`.
+ */
+export function createDrizzleTursoOutboxSetupStatements(
+  options: DrizzleTursoOutboxOptions = {},
+): readonly string[] {
+  const tableName = options.tableName ?? "outbox_messages";
+  const table = quoteIdentifier(tableName);
+  const indexPrefix = tableName.replaceAll(/[^A-Za-z0-9_]/g, "_");
+
+  return [
+    `CREATE TABLE IF NOT EXISTS ${table} (
+      id text PRIMARY KEY NOT NULL,
+      kind text NOT NULL,
+      name text NOT NULL,
+      payload_json text NOT NULL,
+      status text NOT NULL,
+      attempts integer DEFAULT 0 NOT NULL,
+      max_attempts integer DEFAULT 3 NOT NULL,
+      available_at text NOT NULL,
+      claimed_at text,
+      locked_until text,
+      claim_token text,
+      delivered_at text,
+      last_error_json text,
+      created_at text NOT NULL,
+      updated_at text NOT NULL
+    )`,
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${indexPrefix}_available_idx`)} ON ${table} (status, available_at)`,
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${indexPrefix}_locked_idx`)} ON ${table} (status, locked_until)`,
+  ];
+}
+
+/**
+ * Create a Beignet outbox port backed by a Drizzle/Turso database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages.
+ */
+export function createDrizzleTursoOutboxPort<
+  TSchema extends Record<string, unknown>,
+>(
+  db: DrizzleTursoDatabase<TSchema>,
+  adapterOptions: DrizzleTursoOutboxOptions = {},
+): OutboxPort {
+  const table = outboxTable(adapterOptions);
+
+  async function claimWith(
+    tx: DrizzleTursoDatabase<TSchema>,
+    input: { limit: number; now: Date; leaseMs: number },
+  ): Promise<ClaimedOutboxMessage[]> {
+    const nowIso = input.now.toISOString();
+    const lockedUntilIso = new Date(
+      input.now.getTime() + input.leaseMs,
+    ).toISOString();
+    const rows = await tx.all<DrizzleTursoOutboxRow>(sql`select * from ${table}
+      where (
+        (status = 'pending' and available_at <= ${nowIso})
+        or (status = 'claimed' and locked_until is not null and locked_until <= ${nowIso})
+      )
+      order by available_at asc, created_at asc
+      limit ${input.limit}`);
+    const claimed: ClaimedOutboxMessage[] = [];
+
+    for (const row of rows) {
+      const claimToken = createClaimToken();
+      const updateResult = await tx.run(sql`update ${table}
+        set
+          status = 'claimed',
+          attempts = attempts + 1,
+          claimed_at = ${nowIso},
+          locked_until = ${lockedUntilIso},
+          claim_token = ${claimToken},
+          updated_at = ${nowIso}
+        where id = ${row.id}
+          and (
+            (status = 'pending' and available_at <= ${nowIso})
+            or (status = 'claimed' and locked_until is not null and locked_until <= ${nowIso})
+          )`);
+      const rowsAffected = (updateResult as { rowsAffected?: unknown })
+        .rowsAffected;
+      if (typeof rowsAffected === "number" && rowsAffected <= 0) {
+        continue;
+      }
+
+      const claimedRow = await tx.get<DrizzleTursoOutboxRow>(
+        sql`select * from ${table} where id = ${row.id} and claim_token = ${claimToken}`,
+      );
+      if (claimedRow) {
+        claimed.push(rowToClaimedMessage(claimedRow));
+      }
+    }
+
+    return claimed;
+  }
+
+  return {
+    async enqueue(input: OutboxEnqueueInput): Promise<OutboxMessage> {
+      const message = createOutboxMessage(input, {
+        now: nowFrom(adapterOptions),
+      });
+      const nowIso = message.createdAt.toISOString();
+
+      await db.run(sql`insert into ${table} (
+        id,
+        kind,
+        name,
+        payload_json,
+        status,
+        attempts,
+        max_attempts,
+        available_at,
+        claimed_at,
+        locked_until,
+        claim_token,
+        delivered_at,
+        last_error_json,
+        created_at,
+        updated_at
+      ) values (
+        ${message.id},
+        ${message.kind},
+        ${message.name},
+        ${JSON.stringify(message.payload)},
+        ${message.status},
+        ${message.attempts},
+        ${message.maxAttempts},
+        ${message.availableAt.toISOString()},
+        null,
+        null,
+        null,
+        null,
+        null,
+        ${nowIso},
+        ${nowIso}
+      )`);
+
+      return message;
+    },
+
+    async claimBatch(input) {
+      const limit = input.limit;
+      if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error("limit must be a positive integer");
+      }
+      const now = input.now ?? nowFrom(adapterOptions);
+      const leaseMs = input.leaseMs ?? DEFAULT_OUTBOX_LEASE_MS;
+      if (!Number.isInteger(leaseMs) || leaseMs <= 0) {
+        throw new Error("leaseMs must be a positive integer");
+      }
+      const claimInput = { limit, now, leaseMs };
+
+      if ("transaction" in db && typeof db.transaction === "function") {
+        return db.transaction((tx) =>
+          claimWith(tx as DrizzleTursoDatabase<TSchema>, claimInput),
+        );
+      }
+
+      return claimWith(db, claimInput);
+    },
+
+    async markDelivered(input) {
+      const nowIso = (input.now ?? nowFrom(adapterOptions)).toISOString();
+      const result = await db.run(sql`update ${table}
+        set
+          status = 'delivered',
+          delivered_at = ${nowIso},
+          claimed_at = null,
+          locked_until = null,
+          claim_token = null,
+          updated_at = ${nowIso}
+        where id = ${input.id}
+          and status = 'claimed'
+          and claim_token = ${input.claimToken}`);
+
+      assertClaimMutationSucceeded(
+        {
+          id: input.id,
+          expectedStatus: "delivered",
+        },
+        result,
+      );
+      assertClaimedRowSucceeded(await getOutboxRow(db, table, input.id), {
+        id: input.id,
+        expectedStatus: "delivered",
+      });
+    },
+
+    async markFailed(input) {
+      const now = input.now ?? nowFrom(adapterOptions);
+      const nowIso = now.toISOString();
+      const status: OutboxMessageStatus = input.deadLetter
+        ? "deadLettered"
+        : "pending";
+      const availableAt = input.retryAt ?? now;
+
+      const result = await db.run(sql`update ${table}
+        set
+          status = ${status},
+          available_at = ${availableAt.toISOString()},
+          claimed_at = null,
+          locked_until = null,
+          claim_token = null,
+          last_error_json = ${JSON.stringify(serializeOutboxError(input.error))},
+          updated_at = ${nowIso}
+        where id = ${input.id}
+          and status = 'claimed'
+          and claim_token = ${input.claimToken}`);
+
+      assertClaimMutationSucceeded(
+        {
+          id: input.id,
+          expectedStatus: status,
+        },
+        result,
+      );
+      assertClaimedRowSucceeded(await getOutboxRow(db, table, input.id), {
+        id: input.id,
+        expectedStatus: status,
+      });
+    },
+  };
+}
+
 /**
  * Configuration schema for the Drizzle Turso provider.
  * Validates environment variables with TURSO_ prefix.
@@ -174,7 +563,7 @@ const TursoConfigSchema = z.object({
 });
 
 /**
- * Inferred configuration type for Turso provider.
+ * Turso provider config loaded from `TURSO_*` env vars.
  */
 export type TursoConfig = z.infer<typeof TursoConfigSchema>;