@modularizer/plat-client 0.4.0

package/dist/types/errors.d.ts

@@ -0,0 +1,86 @@
+import type { ClientRouteLike } from './client-route';
+export interface ErrorPayload {
+    code?: string;
+    message?: string;
+    details?: unknown;
+    [key: string]: unknown;
+}
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly data?: any;
+    constructor(statusCode: number, message: string, data?: any);
+}
+export declare abstract class HttpProxyError extends Error {
+    readonly route: ClientRouteLike | undefined;
+    readonly url: string;
+    readonly method: string;
+    readonly status: number | undefined;
+    readonly statusText: string | undefined;
+    readonly headers: Headers | undefined;
+    readonly bodyText: string | undefined;
+    readonly bodyJson: unknown;
+    readonly cause: unknown;
+    protected constructor(args: {
+        name: string;
+        message: string;
+        route?: ClientRouteLike;
+        url: string;
+        method: string;
+        status: number | undefined;
+        statusText: string | undefined;
+        headers: Headers | undefined;
+        bodyText: string | undefined;
+        bodyJson: unknown;
+        cause: unknown;
+    });
+}
+export declare class ClientError extends HttpProxyError {
+    readonly payload: ErrorPayload | undefined;
+    constructor(args: {
+        route?: ClientRouteLike;
+        url: string;
+        method: string;
+        status: number;
+        statusText: string;
+        headers: Headers;
+        bodyText: string | undefined;
+        bodyJson: unknown;
+    });
+    get isUnauthorized(): boolean;
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+    get isConflict(): boolean;
+    get isUnprocessable(): boolean;
+    get isRateLimited(): boolean;
+    get retryAfterMs(): number | undefined;
+}
+export declare class ServerError extends HttpProxyError {
+    readonly payload: ErrorPayload | undefined;
+    constructor(args: {
+        route?: ClientRouteLike;
+        url: string;
+        method: string;
+        status: number;
+        statusText: string;
+        headers: Headers;
+        bodyText: string | undefined;
+        bodyJson: unknown;
+    });
+}
+export declare class NetworkError extends HttpProxyError {
+    constructor(args: {
+        route?: ClientRouteLike;
+        url: string;
+        method: string;
+        cause: unknown;
+    });
+}
+export declare class TimeoutError extends HttpProxyError {
+    constructor(args: {
+        route?: ClientRouteLike;
+        url: string;
+        method: string;
+        cause: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

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

package/dist/types/errors.js

@@ -0,0 +1,153 @@
+function asErrorPayload(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    return value;
+}
+function buildHttpErrorMessage(status, statusText, bodyJson, bodyText) {
+    const jsonMessage = bodyJson &&
+        typeof bodyJson === 'object' &&
+        'message' in bodyJson &&
+        typeof bodyJson.message === 'string'
+        ? bodyJson.message
+        : undefined;
+    return jsonMessage || bodyText || `HTTP ${status} ${statusText}`;
+}
+export class HttpError extends Error {
+    statusCode;
+    data;
+    constructor(statusCode, message, data) {
+        super(message);
+        this.name = 'HttpError';
+        this.statusCode = statusCode;
+        this.data = data;
+    }
+}
+export class HttpProxyError extends Error {
+    route;
+    url;
+    method;
+    status;
+    statusText;
+    headers;
+    bodyText;
+    bodyJson;
+    cause;
+    constructor(args) {
+        super(args.message, { cause: args.cause });
+        this.name = args.name;
+        this.route = args.route;
+        this.url = args.url;
+        this.method = args.method;
+        this.status = args.status;
+        this.statusText = args.statusText;
+        this.headers = args.headers;
+        this.bodyText = args.bodyText;
+        this.bodyJson = args.bodyJson;
+        this.cause = args.cause;
+    }
+}
+export class ClientError extends HttpProxyError {
+    payload;
+    constructor(args) {
+        super({
+            name: 'ClientError',
+            message: buildHttpErrorMessage(args.status, args.statusText, args.bodyJson, args.bodyText),
+            route: args.route,
+            url: args.url,
+            method: args.method,
+            status: args.status,
+            statusText: args.statusText,
+            headers: args.headers,
+            bodyText: args.bodyText,
+            bodyJson: args.bodyJson,
+            cause: undefined,
+        });
+        this.payload = asErrorPayload(args.bodyJson);
+    }
+    get isUnauthorized() {
+        return this.status === 401;
+    }
+    get isForbidden() {
+        return this.status === 403;
+    }
+    get isNotFound() {
+        return this.status === 404;
+    }
+    get isConflict() {
+        return this.status === 409;
+    }
+    get isUnprocessable() {
+        return this.status === 422;
+    }
+    get isRateLimited() {
+        return this.status === 429;
+    }
+    get retryAfterMs() {
+        const raw = this.headers?.get('retry-after');
+        if (!raw)
+            return undefined;
+        const seconds = Number(raw);
+        if (Number.isFinite(seconds)) {
+            return Math.max(0, seconds * 1000);
+        }
+        const dateMs = Date.parse(raw);
+        if (Number.isFinite(dateMs)) {
+            return Math.max(0, dateMs - Date.now());
+        }
+        return undefined;
+    }
+}
+export class ServerError extends HttpProxyError {
+    payload;
+    constructor(args) {
+        super({
+            name: 'ServerError',
+            message: buildHttpErrorMessage(args.status, args.statusText, args.bodyJson, args.bodyText),
+            route: args.route,
+            url: args.url,
+            method: args.method,
+            status: args.status,
+            statusText: args.statusText,
+            headers: args.headers,
+            bodyText: args.bodyText,
+            bodyJson: args.bodyJson,
+            cause: undefined,
+        });
+        this.payload = asErrorPayload(args.bodyJson);
+    }
+}
+export class NetworkError extends HttpProxyError {
+    constructor(args) {
+        super({
+            name: 'NetworkError',
+            message: `Network error calling ${args.method} ${args.url}`,
+            route: args.route,
+            url: args.url,
+            method: args.method,
+            status: undefined,
+            statusText: undefined,
+            headers: undefined,
+            bodyText: undefined,
+            bodyJson: undefined,
+            cause: args.cause,
+        });
+    }
+}
+export class TimeoutError extends HttpProxyError {
+    constructor(args) {
+        super({
+            name: 'TimeoutError',
+            message: `Timed out calling ${args.method} ${args.url}`,
+            route: args.route,
+            url: args.url,
+            method: args.method,
+            status: undefined,
+            statusText: undefined,
+            headers: undefined,
+            bodyText: undefined,
+            bodyJson: undefined,
+            cause: args.cause,
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

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

package/dist/types/http.d.ts

@@ -0,0 +1,80 @@
+/** A header value that will be auto-coerced to a string at request time. */
+export type HeaderValue = string | number | boolean;
+/** Common MIME types for Content-Type / Accept headers. */
+export declare const ContentTypes: {
+    readonly JSON: "application/json";
+    readonly FORM: "application/x-www-form-urlencoded";
+    readonly MULTIPART: "multipart/form-data";
+    readonly TEXT: "text/plain";
+    readonly HTML: "text/html";
+    readonly CSV: "text/csv";
+    readonly XML: "application/xml";
+    readonly BINARY: "application/octet-stream";
+};
+export type ContentType = typeof ContentTypes[keyof typeof ContentTypes];
+export type ContentTypeValue = ContentType | (string & {});
+/** Common authorization schemes. */
+export declare const AuthSchemes: {
+    readonly BEARER: "Bearer";
+    readonly BASIC: "Basic";
+};
+export type AuthScheme = typeof AuthSchemes[keyof typeof AuthSchemes];
+export type AuthorizationValue = `${AuthScheme} ${string}` | (string & {});
+/** Common Cache-Control directives. */
+export declare const CacheDirectives: {
+    readonly NO_CACHE: "no-cache";
+    readonly NO_STORE: "no-store";
+    readonly NO_TRANSFORM: "no-transform";
+    readonly MAX_AGE_0: "max-age=0";
+};
+export type CacheDirective = typeof CacheDirectives[keyof typeof CacheDirectives];
+export type CacheControlValue = CacheDirective | `max-age=${number}` | (string & {});
+/** Well-known HTTP headers with narrowed value types. */
+export interface WellKnownHeaders {
+    'Content-Type'?: ContentTypeValue;
+    'Accept'?: ContentTypeValue;
+    'Authorization'?: AuthorizationValue;
+    'Cache-Control'?: CacheControlValue;
+    'If-None-Match'?: string;
+    'If-Modified-Since'?: string;
+    'X-Request-ID'?: string;
+    [key: string]: HeaderValue | undefined;
+}
+/**
+ * Typed HTTP headers: well-known headers get narrowed value types,
+ * custom headers (TCustom) are merged in, and any unknown header
+ * falls back to HeaderValue.
+ */
+export type TypedHeaders<TCustom extends Record<string, HeaderValue | undefined> = {}> = WellKnownHeaders & TCustom & Record<string, HeaderValue | undefined>;
+export declare const HttpMethods: {
+    readonly GET: "GET";
+    readonly POST: "POST";
+    readonly PUT: "PUT";
+    readonly PATCH: "PATCH";
+    readonly DELETE: "DELETE";
+};
+export type HttpMethod = typeof HttpMethods[keyof typeof HttpMethods];
+/** Property names reserved by the OpenAPIClient proxy system. */
+export declare const ProxyProps: {
+    readonly ROOT: "root";
+    readonly CLIENT: "client";
+    readonly SPEC: "spec";
+    readonly ROUTES: "routes";
+    readonly CHILDREN: "children";
+    readonly THEN: "then";
+};
+export type ProxyProp = typeof ProxyProps[keyof typeof ProxyProps];
+/** OpenAPI parameter location values. */
+export declare const ParamLocations: {
+    readonly QUERY: "query";
+    readonly PATH: "path";
+    readonly HEADER: "header";
+    readonly COOKIE: "cookie";
+};
+export type ParamLocation = typeof ParamLocations[keyof typeof ParamLocations];
+/**
+ * All names reserved by the OpenAPIClient and its proxy system.
+ * The plat server should reject routes/methods whose names collide with these.
+ */
+export declare const RESERVED_ROUTE_NAMES: readonly string[];
+//# sourceMappingURL=http.d.ts.map

package/dist/types/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../typescript/src/types/http.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1D,oCAAoC;AACpC,eAAO,MAAM,WAAW;;;CAGd,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1E,uCAAuC;AACvC,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,WAAW,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEpF,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,eAAe,CAAC,EAAE,iBAAiB,CAAA;IACnC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAA;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,EAAE,IACnF,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAAA;AAItE,eAAO,MAAM,WAAW;;;;;;CAMd,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE,yCAAyC;AACzC,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAOxC,CAAC"}

package/dist/types/http.js

@@ -0,0 +1,61 @@
+// ── Header types ──────────────────────────────────────────
+/** Common MIME types for Content-Type / Accept headers. */
+export const ContentTypes = {
+    JSON: 'application/json',
+    FORM: 'application/x-www-form-urlencoded',
+    MULTIPART: 'multipart/form-data',
+    TEXT: 'text/plain',
+    HTML: 'text/html',
+    CSV: 'text/csv',
+    XML: 'application/xml',
+    BINARY: 'application/octet-stream',
+};
+/** Common authorization schemes. */
+export const AuthSchemes = {
+    BEARER: 'Bearer',
+    BASIC: 'Basic',
+};
+/** Common Cache-Control directives. */
+export const CacheDirectives = {
+    NO_CACHE: 'no-cache',
+    NO_STORE: 'no-store',
+    NO_TRANSFORM: 'no-transform',
+    MAX_AGE_0: 'max-age=0',
+};
+// ── HTTP methods ──────────────────────────────────────────
+export const HttpMethods = {
+    GET: 'GET',
+    POST: 'POST',
+    PUT: 'PUT',
+    PATCH: 'PATCH',
+    DELETE: 'DELETE',
+};
+/** Property names reserved by the OpenAPIClient proxy system. */
+export const ProxyProps = {
+    ROOT: 'root',
+    CLIENT: 'client',
+    SPEC: 'spec',
+    ROUTES: 'routes',
+    CHILDREN: 'children',
+    THEN: 'then',
+};
+/** OpenAPI parameter location values. */
+export const ParamLocations = {
+    QUERY: 'query',
+    PATH: 'path',
+    HEADER: 'header',
+    COOKIE: 'cookie',
+};
+/**
+ * All names reserved by the OpenAPIClient and its proxy system.
+ * The plat server should reject routes/methods whose names collide with these.
+ */
+export const RESERVED_ROUTE_NAMES = [
+    ...Object.values(ProxyProps),
+    ...Object.values(HttpMethods).map(m => m.toLowerCase()),
+    // Native function properties that the proxy falls through to
+    'bind', 'call', 'apply', 'toString', 'valueOf',
+    'constructor', 'prototype', 'length', 'name',
+    'tools', 'buildHeaders',
+];
+//# sourceMappingURL=http.js.map

package/dist/types/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../typescript/src/types/http.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAK7D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,mCAAmC;IACzC,SAAS,EAAE,qBAAqB;IAChC,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,iBAAiB;IACtB,MAAM,EAAE,0BAA0B;CAC5B,CAAC;AAIX,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACR,CAAC;AAIX,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;CAChB,CAAC;AAwBX,6DAA6D;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACV,CAAC;AAGX,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;CACN,CAAC;AAGX,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACV,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACnD,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;IAC5B,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,6DAA6D;IAC7D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS;IAC9C,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM;IAC5C,OAAO,EAAE,cAAc;CACjB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from './client';
+export * from './client-route';
+export * from './endpoints';
+export * from './errors';
+export * from './http';
+export * from './openapi';
+export * from './opts';
+export * from './plugins';
+export * from './tools';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../typescript/src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,10 @@
+export * from './client.js';
+export * from './client-route.js';
+export * from './endpoints.js';
+export * from './errors.js';
+export * from './http.js';
+export * from './openapi.js';
+export * from './opts.js';
+export * from './plugins.js';
+export * from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../typescript/src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/dist/types/openapi.d.ts

@@ -0,0 +1,220 @@
+/**
+ * OpenAPI 3.x spec type definitions.
+ *
+ * Every piece of the spec has its own exported interface so that
+ * consumers can reference exactly the part they need.
+ *
+ * Designed to work with both wide types (plain objects) and narrow
+ * `as const` literals for full type-level inference.
+ */
+export interface OpenAPISchema {
+    readonly type?: string;
+    readonly format?: string;
+    readonly enum?: readonly (string | number | boolean)[];
+    readonly const?: string | number | boolean;
+    readonly properties?: Readonly<Record<string, OpenAPISchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean | OpenAPISchema;
+    readonly items?: OpenAPISchema;
+    readonly prefixItems?: readonly OpenAPISchema[];
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly uniqueItems?: boolean;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly exclusiveMinimum?: number | boolean;
+    readonly exclusiveMaximum?: number | boolean;
+    readonly multipleOf?: number;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly default?: unknown;
+    readonly examples?: readonly unknown[];
+    readonly description?: string;
+    readonly title?: string;
+    readonly nullable?: boolean;
+    readonly readOnly?: boolean;
+    readonly writeOnly?: boolean;
+    readonly deprecated?: boolean;
+    readonly $ref?: string;
+    readonly allOf?: readonly OpenAPISchema[];
+    readonly oneOf?: readonly OpenAPISchema[];
+    readonly anyOf?: readonly OpenAPISchema[];
+    readonly not?: OpenAPISchema;
+    readonly discriminator?: OpenAPIDiscriminator;
+}
+export interface OpenAPIDiscriminator {
+    readonly propertyName: string;
+    readonly mapping?: Readonly<Record<string, string>>;
+}
+export interface OpenAPIParameter {
+    readonly name: string;
+    readonly in: 'query' | 'path' | 'header' | 'cookie' | string;
+    readonly required?: boolean;
+    readonly deprecated?: boolean;
+    readonly description?: string;
+    readonly schema?: OpenAPISchema;
+    readonly style?: string;
+    readonly explode?: boolean;
+    readonly example?: unknown;
+    readonly examples?: Readonly<Record<string, OpenAPIExample>>;
+}
+export interface OpenAPIExample {
+    readonly summary?: string;
+    readonly description?: string;
+    readonly value?: unknown;
+    readonly externalValue?: string;
+}
+export interface OpenAPIRequestBody {
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly content: Readonly<Record<string, OpenAPIMediaType>>;
+}
+export interface OpenAPIMediaType {
+    readonly schema?: OpenAPISchema;
+    readonly example?: unknown;
+    readonly examples?: Readonly<Record<string, OpenAPIExample>>;
+    readonly encoding?: Readonly<Record<string, OpenAPIEncoding>>;
+}
+export interface OpenAPIEncoding {
+    readonly contentType?: string;
+    readonly headers?: Readonly<Record<string, OpenAPIHeader>>;
+    readonly style?: string;
+    readonly explode?: boolean;
+    readonly allowReserved?: boolean;
+}
+export interface OpenAPIResponse {
+    readonly description?: string;
+    readonly headers?: Readonly<Record<string, OpenAPIHeader>>;
+    readonly content?: Readonly<Record<string, OpenAPIMediaType>>;
+    readonly links?: Readonly<Record<string, OpenAPILink>>;
+}
+export interface OpenAPIHeader {
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly deprecated?: boolean;
+    readonly schema?: OpenAPISchema;
+}
+export interface OpenAPILink {
+    readonly operationRef?: string;
+    readonly operationId?: string;
+    readonly parameters?: Readonly<Record<string, unknown>>;
+    readonly requestBody?: unknown;
+    readonly description?: string;
+    readonly server?: OpenAPIServer;
+}
+export interface OpenAPIOperation {
+    readonly operationId?: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly deprecated?: boolean;
+    readonly parameters?: readonly OpenAPIParameter[];
+    readonly requestBody?: OpenAPIRequestBody;
+    readonly responses: Readonly<Record<string, OpenAPIResponse>>;
+    readonly security?: readonly OpenAPISecurityRequirement[];
+    readonly servers?: readonly OpenAPIServer[];
+    readonly callbacks?: Readonly<Record<string, OpenAPIPathItem>>;
+    readonly externalDocs?: OpenAPIExternalDocs;
+}
+export interface OpenAPIPathItem {
+    readonly summary?: string;
+    readonly description?: string;
+    readonly get?: OpenAPIOperation;
+    readonly post?: OpenAPIOperation;
+    readonly put?: OpenAPIOperation;
+    readonly patch?: OpenAPIOperation;
+    readonly delete?: OpenAPIOperation;
+    readonly options?: OpenAPIOperation;
+    readonly head?: OpenAPIOperation;
+    readonly trace?: OpenAPIOperation;
+    readonly parameters?: readonly OpenAPIParameter[];
+    readonly servers?: readonly OpenAPIServer[];
+}
+export interface OpenAPIComponents {
+    readonly schemas?: Readonly<Record<string, OpenAPISchema>>;
+    readonly responses?: Readonly<Record<string, OpenAPIResponse>>;
+    readonly parameters?: Readonly<Record<string, OpenAPIParameter>>;
+    readonly examples?: Readonly<Record<string, OpenAPIExample>>;
+    readonly requestBodies?: Readonly<Record<string, OpenAPIRequestBody>>;
+    readonly headers?: Readonly<Record<string, OpenAPIHeader>>;
+    readonly securitySchemes?: Readonly<Record<string, OpenAPISecurityScheme>>;
+    readonly links?: Readonly<Record<string, OpenAPILink>>;
+    readonly callbacks?: Readonly<Record<string, OpenAPIPathItem>>;
+    readonly pathItems?: Readonly<Record<string, OpenAPIPathItem>>;
+}
+export interface OpenAPISecurityScheme {
+    readonly type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect' | string;
+    readonly description?: string;
+    readonly name?: string;
+    readonly in?: 'query' | 'header' | 'cookie' | string;
+    readonly scheme?: string;
+    readonly bearerFormat?: string;
+    readonly flows?: OpenAPIOAuthFlows;
+    readonly openIdConnectUrl?: string;
+}
+export interface OpenAPIOAuthFlows {
+    readonly implicit?: OpenAPIOAuthFlow;
+    readonly password?: OpenAPIOAuthFlow;
+    readonly clientCredentials?: OpenAPIOAuthFlow;
+    readonly authorizationCode?: OpenAPIOAuthFlow;
+}
+export interface OpenAPIOAuthFlow {
+    readonly authorizationUrl?: string;
+    readonly tokenUrl?: string;
+    readonly refreshUrl?: string;
+    readonly scopes: Readonly<Record<string, string>>;
+}
+export type OpenAPISecurityRequirement = Readonly<Record<string, readonly string[]>>;
+export interface OpenAPIInfo {
+    readonly title: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly termsOfService?: string;
+    readonly contact?: OpenAPIContact;
+    readonly license?: OpenAPILicense;
+    readonly summary?: string;
+}
+export interface OpenAPIContact {
+    readonly name?: string;
+    readonly url?: string;
+    readonly email?: string;
+}
+export interface OpenAPILicense {
+    readonly name: string;
+    readonly identifier?: string;
+    readonly url?: string;
+}
+export interface OpenAPIServer {
+    readonly url: string;
+    readonly description?: string;
+    readonly variables?: Readonly<Record<string, OpenAPIServerVariable>>;
+}
+export interface OpenAPIServerVariable {
+    readonly enum?: readonly string[];
+    readonly default: string;
+    readonly description?: string;
+}
+export interface OpenAPIExternalDocs {
+    readonly url: string;
+    readonly description?: string;
+}
+export interface OpenAPITag {
+    readonly name: string;
+    readonly description?: string;
+    readonly externalDocs?: OpenAPIExternalDocs;
+}
+/** Full OpenAPI 3.x specification */
+export interface OpenAPISpec {
+    readonly openapi: string;
+    readonly info: OpenAPIInfo;
+    readonly jsonSchemaDialect?: string;
+    readonly servers?: readonly OpenAPIServer[];
+    readonly paths?: Readonly<Record<string, OpenAPIPathItem>>;
+    readonly webhooks?: Readonly<Record<string, OpenAPIPathItem>>;
+    readonly components?: OpenAPIComponents;
+    readonly security?: readonly OpenAPISecurityRequirement[];
+    readonly tags?: readonly OpenAPITag[];
+    readonly externalDocs?: OpenAPIExternalDocs;
+}
+//# sourceMappingURL=openapi.d.ts.map