mcp-openapi-schema-explorer 1.0.0

package/dist/src/index.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'; // Import ResourceTemplate
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config.js';
+// Import new handlers
+import { TopLevelFieldHandler } from './handlers/top-level-field-handler.js';
+import { PathItemHandler } from './handlers/path-item-handler.js';
+import { OperationHandler } from './handlers/operation-handler.js';
+import { ComponentMapHandler } from './handlers/component-map-handler.js';
+import { ComponentDetailHandler } from './handlers/component-detail-handler.js';
+import { OpenAPITransformer, ReferenceTransformService } from './services/reference-transform.js';
+import { SpecLoaderService } from './services/spec-loader.js';
+import { createFormatter } from './services/formatters.js';
+import { encodeUriPathComponent } from './utils/uri-builder.js'; // Import specific function
+import { isOpenAPIV3, getValidatedComponentMap } from './handlers/handler-utils.js'; // Import type guard and helper
+import { VERSION } from './version.js'; // Import the generated version
+async function main() {
+    try {
+        // Get spec path and options from command line arguments
+        const [, , specPath, ...args] = process.argv;
+        const options = {
+            outputFormat: args.includes('--output-format')
+                ? args[args.indexOf('--output-format') + 1]
+                : undefined,
+        };
+        // Load configuration
+        const config = loadConfig(specPath, options);
+        // Initialize services
+        const referenceTransform = new ReferenceTransformService();
+        referenceTransform.registerTransformer('openapi', new OpenAPITransformer());
+        const specLoader = new SpecLoaderService(config.specPath, referenceTransform);
+        await specLoader.loadSpec();
+        // Get the loaded spec to extract the title
+        const spec = await specLoader.getSpec(); // Rename back to spec
+        // Get the transformed spec for use in completions
+        const transformedSpec = await specLoader.getTransformedSpec({
+            resourceType: 'schema', // Use a default context
+            format: 'openapi',
+        });
+        const defaultServerName = 'OpenAPI Schema Explorer';
+        // Use original spec for title
+        const serverName = spec.info?.title
+            ? `Schema Explorer for ${spec.info.title}`
+            : defaultServerName;
+        // Create MCP server with dynamic name
+        const server = new McpServer({
+            name: serverName,
+            version: VERSION, // Use the imported version
+        });
+        // Set up formatter and new handlers
+        const formatter = createFormatter(config.outputFormat);
+        const topLevelFieldHandler = new TopLevelFieldHandler(specLoader, formatter);
+        const pathItemHandler = new PathItemHandler(specLoader, formatter);
+        const operationHandler = new OperationHandler(specLoader, formatter);
+        const componentMapHandler = new ComponentMapHandler(specLoader, formatter);
+        const componentDetailHandler = new ComponentDetailHandler(specLoader, formatter);
+        // Register new resources
+        // 1. openapi://{field}
+        const fieldTemplate = new ResourceTemplate('openapi://{field}', {
+            list: undefined, // List is handled by the handler logic based on field value
+            complete: {
+                field: () => Object.keys(transformedSpec), // Use transformedSpec
+            },
+        });
+        server.resource('openapi-field', // Unique ID for the resource registration
+        fieldTemplate, {
+            // MimeType varies (text/plain for lists, JSON/YAML for details) - SDK might handle this? Or maybe set a default? Let's omit for now.
+            description: 'Access top-level fields (info, servers, tags), list paths, or list component types.',
+            name: 'OpenAPI Field/List', // Generic name
+        }, topLevelFieldHandler.handleRequest);
+        // 2. openapi://paths/{path}
+        const pathTemplate = new ResourceTemplate('openapi://paths/{path}', {
+            list: undefined, // List is handled by the handler
+            complete: {
+                path: () => Object.keys(transformedSpec.paths ?? {}).map(encodeUriPathComponent), // Use imported function directly
+            },
+        });
+        server.resource('openapi-path-methods', pathTemplate, {
+            mimeType: 'text/plain', // This always returns a list
+            description: 'List available HTTP methods for a specific path. (Note: {path} must be URL-encoded, e.g., /users/{id} becomes users%2F%7Bid%7D)',
+            name: 'Path Methods List',
+        }, pathItemHandler.handleRequest);
+        // 3. openapi://paths/{path}/{method*}
+        const operationTemplate = new ResourceTemplate('openapi://paths/{path}/{method*}', {
+            list: undefined, // Detail view handled by handler
+            complete: {
+                path: () => Object.keys(transformedSpec.paths ?? {}).map(encodeUriPathComponent), // Use imported function directly
+                method: () => [
+                    // Provide static list of common methods
+                    'GET',
+                    'POST',
+                    'PUT',
+                    'DELETE',
+                    'PATCH',
+                    'OPTIONS',
+                    'HEAD',
+                    'TRACE',
+                ],
+            },
+        });
+        server.resource('openapi-operation-detail', operationTemplate, {
+            mimeType: formatter.getMimeType(), // Detail view uses formatter
+            description: 'Get details for one or more specific API operations (methods). (Note: {path} must be URL-encoded, e.g., /users/{id} becomes users%2F%7Bid%7D)',
+            name: 'Operation Detail',
+        }, operationHandler.handleRequest);
+        // 4. openapi://components/{type}
+        const componentMapTemplate = new ResourceTemplate('openapi://components/{type}', {
+            list: undefined, // List is handled by the handler
+            complete: {
+                type: () => {
+                    // Use type guard to ensure spec is V3 before accessing components
+                    if (isOpenAPIV3(transformedSpec)) {
+                        return Object.keys(transformedSpec.components ?? {});
+                    }
+                    return []; // Return empty array if not V3 (shouldn't happen ideally)
+                },
+            },
+        });
+        server.resource('openapi-component-list', componentMapTemplate, {
+            mimeType: 'text/plain', // This always returns a list
+            description: 'List available components of a specific type (e.g., schemas, parameters).',
+            name: 'Component List',
+        }, componentMapHandler.handleRequest);
+        // 5. openapi://components/{type}/{name*}
+        const componentDetailTemplate = new ResourceTemplate('openapi://components/{type}/{name*}', {
+            list: undefined, // Detail view handled by handler
+            complete: {
+                type: () => {
+                    // Use type guard to ensure spec is V3 before accessing components
+                    if (isOpenAPIV3(transformedSpec)) {
+                        return Object.keys(transformedSpec.components ?? {});
+                    }
+                    return []; // Return empty array if not V3
+                }, // <<< Added missing closing brace
+                name: () => {
+                    // Provide names only if there's exactly one component type defined
+                    if (isOpenAPIV3(transformedSpec) &&
+                        transformedSpec.components &&
+                        Object.keys(transformedSpec.components).length === 1) {
+                        // Get the single component type key (e.g., 'schemas')
+                        const componentTypeKey = Object.keys(transformedSpec.components)[0];
+                        // Use the helper to safely get the map
+                        try {
+                            const componentTypeMap = getValidatedComponentMap(transformedSpec, componentTypeKey);
+                            return Object.keys(componentTypeMap);
+                        }
+                        catch (error) {
+                            // Should not happen if key came from Object.keys, but handle defensively
+                            console.error(`Error getting component map for key ${componentTypeKey}:`, error);
+                            return [];
+                        }
+                    }
+                    // Otherwise, return no completions for name
+                    return [];
+                },
+            },
+        });
+        server.resource('openapi-component-detail', componentDetailTemplate, {
+            mimeType: formatter.getMimeType(), // Detail view uses formatter
+            description: 'Get details for one or more specific components (e.g., schemas, parameters).',
+            name: 'Component Detail',
+        }, componentDetailHandler.handleRequest);
+        // Start server
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.error('Failed to start server:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run the server
+main().catch(error => {
+    console.error('Unhandled error:', error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/rendering/components.d.ts

@@ -0,0 +1,67 @@
+import { OpenAPIV3 } from 'openapi-types';
+import { RenderableSpecObject, RenderContext, RenderResultItem } from './types.js';
+export type ComponentType = keyof OpenAPIV3.ComponentsObject;
+export declare const VALID_COMPONENT_TYPES: ComponentType[];
+/**
+ * Wraps an OpenAPIV3.ComponentsObject to make it renderable.
+ * Handles listing the available component types.
+ */
+export declare class RenderableComponents implements RenderableSpecObject {
+    private components;
+    constructor(components: OpenAPIV3.ComponentsObject | undefined);
+    /**
+     * Renders a list of available component types found in the spec.
+     * Corresponds to the `openapi://components` URI.
+     */
+    renderList(context: RenderContext): RenderResultItem[];
+    /**
+     * Detail view for the main 'components' object isn't meaningful.
+     */
+    renderDetail(context: RenderContext): RenderResultItem[];
+    /**
+     * Gets the map object for a specific component type.
+     * @param type - The component type (e.g., 'schemas').
+     * @returns The map (e.g., ComponentsObject['schemas']) or undefined.
+     */
+    getComponentMap(type: ComponentType): Record<string, OpenAPIV3.SchemaObject | OpenAPIV3.ResponseObject | OpenAPIV3.ParameterObject | OpenAPIV3.ExampleObject | OpenAPIV3.RequestBodyObject | OpenAPIV3.HeaderObject | OpenAPIV3.SecuritySchemeObject | OpenAPIV3.LinkObject | OpenAPIV3.CallbackObject | OpenAPIV3.ReferenceObject> | undefined;
+}
+/**
+ * Wraps a map of components of a specific type (e.g., all schemas).
+ * Handles listing component names and rendering component details.
+ */
+export declare class RenderableComponentMap implements RenderableSpecObject {
+    private componentMap;
+    private componentType;
+    private mapUriSuffix;
+    constructor(componentMap: ReturnType<RenderableComponents['getComponentMap']>, componentType: ComponentType, // e.g., 'schemas'
+    mapUriSuffix: string);
+    /**
+     * Renders a list of component names for the specific type.
+     * Corresponds to the `openapi://components/{type}` URI.
+     */
+    renderList(context: RenderContext): RenderResultItem[];
+    /**
+     * Renders the detail view for one or more specific named components
+     * Renders the detail view. For a component map, this usually means listing
+     * the component names, similar to renderList. The handler should call
+     * `renderComponentDetail` for specific component details.
+     */
+    renderDetail(context: RenderContext): RenderResultItem[];
+    /**
+     * Renders the detail view for one or more specific named components
+     * within this map.
+     * Corresponds to the `openapi://components/{type}/{name*}` URI.
+     * This is called by the handler after identifying the name(s).
+     *
+     * @param _context - The rendering context (might be needed later).
+     * @param names - Array of component names.
+     * @returns An array of RenderResultItem representing the component details.
+     */
+    renderComponentDetail(_context: RenderContext, names: string[]): RenderResultItem[];
+    /**
+     * Gets a specific component object by name.
+     * @param name - The name of the component.
+     * @returns The component object (or ReferenceObject) or undefined.
+     */
+    getComponent(name: string): OpenAPIV3.SchemaObject | OpenAPIV3.ResponseObject | OpenAPIV3.ParameterObject | OpenAPIV3.ExampleObject | OpenAPIV3.RequestBodyObject | OpenAPIV3.HeaderObject | OpenAPIV3.SecuritySchemeObject | OpenAPIV3.LinkObject | OpenAPIV3.CallbackObject | OpenAPIV3.ReferenceObject | undefined;
+}

package/dist/src/rendering/components.js

@@ -0,0 +1,177 @@
+import { createErrorResult, generateListHint } from './utils.js'; // Add .js
+export const VALID_COMPONENT_TYPES = [
+    'schemas',
+    'responses',
+    'parameters',
+    'examples',
+    'requestBodies',
+    'headers',
+    'securitySchemes',
+    'links',
+    'callbacks',
+    // 'pathItems' is technically allowed but we handle paths separately
+];
+/**
+ * Wraps an OpenAPIV3.ComponentsObject to make it renderable.
+ * Handles listing the available component types.
+ */
+export class RenderableComponents {
+    constructor(components) {
+        this.components = components;
+    }
+    /**
+     * Renders a list of available component types found in the spec.
+     * Corresponds to the `openapi://components` URI.
+     */
+    renderList(context) {
+        if (!this.components || Object.keys(this.components).length === 0) {
+            return createErrorResult('components', 'No components found in the specification.');
+        }
+        const availableTypes = Object.keys(this.components).filter((key) => VALID_COMPONENT_TYPES.includes(key));
+        if (availableTypes.length === 0) {
+            return createErrorResult('components', 'No valid component types found.');
+        }
+        let listText = 'Available Component Types:\n\n';
+        availableTypes.sort().forEach(type => {
+            listText += `- ${type}\n`;
+        });
+        // Use the new hint generator structure
+        listText += generateListHint(context, { itemType: 'componentType' });
+        return [
+            {
+                uriSuffix: 'components',
+                data: listText,
+                renderAsList: true,
+            },
+        ];
+    }
+    /**
+     * Detail view for the main 'components' object isn't meaningful.
+     */
+    renderDetail(context) {
+        return this.renderList(context);
+    }
+    /**
+     * Gets the map object for a specific component type.
+     * @param type - The component type (e.g., 'schemas').
+     * @returns The map (e.g., ComponentsObject['schemas']) or undefined.
+     */
+    getComponentMap(type) {
+        // Use Map for safe access
+        if (!this.components) {
+            return undefined;
+        }
+        const componentsMap = new Map(Object.entries(this.components));
+        // Cast needed as Map.get returns the value type or undefined
+        return componentsMap.get(type);
+    }
+}
+// =====================================================================
+/**
+ * Wraps a map of components of a specific type (e.g., all schemas).
+ * Handles listing component names and rendering component details.
+ */
+export class RenderableComponentMap {
+    constructor(componentMap, componentType, // e.g., 'schemas'
+    mapUriSuffix // e.g., 'components/schemas'
+    ) {
+        this.componentMap = componentMap;
+        this.componentType = componentType;
+        this.mapUriSuffix = mapUriSuffix;
+    }
+    /**
+     * Renders a list of component names for the specific type.
+     * Corresponds to the `openapi://components/{type}` URI.
+     */
+    renderList(context) {
+        if (!this.componentMap || Object.keys(this.componentMap).length === 0) {
+            return createErrorResult(this.mapUriSuffix, `No components of type "${this.componentType}" found.`);
+        }
+        const names = Object.keys(this.componentMap).sort();
+        let listText = `Available ${this.componentType}:\n\n`;
+        names.forEach(name => {
+            listText += `- ${name}\n`;
+        });
+        // Use the new hint generator structure, providing parent type
+        listText += generateListHint(context, {
+            itemType: 'componentName',
+            parentComponentType: this.componentType,
+        });
+        return [
+            {
+                uriSuffix: this.mapUriSuffix,
+                data: listText,
+                renderAsList: true,
+            },
+        ];
+    }
+    /**
+     * Renders the detail view for one or more specific named components
+     * Renders the detail view. For a component map, this usually means listing
+     * the component names, similar to renderList. The handler should call
+     * `renderComponentDetail` for specific component details.
+     */
+    renderDetail(context) {
+        // Delegate to renderList as the primary view for a component map itself.
+        return this.renderList(context);
+    }
+    /**
+     * Renders the detail view for one or more specific named components
+     * within this map.
+     * Corresponds to the `openapi://components/{type}/{name*}` URI.
+     * This is called by the handler after identifying the name(s).
+     *
+     * @param _context - The rendering context (might be needed later).
+     * @param names - Array of component names.
+     * @returns An array of RenderResultItem representing the component details.
+     */
+    renderComponentDetail(_context, names) {
+        if (!this.componentMap) {
+            // Create error results for all requested names if map is missing
+            return names.map(name => ({
+                uriSuffix: `${this.mapUriSuffix}/${name}`,
+                data: null,
+                isError: true,
+                errorText: `Component map for type "${this.componentType}" not found.`,
+                renderAsList: true,
+            }));
+        }
+        const results = [];
+        for (const name of names) {
+            const component = this.getComponent(name);
+            const componentUriSuffix = `${this.mapUriSuffix}/${name}`;
+            if (!component) {
+                results.push({
+                    uriSuffix: componentUriSuffix,
+                    data: null,
+                    isError: true,
+                    errorText: `Component "${name}" of type "${this.componentType}" not found.`,
+                    renderAsList: true,
+                });
+            }
+            else {
+                // Return the raw component object; handler will format it
+                results.push({
+                    uriSuffix: componentUriSuffix,
+                    data: component,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Gets a specific component object by name.
+     * @param name - The name of the component.
+     * @returns The component object (or ReferenceObject) or undefined.
+     */
+    getComponent(name) {
+        // Use Map for safe access
+        if (!this.componentMap) {
+            return undefined;
+        }
+        const detailsMap = new Map(Object.entries(this.componentMap));
+        // No cast needed, Map.get returns the correct type (ValueType | undefined)
+        return detailsMap.get(name);
+    }
+}
+//# sourceMappingURL=components.js.map

package/dist/src/rendering/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../src/rendering/components.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC,CAAC,UAAU;AAI5E,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD,SAAS;IACT,WAAW;IACX,YAAY;IACZ,UAAU;IACV,eAAe;IACf,SAAS;IACT,iBAAiB;IACjB,OAAO;IACP,WAAW;IACX,oEAAoE;CACrE,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAC/B,YAAoB,UAAkD;QAAlD,eAAU,GAAV,UAAU,CAAwC;IAAG,CAAC;IAE1E;;;OAGG;IACH,UAAU,CAAC,OAAsB;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,iBAAiB,CAAC,YAAY,EAAE,2CAA2C,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAwB,EAAE,CACvF,qBAAqB,CAAC,QAAQ,CAAC,GAAoB,CAAC,CACrD,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,iBAAiB,CAAC,YAAY,EAAE,iCAAiC,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,QAAQ,GAAG,gCAAgC,CAAC;QAChD,cAAc,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnC,QAAQ,IAAI,KAAK,IAAI,IAAI,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,QAAQ,IAAI,gBAAgB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;QAErE,OAAO;YACL;gBACE,SAAS,EAAE,YAAY;gBACvB,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,IAAI;aACnB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAsB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAmB;QAejC,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/D,6DAA6D;QAC7D,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAwD,CAAC;IACxF,CAAC;CACF;AAED,wEAAwE;AAExE;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IACjC,YACU,YAAiE,EACjE,aAA4B,EAAE,kBAAkB;IAChD,YAAoB,CAAC,6BAA6B;;QAFlD,iBAAY,GAAZ,YAAY,CAAqD;QACjE,kBAAa,GAAb,aAAa,CAAe;QAC5B,iBAAY,GAAZ,YAAY,CAAQ;IAC3B,CAAC;IAEJ;;;OAGG;IACH,UAAU,CAAC,OAAsB;QAC/B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,iBAAiB,CACtB,IAAI,CAAC,YAAY,EACjB,0BAA0B,IAAI,CAAC,aAAa,UAAU,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,QAAQ,GAAG,aAAa,IAAI,CAAC,aAAa,OAAO,CAAC;QACtD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnB,QAAQ,IAAI,KAAK,IAAI,IAAI,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,8DAA8D;QAC9D,QAAQ,IAAI,gBAAgB,CAAC,OAAO,EAAE;YACpC,QAAQ,EAAE,eAAe;YACzB,mBAAmB,EAAE,IAAI,CAAC,aAAa;SACxC,CAAC,CAAC;QAEH,OAAO;YACL;gBACE,SAAS,EAAE,IAAI,CAAC,YAAY;gBAC5B,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,IAAI;aACnB;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAsB;QACjC,yEAAyE;QACzE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAuB,EAAE,KAAe;QAC5D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,iEAAiE;YACjE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxB,SAAS,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE;gBACzC,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,2BAA2B,IAAI,CAAC,aAAa,cAAc;gBACtE,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC,CAAC;QACN,CAAC;QAED,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,kBAAkB,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;YAE1D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,kBAAkB;oBAC7B,IAAI,EAAE,IAAI;oBACV,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,cAAc,IAAI,cAAc,IAAI,CAAC,aAAa,cAAc;oBAC3E,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,0DAA0D;gBAC1D,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,kBAAkB;oBAC7B,IAAI,EAAE,SAAS;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,IAAY;QAaZ,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC9D,2EAA2E;QAC3E,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/src/rendering/document.d.ts

@@ -0,0 +1,36 @@
+import { OpenAPIV3 } from 'openapi-types';
+import { RenderableSpecObject, RenderContext, RenderResultItem } from './types.js';
+/**
+ * Wraps an OpenAPIV3.Document to make it renderable.
+ * Handles rendering for top-level fields like 'info', 'servers', etc.
+ * Delegates list rendering for 'paths' and 'components' to respective objects.
+ */
+export declare class RenderableDocument implements RenderableSpecObject {
+    private document;
+    constructor(document: OpenAPIV3.Document);
+    /**
+     * Renders a list view. For the document level, this is intended
+     * to be called only when the requested field is 'paths' or 'components'.
+     * The actual routing/delegation will happen in the handler based on the field.
+     */
+    renderList(_context: RenderContext): RenderResultItem[];
+    /**
+     * Renders the detail view. For the document level, this should not be called
+     * directly without specifying a field. The handler should call
+     * `renderTopLevelFieldDetail` instead.
+     */
+    renderDetail(_context: RenderContext): RenderResultItem[];
+    /**
+     * Renders the detail view for a *specific* top-level field (e.g., 'info', 'servers').
+     * This is called by the handler after identifying the field.
+     *
+     * @param context - The rendering context.
+     * @param fieldObject - The actual top-level field object to render (e.g., document.info).
+     * @param fieldName - The name of the field being rendered (e.g., 'info').
+     * @returns An array of RenderResultItem representing the detail view.
+     */
+    renderTopLevelFieldDetail(context: RenderContext, fieldObject: unknown, fieldName: string): RenderResultItem[];
+    getPathsObject(): OpenAPIV3.PathsObject | undefined;
+    getComponentsObject(): OpenAPIV3.ComponentsObject | undefined;
+    getTopLevelField(fieldName: string): unknown;
+}

package/dist/src/rendering/document.js

@@ -0,0 +1,147 @@
+// No longer need ResourceContents here
+// Placeholder for other renderable objects we'll create
+// import { RenderablePaths } from './paths.js'; // Add .js
+// import { RenderableComponents } from './components.js'; // Add .js
+/**
+ * Wraps an OpenAPIV3.Document to make it renderable.
+ * Handles rendering for top-level fields like 'info', 'servers', etc.
+ * Delegates list rendering for 'paths' and 'components' to respective objects.
+ */
+export class RenderableDocument {
+    // TODO: Add RenderablePaths and RenderableComponents instances
+    // private renderablePaths: RenderablePaths;
+    // private renderableComponents: RenderableComponents;
+    constructor(document) {
+        this.document = document;
+        // Initialize renderable wrappers for paths and components here
+        // this.renderablePaths = new RenderablePaths(document.paths);
+        // this.renderableComponents = new RenderableComponents(document.components);
+    }
+    /**
+     * Renders a list view. For the document level, this is intended
+     * to be called only when the requested field is 'paths' or 'components'.
+     * The actual routing/delegation will happen in the handler based on the field.
+     */
+    renderList(_context) {
+        // Prefix context with _
+        // This method should ideally not be called directly on the document
+        // without specifying 'paths' or 'components' as the field.
+        // The handler for openapi://{field} will delegate to the appropriate
+        // sub-object's renderList.
+        // Returning an error result item.
+        return [
+            {
+                uriSuffix: 'error',
+                data: null, // No specific data for this error
+                isError: true,
+                errorText: 'Error: List rendering is only supported for specific fields like "paths" or "components" at the top level.',
+                renderAsList: true, // Errors often shown as plain text
+            },
+        ];
+    }
+    /**
+     * Renders the detail view. For the document level, this should not be called
+     * directly without specifying a field. The handler should call
+     * `renderTopLevelFieldDetail` instead.
+     */
+    renderDetail(_context) {
+        // Prefix context with _
+        // This method implementation fulfills the interface requirement,
+        // but direct detail rendering of the whole document isn't meaningful here.
+        return [
+            {
+                uriSuffix: 'error',
+                data: null,
+                isError: true,
+                errorText: 'Error: Detail rendering requires specifying a top-level field (e.g., "info", "servers").',
+                renderAsList: true, // Errors often shown as plain text
+            },
+        ];
+    }
+    /**
+     * Renders the detail view for a *specific* top-level field (e.g., 'info', 'servers').
+     * This is called by the handler after identifying the field.
+     *
+     * @param context - The rendering context.
+     * @param fieldObject - The actual top-level field object to render (e.g., document.info).
+     * @param fieldName - The name of the field being rendered (e.g., 'info').
+     * @returns An array of RenderResultItem representing the detail view.
+     */
+    renderTopLevelFieldDetail(context, fieldObject, fieldName) {
+        // Ensure fieldObject is provided (handler should validate fieldName exists)
+        if (fieldObject === undefined || fieldObject === null) {
+            return [
+                {
+                    uriSuffix: fieldName,
+                    data: null,
+                    isError: true,
+                    errorText: `Error: Field "${fieldName}" not found in the OpenAPI document.`,
+                    renderAsList: true,
+                },
+            ];
+        }
+        // Avoid rendering structural fields that have dedicated list views
+        if (fieldName === 'paths' || fieldName === 'components') {
+            return [
+                {
+                    uriSuffix: fieldName,
+                    data: null,
+                    isError: true,
+                    errorText: `Error: Field "${fieldName}" should be accessed via its list view (${context.baseUri}${fieldName}). Use the list view first.`,
+                    renderAsList: true,
+                },
+            ];
+        }
+        try {
+            // For successful detail rendering, return the data object itself.
+            // The handler will format it using the context.formatter.
+            return [
+                {
+                    uriSuffix: fieldName,
+                    data: fieldObject, // Pass the raw data
+                    // isError defaults to false
+                    // renderAsList defaults to false (meaning use detail formatter)
+                },
+            ];
+        }
+        catch (error) {
+            // Handle potential errors during data access or initial checks
+            // Formatting errors will be caught by the handler later
+            return [
+                {
+                    uriSuffix: fieldName,
+                    data: null,
+                    isError: true,
+                    errorText: `Error preparing field "${fieldName}" for rendering: ${error instanceof Error ? error.message : String(error)}`,
+                    renderAsList: true,
+                },
+            ];
+        }
+    } // End of renderTopLevelFieldDetail
+    // --- Helper methods to access specific parts ---
+    getPathsObject() {
+        return this.document.paths;
+    }
+    getComponentsObject() {
+        return this.document.components;
+    }
+    getTopLevelField(fieldName) {
+        // Define allowed top-level OpenAPI document properties
+        const allowedFields = [
+            'openapi',
+            'info',
+            'servers',
+            'paths',
+            'components',
+            'security',
+            'tags',
+            'externalDocs',
+        ];
+        // Only allow access to documented OpenAPI properties
+        if (allowedFields.includes(fieldName)) {
+            return this.document[fieldName];
+        }
+        return undefined;
+    }
+} // End of RenderableDocument class
+//# sourceMappingURL=document.js.map

package/dist/src/rendering/document.js.map

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