@proxy-checkout/stripe-server-js 0.1.0-prx-146.162.1 → 0.1.0

package/dist/cjs/open-setup-intent.js

@@ -1,157 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.openSetupIntent = openSetupIntent;
-exports.directSetupProviderOptionsFingerprint = directSetupProviderOptionsFingerprint;
-const acquisition_js_1 = require("./acquisition.js");
-const compatibility_js_1 = require("./compatibility.js");
-const errors_js_1 = require("./errors.js");
-const subscription_params_js_1 = require("./subscription-params.js");
-async function openSetupIntent(options) {
-    (0, compatibility_js_1.assertStripePathCompatibility)("subscription.direct_setup_intent", options.compatibility);
-    assertStripeId(options.customerId, "cus_", "customerId");
-    (0, acquisition_js_1.assertNoConnectRequestOptions)(options.stripeRequestOptions);
-    const opened = await (0, acquisition_js_1.openSharedAcquisitionSession)({
-        cartSchema: options.cartSchema,
-        getCartBuyerReference: options.getCartBuyerReference,
-        proxy: options.proxy,
-        proxySessionId: options.proxySessionId,
-        requestId: options.requestId,
-    });
-    if (opened.outcome !== "active")
-        return opened;
-    const builderInput = {
-        cart: opened.cart,
-        proxySession: opened.proxySession,
-        stripe: options.stripe,
-    };
-    const setupIntentParams = (await options.buildSetupIntentParams?.(builderInput)) ?? {};
-    const subscriptionParams = await options.buildSubscriptionParams(builderInput);
-    (0, subscription_params_js_1.assertAllowedSetupIntentParams)(setupIntentParams);
-    (0, subscription_params_js_1.validateSubscriptionParams)(subscriptionParams);
-    (0, acquisition_js_1.assertMerchantDoesNotSetAcquisitionMetadata)(setupIntentParams.metadata, "setupIntentParams.metadata");
-    (0, acquisition_js_1.assertMerchantDoesNotSetAcquisitionMetadata)(subscriptionParams.metadata, "subscriptionParams.metadata");
-    const providerOptionsFingerprint = directSetupProviderOptionsFingerprint({
-        customerId: options.customerId,
-        initialInvoiceActionShape: options.initialInvoiceActionShape,
-        setupIntentParams,
-        subscriptionParams,
-    });
-    let reservation;
-    try {
-        reservation = await (0, acquisition_js_1.reserveDirectSubscriptionAcquisition)({
-            directSubscriptionSource: "setup_intent",
-            providerOptionsFingerprint,
-            proxy: options.proxy,
-            proxySessionId: options.proxySessionId,
-            requestId: options.requestId,
-        });
-    }
-    catch (cause) {
-        const proxySession = await (0, acquisition_js_1.terminalAfterAcquisitionFailure)({
-            cause,
-            proxy: options.proxy,
-            proxySessionId: options.proxySessionId,
-            requestId: options.requestId,
-        });
-        return (0, acquisition_js_1.terminalAcquisitionResult)(proxySession, opened.cart);
-    }
-    (0, acquisition_js_1.assertDirectSubscriptionReservation)(reservation, "setup_intent", options.proxySessionId, providerOptionsFingerprint);
-    const expectedMetadata = (0, acquisition_js_1.acquisitionMetadata)(reservation);
-    const replayed = await (0, acquisition_js_1.createOrRecoverStripeAcquisitionObject)({
-        acquisition: reservation.acquisitionAttempt,
-        objectType: "setup_intent",
-        proxy: options.proxy,
-        proxySessionId: options.proxySessionId,
-        requestId: options.requestId,
-        role: "setup_intent",
-        create: async () => {
-            const setupIdempotencyKey = reservation.stripe.idempotencyKeys.setupIntent;
-            if (!setupIdempotencyKey) {
-                throw new errors_js_1.StripeResponseShapeError("Proxy direct SetupIntent reservation omitted its setup_intent idempotency key.", "stripe.idempotencyKeys.setupIntent");
-            }
-            return (await options.stripe.setupIntents.create({
-                ...setupIntentParams,
-                customer: options.customerId,
-                metadata: (0, acquisition_js_1.mergeAcquisitionMetadata)(setupIntentParams.metadata, expectedMetadata),
-            }, (0, acquisition_js_1.stripeRequestOptions)(options.stripeRequestOptions, setupIdempotencyKey)));
-        },
-        retrieve: async (id) => (await options.stripe.setupIntents.retrieve(id, undefined, options.stripeRequestOptions)),
-    });
-    const setupIntent = replayed.object;
-    assertSetupIntent(setupIntent, {
-        customerId: options.customerId,
-        expectedMetadata,
-        expectedSetupIntentId: replayed.acquisition.providerSetupIntentId,
-    });
-    if (!replayed.alreadyAttached) {
-        await (0, acquisition_js_1.attachAcquisitionObject)({
-            acquisitionAttempt: replayed.acquisition,
-            objectId: setupIntent.id,
-            objectType: "setup_intent",
-            providerCustomerId: options.customerId,
-            proxy: options.proxy,
-            proxySessionId: options.proxySessionId,
-            requestId: options.requestId,
-            role: "setup_intent",
-        });
-    }
-    return {
-        acquisitionAttemptId: reservation.acquisitionAttempt.id,
-        cart: opened.cart,
-        clientSecret: requireClientSecret(setupIntent),
-        outcome: "ready",
-        proxySession: opened.proxySession,
-        proxySessionId: options.proxySessionId,
-        setupIntent,
-        setupIntentId: setupIntent.id,
-        status: requireSetupIntentStatus(setupIntent),
-    };
-}
-function directSetupProviderOptionsFingerprint(input) {
-    return (0, acquisition_js_1.fingerprintStripeProviderOptions)("direct_subscription", {
-        direct_subscription_source: "setup_intent",
-        initial_invoice_action_shape: input.initialInvoiceActionShape,
-        setup_intent: { ...input.setupIntentParams, customer: input.customerId },
-        subscription: { ...input.subscriptionParams, customer: input.customerId },
-    });
-}
-function assertSetupIntent(setupIntent, input) {
-    assertStripeId(setupIntent.id, "seti_", "setupIntent.id");
-    if (input.expectedSetupIntentId !== null && setupIntent.id !== input.expectedSetupIntentId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe returned SetupIntent ${setupIntent.id} while retrieving ${input.expectedSetupIntentId}.`, { code: "acquisition_mismatch", field: "setupIntent.id" });
-    }
-    (0, acquisition_js_1.assertAcquisitionMetadata)(setupIntent.metadata, input.expectedMetadata, "Stripe SetupIntent");
-    const customerId = (0, acquisition_js_1.requireStripeObjectId)(setupIntent.customer, "cus_", "setupIntent.customer");
-    if (customerId !== input.customerId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe SetupIntent ${setupIntent.id} Customer does not match the shared billing Customer.`, { code: "customer_payment_method_mismatch", field: "setupIntent.customer" });
-    }
-    requireSetupIntentStatus(setupIntent);
-}
-function requireSetupIntentStatus(setupIntent) {
-    const supported = new Set([
-        "canceled",
-        "processing",
-        "requires_action",
-        "requires_confirmation",
-        "requires_payment_method",
-        "succeeded",
-    ]);
-    if (typeof setupIntent.status !== "string" || !supported.has(setupIntent.status)) {
-        throw new errors_js_1.StripeResponseShapeError(`Stripe SetupIntent ${setupIntent.id} returned an unsupported status shape.`, "setupIntent.status");
-    }
-    return setupIntent.status;
-}
-function requireClientSecret(setupIntent) {
-    if (typeof setupIntent.client_secret !== "string" || setupIntent.client_secret.length === 0) {
-        throw new errors_js_1.StripeResponseShapeError(`Stripe SetupIntent ${setupIntent.id} did not return presentation material.`, "setupIntent.client_secret");
-    }
-    return setupIntent.client_secret;
-}
-function assertStripeId(value, prefix, field) {
-    if (!value.startsWith(prefix) || value.length <= prefix.length) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe ${field} is invalid.`, {
-            code: "provider_response_invalid",
-            field,
-        });
-    }
-}

package/dist/cjs/open-subscription.d.cts

@@ -1,75 +0,0 @@
-import type { PayerOpenedResult, ProxyCartValidator } from "@proxy-checkout/server-js";
-import { type SharedAcquisitionTerminal, type StripeAcquisitionProxyClient } from "./acquisition.js";
-import { type StripeCompatibilityDescriptor } from "./compatibility.js";
-import { type ValidateFixedSubscriptionPrice } from "./subscription-params.js";
-import type { StripeDirectSubscriptionClientLike, StripeInvoiceLike, StripeRequestOptionsWithoutIdempotencyLike, StripeSetupIntentCreateParams, StripeSetupSubscriptionClientLike, StripeSubscriptionCreateParams, StripeSubscriptionLike } from "./types.js";
-export type InitialInvoiceAction = {
-    readonly invoiceId: string | null;
-    readonly kind: "none";
-} | {
-    readonly clientSecret: string;
-    readonly invoiceId: string;
-    readonly kind: "client_secret";
-    readonly paymentIntentId: string | null;
-};
-export interface OpenSubscriptionBuilderInput<TStripe extends StripeDirectSubscriptionClientLike, TCart> {
-    readonly cart: TCart;
-    readonly proxySession: PayerOpenedResult;
-    readonly stripe: TStripe;
-}
-interface OpenSubscriptionBaseOptions<TStripe extends StripeDirectSubscriptionClientLike, TCart> {
-    readonly buildSubscriptionParams: (input: OpenSubscriptionBuilderInput<TStripe, TCart>) => Promise<StripeSubscriptionCreateParams> | StripeSubscriptionCreateParams;
-    readonly cartSchema?: ProxyCartValidator<TCart>;
-    readonly compatibility?: StripeCompatibilityDescriptor;
-    readonly getCartBuyerReference?: (cart: TCart) => string | null | undefined;
-    /** Must match the merchant's pinned Stripe API generation; no shape fallback is attempted. */
-    readonly initialInvoiceActionShape: "confirmation_secret" | "legacy_payment_intent";
-    readonly proxy: StripeAcquisitionProxyClient;
-    readonly proxySessionId: string;
-    readonly requestId?: string;
-    readonly stripe: TStripe;
-    readonly stripeRequestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-    /** Merchant cart/quote attestation for discounts or additional fixed-price checks. */
-    readonly validateFixedPrice?: ValidateFixedSubscriptionPrice<TCart>;
-}
-interface OpenSubscriptionFromSetupIntent<TStripe extends StripeSetupSubscriptionClientLike, TCart> {
-    readonly fromSavedPaymentMethod?: never;
-    readonly fromSetupIntent: {
-        readonly acquisitionAttemptId: string;
-        readonly buildSetupIntentParams?: (input: OpenSubscriptionBuilderInput<TStripe, TCart>) => Promise<StripeSetupIntentCreateParams> | StripeSetupIntentCreateParams;
-        readonly setupIntentId: string;
-    };
-}
-interface OpenSubscriptionFromSavedPaymentMethod {
-    /**
-     * This branch is shareable only for an authorized purchase/shared billing
-     * account, never one invited viewer's private saved method.
-     */
-    readonly fromSavedPaymentMethod: {
-        readonly customerId: string;
-        readonly paymentMethodId: string;
-    };
-    readonly fromSetupIntent?: never;
-}
-export type OpenSubscriptionOptions<TStripe extends StripeDirectSubscriptionClientLike, TCart = unknown> = OpenSubscriptionBaseOptions<TStripe, TCart> & (TStripe extends StripeSetupSubscriptionClientLike ? OpenSubscriptionFromSetupIntent<TStripe, TCart> | OpenSubscriptionFromSavedPaymentMethod : OpenSubscriptionFromSavedPaymentMethod);
-export interface OpenSubscriptionReadyResult<TCart, TSubscription extends StripeSubscriptionLike> {
-    readonly acquisitionAttemptId: string;
-    readonly cart: TCart;
-    readonly initialInvoiceAction: InitialInvoiceAction;
-    readonly outcome: "ready";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly status: string;
-    readonly subscription: TSubscription;
-    readonly subscriptionId: string;
-}
-export type OpenSubscriptionResponse<TCart, TSubscription extends StripeSubscriptionLike> = OpenSubscriptionReadyResult<TCart, TSubscription> | SharedAcquisitionTerminal<TCart>;
-export declare function openSubscription<TStripe extends StripeDirectSubscriptionClientLike, TCart = unknown, TSubscription extends StripeSubscriptionLike = StripeSubscriptionLike>(options: OpenSubscriptionOptions<TStripe, TCart>): Promise<OpenSubscriptionResponse<TCart, TSubscription>>;
-export type LegacyInitialInvoiceLike = StripeInvoiceLike & {
-    readonly payment_intent?: {
-        readonly client_secret?: string | null;
-        readonly id: string;
-        readonly status?: string;
-    } | null;
-};
-export {};

package/dist/cjs/open-subscription.d.ts

@@ -1,75 +0,0 @@
-import type { PayerOpenedResult, ProxyCartValidator } from "@proxy-checkout/server-js";
-import { type SharedAcquisitionTerminal, type StripeAcquisitionProxyClient } from "./acquisition.js";
-import { type StripeCompatibilityDescriptor } from "./compatibility.js";
-import { type ValidateFixedSubscriptionPrice } from "./subscription-params.js";
-import type { StripeDirectSubscriptionClientLike, StripeInvoiceLike, StripeRequestOptionsWithoutIdempotencyLike, StripeSetupIntentCreateParams, StripeSetupSubscriptionClientLike, StripeSubscriptionCreateParams, StripeSubscriptionLike } from "./types.js";
-export type InitialInvoiceAction = {
-    readonly invoiceId: string | null;
-    readonly kind: "none";
-} | {
-    readonly clientSecret: string;
-    readonly invoiceId: string;
-    readonly kind: "client_secret";
-    readonly paymentIntentId: string | null;
-};
-export interface OpenSubscriptionBuilderInput<TStripe extends StripeDirectSubscriptionClientLike, TCart> {
-    readonly cart: TCart;
-    readonly proxySession: PayerOpenedResult;
-    readonly stripe: TStripe;
-}
-interface OpenSubscriptionBaseOptions<TStripe extends StripeDirectSubscriptionClientLike, TCart> {
-    readonly buildSubscriptionParams: (input: OpenSubscriptionBuilderInput<TStripe, TCart>) => Promise<StripeSubscriptionCreateParams> | StripeSubscriptionCreateParams;
-    readonly cartSchema?: ProxyCartValidator<TCart>;
-    readonly compatibility?: StripeCompatibilityDescriptor;
-    readonly getCartBuyerReference?: (cart: TCart) => string | null | undefined;
-    /** Must match the merchant's pinned Stripe API generation; no shape fallback is attempted. */
-    readonly initialInvoiceActionShape: "confirmation_secret" | "legacy_payment_intent";
-    readonly proxy: StripeAcquisitionProxyClient;
-    readonly proxySessionId: string;
-    readonly requestId?: string;
-    readonly stripe: TStripe;
-    readonly stripeRequestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-    /** Merchant cart/quote attestation for discounts or additional fixed-price checks. */
-    readonly validateFixedPrice?: ValidateFixedSubscriptionPrice<TCart>;
-}
-interface OpenSubscriptionFromSetupIntent<TStripe extends StripeSetupSubscriptionClientLike, TCart> {
-    readonly fromSavedPaymentMethod?: never;
-    readonly fromSetupIntent: {
-        readonly acquisitionAttemptId: string;
-        readonly buildSetupIntentParams?: (input: OpenSubscriptionBuilderInput<TStripe, TCart>) => Promise<StripeSetupIntentCreateParams> | StripeSetupIntentCreateParams;
-        readonly setupIntentId: string;
-    };
-}
-interface OpenSubscriptionFromSavedPaymentMethod {
-    /**
-     * This branch is shareable only for an authorized purchase/shared billing
-     * account, never one invited viewer's private saved method.
-     */
-    readonly fromSavedPaymentMethod: {
-        readonly customerId: string;
-        readonly paymentMethodId: string;
-    };
-    readonly fromSetupIntent?: never;
-}
-export type OpenSubscriptionOptions<TStripe extends StripeDirectSubscriptionClientLike, TCart = unknown> = OpenSubscriptionBaseOptions<TStripe, TCart> & (TStripe extends StripeSetupSubscriptionClientLike ? OpenSubscriptionFromSetupIntent<TStripe, TCart> | OpenSubscriptionFromSavedPaymentMethod : OpenSubscriptionFromSavedPaymentMethod);
-export interface OpenSubscriptionReadyResult<TCart, TSubscription extends StripeSubscriptionLike> {
-    readonly acquisitionAttemptId: string;
-    readonly cart: TCart;
-    readonly initialInvoiceAction: InitialInvoiceAction;
-    readonly outcome: "ready";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly status: string;
-    readonly subscription: TSubscription;
-    readonly subscriptionId: string;
-}
-export type OpenSubscriptionResponse<TCart, TSubscription extends StripeSubscriptionLike> = OpenSubscriptionReadyResult<TCart, TSubscription> | SharedAcquisitionTerminal<TCart>;
-export declare function openSubscription<TStripe extends StripeDirectSubscriptionClientLike, TCart = unknown, TSubscription extends StripeSubscriptionLike = StripeSubscriptionLike>(options: OpenSubscriptionOptions<TStripe, TCart>): Promise<OpenSubscriptionResponse<TCart, TSubscription>>;
-export type LegacyInitialInvoiceLike = StripeInvoiceLike & {
-    readonly payment_intent?: {
-        readonly client_secret?: string | null;
-        readonly id: string;
-        readonly status?: string;
-    } | null;
-};
-export {};

package/dist/cjs/open-subscription.js

@@ -1,307 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.openSubscription = openSubscription;
-const acquisition_js_1 = require("./acquisition.js");
-const compatibility_js_1 = require("./compatibility.js");
-const errors_js_1 = require("./errors.js");
-const open_setup_intent_js_1 = require("./open-setup-intent.js");
-const subscription_params_js_1 = require("./subscription-params.js");
-async function openSubscription(options) {
-    (0, acquisition_js_1.assertNoConnectRequestOptions)(options.stripeRequestOptions);
-    (0, compatibility_js_1.assertStripePathCompatibility)(options.fromSetupIntent === undefined
-        ? "subscription.direct_saved_payment_method"
-        : "subscription.direct_setup_intent", options.compatibility);
-    const opened = await (0, acquisition_js_1.openSharedAcquisitionSession)({
-        cartSchema: options.cartSchema,
-        getCartBuyerReference: options.getCartBuyerReference,
-        proxy: options.proxy,
-        proxySessionId: options.proxySessionId,
-        requestId: options.requestId,
-    });
-    if (opened.outcome !== "active")
-        return opened;
-    const builderInput = {
-        cart: opened.cart,
-        proxySession: opened.proxySession,
-        stripe: options.stripe,
-    };
-    const subscriptionParams = await options.buildSubscriptionParams(builderInput);
-    const items = (0, subscription_params_js_1.validateSubscriptionParams)(subscriptionParams);
-    (0, acquisition_js_1.assertMerchantDoesNotSetAcquisitionMetadata)(subscriptionParams.metadata, "subscriptionParams.metadata");
-    const validateFixedPrices = () => (0, subscription_params_js_1.retrieveAndValidateSubscriptionPrices)({
-        cart: opened.cart,
-        items,
-        params: subscriptionParams,
-        proxySession: opened.proxySession,
-        stripe: options.stripe,
-        stripeRequestOptions: options.stripeRequestOptions,
-        validateFixedPrice: options.validateFixedPrice,
-    });
-    let customerId;
-    let paymentMethodId;
-    let providerOptionsFingerprint;
-    let reservation;
-    if (options.fromSetupIntent !== undefined) {
-        assertStripeId(options.fromSetupIntent.setupIntentId, "seti_", "fromSetupIntent.setupIntentId");
-        const setupStripe = requireSetupSubscriptionClient(options.stripe);
-        const setupIntentParams = (await options.fromSetupIntent.buildSetupIntentParams?.({
-            ...builderInput,
-            stripe: setupStripe,
-        })) ?? {};
-        (0, subscription_params_js_1.assertAllowedSetupIntentParams)(setupIntentParams);
-        (0, acquisition_js_1.assertMerchantDoesNotSetAcquisitionMetadata)(setupIntentParams.metadata, "setupIntentParams.metadata");
-        const setupIntent = await setupStripe.setupIntents.retrieve(options.fromSetupIntent.setupIntentId, undefined, options.stripeRequestOptions);
-        if (setupIntent.id !== options.fromSetupIntent.setupIntentId) {
-            throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe returned SetupIntent ${setupIntent.id} while retrieving ${options.fromSetupIntent.setupIntentId}.`, { code: "acquisition_mismatch", field: "setupIntent.id" });
-        }
-        const expectedMetadata = {
-            proxy_acquisition_attempt_id: options.fromSetupIntent.acquisitionAttemptId,
-            proxy_contract_version: "2",
-            proxy_integration_path: "direct_subscription",
-            proxy_session_id: options.proxySessionId,
-        };
-        (0, acquisition_js_1.assertAcquisitionMetadata)(setupIntent.metadata, expectedMetadata, "Stripe SetupIntent");
-        if (setupIntent.status !== "succeeded") {
-            throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe SetupIntent ${setupIntent.id} must succeed before creating a Subscription.`, { code: "setup_intent_not_succeeded", field: "setupIntent.status" });
-        }
-        customerId = (0, acquisition_js_1.requireStripeObjectId)(setupIntent.customer, "cus_", "setupIntent.customer");
-        paymentMethodId = (0, acquisition_js_1.requireStripeObjectId)(setupIntent.payment_method, "pm_", "setupIntent.payment_method");
-        await assertPaymentMethodCustomer({
-            customerId,
-            paymentMethodId,
-            stripe: options.stripe,
-            stripeRequestOptions: options.stripeRequestOptions,
-        });
-        await validateFixedPrices();
-        providerOptionsFingerprint = (0, open_setup_intent_js_1.directSetupProviderOptionsFingerprint)({
-            customerId,
-            initialInvoiceActionShape: options.initialInvoiceActionShape,
-            setupIntentParams,
-            subscriptionParams,
-        });
-        try {
-            reservation = await (0, acquisition_js_1.recoverSetupIntentReservation)({
-                acquisitionAttemptId: options.fromSetupIntent.acquisitionAttemptId,
-                providerOptionsFingerprint,
-                proxy: options.proxy,
-                proxySessionId: options.proxySessionId,
-                requestId: options.requestId,
-                setupIntentId: options.fromSetupIntent.setupIntentId,
-            });
-        }
-        catch (cause) {
-            const proxySession = await (0, acquisition_js_1.terminalAfterAcquisitionFailure)({
-                cause,
-                proxy: options.proxy,
-                proxySessionId: options.proxySessionId,
-                requestId: options.requestId,
-            });
-            return (0, acquisition_js_1.terminalAcquisitionResult)(proxySession, opened.cart);
-        }
-    }
-    else {
-        customerId = options.fromSavedPaymentMethod.customerId;
-        paymentMethodId = options.fromSavedPaymentMethod.paymentMethodId;
-        assertStripeId(customerId, "cus_", "fromSavedPaymentMethod.customerId");
-        assertStripeId(paymentMethodId, "pm_", "fromSavedPaymentMethod.paymentMethodId");
-        await assertPaymentMethodCustomer({
-            customerId,
-            paymentMethodId,
-            stripe: options.stripe,
-            stripeRequestOptions: options.stripeRequestOptions,
-        });
-        await validateFixedPrices();
-        providerOptionsFingerprint = (0, acquisition_js_1.fingerprintStripeProviderOptions)("direct_subscription", {
-            direct_subscription_source: "saved_payment_method",
-            initial_invoice_action_shape: options.initialInvoiceActionShape,
-            subscription: {
-                ...subscriptionParams,
-                customer: customerId,
-                default_payment_method: paymentMethodId,
-            },
-        });
-        try {
-            reservation = await (0, acquisition_js_1.reserveDirectSubscriptionAcquisition)({
-                directSubscriptionSource: "saved_payment_method",
-                providerOptionsFingerprint,
-                proxy: options.proxy,
-                proxySessionId: options.proxySessionId,
-                requestId: options.requestId,
-            });
-        }
-        catch (cause) {
-            const proxySession = await (0, acquisition_js_1.terminalAfterAcquisitionFailure)({
-                cause,
-                proxy: options.proxy,
-                proxySessionId: options.proxySessionId,
-                requestId: options.requestId,
-            });
-            return (0, acquisition_js_1.terminalAcquisitionResult)(proxySession, opened.cart);
-        }
-    }
-    const source = options.fromSetupIntent ? "setup_intent" : "saved_payment_method";
-    (0, acquisition_js_1.assertDirectSubscriptionReservation)(reservation, source, options.proxySessionId, providerOptionsFingerprint);
-    const expectedMetadata = (0, acquisition_js_1.acquisitionMetadata)(reservation);
-    const expansion = initialInvoiceExpansion(options.initialInvoiceActionShape);
-    const replayed = await (0, acquisition_js_1.createOrRecoverStripeAcquisitionObject)({
-        acquisition: reservation.acquisitionAttempt,
-        objectType: "subscription",
-        proxy: options.proxy,
-        proxySessionId: options.proxySessionId,
-        requestId: options.requestId,
-        role: "root",
-        create: async () => (await options.stripe.subscriptions.create({
-            ...subscriptionParams,
-            collection_method: "charge_automatically",
-            customer: customerId,
-            default_payment_method: paymentMethodId,
-            expand: uniqueStrings([...(subscriptionParams.expand ?? []), ...expansion]),
-            metadata: (0, acquisition_js_1.mergeAcquisitionMetadata)(subscriptionParams.metadata, expectedMetadata),
-            payment_behavior: "default_incomplete",
-        }, (0, acquisition_js_1.stripeRequestOptions)(options.stripeRequestOptions, reservation.stripe.idempotencyKeys.root))),
-        retrieve: async (id) => (await options.stripe.subscriptions.retrieve(id, { expand: expansion }, options.stripeRequestOptions)),
-    });
-    const subscription = replayed.object;
-    assertSubscriptionResponse(subscription, {
-        customerId,
-        expectedMetadata,
-        expectedSubscriptionId: replayed.acquisition.providerRootObjectId,
-        paymentMethodId,
-    });
-    if (!replayed.alreadyAttached) {
-        await (0, acquisition_js_1.attachAcquisitionObject)({
-            acquisitionAttempt: replayed.acquisition,
-            objectId: subscription.id,
-            objectType: "subscription",
-            providerCustomerId: customerId,
-            proxy: options.proxy,
-            proxySessionId: options.proxySessionId,
-            requestId: options.requestId,
-            role: "root",
-        });
-    }
-    return {
-        acquisitionAttemptId: reservation.acquisitionAttempt.id,
-        cart: opened.cart,
-        initialInvoiceAction: readInitialInvoiceAction(subscription),
-        outcome: "ready",
-        proxySession: opened.proxySession,
-        proxySessionId: options.proxySessionId,
-        status: requireSubscriptionStatus(subscription),
-        subscription,
-        subscriptionId: subscription.id,
-    };
-}
-function initialInvoiceExpansion(shape) {
-    return shape === "confirmation_secret"
-        ? ["latest_invoice.confirmation_secret"]
-        : ["latest_invoice.payment_intent"];
-}
-function readInitialInvoiceAction(subscription) {
-    const latestInvoice = subscription.latest_invoice;
-    if (latestInvoice === null || latestInvoice === undefined) {
-        if (subscription.status === "active" || subscription.status === "trialing") {
-            return { invoiceId: null, kind: "none" };
-        }
-        throw new errors_js_1.StripeResponseShapeError(`Stripe Subscription ${subscription.id} did not return an expanded initial Invoice.`, "subscription.latest_invoice");
-    }
-    if (typeof latestInvoice === "string") {
-        throw new errors_js_1.StripeResponseShapeError(`Stripe Subscription ${subscription.id} initial Invoice was not expanded.`, "subscription.latest_invoice");
-    }
-    assertStripeId(latestInvoice.id, "in_", "subscription.latest_invoice.id");
-    const confirmationSecret = latestInvoice.confirmation_secret;
-    if (confirmationSecret &&
-        typeof confirmationSecret.client_secret === "string" &&
-        confirmationSecret.client_secret.length > 0) {
-        if (confirmationSecret.type !== undefined && confirmationSecret.type !== "payment_intent") {
-            throw new errors_js_1.StripeResponseShapeError(`Stripe Invoice ${latestInvoice.id} returned an unsupported confirmation secret type.`, "subscription.latest_invoice.confirmation_secret.type");
-        }
-        return {
-            clientSecret: confirmationSecret.client_secret,
-            invoiceId: latestInvoice.id,
-            kind: "client_secret",
-            paymentIntentId: null,
-        };
-    }
-    const paymentIntent = latestInvoice.payment_intent;
-    if (typeof paymentIntent === "object" &&
-        paymentIntent !== null &&
-        typeof paymentIntent.client_secret === "string" &&
-        paymentIntent.client_secret.length > 0) {
-        return {
-            clientSecret: paymentIntent.client_secret,
-            invoiceId: latestInvoice.id,
-            kind: "client_secret",
-            paymentIntentId: (0, acquisition_js_1.requireStripeObjectId)(paymentIntent, "pi_", "subscription.latest_invoice.payment_intent"),
-        };
-    }
-    if (latestInvoice.amount_due === 0 ||
-        latestInvoice.status === "paid" ||
-        latestInvoice.status === "void" ||
-        subscription.status === "active" ||
-        subscription.status === "trialing" ||
-        (typeof paymentIntent === "object" &&
-            paymentIntent !== null &&
-            (paymentIntent.status === "processing" || paymentIntent.status === "succeeded"))) {
-        return { invoiceId: latestInvoice.id, kind: "none" };
-    }
-    throw new errors_js_1.StripeResponseShapeError(`Stripe Subscription ${subscription.id} initial Invoice requires action but did not return a client secret.`, "subscription.latest_invoice");
-}
-async function assertPaymentMethodCustomer(input) {
-    const paymentMethod = await input.stripe.paymentMethods.retrieve(input.paymentMethodId, undefined, input.stripeRequestOptions);
-    if (paymentMethod.id !== input.paymentMethodId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError("Stripe returned a different PaymentMethod than the one requested by the merchant.", { code: "customer_payment_method_mismatch", field: "paymentMethod.id" });
-    }
-    const attachedCustomerId = (0, acquisition_js_1.requireStripeObjectId)(paymentMethod.customer, "cus_", "paymentMethod.customer");
-    if (attachedCustomerId !== input.customerId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError("Stripe PaymentMethod is not attached to the authorized shared billing Customer.", { code: "customer_payment_method_mismatch", field: "paymentMethod.customer" });
-    }
-}
-function requireSetupSubscriptionClient(stripe) {
-    if (!("setupIntents" in stripe) ||
-        typeof stripe.setupIntents?.retrieve !==
-            "function") {
-        throw new errors_js_1.ProxyStripeAcquisitionError("The fromSetupIntent branch requires a merchant Stripe client with setupIntents.retrieve.", { code: "provider_response_invalid", field: "stripe.setupIntents.retrieve" });
-    }
-    return stripe;
-}
-function assertSubscriptionResponse(subscription, input) {
-    assertStripeId(subscription.id, "sub_", "subscription.id");
-    if (input.expectedSubscriptionId !== null && subscription.id !== input.expectedSubscriptionId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe returned Subscription ${subscription.id} while retrieving ${input.expectedSubscriptionId}.`, { code: "acquisition_mismatch", field: "subscription.id" });
-    }
-    (0, acquisition_js_1.assertAcquisitionMetadata)(subscription.metadata, input.expectedMetadata, "Stripe Subscription");
-    const customerId = (0, acquisition_js_1.requireStripeObjectId)(subscription.customer, "cus_", "subscription.customer");
-    const paymentMethodId = (0, acquisition_js_1.requireStripeObjectId)(subscription.default_payment_method, "pm_", "subscription.default_payment_method");
-    if (customerId !== input.customerId || paymentMethodId !== input.paymentMethodId) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe Subscription ${subscription.id} billing identity does not match the verified Customer and PaymentMethod.`, { code: "customer_payment_method_mismatch", field: "subscription.default_payment_method" });
-    }
-    requireSubscriptionStatus(subscription);
-}
-function requireSubscriptionStatus(subscription) {
-    const supported = new Set([
-        "active",
-        "canceled",
-        "incomplete",
-        "incomplete_expired",
-        "past_due",
-        "paused",
-        "trialing",
-        "unpaid",
-    ]);
-    if (typeof subscription.status !== "string" || !supported.has(subscription.status)) {
-        throw new errors_js_1.StripeResponseShapeError(`Stripe Subscription ${subscription.id} returned an unsupported status shape.`, "subscription.status");
-    }
-    return subscription.status;
-}
-function uniqueStrings(values) {
-    return [...new Set(values)];
-}
-function assertStripeId(value, prefix, field) {
-    if (!value.startsWith(prefix) || value.length <= prefix.length) {
-        throw new errors_js_1.ProxyStripeAcquisitionError(`Stripe ${field} is invalid.`, {
-            code: "provider_response_invalid",
-            field,
-        });
-    }
-}

package/dist/cjs/subscription-params.d.cts

@@ -1,33 +0,0 @@
-import type { PayerOpenedResult } from "@proxy-checkout/server-js";
-import type { StripeDirectSubscriptionClientLike, StripePriceLike, StripeRequestOptionsWithoutIdempotencyLike, StripeSetupIntentCreateParams, StripeSubscriptionCreateParams } from "./types.js";
-export interface ValidatedSubscriptionItem {
-    readonly priceId: string;
-    readonly quantity: number;
-}
-export interface VerifiedSubscriptionPriceItem extends ValidatedSubscriptionItem {
-    readonly price: StripePriceLike;
-    readonly unitAmountMinor: number;
-}
-export interface ValidateFixedSubscriptionPriceInput<TCart> {
-    readonly baseRecurringSubtotalMinor: number;
-    readonly cart: TCart;
-    readonly currency: string;
-    readonly items: readonly VerifiedSubscriptionPriceItem[];
-    readonly proxySession: PayerOpenedResult;
-}
-export type ValidateFixedSubscriptionPrice<TCart> = (input: ValidateFixedSubscriptionPriceInput<TCart>) => {
-    readonly expectedInitialInvoiceAmountMinor: number;
-} | Promise<{
-    readonly expectedInitialInvoiceAmountMinor: number;
-}>;
-export declare function assertAllowedSetupIntentParams(params: StripeSetupIntentCreateParams): void;
-export declare function validateSubscriptionParams(params: StripeSubscriptionCreateParams): readonly ValidatedSubscriptionItem[];
-export declare function retrieveAndValidateSubscriptionPrices<TCart>(input: {
-    cart: TCart;
-    items: readonly ValidatedSubscriptionItem[];
-    params: StripeSubscriptionCreateParams;
-    proxySession: PayerOpenedResult;
-    stripe: StripeDirectSubscriptionClientLike;
-    stripeRequestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-    validateFixedPrice?: ValidateFixedSubscriptionPrice<TCart>;
-}): Promise<readonly VerifiedSubscriptionPriceItem[]>;