@labostack/typebridge 0.1.0

package/dist/mesh/mesh-manager.js

@@ -0,0 +1,179 @@
+import { EventEmitter } from "node:events";
+import { TransportClient } from "../transport/client.js";
+/**
+ * MeshManager — automatic peer discovery, connection, and controller routing.
+ *
+ * Each TypeBridge node has a MeshManager that:
+ * 1. Browses for other nodes via mDNS
+ * 2. Auto-connects and exchanges catalogs
+ * 3. Maintains a routing table: controllerName → Connection
+ * 4. Routes method calls to the right peer
+ */
+export class MeshManager extends EventEmitter {
+    localName;
+    localRegistry;
+    /** peerName → Connection */
+    peers = new Map();
+    /** controllerName → peerName */
+    routes = new Map();
+    /** Clients we created (for cleanup) */
+    clients = [];
+    /** mDNS browser stop handle */
+    stopBrowsing = null;
+    constructor(localName, localRegistry) {
+        super();
+        this.localName = localName;
+        this.localRegistry = localRegistry;
+    }
+    /**
+     * Start browsing for other TypeBridge nodes via mDNS.
+     */
+    async startBrowsing() {
+        try {
+            const bonjourModule = await import("bonjour-service");
+            const Bonjour = bonjourModule.default ?? bonjourModule;
+            const bonjour = typeof Bonjour === "function" ? new Bonjour() : Bonjour;
+            const browser = bonjour.find({ type: "typebridge" });
+            browser.on("up", (service) => {
+                // Skip self
+                if (service.name === this.localName)
+                    return;
+                // Skip already connected
+                if (this.peers.has(service.name))
+                    return;
+                const host = service.addresses?.[0] ?? service.host ?? "127.0.0.1";
+                const port = service.port;
+                this.connectToPeer(service.name, host, port).catch(() => {
+                    // Connection failed — will retry on next mDNS event
+                });
+            });
+            this.stopBrowsing = () => {
+                browser.stop();
+                bonjour.destroy();
+            };
+        }
+        catch {
+            // mDNS not available — that's fine, peers can still connect to us
+        }
+    }
+    /**
+     * Connect to a discovered peer, exchange catalogs.
+     */
+    async connectToPeer(name, host, port) {
+        if (this.peers.has(name))
+            return; // already connected
+        const client = new TransportClient({ host, port });
+        this.clients.push(client);
+        const connection = await client.connect();
+        // Send handshake WITH our catalog
+        connection.sendHandshake({
+            name: this.localName,
+            version: 1,
+            catalog: this.localRegistry.toCatalog(),
+        });
+        // Wait for handshake ack with their catalog
+        const peerCatalog = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error("Handshake timeout")), 10_000);
+            connection.on("handshake-ack", (data) => {
+                clearTimeout(timer);
+                resolve(data.catalog ?? {});
+            });
+        });
+        // Register the peer
+        this.registerPeer(name, connection, peerCatalog);
+    }
+    /**
+     * Register an incoming peer (called from server-side handshake handler).
+     */
+    registerIncomingPeer(name, connection, catalog) {
+        if (this.peers.has(name))
+            return; // already connected
+        this.registerPeer(name, connection, catalog);
+    }
+    /**
+     * Register a peer and its controllers in the routing table.
+     */
+    registerPeer(name, connection, catalog) {
+        this.peers.set(name, connection);
+        // Build routing table: controllerName → peerName
+        for (const controllerName of Object.keys(catalog)) {
+            this.routes.set(controllerName, name);
+        }
+        // Wire incoming requests (bidirectional — peer calls our controllers)
+        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 — remove from routing table
+        connection.on("close", () => {
+            this.peers.delete(name);
+            for (const [ctrl, peer] of this.routes) {
+                if (peer === name)
+                    this.routes.delete(ctrl);
+            }
+        });
+        // Notify waiters that a new peer is available
+        this.emit("peer-available", name);
+    }
+    /**
+     * Get the connection for a controller.
+     * If the controller isn't found yet, waits for discovery (with timeout).
+     */
+    async getConnection(controllerName, timeout = 10_000) {
+        // Already known?
+        const peerName = this.routes.get(controllerName);
+        if (peerName) {
+            const conn = this.peers.get(peerName);
+            if (conn && conn.isOpen)
+                return conn;
+        }
+        // Wait for a peer with this controller to appear
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.off("peer-available", check);
+                reject(new Error(`Controller "${controllerName}" not found on any peer (timeout ${timeout}ms). ` +
+                    `Make sure the service exposing it is running.`));
+            }, timeout);
+            const check = () => {
+                const peerName = this.routes.get(controllerName);
+                if (peerName) {
+                    const conn = this.peers.get(peerName);
+                    if (conn && conn.isOpen) {
+                        clearTimeout(timer);
+                        this.off("peer-available", check);
+                        resolve(conn);
+                    }
+                }
+            };
+            this.on("peer-available", check);
+        });
+    }
+    /**
+     * Check if a controller is available on any peer.
+     */
+    hasController(controllerName) {
+        return this.routes.has(controllerName);
+    }
+    /**
+     * Close all peer connections and stop browsing.
+     */
+    async close() {
+        this.stopBrowsing?.();
+        for (const client of this.clients) {
+            client.close();
+        }
+        this.clients = [];
+        this.peers.clear();
+        this.routes.clear();
+    }
+}
+//# sourceMappingURL=mesh-manager.js.map

