@l4yercak3/cli 1.0.6 → 1.1.1

package/src/commands/spread.js

@@ -7,9 +7,11 @@ const configManager = require('../config/config-manager');
 const backendClient = require('../api/backend-client');
 const projectDetector = require('../detectors');
 const fileGenerator = require('../generators');
+const { generateProjectPathHash } = require('../utils/file-utils');
 const inquirer = require('inquirer');
 const chalk = require('chalk');
 const path = require('path');
+const pkg = require('../../package.json');
 
 /**
  * Helper function to create an organization
@@ -378,11 +380,15 @@ async function handleSpread() {
         name: 'features',
         message: 'Select features to enable:',
         choices: [
-          { name: 'CRM (Contacts)', value: 'crm', checked: true },
-          { name: 'Projects', value: 'projects', checked: true },
-          { name: 'Invoices', value: 'invoices', checked: true },
+          { name: 'CRM (contacts, organizations)', value: 'crm', checked: true },
+          { name: 'Events (event management, registrations)', value: 'events', checked: false },
+          { name: 'Products (product catalog)', value: 'products', checked: false },
+          { name: 'Checkout (payment processing)', value: 'checkout', checked: false },
+          { name: 'Tickets (ticket generation)', value: 'tickets', checked: false },
+          { name: 'Invoicing (invoice creation)', value: 'invoicing', checked: false },
+          { name: 'Forms (dynamic forms)', value: 'forms', checked: false },
+          { name: 'Projects (project management)', value: 'projects', checked: false },
           { name: 'OAuth Authentication', value: 'oauth', checked: false },
-          { name: 'Stripe Integration', value: 'stripe', checked: false },
         ],
       },
     ]);
@@ -425,17 +431,34 @@ async function handleSpread() {
     ]);
 
     // Step 7: Production domain (for OAuth redirect URIs)
-    let productionDomain = 'your-domain.com';
+    let productionDomain = null;
     if (features.includes('oauth')) {
-      const { domain } = await inquirer.prompt([
+      console.log(chalk.gray('\n  ℹ️  The following settings are written to .env.local for local development.'));
+      console.log(chalk.gray('     For production, set NEXTAUTH_URL in your hosting platform (e.g., Vercel).\n'));
+
+      const { configureNow } = await inquirer.prompt([
         {
-          type: 'input',
-          name: 'domain',
-          message: 'Production domain (for OAuth redirect URIs):',
-          default: detection.github.repo ? `${detection.github.repo}.vercel.app` : 'your-domain.com',
+          type: 'confirm',
+          name: 'configureNow',
+          message: 'Configure production domain now? (You can skip and do this later)',
+          default: true,
         },
       ]);
-      productionDomain = domain;
+
+      if (configureNow) {
+        const { domain } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'domain',
+            message: 'Production domain (for OAuth redirect URIs):',
+            default: detection.github.repo ? `${detection.github.repo}.vercel.app` : 'your-domain.com',
+          },
+        ]);
+        productionDomain = domain;
+      } else {
+        console.log(chalk.gray('  Skipping production domain configuration.'));
+        console.log(chalk.gray('  Set NEXTAUTH_URL in your hosting platform when deploying.\n'));
+      }
     }
 
     // Step 8: Generate files
@@ -481,10 +504,104 @@ async function handleSpread() {
       console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.gitignore)} (updated)`));
     }
 
+    // Step 9: Register application with backend
+    console.log(chalk.cyan('\n  🔗 Registering with L4YERCAK3...\n'));
+
+    const projectPathHash = generateProjectPathHash(detection.projectPath);
+    let applicationId = null;
+    let isUpdate = false;
+
+    try {
+      // Check if application already exists for this project
+      const existingApp = await backendClient.checkExistingApplication(organizationId, projectPathHash);
+
+      if (existingApp.found && existingApp.application) {
+        // Application already registered
+        console.log(chalk.yellow(`  ⚠️  This project is already registered as "${existingApp.application.name}"`));
+
+        const { updateAction } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'updateAction',
+            message: 'What would you like to do?',
+            choices: [
+              { name: 'Update existing registration', value: 'update' },
+              { name: 'Skip registration (keep existing)', value: 'skip' },
+            ],
+          },
+        ]);
+
+        if (updateAction === 'update') {
+          // Update existing application
+          const updateData = {
+            connection: {
+              features,
+              hasFrontendDatabase: !!detection.framework.metadata?.hasPrisma,
+              frontendDatabaseType: detection.framework.metadata?.hasPrisma ? 'prisma' : undefined,
+            },
+            deployment: {
+              productionUrl: productionDomain ? `https://${productionDomain}` : undefined,
+              githubRepo: detection.github.isGitHub ? `${detection.github.owner}/${detection.github.repo}` : undefined,
+            },
+          };
+
+          await backendClient.updateApplication(existingApp.application.id, updateData);
+          applicationId = existingApp.application.id;
+          isUpdate = true;
+          console.log(chalk.green(`  ✅ Application registration updated\n`));
+        } else {
+          applicationId = existingApp.application.id;
+          console.log(chalk.gray(`  Skipped registration update\n`));
+        }
+      } else {
+        // Register new application
+        const registrationData = {
+          organizationId,
+          name: detection.github.repo || organizationName || 'My Application',
+          description: `Connected via CLI from ${detection.framework.type || 'unknown'} project`,
+          source: {
+            type: 'cli',
+            projectPathHash,
+            cliVersion: pkg.version,
+            framework: detection.framework.type || 'unknown',
+            frameworkVersion: detection.framework.metadata?.version,
+            hasTypeScript: detection.framework.metadata?.hasTypeScript || false,
+            routerType: detection.framework.metadata?.routerType,
+          },
+          connection: {
+            features,
+            hasFrontendDatabase: !!detection.framework.metadata?.hasPrisma,
+            frontendDatabaseType: detection.framework.metadata?.hasPrisma ? 'prisma' : undefined,
+          },
+          deployment: {
+            productionUrl: productionDomain ? `https://${productionDomain}` : undefined,
+            githubRepo: detection.github.isGitHub ? `${detection.github.owner}/${detection.github.repo}` : undefined,
+            githubBranch: detection.github.branch || 'main',
+          },
+        };
+
+        const registrationResult = await backendClient.registerApplication(registrationData);
+        applicationId = registrationResult.applicationId;
+        console.log(chalk.green(`  ✅ Application registered with L4YERCAK3\n`));
+
+        // If backend returned a new API key, use it
+        if (registrationResult.apiKey && registrationResult.apiKey.key) {
+          console.log(chalk.gray(`     API key generated: ${registrationResult.apiKey.prefix}`));
+        }
+      }
+    } catch (regError) {
+      // Registration failed but files were generated - warn but don't fail
+      console.log(chalk.yellow(`  ⚠️  Could not register with backend: ${regError.message}`));
+      console.log(chalk.gray('     Your files were generated successfully.'));
+      console.log(chalk.gray('     Backend registration will be available in a future update.\n'));
+    }
+
     // Save project configuration
     const projectConfig = {
       organizationId,
       organizationName,
+      applicationId,
+      projectPathHash,
       apiKey: `${apiKey.substring(0, 10)}...`, // Store partial key for reference only
       backendUrl,
       features,
@@ -492,12 +609,20 @@ async function handleSpread() {
       productionDomain,
       frameworkType: detection.framework.type,
       createdAt: Date.now(),
+      updatedAt: isUpdate ? Date.now() : undefined,
     };
 
     configManager.saveProjectConfig(detection.projectPath, projectConfig);
     console.log(chalk.gray(`  📝 Configuration saved to ~/.l4yercak3/config.json\n`));
 
-    console.log(chalk.cyan('\n  🎉 Setup complete!\n'));
+    // Show appropriate completion message based on registration status
+    if (applicationId) {
+      console.log(chalk.cyan('\n  🎉 Setup complete!\n'));
+    } else {
+      console.log(chalk.cyan('\n  🎉 Local setup complete!\n'));
+      console.log(chalk.yellow('  ⚠️  Note: Backend registration pending - your app works locally but'));
+      console.log(chalk.yellow('     won\'t appear in the L4YERCAK3 dashboard until endpoints are available.\n'));
+    }
 
     if (features.includes('oauth')) {
       console.log(chalk.yellow('  📋 Next steps:\n'));

package/src/generators/api-client-generator.js

@@ -5,12 +5,15 @@
 
 const fs = require('fs');
 const path = require('path');
+const { checkFileOverwrite, writeFileWithBackup, ensureDir } = require('../utils/file-utils');
 
 class ApiClientGenerator {
   /**
    * Generate API client file
+   * @param {Object} options - Generation options
+   * @returns {Promise<string|null>} - Path to generated file or null if skipped
    */
