@coventia/softphone 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { S as Softphone } from './softphone-DlGV12Xp.cjs';
-export { A as AudioDevices } from './softphone-DlGV12Xp.cjs';
-import { S as SoftphoneConfig } from './call-VKq1I8yP.cjs';
-export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d as CallEventMap, e as CallOptions, f as CallState, g as Contact, E as ERROR_CATALOGUE, F as FatalErrorCode, h as FatalSoftphoneError, H as HangupReason, i as HoldOriginator, I as INITIAL_STATES, L as LogLevel, N as NonFatalErrorCode, j as NonFatalSoftphoneError, R as RemoteParty, k as SoftphoneError, l as SoftphoneErrorCode, m as SoftphoneEvent, n as SoftphoneEventMap, o as SoftphoneState, T as TokenEndpointOptions, p as TokenSource, q as TypedEmitter, V as VoiceToken, r as canTransition, s as isFatal, t as isTerminal } from './call-VKq1I8yP.cjs';
+import { S as Softphone } from './softphone-CY5d2WWY.cjs';
+export { A as AudioDevices } from './softphone-CY5d2WWY.cjs';
+import { S as SoftphoneConfig, O as OutboundNumberRefusal } from './call-C6YpT6uR.cjs';
+export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d as CallEventMap, e as CallOptions, f as CallState, g as Contact, E as ERROR_CATALOGUE, F as FatalErrorCode, h as FatalSoftphoneError, H as HangupReason, i as HoldOriginator, I as INITIAL_STATES, L as LogLevel, N as NonFatalErrorCode, j as NonFatalSoftphoneError, k as OutboundNumber, l as OutboundNumberKind, m as OutboundNumberSettings, n as OutboundNumberState, o as OutboundNumbersSource, R as RemoteParty, p as RingtoneOption, q as RingtoneSettings, r as RingtoneSource, s as SoftphoneError, t as SoftphoneErrorCode, u as SoftphoneEvent, v as SoftphoneEventMap, w as SoftphoneState, T as TokenEndpointOptions, x as TokenSource, y as TypedEmitter, V as VoiceToken, z as canTransition, A as isFatal, B as isTerminal } from './call-C6YpT6uR.cjs';
 
 /**
  * Construct a softphone.
@@ -19,6 +19,16 @@ export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d
  */
 declare function createSoftphone(config: SoftphoneConfig): Softphone;
 
+/**
+ * A change of outbound number the request limits refused (outbound-number-per-agent.md §5.3–§5.5). Structural,
+ * like `isSoftphoneError`: the concrete error is a plain `Error` with a `refusal`, so a host — or a second copy
+ * of the SDK on the page — can recognise it without sharing a class.
+ */
+interface OutboundNumberRefusedError extends Error {
+    readonly refusal: OutboundNumberRefusal;
+}
+declare function isOutboundNumberRefused(value: unknown): value is OutboundNumberRefusedError;
+
 /**
  * Browser-capability probes.
  *
@@ -57,6 +67,6 @@ declare function isWebRtcSupported(): boolean;
  *   - `MockProvider` — lives at @coventia/softphone/testing, so it never lands in a production bundle.
  */
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.4.0";
 
-export { Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isWebRtcSupported };
+export { OutboundNumberRefusal, type OutboundNumberRefusedError, Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isOutboundNumberRefused, isWebRtcSupported };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { S as Softphone } from './softphone-Cyq3hiIM.js';
-export { A as AudioDevices } from './softphone-Cyq3hiIM.js';
-import { S as SoftphoneConfig } from './call-VKq1I8yP.js';
-export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d as CallEventMap, e as CallOptions, f as CallState, g as Contact, E as ERROR_CATALOGUE, F as FatalErrorCode, h as FatalSoftphoneError, H as HangupReason, i as HoldOriginator, I as INITIAL_STATES, L as LogLevel, N as NonFatalErrorCode, j as NonFatalSoftphoneError, R as RemoteParty, k as SoftphoneError, l as SoftphoneErrorCode, m as SoftphoneEvent, n as SoftphoneEventMap, o as SoftphoneState, T as TokenEndpointOptions, p as TokenSource, q as TypedEmitter, V as VoiceToken, r as canTransition, s as isFatal, t as isTerminal } from './call-VKq1I8yP.js';
+import { S as Softphone } from './softphone-DXgmTyrX.js';
+export { A as AudioDevices } from './softphone-DXgmTyrX.js';
+import { S as SoftphoneConfig, O as OutboundNumberRefusal } from './call-C6YpT6uR.js';
+export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d as CallEventMap, e as CallOptions, f as CallState, g as Contact, E as ERROR_CATALOGUE, F as FatalErrorCode, h as FatalSoftphoneError, H as HangupReason, i as HoldOriginator, I as INITIAL_STATES, L as LogLevel, N as NonFatalErrorCode, j as NonFatalSoftphoneError, k as OutboundNumber, l as OutboundNumberKind, m as OutboundNumberSettings, n as OutboundNumberState, o as OutboundNumbersSource, R as RemoteParty, p as RingtoneOption, q as RingtoneSettings, r as RingtoneSource, s as SoftphoneError, t as SoftphoneErrorCode, u as SoftphoneEvent, v as SoftphoneEventMap, w as SoftphoneState, T as TokenEndpointOptions, x as TokenSource, y as TypedEmitter, V as VoiceToken, z as canTransition, A as isFatal, B as isTerminal } from './call-C6YpT6uR.js';
 
 /**
  * Construct a softphone.
@@ -19,6 +19,16 @@ export { C as CALL_TRANSITIONS, a as Call, b as CallDirection, c as CallEvent, d
  */
 declare function createSoftphone(config: SoftphoneConfig): Softphone;
 
