@01.software/sdk 0.48.0 → 0.49.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @01.software/sdk
 
+## 0.49.0
+
+### Minor Changes
+
+- aef44ec: Fix SDK error guards across independently bundled entrypoints and expose the guards from the client and server entries.
+- 86f74d3: Expose immutable membership subscribe-admission snapshot fields in the generated SDK types.
+- edc790e: BREAKING (0.x minor): Checkout `paymentState.activePaymentSession.provider` can
+  now be `portone`. Consumers using `@01.software/sdk` 0.45.0, 0.46.0, or 0.46.1
+  must upgrade to the 0.49.0 release produced by this minor changeset, or later,
+  before the server exposes managed PortOne sessions; otherwise
+  `checkouts.retrieve` and `checkouts.query` throw during strict response
+  validation. SDK 0.48.0's runtime decoder already accepts `portone`, but its
+  published TypeScript `CheckoutPaymentSessionRef` remains `provider: 'toss'`, so
+  0.48.0 is not the fully compatible public-contract floor. `checkouts.create` is
+  not part of this break because the current producer does not return an active
+  PortOne session reference.
+
+  Keep custom bridge recovery on the server-only exact lookup.
+
+- fa71a21: Add a fail-closed PortOne Standard V2 Toss Payments CARD browser action with a required redirect, PG-safe payment identity, and durable single-slot retry semantics.
+- 5ea6348: Expose non-commerce API reasons through `SDKError.apiReason` and the family-aware `getSDKErrorReason` accessor while preserving strict commerce error typing.
+
+### Patch Changes
+
+- cb2a742: Clarify that idempotent commerce mutation response fields do not provide exactly-once side-effect semantics.
+- 15c1024: Synchronize generated Payload types for the internal payment-kernel result and owner-commit records without exposing those collections through a public SDK collection bucket.
+
 ## 0.48.0
 
 ### Minor Changes

package/README.md

@@ -29,7 +29,7 @@ pnpm add @01.software/sdk
 import { createClient } from '@01.software/sdk'
 
 // Server-only entry - keep Secret Key code out of browser-facing imports
