@proxy-checkout/server-js 0.0.8-prx-124.136.1 → 0.1.0-prx-124.137.1

package/dist/cjs/client.js

@@ -33,7 +33,7 @@ class ProxyCheckoutServerClient {
         });
         this.providerAcquisitions = new provider_acquisitions_js_1.ProxyProviderAcquisitionsResource(httpClient);
         this.subscriptions = new subscriptions_js_1.ProxySubscriptionsResource(httpClient, this.sessions);
-        this.events = new events_js_1.ProxyEventsResource(this.sessions, this.subscriptions);
+        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/events.d.cts

@@ -6,6 +6,7 @@
  * lifecycle decision. It never grants from webhook payload fields, and it
  * classifies subscription events from current state rather than event order.
  */
+import type { ProviderAcquisition, ProxyProviderAcquisitionsResource } from "./provider-acquisitions.js";
 import type { MerchantProxySession, ProxySessionsResource } from "./sessions.js";
 import type { MerchantProxySubscription, ProxySubscriptionsResource } from "./subscriptions.js";
 import type { ProxyCheckoutServerRequestOptions } from "./types.js";
@@ -66,23 +67,30 @@ export interface ResolvedPaymentAttempt extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
+export interface ResolvedAcquisitionProgress extends ResolvedBase {
+    readonly acquisition: ProviderAcquisition;
+    readonly kind: "acquisition_progress";
+    readonly session: MerchantProxySession;
+}
 export interface ResolvedIgnored extends ResolvedBase {
     readonly kind: "ignored";
     readonly reason: string;
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;
     private readonly subscriptions;
-    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource);
+    private readonly providerAcquisitions;
+    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource, providerAcquisitions: ProxyProviderAcquisitionsResource);
     /**
      * Resolve a signed webhook event into a current-state lifecycle decision by
      * re-reading the authoritative session/subscription with the secret key.
      */
     resolveCurrentState(event: ProxyWebhookEvent, options?: ResolveProxyEventOptions): Promise<ResolvedProxyEvent>;
+    private resolveProviderAcquisitionEvent;
     private resolveSessionEvent;
     private resolveSubscriptionEvent;
 }

package/dist/cjs/events.d.ts

@@ -6,6 +6,7 @@
  * lifecycle decision. It never grants from webhook payload fields, and it
  * classifies subscription events from current state rather than event order.
  */
+import type { ProviderAcquisition, ProxyProviderAcquisitionsResource } from "./provider-acquisitions.js";
 import type { MerchantProxySession, ProxySessionsResource } from "./sessions.js";
 import type { MerchantProxySubscription, ProxySubscriptionsResource } from "./subscriptions.js";
 import type { ProxyCheckoutServerRequestOptions } from "./types.js";
@@ -66,23 +67,30 @@ export interface ResolvedPaymentAttempt extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
+export interface ResolvedAcquisitionProgress extends ResolvedBase {
+    readonly acquisition: ProviderAcquisition;
+    readonly kind: "acquisition_progress";
+    readonly session: MerchantProxySession;
+}
 export interface ResolvedIgnored extends ResolvedBase {
     readonly kind: "ignored";
     readonly reason: string;
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;
     private readonly subscriptions;
-    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource);
+    private readonly providerAcquisitions;
+    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource, providerAcquisitions: ProxyProviderAcquisitionsResource);
     /**
      * Resolve a signed webhook event into a current-state lifecycle decision by
      * re-reading the authoritative session/subscription with the secret key.
      */
     resolveCurrentState(event: ProxyWebhookEvent, options?: ResolveProxyEventOptions): Promise<ResolvedProxyEvent>;
+    private resolveProviderAcquisitionEvent;
     private resolveSessionEvent;
     private resolveSubscriptionEvent;
 }

package/dist/cjs/events.js

