@apollo-deploy/tesseract 1.8.0 → 2.0.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,18 @@
  */
 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';
+/**
+ * Minimal interface for Zod v4's global registry — only what Tesseract needs.
+ * Declared here so adapters don't need a hard dependency on `zod`.
+ */
+export interface ZodGlobalRegistry {
+    get(schema: unknown): {
+        id?: string;
+    } | undefined;
+    /** Internal id→schema map present in Zod v4 registries. */
+    _idmap?: Map<string, unknown>;
+}
 export interface CollectorOptions {
     /** API metadata written into the generated package.json and README. */
     info: {
@@ -50,6 +61,33 @@ export interface CollectorOptions {
         version?: string;
         importPath?: string;
     };
+    /**
+     * Function to convert framework-specific schema objects (e.g. raw Zod schemas)
+     * to JSON Schema at generation time.
+     *
+     * Required when using `fastify-type-provider-zod` or passing raw Zod schemas
+     * directly to route/collector configs. Pass `toJSONSchema` from `zod` v4.
+     *
+     * @example
+     * ```ts
+     * import { toJSONSchema } from 'zod';
+     * new SDKCollector({ ..., schemaConverter: toJSONSchema });
+     * ```
+     */
+    schemaConverter?: (schema: unknown) => unknown;
+    /**
+     * Zod v4 global registry — controls how registered schemas are resolved
+     * when `schemaConverter` is set.
+     *
+     * - With `schemaPackage`: registered schemas emit a bare `$ref: 'Id'` so
+     *   intake creates external import stubs.
+     * - Without `schemaPackage` (or when a target sets `schemaPackage: null`):
+     *   registered schemas are expanded and wrapped in `$defs` so intake
+     *   generates named data classes (e.g. Kotlin `data class`).
+     *
+     * Pass `z.globalRegistry` from your app.
+     */
+    zodGlobalRegistry?: ZodGlobalRegistry;
     /** `'functional'` (default) or `'class'` (Resend-style `new MySDK('key')`). */
     sdkStyle?: 'functional' | 'class';
     /** `'internal'` (default) or `'public'` (auth key only, baseUrl baked in). */
@@ -58,6 +96,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.
@@ -86,6 +126,7 @@ export interface CollectorOptions {
         output: string;
         packageName?: string;
         packageVersion?: string;
+        versionBump?: VersionBump;
         clientType?: 'internal' | 'public';
         sdkStyle?: 'functional' | 'class';
         /**
@@ -96,12 +137,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
          * ]
          * ```
          */
@@ -152,6 +198,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. */
@@ -169,6 +217,32 @@ export declare class SDKCollector {
      */
     tryGenerate(): Promise<boolean>;
 }
+/**
+ * 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`.
+ * Used in the external-target path so intake treats them as import stubs.
+ */
+export declare function liftRegisteredRefs(schema: unknown, registeredIds: Set<string>): unknown;
+/**
+ * Convert a single raw schema value to JSON Schema.
+ *
+ * - `isExternalTarget: true`  — registered schema → bare `$ref: 'Id'` (external import stub)
+ * - `isExternalTarget: false` — registered schema → `{ $defs: { Id: <expanded> }, $ref: '#/$defs/Id' }`
+ *   so `buildManifestFromRoutes` can extract it as a named local definition.
+ * - 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;
+/**
+ * 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;
+/**
+ * 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>;
 /**
  * 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":"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"}
+{"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);
@@ -78,24 +86,52 @@ export class SDKCollector {
     /** Generate the SDK from accumulated routes and domains. */
     async generate() {
         const { generate } = await import('./index.js');
-        const manifest = this.buildManifest();
+        const toJSONSchema = await resolveSchemaConverter(this.opts.schemaConverter);
+        /**
+         * Build a manifest for a specific schemaPackage context.
+         * When `toJSONSchema` is available, routes are re-converted with the
+         * correct `isExternalTarget` flag before the manifest is built.
+         */
+        const buildManifestFor = (schemaPackage) => {
+            if (!toJSONSchema) {
+                return buildManifestFromRoutes(this._routes, this._registry, this.opts.info, schemaPackage);
+            }
+            const isExternal = !!schemaPackage;
+            // 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),
+            }));
+            return buildManifestFromRoutes(converted, this._registry, this.opts.info, schemaPackage);
+        };
+        const primaryManifest = buildManifestFor(this.opts.schemaPackage);
         const primary = await generate({
-            manifest,
+            manifest: primaryManifest,
             output: this.opts.output,
             language: this.opts.language,
             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 ?? []) {
-            // If the target overrides schemaPackage (including null to disable it),
-            // rebuild the manifest with the target-specific schemaPackage so that
-            // intake resolves types correctly for this language.
             const hasSchemaPackageOverride = Object.prototype.hasOwnProperty.call(target, 'schemaPackage');
-            const targetManifest = hasSchemaPackageOverride
-                ? buildManifestFromRoutes(this._routes, this._registry, this.opts.info, target.schemaPackage ?? undefined)
-                : manifest;
+            // 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)
+                : inheritsSchemaPackage
+                    ? undefined
+                    : this.opts.schemaPackage;
+            const targetManifest = hasSchemaPackageOverride ||
+                targetSchemaPackage !== this.opts.schemaPackage
+                ? buildManifestFor(targetSchemaPackage)
+                : primaryManifest;
             const extra = await generate({
                 manifest: targetManifest,
                 output: target.output,
@@ -103,12 +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,
             });
-            // Merge warnings and counts back into the primary result so callers
-            // get a single aggregated result regardless of target count.
             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);
         }
@@ -133,11 +170,139 @@ 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;
     }
 }
