@coventia/softphone 0.2.0 → 0.2.1

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-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';
 
 /**
  * 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.2.1";
 
 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-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';
 
 /**
  * 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.2.1";
 
 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-IRKNQPWW.js').then(
       (m) => m.coventiaSources({ ...config, baseUrl, tokenSource })
     );
     return pending;
@@ -426,13 +429,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 +479,7 @@ function startPresenceSocket(params) {
       return;
     }
     if (stopped) {
+      if (byeOnArrival) opened.bye?.();
       opened.close();
       return;
     }
@@ -491,6 +500,7 @@ function startPresenceSocket(params) {
 
 // src/core/softphone-impl.ts
 var liveInstance = false;
+var PRESENCE_TEARDOWN_GRACE_MS = 1e4;
 var BrowserAudioDevices = class {
   inputs = [];
   outputs = [];
@@ -565,6 +575,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 +636,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 +652,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 +687,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 +715,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 +748,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 +773,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 +890,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 +950,7 @@ function isCallEngine(value) {
 }
 
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 
 export { CALL_TRANSITIONS, INITIAL_STATES, VERSION, canTransition, createSoftphone, isTerminal };
 //# sourceMappingURL=index.js.map