@azure-tools/typespec-providerhub-controller 0.27.0

package/readme.md

@@ -0,0 +1,66 @@
+# TypeSpec Service Code Generator for ProviderHub
+
+The TypeSpec service code generator for ProviderHub creates an abstract UserRP implementation of specs using the typespec-providerhub extension. Code is generating using the ASP.NET MVC framework. This doc discusses the high-level design, challenges, and remaining work.
+
+We recommend consuming this package through the [typespec-providerhub-templates](https://github.com/Azure/typespec-azure/tree/main/packages/typespec-providerhub-templates), which contains a full service implementation in ASP.Net Core MVC, and sets the appropriate configurations for swagger generation, hosting your service, RP and resource registration, and end-to-end testing in RPaaS OneBox.
+
+## Usage
+
+Any TypeSpec spec defined with `@azure-tools/typespec-azure-resource-manager` can have server-side controller stub code generated by following these steps:
+
+1. Ensure `@azure-tools/typespec-providerhub-controller` is a `dependency` in your project's `package.json` file
+1. Ensure this line is in your main spec file's imports: `import "@azure-tools/typespec-providerhub-controller"`
+1. Run the following command in your project folder:
+
+```
+tsp compile . --emit @azure-tools/typespec-providerhub-controller
+```
+
+### Emitter Options
+
+Emitter options can be configured via the `tspconfig.yaml` configuration:
+
+```yaml
+emitters:
+  '@azure-tools/typespec-providerhub-controller':
+    <optionName>: <value>
+
+
+# For example
+emitters:
+  '@azure-tools/typespec-providerhub-controller':
+    include-operation-controller: true
+```
+
+or via the command line with
+
+```bash
+--option "@azure-tools/typespec-providerhub-controller.<optionName>=<value>"
+
+# For example
+--option "@azure-tools/typespec-providerhub-controller.include-operation-controller=true"
+```
+
+#### `output-dir`
+
+Path where the service code will be generated. By default will use the compiler `output-dir`.
+
+#### `include-operation-controller`
+
+An `OperationController` will be generated to handle operation endpoint requests in your service. This is not enabled by default since most ProviderHub services will use the operation endpoint that is provided automatically by Azure Resource Manager.
+**NOTE:** This is not usually needed for ProviderHub services.
+
+#### `operation-polling-location`
+
+Determines whether a tenant-level ("tenant") or subscription-level ("subscription") status monitor is used for long-running operations. By default, uses the tenant-level status monitor provided by RPaaS.
+
+#### `registration-output-path`
+
+When set to a valid path, generates provider and type registration documents to the specified path. These can be used to register your resource provider and your resource types with RPaaS, for later creation of your manifest.
+
+#### `code-kind`
+
+Type of generation:
+
+- When set to `controller`, generates only controller code and assume that the model will be generated in separate process.
+- When set to `model` , generates only model code and assume that the controller will be generated in separate process.

package/templates/liftr/closedEnum.sq

@@ -0,0 +1,27 @@
+//-----------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.  All rights reserved.
+//-----------------------------------------------------------------------------
+
+// <auto-generated />
+
+using System;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+{{#if isDefined(description) }}
+    /// <summary>
+    {{> renderComment content=description}}
+    /// </summary>
+{{/if}}
+    public enum {{name}} 
+    {
+{{#each values}}
+{{#if isDefined(description)}}
+        /// <summary>
+        {{> renderComment content=description}}
+        /// </summary>
+{{/if}}
+        {{name}} = "{{#if isDefined(value)}}{{value}}{{else}}{{name}}"{{ #unless @last }},{{/unless}}
+{{/each}}
+    }
+}

package/templates/liftr/model.sq

@@ -0,0 +1,43 @@
+//-----------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.  All rights reserved.
+//-----------------------------------------------------------------------------
+
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using Microsoft.TypeSpec.ProviderHub.Controller;
+{{#if (hasConverter this)}}
+using Newtonsoft.Json;
+{{/if}}
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+{{#if description}}
+    /// <summary>
+    {{> renderComment content=description}} 
+    /// </summary>
+{{/if}}
+    public class {{name}}{{#if (or isDerivedType isImplementer)}} : {{#if baseClass}}{{baseClass.name}}{{#if baseClass.typeParameters}}<{{typeParamList baseClass}}>{{/if}}{{/if}}{{#if implements}}{{#if isDerivedType}}, {{/if}}{{join implements ", "}}{{/if}}{{/if}} 
+    {
+{{#each properties}}
+{{#if description}}
+        /// <summary>
+        ///  {{description}} 
+        /// </summary>
+{{/if}}
+{{#if validations}}
+{{#each validations}}
+        [{{name}}({{#each parameters}}{{#if (eq type "string")}}@"{{/if}}{{value}}{{#if (eq type "string")}}"{{/if}}{{#unless @last}}, {{/unless}}{{/each}})]
+{{/each}}
+{{/if}}
+{{#if converters}}
+{{#each converters}}
+        [JsonConverter(typeof({{name}}))]
+{{/each}}
+{{/if}}
+        public {{type.name}}{{#if type.typeParameters}}<{{typeParamList type}}>{{/if}} {{name}} { get; set; }{{#if default}} = {{default}};{{/if}}
+
+{{/each}}
+    }
+}

package/templates/liftr/openEnum.sq

@@ -0,0 +1,34 @@
+//-----------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.  All rights reserved.
+//-----------------------------------------------------------------------------
+
+// <auto-generated />
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+{{#if description}}
+    /// <summary>
+    {{> renderComment content=description}}
+    /// </summary>
+{{/if}}
+    public struct {{name}} 
+    {
+        public static readonly {{name}} {{#each values as |value valueIndex|}}{{value.name}} = "{{#if value.value}}{{value.value}}{{else}}{{value.name}}{{/if}}"{{#if @last}};{{else}},{{/if}} {{/each}}
+
+        private readonly string _value;
+
+        public {{name}}(string value)
+        {
+            _value = value;
+        }
+
+        public override string ToString() =>
+            _value;
+
+        public static implicit operator string({{name}} objValue) =>
+            objValue.ToString();
+
+        public static implicit operator {{name}}(string other) =>
+            new {{name}}(other);
+    }
+}

package/templates/liftr/resourceControllerBase.sq

@@ -0,0 +1,140 @@
+// <auto-generated />
+
+{{#with this as |res|}}
+using System;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.TypeSpec.ProviderHub.Controller;
+using {{nameSpace}}.Service.Models;
+using {{nameSpace}}.Service.Controllers;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+
+namespace {{nameSpace}}.Service
+{
+    /// <summary>
+    /// Controller for user RP operations on the {{res.name}} resource.
+    /// </summary>
+    [ApiController]
+    public abstract class {{res.name}}ControllerBase : ControllerBase
+    {
+        protected readonly ILogger<{{res.name}}ControllerBase> _logger;
+
+        protected {{res.name}}ControllerBase(ILogger<{{res.name}}ControllerBase> logger)
+        {
+            _logger = logger;
+        }
+{{#each operations as |operation operationIndex|}}
+
+{{#if (getOperationAction operation)}}
+{{#if (notCustomOp operation)}}
+        /// <summary>
+        /// Validate the request to {{getOperationAction operation}} the {{res.name}} resource.
+        /// </summary>
+{{#each operation.parameters as |parameter index |}}
+        /// <param name="{{parameter.name}}">
+        {{> renderComment content=parameter.description}}
+        /// </param>
+{{/each}}
+        /// <returns> A ValidationResponse indicating the validity of the {{getOperationAction operation}} request.</returns>
+        [HttpPost]
+        [Route({{res.serviceName}}ServiceRoutes.{{res.name}}Validate{{getOperationAction operation}})]
+        [ProducesResponseType((int)HttpStatusCode.OK, Type = typeof(ValidationResponse))]
+        public async Task<ValidationResponse> Validate{{getOperationAction operation}}Async({{decl operation}})
+        {
+            _logger.LogInformation($"Validate{{getOperationAction operation}}Async()");
+{{#if (isDefined operation.requestParameter)}}
+            var modelValidation = ValidationHelpers.ValidateModel({{operation.requestParameter.name}});
+            if (modelValidation.IsValid)
+            {
+                modelValidation = await OnValidate{{getOperationAction operation}}Async({{call operation}});
+            }
+
+{{else}}
+            var modelValidation = await OnValidate{{getOperationAction operation}}Async({{call operation}});
+{{/if}}
+            return modelValidation;
+        }
+
+{{/if}}
+        /// <summary>
+        /// {{getOperationAction operation}} the {{res.name}} resource.
+        /// </summary>
+{{#each operation.parameters as |parameter index|}}
+        /// <param name="{{parameter.name}}"> 
+        {{> renderComment content=parameter.description}}
+        /// </param>
+{{/each}}
+        /// <returns> The {{res.name}} resource.</returns>
+        [Http{{initialCaps operation.verb }}]
+        [Route({{res.serviceName}}ServiceRoutes.{{res.name}}Item{{#unless (notCustomOp operation)}}{{getOperationAction operation}}{{/unless}})]
+        [ProducesResponseType((int)HttpStatusCode.OK, Type = typeof({{operation.returnType}}))]
+{{#if (or (eq (getOperationAction operation) "Create") (eq (getOperationAction operation) "Patch"))}}
+        [ProducesResponseType((int)HttpStatusCode.Created, Type = typeof({{operation.returnType}}))]
+{{/if}}
+{{#if (eqi operation.verb "DELETE")}}
+        [ProducesResponseType((int)HttpStatusCode.NoContent, Type = typeof({{operation.returnType}}))]
+{{/if}}
+        public async Task<IActionResult> {{getOperationAction operation}}Async({{decl operation}})
+        {
+            _logger.LogInformation("{{getOperationAction operation}}Async()");
+{{#if operation.requestParameter}}
+            {{operation.requestParameter.name}} = {{operation.requestParameter.name}} ?? throw new ArgumentNullException(nameof({{operation.requestParameter.name}}));
+
+{{/if}}
+            if (Request == null)
+            {
+                _logger.LogError($"Http request is null");
+                return BadRequest("Http request is null");
+            }
+
+            return await On{{getOperationAction operation}}Async({{call operation }});
+
+        }
+
+        protected abstract Task<IActionResult> OnValidate{{getOperationAction operation}}Async({{decl operation}});
+
+        protected abstract Task<IActionResult> On{{getOperationAction operation}}Async({{decl operation}});
+
+{{/if}}
+{{/each}}
+{{#if res.hasSubscriptionList}}
+        /// <summary>
+        /// List Organization resources in the specified subscription.
+        /// </summary>
+        /// <param name="subscriptionId"> The subscription id.</param>
+        /// <returns> The list of {{res.name}} Resources in the specified subscription.</returns>
+        [HttpGet]
+        [Route({{res.serviceName}}ServiceRoutes.{{res.name}}ListBySubscription)]
+        [ProducesResponseType((int)HttpStatusCode.OK, Type = typeof({{res.specificationListModelName}}))]
+        public Task<{{res.specificationListModelName}}> ListBySubscription(string subscriptionId)
+        {
+            _logger.LogInformation("ListBySubscriptionAsync()");
+            return OnListBySubscription(subscriptionId);
+        }
+
+        protected abstract Task<{{res.specificationListModelName}}> OnListBySubscription(string subscriptionId);
+
+{{/if}}
+{{#if res.hasResourceGroupList}}
+        /// <summary>
+        /// List {{res.name}} resources in the specified resource group.
+        /// </summary>
+        /// <param name="subscriptionId"> The subscription id.</param>
+        /// <param name="resourceGroupName"> The resource group name.</param>
+        /// <returns> The list of {{res.name}} Resources in the specified resource group.</returns>
+        [HttpGet]
+        [Route({{res.serviceName}}ServiceRoutes.{{res.name}}ListByResourceGroup)]
+        [ProducesResponseType((int)HttpStatusCode.OK, Type = typeof({{res.specificationListModelName}}))]
+        public Task<{{res.specificationListModelName}}> ListByResourceGroupAsync(string subscriptionId, string resourceGroupName)
+        {
+            _logger.LogInformation("ListByResourceGroupAsync()");
+            return OnListByResourceGroupAsync(subscriptionId, resourceGroupName);
+        }
+                
+        protected abstract Task<{{res.specificationListModelName}}> OnListByResourceGroupAsync(string subscriptionId, string resourceGroupName);
+{{/if}}
+    }
+}
+{{/with}}

package/templates/liftr/serviceRoutingConstants.sq

@@ -0,0 +1,35 @@
+// <auto-generated />
+
+namespace {{nameSpace}}.Service.Controllers
+{
+    public static class {{serviceName}}ServiceRoutes
+    {
+{{#if includeOperationController}}
+        public const string ListOperations = "providers/{{nameSpace}}/operations";
+{{/if}}
+{{#each resources as |resource index |}}
+        public const string {{resource.name}}Item = "{{resource.itemPath}}";
+{{#if resource.hasSubscriptionList}}
+        public const string {{resource.name}}ListBySubscription = "/subscriptions/{subscriptionId}/providers/{{resource.nameSpace}}/{{resource.serializedName}}";
+{{/if}}
+{{#if resource.hasResourceGroupList}}
+        public const string {{resource.name}}ListByResourceGroup = "/subscriptions/{subscriptionId}/resourceGroups{resourceGroupName}/providers/{{resource.nameSpace}}/{{resource.serializedName}}";
+{{/if}}
+{{#each resource.operations as | operation opIndex |}}
+{{#if (eqi operation.verb "PUT")}}
+        public const string {{resource.name}}ValidateCreate = "{{resource.itemPath}}/validateCreate";
+{{/if}}
+{{#if (eqi operation.verb "PATCH")}}
+        public const string {{resource.name}}ValidatePatch = "{{resource.itemPath}}/validatePatch";
+{{/if}}
+{{#if (eqi operation.verb "DELETE")}}
+        public const string {{resource.name}}ValidateDelete = "{{resource.itemPath}}/validateDelete";
+{{/if}}
+{{#if (eqi operation.verb "POST")}}
+        public const string {{resource.name}}Validate{{operation.name}} = "{{resource.itemPath}}/validate{{initialCaps operation.subPath}}";
+        public const string {{resource.name}}Item{{operation.name}} = "{{resource.itemPath}}/{{operation.subPath}}";
+{{/if}}
+{{/each}}
+{{/each}}
+    }
+}

package/templates/liftr/single/Operation.sq

@@ -0,0 +1,40 @@
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+    /// <summary>
+    /// Description of an RP Operation.
+    /// </summary>
+    public class Operation
+    {
+        /// <summary>
+        /// The name of the operation, as per Resource-Based Access Control (RBAC). Examples: \"Microsoft.Compute/virtualMachines/write\", \"Microsoft.Compute/virtualMachines/capture/action\
+        /// </summary>
+        public string Name { get; internal set; }
+
+        /// <summary>
+        /// Whether the operation applies to data-plane. This is \"true\" for data-plane operations and \"false\" for ARM/control-plane operations.
+        /// </summary>
+        public bool IsDataAction {get; internal set;}
+
+        /// <summary>
+        /// Localized display information for this particular operation.
+        /// </summary>
+        public OperationDisplay Display {get; internal set;}
+
+        /// <summary>
+        /// The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is \"user,system\"
+        /// </summary>
+        public OperationOrigin Origin {get; internal set;}
+
+        /// <summary>
+        /// Indicates the action type. \"Internal\" refers to actions that are for internal only APIs.
+        /// </summary>
+        public OperationAction ActionType {get; internal set;}
+    }
+}

package/templates/liftr/single/OperationAction.sq

@@ -0,0 +1,31 @@
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+    /// <summary>
+    /// Indicates the action type. \"Internal\" refers to actions that are for internal only APIs.
+    /// </summary>
+    public struct OperationAction
+    {
+        string _value;
+
+        public static readonly OperationAction Internal = "internal";
+        public OperationAction( string value)
+        {
+            _value = value;
+        }
+
+        public override string ToString()
+        {
+            return _value;
+        }
+
+        public static implicit operator string( OperationAction objValue) => objValue.ToString();
+        public static implicit operator OperationAction( string other) => new OperationAction(other);
+    }
+}

package/templates/liftr/single/OperationControllerBase.sq

@@ -0,0 +1,38 @@
+// <auto-generated />
+
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+using System.Threading.Tasks;
+using {{nameSpace}}.Service.Models;
+using {{nameSpace}}.Service.Controllers;
+using System.Net;
+
+namespace {{nameSpace}}.Service
+{
+    public abstract class OperationControllerBase : Controller
+    {
+        internal readonly ILogger<OperationControllerBase> _logger;
+
+        public OperationControllerBase(ILogger<OperationControllerBase> logger)
+        {
+            _logger = logger;
+        }
+
+        /// <summary>
+        /// List all operations provided by {{nameSpace}}.
+        /// </summary>
+        /// <returns> The list of {{nameSpace}} operations.</returns>
+        [HttpGet]
+        [Route({{serviceName}}ServiceRoutes.ListOperations)]
+        [ProducesResponseType((int)HttpStatusCode.OK, Type = typeof(OperationListResult))]
+        public async Task<OperationListResult> ListOperationsAsync()
+        {
+            _logger.LogInformation("ListOperationsAsync()");
+            return await OnOperationListAsync(Request);
+        }
+
+        internal abstract Task<OperationListResult> OnOperationListAsync(HttpRequest request);
+
+    }
+}

package/templates/liftr/single/OperationDisplay.sq

@@ -0,0 +1,35 @@
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+    /// <summary>
+    /// Localized display information for this particular operation.
+    /// </summary>
+    public class OperationDisplay
+    {
+        /// <summary>
+        /// The localized friendly form of the resource provider name, e.g. \"Microsoft Monitoring Insights\" or \"Microsoft Compute\".
+        /// </summary>
+        public string Provider { get; internal set; }
+
+        /// <summary>
+        /// The localized friendly name of the resource type related to this operation. E.g. \"Virtual Machines\" or \"Job Schedule Collections\".
+        /// </summary>
+        public string Resource {get; internal set;}
+
+        /// <summary>
+        /// The concise, localized friendly name for the operation; suitable for dropdowns. E.g. \"Create or Update Virtual Machine\", \"Restart Virtual Machine\".
+        /// </summary>
+        public string Operation {get; internal set;}
+
+        /// <summary>
+        /// The short, localized friendly description of the operation; suitable for tool tips and detailed views.
+        /// </summary>
+        public string Description {get; internal set;}
+    }
+}

package/templates/liftr/single/OperationListResult.sq

@@ -0,0 +1,17 @@
+// <auto-generated />
+
+using Microsoft.TypeSpec.ProviderHub;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+    /// <summary>
+    /// Paged list of RP operations.
+    /// </summary>
+    public class OperationListResult : Pageable<Operation>
+    {
+    }
+}

package/templates/liftr/single/OperationOrigin.sq

@@ -0,0 +1,31 @@
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Microsoft.{{serviceName}}.Service.Models
+{
+    /// <summary>
+    /// The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is \"user,system\".
+    /// </summary>
+    public struct OperationOrigin
+    {
+        string _value;
+
+        public static readonly OperationOrigin User = "user", System = "system", UserAndSystem = "user,system";
+        public OperationOrigin( string value)
+        {
+            _value = value;
+        }
+
+        public override string ToString()
+        {
+            return _value;
+        }
+
+        public static implicit operator string( OperationOrigin objValue) => objValue.ToString();
+        public static implicit operator OperationOrigin( string other) => new OperationOrigin(other);
+    }
+}

package/templates/providerhub/closedEnum.sq

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+// <auto-generated />
+
+namespace {{nameSpace}}.Service.Models
+{
+{{#if isDefined(description)}}
+    /// <summary>
+    {{> renderComment content=description}}
+    /// </summary>
+{{/if}}
+    public enum {{name}} 
+    {
+{{#each values}}
+{{#if isDefined(description)}}
+        /// <summary>
+        {{> renderComment content=description}}
+        /// </summary>
+{{/if}}
+        {{name}} = "{{#if isDefined(value)}}{{value}}{{else}}{{name}}"{{#unless @last }},{{/unless}}
+{{/each}}
+    }
+}

package/templates/providerhub/model.sq

@@ -0,0 +1,103 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+// <auto-generated />
+
+using System;
+using System.Collections.Generic;
+using Newtonsoft.Json;
+using Microsoft.TypeSpec.ProviderHub.Controller;
+{{#if (and discriminatorInfo (ne discriminatorBaseType.namespace namespace))}}
+using {{discriminatorBaseType.namespace}};
+{{/if}}
+
+namespace {{nameSpace}}.Service.Models
+{
+{{#if discriminatorInfo}}
+    [Discriminator(DiscriminatorPropertyName, DiscriminatorValue)]
+    [JsonConverter(typeof(DiscriminatorJsonConverter<{{discriminatorInfo.baseType.name}}>))]
+{{/if}}
+{{#if description}}
+    /// <summary>
+    {{> renderComment content=description}} 
+    /// </summary>
+{{/if}}
+    public {{#if discriminatorInfo}}{{#if (eq discriminatorInfo.value "")}}abstract {{/if}}{{/if}}partial class {{name}}{{#if (or isDerivedType isImplementer)}} : {{#if baseClass}}{{baseClass.name}}{{#if baseClass.typeParameters}}<{{typeParamList baseClass}}>{{/if}}{{/if}}{{#if implements}}{{#if isDerivedType}}, {{/if}}{{joinByName implements ", "}}{{/if}}{{/if}}
+    {{curly true}}{{#if discriminatorInfo}}
+        // Discriminator value
+        private const string DiscriminatorValue = "{{discriminatorInfo.value}}";{{#if (eq discriminatorInfo.value "")}}
+
+        // Discriminator property name
+        protected const string DiscriminatorPropertyName = "{{discriminatorInfo.propertyName}}";{{/if}}{{/if}}
+
+        /// <summary>
+        /// Extensibility point - allows changing class properties during construction.
+        /// </summary>
+        partial void OnBeforeInitialize();
+
+        /// <summary>
+        /// Extensibility point - allows changing class properties during construction.
+        /// </summary>
+        partial void OnAfterInitialize();
+
+        /// <summary>
+        /// Initializes a new instance of the {{name}} class.
+        /// </summary>
+        public {{name}}()
+        {
+            OnBeforeInitialize();
+{{#if (and discriminatorInfo discriminatorInfo.value)}}
+            {{csharpname discriminatorInfo.propertyName}} = DiscriminatorValue;
+{{/if}}
+{{#if (and isVersioned (not hasVersionedAncestor))}}
+            VersionInfo = new {{name}}VersionInfo(this);
+{{/if}}
+{{#if (and isVersioned hasVersionedAncestor)}}
+            VersionInfo = new {{name}}VersionInfo(this, VersionInfo);
+{{/if}}
+            OnAfterInitialize();
+        }
+
+{{#each properties}}
+{{#if description}}
+        /// <summary>
+        {{> renderComment content=description}} 
+        /// </summary>
+{{/if}}
+{{#if versions}}
+{{#each versions}}
+        [{{name}}("{{onVersion}}")]
+{{/each}}
+{{/if}}
+{{#if validations}}
+{{#each validations}}
+        [{{name}}({{#each parameters}}{{#if (eq type "string")}}@"{{/if}}{{value}}{{#if (eq type "string")}}"{{/if}}{{#unless @last}}, {{/unless}}{{/each}})]
+{{/each}}
+{{/if}}
+{{#if converters}}
+{{#each converters}}
+        [JsonConverter(typeof({{name}}))]
+{{/each}}
+{{/if}}
+        [JsonProperty("{{serializedName}}")]
+        public {{type.name}}{{#if type.typeParameters}}<{{typeParamList type}}>{{/if}} {{name}} { get; set; }{{#if default}} = {{default}};{{/if}}
+{{#unless @last}}
+
+{{/unless}}{{/each}}
+{{#if (and isVersioned (not hasVersionedAncestor))}}
+        /// <summary>
+        /// The version information for this class.
+        /// </summary>
+        [JsonIgnore]
+        public ResourceVersionInfo VersionInfo { get; set; }{{/if}}
+{{#if isSerialized}}
+{{#if isVersioned}}
+
+{{/if}}
+        /// <summary>
+        /// Tracks deserialization of the resource.
+        /// </summary>
+        [JsonIgnore]
+        public ResourceSerializationInfo SerializationInfo { get; set; } = new DefaultSerializationInfo();{{/if}}
+    }
+}