feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor #1947

seriouslag · 2025-04-14T01:10:08Z

This NX plugin will generate an NX package from an OpenAPI spec file and run the openapi-ts on the spec.

This is useful for NX projects.
Also very useful to let AI agents know how to use the plugin to automate setting up client code to fit into an NX project.

TODO:

Stretch in this PR:

Support different test frameworks (missing jest)
Generate linting support (eslint, etc)

Questions:
Q: How to handle when the OpenAPI spec file updates?
A: We have added an executor and a call to each generated project. Each project can run that executor to update the spec file and regenerate the client code.

Q: How do we list the plugin in the NX plugin repository
A: https://nx.dev/extending-nx/recipes/publish-plugin#list-your-nx-plugin

Fixes: #1910

Related PRs:

stackblitz · 2025-04-14T01:10:11Z

Run & review this pull request in StackBlitz Codeflow.

vercel · 2025-04-14T01:10:13Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
hey-api-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 17, 2025 1:37am

packages/nx-plugin/src/executors/update-api/index.ts

changeset-bot · 2025-04-14T01:13:45Z

⚠️ No Changeset found

Latest commit: 395fb62

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

codecov · 2025-04-14T01:26:08Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 22.34%. Comparing base (fe9a70b) to head (395fb62).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1947   +/-   ##
=======================================
  Coverage   22.34%   22.34%           
=======================================
  Files         251      251           
  Lines       21026    21026           
  Branches      781      780    -1     
=======================================
  Hits         4699     4699           
  Misses      16321    16321           
  Partials        6        6

Flag	Coverage Δ
unittests	`22.34% <ø> (ø)`

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.

…te base config

pkg-pr-new · 2025-04-14T01:37:06Z

Open in StackBlitz

@hey-api/client-axios

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/client-axios@1947

@hey-api/client-fetch

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/client-fetch@1947

@hey-api/client-next

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/client-next@1947

@hey-api/client-nuxt

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

@hey-api/nuxt

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

@hey-api/nx-plugin

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

@hey-api/openapi-ts

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

@hey-api/vite-plugin

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

commit: 395fb62

…ty in update-api and openapi-client

…ing script to js from ts

…d type error

…e module path

seriouslag · 2025-04-14T22:42:49Z

examples/openapi-ts-nuxt/turbo.json

