@wictorwilen/cocogen 1.0.16 → 1.0.18

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

@@ -1,180 +1 @@
-// 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);
-        return v.Length == 0
-            ? new List<string>()
-            : 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);
-        if (v.Length == 0) return new List<long>();
-        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
-            .Select((x) => long.TryParse(x, out var n) ? n : 0)
-            .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);
-        if (v.Length == 0) return new List<double>();
-        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
-            .Select((x) => double.TryParse(x, out var n) ? n : 0)
-            .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);
-        if (v.Length == 0) return new List<DateTimeOffset>();
-        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
-            .Select((x) => DateTimeOffset.TryParse(x, out var dt) ? dt : DateTimeOffset.MinValue)
-            .ToList();
-    }
-}

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

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

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

@@ -0,0 +1,23 @@
+// Map source rows into the schema model.
+using System.Collections.Generic;
+using <%= namespaceName %>;
+using <%= namespaceName %>.Datasource;
+
+namespace <%= schemaNamespace %>;
+
+/// <summary>
+/// Maps source rows into the schema model using generated transforms.
+/// </summary>
+public static class FromRow
+{
+    /// <summary>
+    /// Convert a row dictionary into a schema model instance.
+    /// </summary>
+    public static <%= itemTypeName %> Parse(IReadOnlyDictionary<string, string?> row)
+    {
+        var transforms = new PropertyTransform();
+        return new <%= itemTypeName %>(
+<%- constructorArgLines %>
+        );
+    }
+}

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

@@ -1,12 +1,16 @@
 // C# representation of the external item schema.
 namespace <%= schemaNamespace %>;
 
+<% if (recordDocLines && recordDocLines.length) { -%>
+<%- recordDocLines.join("\n") %>
+<% } 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 %>,
 <% } -%>
-    string CocoId = ""
+    string InternalId = ""
 );

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

@@ -5,12 +5,13 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Text.Json;
 <% } -%>
+using <%= namespaceName %>.Core;
 using <%= namespaceName %>.Datasource;
 
 namespace <%= schemaNamespace %>;
 
 /// <summary>
-/// Base class for CSV-to-model property transforms.
+/// Base class for row-to-model property transforms.
 /// </summary>
 public abstract class PropertyTransformBase
 {
@@ -30,16 +31,29 @@ public abstract class PropertyTransformBase
 
 <% for (const prop of properties) { -%>
     /// <summary>
-    /// Transform the <%= prop.name %> property from a CSV row.
+    /// Transform the <%= prop.name %> property from a source row.
     /// </summary>
     protected virtual <%= prop.csType %> Transform<%= prop.csName %>(IReadOnlyDictionary<string, string?> row)
     {
-    <% if (prop.transformThrows) { -%>
+<%_ if (prop.transformThrows) { -%>
         <%- prop.transformExpression %>;
-    <% } else { -%>
+<%_ } else { -%>
         return <%- prop.transformExpression %>;
-    <% } -%>
+<%_ } -%>
     }
 
 <% } -%>
+
+    private static List<DateTimeOffset> ValidateDateTimeCollection(string name, string raw, int? minLength, int? maxLength, string? pattern, string? format)
+    {
+        var parts = RowParser.ParseStringCollection(raw);
+        if (parts.Count == 0) return new List<DateTimeOffset>();
+        var results = new List<DateTimeOffset>(parts.Count);
+        for (var index = 0; index < parts.Count; index++)
+        {
+            var validated = Validation.ValidateString(name, parts[index], minLength, maxLength, pattern, format);
+            results.Add(RowParser.ParseDateTime(validated));
+        }
+        return results;
+    }
 }

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

@@ -0,0 +1,184 @@
+// Row value parsing helpers used by generated transforms.
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace <%= namespaceName %>.Datasource;
+
+/// <summary>
+/// Helpers for parsing typed values from row dictionaries.
+/// </summary>
+public static class RowParser
+{
+    /// <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 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 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 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 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 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 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);
+        return v.Length == 0
+            ? new List<string>()
+            : v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries).ToList();
+    }
+
+    /// <summary>
+    /// Parse an Int64 collection from a 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);
+        if (v.Length == 0) return new List<long>();
+        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
+            .Select((x) => long.TryParse(x, out var n) ? n : 0)
+            .ToList();
+    }
+
+    /// <summary>
+    /// Parse a double collection from a 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);
+        if (v.Length == 0) return new List<double>();
+        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
+            .Select((x) => double.TryParse(x, out var n) ? n : 0)
+            .ToList();
+    }
+
+    /// <summary>
+    /// Parse a DateTimeOffset collection from a 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);
+        if (v.Length == 0) return new List<DateTimeOffset>();
+        return v.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
+            .Select((x) => DateTimeOffset.TryParse(x, out var dt) ? dt : DateTimeOffset.MinValue)
+            .ToList();
+    }
+}

package/dist/init/templates/dotnet/Program.commandline.cs.ejs

