@instantdb/core 0.22.57 → 0.22.58

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 (60) hide show
  1. package/__tests__/src/Reactor.test.js +97 -21
  2. package/__tests__/src/utils/PersistedObject.test.ts +383 -0
  3. package/dist/commonjs/InMemoryStorage.d.ts +11 -0
  4. package/dist/commonjs/InMemoryStorage.d.ts.map +1 -0
  5. package/dist/commonjs/InMemoryStorage.js +48 -0
  6. package/dist/commonjs/InMemoryStorage.js.map +1 -0
  7. package/dist/commonjs/IndexedDBStorage.d.ts +10 -3
  8. package/dist/commonjs/IndexedDBStorage.d.ts.map +1 -1
  9. package/dist/commonjs/IndexedDBStorage.js +254 -8
  10. package/dist/commonjs/IndexedDBStorage.js.map +1 -1
  11. package/dist/commonjs/Reactor.d.ts +7 -16
  12. package/dist/commonjs/Reactor.d.ts.map +1 -1
  13. package/dist/commonjs/Reactor.js +199 -149
  14. package/dist/commonjs/Reactor.js.map +1 -1
  15. package/dist/commonjs/SyncTable.d.ts +3 -1
  16. package/dist/commonjs/SyncTable.d.ts.map +1 -1
  17. package/dist/commonjs/SyncTable.js +194 -168
  18. package/dist/commonjs/SyncTable.js.map +1 -1
  19. package/dist/commonjs/index.d.ts +2 -1
  20. package/dist/commonjs/index.d.ts.map +1 -1
  21. package/dist/commonjs/index.js +3 -1
  22. package/dist/commonjs/index.js.map +1 -1
  23. package/dist/commonjs/utils/PersistedObject.d.ts +73 -29
  24. package/dist/commonjs/utils/PersistedObject.d.ts.map +1 -1
  25. package/dist/commonjs/utils/PersistedObject.js +366 -77
  26. package/dist/commonjs/utils/PersistedObject.js.map +1 -1
  27. package/dist/esm/InMemoryStorage.d.ts +11 -0
  28. package/dist/esm/InMemoryStorage.d.ts.map +1 -0
  29. package/dist/esm/InMemoryStorage.js +45 -0
  30. package/dist/esm/InMemoryStorage.js.map +1 -0
  31. package/dist/esm/IndexedDBStorage.d.ts +10 -3
  32. package/dist/esm/IndexedDBStorage.d.ts.map +1 -1
  33. package/dist/esm/IndexedDBStorage.js +254 -8
  34. package/dist/esm/IndexedDBStorage.js.map +1 -1
  35. package/dist/esm/Reactor.d.ts +7 -16
  36. package/dist/esm/Reactor.d.ts.map +1 -1
  37. package/dist/esm/Reactor.js +199 -149
  38. package/dist/esm/Reactor.js.map +1 -1
  39. package/dist/esm/SyncTable.d.ts +3 -1
  40. package/dist/esm/SyncTable.d.ts.map +1 -1
  41. package/dist/esm/SyncTable.js +194 -168
  42. package/dist/esm/SyncTable.js.map +1 -1
  43. package/dist/esm/index.d.ts +2 -1
  44. package/dist/esm/index.d.ts.map +1 -1
  45. package/dist/esm/index.js +4 -1
  46. package/dist/esm/index.js.map +1 -1
  47. package/dist/esm/utils/PersistedObject.d.ts +73 -29
  48. package/dist/esm/utils/PersistedObject.d.ts.map +1 -1
  49. package/dist/esm/utils/PersistedObject.js +364 -76
  50. package/dist/esm/utils/PersistedObject.js.map +1 -1
  51. package/dist/standalone/index.js +1978 -1567
  52. package/dist/standalone/index.umd.cjs +3 -3
  53. package/package.json +2 -2
  54. package/src/InMemoryStorage.ts +34 -0
  55. package/src/IndexedDBStorage.ts +281 -9
  56. package/src/Reactor.js +212 -184
  57. package/src/SyncTable.ts +220 -191
  58. package/src/index.ts +8 -0
  59. package/src/utils/PersistedObject.ts +480 -109
  60. package/src/InMemoryStorage.js +0 -14
@@ -23,6 +23,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
23
23
  };
24
24
  // Uses `requestIdleCallback` if available, otherwise calls the
25
25
  // callback immediately
