@labostack/typebridge 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @labostack/typebridge
+
+Zero-ceremony RPC bridge with full auto-typing for TypeScript microservices.
+
+## Install
+
+```bash
+npm install @labostack/typebridge
+```
+
+## Usage
+
+### Service A — exposes controllers
+
+```typescript
+import { TypeBridge } from "@labostack/typebridge";
+import { NestAdapter } from "@labostack/typebridge/adapters";
+import { UserController } from "./controllers";
+
+export const api = await TypeBridge.create(NestAdapter, {
+  controllers: { UserController },
+});
+```
+
+### Service B — calls Service A
+
+```typescript
+import { TypeBridge } from "@labostack/typebridge";
+import { GenericAdapter } from "@labostack/typebridge/adapters";
+import type { api as UsersAPI } from "../service-a/node";
+
+const api = await TypeBridge
+  .with<typeof UsersAPI>()
+  .create(GenericAdapter, {
+    controllers: "./controllers",
+  });
+
+// Fully typed — IDE autocomplete, args, return types
+const user = await api.userController.findById("abc-123");
+```
+
+### Adapters
+
+| Adapter | Framework |
+|---------|-----------|
+| `NestAdapter` | NestJS |
+| `GenericAdapter` | Plain TypeScript |
+| `TsedAdapter` | Ts.ED |
+| `DeepkitAdapter` | Deepkit |
+
+All from `@labostack/typebridge/adapters`.
+
+## How it works
+
+- **Discovery**: mDNS (local dev) + DNS (Docker/K8s)
+- **Transport**: TCP with binary framing (MessagePack)
+- **Typing**: `import type` + Proxy — zero codegen
+- **Mesh**: Bidirectional — services call each other
+
+## License
+
+MIT

package/dist/adapters/decorators.d.ts

@@ -0,0 +1,11 @@
+import "reflect-metadata";
+/**
+ * @Bridge() decorator — marks a class as a TypeBridge controller.
+ * Use this when your class name doesn't end with "Controller".
+ */
+export declare function Bridge(): ClassDecorator;
+/**
+ * Check if a class has the @Bridge() decorator.
+ */
+export declare function hasBridgeDecorator(target: unknown): boolean;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/adapters/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/adapters/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;;GAGG;AACH,wBAAgB,MAAM,IAAI,cAAc,CAIvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAG3D"}

package/dist/adapters/decorators.js

@@ -0,0 +1,20 @@
+import "reflect-metadata";
+const BRIDGE_METADATA_KEY = "typebridge:bridge";
+/**
+ * @Bridge() decorator — marks a class as a TypeBridge controller.
+ * Use this when your class name doesn't end with "Controller".
+ */
+export function Bridge() {
+    return (target) => {
+        Reflect.defineMetadata(BRIDGE_METADATA_KEY, true, target);
+    };
+}
+/**
+ * Check if a class has the @Bridge() decorator.
+ */
+export function hasBridgeDecorator(target) {
+    if (typeof target !== "function")
+        return false;
+    return Reflect.hasMetadata(BRIDGE_METADATA_KEY, target) === true;
+}
+//# sourceMappingURL=decorators.js.map

package/dist/adapters/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/adapters/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe;IAChD,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACnE,CAAC"}

package/dist/adapters/deepkit-adapter.d.ts

@@ -0,0 +1,11 @@
+import "reflect-metadata";
+import type { FrameworkAdapter } from "../index.js";
+/**
+ * DeepkitAdapter — adapter for Deepkit framework.
+ *
+ * Detects controllers by checking for Deepkit's http controller metadata.
+ * Deepkit uses `@http.controller()` decorator which stores metadata
+ * via `__type` reflection or Reflect.metadata.
+ */
+export declare const DeepkitAdapter: FrameworkAdapter;
+//# sourceMappingURL=deepkit-adapter.d.ts.map

package/dist/adapters/deepkit-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/deepkit-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAGtE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,gBA8B5B,CAAC"}

package/dist/adapters/deepkit-adapter.js

@@ -0,0 +1,39 @@
+import "reflect-metadata";
+import { extractMethodsFromPrototype } from "../index.js";
+/**
+ * DeepkitAdapter — adapter for Deepkit framework.
+ *
+ * Detects controllers by checking for Deepkit's http controller metadata.
+ * Deepkit uses `@http.controller()` decorator which stores metadata
+ * via `__type` reflection or Reflect.metadata.
+ */
+export const DeepkitAdapter = {
+    name: "Deepkit",
+    isController(target) {
+        if (typeof target !== "function")
+            return false;
+        const t = target;
+        // Deepkit marks HTTP controllers with _httpController metadata
+        if (Reflect.hasMetadata("httpController", target))
+            return true;
+        // Deepkit's @http.controller() sets a static property
+        if (t._httpController !== undefined)
+            return true;
+        // Check for Deepkit's __type runtime reflection data
+        if (t.__type !== undefined) {
+            // If it has routes defined, it's a controller
+            const meta = Reflect.getMetadata("httpController", target);
+            if (meta)
+                return true;
+        }
+        return false;
+    },
+    extractMethods(controller) {
+        if (typeof controller !== "function")
+            return [];
+        const ctor = controller;
+        const name = ctor.name.charAt(0).toLowerCase() + ctor.name.slice(1);
+        return extractMethodsFromPrototype(name, ctor);
+    },
+};
+//# sourceMappingURL=deepkit-adapter.js.map

