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.
- package/.turbo/turbo-build.log +1 -1
- package/CHANGELOG.md +13 -0
- package/dist/CojsonMessageChannel/CojsonMessageChannel.d.ts +42 -0
- package/dist/CojsonMessageChannel/CojsonMessageChannel.d.ts.map +1 -0
- package/dist/CojsonMessageChannel/CojsonMessageChannel.js +261 -0
- package/dist/CojsonMessageChannel/CojsonMessageChannel.js.map +1 -0
- package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.d.ts +18 -0
- package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.d.ts.map +1 -0
- package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.js +37 -0
- package/dist/CojsonMessageChannel/MessagePortOutgoingChannel.js.map +1 -0
- package/dist/CojsonMessageChannel/index.d.ts +3 -0
- package/dist/CojsonMessageChannel/index.d.ts.map +1 -0
- package/dist/CojsonMessageChannel/index.js +2 -0
- package/dist/CojsonMessageChannel/index.js.map +1 -0
- package/dist/CojsonMessageChannel/types.d.ts +149 -0
- package/dist/CojsonMessageChannel/types.d.ts.map +1 -0
- package/dist/CojsonMessageChannel/types.js +36 -0
- package/dist/CojsonMessageChannel/types.js.map +1 -0
- package/dist/GarbageCollector.d.ts +4 -2
- package/dist/GarbageCollector.d.ts.map +1 -1
- package/dist/GarbageCollector.js +5 -3
- package/dist/GarbageCollector.js.map +1 -1
- package/dist/SyncStateManager.d.ts +3 -3
- package/dist/SyncStateManager.d.ts.map +1 -1
- package/dist/SyncStateManager.js +4 -4
- package/dist/SyncStateManager.js.map +1 -1
- package/dist/coValueCore/coValueCore.d.ts +19 -1
- package/dist/coValueCore/coValueCore.d.ts.map +1 -1
- package/dist/coValueCore/coValueCore.js +29 -5
- package/dist/coValueCore/coValueCore.js.map +1 -1
- package/dist/exports.d.ts +1 -0
- package/dist/exports.d.ts.map +1 -1
- package/dist/exports.js +1 -0
- package/dist/exports.js.map +1 -1
- package/dist/localNode.d.ts +1 -3
- package/dist/localNode.d.ts.map +1 -1
- package/dist/localNode.js +3 -2
- package/dist/localNode.js.map +1 -1
- package/dist/storage/storageAsync.d.ts +8 -3
- package/dist/storage/storageAsync.d.ts.map +1 -1
- package/dist/storage/storageAsync.js +12 -3
- package/dist/storage/storageAsync.js.map +1 -1
- package/dist/storage/storageSync.d.ts +8 -3
- package/dist/storage/storageSync.d.ts.map +1 -1
- package/dist/storage/storageSync.js +12 -3
- package/dist/storage/storageSync.js.map +1 -1
- package/dist/storage/types.d.ts +5 -0
- package/dist/storage/types.d.ts.map +1 -1
- package/dist/sync.d.ts +6 -0
- package/dist/sync.d.ts.map +1 -1
- package/dist/sync.js +25 -4
- package/dist/sync.js.map +1 -1
- package/dist/tests/CojsonMessageChannel.test.d.ts +2 -0
- package/dist/tests/CojsonMessageChannel.test.d.ts.map +1 -0
- package/dist/tests/CojsonMessageChannel.test.js +236 -0
- package/dist/tests/CojsonMessageChannel.test.js.map +1 -0
- package/dist/tests/GarbageCollector.test.js +87 -13
- package/dist/tests/GarbageCollector.test.js.map +1 -1
- package/dist/tests/StorageApiAsync.test.js +33 -1
- package/dist/tests/StorageApiAsync.test.js.map +1 -1
- package/dist/tests/StorageApiSync.test.js +32 -0
- package/dist/tests/StorageApiSync.test.js.map +1 -1
- package/dist/tests/SyncManager.processQueues.test.js +1 -1
- package/dist/tests/SyncManager.processQueues.test.js.map +1 -1
- package/dist/tests/SyncStateManager.test.js +1 -1
- package/dist/tests/SyncStateManager.test.js.map +1 -1
- package/dist/tests/coPlainText.test.js +1 -1
- package/dist/tests/coPlainText.test.js.map +1 -1
- package/dist/tests/coValueCore.loadFromStorage.test.js +1 -0
- package/dist/tests/coValueCore.loadFromStorage.test.js.map +1 -1
- package/dist/tests/knownState.lazyLoading.test.js +1 -0
- package/dist/tests/knownState.lazyLoading.test.js.map +1 -1
- package/dist/tests/sync.garbageCollection.test.js +56 -32
- package/dist/tests/sync.garbageCollection.test.js.map +1 -1
- package/dist/tests/sync.load.test.js +3 -5
- package/dist/tests/sync.load.test.js.map +1 -1
- package/dist/tests/sync.mesh.test.js +1 -1
- package/dist/tests/sync.mesh.test.js.map +1 -1
- package/dist/tests/sync.peerReconciliation.test.js +3 -3
- package/dist/tests/sync.peerReconciliation.test.js.map +1 -1
- package/dist/tests/sync.storage.test.js +9 -9
- package/dist/tests/sync.storage.test.js.map +1 -1
- package/dist/tests/sync.storageAsync.test.js +7 -7
- package/dist/tests/sync.storageAsync.test.js.map +1 -1
- package/dist/tests/sync.tracking.test.js +35 -4
- package/dist/tests/sync.tracking.test.js.map +1 -1
- package/dist/tests/testStorage.js +2 -2
- package/dist/tests/testStorage.js.map +1 -1
- package/dist/tests/testUtils.d.ts +24 -2
- package/dist/tests/testUtils.d.ts.map +1 -1
- package/dist/tests/testUtils.js +68 -7
- package/dist/tests/testUtils.js.map +1 -1
- package/package.json +4 -4
- package/src/CojsonMessageChannel/CojsonMessageChannel.ts +332 -0
- package/src/CojsonMessageChannel/MessagePortOutgoingChannel.ts +52 -0
- package/src/CojsonMessageChannel/index.ts +9 -0
- package/src/CojsonMessageChannel/types.ts +200 -0
- package/src/GarbageCollector.ts +5 -5
- package/src/SyncStateManager.ts +6 -6
- package/src/coValueCore/coValueCore.ts +30 -7
- package/src/exports.ts +1 -0
- package/src/localNode.ts +3 -5
- package/src/storage/storageAsync.ts +15 -4
- package/src/storage/storageSync.ts +15 -4
- package/src/storage/types.ts +6 -0
- package/src/sync.ts +33 -4
- package/src/tests/CojsonMessageChannel.test.ts +306 -0
- package/src/tests/GarbageCollector.test.ts +114 -13
- package/src/tests/StorageApiAsync.test.ts +50 -1
- package/src/tests/StorageApiSync.test.ts +49 -0
- package/src/tests/SyncManager.processQueues.test.ts +1 -1
- package/src/tests/SyncStateManager.test.ts +1 -1
- package/src/tests/coPlainText.test.ts +1 -1
- package/src/tests/coValueCore.loadFromStorage.test.ts +2 -0
- package/src/tests/knownState.lazyLoading.test.ts +2 -0
- package/src/tests/sync.garbageCollection.test.ts +69 -36
- package/src/tests/sync.load.test.ts +3 -5
- package/src/tests/sync.mesh.test.ts +1 -1
- package/src/tests/sync.peerReconciliation.test.ts +3 -3
- package/src/tests/sync.storage.test.ts +9 -9
- package/src/tests/sync.storageAsync.test.ts +7 -7
- package/src/tests/sync.tracking.test.ts +54 -4
- package/src/tests/testStorage.ts +2 -2
- package/src/tests/testUtils.ts +85 -6
package/.turbo/turbo-build.log
CHANGED
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":"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"}
|
|
@@ -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 @@
|
|
|
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 @@
|
|
|
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":"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"}
|
|
@@ -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
|
|
9
|
+
constructor(coValues: Map<RawCoID, CoValueCore>);
|
|
8
10
|
getCurrentTime(): number;
|
|
9
11
|
trackCoValueAccess({ verified }: CoValueCore): void;
|
|
10
12
|
collect(): void;
|