@vpalmisano/webrtcperf 4.4.10 → 4.4.11

package/build/src/scenarios.d.ts

@@ -1,6 +1,27 @@
 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;
@@ -9,23 +30,45 @@ export declare function aggregateStatsSummary({ dirPath, senderParticipantName,
         id: string;
         scenario: string;
     }) | undefined;
-}): Promise<{
-    timestamp: number;
-    id: string;
-    scenario: string;
-    videoRecvBitratePerPixel: FastStats;
-    videoRecvFps: FastStats;
-    videoSentFps: FastStats;
-}[]>;
+}): 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): string;
+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;
 };
-export declare function simpleTestWithRateLossDelay(id: string, { rate, loss, delay, direction }: {
+/**
+ * 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;

package/build/src/scenarios.js

@@ -5,13 +5,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseStatsFile = parseStatsFile;
 exports.aggregateStatsSummary = aggregateStatsSummary;
+exports.uploadStatsToGoogleSheet = uploadStatsToGoogleSheet;
 exports.formatThrottleRule = formatThrottleRule;
 exports.parseThrottleRule = parseThrottleRule;
-exports.simpleTestWithRateLossDelay = simpleTestWithRateLossDelay;
+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(',');
@@ -23,10 +33,19 @@ async function parseStatsFile(filePath) {
     }, {}));
     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) {
@@ -67,9 +86,84 @@ async function aggregateStatsSummary({ dirPath = 'logs', senderParticipantName =
     }
     return stats.sort((a, b) => a.timestamp - b.timestamp);
 }
-function formatThrottleRule(throttleRule, direction) {
-    const { rate, loss, delay } = throttleRule;
-    return `${direction}-r${rate}-l${loss}-d${delay}`;
+/**
+ * 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+)/);
@@ -81,7 +175,25 @@ function parseThrottleRule(throttleDesc) {
     const delay = parseInt(match[4]);
     return { direction, rate, loss, delay };
 }
-async function simpleTestWithRateLossDelay(id, { rate, loss, delay, direction }, repeat) {
+/**
+ * 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') {
@@ -96,7 +208,7 @@ async function simpleTestWithRateLossDelay(id, { rate, loss, delay, direction },
             { rate, loss, delay, queue, at: 30 },
         ];
     }
-    const throttleDesc = formatThrottleRule({ rate, loss, delay }, direction);
+    const throttleDesc = formatThrottleRule({ rate, loss, delay, direction });
     const now = Date.now();
     const ret = [];
     for (let i = 0; i < repeat; i++) {

package/build/src/scenarios.js.map

@@ -1 +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'\n\nexport async function parseStatsFile(filePath: string) {\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 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  const stats = [] as {\n    timestamp: number\n    id: string\n    scenario: string\n    videoRecvBitratePerPixel: FastStats\n    videoRecvFps: FastStats\n    videoSentFps: FastStats\n  }[]\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\nexport type ThrottleDirection = 'up' | 'down' | 'bidi'\n\nexport function formatThrottleRule(throttleRule: ThrottleRule, direction: ThrottleDirection) {\n  const { rate, loss, delay } = throttleRule\n  return `${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\nexport async function simpleTestWithRateLossDelay(\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"]}
+{"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"]}