@ecomiq/storefront 1.0.2 → 1.1.0

package/README.md

@@ -61,17 +61,18 @@ Si defines `slugStore`, `getPublicStore` usa ese slug (útil en localhost). Si n
 
 | Import | Uso |
 |--------|-----|
-| `@ecomiq/storefront` | **Client:** `EcomiqProvider`, hooks (`useStoreProducts`, …). **Server** (`react-server`): config (`loadEcomiqConfig`, …) |
-| `@ecomiq/storefront/nextjs` | **Server** (`react-server`): `getPublicStore`, cliente BFF server, auth helpers. **Client:** `EcomiqProvider`, hooks |
+| `@ecomiq/storefront` | Tipos, schemas Zod, utilidades vanilla (`formatCurrency`, …). **Server** (`react-server`): config (`loadEcomiqConfig`, …) |
+| `@ecomiq/storefront/react` | **Client** (`"use client"`): `EcomiqProvider`, hooks BFF, componentes reutilizables |
+| `@ecomiq/storefront/nextjs` | **Server** (`react-server`): `getPublicStore`, cliente BFF server, auth helpers. **Client:** reexport de `/react` |
 | `@ecomiq/storefront/nextjs/api` | Proxy `/api/store/*` (App Router) |
 | `@ecomiq/storefront/nextjs/css` | Tailwind mínimo (opcional) |
 | `@ecomiq/storefront/nextjs/postcss` | PostCSS de referencia |
 | `@ecomiq/storefront/tanstack` | TanStack server + reexport client (misma API client que `/nextjs`) |
 | `@ecomiq/storefront/tanstack/api` | Proxy `/api/store/*` (server routes) |
 
-Importa hooks desde `@ecomiq/storefront` o desde `@ecomiq/storefront/nextjs`. El build npm separa internamente server y client para App Router — **no necesitas** subpaths `/server` ni `/client`.
+Importa hooks y `EcomiqProvider` desde `@ecomiq/storefront/react`. El build npm separa server (`react-server`), vanilla (raíz) y React (`/react`) para App Router.
 
-Los hooks (`useStoreProducts`, `useStoreCart`, …) tienen **una sola implementación** reexportada por ambos adapters; solo cambia el bootstrap server (`getPublicStore`, handler del proxy).
+Los hooks (`useStoreProducts`, `useStoreCart`, …) viven en `/react`; `/nextjs` y `/tanstack` los reexportan en client por compatibilidad.
 
 ### Peers
 
@@ -97,7 +98,7 @@ Los hooks (`useStoreProducts`, `useStoreCart`, …) tienen **una sola implementa
          │                                                   │
          └─────────────────────────┬─────────────────────────┘
                                    ▼
-              Capa React compartida (hooks, EcomiqProvider, cliente BFF, auth)
+              Capa React (`/react`) — hooks, EcomiqProvider, cliente BFF browser, auth
                                    │
                                    ▼
               core/server — fetchPublicStoreSettings · handleStoreProxyRequest
@@ -132,8 +133,8 @@ Los hooks y `EcomiqProvider` son **Client Components** (`"use client"`). En el l
 // app/ecomiq-provider.tsx
 "use client";
 
