spaps 0.4.3 → 0.5.1

package/bin/spaps.js

@@ -2,20 +2,12 @@
 
 /**
  * SPAPS CLI - Sweet Potato Authentication & Payment Service
- * 
- * This is a minimal implementation to secure the npm package name.
- * Full implementation coming soon!
  */
 
 const chalk = require('chalk');
-const { program } = require('commander');
-const { spawn } = require('child_process');
-const path = require('path');
 const fs = require('fs');
-const { handleError } = require('../src/error-handler');
-const { showInteractiveHelp, showQuickHelp } = require('../src/help-system');
-const { showInteractiveDocs, showQuickReference, searchDocs } = require('../src/docs-system');
-const { getQuickStartInstructions, getServerStatus, runQuickTest } = require('../src/ai-helper');
+const { buildProgram } = require('../src/cli-dispatcher');
+const { createHandlers } = require('../src/handlers');
 
 const version = require('../package.json').version;
 
@@ -24,307 +16,8 @@ const logo = `
 ${chalk.yellow('🍠 SPAPS')} - Sweet Potato Authentication & Payment Service
 `;
 
-program
-  .name('spaps')
-  .description('CLI for Sweet Potato Authentication & Payment Service')
-  .version(version)
-  .option('--json', 'Output in JSON format for machine parsing');
-
-// Local command - Start local development server
-program
-  .command('local')
-  .description('Start local SPAPS server (no API keys required!)')
-  .option('-p, --port <port>', 'Port to run on', '3456')
-  .option('-o, --open', 'Open browser automatically', false)
-  .option('--json', 'Output in JSON format')
-  .action(async (options, command) => {
-    const isJson = options.json || command.parent.opts().json;
-    
-    if (!isJson) {
-      console.log(logo);
-    }
-    
-    try {
-      // Import and start the local server
-      const LocalServer = require('../src/local-server.js');
-      const server = new LocalServer({ port: options.port, json: isJson });
-      
-      if (isJson) {
-        // For JSON output, start server and return immediately
-        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: parseInt(options.port),
-            features: {
-              autoAuth: true,
-              corsEnabled: true,
-              testUsers: ['user', 'admin', 'premium'],
-              apiKeyRequired: false
-            }
-          }
-        }));
-      } else {
-        await server.start();
-        
-        // Open browser if requested
-        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}`);
-        }
-      }
-      
-      // Keep process running
-      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 command - For AI agents
-program
-  .command('quickstart')
-  .description('Get quick start instructions (for AI agents)')
-  .option('-p, --port <port>', 'Port to check', '3300')
-  .option('--json', 'Output in JSON format')
-  .action(async (options) => {
-    const instructions = getQuickStartInstructions(options.port);
-    
-    if (options.json === true) {
-      console.log(JSON.stringify(instructions, null, 2));
-      process.exit(0);
-    } 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 command - Check if server is running
-program
-  .command('status')
-  .description('Check if SPAPS server is running')
-  .option('-p, --port <port>', 'Port to check', '3300')
-  .option('--json', 'Output in JSON format')
-  .action(async (options) => {
-    const status = await getServerStatus(options.port);
-    
-    if (options.json) {
-      console.log(JSON.stringify(status));
-    } else {
-      if (status.running) {
-        console.log(chalk.green(`✅ SPAPS is running on port ${options.port}`));
-        console.log(chalk.blue(`   URL: ${status.url}`));
-        console.log(chalk.blue(`   Docs: ${status.docs}`));
-      } else {
-        console.log(chalk.red(`❌ SPAPS is not running on port ${options.port}`));
-        console.log(chalk.yellow(`   Start with: ${status.start_command}`));
-      }
-    }
-  });
-
-// Test command - Run quick tests
-program
-  .command('test')
-  .description('Run quick tests to verify SPAPS is working')
-  .option('-p, --port <port>', 'Port to test', '3300')
-  .option('--json', 'Output in JSON format')
-  .action(async (options) => {
-    const results = await runQuickTest(options.port);
-    
-    if (options.json) {
-      console.log(JSON.stringify(results, null, 2));
-    } else {
-      console.log(chalk.yellow('\n🧪 Running SPAPS Tests...\n'));
-      
-      results.results.forEach(result => {
-        const icon = result.success ? '✅' : '❌';
-        console.log(`${icon} ${result.test}`);
-        if (!result.success && result.fix) {
-          console.log(chalk.yellow(`   Fix: ${result.fix}`));
-        }
-      });
-      
-      console.log();
-      console.log(results.success ? 
-        chalk.green(`✨ ${results.summary}`) : 
-        chalk.red(`⚠️  ${results.summary}`)
-      );
-      
-      if (results.next_steps) {
-        console.log('\nNext steps:');
-        results.next_steps.forEach(step => {
-          console.log(`  • ${step}`);
-        });
-      }
-    }
-  });
-
-// Init command - Initialize SPAPS in existing project
-program
-  .command('init')
-  .description('Initialize SPAPS in your project')
-  .option('--json', 'Output in JSON format')
-  .action((options, command) => {
-    const isJson = options.json || command.parent.opts().json;
-    
-    if (!isJson) {
-      console.log(logo);
-      console.log(chalk.green('🔧 Initializing SPAPS...'));
-      console.log();
-    }
-    
-    // Create minimal .env.local
-    const envContent = `# SPAPS Local Development Configuration
-# No API keys needed for local development!
-
-SPAPS_API_URL=http://localhost:3300
-NODE_ENV=development
-
-# When you're ready for production:
-# SPAPS_API_KEY=your-api-key-here
-`;
-
-    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 command (placeholder)
-program
-  .command('create <name>')
-  .description('Create a new project with SPAPS (coming soon)')
-  .action((name) => {
-    console.log(logo);
-    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 command (placeholder)
-program
-  .command('types')
-  .description('Generate TypeScript types (coming soon)')
-  .action(() => {
-    console.log(logo);
-    console.log(chalk.yellow(`🚧 'spaps types' coming in v0.4.0!`));
-  });
-
-// Help command - Interactive help system
-program
-  .command('help')
-  .description('Show help and guides')
-  .option('-i, --interactive', 'Interactive help mode')
-  .option('-q, --quick', 'Quick reference')
-  .action(async (options) => {
-    if (options.interactive) {
-      await showInteractiveHelp();
-    } else if (options.quick) {
-      showQuickHelp();
-    } else {
-      // Default to quick help
-      showQuickHelp();
-    }
-  });
-
-// Docs command - SDK documentation
-program
-  .command('docs')
-  .description('Browse SDK documentation')
-  .option('-i, --interactive', 'Interactive documentation browser')
-  .option('-s, --search <query>', 'Search documentation')
-  .option('--json', 'Output in JSON format')
-  .action(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 {
-      // Default to quick reference
-      showQuickReference();
-    }
-  });
-
-// Help command enhancement
-program.on('--help', () => {
-  console.log();
-  console.log('Examples:');
-  console.log();
-  console.log('  $ spaps local                 # Start local dev server');
-  console.log('  $ spaps init                  # Initialize in current project');
-  console.log('  $ spaps create my-app         # Create new project (soon)');
-  console.log();
-  console.log('Learn more at https://sweetpotato.dev');
-});
+const handlers = createHandlers(version, logo);
+const program = buildProgram({ handlers, dryRun: false, version, logo });
 
 // Show help if no command provided
 if (!process.argv.slice(2).length) {
@@ -334,4 +27,4 @@ if (!process.argv.slice(2).length) {
   console.log(chalk.yellow('💡 Try: npx spaps help --interactive'));
 }
 
-program.parse(process.argv);
+program.parse(process.argv);

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "spaps",
-  "version": "0.4.3",
-  "description": "Sweet Potato Authentication & Payment Service CLI - Zero-config local development and project scaffolding",
-  "main": "bin/spaps.js",
+  "version": "0.5.1",
+  "description": "Sweet Potato Authentication & Payment Service CLI - Zero-config local development with built-in admin middleware and permission utilities",
+  "main": "src/index.js",
   "bin": {
     "spaps": "./bin/spaps.js"
   },
   "exports": {
-    ".": "./bin/spaps.js",
-    "./client": "./client.js"
+    ".": "./src/index.js",
+    "./cli": "./bin/spaps.js",
+    "./client": "./client.js",
+    "./middleware": "./src/middleware/admin.js"
   },
   "scripts": {
     "test": "echo \"No tests yet\""
@@ -30,10 +32,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/sweet-potato"
+    "url": "https://github.com/buildooor/sweet-potato"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/sweet-potato/issues"
+    "url": "https://github.com/build000r/sweet-potato/issues"
   },
   "homepage": "https://sweetpotato.dev",
   "dependencies": {
@@ -44,7 +46,8 @@
     "express": "^4.18.2",
     "ora": "^5.4.1",
     "prompts": "^2.4.2",
-    "stripe": "^18.5.0"
+    "stripe": "^18.5.0",
+    "uuid": "^8.3.2"
   },
   "engines": {
     "node": ">=16.0.0"

package/src/ai-helper.js

@@ -5,7 +5,9 @@
 
 const chalk = require('chalk');
 
-function getQuickStartInstructions(port = 3300) {
+const { DEFAULT_PORT } = require('./config');
+
+function getQuickStartInstructions(port = DEFAULT_PORT) {
   return {
     success: true,
     instructions: {
@@ -17,22 +19,20 @@ function getQuickStartInstructions(port = 3300) {
       step2: {
         description: "Create test file",
         filename: "test-spaps.js",
-        content: `const { SPAPSClient } = require('spaps-sdk');
+        content: `const { SweetPotatoSDK } = require('spaps-sdk');
 
 async function test() {
-  const spaps = new SPAPSClient({
-    apiUrl: 'http://localhost:${port}'
-  });
-  
-  // Test login
-  const { data } = await spaps.login('test@example.com', 'password');
-  console.log('✅ Login successful:', data.user.email);
-  
+  const sdk = new SweetPotatoSDK({ apiUrl: 'http://localhost:${port}' });
+
+  // Test email/password auth (local mode accepts any credentials)
+  const auth = await sdk.auth.signInWithPassword({ email: 'test@example.com', password: 'password' });
+  console.log('✅ Login successful:', auth.user.email);
+
   // Test authenticated request
-  const user = await spaps.getUser();
-  console.log('✅ Got user:', user.data.email);
-  
-  return { success: true, user: user.data };
+  const user = await sdk.auth.getCurrentUser();
+  console.log('✅ Got user:', user.email);
+
+  return { success: true, user };
 }
 
 test().then(console.log).catch(console.error);`
