feat: init `client-ofetch` #2642

brolnickij · 2025-09-14T10:24:43Z

Introduction

client-ofetch came out of this discussion #2618 (comment), the problem in #2619, and extra compatibility issues between client-nuxt and the @pinia/colada plugin (#2595)

Besides fixing all of the above, client-ofetch also grows the Hey API built-in toolbox with another popular HTTP client ofetch.

Features

client-ofetch is a universal (runtime-agnostic) ofetch‑based client
client-ofetch supports native ofetch hooks, retry / timeout / dispatcher / agent, SSE, responseStyle / throwOnError, parseAs / responseType
native hey api integration

Problem details

Right now, client-nuxt is tailored for Nuxt own composables (useAsyncData / useFetch / etc). At the same time, @pinia/colada is a more advanced way to work with the apps infra layer in vue.js projects.

The tight coupling of client-nuxt to Nuxt itself (imports from nuxt/app / vue) makes it a bad fit for Nitro server routes / SSR and for universal libraries like @pinia/colada.

Also, trying to stretch client-nuxt to be "universal" leads to higher coupling and hacks in codegen (branching on isNuxtClient in @pinia/colada and in the SDK). This bloats types and makes the codebase harder to maintain.

In conclusion, it would be nice to have a standalone ofetch, without any ties to Nuxt.

Migration plan

after refactor(pinia-colada): migrate queries to defineQueryOptions #2610 and feat: init client-ofetch #2642 land in main, we need to clean up the @pinia/colada plugin to decouple it from client-nuxt once and for all (remove every isNuxtClient and make them fully independent).
keep two transports (client-nuxt for components & client-ofetch for server routes?*

bolt-new-by-stackblitz · 2025-09-14T10:24:46Z

Run & review this pull request in StackBlitz Codeflow.

changeset-bot · 2025-09-14T10:24:46Z

🦋 Changeset detected

Latest commit: 0e4a063

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@hey-api/openapi-ts	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2025-09-14T10:24:47Z

@brolnickij is attempting to deploy a commit to the Hey API Team on Vercel.

A member of the Team first needs to authorize it.

codecov · 2025-09-14T12:41:14Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 25.26%. Comparing base (b59afd5) to head (0e4a063).
⚠️ Report is 31 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2642      +/-   ##
==========================================
+ Coverage   24.36%   25.26%   +0.89%     
==========================================
  Files         378      385       +7     
  Lines       36466    37085     +619     
  Branches     1640     1781     +141     
==========================================
+ Hits         8885     9369     +484     
- Misses      27568    27703     +135     
  Partials       13       13

Flag	Coverage Δ
unittests	`25.26% <ø> (+0.89%)`	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

pkg-pr-new · 2025-09-14T12:41:29Z

Open in StackBlitz

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/codegen-core@2642

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/nuxt@2642

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/openapi-ts@2642

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/vite-plugin@2642

commit: 0e4a063

mrlubos · 2025-09-22T01:05:18Z

I plan to get to this later today

…hots

mrlubos

This is really well done! Thank you!

brolnickij marked this pull request as ready for review September 15, 2025 11:41

dosubot bot added size:XXL This PR changes 1000+ lines, ignoring generated files. client Client package related feature 🚀 New feature or request labels Sep 15, 2025

brolnickij added 20 commits September 23, 2025 00:09

feat(ofetch): init core client func & config

7023a42

feat(core): init client-ofetch support in plugin system

ea0088a

chore: init ofetch dep

aebfbdd

feat(build): add client-ofetch to pluginNames

5305752

feat: initialize ofetch example project

a1807fe

docs(ofetch): init

168e424

test(client-ofetch): add unit runtime tests

9c5ef55

chore: bump pnpm-lock.yaml

ae42ac9

test(openapi-ts-tests): add client-ofetch to clients matrix & snaps…

1aa9c2b

…hots

chore(release): add changeset for client-ofetch

da9e05f

chore: add ofetch to keywords in package.json

27695fa

chore: bump ofetch dependency

a6f1681

chore(ofetch): pin vue deps version

5b4e24b

chore(ofetch): update snapshots

cfd6dcf

docs(ofetch): init SSE section

300f79a

docs: cap of ofetch -> OFetch

845318c

docs(pinia-colada): add nuxt tips for compatibility

a37d0a3

chore(ofetch): enhance jsdoc for Config interface

9cf1458

chore(ofetch): cleanup comments

e1d6b27

chore: bump snapshots

43e59ff

brolnickij added 3 commits September 23, 2025 00:09

fix(client-ofetch): keep error responses from throwing

9793e70

fix(client-ofetch): return FormData when parseAs is formData

f8cb3fd

chore(client-ofetch): bump snapshots

ef329e3

mrlubos force-pushed the feat/ofetch branch from 9214aea to ef329e3 Compare September 22, 2025 16:09

mrlubos added 3 commits September 23, 2025 03:51

docs: update client pages

7322c67

chore: fix types

492a4e7

test: update snapshots

0e4a063

mrlubos approved these changes Sep 22, 2025

View reviewed changes

dosubot bot added the lgtm This PR has been approved by a maintainer label Sep 22, 2025

mrlubos merged commit efd4e88 into hey-api:main Sep 22, 2025
15 of 16 checks passed

hey-api bot mentioned this pull request Sep 22, 2025

ci: release #2671

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

feat: init `client-ofetch` #2642

feat: init `client-ofetch` #2642

Uh oh!

brolnickij commented Sep 14, 2025 •

edited

Loading

Uh oh!

bolt-new-by-stackblitz bot commented Sep 14, 2025

Uh oh!

changeset-bot bot commented Sep 14, 2025 •

edited

Loading

Uh oh!

vercel bot commented Sep 14, 2025

Uh oh!

codecov bot commented Sep 14, 2025 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Sep 14, 2025 •

edited

Loading

Uh oh!

mrlubos commented Sep 22, 2025

Uh oh!

mrlubos left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

feat: init client-ofetch #2642

feat: init client-ofetch #2642

Uh oh!

Conversation

brolnickij commented Sep 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Introduction

Features

Problem details

Migration plan

Uh oh!

bolt-new-by-stackblitz bot commented Sep 14, 2025

Uh oh!

changeset-bot bot commented Sep 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Sep 14, 2025

Uh oh!

codecov bot commented Sep 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

pkg-pr-new bot commented Sep 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mrlubos commented Sep 22, 2025

Uh oh!

mrlubos left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

feat: init `client-ofetch` #2642

feat: init `client-ofetch` #2642

brolnickij commented Sep 14, 2025 •

edited

Loading

changeset-bot bot commented Sep 14, 2025 •

edited

Loading

codecov bot commented Sep 14, 2025 •

edited

Loading

pkg-pr-new bot commented Sep 14, 2025 •

edited

Loading