Merge branch 'main' into renovate/pnpm-action-setup-6.x

Author: mrlubos

.changeset/popular-years-tickle.md

@@ -101,13 +101,17 @@ jobs:
         if: steps.changesets.outputs.published == 'true'
         run: pnpm changelog:assemble
 
+      - name: Delete spotlight
+        if: steps.changesets.outputs.published == 'true'
+        run: rm -f .release/spotlight.md
+
       - name: Commit changelog
         if: steps.changesets.outputs.published == 'true'
         uses: stefanzweifel/git-auto-commit-action@v7.1.0
         with:
           branch: ${{ env.CURRENT_BRANCH }}
           commit_message: 'chore: sync changelog [skip ci]'
-          file_pattern: CHANGELOG.md
+          file_pattern: CHANGELOG.md .release/spotlight.md
 
       - name: Update lock file
         if: env.CURRENT_BRANCH == 'changeset-release/main'

.changeset/weak-avocados-tap.md

@@ -1,5 +1,108 @@
 # Changelog
 
+# 2026-04-28
+
+## @hey-api/openapi-ts 0.97.0
+
+### ⚠️ Breaking
+
+This release has 15 breaking changes. Please review the release notes carefully before upgrading.
+
+### Updates
+
+- cli: print file count and generator speed ([#3828](https://github.com/hey-api/openapi-ts/pull/3828))
+- **⚠️ Breaking:** client: resolve `runtimeConfigPath` relative to the output folder ([#3770](https://github.com/hey-api/openapi-ts/pull/3770))
+
+### Changed `runtimeConfigPath` behavior
+
+This was a known, long-standing issue confusing first-time users. Before, defining client `runtimeConfigPath` value would paste it verbatim to the generated output. This release changes the behavior to resolve relative to the current working directory the same way output path works.
+- config: remove `--apply` flag from Biome post-processor commands ([#3812](https://github.com/hey-api/openapi-ts/pull/3812))
+
+### Plugins
+
+#### @hey-api/client-angular
+
+- **⚠️ Breaking:** `request` and `response` objects might be undefined ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect `throwOnError` when request validation fails ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+
+#### @hey-api/client-fetch
+
+- **⚠️ Breaking:** pass previous result to error interceptors ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** `request` and `response` objects might be undefined ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect `throwOnError` when request validation fails ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+
+#### @hey-api/client-ky
+
+- **⚠️ Breaking:** pass previous result to error interceptors ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** `request` and `response` objects might be undefined ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect `throwOnError` when request validation fails ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect ky instance defaults ([#3806](https://github.com/hey-api/openapi-ts/pull/3806))
+
+### Changed Ky client behavior
+
+The Ky client was updated to be more intuitive. Some Ky options now need to be passed via the `kyOptions` field and you need to pass `undefined` to unset an option.
+
+#### @hey-api/client-next
+
+- **⚠️ Breaking:** `request` and `response` objects might be undefined ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** pass previous result to error interceptors ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect `throwOnError` when request validation fails ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+
+#### @hey-api/client-ofetch
+
+- **⚠️ Breaking:** `request` and `response` objects might be undefined ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+- **⚠️ Breaking:** respect `throwOnError` when request validation fails ([#3814](https://github.com/hey-api/openapi-ts/pull/3814))
+
+#### @tanstack/angular-query-experimental
+
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### @tanstack/preact-query
+
+- add `useSetQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### @tanstack/react-query
+
+- add `useSetQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### @tanstack/solid-query
+
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### @tanstack/svelte-query
+
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### @tanstack/vue-query
+
+- add `setQueryData` option ([#3824](https://github.com/hey-api/openapi-ts/pull/3824))
+
+#### zod
+
+- fallback `.discriminatedUnion` to `.union` if members contain intersection ([#3813](https://github.com/hey-api/openapi-ts/pull/3813))
+
+---
+
+## @hey-api/codegen-core 0.8.1
+
+### Updates
+
+- planner: speed up identifier conflict detector ([#3823](https://github.com/hey-api/openapi-ts/pull/3823))
+- symbol: speed up symbol registry cache ([#3823](https://github.com/hey-api/openapi-ts/pull/3823))
+
+---
+
+## @hey-api/shared 0.4.2
+
+### Updates
+
+- graph: speed up graph builder ([#3823](https://github.com/hey-api/openapi-ts/pull/3823))
+- utils: speed up deep equality check ([#3823](https://github.com/hey-api/openapi-ts/pull/3823))
+
+---
+
 # 2026-04-20
 
 ## @hey-api/openapi-ts 0.96.1

.github/workflows/release.yml

@@ -4,6 +4,8 @@ const specsPath = path.join(__dirname, '..', 'specs');
 
 export const inputs = {
   circular: path.resolve(specsPath, '3.0.x', 'circular.yaml'),
+  clerk: path.resolve(specsPath, '3.0.x', 'clerk-2025-11-10.yaml'),
+  cloudflare: path.resolve(specsPath, '3.0.x', 'cloudflare-v4.json'),
   full: path.resolve(specsPath, '3.1.x', 'full.yaml'),
   local: 'http://localhost:8000/openapi.json',
   opencode: path.resolve(specsPath, '3.1.x', 'opencode.yaml'),

.release/.gitkeep

@@ -7,6 +7,28 @@ description: Migrating to @hey-api/openapi-ts.
 
 While we try to avoid breaking changes, sometimes it's unavoidable in order to offer you the latest features. This page lists changes that require updates to your code. If you run into a problem with migration, please [open an issue](https://github.com/hey-api/openapi-ts/issues).
 
+## v0.97.0
+
+### Changed `runtimeConfigPath` behavior
+
+This was a known, long-standing issue confusing first-time users. Before, defining client `runtimeConfigPath` value would paste it verbatim to the generated output. This release changes the behavior to resolve relative to the output folder.
+
+### Changed Ky client behavior
+
+The Ky client was updated to be more intuitive. Some Ky options now need to be passed via the `kyOptions` field and you need to pass `undefined` to unset an option.
+
+### Changed error interceptors behavior
+
+Error interceptors now receive the result of the previous error interceptor. This aligns their behavior with request and response interceptors. This change only affects you if you use multiple interceptors.
+
+### Optional client request and response
+
+The returned request and response objects are now typed as optional. This aligns the types with the actual runtime behavior, which remains unchanged.
+
+### Respect `throwOnError` option
+
+Previously, there were instances where setting `throwOnError` to `false` would still throw an error. This most commonly happened when request validation failed. With this change, `throwOnError` is now truly respected.
+
 ## v0.96.0
 
 ### Removed Node 20 support

CHANGELOG.md

@@ -87,7 +87,7 @@ export const createClient = (config: Config = {}): Client => {
       opts.headers.delete('Content-Type');
     }
 
-    const url = buildUrl(opts as any);
+    const url = buildUrl(opts as Config & RequestOptions);
 
     const req = new HttpRequest<unknown>(opts.method ?? 'GET', url, getValidRequestBody(opts), {
       redirect: 'follow',
@@ -122,34 +122,39 @@ export const createClient = (config: Config = {}): Client => {
   };
 
   const request: Client['request'] = async (options) => {
-    const { opts, req: initialReq } = await beforeRequest(options);
-
-    let req = initialReq;
-
-    for (const fn of interceptors.request.fns) {
-      if (fn) {
-        req = await fn(req, opts as any);
-      }
-    }
+    const throwOnError = options.throwOnError ?? _config.throwOnError;
+    const responseStyle = options.responseStyle ?? _config.responseStyle;
 
     const result: {
-      request: HttpRequest<unknown>;
-      response: any;
+      request?: HttpRequest<unknown>;
+      response?: any;
     } = {
-      request: req,
-      response: null,
+      request: undefined,
+      response: undefined,
     };
 
     try {
-      result.response = (await firstValueFrom(
+      const { opts, req: initialReq } = await beforeRequest(options);
+
+      let req = initialReq;
+      result.request = req;
+
+      for (const fn of interceptors.request.fns) {
+        if (fn) {
+          req = await fn(req, opts as ResolvedRequestOptions);
+          result.request = req;
+        }
+      }
+
+      result.response = await firstValueFrom(
         opts
           .httpClient!.request(req)
           .pipe(filter((event) => event.type === HttpEventType.Response)),
-      )) as HttpResponse<unknown>;
+      );
 
       for (const fn of interceptors.response.fns) {
         if (fn) {
-          result.response = await fn(result.response, req, opts as any);
+          result.response = await fn(result.response, req, opts as ResolvedRequestOptions);
         }
       }
 
@@ -173,15 +178,20 @@ export const createClient = (config: Config = {}): Client => {
 
       for (const fn of interceptors.error.fns) {
         if (fn) {
-          finalError = (await fn(finalError, result.response as any, req, opts as any)) as string;
+          finalError = await fn(
+            finalError,
+            result.response,
+            result.request,
+            options as ResolvedRequestOptions,
+          );
         }
       }
 
-      if (opts.throwOnError) {
+      if (throwOnError) {
         throw finalError;
       }
 
-      return opts.responseStyle === 'data'
+      return responseStyle === 'data'
         ? undefined
         : {
             error: finalError,

dev/inputs.ts

@@ -129,8 +129,10 @@ export type RequestResult<
           | {
               data: undefined;
               error: TError[keyof TError];
-              request: HttpRequest<unknown>;
-              response: HttpErrorResponse & {
+              /** request may be undefined, because error may be from building the request object itself */
+              request?: HttpRequest<unknown>;
+              /** response may be undefined, because error may be from building the request object itself or from a network error */
+              response?: HttpErrorResponse & {
                 error: TError[keyof TError] | null;
               };
             }

docs/openapi-ts/migrating.md

@@ -311,8 +311,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>;