@apollo-deploy/tesseract 1.8.0 → 2.0.0

package/README.md

@@ -26,22 +26,36 @@ This reads your manifest and produces a complete npm-ready TypeScript SDK in `./
 
 Generate an SDK from a static manifest file.
 
-| Flag | Required | Description |
-|------|----------|-------------|
-| `-i, --input <path>` | Yes | Path to the `sdk-manifold/v1` manifest JSON file |
-| `-o, --output <dir>` | Yes | Output directory for the generated SDK |
-| `-l, --language <lang>` | No | Target language: `typescript` (default), `python`, `ruby`, `php`, `go`, `rust`, `kotlin`, `csharp` |
-| `-n, --name <name>` | No | Override the npm package name |
-| `--package-version <version>` | No | Override the generated package version |
-| `--client-name <name>` | No | Override the generated client class name |
-| `--base-url <url>` | No | Override the default base URL |
-| `--sdk-style <style>` | No | `functional` (default) or `class` (Resend-style `new MySDK('key')`) |
-| `--client-type <type>` | No | `internal` (full options, default) or `public` (auth key only, baseUrl baked in) |
-| `--dry-run` | No | Preview changes without writing files |
-| `--check` | No | Exit non-zero if generated output is out of date |
+| Flag                          | Required | Description                                                                                        |
+| ----------------------------- | -------- | -------------------------------------------------------------------------------------------------- |
+| `-i, --input <path>`          | Yes      | Path to the `sdk-manifold/v1` manifest JSON file                                                   |
+| `-o, --output <dir>`          | Yes      | Output directory for the generated SDK                                                             |
+| `-l, --language <lang>`       | No       | Target language: `typescript` (default), `python`, `ruby`, `php`, `go`, `rust`, `kotlin`, `csharp` |
+| `-n, --name <name>`           | No       | Override the npm package name                                                                      |
+| `--package-version <version>` | No       | Override the generated package version                                                             |
+| `--version-bump <type>`       | No       | Automatic bump type: `patch` (default), `minor`, or `major`                                        |
+| `--client-name <name>`        | No       | Override the generated client class name                                                           |
+| `--base-url <url>`            | No       | Override the default base URL                                                                      |
+| `--sdk-style <style>`         | No       | `functional` (default) or `class` (Resend-style `new MySDK('key')`)                                |
+| `--client-type <type>`        | No       | `internal` (full options, default) or `public` (auth key only, baseUrl baked in)                   |
+| `--dry-run`                   | No       | Preview changes without writing files                                                              |
+| `--check`                     | No       | Exit non-zero if generated output is out of date                                                   |
 
 `--dry-run` and `--check` are mutually exclusive.
 
+### Versioning
+
+When `packageVersion` is omitted, Tesseract applies `versionBump` to the current package version. TypeScript checks npm first and falls back to `info.version`; other adapters use `info.version`. The default bump is `patch`.
+
+Patch and minor components use decimal carry instead of double digits:
+
+- `0.0.9` + patch → `0.1.0`
+- `0.9.9` + patch → `1.0.0`
+- `2.9.4` + minor → `3.0.0`
+- `2.8.7` + major → `3.0.0`
+
+Set the policy with `--version-bump`, `versionBump` in generator/collector config, or `info.versionBump` in a static manifest. An explicit `packageVersion` always wins.
+
 ### `tesseract run`
 
 Boot an instrumented Fastify app with `TESSERACT_GENERATE=1` to collect annotated routes at runtime and generate an SDK without a static manifest file.
@@ -56,16 +70,16 @@ The app must register `tesseractPlugin` from `@apollo-deploy/tesseract/fastify`.
 
 Tesseract ships adapters for multiple target languages. Pass `-l <lang>` to `tesseract generate`, set `language` in `CollectorOptions`, or use `additionalTargets` to emit multiple languages in a single run.
 
-| Language | Value | Output |
-|----------|-------|--------|
-| TypeScript | `typescript` | npm-ready package with Axios transport |
-| Python | `python` | pip-ready package |
-| Ruby | `ruby` | gem-ready package |
-| PHP | `php` | Composer package |
-| Go | `go` | Go module |
-| Rust | `rust` | Cargo crate |
-| Kotlin | `kotlin` | Gradle project with Ktor + kotlinx.serialization |
-| C# | `csharp` | NuGet package |
+| Language   | Value        | Output                                           |
+| ---------- | ------------ | ------------------------------------------------ |
+| TypeScript | `typescript` | npm-ready package with Axios transport           |
+| Python     | `python`     | pip-ready package                                |
+| Ruby       | `ruby`       | gem-ready package                                |
+| PHP        | `php`        | Composer package                                 |
+| Go         | `go`         | Go module                                        |
+| Rust       | `rust`       | Cargo crate                                      |
+| Kotlin     | `kotlin`     | Gradle project with Ktor + kotlinx.serialization |
+| C#         | `csharp`     | NuGet package                                    |
 
 ### Multiple targets in one run
 
@@ -73,8 +87,12 @@ Use `additionalTargets` on any collector or the Fastify plugin to emit multiple
 
 ```ts
 const collector = new SDKCollector({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
-  output: './sdk/typescript',             // primary — TypeScript
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
+  output: './sdk/typescript', // primary — TypeScript
   additionalTargets: [
     { language: 'kotlin', output: './sdk/java' },
     { language: 'python', output: './sdk/python', packageName: 'my-api' },
@@ -84,6 +102,39 @@ const collector = new SDKCollector({
 
 Each additional target inherits `clientType`, `packageName`, `packageVersion`, and `sdkStyle` from the primary options unless overridden per-target.
 
+Non-TypeScript additional targets automatically expand registered Zod / `$defs` types into local models (they cannot import a TypeScript `schemaPackage`). TypeScript additional targets inherit `schemaPackage` and re-export those types instead of regenerating them.
+
+## Generated SDK structure
+
+Every adapter emits a compact package overview and a separate reference tree:
+
+```text
+README.md
+docs/
+├── README.md          # documentation index
+├── types.md           # generated models, enums, unions, and aliases
+└── domains/
+    ├── users.md       # operations for one API domain
+    └── billing.md
+```
+
+The root README contains installation, quick start, reliability configuration, error handling, and links into the reference. Domain pages document HTTP paths, parameters by location, request bodies, response types, deprecations, streaming behavior, and links to generated source.
+
+### Generated transport reliability
+
+Generated transports share the same baseline behavior across all target languages:
+
+- Bounded request timeouts and cancellation where the language supports it
+- Structured errors with status, code, message, and request ID
+- Retries for transient network failures and HTTP `408`, `425`, `429`, `500`, `502`, `503`, and `504`
+- Exponential backoff with jitter and `Retry-After` support
+- Automatic retries for idempotent methods only
+- `POST` and `PATCH` retries only when explicitly enabled or an `X-Idempotency-Key` is supplied
+- Default headers and a generated SDK user agent where the runtime permits it
+- Explicit client cleanup for transports that own sockets or connection pools
+
+The exact option names follow each target language's conventions and are shown in the generated README.
+
 ## Input: The Manifest
 
 Tesseract consumes a `BackendManifest` JSON file with `$schema: "sdk-manifold/v1"`:
@@ -94,6 +145,7 @@ Tesseract consumes a `BackendManifest` JSON file with `$schema: "sdk-manifold/v1
   "info": {
     "title": "My API",
     "version": "1.0.0",
+    "versionBump": "patch",
     "description": "An example API",
     "baseUrl": "https://api.example.com"
   },
@@ -129,7 +181,7 @@ Tesseract consumes a `BackendManifest` JSON file with `$schema: "sdk-manifold/v1
 
 ### Key Manifest Fields
 
-- **`info`** — Title, version, description, and base URL for the API
+- **`info`** — Title, version, optional `versionBump`, description, and base URL for the API
 - **`domains`** — Groups of routes organized by domain, each with a prefix, stability level (`stable` / `experimental` / `internal`), and route definitions. `internal`-stability domains are excluded from public SDK builds.
 - **`definitions`** — JSON Schema definitions for shared types
 - **`schemaPackage`** _(optional)_ — An external npm package to import types from instead of generating them
@@ -147,14 +199,14 @@ Each route in a domain can specify:
 
 Tesseract ships adapters for every major Node.js API framework. Each adapter is a separate subpath export so you only pull in what you use.
 
-| Framework | Import |
-|-----------|--------|
-| **Fastify** | `@apollo-deploy/tesseract/fastify` |
-| **Express** | `@apollo-deploy/tesseract/express` |
-| **Hono** | `@apollo-deploy/tesseract/hono` |
-| **Koa** | `@apollo-deploy/tesseract/koa` |
-| **Elysia** | `@apollo-deploy/tesseract/elysia` |
-| **NestJS** | `@apollo-deploy/tesseract/nestjs` |
+| Framework                   | Import                                                    |
+| --------------------------- | --------------------------------------------------------- |
+| **Fastify**                 | `@apollo-deploy/tesseract/fastify`                        |
+| **Express**                 | `@apollo-deploy/tesseract/express`                        |
+| **Hono**                    | `@apollo-deploy/tesseract/hono`                           |
+| **Koa**                     | `@apollo-deploy/tesseract/koa`                            |
+| **Elysia**                  | `@apollo-deploy/tesseract/elysia`                         |
+| **NestJS**                  | `@apollo-deploy/tesseract/nestjs`                         |
 | **Generic / any framework** | `import { SDKCollector } from '@apollo-deploy/tesseract'` |
 
 All adapters share the same `CollectorOptions` interface, which means `language` and `additionalTargets` work identically across every framework.
@@ -170,12 +222,14 @@ The Fastify adapter hooks into `onRoute` to collect routes automatically at boot
 import { tesseractPlugin } from '@apollo-deploy/tesseract/fastify';
 
 app.register(tesseractPlugin, {
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
   // Generate a Kotlin SDK alongside the primary TypeScript one:
-  additionalTargets: [
-    { language: 'kotlin', output: './sdk/java' },
-  ],
+  additionalTargets: [{ language: 'kotlin', output: './sdk/java' }],
   // Optional: import types from a shared package instead of regenerating them
   schemaPackage: { name: '@my-org/schemas', version: '^2.0.0' },
   sdkStyle: 'functional', // or 'class'
@@ -188,10 +242,14 @@ The plugin is a complete no-op unless `TESSERACT_GENERATE=1` is set, so it is sa
 Add `sdk` as a top-level option on each route (sibling to `schema`):
 
 ```ts
-fastify.get('/:id', {
-  schema: { response: { 200: UserSchema } },
-  sdk: { methodName: 'getUser' },
-}, handler);
+fastify.get(
+  '/:id',
+  {
+    schema: { response: { 200: UserSchema } },
+    sdk: { methodName: 'getUser' },
+  },
+  handler,
+);
 ```
 
 Use `sdkDomain()` to name the domain and set a description:
@@ -203,10 +261,14 @@ import { sdkDomain } from '@apollo-deploy/tesseract/fastify';
 export default fp(async (fastify) => {
   sdkDomain(fastify, { domain: 'users', description: 'User management' });
 
-  fastify.get('/:id', {
-    schema: { response: { 200: UserSchema } },
-    sdk: { methodName: 'getUser' },
-  }, handler);
+  fastify.get(
+    '/:id',
+    {
+      schema: { response: { 200: UserSchema } },
+      sdk: { methodName: 'getUser' },
+    },
+    handler,
+  );
 });
 ```
 
@@ -224,6 +286,7 @@ export class UsersPlugin {
 ```
 
 **Trigger:**
+
 ```bash
 tesseract run dist/app.js
 # or
@@ -240,21 +303,29 @@ import { ExpressSDKCollector } from '@apollo-deploy/tesseract/express';
 
 const app = express();
 const collector = new ExpressSDKCollector({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
-  additionalTargets: [
-    { language: 'kotlin', output: './sdk/java' },
-  ],
+  additionalTargets: [{ language: 'kotlin', output: './sdk/java' }],
 });
 
 collector.domain('/users', { domain: 'users', description: 'User management' });
 
-app.get('/users/:id',
-  collector.expressRoute('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+app.get(
+  '/users/:id',
+  collector.expressRoute('/users/:id', 'GET', {
+    sdk: { methodName: 'getUser' },
+  }),
   getUserHandler,
 );
-app.post('/users',
-  collector.expressRoute('/users', 'POST', { sdk: { methodName: 'createUser' } }),
+app.post(
+  '/users',
+  collector.expressRoute('/users', 'POST', {
+    sdk: { methodName: 'createUser' },
+  }),
   createUserHandler,
 );
 
@@ -276,14 +347,21 @@ import { HonoSDKCollector } from '@apollo-deploy/tesseract/hono';
 
 const app = new Hono();
 const collector = new HonoSDKCollector({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
 });
 
 collector.domain('/users', { domain: 'users', description: 'User management' });
 
-app.get('/users/:id',
-  collector.honoMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+app.get(
+  '/users/:id',
+  collector.honoMiddleware('/users/:id', 'GET', {
+    sdk: { methodName: 'getUser' },
+  }),
   (c) => c.json(getUser(c.req.param('id'))),
 );
 
@@ -306,14 +384,21 @@ import { KoaSDKCollector } from '@apollo-deploy/tesseract/koa';
 const app = new Koa();
 const router = new Router();
 const collector = new KoaSDKCollector({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
 });
 
 collector.domain('/users', { domain: 'users', description: 'User management' });
 
-router.get('/users/:id',
-  collector.koaMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+router.get(
+  '/users/:id',
+  collector.koaMiddleware('/users/:id', 'GET', {
+    sdk: { methodName: 'getUser' },
+  }),
   getUserHandler,
 );
 
@@ -335,7 +420,11 @@ import { Elysia } from 'elysia';
 import { tesseractPlugin } from '@apollo-deploy/tesseract/elysia';
 
 const { plugin, collector } = tesseractPlugin({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
 });
 
@@ -382,7 +471,10 @@ export class UsersController {
 // main.ts
 import { NestFactory } from '@nestjs/core';
 import { AppModule } from './app.module';
-import { SDKCollector, collectFromNestControllers } from '@apollo-deploy/tesseract/nestjs';
+import {
+  SDKCollector,
+  collectFromNestControllers,
+} from '@apollo-deploy/tesseract/nestjs';
 import { UsersController } from './users/users.controller';
 
 async function bootstrap() {
@@ -391,11 +483,13 @@ async function bootstrap() {
 
   if (process.env.TESSERACT_GENERATE) {
     const collector = new SDKCollector({
-      info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+      info: {
+        title: 'My API',
+        version: '1.0.0',
+        baseUrl: 'https://api.example.com',
+      },
       output: './packages/api-sdk',
-      additionalTargets: [
-        { language: 'kotlin', output: './sdk/java' },
-      ],
+      additionalTargets: [{ language: 'kotlin', output: './sdk/java' }],
     });
     collectFromNestControllers([UsersController], collector);
     await collector.generate();
@@ -422,7 +516,11 @@ Use `SDKCollector` directly from the main package with any HTTP framework:
 import { SDKCollector } from '@apollo-deploy/tesseract';
 
 const collector = new SDKCollector({
-  info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+    baseUrl: 'https://api.example.com',
+  },
   output: './packages/api-sdk',
   additionalTargets: [
     { language: 'kotlin', output: './sdk/java' },
@@ -521,14 +619,18 @@ const client = createMyApiClient({
   apiKey: 'sk_...',
   timeoutMs: 10000,
   retries: { attempts: 3, backoffMs: 500, jitter: true },
-  plugins: [{
-    name: 'logger',
-    beforeRequest(config) {
-      console.log('→', config.method, config.url);
+  plugins: [
+    {
+      name: 'logger',
+      beforeRequest(config) {
+        console.log('→', config.method, config.url);
+      },
     },
-  }],
+  ],
   onError({ method, url, error, attempt, willRetry }) {
-    console.error(`${method} ${url} failed (attempt ${attempt}, retry: ${willRetry})`);
+    console.error(
+      `${method} ${url} failed (attempt ${attempt}, retry: ${willRetry})`,
+    );
   },
 });
 
@@ -581,7 +683,7 @@ await generate({
   output: './sdk',
   language: 'kotlin',
   packageName: '@my-org/api-sdk',
-  packageVersion: '1.2.3',
+  versionBump: 'minor',
 });
 ```
 
@@ -591,7 +693,9 @@ You can also pass a pre-parsed manifest object:
 import { generate } from '@apollo-deploy/tesseract';
 import type { BackendManifest } from '@apollo-deploy/tesseract';
 
-const manifest: BackendManifest = { /* ... */ };
+const manifest: BackendManifest = {
+  /* ... */
+};
 
 await generate({ manifest, output: './sdk', language: 'kotlin' });
 ```
@@ -600,49 +704,53 @@ await generate({ manifest, output: './sdk', language: 'kotlin' });
 
 Either `input` or `manifest` must be provided.
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `input` | `string?` | Path to the manifest file. Required if `manifest` is not provided. |
-| `manifest` | `BackendManifest?` | Pre-parsed manifest object. Alternative to `input`. |
-| `output` | `string` | Output directory |
-| `language` | `TargetLanguage?` | Target language (default: `typescript`). One of: `typescript`, `python`, `ruby`, `php`, `go`, `rust`, `kotlin`, `csharp` |
-| `packageName` | `string?` | Override npm/package name |
-| `packageVersion` | `string?` | Override generated package version; defaults to `info.version` from the manifest |
-| `clientName` | `string?` | Override client class name |
-| `baseUrl` | `string?` | Override default base URL |
-| `sdkStyle` | `'functional' \| 'class'?` | `functional` (default) generates a `createMyClient(config)` factory; `class` generates a Resend-style `new MySDK('api_key', options?)` class |
-| `clientType` | `'internal' \| 'public'?` | `internal` (default) exposes full config options; `public` accepts only an auth key with `baseUrl` baked in |
-| `environments` | `{ name: string; baseUrl: string }[]?` | Named environment presets |
-| `dryRun` | `boolean?` | Transform only, no file I/O |
-| `check` | `boolean?` | Compare output without writing |
-| `prettier` | `boolean?` | Toggle formatting (default: `true`) |
+| Option           | Type                                   | Description                                                                                                                                  |
+| ---------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`          | `string?`                              | Path to the manifest file. Required if `manifest` is not provided.                                                                           |
+| `manifest`       | `BackendManifest?`                     | Pre-parsed manifest object. Alternative to `input`.                                                                                          |
+| `output`         | `string`                               | Output directory                                                                                                                             |
+| `language`       | `TargetLanguage?`                      | Target language (default: `typescript`). One of: `typescript`, `python`, `ruby`, `php`, `go`, `rust`, `kotlin`, `csharp`                     |
+| `packageName`    | `string?`                              | Override npm/package name                                                                                                                    |
+| `packageVersion` | `string?`                              | Exact generated package version override                                                                                                     |
+| `versionBump`    | `'patch' \| 'minor' \| 'major'?`       | Automatic bump when `packageVersion` is omitted; defaults to `patch`                                                                         |
+| `clientName`     | `string?`                              | Override client class name                                                                                                                   |
+| `baseUrl`        | `string?`                              | Override default base URL                                                                                                                    |
+| `sdkStyle`       | `'functional' \| 'class'?`             | `functional` (default) generates a `createMyClient(config)` factory; `class` generates a Resend-style `new MySDK('api_key', options?)` class |
+| `clientType`     | `'internal' \| 'public'?`              | `internal` (default) exposes full config options; `public` accepts only an auth key with `baseUrl` baked in                                  |
+| `environments`   | `{ name: string; baseUrl: string }[]?` | Named environment presets                                                                                                                    |
+| `dryRun`         | `boolean?`                             | Transform only, no file I/O                                                                                                                  |
+| `check`          | `boolean?`                             | Compare output without writing                                                                                                               |
+| `prettier`       | `boolean?`                             | Toggle formatting (default: `true`)                                                                                                          |
 
 ### `CollectorOptions`
 
 Shared by all framework adapters and `SDKCollector`. Extends the programmatic API config with `additionalTargets`.
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `info` | `object` | API metadata: `title`, `version`, `baseUrl?`, `description?` |
-| `output` | `string` | Primary output directory |
-| `language` | `TargetLanguage?` | Primary target language (default: `typescript`) |
-| `additionalTargets` | `AdditionalTarget[]?` | Extra languages to emit alongside the primary output |
-| `schemaPackage` | `object?` | External type package: `name`, `version?`, `importPath?` |
-| `sdkStyle` | `'functional' \| 'class'?` | SDK style |
-| `clientType` | `'internal' \| 'public'?` | Client type |
-| `packageName` | `string?` | Override package name |
-| `packageVersion` | `string?` | Override package version |
+| Option              | Type                             | Description                                                  |
+| ------------------- | -------------------------------- | ------------------------------------------------------------ |
+| `info`              | `object`                         | API metadata: `title`, `version`, `baseUrl?`, `description?` |
+| `output`            | `string`                         | Primary output directory                                     |
+| `language`          | `TargetLanguage?`                | Primary target language (default: `typescript`)              |
+| `additionalTargets` | `AdditionalTarget[]?`            | Extra languages to emit alongside the primary output         |
+| `schemaPackage`     | `object?`                        | External type package: `name`, `version?`, `importPath?`     |
+| `sdkStyle`          | `'functional' \| 'class'?`       | SDK style                                                    |
+| `clientType`        | `'internal' \| 'public'?`        | Client type                                                  |
+| `packageName`       | `string?`                        | Override package name                                        |
+| `packageVersion`    | `string?`                        | Exact package version override                               |
+| `versionBump`       | `'patch' \| 'minor' \| 'major'?` | Automatic bump policy; defaults to `patch`                   |
 
 Each `AdditionalTarget` entry:
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `language` | `TargetLanguage` | Required. Target language for this output |
-| `output` | `string` | Required. Output directory |
-| `packageName` | `string?` | Overrides primary `packageName` for this target |
-| `packageVersion` | `string?` | Overrides primary `packageVersion` for this target |
-| `clientType` | `'internal' \| 'public'?` | Overrides primary `clientType` for this target |
-| `sdkStyle` | `'functional' \| 'class'?` | Overrides primary `sdkStyle` for this target |
+| Field            | Type                             | Description                                                                                                                                           |
+| ---------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `language`       | `TargetLanguage`                 | Required. Target language for this output                                                                                                             |
+| `output`         | `string`                         | Required. Output directory                                                                                                                            |
+| `packageName`    | `string?`                        | Overrides primary `packageName` for this target                                                                                                       |
+| `packageVersion` | `string?`                        | Overrides primary `packageVersion` for this target                                                                                                    |
+| `versionBump`    | `'patch' \| 'minor' \| 'major'?` | Overrides primary `versionBump` for this target                                                                                                       |
+| `clientType`     | `'internal' \| 'public'?`        | Overrides primary `clientType` for this target                                                                                                        |
+| `sdkStyle`       | `'functional' \| 'class'?`       | Overrides primary `sdkStyle` for this target                                                                                                          |
+| `schemaPackage`  | `object \| null?`                | Override schema package. Non-TS languages default to expanding types inline (`null`). Pass an object to force external imports, or `null` explicitly. |
 
 ## Requirements
 

package/dist/adapters/csharp/index.d.ts

@@ -1,12 +1,9 @@
-/**
- * C# (dotnet) language adapter.
- * Generates an idiomatic C# SDK targeting net8.0 with System.Text.Json.
- */
-import type { EnrichedSDKIR } from "../../types/ir.js";
-import type { LanguageAdapter, EmitResult } from "../types.js";
-import type { ResolvedConfig } from "../../types/config.js";
+/** C# language adapter targeting .NET 8. */
+import type { EnrichedSDKIR } from '../../types/ir.js';
+import type { ResolvedConfig } from '../../types/config.js';
+import type { EmitResult, LanguageAdapter } from '../types.js';
 export declare class CSharpAdapter implements LanguageAdapter {
     readonly language = "csharp";
-    emit(enriched: EnrichedSDKIR, outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+    emit(enriched: EnrichedSDKIR, _outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/csharp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/csharp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAU5D,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAEvB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CAsHvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/csharp/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAK5C,OAAO,KAAK,EACV,aAAa,EAId,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAuU/D,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAEvB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CAsGvB"}