@dxos/network-manager 0.3.9-main.320ebac → 0.3.9-main.35264cb

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 (61) hide show
  1. package/dist/lib/browser/{chunk-S2JHWVGQ.mjs → chunk-XF474R3E.mjs} +183 -82
  2. package/dist/lib/browser/chunk-XF474R3E.mjs.map +7 -0
  3. package/dist/lib/browser/index.mjs +1 -11
  4. package/dist/lib/browser/meta.json +1 -1
  5. package/dist/lib/browser/testing/index.mjs +3 -3
  6. package/dist/lib/node/{chunk-3SCPMSHV.cjs → chunk-Y2B5BDRH.cjs} +179 -84
  7. package/dist/lib/node/chunk-Y2B5BDRH.cjs.map +7 -0
  8. package/dist/lib/node/index.cjs +27 -36
  9. package/dist/lib/node/index.cjs.map +2 -2
  10. package/dist/lib/node/meta.json +1 -1
  11. package/dist/lib/node/testing/index.cjs +18 -19
  12. package/dist/lib/node/testing/index.cjs.map +1 -1
  13. package/dist/types/src/topology/mmst-topology.d.ts +1 -0
  14. package/dist/types/src/topology/mmst-topology.d.ts.map +1 -1
  15. package/dist/types/src/transport/index.d.ts +0 -1
  16. package/dist/types/src/transport/index.d.ts.map +1 -1
  17. package/dist/types/src/transport/libdatachannel-transport.d.ts +1 -0
  18. package/dist/types/src/transport/libdatachannel-transport.d.ts.map +1 -1
  19. package/dist/types/src/transport/simplepeer-transport.d.ts +3 -0
  20. package/dist/types/src/transport/simplepeer-transport.d.ts.map +1 -1
  21. package/package.json +18 -18
  22. package/src/topology/mmst-topology.ts +34 -6
  23. package/src/transport/index.ts +0 -1
  24. package/src/transport/libdatachannel-transport.test.ts +0 -4
  25. package/src/transport/libdatachannel-transport.ts +76 -34
  26. package/src/transport/simplepeer-transport.ts +7 -5
  27. package/dist/lib/browser/chunk-S2JHWVGQ.mjs.map +0 -7
  28. package/dist/lib/browser/chunk-YERMWDRB.mjs +0 -24
  29. package/dist/lib/browser/chunk-YERMWDRB.mjs.map +0 -7
  30. package/dist/lib/browser/index.browser-O53CPVK3.mjs +0 -14
  31. package/dist/lib/browser/index.browser-O53CPVK3.mjs.map +0 -7
  32. package/dist/lib/node/chunk-3SCPMSHV.cjs.map +0 -7
  33. package/dist/lib/node/chunk-DMWORJG3.cjs +0 -471
  34. package/dist/lib/node/chunk-DMWORJG3.cjs.map +0 -7
  35. package/dist/lib/node/datachannel-ABYQKZRC.cjs +0 -35
  36. package/dist/lib/node/datachannel-ABYQKZRC.cjs.map +0 -7
  37. package/dist/types/src/transport/datachannel/index.browser.d.ts +0 -15
  38. package/dist/types/src/transport/datachannel/index.browser.d.ts.map +0 -1
  39. package/dist/types/src/transport/datachannel/index.d.ts +0 -8
  40. package/dist/types/src/transport/datachannel/index.d.ts.map +0 -1
  41. package/dist/types/src/transport/datachannel/rtc-data-channel.d.ts +0 -29
  42. package/dist/types/src/transport/datachannel/rtc-data-channel.d.ts.map +0 -1
  43. package/dist/types/src/transport/datachannel/rtc-events.d.ts +0 -9
  44. package/dist/types/src/transport/datachannel/rtc-events.d.ts.map +0 -1
  45. package/dist/types/src/transport/datachannel/rtc-ice-candidate.d.ts +0 -22
  46. package/dist/types/src/transport/datachannel/rtc-ice-candidate.d.ts.map +0 -1
  47. package/dist/types/src/transport/datachannel/rtc-peer-connection.d.ts +0 -54
  48. package/dist/types/src/transport/datachannel/rtc-peer-connection.d.ts.map +0 -1
  49. package/dist/types/src/transport/datachannel/rtc-peer-connection.test.d.ts +0 -2
  50. package/dist/types/src/transport/datachannel/rtc-peer-connection.test.d.ts.map +0 -1
  51. package/dist/types/src/transport/datachannel/rtc-session-description.d.ts +0 -10
  52. package/dist/types/src/transport/datachannel/rtc-session-description.d.ts.map +0 -1
  53. package/src/transport/datachannel/README.md +0 -2
  54. package/src/transport/datachannel/index.browser.ts +0 -8
  55. package/src/transport/datachannel/index.ts +0 -17
  56. package/src/transport/datachannel/rtc-data-channel.ts +0 -148
  57. package/src/transport/datachannel/rtc-events.ts +0 -23
  58. package/src/transport/datachannel/rtc-ice-candidate.ts +0 -54
  59. package/src/transport/datachannel/rtc-peer-connection.test.ts +0 -112
  60. package/src/transport/datachannel/rtc-peer-connection.ts +0 -359
  61. package/src/transport/datachannel/rtc-session-description.ts +0 -23
