@torpor/build 0.4.8 → 0.4.10

package/src/response/serverError.ts

@@ -1,24 +0,0 @@
-import response from "./response";
-
-/**
- * 500 Server Error
- *
- * The HTTP 500 Internal Server Error server error response status code
- * indicates that the server encountered an unexpected condition that prevented
- * it from fulfilling the request. This error is a generic "catch-all" response
- * to server issues, indicating that the server cannot find a more appropriate
- * 5XX error to respond with.
- *
- * If you're a visitor seeing 500 errors on a web page, these issues require
- * investigation by server owners or administrators. There are many possible
- * causes of 500 errors, including: improper server configuration, out-of-memory
- * (OOM) issues, unhandled exceptions, improper file permissions, or other
- * complex factors. Server administrators may proactively log occurrences of
- * server error responses, like the 500 status code, with details about the
- * initiating requests to improve the stability of a service in the future.
- *
- * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/500
- */
-export default function serverError(body?: object | string): Response {
-	return response(500, body ?? "Server error");
-}

package/src/response/temporaryRedirect.ts

@@ -1,31 +0,0 @@
-import transfer from "./transfer";
-
-/**
- * 307 Temporary Redirect
- *
- * The HTTP 307 Temporary Redirect redirection response status code indicates
- * that the resource requested has been temporarily moved to the URL in the
- * Location header.
- *
- * A browser receiving this status will automatically request the resource at
- * the URL in the Location header, redirecting the user to the new page. Search
- * engines receiving this response will not attribute links to the original URL
- * to the new resource, meaning no SEO value is transferred to the new URL.
- *
- * The method and the body of the original request are reused to perform the
- * redirected request. In the cases where you want the request method to be
- * changed to GET, use 303 See Other instead. This is useful when you want to
- * give an answer to a successful PUT request that is not the uploaded resource,
- * but a status monitor or confirmation message like "You have successfully
- * uploaded XYZ".
- *
- * The difference between 307 and 302 is that 307 guarantees that the client
- * will not change the request method and body when the redirected request is
- * made. With 302, older clients incorrectly changed the method to GET. 307 and
- * 302 responses are identical when the request method is GET.
- *
- * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/307
- */
-export default function temporaryRedirect(location: string): Response {
-	return transfer(307, location);
-}

package/src/response/transfer.ts

@@ -1,14 +0,0 @@
-/**
- * Creates a redirect response with the supplied status code.
- */
-export default function transfer(
-	status: 300 | 301 | 302 | 303 | 304 | 307 | 308,
-	location: string,
-): Response {
-	return new Response(null, {
-		status,
-		headers: {
-			location,
-		},
-	});
-}

package/src/response/unauthorized.ts

@@ -1,21 +0,0 @@
-import response from "./response";
-
-/**
- * 401 Unauthorized
- *
- * The HTTP 401 Unauthorized client error response status code indicates that a
- * request was not successful because it lacks valid authentication credentials
- * for the requested resource. This status code is sent with an HTTP
- * WWW-Authenticate response header that contains information on the
- * authentication scheme the server expects the client to include to make the
- * request successfully.
- *
- * A 401 Unauthorized is similar to the 403 Forbidden response, except that a
- * 403 is returned when a request contains valid credentials, but the client
- * does not have permissions to perform a certain action.
- *
- * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/401
- */
-export default function unauthorized(body?: object | string): Response {
-	return response(401, body ?? "Unauthorized");
-}

package/src/response/unprocessable.ts

@@ -1,18 +0,0 @@
-import response from "./response";
-
-/**
- * 422 Unprocessable Content
- *
- * The HTTP 422 Unprocessable Content client error response status code
- * indicates that the server understood the content type of the request content,
- * and the syntax of the request content was correct, but it was unable to
- * process the contained instructions.
- *
- * Clients that receive a 422 response should expect that repeating the request
- * without modification will fail with the same error.
- *
- * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/422
- */
-export default function unprocessable(body?: object | string): Response {
-	return response(422, body ?? "Unprocessable");
-}

