@ecomiq/storefront 2.0.17 → 2.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecomiq/storefront",
-  "version": "2.0.17",
+  "version": "2.0.18",
   "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",
@@ -78,7 +79,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/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',
+    },
+  })
+}