@observertc/observer-js 1.0.0-beta.3 → 1.0.0-beta.5

package/src/common/Middleware.ts

@@ -1,84 +0,0 @@
-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>;
-}
-
-type Callback<T> = (input: T) => void;
-
-class Executor<T> {
-	public done = false;
-	private index = 0;
-	private prevIndex = -1;
-
-	constructor(
-		private readonly stack: Middleware<T>[], 
-		private readonly finalCallback?: Callback<T>
-	) {
-	}
-
-	// Executes the middleware stack
-	public execute(input: T): void {
-		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: T) => this.execute(nextInput));
-		}
-
-		this.done = true;
-		this.finalCallback?.(input);
-	}
-}
-
-export class MiddlewareProcessor<T> implements Processor<T> {
-	private stack: Middleware<T>[] = [];
-	public finalCallback?: Callback<T>;
-
-	public addMiddleware(...middlewares: Middleware<T>[]): Processor<T> {
-		if (middlewares && middlewares.length > 0) {
-			this.stack.push(...middlewares);
-		}
-		
-		return this;
-	}
-
-	public removeMiddleware(...middlewares: Middleware<T>[]): Processor<T> {
-		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 this;
-	}
-
-	public process(value: T): void {
-		if (this.stack.length === 0) {
-			return this.finalCallback?.(value);
-		}
-
-		const executor = new Executor(this.stack, this.finalCallback);
-
-		executor.execute(value);
-	}
-}

package/src/common/SingleExecutor.ts

@@ -1,36 +0,0 @@
-export type SingleExecutor = ReturnType<typeof createSingleExecutor>;
-
-export function createSingleExecutor() {
-	let semaphore = 1;
-	const tasks: (() => Promise<unknown>)[] = [];
-
-	const execute = <T = unknown>(task: () => Promise<T>) => {
-		return new Promise<T>((resolve, reject) => {
-			tasks.push(() => task().then(resolve)
-				.catch(reject));
-			run();
-		});
-	};
-
-	const run = () => {
-		if (semaphore < 1) return;
-
-		const task = tasks.shift();
-
-		if (!task) return;
-
-		const postProcess = () => {
-			++semaphore;
-			run();
-		};
-
-		--semaphore;
-
-		task()
-			.then(postProcess)
-			.catch(postProcess);
-	
-	};
-
-	return execute;
-}

package/src/common/logger.ts

