@l4yercak3/cli 1.0.0

package/src/generators/index.js

@@ -0,0 +1,50 @@
+/**
+ * File Generators
+ * Main entry point for all file 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');
+
+class FileGenerator {
+  /**
+   * Generate all files based on configuration
+   */
+  async generate(options) {
+    const results = {
+      apiClient: null,
+      envFile: null,
+      nextauth: null,
+      oauthGuide: null,
+      gitignore: null,
+    };
+
+    // Generate API client
+    if (options.features && options.features.length > 0) {
+      results.apiClient = apiClientGenerator.generate(options);
+    }
+
+    // Generate environment file
+    results.envFile = envGenerator.generate(options);
+
+    // Generate NextAuth.js config if OAuth is enabled
+    if (options.features && options.features.includes('oauth') && options.oauthProviders) {
+      results.nextauth = nextauthGenerator.generate(options);
+    }
+
+    // Generate OAuth guide if OAuth is enabled
+    if (options.features && options.features.includes('oauth') && options.oauthProviders) {
+      results.oauthGuide = oauthGuideGenerator.generate(options);
+    }
+
+    // Update .gitignore
+    results.gitignore = gitignoreGenerator.generate(options);
+
+    return results;
+  }
+}
+
+module.exports = new FileGenerator();

package/src/generators/nextauth-generator.js

