Introducción

StoreUtils es una librería interna que te permite comunicarte con la API de OrionStore, cuenta con diferentes métodos para simplificar las tareas dentro de la tienda.

No hagas llamados crudos a la API, todo se tiene que realizar con StoreUtils ya que cuenta con error handling, friendly messages, caching, y más que evitan saturación a la API.

tip

Si tienes dudas sobre la API, los endpoints y la referencia está disponible en API Reference.

Instalación

StoreUtils viene embebido en el código dentro de lib:

/utils/lib/orionstore
├── StoreUtils.ts

Para importarla:

import { StoreUtils } from "@/utils/lib/orionstore/StoreUtils";

Y para su uso, solo hay que usar el método deseado:

const productos = await StoreUtils.product.list();

Ejemplo completo

Este es un ejemplo básico de como se implementaría StoreUtils

import { StoreUtils, APIError } from "@/utils/lib/orionstore/StoreUtils";

export async function loadProduct(id: string) {
  try {
    const product = await StoreUtils.product.getById(id);
    return product;
  } catch (e) {
    if (e instanceof APIError) {
      console.error("Error al obtener producto:", e.message, e.status);
    }
    return null;
  }
}

Notas

• La librería soporte Next.js 16+, App Router y servidores edge/route handlers.
• Si quieres añadir nuevos módulos, solo crea una clase que extienda BaseAPI.