@proxy-checkout/server-js 0.1.0-prx-124.150.1 → 0.1.0-prx-146.153.1

package/README.md

@@ -15,6 +15,7 @@ This package should expose the merchant-authenticated backend routes that exist
 | `proxy.sessions.payerHandoff` | `POST /proxy_sessions/:id/payer_handoff` | Low-level escape hatch. Most delegated checkout integrations should use `createHandoff`. |
 | `proxy.sessions.payerOpened` | `POST /proxy_sessions/:id/payer_opened` | Low-level escape hatch. Stripe integrations should usually let `@proxy-checkout/stripe-server-js` call this through `openCheckout`. |
 | `proxy.subscriptions.retrieve` | `GET /subscriptions/:id` | Retrieve current Proxy-linked subscription lifecycle state. |
+| `proxy.liveContractDiagnostics.retrieve` | `GET /stripe_live_contract_diagnostics` | Retrieve bounded, provider-ID-free evidence for a test-mode Stripe live-contract run, including per-session shared-planner shadow comparisons. |
 | `proxy.webhookEndpoints.list` | `GET /webhook_endpoints` | List outbound merchant webhook endpoints. |
 | `proxy.webhookEndpoints.create` | `POST /webhook_endpoints` | Create an outbound endpoint and receive its one-time signing secret. |
 | `proxy.webhookEndpoints.get` | `GET /webhook_endpoints/:id` | Read one outbound endpoint. |

package/dist/cjs/client.d.cts

@@ -1,4 +1,5 @@
 import { ProxyEventsResource } from "./events.js";
+import { ProxyLiveContractDiagnosticsResource } from "./live-contract-diagnostics.js";
 import { ProxyProviderAcquisitionsResource } from "./provider-acquisitions.js";
 import { ProxySessionsResource } from "./sessions.js";
 import { ProxySubscriptionsResource } from "./subscriptions.js";
