npm - @l4yercak3/cli - Versions diffs - 1.0.0 - Mend

@l4yercak3/cli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

package/.claude/settings.local.json +18 -0
package/.cursor/rules.md +203 -0
package/.eslintrc.js +31 -0
package/README.md +227 -0
package/bin/cli.js +61 -0
package/docs/ADDING_NEW_PROJECT_TYPE.md +156 -0
package/docs/ARCHITECTURE_RELATIONSHIPS.md +411 -0
package/docs/CLI_AUTHENTICATION.md +214 -0
package/docs/DETECTOR_ARCHITECTURE.md +326 -0
package/docs/DEVELOPMENT.md +194 -0
package/docs/IMPLEMENTATION_PHASES.md +468 -0
package/docs/OAUTH_CLARIFICATION.md +258 -0
package/docs/OAUTH_SETUP_GUIDE_TEMPLATE.md +211 -0
package/docs/PHASE_0_PROGRESS.md +120 -0
package/docs/PHASE_1_COMPLETE.md +366 -0
package/docs/PHASE_SUMMARY.md +149 -0
package/docs/PLAN.md +511 -0
package/docs/README.md +56 -0
package/docs/STRIPE_INTEGRATION.md +447 -0
package/docs/SUMMARY.md +230 -0
package/docs/UPDATED_PLAN.md +447 -0
package/package.json +53 -0
package/src/api/backend-client.js +148 -0
package/src/commands/login.js +146 -0
package/src/commands/logout.js +24 -0
package/src/commands/spread.js +364 -0
package/src/commands/status.js +62 -0
package/src/config/config-manager.js +205 -0
package/src/detectors/api-client-detector.js +85 -0
package/src/detectors/base-detector.js +77 -0
package/src/detectors/github-detector.js +74 -0
package/src/detectors/index.js +80 -0
package/src/detectors/nextjs-detector.js +139 -0
package/src/detectors/oauth-detector.js +122 -0
package/src/detectors/registry.js +97 -0
package/src/generators/api-client-generator.js +197 -0
package/src/generators/env-generator.js +162 -0
package/src/generators/gitignore-generator.js +92 -0
package/src/generators/index.js +50 -0
package/src/generators/nextauth-generator.js +242 -0
package/src/generators/oauth-guide-generator.js +277 -0
package/src/logo.js +116 -0
package/tests/api-client-detector.test.js +214 -0
package/tests/api-client-generator.test.js +169 -0
package/tests/backend-client.test.js +361 -0
package/tests/base-detector.test.js +101 -0
package/tests/commands/login.test.js +98 -0
package/tests/commands/logout.test.js +70 -0
package/tests/commands/status.test.js +167 -0
package/tests/config-manager.test.js +313 -0
package/tests/detector-index.test.js +209 -0
package/tests/detector-registry.test.js +93 -0
package/tests/env-generator.test.js +278 -0
package/tests/generators-index.test.js +215 -0
package/tests/github-detector.test.js +145 -0
package/tests/gitignore-generator.test.js +109 -0
package/tests/logo.test.js +96 -0
package/tests/nextauth-generator.test.js +231 -0
package/tests/nextjs-detector.test.js +235 -0
package/tests/oauth-detector.test.js +264 -0
package/tests/oauth-guide-generator.test.js +273 -0

package/src/commands/login.js ADDED Viewed

