@ecomiq/storefront 2.1.3 → 3.0.0

package/src/hooks/recently-viewed.ts

@@ -1,125 +0,0 @@
-import { useCallback, useEffect, useState } from 'react'
-import { z } from 'zod'
-import { useSettings } from '../providers/ecomiq'
-
-const RecentlyViewedItemSchema = z.object({
-  id: z.string().min(1),
-  name: z.string().min(1),
-  slug: z.string().min(1),
-  imageUrl: z.string(),
-  price: z.number().nonnegative(),
-  compareAtPrice: z.number().nonnegative().nullable(),
-})
-
-const RecentlyViewedSessionSchema = z.object({
-  version: z.literal(1),
-  storeId: z.string().min(1),
-  items: z.array(RecentlyViewedItemSchema).max(12),
-})
-
-export type RecentlyViewedItem = z.infer<typeof RecentlyViewedItemSchema>
-
-const MAX_ITEMS = 8
-
-function storageKey(storeId: string) {
-  return `ecomiq:recently-viewed:v1:${storeId}`
-}
-
-function readSession(storeId: string) {
-  if (typeof localStorage === 'undefined') return undefined
-  try {
-    const raw = localStorage.getItem(storageKey(storeId))
-    if (!raw) return undefined
-    const parsed = RecentlyViewedSessionSchema.safeParse(JSON.parse(raw))
-    return parsed.success && parsed.data.storeId === storeId ? parsed.data : undefined
-  } catch {
-    return undefined
-  }
-}
-
-/** Lectura síncrona (tests / casos sin React). */
-export function listRecentlyViewed(storeId: string): RecentlyViewedItem[] {
-  return readSession(storeId)?.items ?? []
-}
-
-/** Persistencia síncrona: el item queda al frente y se deduplica por id. */
-export function trackRecentlyViewed(
-  storeId: string,
-  item: RecentlyViewedItem,
-): RecentlyViewedItem[] {
-  const current = listRecentlyViewed(storeId).filter((entry) => entry.id !== item.id)
-  const items = [item, ...current].slice(0, MAX_ITEMS)
-  localStorage.setItem(
-    storageKey(storeId),
-    JSON.stringify({
-      version: 1,
-      storeId,
-      items,
-    } satisfies z.infer<typeof RecentlyViewedSessionSchema>),
-  )
-  return items
-}
-
-export type TrackableProduct = {
-  id: string
-  name: string
-  slug: string
-  imageUrl?: string | null
-  images?: Array<{ url: string }>
-  price: number
-  compareAtPrice: number | null
-}
-
-export function toRecentlyViewedItem(product: TrackableProduct): RecentlyViewedItem {
-  return {
-    id: product.id,
-    name: product.name,
-    slug: product.slug,
-    imageUrl: product.imageUrl || product.images?.[0]?.url || '',
-    price: product.price,
-    compareAtPrice: product.compareAtPrice,
-  }
-}
-
-/**
- * Lista reactiva de productos vistos recientemente de la tienda actual.
- *
- * ```tsx
- * const { items, track } = useRecentlyViewed()
- * ```
- */
-export function useRecentlyViewed() {
-  const { store } = useSettings()
-  const [items, setItems] = useState<RecentlyViewedItem[]>([])
-
-  useEffect(() => {
-    setItems(listRecentlyViewed(store.id))
-  }, [store.id])
-
-  const track = useCallback(
-    (item: RecentlyViewedItem) => {
-      const next = trackRecentlyViewed(store.id, item)
-      setItems(next)
-      return next
-    },
-    [store.id],
-  )
-
-  return { items, track, storeId: store.id }
-}
-
-/**
- * Registra un producto en “visto recientemente” al montar / cambiar de PDP.
- *
- * ```tsx
- * useTrackRecentlyViewed(product)
- * ```
- */
-export function useTrackRecentlyViewed(product: TrackableProduct) {
-  const { store } = useSettings()
-  const item = toRecentlyViewedItem(product)
-
-  useEffect(() => {
-    trackRecentlyViewed(store.id, item)
-  }, [store.id, item.id, item.name, item.slug, item.imageUrl, item.price, item.compareAtPrice])
-}

