@vibecook/truffle 0.4.8 → 0.5.0

package/dist/http.js

@@ -0,0 +1,116 @@
+// node:http interop for the mesh (RFC 021 Phase 2).
+//
+// `mesh.http` lets existing node:http / Express code talk to peers over the
+// mesh with a one-line change. Two directions:
+//
+//   • Outbound: point a request at a peer through a MeshAgent
+//       mesh.http.get('http://100.64.0.7:8080/api/status', (res) => …)
+//       await mesh.http.fetchText('kitchen-pi', 8080, '/api/status')
+//   • Inbound: feed mesh TCP connections into a stock http.Server
+//       const httpServer = http.createServer(app);        // e.g. Express
+//       mesh.net
+//         .createServer((socket) => httpServer.emit('connection', socket))
+//         .listen(8080);
+//
+// Nothing here is mesh-specific beyond the Agent seam: `http.Agent#
+// createConnection` is documented to accept any `stream.Duplex`, and
+// TruffleSocket (see ./net.ts) is one, so node:http drives it exactly like a
+// real net.Socket. The compat shims that make that true live in ./net.ts.
+import http from 'node:http';
+/**
+ * An `http.Agent` that dials its connections over the mesh instead of the
+ * host network. Pass it as `{ agent }` to any `node:http` request and the
+ * request travels to the peer named by the URL hostname (or `options.host`).
+ *
+ * Connection reuse behaves exactly like the stock agent. The default
+ * `keepAlive: false` opens a fresh mesh connection per request and closes it
+ * on response end; `new MeshAgent(net, { keepAlive: true })` pools and reuses
+ * idle sockets like any http.Agent (but see the idle-reaping caveat on
+ * `TruffleSocket.setTimeout` — quiet pooled sockets aren't reaped on a timer).
+ */
+export class MeshAgent extends http.Agent {
+    #net;
+    constructor(net, opts) {
+        super(opts);
+        this.#net = net;
+    }
+    /**
+     * Called by node:http to obtain a socket for a request. Returns a mesh
+     * TruffleSocket (a `stream.Duplex`) synchronously — it connects in the
+     * background and emits `'connect'` later, which is exactly the net.Socket
+     * contract http expects. The callback form is also honoured for robustness
+     * (node uses whichever settles first, once).
+     */
+    createConnection(options, callback) {
+        const socket = this.#net.connect({ host: hostOf(options), port: portOf(options) });
+        if (callback) {
+            const onConnect = () => {
+                socket.removeListener('error', onError);
+                callback(null, socket);
+            };
+            const onError = (err) => {
+                socket.removeListener('connect', onConnect);
+                callback(err, socket);
+            };
+            socket.once('connect', onConnect);
+            socket.once('error', onError);
+        }
+        return socket;
+    }
+}
+/** The peer reference for a request: URL hostname, or `options.host`. */
+function hostOf(options) {
+    // ClientRequest normalises `options.host = hostname || host || 'localhost'`
+    // before the agent sees it; prefer `hostname` explicitly all the same.
+    const host = options.hostname ?? options.host;
+    if (!host)
+        throw new TypeError('mesh.http: request is missing a host (peer reference)');
+    return host;
+}
+function portOf(options) {
+    const port = typeof options.port === 'string' ? Number(options.port) : options.port;
+    return port && Number.isFinite(port) ? port : 80;
+}
+export function createHttpNamespace(net) {
+    const agent = new MeshAgent(net);
+    // Inject the mesh agent unless the caller supplied their own (or `false`).
+    function withAgent(options) {
+        return { ...options, agent: options?.agent ?? agent };
+    }
+    // Normalise node:http's overloads and route through `fn` (request or get).
+    function dispatch(fn, arg1, arg2, arg3) {
+        if (typeof arg2 === 'function' || arg2 === undefined) {
+            // (url|options, callback?) form.
+            if (typeof arg1 === 'string' || arg1 instanceof URL) {
+                return fn(arg1, withAgent(), arg2);
+            }
+            return fn(withAgent(arg1), arg2);
+        }
+        // (url, options, callback?) form.
+        return fn(arg1, withAgent(arg2), arg3);
+    }
+    function request(arg1, arg2, arg3) {
+        return dispatch(http.request, arg1, arg2, arg3);
+    }
+    function get(arg1, arg2, arg3) {
+        return dispatch(http.get, arg1, arg2, arg3);
+    }
+    function fetchText(peer, port, path = '/') {
+        return new Promise((resolve, reject) => {
+            const req = http.request({ host: peer, port, path, method: 'GET', agent }, (res) => {
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(chunk));
+                res.on('end', () => resolve({
+                    status: res.statusCode ?? 0,
+                    headers: res.headers,
+                    body: Buffer.concat(chunks).toString('utf8'),
+                }));
+                res.on('error', reject);
+            });
+            req.on('error', reject);
+            req.end();
+        });
+    }
+    return { agent, Agent: MeshAgent, request, get, fetchText };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,10 @@
-export { NapiNode, NapiFileTransfer, NapiOfferResponder, NapiSyncedStore, } from '@vibecook/truffle-native';
-export type { NapiNodeConfig, NapiNodeIdentity, NapiPeer, NapiPingResult, NapiHealthInfo, NapiPeerEvent, NapiNamespacedMessage, NapiFileOffer, NapiTransferResult, NapiTransferProgress, NapiFileTransferEvent, NapiSlice, NapiStoreEvent, } from '@vibecook/truffle-native';
+export { NapiNode, NapiFileTransfer, NapiOfferResponder, NapiSyncedStore, NapiProxy, NapiTcpSocket, NapiTcpListener, NapiUdpSocket, NapiQuicConnection, NapiQuicListener, NapiQuicStream, } from '@vibecook/truffle-native';
+export type { NapiNodeConfig, NapiNodeIdentity, NapiPeer, NapiPingResult, NapiHealthInfo, NapiPeerEvent, NapiNamespacedMessage, NapiFileOffer, NapiTransferResult, NapiTransferProgress, NapiFileTransferEvent, NapiSlice, NapiStoreEvent, NapiProxyConfig, NapiProxyInfo, NapiProxyEvent, NapiDatagram, } from '@vibecook/truffle-native';
 export { resolveSidecarPath } from './sidecar.js';
