Enum definitions with a single item are not included as referenced.

When referencing an enum with only a single value, the associated property is missing from the generated type.

I’ve attached an example directory that has a simple swagger.yaml and client output. Any help or known workarounds would be greatly appreciated.

The command run to create the client was:

cd output
autorest --typescript --add-credentials=true --input-file=../swagger.yaml --generate-metadata=true --output-folder=client --package-name="enum-single-item" --package-version=0.0.1

The output of that command, showing versions:

AutoRest code generation utility [version: 2.0.4283; node: v8.9.4]
(C) 2018 Microsoft Corporation.
https://aka.ms/autorest
   Loading AutoRest core      '/Users/bluecamel/.autorest/@microsoft.azure_autorest-core@2.0.4283/node_modules/@microsoft.azure/autorest-core/dist' (2.0.4283)
   Loading AutoRest extension '@microsoft.azure/autorest.typescript' (~2.0.12->2.0.304)
   Loading AutoRest extension '@microsoft.azure/autorest.modeler' (2.1.23->2.1.23)

The relevant model definitions:

definitions:
  Thing:
    x-ms-enum:
      name: Thing
    type: string
    enum:
      - thinger

  Stuff:
    properties:
      message:
        type: string
      thing:
        $ref: '#/definitions/Thing'
    required:
      - message
      - thing

The enum is generated correctly:

/**
 * Defines values for Thing.
 * Possible values include: 'thinger'
 * @readonly
 * @enum {string}
 */
export enum Thing {
  Thinger = 'thinger',
}

However, the property is missing from the generated interface that references the enum:

/**
 * @interface
 * An interface representing Stuff.
 */
export interface Stuff {
  /**
   * @member {string} message
   */
  message: string;
}

enum-single-item.zip

[RikkiGibson]

I’ll consider this resolved as by-design. Please follow up if you have any additional questions.

[RikkiGibson]

We had a need to be able to define constant-valued properties and parameters from an API design perspective and we adapted single-case enums to do so. See https://github.com/Azure/autorest/blob/master/docs/developer/guide/defining-clients-swagger.md#constants

If you poke around in ms-rest-js’s serviceClient or serializer you’ll see that at runtime we add the default values for the constant properties for you.

re x-ms-enum: you might be able to get the modeler to treat it as a user-visible string property if you want by providing modelAsString: true. Haven’t tried it myself.