package/src/response.ts

@@ -1,37 +0,0 @@
-import badRequest from "./response/badRequest";
-import created from "./response/created";
-import forbidden from "./response/forbidden";
-import found from "./response/found";
-import methodNotAllowed from "./response/methodNotAllowed";
-import movedPermanently from "./response/movedPermanently";
-import notFound from "./response/notFound";
-import notModified from "./response/notModified";
-import ok from "./response/ok";
-import permanentRedirect from "./response/permanentRedirect";
-import response from "./response/response";
-import seeOther from "./response/seeOther";
-import serverError from "./response/serverError";
-import temporaryRedirect from "./response/temporaryRedirect";
-import transfer from "./response/transfer";
-import unauthorized from "./response/unauthorized";
-import unprocessable from "./response/unprocessable";
-
-export {
-	response,
-	ok,
-	created,
-	transfer,
-	movedPermanently,
-	found,
-	seeOther,
-	notModified,
-	temporaryRedirect,
-	permanentRedirect,
-	badRequest,
-	unauthorized,
-	forbidden,
-	notFound,
-	methodNotAllowed,
-	unprocessable,
-	serverError,
-};

package/src/run/prepareTemplate.ts

@@ -1,39 +0,0 @@
-export default function prepareTemplate(
-	template: string,
-	clientScript: string,
-	clientDevScript?: string,
-): string {
-	let result = template;
-
-	// Put %COMPONENT_HEAD% before </head>
-	// This is where styles will go
-	let headStart = result.indexOf("</head>");
-	if (headStart === -1) {
-		throw new Error(`Couldn't find <head> end tag`);
-	}
-	result = result.substring(0, headStart) + "%COMPONENT_HEAD%" + result.substring(headStart);
-
-	// Put %COMPONENT_BODY% inside <div id="app"></div>
-	// This is where the component's HTML will go
-	let bodyStart = regexIndexOf(result, /<div\s+id=("app"|'app'|app)\s+/);
-	bodyStart = result.indexOf(">", bodyStart) + 1;
-	let bodyEnd = result.indexOf("</div>", bodyStart);
-	if (bodyStart === -1 || bodyEnd === -1) {
-		throw new Error(`Couldn't find <div id="app"></div>`);
-	}
-	result = result.substring(0, bodyStart) + "%COMPONENT_BODY%" + result.substring(bodyEnd);
-
-	// Add the clientEntry script at the very end, for hydrating and navigating
-	if (clientDevScript) {
-		result += `<script type="module" src="${clientDevScript}"></script>`;
-	}
-	result += `<script type="module" src="${clientScript}"></script>`;
-
-	return result;
-}
-
-// From https://stackoverflow.com/a/274094
-function regexIndexOf(string: string, regex: RegExp, position?: number) {
-	var indexOf = string.substring(position || 0).search(regex);
-	return indexOf >= 0 ? indexOf + (position || 0) : indexOf;
-}

package/src/run/run.ts

@@ -1,62 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { transformWithEsbuild } from "vite";
-import Site from "../site/Site";
-import runBuild from "./runBuild";
-import runDev from "./runDev";
-import runPreview from "./runPreview";
-
-export default async function run(
-	folder: string,
-	mode: "dev" | "build" | "preview",
-): Promise<void> {
-	// Look for and load a site.config.js/ts file in the working directory
-	let configFile = "";
-	let deleteConfigFile = false;
-	const jsConfigFile = path.join(folder, "site.config.js");
-	const tsConfigFile = path.join(folder, "site.config.ts");
-	if (fs.existsSync(jsConfigFile)) {
-		// If it's JS, we can just import it straight up
-		configFile = jsConfigFile;
-	} else if (fs.existsSync(tsConfigFile)) {
-		// If it's TS, we need to convert it to JS
-		// TODO: Put the generated file somewhere better (dist?)
-		configFile = path.join(folder, "site.config.temp.js");
-		let source = fs.readFileSync(tsConfigFile, "utf-8");
-		let transformed = await transformWithEsbuild(source, tsConfigFile, {
-			loader: "ts",
-		});
-		fs.writeFileSync(configFile, transformed.code);
-		deleteConfigFile = true;
-	} else {
-		throw new Error("site.config file not found");
-	}
-
-	const site = (await import(configFile)).default as Site;
-	if (!site || !site.root || !site.routes) {
-		throw new Error("Invalid site in config file");
-	}
-	if (deleteConfigFile) {
-		fs.rmSync(configFile);
-	}
-
-	switch (mode) {
-		case "dev": {
-			await runDev(site);
-			break;
-		}
-		case "build": {
-			await runBuild(site);
-			break;
-		}
-		case "preview": {
-			await runPreview(site);
-			break;
-		}
-		default: {
-			console.log("No mode passed, running in dev");
-			await runDev(site);
-			break;
-		}
-	}
-}

