NestJS server codegen

modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig

@@ -151,6 +151,7 @@ org.openapitools.codegen.languages.TypeScriptFetchClientCodegen
 org.openapitools.codegen.languages.TypeScriptInversifyClientCodegen
 org.openapitools.codegen.languages.TypeScriptJqueryClientCodegen
 org.openapitools.codegen.languages.TypeScriptNestjsClientCodegen
+org.openapitools.codegen.languages.TypeScriptNestjsServerCodegen
 org.openapitools.codegen.languages.TypeScriptNodeClientCodegen
 org.openapitools.codegen.languages.TypeScriptReduxQueryClientCodegen
 org.openapitools.codegen.languages.TypeScriptRxjsClientCodegen

modules/openapi-generator/src/main/resources/typescript-nestjs-server/README.md

@@ -0,0 +1,56 @@
+#  OpenApi Generator _typescript-nestjs-server_
+
+Usage: The generated output is intended to be its own module, that can be imported into your NestJS App Module. You do not need to change generated files, just import the module and implement the API
+
+Example usage (with the openapi sample `petstore.yaml`):
+
+1. Invoke openapi-generator
+   ```
+   openapi-generator-cli.jar generate -i petstore.yaml -g typescript-nestjs-server -o api-module/
+   ```
+2. implement the contracts from `api-module/api`  
+   `handlers/PetService.ts`:
+   ```typescript
+   import { Pet, ApiResponse } from "models";
+   import { Observable } from "rxjs";
+   import { PetApi } from "../api";
+   import { Inject, Injectable } from "@nestjs/common";
+
+   @Injectable()
+   export class PetService implements PetApi {
+     addPet(pet: Pet, request: Request): Pet | Promise<Pet> | Observable<Pet> {
+       throw new Error("Method not implemented.");
+     }
+
+     deletePet(petId: number, apiKey: string, request: Request): void | Promise<void> | Observable<void> {
+       throw new Error("Method not implemented.");
+     }
+
+   ...
+   ```
+3. Import the generated `ApiModule` with `ApiModule.forRoot` and provide a instance of `ApiImplementations` with a reference to your implementation  
+   `app.module.ts`
+   ```typescript
+   import { Module } from "@nestjs/common";
+   import { ApiModule, ApiImplementations } from "api-module";
+   import { PetService } from "./handlers/PetService";
+   import { UserService } from "./handlers/UserService";
+   import { StoreService } from "./handlers/StoreService";
+
+   const apiImplementations: ApiImplementations = {
+     petApi: PetService,
+     userApi: UserService,
+     storeApi: StoreService,
+   }
+
+   @Module({
+     imports: [
+       ApiModule.forRoot(apiImplementations),
+     ],
+     controllers: [],
+     providers: [],
+   })
+   export class AppModule {}
+   ```
+
+You now can regenerate the API module as often as you want without overriding your implementation.

modules/openapi-generator/src/main/resources/typescript-nestjs-server/api-implementations.mustache