-import { createServerClient } from '@01.software/sdk/server'
+import { createServerClient, isCommerceSDKError } from '@01.software/sdk/server'
 
 // Webhook only - webhook handlers
 import {
@@ -61,8 +61,8 @@ entry.
 | Import                              | Feature(s)                                                               | Install when used                                                                                          |
 | ----------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
 | `@01.software/sdk`                  | browser-safe `createClient`, commerce helpers, collection helpers, types | none                                                                                                       |
-| `@01.software/sdk/client`           | browser-safe `createClient` entry                                        | none                                                                                                       |
-| `@01.software/sdk/server`           | `createServerClient`, server-only collection, commerce, and preview APIs | none; keep `secretKey` code on the server                                                                  |
+| `@01.software/sdk/client`           | browser-safe `createClient` entry and SDK error guards                   | none                                                                                                       |
+| `@01.software/sdk/server`           | `createServerClient`, server-only APIs, and SDK error guards             | none; keep `secretKey` code on the server                                                                  |
 | `@01.software/sdk/errors`           | SDK error classes and guards                                             | none                                                                                                       |
 | `@01.software/sdk/analytics`        | browser analytics client and typed event helpers                         | none                                                                                                       |
 | `@01.software/sdk/metadata`         | SEO metadata extraction and generation helpers                           | none                                                                                                       |
@@ -92,6 +92,9 @@ Migration quick reference:
 - `createClient` remains available from `@01.software/sdk` and
   `@01.software/sdk/client`.
 - `createServerClient` must be imported from `@01.software/sdk/server`.
+- Error guards are available from the same `@01.software/sdk/client` or
+  `@01.software/sdk/server` entry as the client that throws; the root and
+  `@01.software/sdk/errors` guards also classify errors across entries.
 - React Query hooks and cache helpers must be imported from
   `@01.software/sdk/query`.
 - Product storefront cache resource helpers must be imported from
@@ -1325,10 +1328,8 @@ Treat a replayed Cart result as an operation receipt: never replace a newer
 cached Cart with a lower `revision`; retrieve when response ordering is unclear.
 
 ```typescript
-import {
-  createCommerceIdempotencyKey,
-  isCommerceSDKError,
-} from '@01.software/sdk'
+import { createCommerceIdempotencyKey } from '@01.software/sdk'
+import { isCommerceSDKError } from '@01.software/sdk/errors'
 
 const checkoutIdempotencyKey = createCommerceIdempotencyKey()
 const { checkout, checkoutToken } = await client.commerce.checkouts.create({
@@ -1369,6 +1370,24 @@ if (
   window.location.assign(portOneSession.nextAction.checkoutUrl)
 }
 
+// Standard V2 is a distinct Browser SDK capability, not a Hosted fallback.
+// Do not treat the SDK result or mobile redirect as payment finality.
+const standardPortOneSession =
+  await client.commerce.paymentSessions.createPortOne({
+    checkoutToken,
+    provider: 'portone',
+    providerOptions: { profile: 'standard_v2', paymentMethod: 'CARD' },
+    idempotencyKey: createCommerceIdempotencyKey(),
+  })
+if (
+  standardPortOneSession.presentationStatus === 'actionable' &&
+  standardPortOneSession.nextAction.type === 'portone_sdk'
+) {
+  // PortOne V2 requires its currency constant (`CURRENCY_KRW`), not ISO `KRW`.
+  // await PortOne.requestPayment(standardPortOneSession.nextAction)
+  // Always retrieve the session afterwards; Console lookup/webhook is authoritative.
+}
+
 // Browser recovery requires the parent capability.
 await client.commerce.paymentSessions.retrieve({
   paymentSessionId: paymentSession.id,
@@ -1424,6 +1443,12 @@ authoritative API response or signed webhook, then report the exact captured
 identity and Money. The create response is intentionally limited to
 `{ id, provider, providerSessionId, money }`.
 
+Custom bridge sessions intentionally remain `null` in
+`checkout.paymentState.activePaymentSession`: Checkout exposes only managed
+adapters from its closed provider vocabulary. Persist the `providerSessionId`
+returned by `custom.create` and use `custom.retrieve` with that identity as the
+supported custom-lane settlement recovery path.
+
 ```typescript
 const customSession = await server.commerce.paymentSessions.custom.create({
   provider: 'my-provider',
@@ -1491,6 +1516,38 @@ Canonical commerce error envelopes become `CommerceSDKError`. Branch on its
 stable `reason`, inspect `retryable`, and log `requestId`; a newer server reason
 is preserved as `reason: 'unknown_commerce_error'` plus `rawReason`.
 
+Non-commerce endpoints preserve their open-ended machine reason separately as
+`SDKError.apiReason`. Use `getSDKErrorReason(error)` when shared error handling
+must read either family: it returns the canonical commerce reason, the verbatim
+unknown commerce `rawReason`, or the non-commerce `apiReason`. Existing
+`details` payloads remain available for compatibility, but consumers no longer
+need to normalize `details.reason` and `details.body.reason` themselves.
+
+#### Idempotent mutation results are not exactly-once receipts
+
+No commerce mutation response field is a safe exactly-once gate for a
+non-idempotent side effect such as an operational alert, outbound webhook, or
+ledger entry. Use a consumer-owned durable claim keyed by the side effect's
+stable logical identity. The public webhook guide's
+[`processOnce`](https://docs.01.software/developers/webhooks) pattern uses a
+database unique key, queue idempotency store, or provider-safe send ledger.
+
+`custom.confirm` returns `alreadyConfirmed: true` when the session was already
+confirmed at observation time. It does not attribute the transition to the
+current call. The field is absent from the initial successful confirmation, so
+code that only interprets the response shape must test
+`'alreadyConfirmed' in result`, not `result.alreadyConfirmed === false`. That
+presence check is still not a side-effect gate: when the initial commit succeeds
+but its response is lost, a retry returns `alreadyConfirmed: true` and would
+otherwise silently miss the transition.
+
+Likewise, the `orders.cancelOrder` fields `cancelCommitted` and
+`alreadyCanceled` are domain effect dispositions, not transport replay markers.
+A same-key retry replays the cached initial 2xx body byte-for-byte and can
+therefore return the original `cancelCommitted: true` again. Neither field says
+whether the response was replayed or whether an external side effect has already
+run.
+
 ### Commerce Orders (post-placement operations)
 
 Provider-paid `orders.create`, `orders.confirmPayment`, and ordinary

package/dist/client.cjs

@@ -22,7 +22,22 @@ var client_exports = {};
 __export(client_exports, {
   Client: () => Client,
   ContentClient: () => ContentClient,
-  createClient: () => createClient
+  createClient: () => createClient,
+  isApiError: () => isApiError,
+  isAuthError: () => isAuthError,
+  isCommerceSDKError: () => isCommerceSDKError,
+  isConfigError: () => isConfigError,
+  isConflictError: () => isConflictError,
+  isGoneError: () => isGoneError,
+  isNetworkError: () => isNetworkError,
+  isNotFoundError: () => isNotFoundError,
+  isPermissionError: () => isPermissionError,
+  isRateLimitError: () => isRateLimitError,
+  isSDKError: () => isSDKError,
+  isServiceUnavailableError: () => isServiceUnavailableError,
+  isTimeoutError: () => isTimeoutError,
+  isUsageLimitError: () => isUsageLimitError,
+  isValidationError: () => isValidationError
 });
 module.exports = __toCommonJS(client_exports);
 
@@ -30,6 +45,24 @@ module.exports = __toCommonJS(client_exports);
 var import_qs_esm = require("qs-esm");
 
 // src/core/errors.ts
+var SDK_ERROR_BRAND = /* @__PURE__ */ Symbol.for("@01.software/sdk/SDKError");
+var SDK_ERROR_TYPE_BRAND = /* @__PURE__ */ Symbol.for("@01.software/sdk/SDKError.type");
+function defineSDKErrorBrand(error) {
+  Object.defineProperty(error, SDK_ERROR_BRAND, {
+    value: true,
+    enumerable: false,
+    configurable: false,
+    writable: false
+  });
+}
+function defineSDKErrorType(error, type) {
+  Object.defineProperty(error, SDK_ERROR_TYPE_BRAND, {
+    value: type,
+    enumerable: false,
+    configurable: false,
+    writable: false
+  });
+}
 var SDKError = class extends Error {
   constructor(code, message, status, details, userMessage, suggestion, requestId) {
     super(message);
@@ -40,6 +73,7 @@ var SDKError = class extends Error {
     this.userMessage = userMessage;
     this.suggestion = suggestion;
     this.requestId = requestId;
+    defineSDKErrorBrand(this);
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, new.target);
     }
@@ -60,6 +94,7 @@ var SDKError = class extends Error {
       ...this.kind !== void 0 && { kind: this.kind },
       ...this.reason !== void 0 && { reason: this.reason },
       ...this.rawReason !== void 0 && { rawReason: this.rawReason },
+      ...this.apiReason !== void 0 && { apiReason: this.apiReason },
       ...this.retryable !== void 0 && { retryable: this.retryable },
       ...this.retryAfter !== void 0 && { retryAfter: this.retryAfter }
     };
@@ -233,8 +268,16 @@ function enhanceCommerceError(error, body, headerRequestId) {
   });
   return error;
 }
+function enhanceNonCommerceError(error, reason) {
+  if (typeof reason === "string") Object.assign(error, { apiReason: reason });
+  return error;
+}
+function getSDKErrorReason(error) {
+  if (error.kind !== "commerce") return error.apiReason;
+  return error.reason === "unknown_commerce_error" ? error.rawReason : error.reason;
+}
 function isCommerceSDKError(error) {
-  if (!(error instanceof SDKError) || error.kind !== "commerce") return false;
+  if (!isSDKError(error) || error.kind !== "commerce") return false;
   if (typeof error.requestId !== "string" || typeof error.retryable !== "boolean" || error.retryAfter !== void 0 && (!Number.isSafeInteger(error.retryAfter) || error.retryAfter < 0) || typeof error.reason !== "string") {
     return false;
   }
@@ -244,12 +287,14 @@ var NetworkError = class extends SDKError {
   constructor(message, status, details, userMessage, suggestion) {
     super("NETWORK_ERROR", message, status, details, userMessage, suggestion);
     this.name = "NetworkError";
+    defineSDKErrorType(this, "NetworkError");
   }
 };
 var ValidationError = class extends SDKError {
   constructor(message, details, userMessage, suggestion, status = 400) {
     super("VALIDATION_ERROR", message, status, details, userMessage, suggestion);
     this.name = "ValidationError";
+    defineSDKErrorType(this, "ValidationError");
   }
 };
 var ApiError = class extends SDKError {
@@ -264,24 +309,28 @@ var ApiError = class extends SDKError {
       requestId
     );
     this.name = "ApiError";
+    defineSDKErrorType(this, "ApiError");
   }
 };
 var ConfigError = class extends SDKError {
   constructor(message, details, userMessage, suggestion) {
     super("CONFIG_ERROR", message, void 0, details, userMessage, suggestion);
     this.name = "ConfigError";
+    defineSDKErrorType(this, "ConfigError");
   }
 };
 var TimeoutError = class extends SDKError {
   constructor(message = "Request timed out.", details, userMessage, suggestion) {
     super("TIMEOUT_ERROR", message, 408, details, userMessage, suggestion);
     this.name = "TimeoutError";
+    defineSDKErrorType(this, "TimeoutError");
   }
 };
 var GoneError = class extends SDKError {
   constructor(message = "The requested resource is no longer available.", details, userMessage, suggestion) {
     super("GONE_ERROR", message, 410, details, userMessage, suggestion);
     this.name = "GoneError";
+    defineSDKErrorType(this, "GoneError");
   }
 };
 var ServiceUnavailableError = class extends SDKError {
@@ -296,6 +345,7 @@ var ServiceUnavailableError = class extends SDKError {
     );
     this.name = "ServiceUnavailableError";
     this.retryAfter = retryAfter;
+    defineSDKErrorType(this, "ServiceUnavailableError");
   }
 };
 var UsageLimitError = class extends SDKError {
@@ -303,6 +353,7 @@ var UsageLimitError = class extends SDKError {
     super("USAGE_LIMIT_ERROR", message, 429, details, userMessage, suggestion);
     this.name = "UsageLimitError";
     this.usage = usage;
+    defineSDKErrorType(this, "UsageLimitError");
   }
   toJSON() {
     return {
@@ -323,6 +374,7 @@ var AuthError = class extends SDKError {
       requestId
     );
     this.name = "AuthError";
+    defineSDKErrorType(this, "AuthError");
   }
 };
 var PermissionError = class extends SDKError {
@@ -337,6 +389,7 @@ var PermissionError = class extends SDKError {
       requestId
     );
     this.name = "PermissionError";
+    defineSDKErrorType(this, "PermissionError");
   }
 };
 var NotFoundError = class extends SDKError {
@@ -351,12 +404,14 @@ var NotFoundError = class extends SDKError {
       requestId
     );
     this.name = "NotFoundError";
+    defineSDKErrorType(this, "NotFoundError");
   }
 };
 var ConflictError = class extends SDKError {
   constructor(message, details, userMessage, suggestion, requestId) {
     super("conflict", message, 409, details, userMessage, suggestion, requestId);
     this.name = "ConflictError";
+    defineSDKErrorType(this, "ConflictError");
   }
 };
 var RateLimitError = class extends SDKError {
@@ -372,8 +427,64 @@ var RateLimitError = class extends SDKError {
     );
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
+    defineSDKErrorType(this, "RateLimitError");
   }
 };