-export { createMeshNode, type CreateMeshNodeOptions } from './create-mesh-node.js';
+export { TruffleSocket, TruffleServer, createNetNamespace, type TruffleNet, type NetConnectOptions, type ConnectionListener, } from './net.js';
+export { MeshAgent, createHttpNamespace, type TruffleHttp } from './http.js';
+export { TruffleQuicStream, TruffleQuicConnection, TruffleQuicServer, createQuicNamespace, type TruffleQuic, } from './quic.js';
+export { TruffleDgramSocket, createDgramNamespace, type TruffleDgram, type TruffleRemoteInfo, } from './dgram.js';
+export { createWsNamespace, type TruffleWs, type TruffleWsServer, type TruffleWsServerOptions, type WsLoader, } from './ws.js';
+export { createMeshNode, type CreateMeshNodeOptions, type MeshNode } from './create-mesh-node.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,7 +1,17 @@
 // Re-export classes (values) from the native Rust addon
-export { NapiNode, NapiFileTransfer, NapiOfferResponder, NapiSyncedStore, } from '@vibecook/truffle-native';
+export { NapiNode, NapiFileTransfer, NapiOfferResponder, NapiSyncedStore, NapiProxy, NapiTcpSocket, NapiTcpListener, NapiUdpSocket, NapiQuicConnection, NapiQuicListener, NapiQuicStream, } from '@vibecook/truffle-native';
 // Sidecar binary resolution
 export { resolveSidecarPath } from './sidecar.js';
