openapi-docs-mcp 0.1.0

package/dist/formatter/schema.js

@@ -0,0 +1,142 @@
+import { asObject, asString } from "../openapi/operations.js";
+export function formatSchema(document, schema, options = {}) {
+    return formatSchemaNode(document, schema, {
+        maxDepth: options.maxDepth ?? 5,
+        maxProperties: options.maxProperties ?? 100,
+    }, { depth: 0, references: new Set() });
+}
+export function listSchemaNames(document) {
+    const root = document;
+    const components = asObject(root.components);
+    const schemas = asObject(components?.schemas) ?? asObject(root.definitions);
+    return schemas ? Object.keys(schemas).sort((a, b) => a.localeCompare(b)) : [];
+}
+export function findSchema(document, name) {
+    const root = document;
+    const components = asObject(root.components);
+    const schemas = asObject(components?.schemas) ?? asObject(root.definitions);
+    return schemas?.[name];
+}
+function formatSchemaNode(document, rawSchema, options, state) {
+    if (typeof rawSchema === "boolean")
+        return rawSchema;
+    const schema = asObject(rawSchema);
+    if (!schema)
+        return rawSchema ?? null;
+    const ref = asString(schema.$ref);
+    if (ref) {
+        const refName = decodeURIComponent(ref.split("/").at(-1) ?? ref);
+        if (state.references.has(ref)) {
+            return { $ref: ref, name: refName, circular: true };
+        }
+        if (state.depth >= options.maxDepth) {
+            return { $ref: ref, name: refName, truncated: "maxDepth" };
+        }
+        const resolved = resolveLocalReference(document, ref);
+        if (resolved === undefined)
+            return { $ref: ref, name: refName, unresolved: true };
+        const references = new Set(state.references);
+        references.add(ref);
+        return {
+            $ref: ref,
+            name: refName,
+            schema: formatSchemaNode(document, resolved, options, {
+                depth: state.depth + 1,
+                references,
+            }),
+        };
+    }
+    if (state.depth >= options.maxDepth) {
+        return { type: schema.type ?? "object", truncated: "maxDepth" };
+    }
+    const output = {};
+    copyKnownValues(schema, output, [
+        "type",
+        "format",
+        "title",
+        "description",
+        "nullable",
+        "readOnly",
+        "writeOnly",
+        "deprecated",
+        "default",
+        "example",
+        "examples",
+        "enum",
+        "const",
+        "minimum",
+        "maximum",
+        "minLength",
+        "maxLength",
+        "pattern",
+    ]);
+    if (Array.isArray(schema.required))
+        output.required = schema.required;
+    const properties = asObject(schema.properties);
+    if (properties) {
+        const entries = Object.entries(properties);
+        output.properties = Object.fromEntries(entries.slice(0, options.maxProperties).map(([name, value]) => [
+            name,
+            formatSchemaNode(document, value, options, {
+                depth: state.depth + 1,
+                references: new Set(state.references),
+            }),
+        ]));
+        if (entries.length > options.maxProperties) {
+            output.truncatedProperties = entries.length - options.maxProperties;
+        }
+    }
+    if (schema.items !== undefined) {
+        output.items = formatSchemaNode(document, schema.items, options, {
+            depth: state.depth + 1,
+            references: new Set(state.references),
+        });
+    }
+    if (schema.additionalProperties !== undefined) {
+        output.additionalProperties =
+            typeof schema.additionalProperties === "boolean"
+                ? schema.additionalProperties
+                : formatSchemaNode(document, schema.additionalProperties, options, {
+                    depth: state.depth + 1,
+                    references: new Set(state.references),
+                });
+    }
+    for (const keyword of ["allOf", "oneOf", "anyOf"]) {
+        const variants = schema[keyword];
+        if (Array.isArray(variants)) {
+            output[keyword] = variants.map((variant) => formatSchemaNode(document, variant, options, {
+                depth: state.depth + 1,
+                references: new Set(state.references),
+            }));
+        }
+    }
+    if (schema.not !== undefined) {
+        output.not = formatSchemaNode(document, schema.not, options, {
+            depth: state.depth + 1,
+            references: new Set(state.references),
+        });
+    }
+    return output;
+}
+export function resolveLocalReference(document, ref) {
+    if (!ref.startsWith("#/"))
+        return undefined;
+    const parts = ref
+        .slice(2)
+        .split("/")
+        .map((part) => part.replace(/~1/g, "/").replace(/~0/g, "~"));
+    let current = document;
+    for (const part of parts) {
+        current = asObject(current)?.[part];
+        if (current === undefined)
+            return undefined;
+    }
+    return current;
+}
+function copyKnownValues(source, target, keys) {
+    for (const key of keys) {
+        if (source[key] !== undefined)
+            target[key] = source[key];
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/formatter/schema.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createOpenApiContext, loadOpenApi } from "./openapi/loader.js";
+export { createMcpServer } from "./mcp/server.js";
+export { OpenApiService } from "./service.js";
+export { searchOperations } from "./search/search.js";
+export type { OpenApiContext, OperationEntry, SearchOptions, SearchResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createOpenApiContext, loadOpenApi } from "./openapi/loader.js";
+export { createMcpServer } from "./mcp/server.js";
+export { OpenApiService } from "./service.js";
+export { searchOperations } from "./search/search.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { OpenApiService } from "../service.js";
+export declare function createMcpServer(service: OpenApiService): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAK/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAmGlE"}

package/dist/mcp/server.js

@@ -0,0 +1,89 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { z } from "zod";
+const depthSchema = z.number().int().min(1).max(12).default(5);
+export function createMcpServer(service) {
+    const server = new McpServer({
+        name: "openapi-docs-mcp",
+        version: "0.1.0",
+    });
+    server.registerTool("search_api", {
+        title: "Search OpenAPI operations",
+        description: "Search API operations by natural-language keywords, path, tag, description, or operationId. Returns ranked lightweight candidates; call get_api for full details.",
+        inputSchema: z.object({
+            query: z.string().default("").describe("Keywords such as 异常分页列表 or create user"),
+            method: z.string().optional().describe("Optional HTTP method filter"),
+            tag: z.string().optional().describe("Optional exact tag filter"),
+            limit: z.number().int().min(1).max(50).default(10),
+        }),
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async ({ query, method, tag, limit }) => success({
+        results: service.search({
+            query,
+            limit,
+            ...(method !== undefined ? { method } : {}),
+            ...(tag !== undefined ? { tag } : {}),
+        }),
+        totalOperations: service.context.operations.length,
+    }));
+    server.registerTool("get_api", {
+        title: "Get one OpenAPI operation",
+        description: "Get the request parameters, expanded request body, responses, tags, and metadata for one operation. Prefer the id returned by search_api.",
+        inputSchema: z
+            .object({
+            id: z.string().optional().describe("Stable id returned by search_api"),
+            path: z.string().optional().describe("Exact OpenAPI path"),
+            method: z.string().optional().describe("HTTP method used with path"),
+            maxDepth: depthSchema,
+        })
+            .refine((value) => Boolean(value.id || value.path), {
+            message: "Provide id or path",
+        }),
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async ({ id, path, method, maxDepth }) => {
+        const api = service.getApi({
+            ...(id !== undefined ? { id } : {}),
+            ...(path !== undefined ? { path } : {}),
+            ...(method !== undefined ? { method } : {}),
+        }, { maxDepth });
+        return api
+            ? success(api)
+            : failure("Operation not found. Use search_api to obtain a valid id.");
+    });
+    server.registerTool("get_schema", {
+        title: "Get one OpenAPI schema",
+        description: "Get a named component schema with bounded local $ref expansion and circular-reference protection.",
+        inputSchema: z.object({
+            name: z.string().min(1).describe("Exact component schema name"),
+            maxDepth: depthSchema,
+        }),
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async ({ name, maxDepth }) => {
+        const schema = service.getSchema(name, { maxDepth });
+        return schema
+            ? success(schema)
+            : failure(`Schema not found: ${name}`, {
+                availableSchemas: service.listSchemas().slice(0, 100),
+            });
+    });
+    server.registerTool("list_groups", {
+        title: "List OpenAPI groups",
+        description: "List tags with their operation counts.",
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async () => success({ groups: service.listGroups() }));
+    return server;
+}
+function success(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+function failure(message, details = {}) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+        structuredContent: { error: message, ...details },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/openapi/loader.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject, OpenApiContext } from "../types.js";
+export interface LoadOpenApiOptions {
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    validationMode?: "compatible" | "strict";
+}
+export declare function loadOpenApi(source: string, options?: LoadOpenApiOptions): Promise<OpenApiContext>;
+export declare function createOpenApiContext(input: string | JsonObject, source?: string, options?: Pick<LoadOpenApiOptions, "validationMode">): Promise<OpenApiContext>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/openapi/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK9D,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC1C;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAMzB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,MAAM,SAAW,EACjB,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAM,GACvD,OAAO,CAAC,cAAc,CAAC,CAgCzB"}

package/dist/openapi/loader.js

@@ -0,0 +1,125 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { validate } from "@scalar/openapi-parser";
+import { extractOperations } from "./operations.js";
+const DEFAULT_TIMEOUT_MS = 10_000;
+export async function loadOpenApi(source, options = {}) {
+    const content = isHttpUrl(source)
+        ? await fetchDocument(source, options)
+        : await readFile(resolve(source), "utf8");
+    return createOpenApiContext(content, source, options);
+}
+export async function createOpenApiContext(input, source = "memory", options = {}) {
+    const result = await validate(input);
+    if (!result.valid) {
+        const specification = result.specification;
+        const compatibleErrors = specification
+            ? result.errors.filter((error) => isCompatibleUnicodeReferenceError(error, specification))
+            : [];
+        const fatalErrors = result.errors.filter((error) => !compatibleErrors.includes(error));
+        if (options.validationMode === "strict" || !specification || fatalErrors.length > 0) {
+            throw new Error(`Invalid OpenAPI document: ${formatValidationErrors(result.errors)}`);
+        }
+        const document = specification;
+        assertDocumentShape(document);
+        return {
+            document,
+            source,
+            version: result.version ?? getDocumentVersion(document),
+            operations: extractOperations(document),
+            validationWarnings: summarizeWarnings(compatibleErrors),
+        };
+    }
+    const document = result.specification;
+    return {
+        document,
+        source,
+        version: result.version,
+        operations: extractOperations(document),
+        validationWarnings: [],
+    };
+}
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+async function fetchDocument(url, options) {
+    const response = await fetch(url, {
+        ...(options.headers ? { headers: options.headers } : {}),
+        signal: AbortSignal.timeout(options.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to load OpenAPI document: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+function isCompatibleUnicodeReferenceError(error, document) {
+    const messageMatches = error.message === "Property $ref is not expected to be here" ||
+        error.message.includes("contains non-ASCII characters");
+    if (!messageMatches || typeof error.path !== "string")
+        return false;
+    const value = resolveJsonPointer(document, error.path);
+    const ref = typeof value === "string"
+        ? value
+        : value && typeof value === "object"
+            ? value.$ref
+            : undefined;
+    if (typeof ref !== "string" || !ref.startsWith("#/") || !/[^\x00-\x7F]/.test(ref)) {
+        return false;
+    }
+    return resolveJsonPointer(document, ref.slice(1)) !== undefined;
+}
+function resolveJsonPointer(root, pointer) {
+    if (pointer === "")
+        return root;
+    if (!pointer.startsWith("/"))
+        return undefined;
+    let current = root;
+    for (const rawPart of pointer.slice(1).split("/")) {
+        const part = decodeURIComponent(rawPart.replace(/~1/g, "/").replace(/~0/g, "~"));
+        if (!current || typeof current !== "object" || Array.isArray(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function formatValidationErrors(errors) {
+    return errors
+        .slice(0, 20)
+        .map((error) => {
+        const path = Array.isArray(error.path)
+            ? error.path.join(".")
+            : typeof error.path === "string"
+                ? error.path
+                : "document";
+        return `${path}: ${error.message}`;
+    })
+        .join("; ");
+}
+function summarizeWarnings(errors) {
+    const counts = new Map();
+    for (const error of errors) {
+        const message = error.message.includes("contains non-ASCII characters")
+            ? "Local $ref contains non-ASCII characters"
+            : error.message;
+        counts.set(message, (counts.get(message) ?? 0) + 1);
+    }
+    return [...counts.entries()].map(([message, count]) => ({ message, count }));
+}
+function assertDocumentShape(document) {
+    const root = document;
+    if (typeof root.openapi !== "string" && typeof root.swagger !== "string") {
+        throw new Error("Invalid OpenAPI document: missing openapi or swagger version");
+    }
+    if (!root.info || typeof root.info !== "object") {
+        throw new Error("Invalid OpenAPI document: missing info object");
+    }
+    if (!root.paths || typeof root.paths !== "object") {
+        throw new Error("Invalid OpenAPI document: missing paths object");
+    }
+}
+function getDocumentVersion(document) {
+    const root = document;
+    const value = typeof root.openapi === "string" ? root.openapi : root.swagger;
+    return typeof value === "string" ? value : "unknown";
+}
+//# sourceMappingURL=loader.js.map

package/dist/openapi/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/openapi/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAQlC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,OAAO,GAAuB,EAAE;IAEhC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC;QACtC,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAE5C,OAAO,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA0B,EAC1B,MAAM,GAAG,QAAQ,EACjB,OAAO,GAA+C,EAAE;IAExD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC3C,MAAM,gBAAgB,GAAG,aAAa;YACpC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAC1F,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEvF,IAAI,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,aAAa,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,6BAA6B,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,QAAQ,GAAG,aAAiC,CAAC;QACnD,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO;YACL,QAAQ;YACR,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC;YACvD,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC;YACvC,kBAAkB,EAAE,iBAAiB,CAAC,gBAAgB,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAiC,CAAC;IAC1D,OAAO;QACL,QAAQ;QACR,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACvC,kBAAkB,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,OAA2B;IAE3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;KACrE,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,iCAAiC,CACxC,KAAoD,EACpD,QAAoB;IAEpB,MAAM,cAAc,GAClB,KAAK,CAAC,OAAO,KAAK,0CAA0C;QAC5D,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IAC1D,IAAI,CAAC,cAAc,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,GAAG,GACP,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAClC,CAAC,CAAE,KAAoB,CAAC,IAAI;YAC5B,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;AAClE,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa,EAAE,OAAe;IACxD,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACxF,OAAO,GAAI,OAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAA4D;IAE5D,OAAO,MAAM;SACV,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAC9B,CAAC,CAAC,KAAK,CAAC,IAAI;gBACZ,CAAC,CAAC,UAAU,CAAC;QACjB,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAkC;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACrE,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,mBAAmB,CAAC,QAA0B;IACrD,MAAM,IAAI,GAAG,QAAiC,CAAC;IAC/C,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA0B;IACpD,MAAM,IAAI,GAAG,QAAiC,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}

package/dist/openapi/operations.d.ts

@@ -0,0 +1,13 @@
+import type { OpenAPI } from "@scalar/openapi-types";
+import type { HttpMethod, JsonObject, OperationEntry } from "../types.js";
+export declare const HTTP_METHODS: readonly HttpMethod[];
+export declare function extractOperations(document: OpenAPI.Document): OperationEntry[];
+export declare function findOperation(operations: OperationEntry[], input: {
+    id?: string;
+    path?: string;
+    method?: string;
+}): OperationEntry | undefined;
+export declare function asObject(value: unknown): JsonObject | undefined;
+export declare function asString(value: unknown): string | undefined;
+export declare function asStringArray(value: unknown): string[];
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/openapi/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAU7C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,cAAc,EAAE,CAmC9E;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,cAAc,EAAE,EAC5B,KAAK,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,cAAc,GAAG,SAAS,CAc5B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAI/D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAEtD"}

package/dist/openapi/operations.js

@@ -0,0 +1,71 @@
+export const HTTP_METHODS = [
+    "get",
+    "put",
+    "post",
+    "delete",
+    "options",
+    "head",
+    "patch",
+    "trace",
+    "query",
+];
+export function extractOperations(document) {
+    const root = document;
+    const paths = asObject(root.paths);
+    if (!paths)
+        return [];
+    const operations = [];
+    for (const [path, rawPathItem] of Object.entries(paths)) {
+        const pathItem = asObject(rawPathItem);
+        if (!pathItem)
+            continue;
+        for (const method of HTTP_METHODS) {
+            const operation = asObject(pathItem[method]);
+            if (!operation)
+                continue;
+            const operationId = asString(operation.operationId);
+            const entry = {
+                id: operationId || `${method.toUpperCase()} ${path}`,
+                method,
+                path,
+                tags: asStringArray(operation.tags),
+                operation,
+                pathItem,
+            };
+            const summary = asString(operation.summary);
+            const description = asString(operation.description);
+            if (summary)
+                entry.summary = summary;
+            if (description)
+                entry.description = description;
+            if (operationId)
+                entry.operationId = operationId;
+            operations.push(entry);
+        }
+    }
+    return operations.sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method));
+}
+export function findOperation(operations, input) {
+    if (input.id) {
+        const exact = operations.find((entry) => entry.id === input.id);
+        if (exact)
+            return exact;
+    }
+    if (input.path) {
+        const method = input.method?.toLowerCase();
+        return operations.find((entry) => entry.path === input.path && (!method || entry.method === method));
+    }
+    return undefined;
+}
+export function asObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+export function asStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+//# sourceMappingURL=operations.js.map

package/dist/openapi/operations.js.map

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

package/dist/search/search.d.ts

@@ -0,0 +1,4 @@
+import type { OperationEntry, SearchOptions, SearchResult } from "../types.js";
+export declare function searchOperations(operations: OperationEntry[], options: SearchOptions): SearchResult[];
+export declare function normalize(value: string): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/search/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU/E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CAahB;AAmED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C"}