spaps 0.5.0 → 0.5.1

package/src/handlers.js

@@ -0,0 +1,155 @@
+const chalk = require('chalk');
+const fs = require('fs');
+const { DEFAULT_PORT } = require('./config');
+const { handleError } = require('./error-handler');
+const { showInteractiveHelp, showQuickHelp } = require('./help-system');
+const { showInteractiveDocs, showQuickReference, searchDocs } = require('./docs-system');
+const { getQuickStartInstructions, getServerStatus, runQuickTest } = require('./ai-helper');
+
+function createHandlers(version, logo) {
+  return {
+    local: async ({ options }) => {
+      const isJson = options.json;
+      if (!isJson) console.log(logo);
+      try {
+        const LocalServer = require('./local-server.js');
+        const server = new LocalServer({ port: options.port, json: isJson });
+        if (isJson) {
+          await server.start();
+          console.log(JSON.stringify({
+            success: true,
+            command: 'local',
+            server: {
+              url: `http://localhost:${options.port}`,
+              docs: `http://localhost:${options.port}/docs`,
+              mode: 'local-development',
+              port: Number(options.port),
+              features: { autoAuth: true, corsEnabled: true, testUsers: ['user', 'admin', 'premium'], apiKeyRequired: false }
+            }
+          }));
+        } else {
+          await server.start();
+          if (options.open) {
+            const { exec } = require('child_process');
+            const url = `http://localhost:${options.port}/docs`;
+            const start = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+            exec(`${start} ${url}`);
+          }
+        }
+        process.on('SIGINT', () => {
+          if (!isJson) console.log(chalk.yellow('\n👋 Shutting down SPAPS local server...'));
+          process.exit(0);
+        });
+      } catch (error) {
+        handleError(error, { port: options.port, command: 'local' }, { json: isJson });
+      }
+    },
+    quickstart: async ({ options }) => {
+      const instructions = getQuickStartInstructions(options.port);
+      if (options.json) {
+        console.log(JSON.stringify(instructions, null, 2));
+      } else {
+        console.log(chalk.yellow('\n🍠 SPAPS Quick Start Instructions\n'));
+        console.log('1. Install SDK: npm install spaps-sdk');
+        console.log('2. Create test file with the code above');
+        console.log('3. Run: node test-spaps.js');
+        console.log('\nFor JSON output: npx spaps quickstart --json');
+      }
+    },
+    status: async ({ options }) => {
+      const status = await getServerStatus(options.port);
+      if (options.json) {
+        console.log(JSON.stringify(status));
+      } else {
+        if (!status.running) {
+          console.log(chalk.red('\n❌ SPAPS server is not running'));
+          console.log('Start it with:');
+          console.log(chalk.cyan(`  npx spaps local --port ${options.port}`));
+          console.log();
+        } else {
+          console.log(chalk.green('\n✅ SPAPS server is running!\n'));
+          console.log('  URL:', chalk.cyan(status.url));
+          console.log('  Docs:', chalk.cyan(status.docs));
+          console.log();
+        }
+      }
+    },
+    test: async ({ options }) => {
+      const result = await runQuickTest(options.port);
+      console.log(JSON.stringify(result, null, 2));
+    },
+    init: async ({ options }) => {
+      const isJson = options.json;
+      const envContent = `# SPAPS Local Development\nSPAPS_API_URL=http://localhost:${DEFAULT_PORT}\n# SPAPS_API_KEY=your-api-key-here\n`;
+      const result = { success: true, command: 'init', files_created: [], files_skipped: [], next_steps: ['npx spaps local', 'npm install @spaps/sdk', 'Start coding!'] };
+      if (!fs.existsSync('.env.local')) {
+        fs.writeFileSync('.env.local', envContent);
+        result.files_created.push('.env.local');
+        if (!isJson) console.log(chalk.green('✅ Created .env.local'));
+      } else {
+        result.files_skipped.push('.env.local');
+        result.message = '.env.local already exists';
+        if (!isJson) console.log(chalk.yellow('⚠️  .env.local already exists'));
+      }
+      if (isJson) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log();
+        console.log(chalk.green('✨ SPAPS initialized!'));
+        console.log();
+        console.log('Next steps:');
+        console.log(chalk.cyan('  1. Run: npx spaps local'));
+        console.log(chalk.cyan('  2. Install SDK: npm install @spaps/sdk'));
+        console.log(chalk.cyan('  3. Start coding!'));
+      }
+    },
+    create: () => {
+      console.log(chalk.yellow('🍠 SPAPS'));
+      console.log(chalk.yellow(`🚧 'spaps create' coming in v0.3.0!`));
+      console.log();
+      console.log('For now, check out our examples:');
+      console.log(chalk.cyan('  https://github.com/yourusername/sweet-potato/tree/main/examples'));
+    },
+    types: () => {
+      console.log(chalk.yellow('🍠 SPAPS'));
+      console.log(chalk.yellow(`🚧 'spaps types' coming in v0.4.0!`));
+    },
+    help: async ({ options }) => {
+      if (options.interactive) {
+        await showInteractiveHelp();
+      } else if (options.quick) {
+        showQuickHelp();
+      } else {
+        showQuickHelp();
+      }
+    },
+    docs: async ({ options }) => {
+      if (options.search) {
+        const results = searchDocs(options.search);
+        if (options.json) {
+          console.log(JSON.stringify({ results }, null, 2));
+        } else {
+          console.log(chalk.yellow(`\n🔍 Search results for "${options.search}":\n`));
+          if (results.length === 0) {
+            console.log(chalk.gray('  No results found'));
+          } else {
+            results.forEach((result, i) => {
+              console.log(chalk.green(`  ${i + 1}. ${result.title}`));
+              console.log(chalk.gray(`     ${result.preview}`));
+              console.log();
+            });
+          }
+          console.log(chalk.blue('  Run: npx spaps docs --interactive'));
+          console.log(chalk.blue('  to browse full documentation\n'));
+        }
+      } else if (options.interactive) {
+        await showInteractiveDocs();
+      } else {
+        showQuickReference();
+      }
+    }
+  };
+}
+
+module.exports = { createHandlers };
+

package/src/help-system.js

@@ -6,6 +6,8 @@
 const chalk = require('chalk');
 const prompts = require('prompts');
 
+const { DEFAULT_PORT } = require('./config');
+
 const HELP_TREE = {
   root: {
     question: 'What would you like to do?',
@@ -45,12 +47,12 @@ const HELP_TREE = {
         title: 'Quick start (default settings)',
         value: 'quick-start',
         command: 'npx spaps local',
-        description: 'Start on port 3300'
+        description: `Start on port ${DEFAULT_PORT}`
       },
       {
         title: 'Custom port',
         value: 'custom-port',
-        command: 'npx spaps local --port 3001',
+        command: `npx spaps local --port ${DEFAULT_PORT + 1}`,
         description: 'Choose your own port'
       },
       {
@@ -484,4 +486,4 @@ module.exports = {
   showInteractiveHelp,
   showQuickHelp,
   HELP_TREE
-};
+};