import { DEV } from 'esm-env'; import { json, text } from '../../exports/index.js'; import { coalesce_to_error, get_message, get_status } from '../../utils/error.js'; import { negotiate } from '../../utils/http.js'; import { HttpError } from '../control.js'; import { fix_stack_trace } from '../shared-server.js'; import { ENDPOINT_METHODS } from '../../constants.js'; import { escape_html } from '../../utils/escape.js'; import { with_event } from '../app/server/event.js'; /** @param {any} body */ export function is_pojo(body) { if (typeof body !== 'object') return false; if (body) { if (body instanceof Uint8Array) return false; if (body instanceof ReadableStream) return false; } return true; } /** * @param {Partial>} mod * @param {import('types').HttpMethod} method */ export function method_not_allowed(mod, method) { return text(`${method} method not allowed`, { status: 405, headers: { // https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/405 // "The server must generate an Allow header field in a 405 status code response" allow: allowed_methods(mod).join(', ') } }); } /** @param {Partial>} mod */ export function allowed_methods(mod) { const allowed = ENDPOINT_METHODS.filter((method) => method in mod); if ('GET' in mod || 'HEAD' in mod) allowed.push('HEAD'); return allowed; } /** * Return as a response that renders the error.html * * @param {import('types').SSROptions} options * @param {number} status * @param {string} message */ export function static_error_page(options, status, message) { let page = options.templates.error({ status, message: escape_html(message) }); if (DEV) { // inject Vite HMR client, for easier debugging page = page.replace('', ''); } return text(page, { headers: { 'content-type': 'text/html; charset=utf-8' }, status }); } /** * @param {import('@sveltejs/kit').RequestEvent} event * @param {import('types').SSROptions} options * @param {unknown} error */ export async function handle_fatal_error(event, options, error) { error = error instanceof HttpError ? error : coalesce_to_error(error); const status = get_status(error); const body = await handle_error_and_jsonify(event, options, error); // ideally we'd use sec-fetch-dest instead, but Safari — quelle surprise — doesn't support it const type = negotiate(event.request.headers.get('accept') || 'text/html', [ 'application/json', 'text/html' ]); if (event.isDataRequest || type === 'application/json') { return json(body, { status }); } return static_error_page(options, status, body.message); } /** * @param {import('@sveltejs/kit').RequestEvent} event * @param {import('types').SSROptions} options * @param {any} error * @returns {Promise} */ export async function handle_error_and_jsonify(event, options, error) { if (error instanceof HttpError) { return error.body; } if (__SVELTEKIT_DEV__ && typeof error == 'object') { fix_stack_trace(error); } const status = get_status(error); const message = get_message(error); return ( (await with_event(event, () => options.hooks.handleError({ error, event, status, message }) )) ?? { message } ); } /** * @param {number} status * @param {string} location */ export function redirect_response(status, location) { const response = new Response(undefined, { status, headers: { location } }); return response; } /** * @param {import('@sveltejs/kit').RequestEvent} event * @param {Error & { path: string }} error */ export function clarify_devalue_error(event, error) { if (error.path) { return `Data returned from \`load\` while rendering ${event.route.id} is not serializable: ${error.message} (${error.path})`; } if (error.path === '') { return `Data returned from \`load\` while rendering ${event.route.id} is not a plain object`; } // belt and braces — this should never happen return error.message; } /** * @param {import('types').ServerDataNode} node */ export function serialize_uses(node) { const uses = {}; if (node.uses && node.uses.dependencies.size > 0) { uses.dependencies = Array.from(node.uses.dependencies); } if (node.uses && node.uses.search_params.size > 0) { uses.search_params = Array.from(node.uses.search_params); } if (node.uses && node.uses.params.size > 0) { uses.params = Array.from(node.uses.params); } if (node.uses?.parent) uses.parent = 1; if (node.uses?.route) uses.route = 1; if (node.uses?.url) uses.url = 1; return uses; } /** * Returns `true` if the given path was prerendered * @param {import('@sveltejs/kit').SSRManifest} manifest * @param {string} pathname Should include the base and be decoded */ export function has_prerendered_path(manifest, pathname) { return ( manifest._.prerendered_routes.has(pathname) || (pathname.at(-1) === '/' && manifest._.prerendered_routes.has(pathname.slice(0, -1))) ); }