@wictorwilen/cocogen 1.0.0 → 1.0.11

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

@@ -1,487 +0,0 @@
-using Azure.Identity;
-using Azure.Core;
-using Microsoft.Graph;
-using Microsoft.Graph.Models.ExternalConnectors;
-using Microsoft.Graph.Models.ODataErrors;
-using Microsoft.Kiota.Abstractions;
-using Microsoft.Kiota.Abstractions.Serialization;
-using System.Net.Http.Headers;
-using System.Text;
-using System.Text.Json;
-
-using <%= namespaceName %>.Datasource;
-using <%= namespaceName %>.Generated;
-
-var command = args.Length > 0 ? args[0] : "";
-
-static string RequiredEnv(string name)
-{
-    var value = Environment.GetEnvironmentVariable(name);
-    if (string.IsNullOrWhiteSpace(value))
-        throw new InvalidOperationException($"Missing env var: {name}");
-    return value;
-}
-
-static GraphServiceClient CreateGraphClient()
-{
-    var credential = CreateCredential();
-
-    var graph = new GraphServiceClient(credential, new[] { "https://graph.microsoft.com/.default" });
-    graph.RequestAdapter.BaseUrl = SchemaConstants.GraphBaseUrl;
-    return graph;
-}
-
-static ClientSecretCredential CreateCredential()
-{
-    var tenantId = RequiredEnv("TENANT_ID");
-    var clientId = RequiredEnv("CLIENT_ID");
-    var clientSecret = RequiredEnv("CLIENT_SECRET");
-    return new ClientSecretCredential(tenantId, clientId, clientSecret);
-}
-
-static async Task<string> GetAccessTokenAsync(ClientSecretCredential credential)
-{
-    var token = await credential.GetTokenAsync(
-        new TokenRequestContext(new[] { "https://graph.microsoft.com/.default" })
-    );
-    return token.Token;
-}
-
-static async Task<HttpResponseMessage> GraphRequestAsync(ClientSecretCredential credential, HttpMethod method, string url, object? body = null)
-{
-    using var http = new HttpClient();
-    var token = await GetAccessTokenAsync(credential);
-    http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
-
-    var request = new HttpRequestMessage(method, url);
-    if (body is not null)
-    {
-        var json = JsonSerializer.Serialize(body);
-        request.Content = new StringContent(json, Encoding.UTF8, "application/json");
-    }
-
-    return await http.SendAsync(request);
-}
-
-static bool IsStatus(ApiException ex, int statusCode)
-{
-    return ex.ResponseStatusCode is int sc && sc == statusCode;
-}
-
-static async Task EnsureConnectionAsync(GraphServiceClient graph, string connectionId)
-{
-    var name = RequiredEnv("CONNECTION_NAME");
-    var description = RequiredEnv("CONNECTION_DESCRIPTION");
-
-    try
-    {
-        await graph.External.Connections[connectionId].GetAsync();
-        return;
-    }
-    using Azure.Core;
-    using Azure.Identity;
-    using Microsoft.Extensions.Configuration;
-    using Microsoft.Graph;
-    using Microsoft.Graph.Models.ExternalConnectors;
-    using Microsoft.Graph.Models.ODataErrors;
-    using Microsoft.Kiota.Abstractions;
-    using Microsoft.Kiota.Abstractions.Serialization;
-    using System.CommandLine;
-    using System.Net.Http.Headers;
-    using System.Text;
-    using System.Text.Json;
-
-    using <%= namespaceName %>.Datasource;
-    using <%= namespaceName %>.Schema;
-
-    var configuration = new ConfigurationBuilder()
-        .SetBasePath(Directory.GetCurrentDirectory())
-        .AddJsonFile("appsettings.json", optional: true)
-        .AddJsonFile("appsettings.Development.json", optional: true)
-        .AddEnvironmentVariables()
-        .Build();
-
-    string RequiredSetting(string key)
-    {
-        var value = configuration[key];
-        if (string.IsNullOrWhiteSpace(value))
-            throw new InvalidOperationException($"Missing configuration: {key}");
-        return value;
-    }
-
-    string ConnectionId() => RequiredSetting("Connection:Id");
-    string ConnectionName() => RequiredSetting("Connection:Name");
-    string ConnectionDescription() => RequiredSetting("Connection:Description");
-
-    ClientSecretCredential CreateCredential()
-    {
-        var tenantId = RequiredSetting("AzureAd:TenantId");
-        var clientId = RequiredSetting("AzureAd:ClientId");
-        var clientSecret = RequiredSetting("AzureAd:ClientSecret");
-        return new ClientSecretCredential(tenantId, clientId, clientSecret);
-    }
-
-    GraphServiceClient CreateGraphClient()
-    {
-        var credential = CreateCredential();
-        var graph = new GraphServiceClient(credential, new[] { "https://graph.microsoft.com/.default" });
-        graph.RequestAdapter.BaseUrl = SchemaConstants.GraphBaseUrl;
-        return graph;
-    }
-
-    async Task<string> GetAccessTokenAsync(ClientSecretCredential credential)
-    {
-        var token = await credential.GetTokenAsync(
-            new TokenRequestContext(new[] { "https://graph.microsoft.com/.default" })
-        );
-        return token.Token;
-    }
-
-    async Task<HttpResponseMessage> GraphRequestAsync(ClientSecretCredential credential, HttpMethod method, string url, object? body = null)
-    {
-        using var http = new HttpClient();
-        var token = await GetAccessTokenAsync(credential);
-        http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
-
-        var request = new HttpRequestMessage(method, url);
-        if (body is not null)
-        {
-            var json = JsonSerializer.Serialize(body);
-            request.Content = new StringContent(json, Encoding.UTF8, "application/json");
-        }
-
-        return await http.SendAsync(request);
-    }
-
-    bool IsStatus(ApiException ex, int statusCode)
-    {
-        return ex.ResponseStatusCode is int sc && sc == statusCode;
-    }
-
-    async Task EnsureConnectionAsync(GraphServiceClient graph, string connectionId)
-    {
-        try
-        {
-            await graph.External.Connections[connectionId].GetAsync();
-            return;
-        }
-        catch (ApiException ex) when (IsStatus(ex, 404))
-        {
-            // Create below.
-        }
-
-        var connection = new ExternalConnection
-        {
-            Id = connectionId,
-            Name = ConnectionName(),
-            Description = ConnectionDescription(),
-        };
-
-        if (!string.IsNullOrWhiteSpace(SchemaConstants.ContentCategory))
-        {
-            // contentCategory is currently only exposed on the /beta endpoint.
-            connection.AdditionalData ??= new Dictionary<string, object>();
-            connection.AdditionalData["contentCategory"] = SchemaConstants.ContentCategory!;
-        }
-
-        await graph.External.Connections.PostAsync(connection);
-    }
-
-    async Task PatchSchemaAsync(GraphServiceClient graph, string connectionId)
-    {
-        var schema = SchemaPayload.BuildSchema();
-        await graph.External.Connections[connectionId].Schema.PatchAsync(schema);
-    }
-
-    async Task ProvisionAsync()
-    {
-        var graph = CreateGraphClient();
-        var connectionId = ConnectionId();
-
-        await EnsureConnectionAsync(graph, connectionId);
-        await PatchSchemaAsync(graph, connectionId);
-    <% if (isPeopleConnector) { -%>
-        await RegisterProfileSourceAsync(connectionId);
-    <% } -%>
-
-        Console.WriteLine("ok: provisioned");
-    }
-
-    async Task PutItemAsync(GraphServiceClient graph, string connectionId, Item item)
-    {
-        var itemId = ItemPayload.GetItemId(item);
-
-        var externalItem = ItemPayload.ToExternalItem(item);
-
-        // NOTE: The external connectors surface may not expose a typed PutAsync on all SDK versions.
-        // We still use the Graph SDK's request adapter and models for a strongly-typed payload.
-        var requestInfo = new RequestInformation
-        {
-            HttpMethod = Method.PUT,
-            UrlTemplate = "{+baseurl}/external/connections/{connectionId}/items/{itemId}",
-            PathParameters = new Dictionary<string, object>
-            {
-                { "baseurl", graph.RequestAdapter.BaseUrl },
-                { "connectionId", connectionId },
-                { "itemId", itemId },
-            },
-        };
-
-        requestInfo.Headers.Add("Accept", "application/json");
-        requestInfo.SetContentFromParsable(graph.RequestAdapter, "application/json", externalItem);
-
-        var errorMapping = new Dictionary<string, ParsableFactory<IParsable>>
-        {
-            { "4XX", ODataError.CreateFromDiscriminatorValue },
-            { "5XX", ODataError.CreateFromDiscriminatorValue },
-        };
-
-        await graph.RequestAdapter.SendAsync<ExternalItem>(
-            requestInfo,
-            ExternalItem.CreateFromDiscriminatorValue,
-            errorMapping
-        );
-    }
-
-    async Task IngestAsync(string? csvPath)
-    {
-        var graph = CreateGraphClient();
-        var connectionId = ConnectionId();
-
-        var configuredCsv = configuration["Csv:Path"] ?? "data.csv";
-        var path = string.IsNullOrWhiteSpace(csvPath) ? configuredCsv : csvPath;
-
-        IItemSource source = new CsvItemSource(path);
-
-        var count = 0;
-        await foreach (var item in source.GetItemsAsync())
-        {
-            await PutItemAsync(graph, connectionId, item);
-            count++;
-        }
-
-        Console.WriteLine($"ok: ingested {count} item(s)");
-    }
-
-    <% if (isPeopleConnector) { -%>
-    async Task RegisterProfileSourceAsync(string connectionId)
-    {
-        var credential = CreateCredential();
-        var webUrl = RequiredSetting("ProfileSource:WebUrl");
-        var displayName = configuration["ProfileSource:DisplayName"] ?? ConnectionName();
-        var kind = configuration["ProfileSource:Kind"];
-
-        var payload = new Dictionary<string, object?>
-        {
-            ["sourceId"] = connectionId,
-            ["displayName"] = displayName,
-            ["webUrl"] = webUrl,
-        };
-
-        if (!string.IsNullOrWhiteSpace(kind))
-            payload["kind"] = kind;
-
-        var create = await GraphRequestAsync(
-            credential,
-            HttpMethod.Post,
-            $"{SchemaConstants.GraphBaseUrl}/admin/people/profileSources",
-            payload
-        );
-
-        if (!create.IsSuccessStatusCode && create.StatusCode != System.Net.HttpStatusCode.Conflict)
-        {
-            var text = await create.Content.ReadAsStringAsync();
-            throw new InvalidOperationException($"Failed to register profile source (HTTP {(int)create.StatusCode}): {text}");
-        }
-
-        var sourceUrl = $"{SchemaConstants.GraphBaseUrl}/admin/people/profileSources(sourceId='{connectionId}')";
-        await UpdateProfileSourcePrecedenceAsync(credential, sourceUrl, prepend: true);
-    }
-
-    async Task UnregisterProfileSourceAsync(string connectionId)
-    {
-        var credential = CreateCredential();
-        var sourceUrl = $"{SchemaConstants.GraphBaseUrl}/admin/people/profileSources(sourceId='{connectionId}')";
-
-        await UpdateProfileSourcePrecedenceAsync(credential, sourceUrl, prepend: false);
-
-        var res = await GraphRequestAsync(
-            credential,
-            HttpMethod.Delete,
-            $"{SchemaConstants.GraphBaseUrl}/admin/people/profileSources(sourceId='{connectionId}')"
-        );
-
-        if (!res.IsSuccessStatusCode && res.StatusCode != System.Net.HttpStatusCode.NotFound)
-        {
-            var text = await res.Content.ReadAsStringAsync();
-            throw new InvalidOperationException($"Failed to delete profile source (HTTP {(int)res.StatusCode}): {text}");
-        }
-    }
-
-    async Task UpdateProfileSourcePrecedenceAsync(ClientSecretCredential credential, string sourceUrl, bool prepend)
-    {
-        var res = await GraphRequestAsync(
-            credential,
-            HttpMethod.Get,
-            $"{SchemaConstants.GraphBaseUrl}/admin/people/profilePropertySettings"
-        );
-
-        if (!res.IsSuccessStatusCode)
-        {
-            var text = await res.Content.ReadAsStringAsync();
-            throw new InvalidOperationException($"Failed to list profile property settings (HTTP {(int)res.StatusCode}): {text}");
-        }
-
-        var json = await res.Content.ReadAsStringAsync();
-        using var doc = JsonDocument.Parse(json);
-        if (!doc.RootElement.TryGetProperty("value", out var values) || values.ValueKind != JsonValueKind.Array)
-            return;
-
-        foreach (var entry in values.EnumerateArray())
-        {
-            if (!entry.TryGetProperty("id", out var idProp) || idProp.ValueKind != JsonValueKind.String)
-                continue;
-
-            var id = idProp.GetString() ?? string.Empty;
-            if (string.IsNullOrWhiteSpace(id)) continue;
-
-            List<string> existing = new();
-            if (entry.TryGetProperty("prioritizedSourceUrls", out var urls) && urls.ValueKind == JsonValueKind.Array)
-            {
-                foreach (var url in urls.EnumerateArray())
-                {
-                    if (url.ValueKind == JsonValueKind.String)
-                        existing.Add(url.GetString() ?? "");
-                }
-            }
-
-            existing = existing.Where((u) => !string.IsNullOrWhiteSpace(u) && u != sourceUrl).ToList();
-            var updated = prepend ? new[] { sourceUrl }.Concat(existing).ToList() : existing;
-
-            var patch = new Dictionary<string, object?>
-            {
-                ["@odata.type"] = "#microsoft.graph.profilePropertySetting",
-                ["prioritizedSourceUrls"] = updated,
-            };
-
-            var patchRes = await GraphRequestAsync(
-                credential,
-                HttpMethod.Patch,
-                $"{SchemaConstants.GraphBaseUrl}/admin/people/profilePropertySettings/{id}",
-                patch
-            );
-
-            if (!patchRes.IsSuccessStatusCode)
-            {
-                var text = await patchRes.Content.ReadAsStringAsync();
-                throw new InvalidOperationException($"Failed to update profile property setting {id} (HTTP {(int)patchRes.StatusCode}): {text}");
-            }
-        }
-    }
-    <% } -%>
-
-    async Task DeleteConnectionAsync()
-    {
-        var graph = CreateGraphClient();
-        var connectionId = ConnectionId();
-
-    <% if (isPeopleConnector) { -%>
-        await UnregisterProfileSourceAsync(connectionId);
-    <% } -%>
-
-        try
-        {
-            await graph.External.Connections[connectionId].DeleteAsync();
-        }
-        catch (ApiException ex) when (IsStatus(ex, 404))
-        {
-            // Already deleted.
-        }
-        Console.WriteLine("ok: deleted");
-    }
-
-    var csvOption = new Option<string>("--csv", description: "CSV path");
-
-    var root = new RootCommand("Connector CLI generated by gcgen");
-
-    var provisionCommand = new Command("provision", "Create or update the connection and schema");
-    provisionCommand.SetHandler(async () => await ProvisionAsync());
-
-    var ingestCommand = new Command("ingest", "Ingest items from CSV");
-    ingestCommand.AddOption(csvOption);
-    ingestCommand.SetHandler(async (string? csv) => await IngestAsync(csv), csvOption);
-
-    var deleteCommand = new Command("delete", "Delete the connection");
-    deleteCommand.SetHandler(async () => await DeleteConnectionAsync());
-
-    root.AddCommand(provisionCommand);
-    root.AddCommand(ingestCommand);
-    root.AddCommand(deleteCommand);
-
-    <% if (isPeopleConnector) { -%>
-    var registerCommand = new Command("register-profile-source", "Register the connection as a profile source");
-    registerCommand.SetHandler(async () => await RegisterProfileSourceAsync(ConnectionId()));
-    root.AddCommand(registerCommand);
-    <% } -%>
-
-    return await root.InvokeAsync(args);
-{
-    var graph = CreateGraphClient();
-    var connectionId = RequiredEnv("CONNECTION_ID");
-
-    var csvArg = GetArgValue("--csv", allArgs);
-    var csvPath = !string.IsNullOrWhiteSpace(csvArg)
-        ? csvArg
-        : (Environment.GetEnvironmentVariable("CSV_PATH") ?? "data.csv");
-
-    IItemSource source = new CsvItemSource(csvPath);
-
-    var count = 0;
-    await foreach (var item in source.GetItemsAsync())
-    {
-        await PutItemAsync(graph, connectionId, item);
-        count++;
-    }
-
-    Console.WriteLine($"ok: ingested {count} item(s)");
-}
-
-try
-{
-    if (command == "provision")
-    {
-        await ProvisionAsync();
-    }
-    else if (command == "ingest")
-    {
-        await IngestAsync(args);
-    }
-    else if (command == "register-profile-source")
-    {
-        await RegisterProfileSourceAsync(RequiredEnv("CONNECTION_ID"));
-    }
-    else if (command == "delete")
-    {
-        await DeleteConnectionAsync();
-    }
-    else
-    {
-        Console.WriteLine("Usage:");
-        Console.WriteLine("  dotnet run -- provision");
-        Console.WriteLine("  dotnet run -- ingest --csv path/to.csv");
-        Console.WriteLine("  dotnet run -- register-profile-source");
-        Console.WriteLine("  dotnet run -- delete");
-        Environment.ExitCode = 1;
-    }
-}
-catch (ApiException ex)
-{
-    Console.Error.WriteLine("error: Graph request failed");
-    Console.Error.WriteLine(ex.Message);
-    Environment.ExitCode = 1;
-}
-catch (Exception ex)
-{
-    Console.Error.WriteLine("error: " + ex.Message);
-    Environment.ExitCode = 1;
-}

package/dist/init/templates/ts/src/generated/personEntityDefaults.ts.ejs

@@ -1,33 +0,0 @@
-// Auto-generated defaults for people connector entity payloads.
-// These are derived from @coco.source mappings and regenerated on every update.
-// Customize output in personEntityOverrides.ts instead.
-
-import type { Item } from "./model.js";
-import { parseString, parseStringCollection, readSourceValue } from "../datasource/csv.js";
-
-export function buildPersonEntityDefault(name: string, row: Record<string, unknown>): string {
-  switch (name) {
-<% for (const def of defaults) { -%>
-  <% if (!def.isCollection) { -%>
-    case <%= JSON.stringify(def.name) %>:
-      return <%- def.expression %>;
-  <% } -%>
-<% } -%>
-    default:
-      return "";
-  }
-}
-
-export function buildPersonEntityDefaultCollection(name: string, row: Record<string, unknown>): string[] {
-  switch (name) {
-<% for (const def of defaults) { -%>
-  <% if (def.isCollection) { -%>
-    case <%= JSON.stringify(def.name) %>: {
-      return <%- def.expression %>;
-    }
-  <% } -%>
-<% } -%>
-    default:
-      return [];
-  }
-}

package/dist/init/templates/ts/src/generated/propertyTransforms.ts.ejs

@@ -1,23 +0,0 @@
-// Property transforms for custom mapping logic.
-// For explicit @coco.source mappings, the function receives the source column value.
-// When no @coco.source is provided, the function receives the full row.
-
-import {
-  parseBoolean,
-  parseNumber,
-  parseNumberCollection,
-  parseString,
-  parseStringCollection,
-  readSourceValue
-} from "../datasource/csv.js";
-
-<% for (const prop of properties) { -%>
-export function transform<%= prop.transformName %>(<%= prop.isExplicitSource ? "value: unknown" : "row: Record<string, unknown>" %>): <%= prop.tsType %> {
-  // TODO: customize mapping for <%= prop.name %>
-  return <%- prop.isExplicitSource
-    ? `${prop.parser}(value)`
-    : `${prop.parser}(readSourceValue(row, ${JSON.stringify(prop.csvHeaders)}))`
-  %>;
-}
-
-<% } -%>

package/dist/init/templates/ts/src/personEntityOverrides.ts.ejs

@@ -1,36 +0,0 @@
-// User-editable overrides for people connector entity mapping.
-// This file is created once and will not be overwritten by cocogen update.
-
-export function transformPersonEntity(
-  name: string,
-  row: Record<string, unknown>,
-  value: string
-): string {
-  switch (name) {
-<% for (const propName of names) { -%>
-    case <%= JSON.stringify(propName) %>:
-      // TODO: customize mapping for this entity. Example for skillProficiency:
-      // return JSON.stringify({ displayName: String(row["skill"] ?? ""), proficiency: String(row["proficiency"] ?? "") });
-      return value;
-<% } -%>
-    default:
-      return value;
-  }
-}
-
-export function transformPersonEntityCollection(
-  name: string,
-  row: Record<string, unknown>,
-  value: string[]
-): string[] {
-  switch (name) {
-<% for (const propName of names) { -%>
-    case <%= JSON.stringify(propName) %>:
-      // TODO: customize mapping for this collection entity. Example for skills:
-      // return [JSON.stringify({ displayName: String(row["skill"] ?? ""), proficiency: String(row["proficiency"] ?? "") })];
-      return value;
-<% } -%>
-    default:
-      return value;
-  }
-}