@tiendanube/nube-sdk-helper 0.0.1

package/dist/index.js

@@ -0,0 +1,373 @@
+// src/lib/instance.ts
+var registeredInstance;
+function readGlobalInstance() {
+  return typeof self !== "undefined" ? self.__SDK_INSTANCE__ : void 0;
+}
+function setNubeInstance(nube) {
+  registeredInstance = nube;
+}
+function getNubeInstance() {
+  const instance2 = registeredInstance ?? readGlobalInstance();
+  if (!instance2) {
+    throw new Error(
+      "NubeSDK instance not registered. Call setNubeInstance(nube) at the start of your App(nube) entry point."
+    );
+  }
+  return instance2;
+}
+function clearNubeInstance() {
+  registeredInstance = void 0;
+}
+
+// src/lib/browser.ts
+var instance = null;
+var browser = new Proxy({}, {
+  get(_, prop) {
+    if (instance === null) {
+      instance = getNubeInstance().getBrowserAPIs();
+    }
+    return instance[prop];
+  }
+});
+function navigate(route) {
+  browser.navigate(route);
+}
+function clearBrowserCache() {
+  instance = null;
+}
+
+// src/lib/ui.ts
+var ui = Object.freeze({
+  // Helpers for common components
+  showToast(message, variant = "info") {
+    const toast = {
+      type: "toastRoot",
+      variant,
+      children: [{ type: "toastTitle", children: message }]
+    };
+    getNubeInstance().render("corner_top_right", toast);
+  },
+  // Clear slot
+  clear(slot) {
+    getNubeInstance().clearSlot(slot);
+  },
+  render(slot, component) {
+    getNubeInstance().render(slot, component);
+  },
+  // Render the same component across multiple slots in a single call.
+  renderAll(slots, component) {
+    const nube = getNubeInstance();
+    for (const slot of slots) {
+      nube.render(slot, component);
+    }
+  }
+});
+
+// src/lib/events.ts
+function onEvent(event, listener) {
+  const nube = getNubeInstance();
+  nube.on(event, listener);
+  return () => nube.off(event, listener);
+}
+function toastOn(event, message, variant) {
+  const listener = ((state) => {
+    const text = typeof message === "function" ? message(state) : message;
+    ui.showToast(text, variant);
+  });
+  return onEvent(event, listener);
+}
+
+// src/lib/getters.ts
+function getCurrentState() {
+  return getNubeInstance().getState();
+}
+function getAppData() {
+  return self.__APP_DATA__;
+}
+var cachedScriptURL;
+function getScriptURL() {
+  if (!cachedScriptURL) {
+    cachedScriptURL = Object.freeze(new URL(self.__APP_DATA__.script));
+  }
+  return cachedScriptURL;
+}
+function getScriptSearchParams() {
+  return getScriptURL().searchParams;
+}
+function getScriptParam(key) {
+  return getScriptSearchParams().get(key);
+}
+
+// src/internal/primitives.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function isPlainObject(value) {
+  return isObject(value) && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
+}
+
+// src/lib/guards/address.ts
+function isAddress(value) {
+  return isPlainObject(value) && typeof value.zipcode === "string" && (value.first_name === null || typeof value.first_name === "string") && (value.last_name === null || typeof value.last_name === "string") && (value.address === null || typeof value.address === "string") && (value.number === null || typeof value.number === "string") && (value.floor === null || typeof value.floor === "string") && (value.locality === null || typeof value.locality === "string") && (value.city === null || typeof value.city === "string") && (value.state === null || typeof value.state === "string") && (value.country === null || typeof value.country === "string") && (value.phone === null || typeof value.phone === "string");
+}
+function isShippingAddress(value) {
+  return isPlainObject(value) && typeof value.zipcode === "string" && (value.first_name === null || typeof value.first_name === "string") && (value.last_name === null || typeof value.last_name === "string") && (value.address === null || typeof value.address === "string") && (value.number === null || typeof value.number === "string") && (value.floor === null || typeof value.floor === "string") && (value.locality === null || typeof value.locality === "string") && (value.city === null || typeof value.city === "string") && (value.state === null || typeof value.state === "string") && (value.country === null || typeof value.country === "string") && (value.phone === null || typeof value.phone === "string") && (value.between_street === null || typeof value.between_street === "string") && (value.reference === null || typeof value.reference === "string");
+}
+function isBillingAddress(value) {
+  return isPlainObject(value) && typeof value.zipcode === "string" && (value.first_name === null || typeof value.first_name === "string") && (value.last_name === null || typeof value.last_name === "string") && (value.address === null || typeof value.address === "string") && (value.number === null || typeof value.number === "string") && (value.floor === null || typeof value.floor === "string") && (value.locality === null || typeof value.locality === "string") && (value.city === null || typeof value.city === "string") && (value.state === null || typeof value.state === "string") && (value.country === null || typeof value.country === "string") && (value.phone === null || typeof value.phone === "string") && (value.id_number === null || typeof value.id_number === "string") && (value.customer_type === null || typeof value.customer_type === "string") && (value.business_name === null || typeof value.business_name === "string") && (value.trade_name === null || typeof value.trade_name === "string") && (value.state_registration === null || typeof value.state_registration === "string") && (value.fiscal_regime === null || typeof value.fiscal_regime === "string") && (value.invoice_use === null || typeof value.invoice_use === "string") && (value.document_type === null || typeof value.document_type === "string") && (value.business_activity === null || typeof value.business_activity === "string");
+}
+
+// src/lib/guards/cart.ts
+function isCart(value) {
+  return isPlainObject(value) && typeof value.id === "string" && isPlainObject(value.validation) && typeof value.validation.status === "string" && Array.isArray(value.items) && isPlainObject(value.prices) && typeof value.prices.subtotal === "number" && typeof value.prices.total === "number" && isPlainObject(value.coupon);
+}
+function isCartItem(value) {
+  return isPlainObject(value) && typeof value.id === "number" && typeof value.name === "string" && typeof value.price === "string" && typeof value.quantity === "number" && typeof value.free_shipping === "boolean" && typeof value.product_id === "number" && typeof value.variant_id === "number" && typeof value.thumbnail === "string" && typeof value.variant_values === "string" && typeof value.url === "string" && typeof value.is_ahora_12_eligible === "boolean";
+}
+function isCartValidationSuccess(validation) {
+  return validation.status === "success";
+}
+function isCartValidationPending(validation) {
+  return validation.status === "pending";
+}
+function isCartValidationFail(validation) {
+  return validation.status === "fail";
+}
+
+// src/lib/guards/components.ts
+function isNubeComponent(value) {
+  return typeof value === "string" || isPlainObject(value) && typeof value.type === "string";
+}
+function hasProductList(data) {
+  return isObject(data) && "products" in data && Array.isArray(data.products);
+}
+function hasSections(data) {
+  return isObject(data) && "sections" in data && Array.isArray(data.sections);
+}
+function isSectionWithProducts(item) {
+  return isObject(item) && "products" in item && Array.isArray(item.products);
+}
+function hasSingleProduct(data) {
+  return isObject(data) && "product" in data && isObject(data.product) && "id" in data.product;
+}
+
+// src/lib/guards/domain.ts
+function isStore(value) {
+  return isPlainObject(value) && typeof value.id === "number" && typeof value.name === "string" && typeof value.domain === "string" && typeof value.currency === "string" && typeof value.language === "string";
+}
+function isCustomer(value) {
+  return isPlainObject(value) && (value.id === null || typeof value.id === "number") && isPlainObject(value.contact) && isPlainObject(value.shipping_address) && isPlainObject(value.billing_address);
+}
+function isPayment(value) {
+  return isPlainObject(value) && (value.status === null || typeof value.status === "string") && (value.selected === null || isPlainObject(value.selected));
+}
+function isShipping(value) {
+  return isPlainObject(value) && (value.selected === null || typeof value.selected === "string") && (value.options === void 0 || Array.isArray(value.options)) && (value.custom_labels === void 0 || isPlainObject(value.custom_labels));
+}
+function isShippingOption(value) {
+  return isPlainObject(value) && typeof value.id === "string" && typeof value.price === "number" && typeof value.currency === "string" && typeof value.phone_required === "boolean" && typeof value.id_required === "boolean" && typeof value.accepts_cod === "boolean" && typeof value.free_shipping_eligible === "boolean" && isPlainObject(value.extra) && typeof value.hidden === "boolean" && typeof value.shippable === "boolean";
+}
+
+// src/lib/guards/pages.ts
+function isProductPage(page) {
+  return page.type === "product";
+}
+function isCategoryPage(page) {
+  return page.type === "category";
+}
+function isCheckoutPage(page) {
+  return page.type === "checkout";
+}
+function isAllProductsPage(page) {
+  return page.type === "products";
+}
+function isSearchPage(page) {
+  return page.type === "search";
+}
+function isHomePage(page) {
+  return page.type === "home";
+}
+
+// src/lib/page-match.ts
+function pageMatch(state, handlers) {
+  const { page } = state.location;
+  if (isProductPage(page)) {
+    handlers.product?.(state, page.data.product);
+    return;
+  }
+  if (isCategoryPage(page)) {
+    handlers.category?.(state, page.data);
+    return;
+  }
+  if (isCheckoutPage(page)) {
+    handlers.checkout?.(state, page.data);
+    return;
+  }
+  if (isHomePage(page)) {
+    handlers.home?.(state, page.data);
+    return;
+  }
+}
+function onPage(handlers) {
+  const nube = getNubeInstance();
+  const currentState = nube.getState();
+  pageMatch(currentState, handlers);
+  const listener = (state) => pageMatch(state, handlers);
+  nube.on("location:updated", listener);
+  return () => nube.off("location:updated", listener);
+}
+function onCheckoutStep(handlers) {
+  const nube = getNubeInstance();
+  const currentState = nube.getState();
+  const currentPage = currentState.location.page;
+  if (currentPage.type === "checkout") {
+    handlers[currentPage?.data?.step]?.(currentState);
+  }
+  const listener = (state) => {
+    const { page } = state.location;
+    if (page.type !== "checkout") return;
+    const step = page.data.step;
+    handlers[step]?.(state);
+  };
+  nube.on("checkout:ready", listener);
+  return () => nube.off("checkout:ready", listener);
+}
+
+// src/lib/render.ts
+function getProductsFromState(state) {
+  const { page } = state.location;
+  if (!page || !("data" in page) || !page.data) {
+    return [];
+  }
+  const products = [];
+  if (hasProductList(page.data)) {
+    products.push(...page.data.products);
+  }
+  if (hasSections(page.data)) {
+    for (const section of page.data.sections) {
+      if (isSectionWithProducts(section)) {
+        products.push(...section.products);
+      }
+    }
+  }
+  if (hasSingleProduct(page.data)) {
+    products.push(page.data.product);
+  }
+  return products;
+}
+function forEachProduct(renderFactory) {
+  return (state) => {
+    const products = getProductsFromState(state);
+    if (!products.length) return [];
+    return products.reduce((acc, product) => {
+      const component = renderFactory(product);
+      if (component) {
+        acc.push(Object.assign({}, component, { key: product.id }));
+      }
+      return acc;
+    }, []);
+  };
+}
+
+// src/lib/selectors.ts
+function getCart(state = getCurrentState()) {
+  return state.cart;
+}
+function getCartItems(state = getCurrentState()) {
+  return state.cart.items;
+}
+function getPageType(state = getCurrentState()) {
+  return state.location.page.type;
+}
+function getCustomer(state = getCurrentState()) {
+  return state.customer;
+}
+
+// src/lib/utils.ts
+function deepClone(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (typeof structuredClone === "function") {
+    return structuredClone(obj);
+  }
+  return JSON.parse(JSON.stringify(obj));
+}
+function debounce(func, wait) {
+  let timeout;
+  return (...args) => {
+    const later = () => {
+      timeout = void 0;
+      func(...args);
+    };
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(later, wait);
+  };
+}
+function throttle(func, limit) {
+  let inThrottle;
+  return (...args) => {
+    if (!inThrottle) {
+      func(...args);
+      inThrottle = true;
+      setTimeout(() => {
+        inThrottle = false;
+      }, limit);
+    }
+  };
+}
+export {
+  browser,
+  clearBrowserCache,
+  clearNubeInstance,
+  debounce,
+  deepClone,
+  forEachProduct,
+  getAppData,
+  getCart,
+  getCartItems,
+  getCurrentState,
+  getCustomer,
+  getNubeInstance,
+  getPageType,
+  getProductsFromState,
+  getScriptParam,
+  getScriptSearchParams,
+  getScriptURL,
+  hasProductList,
+  hasSections,
+  hasSingleProduct,
+  isAddress,
+  isAllProductsPage,
+  isBillingAddress,
+  isCart,
+  isCartItem,
+  isCartValidationFail,
+  isCartValidationPending,
+  isCartValidationSuccess,
+  isCategoryPage,
+  isCheckoutPage,
+  isCustomer,
+  isHomePage,
+  isNubeComponent,
+  isPayment,
+  isProductPage,
+  isSearchPage,
+  isSectionWithProducts,
+  isShipping,
+  isShippingAddress,
+  isShippingOption,
+  isStore,
+  navigate,
+  onCheckoutStep,
+  onEvent,
+  onPage,
+  pageMatch,
+  setNubeInstance,
+  throttle,
+  toastOn,
+  ui
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/instance.ts","../src/lib/browser.ts","../src/lib/ui.ts","../src/lib/events.ts","../src/lib/getters.ts","../src/internal/primitives.ts","../src/lib/guards/address.ts","../src/lib/guards/cart.ts","../src/lib/guards/components.ts","../src/lib/guards/domain.ts","../src/lib/guards/pages.ts","../src/lib/page-match.ts","../src/lib/render.ts","../src/lib/selectors.ts","../src/lib/utils.ts"],"sourcesContent":["/**\n * @fileoverview NubeSDK instance management\n *\n * The NubeSDK runtime passes the SDK instance only as the argument of the\n * app entry point (`App(nube)`); it does not expose it on a global. This module\n * lets an app register that instance once, so every other helper\n * (`getCurrentState`, `ui`, `browser`, `onPage`, selectors, ...) can access it\n * without threading `nube` through every function and component.\n */\n\nimport type { NubeSDK } from \"@tiendanube/nube-sdk-types\";\n\n/**\n * The instance registered by the app via {@link setNubeInstance}.\n * `undefined` until the app registers one.\n */\nlet registeredInstance: Readonly<NubeSDK> | undefined;\n\n/**\n * Reads `self.__SDK_INSTANCE__` if it exists, guarding against environments\n * where `self` is undefined (e.g. Node-based test runners).\n */\nfunction readGlobalInstance(): Readonly<NubeSDK> | undefined {\n\treturn typeof self !== \"undefined\" ? self.__SDK_INSTANCE__ : undefined;\n}\n\n/**\n * Registers the NubeSDK instance for the current app.\n *\n * Call this once at the very start of your app entry point so the rest of the\n * helper API can access the instance without it being passed around.\n *\n * @param nube - The NubeSDK instance received by your `App(nube)` entry point\n *\n * @example\n * ```typescript\n * import { setNubeInstance, getCurrentState, ui } from \"@tiendanube/nube-sdk-helper\";\n *\n * export function App(nube: NubeSDK) {\n *   setNubeInstance(nube);\n *\n *   // No need to pass `nube` around anymore:\n *   const state = getCurrentState();\n *   ui.showToast(\"App ready!\");\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function setNubeInstance(nube: Readonly<NubeSDK>): void {\n\tregisteredInstance = nube;\n}\n\n/**\n * Gets the NubeSDK instance for the current app.\n *\n * Returns the instance registered via {@link setNubeInstance}. If none was\n * registered, it falls back to `self.__SDK_INSTANCE__` (for forward\n * compatibility) and throws a descriptive error if neither is available.\n *\n * @returns The readonly NubeSDK instance\n * @throws If no instance was registered and no global instance exists\n *\n * @example\n * ```typescript\n * const nube = getNubeInstance();\n * nube.on(\"location:updated\", (state) => {\n *   console.log(\"Page updated:\", state.location.page);\n * });\n * ```\n *\n * @since 0.1.0\n */\nexport function getNubeInstance(): Readonly<NubeSDK> {\n\tconst instance = registeredInstance ?? readGlobalInstance();\n\n\tif (!instance) {\n\t\tthrow new Error(\n\t\t\t\"NubeSDK instance not registered. Call setNubeInstance(nube) at the start of your App(nube) entry point.\",\n\t\t);\n\t}\n\n\treturn instance;\n}\n\n/**\n * Clears the registered NubeSDK instance.\n *\n * Mainly useful for testing or for tearing down between app reloads.\n *\n * @since 0.1.0\n */\nexport function clearNubeInstance(): void {\n\tregisteredInstance = undefined;\n}\n","/**\n * @fileoverview Browser APIs access functions for NubeSDK\n *\n * This module provides utility functions to easily access\n * browser APIs through the NubeSDK instance.\n */\n\nimport type { NubeBrowserAPIs } from \"@tiendanube/nube-sdk-types\";\nimport { getNubeInstance } from \"./instance\";\n\n// Cache for the browser APIs instance\nlet instance: Readonly<NubeBrowserAPIs> | null = null;\n\n/**\n * Browser APIs available through NubeSDK.\n *\n * Provides access to browser storage, navigation, and other APIs\n * in a convenient and type-safe way.\n *\n * @example\n * ```typescript\n * // Use async localStorage\n * await browser.asyncLocalStorage.setItem('key', 'value');\n * const value = await browser.asyncLocalStorage.getItem('key');\n *\n * // Use async sessionStorage\n * await browser.asyncSessionStorage.setItem('session', 'data');\n *\n * // Navigate to a route\n * browser.navigate('/products/123');\n * ```\n *\n * @since 0.1.0\n */\nexport const browser = new Proxy({} as Readonly<NubeBrowserAPIs>, {\n\tget(_, prop: keyof NubeBrowserAPIs) {\n\t\t// Lazy load: create instance only when a property is accessed\n\t\tif (instance === null) {\n\t\t\tinstance = getNubeInstance().getBrowserAPIs();\n\t\t}\n\n\t\t// Return the property from the cached instance\n\t\treturn instance[prop];\n\t},\n});\n\n/**\n * Navigates to a specific route within the Nube application.\n *\n * @param route - The route to navigate to, must start with '/'\n *\n * @example\n * ```typescript\n * // Navigate to a product page\n * navigate('/products/123');\n *\n * // Navigate to home\n * navigate('/');\n *\n * ```\n *\n * @since 0.1.0\n */\nexport function navigate(route: `/${string}`): void {\n\tbrowser.navigate(route);\n}\n\n/**\n * Clears the browser APIs cache.\n *\n * This function is useful for testing or when you need to force\n * a fresh instance of the browser APIs to be created.\n *\n * @example\n * ```typescript\n * // Clear cache before testing\n * clearBrowserCache();\n *\n * // Next access to browser properties will create a new instance\n * await browser.asyncLocalStorage.setItem('key', 'value');\n * ```\n *\n * @since 0.1.0\n */\nexport function clearBrowserCache(): void {\n\tinstance = null;\n}\n","import type {\n\tNubeComponent,\n\tNubeSDKState,\n\tUISlot,\n} from \"@tiendanube/nube-sdk-types\";\nimport { getNubeInstance } from \"./instance\";\n\n/**\n * Visual variants supported by {@link UIHelper.showToast}.\n *\n * @since 0.1.0\n */\nexport type ToastVariant = \"success\" | \"error\" | \"warning\" | \"info\";\n\n/**\n * A component, list of components, or a render function that derives them from\n * the current state.\n *\n * @since 0.1.0\n */\nexport type RenderableComponent =\n\t| NubeComponent\n\t| NubeComponent[]\n\t| ((state: Readonly<NubeSDKState>) => NubeComponent | NubeComponent[]);\n\nexport type UIHelper = {\n\tshowToast: (message: string, variant?: ToastVariant) => void;\n\tclear: (slot: UISlot) => void;\n\trender: (slot: UISlot, component: RenderableComponent) => void;\n\trenderAll: (slots: UISlot[], component: RenderableComponent) => void;\n};\n\n/**\n * View helpers for NubeSDK.\n *\n * Provides methods to show toasts, clear slots, and render components.\n */\n\nexport const ui: Readonly<UIHelper> = Object.freeze({\n\t// Helpers for common components\n\tshowToast(message, variant = \"info\") {\n\t\tconst toast = {\n\t\t\ttype: \"toastRoot\" as const,\n\t\t\tvariant,\n\t\t\tchildren: [{ type: \"toastTitle\" as const, children: message }],\n\t\t};\n\t\tgetNubeInstance().render(\"corner_top_right\", toast);\n\t},\n\n\t// Clear slot\n\tclear(slot) {\n\t\tgetNubeInstance().clearSlot(slot);\n\t},\n\n\trender(slot, component) {\n\t\tgetNubeInstance().render(slot, component);\n\t},\n\n\t// Render the same component across multiple slots in a single call.\n\trenderAll(slots, component) {\n\t\tconst nube = getNubeInstance();\n\t\tfor (const slot of slots) {\n\t\t\tnube.render(slot, component);\n\t\t}\n\t},\n});\n","/**\n * @fileoverview Event subscription helpers for NubeSDK\n *\n * Thin, ergonomic wrappers around `nube.on` that return an unsubscribe\n * function, plus sugar for the very common \"show a toast when an event fires\"\n * pattern seen across apps.\n */\n\nimport type {\n\tEventListenerMap,\n\tNubeSDKListenableEvent,\n\tNubeSDKState,\n} from \"@tiendanube/nube-sdk-types\";\nimport { getNubeInstance } from \"./instance\";\nimport { type ToastVariant, ui } from \"./ui\";\n\n/**\n * Subscribes a listener to a NubeSDK event and returns an unsubscribe function.\n *\n * Equivalent to calling `nube.on(event, listener)`, but the returned function\n * detaches the listener via `nube.off`, so you don't need to hold a reference\n * to both the instance and the listener to clean it up.\n *\n * @param event - The event to listen for\n * @param listener - The listener to register\n * @returns An unsubscribe function\n *\n * @example\n * ```typescript\n * const unsubscribe = onEvent(\"cart:update\", (state) => {\n *   console.log(\"Cart now has\", state.cart.items.length, \"items\");\n * });\n *\n * // Later:\n * unsubscribe();\n * ```\n *\n * @since 0.1.0\n */\nexport function onEvent<T extends NubeSDKListenableEvent>(\n\tevent: T,\n\tlistener: EventListenerMap[T],\n): () => void {\n\tconst nube = getNubeInstance();\n\tnube.on(event, listener);\n\treturn () => nube.off(event, listener);\n}\n\n/**\n * Shows a toast whenever the given event fires.\n *\n * Replaces the repetitive `nube.on(\"...:success\", () => ui.showToast(...))`\n * pattern. The message can be a static string or a function deriving it from\n * the current state.\n *\n * @param event - The event to listen for\n * @param message - The toast message, or a function returning it from state\n * @param variant - Optional toast variant (defaults to the {@link ui.showToast} default)\n * @returns An unsubscribe function\n *\n * @example\n * ```typescript\n * toastOn(\"cart:add:success\", \"Product added to cart\", \"success\");\n *\n * toastOn(\n *   \"cart:update\",\n *   (state) => `Cart updated: ${state.cart.items.length} items`,\n * );\n * ```\n *\n * @since 0.1.0\n */\nexport function toastOn<T extends NubeSDKListenableEvent>(\n\tevent: T,\n\tmessage: string | ((state: Readonly<NubeSDKState>) => string),\n\tvariant?: ToastVariant,\n): () => void {\n\tconst listener = ((state: Readonly<NubeSDKState>) => {\n\t\tconst text = typeof message === \"function\" ? message(state) : message;\n\t\tui.showToast(text, variant);\n\t}) as EventListenerMap[T];\n\n\treturn onEvent(event, listener);\n}\n","/**\n * @fileoverview Access functions for NubeSDK instance data\n *\n * This module provides utility functions to easily access\n * the SDK instance, current state and application data.\n */\n\nimport type { NubeSDKState, Nullable } from \"@tiendanube/nube-sdk-types\";\nimport { getNubeInstance } from \"./instance\";\n\n/**\n * Gets the current NubeSDK state.\n *\n * @returns The current readonly SDK state\n *\n * @example\n * ```typescript\n * const state = getCurrentState();\n * console.log('Current page:', state.location.page.type);\n * console.log('Page data:', state.location.page.data);\n * ```\n *\n * @since 0.1.0\n */\nexport function getCurrentState(): Readonly<NubeSDKState> {\n\treturn getNubeInstance().getState();\n}\n\n/**\n * Gets the current application data.\n *\n * @returns Readonly object containing application ID and script\n *\n * @example\n * ```typescript\n * const appData = getAppData();\n * console.log('Application ID:', appData.id);\n * console.log('Application script:', appData.script);\n * ```\n *\n * @since 0.1.0\n */\nexport function getAppData(): Readonly<{\n\tid: string;\n\tscript: string;\n}> {\n\treturn self.__APP_DATA__;\n}\n\nlet cachedScriptURL: Readonly<URL> | undefined;\n\n/**\n * Gets the parsed URL of the application script.\n *\n * @returns The readonly URL instance of the application script\n *\n * @example\n * ```typescript\n * const url = getScriptURL();\n * console.log('Script origin:', url.origin);\n * console.log('Script pathname:', url.pathname);\n * ```\n *\n * @since 0.1.0\n */\nexport function getScriptURL(): Readonly<URL> {\n\tif (!cachedScriptURL) {\n\t\tcachedScriptURL = Object.freeze(new URL(self.__APP_DATA__.script));\n\t}\n\treturn cachedScriptURL;\n}\n\n/**\n * Gets the search parameters of the application script URL.\n *\n * @returns The readonly URLSearchParams instance from the script URL\n *\n * @example\n * ```typescript\n * const params = getScriptSearchParams();\n * for (const [key, value] of params) {\n *   console.log(`${key}: ${value}`);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function getScriptSearchParams(): Readonly<URLSearchParams> {\n\treturn getScriptURL().searchParams;\n}\n\n/**\n * Gets a specific search parameter from the application script URL.\n *\n * @param key - The name of the search parameter to retrieve\n * @returns The value of the search parameter, or null if not present\n *\n * @example\n * ```typescript\n * const version = getScriptParam('version');\n * if (version) {\n *   console.log('Script version:', version);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function getScriptParam(key: string): Nullable<string> {\n\treturn getScriptSearchParams().get(key);\n}\n","/**\n * @fileoverview Internal primitive type guards shared across the guards folder.\n *\n * These are building blocks used by the domain-specific guards. They are NOT\n * part of the package's public API and are intentionally not re-exported by\n * `guards/index.ts`.\n *\n * @internal\n */\n\n/**\n * Internal type guard to check if a value is any kind of object (including arrays, dates, etc.)\n * Excludes null and primitive values\n *\n * @internal\n */\nexport function isObject(value: unknown): value is object {\n\treturn typeof value === \"object\" && value !== null;\n}\n\n/**\n * Internal type guard to check if a value is a plain object (not array, date, or other built-in objects)\n *\n * @internal\n */\nexport function isPlainObject(\n\tvalue: unknown,\n): value is Record<string, unknown> {\n\treturn (\n\t\tisObject(value) &&\n\t\t!Array.isArray(value) &&\n\t\tObject.prototype.toString.call(value) === \"[object Object]\"\n\t);\n}\n","/**\n * @fileoverview Address type guards for NubeSDK (address, shipping & billing).\n */\n\nimport type {\n\tAddress,\n\tBillingAddress,\n\tShippingAddress,\n} from \"@tiendanube/nube-sdk-types\";\nimport { isPlainObject } from \"../../internal/primitives\";\n\n/**\n * Type guard to check if a value is a valid address object\n *\n * @param value - The value to check\n * @returns True if the value is an Address\n *\n * @example\n * ```typescript\n * if (isAddress(data)) {\n *   // data is now typed as Address\n *   console.log(data.zipcode);\n *   console.log(data.city);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isAddress(value: unknown): value is Address {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.zipcode === \"string\" &&\n\t\t(value.first_name === null || typeof value.first_name === \"string\") &&\n\t\t(value.last_name === null || typeof value.last_name === \"string\") &&\n\t\t(value.address === null || typeof value.address === \"string\") &&\n\t\t(value.number === null || typeof value.number === \"string\") &&\n\t\t(value.floor === null || typeof value.floor === \"string\") &&\n\t\t(value.locality === null || typeof value.locality === \"string\") &&\n\t\t(value.city === null || typeof value.city === \"string\") &&\n\t\t(value.state === null || typeof value.state === \"string\") &&\n\t\t(value.country === null || typeof value.country === \"string\") &&\n\t\t(value.phone === null || typeof value.phone === \"string\")\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid shipping address\n *\n * @param value - The value to check\n * @returns True if the value is a ShippingAddress\n *\n * @example\n * ```typescript\n * if (isShippingAddress(data)) {\n *   // data is now typed as ShippingAddress\n *   console.log(data.zipcode);\n *   console.log(data.between_street);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isShippingAddress(value: unknown): value is ShippingAddress {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.zipcode === \"string\" &&\n\t\t(value.first_name === null || typeof value.first_name === \"string\") &&\n\t\t(value.last_name === null || typeof value.last_name === \"string\") &&\n\t\t(value.address === null || typeof value.address === \"string\") &&\n\t\t(value.number === null || typeof value.number === \"string\") &&\n\t\t(value.floor === null || typeof value.floor === \"string\") &&\n\t\t(value.locality === null || typeof value.locality === \"string\") &&\n\t\t(value.city === null || typeof value.city === \"string\") &&\n\t\t(value.state === null || typeof value.state === \"string\") &&\n\t\t(value.country === null || typeof value.country === \"string\") &&\n\t\t(value.phone === null || typeof value.phone === \"string\") &&\n\t\t(value.between_street === null ||\n\t\t\ttypeof value.between_street === \"string\") &&\n\t\t(value.reference === null || typeof value.reference === \"string\")\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid billing address\n *\n * @param value - The value to check\n * @returns True if the value is a BillingAddress\n *\n * @example\n * ```typescript\n * if (isBillingAddress(data)) {\n *   // data is now typed as BillingAddress\n *   console.log(data.zipcode);\n *   console.log(data.business_name);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isBillingAddress(value: unknown): value is BillingAddress {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.zipcode === \"string\" &&\n\t\t(value.first_name === null || typeof value.first_name === \"string\") &&\n\t\t(value.last_name === null || typeof value.last_name === \"string\") &&\n\t\t(value.address === null || typeof value.address === \"string\") &&\n\t\t(value.number === null || typeof value.number === \"string\") &&\n\t\t(value.floor === null || typeof value.floor === \"string\") &&\n\t\t(value.locality === null || typeof value.locality === \"string\") &&\n\t\t(value.city === null || typeof value.city === \"string\") &&\n\t\t(value.state === null || typeof value.state === \"string\") &&\n\t\t(value.country === null || typeof value.country === \"string\") &&\n\t\t(value.phone === null || typeof value.phone === \"string\") &&\n\t\t(value.id_number === null || typeof value.id_number === \"string\") &&\n\t\t(value.customer_type === null || typeof value.customer_type === \"string\") &&\n\t\t(value.business_name === null || typeof value.business_name === \"string\") &&\n\t\t(value.trade_name === null || typeof value.trade_name === \"string\") &&\n\t\t(value.state_registration === null ||\n\t\t\ttypeof value.state_registration === \"string\") &&\n\t\t(value.fiscal_regime === null || typeof value.fiscal_regime === \"string\") &&\n\t\t(value.invoice_use === null || typeof value.invoice_use === \"string\") &&\n\t\t(value.document_type === null || typeof value.document_type === \"string\") &&\n\t\t(value.business_activity === null ||\n\t\t\ttypeof value.business_activity === \"string\")\n\t);\n}\n","/**\n * @fileoverview Cart type guards for NubeSDK.\n */\n\nimport type {\n\tCart,\n\tCartItem,\n\tCartValidation,\n\tCartValidationFail,\n\tCartValidationPending,\n\tCartValidationSuccess,\n} from \"@tiendanube/nube-sdk-types\";\nimport { isPlainObject } from \"../../internal/primitives\";\n\n/**\n * Type guard to check if a value is a valid cart object\n *\n * @param value - The value to check\n * @returns True if the value is a Cart\n *\n * @example\n * ```typescript\n * if (isCart(data)) {\n *   // data is now typed as Cart\n *   console.log(data.id);\n *   console.log(data.items.length);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCart(value: unknown): value is Cart {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.id === \"string\" &&\n\t\tisPlainObject(value.validation) &&\n\t\ttypeof value.validation.status === \"string\" &&\n\t\tArray.isArray(value.items) &&\n\t\tisPlainObject(value.prices) &&\n\t\ttypeof value.prices.subtotal === \"number\" &&\n\t\ttypeof value.prices.total === \"number\" &&\n\t\tisPlainObject(value.coupon)\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid cart item\n *\n * @param value - The value to check\n * @returns True if the value is a CartItem\n *\n * @example\n * ```typescript\n * if (isCartItem(item)) {\n *   // item is now typed as CartItem\n *   console.log(item.name);\n *   console.log(item.price);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCartItem(value: unknown): value is CartItem {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.id === \"number\" &&\n\t\ttypeof value.name === \"string\" &&\n\t\ttypeof value.price === \"string\" &&\n\t\ttypeof value.quantity === \"number\" &&\n\t\ttypeof value.free_shipping === \"boolean\" &&\n\t\ttypeof value.product_id === \"number\" &&\n\t\ttypeof value.variant_id === \"number\" &&\n\t\ttypeof value.thumbnail === \"string\" &&\n\t\ttypeof value.variant_values === \"string\" &&\n\t\ttypeof value.url === \"string\" &&\n\t\ttypeof value.is_ahora_12_eligible === \"boolean\"\n\t);\n}\n\n/**\n * Type guard to check if a cart validation is successful\n *\n * @param validation - The validation to check\n * @returns True if the validation is successful\n *\n * @example\n * ```typescript\n * if (isCartValidationSuccess(cart.validation)) {\n *   // cart.validation is now typed as CartValidationSuccess\n *   console.log('Cart is valid');\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCartValidationSuccess(\n\tvalidation: CartValidation,\n): validation is CartValidationSuccess {\n\treturn validation.status === \"success\";\n}\n\n/**\n * Type guard to check if a cart validation is pending\n *\n * @param validation - The validation to check\n * @returns True if the validation is pending\n *\n * @example\n * ```typescript\n * if (isCartValidationPending(cart.validation)) {\n *   // cart.validation is now typed as CartValidationPending\n *   console.log('Cart validation in progress...');\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCartValidationPending(\n\tvalidation: CartValidation,\n): validation is CartValidationPending {\n\treturn validation.status === \"pending\";\n}\n\n/**\n * Type guard to check if a cart validation failed\n *\n * @param validation - The validation to check\n * @returns True if the validation failed\n *\n * @example\n * ```typescript\n * if (isCartValidationFail(cart.validation)) {\n *   // cart.validation is now typed as CartValidationFail\n *   console.log('Cart validation failed:', cart.validation.reason);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCartValidationFail(\n\tvalidation: CartValidation,\n): validation is CartValidationFail {\n\treturn validation.status === \"fail\";\n}\n","/**\n * @fileoverview Component & page-data structure guards for NubeSDK.\n */\n\nimport type { NubeComponent, ProductDetails } from \"@tiendanube/nube-sdk-types\";\nimport { isObject, isPlainObject } from \"../../internal/primitives\";\n\n/**\n * Type guard to check if a value is a valid Nube component\n *\n * @param value - The value to check\n * @returns True if the value is a NubeComponent\n *\n * @example\n * ```typescript\n * if (isNubeComponent(component)) {\n *   // component is now typed as NubeComponent\n *   console.log(component.type);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isNubeComponent(value: unknown): value is NubeComponent {\n\treturn (\n\t\ttypeof value === \"string\" ||\n\t\t(isPlainObject(value) && typeof value.type === \"string\")\n\t);\n}\n\n/**\n * Type guard that checks if an object contains a list of products.\n *\n * This function verifies that the provided data is an object with a `products`\n * property that is an array of ProductDetails. Useful for validating page data\n * structures that may contain product lists.\n *\n * @param data - The unknown value to check\n * @returns True if data is an object with a `products` array property, false otherwise\n *\n * @example\n * ```typescript\n * const pageData = { products: [product1, product2] };\n * if (hasProductList(pageData)) {\n *   // TypeScript now knows pageData.products exists and is ProductDetails[]\n *   pageData.products.forEach(product => console.log(product.id));\n * }\n * ```\n */\nexport function hasProductList(\n\tdata: unknown,\n): data is { products: ProductDetails[] } {\n\treturn isObject(data) && \"products\" in data && Array.isArray(data.products);\n}\n\n/**\n * Type guard that checks if an object contains a list of sections.\n *\n * This function verifies that the provided data is an object with a `sections`\n * property that is an array. Useful for validating page data structures that\n * may contain section-based content.\n *\n * @param data - The unknown value to check\n * @returns True if data is an object with a `sections` array property, false otherwise\n *\n * @example\n * ```typescript\n * const pageData = { sections: [{ type: \"featured_products\", products: [] }] };\n * if (hasSections(pageData)) {\n *   // TypeScript now knows pageData.sections exists and is an array\n *   pageData.sections.forEach(section => processSection(section));\n * }\n * ```\n */\nexport function hasSections(data: unknown): data is { sections: unknown[] } {\n\treturn isObject(data) && \"sections\" in data && Array.isArray(data.sections);\n}\n\n/**\n * Type guard that checks if a section item contains products.\n *\n * This function verifies that the provided item is an object with a `products`\n * property that is an array of ProductDetails. Useful for iterating through\n * sections and filtering those that contain product lists.\n *\n * @param item - The unknown value to check (typically a section object)\n * @returns True if item is an object with a `products` array property, false otherwise\n *\n * @example\n * ```typescript\n * const sections = [{ type: \"featured_products\", products: [product1] }];\n * sections.forEach(section => {\n *   if (isSectionWithProducts(section)) {\n *     // TypeScript now knows section.products exists and is ProductDetails[]\n *     section.products.forEach(product => renderProduct(product));\n *   }\n * });\n * ```\n */\nexport function isSectionWithProducts(\n\titem: unknown,\n): item is { products: ProductDetails[] } {\n\treturn isObject(item) && \"products\" in item && Array.isArray(item.products);\n}\n\n/**\n * Type guard that checks if an object contains a single product (Product Detail Page).\n *\n * This function verifies that the provided data is an object with a `product`\n * property that is a valid ProductDetails object. It performs a minimal integrity\n * check by verifying the product has an `id` property. Useful for validating\n * product detail page data structures.\n *\n * @param data - The unknown value to check\n * @returns True if data is an object with a `product` property containing a valid ProductDetails, false otherwise\n *\n * @example\n * ```typescript\n * const pageData = { product: { id: 1, name: {...}, ... } };\n * if (hasSingleProduct(pageData)) {\n *   // TypeScript now knows pageData.product exists and is ProductDetails\n *   console.log(pageData.product.id);\n * }\n * ```\n */\nexport function hasSingleProduct(\n\tdata: unknown,\n): data is { product: ProductDetails } {\n\treturn (\n\t\tisObject(data) &&\n\t\t\"product\" in data &&\n\t\tisObject(data.product) &&\n\t\t\"id\" in data.product\n\t);\n}\n","/**\n * @fileoverview Domain type guards for NubeSDK (store, customer, payment, shipping).\n */\n\nimport type {\n\tCustomer,\n\tPayment,\n\tShipping,\n\tShippingOption,\n\tStore,\n} from \"@tiendanube/nube-sdk-types\";\nimport { isPlainObject } from \"../../internal/primitives\";\n\n/**\n * Type guard to check if a value is a valid store object\n *\n * @param value - The value to check\n * @returns True if the value is a Store\n *\n * @example\n * ```typescript\n * if (isStore(data)) {\n *   // data is now typed as Store\n *   console.log(data.name);\n *   console.log(data.currency);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isStore(value: unknown): value is Store {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.id === \"number\" &&\n\t\ttypeof value.name === \"string\" &&\n\t\ttypeof value.domain === \"string\" &&\n\t\ttypeof value.currency === \"string\" &&\n\t\ttypeof value.language === \"string\"\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid customer object\n *\n * @param value - The value to check\n * @returns True if the value is a Customer\n *\n * @example\n * ```typescript\n * if (isCustomer(data)) {\n *   // data is now typed as Customer\n *   console.log(data.contact.email);\n *   console.log(data.shipping_address.city);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCustomer(value: unknown): value is Customer {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\t(value.id === null || typeof value.id === \"number\") &&\n\t\tisPlainObject(value.contact) &&\n\t\tisPlainObject(value.shipping_address) &&\n\t\tisPlainObject(value.billing_address)\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid payment object\n *\n * @param value - The value to check\n * @returns True if the value is a Payment\n *\n * @example\n * ```typescript\n * if (isPayment(data)) {\n *   // data is now typed as Payment\n *   console.log(data.status);\n *   console.log(data.selected?.method_name);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isPayment(value: unknown): value is Payment {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\t(value.status === null || typeof value.status === \"string\") &&\n\t\t(value.selected === null || isPlainObject(value.selected))\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid shipping object\n *\n * @param value - The value to check\n * @returns True if the value is a Shipping\n *\n * @example\n * ```typescript\n * if (isShipping(data)) {\n *   // data is now typed as Shipping\n *   console.log(data.selected);\n *   console.log(data.options?.length);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isShipping(value: unknown): value is Shipping {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\t(value.selected === null || typeof value.selected === \"string\") &&\n\t\t(value.options === undefined || Array.isArray(value.options)) &&\n\t\t(value.custom_labels === undefined || isPlainObject(value.custom_labels))\n\t);\n}\n\n/**\n * Type guard to check if a value is a valid shipping option\n *\n * @param value - The value to check\n * @returns True if the value is a ShippingOption\n *\n * @example\n * ```typescript\n * if (isShippingOption(option)) {\n *   // option is now typed as ShippingOption\n *   console.log(option.name);\n *   console.log(option.price);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isShippingOption(value: unknown): value is ShippingOption {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.price === \"number\" &&\n\t\ttypeof value.currency === \"string\" &&\n\t\ttypeof value.phone_required === \"boolean\" &&\n\t\ttypeof value.id_required === \"boolean\" &&\n\t\ttypeof value.accepts_cod === \"boolean\" &&\n\t\ttypeof value.free_shipping_eligible === \"boolean\" &&\n\t\tisPlainObject(value.extra) &&\n\t\ttypeof value.hidden === \"boolean\" &&\n\t\ttypeof value.shippable === \"boolean\"\n\t);\n}\n","/**\n * @fileoverview Page type guards for NubeSDK.\n *\n * Runtime checks that narrow a `Page` to its specific page type.\n */\n\nimport type {\n\tAllProductsPage,\n\tCategoryPage,\n\tCheckoutPage,\n\tHomePage,\n\tPage,\n\tProductPage,\n\tSearchPage,\n} from \"@tiendanube/nube-sdk-types\";\n\n/**\n * Type guard to check if a page is a product page\n *\n * @param page - The page to check\n * @returns True if the page is a ProductPage\n *\n * @example\n * ```typescript\n * if (isProductPage(page)) {\n *   // page is now typed as ProductPage\n *   console.log(page.data.name);\n *   console.log(page.data.variants);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isProductPage(page: Page): page is ProductPage {\n\treturn page.type === \"product\";\n}\n\n/**\n * Type guard to check if a page is a category page\n *\n * @param page - The page to check\n * @returns True if the page is a CategoryPage\n *\n * @example\n * ```typescript\n * if (isCategoryPage(page)) {\n *   // page is now typed as CategoryPage\n *   console.log(page.data.name);\n *   console.log(page.data.id);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCategoryPage(page: Page): page is CategoryPage {\n\treturn page.type === \"category\";\n}\n\n/**\n * Type guard to check if a page is a checkout page\n *\n * @param page - The page to check\n * @returns True if the page is a CheckoutPage\n *\n * @example\n * ```typescript\n * if (isCheckoutPage(page)) {\n *   // page is now typed as CheckoutPage\n *   console.log(page.data.step);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isCheckoutPage(page: Page): page is CheckoutPage {\n\treturn page.type === \"checkout\";\n}\n\n/**\n * Type guard to check if a page is an all products page\n *\n * @param page - The page to check\n * @returns True if the page is an AllProductsPage\n *\n * @example\n * ```typescript\n * if (isAllProductsPage(page)) {\n *   // page is now typed as AllProductsPage\n *   console.log(page.data.id); // 0\n *   console.log(page.data.products);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isAllProductsPage(page: Page): page is AllProductsPage {\n\treturn page.type === \"products\";\n}\n\n/**\n * Type guard to check if a page is a search page\n *\n * @param page - The page to check\n * @returns True if the page is a SearchPage\n *\n * @example\n * ```typescript\n * if (isSearchPage(page)) {\n *   // page is now typed as SearchPage\n *   console.log(page.data.q);\n *   console.log(page.data.products);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isSearchPage(page: Page): page is SearchPage {\n\treturn page.type === \"search\";\n}\n\n/**\n * Type guard to check if a page is a home page\n *\n * @param page - The page to check\n * @returns True if the page is a HomePage\n *\n * @example\n * ```typescript\n * if (isHomePage(page)) {\n *   // page is now typed as HomePage\n *   console.log(page.data?.sections);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function isHomePage(page: Page): page is HomePage {\n\treturn page.type === \"home\";\n}\n","/**\n * @fileoverview Page matching system for NubeSDK\n *\n * This module provides a type-safe system for handling different page types\n * (product, category, checkout) and their respective data.\n * Includes functions for page matching and event handlers.\n */\n\nimport type {\n\tCategory,\n\tCheckout,\n\tHome,\n\tNubeSDKState,\n\tProductDetails,\n} from \"@tiendanube/nube-sdk-types\";\nimport {\n\tisCategoryPage,\n\tisCheckoutPage,\n\tisHomePage,\n\tisProductPage,\n} from \"./guards\";\nimport { getNubeInstance } from \"./instance\";\n\n/**\n * Maps each page type to its specific data payload.\n *\n * @example\n * ```typescript\n * // Product page data\n * const productData: PageDataMap['product'] = {\n *   id: '123',\n *   name: 'Example Product',\n *   price: 29.99\n * };\n *\n * // Category page data\n * const categoryData: PageDataMap['category'] = {\n *   id: 'cat-1',\n *   name: 'Example Category',\n *   products: []\n * };\n * ```\n *\n * @since 0.1.0\n */\nexport type PageDataMap = {\n\tproduct: ProductDetails;\n\tcategory: Category;\n\tcheckout: Checkout;\n\thome: Home;\n};\n\n/**\n * Typed handler for a given page type.\n *\n * @template T - The page type (product, category, checkout)\n * @param state - Current NubeSDK state\n * @param data - Page-specific data for the given page type\n *\n * @example\n * ```typescript\n * const productHandler: PageHandlerFunction<'product'> = (state, data) => {\n *   console.log('Product viewed:', data.name);\n *   trackProductView(data.id);\n * };\n *\n * const checkoutHandler: PageHandlerFunction<'checkout'> = (state, data) => {\n *   if (data.step === 'success') {\n *     trackPurchase(data.orderId);\n *   }\n * };\n * ```\n *\n * @since 0.1.0\n */\nexport type PageHandlerFunction<T extends keyof PageDataMap> = (\n\tstate: NubeSDKState,\n\tdata: PageDataMap[T],\n) => void;\n\n/**\n * Partial set of handlers where only relevant page types need to be implemented.\n *\n * @example\n * ```typescript\n * const handlers: PageHandlers = {\n *   product: (state, data) => trackProductView(data.id),\n *   checkout: (state, data) => {\n *     if (data.step === 'success') trackPurchase();\n *   }\n *   // category handler is optional\n * };\n * ```\n *\n * @since 0.1.0\n */\nexport type PageHandlers = {\n\t[K in keyof PageDataMap]?: PageHandlerFunction<K>;\n};\n\n/**\n * Dispatches to the appropriate handler based on the current page type.\n * Type inference guarantees that each handler receives the correct payload.\n *\n * @param state - Current NubeSDK state\n * @param handlers - Handlers mapped by page type\n *\n * @example\n * ```typescript\n * const state = getCurrentState();\n *\n * pageMatch(state, {\n *   product: (state, data) => {\n *     console.log('Product:', data.name, 'Price:', data.price);\n *   },\n *   category: (state, data) => {\n *     console.log('Category:', data.name, 'Products:', data.products.length);\n *   },\n *   checkout: (state, data) => {\n *     console.log('Checkout step:', data.step);\n *   }\n * });\n * ```\n *\n * @since 0.1.0\n */\nexport function pageMatch(state: NubeSDKState, handlers: PageHandlers): void {\n\tconst { page } = state.location;\n\n\tif (isProductPage(page)) {\n\t\thandlers.product?.(state, page.data.product);\n\t\treturn;\n\t}\n\n\tif (isCategoryPage(page)) {\n\t\thandlers.category?.(state, page.data);\n\t\treturn;\n\t}\n\n\tif (isCheckoutPage(page)) {\n\t\thandlers.checkout?.(state, page.data);\n\t\treturn;\n\t}\n\n\tif (isHomePage(page)) {\n\t\thandlers.home?.(state, page.data);\n\t\treturn;\n\t}\n}\n\n/**\n * Subscribes to navigation changes and invokes handlers that match the current page.\n *\n * Functional pattern that detects the current page type and calls the\n * corresponding handler whenever navigation updates occur.\n *\n * @param handlers - Handlers mapped by page type\n * @returns An unsubscribe function that stops listening for navigation changes\n *\n * @example\n * ```typescript\n * const unsubscribe = onPage({\n *   product: (state, data) => trackProductView(data.id),\n *   checkout: (state, data) => {\n *     if (data.step === 'success') trackPurchase();\n *   }\n * });\n *\n * // Later, to stop listening:\n * unsubscribe();\n * ```\n *\n * @since 0.1.0\n */\nexport function onPage(handlers: PageHandlers): () => void {\n\tconst nube = getNubeInstance();\n\n\tconst currentState = nube.getState();\n\n\tpageMatch(currentState, handlers);\n\n\tconst listener = (state: NubeSDKState) => pageMatch(state, handlers);\n\tnube.on(\"location:updated\", listener);\n\n\treturn () => nube.off(\"location:updated\", listener);\n}\n\n/**\n * Union of all possible checkout steps.\n *\n * @since 0.1.0\n */\ntype CheckoutStep = Checkout[\"step\"];\n\n/**\n * Handlers per checkout step (e.g., 'cart', 'payment', 'success').\n * Only the steps you care about need to be provided.\n *\n * @example\n * ```typescript\n * const checkoutHandlers: CheckoutStepHandlers = {\n *   cart: (state) => console.log('Cart step'),\n *   payment: (state) => console.log('Payment step'),\n *   success: (state) => console.log('Success step')\n * };\n * ```\n *\n * @since 0.1.0\n */\nexport type CheckoutStepHandlers = Partial<\n\tRecord<CheckoutStep, (state: NubeSDKState) => void>\n>;\n\n/**\n * Runs a handler when the checkout is ready and the current step matches.\n *\n * Listens to `checkout:ready` and, if the current page is a checkout,\n * invokes the handler registered for the current `Checkout.step`.\n *\n * @param handlers - Handlers keyed by checkout step\n * @returns An unsubscribe function that stops listening for checkout steps\n *\n * @example\n * ```typescript\n * const unsubscribe = onCheckoutStep({\n *   cart: (state) => {\n *     console.log('User is in cart step');\n *     trackCartView();\n *   },\n *   success: (state) => {\n *     console.log('Purchase completed');\n *     trackPurchase();\n *   }\n * });\n *\n * // Later, to stop listening:\n * unsubscribe();\n * ```\n *\n * @since 0.1.0\n */\nexport function onCheckoutStep(handlers: CheckoutStepHandlers): () => void {\n\tconst nube = getNubeInstance();\n\n\tconst currentState = nube.getState();\n\tconst currentPage = currentState.location.page;\n\n\tif (currentPage.type === \"checkout\") {\n\t\thandlers[currentPage?.data?.step]?.(currentState);\n\t}\n\n\tconst listener = (state: NubeSDKState) => {\n\t\tconst { page } = state.location;\n\t\tif (page.type !== \"checkout\") return;\n\t\tconst step: CheckoutStep = page.data.step;\n\t\thandlers[step]?.(state);\n\t};\n\tnube.on(\"checkout:ready\", listener);\n\n\treturn () => nube.off(\"checkout:ready\", listener);\n}\n","/**\n * @fileoverview Render helpers for NubeSDK\n *\n * This module provides utilities to extract products from state and\n * iterate over them for rendering (e.g., in grid slots).\n */\n\nimport type {\n\tNubeComponent,\n\tNubeSDKState,\n\tProductDetails,\n} from \"@tiendanube/nube-sdk-types\";\nimport {\n\thasProductList,\n\thasSections,\n\thasSingleProduct,\n\tisSectionWithProducts,\n} from \"./guards\";\n\n/**\n * Extracts all products from the NubeSDK state, regardless of the page type.\n * Strategy: \"Greedy\" (Aggressive Collection).\n *\n * This function collects products from multiple sources within the state:\n * - Direct product lists in category, products, and search pages\n * - Products within sections for home, product, category, and products pages\n * - The main product in product detail pages\n *\n * @param state - The current NubeSDK state containing location and page information\n * @returns An array of ProductDetails. Returns an empty array if no products are found\n *          or if the page structure doesn't contain products.\n *\n * @example\n * ```typescript\n * const state = nube.getState();\n * const products = getProductsFromState(state);\n * products.forEach(product => console.log(product.id));\n * ```\n */\nexport function getProductsFromState(state: NubeSDKState): ProductDetails[] {\n\tconst { page } = state.location;\n\n\tif (!page || !(\"data\" in page) || !page.data) {\n\t\treturn [];\n\t}\n\n\tconst products: ProductDetails[] = [];\n\n\tif (hasProductList(page.data)) {\n\t\tproducts.push(...page.data.products);\n\t}\n\n\tif (hasSections(page.data)) {\n\t\tfor (const section of page.data.sections) {\n\t\t\tif (isSectionWithProducts(section)) {\n\t\t\t\tproducts.push(...section.products);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (hasSingleProduct(page.data)) {\n\t\tproducts.push(page.data.product);\n\t}\n\n\treturn products;\n}\n\n/**\n * Creates a higher-order function that iterates over products in grid slots.\n *\n * This helper abstracts page type checking, product iteration, and automatic key generation.\n * It extracts products from the state, maps them through a render factory function,\n * filters out null/undefined results, and automatically injects unique keys for each component.\n *\n * @param renderFactory - A function that receives a ProductDetails and returns a NubeComponent,\n *                        null, or undefined. Components returning null/undefined are filtered out.\n * @returns A function that accepts NubeSDKState and returns an array of NubeComponent instances\n *          with automatically generated keys using the product ID.\n *\n * @example\n * ```typescript\n * nube.render(\n *   \"product_grid_item_image_bottom_right\",\n *   forEachProduct((product) => <MyBadge product={product} />)\n * );\n * ```\n */\nexport function forEachProduct(\n\trenderFactory: (product: ProductDetails) => NubeComponent | null | undefined,\n) {\n\treturn (state: NubeSDKState): NubeComponent[] => {\n\t\tconst products = getProductsFromState(state);\n\n\t\tif (!products.length) return [];\n\n\t\treturn products.reduce<NubeComponent[]>((acc, product) => {\n\t\t\tconst component = renderFactory(product);\n\n\t\t\tif (component) {\n\t\t\t\tacc.push(Object.assign({}, component, { key: product.id }));\n\t\t\t}\n\n\t\t\treturn acc;\n\t\t}, []);\n\t};\n}\n","/**\n * @fileoverview State selectors for NubeSDK\n *\n * Small, focused accessors for the most frequently read slices of the SDK\n * state. Each selector accepts an optional `state`; when omitted it reads the\n * current state from the registered instance, so apps don't need to repeat\n * `const state = nube.getState()` everywhere.\n */\n\nimport type {\n\tCart,\n\tCartItem,\n\tCustomer,\n\tNubeSDKState,\n\tNullable,\n\tPage,\n} from \"@tiendanube/nube-sdk-types\";\nimport { getCurrentState } from \"./getters\";\n\n/**\n * Gets the current cart.\n *\n * @param state - Optional state; defaults to the current SDK state\n * @returns The cart\n *\n * @example\n * ```typescript\n * const cart = getCart();\n * console.log(\"Items:\", cart.items.length);\n * ```\n *\n * @since 0.1.0\n */\nexport function getCart(state: NubeSDKState = getCurrentState()): Cart {\n\treturn state.cart;\n}\n\n/**\n * Gets the items currently in the cart.\n *\n * @param state - Optional state; defaults to the current SDK state\n * @returns The list of cart items\n *\n * @example\n * ```typescript\n * for (const item of getCartItems()) {\n *   console.log(item.name, item.quantity);\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function getCartItems(\n\tstate: NubeSDKState = getCurrentState(),\n): CartItem[] {\n\treturn state.cart.items;\n}\n\n/**\n * Gets the type of the current page (e.g. `\"home\"`, `\"product\"`, `\"checkout\"`).\n *\n * @param state - Optional state; defaults to the current SDK state\n * @returns The current page type\n *\n * @example\n * ```typescript\n * if (getPageType() === \"checkout\") {\n *   // checkout-specific logic\n * }\n * ```\n *\n * @since 0.1.0\n */\nexport function getPageType(\n\tstate: NubeSDKState = getCurrentState(),\n): Page[\"type\"] {\n\treturn state.location.page.type;\n}\n\n/**\n * Gets the current customer, or `null` when not available on the current page.\n *\n * @param state - Optional state; defaults to the current SDK state\n * @returns The customer or `null`\n *\n * @example\n * ```typescript\n * const customer = getCustomer();\n * if (customer) console.log(customer.contact?.email);\n * ```\n *\n * @since 0.1.0\n */\nexport function getCustomer(\n\tstate: NubeSDKState = getCurrentState(),\n): Nullable<Customer> {\n\treturn state.customer;\n}\n","/**\n * @fileoverview General utility functions for NubeSDK\n *\n * This module provides general-purpose utility functions including\n * deep cloning, debouncing, and throttling capabilities.\n */\n\n/**\n * Deep clones a value.\n *\n * Uses the structured clone algorithm when available (it is, in the NubeSDK\n * Web Worker runtime), which correctly handles `Date`, `Map`, `Set`, typed\n * arrays and circular references. Falls back to JSON serialization in\n * environments without `structuredClone` (with the usual JSON limitations:\n * functions, symbols and `undefined` are dropped).\n *\n * @template T - The type of the value to clone\n * @param obj - The value to deep clone\n * @returns A deep clone of the input value\n *\n * @example\n * ```typescript\n * const original = { name: 'John', age: 30, hobbies: ['reading', 'coding'] };\n * const cloned = deepClone(original);\n *\n * cloned.name = 'Jane';\n * cloned.hobbies.push('gaming');\n *\n * console.log(original.name); // 'John' (unchanged)\n * console.log(original.hobbies); // ['reading', 'coding'] (unchanged)\n * ```\n *\n * @since 0.1.0\n */\nexport function deepClone<T>(obj: T): T {\n\tif (obj === null || typeof obj !== \"object\") {\n\t\treturn obj;\n\t}\n\tif (typeof structuredClone === \"function\") {\n\t\treturn structuredClone(obj);\n\t}\n\treturn JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * Debounces a function call, ensuring it only executes after a specified\n * delay has passed since the last invocation.\n *\n * @template T - The function type\n * @param func - The function to debounce\n * @param wait - The number of milliseconds to delay\n * @returns A debounced version of the function\n *\n * @example\n * ```typescript\n * const debouncedSearch = debounce((query: string) => {\n *   console.log('Searching for:', query);\n *   // Perform search operation\n * }, 300);\n *\n * // Multiple rapid calls will only execute the last one after 300ms\n * debouncedSearch('a');\n * debouncedSearch('ab');\n * debouncedSearch('abc'); // Only this will execute\n * ```\n *\n * @since 0.1.0\n */\nexport function debounce<T extends (...args: never[]) => unknown>(\n\tfunc: T,\n\twait: number,\n): (...args: Parameters<T>) => void {\n\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\n\treturn (...args: Parameters<T>): void => {\n\t\tconst later = () => {\n\t\t\ttimeout = undefined;\n\t\t\tfunc(...args);\n\t\t};\n\n\t\tif (timeout) {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t\ttimeout = setTimeout(later, wait);\n\t};\n}\n\n/**\n * Creates a throttled version of a function that will only execute\n * at most once per specified time limit.\n *\n * @template T - The function type\n * @param func - The function to throttle\n * @param limit - The time limit in milliseconds\n * @returns A throttled version of the function\n *\n * @example\n * ```typescript\n * const throttledScroll = throttle((event: Event) => {\n *   console.log('Scroll event:', event);\n *   // Handle scroll event\n * }, 100);\n *\n * // Even with rapid scroll events, the function will only execute\n * // once every 100ms\n * window.addEventListener('scroll', throttledScroll);\n * ```\n *\n * @since 0.1.0\n */\nexport function throttle<T extends (...args: never[]) => unknown>(\n\tfunc: T,\n\tlimit: number,\n): (...args: Parameters<T>) => void {\n\tlet inThrottle: boolean;\n\n\treturn (...args: Parameters<T>): void => {\n\t\tif (!inThrottle) {\n\t\t\tfunc(...args);\n\t\t\tinThrottle = true;\n\t\t\tsetTimeout(() => {\n\t\t\t\tinThrottle = false;\n\t\t\t}, limit);\n\t\t}\n\t};\n}\n"],"mappings":";AAgBA,IAAI;AAMJ,SAAS,qBAAoD;AAC5D,SAAO,OAAO,SAAS,cAAc,KAAK,mBAAmB;AAC9D;AAyBO,SAAS,gBAAgB,MAA+B;AAC9D,uBAAqB;AACtB;AAsBO,SAAS,kBAAqC;AACpD,QAAMA,YAAW,sBAAsB,mBAAmB;AAE1D,MAAI,CAACA,WAAU;AACd,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AAEA,SAAOA;AACR;AASO,SAAS,oBAA0B;AACzC,uBAAqB;AACtB;;;ACnFA,IAAI,WAA6C;AAuB1C,IAAM,UAAU,IAAI,MAAM,CAAC,GAAgC;AAAA,EACjE,IAAI,GAAG,MAA6B;AAEnC,QAAI,aAAa,MAAM;AACtB,iBAAW,gBAAgB,EAAE,eAAe;AAAA,IAC7C;AAGA,WAAO,SAAS,IAAI;AAAA,EACrB;AACD,CAAC;AAmBM,SAAS,SAAS,OAA2B;AACnD,UAAQ,SAAS,KAAK;AACvB;AAmBO,SAAS,oBAA0B;AACzC,aAAW;AACZ;;;AChDO,IAAM,KAAyB,OAAO,OAAO;AAAA;AAAA,EAEnD,UAAU,SAAS,UAAU,QAAQ;AACpC,UAAM,QAAQ;AAAA,MACb,MAAM;AAAA,MACN;AAAA,MACA,UAAU,CAAC,EAAE,MAAM,cAAuB,UAAU,QAAQ,CAAC;AAAA,IAC9D;AACA,oBAAgB,EAAE,OAAO,oBAAoB,KAAK;AAAA,EACnD;AAAA;AAAA,EAGA,MAAM,MAAM;AACX,oBAAgB,EAAE,UAAU,IAAI;AAAA,EACjC;AAAA,EAEA,OAAO,MAAM,WAAW;AACvB,oBAAgB,EAAE,OAAO,MAAM,SAAS;AAAA,EACzC;AAAA;AAAA,EAGA,UAAU,OAAO,WAAW;AAC3B,UAAM,OAAO,gBAAgB;AAC7B,eAAW,QAAQ,OAAO;AACzB,WAAK,OAAO,MAAM,SAAS;AAAA,IAC5B;AAAA,EACD;AACD,CAAC;;;AC1BM,SAAS,QACf,OACA,UACa;AACb,QAAM,OAAO,gBAAgB;AAC7B,OAAK,GAAG,OAAO,QAAQ;AACvB,SAAO,MAAM,KAAK,IAAI,OAAO,QAAQ;AACtC;AA0BO,SAAS,QACf,OACA,SACA,SACa;AACb,QAAM,YAAY,CAAC,UAAkC;AACpD,UAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,KAAK,IAAI;AAC9D,OAAG,UAAU,MAAM,OAAO;AAAA,EAC3B;AAEA,SAAO,QAAQ,OAAO,QAAQ;AAC/B;;;AC3DO,SAAS,kBAA0C;AACzD,SAAO,gBAAgB,EAAE,SAAS;AACnC;AAgBO,SAAS,aAGb;AACF,SAAO,KAAK;AACb;AAEA,IAAI;AAgBG,SAAS,eAA8B;AAC7C,MAAI,CAAC,iBAAiB;AACrB,sBAAkB,OAAO,OAAO,IAAI,IAAI,KAAK,aAAa,MAAM,CAAC;AAAA,EAClE;AACA,SAAO;AACR;AAiBO,SAAS,wBAAmD;AAClE,SAAO,aAAa,EAAE;AACvB;AAkBO,SAAS,eAAe,KAA+B;AAC7D,SAAO,sBAAsB,EAAE,IAAI,GAAG;AACvC;;;AC7FO,SAAS,SAAS,OAAiC;AACzD,SAAO,OAAO,UAAU,YAAY,UAAU;AAC/C;AAOO,SAAS,cACf,OACmC;AACnC,SACC,SAAS,KAAK,KACd,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM;AAE5C;;;ACLO,SAAS,UAAU,OAAkC;AAC3D,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,YAAY,aACxB,MAAM,eAAe,QAAQ,OAAO,MAAM,eAAe,cACzD,MAAM,cAAc,QAAQ,OAAO,MAAM,cAAc,cACvD,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,WAAW,QAAQ,OAAO,MAAM,WAAW,cACjD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,SAAS,QAAQ,OAAO,MAAM,SAAS,cAC7C,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU;AAElD;AAmBO,SAAS,kBAAkB,OAA0C;AAC3E,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,YAAY,aACxB,MAAM,eAAe,QAAQ,OAAO,MAAM,eAAe,cACzD,MAAM,cAAc,QAAQ,OAAO,MAAM,cAAc,cACvD,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,WAAW,QAAQ,OAAO,MAAM,WAAW,cACjD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,SAAS,QAAQ,OAAO,MAAM,SAAS,cAC7C,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,mBAAmB,QACzB,OAAO,MAAM,mBAAmB,cAChC,MAAM,cAAc,QAAQ,OAAO,MAAM,cAAc;AAE1D;AAmBO,SAAS,iBAAiB,OAAyC;AACzE,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,YAAY,aACxB,MAAM,eAAe,QAAQ,OAAO,MAAM,eAAe,cACzD,MAAM,cAAc,QAAQ,OAAO,MAAM,cAAc,cACvD,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,WAAW,QAAQ,OAAO,MAAM,WAAW,cACjD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,SAAS,QAAQ,OAAO,MAAM,SAAS,cAC7C,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,YAAY,QAAQ,OAAO,MAAM,YAAY,cACnD,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,cAC/C,MAAM,cAAc,QAAQ,OAAO,MAAM,cAAc,cACvD,MAAM,kBAAkB,QAAQ,OAAO,MAAM,kBAAkB,cAC/D,MAAM,kBAAkB,QAAQ,OAAO,MAAM,kBAAkB,cAC/D,MAAM,eAAe,QAAQ,OAAO,MAAM,eAAe,cACzD,MAAM,uBAAuB,QAC7B,OAAO,MAAM,uBAAuB,cACpC,MAAM,kBAAkB,QAAQ,OAAO,MAAM,kBAAkB,cAC/D,MAAM,gBAAgB,QAAQ,OAAO,MAAM,gBAAgB,cAC3D,MAAM,kBAAkB,QAAQ,OAAO,MAAM,kBAAkB,cAC/D,MAAM,sBAAsB,QAC5B,OAAO,MAAM,sBAAsB;AAEtC;;;AC9FO,SAAS,OAAO,OAA+B;AACrD,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,OAAO,YACpB,cAAc,MAAM,UAAU,KAC9B,OAAO,MAAM,WAAW,WAAW,YACnC,MAAM,QAAQ,MAAM,KAAK,KACzB,cAAc,MAAM,MAAM,KAC1B,OAAO,MAAM,OAAO,aAAa,YACjC,OAAO,MAAM,OAAO,UAAU,YAC9B,cAAc,MAAM,MAAM;AAE5B;AAmBO,SAAS,WAAW,OAAmC;AAC7D,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,UAAU,YACvB,OAAO,MAAM,aAAa,YAC1B,OAAO,MAAM,kBAAkB,aAC/B,OAAO,MAAM,eAAe,YAC5B,OAAO,MAAM,eAAe,YAC5B,OAAO,MAAM,cAAc,YAC3B,OAAO,MAAM,mBAAmB,YAChC,OAAO,MAAM,QAAQ,YACrB,OAAO,MAAM,yBAAyB;AAExC;AAkBO,SAAS,wBACf,YACsC;AACtC,SAAO,WAAW,WAAW;AAC9B;AAkBO,SAAS,wBACf,YACsC;AACtC,SAAO,WAAW,WAAW;AAC9B;AAkBO,SAAS,qBACf,YACmC;AACnC,SAAO,WAAW,WAAW;AAC9B;;;ACxHO,SAAS,gBAAgB,OAAwC;AACvE,SACC,OAAO,UAAU,YAChB,cAAc,KAAK,KAAK,OAAO,MAAM,SAAS;AAEjD;AAqBO,SAAS,eACf,MACyC;AACzC,SAAO,SAAS,IAAI,KAAK,cAAc,QAAQ,MAAM,QAAQ,KAAK,QAAQ;AAC3E;AAqBO,SAAS,YAAY,MAAgD;AAC3E,SAAO,SAAS,IAAI,KAAK,cAAc,QAAQ,MAAM,QAAQ,KAAK,QAAQ;AAC3E;AAuBO,SAAS,sBACf,MACyC;AACzC,SAAO,SAAS,IAAI,KAAK,cAAc,QAAQ,MAAM,QAAQ,KAAK,QAAQ;AAC3E;AAsBO,SAAS,iBACf,MACsC;AACtC,SACC,SAAS,IAAI,KACb,aAAa,QACb,SAAS,KAAK,OAAO,KACrB,QAAQ,KAAK;AAEf;;;ACxGO,SAAS,QAAQ,OAAgC;AACvD,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,WAAW,YACxB,OAAO,MAAM,aAAa,YAC1B,OAAO,MAAM,aAAa;AAE5B;AAmBO,SAAS,WAAW,OAAmC;AAC7D,SACC,cAAc,KAAK,MAClB,MAAM,OAAO,QAAQ,OAAO,MAAM,OAAO,aAC1C,cAAc,MAAM,OAAO,KAC3B,cAAc,MAAM,gBAAgB,KACpC,cAAc,MAAM,eAAe;AAErC;AAmBO,SAAS,UAAU,OAAkC;AAC3D,SACC,cAAc,KAAK,MAClB,MAAM,WAAW,QAAQ,OAAO,MAAM,WAAW,cACjD,MAAM,aAAa,QAAQ,cAAc,MAAM,QAAQ;AAE1D;AAmBO,SAAS,WAAW,OAAmC;AAC7D,SACC,cAAc,KAAK,MAClB,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,YAAY,UAAa,MAAM,QAAQ,MAAM,OAAO,OAC1D,MAAM,kBAAkB,UAAa,cAAc,MAAM,aAAa;AAEzE;AAmBO,SAAS,iBAAiB,OAAyC;AACzE,SACC,cAAc,KAAK,KACnB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,UAAU,YACvB,OAAO,MAAM,aAAa,YAC1B,OAAO,MAAM,mBAAmB,aAChC,OAAO,MAAM,gBAAgB,aAC7B,OAAO,MAAM,gBAAgB,aAC7B,OAAO,MAAM,2BAA2B,aACxC,cAAc,MAAM,KAAK,KACzB,OAAO,MAAM,WAAW,aACxB,OAAO,MAAM,cAAc;AAE7B;;;ACrHO,SAAS,cAAc,MAAiC;AAC9D,SAAO,KAAK,SAAS;AACtB;AAmBO,SAAS,eAAe,MAAkC;AAChE,SAAO,KAAK,SAAS;AACtB;AAkBO,SAAS,eAAe,MAAkC;AAChE,SAAO,KAAK,SAAS;AACtB;AAmBO,SAAS,kBAAkB,MAAqC;AACtE,SAAO,KAAK,SAAS;AACtB;AAmBO,SAAS,aAAa,MAAgC;AAC5D,SAAO,KAAK,SAAS;AACtB;AAkBO,SAAS,WAAW,MAA8B;AACxD,SAAO,KAAK,SAAS;AACtB;;;ACZO,SAAS,UAAU,OAAqB,UAA8B;AAC5E,QAAM,EAAE,KAAK,IAAI,MAAM;AAEvB,MAAI,cAAc,IAAI,GAAG;AACxB,aAAS,UAAU,OAAO,KAAK,KAAK,OAAO;AAC3C;AAAA,EACD;AAEA,MAAI,eAAe,IAAI,GAAG;AACzB,aAAS,WAAW,OAAO,KAAK,IAAI;AACpC;AAAA,EACD;AAEA,MAAI,eAAe,IAAI,GAAG;AACzB,aAAS,WAAW,OAAO,KAAK,IAAI;AACpC;AAAA,EACD;AAEA,MAAI,WAAW,IAAI,GAAG;AACrB,aAAS,OAAO,OAAO,KAAK,IAAI;AAChC;AAAA,EACD;AACD;AA0BO,SAAS,OAAO,UAAoC;AAC1D,QAAM,OAAO,gBAAgB;AAE7B,QAAM,eAAe,KAAK,SAAS;AAEnC,YAAU,cAAc,QAAQ;AAEhC,QAAM,WAAW,CAAC,UAAwB,UAAU,OAAO,QAAQ;AACnE,OAAK,GAAG,oBAAoB,QAAQ;AAEpC,SAAO,MAAM,KAAK,IAAI,oBAAoB,QAAQ;AACnD;AAwDO,SAAS,eAAe,UAA4C;AAC1E,QAAM,OAAO,gBAAgB;AAE7B,QAAM,eAAe,KAAK,SAAS;AACnC,QAAM,cAAc,aAAa,SAAS;AAE1C,MAAI,YAAY,SAAS,YAAY;AACpC,aAAS,aAAa,MAAM,IAAI,IAAI,YAAY;AAAA,EACjD;AAEA,QAAM,WAAW,CAAC,UAAwB;AACzC,UAAM,EAAE,KAAK,IAAI,MAAM;AACvB,QAAI,KAAK,SAAS,WAAY;AAC9B,UAAM,OAAqB,KAAK,KAAK;AACrC,aAAS,IAAI,IAAI,KAAK;AAAA,EACvB;AACA,OAAK,GAAG,kBAAkB,QAAQ;AAElC,SAAO,MAAM,KAAK,IAAI,kBAAkB,QAAQ;AACjD;;;AC7NO,SAAS,qBAAqB,OAAuC;AAC3E,QAAM,EAAE,KAAK,IAAI,MAAM;AAEvB,MAAI,CAAC,QAAQ,EAAE,UAAU,SAAS,CAAC,KAAK,MAAM;AAC7C,WAAO,CAAC;AAAA,EACT;AAEA,QAAM,WAA6B,CAAC;AAEpC,MAAI,eAAe,KAAK,IAAI,GAAG;AAC9B,aAAS,KAAK,GAAG,KAAK,KAAK,QAAQ;AAAA,EACpC;AAEA,MAAI,YAAY,KAAK,IAAI,GAAG;AAC3B,eAAW,WAAW,KAAK,KAAK,UAAU;AACzC,UAAI,sBAAsB,OAAO,GAAG;AACnC,iBAAS,KAAK,GAAG,QAAQ,QAAQ;AAAA,MAClC;AAAA,IACD;AAAA,EACD;AAEA,MAAI,iBAAiB,KAAK,IAAI,GAAG;AAChC,aAAS,KAAK,KAAK,KAAK,OAAO;AAAA,EAChC;AAEA,SAAO;AACR;AAsBO,SAAS,eACf,eACC;AACD,SAAO,CAAC,UAAyC;AAChD,UAAM,WAAW,qBAAqB,KAAK;AAE3C,QAAI,CAAC,SAAS,OAAQ,QAAO,CAAC;AAE9B,WAAO,SAAS,OAAwB,CAAC,KAAK,YAAY;AACzD,YAAM,YAAY,cAAc,OAAO;AAEvC,UAAI,WAAW;AACd,YAAI,KAAK,OAAO,OAAO,CAAC,GAAG,WAAW,EAAE,KAAK,QAAQ,GAAG,CAAC,CAAC;AAAA,MAC3D;AAEA,aAAO;AAAA,IACR,GAAG,CAAC,CAAC;AAAA,EACN;AACD;;;ACxEO,SAAS,QAAQ,QAAsB,gBAAgB,GAAS;AACtE,SAAO,MAAM;AACd;AAiBO,SAAS,aACf,QAAsB,gBAAgB,GACzB;AACb,SAAO,MAAM,KAAK;AACnB;AAiBO,SAAS,YACf,QAAsB,gBAAgB,GACvB;AACf,SAAO,MAAM,SAAS,KAAK;AAC5B;AAgBO,SAAS,YACf,QAAsB,gBAAgB,GACjB;AACrB,SAAO,MAAM;AACd;;;AC/DO,SAAS,UAAa,KAAW;AACvC,MAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC5C,WAAO;AAAA,EACR;AACA,MAAI,OAAO,oBAAoB,YAAY;AAC1C,WAAO,gBAAgB,GAAG;AAAA,EAC3B;AACA,SAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AACtC;AA0BO,SAAS,SACf,MACA,MACmC;AACnC,MAAI;AAEJ,SAAO,IAAI,SAA8B;AACxC,UAAM,QAAQ,MAAM;AACnB,gBAAU;AACV,WAAK,GAAG,IAAI;AAAA,IACb;AAEA,QAAI,SAAS;AACZ,mBAAa,OAAO;AAAA,IACrB;AACA,cAAU,WAAW,OAAO,IAAI;AAAA,EACjC;AACD;AAyBO,SAAS,SACf,MACA,OACmC;AACnC,MAAI;AAEJ,SAAO,IAAI,SAA8B;AACxC,QAAI,CAAC,YAAY;AAChB,WAAK,GAAG,IAAI;AACZ,mBAAa;AACb,iBAAW,MAAM;AAChB,qBAAa;AAAA,MACd,GAAG,KAAK;AAAA,IACT;AAAA,EACD;AACD;","names":["instance"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tiendanube/nube-sdk-helper",
+  "version": "0.0.1",
+  "description": "Utility functions, type guards, and SDK instance management for NubeSDK apps",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "check": "biome check src",
+    "check:fix": "biome check --write src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TiendaNube/nube-sdk.git"
+  },
+  "author": "Nuvemshop / TiendaNube",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/TiendaNube/nube-sdk/issues"
+  },
+  "homepage": "https://www.tiendanube.com",
+  "devDependencies": {
+    "@biomejs/biome": "1.8.3",
+    "@vitest/coverage-v8": "^3.2.4",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.2",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@tiendanube/nube-sdk-types": "*"
+  },
+  "files": [
+    "./dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tiendanube",
+    "nuvemshop",
+    "nube-sdk",
+    "ecommerce",
+    "sdk",
+    "helper",
+    "utilities",
+    "typeguards"
+  ]
+}