@types/k6 0.54.1 → 0.57.0

k6/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for k6 (https://grafana.com/docs/k6/lates
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/k6.
 
 ### Additional Details
- * Last updated: Wed, 02 Oct 2024 08:39:47 GMT
+ * Last updated: Fri, 14 Feb 2025 12:02:58 GMT
  * Dependencies: none
 
 # Credits

k6/browser/index.d.ts

@@ -936,6 +936,65 @@ export interface ConsoleMessage {
     type(): string;
 }
 
+/**
+ * {@link MetricMessage} objects are dispatched by page via the
+ * `page.on('metric')` event. For each metric that it measured and emitted for
+ * the page, k6 browser delivers it to the registered handlers.
+ *
+ * ```js
+ * // Listen for all metric messages in the page and call its tag method to
+ * // tag matching URLs with the new tag name.
+ * page.on('metric', (metric) => {
+ *   metric.tag({
+ *     name: 'test',
+ *     matches: [
+ *       {url: /^https:\/\/test\.k6\.io\/\?q=[0-9a-z]+$/, method: 'GET'},
+ *     ]
+ *   });
+ * });
+ * ```
+ */
+export interface MetricMessage {
+    /**
+     * tag will match the given `tagMatch.matches` with the current metric's URL
+     * and name tags. When a match is found it will use `tagMatch.name` to replace
+     * the existing URL and name tag values.
+     *
+     * Doing this helps group metrics with different URL and name tags that, in
+     * fact, reference the same resource, allowing for correlation over time and
+     * reducing the cardinality of the metrics.
+     * @param tagMatch
+     */
+    tag(tagMatch: {
+        /**
+         * The name value that replaces the current metric's URL and name
+         * tag values, if a match is found. Required, and must not be an
+         * empty string.
+         */
+        name: string;
+
+        /**
+         * An array of objects containing the matchers which will be used
+         * to match against the current metric's URL and name tags.
+         * Required.
+         */
+        matches: Array<{
+            /**
+             * The regular expression used to find matches in the current
+             * metric's URL and name tags. Required.
+             */
+            url: RegExp;
+
+            /**
+             * Used to match the metric's method tag. It's optional, and when
+             * it's not set it will group all metrics regardless of the method
+             * tag.
+             */
+            method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD" | "TRACE" | "CONNECT";
+        }>;
+    }): void;
+}
+
 /**
  * {@link Cookie} represents a cookie in a {@link BrowserContext}.
  *
@@ -2952,6 +3011,31 @@ export interface Page {
      */
     on(event: "console", listener: (consoleMessage: ConsoleMessage) => void): void;
 
+    /**
+     * page.on('metric') will register a background handler that will listen out
+     * for metrics that are measured and emitted for the page.
+     *
+     * When a {@link MetricMessage} is received by the handler, it can be used to
+     * group different metrics tagged with URL and name so that a correlation can
+     * be found and to reduce the cardinality of the metrics.
+     *
+     * **Usage**
+     *
+     * ```js
+     * // Listen for all metric messages in the page and call its tag method to
+     * // tag matching URLs with the new tag name.
+     * page.on('metric', (metric) => {
+     *   metric.tag({
+     *     name: 'test',
+     *     matches: [
+     *       {url: /^https:\/\/test\.k6\.io\/\?q=[0-9a-z]+$/, method: 'GET'},
+     *     ]
+     *   });
+     * });
+     * ```
+     */
+    on(event: "metric", listener: (metricMessage: MetricMessage) => void): void;
+
     /**
      * Returns the page that opened the current page. The first page that is
      * navigated to will have a null opener.

k6/experimental/csv/index.d.ts

@@ -75,6 +75,22 @@ export interface Options {
      * The line number the parsing should stop at. Default is undefined.
      */
     toLine?: number;
+
+    /**
+     * AsObjects indicates that the CSV rows should be returned as objects, where
+     * the keys are the header column names, and values are the corresponding
+     * row values.
+     *
+     * When this option is enabled, the first line of the CSV file is treated as the header.
+     *
+     * If the option is set and no header line is present, this should be considered an error
+     * case.
+     *
+     * This option is incompatible with the `skipFirstLine` option, and if both are set, an error
+     * should be returned. Same thing applies if the `fromLine` option is set to a value greater
+     * than 0.
+     */
+    asObjects?: boolean;
 }
 
 export * as default from "k6/experimental/csv";

k6/experimental/webcrypto/index.d.ts