@@ -0,0 +1,11 @@
+{


Added this file to cache builds

seriouslag · 2025-04-14T22:43:18Z

examples/openapi-ts-sample/src/App.tsx


 function App() {
  const onClick = async () => {
-    postFoo({
+    addPet({


Changed this file to use actual generated code, I was getting type errors how it was

Sample is meant to be a playground for local development and testing. I thought I ignored it in ESLint?

Maybe was an issue with my IDE, why not use actual code instead of adding broken imports and ignoring it with comments?

I don't remember, I was probably testing something and didn't clean it up. It's similar to the sample snapshot script except it contains a whole app with UI. The idea is to be able to test drive the output since snapshots are never actually executed. Obviously should be way more polished!

seriouslag · 2025-04-14T22:43:33Z

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

@@ -1,7 +1,32 @@
 // This file is auto-generated by @hey-api/openapi-ts


Ran the code gen

seriouslag · 2025-04-14T22:44:19Z

packages/config-vite-base/package.json

@@ -10,6 +10,19 @@
  "scripts": {
    "build": "tsup"
  },
+  "exports": {


Was facing issues with our new configs, adding the exports and adding cjs fixed the issues,

seriouslag · 2025-04-14T22:44:44Z

packages/config-vite-base/package.json

+        "default": "./dist/index.cjs"
+      }
+    },
+    "./setup": "./src/setup.ts"


Exporting the setup file as a direct source file for other vitests to use as a setup file.

seriouslag · 2025-04-14T22:45:22Z

packages/config-vite-base/src/setup.ts

@@ -0,0 +1,5 @@
+// FAIL LOUDLY on unhandled promise rejections / errors


Adding this file because vitest fails if an error is uncaught but no trace is given this will add that. This will help future debugging.

seriouslag · 2025-04-14T22:45:45Z

packages/config-vite-base/src/vitest.base.config.ts

@@ -25,6 +25,7 @@ export function createVitestConfig(
        },
      },
      root,
+      setupFiles: ['@config/vite-base/setup'],


Adding our new vitest setup file with the new export path

seriouslag · 2025-04-14T22:46:16Z

turbo.json

@@ -2,7 +2,7 @@
  "$schema": "./node_modules/turbo/schema.json",
  "tasks": {
    "build": {
-      "cache": false,
+      "cache": true,


Enabled caching for quicker local dev

packages/nx-plugin/src/executors/update-api/updateApi.spec.ts

+    });
+    if (existsSync(v2SpecPath)) {
+      logger.debug(`Spec file already exists: ${v2SpecPath}`);
+      await writeFile(v2SpecPath, v2Spec);


packages/nx-plugin/src/executors/update-api/updateApi.ts

+      } else {
+        logger.debug('No existing spec file found. Creating...');
+      }
+      writeFileSync(absoluteExistingSpecPath, newSpecString);


- fix typo in vitest.config output - change vitest.config to mts for better type support - list vite and vitest as a dep if enabled - change vitest to single fork runner - change build to only output cjs to support nx plugins - add caching and nx linking if spec file is in another project

vercel bot deployed to Preview April 14, 2025 01:11 View deployment

github-advanced-security bot found potential problems Apr 14, 2025

View reviewed changes

packages/nx-plugin/src/executors/update-api/index.ts Fixed Show fixed Hide fixed

seriouslag force-pushed the feat/add-nx-plugin-2 branch from 37ec549 to d84ba4c Compare April 14, 2025 01:13

vercel bot deployed to Preview April 14, 2025 01:14 View deployment

seriouslag force-pushed the feat/add-nx-plugin-2 branch from d84ba4c to fb901bc Compare April 14, 2025 01:20

vercel bot deployed to Preview April 14, 2025 01:21 View deployment

feat(nx-plugin): add nx plugin to generate and update client code

438dac9

seriouslag force-pushed the feat/add-nx-plugin-2 branch from fb901bc to 438dac9 Compare April 14, 2025 01:21

seriouslag changed the title ~~feat(nx-plugin): add nx plugin to generate and update client code~~ feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor Apr 14, 2025

vercel bot deployed to Preview April 14, 2025 01:22 View deployment

feat(config): add exports field and support for CommonJS format in Vi…

d1bb96c

…te base config

vercel bot deployed to Preview April 14, 2025 01:29 View deployment

fix(turbo.json): enable caching for build task

c07a852

vercel bot deployed to Preview April 14, 2025 01:34 View deployment

vercel bot deployed to Preview April 14, 2025 21:07 View deployment

fix(nx-plugin): update build output

d4711ce

seriouslag force-pushed the feat/add-nx-plugin-2 branch from 0a60e87 to d4711ce Compare April 14, 2025 21:11

vercel bot deployed to Preview April 14, 2025 21:12 View deployment

refactor(nx-plugin): update schema prompts and descriptions for clari…

5947e2d

…ty in update-api and openapi-client

vercel bot deployed to Preview April 14, 2025 21:35 View deployment

chore(nx-plugin): remove ts-node dependency and update JSON file copy…

c889844

…ing script to js from ts

seriouslag force-pushed the feat/add-nx-plugin-2 branch from acb3de8 to c889844 Compare April 14, 2025 21:35

vercel bot deployed to Preview April 14, 2025 21:36 View deployment

feat(vitest): add setup files configuration to Vitest base config

19929b4

vercel bot deployed to Preview April 14, 2025 21:52 View deployment

seriouslag added 2 commits April 14, 2025 18:21

feat(turbo.json): add inputs configuration for improved build process

7af9ef1

feat(client): update example to use actual code from the spec to avoi…

354c975

…d type error

vercel bot deployed to Preview April 14, 2025 22:26 View deployment

seriouslag added 2 commits April 14, 2025 18:35

feat(config): update setup file reference in Vitest base config to us…

4d62e9d

…e module path

feat(turbo.json): add build task configuration for Nuxt project

5558a3b

vercel bot deployed to Preview April 14, 2025 22:36 View deployment

seriouslag commented Apr 14, 2025

View reviewed changes

vercel bot deployed to Preview April 17, 2025 00:18 View deployment

github-advanced-security bot found potential problems Apr 17, 2025

View reviewed changes

vercel bot deployed to Preview April 17, 2025 00:39 View deployment

seriouslag force-pushed the feat/add-nx-plugin-2 branch from df83798 to c527716 Compare April 17, 2025 00:42

vercel bot deployed to Preview April 17, 2025 00:43 View deployment

seriouslag force-pushed the feat/add-nx-plugin-2 branch from c527716 to ab291ee Compare April 17, 2025 00:48

vercel bot deployed to Preview April 17, 2025 00:49 View deployment

seriouslag requested a review from mrlubos April 17, 2025 00:57

seriouslag mentioned this pull request Apr 17, 2025

Request NX plugin #1910

Open

seriouslag force-pushed the feat/add-nx-plugin-2 branch from ab291ee to 395fb62 Compare April 17, 2025 01:36

vercel bot deployed to Preview April 17, 2025 01:37 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor #1947

feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor #1947

seriouslag commented Apr 14, 2025 •

edited

Loading

stackblitz bot commented Apr 14, 2025

vercel bot commented Apr 14, 2025 •

edited

Loading

changeset-bot bot commented Apr 14, 2025 •

edited

Loading

codecov bot commented Apr 14, 2025 •

edited

Loading

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

edited

Loading

seriouslag Apr 14, 2025

seriouslag Apr 14, 2025

mrlubos Apr 14, 2025

seriouslag Apr 15, 2025

mrlubos Apr 15, 2025

seriouslag Apr 14, 2025

seriouslag Apr 14, 2025

seriouslag Apr 14, 2025

seriouslag Apr 14, 2025 •

edited

Loading

seriouslag Apr 14, 2025

seriouslag Apr 14, 2025

Check failure

Check failure

		@@ -1,7 +1,32 @@
		// This file is auto-generated by @hey-api/openapi-ts

		@@ -0,0 +1,5 @@
		// FAIL LOUDLY on unhandled promise rejections / errors

feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor #1947

Are you sure you want to change the base?

feat(nx-plugin): add NX Plugin with OpenAPI client generator and executor #1947

Conversation

seriouslag commented Apr 14, 2025 • edited Loading

stackblitz bot commented Apr 14, 2025

vercel bot commented Apr 14, 2025 • edited Loading

changeset-bot bot commented Apr 14, 2025 • edited Loading

⚠️ No Changeset found

codecov bot commented Apr 14, 2025 • edited Loading

Codecov Report

pkg-pr-new bot commented Apr 14, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

seriouslag Apr 14, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Check failure

Check failure

seriouslag commented Apr 14, 2025 •

edited

Loading

vercel bot commented Apr 14, 2025 •

edited

Loading

changeset-bot bot commented Apr 14, 2025 •

edited

Loading

codecov bot commented Apr 14, 2025 •

edited

Loading

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

edited

Loading

seriouslag Apr 14, 2025 •

edited

Loading