@abrar71/lib-jitsi-meet 0.0.0

package/dist/esm/modules/statistics/statistics.js

@@ -0,0 +1,362 @@
+import { getLogger } from '@jitsi/logger';
+import { JitsiTrackEvents } from '../../JitsiTrackEvents';
+import { AnalyticsEvents } from '../../service/statistics/AnalyticsEvents';
+import { StatisticsEvents } from '../../service/statistics/Events';
+import { LOCAL_JID } from '../../service/statistics/constants';
+import RTCStats from '../RTCStats/RTCStats';
+import browser from '../browser';
+import EventEmitter from '../util/EventEmitter';
+import WatchRTC from '../watchRTC/WatchRTC';
+import analytics from './AnalyticsAdapter';
+import LocalStats from './LocalStatsCollector';
+import RTPStats from './RTPStatsCollector';
+const logger = getLogger('stats:statistics');
+/**
+ * Statistics class provides various functionality related to collecting and reporting statistics.
+ */
+class Statistics {
+    /**
+     * Static getter for instances property
+     * Returns the Set holding all active Statistics instances. Lazily
+     * initializes the Set to allow any Set polyfills to be applied.
+     * @type {Set<Statistics>}
+     */
+    static get instances() {
+        if (!Statistics._instances) {
+            Statistics._instances = new Set();
+        }
+        return Statistics._instances;
+    }
+    /**
+     * Init statistic options
+     * @static
+     * @param {Object} options - The options to initialize statistics with
+     */
+    static init(options) {
+        Statistics.audioLevelsEnabled = !options.disableAudioLevels;
+        if (typeof options.pcStatsInterval === 'number') {
+            Statistics.pcStatsInterval = options.pcStatsInterval;
+        }
+        if (typeof options.audioLevelsInterval === 'number') {
+            Statistics.audioLevelsInterval = options.audioLevelsInterval;
+        }
+        Statistics.disableThirdPartyRequests = options.disableThirdPartyRequests;
+        LocalStats.init();
+        WatchRTC.init(options);
+    }
+    /**
+     * Starts collecting local statistics for a track.
+     * @static
+     * @param {JitsiTrack} track - The track to collect statistics for
+     * @param {Function} callback - The callback to invoke with audio levels
+     */
+    static startLocalStats(track, callback) {
+        if (browser.isIosBrowser()) {
+            // On iOS browsers audio is lost if the audio input device is in use by another app
+            // https://bugs.webkit.org/show_bug.cgi?id=233473
+            // The culprit was using the AudioContext, so now we close the AudioContext during
+            // the track being muted, and re-instantiate it afterwards.
+            track.addEventListener(JitsiTrackEvents.NO_DATA_FROM_SOURCE, 
+            /**
+             * Closes AudioContext on no audio data, and enables it on data received again.
+             *
+             * @param {boolean} value - Whether we receive audio data or not.
+             */
+            async (value) => {
+                if (value) {
+                    for (const localStat of Statistics.localStats) {
+                        localStat.stop();
+                    }
+                    await LocalStats.disconnectAudioContext();
+                }
+                else {
+                    LocalStats.connectAudioContext();
+                    for (const localStat of Statistics.localStats) {
+                        localStat.start();
+                    }
+                }
+            });
+        }
+        if (!Statistics.audioLevelsEnabled) {
+            return;
+        }
+        track.addEventListener(JitsiTrackEvents.LOCAL_TRACK_STOPPED, () => {
+            Statistics.stopLocalStats(track);
+        });
+        const stream = track.getOriginalStream();
+        const localStats = new LocalStats(stream, Statistics.audioLevelsInterval, callback);
+        this.localStats.push(localStats);
+        localStats.start();
+    }
+    /**
+     * Stops collecting local statistics for a track.
+     * @static
+     * @param {JitsiTrack} track - The track to stop collecting statistics for
+     */
+    static stopLocalStats(track) {
+        if (!Statistics.audioLevelsEnabled) {
+            return;
+        }
+        const stream = track.getOriginalStream();
+        for (let i = 0; i < Statistics.localStats.length; i++) {
+            if (Statistics.localStats[i].stream === stream) {
+                const localStats = Statistics.localStats.splice(i, 1);
+                localStats[0].stop();
+                break;
+            }
+        }
+    }
+    /**
+     * Sends event to analytics and logs a message to the logger/console.
+     * @static
+     * @param {string | Object} event - The event name, or an object which represents the entire event
+     * @param {Object} properties - Properties to attach to the event
+     */
+    static sendAnalyticsAndLog(event, properties = {}) {
+        if (!event) {
+            logger.warn('No event or event name given.');
+            return;
+        }
+        let eventToLog;
+        // Also support an API with a single object as an event.
+        if (typeof event === 'object') {
+            eventToLog = event;
+        }
+        else {
+            eventToLog = {
+                name: event,
+                properties
+            };
+        }
+        logger.debug(JSON.stringify(eventToLog));
+        // We do this last, because it may modify the object which is passed.
+        this.analytics.sendEvent(event, properties);
+    }
+    /**
+     * Sends event to analytics.
+     * @static
+     * @param {string | Object} eventName - The event name, or an object which represents the entire event
+     * @param {Object} properties - Properties to attach to the event
+     */
+    static sendAnalytics(eventName, properties = {}) {
+        this.analytics.sendEvent(eventName, properties);
+    }
+    constructor(conference, options) {
+        /**
+         * {@link RTPStats} mapped by {@link TraceablePeerConnection.id} which
+         * collect RTP statistics for each peerconnection.
+         * @type {Map<string, RTPStats>}
+         */
+        this.rtpStatsMap = new Map();
+        this.eventEmitter = new EventEmitter();
+        this.conference = conference;
+        this.xmpp = conference?.xmpp;
+        this.options = options || {};
+        Statistics.instances.add(this);
+        RTCStats.attachToConference(this.conference);
+        // WatchRTC is not required to work for react native
+        if (!browser.isReactNative()) {
+            WatchRTC.start(this.options.roomName, this.options.userName);
+        }
+    }
+    /**
+     * Starts collecting RTP stats for given peerconnection.
+     * @param {TraceablePeerConnection} peerconnection
+     */
+    startRemoteStats(peerconnection) {
+        this.stopRemoteStats(peerconnection);
+        try {
+            const rtpStats = new RTPStats(peerconnection, Statistics.audioLevelsInterval, Statistics.pcStatsInterval, this.eventEmitter);
+            rtpStats.start(Statistics.audioLevelsEnabled);
+            this.rtpStatsMap.set(String(peerconnection.id), rtpStats);
+        }
+        catch (e) {
+            logger.error(`Failed to start collecting remote statistics: ${e}`);
+        }
+    }
+    /**
+     * Adds a listener for audio level events.
+     * @param {Function} listener - The listener to add
+     */
+    addAudioLevelListener(listener) {
+        if (!Statistics.audioLevelsEnabled) {
+            return;
+        }
+        this.eventEmitter.on(StatisticsEvents.AUDIO_LEVEL, listener);
+    }
+    /**
+     * Removes an audio level listener.
+     * @param {Function} listener - The listener to remove
+     */
+    removeAudioLevelListener(listener) {
+        if (!Statistics.audioLevelsEnabled) {
+            return;
+        }
+        this.eventEmitter.removeListener(StatisticsEvents.AUDIO_LEVEL, listener);
+    }
+    /**
+     * Adds a listener for before disposed events.
+     * @param {Function} listener - The listener to add
+     */
+    addBeforeDisposedListener(listener) {
+        this.eventEmitter.on(StatisticsEvents.BEFORE_DISPOSED, listener);
+    }
+    /**
+     * Removes a before disposed listener.
+     * @param {Function} listener - The listener to remove
+     */
+    removeBeforeDisposedListener(listener) {
+        this.eventEmitter.removeListener(StatisticsEvents.BEFORE_DISPOSED, listener);
+    }
+    /**
+     * Adds a listener for connection stats events.
+     * @param {Function} listener - The listener to add
+     */
+    addConnectionStatsListener(listener) {
+        this.eventEmitter.on(StatisticsEvents.CONNECTION_STATS, listener);
+    }
+    /**
+     * Removes a connection stats listener.
+     * @param {Function} listener - The listener to remove
+     */
+    removeConnectionStatsListener(listener) {
+        this.eventEmitter.removeListener(StatisticsEvents.CONNECTION_STATS, listener);
+    }
+    /**
+     * Adds a listener for encode time stats events.
+     * @param {Function} listener - The listener to add
+     */
+    addEncodeTimeStatsListener(listener) {
+        this.eventEmitter.on(StatisticsEvents.ENCODE_TIME_STATS, listener);
+    }
+    /**
+     * Removes an encode time stats listener.
+     * @param {Function} listener - The listener to remove
+     */
+    removeEncodeTimeStatsListener(listener) {
+        this.eventEmitter.removeListener(StatisticsEvents.ENCODE_TIME_STATS, listener);
+    }
+    /**
+     * Adds a listener for byte sent stats events.
+     * @param {Function} listener - The listener to add
+     */
+    addByteSentStatsListener(listener) {
+        this.eventEmitter.on(StatisticsEvents.BYTE_SENT_STATS, listener);
+    }
+    /**
+     * Removes a byte sent stats listener.
+     * @param {Function} listener - The listener to remove
+     */
+    removeByteSentStatsListener(listener) {
+        this.eventEmitter.removeListener(StatisticsEvents.BYTE_SENT_STATS, listener);
+    }
+    /**
+     * Updates the list of speakers for which the audio levels are to be calculated. This is needed for the jvb pc only.
+     *
+     * @param {Array<string>} speakerList The list of remote endpoint ids.
+     * @returns {void}
+     */
+    setSpeakerList(speakerList) {
+        for (const rtpStats of Array.from(this.rtpStatsMap.values())) {
+            if (!rtpStats.peerconnection.isP2P) {
+                rtpStats.setSpeakerList(speakerList);
+            }
+        }
+    }
+    /**
+     * Disposes of this instance, stopping any ongoing stats collection.
+     */
+    dispose() {
+        try {
+            this.eventEmitter.emit(StatisticsEvents.BEFORE_DISPOSED);
+            for (const tpcId of this.rtpStatsMap.keys()) {
+                this._stopRemoteStats(tpcId);
+            }
+            if (this.eventEmitter) {
+                this.eventEmitter.removeAllListeners();
+            }
+        }
+        finally {
+            Statistics.instances.delete(this);
+        }
+    }
+    /**
+     * Stops remote RTP stats for given peerconnection ID.
+     * @param {string} tpcId {@link TraceablePeerConnection.id}
+     * @private
+     */
+    _stopRemoteStats(tpcId) {
+        const rtpStats = this.rtpStatsMap.get(tpcId);
+        if (rtpStats) {
+            rtpStats.stop();
+            this.rtpStatsMap.delete(tpcId);
+        }
+    }
+    /**
+     * Stops collecting RTP stats for given peerconnection
+     * @param {TraceablePeerConnection} tpc
+     */
+    stopRemoteStats(tpc) {
+        this._stopRemoteStats(String(tpc.id));
+    }
+    /**
+     * Sends the given feedback
+     *
+     * @param {number} overall an integer between 1 and 5 indicating the user's rating.
+     * @param {string} comment the comment from the user.
+     * @returns {Promise} Resolves immediately.
+     */
+    sendFeedback(overall, comment) {
+        // Statistics.analytics.sendEvent is currently fire and forget, without
+        // confirmation of successful send.
+        Statistics.analytics.sendEvent(AnalyticsEvents.FEEDBACK, {
+            comment,
+            rating: overall
+        });
+        return Promise.resolve();
+    }
+}
+/**
+ * Flag indicating whether audio levels are enabled or not.
+ * @static
+ * @type {boolean}
+ */
+Statistics.audioLevelsEnabled = false;
+/**
+ * The interval for audio levels stats collection.
+ * @static
+ * @type {number}
+ */
+Statistics.audioLevelsInterval = 200;
+/**
+ * The interval for peer connection stats collection.
+ * @static
+ * @type {number}
+ */
+Statistics.pcStatsInterval = 10000;
+/**
+ * Flag indicating whether third party requests are disabled.
+ * @static
+ * @type {boolean}
+ */
+Statistics.disableThirdPartyRequests = false;
+/**
+ * Analytics adapter for sending events.
+ * @static
+ * @type {Object}
+ */
+Statistics.analytics = analytics;
+/**
+ * Array holding local statistics collectors.
+ * @static
+ * @type {Array}
+ */
+Statistics.localStats = [];
+/**
+ * Local JID constant.
+ * @static
+ * @type {string}
+ */
+Statistics.LOCAL_JID = LOCAL_JID;
+export default Statistics;
+//# sourceMappingURL=statistics.js.map

