nitro 3.0.0 → 3.0.1-alpha.1

package/dist/runtime/internal/routes/openapi.mjs

@@ -3,98 +3,92 @@ import { joinURL } from "ufo";
 import { defu } from "defu";
 import { handlersMeta } from "#nitro-internal-virtual/routing-meta";
 import { useRuntimeConfig } from "../runtime-config.mjs";
+// Served as /_openapi.json
 export default defineHandler((event) => {
-  const runtimeConfig = useRuntimeConfig();
-  const base = runtimeConfig.app?.baseURL;
-  const url = joinURL(getRequestURL(event).origin, base);
-  const meta = {
-    title: "Nitro Server Routes",
-    ...runtimeConfig.nitro?.openAPI?.meta
-  };
-  const {
-    paths,
-    globals: { components, ...globalsRest }
-  } = getHandlersMeta();
-  const extensible = Object.fromEntries(
-    Object.entries(globalsRest).filter(([key]) => key.startsWith("x-"))
-  );
-  return {
-    openapi: "3.1.0",
-    info: {
-      title: meta?.title,
-      version: meta?.version,
-      description: meta?.description
-    },
-    servers: [
-      {
-        url,
-        description: "Local Development Server",
-        variables: {}
-      }
-    ],
-    paths,
-    components,
-    ...extensible
-  };
+	const runtimeConfig = useRuntimeConfig();
+	const base = runtimeConfig.app?.baseURL;
+	const url = joinURL(getRequestURL(event).origin, base);
+	const meta = {
+		title: "Nitro Server Routes",
+		...runtimeConfig.nitro?.openAPI?.meta
+	};
+	const { paths, globals: { components,...globalsRest } } = getHandlersMeta();
+	const extensible = Object.fromEntries(Object.entries(globalsRest).filter(([key]) => key.startsWith("x-")));
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: meta?.title,
+			version: meta?.version || "1.0.0",
+			description: meta?.description
+		},
+		servers: [{
+			url,
+			description: "Local Development Server",
+			variables: {}
+		}],
+		paths,
+		components,
+		...extensible
+	};
 });
 function getHandlersMeta() {
-  const paths = {};
-  let globals = {};
-  for (const h of handlersMeta) {
-    const { route, parameters } = normalizeRoute(h.route || "");
-    const tags = defaultTags(h.route || "");
-    const method = (h.method || "get").toLowerCase();
-    const { $global, ...openAPI } = h.meta?.openAPI || {};
-    const item = {
-      [method]: {
-        tags,
-        parameters,
-        responses: {
-          200: { description: "OK" }
-        },
-        ...openAPI
-      }
-    };
-    if ($global) {
-      globals = defu($global, globals);
-    }
-    if (paths[route] === void 0) {
-      paths[route] = item;
-    } else {
-      Object.assign(paths[route], item);
-    }
-  }
-  return { paths, globals };
+	const paths = {};
+	let globals = {};
+	for (const h of handlersMeta) {
+		const { route, parameters } = normalizeRoute(h.route || "");
+		const tags = defaultTags(h.route || "");
+		const method = (h.method || "get").toLowerCase();
+		const { $global,...openAPI } = h.meta?.openAPI || {};
+		const item = { [method]: {
+			tags,
+			parameters,
+			responses: { 200: { description: "OK" } },
+			...openAPI
+		} };
+		if ($global) {
+			// TODO: Warn on conflicting global definitions?
+			globals = defu($global, globals);
+		}
+		if (paths[route] === undefined) {
+			paths[route] = item;
+		} else {
+			Object.assign(paths[route], item);
+		}
+	}
+	return {
+		paths,
+		globals
+	};
 }
 function normalizeRoute(_route) {
-  const parameters = [];
-  let anonymousCtr = 0;
-  const route = _route.replace(/:(\w+)/g, (_, name) => `{${name}}`).replace(/\/(\*)\//g, () => `/{param${++anonymousCtr}}/`).replace(/\*\*{/, "{").replace(/\/(\*\*)$/g, () => `/{*param${++anonymousCtr}}`);
-  const paramMatches = route.matchAll(/{(\*?\w+)}/g);
-  for (const match of paramMatches) {
-    const name = match[1];
-    if (!parameters.some((p) => p.name === name)) {
-      parameters.push({
-        name,
-        in: "path",
-        required: true,
-        schema: { type: "string" }
-      });
-    }
-  }
-  return {
-    route,
-    parameters
-  };
+	const parameters = [];
+	let anonymousCtr = 0;
+	const route = _route.replace(/:(\w+)/g, (_, name) => `{${name}}`).replace(/\/(\*)\//g, () => `/{param${++anonymousCtr}}/`).replace(/\*\*{/, "{").replace(/\/(\*\*)$/g, () => `/{*param${++anonymousCtr}}`);
+	const paramMatches = route.matchAll(/{(\*?\w+)}/g);
+	for (const match of paramMatches) {
+		const name = match[1];
+		if (!parameters.some((p) => p.name === name)) {
+			parameters.push({
+				name,
+				in: "path",
+				required: true,
+				schema: { type: "string" }
+			});
+		}
+	}
+	return {
+		route,
+		parameters
+	};
 }
 function defaultTags(route) {
-  const tags = [];
-  if (route.startsWith("/api/")) {
-    tags.push("API Routes");
-  } else if (route.startsWith("/_")) {
-    tags.push("Internal");
-  } else {
-    tags.push("App Routes");
-  }
-  return tags;
+	const tags = [];
+	if (route.startsWith("/api/")) {
+		tags.push("API Routes");
+	} else if (route.startsWith("/_")) {
+		tags.push("Internal");
+	} else {
+		tags.push("App Routes");
+	}
+	return tags;
 }

package/dist/runtime/internal/routes/renderer-template.d.mts

@@ -1,2 +1,2 @@
 import type { H3Event } from "h3";
-export default function renderIndexHTML(event: H3Event): any;
+export default function renderIndexHTML(event: H3Event);

package/dist/runtime/internal/routes/renderer-template.dev.d.mts

@@ -1,3 +1,2 @@
 import type { H3Event } from "h3";
-import { HTTPResponse } from "h3";
-export default function renderIndexHTML(event: H3Event): Promise<Response | HTTPResponse>;
+export default function renderIndexHTML(event: H3Event);

package/dist/runtime/internal/routes/renderer-template.dev.mjs

@@ -1,21 +1,19 @@
-import {
-  rendererTemplate,
-  rendererTemplateFile
-} from "#nitro-internal-virtual/renderer-template";
+import { serverFetch } from "../app.mjs";
+import { rendererTemplate, rendererTemplateFile, isStaticTemplate } from "#nitro-internal-virtual/renderer-template";
 import { HTTPResponse } from "h3";
 import { hasTemplateSyntax, renderToResponse, compileTemplate } from "rendu";
 export default async function renderIndexHTML(event) {
-  let html = await rendererTemplate(event.req);
-  if (globalThis.__transform_html__) {
-    html = await globalThis.__transform_html__(html);
-  }
-  if (!hasTemplateSyntax(html)) {
-    return new HTTPResponse(html, {
-      headers: { "content-type": "text/html; charset=utf-8" }
-    });
-  }
-  const template = compileTemplate(html, { filename: rendererTemplateFile });
-  return renderToResponse(template, {
-    request: event.req
-  });
+	let html = await rendererTemplate(event.req);
+	if (globalThis.__transform_html__) {
+		html = await globalThis.__transform_html__(html);
+	}
+	const isStatic = isStaticTemplate ?? !hasTemplateSyntax(html);
+	if (isStatic) {
+		return new HTTPResponse(html, { headers: { "content-type": "text/html; charset=utf-8" } });
+	}
+	const template = compileTemplate(html, { filename: rendererTemplateFile });
+	return renderToResponse(template, {
+		request: event.req,
+		context: { serverFetch }
+	});
 }

package/dist/runtime/internal/routes/renderer-template.mjs

@@ -1,4 +1,4 @@
 import { rendererTemplate } from "#nitro-internal-virtual/renderer-template";
 export default function renderIndexHTML(event) {
-  return rendererTemplate(event.req);
+	return rendererTemplate(event.req);
 }

package/dist/runtime/internal/routes/scalar.d.mts

@@ -1,3 +1,4 @@
 import { type EventHandler } from "h3";
+// Served as /_scalar
 declare const _default: EventHandler;
 export default _default;

package/dist/runtime/internal/routes/scalar.mjs

@@ -1,21 +1,24 @@
 import { defineHandler } from "h3";
 import { useRuntimeConfig } from "../runtime-config.mjs";
+// Served as /_scalar
 export default defineHandler((event) => {
-  const runtimeConfig = useRuntimeConfig();
-  const title = runtimeConfig.nitro.openAPI?.meta?.title || "API Reference";
-  const description = runtimeConfig.nitro.openAPI?.meta?.description || "";
-  const openAPIEndpoint = runtimeConfig.nitro.openAPI?.route || "./_openapi.json";
-  const _config = runtimeConfig.nitro.openAPI?.ui?.scalar;
-  const scalarConfig = {
-    ..._config,
-    url: openAPIEndpoint,
-    // @ts-expect-error (missing types?)
-    spec: { url: openAPIEndpoint, ..._config?.spec }
-  };
-  event.res.headers.set("Content-Type", "text/html");
-  return (
-    /* html */
-    `<!doctype html>
+	const runtimeConfig = useRuntimeConfig();
+	const title = runtimeConfig.nitro.openAPI?.meta?.title || "API Reference";
+	const description = runtimeConfig.nitro.openAPI?.meta?.description || "";
+	const openAPIEndpoint = runtimeConfig.nitro.openAPI?.route || "./_openapi.json";
+	// https://github.com/scalar/scalar
+	const _config = runtimeConfig.nitro.openAPI?.ui?.scalar;
+	const scalarConfig = {
+		..._config,
+		url: openAPIEndpoint,
+		spec: {
+			url: openAPIEndpoint,
+			..._config?.spec
+		}
+	};
+	// The default page title
+	event.res.headers.set("Content-Type", "text/html");
+	return `<!doctype html>
     <html lang="en">
       <head>
         <meta charset="utf-8" />
@@ -29,16 +32,13 @@ export default defineHandler((event) => {
       <body>
         <script
           id="api-reference"
-          data-configuration="${JSON.stringify(scalarConfig).split('"').join("&quot;")}"
+          data-configuration="${JSON.stringify(scalarConfig).split("\"").join("&quot;")}"
         ><\/script>
         <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"><\/script>
       </body>
-    </html>`
-  );
+    </html>`;
 });
-const customTheme = (
-  /* css */
-  `/* basic theme */
+const customTheme = `/* basic theme */
   .light-mode,
   .light-mode .dark-mode {
     --theme-background-1: #fff;
@@ -190,5 +190,4 @@ const customTheme = (
   }
   .section-container:nth-of-type(2) {
     overflow: hidden;
-  }`
-);
+  }`;

package/dist/runtime/internal/routes/swagger.d.mts

@@ -1,3 +1,4 @@
 import type { EventHandler } from "h3";
+// https://github.com/swagger-api/swagger-ui
 declare const _default: EventHandler;
 export default _default;

package/dist/runtime/internal/routes/swagger.mjs

@@ -1,15 +1,14 @@
 import { defineHandler } from "h3";
 import { useRuntimeConfig } from "../runtime-config.mjs";
+// https://github.com/swagger-api/swagger-ui
 export default defineHandler((event) => {
-  const runtimeConfig = useRuntimeConfig();
-  const title = runtimeConfig.nitro.openAPI?.meta?.title || "API Reference";
-  const description = runtimeConfig.nitro.openAPI?.meta?.description || "";
-  const openAPIEndpoint = runtimeConfig.nitro.openAPI?.route || "./_openapi.json";
-  const CDN_BASE = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@^5";
-  event.res.headers.set("Content-Type", "text/html");
-  return (
-    /* html */
-    `<!doctype html>
+	const runtimeConfig = useRuntimeConfig();
+	const title = runtimeConfig.nitro.openAPI?.meta?.title || "API Reference";
+	const description = runtimeConfig.nitro.openAPI?.meta?.description || "";
+	const openAPIEndpoint = runtimeConfig.nitro.openAPI?.route || "./_openapi.json";
+	const CDN_BASE = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@^5";
+	event.res.headers.set("Content-Type", "text/html");
+	return `<!doctype html>
     <html lang="en">
       <head>
         <meta charset="utf-8" />
@@ -39,6 +38,5 @@ export default defineHandler((event) => {
           };
         <\/script>
       </body>
-    </html> `
-  );
+    </html> `;
 });

package/dist/runtime/internal/runtime-config.d.mts

@@ -1,9 +1,9 @@
 import type { NitroRuntimeConfig } from "nitro/types";
 export declare function useRuntimeConfig(): NitroRuntimeConfig;
 type EnvOptions = {
-    prefix?: string;
-    altPrefix?: string;
-    envExpansion?: boolean;
+	prefix?: string;
+	altPrefix?: string;
+	envExpansion?: boolean;
 };
-export declare function applyEnv(obj: Record<string, any>, opts: EnvOptions, parentKey?: string): Record<string, any>;
+export declare function applyEnv(obj: Record<string, any>, opts: EnvOptions, parentKey?: string);
 export {};

package/dist/runtime/internal/runtime-config.mjs

@@ -1,49 +1,54 @@
+import { runtimeConfig } from "#nitro-internal-virtual/runtime-config";
 import { snakeCase } from "scule";
 export function useRuntimeConfig() {
-  return useRuntimeConfig._cached ||= getRuntimeConfig();
+	return useRuntimeConfig._cached ||= getRuntimeConfig();
 }
 function getRuntimeConfig() {
-  const runtimeConfig = globalThis.__NITRO_RUNTIME_CONFIG__ || process.env.RUNTIME_CONFIG || {};
-  const env = globalThis.process?.env || {};
-  applyEnv(runtimeConfig, {
-    prefix: "NITRO_",
-    altPrefix: runtimeConfig.nitro?.envPrefix ?? env?.NITRO_ENV_PREFIX ?? "_",
-    envExpansion: runtimeConfig.nitro?.envExpansion ?? env?.NITRO_ENV_EXPANSION ?? false
-  });
-  return runtimeConfig;
+	const env = globalThis.process?.env || {};
+	applyEnv(runtimeConfig, {
+		prefix: "NITRO_",
+		altPrefix: runtimeConfig.nitro?.envPrefix ?? env?.NITRO_ENV_PREFIX ?? "_",
+		envExpansion: Boolean(runtimeConfig.nitro?.envExpansion ?? env?.NITRO_ENV_EXPANSION ?? false)
+	});
+	return runtimeConfig;
 }
 function getEnv(key, opts) {
-  const envKey = snakeCase(key).toUpperCase();
-  return process.env[opts.prefix + envKey] ?? process.env[opts.altPrefix + envKey];
+	const envKey = snakeCase(key).toUpperCase();
+	return process.env[opts.prefix + envKey] ?? process.env[opts.altPrefix + envKey];
 }
 function _isObject(input) {
-  return typeof input === "object" && !Array.isArray(input);
+	return typeof input === "object" && !Array.isArray(input);
 }
 export function applyEnv(obj, opts, parentKey = "") {
-  for (const key in obj) {
-    const subKey = parentKey ? `${parentKey}_${key}` : key;
-    const envValue = getEnv(subKey, opts);
-    if (_isObject(obj[key])) {
-      if (_isObject(envValue)) {
-        obj[key] = { ...obj[key], ...envValue };
-        applyEnv(obj[key], opts, subKey);
-      } else if (envValue === void 0) {
-        applyEnv(obj[key], opts, subKey);
-      } else {
-        obj[key] = envValue ?? obj[key];
-      }
-    } else {
-      obj[key] = envValue ?? obj[key];
-    }
-    if (opts.envExpansion && typeof obj[key] === "string") {
-      obj[key] = _expandFromEnv(obj[key]);
-    }
-  }
-  return obj;
+	for (const key in obj) {
+		const subKey = parentKey ? `${parentKey}_${key}` : key;
+		const envValue = getEnv(subKey, opts);
+		if (_isObject(obj[key])) {
+			// Same as before
+			if (_isObject(envValue)) {
+				obj[key] = {
+					...obj[key],
+					...envValue
+				};
+				applyEnv(obj[key], opts, subKey);
+			} else if (envValue === undefined) {
+				applyEnv(obj[key], opts, subKey);
+			} else {
+				obj[key] = envValue ?? obj[key];
+			}
+		} else {
+			obj[key] = envValue ?? obj[key];
+		}
+		// Experimental env expansion
+		if (opts.envExpansion && typeof obj[key] === "string") {
+			obj[key] = _expandFromEnv(obj[key]);
+		}
+	}
+	return obj;
 }
 const envExpandRx = /\{\{([^{}]*)\}\}/g;
 function _expandFromEnv(value) {
-  return value.replace(envExpandRx, (match, key) => {
-    return process.env[key] || match;
-  });
+	return value.replace(envExpandRx, (match, key) => {
+		return process.env[key] || match;
+	});
 }

package/dist/runtime/internal/static.mjs

@@ -1,77 +1,66 @@
 import { HTTPError, defineHandler } from "h3";
-import {
-  decodePath,
-  joinURL,
-  withLeadingSlash,
-  withoutTrailingSlash
-} from "ufo";
-import {
-  getAsset,
-  isPublicAssetURL,
-  readAsset
-} from "#nitro-internal-virtual/public-assets";
-const METHODS = /* @__PURE__ */ new Set(["HEAD", "GET"]);
-const EncodingMap = { gzip: ".gz", br: ".br" };
+import { decodePath, joinURL, withLeadingSlash, withoutTrailingSlash } from "ufo";
+import { getAsset, isPublicAssetURL, readAsset } from "#nitro-internal-virtual/public-assets";
+const METHODS = new Set(["HEAD", "GET"]);
+const EncodingMap = {
+	gzip: ".gz",
+	br: ".br"
+};
 export default defineHandler((event) => {
-  if (event.req.method && !METHODS.has(event.req.method)) {
-    return;
-  }
-  let id = decodePath(
-    withLeadingSlash(withoutTrailingSlash(event.url.pathname))
-  );
-  let asset;
-  const encodingHeader = event.req.headers.get("accept-encoding") || "";
-  const encodings = [
-    ...encodingHeader.split(",").map((e) => EncodingMap[e.trim()]).filter(Boolean).sort(),
-    ""
-  ];
-  if (encodings.length > 1) {
-    event.res.headers.append("Vary", "Accept-Encoding");
-  }
-  for (const encoding of encodings) {
-    for (const _id of [id + encoding, joinURL(id, "index.html" + encoding)]) {
-      const _asset = getAsset(_id);
-      if (_asset) {
-        asset = _asset;
-        id = _id;
-        break;
-      }
-    }
-  }
-  if (!asset) {
-    if (isPublicAssetURL(id)) {
-      event.res.headers.delete("Cache-Control");
-      throw new HTTPError({ status: 404 });
-    }
-    return;
-  }
-  const ifNotMatch = event.req.headers.get("if-none-match") === asset.etag;
-  if (ifNotMatch) {
-    event.res.status = 304;
-    event.res.statusText = "Not Modified";
-    return "";
-  }
-  const ifModifiedSinceH = event.req.headers.get("if-modified-since");
-  const mtimeDate = new Date(asset.mtime);
-  if (ifModifiedSinceH && asset.mtime && new Date(ifModifiedSinceH) >= mtimeDate) {
-    event.res.status = 304;
-    event.res.statusText = "Not Modified";
-    return "";
-  }
-  if (asset.type) {
-    event.res.headers.set("Content-Type", asset.type);
-  }
-  if (asset.etag && !event.res.headers.has("ETag")) {
-    event.res.headers.set("ETag", asset.etag);
-  }
-  if (asset.mtime && !event.res.headers.has("Last-Modified")) {
-    event.res.headers.set("Last-Modified", mtimeDate.toUTCString());
-  }
-  if (asset.encoding && !event.res.headers.has("Content-Encoding")) {
-    event.res.headers.set("Content-Encoding", asset.encoding);
-  }
-  if (asset.size > 0 && !event.res.headers.has("Content-Length")) {
-    event.res.headers.set("Content-Length", asset.size.toString());
-  }
-  return readAsset(id);
+	if (event.req.method && !METHODS.has(event.req.method)) {
+		return;
+	}
+	let id = decodePath(withLeadingSlash(withoutTrailingSlash(event.url.pathname)));
+	let asset;
+	const encodingHeader = event.req.headers.get("accept-encoding") || "";
+	const encodings = [...encodingHeader.split(",").map((e) => EncodingMap[e.trim()]).filter(Boolean).sort(), ""];
+	if (encodings.length > 1) {
+		event.res.headers.append("Vary", "Accept-Encoding");
+	}
+	for (const encoding of encodings) {
+		for (const _id of [id + encoding, joinURL(id, "index.html" + encoding)]) {
+			const _asset = getAsset(_id);
+			if (_asset) {
+				asset = _asset;
+				id = _id;
+				break;
+			}
+		}
+	}
+	if (!asset) {
+		if (isPublicAssetURL(id)) {
+			event.res.headers.delete("Cache-Control");
+			throw new HTTPError({ status: 404 });
+		}
+		return;
+	}
+	const ifNotMatch = event.req.headers.get("if-none-match") === asset.etag;
+	if (ifNotMatch) {
+		event.res.status = 304;
+		event.res.statusText = "Not Modified";
+		return "";
+	}
+	const ifModifiedSinceH = event.req.headers.get("if-modified-since");
+	const mtimeDate = new Date(asset.mtime);
+	if (ifModifiedSinceH && asset.mtime && new Date(ifModifiedSinceH) >= mtimeDate) {
+		event.res.status = 304;
+		event.res.statusText = "Not Modified";
+		return "";
+	}
+	if (asset.type) {
+		event.res.headers.set("Content-Type", asset.type);
+	}
+	if (asset.etag && !event.res.headers.has("ETag")) {
+		event.res.headers.set("ETag", asset.etag);
+	}
+	if (asset.mtime && !event.res.headers.has("Last-Modified")) {
+		event.res.headers.set("Last-Modified", mtimeDate.toUTCString());
+	}
+	if (asset.encoding && !event.res.headers.has("Content-Encoding")) {
+		event.res.headers.set("Content-Encoding", asset.encoding);
+	}
+	if (asset.size > 0 && !event.res.headers.has("Content-Length")) {
+		event.res.headers.set("Content-Length", asset.size.toString());
+	}
+	return readAsset(id);
 });

package/dist/runtime/internal/storage.mjs

@@ -1,6 +1,6 @@
 import { prefixStorage } from "unstorage";
 import { initStorage } from "#nitro-internal-virtual/storage";
 export function useStorage(base = "") {
-  const storage = useStorage._storage ??= initStorage();
-  return base ? prefixStorage(storage, base) : storage;
+	const storage = useStorage._storage ??= initStorage();
+	return base ? prefixStorage(storage, base) : storage;
 }

package/dist/runtime/internal/task.d.mts

@@ -2,16 +2,16 @@ import type { Task, TaskContext, TaskPayload, TaskResult } from "nitro/types";
 /** @experimental */
 export declare function defineTask<RT = unknown>(def: Task<RT>): Task<RT>;
 /** @experimental */
-export declare function runTask<RT = unknown>(name: string, { payload, context, }?: {
-    payload?: TaskPayload;
-    context?: TaskContext;
+export declare function runTask<RT = unknown>(name: string, { payload, context }?: {
+	payload?: TaskPayload;
+	context?: TaskContext;
 }): Promise<TaskResult<RT>>;
 /** @experimental */
-export declare function startScheduleRunner(): void;
+export declare function startScheduleRunner();
 /** @experimental */
 export declare function getCronTasks(cron: string): string[];
 /** @experimental */
 export declare function runCronTasks(cron: string, ctx: {
-    payload?: TaskPayload;
-    context?: TaskContext;
+	payload?: TaskPayload;
+	context?: TaskContext;
 }): Promise<TaskResult[]>;