@volter/tabnode 0.2.14-volter.88

package/dist/process-tokens.d.ts

@@ -0,0 +1,77 @@
+/**
+ * A run the embedding host has named, and the registry the container answers
+ * about it from.
+ *
+ * `container.run(command, { processToken })` names one run. The `node` command
+ * records the guest process it creates under that name, for as long as the run
+ * lasts, and forgets it when the run ends. Nothing here starts or ends a
+ * program: it is the registry three doors read, and the name a server
+ * registers itself under while its run is the one launching.
+ *
+ * The name reaches the `node` command through the shell's environment, under
+ * the reserved variable below, because two runs can be in flight at once on
+ * one shell and a module-level "the current run" would answer the later one
+ * for both. The guest never sees the variable: the environment the `node`
+ * command gives its process has it removed.
+ */
+/** Whatever the embedding runtime uses to name one guest process. */
+export type ProcessToken = string;
+/** The environment variable a run's name travels in, from `exec` to `node`. */
+export declare const PROCESS_TOKEN_ENV = "__TABNODE_PROCESS_TOKEN";
+/** What the engine can answer about one named run. */
+export interface OwnedRun {
+    /** The timers the run's guest still holds, as Node's loop counts them. */
+    pendingTimers(): number;
+    /** Clear those timers, as ending the process clears them. */
+    stopTimers(): void;
+    /**
+     * Report an exception nobody caught as this run's own, the way Node's
+     * process reports one: the run's `uncaughtException` listeners, else its
+     * stderr and exit 1. False when the run no longer answers.
+     */
+    reportUncaught(error: unknown): boolean;
+}
+/** Run `fn` as this token's guest code, so the doors below name that run. */
+export declare function enterRun<T>(token: ProcessToken, fn: () => T): T;
+/**
+ * Record a named run's guest for the run's lifetime. The answer releases it;
+ * releasing twice is harmless, as a run ends once.
+ */
+export declare function __recordRun(token: ProcessToken, run: OwnedRun): () => void;
+/** The run recorded under this name, while it lasts. */
+export declare function __runFor(token: ProcessToken): OwnedRun | undefined;
+/**
+ * The run now launching a guest, for a handle or a server the guest opens
+ * after its entry has returned, when no run is the current one any more.
+ * `enterRun`'s async-local value covers the guest's own turn and everything
+ * scheduled from inside it; a listen that lands after a native `await`
+ * continuation is attributed here.
+ */
+export declare let __lastLaunchedToken: ProcessToken | null;
+export declare function __setLastLaunchedToken(token: ProcessToken | null): void;
+/** The run a guest is being launched under, where the host named one. */
+export declare function __currentProcessToken(): ProcessToken | null;
+/**
+ * End a named run's timers. The servers it owns are released by `http`'s own
+ * half, `__releaseOwnedServers`, which calls this for the timers.
+ */
+export declare function __stopOwnedProcess(token: ProcessToken): void;
+/** The next process number this engine hands out. */
+export declare function mintPid(): number;
+/** Record the numbers a named run was started with, for the run to read back. */
+export declare function setRunPid(token: ProcessToken, pid: number, ppid: number): void;
+/** The numbers a named run was started with, where one was recorded. */
+export declare function runPid(token: ProcessToken | null | undefined): {
+    pid: number;
+    ppid: number;
+} | undefined;
+/** A run that has ended is no longer a process; its number is nobody's. */
+export declare function forgetRunPid(token: ProcessToken): void;
+/** Whether a live run carries this number, which is what `kill(pid, 0)` asks. */
+export declare function pidIsLive(pid: number): boolean;
+/** The numbers a live process carries, looked up by its own pid. */
+export declare function processByPid(pid: number): {
+    pid: number;
+    ppid: number;
+} | undefined;
+//# sourceMappingURL=process-tokens.d.ts.map

package/dist/process-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tokens.d.ts","sourceRoot":"","sources":["../src/process-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,aAAa,IAAI,MAAM,CAAC;IACxB,6DAA6D;IAC7D,UAAU,IAAI,IAAI,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CACzC;AAcD,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,IAAI,CAQ1E;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,CAElE;AAED;;;;;;GAMG;AACH,eAAO,IAAI,mBAAmB,EAAE,YAAY,GAAG,IAAW,CAAC;AAC3D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAEvE;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,YAAY,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAE5D;AA2BD,qDAAqD;AACrD,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9E;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAExG;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG9C;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAGnF"}

package/dist/punycode-source.d.ts

