feat: init

This commit is contained in:
2026-02-13 22:02:30 +01:00
commit 8f9ff830fb
16711 changed files with 3307340 additions and 0 deletions

View File

@@ -0,0 +1,3 @@
import type { NitroErrorHandler } from "nitropack/types";
declare const _default: NitroErrorHandler;
export default _default;

View File

@@ -0,0 +1,77 @@
import { joinURL, withQuery, withoutBase } from "ufo";
import { appendResponseHeader, getRequestHeaders, send, setResponseHeader, setResponseHeaders, setResponseStatus } from "h3";
import { useNitroApp, useRuntimeConfig } from "nitropack/runtime";
import { isJsonRequest } from "../utils/error.mjs";
import { generateErrorOverlayHTML } from "../utils/dev.mjs";
export default (async function errorhandler(error, event, { defaultHandler }) {
if (event.handled || isJsonRequest(event)) {
// let Nitro handle JSON errors
return;
}
// invoke default Nitro error handler (which will log appropriately if required)
const defaultRes = await defaultHandler(error, event, { json: true });
// let Nitro handle redirect if appropriate
const status = error.status || error.statusCode || 500;
if (status === 404 && defaultRes.status === 302) {
setResponseHeaders(event, defaultRes.headers);
setResponseStatus(event, defaultRes.status, defaultRes.statusText);
return send(event, JSON.stringify(defaultRes.body, null, 2));
}
if (import.meta.dev && typeof defaultRes.body !== "string" && Array.isArray(defaultRes.body.stack)) {
// normalize to string format expected by nuxt `error.vue`
defaultRes.body.stack = defaultRes.body.stack.join("\n");
}
const errorObject = defaultRes.body;
// remove proto/hostname/port from URL
const url = new URL(errorObject.url);
errorObject.url = withoutBase(url.pathname, useRuntimeConfig(event).app.baseURL) + url.search + url.hash;
// add default server message (keep sanitized for unhandled errors)
errorObject.message = error.unhandled ? errorObject.message || "Server Error" : error.message || errorObject.message || "Server Error";
// we will be rendering this error internally so we can pass along the error.data safely
errorObject.data ||= error.data;
errorObject.statusText ||= error.statusText || error.statusMessage;
delete defaultRes.headers["content-type"];
delete defaultRes.headers["content-security-policy"];
setResponseHeaders(event, defaultRes.headers);
// Access request headers
const reqHeaders = getRequestHeaders(event);
// Detect to avoid recursion in SSR rendering of errors
const isRenderingError = event.path.startsWith("/__nuxt_error") || !!reqHeaders["x-nuxt-error"];
// HTML response (via SSR)
const res = isRenderingError ? null : await useNitroApp().localFetch(withQuery(joinURL(useRuntimeConfig(event).app.baseURL, "/__nuxt_error"), errorObject), {
headers: {
...reqHeaders,
"x-nuxt-error": "true"
},
redirect: "manual"
}).catch(() => null);
if (event.handled) {
return;
}
// Fallback to static rendered error page
if (!res) {
const { template } = await import("../templates/error-500");
if (import.meta.dev) {
// TODO: Support `message` in template
errorObject.description = errorObject.message;
}
setResponseHeader(event, "Content-Type", "text/html;charset=UTF-8");
return send(event, template(errorObject));
}
const html = await res.text();
for (const [header, value] of res.headers.entries()) {
if (header === "set-cookie") {
appendResponseHeader(event, header, value);
continue;
}
setResponseHeader(event, header, value);
}
setResponseStatus(event, res.status && res.status !== 200 ? res.status : defaultRes.status, res.statusText || defaultRes.statusText);
if (import.meta.dev && !import.meta.test && typeof html === "string") {
const prettyResponse = await defaultHandler(error, event, { json: false });
if (typeof prettyResponse.body === "string") {
return send(event, html.replace("</body>", `${generateErrorOverlayHTML(prettyResponse.body, { startMinimized: 300 <= status && status < 500 })}</body>`));
}
}
return send(event, html);
});