@@ -0,0 +1,146 @@
+/**
+ * Login Command
+ * Handles CLI authentication via browser OAuth flow
+ */
+const { default: open } = require('open');
+const configManager = require('../config/config-manager');
+const backendClient = require('../api/backend-client');
+const chalk = require('chalk');
+/**
+ * Start local server to receive OAuth callback
+ */
+function startCallbackServer() {
+  return new Promise((resolve, reject) => {
+    const http = require('http');
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url, 'http://localhost:3001');
+      if (url.pathname === '/callback') {
+        const token = url.searchParams.get('token');
+        if (token) {
+          res.writeHead(200, { 'Content-Type': 'text/html' });
+          res.end(`
+            <html>
+              <head><title>CLI Login Success</title></head>
+              <body style="font-family: system-ui; padding: 40px; text-align: center;">
+                <h1 style="color: #9F7AEA;">✅ Successfully logged in!</h1>
+                <p>You can close this window and return to your terminal.</p>
+              </body>
+            </html>
+          `);
+          server.close();
+          resolve(token);
+        } else {
+          res.writeHead(400, { 'Content-Type': 'text/html' });
+          res.end(`
+            <html>
+              <head><title>CLI Login Error</title></head>
+              <body style="font-family: system-ui; padding: 40px; text-align: center;">
+                <h1 style="color: #EF4444;">❌ Login failed</h1>
+                <p>No token received. Please try again.</p>
+              </body>
+            </html>
+          `);
+          server.close();
+          reject(new Error('No token received'));
+        }
+      } else {
+        res.writeHead(404);
+        res.end('Not found');
+      }
+    });
+    server.listen(3001, 'localhost', () => {
+      console.log(chalk.gray('  Waiting for authentication...'));
+    });
+    // Timeout after 5 minutes
+    setTimeout(() => {
+      server.close();
+      reject(new Error('Login timeout - please try again'));
+    }, 5 * 60 * 1000);
+  });
+}
+/**
+ * Login command handler
+ */
+async function handleLogin() {
+  try {
+    // Check if already logged in
+    if (configManager.isLoggedIn()) {
+      const session = configManager.getSession();
+      console.log(chalk.yellow('  ⚠️  You are already logged in'));
+      console.log(chalk.gray(`  Email: ${session.email}`));
+      console.log(chalk.gray(`  Session expires: ${new Date(session.expiresAt).toLocaleString()}`));
+      console.log(chalk.gray('\n  Run "l4yercak3 logout" to log out first\n'));
+      return;
+    }
+    console.log(chalk.cyan('  🔐 Opening browser for authentication...\n'));
+    // Start callback server
+    const callbackPromise = startCallbackServer();
+    // Open browser
+    const loginUrl = backendClient.getLoginUrl();
+    console.log(chalk.gray(`  Login URL: ${loginUrl}\n`));
+    await open(loginUrl);
+    // Wait for callback
+    const token = await callbackPromise;
+    // Validate token and get user info
+    console.log(chalk.gray('  Validating session...'));
+    // Save session
+    // Note: In real implementation, backend would return full session data
+    const session = {
+      token,
+      expiresAt: Date.now() + (30 * 24 * 60 * 60 * 1000), // 30 days
+      // Backend should return: userId, email, etc.
+    };
+    configManager.saveSession(session);
+    // Validate session with backend
+    try {
+      const userInfo = await backendClient.validateSession();
+      if (userInfo) {
+        configManager.saveSession({
+          ...session,
+          userId: userInfo.userId,
+          email: userInfo.email,
+        });
+      }
+    } catch (error) {
+      console.log(chalk.yellow(`  ⚠️  Warning: Could not validate session: ${error.message}`));
+      console.log(chalk.gray('  Session saved, but validation failed. You may need to log in again.'));
+    }
+    console.log(chalk.green('\n  ✅ Successfully logged in!\n'));
+    const finalSession = configManager.getSession();
+    if (finalSession && finalSession.email) {
+      console.log(chalk.gray(`  Logged in as: ${finalSession.email}`));
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n  ❌ Login failed: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+module.exports = {
+  command: 'login',
+  description: 'Authenticate with L4YERCAK3 platform',
+  handler: handleLogin,
+};

package/src/commands/logout.js ADDED Viewed

@@ -0,0 +1,24 @@
+/**
+ * Logout Command
+ * Clears CLI session
+ */
+const configManager = require('../config/config-manager');
+const chalk = require('chalk');
+async function handleLogout() {
+  if (!configManager.isLoggedIn()) {
+    console.log(chalk.yellow('  ⚠️  You are not logged in\n'));
+    return;
+  }
+  configManager.clearSession();
+  console.log(chalk.green('  ✅ Successfully logged out\n'));
+}
+module.exports = {
+  command: 'logout',
+  description: 'Log out from L4YERCAK3 platform',
+  handler: handleLogout,
+};

package/src/commands/spread.js ADDED Viewed

@@ -0,0 +1,364 @@
+/**
+ * Spread Command
+ * Main command for setting up boilerplate integration
+ */
+const configManager = require('../config/config-manager');
+const backendClient = require('../api/backend-client');
+const projectDetector = require('../detectors');
+const fileGenerator = require('../generators');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const path = require('path');
+/**
+ * Helper function to create an organization
+ */
+async function createOrganization(orgName) {
+  console.log(chalk.gray(`  Creating organization "${orgName}"...`));
+  const newOrg = await backendClient.createOrganization(orgName);
+  // Handle different response formats
+  const organizationId = newOrg.organizationId || newOrg.id || newOrg.data?.organizationId || newOrg.data?.id;
+  const organizationName = newOrg.name || orgName;
+  if (!organizationId) {
+    throw new Error('Organization ID not found in response. Please check backend API endpoint.');
+  }
+  console.log(chalk.green(`  ✅ Organization created: ${organizationName}\n`));
+  return { organizationId, organizationName };
+}
+async function handleSpread() {
+  // Check if logged in
+  if (!configManager.isLoggedIn()) {
+    console.log(chalk.yellow('  ⚠️  You must be logged in first'));
+    console.log(chalk.gray('\n  Run "l4yercak3 login" to authenticate\n'));
+    process.exit(1);
+  }
+  console.log(chalk.cyan('  🍰 Setting up your Layer Cake integration...\n'));
+  try {
+    // Step 1: Detect project
+    console.log(chalk.gray('  🔍 Detecting project...\n'));
+    const detection = projectDetector.detect();
+    // Display framework detection results
+    if (detection.framework.type) {
+      const frameworkName = detection.framework.type === 'nextjs' ? 'Next.js' : detection.framework.type;
+      console.log(chalk.green(`  ✅ Detected ${frameworkName} project`));
+      if (detection.framework.type === 'nextjs') {
+        const meta = detection.framework.metadata;
+        if (meta.version) {
+          console.log(chalk.gray(`     Version: ${meta.version}`));
+        }
+        if (meta.routerType) {
+          console.log(chalk.gray(`     Router: ${meta.routerType === 'app' ? 'App Router' : 'Pages Router'}`));
+        }
+        if (meta.hasTypeScript) {
+          console.log(chalk.gray('     TypeScript: Yes'));
+        }
+      }
+      // Show supported features
+      const features = detection.framework.supportedFeatures;
+      const supportedFeatures = Object.entries(features)
+        .filter(([_, supported]) => supported === true || supported === 'manual')
+        .map(([name]) => name);
+      if (supportedFeatures.length > 0) {
+        console.log(chalk.gray(`     Supported features: ${supportedFeatures.join(', ')}`));
+      }
+    } else {
+      console.log(chalk.yellow('  ⚠️  Could not detect project type'));
+      const { continueAnyway } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'continueAnyway',
+          message: 'Continue with basic setup anyway?',
+          default: false,
+        },
+      ]);
+      if (!continueAnyway) {
+        console.log(chalk.gray('\n  Setup cancelled.\n'));
+        process.exit(0);
+      }
+    }
+    // Display GitHub detection
+    if (detection.github.isGitHub) {
+      console.log(chalk.green(`  ✅ Detected GitHub repository: ${detection.github.owner}/${detection.github.repo}`));
+    }
+    // Display API client detection
+    if (detection.apiClient.hasApiClient) {
+      console.log(chalk.yellow(`  ⚠️  Existing API client found: ${detection.apiClient.clientPath}`));
+    }
+    // Display OAuth detection
+    if (detection.oauth.hasOAuth) {
+      console.log(chalk.yellow(`  ⚠️  Existing OAuth setup detected: ${detection.oauth.oauthType}`));
+      if (detection.oauth.providers.length > 0) {
+        console.log(chalk.gray(`     Providers: ${detection.oauth.providers.join(', ')}`));
+      }
+      if (detection.oauth.configPath) {
+        console.log(chalk.gray(`     Config: ${detection.oauth.configPath}`));
+      }
+    }
+    console.log('');
+    // Step 2: Organization selection
+    console.log(chalk.cyan('  📦 Organization Setup\n'));
+    let organizationId;
+    let organizationName;
+    try {
+      const orgsResponse = await backendClient.getOrganizations();
+      // Handle different response formats
+      const organizations = Array.isArray(orgsResponse)
+        ? orgsResponse
+        : orgsResponse.organizations || orgsResponse.data || [];
+      if (organizations.length === 0) {
+        // No organizations, create one
+        const { orgName } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'orgName',
+            message: 'Organization name:',
+            default: detection.github.repo || 'My Organization',
+            validate: (input) => input.trim().length > 0 || 'Organization name is required',
+          },
+        ]);
+        const result = await createOrganization(orgName);
+        organizationId = result.organizationId;
+        organizationName = result.organizationName;
+      } else {
+        // Select or create organization
+        const { orgChoice } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'orgChoice',
+            message: 'Select organization:',
+            choices: [
+              ...organizations.map(org => ({
+                name: `${org.name} (${org.id})`,
+                value: org.id,
+              })),
+              { name: '➕ Create new organization', value: '__create__' },
+            ],
+          },
+        ]);
+        if (orgChoice === '__create__') {
+          const { orgName } = await inquirer.prompt([
+            {
+              type: 'input',
+              name: 'orgName',
+              message: 'Organization name:',
+              default: detection.github.repo || 'My Organization',
+              validate: (input) => input.trim().length > 0 || 'Organization name is required',
+            },
+          ]);
+          const result = await createOrganization(orgName);
+          organizationId = result.organizationId;
+          organizationName = result.organizationName;
+        } else {
+          const selectedOrg = organizations.find(org => org.id === orgChoice);
+          organizationId = orgChoice;
+          organizationName = selectedOrg.name;
+          console.log(chalk.green(`  ✅ Selected organization: ${organizationName}\n`));
+        }
+      }
+    } catch (error) {
+      console.error(chalk.red(`  ❌ Error managing organizations: ${error.message}\n`));
+      process.exit(1);
+    }
+    // Step 3: Generate API key
+    console.log(chalk.cyan('  🔑 API Key Setup\n'));
+    let apiKey;
+    try {
+      console.log(chalk.gray('  Generating API key...'));
+      const apiKeyResponse = await backendClient.generateApiKey(
+        organizationId,
+        'CLI Generated Key',
+        ['*']
+      );
+      // Handle different response formats
+      apiKey = apiKeyResponse.key || apiKeyResponse.apiKey || apiKeyResponse.data?.key || apiKeyResponse.data?.apiKey;
+      if (!apiKey) {
+        throw new Error('API key not found in response. Please check backend API endpoint.');
+      }
+      console.log(chalk.green(`  ✅ API key generated\n`));
+    } catch (error) {
+      console.error(chalk.red(`  ❌ Error generating API key: ${error.message}\n`));
+      process.exit(1);
+    }
+    // Step 4: Feature selection
+    console.log(chalk.cyan('  ⚙️  Feature Selection\n'));
+    const { features } = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        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: 'OAuth Authentication', value: 'oauth', checked: false },
+          { name: 'Stripe Integration', value: 'stripe', checked: false },
+        ],
+      },
+    ]);
+    // Step 5: OAuth provider selection (if OAuth enabled)
+    let oauthProviders = [];
+    if (features.includes('oauth')) {
+      const { providers } = await inquirer.prompt([
+        {
+          type: 'checkbox',
+          name: 'providers',
+          message: 'Select OAuth providers:',
+          choices: [
+            { name: 'Google', value: 'google', checked: true },
+            { name: 'Microsoft', value: 'microsoft', checked: true },
+            { name: 'GitHub', value: 'github', checked: false },
+          ],
+        },
+      ]);
+      oauthProviders = providers;
+    }
+    // Step 6: Backend URL
+    const defaultBackendUrl = configManager.getBackendUrl();
+    const { backendUrl } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'backendUrl',
+        message: 'Backend API URL:',
+        default: defaultBackendUrl,
+        validate: (input) => {
+          try {
+            new URL(input);
+            return true;
+          } catch {
+            return 'Please enter a valid URL';
+          }
+        },
+      },
+    ]);
+    // Step 7: Production domain (for OAuth redirect URIs)
+    let productionDomain = 'your-domain.com';
+    if (features.includes('oauth')) {
+      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;
+    }
+    // Step 8: Generate files
+    console.log(chalk.cyan('\n  📝 Generating files...\n'));
+    // Extract framework metadata for generation
+    const frameworkMeta = detection.framework.metadata || {};
+    const isTypeScript = frameworkMeta.hasTypeScript || false;
+    const routerType = frameworkMeta.routerType || 'pages';
+    const generationOptions = {
+      projectPath: detection.projectPath,
+      apiKey,
+      backendUrl,
+      organizationId,
+      organizationName,
+      features,
+      oauthProviders,
+      productionDomain,
+      appName: detection.github.repo || organizationName,
+      isTypeScript,
+      routerType,
+      frameworkType: detection.framework.type || 'unknown',
+    };
+    const generatedFiles = await fileGenerator.generate(generationOptions);
+    // Display results
+    console.log(chalk.green('  ✅ Files generated:\n'));
+    if (generatedFiles.apiClient) {
+      console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.apiClient)}`));
+    }
+    if (generatedFiles.envFile) {
+      console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.envFile)}`));
+    }
+    if (generatedFiles.nextauth) {
+      console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.nextauth)}`));
+    }
+    if (generatedFiles.oauthGuide) {
+      console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.oauthGuide)}`));
+    }
+    if (generatedFiles.gitignore) {
+      console.log(chalk.gray(`     • ${path.relative(process.cwd(), generatedFiles.gitignore)} (updated)`));
+    }
+    // Save project configuration
+    const projectConfig = {
+      organizationId,
+      organizationName,
+      apiKey: `${apiKey.substring(0, 10)}...`, // Store partial key for reference only
+      backendUrl,
+      features,
+      oauthProviders,
+      productionDomain,
+      frameworkType: detection.framework.type,
+      createdAt: Date.now(),
+    };
+    configManager.saveProjectConfig(detection.projectPath, projectConfig);
+    console.log(chalk.gray(`  📝 Configuration saved to ~/.l4yercak3/config.json\n`));
+    console.log(chalk.cyan('\n  🎉 Setup complete!\n'));
+    if (features.includes('oauth')) {
+      console.log(chalk.yellow('  📋 Next steps:\n'));
+      console.log(chalk.gray('     1. Follow the OAuth setup guide (OAUTH_SETUP_GUIDE.md)'));
+      console.log(chalk.gray('     2. Add OAuth credentials to .env.local'));
+      console.log(chalk.gray('     3. Install NextAuth.js: npm install next-auth'));
+      if (oauthProviders.includes('microsoft')) {
+        console.log(chalk.gray('     4. Install Azure AD provider: npm install next-auth/providers/azure-ad'));
+      }
+      console.log('');
+    }
+    console.log(chalk.gray('  Your project is now connected to L4YERCAK3! 🍰\n'));
+  } catch (error) {
+    console.error(chalk.red(`\n  ❌ Error: ${error.message}\n`));
+    if (error.stack) {
+      console.error(chalk.gray(error.stack));
+    }
+    process.exit(1);
+  }
+}
+module.exports = {
+  command: 'spread',
+  description: 'Initialize a new project integration',
+  handler: handleSpread,
+};

