lokicms-plugin-api-docs 1.0.0

package/dist/plugin.js

@@ -0,0 +1,448 @@
+/**
+ * LokiCMS API Docs Plugin
+ *
+ * Generates API documentation from LokiCMS runtime with support for
+ * JSON, Markdown, OpenAPI 3.0, and TypeScript output formats.
+ */
+import { z } from 'zod';
+import * as fs from 'fs';
+import * as path from 'path';
+import { createDocGenerator } from './services/doc-generator.js';
+import { formatAsJson, formatToolsAsJson, formatContentTypesAsJson } from './formatters/json-formatter.js';
+import { formatAsMarkdown, formatToolsAsMarkdown, formatContentTypesAsMarkdown } from './formatters/markdown-formatter.js';
+import { formatAsOpenApi } from './formatters/openapi-formatter.js';
+import { generateTypeScript, generateToolTypes, generateContentTypeTypes } from './services/typescript-generator.js';
+// Plugin state
+let docGenerator = null;
+let pluginConfig = {};
+/**
+ * Get the documentation generator instance
+ */
+export function getDocGenerator() {
+    if (!docGenerator) {
+        throw new Error('API Docs plugin not initialized');
+    }
+    return docGenerator;
+}
+/**
+ * LokiCMS API Docs Plugin Definition
+ */
+const plugin = {
+    name: 'lokicms-api-docs',
+    version: '1.0.0',
+    description: 'API documentation generator with OpenAPI, Markdown, and TypeScript support',
+    async register(api) {
+        pluginConfig = api.config.apiDocs || {};
+        api.logger.info('Initializing API Docs plugin');
+        // Create documentation generator
+        docGenerator = createDocGenerator(api, pluginConfig, api.logger);
+        // Register MCP tools
+        registerMcpTools(api);
+        api.logger.info('API Docs plugin registered');
+    },
+};
+/**
+ * Register MCP tools for documentation
+ */
+function registerMcpTools(api) {
+    // ========================================================================
+    // MCP Tool: docs_generate
+    // ========================================================================
+    api.mcp.registerTool('docs_generate', {
+        description: 'Generate complete API documentation in specified format',
+        inputSchema: z.object({
+            format: z
+                .enum(['json', 'markdown', 'openapi', 'typescript'])
+                .optional()
+                .describe('Output format (default: json)'),
+            includeTools: z.boolean().optional().describe('Include MCP tools documentation'),
+            includeContentTypes: z.boolean().optional().describe('Include content types documentation'),
+            includeEndpoints: z.boolean().optional().describe('Include REST-like endpoints'),
+            includeExamples: z.boolean().optional().describe('Include example values'),
+            baseUrl: z.string().optional().describe('Base URL for endpoints (OpenAPI)'),
+        }),
+        handler: async (rawInput) => {
+            const input = rawInput;
+            if (!docGenerator) {
+                return { error: 'API Docs plugin not initialized' };
+            }
+            try {
+                const format = input.format || 'json';
+                const docs = await docGenerator.generate({
+                    includeTools: input.includeTools ?? true,
+                    includeContentTypes: input.includeContentTypes ?? true,
+                    includeEndpoints: input.includeEndpoints ?? true,
+                    includeExamples: input.includeExamples ?? false,
+                });
+                let output;
+                let mimeType;
+                switch (format) {
+                    case 'markdown':
+                        output = formatAsMarkdown(docs, {
+                            includeTableOfContents: true,
+                            includeExamples: input.includeExamples,
+                        });
+                        mimeType = 'text/markdown';
+                        break;
+                    case 'openapi':
+                        output = formatAsOpenApi(docs, {
+                            baseUrl: input.baseUrl || pluginConfig.baseUrl,
+                            outputFormat: 'json',
+                        });
+                        mimeType = 'application/json';
+                        break;
+                    case 'typescript': {
+                        const tsOutput = generateTypeScript(docs, {
+                            includeTools: input.includeTools ?? true,
+                            includeContentTypes: input.includeContentTypes ?? true,
+                            includeComments: true,
+                        });
+                        output = tsOutput.code;
+                        mimeType = 'text/typescript';
+                        break;
+                    }
+                    case 'json':
+                    default:
+                        output = formatAsJson(docs, { pretty: true });
+                        mimeType = 'application/json';
+                        break;
+                }
+                return {
+                    success: true,
+                    format,
+                    mimeType,
+                    content: output,
+                    stats: {
+                        toolCount: docs.tools.length,
+                        contentTypeCount: docs.contentTypes.length,
+                        endpointCount: docs.endpoints?.length || 0,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Generation failed',
+                };
+            }
+        },
+    });
+    // ========================================================================
+    // MCP Tool: docs_tools
+    // ========================================================================
+    api.mcp.registerTool('docs_tools', {
+        description: 'List all available MCP tools with their schemas',
+        inputSchema: z.object({
+            format: z
+                .enum(['json', 'markdown', 'typescript'])
+                .optional()
+                .describe('Output format (default: json)'),
+            includeExamples: z.boolean().optional().describe('Include example values'),
+            filter: z.string().optional().describe('Filter tools by name prefix'),
+        }),
+        handler: async (rawInput) => {
+            const input = rawInput;
+            if (!docGenerator) {
+                return { error: 'API Docs plugin not initialized' };
+            }
+            try {
+                let tools = await docGenerator.getTools(input.includeExamples ?? false);
+                // Apply filter if specified
+                if (input.filter) {
+                    const filterLower = input.filter.toLowerCase();
+                    tools = tools.filter((t) => t.name.toLowerCase().startsWith(filterLower));
+                }
+                const format = input.format || 'json';
+                let output;
+                switch (format) {
+                    case 'markdown':
+                        output = formatToolsAsMarkdown(tools, input.includeExamples);
+                        break;
+                    case 'typescript':
+                        output = generateToolTypes(tools, true);
+                        break;
+                    case 'json':
+                    default:
+                        output = formatToolsAsJson(tools, true);
+                        break;
+                }
+                return {
+                    success: true,
+                    format,
+                    count: tools.length,
+                    content: output,
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        parameterCount: t.parameters.length,
+                    })),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Failed to get tools',
+                };
+            }
+        },
+    });
+    // ========================================================================
+    // MCP Tool: docs_content_types
+    // ========================================================================
+    api.mcp.registerTool('docs_content_types', {
+        description: 'Document all content types and their fields',
+        inputSchema: z.object({
+            format: z
+                .enum(['json', 'markdown', 'typescript'])
+                .optional()
+                .describe('Output format (default: json)'),
+            filter: z.string().optional().describe('Filter by content type name'),
+        }),
+        handler: async (rawInput) => {
+            const input = rawInput;
+            if (!docGenerator) {
+                return { error: 'API Docs plugin not initialized' };
+            }
+            try {
+                let contentTypes = await docGenerator.getContentTypes();
+                // Apply filter if specified
+                if (input.filter) {
+                    const filterLower = input.filter.toLowerCase();
+                    contentTypes = contentTypes.filter((ct) => ct.name.toLowerCase().includes(filterLower) ||
+                        ct.slug.toLowerCase().includes(filterLower));
+                }
+                const format = input.format || 'json';
+                let output;
+                switch (format) {
+                    case 'markdown':
+                        output = formatContentTypesAsMarkdown(contentTypes);
+                        break;
+                    case 'typescript':
+                        output = generateContentTypeTypes(contentTypes, true);
+                        break;
+                    case 'json':
+                    default:
+                        output = formatContentTypesAsJson(contentTypes, true);
+                        break;
+                }
+                return {
+                    success: true,
+                    format,
+                    count: contentTypes.length,
+                    content: output,
+                    contentTypes: contentTypes.map((ct) => ({
+                        name: ct.name,
+                        slug: ct.slug,
+                        fieldCount: ct.fields.length,
+                    })),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Failed to get content types',
+                };
+            }
+        },
+    });
+    // ========================================================================
+    // MCP Tool: docs_export
+    // ========================================================================
+    api.mcp.registerTool('docs_export', {
+        description: 'Export documentation to a file',
+        inputSchema: z.object({
+            format: z
+                .enum(['json', 'markdown', 'openapi', 'typescript'])
+                .describe('Output format'),
+            outputPath: z.string().describe('Output file path'),
+            includeTools: z.boolean().optional(),
+            includeContentTypes: z.boolean().optional(),
+            includeExamples: z.boolean().optional(),
+            baseUrl: z.string().optional().describe('Base URL for endpoints'),
+        }),
+        handler: async (rawInput) => {
+            const input = rawInput;
+            if (!docGenerator) {
+                return { error: 'API Docs plugin not initialized' };
+            }
+            try {
+                const docs = await docGenerator.generate({
+                    includeTools: input.includeTools ?? true,
+                    includeContentTypes: input.includeContentTypes ?? true,
+                    includeEndpoints: true,
+                    includeExamples: input.includeExamples ?? false,
+                });
+                let content;
+                let extension;
+                switch (input.format) {
+                    case 'markdown':
+                        content = formatAsMarkdown(docs, {
+                            includeTableOfContents: true,
+                            includeExamples: input.includeExamples,
+                        });
+                        extension = '.md';
+                        break;
+                    case 'openapi':
+                        content = formatAsOpenApi(docs, {
+                            baseUrl: input.baseUrl || pluginConfig.baseUrl,
+                            outputFormat: 'json',
+                        });
+                        extension = '.json';
+                        break;
+                    case 'typescript': {
+                        const tsOutput = generateTypeScript(docs, {
+                            includeTools: input.includeTools ?? true,
+                            includeContentTypes: input.includeContentTypes ?? true,
+                            includeComments: true,
+                        });
+                        content = tsOutput.code;
+                        extension = '.ts';
+                        break;
+                    }
+                    case 'json':
+                    default:
+                        content = formatAsJson(docs, { pretty: true });
+                        extension = '.json';
+                        break;
+                }
+                // Resolve output path
+                let outputPath = input.outputPath;
+                if (!path.extname(outputPath)) {
+                    outputPath = outputPath + extension;
+                }
+                // Ensure directory exists
+                const dir = path.dirname(outputPath);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                // Write file
+                fs.writeFileSync(outputPath, content, 'utf-8');
+                return {
+                    success: true,
+                    format: input.format,
+                    outputPath: path.resolve(outputPath),
+                    size: Buffer.byteLength(content, 'utf-8'),
+                    stats: {
+                        toolCount: docs.tools.length,
+                        contentTypeCount: docs.contentTypes.length,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Export failed',
+                };
+            }
+        },
+    });
+    // ========================================================================
+    // MCP Tool: docs_endpoints
+    // ========================================================================
+    api.mcp.registerTool('docs_endpoints', {
+        description: 'Generate REST-like endpoint documentation',
+        inputSchema: z.object({
+            format: z
+                .enum(['json', 'markdown', 'openapi'])
+                .optional()
+                .describe('Output format (default: json)'),
+            baseUrl: z.string().optional().describe('Base URL for endpoints'),
+            includeTools: z.boolean().optional().describe('Include tool endpoints'),
+            includeContentTypes: z.boolean().optional().describe('Include content CRUD endpoints'),
+            groupByTag: z.boolean().optional().describe('Group endpoints by tag'),
+        }),
+        handler: async (rawInput) => {
+            const input = rawInput;
+            if (!docGenerator) {
+                return { error: 'API Docs plugin not initialized' };
+            }
+            try {
+                const docs = await docGenerator.generate({
+                    includeTools: input.includeTools ?? true,
+                    includeContentTypes: input.includeContentTypes ?? true,
+                    includeEndpoints: true,
+                });
+                const endpoints = docs.endpoints || [];
+                const format = input.format || 'json';
+                if (format === 'openapi') {
+                    const openApiOutput = formatAsOpenApi(docs, {
+                        baseUrl: input.baseUrl || pluginConfig.baseUrl,
+                        outputFormat: 'json',
+                    });
+                    return {
+                        success: true,
+                        format: 'openapi',
+                        count: endpoints.length,
+                        content: openApiOutput,
+                    };
+                }
+                // Group by tag if requested
+                let output;
+                if (input.groupByTag) {
+                    const grouped = {};
+                    for (const endpoint of endpoints) {
+                        const tag = endpoint.tags?.[0] || 'General';
+                        if (!grouped[tag]) {
+                            grouped[tag] = [];
+                        }
+                        grouped[tag].push(endpoint);
+                    }
+                    output = grouped;
+                }
+                else {
+                    output = endpoints;
+                }
+                if (format === 'markdown') {
+                    const lines = ['# API Endpoints', ''];
+                    if (input.groupByTag) {
+                        const grouped = output;
+                        for (const [tag, tagEndpoints] of Object.entries(grouped)) {
+                            lines.push(`## ${tag}`);
+                            lines.push('');
+                            lines.push('| Method | Path | Summary |');
+                            lines.push('|--------|------|---------|');
+                            for (const ep of tagEndpoints) {
+                                lines.push(`| \`${ep.method}\` | \`${ep.path}\` | ${ep.summary} |`);
+                            }
+                            lines.push('');
+                        }
+                    }
+                    else {
+                        lines.push('| Method | Path | Summary |');
+                        lines.push('|--------|------|---------|');
+                        for (const ep of endpoints) {
+                            lines.push(`| \`${ep.method}\` | \`${ep.path}\` | ${ep.summary} |`);
+                        }
+                    }
+                    return {
+                        success: true,
+                        format: 'markdown',
+                        count: endpoints.length,
+                        content: lines.join('\n'),
+                    };
+                }
+                return {
+                    success: true,
+                    format: 'json',
+                    count: endpoints.length,
+                    content: JSON.stringify(output, null, 2),
+                    endpoints: endpoints.map((e) => ({
+                        method: e.method,
+                        path: e.path,
+                        summary: e.summary,
+                        tags: e.tags,
+                    })),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Failed to get endpoints',
+                };
+            }
+        },
+    });
+    api.logger.info('API Docs plugin registered 5 MCP tools: docs_generate, docs_tools, docs_content_types, docs_export, docs_endpoints');
+}
+export default plugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/services/doc-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Documentation Generator Service
+ * Introspects LokiCMS runtime to generate API documentation
+ */
+import type { PluginAPI, ApiDocsConfig, ApiDocumentation, ToolDocumentation, ContentTypeDocumentation, Logger } from '../types.js';
+/**
+ * Create a documentation generator instance
+ */
+export declare function createDocGenerator(api: PluginAPI, config: ApiDocsConfig, logger: Logger): {
+    generate: (options?: {
+        includeTools?: boolean;
+        includeContentTypes?: boolean;
+        includeEndpoints?: boolean;
+        includeExamples?: boolean;
+        forceRefresh?: boolean;
+    }) => Promise<ApiDocumentation>;
+    getTools: (includeExamples?: boolean) => Promise<ToolDocumentation[]>;
+    getContentTypes: () => Promise<ContentTypeDocumentation[]>;
+    clearCache: () => void;
+};
+export type DocGenerator = ReturnType<typeof createDocGenerator>;
+//# sourceMappingURL=doc-generator.d.ts.map

package/dist/services/doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../src/services/doc-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EAExB,MAAM,EAGP,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM;yBAUmB;QAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,KAAQ,OAAO,CAAC,gBAAgB,CAAC;6CAiYgB,OAAO,CAAC,iBAAiB,EAAE,CAAC;2BAO5C,OAAO,CAAC,wBAAwB,EAAE,CAAC;sBAO9C,IAAI;EAY5B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}