@vworlds/dgram-server 1.0.0

package/dgram-common/src/constants.d.ts

@@ -0,0 +1,18 @@
+declare const EVENTS: {
+    CONNECT: string;
+    CONNECTION: string;
+    DATA_CHANNEL_IS_OPEN: string;
+    DISCONNECTED: string;
+    ERROR: string;
+    MESSAGE: string;
+};
+declare const ERRORS: {
+    BROWSER_NOT_SUPPORTED: string;
+    COULD_NOT_PARSE_MESSAGE: string;
+    DROPPED_FROM_BUFFERING: string;
+    MAX_MESSAGE_SIZE_EXCEEDED: string;
+    PEER_CONNECTION_NOT_CREATED: string;
+    DATA_CHANNEL_NOT_CREATED: string;
+    CONNECTION_CLOSED: string;
+};
+export { EVENTS, ERRORS };

package/dgram-common/src/constants.js

@@ -0,0 +1,19 @@
+const EVENTS = {
+    CONNECT: 'connect',
+    CONNECTION: 'connection',
+    DATA_CHANNEL_IS_OPEN: 'dataChannelIsOpen',
+    DISCONNECTED: 'disconnected',
+    ERROR: 'error',
+    MESSAGE: 'rawMessage',
+};
+const ERRORS = {
+    BROWSER_NOT_SUPPORTED: 'BROWSER_NOT_SUPPORTED',
+    COULD_NOT_PARSE_MESSAGE: 'COULD_NOT_PARSE_MESSAGE',
+    DROPPED_FROM_BUFFERING: 'DROPPED_FROM_BUFFERING',
+    MAX_MESSAGE_SIZE_EXCEEDED: 'MAX_MESSAGE_SIZE_EXCEEDED',
+    PEER_CONNECTION_NOT_CREATED: 'PEER_CONNECTION_NOT_CREATED',
+    DATA_CHANNEL_NOT_CREATED: 'DATA_CHANNEL_NOT_CREATED',
+    CONNECTION_CLOSED: 'CONNECTION_CLOSED',
+};
+export { EVENTS, ERRORS };
+//# sourceMappingURL=constants.js.map

package/dgram-common/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../dgram-common/src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG;IACb,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,oBAAoB,EAAE,mBAAmB;IACzC,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,qBAAqB,EAAE,uBAAuB;IAC9C,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB,EAAE,2BAA2B;IACtD,2BAA2B,EAAE,6BAA6B;IAC1D,wBAAwB,EAAE,0BAA0B;IACpD,iBAAiB,EAAE,mBAAmB;CACvC,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/dgram-common/src/events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typed eventemitter3 wrapper used by dgram sockets and listener classes.
+ * Inspired by @yandeu/events: https://github.com/yandeu/events
+ */
+type ValidEventMap<T = any> = T extends {
+    [P in keyof T]: (...args: any[]) => void;
+} ? T : never;
+type Handler<T extends any | ((...args: any[]) => R), R = any> = T;
+export type EventListener<T extends ValidEventMap, K extends EventNames<T>> = T extends string | symbol ? (...args: any[]) => void : K extends keyof T ? Handler<T[K], void> : never;
+type EventArgs<T extends ValidEventMap, K extends EventNames<T>> = Parameters<EventListener<T, K>>;
+export type EventNames<T extends ValidEventMap> = T extends string | symbol ? T : keyof T;
+declare class events<EventMap extends ValidEventMap = any> {
+    on<T extends EventNames<EventMap>>(event: T, fn: EventListener<EventMap, T>, context?: any): events<EventMap>;
+    emit<T extends EventNames<EventMap>>(event: T, ...args: EventArgs<EventMap, T>): boolean;
+    once<T extends EventNames<EventMap>>(event: T, fn: EventListener<EventMap, T>, context?: any): events<EventMap>;
+    eventNames(): EventNames<EventMap>[];
+    listeners(event: EventNames<EventMap>): any[];
+    listenerCount(event: EventNames<EventMap>): any;
+    removeListener<T extends EventNames<EventMap>>(event: T, fn?: EventListener<EventMap, T>, context?: any, once?: boolean): this;
+    removeAllListeners(event?: EventNames<EventMap>): this;
+    off<T extends EventNames<EventMap>>(event: T, fn?: EventListener<EventMap, T> | undefined, context?: any, once?: boolean | undefined): events<EventMap>;
+    addListener<T extends EventNames<EventMap>>(event: T, fn: EventListener<EventMap, T>, context?: any): events<EventMap>;
+}
+export declare class Events<EventMap extends ValidEventMap = any> extends events<EventMap> {
+}
+export {};

package/dgram-common/src/events.js

