serveDeno

serveDeno(app, options) pone en marcha Deno.serve para una aplicación de createServerApp: atiende HTTP con app.fetch, hace el upgrade de los canales Socket con Deno.upgradeWebSocket y registra la IP de cada conexión (remoteAddr). Con handleSignals, cierra de forma ordenada ante SIGINT y SIGTERM (SIGINT y SIGBREAK en Windows) y, desde 1.3, aplica processErrors.

Es lo que ejecuta la salida de meeko build --adapter deno (.meeko/output/deno/main.js).

Uso#

import { createServerApp } from "@meekojs/meeko/server";
import { createDenoAssetReader, serveDeno } from "@meekojs/meeko/deno";

const app = await createServerApp({
  manifest, load, runtime, production: true,
  assets: createDenoAssetReader({ root: new URL("./client/", import.meta.url), assets: manifest.assets ?? {} }),
});
const server = await serveDeno(app, { host: "0.0.0.0", port: 8000, handleSignals: true });
console.log(server.url);

Tipo#

function serveDeno(app: ServerApp, options?: ServeDenoOptions): Promise<DenoServer>

interface ServeDenoOptions {
	readonly host?: string
	readonly port?: number
	readonly publicOrigin?: string
	readonly platform?: ServerPlatform
	readonly onError?: (error: unknown, requestId: string) => void
	readonly maxMessageBytes?: number
	readonly idleTimeout?: number
	readonly handleSignals?: boolean
}

interface DenoServer {
	readonly url: string
	readonly finished: Promise<void>
	close(): Promise<void>
}

Parámetros#

serveDeno(app, options?):

Valor devuelto#

Una promesa con un DenoServer:

Ejemplos#

Construir y ejecutar con los permisos mínimos#

npx meeko build --adapter deno
deno run --allow-net --allow-env --allow-read=.meeko/output/deno .meeko/output/deno/main.js

main.js incluye todas las dependencias del servidor. --allow-env es necesario porque el runtime recibe Deno.env.toObject(); meeko preview --adapter deno concede -A.

Un contenedor#

FROM denoland/deno:2.9.8
WORKDIR /app
COPY .meeko/output/deno ./
ENV MEEKO_HOST=0.0.0.0 MEEKO_PORT=8000 MEEKO_PUBLIC_ORIGIN=https://tienda.example.com
EXPOSE 8000
CMD ["run", "--allow-net", "--allow-env", "--allow-read=.", "main.js"]

server.host y server.port de meeko.config.ts sólo se aplican a Node; aquí valen MEEKO_HOST y MEEKO_PORT (o PORT).

Pruebas con un puerto libre#

const server = await serveDeno(app, { port: 0 });
const response = await fetch(`${server.url}/api/health`);
await response.body?.cancel();
await server.close();
await server.finished;

Errores comunes#

Ejecutar la salida sin permisos#

deno run .meeko/output/deno/main.js

Deno pide acceso a la red, al entorno y a la lectura del build (o lo deniega si no hay una terminal), y sin esos permisos el arranque falla.

deno run --allow-net --allow-env --allow-read=.meeko/output/deno .meeko/output/deno/main.js

Llamarlo fuera de Deno#

// node server.mjs
await serveDeno(app);

Error: The Meeko Deno adapter requires the Deno runtime.

deno run --allow-net --allow-env --allow-read=. main.js

Un puerto o un límite no válidos#

await serveDeno(app, { port: 70000, maxMessageBytes: 0 });

RangeError: Invalid port: 70000; con un puerto válido, RangeError: Invalid maxMessageBytes (o Invalid idleTimeout).

await serveDeno(app, { port: 8000, maxMessageBytes: 16 * 1024 });

Notas#

• Socket en Deno. Deno.upgradeWebSocket no tiene límite de frame: el adaptador mide cada mensaje y cierra con 1009 los mayores, pero Deno ya lo reensambló en memoria. Limite el tamaño de las peticiones en el proxy si necesita un tope anterior. Los binarios se cierran con 1003; el búfer saliente se controla con bufferedAmount.
• Rechazos de sesión. Se hace el upgrade y se cierra con 4401 o 4403 una vuelta del bucle después de abrir, para que el cierre llegue al cliente aunque éste ya haya enviado un mensaje.
• Fallos del proceso. Deno usa unhandledrejection y error de globalThis; conserva el requestId en los rechazos.
• IP. remoteAddr de la conexión; tras un proxy, MEEKO_TRUST_PROXY. Una variable no válida detiene el arranque.
• CSP y cabeceras (desde 1.7). server.contentSecurityPolicy y server.headers se aplican igual que en Node.

Relacionado#

• createDenoAssetReaderSirve con Deno.open, en streaming, sólo los archivos del build listados en el manifiesto de assets, con ETag, HEAD, 304 y la política de caché de Meeko.
• handleProcessErrorsAplica a un host propio la política processErrors de server/runtime.ts para los rechazos sin manejar y las excepciones no capturadas fuera de una petición.
• createServerAppCrea la aplicación de servidor portable (páginas, API, RPC, Socket, assets, sesiones y middleware) a partir del manifiesto del build y un cargador de módulos.
• serveNodeSirve una aplicación de Meeko con el servidor HTTP de Node, sus canales Socket con ws, el cierre ordenado ante señales y la política de fallos del proceso.
• serverEl adaptador de meeko build (node, bun, deno, cloudflare o static) con sus opciones y, desde 1.7, la CSP y las cabeceras de las respuestas en los adaptadores con servidor.
• DenoMeeko como framework full-stack
• Conformidad entre adaptadoresMeeko como framework full-stack