@hey-api/openapi-ts 0.64.0 → 0.64.1

package/dist/index.d.ts

@@ -6340,30 +6340,45 @@ declare namespace OpenApi {
 }
 
 interface Operation extends Omit<Operation$1, 'tags'> {
-    service: string;
+  service: string;
 }
+
 interface Service extends Pick<Model, '$refs' | 'imports' | 'name'> {
-    operations: Operation[];
+  operations: Operation[];
 }
+
 interface Client$1 extends Omit<Client$2, 'operations'> {
-    services: Service[];
+  services: Service[];
 }
 
-type ExtractWithDiscriminator<T, Discriminator> = T extends Discriminator ? T : never;
+type ExtractWithDiscriminator<T, Discriminator> = T extends Discriminator
+  ? T
+  : never;
+
 /**
  * Accepts an array of elements union and attempts to extract only objects.
  * For example, Array<string | number | { id: string }> would result in
  * Array<{ id: string }>.
  */
-type ExtractArrayOfObjects<T, Discriminator> = T extends Array<infer U> ? Array<ExtractWithDiscriminator<U, Discriminator>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<ExtractWithDiscriminator<U, Discriminator>> : never;
+type ExtractArrayOfObjects<T, Discriminator> =
+  T extends Array<infer U>
+    ? Array<ExtractWithDiscriminator<U, Discriminator>>
+    : T extends ReadonlyArray<infer U>
+      ? ReadonlyArray<ExtractWithDiscriminator<U, Discriminator>>
+      : never;
+
 type Files = Record<string, TypeScriptFile>;
+
 /**
  * Transforms an array of objects into an optional object map.
  * For example, Array<{ id: string }> would result in
  * { [key: string]?: { id: string } }
  */
