@wictorwilen/cocogen 1.0.0 → 1.0.11

package/dist/init/templates/dotnet/Generated/CsvParser.cs.ejs

@@ -1,72 +1,115 @@
+// CSV parsing helpers used by generated transforms.
 namespace <%= namespaceName %>.Datasource;
 
+/// <summary>
+/// Helpers for parsing typed values from CSV rows.
+/// </summary>
 public static class CsvParser
 {
+    /// <summary>
+    /// Read the first matching header value from the row.
+    /// </summary>
     public static string ReadValue(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         if (headers.Length == 0) return "";
         return row.TryGetValue(headers[0], out var v) ? (v ?? "") : "";
     }
 
+    /// <summary>
+    /// Parse a nullable string value into a string.
+    /// </summary>
     public static string ParseString(string? value)
     {
         return value ?? "";
     }
 
+    /// <summary>
+    /// Parse a string from a CSV row using the provided headers.
+    /// </summary>
     public static string ParseString(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseString(ReadValue(row, headers));
     }
 
+    /// <summary>
+    /// Parse a boolean from a CSV row using the provided headers.
+    /// </summary>
     public static bool ParseBoolean(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseBoolean(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a boolean from a string value.
+    /// </summary>
     public static bool ParseBoolean(string? value)
     {
         var v = ParseString(value);
         return v.Equals("true", StringComparison.OrdinalIgnoreCase) || v.Equals("1");
     }
 
+    /// <summary>
+    /// Parse an Int64 from a CSV row using the provided headers.
+    /// </summary>
     public static long ParseInt64(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseInt64(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse an Int64 from a string value.
+    /// </summary>
     public static long ParseInt64(string? value)
     {
         var v = ParseString(value);
         return long.TryParse(v, out var n) ? n : 0;
     }
 
+    /// <summary>
+    /// Parse a double from a CSV row using the provided headers.
+    /// </summary>
     public static double ParseDouble(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseDouble(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a double from a string value.
+    /// </summary>
     public static double ParseDouble(string? value)
     {
         var v = ParseString(value);
         return double.TryParse(v, out var n) ? n : 0;
     }
 
+    /// <summary>
+    /// Parse a DateTimeOffset from a CSV row using the provided headers.
+    /// </summary>
     public static DateTimeOffset ParseDateTime(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseDateTime(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a DateTimeOffset from a string value.
+    /// </summary>
     public static DateTimeOffset ParseDateTime(string? value)
     {
         var v = ParseString(value);
         return DateTimeOffset.TryParse(v, out var dt) ? dt : DateTimeOffset.MinValue;
     }
 
+    /// <summary>
+    /// Parse a string collection from a CSV row using the provided headers.
+    /// </summary>
     public static List<string> ParseStringCollection(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseStringCollection(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a string collection from a string value.
+    /// </summary>
     public static List<string> ParseStringCollection(string? value)
     {
         var v = ParseString(value);
@@ -75,11 +118,17 @@ public static class CsvParser
             : v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries).ToList();
     }
 
+    /// <summary>
+    /// Parse an Int64 collection from a CSV row using the provided headers.
+    /// </summary>
     public static List<long> ParseInt64Collection(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseInt64Collection(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse an Int64 collection from a string value.
+    /// </summary>
     public static List<long> ParseInt64Collection(string? value)
     {
         var v = ParseString(value);
@@ -89,11 +138,17 @@ public static class CsvParser
             .ToList();
     }
 
+    /// <summary>
+    /// Parse a double collection from a CSV row using the provided headers.
+    /// </summary>
     public static List<double> ParseDoubleCollection(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseDoubleCollection(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a double collection from a string value.
+    /// </summary>
     public static List<double> ParseDoubleCollection(string? value)
     {
         var v = ParseString(value);
@@ -103,11 +158,17 @@ public static class CsvParser
             .ToList();
     }
 
+    /// <summary>
+    /// Parse a DateTimeOffset collection from a CSV row using the provided headers.
+    /// </summary>
     public static List<DateTimeOffset> ParseDateTimeCollection(IReadOnlyDictionary<string, string?> row, string[] headers)
     {
         return ParseDateTimeCollection(ParseString(row, headers));
     }
 
+    /// <summary>
+    /// Parse a DateTimeOffset collection from a string value.
+    /// </summary>
     public static List<DateTimeOffset> ParseDateTimeCollection(string? value)
     {
         var v = ParseString(value);

package/dist/init/templates/dotnet/Generated/FromCsvRow.cs.ejs

@@ -1,13 +1,21 @@
+// Map CSV rows into the schema model.
 using <%= namespaceName %>;
 using <%= namespaceName %>.Datasource;
 
-namespace <%= namespaceName %>.Schema;
+namespace <%= schemaNamespace %>;
 
+/// <summary>
+/// Maps CSV rows into the schema model using generated transforms.
+/// </summary>
 public static class FromCsvRow
 {
-    public static Item Parse(IReadOnlyDictionary<string, string?> row)
+    /// <summary>
+    /// Convert a CSV row dictionary into a schema model instance.
+    /// </summary>
+    public static <%= itemTypeName %> Parse(IReadOnlyDictionary<string, string?> row)
     {
-        return new Item(
+        var transforms = new PropertyTransform();
+        return new <%= itemTypeName %>(
 <%- constructorArgLines %>
         );
     }

package/dist/init/templates/dotnet/Generated/ItemPayload.cs.ejs

@@ -1,16 +1,26 @@
 <% const graphNs = graphApiVersion === "beta" ? "Microsoft.Graph.Beta" : "Microsoft.Graph"; -%>
+// Build ExternalItem payloads for Graph ingestion.
 using <%= graphNs %>.Models.ExternalConnectors;
 
-namespace <%= namespaceName %>.Schema;
+namespace <%= schemaNamespace %>;
 
+/// <summary>
+/// Maps schema model instances into Graph ExternalItem payloads.
+/// </summary>
 public static class ItemPayload
 {
-    public static string GetItemId(Item item)
+    /// <summary>
+    /// Resolve the external item ID for a schema model instance.
+    /// </summary>
+    public static string GetItemId(<%= itemTypeName %> item)
     {
         return <%- itemIdExpression %>;
     }
 
-    public static ExternalItem ToExternalItem(Item item)
+    /// <summary>
+    /// Convert a schema model instance into a Graph ExternalItem payload.
+    /// </summary>
+    public static ExternalItem ToExternalItem(<%= itemTypeName %> item)
     {
         var props = new Properties
         {

package/dist/init/templates/dotnet/Generated/Model.cs.ejs

@@ -1,28 +1,11 @@
-namespace <%= namespaceName %>.Schema;
+// C# representation of the external item schema.
+namespace <%= schemaNamespace %>;
 
-<% if (itemTypeName === "Item") { -%>
-public sealed record Item(
-<% for (let i = 0; i < properties.length; i++) { -%>
-    <%= properties[i].csType %> <%= properties[i].csName %><%= i < properties.length - 1 ? "," : "" %>
-<% } -%>
-);
-<% } else { -%>
+/// <summary>
+/// Schema model generated from TypeSpec.
+/// </summary>
 public sealed record <%= itemTypeName %>(
 <% for (let i = 0; i < properties.length; i++) { -%>
     <%= properties[i].csType %> <%= properties[i].csName %><%= i < properties.length - 1 ? "," : "" %>
 <% } -%>
 );
-
-public sealed record Item(
-<% for (let i = 0; i < properties.length; i++) { -%>
-    <%= properties[i].csType %> <%= properties[i].csName %><%= i < properties.length - 1 ? "," : "" %>
-<% } -%>
-)
-{
-    public static implicit operator Item(<%= itemTypeName %> item) => new(
-<% for (let i = 0; i < properties.length; i++) { -%>
-        item.<%= properties[i].csName %><%= i < properties.length - 1 ? "," : "" %>
-<% } -%>
-    );
-}
-<% } -%>

package/dist/init/templates/dotnet/Generated/PropertyTransformBase.cs.ejs

@@ -0,0 +1,45 @@
+// Generated property transforms derived from TypeSpec.
+using System;
+using System.Collections.Generic;
+<% if (usesPersonEntity) { -%>
+using System.Linq;
+using System.Text.Json;
+<% } -%>
+using <%= namespaceName %>.Datasource;
+
+namespace <%= schemaNamespace %>;
+
+/// <summary>
+/// Base class for CSV-to-model property transforms.
+/// </summary>
+public abstract class PropertyTransformBase
+{
+    /// <summary>
+    /// Transform a property by name using the generated transform methods.
+    /// </summary>
+    public object TransformProperty(string name, IReadOnlyDictionary<string, string?> row)
+    {
+        return name switch
+        {
+<% for (const prop of properties) { -%>
+            <%= JSON.stringify(prop.name) %> => Transform<%= prop.csName %>(row),
+<% } -%>
+            _ => throw new ArgumentOutOfRangeException(nameof(name), $"Unknown property '{name}'."),
+        };
+    }
+
+<% for (const prop of properties) { -%>
+    /// <summary>
+    /// Transform the <%= prop.name %> property from a CSV row.
+    /// </summary>
+    protected virtual <%= prop.csType %> Transform<%= prop.csName %>(IReadOnlyDictionary<string, string?> row)
+    {
+    <% if (prop.transformThrows) { -%>
+        <%- prop.transformExpression %>;
+    <% } else { -%>
+        return <%- prop.transformExpression %>;
+    <% } -%>
+    }
+
+<% } -%>
+}

package/dist/init/templates/dotnet/Generated/SchemaPayload.cs.ejs

@@ -1,14 +1,22 @@
 <% const graphNs = graphApiVersion === "beta" ? "Microsoft.Graph.Beta" : "Microsoft.Graph"; -%>
+// Graph schema payload derived from the TypeSpec model.
 using <%= graphNs %>.Models.ExternalConnectors;
 
-namespace <%= namespaceName %>.Schema;
+namespace <%= schemaNamespace %>;
 
+/// <summary>
+/// Builds the Graph schema payload for this connector.
+/// </summary>
 public static class SchemaPayload
 {
+    /// <summary>
+    /// Build the schema payload for the external connection.
+    /// </summary>
     public static global::<%= graphNs %>.Models.ExternalConnectors.Schema BuildSchema()
     {
         return new global::<%= graphNs %>.Models.ExternalConnectors.Schema
         {
+            BaseType = "microsoft.graph.externalItem",
             Properties = new List<Property>
             {
 <%- schemaPropertyLines %>