@@ -0,0 +1,42 @@
+/**
+ * Typed eventemitter3 wrapper used by dgram sockets and listener classes.
+ * Inspired by @yandeu/events: https://github.com/yandeu/events
+ */
+import eventEmitter3 from 'eventemitter3';
+const { EventEmitter } = eventEmitter3;
+class events {
+    on(event, fn, context) {
+        return 0;
+    }
+    emit(event, ...args) {
+        return 0;
+    }
+    once(event, fn, context) {
+        return 0;
+    }
+    eventNames() {
+        return 0;
+    }
+    listeners(event) {
+        return 0;
+    }
+    listenerCount(event) {
+        return 0;
+    }
+    removeListener(event, fn, context, once) {
+        return 0;
+    }
+    removeAllListeners(event) {
+        return 0;
+    }
+    off(event, fn, context, once) {
+        return 0;
+    }
+    addListener(event, fn, context) {
+        return 0;
+    }
+}
+events = EventEmitter;
+export class Events extends events {
+}
+//# sourceMappingURL=events.js.map

package/dgram-common/src/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../dgram-common/src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,aAAa,MAAM,eAAe,CAAC;AAE1C,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC;AA2BvC,MAAM,MAAM;IACH,EAAE,CACP,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,IAAI,CACT,KAAQ,EACR,GAAG,IAA4B;QAE/B,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,IAAI,CACT,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,UAAU;QACf,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,SAAS,CAAC,KAA2B;QAC1C,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,aAAa,CAAC,KAA2B;QAC9C,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,cAAc,CACnB,KAAQ,EACR,EAA+B,EAC/B,OAAa,EACb,IAAc;QAEd,OAAO,CAAQ,CAAC;IAClB,CAAC;IAED,kBAAkB,CAAC,KAA4B;QAC7C,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,GAAG,CACR,KAAQ,EACR,EAA2C,EAC3C,OAAa,EACb,IAA0B;QAE1B,OAAO,CAAQ,CAAC;IAClB,CAAC;IAEM,WAAW,CAChB,KAAQ,EACR,EAA8B,EAC9B,OAAa;QAEb,OAAO,CAAQ,CAAC;IAClB,CAAC;CACF;AAEA,MAAc,GAAG,YAAY,CAAC;AAE/B,MAAM,OAAO,MAEX,SAAQ,MAAgB;CAAG"}

package/dgram-common/src/index.d.ts

@@ -0,0 +1,5 @@
+export { Socket } from './socket.js';
+export type { ConnectionError } from './socket.js';
+export { EVENTS, ERRORS } from './constants.js';
+export { Events } from './events.js';
+export type { EventListener, EventNames } from './events.js';

package/dgram-common/src/index.js

@@ -0,0 +1,4 @@
+export { Socket } from './socket.js';
+export { EVENTS, ERRORS } from './constants.js';
+export { Events } from './events.js';
+//# sourceMappingURL=index.js.map

package/dgram-common/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dgram-common/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dgram-common/src/socket.d.ts

@@ -0,0 +1,27 @@
+import { Events } from './events.js';
+/** Describes a connection failure reported through the socket `connect` event. */
+export interface ConnectionError extends Error {
+    /** Numeric status code for the failure. Browser support failures use `-1`. */
+    status: number;
+    /** Human-readable status text suitable for logs or UI. */
+    statusText: string;
+}
+/** Events emitted by dgram socket implementations. */
+interface SocketEvents {
+    /** Fired after the peer connection or data channel closes. */
+    disconnect: () => void;
+    /** Fired when binary payload data arrives from the remote peer. */
+    receive: (data: Uint8Array) => void;
+    /** Fired when the socket connects, or with an error when setup fails. */
+    connect: (err?: ConnectionError) => void;
+}
+/** Common socket-shaped interface implemented by browser and server dgram sockets. */
+export declare abstract class Socket extends Events<SocketEvents> {
+    /** Stable connection id assigned by the signaling server. */
+    abstract get id(): string;
+    /** Sends one binary datagram-like payload over the underlying WebRTC data channel. */
+    abstract send(data: Uint8Array): void;
+    /** Closes the underlying WebRTC connection and releases resources. */
+    abstract close(): void;
+}
+export {};

package/dgram-common/src/socket.js

@@ -0,0 +1,5 @@
+import { Events } from './events.js';
+/** Common socket-shaped interface implemented by browser and server dgram sockets. */
+export class Socket extends Events {
+}
+//# sourceMappingURL=socket.js.map

package/dgram-common/src/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../../dgram-common/src/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAoBrC,sFAAsF;AACtF,MAAM,OAAgB,MAAO,SAAQ,MAAoB;CAOxD"}

package/dgram-server/src/index.d.ts

@@ -0,0 +1,4 @@
+export { SocketListener } from './server/socket-listener.js';
+export { ReliabilityType } from './server/server-options.js';
+export type { ServerOptions } from './server/server-options.js';
+export { ServerSocket } from './server/server-socket.js';

package/dgram-server/src/index.js

@@ -0,0 +1,4 @@
+export { SocketListener } from './server/socket-listener.js';
+export { ReliabilityType } from './server/server-options.js';
+export { ServerSocket } from './server/server-socket.js';
+//# sourceMappingURL=index.js.map

