@ecomiq/storefront 2.1.4 → 3.0.1

package/src/runtime/default-layout.tsx

@@ -1,64 +0,0 @@
-/**
- * Layout por defecto de Ecomiq.
- * Nav y footer salen de settings.cms.menus (main / footer).
- */
-import { Link } from '@tanstack/react-router'
-import { getMenuItems } from '@ecomiq/core'
-import type { LayoutProps } from '../index'
-
-export default function DefaultLayout({ children, settings }: LayoutProps) {
-  const mainItems = getMenuItems(settings, 'main')
-  const footerItems = getMenuItems(settings, 'footer')
-  const nav =
-    mainItems.length > 0
-      ? mainItems.map((item) => ({ label: item.label, to: item.url, target: item.target }))
-      : [{ label: 'Productos', to: '/', target: null as string | null }]
-
-  const storeName = settings?.store.name ?? 'Tienda'
-
-  return (
-    <div className="flex min-h-dvh flex-col">
-      <header className="sticky top-0 z-40 border-b bg-background/90 backdrop-blur supports-[backdrop-filter]:bg-background/75">
-        <div className="mx-auto flex h-14 w-full max-w-6xl items-center justify-between px-4">
-          <Link to="/" className="font-semibold tracking-tight text-lg">
-            {storeName}
-          </Link>
-          <nav className="flex items-center gap-5 text-sm text-muted-foreground">
-            {nav.map((item) =>
-              item.target === '_blank' ? (
-                <a
-                  key={item.to}
-                  href={item.to}
-                  target="_blank"
-                  rel="noreferrer"
-                  className="transition-colors hover:text-foreground"
-                >
-                  {item.label}
-                </a>
-              ) : (
-                <Link key={item.to} to={item.to} className="transition-colors hover:text-foreground">
-                  {item.label}
-                </Link>
-              ),
-            )}
-          </nav>
-        </div>
-      </header>
-      <main className="mx-auto w-full max-w-6xl flex-1 px-4 py-8">{children}</main>
-      <footer className="border-t">
-        <div className="mx-auto flex w-full max-w-6xl flex-col gap-4 px-4 py-6 text-sm text-muted-foreground sm:flex-row sm:items-center sm:justify-between">
-          <p>{settings?.store.description || `${storeName} — creado con Ecomiq`}</p>
-          {footerItems.length > 0 && (
-            <nav className="flex flex-wrap gap-4">
-              {footerItems.map((item) => (
-                <Link key={item.url} to={item.url} className="transition-colors hover:text-foreground">
-                  {item.label}
-                </Link>
-              ))}
-            </nav>
-          )}
-        </div>
-      </footer>
-    </div>
-  )
-}

package/src/runtime/head.ts

