service-bridge 1.8.5-dev.49 → 2.0.0-alpha

package/package.json

@@ -1,125 +1,109 @@
 {
-  "name": "service-bridge",
-  "version": "1.8.5-dev.49",
-  "type": "module",
-  "description": "ServiceBridge SDK for Node.js — one self-hosted runtime for RPC, events, workflows, and jobs without a service mesh or sidecars. Direct gRPC between workers; durable events, jobs, tracing, auto mTLS. One Go runtime + PostgreSQL.",
-  "keywords": [
-    "servicebridge",
-    "service-bridge",
-    "microservices",
-    "rpc",
-    "grpc",
-    "event-bus",
-    "event-driven",
-    "distributed-tracing",
-    "workflow",
-    "orchestration",
-    "background-jobs",
-    "cron",
-    "mtls",
-    "service-mesh",
-    "service-discovery",
-    "distributed-systems",
-    "zero-sidecar",
-    "proxyless",
-    "istio-alternative",
-    "rabbitmq-alternative",
-    "temporal-alternative",
-    "jaeger-alternative",
-    "postgresql",
-    "docker",
-    "kubernetes",
-    "dead-letter-queue",
-    "dlq",
-    "saga",
-    "distributed-transactions",
-    "ai-agent-orchestration",
-    "express",
-    "fastify",
-    "http-middleware",
-    "observability",
-    "prometheus",
-    "tracing",
-    "typescript",
-    "nodejs",
-    "production-ready",
-    "self-hosted"
-  ],
-  "homepage": "https://servicebridge.dev",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/service-bridge/sdk"
-  },
-  "private": false,
-  "license": "SEE LICENSE IN LICENSE",
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist/index.js",
-    "dist/index.d.ts",
-    "dist/express.js",
-    "dist/express.d.ts",
-    "dist/fastify.js",
-    "dist/fastify.d.ts",
-    "dist/trace.d.ts",
-    "README.md",
-    "LICENSE"
-  ],
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./express": {
-      "import": "./dist/express.js",
-      "types": "./dist/express.d.ts"
-    },
-    "./fastify": {
-      "import": "./dist/fastify.js",
-      "types": "./dist/fastify.d.ts"
-    }
-  },
-  "scripts": {
-    "generate:proto": "bun run sdk/scripts/generate-proto.ts",
-    "build:core": "bun build sdk/src/index.ts --outdir=dist --target=node -e @grpc/grpc-js -e @grpc/proto-loader -e protobufjs -e long",
-    "build:types": "bunx tsc -p sdk/tsconfig.json --emitDeclarationOnly --outDir dist && bunx tsc -p http/tsconfig.json --emitDeclarationOnly --outDir http/dist && cp http/dist/express.d.ts http/dist/fastify.d.ts http/dist/trace.d.ts dist/",
-    "build:express": "bun build ./http/src/express.ts --outfile=dist/express.js --target=node -e service-bridge",
-    "build:fastify": "bun build ./http/src/fastify.ts --outfile=dist/fastify.js --target=node -e service-bridge",
-    "build": "bun run build:core && bun run build:express && bun run build:fastify && bun run build:types",
-    "test:sdk": "bun test sdk",
-    "test:http": "bun test --tsconfig-override http/tsconfig.test.json http",
-    "test": "bun run test:sdk && bun run test:http",
-    "typecheck": "bunx tsc -p sdk/tsconfig.json --noEmit && bunx tsc -p http/tsconfig.json --noEmit",
-    "lint": "bunx biome check .",
-    "lint:fix": "bunx biome check . --write"
-  },
-  "dependencies": {
-    "@grpc/grpc-js": "^1.9.0",
-    "@grpc/proto-loader": "^0.7.10",
-    "protobufjs": "^8.0.0"
-  },
-  "peerDependencies": {
-    "express": "",
-    "fastify": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "express": {
-      "optional": true
-    },
-    "fastify": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.4.5",
-    "@types/bun": "latest",
-    "@types/express": "^5.0.6",
-    "@types/node": "^20.0.0",
-    "express": "^4.21.2",
-    "fastify": "^4.29.0",
-    "typescript": "^5.3.0"
-  }
+	"name": "service-bridge",
+	"version": "2.0.0-alpha",
+	"description": "TypeScript SDK for ServiceBridge — RPC, durable events, workflows, jobs and observability over a single self-hosted gRPC runtime with mTLS.",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/service-bridge/sdk.git",
+		"directory": "node"
+	},
+	"homepage": "https://servicebridge.dev",
+	"publishConfig": {
+		"tag": "alpha",
+		"access": "public",
+		"provenance": true
+	},
+	"keywords": [
+		"microservices",
+		"rpc",
+		"events",
+		"workflows",
+		"grpc",
+		"mtls",
+		"observability"
+	],
+	"engines": {
+		"node": ">=18",
+		"bun": ">=1.0"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"dev": "bun run --hot index.ts",
+		"start": "bun run index.ts",
+		"build": "tsup",
+		"prepack": "bun run build",
+		"lint": "biome check .",
+		"format": "biome format --write .",
+		"typecheck": "tsc --noEmit",
+		"check": "biome check --write . && tsc --noEmit"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./express": {
+			"types": "./dist/http/express/index.d.ts",
+			"import": "./dist/http/express/index.js"
+		},
+		"./fastify": {
+			"types": "./dist/http/fastify/index.d.ts",
+			"import": "./dist/http/fastify/index.js"
+		},
+		"./hono": {
+			"types": "./dist/http/hono/index.d.ts",
+			"import": "./dist/http/hono/index.js"
+		}
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.15",
+		"@hono/node-server": "^2.0.4",
+		"@types/better-sqlite3": "^7.6.13",
+		"@types/bun": "latest",
+		"@types/express": "^5.0.6",
+		"@types/pg": "^8.20.0",
+		"express": "^5.2.1",
+		"fast-check": "^4.8.0",
+		"fastify": "^5",
+		"hono": "^4",
+		"pg": "^8.21.0",
+		"ts-proto": "^2.11.8",
+		"tsup": "^8.5.1"
+	},
+	"peerDependencies": {
+		"express": "^4 || ^5",
+		"fastify": "^4 || ^5",
+		"hono": "^4",
+		"typescript": "^5"
+	},
+	"peerDependenciesMeta": {
+		"express": {
+			"optional": true
+		},
+		"fastify": {
+			"optional": true
+		},
+		"hono": {
+			"optional": true
+		}
+	},
+	"dependencies": {
+		"@bufbuild/protobuf": "^2.12.0",
+		"@grpc/grpc-js": "1.14.3",
+		"@peculiar/x509": "^2.0.0",
+		"better-sqlite3": "^12.10.0",
+		"fastify-plugin": "^5.0.1",
+		"protobufjs": "^8.4.0",
+		"reflect-metadata": "^0.2.2",
+		"uuidv7": "^1.2.1"
+	}
 }