-import { EcomiqProvider } from "@ecomiq/storefront";
-import type { StorefrontSettings } from "@ecomiq/storefront/nextjs";
+import { EcomiqProvider } from "@ecomiq/storefront/react";
+import type { StorefrontSettings } from "@ecomiq/storefront";
 
 export function EcomiqRootProvider({
   store,
@@ -170,12 +171,12 @@ export default async function RootLayout({ children }: { children: React.ReactNo
 
 ### 3. Catálogo con hooks
 
-Puedes importar hooks desde el paquete raíz o desde `/nextjs`:
+Importa hooks desde `@ecomiq/storefront/react`:
 
 ```tsx
 "use client";
 
-import { useStoreProducts } from "@ecomiq/storefront";
+import { useStoreProducts } from "@ecomiq/storefront/react";
 
 export function ProductList() {
   const { useStorefrontProductsList } = useStoreProducts();
@@ -231,7 +232,7 @@ export const Route = createFileRoute("/api/store/$")({
 // src/components/ecomiq-provider.tsx
 "use client";
 
-import { EcomiqProvider } from "@ecomiq/storefront";
+import { EcomiqProvider } from "@ecomiq/storefront/react";
 import type { StorefrontSettings } from "@ecomiq/storefront/tanstack";
 
 export function EcomiqRootProvider({
@@ -271,7 +272,7 @@ function RootComponent() {
 ```tsx
 "use client";
 
-import { useStoreProducts, useStoreCart } from "@ecomiq/storefront";
+import { useStoreProducts, useStoreCart } from "@ecomiq/storefront/react";
 ```
 
 ---
@@ -373,21 +374,30 @@ export function AccountActions() {
 }
 ```
 
-En TanStack, cambia el import a `@ecomiq/storefront/tanstack`.
+En TanStack, cambia el import server a `@ecomiq/storefront/tanstack` y los hooks a `@ecomiq/storefront/react`.
 
 ---
 
-## Qué incluye cada adapter
+## Qué incluye cada entry
 
-Desde `/nextjs` o `/tanstack` obtienes:
+Desde `/nextjs` o `/tanstack` (**server**, condición `react-server`):
+
+- `getPublicStore`, `getHostname`, `fetchPublicStoreSettings`
+- Cliente BFF server: `getStorefrontProducts`, `registerCustomer`, carrito/cuenta, etc.
+- Auth server: `ecomiqOAuthPassword`
+
+Desde `@ecomiq/storefront/react` (**client**, `"use client"`):
 
-- **Server:** `getPublicStore`, `getHostname`, `fetchPublicStoreSettings` (agnóstico)
 - **Provider:** `EcomiqProvider`, `useStore`, `usePublicStore`
 - **Hooks BFF:** `useStoreProducts`, `useStoreCollections`, `useStorePages`, `useStoreCart`
-- **Cliente:** `getStorefrontProducts`, `registerCustomer`, servicios de carrito/cuenta, etc.
-- **Auth:** `ecomiqOAuthPassword`, `ecomiqOAuthPasswordClient`, `signInWithEcomiqCredentials`, `useStorefrontSession`
-- **Tipos y Zod:** `StorefrontSettings`, `StorefrontProduct`, schemas, `formatCurrency`
-- **Utilidades:** `findStorefrontCmsPageBySlug`, selector de variantes de producto
+- **Auth client:** `ecomiqOAuthPasswordClient`, `signInWithEcomiqCredentials`, `useStorefrontSession`
+- **Componentes:** selector de variantes de producto (más en futuras versiones)
+
+Desde `@ecomiq/storefront` (raíz — vanilla, server o client):
+
+- **Tipos y Zod:** `StorefrontSettings`, `StorefrontProduct`, schemas
+- **Utilidades:** `formatCurrency`, `countryCurrency`, `sanitizeHtml`, `stripHtml`, labels de pedidos, `findStorefrontCmsPageBySlug`
+- **Config** (solo server): `loadEcomiqConfig`, `EcomiqConfigSchema`, …
 
 ## Variables de entorno
 

package/dist/{chunk-TDQ53V3E.js → chunk-3C4ZLHSU.js}

@@ -1,11 +1,12 @@
-import { StorefrontSettingsSchema, resolvePublicStoreKey, getStorefrontSettingsFromKvByStoreKey } from './chunk-PCLA4TZF.js';
-import { STOREFRONT_ECOMIQ_OAUTH_COOKIE_NAME, STOREFRONT_ECOMIQ_OAUTH_COOKIE_PATH } from './chunk-Q762YXCQ.js';
+import { resolvePublicStoreKey, getStorefrontSettingsFromKvByStoreKey } from './chunk-W372BFMG.js';
+import { StorefrontProductsParamsSchema, StorefrontProductsResponseSchema, StorefrontProductDetailSchema, StorefrontCollectionsResponseSchema, StorefrontCollectionDetailSchema, StorefrontPageListItemSchema, StorefrontPageDetailSchema } from './chunk-ASFU32ZM.js';
+import { StorefrontSettingsSchema } from './chunk-EADDSNJS.js';
+import { STOREFRONT_ECOMIQ_OAUTH_COOKIE_NAME, STOREFRONT_ECOMIQ_OAUTH_COOKIE_PATH } from './chunk-3URTJY6X.js';
 import { z } from 'zod';
 import { createAuthMiddleware, createAuthEndpoint, formCsrfMiddleware } from 'better-auth/api';
 import { APIError } from 'better-auth';
 import { setSessionCookie } from 'better-auth/cookies';
 import { parseUserOutput } from 'better-auth/db';
-import axios from 'axios';
 
 // src/core/client/store-api-client.ts
 var STORE_API_PATH = "/api/store";
@@ -214,188 +215,6 @@ function isCartNotActiveApiError(error) {
   const keys = body?.errors ? Object.keys(body.errors) : [];
   return keys.includes("Carts.NotActive");
 }
-var ProductVariantSchema = z.object({
-  id: z.coerce.string(),
-  name: z.string(),
-  storeId: z.string(),
-  productId: z.coerce.string(),
-  basePrice: z.number().positive().optional().nullable(),
-  comparePrice: z.number().positive().optional().nullable(),
-  //TODO: remove this field
-  originalPrice: z.number().positive().optional().nullable(),
-  costPrice: z.number().positive().optional().nullable(),
-  isDefault: z.boolean().optional().nullable(),
-  reserveStock: z.number().nonnegative().optional().nullable(),
-  weight: z.number().nonnegative().optional().nullable().default(0),
-  width: z.number().nonnegative().optional().nullable(),
-  height: z.number().nonnegative().optional().nullable(),
-  unitOfMeasure: z.string().optional().nullable(),
-  order: z.number().nonnegative().optional().nullable().default(0),
-  sku: z.string().optional().nullable(),
-  stock: z.number().nonnegative().optional().nullable(),
-  leadTime: z.string().optional().nullable(),
-  barCode: z.string().optional().nullable(),
-  shippingWeight: z.number().nonnegative().optional().nullable(),
-  images: z.array(z.string()).optional().nullable(),
-  attributes: z.array(z.string()).optional().nullable(),
-  variantStatus: z.string().optional().nullable(),
-  status: z.string().optional().nullable(),
-  createdOn: z.string().optional().nullable(),
-  updatedOn: z.string().optional().nullable(),
-  deletedOn: z.string().optional().nullable()
-});
-var ProductSchema = z.object({
-  id: z.coerce.string(),
-  name: z.string(),
-  images: z.array(z.object({
-    url: z.string().url(),
-    name: z.string().optional(),
-    isPrimary: z.boolean().optional()
-  })),
-  basePrice: z.number().positive().optional(),
-  salePrice: z.number().positive().optional(),
-  slug: z.string(),
-  description: z.string().optional(),
-  categories: z.array(z.object({
-    id: z.coerce.string(),
-    name: z.string(),
-    slug: z.string(),
-    logo: z.string().optional(),
-    icon: z.string().optional()
-  })).optional(),
-  tags: z.array(z.string()).optional(),
-  inStock: z.boolean().optional(),
-  variants: z.array(ProductVariantSchema).optional()
-});
-z.object({
-  items: z.array(ProductSchema),
-  meta: z.object({
-    total: z.number().int().positive(),
-    page: z.number().int().positive(),
-    pageSize: z.number().int().positive(),
-    hasNextPage: z.boolean()
-  })
-});
-z.object({
-  category: z.string().optional(),
-  search: z.string().optional(),
-  minPrice: z.number().positive().optional(),
-  maxPrice: z.number().positive().optional(),
-  inStock: z.boolean().optional(),
-  sortBy: z.enum(["name", "price", "createdAt"]).optional(),
-  sortOrder: z.enum(["asc", "desc"]).optional(),
-  page: z.number().int().positive().optional(),
-  limit: z.number().int().positive().optional()
-});
-var StorefrontProductSchema = z.object({
-  id: z.coerce.string(),
-  name: z.string(),
-  slug: z.string(),
-  productType: z.string().optional().nullable(),
-  imageUrl: z.string().optional().nullable(),
-  price: z.number().nonnegative(),
-  compareAtPrice: z.number().nonnegative().optional().nullable(),
-  variantCount: z.number().int().nonnegative().optional().default(0),
-  isAvailable: z.boolean(),
-  totalInventory: z.number().int().nonnegative(),
-  bundleItemsCount: z.number().int().nonnegative().optional().default(0),
-  brand: z.string().optional().nullable(),
-  category: z.string().optional().nullable(),
-  status: z.string().optional().nullable(),
-  tags: z.array(z.string()).optional().nullable()
-});
-var StorefrontFacetSchema = z.object({
-  value: z.string(),
-  count: z.number().int().nonnegative()
-});
-var StorefrontProductsResponseSchema = z.object({
-  pageIndex: z.number().int().positive(),
-  pageSize: z.number().int().positive(),
-  totalCount: z.number().int().nonnegative(),
-  totalPages: z.number().int().nonnegative(),
-  products: z.array(StorefrontProductSchema),
-  categories: z.array(StorefrontFacetSchema).optional().default([]),
-  brands: z.array(StorefrontFacetSchema).optional().default([]),
-  minPrice: z.number().nonnegative().optional().nullable(),
-  maxPrice: z.number().nonnegative().optional().nullable()
-});
-var StorefrontProductsParamsSchema = z.object({
-  page: z.number().int().positive().optional().default(1),
-  pageSize: z.number().int().positive().optional().default(20),
-  sort: z.enum(["price_asc", "price_desc", "name_asc", "name_desc", "newest"]).optional().default("price_asc"),
-  sellerId: z.string().optional(),
-  search: z.string().optional(),
-  collection: z.string().optional(),
-  category: z.string().optional(),
-  brand: z.string().optional(),
-  productType: z.string().optional(),
-  inStock: z.boolean().optional(),
-  minPrice: z.number().nonnegative().optional(),
-  maxPrice: z.number().nonnegative().optional()
-});
-var StorefrontVariantOptionSchema = z.object({
-  key: z.string(),
-  name: z.string(),
-  value: z.string()
-});
-var StorefrontProductImageSchema = z.object({
-  url: z.string(),
-  name: z.string().optional().nullable(),
-  order: z.number().int().nonnegative().optional()
-});
-var StorefrontVariantSchema = z.object({
-  id: z.coerce.string().optional().default(""),
-  sku: z.string(),
-  status: z.string().optional().nullable(),
-  price: z.number().nonnegative(),
-  compareAtPrice: z.number().nonnegative().optional().nullable(),
-  quantity: z.number().int().nonnegative(),
-  options: z.array(StorefrontVariantOptionSchema).optional().default([]),
-  images: z.array(StorefrontProductImageSchema).optional().default([])
-});
-var StorefrontPriceTierSchema = z.object({
-  variantId: z.coerce.string(),
-  minQuantity: z.number().int().positive(),
-  maxQuantity: z.number().int().positive().optional().nullable(),
-  unitPrice: z.number().nonnegative()
-});
-var StorefrontBundleItemSchema = z.object({
-  productId: z.coerce.string(),
-  variantId: z.coerce.string(),
-  productName: z.string(),
-  variantName: z.string().optional().nullable(),
-  sku: z.string().optional().nullable(),
-  brand: z.string().optional().nullable(),
-  imageUrl: z.string().optional().nullable(),
-  quantity: z.number().int(),
-  availableStock: z.number().int().optional().default(0),
-  allowBackorders: z.boolean().optional().default(false),
-  requiresShipping: z.boolean().optional().default(true)
-});
-var StorefrontProductDetailSchema = z.object({
-  id: z.coerce.string(),
-  name: z.string(),
-  slug: z.string(),
-  description: z.string().optional().nullable(),
-  productType: z.string().optional().nullable(),
-  status: z.string().optional().nullable(),
-  imageUrl: z.string().optional().nullable(),
-  price: z.number().nonnegative(),
-  compareAtPrice: z.number().nonnegative().optional().nullable(),
-  isAvailable: z.boolean(),
-  totalInventory: z.number().int().nonnegative(),
-  brand: z.string().optional().nullable(),
-  category: z.string().optional().nullable(),
-  categoryId: z.coerce.string().optional().nullable(),
-  tags: z.array(z.string()).optional().nullable(),
-  specifications: z.array(z.record(z.string(), z.unknown())).optional().default([]),
-  variants: z.array(StorefrontVariantSchema).optional().default([]),
-  images: z.array(StorefrontProductImageSchema).optional().default([]),
-  bundleItems: z.array(StorefrontBundleItemSchema).optional().default([]),
-  priceTiers: z.array(StorefrontPriceTierSchema).optional().default([]),
-  createdAt: z.string().optional().nullable(),
-  updatedAt: z.string().optional().nullable()
-});
 
 // src/core/client/store-api-product.service.ts
 async function getStorefrontProducts(params, cacheKey) {
@@ -426,17 +245,6 @@ async function getStorefrontProductBySlug(slug) {
   const response = await client.get(path);
   return StorefrontProductDetailSchema.parse(response);
 }
-var StorefrontCollectionSchema = z.object({
-  id: z.coerce.string(),
-  slug: z.string(),
-  name: z.string(),
-  description: z.string().nullable().optional(),
-  imageUrl: z.string().nullable().optional(),
-  type: z.string(),
-  productCount: z.number().int().nonnegative()
-});
-var StorefrontCollectionsResponseSchema = z.array(StorefrontCollectionSchema);
-var StorefrontCollectionDetailSchema = StorefrontCollectionSchema;
 
 // src/core/client/store-api-collection.service.ts
 async function getStorefrontCollections() {
@@ -451,42 +259,6 @@ async function getStorefrontCollectionBySlug(slug) {
   );
   return StorefrontCollectionDetailSchema.parse(response);
 }
-var StorefrontPageListItemSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  slug: z.string(),
-  layout: z.string()
-});
-var StorefrontPageSeoSchema = z.object({
-  title: z.string().optional(),
-  description: z.string().optional()
-}).optional();
-var StorefrontPageSettingsSchema = z.object({
-  seo: StorefrontPageSeoSchema,
-  html: z.string().optional(),
-  title: z.string().optional()
-}).catchall(z.unknown());
-var StorefrontPageBlockSchema = z.object({
-  id: z.string(),
-  type: z.string(),
-  order: z.number(),
-  settings: z.record(z.unknown()).optional()
-});
-var StorefrontPageSectionSchema = z.object({
-  id: z.string(),
-  type: z.string(),
-  order: z.number(),
-  settings: z.record(z.unknown()).optional(),
-  blocks: z.array(StorefrontPageBlockSchema).optional().default([])
-});
-var StorefrontPageDetailSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  slug: z.string(),
-  layout: z.string(),
-  settings: StorefrontPageSettingsSchema.optional(),
-  sections: z.array(StorefrontPageSectionSchema).optional()
-});
 async function getStorefrontPages() {
   const client = await getStoreApiClient();
   const response = await client.get("pages");
@@ -1507,92 +1279,6 @@ function collectNetworkErrorCodes(e) {
   return out;
 }
 
-// src/react/shell/lib/find-storefront-cms-page.ts
-function isRenderableCmsPage(p) {
-  if (!p.status) return true;
-  return p.status === "published";
-}
-function findStorefrontCmsPageBySlug(settings, slug) {
-  const pages = settings?.cms?.pages;
-  if (!pages?.length) return null;
-  const raw = pages.find(
-    (p) => p.slug === slug && isRenderableCmsPage(p)
-  );
-  if (!raw) return null;
-  const parsed = StorefrontPageDetailSchema.safeParse(raw);
-  return parsed.success ? parsed.data : null;
-}
-
-// src/core/constants/currency.ts
-var countryCurrency = {
-  "PEN": "es-PE",
-  "USD": "en-US",
-  "COP": "es-CO",
-  "MXN": "es-MX"
-};
-
-// src/core/utils/format-currency.ts
-function formatCurrency(amount, currency = "USD") {
-  const locale = countryCurrency[currency] ?? "en-US";
-  return new Intl.NumberFormat(locale, {
-    style: "currency",
-    currency
-  }).format(amount);
-}
-var ApiClient = class {
-  client;
-  storeId;
-  storeDomain;
-  constructor(baseURL = "https://storefront.ecomiq.pe") {
-    this.client = axios.create({
-      baseURL,
-      timeout: 1e4,
-      headers: {
-        "Content-Type": "application/json"
-      }
-    });
-    this.client.interceptors.request.use(
-      (config) => {
-        if (config.headers) {
-          if (this.storeId) config.headers["X-Store-Id"] = this.storeId;
-          if (this.storeDomain) config.headers["X-Store-Domain"] = this.storeDomain;
-        }
-        return config;
-      }
-    );
-    this.client.interceptors.response.use(
-      (response) => response,
-      (error) => {
-        console.error("API Error:", error);
-        return Promise.reject(error);
-      }
-    );
-  }
-  setStoreId(storeId) {
-    this.storeId = storeId;
-  }
-  /** Subdominio para endpoints que usan X-Store-Domain (ej. GET /v1/storefront/settings) */
-  setStoreDomain(domain) {
-    this.storeDomain = domain;
-  }
-  get(url, config) {
-    return this.client.get(url, config).then((response) => response.data);
-  }
-  post(url, data, config) {
-    return this.client.post(url, data, config).then((response) => response.data);
-  }
-  put(url, data, config) {
-    return this.client.put(url, data, config).then((response) => response.data);
-  }
-  patch(url, data, config) {
-    return this.client.patch(url, data, config).then((response) => response.data);
-  }
-  delete(url, config) {
-    return this.client.delete(url, config).then((response) => response.data);
-  }
-};
-new ApiClient();
-
-export { CustomerAddressSchema, CustomerAddressUpsertSchema, CustomerMeSchema, CustomerOrderDetailSchema, CustomerOrderListItemSchema, CustomerProfilePatchSchema, CustomerRegisterRequestSchema, StoreApiClient, StorefrontProductSchema, StorefrontProductsResponseSchema, addCartCoupon, applyServerRequestOriginFromHeaders, checkoutCart, createCart, createCustomerAddress, createStoreApiClient, customerMeToProfilePatch, deleteCustomerAddress, ecomiqOAuthPassword, fetchPublicStoreSettings, findStorefrontCmsPageBySlug, formatCurrency, getCart, getCartCheckout, getCartPaymentMethods, getCustomerAddresses, getCustomerMe, getCustomerOrder, getCustomerOrders, getSharedOrderDraft, getShippingOptions, getStoreApiBaseUrl, getStoreApiClient, getStorefrontCollectionBySlug, getStorefrontCollections, getStorefrontPageBySlug, getStorefrontPagePreview, getStorefrontPages, getStorefrontProductBySlug, getStorefrontProducts, getStorefrontSettings, isCartNotActiveApiError, normalizeRequestHostname, patchCartAddresses, patchCartBuyer, patchCustomer, putCartShippingMethod, registerCustomer, removeCartCoupon, resolvePublicStoreSettingsSource, setClientStoreId, setServerRequestOrigin, setServerStoreId, storeApiClient, updateCustomerAddress, uploadPaymentReceipt };
-//# sourceMappingURL=chunk-TDQ53V3E.js.map
-//# sourceMappingURL=chunk-TDQ53V3E.js.map
+export { CustomerAddressSchema, CustomerAddressUpsertSchema, CustomerMeSchema, CustomerOrderDetailSchema, CustomerOrderListItemSchema, CustomerProfilePatchSchema, CustomerRegisterRequestSchema, StoreApiClient, addCartCoupon, applyServerRequestOriginFromHeaders, checkoutCart, createCart, createCustomerAddress, createStoreApiClient, customerMeToProfilePatch, deleteCustomerAddress, ecomiqOAuthPassword, fetchPublicStoreSettings, getCart, getCartCheckout, getCartPaymentMethods, getCustomerAddresses, getCustomerMe, getCustomerOrder, getCustomerOrders, getSharedOrderDraft, getShippingOptions, getStoreApiBaseUrl, getStoreApiClient, getStorefrontCollectionBySlug, getStorefrontCollections, getStorefrontPageBySlug, getStorefrontPagePreview, getStorefrontPages, getStorefrontProductBySlug, getStorefrontProducts, getStorefrontSettings, isCartNotActiveApiError, normalizeRequestHostname, patchCartAddresses, patchCartBuyer, patchCustomer, putCartShippingMethod, registerCustomer, removeCartCoupon, resolvePublicStoreSettingsSource, setClientStoreId, setServerRequestOrigin, setServerStoreId, storeApiClient, updateCustomerAddress, uploadPaymentReceipt };
+//# sourceMappingURL=chunk-3C4ZLHSU.js.map
+//# sourceMappingURL=chunk-3C4ZLHSU.js.map