@@ -15,15 +15,20 @@ const webhook_events_js_1 = require("./webhook-events.js");
 class ProxyEventsResource {
     sessions;
     subscriptions;
-    constructor(sessions, subscriptions) {
+    providerAcquisitions;
+    constructor(sessions, subscriptions, providerAcquisitions) {
         this.sessions = sessions;
         this.subscriptions = subscriptions;
+        this.providerAcquisitions = providerAcquisitions;
     }
     /**
      * Resolve a signed webhook event into a current-state lifecycle decision by
      * re-reading the authoritative session/subscription with the secret key.
      */
     async resolveCurrentState(event, options = {}) {
+        if ((0, webhook_events_js_1.isProxyProviderAcquisitionEvent)(event.type)) {
+            return this.resolveProviderAcquisitionEvent(event, options);
+        }
         if ((0, webhook_events_js_1.isProxySubscriptionEvent)(event.type)) {
             return this.resolveSubscriptionEvent(event, options);
         }
@@ -44,6 +49,28 @@ class ProxyEventsResource {
             subscriptionId: readEventString(event.data.subscription_id),
         });
     }
+    async resolveProviderAcquisitionEvent(event, options) {
+        const sessionId = extractSessionId(event);
+        const acquisitionAttemptId = readEventString(event.data.provider_acquisition_attempt_id);
+        if (sessionId === null || acquisitionAttemptId === null) {
+            return ignored(event, "Provider acquisition event is missing current-state identifiers.", {
+                sessionId,
+                subscriptionId: null,
+            });
+        }
+        const [session, acquisitions] = await Promise.all([
+            this.sessions.retrieve(sessionId, options),
+            this.providerAcquisitions.listProviderAcquisitions(sessionId, options),
+        ]);
+        const acquisition = acquisitions.find((candidate) => candidate.id === acquisitionAttemptId);
+        if (!acquisition) {
+            return ignored(event, `Provider acquisition ${acquisitionAttemptId} is no longer visible for session ${sessionId}.`, { sessionId, subscriptionId: null });
+        }
+        if (acquisition.proxySessionId !== session.id) {
+            throw new Error("Proxy provider acquisition current state disagreed with its session");
+        }
+        return { acquisition, event, kind: "acquisition_progress", session };
+    }
     async resolveSessionEvent(event, options) {
         const sessionId = extractSessionId(event);
         if (sessionId === null) {

package/dist/cjs/index.d.cts

@@ -2,13 +2,13 @@ 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 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 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 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";
 export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
-export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
 export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, type ProxyWebhookClaimResult, type ProxyWebhookHandlerOptions, type ProxyWebhookOutcome, type ProxyWebhookPayloadInput, type ProxyWebhookProcessRecord, type ProxyWebhookProcessResult, type ProxyWebhookProvisioningFailure, type ProxyWebhookProvisioningSuccess, type ProxyWebhookProvisioningSuccessResult, type ProxyWebhookRequestInput, type ProxyWebhookStore, ProxyWebhooksResource, } from "./webhook-handler.js";
 export { type ConstructProxyWebhookEventInput, type CreateWebhookEndpointInput, constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, type ProxyWebhookEvent, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, type RotateWebhookEndpointSecretInput, type UpdateWebhookEndpointInput, type VerifyProxyWebhookSignatureInput, verifyProxyWebhookSignature, type WebhookEndpoint, type WebhookEndpointSecretResult, } from "./webhooks.js";

package/dist/cjs/index.d.ts

@@ -2,13 +2,13 @@ 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 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 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 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";
 export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
-export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
 export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, type ProxyWebhookClaimResult, type ProxyWebhookHandlerOptions, type ProxyWebhookOutcome, type ProxyWebhookPayloadInput, type ProxyWebhookProcessRecord, type ProxyWebhookProcessResult, type ProxyWebhookProvisioningFailure, type ProxyWebhookProvisioningSuccess, type ProxyWebhookProvisioningSuccessResult, type ProxyWebhookRequestInput, type ProxyWebhookStore, ProxyWebhooksResource, } from "./webhook-handler.js";
 export { type ConstructProxyWebhookEventInput, type CreateWebhookEndpointInput, constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, type ProxyWebhookEvent, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, type RotateWebhookEndpointSecretInput, type UpdateWebhookEndpointInput, type VerifyProxyWebhookSignatureInput, verifyProxyWebhookSignature, type WebhookEndpoint, type WebhookEndpointSecretResult, } from "./webhooks.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.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.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");
