service-bridge 1.7.0-dev.34 → 1.7.0-dev.50

package/README.md

@@ -116,7 +116,7 @@ const sb = servicebridge(
   process.env.SERVICEBRIDGE_SERVICE_KEY!,
 );
 
-const result = await sb.rpc<{ ok: boolean; txId: string }>("payments/charge", {
+const result = await sb.rpc<{ ok: boolean; txId: string }>("payment.charge", {
   orderId: "ord_42",
   amount: 4990,
 });
@@ -171,7 +171,7 @@ await payments.serve({ host: "localhost" });
 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", {
+const charge = await orders.rpc<{ ok: boolean; txId: string }>("payment.charge", {
   orderId: "ord_42",
   amount: 4990,
 });
@@ -203,8 +203,8 @@ await notifications.serve({ host: "localhost" });
 // --- Orchestrate as a workflow ---
 
 await orders.workflow("order.fulfillment", [
-  { id: "reserve",  type: "rpc",        ref: "inventory/reserve" },
-  { id: "charge",   type: "rpc",        ref: "payments/charge",      deps: ["reserve"] },
+  { id: "reserve",  type: "rpc",        ref: "inventory.reserve" },
+  { id: "charge",   type: "rpc",        ref: "payment.charge",      deps: ["reserve"] },
   { id: "wait_dlv", type: "event_wait", ref: "shipping.delivered",   deps: ["charge"] },
   { id: "notify",   type: "event",      ref: "orders.fulfilled",     deps: ["wait_dlv"] },
 ]);
@@ -324,16 +324,9 @@ type WorkerTLSOpts = {
 rpc<T = unknown>(fn: string, payload?: unknown, opts?: RpcOpts): Promise<T>
 ```
 
-Calls a registered RPC handler on another service. Direct gRPC path, no proxy.
+Calls a registered RPC handler on another worker. Direct gRPC path, no proxy.
 
-**Function name formats** — `fn` accepts two formats:
-
-| Format | Example | When to use |
-|---|---|---|
-| Plain name | `"charge"` | Function name is globally unique across all services. Resolved automatically via service discovery. |
-| Canonical name | `"payments/charge"` | Multiple services expose a function with the same plain name, or you want to be explicit about the target service. |
-
-Both formats are interchangeable when the name is unique globally. Canonical format is recommended in production for clarity and to avoid ambiguity as your service count grows.
+**Function name** — `fn` is a single **global function name** (the same string passed to `handleRpc` on the callee), e.g. `payment.charge` or `user.get`. It must be unique in the catalog and **must not contain `/`**.
 
 `RpcOpts`:
 
@@ -347,11 +340,9 @@ Both formats are interchangeable when the name is unique globally. Canonical for
 | `mode` | `"direct" \| "proxy"` | Transport mode. `"direct"` (default) connects directly to the worker. `"proxy"` routes through the control plane when direct connection is unavailable. |
 
 ```ts
-// plain name — works when "get" is unique across services
-const user = await sb.rpc<{ id: string; name: string }>("get", { id: "u_1" });
+const user = await sb.rpc<{ id: string; name: string }>("user.get", { id: "u_1" });
 
-// canonical name — explicit service target, always unambiguous
-const user = await sb.rpc<{ id: string; name: string }>("users/get", { id: "u_1" }, {
+const user2 = await sb.rpc<{ id: string; name: string }>("user.get", { id: "u_1" }, {
   timeout: 5000,
   retries: 2,
 });
@@ -391,16 +382,6 @@ await sb.event("orders.created", { orderId: "ord_42" }, {
 
 ---
 
-### `publishEvent(topic, payload?, opts?)`
-
-```ts
-publishEvent(topic: string, payload?: unknown, opts?: PublishEventOpts): Promise<string>
-```
-
-Publishes an event via the established worker session stream. Requires an active worker session — call after `serve()`. Resolves with `messageId` once the server confirms with `publish_ack`. Times out after 30 s if no ack. Use `event()` when not serving (e.g. caller-only services); use `publishEvent()` from within a worker for lower-latency publishing over the existing session.
-
----
-
 ### `job(target, opts)`
 
 ```ts
@@ -421,7 +402,7 @@ Registers a scheduled or delayed job.
 | `retryPolicyJson` | `string` | Retry policy JSON string. |
 
 ```ts
-await sb.job("billing/collect", {
+await sb.job("billing.collect", {
   cron: "0 * * * *",
   timezone: "UTC",
   via: "rpc",
@@ -466,8 +447,8 @@ interface WorkflowOpts {
 
 ```ts
 await sb.workflow("order.fulfillment", [
-  { id: "reserve", type: "rpc", ref: "inventory/reserve" },
-  { id: "charge", type: "rpc", ref: "payments/charge", deps: ["reserve"] },
+  { id: "reserve", type: "rpc", ref: "inventory.reserve" },
+  { id: "charge", type: "rpc", ref: "payment.charge", deps: ["reserve"] },
   { id: "wait_5m", type: "sleep", durationMs: 300_000, deps: ["charge"] },
   { id: "notify", type: "event", ref: "orders.fulfilled", deps: ["wait_5m"] },
 ]);
@@ -554,7 +535,7 @@ Registers an RPC handler. Chainable.
 | `allowedCallers` | `string[]` | Allow-list of caller service names. |
 
 ```ts
-sb.handleRpc("ai/generate", async (payload: { prompt: string }, ctx) => {
+sb.handleRpc("ai.generate", async (payload: { prompt: string }, ctx) => {
   await ctx?.stream.write({ token: "Hello" }, "output");
   await ctx?.stream.write({ token: " world" }, "output");
   return { text: "Hello world" };
@@ -830,7 +811,7 @@ app.use(servicebridgeMiddleware({
 }));
 
 app.get("/users/:id", async (req, res) => {
-  const user = await req.servicebridge.rpc("users/get", { id: req.params.id });
+  const user = await req.servicebridge.rpc("user.get", { id: req.params.id });
   res.json(user);
 });
 ```
@@ -886,7 +867,7 @@ await app.register(servicebridgePlugin, {
 });
 
 app.get("/users/:id", wrapHandler(async (request, reply) => {
-  const user = await request.servicebridge.rpc("users/get", {
+  const user = await request.servicebridge.rpc("user.get", {
     id: (request.params as any).id,
   });
   return reply.send(user);
@@ -983,7 +964,7 @@ const sb = servicebridge(
 import { servicebridge, ServiceBridgeError } from "service-bridge";
 
 try {
-  await sb.rpc("payments/charge", { orderId: "ord_1" });
+  await sb.rpc("payment.charge", { orderId: "ord_1" });
 } catch (e) {
   if (e instanceof ServiceBridgeError) {
     console.error(e.component, e.operation, e.severity, e.retryable, e.code);
@@ -1171,12 +1152,12 @@ session.onConfigPush({
     'payment-svc': { mode: 'proxy', fallbackPolicy: 'fallback_to_direct' },
   },
   functionOverrides: {
-    'payment-svc/charge': { mode: 'proxy', timeoutMs: 5000 },
+    'payment.charge': { mode: 'proxy', timeoutMs: 5000 },
   },
 });
 
 // Разрешить транспорт для функции
-const mode = session.resolveTransportMode('payment-svc/charge'); // 'proxy'
+const mode = session.resolveTransportMode('payment.charge'); // 'proxy'
 ```
 
 ### Все события сессии