package/dgram-server/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dgram-server/src/server/server-options.d.ts

@@ -0,0 +1,35 @@
+/** Reliability mode used when configuring the server-created data channel. */
+export declare enum ReliabilityType {
+    /** Retransmit dropped packets up to `maxRetransmits`. */
+    Rexmit = "rexmit",
+    /** Retry delivery for at most `maxPacketLifeTime` milliseconds. */
+    Timed = "timed"
+}
+/** Options used by `SocketListener` when creating WebRTC server peers. */
+export interface ServerOptions {
+    /** Base path for the HTTP signaling API. Defaults to `/rtc/v1`. */
+    apiBasePath?: string;
+    /** ICE/STUN/TURN servers shared with node-datachannel. */
+    iceServers?: RTCIceServer[];
+    /** ICE transport policy. Use `relay` to force TURN-only connectivity. */
+    iceTransportPolicy?: RTCIceTransportPolicy;
+    /** Data channel label expected by the client. Use `dgram` with `ClientSocket`. */
+    label: string;
+    /** Enables node-datachannel's UDP mux support when available. */
+    enableIceUdpMux?: boolean;
+    /** The maximum number of milliseconds that attempts to transfer a message may take in unreliable mode. While this value is a 16-bit unsigned number, each user agent may clamp it to whatever maximum it deems appropriate. Default: undefined. */
+    maxPacketLifeTime?: number;
+    /** options.maxRetransmits The maximum number of times the user agent should attempt to retransmit a message which fails the first time in unreliable mode. While this value is a16-bit unsigned number, each user agent may clamp it to whatever maximum it deems appropriate. Default: 0. */
+    maxRetransmits?: number;
+    /** Indicates whether or not messages sent on the RTCDataChannel are required to arrive at their destination. Default: false. */
+    reliabilityType?: ReliabilityType;
+    /** Indicates whether or not messages sent on the RTCDataChannel are required to arrive at their destination in the same order in which they were sent (true), or if they're allowed to arrive out-of-order (false). Default: false. */
+    ordered?: boolean;
+    /** Set a custom port range for the WebRTC connection. */
+    portRange?: {
+        /** Minimum port range (defaults to 0) */
+        min: number;
+        /** Minimum port range (defaults to 65535) */
+        max: number;
+    };
+}

package/dgram-server/src/server/server-options.js

@@ -0,0 +1,9 @@
+/** Reliability mode used when configuring the server-created data channel. */
+export var ReliabilityType;
+(function (ReliabilityType) {
+    /** Retransmit dropped packets up to `maxRetransmits`. */
+    ReliabilityType["Rexmit"] = "rexmit";
+    /** Retry delivery for at most `maxPacketLifeTime` milliseconds. */
+    ReliabilityType["Timed"] = "timed";
+})(ReliabilityType || (ReliabilityType = {}));
+//# sourceMappingURL=server-options.js.map

package/dgram-server/src/server/server-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-options.js","sourceRoot":"","sources":["../../../../src/server/server-options.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,yDAAyD;IACzD,oCAAiB,CAAA;IACjB,mEAAmE;IACnE,kCAAe,CAAA;AACjB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B"}

package/dgram-server/src/server/server-socket.d.ts

@@ -0,0 +1,18 @@
+import WebRTCConnection from '../webrtc/datachannel/webrtc-connection.js';
+import { Socket } from '../../../dgram-common/src/index.js';
+/** Server-side dgram socket for one connected WebRTC client. */
+export declare class ServerSocket extends Socket {
+    connection: WebRTCConnection;
+    /**
+     * Wraps a low-level server WebRTC connection in the common socket API.
+     *
+     * @param connection Active server-side WebRTC connection.
+     */
+    constructor(connection: WebRTCConnection);
+    /** Connection id assigned by the server connection manager. */
+    get id(): string;
+    /** Sends one binary payload to the connected browser peer. */
+    send(data: Uint8Array): void;
+    /** Closes the server-side data channel and peer connection. */
+    close(): void;
+}

package/dgram-server/src/server/server-socket.js

@@ -0,0 +1,36 @@
+import { EVENTS, Socket, } from '../../../dgram-common/src/index.js';
+/** Server-side dgram socket for one connected WebRTC client. */
+export class ServerSocket extends Socket {
+    connection;
+    /**
+     * Wraps a low-level server WebRTC connection in the common socket API.
+     *
+     * @param connection Active server-side WebRTC connection.
+     */
+    constructor(connection) {
+        super();
+        this.connection = connection;
+        this.connection.on(EVENTS.DATA_CHANNEL_IS_OPEN, (err) => {
+            this.emit('connect', err);
+        });
+        this.connection.on(EVENTS.MESSAGE, (data) => {
+            this.emit('receive', data);
+        });
+        this.connection.on(EVENTS.DISCONNECTED, () => {
+            this.emit('disconnect');
+        });
+    }
+    /** Connection id assigned by the server connection manager. */
+    get id() {
+        return this.connection.id;
+    }
+    /** Sends one binary payload to the connected browser peer. */
+    send(data) {
+        this.connection.sendMessage(data);
+    }
+    /** Closes the server-side data channel and peer connection. */
+    close() {
+        this.connection.close();
+    }
+}
+//# sourceMappingURL=server-socket.js.map

