@coventia/softphone 0.4.0 → 0.5.0

package/dist/{call-C6YpT6uR.d.cts → call-FqcvDg1t.d.cts}

@@ -86,10 +86,10 @@ interface TokenEndpointOptions {
  */
 interface CoventiaBackendConfig {
     /**
-     * e.g. `https://api.coventia.es`. **Optional** — falls back to `SoftphoneConfig.apiBase`, which
-     * exists precisely so this and the default call engine name the same backend once instead of
-     * twice. Set it here only when contacts/history genuinely live on a DIFFERENT host than calling
-     * does, which is not the normal case.
+     * Coventia's domain, like `SoftphoneConfig.apiBase`: no path, the SDK builds every route.
+     * **Optional** — falls back to `SoftphoneConfig.apiBase`, which exists precisely so this and the
+     * default call engine name the same backend once instead of twice. Set it here only when
+     * contacts/history genuinely live on a DIFFERENT host than calling does, which is not the normal case.
      */
     readonly baseUrl?: string | undefined;
     /**
@@ -104,7 +104,10 @@ interface CoventiaBackendConfig {
      * That is the CRM today.
      */
     readonly organizationId?: string;
-    /** `/phone` today; `/api/v1/phone` once the partner API ships (SPEC §6.6). */
+    /**
+     * Where the phone routes sit under the base URL. Internal: leave it unset (`/phone`). The routes are
+     * the SDK's to build, which is why `apiBase` is the domain only.
+     */
     readonly basePath?: string;
     /**
      * **The one thing a provider customises**: their own contact list, searched on their own backend.
@@ -134,8 +137,11 @@ interface CoventiaBackendConfig {
 interface SoftphoneConfig {
     readonly tokenSource: TokenSource;
     /**
-     * The Coventia backend, e.g. `https://api.coventia.es`. **The one field to set** if you want the
-     * default call engine (see `provider` below) and are not overriding `coventia.baseUrl` separately.
+     * Coventia's domain — **only the domain**, e.g. `https://backend.example.com`, with no path: the SDK
+     * builds every route itself. Not the Partner API URL your backend calls: that one ends in `/api/v1`,
+     * which does not belong here (it is ignored, with a console warning). **The one field to set** if you
+     * want the default call engine (see `provider` below) and are not overriding `coventia.baseUrl`
+     * separately.
      *
      * Named once here rather than requiring it on both `coventia` and the engine you construct: they
      * are two independent subsystems (contacts/history/caller ID vs. SIP credential provisioning) that
@@ -188,8 +194,44 @@ interface CallOptions {
  * Zadarma registers on-demand, per call, in response to a push (SPEC §3.2); a persistent UA is
  * ignored by its PBX. Leaking "registered" into the public API would force every future provider —
  * including our own SIP infrastructure, which registers persistently — to fake it.
+ *
+ * `standby` means started, and this browser's leader, but ANOTHER softphone of the same extension has
+ * the line — a tab in another browser, the desktop app, a partner page (`docs/specs/line-owner.md` §5).
+ * Its push socket is closed on purpose, so nothing here registers or rings: `line` says where the calls
+ * go, and `takeLine()` — or a `call()` — brings them here. A host that reads `online` as "ready"
+ * correctly reads this as not ready.
+ */
+type SoftphoneState = 'stopped' | 'starting' | 'online' | 'standby' | 'offline' | 'reconnecting' | 'destroyed';
+/**
+ * Where this extension's incoming calls ring, as far as this softphone knows. `here`: it has the line.
+ * `elsewhere`: another softphone of the same extension has it, and this one waits in `standby`. `unknown`:
+ * nobody has said — no presence source, a backend that predates the line owner, a presence socket that is
+ * down — and this softphone listens, exactly as before the line owner existed (§5.1 R7, fail-open).
+ */
+type LineState = 'here' | 'elsewhere' | 'unknown';
+/** Who has the line when it is `elsewhere`: the desktop app, or any other softphone (a browser tab). */
+type LineLocation = 'desktop' | 'browser';
+/**
+ * The last attempt to bring the line here — `takeLine()`, or a `call()` from `standby`, whoever made it:
+ * `claiming` while it is in flight, `refused` when the user is on a call where the line is, `failed` when
+ * nothing could decide. `idle` before any attempt, once the line comes here, and after a `stop()`.
  */
-type SoftphoneState = 'stopped' | 'starting' | 'online' | 'offline' | 'reconnecting' | 'destroyed';
+type LineClaim = 'idle' | 'claiming' | 'refused' | 'failed';
+/** The server's word on this softphone's line, as a `PresenceSource` hands it over (`PresenceCallbacks.onLine`). */
+interface LineUpdate {
+    readonly state: 'here' | 'elsewhere';
+    /** Who has the line when it is `elsewhere`; `null` when it is here, or the server did not say. */
+    readonly where: LineLocation | null;
+}
+/** The answer to `PresenceConnection.claimLine()`. */
+interface LineClaimResult {
+    readonly ok: boolean;
+    /**
+     * Why it was refused: `'on_call'` while the user is on a call (the line never moves during one). Any
+     * other value means nothing was decided. Absent when `ok`.
+     */
+    readonly reason?: string;
+}
 interface ContactsPage {
     readonly items: readonly Contact[];
     /**
@@ -349,6 +391,18 @@ interface PresenceConnection {
      * own source that has no such message simply omits it and gets the grace. Sent just before `close()`.
      */
     readonly bye?: () => void;
+    /**
+     * The line owner (`docs/specs/line-owner.md` §5.2): says which softphone this connection speaks for, so
+     * the server can tell it whether it has the line — through `PresenceCallbacks.onLine`, right after this
+     * and on every change. Sent as the FIRST message of every connection. Optional: a source without it never
+     * takes part, and its softphone listens exactly as before (fail-open), reading its line as `unknown`.
+     */
+    readonly hello?: (clientId: string) => void;
+    /**
+     * "Recibir aquí": asks for the line. Answered through `PresenceCallbacks.onClaimResult` — and, when it
+     * succeeds, by `onLine` saying `here` first. Optional, like `hello`.
+     */
+    readonly claimLine?: () => void;
     /**
      * Ends this connection deliberately. Never causes the SAME callbacks' `onClose` to fire — that is
      * reserved for the connection ending on its OWN (a network drop, a server-side close, a rejected
@@ -368,6 +422,13 @@ interface PresenceCallbacks {
      * identical from here, and both get the same treatment (spec §4.4 — quiet retry, nothing surfaced).
      */
     readonly onClose: () => void;
+    /**
+     * The line, as the server says it — right after `PresenceConnection.hello`, and on every change after
+     * that. Optional, so callbacks written before the line owner existed still type-check.
+     */
+    readonly onLine?: (update: LineUpdate) => void;
+    /** The answer to `PresenceConnection.claimLine()`. Optional, like `onLine`. */
+    readonly onClaimResult?: (result: LineClaimResult) => void;
 }
 /**
  * Opens one live presence connection. Coventia-backed by default (mints a one-time ticket, opens
@@ -598,6 +659,16 @@ declare const ERROR_CATALOGUE: {
         readonly message: "The provider does not support this operation.";
         readonly solution: "Guard the UI on the operation before offering it.";
     };
+    readonly 'line/claim-refused': {
+        readonly fatal: false;
+        readonly message: "The line was not moved here: the user is on a call on the softphone that has it.";
+        readonly solution: "Nothing to fix. The line never moves during a call; take it again once that call has ended. Incoming calls keep ringing where they ring now.";
+    };
+    readonly 'line/unavailable': {
+        readonly fatal: false;
+        readonly message: "The line could not be taken: nothing decided where it is.";
+        readonly solution: "The presence connection is down, the backend predates the line owner, or it did not answer in time. Retry in a moment; incoming calls keep ringing where they ring now.";
+    };
     readonly 'provider/provision-failed': {
         readonly fatal: true;
         readonly message: "The provider could not issue SIP credentials.";
@@ -686,10 +757,25 @@ declare enum SoftphoneEvent {
     /**
      * `softphone.presence` changed — the live agent-presence list (Phase B,
      * `docs/specs/transfer-presence-picker.md`) gained a snapshot or an updated entry. Requires a
-     * `PresenceSource` (from `coventia`/`apiBase`, or a host override) AND this tab currently being
-     * `online && isLeader`; never fires at all otherwise, same reasoning as `TransferOutcome`.
+     * `PresenceSource` (from `coventia`/`apiBase`, or a host override) AND this tab currently being a
+     * started leader — `online`, or waiting in `standby` for the line; never fires at all otherwise,
+     * same reasoning as `TransferOutcome`.
      */
-    PresenceChanged = "presenceChanged"
+    PresenceChanged = "presenceChanged",
+    /**
+     * `softphone.line` / `lineWhere` changed (`docs/specs/line-owner.md` §5): this softphone got the line,
+     * lost it to another softphone of the same extension, or stopped knowing (`unknown` — it then listens,
+     * as before the line owner existed). A third axis beside `StateChanged` and `LeaderChanged`: losing the
+     * line is what takes the softphone to `standby`, but not at once while a call is in progress — the line
+     * can read `elsewhere` while the state is still `online`, until that call ends.
+     */
+    LineChanged = "lineChanged",
+    /**
+     * `softphone.lineClaim` changed: an attempt to bring the line here started, was refused, failed, or ended
+     * (the line came here, or the softphone stopped). Kept apart from `LineChanged`, which only ever means the
+     * line itself moved.
+     */
+    LineClaimChanged = "lineClaimChanged"
 }
 interface SoftphoneEventMap {
     [SoftphoneEvent.StateChanged]: {
@@ -710,6 +796,13 @@ interface SoftphoneEventMap {
     [SoftphoneEvent.PresenceChanged]: {
         readonly agents: readonly PresenceEntry[];
     };
+    [SoftphoneEvent.LineChanged]: {
+        readonly line: LineState;
+        readonly where: LineLocation | null;
+    };
+    [SoftphoneEvent.LineClaimChanged]: {
+        readonly claim: LineClaim;
+    };
 }
 declare enum CallEvent {
     /** Any transition. The catch-all; the specific events below are conveniences. */
@@ -936,4 +1029,4 @@ interface Call extends TypedEmitter<CallEventMap> {
     cancelConsult(): Promise<void>;
 }
 
-export { isFatal as A, isTerminal as B, CALL_TRANSITIONS as C, type ContactsSource as D, ERROR_CATALOGUE as E, type FatalErrorCode as F, type HistorySource as G, type HangupReason as H, INITIAL_STATES as I, type AgentsDirectory as J, type TransferOutcomesPage as K, type LogLevel as L, type PresenceSource as M, type NonFatalErrorCode as N, type OutboundNumberRefusal as O, type PresenceEntry as P, type CallHistoryEntry as Q, type RemoteParty as R, type SoftphoneConfig as S, type TokenEndpointOptions as T, type ContactsPage as U, type VoiceToken as V, type Call as a, type CallDirection as b, CallEvent as c, type CallEventMap as d, type CallOptions as e, type CallState as f, type Contact as g, type FatalSoftphoneError as h, type HoldOriginator as i, type NonFatalSoftphoneError as j, type OutboundNumber as k, type OutboundNumberKind as l, type OutboundNumberSettings as m, type OutboundNumberState as n, type OutboundNumbersSource as o, type RingtoneOption as p, type RingtoneSettings as q, type RingtoneSource as r, type SoftphoneError as s, type SoftphoneErrorCode as t, SoftphoneEvent as u, type SoftphoneEventMap as v, type SoftphoneState as w, type TokenSource as x, type TypedEmitter as y, canTransition as z };
+export { type TokenSource as A, type TypedEmitter as B, CALL_TRANSITIONS as C, canTransition as D, ERROR_CATALOGUE as E, type FatalErrorCode as F, isFatal as G, type HangupReason as H, INITIAL_STATES as I, isTerminal as J, type ContactsSource as K, type LineClaim as L, type HistorySource as M, type NonFatalErrorCode as N, type OutboundNumberRefusal as O, type PresenceEntry as P, type AgentsDirectory as Q, type RemoteParty as R, type SoftphoneConfig as S, type TokenEndpointOptions as T, type TransferOutcomesPage as U, type VoiceToken as V, type PresenceSource as W, type CallHistoryEntry as X, type ContactsPage as Y, type Call as a, type CallDirection as b, CallEvent as c, type CallEventMap as d, type CallOptions as e, type CallState as f, type Contact as g, type FatalSoftphoneError as h, type HoldOriginator as i, type LineLocation as j, type LineState as k, type LogLevel as l, type NonFatalSoftphoneError as m, type OutboundNumber as n, type OutboundNumberKind as o, type OutboundNumberSettings as p, type OutboundNumberState as q, type OutboundNumbersSource as r, type RingtoneOption as s, type RingtoneSettings as t, type RingtoneSource as u, type SoftphoneError as v, type SoftphoneErrorCode as w, SoftphoneEvent as x, type SoftphoneEventMap as y, type SoftphoneState as z };

package/dist/{call-C6YpT6uR.d.ts → call-FqcvDg1t.d.ts}

@@ -86,10 +86,10 @@ interface TokenEndpointOptions {
  */
 interface CoventiaBackendConfig {
     /**
-     * e.g. `https://api.coventia.es`. **Optional** — falls back to `SoftphoneConfig.apiBase`, which
-     * exists precisely so this and the default call engine name the same backend once instead of
-     * twice. Set it here only when contacts/history genuinely live on a DIFFERENT host than calling
-     * does, which is not the normal case.
+     * Coventia's domain, like `SoftphoneConfig.apiBase`: no path, the SDK builds every route.
+     * **Optional** — falls back to `SoftphoneConfig.apiBase`, which exists precisely so this and the
+     * default call engine name the same backend once instead of twice. Set it here only when
+     * contacts/history genuinely live on a DIFFERENT host than calling does, which is not the normal case.
      */
     readonly baseUrl?: string | undefined;
     /**
@@ -104,7 +104,10 @@ interface CoventiaBackendConfig {
      * That is the CRM today.
      */
     readonly organizationId?: string;
-    /** `/phone` today; `/api/v1/phone` once the partner API ships (SPEC §6.6). */
+    /**
+     * Where the phone routes sit under the base URL. Internal: leave it unset (`/phone`). The routes are
+     * the SDK's to build, which is why `apiBase` is the domain only.
+     */
     readonly basePath?: string;
     /**
      * **The one thing a provider customises**: their own contact list, searched on their own backend.
@@ -134,8 +137,11 @@ interface CoventiaBackendConfig {
 interface SoftphoneConfig {
     readonly tokenSource: TokenSource;
     /**
-     * The Coventia backend, e.g. `https://api.coventia.es`. **The one field to set** if you want the
-     * default call engine (see `provider` below) and are not overriding `coventia.baseUrl` separately.
+     * Coventia's domain — **only the domain**, e.g. `https://backend.example.com`, with no path: the SDK
+     * builds every route itself. Not the Partner API URL your backend calls: that one ends in `/api/v1`,
+     * which does not belong here (it is ignored, with a console warning). **The one field to set** if you
+     * want the default call engine (see `provider` below) and are not overriding `coventia.baseUrl`
+     * separately.
      *
      * Named once here rather than requiring it on both `coventia` and the engine you construct: they
      * are two independent subsystems (contacts/history/caller ID vs. SIP credential provisioning) that
@@ -188,8 +194,44 @@ interface CallOptions {
  * Zadarma registers on-demand, per call, in response to a push (SPEC §3.2); a persistent UA is
  * ignored by its PBX. Leaking "registered" into the public API would force every future provider —
  * including our own SIP infrastructure, which registers persistently — to fake it.
+ *
+ * `standby` means started, and this browser's leader, but ANOTHER softphone of the same extension has
+ * the line — a tab in another browser, the desktop app, a partner page (`docs/specs/line-owner.md` §5).
+ * Its push socket is closed on purpose, so nothing here registers or rings: `line` says where the calls
+ * go, and `takeLine()` — or a `call()` — brings them here. A host that reads `online` as "ready"
+ * correctly reads this as not ready.
+ */
+type SoftphoneState = 'stopped' | 'starting' | 'online' | 'standby' | 'offline' | 'reconnecting' | 'destroyed';
+/**
+ * Where this extension's incoming calls ring, as far as this softphone knows. `here`: it has the line.
+ * `elsewhere`: another softphone of the same extension has it, and this one waits in `standby`. `unknown`:
+ * nobody has said — no presence source, a backend that predates the line owner, a presence socket that is
+ * down — and this softphone listens, exactly as before the line owner existed (§5.1 R7, fail-open).
+ */
+type LineState = 'here' | 'elsewhere' | 'unknown';
+/** Who has the line when it is `elsewhere`: the desktop app, or any other softphone (a browser tab). */
+type LineLocation = 'desktop' | 'browser';
+/**
+ * The last attempt to bring the line here — `takeLine()`, or a `call()` from `standby`, whoever made it:
+ * `claiming` while it is in flight, `refused` when the user is on a call where the line is, `failed` when
+ * nothing could decide. `idle` before any attempt, once the line comes here, and after a `stop()`.
  */
-type SoftphoneState = 'stopped' | 'starting' | 'online' | 'offline' | 'reconnecting' | 'destroyed';
+type LineClaim = 'idle' | 'claiming' | 'refused' | 'failed';
+/** The server's word on this softphone's line, as a `PresenceSource` hands it over (`PresenceCallbacks.onLine`). */
+interface LineUpdate {
+    readonly state: 'here' | 'elsewhere';
+    /** Who has the line when it is `elsewhere`; `null` when it is here, or the server did not say. */
+    readonly where: LineLocation | null;
+}
+/** The answer to `PresenceConnection.claimLine()`. */
+interface LineClaimResult {
+    readonly ok: boolean;
+    /**
+     * Why it was refused: `'on_call'` while the user is on a call (the line never moves during one). Any
+     * other value means nothing was decided. Absent when `ok`.
+     */
+    readonly reason?: string;
+}
 interface ContactsPage {
     readonly items: readonly Contact[];
     /**
@@ -349,6 +391,18 @@ interface PresenceConnection {
      * own source that has no such message simply omits it and gets the grace. Sent just before `close()`.
      */
     readonly bye?: () => void;
+    /**
+     * The line owner (`docs/specs/line-owner.md` §5.2): says which softphone this connection speaks for, so
+     * the server can tell it whether it has the line — through `PresenceCallbacks.onLine`, right after this
+     * and on every change. Sent as the FIRST message of every connection. Optional: a source without it never
+     * takes part, and its softphone listens exactly as before (fail-open), reading its line as `unknown`.
+     */
+    readonly hello?: (clientId: string) => void;
+    /**
+     * "Recibir aquí": asks for the line. Answered through `PresenceCallbacks.onClaimResult` — and, when it
+     * succeeds, by `onLine` saying `here` first. Optional, like `hello`.
+     */
+    readonly claimLine?: () => void;
     /**
      * Ends this connection deliberately. Never causes the SAME callbacks' `onClose` to fire — that is
      * reserved for the connection ending on its OWN (a network drop, a server-side close, a rejected
@@ -368,6 +422,13 @@ interface PresenceCallbacks {
      * identical from here, and both get the same treatment (spec §4.4 — quiet retry, nothing surfaced).
      */
     readonly onClose: () => void;
+    /**
+     * The line, as the server says it — right after `PresenceConnection.hello`, and on every change after
+     * that. Optional, so callbacks written before the line owner existed still type-check.
+     */
+    readonly onLine?: (update: LineUpdate) => void;
+    /** The answer to `PresenceConnection.claimLine()`. Optional, like `onLine`. */
+    readonly onClaimResult?: (result: LineClaimResult) => void;
 }
 /**
  * Opens one live presence connection. Coventia-backed by default (mints a one-time ticket, opens
@@ -598,6 +659,16 @@ declare const ERROR_CATALOGUE: {
         readonly message: "The provider does not support this operation.";
         readonly solution: "Guard the UI on the operation before offering it.";
     };
+    readonly 'line/claim-refused': {
+        readonly fatal: false;
+        readonly message: "The line was not moved here: the user is on a call on the softphone that has it.";
+        readonly solution: "Nothing to fix. The line never moves during a call; take it again once that call has ended. Incoming calls keep ringing where they ring now.";
+    };
+    readonly 'line/unavailable': {
+        readonly fatal: false;
+        readonly message: "The line could not be taken: nothing decided where it is.";
+        readonly solution: "The presence connection is down, the backend predates the line owner, or it did not answer in time. Retry in a moment; incoming calls keep ringing where they ring now.";
+    };
     readonly 'provider/provision-failed': {
         readonly fatal: true;
         readonly message: "The provider could not issue SIP credentials.";
@@ -686,10 +757,25 @@ declare enum SoftphoneEvent {
     /**
      * `softphone.presence` changed — the live agent-presence list (Phase B,
      * `docs/specs/transfer-presence-picker.md`) gained a snapshot or an updated entry. Requires a
-     * `PresenceSource` (from `coventia`/`apiBase`, or a host override) AND this tab currently being
-     * `online && isLeader`; never fires at all otherwise, same reasoning as `TransferOutcome`.
+     * `PresenceSource` (from `coventia`/`apiBase`, or a host override) AND this tab currently being a
+     * started leader — `online`, or waiting in `standby` for the line; never fires at all otherwise,
+     * same reasoning as `TransferOutcome`.
      */
-    PresenceChanged = "presenceChanged"
+    PresenceChanged = "presenceChanged",
+    /**
+     * `softphone.line` / `lineWhere` changed (`docs/specs/line-owner.md` §5): this softphone got the line,
+     * lost it to another softphone of the same extension, or stopped knowing (`unknown` — it then listens,
+     * as before the line owner existed). A third axis beside `StateChanged` and `LeaderChanged`: losing the
+     * line is what takes the softphone to `standby`, but not at once while a call is in progress — the line
+     * can read `elsewhere` while the state is still `online`, until that call ends.
+     */
+    LineChanged = "lineChanged",
+    /**
+     * `softphone.lineClaim` changed: an attempt to bring the line here started, was refused, failed, or ended
+     * (the line came here, or the softphone stopped). Kept apart from `LineChanged`, which only ever means the
+     * line itself moved.
+     */
+    LineClaimChanged = "lineClaimChanged"
 }
 interface SoftphoneEventMap {
     [SoftphoneEvent.StateChanged]: {
@@ -710,6 +796,13 @@ interface SoftphoneEventMap {
     [SoftphoneEvent.PresenceChanged]: {
         readonly agents: readonly PresenceEntry[];
     };
+    [SoftphoneEvent.LineChanged]: {
+        readonly line: LineState;
+        readonly where: LineLocation | null;
+    };
+    [SoftphoneEvent.LineClaimChanged]: {
+        readonly claim: LineClaim;
+    };
 }
 declare enum CallEvent {
     /** Any transition. The catch-all; the specific events below are conveniences. */
@@ -936,4 +1029,4 @@ interface Call extends TypedEmitter<CallEventMap> {
     cancelConsult(): Promise<void>;
 }
 
-export { isFatal as A, isTerminal as B, CALL_TRANSITIONS as C, type ContactsSource as D, ERROR_CATALOGUE as E, type FatalErrorCode as F, type HistorySource as G, type HangupReason as H, INITIAL_STATES as I, type AgentsDirectory as J, type TransferOutcomesPage as K, type LogLevel as L, type PresenceSource as M, type NonFatalErrorCode as N, type OutboundNumberRefusal as O, type PresenceEntry as P, type CallHistoryEntry as Q, type RemoteParty as R, type SoftphoneConfig as S, type TokenEndpointOptions as T, type ContactsPage as U, type VoiceToken as V, type Call as a, type CallDirection as b, CallEvent as c, type CallEventMap as d, type CallOptions as e, type CallState as f, type Contact as g, type FatalSoftphoneError as h, type HoldOriginator as i, type NonFatalSoftphoneError as j, type OutboundNumber as k, type OutboundNumberKind as l, type OutboundNumberSettings as m, type OutboundNumberState as n, type OutboundNumbersSource as o, type RingtoneOption as p, type RingtoneSettings as q, type RingtoneSource as r, type SoftphoneError as s, type SoftphoneErrorCode as t, SoftphoneEvent as u, type SoftphoneEventMap as v, type SoftphoneState as w, type TokenSource as x, type TypedEmitter as y, canTransition as z };
+export { type TokenSource as A, type TypedEmitter as B, CALL_TRANSITIONS as C, canTransition as D, ERROR_CATALOGUE as E, type FatalErrorCode as F, isFatal as G, type HangupReason as H, INITIAL_STATES as I, isTerminal as J, type ContactsSource as K, type LineClaim as L, type HistorySource as M, type NonFatalErrorCode as N, type OutboundNumberRefusal as O, type PresenceEntry as P, type AgentsDirectory as Q, type RemoteParty as R, type SoftphoneConfig as S, type TokenEndpointOptions as T, type TransferOutcomesPage as U, type VoiceToken as V, type PresenceSource as W, type CallHistoryEntry as X, type ContactsPage as Y, type Call as a, type CallDirection as b, CallEvent as c, type CallEventMap as d, type CallOptions as e, type CallState as f, type Contact as g, type FatalSoftphoneError as h, type HoldOriginator as i, type LineLocation as j, type LineState as k, type LogLevel as l, type NonFatalSoftphoneError as m, type OutboundNumber as n, type OutboundNumberKind as o, type OutboundNumberSettings as p, type OutboundNumberState as q, type OutboundNumbersSource as r, type RingtoneOption as s, type RingtoneSettings as t, type RingtoneSource as u, type SoftphoneError as v, type SoftphoneErrorCode as w, SoftphoneEvent as x, type SoftphoneEventMap as y, type SoftphoneState as z };

package/dist/{chunk-EYEDPD7Y.js → chunk-6RR6G35E.js}

@@ -1,4 +1,5 @@
-import { createError, isSoftphoneError } from './chunk-2ZSOGGPO.js';
+import { normalizeApiBase } from './chunk-M76SAXXM.js';
+import { createError, isSoftphoneError } from './chunk-FRXHEHQA.js';
 import { cachedTokenSource, invalidateToken } from './chunk-MHOJHG5E.js';
 
 // src/transports/sip/media.ts
@@ -254,9 +255,22 @@ var SipCallEngine = class {
   provider;
   factory;
   #state = "stopped";
+  /**
+   * Which `start()`…`stop()` cycle this is — bumped by `stop()`, which ends one. Everything that awaits
+   * and then acts (builds a UA, subscribes to the signal, sets the state) captures it first and gives up
+   * if a stop has happened since. Not bumped by `start()`: that would cancel work begun just before it,
+   * such as a call placed while the softphone is still starting.
+   *
+   * Without it a stopped phone came back to life: a provisioning or a signal connect still in flight
+   * when `stop()` ran finished afterwards and REGISTERed — and since the PBX routes a call to whichever
+   * client registered last, it quietly took calls from the user's other device while its UI said off.
+   */
+  #run = 0;
   #ua = null;
   /** In-flight `#createUA()`. THE concurrency guard — see `#ensureUA`. */
   #uaInFlight = null;
+  /** Calls waiting for the current UA to register (`#callWhenRegistered`), failed by `#teardownUA`. */
+  #awaitingRegistration = /* @__PURE__ */ new Set();
   #domain = "";
   #activeCall = null;
   /**
@@ -339,14 +353,25 @@ var SipCallEngine = class {
     for (const listener of [...this.#errorListeners]) listener(error);
   }
   async start() {
+    const run = this.#run;
     this.#setState("starting");
     if (this.provider.registrationMode === "persistent") {
-      await this.#ensureUA();
+      try {
+        await this.#ensureUA();
+      } catch (cause) {
+        if (run === this.#run) throw cause;
+      }
+      if (run !== this.#run) return;
       this.#setState("online");
     } else {
       const signal = this.provider.incomingSignal;
       if (signal) {
-        await signal.connect();
+        try {
+          await signal.connect();
+        } catch (cause) {
+          if (run === this.#run) throw cause;
+        }
+        if (run !== this.#run) return;
         this.#signalUnsub = signal.onSignal(() => void this.#onIncomingSignal());
         this.#signalConnectionUnsub = signal.onConnectionChange?.(
           (connected) => this.#setState(connected ? "online" : "offline")
@@ -356,6 +381,7 @@ var SipCallEngine = class {
     }
   }
   async stop() {
+    this.#run += 1;
     this.#clearNoInviteTimer();
     this.#signalUnsub?.();
     this.#signalUnsub = null;
@@ -374,11 +400,12 @@ var SipCallEngine = class {
   async #onIncomingSignal() {
     if (this.now() < this.#rejectGuardUntil) return;
     if (this.#activeCall) return;
+    const run = this.#run;
     try {
       await this.#ensureUA();
       this.#armNoInviteTeardown();
     } catch {
-      this.#teardownUA();
+      if (run === this.#run) this.#teardownUA();
     }
   }
   #armNoInviteTeardown() {
@@ -440,12 +467,16 @@ var SipCallEngine = class {
    */
   async #ensureUA() {
     if (this.#ua) return this.#ua;
-    this.#uaInFlight ??= this.#createUA().finally(() => {
-      this.#uaInFlight = null;
-    });
+    if (!this.#uaInFlight) {
+      const inFlight = this.#createUA().finally(() => {
+        if (this.#uaInFlight === inFlight) this.#uaInFlight = null;
+      });
+      this.#uaInFlight = inFlight;
+    }
     return this.#uaInFlight;
   }
   async #createUA() {
+    const run = this.#run;
     const factory = await this.#resolveFactory();
     let credentials;
     try {
@@ -455,17 +486,28 @@ var SipCallEngine = class {
       else this.#reportError("provider/provision-failed", cause);
       throw cause;
     }
+    if (run !== this.#run) throw createError("engine/not-started");
     this.#domain = domainOf(credentials);
     const config = this.#uaConfig(credentials, factory);
     const ua = factory.createUA(config);
-    ua.on("newRTCSession", ({ session, originator }) => this.#onNewSession(session, originator));
+    ua.on("newRTCSession", ({ session, originator }) => {
+      if (ua !== this.#ua) {
+        if (originator === "remote") session.terminate({ status_code: 486, reason_phrase: "Busy Here" });
+        return;
+      }
+      this.#onNewSession(session, originator);
+    });
     ua.on("disconnected", ({ error }) => {
+      if (ua !== this.#ua) return;
       if (!error) return;
       this.#setState("reconnecting");
       this.#reportError("net/transport-failed", error);
     });
-    ua.on("connected", () => this.#setState("online"));
+    ua.on("connected", () => {
+      if (ua === this.#ua) this.#setState("online");
+    });
     ua.on("registrationFailed", (e) => {
+      if (run !== this.#run) return;
       const detail = e;
       this.#reportError("net/registration-failed", {
         cause: detail?.cause,
@@ -473,7 +515,7 @@ var SipCallEngine = class {
         domain: this.#domain,
         hint: "A bare 401 with no auth challenge usually means the registrar is in the wrong datacenter (SPEC \xA73.1)."
       });
-      this.#teardownUA();
+      if (ua === this.#ua) this.#teardownUA();
       void this.#refreshSignal();
     });
     this.#ua = ua;
@@ -500,6 +542,7 @@ var SipCallEngine = class {
   #teardownUA() {
     this.#uaInFlight = null;
     if (!this.#ua) return;
+    for (const fail of [...this.#awaitingRegistration]) fail();
     try {
       this.#ua.terminateSessions({ status_code: 487 });
       this.#ua.stop();
@@ -523,8 +566,27 @@ var SipCallEngine = class {
   #callWhenRegistered(ua, target) {
     const options = { mediaConstraints: buildAudioConstraints(this.#inputDeviceId), pcConfig: PC_CONFIG };
     if (ua.isRegistered()) return Promise.resolve(ua.call(target, options));
-    return new Promise((resolve) => {
-      ua.on("registered", () => resolve(ua.call(target, options)));
+    const run = this.#run;
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const fail = () => {
+        if (settled) return;
+        settled = true;
+        this.#awaitingRegistration.delete(fail);
+        reject(createError(run === this.#run ? "call/failed" : "engine/not-started"));
+      };
+      this.#awaitingRegistration.add(fail);
+      ua.on("registered", () => {
+        if (settled) return;
+        if (ua !== this.#ua) return fail();
+        settled = true;
+        this.#awaitingRegistration.delete(fail);
+        try {
+          resolve(ua.call(target, options));
+        } catch (cause) {
+          reject(cause);
+        }
+      });
     });
   }
   #wrapCall(session) {
@@ -664,6 +726,12 @@ var ZadarmaPushSignal = class {
   #retryTimer;
   #unwatchBackground;
   #closed = false;
+  /**
+   * Bumped by `disconnect()`. An open or a rebuild still awaiting its key when the signal is disconnected
+   * must build nothing afterwards — and `#closed` alone cannot say so once a later `connect()` (stop, then
+   * start again) has reset it: the late socket was built beside the new one, and nothing ever closed it.
+   */
+  #run = 0;
   #listeners = /* @__PURE__ */ new Set();
   #connectionListeners = /* @__PURE__ */ new Set();
   async connect() {
@@ -673,8 +741,9 @@ var ZadarmaPushSignal = class {
     await this.#open();
   }
   async #open() {
+    const run = this.#run;
     const { key, sip, keyExpiresAt } = await this.deps.fetchKey();
-    if (this.#closed) return;
+    if (run !== this.#run) return;
     const socket = this.deps.createPushSocket(buildPushUrl(key, sip));
     this.#socket = socket;
     this.#attach(socket);
@@ -769,9 +838,10 @@ var ZadarmaPushSignal = class {
       return;
     }
     this.#rebuilding = true;
+    const run = this.#run;
     try {
       const { key, sip, keyExpiresAt } = await this.deps.fetchKey();
-      if (this.#closed) return;
+      if (run !== this.#run) return;
       const swapped = await new Promise((resolve) => {
         const socket = this.deps.createPushSocket(buildPushUrl(key, sip));
         this.#candidate = socket;
@@ -824,6 +894,7 @@ var ZadarmaPushSignal = class {
   }
   disconnect() {
     this.#closed = true;
+    this.#run += 1;
     this.#stopPings();
     clearTimeout(this.#refreshTimer);
     this.#refreshTimer = void 0;
@@ -1061,11 +1132,15 @@ function makeZadarmaBrowserDeps(config) {
 // src/transports/zadarma-engine.ts
 function createZadarmaEngine(config) {
   const provider = new ZadarmaProvider(
-    makeZadarmaBrowserDeps({ ...config, tokenSource: cachedTokenSource(config.tokenSource) })
+    makeZadarmaBrowserDeps({
+      ...config,
+      apiBase: normalizeApiBase(config.apiBase),
+      tokenSource: cachedTokenSource(config.tokenSource)
+    })
   );
   return new SipCallEngine(provider, loadJsSipFactory);
 }
 
 export { ZADARMA_QUIRKS, createZadarmaEngine };
-//# sourceMappingURL=chunk-EYEDPD7Y.js.map
-//# sourceMappingURL=chunk-EYEDPD7Y.js.map
+//# sourceMappingURL=chunk-6RR6G35E.js.map
+//# sourceMappingURL=chunk-6RR6G35E.js.map