@vworlds/dgram-client 1.0.0

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

@@ -0,0 +1,21 @@
+import { Socket } from '../../../dgram-common/src/index.js';
+/** Browser-side dgram socket that exposes a small socket-like API over WebRTC. */
+export declare class ClientSocket extends Socket {
+    /** Low-level WebRTC/signaling connection used by this socket. */
+    private client;
+    /**
+     * Creates a browser dgram socket.
+     *
+     * @param url Signaling API base URL, for example `http://localhost:3000/rtc/v1`.
+     * @param rtcConfig Browser `RTCPeerConnection` configuration, usually ICE servers.
+     */
+    constructor(url: string, rtcConfig: RTCConfiguration);
+    /** Connection id assigned by the signaling server after `connect()` succeeds. */
+    get id(): string;
+    /** Opens signaling, receives the server offer, sends an answer, and waits for the data channel. */
+    connect(): Promise<void>;
+    /** Sends one binary payload over the open data channel. */
+    send(data: Uint8Array): void;
+    /** Closes the browser peer connection and asks the signaling server to close its side. */
+    close(): void;
+}

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

@@ -0,0 +1,61 @@
+import { WebRTCClientConnection } from '../webrtc/webrtc-client-connection.js';
+import { EVENTS, Socket, } from '../../../dgram-common/src/index.js';
+/** Browser-side dgram socket that exposes a small socket-like API over WebRTC. */
+export class ClientSocket extends Socket {
+    /** Low-level WebRTC/signaling connection used by this socket. */
+    client;
+    /**
+     * Creates a browser dgram socket.
+     *
+     * @param url Signaling API base URL, for example `http://localhost:3000/rtc/v1`.
+     * @param rtcConfig Browser `RTCPeerConnection` configuration, usually ICE servers.
+     */
+    constructor(url, rtcConfig) {
+        super();
+        this.client = new WebRTCClientConnection(url, 'dgram', rtcConfig);
+        this.client.on(EVENTS.DISCONNECTED, (reason) => {
+            this.emit('disconnect');
+            this.client.removeAllListeners();
+        });
+        this.client.on(EVENTS.CONNECTION, (status) => {
+            this.emit('connect', status);
+        });
+        this.client.on(EVENTS.MESSAGE, (data) => {
+            let bytes;
+            if (data instanceof ArrayBuffer) {
+                bytes = new Uint8Array(data);
+            }
+            else if (data instanceof Uint8Array) {
+                bytes = data;
+            }
+            else {
+                console.log('Invalid data type');
+                return;
+            }
+            this.emit('receive', bytes);
+        });
+    }
+    /** Connection id assigned by the signaling server after `connect()` succeeds. */
+    get id() {
+        return this.client.id;
+    }
+    /** Opens signaling, receives the server offer, sends an answer, and waits for the data channel. */
+    async connect() {
+        await this.client.connect();
+        this.client.localPeerConnection.onconnectionstatechange = () => {
+            if (this.client.localPeerConnection.connectionState === 'disconnected' ||
+                this.client.localPeerConnection.connectionState === 'closed') {
+                this.client.emit(EVENTS.DISCONNECTED);
+            }
+        };
+    }
+    /** Sends one binary payload over the open data channel. */
+    send(data) {
+        this.client.sendMessage(data);
+    }
+    /** Closes the browser peer connection and asks the signaling server to close its side. */
+    close() {
+        this.client.close();
+    }
+}
+//# sourceMappingURL=client-socket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-socket.js","sourceRoot":"","sources":["../../../../src/client/client-socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EACL,MAAM,EACN,MAAM,GAEP,MAAM,oCAAoC,CAAC;AAE5C,kFAAkF;AAClF,MAAM,OAAO,YAAa,SAAQ,MAAM;IACtC,iEAAiE;IACzD,MAAM,CAAyB;IAEvC;;;;;OAKG;IACH,YAAY,GAAW,EAAE,SAA2B;QAClD,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAElE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,MAAW,EAAE,EAAE;YAClD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,MAAuB,EAAE,EAAE;YAC5D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAA8B,EAAE,EAAE;YAChE,IAAI,KAAiB,CAAC;YACtB,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;gBAChC,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;gBACtC,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IACjF,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,mGAAmG;IAC5F,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,uBAAuB,GAAG,GAAG,EAAE;YAC7D,IACE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,eAAe,KAAK,cAAc;gBAClE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,eAAe,KAAK,QAAQ,EAC5D,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,2DAA2D;IACpD,IAAI,CAAC,IAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,0FAA0F;IACnF,KAAK;QACV,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+import { ClientSocket } from './client/client-socket.js';
+export default ClientSocket;
+export { ClientSocket };

package/dgram-client/src/index.js

@@ -0,0 +1,8 @@
+// import DgramServer from "./server/dgram-server.js";
+// import { ServerOptions } from "./server/server-options.js";
+// export default DgramServer;
+// export { DgramServer, ServerOptions };
+import { ClientSocket } from './client/client-socket.js';
+export default ClientSocket;
+export { ClientSocket };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,8DAA8D;AAE9D,8BAA8B;AAC9B,yCAAyC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,eAAe,YAAY,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dgram-client/src/webrtc/webrtc-client-connection.d.ts

