cojson 0.19.21 → 0.19.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/.turbo/turbo-build.log +1 -1
  2. package/CHANGELOG.md +13 -0
  3. package/dist/CojsonMessageChannel/CojsonMessageChannel.d.ts +42 -0
  4. package/dist/CojsonMessageChannel/CojsonMessageChannel.d.ts.map +1 -0
  5. package/dist/CojsonMessageChannel/CojsonMessageChannel.js +261 -0
  6. package/dist/CojsonMessageChannel/CojsonMessageChannel.js.map +1 -0
  7. package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.d.ts +18 -0
  8. package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.d.ts.map +1 -0
  9. package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.js +37 -0
  10. package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.js.map +1 -0
  11. package/dist/CojsonMessageChannel/index.d.ts +3 -0
  12. package/dist/CojsonMessageChannel/index.d.ts.map +1 -0
  13. package/dist/CojsonMessageChannel/index.js +2 -0
  14. package/dist/CojsonMessageChannel/index.js.map +1 -0
  15. package/dist/CojsonMessageChannel/types.d.ts +149 -0
  16. package/dist/CojsonMessageChannel/types.d.ts.map +1 -0
  17. package/dist/CojsonMessageChannel/types.js +36 -0
  18. package/dist/CojsonMessageChannel/types.js.map +1 -0
  19. package/dist/GarbageCollector.d.ts +4 -2
  20. package/dist/GarbageCollector.d.ts.map +1 -1
  21. package/dist/GarbageCollector.js +5 -3
  22. package/dist/GarbageCollector.js.map +1 -1
  23. package/dist/SyncStateManager.d.ts +3 -3
  24. package/dist/SyncStateManager.d.ts.map +1 -1
  25. package/dist/SyncStateManager.js +4 -4
  26. package/dist/SyncStateManager.js.map +1 -1
  27. package/dist/coValueCore/coValueCore.d.ts +19 -1
  28. package/dist/coValueCore/coValueCore.d.ts.map +1 -1
  29. package/dist/coValueCore/coValueCore.js +29 -5
  30. package/dist/coValueCore/coValueCore.js.map +1 -1
  31. package/dist/exports.d.ts +1 -0
  32. package/dist/exports.d.ts.map +1 -1
  33. package/dist/exports.js +1 -0
  34. package/dist/exports.js.map +1 -1
  35. package/dist/localNode.d.ts +1 -3
  36. package/dist/localNode.d.ts.map +1 -1
  37. package/dist/localNode.js +3 -2
  38. package/dist/localNode.js.map +1 -1
  39. package/dist/storage/storageAsync.d.ts +8 -3
  40. package/dist/storage/storageAsync.d.ts.map +1 -1
  41. package/dist/storage/storageAsync.js +12 -3
  42. package/dist/storage/storageAsync.js.map +1 -1
  43. package/dist/storage/storageSync.d.ts +8 -3
  44. package/dist/storage/storageSync.d.ts.map +1 -1
  45. package/dist/storage/storageSync.js +12 -3
  46. package/dist/storage/storageSync.js.map +1 -1
  47. package/dist/storage/types.d.ts +5 -0
  48. package/dist/storage/types.d.ts.map +1 -1
  49. package/dist/sync.d.ts +6 -0
  50. package/dist/sync.d.ts.map +1 -1
  51. package/dist/sync.js +25 -4
  52. package/dist/sync.js.map +1 -1
  53. package/dist/tests/CojsonMessageChannel.test.d.ts +2 -0
  54. package/dist/tests/CojsonMessageChannel.test.d.ts.map +1 -0
  55. package/dist/tests/CojsonMessageChannel.test.js +236 -0
  56. package/dist/tests/CojsonMessageChannel.test.js.map +1 -0
  57. package/dist/tests/GarbageCollector.test.js +87 -13
  58. package/dist/tests/GarbageCollector.test.js.map +1 -1
  59. package/dist/tests/StorageApiAsync.test.js +33 -1
  60. package/dist/tests/StorageApiAsync.test.js.map +1 -1
  61. package/dist/tests/StorageApiSync.test.js +32 -0
  62. package/dist/tests/StorageApiSync.test.js.map +1 -1
  63. package/dist/tests/SyncManager.processQueues.test.js +1 -1
  64. package/dist/tests/SyncManager.processQueues.test.js.map +1 -1
  65. package/dist/tests/SyncStateManager.test.js +1 -1
  66. package/dist/tests/SyncStateManager.test.js.map +1 -1
  67. package/dist/tests/coPlainText.test.js +1 -1
  68. package/dist/tests/coPlainText.test.js.map +1 -1
  69. package/dist/tests/coValueCore.loadFromStorage.test.js +1 -0
  70. package/dist/tests/coValueCore.loadFromStorage.test.js.map +1 -1
  71. package/dist/tests/knownState.lazyLoading.test.js +1 -0
  72. package/dist/tests/knownState.lazyLoading.test.js.map +1 -1
  73. package/dist/tests/sync.garbageCollection.test.js +56 -32
  74. package/dist/tests/sync.garbageCollection.test.js.map +1 -1
  75. package/dist/tests/sync.load.test.js +3 -5
  76. package/dist/tests/sync.load.test.js.map +1 -1
  77. package/dist/tests/sync.mesh.test.js +1 -1
  78. package/dist/tests/sync.mesh.test.js.map +1 -1
  79. package/dist/tests/sync.peerReconciliation.test.js +3 -3
  80. package/dist/tests/sync.peerReconciliation.test.js.map +1 -1
  81. package/dist/tests/sync.storage.test.js +9 -9
  82. package/dist/tests/sync.storage.test.js.map +1 -1
  83. package/dist/tests/sync.storageAsync.test.js +7 -7
  84. package/dist/tests/sync.storageAsync.test.js.map +1 -1
  85. package/dist/tests/sync.tracking.test.js +35 -4
  86. package/dist/tests/sync.tracking.test.js.map +1 -1
  87. package/dist/tests/testStorage.js +2 -2
  88. package/dist/tests/testStorage.js.map +1 -1
  89. package/dist/tests/testUtils.d.ts +24 -2
  90. package/dist/tests/testUtils.d.ts.map +1 -1
  91. package/dist/tests/testUtils.js +68 -7
  92. package/dist/tests/testUtils.js.map +1 -1
  93. package/package.json +4 -4
  94. package/src/CojsonMessageChannel/CojsonMessageChannel.ts +332 -0
  95. package/src/CojsonMessageChannel/MessagePortOutgoingChannel.ts +52 -0
  96. package/src/CojsonMessageChannel/index.ts +9 -0
  97. package/src/CojsonMessageChannel/types.ts +200 -0
  98. package/src/GarbageCollector.ts +5 -5
  99. package/src/SyncStateManager.ts +6 -6
  100. package/src/coValueCore/coValueCore.ts +30 -7
  101. package/src/exports.ts +1 -0
  102. package/src/localNode.ts +3 -5
  103. package/src/storage/storageAsync.ts +15 -4
  104. package/src/storage/storageSync.ts +15 -4
  105. package/src/storage/types.ts +6 -0
  106. package/src/sync.ts +33 -4
  107. package/src/tests/CojsonMessageChannel.test.ts +306 -0
  108. package/src/tests/GarbageCollector.test.ts +114 -13
  109. package/src/tests/StorageApiAsync.test.ts +50 -1
  110. package/src/tests/StorageApiSync.test.ts +49 -0
  111. package/src/tests/SyncManager.processQueues.test.ts +1 -1
  112. package/src/tests/SyncStateManager.test.ts +1 -1
  113. package/src/tests/coPlainText.test.ts +1 -1
  114. package/src/tests/coValueCore.loadFromStorage.test.ts +2 -0
  115. package/src/tests/knownState.lazyLoading.test.ts +2 -0
  116. package/src/tests/sync.garbageCollection.test.ts +69 -36
  117. package/src/tests/sync.load.test.ts +3 -5
  118. package/src/tests/sync.mesh.test.ts +1 -1
  119. package/src/tests/sync.peerReconciliation.test.ts +3 -3
  120. package/src/tests/sync.storage.test.ts +9 -9
  121. package/src/tests/sync.storageAsync.test.ts +7 -7
  122. package/src/tests/sync.tracking.test.ts +54 -4
  123. package/src/tests/testStorage.ts +2 -2
  124. package/src/tests/testUtils.ts +85 -6