@@ -1,149 +0,0 @@
-/**
- * Runtime interno: construcción del <head>.
- * Mezcla SEO/branding/tracking de `/v1/settings` con el `meta` de cada página
- * (la página siempre gana) y genera los scripts de analytics del CMS.
- */
-import type { StorefrontSettings } from '@ecomiq/core'
-import type { PageMeta } from '../index'
-import {
-  cmsBranding,
-  cmsSeo,
-  storeDisplayName,
-  storeSeoDescription,
-} from '../utils'
-
-type MetaTag = Record<string, string>
-type LinkTag = Record<string, string>
-type ScriptTag = Record<string, string | boolean> & { children?: string }
-
-interface HeadResult {
-  meta?: MetaTag[]
-  links?: LinkTag[]
-  scripts?: ScriptTag[]
-}
-
-function serializeJsonLd(value: Record<string, unknown>) {
-  return JSON.stringify(value)
-    .replace(/</g, '\\u003c')
-    .replace(/\u2028/g, '\\u2028')
-    .replace(/\u2029/g, '\\u2029')
-}
-
-function siteName(settings: StorefrontSettings | null | undefined): string {
-  return storeDisplayName(settings) ?? 'Tienda'
-}
-
-/** Aplica titleTemplate del CMS (`{page} | {site}` o `%s · Tienda`). */
-export function resolveTitle(
-  pageTitle: string | undefined,
-  settings: StorefrontSettings | null | undefined,
-): string {
-  const name = siteName(settings)
-  const seo = cmsSeo(settings)
-  if (!pageTitle) return seo?.metaTitle ?? name
-
-  const template = seo?.titleTemplate?.trim()
-  if (!template) return `${pageTitle} · ${name}`
-
-  return template
-    .replaceAll('{page}', pageTitle)
-    .replaceAll('{site}', name)
-    .replace('%s', pageTitle)
-}
-
-/** Head global: charset, viewport, favicon, tracking. Va en el root. */
-export function buildRootHead(
-  settings: StorefrontSettings | null | undefined,
-): HeadResult {
-  const branding = cmsBranding(settings)
-  const seo = cmsSeo(settings)
-
-  const meta: MetaTag[] = [
-    { charSet: 'utf-8' },
-    { name: 'viewport', content: 'width=device-width, initial-scale=1' },
-  ]
-  if (seo?.robotsIndex === false) {
-    meta.push({ name: 'robots', content: 'noindex, nofollow' })
-  }
-
-  const links: LinkTag[] = [
-    { rel: 'icon', href: branding?.faviconUrl ?? '/favicon.ico' },
-  ]
-
-  return { meta, links, scripts: buildAnalyticsScripts(settings) }
-}
-
-/** Head por página: title (con plantilla), description, OG/Twitter, robots, metas extra y JSON-LD. */
-export function buildPageHead(
-  pageMeta: PageMeta | undefined,
-  settings: StorefrontSettings | null | undefined,
-): HeadResult {
-  const branding = cmsBranding(settings)
-  const seo = cmsSeo(settings)
-  const title = resolveTitle(pageMeta?.title, settings)
-  const description = pageMeta?.description ?? storeSeoDescription(settings) ?? undefined
-  const ogImage = pageMeta?.ogImage ?? branding?.socialImageUrl ?? undefined
-  const name = siteName(settings)
-
-  const meta: MetaTag[] = [{ title }]
-  if (description) meta.push({ name: 'description', content: description })
-  if (pageMeta?.noIndex || seo?.robotsIndex === false) {
-    meta.push({ name: 'robots', content: 'noindex, nofollow' })
-  }
-
-  meta.push({ property: 'og:title', content: title })
-  meta.push({ property: 'og:type', content: 'website' })
-  meta.push({ property: 'og:site_name', content: name })
-  if (description) meta.push({ property: 'og:description', content: description })
-  if (ogImage) {
-    meta.push({ property: 'og:image', content: ogImage })
-    meta.push({ name: 'twitter:card', content: 'summary_large_image' })
-    meta.push({ name: 'twitter:image', content: ogImage })
-  }
-
-  for (const extra of pageMeta?.meta ?? []) meta.push(extra as MetaTag)
-
-  const scripts: ScriptTag[] = []
-  if (pageMeta?.jsonLd) {
-    scripts.push({ type: 'application/ld+json', children: serializeJsonLd(pageMeta.jsonLd) })
-  }
-
-  return { meta, ...(scripts.length ? { scripts } : {}) }
-}
-
-/** Traduce tracking + customScripts del CMS a etiquetas <script>. */
-export function buildAnalyticsScripts(
-  settings: StorefrontSettings | null | undefined,
-): ScriptTag[] {
-  const tracking = settings?.cms?.settings?.tracking
-  const custom = settings?.cms?.settings?.customScripts
-  const scripts: ScriptTag[] = []
-
-  if (tracking?.googleAnalyticsMeasurementId) {
-    const id = tracking.googleAnalyticsMeasurementId
-    scripts.push({ src: `https://www.googletagmanager.com/gtag/js?id=${id}`, async: true })
-    scripts.push({
-      children: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)};gtag('js',new Date());gtag('config','${id}');`,
-    })
-  }
-
-  if (tracking?.googleTagManagerContainerId) {
-    const id = tracking.googleTagManagerContainerId
-    scripts.push({
-      children: `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','${id}');`,
-    })
-  }
-
-  if (tracking?.metaPixelId) {
-    const id = tracking.metaPixelId
-    scripts.push({
-      children: `!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,document,'script','https://connect.facebook.net/en_US/fbevents.js');fbq('init','${id}');fbq('track','PageView');`,
-    })
-  }
-
-  if (custom?.enabled && custom.head) {
-    scripts.push({ children: custom.head })
-  }
-
-  return scripts
-}

