@coventia/softphone 0.1.0 → 0.2.1

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-DHmhotbf.js';
-import { f as CallState, R as RemoteParty, a as Call, h as FatalSoftphoneError, o as SoftphoneState } from '../call-BTYlT2SU.js';
+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';
 
 interface SoftphoneProviderProps {
     readonly softphone: Softphone;
@@ -37,6 +37,17 @@ declare function useIsLeader(): boolean;
  * `phone.activeCall` returns a stable reference for a given call, so it is a safe snapshot.
  */
 declare function useActiveCall(): Call | null;
+/**
+ * The live agent-presence list (`phone.presence`, Phase B) — reactive on `SoftphoneEvent.
+ * PresenceChanged`. `active` gates the SUBSCRIPTION only, not the underlying connection: the socket
+ * itself stays governed entirely by `online && isLeader` inside the softphone (spec's own
+ * always-connected decision), so passing `false` here does not close it — it only stops this
+ * particular component from re-rendering on every update while it has no reason to care, e.g. the
+ * transfer step being closed (spec §4.5: "subscribe when the step opens... unsubscribe when it
+ * closes"). `phone.presence` is still read fresh on every call, so flipping `active` back to `true`
+ * never shows a stale snapshot.
+ */
+declare function usePresence(active: boolean): readonly PresenceEntry[];
 /** An immutable snapshot of a call's reactive fields. */
 interface CallView {
     readonly state: CallState;
@@ -65,4 +76,4 @@ declare function useCall(call: Call | null): CallView | null;
  */
 declare function useDevices(): AudioDevices;
 
-export { type CallView, SoftphoneProvider, type SoftphoneProviderProps, useActiveCall, useCall, useDevices, useIsLeader, useLastError, useSoftphone, useSoftphoneState };
+export { type CallView, SoftphoneProvider, type SoftphoneProviderProps, useActiveCall, useCall, useDevices, useIsLeader, useLastError, usePresence, useSoftphone, useSoftphoneState };

package/dist/react/index.js

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

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

@@ -1,12 +1,19 @@
-import { u as ContactsSource, v as HistorySource, g as Contact, A as AgentsDirectory, q as TypedEmitter, n as SoftphoneEventMap, o as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call } from './call-BTYlT2SU.cjs';
+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';
 
-/** Contacts, history, caller ID and the agents directory, all from one config. */
+/** Contacts, history, caller ID, the agents directory, transfer outcomes and presence, all from one
+ *  config. */
 interface BackendSources {
     readonly contacts: ContactsSource;
     readonly history: HistorySource;
     readonly resolveContact: (number: string) => Promise<Contact | null>;
     /** The Historial tab's "filter by person" directory. Always Coventia's own org membership. */
     readonly listAgents: () => Promise<AgentsDirectory>;
+    /** Phase A (transfer outcome relay) — polled by the transfer watch, never by UI directly. */
+    readonly transferOutcomes: (params: {
+        readonly since?: string;
+    }) => Promise<TransferOutcomesPage>;
+    /** Phase B (presence-gated transfer picker) — opened by `presence-socket.ts`, never by UI directly. */
+    readonly presence: PresenceSource;
 }
 
 /**
@@ -114,6 +121,14 @@ interface Softphone extends TypedEmitter<SoftphoneEventMap> {
      */
     readonly sources: BackendSources | null;
     readonly audio: AudioDevices;
+    /**
+     * The live agent-presence list (Phase B, `docs/specs/transfer-presence-picker.md`) — every org
+     * member with a phone extension, whatever their state. Empty when there is no `PresenceSource`
+     * (no Coventia backend, or a host that omitted one), or while this tab is not `online && isLeader`
+     * — never an error, just nothing to show (spec §4.4's own success criterion). Updates fire
+     * `SoftphoneEvent.PresenceChanged`; `usePresence()` is the reactive read.
+     */
+    readonly presence: readonly PresenceEntry[];
     /**
      * False when the browser has blocked audio playback.
      *

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

@@ -1,12 +1,19 @@
-import { u as ContactsSource, v as HistorySource, g as Contact, A as AgentsDirectory, q as TypedEmitter, n as SoftphoneEventMap, o as SoftphoneState, h as FatalSoftphoneError, e as CallOptions, a as Call } from './call-BTYlT2SU.js';
+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';
 
-/** Contacts, history, caller ID and the agents directory, all from one config. */
+/** Contacts, history, caller ID, the agents directory, transfer outcomes and presence, all from one
+ *  config. */
 interface BackendSources {
     readonly contacts: ContactsSource;
     readonly history: HistorySource;
     readonly resolveContact: (number: string) => Promise<Contact | null>;
     /** The Historial tab's "filter by person" directory. Always Coventia's own org membership. */
     readonly listAgents: () => Promise<AgentsDirectory>;
+    /** Phase A (transfer outcome relay) — polled by the transfer watch, never by UI directly. */
+    readonly transferOutcomes: (params: {
+        readonly since?: string;
+    }) => Promise<TransferOutcomesPage>;
+    /** Phase B (presence-gated transfer picker) — opened by `presence-socket.ts`, never by UI directly. */
+    readonly presence: PresenceSource;
 }
 
 /**
@@ -114,6 +121,14 @@ interface Softphone extends TypedEmitter<SoftphoneEventMap> {
      */
     readonly sources: BackendSources | null;
     readonly audio: AudioDevices;
+    /**
+     * The live agent-presence list (Phase B, `docs/specs/transfer-presence-picker.md`) — every org
+     * member with a phone extension, whatever their state. Empty when there is no `PresenceSource`
+     * (no Coventia backend, or a host that omitted one), or while this tab is not `online && isLeader`
+     * — never an error, just nothing to show (spec §4.4's own success criterion). Updates fire
+     * `SoftphoneEvent.PresenceChanged`; `usePresence()` is the reactive read.
+     */
+    readonly presence: readonly PresenceEntry[];
     /**
      * False when the browser has blocked audio playback.
      *