@ddd-ts-kit/http 0.0.0-stage → 0.1.0

package/dist/openapi/compare.d.ts

@@ -0,0 +1,3 @@
+/** Code-unit order, not locale order: the output must not depend on the machine's locale. */
+export declare function compare(a: string, b: string): number;
+//# sourceMappingURL=compare.d.ts.map

package/dist/openapi/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/openapi/compare.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/openapi/compare.js

@@ -0,0 +1,5 @@
+/** Code-unit order, not locale order: the output must not depend on the machine's locale. */
+export function compare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+//# sourceMappingURL=compare.js.map

package/dist/openapi/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/openapi/compare.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,UAAU,OAAO,CAAC,CAAS,EAAE,CAAS;IAC1C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/openapi/definitions.d.ts

@@ -0,0 +1,14 @@
+import type { JsonSchema, Schema } from '@ddd-ts-kit/validation';
+/**
+ * Local definitions (`$defs`) of the embedded JSON Schemas are moved to `components.schemas`,
+ * because a `#/$defs/...` pointer means nothing once the schema sits inside a document.
+ */
+export declare class Definitions {
+    private readonly schemas;
+    private readonly sources;
+    embed(schema: Schema<unknown>): JsonSchema;
+    all(): Record<string, JsonSchema>;
+    /** Two different definitions sharing a name get distinct component names. */
+    private reserve;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/openapi/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/openapi/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIjE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,UAAU,CAgBzC;IAED,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAEhC;IAED,6EAA6E;IAC7E,OAAO,CAAC,OAAO;CAgBhB"}

package/dist/openapi/definitions.js

@@ -0,0 +1,61 @@
+import { isRecord } from '../support/is-record.js';
+import { compare } from './compare.js';
+/**
+ * Local definitions (`$defs`) of the embedded JSON Schemas are moved to `components.schemas`,
+ * because a `#/$defs/...` pointer means nothing once the schema sits inside a document.
+ */
+export class Definitions {
+    schemas = new Map();
+    sources = new Map();
+    embed(schema) {
+        const { $schema: _dialect, $defs, definitions, ...rest } = schema.toJsonSchema();
+        const local = { ...(isRecord(definitions) ? definitions : {}), ...(isRecord($defs) ? $defs : {}) };
+        const names = new Map();
+        for (const name of Object.keys(local).sort(compare)) {
+            names.set(name, this.reserve(name, JSON.stringify(local[name])));
+        }
+        for (const [name, component] of names) {
+            if (!this.schemas.has(component)) {
+                this.schemas.set(component, asSchema(rewriteRefs(local[name], names)));
+            }
+        }
+        return asSchema(rewriteRefs(rest, names));
+    }
+    all() {
+        return Object.fromEntries(this.schemas);
+    }
+    /** Two different definitions sharing a name get distinct component names. */
+    reserve(name, source) {
+        for (let attempt = 1;; attempt += 1) {
+            const candidate = attempt === 1 ? name : `${name}_${attempt}`;
+            const known = candidate === 'Problem' ? '' : this.sources.get(candidate);
+            if (known === undefined) {
+                this.sources.set(candidate, source);
+                return candidate;
+            }
+            if (known === source) {
+                return candidate;
+            }
+        }
+    }
+}
+function rewriteRefs(node, names) {
+    if (Array.isArray(node)) {
+        return node.map((item) => rewriteRefs(item, names));
+    }
+    if (!isRecord(node)) {
+        return node;
+    }
+    return Object.fromEntries(Object.entries(node).map(([key, value]) => {
+        if (key === '$ref' && typeof value === 'string') {
+            const local = /^#\/(?:\$defs|definitions)\/(.+)$/.exec(value);
+            const component = local?.[1] === undefined ? undefined : names.get(local[1]);
+            return [key, component === undefined ? value : `#/components/schemas/${component}`];
+        }
+        return [key, rewriteRefs(value, names)];
+    }));
+}
+function asSchema(node) {
+    return isRecord(node) ? node : {};
+}
+//# sourceMappingURL=definitions.js.map

package/dist/openapi/definitions.js.map

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

package/dist/openapi/generate-open-api.d.ts

@@ -0,0 +1,21 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+import type { ErrorMapper } from '../error/error-mapper.js';
+import type { Route } from '../route/route.js';
+import type { OpenApiDocument } from './open-api-document.js';
+import type { OpenApiInfo } from './open-api-info.js';
+import type { OpenApiServer } from './open-api-server.js';
+export interface GenerateOpenApiOptions {
+    readonly info: OpenApiInfo;
+    readonly servers?: readonly OpenApiServer[];
+    readonly routes: readonly Route[];
+    readonly securitySchemes?: Readonly<Record<string, JsonSchema>>;
+    /**
+     * The document-wide default requirement. Every route declares its own `security`, which
+     * overrides it in each operation: it only speaks to readers of the document as a whole.
+     */
+    readonly security?: readonly string[];
+    /** Must be the mapper the server runs with, or the documented statuses lie. */
+    readonly errorMapper?: ErrorMapper;
+}
+export declare function generateOpenApi(options: GenerateOpenApiOptions): OpenApiDocument;
+//# sourceMappingURL=generate-open-api.d.ts.map

package/dist/openapi/generate-open-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-open-api.d.ts","sourceRoot":"","sources":["../../src/openapi/generate-open-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAChE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAyBhF"}

package/dist/openapi/generate-open-api.js

@@ -0,0 +1,43 @@
+import { createErrorMapper } from '../error/create-error-mapper.js';
+import { assertUniqueRoutes } from '../route/assert-unique-routes.js';
+import { compare } from './compare.js';
+import { Definitions } from './definitions.js';
+import { openApiPath } from './open-api-path.js';
+import { pathItems } from './path-items.js';
+import { PROBLEM_SCHEMA } from './problem-schema.js';
+import { requirement } from './requirement.js';
+// The order OpenAPI tooling conventionally prints operations in.
+const METHOD_ORDER = ['GET', 'PUT', 'POST', 'DELETE', 'OPTIONS', 'HEAD', 'PATCH'];
+export function generateOpenApi(options) {
+    assertUniqueRoutes(options.routes);
+    const definitions = new Definitions();
+    const routes = sortedRoutes(options.routes);
+    const paths = pathItems(routes, options.errorMapper ?? createErrorMapper(), definitions);
+    const tags = [...new Set(routes.flatMap((route) => route.tags ?? []))].sort(compare);
+    const securitySchemes = options.securitySchemes;
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: options.info.title,
+            version: options.info.version,
+            ...(options.info.description === undefined ? {} : { description: options.info.description }),
+        },
+        ...(options.servers === undefined ? {} : { servers: options.servers }),
+        ...(tags.length === 0 ? {} : { tags: tags.map((name) => ({ name })) }),
+        ...(options.security === undefined ? {} : { security: requirement(options.security) }),
+        paths,
+        components: {
+            schemas: sortKeys({ ...definitions.all(), Problem: PROBLEM_SCHEMA }),
+            ...(securitySchemes === undefined ? {} : { securitySchemes: sortKeys(securitySchemes) }),
+        },
+    };
+}
+/** Sorting first makes every later decision (component naming included) order independent. */
+function sortedRoutes(routes) {
+    return [...routes].sort((a, b) => compare(openApiPath(a.path), openApiPath(b.path)) ||
+        METHOD_ORDER.indexOf(a.method) - METHOD_ORDER.indexOf(b.method));
+}
+function sortKeys(record) {
+    return Object.fromEntries(Object.entries(record).sort(([a], [b]) => compare(a, b)));
+}
+//# sourceMappingURL=generate-open-api.js.map

