Generation Scripts

Automatically generates language-specific enums and documentation from TypeScript clients configuration. These scripts directly import the clients array, ensuring the generated files stay in perfect sync with the TypeScript source of truth.

Usage

.NET Enum Generation

pnpm generate:dotnet-enums

Generates C# enums for the .NET integration packages.

Generated Files (.NET)

• ScalarTarget.Generated.cs - Programming language targets (C#, JavaScript, etc.)
• ScalarClient.Generated.cs - HTTP clients (HttpClient, Fetch, etc.)
• ScalarOptionsMapper.Generated.cs - Target → Client mappings

Generated in: integrations/dotnet/shared/src/Scalar.Shared/

Java Enum Generation

pnpm generate:java-enums

Generates Java enums for the Java integration packages.

Generated Files (Java)

• ScalarTarget.java - Programming language targets (Java, JavaScript, etc.)
• ScalarClient.java - HTTP clients (OkHttp, AsyncHttp, etc.)

Generated in: integrations/java/scalar-core/src/main/java/com/scalar/maven/core/enums/

Markdown Documentation Generation

pnpm generate:markdown-docs

Automatically updates the hiddenClients property documentation in configuration.md with the current list of available clients, grouped by target/language.

Generated Content

Updates the hiddenClients section in documentation/configuration.md with:

• All available clients grouped by target/language
• Comments indicating which language each target represents
• Automatically kept in sync with the TypeScript source

The generated section is marked with HTML comments (<!-- AUTO-GENERATED:CLIENTS START --> and <!-- AUTO-GENERATED:CLIENTS END -->) to prevent manual edits.

Customization

.NET Generator

Customize PascalCase mappings in CUSTOM_PASCAL_CASE_MAPPINGS or obsolete clients in OBSOLETE_CLIENT_ENTRIES in generate-dotnet-enums.ts when needed.

Java Generator

Customize SCREAMING_SNAKE_CASE mappings in CUSTOM_JAVA_MAPPINGS or obsolete clients in OBSOLETE_CLIENT_ENTRIES in generate-java-enums.ts when needed.