@proxy-checkout/server-js 0.0.8-prx-109.82.1 → 0.0.8-prx-120.90.1

package/README.md

@@ -114,6 +114,10 @@ if (event.type === "subscription.renewed") {
 }
 ```
 
+`PROXY_WEBHOOK_EVENT_TYPES` and the `isProxy*Event` predicates also cover initial payment refunds
+and observation-only Shopify reconciliation/renewal/refund/fulfillment events. Shopify observation events do not
+initiate a commerce mutation or imply provisioning; inspect their verified `event.data` payload.
+
 Production calls default to `https://api.proxycheckout.com`. Tests, local
 development, and previews can pass `apiHost`.
 

package/dist/cjs/index.d.cts

@@ -8,6 +8,6 @@ export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type
 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, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, 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

@@ -8,6 +8,6 @@ export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type
 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, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, 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.isProxySessionEvent = exports.isProxyPaymentAttemptEvent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkName = exports.proxyCheckoutSubscriptionEndpoints = exports.ProxySubscriptionsResource = exports.proxyCheckoutServerEndpoints = exports.ProxySessionsResource = exports.ProxySessionCartResource = 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.isProxyPaymentAttemptEvent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkName = exports.proxyCheckoutSubscriptionEndpoints = exports.ProxySubscriptionsResource = exports.proxyCheckoutServerEndpoints = exports.ProxySessionsResource = exports.ProxySessionCartResource = 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");
