@babelforce/babelconnect-sdk 0.10.0 → 0.11.0

package/dist/client.d.ts

@@ -150,3 +150,8 @@ export declare class BabelconnectClient {
     private rawSend;
     private closeAllMedia;
 }
+/**
+ * Stamp the SDK identity (name + build version) onto a request's headers — sent
+ * on every unary + streaming call so the server can identify the client (APP-A5).
+ */
+export declare function applySdkHeaders(header: Headers): void;

package/dist/client.js

@@ -1,7 +1,8 @@
 import { createClient, } from "@connectrpc/connect";
 import { createGrpcWebTransport } from "@connectrpc/connect-web";
+import { SDK_VERSION } from "./version.js";
 import { Agent } from "./gen/babelconnect/v1/babelconnect_connect.js";
-import { AddConferenceMember, AnswerCall, CallDirection, CallLifecycle, CallSource, Command, EndConference, Error as BcError, FlagRecording, Hangup, HistoryRequest, SmsThreadRequest, PhonebookRequest, HoldConferenceMember, Hold, KickConferenceMember, LeaveConference, MarkConversationRead, Mute, MuteConferenceMember, PlaceCall, Register, ResetLineStatus, SendDigits, SendSmsRequest, SetAgentNumber, SetConversationOpen, SetDisplayAs, SetPresence, SetWebrtc, StartConference, StartRecording, StopRecording, SetRecordingTags, SubscribeRequest, Transfer, WrapUpCancel, WrapUpExtend, } from "./gen/babelconnect/v1/babelconnect_pb.js";
+import { AddConferenceMember, AnswerCall, CallDirection, CallLifecycle, CallSource, Command, EndConference, Error as BcError, FlagRecording, Hangup, HistoryRequest, SmsThreadRequest, PhonebookRequest, HoldConferenceMember, Hold, KickConferenceMember, LeaveConference, MarkConversationRead, Mute, MuteConferenceMember, PlaceCall, Pong, Register, ResetLineStatus, SendDigits, SendSmsRequest, SetAgentNumber, SetConversationOpen, SetDisplayAs, SetPresence, SetWebrtc, StartConference, StartRecording, StopRecording, SetRecordingTags, SubscribeRequest, Transfer, WrapUpCancel, WrapUpExtend, } from "./gen/babelconnect/v1/babelconnect_pb.js";
 import { browserMediaFactory, MediaError, toRTCIceServers, } from "./media.js";
 import { StateCache } from "./state-cache.js";
 /**
@@ -346,6 +347,15 @@ export class BabelconnectClient {
         // pass so a 15s heartbeat doesn't trigger a no-op reconcile every tick.
         if (u.update.case === "keepalive")
             return;
+        // Ping: reply with a Pong echoing the seq so the server can measure RTT +
+        // liveness (CALL-M6). Control-only, like keepalive — short-circuited before the
+        // cache and the ready/flush logic so it is never mistaken for the snapshot.
+        if (u.update.case === "ping") {
+            void this.rawSend(new Command({
+                command: { case: "pong", value: new Pong({ seq: u.update.value.seq }) },
+            }));
+            return;
+        }
         // First message = the snapshot ⇒ the session is registered server-side, so
         // flush intents queued during connect() (register(), an early dial, …).
         if (!this.ready) {
@@ -464,10 +474,22 @@ export class BabelconnectClient {
         await Promise.all(all.map((m) => m.close()));
     }
 }
-/** An interceptor that attaches the bearer token to every gRPC-web call. */
+/**
+ * Stamp the SDK identity (name + build version) onto a request's headers — sent
+ * on every unary + streaming call so the server can identify the client (APP-A5).
+ */
+export function applySdkHeaders(header) {
+    header.set("x-babelconnect-sdk", "ts");
+    header.set("x-babelconnect-sdk-version", SDK_VERSION);
+}
+/**
+ * An interceptor that attaches the bearer token and the SDK identity headers to
+ * every gRPC-web call (unary + the long-lived Subscribe stream).
+ */
 function authInterceptor(token) {
     return (next) => (req) => {
         req.header.set("Authorization", `Bearer ${token}`);
+        applySdkHeaders(req.header);
         return next(req);
     };
 }

package/dist/gen/babelconnect/v1/babelconnect_pb.d.ts

@@ -1098,6 +1098,12 @@ export declare class StateUpdate extends Message<StateUpdate> {
          */
         value: Keepalive;
         case: "keepalive";
+    } | {
+        /**
+         * @generated from field: babelconnect.v1.Ping ping = 6;
+         */
+        value: Ping;
+        case: "ping";
     } | {
         case: undefined;
         value?: undefined;
@@ -1131,6 +1137,30 @@ export declare class Keepalive extends Message<Keepalive> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Keepalive;
     static equals(a: Keepalive | PlainMessage<Keepalive> | undefined, b: Keepalive | PlainMessage<Keepalive> | undefined): boolean;
 }
+/**
+ * Ping is a liveness probe the server sends on the heartbeat tick (replacing the
+ * bare Keepalive frame). The client echoes `seq` back in a Pong command; the server
+ * measures round-trip time (RTT) from the reply and tracks per-session liveness.
+ * Like Keepalive it keeps the connection warm, carries no state, and does NOT
+ * advance `seq` — caches ignore it, and the reply is handled in the client's stream
+ * loop, not the state reducer. (APP-A5/CALL-M6.)
+ *
+ * @generated from message babelconnect.v1.Ping
+ */
+export declare class Ping extends Message<Ping> {
+    /**
+     * @generated from field: uint64 seq = 1;
+     */
+    seq: bigint;
+    constructor(data?: PartialMessage<Ping>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "babelconnect.v1.Ping";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): Ping;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): Ping;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Ping;
+    static equals(a: Ping | PlainMessage<Ping> | undefined, b: Ping | PlainMessage<Ping> | undefined): boolean;
+}
 /**
  * Patch is an entity-level delta applied mechanically by the client cache:
  * replace the agent block, upsert/remove a call by id, or set wrap-up.
@@ -1516,6 +1546,14 @@ export declare class Command extends Message<Command> {
          */
         value: MarkConversationRead;
         case: "markConversationRead";
