[Typescript] Enum types

docs/generators/typescript.md

@@ -24,6 +24,7 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |enumNameSuffix|Suffix that will be appended to all enum names.| |Enum|
 |enumPropertyNaming|Naming convention for enum properties: 'camelCase', 'PascalCase', 'snake_case', 'UPPERCASE', and 'original'| |PascalCase|
 |enumPropertyNamingReplaceSpecialChar|Set to true to replace '-' and '+' symbols with 'minus_' and 'plus_' in enum of type string| |false|
+|enumType|Specify the enum type which should be used in the client code.|<dl><dt>**stringUnion**</dt><dd>stringUnion</dd><dt>**enum**</dt><dd>enum</dd></dl>|stringUnion|
 |enumUnknownDefaultCase|If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.|<dl><dt>**false**</dt><dd>No changes to the enum's are made, this is the default option.</dd><dt>**true**</dt><dd>With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl>|false|
 |fileContentDataType|Specifies the type to use for the content of a file - i.e. Blob (Browser, Deno) / Buffer (node)| |Buffer|
 |framework|Specify the framework which should be used in the client code.|<dl><dt>**fetch-api**</dt><dd>fetch-api</dd><dt>**jquery**</dt><dd>jquery</dd></dl>|fetch-api|

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/TypeScriptClientCodegen.java

@@ -74,6 +74,9 @@ public class TypeScriptClientCodegen extends AbstractTypeScriptClientCodegen imp
 
     private static final String USE_OBJECT_PARAMS_SWITCH = "useObjectParameters";
     private static final String USE_OBJECT_PARAMS_DESC = "Use aggregate parameter objects as function arguments for api operations instead of passing each parameter as a separate function argument.";
+    private static final String ENUM_TYPE_SWITCH = "enumType";
+    private static final String ENUM_TYPE_SWITCH_DESC = "Specify the enum type which should be used in the client code.";
+    private static final String[] ENUM_TYPES = {"stringUnion", "enum"};
 
     private final Map<String, String> frameworkToHttpLibMap;
 
@@ -135,6 +138,13 @@ public TypeScriptClientCodegen() {
 
         cliOptions.add(platformOption);
 
+        CliOption enumTypeOption = new CliOption(TypeScriptClientCodegen.ENUM_TYPE_SWITCH, TypeScriptClientCodegen.ENUM_TYPE_SWITCH_DESC);
+        for (String option : TypeScriptClientCodegen.ENUM_TYPES) {
+            enumTypeOption.addEnum(option, option);
+        }
+        enumTypeOption.defaultValue(ENUM_TYPES[0]);
+        cliOptions.add(enumTypeOption);
+
         // Set property naming to camelCase
         supportModelPropertyNaming(CodegenConstants.MODEL_PROPERTY_NAMING_TYPE.camelCase);
 
@@ -426,6 +436,15 @@ public void processOpts() {
                 "http", httpLibName + ".ts"
         ));
 