package/dgram-server/src/server/server-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-socket.js","sourceRoot":"","sources":["../../../../src/server/server-socket.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,MAAM,EACN,MAAM,GACP,MAAM,oCAAoC,CAAC;AAE5C,gEAAgE;AAChE,MAAM,OAAO,YAAa,SAAQ,MAAM;IAMnB;IALnB;;;;OAIG;IACH,YAAmB,UAA4B;QAC7C,KAAK,EAAE,CAAC;QADS,eAAU,GAAV,UAAU,CAAkB;QAG7C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,GAAoB,EAAE,EAAE;YACvE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAgB,EAAE,EAAE;YACtD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;IAC5B,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,IAAgB;QACnB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,+DAA+D;IAC/D,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dgram-server/src/server/socket-listener.d.ts

@@ -0,0 +1,24 @@
+import { Events, Socket } from '../../../dgram-common/src/index.js';
+import express from 'express';
+import { ServerOptions } from './server-options.js';
+/** Events emitted by `SocketListener`. */
+interface SocketListenerEvents {
+    /** Fired after a new peer's data channel opens and is ready to send/receive. */
+    new: (s: Socket) => void;
+}
+/** Installs dgram signaling routes on an Express app and emits connected sockets. */
+export declare class SocketListener extends Events<SocketListenerEvents> {
+    options: ServerOptions;
+    /** HTTP signaling route installer. */
+    private apiServer;
+    /** Creates and tracks server-side WebRTC connections. */
+    private connectionsManager;
+    /**
+     * Creates a listener and mounts signaling routes on the provided Express app.
+     *
+     * @param app Express app that should host the signaling API.
+     * @param options WebRTC and signaling options for every new connection.
+     */
+    constructor(app: express.Application, options: ServerOptions);
+}
+export {};

package/dgram-server/src/server/socket-listener.js

@@ -0,0 +1,32 @@
+import { EVENTS, Events } from '../../../dgram-common/src/index.js';
+import ConnectionsManager from '../webrtc/datachannel/connections-manager.js';
+import HttpServer from '../webrtc/http/http-server.js';
+import { ServerSocket } from './server-socket.js';
+/** Installs dgram signaling routes on an Express app and emits connected sockets. */
+export class SocketListener extends Events {
+    options;
+    /** HTTP signaling route installer. */
+    apiServer;
+    /** Creates and tracks server-side WebRTC connections. */
+    connectionsManager;
+    /**
+     * Creates a listener and mounts signaling routes on the provided Express app.
+     *
+     * @param app Express app that should host the signaling API.
+     * @param options WebRTC and signaling options for every new connection.
+     */
+    constructor(app, options) {
+        super();
+        this.options = options;
+        this.connectionsManager = new ConnectionsManager(options);
+        this.apiServer = new HttpServer(app, this.connectionsManager, this.options);
+        this.apiServer.setupRoutes();
+        this.connectionsManager.on(EVENTS.CONNECTION, (conn) => {
+            const ss = new ServerSocket(conn);
+            ss.on('connect', () => {
+                this.emit('new', ss);
+            });
+        });
+    }
+}
+//# sourceMappingURL=socket-listener.js.map

package/dgram-server/src/server/socket-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-listener.js","sourceRoot":"","sources":["../../../../src/server/socket-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAU,MAAM,oCAAoC,CAAC;AAE5E,OAAO,kBAAkB,MAAM,8CAA8C,CAAC;AAE9E,OAAO,UAAU,MAAM,+BAA+B,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,qFAAqF;AACrF,MAAM,OAAO,cAAe,SAAQ,MAA4B;IAcrD;IAbT,sCAAsC;IAC9B,SAAS,CAAa;IAC9B,yDAAyD;IACjD,kBAAkB,CAAqB;IAE/C;;;;;OAKG;IACH,YACE,GAAwB,EACjB,OAAsB;QAE7B,KAAK,EAAE,CAAC;QAFD,YAAO,GAAP,OAAO,CAAe;QAG7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAE7B,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,IAAsB,EAAE,EAAE;YACvE,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACpB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dgram-server/src/webrtc/datachannel/connections-manager.d.ts