@@ -0,0 +1,242 @@
+/**
+ * NextAuth.js Configuration Generator
+ * Generates NextAuth.js configuration for OAuth providers
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class NextAuthGenerator {
+  /**
+   * Generate NextAuth.js configuration
+   */
+  generate(options) {
+    const {
+      projectPath,
+      backendUrl,
+      oauthProviders,
+      routerType,
+      isTypeScript,
+    } = options;
+
+    // Determine API route path based on router type
+    const apiDir = routerType === 'app'
+      ? path.join(projectPath, 'app', 'api', 'auth')
+      : path.join(projectPath, 'pages', 'api', 'auth');
+
+    // Ensure directory exists
+    if (!fs.existsSync(apiDir)) {
+      fs.mkdirSync(apiDir, { recursive: true });
+    }
+
+    const extension = isTypeScript ? 'ts' : 'js';
+    const routePath = routerType === 'app'
+      ? path.join(apiDir, `[...nextauth]`, `route.${extension}`)
+      : path.join(apiDir, `[...nextauth].${extension}`);
+
+    // Ensure [...nextauth] directory exists for App Router
+    if (routerType === 'app') {
+      const nextauthDir = path.join(apiDir, '[...nextauth]');
+      if (!fs.existsSync(nextauthDir)) {
+        fs.mkdirSync(nextauthDir, { recursive: true });
+      }
+    }
+
+    // Generate NextAuth configuration
+    const code = this.generateCode({
+      backendUrl,
+      oauthProviders,
+      routerType,
+      isTypeScript,
+    });
+
+    fs.writeFileSync(routePath, code, 'utf8');
+    return routePath;
+  }
+
+  /**
+   * Generate NextAuth.js code
+   */
+  generateCode({ oauthProviders, routerType, isTypeScript }) {
+    const providers = [];
+    const providerImports = [];
+
+    if (oauthProviders.includes('google')) {
+      providerImports.push("import GoogleProvider from 'next-auth/providers/google';");
+      providers.push(`      GoogleProvider({
+        clientId: process.env.GOOGLE_CLIENT_ID${isTypeScript ? '!' : ''},
+        clientSecret: process.env.GOOGLE_CLIENT_SECRET${isTypeScript ? '!' : ''},
+      }),`);
+    }
+
+    if (oauthProviders.includes('microsoft')) {
+      providerImports.push("import AzureADProvider from 'next-auth/providers/azure-ad';");
+      providers.push(`      AzureADProvider({
+        clientId: process.env.AZURE_CLIENT_ID${isTypeScript ? '!' : ''},
+        clientSecret: process.env.AZURE_CLIENT_SECRET${isTypeScript ? '!' : ''},
+        tenantId: process.env.AZURE_TENANT_ID${isTypeScript ? '!' : ''},
+      }),`);
+    }
+
+    if (oauthProviders.includes('github')) {
+      providerImports.push("import GitHubProvider from 'next-auth/providers/github';");
+      providers.push(`      GitHubProvider({
+        clientId: process.env.GITHUB_CLIENT_ID${isTypeScript ? '!' : ''},
+        clientSecret: process.env.GITHUB_CLIENT_SECRET${isTypeScript ? '!' : ''},
+      }),`);
+    }
+
+    const providersCode = providers.join('\n');
+
+    // App Router vs Pages Router
+    if (routerType === 'app') {
+      return `/**
+ * NextAuth.js Configuration
+ * Auto-generated by @l4yercak3/cli
+ * 
+ * This file configures OAuth authentication for your frontend application.
+ * Users authenticated here are automatically synced to your L4YERCAK3 backend.
+ */
+
+${providerImports.join('\n')}
+import NextAuth from 'next-auth';
+import type { NextAuthOptions } from 'next-auth';
+
+const authOptions${isTypeScript ? ': NextAuthOptions' : ''} = {
+  providers: [
+${providersCode}
+  ],
+  callbacks: {
+    async signIn({ user, account, profile }) {
+      if (!account) return false;
+
+      try {
+        // Sync user to L4YERCAK3 backend
+        const response = await fetch(\`\${process.env.NEXT_PUBLIC_L4YERCAK3_BACKEND_URL}/api/v1/auth/sync-user\`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': \`Bearer \${process.env.L4YERCAK3_API_KEY}\`,
+          },
+          body: JSON.stringify({
+            email: user.email,
+            name: user.name,
+            image: user.image,
+            provider: account.provider,
+            providerAccountId: account.providerAccountId,
+            accessToken: account.access_token,
+            refreshToken: account.refresh_token,
+            expiresAt: account.expires_at,
+          }),
+        });
+
+        if (!response.ok) {
+          console.error('Failed to sync user to backend:', await response.text());
+          return false;
+        }
+
+        const backendUser = await response.json();
+        
+        // Add backend user ID to session
+        user.id = backendUser.userId;
+        user.organizationId = backendUser.organizationId;
+        
+        return true;
+      } catch (error) {
+        console.error('Error syncing user to backend:', error);
+        return false;
+      }
+    },
+    async session({ session, user${isTypeScript ? ': any' : ''} }) {
+      if (session.user) {
+        session.user.id = user.id;
+        session.user.organizationId = user.organizationId;
+      }
+      return session;
+    },
+  },
+  pages: {
+    signIn: '/auth/signin',
+  },
+};
+
+const handler = NextAuth(authOptions);
+
+export { handler as GET, handler as POST };
+`;
+    } else {
+      // Pages Router
+      return `/**
+ * NextAuth.js Configuration
+ * Auto-generated by @l4yercak3/cli
+ * 
+ * This file configures OAuth authentication for your frontend application.
+ * Users authenticated here are automatically synced to your L4YERCAK3 backend.
+ */
+
+${providerImports.join('\n')}
+import NextAuth from 'next-auth';
+
+export default NextAuth({
+  providers: [
+${providersCode}
+  ],
+  callbacks: {
+    async signIn({ user, account, profile }) {
+      if (!account) return false;
+
+      try {
+        // Sync user to L4YERCAK3 backend
+        const response = await fetch(\`\${process.env.NEXT_PUBLIC_L4YERCAK3_BACKEND_URL}/api/v1/auth/sync-user\`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': \`Bearer \${process.env.L4YERCAK3_API_KEY}\`,
+          },
+          body: JSON.stringify({
+            email: user.email,
+            name: user.name,
+            image: user.image,
+            provider: account.provider,
+            providerAccountId: account.providerAccountId,
+            accessToken: account.access_token,
+            refreshToken: account.refresh_token,
+            expiresAt: account.expires_at,
+          }),
+        });
+
+        if (!response.ok) {
+          console.error('Failed to sync user to backend:', await response.text());
+          return false;
+        }
+
+        const backendUser = await response.json();
+        
+        // Add backend user ID to session
+        user.id = backendUser.userId;
+        user.organizationId = backendUser.organizationId;
+        
+        return true;
+      } catch (error) {
+        console.error('Error syncing user to backend:', error);
+        return false;
+      }
+    },
+    async session({ session, user }) {
+      if (session.user) {
+        session.user.id = user.id;
+        session.user.organizationId = user.organizationId;
+      }
+      return session;
+    },
+  },
+  pages: {
+    signIn: '/auth/signin',
+  },
+});
+`;
+    }
+  }
+}
+
+module.exports = new NextAuthGenerator();

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