package/dist/mesh/mesh-manager.js.map

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

package/dist/proxy/client-proxy.d.ts

@@ -0,0 +1,20 @@
+import type { MethodRegistry } from "../registry/method-registry.js";
+import type { MeshManager } from "../mesh/mesh-manager.js";
+/**
+ * Create a smart mesh proxy.
+ *
+ * This proxy routes method calls to the right place:
+ * - Local controllers → invoke directly via MethodRegistry
+ * - Remote controllers → route via MeshManager (auto-discovered)
+ *
+ * The proxy is what TypeBridge.create() returns. It IS the API:
+ *
+ *   const api = await TypeBridge.create(adapter, { controllers });
+ *   api.userController.findById("abc"); // local or remote — just works
+ *
+ * @param localRegistry - local controllers
+ * @param meshManager - handles remote controller routing
+ * @param ownProps - own properties (close, port, name, etc.)
+ */
+export declare function createMeshProxy<T = unknown>(localRegistry: MethodRegistry, meshManager: MeshManager, ownProps?: Record<string, unknown>): T;
+//# sourceMappingURL=client-proxy.d.ts.map

package/dist/proxy/client-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/client-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,aAAa,EAAE,cAAc,EAC7B,WAAW,EAAE,WAAW,EACxB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,CAAC,CA0BH"}

package/dist/proxy/client-proxy.js

@@ -0,0 +1,69 @@
+/**
+ * Create a smart mesh proxy.
+ *
+ * This proxy routes method calls to the right place:
+ * - Local controllers → invoke directly via MethodRegistry
+ * - Remote controllers → route via MeshManager (auto-discovered)
+ *
+ * The proxy is what TypeBridge.create() returns. It IS the API:
+ *
+ *   const api = await TypeBridge.create(adapter, { controllers });
+ *   api.userController.findById("abc"); // local or remote — just works
+ *
+ * @param localRegistry - local controllers
+ * @param meshManager - handles remote controller routing
+ * @param ownProps - own properties (close, port, name, etc.)
+ */
+export function createMeshProxy(localRegistry, meshManager, ownProps = {}) {
+    return new Proxy(ownProps, {
+        get(target, prop) {
+            if (typeof prop === "symbol")
+                return undefined;
+            if (prop === "then" || prop === "catch" || prop === "finally")
+                return undefined;
+            // Own properties (close, port, name, __controllers) take priority
+            if (prop in target) {
+                return target[prop];
+            }
+            // Return a controller proxy — will route to local or remote
+            return createControllerProxy(localRegistry, meshManager, prop);
+        },
+        ownKeys(target) {
+            return Object.keys(target);
+        },
+        getOwnPropertyDescriptor(target, prop) {
+            if (prop in target) {
+                return { configurable: true, enumerable: true, value: target[prop] };
+            }
+            return undefined;
+        },
+    });
+}
+/**
+ * Controller-level proxy — intercepts method calls and routes them.
+ */
+function createControllerProxy(localRegistry, meshManager, controllerName) {
+    return new Proxy(() => { }, {
+        get(_target, methodName) {
+            if (typeof methodName === "symbol")
+                return undefined;
+            if (methodName === "then" || methodName === "catch" || methodName === "finally")
+                return undefined;
+            // Return a function that routes the call
+            return async (...args) => {
+                // 1. Local? Call directly — no network involved
+                if (localRegistry.hasController(controllerName)) {
+                    return localRegistry.invoke(controllerName, String(methodName), args);
+                }
+                // 2. Remote? Route via mesh (waits for discovery if needed)
+                const conn = await meshManager.getConnection(controllerName);
+                return conn.request(`${controllerName}.${String(methodName)}`, args);
+            };
+        },
+        apply() {
+            throw new Error(`Cannot call controller "${controllerName}" directly. ` +
+                `Access a method: api.${controllerName}.methodName(args)`);
+        },
+    });
+}
+//# sourceMappingURL=client-proxy.js.map

