lokicms-plugin-api-docs 1.0.0

package/dist/formatters/openapi-formatter.js

@@ -0,0 +1,505 @@
+/**
+ * OpenAPI Formatter
+ * Outputs API documentation as OpenAPI 3.0 specification
+ */
+/**
+ * Format documentation as OpenAPI 3.0 specification
+ */
+export function formatAsOpenApi(docs, options = {}) {
+    const { baseUrl = 'http://localhost:3000', serverDescription = 'LokiCMS API Server', outputFormat = 'json', } = options;
+    const spec = buildOpenApiSpec(docs, baseUrl, serverDescription);
+    if (outputFormat === 'yaml') {
+        return toYaml(spec);
+    }
+    return JSON.stringify(spec, null, 2);
+}
+/**
+ * Build OpenAPI specification object
+ */
+function buildOpenApiSpec(docs, baseUrl, serverDescription) {
+    const paths = {};
+    const schemas = {};
+    const tags = new Set();
+    // Add tool endpoints
+    for (const tool of docs.tools) {
+        const path = `/mcp/${tool.name}`;
+        const tag = getToolTag(tool.name);
+        tags.add(tag);
+        // Store input schema
+        const schemaName = pascalCase(tool.name) + 'Input';
+        schemas[schemaName] = tool.inputSchema;
+        paths[path] = {
+            post: createToolOperation(tool, schemaName, tag),
+        };
+    }
+    // Add content type endpoints
+    for (const contentType of docs.contentTypes) {
+        const basePath = `/content/${contentType.slug}`;
+        const schemaName = pascalCase(contentType.name);
+        tags.add('Content');
+        // Store content type schema
+        schemas[schemaName] = buildContentTypeSchema(contentType);
+        // List endpoint
+        paths[basePath] = {
+            get: createListOperation(contentType, schemaName),
+            post: createCreateOperation(contentType, schemaName),
+        };
+        // Single item endpoints
+        paths[`${basePath}/{id}`] = {
+            get: createGetOperation(contentType, schemaName),
+            put: createUpdateOperation(contentType, schemaName),
+            delete: createDeleteOperation(contentType),
+        };
+    }
+    // Add endpoint definitions if present
+    if (docs.endpoints) {
+        for (const endpoint of docs.endpoints) {
+            if (!paths[endpoint.path]) {
+                paths[endpoint.path] = {};
+            }
+            const method = endpoint.method.toLowerCase();
+            paths[endpoint.path][method] = createEndpointOperation(endpoint);
+            if (endpoint.tags) {
+                for (const tag of endpoint.tags) {
+                    tags.add(tag);
+                }
+            }
+        }
+    }
+    return {
+        openapi: '3.0.0',
+        info: {
+            title: docs.info.title,
+            version: docs.info.version,
+            description: docs.info.description,
+        },
+        servers: [
+            {
+                url: baseUrl,
+                description: serverDescription,
+            },
+        ],
+        paths,
+        components: {
+            schemas,
+            securitySchemes: {
+                bearerAuth: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    bearerFormat: 'JWT',
+                },
+            },
+        },
+        tags: Array.from(tags).map((name) => ({
+            name,
+            description: getTagDescription(name),
+        })),
+    };
+}
+/**
+ * Create OpenAPI operation for a tool
+ */
+function createToolOperation(tool, schemaName, tag) {
+    return {
+        summary: tool.description,
+        description: `Execute the ${tool.name} MCP tool`,
+        operationId: tool.name,
+        tags: [tag],
+        requestBody: {
+            required: true,
+            content: {
+                'application/json': {
+                    schema: {
+                        $ref: `#/components/schemas/${schemaName}`,
+                    },
+                },
+            },
+        },
+        responses: {
+            '200': {
+                description: 'Successful response',
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'object',
+                        },
+                    },
+                },
+            },
+            '400': {
+                description: 'Invalid input',
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                error: { type: 'string' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    };
+}
+/**
+ * Create list operation for content type
+ */
+function createListOperation(contentType, schemaName) {
+    return {
+        summary: `List ${contentType.name} entries`,
+        operationId: `list${schemaName}`,
+        tags: ['Content'],
+        parameters: [
+            {
+                name: 'limit',
+                in: 'query',
+                description: 'Maximum number of entries to return',
+                schema: { type: 'integer', default: 20 },
+            },
+            {
+                name: 'offset',
+                in: 'query',
+                description: 'Number of entries to skip',
+                schema: { type: 'integer', default: 0 },
+            },
+        ],
+        responses: {
+            '200': {
+                description: 'List of entries',
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'array',
+                            items: { $ref: `#/components/schemas/${schemaName}` },
+                        },
+                    },
+                },
+            },
+        },
+    };
+}
+/**
+ * Create get operation for content type
+ */
+function createGetOperation(contentType, schemaName) {
+    return {
+        summary: `Get ${contentType.name} by ID`,
+        operationId: `get${schemaName}`,
+        tags: ['Content'],
+        parameters: [
+            {
+                name: 'id',
+                in: 'path',
+                required: true,
+                description: 'Entry ID',
+                schema: { type: 'string' },
+            },
+        ],
+        responses: {
+            '200': {
+                description: 'Entry details',
+                content: {
+                    'application/json': {
+                        schema: { $ref: `#/components/schemas/${schemaName}` },
+                    },
+                },
+            },
+            '404': {
+                description: 'Entry not found',
+            },
+        },
+    };
+}
+/**
+ * Create create operation for content type
+ */
+function createCreateOperation(contentType, schemaName) {
+    return {
+        summary: `Create ${contentType.name}`,
+        operationId: `create${schemaName}`,
+        tags: ['Content'],
+        requestBody: {
+            required: true,
+            content: {
+                'application/json': {
+                    schema: { $ref: `#/components/schemas/${schemaName}` },
+                },
+            },
+        },
+        responses: {
+            '201': {
+                description: 'Entry created',
+                content: {
+                    'application/json': {
+                        schema: { $ref: `#/components/schemas/${schemaName}` },
+                    },
+                },
+            },
+            '400': {
+                description: 'Invalid input',
+            },
+        },
+    };
+}
+/**
+ * Create update operation for content type
+ */
+function createUpdateOperation(contentType, schemaName) {
+    return {
+        summary: `Update ${contentType.name}`,
+        operationId: `update${schemaName}`,
+        tags: ['Content'],
+        parameters: [
+            {
+                name: 'id',
+                in: 'path',
+                required: true,
+                description: 'Entry ID',
+                schema: { type: 'string' },
+            },
+        ],
+        requestBody: {
+            required: true,
+            content: {
+                'application/json': {
+                    schema: { $ref: `#/components/schemas/${schemaName}` },
+                },
+            },
+        },
+        responses: {
+            '200': {
+                description: 'Entry updated',
+                content: {
+                    'application/json': {
+                        schema: { $ref: `#/components/schemas/${schemaName}` },
+                    },
+                },
+            },
+            '404': {
+                description: 'Entry not found',
+            },
+        },
+    };
+}
+/**
+ * Create delete operation for content type
+ */
+function createDeleteOperation(contentType) {
+    return {
+        summary: `Delete ${contentType.name}`,
+        operationId: `delete${pascalCase(contentType.name)}`,
+        tags: ['Content'],
+        parameters: [
+            {
+                name: 'id',
+                in: 'path',
+                required: true,
+                description: 'Entry ID',
+                schema: { type: 'string' },
+            },
+        ],
+        responses: {
+            '204': {
+                description: 'Entry deleted',
+            },
+            '404': {
+                description: 'Entry not found',
+            },
+        },
+    };
+}
+/**
+ * Create operation from endpoint documentation
+ */
+function createEndpointOperation(endpoint) {
+    const operation = {
+        summary: endpoint.summary,
+        description: endpoint.description,
+        tags: endpoint.tags || ['General'],
+        responses: {},
+    };
+    if (endpoint.parameters) {
+        operation.parameters = endpoint.parameters.map((p) => ({
+            name: p.name,
+            in: p.name === 'id' ? 'path' : 'query',
+            required: p.required,
+            description: p.description,
+            schema: { type: p.type },
+        }));
+    }
+    if (endpoint.requestBody) {
+        operation.requestBody = {
+            required: true,
+            content: {
+                'application/json': {
+                    schema: endpoint.requestBody,
+                },
+            },
+        };
+    }
+    if (endpoint.responses) {
+        for (const [code, response] of Object.entries(endpoint.responses)) {
+            operation.responses[code] = {
+                description: response.description,
+                ...(response.schema
+                    ? {
+                        content: {
+                            'application/json': {
+                                schema: response.schema,
+                            },
+                        },
+                    }
+                    : {}),
+            };
+        }
+    }
+    else {
+        operation.responses['200'] = { description: 'Success' };
+    }
+    return operation;
+}
+/**
+ * Build JSON Schema from content type
+ */
+function buildContentTypeSchema(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: fieldTypeToSchemaType(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 fieldTypeToSchemaType(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 tag from name
+ */
+function getToolTag(toolName) {
+    const prefix = toolName.split('_')[0];
+    const tags = {
+        vault: 'Vault',
+        sql: 'SQL',
+        mongodb: 'MongoDB',
+        vectors: 'Vectors',
+        backup: 'Backup',
+        docs: 'Documentation',
+        content: 'Content',
+        media: 'Media',
+        auth: 'Authentication',
+    };
+    return tags[prefix] || 'General';
+}
+/**
+ * Get tag description
+ */
+function getTagDescription(tag) {
+    const descriptions = {
+        Vault: 'Secure credential storage and management',
+        SQL: 'SQL database operations',
+        MongoDB: 'MongoDB database operations',
+        Vectors: 'Vector search and embeddings',
+        Backup: 'Backup and restore operations',
+        Documentation: 'API documentation generation',
+        Content: 'Content management operations',
+        Media: 'Media file operations',
+        Authentication: 'Authentication and authorization',
+        General: 'General operations',
+    };
+    return descriptions[tag] || `${tag} operations`;
+}
+/**
+ * Convert string to PascalCase
+ */
+function pascalCase(str) {
+    return str
+        .split(/[_-]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Simple YAML converter (basic implementation)
+ */
+function toYaml(obj, indent = 0) {
+    const spaces = '  '.repeat(indent);
+    if (obj === null || obj === undefined) {
+        return 'null';
+    }
+    if (typeof obj === 'string') {
+        if (obj.includes('\n') || obj.includes(':') || obj.includes('#')) {
+            return `"${obj.replace(/"/g, '\\"')}"`;
+        }
+        return obj;
+    }
+    if (typeof obj === 'number' || typeof obj === 'boolean') {
+        return String(obj);
+    }
+    if (Array.isArray(obj)) {
+        if (obj.length === 0)
+            return '[]';
+        return obj
+            .map((item) => {
+            const value = toYaml(item, indent + 1);
+            if (typeof item === 'object' && item !== null) {
+                return `${spaces}- ${value.trim().split('\n').join(`\n${spaces}  `)}`;
+            }
+            return `${spaces}- ${value}`;
+        })
+            .join('\n');
+    }
+    if (typeof obj === 'object') {
+        const entries = Object.entries(obj);
+        if (entries.length === 0)
+            return '{}';
+        return entries
+            .map(([key, value]) => {
+            if (value === undefined)
+                return '';
+            const yamlValue = toYaml(value, indent + 1);
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                return `${spaces}${key}:\n${yamlValue}`;
+            }
+            if (Array.isArray(value)) {
+                return `${spaces}${key}:\n${yamlValue}`;
+            }
+            return `${spaces}${key}: ${yamlValue}`;
+        })
+            .filter(Boolean)
+            .join('\n');
+    }
+    return String(obj);
+}
+//# sourceMappingURL=openapi-formatter.js.map

package/dist/formatters/openapi-formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LokiCMS API Docs Plugin
+ *
+ * Generates API documentation from LokiCMS runtime with support for
+ * JSON, Markdown, OpenAPI 3.0, and TypeScript output formats.
+ */
+export { default } from './plugin.js';
+export { getDocGenerator } from './plugin.js';
+export type { ApiDocsConfig, ApiDocumentation, ToolDocumentation, ContentTypeDocumentation, EndpointDocumentation, ParameterDoc, JsonSchema, JsonSchemaProperty, OpenApiSpec, TypeScriptOutput, TypeScriptInterface, OutputFormat, PluginDefinition, PluginAPI, Logger, } from './types.js';
+export { createDocGenerator, type DocGenerator } from './services/doc-generator.js';
+export { zodToJsonSchema, extractParameters, generateExample } from './services/schema-converter.js';
+export { generateTypeScript, generateToolTypes, generateContentTypeTypes, jsonSchemaToTypeScript, } from './services/typescript-generator.js';
+export { formatAsJson, formatToolsAsJson, formatContentTypesAsJson, formatEndpointsAsJson, } from './formatters/json-formatter.js';
+export { formatAsMarkdown, formatToolsAsMarkdown, formatContentTypesAsMarkdown, } from './formatters/markdown-formatter.js';
+export { formatAsOpenApi } from './formatters/openapi-formatter.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;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,MAAM,GACP,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACrG,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * LokiCMS API Docs Plugin
+ *
+ * Generates API documentation from LokiCMS runtime with support for
+ * JSON, Markdown, OpenAPI 3.0, and TypeScript output formats.
+ */
+// Main plugin export
+export { default } from './plugin.js';
+export { getDocGenerator } from './plugin.js';
+// Services
+export { createDocGenerator } from './services/doc-generator.js';
+export { zodToJsonSchema, extractParameters, generateExample } from './services/schema-converter.js';
+export { generateTypeScript, generateToolTypes, generateContentTypeTypes, jsonSchemaToTypeScript, } from './services/typescript-generator.js';
+// Formatters
+export { formatAsJson, formatToolsAsJson, formatContentTypesAsJson, formatEndpointsAsJson, } from './formatters/json-formatter.js';
+export { formatAsMarkdown, formatToolsAsMarkdown, formatContentTypesAsMarkdown, } from './formatters/markdown-formatter.js';
+export { formatAsOpenApi } from './formatters/openapi-formatter.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;;;;;GAKG;AAEH,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAqB9C,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAqB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACrG,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,aAAa;AACb,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LokiCMS API Docs Plugin
+ *
+ * Generates API documentation from LokiCMS runtime with support for
+ * JSON, Markdown, OpenAPI 3.0, and TypeScript output formats.
+ */
+import type { PluginDefinition } from './types.js';
+import { DocGenerator } from './services/doc-generator.js';
+/**
+ * Get the documentation generator instance
+ */
+export declare function getDocGenerator(): DocGenerator;
+/**
+ * LokiCMS API Docs Plugin Definition
+ */
+declare const plugin: PluginDefinition;
+export default plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAsB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAU/E;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,QAAA,MAAM,MAAM,EAAE,gBAkBb,CAAC;AAseF,eAAe,MAAM,CAAC"}