@deterministic-code/datasources-cli 0.0.0-stage → 0.1.3

package/node_modules/@deterministic-code/csharp-generators/src/import-generator.ts

@@ -0,0 +1,226 @@
+import pluralize from "pluralize";
+import type { IImportGenerator } from "@deterministic-code/generators-common/import-generator";
+import { createCasing, type PackCasing } from "./common/default-casing.ts";
+
+const VARIANT_PREFIXES = ["update_", "create_"] as const;
+
+const featureEntity = (entity: string): string => {
+  const prefix = VARIANT_PREFIXES.find((p) => entity.startsWith(p));
+  return prefix === undefined ? entity : entity.slice(prefix.length);
+};
+
+const pluralSnake = (entity: string): string => {
+  const parts = entity.split(/[_-]/);
+  parts[parts.length - 1] = pluralize.plural(parts[parts.length - 1]!);
+  return parts.join("_");
+};
+
+const DATASOURCE_DIR = "Types/Datasource/Generated";
+const VIEW_DIR = "Types/View/Generated";
+const DATASOURCE_VALIDATOR_DIR = `${DATASOURCE_DIR}/Validators`;
+const VIEW_VALIDATOR_DIR = `${VIEW_DIR}/Validators`;
+
+export class CsharpImportGenerator implements IImportGenerator {
+  private readonly organizeByFeature: boolean;
+  private readonly flat: boolean;
+  private readonly basePath: string;
+  private readonly casing: PackCasing;
+
+  constructor(basePath: string, settings: Record<string, string>) {
+    this.basePath = basePath;
+    this.flat = basePath !== "" && basePath !== ".";
+    this.organizeByFeature =
+      !this.flat && settings["other.organize_by_feature"] === "true";
+    this.casing = createCasing(settings);
+  }
+
+  datasource(entity: string): string {
+    return this.underBase(this.rel(DATASOURCE_DIR, this.casedFile(entity)));
+  }
+
+  datasourceRel(entity: string): string {
+    return this.datasource(entity);
+  }
+
+  datasourceQual(entity: string): string {
+    return `Backend.Types.Datasource.${this.casing.convertTypes(entity)}`;
+  }
+
+  datasourceValidator(entity: string): string {
+    return this.underBase(
+      this.rel(
+        DATASOURCE_VALIDATOR_DIR,
+        this.csFile(`datasource_${entity}_validator`),
+      ),
+    );
+  }
+
+  datasourceValidatorRel(entity: string): string {
+    return this.datasourceValidator(entity);
+  }
+
+  view(entity: string): string {
+    return this.underBase(this.rel(VIEW_DIR, this.csFile(entity)));
+  }
+
+  viewRel(entity: string): string {
+    return this.view(entity);
+  }
+
+  viewQual(entity: string): string {
+    return `Backend.Types.View.${this.casing.convertTypes(entity)}`;
+  }
+
+  viewValidator(entity: string): string {
+    return this.underBase(
+      this.rel(VIEW_VALIDATOR_DIR, this.csFile(`${entity}_validator`)),
+    );
+  }
+
+  viewValidatorRel(entity: string): string {
+    return this.viewValidator(entity);
+  }
+
+  service(entity: string): string {
+    return this.underBase(this.csFile(`${entity}_service`));
+  }
+
+  serviceRel(entity: string): string {
+    return this.service(entity);
+  }
+
+  serviceCustom(name: string, _module?: string): string {
+    const file = this.csFile(name);
+    return this.underBase(
+      this.organizeByFeature
+        ? `Features/${this.casing.directory(featureEntity(name))}/custom/${file}`
+        : `../custom/${file}`,
+    );
+  }
+
+  serviceCustomRel(entity: string): string {
+    const file = this.csFile(entity);
+    return this.organizeByFeature
+      ? `Features/${this.casing.directory(entity)}/custom/${file}`
+      : `../custom/${file}`;
+  }
+
+  serviceTest(entity: string): string {
+    return this.underBase(this.csFile(`${entity}_service_tests`));
+  }
+
+  serviceTestRel(entity: string): string {
+    return this.serviceTest(entity);
+  }
+
+  serviceIntegrationTest(entity: string): string {
+    return this.serviceTest(entity);
+  }
+
+  serviceIntegrationTestRel(entity: string): string {
+    return this.serviceIntegrationTest(entity);
+  }
+
+  serviceUse(_entity: string, _symbol: string): string {
+    return "";
+  }
+
+  route(entity: string): string {
+    return this.underBase(`${this.routeModule(entity)}.cs`);
+  }
+
+  routeRel(entity: string): string {
+    return this.route(entity);
+  }
+
+  routeCustom(name: string, _module?: string): string {
+    const file = this.csFile(`${name}_route`);
+    return this.underBase(
+      this.organizeByFeature
+        ? `Features/${this.casing.directory(featureEntity(name))}/custom/${file}`
+        : `../custom/${file}`,
+    );
+  }
+
+  routeTest(entity: string): string {
+    return this.underBase(
+      this.csFile(`${pluralSnake(entity)}_router_tests`),
+    );
+  }
+
+  enrichment(targetTable: string): string {
+    return this.underBase(this.csFile(`${targetTable}_name_enrichment`));
+  }
+
+  test(srcFile: string, fileBase: string): string {
+    const stem = srcFile.includes("Validator")
+      ? `${fileBase}_validator_tests`
+      : `${fileBase}_tests`;
+    const file = this.csFile(stem);
+    const slash = srcFile.lastIndexOf("/");
+    if (slash === -1) return this.underBase(file);
+    return `${srcFile.slice(0, slash)}/${file}`;
+  }
+
+  testSpec(_srcFile: string, _fileBase: string): string {
+    return "";
+  }
+
+  index(_beside: string): string {
+    return "";
+  }
+
+  spec(_fromFile: string, _toFile: string): string {
+    return "Backend.Types.Datasource";
+  }
+
+  routeModule(entity: string): string {
+    return this.casing.fileBase(`${pluralSnake(entity)}_router`);
+  }
+
+  appWiring(): string {
+    return "";
+  }
+
+  validatorFn(
+    _kind: "datasource" | "view",
+    _entity: string,
+    _fn: string,
+  ): string {
+    return "";
+  }
+
+  apiPath(entity: string): string {
+    return entity.replace(/_/g, "-");
+  }
+
+  frontend(relPath: string): string {
+    return `frontend/${relPath}`;
+  }
+
+  private csFile(stem: string): string {
+    return `${this.casing.fileBase(stem)}.cs`;
+  }
+
+  private casedFile(entity: string): string {
+    const file = this.csFile(entity);
+    return this.organizeByFeature
+      ? `Features/${this.casing.directory(entity)}/${file}`
+      : file;
+  }
+
+  private rel(prefix: string, file: string): string {
+    if (this.organizeByFeature || this.flat) return file;
+    return `${prefix}/${file}`;
+  }
+
+  private underBase(file: string): string {
+    if (!this.flat) return file;
+    return `${this.basePath}/${file}`;
+  }
+}
+
+export const createImportGenerator = (
+  basePath: string,
+  settings: Record<string, string>,
+): CsharpImportGenerator => new CsharpImportGenerator(basePath, settings);

