@l4yercak3/cli 1.3.1 → 2.0.0-alpha.0

package/src/generators/gitignore-generator.js

@@ -1,92 +0,0 @@
-/**
- * Gitignore Generator
- * Updates .gitignore to ensure sensitive files are not committed
- */
-
-const fs = require('fs');
-const path = require('path');
-
-class GitignoreGenerator {
-  /**
-   * Update .gitignore file
-   */
-  generate(options) {
-    const { projectPath } = options;
-    const gitignorePath = path.join(projectPath, '.gitignore');
-    
-    // Required entries to ensure are present
-    const requiredEntries = [
-      '# L4YERCAK3 Configuration',
-      '.env.local',
-      '.env*.local',
-      '.l4yercak3/',
-    ];
-
-    let gitignoreContent = '';
-    let needsUpdate = false;
-
-    // Read existing .gitignore if it exists
-    if (fs.existsSync(gitignorePath)) {
-      gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
-    }
-
-    // Check if required entries are missing
-    for (const entry of requiredEntries) {
-      // Skip comment lines for checking
-      if (entry.startsWith('#')) {
-        if (!gitignoreContent.includes(entry)) {
-          needsUpdate = true;
-        }
-      } else {
-        // Check for the actual entry (with or without leading/trailing whitespace)
-        const entryRegex = new RegExp(`^\\s*${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*$`, 'm');
-        if (!entryRegex.test(gitignoreContent)) {
-          needsUpdate = true;
-        }
-      }
-    }
-
-    // If no update needed, return null
-    if (!needsUpdate && gitignoreContent) {
-      return null;
-    }
-
-    // Append required entries if they're missing
-    if (needsUpdate) {
-      if (gitignoreContent && !gitignoreContent.endsWith('\n')) {
-        gitignoreContent += '\n';
-      }
-      
-      // Add section header if not present
-      if (!gitignoreContent.includes('# L4YERCAK3 Configuration')) {
-        gitignoreContent += '\n# L4YERCAK3 Configuration\n';
-        gitignoreContent += '# Auto-generated by @l4yercak3/cli\n';
-        gitignoreContent += '# DO NOT commit sensitive configuration files\n\n';
-      }
-
-      // Add entries if missing
-      const entriesToAdd = [
-        '.env.local',
-        '.env*.local',
-        '.l4yercak3/',
-      ];
-
-      for (const entry of entriesToAdd) {
-        const entryRegex = new RegExp(`^\\s*${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*$`, 'm');
-        if (!entryRegex.test(gitignoreContent)) {
-          gitignoreContent += `${entry}\n`;
-        }
-      }
-    }
-
-    // Write updated .gitignore
-    fs.writeFileSync(gitignorePath, gitignoreContent, 'utf8');
-    return gitignorePath;
-  }
-}
-
-module.exports = new GitignoreGenerator();
-
-
-
-

package/src/generators/index.js