package/dist/proxy/client-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-proxy.js","sourceRoot":"","sources":["../../src/proxy/client-proxy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,aAA6B,EAC7B,WAAwB,EACxB,WAAoC,EAAE;IAEtC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE;QACzB,GAAG,CAAC,MAAM,EAAE,IAAqB;YAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAEhF,kEAAkE;YAClE,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAkC,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC;YAED,4DAA4D;YAC5D,OAAO,qBAAqB,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,CAAC,MAAM;YACZ,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,wBAAwB,CAAC,MAAM,EAAE,IAAI;YACnC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAG,MAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAChF,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAM,CAAC;AACV,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,aAA6B,EAC7B,WAAwB,EACxB,cAAsB;IAEtB,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE;QACzB,GAAG,CAAC,OAAO,EAAE,UAA2B;YACtC,IAAI,OAAO,UAAU,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACrD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAElG,yCAAyC;YACzC,OAAO,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBAClC,gDAAgD;gBAChD,IAAI,aAAa,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;oBAChD,OAAO,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxE,CAAC;gBAED,4DAA4D;gBAC5D,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,cAAc,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACvE,CAAC,CAAC;QACJ,CAAC;QAED,KAAK;YACH,MAAM,IAAI,KAAK,CACb,2BAA2B,cAAc,cAAc;gBACvD,wBAAwB,cAAc,mBAAmB,CAC1D,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/proxy/index.d.ts

@@ -0,0 +1,2 @@
+export { createMeshProxy } from "./client-proxy.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/proxy/index.js

@@ -0,0 +1,2 @@
+export { createMeshProxy } from "./client-proxy.js";
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/reflection/extractor.d.ts

@@ -0,0 +1,13 @@
+import type { MethodDescriptor } from "../types/descriptor.js";
+/**
+ * Extract method descriptors from a plain class by inspecting its prototype.
+ *
+ * This is the fallback/generic extractor used when no adapter-specific
+ * metadata is available. It produces basic descriptors by inspecting
+ * the class prototype's own methods.
+ *
+ * Framework-specific adapters (NestAdapter, TsedAdapter, etc.) may
+ * override this with richer metadata from decorator reflection.
+ */
+export declare function extractMethodsFromPrototype(controllerName: string, controllerClass: new (...args: unknown[]) => unknown): MethodDescriptor[];
+//# sourceMappingURL=extractor.d.ts.map

package/dist/reflection/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/reflection/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,wBAAwB,CAAC;AAGpF;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACnD,gBAAgB,EAAE,CAkCpB"}

package/dist/reflection/extractor.js

@@ -0,0 +1,62 @@
+/**
+ * Extract method descriptors from a plain class by inspecting its prototype.
+ *
+ * This is the fallback/generic extractor used when no adapter-specific
+ * metadata is available. It produces basic descriptors by inspecting
+ * the class prototype's own methods.
+ *
+ * Framework-specific adapters (NestAdapter, TsedAdapter, etc.) may
+ * override this with richer metadata from decorator reflection.
+ */
+export function extractMethodsFromPrototype(controllerName, controllerClass) {
+    const prototype = controllerClass.prototype;
+    const methods = [];
+    const ownMethodNames = Object.getOwnPropertyNames(prototype).filter((name) => name !== "constructor" && typeof prototype[name] === "function");
+    for (const methodName of ownMethodNames) {
+        const method = prototype[methodName];
+        // Try to extract parameter names from function source (best-effort)
+        const paramNames = extractParamNames(method);
+        const parameters = paramNames.map((name, index) => ({
+            name,
+            index,
+            type: { kind: "unknown" },
+            isOptional: false,
+        }));
+        const descriptor = {
+            controllerName,
+            methodName,
+            parameters,
+            returnType: { kind: "unknown" },
+            isAsync: method.constructor.name === "AsyncFunction",
+            decorators: [],
+        };
+        methods.push(descriptor);
+    }
+    return methods;
+}
+/**
+ * Extract parameter names from a function's toString() representation.
+ * Best-effort — works for simple cases. Complex destructuring or
+ * compiled code may not parse correctly.
+ */
+function extractParamNames(fn) {
+    const source = fn.toString();
+    const match = source.match(/\(([^)]*)\)/);
+    if (!match || !match[1])
+        return [];
+    return match[1]
+        .split(",")
+        .map((param) => param.trim())
+        .filter((param) => param.length > 0)
+        .map((param) => {
+        // Handle default values: "name = 'default'" → "name"
+        const eqIdx = param.indexOf("=");
+        if (eqIdx > 0)
+            return param.substring(0, eqIdx).trim();
+        // Handle rest params: "...args" → "args"
+        if (param.startsWith("..."))
+            return param.substring(3);
+        return param;
+    });
+}
+//# sourceMappingURL=extractor.js.map