+// node:net-shaped raw TCP API over the mesh (RFC 021)
+export { TruffleSocket, TruffleServer, createNetNamespace, } from './net.js';
+// node:http interop over the mesh (RFC 021)
+export { MeshAgent, createHttpNamespace } from './http.js';
+// QUIC over the mesh (RFC 021)
+export { TruffleQuicStream, TruffleQuicConnection, TruffleQuicServer, createQuicNamespace, } from './quic.js';
+// node:dgram-shaped raw UDP API over the mesh (RFC 021)
+export { TruffleDgramSocket, createDgramNamespace, } from './dgram.js';
+// WebSocket over the mesh via the `ws` package (RFC 021)
+export { createWsNamespace, } from './ws.js';
 // High-level API
 export { createMeshNode } from './create-mesh-node.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAmBlC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAA8B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAuBlC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,sDAAsD;AACtD,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,GAInB,MAAM,UAAU,CAAC;AAElB,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAoB,MAAM,WAAW,CAAC;AAE7E,+BAA+B;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,wDAAwD;AACxD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,OAAO,EACL,iBAAiB,GAKlB,MAAM,SAAS,CAAC;AAEjB,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAA6C,MAAM,uBAAuB,CAAC"}

package/dist/net.d.ts

@@ -0,0 +1,111 @@
+import { Duplex } from 'node:stream';
+import { EventEmitter } from 'node:events';
+import type { NapiNode, NapiTcpSocket } from '@vibecook/truffle-native';
+export interface NetConnectOptions {
+    /**
+     * Peer to connect to: device id (or unique ≥4-char prefix), device
+     * name, Tailscale hostname, or Tailscale IP.
+     */
+    host: string;
+    /** Port on the peer. */
+    port: number;
+}
+export type ConnectionListener = (socket: TruffleSocket) => void;
+/**
+ * A TCP connection over the mesh, as a standard `stream.Duplex`.
+ *
+ * Mirrors `net.Socket` semantics where it matters: `'connect'`/`'ready'`
+ * on establishment, `end()` half-closes (FIN) while reads continue,
+ * `'end'` on peer EOF, `destroy()` tears down both directions.
+ */
+export declare class TruffleSocket extends Duplex {
+    #private;
+    /** Logical remote address (`host:port`); set once connected. */
+    remoteAddress?: string;
+    /** Stable peer id (resolved device id, or WhoIs node id inbound) when known. */
+    remotePeerId?: string;
+    /** Human-readable peer name from the WhoIs identity (inbound sockets). */
+    remotePeerName?: string;
+    constructor(native: NapiTcpSocket | Promise<NapiTcpSocket>);
+    _read(size: number): void;
+    _write(chunk: Buffer, _encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
+    _final(callback: (error?: Error | null) => void): void;
+    _destroy(error: Error | null, callback: (error: Error | null) => void): void;
+    /** net.Socket#timeout, as recorded by {@link setTimeout}. */
+    timeout: number;
+    /**
+     * net.Socket#setTimeout. Records the value and, like net.Socket, wires an
+     * optional one-shot `'timeout'` listener (and clears it when `msecs` is 0).
+     *
+     * Caveat: the mesh bridge doesn't surface socket idle activity to JS
+     * without forcing the readable side into flowing mode (which would defeat
+     * the pull-model backpressure), so no idle timer is armed and `'timeout'`
+     * never fires on its own — enforce inactivity limits at the app layer if
+     * you need them. http's default server timeout is 0 (disabled) and the
+     * default agent is `keepAlive: false`, so this is inert on the common
+     * paths and exists so calling code doesn't throw. Never auto-destroys the
+     * socket, matching net.Socket.
+     */
+    setTimeout(msecs: number, callback?: () => void): this;
+    /** net.Socket#setNoDelay — no-op: Nagle doesn't apply to the mesh bridge. */
+    setNoDelay(_noDelay?: boolean): this;
+    /** net.Socket#setKeepAlive — no-op: the bridge has no TCP keepalive to set. */
+    setKeepAlive(_enable?: boolean, _initialDelay?: number): this;
+    /** net.Socket#ref — no-op: no libuv handle backs a mesh socket. */
+    ref(): this;
+    /** net.Socket#unref — no-op (see {@link ref}). */
+    unref(): this;
+    /** net.Socket#address — mesh sockets have no local IP/port; returns `{}`. */
+    address(): {
+        address?: string;
+        family?: string;
+        port?: number;
+    };
+}
+/**
+ * A TCP server on the mesh, mimicking `net.Server`.
+ *
+ * Events: `'listening'`, `'connection'` ([`TruffleSocket`]), `'close'`,
+ * `'error'`. To serve HTTP over the mesh:
+ *
+ * ```ts
+ * const httpServer = http.createServer(app);
+ * mesh.net
+ *   .createServer((socket) => httpServer.emit('connection', socket))
+ *   .listen(8080);
+ * ```
+ */
+export declare class TruffleServer extends EventEmitter {
+    #private;
+    /** Bound port; set once `'listening'` fires (resolved when 0 was requested). */
+    port?: number;
+    constructor(node: NapiNode, connectionListener?: ConnectionListener);
+    /**
+     * Start listening on `port` (0 = ephemeral; read `server.port` after
+     * `'listening'`). Returns `this`, like `net.Server#listen`.
+     */
+    listen(port: number, listeningListener?: () => void): this;
+    /** `net.Server#address` compat (port only — mesh listeners have no local IP). */
+    address(): {
+        port: number;
+    } | null;
+    /**
+     * Stop accepting connections and release the port. `callback` fires on
+     * `'close'` — including when the server already closed (e.g. the accept
+     * loop ended on its own after a mesh teardown), like `net.Server#close`.
+     */
+    close(callback?: () => void): this;
+}
+/** node:net-shaped namespace bound to a mesh node. */
+export interface TruffleNet {
+    /** Open a connection to a peer. Returns the socket immediately; it emits `'connect'`. */
+    connect(options: NetConnectOptions): TruffleSocket;
+    connect(port: number, host: string): TruffleSocket;
+    /** Alias of `connect`, mirroring `net.createConnection`. */
+    createConnection(options: NetConnectOptions): TruffleSocket;
+    createConnection(port: number, host: string): TruffleSocket;
+    /** Create a server; call `.listen(port)` to bind, like `net.createServer`. */
+    createServer(connectionListener?: ConnectionListener): TruffleServer;
+}
+export declare function createNetNamespace(node: NapiNode): TruffleNet;
+//# sourceMappingURL=net.d.ts.map

package/dist/net.d.ts.map

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

package/dist/net.js

@@ -0,0 +1,271 @@
+// node:net-shaped API over truffle's raw TCP transport (RFC 021 Phase 2).
+//
+// TruffleSocket is a real stream.Duplex, so everything that accepts a
+// Node socket-ish duplex works over the mesh: piping,
+// `httpServer.emit('connection', socket)`, `http.Agent#createConnection`,
+// the `ws` package via a custom agent, undici's `connect`, etc.
+//
+// Backpressure comes from the pull-model native handle: `_read` awaits one
+// native `read()` at a time, `_write` resolves when the transport accepted
+// the bytes.
+import { Duplex } from 'node:stream';
+import { EventEmitter } from 'node:events';
+/**
+ * A TCP connection over the mesh, as a standard `stream.Duplex`.
+ *
+ * Mirrors `net.Socket` semantics where it matters: `'connect'`/`'ready'`
+ * on establishment, `end()` half-closes (FIN) while reads continue,
+ * `'end'` on peer EOF, `destroy()` tears down both directions.
+ */
+export class TruffleSocket extends Duplex {
+    #native = null;
+    #ready;
+    #reading = false;
+    /** Logical remote address (`host:port`); set once connected. */
+    remoteAddress;
+    /** Stable peer id (resolved device id, or WhoIs node id inbound) when known. */
+    remotePeerId;
+    /** Human-readable peer name from the WhoIs identity (inbound sockets). */
+    remotePeerName;
+    constructor(native) {
+        super({ allowHalfOpen: true });
+        const adopt = (sock) => {
+            this.#native = sock;
+            this.remoteAddress = sock.remoteAddress();
+            this.remotePeerId = sock.remotePeerId() ?? undefined;
+            this.remotePeerName = sock.remotePeerName() ?? undefined;
+            return sock;
+        };
+        if (typeof native.then === 'function') {
+            // Outbound: the dial is in flight; metadata lands on 'connect'.
+            this.#ready = Promise.resolve(native).then((sock) => {
+                adopt(sock);
+                this.emit('connect');
+                this.emit('ready');
+                return sock;
+            });
+            // A failed dial destroys the socket with the error, like net.Socket.
+            this.#ready.catch((err) => this.destroy(err));
+        }
+        else {
+            // Inbound (accept-path) sockets are already connected: set the peer
+            // metadata synchronously so a 'connection' handler can read
+            // remotePeerId/remotePeerName immediately for accept-time gating.
+            // The events still fire asynchronously — constructor-time emits
+            // would have no listeners yet.
+            const sock = adopt(native);
+            this.#ready = Promise.resolve(sock);
+            queueMicrotask(() => {
+                if (!this.destroyed) {
+                    this.emit('connect');
+                    this.emit('ready');
+                }
+            });
+        }
+    }
+    _read(size) {
+        if (this.#reading)
+            return;
+        this.#reading = true;
+        this.#ready
+            .then((sock) => sock.read(size > 0 ? size : undefined))
+            .then((chunk) => {
+            this.#reading = false;
+            this.push(chunk);
+        })
+            .catch((err) => {
+            this.#reading = false;
+            this.destroy(err);
+        });
+    }
+    _write(chunk, _encoding, callback) {
+        this.#ready.then((sock) => sock.write(chunk).then(() => callback(null), callback), callback);
+    }
+    _final(callback) {
+        this.#ready.then((sock) => sock.end().then(() => callback(null), callback), callback);
+    }
+    _destroy(error, callback) {
+        const finish = () => callback(error);
+        if (this.#native) {
+            this.#native.close().then(finish, finish);
+        }
+        else {
+            // Dial still in flight — close the socket when (if) it lands.
+            this.#ready.then((sock) => sock.close()).catch(() => { });
+            finish();
+        }
+    }
+    // ─── net.Socket compat shims (RFC 021) ────────────────────────────────
+    // node:http's client and server hand their sockets a few net.Socket-only
+    // methods (setTimeout/setNoDelay/setKeepAlive/ref/unref/address). A plain
+    // Duplex doesn't have them, so without these `http.request(...)` and
+    // `httpServer.emit('connection', socket)` throw on the missing method.
+    // The mesh data path is a loopback hop with no Nagle, no SO_KEEPALIVE and
+    // no local IP/port, so these are well-behaved no-ops that return `this`
+    // (net.Socket's chainable contract) — enough to satisfy node:http.
+    /** net.Socket#timeout, as recorded by {@link setTimeout}. */
+    timeout = 0;
+    /**
+     * net.Socket#setTimeout. Records the value and, like net.Socket, wires an
+     * optional one-shot `'timeout'` listener (and clears it when `msecs` is 0).
+     *
+     * Caveat: the mesh bridge doesn't surface socket idle activity to JS
+     * without forcing the readable side into flowing mode (which would defeat
+     * the pull-model backpressure), so no idle timer is armed and `'timeout'`
+     * never fires on its own — enforce inactivity limits at the app layer if
+     * you need them. http's default server timeout is 0 (disabled) and the
+     * default agent is `keepAlive: false`, so this is inert on the common
+     * paths and exists so calling code doesn't throw. Never auto-destroys the
+     * socket, matching net.Socket.
+     */
+    setTimeout(msecs, callback) {
+        this.timeout = msecs;
+        if (callback) {
+            if (msecs === 0)
+                this.removeListener('timeout', callback);
+            else
+                this.once('timeout', callback);
+        }
+        return this;
+    }
+    /** net.Socket#setNoDelay — no-op: Nagle doesn't apply to the mesh bridge. */
+    setNoDelay(_noDelay) {
+        return this;
+    }
+    /** net.Socket#setKeepAlive — no-op: the bridge has no TCP keepalive to set. */
+    setKeepAlive(_enable, _initialDelay) {
+        return this;
+    }
+    /** net.Socket#ref — no-op: no libuv handle backs a mesh socket. */
+    ref() {
+        return this;
+    }
+    /** net.Socket#unref — no-op (see {@link ref}). */
+    unref() {
+        return this;
+    }
+    /** net.Socket#address — mesh sockets have no local IP/port; returns `{}`. */
+    address() {
+        return {};
+    }
+}
+/**
+ * A TCP server on the mesh, mimicking `net.Server`.
+ *
+ * Events: `'listening'`, `'connection'` ([`TruffleSocket`]), `'close'`,
+ * `'error'`. To serve HTTP over the mesh:
+ *
+ * ```ts
+ * const httpServer = http.createServer(app);
+ * mesh.net
+ *   .createServer((socket) => httpServer.emit('connection', socket))
+ *   .listen(8080);
+ * ```
+ */
+export class TruffleServer extends EventEmitter {
+    #node;
+    #listener = null;
+    #closed = false;
+    #closeEmitted = false;
+    /** Bound port; set once `'listening'` fires (resolved when 0 was requested). */
+    port;
+    constructor(node, connectionListener) {
+        super();
+        this.#node = node;
+        if (connectionListener)
+            this.on('connection', connectionListener);
+    }
+    /**
+     * Start listening on `port` (0 = ephemeral; read `server.port` after
+     * `'listening'`). Returns `this`, like `net.Server#listen`.
+     */
+    listen(port, listeningListener) {
+        if (this.#listener)
+            throw new Error('listen() already called');
+        if (listeningListener)
+            this.once('listening', listeningListener);
+        this.#node
+            .listenTcp(port)
+            .then((listener) => {
+            if (this.#closed) {
+                void listener.close();
+                return;
+            }
+            this.#listener = listener;
+            this.port = listener.port();
+            this.emit('listening');
+            void this.#acceptLoop(listener);
+        })
+            .catch((err) => this.emit('error', err));
+        return this;
+    }
+    async #acceptLoop(listener) {
+        try {
+            for (;;) {
+                const native = await listener.accept();
+                if (native === null)
+                    break;
+                this.emit('connection', new TruffleSocket(native));
+            }
+        }
+        catch (err) {
+            if (!this.#closed)
+                this.emit('error', err);
+        }
+        this.#emitClose();
+    }
+    #emitClose() {
+        if (this.#closeEmitted)
+            return;
+        this.#closeEmitted = true;
+        this.emit('close');
+    }
+    /** `net.Server#address` compat (port only — mesh listeners have no local IP). */
+    address() {
+        return this.port === undefined ? null : { port: this.port };
+    }
+    /**
+     * Stop accepting connections and release the port. `callback` fires on
+     * `'close'` — including when the server already closed (e.g. the accept
+     * loop ended on its own after a mesh teardown), like `net.Server#close`.
+     */
+    close(callback) {
+        if (callback) {
+            if (this.#closeEmitted)
+                queueMicrotask(callback);
+            else
+                this.once('close', callback);
+        }
+        if (this.#closed)
+            return this;
+        this.#closed = true;
+        const listener = this.#listener;
+        this.#listener = null;
+        if (listener) {
+            // accept() resolves null → the loop exits and emits 'close' (unless
+            // the loop already ended on its own — then 'close' already fired and
+            // this just releases the native listener).
+            void listener.close();
+        }
+        else {
+            this.#emitClose();
+        }
+        return this;
+    }
+}
+export function createNetNamespace(node) {
+    function connect(optionsOrPort, maybeHost) {
+        const { host, port } = typeof optionsOrPort === 'number'
+            ? { host: maybeHost ?? '', port: optionsOrPort }
+            : optionsOrPort;
+        if (!host)
+            throw new TypeError('connect: host (peer) is required');
+        return new TruffleSocket(node.openTcp(host, port));
+    }
+    return {
+        connect,
+        createConnection: connect,
+        createServer: (connectionListener) => new TruffleServer(node, connectionListener),
+    };
+}
+//# sourceMappingURL=net.js.map

package/dist/net.js.map

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