@walkhi/code-relax 0.1.0-beta.1

package/node_modules/node-datachannel/src/lib/types.ts

@@ -0,0 +1,169 @@
+export interface Channel {
+  close(): void;
+  sendMessage(msg: string): boolean;
+  sendMessageBinary(buffer: Uint8Array): boolean;
+  isOpen(): boolean;
+  bufferedAmount(): number;
+  maxMessageSize(): number;
+  setBufferedAmountLowThreshold(newSize: number): void;
+  onOpen(cb: () => void): void;
+  onClosed(cb: () => void): void;
+  onError(cb: (err: string) => void): void;
+  onBufferedAmountLow(cb: () => void): void;
+  onMessage(cb: (msg: string | Buffer | ArrayBuffer) => void): void;
+}
+
+export interface WebSocketServerConfiguration {
+  port?: number; // default 8080
+  enableTls?: boolean; // default = false;
+  certificatePemFile?: string;
+  keyPemFile?: string;
+  keyPemPass?: string;
+  bindAddress?: string;
+  connectionTimeout?: number; // milliseconds
+  maxMessageSize?: number;
+}
+
+// Enum in d.ts is tricky
+export type LogLevel = 'Verbose' | 'Debug' | 'Info' | 'Warning' | 'Error' | 'Fatal';
+
+// SCTP Settings
+export interface SctpSettings {
+  recvBufferSize?: number;
+  sendBufferSize?: number;
+  maxChunksOnQueue?: number;
+  initialCongestionWindow?: number;
+  congestionControlModule?: number;
+  delayedSackTime?: number;
+}
+
+// Proxy Server
+export type ProxyServerType = 'Socks5' | 'Http';
+export interface ProxyServer {
+  type: ProxyServerType;
+  ip: string;
+  port: number;
+  username?: string;
+  password?: string;
+}
+
+export type RelayType = 'TurnUdp' | 'TurnTcp' | 'TurnTls';
+
+export interface IceServer {
+  hostname: string;
+  port: number;
+  username?: string;
+  password?: string;
+  relayType?: RelayType;
+}
+
+export type TransportPolicy = 'all' | 'relay';
+
+export interface RtcConfig {
+  iceServers: (string | IceServer)[];
+  proxyServer?: ProxyServer;
+  bindAddress?: string;
+  enableIceTcp?: boolean;
+  enableIceUdpMux?: boolean;
+  disableAutoNegotiation?: boolean;
+  forceMediaTransport?: boolean;
+  portRangeBegin?: number;
+  portRangeEnd?: number;
+  maxMessageSize?: number;
+  mtu?: number;
+  iceTransportPolicy?: TransportPolicy;
+  disableFingerprintVerification?: boolean;
+  disableAutoGathering?: boolean;
+  certificatePemFile?: string;
+  keyPemFile?: string;
+  keyPemPass?: string;
+}
+
+// Lowercase to match the description type string from libdatachannel
+export type DescriptionType = 'unspec' | 'offer' | 'answer' | 'pranswer' | 'rollback';
+
+export type RTCSdpType = 'answer' | 'offer' | 'pranswer' | 'rollback';
+
+export type RTCIceTransportState =
+  | 'checking'
+  | 'closed'
+  | 'completed'
+  | 'connected'
+  | 'disconnected'
+  | 'failed'
+  | 'new';
+export type RTCPeerConnectionState =
+  | 'closed'
+  | 'connected'
+  | 'connecting'
+  | 'disconnected'
+  | 'failed'
+  | 'new';
+export type RTCIceConnectionState =
+  | 'checking'
+  | 'closed'
+  | 'completed'
+  | 'connected'
+  | 'disconnected'
+  | 'failed'
+  | 'new';
+export type RTCIceGathererState = 'complete' | 'gathering' | 'new';
+export type RTCIceGatheringState = 'complete' | 'gathering' | 'new';
+export type RTCSignalingState =
+  | 'closed'
+  | 'have-local-offer'
+  | 'have-local-pranswer'
+  | 'have-remote-offer'
+  | 'have-remote-pranswer'
+  | 'stable';
+
+export interface LocalDescriptionInit {
+  iceUfrag?: string;
+  icePwd?: string;
+}
+
+export interface DataChannelInitConfig {
+  protocol?: string;
+  negotiated?: boolean;
+  id?: number;
+  unordered?: boolean; // Reliability
+  maxPacketLifeTime?: number; // Reliability
+  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;
+  type: string;
+  transportType: string;
+  candidate: string;
+  mid: string;
+  priority: number;
+}
+
+// Must be same as rtc enum class Direction
+export type Direction = 'SendOnly' | 'RecvOnly' | 'SendRecv' | 'Inactive' | 'Unknown';
+
+export interface IceUdpMuxRequest {
+  ufrag: string;
+  localUfrag: string;
+  host: string;
+  port: number;
+}
+
+// Same as rtc::NalUnit::Separator
+export type NalUnitSeparator = 'Length' | 'ShortStartSequence' | 'LongStartSequence' | 'StartSequence';
+
+// Same as rtc::AV1RtpPacketizer::Packetization
+export type ObuPacketization = 'Obu' | 'TemporalUnit';

