@erenthedeveloper0/zen-openapi 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Eren Sümer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/erenthedeveloper0/zen/main/.github/images/logo-with-text-white.png">
+    <img alt="zen.js" src="https://raw.githubusercontent.com/erenthedeveloper0/zen/main/.github/images/logo-with-text-black.png" width="220">
+  </picture>
+</p>
+
+# @erenthedeveloper0/zen-openapi
+
+OpenAPI 3.1 for [Zen](https://github.com/erenthedeveloper0/zen), generated from the
+same schemas the framework validates requests and serializes responses with —
+so the document says exactly what the wire carries.
+
+> **Alpha.**
+
+```bash
+npm install @erenthedeveloper0/zen-openapi@alpha
+```
+
+```ts
+import { zen, registerSchemaConverter } from '@erenthedeveloper0/zen'
+import { openapiPlugin } from '@erenthedeveloper0/zen-openapi'
+import { z } from 'zod'
+
+// Once, before the app boots: how to read a Zod schema as JSON Schema.
+registerSchemaConverter('zod', (schema, io) => z.toJSONSchema(schema as z.ZodType, { io }))
+
+const app = zen()
+app.use(openapiPlugin, {
+  title: 'Acme API',
+  version: '2.0.0',
+  json: '/openapi.json',   // the document
+  ui: '/docs',             // a built-in viewer with no external requests
+})
+```
+
+## Why the document cannot drift
+
+The generator is a pure function from the frozen application graph to a
+document, run once at boot — the endpoint serves a pre-encoded string with an
+`ETag`, and costs nothing per request.
+
+Response schemas are published **closed** (`additionalProperties: false`),
+because Zen's serializer drops any field a response schema does not declare: a
+document generated from the raw schema would promise clients fields that can
+never arrive. Parameter serialization follows the route's actual coercion
+settings, and a negotiated route publishes one `content` entry per media type,
+in the server's preference order.
+
+## Breaking-change detection
+
+```ts
+import { diffDocuments } from '@erenthedeveloper0/zen-openapi'
+
+const { breaking, compatible } = diffDocuments(committedBaseline, currentDocument)
+if (breaking.length > 0) process.exitCode = 1
+```
+
+Requests are contravariant and responses covariant: removing a response field,
+narrowing a request type or renaming an `operationId` is breaking; adding an
+optional response field is not. Run it in CI against a committed baseline and an
+API change is reviewed as an API change.
+
+## Options
+
+`title` and `version` are required. Also: `servers`, `tags`, `security`,
+`securitySchemes`, `license`, `contact`, `json` / `ui` (paths, or `false`),
+`strict` (turn documentation warnings into boot errors — worth enabling once an
+API is public), and `onDocument` (receives the finished document at boot).
+
+## Documentation
+
+[ARCHITECTURE.md §29](https://github.com/erenthedeveloper0/zen/blob/main/ARCHITECTURE.md#29-openapi--code-generation) ·
+[`examples/openapi`](https://github.com/erenthedeveloper0/zen/tree/main/examples/openapi).
+
+[MIT](https://github.com/erenthedeveloper0/zen/blob/main/LICENSE) © [Eren Sümer](https://github.com/erenthedeveloper0) · [contributors](https://github.com/erenthedeveloper0/zen/blob/main/CONTRIBUTORS.md)

package/dist/diff.d.ts

@@ -0,0 +1,37 @@
+import type { OpenApiDocument } from './types.ts';
+/**
+ * API change detection — rfcs/0001 §29.5.
+ *
+ * A governance feature disguised as tooling. The point is not the diff; it is
+ * that an API change stops being "a diff in a routes file" and becomes a
+ * reviewable statement about compatibility, on the pull request, before it
+ * ships.
+ *
+ * Two asymmetries drive every rule here, and they are the whole model:
+ *
+ *   - **Requests are contravariant.** Accepting *less* breaks callers. Removing
+ *     a field, adding a required one, or narrowing a type are all breaking.
+ *   - **Responses are covariant.** Returning *less* breaks callers. Removing a
+ *     field, dropping a status, or widening a type (a value the client's
+ *     exhaustive switch has never seen) are all breaking.
+ *
+ * The classification is deliberately conservative: when a change could break a
+ * reasonable consumer, it is reported as breaking. A tool that under-reports is
+ * worse than no tool, because it is trusted.
+ */
+export type ChangeKind = 'breaking' | 'compatible' | 'documentation';
+export interface ApiChange {
+    readonly kind: ChangeKind;
+    readonly code: string;
+    readonly message: string;
+    /** `GET /users/{id} → response 200 → users[].email` */
+    readonly location: string;
+}
+export interface DiffResult {
+    readonly changes: readonly ApiChange[];
+    readonly breaking: readonly ApiChange[];
+    readonly compatible: readonly ApiChange[];
+    readonly documentation: readonly ApiChange[];
+}
+export declare function diffDocuments(before: OpenApiDocument, after: OpenApiDocument): DiffResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACK,eAAe,EAC/B,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,CAAA;AAEpE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,QAAQ,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAA;CAC7C;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU,CAuCzF"}

package/dist/diff.js

@@ -0,0 +1,320 @@
+const METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'];
+export function diffDocuments(before, after) {
+    const changes = [];
+    const context = { before: new Resolver(before), after: new Resolver(after), changes };
+    const paths = new Set([...Object.keys(before.paths), ...Object.keys(after.paths)]);
+    for (const path of [...paths].sort()) {
+        const beforeItem = before.paths[path];
+        const afterItem = after.paths[path];
+        if (beforeItem !== undefined && afterItem === undefined) {
+            changes.push(breaking('OAS_PATH_REMOVED', `Path ${path} was removed.`, path));
+            continue;
+        }
+        if (beforeItem === undefined && afterItem !== undefined) {
+            changes.push(compatible('OAS_PATH_ADDED', `Path ${path} was added.`, path));
+            continue;
+        }
+        if (beforeItem === undefined || afterItem === undefined)
+            continue;
+        for (const method of METHODS) {
+            const from = beforeItem[method];
+            const to = afterItem[method];
+            const location = `${method.toUpperCase()} ${path}`;
+            if (from !== undefined && to === undefined) {
+                changes.push(breaking('OAS_OPERATION_REMOVED', `${location} was removed.`, location));
+            }
+            else if (from === undefined && to !== undefined) {
+                changes.push(compatible('OAS_OPERATION_ADDED', `${location} was added.`, location));
+            }
+            else if (from !== undefined && to !== undefined) {
+                diffOperation(from, to, location, context);
+            }
+        }
+    }
+    return {
+        changes,
+        breaking: changes.filter((c) => c.kind === 'breaking'),
+        compatible: changes.filter((c) => c.kind === 'compatible'),
+        documentation: changes.filter((c) => c.kind === 'documentation'),
+    };
+}
+function diffOperation(from, to, where, ctx) {
+    if (from.operationId !== to.operationId) {
+        // Generated clients name their methods from this. Renaming it is a source
+        // break in every SDK even when the wire format is untouched.
+        ctx.changes.push(breaking('OAS_OPERATION_ID_CHANGED', `operationId changed from "${from.operationId}" to "${to.operationId}".`, where));
+    }
+    if (from.summary !== to.summary || from.description !== to.description) {
+        ctx.changes.push(documentation('OAS_DESCRIPTION_CHANGED', 'Summary or description changed.', where));
+    }
+    if (from.deprecated !== true && to.deprecated === true) {
+        ctx.changes.push(documentation('OAS_OPERATION_DEPRECATED', 'Operation was marked deprecated.', where));
+    }
+    if ((from.security?.length ?? 0) === 0 && (to.security?.length ?? 0) > 0) {
+        ctx.changes.push(breaking('OAS_SECURITY_ADDED', 'Operation now requires authentication.', where));
+    }
+    diffParameters(from.parameters ?? [], to.parameters ?? [], where, ctx);
+    diffRequestBody(from, to, where, ctx);
+    diffResponses(from.responses, to.responses, where, ctx);
+}
+function diffParameters(from, to, where, ctx) {
+    const key = (p) => `${p.in}:${p.name}`;
+    const beforeMap = new Map(from.map((p) => [key(p), p]));
+    const afterMap = new Map(to.map((p) => [key(p), p]));
+    for (const [id, parameter] of beforeMap) {
+        const next = afterMap.get(id);
+        const at = `${where} → ${id}`;
+        if (next === undefined) {
+            ctx.changes.push(breaking('OAS_PARAM_REMOVED', `Parameter ${id} was removed.`, at));
+            continue;
+        }
+        if (parameter.required !== true && next.required === true) {
+            ctx.changes.push(breaking('OAS_PARAM_NOW_REQUIRED', `Parameter ${id} became required.`, at));
+        }
+        else if (parameter.required === true && next.required !== true) {
+            ctx.changes.push(compatible('OAS_PARAM_NOW_OPTIONAL', `Parameter ${id} became optional.`, at));
+        }
+        diffSchema(parameter.schema, next.schema, 'request', at, ctx, new Set());
+    }
+    for (const [id, parameter] of afterMap) {
+        if (beforeMap.has(id))
+            continue;
+        const at = `${where} → ${id}`;
+        ctx.changes.push(parameter.required === true
+            ? breaking('OAS_PARAM_ADDED_REQUIRED', `Required parameter ${id} was added.`, at)
+            : compatible('OAS_PARAM_ADDED', `Optional parameter ${id} was added.`, at));
+    }
+}
+function diffRequestBody(from, to, where, ctx) {
+    const beforeBody = from.requestBody;
+    const afterBody = to.requestBody;
+    if (beforeBody === undefined && afterBody === undefined)
+        return;
+    if (beforeBody === undefined && afterBody !== undefined) {
+        ctx.changes.push(afterBody.required === false
+            ? compatible('OAS_BODY_ADDED', 'An optional request body was added.', where)
+            : breaking('OAS_BODY_ADDED_REQUIRED', 'A required request body was added.', where));
+        return;
+    }
+    if (beforeBody !== undefined && afterBody === undefined) {
+        ctx.changes.push(compatible('OAS_BODY_REMOVED', 'The request body is no longer read.', where));
+        return;
+    }
+    if (beforeBody === undefined || afterBody === undefined)
+        return;
+    const media = new Set([...Object.keys(beforeBody.content), ...Object.keys(afterBody.content)]);
+    for (const type of [...media].sort()) {
+        const beforeMedia = beforeBody.content[type];
+        const afterMedia = afterBody.content[type];
+        const at = `${where} → body (${type})`;
+        if (beforeMedia === undefined) {
+            ctx.changes.push(compatible('OAS_BODY_MEDIA_ADDED', `Media type ${type} is now accepted.`, at));
+            continue;
+        }
+        if (afterMedia === undefined) {
+            ctx.changes.push(breaking('OAS_BODY_MEDIA_REMOVED', `Media type ${type} is no longer accepted.`, at));
+            continue;
+        }
+        diffSchema(beforeMedia.schema, afterMedia.schema, 'request', at, ctx, new Set());
+    }
+}
+function diffResponses(from, to, where, ctx) {
+    const statuses = new Set([...Object.keys(from), ...Object.keys(to)]);
+    for (const status of [...statuses].sort()) {
+        const beforeResponse = from[status];
+        const afterResponse = to[status];
+        const at = `${where} → response ${status}`;
+        if (beforeResponse !== undefined && afterResponse === undefined) {
+            ctx.changes.push(breaking('OAS_STATUS_REMOVED', `Status ${status} is no longer returned.`, at));
+            continue;
+        }
+        if (beforeResponse === undefined && afterResponse !== undefined) {
+            ctx.changes.push(compatible('OAS_STATUS_ADDED', `Status ${status} was added.`, at));
+            continue;
+        }
+        if (beforeResponse === undefined || afterResponse === undefined)
+            continue;
+        const beforeContent = beforeResponse.content ?? {};
+        const afterContent = afterResponse.content ?? {};
+        const media = new Set([...Object.keys(beforeContent), ...Object.keys(afterContent)]);
+        for (const type of [...media].sort()) {
+            const beforeMedia = beforeContent[type];
+            const afterMedia = afterContent[type];
+            const mediaAt = `${at} (${type})`;
+            if (beforeMedia === undefined) {
+                ctx.changes.push(compatible('OAS_RESPONSE_MEDIA_ADDED', `Media type ${type} was added.`, mediaAt));
+                continue;
+            }
+            if (afterMedia === undefined) {
+                ctx.changes.push(breaking('OAS_RESPONSE_MEDIA_REMOVED', `Media type ${type} is no longer returned.`, mediaAt));
+                continue;
+            }
+            diffSchema(beforeMedia.schema, afterMedia.schema, 'response', mediaAt, ctx, new Set());
+        }
+    }
+}
+function diffSchema(rawBefore, rawAfter, direction, where, ctx, seen) {
+    const guard = `${rawBefore.$ref ?? ''}|${rawAfter.$ref ?? ''}|${where}`;
+    if (rawBefore.$ref !== undefined || rawAfter.$ref !== undefined) {
+        if (seen.has(guard))
+            return;
+        seen.add(guard);
+    }
+    const before = ctx.before.resolve(rawBefore);
+    const after = ctx.after.resolve(rawAfter);
+    diffTypes(before, after, direction, where, ctx);
+    diffEnum(before, after, direction, where, ctx);
+    if (before.format !== after.format) {
+        ctx.changes.push(breaking('OAS_FORMAT_CHANGED', `Format changed from ${before.format ?? 'none'} to ${after.format ?? 'none'}.`, where));
+    }
+    diffProperties(before, after, direction, where, ctx, seen);
+    const beforeItems = typeof before.items === 'object' ? before.items : undefined;
+    const afterItems = typeof after.items === 'object' ? after.items : undefined;
+    if (beforeItems !== undefined && afterItems !== undefined) {
+        diffSchema(beforeItems, afterItems, direction, `${where}[]`, ctx, seen);
+    }
+    if (direction === 'request' && before.additionalProperties !== false && after.additionalProperties === false) {
+        ctx.changes.push(breaking('OAS_ADDITIONAL_PROPERTIES_CLOSED', 'Extra properties are no longer accepted.', where));
+    }
+}
+function diffProperties(before, after, direction, where, ctx, seen) {
+    const beforeProps = before.properties;
+    const afterProps = after.properties;
+    if (beforeProps === undefined && afterProps === undefined)
+        return;
+    const beforeRequired = new Set(before.required ?? []);
+    const afterRequired = new Set(after.required ?? []);
+    const names = new Set([...Object.keys(beforeProps ?? {}), ...Object.keys(afterProps ?? {})]);
+    for (const name of [...names].sort()) {
+        const from = asSchema(beforeProps?.[name]);
+        const to = asSchema(afterProps?.[name]);
+        const at = `${where}.${name}`;
+        if (from !== undefined && to === undefined) {
+            ctx.changes.push(direction === 'response'
+                ? breaking('OAS_RESPONSE_FIELD_REMOVED', `Response field "${name}" was removed.`, at)
+                : breaking('OAS_REQUEST_FIELD_REMOVED', `Request field "${name}" is no longer accepted.`, at));
+            continue;
+        }
+        if (from === undefined && to !== undefined) {
+            if (direction === 'response') {
+                ctx.changes.push(compatible('OAS_RESPONSE_FIELD_ADDED', `Response field "${name}" was added.`, at));
+            }
+            else {
+                ctx.changes.push(afterRequired.has(name)
+                    ? breaking('OAS_REQUEST_FIELD_ADDED_REQUIRED', `Required request field "${name}" was added.`, at)
+                    : compatible('OAS_REQUEST_FIELD_ADDED', `Optional request field "${name}" was added.`, at));
+            }
+            continue;
+        }
+        if (from === undefined || to === undefined)
+            continue;
+        const wasRequired = beforeRequired.has(name);
+        const isRequired = afterRequired.has(name);
+        if (!wasRequired && isRequired) {
+            ctx.changes.push(direction === 'request'
+                ? breaking('OAS_REQUEST_FIELD_NOW_REQUIRED', `Request field "${name}" became required.`, at)
+                : compatible('OAS_RESPONSE_FIELD_NOW_GUARANTEED', `Response field "${name}" is now always present.`, at));
+        }
+        else if (wasRequired && !isRequired) {
+            ctx.changes.push(direction === 'response'
+                ? breaking('OAS_RESPONSE_FIELD_NOW_OPTIONAL', `Response field "${name}" may now be absent.`, at)
+                : compatible('OAS_REQUEST_FIELD_NOW_OPTIONAL', `Request field "${name}" became optional.`, at));
+        }
+        diffSchema(from, to, direction, at, ctx, seen);
+    }
+}
+function diffTypes(before, after, direction, where, ctx) {
+    const from = typeSet(before);
+    const to = typeSet(after);
+    if (from.size === 0 && to.size === 0)
+        return;
+    const added = [...to].filter((t) => !from.has(t));
+    const removed = [...from].filter((t) => !to.has(t));
+    // Widening a response is breaking (a client that exhaustively handles the old
+    // types meets one it has never seen); widening a request is a relaxation.
+    for (const type of added) {
+        ctx.changes.push(direction === 'response'
+            ? breaking('OAS_TYPE_WIDENED', `Response may now be "${type}".`, where)
+            : compatible('OAS_TYPE_WIDENED', `Request now also accepts "${type}".`, where));
+    }
+    for (const type of removed) {
+        ctx.changes.push(direction === 'request'
+            ? breaking('OAS_TYPE_NARROWED', `Request no longer accepts "${type}".`, where)
+            : compatible('OAS_TYPE_NARROWED', `Response is no longer "${type}".`, where));
+    }
+}
+function diffEnum(before, after, direction, where, ctx) {
+    const from = before.enum;
+    const to = after.enum;
+    if (from === undefined && to === undefined)
+        return;
+    if (from === undefined || to === undefined) {
+        ctx.changes.push(from === undefined
+            ? (direction === 'request'
+                ? breaking('OAS_ENUM_INTRODUCED', 'The accepted values are now restricted to an enum.', where)
+                : compatible('OAS_ENUM_INTRODUCED', 'The returned values are now restricted to an enum.', where))
+            : (direction === 'response'
+                ? breaking('OAS_ENUM_REMOVED', 'The value is no longer restricted to a known set.', where)
+                : compatible('OAS_ENUM_REMOVED', 'Any value is now accepted.', where)));
+        return;
+    }
+    const beforeValues = new Set(from.map((v) => JSON.stringify(v)));
+    const afterValues = new Set(to.map((v) => JSON.stringify(v)));
+    for (const value of afterValues) {
+        if (beforeValues.has(value))
+            continue;
+        ctx.changes.push(direction === 'response'
+            ? breaking('OAS_ENUM_VALUE_ADDED', `Response may now be ${value}.`, where)
+            : compatible('OAS_ENUM_VALUE_ADDED', `Request now also accepts ${value}.`, where));
+    }
+    for (const value of beforeValues) {
+        if (afterValues.has(value))
+            continue;
+        ctx.changes.push(direction === 'request'
+            ? breaking('OAS_ENUM_VALUE_REMOVED', `Request no longer accepts ${value}.`, where)
+            : compatible('OAS_ENUM_VALUE_REMOVED', `Response is no longer ${value}.`, where));
+    }
+}
+/** `true`/`false` are legal schemas; treat them as "no constraints stated". */
+function asSchema(node) {
+    if (node === undefined)
+        return undefined;
+    return typeof node === 'boolean' ? (node ? {} : { not: {} }) : node;
+}
+function typeSet(schema) {
+    const declared = schema.type;
+    if (declared === undefined)
+        return new Set();
+    return new Set(Array.isArray(declared) ? declared : [declared]);
+}
+/** Follows `#/components/schemas/*` so the diff compares shapes, not pointers. */
+class Resolver {
+    #schemas;
+    constructor(document) {
+        this.#schemas = document.components?.schemas ?? {};
+    }
+    resolve(schema) {
+        let current = schema;
+        for (let hops = 0; hops < 16; hops++) {
+            const ref = current.$ref;
+            if (typeof ref !== 'string')
+                return current;
+            const name = ref.startsWith('#/components/schemas/') ? ref.slice('#/components/schemas/'.length) : null;
+            const target = name === null ? undefined : this.#schemas[name];
+            if (target === undefined)
+                return {};
+            current = target;
+        }
+        return {};
+    }
+}
+function breaking(code, message, location) {
+    return { kind: 'breaking', code, message, location };
+}
+function compatible(code, message, location) {
+    return { kind: 'compatible', code, message, location };
+}
+function documentation(code, message, location) {
+    return { kind: 'documentation', code, message, location };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/document.d.ts

@@ -0,0 +1,75 @@
+import type { AppGraph, PathSegment, RouteRecord } from '@erenthedeveloper0/zen-core';
+import { type DocDiagnostic } from './schema.ts';
+import type { ExternalDocs, OpenApiDocument, SecurityRequirement, SecurityScheme, ServerObject, TagObject } from './types.ts';
+/**
+ * `AppGraph → OpenAPIDocument` — rfcs/0001 §29.
+ *
+ * A pure function, and that is the architectural claim. Every other framework
+ * treats OpenAPI as an add-on that *re-describes* what the routes already say,
+ * which is why the documentation is always slightly wrong. Here the graph
+ * already contains every fact the document needs — paths, methods, param types,
+ * request and response schemas per status, tags, collections — so there is
+ * nothing to keep in sync because there is nothing duplicated.
+ *
+ * Nothing in this module runs per request. It is called once, from `onBoot`,
+ * against the frozen graph.
+ */
+export interface OpenApiOptions {
+    readonly title: string;
+    readonly version: string;
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly servers?: readonly ServerObject[] | undefined;
+    readonly tags?: readonly TagObject[] | undefined;
+    readonly externalDocs?: ExternalDocs | undefined;
+    readonly security?: readonly SecurityRequirement[] | undefined;
+    readonly securitySchemes?: Readonly<Record<string, SecurityScheme>> | undefined;
+    readonly license?: {
+        readonly name: string;
+        readonly identifier?: string;
+        readonly url?: string;
+    } | undefined;
+    readonly contact?: {
+        readonly name?: string;
+        readonly url?: string;
+        readonly email?: string;
+    } | undefined;
+    /**
+     * Document the RFC 9457 envelope Zen actually emits on the error path, as
+     * `4XX`/`5XX` responses. On by default: the error shape is a real part of the
+     * API contract, and leaving it undocumented is how clients end up parsing it
+     * by observation.
+     */
+    readonly problemDetails?: boolean | undefined;
+    /** Routes to leave out. The docs endpoints exclude themselves through this. */
+    readonly exclude?: ((route: RouteRecord) => boolean) | undefined;
+}
+export interface OpenApiResult {
+    readonly document: OpenApiDocument;
+    /**
+     * Everything the generator could not state with confidence — an undeclared
+     * response schema, an unconvertible library schema, an anonymous schema shared
+     * by four operations. Surfaced rather than silently papered over, because a
+     * document that quietly describes less than the API does is worse than one
+     * that says so.
+     */
+    readonly diagnostics: readonly DocDiagnostic[];
+}
+export declare function openapiDocument(graph: AppGraph, options: OpenApiOptions): OpenApiResult;
+export interface PathVariant {
+    readonly template: string;
+    readonly segments: readonly PathSegment[];
+    /** The optional parameter this variant adds, used to keep operationIds unique. */
+    readonly suffix: string | null;
+}
+/**
+ * `/posts/:slug?` becomes two paths, not one path with `required: false`.
+ *
+ * OpenAPI has no optional path parameter — the spec requires `required: true`
+ * for `in: 'path'` — so the only correct representation is two concrete paths,
+ * which is also exactly what the router does at build time (`expandOptional`,
+ * §5.2). A generated client therefore gets both call shapes instead of one that
+ * cannot be expressed.
+ */
+export declare function pathVariants(segments: readonly PathSegment[]): PathVariant[];
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAAqE,WAAW,EACxF,WAAW,EACZ,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,YAAY,EAAiB,eAAe,EAC0B,mBAAmB,EACzF,cAAc,EAAE,YAAY,EAAE,SAAS,EACxC,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAA;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,CAAA;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC7G,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IACzG;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,SAAS,CAAA;CACjE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAA;CAC/C;AA+BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAEvF;AA0hBD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAkB5E"}