package/src/commands/status.js ADDED Viewed

@@ -0,0 +1,62 @@
+/**
+ * Status Command
+ * Shows authentication status and user info
+ */
+const configManager = require('../config/config-manager');
+const backendClient = require('../api/backend-client');
+const chalk = require('chalk');
+async function handleStatus() {
+  const isLoggedIn = configManager.isLoggedIn();
+  const session = configManager.getSession();
+  console.log(chalk.bold('  Authentication Status\n'));
+  if (!isLoggedIn) {
+    console.log(chalk.red('  ❌ Not logged in'));
+    console.log(chalk.gray('\n  Run "l4yercak3 login" to authenticate\n'));
+    return;
+  }
+  console.log(chalk.green('  ✅ Logged in\n'));
+  if (session) {
+    if (session.email) {
+      console.log(chalk.gray(`  Email: ${session.email}`));
+    }
+    if (session.expiresAt) {
+      const expiresDate = new Date(session.expiresAt);
+      const now = Date.now();
+      const daysLeft = Math.floor((session.expiresAt - now) / (24 * 60 * 60 * 1000));
+      if (daysLeft > 0) {
+        console.log(chalk.gray(`  Session expires: ${expiresDate.toLocaleString()} (${daysLeft} days)`));
+      } else {
+        console.log(chalk.yellow(`  ⚠️  Session expired: ${expiresDate.toLocaleString()}`));
+      }
+    }
+  }
+  // Try to validate session with backend
+  try {
+    const userInfo = await backendClient.validateSession();
+    if (userInfo) {
+      console.log(chalk.gray(`\n  Backend URL: ${configManager.getBackendUrl()}`));
+      if (userInfo.organizations && userInfo.organizations.length > 0) {
+        console.log(chalk.gray(`  Organizations: ${userInfo.organizations.length}`));
+      }
+    }
+  } catch (error) {
+    console.log(chalk.yellow(`\n  ⚠️  Could not validate session: ${error.message}`));
+  }
+  console.log('');
+}
+module.exports = {
+  command: 'status',
+  description: 'Show authentication status',
+  handler: handleStatus,
+};