chore: add migration notes

Author: mrlubos

.changeset/long-keys-refuse.md

@@ -0,0 +1,20 @@
+---
+'@hey-api/openapi-ts': minor
+---
+
+feat: added `client.baseUrl` option
+
+### Added `client.baseUrl` option
+
+You can use this option to configure the default base URL for the generated client. By default, we will attempt to resolve the first defined server or infer the base URL from the input path. If you'd like to preserve the previous behavior, set `baseUrl` to `false`.
+
+```js
+export default {
+  input: 'path/to/openapi.json',
+  output: 'src/client',
+  plugins: [{
+    baseUrl: false, // [!code ++]
+    name: '@hey-api/client-fetch',
+  }],
+};
+```

.changeset/unlucky-moles-dance.md

@@ -1,8 +1,18 @@
 ---
-'@hey-api/client-axios': patch
-'@hey-api/client-fetch': patch
-'@hey-api/client-next': patch
-'@hey-api/client-nuxt': patch
+'@hey-api/client-axios': minor
+'@hey-api/client-fetch': minor
+'@hey-api/client-next': minor
+'@hey-api/client-nuxt': minor
+'@hey-api/openapi-ts': minor
 ---
 
 fix: make createConfig, CreateClientConfig, and Config accept ClientOptions generic
+
+### Added `ClientOptions` interface
+
+The `Config` interface now accepts an optional generic extending `ClientOptions` instead of `boolean` type `ThrowOnError`.
+
+```ts
+type Foo = Config<false> // [!code --]
+type Foo = Config<{ throwOnError: false }> // [!code ++]
+```

docs/openapi-ts/clients/axios.md

@@ -106,7 +106,7 @@ In our custom file, we need to export a `createClientConfig()` method. This func
 ::: code-group
 
 ```ts [hey-api.ts]
-import type { CreateClientConfig } from '@hey-api/client-axios';
+import type { CreateClientConfig } from './client/client.gen';
 
 export const createClientConfig: CreateClientConfig = (config) => ({
   ...config,

docs/openapi-ts/clients/fetch.md

@@ -106,7 +106,7 @@ In our custom file, we need to export a `createClientConfig()` method. This func
 ::: code-group
 
 ```ts [hey-api.ts]
-import type { CreateClientConfig } from '@hey-api/client-fetch';
+import type { CreateClientConfig } from './client/client.gen';
 
 export const createClientConfig: CreateClientConfig = (config) => ({
   ...config,

docs/openapi-ts/clients/next-js.md

@@ -102,7 +102,7 @@ In our custom file, we need to export a `createClientConfig()` method. This func
 ::: code-group
 
 ```ts [hey-api.ts]
-import type { CreateClientConfig } from '@hey-api/client-next';
+import type { CreateClientConfig } from './client/client.gen';
 
 export const createClientConfig: CreateClientConfig = (config) => ({
   ...config,

docs/openapi-ts/clients/nuxt.md

@@ -102,7 +102,7 @@ In our custom file, we need to export a `createClientConfig()` method. This func
 ::: code-group
 
 ```ts [hey-api.ts]
-import type { CreateClientConfig } from '@hey-api/client-nuxt';
+import type { CreateClientConfig } from './client/client.gen';
 
 export const createClientConfig: CreateClientConfig = (config) => ({
   ...config,

docs/openapi-ts/migrating.md

@@ -27,6 +27,34 @@ This config option is deprecated and will be removed in favor of [clients](./cli
 
 This config option is deprecated and will be removed.
 
+## v0.64.0
+
+### Added `ClientOptions` interface
+
+The `Config` interface now accepts an optional generic extending `ClientOptions` instead of `boolean` type `ThrowOnError`.
+
+```ts
+type Foo = Config<false>; // [!code --]
+type Foo = Config<{ throwOnError: false }>; // [!code ++]
+```
+
+### Added `client.baseUrl` option
+
+You can use this option to configure the default base URL for the generated client. By default, we will attempt to resolve the first defined server or infer the base URL from the input path. If you'd like to preserve the previous behavior, set `baseUrl` to `false`.
+
+```js
+export default {
+  input: 'path/to/openapi.json',
+  output: 'src/client',
+  plugins: [
+    {
+      baseUrl: false, // [!code ++]
+      name: '@hey-api/client-fetch',
+    },
+  ],
+};
+```
+
 ## v0.63.0
 
 ### Client plugins

examples/openapi-ts-next/src/client/client.gen.ts

@@ -1,7 +1,28 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-import { createClient, createConfig } from '@hey-api/client-next';
+import {
+  type ClientOptions as DefaultClientOptions,
+  type Config,
+  createClient,
+  createConfig,
+} from '@hey-api/client-next';
 
 import { createClientConfig } from '../hey-api';
+import type { ClientOptions } from './types.gen';
 
-export const client = createClient(createClientConfig(createConfig()));
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> =
+  (
+    override?: Config<DefaultClientOptions & T>,
+  ) => Config<Required<DefaultClientOptions> & T>;
+
+export const client = createClient(
+  createClientConfig(createConfig<ClientOptions>()),
+);

examples/openapi-ts-next/src/client/types.gen.ts

@@ -561,3 +561,7 @@ export type UpdateUserResponses = {
    */
   default: unknown;
 };
+
+export type ClientOptions = {
+  baseUrl: `${string}://${string}/v3` | (string & {});
+};

examples/openapi-ts-next/src/hey-api.ts

@@ -1,4 +1,4 @@
-import type { CreateClientConfig } from '@hey-api/client-next';
+import type { CreateClientConfig } from './client/client.gen';
 
 export const createClientConfig: CreateClientConfig = (config) => ({
   ...config,