@@ -1,166 +0,0 @@
-/**
- * File Generators
- * Main entry point for all file generation
- *
- * Supports multiple frameworks:
- * - nextjs: Next.js (App Router and Pages Router)
- * - expo: Expo/React Native
- *
- * Supports multiple integration paths:
- * - quickstart: Full-stack with UI components & database
- * - api-only: Just the typed API client
- * - mcp-assisted: AI-powered custom generation
- */
-
-const apiClientGenerator = require('./api-client-generator');
-const envGenerator = require('./env-generator');
-const nextauthGenerator = require('./nextauth-generator');
-const oauthGuideGenerator = require('./oauth-guide-generator');
-const gitignoreGenerator = require('./gitignore-generator');
-const apiOnlyGenerator = require('./api-only');
-const mcpGuideGenerator = require('./mcp-guide-generator');
-const quickstartGenerator = require('./quickstart');
-
-class FileGenerator {
-  /**
-   * Check if framework is a mobile platform
-   */
-  isMobileFramework(frameworkType) {
-    return ['expo', 'react-native'].includes(frameworkType);
-  }
-
-  /**
-   * Check if framework is Next.js
-   */
-  isNextJs(frameworkType) {
-    return frameworkType === 'nextjs';
-  }
-
-  /**
-   * Generate all files based on configuration
-   */
-  async generate(options) {
-    const integrationPath = options.integrationPath || 'api-only';
-
-    // Route to the appropriate generator based on integration path
-    switch (integrationPath) {
-      case 'api-only':
-        return this.generateApiOnly(options);
-      case 'mcp-assisted':
-        return this.generateMcpAssisted(options);
-      case 'quickstart':
-        return this.generateQuickStart(options);
-      default:
-        return this.generateLegacy(options);
-    }
-  }
-
-  /**
-   * API-Only path: Generate typed API client and types
-   */
-  async generateApiOnly(options) {
-    const results = {
-      apiClient: null,
-      types: null,
-      webhooks: null,
-      index: null,
-      envFile: null,
-      gitignore: null,
-    };
-
-    // Generate the full typed API client package
-    const apiOnlyResults = await apiOnlyGenerator.generate(options);
-    results.apiClient = apiOnlyResults.client;
-    results.types = apiOnlyResults.types;
-    results.webhooks = apiOnlyResults.webhooks;
-    results.index = apiOnlyResults.index;
-
-    // Generate environment file
-    results.envFile = envGenerator.generate(options);
-
-    // Update .gitignore
-    results.gitignore = gitignoreGenerator.generate(options);
-
-    return results;
-  }
-
-  /**
-   * MCP-Assisted path: Generate MCP config and guide
-   */
-  async generateMcpAssisted(options) {
-    const results = {
-      mcpConfig: null,
-      mcpGuide: null,
-      envFile: null,
-      gitignore: null,
-    };
-
-    // Generate MCP configuration and guide
-    const mcpResults = await mcpGuideGenerator.generate(options);
-    results.mcpConfig = mcpResults.config;
-    results.mcpGuide = mcpResults.guide;
-
-    // Generate environment file
-    results.envFile = envGenerator.generate(options);
-
-    // Update .gitignore
-    results.gitignore = gitignoreGenerator.generate(options);
-
-    return results;
-  }
-
-  /**
-   * Quick Start path: Full-stack generation with database, hooks, and components
-   */
-  async generateQuickStart(options) {
-    return quickstartGenerator.generate(options);
-  }
-
-  /**
-   * Legacy generation (backward compatibility)
-   */
-  async generateLegacy(options) {
-    const results = {
-      apiClient: null,
-      envFile: null,
-      nextauth: null,
-      oauthGuide: null,
-      gitignore: null,
-    };
-
-    const frameworkType = options.frameworkType || 'unknown';
-    const isMobile = this.isMobileFramework(frameworkType);
-    const isNextJs = this.isNextJs(frameworkType);
-
-    // Generate API client (async - checks for file overwrites)
-    if (options.features && options.features.length > 0) {
-      results.apiClient = await apiClientGenerator.generate(options);
-    }
-
-    // Generate environment file
-    results.envFile = envGenerator.generate(options);
-
-    // Generate NextAuth.js config if OAuth is enabled (Next.js only)
-    if (options.features && options.features.includes('oauth') && options.oauthProviders) {
-      if (isNextJs) {
-        results.nextauth = await nextauthGenerator.generate(options);
-      }
-    }
-
-    // Generate OAuth guide if OAuth is enabled
-    if (options.features && options.features.includes('oauth') && options.oauthProviders) {
-      results.oauthGuide = oauthGuideGenerator.generate({
-        ...options,
-        isMobile,
-        isNextJs,
-      });
-    }
-
-    // Update .gitignore
-    results.gitignore = gitignoreGenerator.generate(options);
-
-    return results;
-  }
-}
-
-module.exports = new FileGenerator();

package/src/generators/manifest-generator.js