package/src/run/runBuild.ts

@@ -1,77 +0,0 @@
-import torpor from "@torpor/unplugin/vite";
-import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
-import { build, defineConfig } from "vite";
-import Site from "../site/Site";
-import manifest from "../site/manifest.ts";
-
-// TODO: Don't cache index.html in dev?
-// TODO: Multiple hook.server locations
-// TODO: Don't reload layouts during client routing
-// TODO: Call the correct +page and +server routes when in the same folder
-
-export default async function runBuild(site: Site): Promise<void> {
-	// Delete the dist folder if it exists
-	const distFolder = path.resolve(site.root, "dist");
-	if (existsSync(distFolder)) {
-		await fs.rm(distFolder, { recursive: true });
-	}
-	const clientFolder = path.join(distFolder, "client");
-	const serverFolder = path.join(distFolder, "server");
-
-	// HOOK: Prebuild
-	if (site.adapter.prebuild) {
-		await site.adapter.prebuild(site);
-	}
-
-	// TODO: From a setting
-	let siteHtml = path.resolve(site.root, "src/site.html");
-
-	const siteFolder = path.resolve(site.root, "./node_modules/@torpor/build/src/site/");
-	let clientScript = path.join(siteFolder, "clientEntry.ts");
-	let serverScript = path.join(siteFolder, "serverEntry.ts");
-
-	// Build the client assets, including site.html and the route files
-	// EXCLUDING anything with `server.js` in the name
-	const clientConfig = structuredClone(site.viteConfig ?? {});
-	clientConfig.plugins = [manifest(site), torpor(), ...site.plugins];
-	clientConfig.build ??= {};
-	clientConfig.build.outDir = clientFolder;
-	clientConfig.build.rollupOptions ??= {};
-	clientConfig.build.rollupOptions.input = [
-		siteHtml,
-		clientScript,
-		...site.routes
-			.filter((r) => !/server\.(ts|js)$/.test(r.file))
-			.map((r) => path.resolve(site.root, r.file)),
-		...site.inputs.filter((f) => !/server\.(ts|js)$/.test(f)),
-	];
-	clientConfig.build.ssrManifest = true;
-	await build(defineConfig(clientConfig));
-
-	// Build the server assets, including the server entry script and the route
-	// files
-	const serverConfig = structuredClone(site.viteConfig ?? {});
-	serverConfig.plugins = [manifest(site, true), torpor(), ...site.plugins];
-	serverConfig.build ??= {};
-	serverConfig.build.outDir = serverFolder;
-	serverConfig.build.rollupOptions ??= {};
-	serverConfig.build.rollupOptions.input = [
-		serverScript,
-		...site.routes.map((r) => path.resolve(site.root, r.file)),
-		...site.inputs,
-	];
-	serverConfig.build.ssr = serverScript;
-	await build(defineConfig(serverConfig));
-
-	// Move the site.html file into /client
-	// HACK: Should do this in Rollup if possible?
-	siteHtml = path.join(clientFolder, "site.html");
-	await fs.rename(path.join(clientFolder, "src", "site.html"), siteHtml);
-	await fs.rm(path.join(clientFolder, "src"), { recursive: true });
-
-	// HOOK: Postbuild
-	if (site.adapter.postbuild) {
-		await site.adapter.postbuild(site);
-	}
-}

