@absolutejs/sync 0.0.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +281 -24
  2. package/dist/adapters/drizzle/collection.d.ts +27 -0
  3. package/dist/adapters/drizzle/index.d.ts +20 -0
  4. package/dist/adapters/drizzle/index.js +265 -0
  5. package/dist/adapters/drizzle/index.js.map +14 -0
  6. package/dist/adapters/drizzle/predicate.d.ts +20 -0
  7. package/dist/adapters/drizzle/read.d.ts +31 -0
  8. package/dist/adapters/drizzle/topics.d.ts +41 -0
  9. package/dist/adapters/drizzle/write.d.ts +69 -0
  10. package/dist/adapters/mysql/index.d.ts +75 -0
  11. package/dist/adapters/mysql/index.js +171 -0
  12. package/dist/adapters/mysql/index.js.map +11 -0
  13. package/dist/adapters/postgres/index.d.ts +53 -0
  14. package/dist/adapters/postgres/index.js +86 -0
  15. package/dist/adapters/postgres/index.js.map +10 -0
  16. package/dist/adapters/prisma/collection.d.ts +39 -0
  17. package/dist/adapters/prisma/index.d.ts +23 -0
  18. package/dist/adapters/prisma/index.js +231 -0
  19. package/dist/adapters/prisma/index.js.map +14 -0
  20. package/dist/adapters/prisma/predicate.d.ts +20 -0
  21. package/dist/adapters/prisma/read.d.ts +28 -0
  22. package/dist/adapters/prisma/topics.d.ts +29 -0
  23. package/dist/adapters/prisma/write.d.ts +65 -0
  24. package/dist/adapters/sqlite/index.d.ts +32 -0
  25. package/dist/adapters/sqlite/index.js +128 -0
  26. package/dist/adapters/sqlite/index.js.map +11 -0
  27. package/dist/angular/index.d.ts +1 -0
  28. package/dist/angular/index.js +347 -0
  29. package/dist/angular/index.js.map +11 -0
  30. package/dist/angular/sync-collection.service.d.ts +20 -0
  31. package/dist/client/index.d.ts +12 -30
  32. package/dist/client/index.js +1099 -3
  33. package/dist/client/index.js.map +10 -4
  34. package/dist/client/liveQuery.d.ts +75 -0
  35. package/dist/client/presence.d.ts +37 -0
  36. package/dist/client/subscriber.d.ts +30 -0
  37. package/dist/client/syncClient.d.ts +53 -0
  38. package/dist/client/syncCollection.d.ts +102 -0
  39. package/dist/client/syncStore.d.ts +81 -0
  40. package/dist/engine/aggregate.d.ts +45 -0
  41. package/dist/engine/cluster.d.ts +41 -0
  42. package/dist/engine/collection.d.ts +87 -0
  43. package/dist/engine/connection.d.ts +103 -0
  44. package/dist/engine/dataflow.d.ts +109 -0
  45. package/dist/engine/equiJoin.d.ts +51 -0
  46. package/dist/engine/graph.d.ts +85 -0
  47. package/dist/engine/index.d.ts +40 -0
  48. package/dist/engine/index.js +1774 -0
  49. package/dist/engine/index.js.map +23 -0
  50. package/dist/engine/materializedView.d.ts +53 -0
  51. package/dist/engine/mutation.d.ts +66 -0
  52. package/dist/engine/pollingSource.d.ts +42 -0
  53. package/dist/engine/presence.d.ts +46 -0
  54. package/dist/engine/reactive.d.ts +67 -0
  55. package/dist/engine/routes.d.ts +40 -0
  56. package/dist/engine/socket.d.ts +67 -0
  57. package/dist/engine/syncEngine.d.ts +132 -0
  58. package/dist/engine/types.d.ts +45 -0
  59. package/dist/index.d.ts +4 -0
  60. package/dist/index.js +327 -3
  61. package/dist/index.js.map +8 -5
  62. package/dist/react/index.d.ts +1 -0
  63. package/dist/react/index.js +332 -0
  64. package/dist/react/index.js.map +11 -0
  65. package/dist/react/useSyncCollection.d.ts +16 -0
  66. package/dist/reactiveHub.d.ts +6 -0
  67. package/dist/svelte/createSyncCollectionStore.d.ts +15 -0
  68. package/dist/svelte/index.d.ts +1 -0
  69. package/dist/svelte/index.js +338 -0
  70. package/dist/svelte/index.js.map +11 -0
  71. package/dist/vue/index.d.ts +1 -0
  72. package/dist/vue/index.js +331 -0
  73. package/dist/vue/index.js.map +11 -0
  74. package/dist/vue/useSyncCollection.d.ts +17 -0
  75. package/package.json +104 -6
