miakapi 3.0.31 → 4.0.0-alpha.1

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 (124) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +372 -0
  3. package/contracts/miakapp-v3.json +6 -0
  4. package/dist/access-token-provider.d.ts +8 -0
  5. package/dist/access-token-provider.d.ts.map +1 -0
  6. package/dist/access-token-provider.js +167 -0
  7. package/dist/access-token-provider.js.map +1 -0
  8. package/dist/api.d.ts +224 -0
  9. package/dist/api.d.ts.map +1 -0
  10. package/dist/api.js +47 -0
  11. package/dist/api.js.map +1 -0
  12. package/dist/browser-api.d.ts +113 -0
  13. package/dist/browser-api.d.ts.map +1 -0
  14. package/dist/browser-api.js +2 -0
  15. package/dist/browser-api.js.map +1 -0
  16. package/dist/browser-client.d.ts +3 -0
  17. package/dist/browser-client.d.ts.map +1 -0
  18. package/dist/browser-client.js +678 -0
  19. package/dist/browser-client.js.map +1 -0
  20. package/dist/browser-relay-credential-provider.d.ts +3 -0
  21. package/dist/browser-relay-credential-provider.d.ts.map +1 -0
  22. package/dist/browser-relay-credential-provider.js +243 -0
  23. package/dist/browser-relay-credential-provider.js.map +1 -0
  24. package/dist/browser.d.ts +4 -0
  25. package/dist/browser.d.ts.map +1 -0
  26. package/dist/browser.js +4 -0
  27. package/dist/browser.js.map +1 -0
  28. package/dist/coordinator.d.ts +3 -0
  29. package/dist/coordinator.d.ts.map +1 -0
  30. package/dist/coordinator.js +547 -0
  31. package/dist/coordinator.js.map +1 -0
  32. package/dist/index.d.ts +4 -0
  33. package/dist/index.d.ts.map +1 -0
  34. package/dist/index.js +4 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/internal/browser-errors.d.ts +31 -0
  37. package/dist/internal/browser-errors.d.ts.map +1 -0
  38. package/dist/internal/browser-errors.js +69 -0
  39. package/dist/internal/browser-errors.js.map +1 -0
  40. package/dist/internal/browser-socket.d.ts +8 -0
  41. package/dist/internal/browser-socket.d.ts.map +1 -0
  42. package/dist/internal/browser-socket.js +204 -0
  43. package/dist/internal/browser-socket.js.map +1 -0
  44. package/dist/internal/calls.d.ts +33 -0
  45. package/dist/internal/calls.d.ts.map +1 -0
  46. package/dist/internal/calls.js +525 -0
  47. package/dist/internal/calls.js.map +1 -0
  48. package/dist/internal/control-plane-response.d.ts +10 -0
  49. package/dist/internal/control-plane-response.d.ts.map +1 -0
  50. package/dist/internal/control-plane-response.js +283 -0
  51. package/dist/internal/control-plane-response.js.map +1 -0
  52. package/dist/internal/declarations.d.ts +88 -0
  53. package/dist/internal/declarations.d.ts.map +1 -0
  54. package/dist/internal/declarations.js +561 -0
  55. package/dist/internal/declarations.js.map +1 -0
  56. package/dist/internal/errors.d.ts +31 -0
  57. package/dist/internal/errors.d.ts.map +1 -0
  58. package/dist/internal/errors.js +72 -0
  59. package/dist/internal/errors.js.map +1 -0
  60. package/dist/internal/events.d.ts +27 -0
  61. package/dist/internal/events.d.ts.map +1 -0
  62. package/dist/internal/events.js +207 -0
  63. package/dist/internal/events.js.map +1 -0
  64. package/dist/internal/presence.d.ts +15 -0
  65. package/dist/internal/presence.d.ts.map +1 -0
  66. package/dist/internal/presence.js +99 -0
  67. package/dist/internal/presence.js.map +1 -0
  68. package/dist/internal/resources.d.ts +33 -0
  69. package/dist/internal/resources.d.ts.map +1 -0
  70. package/dist/internal/resources.js +136 -0
  71. package/dist/internal/resources.js.map +1 -0
  72. package/dist/internal/runtime.d.ts +34 -0
  73. package/dist/internal/runtime.d.ts.map +1 -0
  74. package/dist/internal/runtime.js +17 -0
  75. package/dist/internal/runtime.js.map +1 -0
  76. package/dist/internal/session.d.ts +33 -0
  77. package/dist/internal/session.d.ts.map +1 -0
  78. package/dist/internal/session.js +199 -0
  79. package/dist/internal/session.js.map +1 -0
  80. package/dist/internal/socket.d.ts +6 -0
  81. package/dist/internal/socket.d.ts.map +1 -0
  82. package/dist/internal/socket.js +176 -0
  83. package/dist/internal/socket.js.map +1 -0
  84. package/dist/internal/state.d.ts +30 -0
  85. package/dist/internal/state.d.ts.map +1 -0
  86. package/dist/internal/state.js +188 -0
  87. package/dist/internal/state.js.map +1 -0
  88. package/dist/internal/user-calls.d.ts +27 -0
  89. package/dist/internal/user-calls.d.ts.map +1 -0
  90. package/dist/internal/user-calls.js +325 -0
  91. package/dist/internal/user-calls.js.map +1 -0
  92. package/dist/internal/user-session.d.ts +36 -0
  93. package/dist/internal/user-session.d.ts.map +1 -0
  94. package/dist/internal/user-session.js +250 -0
  95. package/dist/internal/user-session.js.map +1 -0
  96. package/dist/internal/user-state.d.ts +21 -0
  97. package/dist/internal/user-state.d.ts.map +1 -0
  98. package/dist/internal/user-state.js +240 -0
  99. package/dist/internal/user-state.js.map +1 -0
  100. package/dist/internal/validation.d.ts +32 -0
  101. package/dist/internal/validation.d.ts.map +1 -0
  102. package/dist/internal/validation.js +553 -0
  103. package/dist/internal/validation.js.map +1 -0
  104. package/dist/protocol/codec.d.ts +75 -0
  105. package/dist/protocol/codec.d.ts.map +1 -0
  106. package/dist/protocol/codec.js +1091 -0
  107. package/dist/protocol/codec.js.map +1 -0
  108. package/dist/protocol/session.d.ts +14 -0
  109. package/dist/protocol/session.d.ts.map +1 -0
  110. package/dist/protocol/session.js +125 -0
  111. package/dist/protocol/session.js.map +1 -0
  112. package/dist/protocol/user-session.d.ts +14 -0
  113. package/dist/protocol/user-session.d.ts.map +1 -0
  114. package/dist/protocol/user-session.js +116 -0
  115. package/dist/protocol/user-session.js.map +1 -0
  116. package/package.json +58 -9
  117. package/.eslintrc.js +0 -16
  118. package/.gitattributes +0 -2
  119. package/main.js +0 -305
  120. package/miakode.js +0 -56
  121. package/screenshots/bigGrid.jpg +0 -0
  122. package/screenshots/formExample.jpg +0 -0
  123. package/screenshots/properties&table.jpg +0 -0
  124. package/test.js +0 -45
