@ecomiq/storefront 2.1.3 → 3.0.0

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,133 +1,160 @@
-# @ecomiq/storefront
+# Login de clientes
 
-Micro framework SSR de Ecomiq para storefronts. Páginas, datos y deploy sin
-configurar TanStack Start, Vite ni Cloudflare a mano.
+La tienda elige el modo de acceso en Admin, en **Configuración → Compra → Cuentas de clientes**. El SDK consulta esa configuración: `hosted` redirige a Identity y `storefront` muestra el formulario del tema. Ambos modos usan las mismas cuentas y sesión de cliente.
 
-## Instalación
-
-```bash
-npm install @ecomiq/storefront
-# o
-yarn add @ecomiq/storefront
-# o
-pnpm add @ecomiq/storefront
-```
-
-Peer deps: `react` y `react-dom` ^19.
-
-## Uso
-
-```js
-// ecomiq.config.js
-import { defineConfig } from '@ecomiq/storefront/config'
-
-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' },
-})
-```
+La ruta `/account/login` integra dos helpers:
 
 ```tsx
-// pages/index.tsx
-import { definePage, serverApi } from '@ecomiq/storefront'
+import { CustomerLoginForm, startCustomerLogin, submitCustomerLogin } from "@ecomiq/storefront";
+import type { Route } from "./+types/login";
 
-export default definePage({
-  loader: () => serverApi.getProducts({ page: 1, pageSize: 12 }),
-  component: ({ data }) => <pre>{JSON.stringify(data.products, null, 2)}</pre>,
-})
-```
-
-CLI:
-
-```bash
-npx ecomiq dev
-npx ecomiq build
-npx ecomiq deploy
-```
-
-Si actualizas el package y `.ecomiq` quedó de una versión anterior:
-
-```bash
-npx ecomiq clean
-npx ecomiq dev
-```
-
-### Runtime de desarrollo
-
-`ecomiq dev` usa **Node** por defecto. Para emular Workers en local:
-
-```js
-dev: { port: 3000, runtime: 'workerd' },
-```
-
-`ecomiq build` / `deploy` siempre empaquetan para Cloudflare Workers.
-
-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.
-
-Ver el monorepo [ecomiq-storefront](https://github.com/ecomiq/ecomiq-storefront) para la app de referencia y más documentación.
-
-## Storefront declarativo
-
-`StorefrontDefinition v1` permite construir y versionar una tienda sin generar
-código React arbitrario. El contrato valida tema, navegación, footer y ocho
-tipos de sección: `hero`, `product-grid`, `collection-grid`, `promo-banner`,
-`image-text`, `rich-text`, `testimonials` y `newsletter`.
+export function loader({ request, context }: Route.LoaderArgs) {
+  return startCustomerLogin(request, context);
+}
 
-```tsx
-import {
-  StorefrontDefinitionRenderer,
-  createDefaultStorefrontDefinition,
-} from '@ecomiq/storefront'
-
-const definition = createDefaultStorefrontDefinition({
-  storeName: 'Casa Lumbre',
-  description: 'Cerámica producida localmente.',
-})
-
-export function Home() {
-  return (
-    <StorefrontDefinitionRenderer
-      definition={definition}
-      locale="es-PE"
-      currency="PEN"
-      data={{
-        productsBySectionId: {
-          'featured-products': [],
-        },
-        collectionsBySectionId: {
-          'featured-collections': [],
-        },
-      }}
-    />
-  )
+export function action({ request, context }: Route.ActionArgs) {
+  return submitCustomerLogin(request, context);
 }
 ```
 
-Los sistemas que solo necesitan validar o modificar el contrato pueden importar
-el subpath sin cargar el renderer:
-
-```ts
-import {
-  StorefrontDefinitionSchema,
-  StorefrontDefinitionPatchSchema,
-  applyStorefrontDefinitionPatch,
-  type StorefrontDefinitionInput,
-  type StorefrontDefinitionPatchInput,
-} from '@ecomiq/storefront/definition'
-```
+El componente de la ruta puede usar `CustomerLoginForm` con `data={actionData ?? loaderData}`. Su prop `classNames` define `form`, `field`, `label`, `input`, `button`, `secondary`, `error` y `hint`; la página, tipografía, colores y controles conservan el diseño del tema. Los 13 temas incluidos tienen esta integración.
+
+También se puede crear una interfaz propia con `<Form method="post">` de React Router, manteniendo esos helpers y este contrato:
 
-Cada definición lleva `version` y `revision`. Los patches son puros, exigen
-`expectedRevision` y conservan el ID de una sección al reemplazarla. Soportan
-`section.add`, `section.replace`, `section.remove`, `section.reorder`,
-`theme.replace`, `navigation.replace` y `footer.replace`.
-
-El template productivo consulta server-side
-`GET /v1/runtime/storefronts/:storeSlug`, revalida la publicación mediante
-ETag y resuelve los `product-grid.source` y `collection-grid.source` contra el
-API storefront. La publicación declarativa reemplaza solo el contenido de la
-home; el layout comercial y las rutas de catálogo, producto, carrito, checkout
-y cuenta siguen siendo las del framework.
+| `intent` | Campos del formulario |
+| --- | --- |
+| `send` | `email` y token CAPTCHA si está habilitado |
+| `verify` | `code` de seis dígitos; en el paso `secondFactor`, `secondFactor` de autenticación o recuperación |
+| `resend` | Token CAPTCHA si está habilitado; respeta `retryAt` |
+| `reset` | Ninguno; vuelve al ingreso del correo |
+
+Los datos públicos incluyen `step`, `email`, `captcha`, `retryAt` y `error`. La transacción OAuth, PKCE y las claves de verificación permanecen en una cookie firmada HttpOnly; el formulario propio no debe enviar esos valores.
+
+CAPTCHA es independiente del modo y opcional por tienda: `off`, Turnstile o Google reCAPTCHA v2. `CustomerLoginForm` carga y reinicia el proveedor configurado. Una UI propia debe enviar `cf-turnstile-response` o `g-recaptcha-response`; Turnstile usa la acción `customer_login_code`.
+
+## Datos del registro
+
+La tienda configura nombre, apellido, teléfono y fecha de nacimiento como `hidden`, `optional` o `required`. Después del código, ambos 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 su loader, `submitCustomerRegistration` en su action y `CustomerRegistrationForm` con las mismas clases personalizables del login. Los datos del formulario incluyen `registration`, `storeName`, `next`, `today` (fecha local de la tienda) y `error`. También puede implementarse una UI propia que envíe `firstName`, `lastName`, `phone` y `dateOfBirth` (ISO `YYYY-MM-DD`) con `<CustomerCsrfField />`.
+
+`intent=complete` guarda los campos visibles; `intent=skip` permite omitir todos los opcionales cuando no hay obligatorios. Ambos llaman `POST /v1/customer/registration`. El backend valida los requisitos vigentes y recuerda que el cliente completó este paso. Los clientes existentes sólo vuelven si faltan datos que ahora son obligatorios.
+
+Las rutas de cuenta usan `requireCustomer`; checkout permite invitados y llama `requireCustomerRegistration(request, context, current)` cuando hay sesión. La propia ruta de registro usa `customer` para no redirigirse a sí misma. La API también exige completar el registro antes de las operaciones protegidas.
+
+## Desarrollo y temas publicados
+
+En local, `ECOMIQ_AUTH_URL=http://localhost:8000` configura el transporte del BFF hacia Identity sin cambiar la autoridad OAuth pública ni desactivar la validación TLS. Aspire ya proporciona esta dirección al deployer local, que la propaga a los sitios instalados. Los ejemplos `.dev.vars.example` de cada tema la incluyen.
+
+Los temas publicados son artifacts compilados. Para habilitar el modo dentro de la tienda en un tema existente, hay que **recompilar y publicar una versión que incluya los loaders, actions y formularios de login y registro**. Cambiar solamente la configuración de la tienda no modifica artifacts anteriores.
+
+## Enlaces de catálogo
+
+Los temas incluidos mantienen los enlaces a productos y categorías al cambiar
+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, el plugin
+`catalogLinks()` de `@ecomiq/storefront/vite` genera `virtual:ecomiq-links`
+durante la compilación; no analiza código durante las visitas.
+
+El loader raíz pasa ese manifiesto a `readStorefrontLinks(client, manifestLinks)`
+y devuelve el resultado como `storefrontLinks`. `StorefrontLink` y
+`StorefrontAnchor` consumen 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 reflejan al renovar esa caché.
+
+El loader también devuelve `publishedPages`, con las rutas
+``settings.cms.pages.map((page) => `/pages/${page.slug}`)`` del snapshot público.
+Ambos componentes ocultan los enlaces locales `/pages/...` que aún no tienen
+publicación. Al publicar la página, el siguiente snapshot recupera su enlace;
+no se consulta la API por cada enlace ni se modifica la configuración guardada.
+
+El selector del editor conserva la identidad con
+`setting.link("/products/cuaderno", "Comprar", { type: "product", id: "42" })`.
+Con referencia devuelve un `CatalogLink`; sin referencia conserva el texto de
+la URL. Ambos se pueden pasar a `StorefrontLink` y `StorefrontAnchor`, que
+mantienen separados los destinos aunque otro producto reutilice la URL antigua.
+También se reconocen los enlaces anteriores que resuelve el historial del
+catálogo. Los enlaces externos, las rutas ajenas al catálogo y los parámetros
+o anclas se conservan. En código personalizado, usar los componentes anteriores
+para los enlaces editables; las tarjetas que ya reciben `product.url` o
+`category.url` pueden utilizar directamente esos valores.
+
+La instalación inicial de este soporte requiere actualizar y publicar el tema.
+Los cambios posteriores de URLs de catálogo no requieren publicar otra vez.
+
+## 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. El plugin `paymentLogos()` de `@ecomiq/storefront/vite` escribe esos
+SVG en el build del navegador y los sirve en desarrollo.
+
+## 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 (pueden llevar cualquier
+etiqueta).
+
+El loader raíz devuelve `analytics: readAnalytics(context, settings, cart)`;
+es `null` sin IDs ni código propio, y en el lienzo. 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 la tienda usa, 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 `__Host-ecomiq-consent` como
+`<elección>|<versión>|<fecha ISO>` (`analytics.marketing|2.gm.4|2026-10-12T15:30:00.000Z`,
+`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.
+`window.ecomiq.consent.get()` devuelve `{ analytics, marketing, version, date }`
+o `null`; `window.ecomiq.consent.set({ analytics, marketing })` y el evento
+`ecomiq:consent` sirven a otros scripts.
+
+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 por defecto
+
+`@ecomiq/storefront/sections/<id>` trae secciones de página listas:
+`order-tracking` («Seguimiento», `<OrderTracking loaderData={…} />` con el
+loader `loadTracking`), `draft-invoice` («Pedido por pagar»,
+`<DraftInvoice loaderData={…} actionData={…} />` con `loadOrderDraft` y
+`orderDraftAction`) y `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 (como la API, que responde 404 al resto), y el formulario usa `<Captcha>` con la acción Turnstile
+`complaint_book`. El formulario va en multipart con hasta 3 adjuntos (JPG, PNG,
+WebP o PDF de 5 MB); `complaintBookAttachmentError(files)` los valida en el
+navegador y en la action.
+
+Se pintan con el kit del tema: importan `@theme/ui/*` (`button`, `input`,
+`label`, `textarea`, `checkbox`, `radio-group`, `select`),
+que el plugin `themeUi()` de `@ecomiq/storefront/vite` 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.

package/dist/account-Dx4e3syi.js

@@ -0,0 +1,258 @@
+import { optional, text } from "./form-BtQcbXlJ.js";
+import { identityDocumentError, isIdentityDocumentType } from "./documents-T1mzc_j8.js";
+import { ADDRESS_INTENTS, ORDER_REQUEST_INTENTS, isIntent } from "./form-contracts-BNpHaTGJ.js";
+import { readPlace } from "./place-CmW4hBWY.js";
+import { customerHeaders, requireCustomer, requireCustomerWith } from "./session-CKvmFJyg.js";
+import { found, readCountries, readDocumentCountries, store } from "./store-8Q-_LFrQ.js";
+import { requestUrl } from "./urls-CpGQPxvf.js";
+import { data } from "react-router";
+import { ApiError } from "@ecomiq/core";
+// src/account.ts
+const DEFAULT_ADDRESS_LABEL = "Casa";
+function placeName(form, name) {
+	const value = text(form, name);
+	if (value.includes("|")) return readPlace(value).name;
+	return value;
+}
+function readCustomerAddress(form, countryCode) {
+	return {
+		addressKey: text(form, "label") || DEFAULT_ADDRESS_LABEL,
+		countryIsoCode: countryCode,
+		addressLine: text(form, "line"),
+		department: placeName(form, "department") || null,
+		province: placeName(form, "province") || null,
+		district: placeName(form, "district") || null,
+		cellPhone: optional(form, "phone"),
+		reference: optional(form, "reference"),
+		isDefault: form.get("default") === "on"
+	};
+}
+async function loadAccount(request, context) {
+	return { name: (await requireCustomer(request, context)).name };
+}
+const ORDER_STATUSES = [
+	"open",
+	"delivered",
+	"cancelled"
+];
+function readOrderFilters(url) {
+	const status = ORDER_STATUSES.find((value) => value === url.searchParams.get("status")) ?? null;
+	const sort = url.searchParams.get("sort") === "oldest" ? "oldest" : "newest";
+	const view = url.searchParams.get("view") === "grid" ? "grid" : "list";
+	return {
+		q: (url.searchParams.get("q") ?? "").trim().slice(0, 100),
+		status,
+		sort,
+		view
+	};
+}
+/** The query string of the orders list for these filters, without the default values. */
+function orderFiltersQuery(filters) {
+	const query = new URLSearchParams();
+	if (filters.q !== "") query.set("q", filters.q);
+	if (filters.status !== null) query.set("status", filters.status);
+	if (filters.sort === "oldest") query.set("sort", "oldest");
+	if (filters.view === "grid") query.set("view", "grid");
+	return query;
+}
+async function loadOrders(request, context) {
+	const url = requestUrl(request);
+	const filters = readOrderFilters(url);
+	const page = await requireCustomerWith(request, context, (headers) => store(context).getCustomerOrders({
+		...headers,
+		cursor: url.searchParams.get("cursor") ?? void 0,
+		search: filters.q || void 0,
+		status: filters.status ?? void 0,
+		sortDirection: filters.sort === "oldest" ? "asc" : "desc"
+	}));
+	let next = null;
+	if (page.hasNextPage && page.nextCursor) {
+		const query = orderFiltersQuery(filters);
+		query.set("cursor", page.nextCursor);
+		next = `${url.pathname}?${query}`;
+	}
+	return {
+		orders: page.data,
+		next,
+		filters
+	};
+}
+async function loadOrder(request, context, id) {
+	return { order: await found(requireCustomerWith(request, context, (headers) => store(context).getCustomerOrder(id, headers))) };
+}
+const MAX_RETURN_PHOTOS = 3;
+function orderRequestError(error, intent) {
+	const code = error instanceof ApiError ? error.code ?? "" : "";
+	if (code.includes("Receipt")) return "Las fotos deben ser JPG, PNG o WebP de hasta 5 MB.";
+	if (code === "Orders.ReturnPhotosLimit") return "Puedes adjuntar hasta 3 fotos.";
+	if (code === "Orders.ReturnQuantityInvalid") return "Revisa las cantidades a devolver.";
+	if (code === "Orders.ReturnUnavailable") return "Este pedido ya no admite devoluciones.";
+	if (code === "Orders.CancellationUnavailable") return "Este pedido ya no se puede cancelar.";
+	return intent === "return" ? "No pudimos enviar tu solicitud de devolución." : "No pudimos enviar tu solicitud de cancelación.";
+}
+function returnLines(form) {
+	const quantities = form.getAll("quantity");
+	return form.getAll("itemId").map((itemId, index) => ({
+		itemId: String(itemId),
+		quantity: Number(quantities[index] ?? 0)
+	})).filter((line) => line.itemId !== "" && Number.isInteger(line.quantity) && line.quantity > 0);
+}
+/** Return or cancellation request the customer sends from an order of their account. */
+async function orderRequestAction(request, context, orderId) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const intent = text(form, "intent");
+	if (!isIntent(ORDER_REQUEST_INTENTS, intent)) return data({
+		sent: null,
+		error: "Acción no válida."
+	}, { status: 400 });
+	const reason = text(form, "reason");
+	const comment = text(form, "comment") || void 0;
+	if (reason === "") return data({
+		sent: null,
+		error: "Elige un motivo."
+	}, { status: 400 });
+	try {
+		if (intent === "cancel") {
+			await client.requestCustomerOrderCancellation(orderId, {
+				reason,
+				comment
+			}, headers);
+			return {
+				sent: "cancel",
+				error: null
+			};
+		}
+		const items = returnLines(form);
+		if (items.length === 0) return data({
+			sent: null,
+			error: "Elige qué productos quieres devolver."
+		}, { status: 400 });
+		const photos = form.getAll("photos").filter((photo) => photo instanceof File && photo.size > 0);
+		if (photos.length > MAX_RETURN_PHOTOS) return data({
+			sent: null,
+			error: "Puedes adjuntar hasta 3 fotos."
+		}, { status: 400 });
+		await client.requestCustomerOrderReturn(orderId, {
+			reason,
+			comment,
+			items,
+			photos
+		}, headers);
+		return {
+			sent: "return",
+			error: null
+		};
+	} catch (error) {
+		return data({
+			sent: null,
+			error: orderRequestError(error, intent)
+		}, { status: 400 });
+	}
+}
+async function loadAddresses(request, context) {
+	const client = store(context);
+	const [addresses, countries] = await requireCustomerWith(request, context, (headers) => Promise.all([client.getCustomerAddresses(headers), readCountries(client)]));
+	return {
+		addresses,
+		countries
+	};
+}
+async function addressAction(request, context) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const intent = text(form, "intent") || "save";
+	if (!isIntent(ADDRESS_INTENTS, intent)) return data({ error: "Acción no válida." }, { status: 400 });
+	try {
+		if (intent === "delete") {
+			await client.deleteCustomerAddress(text(form, "id"), headers);
+			return { error: null };
+		}
+		if (intent === "default") {
+			const address = (await client.getCustomerAddresses(headers)).find((item) => item.id === text(form, "id"));
+			if (address) await client.updateCustomerAddress(address.id, {
+				...address,
+				isDefault: true
+			}, headers);
+			return { error: null };
+		}
+		const { store: settings } = await client.getSettings();
+		const requestedCountry = text(form, "country");
+		if (requestedCountry !== "" && requestedCountry !== settings.countryCode) return data({ error: "La dirección debe ser dentro del país de la tienda." }, { status: 400 });
+		const input = readCustomerAddress(form, settings.countryCode);
+		if (!input.addressLine || !input.district || !input.cellPhone) return data({ error: "Completa la dirección, el distrito y el celular." }, { status: 400 });
+		const id = text(form, "id");
+		if (id) await client.updateCustomerAddress(id, input, headers);
+		else await client.createCustomerAddress(input, headers);
+		return { error: null };
+	} catch (error) {
+		if (error instanceof ApiError && error.status < 500) return data({ error: "Revisa los datos de la dirección." }, { status: 400 });
+		return data({ error: "No pudimos guardar la dirección." }, { status: 400 });
+	}
+}
+async function loadProfile(request, context) {
+	const client = store(context);
+	const [me, countries] = await requireCustomerWith(request, context, (headers) => Promise.all([client.getCustomerMe(headers), readDocumentCountries(client)]));
+	return {
+		me,
+		countries
+	};
+}
+async function profileAction(request, context) {
+	const current = await requireCustomer(request, context);
+	const client = store(context);
+	const headers = customerHeaders(current);
+	const form = await request.formData();
+	const firstName = text(form, "firstName");
+	const lastName = text(form, "lastName");
+	try {
+		const me = await client.getCustomerMe(headers);
+		const { store: settings } = await client.getSettings();
+		const number = text(form, "document");
+		const type = text(form, "identificationType");
+		const country = text(form, "identificationCountryCode");
+		if (number !== "" && !isIdentityDocumentType(type)) return data({
+			saved: false,
+			error: "Elige el tipo de documento."
+		}, { status: 400 });
+		const documentError = isIdentityDocumentType(type) ? identityDocumentError(type, country, number) : null;
+		if (documentError) return data({
+			saved: false,
+			error: documentError
+		}, { status: 400 });
+		if (me.entityIdentificationNumber && !/^[A-Z]{2}$/.test(country)) return data({
+			saved: false,
+			error: "Elige el país emisor del documento."
+		}, { status: 400 });
+		await client.patchCustomer({
+			firstName,
+			lastName,
+			phone: text(form, "phone"),
+			identificationNumber: number || null,
+			identificationType: number ? type : null,
+			identificationCountryCode: number || me.entityIdentificationNumber ? country : null,
+			entityName: me.entityName,
+			entityIdentificationNumber: me.entityIdentificationNumber,
+			gender: me.gender || null,
+			role: me.role,
+			companyName: me.companyName,
+			dateOfBirth: me.dateOfBirth,
+			consent: me.consent,
+			countryIsoCode: me.countryIsoCode ?? settings.countryCode
+		}, headers);
+		return {
+			saved: true,
+			error: null
+		};
+	} catch {
+		return data({
+			saved: false,
+			error: "No pudimos guardar tus datos."
+		}, { status: 400 });
+	}
+}
+export { addressAction, loadAccount, loadAddresses, loadOrder, loadOrders, loadProfile, orderFiltersQuery, orderRequestAction, profileAction, readCustomerAddress, readOrderFilters };

