@adeeliore/p2p-core 0.1.0

package/dist/session/types.d.ts

@@ -0,0 +1,195 @@
+import type { IceConnectionState, WebRtcConfiguration, WebRtcHeartbeatConfig, WebRtcPeerManager, WebRtcReconnectConfig, WebRtcSignalEmitter, WebRtcEvents } from '../rtc/types';
+import type { P2PCoreErrorPayload } from '../errors';
+import type { IncomingServerMessage, SignalingClient, SignalingProvider } from '../signaling';
+/**
+ * Describes whether a peer was already present in the room when the local
+ * client joined, or whether it appeared later.
+ */
+export type PeerJoinKind = 'existing' | 'new';
+/**
+ * High-level runtime state of the P2P session.
+ */
+export type P2PSessionStatus = 'idle' | 'connecting' | 'connected' | 'error';
+/**
+ * Configuration for a high-level P2P session runtime.
+ */
+export interface P2PSessionOptions {
+    signalBaseUrl?: string;
+    signalingProvider?: SignalingProvider;
+    sessionId: string;
+    clientId?: string;
+    accessToken?: string;
+    autoCreateOffers?: boolean;
+    offerDelayMs?: number;
+    rtcConfig?: WebRtcConfiguration;
+    heartbeat?: WebRtcHeartbeatConfig;
+    reconnect?: WebRtcReconnectConfig;
+    createSignalingClient?: (options: {
+        signalBaseUrl: string;
+        sessionId: string;
+        clientId?: string;
+        accessToken?: string;
+        onMessage?: (message: IncomingServerMessage) => void;
+        onOpen?: () => void;
+        onClose?: (event: WebSocketCloseEvent) => void;
+        onError?: (event: unknown) => void;
+        onProtocolError?: (reason: string, rawMessage: string) => void;
+    }) => SignalingClient;
+    createPeerManager?: (options: {
+        signalEmitter: WebRtcSignalEmitter;
+        events?: WebRtcEvents;
+        rtcConfig?: WebRtcConfiguration;
+        heartbeat?: WebRtcHeartbeatConfig;
+        reconnect?: WebRtcReconnectConfig;
+    }) => WebRtcPeerManager;
+}
+/**
+ * Observable session snapshot exposed by the runtime.
+ */
+export interface P2PSessionState {
+    sessionId: string;
+    localPeerId: string | null;
+    peerIds: string[];
+    status: P2PSessionStatus;
+}
+/**
+ * Payload emitted when the signaling socket closes.
+ */
+export interface P2PSessionSignalingCloseEvent {
+    code?: number;
+    reason?: string;
+    manual: boolean;
+    hadOpened: boolean;
+}
+/**
+ * Generic runtime error payload.
+ */
+export interface P2PSessionErrorEvent extends P2PCoreErrorPayload {
+}
+/**
+ * Transport-level error payload.
+ */
+export interface P2PSessionTransportErrorEvent {
+    peerId?: string;
+    code: P2PCoreErrorPayload['code'];
+    message: string;
+}
+/**
+ * Payload emitted when the signaling layer receives invalid server data.
+ */
+export interface P2PSessionProtocolErrorEvent {
+    code: P2PCoreErrorPayload['code'];
+    reason: string;
+    rawMessage: string;
+}
+/**
+ * Payload emitted on successful signaling welcome.
+ */
+export interface P2PSessionWelcomeEvent {
+    sessionId: string;
+    clientId: string;
+    peers: string[];
+}
+/**
+ * Base payload for peer-related events.
+ */
+export interface P2PSessionPeerEvent {
+    peerId: string;
+}
+/**
+ * Payload emitted when a peer DataChannel becomes available.
+ */
+export interface P2PSessionPeerDataOpenEvent extends P2PSessionPeerEvent {
+    joinKind: PeerJoinKind;
+}
+/**
+ * Payload emitted for inbound peer messages.
+ */
+export interface P2PSessionPeerMessageEvent extends P2PSessionPeerEvent {
+    message: string;
+}
+/**
+ * Payload emitted on ICE state transitions.
+ */
+export interface P2PSessionIceStateChangeEvent extends P2PSessionPeerEvent {
+    state: IceConnectionState;
+}
+/**
+ * Payload emitted when the signaling server sends an explicit error message.
+ */
+export interface P2PSessionServerErrorEvent {
+    code: string;
+    message: string;
+}
+/**
+ * All session runtime events exposed to consumers.
+ */
+export interface P2PSessionEventMap {
+    signalingOpen: void;
+    signalingClose: P2PSessionSignalingCloseEvent;
+    signalingError: P2PSessionErrorEvent;
+    transportError: P2PSessionTransportErrorEvent;
+    protocolError: P2PSessionProtocolErrorEvent;
+    welcome: P2PSessionWelcomeEvent;
+    peerJoined: P2PSessionPeerEvent;
+    peerLeft: P2PSessionPeerEvent;
+    peerDataOpen: P2PSessionPeerDataOpenEvent;
+    peerDataClose: P2PSessionPeerEvent;
+    peerMessage: P2PSessionPeerMessageEvent;
+    iceStateChange: P2PSessionIceStateChangeEvent;
+    pong: void;
+    serverError: P2PSessionServerErrorEvent;
+}
+/**
+ * High-level reusable P2P session runtime.
+ *
+ * This is the main application-facing API of the package.
+ */
+export interface P2PSession {
+    /**
+     * Opens signaling transport and initializes the WebRTC runtime.
+     */
+    connect: () => void;
+    /**
+     * Closes signaling transport, closes peer connections and resets runtime state.
+     */
+    disconnect: (code?: number, reason?: string) => void;
+    /**
+     * Returns whether the signaling connection is currently open and usable.
+     */
+    isConnected: () => boolean;
+    /**
+     * Returns a read-only snapshot of session runtime state.
+     */
+    getState: () => P2PSessionState;
+    /**
+     * Returns the resolved local peer id from the signaling welcome event.
+     */
+    getLocalPeerId: () => string | null;
+    /**
+     * Returns the current signaling-level list of remote peers.
+     */
+    getPeerIds: () => string[];
+    /**
+     * Sends a signaling-level ping through the WebSocket transport.
+     */
+    sendPing: () => boolean;
+    /**
+     * Sends a raw string payload to a specific peer over DataChannel.
+     */
+    sendTo: (peerId: string, message: string) => boolean;
+    /**
+     * Broadcasts a raw string payload to all known peers or a provided subset.
+     */
+    broadcast: (message: string, peerIds?: string[]) => number;
+    /**
+     * Explicitly creates an SDP offer for a target peer.
+     */
+    createOffer: (peerId: string) => Promise<void>;
+    /**
+     * Subscribes to a runtime event.
+     * Returns an unsubscribe function.
+     */
+    on: <TEvent extends keyof P2PSessionEventMap>(eventName: TEvent, listener: (payload: P2PSessionEventMap[TEvent]) => void) => () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

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

package/dist/session/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/signaling/SignalingClient.d.ts

@@ -0,0 +1,39 @@
+import { RelayOutgoingMessage, SignalingClientOptions } from './types';
+/**
+ * Low-level signaling WebSocket client.
+ *
+ * Use this directly only when you want to build your own orchestration layer.
+ * Most applications should prefer `createP2PSession()`.
+ */
+export declare class SignalingClient {
+    private readonly options;
+    private socket;
+    constructor(options: SignalingClientOptions);
+    /**
+     * Opens the signaling WebSocket if it is not already open.
+     */
+    connect(): void;
+    /**
+     * Closes the signaling WebSocket and drops the local socket reference.
+     */
+    disconnect(code?: number, reason?: string): void;
+    /**
+     * Sends a signaling-level ping frame.
+     */
+    sendPing(): void;
+    /**
+     * Relays an SDP or ICE payload through the signaling server to another peer.
+     */
+    sendRelay(type: RelayOutgoingMessage['type'], to: string, payload: unknown): void;
+    /**
+     * Returns whether the underlying WebSocket is open.
+     */
+    isConnected(): boolean;
+    private send;
+    private tryParseServerMessage;
+}
+/**
+ * Builds a signaling WebSocket URL from session connection options.
+ */
+export declare function buildSignalingUrl(options: Pick<SignalingClientOptions, 'signalBaseUrl' | 'sessionId' | 'clientId' | 'accessToken'>): string;
+//# sourceMappingURL=SignalingClient.d.ts.map

package/dist/signaling/SignalingClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalingClient.d.ts","sourceRoot":"","sources":["../../src/signaling/SignalingClient.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,oBAAoB,EACpB,sBAAsB,EACzB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,MAAM,CAA0B;gBAE5B,OAAO,EAAE,sBAAsB;IAI3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAgCf;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAShD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASjF;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,qBAAqB;CAgBhC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC,GAAG,MAAM,CAiB3I"}

package/dist/signaling/SignalingClient.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalingClient = void 0;
+exports.buildSignalingUrl = buildSignalingUrl;
+const constants_1 = require("./constants");
+const OPEN_STATE = 1;
+/**
+ * Low-level signaling WebSocket client.
+ *
+ * Use this directly only when you want to build your own orchestration layer.
+ * Most applications should prefer `createP2PSession()`.
+ */
+class SignalingClient {
+    constructor(options) {
+        this.socket = null;
+        this.options = options;
+    }
+    /**
+     * Opens the signaling WebSocket if it is not already open.
+     */
+    connect() {
+        if (this.socket && this.socket.readyState === OPEN_STATE) {
+            return;
+        }
+        const url = buildSignalingUrl(this.options);
+        const socket = new WebSocket(url);
+        this.socket = socket;
+        socket.onopen = () => {
+            var _a, _b;
+            (_b = (_a = this.options).onOpen) === null || _b === void 0 ? void 0 : _b.call(_a);
+        };
+        socket.onclose = (event) => {
+            var _a, _b;
+            (_b = (_a = this.options).onClose) === null || _b === void 0 ? void 0 : _b.call(_a, event);
+        };
+        socket.onerror = (event) => {
+            var _a, _b;
+            (_b = (_a = this.options).onError) === null || _b === void 0 ? void 0 : _b.call(_a, event);
+        };
+        socket.onmessage = (event) => {
+            var _a, _b, _c;
+            const rawMessage = typeof event.data === 'string' ? event.data : String((_a = event.data) !== null && _a !== void 0 ? _a : '');
+            const parsed = this.tryParseServerMessage(rawMessage);
+            if (!parsed) {
+                return;
+            }
+            (_c = (_b = this.options).onMessage) === null || _c === void 0 ? void 0 : _c.call(_b, parsed);
+        };
+    }
+    /**
+     * Closes the signaling WebSocket and drops the local socket reference.
+     */
+    disconnect(code, reason) {
+        if (!this.socket) {
+            return;
+        }
+        this.socket.close(code, reason);
+        this.socket = null;
+    }
+    /**
+     * Sends a signaling-level ping frame.
+     */
+    sendPing() {
+        this.send({ type: constants_1.SIGNAL_TYPE.PING });
+    }
+    /**
+     * Relays an SDP or ICE payload through the signaling server to another peer.
+     */
+    sendRelay(type, to, payload) {
+        this.send({
+            type,
+            to,
+            payload,
+            sessionId: this.options.sessionId,
+        });
+    }
+    /**
+     * Returns whether the underlying WebSocket is open.
+     */
+    isConnected() {
+        var _a;
+        return ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === OPEN_STATE;
+    }
+    send(message) {
+        if (!this.socket || this.socket.readyState !== OPEN_STATE) {
+            throw new Error('WebSocket is not connected');
+        }
+        if (constants_1.RELAY_TYPES.has(message.type)) {
+            const relay = message;
+            if (!relay.to || !relay.to.trim()) {
+                throw new Error('Relay target `to` is required');
+            }
+        }
+        this.socket.send(JSON.stringify(message));
+    }
+    tryParseServerMessage(rawMessage) {
+        var _a, _b, _c, _d;
+        let parsed;
+        try {
+            parsed = JSON.parse(rawMessage);
+        }
+        catch {
+            (_b = (_a = this.options).onProtocolError) === null || _b === void 0 ? void 0 : _b.call(_a, 'invalid_json', rawMessage);
+            return null;
+        }
+        if (!parsed || typeof parsed !== 'object' || !('type' in parsed)) {
+            (_d = (_c = this.options).onProtocolError) === null || _d === void 0 ? void 0 : _d.call(_c, 'missing_type', rawMessage);
+            return null;
+        }
+        return parsed;
+    }
+}
+exports.SignalingClient = SignalingClient;
+/**
+ * Builds a signaling WebSocket URL from session connection options.
+ */
+function buildSignalingUrl(options) {
+    const base = options.signalBaseUrl.endsWith('/')
+        ? options.signalBaseUrl.slice(0, -1)
+        : options.signalBaseUrl;
+    const url = new URL(`${base}${constants_1.SIGNALING_PATH}`);
+    url.searchParams.set('sessionId', options.sessionId);
+    if (options.clientId && options.clientId.trim()) {
+        url.searchParams.set('clientId', options.clientId.trim());
+    }
+    if (options.accessToken && options.accessToken.trim()) {
+        url.searchParams.set('accessToken', options.accessToken.trim());
+    }
+    return url.toString();
+}

package/dist/signaling/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const SIGNALING_PATH = "/ws";
+export declare const SIGNAL_TYPE: {
+    readonly PING: "ping";
+    readonly PONG: "pong";
+    readonly WELCOME: "welcome";
+    readonly ERROR: "error";
+    readonly PEER_JOINED: "peer-joined";
+    readonly PEER_LEFT: "peer-left";
+    readonly OFFER: "offer";
+    readonly ANSWER: "answer";
+    readonly ICE: "ice";
+};
+export declare const RELAY_TYPES: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/signaling/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/signaling/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAEX,eAAO,MAAM,WAAW,aAItB,CAAC"}

package/dist/signaling/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELAY_TYPES = exports.SIGNAL_TYPE = exports.SIGNALING_PATH = void 0;
+exports.SIGNALING_PATH = '/ws';
+exports.SIGNAL_TYPE = {
+    PING: 'ping',
+    PONG: 'pong',
+    WELCOME: 'welcome',
+    ERROR: 'error',
+    PEER_JOINED: 'peer-joined',
+    PEER_LEFT: 'peer-left',
+    OFFER: 'offer',
+    ANSWER: 'answer',
+    ICE: 'ice',
+};
+exports.RELAY_TYPES = new Set([
+    exports.SIGNAL_TYPE.OFFER,
+    exports.SIGNAL_TYPE.ANSWER,
+    exports.SIGNAL_TYPE.ICE,
+]);

package/dist/signaling/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants';
+export * from './provider';
+export * from './SignalingClient';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/signaling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signaling/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/signaling/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./provider"), exports);
+__exportStar(require("./SignalingClient"), exports);
+__exportStar(require("./types"), exports);

package/dist/signaling/provider.d.ts

@@ -0,0 +1,56 @@
+import { IncomingServerMessage, RelayOutgoingMessage, SignalingClientOptions } from './types';
+import { SignalingClient } from './SignalingClient';
+export type SignalingProviderStatus = 'idle' | 'connecting' | 'open' | 'closed' | 'error';
+export interface SignalingProviderCloseEvent {
+    code?: number;
+    reason?: string;
+}
+export interface SignalingProviderErrorEvent {
+    message: string;
+    cause?: unknown;
+}
+export interface SignalingProviderConnectOptions {
+    sessionId: string;
+    clientId?: string;
+    accessToken?: string;
+}
+export interface SignalingProviderHandlers {
+    onOpen?: () => void;
+    onClose?: (event: SignalingProviderCloseEvent) => void;
+    onError?: (event: SignalingProviderErrorEvent) => void;
+    onProtocolError?: (reason: string, rawMessage: string) => void;
+    onMessage?: (message: IncomingServerMessage) => void;
+    onStatusChange?: (status: SignalingProviderStatus) => void;
+}
+/**
+ * Transport-neutral signaling contract consumed by P2PSession.
+ *
+ * Implementations may use a remote WebSocket server, Android/iOS LAN host,
+ * Multipeer Connectivity, or any other control-plane transport. User data
+ * should still flow over WebRTC DataChannels unless the app explicitly adds a
+ * relay fallback.
+ */
+export interface SignalingProvider {
+    connect(options: SignalingProviderConnectOptions, handlers: SignalingProviderHandlers): void | Promise<void>;
+    disconnect(code?: number, reason?: string): void;
+    sendPing(): void;
+    sendRelay(type: RelayOutgoingMessage['type'], to: string, payload: unknown): void;
+    isConnected(): boolean;
+}
+export interface WebSocketSignalingProviderOptions {
+    signalBaseUrl: string;
+    createSignalingClient?: (options: SignalingClientOptions) => SignalingClient;
+}
+export declare class WebSocketSignalingProvider implements SignalingProvider {
+    private readonly options;
+    private client;
+    constructor(options: WebSocketSignalingProviderOptions);
+    connect(options: SignalingProviderConnectOptions, handlers: SignalingProviderHandlers): void;
+    disconnect(code?: number, reason?: string): void;
+    sendPing(): void;
+    sendRelay(type: RelayOutgoingMessage['type'], to: string, payload: unknown): void;
+    isConnected(): boolean;
+    private send;
+}
+export declare function createWebSocketSignalingProvider(options: WebSocketSignalingProviderOptions): SignalingProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/signaling/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/signaling/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1F,MAAM,WAAW,2BAA2B;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,+BAA+B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;IACvD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7G,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,IAAI,IAAI,CAAC;IACjB,SAAS,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAClF,WAAW,IAAI,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iCAAiC;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,eAAe,CAAC;CAChF;AAED,qBAAa,0BAA2B,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,MAAM,CAAgC;gBAElC,OAAO,EAAE,iCAAiC;IAItD,OAAO,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAuC5F,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhD,QAAQ,IAAI,IAAI;IAIhB,SAAS,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQjF,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,IAAI;CAiBf;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,iBAAiB,CAE9G"}

package/dist/signaling/provider.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketSignalingProvider = void 0;
+exports.createWebSocketSignalingProvider = createWebSocketSignalingProvider;
+const constants_1 = require("./constants");
+const SignalingClient_1 = require("./SignalingClient");
+class WebSocketSignalingProvider {
+    constructor(options) {
+        this.client = null;
+        this.options = options;
+    }
+    connect(options, handlers) {
+        var _a, _b;
+        if ((_a = this.client) === null || _a === void 0 ? void 0 : _a.isConnected()) {
+            return;
+        }
+        (_b = handlers.onStatusChange) === null || _b === void 0 ? void 0 : _b.call(handlers, 'connecting');
+        const clientOptions = {
+            signalBaseUrl: this.options.signalBaseUrl,
+            sessionId: options.sessionId,
+            clientId: options.clientId,
+            accessToken: options.accessToken,
+            onOpen: () => {
+                var _a, _b;
+                (_a = handlers.onStatusChange) === null || _a === void 0 ? void 0 : _a.call(handlers, 'open');
+                (_b = handlers.onOpen) === null || _b === void 0 ? void 0 : _b.call(handlers);
+            },
+            onClose: (event) => {
+                var _a, _b;
+                (_a = handlers.onStatusChange) === null || _a === void 0 ? void 0 : _a.call(handlers, 'closed');
+                (_b = handlers.onClose) === null || _b === void 0 ? void 0 : _b.call(handlers, { code: event.code, reason: event.reason });
+            },
+            onError: (event) => {
+                var _a, _b;
+                (_a = handlers.onStatusChange) === null || _a === void 0 ? void 0 : _a.call(handlers, 'error');
+                (_b = handlers.onError) === null || _b === void 0 ? void 0 : _b.call(handlers, {
+                    message: 'Signaling socket error',
+                    cause: event,
+                });
+            },
+            onProtocolError: handlers.onProtocolError,
+            onMessage: handlers.onMessage,
+        };
+        const client = this.options.createSignalingClient
+            ? this.options.createSignalingClient(clientOptions)
+            : new SignalingClient_1.SignalingClient(clientOptions);
+        this.client = client;
+        client.connect();
+    }
+    disconnect(code, reason) {
+        var _a;
+        (_a = this.client) === null || _a === void 0 ? void 0 : _a.disconnect(code, reason);
+        this.client = null;
+    }
+    sendPing() {
+        this.send({ type: constants_1.SIGNAL_TYPE.PING });
+    }
+    sendRelay(type, to, payload) {
+        this.send({
+            type,
+            to,
+            payload,
+        });
+    }
+    isConnected() {
+        var _a;
+        return ((_a = this.client) === null || _a === void 0 ? void 0 : _a.isConnected()) === true;
+    }
+    send(message) {
+        if (!this.client) {
+            throw new Error('Signaling provider is not connected');
+        }
+        if (message.type === constants_1.SIGNAL_TYPE.PING) {
+            this.client.sendPing();
+            return;
+        }
+        if (constants_1.RELAY_TYPES.has(message.type)) {
+            this.client.sendRelay(message.type, message.to, message.payload);
+            return;
+        }
+        throw new Error(`Unsupported signaling message type: ${message.type}`);
+    }
+}
+exports.WebSocketSignalingProvider = WebSocketSignalingProvider;
+function createWebSocketSignalingProvider(options) {
+    return new WebSocketSignalingProvider(options);
+}

package/dist/signaling/types.d.ts

@@ -0,0 +1,62 @@
+export type RelayType = 'offer' | 'answer' | 'ice';
+export type ServerMessageType = 'welcome' | 'peer-joined' | 'peer-left' | 'pong' | 'offer' | 'answer' | 'ice' | 'error';
+export interface PeerInfo {
+    clientId: string;
+}
+export interface WelcomeMessage {
+    type: 'welcome';
+    sessionId: string;
+    clientId: string;
+    peers: PeerInfo[];
+}
+export interface PeerJoinedMessage {
+    type: 'peer-joined';
+    sessionId: string;
+    clientId: string;
+}
+export interface PeerLeftMessage {
+    type: 'peer-left';
+    sessionId: string;
+    clientId: string;
+}
+export interface PongMessage {
+    type: 'pong';
+}
+export interface RelayServerMessage {
+    type: RelayType;
+    sessionId: string;
+    from: string;
+    to: string;
+    payload?: unknown;
+}
+export interface ErrorMessage {
+    type: 'error';
+    code: string;
+    message: string;
+}
+export type IncomingServerMessage = WelcomeMessage | PeerJoinedMessage | PeerLeftMessage | PongMessage | RelayServerMessage | ErrorMessage;
+export interface OutgoingMessageBase {
+    type: string;
+    sessionId?: string;
+}
+export interface PingMessage extends OutgoingMessageBase {
+    type: 'ping';
+}
+export interface RelayOutgoingMessage extends OutgoingMessageBase {
+    type: RelayType;
+    to: string;
+    payload: unknown;
+}
+export type OutgoingClientMessage = PingMessage | RelayOutgoingMessage;
+export interface SignalingClientOptions {
+    signalBaseUrl: string;
+    sessionId: string;
+    clientId?: string;
+    accessToken?: string;
+    onMessage?: (message: IncomingServerMessage) => void;
+    onOpen?: () => void;
+    onClose?: (event: WebSocketCloseEvent) => void;
+    onError?: (event: unknown) => void;
+    onProtocolError?: (reason: string, rawMessage: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/signaling/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signaling/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GACvB,SAAS,GACT,aAAa,GACb,WAAW,GACX,MAAM,GACN,OAAO,GACP,QAAQ,GACR,KAAK,GACL,OAAO,CAAC;AAEd,MAAM,WAAW,QAAQ;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAC3B,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,kBAAkB,GAClB,YAAY,CAAC;AAEnB,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACpD,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE"}

package/dist/signaling/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });