@fantastic.dev/better-stripe 0.24.0 → 0.25.0

package/dist/client/billing/checkoutRequest.js

@@ -0,0 +1,263 @@
+import { computeFee, isPercentOnlyFee, validateSplit } from "../core/fees.js";
+import { throwStripeError } from "../errors.js";
+import { stripReservedMetadata } 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 renderCheckoutSession(stripe, component, ctx, opts, capturedDescriptor) {
+    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") {
+        if (capturedDescriptor)
+            statementDescriptorSuffix = capturedDescriptor.value;
+        else {
+            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);
+    }
+    return {
+        version: 1,
+        request: finalSessionParams,
+        options: opts,
+        descriptor: { value: statementDescriptorSuffix },
+        routingMetadata: {
+            subscription: sessionParams.subscription_data?.metadata,
+            payment: sessionParams.payment_intent_data?.metadata,
+        },
+        row: {
+            userId: opts.userId,
+            orgId: opts.orgId,
+            accountId: opts.accountId,
+            priceId: opts.stripePriceId,
+            ...feeRow,
+            metadata,
+        },
+    };
+}
+//# sourceMappingURL=checkoutRequest.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type Stripe from "stripe";
+import type { Component, RunCtx } from "../helpers.js";
+import { renderCheckoutSession } from "./checkoutRequest.js";
+export type PreparedCheckoutSession = Awaited<ReturnType<typeof renderCheckoutSession>>;
+/** Read-only preparation. Persist the whole snapshot under host-owned immutable authorization. */
+export declare function prepareCheckoutSession(stripe: Stripe, component: Component, ctx: RunCtx, opts: Parameters<typeof renderCheckoutSession>[3]): Promise<PreparedCheckoutSession>;
+/** Execute only a trusted server snapshot. Ownership and durable request binding belong to the host. */
+export declare function executePreparedCheckoutSession(stripe: Stripe, component: Component, ctx: RunCtx, args: {
+    prepared: PreparedCheckoutSession;
+    idempotencyKey: string;
+}): Promise<{
+    stripeSessionId: string;
+    clientSecret: string | undefined;
+    url: string | undefined;
+}>;
+/** Shared legacy submission. Its input has already passed the maintained renderer's safeguards. */
+export declare function submitPreparedCheckout(stripe: Stripe, component: Component, ctx: RunCtx, prepared: PreparedCheckoutSession, key?: string): Promise<{
+    stripeSessionId: string;
+    clientSecret: string | undefined;
+    url: string | undefined;
+}>;
+//# sourceMappingURL=preparedCheckout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preparedCheckout.d.ts","sourceRoot":"","sources":["../../../src/client/billing/preparedCheckout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,UAAU,CAAC,OAAO,qBAAqB,CAAC,CACzC,CAAC;AAmDF,kGAAkG;AAClG,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAChD,OAAO,CAAC,uBAAuB,CAAC,CAMlC;AACD,wGAAwG;AACxG,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,EAAE,uBAAuB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE;;;;GAkCpE;AACD,mGAAmG;AACnG,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,uBAAuB,EACjC,GAAG,CAAC,EAAE,MAAM;;;;GAuBb"}

package/dist/client/billing/preparedCheckout.js

