@labostack/typebridge 0.1.0

package/dist/transport/framing.d.ts

@@ -0,0 +1,54 @@
+import { type MessageType, FrameFlags } from "./constants.js";
+/**
+ * A parsed frame from the wire.
+ *
+ * Frame layout (Little-Endian, 13 bytes header):
+ * [Magic 2B][Version 1B][Flags 1B][PayloadLen 4B][ReqID 4B][MsgType 1B][Payload...]
+ */
+export interface Frame {
+    /** Protocol version */
+    version: number;
+    /** Frame flags (compression, final, etc.) */
+    flags: FrameFlags;
+    /** Request ID for multiplexing (multiple in-flight requests on one connection) */
+    requestId: number;
+    /** Message type (Request, Response, Error, Handshake, etc.) */
+    messageType: MessageType;
+    /** Raw payload bytes (MessagePack-encoded) */
+    payload: Buffer;
+}
+/**
+ * Encode a Frame into a binary buffer ready for the wire.
+ */
+export declare function encodeFrame(frame: Frame): Buffer;
+/**
+ * Result of attempting to decode a frame from a buffer.
+ */
+export interface DecodeResult {
+    /** The decoded frame, or null if buffer doesn't contain a complete frame */
+    frame: Frame | null;
+    /** Number of bytes consumed from the buffer */
+    bytesConsumed: number;
+}
+/**
+ * Attempt to decode a single frame from a buffer.
+ *
+ * Returns null frame if the buffer doesn't contain a complete frame yet
+ * (partial read — need to wait for more data).
+ */
+export declare function decodeFrame(buffer: Buffer): DecodeResult;
+/**
+ * FrameReader accumulates data from TCP chunks and yields complete frames.
+ * Handles partial reads gracefully (TCP can deliver data in arbitrary chunks).
+ */
+export declare class FrameReader {
+    private buffer;
+    /**
+     * Feed raw TCP data into the reader.
+     * Returns an array of complete frames parsed from the accumulated buffer.
+     */
+    feed(data: Buffer): Frame[];
+    /** Reset the internal buffer */
+    reset(): void;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/transport/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/transport/framing.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CA4BhD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAyDxD;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE;IAmB3B,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAGd"}

package/dist/transport/framing.js

@@ -0,0 +1,107 @@
+import { FRAME_MAGIC, FRAME_HEADER_SIZE, } from "./constants.js";
+/**
+ * Encode a Frame into a binary buffer ready for the wire.
+ */
+export function encodeFrame(frame) {
+    const header = Buffer.alloc(FRAME_HEADER_SIZE);
+    let offset = 0;
+    // Magic (2 bytes, Big-Endian for readability in hex dumps)
+    header.writeUInt16BE(FRAME_MAGIC, offset);
+    offset += 2;
+    // Version (1 byte)
+    header.writeUInt8(frame.version, offset);
+    offset += 1;
+    // Flags (1 byte)
+    header.writeUInt8(frame.flags, offset);
+    offset += 1;
+    // Payload length (4 bytes, Little-Endian)
+    header.writeUInt32LE(frame.payload.length, offset);
+    offset += 4;
+    // Request ID (4 bytes, Little-Endian)
+    header.writeUInt32LE(frame.requestId, offset);
+    offset += 4;
+    // Message type (1 byte)
+    header.writeUInt8(frame.messageType, offset);
+    return Buffer.concat([header, frame.payload]);
+}
+/**
+ * Attempt to decode a single frame from a buffer.
+ *
+ * Returns null frame if the buffer doesn't contain a complete frame yet
+ * (partial read — need to wait for more data).
+ */
+export function decodeFrame(buffer) {
+    // Not enough bytes for header
+    if (buffer.length < FRAME_HEADER_SIZE) {
+        return { frame: null, bytesConsumed: 0 };
+    }
+    let offset = 0;
+    // Validate magic
+    const magic = buffer.readUInt16BE(offset);
+    offset += 2;
+    if (magic !== FRAME_MAGIC) {
+        throw new Error(`Invalid frame magic: expected 0x${FRAME_MAGIC.toString(16)}, got 0x${magic.toString(16)}`);
+    }
+    // Version
+    const version = buffer.readUInt8(offset);
+    offset += 1;
+    // Flags
+    const flags = buffer.readUInt8(offset);
+    offset += 1;
+    // Payload length
+    const payloadLength = buffer.readUInt32LE(offset);
+    offset += 4;
+    // Request ID
+    const requestId = buffer.readUInt32LE(offset);
+    offset += 4;
+    // Message type
+    const messageType = buffer.readUInt8(offset);
+    offset += 1;
+    // Check if we have the full payload
+    const totalFrameSize = FRAME_HEADER_SIZE + payloadLength;
+    if (buffer.length < totalFrameSize) {
+        return { frame: null, bytesConsumed: 0 };
+    }
+    // Extract payload
+    const payload = buffer.subarray(FRAME_HEADER_SIZE, totalFrameSize);
+    return {
+        frame: {
+            version,
+            flags,
+            requestId,
+            messageType,
+            payload: Buffer.from(payload), // copy to avoid buffer reuse issues
+        },
+        bytesConsumed: totalFrameSize,
+    };
+}
+/**
+ * FrameReader accumulates data from TCP chunks and yields complete frames.
+ * Handles partial reads gracefully (TCP can deliver data in arbitrary chunks).
+ */
+export class FrameReader {
+    buffer = Buffer.alloc(0);
+    /**
+     * Feed raw TCP data into the reader.
+     * Returns an array of complete frames parsed from the accumulated buffer.
+     */
+    feed(data) {
+        this.buffer = Buffer.concat([this.buffer, data]);
+        const frames = [];
+        while (this.buffer.length >= FRAME_HEADER_SIZE) {
+            const result = decodeFrame(this.buffer);
+            if (result.frame === null) {
+                // Incomplete frame — wait for more data
+                break;
+            }
+            frames.push(result.frame);
+            this.buffer = this.buffer.subarray(result.bytesConsumed);
+        }
+        return frames;
+    }
+    /** Reset the internal buffer */
+    reset() {
+        this.buffer = Buffer.alloc(0);
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/transport/framing.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,7 @@
+export { TransportServer, type TransportServerOptions } from "./server.js";
+export { TransportClient, type TransportClientOptions } from "./client.js";
+export { Connection } from "./connection.js";
+export { PeerManager, PeerConnection } from "./peer-manager.js";
+export { encodeFrame, decodeFrame, FrameReader, type Frame, type DecodeResult, } from "./framing.js";
+export { FRAME_MAGIC, PROTOCOL_VERSION, FRAME_HEADER_SIZE, MessageType, FrameFlags, } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,KAAK,KAAK,EACV,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,7 @@
+export { TransportServer } from "./server.js";
+export { TransportClient } from "./client.js";
+export { Connection } from "./connection.js";
+export { PeerManager, PeerConnection } from "./peer-manager.js";
+export { encodeFrame, decodeFrame, FrameReader, } from "./framing.js";
+export { FRAME_MAGIC, PROTOCOL_VERSION, FRAME_HEADER_SIZE, MessageType, FrameFlags, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,GAGZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/transport/peer-manager.d.ts

@@ -0,0 +1,67 @@
+import { EventEmitter } from "node:events";
+import type { Connection } from "./connection.js";
+import type { MethodRegistry } from "../registry/method-registry.js";
+import type { PeerTarget } from "../types/options.js";
+/**
+ * Manages outbound peer connections with:
+ * - Lazy connect (no network call until first RPC)
+ * - Retry with exponential backoff
+ * - Auto-reconnect on drop
+ * - Connection caching
+ */
+export declare class PeerManager {
+    /** Local registry — so incoming requests on peer connections can be handled */
+    private readonly localRegistry;
+    /** Local node name — sent during handshake */
+    private readonly localName;
+    private peers;
+    constructor(
+    /** Local registry — so incoming requests on peer connections can be handled */
+    localRegistry: MethodRegistry, 
+    /** Local node name — sent during handshake */
+    localName: string);
+    /**
+     * Get or create a PeerConnection for a given target.
+     */
+    getPeer(nameOrOptions: string | PeerTarget): PeerConnection;
+    /**
+     * Close all peer connections.
+     */
+    closeAll(): Promise<void>;
+}
+/**
+ * A single peer connection with retry logic.
+ */
+export declare class PeerConnection extends EventEmitter {
+    private readonly target;
+    private readonly localRegistry;
+    private readonly localName;
+    private connection;
+    private connectingPromise;
+    private client;
+    private closed;
+    /** Backoff config */
+    private readonly minDelay;
+    private readonly maxDelay;
+    private readonly backoffFactor;
+    constructor(target: string | PeerTarget, localRegistry: MethodRegistry, localName: string);
+    /**
+     * Ensure a connection is established.
+     * If not connected, connects with retry + exponential backoff.
+     * Returns the active connection.
+     */
+    ensureConnected(): Promise<Connection>;
+    /**
+     * Connect with exponential backoff retry.
+     */
+    private connectWithRetry;
+    /**
+     * Single connection attempt.
+     */
+    private doConnect;
+    /**
+     * Close this peer connection.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=peer-manager.d.ts.map

package/dist/transport/peer-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-manager.d.ts","sourceRoot":"","sources":["../../src/transport/peer-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,WAAW;IAIpB,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,KAAK,CAAqC;;IAGhD,+EAA+E;IAC9D,aAAa,EAAE,cAAc;IAC9C,8CAA8C;IAC7B,SAAS,EAAE,MAAM;IAGpC;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc;IAa3D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAY5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAS;IAEvB,qBAAqB;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAK;gBAGhB,MAAM,EAAE,MAAM,GAAG,UAAU,EAC3B,aAAa,EAAE,cAAc,EAC7B,SAAS,EAAE,MAAM;IAKpC;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IA0B5C;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;YACW,SAAS;IAmDvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/transport/peer-manager.js

@@ -0,0 +1,172 @@
+import { EventEmitter } from "node:events";
+import { TransportClient } from "./client.js";
+import { resolveService } from "../discovery/resolver.js";
+/**
+ * Manages outbound peer connections with:
+ * - Lazy connect (no network call until first RPC)
+ * - Retry with exponential backoff
+ * - Auto-reconnect on drop
+ * - Connection caching
+ */
+export class PeerManager {
+    localRegistry;
+    localName;
+    peers = new Map();
+    constructor(
+    /** Local registry — so incoming requests on peer connections can be handled */
+    localRegistry, 
+    /** Local node name — sent during handshake */
+    localName) {
+        this.localRegistry = localRegistry;
+        this.localName = localName;
+    }
+    /**
+     * Get or create a PeerConnection for a given target.
+     */
+    getPeer(nameOrOptions) {
+        const key = typeof nameOrOptions === "string"
+            ? nameOrOptions
+            : `${nameOrOptions.host}:${nameOrOptions.port}`;
+        let peer = this.peers.get(key);
+        if (!peer) {
+            peer = new PeerConnection(nameOrOptions, this.localRegistry, this.localName);
+            this.peers.set(key, peer);
+        }
+        return peer;
+    }
+    /**
+     * Close all peer connections.
+     */
+    async closeAll() {
+        const closeTasks = Array.from(this.peers.values()).map((p) => p.close());
+        await Promise.allSettled(closeTasks);
+        this.peers.clear();
+    }
+}
+/**
+ * A single peer connection with retry logic.
+ */
+export class PeerConnection extends EventEmitter {
+    target;
+    localRegistry;
+    localName;
+    connection = null;
+    connectingPromise = null;
+    client = null;
+    closed = false;
+    /** Backoff config */
+    minDelay = 100;
+    maxDelay = 5000;
+    backoffFactor = 2;
+    constructor(target, localRegistry, localName) {
+        super();
+        this.target = target;
+        this.localRegistry = localRegistry;
+        this.localName = localName;
+    }
+    /**
+     * Ensure a connection is established.
+     * If not connected, connects with retry + exponential backoff.
+     * Returns the active connection.
+     */
+    async ensureConnected() {
+        if (this.closed) {
+            throw new Error("PeerConnection is closed");
+        }
+        // Already connected and socket is alive
+        if (this.connection && !this.connection.isClosed) {
+            return this.connection;
+        }
+        // Another caller is already connecting — wait for it
+        if (this.connectingPromise) {
+            return this.connectingPromise;
+        }
+        // Start a new connection attempt
+        this.connectingPromise = this.connectWithRetry();
+        try {
+            const conn = await this.connectingPromise;
+            return conn;
+        }
+        finally {
+            this.connectingPromise = null;
+        }
+    }
+    /**
+     * Connect with exponential backoff retry.
+     */
+    async connectWithRetry() {
+        let delay = this.minDelay;
+        let attempt = 0;
+        while (!this.closed) {
+            try {
+                return await this.doConnect();
+            }
+            catch (err) {
+                attempt++;
+                if (this.closed) {
+                    throw new Error("PeerConnection closed during connect");
+                }
+                // Wait with exponential backoff
+                await new Promise((r) => setTimeout(r, delay));
+                delay = Math.min(delay * this.backoffFactor, this.maxDelay);
+            }
+        }
+        throw new Error("PeerConnection closed");
+    }
+    /**
+     * Single connection attempt.
+     */
+    async doConnect() {
+        // Resolve the target
+        const resolved = await resolveService(this.target);
+        // Create client and connect
+        this.client = new TransportClient({
+            host: resolved.host,
+            port: resolved.port,
+        });
+        const connection = await this.client.connect();
+        // Send handshake with our name
+        connection.sendHandshake({ name: this.localName, version: 1 });
+        // Wait for handshake ack
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error("Handshake timeout"));
+            }, 10_000);
+            connection.on("handshake-ack", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+        // Wire incoming requests (bidirectional: peer can call our methods too)
+        connection.on("request", async (reqId, method, args) => {
+            try {
+                const [controllerName, methodName] = method.split(".");
+                if (!controllerName || !methodName) {
+                    throw new Error(`Invalid method format: "${method}"`);
+                }
+                const result = await this.localRegistry.invoke(controllerName, methodName, args);
+                connection.sendResponse(reqId, result);
+            }
+            catch (error) {
+                connection.sendError(reqId, error);
+            }
+        });
+        // Handle disconnection — clear connection so next call reconnects
+        connection.on("close", () => {
+            this.connection = null;
+        });
+        this.connection = connection;
+        this.emit("connected", connection);
+        return connection;
+    }
+    /**
+     * Close this peer connection.
+     */
+    async close() {
+        this.closed = true;
+        this.client?.close();
+        this.connection = null;
+        this.client = null;
+    }
+}
+//# sourceMappingURL=peer-manager.js.map

package/dist/transport/peer-manager.js.map

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

package/dist/transport/server.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from "node:events";
+import type { Serializer } from "../serialization/serializer.js";
+export interface TransportServerOptions {
+    /** Port to listen on. 0 = auto-assign. Default: 4242 */
+    port?: number;
+    /** Host to bind to. Default: "0.0.0.0" */
+    host?: string;
+    /** Serializer to use. Default: MsgPackSerializer */
+    serializer?: Serializer;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+}
+/**
+ * TCP transport server — listens for incoming connections and handles RPC.
+ */
+export declare class TransportServer extends EventEmitter {
+    private server;
+    private readonly connections;
+    private readonly serializer;
+    private readonly serverPort;
+    private readonly serverHost;
+    private readonly timeout;
+    private actualPort;
+    constructor(options?: TransportServerOptions);
+    /** The port the server is actually listening on (resolved after listen()) */
+    get port(): number;
+    /**
+     * Start listening for connections.
+     */
+    listen(): Promise<void>;
+    /**
+     * Gracefully close the server and all connections.
+     */
+    close(): Promise<void>;
+    private handleConnection;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/transport/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/transport/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAIjE,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,GAAE,sBAA2B;IAQhD,6EAA6E;IAC7E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,OAAO,CAAC,gBAAgB;CAuBzB"}

package/dist/transport/server.js

@@ -0,0 +1,88 @@
+import { createServer } from "node:net";
+import { EventEmitter } from "node:events";
+import { Connection } from "./connection.js";
+import { MsgPackSerializer } from "../serialization/msgpack.js";
+import { DEFAULT_PORT } from "../types/options.js";
+/**
+ * TCP transport server — listens for incoming connections and handles RPC.
+ */
+export class TransportServer extends EventEmitter {
+    server = null;
+    connections = new Set();
+    serializer;
+    serverPort;
+    serverHost;
+    timeout;
+    actualPort = 0;
+    constructor(options = {}) {
+        super();
+        this.serializer = options.serializer ?? new MsgPackSerializer();
+        this.serverPort = options.port ?? DEFAULT_PORT;
+        this.serverHost = options.host ?? "0.0.0.0";
+        this.timeout = options.timeout ?? 30_000;
+    }
+    /** The port the server is actually listening on (resolved after listen()) */
+    get port() {
+        return this.actualPort;
+    }
+    /**
+     * Start listening for connections.
+     */
+    async listen() {
+        return new Promise((resolve, reject) => {
+            this.server = createServer((socket) => {
+                this.handleConnection(socket);
+            });
+            this.server.on("error", (err) => {
+                this.emit("error", err);
+                reject(err);
+            });
+            this.server.listen(this.serverPort, this.serverHost, () => {
+                const addr = this.server.address();
+                if (addr && typeof addr === "object") {
+                    this.actualPort = addr.port;
+                }
+                this.emit("listening", this.actualPort);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Gracefully close the server and all connections.
+     */
+    async close() {
+        // Close all active connections
+        for (const conn of this.connections) {
+            conn.close();
+        }
+        this.connections.clear();
+        // Close the server
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    handleConnection(socket) {
+        const connection = new Connection(socket, this.serializer, this.timeout);
+        this.connections.add(connection);
+        connection.on("close", () => {
+            this.connections.delete(connection);
+        });
+        // Forward events
+        connection.on("request", (requestId, method, args) => {
+            this.emit("request", connection, requestId, method, args);
+        });
+        connection.on("handshake", (data) => {
+            this.emit("handshake", connection, data);
+        });
+        connection.on("error", (err) => {
+            this.emit("connection-error", connection, err);
+        });
+        this.emit("connection", connection);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/transport/server.js.map

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

package/dist/types/adapter.d.ts

@@ -0,0 +1,33 @@
+import type { MethodDescriptor } from "./descriptor.js";
+/**
+ * FrameworkAdapter — Thin adapter layer for each framework.
+ *
+ * Each adapter knows how to:
+ * 1. Identify whether a class is a controller (via decorators or naming convention)
+ * 2. Extract method descriptors from a controller class
+ * 3. Optionally resolve a controller instance (e.g., from a DI container)
+ */
+export interface FrameworkAdapter {
+    /** Human-readable adapter name (e.g., "NestJS", "Ts.ED", "Generic") */
+    readonly name: string;
+    /**
+     * Check whether a given class/constructor is a controller in this framework.
+     * Used during autobarrel discovery and registration filtering.
+     */
+    isController(target: unknown): boolean;
+    /**
+     * Extract all callable method descriptors from a controller class.
+     * The adapter inspects the class prototype (and optionally decorator metadata)
+     * to build a list of MethodDescriptors.
+     */
+    extractMethods(controller: unknown): MethodDescriptor[];
+    /**
+     * Optionally resolve a live instance of the controller.
+     * Useful for frameworks with DI containers (NestJS, Ts.ED) where the controller
+     * class itself isn't directly instantiable.
+     *
+     * If not provided, TypeBridge will instantiate the class with `new`.
+     */
+    resolveInstance?(controller: unknown): unknown;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAEvC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAExD;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;CAChD"}

package/dist/types/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/types/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":""}