package/dist/openapi/generate-open-api.js.map

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

package/dist/openapi/open-api-document.d.ts

@@ -0,0 +1,18 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+import type { OpenApiInfo } from './open-api-info.js';
+import type { OpenApiServer } from './open-api-server.js';
+export interface OpenApiDocument {
+    readonly openapi: '3.1.0';
+    readonly info: OpenApiInfo;
+    readonly servers?: readonly OpenApiServer[];
+    readonly tags?: readonly {
+        readonly name: string;
+    }[];
+    readonly security?: readonly Record<string, string[]>[];
+    readonly paths: Record<string, Record<string, JsonSchema>>;
+    readonly components: {
+        readonly schemas: Record<string, JsonSchema>;
+        readonly securitySchemes?: Record<string, JsonSchema>;
+    };
+}
+//# sourceMappingURL=open-api-document.d.ts.map

package/dist/openapi/open-api-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-document.d.ts","sourceRoot":"","sources":["../../src/openapi/open-api-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACvD,CAAC;CACH"}

package/dist/openapi/open-api-document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-api-document.js.map

package/dist/openapi/open-api-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-document.js","sourceRoot":"","sources":["../../src/openapi/open-api-document.ts"],"names":[],"mappings":""}

package/dist/openapi/open-api-info.d.ts