package/src/runtime/page.tsx

@@ -1,143 +0,0 @@
-/**
- * Runtime interno de Ecomiq (solo lo importa el código generado en `.ecomiq`).
- * Traduce el contrato público `definePage` a las opciones del router interno.
- */
-import { useContext } from 'react'
-import { useRouterState } from '@tanstack/react-router'
-import type { StorefrontSettings } from '@ecomiq/core'
-import type { EcomiqPage, PublicEcomiqConfig } from '../index'
-import { AppEcomiqContext } from '../providers/ecomiq'
-import { serverApi } from '../server'
-import { StorefrontError } from '../ui/storefront-error'
-import { buildPageHead } from './head'
-
-function isSettings(value: unknown): value is StorefrontSettings {
-  return Boolean(
-    value &&
-      typeof value === 'object' &&
-      value !== null &&
-      'store' in value,
-  )
-}
-
-async function resolveSettingsForMeta(
-  matches?: Array<{ loaderData?: unknown }>,
-): Promise<StorefrontSettings | undefined> {
-  // Preferir el loader del root si ya está en el match (hidratación cliente).
-  // En SSR `matches` suele venir stale (updateMatch no muta el array), así que
-  // caemos a serverApi: el cliente core cachea settings y no hay HTTP extra.
-  const fromRoot = matches?.[0]?.loaderData
-  if (isSettings(fromRoot)) {
-    return fromRoot
-  }
-  try {
-    return await serverApi.getSettings()
-  } catch {
-    return undefined
-  }
-}
-
-function usePageSettings(): StorefrontSettings | undefined {
-  // Mismo módulo que AppEcomiqProvider (no el barrel) para evitar contextos duplicados.
-  const fromProvider = useContext(AppEcomiqContext)?.settings
-  const fromRootLoader = useRouterState({
-    select: (state) => {
-      const data = state.matches[0]?.loaderData
-      return isSettings(data) ? data : undefined
-    },
-  })
-  return fromProvider ?? fromRootLoader
-}
-
-export function pageToRouteOptions<
-  TData,
-  TParams extends Record<string, string>,
-  TSearch extends Record<string, unknown>,
->(
-  page: EcomiqPage<TData, TParams, TSearch>,
-  config: PublicEcomiqConfig,
-) {
-  const readSearch = page.validateSearch ?? ((raw: Record<string, unknown>) => raw as TSearch)
-  const reloadOnSearch = page.reloadOnSearch !== false
-  const stableLoaderDeps: Record<string, never> = {}
-
-  return {
-    preload: page.preload,
-    shouldReload: reloadOnSearch ? undefined : false,
-    validateSearch: readSearch,
-    loaderDeps: ({ search }: { search: TSearch }) => reloadOnSearch ? search : stableLoaderDeps,
-    loader: page.loader
-      ? ({ params, deps, location }: {
-          params: TParams
-          deps: TSearch | Record<string, never>
-          location?: { search?: Record<string, unknown> }
-        }) => {
-          let search = readSearch(location?.search ?? {})
-          if (reloadOnSearch) {
-            search = deps as TSearch
-          }
-          return page.loader!({
-            params,
-            search,
-            config,
-          })
-        }
-      : undefined,
-    head: async ({ loaderData, params, match, matches }: {
-      loaderData: TData
-      params: TParams
-      match: { search: TSearch }
-      matches?: Array<{ loaderData?: unknown }>
-    }) => {
-      // Con loader: si TanStack calcula head antes de tener datos, degrada al head global.
-      // Sin loader: loaderData es siempre undefined — aún así hay que llamar meta.
-      const waitingForLoader = Boolean(page.loader) && loaderData === undefined
-      if (waitingForLoader) return buildPageHead(undefined, undefined)
-
-      const settings = page.meta
-        ? await resolveSettingsForMeta(matches)
-        : undefined
-
-      return buildPageHead(
-        page.meta?.({
-          data: loaderData,
-          params,
-          search: match.search,
-          config,
-          settings,
-        }),
-        settings,
-      )
-    },
-    pendingComponent: page.loading,
-    errorComponent: page.error
-      ? ({ error, reset }: { error: Error; reset: () => void }) => page.error!({ error, reset })
-      : ({ reset }: { error: Error; reset: () => void }) => <StorefrontError onRetry={reset} />,
-  }
-}
-
-export function PageBoundary<
-  TData,
-  TParams extends Record<string, string>,
-  TSearch extends Record<string, unknown>,
->({
-  page,
-  data,
-  params,
-  search,
-}: {
-  page: EcomiqPage<TData, TParams, TSearch>
-  data: TData
-  params: TParams
-  search: TSearch
-}) {
-  const settings = usePageSettings()
-  // Concurrent render / contexto duplicado: no tumbar el root.
-  // El re-render sync con provider o el loader del root suelen recuperar.
-  if (!settings) {
-    const Loading = page.loading
-    return Loading ? <Loading /> : null
-  }
-  const Component = page.component
-  return <Component data={data} params={params} search={search} settings={settings} />
-}

