@molecule/api-payments-stripe 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,935 @@
+<!--
+AUTO-GENERATED — DO NOT EDIT THIS FILE.
+Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
+Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
+To change this document, edit the module-level JSDoc in src/index.ts.
+Generated: 2026-08-15T19:33:01.573Z
+-->
+
+# @molecule/api-payments-stripe
+
+> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
+> It is written to be read by coding agents as much as by people, and is generated from this
+> package's source — edit `src/index.ts` JSDoc, not this file.
+
+Stripe payment provider for molecule.dev.
+
+## Type
+
+`provider`
+
+## Installation
+
+```bash
+npm install @molecule/api-payments-stripe @molecule/api-bond @molecule/api-i18n @molecule/api-jwt @molecule/api-payments @molecule/api-secrets stripe
+```
+
+## API
+
+### Interfaces
+
+#### `AccountStatus`
+
+Connected-account onboarding / payout eligibility status.
+
+```typescript
+interface AccountStatus {
+  /** Stripe connected account ID. */
+  id: string
+  /** Whether the account can accept charges. */
+  chargesEnabled: boolean
+  /** Whether the account can receive payouts. */
+  payoutsEnabled: boolean
+  /** Whether there are any currently-due requirements (Stripe is blocked on something). */
+  requirementsCurrent: boolean
+  /** Stripe connected-account type (`standard`, `express`, `custom`), if known. */
+  type?: ConnectedAccountType
+  /** Currently-due requirement IDs from Stripe (empty when nothing is due). */
+  currentlyDue: readonly string[]
+}
+```
+
+#### `CheckoutSessionResult`
+
+Result of creating or retrieving a checkout session.
+
+```typescript
+interface CheckoutSessionResult {
+  id: string
+  url: string | null
+  /** The Stripe Subscription ID created by the checkout session, if available. */
+  subscription?: string
+}
+```
+
+#### `ConnectedAccountBusinessProfile`
+
+Subset of Stripe `business_profile` fields commonly set during marketplace
+onboarding.
+
+```typescript
+interface ConnectedAccountBusinessProfile {
+  name?: string
+  url?: string
+  productDescription?: string
+  supportEmail?: string
+  supportPhone?: string
+  mcc?: string
+}
+```
+
+#### `ConnectWebhookEvent`
+
+Normalized Connect webhook event.
+
+Provider-agnostic shape so consumers don't have to import Stripe types
+to dispatch on event kind.
+
+```typescript
+interface ConnectWebhookEvent {
+  /** Recognized Connect event type, or `unknown` for unrelated events. */
+  type: ConnectWebhookEventType
+  /** Original Stripe event type string (e.g. `account.updated`). */
+  rawType: string
+  /** The ID of the primary resource this event is about (account, payout, transfer, fee). */
+  resourceId?: string
+  /** The connected account this event applies to, if Stripe sent one. */
+  accountId?: string
+  /** Raw event-data object (plain JSON shape — never the live Stripe object). */
+  data: Record<string, unknown>
+}
+```
+
+#### `CreateAccountLinkParams`
+
+Parameters for creating an account link.
+
+```typescript
+interface CreateAccountLinkParams {
+  /** Stripe connected account ID (`acct_...`). */
+  accountId: string
+  /** URL Stripe redirects the user back to after onboarding completes. */
+  returnUrl: string
+  /** URL Stripe redirects the user to if the link expires before completion. */
+  refreshUrl: string
+  /** Whether this is a first-time onboarding link or an update link. */
+  type: AccountLinkType
+  /** Optional idempotency key for safe retries. */
+  idempotencyKey?: string
+}
+```
+
+#### `CreateAccountLinkResult`
+
+Result of creating an account link.
+
+```typescript
+interface CreateAccountLinkResult {
+  /** Hosted onboarding URL the connected account holder should open. */
+  url: string
+  /** Unix timestamp (seconds) when the link expires. */
+  expiresAt: number
+}
+```
+
+#### `CreateConnectedAccountParams`
+
+Parameters for creating a connected account.
+
+```typescript
+interface CreateConnectedAccountParams {
+  /** Stripe account type — `standard`, `express`, or `custom`. */
+  type: ConnectedAccountType
+  /** Two-letter ISO country code for the account holder (e.g. `US`, `GB`). */
+  country: string
+  /** Email address of the account holder. */
+  email: string
+  /** Optional business profile fields (display name, website, MCC, etc.). */
+  businessProfile?: ConnectedAccountBusinessProfile
+  /** Optional metadata to attach to the connected account. */
+  metadata?: Record<string, string>
+  /** Optional idempotency key for safe retries. */
+  idempotencyKey?: string
+}
+```
+
+#### `CreateConnectedAccountResult`
+
+Result of creating a connected account.
+
+```typescript
+interface CreateConnectedAccountResult {
+  /** Stripe connected account ID (`acct_...`). */
+  id: string
+  /** Optional onboarding URL (only present when an account link is created in the same flow). */
+  accountLinkUrl?: string
+}
+```
+
+#### `CreatePayoutParams`
+
+Parameters for creating a payout from a connected account's Stripe balance to its bank account.
+
+```typescript
+interface CreatePayoutParams {
+  /** Connected account ID to issue the payout from (`acct_...`). */
+  accountId: string
+  /** Amount in the smallest currency unit (e.g. cents for USD). */
+  amount: number
+  /** Three-letter ISO currency code, lowercase (e.g. `usd`). */
+  currency: string
+  /** Optional payout method — `standard` or `instant`. */
+  method?: 'standard' | 'instant'
+  /** Optional metadata. */
+  metadata?: Record<string, string>
+  /** Optional idempotency key for safe retries. */
+  idempotencyKey?: string
+}
+```
+
+#### `CreatePayoutResult`
+
+Result of creating a payout.
+
+```typescript
+interface CreatePayoutResult {
+  /** Stripe payout ID (`po_...`). */
+  id: string
+  /** Amount paid out (smallest currency unit). */
+  amount: number
+  /** Three-letter ISO currency code. */
+  currency: string
+  /** Payout status (e.g. `pending`, `paid`, `failed`). */
+  status: string
+  /** Estimated arrival date (Unix timestamp in seconds). */
+  arrivalDate: number
+}
+```
+
+#### `CreateTransferParams`
+
+Parameters for creating a transfer to a connected account.
+
+```typescript
+interface CreateTransferParams {
+  /** Amount in the smallest currency unit (e.g. cents for USD). */
+  amount: number
+  /** Three-letter ISO currency code, lowercase (e.g. `usd`). */
+  currency: string
+  /** Destination connected account ID (`acct_...`). */
+  destination: string
+  /** Optional source charge to attach the transfer to (for separate-charges-and-transfers flow). */
+  sourceTransaction?: string
+  /** Optional transfer group string (groups related transfers/charges together). */
+  transferGroup?: string
+  /** Optional metadata. */
+  metadata?: Record<string, string>
+  /** Optional idempotency key for safe retries. */
+  idempotencyKey?: string
+}
+```
+
+#### `CreateTransferResult`
+
+Result of creating a transfer.
+
+```typescript
+interface CreateTransferResult {
+  /** Stripe transfer ID (`tr_...`). */
+  id: string
+  /** Amount transferred (smallest currency unit). */
+  amount: number
+  /** Three-letter ISO currency code. */
+  currency: string
+  /** Destination connected account ID. */
+  destination: string
+  /** Transfer group, if set. */
+  transferGroup?: string
+}
+```
+
+#### `NormalizedPurchase`
+
+Normalized purchase information (for one-time purchases).
+
+```typescript
+interface NormalizedPurchase {
+  /**
+   * The payment provider.
+   */
+  provider: PaymentProviderName
+  /**
+   * The purchase/transaction ID.
+   */
+  purchaseId: string
+  /**
+   * The product ID.
+   */
+  productId: string
+  /**
+   * Whether the purchase is valid.
+   */
+  isValid: boolean
+  /**
+   * When the purchase was made (Unix timestamp in ms).
+   */
+  purchaseDate: number
+  /**
+   * Raw data from the provider.
+   */
+  rawData: unknown
+}
+```
+
+#### `NormalizedSubscription`
+
+Normalized subscription information.
+
+Use this interface to abstract away provider-specific differences.
+
+```typescript
+interface NormalizedSubscription {
+  /**
+   * The payment provider.
+   */
+  provider: PaymentProviderName
+  /**
+   * The subscription ID from the provider.
+   */
+  subscriptionId: string
+  /**
+   * The product/plan ID.
+   */
+  productId: string
+  /**
+   * Current subscription status.
+   */
+  status: SubscriptionStatus
+  /**
+   * Whether the subscription is currently active.
+   */
+  isActive: boolean
+  /**
+   * When the current period started (Unix timestamp in ms).
+   */
+  currentPeriodStart?: number
+  /**
+   * When the current period ends (Unix timestamp in ms).
+   */
+  currentPeriodEnd?: number
+  /**
+   * Whether the subscription will auto-renew.
+   */
+  willRenew?: boolean
+  /**
+   * When the subscription was canceled (if applicable).
+   */
+  canceledAt?: number
+  /**
+   * Raw data from the provider.
+   */
+  rawData: unknown
+}
+```
+
+#### `SubscriptionResult`
+
+Normalized subscription data from Stripe.
+
+```typescript
+interface SubscriptionResult {
+  id: string
+  status: string
+  /**
+   * The Stripe Customer ID (`cus_...`) that owns this subscription. Used to bind
+   * a verified subscription to the calling user so a foreign subscription id
+   * cannot be claimed (ownership check in `verifyPayment`).
+   */
+  customer?: string
+  items: { data: Array<{ id: string; price?: { id?: string; product?: string } }> }
+  current_period_start: number
+  current_period_end: number
+  cancel_at_period_end: boolean
+  canceled_at: number | null
+}
+```
+
+#### `SubscriptionUpdateParams`
+
+Parameters for updating a subscription.
+
+```typescript
+interface SubscriptionUpdateParams {
+  items?: Array<{ id: string; price: string }>
+  cancel_at_period_end?: boolean
+}
+```
+
+#### `WebhookEventResult`
+
+Result of verifying a webhook event.
+
+```typescript
+interface WebhookEventResult {
+  type: string
+  data: { object: Record<string, unknown> }
+}
+```
+
+### Types
+
+#### `AccountLinkType`
+
+Account-link types — onboarding (first-time) vs update (returning).
+
+```typescript
+type AccountLinkType = 'account_onboarding' | 'account_update'
+```
+
+#### `ConnectedAccountType`
+
+Connected account type.
+
+Stripe distinguishes three account types with different
+onboarding / dashboard responsibilities. See
+https://stripe.com/docs/connect/accounts.
+
+```typescript
+type ConnectedAccountType = 'standard' | 'express' | 'custom'
+```
+
+#### `ConnectWebhookEventType`
+
+Connect webhook event types this provider knows how to interpret.
+
+`unknown` is returned for any other Stripe event so callers can fall
+through to the standard subscription webhook handler if needed.
+
+```typescript
+type ConnectWebhookEventType =
+  'account.updated' | 'payout.created' | 'transfer.created' | 'application_fee.refunded' | 'unknown'
+```
+
+#### `PaymentProvider`
+
+Payment provider bond interface.
+
+Each payment provider implements the methods relevant to its platform.
+All methods are optional since different platforms use different flows.
+
+```typescript
+type PaymentProvider = PaymentProviderInterface
+```
+
+#### `SubscriptionStatus`
+
+Subscription status across providers.
+
+```typescript
+type SubscriptionStatus =
+  'active' | 'canceled' | 'expired' | 'past_due' | 'trialing' | 'paused' | 'pending' | 'unknown'
+```
+
+### Functions
+
+#### `cancelSubscription(subscriptionId)`
+
+Immediately cancels a Stripe subscription.
+
+```typescript
+function cancelSubscription(subscriptionId: string): Promise<SubscriptionResult>
+```
+
+- `subscriptionId` — The Stripe subscription ID to cancel.
+
+**Returns:** The canceled subscription result.
+
+#### `createAccountLink(params)`
+
+Creates a Stripe account link the connected account holder uses to finish
+onboarding (or to update payout details).
+
+```typescript
+function createAccountLink(params: CreateAccountLinkParams): Promise<CreateAccountLinkResult>
+```
+
+- `params` — Account-link creation parameters.
+
+**Returns:** The hosted onboarding/update URL and its expiry (Unix timestamp, seconds).
+
+#### `createCheckoutSession(options)`
+
+Creates a Stripe Checkout session for a new subscription.
+
+```typescript
+function createCheckoutSession(options: {
+  priceId: string
+  successUrl: string
+  cancelUrl: string
+  customerId?: string
+  clientReferenceId?: string
+  metadata?: Record<string, string>
+  idempotencyKey?: string
+}): Promise<CheckoutSessionResult>
+```
+
+- `options` — Checkout configuration.
+- `options.priceId` — The Stripe Price ID for the subscription line item.
+- `options.successUrl` — URL to redirect to after successful payment.
+- `options.cancelUrl` — URL to redirect to if the user cancels.
+- `options.customerId` — Optional existing Stripe Customer ID.
+- `options.clientReferenceId` — Your own id for the buyer (the app's user id). Stripe echoes it back as `client_reference_id` on the session and on every `checkout.session.*` webhook event, which is how the customer (`cus_…`) created by this checkout gets linked to the account that paid. Always pass it: without it the first purchase has nothing tying the new Stripe customer to a user.
+- `options.metadata` — Optional key-value metadata to attach to the session.
+- `options.idempotencyKey` — Optional idempotency key for safe request retries.
+
+**Returns:** The checkout session ID and URL.
+
+#### `createConnectedAccount(params)`
+
+Creates a Stripe connected account for a marketplace seller / driver / provider.
+
+```typescript
+function createConnectedAccount(
+  params: CreateConnectedAccountParams,
+): Promise<CreateConnectedAccountResult>
+```
+
+- `params` — Connected-account creation parameters.
+
+**Returns:** The new account ID.
+
+#### `createPayout(params)`
+
+Issues a payout from a connected account's Stripe balance to its bank account.
+
+Uses Stripe's `Stripe-Account` header to scope the call to the connected account.
+
+```typescript
+function createPayout(params: CreatePayoutParams): Promise<CreatePayoutResult>
+```
+
+- `params` — Payout parameters.
+
+**Returns:** The created payout.
+
+#### `createPortalSession(options)`
+
+Creates a Stripe Billing Portal session so the user can manage their
+subscription (update payment method, cancel, view invoices) in Stripe's
+hosted portal.
+
+```typescript
+function createPortalSession(options: {
+  customerId: string
+  returnUrl?: string
+}): Promise<{ id: string; url: string } | null>
+```
+
+- `options` — Portal configuration.
+- `options.customerId` — The Stripe Customer ID to open the portal for.
+- `options.returnUrl` — URL Stripe returns the user to when they exit the portal. Falls back to APP_ORIGIN/ORIGIN when omitted.
+
+**Returns:** The portal session ID and URL, or `null` when Stripe rejects the request (e.g. unknown customer).
+
+#### `createSetupIntent(options)`
+
+Creates a Stripe SetupIntent for the saved-card flow.
+
+If `customerId` is not provided, a new Stripe customer is created and its
+ID is returned alongside the SetupIntent so the resource layer can persist
+the customer ID for future SetupIntents and detachments.
+
+```typescript
+function createSetupIntent(options: {
+  customerId?: string
+  metadata?: Record<string, string>
+  idempotencyKey?: string
+}): Promise<{ id: string; clientSecret: string; customerId: string }>
+```
+
+- `options` — SetupIntent creation options.
+- `options.customerId` — Optional existing Stripe customer ID (`cus_...`).
+- `options.metadata` — Optional metadata to attach to the SetupIntent.
+- `options.idempotencyKey` — Optional idempotency key for safe retries.
+
+**Returns:** The SetupIntent ID, client secret, and customer ID.
+
+#### `createTransfer(params)`
+
+Transfers funds from the platform balance to a connected account.
+
+```typescript
+function createTransfer(params: CreateTransferParams): Promise<CreateTransferResult>
+```
+
+- `params` — Transfer parameters.
+
+**Returns:** The created transfer.
+
+#### `detachPaymentMethod(paymentMethodId)`
+
+Detaches a saved Stripe payment method from its customer.
+
+```typescript
+function detachPaymentMethod(paymentMethodId: string): Promise<boolean>
+```
+
+- `paymentMethodId` — The Stripe payment method ID (`pm_...`).
+
+**Returns:** `true` if Stripe acknowledged the detach, `false` otherwise.
+
+#### `getAccountStatus(accountId)`
+
+Looks up a connected account's onboarding / payout status.
+
+```typescript
+function getAccountStatus(accountId: string): Promise<AccountStatus>
+```
+
+- `accountId` — Stripe connected account ID (`acct_...`).
+
+**Returns:** Normalized account status.
+
+#### `getCheckoutSession(sessionId)`
+
+Retrieves a Stripe Checkout session by ID, including the associated subscription.
+
+```typescript
+function getCheckoutSession(sessionId: string): Promise<CheckoutSessionResult>
+```
+
+- `sessionId` — The Stripe Checkout session ID.
+
+**Returns:** The session ID, URL, and subscription ID (if a subscription was created).
+
+#### `getClient()`
+
+Returns the lazily-initialized Stripe client. Throws if `STRIPE_SECRET_KEY` is not set.
+
+```typescript
+function getClient(): Stripe
+```
+
+**Returns:** The shared `Stripe` SDK instance.
+
+#### `getSubscription(subscriptionId)`
+
+Retrieves a Stripe subscription by ID with expanded item data.
+
+```typescript
+function getSubscription(subscriptionId: string): Promise<SubscriptionResult>
+```
+
+- `subscriptionId` — The Stripe subscription ID.
+
+**Returns:** The normalized subscription result.
+
+#### `normalizeSubscription(subscription)`
+
+Normalizes a Stripe-specific `SubscriptionResult` to the common
+`NormalizedSubscription` interface used across all payment providers.
+
+```typescript
+function normalizeSubscription(subscription: SubscriptionResult): NormalizedSubscription
+```
+
+- `subscription` — The Stripe subscription result to normalize.
+
+**Returns:** A `NormalizedSubscription` with provider-agnostic fields.
+
+#### `normalizeSubscriptionStatus(rawStatus)`
+
+Maps a raw Stripe subscription status string (e.g. `past_due`, `incomplete`)
+to the provider-agnostic `SubscriptionStatus`.
+
+Shared between `normalizeSubscription` (verify path) and the webhook adapter so
+both paths derive status identically.
+
+```typescript
+function normalizeSubscriptionStatus(rawStatus: string | undefined): SubscriptionStatus
+```
+
+- `rawStatus` — The raw Stripe `status` string, or `undefined` if absent.
+
+**Returns:** The normalized `SubscriptionStatus` (`'unknown'` for unrecognized/missing).
+
+#### `processConnectWebhook(headers, body)`
+
+Verifies and normalizes a Stripe Connect webhook event.
+
+Reuses the same `STRIPE_WEBHOOK_SECRET` env var as the standard webhook
+pipeline (and the same signature verification logic) — Connect events
+arrive on the same webhook endpoint when the platform's webhook is
+configured to receive Connect events.
+
+```typescript
+function processConnectWebhook(
+  headers: Record<string, string | string[] | undefined>,
+  body: string | Buffer<ArrayBufferLike>,
+): ConnectWebhookEvent
+```
+
+- `headers` — Request headers (looks up `stripe-signature`).
+- `body` — The raw request body (string or Buffer).
+
+**Returns:** The verified, normalized Connect webhook event.
+
+#### `reportUsageOverage(options)`
+
+Reports a usage-based OVERAGE charge to Stripe as a one-off invoice item
+against an existing customer (and, when given, attached to the open invoice
+of a specific subscription so it lands on the next cycle invoice).
+
+This is the supported, type-safe path on the installed Stripe SDK (v22):
+the legacy `subscriptionItems.createUsageRecord` API was removed in favor of
+metered-price meter events / invoice items. A positive-amount invoice item
+is the simplest cost-plus overage mechanism — Stripe aggregates open invoice
+items and bills them at the customer's cycle close, so repeated incremental
+calls accrete onto the same upcoming invoice.
+
+IDEMPOTENCY: the caller MUST pass a stable `idempotencyKey` derived from
+`(user, period, amount)` so a retry or a double-run within the same Stripe
+idempotency window (24h) is collapsed to a single invoice item and never
+double-charges (broker safety invariant 4).
+
+This function performs NO gating of its own — it charges whatever it is
+told to. The decision of WHETHER to charge (configured? opted-in? paid?
+over budget?) lives entirely in the molecule-dev billing module, which is
+the single inert/opt-in gate (safety invariants 1 + 2).
+
+```typescript
+function reportUsageOverage(options: {
+  customerId: string
+  amountCents: number
+  currency?: string
+  priceId: string
+  subscriptionId?: string
+  description?: string
+  metadata?: Record<string, string>
+  idempotencyKey: string
+}): Promise<{ id: string; amountCents: number }>
+```
+
+- `options` — Overage reporting options.
+- `options.customerId` — The Stripe customer to bill (`cus_...`).
+- `options.amountCents` — The overage amount in cents (must be `> 0`).
+- `options.currency` — ISO currency (defaults to `usd`).
+- `options.priceId` — The metered/overage Price id this reports against; recorded in metadata for reconciliation (the invoice item carries an explicit `amount`, so the price's unit amount is not used here).
+- `options.subscriptionId` — Optional subscription to attach the item to so it bills on that subscription's cycle invoice.
+- `options.description` — Human-readable line description.
+- `options.metadata` — Extra reconciliation metadata (e.g. period).
+- `options.idempotencyKey` — REQUIRED stable key (see IDEMPOTENCY above).
+
+**Returns:** The created invoice item id + the amount actually reported.
+
+#### `retrievePaymentMethod(paymentMethodId)`
+
+Retrieves a saved Stripe payment method (card) and returns normalized metadata.
+
+```typescript
+function retrievePaymentMethod(
+  paymentMethodId: string,
+): Promise<{ id: string; brand: string; last4: string; expMonth: number; expYear: number } | null>
+```
+
+- `paymentMethodId` — The Stripe payment method ID (`pm_...`).
+
+**Returns:** Brand, last4, and expiry, or `null` if the lookup fails.
+
+#### `updateSubscription(subscriptionId, params)`
+
+Updates a Stripe subscription (e.g. changes plan, sets cancel_at_period_end).
+
+```typescript
+function updateSubscription(
+  subscriptionId: string,
+  params: SubscriptionUpdateParams,
+): Promise<SubscriptionResult>
+```
+
+- `subscriptionId` — The Stripe subscription ID to update.
+- `params` — The Stripe subscription update parameters.
+
+**Returns:** The updated subscription result.
+
+#### `verifyWebhookSignature(payload, signature)`
+
+Verifies a Stripe webhook signature and parses the event payload.
+Requires `STRIPE_WEBHOOK_SECRET` env var.
+
+```typescript
+function verifyWebhookSignature(
+  payload: string | Buffer<ArrayBufferLike>,
+  signature: string,
+): WebhookEventResult
+```
+
+- `payload` — The raw request body (string or Buffer).
+- `signature` — The `stripe-signature` header value.
+
+**Returns:** The verified webhook event with type and data.
+
+### Constants
+
+#### `paymentProvider`
+
+PaymentProvider-compatible adapter for Stripe.
+
+Wraps the Stripe SDK functions into a `PaymentProvider`-compatible object
+for use with the molecule bond system. Supports subscription verification,
+webhook handling, plan upgrades/downgrades, and cancellation.
+
+```typescript
+const paymentProvider: PaymentProviderInterface
+```
+
+#### `stripeSecretDefinitions`
+
+Secret definitions required by the Stripe payments bond.
+
+```typescript
+const stripeSecretDefinitions: SecretDefinition[]
+```
+
+## Core Interface
+
+Implements `@molecule/api-payments` interface.
+
+## Bond Wiring
+
+Setup function to register this provider with the bond system:
+
+```typescript
+import { bond } from '@molecule/api-bond'
+import { paymentProvider } from '@molecule/api-payments-stripe'
+
+export function setupPaymentsStripe(): void {
+  bond('payments', 'stripe', paymentProvider)
+}
+```
+
+## Injection Notes
+
+### Requirements
+
+Peer dependencies:
+
+- `@molecule/api-bond` ^1.0.1
+- `@molecule/api-i18n` ^1.0.1
+- `@molecule/api-payments` ^1.0.1
+- `@molecule/api-jwt` ^1.0.1
+- `@molecule/api-secrets` ^1.0.1
+
+### Environment Variables
+
+- `STRIPE_SECRET_KEY` _(required)_ — Stripe secret key
+  - Setup: Stripe Dashboard → Developers → API keys; use the sk_test_ key in test mode, sk_live_ in production.
+  - Get it here: [https://dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys)
+  - Example: `sk_test_...`
+- `STRIPE_WEBHOOK_SECRET` _(required)_ — Stripe webhook signing secret
+  - Setup: Stripe Dashboard → Developers → Webhooks → Add endpoint pointing at {apiUrl}/api/users/payment-notification/stripe, then copy its signing secret.
+  - Get it here: [https://dashboard.stripe.com/webhooks](https://dashboard.stripe.com/webhooks)
+  - Example: `whsec_...`
+
+### Runtime Dependencies
+
+- `@molecule/api-bond`
+- `@molecule/api-i18n`
+- `@molecule/api-jwt`
+- `@molecule/api-payments`
+- `@molecule/api-secrets`
+- `stripe`
+
+Bond this as the payments provider so `@molecule/api-payments`'s `verifySubscription` (and
+the payment resource) work server-side — don't call the Stripe SDK directly for
+verification. Env: `STRIPE_SECRET_KEY` + `STRIPE_WEBHOOK_SECRET` are SERVER-ONLY; only the
+publishable key (`pk_…`) is client-side.
+
+**You do NOT need molecule's Express app, the `bond()` wiring, or the UI packages to use
+this — the functions below are framework-agnostic.** On a non-Express / non-molecule host
+(Next.js App Router, serverless functions, Hono, Fastify), import them and call them from
+your OWN route handlers:
+`import { createCheckoutSession, verifyWebhookSignature, getSubscription } from '@molecule/api-payments-stripe'`.
+They cover the whole flow — {@link createCheckoutSession} (server-owned `priceId`, so you
+never take a price/amount from the client), {@link createPortalSession} (hosted Billing
+Portal for payment-method updates/cancellation/invoices), {@link verifyWebhookSignature},
+and the subscription getters/updaters — and carry the security contract (config-not-configured
+errors, normalized status) for free, so reach for these instead of hand-rolling raw
+`stripe` calls. In a Next.js App Router route, read the RAW webhook body with
+`await req.text()` and the header with `req.headers.get('stripe-signature')`, then
+`verifyWebhookSignature(rawBody, signature)` (the `express.raw(...)` note below is the
+Express-host equivalent). Only `@molecule/api-middleware-billing-routes` (Express glue) and
+`@molecule/app-billing-react` (molecule UI) are framework-coupled — skip THOSE on such a
+host, but still use these bond functions underneath.
+
+Two things a weak Stripe integration gets wrong:
+
+- **The webhook body MUST be RAW for signature verification.** {@link verifyWebhookSignature}
+  (Stripe's `constructEvent`) hashes the exact bytes, so a parsed-then-re-serialized body
+  ALWAYS fails. In a molecule app you need NO special middleware: the always-included
+  `@molecule/api-middleware-body-parser-express` already captures the unparsed body as
+  `req.rawBody` (a string) on EVERY request — just pass `req.rawBody` + the `stripe-signature`
+  header to {@link verifyWebhookSignature}. Do NOT add a route-specific `express.raw(...)` here —
+  it is redundant and fights the global JSON parser (which has already consumed the stream and
+  set `req.rawBody`). (ONLY on a NON-molecule Express host that lacks `req.rawBody` do you mount
+  `express.raw({ type: 'application/json' })` before the JSON parser; on Next.js App Router read
+  the raw body with `await req.text()`.) NEVER act on an unverified webhook body — it is
+  attacker-controlled.
+- **Webhooks are redelivered — be idempotent.** Stripe retries until it gets a 2xx, so the
+  same `event.id` can arrive twice. Dedupe on it (the payment record's
+  `UNIQUE(platformKey, transactionId)` already blocks a double-grant), and return 2xx once
+  handled so Stripe stops retrying.
+
+Create checkout with SERVER-configured price ids ({@link createCheckoutSession}) — never an
+amount sent by the client.
+
+**Checkout returns the buyer to the APP, and the session must name the buyer.**
+`paymentProvider.updateSubscription` builds `success_url` /`cancel_url` with
+`resolveCheckoutRedirectUrls` from `@molecule/api-payments`, so Stripe returns to
+`APP_ORIGIN/plan-updated?provider=stripe&sessionId={CHECKOUT_SESSION_ID}` — the page
+then calls `POST /users/:id/verify-payment/stripe` with that id from an origin whose
+cookies authenticate. Returning to a separate API host instead sends a top-level
+redirect with NO credentials, so the callback answers 401 and the paid plan is never
+granted. It also sets `client_reference_id` + `metadata.userId` to the app's user id;
+they are how a webhook links the newly created `cus_…` to the account that paid on a
+FIRST purchase, and without them nothing ever writes the customer id — so any
+usage/metered billing keyed on it can never charge. Pass `clientReferenceId` when you
+call {@link createCheckoutSession} yourself.
+
+**A missing `STRIPE_SECRET_KEY` is NOT the same as "no active subscription."**
+`getClient()` throws a tagged config-not-configured error; `verifySubscription`,
+`updateSubscription`, and `cancelSubscription` on {@link paymentProvider} detect
+that tag (`isConfigNotConfiguredError` from `@molecule/api-payments`) and
+RETHROW it instead of swallowing it into the same `null` / `{ updated: false }`
+/ `false` a genuine verification/update failure returns — so a caller (or its
+own catch block) can tell "the operator forgot to set the secret" apart from
+"this subscription/card is invalid" and surface the actionable 503 instead of
+a generic 400/500.
+
+## E2E Tests
+
+Integration checklist — drive the real UI (live preview, no mocks; use the
+provider's TEST mode — test cards/sandbox accounts, never a live charge),
+adapt each item to this app's actual screens/flows, and check every box off
+one by one. A box you can't check is an integration bug to fix — not a skip:
+
+- [ ] Starting an upgrade/subscribe from the pricing or billing surface creates a
+      checkout session and hands off to the provider flow (redirect or embedded
+      element) — the button does something real, not a dead click.
+- [ ] Returning from a canceled/abandoned checkout leaves the user on their
+      original plan with a sane UI (no phantom entitlement, no error page).
+- [ ] Entitlement flips ONLY after server-side verification (webhook or verify
+      call) — reloading after a client-side-only "success" must NOT show a paid
+      plan unless the server verified it. The sandbox CAPTURES webhook deliveries
+      — read them with the `read_activity` tool (filter type 'webhook'); never
+      mock the event or modify production code to fake an entitlement.
+- [ ] The current subscription status (plan name, renewal/expiry) renders on the
+      account/billing screen, and canceling updates that status visibly.
+- [ ] With payment secrets unconfigured, the flow surfaces an actionable
+      "credentials not configured" message — not a silent no-op or generic 500.
+- [ ] The provider SECRET key never reaches the browser (page + network traffic
+      contain only the publishable key).
+
+## Translations
+
+Translation strings are provided by `@molecule/api-locales-payments-stripe`.

package/dist/bondAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bondAdapter.d.ts","sourceRoot":"","sources":["../src/bondAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAGL,KAAK,eAAe,EAOrB,MAAM,wBAAwB,CAAA;AA6C/B;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,eA8Z7B,CAAA"}
+{"version":3,"file":"bondAdapter.d.ts","sourceRoot":"","sources":["../src/bondAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAGL,KAAK,eAAe,EAQrB,MAAM,wBAAwB,CAAA;AA6C/B;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,eAwa7B,CAAA"}

package/dist/bondAdapter.js

@@ -10,7 +10,7 @@ import crypto from 'crypto';
 import { getLogger } from '@molecule/api-bond';
 const logger = getLogger();
 import { get } from '@molecule/api-bond';
-import { isConfigNotConfiguredError, } from '@molecule/api-payments';
+import { isConfigNotConfiguredError, resolveCheckoutRedirectUrls, } from '@molecule/api-payments';
 import { createCheckoutSession, createPortalSession as stripeCreatePortalSession, createSetupIntent as stripeCreateSetupIntent, detachPaymentMethod as stripeDetachPaymentMethod, getCheckoutSession, getSubscription, normalizeSubscription, normalizeSubscriptionStatus, retrievePaymentMethod as stripeRetrievePaymentMethod, updateSubscription as stripeUpdateSubscription, verifyWebhookSignature, } from './provider.js';
 /**
  * Maps Stripe webhook event types (e.g. `customer.subscription.created`) to
@@ -212,6 +212,10 @@ export const paymentProvider = {
      * 1. Looks up the user's existing Stripe subscription via PaymentRecordService.
      * 2. If found, updates the subscription to the new product/price.
      * 3. If not found, creates a Stripe Checkout session and returns the checkout URL.
+     *    The session returns the buyer to the APP's `/plan-updated` page (never the
+     *    API host — see `resolveCheckoutRedirectUrls`) and carries the user id as
+     *    `client_reference_id` + `metadata.userId` so the resulting customer can be
+     *    linked to the account that paid.
      *
      * Handles subscription updates and new checkout session creation.
      * @param params - The update parameters.
@@ -256,21 +260,20 @@ export const paymentProvider = {
                 }
             }
             // No existing subscription — create a Stripe Checkout session.
-            // Stripe rejects empty/relative success_url and cancel_url with
-            // `code: 'url_invalid'`. When neither API_ORIGIN/APP_ORIGIN nor
-            // ORIGIN is set (typical in dev / smoke-app spin-ups), fall back to
-            // `http://localhost:${PORT}` so checkout still works locally.
-            const apiPort = Number(process.env.PORT) || 4000;
-            const fallbackApiOrigin = `http://localhost:${apiPort}`;
-            // Conventional dev frontend lives on apiPort - 1000 (e.g. 4030 → 3030).
-            // Mirrors the polish-v2 dispatcher's port pairing.
-            const fallbackAppOrigin = `http://localhost:${apiPort - 1000}`;
-            const apiOrigin = process.env.API_ORIGIN || process.env.ORIGIN || fallbackApiOrigin;
-            const appOrigin = process.env.APP_ORIGIN || process.env.ORIGIN || fallbackAppOrigin;
-            if (apiOrigin === fallbackApiOrigin || appOrigin === fallbackAppOrigin) {
-                // Silent localhost redirect URLs in a deployed app strand the user on
-                // localhost after paying — make the fallback visible.
-                logger.warn(`Stripe checkout: API_ORIGIN/APP_ORIGIN/ORIGIN not set — falling back to ${fallbackApiOrigin} / ${fallbackAppOrigin} for redirect URLs (fine in dev, wrong in production).`);
+            // Both redirect URLs point at the APP origin: the session cookie is set
+            // for the app's host, so a top-level return to a separate API host
+            // carries no credentials and the authenticated verify route answers 401
+            // (the buyer pays and lands on an error page). The app's
+            // `/plan-updated` page verifies with the `cs_…` id from the query
+            // instead. Stripe rejects empty/relative URLs with `code: 'url_invalid'`,
+            // so an unset APP_ORIGIN/ORIGIN falls back to localhost — fine in dev,
+            // and warned about because it strands a deployed buyer.
+            const redirects = resolveCheckoutRedirectUrls({
+                provider: 'stripe',
+                sessionIdToken: '{CHECKOUT_SESSION_ID}',
+            });
+            if (redirects.usingFallbackOrigin) {
+                logger.warn(`Stripe checkout: APP_ORIGIN/ORIGIN not set — falling back to ${redirects.appOrigin} for redirect URLs (fine in dev, wrong in production).`);
             }
             // Generate idempotency key from userId + priceId + timestamp window (5-min buckets)
             // This prevents duplicate checkout sessions if the user double-clicks or retries
@@ -281,8 +284,15 @@ export const paymentProvider = {
                 .digest('hex');
             const session = await createCheckoutSession({
                 priceId: params.newProductId,
-                successUrl: `${apiOrigin}/api/users/${params.userId}/verify-payment/stripe?subscriptionId={CHECKOUT_SESSION_ID}`,
-                cancelUrl: appOrigin,
+                successUrl: redirects.successUrl,
+                cancelUrl: redirects.cancelUrl,
+                // Bind the session to the buying account BOTH ways Stripe echoes an
+                // app-side id back (top-level on `checkout.session.*`, and in
+                // `metadata` on objects that carry no client_reference_id). This is
+                // what lets a webhook link the new `cus_…` to the user on a FIRST
+                // purchase, before any customer id is stored.
+                clientReferenceId: params.userId,
+                metadata: { userId: params.userId },
                 idempotencyKey,
             });
             if (session?.id && session?.url) {

package/dist/bondAdapter.js.map

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

package/dist/index.d.ts

@@ -47,6 +47,19 @@
  * Create checkout with SERVER-configured price ids ({@link createCheckoutSession}) — never an
  * amount sent by the client.
  *
+ * **Checkout returns the buyer to the APP, and the session must name the buyer.**
+ * `paymentProvider.updateSubscription` builds `success_url` /`cancel_url` with
+ * `resolveCheckoutRedirectUrls` from `@molecule/api-payments`, so Stripe returns to
+ * `APP_ORIGIN/plan-updated?provider=stripe&sessionId={CHECKOUT_SESSION_ID}` — the page
+ * then calls `POST /users/:id/verify-payment/stripe` with that id from an origin whose
+ * cookies authenticate. Returning to a separate API host instead sends a top-level
+ * redirect with NO credentials, so the callback answers 401 and the paid plan is never
+ * granted. It also sets `client_reference_id` + `metadata.userId` to the app's user id;
+ * they are how a webhook links the newly created `cus_…` to the account that paid on a
+ * FIRST purchase, and without them nothing ever writes the customer id — so any
+ * usage/metered billing keyed on it can never charge. Pass `clientReferenceId` when you
+ * call {@link createCheckoutSession} yourself.
+ *
  * **A missing `STRIPE_SECRET_KEY` is NOT the same as "no active subscription."**
  * `getClient()` throws a tagged config-not-configured error; `verifySubscription`,
  * `updateSubscription`, and `cancelSubscription` on {@link paymentProvider} detect

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -47,6 +47,19 @@
  * Create checkout with SERVER-configured price ids ({@link createCheckoutSession}) — never an
  * amount sent by the client.
  *
+ * **Checkout returns the buyer to the APP, and the session must name the buyer.**
+ * `paymentProvider.updateSubscription` builds `success_url` /`cancel_url` with
+ * `resolveCheckoutRedirectUrls` from `@molecule/api-payments`, so Stripe returns to
+ * `APP_ORIGIN/plan-updated?provider=stripe&sessionId={CHECKOUT_SESSION_ID}` — the page
+ * then calls `POST /users/:id/verify-payment/stripe` with that id from an origin whose
+ * cookies authenticate. Returning to a separate API host instead sends a top-level
+ * redirect with NO credentials, so the callback answers 401 and the paid plan is never
+ * granted. It also sets `client_reference_id` + `metadata.userId` to the app's user id;
+ * they are how a webhook links the newly created `cus_…` to the account that paid on a
+ * FIRST purchase, and without them nothing ever writes the customer id — so any
+ * usage/metered billing keyed on it can never charge. Pass `clientReferenceId` when you
+ * call {@link createCheckoutSession} yourself.
+ *
  * **A missing `STRIPE_SECRET_KEY` is NOT the same as "no active subscription."**
  * `getClient()` throws a tagged config-not-configured error; `verifySubscription`,
  * `updateSubscription`, and `cancelSubscription` on {@link paymentProvider} detect

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/provider.d.ts

@@ -23,6 +23,12 @@ export declare const getClient: () => Stripe;
  * @param options.successUrl - URL to redirect to after successful payment.
  * @param options.cancelUrl - URL to redirect to if the user cancels.
  * @param options.customerId - Optional existing Stripe Customer ID.
+ * @param options.clientReferenceId - Your own id for the buyer (the app's user
+ *   id). Stripe echoes it back as `client_reference_id` on the session and on
+ *   every `checkout.session.*` webhook event, which is how the customer
+ *   (`cus_…`) created by this checkout gets linked to the account that paid.
+ *   Always pass it: without it the first purchase has nothing tying the new
+ *   Stripe customer to a user.
  * @param options.metadata - Optional key-value metadata to attach to the session.
  * @param options.idempotencyKey - Optional idempotency key for safe request retries.
  * @returns The checkout session ID and URL.
@@ -32,6 +38,7 @@ export declare const createCheckoutSession: (options: {
     successUrl: string;
     cancelUrl: string;
     customerId?: string;
+    clientReferenceId?: string;
     metadata?: Record<string, string>;
     idempotencyKey?: string;
 }) => Promise<CheckoutSessionResult>;

package/dist/provider.d.ts.map

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

package/dist/provider.js

@@ -83,6 +83,12 @@ const toSubscriptionResult = (sub) => {
  * @param options.successUrl - URL to redirect to after successful payment.
  * @param options.cancelUrl - URL to redirect to if the user cancels.
  * @param options.customerId - Optional existing Stripe Customer ID.
+ * @param options.clientReferenceId - Your own id for the buyer (the app's user
+ *   id). Stripe echoes it back as `client_reference_id` on the session and on
+ *   every `checkout.session.*` webhook event, which is how the customer
+ *   (`cus_…`) created by this checkout gets linked to the account that paid.
+ *   Always pass it: without it the first purchase has nothing tying the new
+ *   Stripe customer to a user.
  * @param options.metadata - Optional key-value metadata to attach to the session.
  * @param options.idempotencyKey - Optional idempotency key for safe request retries.
  * @returns The checkout session ID and URL.
@@ -101,6 +107,7 @@ export const createCheckoutSession = async (options) => {
             success_url: options.successUrl,
             cancel_url: options.cancelUrl,
             customer: options.customerId,
+            client_reference_id: options.clientReferenceId,
             metadata: options.metadata,
         }, options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : undefined);
         return { id: session.id, url: session.url };

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;AAC1B,sEAAsE;AACtE,2EAA2E;AAC3E,oCAAoC;AACpC,OAAO,cAAc,CAAA;AAGrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAShE;;;;GAIG;AACH,IAAI,OAAO,GAAkB,IAAI,CAAA;AAEjC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;QACzC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,2EAA2E;YAC3E,4EAA4E;YAC5E,yEAAyE;YACzE,yEAAyE;YACzE,4CAA4C;YAC5C,MAAM,wBAAwB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAA;QACjE,CAAC;QACD,4EAA4E;QAC5E,wEAAwE;QACxE,wEAAwE;QACxE,kDAAkD;QAClD,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,CAAC,GAAwB,EAAsB,EAAE;IAC5E,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;QAC5E,KAAK,EAAE;YACL,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClC,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,KAAK,EAAE,IAAI,CAAC,KAAK;oBACf,CAAC,CAAC;wBACE,yDAAyD;wBACzD,4DAA4D;wBAC5D,qDAAqD;wBACrD,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;wBACjB,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBACjF;oBACH,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;SACJ;QACD,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,IAAI,CAAC;QAC1D,kBAAkB,EAAE,SAAS,EAAE,kBAAkB,IAAI,CAAC;QACtD,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;QAC9C,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,OAQ3C,EAAkC,EAAE;IACnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,SAAS,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACxD;YACE,IAAI,EAAE,cAAc;YACpB,oBAAoB,EAAE,CAAC,MAAM,CAAC;YAC9B,UAAU,EAAE;gBACV;oBACE,KAAK,EAAE,OAAO,CAAC,OAAO;oBACtB,QAAQ,EAAE,CAAC;iBACZ;aACF;YACD,WAAW,EAAE,OAAO,CAAC,UAAU;YAC/B,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,QAAQ,EAAE,OAAO,CAAC,UAAU;YAC5B,mBAAmB,EAAE,OAAO,CAAC,iBAAiB;YAC9C,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,EACD,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAChF,CAAA;QAED,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAA;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAA;QAC9D,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAGzC,EAA+C,EAAE;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,CAAA;QAChG,MAAM,OAAO,GAAG,MAAM,SAAS,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC9D,QAAQ,EAAE,OAAO,CAAC,UAAU;YAC5B,UAAU,EAAE,SAAS;SACtB,CAAC,CAAA;QACF,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAA;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAA;QACpE,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,SAAiB,EAAkC,EAAE;IAC5F,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,SAAS,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QACvE,MAAM,YAAY,GAChB,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ;YACtC,CAAC,CAAC,OAAO,CAAC,YAAY;YACtB,CAAC,CAAE,OAAO,CAAC,YAAuC,EAAE,EAAE,CAAA;QAC1D,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,CAAA;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAA;QAChE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,cAAsB,EAA+B,EAAE;IAC3F,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,SAAS,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE;YAC5E,MAAM,EAAE,CAAC,YAAY,CAAC;SACvB,CAAC,CAAA;QACF,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAA;QAC5D,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,cAAsB,EAA+B,EAAE;IAC9F,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAC3E,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAA;QAC3D,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,cAAsB,EACtB,MAAgC,EACH,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,SAAS,EAAE,CAAC,aAAa,CAAC,MAAM,CACzD,cAAc,EACd,MAAyC,CAC1C,CAAA;QACD,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAA;QAC1D,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAwB,EACxB,SAAiB,EACG,EAAE;IACtB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IACvD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,2EAA2E;QAC3E,yEAAyE;QACzE,wEAAwE;QACxE,2EAA2E;QAC3E,oEAAoE;QACpE,MAAM,wBAAwB,CAAC,uBAAuB,EAAE,8BAA8B,CAAC,CAAA;IACzF,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;IACpF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAA4C,EAAE;KAC1E,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAIvC,EAAqE,EAAE;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,IAAI,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAC5C,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAC9B,OAAO,CAAC,cAAc;gBACpB,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,WAAW,EAAE;gBAC1D,CAAC,CAAC,SAAS,CACd,CAAA;YACD,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAA;QAC1B,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAClD;YACE,QAAQ,EAAE,UAAU;YACpB,oBAAoB,EAAE,CAAC,MAAM,CAAC;YAC9B,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,EACD,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAChF,CAAA;QACD,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO;YACL,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,YAAY,EAAE,WAAW,CAAC,aAAa;YACvC,UAAU;SACX,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;QACzD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,eAAuB,EAOf,EAAE;IACV,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;QACrE,IAAI,CAAC,EAAE,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA;QACzB,OAAO;YACL,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;YACpB,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;YACpB,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;YAC3B,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ;SAC1B,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,eAAuB,EAAoB,EAAE;IACrF,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAA;QAC7D,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OASxC,EAAgD,EAAE;IACjD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,SAAS,EAAE,CAAC,YAAY,CAAC,MAAM,CACvD;YACE,QAAQ,EAAE,OAAO,CAAC,UAAU;YAC5B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;YACnC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE;SACnE,EACD,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAC3C,CAAA;QACD,OAAO,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAA;QAC5D,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAA6B,EAAsB,EAAE;IAC/F,MAAM,SAAS,GAAuC;QACpD,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,SAAS;QACrB,kBAAkB,EAAE,SAAS;QAC7B,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,UAAU;KACnB,CAAA;IAED,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,SAAS,CAAA;AACzD,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAgC,EAA0B,EAAE;IAChG,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,YAAY,CAAC,EAAE;QAC/B,SAAS,EAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAkB,IAAI,EAAE;QACvE,MAAM,EAAE,2BAA2B,CAAC,YAAY,CAAC,MAAM,CAAC;QACxD,QAAQ,EAAE,YAAY,CAAC,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,UAAU;QAChF,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,GAAG,IAAI;QAC5D,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,GAAG,IAAI;QACxD,SAAS,EAAE,CAAC,YAAY,CAAC,oBAAoB;QAC7C,UAAU,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;QAClF,OAAO,EAAE,YAAkD;KAC5D,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-payments-stripe",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Stripe payment provider for molecule.dev.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,7 +17,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": [
     "molecule",
@@ -34,11 +35,11 @@
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@molecule/api-bond": "^1.0.0",
-    "@molecule/api-i18n": "^1.0.0",
-    "@molecule/api-payments": "^1.0.0",
-    "@molecule/api-jwt": "^1.0.0",
-    "@molecule/api-secrets": "^1.0.0"
+    "@molecule/api-bond": "^1.0.1",
+    "@molecule/api-i18n": "^1.0.1",
+    "@molecule/api-payments": "^1.1.0",
+    "@molecule/api-jwt": "^1.0.1",
+    "@molecule/api-secrets": "^1.0.1"
   },
   "peerDependenciesMeta": {
     "@molecule/api-payments": {