@beignet/provider-db-drizzle 0.0.9

package/dist/shared/rows.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shared row encode/decode helpers for Drizzle database providers.
+ *
+ * Every dialect stores timestamps as ISO-8601 UTC strings in `text` columns.
+ * This is deliberate: lexicographic order equals chronological order, the
+ * storage semantics stay byte-identical across SQLite, Postgres, and MySQL,
+ * and all values route through this single encode/decode point so a dialect
+ * could later move to native timestamp types without touching the shared
+ * orchestration in `outbox-core.ts` and `idempotency-core.ts`.
+ */
+import type { IdempotencyReservation } from "@beignet/core/idempotency";
+import { type ClaimedOutboxMessage, type OutboxErrorInfo, type OutboxMessage, type OutboxMessageKind, type OutboxMessageStatus } from "@beignet/core/outbox";
+/**
+ * Encode a timestamp for storage. All dialects store ISO-8601 UTC strings.
+ */
+export declare function encodeTimestamp(value: Date): string;
+/**
+ * Decode a stored timestamp string back into a `Date`.
+ */
+export declare function decodeTimestamp(value: string): Date;
+/**
+ * Decode a nullable stored timestamp string.
+ */
+export declare function parseNullableDate(value: string | null): Date | null;
+/**
+ * Decode a stored outbox error JSON column.
+ */
+export declare function parseLastError(value: string | null): OutboxErrorInfo | null;
+/**
+ * Raw outbox table row shape shared by every dialect.
+ */
+export interface OutboxRow {
+    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;
+}
+/**
+ * Decode a raw outbox row into an `OutboxMessage`.
+ */
+export declare function rowToMessage(row: OutboxRow): OutboxMessage;
+/**
+ * Decode a raw outbox row into a `ClaimedOutboxMessage`.
+ *
+ * @throws OutboxClaimError when the row is not in a fully claimed state.
+ */
+export declare function rowToClaimedMessage(row: OutboxRow): ClaimedOutboxMessage;
+/**
+ * Stored idempotency record status values shared by every dialect.
+ */
+export type IdempotencyRowStatus = "in-progress" | "completed";
+/**
+ * Raw idempotency table row shape shared by every dialect.
+ */
+export interface IdempotencyRow {
+    storage_key: string;
+    namespace: string;
+    idempotency_key: string;
+    scope_key: string;
+    fingerprint: string;
+    status: IdempotencyRowStatus;
+    result_json: string | null;
+    reserved_at: string;
+    completed_at: string | null;
+    expires_at: string | null;
+    updated_at: string;
+}
+/**
+ * Decode a raw idempotency row into the reservation outcome for a caller
+ * holding `receivedFingerprint`.
+ */
+export declare function idempotencyReservationFromRow(row: IdempotencyRow, receivedFingerprint: string): IdempotencyReservation;
+//# sourceMappingURL=rows.d.ts.map

package/dist/shared/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/shared/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EAEpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,CAkB1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,oBAAoB,CAqBxE;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,cAAc,EACnB,mBAAmB,EAAE,MAAM,GAC1B,sBAAsB,CA6CxB"}

package/dist/shared/rows.js

