@01.software/sdk 0.49.0 → 0.51.0

package/dist/index.cjs

@@ -130,8 +130,6 @@ __export(src_exports, {
   projectProductToListingShape: () => projectProductToListingShape,
   resolveFeaturedImagePointer: () => resolveFeaturedImagePointer,
   resolveProductDisplayMedia: () => resolveProductDisplayMedia,
-  resolveProductGallery: () => resolveProductGallery,
-  resolveProductMedia: () => resolveProductMedia,
   resolveProductSelection: () => resolveProductSelection,
   resolveProductSelectionFromMatrix: () => resolveProductSelectionFromMatrix,
   resolveProductSelectionMedia: () => resolveProductSelectionMedia,
@@ -243,6 +241,7 @@ var COMMERCE_ERROR_CODES = [
   "payment_session_not_cancelable",
   "payment_session_conflict",
   "provider_identity_mismatch",
+  "managed_refund_attestation_forbidden",
   "payment_method_unavailable",
   "provider_unavailable",
   "lock_timeout",
@@ -785,11 +784,11 @@ function parseRetryAfter(response) {
     permitsAutomaticRetry: seconds <= MAX_AUTOMATIC_RETRY_AFTER_SECONDS
   };
 }
-function mapResponseToError(status, parsed, details, requestId, retryAfter, errorFamily) {
+function mapResponseToError(status, parsed, details, requestId, retryAfter, canonicalCommerceError) {
   const errorDetails = {
     ...details,
     ...parsed.errors && { errors: parsed.errors },
-    ...errorFamily !== "commerce" && parsed.body && { body: parsed.body }
+    ...!canonicalCommerceError && parsed.body && { body: parsed.body }
   };
   const suggestion = getParsedErrorSuggestion(status, parsed);
   const finalize = (error) => {
@@ -797,7 +796,7 @@ function mapResponseToError(status, parsed, details, requestId, retryAfter, erro
     if (retryAfter !== void 0) {
       Object.assign(withRequestId, { retryAfter });
     }
-    return errorFamily === "commerce" ? enhanceCommerceError(withRequestId, parsed.body, requestId) : enhanceNonCommerceError(withRequestId, parsed.reason);
+    return canonicalCommerceError ? enhanceCommerceError(withRequestId, parsed.body, requestId) : enhanceNonCommerceError(withRequestId, parsed.reason);
   };
   if (status === 400 || status === 422) {
     return finalize(
@@ -903,6 +902,7 @@ async function httpFetch(url, options) {
     retry,
     onUnauthorized,
     errorFamily,
+    typedCommerceErrorReasons,
     ...requestInit
   } = options || {};
   const baseUrl = resolveApiUrl(apiUrl);
@@ -956,7 +956,8 @@ async function httpFetch(url, options) {
       });
       if (!response.ok) {
         const parsed = await parseErrorBody(response);
-        const commerceEnvelope = errorFamily === "commerce" ? parseCommerceErrorEnvelope(parsed.body, requestId) : void 0;
+        const canonicalCommerceError = errorFamily === "commerce" || typeof parsed.reason === "string" && typedCommerceErrorReasons?.includes(parsed.reason) === true;
+        const commerceEnvelope = canonicalCommerceError ? parseCommerceErrorEnvelope(parsed.body, requestId) : void 0;
         if (isUsageLimitExceededResponse(response)) {
           const limit = parseInt(
             response.headers.get("X-Usage-Limit") || "0",
@@ -984,7 +985,7 @@ async function httpFetch(url, options) {
             ),
             requestId
           );
-          throw errorFamily === "commerce" ? enhanceCommerceError(usageError, parsed.body, requestId) : enhanceNonCommerceError(usageError, parsed.reason);
+          throw canonicalCommerceError ? enhanceCommerceError(usageError, parsed.body, requestId) : enhanceNonCommerceError(usageError, parsed.reason);
         }
         if (response.status === 401 && onUnauthorized && customerToken && !hasRetried401 && (commerceEnvelope?.reason ?? parsed.reason) === "token_expired") {
           hasRetried401 = true;
@@ -1009,7 +1010,7 @@ async function httpFetch(url, options) {
           details,
           requestId,
           retryAfter.seconds,
-          errorFamily
+          canonicalCommerceError
         );
         const method2 = (requestInit.method || "GET").toUpperCase();
         const isTerminal = error instanceof RateLimitError || error instanceof UsageLimitError;
@@ -1187,15 +1188,15 @@ var HttpClient = class {
       throw err;
     }
   }
-  buildUrl(endpoint2, options) {
-    if (!options) return endpoint2;
+  buildUrl(endpoint, options) {
+    if (!options) return endpoint;
     const { fallbackLocale, ...rest } = options;
     const queryOptions = fallbackLocale === void 0 ? rest : {
       ...rest,
       "fallback-locale": fallbackLocale === false ? "none" : fallbackLocale
     };
     const queryString = (0, import_qs_esm.stringify)(queryOptions, { addQueryPrefix: true });
-    return queryString ? `${endpoint2}${queryString}` : endpoint2;
+    return queryString ? `${endpoint}${queryString}` : endpoint;
   }
   assertJsonResponse(response) {
     const contentType = response.headers.get("content-type");
@@ -1344,39 +1345,39 @@ var ReadOnlyCollectionClient = class extends HttpClient {
   from(collection) {
     return new ReadOnlyCollectionQueryBuilder(this, collection);
   }
-  async requestFind(endpoint2, options) {
-    const url = this.buildUrl(endpoint2, options);
+  async requestFind(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
     const response = await this.fetchWithTracking(url, {
       ...this.defaultOptions,
       method: "GET"
     });
     return this.parseFindResponse(response);
   }
-  async requestFindEndpoint(endpoint2, data) {
-    const response = await this.fetchWithTracking(endpoint2, {
+  async requestFindEndpoint(endpoint, data) {
+    const response = await this.fetchWithTracking(endpoint, {
       ...this.defaultOptions,
       method: "POST",
       body: data ? JSON.stringify(data) : void 0
     });
     return this.parseFindResponse(response);
   }
-  async requestFindEndpointGet(endpoint2) {
-    const response = await this.fetchWithTracking(endpoint2, {
+  async requestFindEndpointGet(endpoint) {
+    const response = await this.fetchWithTracking(endpoint, {
       ...this.defaultOptions,
       method: "GET"
     });
     return this.parseFindResponse(response);
   }
-  async requestFindById(endpoint2, options) {
-    const url = this.buildUrl(endpoint2, options);
+  async requestFindById(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
     const response = await this.fetchWithTracking(url, {
       ...this.defaultOptions,
       method: "GET"
     });
     return this.parseDocumentResponse(response);
   }
-  async requestCount(endpoint2, options) {
-    const url = this.buildUrl(endpoint2, options);
+  async requestCount(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
     const response = await this.fetchWithTracking(url, {
       ...this.defaultOptions,
       method: "GET"
@@ -1386,7 +1387,7 @@ var ReadOnlyCollectionClient = class extends HttpClient {
 };
 
 // src/core/api/parse-response.ts
-async function parseApiResponse(response, endpoint2, options = {}) {
+async function parseApiResponse(response, endpoint, options = {}) {
   if (response.status === 204 || response.headers.get("content-length") === "0") {
     return void 0;
   }
@@ -1395,7 +1396,7 @@ async function parseApiResponse(response, endpoint2, options = {}) {
     parsed = await response.json();
   } catch {
     throw createApiError(
-      `Invalid JSON response from ${endpoint2}`,
+      `Invalid JSON response from ${endpoint}`,
       response.status,
       void 0,
       "Server returned an invalid response.",
@@ -1445,6 +1446,7 @@ async function parseApiResponse(response, endpoint2, options = {}) {
 
 // ../../internal/http-contracts/src/index.ts
 var operationBrand = /* @__PURE__ */ Symbol("sdk-http-operation");
+var PORTONE_STANDARD_ACTION_CAPABILITIES_MEDIA_TYPE = "application/vnd.01software.portone-action-capabilities.v1+json";
 var operation = (collection, method, path, errorFamily) => Object.freeze({
   [operationBrand]: true,
   collection,
@@ -1453,6 +1455,10 @@ var operation = (collection, method, path, errorFamily) => Object.freeze({
   ...errorFamily && { errorFamily }
 });
 var strictCommerceOperation = (collection, method, path) => operation(collection, method, path, "commerce");
+var selectiveCommerceOperation = (collection, method, path, typedCommerceErrorReasons) => Object.freeze({
+  ...operation(collection, method, path),
+  typedCommerceErrorReasons: Object.freeze([...typedCommerceErrorReasons])
+});
 var COMMERCE_ENDPOINT_OPERATIONS = {
   products: {
     detail: operation("products", "get", "/detail"),
@@ -1484,7 +1490,12 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
     confirmPayment: operation("orders", "post", "/confirm-payment"),
     byPayment: operation("orders", "get", "/by-payment"),
     cancel: operation("orders", "post", "/cancel"),
-    resolveCancelRefund: operation("orders", "post", "/resolve-cancel-refund"),
+    resolveCancelRefund: selectiveCommerceOperation(
+      "orders",
+      "post",
+      "/resolve-cancel-refund",
+      ["managed_refund_attestation_forbidden"]
+    ),
     checkout: strictCommerceOperation("orders", "post", "/checkout"),
     createFulfillment: operation("orders", "post", "/create-fulfillment"),
     updateFulfillment: operation("orders", "post", "/update-fulfillment")
@@ -1555,6 +1566,16 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
         "payment-sessions",
         "post",
         "/server/confirm"
+      ),
+      findPortOne: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/portone/find"
+      ),
+      reconcilePortOne: strictCommerceOperation(
+        "payment-sessions",
+        "post",
+        "/server/portone/reconcile"
       )
     },
     custom: {
@@ -1574,12 +1595,26 @@ var COMMERCE_ENDPOINT_OPERATIONS = {
     validate: operation("discounts", "post", "/validate")
   }
 };
+var portOneStandardActionCapabilityOperations = /* @__PURE__ */ new Set([
+  COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.create,
+  COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.retrieve,
+  COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.create,
+  COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.retrieve
+]);
 var MEMBERSHIP_ENDPOINT_OPERATIONS = {
   subscribe: operation(null, "post", "/memberships/subscribe"),
   cancel: operation(null, "post", "/memberships/:id/cancel"),
   me: operation(null, "get", "/memberships/me")
 };
+var EMBEDDED_ADMIN_ENDPOINT_OPERATIONS = {
+  show: operation("tenants", "get", "/embedded-admin-app"),
+  configure: operation("tenants", "patch", "/embedded-admin-app"),
+  disable: operation("tenants", "delete", "/embedded-admin-app")
+};
 var EVENTS_ENDPOINT_OPERATIONS = {
+  events: {
+    convertSchedule: operation("events", "post", "/:id/schedule")
+  },
   occurrences: {
     range: operation("event-occurrences", "get", "/range"),
     admissionAvailability: operation(
@@ -1620,46 +1655,51 @@ function resolveOperationMethod(descriptor) {
 }
 
 // src/core/api/endpoints.ts
-var endpoint = (method, path) => ({ method, path });
 var sharedEndpoint = (descriptor) => descriptor;
-function resolveOperationMethod2(descriptor) {
-  return "collection" in descriptor ? resolveOperationMethod(descriptor) : descriptor.method;
-}
 function resolveOperationErrorFamily(descriptor) {
-  return "collection" in descriptor ? descriptor.errorFamily : void 0;
-}
-function resolveOperationPath2(descriptor, options) {
-  if ("collection" in descriptor) {
-    return resolveOperationPath(descriptor, options);
-  }
-  const query = options?.query?.toString().replace(/^\?/, "");
-  return query ? `${descriptor.path}?${query}` : descriptor.path;
+  return descriptor.errorFamily;
 }
 var COMMERCE_ENDPOINTS = {
   products: {
-    detail: endpoint("GET", "/api/products/detail"),
-    detailCatalog: endpoint("GET", "/api/products/detail/catalog"),
-    listingGroups: endpoint("GET", "/api/products/listing-groups"),
-    listingGroupsCatalog: endpoint(
-      "GET",
-      "/api/products/listing-groups/catalog"
+    detail: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.products.detail),
+    detailCatalog: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.detailCatalog
+    ),
+    listingGroups: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.listingGroups
+    ),
+    listingGroupsCatalog: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsCatalog
+    ),
+    // The manifest keeps the GET read and the POST body-query apart; this
+    // semantic name has always resolved to the GET one.
+    listingGroupsQuery: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsQueryGet
+    ),
+    listingGroupsQueryCatalog: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.listingGroupsQueryCatalog
+    ),
+    stockCheck: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.stockCheck
     ),
-    listingGroupsQuery: endpoint("GET", "/api/products/listing-groups/query"),
-    listingGroupsQueryCatalog: endpoint(
-      "GET",
-      "/api/products/listing-groups/query/catalog"
+    stockSnapshot: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.products.stockSnapshot
     ),
-    stockCheck: endpoint("POST", "/api/products/stock-check"),
-    stockSnapshot: endpoint("GET", "/api/products/stock"),
-    upsert: endpoint("POST", "/api/products/upsert")
+    upsert: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.products.upsert)
   },
   orders: {
-    update: endpoint("POST", "/api/orders/update"),
-    byPayment: endpoint("GET", "/api/orders/by-payment"),
-    cancel: endpoint("POST", "/api/orders/cancel"),
-    resolveCancelRefund: endpoint("POST", "/api/orders/resolve-cancel-refund"),
-    createFulfillment: endpoint("POST", "/api/orders/create-fulfillment"),
-    updateFulfillment: endpoint("POST", "/api/orders/update-fulfillment")
+    update: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.update),
+    byPayment: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.byPayment),
+    cancel: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.cancel),
+    resolveCancelRefund: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.orders.resolveCancelRefund
+    ),
+    createFulfillment: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.orders.createFulfillment
+    ),
+    updateFulfillment: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.orders.updateFulfillment
+    )
   },
   checkouts: {
     create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.orders.checkout),
@@ -1671,18 +1711,21 @@ var COMMERCE_ENDPOINTS = {
     }
   },
   returns: {
-    create: endpoint("POST", "/api/returns/create"),
-    update: endpoint("POST", "/api/returns/update"),
-    returnRefund: endpoint("POST", "/api/returns/return-refund")
+    create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.returns.create),
+    update: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.returns.update),
+    returnRefund: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.returns.returnRefund
+    )
   },
   fulfillmentOrders: {
-    prepare: endpoint(
-      "POST",
-      "/api/fulfillment-orders/prepare-fulfillment-order"
+    prepare: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.fulfillmentOrders.prepare
     )
   },
   fulfillments: {
-    bulkImport: endpoint("POST", "/api/fulfillments/bulk-import")
+    bulkImport: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.fulfillments.bulkImport
+    )
   },
   carts: {
     create: sharedEndpoint(COMMERCE_ENDPOINT_OPERATIONS.carts.create),
@@ -1747,42 +1790,21 @@ var COMMERCE_ENDPOINTS = {
       ),
       confirm: sharedEndpoint(
         COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.confirm
+      ),
+      findPortOne: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.findPortOne
+      ),
+      reconcilePortOne: sharedEndpoint(
+        COMMERCE_ENDPOINT_OPERATIONS.paymentSessions.server.reconcilePortOne
       )
     }
   },
   shippingPolicies: {
-    calculate: endpoint("POST", "/api/shipping-policies/calculate")
+    calculate: sharedEndpoint(
+      COMMERCE_ENDPOINT_OPERATIONS.shippingPolicies.calculate
+    )
   }
 };
-function isCommerceEndpointDescriptor(value) {
-  if (!value || typeof value !== "object") return false;
-  const candidate = value;
-  return typeof candidate.method === "string" && typeof candidate.path === "string";
-}
-function flattenEndpointPaths(value) {
-  if (isCommerceEndpointDescriptor(value)) return [resolveOperationPath2(value)];
-  if (!value || typeof value !== "object") return [];
-  return Object.values(value).flatMap((entry) => flattenEndpointPaths(entry));
-}
-function flattenEndpointDescriptors(value) {
-  if (isCommerceEndpointDescriptor(value)) return [value];
-  if (!value || typeof value !== "object") return [];
-  return Object.values(value).flatMap(
-    (entry) => flattenEndpointDescriptors(entry)
-  );
-}
-var COMMERCE_ENDPOINT_PATHS = flattenEndpointPaths(COMMERCE_ENDPOINTS);
-var COMMERCE_ENDPOINT_DESCRIPTORS = flattenEndpointDescriptors(COMMERCE_ENDPOINTS);
-var MEMBERSHIP_ENDPOINTS = {
-  subscribe: "/api/memberships/subscribe",
-  cancel: (id) => `/api/memberships/${id}/cancel`,
-  me: "/api/memberships/me"
-};
-var MEMBERSHIP_ENDPOINT_PATHS = [
-  MEMBERSHIP_ENDPOINTS.subscribe,
-  MEMBERSHIP_ENDPOINTS.cancel(":id"),
-  MEMBERSHIP_ENDPOINTS.me
-];
 
 // src/core/api/customer-scoped-api.ts
 var CustomerScopedTransport = class {
@@ -1803,10 +1825,10 @@ var CustomerScopedTransport = class {
     this.onUnauthorized = options.onUnauthorized;
     this.onRequestId = options.onRequestId;
   }
-  async request(endpoint2, options) {
+  async request(endpoint, options) {
     const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
     try {
-      const response = await httpFetch(endpoint2, {
+      const response = await httpFetch(endpoint, {
         method: options.method,
         apiUrl: this.apiUrl,
         publishableKey: this.publishableKey,
@@ -1820,7 +1842,7 @@ var CustomerScopedTransport = class {
         ...options.errorFamily && { errorFamily: options.errorFamily }
       });
       this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint2, {
+      return parseApiResponse(response, endpoint, {
         errorFamily: options.errorFamily
       });
     } catch (err) {
@@ -1834,12 +1856,12 @@ var CustomerScopedApi = class {
   constructor(apiName, options) {
     this.transport = new CustomerScopedTransport(apiName, options);
   }
-  requestEndpoint(endpoint2, body, options) {
-    return this.transport.request(resolveOperationPath2(endpoint2, options), {
-      method: resolveOperationMethod2(endpoint2),
+  requestEndpoint(endpoint, body, options) {
+    return this.transport.request(resolveOperationPath(endpoint, options), {
+      method: resolveOperationMethod(endpoint),
       body,
       headers: options?.headers,
-      errorFamily: resolveOperationErrorFamily(endpoint2)
+      errorFamily: resolveOperationErrorFamily(endpoint)
     });
   }
 };
@@ -1847,8 +1869,8 @@ var RawCustomerScopedApi = class {
   constructor(apiName, options) {
     this.transport = new CustomerScopedTransport(apiName, options);
   }
-  request(endpoint2, options) {
-    return this.transport.request(endpoint2, options);
+  request(endpoint, options) {
+    return this.transport.request(endpoint, options);
   }
 };
 
@@ -1923,11 +1945,11 @@ var CommunityClient = class extends RawCustomerScopedApi {
     if (params.page !== void 0) urlParams.set("page", String(params.page));
     return `/api/comments/public?${urlParams.toString()}`;
   }
-  async execute(endpoint2, method, body) {
-    return this.request(endpoint2, { method, body });
+  async execute(endpoint, method, body) {
+    return this.request(endpoint, { method, body });
   }
-  async executeDoc(endpoint2, method, body) {
-    const response = await this.execute(endpoint2, method, body);
+  async executeDoc(endpoint, method, body) {
+    const response = await this.execute(endpoint, method, body);
     return unwrapPayloadDoc(response);
   }
   createPost(params) {
@@ -2193,8 +2215,8 @@ var CommunityClient = class extends RawCustomerScopedApi {
 
 // src/core/content/content-client.ts
 var PublicContentApi = class extends RawCustomerScopedApi {
-  get(endpoint2) {
-    return this.request(endpoint2, { method: "GET" });
+  get(endpoint) {
+    return this.request(endpoint, { method: "GET" });
   }
 };
 function appendCommonParams(search, options, defaultSort) {
@@ -2375,6 +2397,9 @@ function nullableString(value, resource, path) {
     fail(resource, path, "string or null");
   }
 }
+function nullableNonEmptyString(value, resource, path) {
+  if (value !== null) string(value, resource, path);
+}
 function cartLineQuantity(value, resource, path) {
   const quantity = positiveInteger(value, resource, path);
   if (quantity > MAX_CART_LINE_QUANTITY) {
@@ -2884,8 +2909,8 @@ function validatePublicOrderItem(value, resource, path) {
     validateReference(item.variant, resource, `${path}.variant`);
   }
   string(item.productTitle, resource, `${path}.productTitle`);
-  nullableString(item.variantTitle, resource, `${path}.variantTitle`);
-  nullableString(item.sku, resource, `${path}.sku`);
+  nullableNonEmptyString(item.variantTitle, resource, `${path}.variantTitle`);
+  nullableNonEmptyString(item.sku, resource, `${path}.sku`);
   validateAdmissions(item.admissions, resource, `${path}.admissions`);
   const quantity = positiveInteger(item.quantity, resource, `${path}.quantity`);
   const unitPrice = safeMinor(
@@ -3136,8 +3161,8 @@ function validateCheckoutItem(value, resource, path) {
   validateReference(item.product, resource, `${path}.product`);
   validateReference(item.variant, resource, `${path}.variant`);
   string(item.productTitle, resource, `${path}.productTitle`);
-  nullableString(item.variantTitle, resource, `${path}.variantTitle`);
-  nullableString(item.sku, resource, `${path}.sku`);
+  nullableNonEmptyString(item.variantTitle, resource, `${path}.variantTitle`);
+  nullableNonEmptyString(item.sku, resource, `${path}.sku`);
   validateAdmissions(item.admissions, resource, `${path}.admissions`);
   cartLineQuantity(item.quantity, resource, `${path}.quantity`);
   const unitPrice = safeMinor(
@@ -3469,11 +3494,21 @@ function validateNextAction(value, provider, resource, path) {
   const action = record(value, resource, path);
   if (provider === "portone") {
     if (action.type === "portone_sdk") {
+      const hasCancelable = "cancelable" in action;
+      const hasRetryPolicy = "retryPolicy" in action;
+      if (hasCancelable !== hasRetryPolicy) {
+        fail(
+          resource,
+          path,
+          "exact released action or exact negotiated capability action"
+        );
+      }
       exact(
         action,
         [
           "type",
           "version",
+          ...hasCancelable ? ["cancelable", "retryPolicy"] : [],
           "storeId",
           "channelKey",
           "paymentId",
@@ -3488,6 +3523,11 @@ function validateNextAction(value, provider, resource, path) {
         path
       );
       if (action.version !== "v2") fail(resource, `${path}.version`, "v2");
+      if (hasCancelable && action.cancelable !== false)
+        fail(resource, `${path}.cancelable`, "false");
+      if (hasRetryPolicy && action.retryPolicy !== "same_action_only") {
+        fail(resource, `${path}.retryPolicy`, "same_action_only");
+      }
       for (const key of ["storeId", "channelKey"]) {
         boundedString(action[key], 255, resource, `${path}.${key}`);
       }
@@ -3534,6 +3574,10 @@ function validateNextAction(value, provider, resource, path) {
           "HTTPS or loopback URL without embedded credentials"
         );
       }
+      if (!hasCancelable) {
+        action.cancelable = false;
+        action.retryPolicy = "same_action_only";
+      }
       return;
     }
     exact(action, ["type", "checkoutUrl"], [], resource, path);
@@ -4268,8 +4312,8 @@ var CartApi = class extends CustomerScopedApi {
   endpoint(key) {
     return this.serverTransport ? COMMERCE_ENDPOINTS.carts.server[key] : COMMERCE_ENDPOINTS.carts[key];
   }
-  execute(endpoint2, body, idempotencyKey) {
-    return this.requestEndpoint(endpoint2, body, {
+  execute(endpoint, body, idempotencyKey) {
+    return this.requestEndpoint(endpoint, body, {
       ...idempotencyKey && {
         headers: { "X-Idempotency-Key": idempotencyKey }
       }
@@ -4286,26 +4330,26 @@ var CartApi = class extends CustomerScopedApi {
     );
   }
   mine(params = {}) {
-    const endpoint2 = this.endpoint("mine");
-    return this.execute(endpoint2, params).then(
+    const endpoint = this.endpoint("mine");
+    return this.execute(endpoint, params).then(
       (value) => validateCartMineResult(value)
     );
   }
   merge(params) {
     const { idempotencyKey, ...body } = params;
     assertCommerceIdempotencyKey(idempotencyKey);
-    const endpoint2 = this.endpoint("merge");
-    return this.execute(endpoint2, body, idempotencyKey).then(
+    const endpoint = this.endpoint("merge");
+    return this.execute(endpoint, body, idempotencyKey).then(
       (value) => validateCartMergeResult(value)
     );
   }
   addItem(params) {
     return this.mutate(this.endpoint("addItem"), params);
   }
-  mutate(endpoint2, params) {
+  mutate(endpoint, params) {
     const { idempotencyKey, ...body } = params;
     assertCommerceIdempotencyKey(idempotencyKey);
-    return this.execute(endpoint2, body, idempotencyKey).then(
+    return this.execute(endpoint, body, idempotencyKey).then(
       (value) => validateCartMutationResult(value)
     );
   }
@@ -4331,8 +4375,8 @@ var CheckoutApi = class extends CustomerScopedApi {
   constructor(options) {
     super("CheckoutApi", { ...options, requiresCredential: false });
   }
-  post(endpoint2, body, idempotencyKey) {
-    return this.requestEndpoint(endpoint2, body, {
+  post(endpoint, body, idempotencyKey) {
+    return this.requestEndpoint(endpoint, body, {
       ...idempotencyKey && {
         headers: { "X-Idempotency-Key": idempotencyKey }
       }
@@ -4399,11 +4443,15 @@ var PaymentSessionApi = class extends CustomerScopedApi {
     super("PaymentSessionApi", { ...options, requiresCredential: false });
     this.serverTransport = Boolean(options.secretKey);
   }
-  post(endpoint2, body, idempotencyKey) {
-    return this.requestEndpoint(endpoint2, body, {
-      ...idempotencyKey && {
-        headers: { "X-Idempotency-Key": idempotencyKey }
+  post(endpoint, body, idempotencyKey, negotiateStandardActionCapabilities = false) {
+    const headers = {
+      ...idempotencyKey && { "X-Idempotency-Key": idempotencyKey },
+      ...negotiateStandardActionCapabilities && {
+        Accept: PORTONE_STANDARD_ACTION_CAPABILITIES_MEDIA_TYPE
       }
+    };
+    return this.requestEndpoint(endpoint, body, {
+      ...Object.keys(headers).length > 0 && { headers }
     });
   }
   async paymentSession(result, expectedProvider) {
@@ -4428,40 +4476,41 @@ var PaymentSessionApi = class extends CustomerScopedApi {
       this.post(
         this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.create : COMMERCE_ENDPOINTS.paymentSessions.create,
         body,
-        idempotencyKey
+        idempotencyKey,
+        body.providerOptions.profile === "standard_v2"
       ),
       "portone"
     );
   }
   retrieve(params) {
-    const endpoint2 = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.retrieve : COMMERCE_ENDPOINTS.paymentSessions.retrieve;
+    const endpoint = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.retrieve : COMMERCE_ENDPOINTS.paymentSessions.retrieve;
     return this.paymentSession(
-      this.post(endpoint2, params),
+      this.post(endpoint, params),
       "toss"
     );
   }
   retrievePortOne(params) {
-    const endpoint2 = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.retrieve : COMMERCE_ENDPOINTS.paymentSessions.retrieve;
+    const endpoint = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.retrieve : COMMERCE_ENDPOINTS.paymentSessions.retrieve;
     return this.paymentSession(
-      this.post(endpoint2, params),
+      this.post(endpoint, params, void 0, true),
       "portone"
     );
   }
   cancel(params) {
     const { idempotencyKey, ...body } = params;
     assertCommerceIdempotencyKey(idempotencyKey);
-    const endpoint2 = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.cancel : COMMERCE_ENDPOINTS.paymentSessions.cancel;
+    const endpoint = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.cancel : COMMERCE_ENDPOINTS.paymentSessions.cancel;
     return this.paymentSession(
-      this.post(endpoint2, body, idempotencyKey),
+      this.post(endpoint, body, idempotencyKey),
       "toss"
     );
   }
   cancelPortOne(params) {
     const { idempotencyKey, ...body } = params;
     assertCommerceIdempotencyKey(idempotencyKey);
-    const endpoint2 = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.cancel : COMMERCE_ENDPOINTS.paymentSessions.cancel;
+    const endpoint = this.serverTransport ? COMMERCE_ENDPOINTS.paymentSessions.server.cancel : COMMERCE_ENDPOINTS.paymentSessions.cancel;
     return this.paymentSession(
-      this.post(endpoint2, body, idempotencyKey),
+      this.post(endpoint, body, idempotencyKey),
       "portone"
     );
   }
@@ -4540,9 +4589,9 @@ function resolveVariantImageItems(variant, poolById) {
       if (pooled) resolved.push(pooled);
       continue;
     }
-    const mediaId2 = getMediaId(entry);
-    if (mediaId2) {
-      const pooled = poolById.get(mediaId2);
+    const mediaId = getMediaId(entry);
+    if (mediaId) {
+      const pooled = poolById.get(mediaId);
       if (pooled) {
         resolved.push(pooled);
       }
@@ -4733,11 +4782,11 @@ function getFirstMediaId(values) {
   }
   return null;
 }
-function inProductMediaPool(product, mediaId2) {
-  if (mediaId2 == null) return null;
+function inProductMediaPool(product, mediaId) {
+  if (mediaId == null) return null;
   const images = Array.isArray(product?.images) ? product.images : [];
   for (const image of images) {
-    if (extractEntityId(image) === mediaId2) return mediaId2;
+    if (extractEntityId(image) === mediaId) return mediaId;
   }
   return null;
 }
@@ -6318,8 +6367,8 @@ function isProductUpsertFieldValidationErrorBody(value) {
 
 // src/core/commerce/commerce-client.ts
 var BrowserCommerceApi = class extends CustomerScopedApi {
-  requestEndpoint(endpoint2, body, options) {
-    return super.requestEndpoint(endpoint2, body, options);
+  requestEndpoint(endpoint, body, options) {
+    return super.requestEndpoint(endpoint, body, options);
   }
 };
 var CommerceClient = class {
@@ -6519,11 +6568,11 @@ var EventsClient = class {
       { useCustomerAuth: false }
     );
   }
-  async execute(endpoint2, method, body, options = {}) {
+  async execute(endpoint, method, body, options = {}) {
     const useCustomerAuth = options.useCustomerAuth === true;
     const token = useCustomerAuth ? typeof this.customerToken === "function" ? this.customerToken() : this.customerToken : void 0;
     try {
-      const response = await httpFetch(endpoint2, {
+      const response = await httpFetch(endpoint, {
         method,
         apiUrl: this.apiUrl,
         publishableKey: this.publishableKey,
@@ -6532,7 +6581,7 @@ var EventsClient = class {
         ...body !== void 0 && { body: JSON.stringify(body) }
       });
       this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint2);
+      return parseApiResponse(response, endpoint);
     } catch (err) {
       const id = err instanceof SDKError ? err.requestId ?? null : null;
       this.onRequestId?.(id);
@@ -6790,13 +6839,106 @@ function mergeProductDetailWithStock(catalog, snapshot) {
   };
 }
 
+// src/core/webhook/validation.ts
+function isValidWebhookEventData(data) {
+  if (typeof data !== "object" || data === null) return false;
+  const event = data;
+  return typeof event.collection === "string" && typeof event.operation === "string" && event.operation.length > 0 && typeof event.data === "object" && event.data !== null;
+}
+
+// src/core/webhook/receiver.ts
+async function verifySignature(rawBody, secret, signature, timestamp2, deliveryId) {
+  const encoder = new TextEncoder();
+  const signedPrefix = encoder.encode(`${timestamp2}.${deliveryId}.`);
+  const signedPayload = new Uint8Array(signedPrefix.length + rawBody.length);
+  signedPayload.set(signedPrefix);
+  signedPayload.set(rawBody, signedPrefix.length);
+  const key = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["verify"]
+  );
+  if (signature.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(signature)) {
+    return false;
+  }
+  const sigBytes = new Uint8Array(
+    (signature.match(/.{2}/g) ?? []).map((byte) => parseInt(byte, 16))
+  );
+  return crypto.subtle.verify("HMAC", key, sigBytes, signedPayload);
+}
+function timestampIsFresh(timestamp2, toleranceSeconds) {
+  if (!/^\d+$/.test(timestamp2)) return false;
+  const timestampMs = Number(timestamp2);
+  if (!Number.isFinite(timestampMs)) return false;
+  const skewMs = Math.abs(Date.now() - timestampMs);
+  return skewMs <= toleranceSeconds * 1e3;
+}
+var MAX_TOLERANCE_SECONDS = 86400;
+function toleranceIsValid(toleranceSeconds) {
+  return typeof toleranceSeconds === "number" && Number.isFinite(toleranceSeconds) && toleranceSeconds >= 0 && toleranceSeconds <= MAX_TOLERANCE_SECONDS;
+}
+async function processWebhookRequest(request, handler, verify) {
+  try {
+    const rawBody = new Uint8Array(await request.arrayBuffer());
+    const verificationFailure = await verify?.(rawBody);
+    if (verificationFailure) return verificationFailure;
+    const body = JSON.parse(new TextDecoder().decode(rawBody));
+    if (!isValidWebhookEventData(body)) {
+      return new Response(
+        JSON.stringify({ error: "Invalid webhook event format" }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    await handler(body);
+    return new Response(
+      JSON.stringify({ success: true, message: "Webhook processed" }),
+      { status: 200, headers: { "Content-Type": "application/json" } }
+    );
+  } catch (error) {
+    console.error("Webhook processing error:", error);
+    return new Response(JSON.stringify({ error: "Internal server error" }), {
+      status: 500,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
+}
+async function handleSignedWebhook(request, handler, options) {
+  const secret = options?.secret;
+  const configuredTolerance = options?.toleranceSeconds;
+  const toleranceSeconds = configuredTolerance ?? 300;
+  if (typeof secret !== "string" || secret.trim().length === 0) {
+    return new Response(
+      JSON.stringify({ error: "Webhook signing secret is not configured" }),
+      { status: 500, headers: { "Content-Type": "application/json" } }
+    );
+  }
+  if (!toleranceIsValid(toleranceSeconds)) {
+    return new Response(
+      JSON.stringify({ error: "Webhook signature tolerance is not valid" }),
+      { status: 500, headers: { "Content-Type": "application/json" } }
+    );
+  }
+  return processWebhookRequest(request, handler, async (rawBody) => {
+    const signature = request.headers.get("x-webhook-signature") || "";
+    const timestamp2 = request.headers.get("x-webhook-timestamp") || "";
+    const deliveryId = request.headers.get("x-webhook-delivery-id") || "";
+    const valid = Boolean(timestamp2 && deliveryId) && timestampIsFresh(timestamp2, toleranceSeconds) && await verifySignature(rawBody, secret, signature, timestamp2, deliveryId);
+    if (!valid) {
+      return new Response(
+        JSON.stringify({ error: "Invalid webhook signature" }),
+        { status: 401, headers: { "Content-Type": "application/json" } }
+      );
+    }
+  });
+}
+
 // 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;
+  return isValidWebhookEventData(data);
 }
 var COMMERCE_NOTIFICATION_OPERATION = "notification";
 var COMMERCE_NOTIFICATION_EVENTS = [
@@ -6808,7 +6950,9 @@ var COMMERCE_NOTIFICATION_EVENTS = [
   "returnApproved",
   "returnRejected",
   "returnCanceled",
-  "returnCompleted"
+  "returnCompleted",
+  "paymentReconciliationRequired",
+  "paymentRefundRequiresAttention"
 ];
 function isStringOrNumber(value) {
   return typeof value === "string" || typeof value === "number";
@@ -6838,18 +6982,25 @@ function isCommerceNotificationEventName(value) {
   return typeof value === "string" && COMMERCE_NOTIFICATION_EVENTS.includes(value);
 }
 function isCommerceNotificationSourceCollection(value) {
-  return value === "orders" || value === "fulfillments" || value === "returns";
+  return value === "orders" || value === "fulfillments" || value === "returns" || value === "payment-sessions" || value === "payment-refund-attempts";
 }
 function isCommerceNotificationData(value) {
   if (!isRecord(value)) return false;
   if (value.source !== void 0 && (!isRecord(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");
+  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") && (value.paymentSessionId === void 0 || typeof value.paymentSessionId === "string") && (value.checkoutId === void 0 || typeof value.checkoutId === "string") && (value.refundAttemptId === void 0 || typeof value.refundAttemptId === "string") && (value.reason === void 0 || typeof value.reason === "string") && (value.observedAt === void 0 || typeof value.observedAt === "string") && (value.providerObject === void 0 || isRecord(value.providerObject) && typeof value.providerObject.provider === "string" && (value.providerObject.kind === "payment" || value.providerObject.kind === "refund") && typeof value.providerObject.id === "string") && (value.money === void 0 || isRecord(value.money) && Number.isSafeInteger(value.money.amountMinor) && Number(value.money.amountMinor) > 0 && typeof value.money.currency === "string");
 }
 function isCommerceNotification(value) {
   if (!isRecord(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");
+  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") && (value.paymentSessionId === void 0 || typeof value.paymentSessionId === "string") && (value.refundAttemptId === void 0 || typeof value.refundAttemptId === "string");
+}
+function isPaymentIncidentNotificationData(value, event) {
+  const reconciliation = event === "paymentReconciliationRequired";
+  const expectedCollection = reconciliation ? "payment-sessions" : "payment-refund-attempts";
+  const expectedStatus = reconciliation ? "reconciliation_required" : "requires_attention";
+  const expectedReason = reconciliation ? "orderless_capture" : "local_commit_ambiguous";
+  return value.source?.collection === expectedCollection && typeof value.source.id === "string" && value.source.id.length > 0 && typeof value.paymentSessionId === "string" && value.paymentSessionId.length > 0 && isRecord(value.providerObject) && typeof value.providerObject.provider === "string" && value.providerObject.provider.length > 0 && (value.providerObject.kind === "payment" || value.providerObject.kind === "refund") && typeof value.providerObject.id === "string" && value.providerObject.id.length > 0 && isRecord(value.money) && Number.isSafeInteger(value.money.amountMinor) && Number(value.money.amountMinor) > 0 && typeof value.money.currency === "string" && value.money.currency.length > 0 && value.status === expectedStatus && value.reason === expectedReason && typeof value.observedAt === "string" && value.observedAt.length > 0 && !Number.isNaN(Date.parse(value.observedAt)) && (value.checkoutId === void 0 || typeof value.checkoutId === "string" && value.checkoutId.length > 0) && (value.orderId === void 0 || typeof value.orderId === "string" && value.orderId.length > 0) && (reconciliation ? value.source.id === value.paymentSessionId && value.providerObject.kind === "payment" && value.refundAttemptId === void 0 : typeof value.refundAttemptId === "string" && value.refundAttemptId.length > 0 && value.source.id === value.refundAttemptId);
 }
 function isWebhookCommerceNotificationChange(value) {
   if (!isRecord(value)) return false;
@@ -6890,6 +7041,15 @@ function isCommerceNotificationWebhookEvent(event) {
     if (!matchesOptionalId(change.sourceId, sourceId)) return false;
   }
   const changeSourceId = isWebhookCommerceNotificationChange(change) ? change.sourceId : void 0;
+  if (notification.event === "paymentReconciliationRequired" || notification.event === "paymentRefundRequiresAttention") {
+    if (!isPaymentIncidentNotificationData(data, notification.event)) {
+      return false;
+    }
+    const incidentData = data;
+    const expectedCollection = notification.event === "paymentReconciliationRequired" ? "payment-sessions" : "payment-refund-attempts";
+    const notificationSourceId = notification.event === "paymentReconciliationRequired" ? notification.paymentSessionId : notification.refundAttemptId;
+    return sourceCollection === expectedCollection && typeof notification.paymentSessionId === "string" && notification.paymentSessionId === incidentData.paymentSessionId && typeof notificationSourceId === "string" && notificationSourceId === incidentData.source.id && matchesOptionalId(changeSourceId, incidentData.source.id);
+  }
   if (notification.event === "orderPaid" || notification.event === "orderCanceled" || 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);
   }
@@ -6958,80 +7118,8 @@ function createCustomerAuthWebhookHandler(handlers) {
     await handlers.unhandled?.(event);
   };
 }
-async function verifySignature(payload, secret, signature, timestamp2, deliveryId) {
-  const encoder = new TextEncoder();
-  const key = await crypto.subtle.importKey(
-    "raw",
-    encoder.encode(secret),
-    { name: "HMAC", hash: "SHA-256" },
-    false,
-    ["verify"]
-  );
-  if (signature.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(signature)) {
-    return false;
-  }
-  const sigBytes = new Uint8Array(
-    (signature.match(/.{2}/g) ?? []).map((byte) => parseInt(byte, 16))
-  );
-  return crypto.subtle.verify(
-    "HMAC",
-    key,
-    sigBytes,
-    encoder.encode(`${timestamp2}.${deliveryId}.${payload}`)
-  );
-}
-function timestampIsFresh(timestamp2, toleranceSeconds) {
-  if (!/^\d+$/.test(timestamp2)) return false;
-  const timestampMs = Number(timestamp2);
-  if (!Number.isFinite(timestampMs)) return false;
-  const skewMs = Math.abs(Date.now() - timestampMs);
-  return skewMs <= toleranceSeconds * 1e3;
-}
 async function handleWebhook(request, handler, options) {
-  try {
-    const rawBody = await request.text();
-    if (options?.secret) {
-      const signature = request.headers.get("x-webhook-signature") || "";
-      const timestamp2 = request.headers.get("x-webhook-timestamp") || "";
-      const deliveryId = request.headers.get("x-webhook-delivery-id") || "";
-      const toleranceSeconds = options.toleranceSeconds ?? 300;
-      const valid = Boolean(timestamp2 && deliveryId) && timestampIsFresh(timestamp2, toleranceSeconds) && await verifySignature(
-        rawBody,
-        options.secret,
-        signature,
-        timestamp2,
-        deliveryId
-      );
-      if (!valid) {
-        return new Response(
-          JSON.stringify({ error: "Invalid webhook signature" }),
-          { status: 401, headers: { "Content-Type": "application/json" } }
-        );
-      }
-    } else {
-      console.warn(
-        "[@01.software/sdk] Webhook signature verification is disabled. Set { secret } in handleWebhook() options to enable HMAC-SHA256 verification."
-      );
-    }
-    const body = JSON.parse(rawBody);
-    if (!isValidWebhookEvent(body)) {
-      return new Response(
-        JSON.stringify({ error: "Invalid webhook event format" }),
-        { status: 400, headers: { "Content-Type": "application/json" } }
-      );
-    }
-    await handler(body);
-    return new Response(
-      JSON.stringify({ success: true, message: "Webhook processed" }),
-      { status: 200, headers: { "Content-Type": "application/json" } }
-    );
-  } catch (error) {
-    console.error("Webhook processing error:", error);
-    return new Response(JSON.stringify({ error: "Internal server error" }), {
-      status: 500,
-      headers: { "Content-Type": "application/json" }
-    });
-  }
+  return handleSignedWebhook(request, handler, options);
 }
 function createTypedWebhookHandler(collection, handler) {
   return async (event) => {
@@ -7071,6 +7159,7 @@ var INTERNAL_COLLECTIONS = [
   "payment-event-inbox",
   "payment-refund-attempts",
   "portone-payment-interactions",
+  "commerce-payment-webhook-routes",
   "commerce-notification-intents",
   "commerce-idempotency-records",
   "product-collection-items",
@@ -7111,7 +7200,6 @@ var COLLECTIONS = [
   "brands",
   "customer-profiles",
   "customer-profile-stats",
-  "discounts",
   "shipping-policies",
   "shipping-zones",
   "documents",
@@ -7187,6 +7275,9 @@ var SERVER_ONLY_COLLECTIONS = [
   "cart-items",
   "checkouts",
   "checkout-items",
+  // Raw discount definitions require a server credential. Browser discount
+  // validation is exposed through the shaped POST /api/discounts/validate path.
+  "discounts",
   "draft-orders",
   "draft-order-items",
   "posts",
@@ -7352,160 +7443,6 @@ var RealtimeConnection = class {
   }
 };
 
-// src/utils/product-media.ts
-function mediaPointerOptionValues(values) {
-  return (values ?? []).filter((value) => value != null && value !== "").map((value) => ({
-    swatch: {
-      type: "media",
-      mediaItemId: value
-    }
-  }));
-}
-function resolveProductMedia(input) {
-  const resolved = resolveProductSelectionMedia({
-    ...input,
-    selectedVariant: input.selectedVariant ?? (input.variantFeaturedMediaItemId ? { images: [input.variantFeaturedMediaItemId] } : null),
-    selectedOptionValues: input.selectedOptionValues ?? mediaPointerOptionValues(input.selectedOptionValueMediaItemIds)
-  });
-  if (resolved.source !== "none") {
-    return {
-      ...resolved,
-      source: resolved.source === "variant_media_selected" ? "variant_featured" : resolved.source
-    };
-  }
-  const display = resolveProductDisplayMedia({
-    productMediaPool: input.productMediaPool
-  });
-  return {
-    primaryImage: display.primaryImage,
-    images: display.images,
-    source: display.source
-  };
-}
-
-// src/utils/product-gallery.ts
-function mediaId(value) {
-  if (typeof value === "string" || typeof value === "number") {
-    return String(value);
-  }
-  if (typeof value === "object" && value !== null && "id" in value) {
-    const id = value.id;
-    if (typeof id === "string" || typeof id === "number") return String(id);
-  }
-  return null;
-}
-function relationshipIds(values) {
-  if (!Array.isArray(values)) return [];
-  return values.map((value) => mediaId(value)).filter((value) => Boolean(value));
-}
-function buildPoolById2(pool) {
-  const poolById = /* @__PURE__ */ new Map();
-  for (const item of pool) {
-    const id = mediaId(item);
-    if (id) poolById.set(id, item);
-  }
-  return poolById;
-}
-function mediaSetItemsInPool(mediaSet, poolById) {
-  const seen = /* @__PURE__ */ new Set();
-  const items = [];
-  const primaryId = mediaId(mediaSet.primaryMediaItemId);
-  if (primaryId) {
-    const primary = poolById.get(primaryId);
-    if (primary) {
-      seen.add(primaryId);
-      items.push(primary);
-    }
-  }
-  for (const itemId of relationshipIds(mediaSet.items)) {
-    if (seen.has(itemId)) continue;
-    const item = poolById.get(itemId);
-    if (!item) continue;
-    seen.add(itemId);
-    items.push(item);
-  }
-  return items;
-}
-function resolveLegacyMediaSet(input) {
-  if (!Array.isArray(input.mediaSets)) return null;
-  const pool = input.productMediaPool ?? input.pool ?? [];
-  const poolById = buildPoolById2(pool);
-  const selectedVariantId = mediaId(input.selectedVariantId);
-  if (selectedVariantId) {
-    const exactSet = input.mediaSets.find(
-      (set) => set.matchType === "exact-variant" && relationshipIds(set.variantIds).includes(selectedVariantId)
-    );
-    if (exactSet) {
-      const images = mediaSetItemsInPool(exactSet, poolById);
-      if (images.length > 0) {
-        return {
-          primaryImage: images[0] ?? null,
-          images,
-          source: "exact_variant_set"
-        };
-      }
-    }
-  }
-  const selectedOptionValueIds = new Set(
-    relationshipIds(input.selectedOptionValueIds)
-  );
-  const optionSetMatches = input.mediaSets.filter((set) => set.matchType === "option-values").map((set) => {
-    const optionValueIds = relationshipIds(set.optionValueIds);
-    if (optionValueIds.length === 0) return null;
-    if (!optionValueIds.every((id) => selectedOptionValueIds.has(id))) {
-      return null;
-    }
-    const images = mediaSetItemsInPool(set, poolById);
-    if (images.length === 0) return null;
-    return { optionValueCount: optionValueIds.length, images };
-  }).filter(
-    (match) => Boolean(match)
-  ).sort((a, b) => b.optionValueCount - a.optionValueCount);
-  if (optionSetMatches.length > 0) {
-    const images = optionSetMatches[0].images;
-    return {
-      primaryImage: images[0] ?? null,
-      images,
-      source: "option_value_set"
-    };
-  }
-  const defaultSet = input.mediaSets.find((set) => set.matchType === "default");
-  if (defaultSet) {
-    const images = mediaSetItemsInPool(defaultSet, poolById);
-    if (images.length > 0) {
-      return {
-        primaryImage: images[0] ?? null,
-        images,
-        source: "default_set"
-      };
-    }
-  }
-  return {
-    primaryImage: null,
-    images: [],
-    source: "none"
-  };
-}
-function resolveProductGallery(input) {
-  const selectedVariantId = mediaId(input.selectedVariantId);
-  const selectedOptionValueIds = relationshipIds(input.selectedOptionValueIds);
-  const selection = resolveProductSelectionMedia({
-    ...input,
-    productMediaPool: input.productMediaPool ?? input.pool ?? null,
-    selectedVariant: input.selectedVariant ?? (selectedVariantId ? { id: selectedVariantId } : null),
-    selectedOptionValues: input.selectedOptionValues ?? selectedOptionValueIds.map((id) => ({ id }))
-  });
-  if (selection.source !== "none") {
-    return selection;
-  }
-  const legacyResolved = resolveLegacyMediaSet(input);
-  if (legacyResolved && legacyResolved.source !== "none") return legacyResolved;
-  return resolveProductDisplayMedia({
-    productMediaPool: input.productMediaPool ?? input.pool ?? null,
-    featuredImage: input.featuredImage
-  });
-}
-
 // src/utils/image.ts
 var IMAGE_SIZES = [200, 400, 800, 1200, 1600];
 function imageSizeCandidates(sizes) {
@@ -7637,7 +7574,7 @@ function createAnalytics(config) {
     }, destroy() {
     } };
   }
-  const endpoint2 = config.endpoint ?? `${resolveApiUrl()}/api/analytics/collect`;
+  const endpoint = config.endpoint ?? `${resolveApiUrl()}/api/analytics/collect`;
   const respectDnt = config.respectDnt !== false;
   function isDntActive() {
     if (!respectDnt) return false;
@@ -7678,10 +7615,10 @@ function createAnalytics(config) {
     try {
       if (typeof navigator.sendBeacon === "function") {
         const blob = new Blob([body], { type: "text/plain" });
-        const sent = navigator.sendBeacon(endpoint2, blob);
+        const sent = navigator.sendBeacon(endpoint, blob);
         if (sent) return;
       }
-      fetch(endpoint2, {
+      fetch(endpoint, {
         method: "POST",
         keepalive: true,
         headers: { "Content-Type": "application/json" },