@fantastic.dev/better-stripe 0.24.0 → 0.25.1

package/CHANGELOG.md

@@ -26,6 +26,19 @@
 - Remove internal tracker references from public documentation and add a
   regression check that prevents their reintroduction.
 
+## [0.25.1](https://github.com/FantasticDevHQ/better-stripe/compare/v0.25.0...v0.25.1) (2026-10-15)
+
+### Bug Fixes
+
+- **webhooks:** reconcile payout generations before host callbacks ([#202](https://github.com/FantasticDevHQ/better-stripe/issues/202)) ([d8332c4](https://github.com/FantasticDevHQ/better-stripe/commit/d8332c4a3fd98b1cf10e289caa9c476e56b04c79))
+
+## [0.25.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.24.0...v0.25.0) (2026-10-15)
+
+### Features
+
+- **checkout:** expose immutable prepared request execution ([#199](https://github.com/FantasticDevHQ/better-stripe/issues/199)) ([a73454b](https://github.com/FantasticDevHQ/better-stripe/commit/a73454b3027613c5920be79e152610448c9ac70c))
+- **payouts:** collect ledger pages and schedule durable payout attempts ([#198](https://github.com/FantasticDevHQ/better-stripe/issues/198)) ([0ed1b2f](https://github.com/FantasticDevHQ/better-stripe/commit/0ed1b2f23ab34301d226fa65fe0c63e093f4f9e1))
+
 ## [0.24.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.23.2...v0.24.0) (2026-10-15)
 
 ### Features

package/README.md

@@ -48,14 +48,20 @@ provider outcome, and books its net payout fees once.
 The [combined release API](docs/settlement.md#combined-recipient-release) verifies
 complete source and payout history, reserves mature unpaid funds, and creates an
 idempotent bank payout. Install a host job to invoke it and expire due policies.
+The [automatic worker](docs/settlement.md#automatic-recipient-worker) provides
+durable attempt IDs, retry leases, recovery discovery and the next attempt time.
+The example installs its five-minute cron in `example/convex/crons.ts`.
 [Historical imports and explicit funded activation](docs/settlement.md#historical-import-and-funded-activation)
 verify old payouts, source ownership and holding age before enabling a custom
 schedule. Larger histories and unallocated money still require reconciliation;
 schedule controls alone do not enforce a minimum.
+[Resumable local collections and reset safeguards](docs/settlement.md#resumable-local-collections)
+provide bounded ledger inspection while provider-history continuation and scalable
+claim execution are completed.
 
 ## Status
 
-**Version**: `0.24.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
+**Version**: `0.25.1` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
 
 Used in production by its authors. Webhook pipeline is covered by unit tests and a live E2E harness (`npm run e2e:webhooks`) that fires real Stripe-signed events and asserts the ledger.
 

package/dist/client/billing/checkout.d.ts

@@ -1,48 +1,8 @@
+import { renderCheckoutSession } from "./checkoutRequest.js";
 import type Stripe from "stripe";
-import type { SplitRecipient } from "../../component/lib/fees.js";
 import type { Component, RunCtx } from "../helpers.js";
-import type { PlatformFeeConfig, StripeComponentCheckoutSession } from "../types.js";
-export declare function createCheckoutSession(stripe: Stripe, component: Component, ctx: RunCtx, opts: {
-    idempotencyKey?: string;
-    userId: string;
-    orgId?: string;
-    stripePriceId: string;
-    mode: "payment" | "subscription" | "setup";
-    uiMode?: "embedded" | "redirect" | "custom" | "form";
-    quantity?: number;
-    returnUrl: string;
-    trialDays?: number;
-    accountId?: string;
-    customerEmail?: string;
-    /**
-     * The seller/recipient connected account funds are routed to (destination
-     * charge). Fees only apply when this is set.
-     */
-    destinationAccountId?: string;
-    /**
-     * Multiple recipients for one sale (store + affiliate[s]). With >1 recipient
-     * this routes via separate charges & transfers (no `application_fee`); the
-     * transfers are created by the webhook engine. A single-recipient split is
-     * treated as a destination charge. Takes precedence over `destinationAccountId`.
-     */
-    split?: SplitRecipient[];
-    /** Resolved platform fee config (the caller resolves override → default). */
-    feeConfig?: PlatformFeeConfig;
-    /**
-     * Charge total in minor units (one-time payment mode). When known, the
-     * fixed `application_fee_amount` is computed up front; otherwise the fee is
-     * deferred to the webhook.
-     */
-    amount?: number;
-    /**
-     * Platform-default statement-descriptor suffix (BTS-32), used when the
-     * destination account record carries no per-store suffix. The caller
-     * (BetterStripe) passes its validated configured default.
-     */
-    defaultStatementDescriptorSuffix?: string;
-    metadata?: Record<string, string>;
-    sessionOverrides?: Record<string, unknown>;
-}): Promise<{
+import type { StripeComponentCheckoutSession } from "../types.js";
+export declare function createCheckoutSession(stripe: Stripe, component: Component, ctx: RunCtx, opts: Parameters<typeof renderCheckoutSession>[3]): Promise<{
     stripeSessionId: string;
     clientSecret: string | undefined;
     url: string | undefined;

package/dist/client/billing/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../../src/client/billing/checkout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../../src/client/billing/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAGlE,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC;;;;GAUlD;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAKhD;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAKhD;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAK3C;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;IAC3C,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,iBAQF;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,qDAMF"}

package/dist/client/billing/checkout.js

@@ -1,265 +1,10 @@
-import { idempotencyOptions } from "../core/idempotency.js";
-import { computeFee, isPercentOnlyFee, validateSplit } from "../core/fees.js";
-import { throwStripeError } from "../errors.js";
-import { runMutationOrThrow, stripReservedMetadata } from "../helpers.js";
+import { renderCheckoutSession } from "./checkoutRequest.js";
+import { submitPreparedCheckout } from "./preparedCheckout.js";
+import { runMutationOrThrow } from "../helpers.js";
 import { componentRef } from "../webhooks/helpers.js";
-/**
- * Derive the persisted fee/routing fields (BTS-11) from the FINAL Checkout
- * Session request, reading the nested `subscription_data`/`payment_intent_data`
- * that will actually be sent to Stripe. Deriving from the final request (rather
- * than a pre-override draft) keeps the stored row consistent when callers pass
- * `sessionOverrides` that replace those nested params.
- */
-function deriveFeeRow(params) {
-    const dest = (d) => typeof d === "string"
-        ? d
-        : (d?.id ?? undefined);
-    if (params.mode === "subscription") {
-        const destination = dest(params.subscription_data?.transfer_data?.destination);
-        if (!destination)
-            return {};
-        const pct = params.subscription_data?.application_fee_percent;
-        return {
-            chargeType: "destination",
-            destinationAccountId: destination,
-            ...(pct !== undefined ? { applicationFeePercent: pct } : {}),
-        };
-    }
-    if (params.mode === "payment") {
-        const destination = dest(params.payment_intent_data?.transfer_data?.destination);
-        if (!destination)
-            return {};
-        const amt = params.payment_intent_data?.application_fee_amount;
-        return {
-            chargeType: "destination",
-            destinationAccountId: destination,
-            ...(amt !== undefined ? { applicationFeeAmount: amt } : {}),
-        };
-    }
-    return {};
-}
-/**
- * Destination and separate charges use platform prices. Catalog accountId is a
- * store attribution tag, not Stripe ownership (createProduct uses the platform).
- * For tagged products, verify the price in the platform Stripe context before
- * rejecting it. Untagged/unknown catalog entries are validated by Checkout.
- */
-async function assertPlatformPrice(stripe, component, ctx, stripePriceId) {
-    const price = (await ctx.runQuery(componentRef(component, "products/queries/getPriceByStripeId"), { stripePriceId }));
-    if (!price?.stripeProductId)
-        return;
-    const product = (await ctx.runQuery(componentRef(component, "products/queries/getProductByStripeId"), { stripeProductId: price.stripeProductId }));
-    if (product?.accountId) {
-        try {
-            await stripe.prices.retrieve(stripePriceId);
-        }
-        catch (error) {
-            // Only absence on the platform means the ownership check failed.
-            // Auth/network/rate-limit failures must not be misreported as ownership.
-            if (!error ||
-                typeof error !== "object" ||
-                !("code" in error) ||
-                error.code !== "resource_missing")
-                throw error;
-            throwStripeError("INVALID_CONFIGURATION", `Price ${stripePriceId} is unavailable on the platform account; destination charges require a platform-owned price.`);
-        }
-    }
-}
-// =============================================================================
-// Checkout methods
-// =============================================================================
 export async function createCheckoutSession(stripe, component, ctx, opts) {
-    const uiMode = opts.uiMode ?? "embedded";
-    // Setup-mode sessions create no charge, so routing/fees are meaningless and
-    // would persist an unfunded `chargeType` the webhook engine can't act on.
-    if (opts.mode === "setup" &&
-        (opts.split?.length || opts.destinationAccountId || opts.feeConfig)) {
-        throwStripeError("INVALID_CONFIGURATION", "split/destinationAccountId/fee are not supported for setup-mode Checkout Sessions");
-    }
-    // Resolve the routing model. A `split` with >1 recipient uses separate charges
-    // & transfers (no application_fee; webhook engine creates the transfers); a
-    // single-recipient split is just a destination charge. `split` wins over
-    // `destinationAccountId`.
-    let isSeparate = false;
-    let destinationAccountId = opts.destinationAccountId;
-    if (opts.split && opts.split.length > 0) {
-        validateSplit(opts.split);
-        if (opts.split.length === 1) {
-            destinationAccountId = opts.split[0].destinationAccountId;
-        }
-        else {
-            isSeparate = true;
-        }
-    }
-    // Metadata markers the webhook split engine reads to create the transfers.
-    // For subscriptions these live on the subscription and are consumed on each
-    // invoice.paid; for one-time payments they live on the PaymentIntent.
-    const separateMeta = isSeparate
-        ? {
-            bsChargeType: "separate",
-            bsSplit: JSON.stringify(opts.split),
-            ...(opts.feeConfig
-                ? { bsFeeConfig: JSON.stringify(opts.feeConfig) }
-                : {}),
-        }
-        : {};
-    // Strip the reserved `bs*` namespace from caller metadata so it can't forge
-    // webhook instructions (e.g. trigger split transfers without routing).
-    const metadata = {
-        ...stripReservedMetadata(opts.metadata),
-        userId: opts.userId,
-        ...(opts.orgId ? { orgId: opts.orgId } : {}),
-    };
-    // Per-store statement descriptor (BTS-32). Destination charges are platform
-    // charges (platform = merchant of record), so buyer recognition is
-    // suffix-based: the store's stored suffix, else the configured platform
-    // default. Resolved from the component account record at session creation.
-    let statementDescriptorSuffix;
-    if (destinationAccountId && !isSeparate && opts.mode !== "setup") {
-        const account = (await ctx.runQuery(componentRef(component, "core/queries/getAccountByStripeId"), { stripeAccountId: destinationAccountId }));
-        statementDescriptorSuffix =
-            account?.statementDescriptor ?? opts.defaultStatementDescriptorSuffix;
-    }
-    const sessionParams = {
-        mode: opts.mode,
-        line_items: [{ price: opts.stripePriceId, quantity: opts.quantity ?? 1 }],
-        metadata,
-    };
-    if (opts.mode === "subscription") {
-        const subscriptionData = {
-            metadata,
-        };
-        if (opts.trialDays) {
-            subscriptionData.trial_period_days = opts.trialDays;
-        }
-        if (isSeparate) {
-            // Separate charges & transfers: NO transfer_data / application_fee. The
-            // split is carried in metadata for the webhook engine to execute.
-            subscriptionData.metadata = { ...metadata, ...separateMeta };
-        }
-        else if (destinationAccountId) {
-            // Single-recipient destination charge: route funds to the seller and take
-            // the platform's cut. Percent-only fees map to `application_fee_percent`;
-            // percent+fixed/tiered fees can't be expressed that way, so flag the
-            // subscription for per-invoice fee computation (handled by WEBHOOK_FEE).
-            subscriptionData.transfer_data = { destination: destinationAccountId };
-            if (opts.feeConfig) {
-                if (isPercentOnlyFee(opts.feeConfig)) {
-                    subscriptionData.application_fee_percent = opts.feeConfig.percent;
-                }
-                else {
-                    subscriptionData.metadata = {
-                        ...metadata,
-                        bsFeeMode: "per_invoice",
-                        bsFeeConfig: JSON.stringify(opts.feeConfig),
-                    };
-                }
-            }
-            if (statementDescriptorSuffix) {
-                // Subscriptions can't carry a suffix directly; the invoice.created
-                // processor reads this marker and sets it on each invoice.
-                subscriptionData.metadata = {
-                    ...(subscriptionData.metadata ?? metadata),
-                    bsStatementDescriptor: statementDescriptorSuffix,
-                };
-            }
-        }
-        sessionParams.subscription_data = subscriptionData;
-    }
-    if (opts.mode === "payment") {
-        const paymentIntentData = { metadata };
-        if (isSeparate) {
-            paymentIntentData.metadata = { ...metadata, ...separateMeta };
-        }
-        else if (destinationAccountId) {
-            // Single-recipient destination charge for a one-time purchase. The platform
-            // fee is a fixed `application_fee_amount`: compute it when the amount is
-            // known; otherwise flag the PI with `bsFeeMode=per_charge` and the webhook
-            // collects it at payment_intent.succeeded via a partial reversal of the
-            // destination transfer, sized from the amount actually charged (BTS-60).
-            paymentIntentData.transfer_data = {
-                destination: destinationAccountId,
-            };
-            if (statementDescriptorSuffix) {
-                paymentIntentData.statement_descriptor_suffix =
-                    statementDescriptorSuffix;
-            }
-            if (opts.feeConfig) {
-                if (opts.amount !== undefined) {
-                    paymentIntentData.application_fee_amount = computeFee(opts.amount, opts.feeConfig).feeAmount;
-                }
-                else {
-                    paymentIntentData.metadata = {
-                        ...metadata,
-                        bsFeeMode: "per_charge",
-                        bsFeeConfig: JSON.stringify(opts.feeConfig),
-                    };
-                }
-            }
-        }
-        sessionParams.payment_intent_data = paymentIntentData;
-    }
-    if (uiMode === "embedded" || uiMode === "custom" || uiMode === "form") {
-        sessionParams.ui_mode =
-            uiMode === "custom"
-                ? "elements"
-                : uiMode === "form"
-                    ? "form"
-                    : "embedded_page";
-        sessionParams.return_url = opts.returnUrl;
-    }
-    else {
-        sessionParams.success_url = `${opts.returnUrl}?session_id={CHECKOUT_SESSION_ID}`;
-        sessionParams.cancel_url = opts.returnUrl;
-    }
-    if (opts.accountId) {
-        sessionParams.customer_account = opts.accountId;
-    }
-    else if (opts.customerEmail) {
-        sessionParams.customer_email = opts.customerEmail;
-    }
-    // Merge overrides, then derive the persisted fee/routing row from the FINAL
-    // request — sessionOverrides can replace subscription_data/payment_intent_data
-    // wholesale, so the row must reflect what was actually sent to Stripe.
-    const finalSessionParams = {
-        ...sessionParams,
-        ...opts.sessionOverrides,
-    };
-    // Separate-charge sales persist the split + chargeType directly; single-recipient
-    // destination charges derive the row from the final transfer_data/fee.
-    const feeRow = isSeparate
-        ? { chargeType: "separate", splitRecipients: opts.split }
-        : deriveFeeRow(finalSessionParams);
-    // Both destination and separate charges run on the platform account, so the
-    // price must be platform-owned. Validate the FINAL request (post-overrides) so
-    // callers can't inject transfer_data or swap line_items to bypass the check.
-    const finalPriceId = finalSessionParams.line_items?.[0]?.price;
-    if ((isSeparate || feeRow.chargeType === "destination") &&
-        typeof finalPriceId === "string") {
-        await assertPlatformPrice(stripe, component, ctx, finalPriceId);
-    }
-    const requestOptions = idempotencyOptions(opts.idempotencyKey);
-    const session = requestOptions
-        ? await stripe.checkout.sessions.create(finalSessionParams, requestOptions)
-        : await stripe.checkout.sessions.create(finalSessionParams);
-    await runMutationOrThrow(ctx, componentRef(component, "billing/mutations/upsertCheckoutSession"), {
-        stripeSessionId: session.id,
-        userId: opts.userId,
-        orgId: opts.orgId,
-        accountId: opts.accountId,
-        mode: finalSessionParams.mode,
-        status: (session.status ?? "open"),
-        clientSecret: session.client_secret ?? undefined,
-        url: session.url ?? undefined,
-        priceId: opts.stripePriceId,
-        ...feeRow,
-        metadata,
-    });
-    return {
-        stripeSessionId: session.id,
-        clientSecret: session.client_secret ?? undefined,
-        url: session.url ?? undefined,
-    };
+    const prepared = await renderCheckoutSession(stripe, component, ctx, opts);
+    return submitPreparedCheckout(stripe, component, ctx, prepared, opts.idempotencyKey);
 }
 export async function getCheckoutSession(component, ctx, opts) {
     return (await ctx.runQuery(componentRef(component, "billing/queries/getCheckoutSession"), opts));

package/dist/client/billing/checkout.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../../src/client/billing/checkout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../../src/client/billing/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAiD;IAEjD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3E,OAAO,sBAAsB,CAC3B,MAAM,EACN,SAAS,EACT,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,cAAc,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAoB,EACpB,GAAW,EACX,IAA2B;IAE3B,OAAO,CAAC,MAAM,GAAG,CAAC,QAAQ,CACxB,YAAY,CAAC,SAAS,EAAE,oCAAoC,CAAC,EAC7D,IAAI,CACL,CAA0C,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,SAAoB,EACpB,GAAW,EACX,IAAiC;IAEjC,OAAO,CAAC,MAAM,GAAG,CAAC,QAAQ,CACxB,YAAY,CAAC,SAAS,EAAE,8CAA8C,CAAC,EACvE,IAAI,CACL,CAA0C,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAAoB,EACpB,GAAW,EACX,IAAyC;IAEzC,OAAO,CAAC,MAAM,GAAG,CAAC,QAAQ,CACxB,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC,EACrE,IAAI,CACL,CAAqC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAoB,EACpB,GAAW,EACX,IAWC;IAED,MAAM,kBAAkB,CACtB,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,yCAAyC,CAAC,EAClE,IAAI,CACL,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,IAAY,EACZ,IAGC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;QAC1E,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/client/billing/checkoutRequest.d.ts

@@ -0,0 +1,129 @@
+import type Stripe from "stripe";
+import type { SplitRecipient } from "../../component/lib/fees.js";
+import type { Component, RunCtx } from "../helpers.js";
+import type { PlatformFeeConfig } from "../types.js";
+export declare function renderCheckoutSession(stripe: Stripe, component: Component, ctx: RunCtx, opts: {
+    idempotencyKey?: string;
+    userId: string;
+    orgId?: string;
+    stripePriceId: string;
+    mode: "payment" | "subscription" | "setup";
+    uiMode?: "embedded" | "redirect" | "custom" | "form";
+    quantity?: number;
+    returnUrl: string;
+    trialDays?: number;
+    accountId?: string;
+    customerEmail?: string;
+    /**
+     * The seller/recipient connected account funds are routed to (destination
+     * charge). Fees only apply when this is set.
+     */
+    destinationAccountId?: string;
+    /**
+     * Multiple recipients for one sale (store + affiliate[s]). With >1 recipient
+     * this routes via separate charges & transfers (no `application_fee`); the
+     * transfers are created by the webhook engine. A single-recipient split is
+     * treated as a destination charge. Takes precedence over `destinationAccountId`.
+     */
+    split?: SplitRecipient[];
+    /** Resolved platform fee config (the caller resolves override → default). */
+    feeConfig?: PlatformFeeConfig;
+    /**
+     * Charge total in minor units (one-time payment mode). When known, the
+     * fixed `application_fee_amount` is computed up front; otherwise the fee is
+     * deferred to the webhook.
+     */
+    amount?: number;
+    /**
+     * Platform-default statement-descriptor suffix (BTS-32), used when the
+     * destination account record carries no per-store suffix. The caller
+     * (BetterStripe) passes its validated configured default.
+     */
+    defaultStatementDescriptorSuffix?: string;
+    metadata?: Record<string, string>;
+    sessionOverrides?: Record<string, unknown>;
+}, capturedDescriptor?: {
+    value?: string;
+}): Promise<{
+    version: 1;
+    request: Stripe.Checkout.SessionCreateParams;
+    options: {
+        idempotencyKey?: string;
+        userId: string;
+        orgId?: string;
+        stripePriceId: string;
+        mode: "payment" | "subscription" | "setup";
+        uiMode?: "embedded" | "redirect" | "custom" | "form";
+        quantity?: number;
+        returnUrl: string;
+        trialDays?: number;
+        accountId?: string;
+        customerEmail?: string;
+        /**
+         * The seller/recipient connected account funds are routed to (destination
+         * charge). Fees only apply when this is set.
+         */
+        destinationAccountId?: string;
+        /**
+         * Multiple recipients for one sale (store + affiliate[s]). With >1 recipient
+         * this routes via separate charges & transfers (no `application_fee`); the
+         * transfers are created by the webhook engine. A single-recipient split is
+         * treated as a destination charge. Takes precedence over `destinationAccountId`.
+         */
+        split?: SplitRecipient[];
+        /** Resolved platform fee config (the caller resolves override → default). */
+        feeConfig?: PlatformFeeConfig;
+        /**
+         * Charge total in minor units (one-time payment mode). When known, the
+         * fixed `application_fee_amount` is computed up front; otherwise the fee is
+         * deferred to the webhook.
+         */
+        amount?: number;
+        /**
+         * Platform-default statement-descriptor suffix (BTS-32), used when the
+         * destination account record carries no per-store suffix. The caller
+         * (BetterStripe) passes its validated configured default.
+         */
+        defaultStatementDescriptorSuffix?: string;
+        metadata?: Record<string, string>;
+        sessionOverrides?: Record<string, unknown>;
+    };
+    descriptor: {
+        value: string | undefined;
+    };
+    routingMetadata: {
+        subscription: Stripe.MetadataParam | undefined;
+        payment: Stripe.MetadataParam | undefined;
+    };
+    row: {
+        chargeType?: "destination";
+        destinationAccountId?: string;
+        applicationFeePercent?: number;
+        applicationFeeAmount?: number;
+        userId: string;
+        orgId: string | undefined;
+        accountId: string | undefined;
+        priceId: string;
+        metadata: {
+            userId: string;
+            orgId?: string | undefined;
+        };
+    } | {
+        chargeType: "separate";
+        splitRecipients: {
+            amount?: number | undefined;
+            destinationAccountId: string;
+            percent?: number | undefined;
+            role: "affiliate" | "other" | "store";
+        }[] | undefined;
+        userId: string;
+        orgId: string | undefined;
+        accountId: string | undefined;
+        priceId: string;
+        metadata: {
+            userId: string;
+            orgId?: string | undefined;
+        };
+    };
+}>;
+//# sourceMappingURL=checkoutRequest.d.ts.map

package/dist/client/billing/checkoutRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutRequest.d.ts","sourceRoot":"","sources":["../../../src/client/billing/checkoutRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgGrD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;IAC3C,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,EACD,kBAAkB,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;aAmM5B,CAAC;;;yBA3OO,MAAM;gBACf,MAAM;gBACN,MAAM;uBACC,MAAM;cACf,SAAS,GAAG,cAAc,GAAG,OAAO;iBACjC,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM;mBACzC,MAAM;mBACN,MAAM;oBACL,MAAM;oBACN,MAAM;wBACF,MAAM;QACtB;;;WAGG;+BACoB,MAAM;QAC7B;;;;;WAKG;gBACK,cAAc,EAAE;QACxB,6EAA6E;oBACjE,iBAAiB;QAC7B;;;;WAIG;iBACM,MAAM;QACf;;;;WAIG;2CACgC,MAAM;mBAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;2BACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;QAwM5B,KAAK;;;QAEjB,YAAY;QACZ,OAAO;;;qBA3UE,aAAa;+BACH,MAAM;gCACL,MAAM;+BACP,MAAM;;;;;;;;;;oBAmTX,UAAU;;;;;;;;;;;;;;;;GAgC7B"}