@coventia/softphone 0.5.0 → 0.5.1

package/dist/zadarma/index.d.cts

@@ -1,5 +1,5 @@
-import { A as TokenSource } from '../call-FqcvDg1t.cjs';
-import { C as CallEngine } from '../engine-CzOCrfY9.cjs';
+import { A as TokenSource } from '../call-iGvr2ZnO.cjs';
+import { C as CallEngine } from '../engine-BKoT_Pj7.cjs';
 
 /**
  * Provider quirk timers. All optional. A self-hosted provider supplies none of them — which is the
@@ -23,20 +23,47 @@ interface ProviderQuirks {
      */
     readonly userAgent?: string;
     /**
-     * After a reject, ignore inbound INVITEs for this long.
+     * Setting it turns the decline guard on; its value is the guard's FALLBACK window.
      *
-     * Zadarma: 35 000. Its `return_timeout` is ~30 s, during which it RE-RINGS the extension you just
-     * declined. Without this the user is re-rung immediately after hanging up on a caller.
+     * Zadarma: 35 000. Zadarma re-offers a declined call until its ring time ends (the route's
+     * `return_timeout`, ~30 s by default), and nothing in the re-offer tells it from a new call. So after a
+     * decline the engine ignores offers from THE DECLINED CALLER — never anyone else's — while that call is
+     * alive: until the backend says it ended, when it announced it (`CallEngine.noteOffer`); otherwise for
+     * this long after the decline (incoming-call-reliability.md §4.4, Q1).
+     *
+     * Was `rejectGuardMs`, which swallowed every offer and every INVITE in the window, whoever called (CWA-81).
      */
-    readonly rejectGuardMs?: number;
+    readonly declinedCallerGuardMs?: number;
     /**
-     * After an incoming signal, tear the UA down if no INVITE arrives within this long.
+     * Once a REGISTER sent for an offer is answered (its 200 OK), tear the UA down if no INVITE follows within
+     * this long.
+     *
+     * Zadarma: 10 000. Zadarma sends the INVITE ~0.1 s after the 200 OK; a UA left registered with nothing
+     * coming is the standing registration SPEC §3.2 rules out. Counted from the 200 OK, never from `start()`:
+     * on a slow network the WSS alone can take longer than any fixed window (incoming-call-reliability.md F3).
      *
-     * Zadarma: 5 000. The push fires for ANY activity on the extension — transfers, retries, hangups —
-     * not just for a call to answer. Without the teardown a spurious push leaves a UA registered,
-     * which blocks the next real call.
+     * Was `noInviteTeardownMs` (5 000), counted from `ua.start()`.
+     */
+    readonly noInviteAfterRegisterMs?: number;
+    /**
+     * @deprecated Since 0.5.1: `declinedCallerGuardMs`. Kept, with the same value, only because `ZADARMA_QUIRKS`
+     * is exported from `@coventia/softphone/zadarma` and a patch release must not drop a field from it. The engine
+     * does not read it.
+     */
+    readonly rejectGuardMs?: number;
+    /**
+     * @deprecated Since 0.5.1: `noInviteAfterRegisterMs`. Kept, with the same value, for the same reason as
+     * `rejectGuardMs`. The engine does not read it.
      */
     readonly noInviteTeardownMs?: number;
+    /**
+     * The longest an offer may wait for its INVITE, counted from the signal: a leak guard, nothing more.
+     *
+     * Zadarma: 120 000. The wait normally ends with the INVITE, with the offer ending (`offer-ended`), or with
+     * `noInviteAfterRegisterMs`; this only stops a registration that never completes from living forever. It
+     * never fires on a real offer, so it reports nothing (incoming-call-reliability.md §4.3).
+     */
+    readonly offerWaitMaxMs?: number;
     /**
      * Give up waiting for ICE gathering after this long and send the INVITE anyway.
      *

package/dist/zadarma/index.d.ts

@@ -1,5 +1,5 @@
-import { A as TokenSource } from '../call-FqcvDg1t.js';
-import { C as CallEngine } from '../engine-CsNRD7B7.js';
+import { A as TokenSource } from '../call-iGvr2ZnO.js';
+import { C as CallEngine } from '../engine-CeGh5Yai.js';
 
 /**
  * Provider quirk timers. All optional. A self-hosted provider supplies none of them — which is the
@@ -23,20 +23,47 @@ interface ProviderQuirks {
      */
     readonly userAgent?: string;
     /**
-     * After a reject, ignore inbound INVITEs for this long.
+     * Setting it turns the decline guard on; its value is the guard's FALLBACK window.
      *
-     * Zadarma: 35 000. Its `return_timeout` is ~30 s, during which it RE-RINGS the extension you just
-     * declined. Without this the user is re-rung immediately after hanging up on a caller.
+     * Zadarma: 35 000. Zadarma re-offers a declined call until its ring time ends (the route's
+     * `return_timeout`, ~30 s by default), and nothing in the re-offer tells it from a new call. So after a
+     * decline the engine ignores offers from THE DECLINED CALLER — never anyone else's — while that call is
+     * alive: until the backend says it ended, when it announced it (`CallEngine.noteOffer`); otherwise for
+     * this long after the decline (incoming-call-reliability.md §4.4, Q1).
+     *
+     * Was `rejectGuardMs`, which swallowed every offer and every INVITE in the window, whoever called (CWA-81).
      */
