@babelforce/babelconnect-sdk 0.9.1 → 0.10.0

package/dist/client.js

@@ -2,7 +2,7 @@ import { createClient, } from "@connectrpc/connect";
 import { createGrpcWebTransport } from "@connectrpc/connect-web";
 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 { browserMediaFactory, toRTCIceServers, } from "./media.js";
+import { browserMediaFactory, MediaError, toRTCIceServers, } from "./media.js";
 import { StateCache } from "./state-cache.js";
 /**
  * The TypeScript "dumb renderer" client: opens the `Subscribe`/`Send` gRPC-web
@@ -420,9 +420,15 @@ export class BabelconnectClient {
             }));
         }
         catch (e) {
+            // CALL-M5: a Media impl classifies a mic-acquisition failure (no mic,
+            // permission denied, device busy) into a distinct code via MediaError;
+            // anything else stays the opaque catch-all. The distinct code lets the
+            // UI/host explain the cause instead of showing a raw WebRTC string.
+            const code = e instanceof MediaError ? e.code : "media_answer_failed";
+            const message = e instanceof MediaError ? e.message : String(e);
             this.opts.onError?.(new BcError({
-                code: "media_answer_failed",
-                message: String(e),
+                code,
+                message,
                 callId: call.id,
             }));
         }

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

@@ -332,6 +332,18 @@ export declare class Identity extends Message<Identity> {
      * @generated from field: babelconnect.v1.AgentState state = 5;
      */
     state: AgentState;
+    /**
+     * account / company display name, when known (ACC-E1)
+     *
+     * @generated from field: string account_name = 6;
+     */
+    accountName: string;
+    /**
+     * accounts this agent may switch to (ACC-E2)
+     *
+     * @generated from field: repeated babelconnect.v1.Account accounts = 7;
+     */
+    accounts: Account[];
     constructor(data?: PartialMessage<Identity>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "babelconnect.v1.Identity";
@@ -341,6 +353,41 @@ export declare class Identity extends Message<Identity> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Identity;
     static equals(a: Identity | PlainMessage<Identity> | undefined, b: Identity | PlainMessage<Identity> | undefined): boolean;
 }
+/**
+ * Account is one tenant the signed-in agent can operate in — the switchable set
+ * (agent-role only) surfaced for the account picker (ACC-E2). Sourced from
+ * GET /api/v2/user/accounts.
+ *
+ * @generated from message babelconnect.v1.Account
+ */
+export declare class Account extends Message<Account> {
+    /**
+     * customer / account id
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * company / display name
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * the account this session is currently scoped to
+     *
+     * @generated from field: bool current = 3;
+     */
+    current: boolean;
+    constructor(data?: PartialMessage<Account>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "babelconnect.v1.Account";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): Account;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): Account;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Account;
+    static equals(a: Account | PlainMessage<Account> | undefined, b: Account | PlainMessage<Account> | undefined): boolean;
+}
 /**
  * AgentView is the complete per-agent state the server owns and renders to. A
  * snapshot carries the whole view; patches carry entity-level deltas.
@@ -532,6 +579,12 @@ export declare class FeatureAccount extends Message<FeatureAccount> {
      * @generated from field: bool show_status = 3;
      */
     showStatus: boolean;