@@ -70,9 +70,9 @@ test().then(console.log).catch(console.error);`
       },
       {
         method: "POST",
-        path: "/api/stripe/create-checkout-session",
-        body: { price_id: "string", success_url: "string" },
-        response: { sessionId: "string", url: "string" }
+        path: "/api/stripe/checkout-sessions",
+        body: { price_id: "string", success_url: "string", cancel_url: "string" },
+        response: { id: "string", url: "string", status: "string" }
       },
       {
         method: "GET",
@@ -84,12 +84,12 @@ test().then(console.log).catch(console.error);`
     test_commands: {
       health_check: `curl http://localhost:${port}/health`,
       login: `curl -X POST http://localhost:${port}/api/auth/login -H "Content-Type: application/json" -d '{"email":"test@example.com","password":"password"}'`,
-      with_sdk: `node -e "const {SPAPSClient}=require('spaps-sdk');const s=new SPAPSClient();s.login('test@example.com','password').then(r=>console.log(JSON.stringify(r.data))).catch(console.error)"`
+      with_sdk: `node -e "const {SweetPotatoSDK}=require('spaps-sdk');const sdk=new SweetPotatoSDK({apiUrl:'http://localhost:${port}'});sdk.auth.signInWithPassword({email:'test@example.com',password:'password'}).then(r=>console.log(JSON.stringify(r.user))).catch(console.error)"`
     }
   };
 }
 
