agl 43.6.0 → 43.8.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 (166) hide show
  1. package/changelog.md +27 -0
  2. package/dist_serve/bundle.js +1801 -1783
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/aglapi/interfaces.d.ts +35 -0
  6. package/dist_ts/aglapi/interfaces.js +9 -1
  7. package/dist_ts/classes.accountsactions.d.ts +3 -1
  8. package/dist_ts/classes.accountsactions.js +17 -1
  9. package/dist_ts/classes.apnsclient.d.ts +97 -0
  10. package/dist_ts/classes.apnsclient.js +363 -0
  11. package/dist_ts/classes.authmodels.js +19 -6
  12. package/dist_ts/classes.authstore.js +15 -2
  13. package/dist_ts/classes.cli.js +8 -1
  14. package/dist_ts/classes.controller.d.ts +33 -6
  15. package/dist_ts/classes.controller.js +254 -12
  16. package/dist_ts/classes.controllerdevices.d.ts +35 -7
  17. package/dist_ts/classes.controllerdevices.js +86 -13
  18. package/dist_ts/classes.controllerpush.d.ts +111 -0
  19. package/dist_ts/classes.controllerpush.js +299 -0
  20. package/dist_ts/classes.fcmclient.d.ts +78 -0
  21. package/dist_ts/classes.fcmclient.js +278 -0
  22. package/dist_ts/classes.inbox.d.ts +10 -2
  23. package/dist_ts/classes.inbox.js +9 -2
  24. package/dist_ts/classes.inferencerouter.d.ts +21 -3
  25. package/dist_ts/classes.inferencerouter.js +40 -17
  26. package/dist_ts/classes.inferenceservice.js +2 -2
  27. package/dist_ts/classes.mcpclient.d.ts +5 -0
  28. package/dist_ts/classes.mcpclient.js +18 -6
  29. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
  30. package/dist_ts/classes.mcpcontrollerhost.js +19 -1
  31. package/dist_ts/classes.mcpvalidation.js +4 -1
  32. package/dist_ts/classes.mcpworkercaller.d.ts +6 -0
  33. package/dist_ts/classes.mcpworkercaller.js +26 -4
  34. package/dist_ts/classes.pushdelivery.d.ts +115 -0
  35. package/dist_ts/classes.pushdelivery.js +311 -0
  36. package/dist_ts/classes.pushhandover.d.ts +46 -0
  37. package/dist_ts/classes.pushhandover.js +131 -0
  38. package/dist_ts/classes.pushregistrations.d.ts +96 -0
  39. package/dist_ts/classes.pushregistrations.js +263 -0
  40. package/dist_ts/classes.pushsettings.d.ts +125 -0
  41. package/dist_ts/classes.pushsettings.js +377 -0
  42. package/dist_ts/classes.workercallers.d.ts +73 -2
  43. package/dist_ts/classes.workercallers.js +354 -43
  44. package/dist_ts/driver/classes.directreports.d.ts +5 -0
  45. package/dist_ts/driver/classes.directreports.js +3 -2
  46. package/dist_ts/fleet/classes.workerlaunches.d.ts +6 -4
  47. package/dist_ts/fleet/classes.workerlaunches.js +10 -9
  48. package/dist_ts/fleet/classes.workers.d.ts +12 -2
  49. package/dist_ts/fleet/classes.workers.js +82 -2
  50. package/dist_ts/functions.deviceapi.d.ts +23 -3
  51. package/dist_ts/functions.deviceapi.js +41 -3
  52. package/dist_ts/functions.inferencecli.js +2 -1
  53. package/dist_ts/functions.pushcli.d.ts +43 -0
  54. package/dist_ts/functions.pushcli.js +201 -0
  55. package/dist_ts/functions.pushcredentials.d.ts +53 -0
  56. package/dist_ts/functions.pushcredentials.js +111 -0
  57. package/dist_ts/functions.pushwire.d.ts +8 -0
  58. package/dist_ts/functions.pushwire.js +83 -0
  59. package/dist_ts/functions.remotecli.d.ts +2 -2
  60. package/dist_ts/functions.remotecli.js +4 -4
  61. package/dist_ts/functions.workercallervalidation.js +3 -2
  62. package/dist_ts/functions.workerprocessproof.d.ts +12 -0
  63. package/dist_ts/functions.workerprocessproof.js +32 -1
  64. package/dist_ts/interfaces.auth.d.ts +27 -3
  65. package/dist_ts/interfaces.auth.js +10 -1
  66. package/dist_ts/interfaces.lifecycle.d.ts +7 -1
  67. package/dist_ts/interfaces.push.d.ts +69 -0
  68. package/dist_ts/interfaces.push.js +25 -0
  69. package/dist_ts/plugins.d.ts +5 -2
  70. package/dist_ts/plugins.js +7 -3
  71. package/dist_ts_authswitch/authority-contract.d.ts +26 -0
  72. package/dist_ts_authswitch/authority-contract.js +1 -1
  73. package/dist_ts_authswitch/authority-overview.d.ts +8 -0
  74. package/dist_ts_authswitch/authority-overview.js +10 -4
  75. package/dist_ts_authswitch/authority-placement.d.ts +16 -9
  76. package/dist_ts_authswitch/authority-placement.js +10 -7
  77. package/dist_ts_authswitch/authority-priority.d.ts +20 -0
  78. package/dist_ts_authswitch/authority-priority.js +21 -0
  79. package/dist_ts_authswitch/classes.authoritybroker.d.ts +7 -0
  80. package/dist_ts_authswitch/classes.authoritybroker.js +26 -2
  81. package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
  82. package/dist_ts_authswitch/classes.authoritycli.js +43 -3
  83. package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
  84. package/dist_ts_authswitch/classes.authorityclient.js +12 -4
  85. package/dist_ts_authswitch/classes.authoritydaemon.js +7 -1
  86. package/dist_ts_authswitch/classes.authoritydatabase.d.ts +6 -0
  87. package/dist_ts_authswitch/classes.authoritydatabase.js +13 -2
  88. package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
  89. package/dist_ts_authswitch/classes.authoritymodels.js +17 -8
  90. package/dist_ts_interfaces/devices.d.ts +178 -2
  91. package/dist_ts_interfaces/devices.js +24 -2
  92. package/dist_ts_interfaces/index.d.ts +1 -0
  93. package/dist_ts_interfaces/index.js +2 -1
  94. package/dist_ts_interfaces/mcprequests.d.ts +3 -2
  95. package/dist_ts_interfaces/mcprequests.js +3 -1
  96. package/dist_ts_interfaces/push.d.ts +166 -0
  97. package/dist_ts_interfaces/push.js +24 -0
  98. package/dist_ts_interfaces/requests.accounts.d.ts +19 -0
  99. package/dist_ts_interfaces/requests.accounts.js +1 -1
  100. package/dist_ts_interfaces/requests.d.ts +2 -2
  101. package/dist_ts_interfaces/requests.js +1 -1
  102. package/dist_ts_interfaces/workercallers.d.ts +43 -3
  103. package/docs/authswitch.md +25 -0
  104. package/package.json +1 -1
  105. package/readme.md +93 -16
  106. package/ts/00_commitinfo_data.ts +1 -1
  107. package/ts/aglapi/interfaces.ts +8 -0
  108. package/ts/classes.accountsactions.ts +25 -0
  109. package/ts/classes.apnsclient.ts +389 -0
  110. package/ts/classes.authmodels.ts +21 -5
  111. package/ts/classes.authstore.ts +14 -1
  112. package/ts/classes.cli.ts +7 -0
  113. package/ts/classes.controller.ts +277 -10
  114. package/ts/classes.controllerdevices.ts +94 -12
  115. package/ts/classes.controllerpush.ts +351 -0
  116. package/ts/classes.fcmclient.ts +292 -0
  117. package/ts/classes.inbox.ts +13 -2
  118. package/ts/classes.inferencerouter.ts +61 -16
  119. package/ts/classes.inferenceservice.ts +1 -1
  120. package/ts/classes.mcpclient.ts +20 -5
  121. package/ts/classes.mcpcontrollerhost.ts +20 -0
  122. package/ts/classes.mcpvalidation.ts +2 -0
  123. package/ts/classes.mcpworkercaller.ts +24 -2
  124. package/ts/classes.pushdelivery.ts +378 -0
  125. package/ts/classes.pushhandover.ts +98 -0
  126. package/ts/classes.pushregistrations.ts +244 -0
  127. package/ts/classes.pushsettings.ts +428 -0
  128. package/ts/classes.workercallers.ts +329 -37
  129. package/ts/driver/classes.directreports.ts +7 -1
  130. package/ts/fleet/classes.workerlaunches.ts +9 -7
  131. package/ts/fleet/classes.workers.ts +65 -2
  132. package/ts/functions.deviceapi.ts +52 -2
  133. package/ts/functions.inferencecli.ts +1 -0
  134. package/ts/functions.pushcli.ts +212 -0
  135. package/ts/functions.pushcredentials.ts +129 -0
  136. package/ts/functions.pushwire.ts +106 -0
  137. package/ts/functions.remotecli.ts +3 -2
  138. package/ts/functions.workercallervalidation.ts +2 -1
  139. package/ts/functions.workerprocessproof.ts +34 -0
  140. package/ts/interfaces.auth.ts +27 -3
  141. package/ts/interfaces.lifecycle.ts +7 -1
  142. package/ts/interfaces.push.ts +78 -0
  143. package/ts/plugins.ts +6 -1
  144. package/ts_authswitch/authority-contract.ts +21 -0
  145. package/ts_authswitch/authority-overview.ts +19 -5
  146. package/ts_authswitch/authority-placement.ts +18 -10
  147. package/ts_authswitch/authority-priority.ts +25 -0
  148. package/ts_authswitch/classes.authoritybroker.ts +26 -1
  149. package/ts_authswitch/classes.authoritycli.ts +48 -2
  150. package/ts_authswitch/classes.authorityclient.ts +14 -4
  151. package/ts_authswitch/classes.authoritydaemon.ts +8 -1
  152. package/ts_authswitch/classes.authoritydatabase.ts +11 -1
  153. package/ts_authswitch/classes.authoritymodels.ts +17 -6
  154. package/ts_authswitch/readme.md +1 -1
  155. package/ts_interfaces/devices.schema.json +327 -0
  156. package/ts_interfaces/devices.ts +206 -1
  157. package/ts_interfaces/index.ts +1 -0
  158. package/ts_interfaces/mcprequests.ts +3 -0
  159. package/ts_interfaces/push.ts +162 -0
  160. package/ts_interfaces/requests.accounts.ts +17 -0
  161. package/ts_interfaces/requests.ts +2 -0
  162. package/ts_interfaces/workercallers.ts +34 -2
  163. package/ts_web/00_commitinfo_data.ts +1 -1
  164. package/ts_web/accounts.plugins.ts +4 -2
  165. package/ts_web/classes.accountsreadmodel.ts +36 -2
  166. package/ts_web/elements.accounts.ts +48 -0
