@ecomiq/storefront 0.1.0 → 0.1.2

package/dist/find-storefront-cms-page-DNwLo1iV.d.ts

@@ -0,0 +1,178 @@
+import * as zustand from 'zustand';
+import { S as StorefrontSettings } from './collection-anMkdWa7.js';
+import * as React$1 from 'react';
+import React__default from 'react';
+import * as better_auth_react from 'better-auth/react';
+import { createAuthClient } from 'better-auth/react';
+import * as better_auth from 'better-auth';
+import { StorefrontProductDetail, StorefrontVariant, StorefrontSettings as StorefrontSettings$1, StorefrontPageDetail } from '@ecomiq/storefront/react';
+
+/** Instancia de `createAuthClient` (better-auth/react) con los plugins de la app. */
+type StorefrontAuthClientInstance = ReturnType<typeof createAuthClient>;
+declare function StorefrontAuthProvider({ authClient, children, }: {
+    authClient: StorefrontAuthClientInstance;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useStorefrontAuthClient(): StorefrontAuthClientInstance;
+type StorefrontSessionUser = {
+    id: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    name?: string;
+    phone?: string;
+};
+/** Caducidad alineada con OAuth/`expires_in` (skew en ms). El bearer ya no viene en JSON de sesión. */
+declare function storefrontSessionEndsSoon(expiresAt: Date | undefined, skewMs?: number): boolean;
+/** @deprecated Usar `storefrontSessionEndsSoon` */
+declare const storefrontAccessTokenNeedsRefresh: typeof storefrontSessionEndsSoon;
+/**
+ * Sesión Better Auth + usuario mapeado para UI (headers, drawer).
+ */
+declare function useStorefrontSession(): {
+    session: {
+        data: {
+            user: better_auth.StripEmptyObjects<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined;
+            }>;
+            session: better_auth.StripEmptyObjects<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined;
+                userAgent?: string | null | undefined;
+            }>;
+        } | null;
+        isPending: boolean;
+        isRefetching: boolean;
+        error: better_auth_react.BetterFetchError | null;
+        refetch: (queryParams?: {
+            query?: better_auth.SessionQueryParams;
+        } | undefined) => Promise<void>;
+    };
+    user: StorefrontSessionUser | null;
+    sessionExpiresAt: Date | undefined;
+    isAuthenticated: boolean;
+    isPending: boolean;
+    error: better_auth_react.BetterFetchError | null;
+    refetch: (queryParams?: {
+        query?: better_auth.SessionQueryParams;
+    } | undefined) => Promise<void>;
+    signOut: () => Promise<{
+        data: {
+            success: boolean;
+        };
+        error: null;
+    } | {
+        data: null;
+        error: {
+            code?: string | undefined | undefined;
+            message?: string | undefined | undefined;
+            status: number;
+            statusText: string;
+        };
+    }>;
+};
+
+type Drawers = {
+    cart: boolean;
+    search: boolean;
+    menu: boolean;
+    filter: boolean;
+    [key: string]: boolean;
+};
+type Modals = {
+    login: boolean;
+    signup: boolean;
+    [key: string]: boolean;
+};
+type StoreState = {
+    data: StorefrontSettings | null;
+    drawers: Drawers;
+    modals: Modals;
+    openDrawer: (drawer: keyof Drawers) => void;
+    closeDrawer: (drawer: keyof Drawers) => void;
+    toggleDrawer: (drawer: keyof Drawers) => void;
+    closeAllDrawers: () => void;
+    openModal: (modal: keyof Modals) => void;
+    closeModal: (modal: keyof Modals) => void;
+    toggleModal: (modal: keyof Modals) => void;
+    closeAllModals: () => void;
+};
+declare const useStore: zustand.UseBoundStore<zustand.StoreApi<StoreState>>;
+
+type EcomiqProviderProps = {
+    store: StorefrontSettings | null;
+    /** Si lo omites, catálogo y carrito funcionan; login requiere configurar Better Auth (ver README). */
+    authClient?: StorefrontAuthClientInstance;
+    children: React__default.ReactNode;
+    /**
+     * Modales de login/registro y toasts del shell Ecomiq (requiere `@ecomiq/ui` en el monorepo).
+     * En npm / tiendas custom deja `false` y monta tu propia UI.
+     */
+    withShellUi?: boolean;
+};
+declare function EcomiqProvider({ store, authClient, children, withShellUi, }: EcomiqProviderProps): React__default.JSX.Element;
+
+type EcomiqSignInCredentials = {
+    email: string;
+    password: string;
+};
+/**
+ * Inicia sesión con email/contraseña vía plugin `ecomiqOAuthPassword` (Better Auth).
+ * Usa la tienda de `settings` (p. ej. `useStore().data`) para los headers de identidad.
+ */
+declare function signInWithEcomiqCredentials(authClient: StorefrontAuthClientInstance, settings: StorefrontSettings | null | undefined, credentials: EcomiqSignInCredentials): Promise<{
+    data: unknown;
+    error: null;
+}>;
+
+/** Option group derived from variants (e.g. Color: [Black, White], Size: [6x8, 8x11]) */
+type OptionGroup = {
+    key: string;
+    name: string;
+    values: string[];
+};
+/** Selected options per group (e.g. { Color: "Black", Size: "8 x 11 inch" }) */
+type SelectedOptions = Record<string, string>;
+type ProductVariantSelectorRenderProps = {
+    product: StorefrontProductDetail;
+    selectedVariant: StorefrontVariant | null;
+    displayPrice: number;
+    compareAtPrice: number | null | undefined;
+    isAvailable: boolean;
+    selectedOptions: SelectedOptions;
+};
+
+type ProductVariantSelectorProps = {
+    product: StorefrontProductDetail;
+    currency?: string;
+    features?: string[];
+    onVariantChange?: (variant: StorefrontVariant | null, price: number) => void;
+    children?: (props: {
+        product: StorefrontProductDetail;
+        selectedVariant: StorefrontVariant | null;
+        displayPrice: number;
+        compareAtPrice: number | null | undefined;
+        isAvailable: boolean;
+        selectedOptions: SelectedOptions;
+    }) => React.ReactNode;
+};
+declare function ProductVariantSelector({ product, currency, features, onVariantChange, children, }: ProductVariantSelectorProps): React$1.JSX.Element;
+
+/**
+ * Busca una página CMS en `settings.cms.pages` (payload de `getPublicStore` / settings)
+ * y la valida como `StorefrontPageDetail` para `DynamicPage`.
+ */
+declare function findStorefrontCmsPageBySlug(settings: StorefrontSettings$1 | null | undefined, slug: string): StorefrontPageDetail | null;
+
+export { EcomiqProvider as E, type OptionGroup as O, ProductVariantSelector as P, StorefrontAuthProvider as S, storefrontSessionEndsSoon as a, useStorefrontSession as b, type StorefrontAuthClientInstance as c, type StorefrontSessionUser as d, type EcomiqProviderProps as e, signInWithEcomiqCredentials as f, type EcomiqSignInCredentials as g, findStorefrontCmsPageBySlug as h, useStore as i, type ProductVariantSelectorProps as j, type SelectedOptions as k, type ProductVariantSelectorRenderProps as l, storefrontAccessTokenNeedsRefresh as s, useStorefrontAuthClient as u };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+
+declare const EcomiqConfigSchema: z.ZodObject<{
+    /**
+     * Slug de tienda en Ecomiq (p. ej. `mi-tienda` para `mi-tienda.ecomiq.app`).
+     * Si está definido, tiene prioridad sobre el `Host` de la request (útil en `localhost`).
+     */
+    slugStore: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    slugStore?: string | undefined;
+}, {
+    slugStore?: string | undefined;
+}>;
+type EcomiqConfig = z.infer<typeof EcomiqConfigSchema>;
+/**
+ * Carga `ecomiq.config.js` (o `.cjs` / `.mjs`) desde la raíz del proyecto (`process.cwd()`).
+ * Resultado en caché por proceso.
+ */
+declare function loadEcomiqConfig(cwd?: string): EcomiqConfig | null;
+/** Limpia la caché (tests o recarga en dev). */
+declare function clearEcomiqConfigCache(): void;
+/**
+ * Identificador de tienda para settings (API / KV).
+ * 1. `slugStore` en `ecomiq.config.*` si existe.
+ * 2. Si no, deriva del header `Host` (`resolveStorefrontSettingsHost`).
+ */
+declare function resolvePublicStoreKey(hostHeader: string | null | undefined, cwd?: string): string;
+declare function hasEcomiqSlugStoreConfig(cwd?: string): boolean;
+
+export { type EcomiqConfig, EcomiqConfigSchema, clearEcomiqConfigCache, hasEcomiqSlugStoreConfig, loadEcomiqConfig, resolvePublicStoreKey };