package/dist/esm/modules/statistics/statistics.js.map

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

package/dist/esm/modules/util/AsyncQueue.js

@@ -0,0 +1,102 @@
+import { getLogger } from '@jitsi/logger';
+import { queue } from 'async-es';
+const logger = getLogger('utils:AsyncQueue');
+/**
+ * Error to be passed to a callback of a queued task when the queue is cleared.
+ */
+export class ClearedQueueError extends Error {
+    /**
+     * Creates new instance.
+     */
+    constructor(message) {
+        super(message);
+        this.name = 'ClearedQueueError';
+    }
+}
+/**
+ * A queue for async task execution.
+ */
+export default class AsyncQueue {
+    /**
+     * Creates new instance.
+     */
+    constructor() {
+        this._queue = queue(this._processQueueTasks.bind(this), 1);
+        this._stopped = false;
+        this._taskCallbacks = new Map();
+    }
+    /**
+     * Internal task processing implementation which makes things work.
+     */
+    _processQueueTasks(task, finishedCallback) {
+        try {
+            task(finishedCallback);
+        }
+        catch (error) {
+            logger.error(`Task failed: ${error?.stack}`);
+            finishedCallback(error);
+        }
+        finally {
+            this._taskCallbacks.delete(task);
+        }
+    }
+    /**
+     * Removes any pending tasks from the queue.
+     */
+    clear() {
+        for (const finishedCallback of this._taskCallbacks.values()) {
+            try {
+                finishedCallback?.(new ClearedQueueError('The queue has been cleared'));
+            }
+            catch (error) {
+                logger.error('Error in callback while clearing the queue:', error);
+            }
+        }
+        this._queue.kill();
+    }
+    /**
+     * Pauses the execution of the tasks on the queue.
+     */
+    pause() {
+        this._queue.pause();
+    }
+    /**
+     * The 'task' function will be given a callback it MUST call with either:
+     *  1) No arguments if it was successful or
+     *  2) An error argument if there was an error
+     * If the task wants to process the success or failure of the task, it
+     * should pass the {@code callback} to the push function, e.g.:
+     * queue.push(task, (err) => {
+     *     if (err) {
+     *         // error handling
+     *     } else {
+     *         // success handling
+     *     }
+     * });
+     *
+     * @param {Task} task - The task to be executed. See the description above.
+     * @param {TaskCallback} [callback] - Optional callback to be called after the task has been executed.
+     */
+    push(task, callback) {
+        if (this._stopped) {
+            callback && callback(new Error('The queue has been stopped'));
+            return;
+        }
+        this._taskCallbacks.set(task, callback);
+        this._queue.push(task, callback);
+    }
+    /**
+     * Resumes the execution of the tasks on the queue.
+     */
+    resume() {
+        this._queue.resume();
+    }
+    /**
+     * Shutdowns the queue. All already queued tasks will execute, but no future tasks can be added. If a task is added
+     * after the queue has been shutdown then the callback will be called with an error.
+     */
+    shutdown() {
+        this._stopped = true;
+    }
+}
+//# sourceMappingURL=AsyncQueue.js.map

