@api-client/core 0.3.5 → 0.3.8

package/build/src/runtime/reporters/Reporter.d.ts

@@ -0,0 +1,62 @@
+import { IRequestLog } from '../../models/RequestLog.js';
+export interface IProjectExecutionIteration {
+    /**
+     * The index of the iteration.
+     */
+    index: number;
+    /**
+     * The list of requests executed in the iteration.
+     */
+    executed: IRequestLog[];
+    /**
+     * Optional general error message.
+     */
+    error?: string;
+}
+export interface IProjectExecutionLog {
+    /**
+     * The timestamp when the execution started
+     */
+    started: number;
+    /**
+     * The timestamp when the execution ended
+     */
+    ended: number;
+    /**
+     * The execution logs for each iteration.
+     */
+    iterations: IProjectExecutionIteration[];
+}
+/**
+ * Base class for project execution reporters.
+ */
+export declare abstract class Reporter {
+    info: IProjectExecutionLog;
+    constructor(info: IProjectExecutionLog);
+    /**
+     * Generates the report for the current execution log.
+     */
+    abstract generate(): Promise<void>;
+    /**
+     * Checks whether the execution log should be considered a failure.
+     * @param log The execution log.
+     * @returns `true` when the request was a failure.
+     */
+    protected isFailedLog(log: IRequestLog): boolean;
+    /**
+     * Computes the number of requests that failed.
+     */
+    computeFailed(): number;
+    /**
+     * Computes the number of requests that ended with the status code 399 at the most.
+     */
+    computeSucceeded(): number;
+    /**
+     * Computes the total time of sending each request.
+     */
+    computeTotalTime(): number;
+    /**
+     * Computes the total size of received data.
+     */
+    computeTotalSize(): number;
+}

package/build/src/runtime/reporters/Reporter.js