package/src/run/runDev.ts

@@ -1,89 +0,0 @@
-import estorpor from "@torpor/unplugin/esbuild";
-import torpor from "@torpor/unplugin/vite";
-import { configDotenv } from "dotenv";
-import { promises as fs } from "node:fs";
-import path from "node:path";
-import { createServer as createViteServer } from "vite";
-import { serverError } from "../response.ts";
-import Server from "../server/Server.ts";
-import connectMiddleware from "../server/connect/connectMiddleware.ts";
-import Site from "../site/Site.ts";
-import manifest from "../site/manifest.ts";
-import prepareTemplate from "./prepareTemplate.ts";
-
-export default async function runDev(site: Site): Promise<void> {
-	const server = new Server();
-
-	// Create the Vite server in middleware mode and configure the app type as
-	// "custom", disabling Vite's own HTML serving logic so the parent server
-	// can take control
-	const config = structuredClone(site.viteConfig ?? {});
-	config.server = { middlewareMode: true };
-	config.appType = "custom";
-	config.plugins = [manifest(site, true), torpor({ dev: true }), ...site.plugins];
-
-	// HACK: To be able to import `.torp` files from barrel files in
-	// node_modules, we need to add their libraries to `ssr.noExternal` in
-	// site.config.ts, and let esbuild know how to compile them here
-	config.optimizeDeps ??= {};
-	config.optimizeDeps.extensions ??= [];
-	config.optimizeDeps.extensions.push(".torp");
-	config.optimizeDeps.esbuildOptions ??= {};
-	config.optimizeDeps.esbuildOptions.plugins ??= [];
-	config.optimizeDeps.esbuildOptions.plugins.push(estorpor());
-
-	const vite = await createViteServer(config);
-
-	// Read site.html
-	// It's called site.html because @torpor/build builds the site (html, routes
-	// etc) while the user builds the app (components etc)
-	const templateFile = path.resolve(site.root, "src/site.html");
-	let template = await fs.readFile(templateFile, "utf-8");
-
-	// Apply Vite HTML transforms. This injects the Vite HMR client, and also
-	// applies HTML transforms from Vite plugins. Note that we only support a
-	// universal transform, not individual transforms for each route
-	template = await vite.transformIndexHtml("", template);
-
-	const siteFolder = path.resolve(site.root, "./node_modules/@torpor/build/src/site/");
-	let clientScript = path.join(siteFolder, "clientEntry.ts");
-	let clientDevScript = path.join(siteFolder, "clientEntryDev.ts");
-	let serverScript = path.join(siteFolder, "serverEntry.ts");
-
-	// Prepare site.html so that we can just splice components into it
-	template = prepareTemplate(template, clientScript, clientDevScript);
-
-	// Use Vite's Connect instance as middleware. We need to wrap it with
-	// createMiddlewareHandler that converts Connect middleware to
-	// Request/Response web handlers
-	server.use(connectMiddleware(vite.middlewares));
-
-	// Every request (GET, POST, etc) goes through loadEndPoint
-	server.add("*", async (ev) => {
-		try {
-			// Load the server entry. ssrLoadModule automatically transforms ESM
-			// source code to be usable in Node.js. No bundling is required, and
-			// it provides efficient invalidation similar to HMR
-			const { load } = await vite.ssrLoadModule(serverScript);
-
-			// Render the app HTML (or fetch server data etc) via serverEntry's
-			// exported `load` function
-			return await load(ev, template);
-		} catch (e: any) {
-			// If an error is caught, let Vite fix the stack trace so it maps
-			// back to your actual source code
-			vite.ssrFixStacktrace(e);
-			return serverError(e);
-		}
-	});
-
-	// Load environment variables from a `.env` file, with defaults if not set
-	configDotenv();
-
-	process.env.PROTOCOL ??= "http:";
-	process.env.HOST ??= "localhost";
-	process.env.PORT ??= "7059";
-
-	// Serve the site
-	site.adapter.serve(server, site);
-}