-    readonly rejectGuardMs?: number;
+    readonly declinedCallerGuardMs?: number;
     /**
-     * After an incoming signal, tear the UA down if no INVITE arrives within this long.
+     * Once a REGISTER sent for an offer is answered (its 200 OK), tear the UA down if no INVITE follows within
+     * this long.
+     *
+     * Zadarma: 10 000. Zadarma sends the INVITE ~0.1 s after the 200 OK; a UA left registered with nothing
+     * coming is the standing registration SPEC §3.2 rules out. Counted from the 200 OK, never from `start()`:
+     * on a slow network the WSS alone can take longer than any fixed window (incoming-call-reliability.md F3).
      *
-     * Zadarma: 5 000. The push fires for ANY activity on the extension — transfers, retries, hangups —
-     * not just for a call to answer. Without the teardown a spurious push leaves a UA registered,
-     * which blocks the next real call.
+     * Was `noInviteTeardownMs` (5 000), counted from `ua.start()`.
+     */
+    readonly noInviteAfterRegisterMs?: number;
+    /**
+     * @deprecated Since 0.5.1: `declinedCallerGuardMs`. Kept, with the same value, only because `ZADARMA_QUIRKS`
+     * is exported from `@coventia/softphone/zadarma` and a patch release must not drop a field from it. The engine
+     * does not read it.
+     */
+    readonly rejectGuardMs?: number;
+    /**
+     * @deprecated Since 0.5.1: `noInviteAfterRegisterMs`. Kept, with the same value, for the same reason as
+     * `rejectGuardMs`. The engine does not read it.
      */
     readonly noInviteTeardownMs?: number;
+    /**
+     * The longest an offer may wait for its INVITE, counted from the signal: a leak guard, nothing more.
+     *
+     * Zadarma: 120 000. The wait normally ends with the INVITE, with the offer ending (`offer-ended`), or with
+     * `noInviteAfterRegisterMs`; this only stops a registration that never completes from living forever. It
+     * never fires on a real offer, so it reports nothing (incoming-call-reliability.md §4.3).
+     */
+    readonly offerWaitMaxMs?: number;
     /**
      * Give up waiting for ICE gathering after this long and send the INVITE anyway.
      *

package/dist/zadarma/index.js

@@ -1,6 +1,7 @@
-export { ZADARMA_QUIRKS, createZadarmaEngine } from '../chunk-6RR6G35E.js';
+export { ZADARMA_QUIRKS, createZadarmaEngine } from '../chunk-3UTUWGVG.js';
 import '../chunk-M76SAXXM.js';
 import '../chunk-FRXHEHQA.js';
+import '../chunk-DZRSSZWB.js';
 import '../chunk-MHOJHG5E.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/zadarma-engine-VYIXLBQG.js

@@ -0,0 +1,7 @@
+export { createZadarmaEngine } from './chunk-3UTUWGVG.js';
+import './chunk-M76SAXXM.js';
+import './chunk-FRXHEHQA.js';
+import './chunk-DZRSSZWB.js';
+import './chunk-MHOJHG5E.js';
+//# sourceMappingURL=zadarma-engine-VYIXLBQG.js.map
+//# sourceMappingURL=zadarma-engine-VYIXLBQG.js.map

package/dist/{zadarma-engine-TIUE7PZ7.js.map → zadarma-engine-VYIXLBQG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"zadarma-engine-TIUE7PZ7.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"zadarma-engine-VYIXLBQG.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coventia/softphone",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Embeddable browser softphone SDK for Zadarma: a framework-free engine, React components, and a Web Component drop-in.",
   "type": "module",
   "author": "Coventia",