@@ -10,6 +11,8 @@ export declare class ProxyCheckoutServerClient {
     readonly sessions: ProxySessionsResource;
     readonly providerAcquisitions: ProxyProviderAcquisitionsResource;
     readonly subscriptions: ProxySubscriptionsResource;
+    /** Bounded, provider-ID-free evidence for Stripe live-contract validation runs. */
+    readonly liveContractDiagnostics: ProxyLiveContractDiagnosticsResource;
     /** Current-state lifecycle resolver for signed webhook events. */
     readonly events: ProxyEventsResource;
     /** Webhook delivery handling: `handle`, `process`, `constructEvent`. */

package/dist/cjs/client.d.ts

@@ -1,4 +1,5 @@
 import { ProxyEventsResource } from "./events.js";
+import { ProxyLiveContractDiagnosticsResource } from "./live-contract-diagnostics.js";
 import { ProxyProviderAcquisitionsResource } from "./provider-acquisitions.js";
 import { ProxySessionsResource } from "./sessions.js";
 import { ProxySubscriptionsResource } from "./subscriptions.js";
@@ -10,6 +11,8 @@ export declare class ProxyCheckoutServerClient {
     readonly sessions: ProxySessionsResource;
     readonly providerAcquisitions: ProxyProviderAcquisitionsResource;
     readonly subscriptions: ProxySubscriptionsResource;
+    /** Bounded, provider-ID-free evidence for Stripe live-contract validation runs. */
+    readonly liveContractDiagnostics: ProxyLiveContractDiagnosticsResource;
     /** Current-state lifecycle resolver for signed webhook events. */
     readonly events: ProxyEventsResource;
     /** Webhook delivery handling: `handle`, `process`, `constructEvent`. */

package/dist/cjs/client.js

@@ -4,6 +4,7 @@ exports.ProxyCheckoutServerClient = void 0;
 exports.createProxyCheckoutServerClient = createProxyCheckoutServerClient;
 const events_js_1 = require("./events.js");
 const http_client_js_1 = require("./http-client.js");
+const live_contract_diagnostics_js_1 = require("./live-contract-diagnostics.js");
 const provider_acquisitions_js_1 = require("./provider-acquisitions.js");
 const sessions_js_1 = require("./sessions.js");
 const subscriptions_js_1 = require("./subscriptions.js");
@@ -14,6 +15,8 @@ class ProxyCheckoutServerClient {
     sessions;
     providerAcquisitions;
     subscriptions;
+    /** Bounded, provider-ID-free evidence for Stripe live-contract validation runs. */
+    liveContractDiagnostics;
     /** Current-state lifecycle resolver for signed webhook events. */
     events;
     /** Webhook delivery handling: `handle`, `process`, `constructEvent`. */
@@ -33,6 +36,7 @@ class ProxyCheckoutServerClient {
         });
         this.providerAcquisitions = new provider_acquisitions_js_1.ProxyProviderAcquisitionsResource(httpClient);
         this.subscriptions = new subscriptions_js_1.ProxySubscriptionsResource(httpClient, this.sessions);
+        this.liveContractDiagnostics = new live_contract_diagnostics_js_1.ProxyLiveContractDiagnosticsResource(httpClient);
         this.events = new events_js_1.ProxyEventsResource(this.sessions, this.subscriptions, this.providerAcquisitions);
         this.webhooks = new webhook_handler_js_1.ProxyWebhooksResource(this.events, this.sessions);
         this.webhookEndpoints = new webhooks_js_1.ProxyWebhookEndpointsResource(httpClient);

package/dist/cjs/errors.d.cts

@@ -4,7 +4,7 @@ export interface ProxyCheckoutApiErrorDetails {
     readonly responseBody: unknown;
     readonly statusCode: number;
 }
-export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "cart_version_conflict" | "commercial_mode_required" | "invalid_date" | "invalid_session_presentation" | "provider_acquisition_in_progress" | "provider_binding_missing" | "provider_binding_mismatch" | "subscription_session_mismatch" | "unsupported_provider_option" | "webhook_sessions_resource_missing";
+export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "cart_version_conflict" | "acquisition_provider_options_conflict" | "commercial_mode_required" | "invalid_date" | "invalid_session_presentation" | "merchandise_subtotal_invalid" | "provider_acquisition_in_progress" | "provider_binding_missing" | "provider_binding_mismatch" | "subscription_session_mismatch" | "unsupported_provider_option" | "webhook_sessions_resource_missing";
 /**
  * Raised when the SDK receives Proxy data it cannot safely normalize, for
  * example an invalid date string, a cart snapshot that fails the merchant

package/dist/cjs/errors.d.ts

@@ -4,7 +4,7 @@ export interface ProxyCheckoutApiErrorDetails {
     readonly responseBody: unknown;
     readonly statusCode: number;
 }
-export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "cart_version_conflict" | "commercial_mode_required" | "invalid_date" | "invalid_session_presentation" | "provider_acquisition_in_progress" | "provider_binding_missing" | "provider_binding_mismatch" | "subscription_session_mismatch" | "unsupported_provider_option" | "webhook_sessions_resource_missing";
+export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "cart_version_conflict" | "acquisition_provider_options_conflict" | "commercial_mode_required" | "invalid_date" | "invalid_session_presentation" | "merchandise_subtotal_invalid" | "provider_acquisition_in_progress" | "provider_binding_missing" | "provider_binding_mismatch" | "subscription_session_mismatch" | "unsupported_provider_option" | "webhook_sessions_resource_missing";
 /**
  * Raised when the SDK receives Proxy data it cannot safely normalize, for
  * example an invalid date string, a cart snapshot that fails the merchant

package/dist/cjs/events.d.cts

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

package/dist/cjs/events.d.ts

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

package/dist/cjs/events.js

@@ -136,6 +136,19 @@ class ProxyEventsResource {
                 willRenew: false,
             };
         }
+        if (subscription.configurationStatus === "action_required" ||
+            subscription.latestPaymentStatus === "action_required") {
+            return {
+                accessEndsAt,
+                configurationReason: subscription.configurationReason,
+                event,
+                kind: "subscription_action_required",
+                latestPaymentStatus: subscription.latestPaymentStatus,
+                session,
+                subscription,
+                willRenew: (0, lifecycle_js_1.subscriptionWillRenew)(subscription),
+            };
+        }
         if ((0, lifecycle_js_1.isSubscriptionPaymentAtRisk)(subscription)) {
             return {
                 accessEndsAt,
@@ -157,6 +170,19 @@ class ProxyEventsResource {
                 willRenew: (0, lifecycle_js_1.subscriptionWillRenew)(subscription),
             };
         }
+        if (event.type === webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES.subscriptionCancelScheduleRemoved ||
+            event.type === webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES.subscriptionPaused ||
+            event.type === webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES.subscriptionResumed ||
+            event.type === webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES.subscriptionTrialEnding) {
+            return {
+                accessEndsAt,
+                event,
+                kind: "subscription_changed",
+                session,
+                subscription,
+                willRenew: (0, lifecycle_js_1.subscriptionWillRenew)(subscription),
+            };
+        }
         return {
             accessEndsAt,
             event,

package/dist/cjs/index.d.cts

@@ -4,7 +4,8 @@ export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./c
 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 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 ProviderAcquisitionDirectSubscriptionSource, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
+export { type LiveContractDiagnosticAcquisition, type LiveContractDiagnosticBaseline, type LiveContractDiagnosticDelivery, type LiveContractDiagnosticDeployment, type LiveContractDiagnosticDomainEvent, type LiveContractDiagnosticEvidenceSourceType, type LiveContractDiagnosticFee, type LiveContractDiagnosticFinalCart, type LiveContractDiagnosticInvoice, type LiveContractDiagnosticOutbox, type LiveContractDiagnosticReconciliationIssue, type LiveContractDiagnosticRecovery, type LiveContractDiagnosticSession, type LiveContractDiagnosticShadowComparison, type LiveContractDiagnosticShadowComparisonDisposition, type LiveContractDiagnosticShadowComparisonReasonCode, type LiveContractDiagnosticSubscription, ProxyLiveContractDiagnosticsResource, proxyCheckoutLiveContractDiagnosticEndpoints, type RetrieveLiveContractDiagnosticsInput, type StripeLiveContractDiagnostic, } from "./live-contract-diagnostics.js";
+export { type AttachProviderAcquisitionObjectInput, type ConfirmProviderAcquisitionCartInput, type ProviderAcquisition, type ProviderAcquisitionCartConfirmationInput, 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

@@ -4,7 +4,8 @@ export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./c
 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 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 ProviderAcquisitionDirectSubscriptionSource, type ProviderAcquisitionIntegrationPath, type ProviderAcquisitionObjectType, type ProviderAcquisitionObservedCheckoutUiMode, type ProviderAcquisitionPricingMode, type ProviderAcquisitionReservation, ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndpoints, type ReserveProviderAcquisitionInput, type SupersedeProviderAcquisitionInput, } from "./provider-acquisitions.js";
+export { type LiveContractDiagnosticAcquisition, type LiveContractDiagnosticBaseline, type LiveContractDiagnosticDelivery, type LiveContractDiagnosticDeployment, type LiveContractDiagnosticDomainEvent, type LiveContractDiagnosticEvidenceSourceType, type LiveContractDiagnosticFee, type LiveContractDiagnosticFinalCart, type LiveContractDiagnosticInvoice, type LiveContractDiagnosticOutbox, type LiveContractDiagnosticReconciliationIssue, type LiveContractDiagnosticRecovery, type LiveContractDiagnosticSession, type LiveContractDiagnosticShadowComparison, type LiveContractDiagnosticShadowComparisonDisposition, type LiveContractDiagnosticShadowComparisonReasonCode, type LiveContractDiagnosticSubscription, ProxyLiveContractDiagnosticsResource, proxyCheckoutLiveContractDiagnosticEndpoints, type RetrieveLiveContractDiagnosticsInput, type StripeLiveContractDiagnostic, } from "./live-contract-diagnostics.js";
+export { type AttachProviderAcquisitionObjectInput, type ConfirmProviderAcquisitionCartInput, type ProviderAcquisition, type ProviderAcquisitionCartConfirmationInput, 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.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyProxyWebhookSignature = exports.proxyCheckoutWebhookEndpointEndpoints = exports.ProxyWebhookSignatureVerificationError = exports.ProxyWebhookEndpointsResource = exports.PROXY_SIGNATURE_HEADER = exports.constructProxyWebhookEvent = exports.ProxyWebhooksResource = exports.PROXY_WEBHOOK_RETRY_AFTER_SECONDS = exports.PROXY_WEBHOOK_EVENT_TYPES = exports.isProxySubscriptionEvent = exports.isProxyShopifyEvent = exports.isProxySessionEvent = exports.isProxyProviderAcquisitionEvent = exports.isProxyPaymentAttemptEvent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkName = exports.proxyCheckoutSubscriptionEndpoints = exports.ProxySubscriptionsResource = exports.proxyCheckoutServerEndpoints = exports.ProxySessionsResource = exports.ProxySessionCartResource = exports.proxyCheckoutProviderAcquisitionEndpoints = exports.ProxyProviderAcquisitionsResource = exports.TERMINAL_SESSION_STATUSES = exports.subscriptionWillRenew = exports.subscriptionAccessEndsAt = exports.requireProxyDate = exports.parseOptionalProxyDate = exports.PROVISIONABLE_SESSION_STATUSES = exports.isSubscriptionPaymentAtRisk = exports.isSubscriptionEnded = exports.isSessionTerminal = exports.isSessionProvisionable = exports.ENDED_SUBSCRIPTION_STATUSES = exports.AT_RISK_SUBSCRIPTION_STATUSES = exports.ProxyEventsResource = exports.ProxyCheckoutValidationError = exports.ProxyCheckoutApiError = exports.PROXY_SESSION_NOT_FOUND_ERROR_CODE = exports.isProxySessionNotFoundError = exports.assertSubscriptionMatchesSession = exports.assertCartBuyerReference = exports.ProxyCheckoutServerClient = exports.createProxyCheckoutServerClient = exports.parseProxyCart = void 0;
+exports.verifyProxyWebhookSignature = exports.proxyCheckoutWebhookEndpointEndpoints = exports.ProxyWebhookSignatureVerificationError = exports.ProxyWebhookEndpointsResource = exports.PROXY_SIGNATURE_HEADER = exports.constructProxyWebhookEvent = exports.ProxyWebhooksResource = exports.PROXY_WEBHOOK_RETRY_AFTER_SECONDS = exports.PROXY_WEBHOOK_EVENT_TYPES = exports.isProxySubscriptionEvent = exports.isProxyShopifyEvent = exports.isProxySessionEvent = exports.isProxyProviderAcquisitionEvent = exports.isProxyPaymentAttemptEvent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkName = exports.proxyCheckoutSubscriptionEndpoints = exports.ProxySubscriptionsResource = exports.proxyCheckoutServerEndpoints = exports.ProxySessionsResource = exports.ProxySessionCartResource = exports.proxyCheckoutProviderAcquisitionEndpoints = exports.ProxyProviderAcquisitionsResource = exports.proxyCheckoutLiveContractDiagnosticEndpoints = exports.ProxyLiveContractDiagnosticsResource = exports.TERMINAL_SESSION_STATUSES = exports.subscriptionWillRenew = exports.subscriptionAccessEndsAt = exports.requireProxyDate = exports.parseOptionalProxyDate = exports.PROVISIONABLE_SESSION_STATUSES = exports.isSubscriptionPaymentAtRisk = exports.isSubscriptionEnded = exports.isSessionTerminal = exports.isSessionProvisionable = exports.ENDED_SUBSCRIPTION_STATUSES = exports.AT_RISK_SUBSCRIPTION_STATUSES = exports.ProxyEventsResource = exports.ProxyCheckoutValidationError = exports.ProxyCheckoutApiError = exports.PROXY_SESSION_NOT_FOUND_ERROR_CODE = exports.isProxySessionNotFoundError = exports.assertSubscriptionMatchesSession = exports.assertCartBuyerReference = exports.ProxyCheckoutServerClient = exports.createProxyCheckoutServerClient = exports.parseProxyCart = void 0;
 var cart_js_1 = require("./cart.js");
 Object.defineProperty(exports, "parseProxyCart", { enumerable: true, get: function () { return cart_js_1.parseProxyCart; } });
 var client_js_1 = require("./client.js");
@@ -29,6 +29,9 @@ Object.defineProperty(exports, "requireProxyDate", { enumerable: true, get: func
 Object.defineProperty(exports, "subscriptionAccessEndsAt", { enumerable: true, get: function () { return lifecycle_js_1.subscriptionAccessEndsAt; } });
 Object.defineProperty(exports, "subscriptionWillRenew", { enumerable: true, get: function () { return lifecycle_js_1.subscriptionWillRenew; } });
 Object.defineProperty(exports, "TERMINAL_SESSION_STATUSES", { enumerable: true, get: function () { return lifecycle_js_1.TERMINAL_SESSION_STATUSES; } });
+var live_contract_diagnostics_js_1 = require("./live-contract-diagnostics.js");
+Object.defineProperty(exports, "ProxyLiveContractDiagnosticsResource", { enumerable: true, get: function () { return live_contract_diagnostics_js_1.ProxyLiveContractDiagnosticsResource; } });
+Object.defineProperty(exports, "proxyCheckoutLiveContractDiagnosticEndpoints", { enumerable: true, get: function () { return live_contract_diagnostics_js_1.proxyCheckoutLiveContractDiagnosticEndpoints; } });
 var provider_acquisitions_js_1 = require("./provider-acquisitions.js");
 Object.defineProperty(exports, "ProxyProviderAcquisitionsResource", { enumerable: true, get: function () { return provider_acquisitions_js_1.ProxyProviderAcquisitionsResource; } });
 Object.defineProperty(exports, "proxyCheckoutProviderAcquisitionEndpoints", { enumerable: true, get: function () { return provider_acquisitions_js_1.proxyCheckoutProviderAcquisitionEndpoints; } });

package/dist/cjs/lifecycle.js

@@ -105,5 +105,6 @@ function isSubscriptionEnded(subscription) {
 /** True when the subscription is live but has a payment problem (past_due / unpaid / failed). */
 function isSubscriptionPaymentAtRisk(subscription) {
     return (exports.AT_RISK_SUBSCRIPTION_STATUSES.has(subscription.status) ||
+        subscription.latestPaymentStatus === "action_required" ||
         subscription.latestPaymentStatus === "failed");
 }

package/dist/cjs/live-contract-diagnostics.d.cts

@@ -0,0 +1,192 @@
+import type { ProxyCheckoutHttpClient } from "./http-client.js";
+import type { ProxyCheckoutServerRequestOptions } from "./types.js";
+export type LiveContractDiagnosticEvidenceSourceType = "psp_api_response" | "webhook_event";
+export type LiveContractDiagnosticShadowComparisonDisposition = "expected_divergence" | "legacy_not_applicable" | "match" | "unexpected_divergence";
+export type LiveContractDiagnosticShadowComparisonReasonCode = "legacy_not_applicable" | "match" | "shared_configuration_visibility_added" | "shared_invoice_fee_and_lifecycle_added" | "shared_invoice_fee_added" | "shared_invoice_lifecycle_added" | "shared_invoice_line_evidence_required" | "shared_reconciliation_visibility_added" | "unexpected_divergence";
+export interface RetrieveLiveContractDiagnosticsInput {
+    merchantPspConfigId: string;
+    runId: string;
+}
+export interface LiveContractDiagnosticDeployment {
+    readonly artifactDigest: string | null;
+    readonly commitSha: string;
+    readonly environment: "local" | "preview" | "production" | "test";
+    readonly previewId: string | null;
+}
+export interface LiveContractDiagnosticBaseline {
+    readonly activeLifecycleRecoveryWork: number;
+    readonly earnedFeeRows: number;
+    readonly nonNoneFeeDiagnosticRows: number;
+    readonly openAcquisitions: number;
+    readonly undeliveredOutboxEvents: number;
+    readonly unresolvedReconciliationIssues: number;
+}
+export interface LiveContractDiagnosticAcquisition {
+    readonly attemptNumber: number;
+    readonly commercialMode: string;
+    readonly completionRecorded: boolean;
+    readonly customerPresent: boolean;
+    readonly directSubscriptionSource: string | null;
+    readonly id: string;
+    readonly integrationPath: string;
+    readonly pricingMode: string;
+    readonly providerCartConfirmed: boolean;
+    readonly rootObjectPresent: boolean;
+    readonly setupIntentEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly setupIntentPresent: boolean;
+    readonly status: string;
+    readonly statusReason: string | null;
+}
+export interface LiveContractDiagnosticSubscription {
+    readonly configurationReason: string | null;
+    readonly configurationStatus: string;
+    readonly id: string;
+    readonly latestPaymentEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly latestPaymentStatus: string | null;
+    readonly latestProxyInvoiceId: string | null;
+    readonly lifecycleEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticInvoice {
+    readonly amountDueMinor: number;
+    readonly amountPaidMinor: number;
+    readonly amountRemainingMinor: number;
+    readonly currency: string | null;
+    readonly disputeObservationCount: number;
+    readonly earnedFeeCount: number;
+    readonly id: string;
+    readonly linkedPaymentIntentFeeCount: number;
+    readonly paymentAttemptCount: number;
+    readonly providerPaymentIntentPresent: boolean;
+    readonly proxySubscriptionId: string;
+    readonly refundObservationCount: number;
+    readonly status: string;
+    readonly statusEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+}
+export interface LiveContractDiagnosticFee {
+    readonly basisDiagnostic: string;
+    readonly billingCurrency: string;
+    readonly earningObjectType: "invoice" | "payment_intent";
+    readonly expectedFeeAmountDecimal: string;
+    readonly fixedFeeMinor: number;
+    readonly id: string;
+    readonly paymentAttemptId: string;
+    readonly percentageBasisAmountMinor: number;
+    readonly percentageBasisSource: string;
+    readonly percentageBps: number;
+    readonly policyVersion: string;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+}
+export interface LiveContractDiagnosticDelivery {
+    readonly attemptCount: number;
+    readonly id: string;
+    readonly status: string;
+    readonly transport: "https" | "local_relay";
+}
+export interface LiveContractDiagnosticOutbox {
+    readonly attemptCount: number;
+    readonly delivery: LiveContractDiagnosticDelivery | null;
+    readonly id: string;
+    readonly kind: string;
+    readonly maxAttempts: number;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticDomainEvent {
+    readonly id: string;
+    readonly outbox: readonly LiveContractDiagnosticOutbox[];
+    readonly paymentAttemptId: string | null;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySessionId: string | null;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly type: string;
+    readonly visibility: string;
+}
+export interface LiveContractDiagnosticReconciliationIssue {
+    readonly id: string;
+    readonly issueType: string;
+    readonly paymentAttemptId: string | null;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySessionId: string | null;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticRecovery {
+    readonly attemptCount: number;
+    readonly capabilityIds: readonly string[];
+    readonly evidenceHash: string | null;
+    readonly evidencePresent: boolean;
+    readonly id: string;
+    readonly maxAttempts: number;
+    readonly providerAcquisitionAttemptId: string;
+    readonly proxySessionId: string;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly resultDisposition: "action_required" | "no_change" | "resolved" | "retry" | null;
+    readonly resultReason: "completion_contender" | "incomplete_invoice_line_evidence" | "incomplete_invoice_structure" | "incomplete_subscription_configuration" | "invalid_or_unsupported_provider_evidence" | "known_object_not_found" | "stripe_credentials_unavailable" | "subscription_invoice_payment_evidence_conflict" | "unsupported_invoice_payment_evidence" | "unsupported_subscription_configuration" | "unclassified" | null;
+    readonly status: string;
+    readonly targetType: string;
+}
+export interface LiveContractDiagnosticShadowComparison {
+    readonly comparisonHash: string;
+    readonly disposition: LiveContractDiagnosticShadowComparisonDisposition;
+    readonly observationCount: number;
+    readonly reasonCode: LiveContractDiagnosticShadowComparisonReasonCode;
+}
+export interface LiveContractDiagnosticFinalCart {
+    readonly amountMinor: number;
+    readonly cartVersion: number;
+    readonly currency: string;
+    readonly finalizedAt: string;
+    readonly lineCount: number;
+    readonly pricingMode: string;
+    readonly snapshotHash: string;
+}
+export interface LiveContractDiagnosticSession {
+    readonly acquisitions: readonly LiveContractDiagnosticAcquisition[];
+    readonly completedAcquisitionAttemptId: string | null;
+    readonly completionWinnerCount: number;
+    readonly domainEvents: readonly LiveContractDiagnosticDomainEvent[];
+    readonly fees: readonly LiveContractDiagnosticFee[];
+    readonly finalCart: LiveContractDiagnosticFinalCart | null;
+    readonly id: string;
+    readonly invoices: readonly LiveContractDiagnosticInvoice[];
+    readonly reconciliationIssues: readonly LiveContractDiagnosticReconciliationIssue[];
+    readonly recovery: readonly LiveContractDiagnosticRecovery[];
+    readonly shadowComparisons: readonly LiveContractDiagnosticShadowComparison[];
+    readonly status: string;
+    readonly subscriptions: readonly LiveContractDiagnosticSubscription[];
+}
+export interface StripeLiveContractDiagnostic {
+    readonly baseline: LiveContractDiagnosticBaseline;
+    readonly config: {
+        readonly accountRefHash: string | null;
+        readonly id: string;
+        readonly ingress: {
+            readonly apiVersion: string | null;
+            readonly verificationStatus: string;
+        } | null;
+        readonly lifecycleStatus: string;
+        readonly merchantMode: "test";
+        readonly unattributedOpenAcquisitionSignal: boolean;
+    };
+    readonly deployment: LiveContractDiagnosticDeployment;
+    readonly run: {
+        readonly id: string;
+        readonly sessionCount: number;
+        readonly sessions: readonly LiveContractDiagnosticSession[];
+    };
+    readonly version: 1;
+}
+export declare const proxyCheckoutLiveContractDiagnosticEndpoints: readonly [{
+    readonly method: "GET";
+    readonly operation: "liveContractDiagnostics.retrieve";
+    readonly path: "/stripe_live_contract_diagnostics";
+}];
+export declare class ProxyLiveContractDiagnosticsResource {
+    private readonly httpClient;
+    constructor(httpClient: ProxyCheckoutHttpClient);
+    retrieve(input: RetrieveLiveContractDiagnosticsInput, options?: ProxyCheckoutServerRequestOptions): Promise<StripeLiveContractDiagnostic>;
+}

package/dist/cjs/live-contract-diagnostics.d.ts

@@ -0,0 +1,192 @@
+import type { ProxyCheckoutHttpClient } from "./http-client.js";
+import type { ProxyCheckoutServerRequestOptions } from "./types.js";
+export type LiveContractDiagnosticEvidenceSourceType = "psp_api_response" | "webhook_event";
+export type LiveContractDiagnosticShadowComparisonDisposition = "expected_divergence" | "legacy_not_applicable" | "match" | "unexpected_divergence";
+export type LiveContractDiagnosticShadowComparisonReasonCode = "legacy_not_applicable" | "match" | "shared_configuration_visibility_added" | "shared_invoice_fee_and_lifecycle_added" | "shared_invoice_fee_added" | "shared_invoice_lifecycle_added" | "shared_invoice_line_evidence_required" | "shared_reconciliation_visibility_added" | "unexpected_divergence";
+export interface RetrieveLiveContractDiagnosticsInput {
+    merchantPspConfigId: string;
+    runId: string;
+}
+export interface LiveContractDiagnosticDeployment {
+    readonly artifactDigest: string | null;
+    readonly commitSha: string;
+    readonly environment: "local" | "preview" | "production" | "test";
+    readonly previewId: string | null;
+}
+export interface LiveContractDiagnosticBaseline {
+    readonly activeLifecycleRecoveryWork: number;
+    readonly earnedFeeRows: number;
+    readonly nonNoneFeeDiagnosticRows: number;
+    readonly openAcquisitions: number;
+    readonly undeliveredOutboxEvents: number;
+    readonly unresolvedReconciliationIssues: number;
+}
+export interface LiveContractDiagnosticAcquisition {
+    readonly attemptNumber: number;
+    readonly commercialMode: string;
+    readonly completionRecorded: boolean;
+    readonly customerPresent: boolean;
+    readonly directSubscriptionSource: string | null;
+    readonly id: string;
+    readonly integrationPath: string;
+    readonly pricingMode: string;
+    readonly providerCartConfirmed: boolean;
+    readonly rootObjectPresent: boolean;
+    readonly setupIntentEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly setupIntentPresent: boolean;
+    readonly status: string;
+    readonly statusReason: string | null;
+}
+export interface LiveContractDiagnosticSubscription {
+    readonly configurationReason: string | null;
+    readonly configurationStatus: string;
+    readonly id: string;
+    readonly latestPaymentEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly latestPaymentStatus: string | null;
+    readonly latestProxyInvoiceId: string | null;
+    readonly lifecycleEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticInvoice {
+    readonly amountDueMinor: number;
+    readonly amountPaidMinor: number;
+    readonly amountRemainingMinor: number;
+    readonly currency: string | null;
+    readonly disputeObservationCount: number;
+    readonly earnedFeeCount: number;
+    readonly id: string;
+    readonly linkedPaymentIntentFeeCount: number;
+    readonly paymentAttemptCount: number;
+    readonly providerPaymentIntentPresent: boolean;
+    readonly proxySubscriptionId: string;
+    readonly refundObservationCount: number;
+    readonly status: string;
+    readonly statusEvidenceSourceType: LiveContractDiagnosticEvidenceSourceType | null;
+}
+export interface LiveContractDiagnosticFee {
+    readonly basisDiagnostic: string;
+    readonly billingCurrency: string;
+    readonly earningObjectType: "invoice" | "payment_intent";
+    readonly expectedFeeAmountDecimal: string;
+    readonly fixedFeeMinor: number;
+    readonly id: string;
+    readonly paymentAttemptId: string;
+    readonly percentageBasisAmountMinor: number;
+    readonly percentageBasisSource: string;
+    readonly percentageBps: number;
+    readonly policyVersion: string;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+}
+export interface LiveContractDiagnosticDelivery {
+    readonly attemptCount: number;
+    readonly id: string;
+    readonly status: string;
+    readonly transport: "https" | "local_relay";
+}
+export interface LiveContractDiagnosticOutbox {
+    readonly attemptCount: number;
+    readonly delivery: LiveContractDiagnosticDelivery | null;
+    readonly id: string;
+    readonly kind: string;
+    readonly maxAttempts: number;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticDomainEvent {
+    readonly id: string;
+    readonly outbox: readonly LiveContractDiagnosticOutbox[];
+    readonly paymentAttemptId: string | null;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySessionId: string | null;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly type: string;
+    readonly visibility: string;
+}
+export interface LiveContractDiagnosticReconciliationIssue {
+    readonly id: string;
+    readonly issueType: string;
+    readonly paymentAttemptId: string | null;
+    readonly providerAcquisitionAttemptId: string | null;
+    readonly proxySessionId: string | null;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly status: string;
+}
+export interface LiveContractDiagnosticRecovery {
+    readonly attemptCount: number;
+    readonly capabilityIds: readonly string[];
+    readonly evidenceHash: string | null;
+    readonly evidencePresent: boolean;
+    readonly id: string;
+    readonly maxAttempts: number;
+    readonly providerAcquisitionAttemptId: string;
+    readonly proxySessionId: string;
+    readonly proxySubscriptionId: string | null;
+    readonly proxySubscriptionInvoiceId: string | null;
+    readonly resultDisposition: "action_required" | "no_change" | "resolved" | "retry" | null;
+    readonly resultReason: "completion_contender" | "incomplete_invoice_line_evidence" | "incomplete_invoice_structure" | "incomplete_subscription_configuration" | "invalid_or_unsupported_provider_evidence" | "known_object_not_found" | "stripe_credentials_unavailable" | "subscription_invoice_payment_evidence_conflict" | "unsupported_invoice_payment_evidence" | "unsupported_subscription_configuration" | "unclassified" | null;
+    readonly status: string;
+    readonly targetType: string;
+}
+export interface LiveContractDiagnosticShadowComparison {
+    readonly comparisonHash: string;
+    readonly disposition: LiveContractDiagnosticShadowComparisonDisposition;
+    readonly observationCount: number;
+    readonly reasonCode: LiveContractDiagnosticShadowComparisonReasonCode;
+}
+export interface LiveContractDiagnosticFinalCart {
+    readonly amountMinor: number;
+    readonly cartVersion: number;
+    readonly currency: string;
+    readonly finalizedAt: string;
+    readonly lineCount: number;
+    readonly pricingMode: string;
+    readonly snapshotHash: string;
+}
+export interface LiveContractDiagnosticSession {
+    readonly acquisitions: readonly LiveContractDiagnosticAcquisition[];
+    readonly completedAcquisitionAttemptId: string | null;
+    readonly completionWinnerCount: number;
+    readonly domainEvents: readonly LiveContractDiagnosticDomainEvent[];
+    readonly fees: readonly LiveContractDiagnosticFee[];
+    readonly finalCart: LiveContractDiagnosticFinalCart | null;
+    readonly id: string;
+    readonly invoices: readonly LiveContractDiagnosticInvoice[];
+    readonly reconciliationIssues: readonly LiveContractDiagnosticReconciliationIssue[];
+    readonly recovery: readonly LiveContractDiagnosticRecovery[];
+    readonly shadowComparisons: readonly LiveContractDiagnosticShadowComparison[];
+    readonly status: string;
+    readonly subscriptions: readonly LiveContractDiagnosticSubscription[];
+}
+export interface StripeLiveContractDiagnostic {
+    readonly baseline: LiveContractDiagnosticBaseline;
+    readonly config: {
+        readonly accountRefHash: string | null;
+        readonly id: string;
+        readonly ingress: {
+            readonly apiVersion: string | null;
+            readonly verificationStatus: string;
+        } | null;
+        readonly lifecycleStatus: string;
+        readonly merchantMode: "test";
+        readonly unattributedOpenAcquisitionSignal: boolean;
+    };
+    readonly deployment: LiveContractDiagnosticDeployment;
+    readonly run: {
+        readonly id: string;
+        readonly sessionCount: number;
+        readonly sessions: readonly LiveContractDiagnosticSession[];
+    };
+    readonly version: 1;
+}
+export declare const proxyCheckoutLiveContractDiagnosticEndpoints: readonly [{
+    readonly method: "GET";
+    readonly operation: "liveContractDiagnostics.retrieve";
+    readonly path: "/stripe_live_contract_diagnostics";
+}];
+export declare class ProxyLiveContractDiagnosticsResource {
+    private readonly httpClient;
+    constructor(httpClient: ProxyCheckoutHttpClient);
+    retrieve(input: RetrieveLiveContractDiagnosticsInput, options?: ProxyCheckoutServerRequestOptions): Promise<StripeLiveContractDiagnostic>;
+}