@lng2004/node-datachannel 0.31.0-20251228

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 (171) hide show
  1. package/.clang-format +17 -0
  2. package/.editorconfig +12 -0
  3. package/.eslintignore +8 -0
  4. package/.eslintrc.json +27 -0
  5. package/.gitmodules +3 -0
  6. package/.prettierignore +7 -0
  7. package/.prettierrc +13 -0
  8. package/API.md +247 -0
  9. package/BULDING.md +33 -0
  10. package/CMakeLists.txt +134 -0
  11. package/LICENSE +373 -0
  12. package/README.md +130 -0
  13. package/dist/cjs/index.cjs +11 -0
  14. package/dist/cjs/index.cjs.map +1 -0
  15. package/dist/cjs/lib/datachannel-stream.cjs +101 -0
  16. package/dist/cjs/lib/datachannel-stream.cjs.map +1 -0
  17. package/dist/cjs/lib/index.cjs +88 -0
  18. package/dist/cjs/lib/index.cjs.map +1 -0
  19. package/dist/cjs/lib/node-datachannel.cjs +8 -0
  20. package/dist/cjs/lib/node-datachannel.cjs.map +1 -0
  21. package/dist/cjs/lib/websocket-server.cjs +45 -0
  22. package/dist/cjs/lib/websocket-server.cjs.map +1 -0
  23. package/dist/cjs/lib/websocket.cjs +8 -0
  24. package/dist/cjs/lib/websocket.cjs.map +1 -0
  25. package/dist/cjs/polyfill/Events.cjs +86 -0
  26. package/dist/cjs/polyfill/Events.cjs.map +1 -0
  27. package/dist/cjs/polyfill/Exception.cjs +34 -0
  28. package/dist/cjs/polyfill/Exception.cjs.map +1 -0
  29. package/dist/cjs/polyfill/RTCCertificate.cjs +34 -0
  30. package/dist/cjs/polyfill/RTCCertificate.cjs.map +1 -0
  31. package/dist/cjs/polyfill/RTCDataChannel.cjs +214 -0
  32. package/dist/cjs/polyfill/RTCDataChannel.cjs.map +1 -0
  33. package/dist/cjs/polyfill/RTCDtlsTransport.cjs +53 -0
  34. package/dist/cjs/polyfill/RTCDtlsTransport.cjs.map +1 -0
  35. package/dist/cjs/polyfill/RTCError.cjs +83 -0
  36. package/dist/cjs/polyfill/RTCError.cjs.map +1 -0
  37. package/dist/cjs/polyfill/RTCIceCandidate.cjs +132 -0
  38. package/dist/cjs/polyfill/RTCIceCandidate.cjs.map +1 -0
  39. package/dist/cjs/polyfill/RTCIceTransport.cjs +94 -0
  40. package/dist/cjs/polyfill/RTCIceTransport.cjs.map +1 -0
  41. package/dist/cjs/polyfill/RTCPeerConnection.cjs +434 -0
  42. package/dist/cjs/polyfill/RTCPeerConnection.cjs.map +1 -0
  43. package/dist/cjs/polyfill/RTCSctpTransport.cjs +59 -0
  44. package/dist/cjs/polyfill/RTCSctpTransport.cjs.map +1 -0
  45. package/dist/cjs/polyfill/RTCSessionDescription.cjs +45 -0
  46. package/dist/cjs/polyfill/RTCSessionDescription.cjs.map +1 -0
  47. package/dist/cjs/polyfill/index.cjs +42 -0
  48. package/dist/cjs/polyfill/index.cjs.map +1 -0
  49. package/dist/esm/index.mjs +8 -0
  50. package/dist/esm/index.mjs.map +1 -0
  51. package/dist/esm/lib/datachannel-stream.mjs +78 -0
  52. package/dist/esm/lib/datachannel-stream.mjs.map +1 -0
  53. package/dist/esm/lib/index.mjs +62 -0
  54. package/dist/esm/lib/index.mjs.map +1 -0
  55. package/dist/esm/lib/node-datachannel.mjs +12 -0
  56. package/dist/esm/lib/node-datachannel.mjs.map +1 -0
  57. package/dist/esm/lib/websocket-server.mjs +43 -0
  58. package/dist/esm/lib/websocket-server.mjs.map +1 -0
  59. package/dist/esm/lib/websocket.mjs +6 -0
  60. package/dist/esm/lib/websocket.mjs.map +1 -0
  61. package/dist/esm/polyfill/Events.mjs +82 -0
  62. package/dist/esm/polyfill/Events.mjs.map +1 -0
  63. package/dist/esm/polyfill/Exception.mjs +28 -0
  64. package/dist/esm/polyfill/Exception.mjs.map +1 -0
  65. package/dist/esm/polyfill/RTCCertificate.mjs +30 -0
  66. package/dist/esm/polyfill/RTCCertificate.mjs.map +1 -0
  67. package/dist/esm/polyfill/RTCDataChannel.mjs +210 -0
  68. package/dist/esm/polyfill/RTCDataChannel.mjs.map +1 -0
  69. package/dist/esm/polyfill/RTCDtlsTransport.mjs +49 -0
  70. package/dist/esm/polyfill/RTCDtlsTransport.mjs.map +1 -0
  71. package/dist/esm/polyfill/RTCError.mjs +79 -0
  72. package/dist/esm/polyfill/RTCError.mjs.map +1 -0
  73. package/dist/esm/polyfill/RTCIceCandidate.mjs +128 -0
  74. package/dist/esm/polyfill/RTCIceCandidate.mjs.map +1 -0
  75. package/dist/esm/polyfill/RTCIceTransport.mjs +89 -0
  76. package/dist/esm/polyfill/RTCIceTransport.mjs.map +1 -0
  77. package/dist/esm/polyfill/RTCPeerConnection.mjs +430 -0
  78. package/dist/esm/polyfill/RTCPeerConnection.mjs.map +1 -0
  79. package/dist/esm/polyfill/RTCSctpTransport.mjs +55 -0
  80. package/dist/esm/polyfill/RTCSctpTransport.mjs.map +1 -0
  81. package/dist/esm/polyfill/RTCSessionDescription.mjs +41 -0
  82. package/dist/esm/polyfill/RTCSessionDescription.mjs.map +1 -0
  83. package/dist/esm/polyfill/index.mjs +27 -0
  84. package/dist/esm/polyfill/index.mjs.map +1 -0
  85. package/dist/types/lib/datachannel-stream.d.ts +24 -0
  86. package/dist/types/lib/index.d.ts +235 -0
  87. package/dist/types/lib/types.d.ts +118 -0
  88. package/dist/types/lib/websocket-server.d.ts +13 -0
  89. package/dist/types/lib/websocket.d.ts +25 -0
  90. package/dist/types/polyfill/Events.d.ts +15 -0
  91. package/dist/types/polyfill/RTCCertificate.d.ts +9 -0
  92. package/dist/types/polyfill/RTCDataChannel.d.ts +29 -0
  93. package/dist/types/polyfill/RTCDtlsTransport.d.ts +15 -0
  94. package/dist/types/polyfill/RTCError.d.ts +17 -0
  95. package/dist/types/polyfill/RTCIceCandidate.d.ts +21 -0
  96. package/dist/types/polyfill/RTCIceTransport.d.ts +30 -0
  97. package/dist/types/polyfill/RTCPeerConnection.d.ts +64 -0
  98. package/dist/types/polyfill/RTCSctpTransport.d.ts +15 -0
  99. package/dist/types/polyfill/RTCSessionDescription.d.ts +10 -0
  100. package/dist/types/polyfill/index.d.ts +26 -0
  101. package/jest.config.ts +14 -0
  102. package/package.json +121 -0
  103. package/rollup.config.mjs +72 -0
  104. package/src/cpp/data-channel-wrapper.cpp +530 -0
  105. package/src/cpp/data-channel-wrapper.h +63 -0
  106. package/src/cpp/ice-udp-mux-listener-wrapper.cpp +157 -0
  107. package/src/cpp/ice-udp-mux-listener-wrapper.h +43 -0
  108. package/src/cpp/main.cpp +58 -0
  109. package/src/cpp/media-audio-wrapper.cpp +457 -0
  110. package/src/cpp/media-audio-wrapper.h +52 -0
  111. package/src/cpp/media-av1packetization.cpp +24 -0
  112. package/src/cpp/media-av1packetization.h +11 -0
  113. package/src/cpp/media-av1rtppacketizer-wrapper.cpp +126 -0
  114. package/src/cpp/media-av1rtppacketizer-wrapper.h +29 -0
  115. package/src/cpp/media-direction.cpp +43 -0
  116. package/src/cpp/media-direction.h +10 -0
  117. package/src/cpp/media-h264rtppacketizer-wrapper.cpp +126 -0
  118. package/src/cpp/media-h264rtppacketizer-wrapper.h +30 -0
  119. package/src/cpp/media-h265rtppacketizer-wrapper.cpp +126 -0
  120. package/src/cpp/media-h265rtppacketizer-wrapper.h +30 -0
  121. package/src/cpp/media-h26xseparator.cpp +32 -0
  122. package/src/cpp/media-h26xseparator.h +11 -0
  123. package/src/cpp/media-mediahandler-helper.cpp +31 -0
  124. package/src/cpp/media-mediahandler-helper.h +11 -0
  125. package/src/cpp/media-pacinghandler-wrapper.cpp +79 -0
  126. package/src/cpp/media-pacinghandler-wrapper.h +28 -0
  127. package/src/cpp/media-rtcpnackresponder-wrapper.cpp +68 -0
  128. package/src/cpp/media-rtcpnackresponder-wrapper.h +28 -0
  129. package/src/cpp/media-rtcpreceivingsession-wrapper.cpp +57 -0
  130. package/src/cpp/media-rtcpreceivingsession-wrapper.h +28 -0
  131. package/src/cpp/media-rtcpsrreporter-wrapper.cpp +93 -0
  132. package/src/cpp/media-rtcpsrreporter-wrapper.h +30 -0
  133. package/src/cpp/media-rtppacketizationconfig-wrapper.cpp +167 -0
  134. package/src/cpp/media-rtppacketizationconfig-wrapper.h +35 -0
  135. package/src/cpp/media-rtppacketizer-wrapper.cpp +95 -0
  136. package/src/cpp/media-rtppacketizer-wrapper.h +30 -0
  137. package/src/cpp/media-track-wrapper.cpp +458 -0
  138. package/src/cpp/media-track-wrapper.h +61 -0
  139. package/src/cpp/media-video-wrapper.cpp +526 -0
  140. package/src/cpp/media-video-wrapper.h +56 -0
  141. package/src/cpp/peer-connection-wrapper.cpp +1298 -0
  142. package/src/cpp/peer-connection-wrapper.h +89 -0
  143. package/src/cpp/rtc-wrapper.cpp +205 -0
  144. package/src/cpp/rtc-wrapper.h +24 -0
  145. package/src/cpp/thread-safe-callback.cpp +57 -0
  146. package/src/cpp/thread-safe-callback.h +47 -0
  147. package/src/cpp/web-socket-server-wrapper.cpp +275 -0
  148. package/src/cpp/web-socket-server-wrapper.h +41 -0
  149. package/src/cpp/web-socket-wrapper.cpp +796 -0
  150. package/src/cpp/web-socket-wrapper.h +63 -0
  151. package/src/index.ts +9 -0
  152. package/src/lib/datachannel-stream.ts +100 -0
  153. package/src/lib/index.ts +283 -0
  154. package/src/lib/node-datachannel.ts +3 -0
  155. package/src/lib/types.ts +168 -0
  156. package/src/lib/websocket-server.ts +37 -0
  157. package/src/lib/websocket.ts +26 -0
  158. package/src/polyfill/Events.ts +82 -0
  159. package/src/polyfill/Exception.ts +37 -0
  160. package/src/polyfill/README.md +41 -0
  161. package/src/polyfill/RTCCertificate.ts +21 -0
  162. package/src/polyfill/RTCDataChannel.ts +225 -0
  163. package/src/polyfill/RTCDtlsTransport.ts +46 -0
  164. package/src/polyfill/RTCError.ts +78 -0
  165. package/src/polyfill/RTCIceCandidate.ts +128 -0
  166. package/src/polyfill/RTCIceTransport.ts +90 -0
  167. package/src/polyfill/RTCPeerConnection.ts +527 -0
  168. package/src/polyfill/RTCSctpTransport.ts +51 -0
  169. package/src/polyfill/RTCSessionDescription.ts +41 -0
  170. package/src/polyfill/index.ts +38 -0
  171. package/tsconfig.json +21 -0