+    /**
+     * the multi-account switcher (ACC-E2)
+     *
+     * @generated from field: bool allow_account_switch = 4;
+     */
+    allowAccountSwitch: boolean;
     constructor(data?: PartialMessage<FeatureAccount>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "babelconnect.v1.FeatureAccount";
@@ -716,6 +769,14 @@ export declare class AgentInfo extends Message<AgentInfo> {
      * @generated from field: bool line_blocked = 18;
      */
     lineBlocked: boolean;
+    /**
+     * Accounts this agent may switch to without re-logging-in (agent-role only,
+     * resolved at auth from GET /api/v2/user/accounts). One is marked `current`.
+     * Drives the Account tab's switcher; empty/single ⇒ no picker (ACC-E2).
+     *
+     * @generated from field: repeated babelconnect.v1.Account accounts = 19;
+     */
+    accounts: Account[];
     constructor(data?: PartialMessage<AgentInfo>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "babelconnect.v1.AgentInfo";

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

@@ -471,6 +471,18 @@ export class Identity extends Message {
      * @generated from field: babelconnect.v1.AgentState state = 5;
      */
     state = AgentState.UNSPECIFIED;
+    /**
+     * account / company display name, when known (ACC-E1)
+     *
+     * @generated from field: string account_name = 6;
+     */
+    accountName = "";
+    /**
+     * accounts this agent may switch to (ACC-E2)
+     *
+     * @generated from field: repeated babelconnect.v1.Account accounts = 7;
+     */
+    accounts = [];
     constructor(data) {
         super();
         proto3.util.initPartial(data, this);
@@ -483,6 +495,8 @@ export class Identity extends Message {
         { no: 3, name: "number", kind: "scalar", T: 9 /* ScalarType.STRING */ },
         { no: 4, name: "username", kind: "scalar", T: 9 /* ScalarType.STRING */ },
         { no: 5, name: "state", kind: "enum", T: proto3.getEnumType(AgentState) },
+        { no: 6, name: "account_name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 7, name: "accounts", kind: "message", T: Account, repeated: true },
     ]);
     static fromBinary(bytes, options) {
         return new Identity().fromBinary(bytes, options);
@@ -497,6 +511,56 @@ export class Identity extends Message {
         return proto3.util.equals(Identity, a, b);
     }
 }
+/**
+ * Account is one tenant the signed-in agent can operate in — the switchable set
+ * (agent-role only) surfaced for the account picker (ACC-E2). Sourced from
+ * GET /api/v2/user/accounts.
+ *
+ * @generated from message babelconnect.v1.Account
+ */
+export class Account extends Message {
+    /**
+     * customer / account id
+     *
+     * @generated from field: string id = 1;
+     */
+    id = "";
+    /**
+     * company / display name
+     *
+     * @generated from field: string name = 2;
+     */
+    name = "";
+    /**
+     * the account this session is currently scoped to
+     *
+     * @generated from field: bool current = 3;
+     */
+    current = false;
+    constructor(data) {
+        super();
+        proto3.util.initPartial(data, this);
+    }
+    static runtime = proto3;
+    static typeName = "babelconnect.v1.Account";
+    static fields = proto3.util.newFieldList(() => [
+        { no: 1, name: "id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 2, name: "name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+        { no: 3, name: "current", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    ]);
+    static fromBinary(bytes, options) {
+        return new Account().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new Account().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new Account().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(Account, a, b);
+    }
+}
 /**
  * AgentView is the complete per-agent state the server owns and renders to. A
  * snapshot carries the whole view; patches carry entity-level deltas.
@@ -767,6 +831,12 @@ export class FeatureAccount extends Message {
      * @generated from field: bool show_status = 3;
      */
     showStatus = false;
+    /**
+     * the multi-account switcher (ACC-E2)
+     *
+     * @generated from field: bool allow_account_switch = 4;
+     */
+    allowAccountSwitch = false;
     constructor(data) {
         super();
         proto3.util.initPartial(data, this);
@@ -777,6 +847,7 @@ export class FeatureAccount extends Message {
         { no: 1, name: "enabled", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
         { no: 2, name: "allow_device_switch", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
         { no: 3, name: "show_status", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+        { no: 4, name: "allow_account_switch", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     ]);
     static fromBinary(bytes, options) {
         return new FeatureAccount().fromBinary(bytes, options);
@@ -1007,6 +1078,14 @@ export class AgentInfo extends Message {
      * @generated from field: bool line_blocked = 18;
      */
     lineBlocked = false;
+    /**
+     * Accounts this agent may switch to without re-logging-in (agent-role only,
+     * resolved at auth from GET /api/v2/user/accounts). One is marked `current`.
+     * Drives the Account tab's switcher; empty/single ⇒ no picker (ACC-E2).
+     *
+     * @generated from field: repeated babelconnect.v1.Account accounts = 19;
+     */
+    accounts = [];
     constructor(data) {
         super();
         proto3.util.initPartial(data, this);
@@ -1032,6 +1111,7 @@ export class AgentInfo extends Message {
         { no: 16, name: "account_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
         { no: 17, name: "account_name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
         { no: 18, name: "line_blocked", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+        { no: 19, name: "accounts", kind: "message", T: Account, repeated: true },
     ]);
     static fromBinary(bytes, options) {
         return new AgentInfo().fromBinary(bytes, options);

package/dist/index.d.ts

@@ -12,6 +12,6 @@
 export { BabelconnectClient, type ConnectOptions } from "./client.js";
 export { StateCache } from "./state-cache.js";
 export { passwordGrant, revokeToken, pkceChallenge, buildAuthorizeUrl, authorizationCodeGrant, DEFAULT_CLIENT_ID, type TokenResponse, type PkceChallenge, type AuthorizeUrlOptions, } from "./auth.js";
-export { BrowserWebrtcMedia, browserMediaFactory, type Media, type MediaFactory } from "./media.js";
+export { BrowserWebrtcMedia, browserMediaFactory, MediaError, micErrorCode, MIC_NOT_FOUND, MIC_PERMISSION_DENIED, MIC_IN_USE, MEDIA_ANSWER_FAILED, type Media, type MediaFactory, } from "./media.js";
 export * from "./gen/babelconnect/v1/babelconnect_pb.js";
 export { Agent } from "./gen/babelconnect/v1/babelconnect_connect.js";

package/dist/index.js

@@ -12,7 +12,7 @@
 export { BabelconnectClient } from "./client.js";
 export { StateCache } from "./state-cache.js";
 export { passwordGrant, revokeToken, pkceChallenge, buildAuthorizeUrl, authorizationCodeGrant, DEFAULT_CLIENT_ID, } from "./auth.js";
-export { BrowserWebrtcMedia, browserMediaFactory } from "./media.js";
+export { BrowserWebrtcMedia, browserMediaFactory, MediaError, micErrorCode, MIC_NOT_FOUND, MIC_PERMISSION_DENIED, MIC_IN_USE, MEDIA_ANSWER_FAILED, } from "./media.js";
 // The generated babelconnect.v1 messages + enums (AgentView, CallState, Command, …)
 // and the Agent service descriptor.
 export * from "./gen/babelconnect/v1/babelconnect_pb.js";

package/dist/media.d.ts

@@ -19,6 +19,33 @@ export interface Media {
 }
 /** Builds the {@link Media} for a given call id. */
 export type MediaFactory = (callId: string) => Media;
+/** No microphone hardware is available (`NotFoundError`). */
+export declare const MIC_NOT_FOUND = "mic_not_found";
+/** Microphone access was denied (`NotAllowedError` / `SecurityError`). */
+export declare const MIC_PERMISSION_DENIED = "mic_permission_denied";
+/** The microphone is held by another application (`NotReadableError` / `AbortError`). */
+export declare const MIC_IN_USE = "mic_in_use";
+/** The pre-existing catch-all, kept as the fallback when the cause is unclear. */
+export declare const MEDIA_ANSWER_FAILED = "media_answer_failed";
+/**
+ * Thrown by a {@link Media} implementation when it cannot start audio for a
+ * call — e.g. the microphone is missing, permission was denied, or the device
+ * is held by another app (CALL-M5). {@link code} is a stable classification the
+ * SDK surfaces on `onError` (and hosts receive as `cti.error`) so the UI can
+ * show cause-specific help instead of a raw WebRTC string.
+ */
+export declare class MediaError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Classify a caught `getUserMedia` failure into one of the mic error codes,
+ * falling back to {@link MEDIA_ANSWER_FAILED} when the cause can't be told
+ * apart. On the web the real `DOMException` is available so we read its `.name`;
+ * the string form is also scanned as a fallback (and to stay in step with the
+ * Dart classifier, which only has the collapsed `'Unable to getUserMedia: …'`).
+ */
+export declare function micErrorCode(error: unknown): string;
 /**
  * The default browser WebRTC backend: capture the mic, answer the server's offer
  * (non-trickle ICE), and play the remote audio through a hidden `<audio>` element.

package/dist/media.js

@@ -1,3 +1,57 @@
+/** No microphone hardware is available (`NotFoundError`). */
+export const MIC_NOT_FOUND = "mic_not_found";
+/** Microphone access was denied (`NotAllowedError` / `SecurityError`). */
+export const MIC_PERMISSION_DENIED = "mic_permission_denied";
+/** The microphone is held by another application (`NotReadableError` / `AbortError`). */
+export const MIC_IN_USE = "mic_in_use";
+/** The pre-existing catch-all, kept as the fallback when the cause is unclear. */
+export const MEDIA_ANSWER_FAILED = "media_answer_failed";
+/**
+ * Thrown by a {@link Media} implementation when it cannot start audio for a
+ * call — e.g. the microphone is missing, permission was denied, or the device
+ * is held by another app (CALL-M5). {@link code} is a stable classification the
+ * SDK surfaces on `onError` (and hosts receive as `cti.error`) so the UI can
+ * show cause-specific help instead of a raw WebRTC string.
+ */
+export class MediaError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "MediaError";
+    }
+}
+/**
+ * Classify a caught `getUserMedia` failure into one of the mic error codes,
+ * falling back to {@link MEDIA_ANSWER_FAILED} when the cause can't be told
+ * apart. On the web the real `DOMException` is available so we read its `.name`;
+ * the string form is also scanned as a fallback (and to stay in step with the
+ * Dart classifier, which only has the collapsed `'Unable to getUserMedia: …'`).
+ */
+export function micErrorCode(error) {
+    const name = typeof DOMException !== "undefined" && error instanceof DOMException
+        ? error.name
+        : "";
+    const s = `${name} ${String(error)}`.toLowerCase();
+    if (s.includes("notfound") || s.includes("not found") || s.includes("no device")) {
+        return MIC_NOT_FOUND;
+    }
+    if (s.includes("notallowed") ||
+        s.includes("permissiondenied") ||
+        s.includes("permission denied") ||
+        s.includes("security") ||
+        s.includes("denied")) {
+        return MIC_PERMISSION_DENIED;
+    }
+    if (s.includes("notreadable") ||
+        s.includes("trackstart") ||
+        s.includes("abort") ||
+        s.includes("in use") ||
+        s.includes("busy")) {
+        return MIC_IN_USE;
+    }
+    return MEDIA_ANSWER_FAILED;
+}
 /**
  * The default browser WebRTC backend: capture the mic, answer the server's offer
  * (non-trickle ICE), and play the remote audio through a hidden `<audio>` element.
@@ -35,8 +89,17 @@ export class BrowserWebrtcMedia {
             el.srcObject = stream;
             void el.play().catch(() => { });
         };
-        // Capture the microphone and add it to the peer.
-        const local = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
+        // Capture the microphone and add it to the peer. Classify a failure (no mic
+        // / permission denied / device busy) into a MediaError the SDK surfaces with
+        // a distinct code (CALL-M5) so the UI/host can explain it, instead of the
+        // opaque `media_answer_failed`.
+        let local;
+        try {
+            local = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
+        }
+        catch (e) {
+            throw new MediaError(micErrorCode(e), String(e));
+        }
         this.local = local;
         for (const track of local.getAudioTracks())
             pc.addTrack(track, local);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babelforce/babelconnect-sdk",
-  "version": "0.9.1",
+  "version": "0.10.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/",