package/src/runtime/postcss-browser-stub.mjs

@@ -1,5 +0,0 @@
-export function parse() {
-  throw new Error('El storefront no admite estilos inline en HTML enriquecido.')
-}
-
-export default { parse }

package/src/server-config-store.ts

@@ -1,35 +0,0 @@
-import type { CreateApiOptions } from '@ecomiq/core'
-import { createServerOnlyFn } from '@tanstack/react-start'
-
-export interface ServerEcomiqCloudConfig {
-  baseUrl?: string
-  artifactBaseUrl?: string
-  storeSlug?: string
-  timeoutMs?: number
-  cacheTtlMs?: number
-}
-
-export interface ServerEcomiqConfig {
-  domain: string
-  api?: CreateApiOptions
-  cloud?: ServerEcomiqCloudConfig
-}
-
-const serverConfigKey = Symbol.for('@ecomiq/storefront/server-config')
-const serverGlobal = globalThis as typeof globalThis & {
-  [key: symbol]: ServerEcomiqConfig | undefined
-}
-
-export const registerServerConfig = createServerOnlyFn((config: ServerEcomiqConfig): void => {
-  serverGlobal[serverConfigKey] = config
-})
-
-export const getServerConfig = createServerOnlyFn((): ServerEcomiqConfig => {
-  const registered = serverGlobal[serverConfigKey]
-  if (!registered) {
-    throw new Error(
-      'Config server de Ecomiq no disponible. Ejecuta la app mediante `ecomiq dev|build`.',
-    )
-  }
-  return registered
-})

package/src/server.ts