package/node_modules/node-datachannel/src/lib/websocket-server.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'events';
+import nodeDataChannel from './node-datachannel';
+import { WebSocketServerConfiguration } from './types';
+import { WebSocket } from './websocket';
+
+export class WebSocketServer extends EventEmitter {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  #server: any;
+  #clients: WebSocket[] = [];
+
+  constructor(options: WebSocketServerConfiguration) {
+    super();
+    this.#server = new nodeDataChannel.WebSocketServer(options);
+
+    this.#server.onClient((client) => {
+      this.emit('client', client);
+      this.#clients.push(client);
+    });
+  }
+
+  port(): number {
+    return this.#server?.port() || 0;
+  }
+
+  stop(): void {
+    this.#clients.forEach((client) => {
+      client?.close();
+    });
+    this.#server?.stop();
+    this.#server = null;
+    this.removeAllListeners();
+  }
+
+  onClient(cb: (clientSocket: WebSocket) => void): void {
+    if (this.#server) this.on('client', cb);
+  }
+}

package/node_modules/node-datachannel/src/lib/websocket.ts

@@ -0,0 +1,26 @@
+import nodeDataChannel from './node-datachannel';
+import { Channel, WebSocketServerConfiguration } from './types';
+
+export interface WebSocket extends Channel {
+  open(url: string): void;
+  forceClose(): void;
+  remoteAddress(): string | undefined;
+  path(): string | undefined;
+
+  // Channel implementation
+  close(): void;
+  sendMessage(msg: string): boolean;
+  sendMessageBinary(buffer: Uint8Array): boolean;
+  isOpen(): boolean;
+  bufferedAmount(): number;
+  maxMessageSize(): number;
+  setBufferedAmountLowThreshold(newSize: number): void;
+  onOpen(cb: () => void): void;
+  onClosed(cb: () => void): void;
+  onError(cb: (err: string) => void): void;
+  onBufferedAmountLow(cb: () => void): void;
+  onMessage(cb: (msg: string | Buffer) => void): void;
+}
+export const WebSocket: {
+  new (config?: WebSocketServerConfiguration): WebSocket;
+} = nodeDataChannel.WebSocket;

package/node_modules/node-datachannel/src/polyfill/Events.ts

