hono-apcore 0.1.0

package/dist/scanners/hono-route-scanner.js

@@ -0,0 +1,217 @@
+import { ModuleExecuteError, TraceContext, matchPattern } from 'apcore-js';
+import { BaseScanner, createScannedModule, extractPathParamNames, generateSuggestedAlias, substitutePathParams, } from 'apcore-toolkit';
+import { defaultSchemaExtractor } from '../schema/schema-extractor.js';
+import { applyModulePrefix } from '../utils/id-generator.js';
+import { normalizeResult, toModuleAnnotations } from '../utils/module-factory.js';
+/** Methods skipped unless the caller opts back in. */
+const DEFAULT_EXCLUDED_METHODS = ['HEAD', 'OPTIONS'];
+/** Methods whose inputs are carried in a request body rather than the query. */
+const BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);
+/** Base URL used when replaying a route through `app.request()`. */
+const DEFAULT_BASE_URL = 'http://localhost';
+function methodKey(method, path) {
+    return `${method.toUpperCase()} ${path}`;
+}
+function matchesAny(path, patterns) {
+    return patterns.some((pattern) => matchPattern(pattern, path));
+}
+/**
+ * Build the JSON Schema for a route: one required string property per path
+ * parameter, plus a free-form `query` or `body` object depending on method.
+ */
+function buildRouteInputSchema(method, path) {
+    const properties = {};
+    const required = [];
+    for (const name of extractPathParamNames(path)) {
+        properties[name] = {
+            type: 'string',
+            description: `Path parameter "${name}" of ${path}`,
+        };
+        required.push(name);
+    }
+    if (BODY_METHODS.has(method.toUpperCase())) {
+        properties['body'] = {
+            type: 'object',
+            description: 'JSON request body.',
+            additionalProperties: true,
+        };
+    }
+    else {
+        properties['query'] = {
+            type: 'object',
+            description: 'Query-string parameters.',
+            additionalProperties: { type: 'string' },
+        };
+    }
+    const schema = { type: 'object', properties };
+    if (required.length > 0)
+        schema['required'] = required;
+    return schema;
+}
+/**
+ * Propagate identity and W3C trace headers from the apcore `Context` onto the
+ * replayed request, so route-level auth and ACL see the original caller.
+ */
+function contextHeaders(context) {
+    const headers = {};
+    const ctx = context;
+    if (!ctx)
+        return headers;
+    const identity = ctx.identity;
+    if (identity) {
+        if (identity.id)
+            headers['x-user-id'] = identity.id;
+        if (identity.roles?.length)
+            headers['x-roles'] = identity.roles.join(',');
+    }
+    try {
+        Object.assign(headers, TraceContext.inject(ctx));
+    }
+    catch {
+        // A context without a usable trace id simply carries no trace headers.
+    }
+    return headers;
+}
+/** Turn a Response into the plain object a module must return. */
+async function responseToResult(response, moduleId) {
+    const contentType = response.headers.get('content-type') ?? '';
+    const isJson = contentType.includes('json');
+    const payload = isJson ? await response.json() : await response.text();
+    if (!response.ok) {
+        const detail = typeof payload === 'string' ? payload : JSON.stringify(payload);
+        throw new ModuleExecuteError(moduleId, `route responded ${response.status} ${response.statusText}: ${detail}`);
+    }
+    return normalizeResult(payload);
+}
+/**
+ * Scans a Hono app's route table and turns each route into an apcore module.
+ *
+ * Registered modules replay the route in-process through `app.request()`, so
+ * middleware, validators, and error handlers all run exactly as they do for a
+ * real HTTP request — no duplicated business logic, no second code path.
+ *
+ * Behavioural annotations are inferred from the HTTP method per RFC 9110
+ * safe-method semantics (`GET` → readonly + cacheable, `DELETE` →
+ * destructive, `PUT` → idempotent).
+ */
+export class HonoRouteScanner extends BaseScanner {
+    getSourceName() {
+        return 'hono-routes';
+    }
+    /**
+     * Scan the app's routes into toolkit `ScannedModule` intermediates.
+     *
+     * Use {@link scanWithExecutors} when you also need the bound execute
+     * functions — `scan()` returns serialisable metadata only, which is what
+     * the `scan` CLI command and YAML binding export want.
+     */
+    scan(app, options = {}) {
+        return this.scanWithExecutors(app, options).map((entry) => entry.module);
+    }
+    /**
+     * Scan the app's routes, returning each module together with the execute
+     * function that replays it through `app.request()`.
+     */
+    scanWithExecutors(app, options = {}) {
+        const { modulePrefix, includePaths = [], excludePaths = [], excludeMethods = DEFAULT_EXCLUDED_METHODS, include, exclude, tags = ['http'], overrides = {}, baseUrl = DEFAULT_BASE_URL, } = options;
+        const excludedMethods = new Set(excludeMethods.map((m) => m.toUpperCase()));
+        const entries = [];
+        const seen = new Set();
+        for (const route of app.routes) {
+            const method = route.method.toUpperCase();
+            const path = route.path;
+            // `app.use()` registers middleware as method `ALL`; it is not a callable
+            // endpoint, and duplicate (method, path) pairs are the same endpoint
+            // wrapped by several handlers.
+            if (method === 'ALL')
+                continue;
+            if (excludedMethods.has(method))
+                continue;
+            const key = methodKey(method, path);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (includePaths.length > 0 && !matchesAny(path, includePaths))
+                continue;
+            if (excludePaths.length > 0 && matchesAny(path, excludePaths))
+                continue;
+            const override = overrides[key] ?? {};
+            if (override.skip)
+                continue;
+            entries.push(this.buildEntry(app, method, path, override, {
+                modulePrefix,
+                tags,
+                baseUrl,
+            }));
+        }
+        // Deduplicate and filter while keeping each module paired with its
+        // executor. `deduplicateIds` maps 1:1 and preserves order, so index
+        // alignment with `entries` still holds after it renames a collision.
+        const deduped = this.deduplicateIds(entries.map((entry) => entry.module));
+        let paired = deduped.map((module, index) => ({
+            module,
+            execute: entries[index].execute,
+        }));
+        if (include || exclude) {
+            const kept = new Set(this.filterModules(deduped, include, exclude).map((module) => module.moduleId));
+            paired = paired.filter((entry) => kept.has(entry.module.moduleId));
+        }
+        return paired;
+    }
+    buildEntry(app, method, path, override, config) {
+        const alias = generateSuggestedAlias(path, method);
+        const moduleId = applyModulePrefix(override.id ?? alias, config.modulePrefix);
+        const inputSchema = override.inputSchema
+            ? defaultSchemaExtractor.extractJsonSchema(override.inputSchema)
+            : buildRouteInputSchema(method, path);
+        const outputSchema = override.outputSchema
+            ? defaultSchemaExtractor.extractJsonSchema(override.outputSchema)
+            : { type: 'object', properties: {}, additionalProperties: true };
+        const module = createScannedModule({
+            moduleId,
+            description: override.description ?? `${method} ${path}`,
+            inputSchema,
+            outputSchema,
+            tags: [...new Set([...config.tags, ...(override.tags ?? [])])],
+            target: methodKey(method, path),
+            annotations: toModuleAnnotations(override.annotations) ??
+                BaseScanner.inferAnnotationsFromMethod(method),
+            documentation: override.documentation ?? null,
+            suggestedAlias: alias,
+            examples: override.examples ?? [],
+            metadata: { http_method: method, http_path: path },
+        });
+        const execute = async (inputs, context) => {
+            const url = buildRequestUrl(path, method, inputs, config.baseUrl);
+            const headers = contextHeaders(context);
+            const init = { method, headers };
+            if (BODY_METHODS.has(method)) {
+                headers['content-type'] = 'application/json';
+                init.body = JSON.stringify(inputs['body'] ?? {});
+            }
+            const response = await app.request(url, init);
+            return responseToResult(response, moduleId);
+        };
+        return { module, execute };
+    }
+}
+/**
+ * Substitute path parameters and append the query string, producing the URL
+ * handed to `app.request()`.
+ */
+export function buildRequestUrl(path, method, inputs, baseUrl) {
+    const concrete = substitutePathParams(path, inputs);
+    const url = new URL(concrete, baseUrl);
+    if (!BODY_METHODS.has(method.toUpperCase())) {
+        const query = inputs['query'];
+        if (query !== null && typeof query === 'object' && !Array.isArray(query)) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+    }
+    return url.toString();
+}
+//# sourceMappingURL=hono-route-scanner.js.map