@@ -0,0 +1,52 @@
+import { Events } from '../../../dgram-common/src/index.js';
+/** Response returned by the server when creating a WebRTC connection. */
+interface RTCRemotePeerConnection {
+    /** Server-side connection id used by later signaling calls. */
+    id: string;
+    /** Server-created offer that the browser uses as its remote description. */
+    localDescription: {
+        /** Session description protocol body. */
+        sdp: string;
+        /** SDP description type, usually `offer`. */
+        type: string;
+    };
+}
+/** Handles browser WebRTC signaling and data channel lifecycle for `ClientSocket`. */
+export declare class WebRTCClientConnection extends Events {
+    serverUrl: string;
+    label: string;
+    rtcConfiguration: RTCConfiguration;
+    /** Server-assigned connection id. Empty until `connect()` creates a server peer. */
+    id: string;
+    /** Browser `RTCPeerConnection` used for the active session. */
+    localPeerConnection: RTCPeerConnection;
+    /** Server peer metadata and offer returned by the signaling API. */
+    remotePeerConnection: RTCRemotePeerConnection;
+    /** Browser data channel created by the server and delivered through `datachannel`. */
+    dataChannel: RTCDataChannel;
+    /**
+     * Creates the low-level browser connection wrapper.
+     *
+     * @param serverUrl Signaling API base URL.
+     * @param label Expected WebRTC data channel label.
+     * @param rtcConfiguration Browser peer connection configuration.
+     */
+    constructor(serverUrl: string, label: string, rtcConfiguration: RTCConfiguration);
+    /** Accepts the server-created data channel and wires message/open/close handlers. */
+    private onDataChannel;
+    /** Fetches newly gathered server ICE candidates and adds them to the browser peer. */
+    private fetchAdditionalCandidates;
+    /** Resolves after the server-created data channel event arrives. */
+    private waitForDataChannel;
+    /** Performs HTTP signaling and prepares the browser peer connection. */
+    connect(): Promise<{
+        error: any;
+    } | undefined>;
+    /** Sends one payload over the browser data channel when it is open. */
+    sendMessage(data: any): Promise<void>;
+    /** Returns true when the browser data channel still has buffered bytes to flush. */
+    isBuffering(): boolean;
+    /** Closes the browser peer connection and notifies the signaling server. */
+    close(): void;
+}
+export {};

package/dgram-client/src/webrtc/webrtc-client-connection.js