@@ -0,0 +1,6 @@
+export interface OpenApiInfo {
+    readonly title: string;
+    readonly version: string;
+    readonly description?: string;
+}
+//# sourceMappingURL=open-api-info.d.ts.map

package/dist/openapi/open-api-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-info.d.ts","sourceRoot":"","sources":["../../src/openapi/open-api-info.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/openapi/open-api-info.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-api-info.js.map

package/dist/openapi/open-api-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-info.js","sourceRoot":"","sources":["../../src/openapi/open-api-info.ts"],"names":[],"mappings":""}

package/dist/openapi/open-api-path.d.ts

@@ -0,0 +1,2 @@
+export declare function openApiPath(path: string): string;
+//# sourceMappingURL=open-api-path.d.ts.map

package/dist/openapi/open-api-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-path.d.ts","sourceRoot":"","sources":["../../src/openapi/open-api-path.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/openapi/open-api-path.js

@@ -0,0 +1,4 @@
+export function openApiPath(path) {
+    return path.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, '{$1}');
+}
+//# sourceMappingURL=open-api-path.js.map

package/dist/openapi/open-api-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-path.js","sourceRoot":"","sources":["../../src/openapi/open-api-path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/openapi/open-api-server.d.ts

@@ -0,0 +1,5 @@
+export interface OpenApiServer {
+    readonly url: string;
+    readonly description?: string;
+}
+//# sourceMappingURL=open-api-server.d.ts.map

package/dist/openapi/open-api-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-server.d.ts","sourceRoot":"","sources":["../../src/openapi/open-api-server.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/openapi/open-api-server.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-api-server.js.map

package/dist/openapi/open-api-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api-server.js","sourceRoot":"","sources":["../../src/openapi/open-api-server.ts"],"names":[],"mappings":""}

package/dist/openapi/path-items.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+import type { ErrorMapper } from '../error/error-mapper.js';
+import type { Route } from '../route/route.js';
+import type { Definitions } from './definitions.js';
+/** The `paths` of the document: one item per path, one operation per method. */
+export declare function pathItems(routes: readonly Route[], mapper: ErrorMapper, definitions: Definitions): Record<string, Record<string, JsonSchema>>;
+//# sourceMappingURL=path-items.d.ts.map

package/dist/openapi/path-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-items.d.ts","sourceRoot":"","sources":["../../src/openapi/path-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,gFAAgF;AAChF,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAY5C"}

package/dist/openapi/path-items.js

@@ -0,0 +1,43 @@
+import { openApiPath } from './open-api-path.js';
+import { pathParameters } from './path-parameters.js';
+import { requirement } from './requirement.js';
+import { responses } from './responses.js';
+import { schemaParameters } from './schema-parameters.js';
+/** The `paths` of the document: one item per path, one operation per method. */
+export function pathItems(routes, mapper, definitions) {
+    const paths = new Map();
+    for (const route of routes) {
+        const path = openApiPath(route.path);
+        const item = paths.get(path) ?? new Map();
+        item.set(route.method.toLowerCase(), operation(route, mapper, definitions));
+        paths.set(path, item);
+    }
+    return Object.fromEntries([...paths].map(([path, item]) => [path, Object.fromEntries(item)]));
+}
+function operation(route, mapper, definitions) {
+    const request = route.request ?? {};
+    const parameters = [
+        ...pathParameters(route.path, request.params, definitions),
+        ...schemaParameters('query', request.query, definitions),
+        ...schemaParameters('header', request.headers, definitions),
+    ];
+    return {
+        operationId: route.operationId,
+        summary: route.summary,
+        ...(route.description === undefined ? {} : { description: route.description }),
+        ...(route.tags === undefined ? {} : { tags: [...route.tags] }),
+        ...(route.deprecated === true ? { deprecated: true } : {}),
+        security: route.security === false ? [] : requirement(route.security),
+        ...(parameters.length === 0 ? {} : { parameters }),
+        ...(request.body === undefined
+            ? {}
+            : {
+                requestBody: {
+                    required: true,
+                    content: { 'application/json': { schema: definitions.embed(request.body) } },
+                },
+            }),
+        responses: responses(route, mapper, definitions),
+    };
+}
+//# sourceMappingURL=path-items.js.map

