@open-e2ee/signal-protocol-sdk 10.0.0 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/CHANGELOG.md +117 -0
  2. package/README.md +1 -1
  3. package/SECURITY.md +2 -2
  4. package/client/README.md +14 -0
  5. package/dist/client/client.d.ts +9 -0
  6. package/dist/client/client.d.ts.map +1 -1
  7. package/dist/client/client.js +32 -0
  8. package/dist/client/client.js.map +1 -1
  9. package/dist/client/event-hooks.d.ts +36 -0
  10. package/dist/client/event-hooks.d.ts.map +1 -1
  11. package/dist/client/event-hooks.js +1 -0
  12. package/dist/client/event-hooks.js.map +1 -1
  13. package/dist/client/hosted-anonymous-delivery.d.ts.map +1 -1
  14. package/dist/client/hosted-anonymous-delivery.js +3 -0
  15. package/dist/client/hosted-anonymous-delivery.js.map +1 -1
  16. package/dist/client/hosted-device-standing.d.ts +52 -0
  17. package/dist/client/hosted-device-standing.d.ts.map +1 -0
  18. package/dist/client/hosted-device-standing.js +74 -0
  19. package/dist/client/hosted-device-standing.js.map +1 -0
  20. package/dist/client/hosted-group-authority.d.ts.map +1 -1
  21. package/dist/client/hosted-group-authority.js +18 -4
  22. package/dist/client/hosted-group-authority.js.map +1 -1
  23. package/dist/client/hosted-groups.d.ts.map +1 -1
  24. package/dist/client/hosted-groups.js +5 -1
  25. package/dist/client/hosted-groups.js.map +1 -1
  26. package/dist/client/hosted-mailbox-subscription.d.ts +16 -2
  27. package/dist/client/hosted-mailbox-subscription.d.ts.map +1 -1
  28. package/dist/client/hosted-mailbox-subscription.js +243 -42
  29. package/dist/client/hosted-mailbox-subscription.js.map +1 -1
  30. package/dist/client/hosted-transport.d.ts.map +1 -1
  31. package/dist/client/hosted-transport.js +56 -8
  32. package/dist/client/hosted-transport.js.map +1 -1
  33. package/dist/client/hosted.d.ts +13 -1
  34. package/dist/client/hosted.d.ts.map +1 -1
  35. package/dist/client/hosted.js +113 -41
  36. package/dist/client/hosted.js.map +1 -1
  37. package/dist/client/index.d.ts +2 -2
  38. package/dist/client/index.d.ts.map +1 -1
  39. package/dist/client/index.js +1 -1
  40. package/dist/client/index.js.map +1 -1
  41. package/dist/client/messages.d.ts.map +1 -1
  42. package/dist/client/messages.js +10 -0
  43. package/dist/client/messages.js.map +1 -1
  44. package/dist/client/one-time-prekey-refill.d.ts +7 -0
  45. package/dist/client/one-time-prekey-refill.d.ts.map +1 -1
  46. package/dist/client/one-time-prekey-refill.js +5 -1
  47. package/dist/client/one-time-prekey-refill.js.map +1 -1
  48. package/dist/client/relay-acceptance.d.ts +17 -0
  49. package/dist/client/relay-acceptance.d.ts.map +1 -1
  50. package/dist/client/relay-acceptance.js +37 -0
  51. package/dist/client/relay-acceptance.js.map +1 -1
  52. package/dist/client/relay-protocol.d.ts +41 -0
  53. package/dist/client/relay-protocol.d.ts.map +1 -0
  54. package/dist/client/relay-protocol.js +60 -0
  55. package/dist/client/relay-protocol.js.map +1 -0
  56. package/dist/client/relay-subscription.d.ts.map +1 -1
  57. package/dist/client/relay-subscription.js +30 -30
  58. package/dist/client/relay-subscription.js.map +1 -1
  59. package/dist/client/retry-family.d.ts +11 -9
  60. package/dist/client/retry-family.d.ts.map +1 -1
  61. package/dist/client/retry-family.js +5 -5
  62. package/dist/client/retry-family.js.map +1 -1
  63. package/dist/client/retry-request-envelope.d.ts +40 -12
  64. package/dist/client/retry-request-envelope.d.ts.map +1 -1
  65. package/dist/client/retry-request-envelope.js +142 -54
  66. package/dist/client/retry-request-envelope.js.map +1 -1
  67. package/dist/client/retry-request-lifecycle.d.ts +101 -0
  68. package/dist/client/retry-request-lifecycle.d.ts.map +1 -0
  69. package/dist/client/retry-request-lifecycle.js +307 -0
  70. package/dist/client/retry-request-lifecycle.js.map +1 -0
  71. package/dist/client/retry.d.ts +6 -6
  72. package/dist/client/retry.d.ts.map +1 -1
  73. package/dist/client/retry.js +83 -38
  74. package/dist/client/retry.js.map +1 -1
  75. package/dist/client/signal-service-cipher.d.ts.map +1 -1
  76. package/dist/client/signal-service-cipher.js +5 -1
  77. package/dist/client/signal-service-cipher.js.map +1 -1
  78. package/dist/client/types.d.ts.map +1 -1
  79. package/dist/client/types.js.map +1 -1
  80. package/dist/index.d.ts +2 -2
  81. package/dist/index.d.ts.map +1 -1
  82. package/dist/index.js +1 -1
  83. package/dist/index.js.map +1 -1
  84. package/dist/local/store/reliability.d.ts +106 -8
  85. package/dist/local/store/reliability.d.ts.map +1 -1
  86. package/dist/local/store/reliability.js +165 -16
  87. package/dist/local/store/reliability.js.map +1 -1
  88. package/dist/remote/relay/types.d.ts +19 -5
  89. package/dist/remote/relay/types.d.ts.map +1 -1
  90. package/dist/utils/retry.d.ts +3 -0
  91. package/dist/utils/retry.d.ts.map +1 -1
  92. package/dist/utils/retry.js +13 -0
  93. package/dist/utils/retry.js.map +1 -1
  94. package/docs/ASSURANCE.md +5 -5
  95. package/docs/ERROR_HANDLING.md +119 -0
  96. package/package.json +1 -1
