@proxy-checkout/server-js 0.0.8-prx-124.133.1 → 0.0.8-prx-124.134.1

package/README.md

@@ -76,6 +76,8 @@ For delegated checkout, prefer the high-level flow:
 
 Use `payerHandoff`, `payerOpened`, raw event construction, or manual provisioning acknowledgements only for custom integrations that cannot use the default helpers.
 
+The legacy `proxy.sessions.recordProviderBinding(...)` compatibility adapter is deprecated. If a custom Stripe integration still calls it directly, pass canonical `psp: "stripe"` plus `commercialMode: "one_time"` for Checkout `mode: "payment"` or `commercialMode: "subscription"` for Checkout `mode: "subscription"`. Current TypeScript callers receive that requirement at compile time; `openCheckout(...)` derives it automatically.
+
 `proxy.webhooks.handle(...)` automatically marks successful initial provisioning as provisioned after `onResolved` completes. Return a fulfillment reference and/or metadata from `onResolved` when you want that acknowledgement to record the merchant-side access row:
 
 ```ts

package/dist/cjs/sessions.d.cts

@@ -100,12 +100,21 @@ export interface ProxySessionCartResult {
     readonly cartVersion: number;
     readonly currency: string;
 }
-export interface RecordProviderBindingInput extends ProxyCheckoutServerRequestOptions {
-    /** Required for Stripe so Proxy can safely infer the deprecated binding into an acquisition. */
-    readonly commercialMode?: "one_time" | "subscription";
+interface RecordProviderBindingBaseInput extends ProxyCheckoutServerRequestOptions {
     readonly providerCheckoutSessionId: string;
-    readonly psp: string;
 }
+/**
+ * Input for the deprecated provider-binding compatibility adapter.
+ * Canonical Stripe literals require `commercialMode` at compile time; dynamic
+ * or untyped inputs remain protected by the matching runtime validation.
+ */
+export type RecordProviderBindingInput<TPsp extends string = string> = RecordProviderBindingBaseInput & {
+    readonly psp: TPsp;
+} & (Lowercase<TPsp> extends "stripe" ? {
+    readonly commercialMode: "one_time" | "subscription";
+} : {
+    readonly commercialMode?: "one_time" | "subscription";
+});
 export interface ProxySessionProviderBinding {
     readonly providerCheckoutSessionId: string;
     readonly proxySessionId: string;
@@ -199,8 +208,11 @@ export declare class ProxySessionsResource {
      * Bind a provider (PSP) checkout object to a Proxy session so later cart sync
      * can verify ownership. Idempotent for the same provider object; conflicts when
      * the session is already bound to a different one.
+     *
+     * @deprecated Prefer provider acquisition attempts or a provider-specific
+     * helper such as `@proxy-checkout/stripe-server-js` `openCheckout(...)`.
      */
-    recordProviderBinding(proxySessionId: string, input: RecordProviderBindingInput): Promise<ProxySessionProviderBinding>;
+    recordProviderBinding<const TPsp extends string>(proxySessionId: string, input: RecordProviderBindingInput<TPsp>): Promise<ProxySessionProviderBinding>;
     markProvisioned(proxySessionId: string, input?: MarkProxySessionProvisionedInput): Promise<ProxySessionProvisioningAcknowledgement>;
     markProvisioningFailed(proxySessionId: string, input: MarkProxySessionProvisioningFailedInput): Promise<ProxySessionProvisioningAcknowledgement>;
 }
@@ -209,3 +221,4 @@ export declare class ProxySessionCartResource {
     constructor(httpClient: ProxyCheckoutHttpClient);
     set(proxySessionId: string, input: SetProxySessionCartInput): Promise<ProxySessionCartResult>;
 }
+export {};

package/dist/cjs/sessions.d.ts

@@ -100,12 +100,21 @@ export interface ProxySessionCartResult {
     readonly cartVersion: number;
     readonly currency: string;
 }
-export interface RecordProviderBindingInput extends ProxyCheckoutServerRequestOptions {
-    /** Required for Stripe so Proxy can safely infer the deprecated binding into an acquisition. */
-    readonly commercialMode?: "one_time" | "subscription";
+interface RecordProviderBindingBaseInput extends ProxyCheckoutServerRequestOptions {
     readonly providerCheckoutSessionId: string;
-    readonly psp: string;
 }
+/**
+ * Input for the deprecated provider-binding compatibility adapter.
+ * Canonical Stripe literals require `commercialMode` at compile time; dynamic
+ * or untyped inputs remain protected by the matching runtime validation.
+ */
+export type RecordProviderBindingInput<TPsp extends string = string> = RecordProviderBindingBaseInput & {
+    readonly psp: TPsp;
+} & (Lowercase<TPsp> extends "stripe" ? {
+    readonly commercialMode: "one_time" | "subscription";
+} : {
+    readonly commercialMode?: "one_time" | "subscription";
+});
 export interface ProxySessionProviderBinding {
     readonly providerCheckoutSessionId: string;
     readonly proxySessionId: string;
@@ -199,8 +208,11 @@ export declare class ProxySessionsResource {
      * Bind a provider (PSP) checkout object to a Proxy session so later cart sync
      * can verify ownership. Idempotent for the same provider object; conflicts when
      * the session is already bound to a different one.
+     *
+     * @deprecated Prefer provider acquisition attempts or a provider-specific
+     * helper such as `@proxy-checkout/stripe-server-js` `openCheckout(...)`.
      */
-    recordProviderBinding(proxySessionId: string, input: RecordProviderBindingInput): Promise<ProxySessionProviderBinding>;
+    recordProviderBinding<const TPsp extends string>(proxySessionId: string, input: RecordProviderBindingInput<TPsp>): Promise<ProxySessionProviderBinding>;
     markProvisioned(proxySessionId: string, input?: MarkProxySessionProvisionedInput): Promise<ProxySessionProvisioningAcknowledgement>;
     markProvisioningFailed(proxySessionId: string, input: MarkProxySessionProvisioningFailedInput): Promise<ProxySessionProvisioningAcknowledgement>;
 }
@@ -209,3 +221,4 @@ export declare class ProxySessionCartResource {
     constructor(httpClient: ProxyCheckoutHttpClient);
     set(proxySessionId: string, input: SetProxySessionCartInput): Promise<ProxySessionCartResult>;
 }
+export {};

package/dist/cjs/sessions.js

@@ -140,6 +140,9 @@ class ProxySessionsResource {
      * Bind a provider (PSP) checkout object to a Proxy session so later cart sync
      * can verify ownership. Idempotent for the same provider object; conflicts when
      * the session is already bound to a different one.
+     *
+     * @deprecated Prefer provider acquisition attempts or a provider-specific
+     * helper such as `@proxy-checkout/stripe-server-js` `openCheckout(...)`.
      */
     async recordProviderBinding(proxySessionId, input) {
         if (input.psp.trim().toLowerCase() === "stripe" && input.commercialMode === undefined) {

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.133.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.133.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.8-prx-124.134.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.134.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.133.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.133.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.8-prx-124.134.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.134.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.133.1";
+exports.proxyCheckoutServerSdkVersion = "0.0.8-prx-124.134.1";
 exports.proxyCheckoutServerSdkUserAgent = `${exports.proxyCheckoutServerSdkName}/${exports.proxyCheckoutServerSdkVersion}`;

package/dist/esm/sessions.d.ts

@@ -100,12 +100,21 @@ export interface ProxySessionCartResult {
     readonly cartVersion: number;
     readonly currency: string;
 }
-export interface RecordProviderBindingInput extends ProxyCheckoutServerRequestOptions {
-    /** Required for Stripe so Proxy can safely infer the deprecated binding into an acquisition. */
-    readonly commercialMode?: "one_time" | "subscription";
+interface RecordProviderBindingBaseInput extends ProxyCheckoutServerRequestOptions {
     readonly providerCheckoutSessionId: string;
-    readonly psp: string;
 }
+/**
+ * Input for the deprecated provider-binding compatibility adapter.
+ * Canonical Stripe literals require `commercialMode` at compile time; dynamic
+ * or untyped inputs remain protected by the matching runtime validation.
+ */
+export type RecordProviderBindingInput<TPsp extends string = string> = RecordProviderBindingBaseInput & {
+    readonly psp: TPsp;
+} & (Lowercase<TPsp> extends "stripe" ? {
+    readonly commercialMode: "one_time" | "subscription";
+} : {
+    readonly commercialMode?: "one_time" | "subscription";
+});
 export interface ProxySessionProviderBinding {
     readonly providerCheckoutSessionId: string;
     readonly proxySessionId: string;
@@ -199,8 +208,11 @@ export declare class ProxySessionsResource {
      * Bind a provider (PSP) checkout object to a Proxy session so later cart sync
      * can verify ownership. Idempotent for the same provider object; conflicts when
      * the session is already bound to a different one.
+     *
+     * @deprecated Prefer provider acquisition attempts or a provider-specific
+     * helper such as `@proxy-checkout/stripe-server-js` `openCheckout(...)`.
      */
-    recordProviderBinding(proxySessionId: string, input: RecordProviderBindingInput): Promise<ProxySessionProviderBinding>;
+    recordProviderBinding<const TPsp extends string>(proxySessionId: string, input: RecordProviderBindingInput<TPsp>): Promise<ProxySessionProviderBinding>;
     markProvisioned(proxySessionId: string, input?: MarkProxySessionProvisionedInput): Promise<ProxySessionProvisioningAcknowledgement>;
     markProvisioningFailed(proxySessionId: string, input: MarkProxySessionProvisioningFailedInput): Promise<ProxySessionProvisioningAcknowledgement>;
 }
@@ -209,3 +221,4 @@ export declare class ProxySessionCartResource {
     constructor(httpClient: ProxyCheckoutHttpClient);
     set(proxySessionId: string, input: SetProxySessionCartInput): Promise<ProxySessionCartResult>;
 }
+export {};

package/dist/esm/sessions.js

@@ -137,6 +137,9 @@ export class ProxySessionsResource {
      * Bind a provider (PSP) checkout object to a Proxy session so later cart sync
      * can verify ownership. Idempotent for the same provider object; conflicts when
      * the session is already bound to a different one.
+     *
+     * @deprecated Prefer provider acquisition attempts or a provider-specific
+     * helper such as `@proxy-checkout/stripe-server-js` `openCheckout(...)`.
      */
     async recordProviderBinding(proxySessionId, input) {
         if (input.psp.trim().toLowerCase() === "stripe" && input.commercialMode === undefined) {

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.133.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.133.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.8-prx-124.134.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-124.134.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.133.1";
+export const proxyCheckoutServerSdkVersion = "0.0.8-prx-124.134.1";
 export const proxyCheckoutServerSdkUserAgent = `${proxyCheckoutServerSdkName}/${proxyCheckoutServerSdkVersion}`;

package/package.json

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