@team-supercharge/oasg 18.0.2 → 18.2.0

package/targets/dotnet-webapi-system-text-json/templates/model.mustache

@@ -0,0 +1,205 @@
+{{>partial_header}}
+using System;
+using System.Linq;
+using System.Text;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.ComponentModel.DataAnnotations;
+using System.Runtime.Serialization;
+{{#useNewtonsoft}}
+using Newtonsoft.Json;
+{{/useNewtonsoft}}
+{{^useNewtonsoft}}
+using System.Text.Json;
+using System.Text.Json.Serialization;
+{{/useNewtonsoft}}
+{{#models}}
+{{#model}}
+{{#discriminator}}
+using JsonSubTypes;
+{{#useSwashbuckle}}
+using Swashbuckle.AspNetCore.Annotations;
+{{/useSwashbuckle}}
+{{/discriminator}}
+{{/model}}
+{{/models}}
+
+{{#models}}
+{{#model}}
+namespace {{modelPackage}}
+{ {{#isEnum}}{{>enumClass}}{{/isEnum}}{{^isEnum}}
+    /// <summary>
+    /// {{description}}
+    /// </summary>
+    [DataContract]
+    {{#discriminator}}
+    {{#useNewtonsoft}}
+    {{#mappedModels.size}}
+    [JsonConverter(typeof(JsonSubtypes), "{{{discriminatorName}}}")]
+    {{/mappedModels.size}}
+    {{/useNewtonsoft}}
+    {{#useSwashbuckle}}
+    [SwaggerDiscriminator("{{{discriminatorName}}}")]
+    {{/useSwashbuckle}}
+    {{#mappedModels}}
+    [JsonSubtypes.KnownSubType(typeof({{{modelName}}}), "{{^vendorExtensions.x-discriminator-value}}{{{mappingName}}}{{/vendorExtensions.x-discriminator-value}}{{#vendorExtensions.x-discriminator-value}}{{{.}}}{{/vendorExtensions.x-discriminator-value}}")]
+    {{#useSwashbuckle}}
+    [SwaggerSubType(typeof({{{modelName}}}), DiscriminatorValue =  "{{^vendorExtensions.x-discriminator-value}}{{{mappingName}}}{{/vendorExtensions.x-discriminator-value}}{{#vendorExtensions.x-discriminator-value}}{{{.}}}{{/vendorExtensions.x-discriminator-value}}")]
+    {{/useSwashbuckle}}
+    {{/mappedModels}}
+    {{/discriminator}}
+    public {{#modelClassModifier}}{{.}} {{/modelClassModifier}}class {{classname}} {{#parent}}: {{{.}}}{{^pocoModels}}, {{/pocoModels}}{{/parent}}{{^pocoModels}}{{^parent}}: {{/parent}}IEquatable<{{classname}}>{{/pocoModels}}
+    {
+        {{#vars}}
+        {{#items.isEnum}}
+        {{#items}}
+        {{^complexType}}
+{{>enumClass}}
+        {{/complexType}}
+        {{/items}}
+        {{/items.isEnum}}
+        {{#isEnum}}
+        {{^complexType}}
+{{>enumClass}}
+        {{/complexType}}
+        {{/isEnum}}
+        /// <summary>
+        /// {{description}}{{^description}}Gets or Sets {{{name}}}{{/description}}
+        /// </summary>{{#description}}
+        /// <value>{{.}}</value>{{/description}}{{#example}}
+        /* <example>{{.}}</example> */{{/example}}{{#required}}
+        [Required]{{/required}}{{#pattern}}
+        [RegularExpression("{{{.}}}")]{{/pattern}}{{#minLength}}{{#maxLength}}
+        [StringLength({{maxLength}}, MinimumLength={{minLength}})]{{/maxLength}}{{/minLength}}{{#minLength}}{{^maxLength}}
+        [MinLength({{minLength}})]{{/maxLength}}{{/minLength}}{{^minLength}}{{#maxLength}}
+        [MaxLength({{.}})]{{/maxLength}}{{/minLength}}{{#minimum}}{{#maximum}}
+        [Range({{minimum}}, {{maximum}})]{{/maximum}}{{/minimum}}
+        [DataMember(Name="{{baseName}}", EmitDefaultValue={{#isNullable}}true{{/isNullable}}{{^isNullable}}{{#vendorExtensions.x-is-value-type}}true{{/vendorExtensions.x-is-value-type}}{{^vendorExtensions.x-is-value-type}}false{{/vendorExtensions.x-is-value-type}}{{/isNullable}})]
+        {{#isEnum}}
+        public {{{datatypeWithEnum}}}{{#isNullable}}{{^required}}?{{/required}}{{/isNullable}} {{name}} { get; set; }{{#defaultValue}} = {{{.}}};{{/defaultValue}}
+        {{/isEnum}}
+        {{^isEnum}}
+        public {{{dataType}}}{{#nullableReferenceTypes}}{{^isContainer}}{{^required}}{{^isNullable}}?{{/isNullable}}{{/required}}{{/isContainer}}{{/nullableReferenceTypes}} {{name}} { get; set; }{{#defaultValue}} = {{{.}}};{{/defaultValue}}
+        {{/isEnum}}
+        {{^-last}}
+
+        {{/-last}}
+        {{/vars}}
+
+        {{^pocoModels}}
+        /// <summary>
+        /// Returns the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append("class {{classname}} {\n");
+            {{#vars}}
+            sb.Append("  {{name}}: ").Append({{name}}).Append("\n");
+            {{/vars}}
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// Returns the JSON string presentation of the object
+        /// </summary>
+        /// <returns>JSON string presentation of the object</returns>
+        public {{#parent}}{{^isMap}}{{^isArray}}new {{/isArray}}{{/isMap}}{{/parent}}string ToJson()
+        {
+            {{#useNewtonsoft}}
+            return JsonConvert.SerializeObject(this, Formatting.Indented);
+            {{/useNewtonsoft}}
+            {{^useNewtonsoft}}
+            return JsonSerializer.Serialize(this, {{classname}}SerializationContext.Default.{{classname}});
+            {{/useNewtonsoft}}
+        }
+
+        /// <summary>
+        /// Returns true if objects are equal
+        /// </summary>
+        /// <param name="obj">Object to be compared</param>
+        /// <returns>Boolean</returns>
+        public override bool Equals(object obj)
+        {
+            if (obj is null) return false;
+            if (ReferenceEquals(this, obj)) return true;
+            return obj.GetType() == GetType() && Equals(({{classname}})obj);
+        }
+
+        /// <summary>
+        /// Returns true if {{classname}} instances are equal
+        /// </summary>
+        /// <param name="other">Instance of {{classname}} to be compared</param>
+        /// <returns>Boolean</returns>
+        public bool Equals({{classname}} other)
+        {
+            if (other is null) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return {{#vars}}{{^isContainer}}
+                (
+                    {{name}} == other.{{name}} ||
+                    {{^vendorExtensions.x-is-value-type}}{{name}} != null &&{{/vendorExtensions.x-is-value-type}}
+                    {{name}}.Equals(other.{{name}})
+                ){{^-last}} && {{/-last}}{{/isContainer}}{{#isContainer}}
+                (
+                    {{name}} == other.{{name}} ||
+                    {{^vendorExtensions.x-is-value-type}}{{name}} != null &&
+                    other.{{name}} != null &&
+                    {{/vendorExtensions.x-is-value-type}}{{name}}.SequenceEqual(other.{{name}})
+                ){{^-last}} && {{/-last}}{{/isContainer}}{{/vars}}{{^vars}}false{{/vars}};
+        }
+
+        /// <summary>
+        /// Gets the hash code
+        /// </summary>
+        /// <returns>Hash code</returns>
+        public override int GetHashCode()
+        {
+            unchecked // Overflow is fine, just wrap
+            {
+                var hashCode = 41;
+                // Suitable nullity checks etc, of course :)
+                {{#vars}}
+                    {{^vendorExtensions.x-is-value-type}}if ({{name}} != null){{/vendorExtensions.x-is-value-type}}
+                    hashCode = hashCode * 59 + {{name}}.GetHashCode();
+                {{/vars}}
+                return hashCode;
+            }
+        }
+
+        #region Operators
+        #pragma warning disable 1591
+
+        public static bool operator ==({{classname}} left, {{classname}} right)
+        {
+            return Equals(left, right);
+        }
+
+        public static bool operator !=({{classname}} left, {{classname}} right)
+        {
+            return !Equals(left, right);
+        }
+
+        #pragma warning restore 1591
+        #endregion Operators
+        {{/pocoModels}}
+    }
+{{^useNewtonsoft}}
+
+    /// <summary>
+    /// System.Text.Json source-generation context for <see cref="{{classname}}" />.
+    /// Used by ToJson() so (de)serialization is trim- and AOT-safe.
+    /// </summary>
+    [JsonSourceGenerationOptions(WriteIndented = true)]
+    [JsonSerializable(typeof({{classname}}))]
+    internal partial class {{classname}}SerializationContext : JsonSerializerContext
+    {
+    }
+{{/useNewtonsoft}}
+{{/isEnum}}
+{{/model}}
+{{/models}}
+}

package/targets/dotnet-webapi-system-text-json/templates/paramType.mustache

@@ -0,0 +1 @@
+{{#isQueryParam}}{{#isArray}}string[]{{/isArray}}{{^isArray}}{{{dataType}}}{{/isArray}}{{/isQueryParam}}{{^isQueryParam}}{{{dataType}}}{{/isQueryParam}}

package/targets/dotnet-webapi-system-text-json/templates/serviceCollectionExtensions.mustache

@@ -0,0 +1,90 @@
+// <auto-generated/>
+#nullable enable
+using System;
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+using Microsoft.Extensions.DependencyInjection;
+using {{packageName}}.Models;
+
+namespace {{packageName}}
+{
+    /// <summary>
+    /// System.Text.Json source-generation context covering every type this package
+    /// (de)serializes through its minimal-API endpoints: each generated model, each
+    /// operation request/response type, and each inline enum. Registering it (see
+    /// <see cref="{{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}ServiceCollectionExtensions" />)
+    /// lets the endpoints resolve JSON metadata via source generation, which is what
+    /// makes the package safe to trim and to publish with Native AOT — the pipeline
+    /// never falls back to reflection.
+    /// </summary>
+    /// <remarks>
+    /// Duplicate <c>[JsonSerializable]</c> entries are coalesced by the generator, so
+    /// request/response types that are also models are harmless. Inline enums are
+    /// registered with an explicit <c>TypeInfoPropertyName</c> because two models can
+    /// declare equally-named nested enums (e.g. <c>Order.StatusEnum</c> and
+    /// <c>Pet.StatusEnum</c>), which would otherwise collide under SYSLIB1031.
+    /// </remarks>
+    [JsonSerializable(typeof(string))]
+{{#models}}
+{{#model}}
+    [JsonSerializable(typeof({{classname}}))]
+{{#vars}}
+{{#isEnum}}
+{{^complexType}}
+    [JsonSerializable(typeof({{classname}}.{{datatypeWithEnum}}), TypeInfoPropertyName = "{{classname}}{{datatypeWithEnum}}")]
+{{/complexType}}
+{{/isEnum}}
+{{#items.isEnum}}
+{{#items}}
+{{^complexType}}
+    [JsonSerializable(typeof({{classname}}.{{datatypeWithEnum}}), TypeInfoPropertyName = "{{classname}}{{datatypeWithEnum}}")]
+{{/complexType}}
+{{/items}}
+{{/items.isEnum}}
+{{/vars}}
+{{/model}}
+{{/models}}
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+{{#operation}}
+{{^isResponseFile}}
+{{#returnType}}
+    [JsonSerializable(typeof({{{returnType}}}))]
+{{/returnType}}
+{{/isResponseFile}}
+{{#bodyParam}}
+{{^isBinary}}
+    [JsonSerializable(typeof({{#isArray}}List<{{{items.dataType}}}>{{/isArray}}{{^isArray}}{{{baseType}}}{{/isArray}}))]
+{{/isBinary}}
+{{/bodyParam}}
+{{/operation}}
+{{/operations}}
+{{/apis}}
+{{/apiInfo}}
+    public partial class {{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}JsonSerializerContext : JsonSerializerContext
+    {
+    }
+
+    /// <summary>
+    /// Registers the System.Text.Json source-generation context for this generated
+    /// package. Call <c>builder.Services.Add{{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}JsonOptions()</c>
+    /// in Program.cs so the minimal-API endpoints resolve JSON metadata via source
+    /// generation — required when the host is published with Native AOT, harmless
+    /// (a no-op the reflection resolver already covers) for a JIT host.
+    /// </summary>
+    public static class {{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}ServiceCollectionExtensions
+    {
+        /// <summary>
+        /// Inserts <see cref="{{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}JsonSerializerContext" />
+        /// at the front of the minimal-API JSON type-info resolver chain.
+        /// </summary>
+        public static IServiceCollection Add{{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}JsonOptions(this IServiceCollection services)
+        {
+            services.ConfigureHttpJsonOptions(options =>
+                options.SerializerOptions.TypeInfoResolverChain.Insert(
+                    0, {{#lambda.pascalcase}}{{packageName}}{{/lambda.pascalcase}}JsonSerializerContext.Default));
+            return services;
+        }
+    }
+}

package/targets/dotnet-webapi-system-text-json/templates/typeConverter.mustache

@@ -0,0 +1,11 @@
+// <auto-generated/>
+//
+// Intentionally empty for the System.Text.Json / Native-AOT target.
+//
+// The default aspnetcore template emits an MVC `CustomEnumConverter<T>`
+// (a TypeConverter whose body calls the reflection-based
+// JsonSerializer.Deserialize<T>, which raises IL2026/IL3050 under the AOT
+// analyzer). This target suppresses MVC controllers and (de)serializes enums
+// via [JsonConverter(typeof(JsonStringEnumConverter<T>))] + [JsonStringEnumMemberName]
+// on each generated enum, so the converter is unused — and is omitted here to
+// keep the package AOT-clean.