@labostack/typebridge 0.1.0

package/dist/bridge.js

@@ -0,0 +1,151 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { MethodRegistry } from "./registry/method-registry.js";
+import { TransportServer } from "./transport/server.js";
+import { MeshManager } from "./mesh/mesh-manager.js";
+import { announceViaMdns } from "./discovery/mdns.js";
+import { createMeshProxy } from "./proxy/client-proxy.js";
+import { scanControllers } from "./autobarrel/scanner.js";
+/**
+ * TypeBridge — zero-ceremony RPC mesh for TypeScript microservices.
+ *
+ * One method: `TypeBridge.create()`. That's it.
+ *
+ * @example
+ * ```typescript
+ * import { TypeBridge } from "@labostack/typebridge";
+ * import { NestAdapter } from "@labostack/typebridge/adapters";
+ * import { UserController } from "./controllers";
+ *
+ * const api = await TypeBridge.create(NestAdapter, {
+ *   controllers: { UserController },
+ * });
+ *
+ * // From another service — auto-discovered, auto-routed:
+ * // api.userController.findById("abc") — just works.
+ * ```
+ */
+export class TypeBridge {
+    /**
+     * Declare remote peer types for full type inference.
+     *
+     * Returns a builder whose `.create()` merges remote controller types
+     * into the returned API. Zero runtime cost — pure type narrowing.
+     *
+     * @example
+     * ```typescript
+     * import type { api as UsersAPI } from "example-service-nest/node";
+     *
+     * const api = await TypeBridge
+     *   .with<typeof UsersAPI>()
+     *   .create(GenericAdapter, { controllers: { OrderController } });
+     *
+     * api.userController.findById("abc"); // ✅ typed (remote)
+     * api.orderController.create({...});  // ✅ typed (local)
+     * ```
+     */
+    static with() {
+        return {
+            create: TypeBridge.create,
+        };
+    }
+    static async create(adapter, options) {
+        const registry = new MethodRegistry();
+        const serviceName = options.name ?? await inferServiceName();
+        // ─── Resolve controllers (object or directory path) ──
+        const controllerMap = typeof options.controllers === "string"
+            ? await scanControllers(options.controllers, adapter)
+            : options.controllers;
+        // ─── Register controllers ─────────────────────────
+        for (const [key, value] of Object.entries(controllerMap)) {
+            const controllerName = key.charAt(0).toLowerCase() + key.slice(1);
+            if (!adapter.isController(value))
+                continue;
+            const methods = adapter.extractMethods(value);
+            let instance;
+            if (adapter.resolveInstance) {
+                instance = adapter.resolveInstance(value);
+            }
+            else if (typeof value === "function") {
+                try {
+                    instance = new value();
+                }
+                catch {
+                    instance = value;
+                }
+            }
+            else {
+                instance = value;
+            }
+            registry.register(controllerName, instance, methods);
+        }
+        // ─── Mesh manager (auto-discovery + routing) ──────
+        const mesh = new MeshManager(serviceName, registry);
+        // ─── Start transport server ───────────────────────
+        const transport = new TransportServer({
+            port: options.port ?? 0,
+            host: options.host ?? "0.0.0.0",
+        });
+        // Handle incoming handshakes — register the peer in the mesh
+        transport.on("handshake", (conn, data) => {
+            const peerName = data?.name ?? "unknown";
+            const peerCatalog = data?.catalog ?? {};
+            // Register peer's controllers in our mesh
+            mesh.registerIncomingPeer(peerName, conn, peerCatalog);
+            // Send our catalog back
+            conn.sendHandshakeAck({
+                name: serviceName,
+                version: 1,
+                catalog: registry.toCatalog(),
+            });
+        });
+        transport.on("connection-error", () => {
+            // Silently handle
+        });
+        await transport.listen();
+        // ─── mDNS: announce + browse ──────────────────────
+        let mdnsStop = null;
+        if (options.announce !== false) {
+            try {
+                const handle = announceViaMdns(serviceName, transport.port);
+                mdnsStop = handle.stop;
+            }
+            catch {
+                // mDNS not available
+            }
+            // Start browsing for other nodes
+            await mesh.startBrowsing();
+        }
+        // ─── Build the API proxy ──────────────────────────
+        const api = createMeshProxy(registry, mesh, {
+            port: transport.port,
+            name: serviceName,
+            __mesh: mesh,
+            async close() {
+                mdnsStop?.();
+                await mesh.close();
+                await transport.close();
+            },
+        });
+        return api;
+    }
+}
+/**
+ * Infer the service name from the nearest package.json.
+ */
+async function inferServiceName() {
+    try {
+        const pkgPath = join(process.cwd(), "package.json");
+        const raw = await readFile(pkgPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        if (pkg.name) {
+            return pkg.name.replace(/^@[^/]+\//, "");
+        }
+    }
+    catch {
+        // No package.json
+    }
+    const parts = process.cwd().split("/");
+    return parts[parts.length - 1] || "typebridge-service";
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/discovery/dns.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve a service name via standard DNS.
+ *
+ * Works out-of-the-box in:
+ * - Docker Compose (embedded DNS at 127.0.0.11)
+ * - Kubernetes (CoreDNS resolves service-name.namespace.svc.cluster.local)
+ * - Any environment where the hostname is configured in /etc/hosts or DNS
+ */
+export declare function resolveViaDns(serviceName: string): Promise<string | null>;
+//# sourceMappingURL=dns.d.ts.map

package/dist/discovery/dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../src/discovery/dns.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO/E"}

package/dist/discovery/dns.js

@@ -0,0 +1,19 @@
+import { lookup } from "node:dns/promises";
+/**
+ * Resolve a service name via standard DNS.
+ *
+ * Works out-of-the-box in:
+ * - Docker Compose (embedded DNS at 127.0.0.11)
+ * - Kubernetes (CoreDNS resolves service-name.namespace.svc.cluster.local)
+ * - Any environment where the hostname is configured in /etc/hosts or DNS
+ */
+export async function resolveViaDns(serviceName) {
+    try {
+        const result = await lookup(serviceName);
+        return result.address;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=dns.js.map

package/dist/discovery/dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.js","sourceRoot":"","sources":["../../src/discovery/dns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveViaDns } from "./dns.js";
+export { announceViaMdns, resolveViaMdns } from "./mdns.js";
+export { resolveService } from "./resolver.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,4 @@
+export { resolveViaDns } from "./dns.js";
+export { announceViaMdns, resolveViaMdns } from "./mdns.js";
+export { resolveService } from "./resolver.js";
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/discovery/mdns.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Announce this service via mDNS/Bonjour for local dev discovery.
+ *
+ * NOTE: mDNS does NOT work inside Docker (multicast is filtered by default).
+ * This layer is specifically for bare-metal / local dev scenarios.
+ */
+export declare function announceViaMdns(name: string, port: number): {
+    stop: () => void;
+};
+/**
+ * Resolve a service name via mDNS/Bonjour.
+ * Returns the host and port if found within the timeout.
+ */
+export declare function resolveViaMdns(serviceName: string, timeoutMs?: number): Promise<{
+    host: string;
+    port: number;
+} | null>;
+//# sourceMappingURL=mdns.d.ts.map

package/dist/discovery/mdns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns.d.ts","sourceRoot":"","sources":["../../src/discovery/mdns.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAgBtB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBhD"}

package/dist/discovery/mdns.js

@@ -0,0 +1,49 @@
+import Bonjour from "bonjour-service";
+const SERVICE_TYPE = "typebridge";
+/**
+ * Announce this service via mDNS/Bonjour for local dev discovery.
+ *
+ * NOTE: mDNS does NOT work inside Docker (multicast is filtered by default).
+ * This layer is specifically for bare-metal / local dev scenarios.
+ */
+export function announceViaMdns(name, port) {
+    const bonjour = new Bonjour.default();
+    bonjour.publish({
+        name,
+        type: SERVICE_TYPE,
+        port,
+        protocol: "tcp",
+    });
+    return {
+        stop: () => {
+            bonjour.unpublishAll();
+            bonjour.destroy();
+        },
+    };
+}
+/**
+ * Resolve a service name via mDNS/Bonjour.
+ * Returns the host and port if found within the timeout.
+ */
+export async function resolveViaMdns(serviceName, timeoutMs = 3000) {
+    const bonjour = new Bonjour.default();
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            browser.stop();
+            bonjour.destroy();
+            resolve(null);
+        }, timeoutMs);
+        const browser = bonjour.find({ type: SERVICE_TYPE, protocol: "tcp" }, (service) => {
+            if (service.name === serviceName) {
+                clearTimeout(timer);
+                browser.stop();
+                bonjour.destroy();
+                resolve({
+                    host: service.host,
+                    port: service.port,
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=mdns.js.map

package/dist/discovery/mdns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns.js","sourceRoot":"","sources":["../../src/discovery/mdns.ts"],"names":[],"mappings":"AAAA,OAAO,OAAyB,MAAM,iBAAiB,CAAC;AAExD,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC,OAAO,CAAC,OAAO,CAAC;QACd,IAAI;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,OAAO,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,YAAoB,IAAI;IAExB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,OAAgB,EAAE,EAAE;YACzF,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACjC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC;oBACN,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/discovery/resolver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Layered service resolver.
+ *
+ * Resolution order:
+ * 1. DNS hostname lookup (works in Docker Compose / Kubernetes)
+ * 2. mDNS/Bonjour lookup (works in local dev)
+ * 3. Throw if not found
+ */
+export declare function resolveService(nameOrOptions: string | {
+    host: string;
+    port?: number;
+}): Promise<{
+    host: string;
+    port: number;
+}>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/discovery/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/discovery/resolver.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BzC"}

package/dist/discovery/resolver.js

@@ -0,0 +1,36 @@
+import { resolveViaDns } from "./dns.js";
+import { resolveViaMdns } from "./mdns.js";
+import { DEFAULT_PORT } from "../types/options.js";
+/**
+ * Layered service resolver.
+ *
+ * Resolution order:
+ * 1. DNS hostname lookup (works in Docker Compose / Kubernetes)
+ * 2. mDNS/Bonjour lookup (works in local dev)
+ * 3. Throw if not found
+ */
+export async function resolveService(nameOrOptions) {
+    // Explicit host:port — no discovery needed
+    if (typeof nameOrOptions === "object") {
+        return {
+            host: nameOrOptions.host,
+            port: nameOrOptions.port ?? DEFAULT_PORT,
+        };
+    }
+    const serviceName = nameOrOptions;
+    // Layer 1: DNS
+    const dnsResult = await resolveViaDns(serviceName);
+    if (dnsResult) {
+        return { host: dnsResult, port: DEFAULT_PORT };
+    }
+    // Layer 2: mDNS
+    const mdnsResult = await resolveViaMdns(serviceName, 3000);
+    if (mdnsResult) {
+        return mdnsResult;
+    }
+    // Not found
+    throw new Error(`Service "${serviceName}" not found. ` +
+        `Tried DNS and mDNS resolution. ` +
+        `Use explicit { host, port } to connect manually.`);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/discovery/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/discovery/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAAuD;IAEvD,2CAA2C;IAC3C,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,aAAa,CAAC,IAAI;YACxB,IAAI,EAAE,aAAa,CAAC,IAAI,IAAI,YAAY;SACzC,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC;IAElC,eAAe;IACf,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACjD,CAAC;IAED,gBAAgB;IAChB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,MAAM,IAAI,KAAK,CACb,YAAY,WAAW,eAAe;QACtC,iCAAiC;QACjC,kDAAkD,CACnD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @labostack/typebridge — Zero-ceremony RPC mesh for TypeScript
+ *
+ * Usage:
+ *   import { TypeBridge, NestAdapter } from "@labostack/typebridge";
+ *   const api = await TypeBridge.create(NestAdapter, { controllers });
+ *   api.userController.findById("abc"); // local or remote — just works
+ */
+export { TypeBridge } from "./bridge.js";
+export type { TypeDescriptor, MethodDescriptor, ParameterDescriptor, FrameworkAdapter, NodeOptions, TypeBridgeAPI, ControllerInstances, HandshakePayload, HandshakeAckPayload, RequestPayload, ResponsePayload, ErrorPayload, } from "./types/index.js";
+export { FRAME_MAGIC, PROTOCOL_VERSION, FRAME_HEADER_SIZE, MessageType, FrameFlags, } from "./types/index.js";
+export { MethodRegistry } from "./registry/index.js";
+export type { MethodCatalogEntry } from "./registry/index.js";
+export { extractMethodsFromPrototype } from "./reflection/index.js";
+export type { Serializer } from "./serialization/index.js";
+export { MsgPackSerializer } from "./serialization/index.js";
+export { TransportServer, TransportClient, Connection } from "./transport/index.js";
+export { MeshManager } from "./mesh/index.js";
+export { resolveService } from "./discovery/index.js";
+export { scanControllers } from "./autobarrel/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @labostack/typebridge — Zero-ceremony RPC mesh for TypeScript
+ *
+ * Usage:
+ *   import { TypeBridge, NestAdapter } from "@labostack/typebridge";
+ *   const api = await TypeBridge.create(NestAdapter, { controllers });
+ *   api.userController.findById("abc"); // local or remote — just works
+ */
+export { TypeBridge } from "./bridge.js";
+export { FRAME_MAGIC, PROTOCOL_VERSION, FRAME_HEADER_SIZE, MessageType, FrameFlags, } from "./types/index.js";
+// ─── Internals (advanced usage) ──────────────────
+export { MethodRegistry } from "./registry/index.js";
+export { extractMethodsFromPrototype } from "./reflection/index.js";
+export { MsgPackSerializer } from "./serialization/index.js";
+export { TransportServer, TransportClient, Connection } from "./transport/index.js";
+export { MeshManager } from "./mesh/index.js";
+export { resolveService } from "./discovery/index.js";
+export { scanControllers } from "./autobarrel/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBzC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,oDAAoD;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mesh/index.d.ts

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

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

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

package/dist/mesh/index.js

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

package/dist/mesh/index.js.map

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

package/dist/mesh/mesh-manager.d.ts

@@ -0,0 +1,55 @@
+import { EventEmitter } from "node:events";
+import type { Connection } from "../transport/connection.js";
+import type { MethodRegistry, MethodCatalogEntry } from "../registry/method-registry.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 declare class MeshManager extends EventEmitter {
+    private readonly localName;
+    private readonly localRegistry;
+    /** peerName → Connection */
+    private peers;
+    /** controllerName → peerName */
+    private routes;
+    /** Clients we created (for cleanup) */
+    private clients;
+    /** mDNS browser stop handle */
+    private stopBrowsing;
+    constructor(localName: string, localRegistry: MethodRegistry);
+    /**
+     * Start browsing for other TypeBridge nodes via mDNS.
+     */
+    startBrowsing(): Promise<void>;
+    /**
+     * Connect to a discovered peer, exchange catalogs.
+     */
+    connectToPeer(name: string, host: string, port: number): Promise<void>;
+    /**
+     * Register an incoming peer (called from server-side handshake handler).
+     */
+    registerIncomingPeer(name: string, connection: Connection, catalog: Record<string, MethodCatalogEntry[]>): void;
+    /**
+     * Register a peer and its controllers in the routing table.
+     */
+    private registerPeer;
+    /**
+     * Get the connection for a controller.
+     * If the controller isn't found yet, waits for discovery (with timeout).
+     */
+    getConnection(controllerName: string, timeout?: number): Promise<Connection>;
+    /**
+     * Check if a controller is available on any peer.
+     */
+    hasController(controllerName: string): boolean;
+    /**
+     * Close all peer connections and stop browsing.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mesh-manager.d.ts.map

package/dist/mesh/mesh-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-manager.d.ts","sourceRoot":"","sources":["../../src/mesh/mesh-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzF;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAWzC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAXhC,4BAA4B;IAC5B,OAAO,CAAC,KAAK,CAAiC;IAC9C,gCAAgC;IAChC,OAAO,CAAC,MAAM,CAA6B;IAC3C,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAyB;IACxC,+BAA+B;IAC/B,OAAO,CAAC,YAAY,CAA6B;gBAG9B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,cAAc;IAKhD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BpC;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B5E;;OAEG;IACH,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,GAC5C,IAAI;IAKP;;OAEG;IACH,OAAO,CAAC,YAAY;IAsCpB;;;OAGG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAkClF;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}