@@ -43,7 +43,7 @@ export interface SubtleCrypto {
      * @returns A promise that resolves with the decrypted data (also known as "plaintext").
      */
     decrypt(
-        algorithm: AesCtrParams | AesCbcParams | AesGcmParams,
+        algorithm: AesCtrParams | AesCbcParams | AesGcmParams | RsaOaepParams,
         key: CryptoKey,
         data: ArrayBuffer | ArrayBufferView | DataView,
     ): Promise<ArrayBuffer>;
@@ -80,7 +80,7 @@ export interface SubtleCrypto {
      * @returns A promise that resolves with the encrypted data (also known as "ciphertext").
      */
     encrypt(
-        algorithm: AesCtrParams | AesCbcParams | AesGcmParams,
+        algorithm: AesCtrParams | AesCbcParams | AesGcmParams | RsaOaepParams,
         key: CryptoKey,
         data: ArrayBuffer | ArrayBufferView | DataView,
     ): Promise<ArrayBuffer>;
@@ -122,12 +122,12 @@ export interface SubtleCrypto {
      * @param extractable indicates whether it will be possible to export the key using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey`.
      * @param keyUsages indicates what can be done with the newly generated key.
      * @throws {SyntaxError} - if the result is a `CryptoKey` of type `secret` or `private` but `keyUsages is empty.
-     * @returns A promise that resolves with the newly generated CryptoKeyPair`.
+     * @returns A promise that resolves with the newly generated `CryptoKeyPair`.
      */
     generateKey(
-        algorithm: EcKeyGenParams,
+        algorithm: EcKeyGenParams | RSAHashedKeyGenParams,
         extractable: boolean,
-        keyUsages: Array<"sign" | "verify" | "deriveKey" | "deriveBits">,
+        keyUsages: Array<"sign" | "verify" | "deriveKey" | "deriveBits" | "encrypt" | "decrypt">,
     ): Promise<CryptoKeyPair>;
 
     /**
@@ -153,7 +153,8 @@ export interface SubtleCrypto {
             | "AES-GCM"
             | Algorithm<"AES-CBC" | "AES-CTR" | "AES-GCM">
             | HmacImportParams
-            | EcKeyImportParams,
+            | EcKeyImportParams
+            | RsaHashedImportParams,
         extractable: boolean,
         keyUsages: Array<"encrypt" | "decrypt" | "sign" | "verify" | "deriveKey" | "deriveBits">,
     ): Promise<CryptoKey>;
@@ -171,7 +172,7 @@ export interface SubtleCrypto {
      * @returns A promise that resolves with the signature.
      */
     sign(
-        algorithm: "HMAC" | Algorithm<"HMAC"> | EcdsaParams,
+        algorithm: "HMAC" | Algorithm<"HMAC"> | EcdsaParams | RsaPssParams,
         key: CryptoKey,
         data: ArrayBuffer | ArrayBufferView | DataView,
     ): Promise<ArrayBuffer>;
@@ -187,7 +188,7 @@ export interface SubtleCrypto {
      * @returns A promise that resolves with a boolean indicating whether the signature is valid.
      */
     verify(
-        algorithm: "HMAC" | Algorithm<"HMAC"> | EcdsaParams,
+        algorithm: "HMAC" | Algorithm<"HMAC"> | EcdsaParams | RsaPssParams,
         key: CryptoKey,
         signature: ArrayBuffer | ArrayBufferView | DataView,
         data: ArrayBuffer | ArrayBufferView | DataView,
@@ -381,6 +382,24 @@ export interface AesGcmParams extends Algorithm<AlgorithmIdentifier> {
     tagLength?: number;
 }
 
+/**
+ * The `RsaOaepParams` dictionary of the Web Crypto API represents the
+ * object that should be passed as the `algorithm` parameter of the
+ * `SubtleCrypto.encrypt()` and `SubtleCrypto.decrypt()` methods when
+ * using the RSA-OAEP algorithm.
+ */
+export interface RsaOaepParams extends Algorithm<AlgorithmIdentifier> {
+    /**
+     * The name of the algorithm to use.
+     */
+    name: "RSA-OAEP";
+
+    /**
+     * The label to use. If not provided, it will default to an empty ArrayBuffer.
+     */
+    label?: ArrayBuffer | ArrayBufferView | DataView;
+}
+
 /**
  * The `HmacKeyGenParams` dictionary of the Web Crypto API represents the
  * object that should be passed as the `algorithm` parameter of the
@@ -426,6 +445,34 @@ export interface EcKeyGenParams extends Algorithm<AlgorithmIdentifier> {
     namedCurve: "P-256" | "P-384" | "P-521";
 }
 
+/**
+ * The RSAHashedKeyGenParams dictionary of the Web Crypto API represents the
+ * object that should be passed as the algorithm parameter into
+ * `SubtleCrypto.generateKey()`, when the algorithm is identified
+ * as either of RSASSA-PKCS1-v1_5, RSA-PSS or RSA-OAEP.
+ */
+export interface RSAHashedKeyGenParams extends Algorithm<AlgorithmIdentifier> {
+    /**
+     * The name of the algorithm to use.
+     */
+    name: "RSASSA-PKCS1-v1_5" | "RSA-PSS" | "RSA-OAEP";
+
+    /**
+     * The modulus length, in bits.
+     */
+    modulusLength: number;
+
+    /**
+     * The public exponent.
+     */
+    publicExponent: Uint8Array;
+
+    /**
+     * The hash algorithm to use.
+     */
+    hash: HashAlgorithmIdentifier;
+}
+
 /**
  * The `HmacImportParams` dictionary of the Web Crypto API represents the
  * object that should be passed as the `algorithm` parameter of the
@@ -471,6 +518,24 @@ export interface EcKeyImportParams extends Algorithm<AlgorithmIdentifier> {
     namedCurve: "P-256" | "P-384" | "P-521";
 }
 
+/**
+ * The `RsaHashedImportParams` dictionary of the Web Crypto API represents
+ * the object that should be passed as the algorithm parameter
+ * into SubtleCrypto.importKey(), when the algorithm is identified
+ * as either of RSASSA-PKCS1-v1_5, RSA-PSS or RSA-OAEP.
+ */
+export interface RsaHashedImportParams extends Algorithm<AlgorithmIdentifier> {
+    /**
+     * The name of the algorithm to use.
+     */
+    name: "RSASSA-PKCS1-v1_5" | "RSA-PSS" | "RSA-OAEP";
+
+    /**
+     * The hash algorithm to use.
+     */
+    hash: HashAlgorithmIdentifier;
+}
+
 /**
  * The `EcdsaParams` dictionary of the Web Crypto API represents
  * the object that should be passed as the algorithm parameter
@@ -489,6 +554,24 @@ export interface EcdsaParams extends Algorithm<AlgorithmIdentifier> {
     hash: "SHA-1" | "SHA-256" | "SHA-384" | "SHA-512";
 }
 
+/**
+ * The `RsaPssParams` dictionary of the Web Crypto API represents
+ * the object that should be passed as the algorithm parameter
+ * into SubtleCrypto.sign() or SubtleCrypto.verify()
+ * when using the RSA-PSS algorithm.
+ */
+export interface RsaPssParams extends Algorithm<AlgorithmIdentifier> {
+    /**
+     * The name of the algorithm to use.
+     */
+    name: "RSA-PSS";
+
+    /**
+     * The length of the salt to use.
+     */
+    saltLength: number;
+}
+
 /**
  * The `EcdhKeyDeriveParams` dictionary of the Web Crypto API represents
  * the object that should be passed as the algorithm parameter

k6/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/k6",
-    "version": "0.54.1",
+    "version": "0.57.0",
     "description": "TypeScript definitions for k6",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/k6",
     "license": "MIT",
@@ -54,6 +54,28 @@
     "type": "module",
     "main": "",
     "types": "index.d.ts",
+    "exports": {
+        ".": "./index.d.ts",
+        "./options": "./options/index.d.ts",
+        "./ws": "./ws/index.d.ts",
+        "./http": "./http/index.d.ts",
+        "./net/grpc": "./net/grpc/index.d.ts",
+        "./html": "./html/index.d.ts",
+        "./metrics": "./metrics/index.d.ts",
+        "./timers": "./timers/index.d.ts",
+        "./execution": "./execution/index.d.ts",
+        "./encoding": "./encoding/index.d.ts",
+        "./data": "./data/index.d.ts",
+        "./crypto": "./crypto/index.d.ts",
+        "./browser": "./browser/index.d.ts",
+        "./experimental/csv": "./experimental/csv/index.d.ts",
+        "./experimental/fs": "./experimental/fs/index.d.ts",
+        "./experimental/redis": "./experimental/redis/index.d.ts",
+        "./experimental/webcrypto": "./experimental/webcrypto/index.d.ts",
+        "./experimental/streams": "./experimental/streams/index.d.ts",
+        "./experimental/websockets": "./experimental/websockets/index.d.ts",
+        "./package.json": "./package.json"
+    },
     "repository": {
         "type": "git",
         "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
@@ -61,6 +83,7 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "16df1d4804829cafe4d54bc250f82dc44d94a5df3a0b67262eaf6ffa33f024c7",
-    "typeScriptVersion": "4.8"
+    "peerDependencies": {},
+    "typesPublisherContentHash": "79ec80084ae44067fc19284ceb94ca68d3fde05933adbba9cbbed4544a6f017b",
+    "typeScriptVersion": "5.0"
 }