View File

@@ -0,0 +1,2 @@
declare const _default;
export default _default;

View File

@@ -0,0 +1,120 @@
import { useNitroApp } from "nitropack/runtime";
import { destr } from "destr";
import { defineEventHandler, getQuery, readBody, setResponseHeaders } from "h3";
import { resolveUnrefHeadInput } from "@unhead/vue";
import { getRequestDependencies } from "vue-bundle-renderer/runtime";
import { getQuery as getURLQuery } from "ufo";
import { islandCache, islandPropCache } from "../utils/cache.mjs";
import { createSSRContext } from "../utils/renderer/app.mjs";
import { getSSRRenderer } from "../utils/renderer/build-files.mjs";
import { renderInlineStyles } from "../utils/renderer/inline-styles.mjs";
import { getClientIslandResponse, getServerComponentHTML, getSlotIslandResponse } from "../utils/renderer/islands.mjs";
const ISLAND_SUFFIX_RE = /\.json(?:\?.*)?$/;
export default defineEventHandler(async (event) => {
const nitroApp = useNitroApp();
setResponseHeaders(event, {
"content-type": "application/json;charset=utf-8",
"x-powered-by": "Nuxt"
});
if (import.meta.prerender && event.path && await islandCache.hasItem(event.path)) {
return islandCache.getItem(event.path);
}
const islandContext = await getIslandContext(event);
const ssrContext = {
...createSSRContext(event),
islandContext,
noSSR: false,
url: islandContext.url
};
// Render app
const renderer = await getSSRRenderer();
const renderResult = await renderer.renderToString(ssrContext).catch(async (err) => {
await ssrContext.nuxt?.hooks.callHook("app:error", err);
throw err;
});
// Handle errors
if (ssrContext.payload?.error) {
throw ssrContext.payload.error;
}
const inlinedStyles = await renderInlineStyles(ssrContext.modules ?? []);
await ssrContext.nuxt?.hooks.callHook("app:rendered", {
ssrContext,
renderResult
});
if (inlinedStyles.length) {
ssrContext.head.push({ style: inlinedStyles });
}
if (import.meta.dev) {
const { styles } = getRequestDependencies(ssrContext, renderer.rendererContext);
const link = [];
for (const resource of Object.values(styles)) {
// Do not add links to resources that are inlined (vite v5+)
if ("inline" in getURLQuery(resource.file)) {
continue;
}
// Add CSS links in <head> for CSS files
// - in dev mode when rendering an island and the file has scoped styles and is not a page
if (resource.file.includes("scoped") && !resource.file.includes("pages/")) {
link.push({
rel: "stylesheet",
href: renderer.rendererContext.buildAssetsURL(resource.file),
crossorigin: ""
});
}
}
if (link.length) {
ssrContext.head.push({ link }, { mode: "server" });
}
}
const islandHead = {};
for (const entry of ssrContext.head.entries.values()) {
// eslint-disable-next-line @typescript-eslint/no-deprecated
for (const [key, value] of Object.entries(resolveUnrefHeadInput(entry.input))) {
const currentValue = islandHead[key];
if (Array.isArray(currentValue)) {
currentValue.push(...value);
} else {
islandHead[key] = value;
}
}
}
const islandResponse = {
id: islandContext.id,
head: islandHead,
html: getServerComponentHTML(renderResult.html),
components: getClientIslandResponse(ssrContext),
slots: getSlotIslandResponse(ssrContext)
};
await nitroApp.hooks.callHook("render:island", islandResponse, {
event,
islandContext
});
if (import.meta.prerender) {
await islandCache.setItem(`/__nuxt_island/${islandContext.name}_${islandContext.id}.json`, islandResponse);
await islandPropCache.setItem(`/__nuxt_island/${islandContext.name}_${islandContext.id}.json`, event.path);
}
return islandResponse;
});
async function getIslandContext(event) {
// TODO: Strict validation for url
let url = event.path || "";
if (import.meta.prerender && event.path && await islandPropCache.hasItem(event.path)) {
// rehydrate props from cache so we can rerender island if cache does not have it any more
url = await islandPropCache.getItem(event.path);
}
const componentParts = url.substring("/__nuxt_island".length + 1).replace(ISLAND_SUFFIX_RE, "").split("_");
const hashId = componentParts.length > 1 ? componentParts.pop() : undefined;
const componentName = componentParts.join("_");
// TODO: Validate context
const context = event.method === "GET" ? getQuery(event) : await readBody(event);
const ctx = {
url: "/",
...context,
id: hashId,
name: componentName,
props: destr(context.props) || {},
slots: {},
components: {}
};
return ctx;
}