-function getServerStatus(port = 3300) {
+function getServerStatus(port = DEFAULT_PORT) {
   const http = require('http');
   
   return new Promise((resolve) => {
@@ -270,4 +270,4 @@ module.exports = {
   getQuickStartInstructions,
   getServerStatus,
   runQuickTest
-};
+};

package/src/cli-dispatcher.js

@@ -0,0 +1,139 @@
+// CLI dispatcher: builds a Commander program with pluggable handlers
+// Enables dry-run parsing for unit tests without executing side effects.
+
+const { Command } = require('commander');
+const { DEFAULT_PORT } = require('./config');
+
+function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo = null } = {}) {
+  const intents = [];
+  const program = new Command();
+
+  if (dryRun) {
+    program.allowUnknownOption(true);
+  }
+
+  program
+    .name('spaps')
+    .description('CLI for Sweet Potato Authentication & Payment Service')
+    .version(version)
+    .option('--json', 'Output in JSON format for machine parsing');
+
+  function makeAction(name, shape) {
+    return async function actionWrapper(...args) {
+      // Commander 11 passes (options, command) for subcommands without args
+      // For commands with args, it passes (arg1, arg2, ..., options, command)
+      const cmd = args[args.length - 1];
+      const options = args[args.length - 2] || {};
+      const parentJson = program.opts().json;
+      const isJson = Boolean(options.json || parentJson);
+
+      const intent = { name, options: { ...shape(options, cmd, isJson) } };
+      intents.push(intent);
+
+      if (dryRun) return intent;
+      const handler = handlers[name];
+      if (typeof handler === 'function') {
+        return await handler(intent, { program, cmd });
+      }
+      return intent;
+    };
+  }
+
+  // spaps local
+  const cmdLocal = program
+    .command('local')
+    .description('Start local SPAPS server (no API keys required!)')
+    .option('-p, --port <port>', 'Port to run on', String(DEFAULT_PORT))
+    .option('-o, --open', 'Open browser automatically', false)
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('local', (opts, _cmd, isJson) => ({
+        port: Number(opts.port),
+        open: Boolean(opts.open),
+        json: isJson,
+      }))
+    );
+  if (dryRun) cmdLocal.allowUnknownOption(true);
+
+  // spaps quickstart
+  const cmdQuick = program
+    .command('quickstart')
+    .description('Get quick start instructions (for AI agents)')
+    .option('-p, --port <port>', 'Port to check', String(DEFAULT_PORT))
+    .option('--json', 'Output in JSON format')
+    .action(makeAction('quickstart', (opts, _cmd, isJson) => ({ port: Number(opts.port), json: isJson })));
+  if (dryRun) cmdQuick.allowUnknownOption(true);
+
+  // spaps status
+  const cmdStatus = program
+    .command('status')
+    .description('Check if SPAPS server is running')
+    .option('-p, --port <port>', 'Port to check', String(DEFAULT_PORT))
+    .option('--json', 'Output in JSON format')
+    .action(makeAction('status', (opts, _cmd, isJson) => ({ port: Number(opts.port), json: isJson })));
+  if (dryRun) cmdStatus.allowUnknownOption(true);
+
+  // spaps init
+  const cmdInit = program
+    .command('init')
+    .description('Initialize SPAPS in current project')
+    .option('--json', 'Output in JSON format')
+    .action(makeAction('init', (_opts, _cmd, isJson) => ({ json: isJson })));
+  if (dryRun) cmdInit.allowUnknownOption(true);
+
+  // spaps create <name>
+  const cmdCreate = program
+    .command('create <name>')
+    .description('Create a new project with SPAPS (coming soon)')
+    .action(makeAction('create', (optsOrName, cmd) => ({ name: typeof optsOrName === 'string' ? optsOrName : cmd.args[0] })));
+  if (dryRun) cmdCreate.allowUnknownOption(true);
+
+  // spaps types
+  const cmdTypes = program
+    .command('types')
+    .description('Generate TypeScript types (coming soon)')
+    .action(makeAction('types', () => ({})));
+  if (dryRun) cmdTypes.allowUnknownOption(true);
+
+  // spaps help
+  const cmdHelp = program
+    .command('help')
+    .description('Show help and guides')
+    .option('-i, --interactive', 'Interactive help mode')
+    .option('-q, --quick', 'Quick reference')
+    .action(
+      makeAction('help', (opts) => ({ interactive: Boolean(opts.interactive), quick: Boolean(opts.quick) }))
+    );
+  if (dryRun) cmdHelp.allowUnknownOption(true);
+
+  // spaps docs
+  const cmdDocs = program
+    .command('docs')
+    .description('Browse SDK documentation')
+    .option('-i, --interactive', 'Interactive documentation browser')
+    .option('-s, --search <query>', 'Search documentation')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('docs', (opts, _cmd, isJson) => ({ interactive: Boolean(opts.interactive), search: opts.search || null, json: isJson }))
+    );
+  if (dryRun) cmdDocs.allowUnknownOption(true);
+
+  return { program, getIntents: () => intents };
+}
+
+function buildProgram(config = {}) {
+  return defineProgram(config).program;
+}
+
+function parseArgv(argv, config = {}) {
+  const { program, getIntents } = defineProgram({ ...config, dryRun: true });
+  program.exitOverride(() => { /* swallow exit in dry-run */ });
+  try {
+    program.parse(argv, { from: 'user' });
+  } catch (err) {
+    // Commander throws for help/version; we ignore in parse mode
+  }
+  return getIntents();
+}
+
+module.exports = { buildProgram, parseArgv };

package/src/config.js

@@ -0,0 +1,5 @@
+// Shared configuration for SPAPS CLI
+module.exports = {
+  DEFAULT_PORT: 3300
+};
+