mediasoup-client 3.6.90 → 3.6.91

package/lib/DataProducer.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataProducer = void 0;
+const Logger_1 = require("./Logger");
+const EnhancedEventEmitter_1 = require("./EnhancedEventEmitter");
+const errors_1 = require("./errors");
+const logger = new Logger_1.Logger('DataProducer');
+class DataProducer extends EnhancedEventEmitter_1.EnhancedEventEmitter {
+    constructor({ id, dataChannel, sctpStreamParameters, appData }) {
+        super();
+        // Closed flag.
+        this._closed = false;
+        // Observer instance.
+        this._observer = new EnhancedEventEmitter_1.EnhancedEventEmitter();
+        logger.debug('constructor()');
+        this._id = id;
+        this._dataChannel = dataChannel;
+        this._sctpStreamParameters = sctpStreamParameters;
+        this._appData = appData || {};
+        this.handleDataChannel();
+    }
+    /**
+     * DataProducer id.
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * Whether the DataProducer is closed.
+     */
+    get closed() {
+        return this._closed;
+    }
+    /**
+     * SCTP stream parameters.
+     */
+    get sctpStreamParameters() {
+        return this._sctpStreamParameters;
+    }
+    /**
+     * DataChannel readyState.
+     */
+    get readyState() {
+        return this._dataChannel.readyState;
+    }
+    /**
+     * DataChannel label.
+     */
+    get label() {
+        return this._dataChannel.label;
+    }
+    /**
+     * DataChannel protocol.
+     */
+    get protocol() {
+        return this._dataChannel.protocol;
+    }
+    /**
+     * DataChannel bufferedAmount.
+     */
+    get bufferedAmount() {
+        return this._dataChannel.bufferedAmount;
+    }
+    /**
+     * DataChannel bufferedAmountLowThreshold.
+     */
+    get bufferedAmountLowThreshold() {
+        return this._dataChannel.bufferedAmountLowThreshold;
+    }
+    /**
+     * Set DataChannel bufferedAmountLowThreshold.
+     */
+    set bufferedAmountLowThreshold(bufferedAmountLowThreshold) {
+        this._dataChannel.bufferedAmountLowThreshold = bufferedAmountLowThreshold;
+    }
+    /**
+     * App custom data.
+     */
+    get appData() {
+        return this._appData;
+    }
+    /**
+     * App custom data setter.
+     */
+    set appData(appData) {
+        this._appData = appData;
+    }
+    get observer() {
+        return this._observer;
+    }
+    /**
+     * Closes the DataProducer.
+     */
+    close() {
+        if (this._closed) {
+            return;
+        }
+        logger.debug('close()');
+        this._closed = true;
+        this._dataChannel.close();
+        this.emit('@close');
+        // Emit observer event.
+        this._observer.safeEmit('close');
+    }
+    /**
+     * Transport was closed.
+     */
+    transportClosed() {
+        if (this._closed) {
+            return;
+        }
+        logger.debug('transportClosed()');
+        this._closed = true;
+        this._dataChannel.close();
+        this.safeEmit('transportclose');
+        // Emit observer event.
+        this._observer.safeEmit('close');
+    }
+    /**
+     * Send a message.
+     *
+     * @param {String|Blob|ArrayBuffer|ArrayBufferView} data.
+     */
+    send(data) {
+        logger.debug('send()');
+        if (this._closed) {
+            throw new errors_1.InvalidStateError('closed');
+        }
+        this._dataChannel.send(data);
+    }
+    handleDataChannel() {
+        this._dataChannel.addEventListener('open', () => {
+            if (this._closed) {
+                return;
+            }
+            logger.debug('DataChannel "open" event');
+            this.safeEmit('open');
+        });
+        this._dataChannel.addEventListener('error', (event) => {
+            if (this._closed) {
+                return;
+            }
+            let { error } = event;
+            if (!error) {
+                error = new Error('unknown DataChannel error');
+            }
+            if (error.errorDetail === 'sctp-failure') {
+                logger.error('DataChannel SCTP error [sctpCauseCode:%s]: %s', error.sctpCauseCode, error.message);
+            }
+            else {
+                logger.error('DataChannel "error" event: %o', error);
+            }
+            this.safeEmit('error', error);
+        });
+        this._dataChannel.addEventListener('close', () => {
+            if (this._closed) {
+                return;
+            }
+            logger.warn('DataChannel "close" event');
+            this._closed = true;
+            this.emit('@close');
+            this.safeEmit('close');
+            // Emit observer event.
+            this._observer.safeEmit('close');
+        });
+        this._dataChannel.addEventListener('message', () => {
+            if (this._closed) {
+                return;
+            }
+            logger.warn('DataChannel "message" event in a DataProducer, message discarded');
+        });
+        this._dataChannel.addEventListener('bufferedamountlow', () => {
+            if (this._closed) {
+                return;
+            }
+            this.safeEmit('bufferedamountlow');
+        });
+    }
+}
+exports.DataProducer = DataProducer;

package/lib/Device.d.ts