@@ -0,0 +1,98 @@
+import { ErrorResponse } from '../../models/ErrorResponse.js';
+/**
+ * Base class for project execution reporters.
+ */
+export class Reporter {
+    info;
+    constructor(info) {
+        this.info = info;
+    }
+    /**
+     * Checks whether the execution log should be considered a failure.
+     * @param log The execution log.
+     * @returns `true` when the request was a failure.
+     */
+    isFailedLog(log) {
+        if (!log.response || ErrorResponse.isErrorResponse(log.response)) {
+            return true;
+        }
+        const response = log.response;
+        if (response.status >= 400) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Computes the number of requests that failed.
+     */
+    computeFailed() {
+        let result = 0;
+        const { info } = this;
+        const { iterations } = info;
+        iterations.forEach((iteration) => {
+            iteration.executed.forEach((log) => {
+                if (this.isFailedLog(log)) {
+                    result++;
+                }
+            });
+        });
+        return result;
+    }
+    /**
+     * Computes the number of requests that ended with the status code 399 at the most.
+     */
+    computeSucceeded() {
+        let result = 0;
+        const { info } = this;
+        const { iterations } = info;
+        iterations.forEach((iteration) => {
+            iteration.executed.forEach((log) => {
+                if (!log.response || ErrorResponse.isErrorResponse(log.response)) {
+                    return;
+                }
+                const response = log.response;
+                if (response.status < 400) {
+                    result++;
+                }
+            });
+        });
+        return result;
+    }
+    /**
+     * Computes the total time of sending each request.
+     */
+    computeTotalTime() {
+        let result = 0;
+        const { info } = this;
+        const { iterations } = info;
+        iterations.forEach((iteration) => {
+            iteration.executed.forEach((log) => {
+                if (!log.response || ErrorResponse.isErrorResponse(log.response)) {
+                    return;
+                }
+                const response = log.response;
+                if (response.loadingTime && response.loadingTime > 0) {
+                    result += response.loadingTime;
+                }
+            });
+        });
+        return result;
+    }
+    /**
+     * Computes the total size of received data.
+     */
+    computeTotalSize() {
+        let result = 0;
+        const { info } = this;
+        const { iterations } = info;
+        iterations.forEach((iteration) => {
+            iteration.executed.forEach((log) => {
+                if (log.size && log.size.response) {
+                    result += log.size.response;
+                }
+            });
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=Reporter.js.map

package/build/src/runtime/reporters/Reporter.js.map

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

package/build/src/testing/TestCliHelper.d.ts

@@ -0,0 +1,29 @@
+export interface ITestRunCommandOptions {
+    includeError?: boolean;
+    noCleaning?: boolean;
+}
+export declare class TestCliHelper {
+    /**
+     * The globally set test timeout.
+     * @default 2000 The mocha default test timeout.
+     */
+    static testTimeout: number;
+    static cleanTerminalOutput(s: string): string;
+    static splitLines(table: string): string[];
+    /**
+     * Executes a passed asynchronous function and captures stdout.
+     * When the function fails, it cleans up output listeners and throws the error.
+     *
+     * ```javascript
+     * const out = grabOutput(async () => {
+     *  // ...
+     * });
+     * console.log(out); // combined stdout and stderr.
+     * ```
+     *
+     * @param fn The function to execute.
+     * @param timeout The test timeout. After this time the output is reset.
+     * @returns The terminal output.
+     */
+    static grabOutput(fn: () => Promise<void>, timeout?: number): Promise<string>;
+}

package/build/src/testing/TestCliHelper.js

@@ -0,0 +1,80 @@
+export class TestCliHelper {
+    /**
+     * The globally set test timeout.
+     * @default 2000 The mocha default test timeout.
+     */
+    static testTimeout = 2000;
+    static cleanTerminalOutput(s) {
+        let result = s.trim();
+        result = result.replace(/[^\x20-\x7E\n]/gm, '');
+        // result = result.replace(/\[\d+m/gm, '');
+        result = result.replace(/\[\d+[a-zA-Z]/gm, '');
+        result = result.split('\n').filter(i => !!i.trim()).join('\n');
+        return result;
+    }
+    static splitLines(table) {
+        const result = [];
+        table.split('\n').forEach((line) => {
+            const value = line.trim();
+            if (!value) {
+                return;
+            }
+            result.push(value);
+        });
+        return result;
+    }
+    /**
+     * Executes a passed asynchronous function and captures stdout.
+     * When the function fails, it cleans up output listeners and throws the error.
+     *
+     * ```javascript
+     * const out = grabOutput(async () => {
+     *  // ...
+     * });
+     * console.log(out); // combined stdout and stderr.
+     * ```
+     *
+     * @param fn The function to execute.
+     * @param timeout The test timeout. After this time the output is reset.
+     * @returns The terminal output.
+     */
+    static async grabOutput(fn, timeout = TestCliHelper.testTimeout) {
+        const messages = [];
+        function noop() {
+            //
+        }
+        const origOut = process.stdout.write;
+        const origErr = process.stderr.write;
+        const origClear = console.clear;
+        function messageHandler(buffer) {
+            if (typeof buffer === 'string') {
+                messages.push(buffer);
+            }
+            else {
+                messages.push(buffer.toString('utf8'));
+            }
+            return true;
+        }
+        function stop() {
+            process.stdout.write = origOut;
+            process.stderr.write = origErr;
+            console.clear = origClear;
+        }
+        process.stdout.write = messageHandler;
+        process.stderr.write = messageHandler;
+        console.clear = noop;
+        const handle = setTimeout(() => stop(), timeout);
+        try {
+            await fn();
+            stop();
+            clearTimeout(handle);
+        }
+        catch (e) {
+            stop();
+            clearTimeout(handle);
+            throw e;
+        }
+        return messages.join('');
+    }
+}
+//# sourceMappingURL=TestCliHelper.js.map

package/build/src/testing/TestCliHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestCliHelper.js","sourceRoot":"","sources":["../../../src/testing/TestCliHelper.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;IAE1B,MAAM,CAAC,mBAAmB,CAAC,CAAS;QAClC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAChD,2CAA2C;QAC3C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAAa;QAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,EAAE;gBACV,OAAO;aACR;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAuB,EAAE,OAAO,GAAC,aAAa,CAAC,WAAW;QAChF,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,SAAS,IAAI;YACX,EAAE;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;QAChC,SAAS,cAAc,CAAC,MAAuB;YAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;gBAC9B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aACvB;iBAAM;gBACL,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;aACxC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,SAAS,IAAI;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;YAC/B,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;QACtC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QAErB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI;YACF,MAAM,EAAE,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;YACP,YAAY,CAAC,MAAM,CAAC,CAAC;SACtB;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,EAAE,CAAC;YACP,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,CAAC;SACT;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC"}

package/build/src/testing/getPort.d.ts

@@ -0,0 +1,52 @@
+/// <reference types="node" />
+import net from 'net';
+export interface IGetPortOptions extends Omit<net.ListenOptions, 'port'> {
+    /**
+    A preferred port or an iterable of preferred ports to use.
+    */
+    readonly port?: number | Iterable<number>;
+    /**
+    The host on which port resolution should be performed. Can be either an IPv4 or IPv6 address.
+
+    By default, it checks availability on all local addresses defined in [OS network interfaces](https://nodejs.org/api/os.html#os_os_networkinterfaces). If this option is set, it will only check the given host.
+    */
+    readonly host?: string;
+}
+/**
+Get an available TCP port number.
+
+@returns Port number.
+
+@example
+```
+import getPort from 'get-port';
+
+console.log(await getPort());
+//=> 51402
+
+// Pass in a preferred port
+console.log(await getPort({port: 3000}));
+// Will use 3000 if available, otherwise fall back to a random port
+
+// Pass in an array of preferred ports
+console.log(await getPort({port: [3000, 3001, 3002]}));
+// Will use any element in the preferred ports array if available, otherwise fall back to a random port
+```
+*/
+export declare function getPort(options?: IGetPortOptions): Promise<number>;
+/**
+Generate port numbers in the given range `from`...`to`.
+
+@param from - The first port of the range. Must be in the range `1024`...`65535`.
+@param to - The last port of the range. Must be in the range `1024`...`65535` and must be greater than `from`.
+@returns The port numbers in the range.
+
+@example
+```
+import getPort, {portNumbers} from 'get-port';
+
+console.log(await getPort({port: portNumbers(3000, 3100)}));
+// Will use any port from 3000 to 3100, otherwise fall back to a random port
+```
+*/
+export declare function portNumbers(from: number, to: number): Iterable<number>;

package/build/src/testing/getPort.js

@@ -0,0 +1,169 @@
+import net from 'net';
+import os from 'os';
+class Locked extends Error {
+    constructor(port = 0) {
+        super(`${port} is locked`);
+    }
+}
+const lockedPorts = {
+    old: new Set(),
+    young: new Set(),
+};
+// On this interval, the old locked ports are discarded,
+// the young locked ports are moved to old locked ports,
+// and a new young set for locked ports are created.
+const releaseOldLockedPortsIntervalMs = 1000 * 15;
+// Lazily create interval on first use
+let interval;
+const getLocalHosts = () => {
+    const interfaces = os.networkInterfaces();
+    // Add undefined value for createServer function to use default host,
+    // and default IPv4 host in case createServer defaults to IPv6.
+    const results = new Set([undefined, '0.0.0.0']);
+    for (const _interface of Object.values(interfaces)) {
+        if (_interface) {
+            for (const config of _interface) {
+                results.add(config.address);
+            }
+        }
+    }
+    return results;
+};
+const checkAvailablePort = (options) => new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on('error', reject);
+    server.listen(options, () => {
+        const { port } = server.address();
+        server.close(() => {
+            resolve(port);
+        });
+    });
+});
+const getAvailablePort = async (options, hosts) => {
+    if (options.host || options.port === 0) {
+        return checkAvailablePort(options);
+    }
+    for (const host of hosts) {
+        try {
+            await checkAvailablePort({ port: options.port, host }); // eslint-disable-line no-await-in-loop
+        }
+        catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const typed = error;
+            if (!['EADDRNOTAVAIL', 'EINVAL'].includes(typed.code)) {
+                throw typed;
+            }
+        }
+    }
+    return options.port;
+};
+const portCheckSequence = function* (ports) {
+    if (ports) {
+        yield* ports;
+    }
+    yield 0; // Fall back to 0 if anything else failed
+};
+/**
+Get an available TCP port number.
+
+@returns Port number.
+
+@example
+```
+import getPort from 'get-port';
+
+console.log(await getPort());
+//=> 51402
+
+// Pass in a preferred port
+console.log(await getPort({port: 3000}));
+// Will use 3000 if available, otherwise fall back to a random port
+
+// Pass in an array of preferred ports
+console.log(await getPort({port: [3000, 3001, 3002]}));
+// Will use any element in the preferred ports array if available, otherwise fall back to a random port
+```
+*/
+export async function getPort(options) {
+    let ports = [];
+    if (options) {
+        if (typeof options.port === 'number') {
+            ports = [options.port];
+        }
+        else if (options.port) {
+            ports = options.port;
+        }
+    }
+    if (interval === undefined) {
+        interval = setInterval(() => {
+            lockedPorts.old = lockedPorts.young;
+            lockedPorts.young = new Set();
+        }, releaseOldLockedPortsIntervalMs);
+        // Does not exist in some environments (Electron, Jest jsdom env, browser, etc).
+        if (interval.unref) {
+            interval.unref();
+        }
+    }
+    const hosts = getLocalHosts();
+    for (const port of portCheckSequence(ports)) {
+        try {
+            let availablePort = await getAvailablePort({ ...options, port }, hosts); // eslint-disable-line no-await-in-loop
+            while (lockedPorts.old.has(availablePort) || lockedPorts.young.has(availablePort)) {
+                if (port !== 0) {
+                    throw new Locked(port);
+                }
+                availablePort = await getAvailablePort({ ...options, port }, hosts); // eslint-disable-line no-await-in-loop
+            }
+            lockedPorts.young.add(availablePort);
+            if (!availablePort) {
+                throw new Error('No available ports found');
+            }
+            return availablePort;
+        }
+        catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const typed = error;
+            if (!['EADDRINUSE', 'EACCES'].includes(typed.code) && !(typed instanceof Locked)) {
+                throw error;
+            }
+        }
+    }
+    throw new Error('No available ports found');
+}
+/**
+Generate port numbers in the given range `from`...`to`.
+
+@param from - The first port of the range. Must be in the range `1024`...`65535`.
+@param to - The last port of the range. Must be in the range `1024`...`65535` and must be greater than `from`.
+@returns The port numbers in the range.
+
+@example
+```
+import getPort, {portNumbers} from 'get-port';
+
+console.log(await getPort({port: portNumbers(3000, 3100)}));
+// Will use any port from 3000 to 3100, otherwise fall back to a random port
+```
+*/
+export function portNumbers(from, to) {
+    if (!Number.isInteger(from) || !Number.isInteger(to)) {
+        throw new TypeError('`from` and `to` must be integer numbers');
+    }
+    if (from < 1024 || from > 65_535) {
+        throw new RangeError('`from` must be between 1024 and 65535');
+    }
+    if (to < 1024 || to > 65_536) {
+        throw new RangeError('`to` must be between 1024 and 65536');
+    }
+    if (to < from) {
+        throw new RangeError('`to` must be greater than or equal to `from`');
+    }
+    const generator = function* (from, to) {
+        for (let port = from; port <= to; port++) {
+            yield port;
+        }
+    };
+    return generator(from, to);
+}
+//# sourceMappingURL=getPort.js.map

package/build/src/testing/getPort.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@api-client/core",
   "description": "The ARC core client library. Works in NodeJS and in a ES enabled browser.",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "license": "Apache-2.0",
   "main": "build/index.js",
   "module": "build/index.js",
@@ -26,7 +26,6 @@
     "@commitlint/cli": "^16.2.1",
     "@commitlint/config-conventional": "^16.2.1",
     "@esm-bundle/chai": "^4.3.4-fix.0",
-    "@pawel-up/data-mock": "^0.1.7",
     "@types/chai": "^4.2.22",
     "@types/chai-as-promised": "^7.1.5",
     "@types/cors": "^2.8.12",
@@ -88,7 +87,9 @@
   "dependencies": {
     "@metrichor/jmespath": "^0.3.1",
     "@pawel-up/jexl": "^3.0.0",
+    "@pawel-up/data-mock": "^0.1.7",
     "@xmldom/xmldom": "^0.8.1",
+    "console-table-printer": "^2.10.0",
     "form-data": "^4.0.0",
     "json8-patch": "^1.0.6",
     "ws": "^8.5.0",

package/src/lib/calculators/DataCalculator.ts

@@ -0,0 +1,91 @@
+/**
+ * Computations related to the data like size.
+ */
+export class DataCalculator {
+  /**
+   * Computes size in the nearest units
+   */
+  static bytesToSize(bytes: number, decimals = 2): string {
+    if (bytes === 0) {
+      return '0 Bytes';
+    }
+
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const result = parseFloat((bytes / k**i).toFixed(dm));
+    return `${result} ${sizes[i]}`;
+  }
+
+  /**
+   * Calculates size of the string
+   * @param str A string to compute size from.
+   * @returns The size of the string.
+   */
+  stringSize(str: string): number {
+    if (!str || !str.length || typeof str !== 'string') {
+      return 0;
+    }
+    let s = str.length;
+    for (let i = str.length - 1; i >= 0; i--) {
+      const code = str.charCodeAt(i);
+      if (code > 0x7f && code <= 0x7ff) {
+        s++;
+      } else if (code > 0x7ff && code <= 0xffff) {
+        /* istanbul ignore next */
+        s += 2;
+      }
+      /* istanbul ignore if */
+      if (code >= 0xDC00 && code <= 0xDFFF) {
+        i--; // trail surrogate
+      }
+    }
+    return s;
+  }
+
+  /**
+   * @param data The size of the form data
+   * @returns The size of the form data
+   */
+  async formDataSize(data: FormData): Promise<number> {
+    if (typeof Request === 'undefined') {
+      return 0;
+    }
+    const request = new Request('/', {
+      method: 'POST',
+      body: data,
+    });
+    if (!request.arrayBuffer) {
+      return 0;
+    }
+    const buffer = await request.arrayBuffer();
+    return buffer.byteLength;
+  }
+
+  /**
+   * Computes size of the payload.
+   *
+   * @param payload The payload to compute te size for 
+   * @returns The size of the payload
+   */
+  async payloadSize(payload: unknown): Promise<number> {
+    if (!payload) {
+      return 0;
+    }
+    if (payload instanceof ArrayBuffer) {
+      return payload.byteLength;
+    }
+    if (typeof Buffer !== 'undefined' && payload instanceof Buffer) {
+      return payload.byteLength;
+    }
+    if (payload instanceof Blob) {
+      return payload.size;
+    }
+    if (payload instanceof FormData) {
+      return this.formDataSize(payload);
+    }
+    return this.stringSize(String(payload));
+  }
+}