@@ -0,0 +1,277 @@
+/**
+ * OAuth Setup Guide Generator
+ * Generates OAuth setup guide markdown file
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class OAuthGuideGenerator {
+  /**
+   * Generate OAuth setup guide
+   */
+  generate(options) {
+    const {
+      projectPath,
+      oauthProviders,
+      productionDomain,
+      appName,
+    } = options;
+
+    const guidePath = path.join(projectPath, 'OAUTH_SETUP_GUIDE.md');
+    const content = this.generateGuide({
+      oauthProviders,
+      productionDomain,
+      appName,
+    });
+
+    fs.writeFileSync(guidePath, content, 'utf8');
+    return guidePath;
+  }
+
+  /**
+   * Generate guide content
+   */
+  generateGuide({ oauthProviders, productionDomain, appName }) {
+    const hasGoogle = oauthProviders.includes('google');
+    const hasMicrosoft = oauthProviders.includes('microsoft');
+    const hasGitHub = oauthProviders.includes('github');
+
+    let content = `# 🔐 OAuth Authentication Setup Guide
+
+## Overview
+
+This guide will walk you through setting up OAuth authentication for your frontend application. You'll need to create OAuth apps with each provider and add the credentials to your \`.env.local\` file.
+
+**Estimated Time:** 15-20 minutes per provider
+
+---
+
+## ✅ Setup Checklist
+
+`;
+
+    if (hasGoogle) content += `- [ ] Google OAuth setup\n`;
+    if (hasMicrosoft) content += `- [ ] Microsoft OAuth setup\n`;
+    if (hasGitHub) content += `- [ ] GitHub OAuth setup\n`;
+
+    content += `\n---\n\n`;
+
+    // Google OAuth section
+    if (hasGoogle) {
+      content += `## 1. Google OAuth Setup
+
+### Step 1: Go to Google Cloud Console
+
+1. Navigate to: https://console.cloud.google.com/
+2. Select your project or create a new one
+
+### Step 2: Enable Google+ API
+
+1. Go to "APIs & Services" → "Enable APIs and Services"
+2. Search for "Google+ API" and enable it
+
+### Step 3: Create OAuth Client ID
+
+1. Go to "APIs & Services" → "Credentials"
+2. Click "Create Credentials" → "OAuth client ID"
+3. Application type: **Web application**
+4. Name: \`${appName || 'Your App'} - Frontend\`
+
+### Step 4: Configure Redirect URIs
+
+Add these redirect URIs:
+
+**Production:**
+\`\`\`
+https://${productionDomain || 'your-domain.com'}/api/auth/callback/google
+\`\`\`
+
+**Development:**
+\`\`\`
+http://localhost:3000/api/auth/callback/google
+\`\`\`
+
+### Step 5: Save Credentials
+
+1. Copy the **Client ID** and **Client Secret**
+2. Add them to your \`.env.local\` file (see below)
+
+---
+
+`;
+    }
+
+    // Microsoft OAuth section
+    if (hasMicrosoft) {
+      content += `## ${hasGoogle ? '2' : '1'}. Microsoft Entra ID (Azure AD) Setup
+
+### Step 1: Go to Azure Portal
+
+1. Navigate to: https://portal.azure.com/
+2. Go to "Microsoft Entra ID" (formerly Azure AD)
+
+### Step 2: Register Application
+
+1. Go to "App registrations" → "New registration"
+2. Name: \`${appName || 'Your App'} - Frontend\`
+3. Supported account types: Choose based on your needs
+4. Redirect URI: **Web**
+
+### Step 3: Configure Redirect URIs
+
+Add these redirect URIs:
+
+**Production:**
+\`\`\`
+https://${productionDomain || 'your-domain.com'}/api/auth/callback/azure-ad
+\`\`\`
+
+**Development:**
+\`\`\`
+http://localhost:3000/api/auth/callback/azure-ad
+\`\`\`
+
+### Step 4: Create Client Secret
+
+1. Go to "Certificates & secrets" → "New client secret"
+2. Description: \`Frontend OAuth Secret\`
+3. Expires: Choose expiration (recommend 24 months)
+4. Copy the **Value** (not the Secret ID) - you won't see it again!
+
+### Step 5: Save Credentials
+
+1. Copy the **Application (client) ID**, **Directory (tenant) ID**, and **Client Secret Value**
+2. Add them to your \`.env.local\` file (see below)
+
+---
+
+`;
+    }
+
+    // GitHub OAuth section
+    if (hasGitHub) {
+      const sectionNum = (hasGoogle ? 1 : 0) + (hasMicrosoft ? 1 : 0) + 1;
+      content += `## ${sectionNum}. GitHub OAuth Setup
+
+### Step 1: Go to GitHub Developer Settings
+
+1. Navigate to: https://github.com/settings/developers
+2. Click "New OAuth App"
+
+### Step 2: Create OAuth App
+
+1. **Application name:** \`${appName || 'Your App'} - Frontend\`
+2. **Homepage URL:** \`https://${productionDomain || 'your-domain.com'}\`
+3. **Authorization callback URL:**
+   \`\`\`
+   https://${productionDomain || 'your-domain.com'}/api/auth/callback/github
+   \`\`\`
+
+### Step 3: Save Credentials
+
+1. Copy the **Client ID**
+2. Click "Generate a new client secret"
+3. Copy the **Client Secret** (you won't see it again!)
+4. Add them to your \`.env.local\` file (see below)
+
+---
+
+`;
+    }
+
+    content += `## ${(hasGoogle ? 1 : 0) + (hasMicrosoft ? 1 : 0) + (hasGitHub ? 1 : 0) + 1}. Update Environment Variables
+
+Add these to your \`.env.local\` file:
+
+\`\`\`bash
+`;
+
+    if (hasGoogle) {
+      content += `# Google OAuth
+GOOGLE_CLIENT_ID=your_google_client_id_here
+GOOGLE_CLIENT_SECRET=your_google_client_secret_here
+
+`;
+    }
+
+    if (hasMicrosoft) {
+      content += `# Microsoft OAuth
+AZURE_CLIENT_ID=your_azure_client_id_here
+AZURE_CLIENT_SECRET=your_azure_client_secret_value_here
+AZURE_TENANT_ID=your_azure_tenant_id_here
+
+`;
+    }
+
+    if (hasGitHub) {
+      content += `# GitHub OAuth
+GITHUB_CLIENT_ID=your_github_client_id_here
+GITHUB_CLIENT_SECRET=your_github_client_secret_here
+
+`;
+    }
+
+    content += `\`\`\`
+
+**⚠️ Important:** Never commit \`.env.local\` to git! It's already in \`.gitignore\`.
+
+---
+
+## ${(hasGoogle ? 1 : 0) + (hasMicrosoft ? 1 : 0) + (hasGitHub ? 1 : 0) + 2}. Test Your Setup
+
+1. Start your development server: \`npm run dev\`
+2. Navigate to: \`http://localhost:3000/auth/signin\`
+3. Try signing in with each provider
+4. Verify that users are created in your backend
+
+---
+
+## Troubleshooting
+
+### Redirect URI Mismatch
+
+**Error:** "Redirect URI mismatch"
+
+**Solution:** Make sure the redirect URI in your OAuth app matches exactly:
+- Check for trailing slashes
+- Check http vs https
+- Check localhost vs 127.0.0.1
+
+### Invalid Client Secret
+
+**Error:** "Invalid client secret"
+
+**Solution:** 
+- Make sure you copied the **Value** (not Secret ID) for Azure
+- Regenerate the secret if needed
+- Restart your dev server after updating \`.env.local\`
+
+### Provider Not Found
+
+**Error:** "Provider not found"
+
+**Solution:**
+- Check that the provider is configured in \`app/api/auth/[...nextauth]/route.ts\` (or \`pages/api/auth/[...nextauth].ts\`)
+- Verify environment variables are set correctly
+
+---
+
+## Next Steps
+
+Once OAuth is set up:
+1. ✅ Users can sign in with their Google/Microsoft/GitHub accounts
+2. ✅ User accounts are automatically created in your backend
+3. ✅ Users are linked to CRM contacts
+4. ✅ You can use protected routes and API calls
+
+---
+
+**Need Help?** Check the [L4YERCAK3 Documentation](https://docs.l4yercak3.com) or contact support.
+`;
+
+    return content;
+  }
+}
+
+module.exports = new OAuthGuideGenerator();

