createDenoAssetReader

createDenoAssetReader({ root, assets }) es el lector de archivos públicos de Deno: responde sólo a las rutas del manifiesto de assets del build, con el archivo abierto con Deno.open y enviado en streaming, y devuelve null para las demás, que nunca se buscan en el disco. Las cabeceras, HEAD, 304 y la política de caché son las de todos los adaptadores.

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 ?? {} }),
});
await serveDeno(app, { handleSignals: true });

Tipo#

function createDenoAssetReader(options: DenoAssetReaderOptions): AssetReader

interface DenoAssetReaderOptions {
	readonly root: string | URL
	readonly assets: AssetManifest
}

interface AssetReader {
	get(pathname: string, request: Request): Promise<Response | null>
}

Parámetros#

Valor devuelto#

Un AssetReader con get(pathname, request): null para una ruta que no está en assets o un método distinto de GET y HEAD; 304 si If-None-Match coincide, sin abrir el archivo; 200 con el cuerpo del archivo, content-type, ETag, content-length y cache-control (immutable un año para los archivos con hash, max-age=0, must-revalidate para el resto).

Ejemplos#

Permisos de lectura acotados#

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

El lector sólo abre archivos bajo root, así que basta con permitir la lectura de la carpeta de salida.

Un archivo grande en streaming#

GET /downloads/catalogo.pdf → 200, content-length: 18874368, el cuerpo es file.readable

Si el cliente se va, el stream se cancela y el archivo se cierra.

Errores comunes#

Permisos de lectura de otra carpeta#

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

La primera petición a un archivo listado falla con el error de permisos de Deno al abrirlo, y la aplicación responde 500 y lo envía a onError.

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

Ejecutarlo en Node#

await createDenoAssetReader({ root, assets }).get("/robots.txt", request); // en Node

Error: The Meeko Deno adapter requires the Deno runtime. En Node, use createNodeAssetReader.

const assets = createNodeAssetReader({ root: fileURLToPath(new URL("./client/", import.meta.url)), assets: manifest.assets ?? {} });

Notas#

• Seguridad. Las rutas se buscan en el manifiesto sin decodificar: ningún traversal coincide, y la clave sale del build, nunca de la petición.
• Sólo Deno. Importar @meekojs/meeko/deno en otro runtime no falla; lo que falla es leer un archivo.

Relacionado#

• 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.
• createNodeAssetReaderSirve desde el disco, en Node, sólo los archivos del build listados en el manifiesto de assets, en streaming y con ETag, HEAD, 304 y la política de caché de Meeko.
• createBunAssetReaderSirve con Bun.file sólo los archivos del build listados en el manifiesto de assets, con ETag, HEAD, 304 y la política de caché de Meeko.
• DenoMeeko como framework full-stack