@@ -1,4 +1,74 @@
1
- // src/client/index.ts
1
+ var __create = Object.create;
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __name = (target, name) => {
5
+ Object.defineProperty(target, "name", {
6
+ value: name,
7
+ enumerable: false,
8
+ configurable: true
9
+ });
10
+ return target;
11
+ };
12
+ var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
13
+ var __typeError = (msg) => {
14
+ throw TypeError(msg);
15
+ };
16
+ var __defNormalProp = (obj, key, value) => (key in obj) ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
17
+ var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
18
+ var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
19
+ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
20
+ var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
21
+ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
22
+ var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
23
+ var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
24
+ var __expectFn = (fn) => fn !== undefined && typeof fn !== "function" ? __typeError("Function expected") : fn;
25
+ var __decoratorContext = (kind, name, done, metadata, fns) => ({
26
+ kind: __decoratorStrings[kind],
27
+ name,
28
+ metadata,
29
+ addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null))
30
+ });
31
+ var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
32
+ var __runInitializers = (array, flags, self, value) => {
33
+ for (var i = 0, fns = array[flags >> 1], n = fns && fns.length;i < n; i++)
34
+ flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
35
+ return value;
36
+ };
37
+ var __decorateElement = (array, flags, name, decorators, target, extra) => {
38
+ var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
39
+ var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
40
+ var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
41
+ var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : {
42
+ get [name]() {
43
+ return __privateGet(this, extra);
44
+ },
45
+ set [name](x) {
46
+ __privateSet(this, extra, x);
47
+ }
48
+ }, name));
49
+ k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
50
+ for (var i = decorators.length - 1;i >= 0; i--) {
51
+ ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
52
+ if (k) {
53
+ ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => (name in x) };
54
+ if (k ^ 3)
55
+ access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
56
+ if (k > 2)
57
+ access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
58
+ }
59
+ it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? undefined : { get: desc.get, set: desc.set } : target, ctx);
60
+ done._ = 1;
61
+ if (k ^ 4 || it === undefined)
62
+ __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
63
+ else if (typeof it !== "object" || it === null)
64
+ __typeError("Object expected");
65
+ else
66
+ __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
67
+ }
68
+ return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
69
+ };
70
+
71
+ // src/client/subscriber.ts
2
72
  var createSyncSubscriber = ({
3
73
  topics,
4
74
  onEvent,
@@ -33,9 +103,1035 @@ var createSyncSubscriber = ({
33
103
  source
34
104
  };
35
105
  };
106
+ // src/reactiveHub.ts
107
+ var SYNC_OPEN_TOPIC = "@absolutejs/sync:open";
108
+
109
+ // src/client/liveQuery.ts
110
+ var createLiveQuery = (options) => {
111
+ const hasSeed = options.initialData !== undefined;
112
+ let state = {
113
+ data: options.initialData,
114
+ error: undefined,
115
+ loading: !options.manual && !hasSeed,
116
+ fetching: false
117
+ };
118
+ const listeners = new Set;
119
+ const setState = (patch) => {
120
+ state = { ...state, ...patch };
121
+ for (const listener of listeners) {
122
+ listener(state);
123
+ }
124
+ };
125
+ let requestSeq = 0;
126
+ let inFlight;
127
+ let closed = false;
128
+ const refetch = async () => {
129
+ if (closed) {
130
+ return;
131
+ }
132
+ const seq = requestSeq += 1;
133
+ inFlight?.abort();
134
+ const controller = new AbortController;
135
+ inFlight = controller;
136
+ setState({ fetching: true });
137
+ try {
138
+ const data = await options.fetcher(controller.signal);
139
+ if (seq !== requestSeq) {
140
+ return;
141
+ }
142
+ setState({
143
+ data,
144
+ error: undefined,
145
+ loading: false,
146
+ fetching: false
147
+ });
148
+ } catch (error) {
149
+ if (controller.signal.aborted || seq !== requestSeq) {
150
+ return;
151
+ }
152
+ setState({ error, loading: false, fetching: false });
153
+ options.onError?.(error);
154
+ } finally {
155
+ if (inFlight === controller) {
156
+ inFlight = undefined;
157
+ }
158
+ }
159
+ };
160
+ let debounceTimer;
161
+ const scheduleRefetch = () => {
162
+ if (closed) {
163
+ return;
164
+ }
165
+ if (!options.debounceMs) {
166
+ refetch();
167
+ return;
168
+ }
169
+ if (debounceTimer !== undefined) {
170
+ return;
171
+ }
172
+ debounceTimer = setTimeout(() => {
173
+ debounceTimer = undefined;
174
+ refetch();
175
+ }, options.debounceMs);
176
+ };
177
+ let opened = false;
178
+ const onEvent = (event) => {
179
+ if (event.topic === SYNC_OPEN_TOPIC) {
180
+ if (opened) {
181
+ scheduleRefetch();
182
+ }
183
+ opened = true;
184
+ return;
185
+ }
186
+ scheduleRefetch();
187
+ };
188
+ const subscriber = createSyncSubscriber({
189
+ topics: options.topics,
190
+ onEvent,
191
+ url: options.url,
192
+ withCredentials: options.withCredentials,
193
+ eventSourceImpl: options.eventSourceImpl
194
+ });
195
+ if (!options.manual && !hasSeed) {
196
+ refetch();
197
+ }
198
+ const close = () => {
199
+ if (closed) {
200
+ return;
201
+ }
202
+ closed = true;
203
+ subscriber.close();
204
+ inFlight?.abort();
205
+ if (debounceTimer !== undefined) {
206
+ clearTimeout(debounceTimer);
207
+ debounceTimer = undefined;
208
+ }
209
+ listeners.clear();
210
+ };
211
+ return {
212
+ get: () => state,
213
+ subscribe: (listener) => {
214
+ listeners.add(listener);
215
+ return () => {
216
+ listeners.delete(listener);
217
+ };
218
+ },
219
+ refetch,
220
+ close
221
+ };
222
+ };
223
+ var jsonFetcher = (url, init) => async (signal) => {
224
+ const response = await fetch(url, { ...init, signal });
225
+ if (!response.ok) {
226
+ throw new Error(`${response.status} ${response.statusText}`);
227
+ }
228
+ return await response.json();
229
+ };
230
+ // src/client/syncCollection.ts
231
+ var localStorageMutationStorage = (key) => ({
232
+ load: () => {
233
+ const raw = globalThis.localStorage?.getItem(key);
234
+ return raw ? JSON.parse(raw) : [];
235
+ },
236
+ save: (records) => {
237
+ globalThis.localStorage?.setItem(key, JSON.stringify(records));
238
+ }
239
+ });
240
+ var SUBSCRIPTION_ID = "s";
241
+ var createSyncCollection = (options) => {
242
+ const key = options.key ?? ((row) => row.id);
243
+ const reconnectMs = options.reconnectMs ?? 500;
244
+ const maxReconnectMs = options.maxReconnectMs ?? 1e4;
245
+ const Impl = options.webSocketImpl ?? globalThis.WebSocket;
246
+ if (!Impl) {
247
+ throw new Error("createSyncCollection requires WebSocket. Run in a browser or pass webSocketImpl.");
248
+ }
249
+ const confirmed = new Map;
250
+ const pending = [];
251
+ let mutationSeq = 0;
252
+ let state = {
253
+ data: [],
254
+ status: "connecting",
255
+ error: undefined
256
+ };
257
+ const listeners = new Set;
258
+ const setState = (patch) => {
259
+ state = { ...state, ...patch };
260
+ for (const listener of listeners) {
261
+ listener(state);
262
+ }
263
+ };
264
+ const recompute = (patch = {}) => {
265
+ const working = new Map(confirmed);
266
+ const draft = {
267
+ set: (row) => working.set(key(row), row),
268
+ delete: (rowKey) => working.delete(rowKey)
269
+ };
270
+ for (const mutation of pending) {
271
+ mutation.optimistic?.(draft);
272
+ }
273
+ setState({ ...patch, data: [...working.values()] });
274
+ };
275
+ let socket;
276
+ let connected = false;
277
+ let closed = false;
278
+ let attempt = 0;
279
+ let reconnectTimer;
280
+ let appliedVersion = 0;
281
+ const persist = () => {
282
+ options.storage?.save(pending.map((mutation) => ({
283
+ mutationId: mutation.mutationId,
284
+ name: mutation.name,
285
+ args: mutation.args
286
+ })));
287
+ };
288
+ const settlePending = (mutationId) => {
289
+ const index = pending.findIndex((mutation2) => mutation2.mutationId === mutationId);
290
+ if (index === -1) {
291
+ return;
292
+ }
293
+ const [mutation] = pending.splice(index, 1);
294
+ persist();
295
+ return mutation;
296
+ };
297
+ const applyFrame = (frame) => {
298
+ if (frame.type === "snapshot") {
299
+ confirmed.clear();
300
+ for (const row of frame.rows) {
301
+ confirmed.set(key(row), row);
302
+ }
303
+ if (frame.version !== undefined) {
304
+ appliedVersion = frame.version;
305
+ }
306
+ recompute({ status: "ready", error: undefined });
307
+ } else if (frame.type === "diff") {
308
+ for (const row of frame.removed) {
309
+ confirmed.delete(key(row));
310
+ }
311
+ for (const row of frame.added) {
312
+ confirmed.set(key(row), row);
313
+ }
314
+ for (const row of frame.changed) {
315
+ confirmed.set(key(row), row);
316
+ }
317
+ if (frame.version !== undefined) {
318
+ appliedVersion = Math.max(appliedVersion, frame.version);
319
+ }
320
+ recompute();
321
+ } else if (frame.type === "error") {
322
+ setState({ error: frame.message });
323
+ options.onError?.(frame.message);
324
+ } else if (frame.type === "ack") {
325
+ const mutation = settlePending(frame.mutationId);
326
+ if (mutation !== undefined) {
327
+ recompute();
328
+ mutation.resolve(frame.result);
329
+ }
330
+ } else if (frame.type === "reject") {
331
+ const mutation = settlePending(frame.mutationId);
332
+ if (mutation !== undefined) {
333
+ recompute();
334
+ mutation.reject(new Error(String(frame.message)));
335
+ }
336
+ }
337
+ };
338
+ const sendMutate = (mutation) => {
339
+ if (connected) {
340
+ socket?.send(JSON.stringify({
341
+ type: "mutate",
342
+ mutationId: mutation.mutationId,
343
+ name: mutation.name,
344
+ args: mutation.args
345
+ }));
346
+ }
347
+ };
348
+ const connect = () => {
349
+ if (closed) {
350
+ return;
351
+ }
352
+ setState({ status: "connecting" });
353
+ const ws = new Impl(options.url);
354
+ socket = ws;
355
+ ws.onopen = () => {
356
+ attempt = 0;
357
+ connected = true;
358
+ ws.send(JSON.stringify({
359
+ type: "subscribe",
360
+ id: SUBSCRIPTION_ID,
361
+ collection: options.collection,
362
+ params: options.params,
363
+ since: appliedVersion > 0 ? appliedVersion : undefined
364
+ }));
365
+ for (const mutation of pending) {
366
+ sendMutate(mutation);
367
+ }
368
+ };
369
+ ws.onmessage = (event) => {
370
+ try {
371
+ applyFrame(JSON.parse(event.data));
372
+ } catch {}
373
+ };
374
+ ws.onclose = () => {
375
+ connected = false;
376
+ if (closed || reconnectMs <= 0) {
377
+ return;
378
+ }
379
+ const delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);
380
+ attempt += 1;
381
+ reconnectTimer = setTimeout(connect, delay);
382
+ };
383
+ };
384
+ connect();
385
+ const hydratePersisted = async () => {
386
+ if (options.storage === undefined) {
387
+ return;
388
+ }
389
+ const records = await options.storage.load();
390
+ for (const record of records) {
391
+ if (pending.some((m) => m.mutationId === record.mutationId)) {
392
+ continue;
393
+ }
394
+ pending.push({
395
+ mutationId: record.mutationId,
396
+ name: record.name,
397
+ args: record.args,
398
+ resolve: () => {},
399
+ reject: () => {}
400
+ });
401
+ mutationSeq = Math.max(mutationSeq, record.mutationId);
402
+ }
403
+ if (connected) {
404
+ for (const mutation of pending) {
405
+ sendMutate(mutation);
406
+ }
407
+ }
408
+ };
409
+ hydratePersisted();
410
+ return {
411
+ get: () => state,
412
+ subscribe: (listener) => {
413
+ listeners.add(listener);
414
+ return () => {
415
+ listeners.delete(listener);
416
+ };
417
+ },
418
+ mutate: (mutateOptions) => new Promise((resolve, reject) => {
419
+ const mutation = {
420
+ mutationId: mutationSeq += 1,
421
+ name: mutateOptions.name,
422
+ args: mutateOptions.args,
423
+ optimistic: mutateOptions.optimistic,
424
+ resolve: (result) => resolve(result),
425
+ reject
426
+ };
427
+ pending.push(mutation);
428
+ persist();
429
+ recompute();
430
+ sendMutate(mutation);
431
+ }),
432
+ close: () => {
433
+ if (closed) {
434
+ return;
435
+ }
436
+ closed = true;
437
+ connected = false;
438
+ if (reconnectTimer !== undefined) {
439
+ clearTimeout(reconnectTimer);
440
+ }
441
+ try {
442
+ socket?.send(JSON.stringify({ type: "unsubscribe", id: SUBSCRIPTION_ID }));
443
+ socket?.close();
444
+ } catch {}
445
+ for (const mutation of pending.splice(0)) {
446
+ mutation.reject(new Error("sync collection closed"));
447
+ }
448
+ persist();
449
+ setState({ status: "closed" });
450
+ listeners.clear();
451
+ }
452
+ };
453
+ };
454
+ // src/client/presence.ts
455
+ var createPresence = (options) => {
456
+ const reconnectMs = options.reconnectMs ?? 500;
457
+ const maxReconnectMs = options.maxReconnectMs ?? 1e4;
458
+ const Impl = options.webSocketImpl ?? globalThis.WebSocket;
459
+ if (!Impl) {
460
+ throw new Error("createPresence requires WebSocket. Run in a browser or pass webSocketImpl.");
461
+ }
462
+ const id = options.memberId ?? globalThis.crypto?.randomUUID?.() ?? `m${Math.random()}`;
463
+ const members = new Map;
464
+ let state = options.state;
465
+ let snapshot = [];
466
+ const listeners = new Set;
467
+ const emit = () => {
468
+ snapshot = [...members].map(([memberId, memberState]) => ({
469
+ id: memberId,
470
+ state: memberState
471
+ }));
472
+ for (const listener of listeners) {
473
+ listener(snapshot);
474
+ }
475
+ };
476
+ let socket;
477
+ let connected = false;
478
+ let closed = false;
479
+ let attempt = 0;
480
+ let reconnectTimer;
481
+ const send = (frame) => {
482
+ if (connected) {
483
+ socket?.send(JSON.stringify(frame));
484
+ }
485
+ };
486
+ const connect = () => {
487
+ if (closed) {
488
+ return;
489
+ }
490
+ const ws = new Impl(options.url);
491
+ socket = ws;
492
+ ws.onopen = () => {
493
+ attempt = 0;
494
+ connected = true;
495
+ ws.send(JSON.stringify({
496
+ type: "presence-join",
497
+ room: options.room,
498
+ memberId: id,
499
+ state
500
+ }));
501
+ };
502
+ ws.onmessage = (event) => {
503
+ let frame;
504
+ try {
505
+ frame = JSON.parse(event.data);
506
+ } catch {
507
+ return;
508
+ }
509
+ if (frame.type !== "presence" || frame.room !== options.room) {
510
+ return;
511
+ }
512
+ for (const member of frame.joined ?? []) {
513
+ members.set(member.id, member.state);
514
+ }
515
+ for (const member of frame.updated ?? []) {
516
+ members.set(member.id, member.state);
517
+ }
518
+ for (const memberId of frame.left ?? []) {
519
+ members.delete(memberId);
520
+ }
521
+ emit();
522
+ };
523
+ ws.onclose = () => {
524
+ connected = false;
525
+ if (closed || reconnectMs <= 0) {
526
+ return;
527
+ }
528
+ const delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);
529
+ attempt += 1;
530
+ reconnectTimer = setTimeout(connect, delay);
531
+ };
532
+ };
533
+ connect();
534
+ return {
535
+ id,
536
+ get: () => snapshot,
537
+ subscribe: (listener) => {
538
+ listeners.add(listener);
539
+ listener(snapshot);
540
+ return () => {
541
+ listeners.delete(listener);
542
+ };
543
+ },
544
+ set: (next) => {
545
+ state = next;
546
+ send({ type: "presence-set", room: options.room, state: next });
547
+ },
548
+ close: () => {
549
+ closed = true;
550
+ if (reconnectTimer !== undefined) {
551
+ clearTimeout(reconnectTimer);
552
+ }
553
+ send({ type: "presence-leave", room: options.room });
554
+ socket?.close();
555
+ members.clear();
556
+ }
557
+ };
558
+ };
559
+ // src/client/syncClient.ts
560
+ var createSyncClient = (options) => {
561
+ const reconnectMs = options.reconnectMs ?? 500;
562
+ const maxReconnectMs = options.maxReconnectMs ?? 1e4;
563
+ const Impl = options.webSocketImpl ?? globalThis.WebSocket;
564
+ if (!Impl) {
565
+ throw new Error("createSyncClient requires WebSocket. Run in a browser or pass webSocketImpl.");
566
+ }
567
+ const entries = new Map;
568
+ const mutationOwner = new Map;
569
+ let nextEntryId = 0;
570
+ let mutationSeq = 0;
571
+ let socket;
572
+ let connected = false;
573
+ let closed = false;
574
+ let attempt = 0;
575
+ let reconnectTimer;
576
+ const notify = (entry) => {
577
+ for (const listener of entry.listeners) {
578
+ listener(entry.state);
579
+ }
580
+ };
581
+ const rebuild = (entry, patch = {}) => {
582
+ const working = new Map(entry.confirmed);
583
+ const draft = {
584
+ set: (row) => working.set(entry.key(row), row),
585
+ delete: (rowKey) => working.delete(rowKey)
586
+ };
587
+ for (const mutation of entry.pending) {
588
+ mutation.optimistic?.(draft);
589
+ }
590
+ entry.state = {
591
+ ...entry.state,
592
+ ...patch,
593
+ data: [...working.values()]
594
+ };
595
+ };
596
+ const recompute = (entry, patch = {}) => {
597
+ rebuild(entry, patch);
598
+ notify(entry);
599
+ };
600
+ const applyDiffToConfirmed = (entry, diff) => {
601
+ for (const row of diff.removed) {
602
+ entry.confirmed.delete(entry.key(row));
603
+ }
604
+ for (const row of diff.added) {
605
+ entry.confirmed.set(entry.key(row), row);
606
+ }
607
+ for (const row of diff.changed) {
608
+ entry.confirmed.set(entry.key(row), row);
609
+ }
610
+ };
611
+ const settlePending = (mutationId) => {
612
+ const entry = mutationOwner.get(mutationId);
613
+ mutationOwner.delete(mutationId);
614
+ if (entry === undefined) {
615
+ return;
616
+ }
617
+ const index = entry.pending.findIndex((mutation2) => mutation2.mutationId === mutationId);
618
+ if (index === -1) {
619
+ return;
620
+ }
621
+ const [mutation] = entry.pending.splice(index, 1);
622
+ return { entry, mutation };
623
+ };
624
+ const applyFrame = (frame) => {
625
+ if (frame.type === "snapshot") {
626
+ const entry = entries.get(frame.id);
627
+ if (entry === undefined) {
628
+ return;
629
+ }
630
+ entry.confirmed.clear();
631
+ for (const row of frame.rows) {
632
+ entry.confirmed.set(entry.key(row), row);
633
+ }
634
+ if (frame.version !== undefined) {
635
+ entry.appliedVersion = frame.version;
636
+ }
637
+ recompute(entry, { status: "ready", error: undefined });
638
+ } else if (frame.type === "diff") {
639
+ const entry = entries.get(frame.id);
640
+ if (entry === undefined) {
641
+ return;
642
+ }
643
+ applyDiffToConfirmed(entry, frame);
644
+ if (frame.version !== undefined) {
645
+ entry.appliedVersion = Math.max(entry.appliedVersion, frame.version);
646
+ }
647
+ recompute(entry);
648
+ } else if (frame.type === "frame") {
649
+ const affected = new Set;
650
+ for (const diff of frame.diffs) {
651
+ const entry = entries.get(diff.id);
652
+ if (entry === undefined) {
653
+ continue;
654
+ }
655
+ applyDiffToConfirmed(entry, diff);
656
+ if (frame.version !== undefined) {
657
+ entry.appliedVersion = Math.max(entry.appliedVersion, frame.version);
658
+ }
659
+ rebuild(entry);
660
+ affected.add(entry);
661
+ }
662
+ for (const entry of affected) {
663
+ notify(entry);
664
+ }
665
+ } else if (frame.type === "error") {
666
+ if (frame.id !== undefined) {
667
+ const entry = entries.get(frame.id);
668
+ if (entry !== undefined) {
669
+ recompute(entry, { error: frame.message });
670
+ }
671
+ }
672
+ options.onError?.(frame.message);
673
+ } else if (frame.type === "ack") {
674
+ const settled = settlePending(frame.mutationId);
675
+ if (settled !== undefined) {
676
+ recompute(settled.entry);
677
+ settled.mutation.resolve(frame.result);
678
+ }
679
+ } else if (frame.type === "reject") {
680
+ const settled = settlePending(frame.mutationId);
681
+ if (settled !== undefined) {
682
+ recompute(settled.entry);
683
+ settled.mutation.reject(new Error(String(frame.message)));
684
+ }
685
+ }
686
+ };
687
+ const sendSubscribe = (entry) => {
688
+ socket?.send(JSON.stringify({
689
+ type: "subscribe",
690
+ id: entry.id,
691
+ collection: entry.collection,
692
+ params: entry.params,
693
+ since: entry.appliedVersion > 0 ? entry.appliedVersion : undefined
694
+ }));
695
+ };
696
+ const sendMutate = (mutation) => {
697
+ if (connected) {
698
+ socket?.send(JSON.stringify({
699
+ type: "mutate",
700
+ mutationId: mutation.mutationId,
701
+ name: mutation.name,
702
+ args: mutation.args
703
+ }));
704
+ }
705
+ };
706
+ const connect = () => {
707
+ if (closed) {
708
+ return;
709
+ }
710
+ const ws = new Impl(options.url);
711
+ socket = ws;
712
+ ws.onopen = () => {
713
+ attempt = 0;
714
+ connected = true;
715
+ for (const entry of entries.values()) {
716
+ sendSubscribe(entry);
717
+ }
718
+ for (const entry of entries.values()) {
719
+ for (const mutation of entry.pending) {
720
+ sendMutate(mutation);
721
+ }
722
+ }
723
+ };
724
+ ws.onmessage = (event) => {
725
+ try {
726
+ applyFrame(JSON.parse(event.data));
727
+ } catch {}
728
+ };
729
+ ws.onclose = () => {
730
+ connected = false;
731
+ if (closed || reconnectMs <= 0) {
732
+ return;
733
+ }
734
+ const delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);
735
+ attempt += 1;
736
+ reconnectTimer = setTimeout(connect, delay);
737
+ };
738
+ };
739
+ connect();
740
+ const collection = (handleOptions) => {
741
+ const entryId = `c${nextEntryId}`;
742
+ nextEntryId += 1;
743
+ const entry = {
744
+ id: entryId,
745
+ collection: handleOptions.collection,
746
+ params: handleOptions.params,
747
+ key: handleOptions.key ?? ((row) => row.id),
748
+ confirmed: new Map,
749
+ pending: [],
750
+ state: { data: [], status: "connecting", error: undefined },
751
+ listeners: new Set,
752
+ appliedVersion: 0,
753
+ closed: false
754
+ };
755
+ entries.set(entryId, entry);
756
+ if (connected) {
757
+ sendSubscribe(entry);
758
+ }
759
+ return {
760
+ get: () => entry.state,
761
+ subscribe: (listener) => {
762
+ const typed = listener;
763
+ entry.listeners.add(typed);
764
+ listener(entry.state);
765
+ return () => {
766
+ entry.listeners.delete(typed);
767
+ };
768
+ },
769
+ mutate: (mutateOptions) => new Promise((resolve, reject) => {
770
+ mutationSeq += 1;
771
+ const mutation = {
772
+ mutationId: mutationSeq,
773
+ name: mutateOptions.name,
774
+ args: mutateOptions.args,
775
+ optimistic: mutateOptions.optimistic,
776
+ resolve: (result) => resolve(result),
777
+ reject
778
+ };
779
+ entry.pending.push(mutation);
780
+ mutationOwner.set(mutation.mutationId, entry);
781
+ recompute(entry);
782
+ sendMutate(mutation);
783
+ }),
784
+ close: () => {
785
+ if (entry.closed) {
786
+ return;
787
+ }
788
+ entry.closed = true;
789
+ entries.delete(entryId);
790
+ if (connected) {
791
+ socket?.send(JSON.stringify({ type: "unsubscribe", id: entryId }));
792
+ }
793
+ }
794
+ };
795
+ };
796
+ const close = () => {
797
+ closed = true;
798
+ if (reconnectTimer !== undefined) {
799
+ clearTimeout(reconnectTimer);
800
+ }
801
+ socket?.close();
802
+ entries.clear();
803
+ mutationOwner.clear();
804
+ };
805
+ return { collection, close };
806
+ };
807
+ // src/client/syncStore.ts
808
+ var SUBSCRIPTION_ID2 = "s";
809
+ var syncStore = (options) => {
810
+ const key = options.key ?? ((row) => row.id);
811
+ const reconnectMs = options.reconnectMs ?? 500;
812
+ const maxReconnectMs = options.maxReconnectMs ?? 1e4;
813
+ const reconcileGraceMs = options.reconcileGraceMs ?? 3000;
814
+ const mutations = options.mutations ?? {};
815
+ const Impl = options.webSocketImpl ?? globalThis.WebSocket;
816
+ if (!Impl) {
817
+ throw new Error("syncStore requires WebSocket. Run in a browser or pass webSocketImpl.");
818
+ }
819
+ const confirmed = new Map;
820
+ const pending = [];
821
+ let mutationSeq = 0;
822
+ let state = {
823
+ data: options.initialData ? [...options.initialData] : [],
824
+ status: "connecting",
825
+ error: undefined
826
+ };
827
+ if (options.initialData) {
828
+ for (const row of options.initialData) {
829
+ confirmed.set(key(row), row);
830
+ }
831
+ }
832
+ const listeners = new Set;
833
+ const setState = (patch) => {
834
+ state = { ...state, ...patch };
835
+ for (const listener of listeners) {
836
+ listener(state);
837
+ }
838
+ };
839
+ const recompute = (patch = {}) => {
840
+ const working = new Map(confirmed);
841
+ const draft = {
842
+ set: (row) => working.set(key(row), row),
843
+ delete: (rowKey) => working.delete(rowKey)
844
+ };
845
+ for (const mutation of pending) {
846
+ mutation.optimistic?.(draft);
847
+ }
848
+ setState({ ...patch, data: [...working.values()] });
849
+ };
850
+ const persist = () => {
851
+ options.storage?.save(pending.map((mutation) => ({
852
+ mutationId: mutation.id,
853
+ name: mutation.name,
854
+ args: mutation.args
855
+ })));
856
+ };
857
+ const dropPending = (mutation) => {
858
+ const index = pending.indexOf(mutation);
859
+ if (index !== -1) {
860
+ pending.splice(index, 1);
861
+ }
862
+ if (mutation.graceTimer !== undefined) {
863
+ clearTimeout(mutation.graceTimer);
864
+ }
865
+ };
866
+ const reconcileSettled = () => {
867
+ let changed = false;
868
+ for (const mutation of [...pending]) {
869
+ if (!mutation.settled) {
870
+ continue;
871
+ }
872
+ let reflected = true;
873
+ for (const [rowKey, kind] of mutation.touched) {
874
+ const present = confirmed.has(rowKey);
875
+ if (kind === "set" ? !present : present) {
876
+ reflected = false;
877
+ break;
878
+ }
879
+ }
880
+ if (reflected) {
881
+ dropPending(mutation);
882
+ changed = true;
883
+ }
884
+ }
885
+ if (changed) {
886
+ recompute();
887
+ }
888
+ };
889
+ let socket;
890
+ let connected = false;
891
+ let closed = false;
892
+ let attempt = 0;
893
+ let reconnectTimer;
894
+ let appliedVersion = 0;
895
+ const applyFrame = (frame) => {
896
+ if (frame.type === "snapshot") {
897
+ confirmed.clear();
898
+ for (const row of frame.rows) {
899
+ confirmed.set(key(row), row);
900
+ }
901
+ if (frame.version !== undefined) {
902
+ appliedVersion = frame.version;
903
+ }
904
+ recompute({ status: "ready", error: undefined });
905
+ reconcileSettled();
906
+ } else if (frame.type === "diff") {
907
+ for (const row of frame.removed) {
908
+ confirmed.delete(key(row));
909
+ }
910
+ for (const row of frame.added) {
911
+ confirmed.set(key(row), row);
912
+ }
913
+ for (const row of frame.changed) {
914
+ confirmed.set(key(row), row);
915
+ }
916
+ if (frame.version !== undefined) {
917
+ appliedVersion = Math.max(appliedVersion, frame.version);
918
+ }
919
+ recompute();
920
+ reconcileSettled();
921
+ } else if (frame.type === "error") {
922
+ setState({ error: frame.message });
923
+ options.onError?.(frame.message);
924
+ }
925
+ };
926
+ const runMutation = async (mutation) => {
927
+ if (mutation.inFlight || mutation.settled) {
928
+ return;
929
+ }
930
+ const run = mutations[mutation.name];
931
+ if (run === undefined) {
932
+ dropPending(mutation);
933
+ recompute();
934
+ mutation.reject(new Error(`Unknown mutation "${mutation.name}"`));
935
+ return;
936
+ }
937
+ mutation.inFlight = true;
938
+ try {
939
+ const result = await run(mutation.args);
940
+ mutation.inFlight = false;
941
+ mutation.settled = true;
942
+ mutation.resolve(result);
943
+ persist();
944
+ reconcileSettled();
945
+ if (pending.includes(mutation)) {
946
+ mutation.graceTimer = setTimeout(() => {
947
+ dropPending(mutation);
948
+ recompute();
949
+ }, reconcileGraceMs);
950
+ }
951
+ } catch (error) {
952
+ mutation.inFlight = false;
953
+ if (connected) {
954
+ dropPending(mutation);
955
+ recompute();
956
+ persist();
957
+ mutation.reject(error);
958
+ } else {
959
+ options.onError?.(error);
960
+ }
961
+ }
962
+ };
963
+ const connect = () => {
964
+ if (closed) {
965
+ return;
966
+ }
967
+ setState({ status: "connecting" });
968
+ const ws = new Impl(options.url);
969
+ socket = ws;
970
+ ws.onopen = () => {
971
+ attempt = 0;
972
+ connected = true;
973
+ ws.send(JSON.stringify({
974
+ type: "subscribe",
975
+ id: SUBSCRIPTION_ID2,
976
+ collection: options.collection,
977
+ params: options.params,
978
+ since: appliedVersion > 0 ? appliedVersion : undefined
979
+ }));
980
+ for (const mutation of pending) {
981
+ if (!mutation.settled && !mutation.inFlight) {
982
+ runMutation(mutation);
983
+ }
984
+ }
985
+ };
986
+ ws.onmessage = (event) => {
987
+ try {
988
+ applyFrame(JSON.parse(event.data));
989
+ } catch {}
990
+ };
991
+ ws.onclose = () => {
992
+ connected = false;
993
+ if (closed || reconnectMs <= 0) {
994
+ return;
995
+ }
996
+ const delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);
997
+ attempt += 1;
998
+ reconnectTimer = setTimeout(connect, delay);
999
+ };
1000
+ };
1001
+ const eagerHydrate = async () => {
1002
+ if (options.hydrate === undefined || options.initialData !== undefined) {
1003
+ return;
1004
+ }
1005
+ try {
1006
+ const rows = await options.hydrate();
1007
+ if (state.status !== "ready") {
1008
+ confirmed.clear();
1009
+ for (const row of rows) {
1010
+ confirmed.set(key(row), row);
1011
+ }
1012
+ recompute({ status: "ready" });
1013
+ }
1014
+ } catch (error) {
1015
+ options.onError?.(error);
1016
+ }
1017
+ };
1018
+ const hydratePersisted = async () => {
1019
+ if (options.storage === undefined) {
1020
+ return;
1021
+ }
1022
+ const records = await options.storage.load();
1023
+ for (const record of records) {
1024
+ if (pending.some((m) => m.id === record.mutationId)) {
1025
+ continue;
1026
+ }
1027
+ pending.push({
1028
+ id: record.mutationId,
1029
+ name: record.name,
1030
+ args: record.args,
1031
+ touched: new Map,
1032
+ settled: false,
1033
+ inFlight: false,
1034
+ resolve: () => {},
1035
+ reject: () => {}
1036
+ });
1037
+ mutationSeq = Math.max(mutationSeq, record.mutationId);
1038
+ }
1039
+ if (connected) {
1040
+ for (const mutation of pending) {
1041
+ runMutation(mutation);
1042
+ }
1043
+ }
1044
+ };
1045
+ connect();
1046
+ eagerHydrate();
1047
+ hydratePersisted();
1048
+ const collectTouched = (optimistic) => {
1049
+ const touched = new Map;
1050
+ optimistic?.({
1051
+ set: (row) => touched.set(key(row), "set"),
1052
+ delete: (rowKey) => touched.set(rowKey, "delete")
1053
+ });
1054
+ return touched;
1055
+ };
1056
+ return {
1057
+ get: () => state,
1058
+ subscribe: (listener) => {
1059
+ listeners.add(listener);
1060
+ return () => {
1061
+ listeners.delete(listener);
1062
+ };
1063
+ },
1064
+ mutate: (name, args, mutateOptions) => new Promise((resolve, reject) => {
1065
+ const mutation = {
1066
+ id: mutationSeq += 1,
1067
+ name,
1068
+ args,
1069
+ touched: collectTouched(mutateOptions?.optimistic),
1070
+ optimistic: mutateOptions?.optimistic,
1071
+ settled: false,
1072
+ inFlight: false,
1073
+ resolve,
1074
+ reject
1075
+ };
1076
+ pending.push(mutation);
1077
+ persist();
1078
+ recompute();
1079
+ runMutation(mutation);
1080
+ }),
1081
+ refetch: async () => {
1082
+ if (options.hydrate === undefined) {
1083
+ return;
1084
+ }
1085
+ const rows = await options.hydrate();
1086
+ confirmed.clear();
1087
+ for (const row of rows) {
1088
+ confirmed.set(key(row), row);
1089
+ }
1090
+ recompute({ status: "ready" });
1091
+ },
1092
+ close: () => {
1093
+ if (closed) {
1094
+ return;
1095
+ }
1096
+ closed = true;
1097
+ connected = false;
1098
+ if (reconnectTimer !== undefined) {
1099
+ clearTimeout(reconnectTimer);
1100
+ }
1101
+ try {
1102
+ socket?.send(JSON.stringify({ type: "unsubscribe", id: SUBSCRIPTION_ID2 }));
1103
+ socket?.close();
1104
+ } catch {}
1105
+ for (const mutation of pending.splice(0)) {
1106
+ if (mutation.graceTimer !== undefined) {
1107
+ clearTimeout(mutation.graceTimer);
1108
+ }
1109
+ mutation.reject(new Error("sync store closed"));
1110
+ }
1111
+ persist();
1112
+ setState({ status: "closed" });
1113
+ listeners.clear();
1114
+ }
1115
+ };
1116
+ };
1117
+ var unwrapEden = async (response) => {
1118
+ const { data, error } = await response;
1119
+ if (error !== null && error !== undefined) {
1120
+ throw error;
1121
+ }
1122
+ return data;
1123
+ };
36
1124
  export {
37
- createSyncSubscriber
1125
+ unwrapEden,
1126
+ syncStore,
1127
+ localStorageMutationStorage,
1128
+ jsonFetcher,
1129
+ createSyncSubscriber,
1130
+ createSyncCollection,
1131
+ createSyncClient,
1132
+ createPresence,
1133
+ createLiveQuery
38
1134
  };
39
1135
 
40
- //# debugId=10D2496AED02ED9364756E2164756E21
1136
+ //# debugId=E83DAC6C389DAA6A64756E2164756E21
41
1137
  //# sourceMappingURL=index.js.map