hey-api · idbenami · Nov 12, 2025
diff --git a/packages/openapi-ts-tests/main/package.json b/packages/openapi-ts-tests/main/package.json
@@ -31,6 +31,8 @@
     "@hey-api/custom-client": "workspace:*",
     "@hey-api/openapi-ts": "workspace:*",
     "@pinia/colada": "0.17.7",
+    "@nestjs/common": "11.1.6",
+    "@nestjs/core": "11.1.6",
     "@tanstack/angular-query-experimental": "5.73.3",
     "@tanstack/react-query": "5.73.3",
     "@tanstack/solid-query": "5.73.3",

diff --git a/packages/openapi-ts-tests/main/test/clients.test.ts b/packages/openapi-ts-tests/main/test/clients.test.ts
@@ -510,3 +510,161 @@ describe('my-client', () => {
     );
   });
 });
+
+describe.only('client-nestjs', () => {
+  const namespace = 'clients';
+
+  const outputDir = path.join(
+    __dirname,
+    'generated',
+    '3.1.x',
+    namespace,
+    'client-nestjs',
+  );
+
+  const createConfig = (
+    userConfig: Omit<UserConfig, 'input'> & Pick<Partial<UserConfig>, 'input'>,
+  ): UserConfig => ({
+    ...userConfig,
+    input: path.join(getSpecsPath(), '3.1.x', 'full.yaml'),
+    logs: {
+      level: 'silent',
+    },
+    output:
+      typeof userConfig.output === 'string'
+        ? path.join(outputDir, userConfig.output)
+        : {
+            ...userConfig.output,
+            path: path.join(outputDir, userConfig.output.path),
+          },
+  });
+
+  const scenarios = [
+    {
+      config: createConfig({
+        output: 'custom-client-name',
+        plugins: [
+          {
+            clientName: 'MyApi',
+            name: '@hey-api/client-nestjs',
+          },
+        ],
+      }),
+      description: 'custom client name',
+    },
+    {
+      config: createConfig({
+        output: 'custom-module-name',
+        plugins: [
+          {
+            clientName: 'CustomClient',
+            moduleName: 'MyCustomModule',
+            name: '@hey-api/client-nestjs',
+          },
+        ],
+      }),
+      description: 'custom module name',
+    },
+    {
+      config: createConfig({
+        output: 'custom-client-class-name',
+        plugins: [
+          {
+            clientClassName: 'MyHttpClient',
+            clientName: 'TestApi',
+            name: '@hey-api/client-nestjs',
+          },
+        ],
+      }),
+      description: 'custom client class name',
+    },
+    {
+      config: createConfig({
+        output: 'throw-on-error-true',
+        plugins: [
+          {
+            name: '@hey-api/client-nestjs',
+            throwOnError: true,
+          },
+        ],
+      }),
+      description: 'throw on error enabled',
+    },
+    {
+      config: createConfig({
+        output: 'throw-on-error-false',
+        plugins: [
+          {
+            name: '@hey-api/client-nestjs',
+            throwOnError: false,
+          },
+        ],
+      }),
+      description: 'throw on error disabled',
+    },
+    {
+      config: createConfig({
+        output: 'bundled',
+        plugins: [
+          {
+            bundle: true,
+            name: '@hey-api/client-nestjs',
+          },
+        ],
+      }),
+      description: 'bundled client',
+    },
+    {
+      config: createConfig({
+        output: 'no-bundle',
+        plugins: [
+          {
+            bundle: false,
+            name: '@hey-api/client-nestjs',
+          },
+        ],
+      }),
+      description: 'client without bundle',
+    },
+    {
+      config: createConfig({
+        output: 'custom-config-combined',
+        plugins: [
+          {
+            clientClassName: 'SuperClient',
+            clientName: 'AdvancedApi',
+            moduleName: 'AdvancedApiModule',
+            name: '@hey-api/client-nestjs',
+            throwOnError: true,
+          },
+        ],
+      }),
+      description: 'combined custom configuration',
+    },
+  ];
+
+  it.each(scenarios)('$description', async ({ config }) => {
+    await createClient(config);
+
+    const outputPath =
+      typeof config.output === 'string' ? config.output : config.output.path;
+    const filePaths = getFilePaths(outputPath);
+
+    await Promise.all(
+      filePaths.map(async (filePath) => {
+        const fileContent = fs.readFileSync(filePath, 'utf-8');
+
+        await expect(fileContent).toMatchFileSnapshot(
+          path.join(
+            __dirname,
+            '__snapshots__',
+            '3.1.x',
+            namespace,
+            'client-nestjs',
+            filePath.slice(outputDir.length + 1),
+          ),
+        );
+      }),
+    );
+  });
+});
diff --git a/packages/openapi-ts/package.json b/packages/openapi-ts/package.json
@@ -110,6 +110,7 @@
     "@angular/platform-browser-dynamic": "19.2.15",
     "@angular/router": "19.2.15",
     "@config/vite-base": "workspace:*",
+    "@nestjs/common": "11.1.6",
     "@types/bun": "1.3.1",
     "@types/cross-spawn": "6.0.6",
     "@types/semver": "7.7.1",

diff --git a/packages/openapi-ts/src/plugins/@hey-api/client-core/types.d.ts b/packages/openapi-ts/src/plugins/@hey-api/client-core/types.d.ts
@@ -1,10 +1,11 @@
 import type { Plugin } from '~/plugins';
 import type { HeyApiClientAngularPlugin } from '~/plugins/@hey-api/client-angular';
 import type { HeyApiClientAxiosPlugin } from '~/plugins/@hey-api/client-axios';
 import type { HeyApiClientFetchPlugin } from '~/plugins/@hey-api/client-fetch';
 import type { HeyApiClientNextPlugin } from '~/plugins/@hey-api/client-next';
 import type { HeyApiClientNuxtPlugin } from '~/plugins/@hey-api/client-nuxt';
 import type { HeyApiClientOfetchPlugin } from '~/plugins/@hey-api/client-ofetch';
+import type { HeyApiClientNestjsPlugin } from '~/plugins/@hey-api/client-nestjs';
 
 export interface PluginHandler {
   (...args: Parameters<HeyApiClientAngularPlugin['Handler']>): void;
@@ -13,6 +14,7 @@
   (...args: Parameters<HeyApiClientNextPlugin['Handler']>): void;
   (...args: Parameters<HeyApiClientNuxtPlugin['Handler']>): void;
   (...args: Parameters<HeyApiClientOfetchPlugin['Handler']>): void;
+  (...args: Parameters<HeyApiClientNestjsPlugin['Handler']>): void;
 }
 
 /**