package/src/run/runPreview.ts

@@ -1,93 +0,0 @@
-import { configDotenv } from "dotenv";
-import { existsSync, promises as fs } from "node:fs";
-import path from "node:path";
-import { serverError } from "../response.ts";
-import Server from "../server/Server.ts";
-import contentType from "../server/contentType.ts";
-import Site from "../site/Site";
-import prepareTemplate from "./prepareTemplate.ts";
-import runBuild from "./runBuild";
-
-export default async function runPreview(site: Site): Promise<void> {
-	// Build the site
-	await runBuild(site);
-
-	const distFolder = path.resolve(site.root, "dist");
-	const clientFolder = path.join(distFolder, "client");
-	const serverFolder = path.join(distFolder, "server");
-
-	// Find the client script file in /assets
-	let clientScript = (await fs.readdir(path.join(clientFolder, "assets"))).find((f) =>
-		f.startsWith("clientEntry-"),
-	);
-	if (!clientScript) {
-		throw new Error("clientEntry.js not found");
-	}
-	clientScript = `/assets/${clientScript}`;
-
-	// Read site.html
-	// It's called site.html because @torpor/build builds the site (html, routes
-	// etc) while the user builds the app (components etc)
-	let siteHtml = path.join(clientFolder, "site.html");
-	let template = await fs.readFile(siteHtml, "utf-8");
-
-	// Prepare site.html so that we can just splice components into it
-	template = prepareTemplate(template, clientScript);
-
-	// Configure the server
-	const server = new Server();
-
-	// Serve dist/client/assets statically
-	server.add("/assets/*", async (ev) => {
-		try {
-			const url = new URL(ev.request.url);
-			const file = path.join(site.root, "dist", "client", url.pathname);
-			if (existsSync(file)) {
-				// TODO: Stream the data?
-				const body = bufferToArrayBuffer(await fs.readFile(file));
-				return new Response(body, {
-					status: 200,
-					headers: {
-						"Content-Type": contentType(path.extname(file)),
-					},
-				});
-			}
-		} catch (e: any) {
-			return serverError(e);
-		}
-	});
-
-	// Every request (GET, POST, etc) goes through loadEndPoint
-	const serverScript = path.resolve(serverFolder, "serverEntry.js");
-	server.add("*", async (ev) => {
-		try {
-			// Load the server entry
-			const { load } = await import(serverScript);
-
-			// Render the app HTML (or fetch server data etc) via serverEntry's
-			// exported `load` function
-			return await load(ev, template);
-		} catch (e: any) {
-			return serverError(e);
-		}
-	});
-
-	// Load environment variables from a `.env` file, with defaults if not set
-	configDotenv();
-
-	process.env.PROTOCOL ??= "http:";
-	process.env.HOST ??= "localhost";
-	process.env.PORT ??= "7059";
-
-	// Serve the site
-	site.adapter.serve(server, site);
-}
-
-// From https://stackoverflow.com/a/79345620
-// No idea why it is needed
-function bufferToArrayBuffer(buffer: Buffer): ArrayBuffer {
-	return buffer.buffer.slice(
-		buffer.byteOffset,
-		buffer.byteOffset + buffer.byteLength,
-	) as ArrayBuffer;
-}

package/src/run.ts

@@ -1,6 +0,0 @@
-import run from "./run/run";
-import runBuild from "./run/runBuild";
-import runDev from "./run/runDev";
-import runPreview from "./run/runPreview";
-
-export { run, runDev, runBuild, runPreview };

package/src/server/CookieHelper.ts

