@signaldb/svelte 2.0.0-beta.6 → 2.0.0-beta.7

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 (89) hide show
  1. package/dist/base/core/src/AsyncDataAdapter.d.ts +64 -0
  2. package/dist/base/core/src/AsyncDataAdapter.js +450 -0
  3. package/dist/base/core/src/AutoFetchDataAdapter.d.ts +112 -0
  4. package/dist/base/core/src/AutoFetchDataAdapter.js +652 -0
  5. package/dist/base/core/src/Collection/Cursor.d.ts +113 -0
  6. package/dist/base/core/src/Collection/Cursor.js +293 -0
  7. package/dist/base/core/src/Collection/Observer.d.ts +64 -0
  8. package/dist/base/core/src/Collection/Observer.js +181 -0
  9. package/dist/base/core/src/Collection/index.d.ts +294 -0
  10. package/dist/base/core/src/Collection/index.js +580 -0
  11. package/dist/base/core/src/Collection/types.d.ts +28 -0
  12. package/dist/base/core/src/Collection/types.js +2 -0
  13. package/dist/base/core/src/DataAdapter.d.ts +35 -0
  14. package/dist/base/core/src/DataAdapter.js +2 -0
  15. package/dist/base/core/src/DefaultDataAdapter.d.ts +35 -0
  16. package/dist/base/core/src/DefaultDataAdapter.js +398 -0
  17. package/dist/base/core/src/WorkerDataAdapter.d.ts +25 -0
  18. package/dist/base/core/src/WorkerDataAdapter.js +211 -0
  19. package/dist/base/core/src/WorkerDataAdapterHost.d.ts +62 -0
  20. package/dist/base/core/src/WorkerDataAdapterHost.js +409 -0
  21. package/dist/base/core/src/createIndex.d.ts +7 -0
  22. package/dist/base/core/src/createIndex.js +120 -0
  23. package/dist/base/core/src/createIndexProvider.d.ts +8 -0
  24. package/dist/base/core/src/createIndexProvider.js +11 -0
  25. package/dist/base/core/src/createReactivityAdapter.d.ts +8 -0
  26. package/dist/base/core/src/createReactivityAdapter.js +11 -0
  27. package/dist/base/core/src/createStorageAdapter.d.ts +9 -0
  28. package/dist/base/core/src/createStorageAdapter.js +11 -0
  29. package/dist/base/core/src/getIndexInfo.d.ts +39 -0
  30. package/dist/base/core/src/getIndexInfo.js +176 -0
  31. package/dist/base/core/src/index.d.ts +22 -0
  32. package/dist/base/core/src/index.js +39 -0
  33. package/dist/base/core/src/types/Dependency.d.ts +4 -0
  34. package/dist/base/core/src/types/Dependency.js +2 -0
  35. package/dist/base/core/src/types/IndexProvider.d.ts +26 -0
  36. package/dist/base/core/src/types/IndexProvider.js +2 -0
  37. package/dist/base/core/src/types/Modifier.d.ts +46 -0
  38. package/dist/base/core/src/types/Modifier.js +3 -0
  39. package/dist/base/core/src/types/ReactivityAdapter.d.ts +6 -0
  40. package/dist/base/core/src/types/ReactivityAdapter.js +2 -0
  41. package/dist/base/core/src/types/Selector.d.ts +46 -0
  42. package/dist/base/core/src/types/Selector.js +3 -0
  43. package/dist/base/core/src/types/Signal.d.ts +4 -0
  44. package/dist/base/core/src/types/Signal.js +2 -0
  45. package/dist/base/core/src/types/StorageAdapter.d.ts +20 -0
  46. package/dist/base/core/src/types/StorageAdapter.js +2 -0
  47. package/dist/base/core/src/utils/EventEmitter.d.ts +71 -0
  48. package/dist/base/core/src/utils/EventEmitter.js +144 -0
  49. package/dist/base/core/src/utils/batchOnNextTick.d.ts +16 -0
  50. package/dist/base/core/src/utils/batchOnNextTick.js +72 -0
  51. package/dist/base/core/src/utils/compact.d.ts +9 -0
  52. package/dist/base/core/src/utils/compact.js +21 -0
  53. package/dist/base/core/src/utils/createSignal.d.ts +14 -0
  54. package/dist/base/core/src/utils/createSignal.js +38 -0
  55. package/dist/base/core/src/utils/deepClone.d.ts +17 -0
  56. package/dist/base/core/src/utils/deepClone.js +68 -0
  57. package/dist/base/core/src/utils/get.d.ts +9 -0
  58. package/dist/base/core/src/utils/get.js +27 -0
  59. package/dist/base/core/src/utils/getMatchingKeys.d.ts +19 -0
  60. package/dist/base/core/src/utils/getMatchingKeys.js +49 -0
  61. package/dist/base/core/src/utils/intersection.d.ts +9 -0
  62. package/dist/base/core/src/utils/intersection.js +16 -0
  63. package/dist/base/core/src/utils/isEqual.d.ts +14 -0
  64. package/dist/base/core/src/utils/isEqual.js +43 -0
  65. package/dist/base/core/src/utils/isFieldExpression.d.ts +11 -0
  66. package/dist/base/core/src/utils/isFieldExpression.js +52 -0
  67. package/dist/base/core/src/utils/match.d.ts +12 -0
  68. package/dist/base/core/src/utils/match.js +16 -0
  69. package/dist/base/core/src/utils/modify.d.ts +14 -0
  70. package/dist/base/core/src/utils/modify.js +29 -0
  71. package/dist/base/core/src/utils/project.d.ts +15 -0
  72. package/dist/base/core/src/utils/project.js +43 -0
  73. package/dist/base/core/src/utils/queryId.d.ts +9 -0
  74. package/dist/base/core/src/utils/queryId.js +30 -0
  75. package/dist/base/core/src/utils/randomId.d.ts +7 -0
  76. package/dist/base/core/src/utils/randomId.js +12 -0
  77. package/dist/base/core/src/utils/reactiveOrAsync.d.ts +59 -0
  78. package/dist/base/core/src/utils/reactiveOrAsync.js +93 -0
  79. package/dist/base/core/src/utils/serializeValue.d.ts +12 -0
  80. package/dist/base/core/src/utils/serializeValue.js +27 -0
  81. package/dist/base/core/src/utils/set.d.ts +13 -0
  82. package/dist/base/core/src/utils/set.js +43 -0
  83. package/dist/base/core/src/utils/sortItems.d.ts +12 -0
  84. package/dist/base/core/src/utils/sortItems.js +23 -0
  85. package/dist/base/core/src/utils/uniqueBy.d.ts +10 -0
  86. package/dist/base/core/src/utils/uniqueBy.js +19 -0
  87. package/dist/reactivity-adapters/svelte/index.svelte.d.ts +10 -0
  88. package/dist/reactivity-adapters/svelte/index.svelte.js +36 -0
  89. package/package.json +3 -3
