service-bridge 1.0.10-dev.23 → 1.0.10-dev.26

package/dist/index.js

@@ -90,7 +90,27 @@ class ServiceBridgeError extends Error {
     this.operation = opts.operation;
     this.severity = opts.severity;
     this.retryable = opts.severity === "retriable";
-    this.cause = opts.cause;
+    Object.defineProperty(this, "cause", {
+      value: opts.cause,
+      writable: true,
+      enumerable: false,
+      configurable: true
+    });
+  }
+  toString() {
+    return `ServiceBridgeError [${this.severity}]: ${this.message} (${this.operation})`;
+  }
+  [Symbol.for("nodejs.util.inspect.custom")]() {
+    const lines = [
+      `ServiceBridgeError [${this.severity}]`,
+      `  operation: ${this.operation}`,
+      `  message:   ${this.message}`
+    ];
+    if (this.code !== undefined) {
+      lines.push(`  code:      ${this.code}`);
+    }
+    return lines.join(`
+`);
   }
 }
 function containsValue(values, value) {
@@ -214,7 +234,14 @@ function normalizeServiceError(err, operation, component = "control-plane") {
   }
   const grpcErr = err;
   const code = typeof grpcErr?.code === "number" ? grpcErr.code : undefined;
-  const message = typeof grpcErr?.message === "string" && grpcErr.message.length > 0 ? grpcErr.message : err instanceof Error ? err.message : String(err);
+  const details = typeof grpcErr?.details === "string" && grpcErr.details.trim() ? grpcErr.details.trim() : undefined;
+  const rawMsg = (() => {
+    const m = typeof grpcErr?.message === "string" && grpcErr.message ? grpcErr.message : err instanceof Error ? err.message : String(err);
+    return m.replace(/^\d+\s+[A-Z_]+:\s*/, "").trim() || m;
+  })();
+  const base = friendlyGrpcMessage(code, details ?? rawMsg);
+  const appendDetails = details && (code === grpc.status.INTERNAL || code === grpc.status.UNKNOWN || code === undefined);
+  const message = appendDetails ? `${base}: ${details}` : base;
   return new ServiceBridgeError({
     message,
     code,
@@ -225,6 +252,8 @@ function normalizeServiceError(err, operation, component = "control-plane") {
   });
 }
 function friendlyGrpcMessage(code, rawMessage) {
+  if (code === undefined)
+    return rawMessage || "unknown error";
   switch (code) {
     case grpc.status.UNAVAILABLE:
       return "control plane unavailable";
@@ -246,12 +275,14 @@ function friendlyGrpcMessage(code, rawMessage) {
       return "request cancelled";
     case grpc.status.UNIMPLEMENTED:
       return "operation not supported by control plane";
+    case grpc.status.UNKNOWN:
+      return "unknown error from control plane";
     default:
       return rawMessage || "unknown error";
   }
 }
 function friendlySDKMessage(operation, err) {
-  const base = friendlyGrpcMessage(err.code, err.message);
+  const base = err.message;
   switch (operation) {
     case "open-worker-session":
     case "worker-session":
@@ -268,7 +299,7 @@ function friendlySDKMessage(operation, err) {
       return `offline queue flush failed: ${base}`;
     case "flush-on-ready":
     case "flush-on-restore":
-      return `log flush failed: ${base}`;
+      return `offline queue flush failed: ${base}`;
     case "report-call-start":
     case "report-call":
       return `call report failed: ${base}`;
@@ -884,12 +915,15 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
       onlineRestoreTimer = null;
       if (!stopped) {
         isOnline = true;
+        const queueLen = offlineQueue.length;
+        console.info(`[servicebridge] reconnected to runtime${queueLen > 0 ? ` — flushing ${queueLen} queued operation(s)` : ""}`);
         flushQueue().catch((err) => {
           if (isConnectionError(err))
             scheduleOnlineRestore();
           else
             reportSDKError("flush-on-restore", err);
         });
+        scheduleNextHeartbeat(100);
       }
     }, 2000);
   }
@@ -924,6 +958,9 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
       attempt
     }).catch((err) => {
       if (isConnectionError(err)) {
+        if (isOnline) {
+          console.warn("[servicebridge] lost connection to runtime — entering offline mode");
+        }
         isOnline = false;
         scheduleOnlineRestore();
         enqueueOffline({
@@ -972,6 +1009,9 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
       error
     }).catch((err) => {
       if (isConnectionError(err)) {
+        if (isOnline) {
+          console.warn("[servicebridge] lost connection to runtime — entering offline mode");
+        }
         isOnline = false;
         scheduleOnlineRestore();
         enqueueOffline({
@@ -993,6 +1033,10 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
     });
   }
   async function flushQueue() {
+    if (offlineQueue.length === 0)
+      return;
+    const snapshot = offlineQueue.slice();
+    let flushed = 0;
     while (offlineQueue.length > 0 && isOnline) {
       const op = offlineQueue[0];
       try {
@@ -1036,8 +1080,12 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
           await sendReportCall(op);
         }
         offlineQueue.shift();
+        flushed++;
       } catch (err) {
         if (isConnectionError(err)) {
+          if (isOnline) {
+            console.warn("[servicebridge] lost connection to runtime — entering offline mode");
+          }
           isOnline = false;
           scheduleOnlineRestore();
           break;
@@ -1046,6 +1094,18 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
         break;
       }
     }
+    if (flushed > 0) {
+      const remaining = offlineQueue.length;
+      const sentOps = snapshot.slice(0, flushed);
+      console.info(`[servicebridge] flushed ${flushed}/${snapshot.length} queued operation(s) to runtime` + ` (${formatQueueSummary(sentOps)})` + (remaining > 0 ? ` — ${remaining} still queued` : ""));
+    }
+  }
+  function formatQueueSummary(ops) {
+    const counts = {};
+    for (const op of ops) {
+      counts[op.type] = (counts[op.type] ?? 0) + 1;
+    }
+    return Object.entries(counts).map(([type, n]) => `${n} ${type}`).join(", ");
   }
   function requirePeerCN(call, allowedCallers, isDeliver) {
     const peerCN = extractPeerCN(call);
@@ -1192,6 +1252,9 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
       }
     } catch (err) {
       if (isConnectionError(err)) {
+        if (isOnline) {
+          console.warn("[servicebridge] lost connection to runtime — entering offline mode");
+        }
         isOnline = false;
         scheduleOnlineRestore();
       } else if (isRegistryResyncRequiredError(err)) {
@@ -1716,7 +1779,9 @@ function servicebridge(url, serviceKey, serviceOrOpts = {}, maybeGlobalOpts = {}
         closeWorkerSession();
         serveState = null;
         shutdownWorkerServerGracefully();
-        throw normalizeServiceError(err, "serve");
+        const fatal = normalizeServiceError(err, "serve");
+        console.error(`[servicebridge] startup failed: ${fatal.message}`);
+        throw fatal;
       }
     },
     stop() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "service-bridge",
-  "version": "1.0.10-dev.23",
+  "version": "1.0.10-dev.26",
   "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": [