@01.software/sdk 0.49.0 → 0.51.0

package/dist/{index-CbKyoEzy.d.cts → index-B0Hjh3Ey.d.ts}

@@ -1,6 +1,6 @@
-import { C as Collection } from './const-CBba4lDo.cjs';
-import { C as CollectionType } from './types-BKr_2avj.cjs';
-import './payload-types-MKbx5MuJ.cjs';
+import { C as Collection } from './const-JD8obaKg.js';
+import { C as CollectionType } from './types-5ZlcAFuU.js';
+import './payload-types-BOsckg8B.js';
 
 type WebhookOperation = string;
 /**
@@ -61,8 +61,10 @@ interface WebhookEvent<T extends Collection | string = Collection, TData = T ext
     deliveryId?: string;
 }
 type WebhookHandler<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>> = (event: WebhookEvent<T, TData>) => Promise<void> | void;
+/** @deprecated Use the signed receiver options from `@01.software/sdk/webhook`. */
 interface WebhookOptions {
-    secret?: string;
+    /** Nonblank HMAC-SHA256 signing secret for this receiver. */
+    secret: string;
     /** Max accepted skew for signed webhook delivery timestamps. Default: 300s. */
     toleranceSeconds?: number;
 }
@@ -74,13 +76,57 @@ type OrderChangedWebhookEvent<T extends Collection | string = Collection, TData
     change: WebhookOrderChange;
 };
 declare const COMMERCE_NOTIFICATION_OPERATION: "notification";
-declare const COMMERCE_NOTIFICATION_EVENTS: readonly ["orderPaid", "orderCanceled", "fulfillmentShipped", "orderDelivered", "returnRequested", "returnApproved", "returnRejected", "returnCanceled", "returnCompleted"];
+declare const COMMERCE_NOTIFICATION_EVENTS: readonly ["orderPaid", "orderCanceled", "fulfillmentShipped", "orderDelivered", "returnRequested", "returnApproved", "returnRejected", "returnCanceled", "returnCompleted", "paymentReconciliationRequired", "paymentRefundRequiresAttention"];
 type CommerceNotificationEventName = (typeof COMMERCE_NOTIFICATION_EVENTS)[number];
-type CommerceNotificationSourceCollection = 'orders' | 'fulfillments' | 'returns';
+type CustomerCommerceNotificationEventName = Exclude<CommerceNotificationEventName, PaymentIncidentNotificationEventName>;
+type CommerceNotificationSourceCollection = 'orders' | 'fulfillments' | 'returns' | 'payment-sessions' | 'payment-refund-attempts';
 type CommerceNotificationSource = {
     collection: CommerceNotificationSourceCollection;
     id: string | number;
 };