@@ -0,0 +1,311 @@
1
+ import { pushClockSkewText, pushTestAnswerWaitMs } from '../dist_ts_interfaces/push.js';
2
+ import { ApnsClient } from './classes.apnsclient.js';
3
+ import { FcmClient } from './classes.fcmclient.js';
4
+ const nodeClock = {
5
+ now: () => Date.now(),
6
+ setTimeout: (callbackArg, delayMsArg) => setTimeout(callbackArg, delayMsArg),
7
+ clearTimeout: (handleArg) => clearTimeout(handleArg),
8
+ };
9
+ export const pushDeliveryTimings = Object.freeze({
10
+ /** The first wait after a failure that passes; it doubles with every failure after it. */
11
+ initialBackoffMs: 1000,
12
+ maximumBackoffMs: 5 * 60_000,
13
+ /** A notification older than this is dropped, and Apple and Google are told it expires then. */
14
+ maximumAgeMs: 60 * 60_000,
15
+ /** Past this many notifications for one device, the oldest is dropped. */
16
+ maximumQueuedPerDevice: 64,
17
+ });
18
+ /** The key a queued notification is replaced by: an item's key, or the keys a `clear` names. */
19
+ const queueKey = (payloadArg) => (payloadArg.type === 'clear' ? `clear ${payloadArg.keys}` : payloadArg.key);
20
+ const platformNames = { apns: 'APNs', fcm: 'FCM' };
21
+ const retryable = (outcomeArg) => (outcomeArg === 'rate_limited' || outcomeArg === 'service_failed' || outcomeArg === 'unreachable');
22
+ export class ControllerPushDelivery {
23
+ options;
24
+ clock;
25
+ queues = new Map();
26
+ senders = new Map();
27
+ lastFailures = new Map();
28
+ platformFailures = new Map();
29
+ attempts = new Map();
30
+ /** Drains, attempts and sender closes still running: `stop` waits for them. */
31
+ running = new Set();
32
+ abort = new AbortController();
33
+ unsubscribe;
34
+ stopping;
35
+ constructor(options) {
36
+ this.options = options;
37
+ this.clock = options.clock ?? nodeClock;
38
+ // A credential set, removed or refused: the platform's sender goes, and the next send makes one for what is held.
39
+ this.unsubscribe = options.settings.onChange((platformArg) => this.dropSender(platformArg));
40
+ }
41
+ /** Whether the host can send on the platform now: it holds a credential Apple or Google did not refuse. */
42
+ available(platformArg) {
43
+ return this.stopping === undefined && this.options.settings.ready(platformArg);
44
+ }
45
+ /** The last notification to the device that did not go out, while none went out after it. */
46
+ lastFailure(deviceIdArg) {
47
+ return this.lastFailures.get(deviceIdArg);
48
+ }
49
+ /** The platform's last failed send, with the push service's code (`agl push status`). */
50
+ platformFailure(platformArg) {
51
+ return this.platformFailures.get(platformArg);
52
+ }
53
+ /**
54
+ * Queues a notification for the device and returns at once. Nothing is queued while the host cannot send on the
55
+ * device's platform; a notification with a key already queued replaces that one.
56
+ */
57
+ send(targetArg, payloadArg) {
58
+ if (!this.available(targetArg.platform))
59
+ return;
60
+ let queue = this.queues.get(targetArg.deviceId);
61
+ if (!queue) {
62
+ queue = { entries: new Map(), failures: 0, running: false };
63
+ this.queues.set(targetArg.deviceId, queue);
64
+ }
65
+ const key = queueKey(payloadArg);
66
+ queue.entries.delete(key);
67
+ queue.entries.set(key, { target: { ...targetArg }, payload: payloadArg, enqueuedAt: this.clock.now() });
68
+ while (queue.entries.size > pushDeliveryTimings.maximumQueuedPerDevice)
69
+ queue.entries.delete(queue.entries.keys().next().value);
70
+ if (!queue.running && queue.timer === undefined)
71
+ queueMicrotask(() => this.track(this.drain(targetArg.deviceId)));
72
+ }
73
+ /** Drops the device's queued notifications with these keys (items that left the Inbox before they went out). */
74
+ withdraw(deviceIdArg, keysArg) {
75
+ const queue = this.queues.get(deviceIdArg);
76
+ if (!queue)
77
+ return;
78
+ for (const key of keysArg)
79
+ queue.entries.delete(key);
80
+ if (queue.entries.size === 0)
81
+ this.dropQueue(deviceIdArg);
82
+ }
83
+ /**
84
+ * Drops everything queued for the device and its last failure: it was revoked or ended its registration. An attempt
85
+ * still in flight for it no longer records a failure for it.
86
+ */
87
+ forget(deviceIdArg) {
88
+ this.dropQueue(deviceIdArg);
89
+ this.lastFailures.delete(deviceIdArg);
90
+ for (const ticket of this.attempts.get(deviceIdArg) ?? [])
91
+ ticket.forgotten = true;
92
+ }
93
+ /**
94
+ * One attempt now, outside the queue, answering what the push service said (`agl push test`), or `no_answer` once
95
+ * `waitMsArg` passed without an answer: the attempt goes on, and its outcome counts as any other's.
96
+ */
97
+ async deliver(targetArg, payloadArg, waitMsArg = pushTestAnswerWaitMs) {
98
+ if (!this.available(targetArg.platform))
99
+ return { outcome: 'unavailable' };
100
+ const attempt = this.attempt(targetArg, payloadArg, this.clock.now() + pushDeliveryTimings.maximumAgeMs);
101
+ this.track(attempt);
102
+ let timer;
103
+ const waited = new Promise((resolve) => {
104
+ timer = this.clock.setTimeout(() => resolve({ outcome: 'no_answer' }), waitMsArg);
105
+ });
106
+ try {
107
+ const answer = await Promise.race([attempt, waited]);
108
+ return { outcome: answer.outcome, ...(answer.vendorReason === undefined ? {} : { vendorReason: answer.vendorReason }) };
109
+ }
110
+ finally {
111
+ this.clock.clearTimeout(timer);
112
+ }
113
+ }
114
+ /** How many notifications wait for the device, and whether a retry is armed for it. For tests. */
115
+ queued(deviceIdArg) {
116
+ const queue = this.queues.get(deviceIdArg);
117
+ return { count: queue?.entries.size ?? 0, retrying: queue?.timer !== undefined };
118
+ }
119
+ /** Whether nothing runs: no queue, timer, attempt or connection. For tests. */
120
+ idle() {
121
+ return this.queues.size === 0 && this.running.size === 0 && this.senders.size === 0;
122
+ }
123
+ /**
124
+ * Stops for good: every timer cleared, every queue dropped, every request aborted and every connection closed before
125
+ * it resolves. Never rejects; a second call waits for the first.
126
+ */
127
+ stop() {
128
+ this.stopping ??= (async () => {
129
+ this.unsubscribe();
130
+ for (const deviceId of [...this.queues.keys()])
131
+ this.dropQueue(deviceId);
132
+ this.abort.abort();
133
+ for (const platform of [...this.senders.keys()])
134
+ this.dropSender(platform);
135
+ while (this.running.size > 0)
136
+ await Promise.allSettled([...this.running]);
137
+ })();
138
+ return this.stopping;
139
+ }
140
+ track(promiseArg) {
141
+ const tracked = promiseArg.catch((errorArg) => { this.options.fault(errorArg); });
142
+ this.running.add(tracked);
143
+ void tracked.finally(() => { this.running.delete(tracked); });
144
+ }
145
+ dropQueue(deviceIdArg) {
146
+ const queue = this.queues.get(deviceIdArg);
147
+ if (!queue)
148
+ return;
149
+ if (queue.timer !== undefined)
150
+ this.clock.clearTimeout(queue.timer);
151
+ queue.timer = undefined;
152
+ queue.entries.clear();
153
+ if (!queue.running)
154
+ this.queues.delete(deviceIdArg);
155
+ }
156
+ dropSender(platformArg) {
157
+ const held = this.senders.get(platformArg);
158
+ if (!held)
159
+ return;
160
+ this.senders.delete(platformArg);
161
+ this.track(held.sender.close());
162
+ }
163
+ /** The platform's sender for the credential held now; none while the host holds no usable one. */
164
+ sender(platformArg) {
165
+ if (this.stopping !== undefined)
166
+ return undefined;
167
+ const { settings, endpoints } = this.options;
168
+ const common = { ...(endpoints === undefined ? {} : { endpoints }), now: () => this.clock.now() };
169
+ const credential = platformArg === 'apns' ? settings.apnsCredential() : settings.fcmCredential();
170
+ if (!credential)
171
+ return undefined;
172
+ const held = this.senders.get(platformArg);
173
+ if (held?.generation === credential.generation)
174
+ return held;
175
+ if (held)
176
+ this.dropSender(platformArg);
177
+ const created = {
178
+ generation: credential.generation,
179
+ sender: 'keyId' in credential ? new ApnsClient({ credential, ...common }) : new FcmClient({ credential, ...common }),
180
+ };
181
+ this.senders.set(platformArg, created);
182
+ return created;
183
+ }
184
+ /** One send, and what its outcome means for the registration, the device's state and the platform. */
185
+ async attempt(targetArg, payloadArg, expiresAtArg) {
186
+ const ticket = { forgotten: false };
187
+ const tickets = this.attempts.get(targetArg.deviceId) ?? new Set();
188
+ tickets.add(ticket);
189
+ this.attempts.set(targetArg.deviceId, tickets);
190
+ try {
191
+ return await this.attemptOnce(targetArg, payloadArg, expiresAtArg, ticket);
192
+ }
193
+ finally {
194
+ tickets.delete(ticket);
195
+ if (tickets.size === 0 && this.attempts.get(targetArg.deviceId) === tickets)
196
+ this.attempts.delete(targetArg.deviceId);
197
+ }
198
+ }
199
+ async attemptOnce(targetArg, payloadArg, expiresAtArg, ticketArg) {
200
+ const held = this.sender(targetArg.platform);
201
+ if (!held)
202
+ return { outcome: 'unavailable' };
203
+ let result;
204
+ try {
205
+ result = await held.sender.send(targetArg, payloadArg, expiresAtArg, this.abort.signal);
206
+ }
207
+ catch (errorArg) {
208
+ this.options.fault(errorArg);
209
+ result = { outcome: 'service_failed' };
210
+ }
211
+ const attempt = {
212
+ outcome: result.outcome,
213
+ ...(result.outcome !== 'delivered' && result.vendorReason !== undefined ? { vendorReason: result.vendorReason } : {}),
214
+ ...('retryAfterMs' in result && result.retryAfterMs !== undefined ? { retryAfterMs: result.retryAfterMs } : {}),
215
+ };
216
+ if (this.stopping !== undefined)
217
+ return attempt;
218
+ const at = this.clock.now();
219
+ if (result.outcome === 'delivered') {
220
+ this.lastFailures.delete(targetArg.deviceId);
221
+ return attempt;
222
+ }
223
+ if (result.outcome === 'unregistered') {
224
+ this.forget(targetArg.deviceId);
225
+ try {
226
+ await this.options.unregistered(targetArg.deviceId, targetArg.token);
227
+ }
228
+ catch (errorArg) {
229
+ this.options.fault(errorArg);
230
+ }
231
+ return attempt;
232
+ }
233
+ // A device forgotten while the attempt ran (revoked, or its registration ended) keeps no failure.
234
+ if (!ticketArg.forgotten)
235
+ this.lastFailures.set(targetArg.deviceId, { at, reason: result.outcome });
236
+ const clockSkewMs = 'clockSkewMs' in result ? result.clockSkewMs : undefined;
237
+ const previous = this.platformFailures.get(targetArg.platform);
238
+ this.platformFailures.set(targetArg.platform, { at, reason: result.outcome,
239
+ ...(attempt.vendorReason === undefined ? {} : { vendorReason: attempt.vendorReason }),
240
+ ...(clockSkewMs === undefined ? {} : { clockSkewMs }) });
241
+ // The host's clock, not the credential: named once when the refusals for it begin, and in `agl push status` throughout.
242
+ if (clockSkewMs !== undefined && previous?.clockSkewMs === undefined) {
243
+ this.options.fault(new Error(`${platformNames[targetArg.platform]} refused (${attempt.vendorReason ?? 'no code'}) while the push service's `
244
+ + `clock and the host's were ${pushClockSkewText(clockSkewMs)}: the credential is kept and the send is tried again. `
245
+ + 'Set the host\'s clock right (NTP).'));
246
+ }
247
+ if (result.outcome === 'credential_refused') {
248
+ // The platform stops: its queues go, and the settings keep the refusal until the owner sets the credential again.
249
+ for (const [deviceId, queue] of [...this.queues]) {
250
+ const first = queue.entries.values().next().value;
251
+ if (first?.target.platform === targetArg.platform)
252
+ this.dropQueue(deviceId);
253
+ }
254
+ try {
255
+ await this.options.settings.refuse(targetArg.platform, held.generation, attempt.vendorReason);
256
+ }
257
+ catch (errorArg) {
258
+ this.options.fault(errorArg);
259
+ }
260
+ this.dropSender(targetArg.platform);
261
+ }
262
+ return attempt;
263
+ }
264
+ /** Sends the device's queue in order until it is empty, or a failure that passes arms the retry. */
265
+ async drain(deviceIdArg) {
266
+ const queue = this.queues.get(deviceIdArg);
267
+ if (!queue || queue.running || queue.timer !== undefined)
268
+ return;
269
+ queue.running = true;
270
+ try {
271
+ while (this.stopping === undefined && this.queues.get(deviceIdArg) === queue) {
272
+ const now = this.clock.now();
273
+ for (const [key, entry] of queue.entries) {
274
+ if (now - entry.enqueuedAt >= pushDeliveryTimings.maximumAgeMs)
275
+ queue.entries.delete(key);
276
+ }
277
+ const next = queue.entries.entries().next();
278
+ if (next.done)
279
+ break;
280
+ const [key, entry] = next.value;
281
+ const attempt = await this.attempt(entry.target, entry.payload, entry.enqueuedAt + pushDeliveryTimings.maximumAgeMs);
282
+ if (this.stopping !== undefined || this.queues.get(deviceIdArg) !== queue)
283
+ break;
284
+ if (retryable(attempt.outcome)) {
285
+ queue.failures += 1;
286
+ const backoff = Math.min(pushDeliveryTimings.initialBackoffMs * 2 ** Math.min(queue.failures - 1, 30), pushDeliveryTimings.maximumBackoffMs);
287
+ // A service that asked for a longer wait (Retry-After) gets it; what is an hour old by then is dropped.
288
+ const delay = Math.max(backoff, attempt.retryAfterMs ?? 0);
289
+ queue.timer = this.clock.setTimeout(() => {
290
+ queue.timer = undefined;
291
+ this.track(this.drain(deviceIdArg));
292
+ }, delay);
293
+ break;
294
+ }
295
+ // Gone (delivered, refused for good, the credential or the registration gone): a newer one under the key stays.
296
+ if (queue.entries.get(key) === entry)
297
+ queue.entries.delete(key);
298
+ if (attempt.outcome === 'unavailable')
299
+ queue.entries.clear();
300
+ else
301
+ queue.failures = 0;
302
+ }
303
+ }
304
+ finally {
305
+ queue.running = false;
306
+ if (queue.entries.size === 0 && queue.timer === undefined && this.queues.get(deviceIdArg) === queue)
307
+ this.queues.delete(deviceIdArg);
308
+ }
309
+ }
310
+ }
311
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5wdXNoZGVsaXZlcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLnB1c2hkZWxpdmVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsb0JBQW9CLEVBQTJCLE1BQU0sMEJBQTBCLENBQUM7QUFDNUcsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3JELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQW9CbkQsTUFBTSxTQUFTLEdBQXVCO0lBQ3BDLEdBQUcsRUFBRSxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFO0lBQ3JCLFVBQVUsRUFBRSxDQUFDLFdBQVcsRUFBRSxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxXQUFXLEVBQUUsVUFBVSxDQUFDO0lBQzVFLFlBQVksRUFBRSxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUMsWUFBWSxDQUFDLFNBQTJCLENBQUM7Q0FDdkUsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDL0MsMEZBQTBGO0lBQzFGLGdCQUFnQixFQUFFLElBQUk7SUFDdEIsZ0JBQWdCLEVBQUUsQ0FBQyxHQUFHLE1BQU07SUFDNUIsZ0dBQWdHO0lBQ2hHLFlBQVksRUFBRSxFQUFFLEdBQUcsTUFBTTtJQUN6QiwwRUFBMEU7SUFDMUUsc0JBQXNCLEVBQUUsRUFBRTtDQUMzQixDQUFDLENBQUM7QUFpRUgsZ0dBQWdHO0FBQ2hHLE1BQU0sUUFBUSxHQUFHLENBQUMsVUFBMkIsRUFBVSxFQUFFLENBQUMsQ0FBQyxVQUFVLENBQUMsSUFBSSxLQUFLLE9BQU8sQ0FBQyxDQUFDLENBQUMsU0FBUyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUV0SSxNQUFN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
@@ -0,0 +1,46 @@
1
+ import * as plugins from './plugins.js';
2
+ /**
3
+ * The push trigger's clean-stop handover (AGL-1639): the Inbox items it announced that still waited when the controller
4
+ * stopped cleanly, and the pairs the handover it started from named that it had not met yet, by id and `since`, so the
5
+ * next start does not alert again for the same waits. One document per controller in `agl_controller_push_handover`,
6
+ * `{ id, announced }`, its top level fixed for good. `ControllerPush.stop` writes both in it, whole, once (an announced
7
+ * pair wins over a handed-over one with the same id); nothing is written while the controller runs. The next start reads
8
+ * it once and deletes it, so a controller killed later leaves none and its next start announces what waits once more
9
+ * under the same keys. An older controller has no model for the collection and never reads it.
10
+ */
11
+ /** One announced item: its Inbox id and the `since` it was announced with. */
12
+ export interface IPushHandoverEntry {
13
+ id: string;
14
+ since: number;
15
+ }
16
+ export interface IControllerPushHandoverDocument {
17
+ /** `controller:<port>`. */
18
+ id: string;
19
+ /** Newest `since` first. */
20
+ announced: IPushHandoverEntry[];
21
+ }
22
+ /**
23
+ * At most `entries` items are handed over (the Inbox lists at most 200), the newest by `since` when there are more; an
24
+ * item whose id is longer than `idBytes` UTF-8 bytes is left out and announced again. A document is read with up to
25
+ * `readEntries` entries, so one a later release wrote with more is still read and deleted.
26
+ */
27
+ export declare const pushHandoverLimits: {
28
+ readonly entries: 200;
29
+ readonly idBytes: 1024;
30
+ readonly readEntries: 1000;
31
+ readonly documentBytes: number;
32
+ };
33
+ export declare class ControllerPushHandoverModel extends plugins.nosqldb.SmartDataDbDoc<ControllerPushHandoverModel, IControllerPushHandoverDocument> {
34
+ static exact: plugins.nosqldb.TExact<ControllerPushHandoverModel>;
35
+ id: string;
36
+ announced: IPushHandoverEntry[];
37
+ }
38
+ /** What a stop hands over of `announcedArg` (item id to `since`): at most 200, newest `since` first, then by id. */
39
+ export declare const pushHandoverEntries: (announcedArg: ReadonlyMap<string, number>) => IPushHandoverEntry[];
40
+ /**
41
+ * Reads the controller's handover and deletes it: what the last clean stop announced, item id to `since`, or none when
42
+ * no clean stop left one. Throws when the document does not read or could not be deleted; it is then not used.
43
+ */
44
+ export declare const takePushHandover: (controllerIdArg: string) => Promise<ReadonlyMap<string, number> | undefined>;
45
+ /** Writes the controller's handover whole: what `announcedArg` names (`pushHandoverEntries`), replacing any there. */
46
+ export declare const keepPushHandover: (controllerIdArg: string, announcedArg: ReadonlyMap<string, number>) => Promise<void>;
@@ -0,0 +1,131 @@
1
+ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
2
+ function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
3
+ var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
4
+ var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
5
+ var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
6
+ var _, done = false;
7
+ for (var i = decorators.length - 1; i >= 0; i--) {
8
+ var context = {};
9
+ for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
10
+ for (var p in contextIn.access) context.access[p] = contextIn.access[p];
11
+ context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
12
+ var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
13
+ if (kind === "accessor") {
14
+ if (result === void 0) continue;
15
+ if (result === null || typeof result !== "object") throw new TypeError("Object expected");
16
+ if (_ = accept(result.get)) descriptor.get = _;
17
+ if (_ = accept(result.set)) descriptor.set = _;
18
+ if (_ = accept(result.init)) initializers.unshift(_);
19
+ }
20
+ else if (_ = accept(result)) {
21
+ if (kind === "field") initializers.unshift(_);
22
+ else descriptor[key] = _;
23
+ }
24
+ }
25
+ if (target) Object.defineProperty(target, contextIn.name, descriptor);
26
+ done = true;
27
+ };
28
+ var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
29
+ var useValue = arguments.length > 2;
30
+ for (var i = 0; i < initializers.length; i++) {
31
+ value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
32
+ }
33
+ return useValue ? value : void 0;
34
+ };
35
+ import * as plugins from './plugins.js';
36
+ /**
37
+ * At most `entries` items are handed over (the Inbox lists at most 200), the newest by `since` when there are more; an
38
+ * item whose id is longer than `idBytes` UTF-8 bytes is left out and announced again. A document is read with up to
39
+ * `readEntries` entries, so one a later release wrote with more is still read and deleted.
40
+ */
41
+ export const pushHandoverLimits = { entries: 200, idBytes: 1024, readEntries: 1000, documentBytes: 2 * 1024 * 1024 };
42
+ const isPlainObject = (valueArg) => (!!valueArg && typeof valueArg === 'object' && !Array.isArray(valueArg)
43
+ && (Object.getPrototypeOf(valueArg) === Object.prototype || Object.getPrototypeOf(valueArg) === null));
44
+ const assertDocument = (valueArg) => {
45
+ const value = valueArg;
46
+ let size = Number.POSITIVE_INFINITY;
47
+ try {
48
+ size = Buffer.byteLength(JSON.stringify(value?.announced), 'utf8');
49
+ }
50
+ catch { /* refused below */ }
51
+ if (!isPlainObject(value)
52
+ || Object.keys(value).length !== 2
53
+ || typeof value.id !== 'string' || !/^controller:[1-9][0-9]{0,4}$/u.test(value.id)
54
+ || !Array.isArray(value.announced) || value.announced.length > pushHandoverLimits.readEntries
55
+ || !value.announced.every(isPlainObject)
56
+ || size > pushHandoverLimits.documentBytes) {
57
+ throw new Error('Invalid push handover record.');
58
+ }
59
+ };
60
+ let ControllerPushHandoverModel = (() => {
61
+ let _classDecorators = [plugins.nosqldb.managed({ collectionName: 'agl_controller_push_handover' }), plugins.nosqldb.exactPersistence({ assertDocument })];
62
+ let _classDescriptor;
63
+ let _classExtraInitializers = [];
64
+ let _classThis;
65
+ let _classSuper = plugins.nosqldb.SmartDataDbDoc;
66
+ let _id_decorators;
67
+ let _id_initializers = [];
68
+ let _id_extraInitializers = [];
69
+ let _announced_decorators;
70
+ let _announced_initializers = [];
71
+ let _announced_extraInitializers = [];
72
+ var ControllerPushHandoverModel = class extends _classSuper {
73
+ static { _classThis = this; }
74
+ static {
75
+ const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
76
+ _id_decorators = [plugins.nosqldb.unI()];
77
+ _announced_decorators = [plugins.nosqldb.svDb()];
78
+ __esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
79
+ __esDecorate(null, null, _announced_decorators, { kind: "field", name: "announced", static: false, private: false, access: { has: obj => "announced" in obj, get: obj => obj.announced, set: (obj, value) => { obj.announced = value; } }, metadata: _metadata }, _announced_initializers, _announced_extraInitializers);
80
+ __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
81
+ ControllerPushHandoverModel = _classThis = _classDescriptor.value;
82
+ if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
83
+ __runInitializers(_classThis, _classExtraInitializers);
84
+ }
85
+ id = __runInitializers(this, _id_initializers, void 0);
86
+ announced = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _announced_initializers, void 0));
87
+ constructor() {
88
+ super(...arguments);
89
+ __runInitializers(this, _announced_extraInitializers);
90
+ }
91
+ };
92
+ return ControllerPushHandoverModel = _classThis;
93
+ })();
94
+ export { ControllerPushHandoverModel };
95
+ const isEntry = (valueArg) => (isPlainObject(valueArg) && typeof valueArg.id === 'string' && valueArg.id !== ''
96
+ && Buffer.byteLength(valueArg.id, 'utf8') <= pushHandoverLimits.idBytes
97
+ && typeof valueArg.since === 'number' && Number.isFinite(valueArg.since));
98
+ /** What a stop hands over of `announcedArg` (item id to `since`): at most 200, newest `since` first, then by id. */
99
+ export const pushHandoverEntries = (announcedArg) => ([...announcedArg].map(([id, since]) => ({ id, since })).filter(isEntry)
100
+ .sort((leftArg, rightArg) => rightArg.since - leftArg.since || (leftArg.id < rightArg.id ? -1 : leftArg.id > rightArg.id ? 1 : 0))
101
+ .slice(0, pushHandoverLimits.entries));
102
+ /**
103
+ * Reads the controller's handover and deletes it: what the last clean stop announced, item id to `since`, or none when
104
+ * no clean stop left one. Throws when the document does not read or could not be deleted; it is then not used.
105
+ */
106
+ export const takePushHandover = async (controllerIdArg) => {
107
+ const current = await ControllerPushHandoverModel.exact.findStoredOne({ id: controllerIdArg });
108
+ if (!current)
109
+ return undefined;
110
+ const { announced } = ControllerPushHandoverModel.exact.toPersisted(current);
111
+ const deleted = await ControllerPushHandoverModel.exact.delete({ current });
112
+ if (deleted.status !== 'deleted')
113
+ throw new Error('The push handover changed while it was read and was not used.');
114
+ // An entry a later release wrote in another shape is not one of these, and is announced again.
115
+ return new Map(announced.filter(isEntry).map((entryArg) => [entryArg.id, entryArg.since]));
116
+ };
117
+ /** Writes the controller's handover whole: what `announcedArg` names (`pushHandoverEntries`), replacing any there. */
118
+ export const keepPushHandover = async (controllerIdArg, announcedArg) => {
119
+ const announced = pushHandoverEntries(announcedArg);
120
+ const current = await ControllerPushHandoverModel.exact.findStoredOne({ id: controllerIdArg });
121
+ if (!current) {
122
+ const inserted = await ControllerPushHandoverModel.exact.insert({ id: controllerIdArg, announced });
123
+ if (inserted.status !== 'inserted')
124
+ throw new Error('The push handover changed concurrently and was not stored.');
125
+ return;
126
+ }
127
+ const result = await ControllerPushHandoverModel.exact.transition({ current, change: (modelArg) => { modelArg.announced = announced; } });
128
+ if (result.status !== 'transitioned')
129
+ throw new Error('The push handover changed concurrently and was not stored.');
130
+ };
131
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5wdXNoaGFuZG92ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLnB1c2hoYW5kb3Zlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUF5QnhDOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxFQUFFLE9BQU8sRUFBRSxHQUFHLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsSUFBSSxFQUFFLGFBQWEsRUFBRSxDQUFDLEdBQUcsSUFBSSxHQUFHLElBQUksRUFBVyxDQUFDO0FBRTlILE1BQU0sYUFBYSxHQUFHLENBQUMsUUFBaUIsRUFBdUMsRUFBRSxDQUFDLENBQ2hGLENBQUMsQ0FBQyxRQUFRLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUM7T0FDbkUsQ0FBQyxNQUFNLENBQUMsY0FBYyxDQUFDLFFBQVEsQ0FBQyxLQUFLLE1BQU0sQ0FBQyxTQUFTLElBQUksTUFBTSxDQUFDLGNBQWMsQ0FBQyxRQUFRLENBQUMsS0FBSyxJQUFJLENBQUMsQ0FDdEcsQ0FBQztBQUVGLE1BQU0sY0FBYyxHQUErRSxDQUFDLFFBQVEsRUFBRSxFQUFFO0lBQzlHLE1BQU0sS0FBSyxHQUFHLFFBQTJELENBQUM7SUFDMUUsSUFBSSxJQUFJLEdBQUcsTUFBTSxDQUFDLGlCQUFpQixDQUFDO0lBQ3BDLElBQUksQ0FBQztRQUFDLElBQUksR0FBRyxNQUFNLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQUMsQ0FBQztJQUFDLE1BQU0sQ0FBQyxDQUFDLG1CQUFtQixDQUFDLENBQUM7SUFDekcsSUFBSSxD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
@@ -0,0 +1,96 @@
1
+ import * as plugins from './plugins.js';
2
+ import type { TDevicePushEnvironment, TDevicePushPlatform } from '../dist_ts_interfaces/devices.js';
3
+ /**
4
+ * A paired device's registration for notifications (AGL-1639): one document per device, its id the device's. It is
5
+ * its own collection, never a field of the device record, which is exact: an earlier release would refuse a device
6
+ * record that carried one. The token is secret-like: it leaves the controller only to its push service, never in an
7
+ * answer, event, audit entry or log.
8
+ */
9
+ export interface IControllerPushRegistrationDocument {
10
+ /** The device's id. */
11
+ id: string;
12
+ platform: TDevicePushPlatform;
13
+ /** APNs only: the environment the token belongs to. */
14
+ environment?: TDevicePushEnvironment;
15
+ /** The push service's token for the device. */
16
+ token: string;
17
+ /** Whether the device asked for direct report results too. */
18
+ reports: boolean;
19
+ /**
20
+ * 32 random bytes, base64url: the key a notification's collapse key is derived under (HMAC over the item's id). It is
21
+ * made with the registration and kept while it stands, also when the device registers again with another token, so
22
+ * a notification's key stays the same across the host's restarts and the app's registrations.
23
+ */
24
+ salt: string;
25
+ /** Unix milliseconds the registration's platform, token or choices were last set. */
26
+ registeredAt: number;
27
+ }
28
+ /** What a registration says without its token or salt. */
29
+ export type TControllerPushRegistrationState = Pick<IControllerPushRegistrationDocument, 'platform' | 'reports'>;
30
+ /** What a device registers: the registration without its id, salt and time. */
31
+ export type TControllerPushRegistrationRequest = Pick<IControllerPushRegistrationDocument, 'platform' | 'environment' | 'token' | 'reports'>;
32
+ /**
33
+ * A push token as its platform hands it to the app: an APNs device token as lowercase hex of 32 to 100 bytes (Apple
34
+ * states no fixed size), an FCM registration token as 1 to 1024 characters of letters, digits, `_`, `-` and `:`.
35
+ */
36
+ export declare const isDevicePushToken: (platformArg: TDevicePushPlatform, valueArg: unknown) => valueArg is string;
37
+ export declare class ControllerPushRegistrationModel extends plugins.nosqldb.SmartDataDbDoc<ControllerPushRegistrationModel, IControllerPushRegistrationDocument> {
38
+ static exact: plugins.nosqldb.TExact<ControllerPushRegistrationModel>;
39
+ id: string;
40
+ platform: TDevicePushPlatform;
41
+ environment?: TDevicePushEnvironment;
42
+ token: string;
43
+ reports: boolean;
44
+ salt: string;
45
+ registeredAt: number;
46
+ }
47
+ /** A device's registration, without its token or salt; none while it holds none. */
48
+ export declare const readPushRegistration: (deviceIdArg: string) => Promise<TControllerPushRegistrationState | undefined>;
49
+ /**
50
+ * Sets a device's registration: a new one gets a fresh salt, an existing one takes the request's platform, token and
51
+ * choices and keeps its salt; the same request again writes nothing. The caller runs it after the device's record and
52
+ * in the one order of the device's writes, so a revoked device is never registered again.
53
+ */
54
+ export declare const writePushRegistration: (deviceIdArg: string, requestArg: TControllerPushRegistrationRequest, nowArg: number) => Promise<TControllerPushRegistrationState>;
55
+ /**
56
+ * Deletes a device's registration; answers whether there was one. `optionsArg.session` runs it inside the caller's
57
+ * transaction (a revocation, or an origin move that removes the device).
58
+ */
59
+ export declare const deletePushRegistration: (deviceIdArg: string, optionsArg?: plugins.nosqldb.IExactSessionOptions) => Promise<boolean>;
60
+ /**
61
+ * Deletes every registration whose device is gone: one left behind by a write that failed half-way or by an earlier
62
+ * release that revoked a device without knowing registrations. Answers how many it deleted.
63
+ */
64
+ export declare const sweepPushRegistrations: (pairedArg: (deviceIdArg: string) => Promise<boolean>) => Promise<number>;
65
+ /** How many of `deviceIdsArg` hold a registration, per platform (`agl push status`). */
66
+ export declare const countPushRegistrations: (deviceIdsArg: ReadonlySet<string>) => Promise<Record<TDevicePushPlatform, number>>;
67
+ /** A registration as the delivery sends to it, with its token: it never leaves the host but to its push service. */
68
+ export interface IControllerPushTarget {
69
+ deviceId: string;
70
+ platform: TDevicePushPlatform;
71
+ environment?: TDevicePushEnvironment;
72
+ token: string;
73
+ /** Whether the device asked for direct report results too. */
74
+ reports: boolean;
75
+ /** The key a notification's key is made under (`pushNotificationKey`). */
76
+ salt: string;
77
+ }
78
+ /** The registrations of `deviceIdsArg`, with their tokens, in the order of the ids. */
79
+ export declare const readPushTargets: (deviceIdsArg: readonly string[]) => Promise<IControllerPushTarget[]>;
80
+ /**
81
+ * Deletes a device's registration if it still holds `tokenArg`: its push service called that token gone. A registration
82
+ * the device renewed with another token meanwhile stays. Answers whether it deleted one.
83
+ */
84
+ export declare const deletePushRegistrationHolding: (deviceIdArg: string, tokenArg: string) => Promise<boolean>;
85
+ /**
86
+ * What a notification's key is made over besides an Inbox item's id: never an item's id, which holds no control
87
+ * character, so the key of the owner's test notification, of the summary and of a direct report's result never equals
88
+ * an item's. A report's key is over its name: a newer result of the same report replaces the older one.
89
+ */
90
+ export declare const pushKeySubjects: {
91
+ readonly test: '\0test';
92
+ readonly summary: '\0summary';
93
+ readonly report: (nameArg: string) => string;
94
+ };
95
+ /** A notification's key: base64url of HMAC-SHA256 under the registration's salt over `subjectArg` (an item's id). */
96
+ export declare const pushNotificationKey: (saltArg: string, subjectArg: string) => string;