package/dist/express.d.ts

@@ -1,51 +0,0 @@
-import type { Application, NextFunction, Request, Response } from "express";
-import type { ServiceBridgeService } from "service-bridge";
-import type { IncomingTraceContext } from "./trace";
-import { extractTraceFromHeaders } from "./trace";
-export { extractTraceFromHeaders };
-export type { IncomingTraceContext };
-declare global {
-    namespace Express {
-        interface Request {
-            servicebridge: ServiceBridgeService;
-            traceId?: string;
-            spanId?: string;
-        }
-    }
-}
-export interface ServiceBridgeExpressOptions {
-    /** ServiceBridge client (from servicebridge()). Required. */
-    client: ServiceBridgeService;
-    /** Paths to skip tracing. Default: [] */
-    excludePaths?: string[];
-    /** Set x-trace-id response header for propagation. Default: true */
-    propagateTraceHeader?: boolean;
-    /**
-     * Auto-register route patterns in the ServiceBridge HTTP catalog on first hit.
-     * Routes appear in the UI after their first request. Default: true.
-     * Use registerExpressRoutes() for eager (pre-traffic) registration.
-     */
-    autoRegister?: boolean;
-}
-export declare function servicebridgeMiddleware(options: ServiceBridgeExpressOptions): (req: Request, res: Response, next: NextFunction) => void;
-export interface RegisterExpressRoutesOptions {
-    /** Stable identifier for this process instance used in http_instances. */
-    instanceId?: string;
-    /** Address where this service can be reached, e.g. "http://10.0.0.1:3000" */
-    endpoint?: string;
-    /** Service names allowed to call these endpoints. Default: [] */
-    allowedCallers?: string[];
-    /** Path prefixes to exclude from registration. Default: [] */
-    excludePaths?: string[];
-}
-/**
- * Scan an Express application's route table and register every route pattern
- * in the ServiceBridge HTTP catalog. Safe to call multiple times (idempotent).
- *
- * @example
- * app.get('/users/:id', handler);
- * app.post('/orders', handler);
- * app.listen(3000, () => registerExpressRoutes(app, sb));
- */
-export declare function registerExpressRoutes(app: Application, client: ServiceBridgeService, opts?: RegisterExpressRoutesOptions): Promise<void>;
-//# sourceMappingURL=express.d.ts.map