@@ -0,0 +1,128 @@
+/**
+ * Shared row encode/decode helpers for Drizzle database providers.
+ *
+ * Every dialect stores timestamps as ISO-8601 UTC strings in `text` columns.
+ * This is deliberate: lexicographic order equals chronological order, the
+ * storage semantics stay byte-identical across SQLite, Postgres, and MySQL,
+ * and all values route through this single encode/decode point so a dialect
+ * could later move to native timestamp types without touching the shared
+ * orchestration in `outbox-core.ts` and `idempotency-core.ts`.
+ */
+import { OutboxClaimError, } from "@beignet/core/outbox";
+/**
+ * Encode a timestamp for storage. All dialects store ISO-8601 UTC strings.
+ */
+export function encodeTimestamp(value) {
+    return value.toISOString();
+}
+/**
+ * Decode a stored timestamp string back into a `Date`.
+ */
+export function decodeTimestamp(value) {
+    return new Date(value);
+}
+/**
+ * Decode a nullable stored timestamp string.
+ */
+export function parseNullableDate(value) {
+    return value ? decodeTimestamp(value) : null;
+}
+/**
+ * Decode a stored outbox error JSON column.
+ */
+export function parseLastError(value) {
+    return value ? JSON.parse(value) : null;
+}
+/**
+ * Decode a raw outbox row into an `OutboxMessage`.
+ */
+export 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: decodeTimestamp(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: decodeTimestamp(row.created_at),
+        updatedAt: decodeTimestamp(row.updated_at),
+    };
+}
+/**
+ * Decode a raw outbox row into a `ClaimedOutboxMessage`.
+ *
+ * @throws OutboxClaimError when the row is not in a fully claimed state.
+ */
+export 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,
+    };
+}
+/**
+ * Decode a raw idempotency row into the reservation outcome for a caller
+ * holding `receivedFingerprint`.
+ */
+export function idempotencyReservationFromRow(row, receivedFingerprint) {
+    const reservedAt = decodeTimestamp(row.reserved_at);
+    const completedAt = parseNullableDate(row.completed_at);
+    const expiresAt = parseNullableDate(row.expires_at);
+    if (row.fingerprint !== receivedFingerprint) {
+        return {
+            status: "conflict",
+            namespace: row.namespace,
+            key: row.idempotency_key,
+            scopeKey: row.scope_key,
+            storedFingerprint: row.fingerprint,
+            receivedFingerprint,
+            reservedAt,
+            completedAt: completedAt ?? undefined,
+            expiresAt,
+        };
+    }
+    if (row.status === "completed" && completedAt) {
+        return {
+            status: "replay",
+            namespace: row.namespace,
+            key: row.idempotency_key,
+            scopeKey: row.scope_key,
+            fingerprint: row.fingerprint,
+            result: row.result_json === null
+                ? undefined
+                : JSON.parse(row.result_json),
+            reservedAt,
+            completedAt,
+            expiresAt,
+        };
+    }
+    return {
+        status: "inProgress",
+        namespace: row.namespace,
+        key: row.idempotency_key,
+        scopeKey: row.scope_key,
+        fingerprint: row.fingerprint,
+        reservedAt,
+        expiresAt,
+    };
+}
+//# sourceMappingURL=rows.js.map

package/dist/shared/rows.js.map

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

package/dist/sqlite/index.d.ts