package/dist/esm/modules/util/AsyncQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncQueue.js","sourceRoot":"","sources":["../../../../modules/util/AsyncQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAgC,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,MAAM,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxC;;OAEG;IACH,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AAKD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAK3B;;OAEG;IACH;QACI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAU,EAAE,gBAA8B;QACjE,IAAI,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7C,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK;QACD,KAAK,MAAM,gBAAgB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACD,gBAAgB,EAAE,CAAC,IAAI,iBAAiB,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAC5E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACvE,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,IAAU,EAAE,QAAuB;QACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAE9D,OAAO;QACX,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM;QACF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACJ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzB,CAAC;CACJ"}

package/dist/esm/modules/util/Deferred.js

@@ -0,0 +1,41 @@
+/**
+ * Promise-like object which can be passed around for resolving it later. It
+ * implements the "thenable" interface, so it can be used wherever a Promise
+ * could be used.
+ *
+ * In addition a "reject on timeout" functionality is provided.
+ */
+export default class Deferred {
+    /**
+     * Instantiates a Deferred object.
+     */
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolve = (value) => {
+                this.clearRejectTimeout();
+                resolve(value);
+            };
+            this.reject = (reason) => {
+                this.clearRejectTimeout();
+                reject(reason);
+            };
+        });
+        this.then = this.promise.then.bind(this.promise);
+        this.catch = this.promise.catch.bind(this.promise);
+    }
+    /**
+     * Clears the reject timeout.
+     */
+    clearRejectTimeout() {
+        clearTimeout(this._timeout);
+    }
+    /**
+     * Rejects the promise after the given timeout.
+     */
+    setRejectTimeout(ms) {
+        this._timeout = setTimeout(() => {
+            this.reject(new Error('timeout'));
+        }, ms);
+    }
+}
+//# sourceMappingURL=Deferred.js.map