+/**
+ * A change of outbound number the request limits refused (outbound-number-per-agent.md §5.3–§5.5). Structural,
+ * like `isSoftphoneError`: the concrete error is a plain `Error` with a `refusal`, so a host — or a second copy
+ * of the SDK on the page — can recognise it without sharing a class.
+ */
+interface OutboundNumberRefusedError extends Error {
+    readonly refusal: OutboundNumberRefusal;
+}
+declare function isOutboundNumberRefused(value: unknown): value is OutboundNumberRefusedError;
+
 /**
  * Browser-capability probes.
  *
@@ -57,6 +67,6 @@ declare function isWebRtcSupported(): boolean;
  *   - `MockProvider` — lives at @coventia/softphone/testing, so it never lands in a production bundle.
  */
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.4.0";
 
-export { Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isWebRtcSupported };
+export { OutboundNumberRefusal, type OutboundNumberRefusedError, Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isOutboundNumberRefused, isWebRtcSupported };

package/dist/index.js

@@ -1,6 +1,7 @@
 import { isBrowser } from './chunk-KAXEMJ7E.js';
 export { isBrowser, isWebRtcSupported } from './chunk-KAXEMJ7E.js';
 export { CallEvent, SoftphoneEvent } from './chunk-7R6LOOAI.js';
+export { isOutboundNumberRefused } from './chunk-5E5OEXS2.js';
 import { isFatal } from './chunk-2ZSOGGPO.js';
 export { ERROR_CATALOGUE, isFatal } from './chunk-2ZSOGGPO.js';
 import { cachedTokenSource } from './chunk-MHOJHG5E.js';