package/dist/account-forms-AVk71ko7.js

@@ -0,0 +1,39 @@
+import { CustomerCsrfField } from "./customer-csrf-C1oDX-Py.js";
+import { usePageAction } from "./page-action-Ctkf4xC6.js";
+import { Form } from "react-router";
+import { jsx, jsxs } from "react/jsx-runtime";
+// src/account-forms.tsx
+const ADDRESS_ACTION = "/account/addresses";
+const PROFILE_ACTION = "/account/profile";
+function AddressForm({ intent = "save", addressId, children, ...props }) {
+	const action = usePageAction(ADDRESS_ACTION);
+	return /* @__PURE__ */ jsxs(Form, {
+		method: "post",
+		action,
+		...props,
+		children: [
+			/* @__PURE__ */ jsx(CustomerCsrfField, {}),
+			/* @__PURE__ */ jsx("input", {
+				type: "hidden",
+				name: "intent",
+				value: intent
+			}),
+			/* @__PURE__ */ jsx("input", {
+				type: "hidden",
+				name: "id",
+				value: addressId ?? ""
+			}),
+			children
+		]
+	});
+}
+function ProfileForm({ children, ...props }) {
+	const action = usePageAction(PROFILE_ACTION);
+	return /* @__PURE__ */ jsxs(Form, {
+		method: "post",
+		action,
+		...props,
+		children: [/* @__PURE__ */ jsx(CustomerCsrfField, {}), children]
+	});
+}
+export { ADDRESS_ACTION, AddressForm, PROFILE_ACTION, ProfileForm };

package/dist/account-forms.d.ts

@@ -0,0 +1,13 @@
+import { FetcherFormProps } from "react-router";
+type FormProps = Omit<FetcherFormProps, "action" | "method" | "encType">;
+export type AddressFormProps = FormProps & ({
+  intent?: "save";
+  addressId?: string | null;
+} | {
+  intent: "default" | "delete";
+  addressId: string;
+});
+export type ProfileFormProps = FormProps;
+export declare function AddressForm({ intent, addressId, children, ...props }: AddressFormProps): import("react").JSX.Element;
+export declare function ProfileForm({ children, ...props }: ProfileFormProps): import("react").JSX.Element;
+export {};