@@ -0,0 +1,19 @@
+import { type ServerOptions } from '../../server/server-options.js';
+import WebRTCConnection from './webrtc-connection.js';
+import { EventEmitter } from 'events';
+/** Creates, stores, and deletes server-side WebRTC connections. */
+export default class ConnectionsManager extends EventEmitter {
+    options: ServerOptions;
+    /** Active server-side WebRTC connections keyed by connection id. */
+    private connections;
+    /** @param options WebRTC and data channel settings applied to new connections. */
+    constructor(options: ServerOptions);
+    /** Creates a random connection id used by signaling routes. */
+    private createId;
+    /** Looks up an active server connection by id. */
+    getConnection(id: string): WebRTCConnection | undefined;
+    /** Creates a server peer, data channel, and offer for a browser client. */
+    createConnection(): Promise<WebRTCConnection | undefined>;
+    /** Closes and removes a server connection. */
+    deleteConnection(connection: WebRTCConnection): Promise<void>;
+}

package/dgram-server/src/webrtc/datachannel/connections-manager.js

@@ -0,0 +1,94 @@
+import { ReliabilityType, } from '../../server/server-options.js';
+import WebRTCConnection from './webrtc-connection.js';
+import { EventEmitter } from 'events';
+import { EVENTS } from '../../../../dgram-common/src/index.js';
+/** Creates, stores, and deletes server-side WebRTC connections. */
+export default class ConnectionsManager extends EventEmitter {
+    options;
+    /** Active server-side WebRTC connections keyed by connection id. */
+    connections = new Map();
+    /** @param options WebRTC and data channel settings applied to new connections. */
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    /** Creates a random connection id used by signaling routes. */
+    createId() {
+        const possible = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        let id = '';
+        for (let i = 0; i < 24; i++) {
+            id += possible.charAt(Math.floor(Math.random() * possible.length));
+        }
+        return id;
+    }
+    /** Looks up an active server connection by id. */
+    getConnection(id) {
+        return this.connections.get(id);
+    }
+    /** Creates a server peer, data channel, and offer for a browser client. */
+    async createConnection() {
+        return new Promise(async (resolve, reject) => {
+            const { ordered = false, reliabilityType = ReliabilityType.Rexmit, enableIceUdpMux, label = 'dgram', iceServers = [], portRange, iceTransportPolicy = 'all', maxPacketLifeTime = undefined, maxRetransmits = 2, } = this.options;
+            const dcConfig = {
+                ordered,
+            };
+            if (reliabilityType === ReliabilityType.Timed &&
+                maxPacketLifeTime !== undefined) {
+                dcConfig.maxPacketLifeTime = maxPacketLifeTime;
+            }
+            else if (maxRetransmits !== undefined) {
+                dcConfig.maxRetransmits = maxRetransmits;
+            }
+            // WebRTC connection config
+            let rtcConfig = {
+                iceTransportPolicy: iceTransportPolicy,
+                iceServers: iceServers.map((ice) => ice.urls),
+            };
+            if (enableIceUdpMux !== undefined) {
+                rtcConfig.enableIceUdpMux = enableIceUdpMux;
+            }
+            // portRange is a nonstandard API
+            if (portRange?.min && portRange?.max) {
+                rtcConfig = {
+                    ...rtcConfig,
+                    portRangeBegin: portRange.min,
+                    portRangeEnd: portRange.max,
+                };
+            }
+            const newId = this.createId();
+            const connection = new WebRTCConnection(newId, rtcConfig, this.connections);
+            const pc = await connection.init();
+            if (!pc) {
+                reject(undefined);
+            }
+            this.connections.set(connection.id, connection);
+            pc.onDataChannel((dc) => {
+                // do nothing
+            });
+            pc.onStateChange(async (state) => {
+                if (state === 'disconnected' ||
+                    state === 'failed' ||
+                    state === 'closed') {
+                    await this.deleteConnection(connection);
+                }
+                connection.setState(state);
+            });
+            pc.onGatheringStateChange((state) => { });
+            pc.onLocalDescription((sdp, type) => {
+                connection.localDescription = { sdp, type };
+                resolve(connection);
+            });
+            pc.onLocalCandidate((candidate, mid) => {
+                // @ts-ignore
+                connection.iceCandidates.push({ candidate, sdpMid: mid });
+            });
+            await connection.setupDataChannel(label, dcConfig);
+            this.emit(EVENTS.CONNECTION, connection);
+        });
+    }
+    /** Closes and removes a server connection. */
+    async deleteConnection(connection) {
+        await connection.close();
+    }
+}
+//# sourceMappingURL=connections-manager.js.map

package/dgram-server/src/webrtc/datachannel/connections-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections-manager.js","sourceRoot":"","sources":["../../../../../src/webrtc/datachannel/connections-manager.ts"],"names":[],"mappings":"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"}

package/dgram-server/src/webrtc/datachannel/webrtc-connection.d.ts

