@cimplify/sdk 0.44.16 → 0.44.19

package/dist/chunk-QBQCMQ4F.js

@@ -0,0 +1,271 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// src/types/common.ts
+function money(value) {
+  return typeof value === "string" ? parseFloat(value) || 0 : value;
+}
+function moneyFromNumber(value) {
+  return value;
+}
+var ZERO = 0;
+var SUPPORTED_CURRENCY_CODES = /* @__PURE__ */ new Set([
+  "USD",
+  "EUR",
+  "GBP",
+  "JPY",
+  "CNY",
+  "CHF",
+  "CAD",
+  "AUD",
+  "GHS",
+  "NGN",
+  "KES",
+  "ZAR",
+  "XOF",
+  "XAF",
+  "EGP",
+  "TZS",
+  "UGX",
+  "RWF",
+  "ETB",
+  "ZMW",
+  "BWP",
+  "MUR",
+  "NAD",
+  "MWK",
+  "AOA",
+  "CDF",
+  "GMD",
+  "GNF",
+  "LRD",
+  "SLL",
+  "MZN",
+  "BIF",
+  "INR",
+  "BRL",
+  "MXN",
+  "KRW",
+  "TRY",
+  "THB",
+  "MYR",
+  "PHP",
+  "IDR",
+  "VND",
+  "SGD",
+  "HKD",
+  "TWD",
+  "AED",
+  "SAR",
+  "ILS"
+]);
+function isSupportedCurrency(code) {
+  return SUPPORTED_CURRENCY_CODES.has(code);
+}
+var warnedCurrencies = /* @__PURE__ */ new Set();
+function currencyCode(value) {
+  const normalized = value.trim().toUpperCase();
+  if (!isSupportedCurrency(normalized) && !warnedCurrencies.has(normalized)) {
+    warnedCurrencies.add(normalized);
+    console.warn(
+      `[Cimplify] Unrecognized currency code "${normalized}". It may not format correctly.`
+    );
+  }
+  return normalized;
+}
+var ErrorCode = {
+  UNKNOWN_ERROR: "UNKNOWN_ERROR",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  TIMEOUT: "TIMEOUT",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  CART_EMPTY: "CART_EMPTY",
+  CART_EXPIRED: "CART_EXPIRED",
+  CART_NOT_FOUND: "CART_NOT_FOUND",
+  ITEM_UNAVAILABLE: "ITEM_UNAVAILABLE",
+  VARIANT_NOT_FOUND: "VARIANT_NOT_FOUND",
+  VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK",
+  ADDON_REQUIRED: "ADDON_REQUIRED",
+  ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED",
+  CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED",
+  DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED",
+  CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED",
+  QUOTE_NOT_FOUND: "QUOTE_NOT_FOUND",
+  QUOTE_EXPIRED: "QUOTE_EXPIRED",
+  QUOTE_CONSUMED: "QUOTE_CONSUMED",
+  QUOTE_STORAGE_UNAVAILABLE: "QUOTE_STORAGE_UNAVAILABLE",
+  PAYMENT_FAILED: "PAYMENT_FAILED",
+  PAYMENT_CANCELLED: "PAYMENT_CANCELLED",
+  INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS",
+  CARD_DECLINED: "CARD_DECLINED",
+  INVALID_OTP: "INVALID_OTP",
+  OTP_EXPIRED: "OTP_EXPIRED",
+  AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED",
+  PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED",
+  SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE",
+  BOOKING_CONFLICT: "BOOKING_CONFLICT",
+  SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
+  OUT_OF_STOCK: "OUT_OF_STOCK",
+  INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY"
+};
+var DOCS_ERROR_BASE_URL = "https://docs.cimplify.io/reference/error-codes";
+function docsUrlForCode(code) {
+  return `${DOCS_ERROR_BASE_URL}#${code.toLowerCase().replace(/_/g, "-")}`;
+}
+var ERROR_SUGGESTIONS = {
+  UNKNOWN_ERROR: "An unexpected error occurred. Capture the request/response payload and retry with exponential backoff.",
+  NETWORK_ERROR: "Check the shopper's connection and retry. If this persists, inspect CORS, DNS, and API reachability.",
+  TIMEOUT: "The request exceeded the timeout. Retry once, then poll order status before charging again.",
+  UNAUTHORIZED: "Authentication is missing or expired. Ensure a valid access token is set and refresh the session if needed.",
+  FORBIDDEN: "The key/session lacks permission for this resource. Verify business ownership and API key scope.",
+  NOT_FOUND: "The requested resource does not exist or is not visible in this environment.",
+  VALIDATION_ERROR: "One or more fields are invalid. Validate required fields and enum values before retrying.",
+  CART_EMPTY: "The cart has no items. Redirect back to menu/catalogue and require at least one line item.",
+  CART_EXPIRED: "This cart is no longer active. Recreate a new cart and re-add shopper selections.",
+  CART_NOT_FOUND: "Cart could not be located. It may have expired or belongs to a different key/location.",
+  ITEM_UNAVAILABLE: "The selected item is unavailable at this location/time. Prompt the shopper to pick an alternative.",
+  VARIANT_NOT_FOUND: "The requested variant no longer exists. Refresh product data and require re-selection.",
+  VARIANT_OUT_OF_STOCK: "The selected variant is out of stock. Show in-stock variants and block checkout for this line.",
+  ADDON_REQUIRED: "A required add-on is missing. Ensure required modifier groups are completed before add-to-cart.",
+  ADDON_MAX_EXCEEDED: "Too many add-ons were selected. Enforce max selections client-side before submission.",
+  CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
+  DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
+  CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
+  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
+  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
+  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
+  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
+  PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
+  PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
+  INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
+  CARD_DECLINED: "Card was declined. Ask shopper to retry or switch payment method.",
+  INVALID_OTP: "Authorization code is invalid. Let shopper re-enter OTP/PIN and retry.",
+  OTP_EXPIRED: "Authorization code expired. Request a new OTP and re-submit authorization.",
+  AUTHORIZATION_FAILED: "Additional payment authorization failed. Retry authorization or change payment method.",
+  PAYMENT_ACTION_NOT_COMPLETED: "Required payment action was not completed. Resume provider flow and poll for status.",
+  SLOT_UNAVAILABLE: "Selected schedule slot is unavailable. Refresh available slots and ask shopper to reselect.",
+  BOOKING_CONFLICT: "The requested booking conflicts with an existing reservation. Pick another slot/resource.",
+  SERVICE_NOT_FOUND: "Requested service no longer exists. Refresh service catalogue and retry selection.",
+  OUT_OF_STOCK: "Inventory is depleted for this item. Remove it or reduce quantity before checkout.",
+  INSUFFICIENT_QUANTITY: "Requested quantity exceeds available inventory. Reduce quantity and retry.",
+  BUSINESS_ID_REQUIRED: "Business context could not be resolved. Verify the public key and business bootstrap call.",
+  INVALID_CART: "Cart is invalid for checkout. Sync cart state, ensure items exist, then retry.",
+  ORDER_TYPE_REQUIRED: "Order type is required. Provide one of delivery, pickup, or dine_in before checkout.",
+  NO_PAYMENT_ELEMENT: "PaymentElement is required for processCheckout(). Mount it before triggering checkout.",
+  PAYMENT_NOT_MOUNTED: "PaymentElement iframe is not mounted. Mount it in the DOM before processCheckout().",
+  AUTH_INCOMPLETE: "AuthElement has not completed authentication. Wait for AUTHENTICATED before checkout.",
+  AUTH_LOST: "Session was cleared during checkout. Re-authenticate and restart checkout safely.",
+  ALREADY_PROCESSING: "Checkout is already in progress. Disable duplicate submits until completion.",
+  CHECKOUT_NOT_READY: "Checkout elements are still initializing. Wait for readiness before submit.",
+  CANCELLED: "Checkout was cancelled. Preserve cart state and allow shopper to retry.",
+  REQUEST_TIMEOUT: "Provider call timed out. Poll payment/order status before issuing another charge attempt.",
+  POPUP_BLOCKED: "Browser blocked provider popup. Ask shopper to enable popups and retry.",
+  FX_QUOTE_FAILED: "Failed to lock FX quote. Retry currency quote or fallback to base currency."
+};
+var ERROR_HINTS = Object.fromEntries(
+  Object.entries(ERROR_SUGGESTIONS).map(([code, suggestion]) => [
+    code,
+    {
+      docs_url: docsUrlForCode(code),
+      suggestion
+    }
+  ])
+);
+var CimplifyError = class extends Error {
+  constructor(code, message, retryable = false, docs_url, suggestion) {
+    super(message);
+    this.code = code;
+    this.retryable = retryable;
+    this.docs_url = docs_url;
+    this.suggestion = suggestion;
+    this.name = "CimplifyError";
+  }
+  get userMessage() {
+    return this.message;
+  }
+};
+var IdempotencyMismatchError = class extends CimplifyError {
+  constructor(message, originalCreatedAt) {
+    super("IDEMPOTENCY_MISMATCH", message, false);
+    this.originalCreatedAt = originalCreatedAt;
+    this.name = "IdempotencyMismatchError";
+  }
+};
+function isCimplifyError(error) {
+  return error instanceof CimplifyError;
+}
+function isIdempotencyMismatchError(error) {
+  return error instanceof IdempotencyMismatchError;
+}
+function getErrorHint(code) {
+  return ERROR_HINTS[code];
+}
+function enrichError(error, options = {}) {
+  if (error instanceof IdempotencyMismatchError) {
+    return error;
+  }
+  const hint = getErrorHint(error.code);
+  const docsUrl = error.docs_url || hint?.docs_url || docsUrlForCode(error.code || ErrorCode.UNKNOWN_ERROR);
+  const suggestion = error.suggestion || hint?.suggestion;
+  let message = error.message;
+  if (options.isTestMode && !message.includes("pk_test_")) {
+    message = `${message}
+
+\u2139 Your API key is a test-mode key (pk_test_...). Verify test data/session before retrying.`;
+  }
+  const enriched = new CimplifyError(error.code, message, error.retryable, docsUrl, suggestion);
+  enriched.stack = error.stack;
+  return enriched;
+}
+function isRetryableError(error) {
+  if (isCimplifyError(error)) {
+    return error.retryable;
+  }
+  if (error instanceof Error) {
+    const msg = error.message.toLowerCase();
+    return msg.includes("network") || msg.includes("timeout") || msg.includes("fetch");
+  }
+  return false;
+}
+
+exports.CimplifyError = CimplifyError;
+exports.ERROR_HINTS = ERROR_HINTS;
+exports.ErrorCode = ErrorCode;
+exports.IdempotencyMismatchError = IdempotencyMismatchError;
+exports.ZERO = ZERO;
+exports.__privateAdd = __privateAdd;
+exports.__privateGet = __privateGet;
+exports.__privateMethod = __privateMethod;
+exports.__privateSet = __privateSet;
+exports.__privateWrapper = __privateWrapper;
+exports.__publicField = __publicField;
+exports.currencyCode = currencyCode;
+exports.enrichError = enrichError;
+exports.getErrorHint = getErrorHint;
+exports.isCimplifyError = isCimplifyError;
+exports.isIdempotencyMismatchError = isIdempotencyMismatchError;
+exports.isRetryableError = isRetryableError;
+exports.isSupportedCurrency = isSupportedCurrency;
+exports.money = money;
+exports.moneyFromNumber = moneyFromNumber;