@@ -0,0 +1,82 @@
+import RTCDataChannel from './RTCDataChannel';
+import RTCError from './RTCError';
+
+export class RTCPeerConnectionIceEvent
+  extends Event
+  implements globalThis.RTCPeerConnectionIceEvent
+{
+  #candidate: globalThis.RTCIceCandidate;
+
+  constructor(candidate: globalThis.RTCIceCandidate) {
+    super('icecandidate');
+
+    this.#candidate = candidate;
+  }
+
+  get candidate(): globalThis.RTCIceCandidate {
+    return this.#candidate;
+  }
+
+  get url(): string {
+    return '';
+  }
+}
+
+export class RTCDataChannelEvent extends Event implements globalThis.RTCDataChannelEvent {
+  #channel: RTCDataChannel;
+
+  constructor(type: string = 'datachannel', eventInitDict: globalThis.RTCDataChannelEventInit) {
+    super(type);
+
+    if (arguments.length === 0)
+      throw new TypeError(
+        `Failed to construct 'RTCDataChannelEvent': 2 arguments required, but only ${arguments.length} present.`,
+      );
+    if (typeof eventInitDict !== 'object')
+      throw new TypeError(
+        "Failed to construct 'RTCDataChannelEvent': The provided value is not of type 'RTCDataChannelEventInit'.",
+      );
+    if (!eventInitDict.channel)
+      throw new TypeError(
+        "Failed to construct 'RTCDataChannelEvent': Failed to read the 'channel' property from 'RTCDataChannelEventInit': Required member is undefined.",
+      );
+    if (eventInitDict.channel.constructor !== RTCDataChannel)
+      throw new TypeError(
+        "Failed to construct 'RTCDataChannelEvent': Failed to read the 'channel' property from 'RTCDataChannelEventInit': Failed to convert value to 'RTCDataChannel'.",
+      );
+
+    this.#channel = eventInitDict?.channel;
+  }
+
+  get channel(): RTCDataChannel {
+    return this.#channel;
+  }
+}
+
+export class RTCErrorEvent extends Event implements globalThis.RTCErrorEvent {
+  #error: RTCError;
+  constructor(type: string, init: globalThis.RTCErrorEventInit) {
+    if (arguments.length < 2)
+      throw new TypeError(
+        `Failed to construct 'RTCErrorEvent': 2 arguments required, but only ${arguments.length} present.`,
+      );
+    if (typeof init !== 'object')
+      throw new TypeError(
+        "Failed to construct 'RTCErrorEvent': The provided value is not of type 'RTCErrorEventInit'.",
+      );
+    if (!init.error)
+      throw new TypeError(
+        "Failed to construct 'RTCErrorEvent': Failed to read the 'error' property from 'RTCErrorEventInit': Required member is undefined.",
+      );
+    if (init.error.constructor !== RTCError)
+      throw new TypeError(
+        "Failed to construct 'RTCErrorEvent': Failed to read the 'error' property from 'RTCErrorEventInit': Failed to convert value to 'RTCError'.",
+      );
+    super(type || 'error');
+    this.#error = init.error;
+  }
+
+  get error(): RTCError {
+    return this.#error;
+  }
+}

package/node_modules/node-datachannel/src/polyfill/Exception.ts

@@ -0,0 +1,37 @@
+/// <reference lib="dom" />
+
+export class InvalidStateError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'InvalidStateError');
+  }
+}
+
+export class TypeError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'TypeError');
+  }
+}
+
+export class OperationError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'OperationError');
+  }
+}
+
+export class NotFoundError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'NotFoundError');
+  }
+}
+
+export class InvalidAccessError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'InvalidAccessError');
+  }
+}
+
+export class SyntaxError extends DOMException {
+  constructor(msg: string) {
+    super(msg, 'SyntaxError');
+  }
+}

package/node_modules/node-datachannel/src/polyfill/README.md

@@ -0,0 +1,41 @@
+# WebRTC Polyfills
+
+WebRTC polyfills to be used for libraries like `simple-peer`.
+
+# web-platform-tests
+
+Please check actual situation [here](/test/wpt-tests/)
+
+## Example Usage
+
+> For a native usage example please check test folder.
+
+`simple-peer` usage example
+
+```js
+import Peer from 'simple-peer';
+import nodeDatachannelPolyfill from 'node-datachannel/polyfill';
+
+var peer1 = new Peer({ initiator: true, wrtc: nodeDatachannelPolyfill });
+var peer2 = new Peer({ wrtc: nodeDatachannelPolyfill });
+
+peer1.on('signal', (data) => {
+  // when peer1 has signaling data, give it to peer2 somehow
+  peer2.signal(data);
+});
+
+peer2.on('signal', (data) => {
+  // when peer2 has signaling data, give it to peer1 somehow
+  peer1.signal(data);
+});
+
+peer1.on('connect', () => {
+  // wait for 'connect' event before using the data channel
+  peer1.send('hey peer2, how is it going?');
+});
+
+peer2.on('data', (data) => {
+  // got a data channel message
+  console.log('got a message from peer1: ' + data);
+});
+```

package/node_modules/node-datachannel/src/polyfill/RTCCertificate.ts

@@ -0,0 +1,21 @@
+export default class RTCCertificate implements globalThis.RTCCertificate {
+  #expires: number = 0;
+  #fingerprints: globalThis.RTCDtlsFingerprint[] = [];
+
+  constructor() {
+    this.#expires = null;
+    this.#fingerprints = [];
+  }
+
+  get expires(): number {
+    return this.#expires;
+  }
+
+  getFingerprints(): globalThis.RTCDtlsFingerprint[] {
+    return this.#fingerprints;
+  }
+
+  getAlgorithm(): string {
+    return '';
+  }
+}

