@engine262/engine262 0.0.1-01e9fa95a4e8a1c042efd00492309a2de4998fd0

package/lib/node/bin.mjs

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+import { start } from 'node:repl';
+import { readFileSync, writeSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { format as _format, inspect as _inspect, parseArgs, styleText, } from 'node:util';
+// let's try if the following message on old node causes test failure on test262.fyi
+// "ExperimentalWarning: Importing JSON modules is an experimental feature and might change at any time"
+// import packageJson from '../../package.json' with { type: 'json' };
+import { createRequire } from 'node:module';
+import { createConsole } from '../inspector/utils.mjs';
+import { fileSystemModuleLoader } from './module.mjs';
+import { setSurroundingAgent, FEATURES, inspect, Value, Agent, ManagedRealm, createTest262Intrinsics, surroundingAgent, ThrowCompletion, ValueOfNormalCompletion, importBundledTest262Harness, boostTest262Harness, ModuleCache, PerformPromiseThen, CreateBuiltinFunction, composeModuleLoaders, Descriptor, isFunctionObject, Throw, ToNumber, R, Call, GetActiveScriptOrModule, NormalCompletion, } from '#self';
+const packageJson = createRequire(import.meta.url)('../../package.json');
+const writeStdout = (text) => writeSync(process.stdout.fd, text);
+const writeStderr = (text) => writeSync(process.stderr.fd, text);
+const help = () => `
+engine262 v${packageJson.version}
+
+Usage:
+
+    engine262 [options]
+    engine262 [options] [input file]
+    engine262 [input file]
+
+Options:
+  ${((str) => {
+    const options = [
+        ['-h, --help', 'Show help'],
+        ['-m, --module', 'Evaluate contents of input-file as a module.'],
+        ['-e, --eval', 'Evaluate the given string. (can be used with --module)'],
+        ['--features=...', 'A comma separated list of features.'],
+        ['-a, --features=all', 'Enable all features.'],
+        ['--no-test262', 'Do not expose $ and $262 for test262.'],
+        ['--[no-]inspect', 'Do [not] attach an inspector.'],
+        ['--no-preview', 'Do not enable preview in the inspector.'],
+        ['-t, --test262-harness', 'Import test262 harness files.'],
+    ];
+    const maxOptionLength = options.reduce((max, [flag]) => Math.max(max, flag.length), 0);
+    options.forEach(([flag, description]) => {
+        str += `    ${styleText('green', flag.padEnd(maxOptionLength))}  ${description}\n`;
+    });
+    return str;
+})('\n')}
+Features:
+  ${((str) => {
+    const supportColor = styleText('red', 'test') !== 'test';
+    function link(text, url) {
+        if (!supportColor || !url)
+            return text;
+        const OSC = '\u001B]';
+        const BEL = '\u0007';
+        return `${OSC}8;;${url}${BEL}${text}${OSC}8;;${BEL}`;
+    }
+    let maxFlagLength = 0;
+    for (const f of FEATURES) {
+        if (f.flag.length > maxFlagLength)
+            maxFlagLength = f.flag.length;
+    }
+    FEATURES.forEach((f) => {
+        str += `    ${styleText('redBright', f.flag.padEnd(maxFlagLength))}  ${link(f.name, f.url)}\n`;
+    });
+    return str;
+})('\n')}
+`;
+const argv = parseArgs({
+    args: process.argv.slice(2),
+    allowPositionals: true,
+    allowNegative: true,
+    strict: true,
+    options: {
+        'help': { type: 'boolean', short: 'h' },
+        'eval': { type: 'string', short: 'e' },
+        'module': { type: 'boolean', short: 'm' },
+        'features': { type: 'string' },
+        'features-all': { type: 'boolean', short: 'a' },
+        'inspect': { type: 'boolean' },
+        'test262': { type: 'boolean', default: true },
+        'test262-harness': { type: 'boolean', short: 't' },
+        // hidden options
+        'preview-debug': { type: 'boolean' },
+    },
+});
+if (argv.values.help) {
+    writeStdout(help());
+    process.exit(0);
+}
+let features;
+if (argv.values.features === 'all' || argv.values['features-all']) {
+    features = FEATURES.map((f) => f.flag);
+}
+else if (argv.values.features) {
+    features = argv.values.features.split(',');
+}
+else {
+    features = [];
+}
+// exit code 1 if at least 1 unhandled rejection in the end.
+let unhandledExceptionCount = 0;
+process.on('exit', () => {
+    if (unhandledExceptionCount > 0)
+        process.exitCode = 1;
+});
+const unhandledRejectionPendingLog = new Set();
+const agent = new Agent({
+    features,
+    supportedImportAttributes: ['type'],
+    hostHooks: {
+        HostLoadImportedModule: composeModuleLoaders([fileSystemModuleLoader]),
+        HostPromiseRejectionTrackers: new Set([(promise, operation) => {
+                if (operation === 'reject') {
+                    unhandledExceptionCount += 1;
+                    unhandledRejectionPendingLog.add(promise);
+                    const realm = surroundingAgent.currentRealmRecord;
+                    setTimeout(() => {
+                        if (!unhandledRejectionPendingLog.has(promise))
+                            return;
+                        unhandledRejectionPendingLog.delete(promise);
+                        const pop = realm.pushTopContext();
+                        const err = inspect(promise.PromiseResult);
+                        pop?.();
+                        writeStderr(`Unhandled promise rejection: ${err}\n`);
+                    }, 10);
+                }
+                else if (operation === 'handle') {
+                    unhandledExceptionCount -= 1;
+                    unhandledRejectionPendingLog.delete(promise);
+                }
+            }]),
+    },
+    uncaughtExceptionTrackers: new Set([(error) => {
+            unhandledExceptionCount += 1;
+            const pop = realm.pushTopContext();
+            const err = inspect(error);
+            pop?.();
+            writeStderr(`Uncaught exception: ${err}\n`);
+        }]),
+});
+setSurroundingAgent(agent);
+const realm = new ManagedRealm({ resolverCache: new ModuleCache(), name: 'repl', specifier: process.cwd() });
+{
+    const pop = realm.pushTopContext();
+    realm.GlobalObject.properties.set('setTimeout', Descriptor({
+        Value: CreateBuiltinFunction.from(function* timeout(f = Value.undefined, time = Value.undefined) {
+            if (!isFunctionObject(f))
+                return Throw.TypeError('setTimeout($1, ...) should be a function', f);
+            const delay = yield* ToNumber(time);
+            if (delay instanceof ThrowCompletion)
+                return delay;
+            const delayTime = R(ValueOfNormalCompletion(delay));
+            const job = {
+                queueName: 'setTimeout resolve',
+                job: () => Call(f, Value.undefined, []),
+                callerRealm: surroundingAgent.runningExecutionContext.Realm,
+                callerScriptOrModule: GetActiveScriptOrModule(),
+            };
+            surroundingAgent.eventLoop.enqueueAsync('timers', job, (enqueue) => {
+                setTimeout(enqueue, delayTime);
+            });
+            return Value.undefined;
+        }),
+    }));
+    pop?.();
+}
+// Define console.log
+{
+    const format = (function* format(args) {
+        const str = [];
+        for (const arg of args.values()) {
+            // TODO: inspect should return a PlainEvaluator so debugger can hook in.
+            str.push(inspect(arg));
+        }
+        return str.join(' ');
+    });
+    createConsole(realm, {
+        *log(args) {
+            writeStdout(`${yield* format(args)}\n`);
+        },
+        *error(args) {
+            writeStderr(`${yield* format(args)}\n`);
+        },
+        *debug(args) {
+            writeStderr(`${yield* format(args)}\n`);
+        },
+    });
+}
+if (argv.values.test262) {
+    // eslint-disable-next-line no-console
+    createTest262Intrinsics(realm, argv.values.test262, (...args) => {
+        writeStdout(`${_format(...args)}\n`);
+    });
+}
+if (argv.values['test262-harness']) {
+    importBundledTest262Harness(realm);
+    boostTest262Harness(realm);
+}
+async function setupInspector(mode) {
+    const inspectArg = argv.values.inspect;
+    if (mode !== 'repl' && !inspectArg)
+        return undefined;
+    if (inspectArg === false)
+        return undefined;
+    let has_ws = false;
+    try {
+        await import('ws');
+        has_ws = true;
+    }
+    catch {
+        if (inspectArg) {
+            writeStderr('--inspect requires the "ws" package to be installed.\n');
+            process.exit(1);
+        }
+    }
+    if (!has_ws)
+        return undefined;
+    const { NodeWebsocketInspector } = await import('./inspector.mjs');
+    const inspector = await NodeWebsocketInspector.new();
+    inspector.attachAgent(surroundingAgent, [realm]);
+    inspector.preference.previewDebug = argv.values['preview-debug'] || false;
+    writeStdout([
+        `Inspector attached at 127.0.0.1:${inspector.port}${inspectArg ? '' : ', use --no-inspect to disable'}`,
+        'Paste this URL into Chromium to open DevTools:',
+        `    ${inspector.devtoolsFrontendUrl}`,
+        '\n',
+    ].join('\n'));
+    return inspector;
+}
+function oneShotEval(inspector, source, filename) {
+    if (argv.values.module || filename.endsWith('.mjs')) {
+        realm.evaluateModule(source, filename, (promise) => {
+            if (promise instanceof ThrowCompletion) {
+                handleResult(promise);
+                return;
+            }
+            PerformPromiseThen(ValueOfNormalCompletion(promise), Value.null, CreateBuiltinFunction.from((error = Value.undefined) => {
+                handleResult(ThrowCompletion(error));
+            }));
+        });
+    }
+    else {
+        realm.evaluateScript(source, { specifier: filename }, (completion) => {
+            handleResult(completion);
+        });
+    }
+    function handleResult(completion) {
+        if (completion instanceof ThrowCompletion) {
+            const pop = surroundingAgent.hasRunningExecutionContext ? undefined : realm.pushTopContext();
+            const inspected = inspect(completion);
+            pop?.();
+            writeStderr(`${inspected}\n`);
+            unhandledExceptionCount += 1;
+        }
+        // Note: we don't have exit callback (process.on('beforeExit')), so it is impossible
+        // to have more code running after onNoPendingJob is fired.
+        surroundingAgent.eventLoop.onNoPendingJob.add(() => {
+            inspector?.stop();
+        });
+    }
+}
+if (argv.positionals[0]) {
+    const inspector = await setupInspector('file');
+    const source = readFileSync(argv.positionals[0], 'utf8');
+    oneShotEval(inspector, source, resolve(argv.positionals[0]));
+}
+else if (argv.values.eval) {
+    const inspector = await setupInspector('eval');
+    oneShotEval(inspector, argv.values.eval, '<eval>');
+}
+else if (!process.stdin.isTTY) {
+    const inspector = await setupInspector('pipe');
+    process.stdin.setEncoding('utf8');
+    let source = '';
+    process.stdin.on('data', (data) => {
+        source += data;
+    });
+    process.stdin.once('end', () => {
+        oneShotEval(inspector, source, '<pipe>');
+    });
+}
+else {
+    const inspector = await setupInspector('repl');
+    writeStdout(`Welcome to ${packageJson.name} v${String(packageJson.version).replace('0.0.1-', '')} Please report bugs to ${packageJson.bugs.url}\nType ".help" for more information.\n`);
+    const server = start({
+        prompt: '> ',
+        eval: (cmd, _context, _filename, callback) => {
+            try {
+                realm.evaluateScript(cmd, {}, (completion) => {
+                    callback(null, completion);
+                });
+            }
+            catch (e) {
+                callback(e, null);
+            }
+        },
+        preview: false,
+        writer: (o) => {
+            if (o instanceof ThrowCompletion)
+                o = o.Value;
+            if (o instanceof NormalCompletion && o.Value instanceof Value)
+                o = o.Value;
+            let out;
+            const pop = realm.pushTopContext();
+            if (o instanceof Value)
+                out = o === Value.undefined ? '' : inspect(o);
+            else
+                out = _inspect(o);
+            pop?.();
+            return out;
+        },
+    });
+    server.on('exit', () => surroundingAgent.eventLoop.onNoPendingJob.add(() => inspector?.stop()));
+}
+//# sourceMappingURL=bin.mjs.map

package/lib/node/bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.mjs","sourceRoot":"","sources":["../../lib-src/node/bin.mts"],"names":[],"mappings":"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"}

package/lib/node/example.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.d.mts.map

package/lib/node/example.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.mts","sourceRoot":"","sources":["../../lib-src/node/example.mts"],"names":[],"mappings":""}

package/lib/node/example.mjs

@@ -0,0 +1,153 @@
+/* eslint-disable no-console */
+import { NodeWebsocketInspector } from './inspector.mjs';
+import { fileSystemModuleLoader } from './module.mjs';
+import { Agent, composeModuleLoaders, CreateBuiltinFunction, createBuiltinModuleLoader, EnsureCompletion, inspect, ManagedRealm, ModuleCache, ModuleEnvironmentRecord, PerformPromiseThen, setSurroundingAgent, surroundingAgent, SyntheticModuleRecord, ThrowCompletion, ToString, X, Value, ValueOfNormalCompletion, CreateNonEnumerableDataPropertyOrThrow, Throw, IsCallable, GetActiveScriptOrModule, Call, NumberValue, } from '#self';
+import { createConsole } from '#self/inspector';
+// Agent is the running environment.
+const agent = new Agent({
+    uncaughtExceptionTrackers: new Set([(error) => {
+            console.error('Uncaught exception:', inspect(error));
+        }]),
+    hostHooks: {
+        HostLoadImportedModule: composeModuleLoaders([
+            fileSystemModuleLoader,
+            createBuiltinModuleLoader({
+                builtinModules: new Map([[{ Specifier: 'builtin', Attributes: [] }, (realm) => {
+                            const env = new ModuleEnvironmentRecord(null);
+                            const module = new SyntheticModuleRecord({
+                                Environment: env,
+                                ExportNames: [Value('foo')],
+                                EvaluationSteps() {
+                                    // Create built-in function
+                                    const foo = CreateBuiltinFunction.from(function* foo(value = Value.undefined) {
+                                        console.log('Native function foo called with argument:', inspect(yield* ToString(value)));
+                                    }, 'foo');
+                                    X(module.SetSyntheticExport(Value('foo'), foo));
+                                    console.log('Builtin module evaluated');
+                                },
+                                HostDefined: {},
+                                Namespace: undefined,
+                                ModuleSource: undefined,
+                                Realm: realm,
+                            });
+                            return module;
+                        }]]),
+            }),
+        ]),
+    },
+});
+// Only one agent can be active at a time.
+setSurroundingAgent(agent);
+// A Realm is a separate global environment.
+// In Web browsers, each iframe has its own Realm and they may interact with each other.
+const realm = new ManagedRealm({ resolverCache: new ModuleCache(), name: 'My Realm', specifier: process.cwd() });
+// Define console.log
+{
+    const format = (function* format(args) {
+        const str = [];
+        for (const arg of args.values()) {
+            str.push(inspect(arg));
+        }
+        return str.join(' ');
+    });
+    createConsole(realm, {
+        *log(args) {
+            process.stdout.write(`${yield* format(args)}\n`);
+        },
+        *error(args) {
+            process.stderr.write(`${yield* format(args)}\n`);
+        },
+        *debug(args) {
+            process.stderr.write(`${yield* format(args)}\n`);
+        },
+        *default(method, args) {
+            process.stdout.write(`[console.${method}] ${yield* format(args)}\n`);
+        },
+    });
+}
+// Create a new inspector (devtools console)
+const inspector = await NodeWebsocketInspector.new();
+function printResult(value) {
+    const pop = realm.pushTopContext();
+    if (value instanceof ThrowCompletion) {
+        console.error('Error: ', inspect(value.Value));
+    }
+    else {
+        console.log('Result:', inspect(ValueOfNormalCompletion(value)));
+    }
+    pop?.();
+}
+// Run a script and skip debugger infra (get the result synchronously).
+{
+    console.log('--------- evaluateScriptSkipDebugger ---------');
+    const result = EnsureCompletion(realm.evaluateScriptSkipDebugger(`
+    console.log('Hello from engine262!');
+    console.log('2 + 2 =', 2 + 2);
+  `, { specifier: 'example.mjs' }));
+    printResult(result);
+}
+// Run the jobQueue (Promise/other tasks).
+{
+    console.log('--------- jobQueue ---------');
+    const result = EnsureCompletion(realm.evaluateScriptSkipDebugger(`
+    Promise.resolve('Hello from Promise!').then(console.log);
+  `, { specifier: 'example2.mjs' }));
+    // define an async built-in function
+    const pop = realm.pushTopContext();
+    const sleep = CreateBuiltinFunction.from(function* sleep(ms = Value.undefined, callback = Value.undefined) {
+        if (!(ms instanceof NumberValue))
+            return Throw.TypeError('First argument must be a number');
+        if (!IsCallable(callback))
+            return Throw.TypeError('Second argument must be a function');
+        const job = {
+            queueName: 'setTimeout',
+            callerRealm: surroundingAgent.currentRealmRecord,
+            callerScriptOrModule: GetActiveScriptOrModule(),
+            job: function* setTimeoutResolve() {
+                return yield* Call(callback, Value.undefined, []);
+            },
+        };
+        surroundingAgent.eventLoop.enqueueAsync('timers', job, (enqueue) => {
+            setTimeout(enqueue, ms.value);
+        });
+        return Value.undefined;
+    }, 'sleep');
+    X(CreateNonEnumerableDataPropertyOrThrow(realm.GlobalObject, Value('sleep'), sleep));
+    pop?.();
+    const result2 = realm.evaluateScriptSkipDebugger(`
+    sleep(500, () => console.log('Hello from sleep!'));
+  `, { specifier: 'example3.mjs' });
+    printResult(result);
+    printResult(result2);
+}
+inspector.attachAgent(surroundingAgent, [realm]);
+// Run a script with debugger support
+// the evaluation may be sync or async.
+console.log('--------- evaluateScript ---------');
+realm.evaluateScript(`
+  function f() { debugger; return 1; }
+  f();
+`, { specifier: 'vm://1' }, (result) => {
+    printResult(result);
+});
+// resume from the debugger;
+surroundingAgent.resumeEvaluate();
+// Run a module
+console.log('--------- evaluateModule ---------');
+realm.evaluateModule(`
+  import { foo } from "builtin";
+  foo({ toString() { return "X" } });
+`, undefined, (result) => {
+    if (result instanceof ThrowCompletion) {
+        console.error('Module evaluate error: ', inspect(result.Value));
+    }
+    else {
+        PerformPromiseThen(ValueOfNormalCompletion(result), CreateBuiltinFunction.from(() => {
+            console.log('Module evaluated successfully');
+        }), CreateBuiltinFunction.from((error = Value.undefined) => {
+            console.error('Module evaluation error:', inspect(error));
+        }));
+    }
+});
+inspector.stop();
+//# sourceMappingURL=example.mjs.map

package/lib/node/example.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.mjs","sourceRoot":"","sources":["../../lib-src/node/example.mts"],"names":[],"mappings":"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"}

package/lib/node/inspector.d.mts

@@ -0,0 +1,17 @@
+import http from 'node:http';
+import https from 'node:https';
+import { WebSocketServer } from 'ws';
+import { Inspector } from '../inspector/index.mts';
+export declare class NodeWebsocketInspector extends Inspector {
+    _server: http.Server | https.Server;
+    _ws: WebSocketServer;
+    isDebug: boolean;
+    protected send(data: object): void;
+    protected constructor(httpServer: http.Server | https.Server, isDebug: boolean);
+    get devtoolsFrontendUrl(): string;
+    private onRequest;
+    get port(): number;
+    static new(port?: number | 'auto', host?: string, isDebug?: boolean): Promise<NodeWebsocketInspector>;
+    stop(): void;
+}
+//# sourceMappingURL=inspector.d.mts.map

package/lib/node/inspector.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.mts","sourceRoot":"","sources":["../../lib-src/node/inspector.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAoB,MAAM,IAAI,CAAC;AAIvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAUnD,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAEpC,GAAG,EAAE,eAAe,CAAC;IAErB,OAAO,UAAS;IAEhB,UAAmB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK1C;IAED,SAAS,aAAa,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAiC7E;IAED,IAAI,mBAAmB,WAEtB;IAED,OAAO,CAAC,SAAS,CA+Cf;IAEF,IAAI,IAAI,WAEP;IAED,OAAa,GAAG,CAAC,IAAI,GAAE,MAAM,GAAG,MAAe,EAAE,IAAI,SAAc,EAAE,OAAO,UAAsB,mCAuBjG;IAED,IAAI,SAGH;CACF"}

package/lib/node/inspector.mjs

@@ -0,0 +1,138 @@
+import http from 'node:http';
+import https from 'node:https';
+import { WebSocketServer } from 'ws';
+import packageJson from '../../package.json' with { type: 'json' };
+// Note: typescript will not copy json files, so it will not appear in the lib directory
+import protocol from '../../lib-src/inspector/js_protocol.json' with { type: 'json' };
+import { Inspector } from '../inspector/index.mjs';
+const ANSI = {
+    reset: '\u001b[0m',
+    red: '\u001b[31m',
+    green: '\u001b[32m',
+    yellow: '\u001b[33m',
+    blue: '\u001b[34m',
+};
+export class NodeWebsocketInspector extends Inspector {
+    _server;
+    _ws;
+    isDebug = false;
+    send(data) {
+        const s = JSON.stringify(data);
+        this._ws.clients.forEach((ws) => {
+            ws.send(s);
+        });
+    }
+    constructor(httpServer, isDebug) {
+        super();
+        this._server = httpServer;
+        httpServer.on('request', this.onRequest);
+        const websocketServer = new WebSocketServer({ server: httpServer });
+        this._ws = websocketServer;
+        websocketServer.on('connection', (ws) => {
+            const send = (obj) => {
+                const s = JSON.stringify(obj);
+                ws.send(s);
+            };
+            const sendEvent = Object.create(new Proxy({}, {
+                get: (_, key) => {
+                    const f = (params) => {
+                        send({ method: key, params });
+                    };
+                    Object.defineProperty(sendEvent, key, { value: key });
+                    return f;
+                },
+            }));
+            ws.on('message', (data) => {
+                const { id, method, params } = JSON.parse(data);
+                if (isDebug) {
+                    process.stdout.write(`${ANSI.green}${method}${ANSI.reset}: ${JSON.stringify(params)}\n`);
+                }
+                this.onMessage(id, method, params);
+            });
+            ws.on('close', () => {
+                this.onDebuggerDisconnect();
+            });
+        });
+    }
+    get devtoolsFrontendUrl() {
+        return `devtools://devtools/bundled/js_app.html?experiments=true&v8only=true&ws=localhost:${this.port}`;
+    }
+    onRequest = (req, res) => {
+        if (req.method !== 'GET') {
+            res.writeHead(405);
+            res.end();
+            return;
+        }
+        const json = (obj) => {
+            const s = JSON.stringify(obj);
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(s),
+            });
+            res.end(s);
+        };
+        switch (req.url) {
+            case '/json':
+            case '/json/list': {
+                const devtoolsFrontendUrl = this.devtoolsFrontendUrl;
+                json([{
+                        description: `${packageJson.name} instance`,
+                        devtoolsFrontendUrl,
+                        devtoolsFrontendUrlCompat: devtoolsFrontendUrl,
+                        faviconUrl: 'https://avatars0.githubusercontent.com/u/51185628',
+                        id: 'inspector.0',
+                        title: 'engine262',
+                        type: 'node',
+                        url: `file://${process.cwd()}`,
+                        webSocketDebuggerUrl: `ws://localhost:${this.port}/`,
+                    }]);
+                break;
+            }
+            case '/json/version':
+                json({
+                    'Browser': `${packageJson.name}/v${packageJson.version}`,
+                    'Protocol-Version': `${protocol.version.major}.${protocol.version.minor}`,
+                });
+                break;
+            case '/json/protocol':
+                json(protocol);
+                break;
+            default:
+                res.writeHead(404);
+                res.end();
+                break;
+        }
+    };
+    get port() {
+        return this._server.address().port;
+    }
+    static async new(port = 'auto', host = '127.0.0.1', isDebug = !!process.env.DEBUG) {
+        const server = http.createServer();
+        await new Promise((resolve, reject) => {
+            if (typeof port === 'number') {
+                server.listen(port, host, () => {
+                    resolve();
+                });
+            }
+            else {
+                server.once('error', (error) => {
+                    if (error.code !== 'EADDRINUSE') {
+                        reject(error);
+                        return;
+                    }
+                    server.listen(0, host, () => {
+                        resolve();
+                    });
+                }).listen(9229, host, () => {
+                    resolve();
+                });
+            }
+        });
+        return new NodeWebsocketInspector(server, isDebug);
+    }
+    stop() {
+        this._server.close();
+        this._ws.close();
+    }
+}
+//# sourceMappingURL=inspector.mjs.map