@@ -0,0 +1,235 @@
+/**
+ * @beignet/provider-db-drizzle/sqlite
+ *
+ * Drizzle ORM SQLite provider, backed by libSQL, that creates a typed
+ * database port. Works with local `file:` SQLite databases and with Turso's
+ * hosted libSQL service.
+ *
+ * Configuration:
+ * - SQLITE_DB_URL: libSQL database URL (required)
+ * - SQLITE_DB_AUTH_TOKEN: auth token for remote connections such as Turso
+ *   (optional for local dev)
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleSqliteProvider } from "@beignet/provider-db-drizzle/sqlite";
+ *
+ * export const drizzleSqliteProvider = createDrizzleSqliteProvider({ schema });
+ *
+ * // In createNextServer:
+ * const server = await createNextServer({
+ *   ports: basePorts,
+ *   providers: [drizzleSqliteProvider],
+ *   // ...
+ * });
+ *
+ * // In infra:
+ * const todos = createDrizzleTodoRepository(ctx.ports.db.db);
+ * ```
+ */
+import type { IdempotencyPort } from "@beignet/core/idempotency";
+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 LibSQLDatabase } from "drizzle-orm/libsql";
+import type { LibSQLTransaction } from "drizzle-orm/libsql/session";
+import type { SQLiteTransactionConfig } from "drizzle-orm/sqlite-core";
+import { z } from "zod";
+/**
+ * Typed database port interface.
+ * Exposes a typed Drizzle database instance for your schema.
+ *
+ * @template TSchema - The Drizzle schema type (e.g., `typeof schema`)
+ */
+export interface DbPort<TSchema extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * The typed Drizzle database instance.
+     * Use this to query your database with full type safety.
+     */
+    db: LibSQLDatabase<TSchema>;
+    /**
+     * The underlying libSQL client instance.
+     * Use this for advanced operations not covered by Drizzle ORM.
+     */
+    client: Client;
+}
+/**
+ * Drizzle database or transaction client accepted by repository factories.
+ */
+export type DrizzleSqliteDatabase<TSchema extends Record<string, unknown> = Record<string, unknown>> = LibSQLDatabase<TSchema> | LibSQLTransaction<TSchema, ExtractTablesWithRelations<TSchema>>;
+/**
+ * Drizzle transaction client passed to Unit of Work repository factories.
+ */
+export type DrizzleSqliteTransaction<TSchema extends Record<string, unknown> = Record<string, unknown>> = LibSQLTransaction<TSchema, ExtractTablesWithRelations<TSchema>>;
+/**
+ * Options for creating a Drizzle SQLite-backed Unit of Work port.
+ */
+export interface DrizzleSqliteUnitOfWorkOptions<TSchema extends Record<string, unknown>, TxPorts> {
+    /**
+     * The root Drizzle database instance from `ctx.ports.db.db`.
+     */
+    db: LibSQLDatabase<TSchema>;
+    /**
+     * Create transaction-scoped ports from the Drizzle transaction client.
+     *
+     * The event recorder is transaction-local. Record domain events inside the
+     * callback and pass `eventBus` to publish them after the database commit.
+     */
+    createTransactionPorts: (db: DrizzleSqliteTransaction<TSchema>, events: BufferedDomainEventRecorder) => TxPorts;
+    /**
+     * Optional event bus used to flush recorded domain events after commit.
+     */
+    eventBus?: EventBusPort;
+    /**
+     * Optional Drizzle transaction configuration.
+     */
+    transactionConfig?: SQLiteTransactionConfig;
+}
+/**
+ * Create a Unit of Work port backed by Drizzle's libSQL transaction API.
+ *
+ * Beignet does not own your repository interfaces. This helper only
+ * provides the transaction boundary and post-commit event flushing; your app
+ * decides which transaction-scoped ports to create.
+ */
+export declare function createDrizzleSqliteUnitOfWork<TSchema extends Record<string, unknown>, TxPorts>(options: DrizzleSqliteUnitOfWorkOptions<TSchema, TxPorts>): UnitOfWorkPort<TxPorts>;
+/**
+ * Options for a Drizzle SQLite-backed outbox port.
+ */
+export interface DrizzleSqliteOutboxOptions {
+    /**
+     * 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 SQLite outbox table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleSqliteOutboxPort(...)`.
+ */
+export declare function createDrizzleSqliteOutboxSetupStatements(options?: DrizzleSqliteOutboxOptions): readonly string[];
+/**
+ * Create a Beignet outbox port backed by a Drizzle SQLite database.
+ *
+ * Claiming uses a claim-token lease so concurrent workers can safely compete
+ * for eligible messages.
+ */
+export declare function createDrizzleSqliteOutboxPort<TSchema extends Record<string, unknown>>(db: DrizzleSqliteDatabase<TSchema>, adapterOptions?: DrizzleSqliteOutboxOptions): OutboxPort;
+/**
+ * Options for a Drizzle SQLite-backed idempotency port.
+ */
+export interface DrizzleSqliteIdempotencyOptions {
+    /**
+     * Table that stores idempotency records.
+     *
+     * Default: "idempotency_records".
+     */
+    tableName?: string;
+    /**
+     * Clock used by tests and deterministic environments.
+     */
+    now?: () => Date;
+}
+/**
+ * Error thrown when `complete(...)` or `fail(...)` does not match an
+ * in-progress idempotency reservation with the provided fingerprint.
+ *
+ * This usually signals a workflow bug: the reservation was never made, was
+ * already completed or released, expired and was cleaned up, or the caller
+ * passed a different fingerprint than the one used to reserve.
+ */
+export declare class DrizzleSqliteIdempotencyMutationError extends Error {
+    readonly action: "complete" | "fail";
+    readonly namespace: string;
+    readonly key: string;
+    readonly scopeKey: string;
+    constructor(args: {
+        action: "complete" | "fail";
+        namespace: string;
+        key: string;
+        scopeKey: string;
+    });
+}
+/**
+ * Create idempotent SQL statements for the Drizzle SQLite idempotency table.
+ *
+ * Run these during migrations or local setup before using
+ * `createDrizzleSqliteIdempotencyPort(...)`.
+ */
+export declare function createDrizzleSqliteIdempotencySetupStatements(options?: DrizzleSqliteIdempotencyOptions): readonly string[];
+/**
+ * Create a Beignet idempotency port backed by a Drizzle SQLite database.
+ *
+ * The port accepts both the root Drizzle database and transaction clients, so
+ * applications can expose root idempotency for ordinary retry-safe commands and
+ * transaction-scoped idempotency from Unit of Work.
+ */
+export declare function createDrizzleSqliteIdempotencyPort<TSchema extends Record<string, unknown>>(db: DrizzleSqliteDatabase<TSchema>, adapterOptions?: DrizzleSqliteIdempotencyOptions): IdempotencyPort;
+/**
+ * Configuration schema for the Drizzle SQLite provider.
+ * Validates environment variables with SQLITE_ prefix.
+ */
+declare const SqliteConfigSchema: z.ZodObject<{
+    DB_URL: z.ZodString;
+    DB_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * SQLite provider config loaded from `SQLITE_*` env vars.
+ */
+export type SqliteConfig = z.infer<typeof SqliteConfigSchema>;
+/**
+ * Options for creating a Drizzle SQLite provider.
+ *
+ * @template TSchema - The Drizzle schema type
+ */
+export interface DrizzleSqliteProviderOptions<TSchema extends Record<string, unknown>, PortName extends string = "db"> {
+    /**
+     * The Drizzle schema object (e.g. `import * as schema from '@/db/schema'`).
+     * This schema is used to create a typed Drizzle database instance.
+     */
+    schema: TSchema;
+    /**
+     * Optional port name. Defaults to "db".
+     * Renames the contributed port. The provider always reads its connection
+     * from `SQLITE_DB_URL`; for a second database, wire an app-owned provider
+     * with its own env prefix instead.
+     */
+    portName?: PortName;
+}
+/**
+ * Create a Drizzle SQLite provider factory.
+ *
+ * This factory creates a service provider that:
+ * - Uses libSQL via @libsql/client, for local `file:` SQLite databases and
+ *   Turso's hosted libSQL service
+ * - Uses Drizzle ORM via drizzle-orm/libsql
+ * - Exposes a typed DbPort<TSchema> on ports
+ * - Uses SQLITE_-prefixed env vars for connection config
+ *
+ * @template TSchema - The Drizzle schema type (inferred from the schema parameter)
+ * @param options - Configuration options including the schema
+ * @returns A service provider that can be used with createNextServer
+ *
+ * @example
+ * ```ts
+ * import * as schema from "@/db/schema";
+ * import { createDrizzleSqliteProvider } from "@beignet/provider-db-drizzle/sqlite";
+ *
+ * export const drizzleSqliteProvider = createDrizzleSqliteProvider({ schema });
+ * ```
+ */
+export declare function createDrizzleSqliteProvider<TSchema extends Record<string, unknown>, PortName extends string = "db">(options: DrizzleSqliteProviderOptions<TSchema, PortName>): import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
+    DB_URL: z.ZodString;
+    DB_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, Record<PortName, DbPort<TSchema>>, unknown, void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/sqlite/index.d.ts.map

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