package/dist/adapters/deepkit-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit-adapter.js","sourceRoot":"","sources":["../../src/adapters/deepkit-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,SAAS;IAEf,YAAY,CAAC,MAAe;QAC1B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAE/C,MAAM,CAAC,GAAG,MAAa,CAAC;QAExB,+DAA+D;QAC/D,IAAI,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/D,sDAAsD;QACtD,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEjD,qDAAqD;QACrD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3B,8CAA8C;YAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;YAC3D,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,IAAI,OAAO,UAAU,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,UAAiD,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/adapters/generic-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { FrameworkAdapter } from "../index.js";
+/**
+ * GenericAdapter — framework-agnostic adapter for plain TypeScript classes.
+ *
+ * Detects controllers by:
+ * 1. Class name ending with "Controller" (e.g., UserController)
+ * 2. Presence of @Bridge() decorator
+ *
+ * No framework dependency required.
+ */
+export declare const GenericAdapter: FrameworkAdapter;
+//# sourceMappingURL=generic-adapter.d.ts.map

package/dist/adapters/generic-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/generic-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,gBAe5B,CAAC"}

package/dist/adapters/generic-adapter.js

@@ -0,0 +1,28 @@
+import { extractMethodsFromPrototype } from "../index.js";
+import { hasBridgeDecorator } from "./decorators.js";
+/**
+ * GenericAdapter — framework-agnostic adapter for plain TypeScript classes.
+ *
+ * Detects controllers by:
+ * 1. Class name ending with "Controller" (e.g., UserController)
+ * 2. Presence of @Bridge() decorator
+ *
+ * No framework dependency required.
+ */
+export const GenericAdapter = {
+    name: "Generic",
+    isController(target) {
+        if (typeof target !== "function")
+            return false;
+        const name = target.name;
+        return name.endsWith("Controller") || hasBridgeDecorator(target);
+    },
+    extractMethods(controller) {
+        if (typeof controller !== "function")
+            return [];
+        const ctor = controller;
+        const name = ctor.name.charAt(0).toLowerCase() + ctor.name.slice(1);
+        return extractMethodsFromPrototype(name, ctor);
+    },
+};
+//# sourceMappingURL=generic-adapter.js.map

package/dist/adapters/generic-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../src/adapters/generic-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,SAAS;IAEf,YAAY,CAAC,MAAe;QAC1B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,IAAI,GAAI,MAAmB,CAAC,IAAI,CAAC;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,IAAI,OAAO,UAAU,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,UAAiD,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,5 @@
+export { NestAdapter } from "./nest-adapter.js";
+export { GenericAdapter } from "./generic-adapter.js";
+export { TsedAdapter } from "./tsed-adapter.js";
+export { DeepkitAdapter } from "./deepkit-adapter.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/adapters/index.js

@@ -0,0 +1,5 @@
+export { NestAdapter } from "./nest-adapter.js";
+export { GenericAdapter } from "./generic-adapter.js";
+export { TsedAdapter } from "./tsed-adapter.js";
+export { DeepkitAdapter } from "./deepkit-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

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

package/dist/adapters/nest-adapter.d.ts

@@ -0,0 +1,14 @@
+import "reflect-metadata";
+import type { FrameworkAdapter } from "../index.js";
+/**
+ * NestAdapter — adapter for NestJS framework.
+ *
+ * Detects controllers by checking for @Controller() decorator metadata.
+ * Extracts methods by inspecting the class prototype.
+ *
+ * Note: This adapter reads NestJS metadata but doesn't depend on the
+ * NestJS DI container. Controllers should be passed as instances
+ * (resolved from the container) via ServeOptions.controllers.
+ */
+export declare const NestAdapter: FrameworkAdapter;
+//# sourceMappingURL=nest-adapter.d.ts.map

package/dist/adapters/nest-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/nest-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAOtE;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,gBAkBzB,CAAC"}

package/dist/adapters/nest-adapter.js