@@ -0,0 +1,652 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const deepClone_1 = __importDefault(require("./utils/deepClone"));
7
+ const match_1 = __importDefault(require("./utils/match"));
8
+ const modify_1 = __importDefault(require("./utils/modify"));
9
+ const queryId_1 = __importDefault(require("./utils/queryId"));
10
+ const isEqual_1 = __importDefault(require("./utils/isEqual"));
11
+ const getIndexInfo_1 = __importDefault(require("./getIndexInfo"));
12
+ const getMatchingKeys_1 = __importDefault(require("./utils/getMatchingKeys"));
13
+ const sortItems_1 = __importDefault(require("./utils/sortItems"));
14
+ const project_1 = __importDefault(require("./utils/project"));
15
+ /**
16
+ * Default merge strategy: shallow spread (right wins)
17
+ * @param a first item
18
+ * @param b second item
19
+ * @returns merged item
20
+ */
21
+ function defaultMergeItems(a, b) {
22
+ return { ...a, ...b };
23
+ }
24
+ /**
25
+ * Generates a stable key for a selector
26
+ * @param selector - the selector
27
+ * @returns the key
28
+ */
29
+ function selectorId(selector) {
30
+ return JSON.stringify(selector ?? {});
31
+ }
32
+ /**
33
+ * AutoFetchDataAdapter
34
+ *
35
+ * A DataAdapter that:
36
+ * - Mirrors the CollectionBackend surface (CRUD + query registry + lifecycle)
37
+ * - Executes queries against a provided StorageAdapter (local cache)
38
+ * - On first registration of a selector, auto-fetches from a remote source and
39
+ * ingests the result into storage (upsert), then pushes query result updates
40
+ * - Optionally purges auto-fetched items for a selector once no observers remain
41
+ * - Can subscribe to remote change notifications to re-fetch active selectors
42
+ *
43
+ * IMPORTANT: Purging only ever deletes items that were introduced via the
44
+ * auto-fetch path and are no longer referenced by any active selector. Items
45
+ * inserted through CRUD calls are never purged.
46
+ */
47
+ class AutoFetchDataAdapter {
48
+ options;
49
+ id;
50
+ onError;
51
+ fetchQueryItems;
52
+ mergeItems;
53
+ purgeDelay;
54
+ // Per-collection resources
55
+ storageAdapters = new Map();
56
+ storageAdapterReady = new Map();
57
+ collectionIndices = new Map();
58
+ // Per-collection query registries and auto-fetch bookkeeping
59
+ queries = new Map();
60
+ activeObservers = new Map(); // per-collection: key->record
61
+ observerTimeouts = new Map(); // per-collection
62
+ selectorIds = new Map(); // per-collection: selectorKey -> Set<id>
63
+ idRefCounts = new Map(); // per-collection: id -> refcount (for auto-fetched items)
64
+ autoloadIds = new Map(); // per-collection: ids that were introduced via auto-fetch
65
+ constructor(options) {
66
+ this.options = options;
67
+ this.id = options.id || 'autofetch-data-adapter';
68
+ this.onError = options.onError ?? ((error) => {
69
+ /* eslint-disable no-console */ console.error(error);
70
+ });
71
+ this.fetchQueryItems = options.fetchQueryItems;
72
+ this.mergeItems = options.mergeItems ?? defaultMergeItems;
73
+ this.purgeDelay = options.purgeDelay ?? 10_000;
74
+ if (options.registerRemoteChange) {
75
+ void options.registerRemoteChange(async () => {
76
+ await this.forceRefetchAll();
77
+ });
78
+ }
79
+ }
80
+ createCollectionBackend(collection, indices) {
81
+ // init per-collection state
82
+ this.collectionIndices.set(collection.name, indices);
83
+ this.queries.set(collection.name, new Map());
84
+ this.ensureStorageAdapter(collection.name);
85
+ this.activeObservers.set(collection.name, new Map());
86
+ this.observerTimeouts.set(collection.name, new Map());
87
+ this.selectorIds.set(collection.name, new Map());
88
+ this.idRefCounts.set(collection.name, new Map());
89
+ this.autoloadIds.set(collection.name, new Set());
90
+ const ready = this.setupStorage(collection.name, indices);
91
+ this.storageAdapterReady.set(collection.name, ready);
92
+ const registerQuery = (selector, options) => {
93
+ const qid = (0, queryId_1.default)(selector, options);
94
+ const registry = this.queries.get(collection.name);
95
+ if (!registry)
96
+ throw new Error(`Collection ${collection.name} not initialized!`);
97
+ registry.set(qid, {
98
+ selector,
99
+ options,
100
+ items: [],
101
+ listeners: new Set(),
102
+ ...registry.get(qid),
103
+ state: 'active',
104
+ error: null,
105
+ });
106
+ // auto-fetch lifecycle
107
+ const key = selectorId(selector);
108
+ const perColObservers = this.activeObservers.get(collection.name);
109
+ const current = perColObservers?.get(key)?.count ?? 0;
110
+ perColObservers?.set(key, { selector, count: current + 1 });
111
+ // cancel scheduled purge if any
112
+ const timeouts = this.observerTimeouts.get(collection.name);
113
+ const t = timeouts?.get(key);
114
+ if (t)
115
+ clearTimeout(t);
116
+ // Kick async fetch on first observer
117
+ if (current === 0) {
118
+ void this.fetchAndIngest(collection.name, selector).catch(this.onError);
119
+ }
120
+ // Also compute the current local result for immediate availability
121
+ void this.fulfillQuery(collection.name, selector, options).catch(this.onError);
122
+ };
123
+ const unregisterQuery = (selector, options) => {
124
+ const qid = (0, queryId_1.default)(selector, options);
125
+ const registry = this.queries.get(collection.name);
126
+ registry?.delete(qid);
127
+ const key = selectorId(selector);
128
+ const perColObservers = this.activeObservers.get(collection.name);
129
+ const current = perColObservers?.get(key)?.count ?? 0;
130
+ const remaining = Math.max(0, current - 1);
131
+ if (remaining > 0) {
132
+ perColObservers?.set(key, { selector, count: remaining });
133
+ return;
134
+ }
135
+ // schedule purge of auto-fetched items for this selector
136
+ const doPurge = () => {
137
+ perColObservers?.delete(key);
138
+ void this.purgeSelector(collection.name, selector).catch(this.onError);
139
+ };
140
+ if (this.purgeDelay === 0) {
141
+ doPurge();
142
+ }
143
+ else {
144
+ const timeouts = this.observerTimeouts.get(collection.name);
145
+ const t = timeouts?.get(key);
146
+ if (t)
147
+ clearTimeout(t);
148
+ timeouts?.set(key, setTimeout(doPurge, this.purgeDelay));
149
+ }
150
+ };
151
+ const getQueryState = (selector, options) => {
152
+ const q = this.queries.get(collection.name)?.get((0, queryId_1.default)(selector, options));
153
+ return q?.state ?? 'active';
154
+ };
155
+ const getQueryError = (selector, options) => {
156
+ const q = this.queries.get(collection.name)?.get((0, queryId_1.default)(selector, options));
157
+ return q?.error ?? null;
158
+ };
159
+ const getQueryResult = (selector, options) => {
160
+ const q = this.queries.get(collection.name)?.get((0, queryId_1.default)(selector, options));
161
+ return q?.items ?? [];
162
+ };
163
+ const onQueryStateChange = (selector, options, callback) => {
164
+ const qid = (0, queryId_1.default)(selector, options);
165
+ const registry = this.queries.get(collection.name);
166
+ if (!registry)
167
+ throw new Error(`Collection ${collection.name} not initialized!`);
168
+ if (!registry.has(qid)) {
169
+ registry.set(qid, {
170
+ selector,
171
+ options,
172
+ state: 'active',
173
+ error: null,
174
+ items: [],
175
+ listeners: new Set(),
176
+ });
177
+ }
178
+ registry.get(qid)?.listeners.add(callback);
179
+ return () => {
180
+ registry.get(qid)?.listeners.delete(callback);
181
+ };
182
+ };
183
+ return {
184
+ insert: async (item) => {
185
+ await ready;
186
+ const inserted = await this.insert(collection.name, item);
187
+ return inserted;
188
+ },
189
+ updateOne: async (selector, modifier) => {
190
+ await ready;
191
+ return this.updateOne(collection.name, selector, modifier);
192
+ },
193
+ updateMany: async (selector, modifier) => {
194
+ await ready;
195
+ return this.updateMany(collection.name, selector, modifier);
196
+ },
197
+ replaceOne: async (selector, replacement) => {
198
+ await ready;
199
+ return this.replaceOne(collection.name, selector, replacement);
200
+ },
201
+ removeOne: async (selector) => {
202
+ await ready;
203
+ return this.removeOne(collection.name, selector);
204
+ },
205
+ removeMany: async (selector) => {
206
+ await ready;
207
+ return this.removeMany(collection.name, selector);
208
+ },
209
+ registerQuery,
210
+ unregisterQuery,
211
+ getQueryState,
212
+ getQueryError,
213
+ getQueryResult,
214
+ onQueryStateChange,
215
+ executeQuery: async (selector, options) => {
216
+ await ready;
217
+ registerQuery(selector, options);
218
+ await new Promise((resolve) => {
219
+ let stop = () => { };
220
+ stop = onQueryStateChange(selector, options, (state) => {
221
+ if (state === 'active')
222
+ return;
223
+ resolve();
224
+ stop();
225
+ });
226
+ });
227
+ const result = getQueryResult(selector, options);
228
+ unregisterQuery(selector, options);
229
+ return result;
230
+ },
231
+ dispose: async () => {
232
+ this.storageAdapters.delete(collection.name);
233
+ this.queries.delete(collection.name);
234
+ this.collectionIndices.delete(collection.name);
235
+ this.storageAdapterReady.delete(collection.name);
236
+ this.activeObservers.delete(collection.name);
237
+ this.observerTimeouts.delete(collection.name);
238
+ this.selectorIds.delete(collection.name);
239
+ this.idRefCounts.delete(collection.name);
240
+ this.autoloadIds.delete(collection.name);
241
+ },
242
+ isReady: async () => {
243
+ await ready;
244
+ },
245
+ };
246
+ }
247
+ // ===== Auto-fetch mechanics =====
248
+ async forceRefetchAll() {
249
+ const tasks = [];
250
+ for (const [collectionName, observers] of this.activeObservers.entries()) {
251
+ for (const { selector, count } of observers.values()) {
252
+ if (count > 0)
253
+ tasks.push(this.fetchAndIngest(collectionName, selector));
254
+ }
255
+ }
256
+ await Promise.all(tasks);
257
+ }
258
+ async fetchAndIngest(collectionName, selector) {
259
+ // mark queries covering this selector as active (for UX spinners)
260
+ this.publishForSelector(collectionName, selector, 'active', null);
261
+ try {
262
+ const items = await this.fetchQueryItems(collectionName, selector);
263
+ if (!items || !Array.isArray(items)) {
264
+ throw new Error('AutoFetchDataAdapter: fetchQueryItems must resolve to { items: T[] }');
265
+ }
266
+ const ids = items.map(i => i.id);
267
+ // Track selector->ids for purge calculations
268
+ const selectorKey = selectorId(selector);
269
+ const selMap = this.selectorIds.get(collectionName);
270
+ const previous = selMap?.get(selectorKey) ?? new Set();
271
+ ids.forEach(id => previous.add(id));
272
+ selMap?.set(selectorKey, previous);
273
+ // Ingest via upsert (merge when existing)
274
+ await this.upsertMerged(collectionName, items);
275
+ // push updates to any queries that might be affected
276
+ await this.checkQueryUpdates(collectionName, items);
277
+ }
278
+ catch (error) {
279
+ this.publishForSelector(collectionName, selector, 'error', error);
280
+ this.onError(error);
281
+ }
282
+ }
283
+ async purgeSelector(collectionName, selector) {
284
+ const selectorKey = selectorId(selector);
285
+ const selMap = this.selectorIds.get(collectionName);
286
+ const ids = selMap?.get(selectorKey);
287
+ selMap?.delete(selectorKey);
288
+ if (!ids || ids.size === 0)
289
+ return;
290
+ const referenceMap = this.idRefCounts.get(collectionName);
291
+ const autoload = this.autoloadIds.get(collectionName);
292
+ const toRemove = [];
293
+ // Decrement reference counts and collect safe-to-remove ids
294
+ for (const id of ids) {
295
+ const current = referenceMap?.get(id) ?? 0;
296
+ const next = Math.max(0, current - 1);
297
+ if (next === 0) {
298
+ referenceMap?.delete(id);
299
+ if (autoload?.has(id))
300
+ toRemove.push(id);
301
+ }
302
+ else {
303
+ referenceMap?.set(id, next);
304
+ }
305
+ }
306
+ if (toRemove.length === 0)
307
+ return;
308
+ const storage = this.storageAdapters.get(collectionName);
309
+ if (!storage)
310
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
311
+ // Read and remove only those ids that still exist in storage
312
+ const items = await storage.readIds(toRemove);
313
+ if (items.length > 0) {
314
+ await storage.remove(items);
315
+ await this.checkQueryUpdates(collectionName, items);
316
+ }
317
+ // finally, clear autoload marks
318
+ toRemove.forEach(id => autoload?.delete(id));
319
+ }
320
+ // ===== Core query + CRUD plumbing (index-aware, same semantics as AsyncDataAdapter) =====
321
+ async setupStorage(collectionName, indices) {
322
+ const storage = this.storageAdapters.get(collectionName);
323
+ if (!storage)
324
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
325
+ await storage.setup();
326
+ await Promise.all(indices.map(field => storage.createIndex(field)));
327
+ }
328
+ ensureStorageAdapter(name) {
329
+ if (this.storageAdapters.has(name))
330
+ return;
331
+ const adapter = this.options.storage && this.options.storage(name);
332
+ if (!adapter)
333
+ return;
334
+ this.storageAdapters.set(name, adapter);
335
+ }
336
+ publishForSelector(collectionName, selector, state, error) {
337
+ const registry = this.queries.get(collectionName);
338
+ if (!registry)
339
+ return;
340
+ for (const query of registry.values()) {
341
+ // We only toggle state for records with an equal selector
342
+ if (!(0, isEqual_1.default)(query.selector, selector))
343
+ continue;
344
+ this.publishState(collectionName, (0, queryId_1.default)(query.selector, query.options), state, error);
345
+ }
346
+ }
347
+ publishState(collectionName, qid, state, error) {
348
+ const query = this.queries.get(collectionName)?.get(qid);
349
+ if (!query)
350
+ return;
351
+ query.state = state;
352
+ query.error = error;
353
+ for (const callback of query.listeners) {
354
+ try {
355
+ callback(state);
356
+ }
357
+ catch (error_) {
358
+ this.onError(error_);
359
+ }
360
+ }
361
+ }
362
+ publishResult(collectionName, qid, items) {
363
+ const query = this.queries.get(collectionName)?.get(qid);
364
+ if (!query)
365
+ return;
366
+ query.items = items;
367
+ this.queries.get(collectionName)?.set(qid, query);
368
+ }
369
+ async fulfillQuery(collectionName, selector, options) {
370
+ const qid = (0, queryId_1.default)(selector, options);
371
+ const registry = this.queries.get(collectionName);
372
+ if (!registry)
373
+ throw new Error(`Collection ${collectionName} not initialized!`);
374
+ const rec = registry.get(qid);
375
+ if (!rec)
376
+ return;
377
+ this.publishState(collectionName, qid, 'active', null);
378
+ try {
379
+ const items = await this.executeQuery(collectionName, selector, options);
380
+ this.publishResult(collectionName, qid, items);
381
+ this.publishState(collectionName, qid, 'complete', null);
382
+ }
383
+ catch (error) {
384
+ this.publishState(collectionName, qid, 'error', error);
385
+ }
386
+ }
387
+ async getIndexInfo(collectionName, selector) {
388
+ const storage = this.storageAdapters.get(collectionName);
389
+ if (!storage)
390
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
391
+ // Fast path: { id: <scalar> }
392
+ if (selector != null && Object.keys(selector).length === 1 && 'id' in selector && typeof selector.id !== 'object') {
393
+ return { matched: true, ids: [selector.id], optimizedSelector: {} };
394
+ }
395
+ if (selector == null) {
396
+ return { matched: false, ids: [], optimizedSelector: {} };
397
+ }
398
+ const indices = this.collectionIndices.get(collectionName) ?? [];
399
+ return (0, getIndexInfo_1.default)(indices.map(field => async (flatSelector) => {
400
+ if (!Object.hasOwnProperty.call(flatSelector, field))
401
+ return { matched: false };
402
+ const index = await storage.readIndex(field);
403
+ const fieldSelector = flatSelector[field];
404
+ const filtersForNull = fieldSelector == null || fieldSelector.$exists === false;
405
+ const keys = filtersForNull
406
+ ? { include: null, exclude: [...index.keys()].filter(key => key != null) }
407
+ : (0, getMatchingKeys_1.default)(field, flatSelector);
408
+ if (keys.include == null && keys.exclude == null)
409
+ return { matched: false };
410
+ // Build included ids
411
+ let includedIds = [];
412
+ if (keys.include == null) {
413
+ for (const set of index.values())
414
+ for (const pos of set)
415
+ includedIds.push(pos);
416
+ }
417
+ else {
418
+ for (const key of keys.include) {
419
+ const idSet = index.get(key);
420
+ if (idSet)
421
+ for (const id of idSet)
422
+ includedIds.push(id);
423
+ }
424
+ }
425
+ // Apply exclusions
426
+ if (keys.exclude != null) {
427
+ const excludeIds = new Set();
428
+ for (const key of keys.exclude) {
429
+ const idSet = index.get(key);
430
+ if (idSet)
431
+ for (const id of idSet)
432
+ excludeIds.add(id);
433
+ }
434
+ includedIds = includedIds.filter(pos => !excludeIds.has(pos));
435
+ }
436
+ return {
437
+ matched: true,
438
+ ids: includedIds,
439
+ fields: [field],
440
+ keepSelector: filtersForNull,
441
+ };
442
+ }), selector);
443
+ }
444
+ async queryItems(collectionName, selector) {
445
+ const storage = this.storageAdapters.get(collectionName);
446
+ if (!storage)
447
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
448
+ const index = await this.getIndexInfo(collectionName, selector);
449
+ const matchItems = (item) => {
450
+ if (index.optimizedSelector == null)
451
+ return true;
452
+ if (Object.keys(index.optimizedSelector).length <= 0)
453
+ return true;
454
+ return (0, match_1.default)(item, index.optimizedSelector);
455
+ };
456
+ if (index.matched) {
457
+ const items = await storage.readIds(index.ids);
458
+ if ((0, isEqual_1.default)(index.optimizedSelector, {}))
459
+ return items;
460
+ return items.filter(matchItems);
461
+ }
462
+ else {
463
+ const allItems = await storage.readAll();
464
+ if ((0, isEqual_1.default)(selector, {}))
465
+ return allItems;
466
+ return allItems.filter(matchItems);
467
+ }
468
+ }
469
+ async executeQuery(collectionName, selector, options) {
470
+ const items = await this.queryItems(collectionName, selector || {});
471
+ const { sort, skip, limit, fields } = options || {};
472
+ const sorted = sort ? (0, sortItems_1.default)(items, sort) : items;
473
+ const skipped = skip ? sorted.slice(skip) : sorted;
474
+ const limited = limit ? skipped.slice(0, limit) : skipped;
475
+ const idExcluded = fields && fields.id === 0;
476
+ return limited.map((item) => {
477
+ if (!fields)
478
+ return item;
479
+ return { ...(idExcluded ? {} : { id: item.id }), ...(0, project_1.default)(item, fields) };
480
+ });
481
+ }
482
+ async checkQueryUpdates(collectionName, changedItems) {
483
+ const registry = this.queries.get(collectionName);
484
+ if (!registry)
485
+ throw new Error(`Collection ${collectionName} not initialized!`);
486
+ if (registry.size === 0)
487
+ return;
488
+ // Find active queries whose selector matches at least one changed item
489
+ const affected = [...registry.values()].filter(({ selector }) => changedItems.some(item => (0, match_1.default)(item, selector)));
490
+ if (affected.length === 0)
491
+ return;
492
+ // Mark active and notify…
493
+ for (const { selector, options } of affected) {
494
+ const qid = (0, queryId_1.default)(selector, options);
495
+ this.publishState(collectionName, qid, 'active', null);
496
+ }
497
+ // …then recompute and complete
498
+ await Promise.all(affected.map(async ({ selector, options }) => {
499
+ const qid = (0, queryId_1.default)(selector, options);
500
+ try {
501
+ const items = await this.executeQuery(collectionName, selector, options);
502
+ this.publishResult(collectionName, qid, items);
503
+ this.publishState(collectionName, qid, 'complete', null);
504
+ }
505
+ catch (error) {
506
+ this.publishState(collectionName, qid, 'error', error);
507
+ }
508
+ }));
509
+ }
510
+ // ===== CRUD with push-style query updates =====
511
+ async insert(collectionName, newItem) {
512
+ const storage = this.storageAdapters.get(collectionName);
513
+ if (!storage)
514
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
515
+ const existing = await this.executeQuery(collectionName, { id: newItem.id }, { limit: 1 });
516
+ if (existing.length > 0)
517
+ throw new Error(`Item with id ${String(newItem.id)} already exists`);
518
+ await storage.insert([newItem]);
519
+ await this.checkQueryUpdates(collectionName, [newItem]);
520
+ return newItem;
521
+ }
522
+ async updateOne(collectionName, selector, modifier) {
523
+ const storage = this.storageAdapters.get(collectionName);
524
+ if (!storage)
525
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
526
+ const items = await this.executeQuery(collectionName, selector, { limit: 1 });
527
+ const [item] = items;
528
+ const { $setOnInsert, ...rest } = modifier;
529
+ if (item == null)
530
+ return [];
531
+ const modified = (0, modify_1.default)((0, deepClone_1.default)(item), rest);
532
+ if (item.id !== modified.id) {
533
+ const existing = await this.executeQuery(collectionName, { id: modified.id }, { limit: 1 });
534
+ if (existing.length > 0)
535
+ throw new Error(`Item with id ${String(modified.id)} already exists`);
536
+ }
537
+ await storage.replace([modified]);
538
+ await this.checkQueryUpdates(collectionName, [item, modified]);
539
+ return [modified];
540
+ }
541
+ async updateMany(collectionName, selector, modifier) {
542
+ const storage = this.storageAdapters.get(collectionName);
543
+ if (!storage)
544
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
545
+ const items = await this.executeQuery(collectionName, selector);
546
+ if (items.length === 0)
547
+ return [];
548
+ const { $setOnInsert, ...rest } = modifier;
549
+ const changed = await Promise.all(items.map(async (item) => {
550
+ const modified = (0, modify_1.default)((0, deepClone_1.default)(item), rest);
551
+ if (item.id !== modified.id) {
552
+ const existing = await this.executeQuery(collectionName, { id: modified.id }, { limit: 1 });
553
+ if (existing.length > 0)
554
+ throw new Error(`Item with id ${String(modified.id)} already exists`);
555
+ }
556
+ return modified;
557
+ }));
558
+ await storage.replace(changed);
559
+ await this.checkQueryUpdates(collectionName, [...items, ...changed]);
560
+ return changed;
561
+ }
562
+ async replaceOne(collectionName, selector, replacement) {
563
+ const storage = this.storageAdapters.get(collectionName);
564
+ if (!storage)
565
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
566
+ const items = await this.executeQuery(collectionName, selector, { limit: 1 });
567
+ const [item] = items;
568
+ if (item == null)
569
+ return [];
570
+ const modified = { ...replacement, id: replacement.id ?? item.id };
571
+ if (item.id !== modified.id) {
572
+ const existing = await this.executeQuery(collectionName, { id: modified.id }, { limit: 1 });
573
+ if (existing.length > 0)
574
+ throw new Error(`Item with id ${String(modified.id)} already exists`);
575
+ }
576
+ await storage.replace([modified]);
577
+ await this.checkQueryUpdates(collectionName, [item, modified]);
578
+ return [modified];
579
+ }
580
+ async removeOne(collectionName, selector) {
581
+ const storage = this.storageAdapters.get(collectionName);
582
+ if (!storage)
583
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
584
+ const items = await this.executeQuery(collectionName, selector, { limit: 1 });
585
+ const [item] = items;
586
+ if (item == null)
587
+ return [];
588
+ await storage.remove([item]);
589
+ await this.checkQueryUpdates(collectionName, [item]);
590
+ return [item];
591
+ }
592
+ async removeMany(collectionName, selector) {
593
+ const storage = this.storageAdapters.get(collectionName);
594
+ if (!storage)
595
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
596
+ const items = await this.executeQuery(collectionName, selector);
597
+ if (items.length === 0)
598
+ return [];
599
+ await storage.remove(items);
600
+ await this.checkQueryUpdates(collectionName, items);
601
+ return items;
602
+ }
603
+ // ===== Upsert/merge helper for ingesting fetched items =====
604
+ async upsertMerged(collectionName, incoming) {
605
+ if (incoming.length === 0)
606
+ return;
607
+ const storage = this.storageAdapters.get(collectionName);
608
+ if (!storage)
609
+ throw new Error(`No persistence adapter for collection ${collectionName}`);
610
+ const ids = incoming.map(i => i.id);
611
+ const existing = await storage.readIds(ids);
612
+ const existingById = new Map(existing.map((it) => [it.id, it]));
613
+ const toInsert = [];
614
+ const toReplace = [];
615
+ const referenceMap = this.idRefCounts.get(collectionName);
616
+ const autoload = this.autoloadIds.get(collectionName);
617
+ for (const item of incoming) {
618
+ const previous = existingById.get(item.id);
619
+ if (previous) {
620
+ toReplace.push(this.mergeItems(previous, item));
621
+ }
622
+ else {
623
+ toInsert.push(item);
624
+ }
625
+ // mark as auto-fetched and bump refcount
626
+ autoload?.add(item.id);
627
+ referenceMap?.set(item.id, (referenceMap?.get(item.id) ?? 0) + 1);
628
+ }
629
+ if (toInsert.length > 0)
630
+ await storage.insert(toInsert);
631
+ if (toReplace.length > 0)
632
+ await storage.replace(toReplace);
633
+ }
634
+ }
635
+ exports.default = AutoFetchDataAdapter;
636
+ /**
637
+ * Usage (example):
638
+ *
639
+ * const adapter = new AutoFetchDataAdapter({
640
+ * storage: (name) => new IndexedDBStorage(name),
641
+ * fetchQueryItems: async (collectionName, selector) => {
642
+ * const res = await fetch(`/api/${collectionName}?q=${encodeURIComponent(JSON.stringify(selector||{}))}`)
643
+ * const items = await res.json()
644
+ * return { items }
645
+ * },
646
+ * registerRemoteChange: (onChange) => subscribeToWS(onChange),
647
+ * mergeItems: (a, b) => ({ ...a, ...b }),
648
+ * purgeDelay: 10_000,
649
+ * })
650
+ *
651
+ * const backend = adapter.createCollectionBackend(myCollection, ['status', 'projectId'])
652
+ */