package/src/logo.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+/**
+ * Logo display module
+ * Shows the L4YERCAK3 logo with 3D font and rainbow gradient
+ * Combined with building/plumbing metaphor
+ */
+
+const chalk = require('chalk');
+const figlet = require('figlet');
+
+// Rainbow gradient colors
+const rainbow = [
+  '#FF1493', '#FF69B4', '#FF00FF', '#9F7AEA',
+  '#8B5CF6', '#3B82F6', '#00BFFF', '#10B981',
+  '#F59E0B', '#EF4444', '#FF6B6B'
+];
+
+// Helper function for character-by-character gradient
+function applyCharGradient(line, colors) {
+  let result = '';
+  for (let i = 0; i < line.length; i++) {
+    const colorIndex = Math.min(
+      Math.floor((i / line.length) * colors.length),
+      colors.length - 1
+    );
+    result += chalk.hex(colors[colorIndex])(line[i]);
+  }
+  return result;
+}
+
+// Building/plumbing metaphor
+const buildingMetaphor = [
+  "                                                                                                    ",
+  "                                    ╔═══════════════════════════╗                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Floor 5: Landing Page        ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     mywebsite.com                ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║                                  ",
+  "                                    ╠═══════════════════════════╣                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Floor 4: Client Portal        ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     clients.mysite.com            ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║                                  ",
+  "                                    ╠═══════════════════════════╣                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Floor 3: Mobile App           ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     iOS + Android                ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║                                  ",
+  "                                    ╠═══════════════════════════╣                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Floor 2: E-Commerce            ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     shop.mysite.com              ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║                                  ",
+  "                                    ╠═══════════════════════════╣                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Floor 1: Analytics            ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     admin.mysite.com              ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║                                  ",
+  "                                    ╠═══════════════════════════╣                                  ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║  ← Ground: API Layer             ",
+  "                                    ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓║     REST • GraphQL • gRPC        ",
+  "                                    ╚═══════════════════════════╝                                  ",
+  "                                          │ │ │ │ │ │ │ │ │ │ │                                    ",
+  "                                          │ │ │ │ │ │ │ │ │ │ │                                    ",
+  "                                          │ │ │ │ │ │ │ │ │ │ │                                    ",
+  "  ╔═══════════════════════════════════════════════════════════════════════════════════════╗      ",
+  "  ║                                                                                           ║      ",
+  "  ║  💾 Database  🔐 Auth  💳 Stripe  📧 Email  🔄 Workflows  📇 CRM  📊 Analytics  🔔      ║      ",
+  "  ║                                                                                           ║      ",
+  "  ║                    🏗️  THE PLUMBING - l4yercak3 PLATFORM  🏗️                            ║      ",
+  "  ║                                                                                           ║      ",
+  "  ╚═══════════════════════════════════════════════════════════════════════════════════════╝      ",
+  "                                                                                                    ",
+  "     🍰 icing on the l4yercak3 - connect your floors to the plumbing 🍰                          ",
+  "                                                                                                    "
+];
+
+/**
+ * Display the L4YERCAK3 logo with 3D font and rainbow gradient
+ * @param {boolean} showBuilding - Whether to show the building metaphor below
+ */
+function showLogo(showBuilding = true) {
+  // Generate ASCII art with figlet using 3D-ASCII font
+  const logoText = figlet.textSync('L4YERCAK3', { 
+    font: '3D-ASCII',
+    horizontalLayout: 'default',
+    verticalLayout: 'default'
+  });
+  
+  const logoLines = logoText.split('\n');
+  
+  // Print logo with rainbow gradient
+  logoLines.forEach((line) => {
+    console.log(applyCharGradient(line, rainbow));
+  });
+  
+  console.log(''); // spacing
+  
+  // Print building metaphor if requested
+  if (showBuilding) {
+    buildingMetaphor.forEach((line, i) => {
+      if (i >= 1 && i < 23) {
+        // Floors - blue gradient
+        console.log(applyCharGradient(line, ['#3B82F6', '#60A5FA', '#93C5FD', '#DBEAFE']));
+      } else if (i >= 25 && i < 31) {
+        // Foundation box - rainbow gradient
+        console.log(applyCharGradient(line, rainbow));
+      } else {
+        console.log(applyCharGradient(line, rainbow));
+      }
+    });
+  }
+  
+  console.log(''); // final spacing
+}
+
+module.exports = {
+  showLogo,
+  rainbow
+};