archetype-engine 2.0.1 → 2.2.0

package/dist/src/mcp-server.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MCP Server for Archetype Engine
+ *
+ * Provides tools for Claude Desktop, Claude Code, Cursor, and other MCP clients
+ * to generate backends from entity descriptions.
+ *
+ * Usage:
+ *   npx archetype-engine mcp
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMCPServer = runMCPServer;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const parser_1 = require("./json/parser");
+const validation_1 = require("./validation");
+const template_1 = require("./template");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Handle archetype_create_manifest tool
+ */
+async function handleCreateManifest(args) {
+    const manifest = {
+        entities: args.entities,
+        database: args.database,
+        auth: args.auth,
+        template: 'nextjs-drizzle-trpc'
+    };
+    // Validate first
+    const validation = (0, validation_1.validateManifest)(manifest);
+    if (!validation.valid) {
+        const errors = validation.errors.map(e => `[${e.code}] ${e.path}: ${e.message}`).join('\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Validation failed:\n\n${errors}\n\n${validation.errors.map(e => e.suggestion).filter(Boolean).join('\n')}`
+                }]
+        };
+    }
+    // Write manifest.json
+    const manifestPath = path.join(process.cwd(), 'manifest.json');
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    return {
+        content: [{
+                type: 'text',
+                text: `✅ Created manifest.json with ${args.entities.length} entities\n\nNext steps:\n1. Review manifest.json\n2. Run: npx archetype generate manifest.json\n3. Run: npx drizzle-kit push && npm run dev`
+            }]
+    };
+}
+/**
+ * Handle archetype_validate_manifest tool
+ */
+async function handleValidate(args) {
+    const manifestPath = path.resolve(args.manifestPath || 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Manifest not found: ${manifestPath}`
+                }]
+        };
+    }
+    const content = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(content);
+    const validation = (0, validation_1.validateManifest)(manifest);
+    if (validation.valid) {
+        const warnings = validation.warnings.length > 0
+            ? `\n\nWarnings:\n${validation.warnings.map(w => `  - [${w.code}] ${w.message}`).join('\n')}`
+            : '';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✅ Manifest is valid!${warnings}\n\nReady to generate with: npx archetype generate ${manifestPath}`
+                }]
+        };
+    }
+    else {
+        const errors = validation.errors.map(e => `  - [${e.code}] ${e.path}: ${e.message}${e.suggestion ? `\n    Fix: ${e.suggestion}` : ''}`).join('\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Validation failed:\n\n${errors}`
+                }]
+        };
+    }
+}
+/**
+ * Handle archetype_generate tool
+ */
+async function handleGenerate(args) {
+    const manifestPath = path.resolve(args.manifestPath || 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Manifest not found: ${manifestPath}`
+                }]
+        };
+    }
+    const content = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(content);
+    // Validate
+    const validation = (0, validation_1.validateManifest)(manifest);
+    if (!validation.valid) {
+        const errors = validation.errors.map(e => `[${e.code}] ${e.message}`).join('\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Validation failed:\n\n${errors}\n\nRun: npx archetype validate ${manifestPath}`
+                }]
+        };
+    }
+    // Parse and generate
+    const ir = (0, parser_1.parseManifestJSON)(manifest);
+    const template = await (0, template_1.getTemplate)('nextjs-drizzle-trpc');
+    if (!template) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: '❌ Template not found'
+                }]
+        };
+    }
+    const files = await (0, template_1.runTemplate)(template, ir);
+    const fileList = files.map(f => f.path).join('\n  - ');
+    return {
+        content: [{
+                type: 'text',
+                text: `✅ Generated ${files.length} files:\n  - ${fileList}\n\nNext steps:\n1. Run: npx drizzle-kit push\n2. Run: npm run dev`
+            }]
+    };
+}
+/**
+ * Handle archetype_view_schema tool
+ */
+async function handleViewSchema(args) {
+    const configPath = args.configPath || 'manifest.json';
+    try {
+        const { stdout } = await execAsync(`npx archetype view ${configPath}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✅ Opening ERD viewer in browser...\n\n${stdout}`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Failed to open viewer: ${error.message}`
+                }]
+        };
+    }
+}
+/**
+ * Handle archetype_generate_from_description tool
+ * This is a convenience wrapper that uses AI to convert natural language to manifest
+ */
+async function handleGenerateFromDescription(args) {
+    return {
+        content: [{
+                type: 'text',
+                text: `⚠️  This tool requires an AI model to convert the description to entities.\n\nInstead, I recommend:\n1. Use archetype_create_manifest to define entities explicitly\n2. Or create manifest.json manually based on: ${args.description}\n\nExample entities for "${args.description}":\n- Identify the main data types (User, Post, Product, etc.)\n- Define fields for each entity\n- Add relations between entities\n\nThen use archetype_create_manifest with the entity definitions.`
+            }]
+    };
+}
+/**
+ * Main MCP server loop
+ */
+async function runMCPServer() {
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    stdin.setEncoding('utf-8');
+    let buffer = '';
+    stdin.on('data', async (chunk) => {
+        buffer += chunk;
+        // Process complete JSON messages
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const request = JSON.parse(line);
+                if (request.method === 'tools/call' && request.params) {
+                    const toolName = request.params.name;
+                    const args = request.params.arguments || {};
+                    let response;
+                    switch (toolName) {
+                        case 'archetype_create_manifest':
+                            response = await handleCreateManifest(args);
+                            break;
+                        case 'archetype_validate_manifest':
+                            response = await handleValidate(args);
+                            break;
+                        case 'archetype_generate':
+                            response = await handleGenerate(args);
+                            break;
+                        case 'archetype_view_schema':
+                            response = await handleViewSchema(args);
+                            break;
+                        case 'archetype_generate_from_description':
+                            response = await handleGenerateFromDescription(args);
+                            break;
+                        default:
+                            response = {
+                                content: [{
+                                        type: 'text',
+                                        text: `Unknown tool: ${toolName}`
+                                    }]
+                            };
+                    }
+                    stdout.write(JSON.stringify(response) + '\n');
+                }
+            }
+            catch (error) {
+                const errorResponse = {
+                    content: [{
+                            type: 'text',
+                            text: `Error: ${error.message}`
+                        }]
+                };
+                stdout.write(JSON.stringify(errorResponse) + '\n');
+            }
+        }
+    });
+    stdin.on('end', () => {
+        process.exit(0);
+    });
+}
+// Run if called directly
+if (require.main === module) {
+    runMCPServer().catch(console.error);
+}

package/dist/src/templates/nextjs-drizzle-trpc/generators/index.d.ts

@@ -5,4 +5,7 @@ export { apiGenerator } from './api';
 export { hooksGenerator } from './hooks';
 export { crudHooksGenerator } from './crud-hooks';
 export { i18nGenerator } from './i18n';
+export { testGenerator } from './test';
+export { openapiGenerator } from './openapi';
+export { seedGenerator } from './seed';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/templates/nextjs-drizzle-trpc/generators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/templates/nextjs-drizzle-trpc/generators/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/templates/nextjs-drizzle-trpc/generators/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA"}

package/dist/src/templates/nextjs-drizzle-trpc/generators/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // Export all generators for the nextjs-drizzle-trpc template
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.i18nGenerator = exports.crudHooksGenerator = exports.hooksGenerator = exports.apiGenerator = exports.validationGenerator = exports.authGenerator = exports.schemaGenerator = void 0;
+exports.seedGenerator = exports.openapiGenerator = exports.testGenerator = exports.i18nGenerator = exports.crudHooksGenerator = exports.hooksGenerator = exports.apiGenerator = exports.validationGenerator = exports.authGenerator = exports.schemaGenerator = void 0;
 var schema_1 = require("./schema");
 Object.defineProperty(exports, "schemaGenerator", { enumerable: true, get: function () { return schema_1.schemaGenerator; } });
 var auth_1 = require("./auth");
@@ -16,3 +16,9 @@ var crud_hooks_1 = require("./crud-hooks");
 Object.defineProperty(exports, "crudHooksGenerator", { enumerable: true, get: function () { return crud_hooks_1.crudHooksGenerator; } });
 var i18n_1 = require("./i18n");
 Object.defineProperty(exports, "i18nGenerator", { enumerable: true, get: function () { return i18n_1.i18nGenerator; } });
+var test_1 = require("./test");
+Object.defineProperty(exports, "testGenerator", { enumerable: true, get: function () { return test_1.testGenerator; } });
+var openapi_1 = require("./openapi");
+Object.defineProperty(exports, "openapiGenerator", { enumerable: true, get: function () { return openapi_1.openapiGenerator; } });
+var seed_1 = require("./seed");
+Object.defineProperty(exports, "seedGenerator", { enumerable: true, get: function () { return seed_1.seedGenerator; } });

package/dist/src/templates/nextjs-drizzle-trpc/generators/openapi.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenAPI/Swagger Documentation Generator
+ *
+ * Generates OpenAPI 3.0 specification from entity definitions and tRPC routers.
+ * Provides interactive API documentation via Swagger UI.
+ *
+ * Generated files:
+ * - docs/openapi.json - OpenAPI 3.0 specification
+ * - docs/swagger.html - Interactive Swagger UI
+ *
+ * Features:
+ * - Complete API documentation for all CRUD endpoints
+ * - Request/response schemas derived from Zod validation
+ * - Authentication/authorization documentation
+ * - Filter, search, and pagination parameter docs
+ * - Batch operation endpoints
+ * - Interactive testing via Swagger UI
+ *
+ * @module generators/openapi
+ */
+import type { Generator } from '../../../template/types';
+/**
+ * OpenAPI documentation generator
+ */
+export declare const openapiGenerator: Generator;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/src/templates/nextjs-drizzle-trpc/generators/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../../../src/templates/nextjs-drizzle-trpc/generators/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAA;AA+sBvE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SA4B9B,CAAA"}