@@ -0,0 +1,86 @@
+import { runMutationOrThrow } from "../helpers.js";
+import { componentRef } from "../webhooks/helpers.js";
+import { idempotencyOptions } from "../core/idempotency.js";
+import { renderCheckoutSession } from "./checkoutRequest.js";
+function canonical(value) {
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === "number" && !Number.isFinite(item))
+            throw new Error("Checkout request must be serializable.");
+        if (["function", "symbol", "bigint"].includes(typeof item))
+            throw new Error("Checkout request must be serializable.");
+        if (item && typeof item === "object" && !Array.isArray(item))
+            return Object.fromEntries(Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
+        return item;
+    });
+}
+function snapshot(value) {
+    return JSON.parse(canonical(value));
+}
+function validateCorrelation(prepared) {
+    const { request, row, options } = prepared;
+    const nested = request.mode === "subscription"
+        ? request.subscription_data?.metadata
+        : request.mode === "payment"
+            ? request.payment_intent_data?.metadata
+            : undefined;
+    if (request.mode !== options.mode ||
+        request.customer_account !== options.accountId ||
+        request.customer_email !==
+            (options.accountId ? undefined : options.customerEmail) ||
+        request.line_items?.length !== 1 ||
+        request.line_items[0]?.price !== options.stripePriceId ||
+        canonical(request.metadata) !== canonical(row.metadata) ||
+        (request.mode !== "setup" &&
+            Object.entries(row.metadata).some(([key, value]) => nested?.[key] !== value)))
+        throw new Error("Prepared Checkout correlation does not match.");
+    const generated = request.mode === "subscription"
+        ? prepared.routingMetadata.subscription
+        : prepared.routingMetadata.payment;
+    const reserved = new Set([...Object.keys(nested ?? {}), ...Object.keys(generated ?? {})].filter((key) => key.startsWith("bs")));
+    if ([...reserved].some((key) => nested?.[key] !== generated?.[key]))
+        throw new Error("Prepared Checkout routing metadata does not match.");
+}
+/** Read-only preparation. Persist the whole snapshot under host-owned immutable authorization. */
+export async function prepareCheckoutSession(stripe, component, ctx, opts) {
+    const prepared = snapshot(await renderCheckoutSession(stripe, component, ctx, snapshot(opts)));
+    validateCorrelation(prepared);
+    return prepared;
+}
+/** Execute only a trusted server snapshot. Ownership and durable request binding belong to the host. */
+export async function executePreparedCheckoutSession(stripe, component, ctx, args) {
+    const requestOptions = idempotencyOptions(args.idempotencyKey);
+    if (!requestOptions)
+        throw new Error("Prepared Checkout requires an explicit idempotency key.");
+    const prepared = snapshot(args.prepared);
+    if (prepared.version !== 1)
+        throw new Error("Unsupported prepared Checkout version.");
+    if (prepared.options.idempotencyKey !== undefined &&
+        prepared.options.idempotencyKey !== args.idempotencyKey)
+        throw new Error("Prepared Checkout idempotency key does not match.");
+    validateCorrelation(prepared);
+    const expected = snapshot(await renderCheckoutSession(stripe, component, ctx, prepared.options, prepared.descriptor));
+    if (canonical(prepared) !== canonical(expected))
+        throw new Error("Prepared Checkout request does not match its bound context.");
+    return submitPreparedCheckout(stripe, component, ctx, prepared, args.idempotencyKey);
+}
+/** Shared legacy submission. Its input has already passed the maintained renderer's safeguards. */
+export async function submitPreparedCheckout(stripe, component, ctx, prepared, key) {
+    const options = idempotencyOptions(key);
+    const session = options
+        ? await stripe.checkout.sessions.create(prepared.request, options)
+        : await stripe.checkout.sessions.create(prepared.request);
+    await runMutationOrThrow(ctx, componentRef(component, "billing/mutations/upsertCheckoutSession"), {
+        ...prepared.row,
+        stripeSessionId: session.id,
+        mode: prepared.request.mode,
+        status: (session.status ?? "open"),
+        clientSecret: session.client_secret ?? undefined,
+        url: session.url ?? undefined,
+    });
+    return {
+        stripeSessionId: session.id,
+        clientSecret: session.client_secret ?? undefined,
+        url: session.url ?? undefined,
+    };
+}
+//# sourceMappingURL=preparedCheckout.js.map

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

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

package/dist/client/checkoutRequests.d.ts