@@ -1,6 +1,8 @@
 // Connector CLI for provisioning, ingestion, and deletion.
+using Azure.Core;
 using Azure.Identity;
 using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Configuration.UserSecrets;
 <% if (graphApiVersion === "beta") { -%>
 using Microsoft.Graph.Beta;
 <% } else { -%>
@@ -17,6 +19,7 @@ var configuration = new ConfigurationBuilder()
     .SetBasePath(Directory.GetCurrentDirectory())
     .AddJsonFile("appsettings.json", optional: true)
     .AddJsonFile("appsettings.Development.json", optional: true)
+    .AddUserSecrets<Program>(optional: true)
     .AddEnvironmentVariables()
     .Build();
 
@@ -64,14 +67,10 @@ string RequiredSetting(string key, string? fallback = null)
 
 string ConnectionId() => RequiredSetting("Connection:Id", SchemaConstants.ConnectionId);
 string ConnectionName() => RequiredSetting("Connection:Name", SchemaConstants.ConnectionName);
-string ConnectionDescription() => configuration["Connection:Description"]
-    ?? SchemaConstants.ConnectionDescription
-    ?? string.Empty;
+string ConnectionDescription() => RequiredSetting("Connection:Description", SchemaConstants.ConnectionDescription);
 <% if (isPeopleConnector) { -%>
 string ProfileSourceWebUrl() => RequiredSetting("ProfileSource:WebUrl", SchemaConstants.ProfileSourceWebUrl);
-string ProfileSourceDisplayName() => configuration["ProfileSource:DisplayName"]
-    ?? SchemaConstants.ProfileSourceDisplayName
-    ?? ConnectionName();
+string ProfileSourceDisplayName() => RequiredSetting("ProfileSource:DisplayName", SchemaConstants.ProfileSourceDisplayName);
 string ProfileSourcePriority()
 {
     var raw = configuration["ProfileSource:Priority"];
@@ -89,12 +88,35 @@ string ProfileSourcePriority()
 /// <summary>
 /// Create an app-only credential for Microsoft Graph.
 /// </summary>
-ClientSecretCredential CreateCredential()
+TokenCredential CreateCredential()
 {
-    var tenantId = RequiredSetting("AzureAd:TenantId");
-    var clientId = RequiredSetting("AzureAd:ClientId");
-    var clientSecret = RequiredSetting("AzureAd:ClientSecret");
-    return new ClientSecretCredential(tenantId, clientId, clientSecret);
+    var managedIdentityClientId = configuration["AzureAd:ManagedIdentityClientId"];
+    TokenCredential managedIdentity = string.IsNullOrWhiteSpace(managedIdentityClientId)
+        ? new ManagedIdentityCredential()
+        : new ManagedIdentityCredential(managedIdentityClientId);
+
+    var tenantId = configuration["AzureAd:TenantId"];
+    var clientId = configuration["AzureAd:ClientId"];
+    var clientSecret = configuration["AzureAd:ClientSecret"];
+
+    if (string.IsNullOrWhiteSpace(tenantId)
+        && string.IsNullOrWhiteSpace(clientId)
+        && string.IsNullOrWhiteSpace(clientSecret))
+    {
+        return managedIdentity;
+    }
+
+    if (string.IsNullOrWhiteSpace(tenantId)
+        || string.IsNullOrWhiteSpace(clientId)
+        || string.IsNullOrWhiteSpace(clientSecret))
+    {
+        throw new InvalidOperationException(
+            "AzureAd settings are incomplete. Set TenantId, ClientId, and ClientSecret, or clear them to use managed identity."
+        );
+    }
+
+    var clientSecretCredential = new ClientSecretCredential(tenantId, clientId, clientSecret);
+    return new ChainedTokenCredential(managedIdentity, clientSecretCredential);
 }
 
 /// <summary>
@@ -108,7 +130,7 @@ GraphServiceClient CreateGraphClient()
     return graph;
 }
 
-ConnectorCore BuildConnectorCore(GraphServiceClient? graph, ClientSecretCredential? credential, string connectionId)
+ConnectorCore BuildConnectorCore(GraphServiceClient? graph, TokenCredential? credential, string connectionId)
 {
     return new ConnectorCore(
         graph,
@@ -145,10 +167,10 @@ async Task ProvisionAsync()
 /// <summary>
 /// Ingest items from CSV.
 /// </summary>
-async Task IngestAsync(string? csvPath, bool dryRun, int? limit, bool verbose)
+async Task IngestAsync(string? csvPath, bool dryRun, int? limit, bool verbose, bool failFast)
 {
     GraphServiceClient? graph = null;
-    ClientSecretCredential? credential = null;
+    TokenCredential? credential = null;
     string connectionId = "dry-run";
     if (!dryRun)
     {
@@ -164,7 +186,7 @@ async Task IngestAsync(string? csvPath, bool dryRun, int? limit, bool verbose)
     IItemSource source = new CsvItemSource(path);
     var core = BuildConnectorCore(graph, credential, connectionId);
 
-    await core.IngestAsync(source, dryRun, limit, verbose);
+    await core.IngestAsync(source, dryRun, limit, verbose, failFast);
 }
 
 /// <summary>
@@ -183,6 +205,7 @@ async Task DeleteConnectionAsync()
 
 var csvOption = new Option<string>("--csv", description: "CSV path");
 var dryRunOption = new Option<bool>("--dry-run", description: "Build payloads but do not send to Graph");
+var failFastOption = new Option<bool>("--fail-fast", description: "Abort on the first item failure");
 var limitOption = new Option<int?>("--limit", description: "Limit number of items");
 var verboseOption = new Option<bool>("--verbose", description: "Print payloads sent to Graph");
 
@@ -194,12 +217,14 @@ provisionCommand.SetHandler(async () => await ProvisionAsync());
 var ingestCommand = new Command("ingest", "Ingest items from CSV");
 ingestCommand.AddOption(csvOption);
 ingestCommand.AddOption(dryRunOption);
+ingestCommand.AddOption(failFastOption);
 ingestCommand.AddOption(limitOption);
 ingestCommand.AddOption(verboseOption);
 ingestCommand.SetHandler(
-    async (string? csv, bool dryRun, int? limit, bool verbose) => await IngestAsync(csv, dryRun, limit, verbose),
+    async (string? csv, bool dryRun, bool failFast, int? limit, bool verbose) => await IngestAsync(csv, dryRun, limit, verbose, failFast),
     csvOption,
     dryRunOption,
+    failFastOption,
     limitOption,
     verboseOption
 );

package/dist/init/templates/dotnet/PropertyTransform.cs.ejs

@@ -1,4 +1,4 @@
-// Customize CSV-to-model property transforms.
+// Customize row-to-model property transforms.
 namespace <%= schemaNamespace %>;
 
 /// <summary>

package/dist/init/templates/dotnet/README.md.ejs

@@ -26,6 +26,18 @@ This generated CLI currently targets a single connection ID from configuration.
   - `PeopleSettings.ReadWrite.All` (required for profile source registration)
 <% } -%>
 
+## Authentication
+The generated CLI prefers managed identity. If you run on Azure with a managed identity, leave `AzureAd:TenantId`, `AzureAd:ClientId`, and `AzureAd:ClientSecret` empty and (optionally) set `AzureAd:ManagedIdentityClientId` for user-assigned identities.
+
+To use client secret auth locally, set `AzureAd:TenantId`, `AzureAd:ClientId`, and `AzureAd:ClientSecret` in `appsettings.json`, environment variables, or user-secrets.
+
+User-secrets are supported:
+```bash
+dotnet user-secrets set "AzureAd:TenantId" "<tenant-id>"
+dotnet user-secrets set "AzureAd:ClientId" "<client-id>"
+dotnet user-secrets set "AzureAd:ClientSecret" "<client-secret>"
+```
+
 ## TypeSpec editor support
 This project includes `tspconfig.yaml` and a `package.json` with `@wictorwilen/cocogen` as a dev dependency so VS Code can resolve `using coco;`.
 Run `npm install` in this folder to fetch the TypeSpec library.
@@ -41,6 +53,7 @@ Run `npm install` in this folder to fetch the TypeSpec library.
 ## Ingest debugging flags
 Use `dotnet run -- ingest` with:
 - `--dry-run` (build payloads without sending)
+- `--fail-fast` (abort on the first item failure)
 - `--limit <n>` (ingest only N items)
 - `--verbose` (print the exact payload sent to Graph)
 
@@ -48,7 +61,7 @@ Note: `--dry-run` does not require Azure AD or connection settings.
 
 ## Switching from CSV to another datasource
 1) Implement `IItemSource` in `Datasource/`.
-2) If your source yields raw records, map them to `<%= itemTypeName %>` using `FromCsvRow`-style logic.
+2) If your source yields raw records, map them to `<%= itemTypeName %>` using `FromRow`-style logic.
 3) Update `Program.cs` to instantiate your new source instead of `CsvItemSource`.
 
 Tip: keep the `IAsyncEnumerable<<%= itemTypeName %>>` pattern for large datasets.

package/dist/init/templates/dotnet/appsettings.json.ejs

@@ -2,7 +2,8 @@
   "AzureAd": {
     "TenantId": "",
     "ClientId": "",
-    "ClientSecret": ""
+    "ClientSecret": "",
+    "ManagedIdentityClientId": ""
   },
   "Connection": {
     "Id": "",

package/dist/init/templates/dotnet/project.csproj.ejs

@@ -6,6 +6,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <LangVersion>latest</LangVersion>
+    <UserSecretsId><%= userSecretsId %></UserSecretsId>
   </PropertyGroup>
 
   <ItemGroup>
@@ -20,6 +21,7 @@
     <PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.2" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="10.0.2" />
     <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="10.0.2" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.2" />
   </ItemGroup>
 
   <ItemGroup>