package/dist/openapi/path-items.js.map

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

package/dist/openapi/path-parameters.d.ts

@@ -0,0 +1,4 @@
+import type { JsonSchema, Schema } from '@ddd-ts-kit/validation';
+import type { Definitions } from './definitions.js';
+export declare function pathParameters(path: string, schema: Schema<unknown> | undefined, definitions: Definitions): JsonSchema[];
+//# sourceMappingURL=path-parameters.d.ts.map

package/dist/openapi/path-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-parameters.d.ts","sourceRoot":"","sources":["../../src/openapi/path-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,EACnC,WAAW,EAAE,WAAW,GACvB,UAAU,EAAE,CAad"}

package/dist/openapi/path-parameters.js

@@ -0,0 +1,13 @@
+import { schemaParameters } from './schema-parameters.js';
+export function pathParameters(path, schema, definitions) {
+    const described = new Map(schemaParameters('path', schema, definitions).map((parameter) => [parameter['name'], parameter]));
+    // The path is the authority on which parameters exist; the schema only refines their type.
+    return [...path.matchAll(/:([A-Za-z_][A-Za-z0-9_]*)/g)].map((match) => ({
+        name: match[1],
+        in: 'path',
+        schema: { type: 'string' },
+        ...described.get(match[1]),
+        required: true,
+    }));
+}
+//# sourceMappingURL=path-parameters.js.map

package/dist/openapi/path-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-parameters.js","sourceRoot":"","sources":["../../src/openapi/path-parameters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,MAAmC,EACnC,WAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CACjG,CAAC;IAEF,2FAA2F;IAC3F,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/openapi/problem-schema.d.ts

@@ -0,0 +1,3 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+export declare const PROBLEM_SCHEMA: JsonSchema;
+//# sourceMappingURL=problem-schema.d.ts.map

package/dist/openapi/problem-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-schema.d.ts","sourceRoot":"","sources":["../../src/openapi/problem-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,UAyB5B,CAAC"}

package/dist/openapi/problem-schema.js

@@ -0,0 +1,27 @@
+export const PROBLEM_SCHEMA = {
+    type: 'object',
+    description: 'Problem details (RFC 9457) with a stable machine-readable code.',
+    required: ['type', 'title', 'status', 'code', 'requestId'],
+    properties: {
+        type: { type: 'string', description: 'URI identifying the kind of problem.' },
+        title: { type: 'string' },
+        status: { type: 'integer' },
+        code: { type: 'string', description: 'Stable error code; branch on this, not on the title.' },
+        detail: { type: 'string' },
+        issues: {
+            type: 'array',
+            description: 'Present when the request failed validation.',
+            items: {
+                type: 'object',
+                required: ['path', 'code', 'message'],
+                properties: {
+                    path: { type: 'string', description: 'Dotted path, for example body.items.0.sku.' },
+                    code: { type: 'string' },
+                    message: { type: 'string' },
+                },
+            },
+        },
+        requestId: { type: 'string' },
+    },
+};
+//# sourceMappingURL=problem-schema.js.map

package/dist/openapi/problem-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-schema.js","sourceRoot":"","sources":["../../src/openapi/problem-schema.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iEAAiE;IAC9E,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC;IAC1D,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;QAC7F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,6CAA6C;YAC1D,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;gBACrC,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;oBACnF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;aACF;SACF;QACD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC9B;CACF,CAAC"}

package/dist/openapi/requirement.d.ts

@@ -0,0 +1,3 @@
+/** A security requirement: every named scheme, with no scope. */
+export declare function requirement(schemes: readonly string[]): Record<string, string[]>[];
+//# sourceMappingURL=requirement.d.ts.map

