@ecomiq/storefront 2.1.3 → 3.0.0

package/src/review-submission.ts

@@ -1,89 +0,0 @@
-import type {
-  CreateProductReviewParams,
-  StorefrontReview,
-} from '@ecomiq/core'
-import { ApiError } from '@ecomiq/core'
-import { z } from 'zod'
-
-const ReviewProblemSchema = z.object({
-  code: z.string().max(120).regex(/^[A-Za-z0-9._-]+$/).optional(),
-})
-
-interface ProductReviewClient {
-  createProductReview(
-    params: CreateProductReviewParams,
-  ): Promise<StorefrontReview>
-}
-
-export interface ProductReviewSubmissionError {
-  status: 400 | 409 | 429 | 500
-  code?: string
-  message: string
-}
-
-export type ProductReviewSubmissionResult =
-  | {
-      ok: true
-      review: StorefrontReview
-    }
-  | {
-      ok: false
-      error: ProductReviewSubmissionError
-    }
-
-export async function submitProductReview(
-  client: ProductReviewClient,
-  input: CreateProductReviewParams,
-): Promise<ProductReviewSubmissionResult> {
-  try {
-    const review = await client.createProductReview(input)
-    return { ok: true, review }
-  } catch (error) {
-    if (!(error instanceof ApiError)) throw error
-
-    let code: string | undefined
-    const problem = ReviewProblemSchema.safeParse(error.body)
-    if (problem.success) code = problem.data.code
-
-    if (error.status === 400) {
-      let message = 'Revisa los datos de la reseña e inténtalo nuevamente.'
-      if (
-        code === 'ProductReview.OrderInvalid' ||
-        code === 'ProductReview.OrderOwnerMismatch' ||
-        code === 'ProductReview.ProductNotPurchased'
-      ) {
-        message = 'No pudimos verificar la compra con los datos ingresados.'
-      }
-      return { ok: false, error: { status: 400, code, message } }
-    }
-
-    if (error.status === 409) {
-      let message = 'No pudimos registrar esta reseña porque ya existe una similar.'
-      if (code === 'ProductReview.AlreadyExists') {
-        message = 'Ya enviaste una reseña para este producto.'
-      }
-      return { ok: false, error: { status: 409, code, message } }
-    }
-
-    if (error.status === 429) {
-      return {
-        ok: false,
-        error: {
-          status: 429,
-          code,
-          message:
-            'Enviaste varias reseñas en poco tiempo. Espera un momento e inténtalo nuevamente.',
-        },
-      }
-    }
-
-    return {
-      ok: false,
-      error: {
-        status: 500,
-        code,
-        message: 'No pudimos enviar la reseña. Inténtalo nuevamente.',
-      },
-    }
-  }
-}

package/src/runtime/context.ts

@@ -1,2 +0,0 @@
-export { AppEcomiqContext, AppEcomiqProvider, type AppEcomiqValue } from '../providers/ecomiq'
-export { AuthProvider } from '../providers/auth'

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
-})