@vpalmisano/webrtcperf 4.4.9 → 4.4.11

package/build/src/docker.js

@@ -9,29 +9,40 @@ const utils_1 = require("./utils");
 const config_1 = require("./config");
 const throttler_1 = require("@vpalmisano/throttler");
 const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
 const log = (0, utils_1.logger)('webrtcperf:docker');
 async function runWithDocker(argv) {
     const docker = new dockerode_1.default();
     const configPath = argv[0];
     if (!configPath)
         throw new Error('No configuration file specified');
-    const config = (await (0, config_1.loadConfig)(configPath))[0];
+    const configs = await (0, config_1.loadConfig)(configPath);
+    if (!configs.length)
+        throw new Error('Failed to load configuration file');
     const startTimestamp = Date.now();
     const dataDir = process.cwd();
-    const binds = ['/dev/shm:/dev/shm', `${dataDir}:/data`, '/tmp/webrtcperf-cache:/root/.webrtcperf'];
+    const tmpDir = os_1.default.tmpdir();
+    const jsonConfigPath = `${tmpDir}/webrtcperf-config-${startTimestamp}.json`;
+    await fs_1.default.promises.writeFile(jsonConfigPath, JSON.stringify(configs), 'utf-8');
+    const binds = [
+        '/dev/shm:/dev/shm',
+        `${dataDir}:/data`,
+        `${tmpDir}/webrtcperf-cache:/root/.webrtcperf`,
+        `${jsonConfigPath}:/tmp/config.json:ro`,
+    ];
     if (process.env.DEBUG_SRC) {
         binds.push(`${(0, utils_1.resolvePackagePath)('app.min.js')}:/app/app.min.js:ro`);
     }
     const portBindings = {};
     const exposedPorts = {};
-    if (config.debuggingPort) {
-        for (let i = 0; i < config.sessions; i++) {
-            const port = `${config.debuggingPort + i}/tcp`;
-            portBindings[port] = [{ HostPort: `${config.debuggingPort + i}` }];
+    if (configs[0].debuggingPort) {
+        for (let i = 0; i < configs[0].sessions; i++) {
+            const port = `${configs[0].debuggingPort + i}/tcp`;
+            portBindings[port] = [{ HostPort: `${configs[0].debuggingPort + i}` }];
             exposedPorts[port] = {};
         }
     }
-    if (config.throttleConfig && os_1.default.platform() === 'linux') {
+    if (configs[0].throttleConfig && os_1.default.platform() === 'linux') {
         await (0, throttler_1.runShellCommand)('sudo modprobe ifb numifbs=1');
     }
     const env = [
@@ -43,19 +54,21 @@ async function runWithDocker(argv) {
         'SERVER_DATA=/data',
         `START_TIMESTAMP=${startTimestamp}`,
     ];
-    if (config.prometheusPushgateway.startsWith('http://localhost')) {
+    if (configs[0].prometheusPushgateway.startsWith('http://localhost')) {
         env.push('PROMETHEUS_PUSHGATEWAY=http://pushgateway:9091');
     }
     const containerConfig = {
         Image: 'ghcr.io/vpalmisano/webrtcperf:devel',
         name: 'webrtcperf',
         WorkingDir: '/data',
-        Cmd: argv,
+        Cmd: ['/tmp/config.json'],
         HostConfig: {
             Binds: binds,
             PortBindings: portBindings,
-            CapAdd: config.throttleConfig && os_1.default.platform() === 'linux' ? ['NET_ADMIN'] : [],
-            NetworkMode: config.prometheusPushgateway.startsWith('http://localhost') ? 'prometheus-stack_default' : 'bridge',
+            CapAdd: configs[0].throttleConfig && os_1.default.platform() === 'linux' ? ['NET_ADMIN'] : [],
+            NetworkMode: configs[0].prometheusPushgateway.startsWith('http://localhost')
+                ? 'prometheus-stack_default'
+                : 'bridge',
             ExtraHosts: process.env.EXTRA_HOSTS ? process.env.EXTRA_HOSTS.split(',').map(h => h.trim()) : [],
         },
         Env: env,
@@ -103,5 +116,6 @@ async function runWithDocker(argv) {
         log.error('Docker operation failed:', error);
         throw error;
     }
+    await fs_1.default.promises.unlink(jsonConfigPath);
 }
 //# sourceMappingURL=docker.js.map

package/build/src/docker.js.map

@@ -1 +1 @@
-{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/docker.ts"],"names":[],"mappings":"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","sourcesContent":["import Docker from 'dockerode'\nimport { logger, resolvePackagePath } from './utils'\nimport { loadConfig } from './config'\nimport { runShellCommand } from '@vpalmisano/throttler'\nimport os from 'os'\n\nconst log = logger('webrtcperf:docker')\n\nexport async function runWithDocker(argv: string[]) {\n  const docker = new Docker()\n  const configPath = argv[0]\n  if (!configPath) throw new Error('No configuration file specified')\n  const config = (await loadConfig(configPath))[0]\n\n  const startTimestamp = Date.now()\n  const dataDir = process.cwd()\n\n  const binds: string[] = ['/dev/shm:/dev/shm', `${dataDir}:/data`, '/tmp/webrtcperf-cache:/root/.webrtcperf']\n\n  if (process.env.DEBUG_SRC) {\n    binds.push(`${resolvePackagePath('app.min.js')}:/app/app.min.js:ro`)\n  }\n\n  const portBindings: Docker.PortMap = {}\n  const exposedPorts: { [portAndProtocol: string]: object } = {}\n  if (config.debuggingPort) {\n    for (let i = 0; i < config.sessions; i++) {\n      const port = `${config.debuggingPort + i}/tcp`\n      portBindings[port] = [{ HostPort: `${config.debuggingPort + i}` }]\n      exposedPorts[port] = {}\n    }\n  }\n\n  if (config.throttleConfig && os.platform() === 'linux') {\n    await runShellCommand('sudo modprobe ifb numifbs=1')\n  }\n\n  const env = [\n    `DEBUG_LEVEL=${process.env.DEBUG_LEVEL || 'info'}`,\n    'SHOW_PAGE_LOG=false',\n    'SHOW_STATS=false',\n    'SERVER_PORT=5000',\n    'SERVER_USE_HTTPS=true',\n    'SERVER_DATA=/data',\n    `START_TIMESTAMP=${startTimestamp}`,\n  ]\n\n  if (config.prometheusPushgateway.startsWith('http://localhost')) {\n    env.push('PROMETHEUS_PUSHGATEWAY=http://pushgateway:9091')\n  }\n\n  const containerConfig: Docker.ContainerCreateOptions = {\n    Image: 'ghcr.io/vpalmisano/webrtcperf:devel',\n    name: 'webrtcperf',\n    WorkingDir: '/data',\n    Cmd: argv,\n    HostConfig: {\n      Binds: binds,\n      PortBindings: portBindings,\n      CapAdd: config.throttleConfig && os.platform() === 'linux' ? ['NET_ADMIN'] : [],\n      NetworkMode: config.prometheusPushgateway.startsWith('http://localhost') ? 'prometheus-stack_default' : 'bridge',\n      ExtraHosts: process.env.EXTRA_HOSTS ? process.env.EXTRA_HOSTS.split(',').map(h => h.trim()) : [],\n    },\n    Env: env,\n    AttachStdin: true,\n    AttachStdout: true,\n    AttachStderr: true,\n    Tty: true,\n    OpenStdin: true,\n    StdinOnce: true,\n    ExposedPorts: exposedPorts,\n  }\n\n  try {\n    if (!process.env.DEBUG_SRC) {\n      log.info('Pulling latest webrtcperf image...')\n      await docker.pull('ghcr.io/vpalmisano/webrtcperf:devel')\n    }\n\n    try {\n      const existingContainer = await docker.getContainer('webrtcperf')\n      await existingContainer.remove({ force: true })\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    } catch (err: unknown) {\n      // Container doesn't exist, continue\n    }\n\n    const container = await docker.createContainer(containerConfig)\n    await container.start()\n\n    const stream = await container.attach({\n      stream: true,\n      stdin: true,\n      stdout: true,\n      stderr: true,\n    })\n\n    process.stdin.pipe(stream)\n    stream.pipe(process.stdout)\n\n    await new Promise(resolve => {\n      container.wait((err: Error, data: { StatusCode: number }) => {\n        if (err) log.error('Error waiting for container:', data, err.stack)\n        resolve(data)\n      })\n    })\n\n    await container.remove()\n  } catch (error) {\n    log.error('Docker operation failed:', error)\n    throw error\n  }\n}\n"]}
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/docker.ts"],"names":[],"mappings":"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","sourcesContent":["import Docker from 'dockerode'\nimport { logger, resolvePackagePath } from './utils'\nimport { loadConfig } from './config'\nimport { runShellCommand } from '@vpalmisano/throttler'\nimport os from 'os'\nimport fs from 'fs'\n\nconst log = logger('webrtcperf:docker')\n\nexport async function runWithDocker(argv: string[]) {\n  const docker = new Docker()\n  const configPath = argv[0]\n  if (!configPath) throw new Error('No configuration file specified')\n  const configs = await loadConfig(configPath)\n  if (!configs.length) throw new Error('Failed to load configuration file')\n\n  const startTimestamp = Date.now()\n  const dataDir = process.cwd()\n  const tmpDir = os.tmpdir()\n\n  const jsonConfigPath = `${tmpDir}/webrtcperf-config-${startTimestamp}.json`\n  await fs.promises.writeFile(jsonConfigPath, JSON.stringify(configs), 'utf-8')\n\n  const binds: string[] = [\n    '/dev/shm:/dev/shm',\n    `${dataDir}:/data`,\n    `${tmpDir}/webrtcperf-cache:/root/.webrtcperf`,\n    `${jsonConfigPath}:/tmp/config.json:ro`,\n  ]\n\n  if (process.env.DEBUG_SRC) {\n    binds.push(`${resolvePackagePath('app.min.js')}:/app/app.min.js:ro`)\n  }\n\n  const portBindings: Docker.PortMap = {}\n  const exposedPorts: { [portAndProtocol: string]: object } = {}\n  if (configs[0].debuggingPort) {\n    for (let i = 0; i < configs[0].sessions; i++) {\n      const port = `${configs[0].debuggingPort + i}/tcp`\n      portBindings[port] = [{ HostPort: `${configs[0].debuggingPort + i}` }]\n      exposedPorts[port] = {}\n    }\n  }\n\n  if (configs[0].throttleConfig && os.platform() === 'linux') {\n    await runShellCommand('sudo modprobe ifb numifbs=1')\n  }\n\n  const env = [\n    `DEBUG_LEVEL=${process.env.DEBUG_LEVEL || 'info'}`,\n    'SHOW_PAGE_LOG=false',\n    'SHOW_STATS=false',\n    'SERVER_PORT=5000',\n    'SERVER_USE_HTTPS=true',\n    'SERVER_DATA=/data',\n    `START_TIMESTAMP=${startTimestamp}`,\n  ]\n\n  if (configs[0].prometheusPushgateway.startsWith('http://localhost')) {\n    env.push('PROMETHEUS_PUSHGATEWAY=http://pushgateway:9091')\n  }\n\n  const containerConfig: Docker.ContainerCreateOptions = {\n    Image: 'ghcr.io/vpalmisano/webrtcperf:devel',\n    name: 'webrtcperf',\n    WorkingDir: '/data',\n    Cmd: ['/tmp/config.json'],\n    HostConfig: {\n      Binds: binds,\n      PortBindings: portBindings,\n      CapAdd: configs[0].throttleConfig && os.platform() === 'linux' ? ['NET_ADMIN'] : [],\n      NetworkMode: configs[0].prometheusPushgateway.startsWith('http://localhost')\n        ? 'prometheus-stack_default'\n        : 'bridge',\n      ExtraHosts: process.env.EXTRA_HOSTS ? process.env.EXTRA_HOSTS.split(',').map(h => h.trim()) : [],\n    },\n    Env: env,\n    AttachStdin: true,\n    AttachStdout: true,\n    AttachStderr: true,\n    Tty: true,\n    OpenStdin: true,\n    StdinOnce: true,\n    ExposedPorts: exposedPorts,\n  }\n\n  try {\n    if (!process.env.DEBUG_SRC) {\n      log.info('Pulling latest webrtcperf image...')\n      await docker.pull('ghcr.io/vpalmisano/webrtcperf:devel')\n    }\n\n    try {\n      const existingContainer = await docker.getContainer('webrtcperf')\n      await existingContainer.remove({ force: true })\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    } catch (err: unknown) {\n      // Container doesn't exist, continue\n    }\n\n    const container = await docker.createContainer(containerConfig)\n    await container.start()\n\n    const stream = await container.attach({\n      stream: true,\n      stdin: true,\n      stdout: true,\n      stderr: true,\n    })\n\n    process.stdin.pipe(stream)\n    stream.pipe(process.stdout)\n\n    await new Promise(resolve => {\n      container.wait((err: Error, data: { StatusCode: number }) => {\n        if (err) log.error('Error waiting for container:', data, err.stack)\n        resolve(data)\n      })\n    })\n\n    await container.remove()\n  } catch (error) {\n    log.error('Docker operation failed:', error)\n    throw error\n  }\n\n  await fs.promises.unlink(jsonConfigPath)\n}\n"]}

package/build/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from './app';
 export * from './config';
+export * from './docker';
 export * from './media';
 export * from './rtcstats';
 export * from './server';
@@ -7,3 +8,4 @@ export * from './session';
 export * from './stats';
 export * from './utils';
 export * from './vmaf';
+export * from './scenarios';

package/build/src/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./app"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./docker"), exports);
 __exportStar(require("./media"), exports);
 __exportStar(require("./rtcstats"), exports);
 __exportStar(require("./server"), exports);
@@ -23,4 +24,5 @@ __exportStar(require("./session"), exports);
 __exportStar(require("./stats"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./vmaf"), exports);
+__exportStar(require("./scenarios"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB;AACrB,2CAAwB;AACxB,0CAAuB;AACvB,6CAA0B;AAC1B,2CAAwB;AACxB,4CAAyB;AACzB,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB","sourcesContent":["export * from './app'\nexport * from './config'\nexport * from './media'\nexport * from './rtcstats'\nexport * from './server'\nexport * from './session'\nexport * from './stats'\nexport * from './utils'\nexport * from './vmaf'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB;AACrB,2CAAwB;AACxB,2CAAwB;AACxB,0CAAuB;AACvB,6CAA0B;AAC1B,2CAAwB;AACxB,4CAAyB;AACzB,0CAAuB;AACvB,0CAAuB;AACvB,yCAAsB;AACtB,8CAA2B","sourcesContent":["export * from './app'\nexport * from './config'\nexport * from './docker'\nexport * from './media'\nexport * from './rtcstats'\nexport * from './server'\nexport * from './session'\nexport * from './stats'\nexport * from './utils'\nexport * from './vmaf'\nexport * from './scenarios'\n"]}

package/build/src/scenarios.d.ts

@@ -0,0 +1,166 @@
+import { FastStats } from './stats';
+import { ThrottleRule } from '@vpalmisano/throttler';
+/**
+ * It parses a CSV stats file and returns an array of objects representing each row.
+ * @param filePath The path to the CSV stats file.
+ * @returns An array of objects where each object represents a row in the CSV file with keys as column headers.
+ */
+export declare function parseStatsFile(filePath: string): Promise<Record<string, string | number>[]>;
+export type StatsSummary = {
+    timestamp: number;
+    id: string;
+    scenario: string;
+    videoRecvBitratePerPixel: FastStats;
+    videoRecvFps: FastStats;
+    videoSentFps: FastStats;
+};
+/**
+ * It aggregates the stats summary from multiple test runs in a directory.
+ * @param options.dirPath Directory path containing test run subdirectories. Default is 'logs'.
+ * @param options.senderParticipantName Participant name of the sender. Default is 'Participant-000001'.
+ * @param options.receiverParticipantName Participant name of the receiver. Default is 'Participant-000000'.
+ * @param options.nameParser Function to parse test directory names. Default splits by '_' and extracts id and scenario.
+ * @returns Array of aggregated stats including timestamp, id, scenario, videoRecvBitratePerPixel, videoRecvFps, and videoSentFps.
+ */
+export declare function aggregateStatsSummary({ dirPath, senderParticipantName, receiverParticipantName, nameParser, }: {
+    dirPath?: string | undefined;
+    senderParticipantName?: string | undefined;
+    receiverParticipantName?: string | undefined;
+    nameParser?: ((name: string) => {
+        id: string;
+        scenario: string;
+    }) | undefined;
+}): Promise<StatsSummary[]>;
+/**
+ * It uploads the aggregated stats to a Google Sheet.
+ * A valid Google service account credentials file must be specified
+ * in the `GOOGLE_CREDENTIALS_PATH` environment variable.
+ * @param stats The aggregated stats to upload.
+ * @param spreadsheetId The ID of the Google Spreadsheet.
+ * @param table The name of the table (sheet) within the spreadsheet. Default is 'data'.
+ */
+export declare function uploadStatsToGoogleSheet(stats: StatsSummary[], spreadsheetId: string, table?: string): Promise<void>;
+export type ThrottleDirection = 'up' | 'down' | 'bidi';
+export declare function formatThrottleRule(throttleRule: ThrottleRule & {
+    direction: ThrottleDirection;
+}, human?: boolean): string;
+export declare function parseThrottleRule(throttleDesc: string): {
+    direction: ThrottleDirection;
+    rate: number;
+    loss: number;
+    delay: number;
+};
+/**
+ * It generates a test configuration with a scenario including 2 participants.
+ * The first participant sends video and the second receives it.
+ * Both participants send and receive audio.
+ * The network conditions are applied according to the specified direction to the sender (`up`),
+ * the receiver (`down`) or both (`bidi`).
+ * The test is repeated the specified number of times.
+ * The output is an array of partial configuration objects that can be used to run the tests
+ * with the main application, after merging it with a configuration that includes
+ * the destination url (mandatory) and other optional parameters.
+ * @param id The unique identifier for the test scenario.
+ * @param options.rate The target bandwidth in kbps.
+ * @param options.loss The packet loss percentage.
+ * @param options.delay The network delay in milliseconds.
+ * @param options.direction The direction of the network throttling: 'up', 'down', or 'bidi'.
+ * @param repeat The number of times to repeat the test scenario. Default is 1.
+ * @returns An array of partial configuration objects for each test scenario.
+ */
+export declare function twoParticipantsWithRateLossDelay(id: string, { rate, loss, delay, direction }: {
+    rate: number;
+    loss: number;
+    delay: number;
+    direction: ThrottleDirection;
+}, repeat: 1): Promise<Partial<{
+    url: string;
+    urlQuery: string;
+    customUrlHandler: string;
+    videoPath: string;
+    videoWidth: number;
+    videoHeight: number;
+    videoFramerate: number;
+    videoSeek: number;
+    videoDuration: number;
+    videoCacheRaw: boolean;
+    videoCachePath: string;
+    videoFormat: string;
+    useFakeMedia: boolean;
+    runDuration: number;
+    throttleConfig: string;
+    useBrowserThrottling: boolean;
+    randomAudioPeriod: number;
+    randomAudioProbability: number;
+    randomAudioRange: string;
+    chromiumPath: string;
+    chromiumVersion: any;
+    chromiumUrl: string;
+    chromiumFieldTrials: string;
+    windowWidth: number;
+    windowHeight: number;
+    deviceScaleFactor: number;
+    maxVideoDecoders: number;
+    maxVideoDecodersRange: string;
+    incognito: boolean;
+    display: string;
+    sessions: number;
+    tabsPerSession: number;
+    startSessionId: number;
+    startTimestamp: number;
+    enableDetailedStats: string;
+    spawnRate: number;
+    showPageLog: boolean;
+    pageLogFilter: string;
+    pageLogPath: string;
+    enableBrowserLogging: string;
+    userAgent: string;
+    scriptPath: string;
+    scriptParams: string;
+    disabledVideoCodecs: string;
+    localStorage: string;
+    sessionStorage: string;
+    clearCookies: boolean;
+    enableGpu: string;
+    blockedUrls: string;
+    extraHeaders: string;
+    responseModifiers: string;
+    downloadResponses: string;
+    extraCSS: string;
+    cookies: string;
+    overridePermissions: string;
+    hardwareConcurrency: number;
+    debuggingPort: number;
+    debuggingAddress: string;
+    emulateCpuThrottling: number;
+    showStats: boolean;
+    statsPath: string;
+    detailedStatsPath: string;
+    statsInterval: number;
+    rtcStatsTimeout: number;
+    customMetrics: string;
+    prometheusPushgateway: string;
+    prometheusPushgatewayJobName: string;
+    prometheusPushgatewayAuth: string;
+    prometheusPushgatewayGzip: boolean;
+    alertRules: string;
+    alertRulesOutput: string;
+    alertRulesFailPercentile: number;
+    pushStatsUrl: string;
+    pushStatsId: string;
+    serverPort: number;
+    serverSecret: string;
+    serverUseHttps: boolean;
+    serverData: string;
+    vmafPath: string;
+    vmafPreview: boolean;
+    vmafKeepIntermediateFiles: boolean;
+    vmafKeepSourceFiles: boolean;
+    vmafSkipDuplicated: boolean;
+    vmafCrop: string;
+    vmafPrepareVideo: string;
+    vmafProcessVideo: string;
+    vmafVideoCrop: string;
+    visqolPath: string;
+    visqolKeepSourceFiles: boolean;
+}>[]>;

package/build/src/scenarios.js

@@ -0,0 +1,245 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStatsFile = parseStatsFile;
+exports.aggregateStatsSummary = aggregateStatsSummary;
+exports.uploadStatsToGoogleSheet = uploadStatsToGoogleSheet;
+exports.formatThrottleRule = formatThrottleRule;
+exports.parseThrottleRule = parseThrottleRule;
+exports.twoParticipantsWithRateLossDelay = twoParticipantsWithRateLossDelay;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const stats_1 = require("./stats");
+const googleapis_1 = require("googleapis");
+const utils_1 = require("./utils");
+const log = (0, utils_1.logger)('webrtcperf:scenarios');
+/**
+ * It parses a CSV stats file and returns an array of objects representing each row.
+ * @param filePath The path to the CSV stats file.
+ * @returns An array of objects where each object represents a row in the CSV file with keys as column headers.
+ */
+async function parseStatsFile(filePath) {
+    log.debug(`parseStatsFile: ${filePath}`);
+    const fileData = await fs_1.default.promises.readFile(filePath, 'utf-8');
+    const lines = fileData.split('\n');
+    const headers = lines[0].split(',');
+    const data = lines.slice(1).map(line => line.split(',').reduce((acc, value, index) => {
+        if (value !== '') {
+            acc[headers[index]] = isNaN(Number(value)) ? value : Number(value);
+        }
+        return acc;
+    }, {}));
+    return data;
+}
+/**
+ * It aggregates the stats summary from multiple test runs in a directory.
+ * @param options.dirPath Directory path containing test run subdirectories. Default is 'logs'.
+ * @param options.senderParticipantName Participant name of the sender. Default is 'Participant-000001'.
+ * @param options.receiverParticipantName Participant name of the receiver. Default is 'Participant-000000'.
+ * @param options.nameParser Function to parse test directory names. Default splits by '_' and extracts id and scenario.
+ * @returns Array of aggregated stats including timestamp, id, scenario, videoRecvBitratePerPixel, videoRecvFps, and videoSentFps.
+ */
+async function aggregateStatsSummary({ dirPath = 'logs', senderParticipantName = 'Participant-000001', receiverParticipantName = 'Participant-000000', nameParser = (name) => {
+    const [_, id, scenario] = name.split('_');
+    return { id, scenario };
+}, }) {
+    log.debug(`aggregateStatsSummary: ${dirPath}`);
+    const stats = [];
+    const results = await fs_1.default.promises.readdir(dirPath);
+    for (const test of results) {
+        const filePath = path_1.default.join(dirPath, test, 'detailed-stats-summary.csv');
+        if (!fs_1.default.existsSync(filePath))
+            continue;
+        const timestamp = fs_1.default.statSync(path_1.default.join(dirPath, test)).ctime.getTime();
+        const data = await parseStatsFile(filePath);
+        const { id, scenario } = nameParser(test);
+        const aggregated = {
+            timestamp,
+            id,
+            scenario,
+            videoRecvBitratePerPixel: new stats_1.FastStats(),
+            videoRecvFps: new stats_1.FastStats(),
+            videoSentFps: new stats_1.FastStats(),
+        };
+        data.forEach(v => {
+            const { participantName, trackId } = v;
+            const metrics = v;
+            if (participantName === receiverParticipantName) {
+                if (trackId?.endsWith('-v') && metrics.videoRecvFrames > 0) {
+                    const videoRecvBitratePerPixel = metrics.videoRecvBitrates / (metrics.videoRecvWidth * metrics.videoRecvHeight);
+                    if (!isNaN(videoRecvBitratePerPixel))
+                        aggregated.videoRecvBitratePerPixel.push(videoRecvBitratePerPixel);
+                    if (!isNaN(metrics.videoRecvFps))
+                        aggregated.videoRecvFps.push(metrics.videoRecvFps);
+                }
+            }
+            else if (participantName === senderParticipantName) {
+                if (trackId?.endsWith('-v') && metrics.videoSentFrames > 0) {
+                    if (!isNaN(metrics.videoSentFps))
+                        aggregated.videoSentFps.push(metrics.videoSentFps);
+                }
+            }
+        });
+        stats.push(aggregated);
+    }
+    return stats.sort((a, b) => a.timestamp - b.timestamp);
+}
+/**
+ * It uploads the aggregated stats to a Google Sheet.
+ * A valid Google service account credentials file must be specified
+ * in the `GOOGLE_CREDENTIALS_PATH` environment variable.
+ * @param stats The aggregated stats to upload.
+ * @param spreadsheetId The ID of the Google Spreadsheet.
+ * @param table The name of the table (sheet) within the spreadsheet. Default is 'data'.
+ */
+async function uploadStatsToGoogleSheet(stats, spreadsheetId, table = 'data') {
+    log.debug(`uploadResultsToGoogleSheet spreadsheetId: ${spreadsheetId} table: ${table}`);
+    if (!process.env.GOOGLE_CREDENTIALS_PATH)
+        throw new Error('GOOGLE_CREDENTIALS_PATH environment variable is not set');
+    if (!fs_1.default.existsSync(process.env.GOOGLE_CREDENTIALS_PATH))
+        throw new Error(`Google credentials file not found: ${process.env.GOOGLE_CREDENTIALS_PATH}`);
+    if (!stats.length)
+        return;
+    const auth = new googleapis_1.Auth.GoogleAuth({
+        keyFile: process.env.GOOGLE_CREDENTIALS_PATH,
+        scopes: ['https://www.googleapis.com/auth/spreadsheets'],
+    });
+    const sheets = googleapis_1.google.sheets({ version: 'v4', auth });
+    // Update headers.
+    const headers = ['datetime', 'id', 'scenario', 'videoRecvBitratePerPixel', 'videoRecvFps'];
+    await sheets.spreadsheets.values.update({
+        spreadsheetId,
+        range: `${table}!A1:E1`,
+        valueInputOption: 'USER_ENTERED',
+        requestBody: { majorDimension: 'ROWS', values: [headers] },
+    });
+    // Append values.
+    const values = [];
+    stats.forEach(s => {
+        const { timestamp, id, scenario, videoRecvBitratePerPixel, videoRecvFps } = s;
+        if (!videoRecvBitratePerPixel.length)
+            return;
+        const datetime = new Date(timestamp).toLocaleString('en-US', {
+            timeZone: 'UTC',
+            hourCycle: 'h23',
+        });
+        values.push([
+            datetime,
+            id,
+            formatThrottleRule(parseThrottleRule(scenario), true),
+            videoRecvBitratePerPixel.percentile(95).toFixed(3),
+            videoRecvFps.percentile(95).toFixed(3),
+        ]);
+    });
+    if (values.length) {
+        await sheets.spreadsheets.values.append({
+            spreadsheetId,
+            range: `${table}!A:E`,
+            valueInputOption: 'USER_ENTERED',
+            insertDataOption: 'INSERT_ROWS',
+            requestBody: { majorDimension: 'ROWS', values },
+        });
+    }
+}
+function formatBitrate(bitrate, prefix = ' ') {
+    if (bitrate === undefined)
+        return '';
+    let suffix = 'Kbps';
+    if (bitrate >= 10000) {
+        bitrate /= 1000;
+        suffix = 'Mbps';
+    }
+    return `${prefix}${bitrate.toFixed(0)}${suffix}`.padStart(8, ' ');
+}
+function formatLoss(loss, prefix = ' ') {
+    return loss !== undefined ? `${prefix}${loss.toFixed(0).padStart(2, ' ')}%` : '';
+}
+function formatDelay(delay, prefix = ' ') {
+    return delay !== undefined ? `${prefix}${delay.toFixed(0).padStart(3, ' ')}ms` : '';
+}
+function formatThrottleRule(throttleRule, human = false) {
+    const { rate, loss, delay, direction } = throttleRule;
+    return human
+        ? `${direction.padEnd(4, ' ')}${formatBitrate(rate)}${formatLoss(loss)}${formatDelay(delay)}`
+        : `${direction}-r${rate}-l${loss}-d${delay}`;
+}
+function parseThrottleRule(throttleDesc) {
+    const match = throttleDesc.match(/(up|down|bidi)-r(\d+)-l([\d.]+)-d(\d+)/);
+    if (!match)
+        throw new Error(`Invalid throttle description: ${throttleDesc}`);
+    const direction = match[1];
+    const rate = parseInt(match[2]);
+    const loss = parseInt(match[3]);
+    const delay = parseInt(match[4]);
+    return { direction, rate, loss, delay };
+}
+/**
+ * It generates a test configuration with a scenario including 2 participants.
+ * The first participant sends video and the second receives it.
+ * Both participants send and receive audio.
+ * The network conditions are applied according to the specified direction to the sender (`up`),
+ * the receiver (`down`) or both (`bidi`).
+ * The test is repeated the specified number of times.
+ * The output is an array of partial configuration objects that can be used to run the tests
+ * with the main application, after merging it with a configuration that includes
+ * the destination url (mandatory) and other optional parameters.
+ * @param id The unique identifier for the test scenario.
+ * @param options.rate The target bandwidth in kbps.
+ * @param options.loss The packet loss percentage.
+ * @param options.delay The network delay in milliseconds.
+ * @param options.direction The direction of the network throttling: 'up', 'down', or 'bidi'.
+ * @param repeat The number of times to repeat the test scenario. Default is 1.
+ * @returns An array of partial configuration objects for each test scenario.
+ */
+async function twoParticipantsWithRateLossDelay(id, { rate, loss, delay, direction }, repeat) {
+    const throttle = {};
+    const queue = 25;
+    if (direction === 'down' || direction === 'bidi') {
+        throttle.down = [
+            { rate: 20000, loss: 0, delay: 0, queue },
+            { rate, loss, delay, queue, at: 30 },
+        ];
+    }
+    if (direction === 'up' || direction === 'bidi') {
+        throttle.up = [
+            { rate: 20000, loss: 0, delay, queue },
+            { rate, loss, delay, queue, at: 30 },
+        ];
+    }
+    const throttleDesc = formatThrottleRule({ rate, loss, delay, direction });
+    const now = Date.now();
+    const ret = [];
+    for (let i = 0; i < repeat; i++) {
+        const basePath = `logs/${now}-${i + 1}_${id}_${throttleDesc}`;
+        const sessions = direction === 'bidi' ? '0-1' : direction === 'down' ? '0' : '1';
+        ret.push({
+            sessions: 2,
+            runDuration: 60 * 3,
+            debuggingPort: 9000,
+            prometheusPushgateway: 'http://localhost:9091',
+            prometheusPushgatewayJobName: id,
+            statsPath: `${basePath}/stats.csv`,
+            detailedStatsPath: `${basePath}/detailed-stats.csv`,
+            showPageLog: false,
+            showStats: false,
+            statsInterval: 5,
+            scriptParams: JSON.stringify({
+                enableMic: '0-1',
+                enableCam: '1',
+            }),
+            throttleConfig: JSON.stringify([
+                {
+                    sessions,
+                    protocol: 'udp',
+                    skipSourcePorts: '53,80,443',
+                    skipDestinationPorts: '53,80,443',
+                    ...throttle,
+                },
+            ]),
+        });
+    }
+    return ret;
+}
+//# sourceMappingURL=scenarios.js.map

package/build/src/scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.js","sourceRoot":"","sources":["../../src/scenarios.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs'\nimport path from 'path'\nimport { FastStats } from './stats'\nimport { ThrottleConfig, ThrottleRule } from '@vpalmisano/throttler'\nimport { Config } from './config'\nimport { Auth, google } from 'googleapis'\nimport { logger } from './utils'\n\nconst log = logger('webrtcperf:scenarios')\n\n/**\n * It parses a CSV stats file and returns an array of objects representing each row.\n * @param filePath The path to the CSV stats file.\n * @returns An array of objects where each object represents a row in the CSV file with keys as column headers.\n */\nexport async function parseStatsFile(filePath: string) {\n  log.debug(`parseStatsFile: ${filePath}`)\n  const fileData = await fs.promises.readFile(filePath, 'utf-8')\n  const lines = fileData.split('\\n')\n  const headers = lines[0].split(',')\n  const data = lines.slice(1).map(line =>\n    line.split(',').reduce(\n      (acc, value, index) => {\n        if (value !== '') {\n          acc[headers[index]] = isNaN(Number(value)) ? value : Number(value)\n        }\n        return acc\n      },\n      {} as Record<string, string | number>,\n    ),\n  )\n  return data\n}\n\nexport type StatsSummary = {\n  timestamp: number\n  id: string\n  scenario: string\n  videoRecvBitratePerPixel: FastStats\n  videoRecvFps: FastStats\n  videoSentFps: FastStats\n}\n\n/**\n * It aggregates the stats summary from multiple test runs in a directory.\n * @param options.dirPath Directory path containing test run subdirectories. Default is 'logs'.\n * @param options.senderParticipantName Participant name of the sender. Default is 'Participant-000001'.\n * @param options.receiverParticipantName Participant name of the receiver. Default is 'Participant-000000'.\n * @param options.nameParser Function to parse test directory names. Default splits by '_' and extracts id and scenario.\n * @returns Array of aggregated stats including timestamp, id, scenario, videoRecvBitratePerPixel, videoRecvFps, and videoSentFps.\n */\nexport async function aggregateStatsSummary({\n  dirPath = 'logs',\n  senderParticipantName = 'Participant-000001',\n  receiverParticipantName = 'Participant-000000',\n  nameParser = (name: string) => {\n    const [_, id, scenario] = name.split('_')\n    return { id, scenario }\n  },\n}) {\n  log.debug(`aggregateStatsSummary: ${dirPath}`)\n  const stats: StatsSummary[] = []\n  const results = await fs.promises.readdir(dirPath)\n  for (const test of results) {\n    const filePath = path.join(dirPath, test, 'detailed-stats-summary.csv')\n    if (!fs.existsSync(filePath)) continue\n    const timestamp = fs.statSync(path.join(dirPath, test)).ctime.getTime()\n    const data = await parseStatsFile(filePath)\n    const { id, scenario } = nameParser(test)\n\n    const aggregated = {\n      timestamp,\n      id,\n      scenario,\n      videoRecvBitratePerPixel: new FastStats(),\n      videoRecvFps: new FastStats(),\n      videoSentFps: new FastStats(),\n    }\n    data.forEach(v => {\n      const { participantName, trackId } = v as { participantName: string; trackId: string }\n      const metrics = v as Record<string, number>\n      if (participantName === receiverParticipantName) {\n        if (trackId?.endsWith('-v') && metrics.videoRecvFrames > 0) {\n          const videoRecvBitratePerPixel =\n            metrics.videoRecvBitrates / (metrics.videoRecvWidth * metrics.videoRecvHeight)\n          if (!isNaN(videoRecvBitratePerPixel)) aggregated.videoRecvBitratePerPixel.push(videoRecvBitratePerPixel)\n          if (!isNaN(metrics.videoRecvFps)) aggregated.videoRecvFps.push(metrics.videoRecvFps)\n        }\n      } else if (participantName === senderParticipantName) {\n        if (trackId?.endsWith('-v') && metrics.videoSentFrames > 0) {\n          if (!isNaN(metrics.videoSentFps)) aggregated.videoSentFps.push(metrics.videoSentFps)\n        }\n      }\n    })\n    stats.push(aggregated)\n  }\n  return stats.sort((a, b) => a.timestamp - b.timestamp)\n}\n\n/**\n * It uploads the aggregated stats to a Google Sheet.\n * A valid Google service account credentials file must be specified\n * in the `GOOGLE_CREDENTIALS_PATH` environment variable.\n * @param stats The aggregated stats to upload.\n * @param spreadsheetId The ID of the Google Spreadsheet.\n * @param table The name of the table (sheet) within the spreadsheet. Default is 'data'.\n */\nexport async function uploadStatsToGoogleSheet(stats: StatsSummary[], spreadsheetId: string, table = 'data') {\n  log.debug(`uploadResultsToGoogleSheet spreadsheetId: ${spreadsheetId} table: ${table}`)\n  if (!process.env.GOOGLE_CREDENTIALS_PATH) throw new Error('GOOGLE_CREDENTIALS_PATH environment variable is not set')\n  if (!fs.existsSync(process.env.GOOGLE_CREDENTIALS_PATH))\n    throw new Error(`Google credentials file not found: ${process.env.GOOGLE_CREDENTIALS_PATH}`)\n  if (!stats.length) return\n  const auth = new Auth.GoogleAuth({\n    keyFile: process.env.GOOGLE_CREDENTIALS_PATH,\n    scopes: ['https://www.googleapis.com/auth/spreadsheets'],\n  })\n  const sheets = google.sheets({ version: 'v4', auth })\n  // Update headers.\n  const headers = ['datetime', 'id', 'scenario', 'videoRecvBitratePerPixel', 'videoRecvFps']\n  await sheets.spreadsheets.values.update({\n    spreadsheetId,\n    range: `${table}!A1:E1`,\n    valueInputOption: 'USER_ENTERED',\n    requestBody: { majorDimension: 'ROWS', values: [headers] },\n  })\n  // Append values.\n  const values = [] as string[][]\n  stats.forEach(s => {\n    const { timestamp, id, scenario, videoRecvBitratePerPixel, videoRecvFps } = s\n    if (!videoRecvBitratePerPixel.length) return\n    const datetime = new Date(timestamp).toLocaleString('en-US', {\n      timeZone: 'UTC',\n      hourCycle: 'h23',\n    })\n    values.push([\n      datetime,\n      id,\n      formatThrottleRule(parseThrottleRule(scenario), true),\n      videoRecvBitratePerPixel.percentile(95).toFixed(3),\n      videoRecvFps.percentile(95).toFixed(3),\n    ])\n  })\n  if (values.length) {\n    await sheets.spreadsheets.values.append({\n      spreadsheetId,\n      range: `${table}!A:E`,\n      valueInputOption: 'USER_ENTERED',\n      insertDataOption: 'INSERT_ROWS',\n      requestBody: { majorDimension: 'ROWS', values },\n    })\n  }\n}\n\nexport type ThrottleDirection = 'up' | 'down' | 'bidi'\n\nfunction formatBitrate(bitrate: number | undefined, prefix = ' ') {\n  if (bitrate === undefined) return ''\n  let suffix = 'Kbps'\n  if (bitrate >= 10000) {\n    bitrate /= 1000\n    suffix = 'Mbps'\n  }\n  return `${prefix}${bitrate.toFixed(0)}${suffix}`.padStart(8, ' ')\n}\n\nfunction formatLoss(loss: number | undefined, prefix = ' ') {\n  return loss !== undefined ? `${prefix}${loss.toFixed(0).padStart(2, ' ')}%` : ''\n}\n\nfunction formatDelay(delay: number | undefined, prefix = ' ') {\n  return delay !== undefined ? `${prefix}${delay.toFixed(0).padStart(3, ' ')}ms` : ''\n}\n\nexport function formatThrottleRule(throttleRule: ThrottleRule & { direction: ThrottleDirection }, human = false) {\n  const { rate, loss, delay, direction } = throttleRule\n  return human\n    ? `${direction.padEnd(4, ' ')}${formatBitrate(rate)}${formatLoss(loss)}${formatDelay(delay)}`\n    : `${direction}-r${rate}-l${loss}-d${delay}`\n}\n\nexport function parseThrottleRule(throttleDesc: string) {\n  const match = throttleDesc.match(/(up|down|bidi)-r(\\d+)-l([\\d.]+)-d(\\d+)/)\n  if (!match) throw new Error(`Invalid throttle description: ${throttleDesc}`)\n  const direction = match[1] as ThrottleDirection\n  const rate = parseInt(match[2])\n  const loss = parseInt(match[3])\n  const delay = parseInt(match[4])\n  return { direction, rate, loss, delay }\n}\n\n/**\n * It generates a test configuration with a scenario including 2 participants.\n * The first participant sends video and the second receives it.\n * Both participants send and receive audio.\n * The network conditions are applied according to the specified direction to the sender (`up`),\n * the receiver (`down`) or both (`bidi`).\n * The test is repeated the specified number of times.\n * The output is an array of partial configuration objects that can be used to run the tests\n * with the main application, after merging it with a configuration that includes\n * the destination url (mandatory) and other optional parameters.\n * @param id The unique identifier for the test scenario.\n * @param options.rate The target bandwidth in kbps.\n * @param options.loss The packet loss percentage.\n * @param options.delay The network delay in milliseconds.\n * @param options.direction The direction of the network throttling: 'up', 'down', or 'bidi'.\n * @param repeat The number of times to repeat the test scenario. Default is 1.\n * @returns An array of partial configuration objects for each test scenario.\n */\nexport async function twoParticipantsWithRateLossDelay(\n  id: string,\n  { rate, loss, delay, direction }: { rate: number; loss: number; delay: number; direction: ThrottleDirection },\n  repeat: 1,\n) {\n  const throttle: ThrottleConfig = {}\n  const queue = 25\n  if (direction === 'down' || direction === 'bidi') {\n    throttle.down = [\n      { rate: 20000, loss: 0, delay: 0, queue },\n      { rate, loss, delay, queue, at: 30 },\n    ]\n  }\n  if (direction === 'up' || direction === 'bidi') {\n    throttle.up = [\n      { rate: 20000, loss: 0, delay, queue },\n      { rate, loss, delay, queue, at: 30 },\n    ]\n  }\n  const throttleDesc = formatThrottleRule({ rate, loss, delay, direction })\n  const now = Date.now()\n  const ret: Partial<Config>[] = []\n  for (let i = 0; i < repeat; i++) {\n    const basePath = `logs/${now}-${i + 1}_${id}_${throttleDesc}`\n    const sessions = direction === 'bidi' ? '0-1' : direction === 'down' ? '0' : '1'\n    ret.push({\n      sessions: 2,\n      runDuration: 60 * 3,\n      debuggingPort: 9000,\n      prometheusPushgateway: 'http://localhost:9091',\n      prometheusPushgatewayJobName: id,\n      statsPath: `${basePath}/stats.csv`,\n      detailedStatsPath: `${basePath}/detailed-stats.csv`,\n      showPageLog: false,\n      showStats: false,\n      statsInterval: 5,\n      scriptParams: JSON.stringify({\n        enableMic: '0-1',\n        enableCam: '1',\n      }),\n      throttleConfig: JSON.stringify([\n        {\n          sessions,\n          protocol: 'udp',\n          skipSourcePorts: '53,80,443',\n          skipDestinationPorts: '53,80,443',\n          ...throttle,\n        },\n      ]),\n    })\n  }\n  return ret\n}\n"]}

package/build/src/utils.d.ts

@@ -1,5 +1,4 @@
 import { Session } from './session';
-import { FastStats } from './stats';
 export declare function logger(name: string, options?: {}): any;
 /**
  * Resolves the absolute path from the package installation directory.
@@ -235,21 +234,4 @@ export declare function analyzeColors(fpath: string): Promise<{
  */
 export declare function waitStopProcess(pid: number, timeout?: number): Promise<boolean>;
 export declare function getDockerLogsPath(): Promise<string>;
-export declare function parseStatsFile(filePath: string): Promise<Record<string, string | number>[]>;
-export declare function aggregateStatsSummary({ dirPath, senderParticipantName, receiverParticipantName, nameParser, }: {
-    dirPath?: string | undefined;
-    senderParticipantName?: string | undefined;
-    receiverParticipantName?: string | undefined;
-    nameParser?: ((name: string) => {
-        destination: string;
-        scenario: string;
-    }) | undefined;
-}): Promise<{
-    timestamp: number;
-    destination: string;
-    scenario: string;
-    videoRecvBitratePerPixel: FastStats;
-    videoRecvFps: FastStats;
-    videoSentFps: FastStats;
-}[]>;
 export {};