@agentshouse/mdruntime 0.1.0-c3903a68dcbbf → 0.1.0-c3a5b012b4a8c

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 (197) hide show
  1. package/README.md +26 -13
  2. package/dist/adapter.d.ts +244 -88
  3. package/dist/adapter.d.ts.map +1 -1
  4. package/dist/adapter.js +1 -9
  5. package/dist/attached-model.d.ts +8 -0
  6. package/dist/attached-model.d.ts.map +1 -0
  7. package/dist/attached-model.js +46 -0
  8. package/dist/attempt.d.ts +16 -0
  9. package/dist/attempt.d.ts.map +1 -0
  10. package/dist/attempt.js +70 -0
  11. package/dist/binary.d.ts +18 -0
  12. package/dist/binary.d.ts.map +1 -0
  13. package/dist/binary.js +8 -0
  14. package/dist/bootstrap.d.ts +40 -6
  15. package/dist/bootstrap.d.ts.map +1 -1
  16. package/dist/bootstrap.js +336 -52
  17. package/dist/chain.d.ts +12 -0
  18. package/dist/chain.d.ts.map +1 -0
  19. package/dist/chain.js +64 -0
  20. package/dist/change-set.d.ts +9 -14
  21. package/dist/change-set.d.ts.map +1 -1
  22. package/dist/change-set.js +11 -60
  23. package/dist/change.d.ts +46 -0
  24. package/dist/change.d.ts.map +1 -1
  25. package/dist/change.js +34 -0
  26. package/dist/client.d.ts +44 -24
  27. package/dist/client.d.ts.map +1 -1
  28. package/dist/client.js +161 -36
  29. package/dist/collection.d.ts +13 -16
  30. package/dist/collection.d.ts.map +1 -1
  31. package/dist/collection.js +52 -66
  32. package/dist/compile.d.ts +11 -0
  33. package/dist/compile.d.ts.map +1 -0
  34. package/dist/compile.js +717 -0
  35. package/dist/connection.d.ts +69 -44
  36. package/dist/connection.d.ts.map +1 -1
  37. package/dist/connection.js +4581 -1472
  38. package/dist/context.d.ts +2 -0
  39. package/dist/context.d.ts.map +1 -0
  40. package/dist/context.js +7 -0
  41. package/dist/conversation-row.d.ts +33 -0
  42. package/dist/conversation-row.d.ts.map +1 -0
  43. package/dist/conversation-row.js +47 -0
  44. package/dist/conversation.d.ts +76 -27
  45. package/dist/conversation.d.ts.map +1 -1
  46. package/dist/conversation.js +1052 -273
  47. package/dist/digest.d.ts +7 -0
  48. package/dist/digest.d.ts.map +1 -0
  49. package/dist/digest.js +113 -0
  50. package/dist/durability.d.ts +10 -1
  51. package/dist/durability.d.ts.map +1 -1
  52. package/dist/durability.js +5 -0
  53. package/dist/entry.d.ts +20 -0
  54. package/dist/entry.d.ts.map +1 -0
  55. package/dist/entry.js +161 -0
  56. package/dist/expectation.d.ts +21 -0
  57. package/dist/expectation.d.ts.map +1 -0
  58. package/dist/expectation.js +70 -0
  59. package/dist/failure.d.ts +13 -0
  60. package/dist/failure.d.ts.map +1 -0
  61. package/dist/failure.js +19 -0
  62. package/dist/file.d.ts +2 -19
  63. package/dist/file.d.ts.map +1 -1
  64. package/dist/file.js +7 -122
  65. package/dist/host.d.ts +17 -3
  66. package/dist/host.d.ts.map +1 -1
  67. package/dist/host.js +163 -75
  68. package/dist/identity.d.ts +3 -0
  69. package/dist/identity.d.ts.map +1 -1
  70. package/dist/identity.js +13 -1
  71. package/dist/index.d.ts +26 -11
  72. package/dist/index.d.ts.map +1 -1
  73. package/dist/index.js +12 -1
  74. package/dist/job.d.ts +33 -0
  75. package/dist/job.d.ts.map +1 -0
  76. package/dist/job.js +54 -0
  77. package/dist/live.d.ts +23 -0
  78. package/dist/live.d.ts.map +1 -0
  79. package/dist/live.js +165 -0
  80. package/dist/media.d.ts +8 -0
  81. package/dist/media.d.ts.map +1 -0
  82. package/dist/media.js +218 -0
  83. package/dist/memory.d.ts +30 -9
  84. package/dist/memory.d.ts.map +1 -1
  85. package/dist/memory.js +337 -87
  86. package/dist/messages.d.ts +52 -0
  87. package/dist/messages.d.ts.map +1 -0
  88. package/dist/messages.js +168 -0
  89. package/dist/model.d.ts +17 -16
  90. package/dist/model.d.ts.map +1 -1
  91. package/dist/model.js +9 -9
  92. package/dist/name.d.ts +4 -0
  93. package/dist/name.d.ts.map +1 -0
  94. package/dist/name.js +122 -0
  95. package/dist/observation.d.ts +22 -2
  96. package/dist/observation.d.ts.map +1 -1
  97. package/dist/observation.js +133 -17
  98. package/dist/open.d.ts +2 -0
  99. package/dist/open.d.ts.map +1 -0
  100. package/dist/open.js +1 -0
  101. package/dist/opened.d.ts +22 -0
  102. package/dist/opened.d.ts.map +1 -0
  103. package/dist/opened.js +107 -0
  104. package/dist/outcome.d.ts +72 -21
  105. package/dist/outcome.d.ts.map +1 -1
  106. package/dist/outcome.js +81 -1
  107. package/dist/overlay.d.ts +16 -5
  108. package/dist/overlay.d.ts.map +1 -1
  109. package/dist/overlay.js +147 -180
  110. package/dist/parts.d.ts +59 -0
  111. package/dist/parts.d.ts.map +1 -0
  112. package/dist/parts.js +118 -0
  113. package/dist/paths.d.ts +1 -1
  114. package/dist/paths.d.ts.map +1 -1
  115. package/dist/paths.js +4 -16
  116. package/dist/query.d.ts +56 -180
  117. package/dist/query.d.ts.map +1 -1
  118. package/dist/query.js +3 -422
  119. package/dist/questions.d.ts +32 -0
  120. package/dist/questions.d.ts.map +1 -0
  121. package/dist/questions.js +118 -0
  122. package/dist/reach.d.ts +54 -0
  123. package/dist/reach.d.ts.map +1 -0
  124. package/dist/reach.js +483 -0
  125. package/dist/react.d.ts +45 -0
  126. package/dist/react.d.ts.map +1 -0
  127. package/dist/react.js +54 -0
  128. package/dist/read.d.ts +7 -0
  129. package/dist/read.d.ts.map +1 -0
  130. package/dist/read.js +17 -0
  131. package/dist/readiness.d.ts +50 -0
  132. package/dist/readiness.d.ts.map +1 -0
  133. package/dist/readiness.js +27 -0
  134. package/dist/recovery.d.ts +26 -0
  135. package/dist/recovery.d.ts.map +1 -0
  136. package/dist/recovery.js +232 -0
  137. package/dist/refresh.d.ts +21 -7
  138. package/dist/refresh.d.ts.map +1 -1
  139. package/dist/refresh.js +155 -55
  140. package/dist/replica.d.ts +61 -33
  141. package/dist/replica.d.ts.map +1 -1
  142. package/dist/replica.js +355 -162
  143. package/dist/room-draft.d.ts +62 -11
  144. package/dist/room-draft.d.ts.map +1 -1
  145. package/dist/room-draft.js +281 -83
  146. package/dist/rows.d.ts +32 -34
  147. package/dist/rows.d.ts.map +1 -1
  148. package/dist/rows.js +65 -87
  149. package/dist/save.d.ts +74 -6
  150. package/dist/save.d.ts.map +1 -1
  151. package/dist/save.js +902 -183
  152. package/dist/search.d.ts +15 -54
  153. package/dist/search.d.ts.map +1 -1
  154. package/dist/search.js +10 -121
  155. package/dist/seed.d.ts +16 -0
  156. package/dist/seed.d.ts.map +1 -0
  157. package/dist/seed.js +75 -0
  158. package/dist/shared.d.ts +15 -0
  159. package/dist/shared.d.ts.map +1 -0
  160. package/dist/shared.js +421 -0
  161. package/dist/source.d.ts +61 -0
  162. package/dist/source.d.ts.map +1 -0
  163. package/dist/source.js +81 -0
  164. package/dist/status.d.ts +7 -4
  165. package/dist/status.d.ts.map +1 -1
  166. package/dist/status.js +3 -15
  167. package/dist/store.d.ts +178 -80
  168. package/dist/store.d.ts.map +1 -1
  169. package/dist/store.js +372 -381
  170. package/dist/stored.d.ts +156 -0
  171. package/dist/stored.d.ts.map +1 -0
  172. package/dist/stored.js +637 -0
  173. package/dist/tables.d.ts +388 -0
  174. package/dist/tables.d.ts.map +1 -0
  175. package/dist/tables.js +706 -0
  176. package/dist/transfer.d.ts +0 -5
  177. package/dist/transfer.d.ts.map +1 -1
  178. package/dist/turn.d.ts +9 -0
  179. package/dist/turn.d.ts.map +1 -0
  180. package/dist/turn.js +75 -0
  181. package/dist/validation.d.ts +29 -0
  182. package/dist/validation.d.ts.map +1 -0
  183. package/dist/validation.js +104 -0
  184. package/dist/windows.d.ts +11 -0
  185. package/dist/windows.d.ts.map +1 -0
  186. package/dist/windows.js +16 -0
  187. package/dist/wire.d.ts +199 -19
  188. package/dist/wire.d.ts.map +1 -1
  189. package/dist/wire.js +92 -67
  190. package/package.json +33 -10
  191. package/AGENTS.md +0 -210
  192. package/dist/attachment.d.ts +0 -3
  193. package/dist/attachment.d.ts.map +0 -1
  194. package/dist/attachment.js +0 -8
  195. package/dist/read-side.d.ts +0 -14
  196. package/dist/read-side.d.ts.map +0 -1
  197. package/dist/read-side.js +0 -371
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ const COMPLETE_ROOMS = new Set(['complete', 'unadmitted']);
2
+ export function readinessOf(facts) {
3
+ const { established, coverage: held, ...reported } = facts;
4
+ const settledConversations = held.conversations === 'complete' || held.conversations === 'undeclared';
5
+ const complete = held.listed &&
6
+ settledConversations &&
7
+ held.rooms.every((room) => COMPLETE_ROOMS.has(room.state));
8
+ const coverage = { ...held, complete };
9
+ const stored = facts.code === 'stored';
10
+ const ready = stored && complete;
11
+ const usable = stored && (ready || established);
12
+ const status = ready
13
+ ? 'ready'
14
+ : facts.space !== null
15
+ ? 'paused'
16
+ : facts.lost && !established
17
+ ? 'lost'
18
+ : 'preparing';
19
+ return {
20
+ ...reported,
21
+ coverage,
22
+ status,
23
+ ready,
24
+ usable,
25
+ durability: facts.persistence === 'granted' ? 'persistent' : 'best-effort',
26
+ };
27
+ }
@@ -0,0 +1,26 @@
1
+ export type Attempted = 'done' | 'again' | {
2
+ readonly at: number;
3
+ };
4
+ export type Attempt = (signal: AbortSignal) => Promise<Attempted>;
5
+ export type AttemptOptions = {
6
+ readonly at?: number;
7
+ readonly again?: boolean;
8
+ };
9
+ export type RecoveryOptions = {
10
+ readonly firstMs?: number;
11
+ readonly maxMs?: number;
12
+ readonly attempts?: number;
13
+ readonly inFlight?: number;
14
+ };
15
+ export type Recovery = {
16
+ attempt(intent: string, run: Attempt, options?: AttemptOptions): Promise<boolean>;
17
+ pending(intent: string): boolean;
18
+ resume(): void;
19
+ cancel(intent: string): void;
20
+ scope(inFlight?: number): Recovery;
21
+ retire(): Promise<void>;
22
+ };
23
+ export declare function retryDelay(tries: number, firstMs?: number, maxMs?: number): number;
24
+ export declare function untilAnswered<T>(ask: () => Promise<T>, signal: AbortSignal, answered?: (answer: T) => boolean): Promise<T>;
25
+ export declare function createRecovery(options?: RecoveryOptions): Recovery;
26
+ //# sourceMappingURL=recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAsBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAW,EAAE,KAAK,SAAS,GAAG,MAAM,CAGpF;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAoB,GAC5C,OAAO,CAAC,CAAC,CAAC,CAsBZ;AA8KD,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAStE"}
@@ -0,0 +1,232 @@
1
+ // A first retry waits about a second, so a passing failure clears before the next attempt.
2
+ const FIRST_MS = 1_000;
3
+ // Waits stop doubling at half a minute, so work resumes soon after a long failure ends.
4
+ const MAX_MS = 30_000;
5
+ const ATTEMPTS = 8;
6
+ export function retryDelay(tries, firstMs = FIRST_MS, maxMs = MAX_MS) {
7
+ const longest = Math.min(maxMs, firstMs * 2 ** tries);
8
+ return longest / 2 + (Math.random() * longest) / 2;
9
+ }
10
+ export async function untilAnswered(ask, signal, answered = () => true) {
11
+ for (let tries = 0;; tries += 1) {
12
+ try {
13
+ const answer = await ask();
14
+ if (answered(answer) || signal.aborted)
15
+ return answer;
16
+ }
17
+ catch (error) {
18
+ if (signal.aborted)
19
+ throw error;
20
+ }
21
+ await new Promise((resume) => {
22
+ const stop = () => {
23
+ clearTimeout(again);
24
+ resume();
25
+ };
26
+ // A read that failed is asked again on the doubling backoff, so its asker is answered once the failure clears.
27
+ const again = setTimeout(() => {
28
+ signal.removeEventListener('abort', stop);
29
+ resume();
30
+ }, retryDelay(tries));
31
+ signal.addEventListener('abort', stop, { once: true });
32
+ });
33
+ signal.throwIfAborted();
34
+ }
35
+ }
36
+ function owner(backoff, inFlight, release = () => { }) {
37
+ const intents = new Map();
38
+ const children = new Set();
39
+ const running = new Set();
40
+ const queued = [];
41
+ let free = inFlight;
42
+ let retired = false;
43
+ function finish(key, intent, done) {
44
+ if (intents.get(key) === intent)
45
+ intents.delete(key);
46
+ if (intent.timer !== null)
47
+ clearTimeout(intent.timer);
48
+ intent.timer = null;
49
+ intent.end(done);
50
+ }
51
+ function wait(key, intent, at, guided) {
52
+ if (intent.timer !== null)
53
+ clearTimeout(intent.timer);
54
+ intent.due = at;
55
+ intent.guided = guided;
56
+ intent.timer = setTimeout(() => {
57
+ intent.timer = null;
58
+ launch(key, intent);
59
+ }, Math.max(0, at - Date.now()));
60
+ }
61
+ function launch(key, intent) {
62
+ intent.due = null;
63
+ intent.guided = false;
64
+ const controller = new AbortController();
65
+ intent.controller = controller;
66
+ const run = start(key, intent, controller);
67
+ running.add(run);
68
+ void run.finally(() => running.delete(run));
69
+ }
70
+ async function start(key, intent, controller) {
71
+ while (free === 0)
72
+ await new Promise((admit) => queued.push(admit));
73
+ if (controller.signal.aborted) {
74
+ queued.shift()?.();
75
+ return;
76
+ }
77
+ free -= 1;
78
+ const abandoned = new Promise((resolve) => {
79
+ controller.signal.addEventListener('abort', () => resolve(null), { once: true });
80
+ });
81
+ let result;
82
+ try {
83
+ result = await Promise.race([intent.run(controller.signal), abandoned]);
84
+ }
85
+ catch {
86
+ result = 'again';
87
+ }
88
+ finally {
89
+ free += 1;
90
+ queued.shift()?.();
91
+ }
92
+ if (result === null || controller.signal.aborted || intents.get(key) !== intent)
93
+ return;
94
+ intent.controller = null;
95
+ const again = intent.again;
96
+ intent.again = null;
97
+ if (result === 'done') {
98
+ intent.tries = 0;
99
+ if (again === null)
100
+ finish(key, intent, true);
101
+ else if (again === 'now')
102
+ launch(key, intent);
103
+ else
104
+ wait(key, intent, again, true);
105
+ return;
106
+ }
107
+ intent.tries += 1;
108
+ if (intent.tries >= backoff.attempts) {
109
+ if (again === null) {
110
+ finish(key, intent, false);
111
+ return;
112
+ }
113
+ intent.tries = 0;
114
+ if (again === 'now')
115
+ launch(key, intent);
116
+ else
117
+ wait(key, intent, again, true);
118
+ return;
119
+ }
120
+ if (result === 'again') {
121
+ // The next attempt waits the doubling backoff, up to its maximum.
122
+ const delay = retryDelay(intent.tries - 1, backoff.firstMs, backoff.maxMs);
123
+ wait(key, intent, Date.now() + delay, false);
124
+ }
125
+ else
126
+ wait(key, intent, result.at, true);
127
+ }
128
+ const recovery = {
129
+ attempt(key, run, options = {}) {
130
+ if (retired)
131
+ return Promise.resolve(false);
132
+ const held = intents.get(key);
133
+ if (held !== undefined) {
134
+ held.run = run;
135
+ if (held.controller !== null) {
136
+ const at = options.at;
137
+ held.again =
138
+ at === undefined || held.again === 'now'
139
+ ? 'now'
140
+ : Math.min(at, held.again ?? Number.POSITIVE_INFINITY);
141
+ }
142
+ else if (held.due !== null && held.due <= Date.now()) {
143
+ if (held.timer !== null)
144
+ clearTimeout(held.timer);
145
+ held.timer = null;
146
+ launch(key, held);
147
+ }
148
+ else if (options.at !== undefined && (held.due === null || options.at < held.due)) {
149
+ wait(key, held, options.at, true);
150
+ }
151
+ return held.ended;
152
+ }
153
+ let end = () => { };
154
+ const ended = new Promise((resolve) => {
155
+ end = resolve;
156
+ });
157
+ const intent = {
158
+ run,
159
+ tries: 0,
160
+ timer: null,
161
+ due: null,
162
+ guided: false,
163
+ controller: null,
164
+ again: null,
165
+ ended,
166
+ end,
167
+ };
168
+ intents.set(key, intent);
169
+ if (options.at !== undefined)
170
+ wait(key, intent, options.at, true);
171
+ else if (options.again === true) {
172
+ intent.tries = 1;
173
+ wait(key, intent, Date.now() + retryDelay(0, backoff.firstMs, backoff.maxMs), false);
174
+ }
175
+ else
176
+ launch(key, intent);
177
+ return ended;
178
+ },
179
+ pending(key) {
180
+ const intent = intents.get(key);
181
+ return intent !== undefined && intent.controller === null;
182
+ },
183
+ resume() {
184
+ if (retired)
185
+ return;
186
+ for (const [key, intent] of [...intents]) {
187
+ if (intent.guided && intent.due !== null && intent.due > Date.now())
188
+ continue;
189
+ if (intent.timer !== null)
190
+ clearTimeout(intent.timer);
191
+ intent.timer = null;
192
+ intent.controller?.abort();
193
+ intent.again = null;
194
+ intent.tries = 0;
195
+ launch(key, intent);
196
+ }
197
+ },
198
+ cancel(key) {
199
+ const intent = intents.get(key);
200
+ if (intent === undefined)
201
+ return;
202
+ intent.controller?.abort();
203
+ finish(key, intent, false);
204
+ },
205
+ scope(bound = Infinity) {
206
+ const child = owner(backoff, bound, () => children.delete(child));
207
+ if (retired)
208
+ void child.retire();
209
+ else
210
+ children.add(child);
211
+ return child;
212
+ },
213
+ async retire() {
214
+ retired = true;
215
+ release();
216
+ for (const [key, intent] of [...intents]) {
217
+ intent.controller?.abort();
218
+ finish(key, intent, false);
219
+ }
220
+ await Promise.all([...children].map((child) => child.retire()));
221
+ await Promise.all(running);
222
+ },
223
+ };
224
+ return recovery;
225
+ }
226
+ export function createRecovery(options = {}) {
227
+ return owner({
228
+ firstMs: options.firstMs ?? FIRST_MS,
229
+ maxMs: options.maxMs ?? MAX_MS,
230
+ attempts: options.attempts ?? ATTEMPTS,
231
+ }, options.inFlight ?? Infinity);
232
+ }
package/dist/refresh.d.ts CHANGED
@@ -1,13 +1,27 @@
1
- import type { Adapter, AdapterFailure, Authorization, RetryableRefusal } from './adapter.js';
2
- import { type ConfirmedLayer } from './replica.js';
3
- import { type Refused, type Unconfirmed } from './transfer.js';
4
- export type RefreshOutcome = {
1
+ import type { AdapterFailure, Authorization, RefreshPage, RefreshRequest, RefreshResult, RetryableRefusal } from './adapter.js';
2
+ import type { Remodel } from './bootstrap.js';
3
+ import type { ReplicaRecord } from './replica.js';
4
+ import type { RefreshedPage } from './store.js';
5
+ import type { HeldEntry, StoredEntry } from './tables.js';
6
+ import { type Unconfirmed } from './transfer.js';
7
+ export type Advancement = {
5
8
  kind: 'still-current';
6
9
  } | {
7
10
  kind: 'advanced';
8
- confirmed: ConfirmedLayer;
11
+ record: ReplicaRecord;
12
+ changed: ReadonlySet<string>;
9
13
  } | {
10
14
  kind: 'beyond-horizon';
11
- } | RetryableRefusal | Unconfirmed | Refused | AdapterFailure;
12
- export declare function refreshRoom(adapter: Adapter, authorization: Authorization, confirmed: ConfirmedLayer, continuing: () => boolean, minPosition: string | undefined): Promise<RefreshOutcome>;
15
+ } | RetryableRefusal | Unconfirmed | AdapterFailure;
16
+ export type Refresher = (authorization: Authorization, request: RefreshRequest) => Promise<RefreshResult>;
17
+ export type Refreshing = {
18
+ turn(): void;
19
+ prior(paths: readonly string[]): Promise<ReadonlyMap<string, HeldEntry>>;
20
+ later(paths: readonly string[], roomVersion: string): Promise<ReadonlySet<string>>;
21
+ stage(page: RefreshedPage): Promise<boolean>;
22
+ };
23
+ type PageContent = Pick<RefreshPage, 'documents' | 'facts' | 'revisions' | 'fileIds' | 'created' | 'changes' | 'binaryFiles'>;
24
+ export declare function pageEntries(page: PageContent, removals: readonly string[], roomVersion: string, prior: (paths: readonly string[]) => Promise<ReadonlyMap<string, HeldEntry>>): Promise<StoredEntry[]>;
25
+ export declare function advancement(refresh: Refresher, authorization: Authorization, held: ReplicaRecord, remodel: Remodel, continuing: () => boolean, staging: Refreshing): Promise<Advancement>;
26
+ export {};
13
27
  //# sourceMappingURL=refresh.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,aAAa,EAGb,gBAAgB,EAEjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B,gBAAgB,GAChB,WAAW,GACX,OAAO,GACP,cAAc,CAAC;AAEnB,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,OAAO,EACzB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0EzB"}
