@coventia/softphone 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { S as Softphone } from './softphone-DHG9MTNg.cjs';
-export { A as AudioDevices } from './softphone-DHG9MTNg.cjs';
-import { S as SoftphoneConfig } from './call-DUVnDxsz.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-DUVnDxsz.cjs';
+import { S as Softphone } from './softphone-dZMkW8V1.cjs';
+export { A as AudioDevices } from './softphone-dZMkW8V1.cjs';
+import { S as SoftphoneConfig } from './call-CaPDWVk3.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 RingtoneOption, l as RingtoneSettings, m as RingtoneSource, n as SoftphoneError, o as SoftphoneErrorCode, p as SoftphoneEvent, q as SoftphoneEventMap, r as SoftphoneState, T as TokenEndpointOptions, s as TokenSource, t as TypedEmitter, V as VoiceToken, u as canTransition, v as isFatal, w as isTerminal } from './call-CaPDWVk3.cjs';
 
 /**
  * Construct a softphone.
@@ -57,6 +57,6 @@ declare function isWebRtcSupported(): boolean;
  *   - `MockProvider` — lives at @coventia/softphone/testing, so it never lands in a production bundle.
  */
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
 
 export { Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isWebRtcSupported };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { S as Softphone } from './softphone-BtdgZWkm.js';
-export { A as AudioDevices } from './softphone-BtdgZWkm.js';
-import { S as SoftphoneConfig } from './call-DUVnDxsz.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-DUVnDxsz.js';
+import { S as Softphone } from './softphone-DEt0TtQw.js';
+export { A as AudioDevices } from './softphone-DEt0TtQw.js';
+import { S as SoftphoneConfig } from './call-CaPDWVk3.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 RingtoneOption, l as RingtoneSettings, m as RingtoneSource, n as SoftphoneError, o as SoftphoneErrorCode, p as SoftphoneEvent, q as SoftphoneEventMap, r as SoftphoneState, T as TokenEndpointOptions, s as TokenSource, t as TypedEmitter, V as VoiceToken, u as canTransition, v as isFatal, w as isTerminal } from './call-CaPDWVk3.js';
 
 /**
  * Construct a softphone.
@@ -57,6 +57,6 @@ declare function isWebRtcSupported(): boolean;
  *   - `MockProvider` — lives at @coventia/softphone/testing, so it never lands in a production bundle.
  */
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
 
 export { Softphone, SoftphoneConfig, VERSION, createSoftphone, isBrowser, isWebRtcSupported };

package/dist/index.js