-type ArrayOfObjectsToObjectMap<T extends ReadonlyArray<Record<string, any>>, D extends keyof T[number]> = {
-    [K in T[number][D]]?: Extract<T[number], Record<D, K>>;
+type ArrayOfObjectsToObjectMap<
+  T extends ReadonlyArray<Record<string, any>>,
+  D extends keyof T[number],
+> = {
+  [K in T[number][D]]?: Extract<T[number], Record<D, K>>;
 };
 
 type OmitUnderscoreKeys<T> = {
@@ -7025,28 +7040,39 @@ type UserPlugins = Plugin.UserConfig<Config$h> | Plugin.UserConfig<Config$k> | P
 type ClientPlugins = Plugin.Config<Config$h> | Plugin.Config<Config$k> | Plugin.Config<Config$j> | Plugin.Config<Config$i> | Plugin.Config<Config$g> | Plugin.Config<Config$f> | Plugin.Config<Config$e> | Plugin.Config<Config$d> | Plugin.Config<Config$c> | Plugin.Config<Config$b> | Plugin.Config<Config$a> | Plugin.Config<Config$9> | Plugin.Config<Config$8> | Plugin.Config<Config$7> | Plugin.Config<Config$6> | Plugin.Config<Config$5> | Plugin.Config<Config$4> | Plugin.Config<Config$3> | Plugin.Config<Config$2> | Plugin.Config<Config$1>;
 
 type Formatters = 'biome' | 'prettier';
+
 type Linters = 'biome' | 'eslint' | 'oxlint';
-type StringCase = 'camelCase' | 'PascalCase' | 'preserve' | 'snake_case' | 'SCREAMING_SNAKE_CASE';
+
+type StringCase =
+  | 'camelCase'
+  | 'PascalCase'
+  | 'preserve'
+  | 'snake_case'
+  | 'SCREAMING_SNAKE_CASE';
+
 interface UserConfig {
-    /**
-     * Path to the config file. Set this value if you don't use the default
-     * config file name, or it's not located in the project root.
-     */
-    configFile?: string;
-    /**
-     * Skip writing files to disk?
-     *
-     * @default false
-     */
-    dryRun?: boolean;
-    /**
-     * Path to the OpenAPI specification. This can be either local or remote path.
-     * Both JSON and YAML file formats are supported. You can also pass the parsed
-     * object directly if you're fetching the file yourself.
-     *
-     * Alternatively, you can define a configuration object with more options.
-     */
-    input: string | Record<string, unknown> | {
+  /**
+   * Path to the config file. Set this value if you don't use the default
+   * config file name, or it's not located in the project root.
+   */
+  configFile?: string;
+  /**
+   * Skip writing files to disk?
+   *
+   * @default false
+   */
+  dryRun?: boolean;
+  /**
+   * Path to the OpenAPI specification. This can be either local or remote path.
+   * Both JSON and YAML file formats are supported. You can also pass the parsed
+   * object directly if you're fetching the file yourself.
+   *
+   * Alternatively, you can define a configuration object with more options.
+   */
+  input:
+    | string
+    | Record<string, unknown>
+    | {
         /**
          * Prevent parts matching the regular expression from being processed.
          * You can select both operations and components by reference within
@@ -7074,13 +7100,15 @@ interface UserConfig {
          * object directly if you're fetching the file yourself.
          */
         path: string | Record<string, unknown>;
-    };
-    /**
-     * The relative location of the logs folder
-     *
-     * @default process.cwd()
-     */
-    logs?: string | {
+      };
+  /**
+   * The relative location of the logs folder
+   *
+   * @default process.cwd()
+   */
+  logs?:
+    | string
+    | {
         /**
          * The logging level to control the verbosity of log output.
          * Determines which messages are logged based on their severity.
@@ -7098,18 +7126,27 @@ interface UserConfig {
          *
          * @default 'info'
          */
-        level?: 'debug' | 'error' | 'fatal' | 'info' | 'silent' | 'trace' | 'warn';
+        level?:
+          | 'debug'
+          | 'error'
+          | 'fatal'
+          | 'info'
+          | 'silent'
+          | 'trace'
+          | 'warn';
         /**
          * The relative location of the logs folder
          *
          * @default process.cwd()
          */
         path?: string;
-    };
-    /**
-     * The relative location of the output folder
-     */
-    output: string | {
+      };
+  /**
+   * The relative location of the output folder
+   */
+  output:
+    | string
+    | {
         /**
          * Defines casing of the output fields. By default, we preserve `input`
          * values as data transforms incur a performance penalty at runtime.
@@ -7150,21 +7187,25 @@ interface UserConfig {
          * The relative location of the output folder
          */
         path: string;
-    };
-    /**
-     * Plugins generate artifacts from `input`. By default, we generate SDK
-     * functions and TypeScript interfaces. If you manually define `plugins`,
-     * you need to include the default plugins if you wish to use them.
-     *
-     * @default ['@hey-api/typescript', '@hey-api/sdk']
-     */
-    plugins?: ReadonlyArray<UserPlugins['name'] | UserPlugins>;
-    /**
-     * Regenerate the client when the input file changes?
-     *
-     * @default false
-     */
-    watch?: boolean | number | {
+      };
+  /**
+   * Plugins generate artifacts from `input`. By default, we generate SDK
+   * functions and TypeScript interfaces. If you manually define `plugins`,
+   * you need to include the default plugins if you wish to use them.
+   *
+   * @default ['@hey-api/typescript', '@hey-api/sdk']
+   */
+  plugins?: ReadonlyArray<UserPlugins['name'] | UserPlugins>;
+  /**
+   * Regenerate the client when the input file changes? You can alternatively
+   * pass a numeric value for the interval in ms.
+   *
+   * @default false
+   */
+  watch?:
+    | boolean
+    | number
+    | {
         /**
          * Regenerate the client when the input file changes?
          *
@@ -7172,76 +7213,94 @@ interface UserConfig {
          */
         enabled?: boolean;
         /**
-         * How often should we attempt to detect the input file change?
+         * How often should we attempt to detect the input file change? (in ms)
          *
          * @default 1000
          */
         interval?: number;
-    };
-    /**
-     * @deprecated
-     *
-     * Manually set base in OpenAPI config instead of inferring from server value
-     */
-    base?: string;
-    /**
-     * @deprecated
-     *
-     * Opt in to the experimental parser?
-     *
-     * @default true
-     */
-    experimentalParser?: boolean;
-    /**
-     * @deprecated
-     *
-     * Generate core client classes?
-     *
-     * @default true
-     */
-    exportCore?: boolean;
-    /**
-     * @deprecated
-     *
-     * Custom client class name. Please note this option is deprecated and
-     * will be removed in favor of clients.
-     *
-     * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-name
-     */
-    name?: string;
-    /**
-     * @deprecated
-     *
-     * Path to custom request file. Please note this option is deprecated and
-     * will be removed in favor of clients.
-     *
-     * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-request
-     */
-    request?: string;
-    /**
-     * @deprecated
-     *
-     * Use options or arguments functions. Please note this option is deprecated and
-     * will be removed in favor of clients.
-     *
-     * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-useoptions
-     *
-     * @default true
-     */
-    useOptions?: boolean;
-}
-type Config = Omit<Required<UserConfig>, 'base' | 'input' | 'logs' | 'name' | 'output' | 'plugins' | 'request' | 'watch'> & Pick<UserConfig, 'base' | 'name' | 'request'> & {
-    input: ExtractWithDiscriminator<UserConfig['input'], {
-        path: unknown;
-    }>;
+        /**
+         * How long will we wait before the request times out?
+         *
+         * @default 60_000
+         */
+        timeout?: number;
+      };
+  /**
+   * @deprecated
+   *
+   * Manually set base in OpenAPI config instead of inferring from server value
+   */
+  // eslint-disable-next-line typescript-sort-keys/interface
+  base?: string;
+  /**
+   * @deprecated
+   *
+   * Opt in to the experimental parser?
+   *
+   * @default true
+   */
+  experimentalParser?: boolean;
+  /**
+   * @deprecated
+   *
+   * Generate core client classes?
+   *
+   * @default true
+   */
+  exportCore?: boolean;
+  /**
+   * @deprecated
+   *
+   * Custom client class name. Please note this option is deprecated and
+   * will be removed in favor of clients.
+   *
+   * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-name
+   */
+  name?: string;
+  /**
+   * @deprecated
+   *
+   * Path to custom request file. Please note this option is deprecated and
+   * will be removed in favor of clients.
+   *
+   * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-request
+   */
+  request?: string;
+  /**
+   * @deprecated
+   *
+   * Use options or arguments functions. Please note this option is deprecated and
+   * will be removed in favor of clients.
+   *
+   * @link https://heyapi.dev/openapi-ts/migrating.html#deprecated-useoptions
+   *
+   * @default true
+   */
+  useOptions?: boolean;
+}
+
+type Config = Omit<
+  Required<UserConfig>,
+  | 'base'
+  | 'input'
+  | 'logs'
+  | 'name'
+  | 'output'
+  | 'plugins'
+  | 'request'
+  | 'watch'
+> &
+  Pick<UserConfig, 'base' | 'name' | 'request'> & {
+    input: ExtractWithDiscriminator<UserConfig['input'], { path: unknown }>;
     logs: Extract<Required<UserConfig['logs']>, object>;
     output: Extract<UserConfig['output'], object>;
     pluginOrder: ReadonlyArray<ClientPlugins['name']>;
-    plugins: ArrayOfObjectsToObjectMap<ExtractArrayOfObjects<ReadonlyArray<ClientPlugins>, {
-        name: string;
-    }>, 'name'>;
-    watch: Extract<UserConfig['watch'], object>;
-};
+    plugins: ArrayOfObjectsToObjectMap<
+      ExtractArrayOfObjects<ReadonlyArray<ClientPlugins>, { name: string }>,
+      'name'
+    >;
+    watch: Extract<Required<UserConfig['watch']>, object>;
+  };
 
 interface Identifier {
     /**
@@ -7666,6 +7725,11 @@ declare namespace IR {
   export type ServerObject = IRServerObject;
 }
 
+/**
+ * Default plugins used to generate artifacts if plugins aren't specified.
+ */
+declare const defaultPlugins: readonly ["@hey-api/typescript", "@hey-api/sdk"];
+
 declare namespace LegacyIR {
   export type LegacyOperation = Operation;
 }
@@ -7679,16 +7743,11 @@ declare const utils: {
 };
 
 /**
- * Generate the OpenAPI client. This method will read the OpenAPI specification and based on the
- * given language it will generate the client, including the typed models, validation schemas,
- * service layer, etc.
- * @param userConfig {@link UserConfig} passed to the `createClient()` method
- */
-declare function createClient(userConfig: UserConfig): Promise<ReadonlyArray<Client$1 | IR.Context>>;
-/**
- * Default plugins used to generate artifacts if plugins aren't specified.
+ * Generate a client from the provided configuration.
+ *
+ * @param userConfig User provided {@link UserConfig} configuration.
  */
-declare const defaultPlugins: readonly ["@hey-api/typescript", "@hey-api/sdk"];
+declare const createClient: (userConfig: UserConfig) => Promise<ReadonlyArray<Client$1 | IR.Context>>;
 /**
  * Type helper for openapi-ts.config.ts, returns {@link UserConfig} object
  */