View File

@@ -0,0 +1,2 @@
declare const _default;
export default _default;

View File

@@ -0,0 +1,305 @@
import { AsyncLocalStorage } from "node:async_hooks";
import { getPrefetchLinks, getPreloadLinks, getRequestDependencies, renderResourceHeaders } from "vue-bundle-renderer/runtime";
import { appendResponseHeader, createError, getQuery, getResponseStatus, getResponseStatusText, writeEarlyHints } from "h3";
import { getQuery as getURLQuery, joinURL } from "ufo";
import { propsToString, renderSSRHead } from "@unhead/vue/server";
import destr from "destr";
import { defineRenderHandler, getRouteRules, useNitroApp } from "nitropack/runtime";
import { getRenderer } from "../utils/renderer/build-files.mjs";
import { payloadCache } from "../utils/cache.mjs";
import { renderPayloadJsonScript, renderPayloadResponse, renderPayloadScript, splitPayload } from "../utils/renderer/payload.mjs";
import { createSSRContext, setSSRError } from "../utils/renderer/app.mjs";
import { renderInlineStyles } from "../utils/renderer/inline-styles.mjs";
import { replaceIslandTeleports } from "../utils/renderer/islands.mjs";
// @ts-expect-error virtual file
import { renderSSRHeadOptions } from "#internal/unhead.config.mjs";
// @ts-expect-error virtual file
import { NUXT_ASYNC_CONTEXT, NUXT_EARLY_HINTS, NUXT_INLINE_STYLES, NUXT_JSON_PAYLOADS, NUXT_NO_SCRIPTS, NUXT_PAYLOAD_EXTRACTION, NUXT_RUNTIME_PAYLOAD_EXTRACTION, PARSE_ERROR_DATA } from "#internal/nuxt/nitro-config.mjs";
// @ts-expect-error virtual file
import { appHead, appTeleportAttrs, appTeleportTag, componentIslands, appManifest as isAppManifestEnabled } from "#internal/nuxt.config.mjs";
// @ts-expect-error virtual file
import entryIds from "#internal/nuxt/entry-ids.mjs";
// @ts-expect-error virtual file
import { entryFileName } from "#internal/entry-chunk.mjs";
// @ts-expect-error virtual file
import { buildAssetsURL, publicAssetsURL } from "#internal/nuxt/paths";
import { relative } from "pathe";
// @ts-expect-error private property consumed by vite-generated url helpers
globalThis.__buildAssetsURL = buildAssetsURL;
// @ts-expect-error private property consumed by vite-generated url helpers
globalThis.__publicAssetsURL = publicAssetsURL;
// Polyfill for unctx (https://github.com/unjs/unctx#native-async-context)
if (NUXT_ASYNC_CONTEXT && !("AsyncLocalStorage" in globalThis)) {
globalThis.AsyncLocalStorage = AsyncLocalStorage;
}
const HAS_APP_TELEPORTS = !!(appTeleportTag && appTeleportAttrs.id);
const APP_TELEPORT_OPEN_TAG = HAS_APP_TELEPORTS ? `<${appTeleportTag}${propsToString(appTeleportAttrs)}>` : "";
const APP_TELEPORT_CLOSE_TAG = HAS_APP_TELEPORTS ? `</${appTeleportTag}>` : "";
const PAYLOAD_URL_RE = NUXT_JSON_PAYLOADS ? /^[^?]*\/_payload.json(?:\?.*)?$/ : /^[^?]*\/_payload.js(?:\?.*)?$/;
const PAYLOAD_FILENAME = NUXT_JSON_PAYLOADS ? "_payload.json" : "_payload.js";
let entryPath;
export default defineRenderHandler(async (event) => {
const nitroApp = useNitroApp();
// Whether we're rendering an error page
const ssrError = event.path.startsWith("/__nuxt_error") ? getQuery(event) : null;
if (ssrError && !("__unenv__" in event.node.req)) {
throw createError({
status: 404,
statusText: "Page Not Found: /__nuxt_error",
message: "Page Not Found: /__nuxt_error"
});
}
// Initialize ssr context
const ssrContext = createSSRContext(event);
// needed for hash hydration plugin to work
const headEntryOptions = { mode: "server" };
ssrContext.head.push(appHead, headEntryOptions);
if (ssrError) {
// eslint-disable-next-line @typescript-eslint/no-deprecated
const status = ssrError.status || ssrError.statusCode;
if (status) {
// eslint-disable-next-line @typescript-eslint/no-deprecated
ssrError.status = ssrError.statusCode = Number.parseInt(status);
}
if (PARSE_ERROR_DATA && typeof ssrError.data === "string") {
try {
ssrError.data = destr(ssrError.data);
} catch {}
}
setSSRError(ssrContext, ssrError);
}
// Get route options (for `ssr: false`, `isr`, `cache` and `noScripts`)
const routeOptions = getRouteRules(event);
// Whether we are prerendering route or using ISR/SWR caching
const _PAYLOAD_EXTRACTION = !ssrContext.noSSR && (import.meta.prerender && NUXT_PAYLOAD_EXTRACTION || NUXT_RUNTIME_PAYLOAD_EXTRACTION && (routeOptions.isr || routeOptions.cache));
const isRenderingPayload = (_PAYLOAD_EXTRACTION || import.meta.dev && routeOptions.prerender) && PAYLOAD_URL_RE.test(ssrContext.url);
if (isRenderingPayload) {
const url = ssrContext.url.substring(0, ssrContext.url.lastIndexOf("/")) || "/";
ssrContext.url = url;
event._path = event.node.req.url = url;
if (import.meta.prerender && await payloadCache.hasItem(url)) {
return payloadCache.getItem(url);
}
}
if (routeOptions.ssr === false) {
ssrContext.noSSR = true;
}
const payloadURL = _PAYLOAD_EXTRACTION ? joinURL(ssrContext.runtimeConfig.app.cdnURL || ssrContext.runtimeConfig.app.baseURL, ssrContext.url.replace(/\?.*$/, ""), PAYLOAD_FILENAME) + "?" + ssrContext.runtimeConfig.app.buildId : undefined;
// Render app
const renderer = await getRenderer(ssrContext);
// Render 103 Early Hints
if (NUXT_EARLY_HINTS && !isRenderingPayload && !import.meta.prerender) {
const { link } = renderResourceHeaders({}, renderer.rendererContext);
if (link) {
writeEarlyHints(event, link);
}
}
if (NUXT_INLINE_STYLES) {
for (const id of entryIds) {
ssrContext.modules.add(id);
}
}
const _rendered = await renderer.renderToString(ssrContext).catch(async (error) => {
// We use error to bypass full render if we have an early response we can make
// TODO: remove _renderResponse in nuxt v5
if ((ssrContext["~renderResponse"] || ssrContext._renderResponse) && error.message === "skipping render") {
return {};
}
// Use explicitly thrown error in preference to subsequent rendering errors
const _err = !ssrError && ssrContext.payload?.error || error;
await ssrContext.nuxt?.hooks.callHook("app:error", _err);
throw _err;
});
// Render inline styles
// TODO: remove _renderResponse in nuxt v5
const inlinedStyles = NUXT_INLINE_STYLES && !ssrContext["~renderResponse"] && !ssrContext._renderResponse && !isRenderingPayload ? await renderInlineStyles(ssrContext.modules ?? []) : [];
await ssrContext.nuxt?.hooks.callHook("app:rendered", {
ssrContext,
renderResult: _rendered
});
if (ssrContext["~renderResponse"] || ssrContext._renderResponse) {
// TODO: remove _renderResponse in nuxt v5
return ssrContext["~renderResponse"] || ssrContext._renderResponse;
}
// Handle errors
if (ssrContext.payload?.error && !ssrError) {
throw ssrContext.payload.error;
}
// Directly render payload routes
if (isRenderingPayload) {
const response = renderPayloadResponse(ssrContext);
if (import.meta.prerender) {
await payloadCache.setItem(ssrContext.url, response);
}
return response;
}
if (_PAYLOAD_EXTRACTION && import.meta.prerender) {
// Hint nitro to prerender payload for this route
appendResponseHeader(event, "x-nitro-prerender", joinURL(ssrContext.url.replace(/\?.*$/, ""), PAYLOAD_FILENAME));
// Use same ssr context to generate payload for this route
await payloadCache.setItem(ssrContext.url === "/" ? "/" : ssrContext.url.replace(/\/$/, ""), renderPayloadResponse(ssrContext));
}
const NO_SCRIPTS = NUXT_NO_SCRIPTS || routeOptions.noScripts;
// Setup head
const { styles, scripts } = getRequestDependencies(ssrContext, renderer.rendererContext);
// 0. Add import map for stable chunk hashes
if (entryFileName && !NO_SCRIPTS) {
let path = entryPath;
if (!path) {
path = buildAssetsURL(entryFileName);
if (ssrContext.runtimeConfig.app.cdnURL || /^(?:\/|\.+\/)/.test(path)) {
// cache absolute entry path
entryPath = path;
} else {
// TODO: provide support for relative paths in assets as well
// relativise path
path = relative(event.path.replace(/\/[^/]+$/, "/"), joinURL("/", path));
if (!/^(?:\/|\.+\/)/.test(path)) {
path = `./${path}`;
}
}
}
ssrContext.head.push({ script: [{
tagPosition: "head",
tagPriority: -2,
type: "importmap",
innerHTML: JSON.stringify({ imports: { "#entry": path } })
}] }, headEntryOptions);
}
// 1. Preload payloads and app manifest
if (_PAYLOAD_EXTRACTION && !NO_SCRIPTS) {
ssrContext.head.push({ link: [NUXT_JSON_PAYLOADS ? {
rel: "preload",
as: "fetch",
crossorigin: "anonymous",
href: payloadURL
} : {
rel: "modulepreload",
crossorigin: "",
href: payloadURL
}] }, headEntryOptions);
}
if (isAppManifestEnabled && ssrContext["~preloadManifest"] && !NO_SCRIPTS) {
ssrContext.head.push({ link: [{
rel: "preload",
as: "fetch",
fetchpriority: "low",
crossorigin: "anonymous",
href: buildAssetsURL(`builds/meta/${ssrContext.runtimeConfig.app.buildId}.json`)
}] }, {
...headEntryOptions,
tagPriority: "low"
});
}
// 2. Styles
if (inlinedStyles.length) {
ssrContext.head.push({ style: inlinedStyles });
}
const link = [];
for (const resource of Object.values(styles)) {
// Do not add links to resources that are inlined (vite v5+)
if (import.meta.dev && "inline" in getURLQuery(resource.file)) {
continue;
}
// Add CSS links in <head> for CSS files
// - in production
// - in dev mode when not rendering an island
link.push({
rel: "stylesheet",
href: renderer.rendererContext.buildAssetsURL(resource.file),
crossorigin: ""
});
}
if (link.length) {
ssrContext.head.push({ link }, headEntryOptions);
}
if (!NO_SCRIPTS) {
// 4. Resource Hints
// Remove lazy hydrated modules from ssrContext.modules so they don't get preloaded
// (CSS links are already added above, this only affects JS preloads)
if (ssrContext["~lazyHydratedModules"]) {
for (const id of ssrContext["~lazyHydratedModules"]) {
ssrContext.modules?.delete(id);
}
}
ssrContext.head.push({ link: getPreloadLinks(ssrContext, renderer.rendererContext) }, headEntryOptions);
ssrContext.head.push({ link: getPrefetchLinks(ssrContext, renderer.rendererContext) }, headEntryOptions);
// 5. Payloads
ssrContext.head.push({ script: _PAYLOAD_EXTRACTION ? NUXT_JSON_PAYLOADS ? renderPayloadJsonScript({
ssrContext,
data: splitPayload(ssrContext).initial,
src: payloadURL
}) : renderPayloadScript({
ssrContext,
data: splitPayload(ssrContext).initial,
routeOptions,
src: payloadURL
}) : NUXT_JSON_PAYLOADS ? renderPayloadJsonScript({
ssrContext,
data: ssrContext.payload
}) : renderPayloadScript({
ssrContext,
data: ssrContext.payload,
routeOptions
}) }, {
...headEntryOptions,
tagPosition: "bodyClose",
tagPriority: "high"
});
}
// 6. Scripts
if (!routeOptions.noScripts) {
const tagPosition = _PAYLOAD_EXTRACTION && !NUXT_JSON_PAYLOADS ? "bodyClose" : "head";
ssrContext.head.push({ script: Object.values(scripts).map((resource) => ({
type: resource.module ? "module" : null,
src: renderer.rendererContext.buildAssetsURL(resource.file),
defer: resource.module ? null : true,
tagPosition,
crossorigin: ""
})) }, headEntryOptions);
}
const { headTags, bodyTags, bodyTagsOpen, htmlAttrs, bodyAttrs } = await renderSSRHead(ssrContext.head, renderSSRHeadOptions);
// Create render context
const htmlContext = {
htmlAttrs: htmlAttrs ? [htmlAttrs] : [],
head: normalizeChunks([headTags]),
bodyAttrs: bodyAttrs ? [bodyAttrs] : [],
bodyPrepend: normalizeChunks([bodyTagsOpen, ssrContext.teleports?.body]),
body: [componentIslands ? replaceIslandTeleports(ssrContext, _rendered.html) : _rendered.html, APP_TELEPORT_OPEN_TAG + (HAS_APP_TELEPORTS ? joinTags([ssrContext.teleports?.[`#${appTeleportAttrs.id}`]]) : "") + APP_TELEPORT_CLOSE_TAG],
bodyAppend: [bodyTags]
};
// Allow hooking into the rendered result
await nitroApp.hooks.callHook("render:html", htmlContext, { event });
// Construct HTML response
return {
body: renderHTMLDocument(htmlContext),
statusCode: getResponseStatus(event),
statusMessage: getResponseStatusText(event),
headers: {
"content-type": "text/html;charset=utf-8",
"x-powered-by": "Nuxt"
}
};
});
function normalizeChunks(chunks) {
const result = [];
for (const _chunk of chunks) {
const chunk = _chunk?.trim();
if (chunk) {
result.push(chunk);
}
}
return result;
}
function joinTags(tags) {
return tags.join("");
}
function joinAttrs(chunks) {
if (chunks.length === 0) {
return "";
}
return " " + chunks.join(" ");
}
function renderHTMLDocument(html) {
return "<!DOCTYPE html>" + `<html${joinAttrs(html.htmlAttrs)}>` + `<head>${joinTags(html.head)}</head>` + `<body${joinAttrs(html.bodyAttrs)}>${joinTags(html.bodyPrepend)}${joinTags(html.body)}${joinTags(html.bodyAppend)}</body>` + "</html>";
}