quapp 1.0.5 → 1.1.2

package/README.md

@@ -1,29 +1,194 @@
-# Quapp CLI 🧪
-
-**Quapp CLI** is a developer-friendly CLI tool to serve and Build quapps in a quick and Easy manner
-
----
-
-## 🚀 Features
-
-- ⚡ Create Quapp's Quickly and Efficently
-- 📱 Serve locally and share via LAN QR code  
-- 📁 Lightweight and extensible project setup  
-
----
-
-## 📦 Installation
-
-```bash
-npm install quapp
-
-```
-## 🔧 Usage
-
-```bash
-    quapp serve
-
-    quapp build
-
-    quapp
-```
+# quapp
+
+Development CLI for Quapp projects - start a dev server with LAN QR code and build `.qpp` packages.
+
+## Installation
+
+```bash
+npm install -D quapp
+```
+
+## Commands
+
+### `quapp init`
+
+Initialize Quapp in an existing project. Creates config and adds scripts.
+
+```bash
+quapp init [options]
+```
+
+**Options:**
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--yes` | `-y` | Skip confirmation prompt |
+| `--force` | `-f` | Overwrite existing config/scripts |
+| `--dry-run` | | Preview changes without applying |
+
+### `quapp serve`
+
+Start development server with LAN access and QR code for mobile testing.
+
+```bash
+quapp serve [options]
+```
+
+**Options:**
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--port <port>` | `-p` | Port to run on (default: 5173) |
+| `--host <host>` | | Host to bind to |
+| `--open` | | Open browser automatically |
+| `--no-qr` | | Disable QR code display |
+| `--https` | | Enable HTTPS |
+
+### `quapp build`
+
+Build for production and create `.qpp` package.
+
+```bash
+quapp build [options]
+```
+
+**Options:**
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--output <file>` | `-o` | Output filename (default: dist.qpp) |
+| `--no-clean` | | Keep dist folder after build |
+| `--skip-prompts` | | Skip interactive prompts |
+
+## Global Options
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--json` | | Output as JSON (for automation/AI) |
+| `--no-color` | | Disable colored output |
+| `--verbose` | | Show detailed logs |
+| `--version` | `-v` | Show version |
+| `--help` | `-h` | Show help |
+
+## Configuration
+
+Create `quapp.config.json` in your project root:
+
+```json
+{
+  "server": {
+    "port": 5173,
+    "qr": true,
+    "network": "private",
+    "openBrowser": false,
+    "https": false,
+    "fallbackPort": true,
+    "autoRetry": true,
+    "strictPort": false
+  },
+  "build": {
+    "outDir": "dist",
+    "outputFile": "dist.qpp"
+  }
+}
+```
+
+## Examples
+
+```bash
+# Initialize Quapp in existing project
+quapp init
+
+# Initialize without prompts (AI-friendly)
+quapp init --yes --json
+
+# Start dev server
+quapp serve
+
+# Start on specific port
+quapp serve -p 3000
+
+# Start and open browser
+quapp serve --open
+
+# Build for production
+quapp build
+
+# Build with custom output name
+quapp build -o my-app.qpp
+
+# Build with JSON output (AI-friendly)
+quapp build --json --skip-prompts
+```
+
+## AI/Automation Usage
+
+For non-interactive environments:
+
+```bash
+# Initialize without prompts
+quapp init --yes --json
+
+# Preview init changes
+quapp init --dry-run --json
+
+# Build without prompts
+quapp build --skip-prompts --json
+
+# Build with custom output
+quapp build -o myapp.qpp --skip-prompts --json
+```
+
+### JSON Output Examples
+
+Init success:
+```json
+{
+  "success": true,
+  "changes": ["quapp.config.json", "script:dev", "script:qbuild", "devDependency:quapp"],
+  "nextSteps": ["npm install", "npm run dev"]
+}
+```
+
+Build success:
+```json
+{
+  "success": true,
+  "outputFile": "dist.qpp",
+  "outputPath": "/path/to/project/dist.qpp",
+  "manifest": {
+    "package_name": "com.author.myapp",
+    "version": "1.0.0",
+    "version_code": 10000
+  },
+  "duration": 5230
+}
+```
+
+Error (with suggestion for AI):
+```json
+{
+  "success": false,
+  "errorCode": "NO_BUILD_SCRIPT",
+  "error": "No build script",
+  "suggestion": "Add to package.json: \"scripts\": { \"build\": \"vite build\" }"
+}
+```
+
+## Exit Codes
+
+| Code | Description |
+|------|-------------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Build failed |
+| 4 | Configuration error |
+| 5 | Missing dependency |
+| 130 | User cancelled |
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Vite (in your project's dependencies)
+
+## License
+
+MIT

package/bin/cli.js

@@ -1,48 +1,134 @@
-#!/usr/bin/env node
-
-import { spawn } from "child_process";
-import path from "path";
-import { fileURLToPath } from "url";
-
-// Resolve __dirname in ESM
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Get user command
-const args = process.argv.slice(2);
-const command = args[0];
-
-// Path to files inside your package
-const buildPath = path.join(__dirname, "../build.js");
-const servePath = path.join(__dirname, "../server.js");
-
-// Helper to run a file with Node
-function runScript(scriptPath) {
-  const child = spawn("node", [scriptPath], { stdio: "inherit" });
-  child.on("close", (code) => process.exit(code));
-}
-
-switch (command) {
-  case "build":
-    runScript(buildPath);
-    break;
-  case "serve":
-    runScript(servePath);
-    break;
-  default:
-    console.log(`
-\x1b[1m\x1b[34mQuapp CLI\x1b[0m
-
-Usage:
-  quapp build       Run production build and compress to dist.quapp
-  quapp serve       Start local server for testing your app
-
-Options:
-  -h, --help        Show this help message
-
-Examples:
-  quapp build
-  quapp serve
-`);
-    break;
-}
+#!/usr/bin/env node
+
+/**
+ * quapp CLI - Development and build tools for Quapp projects
+ * 
+ * Commands:
+ *   quapp serve  - Start development server with LAN access
+ *   quapp build  - Build for production and create .qpp package
+ */
+
+import { parseArgs, getHelpText, getVersion } from '../lib/args.js';
+import { initColors } from '../lib/colors.js';
+import * as logger from '../lib/logger.js';
+import { EXIT_CODES } from '../lib/constants.js';
+import { runServe } from '../commands/serve.js';
+import { runBuild } from '../commands/build.js';
+import { runInit } from '../commands/init.js';
+
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+
+async function main() {
+  // Parse arguments
+  const args = parseArgs(process.argv.slice(2));
+
+  // Handle --help
+  if (args.help) {
+    console.log(getHelpText());
+    process.exit(EXIT_CODES.SUCCESS);
+  }
+
+  // Handle --version
+  if (args.version) {
+    console.log(getVersion());
+    process.exit(EXIT_CODES.SUCCESS);
+  }
+
+  // Initialize colors
+  initColors(args.noColor);
+
+  // Initialize logger
+  logger.initLogger({ json: args.json, verbose: args.verbose });
+
+  // Check for argument errors
+  if (args.errors.length > 0) {
+    for (const err of args.errors) {
+      logger.error(err);
+    }
+    if (args.json) {
+      logger.outputJson({ success: false, errors: args.errors });
+    }
+    process.exit(EXIT_CODES.INVALID_ARGS);
+  }
+
+  // Handle missing command
+  if (!args.command) {
+    console.log(getHelpText());
+    process.exit(EXIT_CODES.SUCCESS);
+  }
+
+  // Route to command
+  let result;
+
+  switch (args.command) {
+    case 'serve':
+      result = await runServe({
+        port: args.port,
+        host: args.host,
+        qr: args.qr,
+        open: args.open,
+        https: args.https,
+        extra: args.extra,
+        _attempt: 0,
+      });
+      break;
+
+    case 'build':
+      result = await runBuild({
+        output: args.output,
+        clean: args.clean,
+        skipPrompts: args.skipPrompts,
+      });
+      break;
+
+    case 'init':
+      result = await runInit({
+        force: args.force,
+        yes: args.yes,
+        dryRun: args.dryRun,
+        skipPrompts: args.skipPrompts,
+      });
+      break;
+
+    default:
+      logger.error(`Unknown command: ${args.command}`);
+      logger.info('Run "quapp --help" for available commands');
+      
+      if (args.json) {
+        logger.outputJson({ success: false, error: `Unknown command: ${args.command}` });
+      }
+      process.exit(EXIT_CODES.INVALID_ARGS);
+  }
+
+  // Output JSON result if requested
+  if (args.json && result) {
+    logger.outputJson(result);
+  }
+
+  // Exit with appropriate code
+  process.exit(result?.success ? EXIT_CODES.SUCCESS : (result?.exitCode || EXIT_CODES.GENERAL_ERROR));
+}
+
+// ============================================================================
+// Run
+// ============================================================================
+
+main().catch((err) => {
+  console.error(`\x1b[31m✖ Unexpected error: ${err.message}\x1b[0m`);
+  
+  if (process.argv.includes('--verbose')) {
+    console.error(err.stack);
+  }
+  
+  if (process.argv.includes('--json')) {
+    console.log(JSON.stringify({
+      success: false,
+      error: err.message,
+      stack: process.argv.includes('--verbose') ? err.stack : undefined,
+    }, null, 2));
+  }
+  
+  process.exit(EXIT_CODES.GENERAL_ERROR);
+});

package/commands/build.js

@@ -0,0 +1,267 @@
+/**
+ * Build command - Create production .qpp package
+ */
+
+import fs from 'fs';
+import { rm } from 'fs/promises';
+import path from 'path';
+import { execSync } from 'child_process';
+import archiver from 'archiver';
+import prompts from 'prompts';
+import * as logger from '../lib/logger.js';
+import { loadConfig, loadPackageJson, updatePackageJson, hasBuildScript } from '../lib/config.js';
+import { generateManifest, writeManifest } from '../lib/manifest.js';
+import { EXIT_CODES } from '../lib/constants.js';
+
+/**
+ * Prompt for missing package.json fields
+ * @param {Object} pkg - Current package.json
+ * @param {string[]} missing - List of missing fields
+ * @returns {Promise<Object>} Updated values
+ */
+async function promptMissingFields(pkg, missing) {
+  const questions = [];
+
+  if (missing.includes('name')) {
+    questions.push({
+      type: 'text',
+      name: 'name',
+      message: 'Enter project name:',
+      validate: (x) => x.trim() !== '' ? true : 'Name is required',
+    });
+  }
+
+  if (missing.includes('version')) {
+    questions.push({
+      type: 'text',
+      name: 'version',
+      message: 'Enter version (e.g., 1.0.0):',
+      initial: '1.0.0',
+      validate: (x) => x.trim() !== '' ? true : 'Version is required',
+    });
+  }
+
+  // Always ask for author if not present
+  if (!pkg.author) {
+    questions.push({
+      type: 'text',
+      name: 'author',
+      message: 'Enter author name:',
+      validate: (x) => x.trim() !== '' ? true : 'Author is required',
+    });
+  }
+
+  if (questions.length === 0) {
+    return {};
+  }
+
+  return await prompts(questions);
+}
+
+/**
+ * Compress directory to .qpp file
+ * @param {string} sourceDir - Directory to compress
+ * @param {string} outputPath - Output file path
+ * @returns {Promise<Object>} Result with file size
+ */
+async function compressToQpp(sourceDir, outputPath) {
+  return new Promise((resolve, reject) => {
+    const output = fs.createWriteStream(outputPath);
+    const archive = archiver('zip', { zlib: { level: 9 } });
+
+    output.on('close', () => {
+      resolve({
+        success: true,
+        size: archive.pointer(),
+        path: outputPath,
+      });
+    });
+
+    archive.on('error', (err) => {
+      reject(err);
+    });
+
+    archive.pipe(output);
+    archive.directory(sourceDir, false);
+    archive.finalize();
+  });
+}
+
+/**
+ * Format bytes to human readable string
+ * @param {number} bytes
+ * @returns {string}
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+
+/**
+ * Run the build command
+ * @param {Object} options - Command options
+ * @returns {Promise<Object>} Result
+ */
+export async function runBuild(options = {}) {
+  const cwd = process.cwd();
+  const startTime = Date.now();
+
+  // Load config
+  const { config, configError } = loadConfig(cwd);
+  
+  if (configError) {
+    logger.warn(configError);
+  }
+
+  // Load package.json
+  const pkgResult = loadPackageJson(cwd);
+  
+  if (!pkgResult.success) {
+    logger.error(pkgResult.error);
+    return { 
+      success: false, 
+      errorCode: 'PACKAGE_JSON_ERROR',
+      error: pkgResult.error, 
+      suggestion: 'Make sure you are in a Quapp project directory',
+      exitCode: EXIT_CODES.CONFIG_ERROR 
+    };
+  }
+
+  let pkg = pkgResult.package;
+
+  // Handle missing fields
+  if (pkgResult.missingFields.length > 0 || !pkg.author) {
+    if (options.skipPrompts) {
+      // In non-interactive mode, use defaults for missing fields
+      const updates = {};
+      
+      if (pkgResult.missingFields.includes('name')) {
+        logger.error('Missing required field: name');
+        return { success: false, error: 'Missing name in package.json', exitCode: EXIT_CODES.CONFIG_ERROR };
+      }
+      
+      if (pkgResult.missingFields.includes('version')) {
+        updates.version = '1.0.0';
+        logger.warn('No version specified, using 1.0.0');
+      }
+      
+      if (!pkg.author) {
+        updates.author = 'developer';
+        logger.warn('No author specified, using "developer"');
+      }
+      
+      if (Object.keys(updates).length > 0) {
+        const updateResult = updatePackageJson(cwd, updates);
+        if (updateResult.success) {
+          pkg = updateResult.package;
+        }
+      }
+    } else {
+      // Interactive mode - prompt for missing fields
+      const answers = await promptMissingFields(pkg, pkgResult.missingFields);
+      
+      if (Object.keys(answers).length > 0) {
+        const updateResult = updatePackageJson(cwd, answers);
+        if (!updateResult.success) {
+          logger.error(updateResult.error);
+          return { success: false, error: updateResult.error, exitCode: EXIT_CODES.CONFIG_ERROR };
+        }
+        pkg = updateResult.package;
+        logger.success('Updated package.json');
+      }
+    }
+  }
+
+  // Check for build script
+  if (!hasBuildScript(pkg)) {
+    logger.error('No "build" script found in package.json');
+    logger.info('Add a build script to your package.json, e.g.: "build": "vite build"');
+    return { 
+      success: false, 
+      errorCode: 'NO_BUILD_SCRIPT',
+      error: 'No build script', 
+      suggestion: 'Add to package.json: "scripts": { "build": "vite build" }',
+      exitCode: EXIT_CODES.CONFIG_ERROR 
+    };
+  }
+
+  // Paths
+  const distDir = path.join(cwd, config.build.outDir);
+  let outputFile = options.output || config.build.outputFile;
+  // Ensure .qpp extension
+  if (!outputFile.endsWith('.qpp')) {
+    outputFile = `${outputFile}.qpp`;
+  }
+  const outputPath = path.join(cwd, outputFile);
+
+  // Step 1: Run build
+  logger.step('📦', 'Building for production...');
+  
+  try {
+    execSync('npm run build', { 
+      cwd, 
+      stdio: logger.isJsonMode() ? 'pipe' : 'inherit' 
+    });
+    logger.success('Build completed');
+  } catch (err) {
+    logger.error('Build failed');
+    return { success: false, error: 'Build failed', exitCode: EXIT_CODES.BUILD_FAILED };
+  }
+
+  // Step 2: Verify dist folder exists
+  if (!fs.existsSync(distDir)) {
+    logger.error(`Build output directory "${config.build.outDir}" not found`);
+    logger.info('Make sure your build script outputs to the correct directory');
+    return { success: false, error: 'Build output not found', exitCode: EXIT_CODES.BUILD_FAILED };
+  }
+
+  // Step 3: Generate and write manifest
+  logger.step('📋', 'Generating manifest...');
+  
+  const manifest = generateManifest(pkg);
+  const manifestResult = writeManifest(distDir, manifest);
+  
+  if (!manifestResult.success) {
+    logger.error(manifestResult.error);
+    return { success: false, error: manifestResult.error, exitCode: EXIT_CODES.GENERAL_ERROR };
+  }
+  
+  logger.success('Manifest created');
+  logger.debug(`Package: ${manifest.package_name}`);
+  logger.debug(`Version: ${manifest.version} (code: ${manifest.version_code})`);
+
+  // Step 4: Compress to .qpp
+  logger.step('🗜️', `Compressing to ${outputFile}...`);
+  
+  try {
+    const compressResult = await compressToQpp(distDir, outputPath);
+    logger.success(`Created ${outputFile} (${formatSize(compressResult.size)})`);
+  } catch (err) {
+    logger.error(`Failed to create ${outputFile}: ${err.message}`);
+    return { success: false, error: 'Compression failed', exitCode: EXIT_CODES.GENERAL_ERROR };
+  }
+
+  // Step 5: Clean up dist folder
+  if (options.clean !== false) {
+    try {
+      await rm(distDir, { recursive: true, force: true });
+      logger.debug('Cleaned up dist folder');
+    } catch (err) {
+      logger.warn(`Could not remove dist folder: ${err.message}`);
+    }
+  }
+
+  // Done
+  const duration = Date.now() - startTime;
+  logger.newline();
+  logger.success(`Build complete in ${(duration / 1000).toFixed(1)}s`);
+
+  return {
+    success: true,
+    outputFile,
+    outputPath,
+    manifest,
+    duration,
+  };
+}