package/dist/chunk-XPXAZXF2.mjs

@@ -0,0 +1,250 @@
+var __defProp = Object.defineProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// src/types/common.ts
+function money(value) {
+  return typeof value === "string" ? parseFloat(value) || 0 : value;
+}
+function moneyFromNumber(value) {
+  return value;
+}
+var ZERO = 0;
+var SUPPORTED_CURRENCY_CODES = /* @__PURE__ */ new Set([
+  "USD",
+  "EUR",
+  "GBP",
+  "JPY",
+  "CNY",
+  "CHF",
+  "CAD",
+  "AUD",
+  "GHS",
+  "NGN",
+  "KES",
+  "ZAR",
+  "XOF",
+  "XAF",
+  "EGP",
+  "TZS",
+  "UGX",
+  "RWF",
+  "ETB",
+  "ZMW",
+  "BWP",
+  "MUR",
+  "NAD",
+  "MWK",
+  "AOA",
+  "CDF",
+  "GMD",
+  "GNF",
+  "LRD",
+  "SLL",
+  "MZN",
+  "BIF",
+  "INR",
+  "BRL",
+  "MXN",
+  "KRW",
+  "TRY",
+  "THB",
+  "MYR",
+  "PHP",
+  "IDR",
+  "VND",
+  "SGD",
+  "HKD",
+  "TWD",
+  "AED",
+  "SAR",
+  "ILS"
+]);
+function isSupportedCurrency(code) {
+  return SUPPORTED_CURRENCY_CODES.has(code);
+}
+var warnedCurrencies = /* @__PURE__ */ new Set();
+function currencyCode(value) {
+  const normalized = value.trim().toUpperCase();
+  if (!isSupportedCurrency(normalized) && !warnedCurrencies.has(normalized)) {
+    warnedCurrencies.add(normalized);
+    console.warn(
+      `[Cimplify] Unrecognized currency code "${normalized}". It may not format correctly.`
+    );
+  }
+  return normalized;
+}
+var ErrorCode = {
+  UNKNOWN_ERROR: "UNKNOWN_ERROR",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  TIMEOUT: "TIMEOUT",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  CART_EMPTY: "CART_EMPTY",
+  CART_EXPIRED: "CART_EXPIRED",
+  CART_NOT_FOUND: "CART_NOT_FOUND",
+  ITEM_UNAVAILABLE: "ITEM_UNAVAILABLE",
+  VARIANT_NOT_FOUND: "VARIANT_NOT_FOUND",
+  VARIANT_OUT_OF_STOCK: "VARIANT_OUT_OF_STOCK",
+  ADDON_REQUIRED: "ADDON_REQUIRED",
+  ADDON_MAX_EXCEEDED: "ADDON_MAX_EXCEEDED",
+  CHECKOUT_VALIDATION_FAILED: "CHECKOUT_VALIDATION_FAILED",
+  DELIVERY_ADDRESS_REQUIRED: "DELIVERY_ADDRESS_REQUIRED",
+  CUSTOMER_INFO_REQUIRED: "CUSTOMER_INFO_REQUIRED",
+  QUOTE_NOT_FOUND: "QUOTE_NOT_FOUND",
+  QUOTE_EXPIRED: "QUOTE_EXPIRED",
+  QUOTE_CONSUMED: "QUOTE_CONSUMED",
+  QUOTE_STORAGE_UNAVAILABLE: "QUOTE_STORAGE_UNAVAILABLE",
+  PAYMENT_FAILED: "PAYMENT_FAILED",
+  PAYMENT_CANCELLED: "PAYMENT_CANCELLED",
+  INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS",
+  CARD_DECLINED: "CARD_DECLINED",
+  INVALID_OTP: "INVALID_OTP",
+  OTP_EXPIRED: "OTP_EXPIRED",
+  AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED",
+  PAYMENT_ACTION_NOT_COMPLETED: "PAYMENT_ACTION_NOT_COMPLETED",
+  SLOT_UNAVAILABLE: "SLOT_UNAVAILABLE",
+  BOOKING_CONFLICT: "BOOKING_CONFLICT",
+  SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
+  OUT_OF_STOCK: "OUT_OF_STOCK",
+  INSUFFICIENT_QUANTITY: "INSUFFICIENT_QUANTITY"
+};
+var DOCS_ERROR_BASE_URL = "https://docs.cimplify.io/reference/error-codes";
+function docsUrlForCode(code) {
+  return `${DOCS_ERROR_BASE_URL}#${code.toLowerCase().replace(/_/g, "-")}`;
+}
+var ERROR_SUGGESTIONS = {
+  UNKNOWN_ERROR: "An unexpected error occurred. Capture the request/response payload and retry with exponential backoff.",
+  NETWORK_ERROR: "Check the shopper's connection and retry. If this persists, inspect CORS, DNS, and API reachability.",
+  TIMEOUT: "The request exceeded the timeout. Retry once, then poll order status before charging again.",
+  UNAUTHORIZED: "Authentication is missing or expired. Ensure a valid access token is set and refresh the session if needed.",
+  FORBIDDEN: "The key/session lacks permission for this resource. Verify business ownership and API key scope.",
+  NOT_FOUND: "The requested resource does not exist or is not visible in this environment.",
+  VALIDATION_ERROR: "One or more fields are invalid. Validate required fields and enum values before retrying.",
+  CART_EMPTY: "The cart has no items. Redirect back to menu/catalogue and require at least one line item.",
+  CART_EXPIRED: "This cart is no longer active. Recreate a new cart and re-add shopper selections.",
+  CART_NOT_FOUND: "Cart could not be located. It may have expired or belongs to a different key/location.",
+  ITEM_UNAVAILABLE: "The selected item is unavailable at this location/time. Prompt the shopper to pick an alternative.",
+  VARIANT_NOT_FOUND: "The requested variant no longer exists. Refresh product data and require re-selection.",
+  VARIANT_OUT_OF_STOCK: "The selected variant is out of stock. Show in-stock variants and block checkout for this line.",
+  ADDON_REQUIRED: "A required add-on is missing. Ensure required modifier groups are completed before add-to-cart.",
+  ADDON_MAX_EXCEEDED: "Too many add-ons were selected. Enforce max selections client-side before submission.",
+  CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
+  DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
+  CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
+  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
+  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
+  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
+  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
+  PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
+  PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
+  INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
+  CARD_DECLINED: "Card was declined. Ask shopper to retry or switch payment method.",
+  INVALID_OTP: "Authorization code is invalid. Let shopper re-enter OTP/PIN and retry.",
+  OTP_EXPIRED: "Authorization code expired. Request a new OTP and re-submit authorization.",
+  AUTHORIZATION_FAILED: "Additional payment authorization failed. Retry authorization or change payment method.",
+  PAYMENT_ACTION_NOT_COMPLETED: "Required payment action was not completed. Resume provider flow and poll for status.",
+  SLOT_UNAVAILABLE: "Selected schedule slot is unavailable. Refresh available slots and ask shopper to reselect.",
+  BOOKING_CONFLICT: "The requested booking conflicts with an existing reservation. Pick another slot/resource.",
+  SERVICE_NOT_FOUND: "Requested service no longer exists. Refresh service catalogue and retry selection.",
+  OUT_OF_STOCK: "Inventory is depleted for this item. Remove it or reduce quantity before checkout.",
+  INSUFFICIENT_QUANTITY: "Requested quantity exceeds available inventory. Reduce quantity and retry.",
+  BUSINESS_ID_REQUIRED: "Business context could not be resolved. Verify the public key and business bootstrap call.",
+  INVALID_CART: "Cart is invalid for checkout. Sync cart state, ensure items exist, then retry.",
+  ORDER_TYPE_REQUIRED: "Order type is required. Provide one of delivery, pickup, or dine_in before checkout.",
+  NO_PAYMENT_ELEMENT: "PaymentElement is required for processCheckout(). Mount it before triggering checkout.",
+  PAYMENT_NOT_MOUNTED: "PaymentElement iframe is not mounted. Mount it in the DOM before processCheckout().",
+  AUTH_INCOMPLETE: "AuthElement has not completed authentication. Wait for AUTHENTICATED before checkout.",
+  AUTH_LOST: "Session was cleared during checkout. Re-authenticate and restart checkout safely.",
+  ALREADY_PROCESSING: "Checkout is already in progress. Disable duplicate submits until completion.",
+  CHECKOUT_NOT_READY: "Checkout elements are still initializing. Wait for readiness before submit.",
+  CANCELLED: "Checkout was cancelled. Preserve cart state and allow shopper to retry.",
+  REQUEST_TIMEOUT: "Provider call timed out. Poll payment/order status before issuing another charge attempt.",
+  POPUP_BLOCKED: "Browser blocked provider popup. Ask shopper to enable popups and retry.",
+  FX_QUOTE_FAILED: "Failed to lock FX quote. Retry currency quote or fallback to base currency."
+};
+var ERROR_HINTS = Object.fromEntries(
+  Object.entries(ERROR_SUGGESTIONS).map(([code, suggestion]) => [
+    code,
+    {
+      docs_url: docsUrlForCode(code),
+      suggestion
+    }
+  ])
+);
+var CimplifyError = class extends Error {
+  constructor(code, message, retryable = false, docs_url, suggestion) {
+    super(message);
+    this.code = code;
+    this.retryable = retryable;
+    this.docs_url = docs_url;
+    this.suggestion = suggestion;
+    this.name = "CimplifyError";
+  }
+  get userMessage() {
+    return this.message;
+  }
+};
+var IdempotencyMismatchError = class extends CimplifyError {
+  constructor(message, originalCreatedAt) {
+    super("IDEMPOTENCY_MISMATCH", message, false);
+    this.originalCreatedAt = originalCreatedAt;
+    this.name = "IdempotencyMismatchError";
+  }
+};
+function isCimplifyError(error) {
+  return error instanceof CimplifyError;
+}
+function isIdempotencyMismatchError(error) {
+  return error instanceof IdempotencyMismatchError;
+}
+function getErrorHint(code) {
+  return ERROR_HINTS[code];
+}
+function enrichError(error, options = {}) {
+  if (error instanceof IdempotencyMismatchError) {
+    return error;
+  }
+  const hint = getErrorHint(error.code);
+  const docsUrl = error.docs_url || hint?.docs_url || docsUrlForCode(error.code || ErrorCode.UNKNOWN_ERROR);
+  const suggestion = error.suggestion || hint?.suggestion;
+  let message = error.message;
+  if (options.isTestMode && !message.includes("pk_test_")) {
+    message = `${message}
+
+\u2139 Your API key is a test-mode key (pk_test_...). Verify test data/session before retrying.`;
+  }
+  const enriched = new CimplifyError(error.code, message, error.retryable, docsUrl, suggestion);
+  enriched.stack = error.stack;
+  return enriched;
+}
+function isRetryableError(error) {
+  if (isCimplifyError(error)) {
+    return error.retryable;
+  }
+  if (error instanceof Error) {
+    const msg = error.message.toLowerCase();
+    return msg.includes("network") || msg.includes("timeout") || msg.includes("fetch");
+  }
+  return false;
+}
+
+export { CimplifyError, ERROR_HINTS, ErrorCode, IdempotencyMismatchError, ZERO, __privateAdd, __privateGet, __privateMethod, __privateSet, __privateWrapper, __publicField, currencyCode, enrichError, getErrorHint, isCimplifyError, isIdempotencyMismatchError, isRetryableError, isSupportedCurrency, money, moneyFromNumber };