@@ -45,6 +45,7 @@ Object.defineProperty(exports, "proxyCheckoutServerSdkUserAgent", { enumerable:
 Object.defineProperty(exports, "proxyCheckoutServerSdkVersion", { enumerable: true, get: function () { return version_js_1.proxyCheckoutServerSdkVersion; } });
 var webhook_events_js_1 = require("./webhook-events.js");
 Object.defineProperty(exports, "isProxyPaymentAttemptEvent", { enumerable: true, get: function () { return webhook_events_js_1.isProxyPaymentAttemptEvent; } });
+Object.defineProperty(exports, "isProxyProviderAcquisitionEvent", { enumerable: true, get: function () { return webhook_events_js_1.isProxyProviderAcquisitionEvent; } });
 Object.defineProperty(exports, "isProxySessionEvent", { enumerable: true, get: function () { return webhook_events_js_1.isProxySessionEvent; } });
 Object.defineProperty(exports, "isProxyShopifyEvent", { enumerable: true, get: function () { return webhook_events_js_1.isProxyShopifyEvent; } });
 Object.defineProperty(exports, "isProxySubscriptionEvent", { enumerable: true, get: function () { return webhook_events_js_1.isProxySubscriptionEvent; } });

package/dist/cjs/version.d.cts

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

package/dist/cjs/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.0.8-prx-124.136.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.136.1";
+export declare const proxyCheckoutServerSdkVersion = "0.1.0-prx-124.137.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.1.0-prx-124.137.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.0.8-prx-124.136.1";
+exports.proxyCheckoutServerSdkVersion = "0.1.0-prx-124.137.1";
 exports.proxyCheckoutServerSdkUserAgent = `${exports.proxyCheckoutServerSdkName}/${exports.proxyCheckoutServerSdkVersion}`;

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

@@ -7,10 +7,21 @@
  */
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
+    readonly paymentAttemptDisputed: "payment_attempt.disputed";
+    readonly paymentAttemptDisputeLost: "payment_attempt.dispute_lost";
+    readonly paymentAttemptDisputeWon: "payment_attempt.dispute_won";
     readonly paymentAttemptFailed: "payment_attempt.failed";
     readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptReconciliationRequired: "payment_attempt.reconciliation_required";
     readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
+    readonly providerAcquisitionCancelled: "provider_acquisition.cancelled";
+    readonly providerAcquisitionExpired: "provider_acquisition.expired";
+    readonly providerAcquisitionFailed: "provider_acquisition.failed";
+    readonly providerAcquisitionPrepared: "provider_acquisition.prepared";
+    readonly providerAcquisitionProcessing: "provider_acquisition.processing";
+    readonly providerAcquisitionReconciliationRequired: "provider_acquisition.reconciliation_required";
+    readonly providerAcquisitionRequiresAction: "provider_acquisition.requires_action";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
     readonly sessionFailed: "proxy_session.failed";
@@ -23,8 +34,11 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     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. */
@@ -33,5 +47,7 @@ export declare function isProxySessionEvent(eventType: string): boolean;
 export declare function isProxySubscriptionEvent(eventType: string): boolean;
 /** True for `payment_attempt.*` events. */
 export declare function isProxyPaymentAttemptEvent(eventType: string): boolean;
+/** True for non-granting `provider_acquisition.*` progress wakeups. */
+export declare function isProxyProviderAcquisitionEvent(eventType: string): boolean;
 /** True for observation-only `shopify.*` commerce events. */
 export declare function isProxyShopifyEvent(eventType: string): boolean;

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

@@ -7,10 +7,21 @@
  */
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
+    readonly paymentAttemptDisputed: "payment_attempt.disputed";
+    readonly paymentAttemptDisputeLost: "payment_attempt.dispute_lost";
+    readonly paymentAttemptDisputeWon: "payment_attempt.dispute_won";
     readonly paymentAttemptFailed: "payment_attempt.failed";
     readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptReconciliationRequired: "payment_attempt.reconciliation_required";
     readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
+    readonly providerAcquisitionCancelled: "provider_acquisition.cancelled";
+    readonly providerAcquisitionExpired: "provider_acquisition.expired";
+    readonly providerAcquisitionFailed: "provider_acquisition.failed";
+    readonly providerAcquisitionPrepared: "provider_acquisition.prepared";
+    readonly providerAcquisitionProcessing: "provider_acquisition.processing";
+    readonly providerAcquisitionReconciliationRequired: "provider_acquisition.reconciliation_required";
+    readonly providerAcquisitionRequiresAction: "provider_acquisition.requires_action";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
     readonly sessionFailed: "proxy_session.failed";
@@ -23,8 +34,11 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     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. */
@@ -33,5 +47,7 @@ export declare function isProxySessionEvent(eventType: string): boolean;
 export declare function isProxySubscriptionEvent(eventType: string): boolean;
 /** True for `payment_attempt.*` events. */
 export declare function isProxyPaymentAttemptEvent(eventType: string): boolean;
+/** True for non-granting `provider_acquisition.*` progress wakeups. */
+export declare function isProxyProviderAcquisitionEvent(eventType: string): boolean;
 /** True for observation-only `shopify.*` commerce events. */
 export declare function isProxyShopifyEvent(eventType: string): boolean;

package/dist/cjs/webhook-events.js

@@ -11,13 +11,25 @@ exports.PROXY_WEBHOOK_EVENT_TYPES = void 0;
 exports.isProxySessionEvent = isProxySessionEvent;
 exports.isProxySubscriptionEvent = isProxySubscriptionEvent;
 exports.isProxyPaymentAttemptEvent = isProxyPaymentAttemptEvent;
+exports.isProxyProviderAcquisitionEvent = isProxyProviderAcquisitionEvent;
 exports.isProxyShopifyEvent = isProxyShopifyEvent;
 exports.PROXY_WEBHOOK_EVENT_TYPES = {
     paymentAttemptCancelled: "payment_attempt.cancelled",
+    paymentAttemptDisputed: "payment_attempt.disputed",
+    paymentAttemptDisputeLost: "payment_attempt.dispute_lost",
+    paymentAttemptDisputeWon: "payment_attempt.dispute_won",
     paymentAttemptFailed: "payment_attempt.failed",
     paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded",
+    paymentAttemptReconciliationRequired: "payment_attempt.reconciliation_required",
     paymentAttemptRefunded: "payment_attempt.refunded",
     paymentAttemptSucceeded: "payment_attempt.succeeded",
+    providerAcquisitionCancelled: "provider_acquisition.cancelled",
+    providerAcquisitionExpired: "provider_acquisition.expired",
+    providerAcquisitionFailed: "provider_acquisition.failed",
+    providerAcquisitionPrepared: "provider_acquisition.prepared",
+    providerAcquisitionProcessing: "provider_acquisition.processing",
+    providerAcquisitionReconciliationRequired: "provider_acquisition.reconciliation_required",
+    providerAcquisitionRequiresAction: "provider_acquisition.requires_action",
     sessionCancelled: "proxy_session.cancelled",
     sessionExpired: "proxy_session.expired",
     sessionFailed: "proxy_session.failed",
@@ -30,8 +42,11 @@ exports.PROXY_WEBHOOK_EVENT_TYPES = {
     shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed",
     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,
@@ -44,16 +59,32 @@ const SESSION_EVENT_TYPES = new Set([
 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,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputeLost,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputeWon,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputed,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptFailed,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptPartiallyRefunded,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptReconciliationRequired,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptRefunded,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptSucceeded,
 ]);
+const PROVIDER_ACQUISITION_EVENT_TYPES = new Set([
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionCancelled,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionExpired,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionFailed,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionPrepared,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionProcessing,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionReconciliationRequired,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionRequiresAction,
+]);
 const SHOPIFY_EVENT_TYPES = new Set([
     exports.PROXY_WEBHOOK_EVENT_TYPES.shopifyFulfillmentObserved,
     exports.PROXY_WEBHOOK_EVENT_TYPES.shopifyRefundObserved,
@@ -72,6 +103,10 @@ function isProxySubscriptionEvent(eventType) {
 function isProxyPaymentAttemptEvent(eventType) {
     return PAYMENT_ATTEMPT_EVENT_TYPES.has(eventType);
 }
+/** True for non-granting `provider_acquisition.*` progress wakeups. */
+function isProxyProviderAcquisitionEvent(eventType) {
+    return PROVIDER_ACQUISITION_EVENT_TYPES.has(eventType);
+}
 /** True for observation-only `shopify.*` commerce events. */
 function isProxyShopifyEvent(eventType) {
     return SHOPIFY_EVENT_TYPES.has(eventType);

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

@@ -17,6 +17,7 @@ export type ProxyWebhookClaimResult = "claimed" | "duplicate" | "processing";
 export type ProxyWebhookOutcome = "duplicate" | "ignored" | "processed" | "processing";
 /** Compact, lifecycle-free audit record handed to a {@link ProxyWebhookStore}. */
 export interface ProxyWebhookProcessRecord {
+    readonly acquisitionAttemptId?: string | null;
     readonly kind: ResolvedProxyEventKind;
     readonly paymentAttemptId?: string | null;
     readonly sessionId: string | null;

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

@@ -17,6 +17,7 @@ export type ProxyWebhookClaimResult = "claimed" | "duplicate" | "processing";
 export type ProxyWebhookOutcome = "duplicate" | "ignored" | "processed" | "processing";
 /** Compact, lifecycle-free audit record handed to a {@link ProxyWebhookStore}. */
 export interface ProxyWebhookProcessRecord {
+    readonly acquisitionAttemptId?: string | null;
     readonly kind: ResolvedProxyEventKind;
     readonly paymentAttemptId?: string | null;
     readonly sessionId: string | null;

package/dist/cjs/webhook-handler.js

@@ -198,6 +198,13 @@ function jsonResponse(status, body) {
 }
 function toProcessRecord(resolved) {
     switch (resolved.kind) {
+        case "acquisition_progress":
+            return {
+                acquisitionAttemptId: resolved.acquisition.id,
+                kind: resolved.kind,
+                sessionId: resolved.session.id,
+                subscriptionId: null,
+            };
         case "ignored":
             return {
                 kind: resolved.kind,

package/dist/esm/client.js

@@ -29,7 +29,7 @@ export class ProxyCheckoutServerClient {
         });
         this.providerAcquisitions = new ProxyProviderAcquisitionsResource(httpClient);
         this.subscriptions = new ProxySubscriptionsResource(httpClient, this.sessions);
-        this.events = new ProxyEventsResource(this.sessions, this.subscriptions);
+        this.events = new ProxyEventsResource(this.sessions, this.subscriptions, this.providerAcquisitions);
         this.webhooks = new ProxyWebhooksResource(this.events, this.sessions);
         this.webhookEndpoints = new ProxyWebhookEndpointsResource(httpClient);
     }

package/dist/esm/events.d.ts

@@ -6,6 +6,7 @@
  * lifecycle decision. It never grants from webhook payload fields, and it
  * classifies subscription events from current state rather than event order.
  */
+import type { ProviderAcquisition, ProxyProviderAcquisitionsResource } from "./provider-acquisitions.js";
 import type { MerchantProxySession, ProxySessionsResource } from "./sessions.js";
 import type { MerchantProxySubscription, ProxySubscriptionsResource } from "./subscriptions.js";
 import type { ProxyCheckoutServerRequestOptions } from "./types.js";
@@ -66,23 +67,30 @@ export interface ResolvedPaymentAttempt extends ResolvedBase {
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
+export interface ResolvedAcquisitionProgress extends ResolvedBase {
+    readonly acquisition: ProviderAcquisition;
+    readonly kind: "acquisition_progress";
+    readonly session: MerchantProxySession;
+}
 export interface ResolvedIgnored extends ResolvedBase {
     readonly kind: "ignored";
     readonly reason: string;
     readonly sessionId: string | null;
     readonly subscriptionId: string | null;
 }
-export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedIgnored;
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedAcquisitionProgress | ResolvedIgnored;
 export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
 export declare class ProxyEventsResource {
     private readonly sessions;
     private readonly subscriptions;
-    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource);
+    private readonly providerAcquisitions;
+    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource, providerAcquisitions: ProxyProviderAcquisitionsResource);
     /**
      * Resolve a signed webhook event into a current-state lifecycle decision by
      * re-reading the authoritative session/subscription with the secret key.
      */
     resolveCurrentState(event: ProxyWebhookEvent, options?: ResolveProxyEventOptions): Promise<ResolvedProxyEvent>;
+    private resolveProviderAcquisitionEvent;
     private resolveSessionEvent;
     private resolveSubscriptionEvent;
 }

package/dist/esm/events.js

@@ -8,19 +8,24 @@
  */
 import { assertSubscriptionMatchesSession } from "./consistency.js";
 import { isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, subscriptionAccessEndsAt, subscriptionWillRenew, } from "./lifecycle.js";
-import { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxySubscriptionEvent, } from "./webhook-events.js";
+import { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxySubscriptionEvent, } from "./webhook-events.js";
 export class ProxyEventsResource {
     sessions;
     subscriptions;
-    constructor(sessions, subscriptions) {
+    providerAcquisitions;
+    constructor(sessions, subscriptions, providerAcquisitions) {
         this.sessions = sessions;
         this.subscriptions = subscriptions;
+        this.providerAcquisitions = providerAcquisitions;
     }
     /**
      * Resolve a signed webhook event into a current-state lifecycle decision by
      * re-reading the authoritative session/subscription with the secret key.
      */
     async resolveCurrentState(event, options = {}) {
+        if (isProxyProviderAcquisitionEvent(event.type)) {
+            return this.resolveProviderAcquisitionEvent(event, options);
+        }
         if (isProxySubscriptionEvent(event.type)) {
             return this.resolveSubscriptionEvent(event, options);
         }
@@ -41,6 +46,28 @@ export class ProxyEventsResource {
             subscriptionId: readEventString(event.data.subscription_id),
         });
     }
+    async resolveProviderAcquisitionEvent(event, options) {
+        const sessionId = extractSessionId(event);
+        const acquisitionAttemptId = readEventString(event.data.provider_acquisition_attempt_id);
+        if (sessionId === null || acquisitionAttemptId === null) {
+            return ignored(event, "Provider acquisition event is missing current-state identifiers.", {
+                sessionId,
+                subscriptionId: null,
+            });
+        }
+        const [session, acquisitions] = await Promise.all([
+            this.sessions.retrieve(sessionId, options),
+            this.providerAcquisitions.listProviderAcquisitions(sessionId, options),
+        ]);
+        const acquisition = acquisitions.find((candidate) => candidate.id === acquisitionAttemptId);
+        if (!acquisition) {
+            return ignored(event, `Provider acquisition ${acquisitionAttemptId} is no longer visible for session ${sessionId}.`, { sessionId, subscriptionId: null });
+        }
+        if (acquisition.proxySessionId !== session.id) {
+            throw new Error("Proxy provider acquisition current state disagreed with its session");
+        }
+        return { acquisition, event, kind: "acquisition_progress", session };
+    }
     async resolveSessionEvent(event, options) {
         const sessionId = extractSessionId(event);
         if (sessionId === null) {

package/dist/esm/index.d.ts

@@ -2,13 +2,13 @@ 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 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 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 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";
 export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
-export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
 export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, type ProxyWebhookClaimResult, type ProxyWebhookHandlerOptions, type ProxyWebhookOutcome, type ProxyWebhookPayloadInput, type ProxyWebhookProcessRecord, type ProxyWebhookProcessResult, type ProxyWebhookProvisioningFailure, type ProxyWebhookProvisioningSuccess, type ProxyWebhookProvisioningSuccessResult, type ProxyWebhookRequestInput, type ProxyWebhookStore, ProxyWebhooksResource, } from "./webhook-handler.js";
 export { type ConstructProxyWebhookEventInput, type CreateWebhookEndpointInput, constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, type ProxyWebhookEvent, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, type RotateWebhookEndpointSecretInput, type UpdateWebhookEndpointInput, type VerifyProxyWebhookSignatureInput, verifyProxyWebhookSignature, type WebhookEndpoint, type WebhookEndpointSecretResult, } from "./webhooks.js";

package/dist/esm/index.js

@@ -8,6 +8,6 @@ export { ProxyProviderAcquisitionsResource, proxyCheckoutProviderAcquisitionEndp
 export { ProxySessionCartResource, ProxySessionsResource, proxyCheckoutServerEndpoints, } from "./sessions.js";
 export { ProxySubscriptionsResource, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
 export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
-export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, isProxyProviderAcquisitionEvent, isProxySessionEvent, isProxyShopifyEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, } from "./webhook-events.js";
 export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, ProxyWebhooksResource, } from "./webhook-handler.js";
 export { constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, verifyProxyWebhookSignature, } from "./webhooks.js";

package/dist/esm/version.d.ts

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

package/dist/esm/version.js

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

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

@@ -7,10 +7,21 @@
  */
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
+    readonly paymentAttemptDisputed: "payment_attempt.disputed";
+    readonly paymentAttemptDisputeLost: "payment_attempt.dispute_lost";
+    readonly paymentAttemptDisputeWon: "payment_attempt.dispute_won";
     readonly paymentAttemptFailed: "payment_attempt.failed";
     readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptReconciliationRequired: "payment_attempt.reconciliation_required";
     readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
+    readonly providerAcquisitionCancelled: "provider_acquisition.cancelled";
+    readonly providerAcquisitionExpired: "provider_acquisition.expired";
+    readonly providerAcquisitionFailed: "provider_acquisition.failed";
+    readonly providerAcquisitionPrepared: "provider_acquisition.prepared";
+    readonly providerAcquisitionProcessing: "provider_acquisition.processing";
+    readonly providerAcquisitionReconciliationRequired: "provider_acquisition.reconciliation_required";
+    readonly providerAcquisitionRequiresAction: "provider_acquisition.requires_action";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
     readonly sessionFailed: "proxy_session.failed";
@@ -23,8 +34,11 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     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. */
@@ -33,5 +47,7 @@ export declare function isProxySessionEvent(eventType: string): boolean;
 export declare function isProxySubscriptionEvent(eventType: string): boolean;
 /** True for `payment_attempt.*` events. */
 export declare function isProxyPaymentAttemptEvent(eventType: string): boolean;
+/** True for non-granting `provider_acquisition.*` progress wakeups. */
+export declare function isProxyProviderAcquisitionEvent(eventType: string): boolean;
 /** True for observation-only `shopify.*` commerce events. */
 export declare function isProxyShopifyEvent(eventType: string): boolean;

package/dist/esm/webhook-events.js

@@ -7,10 +7,21 @@
  */
 export const PROXY_WEBHOOK_EVENT_TYPES = {
     paymentAttemptCancelled: "payment_attempt.cancelled",
+    paymentAttemptDisputed: "payment_attempt.disputed",
+    paymentAttemptDisputeLost: "payment_attempt.dispute_lost",
+    paymentAttemptDisputeWon: "payment_attempt.dispute_won",
     paymentAttemptFailed: "payment_attempt.failed",
     paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded",
+    paymentAttemptReconciliationRequired: "payment_attempt.reconciliation_required",
     paymentAttemptRefunded: "payment_attempt.refunded",
     paymentAttemptSucceeded: "payment_attempt.succeeded",
+    providerAcquisitionCancelled: "provider_acquisition.cancelled",
+    providerAcquisitionExpired: "provider_acquisition.expired",
+    providerAcquisitionFailed: "provider_acquisition.failed",
+    providerAcquisitionPrepared: "provider_acquisition.prepared",
+    providerAcquisitionProcessing: "provider_acquisition.processing",
+    providerAcquisitionReconciliationRequired: "provider_acquisition.reconciliation_required",
+    providerAcquisitionRequiresAction: "provider_acquisition.requires_action",
     sessionCancelled: "proxy_session.cancelled",
     sessionExpired: "proxy_session.expired",
     sessionFailed: "proxy_session.failed",
@@ -23,8 +34,11 @@ export const PROXY_WEBHOOK_EVENT_TYPES = {
     shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed",
     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,
@@ -37,16 +51,32 @@ const SESSION_EVENT_TYPES = new Set([
 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,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputeLost,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputeWon,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptDisputed,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptFailed,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptPartiallyRefunded,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptReconciliationRequired,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptRefunded,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptSucceeded,
 ]);
+const PROVIDER_ACQUISITION_EVENT_TYPES = new Set([
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionCancelled,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionExpired,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionFailed,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionPrepared,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionProcessing,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionReconciliationRequired,
+    PROXY_WEBHOOK_EVENT_TYPES.providerAcquisitionRequiresAction,
+]);
 const SHOPIFY_EVENT_TYPES = new Set([
     PROXY_WEBHOOK_EVENT_TYPES.shopifyFulfillmentObserved,
     PROXY_WEBHOOK_EVENT_TYPES.shopifyRefundObserved,
@@ -65,6 +95,10 @@ export function isProxySubscriptionEvent(eventType) {
 export function isProxyPaymentAttemptEvent(eventType) {
     return PAYMENT_ATTEMPT_EVENT_TYPES.has(eventType);
 }
+/** True for non-granting `provider_acquisition.*` progress wakeups. */
+export function isProxyProviderAcquisitionEvent(eventType) {
+    return PROVIDER_ACQUISITION_EVENT_TYPES.has(eventType);
+}
 /** True for observation-only `shopify.*` commerce events. */
 export function isProxyShopifyEvent(eventType) {
     return SHOPIFY_EVENT_TYPES.has(eventType);

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

@@ -17,6 +17,7 @@ export type ProxyWebhookClaimResult = "claimed" | "duplicate" | "processing";
 export type ProxyWebhookOutcome = "duplicate" | "ignored" | "processed" | "processing";
 /** Compact, lifecycle-free audit record handed to a {@link ProxyWebhookStore}. */
 export interface ProxyWebhookProcessRecord {
+    readonly acquisitionAttemptId?: string | null;
     readonly kind: ResolvedProxyEventKind;
     readonly paymentAttemptId?: string | null;
     readonly sessionId: string | null;

package/dist/esm/webhook-handler.js

@@ -194,6 +194,13 @@ function jsonResponse(status, body) {
 }
 function toProcessRecord(resolved) {
     switch (resolved.kind) {
+        case "acquisition_progress":
+            return {
+                acquisitionAttemptId: resolved.acquisition.id,
+                kind: resolved.kind,
+                sessionId: resolved.session.id,
+                subscriptionId: null,
+            };
         case "ignored":
             return {
                 kind: resolved.kind,

package/package.json

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