@nifrajs/schema 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -8,7 +8,8 @@
  */
 export { fromTypeBox, type NifraSchema } from "./adapter.js";
 export { registerFormat } from "./formats.js";
-export { type OpenAPIDocument, type OpenAPIInfo, toOpenAPI } from "./openapi.js";
+export { type OpenAPIDocument, type OpenAPIInfo, toOpenAPI, toOpenAPIFromEvidence, } from "./openapi.js";
+export { diffOpenApiInventory, type ImportedApiInventory, type ImportedRoute, type ImportedRouteQuery, type ImportOpenAPIOptions, importOpenAPI, OpenAPIImportError, type OpenApiInventoryDrift, } from "./openapi-import.js";
 export { decodeCursor, encodeCursor, type Page, paginate } from "./pagination.js";
 export { t } from "./t.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEhF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,SAAS,EACT,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,aAAa,EACb,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}

package/dist/index.js

@@ -11,7 +11,8 @@ export { fromTypeBox } from "./adapter.js";
 // install themselves lazily from the validate path (see ./adapter.ts) - NOT as an import side
 // effect of this module, which a production bundler would tree-shake away.
 export { registerFormat } from "./formats.js";
-export { toOpenAPI } from "./openapi.js";
+export { toOpenAPI, toOpenAPIFromEvidence, } from "./openapi.js";
+export { diffOpenApiInventory, importOpenAPI, OpenAPIImportError, } from "./openapi-import.js";
 // Cursor-pagination runtime helpers - pair with `t.paginated` / `t.pageQuery`.
 export { decodeCursor, encodeCursor, paginate } from "./pagination.js";
 export { t } from "./t.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC5D,gGAAgG;AAChG,8FAA8F;AAC9F,2EAA2E;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAA0C,SAAS,EAAE,MAAM,cAAc,CAAA;AAChF,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAa,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC5D,gGAAgG;AAChG,8FAA8F;AAC9F,2EAA2E;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAGL,SAAS,EACT,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,oBAAoB,EAKpB,aAAa,EACb,kBAAkB,GAEnB,MAAM,qBAAqB,CAAA;AAC5B,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAa,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}

package/dist/openapi-import.d.ts

@@ -0,0 +1,73 @@
+/**
+ * OpenAPI 3.x inventory import - the structural half of an export/import roundtrip.
+ *
+ * `toOpenAPI` renders a Nifra app (or contract) as an OpenAPI 3.1 document. This module reads such
+ * a document back into a canonical route inventory: method, Nifra-templated path (`{id}` back to
+ * `:id`), required query names, body presence, and response statuses. `diffOpenApiInventory` then
+ * compares two inventories, so `export -> import -> diff` proves the cycle survives in CI.
+ *
+ * Deliberate boundaries, all fail-closed or explicitly documented:
+ *
+ * - Offline and ref-opaque. `$ref`s are never resolved and nothing is fetched. A `$ref` parameter
+ *   cannot yield a name without resolution, so it throws with the location; `$ref` bodies and
+ *   response schemas only assert presence, which needs no resolution.
+ * - No schema reconstruction. JSON Schema is not turned back into `t` builders here - that is a
+ *   separate codegen step needing consumer evidence. The inventory proves the route table survived;
+ *   field-level types ride along in the source document, not in this comparison.
+ * - No auth interpretation. `security`, `securitySchemes`, and `servers` are never read. Importing
+ *   an API must not silently adopt its auth model.
+ * - Templated paths degrade conservatively. `/files/*path` exports as `/files/{path}`, indistinguishable
+ *   from a single-segment `:path`. Import yields `:path` and records a note for every OpenAPI template;
+ *   a greedy remainder needs a manual `*path` rewrite.
+ * - Nifra parameter names follow `/^[A-Za-z_][A-Za-z0-9_]*$/`; `__proto__`, `constructor`, and
+ *   `prototype` are rejected. Mixed templates are converted only when their boundaries are representable.
+ * - Bounded. Path/operation/parameter counts are capped (`ImportOpenAPIOptions`); a document over
+ *   the caps throws rather than allocating.
+ */
+export declare class OpenAPIImportError extends Error {
+    constructor(message: string);
+}
+export interface ImportOpenAPIOptions {
+    /** Maximum entries under `paths`. Default 5000. */
+    readonly maxPaths?: number;
+    /** Maximum operations on one path item. Default 8. */
+    readonly maxOperationsPerPath?: number;
+    /** Maximum merged parameters per operation. Default 100. */
+    readonly maxParameters?: number;
+}
+export interface ImportedRouteQuery {
+    readonly name: string;
+    readonly required: boolean;
+}
+export interface ImportedRoute {
+    /** Lowercase HTTP method as it appears in the document. */
+    readonly method: string;
+    /** Nifra-templated path (`/users/:id`). */
+    readonly path: string;
+    readonly operationId?: string;
+    /** Template parameter names in path order. */
+    readonly pathParams: readonly string[];
+    readonly query: readonly ImportedRouteQuery[];
+    readonly hasBody: boolean;
+    readonly requestBodyRequired: boolean;
+    /** Response status keys (`"200"`, `"404"`, `"default"`). */
+    readonly responseStatuses: readonly string[];
+    /** Per-route degradations (wildcard rewrites). */
+    readonly notes: readonly string[];
+}
+export interface ImportedApiInventory {
+    readonly title: string;
+    readonly version: string;
+    readonly routes: readonly ImportedRoute[];
+    readonly warnings: readonly string[];
+}
+export interface OpenApiInventoryDrift {
+    /** `METHOD /path`, or `inventory` for route-set level drift. */
+    readonly route: string;
+    readonly message: string;
+}
+/** Parse an OpenAPI 3.0/3.1 document into a canonical route inventory. Throws on invalid input. */
+export declare function importOpenAPI(document: unknown, options?: ImportOpenAPIOptions): ImportedApiInventory;
+/** Compare two inventories. Empty means the export/import cycle preserved the route table. */
+export declare function diffOpenApiInventory(expected: ImportedApiInventory, actual: ImportedApiInventory): readonly OpenApiInventoryDrift[];
+//# sourceMappingURL=openapi-import.d.ts.map

package/dist/openapi-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-import.d.ts","sourceRoot":"","sources":["../src/openapi-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAgJD,mGAAmG;AACnG,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CA+HtB;AAMD,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,oBAAoB,GAC3B,SAAS,qBAAqB,EAAE,CAgDlC"}

package/dist/openapi-import.js