package/dist/openapi/requirement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement.d.ts","sourceRoot":"","sources":["../../src/openapi/requirement.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAElF"}

package/dist/openapi/requirement.js

@@ -0,0 +1,5 @@
+/** A security requirement: every named scheme, with no scope. */
+export function requirement(schemes) {
+    return schemes.map((scheme) => ({ [scheme]: [] }));
+}
+//# sourceMappingURL=requirement.js.map

package/dist/openapi/requirement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement.js","sourceRoot":"","sources":["../../src/openapi/requirement.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/openapi/responses.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchema } from '@ddd-ts-kit/validation';
+import type { ErrorMapper } from '../error/error-mapper.js';
+import type { Route } from '../route/route.js';
+import type { Definitions } from './definitions.js';
+/** The declared responses, plus one problem response per status of the declared error codes. */
+export declare function responses(route: Route, mapper: ErrorMapper, definitions: Definitions): JsonSchema;
+//# sourceMappingURL=responses.d.ts.map

package/dist/openapi/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/openapi/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,UAAU,CAUjG"}

package/dist/openapi/responses.js

@@ -0,0 +1,50 @@
+import { statusTitle } from '../error/status-title.js';
+import { isRecord } from '../support/is-record.js';
+import { compare } from './compare.js';
+const VALIDATION_FAILED = 'VALIDATION_FAILED';
+const PROBLEM_REF = { $ref: '#/components/schemas/Problem' };
+/** The declared responses, plus one problem response per status of the declared error codes. */
+export function responses(route, mapper, definitions) {
+    const byStatus = declaredResponses(route, definitions);
+    for (const [status, codes] of errorCodesByStatus(route, mapper)) {
+        byStatus.set(status, problemResponse(status, codes, byStatus.get(status)));
+    }
+    const statuses = [...byStatus.keys()].sort((a, b) => a - b);
+    return Object.fromEntries(statuses.map((status) => [String(status), byStatus.get(status)]));
+}
+function declaredResponses(route, definitions) {
+    const byStatus = new Map();
+    // A copy has a string index, which is how the statuses are enumerated.
+    const declaredByKey = { ...route.responses };
+    for (const [key, declared] of Object.entries(declaredByKey)) {
+        byStatus.set(Number(key), {
+            description: declared.description,
+            ...(declared.body === undefined
+                ? {}
+                : { content: { 'application/json': { schema: definitions.embed(declared.body) } } }),
+        });
+    }
+    return byStatus;
+}
+function errorCodesByStatus(route, mapper) {
+    const validatesInput = Object.values(route.request ?? {}).some((schema) => schema !== undefined);
+    const codes = new Set([...(route.errors ?? []), ...(validatesInput ? [VALIDATION_FAILED] : [])]);
+    const codesByStatus = new Map();
+    for (const code of codes) {
+        const status = mapper.statusOf(code);
+        codesByStatus.set(status, [...(codesByStatus.get(status) ?? []), code]);
+    }
+    return codesByStatus;
+}
+function problemResponse(status, codes, declared) {
+    const sorted = [...codes].sort(compare);
+    return {
+        description: declared === undefined ? `${statusTitle(status)}. Error codes: ${sorted.join(', ')}.` : declared['description'],
+        content: {
+            ...(isRecord(declared?.['content']) ? declared['content'] : {}),
+            'application/problem+json': { schema: PROBLEM_REF },
+        },
+        'x-error-codes': sorted,
+    };
+}
+//# sourceMappingURL=responses.js.map

package/dist/openapi/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/openapi/responses.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAC9C,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;AAE7D,gGAAgG;AAChG,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,MAAmB,EAAE,WAAwB;IACnF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEvD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAY,EAAE,WAAwB;IAC/D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC/C,uEAAuE;IACvE,MAAM,aAAa,GAA2C,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAErF,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;YACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAC7B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC;SACvF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAY,EAAE,MAAmB;IAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,KAAwB,EAAE,QAAgC;IACjG,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO;QACL,WAAW,EACT,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACjH,OAAO,EAAE;YACP,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,0BAA0B,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;SACpD;QACD,eAAe,EAAE,MAAM;KACxB,CAAC;AACJ,CAAC"}

package/dist/openapi/schema-parameters.d.ts

