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

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-latest, ubuntu-latest, windows-latest]
-        node-version: ['18.20.5', '20.11.1', '22.11.0']
+        node-version: ['20.19.0', '22.12.0']
     steps:
       - uses: actions/[email protected]
         with:
@@ -38,7 +38,7 @@ jobs:
         run: pnpm build --filter="@hey-api/**"
 
       - name: Build examples
-        if: matrix.node-version == '22.11.0' && matrix.os == 'ubuntu-latest'
+        if: matrix.node-version == '24.0.1' && matrix.os == 'ubuntu-latest'
         run: pnpm build --filter="@examples/**"
 
       - name: Run linter
@@ -54,7 +54,7 @@ jobs:
         run: pnpm test:e2e
 
       - name: Publish preview packages
-        if: github.event_name == 'pull_request' && matrix.node-version == '22.11.0' && matrix.os == 'ubuntu-latest'
+        if: github.event_name == 'pull_request' && matrix.node-version == '24.0.1' && matrix.os == 'ubuntu-latest'
         run: ./scripts/publish-preview-packages.sh
         env:
           TURBO_SCM_BASE: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}

.nvmrc

@@ -1 +1 @@
-22.11.0
+22.12.0

examples/openapi-ts-fastify/package.json

@@ -21,5 +21,8 @@
     "typescript": "5.8.3",
     "vite": "6.2.6",
     "vitest": "3.1.1"
+  },
+  "overrides": {
+    "find-my-way": "9.2.0"
   }
 }

examples/openapi-ts-nuxt/turbo.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "../../node_modules/turbo/schema.json",
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "cache": true,
+      "dependsOn": ["^build"],
+      "outputs": [".nuxt/**"]
+    }
+  }
+}

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

@@ -9,14 +9,14 @@ import {
   Section,
 } from '@radix-ui/themes';
 
-// @ts-expect-error
-import { postFoo } from './client/sdk.gen';
+import { addPet } from './client/sdk.gen';
 
 function App() {
   const onClick = async () => {
-    postFoo({
+    addPet({
       body: {
-        foo: [[1, 2]],
+        name: 'test',
+        photoUrls: ['test'],
       },
     });
   };

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

@@ -1,7 +1,32 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-import { createClient, createConfig } from '@hey-api/client-fetch';
+import {
+  type ClientOptions as DefaultClientOptions,
+  type Config,
+  createClient,
+  createConfig,
+} from '@hey-api/client-fetch';
 
 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>({
+      baseUrl: 'https://petstore3.swagger.io/api/v3',
+    }),
+  ),
+);

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

@@ -38,59 +38,6 @@ export const OrderSchema = {
   },
 } as const;
 
-export const CustomerSchema = {
-  properties: {
-    address: {
-      items: {
-        $ref: '#/components/schemas/Address',
-      },
-      type: 'array',
-      xml: {
-        name: 'addresses',
-        wrapped: true,
-      },
-    },
-    id: {
-      example: 100000,
-      format: 'int64',
-      type: 'integer',
-    },
-    username: {
-      example: 'fehguy',
-      type: 'string',
-    },
-  },
-  type: 'object',
-  xml: {
-    name: 'customer',
-  },
-} as const;
-
-export const AddressSchema = {
-  properties: {
-    city: {
-      example: 'Palo Alto',
-      type: 'string',
-    },
-    state: {
-      example: 'CA',
-      type: 'string',
-    },
-    street: {
-      example: '437 Lytton',
-      type: 'string',
-    },
-    zip: {
-      example: 94301,
-      type: 'string',
-    },
-  },
-  type: 'object',
-  xml: {
-    name: 'address',
-  },
-} as const;
-
 export const CategorySchema = {
   properties: {
     id: {
@@ -130,11 +77,11 @@ export const UserSchema = {
       type: 'string',
     },
     password: {
-      example: 12345,
+      example: '12345',
       type: 'string',
     },
     phone: {
-      example: 12345,
+      example: '12345',
       type: 'string',
     },
     userStatus: {
@@ -206,9 +153,6 @@ export const PetSchema = {
     tags: {
       items: {
         $ref: '#/components/schemas/Tag',
-        xml: {
-          name: 'tag',
-        },
       },
       type: 'array',
       xml: {