@@ -1,82 +0,0 @@
-export interface Logger {
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	trace(...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	debug(...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	info(...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	warn(...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	error(...args: any[]): void;
-}
-
-export interface ObserverLogger {
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	trace(module: string, ...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	debug(module: string, ...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	info(module: string, ...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	warn(module: string, ...args: any[]): void;
-	/* eslint-disable @typescript-eslint/no-explicit-any */
-	error(module: string, ...args: any[]): void;
-}
-
-let mainLogger: ObserverLogger = new class implements ObserverLogger {
-	trace = () => void 0;
-	// trace(module: string, ...args: any[]) {
-	// 	// eslint-disable-next-line no-console
-	// 	console.log(`[TRACE] ${module}`, ...args);
-	// }
-
-	debug(module: string, ...args: any[]) {
-		// eslint-disable-next-line no-console
-		console.log(`[DEBUG] ${module}`, ...args);
-	}
-
-	info(module: string, ...args: any[]) {
-		// eslint-disable-next-line no-console
-		console.info(`[INFO] ${module}`, ...args);
-	}
-
-	warn(module: string, ...args: any[]) {
-		// eslint-disable-next-line no-console
-		console.warn(`[WARN] ${module}`, ...args);
-	}
-
-	error(module: string, ...args: any[]) {
-		// eslint-disable-next-line no-console
-		console.error(`[ERROR] ${module}`, ...args);
-	}
-}();
-
-export function createLogger(moduleName: string): Logger {
-	return new class implements Logger {
-		trace(...args: any[]) {
-			mainLogger.trace(moduleName, ...args);
-		}
-
-		debug(...args: any[]) {
-			mainLogger.debug(moduleName, ...args);
-		}
-
-		info(...args: any[]) {
-			mainLogger.info(moduleName, ...args);
-		}
-
-		warn(...args: any[]) {
-			mainLogger.warn(moduleName, ...args);
-		}
-
-		error(...args: any[]) {
-			mainLogger.error(moduleName, ...args);
-		}
-
-	}();
-}
-
-export function setObserverLogger(logger: ObserverLogger) {
-	mainLogger = logger;
-}

package/src/common/types.ts

@@ -1,4 +0,0 @@
-export type MediaKind = 'audio' | 'video';
-export type SupportedVideoCodecType = 'vp8' | 'vp9' | 'h264' | 'h265';
-
-// export type EvaluatorMiddleware = Middleware<EvaluatorContext>;

package/src/common/utils.ts

@@ -1,69 +0,0 @@
-export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-
-export type Writable<T> = T extends object ? { -readonly [K in keyof T]: Writable<T[K]> } : T;
-
-export function iteratorConverter<T>(generator: Generator<T, void, undefined>): IterableIterator<T> {
-	return {
-		[Symbol.iterator](): IterableIterator<T> {
-			return this;
-		},
-		next(): IteratorResult<T> {
-			return generator.next();
-		},
-	};
-}
-
-export function asyncIteratorConverter<T>(generator: AsyncGenerator<T, void, undefined>): AsyncIterableIterator<T> {
-	return {
-		[Symbol.asyncIterator](): AsyncIterableIterator<T> {
-			return this;
-		},
-		next(): Promise<IteratorResult<T>> {
-			return generator.next();
-		},
-	};
-}
-
-export function isValidUuid(str: string): boolean {
-	const regexp = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-
-	return regexp.test(str);
-}
-
-export function getAverage(arr: number[], defaultAvgIfArrLengthIs0 = 0): number {
-	if (arr.length === 0) return defaultAvgIfArrLengthIs0;
-	
-	return arr.reduce((a, b) => a + b, 0) / arr.length;
-}
-
-export function getMedian(arr: number[], copyArrayForSorting = true): number {
-	// Sort the array in ascending order
-	const sortedArr = copyArrayForSorting 
-		? arr.slice().sort((a, b) => a - b)
-		: arr.sort((a, b) => a-b)
-
-	;
-
-	// Calculate the middle index
-	const mid = Math.floor(sortedArr.length / 2);
-
-	// If the array length is odd, return the middle element
-	if (sortedArr.length % 2 !== 0) {
-		return sortedArr[mid];
-	}
-
-	// If the array length is even, return the average of the two middle elements
-	return (sortedArr[mid - 1] + sortedArr[mid]) / 2;
-}
-
-export function parseJsonAs<T>(json?: string): T | undefined {
-	if (!json) {
-		return undefined;
-	}
-	
-	try {
-		return JSON.parse(json) as T;
-	} catch (error) {
-		return undefined;
-	}
-}

package/src/detectors/Detector.ts

@@ -1,6 +0,0 @@
-// import { AlertState } from "../ClientMonitor";
-
-export interface Detector {
-	readonly name: string;
-	update(): void;
-}

package/src/detectors/Detectors.ts

@@ -1,38 +0,0 @@
-import { createLogger } from '../common/logger';
-import { Detector } from './Detector';
-
-const logger = createLogger('Detectors');
-
-export class Detectors {
-	private _detectors: Detector[];
-
-	public constructor(...detectors: Detector[]) {
-		this._detectors = detectors;
-	}
-
-	public add(detector: Detector) {
-		this._detectors.push(detector);
-	}
-
-	public remove(detector: Detector) {
-		this._detectors = this._detectors.filter((d) => d !== detector);
-	}
-
-	get listOfNames() {
-		return this._detectors.map((d) => d.name);
-	}
-
-	public update() {
-		for (const detector of this._detectors) {
-			try {
-				detector.update();
-			} catch (err) {
-				logger.warn(`Error updating detector ${detector?.constructor?.name}`, err);
-			}
-		}
-	}
-
-	public clear() {
-		this._detectors = [];
-	}
-}

package/src/index.ts

@@ -1,32 +0,0 @@
-export type { ObserverEvents } from './Observer';
-
-export { Observer } from './Observer';
-export { ObservedCall } from './ObservedCall';
-export { ObservedInboundTrack } from './ObservedInboundTrack';
-export { ObservedOutboundTrack } from './ObservedOutboundTrack';
-export { ObservedClient } from './ObservedClient';
-export { ObservedPeerConnection } from './ObservedPeerConnection';
-export { ObservedMediaSource } from './ObservedMediaSource';
-export { ObservedMediaPlayout } from './ObservedMediaPlayout';
-export { ObservedCodec } from './ObservedCodec';
-export { ObservedCertificate } from './ObservedCertificate';
-export { ObservedDataChannel } from './ObservedDataChannel';
-export { ObservedInboundRtp } from './ObservedInboundRtp';
-export { ObservedOutboundRtp } from './ObservedOutboundRtp';
-export { ObservedRemoteInboundRtp } from './ObservedRemoteInboundRtp';
-export { ObservedRemoteOutboundRtp } from './ObservedRemoteOutboundRtp';
-export { ObservedIceCandidatePair } from './ObservedIceCandidatePair';
-export { ObservedIceCandidate } from './ObservedIceCandidate';
-export { ObservedIceTransport } from './ObservedIceTransport';
-export { ObservedPeerConnectionTransport } from './ObservedPeerConnectionTransport';
-export { ClientEventTypes } from './schema/ClientEventTypes';
-export { ClientMetaTypes } from './schema/ClientMetaTypes';
-export { ClientSample, ClientIssue, ClientEvent, ClientMetaData } from './schema/ClientSample';
-export { ScoreCalculator } from './scores/ScoreCalculator';
-export { ObservedClientEventMonitor } from './ObservedClientEventMonitor';
-export { ObserverEventMonitor } from './ObserverEventMonitor';
-export { Middleware } from './common/Middleware';
-export type {
-	TrackReport,
-	ClientReport,
-} from './Reports';

package/src/mediasoup/ObservedMediaRouter.ts

@@ -1,10 +0,0 @@
-export type Item = {
-	callId: string;
-	appData?: Record<string, unknown>;
-	region: string;
-	publishers: string[];
-	subscribers: string[];
-}
-export class ObservedMediaRouter {
-
-}

package/src/monitors/TurnUsageMonitor.ts

@@ -1,187 +0,0 @@
-// import { EventEmitter } from 'events';
-// import { ObservedPeerConnection } from '../ObservedPeerConnection';
-// import { ObservedICEEvents } from '../ObservedICE';
-// import { ObservedClient } from '../ObservedClient';
-
-// export type TurnUsageMonitorEvents = {
-// 	close: [],
-// 	'newturnip': [string],
-// 	update: [TurnUsage],
-// 	addpeerconnection: [ObservedPeerConnection],
-// 	removepeerconnection: [ObservedPeerConnection],
-// }
-
-// export type TurnUsage = {
-// 	turnIp: string;
-// 	totalBytesSent: number;
-// 	totalBytesReceived: number;
-// 	totalPacketsSent: number;
-// 	totalPacketsReceived: number;
-// }
-
-// export type TurnStats = {
-// 	turnIp: string;
-// 	totalBytesSent: number;
-// 	totalBytesReceived: number;
-// 	totalPacketsSent: number;
-// 	totalPacketsReceived: number;
-// 	deltaBytesSent: number;
-// 	deltaBytesReceived: number;
-// 	timestamp: number;
-// 	outboundBitrate: number;
-// 	inboundBitrate: number;
-// }
-
-// type ObservedConnection = {
-// 	peerConnection: ObservedPeerConnection,
-// 	onUpdate: (...e: ObservedICEEvents['update']) => void;
-
-// }
-
-// export declare interface TurnUsageMonitor {
-// 	on<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
-// 	off<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
-// 	once<U extends keyof TurnUsageMonitorEvents>(event: U, listener: (...args: TurnUsageMonitorEvents[U]) => void): this;
-// 	emit<U extends keyof TurnUsageMonitorEvents>(event: U, ...args: TurnUsageMonitorEvents[U]): boolean;
-// }
-
-// export class TurnUsageMonitor extends EventEmitter {
-// 	private readonly _connections = new Map<string, ObservedConnection>();
-// 	private readonly _turnUsage = new Map<string, TurnUsage>();
-// 	private readonly _stats = new Map<string, TurnStats>();
-
-// 	private _closed = false;
-// 	public constructor() {
-// 		super();
-// 		this.setMaxListeners(Infinity);
-// 	}
-
-// 	public get stats(): TurnStats[] {
-// 		const result: TurnStats[] = [];
-
-// 		for (const [ turnIp, usage ] of this._turnUsage) {
-// 			const stats = this._stats.get(turnIp) ?? {
-// 				turnIp,
-// 				totalBytesSent: 0,
-// 				totalBytesReceived: 0,
-// 				totalPacketsSent: 0,
-// 				totalPacketsReceived: 0,
-// 				deltaBytesSent: 0,
-// 				deltaBytesReceived: 0,
-// 				timestamp: Date.now(),
-// 				outboundBitrate: 0,
-// 				inboundBitrate: 0,
-// 			};
-
-// 			stats.deltaBytesSent = usage.totalBytesSent - stats.totalBytesSent;
-// 			stats.deltaBytesReceived = usage.totalBytesReceived - stats.totalBytesReceived;
-// 			stats.timestamp = Date.now();
-// 			stats.outboundBitrate = (stats.deltaBytesSent * 8) / ((stats.timestamp - stats.timestamp) / 1000.0);
-// 			stats.inboundBitrate = (stats.deltaBytesReceived * 8) / ((stats.timestamp - stats.timestamp) / 1000.0);
-// 			stats.totalBytesSent = usage.totalBytesSent;
-// 			stats.totalBytesReceived = usage.totalBytesReceived;
-// 			stats.totalPacketsSent = usage.totalPacketsSent;
-// 			stats.totalPacketsReceived = usage.totalPacketsReceived;
-
-// 			this._stats.set(turnIp, stats);
-
-// 			result.push(stats);
-// 		}
-
-// 		return result;
-// 	}
-
-// 	public addPeerConnection(peerConnection: ObservedPeerConnection) {
-// 		if (this.closed) return;
-// 		if (this._connections.has(peerConnection.peerConnectionId)) return;
-
-// 		const ice = peerConnection.ICE;
-
-// 		const onUpdate = () => {
-// 			const turnIp = ice?.selectedRemoteCandidate?.address;
-			
-// 			if (!peerConnection.usingTURN || !turnIp) return;
-			
-// 			let usage = this._turnUsage.get(turnIp);
-
-// 			if (!usage) {
-// 				usage = {
-// 					turnIp,
-// 					totalBytesSent: 0,
-// 					totalBytesReceived: 0,
-// 					totalPacketsSent: 0,
-// 					totalPacketsReceived: 0,
-// 				};
-// 				this._turnUsage.set(turnIp, usage);
-
-// 				this.emit('newturnip', turnIp);
-// 			}
-			
-// 			usage.totalBytesSent += ice.deltaBytesSent;
-// 			usage.totalBytesReceived += ice.deltaBytesReceived;
-// 			usage.totalPacketsSent += ice.deltaPacketsSent;
-// 			usage.totalPacketsReceived += ice.deltaPacketsReceived;
-
-// 			this.emit('update', usage);
-// 		};
-
-// 		peerConnection.ICE.on('update', onUpdate);
-
-// 		this._connections.set(peerConnection.peerConnectionId, {
-// 			peerConnection,
-// 			onUpdate
-// 		});
-
-// 		this.emit('addpeerconnection', peerConnection);
-// 	}
-
-// 	public removePeerConnection(peerConnection: ObservedPeerConnection) {
-// 		if (this.closed) return;
-// 		if (!this._connections.has(peerConnection.peerConnectionId)) return;
-
-// 		const { onUpdate } = this._connections.get(peerConnection.peerConnectionId) ?? {};
-		
-// 		if (!onUpdate) return;
-
-// 		peerConnection.ICE.off('update', onUpdate);
-
-// 		this._connections.delete(peerConnection.peerConnectionId);
-
-// 		this.emit('removepeerconnection', peerConnection);
-// 	}
-
-// 	public get turnIps() {
-// 		return Array.from(this._turnUsage.keys());
-// 	}
-
-// 	public get peerConnections() {
-// 		return Array.from(this._connections.values()).map(({ peerConnection }) => peerConnection);
-// 	}
-
-// 	public getUsage(turnIp: string) {
-// 		return this._turnUsage.get(turnIp);
-// 	}
-
-// 	public get clients(): ReadonlyMap<string, ObservedClient> {
-// 		const result = new Map<string, ObservedClient>();
-
-// 		for (const pc of this.peerConnections) {
-// 			if (result.has(pc.clientId)) continue;
-			
-// 			result.set(pc.clientId, pc.client);
-// 		}
-
-// 		return result;
-// 	}
-
-// 	public get closed() {
-// 		return this._closed;
-// 	}
-
-// 	public close() {
-// 		if (this._closed) return;
-// 		this._closed = true;
-
-// 		this.emit('close');
-// 	}
-// }