@@ -0,0 +1,80 @@
+import type Stripe from "stripe";
+import type { Component, RunCtx } from "./helpers.js";
+import type { FeeOverride, PlatformFeeConfig } from "./types.js";
+import type { CreateCheckoutSessionOptions } from "./billing/checkoutOptions.js";
+import { executePreparedCheckoutSession } from "./billing/preparedCheckout.js";
+/** Server-only request preparation and execution, without a browser-owned money API. */
+export declare class CheckoutRequestClient {
+    private component;
+    private provider;
+    private resolveFee;
+    private descriptor?;
+    constructor(component: Component, provider: () => Stripe, resolveFee: (fee?: FeeOverride) => PlatformFeeConfig | undefined, descriptor?: string | undefined);
+    prepare(ctx: RunCtx, opts: CreateCheckoutSessionOptions): 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;
+            destinationAccountId?: string;
+            split?: import("../component/lib/fees.js").SplitRecipient[];
+            feeConfig?: PlatformFeeConfig;
+            amount?: number;
+            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;
+            };
+        };
+    }>;
+    execute(ctx: RunCtx, args: Parameters<typeof executePreparedCheckoutSession>[3]): Promise<{
+        stripeSessionId: string;
+        clientSecret: string | undefined;
+        url: string | undefined;
+    }>;
+}
+//# sourceMappingURL=checkoutRequests.d.ts.map

package/dist/client/checkoutRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutRequests.d.ts","sourceRoot":"","sources":["../../src/client/checkoutRequests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAEL,8BAA8B,EAC/B,MAAM,+BAA+B,CAAC;AAEvC,wFAAwF;AACxF,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU,CAAC;IAJrB,YACU,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,MAAM,EACtB,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,KAAK,iBAAiB,GAAG,SAAS,EAChE,UAAU,CAAC,EAAE,MAAM,YAAA,EACzB;IACJ,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAUtD;IACD,OAAO,CACL,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,CAAC;;;;OAQ3D;CACF"}

package/dist/client/checkoutRequests.js

@@ -0,0 +1,28 @@
+import { prepareCheckoutSession, executePreparedCheckoutSession, } from "./billing/preparedCheckout.js";
+/** Server-only request preparation and execution, without a browser-owned money API. */
+export class CheckoutRequestClient {
+    component;
+    provider;
+    resolveFee;
+    descriptor;
+    constructor(component, provider, resolveFee, descriptor) {
+        this.component = component;
+        this.provider = provider;
+        this.resolveFee = resolveFee;
+        this.descriptor = descriptor;
+    }
+    prepare(ctx, opts) {
+        const { fee, ...rest } = opts;
+        return prepareCheckoutSession(this.provider(), this.component, ctx, {
+            ...rest,
+            feeConfig: opts.destinationAccountId || opts.split?.length
+                ? this.resolveFee(fee)
+                : undefined,
+            defaultStatementDescriptorSuffix: this.descriptor,
+        });
+    }
+    execute(ctx, args) {
+        return executePreparedCheckoutSession(this.provider(), this.component, ctx, args);
+    }
+}
+//# sourceMappingURL=checkoutRequests.js.map

package/dist/client/checkoutRequests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutRequests.js","sourceRoot":"","sources":["../../src/client/checkoutRequests.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AAEvC,wFAAwF;AACxF,MAAM,OAAO,qBAAqB;IAEtB,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;IAJpB,YACU,SAAoB,EACpB,QAAsB,EACtB,UAAgE,EAChE,UAAmB;yBAHnB,SAAS;wBACT,QAAQ;0BACR,UAAU;0BACV,UAAU;IACjB,CAAC;IACJ,OAAO,CAAC,GAAW,EAAE,IAAkC;QACrD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC9B,OAAO,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAClE,GAAG,IAAI;YACP,SAAS,EACP,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM;gBAC7C,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBACtB,CAAC,CAAC,SAAS;YACf,gCAAgC,EAAE,IAAI,CAAC,UAAU;SAClD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CACL,GAAW,EACX,IAA0D;QAE1D,OAAO,8BAA8B,CACnC,IAAI,CAAC,QAAQ,EAAE,EACf,IAAI,CAAC,SAAS,EACd,GAAG,EACH,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}