+function hasBrandedSDKErrorShape(error) {
+  if (error === null || typeof error !== "object") return false;
+  const candidate = error;
+  return candidate[SDK_ERROR_BRAND] === true && typeof candidate.name === "string" && typeof candidate.code === "string" && typeof candidate.message === "string" && (candidate.status === void 0 || typeof candidate.status === "number") && (candidate.userMessage === void 0 || typeof candidate.userMessage === "string") && (candidate.suggestion === void 0 || typeof candidate.suggestion === "string") && (candidate.requestId === void 0 || typeof candidate.requestId === "string") && (candidate.kind === void 0 || candidate.kind === "commerce") && (candidate.reason === void 0 || typeof candidate.reason === "string") && (candidate.rawReason === void 0 || typeof candidate.rawReason === "string") && (candidate.apiReason === void 0 || typeof candidate.apiReason === "string") && (candidate.retryable === void 0 || typeof candidate.retryable === "boolean") && (candidate.retryAfter === void 0 || typeof candidate.retryAfter === "number") && typeof candidate.getUserMessage === "function" && typeof candidate.toJSON === "function";
+}
+function hasSDKErrorType(error, type) {
+  return hasBrandedSDKErrorShape(error) && error[SDK_ERROR_TYPE_BRAND] === type;
+}
+function isSDKError(error) {
+  return error instanceof SDKError || hasBrandedSDKErrorShape(error);
+}
+function isNetworkError(error) {
+  return error instanceof NetworkError || hasSDKErrorType(error, "NetworkError");
+}
+function isValidationError(error) {
+  if (error instanceof ValidationError || hasSDKErrorType(error, "ValidationError")) {
+    return true;
+  }
+  if (error == null || typeof error !== "object") return false;
+  const candidate = error;
+  return candidate.name === "ValidationError" && candidate.code === "VALIDATION_ERROR" && typeof candidate.message === "string" && typeof candidate.getUserMessage === "function" && typeof candidate.toJSON === "function";
+}
+function isApiError(error) {
+  return error instanceof ApiError || hasSDKErrorType(error, "ApiError");
+}
+function isConfigError(error) {
+  return error instanceof ConfigError || hasSDKErrorType(error, "ConfigError");
+}
+function isTimeoutError(error) {
+  return error instanceof TimeoutError || hasSDKErrorType(error, "TimeoutError");
+}
+function isGoneError(error) {
+  return error instanceof GoneError || hasSDKErrorType(error, "GoneError");
+}
+function isServiceUnavailableError(error) {
+  return error instanceof ServiceUnavailableError || hasSDKErrorType(error, "ServiceUnavailableError");
+}
+function isUsageLimitError(error) {
+  return error instanceof UsageLimitError || hasSDKErrorType(error, "UsageLimitError");
+}
+function isAuthError(error) {
+  return error instanceof AuthError || hasSDKErrorType(error, "AuthError");
+}
+function isPermissionError(error) {
+  return error instanceof PermissionError || hasSDKErrorType(error, "PermissionError");
+}
+function isNotFoundError(error) {
+  return error instanceof NotFoundError || hasSDKErrorType(error, "NotFoundError");
+}
+function isConflictError(error) {
+  return error instanceof ConflictError || hasSDKErrorType(error, "ConflictError");
+}
+function isRateLimitError(error) {
+  return error instanceof RateLimitError || hasSDKErrorType(error, "RateLimitError");
+}
 var createNetworkError = (message, status, details, userMessage, suggestion) => new NetworkError(message, status, details, userMessage, suggestion);
 var createValidationError = (message, details, userMessage, suggestion, status) => new ValidationError(message, details, userMessage, suggestion, status);
 var createApiError = (message, status, details, userMessage, suggestion, requestId) => new ApiError(message, status, details, userMessage, suggestion, requestId);
