@nimbus-sh/core 0.1.0

package/dist/substrate/lifo/node-compat/http.d.ts

@@ -0,0 +1,133 @@
+import { EventEmitter } from './events.js';
+import { type LoopbackRouter, type VirtualRequestHandler, type VirtualResponse } from '../kernel/index.js';
+/** Extended VirtualResponse with a done promise for async middleware */
+export interface VirtualResponseWithDone extends VirtualResponse {
+    _donePromise?: Promise<void>;
+}
+interface RequestOptions {
+    hostname?: string;
+    host?: string;
+    port?: number | string;
+    path?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+declare class IncomingMessage extends EventEmitter {
+    statusCode: number;
+    statusMessage: string;
+    headers: Record<string, string>;
+    method?: string;
+    url?: string;
+    httpVersion: string;
+    httpVersionMajor: number;
+    httpVersionMinor: number;
+    complete: boolean;
+    aborted: boolean;
+    readable: boolean;
+    socket: {
+        remoteAddress: string;
+        remotePort: number;
+        encrypted: boolean;
+        destroy: () => void;
+    };
+    connection: {
+        remoteAddress: string;
+        encrypted: boolean;
+    };
+    constructor(statusCode: number, statusMessage: string, headers: Record<string, string>);
+    setEncoding(_enc: string): this;
+    resume(): this;
+    pause(): this;
+    destroy(): this;
+}
+declare class ClientRequest extends EventEmitter {
+    private options;
+    private body;
+    private aborted;
+    private portRegistry?;
+    private routeLoopback?;
+    private protocol;
+    constructor(options: RequestOptions, cb?: (res: IncomingMessage) => void, portRegistry?: Map<number, VirtualRequestHandler>, protocol?: 'http:' | 'https:', routeLoopback?: LoopbackRouter);
+    write(data: string): void;
+    end(data?: string): void;
+    abort(): void;
+    private execute;
+    setTimeout(_ms: number, cb?: () => void): this;
+}
+declare class ServerResponse extends EventEmitter {
+    statusCode: number;
+    statusMessage: string;
+    headersSent: boolean;
+    finished: boolean;
+    writableEnded: boolean;
+    writableFinished: boolean;
+    private _headers;
+    private _body;
+    private _vRes;
+    socket: {
+        destroy: () => void;
+        writable: boolean;
+        readable: boolean;
+        remoteAddress: string;
+    } | null;
+    _donePromise: Promise<void>;
+    private _doneResolve;
+    constructor(vRes: {
+        statusCode: number;
+        headers: Record<string, string>;
+        body: string;
+    });
+    writeHead(statusCode: number, reasonOrHeaders?: string | Record<string, string | string[]>, headers?: Record<string, string | string[]>): this;
+    setHeader(name: string, value: string | string[]): this;
+    getHeader(name: string): string | string[] | undefined;
+    getHeaders(): Record<string, string | string[]>;
+    getHeaderNames(): string[];
+    hasHeader(name: string): boolean;
+    removeHeader(name: string): void;
+    appendHeader(name: string, value: string | string[]): this;
+    flushHeaders(): void;
+    write(data: string | Uint8Array): boolean;
+    end(data?: string | Uint8Array | (() => void), _encoding?: string, cb?: () => void): void;
+    cork(): void;
+    uncork(): void;
+}
+export declare const ACTIVE_SERVERS: unique symbol;
+declare class Server extends EventEmitter {
+    private portRegistry;
+    private _port;
+    private _closeResolve;
+    private _promise;
+    private _activeServers;
+    constructor(portRegistry: Map<number, VirtualRequestHandler>, activeServers: Server[], requestHandler?: (req: unknown, res: unknown) => void);
+    listen(port: number, ...rest: unknown[]): this;
+    close(callback?: () => void): this;
+    address(): {
+        port: number;
+        address: string;
+        family: string;
+    } | null;
+    getPromise(): Promise<void> | null;
+}
+export declare function createHttp(portRegistry?: Map<number, VirtualRequestHandler>, protocol?: 'http:' | 'https:', routeLoopback?: LoopbackRouter): {
+    request: (urlOrOptions: string | RequestOptions, optionsOrCb?: RequestOptions | ((res: IncomingMessage) => void), cb?: (res: IncomingMessage) => void) => ClientRequest;
+    get: (urlOrOptions: string | RequestOptions, optionsOrCb?: RequestOptions | ((res: IncomingMessage) => void), cb?: (res: IncomingMessage) => void) => ClientRequest;
+    createServer: (requestHandler?: (req: unknown, res: unknown) => void) => Server;
+    IncomingMessage: typeof IncomingMessage;
+    ClientRequest: typeof ClientRequest;
+    Server: typeof Server;
+    ServerResponse: typeof ServerResponse;
+    [ACTIVE_SERVERS]: Server[];
+};
+export declare function request(urlOrOptions: string | RequestOptions, optionsOrCb?: RequestOptions | ((res: IncomingMessage) => void), cb?: (res: IncomingMessage) => void): ClientRequest;
+export declare function get(urlOrOptions: string | RequestOptions, optionsOrCb?: RequestOptions | ((res: IncomingMessage) => void), cb?: (res: IncomingMessage) => void): ClientRequest;
+export declare function createServer(): never;
+declare const _default: {
+    request: typeof request;
+    get: typeof get;
+    createServer: typeof createServer;
+    IncomingMessage: typeof IncomingMessage;
+    ClientRequest: typeof ClientRequest;
+};
+export default _default;
+//# sourceMappingURL=http.d.ts.map

package/dist/substrate/lifo/node-compat/http.d.ts.map

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

package/dist/substrate/lifo/node-compat/http.js

@@ -0,0 +1,452 @@
+import { EventEmitter } from './events.js';
+import { isLoopbackHost, } from '../kernel/index.js';
+class IncomingMessage extends EventEmitter {
+    statusCode;
+    statusMessage;
+    headers;
+    method;
+    url;
+    httpVersion = '1.1';
+    httpVersionMajor = 1;
+    httpVersionMinor = 1;
+    complete = false;
+    aborted = false;
+    readable = true;
+    // Minimal socket stub that Vite/Connect middleware expects
+    socket;
+    connection;
+    constructor(statusCode, statusMessage, headers) {
+        super();
+        this.statusCode = statusCode;
+        this.statusMessage = statusMessage;
+        this.headers = headers;
+        const socketStub = {
+            remoteAddress: '127.0.0.1',
+            remotePort: 0,
+            encrypted: false,
+            destroy: () => { },
+        };
+        this.socket = socketStub;
+        this.connection = socketStub;
+    }
+    setEncoding(_enc) {
+        return this;
+    }
+    // Stream-like methods that middleware may call
+    resume() {
+        return this;
+    }
+    pause() {
+        return this;
+    }
+    destroy() {
+        this.aborted = true;
+        return this;
+    }
+}
+class ClientRequest extends EventEmitter {
+    options;
+    body = '';
+    aborted = false;
+    portRegistry;
+    routeLoopback;
+    protocol;
+    constructor(options, cb, portRegistry, protocol = 'http:', routeLoopback) {
+        super();
+        this.options = options;
+        this.portRegistry = portRegistry;
+        this.protocol = protocol;
+        this.routeLoopback = routeLoopback;
+        if (cb)
+            this.on('response', cb);
+        // Defer the actual fetch
+        queueMicrotask(() => this.execute());
+    }
+    write(data) {
+        this.body += data;
+    }
+    end(data) {
+        if (data)
+            this.body += data;
+    }
+    abort() {
+        this.aborted = true;
+    }
+    async execute() {
+        if (this.aborted)
+            return;
+        const host = this.options.hostname || this.options.host || 'localhost';
+        const port = this.options.port ? Number(this.options.port) : (this.protocol === 'http:' ? 80 : 443);
+        const path = this.options.path || '/';
+        const loopback = isLoopbackHost(host);
+        // Check if target is a virtual server
+        if (this.portRegistry && loopback) {
+            const handler = this.portRegistry.get(port);
+            if (handler) {
+                const vReq = {
+                    method: this.options.method || 'GET',
+                    url: path,
+                    headers: this.options.headers || {},
+                    body: this.body,
+                };
+                const vRes = {
+                    statusCode: 200,
+                    headers: {},
+                    body: '',
+                };
+                try {
+                    handler(vReq, vRes);
+                    const msg = new IncomingMessage(vRes.statusCode, 'OK', vRes.headers);
+                    this.emit('response', msg);
+                    queueMicrotask(() => {
+                        msg.emit('data', vRes.body);
+                        msg.emit('end');
+                    });
+                }
+                catch (e) {
+                    this.emit('error', e);
+                }
+                return;
+            }
+        }
+        if (loopback) {
+            if (this.routeLoopback) {
+                try {
+                    const method = this.options.method || 'GET';
+                    const hasBody = method !== 'GET' && method !== 'HEAD' && this.body.length > 0;
+                    const response = await this.routeLoopback(port, new Request(`${this.protocol}//${host}:${port}${path}`, {
+                        method,
+                        headers: this.options.headers,
+                        body: hasBody ? this.body : undefined,
+                    }));
+                    if (response) {
+                        const headers = {};
+                        response.headers.forEach((value, key) => { headers[key] = value; });
+                        const msg = new IncomingMessage(response.status, response.statusText, headers);
+                        this.emit('response', msg);
+                        const text = await response.text();
+                        msg.emit('data', text);
+                        msg.emit('end');
+                        return;
+                    }
+                }
+                catch (error) {
+                    this.emit('error', error);
+                    return;
+                }
+            }
+            this.emit('error', new Error(`connect ECONNREFUSED ${host}:${port}`));
+            return;
+        }
+        // Fall through to real fetch
+        const proto = this.protocol.replace(':', ''); // 'http:' -> 'http' or 'https:' -> 'https'
+        const portStr = this.options.port ? `:${this.options.port}` : '';
+        const url = `${proto}://${host}${portStr}${path}`;
+        try {
+            const resp = await fetch(url, {
+                method: this.options.method || 'GET',
+                headers: this.options.headers,
+                body: this.options.method !== 'GET' && this.body ? this.body : undefined,
+            });
+            const headers = {};
+            resp.headers.forEach((v, k) => { headers[k] = v; });
+            const msg = new IncomingMessage(resp.status, resp.statusText, headers);
+            this.emit('response', msg);
+            const text = await resp.text();
+            msg.emit('data', text);
+            msg.emit('end');
+        }
+        catch (e) {
+            this.emit('error', e);
+        }
+    }
+    setTimeout(_ms, cb) {
+        if (cb)
+            this.on('timeout', cb);
+        return this;
+    }
+}
+// --- ServerResponse class ---
+class ServerResponse extends EventEmitter {
+    statusCode = 200;
+    statusMessage = 'OK';
+    headersSent = false;
+    finished = false;
+    writableEnded = false;
+    writableFinished = false;
+    _headers = {};
+    _body = '';
+    _vRes;
+    // Minimal socket stub that middleware may reference
+    socket;
+    // Promise that resolves when end() is called (for async middleware)
+    _donePromise;
+    _doneResolve;
+    constructor(vRes) {
+        super();
+        this._vRes = vRes;
+        this._donePromise = new Promise((resolve) => {
+            this._doneResolve = resolve;
+        });
+        // Socket stub that resolves _donePromise on destroy (error abort path)
+        this.socket = {
+            writable: true,
+            readable: true,
+            remoteAddress: '127.0.0.1',
+            destroy: () => {
+                this.socket.writable = false;
+                if (!this.finished) {
+                    this._vRes.statusCode = this.statusCode || 500;
+                    this._vRes.headers = {};
+                    this._vRes.body = '';
+                    this.finished = true;
+                    this._doneResolve();
+                }
+            },
+        };
+    }
+    writeHead(statusCode, reasonOrHeaders, headers) {
+        this.statusCode = statusCode;
+        let h;
+        if (typeof reasonOrHeaders === 'string') {
+            this.statusMessage = reasonOrHeaders;
+            h = headers;
+        }
+        else {
+            h = reasonOrHeaders;
+        }
+        if (h) {
+            for (const [k, v] of Object.entries(h)) {
+                this._headers[k.toLowerCase()] = v;
+            }
+        }
+        this.headersSent = true;
+        return this;
+    }
+    setHeader(name, value) {
+        this._headers[name.toLowerCase()] = value;
+        return this;
+    }
+    getHeader(name) {
+        return this._headers[name.toLowerCase()];
+    }
+    getHeaders() {
+        return { ...this._headers };
+    }
+    getHeaderNames() {
+        return Object.keys(this._headers);
+    }
+    hasHeader(name) {
+        return name.toLowerCase() in this._headers;
+    }
+    removeHeader(name) {
+        delete this._headers[name.toLowerCase()];
+    }
+    appendHeader(name, value) {
+        const key = name.toLowerCase();
+        const existing = this._headers[key];
+        if (existing === undefined) {
+            this._headers[key] = value;
+        }
+        else if (Array.isArray(existing)) {
+            this._headers[key] = existing.concat(value);
+        }
+        else {
+            this._headers[key] = Array.isArray(value) ? [existing, ...value] : [existing, value];
+        }
+        return this;
+    }
+    flushHeaders() {
+        this.headersSent = true;
+    }
+    write(data) {
+        if (typeof data === 'string') {
+            this._body += data;
+        }
+        else {
+            this._body += new TextDecoder().decode(data);
+        }
+        return true;
+    }
+    end(data, _encoding, cb) {
+        if (typeof data === 'function') {
+            cb = data;
+            data = undefined;
+        }
+        if (typeof data === 'string') {
+            this._body += data;
+        }
+        else if (data instanceof Uint8Array) {
+            this._body += new TextDecoder().decode(data);
+        }
+        this.finished = true;
+        this.writableEnded = true;
+        this.writableFinished = true;
+        // Flatten header arrays to comma-separated strings for the virtual response
+        const flatHeaders = {};
+        for (const [k, v] of Object.entries(this._headers)) {
+            flatHeaders[k] = Array.isArray(v) ? v.join(', ') : v;
+        }
+        // Flush to virtual response
+        this._vRes.statusCode = this.statusCode;
+        this._vRes.headers = flatHeaders;
+        this._vRes.body = this._body;
+        this.headersSent = true;
+        this.emit('finish');
+        this._doneResolve();
+        if (cb)
+            cb();
+    }
+    // Cork/uncork stubs (used by some frameworks)
+    cork() { }
+    uncork() { }
+}
+// --- Server class ---
+// Symbol used to track active server promises on the http module instance
+export const ACTIVE_SERVERS = Symbol.for('lifo.http.activeServers');
+class Server extends EventEmitter {
+    portRegistry;
+    _port = null;
+    _closeResolve = null;
+    _promise = null;
+    _activeServers;
+    constructor(portRegistry, activeServers, requestHandler) {
+        super();
+        this.portRegistry = portRegistry;
+        this._activeServers = activeServers;
+        if (requestHandler) {
+            this.on('request', requestHandler);
+        }
+    }
+    listen(port, ...rest) {
+        let callback;
+        for (const arg of rest) {
+            if (typeof arg === 'function') {
+                callback = arg;
+                break;
+            }
+        }
+        this._port = port;
+        // Create a promise that resolves when server.close() is called
+        this._promise = new Promise((resolve) => {
+            this._closeResolve = resolve;
+        });
+        // Register the handler in portRegistry
+        const handler = (vReq, vRes) => {
+            const req = new IncomingMessage(0, '', vReq.headers);
+            req.method = vReq.method;
+            req.url = vReq.url;
+            const res = new ServerResponse(vRes);
+            // Attach the done promise to vRes so consumers (tunnel, curl) can await async middleware
+            vRes._donePromise = res._donePromise;
+            this.emit('request', req, res);
+            // Emit body data + end so middleware that reads the request body works
+            queueMicrotask(() => {
+                if (vReq.body) {
+                    req.emit('data', vReq.body);
+                }
+                req.complete = true;
+                req.emit('end');
+            });
+        };
+        this.portRegistry.set(port, handler);
+        // Track this server
+        this._activeServers.push(this);
+        // Emit 'listening' event asynchronously (like Node does) and call callback
+        queueMicrotask(() => {
+            this.emit('listening');
+            if (callback)
+                callback();
+        });
+        return this;
+    }
+    close(callback) {
+        if (this._port !== null) {
+            this.portRegistry.delete(this._port);
+        }
+        // Remove from active servers list
+        const idx = this._activeServers.indexOf(this);
+        if (idx !== -1)
+            this._activeServers.splice(idx, 1);
+        if (this._closeResolve) {
+            this._closeResolve();
+            this._closeResolve = null;
+        }
+        if (callback) {
+            queueMicrotask(callback);
+        }
+        this.emit('close');
+        return this;
+    }
+    address() {
+        if (this._port === null)
+            return null;
+        return { port: this._port, address: '127.0.0.1', family: 'IPv4' };
+    }
+    getPromise() {
+        return this._promise;
+    }
+}
+// --- Factory function ---
+export function createHttp(portRegistry, protocol = 'http:', routeLoopback) {
+    // Track active servers created by this http module instance
+    const activeServers = [];
+    function httpRequest(urlOrOptions, optionsOrCb, cb) {
+        let options;
+        let callback;
+        if (typeof urlOrOptions === 'string') {
+            const u = new URL(urlOrOptions);
+            options = {
+                hostname: u.hostname,
+                port: u.port,
+                path: u.pathname + u.search,
+                method: 'GET',
+            };
+            if (typeof optionsOrCb === 'function') {
+                callback = optionsOrCb;
+            }
+            else {
+                options = { ...options, ...optionsOrCb };
+                callback = cb;
+            }
+        }
+        else {
+            options = urlOrOptions;
+            callback = optionsOrCb;
+        }
+        return new ClientRequest(options, callback, portRegistry, protocol, routeLoopback);
+    }
+    function httpGet(urlOrOptions, optionsOrCb, cb) {
+        const req = httpRequest(urlOrOptions, optionsOrCb, cb);
+        req.end();
+        return req;
+    }
+    function httpCreateServer(requestHandler) {
+        if (!portRegistry) {
+            throw new Error('http.createServer() is not supported in Lifo');
+        }
+        return new Server(portRegistry, activeServers, requestHandler);
+    }
+    const mod = {
+        request: httpRequest,
+        get: httpGet,
+        createServer: httpCreateServer,
+        IncomingMessage,
+        ClientRequest,
+        Server,
+        ServerResponse,
+        [ACTIVE_SERVERS]: activeServers,
+    };
+    return mod;
+}
+// --- Legacy static exports (for backward compatibility) ---
+export function request(urlOrOptions, optionsOrCb, cb) {
+    return createHttp().request(urlOrOptions, optionsOrCb, cb);
+}
+export function get(urlOrOptions, optionsOrCb, cb) {
+    return createHttp().get(urlOrOptions, optionsOrCb, cb);
+}
+export function createServer() {
+    throw new Error('http.createServer() is not supported in Lifo');
+}
+export default { request, get, createServer, IncomingMessage, ClientRequest };

package/dist/substrate/lifo/node-compat/index.d.ts

@@ -0,0 +1,20 @@
+import type { VFS } from '../kernel/vfs/index.js';
+import type { CommandOutputStream } from '../commands/types.js';
+import type { LoopbackRouter, VirtualRequestHandler } from '../kernel/index.js';
+export interface NodeContext {
+    vfs: VFS;
+    cwd: string;
+    env: Record<string, string>;
+    stdout: CommandOutputStream;
+    stderr: CommandOutputStream;
+    argv: string[];
+    filename: string;
+    dirname: string;
+    signal: AbortSignal;
+    executeCapture?: (input: string) => Promise<string>;
+    portRegistry?: Map<number, VirtualRequestHandler>;
+    routeLoopback?: LoopbackRouter;
+}
+export declare function createModuleMap(ctx: NodeContext): Record<string, () => unknown>;
+export { ProcessExitError } from './process.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/substrate/lifo/node-compat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/node-compat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAShE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAehF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAiQ/E;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}