package/dist/index.js

@@ -0,0 +1,103 @@
+import { existsSync } from 'fs';
+import { createRequire } from 'module';
+import { join } from 'path';
+import { z } from 'zod';
+import '@opennextjs/cloudflare';
+import '@ecomiq/storefront/core';
+
+// src/core/config/ecomiq-config.ts
+var ECOMIQ_APP_APEX = "ecomiq.app";
+var ECOMIQ_APP_SUFFIX = [`.${ECOMIQ_APP_APEX}`, `.localhost`];
+function normalizeStoreHost(hostHeader) {
+  let h = hostHeader.trim().toLowerCase();
+  const colon = h.indexOf(":");
+  if (colon !== -1) h = h.slice(0, colon);
+  if (h.startsWith("www.")) h = h.slice(4);
+  return h;
+}
+function resolveStorefrontSettingsHost(hostHeader) {
+  const host = normalizeStoreHost(hostHeader);
+  if (!host) {
+    throw Object.assign(new Error("Host inv\xE1lido para tienda"), { status: 400 });
+  }
+  if (host === ECOMIQ_APP_APEX) {
+    throw Object.assign(new Error("Host apex ecomiq.app sin slug de tienda"), { status: 400 });
+  }
+  if (ECOMIQ_APP_SUFFIX.some((suffix) => host.endsWith(suffix))) {
+    const slug = host.slice(0, -(ECOMIQ_APP_SUFFIX.find((suffix) => host.endsWith(suffix))?.length ?? 0));
+    if (!slug) {
+      throw Object.assign(new Error("Host sin slug para ecomiq.app"), { status: 400 });
+    }
+    return slug;
+  }
+  return host;
+}
+
+// src/core/config/ecomiq-config.ts
+var CONFIG_FILENAMES = [
+  "ecomiq.config.js",
+  "ecomiq.config.cjs",
+  "ecomiq.config.mjs"
+];
+var EcomiqConfigSchema = z.object({
+  /**
+   * Slug de tienda en Ecomiq (p. ej. `mi-tienda` para `mi-tienda.ecomiq.app`).
+   * Si está definido, tiene prioridad sobre el `Host` de la request (útil en `localhost`).
+   */
+  slugStore: z.string().min(1).optional()
+});
+var cachedConfig;
+function parseExportedConfig(raw) {
+  const candidate = raw && typeof raw === "object" && "default" in raw ? raw.default : raw;
+  const parsed = EcomiqConfigSchema.safeParse(candidate);
+  if (!parsed.success) {
+    console.warn(
+      "[ecomiq] ecomiq.config.* inv\xE1lido:",
+      parsed.error.flatten().fieldErrors
+    );
+    return null;
+  }
+  const slugStore = parsed.data.slugStore?.trim();
+  return slugStore ? { slugStore } : {};
+}
+function loadEcomiqConfig(cwd = process.cwd()) {
+  if (cachedConfig !== void 0) return cachedConfig;
+  for (const filename of CONFIG_FILENAMES) {
+    const configPath = join(cwd, filename);
+    if (!existsSync(configPath)) continue;
+    try {
+      const requireFromApp = createRequire(join(cwd, "package.json"));
+      const loaded = requireFromApp(configPath);
+      const parsed = parseExportedConfig(loaded);
+      cachedConfig = parsed;
+      return cachedConfig;
+    } catch (error) {
+      console.warn(`[ecomiq] No se pudo cargar ${configPath}:`, error);
+    }
+  }
+  cachedConfig = null;
+  return null;
+}
+function clearEcomiqConfigCache() {
+  cachedConfig = void 0;
+}
+function resolvePublicStoreKey(hostHeader, cwd) {
+  const slugFromConfig = loadEcomiqConfig(cwd)?.slugStore?.trim();
+  if (slugFromConfig) return slugFromConfig;
+  if (!hostHeader?.trim()) {
+    throw Object.assign(
+      new Error(
+        "Host is required, o define slugStore en ecomiq.config.js en la ra\xEDz del proyecto"
+      ),
+      { status: 400 }
+    );
+  }
+  return resolveStorefrontSettingsHost(hostHeader);
+}
+function hasEcomiqSlugStoreConfig(cwd) {
+  return Boolean(loadEcomiqConfig(cwd)?.slugStore?.trim());
+}
+
+export { EcomiqConfigSchema, clearEcomiqConfigCache, hasEcomiqSlugStoreConfig, loadEcomiqConfig, resolvePublicStoreKey };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/client/storefront-settings-kv.service.ts","../src/core/config/ecomiq-config.ts"],"names":[],"mappings":";;;;;;;;AAOA,IAAM,eAAA,GAAkB,YAAA;AACxB,IAAM,iBAAA,GAAoB,CAAC,CAAA,CAAA,EAAI,eAAe,IAAI,CAAA,UAAA,CAAY,CAAA;AAOvD,SAAS,mBAAmB,UAAA,EAA4B;AAC7D,EAAA,IAAI,CAAA,GAAI,UAAA,CAAW,IAAA,EAAK,CAAE,WAAA,EAAY;AACtC,EAAA,MAAM,KAAA,GAAQ,CAAA,CAAE,OAAA,CAAQ,GAAG,CAAA;AAC3B,EAAA,IAAI,UAAU,EAAA,EAAI,CAAA,GAAI,CAAA,CAAE,KAAA,CAAM,GAAG,KAAK,CAAA;AACtC,EAAA,IAAI,EAAE,UAAA,CAAW,MAAM,GAAG,CAAA,GAAI,CAAA,CAAE,MAAM,CAAC,CAAA;AACvC,EAAA,OAAO,CAAA;AACT;AAMO,SAAS,8BAA8B,UAAA,EAA4B;AACxE,EAAA,MAAM,IAAA,GAAO,mBAAmB,UAAU,CAAA;AAC1C,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,MAAA,CAAO,OAAO,IAAI,KAAA,CAAM,8BAA2B,CAAA,EAAG,EAAE,MAAA,EAAQ,GAAA,EAAK,CAAA;AAAA,EAC7E;AACA,EAAA,IAAI,SAAS,eAAA,EAAiB;AAC5B,IAAA,MAAM,MAAA,CAAO,OAAO,IAAI,KAAA,CAAM,yCAAyC,CAAA,EAAG,EAAE,MAAA,EAAQ,GAAA,EAAK,CAAA;AAAA,EAC3F;AACA,EAAA,IAAI,kBAAkB,IAAA,CAAK,CAAA,MAAA,KAAU,KAAK,QAAA,CAAS,MAAM,CAAC,CAAA,EAAG;AAC3D,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,EAAE,iBAAA,CAAkB,IAAA,CAAK,CAAA,MAAA,KAAU,IAAA,CAAK,QAAA,CAAS,MAAM,CAAC,CAAA,EAAG,UAAU,CAAA,CAAE,CAAA;AAClG,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA,MAAM,MAAA,CAAO,OAAO,IAAI,KAAA,CAAM,+BAA+B,CAAA,EAAG,EAAE,MAAA,EAAQ,GAAA,EAAK,CAAA;AAAA,IACjF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA;AACT;;;ACrCA,IAAM,gBAAA,GAAmB;AAAA,EACvB,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAA;AAEO,IAAM,kBAAA,GAAqB,EAAE,MAAA,CAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKzC,WAAW,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,CAAC,EAAE,QAAA;AAC/B,CAAC;AAID,IAAI,YAAA;AAEJ,SAAS,oBAAoB,GAAA,EAAmC;AAC9D,EAAA,MAAM,SAAA,GACJ,OAAO,OAAO,GAAA,KAAQ,YAAY,SAAA,IAAc,GAAA,GAC3C,IAA6B,OAAA,GAC9B,GAAA;AACN,EAAA,MAAM,MAAA,GAAS,kBAAA,CAAmB,SAAA,CAAU,SAAS,CAAA;AACrD,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAA,CAAQ,IAAA;AAAA,MACN,uCAAA;AAAA,MACA,MAAA,CAAO,KAAA,CAAM,OAAA,EAAQ,CAAE;AAAA,KACzB;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,CAAK,SAAA,EAAW,IAAA,EAAK;AAC9C,EAAA,OAAO,SAAA,GAAY,EAAE,SAAA,EAAU,GAAI,EAAC;AACtC;AAMO,SAAS,gBAAA,CAAiB,GAAA,GAAM,OAAA,CAAQ,GAAA,EAAI,EAAwB;AACzE,EAAA,IAAI,YAAA,KAAiB,QAAW,OAAO,YAAA;AAEvC,EAAA,KAAA,MAAW,YAAY,gBAAA,EAAkB;AACvC,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAA;AACrC,IAAA,IAAI,CAAC,UAAA,CAAW,UAAU,CAAA,EAAG;AAE7B,IAAA,IAAI;AACF,MAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,IAAA,CAAK,GAAA,EAAK,cAAc,CAAC,CAAA;AAC9D,MAAA,MAAM,MAAA,GAAS,eAAe,UAAU,CAAA;AACxC,MAAA,MAAM,MAAA,GAAS,oBAAoB,MAAM,CAAA;AACzC,MAAA,YAAA,GAAe,MAAA;AACf,MAAA,OAAO,YAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,2BAAA,EAA8B,UAAU,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAAA,IACjE;AAAA,EACF;AAEA,EAAA,YAAA,GAAe,IAAA;AACf,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,sBAAA,GAA+B;AAC7C,EAAA,YAAA,GAAe,MAAA;AACjB;AAOO,SAAS,qBAAA,CACd,YACA,GAAA,EACQ;AACR,EAAA,MAAM,cAAA,GAAiB,gBAAA,CAAiB,GAAG,CAAA,EAAG,WAAW,IAAA,EAAK;AAC9D,EAAA,IAAI,gBAAgB,OAAO,cAAA;AAE3B,EAAA,IAAI,CAAC,UAAA,EAAY,IAAA,EAAK,EAAG;AACvB,IAAA,MAAM,MAAA,CAAO,MAAA;AAAA,MACX,IAAI,KAAA;AAAA,QACF;AAAA,OACF;AAAA,MACA,EAAE,QAAQ,GAAA;AAAI,KAChB;AAAA,EACF;AAEA,EAAA,OAAO,8BAA8B,UAAU,CAAA;AACjD;AAEO,SAAS,yBAAyB,GAAA,EAAuB;AAC9D,EAAA,OAAO,QAAQ,gBAAA,CAAiB,GAAG,CAAA,EAAG,SAAA,EAAW,MAAM,CAAA;AACzD","file":"index.js","sourcesContent":["import { getCloudflareContext } from \"@opennextjs/cloudflare\";\nimport { StorefrontSettingsSchema } from \"@ecomiq/storefront/core\";\nimport type { StorefrontSettings } from \"@ecomiq/storefront/core\";\n\n/** Debe coincidir con el `binding` en wrangler.jsonc (`kv_namespaces`). */\nexport const ECOMIQ_CLIENTS_STORE_KV_BINDING = \"ecomiq_clients_store\" as const;\n\nconst ECOMIQ_APP_APEX = \"ecomiq.app\";\nconst ECOMIQ_APP_SUFFIX = [`.${ECOMIQ_APP_APEX}`, `.localhost`];\n\ntype KvJsonGet = {\n  get(key: string, options: { type: \"json\" }): Promise<unknown>;\n};\n\n/** Host sin puerto, minúsculas, sin `www.`. */\nexport function normalizeStoreHost(hostHeader: string): string {\n  let h = hostHeader.trim().toLowerCase();\n  const colon = h.indexOf(\":\");\n  if (colon !== -1) h = h.slice(0, colon);\n  if (h.startsWith(\"www.\")) h = h.slice(4);\n  return h;\n}\n\n/**\n * Identificador de tienda a partir del `Host`: slug en `*.ecomiq.app`, FQDN en dominio propio.\n * Misma semántica que el sufijo de `buildStorefrontKvSnapshotKey` (sin el prefijo KV).\n */\nexport function resolveStorefrontSettingsHost(hostHeader: string): string {\n  const host = normalizeStoreHost(hostHeader);\n  if (!host) {\n    throw Object.assign(new Error(\"Host inválido para tienda\"), { status: 400 });\n  }\n  if (host === ECOMIQ_APP_APEX) {\n    throw Object.assign(new Error(\"Host apex ecomiq.app sin slug de tienda\"), { status: 400 });\n  }\n  if (ECOMIQ_APP_SUFFIX.some(suffix => host.endsWith(suffix))) {\n    const slug = host.slice(0, -(ECOMIQ_APP_SUFFIX.find(suffix => host.endsWith(suffix))?.length ?? 0));\n    if (!slug) {\n      throw Object.assign(new Error(\"Host sin slug para ecomiq.app\"), { status: 400 });\n    }\n    return slug;\n  }\n  return host;\n}\n\n/**\n * Clave KV del snapshot de tienda.\n * - `*.ecomiq.app` → `storefront:snapshots:store:<slug>` (todo lo que va antes de `.ecomiq.app`, p. ej. `plata950`).\n * - Dominio propio (p. ej. `plata950.com`) → `storefront:snapshots:store:<dominio completo>`.\n */\nexport function buildStorefrontKvSnapshotKeyFromStoreKey(storeKey: string): string {\n  const key = storeKey.trim();\n  if (!key) {\n    throw Object.assign(new Error(\"Store key vacío para KV\"), { status: 400 });\n  }\n  return `storefront:snapshots:store:${key}`;\n}\n\nexport function buildStorefrontKvSnapshotKey(hostHeader: string): string {\n  return buildStorefrontKvSnapshotKeyFromStoreKey(\n    resolveStorefrontSettingsHost(hostHeader),\n  );\n}\n\nfunction getKvNamespace(env: unknown): KvJsonGet | undefined {\n  if (!env || typeof env !== \"object\") return undefined;\n  const ns = (env as Record<string, unknown>)[ECOMIQ_CLIENTS_STORE_KV_BINDING];\n  if (!ns || typeof ns !== \"object\" || typeof (ns as KvJsonGet).get !== \"function\") {\n    return undefined;\n  }\n  return ns as KvJsonGet;\n}\n\n/**\n * Lee settings desde KV con clave ya resuelta (slug o dominio).\n */\nexport async function getStorefrontSettingsFromKvByStoreKey(\n  storeKey: string,\n): Promise<StorefrontSettings> {\n  const { env } = await getCloudflareContext({ async: true });\n  const kv = getKvNamespace(env);\n  if (!kv) {\n    const err = new Error(\n      `Binding KV \"${ECOMIQ_CLIENTS_STORE_KV_BINDING}\" no encontrado. Configura kv_namespaces en wrangler.`\n    );\n    throw Object.assign(err, { status: 500 });\n  }\n\n  const cacheKey = buildStorefrontKvSnapshotKeyFromStoreKey(storeKey);\n  const raw = await kv.get(cacheKey, { type: \"json\" });\n  if (raw == null) {\n    const err = new Error(\"Store settings not found in KV\");\n    throw Object.assign(err, { status: 404 });\n  }\n\n  return StorefrontSettingsSchema.parse(raw);\n}\n\n/**\n * Lee settings desde KV (`ecomiq_clients_store`) usando la clave según el host.\n */\nexport async function getStorefrontSettingsFromKv(hostHeader: string): Promise<StorefrontSettings> {\n  return getStorefrontSettingsFromKvByStoreKey(\n    resolveStorefrontSettingsHost(hostHeader),\n  );\n}\n","import { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join } from \"node:path\";\nimport { z } from \"zod\";\nimport { resolveStorefrontSettingsHost } from \"../client/storefront-settings-kv.service\";\n\nconst CONFIG_FILENAMES = [\n  \"ecomiq.config.js\",\n  \"ecomiq.config.cjs\",\n  \"ecomiq.config.mjs\",\n] as const;\n\nexport const EcomiqConfigSchema = z.object({\n  /**\n   * Slug de tienda en Ecomiq (p. ej. `mi-tienda` para `mi-tienda.ecomiq.app`).\n   * Si está definido, tiene prioridad sobre el `Host` de la request (útil en `localhost`).\n   */\n  slugStore: z.string().min(1).optional(),\n});\n\nexport type EcomiqConfig = z.infer<typeof EcomiqConfigSchema>;\n\nlet cachedConfig: EcomiqConfig | null | undefined;\n\nfunction parseExportedConfig(raw: unknown): EcomiqConfig | null {\n  const candidate =\n    raw && typeof raw === \"object\" && \"default\" in (raw as object)\n      ? (raw as { default: unknown }).default\n      : raw;\n  const parsed = EcomiqConfigSchema.safeParse(candidate);\n  if (!parsed.success) {\n    console.warn(\n      \"[ecomiq] ecomiq.config.* inválido:\",\n      parsed.error.flatten().fieldErrors,\n    );\n    return null;\n  }\n  const slugStore = parsed.data.slugStore?.trim();\n  return slugStore ? { slugStore } : {};\n}\n\n/**\n * Carga `ecomiq.config.js` (o `.cjs` / `.mjs`) desde la raíz del proyecto (`process.cwd()`).\n * Resultado en caché por proceso.\n */\nexport function loadEcomiqConfig(cwd = process.cwd()): EcomiqConfig | null {\n  if (cachedConfig !== undefined) return cachedConfig;\n\n  for (const filename of CONFIG_FILENAMES) {\n    const configPath = join(cwd, filename);\n    if (!existsSync(configPath)) continue;\n\n    try {\n      const requireFromApp = createRequire(join(cwd, \"package.json\"));\n      const loaded = requireFromApp(configPath) as unknown;\n      const parsed = parseExportedConfig(loaded);\n      cachedConfig = parsed;\n      return cachedConfig;\n    } catch (error) {\n      console.warn(`[ecomiq] No se pudo cargar ${configPath}:`, error);\n    }\n  }\n\n  cachedConfig = null;\n  return null;\n}\n\n/** Limpia la caché (tests o recarga en dev). */\nexport function clearEcomiqConfigCache(): void {\n  cachedConfig = undefined;\n}\n\n/**\n * Identificador de tienda para settings (API / KV).\n * 1. `slugStore` en `ecomiq.config.*` si existe.\n * 2. Si no, deriva del header `Host` (`resolveStorefrontSettingsHost`).\n */\nexport function resolvePublicStoreKey(\n  hostHeader: string | null | undefined,\n  cwd?: string,\n): string {\n  const slugFromConfig = loadEcomiqConfig(cwd)?.slugStore?.trim();\n  if (slugFromConfig) return slugFromConfig;\n\n  if (!hostHeader?.trim()) {\n    throw Object.assign(\n      new Error(\n        \"Host is required, o define slugStore en ecomiq.config.js en la raíz del proyecto\",\n      ),\n      { status: 400 },\n    );\n  }\n\n  return resolveStorefrontSettingsHost(hostHeader);\n}\n\nexport function hasEcomiqSlugStoreConfig(cwd?: string): boolean {\n  return Boolean(loadEcomiqConfig(cwd)?.slugStore?.trim());\n}\n"]}

package/dist/nextjs/globals.css

@@ -1,11 +1,10 @@
 /**
- * Estilos base del SDK para consumidores npm (sin @ecomiq/ui).
- * La app debe aportar su propio sistema de diseño / primitivos UI.
+ * Estilos mínimos para consumidores npm.
+ * La app define su propio design system y componentes.
  */
 @import "tailwindcss";
 
-@source "../react/";
-@source "../react/components/cms-sections-renderer.tsx";
+@source "../react/shell/components/product-variant-selector/";
 
 @layer base {
   * {