package/node_modules/@deterministic-code/csharp-generators/src/resources/backend-app.ts

@@ -0,0 +1,26 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(new URL(`../templates/create-backend-app/${rel}`, import.meta.url), "utf8");
+
+export const [
+  appCsproj,
+  programCs,
+  dockerfile,
+  appsettingsJson,
+  appsettingsDevelopmentJson,
+  entrypointSh,
+  dockerComposeYml,
+  envFile,
+  gitignore,
+] = await Promise.all([
+  resource("csharp/App/App.csproj.tmpl"),
+  resource("csharp/App/Program.cs.tmpl"),
+  resource("Dockerfile.tmpl"),
+  resource("csharp/App/appsettings.json.tmpl"),
+  resource("csharp/App/appsettings.Development.json.tmpl"),
+  resource("entrypoint.sh"),
+  resource("docker-compose.yml.tmpl"),
+  resource("env.tmpl"),
+  resource("gitignore.tmpl"),
+]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/datasource-type-validators-tests.ts

@@ -0,0 +1,12 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-datasource-type-validators-tests/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const typeTestTmpl = await resource("type.tests.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/resources/datasource-type-validators.ts

@@ -0,0 +1,12 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-datasource-type-validators/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const typeTmpl = await resource("type.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/resources/datasource-types-tests.ts

@@ -0,0 +1,11 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-datasource-types-tests/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [typeTestTmpl] = await Promise.all([
+  resource("type.tests.cs.tmpl"),
+]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/datasource-types.ts

@@ -0,0 +1,9 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-datasource-types/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const typeTmpl = await resource("type.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/resources/routes-tests.ts

@@ -0,0 +1,9 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-routes-tests/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [genericTmpl] = await Promise.all([resource("generic.cs.tmpl")]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/routes.ts

@@ -0,0 +1,14 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-routes/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [routerTmpl, customStubTmpl, nameEnrichmentTmpl] =
+  await Promise.all([
+    resource("router.cs.tmpl"),
+    resource("custom-stub.cs.tmpl"),
+    resource("name-enrichment.cs.tmpl"),
+  ]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/service-tests.ts

@@ -0,0 +1,9 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-service-tests/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [genericTmpl] = await Promise.all([resource("generic.cs.tmpl")]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/services.ts

@@ -0,0 +1,12 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-services/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [genericTmpl, customStubTmpl] = await Promise.all([
+  resource("generic.cs.tmpl"),
+  resource("custom-stub.cs.tmpl"),
+]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/view-type-validators-tests.ts

@@ -0,0 +1,12 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-view-type-validators-tests/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const typeTestTmpl = await resource("type.tests.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/resources/view-type-validators.ts

@@ -0,0 +1,9 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-view-type-validators/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const typeTmpl = await resource("type.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/resources/view-types-tests.ts

@@ -0,0 +1,11 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-view-types-tests/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [typeTestTmpl] = await Promise.all([
+  resource("type.tests.cs.tmpl"),
+]);

package/node_modules/@deterministic-code/csharp-generators/src/resources/view-types.ts

@@ -0,0 +1,9 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-view-types/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const typeTmpl = await resource("type.cs.tmpl");

package/node_modules/@deterministic-code/csharp-generators/src/specification-parser.ts

@@ -0,0 +1,34 @@
+export { DeterministicParser } from "@deterministic-code/deterministic-generators-common/parser";
+export type {
+  CustomRouteEntry,
+  CustomServiceEntry,
+  DatasourceFieldOverlay,
+  DatasourceIndex,
+  DatasourceTable,
+  DirectFkDescriptor,
+  FieldKind,
+  IDeterministic,
+  M2mDescriptor,
+  NestedRouteDescriptor,
+  ParsedRoutes,
+  ParsedServices,
+  RouteByField,
+  RouteCandidate,
+  SeedRow,
+  SeedValue,
+  ServiceByField,
+  ServiceCandidate,
+  Type,
+  TypeField,
+  TypeKind,
+} from "@deterministic-code/deterministic-generators-common/parser";
+export type { IDeterministicReader } from "@deterministic-code/generators-common/deterministic-reader";
+export {
+  DATASOURCE_SEEDS_YAML,
+  primaryKeyColumn,
+  ROUTES_YAML,
+  SERVICES_YAML,
+  typeHasTag,
+  TYPES_YAML,
+  uniqueLookupFields,
+} from "@deterministic-code/generators-common/spec-types";

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/Dockerfile.tmpl

@@ -0,0 +1,23 @@
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
+WORKDIR /src
+COPY {{PROJECT_NAME}}.csproj ./
+RUN dotnet restore {{PROJECT_NAME}}.csproj
+COPY . ./
+# === BEGIN MIGRATE_COPY — see PATCH_PLAN in create-migrate-scripts.mjs ===
+# === END MIGRATE_COPY ===
+RUN dotnet publish {{PROJECT_NAME}}.csproj -c Release -o /app/publish
+
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS runtime
+WORKDIR /app
+RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*
+COPY --from=build /app/publish ./
+# === BEGIN MIGRATE_RUNTIME_COPY — see PATCH_PLAN in create-migrate-scripts.mjs ===
+# === END MIGRATE_RUNTIME_COPY ===
+COPY scripts/entrypoint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+EXPOSE 4000
+ENV ASPNETCORE_URLS=http://+:4000
+HEALTHCHECK --interval=5s --timeout=3s --start-period=5s --retries=6 \
+  CMD curl -fsS http://localhost:4000/api/health || exit 1
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
+CMD ["dotnet", "{{PROJECT_NAME}}.dll"]

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/csharp/App/App.csproj.tmpl

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <RootNamespace>{{PROJECT_NAME}}</RootNamespace>
+    <AssemblyName>{{PROJECT_NAME}}</AssemblyName>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <IsPackable>false</IsPackable>
+    <!-- MigrateRunner/ (single-lang) and migrate/ (multi-lang) are sibling projects (see create-migrate-scripts.mjs); both excluded so the app's autoglob doesn't pull in their sources and trip on CS8802 (two top-level Program.cs) plus CS0234/CS0246 for MySqlConnector/Npgsql/Microsoft.Data (those packages are declared in MigrateRunner.csproj, not here). -->
+    <DefaultItemExcludes>$(DefaultItemExcludes);MigrateRunner/**/*;migrate/**/*</DefaultItemExcludes>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DotNetEnv" Version="3.2.0" />
+    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.0" />
+    <!-- === BEGIN DIALECT_PACKAGES — see PATCH_PLAN in create-migrate-scripts.mjs === -->
+    <!-- === END DIALECT_PACKAGES === -->
+  </ItemGroup>
+
+</Project>

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/csharp/App/Program.cs.tmpl

@@ -0,0 +1,28 @@
+// === BEGIN APP_DB_IMPORTS — see PATCH_PLAN in create-migrate-scripts.mjs ===
+// === END APP_DB_IMPORTS ===
+
+// NoClobber: real env vars win over .env, matching the ts/rust lanes; must run before CreateBuilder so ASPNETCORE_URLS from .env reaches Kestrel.
+DotNetEnv.Env.NoClobber().Load();
+
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddSingleton<IHealthCheckService, HealthCheckService>();
+// === BEGIN APP_BEFORE_HOOK — see PATCH_PLAN in create-migrate-scripts.mjs ===
+// === END APP_BEFORE_HOOK ===
+
+var app = builder.Build();
+
+app.MapGet("/api/health", (IHealthCheckService h) => h.Check());
+// === BEGIN APP_AFTER_HOOK — see PATCH_PLAN in create-migrate-scripts.mjs ===
+// === END APP_AFTER_HOOK ===
+
+app.Run();
+
+public interface IHealthCheckService
+{
+    object Check();
+}
+
+public sealed class HealthCheckService : IHealthCheckService
+{
+    public object Check() => new { ok = true };
+}

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/csharp/App/appsettings.Development.json.tmpl

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Debug",
+      "Microsoft.AspNetCore": "Information"
+    }
+  }
+}

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/csharp/App/appsettings.json.tmpl

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/docker-compose.yml.tmpl

@@ -0,0 +1,17 @@
+csharp:
+  build:
+    context: .
+  ports:
+    - '${HOST_PORT:-4003}:4000'
+  environment:
+    - ASPNETCORE_ENVIRONMENT=Production
+    - ASPNETCORE_URLS=http://+:4000
+    - DETERMINISTIC_TRACE=${DETERMINISTIC_TRACE:-}
+  healthcheck:
+    test: ['CMD-SHELL', 'curl -fsS http://localhost:4000/api/health || exit 1']
+    interval: 5s
+    timeout: 3s
+    retries: 6
+    start_period: 5s
+  labels:
+    - 'deterministic.language=csharp'

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/entrypoint.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+set -eu
+
+# === BEGIN MIGRATE_HOOK — see PATCH_PLAN in create-migrate-scripts.mjs ===
+# === END MIGRATE_HOOK ===
+
+exec "$@"

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/env.tmpl

@@ -0,0 +1 @@
+ASPNETCORE_URLS=http://+:4003

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-backend-app/gitignore.tmpl

@@ -0,0 +1,18 @@
+bin/
+obj/
+out/
+publish/
+*.user
+*.suo
+*.userosscache
+*.sln.docstates
+*.pidb
+*.svclog
+*.log
+.vs/
+.vscode/
+.idea/
+
+# Env / secrets
+.env.local
+appsettings.*.local.json

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-datasource-type-validators/type.cs.tmpl

@@ -0,0 +1,14 @@
+// schema-version: {{schemaVersion}}
+using FluentValidation;
+
+namespace {{namespace}};
+
+public class {{validatorClass}} : AbstractValidator<{{typesNamespace}}.{{className}}>
+{
+    public {{validatorClass}}()
+    {
+{{#rules}}
+{{&line}}
+{{/rules}}
+    }
+}

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-datasource-type-validators-tests/type.tests.cs.tmpl

@@ -0,0 +1,20 @@
+// schema-version: {{schemaVersion}}
+using Xunit;
+using FluentValidation;
+using Backend.Types.Datasource;
+using Backend.Validators.Datasource;
+
+namespace Backend.Tests.Datasource;
+
+public class {{testClassName}}
+{
+{{#cases}}
+    [Fact]
+    public void {{ident}}()
+    {
+        var value = {{&fixture}};
+        var result = new {{validatorClass}}().Validate(value);
+        Assert.{{assertion}}(result.IsValid);
+    }
+{{/cases}}
+}

package/node_modules/@deterministic-code/csharp-generators/src/templates/create-datasource-types/type.cs.tmpl

@@ -0,0 +1,15 @@
+// schema-version: {{schemaVersion}}
+namespace Backend.Types.Datasource;
+
+{{#simpleDoc}}/** Type {{className}}. */
+{{/simpleDoc}}{{#descriptionDoc}}/**
+ * Type {{className}}.
+ * Datasource type: {{datasourceType}}.
+ * Fields: {{fieldCount}}.
+ */
+{{/descriptionDoc}}public class {{className}}{{#hasExtends}} : {{&extendsType}}{{/hasExtends}}
+{
+{{#fields}}
+    public {{csType}} {{ident}} { get; set; }{{#hasInitializer}} = {{&initializer}}{{/hasInitializer}};
+{{/fields}}
+}