meeko preview

meeko preview arranca el build de producción con el runtime de su adaptador, para comprobar que lo que se va a desplegar funciona: no compila nada, así que antes hay que ejecutar meeko build con el mismo adaptador.

Uso#

meeko build --adapter static
meeko preview --adapter static

http://localhost:4173

Tipo#

meeko preview [directorio] [--adapter <node|cloudflare|bun|deno|static>]

Opciones#

Resultado#

• Node y static imprimen la URL y sirven en este proceso hasta Ctrl+C. Como en meeko start, loopback y 0.0.0.0 se muestran como http://localhost:4173 y, con 0.0.0.0 o ::, siguen líneas Red: con las direcciones de red. Las salidas de Bun y Deno escriben lo mismo; Deno sólo lista la red con --allow-sys=networkInterfaces, que -A incluye.
• Bun, Deno y Cloudflare heredan la consola del proceso hijo, que escribe su propia salida; meeko preview le reenvía SIGINT y SIGTERM y termina con el código de salida del hijo.
• static sirve el archivo pedido, el index.html de la carpeta o 404.html con estado 404 (o el texto Not Found si el build no tiene 404.html, porque falta app/error.meeko), sin publicar _headers ni _meeko/, y aplica contentSecurityPolicy y headers como lo haría el hosting con headerFiles. Sólo admite GET y HEAD (otro método da 405 con Allow: GET, HEAD) y todo lleva cache-control: no-cache.

Ejemplos#

Un sitio estático antes de subirlo#

meeko build --adapter static
MEEKO_PORT=5000 meeko preview --adapter static

curl -sI http://127.0.0.1:5000/
# HTTP/1.1 200 OK
# content-type: text/html; charset=utf-8
# cache-control: no-cache
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:5000/no-existe
# 404

Bun o Deno#

meeko build --adapter bun
meeko preview --adapter bun

El build ya lleva todas las dependencias: lo que funciona aquí funciona copiando sólo .meeko/output/bun/ al servidor. Con Deno, preview concede todos los permisos (-A); en producción bastan --allow-net, --allow-env y --allow-read de la carpeta.

Cloudflare Workers en local#

pnpm add -D wrangler
meeko build --adapter cloudflare
MEEKO_PORT=8787 meeko preview --adapter cloudflare

preview usa el Wrangler de la aplicación o, si no lo tiene, el de la instalación de Meeko.

El adaptador de la configuración#

Con server: { adapter: "deno" } en meeko.config.ts, --adapter sobra en los dos comandos:

meeko build
meeko preview

Errores comunes#

Previsualizar otro adaptador que el construido#

meeko build --adapter static
meeko preview

Sin --adapter, preview toma el de la configuración (por defecto, node) y busca otro build: No hay build de producción en …\.meeko\output\node\index.mjs; ejecuta meeko build. Con los demás adaptadores el mensaje nombra su archivo, como No hay build de producción en …\.meeko\output\deno\main.js; ejecuta meeko build --adapter deno o No hay build estático en …\.meeko\output\static; ejecuta meeko build --adapter static.

meeko build --adapter static
meeko preview --adapter static

Cloudflare sin Wrangler#

meeko build --adapter cloudflare
meeko preview --adapter cloudflare

Si ni la aplicación ni Meeko encuentran Wrangler: Wrangler no está instalado; añádelo con pnpm add -D wrangler para previsualizar el build de cloudflare.

pnpm add -D wrangler
meeko preview --adapter cloudflare

--adapter sin nombre#

meeko preview --adapter

Falta el nombre del adaptador en --adapter de preview, con el uso y código 1. Un nombre que no existe da Adaptador desconocido: …; usa node, cloudflare, deno, bun o static.

meeko preview --adapter bun

Notas#

• Para probar, no para producción. Con Node, preview y start son el mismo servidor; con static, el servidor de preview sólo imita a un hosting y no debe exponerse a Internet. Con Deno, -A concede más permisos de los necesarios.
• Runtimes. bun y deno deben estar en el PATH. Si el ejecutable no existe, el error es Bun no está instalado o no está en el PATH; instálalo desde https://bun.sh para previsualizar el build de bun (o el equivalente de Deno). Un gestor de versiones con shims, como mise o asdf, puede interceptar el comando y mostrar su propio error.
• Windows y POSIX. El proceso hijo se lanza sin ventana propia en Windows, con la consola del padre, y recibe reenviados SIGINT y SIGTERM. Si el hijo termina por una señal, preview sale con código 1.
• Sesiones. Con Node, Bun y Deno, preview es producción: necesita MEEKO_REDIS_URL o sessions en server/runtime.ts, como meeko start.
• CSP. preview aplica server.contentSecurityPolicy y server.headers igual que producción (con static desde 1.3; con los adaptadores con servidor desde 1.7). Es el sitio para comprobar que la CSP no bloquea nada antes de desplegar.

Relacionado#

• meeko buildComprueba el proyecto y escribe en .meeko/output/<adaptador>/ la salida de producción, con el cliente, el servidor y las páginas prerenderizadas.
• meeko startArranca el servidor de producción de Node con la salida de meeko build, sin Vite ni las fuentes de la aplicación.
• createBunServerLos handlers fetch y websocket para servir una aplicación de Meeko con Bun.serve, con Socket sobre el WebSocket nativo de Bun y sus límites de payload, contrapresión e inactividad.
• serveDenoSirve una aplicación de Meeko con Deno.serve, con Socket sobre Deno.upgradeWebSocket, cierre ordenado ante señales y la política de fallos del proceso.
• createWorkerSirve una aplicación de Meeko desde un Worker de módulo de Cloudflare, creada una vez por aislado con los bindings, con los upgrades de Socket reenviados al Durable Object de su sala.
• Sitio estáticoMeeko como framework full-stack
• BunMeeko como framework full-stack
• DenoMeeko como framework full-stack
• Cloudflare WorkersMeeko como framework full-stack