package/node_modules/node-datachannel/src/polyfill/RTCDataChannel.ts

@@ -0,0 +1,225 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import * as exceptions from './Exception';
+import { DataChannel } from '../lib/index';
+import { RTCErrorEvent } from './Events';
+
+export default class RTCDataChannel extends EventTarget implements globalThis.RTCDataChannel {
+  #dataChannel: DataChannel;
+  #readyState: globalThis.RTCDataChannelState;
+  #bufferedAmountLowThreshold: number;
+  #binaryType: BinaryType;
+  #maxPacketLifeTime: number | null;
+  #maxRetransmits: number | null;
+  #negotiated: boolean;
+  #ordered: boolean;
+  #id: number;
+  #label: string;
+  #protocol: string;
+
+  #closeRequested = false;
+
+  // events
+  onbufferedamountlow: globalThis.RTCDataChannel['onbufferedamountlow'] = null;
+  onclose: globalThis.RTCDataChannel['onclose'] = null;
+  onclosing: globalThis.RTCDataChannel['onclosing'] = null;
+  onerror: globalThis.RTCDataChannel['onerror'] = null;
+  onmessage: globalThis.RTCDataChannel['onmessage'] = null;
+  onopen: globalThis.RTCDataChannel['onopen'] = null;
+
+  constructor(dataChannel: DataChannel, opts: globalThis.RTCDataChannelInit = {}) {
+    super();
+
+    this.#dataChannel = dataChannel;
+    this.#binaryType = 'arraybuffer';
+    this.#readyState = this.#dataChannel.isOpen() ? 'open' : 'connecting';
+    this.#bufferedAmountLowThreshold = 0;
+    this.#maxPacketLifeTime = opts.maxPacketLifeTime ?? null;
+    this.#maxRetransmits = opts.maxRetransmits ?? null;
+    this.#negotiated = opts.negotiated ?? false;
+    this.#ordered = opts.ordered ?? true;
+    this.#id = this.#dataChannel.getId();
+    this.#label = this.#dataChannel.getLabel();
+    this.#protocol = this.#dataChannel.getProtocol();
+
+    // forward dataChannel events
+    this.#dataChannel.onOpen(() => {
+      this.#readyState = 'open';
+      this.dispatchEvent(new Event('open', {}));
+    });
+
+    this.#dataChannel.onClosed(() => {
+      // Simulate closing event
+      if (!this.#closeRequested) {
+        this.#readyState = 'closing';
+        this.dispatchEvent(new Event('closing'));
+      }
+
+      setImmediate(() => {
+        this.#readyState = 'closed';
+        this.dispatchEvent(new Event('close'));
+      });
+    });
+
+    this.#dataChannel.onError((msg) => {
+      this.dispatchEvent(
+        new RTCErrorEvent('error', {
+          error: new RTCError(
+            {
+              errorDetail: 'data-channel-failure',
+            },
+            msg,
+          ),
+        }),
+      );
+    });
+
+    this.#dataChannel.onBufferedAmountLow(() => {
+      this.dispatchEvent(new Event('bufferedamountlow'));
+    });
+
+    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 }));
+    });
+
+    // forward events to properties
+    this.addEventListener('message', (e) => {
+      if (this.onmessage) this.onmessage(e as MessageEvent);
+    });
+    this.addEventListener('bufferedamountlow', (e) => {
+      if (this.onbufferedamountlow) this.onbufferedamountlow(e);
+    });
+    this.addEventListener('error', (e) => {
+      if (this.onerror) this.onerror(e as RTCErrorEvent);
+    });
+    this.addEventListener('close', (e) => {
+      if (this.onclose) this.onclose(e);
+    });
+    this.addEventListener('closing', (e) => {
+      if (this.onclosing) this.onclosing(e);
+    });
+    this.addEventListener('open', (e) => {
+      if (this.onopen) this.onopen(e);
+    });
+  }
+
+  set binaryType(type) {
+    if (type !== 'blob' && type !== 'arraybuffer') {
+      throw new DOMException(
+        "Failed to set the 'binaryType' property on 'RTCDataChannel': Unknown binary type : " +
+          type,
+        'TypeMismatchError',
+      );
+    }
+    this.#binaryType = type;
+  }
+
+  get binaryType(): BinaryType {
+    return this.#binaryType;
+  }
+
+  get bufferedAmount(): number {
+    return this.#dataChannel.bufferedAmount();
+  }
+
+  get bufferedAmountLowThreshold(): number {
+    return this.#bufferedAmountLowThreshold;
+  }
+
+  set bufferedAmountLowThreshold(value) {
+    const number = Number(value) || 0;
+    this.#bufferedAmountLowThreshold = number;
+    this.#dataChannel.setBufferedAmountLowThreshold(number);
+  }
+
+  get id(): number | null {
+    return this.#id;
+  }
+
+  get label(): string {
+    return this.#label;
+  }
+
+  get maxPacketLifeTime(): number | null {
+    return this.#maxPacketLifeTime;
+  }
+
+  get maxRetransmits(): number | null {
+    return this.#maxRetransmits;
+  }
+
+  get negotiated(): boolean {
+    return this.#negotiated;
+  }
+
+  get ordered(): boolean {
+    return this.#ordered;
+  }
+
+  get protocol(): string {
+    return this.#protocol;
+  }
+
+  get readyState(): globalThis.RTCDataChannelState {
+    return this.#readyState;
+  }
+
+  send(data): void {
+    if (this.#readyState !== 'open') {
+      throw new exceptions.InvalidStateError(
+        "Failed to execute 'send' on 'RTCDataChannel': RTCDataChannel.readyState is not 'open'",
+      );
+    }
+
+    // Needs network error, type error implemented
+    if (typeof data === 'string') {
+      this.#dataChannel.sendMessage(data);
+    } else if (data instanceof Blob) {
+      data.arrayBuffer().then((ab) => {
+        if (process?.versions?.bun) {
+          this.#dataChannel.sendMessageBinary(Buffer.from(ab));
+        } else {
+          this.#dataChannel.sendMessageBinary(new Uint8Array(ab));
+        }
+      });
+    } else if (data instanceof Uint8Array) {
+      this.#dataChannel.sendMessageBinary(data);
+    } else {
+      if (process?.versions?.bun) {
+        this.#dataChannel.sendMessageBinary(Buffer.from(data));
+      } else {
+        this.#dataChannel.sendMessageBinary(new Uint8Array(data));
+      }
+    }
+  }
+
+  close(): void {
+    this.#closeRequested = true;
+    setImmediate(() => {
+      this.#dataChannel.close();
+    });
+  }
+}

