@coventia/softphone 0.5.0 → 0.5.1

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

@@ -223,6 +223,24 @@ interface LineUpdate {
     /** Who has the line when it is `elsewhere`; `null` when it is here, or the server did not say. */
     readonly where: LineLocation | null;
 }
+/**
+ * A call offered to this user's line, as the backend announces it over the presence socket
+ * (incoming-call-reliability.md §5): `start` each time the call is offered to the extension (a re-offer of the
+ * same call repeats it, same `callId`), `end` when the call is over. `callId` is opaque; `from` is the caller,
+ * `null` (or, on an `end`, absent) when the backend did not say.
+ *
+ * The softphone uses it for one thing: after a decline, to know when the declined call's re-offers stop, so a
+ * new call from the same number rings (§4.4). A presence source that never sends it loses nothing but that.
+ */
+type CallOffer = {
+    readonly state: 'start';
+    readonly callId: string;
+    readonly from: string | null;
+} | {
+    readonly state: 'end';
+    readonly callId: string;
+    readonly from?: string | null;
+};
 /** The answer to `PresenceConnection.claimLine()`. */
 interface LineClaimResult {
     readonly ok: boolean;
@@ -429,6 +447,12 @@ interface PresenceCallbacks {
     readonly onLine?: (update: LineUpdate) => void;
     /** The answer to `PresenceConnection.claimLine()`. Optional, like `onLine`. */
     readonly onClaimResult?: (result: LineClaimResult) => void;
+    /**
+     * A call offered to this line started or ended (`CallOffer`). Sent only to the line's owner. Optional, like
+     * `onLine`: callbacks written before it existed still type-check, and a source that never calls it leaves the
+     * softphone on its fallback after a decline (incoming-call-reliability.md §4.4).
+     */
+    readonly onOffer?: (offer: CallOffer) => void;
 }
 /**
  * Opens one live presence connection. Coventia-backed by default (mints a one-time ticket, opens
@@ -903,7 +927,7 @@ interface TypedEmitter<M> {
  *
  *   - **`rejecting`.** Today's engine has one, purely to swallow Zadarma's `return_timeout` retries
  *     for 35 s after a decline (SPEC §3.4). That is a PROVIDER quirk — it belongs in
- *     `providers/zadarma.ts` as `quirks.rejectGuardMs`, not in the shared state machine. A rejected
+ *     `providers/zadarma.ts` as `quirks.declinedCallerGuardMs`, not in the shared state machine. A rejected
  *     call is simply `ended`. Our own SIP infrastructure would not need it at all (SPEC §2.3).
  *
  *   - **A pre-INVITE state.** A Call exists only once an INVITE has landed. The "user answered
@@ -1029,4 +1053,4 @@ interface Call extends TypedEmitter<CallEventMap> {
     cancelConsult(): Promise<void>;
 }
 
-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 };
+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 CallOffer as Z, 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-FqcvDg1t.d.ts → call-iGvr2ZnO.d.ts}

@@ -223,6 +223,24 @@ interface LineUpdate {
     /** Who has the line when it is `elsewhere`; `null` when it is here, or the server did not say. */
     readonly where: LineLocation | null;
 }
+/**
+ * A call offered to this user's line, as the backend announces it over the presence socket
+ * (incoming-call-reliability.md §5): `start` each time the call is offered to the extension (a re-offer of the
+ * same call repeats it, same `callId`), `end` when the call is over. `callId` is opaque; `from` is the caller,
+ * `null` (or, on an `end`, absent) when the backend did not say.
+ *
+ * The softphone uses it for one thing: after a decline, to know when the declined call's re-offers stop, so a
+ * new call from the same number rings (§4.4). A presence source that never sends it loses nothing but that.
+ */
+type CallOffer = {
+    readonly state: 'start';
+    readonly callId: string;
+    readonly from: string | null;
+} | {
+    readonly state: 'end';
+    readonly callId: string;
+    readonly from?: string | null;
+};
 /** The answer to `PresenceConnection.claimLine()`. */
 interface LineClaimResult {
     readonly ok: boolean;
@@ -429,6 +447,12 @@ interface PresenceCallbacks {
     readonly onLine?: (update: LineUpdate) => void;
     /** The answer to `PresenceConnection.claimLine()`. Optional, like `onLine`. */
     readonly onClaimResult?: (result: LineClaimResult) => void;
+    /**
+     * A call offered to this line started or ended (`CallOffer`). Sent only to the line's owner. Optional, like
+     * `onLine`: callbacks written before it existed still type-check, and a source that never calls it leaves the
+     * softphone on its fallback after a decline (incoming-call-reliability.md §4.4).
+     */
+    readonly onOffer?: (offer: CallOffer) => void;
 }
 /**
  * Opens one live presence connection. Coventia-backed by default (mints a one-time ticket, opens
@@ -903,7 +927,7 @@ interface TypedEmitter<M> {
  *
  *   - **`rejecting`.** Today's engine has one, purely to swallow Zadarma's `return_timeout` retries
  *     for 35 s after a decline (SPEC §3.4). That is a PROVIDER quirk — it belongs in
- *     `providers/zadarma.ts` as `quirks.rejectGuardMs`, not in the shared state machine. A rejected
+ *     `providers/zadarma.ts` as `quirks.declinedCallerGuardMs`, not in the shared state machine. A rejected
  *     call is simply `ended`. Our own SIP infrastructure would not need it at all (SPEC §2.3).
  *
  *   - **A pre-INVITE state.** A Call exists only once an INVITE has landed. The "user answered
@@ -1029,4 +1053,4 @@ interface Call extends TypedEmitter<CallEventMap> {
     cancelConsult(): Promise<void>;
 }
 
-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 };
+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 CallOffer as Z, 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 };