+        additionalProperties.putIfAbsent(ENUM_TYPE_SWITCH, ENUM_TYPES[0]);
+        Object propEnumType = additionalProperties.get(ENUM_TYPE_SWITCH);
+
+        Map<String, Boolean> enumTypes = new HashMap<>();
+        for (String enumType : ENUM_TYPES) {
+            enumTypes.put(enumType, enumType.equals(propEnumType));
+        }
+        additionalProperties.put("enumTypes", enumTypes);
+
         Object propPlatform = additionalProperties.get(PLATFORM_SWITCH);
         if (propPlatform == null) {
             propPlatform = "browser";

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

@@ -71,26 +71,40 @@ export class {{classname}} {{#parent}}extends {{{.}}} {{/parent}}{
 
 {{#vars}}
 {{#isEnum}}
+{{#enumTypes}}
+{{#enum}}
 export enum {{classname}}{{enumName}} {
     {{#allowableValues}}
     {{#enumVars}}
     {{name}} = {{{value}}}{{^-last}},{{/-last}}
     {{/enumVars}}
     {{/allowableValues}}
 }
+{{/enum}}
+{{#stringUnion}}
+    export type {{classname}}{{enumName}} ={{#allowableValues}}{{#values}} "{{.}}" {{^-last}}|{{/-last}}{{/values}}{{/allowableValues}};
+{{/stringUnion}}
+{{/enumTypes}}
 {{/isEnum}}
 {{/vars}}
 
 {{/hasEnums}}
 {{/isEnum}}
 {{#isEnum}}
+{{#enumTypes}}
+{{#enum}}
 export enum {{classname}} {
     {{#allowableValues}}
     {{#enumVars}}
     {{name}} = {{{value}}}{{^-last}},{{/-last}}
     {{/enumVars}}
     {{/allowableValues}}
 }
+{{/enum}}
+{{#stringUnion}}
+    export type {{classname}} ={{#allowableValues}}{{#values}} "{{.}}" {{^-last}}|{{/-last}}{{/values}}{{/allowableValues}};
+{{/stringUnion}}
+{{/enumTypes}}
 {{/isEnum}}
 {{/model}}
 {{/models}}

samples/openapi3/client/petstore/typescript/builds/browser/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/browser/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/builds/composed-schemas/models/Dog.ts

@@ -41,10 +41,5 @@ export class Dog {
 }
 
 
-export enum DogBreedEnum {
-    Dingo = 'Dingo',
-    Husky = 'Husky',
-    Retriever = 'Retriever',
-    Shepherd = 'Shepherd'
-}
+    export type DogBreedEnum = "Dingo" | "Husky" | "Retriever" | "Shepherd" ;
 

samples/openapi3/client/petstore/typescript/builds/composed-schemas/models/PetByType.ts

@@ -41,8 +41,5 @@ export class PetByType {
 }
 
 
-export enum PetByTypePetTypeEnum {
-    Cat = 'Cat',
-    Dog = 'Dog'
-}
+    export type PetByTypePetTypeEnum = "Cat" | "Dog" ;
 

samples/openapi3/client/petstore/typescript/builds/composed-schemas/models/PetsFilteredPatchRequest.ts

@@ -57,8 +57,5 @@ export class PetsFilteredPatchRequest {
 }
 
 
-export enum PetsFilteredPatchRequestPetTypeEnum {
-    Cat = 'Cat',
-    Dog = 'Dog'
-}
+    export type PetsFilteredPatchRequestPetTypeEnum = "Cat" | "Dog" ;
 

samples/openapi3/client/petstore/typescript/builds/composed-schemas/models/PetsPatchRequest.ts

@@ -58,10 +58,5 @@ export class PetsPatchRequest {
 }
 
 
-export enum PetsPatchRequestBreedEnum {
-    Dingo = 'Dingo',
-    Husky = 'Husky',
-    Retriever = 'Retriever',
-    Shepherd = 'Shepherd'
-}
+    export type PetsPatchRequestBreedEnum = "Dingo" | "Husky" | "Retriever" | "Shepherd" ;
 

samples/openapi3/client/petstore/typescript/builds/default/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/default/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/builds/deno/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/deno/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/builds/inversify/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/inversify/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/builds/jquery/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/jquery/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/builds/object_params/models/Order.ts

@@ -75,9 +75,5 @@ export class Order {
 }
 
 
-export enum OrderStatusEnum {
-    Placed = 'placed',
-    Approved = 'approved',
-    Delivered = 'delivered'
-}
+    export type OrderStatusEnum = "placed" | "approved" | "delivered" ;
 

samples/openapi3/client/petstore/typescript/builds/object_params/models/Pet.ts

@@ -77,9 +77,5 @@ export class Pet {
 }
 
 
-export enum PetStatusEnum {
-    Available = 'available',
-    Pending = 'pending',
-    Sold = 'sold'
-}
+    export type PetStatusEnum = "available" | "pending" | "sold" ;
 

samples/openapi3/client/petstore/typescript/tests/browser/test/PetApi.test.ts

@@ -1,5 +1,5 @@
 import { expect } from '@esm-bundle/chai';
-import { ServerConfiguration, createConfiguration, PetApi, Tag, Pet, PetStatusEnum, ApiException, RequiredError } from 'ts-petstore-client'
+import { ServerConfiguration, createConfiguration, PetApi, Tag, Pet, ApiException, RequiredError } from 'ts-petstore-client'
 import image from "./pet";
 
 const configuration = createConfiguration({
@@ -20,7 +20,7 @@ function createPet() {
     pet.id = Math.floor(Math.random() * 100000)
     pet.name = "PetName"
     pet.photoUrls = []
-    pet.status = PetStatusEnum.Available
+    pet.status = 'available'
     pet.tags = [ tag ]
     return pet as Required<Pet>;
 }

samples/openapi3/client/petstore/typescript/tests/default/test/api/PetApi.test.ts

@@ -18,7 +18,7 @@ describe("PetApi", () => {
         pet.id = Math.floor(Math.random() * 100000)
         pet.name = "PetName"
         pet.photoUrls = []
-        pet.status = petstore.PetStatusEnum.Available
+        pet.status = 'available'
         pet.tags = [ tag ]
 
         await petApi.addPet(pet);

samples/openapi3/client/petstore/typescript/tests/default/test/models/ObjectSerializer.test.ts

@@ -92,7 +92,7 @@ describe("ObjectSerializer", () => {
             pet.category = category
             pet.name = "PetName"
             pet.photoUrls = [ "url", "other url"] 
-            pet.status = petstore.PetStatusEnum.Available
+            pet.status = "available"
             pet.tags = tags
 
             expect(ObjectSerializer.serialize(pet, "Pet", "")).to.deep.equal({
@@ -199,7 +199,7 @@ describe("ObjectSerializer", () => {
             pet.category = category
             pet.name = "PetName"
             pet.photoUrls = [ "url", "other url"] 
-            pet.status = petstore.PetStatusEnum.Available
+            pet.status = "available"
             pet.tags = tags
 
             const deserialized = ObjectSerializer.deserialize({

samples/openapi3/client/petstore/typescript/tests/deno/test/api/PetApi_test.ts

@@ -17,7 +17,7 @@ const petId = Math.floor(Math.random() * 100000);
 pet.id = petId;
 pet.name = "PetName";
 pet.photoUrls = [];
-pet.status = petstore.PetStatusEnum.Available;
+pet.status = 'available';
 pet.tags = [tag];
 
 Deno.test({

samples/openapi3/client/petstore/typescript/tests/jquery/test/api/PetApi.test.ts

@@ -16,7 +16,7 @@ const pet = new petstore.Pet()
 pet.id = Math.floor(Math.random() * 100000)
 pet.name = "PetName"
 pet.photoUrls = []
-pet.status = petstore.PetStatusEnum.Available
+pet.status = 'available'
 pet.tags = [ tag ]
 
 QUnit.module("PetApi")

samples/openapi3/client/petstore/typescript/tests/object_params/test/api/PetApi.test.ts

@@ -15,7 +15,7 @@ const pet = new petstore.Pet()
 pet.id = Math.floor(Math.random() * 100000)
 pet.name = "PetName"
 pet.photoUrls = []
-pet.status = petstore.PetStatusEnum.Available
+pet.status = 'available'
 pet.tags = [ tag ]
 
 describe("PetApi", () =>{