@@ -1,286 +0,0 @@
-/**
- * API storefront que solo corre en el servidor (TanStack Start RPC).
- * En SSR ejecuta el handler localmente; en el cliente llama al Worker.
- *
- * ```ts
- * import { definePage, serverApi } from '@ecomiq/storefront'
- *
- * export default definePage({
- *   loader: () => serverApi.getProducts({ page: 1, pageSize: 12 }),
- *   component: ({ data }) => …,
- * })
- * ```
- *
- * Nota: cada `createServerFn` debe vivir en el top-level del módulo
- * (el compilador de Start asigna IDs estables por call-site).
- * El cliente storefront es singleton → el cache de settings se reutiliza.
- */
-import { createServerFn } from '@tanstack/react-start'
-import {
-  AddCartItemParamsSchema,
-  CartAddressesParamsSchema,
-  CartBuyerParamsSchema,
-  CartCheckoutParamsSchema,
-  CartCheckoutReadParamsSchema,
-  CartPromotionCodeParamsSchema,
-  CreateProductReviewParamsSchema,
-  GetCartParamsSchema,
-  GetDepartmentsParamsSchema,
-  GetDistrictsParamsSchema,
-  GetProvincesParamsSchema,
-  GetShippingOptionsParamsSchema,
-  ListProductReviewsParamsSchema,
-  ProductAutocompleteParamsSchema,
-  ProductDetailParamsSchema,
-  ProductsParamsSchema,
-  PutShippingMethodParamsSchema,
-  RelatedProductsParamsSchema,
-  RemoveCartItemParamsSchema,
-  UpdateCartItemQuantityParamsSchema,
-  type AddCartItemParams,
-  type CartAddressesParams,
-  type CartBuyerParams,
-  type CartCheckoutParams,
-  type CartCheckoutReadParams,
-  type CartPromotionCodeParams,
-  type CreateProductReviewParams,
-  type GetCartParams,
-  type GetDepartmentsParams,
-  type GetDistrictsParams,
-  type GetProvincesParams,
-  type GetShippingOptionsParams,
-  type ListProductReviewsParams,
-  type ProductAutocompleteParams,
-  type ProductDetailParams,
-  type ProductsParamsInput,
-  type PutShippingMethodParams,
-  type RelatedProductsParams,
-  type RemoveCartItemParams,
-  type UpdateCartItemQuantityParams,
-  type UploadPaymentReceiptParams,
-  CartTokenSchema,
-  EntityIdSchema,
-} from '@ecomiq/core'
-import { z } from 'zod'
-import { getStorefrontClient } from './client'
-import {
-  loadActiveCart,
-  submitCartItemQuantity,
-  submitCartItemRemoval,
-  submitProductToCart,
-  type AddProductToCartInput,
-} from './cart-session'
-import { submitProductReview } from './review-submission'
-
-const getSettingsFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getSettings(),
-)
-
-const getStoreIdFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getStoreId(),
-)
-
-const getCollectionsFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getCollections(),
-)
-
-const getCollectionBySlugFn = createServerFn({ method: 'GET' })
-  .validator(z.object({ slug: z.string().min(1) }))
-  .handler(({ data }) => getStorefrontClient().getCollectionBySlug(data.slug))
-
-const getPageBySlugFn = createServerFn({ method: 'GET' })
-  .validator(z.object({ slug: z.string().min(1) }))
-  .handler(({ data }) => getStorefrontClient().getPageBySlug(data.slug))
-
-const getProductsFn = createServerFn({ method: 'GET' })
-  .validator(ProductsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getProducts(data))
-
-const ProductBySlugServerParamsSchema = ProductDetailParamsSchema.extend({
-  slug: z.string().min(1),
-})
-
-const getProductBySlugFn = createServerFn({ method: 'GET' })
-  .validator(ProductBySlugServerParamsSchema)
-  .handler(({ data }) =>
-    getStorefrontClient().getProductBySlug(data.slug, { sellerId: data.sellerId }),
-  )
-
-const getRelatedProductsFn = createServerFn({ method: 'GET' })
-  .validator(RelatedProductsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getRelatedProducts(data))
-
-const autocompleteProductsFn = createServerFn({ method: 'GET' })
-  .validator(ProductAutocompleteParamsSchema)
-  .handler(({ data }) => getStorefrontClient().autocompleteProducts(data))
-
-const listProductReviewsFn = createServerFn({ method: 'GET' })
-  .validator(ListProductReviewsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().listProductReviews(data))
-
-const submitProductReviewFn = createServerFn({ method: 'POST' })
-  .validator(CreateProductReviewParamsSchema)
-  .handler(({ data }) => submitProductReview(getStorefrontClient(), data))
-
-const loadCartFn = createServerFn({ method: 'POST' })
-  .validator(GetCartParamsSchema)
-  .handler(({ data }) => loadActiveCart(getStorefrontClient(), data))
-
-const setCartItemQuantityFn = createServerFn({ method: 'POST' })
-  .validator(UpdateCartItemQuantityParamsSchema)
-  .handler(({ data }) => submitCartItemQuantity(getStorefrontClient(), data))
-
-const removeCartItemFn = createServerFn({ method: 'POST' })
-  .validator(RemoveCartItemParamsSchema)
-  .handler(({ data }) => submitCartItemRemoval(getStorefrontClient(), data))
-
-const AddProductToCartServerSchema = z.object({
-  cartToken: CartTokenSchema.optional(),
-  currencyCode: z.string().length(3),
-  variantId: EntityIdSchema,
-  quantity: z.number().int().positive(),
-})
-
-const addProductToCartFn = createServerFn({ method: 'POST' })
-  .validator(AddProductToCartServerSchema)
-  .handler(({ data }) => submitProductToCart(getStorefrontClient(), data))
-
-const addCartItemFn = createServerFn({ method: 'POST' })
-  .validator(AddCartItemParamsSchema)
-  .handler(({ data }) => getStorefrontClient().addCartItem(data))
-
-const getCartCheckoutFn = createServerFn({ method: 'GET' })
-  .validator(CartCheckoutReadParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getCartCheckout(data))
-
-const getShippingOptionsFn = createServerFn({ method: 'GET' })
-  .validator(GetShippingOptionsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getShippingOptions(data))
-
-const putCartShippingMethodFn = createServerFn({ method: 'POST' })
-  .validator(PutShippingMethodParamsSchema)
-  .handler(({ data }) => getStorefrontClient().putCartShippingMethod(data))
-
-const patchCartBuyerFn = createServerFn({ method: 'POST' })
-  .validator(CartBuyerParamsSchema)
-  .handler(({ data }) => getStorefrontClient().patchCartBuyer(data))
-
-const patchCartAddressesFn = createServerFn({ method: 'POST' })
-  .validator(CartAddressesParamsSchema)
-  .handler(({ data }) => getStorefrontClient().patchCartAddresses(data))
-
-const checkoutCartFn = createServerFn({ method: 'POST' })
-  .validator(CartCheckoutParamsSchema)
-  .handler(({ data }) => getStorefrontClient().checkoutCart(data))
-
-const CartPaymentReceiptServerSchema = z.object({
-  cartToken: CartTokenSchema,
-  fileBase64: z.string().min(1),
-  fileName: z.string().min(1),
-  mimeType: z.string().min(1).optional(),
-})
-
-const uploadPaymentReceiptFn = createServerFn({ method: 'POST' })
-  .validator(CartPaymentReceiptServerSchema)
-  .handler(({ data }) => {
-    const binary = Uint8Array.from(atob(data.fileBase64), (c) => c.charCodeAt(0))
-    const file = new Blob([binary], { type: data.mimeType ?? 'application/octet-stream' })
-    return getStorefrontClient().uploadPaymentReceipt({
-      cartToken: data.cartToken,
-      file,
-      fileName: data.fileName,
-    })
-  })
-
-const addCartPromotionCodeFn = createServerFn({ method: 'POST' })
-  .validator(CartPromotionCodeParamsSchema)
-  .handler(({ data }) => getStorefrontClient().addCartPromotionCode(data))
-
-const removeCartPromotionCodeFn = createServerFn({ method: 'POST' })
-  .validator(CartPromotionCodeParamsSchema)
-  .handler(({ data }) => getStorefrontClient().removeCartPromotionCode(data))
-
-const getCountriesFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getCountries(),
-)
-
-const getDepartmentsFn = createServerFn({ method: 'GET' })
-  .validator(GetDepartmentsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getDepartments(data))
-
-const getProvincesFn = createServerFn({ method: 'GET' })
-  .validator(GetProvincesParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getProvinces(data))
-
-const getDistrictsFn = createServerFn({ method: 'GET' })
-  .validator(GetDistrictsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getDistricts(data))
-
-/**
- * Cliente storefront server-only. Misma superficie útil que `createClient()`,
- * pero cada método es una server function reutilizable desde cualquier página.
- */
-export const serverApi = {
-  getSettings: () => getSettingsFn(),
-  getStoreId: () => getStoreIdFn(),
-  getCollections: () => getCollectionsFn(),
-  getCollectionBySlug: (slug: string) => getCollectionBySlugFn({ data: { slug } }),
-  getPageBySlug: (slug: string) => getPageBySlugFn({ data: { slug } }),
-  getProducts: (
-    params: ProductsParamsInput = {},
-    options: { signal?: AbortSignal } = {},
-  ) => getProductsFn({ data: params, signal: options.signal }),
-  getProductBySlug: (slug: string, params: ProductDetailParams = {}) =>
-    getProductBySlugFn({ data: { slug, ...params } }),
-  getRelatedProducts: (params: RelatedProductsParams) =>
-    getRelatedProductsFn({ data: params }),
-  autocompleteProducts: (params: ProductAutocompleteParams) =>
-    autocompleteProductsFn({ data: params }),
-  listProductReviews: (params: ListProductReviewsParams) =>
-    listProductReviewsFn({ data: params }),
-  submitProductReview: (params: CreateProductReviewParams) =>
-    submitProductReviewFn({ data: params }),
-  loadCart: (params: GetCartParams) => loadCartFn({ data: params }),
-  setCartItemQuantity: (params: UpdateCartItemQuantityParams) =>
-    setCartItemQuantityFn({ data: params }),
-  removeCartItem: (params: RemoveCartItemParams) =>
-    removeCartItemFn({ data: params }),
-  addProductToCart: (params: AddProductToCartInput) =>
-    addProductToCartFn({ data: params }),
-  addCartItem: (params: AddCartItemParams) => addCartItemFn({ data: params }),
-  getCartCheckout: (params: CartCheckoutReadParams) =>
-    getCartCheckoutFn({ data: params }),
-  getShippingOptions: (params: GetShippingOptionsParams) =>
-    getShippingOptionsFn({ data: params }),
-  putCartShippingMethod: (params: PutShippingMethodParams) =>
-    putCartShippingMethodFn({ data: params }),
-  patchCartBuyer: (params: CartBuyerParams) => patchCartBuyerFn({ data: params }),
-  patchCartAddresses: (params: CartAddressesParams) =>
-    patchCartAddressesFn({ data: params }),
-  checkoutCart: (params: CartCheckoutParams) => checkoutCartFn({ data: params }),
-  uploadPaymentReceipt: async (params: UploadPaymentReceiptParams) => {
-    const buffer = await params.file.arrayBuffer()
-    const bytes = new Uint8Array(buffer)
-    let binary = ''
-    for (const byte of bytes) binary += String.fromCharCode(byte)
-    return uploadPaymentReceiptFn({
-      data: {
-        cartToken: params.cartToken,
-        fileBase64: btoa(binary),
-        fileName:
-          params.fileName ??
-          (params.file instanceof File ? params.file.name : 'receipt'),
-        mimeType: params.file.type || undefined,
-      },
-    })
-  },
-  addCartPromotionCode: (params: CartPromotionCodeParams) =>
-    addCartPromotionCodeFn({ data: params }),
-  removeCartPromotionCode: (params: CartPromotionCodeParams) =>
-    removeCartPromotionCodeFn({ data: params }),
-  getCountries: () => getCountriesFn(),
-  getDepartments: (params: GetDepartmentsParams) =>
-    getDepartmentsFn({ data: params }),
-  getProvinces: (params: GetProvincesParams) => getProvincesFn({ data: params }),
-  getDistricts: (params: GetDistrictsParams) => getDistrictsFn({ data: params }),
-}