@@ -0,0 +1,19 @@
+import { Type } from '@nestjs/common';
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+import { {{classname}} } from '{{apiPackage}}';
+{{/operations}}
+{{/apis}}
+
+/**
+ * Provide this type to {@link ApiModule} to provide your API implementations
+**/
+export type ApiImplementations = {
+{{#apis}}
+{{#operations}}
+  {{#lambda.camelcase}}{{classname}}{{/lambda.camelcase}}: Type<{{classname}}>
+{{/operations}}
+{{/apis}}
+};
+{{/apiInfo}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/api.module.mustache

@@ -0,0 +1,37 @@
+import { DynamicModule, Module, Provider } from '@nestjs/common';
+import { ApiImplementations } from './api-implementations'
+{{#apiInfo}}
+{{#apis}}
+import { {{classname}} } from './{{apiPackage}}';
+import { {{classname}}Controller } from './controllers';
+{{/apis}}
+{{/apiInfo}}
+
+@Module({})
+export class ApiModule {
+  static forRoot(apiImplementations: ApiImplementations): DynamicModule {
+      const providers: Provider[] = [
+{{#apiInfo}}
+{{#apis}}
+        {
+          provide: {{classname}},
+          useClass: apiImplementations.{{#lambda.camelcase}}{{classname}}{{/lambda.camelcase}}
+        },
+{{/apis}}
+{{/apiInfo}}
+      ];
+
+      return {
+        module: ApiModule,
+        controllers: [
+{{#apiInfo}}
+{{#apis}}
+          {{classname}}Controller,
+{{/apis}}
+{{/apiInfo}}
+        ],
+        providers: [...providers],
+        exports: [...providers]
+      }
+    }
+}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/api.mustache

@@ -0,0 +1,13 @@
+import { Injectable } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { {{#tsImports}}{{classname}}, {{/tsImports}} } from '../{{modelPackage}}';
+
+@Injectable()
+export abstract class {{classname}} {
+{{#operations}}
+{{#operation}}
+  abstract {{operationId}}({{#allParams}}{{paramName}}: {{{dataType}}}, {{/allParams}} request: Request): {{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}} | Promise<{{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}}> | Observable<{{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}}>;
+
+{{/operation}}
+{{/operations}}
+} 

modules/openapi-generator/src/main/resources/typescript-nestjs-server/apis.mustache

@@ -0,0 +1,7 @@
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+export * from './{{classFilename}}';
+{{/operations}}
+{{/apis}}
+{{/apiInfo}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/controller.mustache

@@ -0,0 +1,19 @@
+import { Controller{{#httpMethods}}, {{.}}{{/httpMethods}}, Req } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { {{classname}} } from '../{{apiPackage}}';
+import { {{#tsImports}}{{classname}}, {{/tsImports}} } from '../{{modelPackage}}';
+
+@Controller()
+export class {{classname}}Controller {
+  constructor(private readonly {{classVarName}}: {{classname}}) {}
+
+{{#operations}}
+{{#operation}}
+  @{{#vendorExtensions.x-http-method}}{{.}}{{/vendorExtensions.x-http-method}}{{^vendorExtensions.x-http-method}}{{httpMethod}}{{/vendorExtensions.x-http-method}}('{{path}}')
+  {{operationId}}({{#allParams}}{{paramName}}: {{{dataType}}}, {{/allParams}}@Req() request: Request): {{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}} | Promise<{{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}}> | Observable<{{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}void{{/returnType}}> {
+    return this.{{classVarName}}.{{operationId}}({{#allParams}}{{paramName}}, {{/allParams}}request);
+  }
+
+{{/operation}}
+{{/operations}}
+} 

modules/openapi-generator/src/main/resources/typescript-nestjs-server/controllers.mustache

@@ -0,0 +1,7 @@
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+export * from './{{classFilename}}.controller';
+{{/operations}}
+{{/apis}}
+{{/apiInfo}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/git_push.sh.mustache

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Git push script for {{npmName}}
+
+# Check if we're in a git repository
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    echo "Error: Not in a git repository"
+    exit 1
+fi
+
+# Get the current branch
+CURRENT_BRANCH=$(git branch --show-current)
+
+echo "Pushing to git repository..."
+echo "Current branch: $CURRENT_BRANCH"
+
+# Add all changes
+git add .
+
+# Commit with a default message if no commit message provided
+if [ -z "$1" ]; then
+    git commit -m "Update generated NestJS server code"
+else
+    git commit -m "$1"
+fi
+
+# Push to the current branch
+git push origin $CURRENT_BRANCH
+
+echo "Successfully pushed to git repository!" 

modules/openapi-generator/src/main/resources/typescript-nestjs-server/gitignore

@@ -0,0 +1,61 @@
+# compiled output
+/dist
+/node_modules
+
+# Logs
+logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# OS
+.DS_Store
+
+# Tests
+/coverage
+/.nyc_output
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/ 

modules/openapi-generator/src/main/resources/typescript-nestjs-server/model.mustache

@@ -0,0 +1,15 @@
+{{#models}}
+{{#model}}
+{{#tsImports}}
+import { {{classname}} } from './{{filename}}';
+{{/tsImports}}
+
+
+{{#description}}
+/**
+ * {{{.}}}
+ */
+{{/description}}
+{{#isEnum}}{{>modelEnum}}{{/isEnum}}{{^isEnum}}{{#isAlias}}{{>modelAlias}}{{/isAlias}}{{^isAlias}}{{#taggedUnions}}{{>modelTaggedUnion}}{{/taggedUnions}}{{^taggedUnions}}{{#oneOf}}{{#-first}}{{>modelOneOf}}{{/-first}}{{/oneOf}}{{^oneOf}}{{>modelGeneric}}{{/oneOf}}{{/taggedUnions}}{{/isAlias}}{{/isEnum}}
+{{/model}}
+{{/models}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/modelAlias.mustache

@@ -0,0 +1 @@
+export type {{classname}} = {{dataType}};

modules/openapi-generator/src/main/resources/typescript-nestjs-server/modelEnum.mustache

@@ -0,0 +1,30 @@
+{{#stringEnums}}
+export enum {{classname}} {
+{{#allowableValues}}
+{{#enumVars}}
+{{#enumDescription}}
+
+    /**
+     * {{.}}
+     */{{/enumDescription}}
+    {{name}} = {{{value}}}{{^-last}},{{/-last}}
+{{/enumVars}}
+{{/allowableValues}}
+}
+{{/stringEnums}}
+{{^stringEnums}}
+export const {{classname}} = {
+{{#allowableValues}}
+{{#enumVars}}
+{{#enumDescription}}
+
+    /**
+     * {{.}}
+     */
+{{/enumDescription}}
+    {{name}}: {{{value}}}{{^-last}},{{/-last}}
+{{/enumVars}}
+{{/allowableValues}}
+} as const;
+export type {{classname}} = typeof {{classname}}[keyof typeof {{classname}}];
+{{/stringEnums}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/modelGeneric.mustache

@@ -0,0 +1,23 @@
+export interface {{classname}}{{#allParents}}{{#-first}} extends {{/-first}}{{{.}}}{{^-last}}, {{/-last}}{{/allParents}} { {{>modelGenericAdditionalProperties}}
+{{#vars}}
+  {{#description}}
+  /**
+   * {{{description}}}
+   {{#deprecated}}
+   * @deprecated
+   {{/deprecated}}
+   */
+  {{/description}}
+  {{^description}}
+  {{#deprecated}}
+  /** @deprecated */
+  {{/deprecated}}
+  {{/description}}
+  {{^modelPropertyNamingOriginal}}
+  {{#isReadOnly}}readonly {{/isReadOnly}}{{{name}}}{{^required}}?{{/required}}: {{#isEnum}}{{{datatypeWithEnum}}}{{/isEnum}}{{^isEnum}}{{{dataType}}}{{/isEnum}}{{#isNullable}} | null{{/isNullable}};
+  {{/modelPropertyNamingOriginal}}
+  {{#modelPropertyNamingOriginal}}
+  {{#isReadOnly}}readonly {{/isReadOnly}}{{#hasSanitizedName}}'{{{baseName}}}'{{/hasSanitizedName}}{{^hasSanitizedName}}{{{name}}}{{/hasSanitizedName}}{{^required}}?{{/required}}: {{#isEnum}}{{{datatypeWithEnum}}}{{/isEnum}}{{^isEnum}}{{{dataType}}}{{/isEnum}}{{#isNullable}} | null{{/isNullable}};
+  {{/modelPropertyNamingOriginal}}
+{{/vars}}
+}{{>modelGenericEnums}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/modelGenericAdditionalProperties.mustache

@@ -0,0 +1,5 @@
+{{#additionalPropertiesType}}
+
+  [key: string]: {{{additionalPropertiesType}}}{{#hasVars}} | any{{/hasVars}};
+
+{{/additionalPropertiesType}}

modules/openapi-generator/src/main/resources/typescript-nestjs-server/modelGenericEnums.mustache

@@ -0,0 +1,30 @@
+{{#hasEnums}}
+
+{{^stringEnums}}
+export namespace {{classname}} {
+{{/stringEnums}}
+{{#vars}}
+    {{#isEnum}}
+{{#stringEnums}}
+  export enum {{classname}}{{enumName}} {
+{{#allowableValues}}
+{{#enumVars}}
+    {{name}} = {{{value}}}{{^-last}},{{/-last}}
+{{/enumVars}}
+{{/allowableValues}}
+  };
+{{/stringEnums}}
+{{^stringEnums}}
+  export const {{enumName}} = {
+  {{#allowableValues}}
+  {{#enumVars}}
+    {{name}}: {{{value}}}{{^-last}},{{/-last}}
+  {{/enumVars}}
+  {{/allowableValues}}
+  } as const;
+  export type {{enumName}} = typeof {{enumName}}[keyof typeof {{enumName}}];
+{{/stringEnums}}
+    {{/isEnum}}
+{{/vars}}
+{{^stringEnums}}}{{/stringEnums}}
+{{/hasEnums}}