@kb-labs/adapters-service-transport-http 2.96.0

package/README.md

@@ -0,0 +1,13 @@
+# @kb-labs/adapters-service-transport-http
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem.
+
+HTTP/unix-socket implementation of `IServiceTransport` using undici connection pools. Platform-only adapter — never exposed to plugin context.
+
+## Overview
+
+| Property | Value |
+|----------|-------|
+| Interface | `IServiceTransport` |
+| Backend | undici (HTTP + unix domain sockets) |
+| Layer | Adapter (Layer 2) |

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { IServiceTransport, ServiceConnectionInfo, ServiceListenAddress, ServiceTransportRequest, ServiceTransportResponse, ServiceTransportStream, ServiceTransportHealth } from '@kb-labs/sdk';
+export { IServiceTransport, ServiceConnectionInfo, ServiceTransportHealth, ServiceTransportRequest, ServiceTransportResponse, ServiceTransportStream } from '@kb-labs/sdk';
+import { AdapterManifest } from '@kb-labs/sdk/adapters';
+
+interface HttpServiceTransportConfig {
+    services: Record<string, {
+        url: string;
+        socketPath?: string;
+        timeoutMs?: number;
+    }>;
+    /**
+     * Per-environment TCP port shift, added to every service url's port. Sockets
+     * are unaffected (they isolate via KB_SOCKET_HASH path, not port). This is a
+     * LOCAL mechanism for running multiple environments on one host; in
+     * cloud/k8s the offset is 0 and isolation comes from namespace/DNS. Falls
+     * back to the KB_NET_OFFSET env var when not set in config.
+     */
+    offset?: number;
+}
+/**
+ * Shift the port of a TCP url by offset, leaving scheme/host/path intact.
+ * No-op for offset 0, urls without an explicit port (e.g. socket placeholders),
+ * or unparseable urls. The single helper used for both route and bind so the
+ * two never drift.
+ */
+declare function applyPortOffset(url: string, offset: number): string;
+declare class HttpServiceTransport implements IServiceTransport {
+    private readonly config;
+    private readonly pools;
+    private readonly offset;
+    constructor(config: HttpServiceTransportConfig);
+    connectionInfo(serviceId: string): ServiceConnectionInfo | undefined;
+    listenAddress(serviceId: string): ServiceListenAddress | undefined;
+    call(serviceId: string, req: ServiceTransportRequest): Promise<ServiceTransportResponse>;
+    stream(serviceId: string, req: ServiceTransportRequest): Promise<ServiceTransportStream>;
+    private _request;
+    health(): Promise<ServiceTransportHealth>;
+    /** Drain and close all connection pools. */
+    destroy(): Promise<void>;
+}
+
+declare const manifest: AdapterManifest;
+
+/**
+ * @module @kb-labs/adapters-service-transport-http
+ * HTTP/unix-socket implementation of IServiceTransport.
+ *
+ * Uses undici connection pools — supports both TCP and unix domain sockets.
+ * Platform-only: never exposed to plugin context.
+ */
+
+declare function createAdapter(config: HttpServiceTransportConfig): HttpServiceTransport;
+
+export { HttpServiceTransport, type HttpServiceTransportConfig, applyPortOffset, createAdapter, manifest };

package/dist/index.js