package/src/index.ts

@@ -1,354 +0,0 @@
-/**
- * API pública de @ecomiq/storefront.
- * Todo lo que el usuario importa sale de aquí o de '@ecomiq/storefront/ui'.
- * Las herramientas internas (router, bundler, SSR) no se exponen.
- */
-import type { ReactNode } from 'react'
-import type { StorefrontSettings } from '@ecomiq/core'
-import type { PublicEcomiqConfig } from './public-config'
-
-export type {
-  EcomiqConfig,
-  EcomiqThemeConfig,
-  PublicEcomiqConfig,
-} from './public-config'
-
-export {
-  createApi,
-  createStorefrontClient,
-  ApiError,
-  DEFAULT_API_BASE_URL,
-  DEFAULT_API_VERSION,
-} from '@ecomiq/core'
-export type { Api, CreateApiOptions, StorefrontClient } from '@ecomiq/core'
-export type { CreateApiOptions as CreateClientOptions } from '@ecomiq/core'
-export {
-  CollectionSchema,
-  CollectionsSchema,
-  CountrySchema,
-  CountriesSchema,
-  DepartmentSchema,
-  DepartmentsSchema,
-  DistrictSchema,
-  DistrictsSchema,
-  CartTokenSchema,
-  EntityIdSchema,
-  NullableEntityIdSchema,
-  OptionalEntityIdSchema,
-  GeoDivisionSchema,
-  GeoDivisionTypeSchema,
-  GetDepartmentsParamsSchema,
-  GetDistrictsParamsSchema,
-  GetProvincesParamsSchema,
-  ProvinceSchema,
-  ProvincesSchema,
-  StorefrontSettingsSchema,
-  StorefrontMenuSchema,
-  StorefrontMenuItemSchema,
-  getMenuItems,
-} from '@ecomiq/core'
-export type { CartToken, EntityId } from '@ecomiq/core'
-export { getCountries, getDepartments, getDistricts, getProvinces } from '@ecomiq/core'
-export {
-  AddCartItemParamsSchema,
-  CreateCartParamsSchema,
-  CreateProductReviewParamsSchema,
-  GetCartParamsSchema,
-  ListProductReviewsParamsSchema,
-  ProductDetailParamsSchema,
-  ProductDetailSchema,
-  ProductAutocompleteParamsSchema,
-  ProductSuggestionSchema,
-  ProductSuggestionsSchema,
-  ProductSummarySchema,
-  ProductsParamsSchema,
-  ProductsResponseSchema,
-  RelatedProductsParamsSchema,
-  RemoveCartItemParamsSchema,
-  StorefrontCartSchema,
-  StorefrontReviewSchema,
-  StorefrontReviewsSchema,
-  CartCheckoutReadParamsSchema,
-  CartCheckoutParamsSchema,
-  GetShippingOptionsParamsSchema,
-  PutShippingMethodParamsSchema,
-  CartBuyerParamsSchema,
-  CartAddressesParamsSchema,
-  CartPromotionCodeParamsSchema,
-  UpdateCartItemQuantityParamsSchema,
-  sanitizeHtml,
-  stripHtml,
-} from '@ecomiq/core'
-export type {
-  Collection,
-  Collections,
-  Countries,
-  Country,
-  Department,
-  Departments,
-  District,
-  Districts,
-  GeoDivision,
-  GeoDivisionType,
-  GetDepartmentsParams,
-  GetDistrictsParams,
-  GetProvincesParams,
-  Province,
-  Provinces,
-  StorefrontSettings,
-  StorefrontMenu,
-  StorefrontMenuItem,
-  AddCartItemParams,
-  BundleItem,
-  CreateCartParams,
-  CreateProductReviewParams,
-  GetCartParams,
-  ListProductReviewsParams,
-  ProductDetail,
-  ProductDetailParams,
-  Product,
-  ProductAutocompleteParams,
-  ProductImage,
-  ProductPriceTier,
-  ProductSuggestion,
-  ProductSummary,
-  ProductsParams,
-  ProductsParamsInput,
-  ProductsResponse,
-  RelatedProductsParams,
-  RemoveCartItemParams,
-  SearchFilter,
-  SizeGuide,
-  SpecItem,
-  StorefrontCart,
-  StorefrontCartItem,
-  CartCheckoutReadParams,
-  CartCheckoutParams,
-  CartCheckoutResponse,
-  CartPaymentMethod,
-  GetShippingOptionsParams,
-  PutShippingMethodParams,
-  CartBuyerParams,
-  CartAddressesParams,
-  CartPromotionCodeParams,
-  ShippingRate,
-  ShippingOptionGroup,
-  ShippingOptionsResponse,
-  StorefrontOrderBump,
-  StorefrontReview,
-  StorefrontReviews,
-  UpdateCartItemQuantityParams,
-  VariantItem,
-  CustomerAddress,
-  CustomerAddresses,
-  CustomerAddressUpsertInput,
-  CustomerSavedAddress,
-  CustomerMe,
-  CustomerProfile,
-  CustomerProfilePatch,
-  CustomerOrderDetail,
-  CustomerOrderListItem,
-} from '@ecomiq/core'
-export {
-  CustomerAddressSchema,
-  CustomerAddressesSchema,
-  CustomerAddressUpsertInputSchema,
-  toCustomerSavedAddresses,
-  getCustomerAddresses,
-  createCustomerAddress,
-  updateCustomerAddress,
-  deleteCustomerAddress,
-  CustomerMeSchema,
-  CustomerProfileSchema,
-  CustomerProfilePatchSchema,
-  CustomerRegisterRequestSchema,
-  customerMeToProfile,
-  customerMeToProfilePatch,
-  customerProfileToPatch,
-  getCustomerMe,
-  patchCustomer,
-  registerCustomer,
-  CustomerOrderListItemSchema,
-  CustomerOrderDetailSchema,
-  CustomerOrderListSchema,
-  formatCustomerOrderStatus,
-  customerOrderStatusTone,
-  formatOrderDate,
-  formatOrderDateTime,
-  getCustomerOrders,
-  getCustomerOrder,
-} from '@ecomiq/core'
-export { createClient, getStorefrontClient } from './client'
-export type {
-  AddProductToCartInput,
-  AddProductToCartResult,
-  ProductCartMutationResult,
-} from './cart-session'
-export type {
-  ProductReviewSubmissionError,
-  ProductReviewSubmissionResult,
-} from './review-submission'
-export { serverApi } from './server'
-export { proxyStorefrontRequest } from './api-proxy'
-export { createStorefrontProxyApi } from './proxy-api'
-export {
-  AppEcomiqProvider,
-  useApiQuery,
-  useAppConfig,
-  useSettings,
-  useMenu,
-  useSearchNavigate,
-  CartProvider,
-  useCart,
-  AuthProvider,
-  createStorefrontAuthClient,
-  useAuth,
-  type CartContextValue,
-  type CartLoadStatus,
-  type CartMutation,
-  type StorefrontAuthClientInstance,
-  type StorefrontSession,
-} from './providers'
-export {
-  listRecentlyViewed,
-  trackRecentlyViewed,
-  toRecentlyViewedItem,
-  useRecentlyViewed,
-  useTrackRecentlyViewed,
-  type RecentlyViewedItem,
-  type TrackableProduct,
-} from './hooks'
-export { createStorefrontAuth } from './auth/create-storefront-auth'
-export type { CreateStorefrontAuthOptions } from './auth/create-storefront-auth'
-export {
-  BETTER_AUTH_TRUSTED_HOSTS_ENV,
-  DEFAULT_STOREFRONT_AUTH_ALLOWED_HOSTS,
-  defaultAllowedHostsFromEnv,
-  hostsFromStoreSettings,
-  mergeSettingsHostsIntoBaseURL,
-  resolveStorefrontAuthBaseURL,
-} from './auth/storefront-auth-base-url'
-export type {
-  StorefrontDynamicBaseURLConfig,
-  StoreSettingsHostsSource,
-} from './auth/storefront-auth-base-url'
-export { ecomiqOAuthPassword } from './auth/ecomiq-oauth-password-plugin'
-export { ecomiqOAuthPasswordClient } from './auth/ecomiq-oauth-password-client'
-export { signInWithEcomiqCredentials } from './auth/ecomiq-storefront-sign-in'
-export type { EcomiqSignInCredentials } from './auth/ecomiq-storefront-sign-in'
-export * from './utils'
-export { formatMoney, type MoneyLocale } from './format-money'
-export { Link } from './link'
-export { Await } from '@tanstack/react-router'
-export {
-  Hero,
-  findHeroSection,
-  type HeroProps,
-  type HeroSlide,
-} from './components/hero'
-export * from './storefront-definition'
-export {
-  definitionForRoute,
-  useDefinition,
-} from './storefront-layout'
-export { z } from 'zod'
-
-/**
- * Contexto del loader. Por defecto el loader es isomorfo (SSR + cliente).
- * Preferí `serverApi` para que el fetch a storefront solo corra en el servidor.
- */
-export interface LoaderContext<
-  TParams = Record<string, string>,
-  TSearch extends Record<string, unknown> = Record<string, unknown>,
-> {
-  params: TParams
-  search: TSearch
-  config: PublicEcomiqConfig
-}
-
-/** Props que recibe el componente de una página. */
-export interface PageProps<
-  TData = unknown,
-  TParams = Record<string, string>,
-  TSearch extends Record<string, unknown> = Record<string, unknown>,
-> {
-  data: TData
-  params: TParams
-  search: TSearch
-  /** Settings storefront (CMS, store, menus). Cargado en el root; sin request extra. */
-  settings: StorefrontSettings
-}
-
-export interface PageMeta {
-  title?: string
-  description?: string
-  /** Imagen OG específica de esta página (sobreescribe branding.socialImageUrl). */
-  ogImage?: string
-  /** Marca la página como noindex,nofollow. */
-  noIndex?: boolean
-  /** Metas extra solo para esta página. */
-  meta?: Array<{ name?: string; property?: string; content: string }>
-  /** Datos estructurados (schema.org); se serializa como JSON-LD. */
-  jsonLd?: Record<string, unknown>
-}
-
-/** Props que recibe un layout personalizado (layout.tsx en la raíz del proyecto). */
-export interface LayoutProps {
-  children: ReactNode
-  config: PublicEcomiqConfig
-  /** Settings storefront (CMS, store, menus). Cargado en el root para todas las páginas. */
-  settings: StorefrontSettings
-}
-
-/**
- * Define el layout global de la tienda (opcional).
- * Crea `layout.tsx` en la raíz del proyecto y el framework lo usa en lugar
- * del layout por defecto. Recibe `children` (la página) y `config`.
- */
-export function defineLayout(layout: (props: LayoutProps) => ReactNode) {
-  return layout
-}
-
-export interface EcomiqPage<
-  TData = unknown,
-  TParams = Record<string, string>,
-  TSearch extends Record<string, unknown> = Record<string, unknown>,
-> {
-  preload?: boolean
-  reloadOnSearch?: boolean
-  validateSearch?: (raw: Record<string, unknown>) => TSearch
-  /**
-   * Carga de datos. Corre en SSR y en navegaciones cliente.
-   * Usa `serverApi` (no `createClient`) para que el HTTP a storefront
-   * solo ocurra en el servidor.
-   */
-  loader?: (ctx: LoaderContext<TParams, TSearch>) => Promise<TData> | TData
-  /** Metadatos del documento; recibe los datos ya cargados. */
-  meta?: (ctx: {
-    data: TData
-    params: TParams
-    search: TSearch
-    config: PublicEcomiqConfig
-    /**
-     * Settings storefront cargados en el root. Opcional: puede faltar si el
-     * `<head>` se calcula antes de que el match raíz tenga sus datos.
-     */
-    settings?: StorefrontSettings
-  }) => PageMeta
-  /** UI de la página. */
-  component: (props: PageProps<TData, TParams, TSearch>) => ReactNode
-  /** UI mientras el loader está en curso (navegación cliente). */
-  loading?: () => ReactNode
-  /** UI cuando el loader falla. */
-  error?: (props: { error: Error; reset: () => void }) => ReactNode
-}
-
-export function definePage<
-  TData = unknown,
-  TParams = Record<string, string>,
-  TSearch extends Record<string, unknown> = Record<string, unknown>,
->(
-  page: EcomiqPage<TData, TParams, TSearch>,
-): EcomiqPage<TData, TParams, TSearch> {
-  return page
-}

