@apollo-deploy/tesseract 1.9.0 → 2.1.0

package/dist/cli.js

@@ -2,19 +2,19 @@
 /**
  * Tesseract CLI — manifest-first SDK generator (refactored, scalable).
  */
-import { Command } from "commander";
-import { readFileSync } from "node:fs";
-import { resolve, join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-import { generate } from "./index.js";
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { resolve, join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import { generate } from './index.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 /**
  * Package metadata loader (isolated for testability + reuse)
  */
 function loadPackageVersion() {
-    const pkgPath = join(__dirname, "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
     return pkg.version;
 }
 /**
@@ -24,9 +24,10 @@ function buildConfig(opts) {
     return {
         input: resolve(opts.input),
         output: resolve(opts.output),
-        language: opts.language ?? "typescript",
+        language: opts.language ?? 'typescript',
         packageName: opts.name,
         packageVersion: opts.packageVersion,
+        versionBump: opts.versionBump,
         npmToken: opts.npmToken,
         clientName: opts.clientName,
         baseUrl: opts.baseUrl,
@@ -42,12 +43,12 @@ function buildConfig(opts) {
 function printWarnings(warnings) {
     if (!warnings.length)
         return;
-    console.warn("\nWarnings:");
+    console.warn('\nWarnings:');
     for (const w of warnings) {
         console.warn(`  ⚠ ${w}`);
     }
 }
-function printFileList(files, prefix = "  - ") {
+function printFileList(files, prefix = '  - ') {
     for (const file of files) {
         console.log(`${prefix}${file}`);
     }
@@ -58,7 +59,7 @@ function printFileList(files, prefix = "  - ") {
 function handleResult(opts, result) {
     printWarnings(result.warnings);
     switch (result.mode) {
-        case "check":
+        case 'check':
             if (result.hasChanges) {
                 console.error(`\n✗ Generated output is out of date: ${result.filesWritten} files would change`);
                 printFileList(result.changedFiles);
@@ -66,7 +67,7 @@ function handleResult(opts, result) {
             }
             console.log(`\n✓ Generated output is up to date → ${opts.output}`);
             return;
-        case "dry-run":
+        case 'dry-run':
             console.log(`\n✓ Dry run complete: ${result.filesWritten} files would change → ${opts.output}`);
             if (result.changedFiles.length) {
                 printFileList(result.changedFiles);
@@ -74,12 +75,18 @@ function handleResult(opts, result) {
             if (result.filesSkipped > 0) {
                 console.log(`  ${result.filesSkipped} files unchanged`);
             }
+            if (result.filesDeleted > 0) {
+                console.log(`  ${result.filesDeleted} stale files would be removed`);
+            }
             return;
         default:
             console.log(`\n✓ Generated ${result.filesWritten} files → ${opts.output}`);
             if (result.filesSkipped > 0) {
                 console.log(`  ${result.filesSkipped} files unchanged (skipped)`);
             }
+            if (result.filesDeleted > 0) {
+                console.log(`  ${result.filesDeleted} stale files removed`);
+            }
     }
 }
 /**
@@ -87,7 +94,12 @@ function handleResult(opts, result) {
  */
 function validateFlags(opts) {
     if (opts.dryRun && opts.check) {
-        console.error("\n✗ --dry-run and --check are mutually exclusive");
+        console.error('\n✗ --dry-run and --check are mutually exclusive');
+        process.exit(1);
+    }
+    if (opts.versionBump &&
+        !['patch', 'minor', 'major'].includes(opts.versionBump)) {
+        console.error('\n✗ --version-bump must be patch, minor, or major');
         process.exit(1);
     }
 }
@@ -113,8 +125,8 @@ async function handleGenerate(opts) {
 function handleRun(appPath) {
     const resolved = resolve(appPath);
     const result = spawnSync(process.execPath, [resolved], {
-        env: { ...process.env, TESSERACT_GENERATE: "1" },
-        stdio: "inherit",
+        env: { ...process.env, TESSERACT_GENERATE: '1' },
+        stdio: 'inherit',
     });
     process.exit(result.status ?? 0);
 }
@@ -125,32 +137,33 @@ function createCLI() {
     const program = new Command();
     const version = loadPackageVersion();
     program
-        .name("tesseract")
-        .description("Manifest-first SDK generator — turns sdk-manifold/v1 manifests into production-ready TypeScript SDKs")
+        .name('tesseract')
+        .description('Manifest-first SDK generator — turns sdk-manifold/v1 manifests into production-ready TypeScript SDKs')
         .version(version);
     program
-        .command("generate")
-        .description("Generate an SDK from an sdk-manifold/v1 manifest file")
-        .requiredOption("-i, --input <path>", "Path to the sdk-manifold/v1 manifest JSON file")
-        .requiredOption("-o, --output <dir>", "Output directory for the generated SDK")
-        .option("-l, --language <lang>", "Target language: typescript, python, ruby, php, go, rust, kotlin, csharp")
-        .option("-n, --name <name>", "Override the SDK package name")
-        .option("--package-version <version>", "Override the generated package version")
-        .option("--client-name <name>", "Override the client class name")
-        .option("--base-url <url>", "Override the base URL")
-        .option("--dry-run", "Preview output without writing files")
-        .option("--check", "Exit non-zero if generated output is out of date")
-        .option("--sdk-style <style>", 'SDK style: functional (default) or class (Resend-style: new MySDK("key"))')
-        .option("--client-type <type>", "Client type: internal (full options, default) or public (auth key only, baseUrl baked in)")
-        .option("--npm-token <token>", "NPM auth token for resolving private package versions (defaults to NPM_TOKEN env var)")
+        .command('generate')
+        .description('Generate an SDK from an sdk-manifold/v1 manifest file')
+        .requiredOption('-i, --input <path>', 'Path to the sdk-manifold/v1 manifest JSON file')
+        .requiredOption('-o, --output <dir>', 'Output directory for the generated SDK')
+        .option('-l, --language <lang>', 'Target language: typescript, python, ruby, php, go, rust, kotlin, csharp')
+        .option('-n, --name <name>', 'Override the SDK package name')
+        .option('--package-version <version>', 'Override the generated package version')
+        .option('--version-bump <type>', 'Version bump when package version is resolved: patch, minor, or major')
+        .option('--client-name <name>', 'Override the client class name')
+        .option('--base-url <url>', 'Override the base URL')
+        .option('--dry-run', 'Preview output without writing files')
+        .option('--check', 'Exit non-zero if generated output is out of date')
+        .option('--sdk-style <style>', 'SDK style: functional (default) or class (Resend-style: new MySDK("key"))')
+        .option('--client-type <type>', 'Client type: internal (full options, default) or public (auth key only, baseUrl baked in)')
+        .option('--npm-token <token>', 'NPM auth token for resolving private package versions (defaults to NPM_TOKEN env var)')
         .action(handleGenerate);
     program
-        .command("run")
+        .command('run')
         .description([
-        "Boot an instrumented Fastify app with TESSERACT_GENERATE=1 to collect routes and generate an SDK.",
-        "The app must register `tesseractPlugin` from `@apollo-deploy/tesseract/fastify`.",
-    ].join("\n"))
-        .argument("<app>", "Path to the compiled app entry-point (e.g. dist/app.js)")
+        'Boot an instrumented Fastify app with TESSERACT_GENERATE=1 to collect routes and generate an SDK.',
+        'The app must register `tesseractPlugin` from `@apollo-deploy/tesseract/fastify`.',
+    ].join('\n'))
+        .argument('<app>', 'Path to the compiled app entry-point (e.g. dist/app.js)')
         .action(handleRun);
     return program;
 }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/collector.d.ts

@@ -28,7 +28,19 @@
  */
 import type { BackendManifest, ManifestRouteSchema } from './types/manifest.js';
 import type { SDKModuleConfig, SDKRouteConfig } from './types/sdk-module.js';
-import type { TargetLanguage } from './types/ir.js';
+import type { TargetLanguage, VersionBump } from './types/ir.js';
+export type SchemaConversionMode = 'input' | 'output';
+export interface SchemaOverrideContext {
+    zodSchema: unknown;
+    jsonSchema: Record<string, unknown>;
+    path: Array<string | number>;
+}
+export interface SchemaConversionOptions {
+    io?: SchemaConversionMode;
+    unrepresentable?: 'throw' | 'any';
+    override?: (context: SchemaOverrideContext) => void;
+}
+export type SchemaConverter = (schema: unknown, options?: SchemaConversionOptions) => unknown;
 /**
  * Minimal interface for Zod v4's global registry — only what Tesseract needs.
  * Declared here so adapters don't need a hard dependency on `zod`.
@@ -74,7 +86,7 @@ export interface CollectorOptions {
      * new SDKCollector({ ..., schemaConverter: toJSONSchema });
      * ```
      */
-    schemaConverter?: (schema: unknown) => unknown;
+    schemaConverter?: SchemaConverter;
     /**
      * Zod v4 global registry — controls how registered schemas are resolved
      * when `schemaConverter` is set.
@@ -96,6 +108,8 @@ export interface CollectorOptions {
     packageName?: string;
     /** Override the generated package version. */
     packageVersion?: string;
+    /** Version increment used when packageVersion is omitted. */
+    versionBump?: VersionBump;
     /**
      * Target SDK language for the primary output. Defaults to `'typescript'`.
      * Use `additionalTargets` to emit multiple languages simultaneously.
@@ -124,6 +138,7 @@ export interface CollectorOptions {
         output: string;
         packageName?: string;
         packageVersion?: string;
+        versionBump?: VersionBump;
         clientType?: 'internal' | 'public';
         sdkStyle?: 'functional' | 'class';
         /**
@@ -134,12 +149,17 @@ export interface CollectorOptions {
          * from a shared TypeScript package but an additional target (e.g. Kotlin)
          * needs self-contained inline types.
          *
-         * Omit to inherit the primary `schemaPackage`.
+         * Non-TypeScript targets default to expanding types inline (as if
+         * `schemaPackage: null`) when this field is omitted, since they cannot
+         * import a TypeScript schema package.
+         *
+         * Omit on a TypeScript additional target to inherit the primary `schemaPackage`.
          *
          * @example
          * ```ts
          * additionalTargets: [
-         *   { language: 'kotlin', output: './sdk/java', schemaPackage: null },
+         *   { language: 'kotlin', output: './sdk/java' }, // auto-expands types
+         *   { language: 'kotlin', output: './sdk/java', schemaPackage: null }, // explicit
          * ]
          * ```
          */
@@ -190,6 +210,8 @@ export declare class SDKCollector {
      * @param config - Schema and SDK options for this route.
      */
     route(url: string, method: string, config: CollectorRouteConfig): this;
+    /** Number of routes currently registered. */
+    get routeCount(): number;
     /** Build and return the `BackendManifest` from all accumulated routes and domains. */
     buildManifest(): BackendManifest;
     /** Generate the SDK from accumulated routes and domains. */
@@ -222,17 +244,20 @@ export declare function liftRegisteredRefs(schema: unknown, registeredIds: Set<s
  * - No registry — calls `toJSONSchema` directly; nested `$defs` are extracted by
  *   `buildManifestFromRoutes`.
  */
-export declare function convertSchemaValue(value: unknown, toJSONSchema: (s: unknown) => unknown, zodRegistry?: ZodGlobalRegistry, isExternalTarget?: boolean): unknown;
+export declare function convertSchemaValue(value: unknown, toJSONSchema: SchemaConverter, zodRegistry?: ZodGlobalRegistry, isExternalTarget?: boolean, mode?: SchemaConversionMode): unknown;
 /**
  * Convert all schema fields on a single route schema, applying the correct
  * Zod→JSON Schema conversion strategy for the target.
  */
-export declare function convertRouteSchema(schema: ManifestRouteSchema | undefined, toJSONSchema: (s: unknown) => unknown, zodRegistry?: ZodGlobalRegistry, isExternalTarget?: boolean): ManifestRouteSchema | undefined;
+export declare function convertRouteSchema(schema: ManifestRouteSchema | undefined, toJSONSchema: SchemaConverter, zodRegistry?: ZodGlobalRegistry, isExternalTarget?: boolean, route?: {
+    method?: string;
+    url?: string;
+}): ManifestRouteSchema | undefined;
 /**
  * Resolve the `toJSONSchema` converter: use the explicit one if provided,
  * otherwise attempt auto-detection from the host app's `zod` package.
  */
-export declare function resolveSchemaConverter(explicit?: (s: unknown) => unknown): Promise<((s: unknown) => unknown) | undefined>;
+export declare function resolveSchemaConverter(explicit?: SchemaConverter): Promise<SchemaConverter | undefined>;
 /**
  * Builds a `BackendManifest` from a flat list of collected routes and a domain
  * registry. Exported so framework adapters (including the Fastify plugin) can

package/dist/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAiB,mBAAmB,EAAc,MAAM,qBAAqB,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAClD,2DAA2D;IAC3D,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC/C;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAClC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;QACnC,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;QAClC;;;;;;;;;;;;;;;;WAgBG;QACH,aAAa,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;KAC1D,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,2CAA2C;IAC3C,GAAG,EAAE,cAAc,CAAC;IACpB,wDAAwD;IACxD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,CAAM;IACjD,SAAS,CAAC,QAAQ,CAAC,SAAS,+BAAsC;IAClE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBAE9B,IAAI,EAAE,gBAAgB;IAIlC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,IAAI;IAKtE;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAYtE,sFAAsF;IACtF,aAAa,IAAI,eAAe;IAIhC,4DAA4D;IACtD,QAAQ,IAAI,OAAO,CAAC,OAAO,YAAY,EAAE,cAAc,CAAC;IAiE9D;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAUtC;AASD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,OAAO,CAyBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,EACrC,WAAW,CAAC,EAAE,iBAAiB,EAC/B,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CA0BT;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,EACrC,WAAW,CAAC,EAAE,iBAAiB,EAC/B,gBAAgB,CAAC,EAAE,OAAO,GACzB,mBAAmB,GAAG,SAAS,CAiBjC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACjC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAUhD;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC,EACF,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,aAAa,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,GAChD,eAAe,CAwCjB"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"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"}

package/dist/collector.js

@@ -47,7 +47,11 @@ export class SDKCollector {
      * @param config - Optional domain metadata — name override, description, stability.
      */
     domain(prefix, config) {
-        this._registry.set(prefix, { prefix, ...config });
+        const normalizedPrefix = normalizePath(prefix);
+        this._registry.set(normalizedPrefix, {
+            prefix: normalizedPrefix,
+            ...config,
+        });
         return this;
     }
     /**
@@ -63,7 +67,7 @@ export class SDKCollector {
         if (config.sdk?.exclude)
             return this;
         this._routes.push({
-            url,
+            url: normalizePath(url),
             method: method.toUpperCase(),
             schema: config.schema,
             sdk: config.sdk,
@@ -71,6 +75,10 @@ export class SDKCollector {
         });
         return this;
     }
+    /** Number of routes currently registered. */
+    get routeCount() {
+        return this._routes.length;
+    }
     /** Build and return the `BackendManifest` from all accumulated routes and domains. */
     buildManifest() {
         return buildManifestFromRoutes(this._routes, this._registry, this.opts.info, this.opts.schemaPackage);
@@ -89,10 +97,13 @@ export class SDKCollector {
                 return buildManifestFromRoutes(this._routes, this._registry, this.opts.info, schemaPackage);
             }
             const isExternal = !!schemaPackage;
-            const registry = schemaPackage ? this.opts.zodGlobalRegistry : undefined;
+            // Always pass the registry when available so non-external targets can
+            // expand registered schemas into `$defs` (named local models). External
+            // targets use the same registry to emit bare `$ref` import stubs.
+            const registry = this.opts.zodGlobalRegistry;
             const converted = this._routes.map((r) => ({
                 ...r,
-                schema: convertRouteSchema(r.schema, toJSONSchema, registry, isExternal),
+                schema: convertRouteSchema(r.schema, toJSONSchema, registry, isExternal, { method: r.method, url: r.url }),
             }));
             return buildManifestFromRoutes(converted, this._registry, this.opts.info, schemaPackage);
         };
@@ -104,14 +115,21 @@ export class SDKCollector {
             clientType: this.opts.clientType,
             packageName: this.opts.packageName,
             packageVersion: this.opts.packageVersion,
+            versionBump: this.opts.versionBump,
             sdkStyle: this.opts.sdkStyle,
         });
         for (const target of this.opts.additionalTargets ?? []) {
             const hasSchemaPackageOverride = Object.prototype.hasOwnProperty.call(target, 'schemaPackage');
+            // Non-TypeScript targets cannot import a TS schema package — expand
+            // registered types into local definitions unless explicitly overridden.
+            const inheritsSchemaPackage = !hasSchemaPackageOverride && target.language !== 'typescript';
             const targetSchemaPackage = hasSchemaPackageOverride
                 ? (target.schemaPackage ?? undefined)
-                : this.opts.schemaPackage;
-            const targetManifest = hasSchemaPackageOverride || targetSchemaPackage !== this.opts.schemaPackage
+                : inheritsSchemaPackage
+                    ? undefined
+                    : this.opts.schemaPackage;
+            const targetManifest = hasSchemaPackageOverride ||
+                targetSchemaPackage !== this.opts.schemaPackage
                 ? buildManifestFor(targetSchemaPackage)
                 : primaryManifest;
             const extra = await generate({
@@ -121,10 +139,13 @@ export class SDKCollector {
                 clientType: target.clientType ?? this.opts.clientType,
                 packageName: target.packageName ?? this.opts.packageName,
                 packageVersion: target.packageVersion ?? this.opts.packageVersion,
+                versionBump: target.versionBump ?? this.opts.versionBump,
                 sdkStyle: target.sdkStyle ?? this.opts.sdkStyle,
             });
             primary.filesWritten += extra.filesWritten;
             primary.filesSkipped += extra.filesSkipped;
+            primary.filesDeleted += extra.filesDeleted;
+            primary.hasChanges ||= extra.hasChanges;
             primary.warnings.push(...extra.warnings);
             primary.changedFiles.push(...extra.changedFiles);
         }
@@ -149,7 +170,10 @@ export class SDKCollector {
             for (const w of result.warnings)
                 console.warn(`  ⚠  ${w}`);
         }
-        const targets = [this.opts.output, ...(this.opts.additionalTargets ?? []).map((t) => t.output)];
+        const targets = [
+            this.opts.output,
+            ...(this.opts.additionalTargets ?? []).map((t) => t.output),
+        ];
         console.log(`[tesseract] ✓ ${result.filesWritten} files written → ${targets.join(', ')}`);
         return true;
     }
@@ -159,6 +183,61 @@ export class SDKCollector {
 function isZodSchema(value) {
     return !!value && typeof value === 'object' && '_zod' in value;
 }
+function getSchemaId(schema, registry) {
+    const registeredId = registry?.get(schema)?.id;
+    if (registeredId)
+        return registeredId;
+    if (!schema || typeof schema !== 'object')
+        return undefined;
+    const meta = schema.meta;
+    if (typeof meta !== 'function')
+        return undefined;
+    const id = meta.call(schema)?.id;
+    return typeof id === 'string' && id.length > 0 ? id : undefined;
+}
+const NON_JSON_ZOD_TYPES = new Set([
+    'bigint',
+    'symbol',
+    'undefined',
+    'void',
+    'nan',
+    'custom',
+    'function',
+    'map',
+    'set',
+]);
+function getZodType(schema) {
+    if (!schema || typeof schema !== 'object')
+        return undefined;
+    const def = schema._zod?.def;
+    return typeof def?.type === 'string' ? def.type : undefined;
+}
+/**
+ * Convert a Zod schema while preserving JSON transport semantics.
+ *
+ * JavaScript `Date` values are serialized over HTTP as ISO-8601 strings, so
+ * they are represented as JSON Schema `string` / `date-time`. Other values
+ * that JSON cannot carry (BigInt, Function, Map, Set, etc.) still fail.
+ */
+function convertZodSchema(schema, converter, mode) {
+    return converter(schema, {
+        io: mode,
+        unrepresentable: 'any',
+        override: ({ zodSchema, jsonSchema }) => {
+            const type = getZodType(zodSchema);
+            if (type === 'date') {
+                for (const key of Object.keys(jsonSchema))
+                    delete jsonSchema[key];
+                jsonSchema.type = 'string';
+                jsonSchema.format = 'date-time';
+                return;
+            }
+            if (type && NON_JSON_ZOD_TYPES.has(type)) {
+                throw new Error(`${type[0].toUpperCase()}${type.slice(1)} cannot be represented in JSON Schema`);
+            }
+        },
+    });
+}
 /**
  * Post-process a JSON Schema produced by `toJSONSchema` so that any `$defs`
  * entry whose key matches a registered global id is lifted to a bare `$ref`.
@@ -203,62 +282,70 @@ export function liftRegisteredRefs(schema, registeredIds) {
  * - No registry — calls `toJSONSchema` directly; nested `$defs` are extracted by
  *   `buildManifestFromRoutes`.
  */
-export function convertSchemaValue(value, toJSONSchema, zodRegistry, isExternalTarget) {
+export function convertSchemaValue(value, toJSONSchema, zodRegistry, isExternalTarget, mode = 'output') {
     if (isZodSchema(value)) {
-        if (zodRegistry) {
-            const entry = zodRegistry.get(value);
-            if (entry?.id) {
-                if (isExternalTarget) {
-                    return { $ref: entry.id };
-                }
-                try {
-                    const expanded = toJSONSchema(value);
-                    return { $defs: { [entry.id]: expanded }, $ref: `#/$defs/${entry.id}` };
-                }
-                catch {
-                    return { $ref: entry.id };
-                }
-            }
-        }
-        try {
-            const jsonSchema = toJSONSchema(value);
-            if (zodRegistry?._idmap && jsonSchema && typeof jsonSchema === 'object') {
-                const registeredIds = new Set(zodRegistry._idmap.keys());
-                return liftRegisteredRefs(jsonSchema, registeredIds);
-            }
-            return jsonSchema;
+        const schemaId = getSchemaId(value, zodRegistry);
+        if (schemaId) {
+            if (isExternalTarget)
+                return { $ref: schemaId };
+            const expanded = convertZodSchema(value, toJSONSchema, mode);
+            return { $defs: { [schemaId]: expanded }, $ref: `#/$defs/${schemaId}` };
         }
-        catch {
-            return value;
+        const jsonSchema = convertZodSchema(value, toJSONSchema, mode);
+        // Only lift registered `$defs` → bare `$ref` for external (schemaPackage)
+        // targets. Inline targets must keep `$defs` so they become local models.
+        if (isExternalTarget &&
+            zodRegistry?._idmap &&
+            jsonSchema &&
+            typeof jsonSchema === 'object') {
+            const registeredIds = new Set(zodRegistry._idmap.keys());
+            return liftRegisteredRefs(jsonSchema, registeredIds);
         }
+        return jsonSchema;
     }
     return value;
 }
 // Schema fields eligible for registry-based $ref replacement.
 // headers are always expanded inline since they're rarely top-level registered schemas.
-const REGISTRY_ELIGIBLE_FIELDS = new Set(['body', 'querystring', 'query', 'params']);
+const REGISTRY_ELIGIBLE_FIELDS = new Set([
+    'body',
+    'querystring',
+    'query',
+    'params',
+]);
 /**
  * Convert all schema fields on a single route schema, applying the correct
  * Zod→JSON Schema conversion strategy for the target.
  */
-export function convertRouteSchema(schema, toJSONSchema, zodRegistry, isExternalTarget) {
+export function convertRouteSchema(schema, toJSONSchema, zodRegistry, isExternalTarget, route) {
     if (!schema)
         return schema;
     const result = {};
+    const routeLabel = [route?.method, route?.url].filter(Boolean).join(' ');
+    const convert = (value, field, mode, useRegistry = false) => {
+        try {
+            return convertSchemaValue(value, toJSONSchema, useRegistry ? zodRegistry : undefined, useRegistry ? isExternalTarget : false, mode);
+        }
+        catch (error) {
+            const location = routeLabel ? ` for ${routeLabel}` : '';
+            const message = error instanceof Error ? error.message : String(error);
+            const hint = mode === 'output'
+                ? ' Response transforms must end in a JSON-schema-representable output schema.'
+                : '';
+            throw new Error(`Failed to convert ${field} schema${location}: ${message}.${hint}`, { cause: error });
+        }
+    };
     for (const [key, val] of Object.entries(schema)) {
         if (key === 'response' && val && typeof val === 'object') {
             const serialized = {};
             for (const [status, responseSchema] of Object.entries(val)) {
-                serialized[status] = convertSchemaValue(responseSchema, toJSONSchema, zodRegistry, isExternalTarget);
+                serialized[status] = convert(responseSchema, `response ${status}`, 'output', true);
             }
             result[key] = serialized;
+            continue;
         }
-        else if (REGISTRY_ELIGIBLE_FIELDS.has(key)) {
-            result[key] = convertSchemaValue(val, toJSONSchema, zodRegistry, isExternalTarget);
-        }
-        else {
-            result[key] = convertSchemaValue(val, toJSONSchema);
-        }
+        const isRequestSchema = REGISTRY_ELIGIBLE_FIELDS.has(key) || key === 'headers';
+        result[key] = convert(val, key, isRequestSchema ? 'input' : 'output', REGISTRY_ELIGIBLE_FIELDS.has(key));
     }
     return result;
 }
@@ -271,7 +358,7 @@ export async function resolveSchemaConverter(explicit) {
         return explicit;
     try {
         const zodPkg = 'zod';
-        const zodModule = await import(zodPkg);
+        const zodModule = (await import(zodPkg));
         const converter = zodModule.toJSONSchema;
         return typeof converter === 'function' ? converter : undefined;
     }
@@ -290,15 +377,15 @@ export function buildManifestFromRoutes(routes, registry, info, schemaPackage) {
     const sortedPrefixes = [...registry.keys()].sort((a, b) => b.length - a.length);
     const domainMap = new Map();
     for (const route of routes) {
-        const matchedPrefix = sortedPrefixes.find((p) => route.url === p || route.url.startsWith(p + '/')) ??
-            derivePrefix(route.url);
+        const url = normalizePath(route.url);
+        const matchedPrefix = sortedPrefixes.find((prefix) => prefix === '/' || url === prefix || url.startsWith(`${prefix}/`)) ?? derivePrefix(url);
         if (!domainMap.has(matchedPrefix)) {
             domainMap.set(matchedPrefix, {
                 config: registry.get(matchedPrefix) ?? { prefix: matchedPrefix },
                 routes: [],
             });
         }
-        const tail = route.url.substring(matchedPrefix.length) || '/';
+        const tail = url.substring(matchedPrefix === '/' ? 0 : matchedPrefix.length) || '/';
         domainMap.get(matchedPrefix).routes.push({
             method: route.method,
             url: tail.startsWith('/') ? tail : '/' + tail,
@@ -316,14 +403,25 @@ export function buildManifestFromRoutes(routes, registry, info, schemaPackage) {
             baseUrl: info.baseUrl,
         },
         ...(schemaPackage && { schemaPackage }),
-        domains: [...domainMap.values()].map(({ config, routes }) => ({ ...config, routes })),
+        domains: [...domainMap.values()].map(({ config, routes }) => ({
+            ...config,
+            routes,
+        })),
         ...buildDefinitionsFromDefs(routes),
     };
 }
 /** Derives a domain prefix from the first non-parameter URL segment. */
 function derivePrefix(url) {
-    const first = url.split('/').find((s) => s.length > 0 && !s.startsWith(':'));
-    return first ? '/' + first : '/';
+    const first = url
+        .split('/')
+        .find((segment) => segment && !segment.startsWith(':'));
+    return first ? `/${first}` : '/';
+}
+function normalizePath(value) {
+    const path = value.trim();
+    if (!path || path === '/')
+        return '/';
+    return `/${path.replace(/^\/+|\/+$/g, '')}`;
 }
 // ── $defs extraction ──────────────────────────────────────────────────────────
 /**
@@ -365,7 +463,9 @@ function buildDefinitionsFromDefs(routes) {
 function collectDefs(schema, out) {
     if (!schema || typeof schema !== 'object')
         return;
-    if (schema.$defs && typeof schema.$defs === 'object' && !Array.isArray(schema.$defs)) {
+    if (schema.$defs &&
+        typeof schema.$defs === 'object' &&
+        !Array.isArray(schema.$defs)) {
         for (const [key, val] of Object.entries(schema.$defs)) {
             if (!(key in out))
                 out[key] = val;