@@ -75,6 +75,9 @@ function canTransition(from, to) {
 function isTerminal(state) {
   return CALL_TRANSITIONS[state].length === 0;
 }
+function isOnCallState(state) {
+  return state !== "ringing" && !isTerminal(state);
+}
 
 // src/core/call-impl.ts
 var CallImpl = class _CallImpl extends Emitter {
@@ -281,7 +284,7 @@ function coventiaBackend(config, tokenSource, fallbackBaseUrl) {
   }
   let pending = null;
   const load = () => {
-    pending ??= import('./sources-5L2R4HTV.js').then(
+    pending ??= import('./sources-M3GYMS6V.js').then(
       (m) => m.coventiaSources({ ...config, baseUrl, tokenSource })
     );
     return pending;
@@ -292,7 +295,12 @@ 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
+    }
   };
 }
 
@@ -426,13 +434,18 @@ function startPresenceSocket(params) {
   let agents = /* @__PURE__ */ new Map();
   let lastReportedOnCall = null;
   let connection = null;
-  const stop = () => {
+  let byeOnArrival = false;
+  const stop = (options) => {
     if (stopped) return;
     stopped = true;
     if (reconnectTimer !== null) {
       cancelTimeout(reconnectTimer);
       reconnectTimer = null;
     }
+    if (options?.bye) {
+      byeOnArrival = true;
+      connection?.bye?.();
+    }
     connection?.close();
     connection = null;
   };
@@ -471,6 +484,7 @@ function startPresenceSocket(params) {
       return;
     }
     if (stopped) {
+      if (byeOnArrival) opened.bye?.();
       opened.close();
       return;
     }
@@ -491,18 +505,36 @@ function startPresenceSocket(params) {
 
 // src/core/softphone-impl.ts
 var liveInstance = false;
+var PRESENCE_TEARDOWN_GRACE_MS = 1e4;
 var BrowserAudioDevices = class {
   inputs = [];
   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());
@@ -518,26 +550,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;
@@ -565,6 +634,8 @@ var SoftphoneImpl = class extends Emitter {
    * rather than by any one call.
    */
   #presenceWatch = null;
+  /** A pending state-driven teardown of the watch — see `PRESENCE_TEARDOWN_GRACE_MS`. */
+  #presenceTeardownTimer = null;
   #presenceAgents = [];
   /**
    * `tabLock` defaults to the real Web Locks implementation — not part of `SoftphoneConfig` (an
@@ -624,6 +695,7 @@ var SoftphoneImpl = class extends Emitter {
   }
   async stop() {
     if (!this.#startedHere) return;
+    this.#sayGoodbye();
     this.#tabLock.release();
     if (this.#isLeader) {
       await this.#engine.stop();
@@ -639,8 +711,7 @@ var SoftphoneImpl = class extends Emitter {
     this.#destroyed = true;
     for (const stopWatch of this.#activeWatches) stopWatch();
     this.#activeWatches.clear();
-    this.#presenceWatch?.stop();
-    this.#presenceWatch = null;
+    this.#sayGoodbye();
     await this.stop().catch(() => {
     });
     this.#setState("destroyed");
@@ -675,11 +746,15 @@ var SoftphoneImpl = class extends Emitter {
       (target, callerNumber) => this.#onTransfer(target, callerNumber)
     );
     this.#activeCall = call;
+    const offState = call.on("stateChanged" /* StateChanged */, () => this.#syncCallState());
+    this.#syncCallState();
     const off = call.on("ended" /* Ended */, () => {
       off();
+      offState();
       if (this.#activeCall === call) {
         this.#activeCall = null;
         this.emit("activeCallChanged" /* ActiveCallChanged */, { call: null });
+        this.#syncCallState();
       }
     });
     if (this.#resolveContact) {
@@ -699,6 +774,21 @@ var SoftphoneImpl = class extends Emitter {
     this.emit("stateChanged" /* StateChanged */, { state, previous });
     this.#syncPresenceWatch();
   }
+  /**
+   * Whether this softphone is on a call right now, as presence means it (`isOnCallState`). There is a single
+   * active-call slot, and a consult leg is a child of that call, so the parent staying alive covers a consult.
+   */
+  #isOnCall() {
+    return this.#activeCall !== null && isOnCallState(this.#activeCall.state);
+  }
+  /**
+   * Reports the current on-a-call value to the backend. The watch de-duplicates (it only sends on change) and
+   * remembers the latest value to replay after a reconnect, so this can be called on every transition without
+   * ceremony. A no-op while there is no presence watch (not online, not the leader, no backend configured).
+   */
+  #syncCallState() {
+    this.#presenceWatch?.reportCallState(this.#isOnCall());
+  }
   #setLeader(isLeader) {
     if (isLeader === this.#isLeader) return;
     this.#isLeader = isLeader;
@@ -717,9 +807,21 @@ var SoftphoneImpl = class extends Emitter {
    * This still passes `getIsLeader: () => this.#isLeader` for that narrower, defensive recheck; the
    * BROAD online/leader gate — whether to be connected AT ALL — is owned entirely here, the same
    * split `#onTransfer` already has with `startTransferWatch`.
+   *
+   * One exception to "tear down the moment `online` is lost": a leader that is merely `offline` or
+   * `reconnecting` keeps its watch for `PRESENCE_TEARDOWN_GRACE_MS` — a blip shorter than that never touches
+   * the presence socket at all. Anything else (stopped, starting, destroyed, or no longer the leader) still
+   * tears it down at once: those are not blips, and a follower must never hold a connection.
    */
   #syncPresenceWatch() {
-    const shouldRun = Boolean(this.sources) && this.#state === "online" && this.#isLeader;
+    const eligible = Boolean(this.sources) && this.#isLeader;
+    const shouldRun = eligible && this.#state === "online";
+    const blip = eligible && (this.#state === "offline" || this.#state === "reconnecting");
+    if (!blip) this.#cancelPresenceTeardown();
+    if (blip && this.#presenceWatch !== null) {
+      this.#schedulePresenceTeardown();
+      return;
+    }
     if (shouldRun === (this.#presenceWatch !== null)) return;
     if (shouldRun) {
       this.#presenceWatch = startPresenceSocket({
@@ -730,13 +832,49 @@ var SoftphoneImpl = class extends Emitter {
           this.emit("presenceChanged" /* PresenceChanged */, { agents });
         }
       });
+      this.#syncCallState();
     } else {
-      this.#presenceWatch?.stop();
-      this.#presenceWatch = null;
-      this.#presenceAgents = [];
-      this.emit("presenceChanged" /* PresenceChanged */, { agents: [] });
+      this.#stopPresence();
     }
   }
+  /**
+   * Starts the grace period before an `offline` / `reconnecting` leader loses its presence socket. Idempotent
+   * on purpose: a second notification inside the same blip must NOT push the deadline back.
+   */
+  #schedulePresenceTeardown() {
+    if (this.#presenceTeardownTimer !== null) return;
+    this.#presenceTeardownTimer = setTimeout(() => {
+      this.#presenceTeardownTimer = null;
+      if (this.#state === "online" && this.#isLeader) return;
+      this.#stopPresence();
+    }, PRESENCE_TEARDOWN_GRACE_MS);
+  }
+  #cancelPresenceTeardown() {
+    if (this.#presenceTeardownTimer === null) return;
+    clearTimeout(this.#presenceTeardownTimer);
+    this.#presenceTeardownTimer = null;
+  }
+  /**
+   * Stops the presence watch and forgets its roster. A STATE-DRIVEN teardown (the softphone left `online`
+   * for good, or lost leadership) passes nothing and says no goodbye; only a deliberate stop passes `bye`.
+   * Any pending grace-period teardown is cancelled — there is nothing left for it to do.
+   */
+  #stopPresence(options) {
+    this.#cancelPresenceTeardown();
+    if (!this.#presenceWatch) return;
+    this.#presenceWatch.stop(options);
+    this.#presenceWatch = null;
+    this.#presenceAgents = [];
+    this.emit("presenceChanged" /* PresenceChanged */, { agents: [] });
+  }
+  /**
+   * A DELIBERATE stop (`stop()` / `destroy()`): say any call is over, then say goodbye, so the backend drops
+   * this phone at once instead of waiting out the close grace. Idempotent — a second call finds no watch.
+   */
+  #sayGoodbye() {
+    this.#presenceWatch?.reportCallState(false);
+    this.#stopPresence({ bye: true });
+  }
   /**
    * Phase A (transfer outcome relay, `docs/specs/transfer-outcome-relay.md`) — `CallImpl.transfer()`'s
    * internal seam calls this. No-ops entirely when no Coventia backend is configured (`sources` is
@@ -811,7 +949,7 @@ function defaultZadarmaEngine(config) {
   const stateChange = new LazyRelay();
   const error = new LazyRelay();
   function load() {
-    pending ??= import('./zadarma-engine-4VOPIBXG.js').then(({ createZadarmaEngine }) => {
+    pending ??= import('./zadarma-engine-L5DEFXUS.js').then(({ createZadarmaEngine }) => {
       const engine = createZadarmaEngine(config);
       incoming.attach({ on: (l) => engine.onIncoming(l) });
       stateChange.attach({ on: (l) => engine.onStateChange(l) });
@@ -871,7 +1009,7 @@ function isCallEngine(value) {
 }
 
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 
 export { CALL_TRANSITIONS, INITIAL_STATES, VERSION, canTransition, createSoftphone, isTerminal };
 //# sourceMappingURL=index.js.map