@@ -0,0 +1,3 @@
+export declare const PUNYCODE_VERSION = "2.3.1";
+export declare const PUNYCODE_SOURCE = "'use strict';\n\n/** Highest positive signed 32-bit float value */\nconst maxInt = 2147483647; // aka. 0x7FFFFFFF or 2^31-1\n\n/** Bootstring parameters */\nconst base = 36;\nconst tMin = 1;\nconst tMax = 26;\nconst skew = 38;\nconst damp = 700;\nconst initialBias = 72;\nconst initialN = 128; // 0x80\nconst delimiter = '-'; // '\\x2D'\n\n/** Regular expressions */\nconst regexPunycode = /^xn--/;\nconst regexNonASCII = /[^\\0-\\x7F]/; // Note: U+007F DEL is excluded too.\nconst regexSeparators = /[\\x2E\\u3002\\uFF0E\\uFF61]/g; // RFC 3490 separators\n\n/** Error messages */\nconst errors = {\n\t'overflow': 'Overflow: input needs wider integers to process',\n\t'not-basic': 'Illegal input >= 0x80 (not a basic code point)',\n\t'invalid-input': 'Invalid input'\n};\n\n/** Convenience shortcuts */\nconst baseMinusTMin = base - tMin;\nconst floor = Math.floor;\nconst stringFromCharCode = String.fromCharCode;\n\n/*--------------------------------------------------------------------------*/\n\n/**\n * A generic error utility function.\n * @private\n * @param {String} type The error type.\n * @returns {Error} Throws a `RangeError` with the applicable error message.\n */\nfunction error(type) {\n\tthrow new RangeError(errors[type]);\n}\n\n/**\n * A generic `Array#map` utility function.\n * @private\n * @param {Array} array The array to iterate over.\n * @param {Function} callback The function that gets called for every array\n * item.\n * @returns {Array} A new array of values returned by the callback function.\n */\nfunction map(array, callback) {\n\tconst result = [];\n\tlet length = array.length;\n\twhile (length--) {\n\t\tresult[length] = callback(array[length]);\n\t}\n\treturn result;\n}\n\n/**\n * A simple `Array#map`-like wrapper to work with domain name strings or email\n * addresses.\n * @private\n * @param {String} domain The domain name or email address.\n * @param {Function} callback The function that gets called for every\n * character.\n * @returns {String} A new string of characters returned by the callback\n * function.\n */\nfunction mapDomain(domain, callback) {\n\tconst parts = domain.split('@');\n\tlet result = '';\n\tif (parts.length > 1) {\n\t\t// In email addresses, only the domain name should be punycoded. Leave\n\t\t// the local part (i.e. everything up to `@`) intact.\n\t\tresult = parts[0] + '@';\n\t\tdomain = parts[1];\n\t}\n\t// Avoid `split(regex)` for IE8 compatibility. See #17.\n\tdomain = domain.replace(regexSeparators, '\\x2E');\n\tconst labels = domain.split('.');\n\tconst encoded = map(labels, callback).join('.');\n\treturn result + encoded;\n}\n\n/**\n * Creates an array containing the numeric code points of each Unicode\n * character in the string. While JavaScript uses UCS-2 internally,\n * this function will convert a pair of surrogate halves (each of which\n * UCS-2 exposes as separate characters) into a single code point,\n * matching UTF-16.\n * @see `punycode.ucs2.encode`\n * @see <https://mathiasbynens.be/notes/javascript-encoding>\n * @memberOf punycode.ucs2\n * @name decode\n * @param {String} string The Unicode input string (UCS-2).\n * @returns {Array} The new array of code points.\n */\nfunction ucs2decode(string) {\n\tconst output = [];\n\tlet counter = 0;\n\tconst length = string.length;\n\twhile (counter < length) {\n\t\tconst value = string.charCodeAt(counter++);\n\t\tif (value >= 0xD800 && value <= 0xDBFF && counter < length) {\n\t\t\t// It's a high surrogate, and there is a next character.\n\t\t\tconst extra = string.charCodeAt(counter++);\n\t\t\tif ((extra & 0xFC00) == 0xDC00) { // Low surrogate.\n\t\t\t\toutput.push(((value & 0x3FF) << 10) + (extra & 0x3FF) + 0x10000);\n\t\t\t} else {\n\t\t\t\t// It's an unmatched surrogate; only append this code unit, in case the\n\t\t\t\t// next code unit is the high surrogate of a surrogate pair.\n\t\t\t\toutput.push(value);\n\t\t\t\tcounter--;\n\t\t\t}\n\t\t} else {\n\t\t\toutput.push(value);\n\t\t}\n\t}\n\treturn output;\n}\n\n/**\n * Creates a string based on an array of numeric code points.\n * @see `punycode.ucs2.decode`\n * @memberOf punycode.ucs2\n * @name encode\n * @param {Array} codePoints The array of numeric code points.\n * @returns {String} The new Unicode string (UCS-2).\n */\nconst ucs2encode = codePoints => String.fromCodePoint(...codePoints);\n\n/**\n * Converts a basic code point into a digit/integer.\n * @see `digitToBasic()`\n * @private\n * @param {Number} codePoint The basic numeric code point value.\n * @returns {Number} The numeric value of a basic code point (for use in\n * representing integers) in the range `0` to `base - 1`, or `base` if\n * the code point does not represent a value.\n */\nconst basicToDigit = function(codePoint) {\n\tif (codePoint >= 0x30 && codePoint < 0x3A) {\n\t\treturn 26 + (codePoint - 0x30);\n\t}\n\tif (codePoint >= 0x41 && codePoint < 0x5B) {\n\t\treturn codePoint - 0x41;\n\t}\n\tif (codePoint >= 0x61 && codePoint < 0x7B) {\n\t\treturn codePoint - 0x61;\n\t}\n\treturn base;\n};\n\n/**\n * Converts a digit/integer into a basic code point.\n * @see `basicToDigit()`\n * @private\n * @param {Number} digit The numeric value of a basic code point.\n * @returns {Number} The basic code point whose value (when used for\n * representing integers) is `digit`, which needs to be in the range\n * `0` to `base - 1`. If `flag` is non-zero, the uppercase form is\n * used; else, the lowercase form is used. The behavior is undefined\n * if `flag` is non-zero and `digit` has no uppercase form.\n */\nconst digitToBasic = function(digit, flag) {\n\t//  0..25 map to ASCII a..z or A..Z\n\t// 26..35 map to ASCII 0..9\n\treturn digit + 22 + 75 * (digit < 26) - ((flag != 0) << 5);\n};\n\n/**\n * Bias adaptation function as per section 3.4 of RFC 3492.\n * https://tools.ietf.org/html/rfc3492#section-3.4\n * @private\n */\nconst adapt = function(delta, numPoints, firstTime) {\n\tlet k = 0;\n\tdelta = firstTime ? floor(delta / damp) : delta >> 1;\n\tdelta += floor(delta / numPoints);\n\tfor (/* no initialization */; delta > baseMinusTMin * tMax >> 1; k += base) {\n\t\tdelta = floor(delta / baseMinusTMin);\n\t}\n\treturn floor(k + (baseMinusTMin + 1) * delta / (delta + skew));\n};\n\n/**\n * Converts a Punycode string of ASCII-only symbols to a string of Unicode\n * symbols.\n * @memberOf punycode\n * @param {String} input The Punycode string of ASCII-only symbols.\n * @returns {String} The resulting string of Unicode symbols.\n */\nconst decode = function(input) {\n\t// Don't use UCS-2.\n\tconst output = [];\n\tconst inputLength = input.length;\n\tlet i = 0;\n\tlet n = initialN;\n\tlet bias = initialBias;\n\n\t// Handle the basic code points: let `basic` be the number of input code\n\t// points before the last delimiter, or `0` if there is none, then copy\n\t// the first basic code points to the output.\n\n\tlet basic = input.lastIndexOf(delimiter);\n\tif (basic < 0) {\n\t\tbasic = 0;\n\t}\n\n\tfor (let j = 0; j < basic; ++j) {\n\t\t// if it's not a basic code point\n\t\tif (input.charCodeAt(j) >= 0x80) {\n\t\t\terror('not-basic');\n\t\t}\n\t\toutput.push(input.charCodeAt(j));\n\t}\n\n\t// Main decoding loop: start just after the last delimiter if any basic code\n\t// points were copied; start at the beginning otherwise.\n\n\tfor (let index = basic > 0 ? basic + 1 : 0; index < inputLength; /* no final expression */) {\n\n\t\t// `index` is the index of the next character to be consumed.\n\t\t// Decode a generalized variable-length integer into `delta`,\n\t\t// which gets added to `i`. The overflow checking is easier\n\t\t// if we increase `i` as we go, then subtract off its starting\n\t\t// value at the end to obtain `delta`.\n\t\tconst oldi = i;\n\t\tfor (let w = 1, k = base; /* no condition */; k += base) {\n\n\t\t\tif (index >= inputLength) {\n\t\t\t\terror('invalid-input');\n\t\t\t}\n\n\t\t\tconst digit = basicToDigit(input.charCodeAt(index++));\n\n\t\t\tif (digit >= base) {\n\t\t\t\terror('invalid-input');\n\t\t\t}\n\t\t\tif (digit > floor((maxInt - i) / w)) {\n\t\t\t\terror('overflow');\n\t\t\t}\n\n\t\t\ti += digit * w;\n\t\t\tconst t = k <= bias ? tMin : (k >= bias + tMax ? tMax : k - bias);\n\n\t\t\tif (digit < t) {\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tconst baseMinusT = base - t;\n\t\t\tif (w > floor(maxInt / baseMinusT)) {\n\t\t\t\terror('overflow');\n\t\t\t}\n\n\t\t\tw *= baseMinusT;\n\n\t\t}\n\n\t\tconst out = output.length + 1;\n\t\tbias = adapt(i - oldi, out, oldi == 0);\n\n\t\t// `i` was supposed to wrap around from `out` to `0`,\n\t\t// incrementing `n` each time, so we'll fix that now:\n\t\tif (floor(i / out) > maxInt - n) {\n\t\t\terror('overflow');\n\t\t}\n\n\t\tn += floor(i / out);\n\t\ti %= out;\n\n\t\t// Insert `n` at position `i` of the output.\n\t\toutput.splice(i++, 0, n);\n\n\t}\n\n\treturn String.fromCodePoint(...output);\n};\n\n/**\n * Converts a string of Unicode symbols (e.g. a domain name label) to a\n * Punycode string of ASCII-only symbols.\n * @memberOf punycode\n * @param {String} input The string of Unicode symbols.\n * @returns {String} The resulting Punycode string of ASCII-only symbols.\n */\nconst encode = function(input) {\n\tconst output = [];\n\n\t// Convert the input in UCS-2 to an array of Unicode code points.\n\tinput = ucs2decode(input);\n\n\t// Cache the length.\n\tconst inputLength = input.length;\n\n\t// Initialize the state.\n\tlet n = initialN;\n\tlet delta = 0;\n\tlet bias = initialBias;\n\n\t// Handle the basic code points.\n\tfor (const currentValue of input) {\n\t\tif (currentValue < 0x80) {\n\t\t\toutput.push(stringFromCharCode(currentValue));\n\t\t}\n\t}\n\n\tconst basicLength = output.length;\n\tlet handledCPCount = basicLength;\n\n\t// `handledCPCount` is the number of code points that have been handled;\n\t// `basicLength` is the number of basic code points.\n\n\t// Finish the basic string with a delimiter unless it's empty.\n\tif (basicLength) {\n\t\toutput.push(delimiter);\n\t}\n\n\t// Main encoding loop:\n\twhile (handledCPCount < inputLength) {\n\n\t\t// All non-basic code points < n have been handled already. Find the next\n\t\t// larger one:\n\t\tlet m = maxInt;\n\t\tfor (const currentValue of input) {\n\t\t\tif (currentValue >= n && currentValue < m) {\n\t\t\t\tm = currentValue;\n\t\t\t}\n\t\t}\n\n\t\t// Increase `delta` enough to advance the decoder's <n,i> state to <m,0>,\n\t\t// but guard against overflow.\n\t\tconst handledCPCountPlusOne = handledCPCount + 1;\n\t\tif (m - n > floor((maxInt - delta) / handledCPCountPlusOne)) {\n\t\t\terror('overflow');\n\t\t}\n\n\t\tdelta += (m - n) * handledCPCountPlusOne;\n\t\tn = m;\n\n\t\tfor (const currentValue of input) {\n\t\t\tif (currentValue < n && ++delta > maxInt) {\n\t\t\t\terror('overflow');\n\t\t\t}\n\t\t\tif (currentValue === n) {\n\t\t\t\t// Represent delta as a generalized variable-length integer.\n\t\t\t\tlet q = delta;\n\t\t\t\tfor (let k = base; /* no condition */; k += base) {\n\t\t\t\t\tconst t = k <= bias ? tMin : (k >= bias + tMax ? tMax : k - bias);\n\t\t\t\t\tif (q < t) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tconst qMinusT = q - t;\n\t\t\t\t\tconst baseMinusT = base - t;\n\t\t\t\t\toutput.push(\n\t\t\t\t\t\tstringFromCharCode(digitToBasic(t + qMinusT % baseMinusT, 0))\n\t\t\t\t\t);\n\t\t\t\t\tq = floor(qMinusT / baseMinusT);\n\t\t\t\t}\n\n\t\t\t\toutput.push(stringFromCharCode(digitToBasic(q, 0)));\n\t\t\t\tbias = adapt(delta, handledCPCountPlusOne, handledCPCount === basicLength);\n\t\t\t\tdelta = 0;\n\t\t\t\t++handledCPCount;\n\t\t\t}\n\t\t}\n\n\t\t++delta;\n\t\t++n;\n\n\t}\n\treturn output.join('');\n};\n\n/**\n * Converts a Punycode string representing a domain name or an email address\n * to Unicode. Only the Punycoded parts of the input will be converted, i.e.\n * it doesn't matter if you call it on a string that has already been\n * converted to Unicode.\n * @memberOf punycode\n * @param {String} input The Punycoded domain name or email address to\n * convert to Unicode.\n * @returns {String} The Unicode representation of the given Punycode\n * string.\n */\nconst toUnicode = function(input) {\n\treturn mapDomain(input, function(string) {\n\t\treturn regexPunycode.test(string)\n\t\t\t? decode(string.slice(4).toLowerCase())\n\t\t\t: string;\n\t});\n};\n\n/**\n * Converts a Unicode string representing a domain name or an email address to\n * Punycode. Only the non-ASCII parts of the domain name will be converted,\n * i.e. it doesn't matter if you call it with a domain that's already in\n * ASCII.\n * @memberOf punycode\n * @param {String} input The domain name or email address to convert, as a\n * Unicode string.\n * @returns {String} The Punycode representation of the given domain name or\n * email address.\n */\nconst toASCII = function(input) {\n\treturn mapDomain(input, function(string) {\n\t\treturn regexNonASCII.test(string)\n\t\t\t? 'xn--' + encode(string)\n\t\t\t: string;\n\t});\n};\n\n/*--------------------------------------------------------------------------*/\n\n/** Define the public API */\nconst punycode = {\n\t/**\n\t * A string representing the current Punycode.js version number.\n\t * @memberOf punycode\n\t * @type String\n\t */\n\t'version': '2.3.1',\n\t/**\n\t * An object of methods to convert from JavaScript's internal character\n\t * representation (UCS-2) to Unicode code points, and back.\n\t * @see <https://mathiasbynens.be/notes/javascript-encoding>\n\t * @memberOf punycode\n\t * @type Object\n\t */\n\t'ucs2': {\n\t\t'decode': ucs2decode,\n\t\t'encode': ucs2encode\n\t},\n\t'decode': decode,\n\t'encode': encode,\n\t'toASCII': toASCII,\n\t'toUnicode': toUnicode\n};\n\nmodule.exports = punycode;\n";
+//# sourceMappingURL=punycode-source.d.ts.map

