rehive 4.2.2 → 4.3.0

package/src/extensions/business/openapi-ts/types.gen.ts

@@ -364,14 +364,25 @@ export type AdminBusinessCategoryResponse = {
 export type AdminBusinessDocument = {
     readonly id: string;
     readonly file: string;
+    readonly files: Array<BusinessDocumentFile>;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    readonly type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    readonly type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -547,15 +558,24 @@ export type AdminCompanyResponse = {
  */
 export type AdminCreateBusinessDocument = {
     readonly id: string;
-    file: string;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -1041,6 +1061,20 @@ export type BusinessCategoryUpdateResponse = {
     data?: BusinessCategoryUpdate;
 };
 
+/**
+ * A ModelSerializer that takes additional arguments for
+ * "fields", "omit" and "expand" in order to
+ * control which fields are displayed, and whether to replace simple
+ * values with complex, nested serializations
+ */
+export type BusinessDocumentFile = {
+    readonly file: string;
+};
+
+export type BusinessDocumentFileWrite = {
+    file: string;
+};
+
 /**
  * A ModelSerializer that takes additional arguments for
  * "fields", "omit" and "expand" in order to
@@ -1712,14 +1746,25 @@ export type ManagerBusinessAutomatedPayoutDestination = {
 export type ManagerBusinessDocument = {
     readonly id: string;
     readonly file: string;
+    readonly files: Array<BusinessDocumentFile>;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    readonly type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    readonly type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -2301,15 +2346,24 @@ export type ManagerCreateBusiness = {
  */
 export type ManagerCreateBusinessDocument = {
     readonly id: string;
-    file: string;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -3101,14 +3155,25 @@ export type PatchedAdminBusinessCategory = {
 export type PatchedAdminBusinessDocument = {
     readonly id?: string;
     readonly file?: string;
+    readonly files?: Array<BusinessDocumentFile>;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    readonly type?: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    readonly type?: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -4557,15 +4622,29 @@ export type AdminCompanyResponseWritable = {
  * values with complex, nested serializations
  */
 export type AdminCreateBusinessDocumentWritable = {
-    file: string;
+    file?: string;
+    /**
+     * Multi-file upload. Submit as bracketed multipart keys: `files[<i>][file]` (binary) where `<i>` is the slot index (up to MAX_FLEXIBLE_FILES). Mutually exclusive with the legacy `file` field.
+     */
+    files?: Array<BusinessDocumentFileWrite>;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     /**
      * * `obsolete` - obsolete
      * * `declined` - declined
@@ -5945,15 +6024,29 @@ export type ManagerCreateBusinessWritable = {
  * values with complex, nested serializations
  */
 export type ManagerCreateBusinessDocumentWritable = {
-    file: string;
+    file?: string;
+    /**
+     * Multi-file upload. Submit as bracketed multipart keys: `files[<i>][file]` (binary) where `<i>` is the slot index (up to MAX_FLEXIBLE_FILES). Mutually exclusive with the legacy `file` field.
+     */
+    files?: Array<BusinessDocumentFileWrite>;
     /**
      * * `incorporation_certificate` - incorporation_certificate
      * * `tax_certificate` - tax_certificate
      * * `financial_statement` - financial_statement
      * * `trade_certificate` - trade_certificate
      * * `shareholder_identification` - shareholder_identification
+     * * `incumbency_certificate` - incumbency_certificate
+     * * `partnership_agreement` - partnership_agreement
+     * * `power_of_attorney` - power_of_attorney
+     * * `proof_of_address` - proof_of_address
+     * * `proof_of_nature_of_business` - proof_of_nature_of_business
+     * * `self_declaration_form` - self_declaration_form
+     * * `state_registry` - state_registry
+     * * `trust_agreement` - trust_agreement
+     * * `transparency_registry_extract` - transparency_registry_extract
+     * * `other` - other
      */
-    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification';
+    type: 'incorporation_certificate' | 'tax_certificate' | 'financial_statement' | 'trade_certificate' | 'shareholder_identification' | 'incumbency_certificate' | 'partnership_agreement' | 'power_of_attorney' | 'proof_of_address' | 'proof_of_nature_of_business' | 'self_declaration_form' | 'state_registry' | 'trust_agreement' | 'transparency_registry_extract' | 'other';
     metadata?: {
         [key: string]: unknown;
     } | null;

package/src/extensions/conversion/openapi-ts/client/client.gen.ts

@@ -48,10 +48,7 @@ export const createClient = (config: Config = {}): Client => {
     };
 
     if (opts.security) {
-      await setAuthParams({
-        ...opts,
-        security: opts.security,
-      });
+      await setAuthParams(opts);
     }
 
     if (opts.requestValidator) {
@@ -75,171 +72,154 @@ export const createClient = (config: Config = {}): Client => {
   };
 
   const request: Client['request'] = async (options) => {
-    const { opts, url } = await beforeRequest(options);
-    const requestInit: ReqInit = {
-      redirect: 'follow',
-      ...opts,
-      body: getValidRequestBody(opts),
-    };
-
-    let request = new Request(url, requestInit);
+    const throwOnError = options.throwOnError ?? _config.throwOnError;
+    const responseStyle = options.responseStyle ?? _config.responseStyle;
 
-    for (const fn of interceptors.request.fns) {
-      if (fn) {
-        request = await fn(request, opts);
-      }
-    }
-
-    // fetch must be assigned here, otherwise it would throw the error:
-    // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
-    const _fetch = opts.fetch!;
-    let response: Response;
+    let request: Request | undefined;
+    let response: Response | undefined;
 
     try {
-      response = await _fetch(request);
-    } catch (error) {
-      // Handle fetch exceptions (AbortError, network errors, etc.)
-      let finalError = error;
+      const { opts, url } = await beforeRequest(options);
+      const requestInit: ReqInit = {
+        redirect: 'follow',
+        ...opts,
+        body: getValidRequestBody(opts),
+      };
 
-      for (const fn of interceptors.error.fns) {
+      request = new Request(url, requestInit);
+
+      for (const fn of interceptors.request.fns) {
         if (fn) {
-          finalError = (await fn(error, undefined as any, request, opts)) as unknown;
+          request = await fn(request, opts);
         }
       }
 
-      finalError = finalError || ({} as unknown);
+      // fetch must be assigned here, otherwise it would throw the error:
+      // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
+      const _fetch = opts.fetch!;
 
-      if (opts.throwOnError) {
-        throw finalError;
-      }
-
-      // Return error response
-      return opts.responseStyle === 'data'
-        ? undefined
-        : {
-            error: finalError,
-            request,
-            response: undefined as any,
-          };
-    }
+      response = await _fetch(request);
 
-    for (const fn of interceptors.response.fns) {
-      if (fn) {
-        response = await fn(response, request, opts);
+      for (const fn of interceptors.response.fns) {
+        if (fn) {
+          response = await fn(response, request, opts);
+        }
       }
-    }
-
-    const result = {
-      request,
-      response,
-    };
 
-    if (response.ok) {
-      const parseAs =
-        (opts.parseAs === 'auto'
-          ? getParseAs(response.headers.get('Content-Type'))
-          : opts.parseAs) ?? 'json';
+      const result = {
+        request,
+        response,
+      };
+
+      if (response.ok) {
+        const parseAs =
+          (opts.parseAs === 'auto'
+            ? getParseAs(response.headers.get('Content-Type'))
+            : opts.parseAs) ?? 'json';
+
+        if (response.status === 204 || response.headers.get('Content-Length') === '0') {
+          let emptyData: any;
+          switch (parseAs) {
+            case 'arrayBuffer':
+            case 'blob':
+            case 'text':
+              emptyData = await response[parseAs]();
+              break;
+            case 'formData':
+              emptyData = new FormData();
+              break;
+            case 'stream':
+              emptyData = response.body;
+              break;
+            case 'json':
+            default:
+              emptyData = {};
+              break;
+          }
+          return opts.responseStyle === 'data'
+            ? emptyData
+            : {
+                data: emptyData,
+                ...result,
+              };
+        }
 
-      if (response.status === 204 || response.headers.get('Content-Length') === '0') {
-        let emptyData: any;
+        let data: any;
         switch (parseAs) {
           case 'arrayBuffer':
           case 'blob':
+          case 'formData':
           case 'text':
-            emptyData = await response[parseAs]();
+            data = await response[parseAs]();
             break;
-          case 'formData':
-            emptyData = new FormData();
+          case 'json': {
+            // Some servers return 200 with no Content-Length and empty body.
+            // response.json() would throw; read as text and parse if non-empty.
+            const text = await response.text();
+            data = text ? JSON.parse(text) : {};
             break;
+          }
           case 'stream':
-            emptyData = response.body;
-            break;
-          case 'json':
-          default:
-            emptyData = {};
-            break;
+            return opts.responseStyle === 'data'
+              ? response.body
+              : {
+                  data: response.body,
+                  ...result,
+                };
+        }
+
+        if (parseAs === 'json') {
+          if (opts.responseValidator) {
+            await opts.responseValidator(data);
+          }
+
+          if (opts.responseTransformer) {
+            data = await opts.responseTransformer(data);
+          }
         }
+
         return opts.responseStyle === 'data'
-          ? emptyData
+          ? data
           : {
-              data: emptyData,
+              data,
               ...result,
             };
       }
 
-      let data: any;
-      switch (parseAs) {
-        case 'arrayBuffer':
-        case 'blob':
-        case 'formData':
-        case 'text':
-          data = await response[parseAs]();
-          break;
-        case 'json': {
-          // Some servers return 200 with no Content-Length and empty body.
-          // response.json() would throw; read as text and parse if non-empty.
-          const text = await response.text();
-          data = text ? JSON.parse(text) : {};
-          break;
-        }
-        case 'stream':
-          return opts.responseStyle === 'data'
-            ? response.body
-            : {
-                data: response.body,
-                ...result,
-              };
+      const textError = await response.text();
+      let jsonError: unknown;
+
+      try {
+        jsonError = JSON.parse(textError);
+      } catch {
+        // noop
       }
 
-      if (parseAs === 'json') {
-        if (opts.responseValidator) {
-          await opts.responseValidator(data);
-        }
+      throw jsonError ?? textError;
+    } catch (error) {
+      let finalError = error;
 
-        if (opts.responseTransformer) {
-          data = await opts.responseTransformer(data);
+      for (const fn of interceptors.error.fns) {
+        if (fn) {
+          finalError = await fn(finalError, response, request, options as ResolvedRequestOptions);
         }
       }
 
-      return opts.responseStyle === 'data'
-        ? data
-        : {
-            data,
-            ...result,
-          };
-    }
-
-    const textError = await response.text();
-    let jsonError: unknown;
-
-    try {
-      jsonError = JSON.parse(textError);
-    } catch {
-      // noop
-    }
-
-    const error = jsonError ?? textError;
-    let finalError = error;
+      finalError = finalError || {};
 
-    for (const fn of interceptors.error.fns) {
-      if (fn) {
-        finalError = (await fn(error, response, request, opts)) as string;
+      if (throwOnError) {
+        throw finalError;
       }
-    }
-
-    finalError = finalError || ({} as string);
 
-    if (opts.throwOnError) {
-      throw finalError;
+      // TODO: we probably want to return error and improve types
+      return responseStyle === 'data'
+        ? undefined
+        : {
+            error: finalError,
+            request,
+            response,
+          };
     }
-
-    // TODO: we probably want to return error and improve types
-    return opts.responseStyle === 'data'
-      ? undefined
-      : {
-          error: finalError,
-          ...result,
-        };
   };
 
   const makeMethodFn = (method: Uppercase<HttpMethod>) => (options: RequestOptions) =>
@@ -250,7 +230,6 @@ export const createClient = (config: Config = {}): Client => {
     return createSseClient({
       ...opts,
       body: opts.body as BodyInit | null | undefined,
-      headers: opts.headers as unknown as Record<string, string>,
       method,
       onRequest: async (url, init) => {
         let request = new Request(url, init);

package/src/extensions/conversion/openapi-ts/client/index.ts

@@ -9,6 +9,7 @@ export {
 } from '../core/bodySerializer.gen';
 export { buildClientParams } from '../core/params.gen';
 export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen';
+export type { ServerSentEventsResult } from '../core/serverSentEvents.gen';
 export { createClient } from './client.gen';
 export type {
   Client,

package/src/extensions/conversion/openapi-ts/client/types.gen.ts

@@ -127,8 +127,10 @@ export type RequestResult<
                 error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
               }
           ) & {
-            request: Request;
-            response: Response;
+            /** request may be undefined, because error may be from building the request object itself */
+            request?: Request;
+            /** response may be undefined, because error may be from building the request object itself or from a network error */
+            response?: Response;
           }
     >;
 
@@ -149,12 +151,13 @@ type MethodFn = <
 
 type SseFn = <
   TData = unknown,
-  TError = unknown,
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  _TError = unknown,
   ThrowOnError extends boolean = false,
   TResponseStyle extends ResponseStyle = 'data',
 >(
   options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>,
-) => Promise<ServerSentEventsResult<TData, TError>>;
+) => Promise<ServerSentEventsResult<TData>>;
 
 type RequestFn = <
   TData = unknown,

package/src/extensions/conversion/openapi-ts/client/utils.gen.ts

@@ -14,8 +14,8 @@ import type { Client, ClientOptions, Config, RequestOptions } from './types.gen'
 export const createQuerySerializer = <T = unknown>({
   parameters = {},
   ...args
-}: QuerySerializerOptions = {}) => {
-  const querySerializer = (queryParams: T) => {
+}: QuerySerializerOptions = {}): ((queryParams: T) => string) => {
+  const querySerializer = (queryParams: T): string => {
     const search: string[] = [];
     if (queryParams && typeof queryParams === 'object') {
       for (const name in queryParams) {
@@ -118,14 +118,12 @@ const checkForExistence = (
   return false;
 };
 
-export const setAuthParams = async ({
-  security,
-  ...options
-}: Pick<Required<RequestOptions>, 'security'> &
-  Pick<RequestOptions, 'auth' | 'query'> & {
+export async function setAuthParams(
+  options: Pick<RequestOptions, 'auth' | 'query' | 'security'> & {
     headers: Headers;
-  }) => {
-  for (const auth of security) {
+  },
+): Promise<void> {
+  for (const auth of options.security ?? []) {
     if (checkForExistence(options, auth.name)) {
       continue;
     }
@@ -154,7 +152,7 @@ export const setAuthParams = async ({
         break;
     }
   }
-};
+}
 
 export const buildUrl: Client['buildUrl'] = (options) =>
   getUrl({
@@ -218,8 +216,10 @@ export const mergeHeaders = (
 
 type ErrInterceptor<Err, Res, Req, Options> = (
   error: Err,
-  response: Res,
-  request: Req,
+  /** response may be undefined due to a network error where no response object is produced */
+  response: Res | undefined,
+  /** request may be undefined, because error may be from building the request object itself */
+  request: Req | undefined,
   options: Options,
 ) => Err | Promise<Err>;
 

package/src/extensions/conversion/openapi-ts/client.gen.ts

@@ -1,6 +1,6 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-import { type ClientOptions, type Config, createClient, createConfig } from './client';
+import { type Client, type ClientOptions, type Config, createClient, createConfig } from './client';
 import type { ClientOptions as ClientOptions2 } from './types.gen';
 
 /**
@@ -13,4 +13,4 @@ import type { ClientOptions as ClientOptions2 } from './types.gen';
  */
 export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
 
-export const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://conversion.services.rehive.com/api/' }));
+export const client: Client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://conversion.services.rehive.com/api/' }));

package/src/extensions/conversion/openapi-ts/core/auth.gen.ts

@@ -9,6 +9,13 @@ export interface Auth {
    * @default 'header'
    */
   in?: 'header' | 'query' | 'cookie';
+  /**
+   * A unique identifier for the security scheme.
+   *
+   * Defined only when there are multiple security schemes whose `Auth`
+   * shape would otherwise be identical.
+   */
+  key?: string;
   /**
    * Header or query parameter name.
    *