package/dist/esm/modules/util/Deferred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deferred.js","sourceRoot":"","sources":["../../../../modules/util/Deferred.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;IAQzB;;OAEG;IACH;QACI,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,OAAO,GAAG,CAAC,KAAyB,EAAE,EAAE;gBACzC,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,CAAC,MAAY,EAAE,EAAE;gBAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC1B,MAAM,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,kBAAkB;QACd,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,EAAU;QACvB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IACX,CAAC;CACJ"}

package/dist/esm/modules/util/EventEmitter.js

@@ -0,0 +1,17 @@
+import { EventEmitter as NodeEventEmitter } from 'events';
+/**
+ * The class creates our own EventEmitter instance
+ */
+export default class EventEmitter extends NodeEventEmitter {
+    /**
+     * Creates new instance.
+     * @constructor
+     */
+    constructor() {
+        super();
+        // aliases for addListener/removeListener
+        this.addEventListener = this.addListener;
+        this.removeEventListener = this.removeListener;
+    }
+}
+//# sourceMappingURL=EventEmitter.js.map

package/dist/esm/modules/util/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../../../../modules/util/EventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI1D;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,gBAAgB;IAItD;;;OAGG;IACH;QACI,KAAK,EAAE,CAAC;QAER,yCAAyC;QACzC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC;IACnD,CAAC;CACJ"}