package/dist/scanners/hono-route-scanner.js.map

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

package/dist/scanners/index.d.ts

@@ -0,0 +1,3 @@
+export { HonoRouteScanner, buildRequestUrl } from './hono-route-scanner.js';
+export type { HonoAppLike } from './hono-route-scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanners/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/scanners/index.js

@@ -0,0 +1,2 @@
+export { HonoRouteScanner, buildRequestUrl } from './hono-route-scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/scanners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanners/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/schema/adapters/json-schema.adapter.d.ts

@@ -0,0 +1,23 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaAdapter } from './schema-adapter.interface.js';
+/**
+ * Schema adapter for plain JSON Schema objects.
+ *
+ * JSON Schema is structurally compatible with TypeBox's `TSchema`, so
+ * conversion is a deep clone via JSON round-trip.
+ */
+export declare class JsonSchemaAdapter implements SchemaAdapter {
+    readonly name: "json-schema";
+    readonly priority = 30;
+    /**
+     * Returns `true` for a non-null, non-array object that carries a `type`,
+     * `properties`, `anyOf`, `oneOf`, or `$ref` key and is not already a
+     * TypeBox schema (those belong to {@link TypeBoxAdapter}).
+     */
+    detect(input: unknown): boolean;
+    /** Deep-clone the JSON Schema; it doubles as a structurally valid TSchema. */
+    extract(input: unknown): TSchema;
+    /** Deep-clone the JSON Schema. */
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=json-schema.adapter.d.ts.map

package/dist/schema/adapters/json-schema.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.adapter.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/json-schema.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKnE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,QAAQ,MAAM;IAEvB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAoB/B,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIhC,kCAAkC;IAClC,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3D"}

package/dist/schema/adapters/json-schema.adapter.js

@@ -0,0 +1,40 @@
+/** Well-known symbol used by @sinclair/typebox to tag its schema objects. */
+const TYPEBOX_KIND = Symbol.for('TypeBox.Kind');
+/**
+ * Schema adapter for plain JSON Schema objects.
+ *
+ * JSON Schema is structurally compatible with TypeBox's `TSchema`, so
+ * conversion is a deep clone via JSON round-trip.
+ */
+export class JsonSchemaAdapter {
+    name = 'json-schema';
+    priority = 30;
+    /**
+     * Returns `true` for a non-null, non-array object that carries a `type`,
+     * `properties`, `anyOf`, `oneOf`, or `$ref` key and is not already a
+     * TypeBox schema (those belong to {@link TypeBoxAdapter}).
+     */
+    detect(input) {
+        if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+            return false;
+        }
+        const obj = input;
+        if (TYPEBOX_KIND in obj) {
+            return false;
+        }
+        return ('type' in obj ||
+            'properties' in obj ||
+            'anyOf' in obj ||
+            'oneOf' in obj ||
+            '$ref' in obj);
+    }
+    /** Deep-clone the JSON Schema; it doubles as a structurally valid TSchema. */
+    extract(input) {
+        return JSON.parse(JSON.stringify(input));
+    }
+    /** Deep-clone the JSON Schema. */
+    extractJsonSchema(input) {
+        return JSON.parse(JSON.stringify(input));
+    }
+}
+//# sourceMappingURL=json-schema.adapter.js.map