@@ -0,0 +1,46 @@
+import { EventEmitter } from 'events';
+import { PeerConnection } from 'node-datachannel';
+import type { DataChannel, DataChannelInitConfig, RtcConfig } from 'node-datachannel';
+/** SDP offer generated by node-datachannel for the browser peer. */
+export interface LocalDescription {
+    /** Session description protocol body. */
+    sdp: string;
+    /** SDP description type, usually `offer`. */
+    type: string;
+}
+/** Low-level server-side WebRTC peer and data channel wrapper. */
+export default class WebRTCConnection extends EventEmitter {
+    id: string;
+    config: RtcConfig;
+    connections: Map<string, WebRTCConnection>;
+    /** Last observed peer connection state. */
+    state: string;
+    /** node-datachannel peer connection for this client. */
+    peerConnection: PeerConnection | undefined;
+    /** Server-created data channel used for binary messages. */
+    dataChannel: DataChannel | undefined;
+    /** Current local SDP description sent to the browser during signaling. */
+    localDescription: LocalDescription;
+    /** ICE candidates gathered since the browser last polled the signaling API. */
+    iceCandidates: RTCIceCandidate[];
+    /**
+     * Creates a low-level server WebRTC connection wrapper.
+     *
+     * @param id Connection id assigned by `ConnectionsManager`.
+     * @param config node-datachannel peer connection configuration.
+     * @param connections Shared connection map used for self-removal on close.
+     */
+    constructor(id: string, config: RtcConfig, connections: Map<string, WebRTCConnection>);
+    /** Records a peer state change and emits the matching dgram lifecycle event. */
+    setState(state: string): void;
+    /** Creates the underlying node-datachannel peer connection. */
+    init(): Promise<PeerConnection>;
+    /** Creates or returns the server data channel and attaches message/open handlers. */
+    setupDataChannel(label: string, config: DataChannelInitConfig): Promise<DataChannel>;
+    /** Sends one binary payload to the browser peer. */
+    sendMessage(data: any): Promise<void>;
+    /** Returns true when node-datachannel has buffered outbound data. */
+    isBuffering(): boolean;
+    /** Closes the data channel, peer connection, and removes this connection from the map. */
+    close(): Promise<void>;
+}

package/dgram-server/src/webrtc/datachannel/webrtc-connection.js

@@ -0,0 +1,111 @@
+import { EventEmitter } from 'events';
+import { PeerConnection } from 'node-datachannel';
+import { EVENTS, ERRORS } from '../../../../dgram-common/src/index.js';
+/** Low-level server-side WebRTC peer and data channel wrapper. */
+export default class WebRTCConnection extends EventEmitter {
+    id;
+    config;
+    connections;
+    /** Last observed peer connection state. */
+    state;
+    /** node-datachannel peer connection for this client. */
+    peerConnection;
+    /** Server-created data channel used for binary messages. */
+    dataChannel;
+    /** Current local SDP description sent to the browser during signaling. */
+    localDescription;
+    /** ICE candidates gathered since the browser last polled the signaling API. */
+    iceCandidates = [];
+    /**
+     * Creates a low-level server WebRTC connection wrapper.
+     *
+     * @param id Connection id assigned by `ConnectionsManager`.
+     * @param config node-datachannel peer connection configuration.
+     * @param connections Shared connection map used for self-removal on close.
+     */
+    constructor(id, config, connections) {
+        super();
+        this.id = id;
+        this.config = config;
+        this.connections = connections;
+        this.state = '';
+        this.localDescription = { sdp: '', type: '' };
+    }
+    /** Records a peer state change and emits the matching dgram lifecycle event. */
+    setState(state) {
+        if (this.state === state) {
+            return;
+        }
+        this.state = state;
+        if (state === 'open') {
+            this.emit(EVENTS.CONNECT);
+        }
+        else if (state === 'failed') {
+            this.emit(EVENTS.ERROR);
+        }
+        else if (state === 'closed') {
+            this.emit(EVENTS.DISCONNECTED);
+        }
+    }
+    /** Creates the underlying node-datachannel peer connection. */
+    async init() {
+        this.peerConnection = new PeerConnection(this.id, this.config);
+        return this.peerConnection;
+    }
+    /** Creates or returns the server data channel and attaches message/open handlers. */
+    async setupDataChannel(label, config) {
+        if (!this.peerConnection) {
+            throw new Error(ERRORS.PEER_CONNECTION_NOT_CREATED);
+        }
+        if (this.dataChannel) {
+            return this.dataChannel;
+        }
+        this.dataChannel = this.peerConnection.createDataChannel(label, config);
+        this.dataChannel.onOpen(() => {
+            this.dataChannel?.onMessage((msg) => {
+                this.emit(EVENTS.MESSAGE, msg);
+            });
+            this.emit(EVENTS.DATA_CHANNEL_IS_OPEN);
+        });
+        return this.dataChannel;
+    }
+    /** Sends one binary payload to the browser peer. */
+    async sendMessage(data) {
+        if (!this.dataChannel) {
+            throw new Error(ERRORS.DATA_CHANNEL_NOT_CREATED);
+        }
+        if (this.dataChannel.isOpen()) {
+            try {
+                this.dataChannel.sendMessageBinary(data);
+            }
+            catch (error) {
+                console.log(error);
+            }
+        }
+        else {
+            throw new Error(ERRORS.CONNECTION_CLOSED);
+        }
+    }
+    /** Returns true when node-datachannel has buffered outbound data. */
+    isBuffering() {
+        if (this.dataChannel) {
+            return this.dataChannel.bufferedAmount() > 0;
+        }
+        return false;
+    }
+    /** Closes the data channel, peer connection, and removes this connection from the map. */
+    async close() {
+        if (this.dataChannel?.isOpen()) {
+            this.dataChannel.close();
+            this.dataChannel = undefined;
+        }
+        if (this.peerConnection) {
+            this.peerConnection.close();
+            this.peerConnection = undefined;
+        }
+        if (this.connections.has(this.id)) {
+            this.connections.delete(this.id);
+        }
+    }
+}
+//# sourceMappingURL=webrtc-connection.js.map