package/dist/express.js

@@ -1,129 +0,0 @@
-// http/src/express.ts
-import { withTraceContext } from "service-bridge";
-
-// http/src/trace.ts
-function parseTraceparent(traceparent) {
-  const parts = traceparent.trim().split("-");
-  if (parts.length !== 4 || parts[0] !== "00")
-    return null;
-  const [, traceId, parentSpanId] = parts;
-  if (!traceId || !parentSpanId || traceId.length !== 32 || parentSpanId.length !== 16)
-    return null;
-  return { traceId, parentSpanId };
-}
-function randomTraceId() {
-  return crypto.randomUUID().replace(/-/g, "");
-}
-function extractTraceFromHeaders(headers) {
-  const traceparent = headers.traceparent;
-  const tp = Array.isArray(traceparent) ? traceparent[0] : traceparent;
-  if (tp) {
-    const parsed = parseTraceparent(tp);
-    if (parsed)
-      return parsed;
-  }
-  const xTraceId = headers["x-trace-id"];
-  const traceId = Array.isArray(xTraceId) ? xTraceId[0] : xTraceId;
-  if (traceId && typeof traceId === "string") {
-    return { traceId: traceId.trim(), parentSpanId: "" };
-  }
-  return { traceId: randomTraceId(), parentSpanId: "" };
-}
-
-// http/src/express.ts
-function servicebridgeMiddleware(options) {
-  const {
-    client,
-    excludePaths = [],
-    propagateTraceHeader = true,
-    autoRegister = true
-  } = options;
-  const registeredPatterns = new Set;
-  return function middleware(req, res, next) {
-    const path = req.path ?? req.url?.split("?")[0] ?? "/";
-    if (excludePaths.some((p) => path.startsWith(p))) {
-      req.servicebridge = client;
-      next();
-      return;
-    }
-    const headers = {};
-    for (const [k, v] of Object.entries(req.headers)) {
-      if (v != null)
-        headers[k.toLowerCase()] = v;
-    }
-    const traceCtx = extractTraceFromHeaders(headers);
-    const span = client.startHttpSpan({
-      method: req.method,
-      path,
-      traceId: traceCtx.traceId,
-      parentSpanId: traceCtx.parentSpanId
-    });
-    req.servicebridge = client;
-    req.traceId = span.traceId;
-    req.spanId = span.spanId;
-    if (propagateTraceHeader) {
-      res.setHeader("x-trace-id", span.traceId);
-    }
-    const onFinish = () => {
-      res.off("finish", onFinish);
-      res.off("close", onFinish);
-      span.end({
-        statusCode: res.statusCode,
-        success: res.statusCode < 400
-      });
-      if (autoRegister) {
-        const routePattern = req.route?.path;
-        if (routePattern && typeof routePattern === "string") {
-          const key = `${req.method}:${routePattern}`;
-          if (!registeredPatterns.has(key)) {
-            registeredPatterns.add(key);
-            client.registerHttpEndpoint({ method: req.method, route: routePattern }).catch(() => {
-              registeredPatterns.delete(key);
-            });
-          }
-        }
-      }
-    };
-    res.on("finish", onFinish);
-    res.on("close", onFinish);
-    withTraceContext({ traceId: span.traceId, spanId: span.spanId }, () => {
-      next();
-    });
-  };
-}
-async function registerExpressRoutes(app, client, opts = {}) {
-  const { instanceId, endpoint, allowedCallers = [], excludePaths = [] } = opts;
-  const routes = extractExpressRoutes(app);
-  await Promise.allSettled(routes.filter(({ path }) => !excludePaths.some((p) => path.startsWith(p))).map(({ method, path: route }) => client.registerHttpEndpoint({
-    method,
-    route,
-    instanceId,
-    endpoint,
-    allowedCallers
-  })));
-}
-function getLayerStack(app) {
-  const r = app._router ?? app.router;
-  return r?.stack ?? app.stack ?? [];
-}
-function extractExpressRoutes(app, prefix = "") {
-  const routes = [];
-  const stack = getLayerStack(app);
-  for (const layer of stack) {
-    if (layer.route) {
-      const routePath = prefix + (layer.route.path ?? "");
-      const methods = Object.keys(layer.route.methods ?? {}).filter((m) => m !== "_all");
-      for (const method of methods) {
-        routes.push({ method: method.toUpperCase(), path: routePath });
-      }
-    } else if (layer.name === "router" && layer.handle) {
-      routes.push(...extractExpressRoutes(layer.handle, prefix));
-    }
-  }
-  return routes;
-}
-export {
-  servicebridgeMiddleware,
-  registerExpressRoutes,
-  extractTraceFromHeaders
-};

