@ecomiq/storefront 2.1.4 → 3.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ecomiq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,113 +1,414 @@
 # @ecomiq/storefront
 
-Micro framework SSR de Ecomiq para storefronts. Páginas, datos y deploy sin
-configurar TanStack Start, Vite ni Cloudflare a mano.
+SDK de temas de Ecomiq para React Router 8. Trae los loaders y actions de
+catálogo, carrito, checkout y cuenta de cliente, las secciones editables y los
+plugins de Vite que corren la tienda en un Worker de Cloudflare. Los datos
+vienen de tu tienda en Ecomiq; el diseño es tuyo.
 
-## Instalación
+- [Empezar](#empezar)
+- [Archivos de la plataforma](#archivos-de-la-plataforma)
+- [Entradas del paquete](#entradas-del-paquete)
+- [Uso básico](#uso-básico)
+- [Login de clientes](#login-de-clientes)
+- [Registro de clientes](#registro-de-clientes)
+- [Enlaces de catálogo](#enlaces-de-catálogo)
+- [Logos de medios de pago](#logos-de-medios-de-pago)
+- [Medición y consentimiento](#medición-y-consentimiento)
+- [Secciones de Ecomiq](#secciones-de-ecomiq)
+- [Temas publicados](#temas-publicados)
+
+## Empezar
+
+La forma más corta es bajar el código de tu tienda, que ya trae este paquete:
+
+```bash
+npm create ecomiq@latest mi-tienda
+cd mi-tienda && npm install
+npx ecomiq dev
+```
+
+Para agregarlo a un proyecto React Router existente:
 
 ```bash
-npm install @ecomiq/storefront
-# o
-yarn add @ecomiq/storefront
-# o
-pnpm add @ecomiq/storefront
+npm install @ecomiq/storefront @ecomiq/core react react-dom react-router
 ```
 
-Peer deps: `react` y `react-dom` ^19.
+| Requisito    | Versión                                        |
+| ------------ | ---------------------------------------------- |
+| Node.js      | 22.22 o superior                               |
+| React        | 19                                             |
+| React Router | 8, en modo framework con SSR                   |
+| Runtime      | Cloudflare Workers (`@cloudflare/vite-plugin`) |
+
+`react` y `react-router` son dependencias peer: el SDK usa las del tema.
+
+Guía completa: <https://docs.ecomiq.pe/es/docs/guides/storefront/themes>
+
+## Archivos de la plataforma
 
-## Uso
+`ecomiq init` y el editor de Ecomiq escriben estos archivos; no los edites en
+un tema.
 
-```js
-// ecomiq.config.js
-import { defineConfig } from '@ecomiq/storefront/config'
+```ts title="vite.config.ts"
+import { publicAssets, catalogLinks, paymentLogos, sectionLoaders, themeUi } from "@ecomiq/storefront/vite";
+import { fileURLToPath } from "node:url";
+import { cloudflare } from "@cloudflare/vite-plugin";
+import { reactRouter } from "@react-router/dev/vite";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "vite";
 
 export default defineConfig({
-  domain: 'mi-tienda',
-  // Server-only. Obligatorio en producción para usar una publicación de Cloud.
-  cloud: { baseUrl: 'https://cloud.internal.example' },
-})
+  plugins: [publicAssets(), catalogLinks(), sectionLoaders(), paymentLogos(), themeUi(), cloudflare({ viteEnvironment: { name: "ssr" } }), tailwindcss(), reactRouter()],
+  resolve: { alias: { "~": fileURLToPath(new URL("./app", import.meta.url)) } },
+  build: { rolldownOptions: { output: { codeSplitting: { groups: [{ name: "icons", test: /[\\/]node_modules[\\/](?:@phosphor-icons|@heroicons|@mdi|@remixicon|lucide-react|iconoir-react)[\\/]/ }] } } } },
+});
 ```
 
-```tsx
-// pages/index.tsx
-import { definePage, serverApi } from '@ecomiq/storefront'
+```ts title="workers/app.ts"
+import { createRequestHandler } from "@ecomiq/storefront";
 
-export default definePage({
-  loader: () => serverApi.getProducts({ page: 1, pageSize: 12 }),
-  component: ({ data }) => <pre>{JSON.stringify(data.products, null, 2)}</pre>,
-})
+export default createRequestHandler(() => import("virtual:react-router/server-build"), import.meta.env.MODE);
 ```
 
-CLI:
+`wrangler.jsonc` define la tienda en `vars`: `ECOMIQ_STORE` (el slug) y
+`ECOMIQ_API_URL` (la API Storefront, `https://storefront.ecomiq.pe`). Los tipos
+de los módulos virtuales del SDK se cargan con
+`/// <reference types="@ecomiq/storefront/vite-client" />`.
 
-```bash
-npx ecomiq dev
-npx ecomiq build
-npx ecomiq deploy
+| Plugin             | Qué hace                                                                                                    |
+| ------------------ | ----------------------------------------------------------------------------------------------------------- |
+| `publicAssets()`   | Versiona las imágenes y fuentes de `public/` y, al compilar, genera sus anchos en WebP.                     |
+| `catalogLinks()`   | Genera `virtual:ecomiq-links` con los enlaces editables del tema.                                           |
+| `sectionLoaders()` | Suma al loader de cada ruta el `load` de las secciones que usa y aplica las plantillas de `app/templates/`. |
+| `paymentLogos()`   | Escribe los SVG de medios de pago en el build.                                                              |
+| `themeUi()`        | Lleva `@theme/ui/*` a `app/components/ui/*` del tema.                                                       |
+
+## Entradas del paquete
+
+| Import                             | Para qué                                                         |
+| ---------------------------------- | ---------------------------------------------------------------- |
+| `@ecomiq/storefront`               | Cliente de la tienda, loaders de páginas, sesión, enlaces y SEO. |
+| `@ecomiq/storefront/vite`          | Plugins de Vite.                                                 |
+| `@ecomiq/storefront/cart`          | Carrito: `CartForm`, `useCart`, drawer y carrito optimista.      |
+| `@ecomiq/storefront/checkout`      | Checkout, medios de pago y comprobante.                          |
+| `@ecomiq/storefront/account`       | Cuenta: pedidos, direcciones y perfil.                           |
+| `@ecomiq/storefront/order`         | Estado y pago de un pedido.                                      |
+| `@ecomiq/storefront/analytics`     | Medición, píxeles y aviso de consentimiento.                     |
+| `@ecomiq/storefront/sections/<id>` | [Secciones de Ecomiq](#secciones-de-ecomiq) listas para usar.    |
+| `@ecomiq/storefront/vite-client`   | Tipos de los módulos virtuales.                                  |
+
+## Uso básico
+
+### Loader raíz
+
+`store(context)` devuelve el cliente de la tienda configurada en el Worker.
+`readStorefrontLayout` lee la configuración, las colecciones y los enlaces del
+tema en una sola pasada.
+
+```tsx title="app/root.tsx"
+import manifestLinks from "virtual:ecomiq-links";
+import { readCart, readStorefrontLayout, store } from "@ecomiq/storefront";
+import { readAnalytics } from "@ecomiq/storefront/analytics";
+import type { Route } from "./+types/root";
+
+export { shouldRevalidateCatalogRoot as shouldRevalidate } from "@ecomiq/storefront";
+
+export async function loader({ request, context }: Route.LoaderArgs) {
+  const client = store(context);
+  const [{ settings, storefrontLinks }, cart] = await Promise.all([
+    readStorefrontLayout({ client, links: manifestLinks }),
+    readCart(request, client),
+  ]);
+  return {
+    storefrontLinks,
+    publishedPages: settings.cms.pages.map((page) => `/pages/${page.slug}`),
+    analytics: readAnalytics(context, settings, cart),
+    cart,
+  };
+}
 ```
 
-Si actualizas el package y `.ecomiq` quedó de una versión anterior:
+### Una sección editable
 
-```bash
-npx ecomiq clean
-npx ecomiq dev
+Una sección exporta `settings` con lo que el comerciante cambia en el editor.
+El loader de la ruta lee esos ajustes; nunca escribas a mano precios, stock ni
+productos.
+
+```tsx title="app/components/sections/new-arrivals.tsx"
+import type { ProductSummary } from "@ecomiq/core";
+import { money, setting, StorefrontLink } from "@ecomiq/storefront";
+
+export const settings = {
+  arrivals: {
+    title: setting.text("Recién llegados", "Título"),
+    collection: setting.collection("novedades", "Colección"),
+    limit: setting.number(8, "Cantidad"),
+    link: setting.link("/collections/novedades", "Enlace"),
+  },
+};
+
+type Props = { products: ProductSummary[]; currency: string; language: string };
+
+export function NewArrivals({ products, currency, language }: Props) {
+  return (
+    <section>
+      <h2>{settings.arrivals.title}</h2>
+      <StorefrontLink to={settings.arrivals.link}>Ver todo</StorefrontLink>
+      <ul>
+        {products.map((product) => (
+          <li key={product.id}>
+            {product.name} · {money(product.price, currency, language)}
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
 ```
 
-### Runtime de desarrollo
+```tsx title="app/routes/home.tsx"
+import { pickProducts, store } from "@ecomiq/storefront";
+import { NewArrivals, settings } from "~/components/sections/new-arrivals";
+import type { Route } from "./+types/home";
 
-`ecomiq dev` usa **Node** por defecto. Para emular Workers en local:
+export async function loader({ context }: Route.LoaderArgs) {
+  const client = store(context);
+  const [shop, products] = await Promise.all([
+    client.getSettings(),
+    pickProducts(client, { collection: settings.arrivals.collection, limit: settings.arrivals.limit }),
+  ]);
+  return { products, currency: shop.store.currency, language: shop.store.language };
+}
 
-```js
-dev: { port: 3000, runtime: 'workerd' },
+export default function Home({ loaderData }: Route.ComponentProps) {
+  return <NewArrivals {...loaderData} />;
+}
 ```
 
-`ecomiq build` / `deploy` siempre empaquetan para Cloudflare Workers.
+`pickProducts` acepta `collection`, `category`, `products`, `limit` y `sort`.
+Los ajustes disponibles son `setting.text`, `image`, `link`, `collection`,
+`category`, `product`, `products`, `number` y `toggle`. El primer argumento es
+el valor inicial y debe ser literal; el segundo, la etiqueta que ve el
+comerciante.
 
-Durante `ecomiq dev`, si `cloud.baseUrl` se omite, el framework conecta a
-`http://127.0.0.1:8020`. En producción no se inventa un hostname: si falta la
-URL o Cloud no tiene una publicación activa, el template conserva su home
-clásica.
+### Carrito
 
-Ver el monorepo [ecomiq-storefront](https://github.com/ecomiq/ecomiq-storefront) para la app de referencia y más documentación.
+```tsx title="app/routes/cart.tsx"
+import { cartAction, loadCart } from "@ecomiq/storefront";
+import type { Route } from "./+types/cart";
 
-## Storefront declarativo
+export async function loader({ request, context }: Route.LoaderArgs) {
+  return loadCart(request, context);
+}
 
-El contrato y el renderer viven fuera de este package:
+export async function action({ request, context }: Route.ActionArgs) {
+  return cartAction(request, context);
+}
+```
 
-- `@ecomiq/storefront-definition` — schema Zod, patches, migraciones
-- `@ecomiq/storefront-definition/react` — `DefinitionRenderer`, loaders y hooks
+Con un cliente con sesión, el Worker rechaza con 403 cualquier petición que no
+sea de lectura si no trae el token de la sesión: los formularios llevan
+`<CustomerCsrfField />` y los `fetch` propios, la cabecera `X-Customer-Csrf`.
+`FORM_CONTRACTS` lista los `intent` y los campos que acepta cada acción.
 
-```tsx
-import { createDefaultStorefrontDefinition } from '@ecomiq/storefront-definition'
-import { DefinitionRenderer } from '@ecomiq/storefront-definition/react'
+## Login de clientes
 
-const definition = createDefaultStorefrontDefinition({
-  storeName: 'Casa Lumbre',
-  description: 'Cerámica producida localmente.',
-})
+La tienda elige el modo de acceso en Admin, en **Configuración → Compra →
+Cuentas de clientes**. El SDK lee esa configuración: `hosted` redirige a
+Identity y `storefront` muestra el formulario del tema. Los dos modos usan las
+mismas cuentas y la misma sesión de cliente.
 
-export function Home() {
-  return (
-    <DefinitionRenderer
-      definition={definition}
-      locale="es-PE"
-      currency="PEN"
-      data={{
-        productsBySectionId: {
-          'featured-products': [],
-        },
-        collectionsBySectionId: {
-          'featured-collections': [],
-        },
-      }}
-    />
-  )
+La ruta `/account/login` usa dos helpers:
+
+```tsx title="app/routes/login.tsx"
+import { CustomerLoginForm, startCustomerLogin, submitCustomerLogin } from "@ecomiq/storefront";
+import type { Route } from "./+types/login";
+
+export function loader({ request, context }: Route.LoaderArgs) {
+  return startCustomerLogin(request, context);
 }
-```
 
-```ts
-import {
-  StorefrontDefinitionSchema,
-  applyStorefrontDefinitionPatch,
-} from '@ecomiq/storefront-definition'
+export function action({ request, context }: Route.ActionArgs) {
+  return submitCustomerLogin(request, context);
+}
 ```
+
+El componente de la ruta pinta `CustomerLoginForm` con
+`data={actionData ?? loaderData}`. Su prop `classNames` define `form`, `field`,
+`label`, `input`, `button`, `secondary`, `error` y `hint`; la página, la
+tipografía, los colores y los controles siguen siendo del tema. Los temas de
+Ecomiq ya traen esta integración.
+
+Para una interfaz propia, usa `<Form method="post">` de React Router con los
+mismos helpers y este contrato:
+
+| `intent` | Campos del formulario                                                                                           |
+| -------- | --------------------------------------------------------------------------------------------------------------- |
+| `send`   | `email` y el token CAPTCHA si está habilitado.                                                                  |
+| `verify` | `code` de seis dígitos; en el paso `secondFactor`, el código de autenticación o recuperación en `secondFactor`. |
+| `resend` | El token CAPTCHA si está habilitado; respeta `retryAt`.                                                         |
+| `reset`  | Ninguno; vuelve al ingreso del correo.                                                                          |
+
+Los datos públicos son `step`, `email`, `captcha`, `retryAt` y `error`. La
+transacción OAuth, PKCE y las claves de verificación viajan en una cookie
+firmada HttpOnly; el formulario propio no envía esos valores.
+
+CAPTCHA es opcional por tienda e independiente del modo: `off`, Turnstile o
+Google reCAPTCHA v2. `CustomerLoginForm` carga y reinicia el proveedor
+configurado. Una interfaz propia envía `cf-turnstile-response` o
+`g-recaptcha-response`; Turnstile usa la acción `customer_login_code`.
+
+## Registro de clientes
+
+La tienda configura nombre, apellido, teléfono y fecha de nacimiento como
+`hidden`, `optional` o `required`. Después del código, los dos modos de login
+crean la sesión y consultan `GET /v1/customer/registration`. Si falta completar
+el alta, redirigen a `/account/register?next=...`; el destino se limita a una
+ruta interna segura.
+
+La ruta de registro usa `loadCustomerRegistration` en el loader,
+`submitCustomerRegistration` en la action y `CustomerRegistrationForm` con las
+mismas clases del login. Los datos incluyen `registration`, `storeName`, `next`,
+`today` (la fecha local de la tienda) y `error`. Una interfaz propia envía
+`firstName`, `lastName`, `phone` y `dateOfBirth` (`YYYY-MM-DD`) con
+`<CustomerCsrfField />`.
+
+`intent=complete` guarda los campos visibles; `intent=skip` omite los opcionales
+cuando no hay obligatorios. Los dos llaman `POST /v1/customer/registration`. El
+backend valida los requisitos vigentes y recuerda que el cliente completó el
+paso: un cliente existente solo vuelve si faltan datos que ahora son
+obligatorios.
+
+Las rutas de cuenta usan `requireCustomer`. El checkout admite invitados y llama
+`requireCustomerRegistration(request, context, current)` cuando hay sesión. La
+ruta de registro usa `customer` para no redirigirse a sí misma. La API también
+exige el registro completo antes de las operaciones protegidas.
+
+## Enlaces de catálogo
+
+Los enlaces a productos y categorías siguen funcionando aunque cambien su
+patrón, slug o URL personalizada. Los menús se resuelven en la configuración
+cacheada del servidor. Para botones y otros enlaces editables, `catalogLinks()`
+genera `virtual:ecomiq-links` al compilar; no analiza código durante las
+visitas.
+
+El loader raíz pasa ese manifiesto a `readStorefrontLayout` y devuelve
+`storefrontLinks`. `StorefrontLink` y `StorefrontAnchor` usan ese mapa sin hacer
+peticiones. El SDK deduplica los destinos, agrupa hasta 100 por petición y
+comparte los resultados durante 30 segundos; los cambios se ven al renovar esa
+caché.
+
+El loader también devuelve `publishedPages` con las rutas `/pages/<slug>` del
+snapshot público. Los dos componentes ocultan los enlaces a `/pages/...` que
+todavía no están publicados; al publicar la página, el siguiente snapshot
+recupera el enlace sin consultar la API por cada enlace.
+
+El selector del editor guarda la identidad del destino con
+`setting.link("/products/cuaderno", "Comprar", { type: "product", id: "42" })`.
+Con referencia devuelve un `CatalogLink`; sin referencia conserva la URL como
+texto. Los dos sirven para `StorefrontLink` y `StorefrontAnchor`, que mantienen
+el destino aunque otro producto reutilice la URL antigua, y reconocen los
+enlaces viejos que resuelve el historial del catálogo. Los enlaces externos,
+las rutas fuera del catálogo, los parámetros y las anclas se conservan.
+
+En código propio, usa esos componentes para los enlaces editables. Las tarjetas
+que ya reciben `product.url` o `category.url` pueden usar esos valores tal cual.
+
+## Logos de medios de pago
+
+`PaymentLogo` pinta un `<img>` de 38×24 que apunta a
+`/assets/payment-logos/<código>.svg`; el JavaScript de la tienda solo lleva los
+nombres. `paymentLogos()` escribe esos SVG en el build del navegador y los sirve
+en desarrollo. `paymentLogoCodes` convierte los medios de pago de la tienda en
+esos códigos.
+
+## Medición y consentimiento
+
+`@ecomiq/storefront/analytics` carga GA4, Google Tag Manager, Meta Pixel y el
+código propio que la tienda configura en Admin (**Tienda online → Ajustes →
+Medición y píxeles**), y solo después de que el cliente los acepta. Cada
+herramienta pide su finalidad: GA4, «Medición»; Meta Pixel, «Publicidad»;
+Google Tag Manager y el código propio, las dos, porque pueden llevar cualquier
+etiqueta.
+
+El loader raíz devuelve `analytics: readAnalytics(context, settings, cart)`, que
+es `null` sin IDs ni código propio y en el lienzo del editor. El `Layout` pinta
+`<Analytics />` y `<ConsentBanner />`. El aviso no trae estilos: el tema le pasa
+`className` y `classNames` (`text`, `link`, `configure`, `options`, `option`,
+`actions`, `accept`, `reject`; sin `configure` usa la clase de `link`). Nombra
+los proveedores que usa la tienda, avisa que los datos pueden tratarse fuera del
+país y enlaza `/pages/privacidad` si existe. «Rechazar» y «Aceptar» van en la
+primera capa; «Configurar» muestra una casilla sin marcar por finalidad y
+«Guardar». Se pinta solo en el navegador.
+
+La decisión se guarda 12 meses en la cookie `__Host-ecomiq-consent` como
+`<elección>|<versión>|<fecha ISO>`, por ejemplo
+`analytics.marketing|2.gm.4|2026-10-12T15:30:00.000Z` o `none|…`. La versión
+junta la del aviso, las herramientas activas y la versión publicada de la página
+de privacidad: si cambia, el aviso vuelve a preguntar y nada se carga hasta la
+nueva decisión. Una cookie sin versión no cuenta como decisión. Las cookies del
+SDK usan el prefijo `__Host-` y `Secure`, así que otra tienda del mismo dominio
+no puede escribirlas.
+
+Para otros scripts, `window.ecomiq.consent.get()` devuelve
+`{ analytics, marketing, version, date }` o `null`,
+`window.ecomiq.consent.set({ analytics, marketing })` guarda una decisión y el
+evento `ecomiq:consent` avisa cada cambio.
+
+Para cambiar o retirar la decisión, el pie del tema pinta `<ConsentLink />`
+(«Cookies», con las clases de los enlaces vecinos): vuelve a abrir el aviso y no
+pinta nada cuando la tienda no mide. Retirar una finalidad borra sus cookies
+(`_ga*`, `_gid`, `_gat*`, `_fbp`, `_fbc`, `_gcl_*`), avisa a Google y Meta y
+recarga la página si alguna herramienta ya estaba cargada.
+
+Los loaders del SDK agregan `analytics` a sus datos (`productPage`,
+`resolvePage`, `collectionPage`, `loadCheckout`, `loadOrderStatus`) y la ruta
+`/products` usa `catalogAnalytics(q, result.products)`; las rutas devuelven esa
+clave tal cual. `<Analytics />` envía `page_view`, `view_item`,
+`view_item_list`, `search`, `add_to_cart` y `remove_from_cart` (comparando el
+carrito de la raíz), `begin_checkout` una vez por carrito y `purchase`, que lee
+la cookie `__Host-ecomiq-purchase` de 10 minutos que deja el pago cuando hay
+consentimiento.
+
+## Secciones de Ecomiq
+
+`@ecomiq/storefront/sections/<id>` trae secciones de página listas:
+
+| Sección          | Nombre en el editor    | Componente y datos                                                                                                                      |
+| ---------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `order-tracking` | Seguimiento            | `<OrderTracking loaderData={…} />` con `loadTracking`.                                                                                  |
+| `draft-invoice`  | Pedido por pagar       | `<DraftInvoice loaderData={…} actionData={…} />` con `loadOrderDraft` y `orderDraftAction`.                                             |
+| `complaint-book` | Libro de Reclamaciones | `<ComplaintBook loaderData={…} actionData={…} />` con `loadComplaintBook` y `complaintBookAction`, en la ruta `libro-de-reclamaciones`. |
+
+Cada una exporta `catalog` y `settings` como las secciones del tema;
+`complaint-book` no tiene ajustes. `complaintBookLinks(settings)` devuelve el
+enlace del pie solo para tiendas en soles, igual que la API, que responde 404 al
+resto. Su formulario usa `<Captcha>` con la acción Turnstile `complaint_book` y
+va en multipart con hasta 3 adjuntos (JPG, PNG, WebP o PDF de hasta 5 MB);
+`complaintBookAttachmentError(files)` los valida en el navegador y en la action.
+
+Las secciones se pintan con el kit del tema: importan `@theme/ui/*` (`button`,
+`input`, `label`, `textarea`, `checkbox`, `radio-group`, `select`), que
+`themeUi()` lleva a `app/components/ui/*`, y solo usan clases con los tokens del
+tema. Si al tema le falta un componente, el build falla con el archivo que falta
+y la sección que lo usa.
+
+El código fuente viaja en `src/sections` del paquete: «Personalizar» en el
+editor lo copia a `app/components/sections/<id>.tsx` y apunta la ruta a esa
+copia.
+
+## Temas publicados
+
+Un tema publicado es un build compilado. Para que una tienda use una función
+nueva del SDK, como el login dentro de la tienda o los enlaces de catálogo, hay
+que actualizar el tema y volver a publicarlo. Cambiar solo la configuración de
+la tienda no modifica builds anteriores. Los cambios posteriores de URLs del
+catálogo no necesitan otra publicación.
+
+En desarrollo contra un Identity local, `ECOMIQ_AUTH_URL` (por ejemplo
+`http://localhost:8000`) cambia el transporte del BFF hacia Identity sin tocar
+la autoridad OAuth pública ni la validación TLS.
+
+## Licencia
+
+MIT