@coventia/softphone 0.2.1 → 0.3.0

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/context.tsx","../../src/react/hooks.ts"],"names":["createContext","useContext","useSyncExternalStore","useCallback","useRef"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, useContext, type ReactNode } from 'react';\r\nimport type { Softphone } from '../core/softphone.js';\r\n\r\n/**\r\n * The provider takes an INSTANCE the host constructed — not config props.\r\n *\r\n * This is LiveKit's hard-won lesson (SPEC §5.1): they are deprecating their config-props\r\n * `<LiveKitRoom>` in favour of a provider that accepts an instance. Holding the `Softphone` above the\r\n * React tree lets the app own the connection, survive route changes and unmounts without dropping a\r\n * call, and unit-test the engine with no React at all. Config-props would rebuild the engine on\r\n * every prop change — catastrophic for something holding a live `RTCPeerConnection`.\r\n */\r\nconst SoftphoneContext = createContext<Softphone | null>(null);\r\n\r\nexport interface SoftphoneProviderProps {\r\n  readonly softphone: Softphone;\r\n  readonly children: ReactNode;\r\n}\r\n\r\nexport function SoftphoneProvider({ softphone, children }: SoftphoneProviderProps) {\r\n  return <SoftphoneContext.Provider value={softphone}>{children}</SoftphoneContext.Provider>;\r\n}\r\n\r\n/** The `Softphone` instance from context. Stable — does not re-render on state changes. */\r\nexport function useSoftphone(): Softphone {\r\n  const softphone = useContext(SoftphoneContext);\r\n  if (!softphone) {\r\n    throw new Error('useSoftphone() must be used within a <SoftphoneProvider>.');\r\n  }\r\n  return softphone;\r\n}\r\n","// Built-in, no shim: the peer floor is React 18 (SPEC §2.7), which ships useSyncExternalStore.\r\nimport { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useSoftphone } from './context.js';\r\nimport { SoftphoneEvent, CallEvent } from '../core/events.js';\r\nimport type { Call, CallState } from '../core/call.js';\r\nimport type { PresenceEntry, RemoteParty, SoftphoneState } from '../core/types.js';\r\nimport type { AudioDevices } from '../core/softphone.js';\r\nimport type { FatalSoftphoneError } from '../core/errors.js';\r\n\r\n/** Reactive softphone lifecycle state (`stopped` → `online` → …). */\r\n/**\r\n * The reason the phone cannot currently be used, or `null`.\r\n *\r\n * Reads `softphone.lastError`, which is STATE rather than only an event — the widget is usually\r\n * opened *after* something broke, and a listener mounted at that point would have missed the event\r\n * entirely and rendered a dialpad with no explanation.\r\n *\r\n * Re-reads on both channels because both can change it: `Error` sets it, and `StateChanged` clears it\r\n * on reaching `online`. Subscribing to only the first would leave a stale gate on screen after the\r\n * phone recovered.\r\n */\r\nexport function useLastError(): FatalSoftphoneError | null {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback(\r\n      (cb: () => void) => {\r\n        const offError = phone.on(SoftphoneEvent.Error, () => cb());\r\n        const offState = phone.on(SoftphoneEvent.StateChanged, () => cb());\r\n        return () => {\r\n          offError();\r\n          offState();\r\n        };\r\n      },\r\n      [phone],\r\n    ),\r\n    useCallback(() => phone.lastError, [phone]),\r\n  );\r\n}\r\n\r\nexport function useSoftphoneState(): SoftphoneState {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.StateChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.state, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * Whether THIS tab is the one allowed to be reachable (`multi-tab-leader-election.md`). `false` by\r\n * default and while waiting for another open tab to release it — show your own \"active in another\r\n * tab\" state for that duration; the `/ui` widget already does.\r\n */\r\nexport function useIsLeader(): boolean {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.LeaderChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.isLeader, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * The current call, or null. Re-renders when it changes — inbound, outbound, or ended.\r\n *\r\n * `phone.activeCall` returns a stable reference for a given call, so it is a safe snapshot.\r\n */\r\nexport function useActiveCall(): Call | null {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.ActiveCallChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.activeCall, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * The live agent-presence list (`phone.presence`, Phase B) — reactive on `SoftphoneEvent.\r\n * PresenceChanged`. `active` gates the SUBSCRIPTION only, not the underlying connection: the socket\r\n * itself stays governed entirely by `online && isLeader` inside the softphone (spec's own\r\n * always-connected decision), so passing `false` here does not close it — it only stops this\r\n * particular component from re-rendering on every update while it has no reason to care, e.g. the\r\n * transfer step being closed (spec §4.5: \"subscribe when the step opens... unsubscribe when it\r\n * closes\"). `phone.presence` is still read fresh on every call, so flipping `active` back to `true`\r\n * never shows a stale snapshot.\r\n */\r\nexport function usePresence(active: boolean): readonly PresenceEntry[] {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback(\r\n      (cb: () => void) => {\r\n        if (!active) return () => {};\r\n        return phone.on(SoftphoneEvent.PresenceChanged, () => cb());\r\n      },\r\n      [phone, active],\r\n    ),\r\n    useCallback(() => phone.presence, [phone]),\r\n  );\r\n}\r\n\r\n/** An immutable snapshot of a call's reactive fields. */\r\nexport interface CallView {\r\n  readonly state: CallState;\r\n  readonly isMuted: boolean;\r\n  readonly isOnHold: boolean;\r\n  readonly remote: RemoteParty;\r\n  readonly remoteStream: MediaStream | null;\r\n  readonly answeredAt: Date | null;\r\n}\r\n\r\nconst CALL_EVENTS: readonly CallEvent[] = [\r\n  CallEvent.StateChanged,\r\n  CallEvent.Muted,\r\n  CallEvent.Held,\r\n  CallEvent.Unheld,\r\n  CallEvent.RemotePartyUpdated,\r\n  CallEvent.RemoteStream,\r\n  CallEvent.Ended,\r\n];\r\n\r\n/**\r\n * Reactive view of a specific call. Re-renders only when one of the call's own events fires — no\r\n * polling, no re-render storms.\r\n *\r\n * The snapshot is CACHED and invalidated only on an event, so `useSyncExternalStore` gets a stable\r\n * reference between changes (returning a fresh object every render would infinite-loop).\r\n */\r\nexport function useCall(call: Call | null): CallView | null {\r\n  const cache = useRef<{ call: Call; view: CallView } | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (cb: () => void) => {\r\n      if (!call) return () => {};\r\n      const unsubs = CALL_EVENTS.map((event) =>\r\n        call.on(event, () => {\r\n          cache.current = null; // invalidate; getSnapshot rebuilds on the next read\r\n          cb();\r\n        }),\r\n      );\r\n      return () => {\r\n        for (const off of unsubs) off();\r\n      };\r\n    },\r\n    [call],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CallView | null => {\r\n    if (!call) return null;\r\n    if (cache.current?.call === call) return cache.current.view;\r\n    const view: CallView = {\r\n      state: call.state,\r\n      isMuted: call.isMuted,\r\n      isOnHold: call.isOnHold,\r\n      remote: call.remote,\r\n      remoteStream: call.remoteStream,\r\n      answeredAt: call.answeredAt,\r\n    };\r\n    cache.current = { call, view };\r\n    return view;\r\n  }, [call]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n\r\n/**\r\n * The audio device surface (`phone.audio`) — reactive. Re-renders on `SoftphoneEvent.DeviceChange`: a\r\n * device plugged/unplugged, or a selection changed (SPEC §7 Phase 2).\r\n *\r\n * The snapshot is CACHED and invalidated only on that event, same reasoning as `useCall`'s own\r\n * `CallView`: `phone.audio` is ONE stable object whose fields mutate in place, so returning it\r\n * directly would never change by reference and `useSyncExternalStore` would never re-render. A fresh\r\n * object, rebuilt only when something actually changed, is what makes this reactive without polling.\r\n */\r\nexport function useDevices(): AudioDevices {\r\n  const phone = useSoftphone();\r\n  const cache = useRef<{ audio: AudioDevices; view: AudioDevices } | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (cb: () => void) =>\r\n      phone.on(SoftphoneEvent.DeviceChange, () => {\r\n        cache.current = null; // invalidate; getSnapshot rebuilds on the next read\r\n        cb();\r\n      }),\r\n    [phone],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): AudioDevices => {\r\n    const audio = phone.audio;\r\n    if (cache.current?.audio === audio) return cache.current.view;\r\n    const view: AudioDevices = {\r\n      inputs: audio.inputs,\r\n      outputs: audio.outputs,\r\n      currentInputId: audio.currentInputId,\r\n      currentOutputId: audio.currentOutputId,\r\n      canSelectOutput: audio.canSelectOutput,\r\n      setInput: (deviceId) => audio.setInput(deviceId),\r\n      setOutput: (deviceId) => audio.setOutput(deviceId),\r\n      setRingtoneOutput: (deviceId) => audio.setRingtoneOutput(deviceId),\r\n      refresh: () => audio.refresh(),\r\n    };\r\n    cache.current = { audio, view };\r\n    return view;\r\n  }, [phone]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n"]}
+{"version":3,"sources":["../../src/react/context.tsx","../../src/react/hooks.ts"],"names":["createContext","useContext","useSyncExternalStore","useCallback","useRef"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, useContext, type ReactNode } from 'react';\r\nimport type { Softphone } from '../core/softphone.js';\r\n\r\n/**\r\n * The provider takes an INSTANCE the host constructed — not config props.\r\n *\r\n * This is LiveKit's hard-won lesson (SPEC §5.1): they are deprecating their config-props\r\n * `<LiveKitRoom>` in favour of a provider that accepts an instance. Holding the `Softphone` above the\r\n * React tree lets the app own the connection, survive route changes and unmounts without dropping a\r\n * call, and unit-test the engine with no React at all. Config-props would rebuild the engine on\r\n * every prop change — catastrophic for something holding a live `RTCPeerConnection`.\r\n */\r\nconst SoftphoneContext = createContext<Softphone | null>(null);\r\n\r\nexport interface SoftphoneProviderProps {\r\n  readonly softphone: Softphone;\r\n  readonly children: ReactNode;\r\n}\r\n\r\nexport function SoftphoneProvider({ softphone, children }: SoftphoneProviderProps) {\r\n  return <SoftphoneContext.Provider value={softphone}>{children}</SoftphoneContext.Provider>;\r\n}\r\n\r\n/** The `Softphone` instance from context. Stable — does not re-render on state changes. */\r\nexport function useSoftphone(): Softphone {\r\n  const softphone = useContext(SoftphoneContext);\r\n  if (!softphone) {\r\n    throw new Error('useSoftphone() must be used within a <SoftphoneProvider>.');\r\n  }\r\n  return softphone;\r\n}\r\n","// Built-in, no shim: the peer floor is React 18 (SPEC §2.7), which ships useSyncExternalStore.\r\nimport { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useSoftphone } from './context.js';\r\nimport { SoftphoneEvent, CallEvent } from '../core/events.js';\r\nimport type { Call, CallState } from '../core/call.js';\r\nimport type { PresenceEntry, RemoteParty, SoftphoneState } from '../core/types.js';\r\nimport type { AudioDevices } from '../core/softphone.js';\r\nimport type { FatalSoftphoneError } from '../core/errors.js';\r\n\r\n/** Reactive softphone lifecycle state (`stopped` → `online` → …). */\r\n/**\r\n * The reason the phone cannot currently be used, or `null`.\r\n *\r\n * Reads `softphone.lastError`, which is STATE rather than only an event — the widget is usually\r\n * opened *after* something broke, and a listener mounted at that point would have missed the event\r\n * entirely and rendered a dialpad with no explanation.\r\n *\r\n * Re-reads on both channels because both can change it: `Error` sets it, and `StateChanged` clears it\r\n * on reaching `online`. Subscribing to only the first would leave a stale gate on screen after the\r\n * phone recovered.\r\n */\r\nexport function useLastError(): FatalSoftphoneError | null {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback(\r\n      (cb: () => void) => {\r\n        const offError = phone.on(SoftphoneEvent.Error, () => cb());\r\n        const offState = phone.on(SoftphoneEvent.StateChanged, () => cb());\r\n        return () => {\r\n          offError();\r\n          offState();\r\n        };\r\n      },\r\n      [phone],\r\n    ),\r\n    useCallback(() => phone.lastError, [phone]),\r\n  );\r\n}\r\n\r\nexport function useSoftphoneState(): SoftphoneState {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.StateChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.state, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * Whether THIS tab is the one allowed to be reachable (`multi-tab-leader-election.md`). `false` by\r\n * default and while waiting for another open tab to release it — show your own \"active in another\r\n * tab\" state for that duration; the `/ui` widget already does.\r\n */\r\nexport function useIsLeader(): boolean {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.LeaderChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.isLeader, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * The current call, or null. Re-renders when it changes — inbound, outbound, or ended.\r\n *\r\n * `phone.activeCall` returns a stable reference for a given call, so it is a safe snapshot.\r\n */\r\nexport function useActiveCall(): Call | null {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback((cb: () => void) => phone.on(SoftphoneEvent.ActiveCallChanged, () => cb()), [phone]),\r\n    useCallback(() => phone.activeCall, [phone]),\r\n  );\r\n}\r\n\r\n/**\r\n * The live agent-presence list (`phone.presence`, Phase B) — reactive on `SoftphoneEvent.\r\n * PresenceChanged`. `active` gates the SUBSCRIPTION only, not the underlying connection: the socket\r\n * itself stays governed entirely by `online && isLeader` inside the softphone (spec's own\r\n * always-connected decision), so passing `false` here does not close it — it only stops this\r\n * particular component from re-rendering on every update while it has no reason to care, e.g. the\r\n * transfer step being closed (spec §4.5: \"subscribe when the step opens... unsubscribe when it\r\n * closes\"). `phone.presence` is still read fresh on every call, so flipping `active` back to `true`\r\n * never shows a stale snapshot.\r\n */\r\nexport function usePresence(active: boolean): readonly PresenceEntry[] {\r\n  const phone = useSoftphone();\r\n  return useSyncExternalStore(\r\n    useCallback(\r\n      (cb: () => void) => {\r\n        if (!active) return () => {};\r\n        return phone.on(SoftphoneEvent.PresenceChanged, () => cb());\r\n      },\r\n      [phone, active],\r\n    ),\r\n    useCallback(() => phone.presence, [phone]),\r\n  );\r\n}\r\n\r\n/** An immutable snapshot of a call's reactive fields. */\r\nexport interface CallView {\r\n  readonly state: CallState;\r\n  readonly isMuted: boolean;\r\n  readonly isOnHold: boolean;\r\n  readonly remote: RemoteParty;\r\n  readonly remoteStream: MediaStream | null;\r\n  readonly answeredAt: Date | null;\r\n}\r\n\r\nconst CALL_EVENTS: readonly CallEvent[] = [\r\n  CallEvent.StateChanged,\r\n  CallEvent.Muted,\r\n  CallEvent.Held,\r\n  CallEvent.Unheld,\r\n  CallEvent.RemotePartyUpdated,\r\n  CallEvent.RemoteStream,\r\n  CallEvent.Ended,\r\n];\r\n\r\n/**\r\n * Reactive view of a specific call. Re-renders only when one of the call's own events fires — no\r\n * polling, no re-render storms.\r\n *\r\n * The snapshot is CACHED and invalidated only on an event, so `useSyncExternalStore` gets a stable\r\n * reference between changes (returning a fresh object every render would infinite-loop).\r\n */\r\nexport function useCall(call: Call | null): CallView | null {\r\n  const cache = useRef<{ call: Call; view: CallView } | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (cb: () => void) => {\r\n      if (!call) return () => {};\r\n      const unsubs = CALL_EVENTS.map((event) =>\r\n        call.on(event, () => {\r\n          cache.current = null; // invalidate; getSnapshot rebuilds on the next read\r\n          cb();\r\n        }),\r\n      );\r\n      return () => {\r\n        for (const off of unsubs) off();\r\n      };\r\n    },\r\n    [call],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CallView | null => {\r\n    if (!call) return null;\r\n    if (cache.current?.call === call) return cache.current.view;\r\n    const view: CallView = {\r\n      state: call.state,\r\n      isMuted: call.isMuted,\r\n      isOnHold: call.isOnHold,\r\n      remote: call.remote,\r\n      remoteStream: call.remoteStream,\r\n      answeredAt: call.answeredAt,\r\n    };\r\n    cache.current = { call, view };\r\n    return view;\r\n  }, [call]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n\r\n/**\r\n * The audio device surface (`phone.audio`) — reactive. Re-renders on `SoftphoneEvent.DeviceChange`: a\r\n * device plugged/unplugged, or a selection changed (SPEC §7 Phase 2).\r\n *\r\n * The snapshot is CACHED and invalidated only on that event, same reasoning as `useCall`'s own\r\n * `CallView`: `phone.audio` is ONE stable object whose fields mutate in place, so returning it\r\n * directly would never change by reference and `useSyncExternalStore` would never re-render. A fresh\r\n * object, rebuilt only when something actually changed, is what makes this reactive without polling.\r\n */\r\nexport function useDevices(): AudioDevices {\r\n  const phone = useSoftphone();\r\n  const cache = useRef<{ audio: AudioDevices; view: AudioDevices } | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (cb: () => void) =>\r\n      phone.on(SoftphoneEvent.DeviceChange, () => {\r\n        cache.current = null; // invalidate; getSnapshot rebuilds on the next read\r\n        cb();\r\n      }),\r\n    [phone],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): AudioDevices => {\r\n    const audio = phone.audio;\r\n    if (cache.current?.audio === audio) return cache.current.view;\r\n    const view: AudioDevices = {\r\n      inputs: audio.inputs,\r\n      outputs: audio.outputs,\r\n      currentInputId: audio.currentInputId,\r\n      currentOutputId: audio.currentOutputId,\r\n      currentRingtoneOutputId: audio.currentRingtoneOutputId,\r\n      canSelectOutput: audio.canSelectOutput,\r\n      canSelectRingtoneOutput: audio.canSelectRingtoneOutput,\r\n      setInput: (deviceId) => audio.setInput(deviceId),\r\n      setOutput: (deviceId) => audio.setOutput(deviceId),\r\n      setRingtoneOutput: (deviceId) => audio.setRingtoneOutput(deviceId),\r\n      refresh: () => audio.refresh(),\r\n    };\r\n    cache.current = { audio, view };\r\n    return view;\r\n  }, [phone]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n"]}

package/dist/react/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as Softphone, A as AudioDevices } from '../softphone-DlGV12Xp.cjs';
-import { f as CallState, R as RemoteParty, a as Call, h as FatalSoftphoneError, P as PresenceEntry, o as SoftphoneState } from '../call-VKq1I8yP.cjs';
+import { S as Softphone, A as AudioDevices } from '../softphone-dZMkW8V1.cjs';
+import { f as CallState, R as RemoteParty, a as Call, h as FatalSoftphoneError, P as PresenceEntry, r as SoftphoneState } from '../call-CaPDWVk3.cjs';
 
 interface SoftphoneProviderProps {
     readonly softphone: Softphone;

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as Softphone, A as AudioDevices } from '../softphone-Cyq3hiIM.js';
-import { f as CallState, R as RemoteParty, a as Call, h as FatalSoftphoneError, P as PresenceEntry, o as SoftphoneState } from '../call-VKq1I8yP.js';
+import { S as Softphone, A as AudioDevices } from '../softphone-DEt0TtQw.js';
+import { f as CallState, R as RemoteParty, a as Call, h as FatalSoftphoneError, P as PresenceEntry, r as SoftphoneState } from '../call-CaPDWVk3.js';
 
 interface SoftphoneProviderProps {
     readonly softphone: Softphone;

package/dist/react/index.js

@@ -1,4 +1,4 @@
-export { SoftphoneProvider, useActiveCall, useCall, useDevices, useIsLeader, useLastError, usePresence, useSoftphone, useSoftphoneState } from '../chunk-LMJXX4YM.js';
+export { SoftphoneProvider, useActiveCall, useCall, useDevices, useIsLeader, useLastError, usePresence, useSoftphone, useSoftphoneState } from '../chunk-UHNLEBBO.js';
 import '../chunk-7R6LOOAI.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{softphone-Cyq3hiIM.d.ts → softphone-DEt0TtQw.d.ts}

@@ -1,7 +1,7 @@
-import { u as ContactsSource, v as HistorySource, g as Contact, A as AgentsDirectory, w as TransferOutcomesPage, x as PresenceSource, q as TypedEmitter, n as SoftphoneEventMap, o as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call, P as PresenceEntry } from './call-VKq1I8yP.js';
+import { x as ContactsSource, y as HistorySource, g as Contact, A as AgentsDirectory, z as TransferOutcomesPage, B as PresenceSource, m as RingtoneSource, t as TypedEmitter, q as SoftphoneEventMap, r as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call, P as PresenceEntry } from './call-CaPDWVk3.js';
 
-/** Contacts, history, caller ID, the agents directory, transfer outcomes and presence, all from one
- *  config. */
+/** Contacts, history, caller ID, the agents directory, transfer outcomes, presence and ringtone
+ *  settings, all from one config. */
 interface BackendSources {
     readonly contacts: ContactsSource;
     readonly history: HistorySource;
@@ -14,6 +14,8 @@ interface BackendSources {
     }) => Promise<TransferOutcomesPage>;
     /** Phase B (presence-gated transfer picker) — opened by `presence-socket.ts`, never by UI directly. */
     readonly presence: PresenceSource;
+    /** The caller's ringtone settings (custom-ringtone.md §4.4). Always Coventia's — no override. */
+    readonly ringtones: RingtoneSource;
 }
 
 /**
@@ -25,12 +27,20 @@ interface AudioDevices {
     readonly inputs: readonly MediaDeviceInfo[];
     readonly outputs: readonly MediaDeviceInfo[];
     /**
-     * The currently-selected input/output, or `null` — no explicit choice made, the browser's own
-     * default is in use. Never a stale ID: if the selected device is unplugged, its selection is
-     * cleared back to `null` rather than pointing at a device that no longer exists.
+     * The currently-selected input/output/ringtone output, or `null` — no explicit choice made, the
+     * browser's own default is in use. Never a stale ID: if the selected device is unplugged, its
+     * selection reads `null` rather than pointing at a device that no longer exists.
+     *
+     * **Choices are remembered** — in `localStorage` (`coventia-softphone:devices`), so they survive a
+     * reload. What is remembered is the user's *preference*, kept apart from these current values: an
+     * unplugged headset reads `null` here, and reads as selected again the moment it is plugged back in,
+     * without the user choosing it twice. Device ids are per browser and per site, which is exactly the
+     * scope of that storage (custom-ringtone.md §4.5). Where storage is blocked (private mode, a
+     * sandboxed iframe) choices simply last for the page, as they used to.
      */
     readonly currentInputId: string | null;
     readonly currentOutputId: string | null;