package/src/link.tsx

@@ -1,2 +0,0 @@
-export { Link } from '@tanstack/react-router'
-export type { LinkProps } from '@tanstack/react-router'

package/src/pages/account/account-page-skeleton.tsx

@@ -1,69 +0,0 @@
-import { Skeleton } from '../../ui/skeleton'
-import { cn } from '../../ui/cn'
-
-function NavRowSkeleton() {
-  return (
-    <div className="flex items-center justify-between border-b border-border px-4 py-4">
-      <span className="flex items-center gap-3">
-        <Skeleton className="size-4 shrink-0 rounded" />
-        <Skeleton className="h-4 w-28" />
-      </span>
-      <Skeleton className="size-4 shrink-0 rounded" />
-    </div>
-  )
-}
-
-export function AccountSectionSkeleton() {
-  return (
-    <div className="space-y-6 px-6" aria-busy="true" aria-label="Cargando sección">
-      <div className="space-y-2">
-        <Skeleton className="h-6 w-40" />
-        <Skeleton className="h-4 w-full max-w-md" />
-      </div>
-      <div className="overflow-hidden rounded-xl border border-border bg-background">
-        {Array.from({ length: 4 }).map((_, index) => (
-          <div
-            key={index}
-            className={cn(
-              'flex items-center justify-between gap-4 px-5 py-4',
-              index < 3 && 'border-b border-border',
-            )}
-          >
-            <div className="min-w-0 flex-1 space-y-2">
-              <Skeleton className="h-3 w-24" />
-              <Skeleton className="h-4 w-full max-w-xs" />
-            </div>
-            <Skeleton className="size-8 shrink-0 rounded-md" />
-          </div>
-        ))}
-      </div>
-    </div>
-  )
-}
-
-export function AccountPageSkeleton() {
-  return (
-    <div
-      className="container mx-auto px-4 py-8"
-      aria-busy="true"
-      aria-label="Cargando cuenta"
-    >
-      <Skeleton className="h-4 w-24" />
-      <Skeleton className="mt-2 h-9 w-40" />
-
-      <div className="mt-8 grid grid-cols-1 gap-6 lg:grid-cols-[320px_1fr]">
-        <aside className="overflow-hidden rounded-xl border border-border bg-background lg:sticky lg:top-15 lg:self-start">
-          <nav>
-            {Array.from({ length: 5 }).map((_, index) => (
-              <NavRowSkeleton key={index} />
-            ))}
-          </nav>
-        </aside>
-
-        <section className="min-w-0">
-          <AccountSectionSkeleton />
-        </section>
-      </div>
-    </div>
-  )
-}