package/dist/{chunk-7NML226B.mjs → chunk-XZPO5GEM.mjs}

@@ -1,4 +1,5 @@
-import { CimplifyError, currencyCode, ErrorCode, enrichError, isPaymentStatusRequiresAction, normalizeStatusResponse, isPaymentStatusSuccess, isPaymentStatusFailure, getErrorHint } from './chunk-6AZZ6AOF.mjs';
+import { isPaymentStatusRequiresAction, normalizeStatusResponse, isPaymentStatusSuccess, isPaymentStatusFailure } from './chunk-NRT6PVW5.mjs';
+import { CimplifyError, currencyCode, ErrorCode, enrichError, getErrorHint } from './chunk-XPXAZXF2.mjs';
 
 // src/types/result.ts
 function ok(value) {

package/dist/client-B_Ei3ENB.d.mts

@@ -0,0 +1,86 @@
+import { C as CimplifyClient } from './client-Dh-bHyhU.mjs';
+import { C as CreateAppOptions, A as AppHandle } from './server-CWpUlLOQ.mjs';
+
+/**
+ * Test client + fixtures.
+ *
+ * Spins up an in-process Hono mock and a typed SDK client wired to it
+ * via the SDK's first-class `fetch` injection — no global mutation,
+ * no port, no MSW. Tests in the same module run in parallel safely.
+ *
+ *   import { createTestClient, fixtures } from "@cimplify/sdk/testing";
+ *
+ *   const handle = createTestClient({ seed: "fashion" });
+ *   try {
+ *     const item = await fixtures.addFirstProduct(handle.client);
+ *     expect(item.product.name).toBeTruthy();
+ *   } finally {
+ *     handle.dispose();
+ *   }
+ */
+
+interface TestClientHandle {
+    /** Typed SDK client routed to the in-process mock. */
+    client: CimplifyClient;
+    /** Direct access to the mock — registry, deps, request shortcut. */
+    mock: AppHandle;
+    /** Reset all in-memory state (cart, orders, sessions). Token persists. */
+    reset: () => void;
+    /** Drop all state + session. Always safe to call multiple times. */
+    dispose: () => void;
+}
+/**
+ * Create an in-process mock + a typed SDK client wired to it.
+ *
+ * Each call gets its OWN session token — tests in the same module
+ * run safely in parallel because there's no shared global state.
+ */
+declare function createTestClient(options?: CreateAppOptions): TestClientHandle;
+interface ProductSummary {
+    id: string;
+    name: string;
+    slug: string;
+    type?: string;
+}
+interface AddFirstProductOptions {
+    /** Pick a specific product by slug instead of "first". */
+    slug?: string;
+    /** Auto-pick the first available variant if the product has variants. Default true. */
+    withVariant?: boolean;
+}
+interface AddFirstProductResult {
+    product: ProductSummary;
+    variantId?: string;
+}
+/**
+ * Pre-baked fixture functions for common test setup. Use these to keep
+ * tests focused on the assertion you care about, not on plumbing.
+ */
+declare const fixtures: {
+    /**
+     * Add the first available product (or a named one) to the cart.
+     * Picks the first variant if the product has variants.
+     */
+    addFirstProduct(client: CimplifyClient, opts?: AddFirstProductOptions): Promise<AddFirstProductResult>;
+    /** A minimal valid customer object for checkout. */
+    customer(overrides?: Partial<{
+        name: string;
+        email: string;
+        phone: string;
+    }>): {
+        name: string;
+        email: string;
+        phone: string;
+    };
+    /**
+     * Run the full guest auth flow (request OTP → verify) and return
+     * the new session token. The mock's permissive auth mode echoes
+     * the code in `request_otp`, so we don't need to read it.
+     */
+    authenticate(client: CimplifyClient, contact?: string, code?: string): Promise<{
+        token: string;
+        customerId: string;
+    }>;
+};
+
+export { type AddFirstProductOptions as A, type ProductSummary as P, type TestClientHandle as T, type AddFirstProductResult as a, createTestClient as c, fixtures as f };