+    readonly currentRingtoneOutputId: string | null;
     /**
      * Re-enumerate. `inputs`/`outputs` already stay current on their own — a device physically
      * plugged or unplugged fires the browser's own `devicechange` and needs no help — but a
@@ -55,17 +65,23 @@ interface AudioDevices {
      */
     setOutput(deviceId: string | null): Promise<void>;
     /**
-     * The RINGTONE output, separate from the call speaker.
+     * The RINGTONE output, separate from the call speaker, or `null` for the browser's default device.
      *
      * Of every SDK surveyed only Twilio ships this, and users want it: ring on the laptop speakers so
-     * you hear it across the room, take the call in the headset.
+     * you hear it across the room, take the call in the headset. Only the inbound ring (and its preview
+     * in Ajustes) follows it; the call itself, the ringback and the short cues stay where they were.
      *
-     * **Not yet implemented** — still Phase 2 groundwork, like `NoopAudioDevices` before it. Calling it
-     * resolves without effect until a later pass wires it up.
+     * Like `setOutput`, this only records the choice and fires `SoftphoneEvent.DeviceChange` — the `/ui`
+     * layer is what routes the ring. A no-op for routing when `canSelectRingtoneOutput` is false.
      */
     setRingtoneOutput(deviceId: string | null): Promise<void>;
     /** False when the browser lacks `setSinkId` (Safari, most of Firefox) — `setOutput` is then a no-op. */
     readonly canSelectOutput: boolean;