@@ -0,0 +1,90 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ import RTCIceCandidate from './RTCIceCandidate';
3
+ import RTCPeerConnection from './RTCPeerConnection';
4
+
5
+ export default class RTCIceTransport extends EventTarget implements globalThis.RTCIceTransport {
6
+ #pc: RTCPeerConnection = null;
7
+
8
+ ongatheringstatechange: globalThis.RTCIceTransport['ongatheringstatechange'] = null;
9
+ onselectedcandidatepairchange: globalThis.RTCIceTransport['onselectedcandidatepairchange'] = null;
10
+ onstatechange: globalThis.RTCIceTransport['onstatechange'] = null;
11
+
12
+ constructor(init: { pc: RTCPeerConnection }) {
13
+ super();
14
+ this.#pc = init.pc;
15
+
16
+ this.#pc.addEventListener('icegatheringstatechange', () => {
17
+ const e = new Event('gatheringstatechange');
18
+ this.dispatchEvent(e);
19
+ this.ongatheringstatechange?.(e);
20
+ });
21
+ this.#pc.addEventListener('iceconnectionstatechange', () => {
22
+ const e = new Event('statechange');
23
+ this.dispatchEvent(e);
24
+ this.onstatechange?.(e);
25
+ });
26
+ }
27
+
28
+ get component(): globalThis.RTCIceComponent {
29
+ const cp = this.getSelectedCandidatePair();
30
+ if (!cp?.local) return null;
31
+ return cp.local.component;
32
+ }
33
+
34
+ get gatheringState(): globalThis.RTCIceGatheringState {
35
+ return this.#pc ? this.#pc.iceGatheringState : 'new';
36
+ }
37
+
38
+ get role(): globalThis.RTCIceRole {
39
+ return this.#pc.localDescription!.type == 'offer' ? 'controlling' : 'controlled';
40
+ }
41
+
42
+ get state(): globalThis.RTCIceTransportState {
43
+ return this.#pc ? this.#pc.iceConnectionState : 'new';
44
+ }
45
+
46
+ getLocalCandidates(): globalThis.RTCIceCandidate[] {
47
+ return this.#pc?.ext_localCandidates ?? [];
48
+ }
49
+
50
+ getLocalParameters(): RTCIceParameters | null {
51
+ return new RTCIceParameters(
52
+ new RTCIceCandidate({
53
+ candidate: this.#pc.selectedCandidatePair()!.local.candidate,
54
+ sdpMLineIndex: 0,
55
+ }),
56
+ );
57
+ }
58
+
59
+ getRemoteCandidates(): globalThis.RTCIceCandidate[] {
60
+ return this.#pc?.ext_remoteCandidates ?? [];
61
+ }
62
+
63
+ getRemoteParameters(): any {
64
+ /** */
65
+ }
66
+
67
+ getSelectedCandidatePair(): globalThis.RTCIceCandidatePair | null {
68
+ const cp = this.#pc?.selectedCandidatePair();
69
+ if (!cp) return null;
70
+ return {
71
+ local: new RTCIceCandidate({
72
+ candidate: cp.local.candidate,
73
+ sdpMid: cp.local.mid,
74
+ }),
75
+ remote: new RTCIceCandidate({
76
+ candidate: cp.remote.candidate,
77
+ sdpMid: cp.remote.mid,
78
+ }),
79
+ };
80
+ }
81
+ }
82
+
83
+ export class RTCIceParameters implements globalThis.RTCIceParameters {
84
+ usernameFragment = '';
85
+ password = '';
86
+ constructor({ usernameFragment, password = '' }) {
87
+ this.usernameFragment = usernameFragment;
88
+ this.password = password;
89
+ }
90
+ }
@@ -0,0 +1,527 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ import { DataChannelInitConfig, SelectedCandidateInfo } from '../lib/types';
3
+ import { PeerConnection } from '../lib/index';
4
+ import RTCSessionDescription from './RTCSessionDescription';
5
+ import RTCDataChannel from './RTCDataChannel';
6
+ import RTCIceCandidate from './RTCIceCandidate';
7
+ import { RTCDataChannelEvent, RTCPeerConnectionIceEvent } from './Events';
8
+ import RTCSctpTransport from './RTCSctpTransport';
9
+ import * as exceptions from './Exception';
10
+ import RTCCertificate from './RTCCertificate';
11
+
12
+ // extend RTCConfiguration with peerIdentity
13
+ interface RTCConfiguration extends globalThis.RTCConfiguration {
14
+ peerIdentity?: string;
15
+ peerConnection?: PeerConnection;
16
+ }
17
+
18
+ export default class RTCPeerConnection extends EventTarget implements globalThis.RTCPeerConnection {
19
+ static async generateCertificate(): Promise<RTCCertificate> {
20
+ throw new DOMException('Not implemented');
21
+ }
22
+
23
+ #peerConnection: PeerConnection;
24
+ #localOffer: ReturnType<typeof createDeferredPromise>;
25
+ #localAnswer: ReturnType<typeof createDeferredPromise>;
26
+ #dataChannels: Set<globalThis.RTCDataChannel>;
27
+ #dataChannelsClosed = 0;
28
+ #config: globalThis.RTCConfiguration;
29
+ #canTrickleIceCandidates: boolean | null = null;
30
+ #sctp: globalThis.RTCSctpTransport;
31
+ #announceNegotiation = false;
32
+
33
+ #localCandidates: globalThis.RTCIceCandidate[] = [];
34
+ #remoteCandidates: globalThis.RTCIceCandidate[] = [];
35
+
36
+ // events
37
+ onconnectionstatechange: globalThis.RTCPeerConnection['onconnectionstatechange'] = null;
38
+ // For ondatachannel we need to define type manually
39
+ ondatachannel: ((this: globalThis.RTCPeerConnection, ev: RTCDataChannelEvent) => any) | null;
40
+ onicecandidate: globalThis.RTCPeerConnection['onicecandidate'] = null;
41
+ onicecandidateerror: globalThis.RTCPeerConnection['onicecandidateerror'] = null;
42
+ oniceconnectionstatechange: globalThis.RTCPeerConnection['oniceconnectionstatechange'] = null;
43
+ onicegatheringstatechange: globalThis.RTCPeerConnection['onicegatheringstatechange'] = null;
44
+ onnegotiationneeded: globalThis.RTCPeerConnection['onnegotiationneeded'] = null;
45
+ onsignalingstatechange: globalThis.RTCPeerConnection['onsignalingstatechange'] = null;
46
+ ontrack: globalThis.RTCPeerConnection['ontrack'] = null;
47
+
48
+ private _checkConfiguration(config: globalThis.RTCConfiguration): void {
49
+ if (config && config.iceServers === undefined) config.iceServers = [];
50
+ if (config && config.iceTransportPolicy === undefined) config.iceTransportPolicy = 'all';
51
+
52
+ if (config?.iceServers === null) throw new TypeError('IceServers cannot be null');
53
+
54
+ // Check for all the properties of iceServers
55
+ if (Array.isArray(config?.iceServers)) {
56
+ for (let i = 0; i < config.iceServers.length; i++) {
57
+ if (config.iceServers[i] === null) throw new TypeError('IceServers cannot be null');
58
+ if (config.iceServers[i] === undefined)
59
+ throw new TypeError('IceServers cannot be undefined');
60
+ if (Object.keys(config.iceServers[i]).length === 0)
61
+ throw new TypeError('IceServers cannot be empty');
62
+
63
+ // If iceServers is string convert to array
64
+ if (typeof config.iceServers[i].urls === 'string')
65
+ config.iceServers[i].urls = [config.iceServers[i].urls as string];
66
+
67
+ // urls can not be empty
68
+ if ((config.iceServers[i].urls as string[])?.some((url) => url == ''))
69
+ throw new exceptions.SyntaxError('IceServers urls cannot be empty');
70
+
71
+ // urls should be valid URLs and match the protocols "stun:|turn:|turns:"
72
+ if (
73
+ (config.iceServers[i].urls as string[])?.some((url) => {
74
+ try {
75
+ const parsedURL = new URL(url);
76
+
77
+ return !/^(stun:|turn:|turns:)$/.test(parsedURL.protocol);
78
+ } catch (error) {
79
+ return true;
80
+ }
81
+ })
82
+ )
83
+ throw new exceptions.SyntaxError('IceServers urls wrong format');
84
+
85
+ // If this is a turn server check for username and credential
86
+ if ((config.iceServers[i].urls as string[])?.some((url) => url.startsWith('turn'))) {
87
+ if (!config.iceServers[i].username)
88
+ throw new exceptions.InvalidAccessError('IceServers username cannot be null');
89
+ if (!config.iceServers[i].credential)
90
+ throw new exceptions.InvalidAccessError('IceServers username cannot be undefined');
91
+ }
92
+
93
+ // length of urls can not be 0
94
+ if (config.iceServers[i].urls?.length === 0)
95
+ throw new exceptions.SyntaxError('IceServers urls cannot be empty');
96
+ }
97
+ }
98
+
99
+ if (
100
+ config &&
101
+ config.iceTransportPolicy &&
102
+ config.iceTransportPolicy !== 'all' &&
103
+ config.iceTransportPolicy !== 'relay'
104
+ )
105
+ throw new TypeError('IceTransportPolicy must be either "all" or "relay"');
106
+ }
107
+
108
+ setConfiguration(config: globalThis.RTCConfiguration): void {
109
+ this._checkConfiguration(config);
110
+ this.#config = config;
111
+ }
112
+
113
+ constructor(config: RTCConfiguration = { iceServers: [], iceTransportPolicy: 'all' }) {
114
+ super();
115
+
116
+ this._checkConfiguration(config);
117
+ this.#config = config;
118
+ this.#localOffer = createDeferredPromise();
119
+ this.#localAnswer = createDeferredPromise();
120
+ this.#dataChannels = new Set();
121
+ this.#canTrickleIceCandidates = null;
122
+
123
+ try {
124
+ const peerIdentity = (config as any)?.peerIdentity ?? `peer-${getRandomString(7)}`;
125
+ this.#peerConnection =
126
+ config?.peerConnection ??
127
+ new PeerConnection(peerIdentity, {
128
+ ...config,
129
+ iceServers:
130
+ config?.iceServers
131
+ ?.map((server) => {
132
+ const urls = Array.isArray(server.urls) ? server.urls : [server.urls];
133
+
134
+ return urls.map((url) => {
135
+ if (server.username && server.credential) {
136
+ const [protocol, rest] = url.split(/:(.*)/);
137
+ return `${protocol}:${server.username}:${server.credential}@${rest}`;
138
+ }
139
+ return url;
140
+ });
141
+ })
142
+ .flat() ?? [],
143
+ });
144
+ } catch (error) {
145
+ if (!error || !error.message) throw new exceptions.NotFoundError('Unknown error');
146
+ throw new exceptions.SyntaxError(error.message);
147
+ }
148
+
149
+ // forward peerConnection events
150
+ this.#peerConnection.onStateChange(() => {
151
+ this.dispatchEvent(new Event('connectionstatechange'));
152
+ });
153
+
154
+ this.#peerConnection.onIceStateChange(() => {
155
+ this.dispatchEvent(new Event('iceconnectionstatechange'));
156
+ });
157
+
158
+ this.#peerConnection.onSignalingStateChange(() => {
159
+ this.dispatchEvent(new Event('signalingstatechange'));
160
+ });
161
+
162
+ this.#peerConnection.onGatheringStateChange(() => {
163
+ this.dispatchEvent(new Event('icegatheringstatechange'));
164
+ });
165
+
166
+ this.#peerConnection.onDataChannel((channel) => {
167
+ const dc = new RTCDataChannel(channel);
168
+ this.#dataChannels.add(dc);
169
+ this.dispatchEvent(new RTCDataChannelEvent('datachannel', { channel: dc }));
170
+ });
171
+
172
+ this.#peerConnection.onLocalDescription((sdp, type) => {
173
+ if (type === 'offer') {
174
+ this.#localOffer.resolve(new RTCSessionDescription({ sdp, type }));
175
+ }
176
+
177
+ if (type === 'answer') {
178
+ this.#localAnswer.resolve(new RTCSessionDescription({ sdp, type }));
179
+ }
180
+ });
181
+
182
+ this.#peerConnection.onLocalCandidate((candidate, sdpMid) => {
183
+ if (sdpMid === 'unspec') {
184
+ this.#localAnswer.reject(new Error(`Invalid description type ${sdpMid}`));
185
+ return;
186
+ }
187
+
188
+ this.#localCandidates.push(new RTCIceCandidate({ candidate, sdpMid }));
189
+ this.dispatchEvent(new RTCPeerConnectionIceEvent(new RTCIceCandidate({ candidate, sdpMid })));
190
+ });
191
+
192
+ // forward events to properties
193
+ this.addEventListener('connectionstatechange', (e) => {
194
+ this.onconnectionstatechange?.(e);
195
+ });
196
+ this.addEventListener('signalingstatechange', (e) => {
197
+ this.onsignalingstatechange?.(e);
198
+ });
199
+ this.addEventListener('iceconnectionstatechange', (e) => {
200
+ this.oniceconnectionstatechange?.(e);
201
+ });
202
+ this.addEventListener('icegatheringstatechange', (e) => {
203
+ this.onicegatheringstatechange?.(e);
204
+ });
205
+ this.addEventListener('datachannel', (e) => {
206
+ this.ondatachannel?.(e as RTCDataChannelEvent);
207
+ });
208
+ this.addEventListener('icecandidate', (e) => {
209
+ this.onicecandidate?.(e as globalThis.RTCPeerConnectionIceEvent);
210
+ });
211
+ this.addEventListener('track', (e) => {
212
+ this.ontrack?.(e as RTCTrackEvent);
213
+ });
214
+ this.addEventListener('negotiationneeded', (e) => {
215
+ this.#announceNegotiation = true;
216
+ this.onnegotiationneeded?.(e);
217
+ });
218
+
219
+ this.#sctp = new RTCSctpTransport({
220
+ pc: this,
221
+ });
222
+ }
223
+
224
+ // Extra FUnctions
225
+ get ext_maxDataChannelId(): number {
226
+ return this.#peerConnection.maxDataChannelId();
227
+ }
228
+
229
+ get ext_maxMessageSize(): number {
230
+ return this.#peerConnection.maxMessageSize();
231
+ }
232
+
233
+ get ext_localCandidates(): globalThis.RTCIceCandidate[] {
234
+ return this.#localCandidates;
235
+ }
236
+
237
+ get ext_remoteCandidates(): globalThis.RTCIceCandidate[] {
238
+ return this.#remoteCandidates;
239
+ }
240
+
241
+ selectedCandidatePair(): {
242
+ local: SelectedCandidateInfo;
243
+ remote: SelectedCandidateInfo;
244
+ } | null {
245
+ return this.#peerConnection.getSelectedCandidatePair();
246
+ }
247
+
248
+ get canTrickleIceCandidates(): boolean | null {
249
+ return this.#canTrickleIceCandidates;
250
+ }
251
+
252
+ get connectionState(): globalThis.RTCPeerConnectionState {
253
+ return this.#peerConnection.state();
254
+ }
255
+
256
+ get iceConnectionState(): globalThis.RTCIceConnectionState {
257
+ let state = this.#peerConnection.iceState();
258
+ // libdatachannel uses 'completed' instead of 'connected'
259
+ // see /webrtc/getstats.html
260
+ if (state == 'completed') state = 'connected';
261
+ return state;
262
+ }
263
+
264
+ get iceGatheringState(): globalThis.RTCIceGatheringState {
265
+ return this.#peerConnection.gatheringState();
266
+ }
267
+
268
+ get currentLocalDescription(): globalThis.RTCSessionDescription {
269
+ return new RTCSessionDescription(this.#peerConnection.localDescription() as any);
270
+ }
271
+
272
+ get currentRemoteDescription(): globalThis.RTCSessionDescription {
273
+ return new RTCSessionDescription(this.#peerConnection.remoteDescription() as any);
274
+ }
275
+
276
+ get localDescription(): globalThis.RTCSessionDescription {
277
+ return new RTCSessionDescription(this.#peerConnection.localDescription() as any);
278
+ }
279
+
280
+ get pendingLocalDescription(): globalThis.RTCSessionDescription {
281
+ return new RTCSessionDescription(this.#peerConnection.localDescription() as any);
282
+ }
283
+
284
+ get pendingRemoteDescription(): globalThis.RTCSessionDescription {
285
+ return new RTCSessionDescription(this.#peerConnection.remoteDescription() as any);
286
+ }
287
+
288
+ get remoteDescription(): globalThis.RTCSessionDescription {
289
+ return new RTCSessionDescription(this.#peerConnection.remoteDescription() as any);
290
+ }
291
+
292
+ get sctp(): globalThis.RTCSctpTransport {
293
+ return this.#sctp;
294
+ }
295
+
296
+ get signalingState(): globalThis.RTCSignalingState {
297
+ return this.#peerConnection.signalingState();
298
+ }
299
+
300
+ async addIceCandidate(candidate?: globalThis.RTCIceCandidateInit | null): Promise<void> {
301
+ if (!candidate || !candidate.candidate) {
302
+ return;
303
+ }
304
+
305
+ if (candidate.sdpMid === null && candidate.sdpMLineIndex === null) {
306
+ throw new TypeError('sdpMid must be set');
307
+ }
308
+
309
+ if (candidate.sdpMid === undefined && candidate.sdpMLineIndex == undefined) {
310
+ throw new TypeError('sdpMid must be set');
311
+ }
312
+
313
+ // Reject if sdpMid format is not valid
314
+ // ??
315
+ if (candidate.sdpMid && candidate.sdpMid.length > 3) {
316
+ // console.log(candidate.sdpMid);
317
+ throw new exceptions.OperationError('Invalid sdpMid format');
318
+ }
319
+
320
+ // We don't care about sdpMLineIndex, just for test
321
+ if (!candidate.sdpMid && candidate.sdpMLineIndex > 1) {
322
+ throw new exceptions.OperationError('This is only for test case.');
323
+ }
324
+
325
+ try {
326
+ this.#peerConnection.addRemoteCandidate(candidate.candidate, candidate.sdpMid ?? '0');
327
+ this.#remoteCandidates.push(
328
+ new RTCIceCandidate({
329
+ candidate: candidate.candidate,
330
+ sdpMid: candidate.sdpMid ?? '0',
331
+ }),
332
+ );
333
+ } catch (error) {
334
+ if (!error || !error.message) throw new exceptions.NotFoundError('Unknown error');
335
+
336
+ // Check error Message if contains specific message
337
+ if (error.message.includes('remote candidate without remote description'))
338
+ throw new exceptions.InvalidStateError(error.message);
339
+ if (error.message.includes('Invalid candidate format'))
340
+ throw new exceptions.OperationError(error.message);
341
+
342
+ throw new exceptions.NotFoundError(error.message);
343
+ }
344
+ }
345
+
346
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
347
+ addTrack(_track, ..._streams): globalThis.RTCRtpSender {
348
+ throw new DOMException('Not implemented');
349
+ }
350
+
351
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
352
+ addTransceiver(_trackOrKind, _init): globalThis.RTCRtpTransceiver {
353
+ throw new DOMException('Not implemented');
354
+ }
355
+
356
+ close(): void {
357
+ this.#peerConnection.close();
358
+ }
359
+
360
+ createAnswer(): Promise<globalThis.RTCSessionDescriptionInit | any> {
361
+ return this.#localAnswer;
362
+ }
363
+
364
+ createDataChannel(label: string, opts: globalThis.RTCDataChannelInit = {}): RTCDataChannel {
365
+ const nativeOpts: DataChannelInitConfig = {
366
+ ...opts,
367
+ // libdatachannel uses "unordered", opposite of RTCDataChannelInit.ordered
368
+ unordered: opts.ordered === false ? true : false,
369
+ };
370
+
371
+ const channel = this.#peerConnection.createDataChannel(label, nativeOpts);
372
+ const dataChannel = new RTCDataChannel(channel, opts);
373
+
374
+ // ensure we can close all channels when shutting down
375
+ this.#dataChannels.add(dataChannel);
376
+ dataChannel.addEventListener('close', () => {
377
+ this.#dataChannels.delete(dataChannel);
378
+ this.#dataChannelsClosed++;
379
+ });
380
+
381
+ if (this.#announceNegotiation == null) {
382
+ this.#announceNegotiation = false;
383
+ this.dispatchEvent(new Event('negotiationneeded'));
384
+ }
385
+
386
+ return dataChannel;
387
+ }
388
+
389
+ createOffer(): Promise<globalThis.RTCSessionDescriptionInit | any> {
390
+ return this.#localOffer;
391
+ }
392
+
393
+ getConfiguration(): globalThis.RTCConfiguration {
394
+ return this.#config;
395
+ }
396
+
397
+ getReceivers(): globalThis.RTCRtpReceiver[] {
398
+ throw new DOMException('Not implemented');
399
+ }
400
+
401
+ getSenders(): globalThis.RTCRtpSender[] {
402
+ throw new DOMException('Not implemented');
403
+ }
404
+
405
+ getStats(): Promise<globalThis.RTCStatsReport> | any {
406
+ return new Promise((resolve) => {
407
+ const report = new Map();
408
+ const cp = this.#peerConnection?.getSelectedCandidatePair();
409
+ const bytesSent = this.#peerConnection?.bytesSent();
410
+ const bytesReceived = this.#peerConnection?.bytesReceived();
411
+ const rtt = this.#peerConnection?.rtt();
412
+
413
+ if (!cp) {
414
+ return resolve(report);
415
+ }
416
+
417
+ const localIdRs = getRandomString(8);
418
+ const localId = 'RTCIceCandidate_' + localIdRs;
419
+ report.set(localId, {
420
+ id: localId,
421
+ type: 'local-candidate',
422
+ timestamp: Date.now(),
423
+ candidateType: cp.local.type,
424
+ ip: cp.local.address,
425
+ port: cp.local.port,
426
+ });
427
+
428
+ const remoteIdRs = getRandomString(8);
429
+ const remoteId = 'RTCIceCandidate_' + remoteIdRs;
430
+ report.set(remoteId, {
431
+ id: remoteId,
432
+ type: 'remote-candidate',
433
+ timestamp: Date.now(),
434
+ candidateType: cp.remote.type,
435
+ ip: cp.remote.address,
436
+ port: cp.remote.port,
437
+ });
438
+
439
+ const candidateId = 'RTCIceCandidatePair_' + localIdRs + '_' + remoteIdRs;
440
+ report.set(candidateId, {
441
+ id: candidateId,
442
+ type: 'candidate-pair',
443
+ timestamp: Date.now(),
444
+ localCandidateId: localId,
445
+ remoteCandidateId: remoteId,
446
+ state: 'succeeded',
447
+ nominated: true,
448
+ writable: true,
449
+ bytesSent: bytesSent,
450
+ bytesReceived: bytesReceived,
451
+ totalRoundTripTime: rtt,
452
+ currentRoundTripTime: rtt,
453
+ });
454
+
455
+ const transportId = 'RTCTransport_0_1';
456
+ report.set(transportId, {
457
+ id: transportId,
458
+ timestamp: Date.now(),
459
+ type: 'transport',
460
+ bytesSent: bytesSent,
461
+ bytesReceived: bytesReceived,
462
+ dtlsState: 'connected',
463
+ selectedCandidatePairId: candidateId,
464
+ selectedCandidatePairChanges: 1,
465
+ });
466
+
467
+ // peer-connection'
468
+ report.set('P', {
469
+ id: 'P',
470
+ type: 'peer-connection',
471
+ timestamp: Date.now(),
472
+ dataChannelsOpened: this.#dataChannels.size,
473
+ dataChannelsClosed: this.#dataChannelsClosed,
474
+ });
475
+
476
+ return resolve(report);
477
+ });
478
+ }
479
+
480
+ getTransceivers(): globalThis.RTCRtpTransceiver[] {
481
+ return []; // throw new DOMException('Not implemented');
482
+ }
483
+
484
+ removeTrack(): void {
485
+ throw new DOMException('Not implemented');
486
+ }
487
+
488
+ restartIce(): Promise<void> {
489
+ throw new DOMException('Not implemented');
490
+ }
491
+
492
+ async setLocalDescription(description: globalThis.RTCSessionDescriptionInit): Promise<void> {
493
+ if (description?.type !== 'offer') {
494
+ // any other type causes libdatachannel to throw
495
+ return;
496
+ }
497
+
498
+ this.#peerConnection.setLocalDescription(description?.type as any);
499
+ }
500
+
501
+ async setRemoteDescription(description: globalThis.RTCSessionDescriptionInit): Promise<void> {
502
+ if (description.sdp == null) {
503
+ throw new DOMException('Remote SDP must be set');
504
+ }
505
+
506
+ this.#peerConnection.setRemoteDescription(description.sdp, description.type as any);
507
+ }
508
+ }
509
+
510
+ function createDeferredPromise(): any {
511
+ let resolve: any, reject: any;
512
+
513
+ const promise = new Promise(function (_resolve, _reject) {
514
+ resolve = _resolve;
515
+ reject = _reject;
516
+ });
517
+
518
+ (promise as any).resolve = resolve;
519
+ (promise as any).reject = reject;
520
+ return promise;
521
+ }
522
+
523
+ function getRandomString(length: number): string {
524
+ return Math.random()
525
+ .toString(36)
526
+ .substring(2, 2 + length);
527
+ }
@@ -0,0 +1,51 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ import RTCDtlsTransport from './RTCDtlsTransport';
3
+ import RTCPeerConnection from './RTCPeerConnection';
4
+
5
+ export default class RTCSctpTransport extends EventTarget implements globalThis.RTCSctpTransport {
6
+ #pc: RTCPeerConnection = null;
7
+ #transport: globalThis.RTCDtlsTransport = null;
8
+
9
+ onstatechange: globalThis.RTCSctpTransport['onstatechange'] = null;
10
+
11
+ constructor(initial: { pc: RTCPeerConnection }) {
12
+ super();
13
+ this.#pc = initial.pc;
14
+
15
+ this.#transport = new RTCDtlsTransport({
16
+ pc: initial.pc,
17
+ });
18
+
19
+ this.#pc.addEventListener('connectionstatechange', () => {
20
+ const e = new Event('statechange');
21
+ this.dispatchEvent(e);
22
+ this.onstatechange?.(e);
23
+ });
24
+ }
25
+
26
+ get maxChannels(): number | null {
27
+ if (this.state !== 'connected') return null;
28
+ return this.#pc.ext_maxDataChannelId;
29
+ }
30
+
31
+ get maxMessageSize(): number {
32
+ if (this.state !== 'connected') return null;
33
+ return this.#pc?.ext_maxMessageSize ?? 65536;
34
+ }
35
+
36
+ get state(): globalThis.RTCSctpTransportState {
37
+ // reduce state from new, connecting, connected, disconnected, failed, closed, unknown
38
+ // to RTCSctpTransport states connecting, connected, closed
39
+ let state = this.#pc.connectionState;
40
+ if (state === 'new' || state === 'connecting') {
41
+ state = 'connecting';
42
+ } else if (state === 'disconnected' || state === 'failed' || state === 'closed') {
43
+ state = 'closed';
44
+ }
45
+ return state;
46
+ }
47
+
48
+ get transport(): globalThis.RTCDtlsTransport {
49
+ return this.#transport;
50
+ }
51
+ }
@@ -0,0 +1,41 @@
1
+ // https://developer.mozilla.org/docs/Web/API/RTCSessionDescription
2
+ //
3
+ // Example usage
4
+ // const init = {
5
+ // type: 'offer',
6
+ // sdp: 'v=0\r\no=- 1234567890 1234567890 IN IP4 192.168.1.1\r\ns=-\r\nt=0 0\r\na=ice-ufrag:abcd\r\na=ice-pwd:efgh\r\n'
7
+ // };
8
+
9
+ export default class RTCSessionDescription implements globalThis.RTCSessionDescriptionInit {
10
+ #type: globalThis.RTCSdpType;
11
+ #sdp: string;
12
+
13
+ constructor(init: globalThis.RTCSessionDescriptionInit) {
14
+ this.#type = init?.type;
15
+ this.#sdp = init?.sdp ?? '';
16
+ }
17
+
18
+ get type(): globalThis.RTCSdpType {
19
+ return this.#type;
20
+ }
21
+
22
+ set type(type) {
23
+ if (type !== 'offer' && type !== 'answer' && type !== 'pranswer' && type !== 'rollback') {
24
+ throw new TypeError(
25
+ `Failed to set the 'type' property on 'RTCSessionDescription': The provided value '${type}' is not a valid enum value of type RTCSdpType.`,
26
+ );
27
+ }
28
+ this.#type = type;
29
+ }
30
+
31
+ get sdp(): string {
32
+ return this.#sdp;
33
+ }
34
+
35
+ toJSON(): globalThis.RTCSessionDescriptionInit {
36
+ return {
37
+ sdp: this.#sdp,
38
+ type: this.#type,
39
+ };
40
+ }
41
+ }