The admin socket now also speaks OCapN over Cap'n Web: a WebSocket there reaches the VatAdmin DO, an OCapN peer whose bootstrap (swissnum vatAdmin) offers createVat(src, params). params may hold remote objects; the vat's root comes back as one. Each OCapN vat is its own peer: SES and @endo/ocapn run in its facet (vat-runtime.js, bundled with esbuild), around the vat's own module, which exports buildRootObject(vatPowers, params). Passing a client's object to a vat, or a vat's root to the client, is an OCapN handoff, so the receiver dials the exporter. Nothing here can dial out, so the VatAdmin is also the router: a client registers its gateway under a designator, a vat's designator is its id, and every peer reaches every other through it. The netlayer is ertp-clerk's, made to work over Workers RPC stubs and plain promises as well as Cap'n Web. Not yet: sturdyrefs that survive a restart, an adminNode, and grants (egress, mount) for OCapN vats. App vats (export class App) still work beside them. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
52 lines
2.0 KiB
JavaScript
52 lines
2.0 KiB
JavaScript
/** @file Run real workerd processes for tests. */
|
|
import { spawn } from "node:child_process";
|
|
import { rm } from "node:fs/promises";
|
|
import { connect, createServer } from "node:net";
|
|
import { join } from "node:path";
|
|
|
|
export const here = new URL("..", import.meta.url).pathname;
|
|
// the package binary, not the .bin shim: the shim forks it, so a kill would orphan workerd
|
|
const workerd = join(here, "node_modules/workerd/bin/workerd");
|
|
|
|
export const freePort = () =>
|
|
new Promise((resolve) => {
|
|
const s = createServer().listen(0, "127.0.0.1", () => {
|
|
const { port } = s.address();
|
|
s.close(() => resolve(port));
|
|
});
|
|
});
|
|
|
|
/** Resolves once something accepts connections at `opts` (a port or a socket path). */
|
|
export const accepting = (opts) =>
|
|
new Promise((resolve) => {
|
|
const s = connect(opts, () => (s.end(), resolve(true)));
|
|
s.on("error", () => resolve(false));
|
|
});
|
|
|
|
/**
|
|
* Run workerd on `config` until `stop()`; resolves once `listening` accepts.
|
|
*
|
|
* @param {string} config
|
|
* @param {string[]} args socket, directory, and external overrides
|
|
* @param {{ port: number } | { path: string }} listening
|
|
* @param {string[]} stale socket files a crash leaves behind; bind() would fail on them
|
|
*/
|
|
export const startWorkerd = async (config, args, listening, stale = []) => {
|
|
for (const f of stale) await rm(f, { force: true });
|
|
const child = spawn(workerd, ["serve", "--experimental", join(here, config), ...args], {
|
|
stdio: ["ignore", process.env.WORKERD_LOG ? "inherit" : "ignore", "pipe"],
|
|
});
|
|
let log = "";
|
|
// WORKERD_LOG=1 echoes workerd's stderr, for debugging
|
|
child.stderr.on("data", (c) => (process.env.WORKERD_LOG ? process.stderr.write(c) : (log += c)));
|
|
const exited = new Promise((resolve) => child.on("exit", resolve));
|
|
for (let i = 0; i < 100; i++) {
|
|
// SIGKILL: a crash is the harder durability test
|
|
if (await accepting(listening)) return { stop: () => (child.kill("SIGKILL"), exited) };
|
|
await new Promise((r) => setTimeout(r, 50));
|
|
}
|
|
child.kill("SIGKILL");
|
|
throw new Error(`workerd did not start: ${log}`);
|
|
};
|
|
|