+    /**
+     * Whether the ring can be sent to a chosen device. False on Safari (no `setSinkId` at all) — the
+     * ring then plays on the default output and a UI should not offer the picker.
+     */
+    readonly canSelectRingtoneOutput: boolean;
 }
 /**
  * The engine. Long-lived; owns registration, credentials, devices, and the provider.

package/dist/{softphone-DlGV12Xp.d.cts → softphone-dZMkW8V1.d.cts}

@@ -1,7 +1,7 @@
-import { u as ContactsSource, v as HistorySource, g as Contact, A as AgentsDirectory, w as TransferOutcomesPage, x as PresenceSource, q as TypedEmitter, n as SoftphoneEventMap, o as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call, P as PresenceEntry } from './call-VKq1I8yP.cjs';
+import { x as ContactsSource, y as HistorySource, g as Contact, A as AgentsDirectory, z as TransferOutcomesPage, B as PresenceSource, m as RingtoneSource, t as TypedEmitter, q as SoftphoneEventMap, r as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call, P as PresenceEntry } from './call-CaPDWVk3.cjs';
 
-/** Contacts, history, caller ID, the agents directory, transfer outcomes and presence, all from one
- *  config. */
+/** Contacts, history, caller ID, the agents directory, transfer outcomes, presence and ringtone
+ *  settings, all from one config. */
 interface BackendSources {
     readonly contacts: ContactsSource;
     readonly history: HistorySource;
@@ -14,6 +14,8 @@ interface BackendSources {
     }) => Promise<TransferOutcomesPage>;
     /** Phase B (presence-gated transfer picker) — opened by `presence-socket.ts`, never by UI directly. */
     readonly presence: PresenceSource;
+    /** The caller's ringtone settings (custom-ringtone.md §4.4). Always Coventia's — no override. */
+    readonly ringtones: RingtoneSource;
 }
 
 /**
@@ -25,12 +27,20 @@ interface AudioDevices {
     readonly inputs: readonly MediaDeviceInfo[];
     readonly outputs: readonly MediaDeviceInfo[];
     /**
-     * The currently-selected input/output, or `null` — no explicit choice made, the browser's own
-     * default is in use. Never a stale ID: if the selected device is unplugged, its selection is
-     * cleared back to `null` rather than pointing at a device that no longer exists.
+     * The currently-selected input/output/ringtone output, or `null` — no explicit choice made, the
+     * browser's own default is in use. Never a stale ID: if the selected device is unplugged, its
+     * selection reads `null` rather than pointing at a device that no longer exists.
+     *
+     * **Choices are remembered** — in `localStorage` (`coventia-softphone:devices`), so they survive a
+     * reload. What is remembered is the user's *preference*, kept apart from these current values: an
+     * unplugged headset reads `null` here, and reads as selected again the moment it is plugged back in,
+     * without the user choosing it twice. Device ids are per browser and per site, which is exactly the
+     * scope of that storage (custom-ringtone.md §4.5). Where storage is blocked (private mode, a
+     * sandboxed iframe) choices simply last for the page, as they used to.
      */
     readonly currentInputId: string | null;
     readonly currentOutputId: string | null;
+    readonly currentRingtoneOutputId: string | null;
     /**
      * Re-enumerate. `inputs`/`outputs` already stay current on their own — a device physically
      * plugged or unplugged fires the browser's own `devicechange` and needs no help — but a
@@ -55,17 +65,23 @@ interface AudioDevices {
      */
     setOutput(deviceId: string | null): Promise<void>;
     /**
-     * The RINGTONE output, separate from the call speaker.
+     * The RINGTONE output, separate from the call speaker, or `null` for the browser's default device.
      *
      * Of every SDK surveyed only Twilio ships this, and users want it: ring on the laptop speakers so
-     * you hear it across the room, take the call in the headset.
+     * you hear it across the room, take the call in the headset. Only the inbound ring (and its preview
+     * in Ajustes) follows it; the call itself, the ringback and the short cues stay where they were.
      *
-     * **Not yet implemented** — still Phase 2 groundwork, like `NoopAudioDevices` before it. Calling it
-     * resolves without effect until a later pass wires it up.
+     * Like `setOutput`, this only records the choice and fires `SoftphoneEvent.DeviceChange` — the `/ui`
+     * layer is what routes the ring. A no-op for routing when `canSelectRingtoneOutput` is false.
      */
     setRingtoneOutput(deviceId: string | null): Promise<void>;
     /** False when the browser lacks `setSinkId` (Safari, most of Firefox) — `setOutput` is then a no-op. */
     readonly canSelectOutput: boolean;