@@ -0,0 +1,302 @@
+/**
+ * OpenAPI 3.x inventory import - the structural half of an export/import roundtrip.
+ *
+ * `toOpenAPI` renders a Nifra app (or contract) as an OpenAPI 3.1 document. This module reads such
+ * a document back into a canonical route inventory: method, Nifra-templated path (`{id}` back to
+ * `:id`), required query names, body presence, and response statuses. `diffOpenApiInventory` then
+ * compares two inventories, so `export -> import -> diff` proves the cycle survives in CI.
+ *
+ * Deliberate boundaries, all fail-closed or explicitly documented:
+ *
+ * - Offline and ref-opaque. `$ref`s are never resolved and nothing is fetched. A `$ref` parameter
+ *   cannot yield a name without resolution, so it throws with the location; `$ref` bodies and
+ *   response schemas only assert presence, which needs no resolution.
+ * - No schema reconstruction. JSON Schema is not turned back into `t` builders here - that is a
+ *   separate codegen step needing consumer evidence. The inventory proves the route table survived;
+ *   field-level types ride along in the source document, not in this comparison.
+ * - No auth interpretation. `security`, `securitySchemes`, and `servers` are never read. Importing
+ *   an API must not silently adopt its auth model.
+ * - Templated paths degrade conservatively. `/files/*path` exports as `/files/{path}`, indistinguishable
+ *   from a single-segment `:path`. Import yields `:path` and records a note for every OpenAPI template;
+ *   a greedy remainder needs a manual `*path` rewrite.
+ * - Nifra parameter names follow `/^[A-Za-z_][A-Za-z0-9_]*$/`; `__proto__`, `constructor`, and
+ *   `prototype` are rejected. Mixed templates are converted only when their boundaries are representable.
+ * - Bounded. Path/operation/parameter counts are capped (`ImportOpenAPIOptions`); a document over
+ *   the caps throws rather than allocating.
+ */
+export class OpenAPIImportError extends Error {
+    constructor(message) {
+        super(`openapi import: ${message}`);
+        this.name = "OpenAPIImportError";
+    }
+}
+const SUPPORTED_METHODS = new Set([
+    "get",
+    "put",
+    "post",
+    "delete",
+    "patch",
+    "head",
+    "options",
+    "trace",
+]);
+const PATH_ITEM_METADATA = new Set(["$ref", "summary", "description", "servers", "parameters"]);
+const RESPONSE_KEY = /^(?:[1-5][0-9]{2}|default)$/;
+const TEMPLATE_EXPRESSION = /\{([^{}]*)\}/g;
+const NIFRA_PARAM = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const RESERVED_PARAM_NAMES = new Set(["__proto__", "constructor", "prototype"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizedLimit(value, fallback, label) {
+    const max = value ?? fallback;
+    if (!Number.isSafeInteger(max) || max < 0)
+        throw new OpenAPIImportError(`${label} limit must be a finite safe integer >= 0`);
+    return max;
+}
+function assertLimit(count, max, label) {
+    if (count > max)
+        throw new OpenAPIImportError(`${label} count ${count} exceeds limit ${max}`);
+}
+/** Collect own keys while stopping as soon as a bounded collection is over its cap. */
+function ownKeysWithinLimit(record, max, label, include = () => true) {
+    const keys = [];
+    for (const key in record) {
+        if (!Object.hasOwn(record, key) || !include(key))
+            continue;
+        if (keys.length >= max)
+            throw new OpenAPIImportError(`${label} count ${keys.length + 1} exceeds limit ${max}`);
+        keys.push(key);
+    }
+    return keys;
+}
+function toNifraPath(openapiPath) {
+    const segments = openapiPath.split("/");
+    let templated = false;
+    const pathParams = [];
+    const out = segments.map((segment) => {
+        if (!segment.includes("{") && !segment.includes("}"))
+            return segment;
+        const matches = [...segment.matchAll(TEMPLATE_EXPRESSION)];
+        if (matches.length === 0)
+            throw new OpenAPIImportError(`unparseable path template ${openapiPath}`);
+        let cursor = 0;
+        let converted = "";
+        for (const match of matches) {
+            if (match.index === undefined)
+                throw new OpenAPIImportError(`unparseable path template ${openapiPath}`);
+            const start = match.index;
+            const end = start + match[0].length;
+            const name = match[1] ?? "";
+            const previous = segment[start - 1];
+            const next = segment[end];
+            // Nifra's mixed grammar needs a non-identifier delimiter after a parameter. A terminal
+            // `foo{bar}` or adjacent `{a}{b}` cannot be represented without changing the capture.
+            if (next === "{" ||
+                (next !== undefined && /[A-Za-z0-9_]/.test(next)) ||
+                (next === undefined && previous !== undefined && /[A-Za-z0-9_]/.test(previous)))
+                throw new OpenAPIImportError(`path template ${openapiPath} is not representable in Nifra`);
+            if (!NIFRA_PARAM.test(name) || RESERVED_PARAM_NAMES.has(name))
+                throw new OpenAPIImportError(`invalid path parameter ${name}`);
+            if (pathParams.includes(name))
+                throw new OpenAPIImportError(`duplicate path parameter ${name} on ${openapiPath}`);
+            pathParams.push(name);
+            converted += `${segment.slice(cursor, start)}:${name}`;
+            cursor = end;
+            templated = true;
+        }
+        const tail = segment.slice(cursor);
+        if (tail.includes("{") || tail.includes("}"))
+            throw new OpenAPIImportError(`unparseable path template ${openapiPath}`);
+        return converted + tail;
+    });
+    return { path: out.join("/"), templated, pathParams: Object.freeze(pathParams) };
+}
+function mergedParameters(pathItem, operation, max) {
+    const merged = new Map();
+    for (const source of [pathItem.parameters, operation.parameters]) {
+        if (source === undefined)
+            continue;
+        if (!Array.isArray(source))
+            throw new OpenAPIImportError("parameters must be an array");
+        assertLimit(source.length, max, "parameters");
+        for (const entry of source) {
+            if (!isRecord(entry))
+                throw new OpenAPIImportError("parameter entries must be objects");
+            if ("$ref" in entry)
+                throw new OpenAPIImportError("parameter $refs must be inlined before import - refs are never resolved");
+            const { name, in: location, required, } = entry;
+            if (typeof name !== "string" || name === "")
+                throw new OpenAPIImportError("parameters need a non-empty name");
+            if (typeof location !== "string" || location === "")
+                throw new OpenAPIImportError(`parameter ${name} needs an 'in' location`);
+            merged.set(`${location} ${name}`, {
+                name,
+                location,
+                required: required === true,
+            });
+        }
+    }
+    assertLimit(merged.size, max, "merged parameters");
+    return [...merged.values()];
+}
+/** Parse an OpenAPI 3.0/3.1 document into a canonical route inventory. Throws on invalid input. */
+export function importOpenAPI(document, options = {}) {
+    const maxPaths = normalizedLimit(options.maxPaths, 5000, "maxPaths");
+    const maxOperations = normalizedLimit(options.maxOperationsPerPath, 8, "maxOperationsPerPath");
+    const maxParameters = normalizedLimit(options.maxParameters, 100, "maxParameters");
+    if (!isRecord(document))
+        throw new OpenAPIImportError("document must be an object");
+    const { openapi, info, paths } = document;
+    if (typeof openapi !== "string" || !/^3\.(0|1)\.\d+$/.test(openapi))
+        throw new OpenAPIImportError(`unsupported OpenAPI version ${JSON.stringify(openapi)} - 3.0.x and 3.1.x only`);
+    if (!isRecord(info))
+        throw new OpenAPIImportError("document.info must be an object");
+    const title = typeof info.title === "string" ? info.title : "";
+    const version = typeof info.version === "string" ? info.version : "";
+    if (paths === undefined)
+        return { title, version, routes: Object.freeze([]), warnings: Object.freeze([]) };
+    if (!isRecord(paths))
+        throw new OpenAPIImportError("document.paths must be an object");
+    const pathKeys = ownKeysWithinLimit(paths, maxPaths, "paths");
+    const warnings = [];
+    const routes = [];
+    for (const openapiPath of pathKeys) {
+        if (!openapiPath.startsWith("/"))
+            throw new OpenAPIImportError(`path ${openapiPath} must start with /`);
+        const pathItem = paths[openapiPath];
+        if (!isRecord(pathItem))
+            throw new OpenAPIImportError(`path item ${openapiPath} must be an object`);
+        if (Object.hasOwn(pathItem, "$ref"))
+            throw new OpenAPIImportError(`path item $refs must be inlined before import - refs are never resolved`);
+        const operationKeys = ownKeysWithinLimit(pathItem, maxOperations, `operations on ${openapiPath}`, (key) => key !== "parameters" && !PATH_ITEM_METADATA.has(key) && !key.startsWith("x-"));
+        const { path, templated, pathParams } = toNifraPath(openapiPath);
+        const seenMethods = new Set();
+        for (const rawMethod of operationKeys) {
+            const method = rawMethod.toLowerCase();
+            if (!SUPPORTED_METHODS.has(method))
+                throw new OpenAPIImportError(`unsupported method ${rawMethod} on ${openapiPath}`);
+            if (seenMethods.has(method))
+                throw new OpenAPIImportError(`duplicate method ${rawMethod} on ${openapiPath}`);
+            seenMethods.add(method);
+            const rawOperation = pathItem[rawMethod];
+            if (!isRecord(rawOperation))
+                throw new OpenAPIImportError(`operation ${rawMethod} ${openapiPath} must be an object`);
+            const params = mergedParameters(pathItem, rawOperation, maxParameters);
+            const query = [];
+            for (const param of params) {
+                if (param.location === "query")
+                    query.push({ name: param.name, required: param.required });
+                else if (param.location !== "path" && param.location !== "header")
+                    warnings.push(`${method.toUpperCase()} ${path}: '${param.location}' parameter '${param.name}' skipped`);
+                else if (param.location === "header")
+                    warnings.push(`${method.toUpperCase()} ${path}: header parameters are not inventoried`);
+            }
+            const declaredPathParams = new Set(params.filter((param) => param.location === "path").map((param) => param.name));
+            for (const name of pathParams) {
+                if (!declaredPathParams.has(name))
+                    throw new OpenAPIImportError(`path parameter ${name} is not declared on ${method.toUpperCase()} ${path}`);
+            }
+            for (const name of declaredPathParams) {
+                if (!pathParams.includes(name))
+                    throw new OpenAPIImportError(`declared path parameter ${name} is not in ${path}`);
+            }
+            const rawBody = rawOperation.requestBody;
+            const hasBody = rawBody !== undefined;
+            if (hasBody && !isRecord(rawBody))
+                throw new OpenAPIImportError(`requestBody on ${method.toUpperCase()} ${path} must be an object`);
+            const rawResponses = rawOperation.responses;
+            if (rawResponses === undefined)
+                throw new OpenAPIImportError(`responses are required on ${method.toUpperCase()} ${path}`);
+            if (!isRecord(rawResponses))
+                throw new OpenAPIImportError(`responses on ${method.toUpperCase()} ${path} must be an object`);
+            const responseStatuses = [];
+            for (const status of Object.keys(rawResponses)) {
+                if (!RESPONSE_KEY.test(status))
+                    throw new OpenAPIImportError(`invalid response status ${status} on ${method.toUpperCase()} ${path}`);
+                if (!isRecord(rawResponses[status]))
+                    throw new OpenAPIImportError(`response ${status} on ${method.toUpperCase()} ${path} must be an object`);
+                responseStatuses.push(status);
+            }
+            const notes = templated
+                ? [
+                    "OpenAPI path templates import as single-segment :params - greedy remainders (*rest) cannot be distinguished and need manual rewrites",
+                ]
+                : [];
+            const operationId = rawOperation.operationId;
+            routes.push(Object.freeze({
+                method,
+                path,
+                ...(typeof operationId === "string" && operationId !== "" ? { operationId } : {}),
+                pathParams,
+                query: Object.freeze(query),
+                hasBody,
+                requestBodyRequired: hasBody && rawBody.required === true,
+                responseStatuses: Object.freeze(responseStatuses),
+                notes: Object.freeze(notes),
+            }));
+        }
+    }
+    if (routes.some((route) => route.pathParams.length > 0))
+        warnings.push("OpenAPI path templates import as single-segment :params - greedy remainders (*rest) cannot be distinguished and need manual rewrites; see route notes");
+    return {
+        title,
+        version,
+        routes: Object.freeze(routes),
+        warnings: Object.freeze(warnings),
+    };
+}
+function routeKey(method, path) {
+    return `${method.toUpperCase()} ${path}`;
+}
+/** Compare two inventories. Empty means the export/import cycle preserved the route table. */
+export function diffOpenApiInventory(expected, actual) {
+    const drift = [];
+    const actualByKey = new Map(actual.routes.map((route) => [routeKey(route.method, route.path), route]));
+    const expectedKeys = new Set();
+    for (const want of expected.routes) {
+        const key = routeKey(want.method, want.path);
+        expectedKeys.add(key);
+        const got = actualByKey.get(key);
+        if (got === undefined) {
+            drift.push({ route: key, message: "route missing after import" });
+            continue;
+        }
+        const wantQuery = new Map(want.query.map((param) => [param.name, param.required]));
+        const gotQuery = new Map(got.query.map((param) => [param.name, param.required]));
+        for (const [name, required] of wantQuery) {
+            if (!gotQuery.has(name))
+                drift.push({ route: key, message: `query parameter '${name}' lost` });
+            else if (gotQuery.get(name) !== required)
+                drift.push({ route: key, message: `query parameter '${name}' required flag flipped` });
+        }
+        for (const name of gotQuery.keys()) {
+            if (!wantQuery.has(name))
+                drift.push({ route: key, message: `unexpected query parameter '${name}'` });
+        }
+        if (want.hasBody !== got.hasBody)
+            drift.push({
+                route: key,
+                message: want.hasBody ? "request body lost" : "unexpected request body",
+            });
+        else if (want.hasBody && want.requestBodyRequired !== got.requestBodyRequired)
+            drift.push({ route: key, message: "request body required flag flipped" });
+        const wantStatuses = new Set(want.responseStatuses);
+        const gotStatuses = new Set(got.responseStatuses);
+        for (const status of wantStatuses) {
+            if (!gotStatuses.has(status))
+                drift.push({ route: key, message: `response status ${status} lost` });
+        }
+        for (const status of gotStatuses) {
+            if (!wantStatuses.has(status))
+                drift.push({ route: key, message: `unexpected response status ${status}` });
+        }
+    }
+    for (const got of actual.routes) {
+        const key = routeKey(got.method, got.path);
+        if (!expectedKeys.has(key))
+            drift.push({ route: key, message: "unexpected route after import" });
+    }
+    return Object.freeze(drift);
+}
+//# sourceMappingURL=openapi-import.js.map

package/dist/openapi-import.js.map

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

package/dist/openapi.d.ts

@@ -1,4 +1,5 @@
 import type { ContractShape } from "@nifrajs/core/contract";
+import { type ProjectEvidenceSnapshot } from "@nifrajs/core/evidence";
 import { type JsonSchema } from "@nifrajs/core/reflection";
 import type { Server } from "@nifrajs/core/server";
 /**
@@ -39,6 +40,11 @@ export interface ToOpenAPIOptions {
     readonly securitySchemes?: Readonly<Record<string, Record<string, unknown>>>;
     /** Document-wide security requirement; a per-operation `security` (incl. `[]` for public) overrides it. */
     readonly security?: readonly SecurityRequirement[];
+    /**
+     * Reuse a canonical token-only route-evidence pass. This is useful for build artifacts and CLI
+     * projections that already evaluated the project; it never supplies runtime validators.
+     */
+    readonly evidence?: ProjectEvidenceSnapshot;
     /**
      * Per-operation overrides, shallow-merged over the generated operation. Keyed by `operationId`
      * (contract op name) or `"METHOD /path"` (e.g. `"GET /users/:id"`). The escape hatch for detail that
@@ -99,5 +105,7 @@ export interface OpenAPIDocument {
 }
 /** Generate an OpenAPI 3.1 document from a contract or a running app. See the module doc for the detail model. */
 export declare function toOpenAPI(input: ContractShape | Server, options?: ToOpenAPIOptions): OpenAPIDocument;
+/** Generate OpenAPI from an existing canonical project-evidence snapshot without loading a server. */
+export declare function toOpenAPIFromEvidence(evidence: ProjectEvidenceSnapshot, options?: Omit<ToOpenAPIOptions, "evidence">): OpenAPIDocument;
 export {};
 //# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

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

package/dist/openapi.js

@@ -1,3 +1,4 @@
+import { reflectedRoutesFromEvidence } from "@nifrajs/core/evidence";
 import { reflectRoutes, reflectSchema, } from "@nifrajs/core/reflection";
 /**
  * Collects schemas that carry a `$id` into `components.schemas`, returning a `$ref` in their place -
@@ -49,23 +50,52 @@ class SchemaStore {
         return { $ref: `#/components/schemas/${componentName}` };
     }
 }
-/** Name of a path segment's parameter, or `undefined` for a static segment. */
-function segmentParam(segment) {
-    if (segment.startsWith(":"))
-        return segment.slice(1);
+const NIFRA_PARAM = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const MIXED_PARAM = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+/** Names captured by a route segment under Nifra's parameter grammar. */
+function segmentParams(segment) {
     if (segment.startsWith("*"))
-        return segment.length > 1 ? segment.slice(1) : "wildcard";
+        return [segment.length > 1 ? segment.slice(1) : "wildcard"];
+    const names = [];
+    for (const match of segment.matchAll(MIXED_PARAM)) {
+        const name = match[1];
+        if (name === undefined || match.index === undefined)
+            continue;
+        const previous = segment[match.index - 1];
+        const atEnd = match.index + match[0].length === segment.length;
+        // `things:batchGet` is an established literal action path. The router only treats a terminal
+        // colon after an identifier as a parameter when a literal suffix follows it.
+        if (previous !== undefined && /[A-Za-z0-9_]/.test(previous) && atEnd)
+            continue;
+        names.push(name);
+    }
+    return names;
+}
+/** Name of a wholly dynamic path segment, or `undefined` for static/mixed segments. */
+function segmentParam(segment) {
+    const names = segmentParams(segment);
+    if (segment.startsWith("*") && names.length === 1)
+        return names[0];
+    if (segment.startsWith(":") && NIFRA_PARAM.test(segment.slice(1)) && names.length === 1)
+        return names[0];
     return undefined;
 }
+/** Convert one Nifra route segment, including mixed forms, to OpenAPI templates. */
+function toTemplatedSegment(segment) {
+    const whole = segmentParam(segment);
+    if (whole !== undefined)
+        return `{${whole}}`;
+    return segment.replace(MIXED_PARAM, (match, name, offset) => {
+        const previous = segment[offset - 1];
+        const atEnd = offset + match.length === segment.length;
+        if (previous !== undefined && /[A-Za-z0-9_]/.test(previous) && atEnd)
+            return match;
+        return `{${name}}`;
+    });
+}
 /** `/users/:id/*rest` → `/users/{id}/{rest}` (OpenAPI path templating). */
 function toTemplatedPath(path) {
-    return path
-        .split("/")
-        .map((segment) => {
-        const param = segmentParam(segment);
-        return param === undefined ? segment : `{${param}}`;
-    })
-        .join("/");
+    return path.split("/").map(toTemplatedSegment).join("/");
 }
 function pathParameters(path, paramsSchema) {
     const params = [];
@@ -77,8 +107,7 @@ function pathParameters(path, paramsSchema) {
         }
     }
     for (const segment of path.split("/")) {
-        const name = segmentParam(segment);
-        if (name !== undefined) {
+        for (const name of segmentParams(segment)) {
             // Merge the declared constraint (uuid format, integer type, etc.) when present;
             // fall back to the bare { type: "string" } derived from the URL pattern.
             const schema = fieldSchemas.get(name) ?? { type: "string" };
@@ -235,7 +264,10 @@ export function toOpenAPI(input, options = {}) {
     const paths = {};
     const store = new SchemaStore();
     if (isApp(input)) {
-        for (const route of reflectRoutes(input)) {
+        const routes = options.evidence === undefined
+            ? reflectRoutes(input)
+            : reflectedRoutesFromEvidence(options.evidence);
+        for (const route of routes) {
             addOperation(paths, route.method, {
                 path: route.path,
                 body: route.schema?.body,
@@ -303,4 +335,11 @@ export function toOpenAPI(input, options = {}) {
         ...(Object.keys(components).length > 0 ? { components } : {}),
     };
 }
+/** Generate OpenAPI from an existing canonical project-evidence snapshot without loading a server. */
+export function toOpenAPIFromEvidence(evidence, options = {}) {
+    const app = {
+        routes: () => reflectedRoutesFromEvidence(evidence),
+    };
+    return toOpenAPI(app, { ...options, evidence });
+}
 //# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAGL,aAAa,EACb,aAAa,GAEd,MAAM,0BAA0B,CAAA;AA8HjC;;;;GAIG;AACH,MAAM,WAAW;IACN,OAAO,GAA+B,EAAE,CAAA;IAChC,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC1C,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEjD,aAAa,CAAC,EAAU;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QACrC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;aAC9C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aACjD,IAAI,CAAC,EAAE,CAAC,CAAA;QACX,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,OAAO,EAAE,CAAA;QACpE,IAAI,IAAI,GAAG,IAAI,CAAA;QACf,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACzE,IAAI,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,CAAA;YAC1B,MAAM,IAAI,CAAC,CAAA;QACb,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iGAAiG;IACjG,OAAO,CAAC,MAA8B;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC1C,IAAI,OAAO,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QAC9C,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;QAClE,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;YAC7B,OAAO,OAAO,CAAC,GAAG,CAAA,CAAC,kEAAkE;YACrF,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE;gBACjD,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;gBAClB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,wBAAwB,aAAa,EAAE,EAAE,CAAA;IAC1D,CAAC;CACF;AAED,MAAM,WAAW,GAAG,0BAA0B,CAAA;AAC9C,MAAM,WAAW,GAAG,4BAA4B,CAAA;AAEhD,yEAAyE;AACzE,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IACxF,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,SAAQ;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAA;QAC9D,6FAA6F;QAC7F,6EAA6E;QAC7E,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK;YAAE,SAAQ;QAC9E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,uFAAuF;AACvF,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IAClE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACrF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACjB,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,oFAAoF;AACpF,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,KAAK,GAAG,CAAA;IAC5C,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,MAAc,EAAE,EAAE;QAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACpC,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAA;QACtD,IAAI,QAAQ,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;QAClF,OAAO,IAAI,IAAI,GAAG,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,YAA+B;IACnE,MAAM,MAAM,GAAuB,EAAE,CAAA;IACrC,gFAAgF;IAChF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAA;IAClD,IAAI,YAAY,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,gFAAgF;YAChF,yEAAyE;YACzE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAA;YACpE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,eAAe,CAAC,MAAoC;IAC3D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC5B,oFAAoF;IACpF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACnC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,OAAO;QACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAoC;IAC5D,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE;QAC9B,EAAE,EAAE,QAAiB;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC,CAAA;AACL,CAAC;AA8BD,MAAM,WAAW,GAAqC;IACpD,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,oBAAoB;IAC3B,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,wBAAwB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,uBAAuB;IAC9B,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,qBAAqB;CAC7B,CAAA;AAED,SAAS,0BAA0B,CACjC,MAAsC;IAEtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,MAAM,GAAG,GAAwE,EAAE,CAAA;IACnF,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC7E,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;QACnF,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC;AAED,SAAS,cAAc,CACrB,KAAqB,EACrB,KAAkB;IAElB,MAAM,SAAS,GAAoC,EAAE,CAAA;IACrD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QACvD,SAAS,CAAC,KAAK,CAAC;YACd,MAAM,KAAK,SAAS;gBAClB,CAAC,CAAC;oBACE,WAAW,EAAE,IAAI;oBACjB,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,mBAAmB,IAAI,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;iBAC3E;gBACH,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC1C,CAAC;IACD,oEAAoE;IACpE,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAoB,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAA;YACxE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC1F,IAAI,MAAM,KAAK,SAAS;gBACtB,QAAQ,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAA;YAC5E,SAAS,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAA;QAC9B,CAAC;IACH,CAAC;IACD,+FAA+F;IAC/F,gFAAgF;IAChF,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,SAAS;gBAAE,SAAQ;YAChF,MAAM,QAAQ,GAAoB;gBAChC,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,UAAU;aACzE,CAAA;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;YAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,QAAQ,CAAC,OAAO,GAAG;oBACjB,CAAC,UAAU,CAAC,WAAW,IAAI,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE;iBAC3D,CAAA;YACH,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAA;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,KAAqB,EAAE,KAAkB;IAC/D,MAAM,SAAS,GAAqB,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAA;IAC/E,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;IAC9E,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAClE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;IAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,SAAS,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IAClF,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;QAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAA;IAC1D,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,SAAS,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA,CAAC,2BAA2B;IAEjG,MAAM,UAAU,GAAG;QACjB,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;QAC3C,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;QAC/B,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC;KACnC,CAAA;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,SAAS,CAAC,UAAU,GAAG,UAAU,CAAA;IAE5D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS,CAAC,WAAW,GAAG;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;aAC1E,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,KAAuD,EACvD,MAAc,EACd,KAAqB,EACrB,KAAkB,EAClB,UAA0C;IAE1C,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;IACvC,KAAK,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAA;IAC3B,IAAI,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC5C,oEAAoE;IACpE,MAAM,QAAQ,GACZ,UAAU,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAChG,IAAI,QAAQ,KAAK,SAAS;QAAE,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,GAAG,QAAQ,EAAsB,CAAA;IACzF,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,SAAS,CAAA;AAC5C,CAAC;AAED,SAAS,KAAK,CAAC,KAA6B;IAC1C,uFAAuF;IACvF,8EAA8E;IAC9E,OAAO,OAAQ,KAA8B,CAAC,MAAM,KAAK,UAAU,CAAA;AACrE,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,SAAS,CACvB,KAA6B,EAC7B,UAA4B,EAAE;IAE9B,MAAM,KAAK,GAAqD,EAAE,CAAA;IAClE,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAA;IAE/B,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,MAAM,GACV,OAAO,CAAC,QAAQ,KAAK,SAAS;YAC5B,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,2BAA2B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,YAAY,CACV,KAAK,EACL,KAAK,CAAC,MAAM,EACZ;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI;gBACxB,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK;gBAC1B,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;gBAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM;gBAC5B,kFAAkF;gBAClF,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ;gBAChC,+DAA+D;gBAC/D,SAAS,EAAE,0BAA0B,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;gBAC3D,iBAAiB,EACf,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC5E,WAAW,EAAE,SAAS;aACvB,EACD,KAAK,EACL,OAAO,CAAC,UAAU,CACnB,CAAA;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,YAAY,CACV,KAAK,EACL,EAAE,CAAC,MAAM,EACT;gBACE,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC;gBAChE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC;gBACnE,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,CAAC;gBACzE,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC;gBACtE,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,CAAC;gBAC5E,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,kBAAkB,EAAE,EAAE,CAAC,kBAAkB;gBACzC,mBAAmB,EAAE,EAAE,CAAC,mBAAmB;gBAC3C,SAAS,EACP,EAAE,CAAC,SAAS,KAAK,SAAS;oBACxB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE;wBACtD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAA;wBACxC,OAAO;4BACL,MAAM;4BACN;gCACE,GAAG,QAAQ;gCACX,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;6BACnE;yBACF,CAAA;oBACH,CAAC,CAAC,CACH;gBACP,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;aACxF,EACD,KAAK,EACL,OAAO,CAAC,UAAU,CACnB,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAsB,EAAE,CAAA;IACxC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAC7E,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,UAAU,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAA;IAE/F,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;YACnC,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF;QACD,KAAK;QACL,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAA;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CACnC,QAAiC,EACjC,UAA8C,EAAE;IAEhD,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,GAAG,EAAE,CAAC,2BAA2B,CAAC,QAAQ,CAAC;KAC/B,CAAA;IACtB,OAAO,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;AACjD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/schema",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "description": "Built-in schema builder `t` - TypeBox-backed (free JSON Schema + compiled validators), implements Standard Schema so nifra routes validate it natively.",
   "keywords": [
     "bun",
@@ -48,7 +48,7 @@
     "@sinclair/typebox": "^0.34.49"
   },
   "peerDependencies": {
-    "@nifrajs/core": "^3.3.0"
+    "@nifrajs/core": "^3.5.0"
   },
   "devDependencies": {
     "@nifrajs/core": "workspace:*",

package/src/index.ts

@@ -11,7 +11,22 @@ export { fromTypeBox, type NifraSchema } from "./adapter.ts"
 // install themselves lazily from the validate path (see ./adapter.ts) - NOT as an import side
 // effect of this module, which a production bundler would tree-shake away.
 export { registerFormat } from "./formats.ts"
-export { type OpenAPIDocument, type OpenAPIInfo, toOpenAPI } from "./openapi.ts"
+export {
+  type OpenAPIDocument,
+  type OpenAPIInfo,
+  toOpenAPI,
+  toOpenAPIFromEvidence,
+} from "./openapi.ts"
+export {
+  diffOpenApiInventory,
+  type ImportedApiInventory,
+  type ImportedRoute,
+  type ImportedRouteQuery,
+  type ImportOpenAPIOptions,
+  importOpenAPI,
+  OpenAPIImportError,
+  type OpenApiInventoryDrift,
+} from "./openapi-import.ts"
 // Cursor-pagination runtime helpers - pair with `t.paginated` / `t.pageQuery`.
 export { decodeCursor, encodeCursor, type Page, paginate } from "./pagination.ts"
 export { t } from "./t.ts"

package/src/openapi-import.ts

@@ -0,0 +1,410 @@
+/**
+ * OpenAPI 3.x inventory import - the structural half of an export/import roundtrip.
+ *
+ * `toOpenAPI` renders a Nifra app (or contract) as an OpenAPI 3.1 document. This module reads such
+ * a document back into a canonical route inventory: method, Nifra-templated path (`{id}` back to
+ * `:id`), required query names, body presence, and response statuses. `diffOpenApiInventory` then
+ * compares two inventories, so `export -> import -> diff` proves the cycle survives in CI.
+ *
+ * Deliberate boundaries, all fail-closed or explicitly documented:
+ *
+ * - Offline and ref-opaque. `$ref`s are never resolved and nothing is fetched. A `$ref` parameter
+ *   cannot yield a name without resolution, so it throws with the location; `$ref` bodies and
+ *   response schemas only assert presence, which needs no resolution.
+ * - No schema reconstruction. JSON Schema is not turned back into `t` builders here - that is a
+ *   separate codegen step needing consumer evidence. The inventory proves the route table survived;
+ *   field-level types ride along in the source document, not in this comparison.
+ * - No auth interpretation. `security`, `securitySchemes`, and `servers` are never read. Importing
+ *   an API must not silently adopt its auth model.
+ * - Templated paths degrade conservatively. `/files/*path` exports as `/files/{path}`, indistinguishable
+ *   from a single-segment `:path`. Import yields `:path` and records a note for every OpenAPI template;
+ *   a greedy remainder needs a manual `*path` rewrite.
+ * - Nifra parameter names follow `/^[A-Za-z_][A-Za-z0-9_]*$/`; `__proto__`, `constructor`, and
+ *   `prototype` are rejected. Mixed templates are converted only when their boundaries are representable.
+ * - Bounded. Path/operation/parameter counts are capped (`ImportOpenAPIOptions`); a document over
+ *   the caps throws rather than allocating.
+ */
+
+export class OpenAPIImportError extends Error {
+  constructor(message: string) {
+    super(`openapi import: ${message}`)
+    this.name = "OpenAPIImportError"
+  }
+}
+
+export interface ImportOpenAPIOptions {
+  /** Maximum entries under `paths`. Default 5000. */
+  readonly maxPaths?: number
+  /** Maximum operations on one path item. Default 8. */
+  readonly maxOperationsPerPath?: number
+  /** Maximum merged parameters per operation. Default 100. */
+  readonly maxParameters?: number
+}
+
+export interface ImportedRouteQuery {
+  readonly name: string
+  readonly required: boolean
+}
+
+export interface ImportedRoute {
+  /** Lowercase HTTP method as it appears in the document. */
+  readonly method: string
+  /** Nifra-templated path (`/users/:id`). */
+  readonly path: string
+  readonly operationId?: string
+  /** Template parameter names in path order. */
+  readonly pathParams: readonly string[]
+  readonly query: readonly ImportedRouteQuery[]
+  readonly hasBody: boolean
+  readonly requestBodyRequired: boolean
+  /** Response status keys (`"200"`, `"404"`, `"default"`). */
+  readonly responseStatuses: readonly string[]
+  /** Per-route degradations (wildcard rewrites). */
+  readonly notes: readonly string[]
+}
+
+export interface ImportedApiInventory {
+  readonly title: string
+  readonly version: string
+  readonly routes: readonly ImportedRoute[]
+  readonly warnings: readonly string[]
+}
+
+export interface OpenApiInventoryDrift {
+  /** `METHOD /path`, or `inventory` for route-set level drift. */
+  readonly route: string
+  readonly message: string
+}
+
+const SUPPORTED_METHODS: ReadonlySet<string> = new Set([
+  "get",
+  "put",
+  "post",
+  "delete",
+  "patch",
+  "head",
+  "options",
+  "trace",
+])
+const PATH_ITEM_METADATA = new Set(["$ref", "summary", "description", "servers", "parameters"])
+const RESPONSE_KEY = /^(?:[1-5][0-9]{2}|default)$/
+const TEMPLATE_EXPRESSION = /\{([^{}]*)\}/g
+const NIFRA_PARAM = /^[A-Za-z_][A-Za-z0-9_]*$/
+const RESERVED_PARAM_NAMES = new Set(["__proto__", "constructor", "prototype"])
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+function normalizedLimit(value: number | undefined, fallback: number, label: string): number {
+  const max = value ?? fallback
+  if (!Number.isSafeInteger(max) || max < 0)
+    throw new OpenAPIImportError(`${label} limit must be a finite safe integer >= 0`)
+  return max
+}
+
+function assertLimit(count: number, max: number, label: string): void {
+  if (count > max) throw new OpenAPIImportError(`${label} count ${count} exceeds limit ${max}`)
+}
+
+/** Collect own keys while stopping as soon as a bounded collection is over its cap. */
+function ownKeysWithinLimit(
+  record: Record<string, unknown>,
+  max: number,
+  label: string,
+  include: (key: string) => boolean = () => true,
+): string[] {
+  const keys: string[] = []
+  for (const key in record) {
+    if (!Object.hasOwn(record, key) || !include(key)) continue
+    if (keys.length >= max)
+      throw new OpenAPIImportError(`${label} count ${keys.length + 1} exceeds limit ${max}`)
+    keys.push(key)
+  }
+  return keys
+}
+
+function toNifraPath(openapiPath: string): {
+  readonly path: string
+  readonly templated: boolean
+  readonly pathParams: readonly string[]
+} {
+  const segments = openapiPath.split("/")
+  let templated = false
+  const pathParams: string[] = []
+  const out = segments.map((segment) => {
+    if (!segment.includes("{") && !segment.includes("}")) return segment
+    const matches = [...segment.matchAll(TEMPLATE_EXPRESSION)]
+    if (matches.length === 0)
+      throw new OpenAPIImportError(`unparseable path template ${openapiPath}`)
+    let cursor = 0
+    let converted = ""
+    for (const match of matches) {
+      if (match.index === undefined)
+        throw new OpenAPIImportError(`unparseable path template ${openapiPath}`)
+      const start = match.index
+      const end = start + match[0].length
+      const name = match[1] ?? ""
+      const previous = segment[start - 1]
+      const next = segment[end]
+      // Nifra's mixed grammar needs a non-identifier delimiter after a parameter. A terminal
+      // `foo{bar}` or adjacent `{a}{b}` cannot be represented without changing the capture.
+      if (
+        next === "{" ||
+        (next !== undefined && /[A-Za-z0-9_]/.test(next)) ||
+        (next === undefined && previous !== undefined && /[A-Za-z0-9_]/.test(previous))
+      )
+        throw new OpenAPIImportError(`path template ${openapiPath} is not representable in Nifra`)
+      if (!NIFRA_PARAM.test(name) || RESERVED_PARAM_NAMES.has(name))
+        throw new OpenAPIImportError(`invalid path parameter ${name}`)
+      if (pathParams.includes(name))
+        throw new OpenAPIImportError(`duplicate path parameter ${name} on ${openapiPath}`)
+      pathParams.push(name)
+      converted += `${segment.slice(cursor, start)}:${name}`
+      cursor = end
+      templated = true
+    }
+    const tail = segment.slice(cursor)
+    if (tail.includes("{") || tail.includes("}"))
+      throw new OpenAPIImportError(`unparseable path template ${openapiPath}`)
+    return converted + tail
+  })
+  return { path: out.join("/"), templated, pathParams: Object.freeze(pathParams) }
+}
+
+interface MergedParameter {
+  readonly name: string
+  readonly location: string
+  readonly required: boolean
+}
+
+function mergedParameters(
+  pathItem: Record<string, unknown>,
+  operation: Record<string, unknown>,
+  max: number,
+): MergedParameter[] {
+  const merged = new Map<string, MergedParameter>()
+  for (const source of [pathItem.parameters, operation.parameters]) {
+    if (source === undefined) continue
+    if (!Array.isArray(source)) throw new OpenAPIImportError("parameters must be an array")
+    assertLimit(source.length, max, "parameters")
+    for (const entry of source) {
+      if (!isRecord(entry)) throw new OpenAPIImportError("parameter entries must be objects")
+      if ("$ref" in entry)
+        throw new OpenAPIImportError(
+          "parameter $refs must be inlined before import - refs are never resolved",
+        )
+      const {
+        name,
+        in: location,
+        required,
+      } = entry as {
+        name?: unknown
+        in?: unknown
+        required?: unknown
+      }
+      if (typeof name !== "string" || name === "")
+        throw new OpenAPIImportError("parameters need a non-empty name")
+      if (typeof location !== "string" || location === "")
+        throw new OpenAPIImportError(`parameter ${name} needs an 'in' location`)
+      merged.set(`${location} ${name}`, {
+        name,
+        location,
+        required: required === true,
+      })
+    }
+  }
+  assertLimit(merged.size, max, "merged parameters")
+  return [...merged.values()]
+}
+
+/** Parse an OpenAPI 3.0/3.1 document into a canonical route inventory. Throws on invalid input. */
+export function importOpenAPI(
+  document: unknown,
+  options: ImportOpenAPIOptions = {},
+): ImportedApiInventory {
+  const maxPaths = normalizedLimit(options.maxPaths, 5000, "maxPaths")
+  const maxOperations = normalizedLimit(options.maxOperationsPerPath, 8, "maxOperationsPerPath")
+  const maxParameters = normalizedLimit(options.maxParameters, 100, "maxParameters")
+  if (!isRecord(document)) throw new OpenAPIImportError("document must be an object")
+  const { openapi, info, paths } = document
+  if (typeof openapi !== "string" || !/^3\.(0|1)\.\d+$/.test(openapi))
+    throw new OpenAPIImportError(
+      `unsupported OpenAPI version ${JSON.stringify(openapi)} - 3.0.x and 3.1.x only`,
+    )
+  if (!isRecord(info)) throw new OpenAPIImportError("document.info must be an object")
+  const title = typeof info.title === "string" ? info.title : ""
+  const version = typeof info.version === "string" ? info.version : ""
+  if (paths === undefined)
+    return { title, version, routes: Object.freeze([]), warnings: Object.freeze([]) }
+  if (!isRecord(paths)) throw new OpenAPIImportError("document.paths must be an object")
+  const pathKeys = ownKeysWithinLimit(paths, maxPaths, "paths")
+  const warnings: string[] = []
+  const routes: ImportedRoute[] = []
+  for (const openapiPath of pathKeys) {
+    if (!openapiPath.startsWith("/"))
+      throw new OpenAPIImportError(`path ${openapiPath} must start with /`)
+    const pathItem = paths[openapiPath]
+    if (!isRecord(pathItem))
+      throw new OpenAPIImportError(`path item ${openapiPath} must be an object`)
+    if (Object.hasOwn(pathItem, "$ref"))
+      throw new OpenAPIImportError(
+        `path item $refs must be inlined before import - refs are never resolved`,
+      )
+    const operationKeys = ownKeysWithinLimit(
+      pathItem,
+      maxOperations,
+      `operations on ${openapiPath}`,
+      (key) => key !== "parameters" && !PATH_ITEM_METADATA.has(key) && !key.startsWith("x-"),
+    )
+    const { path, templated, pathParams } = toNifraPath(openapiPath)
+    const seenMethods = new Set<string>()
+    for (const rawMethod of operationKeys) {
+      const method = rawMethod.toLowerCase()
+      if (!SUPPORTED_METHODS.has(method))
+        throw new OpenAPIImportError(`unsupported method ${rawMethod} on ${openapiPath}`)
+      if (seenMethods.has(method))
+        throw new OpenAPIImportError(`duplicate method ${rawMethod} on ${openapiPath}`)
+      seenMethods.add(method)
+      const rawOperation = pathItem[rawMethod]
+      if (!isRecord(rawOperation))
+        throw new OpenAPIImportError(`operation ${rawMethod} ${openapiPath} must be an object`)
+      const params = mergedParameters(pathItem, rawOperation, maxParameters)
+      const query: ImportedRouteQuery[] = []
+      for (const param of params) {
+        if (param.location === "query") query.push({ name: param.name, required: param.required })
+        else if (param.location !== "path" && param.location !== "header")
+          warnings.push(
+            `${method.toUpperCase()} ${path}: '${param.location}' parameter '${param.name}' skipped`,
+          )
+        else if (param.location === "header")
+          warnings.push(`${method.toUpperCase()} ${path}: header parameters are not inventoried`)
+      }
+      const declaredPathParams = new Set(
+        params.filter((param) => param.location === "path").map((param) => param.name),
+      )
+      for (const name of pathParams) {
+        if (!declaredPathParams.has(name))
+          throw new OpenAPIImportError(
+            `path parameter ${name} is not declared on ${method.toUpperCase()} ${path}`,
+          )
+      }
+      for (const name of declaredPathParams) {
+        if (!pathParams.includes(name))
+          throw new OpenAPIImportError(`declared path parameter ${name} is not in ${path}`)
+      }
+      const rawBody = rawOperation.requestBody
+      const hasBody = rawBody !== undefined
+      if (hasBody && !isRecord(rawBody))
+        throw new OpenAPIImportError(
+          `requestBody on ${method.toUpperCase()} ${path} must be an object`,
+        )
+      const rawResponses = rawOperation.responses
+      if (rawResponses === undefined)
+        throw new OpenAPIImportError(`responses are required on ${method.toUpperCase()} ${path}`)
+      if (!isRecord(rawResponses))
+        throw new OpenAPIImportError(
+          `responses on ${method.toUpperCase()} ${path} must be an object`,
+        )
+      const responseStatuses: string[] = []
+      for (const status of Object.keys(rawResponses)) {
+        if (!RESPONSE_KEY.test(status))
+          throw new OpenAPIImportError(
+            `invalid response status ${status} on ${method.toUpperCase()} ${path}`,
+          )
+        if (!isRecord(rawResponses[status]))
+          throw new OpenAPIImportError(
+            `response ${status} on ${method.toUpperCase()} ${path} must be an object`,
+          )
+        responseStatuses.push(status)
+      }
+      const notes = templated
+        ? [
+            "OpenAPI path templates import as single-segment :params - greedy remainders (*rest) cannot be distinguished and need manual rewrites",
+          ]
+        : []
+      const operationId = rawOperation.operationId
+      routes.push(
+        Object.freeze({
+          method,
+          path,
+          ...(typeof operationId === "string" && operationId !== "" ? { operationId } : {}),
+          pathParams,
+          query: Object.freeze(query),
+          hasBody,
+          requestBodyRequired: hasBody && (rawBody as Record<string, unknown>).required === true,
+          responseStatuses: Object.freeze(responseStatuses),
+          notes: Object.freeze(notes),
+        }),
+      )
+    }
+  }
+  if (routes.some((route) => route.pathParams.length > 0))
+    warnings.push(
+      "OpenAPI path templates import as single-segment :params - greedy remainders (*rest) cannot be distinguished and need manual rewrites; see route notes",
+    )
+  return {
+    title,
+    version,
+    routes: Object.freeze(routes),
+    warnings: Object.freeze(warnings),
+  }
+}
+
+function routeKey(method: string, path: string): string {
+  return `${method.toUpperCase()} ${path}`
+}
+
+/** Compare two inventories. Empty means the export/import cycle preserved the route table. */
+export function diffOpenApiInventory(
+  expected: ImportedApiInventory,
+  actual: ImportedApiInventory,
+): readonly OpenApiInventoryDrift[] {
+  const drift: OpenApiInventoryDrift[] = []
+  const actualByKey = new Map(
+    actual.routes.map((route) => [routeKey(route.method, route.path), route]),
+  )
+  const expectedKeys = new Set<string>()
+  for (const want of expected.routes) {
+    const key = routeKey(want.method, want.path)
+    expectedKeys.add(key)
+    const got = actualByKey.get(key)
+    if (got === undefined) {
+      drift.push({ route: key, message: "route missing after import" })
+      continue
+    }
+    const wantQuery = new Map(want.query.map((param) => [param.name, param.required]))
+    const gotQuery = new Map(got.query.map((param) => [param.name, param.required]))
+    for (const [name, required] of wantQuery) {
+      if (!gotQuery.has(name)) drift.push({ route: key, message: `query parameter '${name}' lost` })
+      else if (gotQuery.get(name) !== required)
+        drift.push({ route: key, message: `query parameter '${name}' required flag flipped` })
+    }
+    for (const name of gotQuery.keys()) {
+      if (!wantQuery.has(name))
+        drift.push({ route: key, message: `unexpected query parameter '${name}'` })
+    }
+    if (want.hasBody !== got.hasBody)
+      drift.push({
+        route: key,
+        message: want.hasBody ? "request body lost" : "unexpected request body",
+      })
+    else if (want.hasBody && want.requestBodyRequired !== got.requestBodyRequired)
+      drift.push({ route: key, message: "request body required flag flipped" })
+    const wantStatuses = new Set(want.responseStatuses)
+    const gotStatuses = new Set(got.responseStatuses)
+    for (const status of wantStatuses) {
+      if (!gotStatuses.has(status))
+        drift.push({ route: key, message: `response status ${status} lost` })
+    }
+    for (const status of gotStatuses) {
+      if (!wantStatuses.has(status))
+        drift.push({ route: key, message: `unexpected response status ${status}` })
+    }
+  }
+  for (const got of actual.routes) {
+    const key = routeKey(got.method, got.path)
+    if (!expectedKeys.has(key)) drift.push({ route: key, message: "unexpected route after import" })
+  }
+  return Object.freeze(drift)
+}

package/src/openapi.ts

@@ -1,4 +1,5 @@
 import type { ContractShape } from "@nifrajs/core/contract"
+import { type ProjectEvidenceSnapshot, reflectedRoutesFromEvidence } from "@nifrajs/core/evidence"
 import {
   type JsonSchema,
   type ReflectedRouteSchema,
@@ -50,6 +51,11 @@ export interface ToOpenAPIOptions {
   readonly securitySchemes?: Readonly<Record<string, Record<string, unknown>>>
   /** Document-wide security requirement; a per-operation `security` (incl. `[]` for public) overrides it. */
   readonly security?: readonly SecurityRequirement[]
+  /**
+   * Reuse a canonical token-only route-evidence pass. This is useful for build artifacts and CLI
+   * projections that already evaluated the project; it never supplies runtime validators.
+   */
+  readonly evidence?: ProjectEvidenceSnapshot
   /**
    * Per-operation overrides, shallow-merged over the generated operation. Keyed by `operationId`
    * (contract op name) or `"METHOD /path"` (e.g. `"GET /users/:id"`). The escape hatch for detail that
@@ -175,22 +181,50 @@ class SchemaStore {
   }
 }
 
-/** Name of a path segment's parameter, or `undefined` for a static segment. */
+const NIFRA_PARAM = /^[A-Za-z_][A-Za-z0-9_]*$/
+const MIXED_PARAM = /:([A-Za-z_][A-Za-z0-9_]*)/g
+
+/** Names captured by a route segment under Nifra's parameter grammar. */
+function segmentParams(segment: string): readonly string[] {
+  if (segment.startsWith("*")) return [segment.length > 1 ? segment.slice(1) : "wildcard"]
+  const names: string[] = []
+  for (const match of segment.matchAll(MIXED_PARAM)) {
+    const name = match[1]
+    if (name === undefined || match.index === undefined) continue
+    const previous = segment[match.index - 1]
+    const atEnd = match.index + match[0].length === segment.length
+    // `things:batchGet` is an established literal action path. The router only treats a terminal
+    // colon after an identifier as a parameter when a literal suffix follows it.
+    if (previous !== undefined && /[A-Za-z0-9_]/.test(previous) && atEnd) continue
+    names.push(name)
+  }
+  return names
+}
+
+/** Name of a wholly dynamic path segment, or `undefined` for static/mixed segments. */
 function segmentParam(segment: string): string | undefined {
-  if (segment.startsWith(":")) return segment.slice(1)
-  if (segment.startsWith("*")) return segment.length > 1 ? segment.slice(1) : "wildcard"
+  const names = segmentParams(segment)
+  if (segment.startsWith("*") && names.length === 1) return names[0]
+  if (segment.startsWith(":") && NIFRA_PARAM.test(segment.slice(1)) && names.length === 1)
+    return names[0]
   return undefined
 }
 
+/** Convert one Nifra route segment, including mixed forms, to OpenAPI templates. */
+function toTemplatedSegment(segment: string): string {
+  const whole = segmentParam(segment)
+  if (whole !== undefined) return `{${whole}}`
+  return segment.replace(MIXED_PARAM, (match, name: string, offset: number) => {
+    const previous = segment[offset - 1]
+    const atEnd = offset + match.length === segment.length
+    if (previous !== undefined && /[A-Za-z0-9_]/.test(previous) && atEnd) return match
+    return `{${name}}`
+  })
+}
+
 /** `/users/:id/*rest` → `/users/{id}/{rest}` (OpenAPI path templating). */
 function toTemplatedPath(path: string): string {
-  return path
-    .split("/")
-    .map((segment) => {
-      const param = segmentParam(segment)
-      return param === undefined ? segment : `{${param}}`
-    })
-    .join("/")
+  return path.split("/").map(toTemplatedSegment).join("/")
 }
 
 function pathParameters(path: string, paramsSchema?: SchemaReflection): OpenAPIParameter[] {
@@ -203,8 +237,7 @@ function pathParameters(path: string, paramsSchema?: SchemaReflection): OpenAPIP
     }
   }
   for (const segment of path.split("/")) {
-    const name = segmentParam(segment)
-    if (name !== undefined) {
+    for (const name of segmentParams(segment)) {
       // Merge the declared constraint (uuid format, integer type, etc.) when present;
       // fall back to the bare { type: "string" } derived from the URL pattern.
       const schema = fieldSchemas.get(name) ?? { type: "string" as const }
@@ -402,7 +435,11 @@ export function toOpenAPI(
   const store = new SchemaStore()
 
   if (isApp(input)) {
-    for (const route of reflectRoutes(input)) {
+    const routes =
+      options.evidence === undefined
+        ? reflectRoutes(input)
+        : reflectedRoutesFromEvidence(options.evidence)
+    for (const route of routes) {
       addOperation(
         paths,
         route.method,
@@ -485,3 +522,14 @@ export function toOpenAPI(
     ...(Object.keys(components).length > 0 ? { components } : {}),
   }
 }
+
+/** Generate OpenAPI from an existing canonical project-evidence snapshot without loading a server. */
+export function toOpenAPIFromEvidence(
+  evidence: ProjectEvidenceSnapshot,
+  options: Omit<ToOpenAPIOptions, "evidence"> = {},
+): OpenAPIDocument {
+  const app = {
+    routes: () => reflectedRoutesFromEvidence(evidence),
+  } as unknown as Server
+  return toOpenAPI(app, { ...options, evidence })
+}