package/dist/fastify.d.ts

@@ -1,43 +0,0 @@
-import type { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
-import type { ServiceBridgeService } from "service-bridge";
-declare module "fastify" {
-    interface FastifyRequest {
-        servicebridge: ServiceBridgeService;
-        traceId?: string;
-        spanId?: string;
-    }
-}
-export interface ServiceBridgeFastifyOptions {
-    /** ServiceBridge client (from servicebridge()). Required. */
-    client: ServiceBridgeService;
-    /** Paths to skip tracing. Default: [] */
-    excludePaths?: string[];
-    /** Set x-trace-id response header for propagation. Default: true */
-    propagateTraceHeader?: boolean;
-    /**
-     * Auto-register every route in the ServiceBridge HTTP catalog via Fastify's
-     * onRoute hook. Routes appear in the UI as soon as the server starts (before
-     * any traffic). Default: true.
-     */
-    autoRegister?: boolean;
-    /**
-     * Options forwarded to registerHttpEndpoint for each auto-discovered route.
-     */
-    register?: {
-        /** Stable identifier for this process instance. */
-        instanceId?: string;
-        /** Address where this service can be reached, e.g. "http://10.0.0.1:3000" */
-        endpoint?: string;
-        /** Service names allowed to call these endpoints. Default: [] */
-        allowedCallers?: string[];
-        /** Path prefixes to exclude from registration. Default: [] */
-        excludePaths?: string[];
-    };
-}
-export declare function servicebridgePlugin(fastify: FastifyInstance, options: ServiceBridgeFastifyOptions): Promise<void>;
-/**
- * Wraps a route handler to run inside trace context.
- * Use when the handler calls req.servicebridge.rpc() or event() — ensures trace propagation.
- */
-export declare function wrapHandler<T>(handler: (request: FastifyRequest, reply: FastifyReply) => T): (request: FastifyRequest, reply: FastifyReply) => T;
-//# sourceMappingURL=fastify.d.ts.map

package/dist/fastify.js

@@ -1,122 +0,0 @@
-// http/src/fastify.ts
-import { withTraceContext } from "service-bridge";
-
-// http/src/trace.ts
-function parseTraceparent(traceparent) {
-  const parts = traceparent.trim().split("-");
-  if (parts.length !== 4 || parts[0] !== "00")
-    return null;
-  const [, traceId, parentSpanId] = parts;
-  if (!traceId || !parentSpanId || traceId.length !== 32 || parentSpanId.length !== 16)
-    return null;
-  return { traceId, parentSpanId };
-}
-function randomTraceId() {
-  return crypto.randomUUID().replace(/-/g, "");
-}
-function extractTraceFromHeaders(headers) {
-  const traceparent = headers.traceparent;
-  const tp = Array.isArray(traceparent) ? traceparent[0] : traceparent;
-  if (tp) {
-    const parsed = parseTraceparent(tp);
-    if (parsed)
-      return parsed;
-  }
-  const xTraceId = headers["x-trace-id"];
-  const traceId = Array.isArray(xTraceId) ? xTraceId[0] : xTraceId;
-  if (traceId && typeof traceId === "string") {
-    return { traceId: traceId.trim(), parentSpanId: "" };
-  }
-  return { traceId: randomTraceId(), parentSpanId: "" };
-}
-
-// http/src/fastify.ts
-async function servicebridgePlugin(fastify, options) {
-  const {
-    client,
-    excludePaths = [],
-    propagateTraceHeader = true,
-    autoRegister = true,
-    register: registerOpts = {}
-  } = options;
-  fastify.decorateRequest("servicebridge", null);
-  fastify.decorateRequest("traceId", null);
-  fastify.decorateRequest("spanId", null);
-  if (autoRegister) {
-    const excludeReg = registerOpts.excludePaths ?? [];
-    fastify.addHook("onRoute", (routeOptions) => {
-      const routePath = routeOptions.url ?? routeOptions.path ?? "";
-      if (excludeReg.some((p) => routePath.startsWith(p)))
-        return;
-      const methods = Array.isArray(routeOptions.method) ? routeOptions.method : [routeOptions.method];
-      for (const method of methods) {
-        if (method === "HEAD" || method === "OPTIONS")
-          continue;
-        client.registerHttpEndpoint({
-          method,
-          route: routePath,
-          instanceId: registerOpts.instanceId,
-          endpoint: registerOpts.endpoint,
-          allowedCallers: registerOpts.allowedCallers ?? []
-        }).catch(() => {});
-      }
-    });
-  }
-  fastify.addHook("onRequest", async (request, reply) => {
-    request.servicebridge = client;
-    const path = request.url?.split("?")[0] ?? "/";
-    if (excludePaths.some((p) => path.startsWith(p))) {
-      return;
-    }
-    const headers = {};
-    for (const [k, v] of Object.entries(request.headers)) {
-      if (typeof v === "string" || Array.isArray(v)) {
-        headers[k.toLowerCase()] = v;
-      }
-    }
-    const traceCtx = extractTraceFromHeaders(headers);
-    const span = client.startHttpSpan({
-      method: request.method,
-      path,
-      traceId: traceCtx.traceId,
-      parentSpanId: traceCtx.parentSpanId
-    });
-    let ended = false;
-    const endSpan = (opts) => {
-      if (ended)
-        return;
-      ended = true;
-      span.end(opts);
-    };
-    request.traceId = span.traceId;
-    request.spanId = span.spanId;
-    if (propagateTraceHeader) {
-      reply.header("x-trace-id", span.traceId);
-    }
-    request.raw.once("close", () => {
-      if (!reply.sent) {
-        endSpan({ success: false, error: "connection closed" });
-      }
-    });
-    reply.raw.once("finish", () => {
-      endSpan({
-        statusCode: reply.statusCode,
-        success: reply.statusCode < 400
-      });
-    });
-  });
-}
-function wrapHandler(handler) {
-  return (request, reply) => {
-    const traceId = request.traceId;
-    const spanId = request.spanId;
-    if (traceId && spanId) {
-      return withTraceContext({ traceId, spanId }, () => handler(request, reply));
-    }
-    return handler(request, reply);
-  };
-}
-export {
-  wrapHandler,
-  servicebridgePlugin
-};

package/dist/trace.d.ts

@@ -1,19 +0,0 @@
-/**
- * Result of extracting trace context from incoming HTTP headers.
- * traceId    — the trace this request belongs to (carry-over or newly generated).
- * parentSpanId — the caller's span ID to use as parent, empty string if unknown.
- */
-export interface IncomingTraceContext {
-    traceId: string;
-    parentSpanId: string;
-}
-/**
- * Extract distributed trace context from incoming HTTP request headers.
- *
- * Priority:
- *  1. W3C `traceparent` — full parent info (traceId + parentSpanId)
- *  2. `x-trace-id`      — traceId only, no parent span known
- *  3. Nothing           — generate a fresh traceId, no parent
- */
-export declare function extractTraceFromHeaders(headers: Record<string, string | string[] | undefined>): IncomingTraceContext;
-//# sourceMappingURL=trace.d.ts.map