26
+ import { create } from 'mutative';
26
27
  function safeIdleCallback(cb, timeout) {
27
28
  if (typeof requestIdleCallback === 'undefined') {
28
29
  cb();
@@ -31,92 +32,242 @@ function safeIdleCallback(cb, timeout) {
31
32
  requestIdleCallback(cb, { timeout });
32
33
  }
33
34
  }
35
+ export const META_KEY = '__meta';
36
+ export class StorageInterface {
37
+ constructor(appId, storeName) { }
38
+ }
34
39
  export class PersistedObject {
35
- constructor(persister, key, defaultValue,
36
- /**
37
- * Merges data from storage with in-memory value on load.
38
- * If a value is returned from onMerge, that value that will
39
- * become the current value.
40
- */
41
- onMerge, serialize = (x) => {
42
- return x;
43
- }, parse = (x) => {
44
- return x;
45
- }, saveThrottleMs = 100, idleCallbackMaxWaitMs = 1000) {
40
+ constructor(opts) {
41
+ var _a, _b;
46
42
  this._subs = [];
47
43
  this._nextSave = null;
48
- this._persister = persister;
49
- this._key = key;
50
- this._onMerge = onMerge;
51
- this._loadedCbs = [];
52
- this._isLoading = true;
53
- this.currentValue = defaultValue;
54
- this.serialize = serialize;
55
- this.parse = parse;
56
- this._saveThrottleMs = saveThrottleMs;
57
- this._pendingSaveCbs = [];
44
+ this._nextGc = null;
45
+ this._pendingSaveKeys = new Set();
46
+ this._loadedKeys = new Set();
58
47
  this._version = 0;
59
- this._idleCallbackMaxWaitMs = idleCallbackMaxWaitMs;
60
- this._load();
48
+ this._meta = {
49
+ isLoading: true,
50
+ onLoadCbs: [],
51
+ value: null,
52
+ error: null,
53
+ attempts: 0,
54
+ };
55
+ this._persister = opts.persister;
56
+ this._merge = opts.merge;
57
+ this.serialize = opts.serialize;
58
+ this.parse = opts.parse;
59
+ this._objectSize = opts.objectSize;
60
+ this._log = opts.logger;
61
+ this._saveThrottleMs = (_a = opts.saveThrottleMs) !== null && _a !== void 0 ? _a : 100;
62
+ this._idleCallbackMaxWaitMs = (_b = opts.idleCallbackMaxWaitMs) !== null && _b !== void 0 ? _b : 1000;
63
+ this._gcOpts = opts.gc;
64
+ this.currentValue = {};
65
+ this._loadedKeys = new Set();
66
+ this._loadingKeys = {};
67
+ this._initMeta();
68
+ if (opts.preloadEntryCount) {
69
+ this._preloadEntries(opts.preloadEntryCount);
70
+ }
61
71
  }
62
- _getFromStorage() {
72
+ _initMeta() {
63
73
  return __awaiter(this, void 0, void 0, function* () {
74
+ var _a, _b, _c;
75
+ if (this._meta.loadingPromise) {
76
+ yield this._meta.loadingPromise;
77
+ }
64
78
  try {
65
- return this.parse(yield this._persister.getItem(this._key));
79
+ const p = this._persister.getItem(META_KEY);
80
+ this._meta.loadingPromise = p;
81
+ const v = yield p;
82
+ this._meta.isLoading = false;
83
+ this._meta.error = null;
84
+ this._meta.loadingPromise = null;
85
+ this._meta.attempts = 0;
86
+ const existingObjects = (_b = (_a = this._meta.value) === null || _a === void 0 ? void 0 : _a.objects) !== null && _b !== void 0 ? _b : {};
87
+ const value = v !== null && v !== void 0 ? v : {};
88
+ const objects = (_c = value.objects) !== null && _c !== void 0 ? _c : {};
89
+ // Merge the values from storage with in-memory values
90
+ this._meta.value = Object.assign(Object.assign({}, value), { objects: Object.assign(Object.assign({}, existingObjects), objects) });
66
91
  }
67
92
  catch (e) {
68
- console.error(`Unable to read from storage for key=${this._key}`, e);
69
- return null;
93
+ this._meta.error = e;
94
+ this._meta.attempts++;
95
+ this._meta.loadingPromise = null;
70
96
  }
71
97
  });
72
98
  }
73
- _load() {
99
+ _getMeta() {
74
100
  return __awaiter(this, void 0, void 0, function* () {
75
- const fromStorage = yield this._getFromStorage();
76
- this._isLoading = false;
77
- const mergeResult = this._onMerge(fromStorage, this.currentValue);
78
- if (mergeResult) {
79
- this.currentValue = mergeResult;
101
+ if (this._meta.value) {
102
+ return this._meta.value;
80
103
  }
81
- for (const cb of this._loadedCbs) {
82
- cb();
104
+ if (this._meta.loadingPromise) {
105
+ yield this._meta.loadingPromise;
106
+ return this._meta.value;
83
107
  }
108
+ this._initMeta();
109
+ yield this._meta.loadingPromise;
110
+ return this._meta.value;
84
111
  });
85
112
  }
86
- waitForLoaded() {
113
+ _refreshMeta() {
87
114
  return __awaiter(this, void 0, void 0, function* () {
88
- if (!this._isLoading) {
89
- return;
90
- }
91
- const loadedPromise = new Promise((resolve) => {
92
- this._loadedCbs.push(resolve);
115
+ yield this._initMeta();
116
+ return this._meta.value;
117
+ });
118
+ }
119
+ _preloadEntries(n) {
120
+ return __awaiter(this, void 0, void 0, function* () {
121
+ const meta = yield this.waitForMetaToLoad();
122
+ const entries = Object.entries(meta.objects);
123
+ entries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {
124
+ return b_meta.updatedAt - a_meta.updatedAt;
93
125
  });
94
- yield loadedPromise;
126
+ for (const [k] of entries.slice(0, n)) {
127
+ this._loadKey(k);
128
+ }
129
+ });
130
+ }
131
+ _getFromStorage(key) {
132
+ return __awaiter(this, void 0, void 0, function* () {
133
+ try {
134
+ const data = yield this._persister.getItem(key);
135
+ if (!data) {
136
+ return data;
137
+ }
138
+ const parsed = this.parse(key, data);
139
+ return parsed;
140
+ }
141
+ catch (e) {
142
+ console.error(`Unable to read from storage for key=${key}`, e);
143
+ return null;
144
+ }
95
145
  });
96
146
  }
97
- isLoading() {
98
- return this._isLoading;
147
+ waitForKeyToLoad(k) {
148
+ return __awaiter(this, void 0, void 0, function* () {
149
+ if (this._loadedKeys.has(k)) {
150
+ return this.currentValue[k];
151
+ }
152
+ yield (this._loadingKeys[k] || this._loadKey(k));
153
+ return this.currentValue[k];
154
+ });
99
155
  }
100
- version() {
101
- return this._version;
156
+ // Used for tests
157
+ waitForMetaToLoad() {
158
+ return __awaiter(this, void 0, void 0, function* () {
159
+ return this._getMeta();
160
+ });
102
161
  }
103
- waitForSync() {
162
+ // Unloads the key so that it can be garbage collected, but does not
163
+ // delete it. Removes the key from currentValue.
164
+ unloadKey(k) {
165
+ this._loadedKeys.delete(k);
166
+ delete this._loadingKeys[k];
167
+ delete this.currentValue[k];
168
+ }
169
+ _loadKey(k) {
104
170
  return __awaiter(this, void 0, void 0, function* () {
105
- if (!this._nextSave) {
171
+ if (this._loadedKeys.has(k) || k in this._loadingKeys)
106
172
  return;
173
+ const p = this._getFromStorage(k);
174
+ this._loadingKeys[k] = p;
175
+ const value = yield p;
176
+ delete this._loadingKeys[k];
177
+ this._loadedKeys.add(k);
178
+ if (value) {
179
+ const merged = this._merge(k, value, this.currentValue[k]);
180
+ if (merged) {
181
+ this.currentValue[k] = merged;
182
+ }
107
183
  }
108
- const syncedPromise = new Promise((resolve) => {
109
- this._pendingSaveCbs.push(resolve);
110
- });
111
- yield syncedPromise;
184
+ this.onKeyLoaded && this.onKeyLoaded(k);
112
185
  });
113
186
  }
114
- _writeToStorage() {
115
- this._persister.setItem(this._key, this.serialize(this.currentValue));
116
- for (const cb of this._pendingSaveCbs) {
117
- cb();
187
+ // Returns a promise with a number so that we can wait for flush
188
+ // to finish in the tests. The number is the number of operations
189
+ // it performed, but it's mostly there so that typescript will warn
190
+ // us if we forget to retun the promise from the function.
191
+ _writeToStorage(opts) {
192
+ var _a, _b;
193
+ const promises = [];
194
+ const skipGc = opts === null || opts === void 0 ? void 0 : opts.skipGc;
195
+ if (this._meta.isLoading) {
196
+ // Wait for meta to load and try again, give it a delay so that
197
+ // we don't spend too much time retrying
198
+ const p = new Promise((resolve, reject) => {
199
+ var _a;
200
+ setTimeout(() => this._enqueuePersist(opts
201
+ ? Object.assign(Object.assign({}, opts), { attempts: (opts.attempts || 0) + 1 }) : { attempts: 1 })
202
+ .then(resolve)
203
+ .catch(reject), 10 + ((_a = opts === null || opts === void 0 ? void 0 : opts.attempts) !== null && _a !== void 0 ? _a : 0) * 1000);
204
+ });
205
+ promises.push(p);
206
+ return Promise.all(promises).then((vs) => vs.reduce((acc, x) => acc + x, 0));
207
+ }
208
+ const metaValue = this._meta.value;
209
+ if (!metaValue) {
210
+ // If it's not loading and we don't have the data, then there
211
+ // must be an error and we're not going to be able to save until
212
+ // the error is resolved elsewhere.
213
+ return Promise.resolve(0);
214
+ }
215
+ const keysToDelete = [];
216
+ const keysToUpdate = [];
217
+ for (const k of this._pendingSaveKeys) {
218
+ if (!(k in this.currentValue)) {
219
+ keysToDelete.push(k);
220
+ delete metaValue.objects[k];
221
+ }
222
+ else {
223
+ keysToUpdate.push(k);
224
+ }
118
225
  }
119
- this._pendingSaveCbs.length = 0;
226
+ for (const k of keysToDelete) {
227
+ const p = this._persister.removeItem(k);
228
+ promises.push(p.then(() => 1));
229
+ this._loadedKeys.delete(k);
230
+ this._pendingSaveKeys.delete(k);
231
+ }
232
+ const keysToLoad = [];
233
+ const kvPairs = [[META_KEY, metaValue]];
234
+ const metaObjects = (_a = metaValue.objects) !== null && _a !== void 0 ? _a : {};
235
+ metaValue.objects = metaObjects;
236
+ for (const k of keysToUpdate) {
237
+ if (this._loadedKeys.has(k)) {
238
+ const serializedV = this.serialize(k, this.currentValue[k]);
239
+ kvPairs.push([k, serializedV]);
240
+ const size = this._objectSize(serializedV);
241
+ const m = (_b = metaObjects[k]) !== null && _b !== void 0 ? _b : {
242
+ createdAt: Date.now(),
243
+ updatedAt: Date.now(),
244
+ size,
245
+ };
246
+ m.updatedAt = Date.now();
247
+ m.size = size;
248
+ metaObjects[k] = m;
249
+ this._pendingSaveKeys.delete(k);
250
+ }
251
+ else {
252
+ keysToLoad.push(k);
253
+ }
254
+ }
255
+ const p = this._persister.multiSet(kvPairs);
256
+ promises.push(p.then(() => 1));
257
+ // For the keys that haven't loaded, load the key then try
258
+ // persisting again. We don't want to do any async work here
259
+ // or else we might end up saving older copies of the data to
260
+ // the store.
261
+ for (const k of keysToLoad) {
262
+ const p = this._loadKey(k).then(() => this._enqueuePersist(opts));
263
+ promises.push(p);
264
+ }
265
+ if (!skipGc) {
266
+ this.gc();
267
+ }
268
+ return Promise.all(promises).then((vs) => {
269
+ return vs.reduce((acc, x) => acc + x, 0);
270
+ });
120
271
  }
121
272
  flush() {
122
273
  return __awaiter(this, void 0, void 0, function* () {
@@ -124,36 +275,173 @@ export class PersistedObject {
124
275
  return;
125
276
  }
126
277
  clearTimeout(this._nextSave);
127
- this._writeToStorage();
278
+ this._nextSave = null;
279
+ const p = this._writeToStorage();
280
+ return p;
128
281
  });
129
282
  }
130
- _enqueuePersist(cb) {
131
- if (this._nextSave) {
132
- if (cb) {
133
- this._pendingSaveCbs.push(cb);
283
+ _gc() {
284
+ return __awaiter(this, void 0, void 0, function* () {
285
+ if (!this._gcOpts) {
286
+ return;
287
+ }
288
+ const keys = new Set(yield this._persister.getAllKeys());
289
+ keys.delete(META_KEY);
290
+ // Keys we can't delete
291
+ const sacredKeys = new Set(Object.keys(this.currentValue));
292
+ for (const k of Object.keys(this._loadingKeys)) {
293
+ sacredKeys.add(k);
294
+ }
295
+ for (const k of this._loadedKeys) {
296
+ sacredKeys.add(k);
297
+ }
298
+ // Refresh meta from the store so that we're less likely to
299
+ // clobber data from other tabs
300
+ const meta = yield this._refreshMeta();
301
+ if (!meta) {
302
+ this._log.info('Could not gc because we were not able to load meta');
303
+ return;
304
+ }
305
+ const promises = [];
306
+ const deets = {
307
+ gcOpts: this._gcOpts,
308
+ keys,
309
+ sacredKeys,
310
+ removed: [],
311
+ metaRemoved: [],
312
+ removedMissingCount: 0,
313
+ removedOldCount: 0,
314
+ removedThresholdCount: 0,
315
+ removedSizeCount: 0,
316
+ };
317
+ // First, remove all keys we don't know about
318
+ for (const key of keys) {
319
+ if (sacredKeys.has(key) || key in meta.objects) {
320
+ continue;
321
+ }
322
+ this._log.info('Lost track of key in meta', key);
323
+ promises.push(this._persister.removeItem(key));
324
+ deets.removed.push(key);
325
+ deets.removedMissingCount++;
326
+ }
327
+ // Remove anything over the max age
328
+ const now = Date.now();
329
+ for (const [k, m] of Object.entries(meta.objects)) {
330
+ if (!sacredKeys.has(k) &&
331
+ m.updatedAt < now - this._gcOpts.maxAgeMs) {
332
+ promises.push(this._persister.removeItem(k));
333
+ delete meta.objects[k];
334
+ deets.removed.push(k);
335
+ deets.removedOldCount++;
336
+ }
337
+ }
338
+ // Keep queries under max queries
339
+ const maxEntries = Object.entries(meta.objects);
340
+ maxEntries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {
341
+ return a_meta.updatedAt - b_meta.updatedAt;
342
+ });
343
+ const deletableMaxEntries = maxEntries.filter(([x]) => !sacredKeys.has(x));
344
+ if (maxEntries.length > this._gcOpts.maxEntries) {
345
+ for (const [k] of deletableMaxEntries.slice(0, maxEntries.length - this._gcOpts.maxEntries)) {
346
+ promises.push(this._persister.removeItem(k));
347
+ delete meta.objects[k];
348
+ deets.removed.push(k);
349
+ deets.removedThresholdCount++;
350
+ }
134
351
  }
352
+ // Remove oldest entries until we are under max size
353
+ const delEntries = Object.entries(meta.objects);
354
+ delEntries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {
355
+ return a_meta.updatedAt - b_meta.updatedAt;
356
+ });
357
+ const deletableDelEntries = delEntries.filter(([x]) => !sacredKeys.has(x));
358
+ let currentSize = delEntries.reduce((acc, [_k, m]) => {
359
+ return acc + m.size;
360
+ }, 0);
361
+ while (currentSize > 0 &&
362
+ currentSize > this._gcOpts.maxSize &&
363
+ deletableDelEntries.length) {
364
+ const [[k, m]] = deletableDelEntries.splice(0, 1);
365
+ currentSize -= m.size;
366
+ promises.push(this._persister.removeItem(k));
367
+ delete meta.objects[k];
368
+ deets.removed.push(k);
369
+ deets.removedSizeCount++;
370
+ }
371
+ // Update meta to remove keys that are no longer in the store
372
+ for (const k of Object.keys(meta.objects)) {
373
+ if (!keys.has(k) && !sacredKeys.has(k)) {
374
+ delete meta.objects[k];
375
+ }
376
+ }
377
+ if (deets.removed.length || deets.metaRemoved.length) {
378
+ // Trigger a flush of the meta
379
+ promises.push(this._enqueuePersist({ skipGc: true }));
380
+ }
381
+ this._log.info('Completed GC', deets);
382
+ yield Promise.all(promises);
383
+ return deets;
384
+ });
385
+ }
386
+ // Schedules a GC to run in one minute (unless it is already scheduled)
387
+ gc() {
388
+ if (this._nextGc) {
135
389
  return;
136
390
  }
137
- this._nextSave = setTimeout(() => {
391
+ this._nextGc = setTimeout(() => {
138
392
  safeIdleCallback(() => {
139
- this._nextSave = null;
140
- this._writeToStorage();
141
- }, this._idleCallbackMaxWaitMs);
142
- }, this._saveThrottleMs);
393
+ this._nextGc = null;
394
+ this._gc();
395
+ }, 30 * 1000);
396
+ },
397
+ // 1 minute + some jitter to keep multiple tabs from running at same time
398
+ 1000 * 60 + Math.random() * 500);
399
+ }
400
+ _enqueuePersist(opts) {
401
+ return new Promise((resolve, reject) => {
402
+ if (this._nextSave) {
403
+ resolve(0);
404
+ return;
405
+ }
406
+ this._nextSave = setTimeout(() => {
407
+ safeIdleCallback(() => {
408
+ this._nextSave = null;
409
+ this._writeToStorage(opts).then(resolve).catch(reject);
410
+ }, this._idleCallbackMaxWaitMs);
411
+ }, this._saveThrottleMs);
412
+ });
413
+ }
414
+ version() {
415
+ return this._version;
143
416
  }
144
- set(f, cb) {
417
+ // Takes a function that updates the store in place.
418
+ // Uses `mutative` to get a list of keys that were changed
419
+ // so that we know which entries we need to persist to the store.
420
+ updateInPlace(f) {
145
421
  this._version++;
146
- this.currentValue = f(this.currentValue);
147
- if (this._isLoading) {
148
- this._loadedCbs.push(() => this._enqueuePersist(cb));
422
+ const [state, patches] = create(this.currentValue, f, {
423
+ enablePatches: true,
424
+ });
425
+ for (const patch of patches) {
426
+ const k = patch.path[0];
427
+ if (k && typeof k === 'string') {
428
+ this._pendingSaveKeys.add(k);
429
+ if (!this._loadedKeys.has(k)) {
430
+ this._loadKey(k);
431
+ }
432
+ }
149
433
  }
150
- else {
151
- this._enqueuePersist(cb);
434
+ for (const k of Object.keys(state)) {
435
+ if (!state[k]) {
436
+ debugger;
437
+ }
152
438
  }
153
- for (const sub of this._subs) {
154
- sub(this.currentValue);
439
+ this.currentValue = state;
440
+ this._enqueuePersist();
441
+ for (const cb of this._subs) {
442
+ cb(this.currentValue);
155
443
  }
156
- return this.currentValue;
444
+ return state;
157
445
  }
158
446
  subscribe(cb) {
159
447
  this._subs.push(cb);
@@ -1 +1 @@
1
- {"version":3,"file":"PersistedObject.js","sourceRoot":"","sources":["../../../src/utils/PersistedObject.ts"],"names":[],"mappings":"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","sourcesContent":["// PersistedObjects save data outside of memory.\n//\n// When we load a persisted object, it's possible we call `set`\n// before we finish loading. To address we handle set in two ways:\n//\n// 1. Before load\n// We simply update currentValue in memory\n//\n// 2. After load\n// We update currentValue in memory and in storage\n//\n// Each PersistedObject provides it's own `onMerge`\n// function to handle the merge of data from storage and memory\n// on load\n\n// Uses `requestIdleCallback` if available, otherwise calls the\n// callback immediately\nfunction safeIdleCallback(cb, timeout: number) {\n if (typeof requestIdleCallback === 'undefined') {\n cb();\n } else {\n requestIdleCallback(cb, { timeout });\n }\n}\n\nexport class PersistedObject<T> {\n _subs = [];\n _persister: Storage;\n _key: string;\n _onMerge: (fromStorage: T, inMemoryValue: T) => T | void;\n _loadedCbs: Array<() => void>;\n _isLoading: boolean;\n currentValue: T;\n serialize: (input: T) => any;\n parse: (input: any) => T;\n _saveThrottleMs: number;\n _idleCallbackMaxWaitMs: number;\n _pendingSaveCbs: Array<() => void>;\n _version: number;\n _nextSave: null | NodeJS.Timeout = null;\n\n constructor(\n persister: Storage,\n key: string,\n defaultValue: T,\n /**\n * Merges data from storage with in-memory value on load.\n * If a value is returned from onMerge, that value that will\n * become the current value.\n */\n onMerge: (fromStorage: T, inMemoryValue: T) => T | void,\n serialize = (x: T): any => {\n return x;\n },\n parse = (x: any): T => {\n return x;\n },\n saveThrottleMs = 100,\n idleCallbackMaxWaitMs = 1000,\n ) {\n this._persister = persister;\n this._key = key;\n\n this._onMerge = onMerge;\n\n this._loadedCbs = [];\n this._isLoading = true;\n this.currentValue = defaultValue;\n this.serialize = serialize;\n this.parse = parse;\n this._saveThrottleMs = saveThrottleMs;\n this._pendingSaveCbs = [];\n this._version = 0;\n this._idleCallbackMaxWaitMs = idleCallbackMaxWaitMs;\n\n this._load();\n }\n\n async _getFromStorage() {\n try {\n return this.parse(await this._persister.getItem(this._key));\n } catch (e) {\n console.error(`Unable to read from storage for key=${this._key}`, e);\n return null;\n }\n }\n\n async _load() {\n const fromStorage = await this._getFromStorage();\n this._isLoading = false;\n\n const mergeResult = this._onMerge(fromStorage, this.currentValue);\n if (mergeResult) {\n this.currentValue = mergeResult;\n }\n for (const cb of this._loadedCbs) {\n cb();\n }\n }\n\n async waitForLoaded(): Promise<void> {\n if (!this._isLoading) {\n return;\n }\n const loadedPromise = new Promise<void>((resolve) => {\n this._loadedCbs.push(resolve);\n });\n await loadedPromise;\n }\n\n isLoading() {\n return this._isLoading;\n }\n\n version() {\n return this._version;\n }\n\n async waitForSync() {\n if (!this._nextSave) {\n return;\n }\n const syncedPromise = new Promise<void>((resolve) => {\n this._pendingSaveCbs.push(resolve);\n });\n await syncedPromise;\n }\n\n _writeToStorage() {\n this._persister.setItem(this._key, this.serialize(this.currentValue));\n for (const cb of this._pendingSaveCbs) {\n cb();\n }\n this._pendingSaveCbs.length = 0;\n }\n\n async flush() {\n if (!this._nextSave) {\n return;\n }\n clearTimeout(this._nextSave);\n this._writeToStorage();\n }\n\n _enqueuePersist(cb) {\n if (this._nextSave) {\n if (cb) {\n this._pendingSaveCbs.push(cb);\n }\n return;\n }\n this._nextSave = setTimeout(() => {\n safeIdleCallback(() => {\n this._nextSave = null;\n this._writeToStorage();\n }, this._idleCallbackMaxWaitMs);\n }, this._saveThrottleMs);\n }\n\n set(f: (prev: T) => T, cb?: () => void): T {\n this._version++;\n this.currentValue = f(this.currentValue);\n if (this._isLoading) {\n this._loadedCbs.push(() => this._enqueuePersist(cb));\n } else {\n this._enqueuePersist(cb);\n }\n for (const sub of this._subs) {\n sub(this.currentValue);\n }\n return this.currentValue;\n }\n\n subscribe(cb) {\n this._subs.push(cb);\n cb(this.currentValue);\n\n return () => {\n this._subs = this._subs.filter((x) => x !== cb);\n };\n }\n}\n"]}
1
+ {"version":3,"file":"PersistedObject.js","sourceRoot":"","sources":["../../../src/utils/PersistedObject.ts"],"names":[],"mappings":"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","sourcesContent":["// PersistedObjects save data outside of memory.\n//\n// When we load a persisted object, it's possible we call `set`\n// before we finish loading. To address we handle set in two ways:\n//\n// 1. Before load\n// We simply update currentValue in memory\n//\n// 2. After load\n// We update currentValue in memory and in storage\n//\n// Each PersistedObject provides it's own `onMerge`\n// function to handle the merge of data from storage and memory\n// on load\n\n// Uses `requestIdleCallback` if available, otherwise calls the\n// callback immediately\n\nimport { create } from 'mutative';\nimport type { Logger } from './log.ts';\n\nfunction safeIdleCallback(cb, timeout: number) {\n if (typeof requestIdleCallback === 'undefined') {\n cb();\n } else {\n requestIdleCallback(cb, { timeout });\n }\n}\n\nexport const META_KEY = '__meta';\n\nexport type ObjectMeta = { createdAt: number; updatedAt: number; size: number };\n\nexport type Meta<K extends string> = {\n objects: Record<K, ObjectMeta>;\n};\n\nexport type StorageInterfaceStoreName = 'kv' | 'querySubs' | 'syncSubs';\n\nexport abstract class StorageInterface {\n constructor(appId: string, storeName: StorageInterfaceStoreName) {}\n abstract getItem(key: string): Promise<any>;\n abstract removeItem(key: string): Promise<void>;\n abstract multiSet(keyValuePairs: Array<[string, any]>): Promise<void>;\n abstract getAllKeys(): Promise<string[]>;\n}\n\nexport type GCOpts = {\n maxSize: number;\n maxAgeMs: number;\n maxEntries: number;\n};\n\nexport type Opts<K, T, SerializedT> = {\n persister: StorageInterface;\n /**\n * Merges data from storage with in-memory value on load.\n * The value returned from merge will become the current value.\n */\n merge: (\n key: K,\n fromStorage: T | null | undefined,\n inMemoryValue: T | null | undefined,\n ) => T;\n serialize: (key: K, input: T) => SerializedT;\n parse: (key: K, value: SerializedT) => T;\n objectSize: (x: SerializedT) => number;\n logger: Logger;\n gc: GCOpts | null | undefined;\n saveThrottleMs?: number | null | undefined;\n idleCallbackMaxWaitMs?: number | null | undefined;\n preloadEntryCount?: number | null | undefined;\n};\n\nexport class PersistedObject<K extends string, T, SerializedT> {\n currentValue: Record<K, T>;\n private _subs = [];\n private _persister: StorageInterface;\n private _merge: (key: K, fromStorage: T, inMemoryValue: T) => T;\n private serialize: (key: K, input: T) => SerializedT;\n private parse: (key: K, value: SerializedT) => T;\n private _saveThrottleMs: number;\n private _idleCallbackMaxWaitMs: number;\n private _nextSave: null | NodeJS.Timeout = null;\n private _nextGc: null | NodeJS.Timeout = null;\n private _pendingSaveKeys: Set<K> = new Set();\n private _loadedKeys: Set<K> = new Set();\n private _loadingKeys: Record<K, Promise<T>>;\n private _objectSize: (serializedObject: SerializedT) => number;\n private _log: Logger;\n\n onKeyLoaded: (key: string) => void | null | undefined;\n private _version = 0;\n private _meta: {\n isLoading: boolean;\n onLoadCbs: Array<() => void>;\n value: null | Meta<K>;\n error: null | Error;\n attempts: number;\n loadingPromise?: Promise<Meta<K>> | null | undefined;\n } = {\n isLoading: true,\n onLoadCbs: [],\n value: null,\n error: null,\n attempts: 0,\n };\n private _gcOpts: GCOpts;\n\n constructor(opts: Opts<K, T, SerializedT>) {\n this._persister = opts.persister;\n this._merge = opts.merge;\n this.serialize = opts.serialize;\n this.parse = opts.parse;\n this._objectSize = opts.objectSize;\n this._log = opts.logger;\n this._saveThrottleMs = opts.saveThrottleMs ?? 100;\n this._idleCallbackMaxWaitMs = opts.idleCallbackMaxWaitMs ?? 1000;\n this._gcOpts = opts.gc;\n this.currentValue = {} as Record<K, T>;\n this._loadedKeys = new Set();\n this._loadingKeys = {} as Record<K, Promise<T>>;\n this._initMeta();\n if (opts.preloadEntryCount) {\n this._preloadEntries(opts.preloadEntryCount);\n }\n }\n\n private async _initMeta() {\n if (this._meta.loadingPromise) {\n await this._meta.loadingPromise;\n }\n try {\n const p = this._persister.getItem(META_KEY);\n this._meta.loadingPromise = p;\n const v = await p;\n this._meta.isLoading = false;\n this._meta.error = null;\n this._meta.loadingPromise = null;\n this._meta.attempts = 0;\n const existingObjects = this._meta.value?.objects ?? {};\n const value = v ?? {};\n const objects = value.objects ?? {};\n // Merge the values from storage with in-memory values\n this._meta.value = {\n ...value,\n objects: { ...existingObjects, ...objects },\n } as Meta<K>;\n } catch (e) {\n this._meta.error = e;\n this._meta.attempts++;\n this._meta.loadingPromise = null;\n }\n }\n\n private async _getMeta(): Promise<Meta<K>> {\n if (this._meta.value) {\n return this._meta.value;\n }\n if (this._meta.loadingPromise) {\n await this._meta.loadingPromise;\n return this._meta.value;\n }\n this._initMeta();\n await this._meta.loadingPromise;\n return this._meta.value;\n }\n\n private async _refreshMeta(): Promise<Meta<K>> {\n await this._initMeta();\n return this._meta.value;\n }\n\n private async _preloadEntries(n: number) {\n const meta = await this.waitForMetaToLoad();\n const entries = Object.entries(meta.objects) as Array<[K, ObjectMeta]>;\n entries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {\n return b_meta.updatedAt - a_meta.updatedAt;\n });\n for (const [k] of entries.slice(0, n)) {\n this._loadKey(k);\n }\n }\n\n private async _getFromStorage(key: K) {\n try {\n const data = await this._persister.getItem(key);\n if (!data) {\n return data;\n }\n const parsed = this.parse(key, data as SerializedT);\n return parsed;\n } catch (e) {\n console.error(`Unable to read from storage for key=${key}`, e);\n return null;\n }\n }\n\n public async waitForKeyToLoad(k: K) {\n if (this._loadedKeys.has(k)) {\n return this.currentValue[k];\n }\n await (this._loadingKeys[k] || this._loadKey(k));\n return this.currentValue[k];\n }\n\n // Used for tests\n public async waitForMetaToLoad() {\n return this._getMeta();\n }\n\n // Unloads the key so that it can be garbage collected, but does not\n // delete it. Removes the key from currentValue.\n public unloadKey(k: K) {\n this._loadedKeys.delete(k);\n delete this._loadingKeys[k];\n delete this.currentValue[k];\n }\n\n private async _loadKey(k: K) {\n if (this._loadedKeys.has(k) || k in this._loadingKeys) return;\n const p = this._getFromStorage(k);\n this._loadingKeys[k] = p;\n const value = await p;\n delete this._loadingKeys[k];\n this._loadedKeys.add(k);\n\n if (value) {\n const merged = this._merge(k, value, this.currentValue[k]);\n if (merged) {\n this.currentValue[k] = merged;\n }\n }\n this.onKeyLoaded && this.onKeyLoaded(k);\n }\n\n // Returns a promise with a number so that we can wait for flush\n // to finish in the tests. The number is the number of operations\n // it performed, but it's mostly there so that typescript will warn\n // us if we forget to retun the promise from the function.\n private _writeToStorage(opts?: {\n skipGc?: boolean | null | undefined;\n attempts?: number | null | undefined;\n }): Promise<number> {\n const promises: Promise<number>[] = [];\n const skipGc = opts?.skipGc;\n if (this._meta.isLoading) {\n // Wait for meta to load and try again, give it a delay so that\n // we don't spend too much time retrying\n const p: Promise<number> = new Promise((resolve, reject) => {\n setTimeout(\n () =>\n this._enqueuePersist(\n opts\n ? { ...opts, attempts: (opts.attempts || 0) + 1 }\n : { attempts: 1 },\n )\n .then(resolve)\n .catch(reject),\n 10 + (opts?.attempts ?? 0) * 1000,\n );\n });\n promises.push(p);\n return Promise.all(promises).then((vs) =>\n vs.reduce((acc, x) => acc + x, 0),\n );\n }\n const metaValue = this._meta.value;\n if (!metaValue) {\n // If it's not loading and we don't have the data, then there\n // must be an error and we're not going to be able to save until\n // the error is resolved elsewhere.\n return Promise.resolve(0);\n }\n const keysToDelete = [];\n const keysToUpdate = [];\n for (const k of this._pendingSaveKeys) {\n if (!(k in this.currentValue)) {\n keysToDelete.push(k);\n delete metaValue.objects[k];\n } else {\n keysToUpdate.push(k);\n }\n }\n\n for (const k of keysToDelete) {\n const p = this._persister.removeItem(k);\n promises.push(p.then(() => 1));\n this._loadedKeys.delete(k);\n this._pendingSaveKeys.delete(k);\n }\n\n const keysToLoad = [];\n\n const kvPairs: Array<[string, any]> = [[META_KEY, metaValue]];\n const metaObjects: Meta<K>['objects'] =\n metaValue.objects ?? ({} as Meta<K>['objects']);\n metaValue.objects = metaObjects;\n for (const k of keysToUpdate) {\n if (this._loadedKeys.has(k)) {\n const serializedV = this.serialize(k, this.currentValue[k]);\n kvPairs.push([k, serializedV]);\n const size = this._objectSize(serializedV);\n const m = metaObjects[k] ?? {\n createdAt: Date.now(),\n updatedAt: Date.now(),\n size,\n };\n m.updatedAt = Date.now();\n m.size = size;\n metaObjects[k] = m;\n this._pendingSaveKeys.delete(k);\n } else {\n keysToLoad.push(k);\n }\n }\n\n const p = this._persister.multiSet(kvPairs);\n promises.push(p.then(() => 1));\n\n // For the keys that haven't loaded, load the key then try\n // persisting again. We don't want to do any async work here\n // or else we might end up saving older copies of the data to\n // the store.\n for (const k of keysToLoad) {\n const p = this._loadKey(k).then(() => this._enqueuePersist(opts));\n promises.push(p);\n }\n\n if (!skipGc) {\n this.gc();\n }\n\n return Promise.all(promises).then((vs) => {\n return vs.reduce((acc, x) => acc + x, 0);\n });\n }\n\n async flush() {\n if (!this._nextSave) {\n return;\n }\n clearTimeout(this._nextSave);\n this._nextSave = null;\n const p = this._writeToStorage();\n return p;\n }\n\n private async _gc() {\n if (!this._gcOpts) {\n return;\n }\n const keys = new Set(await this._persister.getAllKeys());\n keys.delete(META_KEY);\n\n // Keys we can't delete\n const sacredKeys = new Set(Object.keys(this.currentValue));\n for (const k of Object.keys(this._loadingKeys)) {\n sacredKeys.add(k);\n }\n for (const k of this._loadedKeys) {\n sacredKeys.add(k);\n }\n\n // Refresh meta from the store so that we're less likely to\n // clobber data from other tabs\n const meta = await this._refreshMeta();\n if (!meta) {\n this._log.info('Could not gc because we were not able to load meta');\n return;\n }\n\n const promises = [];\n\n const deets = {\n gcOpts: this._gcOpts,\n keys,\n sacredKeys,\n removed: [],\n metaRemoved: [],\n removedMissingCount: 0,\n removedOldCount: 0,\n removedThresholdCount: 0,\n removedSizeCount: 0,\n };\n\n // First, remove all keys we don't know about\n for (const key of keys) {\n if (sacredKeys.has(key) || key in meta.objects) {\n continue;\n }\n this._log.info('Lost track of key in meta', key);\n promises.push(this._persister.removeItem(key));\n deets.removed.push(key);\n deets.removedMissingCount++;\n }\n\n // Remove anything over the max age\n const now = Date.now();\n for (const [k, m] of Object.entries(meta.objects)) {\n if (\n !sacredKeys.has(k) &&\n (m as ObjectMeta).updatedAt < now - this._gcOpts.maxAgeMs\n ) {\n promises.push(this._persister.removeItem(k));\n delete meta.objects[k];\n deets.removed.push(k);\n deets.removedOldCount++;\n }\n }\n\n // Keep queries under max queries\n const maxEntries = Object.entries(meta.objects) as Array<[K, ObjectMeta]>;\n maxEntries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {\n return a_meta.updatedAt - b_meta.updatedAt;\n });\n\n const deletableMaxEntries = maxEntries.filter(([x]) => !sacredKeys.has(x));\n if (maxEntries.length > this._gcOpts.maxEntries) {\n for (const [k] of deletableMaxEntries.slice(\n 0,\n maxEntries.length - this._gcOpts.maxEntries,\n )) {\n promises.push(this._persister.removeItem(k));\n delete meta.objects[k];\n deets.removed.push(k);\n deets.removedThresholdCount++;\n }\n }\n\n // Remove oldest entries until we are under max size\n const delEntries = Object.entries(meta.objects) as Array<[K, ObjectMeta]>;\n delEntries.sort(([_k_a, a_meta], [_k_b, b_meta]) => {\n return a_meta.updatedAt - b_meta.updatedAt;\n });\n const deletableDelEntries = delEntries.filter(([x]) => !sacredKeys.has(x));\n\n let currentSize = delEntries.reduce((acc, [_k, m]) => {\n return acc + m.size;\n }, 0);\n\n while (\n currentSize > 0 &&\n currentSize > this._gcOpts.maxSize &&\n deletableDelEntries.length\n ) {\n const [[k, m]] = deletableDelEntries.splice(0, 1);\n currentSize -= m.size;\n promises.push(this._persister.removeItem(k));\n delete meta.objects[k];\n deets.removed.push(k);\n deets.removedSizeCount++;\n }\n\n // Update meta to remove keys that are no longer in the store\n for (const k of Object.keys(meta.objects)) {\n if (!keys.has(k) && !sacredKeys.has(k)) {\n delete meta.objects[k];\n }\n }\n\n if (deets.removed.length || deets.metaRemoved.length) {\n // Trigger a flush of the meta\n promises.push(this._enqueuePersist({ skipGc: true }));\n }\n\n this._log.info('Completed GC', deets);\n\n await Promise.all(promises);\n return deets;\n }\n\n // Schedules a GC to run in one minute (unless it is already scheduled)\n gc() {\n if (this._nextGc) {\n return;\n }\n this._nextGc = setTimeout(\n () => {\n safeIdleCallback(() => {\n this._nextGc = null;\n this._gc();\n }, 30 * 1000);\n },\n // 1 minute + some jitter to keep multiple tabs from running at same time\n 1000 * 60 + Math.random() * 500,\n );\n }\n\n private _enqueuePersist(opts?: {\n skipGc?: boolean | null | undefined;\n attempts?: number | null | undefined;\n }): Promise<number> {\n return new Promise((resolve, reject) => {\n if (this._nextSave) {\n resolve(0);\n return;\n }\n\n this._nextSave = setTimeout(() => {\n safeIdleCallback(() => {\n this._nextSave = null;\n this._writeToStorage(opts).then(resolve).catch(reject);\n }, this._idleCallbackMaxWaitMs);\n }, this._saveThrottleMs);\n });\n }\n\n version() {\n return this._version;\n }\n\n // Takes a function that updates the store in place.\n // Uses `mutative` to get a list of keys that were changed\n // so that we know which entries we need to persist to the store.\n public updateInPlace(f: (prev: Record<string, T>) => void) {\n this._version++;\n const [state, patches] = create(this.currentValue, f, {\n enablePatches: true,\n });\n for (const patch of patches) {\n const k = patch.path[0];\n if (k && typeof k === 'string') {\n this._pendingSaveKeys.add(k as K);\n if (!this._loadedKeys.has(k as K)) {\n this._loadKey(k as K);\n }\n }\n }\n\n for (const k of Object.keys(state)) {\n if (!state[k]) {\n debugger;\n }\n }\n\n this.currentValue = state;\n this._enqueuePersist();\n for (const cb of this._subs) {\n cb(this.currentValue);\n }\n return state;\n }\n\n public subscribe(cb: (value: Record<K, T>) => void) {\n this._subs.push(cb);\n cb(this.currentValue);\n\n return () => {\n this._subs = this._subs.filter((x) => x !== cb);\n };\n }\n}\n"]}