@ecomiq/storefront 2.0.17 → 2.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecomiq/storefront",
-  "version": "2.0.17",
+  "version": "2.0.19",
   "description": "Micro framework SSR de Ecomiq para storefronts. Páginas, datos y deploy sin configurar nada.",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,7 @@
     "./internal/page": "./src/runtime/page.tsx",
     "./internal/context": "./src/runtime/context.ts",
     "./internal/server-config": "./src/server-config-store.ts",
+    "./internal/health": "./src/health.ts",
     "./internal/head": "./src/runtime/head.ts",
     "./internal/default-layout": "./src/runtime/default-layout.tsx",
     "./internal/checkout": "./src/pages/checkout.tsx",
@@ -49,6 +50,7 @@
     "bin",
     "src",
     "templates",
+    "public",
     "README.md"
   ],
   "sideEffects": [
@@ -78,7 +80,7 @@
     "vite": "^8.1.0",
     "wrangler": "^4.100.0",
     "zod": "^3.25.0",
-    "@ecomiq/core": "^0.1.5"
+    "@ecomiq/core": "^0.1.6"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/public/design-bridge.js

@@ -0,0 +1,318 @@
+/**
+ * Puente de modo design (solo dev). El parent (frontend) envía postMessage;
+ * este script pinta hover/select y devuelve metadata del nodo.
+ */
+(function () {
+  if (typeof window === 'undefined' || window.parent === window) return;
+
+  var enabled = false;
+  var selectedEl = null;
+  var selectionLocked = false;
+  var previewStyles = {};
+  var hoverBox = null;
+  var hoverLabel = null;
+  var selectBox = null;
+  var selectLabel = null;
+
+  function ensureOverlay() {
+    if (hoverBox) return;
+    var style = document.createElement('style');
+    style.textContent =
+      '#__design_hover__,#__design_select__{pointer-events:none;position:fixed;z-index:2147483646;box-sizing:border-box;transition:top .05s,left .05s,width .05s,height .05s}' +
+      '#__design_hover__{border:2px solid #6366f1;background:rgba(99,102,241,.1)}' +
+      '#__design_select__{border:2px solid #c8a96e;background:rgba(200,169,110,.12)}' +
+      '.__design_lbl{position:fixed;z-index:2147483647;font:11px/1.3 ui-monospace,monospace;padding:2px 6px;border-radius:4px;white-space:nowrap;pointer-events:none}' +
+      '.__design_lbl_hover{background:#6366f1;color:#fff}' +
+      '.__design_lbl_select{background:#c8a96e;color:#1a1714}';
+    document.head.appendChild(style);
+
+    hoverBox = document.createElement('div');
+    hoverBox.id = '__design_hover__';
+    hoverBox.hidden = true;
+    hoverLabel = document.createElement('div');
+    hoverLabel.className = '__design_lbl __design_lbl_hover';
+    hoverLabel.hidden = true;
+
+    selectBox = document.createElement('div');
+    selectBox.id = '__design_select__';
+    selectBox.hidden = true;
+    selectLabel = document.createElement('div');
+    selectLabel.className = '__design_lbl __design_lbl_select';
+    selectLabel.hidden = true;
+
+    document.body.appendChild(hoverBox);
+    document.body.appendChild(hoverLabel);
+    document.body.appendChild(selectBox);
+    document.body.appendChild(selectLabel);
+  }
+
+  function escapeCss(value) {
+    if (typeof CSS !== 'undefined' && CSS.escape) return CSS.escape(value);
+    return value.replace(/[^a-zA-Z0-9_-]/g, '\\$&');
+  }
+
+  function pickElement(raw) {
+    if (!raw || raw === document.body || raw === document.documentElement) return null;
+    if (raw.id === '__design_hover__' || raw.id === '__design_select__') return null;
+    if (raw.classList && raw.classList.contains('__design_lbl')) return null;
+    return raw;
+  }
+
+  function getLabel(el) {
+    var tag = el.tagName.toLowerCase();
+    var classes = Array.from(el.classList || []).filter(function (c) {
+      return !c.startsWith('__design');
+    });
+    if (classes.length) return tag + '.' + classes.slice(0, 2).join('.');
+    return tag;
+  }
+
+  function getSelector(el) {
+    if (el.id) return '#' + escapeCss(el.id);
+    var parts = [];
+    var current = el;
+    while (current && current !== document.body && current !== document.documentElement) {
+      var part = current.tagName.toLowerCase();
+      if (current.id) {
+        parts.unshift('#' + escapeCss(current.id));
+        break;
+      }
+      var parent = current.parentElement;
+      if (parent) {
+        var siblings = Array.from(parent.children).filter(function (c) {
+          return c.tagName === current.tagName;
+        });
+        if (siblings.length > 1) {
+          var idx = siblings.indexOf(current) + 1;
+          part += ':nth-of-type(' + idx + ')';
+        }
+      }
+      var cls = Array.from(current.classList || []).find(function (c) {
+        return !c.startsWith('__design') && !c.startsWith('design-');
+      });
+      if (cls) part += '.' + escapeCss(cls);
+      parts.unshift(part);
+      current = parent;
+    }
+    return parts.join(' > ');
+  }
+
+  function textSnippet(el) {
+    var text = (el.innerText || el.textContent || '').replace(/\s+/g, ' ').trim();
+    if (!text) return undefined;
+    return text.length > 80 ? text.slice(0, 80) + '…' : text;
+  }
+
+  function camelToKebab(key) {
+    return key.replace(/[A-Z]/g, function (m) {
+      return '-' + m.toLowerCase();
+    });
+  }
+
+  function computedSnapshot(el) {
+    var cs = window.getComputedStyle(el);
+    return {
+      display: cs.display,
+      paddingTop: cs.paddingTop,
+      paddingRight: cs.paddingRight,
+      paddingBottom: cs.paddingBottom,
+      paddingLeft: cs.paddingLeft,
+      marginTop: cs.marginTop,
+      marginRight: cs.marginRight,
+      marginBottom: cs.marginBottom,
+      marginLeft: cs.marginLeft,
+      fontSize: cs.fontSize,
+      fontWeight: cs.fontWeight,
+      lineHeight: cs.lineHeight,
+      letterSpacing: cs.letterSpacing,
+      color: cs.color,
+      backgroundColor: cs.backgroundColor,
+      borderWidth: cs.borderWidth,
+      borderStyle: cs.borderStyle,
+      borderColor: cs.borderColor,
+      borderRadius: cs.borderRadius,
+      opacity: cs.opacity,
+      boxShadow: cs.boxShadow,
+      textAlign: cs.textAlign,
+    };
+  }
+
+  function elementRect(el) {
+    var r = el.getBoundingClientRect();
+    return {
+      top: r.top,
+      left: r.left,
+      width: r.width,
+      height: r.height,
+    };
+  }
+
+  function elementPayload(el) {
+    return {
+      selector: getSelector(el),
+      tag: el.tagName.toLowerCase(),
+      label: getLabel(el),
+      classes: Array.from(el.classList || []).filter(function (c) {
+        return !c.startsWith('__design');
+      }),
+      textSnippet: textSnippet(el),
+      computedStyles: computedSnapshot(el),
+      rect: elementRect(el),
+    };
+  }
+
+  var rectRaf = null;
+  function postSelectionRect() {
+    if (!selectionLocked || !selectedEl) return;
+    if (rectRaf) return;
+    rectRaf = requestAnimationFrame(function () {
+      rectRaf = null;
+      post('DESIGN_RECT', { rect: elementRect(selectedEl) });
+    });
+  }
+
+  function clearPreviewStyles() {
+    if (!selectedEl) return;
+    Object.keys(previewStyles).forEach(function (key) {
+      selectedEl.style.removeProperty(camelToKebab(key));
+    });
+    previewStyles = {};
+    updateSelectOverlay();
+  }
+
+  function applyPreviewStyles(styles) {
+    if (!selectedEl || !styles) return;
+    Object.keys(styles).forEach(function (key) {
+      var val = styles[key];
+      if (val === '' || val == null) {
+        selectedEl.style.removeProperty(camelToKebab(key));
+        delete previewStyles[key];
+      } else {
+        selectedEl.style.setProperty(camelToKebab(key), String(val));
+        previewStyles[key] = String(val);
+      }
+    });
+    updateSelectOverlay();
+  }
+
+  function placeBox(box, label, el) {
+    var rect = el.getBoundingClientRect();
+    box.style.top = rect.top + 'px';
+    box.style.left = rect.left + 'px';
+    box.style.width = rect.width + 'px';
+    box.style.height = rect.height + 'px';
+    box.hidden = false;
+
+    label.textContent = getLabel(el);
+    label.style.top = Math.max(4, rect.top - 22) + 'px';
+    label.style.left = rect.left + 'px';
+    label.hidden = false;
+  }
+
+  function hideHover() {
+    if (hoverBox) hoverBox.hidden = true;
+    if (hoverLabel) hoverLabel.hidden = true;
+  }
+
+  function updateSelectOverlay() {
+    if (selectionLocked && selectedEl) {
+      placeBox(selectBox, selectLabel, selectedEl);
+      postSelectionRect();
+    }
+  }
+
+  function post(type, payload) {
+    window.parent.postMessage(
+      { source: 'design-bridge', type: type, payload: payload || {} },
+      '*',
+    );
+  }
+
+  function clearSelection(notifyParent) {
+    clearPreviewStyles();
+    selectedEl = null;
+    selectionLocked = false;
+    if (selectBox) selectBox.hidden = true;
+    if (selectLabel) selectLabel.hidden = true;
+    if (notifyParent) post('DESIGN_DESELECT');
+  }
+
+  function onMouseMove(e) {
+    if (!enabled) return;
+
+    if (selectionLocked && selectedEl) {
+      updateSelectOverlay();
+      hideHover();
+      return;
+    }
+
+    var el = pickElement(document.elementFromPoint(e.clientX, e.clientY));
+    if (!el) {
+      hideHover();
+      return;
+    }
+    placeBox(hoverBox, hoverLabel, el);
+    post('DESIGN_HOVER', elementPayload(el));
+  }
+
+  function onClick(e) {
+    if (!enabled) return;
+    e.preventDefault();
+    e.stopPropagation();
+
+    var el = pickElement(document.elementFromPoint(e.clientX, e.clientY));
+    if (!el) return;
+
+    if (selectionLocked && selectedEl) {
+      if (el === selectedEl) {
+        clearSelection(true);
+        return;
+      }
+      // Click fuera del popover / en otro nodo ya no deselecciona.
+      // clearSelection(true);
+      return;
+    }
+
+    selectedEl = el;
+    selectionLocked = true;
+    placeBox(selectBox, selectLabel, el);
+    hideHover();
+    post('DESIGN_SELECT', elementPayload(el));
+  }
+
+  function enable() {
+    if (enabled) return;
+    enabled = true;
+    ensureOverlay();
+    document.addEventListener('mousemove', onMouseMove, true);
+    document.addEventListener('click', onClick, true);
+    window.addEventListener('scroll', updateSelectOverlay, true);
+    window.addEventListener('resize', updateSelectOverlay);
+    document.body.style.cursor = 'crosshair';
+    post('DESIGN_READY');
+  }
+
+  function disable() {
+    if (!enabled) return;
+    enabled = false;
+    clearSelection(false);
+    document.removeEventListener('mousemove', onMouseMove, true);
+    document.removeEventListener('click', onClick, true);
+    window.removeEventListener('scroll', updateSelectOverlay, true);
+    window.removeEventListener('resize', updateSelectOverlay);
+    document.body.style.cursor = '';
+    hideHover();
+  }
+
+  window.addEventListener('message', function (event) {
+    var data = event.data;
+    if (!data || data.target !== 'design-bridge') return;
+    if (data.type === 'DESIGN_ENABLE') enable();
+    if (data.type === 'DESIGN_DISABLE') disable();
+    if (data.type === 'DESIGN_CLEAR_SELECTION') clearSelection(false);
+    if (data.type === 'DESIGN_APPLY_STYLES') applyPreviewStyles(data.payload && data.payload.styles);
+    if (data.type === 'DESIGN_CLEAR_PREVIEW') clearPreviewStyles();
+  });
+
+  post('DESIGN_READY');
+})();

package/src/codegen.mjs

@@ -155,15 +155,18 @@ export async function generateApp({ cwd, appDir, frameworkRoot, config }) {
     HEADER +
       `import startServer, { createServerEntry } from '@tanstack/react-start/server-entry'\n` +
       `import config from '../../ecomiq.config.js'\n` +
-      `import { registerServerConfig } from '@ecomiq/storefront/internal/server-config'\n\n` +
+      `import { registerServerConfig } from '@ecomiq/storefront/internal/server-config'\n` +
+      `import { handleEcomiqHealth } from '@ecomiq/storefront/internal/health'\n\n` +
       `export default createServerEntry({\n` +
-      `  async fetch(...args) {\n` +
+      `  async fetch(request, ...rest) {\n` +
       `    let api = config.api\n` +
       `    if (import.meta.env.DEV && config.dev?.apiBaseUrl) {\n` +
       `      api = { ...api, baseUrl: config.dev.apiBaseUrl }\n` +
       `    }\n` +
       `    registerServerConfig({ domain: config.domain, api })\n` +
-      `    return startServer.fetch(...args)\n` +
+      `    const health = await handleEcomiqHealth(request)\n` +
+      `    if (health) return health\n` +
+      `    return startServer.fetch(request, ...rest)\n` +
       `  },\n` +
       `})\n`,
   )

package/src/health.ts

@@ -0,0 +1,90 @@
+/**
+ * Health interno del runtime storefront.
+ * GET /ping            → liveness puro: "ok" 200 (target del probe de vm-manager).
+ * GET /__ecomiq/health → proceso up + estado de /v1/settings (sin SSR de páginas).
+ */
+import { getStorefrontClient } from './client'
+
+export const ECOMIQ_HEALTH_PATH = '/__ecomiq/health'
+export const ECOMIQ_PING_PATH = '/ping'
+
+export type EcomiqHealthSettingsStatus = {
+  ok: boolean
+  latencyMs: number
+  storeId?: string
+  domain?: string | null
+  error?: string
+}
+
+export type EcomiqHealthResponse = {
+  ok: true
+  settings: EcomiqHealthSettingsStatus
+}
+
+async function probeSettings(): Promise<EcomiqHealthSettingsStatus> {
+  const started = Date.now()
+  try {
+    const settings = await getStorefrontClient().getSettings()
+    return {
+      ok: true,
+      latencyMs: Date.now() - started,
+      storeId: settings.store.id,
+      domain: settings.store.domain ?? settings.store.slug,
+    }
+  } catch (error) {
+    return {
+      ok: false,
+      latencyMs: Date.now() - started,
+      error: error instanceof Error ? error.message : String(error),
+    }
+  }
+}
+
+/**
+ * Si el request es al health interno, responde JSON.
+ * Si no, `null` para que el caller siga con el fetch normal de TanStack.
+ */
+export async function handleEcomiqHealth(
+  request: Request,
+): Promise<Response | null> {
+  const { pathname } = new URL(request.url)
+  if (pathname !== ECOMIQ_HEALTH_PATH && pathname !== ECOMIQ_PING_PATH) {
+    return null
+  }
+
+  if (request.method !== 'GET' && request.method !== 'HEAD') {
+    return new Response(null, {
+      status: 405,
+      headers: { allow: 'GET, HEAD' },
+    })
+  }
+
+  if (pathname === ECOMIQ_PING_PATH) {
+    return new Response(request.method === 'HEAD' ? null : 'ok', {
+      status: 200,
+      headers: {
+        'content-type': 'text/plain; charset=utf-8',
+        'cache-control': 'no-store',
+      },
+    })
+  }
+
+  const body: EcomiqHealthResponse = {
+    ok: true,
+    settings: await probeSettings(),
+  }
+
+  if (request.method === 'HEAD') {
+    return new Response(null, {
+      status: 200,
+      headers: { 'content-type': 'application/json; charset=utf-8' },
+    })
+  }
+
+  return Response.json(body, {
+    status: 200,
+    headers: {
+      'cache-control': 'no-store',
+    },
+  })
+}

package/src/vite-inline.mjs

@@ -21,7 +21,28 @@ const postcssBrowserStub = fileURLToPath(
 )
 
 const frameworkRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const designBridgePath = resolve(frameworkRoot, 'public', 'design-bridge.js')
 
+/** Sirve /design-bridge.js desde el package (no desde public/ del usuario). */
+function designBridgePlugin() {
+  return {
+    name: 'ecomiq:design-bridge',
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        const url = req.url?.split('?')[0]
+        if (url !== '/design-bridge.js') return next()
+        try {
+          const body = readFileSync(designBridgePath)
+          res.setHeader('Content-Type', 'application/javascript; charset=utf-8')
+          res.setHeader('Cache-Control', 'no-store')
+          res.end(body)
+        } catch (error) {
+          next(error)
+        }
+      })
+    },
+  }
+}
 function resolveSanitizeHtmlPostcss(source, importer) {
   if (source !== 'postcss') return null
   if (!importer?.includes('/sanitize-html/')) return null
@@ -160,7 +181,7 @@ export function createViteConfig({ appDir, config, projectRoot, runtime }) {
   const resolvedRuntime = resolveDevRuntime({ config, runtime })
   const resolvedHttps = resolveDevHttps({ config, projectRoot: root, appDir })
 
-  const plugins = [tailwindcss()]
+  const plugins = [tailwindcss(), designBridgePlugin()]
 
   if (resolvedHttps.plugin) {
     plugins.push(resolvedHttps.plugin)

package/templates/__root.tsx

@@ -50,6 +50,10 @@ function RootDocument({ children, language }: { children: ReactNode; language: s
       </head>
       <body className="bg-background text-foreground antialiased">
         {children}
+        {/* Puente de design mode (solo dev): el parent (admin) pinta hover/select. */}
+        {import.meta.env.DEV ? (
+          <script src="/design-bridge.js?v=1.0.0" defer />
+        ) : null}
         <Scripts />
       </body>
     </html>