@codelitdev/billing 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeLit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,339 @@
+# @codelitdev/billing
+
+Provider-neutral billing engine for CodeLit products. It runs **inside** your API process against **your** PostgreSQL database. It is not a hosted billing service.
+
+Version **0.1.0-alpha.1**. Workflows, action grants, operator services, and lifecycle hooks are **experimental**. There is no v1 cutover until a second consumer (CourseLit) proves the same contracts.
+
+## Purpose
+
+CodeLit products sell their own SaaS (organizations, schools, later other aggregates) through a payment provider. Without a shared engine, each product tends to grow its own catalog, checkout, webhooks, and reconciliation — and those copies diverge on the parts that are easy to get wrong.
+
+This package standardizes those mechanics:
+
+- Immutable, versioned price catalogs verified against the provider
+- Checkout, customer portal, cancellation, and plan change
+- Webhook verification, durable inbox, retrieve-current-then-project
+- Subscription transitions, material projection diffs, and reconciliation leases
+- Provider-safe public catalog / commercial-state read models
+- Fake + Dodo adapters behind one contract
+
+Your product still owns:
+
+- Who is billed (organization, school, …)
+- Plan names, entitlements, quotas, trials, grace, availability
+- Auth, CSRF, recent-auth tokens, HTTP routes, UI
+- Schema migrations, backfills, encryption keys, audit storage, alerts
+
+The package never runs DDL on install, import, or process startup.
+
+## Install
+
+```bash
+pnpm add @codelitdev/billing@0.1.0-alpha.1
+# or: pnpm add @codelitdev/billing@alpha
+# Dodo is an optional peer of the Dodo adapter
+pnpm add dodopayments
+```
+
+Public imports (do not import `src/`):
+
+| Subpath | Use |
+| --- | --- |
+| `@codelitdev/billing/config` | `defineBillingConfig` |
+| `@codelitdev/billing/drizzle` | `createDrizzleBillingStore` |
+| `@codelitdev/billing/workflows` | `createBilling` (experimental) |
+| `@codelitdev/billing/operations` | Operator inspect / retry / cancel |
+| `@codelitdev/billing/providers` | Registry, fake, contract types |
+| `@codelitdev/billing/providers/dodo` | `createDodoBillingProvider` |
+| `@codelitdev/billing/core` | Statuses, money, errors, clock |
+| `@codelitdev/billing/catalog` | Offer validation / public catalog |
+| `@codelitdev/billing/testing` | Provider contract + workflow harness |
+
+CLI:
+
+```bash
+pnpm exec codelit-billing generate --config billing.config.ts
+pnpm exec codelit-billing generate --check --config billing.config.ts
+```
+
+## How it fits together
+
+```
+Your API / UI
+  auth, grants, plan policy, entitlements
+       │
+       ▼
+  createBilling  ──► catalog + state machines
+                 ──► provider adapter (Dodo / fake)
+                 ──► Drizzle store ──► your Postgres
+                 ──► your audit + afterProjection hooks
+```
+
+Hexagonal rules that matter in practice:
+
+- Core never reads `process.env` or wall time. You inject a `Clock` and provider options.
+- No database transaction is held across a provider HTTP call. Durable checkout / webhook / job rows bridge that gap.
+- A verified webhook is a wake-up. Entitlement changes only after `retrieveSubscription` and a material snapshot diff.
+- Cloud composition requires an audit hook and a return-URL allowlist.
+
+## 1. Describe schema (`billing.config.ts`)
+
+Same idea as Better Auth: the package owns the canonical model; you check in generated TypeScript and own SQL via drizzle-kit.
+
+```ts
+import { defineBillingConfig } from "@codelitdev/billing/config";
+
+export default defineBillingConfig({
+  dialect: "postgresql",
+  adapter: "drizzle",
+  output: "./src/db/schema/billing.generated.ts",
+  billableEntity: {
+    modelName: "organization",
+    tableImport: "./organizations",
+    tableExport: "organizations",
+    idColumn: "id",
+    idType: "uuid",
+    onDelete: "restrict",
+  },
+  payer: {
+    modelName: "user",
+    tableImport: "./auth",
+    tableExport: "user",
+    idColumn: "id",
+    idType: "text",
+    onDelete: "restrict",
+  },
+  planIds: ["pro", "business"],
+  requiredOfferKeys: [
+    "pro_month",
+    "pro_year",
+    "business_month",
+    "business_year",
+  ],
+  additionalFields: {
+    checkoutAttempts: {
+      pendingTeamName: { type: "text", nullable: true },
+    },
+  },
+});
+```
+
+`planIds` are **paid** plans persisted on canonical rows. A product Free plan or cardless trial stays in your tables — do not put `"free"` here.
+
+Then:
+
+```bash
+pnpm exec codelit-billing generate --config apps/api/billing.config.ts
+pnpm exec drizzle-kit generate
+pnpm exec drizzle-kit migrate
+```
+
+CI should run `generate --check` so committed `billing.generated.ts` cannot drift. Hand-edit SQL for backfills (for example seeding a Free `billing_plan_states` row); never edit the generated TypeScript.
+
+Examples: `examples/reference-product/`, `examples/consumers/sendlit/`.
+
+## 2. Compose the engine
+
+Parse your own env. Pass typed Dodo options. Wire Drizzle, grants, encryption, and product effects.
+
+```ts
+import { systemClock } from "@codelitdev/billing/core";
+import { createDrizzleBillingStore } from "@codelitdev/billing/drizzle";
+import { createBilling } from "@codelitdev/billing/workflows";
+import { createDodoBillingProvider } from "@codelitdev/billing/providers/dodo";
+import { db } from "./db/client";
+import * as billingSchema from "./db/billing.generated";
+
+const clock = systemClock;
+const store = createDrizzleBillingStore(db, {
+  schema: billingSchema,
+  clock,
+  planStateDefaults: { plan: "free", rampStage: 0, rampCleanStageDays: 0 },
+  checkoutApplicationFields: {
+    toColumns: (fields) => ({
+      pendingTeamName:
+        typeof fields.pendingTeamName === "string"
+          ? fields.pendingTeamName
+          : null,
+    }),
+    fromRow: (row) => ({ pendingTeamName: row.pendingTeamName ?? null }),
+  },
+});
+
+export const billing = createBilling({
+  database: store,
+  providers: [
+    createDodoBillingProvider({
+      apiKey: process.env.DODO_PAYMENTS_API_KEY!,
+      environment: "test_mode", // or "live_mode"
+      webhookSecrets: [
+        { version: "current", secret: process.env.DODO_PAYMENTS_WEBHOOK_KEY_CURRENT! },
+      ],
+      clock,
+    }),
+  ],
+  clock,
+  authorization: yourGrantPort, // consume-once BillingAuthorizationPort
+  sensitiveValues: yourEncryptPort,
+  hooks: {
+    audit: yourAuditHook,
+    lifecycle: {
+      afterProjection: (input) =>
+        applyProductEffects(input, store.getTransaction() ?? db),
+    },
+  },
+  mode: "cloud", // "oss" forbids providers, offers, and catalog revision
+  checkoutProvider: "dodo",
+  requestedRevision: 1,
+  requiredOfferKeys: ["pro_month", "pro_year", "business_month", "business_year"],
+  offers: yourOffers, // must match requiredOfferKeys exactly
+  returnUrlValidator: (url) =>
+    new URL(url).origin === new URL(process.env.WEB_CLIENT!).origin,
+});
+```
+
+`afterProjection` runs **inside** the engine transaction. Use `store.getTransaction() ?? db` and do **not** open a nested `db.transaction()` on the root pool client — that deadlocks on `FOR UPDATE` rows. If you were passed the engine client, write on it; only nest when you received the root `db`.
+
+OSS mode: `mode: "oss"`, empty providers, `checkoutProvider: ""`, `requestedRevision: null`, no offers. The engine rejects checkout; your product unlocks paid capabilities itself.
+
+## 3. Catalog at startup
+
+Cloud startup validates config shape and **records** the requested revision. It must not block ordinary API readiness on Dodo.
+
+```ts
+await billing.recordRequestedCatalog();
+// later, from a worker / sweep — not on the hot health path
+await billing.verifyRequestedCatalog();
+```
+
+Checkout is available only when that requested revision is the verified **active** revision. A pending or invalid request sets `checkoutAvailable: false` on the public catalog; the last verified revision remains the commercial projection. Operators abandon a bad request with `abandonRequestedCatalog` after reverting config.
+
+Immediately before creating a provider session, checkout re-fetches the selected product. A mismatch freezes new checkout; existing subscribers keep the last verified mapping.
+
+## 4. Human billing actions
+
+Your app authenticates the user, proves recent auth / CSRF however you like, then issues a **single-use** `BillingActionGrant`. The engine consumes the grant **and** checks the persisted payer. A fresh grant cannot switch the payer on an existing customer or subscription.
+
+```ts
+const { checkoutUrl } = await billing.startCheckout({
+  grant,
+  entity: { kind: "organization", id: organizationId },
+  payer: { id: userId, email, name },
+  offerKey: "pro_month",
+  catalogRevision: displayedRevision, // the revision the UI showed
+  returnUrl,
+  trialDays: 14, // 0 if ineligible; the package does not decide eligibility
+  applicationFields: { pendingTeamName: "Acme Team" },
+});
+```
+
+Other grant actions: `startPortal`, `startPlanChange`, `cancel`. Submit the catalog revision the user saw; a stale revision fails with `catalog_changed` and may include the current public catalog.
+
+Redirect is not payment. Entitlement changes from webhook projection or reconciliation.
+
+## 5. Webhooks and workers
+
+Preserve the **raw** body. Return 2xx after the event is durably inserted (duplicates included). Project asynchronously.
+
+```ts
+const ingested = await billing.ingestWebhook({
+  provider: "dodo",
+  raw: { body, headers },
+});
+res.status(ingested.duplicate ? 200 : 202).json({ accepted: true });
+void billing.runWebhookInboxBatch({ workerId: `billing-${process.pid}` });
+```
+
+The package does not start timers. Your scheduler should call, with unique `workerId`s:
+
+| Unit | Job |
+| --- | --- |
+| `runWebhookInboxBatch` | Drain verified events (retrieve + project) |
+| `runReconciliationBatch` | Stuck customers/checkouts/changes/subscriptions |
+| `runDeadlineBatch` | Expire open checkouts; drop elapsed paid-through entitlement |
+| `purgeExpiredSensitiveValues` | Drop old encrypted checkout URLs / replay payloads |
+| `verifyRequestedCatalog` | Finish a pending catalog revision |
+
+Multi-instance safety is database leases, not a process-local mutex. Never hold an app transaction across a provider call.
+
+## 6. Read models
+
+Ordinary routes must not call the provider.
+
+```ts
+const catalog = await billing.publicCatalog();
+// { revision, checkoutAvailable, offers: [{ key, plan, interval, amountMinor, currency, displayTrialDays }] }
+// no provider product IDs
+
+const commercial = await billing.commercialState(organizationId);
+// activePaidPlan, subscriptionStatus, periods, pendingCheckout / pendingPlanChange, projectionVersion
+```
+
+Compose those with your trial, Free plan, quotas, and `canManageBilling`. `projectionVersion` is a cache key; equivalent webhook replays update freshness only and do not increment it.
+
+Before close / delete / owner demotion, call `getBillableEntityBillingBlockers` / `getPayerBillingResponsibilities` in the same transaction as the mutation. The package reports blockers; you decide the user-facing error.
+
+Workflow failures are `BillingWorkflowError` with stable codes (`catalog_changed`, `payer_mismatch`, `checkout_pending`, …). Map them to HTTP in the app. Do not persist raw SDK messages.
+
+## 7. Operator CLI
+
+Product CLIs call `createOperations`. Every mutation needs `OperatorContext` (`actorId`, bounded `reason`, optional ticket) and hits the audit hook.
+
+```ts
+import { createOperations } from "@codelitdev/billing/operations";
+
+const ops = createOperations({
+  billing,
+  clock,
+  requestedRevision: 1,
+  checkoutProvider: "dodo",
+  sensitiveValues,
+});
+
+await ops.health();
+await ops.retryWebhook(ctx, providerEventId, "preserve_attempts");
+await ops.reconcileSubscription(ctx, subscriptionId);
+await ops.requestCancellation(ctx, subscriptionId);
+const payload = await ops.decryptReplay(ctx, ciphertext); // separately audited
+```
+
+Do not `UPDATE billing_webhook_events SET status = 'pending'` by hand. Retry either preserves the attempt counter or starts `new_budget`.
+
+Procedures: [`docs/runbooks.md`](docs/runbooks.md).
+
+## 8. Tests
+
+```ts
+import { runBillingProviderContract, createWorkflowHarness } from "@codelitdev/billing/testing";
+```
+
+- `runBillingProviderContract(adapter)` — every adapter, including Dodo in CI against the fake and gated sandbox tests against Dodo test mode.
+- `createWorkflowHarness()` — catalog, checkout, webhook ordering, grants, reconciliation without a network.
+
+`pnpm test` is deterministic. Live Dodo sandbox tests stay behind an explicit env gate.
+
+## What this package will not do
+
+- Product routes, ts-rest, MCP, or UI
+- Auth, membership, CSRF, or issuing action tokens
+- Automatic SQL on install/import/startup
+- A shared billing database
+- Usage metering, tax, or invoices in this alpha
+- Moving a live subscription from one provider to another
+- SendLit reputation, domains, or “one owned Free org” policy
+
+## Versioning
+
+- **0.1.0-alpha.x** — experimental workflows. Public core/schema/provider types aim to stay stable; workflow/hook contracts can still change. Install with the `alpha` tag, not `latest`.
+- Schema-changing package releases bump the generated schema version. Upgrade: bump the dependency → `generate` → review TS diff → `drizzle-kit generate` → add app backfills → migrate in the product job → deploy compatible API/worker.
+- Architecture and rollout: [`docs/architecture.md`](docs/architecture.md). Extraction discrepancies: [`docs/decisions/0001-extraction-discrepancies.md`](docs/decisions/0001-extraction-discrepancies.md).
+
+## Develop this repo
+
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+pnpm test:packed   # install the tarball via public exports only
+```

package/dist/adapters/drizzle/index.d.ts

@@ -0,0 +1,28 @@
+import { and, eq } from "drizzle-orm";
+import type { Clock } from "../../core/clock.js";
+import { createDrizzleBillingStore, type CheckoutApplicationFieldsCodec, type DrizzleBillingStore, type DrizzleBillingStoreOptions, type DrizzleDb, type GeneratedBillingSchema } from "./store.js";
+import type { BillingStore } from "../../persistence/store.js";
+export { createDrizzleBillingStore, type CheckoutApplicationFieldsCodec, type DrizzleBillingStore, type DrizzleBillingStoreOptions, type DrizzleDb, type GeneratedBillingSchema, };
+export type DrizzleLike = {
+    insert: (...args: never[]) => unknown;
+    select: (...args: never[]) => unknown;
+    update: (...args: never[]) => unknown;
+    transaction: <T>(fn: (tx: DrizzleLike) => Promise<T>) => Promise<T>;
+    execute?: (query: unknown) => Promise<unknown>;
+};
+export type DrizzleBillingAdapter = BillingStore & {
+    schema: GeneratedBillingSchema;
+    db: DrizzleLike;
+    clock: Clock;
+    withTransaction<T>(fn: (() => Promise<T>) | ((tx: DrizzleLike) => Promise<T>)): Promise<T>;
+    insertCheckoutAttempt(values: Record<string, unknown>): Promise<unknown>;
+    insertWebhookEvent(values: Record<string, unknown>): Promise<unknown>;
+    insertProviderCustomer(values: Record<string, unknown>): Promise<unknown>;
+    insertSubscriptionProjection(values: Record<string, unknown>): Promise<unknown>;
+    getCheckoutAttemptById(id: string): Promise<unknown>;
+    getWebhookEvent(provider: string, providerEventId: string): Promise<unknown>;
+    getSubscriptionProjection(provider: string, providerSubscriptionId: string): Promise<unknown>;
+};
+export declare function drizzleBillingAdapter(db: DrizzleLike, options: DrizzleBillingStoreOptions): DrizzleBillingAdapter;
+export { and, eq };
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/drizzle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAO,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACH,yBAAyB,EACzB,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EACH,yBAAyB,EACzB,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EACd,KAAK,sBAAsB,GAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD,CAAC;AAaF,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG;IAC/C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,CAAC,EACb,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,4BAA4B,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,eAAe,CACX,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,yBAAyB,CACrB,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,GAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,0BAA0B,GACpC,qBAAqB,CAoGvB;AAED,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC"}

package/dist/adapters/drizzle/index.js

@@ -0,0 +1,75 @@
+import { and, eq, sql } from "drizzle-orm";
+import { createDrizzleBillingStore, } from "./store.js";
+export { createDrizzleBillingStore, };
+export function drizzleBillingAdapter(db, options) {
+    const store = createDrizzleBillingStore(db, options);
+    const adapter = {
+        ...store,
+        schema: options.schema,
+        db,
+        clock: options.clock,
+        get transactionDepth() {
+            return store.transactionDepth;
+        },
+        async withTransaction(fn) {
+            return store.withTransaction(fn.length > 0
+                ? (tx) => fn(tx)
+                : fn);
+        },
+        async insertCheckoutAttempt(values) {
+            return db
+                .insert(options.schema.billingCheckoutAttempts)
+                .values(values)
+                .returning();
+        },
+        async insertWebhookEvent(values) {
+            return db
+                .insert(options.schema.billingWebhookEvents)
+                .values(values)
+                .returning();
+        },
+        async insertProviderCustomer(values) {
+            return db
+                .insert(options.schema.billingProviderCustomers)
+                .values(values)
+                .returning();
+        },
+        async insertSubscriptionProjection(values) {
+            return db
+                .insert(options.schema.billingSubscriptions)
+                .values(values)
+                .returning();
+        },
+        async getCheckoutAttemptById(id) {
+            const table = options.schema.billingCheckoutAttempts;
+            const rows = await db
+                .select()
+                .from(table)
+                .where(eq(table.id, id))
+                .limit(1);
+            return rows[0] ?? null;
+        },
+        async getWebhookEvent(providerName, providerEventId) {
+            const table = options.schema.billingWebhookEvents;
+            const rows = await db
+                .select()
+                .from(table)
+                .where(and(eq(table.provider, providerName), eq(table.providerEventId, providerEventId)))
+                .limit(1);
+            return rows[0] ?? null;
+        },
+        async getSubscriptionProjection(providerName, providerSubscriptionId) {
+            const table = options.schema.billingSubscriptions;
+            const rows = await db
+                .select()
+                .from(table)
+                .where(and(eq(table.provider, providerName), eq(table.providerSubscriptionId, providerSubscriptionId)))
+                .limit(1);
+            return rows[0] ?? null;
+        },
+    };
+    void sql;
+    return adapter;
+}
+export { and, eq };
+//# sourceMappingURL=index.js.map

package/dist/adapters/drizzle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/drizzle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACH,yBAAyB,GAM5B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,yBAAyB,GAM5B,CAAC;AA6CF,MAAM,UAAU,qBAAqB,CACjC,EAAe,EACf,OAAmC;IAEnC,MAAM,KAAK,GAAG,yBAAyB,CACnC,EAAwB,EACxB,OAAO,CACV,CAAC;IACF,MAAM,OAAO,GAA0B;QACnC,GAAG,KAAK;QACR,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,EAAE;QACF,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,gBAAgB;YAChB,OAAO,KAAK,CAAC,gBAAgB,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,eAAe,CACjB,EAA0D;YAE1D,OAAO,KAAK,CAAC,eAAe,CACxB,EAAE,CAAC,MAAM,GAAG,CAAC;gBACT,CAAC,CAAC,CAAC,EAAa,EAAE,EAAE,CACb,EAAsC,CACnC,EAAiB,CACpB;gBACP,CAAC,CAAE,EAAuB,CACjC,CAAC;QACN,CAAC;QACD,KAAK,CAAC,qBAAqB,CAAC,MAAM;YAC9B,OAAQ,EAAiB;iBACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAgC,CAAC;iBACvD,MAAM,CAAC,MAAM,CAAC;iBACd,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,MAAM;YAC3B,OAAQ,EAAiB;iBACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,oBAA6B,CAAC;iBACpD,MAAM,CAAC,MAAM,CAAC;iBACd,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,sBAAsB,CAAC,MAAM;YAC/B,OAAQ,EAAiB;iBACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,wBAAiC,CAAC;iBACxD,MAAM,CAAC,MAAM,CAAC;iBACd,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,4BAA4B,CAAC,MAAM;YACrC,OAAQ,EAAiB;iBACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,oBAA6B,CAAC;iBACpD,MAAM,CAAC,MAAM,CAAC;iBACd,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,sBAAsB,CAAC,EAAU;YACnC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,uBAE5B,CAAC;YACF,MAAM,IAAI,GAAG,MAAO,EAAiB;iBAChC,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAW,EAAE,EAAE,CAAC,CAAC;iBAChC,KAAK,CAAC,CAAC,CAAC,CAAC;YACd,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,YAAoB,EAAE,eAAuB;YAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,oBAG5B,CAAC;YACF,MAAM,IAAI,GAAG,MAAO,EAAiB;iBAChC,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CACF,GAAG,CACC,EAAE,CAAC,KAAK,CAAC,QAAiB,EAAE,YAAY,CAAC,EACzC,EAAE,CAAC,KAAK,CAAC,eAAwB,EAAE,eAAe,CAAC,CACtD,CACJ;iBACA,KAAK,CAAC,CAAC,CAAC,CAAC;YACd,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,yBAAyB,CAAC,YAAY,EAAE,sBAAsB;YAChE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,oBAG5B,CAAC;YACF,MAAM,IAAI,GAAG,MAAO,EAAiB;iBAChC,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CACF,GAAG,CACC,EAAE,CAAC,KAAK,CAAC,QAAiB,EAAE,YAAY,CAAC,EACzC,EAAE,CACE,KAAK,CAAC,sBAA+B,EACrC,sBAAsB,CACzB,CACJ,CACJ;iBACA,KAAK,CAAC,CAAC,CAAC,CAAC;YACd,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC3B,CAAC;KACJ,CAAC;IACF,KAAK,GAAG,CAAC;IACT,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC"}

package/dist/adapters/drizzle/store.d.ts

@@ -0,0 +1,37 @@
+import type { Clock } from "../../core/clock.js";
+import type { BillingStore } from "../../persistence/store.js";
+export type GeneratedBillingSchema = {
+    billingPriceEntries: unknown;
+    billingCatalogRevisions: unknown;
+    billingCatalogRevisionItems: unknown;
+    billingProviderCustomers: unknown;
+    billingCheckoutAttempts: unknown;
+    billingPlanChangeAttempts: unknown;
+    billingSubscriptions: unknown;
+    billingPlanStates: unknown;
+    billingWebhookEvents: unknown;
+    billingReconciliationJobs: unknown;
+};
+export type DrizzleDb = {
+    select: (...args: never[]) => unknown;
+    insert: (...args: never[]) => unknown;
+    update: (...args: never[]) => unknown;
+    transaction: <T>(fn: (tx: DrizzleDb) => Promise<T>) => Promise<T>;
+};
+export type DrizzleBillingStoreOptions = {
+    schema: GeneratedBillingSchema;
+    clock: Clock;
+    planStateDefaults?: Record<string, unknown>;
+    checkoutApplicationFields?: CheckoutApplicationFieldsCodec;
+};
+export type CheckoutApplicationFieldsCodec = {
+    toColumns(fields: Record<string, unknown>): Record<string, unknown>;
+    fromRow(row: Readonly<Record<string, unknown>>): Record<string, unknown>;
+};
+export type DrizzleBillingStore = BillingStore & {
+    withTransaction<T>(fn: (() => Promise<T>) | ((tx: DrizzleDb) => Promise<T>)): Promise<T>;
+    /** Open Drizzle transaction when called inside `withTransaction`. */
+    getTransaction(): DrizzleDb | undefined;
+};
+export declare function createDrizzleBillingStore(db: DrizzleDb, options: DrizzleBillingStoreOptions): DrizzleBillingStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/adapters/drizzle/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAQjD,OAAO,KAAK,EACR,YAAY,EAQf,MAAM,4BAA4B,CAAC;AACpC,MAAM,MAAM,sBAAsB,GAAG;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IACjC,2BAA2B,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,OAAO,CAAC;IAClC,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;IACnC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,yBAAyB,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACrE,CAAC;AAoBF,MAAM,MAAM,0BAA0B,GAAG;IACrC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,yBAAyB,CAAC,EAAE,8BAA8B,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IACzC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAC7C,eAAe,CAAC,CAAC,EACb,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,qEAAqE;IACrE,cAAc,IAAI,SAAS,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,0BAA0B,GACpC,mBAAmB,CAwxCrB"}