@@ -1,36 +0,0 @@
-import { SerializeOptions, parse, serialize } from "cookie";
-
-export default class CookieHelper {
-	request: Request;
-	cookies: Map<string, string> = new Map();
-
-	constructor(request: Request) {
-		this.request = request;
-	}
-
-	get(name: string): string | undefined {
-		// If it's been set, return the value from the map
-		if (this.cookies.has(name)) {
-			return parse(this.cookies.get(name)!)[name];
-		}
-		// Otherwise, return the value from the `cookie` header
-		const header = this.request.headers.get("cookie");
-		return parse(header ?? "")[name];
-	}
-
-	set(name: string, value: string, options?: SerializeOptions): void {
-		// Set a cookie header with some default values for security
-		options ??= {};
-		options.httpOnly ??= true;
-		options.secure ??= true;
-		options.sameSite ??= "lax";
-		this.cookies.set(name, serialize(name, value, options));
-	}
-
-	delete(name: string, options?: SerializeOptions): void {
-		// Set a cookie header with an immediate expiry date
-		options ??= {};
-		options.expires = new Date(0);
-		this.cookies.set(name, serialize(name, "", options));
-	}
-}

package/src/server/HeaderHelper.ts

@@ -1,25 +0,0 @@
-export default class HeaderHelper {
-	request: Request;
-	headers: Map<string, string> = new Map();
-
-	constructor(request: Request) {
-		this.request = request;
-	}
-
-	get(name: string): string | undefined {
-		// If it's been set, return the updated value
-		if (this.headers.has(name)) {
-			return this.headers.get(name);
-		}
-		// Otherwise, return the value from the header
-		return this.request.headers.get(name) ?? undefined;
-	}
-
-	set(name: string, value: string): void {
-		this.headers.set(name, value);
-	}
-
-	delete(name: string): void {
-		this.headers.delete(name);
-	}
-}

package/src/server/Routerx.ts

@@ -1,72 +0,0 @@
-import pathToRegex from "../utils/pathToRegex";
-import type HttpMethod from "./types/HttpMethod";
-import type MiddlewareFunction from "./types/MiddlewareFunction";
-import type ServerFunction from "./types/ServerFunction";
-
-// This is not actually used anywhere, for now at least
-
-export default class Router {
-	methods: Map<HttpMethod, RouteHandler[]> = new Map<HttpMethod, RouteHandler[]>();
-	middleware: MiddlewareHandler[] = [];
-
-	constructor() {
-		// Create all method handlers up front so we don't have to worry about
-		// checking if they exist. Using a non-standard method will just error
-		this.methods.set("GET", []);
-		this.methods.set("HEAD", []);
-		this.methods.set("PATCH", []);
-		this.methods.set("POST", []);
-		this.methods.set("PUT", []);
-		this.methods.set("DELETE", []);
-		this.methods.set("OPTIONS", []);
-		this.methods.set("CONNECT", []);
-		this.methods.set("TRACE", []);
-	}
-
-	add(method: HttpMethod, path: string, fn: ServerFunction): Router {
-		this.methods.get(method)!.push(new RouteHandler(path, fn));
-		return this;
-	}
-
-	match(method: HttpMethod, path: string): Match | undefined {
-		for (let handler of this.methods.get(method)!) {
-			let match = path.match(handler.regex);
-			if (match) {
-				console.log("found", handler);
-				return {
-					fn: handler.fn,
-					params: match.groups,
-				};
-			}
-		}
-	}
-}
-
-class RouteHandler {
-	path: string;
-	regex: RegExp;
-	fn: ServerFunction;
-
-	constructor(path: string, fn: ServerFunction) {
-		this.path = path;
-		this.regex = pathToRegex(path);
-		this.fn = fn;
-	}
-}
-
-class MiddlewareHandler {
-	path: string;
-	regex: RegExp;
-	fn: MiddlewareFunction;
-
-	constructor(path: string, fn: MiddlewareFunction) {
-		this.path = path;
-		this.regex = pathToRegex(path);
-		this.fn = fn;
-	}
-}
-
-interface Match {
-	fn: ServerFunction;
-	params?: Record<string, string>;
-}