@apollo-deploy/tesseract 1.8.0 → 2.0.0

package/dist/utils/npm-token.js

@@ -1,90 +1,41 @@
-/**
- * Resolves a private npm registry auth token from multiple sources.
- *
- * Works across npm, yarn, pnpm, and bun — all respect .npmrc files.
- */
-import { execSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-const REGISTRY_HOST = "//registry.npmjs.org/";
-const AUTH_TOKEN_KEY = `${REGISTRY_HOST}:_authToken`;
-/**
- * Resolves the npm auth token for registry.npmjs.org.
- *
- * Tries sources in order:
- * 1. Explicit token (passed by user)
- * 2. NPM_TOKEN environment variable
- * 3. `npm config get` (works with npm installed alongside any runtime)
- * 4. User-level ~/.npmrc (parsed directly — works for npm, yarn, pnpm, bun)
- * 5. Project-local .npmrc
- *
- * Returns undefined if no token is found (caller falls back gracefully).
- */
+/** Resolves the npm registry token without spawning a package-manager process. */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const AUTH_TOKEN_KEY = '//registry.npmjs.org/:_authToken';
+const ENV_REFERENCE = /\$\{([^}]+)\}/g;
 export function resolveNpmToken(explicitToken) {
-    // 1. Explicit token passed by user
     if (explicitToken)
         return explicitToken;
-    // 2. Environment variable (most common in CI/CD)
-    const envToken = process.env.NPM_TOKEN;
+    const envToken = process.env.NPM_TOKEN ?? process.env.NODE_AUTH_TOKEN;
     if (envToken)
         return envToken;
-    // 3. npm config get — authoritative source for npm-based setups.
-    //    Uses execSync so it works synchronously in config resolution.
-    try {
-        const token = execSync(`npm config get ${JSON.stringify(AUTH_TOKEN_KEY)}`, {
-            encoding: "utf-8",
-            timeout: 3000,
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        // npm config get returns the literal string "undefined" when unset
-        if (token && token !== "undefined")
-            return token;
-    }
-    catch {
-        // npm not available, timed out, or failed — fall through
-    }
-    // 4. Parse ~/.npmrc directly (universal — all package managers respect this)
-    try {
-        const token = parseNpmrcForToken(join(homedir(), ".npmrc"));
-        if (token)
-            return token;
-    }
-    catch {
-        // file doesn't exist or can't be read
-    }
-    // 5. Project-local .npmrc
+    return readToken('.npmrc') ?? readToken(join(homedir(), '.npmrc'));
+}
+function readToken(filePath) {
+    let contents;
     try {
-        const token = parseNpmrcForToken(".npmrc");
-        if (token)
-            return token;
+        contents = readFileSync(filePath, 'utf8');
     }
     catch {
-        // no local .npmrc
+        return undefined;
     }
-    return undefined;
-}
-/**
- * Parses an .npmrc-style file for the auth token of registry.npmjs.org.
- *
- * Supported formats:
- *   //registry.npmjs.org/:_authToken=npm_abc123
- *   //registry.npmjs.org/:_authToken = npm_abc123
- */
-function parseNpmrcForToken(filePath) {
-    const contents = readFileSync(filePath, "utf-8");
-    for (const line of contents.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#"))
+    for (const line of contents.split(/\r?\n/)) {
+        const separator = line.indexOf('=');
+        if (separator < 0)
             continue;
-        const eqIdx = trimmed.indexOf("=");
-        if (eqIdx === -1)
+        const key = line.slice(0, separator).trim();
+        if (key !== AUTH_TOKEN_KEY)
             continue;
-        const key = trimmed.slice(0, eqIdx).trim();
-        const value = trimmed.slice(eqIdx + 1).trim();
-        if (key === AUTH_TOKEN_KEY && value) {
-            return value;
-        }
+        const rawValue = line.slice(separator + 1).trim();
+        if (!rawValue)
+            return undefined;
+        const value = rawValue.length >= 2 &&
+            rawValue[0] === rawValue.at(-1) &&
+            ['"', "'"].includes(rawValue[0])
+            ? rawValue.slice(1, -1)
+            : rawValue;
+        return value.replace(ENV_REFERENCE, (_, name) => process.env[name] ?? '');
     }
     return undefined;
 }

package/dist/utils/npm-token.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-token.js","sourceRoot":"","sources":["../../src/utils/npm-token.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAC9C,MAAM,cAAc,GAAG,GAAG,aAAa,aAAa,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,aAAsB;IACpD,mCAAmC;IACnC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,iDAAiD;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,iEAAiE;IACjE,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE;YACzE,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,mEAAmE;QACnE,IAAI,KAAK,IAAI,KAAK,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAE3B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9C,IAAI,GAAG,KAAK,cAAc,IAAI,KAAK,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"npm-token.js","sourceRoot":"","sources":["../../src/utils/npm-token.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,MAAM,UAAU,eAAe,CAAC,aAAsB;IACpD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,cAAc;YAAE,SAAS;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,KAAK,GACT,QAAQ,CAAC,MAAM,IAAI,CAAC;YACpB,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC,CAAC,QAAQ,CAAC;QACf,OAAO,KAAK,CAAC,OAAO,CAClB,aAAa,EACb,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,14 @@
+import type { VersionBump } from '../types/ir.js';
+/**
+ * Converts an existing numeric version to Tesseract's decimal-carry format.
+ * Patch and minor components remain in the 0-9 range.
+ */
+export declare function normalizeVersion(version: string): string;
+export declare function bumpVersion(version: string, bump?: VersionBump): string;
+export interface ResolvePackageVersionOptions {
+    currentVersion: string;
+    packageVersion?: string;
+    bump?: VersionBump;
+}
+export declare function resolvePackageVersion({ currentVersion, packageVersion, bump, }: ResolvePackageVersionOptions): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiBlD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAqB,GAC1B,MAAM,CA4BR;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,cAAc,EACd,cAAc,EACd,IAAI,GACL,EAAE,4BAA4B,GAAG,MAAM,CAQvC"}

package/dist/utils/version.js

@@ -0,0 +1,60 @@
+const VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseVersion(version) {
+    const value = version.trim();
+    const match = VERSION_PATTERN.exec(value);
+    if (!match)
+        throw new Error(`Invalid version: "${version}"`);
+    const parts = match.slice(1, 4).map(Number);
+    if (parts.some((part) => !Number.isSafeInteger(part))) {
+        throw new Error(`Invalid version: "${version}"`);
+    }
+    return parts;
+}
+/**
+ * Converts an existing numeric version to Tesseract's decimal-carry format.
+ * Patch and minor components remain in the 0-9 range.
+ */
+export function normalizeVersion(version) {
+    let [major, minor, patch] = parseVersion(version);
+    minor += Math.floor(patch / 10);
+    patch %= 10;
+    major += Math.floor(minor / 10);
+    minor %= 10;
+    return `${major}.${minor}.${patch}`;
+}
+export function bumpVersion(version, bump = 'patch') {
+    let [major, minor, patch] = normalizeVersion(version).split('.').map(Number);
+    switch (bump) {
+        case 'major':
+            major += 1;
+            minor = 0;
+            patch = 0;
+            break;
+        case 'minor':
+            minor += 1;
+            patch = 0;
+            break;
+        case 'patch':
+            patch += 1;
+            break;
+    }
+    if (patch >= 10) {
+        minor += Math.floor(patch / 10);
+        patch %= 10;
+    }
+    if (minor >= 10) {
+        major += Math.floor(minor / 10);
+        minor %= 10;
+    }
+    return `${major}.${minor}.${patch}`;
+}
+export function resolvePackageVersion({ currentVersion, packageVersion, bump, }) {
+    if (packageVersion) {
+        parseVersion(packageVersion);
+        return packageVersion.trim();
+    }
+    return bump
+        ? bumpVersion(currentVersion, bump)
+        : normalizeVersion(currentVersion);
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GACnB,gEAAgE,CAAC;AAEnE,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,GAAG,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAA6B,CAAC;IACxE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAElD,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAChC,KAAK,IAAI,EAAE,CAAC;IACZ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAChC,KAAK,IAAI,EAAE,CAAC;IAEZ,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAAoB,OAAO;IAE3B,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,GAAG,CAAC,CAAC;YACV,MAAM;QACR,KAAK,OAAO;YACV,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,GAAG,CAAC,CAAC;YACV,MAAM;QACR,KAAK,OAAO;YACV,KAAK,IAAI,CAAC,CAAC;YACX,MAAM;IACV,CAAC;IAED,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAChC,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAChC,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;AACtC,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,EACpC,cAAc,EACd,cAAc,EACd,IAAI,GACyB;IAC7B,IAAI,cAAc,EAAE,CAAC;QACnB,YAAY,CAAC,cAAc,CAAC,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI;QACT,CAAC,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC;QACnC,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@apollo-deploy/tesseract",
-  "version": "1.8.0",
+  "version": "2.0.0",
   "type": "module",
-  "description": "Manifest-first SDK generator — turns sdk-manifold/v1 manifests into production-ready TypeScript SDKs",
+  "description": "Manifest-first SDK generator for TypeScript, Python, Ruby, PHP, Go, Rust, Kotlin, and C#",
   "bin": {
     "tesseract": "./dist/cli.js"
   },
@@ -59,7 +59,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "bun src/cli.ts",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "npm test",
+    "test": "npm run build && node --test test/*.test.mjs"
   },
   "dependencies": {
     "change-case": "^5.4.4",

package/templates/csharp/client.hbs

@@ -2,94 +2,71 @@ namespace {{namespace}};
 
 using System;
 using System.Collections.Generic;
+using System.Net.Http;
 using {{namespace}}.Api;
 
-/// <summary>
-/// Configuration for the {{clientName}} API client.
-/// </summary>
-public class {{clientName}}ClientConfig
+/// <summary>Configuration for the {{clientName}} API client.</summary>
+public sealed class {{clientName}}ClientConfig
 {
-    /// <summary>
-    /// Base URL for all API requests.
-    /// </summary>
     public string BaseUrl { get; set; } = "{{baseUrl}}";
 {{#each securitySchemes}}
 {{#if (eq type "apiKey")}}
-    /// <summary>
-    /// API key for the {{name}} security scheme.
-    /// </summary>
+    /// <summary>API key for the {{name}} security scheme.</summary>
     public string? {{pascalCase configKey}} { get; set; }
 {{/if}}
 {{#if (and (eq type "http") (eq scheme "bearer"))}}
-    /// <summary>
-    /// Bearer token for the {{name}} security scheme.
-    /// </summary>
+    /// <summary>Bearer token for the {{name}} security scheme.</summary>
     public string? {{pascalCase configKey}} { get; set; }
 {{/if}}
 {{#if (eq type "oauth2")}}
-    /// <summary>
-    /// OAuth2 access token for the {{name}} security scheme.
-    /// </summary>
+    /// <summary>OAuth2 access token for the {{name}} security scheme.</summary>
     public string? {{pascalCase configKey}} { get; set; }
 {{/if}}
 {{#if (eq type "openIdConnect")}}
-    /// <summary>
-    /// OpenID Connect token for the {{name}} security scheme.
-    /// </summary>
+    /// <summary>OpenID Connect token for the {{name}} security scheme.</summary>
     public string? {{pascalCase configKey}} { get; set; }
 {{/if}}
 {{/each}}
-    /// <summary>
-    /// Request timeout in milliseconds.
-    /// </summary>
     public int TimeoutMs { get; set; } = 15000;
-
-    /// <summary>
-    /// Maximum number of retry attempts for transient failures.
-    /// </summary>
     public int MaxRetries { get; set; } = 3;
-
-    /// <summary>
-    /// Default headers sent with every request.
-    /// </summary>
+    public bool RetryUnsafeRequests { get; set; }
     public Dictionary<string, string>? DefaultHeaders { get; set; }
+    /// <summary>Optional shared HttpClient. The SDK will not dispose an injected client.</summary>
+    public HttpClient? HttpClient { get; set; }
 }
 
-/// <summary>
-/// Primary API client for {{title}}.
-/// </summary>
-public class {{clientName}}Client
+/// <summary>Primary API client for {{title}}.</summary>
+public sealed class {{clientName}}Client : IDisposable
 {
     private readonly Transport _transport;
 
 {{#each groups}}
-    /// <summary>
-    /// {{#if description}}{{description}}{{else}}{{name}} operations{{/if}}
-    /// </summary>
+    /// <summary>{{#if description}}{{description}}{{else}}{{name}} operations{{/if}}</summary>
     public {{interfaceName}} {{pascalCase name}} { get; }
 {{/each}}
 
-    /// <summary>
-    /// Creates a new {{clientName}} API client.
-    /// </summary>
-    /// <param name="config">Client configuration. If null, defaults are used.</param>
     public {{clientName}}Client({{clientName}}ClientConfig? config = null)
     {
         config ??= new {{clientName}}ClientConfig();
 
-        _transport = new Transport(new TransportConfig
-        {
-            BaseUrl = config.BaseUrl,
+        _transport = new Transport(
+            new TransportConfig
+            {
+                BaseUrl = config.BaseUrl,
 {{#each securitySchemes}}
-            {{pascalCase configKey}} = config.{{pascalCase configKey}},
+                {{pascalCase configKey}} = config.{{pascalCase configKey}},
 {{/each}}
-            TimeoutMs = config.TimeoutMs,
-            MaxRetries = config.MaxRetries,
-            DefaultHeaders = config.DefaultHeaders,
-        });
+                TimeoutMs = config.TimeoutMs,
+                MaxRetries = config.MaxRetries,
+                RetryUnsafeRequests = config.RetryUnsafeRequests,
+                DefaultHeaders = config.DefaultHeaders,
+            },
+            config.HttpClient);
 
 {{#each groups}}
         {{pascalCase name}} = new {{interfaceName}}(_transport);
 {{/each}}
     }
+
+    public void Dispose() => _transport.Dispose();
 }

package/templates/csharp/csproj.hbs

@@ -9,8 +9,15 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <RootNamespace>{{namespace}}</RootNamespace>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Update="README.md" Pack="true" PackagePath="\" />
+    <None Update="LICENSE" Pack="true" PackagePath="\" />
+    <None Update="docs/**/*.md" Pack="true" PackagePath="docs/%(RecursiveDir)%(Filename)%(Extension)" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="System.Text.Json" Version="8.0.*" />
   </ItemGroup>

package/templates/csharp/domain.hbs

@@ -4,180 +4,98 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Net.Http;
-using System.Text;
-using System.Text.Json;
 using System.Threading;
 using System.Threading.Tasks;
 
-/// <summary>
-/// Provides access to {{name}} API operations.
-/// </summary>
+/// <summary>{{#if description}}{{description}}{{else}}{{interfaceName}} API operations.{{/if}}</summary>
 public class {{interfaceName}}
 {
     private readonly Transport _transport;
 
-    /// <summary>
-    /// Creates a new {{interfaceName}} instance.
-    /// </summary>
     public {{interfaceName}}(Transport transport)
     {
         _transport = transport;
     }
 
 {{#each operations}}
-{{#if isEventStream}}
-    /// <summary>
-    {{#if summary}}
-    /// {{summary}}
-    {{/if}}
-    {{#if description}}
-    /// {{description}}
-    {{/if}}
-    {{#if deprecated}}
-    /// [Obsolete] {{#if deprecationMessage}}{{deprecationMessage}}{{/if}}
-    {{/if}}
-    /// </summary>
 {{#if deprecated}}
-    [Obsolete({{#if deprecationMessage}}"{{deprecationMessage}}"{{/if}})]
-{{/if}}
-    public async IAsyncEnumerable<string> {{pascalCase name}}Async(
-{{#each pathParams}}
-        {{type}}{{#if (not required)}}?{{/if}} {{name}},
-{{/each}}
-{{#if requestBody}}
-        {{requestBody.type}}{{#if (not requestBody.required)}}?{{/if}} body,
+    [Obsolete{{#if deprecationMessage}}("{{deprecationMessage}}"){{/if}}]
 {{/if}}
-{{#if queryType}}
-        {{queryType}}? query = null,
+{{#if isEventStream}}
+    public async IAsyncEnumerable<string> {{methodName}}Async(
+{{#if hasParameters}}
+        {{{signature}}},
 {{/if}}
-        CancellationToken cancellationToken = default)
+        [System.Runtime.CompilerServices.EnumeratorCancellation] CancellationToken cancellationToken = default)
     {
-        var path = $"{{path}}"
+        var path = "{{path}}";
 {{#each pathParams}}
-            .Replace("{{{originalName}}}", Uri.EscapeDataString({{name}}?.ToString() ?? ""))
+        path = path.Replace("{{placeholder}}", Uri.EscapeDataString({{parameterName}}.ToString() ?? ""));
 {{/each}}
-        ;
-
-        var queryParams = new Dictionary<string, string>();
-{{#if queryType}}
-        if (query != null)
+        var queryParams = BuildQuery({{#if hasQuery}}query{{else}}null{{/if}});
+        Dictionary<string, string>? requestHeaders = {{#if hasHeaders}}headers == null ? null : new Dictionary<string, string>(headers){{else}}null{{/if}};
+        var response = await _transport.StreamAsync(new Transport.Request
         {
-            var json = JsonSerializer.Serialize(query);
-            var dict = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(json);
-            if (dict != null)
-            {
-                foreach (var (key, value) in dict)
-                {
-                    if (value.ValueKind != JsonValueKind.Null)
-                        queryParams[key] = value.ToString();
-                }
-            }
-        }
-{{/if}}
-{{#if (hasQueryParams this)}}
-{{#each queryParams}}
-        if ({{name}} != null)
-            queryParams["{{originalName}}"] = {{name}}.ToString();
-{{/each}}
-{{/if}}
-
-        var response = await _transport.StreamAsync(
-            new Transport.Request
-            {
-                Method = HttpMethod.{{httpMethod}},
-                Path = path,
-                Query = queryParams.Count > 0 ? queryParams : null,
+            Method = new HttpMethod("{{httpMethod}}"),
+            Path = path,
+            Query = queryParams,
+            Headers = requestHeaders,
 {{#if requestBody}}
-                Body = body,
-                ContentType = "{{requestBody.contentType}}",
+            Body = body,
+            ContentType = "{{requestBody.contentType}}",
 {{/if}}
-            },
-            cancellationToken);
+        }, cancellationToken);
 
         using var stream = await response.Content.ReadAsStreamAsync(cancellationToken);
         using var reader = new StreamReader(stream);
-
         while (!reader.EndOfStream)
         {
             cancellationToken.ThrowIfCancellationRequested();
             var line = await reader.ReadLineAsync(cancellationToken);
-            if (line == null) break;
-
-            // Forward raw SSE lines
+            if (line is null) yield break;
             yield return line;
         }
     }
 
 {{else}}
-    /// <summary>
-    {{#if summary}}
-    /// {{summary}}
-    {{/if}}
-    {{#if description}}
-    /// {{description}}
-    {{/if}}
-    {{#if deprecated}}
-    /// [Obsolete] {{#if deprecationMessage}}{{deprecationMessage}}{{/if}}
-    {{/if}}
-    /// </summary>
-{{#if deprecated}}
-    [Obsolete({{#if deprecationMessage}}"{{deprecationMessage}}"{{/if}})]
-{{/if}}
-    public async Task<{{#if responseType}}{{responseType}}{{else}}object{{/if}}> {{pascalCase name}}Async(
-{{#each pathParams}}
-        {{type}}{{#if (not required)}}?{{/if}} {{name}},
-{{/each}}
-{{#if requestBody}}
-        {{requestBody.type}}{{#if (not requestBody.required)}}?{{/if}} body,
-{{/if}}
-{{#if queryType}}
-        {{queryType}}? query = null,
+    public async {{#if isVoid}}Task{{else}}Task<{{targetResponseType}}>{{/if}} {{methodName}}Async(
+{{#if hasParameters}}
+        {{{signature}}},
 {{/if}}
         CancellationToken cancellationToken = default)
     {
-        var path = $"{{path}}"
+        var path = "{{path}}";
 {{#each pathParams}}
-            .Replace("{{{originalName}}}", Uri.EscapeDataString({{name}}?.ToString() ?? ""))
+        path = path.Replace("{{placeholder}}", Uri.EscapeDataString({{parameterName}}.ToString() ?? ""));
 {{/each}}
-        ;
-
-        var queryParams = new Dictionary<string, string>();
-{{#if queryType}}
-        if (query != null)
+        var request = new Transport.Request
         {
-            var json = JsonSerializer.Serialize(query);
-            var dict = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(json);
-            if (dict != null)
-            {
-                foreach (var (key, value) in dict)
-                {
-                    if (value.ValueKind != JsonValueKind.Null)
-                        queryParams[key] = value.ToString();
-                }
-            }
-        }
-{{/if}}
-{{#if (hasQueryParams this)}}
-{{#each queryParams}}
-        if ({{name}} != null)
-            queryParams["{{originalName}}"] = {{name}}.ToString();
-{{/each}}
-{{/if}}
-
-        return await _transport.ExecuteAsync<{{#if responseType}}{{responseType}}{{else}}object{{/if}}>(
-            new Transport.Request
-            {
-                Method = HttpMethod.{{httpMethod}},
-                Path = path,
-                Query = queryParams.Count > 0 ? queryParams : null,
+            Method = new HttpMethod("{{httpMethod}}"),
+            Path = path,
+            Query = BuildQuery({{#if hasQuery}}query{{else}}null{{/if}}),
+            Headers = {{#if hasHeaders}}headers == null ? null : new Dictionary<string, string>(headers){{else}}null{{/if}},
 {{#if requestBody}}
-                Body = body,
-                ContentType = "{{requestBody.contentType}}",
+            Body = body,
+            ContentType = "{{requestBody.contentType}}",
+{{/if}}
+        };
+{{#if isVoid}}
+        await _transport.ExecuteRawAsync(request, cancellationToken);
+{{else}}
+        return await _transport.ExecuteAsync<{{targetResponseType}}>(request, cancellationToken);
 {{/if}}
-            },
-            cancellationToken);
     }
 
 {{/if}}
 {{/each}}
+    private static Dictionary<string, string>? BuildQuery(IReadOnlyDictionary<string, object?>? query)
+    {
+        if (query is null || query.Count == 0) return null;
+        var result = new Dictionary<string, string>();
+        foreach (var (key, value) in query)
+        {
+            if (value is not null) result[key] = value.ToString() ?? "";
+        }
+        return result.Count == 0 ? null : result;
+    }
 }