1
+ {"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAG9D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B,gBAAgB,GAChB,WAAW,GACX,cAAc,CAAC;AAEnB,MAAM,MAAM,SAAS,GAAG,CACtB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C,CAAC;AASF,KAAK,WAAW,GAAG,IAAI,CACrB,WAAW,EACX,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CACxF,CAAC;AAwFF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAC3E,OAAO,CAAC,WAAW,EAAE,CAAC,CAKxB;AAgDD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,SAAS,EAClB,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,OAAO,EACzB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,WAAW,CAAC,CA8CtB"}
package/dist/refresh.js CHANGED
@@ -1,60 +1,161 @@
1
- import { declaredAttachments } from './attachment.js';
2
- import { readStaged } from './replica.js';
3
1
  import { unconfirmed } from './transfer.js';
4
- export async function refreshRoom(adapter, authorization, confirmed, continuing, minPosition) {
5
- const locator = confirmed.record.locator;
6
- const fromRoomVersion = confirmed.record.roomVersion;
7
- const first = await adapter.refresh(authorization, {
2
+ import { ROW_WEIGHT, stepped, yielded } from './turn.js';
3
+ function* listing(page, removals) {
4
+ const removed = new Set();
5
+ for (const path of removals) {
6
+ removed.add(path);
7
+ yield ROW_WEIGHT;
8
+ }
9
+ const documents = [];
10
+ const binaries = [];
11
+ const asked = [];
12
+ const written = new Set();
13
+ for (const [kept, named] of [
14
+ [documents, page.documents],
15
+ [binaries, page.binaryFiles],
16
+ ]) {
17
+ for (const path of Object.keys(named)) {
18
+ yield ROW_WEIGHT;
19
+ if (removed.has(path))
20
+ continue;
21
+ kept.push(path);
22
+ written.add(path);
23
+ if (page.revisions[path] === undefined)
24
+ asked.push(path);
25
+ }
26
+ }
27
+ const others = [];
28
+ const seen = new Set();
29
+ for (const named of [page.revisions, page.fileIds ?? {}, page.changes]) {
30
+ for (const path of Object.keys(named)) {
31
+ yield ROW_WEIGHT;
32
+ if (seen.has(path))
33
+ continue;
34
+ seen.add(path);
35
+ if (!written.has(path) && !removed.has(path))
36
+ others.push(path);
37
+ }
38
+ }
39
+ return { documents, binaries, others, asked: [...asked, ...others] };
40
+ }
41
+ function* entering(page, roomVersion, listed, prior) {
42
+ const entries = [];
43
+ for (const path of listed.documents) {
44
+ yield ROW_WEIGHT;
45
+ entries.push({
46
+ path,
47
+ content: page.documents[path],
48
+ facts: page.facts[path] ?? null,
49
+ binary: null,
50
+ revision: page.revisions[path] ?? prior.get(path)?.revision ?? null,
51
+ fileId: page.fileIds?.[path] ?? null,
52
+ created: page.created?.[path] ?? null,
53
+ change: page.changes[path] ?? null,
54
+ written: roomVersion,
55
+ });
56
+ }
57
+ for (const path of listed.binaries) {
58
+ yield ROW_WEIGHT;
59
+ entries.push({
60
+ path,
61
+ content: null,
62
+ facts: null,
63
+ binary: { state: 'accepted', ...page.binaryFiles[path] },
64
+ revision: page.revisions[path] ?? prior.get(path)?.revision ?? null,
65
+ fileId: page.fileIds?.[path] ?? null,
66
+ created: page.created?.[path] ?? null,
67
+ change: page.changes[path] ?? null,
68
+ written: null,
69
+ });
70
+ }
71
+ for (const path of listed.others) {
72
+ yield ROW_WEIGHT;
73
+ const held = prior.get(path);
74
+ if (held === undefined)
75
+ continue;
76
+ const { type: _type, ...kept } = held;
77
+ entries.push({
78
+ ...kept,
79
+ revision: page.revisions[path] ?? held.revision,
80
+ fileId: page.fileIds?.[path] ?? held.fileId,
81
+ created: page.created?.[path] ?? held.created,
82
+ change: page.changes[path] ?? held.change,
83
+ });
84
+ }
85
+ return entries;
86
+ }
87
+ export async function pageEntries(page, removals, roomVersion, prior) {
88
+ await yielded();
89
+ const listed = await stepped(listing(page, removals));
90
+ const held = listed.asked.length === 0 ? new Map() : await prior(listed.asked);
91
+ return stepped(entering(page, roomVersion, listed, held));
92
+ }
93
+ function without(named, kept) {
94
+ return Object.fromEntries(Object.entries(named).filter(([path]) => !kept.has(path)));
95
+ }
96
+ function unwritten(page, kept) {
97
+ if (kept.size === 0)
98
+ return page;
99
+ return {
100
+ ...page,
101
+ documents: without(page.documents, kept),
102
+ facts: without(page.facts, kept),
103
+ revisions: without(page.revisions, kept),
104
+ ...(page.fileIds === undefined ? {} : { fileIds: without(page.fileIds, kept) }),
105
+ ...(page.created === undefined ? {} : { created: without(page.created, kept) }),
106
+ changes: without(page.changes, kept),
107
+ binaryFiles: without(page.binaryFiles, kept),
108
+ removals: page.removals.filter((path) => !kept.has(path)),
109
+ };
110
+ }
111
+ async function pageOf(answered, roomVersion, staging) {
112
+ const page = unwritten(answered, await staging.later([
113
+ ...Object.keys(answered.documents),
114
+ ...Object.keys(answered.binaryFiles),
115
+ ...answered.removals,
116
+ ], roomVersion));
117
+ return {
118
+ entries: await pageEntries(page, page.removals, roomVersion, (paths) => staging.prior(paths)),
119
+ removals: page.removals,
120
+ folders: page.folders ?? [],
121
+ folderRemovals: page.folderRemovals ?? [],
122
+ };
123
+ }
124
+ export async function advancement(refresh, authorization, held, remodel, continuing, staging) {
125
+ const locator = held.locator;
126
+ const fromRoomVersion = held.roomVersion;
127
+ staging.turn();
128
+ if (!continuing())
129
+ return unconfirmed;
130
+ const first = await refresh(authorization, {
8
131
  locator,
9
- selection: confirmed.record.replica.selection,
132
+ selection: held.replica.selection,
10
133
  fromRoomVersion,
11
- ...(minPosition === undefined ? {} : { minPosition }),
12
134
  });
13
135
  if (first.kind !== 'net-advancement')
14
136
  return first;
15
137
  const roomVersion = first.roomVersion;
16
- const documents = { ...confirmed.record.documents };
17
- const revisions = { ...confirmed.record.revisions };
18
- const changes = { ...confirmed.record.changes };
19
- const written = { ...confirmed.record.written };
20
- const binaryTargets = new Set(confirmed.record.binaryTargets);
21
- const attachments = [];
22
- const stage = (page) => {
23
- if (page.attachments !== undefined)
24
- attachments.push(page.attachments);
25
- Object.assign(documents, page.documents);
26
- Object.assign(revisions, page.revisions);
27
- for (const path of Object.keys(page.documents)) {
28
- binaryTargets.delete(path);
29
- delete changes[path];
30
- written[path] = roomVersion;
31
- }
32
- for (const target of page.binaryTargets) {
33
- delete documents[target];
34
- delete revisions[target];
35
- delete changes[target];
36
- delete written[target];
37
- binaryTargets.add(target);
38
- }
39
- Object.assign(changes, page.changes);
40
- for (const path of page.removals) {
41
- delete documents[path];
42
- delete revisions[path];
43
- delete changes[path];
44
- delete written[path];
45
- binaryTargets.delete(path);
46
- }
138
+ const models = remodel(first.models, { collection: held.model });
139
+ const changed = new Set();
140
+ const staged = async (page) => {
141
+ const read = await pageOf(page, roomVersion, staging);
142
+ for (const { path } of read.entries)
143
+ changed.add(path);
144
+ for (const path of read.removals)
145
+ changed.add(path);
146
+ return staging.stage(read);
47
147
  };
48
- stage(first);
148
+ if (!(await staged(first)))
149
+ return unconfirmed;
49
150
  let pageToken = first.pageToken;
50
151
  while (pageToken !== undefined) {
152
+ await staging.turn();
51
153
  if (!continuing())
52
154
  return unconfirmed;
53
- const page = await adapter.refresh(authorization, {
155
+ const page = await refresh(authorization, {
54
156
  locator,
55
- selection: confirmed.record.replica.selection,
157
+ selection: held.replica.selection,
56
158
  fromRoomVersion,
57
- ...(minPosition === undefined ? {} : { minPosition }),
58
159
  pageToken,
59
160
  });
60
161
  if (page.kind === 'still-current' || page.kind === 'beyond-horizon')
@@ -63,18 +164,17 @@ export async function refreshRoom(adapter, authorization, confirmed, continuing,
63
164
  return page;
64
165
  if (page.roomVersion !== roomVersion)
65
166
  return unconfirmed;
66
- stage(page);
167
+ if (!(await staged(page)))
168
+ return unconfirmed;
67
169
  pageToken = page.pageToken;
68
170
  }
69
- const staged = readStaged({
70
- ...confirmed.record,
71
- roomVersion,
72
- documents,
73
- binaryTargets: [...binaryTargets].sort(),
74
- revisions,
75
- changes,
76
- written,
77
- attachments: attachments.length === 0 ? confirmed.record.attachments : declaredAttachments(attachments),
78
- }, confirmed);
79
- return staged.kind === 'staged' ? { kind: 'advanced', confirmed: staged.confirmed } : staged;
171
+ return {
172
+ kind: 'advanced',
173
+ record: {
174
+ ...held,
175
+ model: models.collection,
176
+ roomVersion,
177
+ },
178
+ changed,
179
+ };
80
180
  }