package/dist/esm/modules/util/EventEmitterForwarder.js

@@ -0,0 +1,52 @@
+/**
+ * Implements utility to forward events from one eventEmitter to another.
+ * @param src {object} instance of EventEmitter or another class that implements
+ * addListener method which will register listener to EventEmitter instance.
+ * @param dest {object} instance of EventEmitter or another class that
+ * implements emit method which will emit an event.
+ */
+export default class EventEmitterForwarder {
+    /**
+     * @constructor
+     */
+    constructor(src, dest) {
+        if (!src || !dest || typeof src.addListener !== 'function' || typeof dest.emit !== 'function') {
+            throw new Error('Invalid arguments passed to EventEmitterForwarder');
+        }
+        this.src = src;
+        this.dest = dest;
+        this.listeners = new Map();
+    }
+    /**
+     * Adds event to be forwarded from src to dest.
+     * @param srcEvent {string} the event that EventEmitterForwarder is listening
+     * for.
+     * @param dstEvent {string} the event that will be fired from dest.
+     * @param arguments all other passed arguments are going to be fired with
+     * dstEvent.
+     */
+    forward(...args) {
+        const srcEvent = args[0];
+        // This will be the "this" value for emit function.
+        args[0] = this.dest;
+        // Using bind.apply to pass the arguments as Array-like object ("arguments")
+        const newListener = Function.prototype.bind.apply(this.dest.emit, args);
+        this.src.addListener(srcEvent, newListener);
+        this.listeners.set(srcEvent, newListener);
+    }
+    /**
+     * Clears the listeners for the supplied events.
+     *
+     * @param args all the events which listeners to be cleaned.
+     */
+    removeListeners(...args) {
+        args.forEach(a => {
+            const l = this.listeners.get(a);
+            if (l) {
+                this.src.removeListener(a, l);
+                this.listeners.delete(a);
+            }
+        });
+    }
+}
+//# sourceMappingURL=EventEmitterForwarder.js.map

package/dist/esm/modules/util/EventEmitterForwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitterForwarder.js","sourceRoot":"","sources":["../../../../modules/util/EventEmitterForwarder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IAKtC;;OAEG;IACH,YAAY,GAAQ,EAAE,IAAS;QAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5F,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,IAAI;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,mDAAmD;QACnD,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAEpB,4EAA4E;QAC5E,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAExE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,GAAG,IAAI;QACnB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACb,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAEhC,IAAI,CAAC,EAAE,CAAC;gBACJ,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}