@@ -1,154 +0,0 @@
-/**
- * Manifest Generator
- * Generates and manages the .l4yercak3.json project manifest file
- *
- * The manifest captures the project's structure (framework, models, routes)
- * and is used by the platform to understand and integrate with the app.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const MANIFEST_FILENAME = '.l4yercak3.json';
-const MANIFEST_VERSION = '1.0.0';
-
-class ManifestGenerator {
-  /**
-   * Generate or update the .l4yercak3.json manifest
-   * @param {object} options
-   * @param {string} options.projectPath - Project root directory
-   * @param {object} options.detection - Detection results from ProjectDetector
-   * @param {Array} options.models - Detected models from model-detector
-   * @param {Array} options.routes - Detected routes from page-detector (with methods)
-   * @param {Array} options.mappings - Suggested mappings from mapping-suggestor
-   * @returns {string} Path to the generated manifest file
-   */
-  generate(options) {
-    const { projectPath, detection, models, routes, mappings } = options;
-    const manifestPath = path.join(projectPath, MANIFEST_FILENAME);
-
-    // Read existing manifest to preserve user overrides
-    const existing = this.loadManifest(projectPath);
-
-    const manifest = {
-      version: MANIFEST_VERSION,
-      framework: detection?.framework?.type || 'unknown',
-      routerType: detection?.framework?.metadata?.routerType || null,
-      typescript: detection?.framework?.metadata?.hasTypeScript || false,
-      database: detection?.database?.primary?.type || null,
-      detectedModels: (models || []).map(m => ({
-        name: m.name,
-        source: m.source,
-        fields: m.fields || [],
-      })),
-      detectedRoutes: (routes || [])
-        .filter(r => r.pageType === 'api_route')
-        .map(r => ({
-          path: r.path,
-          methods: r.methods || ['GET', 'POST'],
-        })),
-      suggestedMappings: (mappings || []).map(m => ({
-        localModel: m.localModel,
-        platformType: m.platformType,
-        confidence: m.confidence,
-      })),
-      lastSyncedAt: new Date().toISOString(),
-    };
-
-    // Preserve user overrides from existing manifest
-    if (existing && existing.userOverrides) {
-      manifest.userOverrides = existing.userOverrides;
-    }
-
-    // Preserve confirmed mappings from existing manifest
-    if (existing && existing.confirmedMappings) {
-      manifest.confirmedMappings = existing.confirmedMappings;
-    }
-
-    fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
-    return manifestPath;
-  }
-
-  /**
-   * Load an existing manifest from a project
-   * @param {string} projectPath - Project root directory
-   * @returns {object|null} Parsed manifest or null if not found
-   */
-  loadManifest(projectPath) {
-    const manifestPath = path.join(projectPath, MANIFEST_FILENAME);
-    try {
-      if (!fs.existsSync(manifestPath)) {
-        return null;
-      }
-      const content = fs.readFileSync(manifestPath, 'utf8');
-      return JSON.parse(content);
-    } catch {
-      return null;
-    }
-  }
-
-  /**
-   * Check if a manifest exists in the project
-   * @param {string} projectPath
-   * @returns {boolean}
-   */
-  hasManifest(projectPath) {
-    return fs.existsSync(path.join(projectPath, MANIFEST_FILENAME));
-  }
-
-  /**
-   * Compute a diff between old and new manifest data
-   * @param {object} oldManifest - Previous manifest
-   * @param {object} newManifest - New manifest data
-   * @returns {object} Diff summary
-   */
-  diff(oldManifest, newManifest) {
-    const result = {
-      modelsAdded: [],
-      modelsRemoved: [],
-      routesAdded: [],
-      routesRemoved: [],
-      mappingsChanged: [],
-      hasChanges: false,
-    };
-
-    if (!oldManifest) {
-      result.modelsAdded = newManifest.detectedModels || [];
-      result.routesAdded = newManifest.detectedRoutes || [];
-      result.hasChanges = result.modelsAdded.length > 0 || result.routesAdded.length > 0;
-      return result;
-    }
-
-    // Compare models
-    const oldModelNames = new Set((oldManifest.detectedModels || []).map(m => m.name));
-    const newModelNames = new Set((newManifest.detectedModels || []).map(m => m.name));
-
-    for (const m of (newManifest.detectedModels || [])) {
-      if (!oldModelNames.has(m.name)) result.modelsAdded.push(m);
-    }
-    for (const m of (oldManifest.detectedModels || [])) {
-      if (!newModelNames.has(m.name)) result.modelsRemoved.push(m);
-    }
-
-    // Compare routes
-    const oldRoutePaths = new Set((oldManifest.detectedRoutes || []).map(r => r.path));
-    const newRoutePaths = new Set((newManifest.detectedRoutes || []).map(r => r.path));
-
-    for (const r of (newManifest.detectedRoutes || [])) {
-      if (!oldRoutePaths.has(r.path)) result.routesAdded.push(r);
-    }
-    for (const r of (oldManifest.detectedRoutes || [])) {
-      if (!newRoutePaths.has(r.path)) result.routesRemoved.push(r);
-    }
-
-    result.hasChanges =
-      result.modelsAdded.length > 0 ||
-      result.modelsRemoved.length > 0 ||
-      result.routesAdded.length > 0 ||
-      result.routesRemoved.length > 0;
-
-    return result;
-  }
-}
-
-module.exports = new ManifestGenerator();

package/src/generators/mcp-guide-generator.js