@@ -0,0 +1,5 @@
+import type { JsonSchema, Schema } from '@ddd-ts-kit/validation';
+import type { Definitions } from './definitions.js';
+/** One OpenAPI parameter per property of the schema of a request part. */
+export declare function schemaParameters(location: 'path' | 'query' | 'header', schema: Schema<unknown> | undefined, definitions: Definitions): JsonSchema[];
+//# sourceMappingURL=schema-parameters.d.ts.map

package/dist/openapi/schema-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parameters.d.ts","sourceRoot":"","sources":["../../src/openapi/schema-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EACrC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,EACnC,WAAW,EAAE,WAAW,GACvB,UAAU,EAAE,CAyBd"}

package/dist/openapi/schema-parameters.js

@@ -0,0 +1,24 @@
+import { isRecord } from '../support/is-record.js';
+/** One OpenAPI parameter per property of the schema of a request part. */
+export function schemaParameters(location, schema, definitions) {
+    if (schema === undefined) {
+        return [];
+    }
+    const embedded = definitions.embed(schema);
+    const properties = embedded['properties'];
+    if (!isRecord(properties)) {
+        return [];
+    }
+    const required = Array.isArray(embedded['required']) ? embedded['required'] : [];
+    return Object.entries(properties).map(([name, property]) => {
+        const description = isRecord(property) ? property['description'] : undefined;
+        return {
+            name,
+            in: location,
+            ...(typeof description === 'string' ? { description } : {}),
+            required: required.includes(name),
+            schema: property,
+        };
+    });
+}
+//# sourceMappingURL=schema-parameters.js.map

package/dist/openapi/schema-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parameters.js","sourceRoot":"","sources":["../../src/openapi/schema-parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAC9B,QAAqC,EACrC,MAAmC,EACnC,WAAwB;IAExB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE1C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjF,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;QACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7E,OAAO;YACL,IAAI;YACJ,EAAE,EAAE,QAAQ;YACZ,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/openapi/stringify-open-api.d.ts

@@ -0,0 +1,4 @@
+import type { OpenApiDocument } from './open-api-document.js';
+/** The exact bytes to commit: two-space JSON and a trailing newline. */
+export declare function stringifyOpenApi(document: OpenApiDocument): string;
+//# sourceMappingURL=stringify-open-api.d.ts.map

package/dist/openapi/stringify-open-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-open-api.d.ts","sourceRoot":"","sources":["../../src/openapi/stringify-open-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAElE"}

package/dist/openapi/stringify-open-api.js

@@ -0,0 +1,5 @@
+/** The exact bytes to commit: two-space JSON and a trailing newline. */
+export function stringifyOpenApi(document) {
+    return `${JSON.stringify(document, null, 2)}\n`;
+}
+//# sourceMappingURL=stringify-open-api.js.map

package/dist/openapi/stringify-open-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-open-api.js","sourceRoot":"","sources":["../../src/openapi/stringify-open-api.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACxD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,7 @@
+export { checkOpenApiDrift } from './openapi/check-open-api-drift.js';
+export { generateOpenApi, type GenerateOpenApiOptions } from './openapi/generate-open-api.js';
+export type { OpenApiDocument } from './openapi/open-api-document.js';
+export type { OpenApiInfo } from './openapi/open-api-info.js';
+export type { OpenApiServer } from './openapi/open-api-server.js';
+export { stringifyOpenApi } from './openapi/stringify-open-api.js';
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/openapi.js

@@ -0,0 +1,4 @@
+export { checkOpenApiDrift } from './openapi/check-open-api-drift.js';
+export { generateOpenApi } from './openapi/generate-open-api.js';
+export { stringifyOpenApi } from './openapi/stringify-open-api.js';
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAA+B,MAAM,gCAAgC,CAAC;AAI9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/pagination/issue.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationIssue } from '@ddd-ts-kit/validation';
+export declare function issue(path: string, code: string, message: string): ValidationIssue;
+//# sourceMappingURL=issue.d.ts.map

package/dist/pagination/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../src/pagination/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAElF"}

package/dist/pagination/issue.js

@@ -0,0 +1,4 @@
+export function issue(path, code, message) {
+    return { path, code, message };
+}
+//# sourceMappingURL=issue.js.map