package/dist/reflection/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/reflection/extractor.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,cAAsB,EACtB,eAAoD;IAEpD,MAAM,SAAS,GAAG,eAAe,CAAC,SAAoC,CAAC;IACvE,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,MAAM,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,MAAM,CACjE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAC1E,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAa,CAAC;QAEjD,oEAAoE;QACpE,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE7C,MAAM,UAAU,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACzE,IAAI;YACJ,KAAK;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAoB;YAC3C,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC,CAAC;QAEJ,MAAM,UAAU,GAAqB;YACnC,cAAc;YACd,UAAU;YACV,UAAU;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAoB;YACjD,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe;YACpD,UAAU,EAAE,EAAE;SACf,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,EAAY;IACrC,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,KAAK,CAAC,CAAC,CAAC;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,qDAAqD;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,yCAAyC;QACzC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/reflection/index.d.ts

@@ -0,0 +1,2 @@
+export { extractMethodsFromPrototype } from "./extractor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/reflection/index.js

@@ -0,0 +1,2 @@
+export { extractMethodsFromPrototype } from "./extractor.js";
+//# sourceMappingURL=index.js.map

package/dist/reflection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,3 @@
+export { MethodRegistry } from "./method-registry.js";
+export type { MethodCatalogEntry } from "./method-registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,2 @@
+export { MethodRegistry } from "./method-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/method-registry.d.ts

@@ -0,0 +1,56 @@
+import type { MethodDescriptor } from "../types/descriptor.js";
+/**
+ * MethodRegistry — stores all registered controllers and their methods.
+ *
+ * Each controller is registered with a key name (e.g., "userController")
+ * and its instance + extracted method descriptors.
+ */
+export declare class MethodRegistry {
+    /** controller name → method descriptors */
+    private readonly methods;
+    /** controller name → controller instance (for invoking methods) */
+    private readonly instances;
+    /**
+     * Register a controller with its method descriptors and instance.
+     */
+    register(controllerName: string, instance: unknown, methods: MethodDescriptor[]): void;
+    /**
+     * Get all method descriptors for a controller.
+     */
+    getMethods(controllerName: string): MethodDescriptor[] | undefined;
+    /**
+     * Get a specific method descriptor.
+     */
+    getMethod(controllerName: string, methodName: string): MethodDescriptor | undefined;
+    /**
+     * Get the instance for a controller (used to actually call methods).
+     */
+    getInstance(controllerName: string): unknown | undefined;
+    /**
+     * Check if a controller is registered.
+     */
+    hasController(controllerName: string): boolean;
+    /**
+     * Get all registered controller names.
+     */
+    getControllerNames(): string[];
+    /**
+     * Invoke a method on a registered controller.
+     */
+    invoke(controllerName: string, methodName: string, args: unknown[]): Promise<unknown>;
+    /**
+     * Generate a serializable type catalog for the handshake.
+     * Contains all controllers, methods, and their parameter info.
+     */
+    toCatalog(): Record<string, MethodCatalogEntry[]>;
+}
+/**
+ * Single method entry in the serializable catalog.
+ */
+export interface MethodCatalogEntry {
+    methodName: string;
+    parameterNames: string[];
+    parameterCount: number;
+    isAsync: boolean;
+}
+//# sourceMappingURL=method-registry.d.ts.map

package/dist/registry/method-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-registry.d.ts","sourceRoot":"","sources":["../../src/registry/method-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD;;OAEG;IACH,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,IAAI;IAKP;;OAEG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,SAAS;IAIlE;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAMnF;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIxD;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAe3F;;;OAGG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAclD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/registry/method-registry.js