package/dist/punycode-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"punycode-source.d.ts","sourceRoot":"","sources":["../src/punycode-source.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,eAAe,2zaAA2za,CAAC"}

package/dist/runtime-interface.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Runtime Interface - Common interface for main-thread and worker runtimes
+ */
+import type { VirtualFS } from './virtual-fs';
+export interface IRuntimeOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onConsole?: (method: string, args: unknown[]) => void;
+}
+export interface IModule {
+    id: string;
+    filename: string;
+    exports: unknown;
+    loaded: boolean;
+    children: IModule[];
+    paths: string[];
+}
+export interface IExecuteResult {
+    exports: unknown;
+    module: IModule;
+}
+/**
+ * Common runtime interface implemented by both MainThreadRuntime and WorkerRuntime
+ */
+export interface IRuntime {
+    /**
+     * Execute code as a module
+     */
+    execute(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the virtual file system
+     */
+    runFile(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache
+     */
+    clearCache(): void;
+    /**
+     * Get the virtual file system (only available on main thread runtime)
+     */
+    getVFS?(): VirtualFS;
+    /**
+     * Terminate the runtime (only applicable to worker runtime)
+     */
+    terminate?(): void;
+}
+/**
+ * Options for creating a runtime
+ */
+export interface CreateRuntimeOptions extends IRuntimeOptions {
+    /**
+     * Which thread the guest runs on.
+     * - false (default): the caller's thread
+     * - true: a worker of the engine's own
+     * - 'auto': a worker where the realm has them, the caller's thread otherwise
+     *
+     * A worker is a thread, not an origin: it reaches the page's storage and
+     * its network. An embedder that needs origin isolation serves the run from
+     * an origin of its own, which is the substrate's isolation worker.
+     */
+    useWorker?: boolean | 'auto';
+}
+/**
+ * VFS snapshot for transferring to worker
+ */
+export interface VFSSnapshot {
+    files: VFSFileEntry[];
+}
+export interface VFSFileEntry {
+    path: string;
+    type: 'file' | 'directory';
+    content?: string;
+}
+//# sourceMappingURL=runtime-interface.d.ts.map

package/dist/runtime-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-interface.d.ts","sourceRoot":"","sources":["../src/runtime-interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAElE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnD;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,IAAI,SAAS,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/runtime.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Runtime - Execute user code with shimmed Node.js globals
+ *
+ * ESM to CJS transformation is now handled during npm install by transform.ts
+ * using esbuild-wasm. This runtime just executes the pre-transformed CJS code.
+ */
+import { VirtualFS } from './virtual-fs';
+import type { IExecuteResult } from './runtime-interface';
+import { Process } from './shims/process';
+export declare function pendingGuestTimers(process: Process): number;
+/**
+ * Clear every timer a guest still holds, as ending a Node process clears the
+ * ones its loop was waiting on. The ids were made by the host's own
+ * `setTimeout`/`setInterval` through the guest's global view, so the host's
+ * own clears end them; a `Timeout` is cleared by either in Node, and either
+ * refusing an id of the other kind is not an error here.
+ */
+export declare function stopGuestTimers(process: Process): void;
+export declare function __substratePendingOf(value: unknown): Promise<void> | undefined;
+export interface Module {
+    id: string;
+    filename: string;
+    exports: unknown;
+    loaded: boolean;
+    children: Module[];
+    paths: string[];
+    /** The module that first required this one; null for the entry, as Node's is. */
+    parent?: Module | null;
+}
+export interface RuntimeOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onConsole?: (method: string, args: unknown[]) => void;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    /** What is on the guest's fd 0, the way a shell puts the left of a pipe there. */
+    stdin?: string;
+    /** The runner can still write to fd 0, so standard input has not ended. */
+    stdinHeld?: boolean;
+    /** The run was given a TTY; a pipe child is not one. */
+    tty?: boolean;
+    /** This run's process number and its parent's; minted where neither is given. */
+    pid?: number;
+    ppid?: number;
+}
+export interface RequireFunction {
+    (id: string): unknown;
+    resolve: (id: string) => string;
+    cache: Record<string, Module>;
+}
+/**
+ * Runtime class for executing code in virtual environment
+ * Note: This class has sync methods for backward compatibility.
+ * Use createRuntime() factory for IRuntime interface compliance.
+ */
+export declare class Runtime {
+    private vfs;
+    private fsShim;
+    private process;
+    private moduleCache;
+    private options;
+    /** Cache for pre-processed code (after ESM transform) before eval */
+    private processedCodeCache;
+    constructor(vfs: VirtualFS, options?: RuntimeOptions);
+    /**
+     * Execute code as a module (synchronous - backward compatible)
+     */
+    execute(code: string, filename?: string): {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Execute code as a module (async version for IRuntime interface)
+     * Alias: executeSync() is the same as execute() for backward compatibility
+     */
+    executeSync: (code: string, filename?: string) => {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Execute code as a module (async - for IRuntime interface)
+     */
+    executeAsync(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the virtual file system (synchronous - backward compatible)
+     */
+    runFile(filename: string): {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Alias for runFile (backward compatibility)
+     */
+    runFileSync: (filename: string) => {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Run a file from the virtual file system (async - for IRuntime interface)
+     */
+    runFileAsync(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache
+     */
+    clearCache(): void;
+    /**
+     * Get the virtual file system
+     */
+    getVFS(): VirtualFS;
+    /**
+     * Get the process object
+     */
+    getProcess(): Process;
+    /**
+     * Create a REPL context that evaluates expressions and persists state.
+     *
+     * Returns an object with an `eval` method that:
+     * - Returns the value of the last expression (unlike `execute` which returns module.exports)
+     * - Persists variables between calls (`var x = 1` then `x` works)
+     * - Has access to `require`, `console`, `process`, `Buffer` (same as execute)
+     *
+     * Security: The eval runs inside a Generator's local scope via direct eval,
+     * NOT in the global scope. Only the runtime's own require/console/process are
+     * exposed — the same sandbox boundary as execute(). Variables created in the
+     * REPL are confined to the generator's closure and cannot leak to the page.
+     *
+     * Note: `const`/`let` are transformed to `var` so they persist across calls
+     * (var hoists to the generator's function scope, const/let are block-scoped
+     * to each eval call and would be lost).
+     */
+    createREPL(): {
+        eval: (code: string) => unknown;
+    };
+}
+/**
+ * Create and execute code in a new runtime (synchronous - backward compatible)
+ */
+export declare function execute(code: string, vfs: VirtualFS, options?: RuntimeOptions): {
+    exports: unknown;
+    module: Module;
+};
+export type { IRuntime, IExecuteResult, IRuntimeOptions } from './runtime-interface';
+export default Runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/server-bridge.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Server Bridge
+ * Connects Service Worker requests to virtual HTTP servers
+ */
+import { type ResponseData } from './node-lib/http-bridge';
+import { EventEmitter } from './node-lib/events-module';
+/**
+ * Interface for virtual servers that can be registered with the bridge
+ */
+export interface IVirtualServer {
+    listening: boolean;
+    /** What `net.Server.address()` answers: an address and a port, or the PATH of a unix-domain socket. */
+    address(): {
+        port: number;
+        address: string;
+        family: string;
+    } | string | null;
+    handleRequest(method: string, url: string, headers: Record<string, string>, body?: Buffer | string): Promise<ResponseData>;
+}
+export interface VirtualServer {
+    /**
+     * A server the host registered and answers itself, or null for a guest's
+     * own: a guest's server is a port this engine is listening on, and it is
+     * reached by connecting to it like any other client.
+     */
+    server: IVirtualServer | null;
+    port: number;
+    hostname: string;
+}
+export interface BridgeOptions {
+    baseUrl?: string;
+    onServerReady?: (port: number, url: string) => void;
+}
+export interface InitServiceWorkerOptions {
+    /**
+     * The URL path to the service worker file
+     * @default '/__sw__.js'
+     */
+    swUrl?: string;
+    /**
+     * The page's own documents that are frames of it (a sandbox, a worker
+     * host), by path, so the worker does not take one for the preview's.
+     */
+    ownDocuments?: string[];
+}
+export declare class ServerBridge extends EventEmitter {
+    static DEBUG: boolean;
+    servers: Map<number, VirtualServer>;
+    private baseUrl;
+    private options;
+    private messageChannel;
+    /** The upgrade channel this bridge opened, held so it can be given back. */
+    private upgradeChannel;
+    private serviceWorkerReady;
+    private keepaliveInterval;
+    constructor(options?: BridgeOptions);
+    /**
+     * Give back everything this bridge opened: the upgrade channel and the
+     * service worker keepalive. A host that is done with a container calls it
+     * and has its process back; calling it twice is nothing.
+     */
+    /**
+     * Every port a guest starts listening on becomes a server this bridge can
+     * answer for, and every port it stops listening on stops being one. The
+     * news comes from the net binding, because that is where a port is taken;
+     * the engine's `http` is Node's own file and knows nothing of a page.
+     */
+    private watchGuestPorts;
+    close(): void;
+    /**
+     * Register a server on a port
+     */
+    registerServer(server: IVirtualServer | null, port: number, hostname?: string): void;
+    /**
+     * Unregister a server
+     */
+    unregisterServer(port: number): void;
+    /** The server the service worker answers at the origin's root, the preview's; null for none. */
+    private primaryPort;
+    /**
+     * Names the server the service worker serves at the origin's root, as an
+     * app is served at its own origin's root: its documents read their routes
+     * from `location.pathname`, which under /__virtual__/<port>/ is not the
+     * path they expect. Told to the worker now and again whenever the worker
+     * is (re)initialized, since a worker that restarted remembers nothing.
+     */
+    setPrimaryPort(port: number | null): void;
+    /** Every registration the worker should hold, sent again to a worker that was (re)initialized. */
+    private announceServers;
+    private ownDocuments;
+    /**
+     * Get server URL for a port
+     */
+    getServerUrl(port: number): string;
+    /**
+     * Get all registered server ports
+     */
+    getServerPorts(): number[];
+    /**
+     * Handle an incoming request from Service Worker
+     */
+    handleRequest(port: number, method: string, url: string, headers: Record<string, string>, body?: ArrayBuffer): Promise<ResponseData>;
+    /**
+     * Initialize Service Worker communication
+     * @param options - Configuration options for the service worker
+     * @param options.swUrl - Custom URL path to the service worker file (default: '/__sw__.js')
+     */
+    initServiceWorker(options?: InitServiceWorkerOptions): Promise<void>;
+    /**
+     * Handle messages from Service Worker
+     */
+    private handleServiceWorkerMessage;
+    /**
+     * Handle a streaming request - sends chunks as they arrive
+     */
+    /**
+     * A page-side request streamed to the caller as it arrives, the door a host
+     * reads a guest's server through when it wants chunks rather than a body:
+     * a guest's own server is reached over the loopback as any client reaches
+     * it; a server the host registered answers through its own streaming
+     * method where it has one, else its buffered answer is delivered whole.
+     */
+    handleStreamingRequest(port: number, method: string, url: string, headers: Record<string, string>, body: ArrayBuffer | undefined, callbacks: {
+        start(statusCode: number, statusMessage: string, headers: Record<string, string>): void;
+        chunk(chunk: Uint8Array): void;
+        end(): void;
+    }): Promise<boolean>;
+    private streamToServiceWorker;
+    /**
+     * Send message to Service Worker
+     */
+    private notifyServiceWorker;
+    /**
+     * Create a mock request handler for testing without Service Worker
+     */
+    createFetchHandler(): (request: Request) => Promise<Response>;
+}
+/**
+ * Get or create the global server bridge
+ */
+export declare function getServerBridge(options?: BridgeOptions): ServerBridge;
+/**
+ * Reset the global bridge (for testing)
+ */
+export declare function resetServerBridge(): void;
+export default ServerBridge;
+//# sourceMappingURL=server-bridge.d.ts.map

package/dist/server-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-bridge.d.ts","sourceRoot":"","sources":["../src/server-bridge.ts"],"names":[],"mappings":"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"}

package/dist/shims/async_hooks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * async_hooks shim - Async tracking is not available in browser
+ */
+export declare class AsyncResource {
+    constructor(_type: string, _options?: object);
+    runInAsyncScope<T>(fn: (...args: any[]) => T, thisArg?: unknown, ...args: any[]): T;
+    emitDestroy(): this;
+    asyncId(): number;
+    triggerAsyncId(): number;
+    static bind<T extends (...args: any[]) => any>(fn: T, _type?: string): T;
+}
+export declare class AsyncLocalStorage<T> {
+    private store;
+    constructor();
+    static snapshot(): (callback: (...args: unknown[]) => unknown, ...args: unknown[]) => unknown;
+    static bind(callback: (...args: unknown[]) => unknown): (...args: unknown[]) => unknown;
+    disable(): void;
+    getStore(): T | undefined;
+    /**
+     * A store entered for an async callback used to be left the moment the
+     * callback returned its promise, so the first `await` inside a Server Action
+     * lost Next's request store and `cookies()` was "outside a request scope". A
+     * tab has no async_hooks and no AsyncContext, and an `await` of a native
+     * promise bypasses any `then` a patch could install, so the continuations
+     * cannot be followed. What can be done honestly is keep the store current
+     * until the callback's promise settles: exact for one run at a time, and
+     * last-entered-wins where two async runs overlap.
+     */
+    run<R>(store: T, callback: (...args: unknown[]) => R, ...args: unknown[]): R;
+    exit<R>(callback: () => R): R;
+    enterWith(store: T): void;
+}
+export interface AsyncHook {
+    enable(): this;
+    disable(): this;
+}
+export declare function createHook(_callbacks: object): AsyncHook;
+export declare function executionAsyncId(): number;
+export declare function executionAsyncResource(): object;
+export declare function triggerAsyncId(): number;
+declare const _default: {
+    AsyncResource: typeof AsyncResource;
+    AsyncLocalStorage: typeof AsyncLocalStorage;
+    createHook: typeof createHook;
+    executionAsyncId: typeof executionAsyncId;
+    executionAsyncResource: typeof executionAsyncResource;
+    triggerAsyncId: typeof triggerAsyncId;
+};
+export default _default;
+//# sourceMappingURL=async_hooks.d.ts.map

package/dist/shims/async_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_hooks.d.ts","sourceRoot":"","sources":["../../src/shims/async_hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,aAAa;gBACZ,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAG5C,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;IAInF,WAAW,IAAI,IAAI;IACnB,OAAO,IAAI,MAAM;IACjB,cAAc,IAAI,MAAM;IAGxB,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC;CAGzE;AAYD,qBAAa,iBAAiB,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAgB;;IAM7B,MAAM,CAAC,QAAQ,KAGL,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,GAAG,MAAM,OAAO,EAAE;IAUvE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAE3C,GAAG,MAAM,OAAO,EAAE;IAG5B,OAAO,IAAI,IAAI;IAEf,QAAQ,IAAI,CAAC,GAAG,SAAS;IAIzB;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC;IAmB5E,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAU7B,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAG1B;AA0CD,MAAM,WAAW,SAAS;IACxB,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAKxD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;;;;;;;;;AAED,wBAOE"}