@b9g/shovel 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2023 Brian Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/bin/shovel.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node --experimental-vm-modules --experimental-fetch --no-warnings
+import * as Path from "path";
+import * as FS from "fs/promises";
+import {createServer} from "http";
+import * as VM from "vm";
+import {pathToFileURL} from "url";
+import {parseArgs} from "@pkgjs/parseargs";
+import * as ESBuild from "esbuild";
+import {SourceMapConsumer} from "source-map";
+import MagicString from "magic-string";
+import StackTracey from "stacktracey";
+import resolve from "../resolve.js";
+
+// TODO: replace with yargs or commander
+const {values, positionals} = parseArgs({
+	allowPositionals: true,
+	options: {
+		port: {
+			type: "string",
+		},
+	},
+});
+
+const path = Path.resolve(positionals[0] || "");
+const cwd = process.cwd();
+const port = parseInt(values["port"] || "1337");
+
+let sourceMapConsumer;
+let namespace;
+const plugin = {
+	name: "loader",
+	setup(build) {
+		// TODO: correct filters
+		build.onLoad({filter: /\.(js|ts|jsx|tsx)$/}, async (args) => {
+			let code = await FS.readFile(args.path, "utf8");
+			const magicString = new MagicString(code);
+			magicString.prepend(
+				`import.meta.url = "${pathToFileURL(args.path).href}";`,
+			);
+
+			code = magicString.toString();
+			const map = magicString.generateMap({
+				file: args.path,
+				source: args.path,
+				hires: true,
+				includeContent: true,
+			});
+
+			code = code + "\n//# sourceMappingURL=" + map.toUrl();
+			return {
+				contents: code,
+				loader: Path.extname(args.path).slice(1),
+			};
+		});
+
+		// TODO: Error handling
+		build.onEnd(async (result) => {
+			const url = pathToFileURL(build.initialOptions.entryPoints[0]).href;
+			console.log("built:", url);
+			// TODO: handle build errors
+			if (result.errors && result.errors.length) {
+				const formatted = await ESBuild.formatMessages(result.errors, {
+					kind: "error",
+					color: true,
+				});
+				console.error(formatted.join("\n"));
+				return;
+			}
+
+			const code = result.outputFiles.find((file) => file.path.endsWith(".js"))?.text;
+			const map = result.outputFiles.find((file) => file.path.endsWith(".map"))?.text;
+			if (map) {
+				sourceMapConsumer = await new SourceMapConsumer(map);
+			}
+
+			const module = new VM.SourceTextModule(code, {
+				identifier: url,
+			});
+
+			await module.link(async (specifier) => {
+				const resolved = await resolve(specifier, cwd);
+				try {
+					const child = await import(resolved);
+					const exports = Object.keys(child);
+					return new VM.SyntheticModule(
+						exports,
+						function () {
+							for (const key of exports) {
+								this.setExport(key, child[key]);
+							}
+						},
+					);
+				} catch (err) {
+					// TODO: Log a message
+					console.error("await import threw", err);
+					return new VM.SyntheticModule([], function () {});
+				}
+			});
+
+			try {
+				await module.evaluate();
+			} catch (err) {
+				if (sourceMapConsumer) {
+					fixStack(err, sourceMapConsumer);
+				}
+
+				console.error(err);
+				return;
+			}
+
+			namespace?.default?.cleanup?.();
+			namespace = module.namespace;
+		});
+	},
+};
+
+function fixStack(err, sourceMapConsumer) {
+	let [message, ...lines] = err.stack.split("\n");
+	lines = lines.map((line, i) => {
+		// parse the stack trace line
+		return line.replace(new RegExp(`${path}:(\\d+):(\\d+)`), (match, line, column) => {
+			const pos = sourceMapConsumer.originalPositionFor({
+				line: parseInt(line),
+				column: parseInt(column),
+			});
+
+			const source = pos.source ? Path.resolve(
+				Path.dirname(path),
+				pos.source
+			) : url;
+			return `${source}:${pos.line}:${pos.column}`;
+		});
+	});
+	err.stack = [message, ...lines].join("\n");
+}
+
+const ctx = await ESBuild.context({
+	format: "esm",
+	platform: "node",
+	absWorkingDir: cwd,
+	entryPoints: [path],
+	bundle: true,
+	metafile: true,
+	write: false,
+	packages: "external",
+	sourcemap: "both",
+	plugins: [plugin],
+	outdir: cwd,
+	logLevel: "silent",
+});
+
+await ctx.watch();
+
+function readableStreamFromMessage(req) {
+	return new ReadableStream({
+		start(controller) {
+			req.on("data", (chunk) => {
+				controller.enqueue(chunk);
+			});
+
+			req.on("end", () => {
+				controller.close();
+			});
+		},
+
+		cancel() {
+			req.destroy();
+		},
+	});
+}
+
+async function webRequestFromNode(req) {
+	const url = new URL(req.url || "/", "http://" + req.headers.host);
+	const headers = new Headers();
+	for (const key in req.headers) {
+		if (req.headers[key]) {
+			headers.append(key, req.headers[key]);
+		}
+	}
+
+	return new Request(url, {
+		method: req.method,
+		headers,
+		body: req.method === "GET" || req.method === "HEAD" ? undefined : readableStreamFromMessage(req),
+	});
+}
+
+async function callNodeResponse(res, webRes) {
+	const headers = {};
+	webRes.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	res.writeHead(webRes.status, headers);
+	// TODO: stream the body
+	res.end(await webRes.text());
+}
+
+const server = createServer(async (req, res) => {
+	const webReq = await webRequestFromNode(req);
+	if (typeof namespace?.default?.fetch === "function") {
+		let webRes;
+		try {
+			webRes = await namespace?.default?.fetch(webReq);
+		} catch (err)	{
+			console.error(err);
+			res.writeHead(500);
+			res.end();
+			return;
+		}
+
+		callNodeResponse(res, webRes);
+	} else {
+		res.write("waiting for namespace to be set");
+		res.end();
+	}
+});
+
+console.log("listening on port:", port);
+server.listen(port);
+
+process.on("uncaughtException", (err) => {
+	if (sourceMapConsumer) {
+		fixStack(err, sourceMapConsumer);
+	}
+
+	console.error(err);
+});
+
+process.on("unhandledRejection", (err) => {
+	if (sourceMapConsumer) {
+		fixStack(err, sourceMapConsumer);
+	}
+
+	console.error(err);
+});