-  generate(options) {
+  async generate(options) {
     const {
       projectPath,
       apiKey,
@@ -25,13 +28,18 @@ class ApiClientGenerator {
       : path.join(projectPath, 'lib');
 
     // Ensure lib directory exists
-    if (!fs.existsSync(libDir)) {
-      fs.mkdirSync(libDir, { recursive: true });
-    }
+    ensureDir(libDir);
 
     const extension = isTypeScript ? 'ts' : 'js';
     const outputPath = path.join(libDir, `api-client.${extension}`);
 
+    // Check if file exists and get action
+    const action = await checkFileOverwrite(outputPath);
+
+    if (action === 'skip') {
+      return null;
+    }
+
     // Generate API client code
     const code = this.generateCode({
       apiKey,
@@ -40,8 +48,7 @@ class ApiClientGenerator {
       isTypeScript,
     });
 
-    fs.writeFileSync(outputPath, code, 'utf8');
-    return outputPath;
+    return writeFileWithBackup(outputPath, code, action);
   }
 
   /**

package/src/generators/env-generator.js

@@ -105,6 +105,10 @@ class EnvGenerator {
     let content = `# L4YERCAK3 Configuration
 # Auto-generated by @l4yercak3/cli
 # DO NOT commit this file to git - it contains sensitive credentials
+#
+# This file is for LOCAL DEVELOPMENT. For production:
+# - Set these variables in your hosting platform (Vercel, Netlify, etc.)
+# - NEXTAUTH_URL should be your production domain
 
 # Core API Configuration
 L4YERCAK3_API_KEY=${envVars.L4YERCAK3_API_KEY}
@@ -117,6 +121,11 @@ NEXT_PUBLIC_L4YERCAK3_BACKEND_URL=${envVars.NEXT_PUBLIC_L4YERCAK3_BACKEND_URL}
     // Add OAuth section if present
     if (envVars.GOOGLE_CLIENT_ID || envVars.AZURE_CLIENT_ID || envVars.GITHUB_CLIENT_ID) {
       content += `# OAuth Configuration
+# Get your OAuth credentials from:
+# - Google: https://console.cloud.google.com/apis/credentials
+# - Microsoft: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps
+# - GitHub: https://github.com/settings/developers
+
 `;
       if (envVars.GOOGLE_CLIENT_ID) {
         content += `GOOGLE_CLIENT_ID=${envVars.GOOGLE_CLIENT_ID}
@@ -138,7 +147,11 @@ GITHUB_CLIENT_SECRET=${envVars.GITHUB_CLIENT_SECRET}
 `;
       }
       if (envVars.NEXTAUTH_URL) {
-        content += `NEXTAUTH_URL=${envVars.NEXTAUTH_URL}
+        content += `# NextAuth.js Configuration
+# NEXTAUTH_URL: Set to http://localhost:3000 for development
+# For production, set this in your hosting platform (Vercel auto-sets this)
+NEXTAUTH_URL=${envVars.NEXTAUTH_URL}
+# Generate with: openssl rand -base64 32
 NEXTAUTH_SECRET=${envVars.NEXTAUTH_SECRET}
 
 `;

package/src/generators/index.js

@@ -22,17 +22,17 @@ class FileGenerator {
       gitignore: null,
     };
 
-    // Generate API client
+    // Generate API client (async - checks for file overwrites)
     if (options.features && options.features.length > 0) {
-      results.apiClient = apiClientGenerator.generate(options);
+      results.apiClient = await apiClientGenerator.generate(options);
     }
 
     // Generate environment file
     results.envFile = envGenerator.generate(options);
 
-    // Generate NextAuth.js config if OAuth is enabled
+    // Generate NextAuth.js config if OAuth is enabled (async - checks for file overwrites)
     if (options.features && options.features.includes('oauth') && options.oauthProviders) {
-      results.nextauth = nextauthGenerator.generate(options);
+      results.nextauth = await nextauthGenerator.generate(options);
     }
 
     // Generate OAuth guide if OAuth is enabled

package/src/generators/nextauth-generator.js

@@ -5,12 +5,15 @@
 
 const fs = require('fs');
 const path = require('path');
+const { checkFileOverwrite, writeFileWithBackup, ensureDir } = require('../utils/file-utils');
 
 class NextAuthGenerator {
   /**
    * Generate NextAuth.js configuration
+   * @param {Object} options - Generation options
+   * @returns {Promise<string|null>} - Path to generated file or null if skipped
    */
-  generate(options) {
+  async generate(options) {
     const {
       projectPath,
       backendUrl,
@@ -25,9 +28,7 @@ class NextAuthGenerator {
       : path.join(projectPath, 'pages', 'api', 'auth');
 
     // Ensure directory exists
-    if (!fs.existsSync(apiDir)) {
-      fs.mkdirSync(apiDir, { recursive: true });
-    }
+    ensureDir(apiDir);
 
     const extension = isTypeScript ? 'ts' : 'js';
     const routePath = routerType === 'app'
@@ -37,9 +38,14 @@ class NextAuthGenerator {
     // 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 });
-      }
+      ensureDir(nextauthDir);
+    }
+
+    // Check if file exists and get action
+    const action = await checkFileOverwrite(routePath);
+
+    if (action === 'skip') {
+      return null;
     }
 
     // Generate NextAuth configuration
@@ -50,8 +56,7 @@ class NextAuthGenerator {
       isTypeScript,
     });
 
-    fs.writeFileSync(routePath, code, 'utf8');
-    return routePath;
+    return writeFileWithBackup(routePath, code, action);
   }
 
   /**

package/src/utils/file-utils.js

@@ -0,0 +1,117 @@
+/**
+ * File Utilities
+ * Helper functions for safe file operations
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+const GENERATED_HEADER = 'Auto-generated by @l4yercak3/cli';
+
+/**
+ * Check if a file was generated by our CLI
+ */
+function isGeneratedFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return false;
+  }
+
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+    // Check first 500 chars for our header
+    return content.substring(0, 500).includes(GENERATED_HEADER);
+  } catch (error) {
+    return false;
+  }
+}
+
+/**
+ * Check if file exists and prompt for action if needed
+ * Returns: 'write' | 'skip' | 'backup'
+ */
+async function checkFileOverwrite(filePath, options = {}) {
+  const { silent = false, defaultAction = 'prompt' } = options;
+
+  if (!fs.existsSync(filePath)) {
+    return 'write';
+  }
+
+  // If it's our generated file, safe to overwrite
+  if (isGeneratedFile(filePath)) {
+    if (!silent) {
+      console.log(chalk.gray(`  Updating ${path.basename(filePath)} (previously generated)`));
+    }
+    return 'write';
+  }
+
+  // File exists and wasn't generated by us - prompt user
+  if (defaultAction === 'skip') {
+    return 'skip';
+  }
+
+  const relativePath = path.basename(filePath);
+  console.log(chalk.yellow(`\n  ⚠️  ${relativePath} already exists and appears to be modified`));
+
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: `What would you like to do with ${relativePath}?`,
+      choices: [
+        { name: 'Overwrite (replace with generated code)', value: 'write' },
+        { name: 'Backup and overwrite (save old file as .backup)', value: 'backup' },
+        { name: 'Skip (keep existing file)', value: 'skip' },
+      ],
+    },
+  ]);
+
+  return action;
+}
+
+/**
+ * Write file with optional backup
+ */
+function writeFileWithBackup(filePath, content, action) {
+  if (action === 'skip') {
+    return null;
+  }
+
+  if (action === 'backup' && fs.existsSync(filePath)) {
+    const backupPath = `${filePath}.backup`;
+    fs.copyFileSync(filePath, backupPath);
+    console.log(chalk.gray(`  Backed up to ${path.basename(backupPath)}`));
+  }
+
+  fs.writeFileSync(filePath, content, 'utf8');
+  return filePath;
+}
+
+/**
+ * Ensure directory exists
+ */
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+/**
+ * Generate SHA256 hash of project path for identification
+ * This is used to identify returning projects when registering with backend
+ */
+function generateProjectPathHash(projectPath) {
+  const absolutePath = path.resolve(projectPath);
+  return crypto.createHash('sha256').update(absolutePath).digest('hex');
+}
+
+module.exports = {
+  GENERATED_HEADER,
+  isGeneratedFile,
+  checkFileOverwrite,
+  writeFileWithBackup,
+  ensureDir,
+  generateProjectPathHash,
+};

