@observertc/observer-js 0.42.9 → 1.0.1-28c6425.0

package/lib/Observer.js

@@ -1,255 +1,179 @@
 "use strict";
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Observer = void 0;
 const logger_1 = require("./common/logger");
 const ObservedCall_1 = require("./ObservedCall");
-const ReportsCollector_1 = require("./ReportsCollector");
 const events_1 = require("events");
-const callEventReports_1 = require("./common/callEventReports");
-const ObservedSfu_1 = require("./ObservedSfu");
-const CallSummaryMonitor_1 = require("./monitors/CallSummaryMonitor");
-const TurnUsageMonitor_1 = require("./monitors/TurnUsageMonitor");
-const ClientIssueMonitor_1 = require("./monitors/ClientIssueMonitor");
-const SfuServerMonitor_1 = require("./monitors/SfuServerMonitor");
+const ObservedTURN_1 = require("./ObservedTURN");
+const Detectors_1 = require("./detectors/Detectors");
+const OnIntervalUpdater_1 = require("./updaters/OnIntervalUpdater");
+const OnAllCallObserverUpdater_1 = require("./updaters/OnAllCallObserverUpdater_");
+const OnAnyCallObserverUpdater_1 = require("./updaters/OnAnyCallObserverUpdater_");
 const logger = (0, logger_1.createLogger)('Observer');
 class Observer extends events_1.EventEmitter {
-    static create(providedConfig) {
-        const config = Object.assign({
-            defaultServiceId: 'default-service-id',
-            defaultMediaUnitId: 'default-media-unit-id',
-            evaluator: {
-                fetchSamples: true,
-                maxIdleTimeInMs: 300 * 1000,
-            },
-            sink: {},
-            logLevel: 'info',
-        }, providedConfig);
-        return new Observer(config);
+    config;
+    detectors;
+    observedTURN = new ObservedTURN_1.ObservedTURN();
+    observedCalls = new Map();
+    updater;
+    closed = false;
+    totalAddedCall = 0;
+    totalRemovedCall = 0;
+    totalRttLt50Measurements = 0;
+    totalRttLt150Measurements = 0;
+    totalRttLt300Measurements = 0;
+    totalRttGtOrEq300Measurements = 0;
+    totalClientIssues = 0;
+    numberOfClientsUsedTurn = 0;
+    numberOfClients = 0;
+    numberOfInboundRtpStreams = 0;
+    numberOfOutboundRtpStreams = 0;
+    numberOfDataChannels = 0;
+    numberOfPeerConnections = 0;
+    get numberOfCalls() {
+        return this.observedCalls.size;
     }
-    constructor(config) {
+    _timer;
+    constructor(config = {
+        updatePolicy: 'update-when-all-call-updated',
+        updateIntervalInMs: undefined,
+    }) {
         super();
         this.config = config;
-        this.reports = new ReportsCollector_1.ReportsCollector();
-        this._observedCalls = new Map();
-        this._observedSfus = new Map();
-        this._monitors = new Map();
-        this._closed = false;
         this.setMaxListeners(Infinity);
-        logger.debug('Observer is created with config', this.config);
-        const onReports = (context) => this.emit('reports', context);
-        const onNewReport = (collectedReports) => {
-            if (!this.config.maxReports || this._closed)
-                return;
-            if (this.config.maxReports < collectedReports) {
-                this._emitReports();
+        this.update = this.update.bind(this);
+        if (this.config.updateIntervalInMs) {
+            if (this.config.updatePolicy && this.config.updatePolicy !== 'update-on-interval') {
+                throw new Error('update policy must be update-on-interval if updateIntervalInMs is set in config');
             }
-        };
-        this._emitReports();
-        this.once('close', () => {
-            this.reports.off('newreport', onNewReport);
-            this.reports.off('reports', onReports);
-        });
-        this.reports.on('newreport', onNewReport);
-        this.reports.on('reports', onReports);
-    }
-    createObservedCall(config) {
-        if (this._closed) {
-            throw new Error('Attempted to create a call source on a closed observer');
+            this._timer = setInterval(this.update.bind(this), this.config.updateIntervalInMs);
         }
-        const { appData, reportCallEnded = true, reportCallStarted = true } = config, model = __rest(config, ["appData", "reportCallEnded", "reportCallStarted"]);
-        const call = new ObservedCall_1.ObservedCall(Object.assign(Object.assign({}, model), { serviceId: this.config.defaultServiceId }), this, appData);
-        if (this._closed)
-            throw new Error('Cannot create an observed call on a closed observer');
-        if (this._observedCalls.has(call.callId))
-            throw new Error(`Observed Call with id ${call.callId} already exists`);
-        call.once('close', () => {
-            var _a;
-            this._observedCalls.delete(call.callId);
-            reportCallEnded && this.reports.addCallEventReport((0, callEventReports_1.createCallEndedEventReport)(call.serviceId, call.roomId, call.callId, (_a = call.observationEnded) !== null && _a !== void 0 ? _a : Date.now()));
-        });
-        this._observedCalls.set(call.callId, call);
-        reportCallStarted && this.reports.addCallEventReport((0, callEventReports_1.createCallStartedEventReport)(call.serviceId, call.roomId, call.callId, call.observationStarted));
-        this.emit('newcall', call);
-        return call;
-    }
-    createObservedSfu(model, appData) {
-        if (this._closed) {
-            throw new Error('Attempted to create an sfu source on a closed observer');
+        if (this.config.updateIntervalInMs) {
+            if (this.config.updatePolicy !== 'update-on-interval') {
+                throw new Error('updatePolicy must be update-on-interval if updateIntervalInMs is set in config');
+            }
         }
-        const sfu = new ObservedSfu_1.ObservedSfu(model, this, appData);
-        if (this._closed)
-            throw new Error('Cannot create an observed sfu on a closed observer');
-        if (this._observedSfus.has(sfu.sfuId))
-            throw new Error(`Observed SFU with id ${sfu.sfuId} already exists`);
-        sfu.once('close', () => {
-            this._observedSfus.delete(sfu.sfuId);
-        });
-        this._observedSfus.set(sfu.sfuId, sfu);
-        this.emit('newsfu', sfu);
-        return sfu;
-    }
-    createCallSummaryMonitor(options) {
-        if (this._closed)
-            throw new Error('Cannot create a call summary monitor on a closed observer');
-        const existingMonitor = this._monitors.get(CallSummaryMonitor_1.CallSummaryMonitor.name);
-        if (existingMonitor)
-            return existingMonitor;
-        const monitor = new CallSummaryMonitor_1.CallSummaryMonitor(options);
-        const onNewCall = (call) => {
-            monitor.addCall(call);
-            call.once('close', () => {
-                var _a;
-                return setTimeout(() => {
-                    const summary = monitor.takeSummary(call.callId);
-                    summary && monitor.emit('summary', summary);
-                }, (_a = options === null || options === void 0 ? void 0 : options.timeoutAfterCallClose) !== null && _a !== void 0 ? _a : 1000);
-            });
-        };
-        monitor.once('close', () => {
-            this._monitors.delete(CallSummaryMonitor_1.CallSummaryMonitor.name);
-            this.off('newcall', onNewCall);
-        });
-        this._monitors.set(CallSummaryMonitor_1.CallSummaryMonitor.name, monitor);
-        this.on('newcall', onNewCall);
-        this.once('close', () => {
-            monitor.close();
-        });
-        return monitor;
+        switch (this.config.updatePolicy) {
+            case 'update-on-any-call-updated':
+                this.updater = new OnAllCallObserverUpdater_1.OnAllCallObserverUpdater(this);
+                break;
+            case 'update-when-all-call-updated':
+                this.updater = new OnAnyCallObserverUpdater_1.OnAnyCallObserverUpdater(this);
+                break;
+            case 'update-on-interval':
+                if (!this.config.updateIntervalInMs) {
+                    throw new Error('updateIntervalInMs setting in config must be set if updatePolicy is update-on-interval');
+                }
+                this.updater = new OnIntervalUpdater_1.OnIntervalUpdater(this.config.updateIntervalInMs, this.update.bind(this));
+                break;
+        }
+        this.detectors = new Detectors_1.Detectors();
     }
-    createTurnUsageMonitor() {
-        if (this._closed)
-            throw new Error('Cannot create a turn usage monitor on a closed observer');
-        const existingMonitor = this._monitors.get(TurnUsageMonitor_1.TurnUsageMonitor.name);
-        if (existingMonitor)
-            return existingMonitor;
-        const monitor = new TurnUsageMonitor_1.TurnUsageMonitor();
-        const onNewCall = (call) => {
-            const onNewClient = (client) => {
-                const onNewPeerConnection = (pc) => {
-                    const onUsingTurnChanged = (usingTurn) => {
-                        if (usingTurn)
-                            monitor.addPeerConnection(pc);
-                        else
-                            monitor.removePeerConnection(pc);
-                    };
-                    pc.once('close', () => {
-                        pc.ICE.off('usingturnchanged', onUsingTurnChanged);
-                        monitor.removePeerConnection(pc);
-                    });
-                    pc.ICE.on('usingturnchanged', onUsingTurnChanged);
-                };
-                client.once('close', () => client.off('newpeerconnection', onNewPeerConnection));
-                client.on('newpeerconnection', onNewPeerConnection);
-            };
-            call.once('close', () => call.off('newclient', onNewClient));
-            call.on('newclient', onNewClient);
-        };
-        monitor.once('close', () => {
-            this._monitors.delete(TurnUsageMonitor_1.TurnUsageMonitor.name);
-            this.off('newcall', onNewCall);
-        });
-        this._monitors.set(TurnUsageMonitor_1.TurnUsageMonitor.name, monitor);
-        this.on('newcall', onNewCall);
-        this.once('close', () => {
-            monitor.close();
-        });
-        return monitor;
+    getObservedCall(callId) {
+        if (this.closed || !this.observedCalls.has(callId))
+            return;
+        return this.observedCalls.get(callId);
     }
-    createSfuServerMonitor() {
-        if (this._closed)
-            throw new Error('Cannot create a turn usage monitor on a closed observer');
-        const existingMonitor = this._monitors.get(SfuServerMonitor_1.SfuServerMonitor.name);
-        if (existingMonitor)
-            return existingMonitor;
-        const monitor = new SfuServerMonitor_1.SfuServerMonitor({
-            tooHighRttAlertSettings: {
-                minNumberOfPeerConnections: 10,
-                percentageOfPeerConnectionsHighWatermark: 0.5,
-                percentageOfPeerConnectionsLowWatermark: 0.2,
-                threshold: 'rtt-gt-300',
-            }
-        });
-        const onNewCall = (call) => {
-            const onNewClient = (client) => {
-                const onNewPeerConnection = (pc) => {
-                    monitor.addPeerConnection(pc);
-                };
-                client.once('close', () => client.off('newpeerconnection', onNewPeerConnection));
-                client.on('newpeerconnection', onNewPeerConnection);
-            };
-            call.once('close', () => call.off('newclient', onNewClient));
-            call.on('newclient', onNewClient);
-        };
-        monitor.once('close', () => {
-            this._monitors.delete(SfuServerMonitor_1.SfuServerMonitor.name);
-            this.off('newcall', onNewCall);
-        });
-        this._monitors.set(SfuServerMonitor_1.SfuServerMonitor.name, monitor);
-        this.on('newcall', onNewCall);
-        this.once('close', () => {
-            monitor.close();
-        });
-        return monitor;
-    }
-    createClientIssueMonitor() {
-        if (this._closed)
-            throw new Error('Cannot create a turn usage monitor on a closed observer');
-        const existingMonitor = this._monitors.get(ClientIssueMonitor_1.ClientIssueMonitor.name);
-        if (existingMonitor)
-            return existingMonitor;
-        const monitor = new ClientIssueMonitor_1.ClientIssueMonitor();
-        const onNewCall = (call) => monitor.addCall(call);
-        monitor.once('close', () => {
-            this._monitors.delete(ClientIssueMonitor_1.ClientIssueMonitor.name);
-            this.off('newcall', onNewCall);
-        });
-        this._monitors.set(ClientIssueMonitor_1.ClientIssueMonitor.name, monitor);
-        this.on('newcall', onNewCall);
-        this.once('close', () => {
-            monitor.close();
+    createObservedCall(settings) {
+        if (this.closed) {
+            throw new Error('Attempted to create a call source on a closed observer');
+        }
+        if (!settings.updatePolicy) {
+            settings.updatePolicy = this.config.defaultCallUpdatePolicy;
+            settings.updateIntervalInMs = this.config.defaultCallUpdateIntervalInMs;
+        }
+        const observedCall = new ObservedCall_1.ObservedCall(settings, this);
+        const onCallUpdated = () => this._onObservedCallUpdated(observedCall);
+        if (this.observedCalls.has(observedCall.callId))
+            throw new Error(`Observed Call with id ${observedCall.callId} already exists`);
+        observedCall.once('close', () => {
+            this.observedCalls.delete(observedCall.callId);
+            observedCall.off('update', onCallUpdated);
+            ++this.totalRemovedCall;
         });
-        return monitor;
-    }
-    get observedCalls() {
-        return this._observedCalls;
-    }
-    get observedSfus() {
-        return this._observedSfus;
-    }
-    get closed() {
-        return this._closed;
+        this.observedCalls.set(observedCall.callId, observedCall);
+        observedCall.on('update', onCallUpdated);
+        ++this.totalAddedCall;
+        this.emit('newcall', observedCall);
+        return observedCall;
     }
     close() {
-        if (this._closed) {
+        if (this.closed) {
             return logger.debug('Attempted to close twice');
         }
-        this._closed = true;
-        this._observedCalls.forEach((call) => call.close());
+        this.closed = true;
+        clearInterval(this._timer);
+        this._timer = undefined;
+        this.observedCalls.forEach((call) => call.close());
         this.emit('close');
     }
-    _emitReports() {
-        if (this._reportTimer) {
-            clearTimeout(this._reportTimer);
-            this._reportTimer = undefined;
+    accept(sample) {
+        if (this.closed)
+            return;
+        if (!sample.callId)
+            return logger.warn('Received sample without callId. %o', sample);
+        if (!sample.clientId)
+            return logger.warn('Received sample without clientId %o', sample);
+        const call = this.getObservedCall(sample.callId) ?? this.createObservedCall({
+            callId: sample.callId,
+            updateIntervalInMs: this.config.defaultCallUpdateIntervalInMs,
+            updatePolicy: this.config.defaultCallUpdatePolicy,
+        });
+        const client = call.getObservedClient(sample.clientId) ?? call.createObservedClient({
+            clientId: sample.clientId,
+        });
+        client.accept(sample);
+    }
+    update() {
+        if (this.closed) {
+            return;
         }
-        this.reports.emit();
-        if (this.config.maxCollectingTimeInMs) {
-            this._reportTimer = setTimeout(() => {
-                this._reportTimer = undefined;
-                this._emitReports();
-            }, this.config.maxCollectingTimeInMs);
+        this.numberOfInboundRtpStreams = 0;
+        this.numberOfOutboundRtpStreams = 0;
+        this.numberOfPeerConnections = 0;
+        this.numberOfDataChannels = 0;
+        this.numberOfClients = 0;
+        this.numberOfClientsUsedTurn = 0;
+        for (const call of this.observedCalls.values()) {
+            this.numberOfInboundRtpStreams += call.numberOfInboundRtpStreams;
+            this.numberOfOutboundRtpStreams += call.numberOfOutboundRtpStreams;
+            this.numberOfPeerConnections += call.numberOfPeerConnections;
+            this.numberOfDataChannels += call.numberOfDataChannels;
+            this.numberOfClients += call.numberOfClients;
+            this.numberOfClientsUsedTurn += call.clientsUsedTurn.size;
         }
+        this.observedTURN.update();
+        this.emit('update');
+    }
+    _onObservedCallUpdated(call) {
+        this.totalRttLt50Measurements += call.deltaRttLt50Measurements;
+        this.totalRttLt150Measurements += call.deltaRttLt150Measurements;
+        this.totalRttLt300Measurements += call.deltaRttLt300Measurements;
+        this.totalRttGtOrEq300Measurements += call.deltaRttGtOrEq300Measurements;
+        this.totalClientIssues += call.deltaNumberOfIssues;
+    }
+    resetSummaryMetrics() {
+        this.totalAddedCall = 0;
+        this.totalRemovedCall = 0;
+        this.totalRttLt50Measurements = 0;
+        this.totalRttLt150Measurements = 0;
+        this.totalRttLt300Measurements = 0;
+        this.totalRttGtOrEq300Measurements = 0;
+        this.totalClientIssues = 0;
+    }
+    createSummary() {
+        return {
+            totalAddedCall: this.totalAddedCall,
+            totalRemovedCall: this.totalRemovedCall,
+            totalRttLt50Measurements: this.totalRttLt50Measurements,
+            totalRttLt150Measurements: this.totalRttLt150Measurements,
+            totalRttLt300Measurements: this.totalRttLt300Measurements,
+            totalRttGtOrEq300Measurements: this.totalRttGtOrEq300Measurements,
+            totalClientIssues: this.totalClientIssues,
+            currentActiveCalls: this.observedCalls.size,
+            currentNumberOfClients: this.numberOfClients,
+            currentNumberOfClientsUsingTURN: this.numberOfClientsUsedTurn,
+        };
     }
 }
 exports.Observer = Observer;

package/lib/ObserverSummary.d.ts

@@ -0,0 +1,13 @@
+export type ObserverSummary = {
+    currentActiveCalls: number;
+    currentNumberOfClientsUsingTURN: number;
+    currentNumberOfClients: number;
+    totalAddedCall: number;
+    totalRemovedCall: number;
+    totalRttLt50Measurements: number;
+    totalRttLt150Measurements: number;
+    totalRttLt300Measurements: number;
+    totalRttGtOrEq300Measurements: number;
+    totalClientIssues: number;
+};
+//# sourceMappingURL=ObserverSummary.d.ts.map

package/lib/ObserverSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserverSummary.d.ts","sourceRoot":"","sources":["../src/ObserverSummary.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+BAA+B,EAAE,MAAM,CAAC;IACxC,sBAAsB,EAAE,MAAM,CAAC;IAE/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,EAAE,MAAM,CAAC;IAEtC,iBAAiB,EAAE,MAAM,CAAC;CAC1B,CAAA"}

package/lib/ObserverSummary.js

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

package/lib/common/Middleware.d.ts

@@ -1,8 +1,17 @@
 export type Middleware<T> = (input: T, next: (nextInput: T) => void) => void;
 export interface Processor<T> {
+    finalCallback?: Callback<T>;
     process(value: T): void;
     addMiddleware(...middlewares: Middleware<T>[]): Processor<T>;
     removeMiddleware(...middlewares: Middleware<T>[]): Processor<T>;
 }
-export declare function createProcessor<T>(): Processor<T>;
+type Callback<T> = (input: T) => void;
+export declare class MiddlewareProcessor<T> implements Processor<T> {
+    private stack;
+    finalCallback?: Callback<T>;
+    addMiddleware(...middlewares: Middleware<T>[]): Processor<T>;
+    removeMiddleware(...middlewares: Middleware<T>[]): Processor<T>;
+    process(value: T): void;
+}
+export {};
 //# sourceMappingURL=Middleware.d.ts.map

package/lib/common/Middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Middleware.d.ts","sourceRoot":"","sources":["../../src/common/Middleware.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAC3B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,KACxB,IAAI,CAAC;AAEV,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7D,gBAAgB,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,wBAAgB,eAAe,CAAC,CAAC,KAC9B,SAAS,CAAC,CAAC,CAAC,CA2Cd"}
+{"version":3,"file":"Middleware.d.ts","sourceRoot":"","sources":["../../src/common/Middleware.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAC3B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,KACxB,IAAI,CAAC;AAEV,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7D,gBAAgB,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAoCtC,qBAAa,mBAAmB,CAAC,CAAC,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAuB;IAC7B,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5B,aAAa,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAQ5D,gBAAgB,CAAC,GAAG,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IAc/D,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAS9B"}

package/lib/common/Middleware.js

@@ -1,41 +1,60 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createProcessor = void 0;
-function createProcessor() {
-    const stack = [];
-    const result = {
-        addMiddleware: (...middlewares) => {
-            if (middlewares && 0 < middlewares.length) {
-                stack.push(...middlewares);
-            }
-            return result;
-        },
-        removeMiddleware: (...middlewares) => {
-            if (middlewares && 0 < middlewares.length) {
-                for (const process of middlewares) {
-                    const index = stack.indexOf(process);
-                    if (0 < index)
-                        stack.splice(index, 1);
+exports.MiddlewareProcessor = void 0;
+class Executor {
+    stack;
+    finalCallback;
+    done = false;
+    index = 0;
+    prevIndex = -1;
+    constructor(stack, finalCallback) {
+        this.stack = stack;
+        this.finalCallback = finalCallback;
+    }
+    // Executes the middleware stack
+    execute(input) {
+        if (this.index <= this.prevIndex) {
+            throw new Error('Middleware must call next() only once!');
+        }
+        else if (this.done) {
+            throw new Error('Middleware stack has already been executed!');
+        }
+        this.prevIndex = this.index;
+        const middleware = this.stack[this.index];
+        this.index++;
+        if (middleware) {
+            return middleware(input, (nextInput) => this.execute(nextInput));
+        }
+        this.done = true;
+        this.finalCallback?.(input);
+    }
+}
+class MiddlewareProcessor {
+    stack = [];
+    finalCallback;
+    addMiddleware(...middlewares) {
+        if (middlewares && middlewares.length > 0) {
+            this.stack.push(...middlewares);
+        }
+        return this;
+    }
+    removeMiddleware(...middlewares) {
+        if (middlewares && middlewares.length > 0) {
+            for (const middleware of middlewares) {
+                const index = this.stack.indexOf(middleware);
+                if (index >= 0) {
+                    this.stack.splice(index, 1);
                 }
             }
-            return result;
-        },
-        process: (value) => {
-            let prevIndex = -1;
-            const execute = (index, input) => {
-                if (index <= prevIndex) {
-                    throw new Error('middleware must call next() only once!');
-                }
-                prevIndex = index;
-                const middleware = stack[index];
-                if (!middleware)
-                    return;
-                const next = (nextInput) => execute(index + 1, nextInput);
-                return middleware(input, next);
-            };
-            return execute(0, value);
-        },
-    };
-    return result;
+        }
+        return this;
+    }
+    process(value) {
+        if (this.stack.length === 0) {
+            return this.finalCallback?.(value);
+        }
+        const executor = new Executor(this.stack, this.finalCallback);
+        executor.execute(value);
+    }
 }
-exports.createProcessor = createProcessor;
+exports.MiddlewareProcessor = MiddlewareProcessor;

package/lib/common/logger.d.ts

@@ -1,4 +1,3 @@
-export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent';
 export interface Logger {
     trace(...args: any[]): void;
     debug(...args: any[]): void;
@@ -6,8 +5,13 @@ export interface Logger {
     warn(...args: any[]): void;
     error(...args: any[]): void;
 }
-export declare function setLogLevel(level: LogLevel): void;
-export declare const getLogLevel: () => LogLevel;
-export declare function forwardLogsTo(logger: Logger | null): void;
+export interface ObserverLogger {
+    trace(module: string, ...args: any[]): void;
+    debug(module: string, ...args: any[]): void;
+    info(module: string, ...args: any[]): void;
+    warn(module: string, ...args: any[]): void;
+    error(module: string, ...args: any[]): void;
+}
 export declare function createLogger(moduleName: string): Logger;
+export declare function setObserverLogger(logger: ObserverLogger): void;
 //# sourceMappingURL=logger.d.ts.map

package/lib/common/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/common/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,MAAM;IAEtB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC5B;AAiBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAO1C;AAED,eAAO,MAAM,WAAW,gBAEvB,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,QAElD;AAcD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA+BvD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/common/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IAEtB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAE9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC5C;AA8BD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAuBvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,QAEvD"}