package/node_modules/node-datachannel/src/polyfill/RTCDtlsTransport.ts

@@ -0,0 +1,46 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import RTCIceTransport from './RTCIceTransport';
+import RTCPeerConnection from './RTCPeerConnection';
+
+export default class RTCDtlsTransport extends EventTarget implements globalThis.RTCDtlsTransport {
+  #pc: RTCPeerConnection = null;
+  #iceTransport = null;
+
+  onstatechange: globalThis.RTCDtlsTransport['onstatechange'] = null;
+  onerror: globalThis.RTCDtlsTransport['onstatechange'] = null;
+
+  constructor(init: { pc: RTCPeerConnection }) {
+    super();
+    this.#pc = init.pc;
+
+    this.#iceTransport = new RTCIceTransport({
+      pc: init.pc,
+    });
+
+    // forward peerConnection events
+    this.#pc.addEventListener('connectionstatechange', () => {
+      const e = new Event('statechange');
+      this.dispatchEvent(e);
+      this.onstatechange?.(e);
+    });
+  }
+
+  get iceTransport(): globalThis.RTCIceTransport {
+    return this.#iceTransport;
+  }
+
+  get state(): globalThis.RTCDtlsTransportState {
+    // reduce state from new, connecting, connected, disconnected, failed, closed, unknown
+    // to RTCDtlsTRansport states new, connecting, connected, closed, failed
+    let state = this.#pc ? this.#pc.connectionState : 'new';
+    if (state === 'disconnected') {
+      state = 'closed';
+    }
+    return state;
+  }
+
+  getRemoteCertificates(): ArrayBuffer[] {
+    // TODO: implement
+    return [new ArrayBuffer(0)];
+  }
+}