@@ -0,0 +1,33 @@
+import "reflect-metadata";
+import { extractMethodsFromPrototype } from "../index.js";
+// NestJS metadata keys (from @nestjs/common)
+const CONTROLLER_WATERMARK = "__controller__";
+const PATH_METADATA = "path";
+/**
+ * NestAdapter — adapter for NestJS framework.
+ *
+ * Detects controllers by checking for @Controller() decorator metadata.
+ * Extracts methods by inspecting the class prototype.
+ *
+ * Note: This adapter reads NestJS metadata but doesn't depend on the
+ * NestJS DI container. Controllers should be passed as instances
+ * (resolved from the container) via ServeOptions.controllers.
+ */
+export const NestAdapter = {
+    name: "NestJS",
+    isController(target) {
+        if (typeof target !== "function")
+            return false;
+        // Check for NestJS @Controller() decorator watermark
+        return (Reflect.hasMetadata(CONTROLLER_WATERMARK, target) ||
+            Reflect.hasMetadata(PATH_METADATA, target));
+    },
+    extractMethods(controller) {
+        if (typeof controller !== "function")
+            return [];
+        const ctor = controller;
+        const name = ctor.name.charAt(0).toLowerCase() + ctor.name.slice(1);
+        return extractMethodsFromPrototype(name, ctor);
+    },
+};
+//# sourceMappingURL=nest-adapter.js.map

package/dist/adapters/nest-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-adapter.js","sourceRoot":"","sources":["../../src/adapters/nest-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAC9C,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,QAAQ;IAEd,YAAY,CAAC,MAAe;QAC1B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC/C,qDAAqD;QACrD,OAAO,CACL,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC;YACjD,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAC3C,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,IAAI,OAAO,UAAU,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,UAAiD,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/adapters/tsed-adapter.d.ts

@@ -0,0 +1,10 @@
+import "reflect-metadata";
+import type { FrameworkAdapter } from "../index.js";
+/**
+ * TsedAdapter — adapter for Ts.ED framework.
+ *
+ * Detects controllers by checking for @Controller() decorator metadata
+ * from @tsed/common. Extracts methods from the class prototype.
+ */
+export declare const TsedAdapter: FrameworkAdapter;
+//# sourceMappingURL=tsed-adapter.d.ts.map

package/dist/adapters/tsed-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsed-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/tsed-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAOtE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,gBAoBzB,CAAC"}

package/dist/adapters/tsed-adapter.js

@@ -0,0 +1,31 @@
+import "reflect-metadata";
+import { extractMethodsFromPrototype } from "../index.js";
+// Ts.ED metadata keys (from @tsed/common)
+const TSED_CONTROLLER_KEY = "tsed:controller";
+const TSED_CONTROLLER_URL = "tsed:controller:url";
+/**
+ * TsedAdapter — adapter for Ts.ED framework.
+ *
+ * Detects controllers by checking for @Controller() decorator metadata
+ * from @tsed/common. Extracts methods from the class prototype.
+ */
+export const TsedAdapter = {
+    name: "Ts.ED",
+    isController(target) {
+        if (typeof target !== "function")
+            return false;
+        // Check for Ts.ED @Controller() decorator metadata
+        return (Reflect.hasMetadata(TSED_CONTROLLER_KEY, target) ||
+            Reflect.hasMetadata(TSED_CONTROLLER_URL, target) ||
+            // Ts.ED v7+ uses "injectable:type" with value "controller"
+            Reflect.getMetadata("injectable:type", target) === "controller");
+    },
+    extractMethods(controller) {
+        if (typeof controller !== "function")
+            return [];
+        const ctor = controller;
+        const name = ctor.name.charAt(0).toLowerCase() + ctor.name.slice(1);
+        return extractMethodsFromPrototype(name, ctor);
+    },
+};
+//# sourceMappingURL=tsed-adapter.js.map

package/dist/adapters/tsed-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsed-adapter.js","sourceRoot":"","sources":["../../src/adapters/tsed-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,0CAA0C;AAC1C,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAC9C,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IAEb,YAAY,CAAC,MAAe;QAC1B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC/C,mDAAmD;QACnD,OAAO,CACL,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC;YAChD,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC;YAChD,2DAA2D;YAC3D,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,YAAY,CAChE,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,IAAI,OAAO,UAAU,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,UAAiD,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/autobarrel/index.d.ts

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

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

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

package/dist/autobarrel/index.js

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

package/dist/autobarrel/index.js.map

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

package/dist/autobarrel/scanner.d.ts

@@ -0,0 +1,14 @@
+import type { FrameworkAdapter } from "../types/adapter.js";
+/**
+ * Scan a directory for controller classes.
+ *
+ * Recursively walks the directory, imports all .ts/.js files,
+ * and collects exports that the adapter recognizes as controllers
+ * (or whose name ends with "Controller").
+ *
+ * @param dirPath - Path to the controllers directory (relative or absolute)
+ * @param adapter - Framework adapter with isController() predicate
+ * @returns Object of discovered controller classes: { UserController, OrderController, ... }
+ */
+export declare function scanControllers(dirPath: string, adapter: FrameworkAdapter): Promise<Record<string, unknown>>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/autobarrel/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/autobarrel/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiDlC"}