@@ -583,7 +694,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) : withRequestId;
+    return errorFamily === "commerce" ? enhanceCommerceError(withRequestId, parsed.body, requestId) : enhanceNonCommerceError(withRequestId, parsed.reason);
   };
   if (status === 400 || status === 422) {
     return finalize(
@@ -770,7 +881,7 @@ async function httpFetch(url, options) {
             ),
             requestId
           );
-          throw errorFamily === "commerce" ? enhanceCommerceError(usageError, parsed.body, requestId) : usageError;
+          throw errorFamily === "commerce" ? enhanceCommerceError(usageError, parsed.body, requestId) : enhanceNonCommerceError(usageError, parsed.reason);
         }
         if (response.status === 401 && onUnauthorized && customerToken && !hasRetried401 && (commerceEnvelope?.reason ?? parsed.reason) === "token_expired") {
           hasRetried401 = true;
@@ -1217,7 +1328,7 @@ async function parseApiResponse(response, endpoint2, options = {}) {
     }
     const withRequestId = attachRequestId(error, requestId);
     if (retryAfter !== void 0) Object.assign(withRequestId, { retryAfter });
-    throw options.errorFamily === "commerce" ? enhanceCommerceError(withRequestId, data, requestId) : withRequestId;
+    throw options.errorFamily === "commerce" ? enhanceCommerceError(withRequestId, data, requestId) : enhanceNonCommerceError(withRequestId, reason);
   }
   return data;
 }