@@ -1,4 +1,4 @@
1
1
 
2
- > cojson@0.19.21 build /home/runner/_work/jazz/jazz/packages/cojson
2
+ > cojson@0.19.22 build /home/runner/_work/jazz/jazz/packages/cojson
3
3
  > rm -rf ./dist && tsc --sourceMap --outDir dist
4
4
 
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # cojson
2
2
 
3
+ ## 0.19.22
4
+
5
+ ### Patch Changes
6
+
7
+ - 3b70482: Wait for CoValues' dependencies to be garbage-collected before collecting them. This makes accounts and groups safe to be collected.
8
+ - 6078ea5: Wait for CoValues to be synced before garbage-collecting them
9
+ - cojson-core-wasm@0.19.22
10
+ - cojson-core-rn@0.19.22
11
+ - cojson-core-napi@0.19.22
12
+
3
13
  ## 0.19.19
4
14
 
5
15
  ### Patch Changes
@@ -355,6 +365,7 @@
355
365
  ### Patch Changes
356
366
 
357
367
  - a584ab3: Add WasmCrypto support for Cloudflare Workers and edge runtimes by importing `jazz-tools/load-edge-wasm`.
368
+
358
369
  - Enable WasmCrypto functionality by initializing the WebAssembly environment with the import: `import "jazz-tools/load-edge-wasm"` in edge runtimes.
359
370
  - Guarantee compatibility across Cloudflare Workers and other edge runtime environments.
360
371
 
@@ -375,6 +386,7 @@
375
386
  - 2ddf4d9: Introducing version control APIs, unstable_branch and unstable_merge
376
387
 
