node-datachannel 0.28.0 → 0.30.0

package/src/cpp/web-socket-wrapper.h

@@ -1,9 +1,6 @@
 #ifndef WEB_SOCKET_WRAPPER_H
 #define WEB_SOCKET_WRAPPER_H
 
-#include <iostream>
-#include <string>
-#include <variant>
 #include <memory>
 #include <unordered_set>
 

package/src/lib/index.ts

@@ -16,6 +16,7 @@ import {
   SelectedCandidateInfo,
 } from './types';
 import { WebSocket } from './websocket';
+import type { CertificateFingerprint, IceUdpMuxRequest, LocalDescriptionInit } from './types';
 
 export function preload(): void {
   nodeDataChannel.preload();
@@ -136,10 +137,11 @@ export const DataChannel: {
 
 export interface PeerConnection {
   close(): void;
-  setLocalDescription(type?: DescriptionType): void;
+  setLocalDescription(type?: DescriptionType, init?: LocalDescriptionInit): void;
   setRemoteDescription(sdp: string, type: DescriptionType): void;
   localDescription(): { type: DescriptionType; sdp: string } | null;
   remoteDescription(): { type: DescriptionType; sdp: string } | null;
+  remoteFingerprint(): CertificateFingerprint;
   addRemoteCandidate(candidate: string, mid: string): void;
   createDataChannel(label: string, config?: DataChannelInitConfig): DataChannel;
   addTrack(media: Video | Audio): Track;
@@ -170,6 +172,16 @@ export const PeerConnection: {
   new (peerName: string, config: RtcConfig): PeerConnection;
 } = nodeDataChannel.PeerConnection;
 
+export interface IceUdpMuxListener {
+  address?: string;
+  port: number;
+  stop(): void;
+  onUnhandledStunRequest(cb: (req: IceUdpMuxRequest) => void): void;
+}
+export const IceUdpMuxListener: {
+  new (port: number, address?: string): IceUdpMuxListener;
+} = nodeDataChannel.IceUdpMuxListener;
+
 export interface RtcpReceivingSession {}
 
 export const RtcpReceivingSession: {
@@ -196,6 +208,7 @@ export default {
   WebSocket,
   WebSocketServer,
   DataChannelStream,
+  IceUdpMuxListener,
 };
 
 // Types

package/src/lib/types.ts

@@ -73,6 +73,10 @@ export interface RtcConfig {
   mtu?: number;
   iceTransportPolicy?: TransportPolicy;
   disableFingerprintVerification?: boolean;
+  disableAutoGathering?: boolean;
+  certificatePemFile?: string;
+  keyPemFile?: string;
+  keyPemPass?: string;
 }
 
 // Lowercase to match the description type string from libdatachannel
@@ -113,6 +117,11 @@ export type RTCSignalingState =
   | 'have-remote-pranswer'
   | 'stable';
 
+export interface LocalDescriptionInit {
+  iceUfrag?: string;
+  icePwd?: string;
+}
+
 export interface DataChannelInitConfig {
   protocol?: string;
   negotiated?: boolean;
@@ -122,6 +131,17 @@ export interface DataChannelInitConfig {
   maxRetransmits?: number; // Reliability
 }
 
+export interface CertificateFingerprint {
+  /**
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/RTCCertificate/getFingerprints#value
+   */
+  value: string;
+  /**
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/RTCCertificate/getFingerprints#algorithm
+   */
+  algorithm: 'sha-1' | 'sha-224' | 'sha-256' | 'sha-384' | 'sha-512' | 'md5' | 'md2';
+}
+
 export interface SelectedCandidateInfo {
   address: string;
   port: number;
@@ -134,3 +154,9 @@ export interface SelectedCandidateInfo {
 
 // Must be same as rtc enum class Direction
 export type Direction = 'SendOnly' | 'RecvOnly' | 'SendRecv' | 'Inactive' | 'Unknown';
+
+export interface IceUdpMuxRequest {
+  ufrag: string;
+  host: string;
+  port: number;
+}

package/src/polyfill/Events.ts

@@ -1,7 +1,10 @@
 import RTCDataChannel from './RTCDataChannel';
 import RTCError from './RTCError';
 
-export class RTCPeerConnectionIceEvent extends Event implements globalThis.RTCPeerConnectionIceEvent {
+export class RTCPeerConnectionIceEvent
+  extends Event
+  implements globalThis.RTCPeerConnectionIceEvent
+{
   #candidate: globalThis.RTCIceCandidate;
 
   constructor(candidate: globalThis.RTCIceCandidate) {

package/src/polyfill/RTCDataChannel.ts

@@ -30,7 +30,7 @@ export default class RTCDataChannel extends EventTarget implements globalThis.RT
     super();
 
     this.#dataChannel = dataChannel;
-    this.#binaryType = 'blob';
+    this.#binaryType = 'arraybuffer';
     this.#readyState = this.#dataChannel.isOpen() ? 'open' : 'connecting';
     this.#bufferedAmountLowThreshold = 0;
     this.#maxPacketLifeTime = opts.maxPacketLifeTime ?? null;
@@ -77,10 +77,29 @@ export default class RTCDataChannel extends EventTarget implements globalThis.RT
       this.dispatchEvent(new Event('bufferedamountlow'));
     });
 
-    this.#dataChannel.onMessage((data) => {
-      if (ArrayBuffer.isView(data)) {
-        if (this.binaryType == 'arraybuffer') data = data.buffer;
-        else data = Buffer.from(data.buffer);
+    this.#dataChannel.onMessage((message) => {
+      if (typeof message === 'string') {
+        this.dispatchEvent(new MessageEvent('message', { data: message }));
+        return;
+      }
+
+      let data: Blob | ArrayBuffer;
+
+      if (message instanceof ArrayBuffer) {
+        data = message;
+      } else {
+        data = message.buffer;
+
+        if (message.byteOffset !== 0 || message.byteLength !== message.buffer.byteLength) {
+          // message is view on underlying buffer, must create new
+          // ArrayBuffer that only contains message data
+          data = new ArrayBuffer(message.byteLength);
+          new Uint8Array(data, 0, message.byteLength).set(message);
+        }
+      }
+
+      if (this.#binaryType === 'blob') {
+        data = new Blob([data]);
       }
 
       this.dispatchEvent(new MessageEvent('message', { data }));

package/src/polyfill/RTCDtlsTransport.ts

@@ -14,7 +14,7 @@ export default class RTCDtlsTransport extends EventTarget implements globalThis.
     this.#pc = init.pc;
 
     this.#iceTransport = new RTCIceTransport({
-      pc: init.pc
+      pc: init.pc,
     });
 
     // forward peerConnection events

package/src/polyfill/RTCPeerConnection.ts

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import { SelectedCandidateInfo } from '../lib/types';
+import { DataChannelInitConfig, SelectedCandidateInfo } from '../lib/types';
 import { PeerConnection } from '../lib/index';
 import RTCSessionDescription from './RTCSessionDescription';
 import RTCDataChannel from './RTCDataChannel';
@@ -36,7 +36,7 @@ export default class RTCPeerConnection extends EventTarget implements globalThis
   // events
   onconnectionstatechange: globalThis.RTCPeerConnection['onconnectionstatechange'] = null;
   // For ondatachannel we need to define type manually
-  ondatachannel: ((this: globalThis.RTCPeerConnection, ev: RTCDataChannelEvent) => any) | null;
+  ondatachannel: ((this: globalThis.RTCPeerConnection, ev: globalThis.RTCDataChannelEvent) => any) | null;
   onicecandidate: globalThis.RTCPeerConnection['onicecandidate'] = null;
   onicecandidateerror: globalThis.RTCPeerConnection['onicecandidateerror'] = null;
   oniceconnectionstatechange: globalThis.RTCPeerConnection['oniceconnectionstatechange'] = null;
@@ -362,7 +362,13 @@ export default class RTCPeerConnection extends EventTarget implements globalThis
   }
 
   createDataChannel(label: string, opts: globalThis.RTCDataChannelInit = {}): RTCDataChannel {
-    const channel = this.#peerConnection.createDataChannel(label, opts);
+    const nativeOpts: DataChannelInitConfig = {
+      ...opts,
+      // libdatachannel uses "unordered", opposite of RTCDataChannelInit.ordered
+      unordered: opts.ordered === false ? true : false,
+    };
+
+    const channel = this.#peerConnection.createDataChannel(label, nativeOpts);
     const dataChannel = new RTCDataChannel(channel, opts);
 
     // ensure we can close all channels when shutting down

package/src/polyfill/RTCSctpTransport.ts

@@ -13,7 +13,7 @@ export default class RTCSctpTransport extends EventTarget implements globalThis.
     this.#pc = initial.pc;
 
     this.#transport = new RTCDtlsTransport({
-      pc: initial.pc
+      pc: initial.pc,
     });
 
     this.#pc.addEventListener('connectionstatechange', () => {
@@ -30,7 +30,7 @@ export default class RTCSctpTransport extends EventTarget implements globalThis.
 
   get maxMessageSize(): number {
     if (this.state !== 'connected') return null;
-    return this.#pc?.ext_maxMessageSize ?? 65536;;
+    return this.#pc?.ext_maxMessageSize ?? 65536;
   }
 
   get state(): globalThis.RTCSctpTransportState {