@@ -0,0 +1,84 @@
+/**
+ * MethodRegistry — stores all registered controllers and their methods.
+ *
+ * Each controller is registered with a key name (e.g., "userController")
+ * and its instance + extracted method descriptors.
+ */
+export class MethodRegistry {
+    /** controller name → method descriptors */
+    methods = new Map();
+    /** controller name → controller instance (for invoking methods) */
+    instances = new Map();
+    /**
+     * Register a controller with its method descriptors and instance.
+     */
+    register(controllerName, instance, methods) {
+        this.methods.set(controllerName, methods);
+        this.instances.set(controllerName, instance);
+    }
+    /**
+     * Get all method descriptors for a controller.
+     */
+    getMethods(controllerName) {
+        return this.methods.get(controllerName);
+    }
+    /**
+     * Get a specific method descriptor.
+     */
+    getMethod(controllerName, methodName) {
+        const methods = this.methods.get(controllerName);
+        if (!methods)
+            return undefined;
+        return methods.find((m) => m.methodName === methodName);
+    }
+    /**
+     * Get the instance for a controller (used to actually call methods).
+     */
+    getInstance(controllerName) {
+        return this.instances.get(controllerName);
+    }
+    /**
+     * Check if a controller is registered.
+     */
+    hasController(controllerName) {
+        return this.methods.has(controllerName);
+    }
+    /**
+     * Get all registered controller names.
+     */
+    getControllerNames() {
+        return Array.from(this.methods.keys());
+    }
+    /**
+     * Invoke a method on a registered controller.
+     */
+    async invoke(controllerName, methodName, args) {
+        const instance = this.instances.get(controllerName);
+        if (!instance) {
+            throw new Error(`Controller not found: ${controllerName}`);
+        }
+        const method = instance[methodName];
+        if (typeof method !== "function") {
+            throw new Error(`Method not found: ${controllerName}.${methodName}`);
+        }
+        // Call the method on the instance with the provided args
+        return method.call(instance, ...args);
+    }
+    /**
+     * Generate a serializable type catalog for the handshake.
+     * Contains all controllers, methods, and their parameter info.
+     */
+    toCatalog() {
+        const catalog = {};
+        for (const [controllerName, methods] of this.methods) {
+            catalog[controllerName] = methods.map((m) => ({
+                methodName: m.methodName,
+                parameterNames: m.parameters.map((p) => p.name),
+                parameterCount: m.parameters.length,
+                isAsync: m.isAsync,
+            }));
+        }
+        return catalog;
+    }
+}
+//# sourceMappingURL=method-registry.js.map

package/dist/registry/method-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../src/registry/method-registry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACzB,2CAA2C;IAC1B,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IACjE,mEAAmE;IAClD,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IAExD;;OAEG;IACH,QAAQ,CACN,cAAsB,EACtB,QAAiB,EACjB,OAA2B;QAE3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,cAAsB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,cAAsB,EAAE,UAAkB;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,cAAsB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,cAAsB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,cAAsB,EAAE,UAAkB,EAAE,IAAe;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,cAAc,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,MAAM,GAAI,QAAoC,CAAC,UAAU,CAAC,CAAC;QACjE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,qBAAqB,cAAc,IAAI,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,yDAAyD;QACzD,OAAQ,MAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,MAAM,OAAO,GAAyC,EAAE,CAAC;QAEzD,KAAK,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5C,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC/C,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;gBACnC,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/serialization/error-ext.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Custom Error serialization/deserialization.
+ *
+ * Errors are fully serialized as-is:
+ * - name, message, stack (exact)
+ * - cause chains (recursive)
+ * - All enumerable custom properties (statusCode, details, etc.)
+ *
+ * The client receives the exact same error the server threw. Period.
+ */
+/** Marker to identify serialized Error objects in MessagePack payload */
+export declare const ERROR_MARKER = "__typebridge_error__";
+/**
+ * Serialized representation of an Error.
+ */
+export interface SerializedError {
+    [ERROR_MARKER]: true;
+    name: string;
+    message: string;
+    stack: string | undefined;
+    cause?: SerializedError;
+    properties: Record<string, unknown>;
+}
+/**
+ * Serialize an Error object into a plain object that can be encoded by MessagePack.
+ * Recursively serializes `cause` chains and captures all enumerable properties.
+ */
+export declare function serializeError(error: unknown): SerializedError;
+/**
+ * Deserialize a SerializedError back into an Error object.
+ * Reconstructs cause chains and restores all custom properties.
+ */
+export declare function deserializeError(data: SerializedError): Error;
+/**
+ * Check if a value is a serialized TypeBridge Error.
+ */
+export declare function isSerializedError(value: unknown): value is SerializedError;
+//# sourceMappingURL=error-ext.d.ts.map

package/dist/serialization/error-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-ext.d.ts","sourceRoot":"","sources":["../../src/serialization/error-ext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAiC9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAmB7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}