@@ -0,0 +1,200 @@
+import { ERRORS, EVENTS, Events } from '../../../dgram-common/src/index.js';
+/** Handles browser WebRTC signaling and data channel lifecycle for `ClientSocket`. */
+export class WebRTCClientConnection extends Events {
+    serverUrl;
+    label;
+    rtcConfiguration;
+    /** Server-assigned connection id. Empty until `connect()` creates a server peer. */
+    id;
+    /** Browser `RTCPeerConnection` used for the active session. */
+    localPeerConnection;
+    /** Server peer metadata and offer returned by the signaling API. */
+    remotePeerConnection;
+    /** Browser data channel created by the server and delivered through `datachannel`. */
+    dataChannel;
+    /**
+     * Creates the low-level browser connection wrapper.
+     *
+     * @param serverUrl Signaling API base URL.
+     * @param label Expected WebRTC data channel label.
+     * @param rtcConfiguration Browser peer connection configuration.
+     */
+    constructor(serverUrl, label, rtcConfiguration) {
+        super();
+        this.serverUrl = serverUrl;
+        this.label = label;
+        this.rtcConfiguration = rtcConfiguration;
+        this.id = '';
+    }
+    /** Accepts the server-created data channel and wires message/open/close handlers. */
+    onDataChannel(ev) {
+        const { channel } = ev;
+        if (channel.label !== this.label) {
+            return;
+        }
+        this.dataChannel = channel;
+        // set default binaryType to arraybuffer
+        // https://github.com/node-webrtc/node-webrtc/issues/441
+        this.dataChannel.binaryType = 'arraybuffer';
+        this.dataChannel.onmessage = (ev) => {
+            this.emit(EVENTS.MESSAGE, ev.data);
+        };
+        this.dataChannel.onopen = () => {
+            this.emit(EVENTS.CONNECTION);
+        };
+        this.dataChannel.onclose = () => {
+            this.emit(EVENTS.DISCONNECTED);
+        };
+        if (this.dataChannel.readyState === 'open') {
+            this.emit(EVENTS.CONNECTION);
+        }
+    }
+    /** Fetches newly gathered server ICE candidates and adds them to the browser peer. */
+    async fetchAdditionalCandidates(serverUrl, id) {
+        if (this.dataChannel?.readyState === 'closed') {
+            return;
+        }
+        const res = await fetch(`${serverUrl}/connection/${id}/candidates`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (res.ok) {
+            const candidates = (await res.json());
+            candidates.forEach((c) => {
+                this.localPeerConnection.addIceCandidate(c);
+            });
+        }
+    }
+    /** Resolves after the server-created data channel event arrives. */
+    async waitForDataChannel() {
+        return new Promise((resolve) => {
+            this.localPeerConnection?.addEventListener('datachannel', () => {
+                resolve();
+            }, { once: true });
+        });
+    }
+    /** Performs HTTP signaling and prepares the browser peer connection. */
+    async connect() {
+        const rtcpc = globalThis.RTCPeerConnection;
+        if (!rtcpc) {
+            this.emit(EVENTS.CONNECTION, {
+                status: -1,
+                statusText: ERRORS.BROWSER_NOT_SUPPORTED,
+            });
+            throw new Error(`Connection failed with error ${ERRORS.BROWSER_NOT_SUPPORTED}`);
+        }
+        const headers = { 'Content-Type': 'application/json' };
+        try {
+            const res = await fetch(`${this.serverUrl}/connection`, {
+                method: 'POST',
+                headers,
+            });
+            if (res.status >= 300) {
+                this.emit(EVENTS.CONNECTION, {
+                    status: -1,
+                    statusText: `Connection failed with status ${res.status}`,
+                });
+                throw new Error(`Connection failed with status ${res.status}`);
+            }
+            this.remotePeerConnection = (await res.json());
+            this.id = this.remotePeerConnection.id;
+        }
+        catch (err) {
+            console.log(err);
+            this.emit(EVENTS.CONNECTION, { status: -1, statusText: err?.toString() });
+            throw new Error(`Connection failed with error ${err}`);
+        }
+        const configuration = {
+            // @ts-ignore
+            sdpSemantics: 'unified-plan',
+            ...this.rtcConfiguration,
+        };
+        // create rtc peer connection
+        this.localPeerConnection = new rtcpc(configuration);
+        // get additional ice candidates
+        // we do still continue to gather candidates even if the connection is established,
+        // maybe we get a better connection.
+        // So the server is still gathering candidates and we ask for them frequently.
+        const showBackOffIntervals = (attempts = 10, initial = 50, factor = 1.8, jitter = 20) => Array(attempts)
+            .fill(0)
+            .map((_, index) => parseInt((initial * factor ** index).toString()) +
+            parseInt((Math.random() * jitter).toString()));
+        showBackOffIntervals().forEach((ms) => {
+            setTimeout(() => {
+                this.fetchAdditionalCandidates(this.serverUrl, this.id).catch(() => { });
+            }, ms);
+        });
+        try {
+            await this.localPeerConnection.setRemoteDescription(this.remotePeerConnection.localDescription);
+            this.localPeerConnection.addEventListener('datachannel', this.onDataChannel.bind(this), { once: true });
+            const originalAnswer = await this.localPeerConnection.createAnswer();
+            const updatedAnswer = new RTCSessionDescription({
+                type: 'answer',
+                sdp: originalAnswer.sdp ?? '',
+            });
+            await this.localPeerConnection.setLocalDescription(updatedAnswer);
+            try {
+                await fetch(`${this.serverUrl}/connection/${this.id}/remote-desc`, {
+                    method: 'POST',
+                    body: JSON.stringify(this.localPeerConnection.localDescription),
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                });
+            }
+            catch (error) {
+                console.error(error.message);
+                return { error };
+            }
+            if (!this.dataChannel) {
+                await this.waitForDataChannel();
+            }
+        }
+        catch (err) {
+            console.error(err?.message);
+            this.localPeerConnection.close();
+            this.emit(EVENTS.CONNECTION, { status: -1, statusText: err?.toString() });
+            throw new Error(`Connection failed with error ${err}`);
+        }
+    }
+    /** Sends one payload over the browser data channel when it is open. */
+    async sendMessage(data) {
+        if (!this.dataChannel) {
+            throw new Error(ERRORS.DATA_CHANNEL_NOT_CREATED);
+        }
+        if (this.dataChannel.readyState === 'open' ||
+            this.dataChannel.isOpen?.()) {
+            try {
+                this.dataChannel.send(data);
+            }
+            catch (error) {
+                console.log(error);
+            }
+        }
+    }
+    /** Returns true when the browser data channel still has buffered bytes to flush. */
+    isBuffering() {
+        if (this.dataChannel) {
+            return this.dataChannel.bufferedAmount > 0;
+        }
+        return false;
+    }
+    /** Closes the browser peer connection and notifies the signaling server. */
+    close() {
+        this.localPeerConnection.close();
+        try {
+            fetch(`${this.serverUrl}/connection/${this.id}/close`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+}
+//# sourceMappingURL=webrtc-client-connection.js.map

package/dgram-client/src/webrtc/webrtc-client-connection.js.map

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

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/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@vworlds/dgram-client",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dgram-client/src/index.js",
+  "types": "./dgram-client/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dgram-client/src/index.d.ts",
+      "default": "./dgram-client/src/index.js"
+    }
+  },
+  "dependencies": {
+    "eventemitter3": "^4.0.7"
+  },
+  "license": "UNLICENSED"
+}