+    /**
+     * Whether the ring can be sent to a chosen device. False on Safari (no `setSinkId` at all) — the
+     * ring then plays on the default output and a UI should not offer the picker.
+     */
+    readonly canSelectRingtoneOutput: boolean;
 }
 /**
  * The engine. Long-lived; owns registration, credentials, devices, and the provider.

package/dist/softphone.css

@@ -1952,6 +1952,116 @@
 }
 .cv-settings-select:focus { outline: none; border-color: var(--cv-accent); background: var(--cv-bg); }
 .cv-settings-empty { font-size: 0.85rem; color: var(--cv-muted); }
+
+/* `--cv-danger-strong` is the AS-TEXT danger token (see its definition): red-600 on the light `--cv-bg`,
+   red-400 on the dark one. */
+.cv-settings-error { margin: 0.6rem 0.2rem 0; font-size: 0.78rem; line-height: 1.4; color: var(--cv-danger-strong); }
+
+/*
+  Ajustes as a list (custom-ringtone.md §4.6, revised 2026-10-14): each row names a setting, shows its CURRENT
+  value under the name, and opens a page. Same icon circle and dividers as the device rows above (they live in
+  the same `.cv-settings-section-body`, which supplies the padding and the dividers), same chevron as
+  `.cv-detail-row--action` — one row vocabulary across the widget.
+*/
+.cv-settings-nav {
+  display: flex;
+  align-items: center;
+  gap: 0.7rem;
+  width: 100%;
+  border: none;
+  background: none;
+  font: inherit;
+  color: inherit;
+  text-align: left;
+}
+button.cv-settings-nav { cursor: pointer; transition: background 0.12s ease; }
+button.cv-settings-nav:hover { background: var(--cv-surface); }
+button.cv-settings-nav:focus-visible { outline: 2px solid var(--cv-accent); outline-offset: -2px; }
+.cv-settings-nav-text { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 0.1rem; }
+.cv-settings-nav-title { font-size: 0.88rem; font-weight: 600; color: var(--cv-text); }
+/* One line, cut with an ellipsis — the full device name is on its page. `--cv-muted` on `--cv-bg` is the
+   pairing already verified for `.cv-settings-note`. The static row (a note, no page) may wrap instead. */
+.cv-settings-nav-value {
+  font-size: 0.8rem;
+  color: var(--cv-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.cv-settings-nav--static .cv-settings-nav-value { white-space: normal; line-height: 1.45; }
+.cv-settings-nav-chevron { flex-shrink: 0; color: var(--cv-muted); }
+
+/* A settings page: the `.cv-detail` overlay (entrance, back button, reduced motion all inherited) with a
+   scrolling body of its own. */
+.cv-settings-page-body { flex: 1; min-height: 0; overflow-y: auto; padding: 0.25rem 1rem 1rem; }
+.cv-settings-page-title {
+  margin: 0.15rem 0.2rem 0.35rem;
+  font-size: 1.05rem;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  color: var(--cv-text);
+}
+/* Focus lands here on open (for keyboard and screen-reader users); a ring on a heading would only look
+   like a stray box to everyone else. */
+.cv-settings-page-title:focus { outline: none; }
+.cv-settings-page-intro { margin: 0 0.2rem 0.85rem; font-size: 0.8rem; line-height: 1.45; color: var(--cv-muted); }
+.cv-settings-page-empty { margin: 0; padding: 0 0.2rem; font-size: 0.85rem; color: var(--cv-muted); }
+
+/* The checkmark list: one card like `.cv-settings-section-body`, a row per choice. */
+.cv-choices {
+  border: 1px solid var(--cv-border);
+  border-radius: 14px;
+  background: var(--cv-bg);
+  overflow: hidden;
+}
+.cv-choice {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  min-height: 44px;
+  padding: 0.6rem 0.85rem;
+  cursor: pointer;
+  transition: background 0.12s ease;
+}
+.cv-choice + .cv-choice { border-top: 1px solid var(--cv-border); }
+.cv-choice:hover { background: var(--cv-surface); }
+/* The real control: a native radio, kept in the accessibility tree and keyboard order, drawn by the row. */
+.cv-choice-input {
+  position: absolute;
+  opacity: 0;
+  width: 1px;
+  height: 1px;
+  margin: 0;
+  pointer-events: none;
+}
+.cv-choice:has(.cv-choice-input:focus-visible) { outline: 2px solid var(--cv-accent); outline-offset: -2px; }
+.cv-choice-text { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 0.1rem; }
+.cv-choice-label { font-size: 0.88rem; color: var(--cv-text); overflow-wrap: anywhere; }
+.cv-choice-sub { font-size: 0.78rem; color: var(--cv-muted); }
+.cv-choice[data-checked] .cv-choice-label { font-weight: 600; }
+.cv-choice-check { flex-shrink: 0; color: var(--cv-accent-strong); visibility: hidden; }
+.cv-choice[data-checked] .cv-choice-check { visibility: visible; }
+.cv-choice-playing { display: inline-flex; flex-shrink: 0; color: var(--cv-accent-strong); }
+
+.cv-settings-test,
+.cv-settings-retry {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+.cv-settings-test { margin-top: 0.85rem; }
+.cv-settings-retry { margin-top: 0.6rem; }
+
+/* Visually hidden, still read aloud. */
+.cv-sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
 /* `--cv-muted` on `--cv-bg` — 4.83:1 light / 6.97:1 dark, computed fresh for THIS pairing (the note
    used to sit on `--cv-surface` with its own card; now it sits directly on the section's `--cv-bg`,
    a different background that earns its own check rather than inheriting the old one's number). */
@@ -1961,18 +2071,6 @@
   font-size: 0.8rem;
   line-height: 1.5;
 }
-/* Closing note for the tab as a whole, not any one section — sits directly on `.cv-settings-body`,
-   which shares the same `--cv-bg` as `.cv-settings-section-body` above, so the `--cv-muted`-on-
-   `--cv-bg` pairing already verified for `.cv-settings-note` carries over unchanged. Centred and
-   quieter than a row: this is a footnote about the tab, not a row's worth of content. */
-.cv-settings-more {
-  margin: 0;
-  padding: 0 0.5rem;
-  text-align: center;
-  color: var(--cv-muted);
-  font-size: 0.78rem;
-  line-height: 1.5;
-}
 
 /* ── Centred states (mic gate) ───────────────────────────────────────────────── */
 .cv-center {

package/dist/{sources-IRKNQPWW.js → sources-M3GYMS6V.js}

@@ -309,6 +309,56 @@ function coventiaSources(config) {
       })();
     });
   };
+  const fileBase = config.baseUrl.replace(/\/+$/, "");
+  const toLoop = (l) => l && Number.isFinite(l.start) && Number.isFinite(l.end) && l.start >= 0 && l.end > l.start ? { start: l.start, end: l.end } : null;
+  const toRingtoneSettings = (body) => {
+    const catalogue = (body.catalogue ?? []).map((r) => ({
+      id: r.id,
+      name: r.name,
+      url: r.path ? `${fileBase}${r.path}` : null,
+      loop: r.path ? toLoop(r.loop) : null
+    }));
+    const builtIn = catalogue.find((r) => r.url === null)?.id ?? "clasico";
+    const effective = catalogue.some((r) => r.id === body.effective) ? body.effective : builtIn;
+    return { catalogue, orgDefault: body.orgDefault ?? null, mine: body.user ?? null, effective };
+  };
+  const CACHE_PREFIX = "coventia-softphone:ringtones:";
+  const cacheKey = async () => {
+    try {
+      const { identity } = await config.tokenSource.getToken();
+      return `${CACHE_PREFIX}${fileBase}|${config.organizationId ?? "-"}|${identity}`;
+    } catch {
+      return null;
+    }
+  };
+  const remember = async (settings) => {
+    const key = await cacheKey();
+    try {
+      if (key) globalThis.localStorage?.setItem(key, JSON.stringify(settings));
+    } catch {
+    }
+    return settings;
+  };
+  const recall = async () => {
+    const key = await cacheKey();
+    try {
+      const raw = key ? globalThis.localStorage?.getItem(key) : null;
+      const s = raw ? JSON.parse(raw) : null;
+      const ok = s && Array.isArray(s.catalogue) && s.catalogue.every((r) => typeof r?.id === "string" && typeof r.name === "string" && (r.url === null || typeof r.url === "string")) && s.catalogue.some((r) => r.id === s.effective);
+      return ok ? { ...s, catalogue: s.catalogue.map((r) => ({ ...r, loop: toLoop(r.loop) })) } : null;
+    } catch {
+      return null;
+    }
+  };
+  const ringtones = {
+    get: async (signal) => remember(toRingtoneSettings(await get(`${base}/ringtones`, org, signal))),
+    // `null` clears: the empty id is dropped from the query by the request helper, and the backend reads a
+    // missing `ringtone_id` as "clear".
+    setMine: async (id) => remember(
+      toRingtoneSettings(await post(`${base}/ringtones/user`, { ...org, ringtone_id: id ?? "" }))
+    ),
+    cached: recall
+  };
   const contacts = config.contacts ?? coventiaContacts;
   const resolve = config.resolveContact ?? (config.contacts ? resolverFromContacts(config.contacts) : coventiaResolve);
   const history = withNameResolution(rawHistory, resolve);
@@ -320,10 +370,11 @@ function coventiaSources(config) {
     resolveContact: resolve,
     listAgents: coventiaListAgents,
     transferOutcomes,
-    presence
+    presence,
+    ringtones
   };
 }
 
 export { coventiaSources, resolverFromContacts };
-//# sourceMappingURL=sources-IRKNQPWW.js.map
-//# sourceMappingURL=sources-IRKNQPWW.js.map
+//# sourceMappingURL=sources-M3GYMS6V.js.map
+//# sourceMappingURL=sources-M3GYMS6V.js.map