@@ -10,6 +10,9 @@ import { log } from '@dxos/log';
10
10
 
11
11
  import { type SwarmController, type Topology } from './topology';
12
12
 
13
+ const MIN_UPDATE_INTERVAL = 1000 * 10;
14
+ const MAX_CHANGES_PER_UPDATE = 1;
15
+
13
16
  export interface MMSTTopologyOptions {
14
17
  /**
15
18
  * Number of connections the peer will originate by itself.
@@ -36,6 +39,8 @@ export class MMSTTopology implements Topology {
36
39
 
37
40
  private _sampleCollected = false;
38
41
 
42
+ private _lastAction = new Date(0);
43
+
39
44
  constructor({ originateConnections = 2, maxPeers = 4, sampleSize = 10 }: MMSTTopologyOptions = {}) {
40
45
  this._originateConnections = originateConnections;
41
46
  this._maxPeers = maxPeers;
@@ -74,22 +79,45 @@ export class MMSTTopology implements Topology {
74
79
  invariant(this._controller, 'Not initialized');
75
80
  const { connected, candidates, ownPeerId } = this._controller.getState();
76
81
 
82
+ // TODO(nf): does this rate limiting/flap dampening logic belong here or in the SwarmController?
77
83
  if (connected.length > this._maxPeers) {
78
84
  // Disconnect extra peers.
85
+ log(`disconnect ${connected.length - this._maxPeers} peers.`);
79
86
  const sorted = sortByXorDistance(connected, ownPeerId)
80
87
  .reverse()
81
88
  .slice(0, this._maxPeers - connected.length);
82
- for (const peer of sorted) {
83
- log(`Disconnect ${peer}.`);
84
- this._controller.disconnect(peer);
89
+ invariant(sorted.length === 0);
90
+
91
+ if (sorted.length > MAX_CHANGES_PER_UPDATE) {
92
+ log(`want to disconnect ${sorted.length} peers but limited to ${MAX_CHANGES_PER_UPDATE}`);
93
+ }
94
+
95
+ if (Date.now() - this._lastAction.getTime() > MIN_UPDATE_INTERVAL) {
96
+ for (const peer of sorted.slice(0, MAX_CHANGES_PER_UPDATE)) {
97
+ log(`Disconnect ${peer}.`);
98
+ this._controller.disconnect(peer);
99
+ }
100
+ this._lastAction = new Date();
101
+ } else {
102
+ log('rate limited discconnect');
85
103
  }
86
104
  } else if (connected.length < this._originateConnections) {
87
105
  // Connect new peers to reach desired quota.
106
+ log(`connect ${this._originateConnections - connected.length} peers.`);
88
107
  const sample = candidates.sort(() => Math.random() - 0.5).slice(0, this._sampleSize);
89
108
  const sorted = sortByXorDistance(sample, ownPeerId).slice(0, this._originateConnections - connected.length);
90
- for (const peer of sorted) {
91
- log(`Connect ${peer}.`);
92
- this._controller.connect(peer);
109
+
110
+ if (sorted.length > MAX_CHANGES_PER_UPDATE) {
111
+ log(`want to connect ${sorted.length} peers but limited to ${MAX_CHANGES_PER_UPDATE}`);
112
+ }
113
+ if (Date.now() - this._lastAction.getTime() > MIN_UPDATE_INTERVAL) {
114
+ for (const peer of sorted.slice(0, MAX_CHANGES_PER_UPDATE)) {
115
+ log(`Connect ${peer}.`);
116
+ this._controller.connect(peer);
117
+ }
118
+ this._lastAction = new Date();
119
+ } else {
120
+ log('rate limited connect');
93
121
  }
94
122
  }
95
123
  }
@@ -7,6 +7,5 @@ export * from './transport';
7
7
  export * from './simplepeer-transport';
8
8
  export * from './simplepeer-transport-service';
9
9
  export * from './simplepeer-transport-proxy';
10
- export * from './datachannel';
11
10
  export * from './libdatachannel-transport';
12
11
  export * from './tcp-transport';
@@ -2,10 +2,6 @@
2
2
  // Copyright 2023 DXOS.org
3
3
  //
4
4
 
5
- //
6
- // Copyright 2020 DXOS.org
7
- //
8
-
9
5
  import { Duplex } from 'stream';
10
6
 
11
7
  import { sleep, TestStream } from '@dxos/async';
@@ -9,7 +9,6 @@ import { ErrorStream } from '@dxos/debug';
9
9
  import { log } from '@dxos/log';
10
10
  import { type Signal } from '@dxos/protocols/proto/dxos/mesh/swarm';
11
11
 
12
- import { type PeerConnection } from './datachannel/rtc-peer-connection';
13
12
  import { type Transport, type TransportFactory, type TransportStats } from './transport';
14
13
 
15
14
  export type LibDataChannelTransportParams = {
@@ -34,7 +33,7 @@ export class LibDataChannelTransport implements Transport {
34
33
  private _connected = false;
35
34
  readonly connected = new Event();
36
35
  readonly errors = new ErrorStream();
37
- private readonly _peer: Promise<PeerConnection>;
36
+ private readonly _peer: Promise<RTCPeerConnection>;
38
37
  private _channel!: RTCDataChannel;
39
38
  private _stream!: Duplex;
40
39
 
@@ -43,11 +42,20 @@ export class LibDataChannelTransport implements Transport {
43
42
 
44
43
  constructor(private readonly params: LibDataChannelTransportParams) {
45
44
  this._peer = (async () => {
46
- const { RTCPeerConnection: PeerConnection } = await import('./datachannel');
45
+ /* eslint-disable @typescript-eslint/consistent-type-imports */
46
+ const { RTCPeerConnection } = (await importESM('node-datachannel/polyfill'))
47
+ .default as typeof import('node-datachannel/polyfill');
48
+ /* eslint-enable @typescript-eslint/consistent-type-imports */
47
49
  if (this._closed) {
48
50
  this.errors.raise(new Error('connection already closed'));
49
51
  }
50
- const peer = new PeerConnection(params.webrtcConfig);
52
+ // workaround https://github.com/murat-dogan/node-datachannel/pull/207
53
+ if (params.webrtcConfig) {
54
+ params.webrtcConfig.iceServers = params.webrtcConfig.iceServers ?? [];
55
+ } else {
56
+ params.webrtcConfig = { iceServers: [] };
57
+ }
58
+ const peer = new RTCPeerConnection(params.webrtcConfig);
51
59
 
52
60
  peer.onicecandidateerror = (event) => {
53
61
  log.error('peer.onicecandidateerror', { event });
@@ -84,10 +92,14 @@ export class LibDataChannelTransport implements Transport {
84
92
  }
85
93
  }
86
94
  };