@@ -0,0 +1,561 @@
1
+ import { LIMITS, Opcode } from '../protocol/codec.js';
2
+ import { cancelled, invalidLifecycle, relayFailure, superseded, } from './errors.js';
3
+ import { createDeferred } from './resources.js';
4
+ import { validateDeclarationOptions, validateEventAccess, validateStateAccess, } from './validation.js';
5
+ export const DECLARATION_DOMAINS = Object.freeze([
6
+ 'state',
7
+ 'state_access',
8
+ 'events',
9
+ 'event_access',
10
+ 'functions',
11
+ ]);
12
+ const EMPTY_REVISIONS = Object.freeze({
13
+ state: 0,
14
+ state_access: 0,
15
+ events: 0,
16
+ event_access: 0,
17
+ functions: 0,
18
+ });
19
+ function emptySnapshot() {
20
+ return Object.freeze({
21
+ state: Object.freeze({}),
22
+ stateAccess: Object.freeze([]),
23
+ events: Object.freeze([]),
24
+ eventAccess: Object.freeze([]),
25
+ functions: Object.freeze({}),
26
+ revisions: EMPTY_REVISIONS,
27
+ });
28
+ }
29
+ function copyRevisions(value) {
30
+ return Object.freeze({ ...value });
31
+ }
32
+ function copySnapshot(value) {
33
+ return Object.freeze({
34
+ state: value.state,
35
+ stateAccess: value.stateAccess,
36
+ events: value.events,
37
+ eventAccess: value.eventAccess,
38
+ functions: value.functions,
39
+ revisions: copyRevisions(value.revisions),
40
+ });
41
+ }
42
+ function protocolValuesEqual(left, right) {
43
+ if (left === right)
44
+ return true;
45
+ if (left instanceof Uint8Array || right instanceof Uint8Array) {
46
+ return left instanceof Uint8Array && right instanceof Uint8Array
47
+ && left.length === right.length && left.every((byte, index) => byte === right[index]);
48
+ }
49
+ if (Array.isArray(left) || Array.isArray(right)) {
50
+ return Array.isArray(left) && Array.isArray(right) && left.length === right.length
51
+ && left.every((item, index) => protocolValuesEqual(item, right[index]));
52
+ }
53
+ if (left === null || right === null || typeof left !== 'object' || typeof right !== 'object') {
54
+ return Number.isNaN(left) && Number.isNaN(right);
55
+ }
56
+ const leftKeys = Object.keys(left);
57
+ return leftKeys.length === Object.keys(right).length
58
+ && leftKeys.every((key) => Object.hasOwn(right, key)
59
+ && protocolValuesEqual(left[key], right[key]));
60
+ }
61
+ function revisionsEqual(left, right) {
62
+ return DECLARATION_DOMAINS.every((domain) => left[domain] === right[domain]);
63
+ }
64
+ function frameRequestId(frame) {
65
+ const value = frame.payload[0];
66
+ return typeof value === 'number' && Number.isSafeInteger(value) ? value : undefined;
67
+ }
68
+ function dictionary(value, expectedNames) {
69
+ if (!Array.isArray(value))
70
+ throw new TypeError('Relay dictionary is not an array');
71
+ const result = new Map();
72
+ const ids = new Set();
73
+ for (const raw of value) {
74
+ if (!Array.isArray(raw))
75
+ throw new TypeError('Relay dictionary entry is not an array');
76
+ const id = raw[0];
77
+ const name = raw[1];
78
+ if (typeof id !== 'number' || !Number.isSafeInteger(id) || typeof name !== 'string') {
79
+ throw new TypeError('Relay dictionary entry is invalid');
80
+ }
81
+ if (ids.has(id) || result.has(name))
82
+ throw new TypeError('Relay dictionary contains a duplicate');
83
+ ids.add(id);
84
+ result.set(name, id);
85
+ }
86
+ if (result.size !== expectedNames.length
87
+ || expectedNames.some((name) => !result.has(name))) {
88
+ throw new TypeError('Relay dictionary does not match the declared snapshot');
89
+ }
90
+ return result;
91
+ }
92
+ function ackDomain(opcode) {
93
+ if (opcode === Opcode.StateSyncOk)
94
+ return 'state';
95
+ if (opcode === Opcode.StateAclOk)
96
+ return 'state_access';
97
+ if (opcode === Opcode.EventSyncOk)
98
+ return 'events';
99
+ if (opcode === Opcode.EventAclOk)
100
+ return 'event_access';
101
+ if (opcode === Opcode.FunctionSyncOk)
102
+ return 'functions';
103
+ return undefined;
104
+ }
105
+ export class DeclarationManager {
106
+ #host;
107
+ #pending = [];
108
+ #requests = new Map();
109
+ #desired = emptySnapshot();
110
+ #active;
111
+ #current;
112
+ #transactionToken = 0;
113
+ #stopped = false;
114
+ #confirmed = new Map();
115
+ /** A confirmed value arrived after the current transaction was handed off. */
116
+ #confirmedAfterHandoff = false;
117
+ constructor(host) {
118
+ this.#host = host;
119
+ }
120
+ get desired() {
121
+ return this.#desired;
122
+ }
123
+ get active() {
124
+ return this.#active;
125
+ }
126
+ configure(configuration) {
127
+ for (const domain of DECLARATION_DOMAINS)
128
+ this.#supersedeUnprotected(domain);
129
+ const revisions = {
130
+ state: this.#desired.revisions.state + 1,
131
+ state_access: this.#desired.revisions.state_access + 1,
132
+ events: this.#desired.revisions.events + 1,
133
+ event_access: this.#desired.revisions.event_access + 1,
134
+ functions: this.#desired.revisions.functions + 1,
135
+ };
136
+ this.#desired = Object.freeze({
137
+ ...configuration,
138
+ revisions: Object.freeze(revisions),
139
+ });
140
+ }
141
+ declareState(state, signal) {
142
+ return this.#replace('state', (snapshot, revisions) => copySnapshot({ ...snapshot, state, revisions }), signal);
143
+ }
144
+ declareStateAccess(stateAccess, signal) {
145
+ return this.#replace('state_access', (snapshot, revisions) => copySnapshot({ ...snapshot, stateAccess, revisions }), signal);
146
+ }
147
+ declareEvents(events, signal) {
148
+ return this.#replace('events', (snapshot, revisions) => copySnapshot({ ...snapshot, events, revisions }), signal);
149
+ }
150
+ declareEventAccess(eventAccess, signal) {
151
+ return this.#replace('event_access', (snapshot, revisions) => copySnapshot({ ...snapshot, eventAccess, revisions }), signal);
152
+ }
153
+ declareFunctions(functions, signal) {
154
+ return this.#replace('functions', (snapshot, revisions) => copySnapshot({ ...snapshot, functions, revisions }), signal);
155
+ }
156
+ synchronize(session) {
157
+ this.#requests.clear();
158
+ this.#current = undefined;
159
+ this.#confirmedAfterHandoff = false;
160
+ this.#begin(session);
161
+ }
162
+ /**
163
+ * Records a mutation batch the relay acknowledged with `STATE_SET_OK`.
164
+ *
165
+ * Every later re-declaration of the same state slice carries these values
166
+ * instead of the declared ones, because `STATE_SYNC` replaces the relay's
167
+ * values and an ACL, event or function change — or a reconnect — must not
168
+ * roll the home back. Only acknowledged batches are recorded: a rejected or
169
+ * unknown mutation never reaches this method, so it is never replayed.
170
+ *
171
+ * `sequence` is the order in which the batches were sent. The relay applies
172
+ * one connection's frames in order, so the later batch wins a path.
173
+ */
174
+ recordConfirmed(mutations, revision, sequence) {
175
+ let changedValue = false;
176
+ for (const mutation of mutations) {
177
+ const existing = this.#confirmed.get(mutation.path);
178
+ if (existing !== undefined && existing.revision === revision && existing.sequence > sequence)
179
+ continue;
180
+ const deleted = 'delete' in mutation;
181
+ this.#confirmed.set(mutation.path, Object.freeze({
182
+ revision,
183
+ sequence,
184
+ deleted,
185
+ value: deleted ? undefined : mutation.value,
186
+ }));
187
+ const current = this.#current;
188
+ if (!deleted && current !== undefined
189
+ && current.snapshot.revisions.state === revision
190
+ && Object.hasOwn(current.snapshot.state, mutation.path)
191
+ && !protocolValuesEqual(current.snapshot.state[mutation.path], mutation.value)) {
192
+ changedValue = true;
193
+ }
194
+ }
195
+ const current = this.#current;
196
+ if (!changedValue || current === undefined)
197
+ return;
198
+ // The relay applied this batch before it staged the current STATE_SYNC,
199
+ // which captured the older value. Activating that stage would roll the
200
+ // mutation back while users see the result as current, so the stage is
201
+ // replaced: a new STATE_SYNC discards it on the relay (RFC 0001 §7.5).
202
+ if (!current.handedOff) {
203
+ this.#current = undefined;
204
+ this.#begin(current.session);
205
+ }
206
+ else {
207
+ this.#confirmedAfterHandoff = true;
208
+ }
209
+ }
210
+ /**
211
+ * The relay refused to reapply an acknowledged deletion, so it holds the
212
+ * declared value again. That value becomes the acknowledged one, unless a
213
+ * newer mutation of the path was acknowledged meanwhile.
214
+ */
215
+ restorationRefused(paths) {
216
+ for (const [path, sequence] of paths) {
217
+ const entry = this.#confirmed.get(path);
218
+ if (entry?.deleted === true && entry.sequence === sequence)
219
+ this.#confirmed.delete(path);
220
+ }
221
+ }
222
+ /** The confirmed entry sequence of each path, for a restoration in flight. */
223
+ confirmedSequences(paths) {
224
+ const result = new Map();
225
+ for (const path of paths) {
226
+ const entry = this.#confirmed.get(path);
227
+ if (entry !== undefined)
228
+ result.set(path, entry.sequence);
229
+ }
230
+ return result;
231
+ }
232
+ handleFrame(frame) {
233
+ const domain = ackDomain(frame.opcode);
234
+ if (domain === undefined)
235
+ return false;
236
+ const requestId = frameRequestId(frame);
237
+ if (requestId === undefined)
238
+ throw new TypeError('Declaration acknowledgement has no request ID');
239
+ const request = this.#requests.get(requestId);
240
+ if (request === undefined)
241
+ throw new TypeError('Declaration acknowledgement is not correlated');
242
+ this.#requests.delete(requestId);
243
+ const current = this.#current;
244
+ if (current === undefined || request.token !== current.token)
245
+ return true;
246
+ const expectedDomain = DECLARATION_DOMAINS[current.index];
247
+ if (request.domain !== domain || expectedDomain !== domain) {
248
+ throw new TypeError('Declaration acknowledgement is out of order');
249
+ }
250
+ if (domain === 'state') {
251
+ const epoch = frame.payload[1];
252
+ const expectedEpoch = current.session.welcome.epoch;
253
+ if (!(epoch instanceof Uint8Array)
254
+ || epoch.length !== expectedEpoch.length
255
+ || epoch.some((value, index) => value !== expectedEpoch[index])) {
256
+ throw new TypeError('STATE_SYNC_OK uses a stale epoch');
257
+ }
258
+ current.stateIds = dictionary(frame.payload[3], Object.keys(current.snapshot.state));
259
+ }
260
+ if (domain === 'events') {
261
+ current.topicIds = dictionary(frame.payload[1], current.snapshot.events.map(({ topic }) => topic));
262
+ }
263
+ if (domain === 'functions') {
264
+ current.functionIds = dictionary(frame.payload[1], Object.keys(current.snapshot.functions));
265
+ }
266
+ current.index += 1;
267
+ if (current.index === DECLARATION_DOMAINS.length)
268
+ this.#activate(current);
269
+ else
270
+ void this.#sendCurrentDomain(current);
271
+ return true;
272
+ }
273
+ handleError(requestId, code, retryable) {
274
+ const request = this.#requests.get(requestId);
275
+ if (request === undefined)
276
+ return false;
277
+ this.#requests.delete(requestId);
278
+ const current = this.#current;
279
+ if (current === undefined || request.token !== current.token)
280
+ return true;
281
+ if (retryable) {
282
+ this.#host.transportFailure(relayFailure(code, true, 'not_dispatched'));
283
+ return true;
284
+ }
285
+ this.#rejectTransaction(current, relayFailure(code, false, 'not_dispatched'));
286
+ return true;
287
+ }
288
+ disconnected() {
289
+ this.#requests.clear();
290
+ this.#current = undefined;
291
+ }
292
+ stop() {
293
+ this.#stopped = true;
294
+ this.#requests.clear();
295
+ this.#current = undefined;
296
+ for (const pending of this.#pending.splice(0)) {
297
+ this.#removePendingAbort(pending);
298
+ pending.deferred.reject(cancelled('not_dispatched', 'Coordinator stopped before declaration activation'));
299
+ }
300
+ }
301
+ #replace(domain, update, signal) {
302
+ if (this.#stopped)
303
+ return Promise.reject(invalidLifecycle('Coordinator is stopped'));
304
+ if (signal?.aborted === true)
305
+ return Promise.reject(cancelled('not_dispatched'));
306
+ if (this.#pending.length >= LIMITS.declarationsPerCoordinator
307
+ || this.#requests.size >= LIMITS.declarationsPerCoordinator) {
308
+ return Promise.reject(new RangeError('Too many pending declarations'));
309
+ }
310
+ this.#supersedeUnprotected(domain);
311
+ const revision = this.#desired.revisions[domain] + 1;
312
+ const revisions = copyRevisions({ ...this.#desired.revisions, [domain]: revision });
313
+ this.#desired = update(this.#desired, revisions);
314
+ const deferred = createDeferred();
315
+ const pending = { domain, revision, deferred };
316
+ if (signal !== undefined) {
317
+ const abort = () => {
318
+ const index = this.#pending.indexOf(pending);
319
+ if (index !== -1)
320
+ this.#pending.splice(index, 1);
321
+ deferred.reject(cancelled('not_dispatched'));
322
+ };
323
+ pending.signal = signal;
324
+ pending.abort = abort;
325
+ signal.addEventListener('abort', abort, { once: true });
326
+ }
327
+ this.#pending.push(pending);
328
+ const session = this.#host.currentSession();
329
+ if (session !== undefined) {
330
+ if (this.#current === undefined)
331
+ this.#begin(session);
332
+ else if (!this.#current.handedOff) {
333
+ this.#current = undefined;
334
+ this.#begin(session);
335
+ }
336
+ }
337
+ return deferred.promise;
338
+ }
339
+ #supersedeUnprotected(domain) {
340
+ const protectedRevision = this.#current?.handedOff === true
341
+ ? this.#current.snapshot.revisions[domain]
342
+ : 0;
343
+ for (let index = this.#pending.length - 1; index >= 0; index -= 1) {
344
+ const pending = this.#pending[index];
345
+ if (pending?.domain !== domain || pending.revision <= protectedRevision)
346
+ continue;
347
+ this.#pending.splice(index, 1);
348
+ this.#removePendingAbort(pending);
349
+ pending.deferred.reject(superseded());
350
+ }
351
+ }
352
+ #begin(session) {
353
+ this.#transactionToken += 1;
354
+ const welcome = session.welcome;
355
+ this.#current = {
356
+ token: this.#transactionToken,
357
+ snapshot: this.#withConfirmedState(copySnapshot(this.#desired)),
358
+ session,
359
+ receipt: Object.freeze({
360
+ sessionId: welcome.readySession.sessionId,
361
+ generation: welcome.readySession.generation,
362
+ }),
363
+ index: 0,
364
+ handedOff: false,
365
+ stateIds: new Map(),
366
+ topicIds: new Map(),
367
+ functionIds: new Map(),
368
+ };
369
+ this.#host.synchronizing();
370
+ if (this.#stopped) {
371
+ this.#current = undefined;
372
+ return;
373
+ }
374
+ void this.#sendCurrentDomain(this.#current);
375
+ }
376
+ async #sendCurrentDomain(transaction) {
377
+ const domain = DECLARATION_DOMAINS[transaction.index];
378
+ if (domain === undefined || this.#current?.token !== transaction.token)
379
+ return;
380
+ const requestId = this.#host.nextRequestId();
381
+ this.#requests.set(requestId, { token: transaction.token, domain });
382
+ const frame = this.#frameFor(transaction.snapshot, domain, requestId);
383
+ if (domain === 'functions')
384
+ transaction.handedOff = true;
385
+ try {
386
+ await transaction.session.send(frame);
387
+ }
388
+ catch (error) {
389
+ if (this.#current?.token === transaction.token)
390
+ this.#host.transportFailure(error);
391
+ }
392
+ }
393
+ #frameFor(snapshot, domain, requestId) {
394
+ if (domain === 'state') {
395
+ return {
396
+ opcode: Opcode.StateSync,
397
+ payload: [requestId, Object.entries(snapshot.state).map(([path, value]) => [path, value])],
398
+ };
399
+ }
400
+ if (domain === 'state_access') {
401
+ return {
402
+ opcode: Opcode.StateAclSync,
403
+ payload: [requestId, snapshot.stateAccess.map(({ userId, patterns }) => [
404
+ userId,
405
+ [...patterns],
406
+ ])],
407
+ };
408
+ }
409
+ if (domain === 'events') {
410
+ return {
411
+ opcode: Opcode.EventSync,
412
+ payload: [requestId, snapshot.events.map(({ topic, directions }) => [topic, directions])],
413
+ };
414
+ }
415
+ if (domain === 'event_access') {
416
+ return {
417
+ opcode: Opcode.EventAclSync,
418
+ payload: [requestId, snapshot.eventAccess.map(({ userId, publish, subscribe }) => [
419
+ userId,
420
+ [...publish],
421
+ [...subscribe],
422
+ ])],
423
+ };
424
+ }
425
+ return {
426
+ opcode: Opcode.FunctionSync,
427
+ payload: [requestId, Object.keys(snapshot.functions)],
428
+ };
429
+ }
430
+ /**
431
+ * The snapshot to send: the desired slices, with each declared path carrying
432
+ * the value the relay last acknowledged for that same state revision.
433
+ */
434
+ #withConfirmedState(snapshot) {
435
+ let state;
436
+ for (const [path, entry] of this.#confirmed) {
437
+ if (entry.deleted
438
+ || entry.revision !== snapshot.revisions.state
439
+ || !Object.hasOwn(snapshot.state, path))
440
+ continue;
441
+ state ??= { ...snapshot.state };
442
+ state[path] = entry.value;
443
+ }
444
+ return state === undefined
445
+ ? snapshot
446
+ : copySnapshot({ ...snapshot, state: Object.freeze(state) });
447
+ }
448
+ /**
449
+ * After activation, forgets what the activated declaration superseded and
450
+ * returns the acknowledged deletions the activation undid.
451
+ */
452
+ #settleConfirmedState(snapshot) {
453
+ const deletions = [];
454
+ for (const [path, entry] of this.#confirmed) {
455
+ if (entry.revision !== snapshot.revisions.state || !Object.hasOwn(snapshot.state, path)) {
456
+ this.#confirmed.delete(path);
457
+ }
458
+ else if (entry.deleted) {
459
+ deletions.push(path);
460
+ }
461
+ }
462
+ return deletions;
463
+ }
464
+ #activate(transaction) {
465
+ if (this.#current?.token !== transaction.token)
466
+ return;
467
+ this.#active = Object.freeze({
468
+ snapshot: transaction.snapshot,
469
+ receipt: transaction.receipt,
470
+ stateIds: transaction.stateIds,
471
+ topicIds: transaction.topicIds,
472
+ functionIds: transaction.functionIds,
473
+ });
474
+ this.#current = undefined;
475
+ this.#host.activeDeclarationsChanged(this.#active);
476
+ const deletions = this.#settleConfirmedState(transaction.snapshot);
477
+ if (deletions.length > 0)
478
+ this.#host.restoreDeletions(transaction.session, this.#active, deletions);
479
+ this.#settleThrough(transaction.snapshot.revisions, transaction.receipt, undefined);
480
+ const refresh = this.#confirmedAfterHandoff;
481
+ this.#confirmedAfterHandoff = false;
482
+ if (refresh || !revisionsEqual(this.#desired.revisions, transaction.snapshot.revisions)) {
483
+ this.#begin(transaction.session);
484
+ }
485
+ else {
486
+ this.#host.declarationsReady(transaction.receipt);
487
+ }
488
+ }
489
+ #rejectTransaction(transaction, failure) {
490
+ if (this.#current?.token !== transaction.token)
491
+ return;
492
+ this.#current = undefined;
493
+ // Nothing activated, so the relay still holds every acknowledged value.
494
+ this.#confirmedAfterHandoff = false;
495
+ this.#settleThrough(transaction.snapshot.revisions, transaction.receipt, failure);
496
+ const activeSnapshot = this.#active?.snapshot ?? emptySnapshot();
497
+ const desired = this.#desired;
498
+ const revisions = { ...desired.revisions };
499
+ const next = {
500
+ state: desired.state,
501
+ stateAccess: desired.stateAccess,
502
+ events: desired.events,
503
+ eventAccess: desired.eventAccess,
504
+ functions: desired.functions,
505
+ };
506
+ for (const domain of DECLARATION_DOMAINS) {
507
+ if (desired.revisions[domain] > transaction.snapshot.revisions[domain])
508
+ continue;
509
+ revisions[domain] = activeSnapshot.revisions[domain];
510
+ if (domain === 'state')
511
+ next.state = activeSnapshot.state;
512
+ if (domain === 'state_access')
513
+ next.stateAccess = activeSnapshot.stateAccess;
514
+ if (domain === 'events')
515
+ next.events = activeSnapshot.events;
516
+ if (domain === 'event_access')
517
+ next.eventAccess = activeSnapshot.eventAccess;
518
+ if (domain === 'functions')
519
+ next.functions = activeSnapshot.functions;
520
+ }
521
+ this.#desired = copySnapshot({ ...next, revisions: copyRevisions(revisions) });
522
+ const hasQueuedSnapshot = !revisionsEqual(this.#desired.revisions, activeSnapshot.revisions);
523
+ const hasActiveConfiguration = this.#active?.receipt.sessionId === transaction.receipt.sessionId
524
+ && this.#active.receipt.generation === transaction.receipt.generation;
525
+ this.#host.declarationFailure(failure, hasActiveConfiguration, hasQueuedSnapshot);
526
+ if (hasQueuedSnapshot) {
527
+ this.#begin(transaction.session);
528
+ }
529
+ }
530
+ #settleThrough(revisions, receipt, failure) {
531
+ for (let index = this.#pending.length - 1; index >= 0; index -= 1) {
532
+ const pending = this.#pending[index];
533
+ if (pending === undefined || pending.revision > revisions[pending.domain])
534
+ continue;
535
+ this.#pending.splice(index, 1);
536
+ this.#removePendingAbort(pending);
537
+ if (failure === undefined)
538
+ pending.deferred.resolve(receipt);
539
+ else
540
+ pending.deferred.reject(failure);
541
+ }
542
+ }
543
+ #removePendingAbort(pending) {
544
+ if (pending.signal !== undefined && pending.abort !== undefined) {
545
+ pending.signal.removeEventListener('abort', pending.abort);
546
+ }
547
+ }
548
+ }
549
+ export class AccessManager {
550
+ #declarations;
551
+ constructor(declarations) {
552
+ this.#declarations = declarations;
553
+ }
554
+ declareState(entries, options = {}) {
555
+ return this.#declarations.declareStateAccess(validateStateAccess(entries), validateDeclarationOptions(options, 'state access declaration'));
556
+ }
557
+ declareEvents(entries, options = {}) {
558
+ return this.#declarations.declareEventAccess(validateEventAccess(entries), validateDeclarationOptions(options, 'event access declaration'));
559
+ }
560
+ }
561
+ //# sourceMappingURL=declarations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"declarations.js","sourceRoot":"","sources":["../../src/internal/declarations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import type { CoordinatorFailure, CoordinatorLogRecord, CoordinatorLogger, DispatchOutcome } from '../api.js';
2
+ interface FailureOptions {
3
+ code?: number;
4
+ correlation?: {
5
+ kind: 'event' | 'call';
6
+ localId: string;
7
+ };
8
+ retryable?: boolean;
9
+ }
10
+ export declare class CoordinatorError extends Error implements CoordinatorFailure {
11
+ readonly kind: CoordinatorFailure['kind'];
12
+ readonly retryable: boolean;
13
+ readonly outcome: DispatchOutcome;
14
+ readonly code?: number;
15
+ readonly correlation?: {
16
+ kind: 'event' | 'call';
17
+ localId: string;
18
+ };
19
+ constructor(kind: CoordinatorFailure['kind'], outcome: DispatchOutcome, message: string, options?: FailureOptions);
20
+ }
21
+ export declare function invalidLifecycle(message: string): CoordinatorError;
22
+ export declare function unavailable(message?: string): CoordinatorError;
23
+ export declare function cancelled(outcome: 'not_dispatched' | 'outcome_unknown', message?: string): CoordinatorError;
24
+ export declare function superseded(): CoordinatorError;
25
+ export declare function outcomeUnknown(message?: string): CoordinatorError;
26
+ export declare function internalFailure(message?: string): CoordinatorError;
27
+ export declare function protocolFailure(message?: string): CoordinatorError;
28
+ export declare function relayFailure(code: number, retryable: boolean, outcome: DispatchOutcome, correlation?: FailureOptions['correlation']): CoordinatorError;
29
+ export declare function safeLog(logger: CoordinatorLogger | undefined, record: CoordinatorLogRecord): void;
30
+ export {};
31
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EAChB,MAAM,WAAW,CAAC;AAEnB,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,kBAAkB;IACvE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,YACE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,EAW7B;CACF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAElE;AAED,wBAAgB,WAAW,CAAC,OAAO,SAA6B,GAAG,gBAAgB,CAElF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,EAC7C,OAAO,SAA4B,GAClC,gBAAgB,CAElB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAM7C;AAED,wBAAgB,cAAc,CAAC,OAAO,SAA6C,GAAG,gBAAgB,CAErG;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAiC,GAAG,gBAAgB,CAE1F;AAED,wBAAgB,eAAe,CAAC,OAAO,SAA6B,GAAG,gBAAgB,CAEtF;AAYD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,eAAe,EACxB,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,GAC1C,gBAAgB,CAKlB;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAOjG"}