+    } | {
+        /**
+         * reply to a server Ping (liveness + RTT); echoes Ping.seq
+         *
+         * @generated from field: babelconnect.v1.Pong pong = 30;
+         */
+        value: Pong;
+        case: "pong";
     } | {
         case: undefined;
         value?: undefined;
@@ -1529,6 +1567,27 @@ export declare class Command extends Message<Command> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Command;
     static equals(a: Command | PlainMessage<Command> | undefined, b: Command | PlainMessage<Command> | undefined): boolean;
 }
+/**
+ * Pong replies to a server Ping (StateUpdate.ping), echoing its `seq` so the server
+ * can match it to the outstanding ping and compute RTT. Sent automatically by the
+ * SDK from its stream-receive loop — not a user intent. (APP-A5/CALL-M6.)
+ *
+ * @generated from message babelconnect.v1.Pong
+ */
+export declare class Pong extends Message<Pong> {
+    /**
+     * @generated from field: uint64 seq = 1;
+     */
+    seq: bigint;
+    constructor(data?: PartialMessage<Pong>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "babelconnect.v1.Pong";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): Pong;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): Pong;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Pong;
+    static equals(a: Pong | PlainMessage<Pong> | undefined, b: Pong | PlainMessage<Pong> | undefined): boolean;
+}
 /**
  * @generated from message babelconnect.v1.Register
  */

package/dist/gen/babelconnect/v1/babelconnect_pb.js

@@ -1545,6 +1545,7 @@ export class StateUpdate extends Message {
         { no: 3, name: "patch", kind: "message", T: Patch, oneof: "update" },
         { no: 4, name: "error", kind: "message", T: Error, oneof: "update" },
         { no: 5, name: "keepalive", kind: "message", T: Keepalive, oneof: "update" },
+        { no: 6, name: "ping", kind: "message", T: Ping, oneof: "update" },
     ]);
     static fromBinary(bytes, options) {
         return new StateUpdate().fromBinary(bytes, options);
@@ -1590,6 +1591,43 @@ export class Keepalive extends Message {
         return proto3.util.equals(Keepalive, a, b);
     }
 }
+/**
+ * Ping is a liveness probe the server sends on the heartbeat tick (replacing the
+ * bare Keepalive frame). The client echoes `seq` back in a Pong command; the server
+ * measures round-trip time (RTT) from the reply and tracks per-session liveness.
+ * Like Keepalive it keeps the connection warm, carries no state, and does NOT
+ * advance `seq` — caches ignore it, and the reply is handled in the client's stream
+ * loop, not the state reducer. (APP-A5/CALL-M6.)
+ *
+ * @generated from message babelconnect.v1.Ping
+ */
+export class Ping extends Message {
+    /**
+     * @generated from field: uint64 seq = 1;
+     */
+    seq = protoInt64.zero;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "babelconnect.v1.Ping";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "seq", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new Ping().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new Ping().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new Ping().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(Ping, a, b);
+    }
+}
 /**
  * Patch is an entity-level delta applied mechanically by the client cache:
  * replace the agent block, upsert/remove a call by id, or set wrap-up.
@@ -1775,6 +1813,7 @@ export class Command extends Message {
         { no: 27, name: "mute_conference_member", kind: "message", T: MuteConferenceMember, oneof: "command" },
         { no: 28, name: "set_conversation_open", kind: "message", T: SetConversationOpen, oneof: "command" },
         { no: 29, name: "mark_conversation_read", kind: "message", T: MarkConversationRead, oneof: "command" },
+        { no: 30, name: "pong", kind: "message", T: Pong, oneof: "command" },
     ]);
     static fromBinary(bytes, options) {
         return new Command().fromBinary(bytes, options);
@@ -1789,6 +1828,40 @@ export class Command extends Message {
         return proto3.util.equals(Command, a, b);
     }
 }
+/**
+ * Pong replies to a server Ping (StateUpdate.ping), echoing its `seq` so the server
+ * can match it to the outstanding ping and compute RTT. Sent automatically by the
+ * SDK from its stream-receive loop — not a user intent. (APP-A5/CALL-M6.)
+ *
+ * @generated from message babelconnect.v1.Pong
+ */
+export class Pong extends Message {
+    /**
+     * @generated from field: uint64 seq = 1;
+     */
+    seq = protoInt64.zero;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "babelconnect.v1.Pong";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "seq", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new Pong().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new Pong().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new Pong().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(Pong, a, b);
+    }
+}
 /**
  * @generated from message babelconnect.v1.Register
  */

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.11.0";

package/dist/version.js

@@ -0,0 +1,3 @@
+// Generated by scripts/gen-version.mjs (npm prebuild) from package.json.
+// Do not edit by hand.
+export const SDK_VERSION = "0.11.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babelforce/babelconnect-sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "TypeScript SDK for babelconnect — server-authoritative agent state over gRPC-web, native WebRTC audio, and an embeddable widget (iframe + postMessage) for the Flutter web app.",
   "license": "Apache-2.0",
   "homepage": "https://babelforce.github.io/babelconnect-sdk/",
@@ -24,6 +24,7 @@
   },
   "scripts": {
     "generate": "echo 'run `task gen` at the repo root (buf generate emits src/gen)'",
+    "prebuild": "node scripts/gen-version.mjs",
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test test/*.test.mjs",