lokicms-plugin-api-docs 1.0.0

package/dist/services/doc-generator.js

@@ -0,0 +1,370 @@
+/**
+ * Documentation Generator Service
+ * Introspects LokiCMS runtime to generate API documentation
+ */
+import { zodToJsonSchema, extractParameters } from './schema-converter.js';
+/**
+ * Create a documentation generator instance
+ */
+export function createDocGenerator(api, config, logger) {
+    // Cache for generated documentation
+    let cachedDocs = null;
+    let cacheTimestamp = 0;
+    const CACHE_TTL_MS = 60000; // 1 minute
+    /**
+     * Generate complete API documentation
+     */
+    async function generate(options = {}) {
+        const { includeTools = true, includeContentTypes = true, includeEndpoints = true, includeExamples = config.includeExamples ?? false, forceRefresh = false, } = options;
+        // Return cached if still valid
+        if (!forceRefresh && cachedDocs && Date.now() - cacheTimestamp < CACHE_TTL_MS) {
+            return cachedDocs;
+        }
+        logger.debug('Generating API documentation');
+        const docs = {
+            info: {
+                title: config.title || 'LokiCMS API',
+                version: config.version || '1.0.0',
+                description: config.description || 'LokiCMS API Documentation',
+                generatedAt: new Date().toISOString(),
+            },
+            tools: [],
+            contentTypes: [],
+            endpoints: [],
+        };
+        if (includeTools) {
+            docs.tools = await introspectTools(includeExamples);
+        }
+        if (includeContentTypes) {
+            docs.contentTypes = await introspectContentTypes();
+        }
+        if (includeEndpoints) {
+            docs.endpoints = generateEndpoints(docs.tools, docs.contentTypes);
+        }
+        // Update cache
+        cachedDocs = docs;
+        cacheTimestamp = Date.now();
+        logger.info(`Generated documentation: ${docs.tools.length} tools, ${docs.contentTypes.length} content types`);
+        return docs;
+    }
+    /**
+     * Introspect registered MCP tools
+     */
+    async function introspectTools(includeExamples = false) {
+        const tools = [];
+        // Try to get tools from MCP API
+        const mcpTools = api.mcp.getTools?.() || new Map();
+        for (const [name, definition] of mcpTools) {
+            try {
+                const inputSchema = zodToJsonSchema(definition.inputSchema, includeExamples);
+                const parameters = extractParameters(definition.inputSchema, includeExamples);
+                const toolDoc = {
+                    name,
+                    description: definition.description,
+                    parameters,
+                    inputSchema,
+                };
+                if (includeExamples) {
+                    toolDoc.examples = generateToolExamples(name, parameters);
+                }
+                tools.push(toolDoc);
+            }
+            catch (error) {
+                logger.warn(`Failed to document tool ${name}: ${error}`);
+            }
+        }
+        // Sort alphabetically
+        tools.sort((a, b) => a.name.localeCompare(b.name));
+        return tools;
+    }
+    /**
+     * Introspect content types
+     */
+    async function introspectContentTypes() {
+        const contentTypes = [];
+        // Try to get content types from content API
+        const types = api.content?.getContentTypes?.() || [];
+        for (const type of types) {
+            contentTypes.push({
+                name: type.name,
+                slug: type.slug,
+                description: type.description,
+                fields: type.fields.map((field) => ({
+                    name: field.name,
+                    type: field.type,
+                    required: field.required ?? false,
+                    description: field.description,
+                    options: field.options,
+                })),
+            });
+        }
+        // Sort alphabetically
+        contentTypes.sort((a, b) => a.name.localeCompare(b.name));
+        return contentTypes;
+    }
+    /**
+     * Generate REST-like endpoint documentation from tools
+     */
+    function generateEndpoints(tools, contentTypes) {
+        const endpoints = [];
+        const baseUrl = config.baseUrl || '/mcp';
+        // Generate endpoints for each tool
+        for (const tool of tools) {
+            endpoints.push({
+                method: 'POST',
+                path: `${baseUrl}/${tool.name}`,
+                summary: tool.description,
+                description: `Execute the ${tool.name} MCP tool`,
+                requestBody: tool.inputSchema,
+                responses: {
+                    '200': {
+                        description: 'Successful response',
+                        schema: { type: 'object' },
+                    },
+                    '400': {
+                        description: 'Invalid input',
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                error: { type: 'string' },
+                            },
+                        },
+                    },
+                },
+                tags: [getToolCategory(tool.name)],
+            });
+        }
+        // Generate CRUD endpoints for content types
+        for (const contentType of contentTypes) {
+            const basePath = `${baseUrl}/content/${contentType.slug}`;
+            // List
+            endpoints.push({
+                method: 'GET',
+                path: basePath,
+                summary: `List ${contentType.name} entries`,
+                description: `Retrieve a list of ${contentType.name} entries`,
+                parameters: [
+                    { name: 'limit', type: 'number', required: false, description: 'Maximum entries to return' },
+                    { name: 'offset', type: 'number', required: false, description: 'Number of entries to skip' },
+                ],
+                responses: {
+                    '200': {
+                        description: 'List of entries',
+                        schema: {
+                            type: 'array',
+                            items: generateContentTypeSchema(contentType),
+                        },
+                    },
+                },
+                tags: ['Content'],
+            });
+            // Get by ID
+            endpoints.push({
+                method: 'GET',
+                path: `${basePath}/{id}`,
+                summary: `Get ${contentType.name} by ID`,
+                description: `Retrieve a single ${contentType.name} entry by its ID`,
+                parameters: [
+                    { name: 'id', type: 'string', required: true, description: 'Entry ID' },
+                ],
+                responses: {
+                    '200': {
+                        description: 'Entry details',
+                        schema: generateContentTypeSchema(contentType),
+                    },
+                    '404': {
+                        description: 'Entry not found',
+                    },
+                },
+                tags: ['Content'],
+            });
+            // Create
+            endpoints.push({
+                method: 'POST',
+                path: basePath,
+                summary: `Create ${contentType.name}`,
+                description: `Create a new ${contentType.name} entry`,
+                requestBody: generateContentTypeSchema(contentType),
+                responses: {
+                    '201': {
+                        description: 'Entry created',
+                        schema: generateContentTypeSchema(contentType),
+                    },
+                    '400': {
+                        description: 'Invalid input',
+                    },
+                },
+                tags: ['Content'],
+            });
+            // Update
+            endpoints.push({
+                method: 'PUT',
+                path: `${basePath}/{id}`,
+                summary: `Update ${contentType.name}`,
+                description: `Update an existing ${contentType.name} entry`,
+                parameters: [
+                    { name: 'id', type: 'string', required: true, description: 'Entry ID' },
+                ],
+                requestBody: generateContentTypeSchema(contentType),
+                responses: {
+                    '200': {
+                        description: 'Entry updated',
+                        schema: generateContentTypeSchema(contentType),
+                    },
+                    '404': {
+                        description: 'Entry not found',
+                    },
+                },
+                tags: ['Content'],
+            });
+            // Delete
+            endpoints.push({
+                method: 'DELETE',
+                path: `${basePath}/{id}`,
+                summary: `Delete ${contentType.name}`,
+                description: `Delete a ${contentType.name} entry`,
+                parameters: [
+                    { name: 'id', type: 'string', required: true, description: 'Entry ID' },
+                ],
+                responses: {
+                    '204': {
+                        description: 'Entry deleted',
+                    },
+                    '404': {
+                        description: 'Entry not found',
+                    },
+                },
+                tags: ['Content'],
+            });
+        }
+        return endpoints;
+    }
+    /**
+     * Generate JSON Schema from content type
+     */
+    function generateContentTypeSchema(contentType) {
+        const properties = {
+            id: { type: 'string', description: 'Unique identifier' },
+            createdAt: { type: 'string', format: 'date-time' },
+            updatedAt: { type: 'string', format: 'date-time' },
+        };
+        const required = ['id'];
+        for (const field of contentType.fields) {
+            properties[field.name] = {
+                type: fieldTypeToJsonType(field.type),
+                description: field.description,
+            };
+            if (field.required) {
+                required.push(field.name);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required,
+        };
+    }
+    /**
+     * Convert field type to JSON Schema type
+     */
+    function fieldTypeToJsonType(fieldType) {
+        const typeMap = {
+            string: 'string',
+            text: 'string',
+            richtext: 'string',
+            number: 'number',
+            integer: 'integer',
+            boolean: 'boolean',
+            date: 'string',
+            datetime: 'string',
+            array: 'array',
+            object: 'object',
+            reference: 'string',
+            media: 'string',
+            json: 'object',
+        };
+        return typeMap[fieldType.toLowerCase()] || 'string';
+    }
+    /**
+     * Get tool category from name
+     */
+    function getToolCategory(toolName) {
+        const prefix = toolName.split('_')[0];
+        const categories = {
+            vault: 'Vault',
+            sql: 'SQL',
+            mongodb: 'MongoDB',
+            vectors: 'Vectors',
+            backup: 'Backup',
+            docs: 'Documentation',
+            content: 'Content',
+            media: 'Media',
+            auth: 'Authentication',
+        };
+        return categories[prefix] || 'General';
+    }
+    /**
+     * Generate example inputs for a tool
+     */
+    function generateToolExamples(toolName, parameters) {
+        const example = {};
+        for (const param of parameters) {
+            if (param.required) {
+                example[param.name] = param.example ?? param.default ?? getDefaultValue(param.type);
+            }
+        }
+        return [
+            {
+                name: 'Basic usage',
+                input: example,
+                description: `Basic example for ${toolName}`,
+            },
+        ];
+    }
+    /**
+     * Get default value for a type
+     */
+    function getDefaultValue(type) {
+        switch (type) {
+            case 'string':
+                return 'example';
+            case 'number':
+                return 0;
+            case 'boolean':
+                return true;
+            case 'array':
+                return [];
+            case 'object':
+                return {};
+            default:
+                return null;
+        }
+    }
+    /**
+     * Get tools list only
+     */
+    async function getTools(includeExamples = false) {
+        return introspectTools(includeExamples);
+    }
+    /**
+     * Get content types only
+     */
+    async function getContentTypes() {
+        return introspectContentTypes();
+    }
+    /**
+     * Clear documentation cache
+     */
+    function clearCache() {
+        cachedDocs = null;
+        cacheTimestamp = 0;
+        logger.debug('Documentation cache cleared');
+    }
+    return {
+        generate,
+        getTools,
+        getContentTypes,
+        clearCache,
+    };
+}
+//# sourceMappingURL=doc-generator.js.map

package/dist/services/doc-generator.js.map

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

package/dist/services/schema-converter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Schema Converter Service
+ * Converts Zod schemas to JSON Schema format
+ */
+import type { z } from 'zod';
+import type { JsonSchema, JsonSchemaProperty, ParameterDoc } from '../types.js';
+/**
+ * Convert a Zod schema to JSON Schema format
+ */
+export declare function zodToJsonSchema(schema: z.ZodType, includeExamples?: boolean): JsonSchema;
+/**
+ * Extract parameter documentation from a Zod object schema
+ */
+export declare function extractParameters(schema: z.ZodType, includeExamples?: boolean): ParameterDoc[];
+/**
+ * Generate example value for a JSON Schema property
+ */
+export declare function generateExample(schema: JsonSchemaProperty): unknown;
+//# sourceMappingURL=schema-converter.d.ts.map

package/dist/services/schema-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.ts","sourceRoot":"","sources":["../../src/services/schema-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsBhF;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,UAAQ,GAAG,UAAU,CAMtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,UAAQ,GAAG,YAAY,EAAE,CAgD5F;AA2TD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAkDnE"}