@grafana/openapi-to-k6 0.1.2 → 0.2.1

package/examples/headers_schema/tags/default.ts

@@ -0,0 +1,182 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * Header Demo API
+ * An API demonstrating the use of headers in different ways
+ * OpenAPI spec version: 1.0.0
+ */
+import { URL } from 'https://jslib.k6.io/url/1.0.0/index.js'
+import http from 'k6/http'
+import type { Params, Response } from 'k6/http'
+import type {
+  GetExampleGet200,
+  GetExampleGetHeaders,
+  GetExampleResponseHeaders200,
+  PostExamplePostBody,
+  PostExamplePostHeaders,
+} from './headerDemoAPI.schemas'
+
+/**
+ * This is the base client to use for interacting with the API.
+ */
+export class DefaultClient {
+  private cleanBaseUrl: string
+  private commonRequestParameters: Params
+
+  constructor(clientOptions: {
+    baseUrl: string
+    commonRequestParameters?: Params
+  }) {
+    this.cleanBaseUrl = clientOptions.baseUrl.replace(/\/+$/, '')
+  }
+
+  /**
+   * This GET request demonstrates the use of custom request headers
+   * @summary GET request with headers
+   */
+  getExampleGet(
+    headers?: GetExampleGetHeaders,
+    requestParameters?: Params
+  ): {
+    response: Response
+    data: GetExampleGet200
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example-get`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request('GET', url.toString(), undefined, {
+      ...mergedRequestParameters,
+      headers: {
+        // In the schema, headers can be of any type like number but k6 accepts only strings as headers, hence converting all headers to string
+        ...Object.fromEntries(
+          Object.entries(headers || {}).map(([key, value]) => [
+            key,
+            String(value),
+          ])
+        ),
+        ...mergedRequestParameters?.headers,
+      },
+    })
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+  /**
+   * This POST request uses a security header for authentication
+   * @summary POST request with security headers
+   */
+  postExamplePost(
+    postExamplePostBody: PostExamplePostBody,
+    headers: PostExamplePostHeaders,
+    requestParameters?: Params
+  ): {
+    response: Response
+    data: void
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example-post`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'POST',
+      url.toString(),
+      JSON.stringify(postExamplePostBody),
+      {
+        ...mergedRequestParameters,
+        headers: {
+          'Content-Type': 'application/json',
+          // In the schema, headers can be of any type like number but k6 accepts only strings as headers, hence converting all headers to string
+          ...Object.fromEntries(
+            Object.entries(headers || {}).map(([key, value]) => [
+              key,
+              String(value),
+            ])
+          ),
+          ...mergedRequestParameters?.headers,
+        },
+      }
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+  /**
+   * This GET request returns custom response headers
+   * @summary GET request with response headers only
+   */
+  getExampleResponseHeaders(requestParameters?: Params): {
+    response: Response
+    data: GetExampleResponseHeaders200
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example-response-headers`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'GET',
+      url.toString(),
+      undefined,
+      mergedRequestParameters
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+
+  /**
+   * Merges the provided request parameters with default parameters for the client.
+   *
+   * @param {Params} requestParameters - The parameters provided specifically for the request
+   * @param {Params} commonRequestParameters - Common parameters for all requests
+   * @returns {Params} - The merged parameters
+   */
+  private _mergeRequestParameters(
+    requestParameters?: Params,
+    commonRequestParameters?: Params
+  ): Params {
+    return {
+      ...commonRequestParameters, // Default to common parameters
+      ...requestParameters, // Override with request-specific parameters
+      headers: {
+        ...(commonRequestParameters?.headers || {}), // Ensure headers are defined
+        ...(requestParameters?.headers || {}),
+      },
+      cookies: {
+        ...(commonRequestParameters?.cookies || {}), // Ensure cookies are defined
+        ...(requestParameters?.cookies || {}),
+      },
+      tags: {
+        ...(commonRequestParameters?.tags || {}), // Ensure tags are defined
+        ...(requestParameters?.tags || {}),
+      },
+    }
+  }
+}

package/examples/headers_schema/tags/headerDemoAPI.schemas.ts

@@ -0,0 +1,32 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * Header Demo API
+ * An API demonstrating the use of headers in different ways
+ * OpenAPI spec version: 1.0.0
+ */
+export type GetExampleResponseHeaders200 = {
+  status?: string
+}
+
+export type PostExamplePostBody = {
+  data?: string
+}
+
+export type PostExamplePostHeaders = {
+  /**
+   * Bearer token for authorization
+   */
+  Authorization: string
+}
+
+export type GetExampleGet200 = {
+  message?: string
+}
+
+export type GetExampleGetHeaders = {
+  /**
+   * A custom header for this request
+   */
+  'X-Custom-Header'?: string
+}

package/examples/headers_schema/tags/k6-script.sample.ts

@@ -0,0 +1,25 @@
+import { HeaderDemoAPIClient } from './headerDemoAPI.ts'
+
+const baseUrl = '<BASE_URL>'
+const client = new HeaderDemoAPIClient({ baseUrl })
+
+export default function () {
+  /**
+   * GET request with headers
+   */
+  const getExampleGetResponseData = client.getExampleGet()
+
+  /**
+   * POST request with security headers
+   */
+  const postExamplePostResponseData = client.postExamplePost(
+    postExamplePostBody,
+    headers
+  )
+
+  /**
+   * GET request with response headers only
+   */
+  const getExampleResponseHeadersResponseData =
+    client.getExampleResponseHeaders()
+}

package/examples/no_title_schema/{k6-script.sample.ts → single/k6-script.sample.ts}

@@ -1,7 +1,7 @@
-import { createK6Client } from './k6Client.ts'
+import { K6ClientClient } from './k6Client.ts'
 
 const baseUrl = '<BASE_URL>'
-const client = createK6Client({ baseUrl })
+const client = new K6ClientClient({ baseUrl })
 
 export default function () {
   /**

package/examples/no_title_schema/single/k6Client.ts

@@ -0,0 +1,87 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * K6Client
+ * OpenAPI spec version: 1.0.0
+ */
+import { URL } from 'https://jslib.k6.io/url/1.0.0/index.js'
+import http from 'k6/http'
+import type { Params, Response } from 'k6/http'
+export type GetExample200 = {
+  message?: string
+}
+
+/**
+ * This is the base client to use for interacting with the API.
+ */
+export class K6ClientClient {
+  private cleanBaseUrl: string
+  private commonRequestParameters: Params
+
+  constructor(clientOptions: {
+    baseUrl: string
+    commonRequestParameters?: Params
+  }) {
+    this.cleanBaseUrl = clientOptions.baseUrl.replace(/\/+$/, '')
+  }
+
+  /**
+   * @summary Retrieve example data
+   */
+  getExample(requestParameters?: Params): {
+    response: Response
+    data: GetExample200
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'GET',
+      url.toString(),
+      undefined,
+      mergedRequestParameters
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+
+  /**
+   * Merges the provided request parameters with default parameters for the client.
+   *
+   * @param {Params} requestParameters - The parameters provided specifically for the request
+   * @param {Params} commonRequestParameters - Common parameters for all requests
+   * @returns {Params} - The merged parameters
+   */
+  private _mergeRequestParameters(
+    requestParameters?: Params,
+    commonRequestParameters?: Params
+  ): Params {
+    return {
+      ...commonRequestParameters, // Default to common parameters
+      ...requestParameters, // Override with request-specific parameters
+      headers: {
+        ...(commonRequestParameters?.headers || {}), // Ensure headers are defined
+        ...(requestParameters?.headers || {}),
+      },
+      cookies: {
+        ...(commonRequestParameters?.cookies || {}), // Ensure cookies are defined
+        ...(requestParameters?.cookies || {}),
+      },
+      tags: {
+        ...(commonRequestParameters?.tags || {}), // Ensure tags are defined
+        ...(requestParameters?.tags || {}),
+      },
+    }
+  }
+}

package/examples/{basic_schema → no_title_schema/split}/k6-script.sample.ts

@@ -1,7 +1,7 @@
-import { createSimpleAPI } from './simpleAPI.ts'
+import { K6ClientClient } from './k6Client.ts'
 
 const baseUrl = '<BASE_URL>'
-const client = createSimpleAPI({ baseUrl })
+const client = new K6ClientClient({ baseUrl })
 
 export default function () {
   /**

package/examples/no_title_schema/split/k6Client.schemas.ts

@@ -0,0 +1,9 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * K6Client
+ * OpenAPI spec version: 1.0.0
+ */
+export type GetExample200 = {
+  message?: string
+}

package/examples/no_title_schema/split/k6Client.ts

@@ -0,0 +1,85 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * K6Client
+ * OpenAPI spec version: 1.0.0
+ */
+import { URL } from 'https://jslib.k6.io/url/1.0.0/index.js'
+import http from 'k6/http'
+import type { Params, Response } from 'k6/http'
+import type { GetExample200 } from './k6Client.schemas'
+
+/**
+ * This is the base client to use for interacting with the API.
+ */
+export class K6ClientClient {
+  private cleanBaseUrl: string
+  private commonRequestParameters: Params
+
+  constructor(clientOptions: {
+    baseUrl: string
+    commonRequestParameters?: Params
+  }) {
+    this.cleanBaseUrl = clientOptions.baseUrl.replace(/\/+$/, '')
+  }
+
+  /**
+   * @summary Retrieve example data
+   */
+  getExample(requestParameters?: Params): {
+    response: Response
+    data: GetExample200
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'GET',
+      url.toString(),
+      undefined,
+      mergedRequestParameters
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+
+  /**
+   * Merges the provided request parameters with default parameters for the client.
+   *
+   * @param {Params} requestParameters - The parameters provided specifically for the request
+   * @param {Params} commonRequestParameters - Common parameters for all requests
+   * @returns {Params} - The merged parameters
+   */
+  private _mergeRequestParameters(
+    requestParameters?: Params,
+    commonRequestParameters?: Params
+  ): Params {
+    return {
+      ...commonRequestParameters, // Default to common parameters
+      ...requestParameters, // Override with request-specific parameters
+      headers: {
+        ...(commonRequestParameters?.headers || {}), // Ensure headers are defined
+        ...(requestParameters?.headers || {}),
+      },
+      cookies: {
+        ...(commonRequestParameters?.cookies || {}), // Ensure cookies are defined
+        ...(requestParameters?.cookies || {}),
+      },
+      tags: {
+        ...(commonRequestParameters?.tags || {}), // Ensure tags are defined
+        ...(requestParameters?.tags || {}),
+      },
+    }
+  }
+}

package/examples/no_title_schema/tags/default.ts

@@ -0,0 +1,85 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * K6Client
+ * OpenAPI spec version: 1.0.0
+ */
+import { URL } from 'https://jslib.k6.io/url/1.0.0/index.js'
+import http from 'k6/http'
+import type { Params, Response } from 'k6/http'
+import type { GetExample200 } from './k6Client.schemas'
+
+/**
+ * This is the base client to use for interacting with the API.
+ */
+export class DefaultClient {
+  private cleanBaseUrl: string
+  private commonRequestParameters: Params
+
+  constructor(clientOptions: {
+    baseUrl: string
+    commonRequestParameters?: Params
+  }) {
+    this.cleanBaseUrl = clientOptions.baseUrl.replace(/\/+$/, '')
+  }
+
+  /**
+   * @summary Retrieve example data
+   */
+  getExample(requestParameters?: Params): {
+    response: Response
+    data: GetExample200
+  } {
+    const url = new URL(this.cleanBaseUrl + `/example`)
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'GET',
+      url.toString(),
+      undefined,
+      mergedRequestParameters
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+
+  /**
+   * Merges the provided request parameters with default parameters for the client.
+   *
+   * @param {Params} requestParameters - The parameters provided specifically for the request
+   * @param {Params} commonRequestParameters - Common parameters for all requests
+   * @returns {Params} - The merged parameters
+   */
+  private _mergeRequestParameters(
+    requestParameters?: Params,
+    commonRequestParameters?: Params
+  ): Params {
+    return {
+      ...commonRequestParameters, // Default to common parameters
+      ...requestParameters, // Override with request-specific parameters
+      headers: {
+        ...(commonRequestParameters?.headers || {}), // Ensure headers are defined
+        ...(requestParameters?.headers || {}),
+      },
+      cookies: {
+        ...(commonRequestParameters?.cookies || {}), // Ensure cookies are defined
+        ...(requestParameters?.cookies || {}),
+      },
+      tags: {
+        ...(commonRequestParameters?.tags || {}), // Ensure tags are defined
+        ...(requestParameters?.tags || {}),
+      },
+    }
+  }
+}

package/examples/no_title_schema/tags/k6-script.sample.ts

@@ -0,0 +1,11 @@
+import { K6ClientClient } from './k6Client.ts'
+
+const baseUrl = '<BASE_URL>'
+const client = new K6ClientClient({ baseUrl })
+
+export default function () {
+  /**
+   * Retrieve example data
+   */
+  const getExampleResponseData = client.getExample()
+}

package/examples/no_title_schema/tags/k6Client.schemas.ts

@@ -0,0 +1,9 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * K6Client
+ * OpenAPI spec version: 1.0.0
+ */
+export type GetExample200 = {
+  message?: string
+}

package/examples/post_request_with_query_params/single/exampleAPI.ts

@@ -0,0 +1,126 @@
+/**
+ * Automatically generated by @grafana/openapi-to-k6: 0.2.0
+ * Do not edit manually.
+ * Example API
+ * API with a POST request having an object as the body and query parameters
+ * OpenAPI spec version: 1.0.0
+ */
+import { URL, URLSearchParams } from 'https://jslib.k6.io/url/1.0.0/index.js'
+import http from 'k6/http'
+import type { Params, Response } from 'k6/http'
+export type CreateExampleData201 = {
+  /** The data from the body */
+  data?: string
+  /** The active status from the query parameter */
+  isActive?: boolean
+  /** Response status */
+  status?: string
+  /** The user ID from the query parameter */
+  userId?: string
+}
+
+export type CreateExampleDataBody = {
+  /** A string field representing data */
+  data: string
+}
+
+export type CreateExampleDataParams = {
+  /**
+   * A string query parameter for user ID
+   */
+  userId: string
+  /**
+   * A boolean query parameter
+   */
+  isActive?: boolean
+}
+
+/**
+ * This is the base client to use for interacting with the API.
+ */
+export class ExampleAPIClient {
+  private cleanBaseUrl: string
+  private commonRequestParameters: Params
+
+  constructor(clientOptions: {
+    baseUrl: string
+    commonRequestParameters?: Params
+  }) {
+    this.cleanBaseUrl = clientOptions.baseUrl.replace(/\/+$/, '')
+  }
+
+  /**
+   * This endpoint demonstrates a POST request with query parameters and a single field object in the body
+   * @summary Create example data
+   */
+  createExampleData(
+    createExampleDataBody: CreateExampleDataBody,
+    params: CreateExampleDataParams,
+    requestParameters?: Params
+  ): {
+    response: Response
+    data: CreateExampleData201
+  } {
+    const url = new URL(
+      this.cleanBaseUrl +
+        `/example` +
+        `?${new URLSearchParams(params).toString()}`
+    )
+    const mergedRequestParameters = this._mergeRequestParameters(
+      requestParameters || {},
+      this.commonRequestParameters
+    )
+    const response = http.request(
+      'POST',
+      url.toString(),
+      JSON.stringify(createExampleDataBody),
+      {
+        ...mergedRequestParameters,
+        headers: {
+          'Content-Type': 'application/json',
+          ...mergedRequestParameters?.headers,
+        },
+      }
+    )
+    let data
+
+    try {
+      data = response.json()
+    } catch {
+      data = response.body
+    }
+    return {
+      response,
+      data,
+    }
+  }
+
+  /**
+   * Merges the provided request parameters with default parameters for the client.
+   *
+   * @param {Params} requestParameters - The parameters provided specifically for the request
+   * @param {Params} commonRequestParameters - Common parameters for all requests
+   * @returns {Params} - The merged parameters
+   */
+  private _mergeRequestParameters(
+    requestParameters?: Params,
+    commonRequestParameters?: Params
+  ): Params {
+    return {
+      ...commonRequestParameters, // Default to common parameters
+      ...requestParameters, // Override with request-specific parameters
+      headers: {
+        ...(commonRequestParameters?.headers || {}), // Ensure headers are defined
+        ...(requestParameters?.headers || {}),
+      },
+      cookies: {
+        ...(commonRequestParameters?.cookies || {}), // Ensure cookies are defined
+        ...(requestParameters?.cookies || {}),
+      },
+      tags: {
+        ...(commonRequestParameters?.tags || {}), // Ensure tags are defined
+        ...(requestParameters?.tags || {}),
+      },
+    }
+  }
+}

package/examples/post_request_with_query_params/{k6-script.sample.ts → single/k6-script.sample.ts}

@@ -1,7 +1,7 @@
-import { createExampleAPI } from './exampleAPI.ts'
+import { ExampleAPIClient } from './exampleAPI.ts'
 
 const baseUrl = '<BASE_URL>'
-const client = createExampleAPI({ baseUrl })
+const client = new ExampleAPIClient({ baseUrl })
 
 export default function () {
   /**