@proxy-checkout/server-js 0.1.0-prx-124.148.1 → 0.1.0-prx-124.149.1

package/dist/cjs/events.d.cts

@@ -35,6 +35,13 @@ export interface ResolvedSubscriptionRenewed extends ResolvedBase {
     readonly subscription: MerchantProxySubscription;
     readonly willRenew: boolean;
 }
+export interface ResolvedSubscriptionChanged extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_changed";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
 export interface ResolvedSubscriptionCancelScheduled extends ResolvedBase {
     readonly accessEndsAt: Date | null;
     readonly kind: "subscription_cancel_scheduled";
@@ -78,7 +85,7 @@ export interface ResolvedIgnored extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionChanged | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;

package/dist/cjs/events.d.ts

@@ -35,6 +35,13 @@ export interface ResolvedSubscriptionRenewed extends ResolvedBase {
     readonly subscription: MerchantProxySubscription;
     readonly willRenew: boolean;
 }
+export interface ResolvedSubscriptionChanged extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_changed";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
 export interface ResolvedSubscriptionCancelScheduled extends ResolvedBase {
     readonly accessEndsAt: Date | null;
     readonly kind: "subscription_cancel_scheduled";
@@ -78,7 +85,7 @@ export interface ResolvedIgnored extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionChanged | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;

package/dist/cjs/events.js

@@ -147,6 +147,16 @@ class ProxyEventsResource {
                 willRenew: (0, lifecycle_js_1.subscriptionWillRenew)(subscription),
             };
         }
+        if (event.type === webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES.subscriptionChanged) {
+            return {
+                accessEndsAt,
+                event,
+                kind: "subscription_changed",
+                session,
+                subscription,
+                willRenew: (0, lifecycle_js_1.subscriptionWillRenew)(subscription),
+            };
+        }
         return {
             accessEndsAt,
             event,

package/dist/cjs/index.d.cts

@@ -2,9 +2,9 @@ export { type ProxyCartParseOptions, type ProxyCartValidator, parseProxyCart, }
 export { createProxyCheckoutServerClient, ProxyCheckoutServerClient, } from "./client.js";
 export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./consistency.js";
 export { isProxySessionNotFoundError, PROXY_SESSION_NOT_FOUND_ERROR_CODE, ProxyCheckoutApiError, type ProxyCheckoutApiErrorDetails, type ProxyCheckoutValidationCode, ProxyCheckoutValidationError, } from "./errors.js";
-export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
+export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionChanged, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
 export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, PROVISIONABLE_SESSION_STATUSES, parseOptionalProxyDate, requireProxyDate, subscriptionAccessEndsAt, subscriptionWillRenew, TERMINAL_SESSION_STATUSES, } from "./lifecycle.js";
-export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
+export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionDirectSubscriptionSource, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
 export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type CreateProxySessionOptions, type MarkProxySessionProvisionedInput, type MarkProxySessionProvisioningFailedInput, type MerchantProxySession, type PayerHandoffResult, type PayerOpenedResult, type ProxySession, type ProxySessionAcquisitionSummary, type ProxySessionActionableNextStep, ProxySessionCartResource, type ProxySessionCartResult, type ProxySessionHandoff, type ProxySessionPresentationState, type ProxySessionProviderBinding, type ProxySessionProvisioningAcknowledgement, ProxySessionsResource, type ProxySessionViewStatus, proxyCheckoutServerEndpoints, type RecordProviderBindingInput, type SetProxySessionCartInput, type TypedMerchantProxySession, } from "./sessions.js";
 export { type MerchantProxySubscription, ProxySubscriptionsResource, type ProxySubscriptionWithSession, type ProxySubscriptionWithUntypedSession, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
 export type { JsonObject, JsonPrimitive, JsonValue, ProxyCheckoutFetch, ProxyCheckoutServerClientOptions, ProxyCheckoutServerRequestOptions, } from "./types.js";

package/dist/cjs/index.d.ts

@@ -2,9 +2,9 @@ export { type ProxyCartParseOptions, type ProxyCartValidator, parseProxyCart, }
 export { createProxyCheckoutServerClient, ProxyCheckoutServerClient, } from "./client.js";
 export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./consistency.js";
 export { isProxySessionNotFoundError, PROXY_SESSION_NOT_FOUND_ERROR_CODE, ProxyCheckoutApiError, type ProxyCheckoutApiErrorDetails, type ProxyCheckoutValidationCode, ProxyCheckoutValidationError, } from "./errors.js";
-export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
+export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionChanged, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
 export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, PROVISIONABLE_SESSION_STATUSES, parseOptionalProxyDate, requireProxyDate, subscriptionAccessEndsAt, subscriptionWillRenew, TERMINAL_SESSION_STATUSES, } from "./lifecycle.js";