+type PaymentIncidentNotificationEventName = 'paymentReconciliationRequired' | 'paymentRefundRequiresAttention';
+type PaymentIncidentNotificationSourceCollection = 'payment-sessions' | 'payment-refund-attempts';
+type PaymentIncidentNotificationReason = 'orderless_capture' | 'local_commit_ambiguous';
+type PaymentIncidentNotificationStatus = 'reconciliation_required' | 'requires_attention';
+type PaymentIncidentProviderObject = {
+    provider: string;
+    kind: 'payment' | 'refund';
+    id: string;
+};
+type PaymentIncidentMoney = {
+    amountMinor: number;
+    currency: string;
+};
+type PaymentIncidentNotificationBase = {
+    paymentSessionId: string;
+    checkoutId?: string;
+    orderId?: string;
+    providerObject: PaymentIncidentProviderObject;
+    money: PaymentIncidentMoney;
+    observedAt: string;
+};
+type PaymentReconciliationRequiredNotificationData = PaymentIncidentNotificationBase & {
+    source: {
+        collection: 'payment-sessions';
+        id: string;
+    };
+    providerObject: PaymentIncidentProviderObject & {
+        kind: 'payment';
+    };
+    status: 'reconciliation_required';
+    reason: 'orderless_capture';
+    refundAttemptId?: never;
+};
+type PaymentRefundRequiresAttentionNotificationData = PaymentIncidentNotificationBase & {
+    source: {
+        collection: 'payment-refund-attempts';
+        id: string;
+    };
+    refundAttemptId: string;
+    status: 'requires_attention';
+    reason: 'local_commit_ambiguous';
+};
+type PaymentIncidentNotificationData = PaymentReconciliationRequiredNotificationData | PaymentRefundRequiresAttentionNotificationData;
 type CommerceNotificationData = {
     source?: CommerceNotificationSource;
     orderId?: string | number;
@@ -95,6 +141,13 @@ type CommerceNotificationData = {
     returnStatus?: string;
     refundAmount?: number;
     completedAt?: string;
+    paymentSessionId?: string;
+    checkoutId?: string;
+    refundAttemptId?: string;
+    providerObject?: PaymentIncidentProviderObject;
+    money?: PaymentIncidentMoney;
+    reason?: PaymentIncidentNotificationReason;
+    observedAt?: string;
 };
 type CommerceNotification = {
     event: CommerceNotificationEventName;
@@ -103,6 +156,8 @@ type CommerceNotification = {
     orderId?: string;
     fulfillmentId?: string;
     returnId?: string;
+    paymentSessionId?: string;
+    refundAttemptId?: string;
 };
 type WebhookCommerceNotificationChange = {
     type: 'notification';
@@ -126,7 +181,7 @@ type CommerceEmailEventConfig = {
 };
 type CommerceEmailConfig = {
     version: 1;
-    commerceNotifications: Partial<Record<CommerceNotificationEventName, CommerceEmailEventConfig>>;
+    commerceNotifications: Partial<Record<CustomerCommerceNotificationEventName, CommerceEmailEventConfig>>;
 };
 type CommerceNotificationHandlerContext = {
     event: CommerceNotificationWebhookEvent;
@@ -137,7 +192,9 @@ type CommerceNotificationEventHandlers = Partial<Record<CommerceNotificationEven
     unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
 };
 type CommerceEmailHandlerContext = CommerceNotificationHandlerContext;
-type CommerceEmailEventHandlers = CommerceNotificationEventHandlers;
+type CommerceEmailEventHandlers = Partial<Record<CustomerCommerceNotificationEventName, (context: CommerceEmailHandlerContext) => MaybePromise<void>>> & {
+    unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
+};
 /**
  * Returns true for semantic order-change webhooks emitted as update events.
  *
@@ -183,7 +240,12 @@ interface CustomerAuthWebhookHandlers {
 }
 declare function isCustomerPasswordResetWebhookEvent(event: WebhookEvent<string, unknown>): event is CustomerPasswordResetWebhookEvent;
 declare function createCustomerAuthWebhookHandler(handlers: CustomerAuthWebhookHandlers): WebhookHandler<string, unknown>;
-declare function handleWebhook<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>>(request: Request, handler: WebhookHandler<T, TData>, options?: WebhookOptions): Promise<Response>;
+/**
+ * @deprecated Import `handleSignedWebhook()` from `@01.software/sdk/webhook`.
+ * This compatibility alias is signed and fails closed when its required secret
+ * is missing or blank.
+ */
+declare function handleWebhook<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>>(request: Request, handler: WebhookHandler<T, TData>, options: WebhookOptions): Promise<Response>;
 declare function createTypedWebhookHandler<T extends Collection>(collection: T, handler: (event: WebhookEvent<T>) => Promise<void> | void): WebhookHandler<T>;
 
-export { type WebhookOperation as A, type WebhookOptions as B, COMMERCE_NOTIFICATION_EVENTS as C, type WebhookOrderChange as D, type WebhookOrderMoved as E, type WebhookOrderScope as F, createCommerceEmailWebhookHandler as G, createCommerceNotificationWebhookHandler as H, createCustomerAuthWebhookHandler as I, createTypedWebhookHandler as J, defineCommerceEmailConfig as K, getCommerceNotificationIdempotencyKey as L, handleWebhook as M, isCommerceNotificationWebhookEvent as N, ORDER_CHANGED_EVENT_TYPE as O, isCustomerPasswordResetWebhookEvent as P, isOrderChangedWebhookEvent as Q, isValidWebhookEvent as R, isWebhookCollection as S, isWebhookOperation as T, type WebhookChange as W, COMMERCE_NOTIFICATION_EVENT_TYPE as a, COMMERCE_NOTIFICATION_OPERATION as b, CUSTOMER_PASSWORD_RESET_OPERATION as c, type CollectionWebhookOperation as d, type CommerceEmailChannel as e, type CommerceEmailConfig as f, type CommerceEmailEventConfig as g, type CommerceEmailEventHandlers as h, type CommerceEmailHandlerContext as i, type CommerceNotification as j, type CommerceNotificationData as k, type CommerceNotificationEventHandlers as l, type CommerceNotificationEventName as m, type CommerceNotificationHandlerContext as n, type CommerceNotificationSource as o, type CommerceNotificationSourceCollection as p, type CommerceNotificationWebhookEvent as q, type CustomerAuthWebhookEvent as r, type CustomerAuthWebhookHandlers as s, type CustomerPasswordResetWebhookData as t, type CustomerPasswordResetWebhookEvent as u, type OrderChangedWebhookEvent as v, type WebhookCommerceNotificationChange as w, type WebhookEvent as x, type WebhookHandler as y, type WebhookKnownOperation as z };
+export { isWebhookOperation as $, type PaymentIncidentNotificationStatus as A, type PaymentIncidentProviderObject as B, COMMERCE_NOTIFICATION_EVENTS as C, type WebhookChange as D, type WebhookCommerceNotificationChange as E, type WebhookEvent as F, type WebhookKnownOperation as G, type WebhookOperation as H, type WebhookOptions as I, type WebhookOrderChange as J, type WebhookOrderMoved as K, type WebhookOrderScope as L, createCommerceEmailWebhookHandler as M, createCommerceNotificationWebhookHandler as N, ORDER_CHANGED_EVENT_TYPE as O, type PaymentIncidentMoney as P, createCustomerAuthWebhookHandler as Q, createTypedWebhookHandler as R, defineCommerceEmailConfig as S, getCommerceNotificationIdempotencyKey as T, handleWebhook as U, isCommerceNotificationWebhookEvent as V, type WebhookHandler as W, isCustomerPasswordResetWebhookEvent as X, isOrderChangedWebhookEvent as Y, isValidWebhookEvent as Z, isWebhookCollection as _, COMMERCE_NOTIFICATION_EVENT_TYPE as a, type CustomerCommerceNotificationEventName as a0, type PaymentReconciliationRequiredNotificationData as a1, type PaymentRefundRequiresAttentionNotificationData as a2, COMMERCE_NOTIFICATION_OPERATION as b, CUSTOMER_PASSWORD_RESET_OPERATION as c, type CollectionWebhookOperation as d, type CommerceEmailChannel as e, type CommerceEmailConfig as f, type CommerceEmailEventConfig as g, type CommerceEmailEventHandlers as h, type CommerceEmailHandlerContext as i, type CommerceNotification as j, type CommerceNotificationData as k, type CommerceNotificationEventHandlers as l, type CommerceNotificationEventName as m, type CommerceNotificationHandlerContext as n, type CommerceNotificationSource as o, type CommerceNotificationSourceCollection as p, type CommerceNotificationWebhookEvent as q, type CustomerAuthWebhookEvent as r, type CustomerAuthWebhookHandlers as s, type CustomerPasswordResetWebhookData as t, type CustomerPasswordResetWebhookEvent as u, type OrderChangedWebhookEvent as v, type PaymentIncidentNotificationData as w, type PaymentIncidentNotificationEventName as x, type PaymentIncidentNotificationReason as y, type PaymentIncidentNotificationSourceCollection as z };

package/dist/{index-DUuIqUS8.d.ts → index-Bu0kCc6o.d.cts}

@@ -1,6 +1,6 @@
-import { C as Collection } from './const-DCNV5Kq7.js';
-import { C as CollectionType } from './types-L_nh-ED7.js';
-import './payload-types-MKbx5MuJ.js';
+import { C as Collection } from './const-D8LixhAJ.cjs';
+import { C as CollectionType } from './types-B14sEt1z.cjs';
+import './payload-types-BOsckg8B.cjs';
 
 type WebhookOperation = string;
 /**
@@ -61,8 +61,10 @@ interface WebhookEvent<T extends Collection | string = Collection, TData = T ext
     deliveryId?: string;
 }
 type WebhookHandler<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>> = (event: WebhookEvent<T, TData>) => Promise<void> | void;
+/** @deprecated Use the signed receiver options from `@01.software/sdk/webhook`. */
 interface WebhookOptions {
-    secret?: string;
+    /** Nonblank HMAC-SHA256 signing secret for this receiver. */
+    secret: string;
     /** Max accepted skew for signed webhook delivery timestamps. Default: 300s. */
     toleranceSeconds?: number;
 }
@@ -74,13 +76,57 @@ type OrderChangedWebhookEvent<T extends Collection | string = Collection, TData
     change: WebhookOrderChange;
 };
 declare const COMMERCE_NOTIFICATION_OPERATION: "notification";
-declare const COMMERCE_NOTIFICATION_EVENTS: readonly ["orderPaid", "orderCanceled", "fulfillmentShipped", "orderDelivered", "returnRequested", "returnApproved", "returnRejected", "returnCanceled", "returnCompleted"];
+declare const COMMERCE_NOTIFICATION_EVENTS: readonly ["orderPaid", "orderCanceled", "fulfillmentShipped", "orderDelivered", "returnRequested", "returnApproved", "returnRejected", "returnCanceled", "returnCompleted", "paymentReconciliationRequired", "paymentRefundRequiresAttention"];
 type CommerceNotificationEventName = (typeof COMMERCE_NOTIFICATION_EVENTS)[number];
-type CommerceNotificationSourceCollection = 'orders' | 'fulfillments' | 'returns';
+type CustomerCommerceNotificationEventName = Exclude<CommerceNotificationEventName, PaymentIncidentNotificationEventName>;
+type CommerceNotificationSourceCollection = 'orders' | 'fulfillments' | 'returns' | 'payment-sessions' | 'payment-refund-attempts';
 type CommerceNotificationSource = {
     collection: CommerceNotificationSourceCollection;
     id: string | number;
 };
+type PaymentIncidentNotificationEventName = 'paymentReconciliationRequired' | 'paymentRefundRequiresAttention';
+type PaymentIncidentNotificationSourceCollection = 'payment-sessions' | 'payment-refund-attempts';
+type PaymentIncidentNotificationReason = 'orderless_capture' | 'local_commit_ambiguous';
+type PaymentIncidentNotificationStatus = 'reconciliation_required' | 'requires_attention';
+type PaymentIncidentProviderObject = {
+    provider: string;
+    kind: 'payment' | 'refund';
+    id: string;
+};
+type PaymentIncidentMoney = {
+    amountMinor: number;
+    currency: string;
+};
+type PaymentIncidentNotificationBase = {
+    paymentSessionId: string;
+    checkoutId?: string;
+    orderId?: string;
+    providerObject: PaymentIncidentProviderObject;
+    money: PaymentIncidentMoney;
+    observedAt: string;
+};
+type PaymentReconciliationRequiredNotificationData = PaymentIncidentNotificationBase & {
+    source: {
+        collection: 'payment-sessions';
+        id: string;
+    };
+    providerObject: PaymentIncidentProviderObject & {
+        kind: 'payment';
+    };
+    status: 'reconciliation_required';
+    reason: 'orderless_capture';
+    refundAttemptId?: never;
+};
+type PaymentRefundRequiresAttentionNotificationData = PaymentIncidentNotificationBase & {
+    source: {
+        collection: 'payment-refund-attempts';
+        id: string;
+    };
+    refundAttemptId: string;
+    status: 'requires_attention';
+    reason: 'local_commit_ambiguous';
+};
+type PaymentIncidentNotificationData = PaymentReconciliationRequiredNotificationData | PaymentRefundRequiresAttentionNotificationData;
 type CommerceNotificationData = {
     source?: CommerceNotificationSource;
     orderId?: string | number;
@@ -95,6 +141,13 @@ type CommerceNotificationData = {
     returnStatus?: string;
     refundAmount?: number;
     completedAt?: string;
+    paymentSessionId?: string;
+    checkoutId?: string;
+    refundAttemptId?: string;
+    providerObject?: PaymentIncidentProviderObject;
+    money?: PaymentIncidentMoney;
+    reason?: PaymentIncidentNotificationReason;
+    observedAt?: string;
 };
 type CommerceNotification = {
     event: CommerceNotificationEventName;
@@ -103,6 +156,8 @@ type CommerceNotification = {
     orderId?: string;
     fulfillmentId?: string;
     returnId?: string;
+    paymentSessionId?: string;
+    refundAttemptId?: string;
 };
 type WebhookCommerceNotificationChange = {
     type: 'notification';
@@ -126,7 +181,7 @@ type CommerceEmailEventConfig = {
 };
 type CommerceEmailConfig = {
     version: 1;
-    commerceNotifications: Partial<Record<CommerceNotificationEventName, CommerceEmailEventConfig>>;
+    commerceNotifications: Partial<Record<CustomerCommerceNotificationEventName, CommerceEmailEventConfig>>;
 };
 type CommerceNotificationHandlerContext = {
     event: CommerceNotificationWebhookEvent;
@@ -137,7 +192,9 @@ type CommerceNotificationEventHandlers = Partial<Record<CommerceNotificationEven
     unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
 };
 type CommerceEmailHandlerContext = CommerceNotificationHandlerContext;
-type CommerceEmailEventHandlers = CommerceNotificationEventHandlers;
+type CommerceEmailEventHandlers = Partial<Record<CustomerCommerceNotificationEventName, (context: CommerceEmailHandlerContext) => MaybePromise<void>>> & {
+    unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
+};
 /**
  * Returns true for semantic order-change webhooks emitted as update events.
  *
@@ -183,7 +240,12 @@ interface CustomerAuthWebhookHandlers {
 }
 declare function isCustomerPasswordResetWebhookEvent(event: WebhookEvent<string, unknown>): event is CustomerPasswordResetWebhookEvent;
 declare function createCustomerAuthWebhookHandler(handlers: CustomerAuthWebhookHandlers): WebhookHandler<string, unknown>;
-declare function handleWebhook<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>>(request: Request, handler: WebhookHandler<T, TData>, options?: WebhookOptions): Promise<Response>;
+/**
+ * @deprecated Import `handleSignedWebhook()` from `@01.software/sdk/webhook`.
+ * This compatibility alias is signed and fails closed when its required secret
+ * is missing or blank.
+ */
+declare function handleWebhook<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>>(request: Request, handler: WebhookHandler<T, TData>, options: WebhookOptions): Promise<Response>;
 declare function createTypedWebhookHandler<T extends Collection>(collection: T, handler: (event: WebhookEvent<T>) => Promise<void> | void): WebhookHandler<T>;
 
-export { type WebhookOperation as A, type WebhookOptions as B, COMMERCE_NOTIFICATION_EVENTS as C, type WebhookOrderChange as D, type WebhookOrderMoved as E, type WebhookOrderScope as F, createCommerceEmailWebhookHandler as G, createCommerceNotificationWebhookHandler as H, createCustomerAuthWebhookHandler as I, createTypedWebhookHandler as J, defineCommerceEmailConfig as K, getCommerceNotificationIdempotencyKey as L, handleWebhook as M, isCommerceNotificationWebhookEvent as N, ORDER_CHANGED_EVENT_TYPE as O, isCustomerPasswordResetWebhookEvent as P, isOrderChangedWebhookEvent as Q, isValidWebhookEvent as R, isWebhookCollection as S, isWebhookOperation as T, type WebhookChange as W, COMMERCE_NOTIFICATION_EVENT_TYPE as a, COMMERCE_NOTIFICATION_OPERATION as b, CUSTOMER_PASSWORD_RESET_OPERATION as c, type CollectionWebhookOperation as d, type CommerceEmailChannel as e, type CommerceEmailConfig as f, type CommerceEmailEventConfig as g, type CommerceEmailEventHandlers as h, type CommerceEmailHandlerContext as i, type CommerceNotification as j, type CommerceNotificationData as k, type CommerceNotificationEventHandlers as l, type CommerceNotificationEventName as m, type CommerceNotificationHandlerContext as n, type CommerceNotificationSource as o, type CommerceNotificationSourceCollection as p, type CommerceNotificationWebhookEvent as q, type CustomerAuthWebhookEvent as r, type CustomerAuthWebhookHandlers as s, type CustomerPasswordResetWebhookData as t, type CustomerPasswordResetWebhookEvent as u, type OrderChangedWebhookEvent as v, type WebhookCommerceNotificationChange as w, type WebhookEvent as x, type WebhookHandler as y, type WebhookKnownOperation as z };
+export { isWebhookOperation as $, type PaymentIncidentNotificationStatus as A, type PaymentIncidentProviderObject as B, COMMERCE_NOTIFICATION_EVENTS as C, type WebhookChange as D, type WebhookCommerceNotificationChange as E, type WebhookEvent as F, type WebhookKnownOperation as G, type WebhookOperation as H, type WebhookOptions as I, type WebhookOrderChange as J, type WebhookOrderMoved as K, type WebhookOrderScope as L, createCommerceEmailWebhookHandler as M, createCommerceNotificationWebhookHandler as N, ORDER_CHANGED_EVENT_TYPE as O, type PaymentIncidentMoney as P, createCustomerAuthWebhookHandler as Q, createTypedWebhookHandler as R, defineCommerceEmailConfig as S, getCommerceNotificationIdempotencyKey as T, handleWebhook as U, isCommerceNotificationWebhookEvent as V, type WebhookHandler as W, isCustomerPasswordResetWebhookEvent as X, isOrderChangedWebhookEvent as Y, isValidWebhookEvent as Z, isWebhookCollection as _, COMMERCE_NOTIFICATION_EVENT_TYPE as a, type CustomerCommerceNotificationEventName as a0, type PaymentReconciliationRequiredNotificationData as a1, type PaymentRefundRequiresAttentionNotificationData as a2, COMMERCE_NOTIFICATION_OPERATION as b, CUSTOMER_PASSWORD_RESET_OPERATION as c, type CollectionWebhookOperation as d, type CommerceEmailChannel as e, type CommerceEmailConfig as f, type CommerceEmailEventConfig as g, type CommerceEmailEventHandlers as h, type CommerceEmailHandlerContext as i, type CommerceNotification as j, type CommerceNotificationData as k, type CommerceNotificationEventHandlers as l, type CommerceNotificationEventName as m, type CommerceNotificationHandlerContext as n, type CommerceNotificationSource as o, type CommerceNotificationSourceCollection as p, type CommerceNotificationWebhookEvent as q, type CustomerAuthWebhookEvent as r, type CustomerAuthWebhookHandlers as s, type CustomerPasswordResetWebhookData as t, type CustomerPasswordResetWebhookEvent as u, type OrderChangedWebhookEvent as v, type PaymentIncidentNotificationData as w, type PaymentIncidentNotificationEventName as x, type PaymentIncidentNotificationReason as y, type PaymentIncidentNotificationSourceCollection as z };