@@ -1,5 +1,6 @@
1
1
  import { utf8Decode } from '../internal/platform/index.js';
2
2
  import { withRelayRequestDeadline } from './relay-request-deadline.js';
3
+ import { relayProtocolHeaders, throwIfUpgradeRequired } from './relay-protocol.js';
3
4
  import { EndorsementManager, } from './endorsement-manager.js';
4
5
  import { verifyGroupAuthority } from '../internal/groups/authority-certificate.js';
5
6
  import { decodeGroupTrustRoot } from '../internal/groups/trust-root.js';
@@ -12,14 +13,13 @@ async function fetchAuthority(connection) {
12
13
  headers: {
13
14
  'content-type': 'application/json',
14
15
  accept: 'application/json',
16
+ ...relayProtocolHeaders(),
15
17
  },
16
18
  body: JSON.stringify({ publishableKey: connection.publishableKey }),
17
19
  signal,
18
20
  });
19
- if (!response.ok || !response.body) {
20
- await response.body?.cancel();
21
+ if (!response.body)
21
22
  throw new Error('Managed group authority is unavailable');
22
- }
23
23
  const reader = response.body.getReader();
24
24
  const chunks = [];
25
25
  let length = 0;
@@ -31,7 +31,9 @@ async function fetchAuthority(connection) {
31
31
  length += part.value.length;
32
32
  if (length > 8192) {
33
33
  await reader.cancel();
34
- throw new Error('Managed group authority exceeds its size limit');
34
+ throw new Error(response.ok
35
+ ? 'Managed group authority exceeds its size limit'
36
+ : 'Managed group authority is unavailable');
35
37
  }
36
38
  chunks.push(part.value);
37
39
  }
@@ -45,6 +47,18 @@ async function fetchAuthority(connection) {
45
47
  body.set(part, offset);
46
48
  offset += part.length;
47
49
  }
50
+ if (!response.ok) {
51
+ // Only the error body tells a terminal `UPGRADE_REQUIRED` from an outage.
52
+ let error;
53
+ try {
54
+ error = JSON.parse(utf8Decode(body, { fatal: true }));
55
+ }
56
+ catch {
57
+ error = undefined;
58
+ }
59
+ throwIfUpgradeRequired(response.status, error);
60
+ throw new Error('Managed group authority is unavailable');
61
+ }
48
62
  return body;
49
63
  });