package/dist/sources-M3GYMS6V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sources.ts","../src/coventia/api.ts","../src/coventia/sources.ts"],"names":["resolve"],"mappings":"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","file":"sources-M3GYMS6V.js","sourcesContent":["/**\r\n * **Internal.** Not exported from any entry point.\r\n *\r\n * The rules that are about **phone numbers and names** rather than about any backend: universal,\r\n * easy to get subtly wrong, and worth getting right once.\r\n *\r\n * These were public while a host had to build their own sources. They no longer do — a provider\r\n * supplies `coventia.contacts` and everything else (caller ID, history names) is derived from it in\r\n * `coventia/sources.ts`, the only caller left. Exported API is a contract owed forever, so it should\r\n * not outlive its consumers.\r\n */\r\nimport type { Contact } from './core/types.js';\r\nimport type { CallHistoryEntry, HistorySource } from './ui/types.js';\r\n\r\n/**\r\n * A number reduced to the digits telephony actually matches on — `'+34 600 111 222'` → `'34600111222'`.\r\n *\r\n * Comparing numbers as raw strings is the bug this exists to prevent: the same line arrives as\r\n * `+34600111222` from a SIP header, `34600111222` from a database, and `+34 600 111 222` from a human,\r\n * and all three are one contact.\r\n */\r\nexport function toDigits(number: string): string {\r\n  return String(number ?? '').replace(/\\D/g, '');\r\n}\r\n\r\n/**\r\n * Decide whether a resolved string is really a **name** — the \"don't echo the bare number\" rule.\r\n *\r\n * A contact saved as its own number (\"+34 600 111 222\") resolves to a \"name\" that is just the number\r\n * reformatted. Showing it puts `+34600111222` where a name belongs, or worse, a *differently*\r\n * formatted copy of the number the widget is already displaying an inch away.\r\n *\r\n * This is the SDK deciding what it is willing to call a name, so it holds for every host — not only\r\n * for a backend that happens to be careful. Returns `null` when there is no name worth showing, which\r\n * is the signal to keep displaying the number.\r\n */\r\nexport function normalizeResolvedName(raw: string | null | undefined, number: string): string | null {\r\n  if (!raw) return null;\r\n  const trimmed = String(raw).trim();\r\n  if (!trimmed) return null;\r\n  const digits = toDigits(number);\r\n  if (!digits) return trimmed;\r\n  return toDigits(trimmed) === digits ? null : trimmed;\r\n}\r\n\r\n/**\r\n * Wrap a `HistorySource` so its entries get caller names, resolved once per distinct number.\r\n *\r\n * A call log is the same handful of numbers over and over, so the naive \"resolve each row\" costs a\r\n * request per row and hammers the backend with duplicates. This dedupes **by digits** (see\r\n * `toDigits` — `+34600111222` and `34600111222` are one lookup), caches across pages, and remembers\r\n * misses so an unknown number is not re-asked forever.\r\n *\r\n * A failed lookup leaves the entry's `name` null and is NOT cached, so a later page retries: the\r\n * number is still callable, and an unreachable name service must not empty the tab.\r\n *\r\n *   const history = withNameResolution(myHistorySource, myResolveContact);\r\n */\r\nexport function withNameResolution(\r\n  source: HistorySource,\r\n  resolve: (number: string, signal?: AbortSignal) => Promise<Contact | null>,\r\n): HistorySource {\r\n  const cache = new Map<string, string | null>();\r\n\r\n  return async (params) => {\r\n    const entries = await source(params);\r\n\r\n    // Only entries that still NEED a name. A source that already knows one (its own join, its own\r\n    // cache) must not cost a lookup — the numbers it named are not our business.\r\n    const wanted = [\r\n      ...new Set(entries.filter((e) => e.name === null).map((e) => toDigits(e.number))),\r\n    ].filter((d) => d !== '' && !cache.has(d));\r\n    await Promise.all(\r\n      wanted.map(async (digits) => {\r\n        try {\r\n          const contact = await resolve(digits);\r\n          cache.set(digits, normalizeResolvedName(contact?.name ?? null, digits));\r\n        } catch {\r\n          // Deliberately not cached — a transient failure must not become a permanent blank.\r\n        }\r\n      }),\r\n    );\r\n\r\n    return entries.map((e): CallHistoryEntry => {\r\n      // Never overwrite a name the source already knew.\r\n      if (e.name !== null) return e;\r\n      const resolved = cache.get(toDigits(e.number)) ?? null;\r\n      return resolved === null ? e : { ...e, name: resolved };\r\n    });\r\n  };\r\n}\r\n","import { invalidateToken } from '../core/token-cache.js';\r\nimport type { TokenSource } from '../core/types.js';\r\n\r\n/** A failed backend call. `status` is the HTTP status, or 0 when the request never completed. */\r\nexport class ApiError extends Error {\r\n  readonly status: number;\r\n\r\n  constructor(status: number, message: string) {\r\n    super(message);\r\n    this.name = 'ApiError';\r\n    this.status = status;\r\n  }\r\n}\r\n\r\nexport type QueryParams = Readonly<Record<string, string | number | undefined>>;\r\n\r\n/**\r\n * A minimal authenticated GET against Coventia's phone service.\r\n *\r\n * Lives under `coventia/` rather than `core/`: the core ships no HTTP at all, so a partner on their\r\n * own backend never loads this.\r\n */\r\ninterface RequestConfig {\r\n  readonly baseUrl: string;\r\n  readonly tokenSource: TokenSource;\r\n  readonly fetch?: typeof globalThis.fetch;\r\n}\r\n\r\n/**\r\n * Shared by `createGet` and `createPost`: one attempt against the backend, with the 401-retry-once\r\n * policy both need (see `createGet`'s own note on why). `method` is the only thing that differs\r\n * between the two — this backend's phone routes take every parameter as a query string, GET or POST\r\n * alike (the presence ticket mint is a POST with no body, `organization_id` on the query, same as any\r\n * GET here), so there is nothing else for a request body to carry.\r\n */\r\nfunction createRequest(config: RequestConfig, method: 'GET' | 'POST') {\r\n  // Bound, not passed by reference: an unbound `fetch` throws \"Illegal invocation\" in some browsers.\r\n  const doFetch: typeof globalThis.fetch = config.fetch\r\n    ? config.fetch\r\n    : (...args) => globalThis.fetch(...args);\r\n  const base = config.baseUrl.replace(/\\/+$/, '');\r\n\r\n  /**\r\n   * One attempt. Split out so a 401 can be retried exactly once with a fresh token — see the\r\n   * returned function's own note.\r\n   */\r\n  async function attempt<T>(path: string, params: QueryParams, signal?: AbortSignal): Promise<T> {\r\n    const { token } = await config.tokenSource.getToken(signal);\r\n    const qs = new URLSearchParams();\r\n    for (const [k, v] of Object.entries(params)) {\r\n      if (v !== undefined && v !== '') qs.set(k, String(v));\r\n    }\r\n    const query = qs.toString();\r\n\r\n    const res = await doFetch(`${base}${path}${query ? `?${query}` : ''}`, {\r\n      method,\r\n      // The RAW token, no `Bearer ` prefix — see `VoiceToken.token` (SPEC §6.1).\r\n      headers: { Authorization: token },\r\n      ...(signal ? { signal } : {}),\r\n    });\r\n\r\n    const body: unknown = await res.json().catch(() => null);\r\n    const message = (body as { message?: string } | null)?.message ?? `${path} — HTTP ${res.status}`;\r\n\r\n    if (!res.ok) throw new ApiError(res.status, message);\r\n    // This backend answers 200 with `{ success: false }` on handled failures, so the status alone is\r\n    // not enough to know a call worked.\r\n    if ((body as { success?: boolean } | null)?.success === false) {\r\n      throw new ApiError(res.status, message);\r\n    }\r\n    return body as T;\r\n  }\r\n\r\n  /**\r\n   * Retry once on 401, with a freshly minted token.\r\n   *\r\n   * A cached token can be rejected before its nominal expiry — revoked on logout, or invalidated when\r\n   * the extension is re-provisioned. Without this the cache would keep handing back the dead one for\r\n   * up to its full TTL, so `revokeVoiceTokensForUser` would not actually stop a running softphone.\r\n   *\r\n   * Exactly one retry: a second 401 means the credential itself is refused, not stale, and retrying\r\n   * would be a loop against the host's token endpoint.\r\n   */\r\n  return async function request<T>(path: string, params: QueryParams = {}, signal?: AbortSignal): Promise<T> {\r\n    try {\r\n      return await attempt<T>(path, params, signal);\r\n    } catch (error) {\r\n      if (!(error instanceof ApiError) || error.status !== 401) throw error;\r\n      invalidateToken(config.tokenSource);\r\n      return attempt<T>(path, params, signal);\r\n    }\r\n  };\r\n}\r\n\r\n/**\r\n * A minimal authenticated GET against Coventia's phone service.\r\n *\r\n * Lives under `coventia/` rather than `core/`: the core ships no HTTP at all, so a partner on their\r\n * own backend never loads this.\r\n */\r\nexport function createGet(config: RequestConfig) {\r\n  return createRequest(config, 'GET');\r\n}\r\n\r\n/** The POST counterpart — today, only the presence ticket mint (`POST /presence/ticket`) uses it. */\r\nexport function createPost(config: RequestConfig) {\r\n  return createRequest(config, 'POST');\r\n}\r\n","import { normalizeResolvedName, toDigits, withNameResolution } from '../sources.js';\r\nimport { createGet, createPost } from './api.js';\r\nimport type {\r\n  Contact,\r\n  PresenceCallbacks,\r\n  PresenceConnection,\r\n  PresenceEntry,\r\n  PresenceSource,\r\n  PresenceState,\r\n  RingtoneSettings,\r\n  RingtoneSource,\r\n  TokenSource,\r\n  TransferOutcomeEntry,\r\n  TransferOutcomesPage,\r\n  TransferOutcomeSource,\r\n} from '../core/types.js';\r\nimport type {\r\n  AgentsDirectory,\r\n  CallDetail,\r\n  CallHandler,\r\n  CallHistoryEntry,\r\n  CallOutcome,\r\n  ContactsPage,\r\n  ContactsSource,\r\n  HistorySource,\r\n} from '../ui/types.js';\r\n\r\nexport interface CoventiaSourcesConfig {\r\n  /** Coventia backend base URL, e.g. `https://api.coventia.es`. */\r\n  readonly baseUrl: string;\r\n  readonly tokenSource: TokenSource;\r\n  /**\r\n   * Only for session-authenticated hosts. A voice token carries the organization in its claim and\r\n   * the backend pins it from there, so a partner omits this and cannot point the SDK at a tenant\r\n   * their token does not cover. See `CoventiaBackendConfig.organizationId`.\r\n   */\r\n  readonly organizationId?: string;\r\n  /**\r\n   * Where the phone routes live. `/phone` today; `/api/v1/phone` once the partner API ships (§6.6),\r\n   * at which point only this string changes.\r\n   */\r\n  readonly basePath?: string;\r\n  /**\r\n   * **The one thing a provider implements.** Their contact list, searched on their own backend.\r\n   *\r\n   * Supplying this is enough for everything: it drives the Contactos tab, and caller ID is DERIVED\r\n   * from it by searching for the incoming number (see `resolverFromContacts`). One source means the\r\n   * Contactos tab, a live call and a history row can never disagree about who a number belongs to —\r\n   * which they did when the list and the lookup were separate overrides.\r\n   *\r\n   * The matching happens on their backend, where the CRM is: we send the number as `search` and take\r\n   * an exact digit match from the results.\r\n   */\r\n  readonly contacts?: ContactsSource;\r\n\r\n  /**\r\n   * Caller ID, only if searching the list is not how their CRM answers \"who is this number\".\r\n   *\r\n   * Rarely needed — `contacts` already derives it. Worth setting when a dedicated lookup is cheaper\r\n   * than a search, or when the number lives on a record that search does not return.\r\n   */\r\n  readonly resolveContact?: (number: string) => Promise<Contact | null>;\r\n  /** Overrides polling `/transfers/outcomes` — see `CoventiaBackendConfig.transferOutcomes`. */\r\n  readonly transferOutcomes?: TransferOutcomeSource;\r\n  /** Overrides the presence WebSocket — see `CoventiaBackendConfig.presence`. */\r\n  readonly presence?: PresenceSource;\r\n  readonly fetch?: typeof globalThis.fetch;\r\n  /** Overridable for tests — a fake `WebSocket` constructor. Defaults to `globalThis.WebSocket`. */\r\n  readonly WebSocket?: typeof globalThis.WebSocket;\r\n}\r\n\r\nexport interface CoventiaSources {\r\n  /** The Contactos tab. A partner may replace this with their own; everything else cannot be. */\r\n  readonly contacts: ContactsSource;\r\n  /** The Historial tab. **Coventia's, always** — we store the calls and the recordings. */\r\n  readonly history: HistorySource;\r\n  /** Caller ID for an incoming number, for `SoftphoneConfig.resolveContact`. */\r\n  readonly resolveContact: (number: string) => Promise<Contact | null>;\r\n  /** The Historial tab's \"filter by person\" directory. Always Coventia's own org membership. */\r\n  readonly listAgents: () => Promise<AgentsDirectory>;\r\n  /** Phase A (transfer outcome relay) — polled by the transfer watch, never by UI directly. */\r\n  readonly transferOutcomes: TransferOutcomeSource;\r\n  /** Phase B (presence-gated transfer picker) — opened by `presence-socket.ts`, never by UI directly. */\r\n  readonly presence: PresenceSource;\r\n  /** The caller's ringtone settings (custom-ringtone.md §4.3–4.4). */\r\n  readonly ringtones: RingtoneSource;\r\n}\r\n\r\n/** What every `/ringtones` route returns (backend `routes/ringtones.js`). */\r\ninterface RingtonesResponse {\r\n  readonly catalogue?: ReadonlyArray<{\r\n    readonly id: string;\r\n    readonly name: string;\r\n    readonly path: string | null;\r\n    readonly loop?: { readonly start: number; readonly end: number } | null;\r\n  }>;\r\n  readonly orgDefault?: string | null;\r\n  readonly user?: string | null;\r\n  readonly effective?: string;\r\n}\r\n\r\n/** What `/agents` returns. */\r\ninterface AgentRow {\r\n  readonly user_id: string;\r\n  readonly name: string | null;\r\n}\r\n\r\n/** What `/webrtc/contacts` returns. **The only place `wa_id` is named in the whole SDK.** */\r\ninterface WhatsAppContactRow {\r\n  readonly wa_id: string;\r\n  readonly name: string | null;\r\n}\r\n\r\n/**\r\n * `wa_id` → `Contact`.\r\n *\r\n * `id` IS the `wa_id`, and that leaks nothing: the backend serves callable contacts only\r\n * (`wa_id: /^[0-9]+$/`), so the value is literally the phone digits and carries nothing `phone` does\r\n * not. What the boundary removes is the SHAPE — no `custom_username`/`username` coalescing, no\r\n * WhatsApp field names past this function.\r\n */\r\nconst toContact = (row: WhatsAppContactRow): Contact => ({\r\n  id: row.wa_id,\r\n  name: row.name,\r\n  phone: `+${row.wa_id}`,\r\n});\r\n\r\n/** One hop in `handled_by_chain`, as Mongo stores it — no `name` (see `HandledByChainRow`'s own note). */\r\ninterface HandledByChainRow {\r\n  readonly ext?: string;\r\n  readonly user_id?: string | null;\r\n}\r\n\r\n/** The same hop, enriched by `GET /calls/:id` with a resolved display name. */\r\ninterface EnrichedHandledByChainRow extends HandledByChainRow {\r\n  readonly name?: string | null;\r\n}\r\n\r\n/** A row from `/calls`. The backend spreads raw Mongo docs, so every read below is defensive. */\r\ninterface CallRow {\r\n  readonly _id?: string;\r\n  /** The PBX's vocabulary: `incoming` | `outgoing`. NOT the SDK's `inbound`/`outbound`. */\r\n  readonly direction?: string;\r\n  readonly caller_id?: string;\r\n  readonly called_did?: string;\r\n  readonly destination?: string;\r\n  readonly disposition?: string;\r\n  readonly duration?: number;\r\n  readonly created_at?: string | number;\r\n  readonly recording_count?: number;\r\n  readonly handled_by_chain?: readonly HandledByChainRow[];\r\n  /** The transfer route as bare extensions — populated even when `handled_by_chain` isn't (older\r\n   *  docs, written before the chain existed). */\r\n  readonly extensions?: readonly string[];\r\n  readonly internal?: string;\r\n  readonly last_internal?: string;\r\n}\r\n\r\nconst toDirection = (raw: string | undefined): 'inbound' | 'outbound' =>\r\n  raw === 'outgoing' ? 'outbound' : 'inbound';\r\n\r\n/** Which field holds the other party depends on the direction. */\r\nconst otherParty = (row: CallRow): string =>\r\n  toDirection(row.direction) === 'outbound'\r\n    ? (row.called_did ?? row.destination ?? '')\r\n    : (row.caller_id ?? '');\r\n\r\n/**\r\n * Who handled the call, in order. Prefers the real chain (`ext` + resolved `user_id`); falls back to\r\n * bare extensions ONLY when there is no chain at all — a doc written before `handled_by_chain` existed.\r\n * Unifies both shapes into one `CallHandler[]` so the UI never has to know which source it came from:\r\n * a bare extension is just a handler with `userId: null, name: null`.\r\n */\r\nfunction toHandledBy(row: CallRow, chain: readonly EnrichedHandledByChainRow[] = row.handled_by_chain ?? []): readonly CallHandler[] {\r\n  if (chain.length > 0) {\r\n    return chain\r\n      .filter((h): h is EnrichedHandledByChainRow & { ext: string } => Boolean(h?.ext))\r\n      .map((h) => ({ extension: h.ext, userId: h.user_id ?? null, name: h.name ?? null }));\r\n  }\r\n  const bare = row.extensions?.length ? row.extensions : [row.internal, row.last_internal];\r\n  return [...new Set(bare.filter((e): e is string => Boolean(e)))].map((extension) => ({\r\n    extension,\r\n    userId: null,\r\n    name: null,\r\n  }));\r\n}\r\n\r\n/**\r\n * \"Not answered\" is ANY non-empty disposition other than `answered` — `no answer`, `busy`, `cancel`,\r\n * `failed`, `congestion`, and whatever Zadarma adds next.\r\n *\r\n * Open-ended rather than an allow-list, so an unrecognised value surfaces under \"Perdidas\" instead of\r\n * vanishing. **An EMPTY disposition counts as ANSWERED**, so a call of unknown status is not wrongly\r\n * flagged. Both halves are load-bearing.\r\n */\r\nconst isMissed = (row: CallRow): boolean => {\r\n  const d = String(row.disposition ?? '').trim().toLowerCase();\r\n  return d !== '' && d !== 'answered';\r\n};\r\n\r\n/**\r\n * The PBX's own vocabulary translated to the SDK's, for a call `isMissed`. Never returns Zadarma's\r\n * raw string — an unrecognised or future value falls into `'unavailable'` rather than leaking through\r\n * or being dropped, same open-ended reasoning `isMissed` itself documents.\r\n */\r\nconst toOutcome = (row: CallRow): CallOutcome => {\r\n  switch (String(row.disposition ?? '').trim().toLowerCase()) {\r\n    case 'no answer':\r\n      return 'no-answer';\r\n    case 'busy':\r\n      return 'busy';\r\n    case 'cancel':\r\n      return 'cancelled';\r\n    case 'failed':\r\n      return 'failed';\r\n    default:\r\n      return 'unavailable';\r\n  }\r\n};\r\n\r\n/**\r\n * Caller ID, derived from a contacts source: ask it for the number and take an exact match.\r\n *\r\n * This is why a provider only has to implement ONE function. Their search endpoint already knows how\r\n * to match a phone number — it is the same question the Contactos tab asks, with a different query —\r\n * and doing it on their backend is where the CRM actually lives.\r\n *\r\n * **Exact digit match only.** A search for a number can return partial or fuzzy hits, and naming a\r\n * caller after a near-miss is worse than showing the bare number: the user trusts the name.\r\n * `toDigits` on both sides so `+34 600 111 222` and `34600111222` compare equal.\r\n */\r\nexport function resolverFromContacts(\r\n  contacts: ContactsSource,\r\n): (number: string) => Promise<Contact | null> {\r\n  return async (number) => {\r\n    const digits = toDigits(number);\r\n    if (!digits) return null;\r\n    // The number as the PBX reported it — their backend has the most to work with that way. `limit`\r\n    // is small: we want one exact hit, not a page of near misses.\r\n    const page = await contacts({ search: number, skip: 0, limit: 10 });\r\n    return page.items.find((c) => toDigits(c.phone) === digits) ?? null;\r\n  };\r\n}\r\n\r\nconst toDate = (raw: string | number | undefined): Date => {\r\n  if (raw === undefined) return new Date(0);\r\n  const d = new Date(raw);\r\n  return Number.isNaN(d.getTime()) ? new Date(0) : d;\r\n};\r\n\r\n/** What `GET /transfers/outcomes` returns per entry — `transferOutcomeStore.js`'s own wire shape. */\r\ninterface TransferOutcomeRow {\r\n  readonly id?: string;\r\n  readonly target?: string;\r\n  /** The backend's wire value; `'connected'` or anything else (`'not_connected'`) maps below. */\r\n  readonly status?: string;\r\n  readonly at?: string;\r\n}\r\n\r\n/** `not_connected` → `'not-connected'` (spec §4 D2's kebab-case, matching `HangupReason`) — the ONE\r\n *  place that translation happens; open-ended rather than an allow-list, so an unrecognised status\r\n *  fails safe as `'not-connected'` (the agent gets told, never silently nothing) rather than throwing. */\r\nconst toTransferOutcome = (row: TransferOutcomeRow): TransferOutcomeEntry => ({\r\n  id: row.id ?? '',\r\n  target: row.target ?? '',\r\n  status: row.status === 'connected' ? 'connected' : 'not-connected',\r\n  at: toDate(row.at),\r\n});\r\n\r\n/** What the presence WebSocket's `snapshot`/`delta` messages carry per agent — `presenceSocket.js`'s\r\n *  own wire shape (`docs/specs/transfer-presence-picker.md` §4.3, plan §2). */\r\ninterface PresenceAgentRow {\r\n  readonly userId?: string;\r\n  readonly extension?: string;\r\n  readonly name?: string | null;\r\n  readonly state?: string;\r\n}\r\n\r\n/** Open-ended rather than an allow-list, matching `toTransferOutcome`'s own reasoning for an\r\n *  unrecognised value: fails safe as `'desconectado'` (never wrongly reachable) rather than throwing. */\r\nconst toPresenceState = (raw: string | undefined): PresenceState =>\r\n  raw === 'disponible' || raw === 'en_llamada' ? raw : 'desconectado';\r\n\r\nconst toPresenceEntry = (row: PresenceAgentRow): PresenceEntry => ({\r\n  userId: row.userId ?? '',\r\n  extension: row.extension ?? '',\r\n  name: row.name ?? null,\r\n  state: toPresenceState(row.state),\r\n});\r\n\r\n/** `POST /presence/ticket`'s response (`presenceTicketStore.js`'s own wire shape). */\r\ninterface PresenceTicketResponse {\r\n  readonly success?: boolean;\r\n  readonly ticket?: string;\r\n  readonly expires_in?: number;\r\n}\r\n\r\n/** `https://api.coventia.es` → `wss://api.coventia.es`; `http://` → `ws://`. Scheme swapped, and any\r\n *  trailing slash trimmed — same normalisation `createGet`/`createPost` apply to `baseUrl` internally,\r\n *  needed again here since this function works from the raw config value, not their trimmed copy. */\r\nconst toWebSocketUrl = (httpUrl: string): string => httpUrl.replace(/^http/, 'ws').replace(/\\/+$/, '');\r\n\r\n/**\r\n * Coventia's phone service, as the sources the widget asks for.\r\n *\r\n * **This is the anti-corruption layer.** The backend speaks WhatsApp's data model; the SDK speaks\r\n * `Contact` and `CallHistoryEntry`. The translation happens here and nowhere else — enforced by\r\n * structure, since `core/` cannot reach `coventia/` and a partner never imports it.\r\n */\r\nexport function coventiaSources(config: CoventiaSourcesConfig): CoventiaSources {\r\n  const get = createGet(config);\r\n  const post = createPost(config);\r\n  const base = config.basePath ?? '/phone';\r\n  // Absent for a voice token, which already names the organization. Spread into every query below,\r\n  // so omitting it removes the parameter entirely rather than sending `organization_id=undefined`.\r\n  const org = config.organizationId ? { organization_id: config.organizationId } : {};\r\n\r\n  const coventiaContacts: ContactsSource = async ({ search, skip, limit }): Promise<ContactsPage> => {\r\n    const body = await get<{ contacts?: readonly WhatsAppContactRow[]; total?: number }>(\r\n      `${base}/webrtc/contacts`,\r\n      { ...org, search, skip, limit },\r\n    );\r\n    return { items: (body.contacts ?? []).map(toContact), total: body.total ?? 0 };\r\n  };\r\n\r\n  const coventiaResolve = async (number: string): Promise<Contact | null> => {\r\n    const digits = toDigits(number);\r\n    if (!digits) return null;\r\n    const body = await get<{ name?: string | null }>(`${base}/webrtc/caller-name`, {\r\n      ...org,\r\n      number: digits,\r\n    });\r\n    // Re-applied on top of the backend's own rule: a contact saved as its own number resolves to a\r\n    // \"name\" that is just the number reformatted, and showing that puts +34600111222 where a name\r\n    // belongs — next to the number the widget is already displaying.\r\n    const name = normalizeResolvedName(body.name ?? null, digits);\r\n    return name === null ? null : { id: digits, name, phone: `+${digits}` };\r\n  };\r\n\r\n  const rawHistory: HistorySource = async ({\r\n    skip,\r\n    limit,\r\n    missed,\r\n    userId,\r\n  }): Promise<readonly CallHistoryEntry[]> => {\r\n    const body = await get<{ calls?: readonly CallRow[] }>(`${base}/calls`, {\r\n      ...org,\r\n      skip,\r\n      limit,\r\n      // Omitted rather than `'false'` — the backend only special-cases `missed=true`, so leaving it\r\n      // out entirely for \"Todas\" is equivalent and one less thing for a param dump to explain.\r\n      missed: missed ? 'true' : undefined,\r\n      user_id: userId,\r\n    });\r\n    return (body.calls ?? []).map((row): CallHistoryEntry => {\r\n      const id = row._id ?? '';\r\n      const recorded = (row.recording_count ?? 0) > 0;\r\n      const missedRow = isMissed(row);\r\n      const handledBy = toHandledBy(row);\r\n      return {\r\n        id,\r\n        direction: toDirection(row.direction),\r\n        number: otherParty(row),\r\n        // Filled by `withNameResolution` at the mount — deduped by digits and cached across pages.\r\n        name: null,\r\n        at: toDate(row.created_at),\r\n        durationSec: row.duration ?? 0,\r\n        missed: missedRow,\r\n        ...(missedRow ? { outcome: toOutcome(row) } : {}),\r\n        // The DID is only ever the ORG's own number, which only an inbound call dials — an outbound\r\n        // row's `called_did` is the OTHER party (already `number` above); showing it again as \"DID\"\r\n        // would just repeat the row under a wrong label.\r\n        ...(toDirection(row.direction) === 'inbound' && row.called_did ? { did: row.called_did } : {}),\r\n        recorded,\r\n        handledBy,\r\n        // The detail page's one enrichment fetch — signed recording URLs, plus this SAME chain with\r\n        // names resolved. Skipped when there is nothing to enrich: minting signed URLs and resolving\r\n        // names for a page of 30 calls nobody opens is pure waste.\r\n        ...(recorded || handledBy.length > 0\r\n          ? {\r\n              loadDetail: async (): Promise<CallDetail> => {\r\n                // Unlike `/calls` (rows spread flat into `calls: []`), `/calls/:id` wraps its one\r\n                // result in `call` — `recordings.js`'s `res.json({ success, call: {...} })`.\r\n                const detail = await get<{\r\n                  call?: {\r\n                    recording_urls?: readonly string[];\r\n                    handled_by_chain?: readonly EnrichedHandledByChainRow[];\r\n                  };\r\n                }>(`${base}/calls/${encodeURIComponent(id)}`, org);\r\n                return {\r\n                  recordingUrls: detail.call?.recording_urls ?? [],\r\n                  // `row`'s own bare-extension fields (read inside `toHandledBy` when the chain\r\n                  // passed here is empty) still work as the fallback — only the CHAIN comes from the\r\n                  // enriched response; the rest of `row` is unchanged.\r\n                  handledBy: toHandledBy(row, detail.call?.handled_by_chain ?? []),\r\n                };\r\n              },\r\n            }\r\n          : {}),\r\n      };\r\n    });\r\n  };\r\n\r\n  const coventiaListAgents = async (): Promise<AgentsDirectory> => {\r\n    const body = await get<{ me?: AgentRow | null; people?: readonly AgentRow[] }>(\r\n      `${base}/agents`,\r\n      org,\r\n    );\r\n    const toAgent = (row: AgentRow) => ({ userId: row.user_id, name: row.name });\r\n    return {\r\n      me: body.me ? toAgent(body.me) : null,\r\n      people: (body.people ?? []).map(toAgent),\r\n    };\r\n  };\r\n\r\n  /**\r\n   * Phase A (transfer outcome relay). `since` omitted on the caller's very first poll — that call\r\n   * exists only to learn the starting `cursor`, per spec §5.3; this source is a thin, honest wrapper\r\n   * around the endpoint and does not itself implement that \"discard the first page\" rule, which\r\n   * belongs to the transfer watch (plan T5) that calls it.\r\n   */\r\n  const coventiaTransferOutcomes: TransferOutcomeSource = async ({ since }): Promise<TransferOutcomesPage> => {\r\n    const body = await get<{ cursor?: string; outcomes?: readonly TransferOutcomeRow[] }>(\r\n      `${base}/transfers/outcomes`,\r\n      { ...org, since },\r\n    );\r\n    return {\r\n      cursor: body.cursor ?? '0',\r\n      outcomes: (body.outcomes ?? []).map(toTransferOutcome),\r\n    };\r\n  };\r\n\r\n  /**\r\n   * Phase B (presence-gated transfer picker). Mints a fresh, one-time ticket (never the real voice\r\n   * token — spec §4.2's \"decided 2026-09-24: where the token travels\") and opens the WebSocket with\r\n   * it. Called fresh on every (re)connect by `presence-socket.ts`, which owns retry/backoff — this\r\n   * function is a single, honest attempt, the same division of labour `coventiaTransferOutcomes` has\r\n   * with the transfer watch that calls IT.\r\n   */\r\n  const coventiaPresence: PresenceSource = (callbacks: PresenceCallbacks): Promise<PresenceConnection> => {\r\n    const WS = config.WebSocket ?? globalThis.WebSocket;\r\n    return new Promise<PresenceConnection>((resolve, reject) => {\r\n      void (async () => {\r\n        let ticket: string;\r\n        try {\r\n          const body = await post<PresenceTicketResponse>(`${base}/presence/ticket`, org);\r\n          if (!body.ticket) throw new Error('presence ticket mint returned no ticket');\r\n          ticket = body.ticket;\r\n        } catch (error) {\r\n          reject(error instanceof Error ? error : new Error(String(error)));\r\n          return;\r\n        }\r\n\r\n        const wsUrl = `${toWebSocketUrl(config.baseUrl)}${base}/presence?ticket=${encodeURIComponent(ticket)}`;\r\n        const ws = new WS(wsUrl);\r\n        let settled = false;\r\n\r\n        ws.onopen = () => {\r\n          if (settled) return;\r\n          settled = true;\r\n          resolve({\r\n            reportCallState: (onCall) => {\r\n              if (ws.readyState !== WS.OPEN) return;\r\n              ws.send(JSON.stringify({ type: 'call-state', onCall }));\r\n            },\r\n            bye: () => {\r\n              if (ws.readyState !== WS.OPEN) return;\r\n              ws.send(JSON.stringify({ type: 'bye' }));\r\n            },\r\n            close: () => {\r\n              // Detached first — a deliberate close must never be reported to the caller as a drop\r\n              // (`PresenceConnection.close`'s own contract).\r\n              ws.onclose = null;\r\n              ws.onerror = null;\r\n              ws.close();\r\n            },\r\n          });\r\n        };\r\n\r\n        ws.onmessage = (event: MessageEvent) => {\r\n          let data: unknown;\r\n          try {\r\n            data = JSON.parse(String(event.data));\r\n          } catch {\r\n            return; // not JSON — ignore rather than tear down the connection over one stray frame\r\n          }\r\n          const msg = data as {\r\n            type?: string;\r\n            agents?: readonly PresenceAgentRow[];\r\n            agent?: PresenceAgentRow;\r\n          };\r\n          if (msg.type === 'snapshot') {\r\n            callbacks.onSnapshot((msg.agents ?? []).map(toPresenceEntry));\r\n          } else if (msg.type === 'delta' && msg.agent) {\r\n            callbacks.onDelta(toPresenceEntry(msg.agent));\r\n          }\r\n        };\r\n\r\n        ws.onclose = () => {\r\n          if (!settled) {\r\n            // Never actually opened (ticket refused, network refusal, ...) — indistinguishable from a\r\n            // drop to `presence-socket.ts`, which is exactly why this rejects rather than calling\r\n            // `onClose`: there is no `PresenceConnection` yet for that callback to be about.\r\n            settled = true;\r\n            reject(new Error('presence socket closed before opening'));\r\n            return;\r\n          }\r\n          callbacks.onClose();\r\n        };\r\n\r\n        // A real WebSocket always follows `error` with `close` — nothing extra to do here, and a\r\n        // browser gives an `error` event no further detail worth reporting anyway.\r\n        ws.onerror = () => {};\r\n      })();\r\n    });\r\n  };\r\n\r\n  /*\r\n   * Ringtone settings. The backend answers with a `path` from the API root rather than a URL (behind its\r\n   * proxy it cannot know its own public host — custom-ringtone-plan.md §2), so the file URL is built here\r\n   * exactly the way every request URL is: `baseUrl` + path. The UI only ever sees absolute URLs.\r\n   */\r\n  const fileBase = config.baseUrl.replace(/\\/+$/, '');\r\n  /** Loop points only when they are usable numbers in order — anything else means \"loop the whole file\". */\r\n  const toLoop = (l: { start: number; end: number } | null | undefined) =>\r\n    l && Number.isFinite(l.start) && Number.isFinite(l.end) && l.start >= 0 && l.end > l.start\r\n      ? { start: l.start, end: l.end }\r\n      : null;\r\n  const toRingtoneSettings = (body: RingtonesResponse): RingtoneSettings => {\r\n    const catalogue = (body.catalogue ?? []).map((r) => ({\r\n      id: r.id,\r\n      name: r.name,\r\n      url: r.path ? `${fileBase}${r.path}` : null,\r\n      loop: r.path ? toLoop(r.loop) : null,\r\n    }));\r\n    // Defensive only — the backend always resolves `effective` to a catalogue id. If a malformed answer\r\n    // ever named something else, the built-in tone (the entry with no file) is the safe reading.\r\n    const builtIn = catalogue.find((r) => r.url === null)?.id ?? 'clasico';\r\n    const effective = catalogue.some((r) => r.id === body.effective) ? (body.effective as string) : builtIn;\r\n    return { catalogue, orgDefault: body.orgDefault ?? null, mine: body.user ?? null, effective };\r\n  };\r\n\r\n  /*\r\n   * The last settings this user had, remembered in localStorage (custom-ringtone.md §4.4, added 2026-10-15):\r\n   * at startup the softphone can start loading the right file — usually straight from the browser's HTTP\r\n   * cache — before the backend has answered, which closes the \"first second after start\" window in which a\r\n   * call would otherwise ring the built-in tone. Fresh settings from the backend always replace them.\r\n   *\r\n   * Keyed by backend, organization and user (the token's identity), so two people sharing a browser — or one\r\n   * person in two organizations — never see each other's choice. Never throws: storage may be blocked.\r\n   */\r\n  const CACHE_PREFIX = 'coventia-softphone:ringtones:';\r\n  const cacheKey = async (): Promise<string | null> => {\r\n    try {\r\n      const { identity } = await config.tokenSource.getToken();\r\n      return `${CACHE_PREFIX}${fileBase}|${config.organizationId ?? '-'}|${identity}`;\r\n    } catch {\r\n      return null;\r\n    }\r\n  };\r\n  const remember = async (settings: RingtoneSettings): Promise<RingtoneSettings> => {\r\n    const key = await cacheKey();\r\n    try {\r\n      if (key) globalThis.localStorage?.setItem(key, JSON.stringify(settings));\r\n    } catch {\r\n      /* blocked or full — nothing to remember, nothing lost */\r\n    }\r\n    return settings;\r\n  };\r\n  const recall = async (): Promise<RingtoneSettings | null> => {\r\n    const key = await cacheKey();\r\n    try {\r\n      const raw = key ? globalThis.localStorage?.getItem(key) : null;\r\n      const s = raw ? (JSON.parse(raw) as RingtoneSettings) : null;\r\n      // Only a well-formed record whose effective ringtone is in its own catalogue; anything else is ignored.\r\n      const ok =\r\n        s &&\r\n        Array.isArray(s.catalogue) &&\r\n        s.catalogue.every((r) => typeof r?.id === 'string' && typeof r.name === 'string' && (r.url === null || typeof r.url === 'string')) &&\r\n        s.catalogue.some((r) => r.id === s.effective);\r\n      return ok ? { ...s, catalogue: s.catalogue.map((r) => ({ ...r, loop: toLoop(r.loop) })) } : null;\r\n    } catch {\r\n      return null;\r\n    }\r\n  };\r\n\r\n  const ringtones: RingtoneSource = {\r\n    get: async (signal) =>\r\n      remember(toRingtoneSettings(await get<RingtonesResponse>(`${base}/ringtones`, org, signal))),\r\n    // `null` clears: the empty id is dropped from the query by the request helper, and the backend reads a\r\n    // missing `ringtone_id` as \"clear\".\r\n    setMine: async (id) =>\r\n      remember(\r\n        toRingtoneSettings(await post<RingtonesResponse>(`${base}/ringtones/user`, { ...org, ringtone_id: id ?? '' })),\r\n      ),\r\n    cached: recall,\r\n  };\r\n\r\n  const contacts = config.contacts ?? coventiaContacts;\r\n\r\n  /*\r\n   * Caller ID follows the CONTACT LIST, not a separate setting.\r\n   *\r\n   * A provider who supplies `contacts` gets a resolver derived from it, so the tab, a live call and a\r\n   * history row always name the same number the same way. Supplying only the list used to leave\r\n   * caller ID on ours — the same person appearing twice under two names inside one widget.\r\n   */\r\n  const resolve =\r\n    config.resolveContact ??\r\n    (config.contacts ? resolverFromContacts(config.contacts) : coventiaResolve);\r\n\r\n  // Names, resolved once per distinct number and cached across pages — a call log is the same handful\r\n  // of numbers over and over. Wrapped HERE rather than left to the caller: the raw rows carry\r\n  // `name: null`, so a caller who forgets this gets a history of bare numbers and no error.\r\n  const history = withNameResolution(rawHistory, resolve);\r\n\r\n  const transferOutcomes = config.transferOutcomes ?? coventiaTransferOutcomes;\r\n  const presence = config.presence ?? coventiaPresence;\r\n\r\n  return {\r\n    contacts,\r\n    history,\r\n    resolveContact: resolve,\r\n    listAgents: coventiaListAgents,\r\n    transferOutcomes,\r\n    presence,\r\n    ringtones,\r\n  };\r\n}\r\n"]}

package/dist/testing/index.d.cts

@@ -1,5 +1,5 @@
-import { o as SoftphoneState, k as SoftphoneError, e as CallOptions, H as HangupReason, l as SoftphoneErrorCode, p as TokenSource } from '../call-VKq1I8yP.cjs';
-import { C as CallEngine, E as EngineCall } from '../engine-BlQBo2Ys.cjs';
+import { r as SoftphoneState, n as SoftphoneError, e as CallOptions, H as HangupReason, o as SoftphoneErrorCode, s as TokenSource } from '../call-CaPDWVk3.cjs';
+import { C as CallEngine, E as EngineCall } from '../engine-CU2rEo3g.cjs';
 
 interface SimulateIncomingOptions {
     readonly from: string;

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import { o as SoftphoneState, k as SoftphoneError, e as CallOptions, H as HangupReason, l as SoftphoneErrorCode, p as TokenSource } from '../call-VKq1I8yP.js';
-import { C as CallEngine, E as EngineCall } from '../engine-C0BOkIcW.js';
+import { r as SoftphoneState, n as SoftphoneError, e as CallOptions, H as HangupReason, o as SoftphoneErrorCode, s as TokenSource } from '../call-CaPDWVk3.js';
+import { C as CallEngine, E as EngineCall } from '../engine-BgBsIcEa.js';
 
 interface SimulateIncomingOptions {
     readonly from: string;