@proxy-checkout/server-js 0.0.4-pr-76.17.1 → 0.0.4-pr-76.18.1

package/dist/lifecycle.d.ts

@@ -10,7 +10,13 @@ import type { MerchantProxySession } from "./sessions.js";
 import type { MerchantProxySubscription } from "./subscriptions.js";
 /** Session statuses that mean the payer has paid and entitlement may be granted. */
 export declare const PROVISIONABLE_SESSION_STATUSES: Set<string>;
-/** Session statuses that are terminal — no further lifecycle transitions occur. */
+/**
+ * Session statuses that are terminal from the SDK's lifecycle perspective — the
+ * automatic flow has stopped and the merchant must observe the outcome. This
+ * includes `merchant_action_required`, which halts the session pending merchant
+ * intervention; classifying it here keeps a `proxy_session.merchant_action_required`
+ * event from silently resolving to `ignored` and being marked processed.
+ */
 export declare const TERMINAL_SESSION_STATUSES: Set<string>;
 /** Subscription statuses that mean the subscription is no longer active. */
 export declare const ENDED_SUBSCRIPTION_STATUSES: Set<string>;

package/dist/lifecycle.js

@@ -9,11 +9,18 @@
 import { ProxyCheckoutValidationError } from "./errors.js";
 /** Session statuses that mean the payer has paid and entitlement may be granted. */
 export const PROVISIONABLE_SESSION_STATUSES = new Set(["paid", "provisionable"]);
-/** Session statuses that are terminal — no further lifecycle transitions occur. */
+/**
+ * Session statuses that are terminal from the SDK's lifecycle perspective — the
+ * automatic flow has stopped and the merchant must observe the outcome. This
+ * includes `merchant_action_required`, which halts the session pending merchant
+ * intervention; classifying it here keeps a `proxy_session.merchant_action_required`
+ * event from silently resolving to `ignored` and being marked processed.
+ */
 export const TERMINAL_SESSION_STATUSES = new Set([
     "cancelled",
     "expired",
     "failed",
+    "merchant_action_required",
     "provisioned",
     "provisioning_failed",
 ]);

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.17.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-pr-76.17.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.18.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-pr-76.18.1";

package/dist/version.js

@@ -1,3 +1,3 @@
 export const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.17.1";
+export const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.18.1";
 export const proxyCheckoutServerSdkUserAgent = `${proxyCheckoutServerSdkName}/${proxyCheckoutServerSdkVersion}`;

package/dist/webhook-handler.js

@@ -72,7 +72,21 @@ export class ProxyWebhooksResource {
             throw error;
         }
         if (store !== undefined) {
-            await store.markProcessed(event.id, toProcessRecord(resolved));
+            try {
+                await store.markProcessed(event.id, toProcessRecord(resolved));
+            }
+            catch (error) {
+                // The fulfillment ran, but committing idempotency failed. Best-effort
+                // release the claim so the event is reclaimable on a later delivery
+                // instead of being stuck in the in-flight branch forever.
+                try {
+                    await store.markFailed(event.id, error);
+                }
+                catch {
+                    // Never let a store failure shadow the original markProcessed error.
+                }
+                throw error;
+            }
         }
         return {
             event,

package/package.json

@@ -7,7 +7,7 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.4-pr-76.17.1",
+  "version": "0.0.4-pr-76.18.1",
   "devDependencies": {
     "@types/node": "^24.12.4",
     "@vitest/coverage-v8": "4.1.7",