package/dist/autobarrel/scanner.js

@@ -0,0 +1,93 @@
+import { readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+/**
+ * Scan a directory for controller classes.
+ *
+ * Recursively walks the directory, imports all .ts/.js files,
+ * and collects exports that the adapter recognizes as controllers
+ * (or whose name ends with "Controller").
+ *
+ * @param dirPath - Path to the controllers directory (relative or absolute)
+ * @param adapter - Framework adapter with isController() predicate
+ * @returns Object of discovered controller classes: { UserController, OrderController, ... }
+ */
+export async function scanControllers(dirPath, adapter) {
+    const absolutePath = resolve(process.cwd(), dirPath);
+    const controllers = {};
+    let files;
+    try {
+        files = await readdirRecursive(absolutePath);
+    }
+    catch (err) {
+        throw new Error(`[TypeBridge] Failed to scan controllers directory "${dirPath}": ${err.message}`);
+    }
+    for (const filePath of files) {
+        // Skip non-source files
+        if (!isSourceFile(filePath))
+            continue;
+        try {
+            // Dynamic import using file:// URL (required for ESM)
+            const fileUrl = pathToFileURL(filePath).href;
+            const mod = await import(fileUrl);
+            // Check all named exports
+            for (const [exportName, exportValue] of Object.entries(mod)) {
+                if (exportName === "default")
+                    continue;
+                if (typeof exportValue !== "function")
+                    continue;
+                // Check: adapter says it's a controller, OR name ends with "Controller"
+                const isController = adapter.isController(exportValue) ||
+                    exportName.endsWith("Controller");
+                if (isController) {
+                    controllers[exportName] = exportValue;
+                }
+            }
+        }
+        catch {
+            // Skip files that fail to import (e.g., non-module files, syntax errors)
+        }
+    }
+    if (Object.keys(controllers).length === 0) {
+        console.warn(`[TypeBridge] No controllers found in "${dirPath}". ` +
+            `Make sure controller class names end with "Controller" or use the @Bridge() decorator.`);
+    }
+    return controllers;
+}
+/**
+ * Recursively list all files in a directory.
+ */
+async function readdirRecursive(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const nested = await readdirRecursive(fullPath);
+            files.push(...nested);
+        }
+        else {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Check if a file is a TypeScript/JavaScript source file we should import.
+ */
+function isSourceFile(filePath) {
+    // Include .ts, .js, .mts, .mjs
+    if (!filePath.endsWith(".ts") &&
+        !filePath.endsWith(".js") &&
+        !filePath.endsWith(".mts") &&
+        !filePath.endsWith(".mjs")) {
+        return false;
+    }
+    // Exclude declaration files, tests, specs
+    if (filePath.endsWith(".d.ts") || filePath.endsWith(".d.mts"))
+        return false;
+    if (filePath.includes(".test.") || filePath.includes(".spec."))
+        return false;
+    return true;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/autobarrel/scanner.js.map

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

package/dist/bridge.d.ts

@@ -0,0 +1,54 @@
+import type { FrameworkAdapter } from "./types/adapter.js";
+import type { NodeOptions, TypeBridgeAPI } from "./types/options.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 declare 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<P>(): {
+        create: {
+            /** Object controllers — fully typed local + remote */
+            <C extends Record<string, unknown>>(adapter: FrameworkAdapter, options: NodeOptions<C>): Promise<TypeBridgeAPI<C> & Omit<P, "close" | "name" | "port" | "__controllers" | "__mesh">>;
+            /** Autobarrel — directory path */
+            (adapter: FrameworkAdapter, options: NodeOptions<string>): Promise<TypeBridgeAPI<Record<string, unknown>> & Omit<P, "close" | "name" | "port" | "__controllers" | "__mesh">>;
+        };
+    };
+    /** Object controllers — fully typed */
+    static create<C extends Record<string, unknown>>(adapter: FrameworkAdapter, options: NodeOptions<C>): Promise<TypeBridgeAPI<C>>;
+    /** Autobarrel — directory path, controllers discovered at runtime */
+    static create(adapter: FrameworkAdapter, options: NodeOptions<string>): Promise<TypeBridgeAPI<Record<string, unknown>>>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASrE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC;gBAGoB;YAC3B,sDAAsD;YACtD,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,kEAAkB,CAAC,CAAC;YAC/C,kCAAkC;YAClC,CACE,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kEAAkB,CAAC,CAAC;SACtE;;IAIL,uCAAuC;WAC1B,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAE5B,qEAAqE;WACxD,MAAM,CACjB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAkGnD"}