-export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
+export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionDirectSubscriptionSource, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
 export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type CreateProxySessionOptions, type MarkProxySessionProvisionedInput, type MarkProxySessionProvisioningFailedInput, type MerchantProxySession, type PayerHandoffResult, type PayerOpenedResult, type ProxySession, type ProxySessionAcquisitionSummary, type ProxySessionActionableNextStep, ProxySessionCartResource, type ProxySessionCartResult, type ProxySessionHandoff, type ProxySessionPresentationState, type ProxySessionProviderBinding, type ProxySessionProvisioningAcknowledgement, ProxySessionsResource, type ProxySessionViewStatus, proxyCheckoutServerEndpoints, type RecordProviderBindingInput, type SetProxySessionCartInput, type TypedMerchantProxySession, } from "./sessions.js";
 export { type MerchantProxySubscription, ProxySubscriptionsResource, type ProxySubscriptionWithSession, type ProxySubscriptionWithUntypedSession, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
 export type { JsonObject, JsonPrimitive, JsonValue, ProxyCheckoutFetch, ProxyCheckoutServerClientOptions, ProxyCheckoutServerRequestOptions, } from "./types.js";

package/dist/cjs/provider-acquisitions.d.cts

@@ -3,12 +3,14 @@ import type { ProxyCheckoutServerRequestOptions } from "./types.js";
 declare const providerAcquisitionCheckoutUiModes: readonly ["custom", "embedded", "hosted"];
 declare const providerAcquisitionObservedCheckoutUiModes: readonly ["custom", "embedded", "hosted", "unknown"];
 declare const providerAcquisitionCommercialModes: readonly ["one_time", "subscription"];
+declare const providerAcquisitionDirectSubscriptionSources: readonly ["saved_payment_method", "setup_intent"];
 declare const providerAcquisitionIntegrationPaths: readonly ["checkout_session", "direct_subscription", "payment_intent"];
 declare const providerAcquisitionObjectTypes: readonly ["checkout_session", "payment_intent", "setup_intent", "subscription"];
 declare const providerAcquisitionPricingModes: readonly ["fixed", "provider_finalized"];
 export type ProviderAcquisitionCheckoutUiMode = (typeof providerAcquisitionCheckoutUiModes)[number];
 export type ProviderAcquisitionObservedCheckoutUiMode = (typeof providerAcquisitionObservedCheckoutUiModes)[number];
 export type ProviderAcquisitionCommercialMode = (typeof providerAcquisitionCommercialModes)[number];
+export type ProviderAcquisitionDirectSubscriptionSource = (typeof providerAcquisitionDirectSubscriptionSources)[number];
 export type ProviderAcquisitionIntegrationPath = (typeof providerAcquisitionIntegrationPaths)[number];
 export type ProviderAcquisitionObjectType = (typeof providerAcquisitionObjectTypes)[number];
 export type ProviderAcquisitionPricingMode = (typeof providerAcquisitionPricingModes)[number];
@@ -21,6 +23,7 @@ export interface ProviderAcquisition {
     readonly directFeeBasisSource: string | null;
     readonly directMerchandiseCurrency: string | null;
     readonly directMerchandiseSubtotalMinor: number | null;
+    readonly directSubscriptionSource: ProviderAcquisitionDirectSubscriptionSource | null;
     readonly id: string;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     readonly merchantPspConfigId: string;
@@ -57,6 +60,8 @@ export interface ProviderAcquisitionReservation {
 export interface ReserveProviderAcquisitionInput extends ProxyCheckoutServerRequestOptions {
     readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
     readonly commercialMode: ProviderAcquisitionCommercialMode;
+    /** Required only for direct_subscription; selects its exact Stripe preparation branch. */
+    readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     /** Optional server-only direct PaymentIntent percentage basis; omit to use verified provider gross. */
     readonly merchandiseSubtotalMinor?: number;
@@ -74,6 +79,8 @@ export interface SupersedeProviderAcquisitionInput extends ProxyCheckoutServerRe
     readonly reason: string;
     readonly replacement: {
         readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
+        /** Required only for a direct_subscription replacement. */
+        readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
         readonly integrationPath: ProviderAcquisitionIntegrationPath;
         readonly providerOptionsFingerprint: string;
     };

package/dist/cjs/provider-acquisitions.d.ts

@@ -3,12 +3,14 @@ import type { ProxyCheckoutServerRequestOptions } from "./types.js";
 declare const providerAcquisitionCheckoutUiModes: readonly ["custom", "embedded", "hosted"];
 declare const providerAcquisitionObservedCheckoutUiModes: readonly ["custom", "embedded", "hosted", "unknown"];
 declare const providerAcquisitionCommercialModes: readonly ["one_time", "subscription"];
+declare const providerAcquisitionDirectSubscriptionSources: readonly ["saved_payment_method", "setup_intent"];
 declare const providerAcquisitionIntegrationPaths: readonly ["checkout_session", "direct_subscription", "payment_intent"];
 declare const providerAcquisitionObjectTypes: readonly ["checkout_session", "payment_intent", "setup_intent", "subscription"];
 declare const providerAcquisitionPricingModes: readonly ["fixed", "provider_finalized"];
 export type ProviderAcquisitionCheckoutUiMode = (typeof providerAcquisitionCheckoutUiModes)[number];
 export type ProviderAcquisitionObservedCheckoutUiMode = (typeof providerAcquisitionObservedCheckoutUiModes)[number];
 export type ProviderAcquisitionCommercialMode = (typeof providerAcquisitionCommercialModes)[number];
+export type ProviderAcquisitionDirectSubscriptionSource = (typeof providerAcquisitionDirectSubscriptionSources)[number];
 export type ProviderAcquisitionIntegrationPath = (typeof providerAcquisitionIntegrationPaths)[number];
 export type ProviderAcquisitionObjectType = (typeof providerAcquisitionObjectTypes)[number];
 export type ProviderAcquisitionPricingMode = (typeof providerAcquisitionPricingModes)[number];
@@ -21,6 +23,7 @@ export interface ProviderAcquisition {
     readonly directFeeBasisSource: string | null;
     readonly directMerchandiseCurrency: string | null;
     readonly directMerchandiseSubtotalMinor: number | null;
+    readonly directSubscriptionSource: ProviderAcquisitionDirectSubscriptionSource | null;
     readonly id: string;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     readonly merchantPspConfigId: string;
@@ -57,6 +60,8 @@ export interface ProviderAcquisitionReservation {
 export interface ReserveProviderAcquisitionInput extends ProxyCheckoutServerRequestOptions {
     readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
     readonly commercialMode: ProviderAcquisitionCommercialMode;
+    /** Required only for direct_subscription; selects its exact Stripe preparation branch. */
+    readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     /** Optional server-only direct PaymentIntent percentage basis; omit to use verified provider gross. */
     readonly merchandiseSubtotalMinor?: number;
@@ -74,6 +79,8 @@ export interface SupersedeProviderAcquisitionInput extends ProxyCheckoutServerRe
     readonly reason: string;
     readonly replacement: {
         readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
+        /** Required only for a direct_subscription replacement. */
+        readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
         readonly integrationPath: ProviderAcquisitionIntegrationPath;
         readonly providerOptionsFingerprint: string;
     };

package/dist/cjs/provider-acquisitions.js

@@ -8,6 +8,10 @@ const providerAcquisitionObservedCheckoutUiModes = [
     "unknown",
 ];
 const providerAcquisitionCommercialModes = ["one_time", "subscription"];
+const providerAcquisitionDirectSubscriptionSources = [
+    "saved_payment_method",
+    "setup_intent",
+];
 const providerAcquisitionIntegrationPaths = [
     "checkout_session",
     "direct_subscription",
@@ -52,6 +56,9 @@ class ProxyProviderAcquisitionsResource {
         const response = await this.httpClient.request("POST", `/proxy_sessions/${encodeURIComponent(proxySessionId)}/acquisition_attempts`, {
             ...(input.checkoutUiMode === undefined ? {} : { checkout_ui_mode: input.checkoutUiMode }),
             commercial_mode: input.commercialMode,
+            ...(input.directSubscriptionSource === undefined
+                ? {}
+                : { direct_subscription_source: input.directSubscriptionSource }),
             integration_path: input.integrationPath,
             ...(input.merchandiseSubtotalMinor === undefined
                 ? {}
@@ -78,6 +85,9 @@ class ProxyProviderAcquisitionsResource {
                 ...(input.replacement.checkoutUiMode === undefined
                     ? {}
                     : { checkout_ui_mode: input.replacement.checkoutUiMode }),
+                ...(input.replacement.directSubscriptionSource === undefined
+                    ? {}
+                    : { direct_subscription_source: input.replacement.directSubscriptionSource }),
                 integration_path: input.replacement.integrationPath,
                 provider_options_fingerprint: input.replacement.providerOptionsFingerprint,
             },
@@ -134,6 +144,7 @@ function parseAcquisition(value, operation) {
         directFeeBasisSource: (0, response_validators_js_1.requireNullableString)(body.direct_fee_basis_source, `${operation}.directFeeBasisSource`),
         directMerchandiseCurrency: (0, response_validators_js_1.requireNullableString)(body.direct_merchandise_currency, `${operation}.directMerchandiseCurrency`),
         directMerchandiseSubtotalMinor: (0, response_validators_js_1.requireNullableInteger)(body.direct_merchandise_subtotal_minor, `${operation}.directMerchandiseSubtotalMinor`),
+        directSubscriptionSource: requireNullableEnum(body.direct_subscription_source, `${operation}.directSubscriptionSource`, providerAcquisitionDirectSubscriptionSources),
         id: (0, response_validators_js_1.requireString)(body.id, `${operation}.id`),
         integrationPath: requireEnum(body.integration_path, `${operation}.integrationPath`, providerAcquisitionIntegrationPaths),
         merchantPspConfigId: (0, response_validators_js_1.requireString)(body.merchant_psp_config_id, `${operation}.merchantPspConfigId`),

package/dist/cjs/version.d.cts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.148.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.148.1";
+export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.149.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.149.1";

package/dist/cjs/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.148.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.148.1";
+export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.149.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.149.1";

package/dist/cjs/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkName = void 0;
 exports.proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-exports.proxyCheckoutServerSdkVersion = "0.1.0-prx-124.148.1";
+exports.proxyCheckoutServerSdkVersion = "0.1.0-prx-124.149.1";
 exports.proxyCheckoutServerSdkUserAgent = `${exports.proxyCheckoutServerSdkName}/${exports.proxyCheckoutServerSdkVersion}`;

package/dist/cjs/webhook-events.d.cts

@@ -30,10 +30,8 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionChanged: "subscription.changed";
-    readonly subscriptionConfigurationActionRequired: "subscription.configuration_action_required";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
     readonly subscriptionRenewed: "subscription.renewed";
-    readonly subscriptionTrialEnding: "subscription.trial_ending";
 };
 export type ProxyWebhookEventType = (typeof PROXY_WEBHOOK_EVENT_TYPES)[keyof typeof PROXY_WEBHOOK_EVENT_TYPES];
 /** True for `proxy_session.*` events. */

package/dist/cjs/webhook-events.d.ts

@@ -30,10 +30,8 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionChanged: "subscription.changed";
-    readonly subscriptionConfigurationActionRequired: "subscription.configuration_action_required";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
     readonly subscriptionRenewed: "subscription.renewed";
-    readonly subscriptionTrialEnding: "subscription.trial_ending";
 };
 export type ProxyWebhookEventType = (typeof PROXY_WEBHOOK_EVENT_TYPES)[keyof typeof PROXY_WEBHOOK_EVENT_TYPES];
 /** True for `proxy_session.*` events. */

package/dist/cjs/webhook-events.js

@@ -38,10 +38,8 @@ exports.PROXY_WEBHOOK_EVENT_TYPES = {
     subscriptionCancelled: "subscription.cancelled",
     subscriptionCancelScheduled: "subscription.cancel_scheduled",
     subscriptionChanged: "subscription.changed",
-    subscriptionConfigurationActionRequired: "subscription.configuration_action_required",
     subscriptionPaymentFailed: "subscription.payment_failed",
     subscriptionRenewed: "subscription.renewed",
-    subscriptionTrialEnding: "subscription.trial_ending",
 };
 const SESSION_EVENT_TYPES = new Set([
     exports.PROXY_WEBHOOK_EVENT_TYPES.sessionCancelled,
@@ -55,10 +53,8 @@ const SUBSCRIPTION_EVENT_TYPES = new Set([
     exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionCancelScheduled,
     exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionCancelled,
     exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionChanged,
-    exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionConfigurationActionRequired,
     exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionPaymentFailed,
     exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionRenewed,
-    exports.PROXY_WEBHOOK_EVENT_TYPES.subscriptionTrialEnding,
 ]);
 const PAYMENT_ATTEMPT_EVENT_TYPES = new Set([
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptCancelled,

package/dist/esm/events.d.ts

@@ -35,6 +35,13 @@ export interface ResolvedSubscriptionRenewed extends ResolvedBase {
     readonly subscription: MerchantProxySubscription;
     readonly willRenew: boolean;
 }
+export interface ResolvedSubscriptionChanged extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_changed";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
 export interface ResolvedSubscriptionCancelScheduled extends ResolvedBase {
     readonly accessEndsAt: Date | null;
     readonly kind: "subscription_cancel_scheduled";
@@ -78,7 +85,7 @@ export interface ResolvedIgnored extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionChanged | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;

package/dist/esm/events.js

@@ -8,7 +8,7 @@
  */
 import { assertSubscriptionMatchesSession } from "./consistency.js";
 import { isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, subscriptionAccessEndsAt, subscriptionWillRenew, } from "./lifecycle.js";
-import { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxySubscriptionEvent, } from "./webhook-events.js";
+import { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, } from "./webhook-events.js";
 export class ProxyEventsResource {
     sessions;
     subscriptions;
@@ -144,6 +144,16 @@ export class ProxyEventsResource {
                 willRenew: subscriptionWillRenew(subscription),
             };
         }
+        if (event.type === PROXY_WEBHOOK_EVENT_TYPES.subscriptionChanged) {
+            return {
+                accessEndsAt,
+                event,
+                kind: "subscription_changed",
+                session,
+                subscription,
+                willRenew: subscriptionWillRenew(subscription),
+            };
+        }
         return {
             accessEndsAt,
             event,

package/dist/esm/index.d.ts

@@ -2,9 +2,9 @@ export { type ProxyCartParseOptions, type ProxyCartValidator, parseProxyCart, }
 export { createProxyCheckoutServerClient, ProxyCheckoutServerClient, } from "./client.js";
 export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./consistency.js";
 export { isProxySessionNotFoundError, PROXY_SESSION_NOT_FOUND_ERROR_CODE, ProxyCheckoutApiError, type ProxyCheckoutApiErrorDetails, type ProxyCheckoutValidationCode, ProxyCheckoutValidationError, } from "./errors.js";
-export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
+export { ProxyEventsResource, type ResolvedAcquisitionProgress, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionChanged, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
 export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, PROVISIONABLE_SESSION_STATUSES, parseOptionalProxyDate, requireProxyDate, subscriptionAccessEndsAt, subscriptionWillRenew, TERMINAL_SESSION_STATUSES, } from "./lifecycle.js";
-export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
+export { type AttachProviderAcquisitionObjectInput, type ProviderAcquisition, type ProviderAcquisitionCheckoutUiMode, type ProviderAcquisitionCommercialMode, type ProviderAcquisitionDirectSubscriptionSource, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
 export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type CreateProxySessionOptions, type MarkProxySessionProvisionedInput, type MarkProxySessionProvisioningFailedInput, type MerchantProxySession, type PayerHandoffResult, type PayerOpenedResult, type ProxySession, type ProxySessionAcquisitionSummary, type ProxySessionActionableNextStep, ProxySessionCartResource, type ProxySessionCartResult, type ProxySessionHandoff, type ProxySessionPresentationState, type ProxySessionProviderBinding, type ProxySessionProvisioningAcknowledgement, ProxySessionsResource, type ProxySessionViewStatus, proxyCheckoutServerEndpoints, type RecordProviderBindingInput, type SetProxySessionCartInput, type TypedMerchantProxySession, } from "./sessions.js";
 export { type MerchantProxySubscription, ProxySubscriptionsResource, type ProxySubscriptionWithSession, type ProxySubscriptionWithUntypedSession, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
 export type { JsonObject, JsonPrimitive, JsonValue, ProxyCheckoutFetch, ProxyCheckoutServerClientOptions, ProxyCheckoutServerRequestOptions, } from "./types.js";

package/dist/esm/provider-acquisitions.d.ts

@@ -3,12 +3,14 @@ import type { ProxyCheckoutServerRequestOptions } from "./types.js";
 declare const providerAcquisitionCheckoutUiModes: readonly ["custom", "embedded", "hosted"];
 declare const providerAcquisitionObservedCheckoutUiModes: readonly ["custom", "embedded", "hosted", "unknown"];
 declare const providerAcquisitionCommercialModes: readonly ["one_time", "subscription"];
+declare const providerAcquisitionDirectSubscriptionSources: readonly ["saved_payment_method", "setup_intent"];
 declare const providerAcquisitionIntegrationPaths: readonly ["checkout_session", "direct_subscription", "payment_intent"];
 declare const providerAcquisitionObjectTypes: readonly ["checkout_session", "payment_intent", "setup_intent", "subscription"];
 declare const providerAcquisitionPricingModes: readonly ["fixed", "provider_finalized"];
 export type ProviderAcquisitionCheckoutUiMode = (typeof providerAcquisitionCheckoutUiModes)[number];
 export type ProviderAcquisitionObservedCheckoutUiMode = (typeof providerAcquisitionObservedCheckoutUiModes)[number];
 export type ProviderAcquisitionCommercialMode = (typeof providerAcquisitionCommercialModes)[number];
+export type ProviderAcquisitionDirectSubscriptionSource = (typeof providerAcquisitionDirectSubscriptionSources)[number];
 export type ProviderAcquisitionIntegrationPath = (typeof providerAcquisitionIntegrationPaths)[number];
 export type ProviderAcquisitionObjectType = (typeof providerAcquisitionObjectTypes)[number];
 export type ProviderAcquisitionPricingMode = (typeof providerAcquisitionPricingModes)[number];
@@ -21,6 +23,7 @@ export interface ProviderAcquisition {
     readonly directFeeBasisSource: string | null;
     readonly directMerchandiseCurrency: string | null;
     readonly directMerchandiseSubtotalMinor: number | null;
+    readonly directSubscriptionSource: ProviderAcquisitionDirectSubscriptionSource | null;
     readonly id: string;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     readonly merchantPspConfigId: string;
@@ -57,6 +60,8 @@ export interface ProviderAcquisitionReservation {
 export interface ReserveProviderAcquisitionInput extends ProxyCheckoutServerRequestOptions {
     readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
     readonly commercialMode: ProviderAcquisitionCommercialMode;
+    /** Required only for direct_subscription; selects its exact Stripe preparation branch. */
+    readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
     readonly integrationPath: ProviderAcquisitionIntegrationPath;
     /** Optional server-only direct PaymentIntent percentage basis; omit to use verified provider gross. */
     readonly merchandiseSubtotalMinor?: number;
@@ -74,6 +79,8 @@ export interface SupersedeProviderAcquisitionInput extends ProxyCheckoutServerRe
     readonly reason: string;
     readonly replacement: {
         readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
+        /** Required only for a direct_subscription replacement. */
+        readonly directSubscriptionSource?: ProviderAcquisitionDirectSubscriptionSource;
         readonly integrationPath: ProviderAcquisitionIntegrationPath;
         readonly providerOptionsFingerprint: string;
     };

package/dist/esm/provider-acquisitions.js

@@ -5,6 +5,10 @@ const providerAcquisitionObservedCheckoutUiModes = [
     "unknown",
 ];
 const providerAcquisitionCommercialModes = ["one_time", "subscription"];
+const providerAcquisitionDirectSubscriptionSources = [
+    "saved_payment_method",
+    "setup_intent",
+];
 const providerAcquisitionIntegrationPaths = [
     "checkout_session",
     "direct_subscription",
@@ -49,6 +53,9 @@ export class ProxyProviderAcquisitionsResource {
         const response = await this.httpClient.request("POST", `/proxy_sessions/${encodeURIComponent(proxySessionId)}/acquisition_attempts`, {
             ...(input.checkoutUiMode === undefined ? {} : { checkout_ui_mode: input.checkoutUiMode }),
             commercial_mode: input.commercialMode,
+            ...(input.directSubscriptionSource === undefined
+                ? {}
+                : { direct_subscription_source: input.directSubscriptionSource }),
             integration_path: input.integrationPath,
             ...(input.merchandiseSubtotalMinor === undefined
                 ? {}
@@ -75,6 +82,9 @@ export class ProxyProviderAcquisitionsResource {
                 ...(input.replacement.checkoutUiMode === undefined
                     ? {}
                     : { checkout_ui_mode: input.replacement.checkoutUiMode }),
+                ...(input.replacement.directSubscriptionSource === undefined
+                    ? {}
+                    : { direct_subscription_source: input.replacement.directSubscriptionSource }),
                 integration_path: input.replacement.integrationPath,
                 provider_options_fingerprint: input.replacement.providerOptionsFingerprint,
             },
@@ -130,6 +140,7 @@ function parseAcquisition(value, operation) {
         directFeeBasisSource: requireNullableString(body.direct_fee_basis_source, `${operation}.directFeeBasisSource`),
         directMerchandiseCurrency: requireNullableString(body.direct_merchandise_currency, `${operation}.directMerchandiseCurrency`),
         directMerchandiseSubtotalMinor: requireNullableInteger(body.direct_merchandise_subtotal_minor, `${operation}.directMerchandiseSubtotalMinor`),
+        directSubscriptionSource: requireNullableEnum(body.direct_subscription_source, `${operation}.directSubscriptionSource`, providerAcquisitionDirectSubscriptionSources),
         id: requireString(body.id, `${operation}.id`),
         integrationPath: requireEnum(body.integration_path, `${operation}.integrationPath`, providerAcquisitionIntegrationPaths),
         merchantPspConfigId: requireString(body.merchant_psp_config_id, `${operation}.merchantPspConfigId`),

package/dist/esm/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.148.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.148.1";
+export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.149.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.149.1";

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 export const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.148.1";
+export const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.149.1";
 export const proxyCheckoutServerSdkUserAgent = `${proxyCheckoutServerSdkName}/${proxyCheckoutServerSdkVersion}`;

package/dist/esm/webhook-events.d.ts

@@ -30,10 +30,8 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionChanged: "subscription.changed";
-    readonly subscriptionConfigurationActionRequired: "subscription.configuration_action_required";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
     readonly subscriptionRenewed: "subscription.renewed";
-    readonly subscriptionTrialEnding: "subscription.trial_ending";
 };
 export type ProxyWebhookEventType = (typeof PROXY_WEBHOOK_EVENT_TYPES)[keyof typeof PROXY_WEBHOOK_EVENT_TYPES];
 /** True for `proxy_session.*` events. */

package/dist/esm/webhook-events.js

@@ -30,10 +30,8 @@ export const PROXY_WEBHOOK_EVENT_TYPES = {
     subscriptionCancelled: "subscription.cancelled",
     subscriptionCancelScheduled: "subscription.cancel_scheduled",
     subscriptionChanged: "subscription.changed",
-    subscriptionConfigurationActionRequired: "subscription.configuration_action_required",
     subscriptionPaymentFailed: "subscription.payment_failed",
     subscriptionRenewed: "subscription.renewed",
-    subscriptionTrialEnding: "subscription.trial_ending",
 };
 const SESSION_EVENT_TYPES = new Set([
     PROXY_WEBHOOK_EVENT_TYPES.sessionCancelled,
@@ -47,10 +45,8 @@ const SUBSCRIPTION_EVENT_TYPES = new Set([
     PROXY_WEBHOOK_EVENT_TYPES.subscriptionCancelScheduled,
     PROXY_WEBHOOK_EVENT_TYPES.subscriptionCancelled,
     PROXY_WEBHOOK_EVENT_TYPES.subscriptionChanged,
-    PROXY_WEBHOOK_EVENT_TYPES.subscriptionConfigurationActionRequired,
     PROXY_WEBHOOK_EVENT_TYPES.subscriptionPaymentFailed,
     PROXY_WEBHOOK_EVENT_TYPES.subscriptionRenewed,
-    PROXY_WEBHOOK_EVENT_TYPES.subscriptionTrialEnding,
 ]);
 const PAYMENT_ATTEMPT_EVENT_TYPES = new Set([
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptCancelled,

package/package.json

@@ -7,7 +7,7 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/esm/index.d.ts",
-  "version": "0.1.0-prx-124.148.1",
+  "version": "0.1.0-prx-124.149.1",
   "devDependencies": {
     "@types/node": "^24.12.4",
     "@vitest/coverage-v8": "4.1.7",