November's Paddleball Marathon


    6.0.0-beta.19 • Public • Published

    TypeScript Plugin for Autorest

    Autorest is a suite of tools to automatically generate SDKs for cloud services. This project provides an autorest extension that generates SDKs in TypeScript.

    Note: This project, @autorest/typescript is the latest version of the TS/JS SDK generator and is currently in preview. The earlier stable version of the SDK generator is available in the v4x branch of the Azure/autorest.typescript repository.

    Auto-generate your package in TypeScript using Autorest

    It is easy to generate an SDK once you have a swagger specification file.

    • You will need first to install Autorest
    npm install -g autorest
    • You can then generate the SDK as follows:
    autorest --typescript <path to the swagger file>
    • You will likely need to specify extra flags to control the behavior of the generation, and these flags are listed in the next section.


    In addition to the list of Autorest flags, you can further control the behavior of the typescript generator with the following flags:

    Flag Description
    --use-core-v2 Uses azure core v2 and it is enabled by default. Please set it to false if you need to regenerate a package that uses core-http and you do not want to do the migration to core v2 in that regeneration. For differences between v1 and v2, please refer to
    --hide-client Hides the client class from docs. This is typically useful when the you will write a convenience layer on top of the generated client
    --ignore-nullable-on-optional If an optional property is also marked as nullable, it will be treated as just optional
    --generate-metadata Generates meta files such as readme, license, package.json, etc. Typically, you need to specify this flag in your first generation only
    --tracing-info Controls specification of meta info attached to requests for tracing purposes
    --disable-async-iterators Does not generate async iterators needed for paging operations
    --allow-insecure-connection Allow generated clients to make requests to HTTP endpoints


    This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

    When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

    This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

    Autorest Typescript Plugin Configuration

    version: 3.6.6
      "@autorest/modelerfour": "4.21.4"
      # this runs a pre-namer step to clean up names
      prenamer: true
      # this will flatten modelers marked with 'x-ms-client-flatten'
      flatten-models: true
      # this will flatten parameters marked with 'x-ms-client-flatten'
      flatten-payloads: true
      # this will make the content-type parameter always specified
      always-create-content-type-parameter: true
      # enables parameter grouping via x-ms-parameter-grouping
      group-parameters: true
      # Enable older inconsistent behavior that an enum with a single value would become a constant by default.
      seal-single-value-enum-by-default: true
      input-artifact: typescript-files
    output-artifact: typescript-files
      typescript: # <- name of plugin
        input: modelerfour/identity
        output-artifact: typescript-files
        input: typescript
        scope: typescript-scope/emitter
      "@autorest/testmodeler": "1.0.4"
        - ./
        - ./
      split-parents-value: false
    include-x-ms-examples-original-file: true
      include-x-ms-examples-original-file: true
        input: modelerfour/identity
        # scope : output-scope
        input: test-modeler
        input: test-modeler/identity
        output-artifact: typescript-files
        input: typescript
        scope: typescript-scope/emitter

    REST Client Generator overrides

      # this runs a pre-namer step to clean up names
      prenamer: true
      flatten-models: false
      flatten-payloads: false
      always-create-content-type-parameter: true
      group-parameters: false


      typescript: # type: Help as defined in autorest-core/help.ts
        activationScope: typescript
        categoryFriendlyName: Typescript Generator
          - key: azure-arm
            description: Generate management plane flavor. Setting up the required flags for arm libraries
          - key: license-header
            description: "text to include as a header comment in generated files (magic strings: MICROSOFT_MIT, MICROSOFT_APACHE, MICROSOFT_MIT_NO_VERSION, MICROSOFT_APACHE_NO_VERSION, MICROSOFT_MIT_NO_CODEGEN)"
            type: string
          - key: add-credentials
            description: include a credential property and constructor parameter supporting different authentication behaviors
          - key: credential-scopes
            type: string | string[]
            description: Specify the scopes over which the credential functions. When generating management plane we default the scope to ''
          - key: package-name
            type: string
            description: The name of your package. This is the name your package will be published under.
          - key: source-code-folder-path
            type: string
            description: Where to output the generated code inside the output-folder. Defaults to src.
          - key: generate-metadata
            description: Whether to generate extra metadata in your package. For instance, generates a README file, license file etc if set to true.
          - key: disable-async-iterators
            description: Whether to generate pageable methods as AsyncIterators. Defaults to true.

    Language Specific Requirements: TypeScript

    For TypeScript projects, simply import autorest-extension-base which implements the AutoRest extension protocol and offers a simple API to register plugins. See index.ts.




    npm i @autorest/typescript@6.0.0-beta.19





    Unpacked Size

    1.35 MB

    Total Files


    Last publish


    • azure-sdk