package/dgram-server/src/webrtc/datachannel/webrtc-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc-connection.js","sourceRoot":"","sources":["../../../../../src/webrtc/datachannel/webrtc-connection.ts"],"names":[],"mappings":"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"}

package/dgram-server/src/webrtc/http/helpers.d.ts

@@ -0,0 +1,5 @@
+import express from 'express';
+/** Sends a plain text HTTP response with the provided status code. */
+export declare function sendStatus(res: express.Response, code: number, msg: string): void;
+/** Sends an object as a JSON HTTP 200 response. */
+export declare function sendJson(res: express.Response, obj: object): void;

package/dgram-server/src/webrtc/http/helpers.js

@@ -0,0 +1,13 @@
+/** Sends a plain text HTTP response with the provided status code. */
+export function sendStatus(res, code, msg) {
+    res.status(code);
+    res.setHeader('Content-Type', 'text/plain');
+    res.end(msg);
+}
+/** Sends an object as a JSON HTTP 200 response. */
+export function sendJson(res, obj) {
+    res.status(200);
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(obj));
+}
+//# sourceMappingURL=helpers.js.map

package/dgram-server/src/webrtc/http/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/webrtc/http/helpers.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,GAAqB,EAAE,IAAY,EAAE,GAAW;IACzE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,QAAQ,CAAC,GAAqB,EAAE,GAAW;IACzD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dgram-server/src/webrtc/http/http-server.d.ts

@@ -0,0 +1,20 @@
+import express from 'express';
+import { ServerOptions } from '../../server/server-options.js';
+import ConnectionsManager from '../datachannel/connections-manager.js';
+/** Mounts the HTTP signaling routes needed by the browser client. */
+export default class HttpServer {
+    app: express.Application;
+    connectionsManager: ConnectionsManager;
+    /** URL prefix where signaling routes are installed. */
+    private apiBasePath;
+    /**
+     * Creates a signaling route installer.
+     *
+     * @param app Express app to receive signaling routes.
+     * @param connectionsManager Connection manager used by route handlers.
+     * @param options Server options containing the optional API base path.
+     */
+    constructor(app: express.Application, connectionsManager: ConnectionsManager, options: ServerOptions);
+    /** Registers connection, answer, candidate, and close routes on the Express app. */
+    setupRoutes(): void;
+}

package/dgram-server/src/webrtc/http/http-server.js

@@ -0,0 +1,30 @@
+import { closeConnection, createConnection, getIceCandidates, setRemoteDesc, } from './routes.js';
+/** Default URL prefix used by the dgram signaling API. */
+const DEFAULT_API_BASE_PATH = '/rtc/v1';
+/** Mounts the HTTP signaling routes needed by the browser client. */
+export default class HttpServer {
+    app;
+    connectionsManager;
+    /** URL prefix where signaling routes are installed. */
+    apiBasePath;
+    /**
+     * Creates a signaling route installer.
+     *
+     * @param app Express app to receive signaling routes.
+     * @param connectionsManager Connection manager used by route handlers.
+     * @param options Server options containing the optional API base path.
+     */
+    constructor(app, connectionsManager, options) {
+        this.app = app;
+        this.connectionsManager = connectionsManager;
+        this.apiBasePath = options.apiBasePath || DEFAULT_API_BASE_PATH;
+    }
+    /** Registers connection, answer, candidate, and close routes on the Express app. */
+    setupRoutes() {
+        this.app.post(`${this.apiBasePath}/connection`, createConnection.bind(null, this.connectionsManager));
+        this.app.post(`${this.apiBasePath}/connection/:id/remote-desc`, setRemoteDesc.bind(null, this.connectionsManager));
+        this.app.get(`${this.apiBasePath}/connection/:id/candidates`, getIceCandidates.bind(null, this.connectionsManager));
+        this.app.post(`${this.apiBasePath}/connection/:id/close`, closeConnection.bind(null, this.connectionsManager));
+    }
+}
+//# sourceMappingURL=http-server.js.map