package/noop.ts

@@ -0,0 +1,8 @@
+function thrower(): never {
+	console.log("hi");
+	throw new Error("This is an error");
+}
+
+export default function noop() {
+	thrower();
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+	"name": "@b9g/shovel",
+	"version": "0.1.0",
+	"type": "module",
+	"description": "Dig for treasure",
+	"scripts": {
+		"test": "echo \"Error: no test specified\" && exit 1"
+	},
+	"license": "MIT",
+	"dependencies": {
+		"@b9g/crank": "^0.5.3",
+		"@pkgjs/parseargs": "^0.11.0",
+		"chokidar": "^3.5.3",
+		"esbuild": "^0.17.11",
+		"is-core-module": "^2.11.0",
+		"magic-string": "^0.30.0",
+		"resolve.exports": "^2.0.1",
+		"source-map": "^0.7.4"
+	},
+	"bin": {
+		"shovel": "bin/shovel.js"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/poop.ts

@@ -0,0 +1,13 @@
+import {jsx} from "@b9g/crank/standalone";
+import {renderer} from "@b9g/crank/html";
+import noop from "./noop.ts";
+
+export default {
+	fetch(req: Request) {
+		console.log("serving:", req.url);
+		const html = renderer.render(jsx`<div>Hello from Crank</div>`);
+		return new Response(html, {
+			headers: {"content-type": "text/html; charset=UTF-8"},
+		});
+	}
+};

package/resolve.js

@@ -0,0 +1,197 @@
+// Adapted from https://github.com/browserify/resolve because the original code
+// was truly ass and didn't support ES modules.
+// TODO: Support ES modules, clean up, double check it works according to the node resolution algorithm.
+// MIT License
+// Copyright (c) 2012 James Halliday
+import * as FS from "fs/promises";
+import * as Path from "path";
+import isCore from 'is-core-module';
+
+function nodeModulesPaths(start) {
+	let prefix = '/';
+	if ((/^([A-Za-z]:)/).test(start)) {
+		prefix = '';
+	} else if ((/^\\\\/).test(start)) {
+		prefix = '\\\\';
+	}
+
+	const paths = [start];
+	let parsed = Path.parse(start);
+	while (parsed.dir !== paths[paths.length - 1]) {
+		paths.push(parsed.dir);
+		parsed = Path.parse(parsed.dir);
+	}
+
+	return paths.reduce(function (dirs, aPath) {
+		return dirs.concat([Path.resolve(prefix, aPath, "node_modules")]);
+	}, []);
+}
+
+async function isFile(file) {
+	let stat;
+	try {
+		stat = await FS.stat(file);
+	} catch (err) {
+		if (err.code === 'ENOENT' || err.code === 'ENOTDIR') {
+			return false;
+		}
+
+		throw err;
+	}
+
+	return stat.isFile() || stat.isFIFO();
+}
+
+async function isDirectory(dir) {
+	let stat;
+	try {
+		stat = await FS.stat(dir);
+	} catch (err) {
+		if (err.code === 'ENOENT' || err.code === 'ENOTDIR') {
+			return false;
+		}
+
+		throw err;
+	}
+
+	return stat.isDirectory();
+}
+
+const localRealpath =
+	process.platform !== 'win32' && FS.realpath && typeof FS.realpath.native === 'function'
+		? FS.realpath.native
+		: FS.realpath;
+async function realpath(x) {
+	try {
+		return await localRealpath(x);
+	} catch (err) {
+		if (err.code === 'ENOENT') {
+			return x;
+		}
+
+		throw err;
+	}
+}
+
+function maybeRealpath(realpath, x, opts) {
+	if (!opts || !opts.preserveSymlinks) {
+		return realpath(x);
+	} else {
+		return x;
+	}
+}
+
+async function readPackage(pkgfile) {
+	const body = await FS.readFile(pkgfile);
+	return JSON.parse(body);
+}
+
+function getPackageCandidates(x, start) {
+	const dirs = nodeModulesPaths(start);
+	for (let i = 0; i < dirs.length; i++) {
+		dirs[i] = Path.join(dirs[i], x);
+	}
+
+	return dirs;
+}
+
+async function loadAsFile(x) {
+	const extensions = ["", ".js"];
+	for (const ext of extensions) {
+		const file = x + ext;
+		if (await isFile(file)) {
+			return file;
+		}
+	}
+
+	return x;
+}
+
+async function loadpkg(dir) {
+	if (dir === '' || dir === '/') {
+		return null;
+	}
+
+	if (process.platform === 'win32' && (/^\w:[/\\]*$/).test(dir)) {
+		return null;
+	}
+
+	if ((/[/\\]node_modules[/\\]*$/).test(dir)) {
+		return null;
+	}
+
+	dir = await maybeRealpath(realpath, dir);
+	const pkgfile = Path.join(dir, 'package.json');
+	if (!await isFile(pkgfile)) {
+		return loadpkg(Path.dirname(dir));
+	}
+
+	return await readPackage(pkgfile);
+}
+
+async function loadAsDirectory(x) {
+	let pkgdir;
+	try { 
+		pkgdir = await maybeRealpath(realpath, x);
+	} catch (err) {
+		throw err;
+	}
+
+	const pkgfile = Path.join(pkgdir, 'package.json');
+	if (!await isFile(pkgfile)) {
+		return loadAsFile(Path.join(x, '/index'));
+	}
+
+	const pkg = await readPackage(pkgfile);
+	if (pkg && pkg.main) {
+		return loadAsFile(Path.join(x, pkg.main));
+	} else if (pkg && pkg.module) {
+		return loadAsFile(Path.join(x, pkg.module));
+	}
+
+	return loadAsFile(Path.join(x, '/index'));
+}
+
+async function processDirs(dirs) {
+	for (const dir of dirs) {
+		if (await isDirectory(dir)) {
+			return loadAsDirectory(dir);
+		}
+
+		const result = await loadAsFile(dir);
+		if (result) {
+			return result;
+		}
+	}
+}
+
+async function loadNodeModules(x, start) {
+	const dirs = getPackageCandidates(x, start);
+	return processDirs(dirs) || x;
+}
+
+export default async function resolve(specifier, basedir) {
+	if (typeof specifier !== 'string') {
+		throw new TypeError('specifier must be a string');
+	}
+
+	// ensure that `basedir` is an absolute path at this point, resolving against the process' current working directory
+	let absoluteStart = Path.resolve(basedir);
+
+	absoluteStart = await maybeRealpath(
+		realpath,
+		absoluteStart,
+	);
+
+	if (!isDirectory(absoluteStart)) {
+		throw new Error(`Cannot resolve ${basedir} to a directory`);
+	}
+
+	if (isCore(specifier)) {
+		return specifier;
+	} else if ((/^(?:\.\.?(?:\/|$)|\/|([A-Za-z]:)?[/\\])/).test(specifier)) {
+		throw new Error("This shouldn't happen");
+	}
+
+	return loadNodeModules(specifier, basedir);
+}