@@ -1641,13 +1752,7 @@ function unwrapPayloadDoc(value) {
   return value;
 }
 function hasCanonicalNotFoundReason(error) {
-  const details = error.details;
-  if (typeof details !== "object" || details === null) return false;
-  if ("reason" in details && details.reason === "not_found") return true;
-  if (!("body" in details) || typeof details.body !== "object" || details.body === null) {
-    return false;
-  }
-  return "reason" in details.body && details.body.reason === "not_found";
+  return getSDKErrorReason(error) === "not_found";
 }
 var CommunityClient = class extends RawCustomerScopedApi {
   constructor(options) {
@@ -3253,9 +3358,77 @@ function validateRequiredReconciliation(value, allowed, resource, path) {
 function validateNextAction(value, provider, resource, path) {
   const action = record(value, resource, path);
   if (provider === "portone") {
+    if (action.type === "portone_sdk") {
+      exact(
+        action,
+        [
+          "type",
+          "version",
+          "storeId",
+          "channelKey",
+          "paymentId",
+          "orderName",
+          "totalAmount",
+          "currency",
+          "payMethod",
+          "redirectUrl"
+        ],
+        [],
+        resource,
+        path
+      );
+      if (action.version !== "v2") fail(resource, `${path}.version`, "v2");
+      for (const key of ["storeId", "channelKey"]) {
+        boundedString(action[key], 255, resource, `${path}.${key}`);
+      }
+      const paymentId = boundedString(
+        action.paymentId,
+        40,
+        resource,
+        `${path}.paymentId`
+      );
+      if (!/^[A-Za-z0-9]{6,40}$/.test(paymentId)) {
+        fail(
+          resource,
+          `${path}.paymentId`,
+          "6-40 ASCII alphanumeric characters"
+        );
+      }
+      boundedString(
+        action.orderName,
+        MAX_COMMERCE_SHORT_TEXT_LENGTH,
+        resource,
+        `${path}.orderName`
+      );
+      positiveInteger(action.totalAmount, resource, `${path}.totalAmount`);
+      if (action.currency !== "CURRENCY_KRW") {
+        fail(resource, `${path}.currency`, "CURRENCY_KRW");
+      }
+      if (action.payMethod !== "CARD")
+        fail(resource, `${path}.payMethod`, "CARD");
+      const redirectUrl = boundedString(
+        action.redirectUrl,
+        2048,
+        resource,
+        `${path}.redirectUrl`
+      );
+      try {
+        const parsed = new URL(redirectUrl);
+        const loopback = parsed.protocol === "http:" && (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1");
+        if (!loopback && parsed.protocol !== "https:" || parsed.username || parsed.password)
+          throw new Error("unsafe redirect URL");
+      } catch {
+        fail(
+          resource,
+          `${path}.redirectUrl`,
+          "HTTPS or loopback URL without embedded credentials"
+        );
+      }
+      return;
+    }
     exact(action, ["type", "checkoutUrl"], [], resource, path);
     if (action.type !== "portone_checkout") {
-      fail(resource, `${path}.type`, "portone_checkout");
+      fail(resource, `${path}.type`, "portone_checkout | portone_sdk");
     }
     const checkoutUrl = boundedString(
       action.checkoutUrl,
@@ -5218,21 +5391,11 @@ var PRODUCT_DETAIL_UNAVAILABLE_REASONS = /* @__PURE__ */ new Set([
   "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;
+  const reason = getSDKErrorReason(error);
+  if (!reason || !PRODUCT_DETAIL_UNAVAILABLE_REASONS.has(reason))
+    return void 0;
   return { found: false, reason };
 }
 var MARKET_PRICE_QUERY_UNSUPPORTED_MESSAGE = "Market listing pages do not support base price filters or price sorts.";