@@ -284,7 +285,7 @@ function coventiaBackend(config, tokenSource, fallbackBaseUrl) {
   }
   let pending = null;
   const load = () => {
-    pending ??= import('./sources-IRKNQPWW.js').then(
+    pending ??= import('./sources-ONYQW733.js').then(
       (m) => m.coventiaSources({ ...config, baseUrl, tokenSource })
     );
     return pending;
@@ -295,7 +296,17 @@ function coventiaBackend(config, tokenSource, fallbackBaseUrl) {
     resolveContact: async (number) => (await load()).resolveContact(number),
     listAgents: async () => (await load()).listAgents(),
     transferOutcomes: async (params) => (await load()).transferOutcomes(params),
-    presence: async (callbacks) => (await load()).presence(callbacks)
+    presence: async (callbacks) => (await load()).presence(callbacks),
+    ringtones: {
+      get: async (signal) => (await load()).ringtones.get(signal),
+      setMine: async (id) => (await load()).ringtones.setMine(id),
+      cached: async () => (await load()).ringtones.cached?.() ?? null
+    },
+    outboundNumbers: {
+      get: async (signal) => (await load()).outboundNumbers.get(signal),
+      setMine: async (id) => (await load()).outboundNumbers.setMine(id),
+      cached: async () => (await load()).outboundNumbers.cached?.() ?? null
+    }
   };
 }
 
@@ -506,13 +517,30 @@ var BrowserAudioDevices = class {
   outputs = [];
   currentInputId = null;
   currentOutputId = null;
+  currentRingtoneOutputId = null;
   canSelectOutput;
+  canSelectRingtoneOutput;
   #engine;
   #onChange;
+  /**
+   * What the user CHOSE, remembered across reloads — distinct from the `current*` fields, which are
+   * what is usable right now. Keeping them apart is what stops a fresh page load from wiping a saved
+   * choice: until the microphone has been granted, Chrome enumerates every device with a blank id, so
+   * "is the saved device in the list?" is no on every first enumeration. The preference survives
+   * that; `current*` simply reads `null` until the device is really there.
+   */
+  #preferred;
+  /** The input the engine was last told about — it starts on the system default (`null`). */
+  #engineInputId = null;
   constructor(engine, onChange) {
     this.#engine = engine;
     this.#onChange = onChange;
     this.canSelectOutput = isBrowser() && typeof HTMLMediaElement !== "undefined" && "setSinkId" in HTMLMediaElement.prototype;
+    this.canSelectRingtoneOutput = this.canSelectOutput;
+    this.#preferred = readStoredDevices();
+    this.currentInputId = this.#preferred.input;
+    this.currentOutputId = this.#preferred.output;
+    this.currentRingtoneOutputId = this.#preferred.ringtone;
     if (isBrowser() && navigator.mediaDevices) {
       void this.refresh();
       navigator.mediaDevices.addEventListener?.("devicechange", () => void this.refresh());
@@ -528,26 +556,63 @@ var BrowserAudioDevices = class {
     }
     this.inputs = all.filter((d) => d.kind === "audioinput");
     this.outputs = all.filter((d) => d.kind === "audiooutput");
-    if (this.currentInputId && !this.inputs.some((d) => d.deviceId === this.currentInputId)) {
-      this.currentInputId = null;
-    }
-    if (this.currentOutputId && !this.outputs.some((d) => d.deviceId === this.currentOutputId)) {
-      this.currentOutputId = null;
-    }
+    this.currentInputId = usable(this.#preferred.input, this.inputs);
+    this.currentOutputId = usable(this.#preferred.output, this.outputs);
+    this.currentRingtoneOutputId = usable(this.#preferred.ringtone, this.outputs);
     this.#onChange();
+    if (this.currentInputId && this.currentInputId !== this.#engineInputId) {
+      await this.#tellEngine(this.currentInputId);
+    }
   }
   async setInput(deviceId) {
     this.currentInputId = deviceId;
+    this.#remember({ input: deviceId });
     this.#onChange();
+    await this.#tellEngine(deviceId);
+  }
+  async #tellEngine(deviceId) {
+    this.#engineInputId = deviceId;
     await this.#engine.setInputDevice?.(deviceId);
   }
   async setOutput(deviceId) {
     this.currentOutputId = deviceId;
+    this.#remember({ output: deviceId });
     this.#onChange();
   }
-  async setRingtoneOutput() {
+  async setRingtoneOutput(deviceId) {
+    this.currentRingtoneOutputId = deviceId;
+    this.#remember({ ringtone: deviceId });
+    this.#onChange();
+  }
+  #remember(patch) {
+    this.#preferred = { ...this.#preferred, ...patch };
+    writeStoredDevices(this.#preferred);
   }
 };
+var DEVICES_KEY = "coventia-softphone:devices";
+var NO_DEVICES = { input: null, output: null, ringtone: null };
+function usable(id, list) {
+  return id && list.some((d) => d.deviceId === id) ? id : null;
+}
+function readStoredDevices() {
+  if (!isBrowser()) return NO_DEVICES;
+  try {
+    const raw = JSON.parse(globalThis.localStorage?.getItem(DEVICES_KEY) ?? "null");
+    if (!raw || typeof raw !== "object") return NO_DEVICES;
+    const pick = (v) => typeof v === "string" && v ? v : null;
+    const r = raw;
+    return { input: pick(r.input), output: pick(r.output), ringtone: pick(r.ringtone) };
+  } catch {
+    return NO_DEVICES;
+  }
+}
+function writeStoredDevices(devices) {
+  if (!isBrowser()) return;
+  try {
+    globalThis.localStorage?.setItem(DEVICES_KEY, JSON.stringify(devices));
+  } catch {
+  }
+}
 var SoftphoneImpl = class extends Emitter {
   #state = "stopped";
   #lastError = null;
@@ -950,7 +1015,7 @@ function isCallEngine(value) {
 }
 
 // src/index.ts
-var VERSION = "0.2.1";
+var VERSION = "0.4.0";
 
 export { CALL_TRANSITIONS, INITIAL_STATES, VERSION, canTransition, createSoftphone, isTerminal };
 //# sourceMappingURL=index.js.map