@@ -1,256 +0,0 @@
-/**
- * MCP Guide Generator
- * Generates MCP configuration and guide for AI-powered development
- */
-
-const fs = require('fs');
-const path = require('path');
-const { ensureDir, writeFileWithBackup, checkFileOverwrite } = require('../utils/file-utils');
-
-class McpGuideGenerator {
-  /**
-   * Generate MCP configuration and guide files
-   * @param {Object} options - Generation options
-   * @returns {Promise<Object>} - Generated file paths
-   */
-  async generate(options) {
-    const results = {
-      config: null,
-      guide: null,
-    };
-
-    results.config = await this.generateConfig(options);
-    results.guide = await this.generateGuide(options);
-
-    return results;
-  }
-
-  /**
-   * Generate .claude/mcp.json configuration
-   */
-  async generateConfig(options) {
-    const { projectPath } = options;
-
-    const claudeDir = path.join(projectPath, '.claude');
-    ensureDir(claudeDir);
-
-    const outputPath = path.join(claudeDir, 'mcp.json');
-
-    // Check if file exists
-    let existingConfig = {};
-    if (fs.existsSync(outputPath)) {
-      try {
-        existingConfig = JSON.parse(fs.readFileSync(outputPath, 'utf8'));
-      } catch {
-        // Ignore parse errors
-      }
-    }
-
-    // Merge with existing config
-    const config = {
-      ...existingConfig,
-      mcpServers: {
-        ...existingConfig.mcpServers,
-        l4yercak3: {
-          command: 'npx',
-          args: ['@l4yercak3/cli', 'mcp', 'start'],
-          env: {
-            L4YERCAK3_CONFIG_PATH: '${workspaceFolder}/.l4yercak3',
-          },
-        },
-      },
-    };
-
-    const action = await checkFileOverwrite(outputPath);
-    if (action === 'skip') {
-      return null;
-    }
-
-    return writeFileWithBackup(outputPath, JSON.stringify(config, null, 2), action);
-  }
-
-  /**
-   * Generate MCP integration guide
-   */
-  async generateGuide(options) {
-    const {
-      projectPath,
-      organizationName,
-      features,
-    } = options;
-
-    const docsDir = path.join(projectPath, 'docs');
-    ensureDir(docsDir);
-
-    const outputPath = path.join(docsDir, 'L4YERCAK3_MCP_GUIDE.md');
-
-    const action = await checkFileOverwrite(outputPath);
-    if (action === 'skip') {
-      return null;
-    }
-
-    const content = this.generateGuideContent({
-      organizationName,
-      features,
-    });
-
-    return writeFileWithBackup(outputPath, content, action);
-  }
-
-  generateGuideContent({ organizationName, features }) {
-    const featureList = features || ['crm'];
-
-    return `# L4YERCAK3 MCP Integration Guide
-
-Your project is connected to L4YERCAK3! You can now use Claude Code to build
-custom integrations using natural language.
-
-## Getting Started
-
-The L4YERCAK3 MCP server has been configured in \`.claude/mcp.json\`. When you
-use Claude Code in this project, it will have access to L4YERCAK3 tools.
-
-## Available MCP Tools
-
-### CRM Tools (contacts:read, contacts:write)
-${featureList.includes('crm') ? `
-- \`l4yercak3_crm_list_contacts\` - List and search contacts
-- \`l4yercak3_crm_create_contact\` - Create new contacts
-- \`l4yercak3_crm_get_contact\` - Get contact details
-- \`l4yercak3_crm_update_contact\` - Update contacts
-- \`l4yercak3_crm_delete_contact\` - Delete contacts
-- \`l4yercak3_crm_add_tags\` - Add tags to contacts
-- \`l4yercak3_crm_list_organizations\` - List organizations
-- \`l4yercak3_crm_create_organization\` - Create organizations
-` : '*Not enabled*'}
-
-### Events Tools (events:read, events:write)
-${featureList.includes('events') ? `
-- \`l4yercak3_events_list\` - List events
-- \`l4yercak3_events_create\` - Create events
-- \`l4yercak3_events_get\` - Get event details with products/sponsors
-- \`l4yercak3_events_get_attendees\` - List attendees
-- \`l4yercak3_events_check_in\` - Check in attendees
-` : '*Not enabled*'}
-
-### Forms Tools (forms:read, forms:write)
-${featureList.includes('forms') ? `
-- \`l4yercak3_forms_list\` - List forms
-- \`l4yercak3_forms_get\` - Get form with fields
-- \`l4yercak3_forms_submit\` - Submit form responses
-- \`l4yercak3_forms_get_responses\` - Get form submissions
-` : '*Not enabled*'}
-
-### Products Tools (products:read)
-${featureList.includes('products') ? `
-- \`l4yercak3_products_list\` - List products
-- \`l4yercak3_products_get\` - Get product details
-` : '*Not enabled*'}
-
-### Checkout Tools (checkout:write)
-${featureList.includes('checkout') ? `
-- \`l4yercak3_checkout_create_session\` - Create checkout session
-- \`l4yercak3_checkout_get_session\` - Get checkout status
-- \`l4yercak3_orders_list\` - List orders
-- \`l4yercak3_orders_get\` - Get order details
-` : '*Not enabled*'}
-
-### Invoicing Tools (invoices:read, invoices:write)
-${featureList.includes('invoicing') ? `
-- \`l4yercak3_invoices_list\` - List invoices
-- \`l4yercak3_invoices_create\` - Create invoices
-- \`l4yercak3_invoices_get\` - Get invoice details
-- \`l4yercak3_invoices_send\` - Send invoice to customer
-- \`l4yercak3_invoices_mark_paid\` - Mark invoice as paid
-- \`l4yercak3_invoices_get_pdf\` - Get invoice PDF URL
-` : '*Not enabled*'}
-
-### Benefits Tools (benefits:read, benefits:write)
-${featureList.includes('benefits') ? `
-- \`l4yercak3_benefits_list_claims\` - List benefit claims
-- \`l4yercak3_benefits_create_claim\` - Submit a benefit claim
-- \`l4yercak3_benefits_approve_claim\` - Approve a claim
-- \`l4yercak3_benefits_reject_claim\` - Reject a claim
-- \`l4yercak3_benefits_list_commissions\` - List commission payouts
-` : '*Not enabled*'}
-
-### Code Generation Tools
-- \`l4yercak3_generate_api_client\` - Generate typed API client
-- \`l4yercak3_generate_component\` - Generate React components
-- \`l4yercak3_generate_hook\` - Generate React hooks
-- \`l4yercak3_generate_page\` - Generate Next.js pages
-
-## Example Prompts
-
-Here are some things you can ask Claude Code to do:
-
-### CRM & Contacts
-1. "Create a contact management page with search, filtering by tags, and the ability to add notes"
-2. "Build a contact detail view that shows all activities and related organizations"
-3. "Generate a contact import feature that reads from CSV"
-
-### Events & Registrations
-4. "Build an event registration flow with ticket selection and Stripe checkout"
-5. "Create an event listing page with filters for date, location, and category"
-6. "Build a mobile-friendly check-in scanner for event attendees"
-
-### Forms
-7. "Generate a form builder that lets admins create custom forms and view submissions"
-8. "Create a contact form that saves to L4YERCAK3 CRM"
-9. "Build a survey results dashboard with charts"
-
-### E-commerce
-10. "Create a product catalog with categories and search"
-11. "Build a shopping cart with quantity controls"
-12. "Generate an order history page for customers"
-
-### Invoicing
-13. "Create an invoice dashboard showing pending, paid, and overdue invoices"
-14. "Build a send invoice flow with email preview"
-15. "Generate an invoice PDF viewer component"
-
-### Dashboard & Analytics
-16. "Create a dashboard showing CRM contacts, recent events, and pending invoices"
-17. "Build a revenue analytics chart from order data"
-18. "Generate a customer lifetime value report"
-
-## Your Configuration
-
-- **Organization:** ${organizationName || 'Your Organization'}
-- **Features Enabled:** ${featureList.join(', ')}
-- **API Key:** Stored in .env.local
-
-## Tips for Best Results
-
-1. **Be specific about your UI framework** - Tell Claude if you're using Tailwind, shadcn/ui, Material UI, etc.
-
-2. **Reference existing patterns** - Say "match the style of my existing components" so Claude reads your code first.
-
-3. **Start with data** - Ask Claude to show what data is available from the API before designing UI.
-
-4. **Iterate incrementally** - Start simple and add features one at a time.
-
-5. **Ask for explanations** - Claude can explain what MCP tools are available and how they work.
-
-## Webhook Integration
-
-You can also ask Claude to set up webhooks for real-time updates:
-
-- "Set up a webhook handler for new contact creation"
-- "Create a webhook endpoint that syncs orders to our local database"
-- "Build a notification system triggered by invoice.paid webhooks"
-
-## Need Help?
-
-- Ask Claude: "What L4YERCAK3 MCP tools are available?"
-- Ask Claude: "Show me an example of using the contacts API"
-- Ask Claude: "Help me debug this L4YERCAK3 integration"
-
----
-
-Generated by @l4yercak3/cli
-`;
-  }
-}
-
-module.exports = new McpGuideGenerator();