service-bridge 1.0.8-dev.19 → 1.0.9-dev.21

package/README.md

@@ -97,7 +97,6 @@ import { servicebridge } from "service-bridge";
 const sb = servicebridge(
   process.env.SERVICEBRIDGE_URL ?? "localhost:14445",
   process.env.SERVICEBRIDGE_SERVICE_KEY!,
-  "payments",
 );
 
 sb.handleRpc("charge", async (payload: { orderId: string; amount: number }) => {
@@ -115,7 +114,6 @@ import { servicebridge } from "service-bridge";
 const sb = servicebridge(
   process.env.SERVICEBRIDGE_URL ?? "localhost:14445",
   process.env.SERVICEBRIDGE_SERVICE_KEY!,
-  "orders",
 );
 
 const result = await sb.rpc<{ ok: boolean; txId: string }>("payments/charge", {
@@ -153,7 +151,7 @@ import { servicebridge } from "service-bridge";
 
 // --- Payments service (worker) ---
 
-const payments = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!, "payments");
+const payments = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!);
 
 payments.handleRpc("charge", async (payload: { orderId: string; amount: number }, ctx) => {
   await ctx?.stream.write({ status: "charging", orderId: payload.orderId }, "progress");
@@ -170,7 +168,7 @@ await payments.serve({ host: "localhost" });
 ```ts
 // --- Orders service (caller + event publisher) ---
 
-const orders = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!, "orders");
+const orders = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!);
 
 // Call payments, then publish event
 const charge = await orders.rpc<{ ok: boolean; txId: string }>("payments/charge", {
@@ -190,7 +188,7 @@ await orders.event("orders.completed", {
 ```ts
 // --- Notifications service (event consumer) ---
 
-const notifications = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!, "notifications");
+const notifications = servicebridge("localhost:14445", process.env.SERVICEBRIDGE_SERVICE_KEY!);
 
 notifications.handleEvent("orders.*", async (payload, ctx) => {
   const body = payload as { orderId: string; txId: string };
@@ -273,18 +271,19 @@ across all three SDKs. Parity differences are naming-only (language idioms):
 - Handler hints: timeout/retryable/concurrency/prefetch are advisory in all SDKs
 - Shared `serve()` fields across SDKs: host, max in-flight, instance ID, weight, and per-serve TLS override
 
-### `servicebridge(url, serviceKey, serviceName?, opts?)`
+### `servicebridge(url, serviceKey, opts?)`
 
 ```ts
 function servicebridge(
   url: string,
   serviceKey: string,
-  service?: string,
-  globalOpts?: ServiceBridgeOpts,
+  serviceOrOpts?: string | ServiceBridgeOpts,
+  maybeGlobalOpts?: ServiceBridgeOpts,
 ): ServiceBridgeService
 ```
 
 Creates an SDK client instance.
+Service identity is resolved by the runtime from `serviceKey`; passing a third `service` argument is legacy-only.
 
 `ServiceBridgeOpts`:
 
@@ -540,7 +539,7 @@ Registers an event consumer handler. Chainable.
 
 | Option | Type | Description |
 |---|---|---|
-| `groupName` | `string` | Consumer group name. Default: `<service>.<pattern>`. |
+| `groupName` | `string` | Consumer group name. Default: `<service-key-id>.<pattern>`. |
 | `concurrency` | `number` | Advisory concurrency hint (currently not hard-enforced). |
 | `prefetch` | `number` | Advisory prefetch hint (currently not hard-enforced). |
 | `retryPolicyJson` | `string` | Retry policy JSON string. |
@@ -766,7 +765,7 @@ import express from "express";
 import { servicebridge } from "service-bridge";
 import { servicebridgeMiddleware, registerExpressRoutes } from "service-bridge/express";
 
-const sb = servicebridge(process.env.SERVICEBRIDGE_URL!, process.env.SERVICEBRIDGE_SERVICE_KEY!, "api");
+const sb = servicebridge(process.env.SERVICEBRIDGE_URL!, process.env.SERVICEBRIDGE_SERVICE_KEY!);
 const app = express();
 
 app.use(servicebridgeMiddleware({
@@ -822,7 +821,7 @@ import Fastify from "fastify";
 import { servicebridge } from "service-bridge";
 import { servicebridgePlugin, wrapHandler } from "service-bridge/fastify";
 
-const sb = servicebridge(process.env.SERVICEBRIDGE_URL!, process.env.SERVICEBRIDGE_SERVICE_KEY!, "api");
+const sb = servicebridge(process.env.SERVICEBRIDGE_URL!, process.env.SERVICEBRIDGE_SERVICE_KEY!);
 const app = Fastify();
 
 await app.register(servicebridgePlugin, {
@@ -895,13 +894,11 @@ The SDK requires values you pass into `servicebridge(...)`. Common setup:
 |---|---|---|---|
 | `SERVICEBRIDGE_URL` | yes | `localhost:14445` | gRPC control plane URL |
 | `SERVICEBRIDGE_SERVICE_KEY` | yes | `sbv2.<id>.<secret>.<ca>` | Service authentication key (sbv2 only) |
-| `SERVICEBRIDGE_SERVICE` | yes (worker mode) | `orders` | Service name in registry |
 
 ```ts
 const sb = servicebridge(
   process.env.SERVICEBRIDGE_URL ?? "localhost:14445",
   process.env.SERVICEBRIDGE_SERVICE_KEY!,
-  process.env.SERVICEBRIDGE_SERVICE ?? "orders",
 );
 ```
 

package/dist/index.js

@@ -458,7 +458,11 @@ function ensureSbResolverRegistered() {
   }
   registerResolver("sb", SbResolver);
 }
-function servicebridge(url, serviceKey, service = "", globalOpts = {}) {
+function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}) {
+  const service = typeof serviceOrOpts === "string" ? serviceOrOpts.trim() : "";
+  const globalOpts = typeof serviceOrOpts === "string" ? maybeGlobalOpts : serviceOrOpts ?? {};
+  const parsedServiceKey = parseServiceKeyV2(serviceKey);
+  const defaultConsumerPrefix = service || parsedServiceKey.keyId || "consumer";
   const meta = new grpc.Metadata;
   meta.add("x-service-key", serviceKey);
   const rawUrl = url.trim();
@@ -1511,7 +1515,7 @@ function servicebridge(url, serviceKey, service = "", globalOpts = {}) {
     },
     handleEvent(pattern, handler, opts) {
       const normalizedOpts = opts ?? {};
-      const groupName = normalizedOpts.groupName || `${service}.${pattern}`;
+      const groupName = normalizedOpts.groupName || `${defaultConsumerPrefix}.${pattern}`;
       if (eventHandlers.has(groupName)) {
         throw new Error(`Duplicate event consumer group "${groupName}". ` + "Use a distinct groupName for each handleEvent() registration.");
       }
@@ -1529,9 +1533,6 @@ function servicebridge(url, serviceKey, service = "", globalOpts = {}) {
       if (fnHandlers.size === 0 && eventHandlers.size === 0) {
         throw new Error("No handlers registered. Call handleRpc() or handleEvent() before serve().");
       }
-      if (!service.trim()) {
-        throw new Error("serve() requires a non-empty service name");
-      }
       if (opts.maxInFlight != null && (!Number.isInteger(opts.maxInFlight) || opts.maxInFlight < 1)) {
         throw new Error("serve() maxInFlight must be a positive integer");
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "service-bridge",
-  "version": "1.0.8-dev.19",
+  "version": "1.0.9-dev.21",
   "type": "module",
   "description": "ServiceBridge SDK for Node.js — production-ready RPC, durable events, workflows, jobs, and distributed tracing. One Go runtime + PostgreSQL replaces Istio, RabbitMQ, Temporal, and Jaeger.",
   "keywords": [