package/dgram-server/src/webrtc/http/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../../../../src/webrtc/http/http-server.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,0DAA0D;AAC1D,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAExC,qEAAqE;AACrE,MAAM,CAAC,OAAO,OAAO,UAAU;IAYpB;IACA;IAZT,uDAAuD;IAC/C,WAAW,CAAC;IAEpB;;;;;;OAMG;IACH,YACS,GAAwB,EACxB,kBAAsC,EAC7C,OAAsB;QAFf,QAAG,GAAH,GAAG,CAAqB;QACxB,uBAAkB,GAAlB,kBAAkB,CAAoB;QAG7C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IAClE,CAAC;IAED,oFAAoF;IAC7E,WAAW;QAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,WAAW,aAAa,EAChC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,CACrD,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,WAAW,6BAA6B,EAChD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAClD,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,GAAG,CACV,GAAG,IAAI,CAAC,WAAW,4BAA4B,EAC/C,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,CACrD,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,WAAW,uBAAuB,EAC1C,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,CACpD,CAAC;IACJ,CAAC;CACF"}

package/dgram-server/src/webrtc/http/routes.d.ts

@@ -0,0 +1,10 @@
+import express from 'express';
+import ConnectionsManager from '../datachannel/connections-manager.js';
+/** Creates a server WebRTC peer and returns its id plus local SDP offer. */
+export declare function createConnection(connectionMgr: ConnectionsManager, req: express.Request, res: express.Response): Promise<void>;
+/** Stores the browser SDP answer on an existing server peer. */
+export declare function setRemoteDesc(connectionMgr: ConnectionsManager, req: express.Request, res: express.Response): void;
+/** Closes an existing server peer connection. */
+export declare function closeConnection(connectionMgr: ConnectionsManager, req: express.Request, res: express.Response): void;
+/** Returns pending server ICE candidates and clears the candidate queue. */
+export declare function getIceCandidates(connectionMgr: ConnectionsManager, req: express.Request, res: express.Response): void;

package/dgram-server/src/webrtc/http/routes.js

@@ -0,0 +1,78 @@
+import { sendJson, sendStatus } from './helpers.js';
+/** Creates a server WebRTC peer and returns its id plus local SDP offer. */
+export async function createConnection(connectionMgr, req, res) {
+    const conn = await connectionMgr.createConnection();
+    if (!conn) {
+        sendStatus(res, 500, 'There was a problem creating the datachannel connection');
+        return;
+    }
+    sendJson(res, {
+        id: conn.id,
+        localDescription: conn.localDescription,
+    });
+}
+/** Stores the browser SDP answer on an existing server peer. */
+export function setRemoteDesc(connectionMgr, req, res) {
+    const connId = req.params.id;
+    if (!connId) {
+        sendStatus(res, 400, 'Connection id is empty');
+        return;
+    }
+    try {
+        const conn = connectionMgr.getConnection(connId);
+        if (!conn || !conn.peerConnection) {
+            sendStatus(res, 404, 'Connection not found');
+            return;
+        }
+        conn.peerConnection.setRemoteDescription(req.body.sdp, req.body.type);
+        sendStatus(res, 200, '');
+    }
+    catch (err) {
+        console.log(err);
+        sendStatus(res, 500, '');
+    }
+}
+/** Closes an existing server peer connection. */
+export function closeConnection(connectionMgr, req, res) {
+    const connId = req.params.id;
+    if (!connId) {
+        sendStatus(res, 400, 'Connection id is empty');
+        return;
+    }
+    try {
+        const conn = connectionMgr.getConnection(connId);
+        if (!conn || !conn.peerConnection) {
+            sendStatus(res, 404, 'Connection not found');
+            return;
+        }
+        conn.peerConnection.close();
+        sendStatus(res, 200, '');
+    }
+    catch (err) {
+        console.log(err);
+        sendStatus(res, 500, '');
+    }
+}
+/** Returns pending server ICE candidates and clears the candidate queue. */
+export function getIceCandidates(connectionMgr, req, res) {
+    const connId = req.params.id;
+    if (!connId) {
+        sendStatus(res, 400, 'Connection id is empty');
+        return;
+    }
+    try {
+        const conn = connectionMgr.getConnection(connId);
+        if (!conn || !conn.peerConnection) {
+            sendStatus(res, 404, 'Connection not found');
+            return;
+        }
+        const iceCandidates = [...conn.iceCandidates];
+        conn.iceCandidates = [];
+        sendJson(res, iceCandidates);
+    }
+    catch (err) {
+        console.log(err);
+        sendStatus(res, 500, '');
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dgram-server/src/webrtc/http/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../../../src/webrtc/http/routes.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@vworlds/dgram-server",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dgram-server/src/index.js",
+  "types": "./dgram-server/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dgram-server/src/index.d.ts",
+      "default": "./dgram-server/src/index.js"
+    }
+  },
+  "dependencies": {
+    "eventemitter3": "^4.0.7",
+    "express": "^4.18.2",
+    "node-datachannel": "^0.32.3"
+  },
+  "license": "UNLICENSED"
+}