@01.software/sdk 0.31.0 → 0.33.0

package/dist/{collection-client-ByzY3hWK.d.ts → collection-client-B6SlhzIP.d.ts}

@@ -1,7 +1,7 @@
-import { D as DebugConfig, R as RetryConfig, A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse } from './types-BX2mqDf6.js';
+import { D as DebugConfig, R as RetryConfig, A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse } from './types-BHh0YLmq.js';
 import { GenerateMetadataOptions, Metadata } from './metadata.js';
-import { c as ServerCollection, P as PublicCollection } from './const-BGCP-OJL.js';
-import { C as CollectionType } from './types-CVA10VC-.js';
+import { c as ServerCollection, P as PublicCollection } from './const-DwmSDeWq.js';
+import { C as CollectionType } from './types-Cel_4L9t.js';
 
 interface FetchOptions extends RequestInit {
     apiUrl?: string;

package/dist/{collection-client-DFXXz0vk.d.cts → collection-client-De6eKW1J.d.cts}

@@ -1,7 +1,7 @@
-import { D as DebugConfig, R as RetryConfig, A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse } from './types-DChFjQGz.cjs';
+import { D as DebugConfig, R as RetryConfig, A as ApiQueryOptions, P as PayloadFindResponse, g as PayloadMutationResponse } from './types-BZKxss8Y.cjs';
 import { GenerateMetadataOptions, Metadata } from './metadata.cjs';
-import { c as ServerCollection, P as PublicCollection } from './const-AytzliEu.cjs';
-import { C as CollectionType } from './types-CmLG-7RL.cjs';
+import { c as ServerCollection, P as PublicCollection } from './const-sPR2IkCe.cjs';
+import { C as CollectionType } from './types-B3YT092I.cjs';
 
 interface FetchOptions extends RequestInit {
     apiUrl?: string;

package/dist/{const-AytzliEu.d.cts → const-DwmSDeWq.d.ts}

@@ -1,4 +1,4 @@
-import { e as Config } from './payload-types-Wa4-eC6x.cjs';
+import { e as Config } from './payload-types-dkeQyrDC.js';
 
 /**
  * Collection type derived from Payload Config.
@@ -9,7 +9,7 @@ type Collection = keyof Config['collections'];
  * Internal collections that should not be exposed via SDK.
  * Includes Payload system collections and admin-only collections.
  */
-declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "inventory-reservations", "product-collection-items", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
+declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "inventory-reservations", "commerce-notification-intents", "product-collection-items", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
 /**
  * Array of all public collection names for runtime use (e.g., Zod enum validation).
  * This is the single source of truth for which collections are publicly accessible via SDK.

package/dist/{const-BGCP-OJL.d.ts → const-sPR2IkCe.d.cts}

@@ -1,4 +1,4 @@
-import { e as Config } from './payload-types-Wa4-eC6x.js';
+import { e as Config } from './payload-types-dkeQyrDC.cjs';
 
 /**
  * Collection type derived from Payload Config.
@@ -9,7 +9,7 @@ type Collection = keyof Config['collections'];
  * Internal collections that should not be exposed via SDK.
  * Includes Payload system collections and admin-only collections.
  */
-declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "inventory-reservations", "product-collection-items", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
+declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "inventory-reservations", "commerce-notification-intents", "product-collection-items", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
 /**
  * Array of all public collection names for runtime use (e.g., Zod enum validation).
  * This is the single source of truth for which collections are publicly accessible via SDK.

package/dist/index.cjs

@@ -24,6 +24,9 @@ __export(src_exports, {
   AuthError: () => AuthError,
   BaseApi: () => BaseApi,
   COLLECTIONS: () => COLLECTIONS,
+  COMMERCE_NOTIFICATION_EVENTS: () => COMMERCE_NOTIFICATION_EVENTS,
+  COMMERCE_NOTIFICATION_EVENT_TYPE: () => COMMERCE_NOTIFICATION_EVENT_TYPE,
+  COMMERCE_NOTIFICATION_OPERATION: () => COMMERCE_NOTIFICATION_OPERATION,
   CUSTOMER_PASSWORD_RESET_OPERATION: () => CUSTOMER_PASSWORD_RESET_OPERATION,
   CartApi: () => CartApi,
   CommerceClient: () => CommerceClient,
@@ -38,6 +41,7 @@ __export(src_exports, {
   INTERNAL_COLLECTIONS: () => INTERNAL_COLLECTIONS,
   NetworkError: () => NetworkError,
   NotFoundError: () => NotFoundError,
+  ORDER_CHANGED_EVENT_TYPE: () => ORDER_CHANGED_EVENT_TYPE,
   OrderApi: () => OrderApi,
   PermissionError: () => PermissionError,
   ProductApi: () => ProductApi,
@@ -61,6 +65,7 @@ __export(src_exports, {
   createAnalytics: () => createAnalytics,
   createAuthError: () => createAuthError,
   createClient: () => createClient2,
+  createCommerceEmailWebhookHandler: () => createCommerceEmailWebhookHandler,
   createConflictError: () => createConflictError,
   createCustomerAuthWebhookHandler: () => createCustomerAuthWebhookHandler,
   createNotFoundError: () => createNotFoundError,
@@ -68,9 +73,11 @@ __export(src_exports, {
   createProductSelectionCodec: () => createProductSelectionCodec,
   createRateLimitError: () => createRateLimitError,
   createTypedWebhookHandler: () => createTypedWebhookHandler,
+  defineCommerceEmailConfig: () => defineCommerceEmailConfig,
   formatOrderName: () => formatOrderName,
   generateOrderNumber: () => generateOrderNumber,
   getAvailableOptionValues: () => getAvailableOptionValues,
+  getCommerceNotificationIdempotencyKey: () => getCommerceNotificationIdempotencyKey,
   getImageLqip: () => getImageLqip,
   getImagePalette: () => getImagePalette,
   getImagePlaceholderStyle: () => getImagePlaceholderStyle,
@@ -86,12 +93,14 @@ __export(src_exports, {
   handleWebhook: () => handleWebhook,
   isApiError: () => isApiError,
   isAuthError: () => isAuthError,
+  isCommerceNotificationWebhookEvent: () => isCommerceNotificationWebhookEvent,
   isConfigError: () => isConfigError,
   isConflictError: () => isConflictError,
   isCustomerPasswordResetWebhookEvent: () => isCustomerPasswordResetWebhookEvent,
   isGoneError: () => isGoneError,
   isNetworkError: () => isNetworkError,
   isNotFoundError: () => isNotFoundError,
+  isOrderChangedWebhookEvent: () => isOrderChangedWebhookEvent,
   isPermissionError: () => isPermissionError,
   isRateLimitError: () => isRateLimitError,
   isSDKError: () => isSDKError,
@@ -100,6 +109,8 @@ __export(src_exports, {
   isUsageLimitError: () => isUsageLimitError,
   isValidWebhookEvent: () => isValidWebhookEvent,
   isValidationError: () => isValidationError,
+  isWebhookCollection: () => isWebhookCollection,
+  isWebhookOperation: () => isWebhookOperation,
   normalizeProductSelection: () => normalizeProductSelection,
   normalizeProductSelectionFromMatrix: () => normalizeProductSelectionFromMatrix,
   normalizeSelectedValueIds: () => normalizeSelectedValueIds,
@@ -1340,7 +1351,7 @@ var CustomerAuth = class {
       );
       return data.customer ?? null;
     } catch (error) {
-      if (error instanceof ApiError && error.status === 401) {
+      if (error instanceof SDKError && error.status === 401) {
         this.setToken(null);
         return null;
       }
@@ -1435,51 +1446,15 @@ var CustomerAuth = class {
     if (!headers.has("Content-Type") && init.body) {
       headers.set("Content-Type", "application/json");
     }
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT2);
-    let res;
-    try {
-      res = await fetch(`${this.baseUrl}${path}`, {
-        ...init,
-        headers,
-        signal: controller.signal
-      });
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new TimeoutError(`Request timed out after ${DEFAULT_TIMEOUT2}ms`, {
-          url: path,
-          timeout: DEFAULT_TIMEOUT2
-        });
-      }
-      throw new NetworkError(
-        error instanceof Error ? error.message : "Network request failed",
-        void 0,
-        { url: path },
-        "Network connection failed.",
-        "Please check your internet connection and try again."
-      );
-    }
-    clearTimeout(timeoutId);
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({}));
-      throw new ApiError(
-        body.error || `HTTP ${res.status}`,
-        res.status,
-        body.details,
-        body.error
-      );
-    }
-    try {
-      return await res.json();
-    } catch {
-      throw new ApiError(
-        "Invalid JSON response from server",
-        res.status,
-        void 0,
-        "INVALID_RESPONSE"
-      );
-    }
+    const response = await httpFetch(path, {
+      ...init,
+      apiUrl: this.baseUrl,
+      publishableKey: this.publishableKey,
+      headers,
+      timeout: DEFAULT_TIMEOUT2,
+      retry: { maxRetries: 0 }
+    });
+    return parseApiResponse(response, path);
   }
 };
 
@@ -1560,6 +1535,117 @@ var CartApi = class {
   }
 };
 
+// src/core/api/base-api.ts
+var BaseApi = class {
+  constructor(apiName, options) {
+    if (!options.secretKey) {
+      throw createConfigError(`secretKey is required for ${apiName}.`);
+    }
+    this.publishableKey = requirePublishableKeyForSecret(
+      apiName,
+      options.publishableKey,
+      options.secretKey
+    );
+    this.secretKey = options.secretKey;
+    this.apiUrl = options.apiUrl;
+    this.onRequestId = options.onRequestId;
+  }
+  async request(endpoint, body, options) {
+    const method = options?.method ?? "POST";
+    try {
+      const response = await httpFetch(endpoint, {
+        method,
+        apiUrl: this.apiUrl,
+        publishableKey: this.publishableKey,
+        secretKey: this.secretKey,
+        ...body !== void 0 && { body: JSON.stringify(body) },
+        ...options?.headers && { headers: options.headers }
+      });
+      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
+      return parseApiResponse(response, endpoint);
+    } catch (err) {
+      const id = err instanceof SDKError ? err.requestId ?? null : null;
+      this.onRequestId?.(id);
+      throw err;
+    }
+  }
+};
+
+// src/core/api/product-api.ts
+var PRODUCT_DETAIL_UNAVAILABLE_REASONS = /* @__PURE__ */ new Set([
+  "not_found",
+  "not_published",
+  "feature_disabled"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readProductDetailUnavailableReason(value) {
+  if (!isRecord(value)) return void 0;
+  const directReason = value.reason ?? value.code;
+  if (typeof directReason === "string" && PRODUCT_DETAIL_UNAVAILABLE_REASONS.has(directReason)) {
+    return directReason;
+  }
+  return readProductDetailUnavailableReason(value.body);
+}
+function productDetailResultFromError(error) {
+  if (!(error instanceof SDKError) || error.status !== 404) return void 0;
+  const reason = readProductDetailUnavailableReason(error.details);
+  if (!reason) return void 0;
+  return { found: false, reason };
+}
+var ProductApi = class extends BaseApi {
+  constructor(options) {
+    super("ProductApi", options);
+  }
+  /**
+   * Check point-in-time stock availability for one or more product variants.
+   * Results reflect available stock at the moment of the call and are not guaranteed
+   * to remain available by the time an order is placed.
+   */
+  stockCheck(params) {
+    return this.request("/api/products/stock-check", params);
+  }
+  listingGroups(params) {
+    return this.request(
+      "/api/products/listing-groups",
+      params
+    );
+  }
+  /**
+   * Fetch full product detail by slug or id.
+   * Returns a discriminated result so storefronts can distinguish missing,
+   * unpublished, and feature-disabled products.
+   *
+   * Only product-detail 404 responses carrying one of those allowlisted reasons
+   * are mapped to `{ found: false, reason }`. Unknown or uncoded 404s, plus
+   * permission/auth errors such as tenant mismatch, continue to throw typed SDK
+   * errors instead of being collapsed into a storefront absence result.
+   */
+  async detail(params) {
+    try {
+      const product = await this.request(
+        "/api/products/detail",
+        params
+      );
+      return { found: true, product };
+    } catch (err) {
+      const notFoundResult = productDetailResultFromError(err);
+      if (notFoundResult) return notFoundResult;
+      throw err;
+    }
+  }
+  /**
+   * Atomically create or update a product together with its options,
+   * option-values, and variants in a single transaction. Mirrors Shopify's
+   * `productSet` shape and is the canonical write path for the MCP
+   * `product-upsert` tool.
+   */
+  upsert(params) {
+    return this.request("/api/products/upsert", params);
+  }
+};
+
 // src/core/commerce/commerce-client.ts
 var CommerceClient = class {
   constructor(options) {
@@ -1594,9 +1680,14 @@ var CommerceClient = class {
       listingGroups: (params) => execute("/api/products/listing-groups", params),
       detail: async (params) => {
         try {
-          return await execute("/api/products/detail", params);
+          const product = await execute(
+            "/api/products/detail",
+            params
+          );
+          return { found: true, product };
         } catch (err) {
-          if (err instanceof NotFoundError) return null;
+          const notFoundResult = productDetailResultFromError(err);
+          if (notFoundResult) return notFoundResult;
           throw err;
         }
       }
@@ -1688,42 +1779,6 @@ function createClient(options) {
   return new Client(options);
 }
 
-// src/core/api/base-api.ts
-var BaseApi = class {
-  constructor(apiName, options) {
-    if (!options.secretKey) {
-      throw createConfigError(`secretKey is required for ${apiName}.`);
-    }
-    this.publishableKey = requirePublishableKeyForSecret(
-      apiName,
-      options.publishableKey,
-      options.secretKey
-    );
-    this.secretKey = options.secretKey;
-    this.apiUrl = options.apiUrl;
-    this.onRequestId = options.onRequestId;
-  }
-  async request(endpoint, body, options) {
-    const method = options?.method ?? "POST";
-    try {
-      const response = await httpFetch(endpoint, {
-        method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        ...body !== void 0 && { body: JSON.stringify(body) },
-        ...options?.headers && { headers: options.headers }
-      });
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint);
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
-  }
-};
-
 // src/core/api/order-api.ts
 var OrderApi = class extends BaseApi {
   constructor(options) {
@@ -1756,7 +1811,7 @@ var OrderApi = class extends BaseApi {
   }
   bulkImportFulfillments(params) {
     return this.request(
-      "/api/orders/bulk-import-fulfillments",
+      "/api/fulfillments/bulk-import",
       params
     );
   }
@@ -1794,58 +1849,144 @@ var ShippingApi = class extends BaseApi {
   }
 };
 
-// src/core/api/product-api.ts
-var ProductApi = class extends BaseApi {
-  constructor(options) {
-    super("ProductApi", options);
-  }
-  /**
-   * Check point-in-time stock availability for one or more product variants.
-   * Results reflect available stock at the moment of the call and are not guaranteed
-   * to remain available by the time an order is placed.
-   */
-  stockCheck(params) {
-    return this.request("/api/products/stock-check", params);
-  }
-  listingGroups(params) {
-    return this.request(
-      "/api/products/listing-groups",
-      params
-    );
-  }
-  /**
-   * Fetch full product detail by slug or id.
-   * Returns `null` on 404 regardless of reason (`not_found` / `not_published` /
-   * `tenant_mismatch` / `feature_disabled`). For the reason behind a null,
-   * inspect `client.lastRequestId` against backend logs.
-   */
-  async detail(params) {
-    try {
-      return await this.request("/api/products/detail", params);
-    } catch (err) {
-      if (err instanceof NotFoundError) return null;
-      throw err;
-    }
-  }
-  /**
-   * Atomically create or update a product together with its options,
-   * option-values, and variants in a single transaction. Mirrors Shopify's
-   * `productSet` shape and is the canonical write path for the MCP
-   * `product-upsert` tool.
-   */
-  upsert(params) {
-    return this.request("/api/products/upsert", params);
-  }
-};
-
 // src/core/webhook/index.ts
+var ORDER_CHANGED_EVENT_TYPE = "collection.orderChanged";
+var COMMERCE_NOTIFICATION_EVENT_TYPE = "commerce.notification";
 function isValidWebhookEvent(data) {
   if (typeof data !== "object" || data === null) return false;
   const obj = data;
   return typeof obj.collection === "string" && typeof obj.operation === "string" && obj.operation.length > 0 && typeof obj.data === "object" && obj.data !== null;
 }
+var COMMERCE_NOTIFICATION_OPERATION = "notification";
+var COMMERCE_NOTIFICATION_EVENTS = [
+  "orderPaid",
+  "fulfillmentShipped",
+  "orderDelivered",
+  "returnRequested",
+  "returnCompleted"
+];
+function isStringOrNumber(value) {
+  return typeof value === "string" || typeof value === "number";
+}
+function isWebhookOrderScope(value) {
+  if (!isRecord2(value)) return false;
+  if (value.kind === "collection") {
+    return typeof value.collection === "string";
+  }
+  if (value.kind === "join") {
+    return typeof value.collection === "string" && typeof value.field === "string" && isStringOrNumber(value.id);
+  }
+  return false;
+}
+function isWebhookOrderMoved(value) {
+  if (!isRecord2(value)) return false;
+  return typeof value.collection === "string" && isStringOrNumber(value.id) && (value.relatedCollection === void 0 || typeof value.relatedCollection === "string") && (value.relatedId === void 0 || isStringOrNumber(value.relatedId));
+}
+function hasOptionalOrderValue(value, key) {
+  return value[key] === void 0 || value[key] === null || typeof value[key] === "string";
+}
+function isWebhookOrderChange(value) {
+  if (!isRecord2(value)) return false;
+  return value.type === "order" && value.source === "payload-orderable" && (value.orderableFieldName === void 0 || typeof value.orderableFieldName === "string") && hasOptionalOrderValue(value, "previousOrder") && hasOptionalOrderValue(value, "nextOrder") && isWebhookOrderScope(value.scope) && isWebhookOrderMoved(value.moved);
+}
+function isCommerceNotificationEventName(value) {
+  return typeof value === "string" && COMMERCE_NOTIFICATION_EVENTS.includes(value);
+}
+function isCommerceNotificationSourceCollection(value) {
+  return value === "orders" || value === "fulfillments" || value === "returns";
+}
+function isCommerceNotificationData(value) {
+  if (!isRecord2(value)) return false;
+  if (value.source !== void 0 && (!isRecord2(value.source) || !isCommerceNotificationSourceCollection(value.source.collection) || !isStringOrNumber(value.source.id))) {
+    return false;
+  }
+  return (value.orderId === void 0 || isStringOrNumber(value.orderId)) && (value.orderNumber === void 0 || typeof value.orderNumber === "string") && (value.status === void 0 || typeof value.status === "string") && (value.totalAmount === void 0 || typeof value.totalAmount === "number") && (value.currency === void 0 || typeof value.currency === "string") && (value.fulfillmentId === void 0 || isStringOrNumber(value.fulfillmentId)) && (value.fulfillmentStatus === void 0 || typeof value.fulfillmentStatus === "string") && (value.shippedAt === void 0 || typeof value.shippedAt === "string") && (value.returnId === void 0 || isStringOrNumber(value.returnId)) && (value.returnStatus === void 0 || typeof value.returnStatus === "string") && (value.refundAmount === void 0 || typeof value.refundAmount === "number") && (value.completedAt === void 0 || typeof value.completedAt === "string");
+}
+function isCommerceNotification(value) {
+  if (!isRecord2(value)) return false;
+  return isCommerceNotificationEventName(value.event) && typeof value.intentId === "string" && value.intentId.length > 0 && typeof value.dedupeKey === "string" && value.dedupeKey.length > 0 && (value.orderId === void 0 || typeof value.orderId === "string") && (value.fulfillmentId === void 0 || typeof value.fulfillmentId === "string") && (value.returnId === void 0 || typeof value.returnId === "string");
+}
+function isWebhookCommerceNotificationChange(value) {
+  if (!isRecord2(value)) return false;
+  return value.type === "notification" && value.source === "commerce-notifications" && isCommerceNotificationEventName(value.event) && isCommerceNotificationSourceCollection(value.sourceCollection) && isStringOrNumber(value.sourceId);
+}
+function matchesOptionalId(actual, expected) {
+  return actual === void 0 || expected === void 0 || actual === expected;
+}
+function isOrderChangedWebhookEvent(event) {
+  if (!isValidWebhookEvent(event) || event.operation !== "update" || event.eventType !== ORDER_CHANGED_EVENT_TYPE || !isWebhookOrderChange(event.change)) {
+    return false;
+  }
+  if (event.collection !== event.change.scope.collection) {
+    return false;
+  }
+  if (event.change.scope.kind === "collection" && event.change.moved.collection !== event.change.scope.collection) {
+    return false;
+  }
+  return true;
+}
+function isCommerceNotificationWebhookEvent(event) {
+  if (!isValidWebhookEvent(event) || event.operation !== COMMERCE_NOTIFICATION_OPERATION || event.eventType !== COMMERCE_NOTIFICATION_EVENT_TYPE || !isCommerceNotificationData(event.data) || !isCommerceNotification(event.notification)) {
+    return false;
+  }
+  const notification = event.notification;
+  const data = event.data;
+  const change = event.change;
+  const sourceCollection = data.source?.collection ?? event.collection;
+  const sourceId = data.source?.id;
+  if (!isCommerceNotificationSourceCollection(sourceCollection)) return false;
+  if (data.source !== void 0 && event.collection !== data.source.collection) {
+    return false;
+  }
+  if (change !== void 0) {
+    if (!isWebhookCommerceNotificationChange(change)) return false;
+    if (change.sourceCollection !== sourceCollection) return false;
+    if (change.event !== notification.event) return false;
+    if (!matchesOptionalId(change.sourceId, sourceId)) return false;
+  }
+  const changeSourceId = isWebhookCommerceNotificationChange(change) ? change.sourceId : void 0;
+  if (notification.event === "orderPaid" || notification.event === "orderDelivered") {
+    return sourceCollection === "orders" && typeof notification.orderId === "string" && notification.orderId.length > 0 && matchesOptionalId(data.orderId, sourceId) && matchesOptionalId(notification.orderId, sourceId) && matchesOptionalId(data.orderId, notification.orderId) && matchesOptionalId(changeSourceId, data.orderId ?? notification.orderId);
+  }
+  if (notification.event === "fulfillmentShipped") {
+    return sourceCollection === "fulfillments" && matchesOptionalId(data.fulfillmentId, sourceId) && typeof notification.fulfillmentId === "string" && notification.fulfillmentId.length > 0 && matchesOptionalId(notification.fulfillmentId, sourceId) && matchesOptionalId(data.fulfillmentId, notification.fulfillmentId) && matchesOptionalId(changeSourceId, notification.fulfillmentId);
+  }
+  if (notification.event === "returnRequested" || notification.event === "returnCompleted") {
+    return sourceCollection === "returns" && matchesOptionalId(data.returnId, sourceId) && typeof notification.returnId === "string" && notification.returnId.length > 0 && matchesOptionalId(notification.returnId, sourceId) && matchesOptionalId(data.returnId, notification.returnId) && matchesOptionalId(changeSourceId, notification.returnId);
+  }
+  return false;
+}
+function getCommerceNotificationIdempotencyKey(event) {
+  return `${event.notification.intentId}:${event.notification.dedupeKey}`;
+}
+function defineCommerceEmailConfig(config) {
+  return config;
+}
+function createCommerceEmailWebhookHandler(handlers) {
+  return async (event) => {
+    if (!isCommerceNotificationWebhookEvent(event)) {
+      await handlers.unhandled?.(event);
+      return;
+    }
+    const handler = handlers[event.notification.event];
+    if (!handler) {
+      await handlers.unhandled?.(event);
+      return;
+    }
+    await handler({
+      event,
+      idempotencyKey: getCommerceNotificationIdempotencyKey(event)
+    });
+  };
+}
+function isWebhookCollection(event, collection) {
+  return isValidWebhookEvent(event) && event.collection === collection;
+}
+function isWebhookOperation(event, operation) {
+  return isValidWebhookEvent(event) && event.operation === operation;
+}
 var CUSTOMER_PASSWORD_RESET_OPERATION = "password-reset";
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
 function hasString(value, key) {
@@ -1855,7 +1996,7 @@ function hasStringOrNumber(value, key) {
   return typeof value[key] === "string" || typeof value[key] === "number";
 }
 function isCustomerPasswordResetWebhookEvent(event) {
-  if (event.collection !== "customers" || event.operation !== CUSTOMER_PASSWORD_RESET_OPERATION || !isRecord(event.data)) {
+  if (event.collection !== "customers" || event.operation !== CUSTOMER_PASSWORD_RESET_OPERATION || !isRecord2(event.data)) {
     return false;
   }
   return hasStringOrNumber(event.data, "customerId") && hasString(event.data, "email") && hasString(event.data, "name") && hasString(event.data, "resetPasswordToken") && hasString(event.data, "resetPasswordExpiresAt");
@@ -1975,6 +2116,7 @@ var INTERNAL_COLLECTIONS = [
   "subscriptions",
   "billing-history",
   "inventory-reservations",
+  "commerce-notification-intents",
   "product-collection-items",
   "order-status-logs",
   "api-keys",
@@ -3207,7 +3349,14 @@ function buildProductListingProjection(product, variants) {
 function buildProductListingCard(item, options = {}) {
   const product = item.product;
   const groups = item.groups;
-  const primaryImage = firstMedia(product.thumbnail) ?? firstMedia(product.images ?? null) ?? null;
+  const variants = getProductListingCardVariants(item);
+  const projectedListing = buildProductListingProjection(product, variants);
+  const selectionHintVariant = getRelationID(product.listing?.selectionHintVariant) ?? projectedListing.selectionHintVariant;
+  const representativeVariant = findListingCardRepresentativeVariant(
+    variants,
+    selectionHintVariant
+  );
+  const primaryImage = firstMedia(product.thumbnail) ?? firstMedia(product.images ?? null) ?? firstMedia(representativeVariant?.thumbnail) ?? firstMedia(representativeVariant?.images) ?? firstMedia(product.listing?.primaryImage) ?? firstMedia(projectedListing.primaryImage) ?? null;
   const priceRange = aggregateListingPriceRange(groups);
   const availableForSale = groups.some(
     (group) => group.listing.availableForSale
@@ -3215,14 +3364,42 @@ function buildProductListingCard(item, options = {}) {
   const swatches = groups.length > 1 ? groups.map((group) => buildListingSwatch(product, group, options)) : [];
   return {
     id: String(product.id),
-    href: buildProductHref({ slug: product.slug }, void 0, options),
+    href: buildProductHref(
+      { slug: product.slug },
+      { listing: { selectionHintVariant } },
+      options
+    ),
     title: product.title,
+    representativeVariant,
     primaryImage,
     priceRange,
     availableForSale,
     swatches
   };
 }
+function getProductListingCardVariants(item) {
+  const productVariants = item.product.variants?.docs;
+  if (Array.isArray(productVariants) && productVariants.length > 0) {
+    return productVariants;
+  }
+  const variants = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const group of item.groups) {
+    for (const variant of group.variants) {
+      const id = getRelationID(variant.id);
+      if (id && seen.has(id)) continue;
+      if (id) seen.add(id);
+      variants.push(variant);
+    }
+  }
+  return variants;
+}
+function findListingCardRepresentativeVariant(variants, representativeVariantId) {
+  if (representativeVariantId == null) return null;
+  return variants.find(
+    (variant) => getRelationID(variant.id) === representativeVariantId
+  ) ?? null;
+}
 function aggregateListingPriceRange(groups) {
   const minPrice = minOfNullable(groups.map((g) => g.listing.minPrice));
   const maxPrice = maxOfNullable(groups.map((g) => g.listing.maxPrice));