package/tests/api-client-generator.test.js

@@ -6,8 +6,17 @@ const fs = require('fs');
 const path = require('path');
 
 jest.mock('fs');
+jest.mock('../src/utils/file-utils', () => ({
+  checkFileOverwrite: jest.fn().mockResolvedValue('write'),
+  writeFileWithBackup: jest.fn((filePath, content, action) => {
+    if (action === 'skip') return null;
+    return filePath;
+  }),
+  ensureDir: jest.fn(),
+}));
 
 const ApiClientGenerator = require('../src/generators/api-client-generator');
+const { checkFileOverwrite, writeFileWithBackup, ensureDir } = require('../src/utils/file-utils');
 
 describe('ApiClientGenerator', () => {
   const mockProjectPath = '/test/project';
@@ -17,10 +26,11 @@ describe('ApiClientGenerator', () => {
     fs.existsSync.mockReturnValue(false);
     fs.mkdirSync.mockReturnValue(undefined);
     fs.writeFileSync.mockReturnValue(undefined);
+    checkFileOverwrite.mockResolvedValue('write');
   });
 
   describe('generate', () => {
-    it('creates api-client.js in lib folder when no src exists', () => {
+    it('creates api-client.js in lib folder when no src exists', async () => {
       fs.existsSync.mockReturnValue(false);
 
       const options = {
@@ -31,17 +41,14 @@ describe('ApiClientGenerator', () => {
         isTypeScript: false,
       };
 
-      const result = ApiClientGenerator.generate(options);
+      const result = await ApiClientGenerator.generate(options);
 
       expect(result).toBe(path.join(mockProjectPath, 'lib', 'api-client.js'));
-      expect(fs.mkdirSync).toHaveBeenCalledWith(
-        path.join(mockProjectPath, 'lib'),
-        { recursive: true }
-      );
-      expect(fs.writeFileSync).toHaveBeenCalled();
+      expect(ensureDir).toHaveBeenCalledWith(path.join(mockProjectPath, 'lib'));
+      expect(writeFileWithBackup).toHaveBeenCalled();
     });
 
-    it('creates api-client.ts in src/lib folder when src exists', () => {
+    it('creates api-client.ts in src/lib folder when src exists', async () => {
       fs.existsSync.mockImplementation((p) =>
         p === path.join(mockProjectPath, 'src')
       );
@@ -54,13 +61,13 @@ describe('ApiClientGenerator', () => {
         isTypeScript: true,
       };
 
-      const result = ApiClientGenerator.generate(options);
+      const result = await ApiClientGenerator.generate(options);
 
       expect(result).toBe(path.join(mockProjectPath, 'src', 'lib', 'api-client.ts'));
     });
 
-    it('does not create lib dir if it exists', () => {
-      fs.existsSync.mockReturnValue(true);
+    it('returns null when user skips overwrite', async () => {
+      checkFileOverwrite.mockResolvedValue('skip');
 
       const options = {
         projectPath: mockProjectPath,
@@ -70,9 +77,9 @@ describe('ApiClientGenerator', () => {
         isTypeScript: false,
       };
 
-      ApiClientGenerator.generate(options);
+      const result = await ApiClientGenerator.generate(options);
 
-      expect(fs.mkdirSync).not.toHaveBeenCalled();
+      expect(result).toBeNull();
     });
   });