@@ -0,0 +1,138 @@
+import { Pool } from 'undici';
+
+// src/transport.ts
+function applyPortOffset(url, offset) {
+  if (!offset) return url;
+  try {
+    const u = new URL(url);
+    if (!u.port) return url;
+    u.port = String(Number(u.port) + offset);
+    return u.toString().replace(/\/$/, "");
+  } catch {
+    return url;
+  }
+}
+function assertResolvedSocketPath(socketPath, serviceId) {
+  if (/\$\{[^}]+\}/.test(socketPath)) {
+    throw new Error(
+      `Service "${serviceId}" has an unresolved placeholder in socketPath: "${socketPath}". Check that the required environment variable is set (e.g. KB_SOCKET_HASH).`
+    );
+  }
+}
+var HttpServiceTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.offset = config.offset ?? (Number(process.env.KB_NET_OFFSET) || 0);
+    for (const [id, svc] of Object.entries(config.services)) {
+      const base = svc.socketPath ? svc.url : applyPortOffset(svc.url, this.offset);
+      this.pools.set(id, new Pool(base, {
+        ...svc.socketPath ? { socketPath: svc.socketPath } : {},
+        connections: 10,
+        pipelining: 0
+      }));
+    }
+  }
+  config;
+  pools = /* @__PURE__ */ new Map();
+  offset;
+  connectionInfo(serviceId) {
+    const svc = this.config.services[serviceId];
+    if (!svc) return void 0;
+    if (svc.socketPath) assertResolvedSocketPath(svc.socketPath, serviceId);
+    const baseUrl = svc.socketPath ? svc.url : applyPortOffset(svc.url, this.offset);
+    return { baseUrl, socketPath: svc.socketPath };
+  }
+  listenAddress(serviceId) {
+    const svc = this.config.services[serviceId];
+    if (!svc) return void 0;
+    if (svc.socketPath) {
+      assertResolvedSocketPath(svc.socketPath, serviceId);
+      return { socketPath: svc.socketPath };
+    }
+    let port;
+    try {
+      const u = new URL(applyPortOffset(svc.url, this.offset));
+      if (!u.port) return void 0;
+      port = Number(u.port);
+    } catch {
+      return void 0;
+    }
+    return { port };
+  }
+  async call(serviceId, req) {
+    const { statusCode, headers, body } = await this._request(serviceId, req);
+    const payload = await body.json().catch(async () => {
+      const text = await body.text().catch(() => void 0);
+      return text ?? void 0;
+    });
+    return { ok: statusCode < 400, statusCode, payload, metadata: headers };
+  }
+  async stream(serviceId, req) {
+    const { statusCode, headers, body } = await this._request(serviceId, req);
+    return {
+      ok: statusCode < 400,
+      statusCode,
+      body,
+      metadata: headers
+    };
+  }
+  async _request(serviceId, req) {
+    const pool = this.pools.get(serviceId);
+    if (!pool) throw new Error(`Unknown service: ${serviceId}`);
+    const svc = this.config.services[serviceId];
+    const method = req.metadata?.["http-method"] ?? (req.payload !== void 0 ? "POST" : "GET");
+    return pool.request({
+      method,
+      path: req.path,
+      headers: {
+        ...req.payload !== void 0 ? { "content-type": "application/json" } : {},
+        ...req.metadata
+      },
+      body: req.payload !== void 0 ? JSON.stringify(req.payload) : void 0,
+      headersTimeout: req.timeoutMs ?? svc.timeoutMs ?? 3e4,
+      signal: req.signal
+    });
+  }
+  async health() {
+    const results = {};
+    await Promise.allSettled(
+      Object.keys(this.config.services).map(async (id) => {
+        try {
+          const res = await this.call(id, { path: "/health" });
+          results[id] = res.ok;
+        } catch {
+          results[id] = false;
+        }
+      })
+    );
+    const allOk = Object.values(results).every(Boolean);
+    return { status: allOk ? "ok" : "degraded", services: results };
+  }
+  /** Drain and close all connection pools. */
+  async destroy() {
+    await Promise.allSettled(
+      Array.from(this.pools.values()).map((pool) => pool.destroy())
+    );
+    this.pools.clear();
+  }
+};
+
+// src/manifest.ts
+var manifest = {
+  manifestVersion: "1.0.0",
+  id: "service-transport-http",
+  name: "HTTP Service Transport",
+  version: "1.0.0",
+  description: "HTTP/unix-socket transport for gateway \u2192 service communication",
+  type: "core",
+  implements: "IServiceTransport"
+};
+
+// src/index.ts
+function createAdapter(config) {
+  return new HttpServiceTransport(config);
+}
+
+export { HttpServiceTransport, applyPortOffset, createAdapter, manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport.ts","../src/manifest.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Pool } from 'undici';\nimport type {\n  IServiceTransport,\n  ServiceConnectionInfo,\n  ServiceListenAddress,\n  ServiceTransportRequest,\n  ServiceTransportResponse,\n  ServiceTransportStream,\n  ServiceTransportHealth,\n} from '@kb-labs/sdk';\n\nexport interface HttpServiceTransportConfig {\n  services: Record<string, {\n    url: string;\n    socketPath?: string;\n    timeoutMs?: number;\n  }>;\n  /**\n   * Per-environment TCP port shift, added to every service url's port. Sockets\n   * are unaffected (they isolate via KB_SOCKET_HASH path, not port). This is a\n   * LOCAL mechanism for running multiple environments on one host; in\n   * cloud/k8s the offset is 0 and isolation comes from namespace/DNS. Falls\n   * back to the KB_NET_OFFSET env var when not set in config.\n   */\n  offset?: number;\n}\n\n/**\n * Shift the port of a TCP url by offset, leaving scheme/host/path intact.\n * No-op for offset 0, urls without an explicit port (e.g. socket placeholders),\n * or unparseable urls. The single helper used for both route and bind so the\n * two never drift.\n */\nexport function applyPortOffset(url: string, offset: number): string {\n  if (!offset) return url;\n  try {\n    const u = new URL(url);\n    if (!u.port) return url;\n    u.port = String(Number(u.port) + offset);\n    return u.toString().replace(/\\/$/, '');\n  } catch {\n    return url;\n  }\n}\n\nfunction assertResolvedSocketPath(socketPath: string, serviceId: string): void {\n  if (/\\$\\{[^}]+\\}/.test(socketPath)) {\n    throw new Error(\n      `Service \"${serviceId}\" has an unresolved placeholder in socketPath: \"${socketPath}\". ` +\n      `Check that the required environment variable is set (e.g. KB_SOCKET_HASH).`,\n    );\n  }\n}\n\nexport class HttpServiceTransport implements IServiceTransport {\n  private readonly pools = new Map<string, Pool>();\n  private readonly offset: number;\n\n  constructor(private readonly config: HttpServiceTransportConfig) {\n    this.offset = config.offset ?? (Number(process.env.KB_NET_OFFSET) || 0);\n    for (const [id, svc] of Object.entries(config.services)) {\n      // Socket services route via socketPath; their url is a placeholder, so\n      // the offset is harmlessly skipped. TCP services get the shifted url.\n      const base = svc.socketPath ? svc.url : applyPortOffset(svc.url, this.offset);\n      this.pools.set(id, new Pool(base, {\n        ...(svc.socketPath ? { socketPath: svc.socketPath } : {}),\n        connections: 10,\n        pipelining: 0,\n      }));\n    }\n  }\n\n  connectionInfo(serviceId: string): ServiceConnectionInfo | undefined {\n    const svc = this.config.services[serviceId];\n    if (!svc) return undefined;\n    if (svc.socketPath) assertResolvedSocketPath(svc.socketPath, serviceId);\n    const baseUrl = svc.socketPath ? svc.url : applyPortOffset(svc.url, this.offset);\n    return { baseUrl, socketPath: svc.socketPath };\n  }\n\n  listenAddress(serviceId: string): ServiceListenAddress | undefined {\n    const svc = this.config.services[serviceId];\n    if (!svc) return undefined;\n    if (svc.socketPath) {\n      assertResolvedSocketPath(svc.socketPath, serviceId);\n      return { socketPath: svc.socketPath };\n    }\n    // Same offset as the route, so bind and route ports never drift. Host is\n    // omitted — the local adapter doesn't own the bind host; the daemon keeps\n    // its own host config. Guard a url without an explicit port (would parse to\n    // 0): return undefined so the caller falls back to its default port.\n    let port: number;\n    try {\n      const u = new URL(applyPortOffset(svc.url, this.offset));\n      if (!u.port) return undefined;\n      port = Number(u.port);\n    } catch {\n      return undefined;\n    }\n    return { port };\n  }\n\n  async call(serviceId: string, req: ServiceTransportRequest): Promise<ServiceTransportResponse> {\n    const { statusCode, headers, body } = await this._request(serviceId, req);\n    const payload = await body.json().catch(async () => {\n      const text = await body.text().catch(() => undefined);\n      return text ?? undefined;\n    });\n    return { ok: statusCode < 400, statusCode, payload, metadata: headers as Record<string, string> };\n  }\n\n  async stream(serviceId: string, req: ServiceTransportRequest): Promise<ServiceTransportStream> {\n    const { statusCode, headers, body } = await this._request(serviceId, req);\n    return {\n      ok: statusCode < 400,\n      statusCode,\n      body: body as unknown as AsyncIterable<Uint8Array>,\n      metadata: headers as Record<string, string>,\n    };\n  }\n\n  private async _request(serviceId: string, req: ServiceTransportRequest) {\n    const pool = this.pools.get(serviceId);\n    if (!pool) throw new Error(`Unknown service: ${serviceId}`);\n\n    const svc = this.config.services[serviceId]!;\n    const method = req.metadata?.['http-method'] ?? (req.payload !== undefined ? 'POST' : 'GET');\n\n    return pool.request({\n      method,\n      path: req.path,\n      headers: {\n        ...(req.payload !== undefined ? { 'content-type': 'application/json' } : {}),\n        ...req.metadata,\n      },\n      body: req.payload !== undefined ? JSON.stringify(req.payload) : undefined,\n      headersTimeout: req.timeoutMs ?? svc.timeoutMs ?? 30_000,\n      signal: req.signal,\n    });\n  }\n\n  async health(): Promise<ServiceTransportHealth> {\n    const results: Record<string, boolean> = {};\n    await Promise.allSettled(\n      Object.keys(this.config.services).map(async id => {\n        try {\n          const res = await this.call(id, { path: '/health' });\n          results[id] = res.ok;\n        } catch {\n          results[id] = false;\n        }\n      }),\n    );\n    const allOk = Object.values(results).every(Boolean);\n    return { status: allOk ? 'ok' : 'degraded', services: results };\n  }\n\n  /** Drain and close all connection pools. */\n  async destroy(): Promise<void> {\n    await Promise.allSettled(\n      Array.from(this.pools.values()).map(pool => pool.destroy()),\n    );\n    this.pools.clear();\n  }\n}\n","import type { AdapterManifest } from '@kb-labs/sdk/adapters';\n\nexport const manifest: AdapterManifest = {\n  manifestVersion: '1.0.0',\n  id: 'service-transport-http',\n  name: 'HTTP Service Transport',\n  version: '1.0.0',\n  description: 'HTTP/unix-socket transport for gateway → service communication',\n  type: 'core',\n  implements: 'IServiceTransport',\n};\n","/**\n * @module @kb-labs/adapters-service-transport-http\n * HTTP/unix-socket implementation of IServiceTransport.\n *\n * Uses undici connection pools — supports both TCP and unix domain sockets.\n * Platform-only: never exposed to plugin context.\n */\n\nimport { HttpServiceTransport, type HttpServiceTransportConfig } from './transport.js';\n\nexport { HttpServiceTransport, type HttpServiceTransportConfig, applyPortOffset } from './transport.js';\nexport { manifest } from './manifest.js';\n\nexport function createAdapter(config: HttpServiceTransportConfig): HttpServiceTransport {\n  return new HttpServiceTransport(config);\n}\n\nexport type {\n  IServiceTransport,\n  ServiceConnectionInfo,\n  ServiceTransportRequest,\n  ServiceTransportResponse,\n  ServiceTransportStream,\n  ServiceTransportHealth,\n} from '@kb-labs/sdk';\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kb-labs/adapters-service-transport-http",
+  "description": "HTTP/unix-socket service transport implementing IServiceTransport",
+  "version": "2.96.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "undici": "^7"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "fastify": "^5.8.5",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6",
+    "@kb-labs/sdk": "2.21.2",
+    "@kb-labs/devkit": "2.96.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "peerDependencies": {
+    "@kb-labs/sdk": "^2.21.2"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit"
+  }
+}