package/dist/schema/adapters/json-schema.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.adapter.js","sourceRoot":"","sources":["../../../src/schema/adapters/json-schema.adapter.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,aAAsB,CAAC;IAC9B,QAAQ,GAAG,EAAE,CAAC;IAEvB;;;;OAIG;IACH,MAAM,CAAC,KAAc;QACnB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,KAAyC,CAAC;QAEtD,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CACL,MAAM,IAAI,GAAG;YACb,YAAY,IAAI,GAAG;YACnB,OAAO,IAAI,GAAG;YACd,OAAO,IAAI,GAAG;YACd,MAAM,IAAI,GAAG,CACd,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,OAAO,CAAC,KAAc;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAY,CAAC;IACtD,CAAC;IAED,kCAAkC;IAClC,iBAAiB,CAAC,KAAc;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAA4B,CAAC;IACtE,CAAC;CACF"}

package/dist/schema/adapters/schema-adapter.interface.d.ts

@@ -0,0 +1,24 @@
+import type { TSchema } from '@sinclair/typebox';
+/**
+ * Contract for pluggable schema adapters.
+ *
+ * Each adapter knows how to detect one schema dialect (TypeBox, Zod, plain
+ * JSON Schema, ...) and convert it into the two canonical representations
+ * apcore consumes.
+ */
+export interface SchemaAdapter {
+    /** Human-readable adapter name, e.g. `'typebox'` or `'json-schema'`. */
+    readonly name: string;
+    /**
+     * Selection weight. Adapters are tried in **descending** priority order,
+     * so a higher number wins when two adapters both claim an input.
+     */
+    readonly priority: number;
+    /** Return `true` when `input` is a schema this adapter can handle. */
+    detect(input: unknown): boolean;
+    /** Convert `input` into a TypeBox-compatible `TSchema` object. */
+    extract(input: unknown): TSchema;
+    /** Convert `input` into a plain JSON Schema object. */
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=schema-adapter.interface.d.ts.map

package/dist/schema/adapters/schema-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-adapter.interface.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/schema-adapter.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAEhC,kEAAkE;IAClE,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAEjC,uDAAuD;IACvD,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5D"}

package/dist/schema/adapters/schema-adapter.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-adapter.interface.js.map

package/dist/schema/adapters/schema-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-adapter.interface.js","sourceRoot":"","sources":["../../../src/schema/adapters/schema-adapter.interface.ts"],"names":[],"mappings":""}

package/dist/schema/adapters/typebox.adapter.d.ts

@@ -0,0 +1,26 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaAdapter } from './schema-adapter.interface.js';
+/**
+ * Schema adapter for `@sinclair/typebox` schemas.
+ *
+ * TypeBox schemas are already valid JSON Schema objects decorated with extra
+ * `Symbol` properties that the TypeBox runtime (`Value.Check()`) relies on.
+ */
+export declare class TypeBoxAdapter implements SchemaAdapter {
+    readonly name: "typebox";
+    readonly priority = 100;
+    /** Returns `true` when `input` carries `Symbol.for('TypeBox.Kind')`. */
+    detect(input: unknown): boolean;
+    /**
+     * Return the TypeBox schema as-is — its `Symbol` keys must survive for
+     * runtime validation to work.
+     */
+    extract(input: unknown): TSchema;
+    /**
+     * Convert a TypeBox schema to plain JSON Schema. Because TypeBox *is* JSON
+     * Schema with extra symbol decorations, a JSON round-trip drops the symbols
+     * and leaves a standards-compliant document.
+     */
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=typebox.adapter.d.ts.map

package/dist/schema/adapters/typebox.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.adapter.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/typebox.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAQnE;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,QAAQ,OAAO;IAExB,wEAAwE;IACxE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAM/B;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIhC;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG3D"}

package/dist/schema/adapters/typebox.adapter.js

@@ -0,0 +1,39 @@
+/**
+ * Well-known TypeBox symbol tagging every schema node. Looking it up lets
+ * detection work without importing TypeBox at runtime.
+ */
+const KIND = Symbol.for('TypeBox.Kind');
+/**
+ * Schema adapter for `@sinclair/typebox` schemas.
+ *
+ * TypeBox schemas are already valid JSON Schema objects decorated with extra
+ * `Symbol` properties that the TypeBox runtime (`Value.Check()`) relies on.
+ */
+export class TypeBoxAdapter {
+    name = 'typebox';
+    priority = 100;
+    /** Returns `true` when `input` carries `Symbol.for('TypeBox.Kind')`. */
+    detect(input) {
+        if (input === null || input === undefined)
+            return false;
+        if (typeof input !== 'object')
+            return false;
+        return KIND in input;
+    }
+    /**
+     * Return the TypeBox schema as-is — its `Symbol` keys must survive for
+     * runtime validation to work.
+     */
+    extract(input) {
+        return input;
+    }
+    /**
+     * Convert a TypeBox schema to plain JSON Schema. Because TypeBox *is* JSON
+     * Schema with extra symbol decorations, a JSON round-trip drops the symbols
+     * and leaves a standards-compliant document.
+     */
+    extractJsonSchema(input) {
+        return JSON.parse(JSON.stringify(input));
+    }
+}
+//# sourceMappingURL=typebox.adapter.js.map

package/dist/schema/adapters/typebox.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.adapter.js","sourceRoot":"","sources":["../../../src/schema/adapters/typebox.adapter.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,SAAkB,CAAC;IAC1B,QAAQ,GAAG,GAAG,CAAC;IAExB,wEAAwE;IACxE,MAAM,CAAC,KAAc;QACnB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,IAAI,IAAK,KAAgB,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAc;QACpB,OAAO,KAAgB,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,KAAc;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAA4B,CAAC;IACtE,CAAC;CACF"}

package/dist/schema/adapters/zod.adapter.d.ts

@@ -0,0 +1,17 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaAdapter } from './schema-adapter.interface.js';
+/**
+ * Schema adapter for Zod, supporting both Zod 3 and Zod 4.
+ *
+ * Detection and conversion are structural — Zod is never imported — so the
+ * adapter works whichever major version (if any) the host app installs.
+ * Zod 3 is recognised by `_def.typeName`, Zod 4 by `_zod.def.type`.
+ */
+export declare class ZodAdapter implements SchemaAdapter {
+    readonly name: "zod";
+    readonly priority = 50;
+    detect(input: unknown): boolean;
+    extract(input: unknown): TSchema;
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=zod.adapter.d.ts.map

package/dist/schema/adapters/zod.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.adapter.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/zod.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AA4bnE;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,QAAQ,MAAM;IAEvB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIhC,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK3D"}