+// ── Zod schema conversion ─────────────────────────────────────────────────────
+/** Returns true when `value` is a Zod v4 schema instance. */
+function isZodSchema(value) {
+    return !!value && typeof value === 'object' && '_zod' in value;
+}
+/**
+ * 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`.
+ * Used in the external-target path so intake treats them as import stubs.
+ */
+export function liftRegisteredRefs(schema, registeredIds) {
+    if (!schema || typeof schema !== 'object')
+        return schema;
+    if (Array.isArray(schema)) {
+        return schema.map((item) => liftRegisteredRefs(item, registeredIds));
+    }
+    const s = schema;
+    if (typeof s.$ref === 'string' && s.$ref.startsWith('#/$defs/')) {
+        const id = s.$ref.slice('#/$defs/'.length);
+        if (registeredIds.has(id))
+            return { $ref: id };
+    }
+    const result = {};
+    for (const [key, val] of Object.entries(s)) {
+        if (key === '$defs')
+            continue;
+        result[key] = liftRegisteredRefs(val, registeredIds);
+    }
+    if (s.$defs && typeof s.$defs === 'object' && !Array.isArray(s.$defs)) {
+        const remainingDefs = {};
+        for (const [defKey, defVal] of Object.entries(s.$defs)) {
+            if (!registeredIds.has(defKey)) {
+                remainingDefs[defKey] = liftRegisteredRefs(defVal, registeredIds);
+            }
+        }
+        if (Object.keys(remainingDefs).length > 0)
+            result.$defs = remainingDefs;
+    }
+    return result;
+}
+/**
+ * Convert a single raw schema value to JSON Schema.
+ *
+ * - `isExternalTarget: true`  — registered schema → bare `$ref: 'Id'` (external import stub)
+ * - `isExternalTarget: false` — registered schema → `{ $defs: { Id: <expanded> }, $ref: '#/$defs/Id' }`
+ *   so `buildManifestFromRoutes` can extract it as a named local definition.
+ * - No registry — calls `toJSONSchema` directly; nested `$defs` are extracted by
+ *   `buildManifestFromRoutes`.
+ */
+export function convertSchemaValue(value, toJSONSchema, zodRegistry, isExternalTarget) {
+    if (isZodSchema(value)) {
+        if (zodRegistry) {
+            const entry = zodRegistry.get(value);
+            if (entry?.id) {
+                if (isExternalTarget) {
+                    return { $ref: entry.id };
+                }
+                const expanded = toJSONSchema(value);
+                return { $defs: { [entry.id]: expanded }, $ref: `#/$defs/${entry.id}` };
+            }
+        }
+        const jsonSchema = toJSONSchema(value);
+        // 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',
+]);
+/**
+ * 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) {
+    if (!schema)
+        return schema;
+    const result = {};
+    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);
+            }
+            result[key] = serialized;
+        }
+        else if (REGISTRY_ELIGIBLE_FIELDS.has(key)) {
+            result[key] = convertSchemaValue(val, toJSONSchema, zodRegistry, isExternalTarget);
+        }
+        else {
+            result[key] = convertSchemaValue(val, toJSONSchema);
+        }
+    }
+    return result;
+}
+/**
+ * Resolve the `toJSONSchema` converter: use the explicit one if provided,
+ * otherwise attempt auto-detection from the host app's `zod` package.
+ */
+export async function resolveSchemaConverter(explicit) {
+    if (typeof explicit === 'function')
+        return explicit;
+    try {
+        const zodPkg = 'zod';
+        const zodModule = (await import(zodPkg));
+        const converter = zodModule.toJSONSchema;
+        return typeof converter === 'function' ? converter : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 // ── Shared manifest builder ───────────────────────────────────────────────────
 /**
  * Builds a `BackendManifest` from a flat list of collected routes and a domain
@@ -149,15 +314,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,
@@ -175,14 +340,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 ──────────────────────────────────────────────────────────
 /**
@@ -224,7 +400,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;