95
+
87
96
  if (params.initiator) {
88
97
  peer
89
98
  .createOffer()
90
99
  .then(async (offer) => {
100
+ if (this._closed) {
101
+ return;
102
+ }
91
103
  if (peer.connectionState !== 'connecting') {
92
104
  log.error('i am initiator but peer not in state connecting', { peer });
93
105
  this.errors.raise(new Error('invalid state: peer is initiator, but other peer not in state connecting'));
@@ -184,6 +196,12 @@ export class LibDataChannelTransport implements Transport {
184
196
  return;
185
197
  }
186
198
  await this._disconnectStreams();
199
+ const peer = await this._peer;
200
+ try {
201
+ peer.close();
202
+ } catch (err: any) {
203
+ this.errors.raise(err);
204
+ }
187
205
  this._closed = true;
188
206
  this.closed.emit();
189
207
  }
@@ -238,39 +256,60 @@ export class LibDataChannelTransport implements Transport {
238
256
  }
239
257
 
240
258
  async getDetails(): Promise<string> {
241
- return this._peer
242
- .then(async (peer) => {
243
- const cp = await peer.getSelectedCandidatePair();
244
- if (!cp) {
245
- return 'unavailable';
246
- }
247
- return `${cp.remote.address}:${cp.remote.port}/${cp.remote.transportType} ${cp.remote.type}`;
248
- })
249
- .catch((err) => {
250
- log.catch(err);
251
- return 'unavailable';
252
- });
259
+ const stats = await this._getStats();
260
+ const rc = stats?.remoteCandidate;
261
+ if (!rc) {
262
+ return 'unavailable';
263
+ }
264
+
265
+ if (rc.candidateType === 'relay') {
266
+ return `${rc.ip}:${rc.port} relay for ${rc.relatedAddress}:${rc.relatedPort}`;
267
+ }
268
+ return `${rc.ip}:${rc.port} ${rc.candidateType}`;
269
+ }
270
+
271
+ async _getStats(): Promise<any> {
272
+ return this._peer.then(async (peer) => {
273
+ const stats = await peer.getStats();
274
+
275
+ const statsEntries = Array.from((stats as any).entries() as any[]);
276
+ const transport = statsEntries.filter((s) => s[1].type === 'transport')[0][1];
277
+ const candidatePair = statsEntries.filter((s: any) => s[0] === transport.selectedCandidatePairId);
278
+ let selectedCandidatePair: any;
279
+ let remoteCandidate: any;
280
+ if (candidatePair.length > 0) {
281
+ selectedCandidatePair = candidatePair[0][1];
282
+ remoteCandidate = statsEntries.filter((s: any) => s[0] === selectedCandidatePair.remoteCandidateId)[0][1];
283
+ }
284
+
285
+ return {
286
+ transport,
287
+ selectedCandidatePair,
288
+ remoteCandidate,
289
+ raw: Object.fromEntries(stats as any),
290
+ };
291
+ });
253
292
  }
254
293
 
255
294
  async getStats(): Promise<TransportStats> {
256
- return this._peer
257
- .then((peer) => {
258
- return {
259
- bytesSent: peer.bytesSent(),
260
- bytesReceived: peer.bytesReceived(),
261
- packetsSent: 0,
262
- packetsReceived: 0,
263
- };
264
- })
265
- .catch((err) => {
266
- log.catch(err);
267
- return {
268
- bytesSent: 0,
269
- bytesReceived: 0,
270
- packetsSent: 0,
271
- packetsReceived: 0,
272
- };
273
- });
295
+ const stats = await this._getStats();
296
+ if (!stats) {
297
+ return {
298
+ bytesSent: 0,
299
+ bytesReceived: 0,
300
+ packetsSent: 0,
301
+ packetsReceived: 0,
302
+ rawStats: {},
303
+ };
304
+ }
305
+
306
+ return {
307
+ bytesSent: stats.transport.bytesSent,
308
+ bytesReceived: stats.transport.bytesReceived,
309
+ packetsSent: 0,
310
+ packetsReceived: 0,
311
+ rawStats: stats.raw,
312
+ };
274
313
  }
275
314
 
276
315
  // TODO(nf): add classmethod to call node-datachannel.cleanup() when all instances have been destroyed?
@@ -290,3 +329,6 @@ export const createLibDataChannelTransportFactory = (webrtcConfig?: any): Transp
290
329
  webrtcConfig,
291
330
  }),
292
331
  });