@@ -43,6 +43,7 @@ Object.defineProperty(exports, "proxyCheckoutServerSdkVersion", { enumerable: tr
 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, "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; } });
 Object.defineProperty(exports, "PROXY_WEBHOOK_EVENT_TYPES", { enumerable: true, get: function () { return webhook_events_js_1.PROXY_WEBHOOK_EVENT_TYPES; } });
 var webhook_handler_js_1 = require("./webhook-handler.js");

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

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

@@ -8,6 +8,8 @@
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
     readonly paymentAttemptFailed: "payment_attempt.failed";
+    readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
@@ -15,6 +17,10 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly sessionMerchantActionRequired: "proxy_session.merchant_action_required";
     readonly sessionPaid: "proxy_session.paid";
     readonly sessionProvisionable: "proxy_session.provisionable";
+    readonly shopifyFulfillmentObserved: "shopify.fulfillment_observed";
+    readonly shopifyRefundObserved: "shopify.refund_observed";
+    readonly shopifySubscriptionPaymentObserved: "shopify.subscription_payment_observed";
+    readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
@@ -27,3 +33,5 @@ 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 observation-only `shopify.*` commerce events. */
+export declare function isProxyShopifyEvent(eventType: string): boolean;

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

@@ -8,6 +8,8 @@
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
     readonly paymentAttemptFailed: "payment_attempt.failed";
+    readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
@@ -15,6 +17,10 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly sessionMerchantActionRequired: "proxy_session.merchant_action_required";
     readonly sessionPaid: "proxy_session.paid";
     readonly sessionProvisionable: "proxy_session.provisionable";
+    readonly shopifyFulfillmentObserved: "shopify.fulfillment_observed";
+    readonly shopifyRefundObserved: "shopify.refund_observed";
+    readonly shopifySubscriptionPaymentObserved: "shopify.subscription_payment_observed";
+    readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
@@ -27,3 +33,5 @@ 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 observation-only `shopify.*` commerce events. */
+export declare function isProxyShopifyEvent(eventType: string): boolean;

package/dist/cjs/webhook-events.js

@@ -11,9 +11,12 @@ exports.PROXY_WEBHOOK_EVENT_TYPES = void 0;
 exports.isProxySessionEvent = isProxySessionEvent;
 exports.isProxySubscriptionEvent = isProxySubscriptionEvent;
 exports.isProxyPaymentAttemptEvent = isProxyPaymentAttemptEvent;
+exports.isProxyShopifyEvent = isProxyShopifyEvent;
 exports.PROXY_WEBHOOK_EVENT_TYPES = {
     paymentAttemptCancelled: "payment_attempt.cancelled",
     paymentAttemptFailed: "payment_attempt.failed",
+    paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded",
+    paymentAttemptRefunded: "payment_attempt.refunded",
     paymentAttemptSucceeded: "payment_attempt.succeeded",
     sessionCancelled: "proxy_session.cancelled",
     sessionExpired: "proxy_session.expired",
@@ -21,6 +24,10 @@ exports.PROXY_WEBHOOK_EVENT_TYPES = {
     sessionMerchantActionRequired: "proxy_session.merchant_action_required",
     sessionPaid: "proxy_session.paid",
     sessionProvisionable: "proxy_session.provisionable",
+    shopifyFulfillmentObserved: "shopify.fulfillment_observed",
+    shopifyRefundObserved: "shopify.refund_observed",
+    shopifySubscriptionPaymentObserved: "shopify.subscription_payment_observed",
+    shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed",
     subscriptionCancelled: "subscription.cancelled",
     subscriptionCancelScheduled: "subscription.cancel_scheduled",
     subscriptionPaymentFailed: "subscription.payment_failed",
@@ -43,8 +50,16 @@ const SUBSCRIPTION_EVENT_TYPES = new Set([
 const PAYMENT_ATTEMPT_EVENT_TYPES = new Set([
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptCancelled,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptFailed,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptPartiallyRefunded,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptRefunded,
     exports.PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptSucceeded,
 ]);
+const SHOPIFY_EVENT_TYPES = new Set([
+    exports.PROXY_WEBHOOK_EVENT_TYPES.shopifyFulfillmentObserved,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.shopifyRefundObserved,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.shopifySubscriptionPaymentObserved,
+    exports.PROXY_WEBHOOK_EVENT_TYPES.shopifySubscriptionRefundObserved,
+]);
 /** True for `proxy_session.*` events. */
 function isProxySessionEvent(eventType) {
     return SESSION_EVENT_TYPES.has(eventType);
@@ -57,3 +72,7 @@ function isProxySubscriptionEvent(eventType) {
 function isProxyPaymentAttemptEvent(eventType) {
     return PAYMENT_ATTEMPT_EVENT_TYPES.has(eventType);
 }
+/** True for observation-only `shopify.*` commerce events. */
+function isProxyShopifyEvent(eventType) {
+    return SHOPIFY_EVENT_TYPES.has(eventType);
+}

package/dist/esm/index.d.ts

@@ -8,6 +8,6 @@ export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type
 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, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, 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

@@ -7,6 +7,6 @@ export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionPr
 export { ProxySessionCartResource, ProxySessionsResource, proxyCheckoutServerEndpoints, } from "./sessions.js";
 export { ProxySubscriptionsResource, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
 export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
-export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, } from "./webhook-events.js";
+export { isProxyPaymentAttemptEvent, 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-109.82.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-109.82.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.8-prx-120.90.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.8-prx-120.90.1";

package/dist/esm/version.js

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

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

@@ -8,6 +8,8 @@
 export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly paymentAttemptCancelled: "payment_attempt.cancelled";
     readonly paymentAttemptFailed: "payment_attempt.failed";
+    readonly paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded";
+    readonly paymentAttemptRefunded: "payment_attempt.refunded";
     readonly paymentAttemptSucceeded: "payment_attempt.succeeded";
     readonly sessionCancelled: "proxy_session.cancelled";
     readonly sessionExpired: "proxy_session.expired";
@@ -15,6 +17,10 @@ export declare const PROXY_WEBHOOK_EVENT_TYPES: {
     readonly sessionMerchantActionRequired: "proxy_session.merchant_action_required";
     readonly sessionPaid: "proxy_session.paid";
     readonly sessionProvisionable: "proxy_session.provisionable";
+    readonly shopifyFulfillmentObserved: "shopify.fulfillment_observed";
+    readonly shopifyRefundObserved: "shopify.refund_observed";
+    readonly shopifySubscriptionPaymentObserved: "shopify.subscription_payment_observed";
+    readonly shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed";
     readonly subscriptionCancelled: "subscription.cancelled";
     readonly subscriptionCancelScheduled: "subscription.cancel_scheduled";
     readonly subscriptionPaymentFailed: "subscription.payment_failed";
@@ -27,3 +33,5 @@ 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 observation-only `shopify.*` commerce events. */
+export declare function isProxyShopifyEvent(eventType: string): boolean;

package/dist/esm/webhook-events.js

@@ -8,6 +8,8 @@
 export const PROXY_WEBHOOK_EVENT_TYPES = {
     paymentAttemptCancelled: "payment_attempt.cancelled",
     paymentAttemptFailed: "payment_attempt.failed",
+    paymentAttemptPartiallyRefunded: "payment_attempt.partially_refunded",
+    paymentAttemptRefunded: "payment_attempt.refunded",
     paymentAttemptSucceeded: "payment_attempt.succeeded",
     sessionCancelled: "proxy_session.cancelled",
     sessionExpired: "proxy_session.expired",
@@ -15,6 +17,10 @@ export const PROXY_WEBHOOK_EVENT_TYPES = {
     sessionMerchantActionRequired: "proxy_session.merchant_action_required",
     sessionPaid: "proxy_session.paid",
     sessionProvisionable: "proxy_session.provisionable",
+    shopifyFulfillmentObserved: "shopify.fulfillment_observed",
+    shopifyRefundObserved: "shopify.refund_observed",
+    shopifySubscriptionPaymentObserved: "shopify.subscription_payment_observed",
+    shopifySubscriptionRefundObserved: "shopify.subscription_refund_observed",
     subscriptionCancelled: "subscription.cancelled",
     subscriptionCancelScheduled: "subscription.cancel_scheduled",
     subscriptionPaymentFailed: "subscription.payment_failed",
@@ -37,8 +43,16 @@ const SUBSCRIPTION_EVENT_TYPES = new Set([
 const PAYMENT_ATTEMPT_EVENT_TYPES = new Set([
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptCancelled,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptFailed,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptPartiallyRefunded,
+    PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptRefunded,
     PROXY_WEBHOOK_EVENT_TYPES.paymentAttemptSucceeded,
 ]);
+const SHOPIFY_EVENT_TYPES = new Set([
+    PROXY_WEBHOOK_EVENT_TYPES.shopifyFulfillmentObserved,
+    PROXY_WEBHOOK_EVENT_TYPES.shopifyRefundObserved,
+    PROXY_WEBHOOK_EVENT_TYPES.shopifySubscriptionPaymentObserved,
+    PROXY_WEBHOOK_EVENT_TYPES.shopifySubscriptionRefundObserved,
+]);
 /** True for `proxy_session.*` events. */
 export function isProxySessionEvent(eventType) {
     return SESSION_EVENT_TYPES.has(eventType);
@@ -51,3 +65,7 @@ export function isProxySubscriptionEvent(eventType) {
 export function isProxyPaymentAttemptEvent(eventType) {
     return PAYMENT_ATTEMPT_EVENT_TYPES.has(eventType);
 }
+/** True for observation-only `shopify.*` commerce events. */
+export function isProxyShopifyEvent(eventType) {
+    return SHOPIFY_EVENT_TYPES.has(eventType);
+}

package/package.json

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