50
64
  return verifyGroupAuthority(JSON.parse(utf8Decode(buffer, { fatal: true })), {
@@ -1 +1 @@
1
- {"version":3,"file":"hosted-group-authority.js","sourceRoot":"","sources":["../../client/hosted-group-authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,kBAAkB,GAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAUrE,KAAK,UAAU,cAAc,CAAC,UAAiC;IAC7D,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,UAAU,CAAC,gBAAgB,mBAAmB,EACjD;YACE,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,cAAc,EAAE,CAAC;YACnE,MAAM;SACP,CACF,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,IAAI;oBAAE,MAAM;gBACrB,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC5B,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;oBAClB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACpE,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvB,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,oBAAoB,CACzB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/C;QACE,GAAG,UAAU,CAAC,gBAAgB;QAC9B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE;KAC5B,CACF,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAAiC,EACjC,OAA2B;IAE3B,IACE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACvB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CACpE;QAED,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,IAAI,OACwE,CAAC;IAC7E,IAAI,OAA4C,CAAC;IACjD,MAAM,gBAAgB,GAAG,KAAK,IAA6B,EAAE;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ;YAC/D,OAAO,OAAO,CAAC,KAAK,CAAC;QACvB,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,oBAAoB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,KAAK,GAAmB;gBAC5B,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,cAAc,EAAE,SAAS,CAAC,KAAK;gBAC/B,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;oBACxC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,kBAAkB,EAAE,IAAI,kBAAkB,CACxC,OAAO,CAAC,gBAAgB,EACxB,IAAI,CAAC,wBAAwB,CAC9B;qBACF,CAAC;aACP,CAAC;YACF,OAAO,GAAG;gBACR,KAAK;gBACL,SAAS,EAAE,SAAS,CAAC,qBAAqB;gBAC1C,QAAQ,EAAE,SAAS,CAAC,oBAAoB;aACzC,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC3C,OAAO;QACL,GAAG,SAAS;QACZ,gBAAgB;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"hosted-group-authority.js","sourceRoot":"","sources":["../../client/hosted-group-authority.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"hosted-groups.d.ts","sourceRoot":"","sources":["../../client/hosted-groups.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACZ,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAyF1C,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;KAC3B,CAAC;IAEF,YAAY,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAmBzC;CACF;AAED,0FAA0F;AAC1F,qBAAa,iBAAkB,YAAW,WAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAvC,YAA6B,UAAU,EAAE,qBAAqB,EAAI;YAEpD,OAAO;IAoCf,4BAA4B,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAOpJ;IAEK,WAAW,CACf,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAKf;IAEK,QAAQ,CACZ,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,kBAAkB,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoB/B;IAEK,gBAAgB,CACpB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,iBAAiB,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAUpE;IAEK,eAAe,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;IAEK,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAc9B;CACF"}
1
+ {"version":3,"file":"hosted-groups.d.ts","sourceRoot":"","sources":["../../client/hosted-groups.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACZ,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAyF1C,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;KAC3B,CAAC;IAEF,YAAY,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAmBzC;CACF;AAED,0FAA0F;AAC1F,qBAAa,iBAAkB,YAAW,WAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAvC,YAA6B,UAAU,EAAE,qBAAqB,EAAI;YAEpD,OAAO;IAwCf,4BAA4B,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAOpJ;IAEK,WAAW,CACf,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,UAAU,EAC1B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAKf;IAEK,QAAQ,CACZ,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,kBAAkB,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoB/B;IAEK,gBAAgB,CACpB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC;QAAE,iBAAiB,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAUpE;IAEK,eAAe,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;IAEK,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,UAAU,EACnB,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAc9B;CACF"}
@@ -1,6 +1,7 @@
1
1
  import { utf8Decode } from '../internal/platform/index.js';
2
2
  import { base64ToBytes, bytesToBase64 } from '../internal/crypto/index.js';
3
3
  import { withRelayRequestDeadline } from './relay-request-deadline.js';
4
+ import { relayProtocolHeaders, throwIfUpgradeRequired } from './relay-protocol.js';
4
5
  import { isGroupErrorDetail, } from '../internal/groups/error-details.js';
5
6
  const MAXIMUM_RESPONSE_BYTES = 8 * 1024 * 1024;
6
7
  const MAXIMUM_CHANGE_ENTRIES = 64;
@@ -128,6 +129,7 @@ export class HostedGroupServer {
128
129
  headers: {
129
130
  accept: 'application/json',
130
131
  'content-type': 'application/json',
132
+ ...relayProtocolHeaders(),
131
133
  },
132
134
  body: JSON.stringify({
133
135
  publishableKey: this.connection.publishableKey,
@@ -140,8 +142,10 @@ export class HostedGroupServer {
140
142
  signal,
141
143
  });
142
144
  const value = await readResponse(response);
143
- if (!response.ok)
145
+ if (!response.ok) {
146
+ throwIfUpgradeRequired(response.status, value);
144
147
  throw new HostedGroupError(response.status, value);
148
+ }
145
149
  return value;
146
150
  });
147
151
  }
@@ -1 +1 @@
1
- {"version":3,"file":"hosted-groups.js","sourceRoot":"","sources":["../../client/hosted-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQlD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,kBAAkB,GAAqC;IAC3D,eAAe,EAAE,GAAG;IACpB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;CACtB,CAAC;AAGF,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACxE,eAAe,EAAE,CAAC;IACpB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,eAAe,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,KAAe,CAAC,CAAC;QAC9C,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,KAAK;YAAE,eAAe,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,eAAe,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/B,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC;QAC7C,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QACvC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;KACpC,CAAC;IACF,IAAI,MAAM,CAAC,eAAe,CAAC,UAAU,KAAK,EAAE;QAAE,eAAe,EAAE,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAkB;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QAC9C,eAAe,EAAE,CAAC;IACpB,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM;YACrB,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAChC,IAAI,MAAM,GAAG,sBAAsB,EAAE,CAAC;gBACpC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,eAAe,EAAE,CAAC;YACpB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,IAAI,MAAM,KAAK,CAAC;YAAE,eAAe,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAKX;IAEF,YAAY,MAAc,EAAE,KAAc;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,GACR,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC;YAC7C,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM;YACvC,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,sBAAsB,CAAC;QAC7B,KAAK,CAAC,GAAG,IAAI,8BAA8B,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,sBAAsB,IAAI,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC;YACrE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAClC,IACE,IAAI,KAAK,WAAW;YACpB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAChC,CAAC,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YAEtE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,OAAO,iBAAiB;IACC,UAAU;IAAvC,YAA6B,UAAiC;0BAAjC,UAAU;IAA0B,CAAC;IAE1D,KAAK,CAAC,OAAO,CACnB,SAAmF,EACnF,OAAmB,EACnB,aAAiC,EACjC,MAAM,GAAe,EAAE;QAEvB,IAAI,CAAC,aAAa,CAAC,cAAc,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;YAC/F,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,OAAO,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,qBAAqB,SAAS,EAAE,EACnE;gBACE,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc;oBAC9C,cAAc,EAAE,aAAa,CAAC,cAAc;oBAC5C,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;oBAC/B,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,YAAY,CAAC;oBACvD,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,iBAAiB,CAAC;oBACjE,GAAG,MAAM;iBACV,CAAC;gBACF,MAAM;aACP,CACF,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACrE,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,4BAA4B,CAAC,OAAmB,EAAE,aAAiC;QACvF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,eAAe,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,UAAU,GAAG,KAAK,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,eAAe,EAAE,CAAC;QAC3E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAmB,EACnB,cAA0B,EAC1B,aAAiC;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YACjE,cAAc,EAAE,aAAa,CAAC,cAAc,CAAC;SAC9C,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,SAAS;YAAE,eAAe,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAmB,EACnB,aAAiC,EACjC,OAAgB;QAEhB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAC9B,OAAO,EACP,OAAO,EACP,aAAa,EACb,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CACzC,CAAC;QACF,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG;YACb,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC;YAC3C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC/B,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;SAClD,CAAC;QACF,IACE,MAAM,CAAC,iBAAiB,CAAC,UAAU,KAAK,EAAE;YAC1C,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC;YAErD,eAAe,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAAmB,EACnB,kBAA8B,EAC9B,aAAiC;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE;YACpE,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,eAAe,EAAE,CAAC;QACtC,OAAO;YACL,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;YACjD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;SAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAAmB,EACnB,WAAmB,EACnB,aAAiC;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;YAClE,WAAW;SACZ,CAAC,CAAC;QACH,IACE,CAAC,MAAM,CAAC,KAAK,CAAC;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7B,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,sBAAsB;YAC7C,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;YAElC,eAAe,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IACE,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC;YAEzE,eAAe,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,OAAmB,EACnB,eAAuB,EACvB,OAAmB,EACnB,kBAA8B,EAC9B,aAAiC;QAEjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,CACnB,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YACnD,eAAe;YACf,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;YAC/B,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,CAAC;SACtD,CAAC,CACH,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,KAAK,eAAe,GAAG,CAAC;YAAE,eAAe,EAAE,CAAC;QAC9D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
1
+ {"version":3,"file":"hosted-groups.js","sourceRoot":"","sources":["../../client/hosted-groups.ts"],"names":[],"mappings":"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"}
@@ -26,11 +26,22 @@ export interface MailboxAcknowledgment {
26
26
  readonly receipted: readonly string[];
27
27
  }
28
28
  interface MailboxSubscription {
29
+ /**
30
+ * Gets the socket address and a device token. `refreshed` is true when the
31
+ * call got a new device token from the Relay.
32
+ */
29
33
  authenticate(): Promise<{
30
34
  url: string;
31
35
  token: string;
32
36
  renewAt: number;
37
+ refreshed: boolean;
33
38
  }>;
39
+ /**
40
+ * Returns true for a Relay refusal of a socket authentication or a pull
41
+ * that the same request gets again. The subscription then stops with the
42
+ * reason `authority-refused`. Each other failure goes to the retry schedule.
43
+ */
44
+ isConclusiveRefusal(error: unknown): boolean;
34
45
  /** Decodes the `message` of a `durable-message` frame. */
35
46
  decodeDurable(message: unknown): Envelope;
36
47
  /** Recovers retained work over HTTP while no socket delivers it. */
@@ -59,8 +70,11 @@ interface MailboxSubscription {
59
70
  onBatchEnd?(): void;
60
71
  /**
61
72
  * Receives each connection transition. The subscription starts at
62
- * `connecting` and ends at `stopped`. A token renewal on a live socket is not
63
- * a transition.
73
+ * `connecting` and ends at `stopped`. It ends at `stopped` with the reason
74
+ * `upgrade-required` when the Relay no longer serves the protocol version of
75
+ * this SDK, with `device-revoked` or `device-unknown` when the Relay refuses
76
+ * this device, and with `authority-refused` after a conclusive refusal. A
77
+ * token renewal on a live socket is not a transition.
64
78
  */
65
79
  onConnectionState(state: RelayConnectionState["state"], reason?: RelayConnectionReason): void;
66
80
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"hosted-mailbox-subscription.d.ts","sourceRoot":"","sources":["../../client/hosted-mailbox-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAOL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AA8DhC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,UAAU,mBAAmB;IAC3B,YAAY,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,0DAA0D;IAC1D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B;;;OAGG;IACH,WAAW,CACT,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,CACf,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACpC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,IAAI,CAAC;IACR;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAqBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,yBAAyB,CAulB3B"}
1
+ {"version":3,"file":"hosted-mailbox-subscription.d.ts","sourceRoot":"","sources":["../../client/hosted-mailbox-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAOL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAyGhC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,UAAU,mBAAmB;IAC3B;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7C,0DAA0D;IAC1D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B;;;OAGG;IACH,WAAW,CACT,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACnE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB;;;;;;;OAOG;IACH,iBAAiB,CACf,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACpC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,IAAI,CAAC;IACR;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAqBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,yBAAyB,CAowB3B"}
@@ -1,7 +1,23 @@
1
1
  import { HostedRelayPresenceError, decodePresenceAnswer, decodePresenceUpdate, encodePresenceFrame, isPresenceAnswerType, isPresenceUpdateType, } from "./hosted-presence-frames.js";
2
2
  import { MAXIMUM_RECEIPTS_PER_FRAME, decodeRelayDeliveryReceipts, } from "./relay-receipt-intake.js";
3
- const MAILBOX_PROTOCOL = "open-e2ee-relay.v1";
4
- const AUTH_PROTOCOL_PREFIX = "open-e2ee-relay.auth.";
3
+ import { HostedRelayUpgradeRequiredError, RELAY_AUTH_PROTOCOL_PREFIX, RELAY_PROTOCOL_VERSION, relayProtocolToken, } from "./relay-protocol.js";
4
+ import { HostedRelayDeviceRevokedError, HostedRelayDeviceUnknownError, } from "./hosted-device-standing.js";
5
+ /**
6
+ * The stop reason that a typed Relay refusal names, or undefined for any other
7
+ * error. A conclusive `HostedRelayHttpError` refusal is not typed. The
8
+ * subscription asks `isConclusiveRefusal` for it.
9
+ */
10
+ function relayRefusalReason(error) {
11
+ if (error instanceof HostedRelayUpgradeRequiredError)
12
+ return "upgrade-required";
13
+ if (error instanceof HostedRelayDeviceRevokedError)
14
+ return "device-revoked";
15
+ if (error instanceof HostedRelayDeviceUnknownError)
16
+ return "device-unknown";
17
+ return undefined;
18
+ }
19
+ /** The subprotocol token that the socket offers and the Relay must echo. */
20
+ const RELAY_PROTOCOL_TOKEN = relayProtocolToken(RELAY_PROTOCOL_VERSION);
5
21
  /**
6
22
  * The recovery pull waits a random time from half to one and a half of this
7
23
  * value after the call that asks for it, so clients that lose their sockets
@@ -28,11 +44,15 @@ const MAXIMUM_RECOVERY_MILLISECONDS = 64_000;
28
44
  */
29
45
  const FAILED_MESSAGE_GONE_MILLISECONDS = 5_000;
30
46
  /**
31
- * The reconnect ceiling starts at 1 s and doubles to 30 s. Each wait is a
32
- * random time from zero up to the ceiling (full jitter), the first one too, so
33
- * clients that lose their sockets together, for example in a Relay deploy, do
34
- * not reconnect together. The ceiling starts again at 1 s when the Relay
35
- * answers a ping, 30 s after the socket opens. A socket that closes sooner,
47
+ * The retry schedule. Its ceiling starts at 1 s and doubles to 30 s. Each wait
48
+ * is a random time from zero up to the ceiling (full jitter), the first one
49
+ * too, so clients that lose their sockets together, for example in a Relay
50
+ * deploy, do not reconnect together. A failed socket, a failed socket
51
+ * authentication, and a failed pull share this one schedule. While a wait is
52
+ * pending, a further failure draws no new wait, so failures of different
53
+ * kinds do not multiply the requests of an outage. The ceiling starts again at
54
+ * 1 s when the Relay answers a ping, 30 s after the socket opens, and when the
55
+ * socket authentication gets a new device token. A socket that closes sooner,
36
56
  * for example on a frame that the client refuses on each connect, keeps the
37
57
  * ceiling growing, so a loop of short connections backs off to 30 s.
38
58
  */
@@ -59,6 +79,12 @@ const MAXIMUM_PENDING_PRESENCE_REQUESTS = 16;
59
79
  const PRESENCE_ANSWER_MILLISECONDS = 10_000;
60
80
  /** The Relay closes the socket with this code on a frame that it refuses. */
61
81
  const POLICY_VIOLATION_CLOSE_CODE = 1008;
82
+ /**
83
+ * The Relay closes the socket with this code and the reason
84
+ * `UPGRADE_REQUIRED` when it no longer serves the offered protocol version.
85
+ */
86
+ const UPGRADE_REQUIRED_CLOSE_CODE = 4426;
87
+ const UPGRADE_REQUIRED_CLOSE_REASON = "UPGRADE_REQUIRED";
62
88
  function notConnected() {
63
89
  return new HostedRelayPresenceError("NOT_CONNECTED", "The mailbox socket is not connected", true);
64
90
  }
@@ -71,15 +97,44 @@ function notConnected() {
71
97
  */
72
98
  export function subscribeHostedMailbox(options) {
73
99
  let active = true;
100
+ /**
101
+ * True after the Relay refused the protocol version of this SDK, refused
102
+ * this device, or refused the subscription conclusively.
103
+ */
104
+ let refused = false;
74
105
  let socket;
106
+ /** True after the current socket opened with the mailbox subprotocol. */
107
+ let socketOpened = false;
108
+ /** True while a connect waits for its socket authentication. */
109
+ let authenticating = false;
75
110
  let connectionGeneration = 0;
111
+ /** The ceiling of the retry schedule. */
76
112
  let reconnectDelay = FIRST_RECONNECT_MILLISECONDS;
77
- let reconnectTimer;
78
113
  let handshakeTimer;
79
114
  let renewalTimer;
80
- let recoveryTimer;
115
+ /**
116
+ * The one timer of the retries. It fires at the sooner of `retryDue` and
117
+ * `recoveryDue`.
118
+ */
119
+ let retryTimer;
120
+ /**
121
+ * The `Date.now()` time of the next retry of the schedule. The retry
122
+ * reconnects a missing socket, or runs an owed pull while a socket is up or
123
+ * connecting. Undefined while no retry waits.
124
+ */
125
+ let retryDue;
81
126
  /** The `Date.now()` time at which the pending recovery pull starts. */
82
- let recoveryDue = 0;
127
+ let recoveryDue;
128
+ /**
129
+ * True from a failed socket authentication or a failed pull until a pull
130
+ * succeeds, the socket authentication gets a new device token, or the
131
+ * Relay answers a ping. In an outage a failed socket draws no recovery pull
132
+ * of its own. A socket attempt that fails before it opens pulls at once
133
+ * instead, on the retry schedule.
134
+ */
135
+ let outage = false;
136
+ /** True while a failed pull waits for the next retry. */
137
+ let pullOwed = false;
83
138
  let failedWorkRecoveryDelay = RECOVERY_MILLISECONDS;
84
139
  /**
85
140
  * The id of each message whose work failed, with the `Date.now()` time of
@@ -188,6 +243,67 @@ export function subscribeHostedMailbox(options) {
188
243
  if (awaitingReply.delete(messageId))
189
244
  options.onAcknowledgmentReply(messageId, receipted.includes(messageId));
190
245
  };
246
+ /** Sets the one retry timer for the sooner of the two pending times. */
247
+ const armRetryTimer = () => {
248
+ clearTimeout(retryTimer);
249
+ retryTimer = undefined;
250
+ if (!active)
251
+ return;
252
+ const due = Math.min(retryDue ?? Infinity, recoveryDue ?? Infinity);
253
+ if (due === Infinity)
254
+ return;
255
+ retryTimer = setTimeout(() => runRetries(due), Math.max(0, due - Date.now()));
256
+ };
257
+ /**
258
+ * Runs each retry that is due at `due`, the time of the timer that fired,
259
+ * then sets the timer for the rest.
260
+ */
261
+ const runRetries = (due) => {
262
+ retryTimer = undefined;
263
+ if (retryDue !== undefined && retryDue <= due) {
264
+ retryDue = undefined;
265
+ // A new socket attempt carries the owed pull, which runs when the
266
+ // attempt fails before it opens.
267
+ if (socket === undefined && !authenticating)
268
+ void connect();
269
+ else if (pullOwed) {
270
+ pullOwed = false;
271
+ requestPull();
272
+ }
273
+ }
274
+ if (recoveryDue !== undefined && recoveryDue <= due) {
275
+ recoveryDue = undefined;
276
+ requestPull();
277
+ }
278
+ armRetryTimer();
279
+ };
280
+ /**
281
+ * Draws the next retry wait from the schedule and doubles the ceiling,
282
+ * unless a retry already waits. A failure during the wait draws nothing.
283
+ */
284
+ const scheduleRetry = () => {
285
+ if (!active || retryDue !== undefined)
286
+ return;
287
+ retryDue = Date.now() + Math.floor(Math.random() * reconnectDelay);
288
+ reconnectDelay = Math.min(MAXIMUM_RECONNECT_MILLISECONDS, reconnectDelay * 2);
289
+ armRetryTimer();
290
+ };
291
+ /** A request succeeded, so the outage ends and the ceiling starts again. */
292
+ const endOutage = () => {
293
+ outage = false;
294
+ reconnectDelay = FIRST_RECONNECT_MILLISECONDS;
295
+ };
296
+ /**
297
+ * Owes a failed pull to the retry schedule. The pending recovery pull
298
+ * ends, so the failed pull does not run twice.
299
+ */
300
+ const retryPull = () => {
301
+ outage = true;
302
+ pullOwed = true;
303
+ recoveryDue = undefined;
304
+ armRetryTimer();
305
+ scheduleRetry();
306
+ };
191
307
  /**
192
308
  * Schedules one recovery pull. A pending pull that starts sooner stays, and
193
309
  * a pending pull that starts later is replaced, so a longer wait for failed
@@ -199,16 +315,10 @@ export function subscribeHostedMailbox(options) {
199
315
  return false;
200
316
  const wait = delay * (0.5 + Math.random());
201
317
  const due = Date.now() + wait;
202
- if (recoveryTimer !== undefined) {
203
- if (due >= recoveryDue)
204
- return false;
205
- clearTimeout(recoveryTimer);
206
- }
318
+ if (recoveryDue !== undefined && due >= recoveryDue)
319
+ return false;
207
320
  recoveryDue = due;
208
- recoveryTimer = setTimeout(() => {
209
- recoveryTimer = undefined;
210
- requestPull();
211
- }, wait);
321
+ armRetryTimer();
212
322
  return true;
213
323
  };
214
324
  /** Schedules the recovery pull for failed work, and doubles its next wait. */
@@ -240,7 +350,11 @@ export function subscribeHostedMailbox(options) {
240
350
  if ("receipt" in work) {
241
351
  try {
242
352
  await options.receiveReceipt(work.receipt);
243
- receiptAcknowledgments.push(work.receipt.receiptId);
353
+ // A hand-off that settles after a refusal stop is not
354
+ // acknowledged, because the Relay refuses the acknowledgment. The
355
+ // Relay keeps the receipt.
356
+ if (!refused)
357
+ receiptAcknowledgments.push(work.receipt.receiptId);
244
358
  }
245
359
  catch {
246
360
  failed = true;
@@ -291,6 +405,8 @@ export function subscribeHostedMailbox(options) {
291
405
  if (draining || !active)
292
406
  return;
293
407
  draining = true;
408
+ /** True while `options.pull` runs, so the catch knows what failed. */
409
+ let pulling = false;
294
410
  try {
295
411
  while (active &&
296
412
  (pullRequested || ephemeral.length > 0 || durable.length > 0)) {
@@ -316,7 +432,13 @@ export function subscribeHostedMailbox(options) {
316
432
  pullRequested = false;
317
433
  flushAcknowledgments();
318
434
  const pulledAt = Date.now();
435
+ pulling = true;
319
436
  const { messages, receipts } = await options.pull();
437
+ pulling = false;
438
+ // The Relay answered, so the HTTP outage ends. The reconnect ceiling
439
+ // stays, because the socket can still fail.
440
+ outage = false;
441
+ pullOwed = false;
320
442
  const { failed, acknowledged } = await receiveBatch([
321
443
  ...messages.map((message) => ({ message })),
322
444
  ...receipts.map((receipt) => ({ receipt })),
@@ -338,10 +460,22 @@ export function subscribeHostedMailbox(options) {
338
460
  recoverLater();
339
461
  }
340
462
  }
341
- catch {
463
+ catch (error) {
342
464
  // A pull, an ephemeral message, or a batch callback failed. Retained
343
- // durable work stays in the mailbox. Ephemeral work can be lost.
344
- recoverLater();
465
+ // durable work stays in the mailbox. Ephemeral work can be lost. A pull
466
+ // that the Relay refuses for this SDK or this device, or refuses
467
+ // conclusively, fails the same way each time, so it ends the
468
+ // subscription. Each other failed pull goes to the retry schedule. A
469
+ // callback error is the application's, so it only schedules a pull.
470
+ const refusal = relayRefusalReason(error);
471
+ if (refusal !== undefined)
472
+ stop(refusal);
473
+ else if (!pulling)
474
+ recoverLater();
475
+ else if (options.isConclusiveRefusal(error))
476
+ stop("authority-refused");
477
+ else
478
+ retryPull();
345
479
  }
346
480
  finally {
347
481
  draining = false;
@@ -361,6 +495,9 @@ export function subscribeHostedMailbox(options) {
361
495
  const disconnect = () => {
362
496
  const previous = socket;
363
497
  socket = undefined;
498
+ socketOpened = false;
499
+ // A connect that still authenticates is dropped by its generation.
500
+ authenticating = false;
364
501
  connectionGeneration++;
365
502
  ephemeral.length = 0;
366
503
  durable.length = 0;
@@ -383,19 +520,55 @@ export function subscribeHostedMailbox(options) {
383
520
  /* Already closed. */
384
521
  }
385
522
  };
523
+ /**
524
+ * Ends the subscription because the Relay refused it in a way that each
525
+ * reconnect and each pull gets again: `upgrade-required` when the Relay no
526
+ * longer serves the protocol version of this SDK, `device-revoked` or
527
+ * `device-unknown` when the Relay refuses this device, and
528
+ * `authority-refused` after a conclusive refusal of a socket authentication
529
+ * or a pull. No retry
530
+ * follows. Queued acknowledgments are not sent, because the Relay refuses
531
+ * them too. A receipt hand-off that settles after the stop is not
532
+ * acknowledged either. The Relay keeps their messages and receipts, and each
533
+ * queued message gets the reply `receipted` false.
534
+ */
535
+ const stop = (reason) => {
536
+ if (!active)
537
+ return;
538
+ active = false;
539
+ refused = true;
540
+ const unsent = acknowledgments.splice(0);
541
+ receiptAcknowledgments.length = 0;
542
+ for (const messageId of unsent)
543
+ options.onAcknowledgmentReply(messageId, false);
544
+ clearTimeout(retryTimer);
545
+ retryTimer = undefined;
546
+ retryDue = undefined;
547
+ recoveryDue = undefined;
548
+ clearTimeout(acknowledgmentTimer);
549
+ acknowledgmentTimer = undefined;
550
+ disconnect();
551
+ options.onConnectionState("stopped", reason);
552
+ };
386
553
  const retryConnection = (reason) => {
387
- if (!active || reconnectTimer !== undefined)
554
+ if (!active)
388
555
  return;
556
+ const replayed = socketOpened;
389
557
  disconnect();
390
558
  options.onConnectionState("reconnecting", reason);
391
- // One recovery pull per reconnect attempt, paced by the reconnect backoff.
392
- recoverLater();
393
- const delay = Math.floor(Math.random() * reconnectDelay);
394
- reconnectDelay = Math.min(MAXIMUM_RECONNECT_MILLISECONDS, reconnectDelay * 2);
395
- reconnectTimer = setTimeout(() => {
396
- reconnectTimer = undefined;
397
- void connect();
398
- }, delay);
559
+ if (!outage) {
560
+ // One recovery pull per reconnect attempt, drawn before the wait.
561
+ recoverLater();
562
+ }
563
+ else if (reason !== "authentication" && !replayed) {
564
+ // In an outage, a socket attempt that fails before it opens pulls at
565
+ // once, on the retry schedule. A socket that opened replayed the
566
+ // retained work. A pull after a failed authentication would fail on
567
+ // the same device token.
568
+ pullOwed = false;
569
+ requestPull();
570
+ }
571
+ scheduleRetry();
399
572
  };
400
573
  const queueDurable = (candidate, message) => {
401
574
  const envelope = options.decodeDurable(message);
@@ -425,14 +598,19 @@ export function subscribeHostedMailbox(options) {
425
598
  const connect = async () => {
426
599
  const generation = ++connectionGeneration;
427
600
  let authenticated = false;
601
+ authenticating = true;
428
602
  try {
429
603
  const authority = await options.authenticate();
430
604
  authenticated = true;
431
605
  if (!active || generation !== connectionGeneration)
432
606
  return;
607
+ authenticating = false;
608
+ // A new device token shows that the Relay serves this device again.
609
+ if (authority.refreshed)
610
+ endOutage();
433
611
  const candidate = new WebSocket(authority.url, [
434
- MAILBOX_PROTOCOL,
435
- `${AUTH_PROTOCOL_PREFIX}${authority.token}`,
612
+ RELAY_PROTOCOL_TOKEN,
613
+ `${RELAY_AUTH_PROTOCOL_PREFIX}${authority.token}`,
436
614
  ]);
437
615
  socket = candidate;
438
616
  const current = () => active && socket === candidate;
@@ -443,7 +621,7 @@ export function subscribeHostedMailbox(options) {
443
621
  candidate.addEventListener("open", () => {
444
622
  if (!current())
445
623
  return;
446
- if (candidate.protocol !== MAILBOX_PROTOCOL) {
624
+ if (candidate.protocol !== RELAY_PROTOCOL_TOKEN) {
447
625
  retryConnection("protocol");
448
626
  return;
449
627
  }
@@ -456,8 +634,10 @@ export function subscribeHostedMailbox(options) {
456
634
  // a failed message remains. This pull is scheduled before the replay
457
635
  // arrives, so it can find an empty page when the replay handles the
458
636
  // last failed message.
459
- clearTimeout(recoveryTimer);
460
- recoveryTimer = undefined;
637
+ socketOpened = true;
638
+ recoveryDue = undefined;
639
+ pullOwed = false;
640
+ armRetryTimer();
461
641
  failedWorkRecoveryDelay = RECOVERY_MILLISECONDS;
462
642
  if (failedMessages.size > 0)
463
643
  recoverFailedWork();
@@ -501,7 +681,7 @@ export function subscribeHostedMailbox(options) {
501
681
  if (event.data === "pong") {
502
682
  unansweredPings = 0;
503
683
  // The socket stayed open and the Relay answers it.
504
- reconnectDelay = FIRST_RECONNECT_MILLISECONDS;
684
+ endOutage();
505
685
  return;
506
686
  }
507
687
  const frame = JSON.parse(event.data);
@@ -554,6 +734,15 @@ export function subscribeHostedMailbox(options) {
554
734
  candidate.addEventListener("close", (event) => {
555
735
  if (!current())
556
736
  return;
737
+ if (event.code === UPGRADE_REQUIRED_CLOSE_CODE &&
738
+ event.reason === UPGRADE_REQUIRED_CLOSE_REASON) {
739
+ stop("upgrade-required");
740
+ return;
741
+ }
742
+ // A close 4400 with the reason `PROTOCOL_UNSUPPORTED` takes the
743
+ // retry below. The Relay sends it for a version above the newest one
744
+ // that it serves, which happens only after a Relay rollback. The
745
+ // version comes back when the newer Relay does, so the socket retries.
557
746
  if (event.code === POLICY_VIOLATION_CLOSE_CODE)
558
747
  rejectPresence(new HostedRelayPresenceError("FRAME_REJECTED", "The Relay closed the mailbox socket on a refused frame", false));
559
748
  retryConnection("closed");
@@ -563,9 +752,21 @@ export function subscribeHostedMailbox(options) {
563
752
  retryConnection("error");
564
753
  });
565
754
  }
566
- catch {
567
- if (active && generation === connectionGeneration)
755
+ catch (error) {
756
+ if (!active || generation !== connectionGeneration)
757
+ return;
758
+ authenticating = false;
759
+ const refusal = relayRefusalReason(error);
760
+ if (refusal !== undefined)
761
+ stop(refusal);
762
+ else if (options.isConclusiveRefusal(error))
763
+ stop("authority-refused");
764
+ else {
765
+ // A failed socket authentication is a failed Relay request.
766
+ if (!authenticated)
767
+ outage = true;
568
768
  retryConnection(authenticated ? "error" : "authentication");
769
+ }
569
770
  }
570
771
  };
571
772
  options.onConnectionState("connecting");
@@ -623,8 +824,8 @@ export function subscribeHostedMailbox(options) {
623
824
  return;
624
825
  flushAcknowledgments();
625
826
  active = false;
626
- clearTimeout(reconnectTimer);
627
- clearTimeout(recoveryTimer);
827
+ clearTimeout(retryTimer);
828
+ retryTimer = undefined;
628
829
  disconnect();
629
830
  options.onConnectionState("stopped");
630
831
  },