332
+
333
+ // eslint-disable-next-line no-new-func
334
+ const importESM = Function('path', 'return import(path)');
@@ -37,6 +37,9 @@ export class SimplePeerTransport implements Transport {
37
37
 
38
38
  private readonly _instanceId = PublicKey.random().toHex();
39
39
 
40
+ /**
41
+ * @params opts.config formatted as per https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/RTCPeerConnection
42
+ */
40
43
  constructor(private readonly params: SimplePeerTransportParams) {
41
44
  log.trace('dxos.mesh.webrtc-transport.constructor', trace.begin({ id: this._instanceId }));
42
45
  log('created connection', params);
@@ -142,8 +145,8 @@ export class SimplePeerTransport implements Transport {
142
145
  return {
143
146
  bytesSent: stats.transport.bytesSent,
144
147
  bytesReceived: stats.transport.bytesReceived,
145
- packetsSent: stats.transport.messagesSent,
146
- packetsReceived: stats.transport.messagesReceived,
148
+ packetsSent: stats.transport.packetsSent,
149
+ packetsReceived: stats.transport.packetsReceived,
147
150
  rawStats: stats.raw,
148
151
  };
149
152
  }
@@ -179,8 +182,8 @@ export class SimplePeerTransport implements Transport {
179
182
  return 'unavailable';
180
183
  }
181
184
 
182
- if (rc.relay) {
183
- return `${rc.ip}:${rc.port}/${rc.protocol} relay for XXX ${rc.candidateType}`;
185
+ if (rc.candidateType === 'relay') {
186
+ return `${rc.ip}:${rc.port}/${rc.protocol} relay for ${rc.relatedAddress}:${rc.relatedPort}`;
184
187
  }
185
188
  return `${rc.ip}:${rc.port}/${rc.protocol} ${rc.candidateType}`;
186
189
  }
@@ -190,7 +193,6 @@ export class SimplePeerTransport implements Transport {
190
193
  if (this._closed) {
191
194
  return;
192
195
  }
193
- this._closed = true;
194
196
  this._disconnectStreams();
195
197
  this._peer!.destroy();
196
198
  this._closed = true;