377
388
  Flagged as unstable because branch & merge scope & propagation needs to be validated.
389
+
378
390
  - cojson-core-wasm@0.18.13
379
391
 
380
392
  ## 0.18.12
@@ -590,6 +602,7 @@
590
602
  - 3cd1586: Makes the key rotation not fail when child groups are unavailable or their readkey is not accessible.
591
603
 
592
604
  Also changes the Group.removeMember method to not return a Promise, because:
605
+
593
606
  - All the locally available child groups are rotated immediately
594
607
  - All the remote child groups are rotated in background, but since they are not locally available the user won't need the new key immediately
595
608
 
@@ -0,0 +1,42 @@
1
+ import type { Peer } from "../sync.js";
2
+ import type { AcceptFromPortOptions, WaitForConnectionOptions, ExposeOptions, MessagePortLike, PostMessageTarget } from "./types.js";
3
+ /**
4
+ * CojsonMessageChannel provides a low-level API for creating cojson peers
5
+ * that communicate via the MessageChannel API (or compatible implementations
6
+ * like Electron's MessageChannelMain).
7
+ *
8
+ * Inspired by Comlink, it handles:
9
+ * - Port management (creating MessageChannels and transferring ports)
10
+ * - Handshake protocol (ensuring both sides are ready)
11
+ * - Peer creation (returning a standard cojson Peer)
12
+ */
13
+ export declare class CojsonMessageChannel {
14
+ /**
15
+ * Expose a cojson connection to a target with a postMessage API.
16
+ * Creates a MessageChannel, transfers port2 to the target, and waits for handshake.
17
+ *
18
+ * @param target - Any object with a postMessage method (Worker, Window, MessagePort, etc.)
19
+ * @param opts - Configuration options
20
+ * @returns A promise that resolves to a Peer once the handshake completes
21
+ */
22
+ static expose(target: PostMessageTarget, opts?: ExposeOptions): Promise<Peer>;
23
+ /**
24
+ * Wait for an incoming Jazz connection.
25
+ * Listens for a port transfer message on the global scope and completes the handshake.
26
+ *
27
+ * @param opts - Configuration options
28
+ * @returns A promise that resolves to a Peer once the handshake completes
29
+ */
30
+ static waitForConnection(opts?: WaitForConnectionOptions): Promise<Peer>;
31
+ /**
32
+ * Accept an incoming Jazz connection from a specific port.
33
+ * Lower-level API useful for testing or when you already have the port.
34
+ * This method has no timeout - it will wait indefinitely for the handshake.
35
+ *
36
+ * @param port - The MessagePort to accept the connection on
37
+ * @param opts - Configuration options
38
+ * @returns A promise that resolves to a Peer once the handshake completes
39
+ */
40
+ static acceptFromPort(port: MessagePortLike, opts?: AcceptFromPortOptions): Promise<Peer>;
41
+ }
42
+ //# sourceMappingURL=CojsonMessageChannel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CojsonMessageChannel.d.ts","sourceRoot":"","sources":["../../src/CojsonMessageChannel/CojsonMessageChannel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,aAAa,EAEb,eAAe,EACf,iBAAiB,EAElB,MAAM,YAAY,CAAC;AASpB;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC;IA0FhB;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D5E;;;;;;;;OAQG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;CA2DjB"}
@@ -0,0 +1,261 @@
1
+ import { ConnectedPeerChannel } from "../streamUtils.js";
2
+ import { MessagePortOutgoingChannel } from "./MessagePortOutgoingChannel.js";
3
+ import { isControlMessage, isPortTransferMessage, isReadyAckMessage, isReadyMessage, } from "./types.js";
4
+ import { logger } from "../logger.js";
5
+ /**
6
+ * CojsonMessageChannel provides a low-level API for creating cojson peers
7
+ * that communicate via the MessageChannel API (or compatible implementations
8
+ * like Electron's MessageChannelMain).
9
+ *
10
+ * Inspired by Comlink, it handles:
11
+ * - Port management (creating MessageChannels and transferring ports)
12
+ * - Handshake protocol (ensuring both sides are ready)
13
+ * - Peer creation (returning a standard cojson Peer)
14
+ */
15
+ export class CojsonMessageChannel {
16
+ /**
17
+ * Expose a cojson connection to a target with a postMessage API.
18
+ * Creates a MessageChannel, transfers port2 to the target, and waits for handshake.
19
+ *
20
+ * @param target - Any object with a postMessage method (Worker, Window, MessagePort, etc.)
21
+ * @param opts - Configuration options
22
+ * @returns A promise that resolves to a Peer once the handshake completes
23
+ */
24
+ static expose(target, opts = {}) {
25
+ const id = opts.id ?? `channel_${Math.random()}`;
26
+ const role = opts.role ?? "client";
27
+ // Create or use provided MessageChannel
28
+ const channel = opts.messageChannel ?? new MessageChannel();
29
+ const { port1, port2 } = channel;
30
+ return new Promise((resolve, reject) => {
31
+ let resolved = false;
32
+ const cleanup = () => {
33
+ port1.removeEventListener("message", handleMessage);
34
+ port1.removeEventListener("messageerror", handleError);
35
+ };
36
+ const handleError = (evt) => {
37
+ if (resolved)
38
+ return;
39
+ cleanup();
40
+ port1.close();
41
+ reject(new Error("MessageChannel error during handshake", {
42
+ cause: evt,
43
+ }));
44
+ };
45
+ const handleMessage = (event) => {
46
+ const data = event.data;
47
+ // Wait for ready acknowledgment from guest
48
+ if (isReadyAckMessage(data)) {
49
+ if (resolved)
50
+ return;
51
+ resolved = true;
52
+ cleanup();
53
+ // Create the peer
54
+ const peer = createPeerFromPort(port1, {
55
+ id,
56
+ role,
57
+ onClose: opts.onClose,
58
+ });
59
+ resolve(peer);
60
+ }
61
+ };
62
+ // Start listening on port1
63
+ port1.addEventListener("message", handleMessage);
64
+ port1.addEventListener("messageerror", handleError);
65
+ // Start the port if needed (browser MessagePort requires this)
66
+ if (port1.start) {
67
+ port1.start();
68
+ }
69
+ // Transfer port2 to target
70
+ // Detect if target is a Window (has postMessage with targetOrigin signature)
71
+ // We use duck typing: if targetOrigin is provided, assume it's a Window
72
+ const targetOrigin = opts.targetOrigin ?? "*";
73
+ const portTransferMessage = { type: "jazz:port", id };
74
+ try {
75
+ // Try Window-style postMessage first if targetOrigin is specified
76
+ if (opts.targetOrigin !== undefined) {
77
+ // Window/iframe: postMessage(data, targetOrigin, [transfer])
78
+ target.postMessage(portTransferMessage, targetOrigin, [port2]);
79
+ }
80
+ else {
81
+ // Worker/MessagePort style: postMessage(data, [transfer])
82
+ target.postMessage(portTransferMessage, [port2]);
83
+ }
84
+ }
85
+ catch {
86
+ // Fallback: try the other signature
87
+ try {
88
+ target.postMessage(portTransferMessage, [port2]);
89
+ }
90
+ catch (e) {
91
+ cleanup();
92
+ port1.close();
93
+ reject(new Error(`Failed to transfer port to target: ${e}`));
94
+ return;
95
+ }
96
+ }
97
+ // Send ready message with our ID
98
+ const readyMessage = { type: "jazz:ready", id };
99
+ port1.postMessage(readyMessage);
100
+ });
101
+ }
102
+ /**
103
+ * Wait for an incoming Jazz connection.
104
+ * Listens for a port transfer message on the global scope and completes the handshake.
105
+ *
106
+ * @param opts - Configuration options
107
+ * @returns A promise that resolves to a Peer once the handshake completes
108
+ */
109
+ static waitForConnection(opts = {}) {
110
+ return new Promise((resolve) => {
111
+ let resolved = false;
112
+ const scope = globalThis;
113
+ const cleanup = () => {
114
+ scope.removeEventListener("message", handlePortTransfer);
115
+ };
116
+ const handlePortTransfer = async (event) => {
117
+ const messageEvent = event;
118
+ const data = messageEvent.data;
119
+ // Check if this is a valid port transfer message
120
+ if (!isPortTransferMessage(data)) {
121
+ return;
122
+ }
123
+ // If id filter is provided, check it against the port transfer message
124
+ if (opts.id !== undefined && data.id !== opts.id) {
125
+ return; // Ignore, keep waiting for matching id
126
+ }
127
+ // Validate origin if in Window context and allowedOrigins is specified
128
+ if (opts.allowedOrigins && opts.allowedOrigins.length > 0) {
129
+ const origin = messageEvent.origin;
130
+ const isAllowed = opts.allowedOrigins.some((allowed) => allowed === "*" || allowed === origin);
131
+ if (!isAllowed) {
132
+ logger.warn(`Ignoring message from non-allowed origin: ${origin}`);
133
+ return; // Ignore messages from non-allowed origins
134
+ }
135
+ }
136
+ // Get the transferred port
137
+ const port = messageEvent.ports?.[0];
138
+ if (!port) {
139
+ return; // No port transferred, ignore
140
+ }
141
+ if (resolved)
142
+ return;
143
+ resolved = true;
144
+ cleanup();
145
+ // Complete the handshake using acceptFromPort
146
+ // Pass the id from the port transfer message to acceptFromPort
147
+ const peer = await CojsonMessageChannel.acceptFromPort(port, {
148
+ ...opts,
149
+ id: data.id, // Use the id from the port transfer message
150
+ });
151
+ resolve(peer);
152
+ };
153
+ // Start listening for port transfer
154
+ scope.addEventListener("message", handlePortTransfer);
155
+ });
156
+ }
157
+ /**
158
+ * Accept an incoming Jazz connection from a specific port.
159
+ * Lower-level API useful for testing or when you already have the port.
160
+ * This method has no timeout - it will wait indefinitely for the handshake.
161
+ *
162
+ * @param port - The MessagePort to accept the connection on
163
+ * @param opts - Configuration options
164
+ * @returns A promise that resolves to a Peer once the handshake completes
165
+ */
166
+ static acceptFromPort(port, opts = {}) {
167
+ const role = opts.role ?? "client";
168
+ return new Promise((resolve) => {
169
+ let resolved = false;
170
+ let peerId;
171
+ const cleanup = () => {
172
+ port.removeEventListener("message", handleMessage);
173
+ port.removeEventListener("messageerror", handleError);
174
+ };
175
+ const handleError = () => {
176
+ if (resolved)
177
+ return;
178
+ // On error, just close and let the caller handle it
179
+ cleanup();
180
+ port.close();
181
+ };
182
+ const handleMessage = (event) => {
183
+ const data = event.data;
184
+ // Wait for ready message from host
185
+ if (isReadyMessage(data)) {
186
+ // If id filter is provided, validate it
187
+ if (opts.id !== undefined && data.id !== opts.id) {
188
+ return; // Ignore, keep waiting for matching id
189
+ }
190
+ peerId = data.id;
191
+ // Send acknowledgment
192
+ port.postMessage({ type: "jazz:ready" });
193
+ if (resolved)
194
+ return;
195
+ resolved = true;
196
+ cleanup();
197
+ // Create the peer
198
+ const peer = createPeerFromPort(port, {
199
+ id: peerId,
200
+ role,
201
+ onClose: opts.onClose,
202
+ });
203
+ resolve(peer);
204
+ }
205
+ };
206
+ // Start listening
207
+ port.addEventListener("message", handleMessage);
208
+ port.addEventListener("messageerror", handleError);
209
+ // Start the port if needed (browser MessagePort requires this)
210
+ if (port.start) {
211
+ port.start();
212
+ }
213
+ });
214
+ }
215
+ }
216
+ /**
217
+ * Create a Peer from a MessagePort after handshake is complete.
218
+ */
219
+ function createPeerFromPort(port, opts) {
220
+ const incoming = new ConnectedPeerChannel();
221
+ const outgoing = new MessagePortOutgoingChannel(port);
222
+ // Forward messages from port to incoming channel
223
+ const handleMessage = (event) => {
224
+ const data = event.data;
225
+ // Skip control messages (they're for handshake only)
226
+ if (isControlMessage(data)) {
227
+ return;
228
+ }
229
+ incoming.push(data);
230
+ };
231
+ const handleError = () => {
232
+ incoming.push("Disconnected");
233
+ incoming.close();
234
+ };
235
+ port.addEventListener("message", handleMessage);
236
+ port.addEventListener("messageerror", handleError);
237
+ port.addEventListener("close", () => {
238
+ incoming.push("Disconnected");
239
+ incoming.close();
240
+ });
241
+ // Handle outgoing channel close
242
+ outgoing.onClose(() => {
243
+ port.removeEventListener("message", handleMessage);
244
+ port.removeEventListener("messageerror", handleError);
245
+ port.close();
246
+ incoming.push("Disconnected");
247
+ incoming.close();
248
+ opts.onClose?.();
249
+ });
250
+ // Handle incoming channel close (propagate to outgoing)
251
+ incoming.onClose(() => {
252
+ outgoing.close();
253
+ });
254
+ return {
255
+ id: opts.id,
256
+ incoming,
257
+ outgoing,
258
+ role: opts.role,
259
+ };
260
+ }
261
+ //# sourceMappingURL=CojsonMessageChannel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CojsonMessageChannel.js","sourceRoot":"","sources":["../../src/CojsonMessageChannel/CojsonMessageChannel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAU7E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,MAAyB,EACzB,OAAsB,EAAE;QAExB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;QAEnC,wCAAwC;QACxC,MAAM,OAAO,GACX,IAAI,CAAC,cAAc,IAAI,IAAI,cAAc,EAAE,CAAC;QAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAEjC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBACpD,KAAK,CAAC,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACzD,CAAC,CAAC;YAEF,MAAM,WAAW,GAAG,CAAC,GAAY,EAAE,EAAE;gBACnC,IAAI,QAAQ;oBAAE,OAAO;gBACrB,OAAO,EAAE,CAAC;gBACV,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,MAAM,CACJ,IAAI,KAAK,CAAC,uCAAuC,EAAE;oBACjD,KAAK,EAAE,GAAG;iBACX,CAAC,CACH,CAAC;YACJ,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAI,KAAsB,CAAC,IAAI,CAAC;gBAE1C,2CAA2C;gBAC3C,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5B,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,OAAO,EAAE,CAAC;oBAEV,kBAAkB;oBAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE;wBACrC,EAAE;wBACF,IAAI;wBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;qBACtB,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC;YAEF,2BAA2B;YAC3B,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACjD,KAAK,CAAC,gBAAgB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAEpD,+DAA+D;YAC/D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;YAED,2BAA2B;YAC3B,6EAA6E;YAC7E,wEAAwE;YACxE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC;YAC9C,MAAM,mBAAmB,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;YAEtD,IAAI,CAAC;gBACH,kEAAkE;gBAClE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;oBACpC,6DAA6D;oBAC7D,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,0DAA0D;oBAC1D,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;gBACpC,IAAI,CAAC;oBACH,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,EAAE,CAAC;oBACV,KAAK,CAAC,KAAK,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,MAAM,YAAY,GAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAC9D,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAiC,EAAE;QAC1D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,KAAK,GAAG,UAAoC,CAAC;YAEnD,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;YAC3D,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAAc,EAAE,EAAE;gBAClD,MAAM,YAAY,GAAG,KAAqB,CAAC;gBAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;gBAE/B,iDAAiD;gBACjD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjC,OAAO;gBACT,CAAC;gBAED,uEAAuE;gBACvE,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;oBACjD,OAAO,CAAC,uCAAuC;gBACjD,CAAC;gBAED,uEAAuE;gBACvE,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;oBACnC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CACxC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,MAAM,CACnD,CAAC;oBACF,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC;wBACnE,OAAO,CAAC,2CAA2C;oBACrD,CAAC;gBACH,CAAC;gBAED,2BAA2B;gBAC3B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAgC,CAAC;gBACpE,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO,CAAC,8BAA8B;gBACxC,CAAC;gBAED,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,EAAE,CAAC;gBAEV,8CAA8C;gBAC9C,+DAA+D;gBAC/D,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,cAAc,CAAC,IAAI,EAAE;oBAC3D,GAAG,IAAI;oBACP,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,4CAA4C;iBAC1D,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC;YAEF,oCAAoC;YACpC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,cAAc,CACnB,IAAqB,EACrB,OAA8B,EAAE;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;QAEnC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,MAA0B,CAAC;YAE/B,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBACnD,IAAI,CAAC,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACxD,CAAC,CAAC;YAEF,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,IAAI,QAAQ;oBAAE,OAAO;gBACrB,oDAAoD;gBACpD,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAI,KAAsB,CAAC,IAAI,CAAC;gBAE1C,mCAAmC;gBACnC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,wCAAwC;oBACxC,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;wBACjD,OAAO,CAAC,uCAAuC;oBACjD,CAAC;oBAED,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;oBAEjB,sBAAsB;oBACtB,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;oBAEzC,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,OAAO,EAAE,CAAC;oBAEV,kBAAkB;oBAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE;wBACpC,EAAE,EAAE,MAAM;wBACV,IAAI;wBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;qBACtB,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC;YAEF,kBAAkB;YAClB,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAChD,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAEnD,+DAA+D;YAC/D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,IAAqB,EACrB,IAIC;IAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAEtD,iDAAiD;IACjD,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE;QACvC,MAAM,IAAI,GAAI,KAAsB,CAAC,IAAI,CAAC;QAE1C,qDAAqD;QACrD,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAChD,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QAClC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;QACpB,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACnD,IAAI,CAAC,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;QACpB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ;QACR,QAAQ;QACR,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { DisconnectedError, OutgoingPeerChannel, SyncMessage } from "../sync.js";
2
+ import type { MessagePortLike } from "./types.js";
3
+ /**
4
+ * An implementation of OutgoingPeerChannel that sends messages via a MessagePortLike.
5
+ *
6
+ * Messages are sent directly using the port's postMessage method,
7
+ * which uses structured cloning (no JSON serialization needed).
8
+ */
9
+ export declare class MessagePortOutgoingChannel implements OutgoingPeerChannel {
10
+ private port;
11
+ private closed;
12
+ private closeListeners;
13
+ constructor(port: MessagePortLike);
14
+ push(msg: SyncMessage | DisconnectedError): void;
15
+ close(): void;
16
+ onClose(callback: () => void): void;
17
+ }
18
+ //# sourceMappingURL=MessagePortOutgoingChannel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MessagePortOutgoingChannel.d.ts","sourceRoot":"","sources":["../../src/CojsonMessageChannel/MessagePortOutgoingChannel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAyB;gBAEnC,IAAI,EAAE,eAAe;IAIjC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI;IAahD,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAGpC"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * An implementation of OutgoingPeerChannel that sends messages via a MessagePortLike.
3
+ *
4
+ * Messages are sent directly using the port's postMessage method,
5
+ * which uses structured cloning (no JSON serialization needed).
6
+ */
7
+ export class MessagePortOutgoingChannel {
8
+ constructor(port) {
9
+ this.closed = false;
10
+ this.closeListeners = new Set();
11
+ this.port = port;
12
+ }
13
+ push(msg) {
14
+ if (this.closed) {
15
+ return;
16
+ }
17
+ if (msg === "Disconnected") {
18
+ this.close();
19
+ return;
20
+ }
21
+ this.port.postMessage(msg);
22
+ }
23
+ close() {
24
+ if (this.closed) {
25
+ return;
26
+ }
27
+ this.closed = true;
28
+ this.port.close();
29
+ for (const listener of this.closeListeners) {
30
+ listener();
31
+ }
32
+ }
33
+ onClose(callback) {
34
+ this.closeListeners.add(callback);
35
+ }
36
+ }
37
+ //# sourceMappingURL=MessagePortOutgoingChannel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MessagePortOutgoingChannel.js","sourceRoot":"","sources":["../../src/CojsonMessageChannel/MessagePortOutgoingChannel.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAKrC,YAAY,IAAqB;QAHzB,WAAM,GAAG,KAAK,CAAC;QACf,mBAAc,GAAG,IAAI,GAAG,EAAc,CAAC;QAG7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,GAAoC;QACvC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAElB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAoB;QAC1B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF"}
@@ -0,0 +1,3 @@
1
+ export { CojsonMessageChannel } from "./CojsonMessageChannel.js";
2
+ export type { AcceptFromPortOptions, WaitForConnectionOptions, ExposeOptions, MessageChannelLike, PostMessageTarget, MessagePortLike, } from "./types.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/CojsonMessageChannel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { CojsonMessageChannel } from "./CojsonMessageChannel.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/CojsonMessageChannel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
@@ -0,0 +1,149 @@
1
+ /**
2
+ * Type definitions for JazzMessageChannel
3
+ *
4
+ * These types support cross-context communication via MessageChannel API
5
+ * and compatible implementations (e.g., Electron's MessageChannelMain).
6
+ */
7
+ /**
8
+ * Duck-typed interface for any object that can receive messages via postMessage.
9
+ *
10
+ * Covers:
11
+ * - Worker
12
+ * - Window (including iframes via contentWindow)
13
+ * - MessagePort
14
+ * - ServiceWorker
15
+ * - Client (Service Worker clients)
16
+ * - Electron's WebContents (renderer windows)
17
+ */
18
+ export interface PostMessageTarget {
19
+ postMessage(message: unknown, transfer?: MessagePortLike[]): void;
20
+ postMessage(message: unknown, targetOrigin: string, transfer?: MessagePortLike[]): void;
21
+ }
22
+ /**
23
+ * MessagePort-like interface that covers browser MessagePort and Electron MessagePortMain.
24
+ *
25
+ * Note: Electron's MessagePortMain does not have a start() method,
26
+ * so it's optional here.
27
+ */
28
+ export interface MessagePortLike {
29
+ postMessage(message: unknown): void;
30
+ addEventListener(type: "message" | "messageerror", listener: (event: unknown) => void): void;
31
+ removeEventListener(type: "message" | "messageerror", listener: (event: unknown) => void): void;
32
+ addEventListener(event: "close", listener: () => void): void;
33
+ removeEventListener(type: "close", listener: () => void): void;
34
+ /** Optional - not present on Electron's MessagePortMain */
35
+ start?(): void;
36
+ close(): void;
37
+ }
38
+ /**
39
+ * MessageChannel-like interface that covers browser MessageChannel
40
+ * and Electron MessageChannelMain.
41
+ */
42
+ export interface MessageChannelLike {
43
+ port1: MessagePortLike;
44
+ port2: MessagePortLike;
45
+ }
46
+ /**
47
+ * Options for JazzMessageChannel.expose()
48
+ */
49
+ export interface ExposeOptions {
50
+ /**
51
+ * Unique identifier for the peer connection, sent to the guest during handshake.
52
+ * Both sides will use this same ID for the Peer object.
53
+ * If not provided, a unique ID will be generated using `channel_${Math.random()}`.
54
+ */
55
+ id?: string;
56
+ /** Role of the peer in the sync topology */
57
+ role?: "client" | "server";
58
+ /** Target origin for Window targets (default: "*") */
59
+ targetOrigin?: string;
60
+ /**
61
+ * A pre-created MessageChannel to use instead of creating a new one.
62
+ * Use this for environments where the global MessageChannel is not available,
63
+ * e.g., Electron main process with MessageChannelMain.
64
+ * If not provided, a new MessageChannel will be created.
65
+ */
66
+ messageChannel?: MessageChannelLike;
67
+ /** Callback when the connection closes */
68
+ onClose?: () => void;
69
+ }
70
+ /**
71
+ * Options for CojsonMessageChannel.waitForConnection()
72
+ */
73
+ export interface WaitForConnectionOptions {
74
+ /**
75
+ * Expected peer ID to accept.
76
+ * If provided, only handshakes with matching id will be accepted; others are ignored.
77
+ * If not provided, any connection will be accepted.
78
+ */
79
+ id?: string;
80
+ /** Role of the peer in the sync topology */
81
+ role?: "client" | "server";
82
+ /** Allowed origins for Window contexts (default: ["*"]) */
83
+ allowedOrigins?: string[];
84
+ /** Callback when the connection closes */
85
+ onClose?: () => void;
86
+ }
87
+ /**
88
+ * Options for CojsonMessageChannel.acceptFromPort()
89
+ * Note: No timeout option - acceptFromPort waits indefinitely.
90
+ */
91
+ export interface AcceptFromPortOptions {
92
+ /**
93
+ * Expected peer ID to accept.
94
+ * If provided, only handshakes with matching id will be accepted; others are ignored.
95
+ * If not provided, any connection will be accepted.
96
+ */
97
+ id?: string;
98
+ /** Role of the peer in the sync topology */
99
+ role?: "client" | "server";
100
+ /** Callback when the connection closes */
101
+ onClose?: () => void;
102
+ }
103
+ /**
104
+ * Port transfer message sent via target.postMessage.
105
+ * The actual port is transferred via Transferable.
106
+ */
107
+ export interface PortTransferMessage {
108
+ type: "jazz:port";
109
+ /** The peer ID for this connection */
110
+ id: string;
111
+ }
112
+ /**
113
+ * Ready signal sent from host to guest via MessagePort.
114
+ * Contains the peer ID that both sides will use.
115
+ */
116
+ export interface ReadyMessage {
117
+ type: "jazz:ready";
118
+ /** The peer ID to use on both sides */
119
+ id: string;
120
+ }
121
+ /**
122
+ * Acknowledgment sent from guest to host via MessagePort.
123
+ * No id needed - guest uses the id from the host's ReadyMessage.
124
+ */
125
+ export interface ReadyAckMessage {
126
+ type: "jazz:ready";
127
+ }
128
+ /**
129
+ * Union of all control messages used in the handshake protocol.
130
+ */
131
+ export type ControlMessage = PortTransferMessage | ReadyMessage | ReadyAckMessage;
132
+ /**
133
+ * Type guard to check if a message is a Jazz control message.
134
+ * Control messages are identified by having a "type" property starting with "jazz:".
135
+ */
136
+ export declare function isControlMessage(msg: unknown): msg is ControlMessage;
137
+ /**
138
+ * Type guard to check if a message is a PortTransferMessage.
139
+ */
140
+ export declare function isPortTransferMessage(msg: unknown): msg is PortTransferMessage;
141
+ /**
142
+ * Type guard to check if a message is a ReadyMessage (with id).
143
+ */
144
+ export declare function isReadyMessage(msg: unknown): msg is ReadyMessage;
145
+ /**
146
+ * Type guard to check if a message is a ReadyAckMessage (without id).
147
+ */
148
+ export declare function isReadyAckMessage(msg: unknown): msg is ReadyAckMessage;
149
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/CojsonMessageChannel/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAClE,WAAW,CACT,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,IAAI,CAAC;CACT;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,gBAAgB,CACd,IAAI,EAAE,SAAS,GAAG,cAAc,EAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI,CAAC;IACR,mBAAmB,CACjB,IAAI,EAAE,SAAS,GAAG,cAAc,EAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI,CAAC;IACR,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7D,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/D,2DAA2D;IAC3D,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE3B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAEpC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE3B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE3B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,YAAY,GACZ,eAAe,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAQpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,mBAAmB,CAE5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAEtE"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Type definitions for JazzMessageChannel
3
+ *
4
+ * These types support cross-context communication via MessageChannel API
5
+ * and compatible implementations (e.g., Electron's MessageChannelMain).
6
+ */
7
+ /**
8
+ * Type guard to check if a message is a Jazz control message.
9
+ * Control messages are identified by having a "type" property starting with "jazz:".
10
+ */
11
+ export function isControlMessage(msg) {
12
+ return (typeof msg === "object" &&
13
+ msg !== null &&
14
+ "type" in msg &&
15
+ typeof msg.type === "string" &&
16
+ msg.type.startsWith("jazz:"));
17
+ }
18
+ /**
19
+ * Type guard to check if a message is a PortTransferMessage.
20
+ */
21
+ export function isPortTransferMessage(msg) {
22
+ return isControlMessage(msg) && msg.type === "jazz:port";
23
+ }
24
+ /**
25
+ * Type guard to check if a message is a ReadyMessage (with id).
26
+ */
27
+ export function isReadyMessage(msg) {
28
+ return isControlMessage(msg) && msg.type === "jazz:ready" && "id" in msg;
29
+ }
30
+ /**
31
+ * Type guard to check if a message is a ReadyAckMessage (without id).
32
+ */
33
+ export function isReadyAckMessage(msg) {
34
+ return isControlMessage(msg) && msg.type === "jazz:ready" && !("id" in msg);
35
+ }
36
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/CojsonMessageChannel/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+JH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAY;IAEZ,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,IAAI,GAAG,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;AAC9E,CAAC"}
@@ -1,10 +1,12 @@
1
1
  import { CoValueCore } from "./coValueCore/coValueCore.js";
2
2
  import { RawCoID } from "./ids.js";
3
+ /**
4
+ * TTL-based garbage collector for removing unused CoValues from memory.
5
+ */
3
6
  export declare class GarbageCollector {
4
7
  private readonly coValues;
5
- private readonly garbageCollectGroups;
6
8
  private readonly interval;
7
- constructor(coValues: Map<RawCoID, CoValueCore>, garbageCollectGroups: boolean);
9
+ constructor(coValues: Map<RawCoID, CoValueCore>);
8
10
  getCurrentTime(): number;
9
11
  trackCoValueAccess({ verified }: CoValueCore): void;
10
12
  collect(): void;