@@ -0,0 +1,92 @@
+import { EnhancedEventEmitter } from './EnhancedEventEmitter';
+import { Transport, TransportOptions } from './Transport';
+import { HandlerFactory } from './handlers/HandlerInterface';
+import { RtpCapabilities, MediaKind } from './RtpParameters';
+import { SctpCapabilities } from './SctpParameters';
+import { AppData } from './types';
+export type BuiltinHandlerName = 'Chrome111' | 'Chrome74' | 'Chrome70' | 'Chrome67' | 'Chrome55' | 'Firefox60' | 'Safari12' | 'Safari11' | 'Edge11' | 'ReactNativeUnifiedPlan' | 'ReactNative';
+export type DeviceOptions = {
+    /**
+     * The name of one of the builtin handlers.
+     */
+    handlerName?: BuiltinHandlerName;
+    /**
+     * Custom handler factory.
+     */
+    handlerFactory?: HandlerFactory;
+    /**
+     * DEPRECATED!
+     * The name of one of the builtin handlers.
+     */
+    Handler?: string;
+};
+export declare function detectDevice(): BuiltinHandlerName | undefined;
+export type DeviceObserverEvents = {
+    newtransport: [Transport];
+};
+export declare class Device {
+    private readonly _handlerFactory;
+    private readonly _handlerName;
+    private _loaded;
+    private _extendedRtpCapabilities?;
+    private _recvRtpCapabilities?;
+    private readonly _canProduceByKind;
+    private _sctpCapabilities?;
+    protected readonly _observer: EnhancedEventEmitter<DeviceObserverEvents>;
+    /**
+     * Create a new Device to connect to mediasoup server.
+     *
+     * @throws {UnsupportedError} if device is not supported.
+     */
+    constructor({ handlerName, handlerFactory, Handler }?: DeviceOptions);
+    /**
+     * The RTC handler name.
+     */
+    get handlerName(): string;
+    /**
+     * Whether the Device is loaded.
+     */
+    get loaded(): boolean;
+    /**
+     * RTP capabilities of the Device for receiving media.
+     *
+     * @throws {InvalidStateError} if not loaded.
+     */
+    get rtpCapabilities(): RtpCapabilities;
+    /**
+     * SCTP capabilities of the Device.
+     *
+     * @throws {InvalidStateError} if not loaded.
+     */
+    get sctpCapabilities(): SctpCapabilities;
+    get observer(): EnhancedEventEmitter;
+    /**
+     * Initialize the Device.
+     */
+    load({ routerRtpCapabilities }: {
+        routerRtpCapabilities: RtpCapabilities;
+    }): Promise<void>;
+    /**
+     * Whether we can produce audio/video.
+     *
+     * @throws {InvalidStateError} if not loaded.
+     * @throws {TypeError} if wrong arguments.
+     */
+    canProduce(kind: MediaKind): boolean;
+    /**
+     * Creates a Transport for sending media.
+     *
+     * @throws {InvalidStateError} if not loaded.
+     * @throws {TypeError} if wrong arguments.
+     */
+    createSendTransport<TransportAppData extends AppData = AppData>({ id, iceParameters, iceCandidates, dtlsParameters, sctpParameters, iceServers, iceTransportPolicy, additionalSettings, proprietaryConstraints, appData }: TransportOptions<TransportAppData>): Transport<TransportAppData>;
+    /**
+     * Creates a Transport for receiving media.
+     *
+     * @throws {InvalidStateError} if not loaded.
+     * @throws {TypeError} if wrong arguments.
+     */
+    createRecvTransport<TransportAppData extends AppData = AppData>({ id, iceParameters, iceCandidates, dtlsParameters, sctpParameters, iceServers, iceTransportPolicy, additionalSettings, proprietaryConstraints, appData }: TransportOptions<TransportAppData>): Transport<TransportAppData>;
+    private createTransport;
+}
+//# sourceMappingURL=Device.d.ts.map

package/lib/Device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../src/Device.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAoB,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAoB,MAAM,6BAA6B,CAAC;AAY/E,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,MAAM,kBAAkB,GAC3B,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,wBAAwB,GACxB,aAAa,CAAC;AAEjB,MAAM,MAAM,aAAa,GACzB;IACC;;OAEG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,YAAY,IAAI,kBAAkB,GAAG,SAAS,CAiM7D;AAED,MAAM,MAAM,oBAAoB,GAChC;IACC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;CAC1B,CAAC;AAEF,qBAAa,MAAM;IAGlB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,wBAAwB,CAAC,CAAM;IAEvC,OAAO,CAAC,oBAAoB,CAAC,CAAkB;IAG/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IAErD,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAE7C,SAAS,CAAC,QAAQ,CAAC,SAAS,6CAAoD;IAEhF;;;;OAIG;gBACS,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,GAAE,aAAkB;IA2GxE;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAGpB;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,eAAe,CAQrC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAQvC;IAED,IAAI,QAAQ,IAAI,oBAAoB,CAGnC;IAED;;OAEG;IACG,IAAI,CACT,EAAE,qBAAqB,EAAE,EACzB;QAAE,qBAAqB,EAAE,eAAe,CAAA;KAAE,GACxC,OAAO,CAAC,IAAI,CAAC;IAgFhB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAcpC;;;;;OAKG;IACH,mBAAmB,CAAC,gBAAgB,SAAS,OAAO,GAAG,OAAO,EAC7D,EACC,EAAE,EACF,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GACnC,SAAS,CAAC,gBAAgB,CAAC;IAoB9B;;;;;OAKG;IACH,mBAAmB,CAAC,gBAAgB,SAAS,OAAO,GAAG,OAAO,EAC7D,EACC,EAAE,EACF,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GACnC,SAAS,CAAC,gBAAgB,CAAC;IAoB9B,OAAO,CAAC,eAAe;CAwEvB"}