launchpd 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Launchpd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# Launchpd
+
+Deploy static sites instantly to a live URL. No config, no complexity.
+
+## Quick Start
+
+```bash
+npm install -g launchpd
+launchpd deploy ./my-site
+```
+
+## Installation
+
+```bash
+npm install -g launchpd
+```
+
+Requires Node.js 20 or higher.
+
+## Usage
+
+### Deploy a folder
+
+```bash
+launchpd deploy ./my-folder
+```
+
+### Use a custom subdomain
+
+```bash
+launchpd deploy ./my-folder --name my-project
+```
+
+### Set expiration time
+
+```bash
+launchpd deploy ./my-folder --expires 2h
+# Auto-deletes after 2 hours
+```
+
+
+
+### List your deployments
+
+```bash
+launchpd list
+```
+
+### View version history
+
+```bash
+launchpd versions my-subdomain
+```
+
+### Rollback to previous version
+
+```bash
+launchpd rollback my-subdomain
+launchpd rollback my-subdomain --to 2
+```
+
+## Authentication
+
+### Register for a free account
+
+```bash
+launchpd register
+```
+
+### Login with your API key
+
+```bash
+launchpd login
+```
+
+### Check current user and quota
+
+```bash
+launchpd whoami
+launchpd quota
+```
+
+### Logout
+
+```bash
+launchpd logout
+```
+
+## Support
+
+- [Report issues](https://github.com/kents00/launchpd/issues)
+- [Documentation](https://launchpd.cloud/docs)
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { deploy } from '../src/commands/deploy.js';
+import { list } from '../src/commands/list.js';
+import { rollback } from '../src/commands/rollback.js';
+import { versions } from '../src/commands/versions.js';
+import { login, logout, register, whoami, quota } from '../src/commands/auth.js';
+
+const program = new Command();
+
+program
+    .name('launchpd')
+    .description('Deploy static sites instantly to a live URL')
+    .version('0.1.12');
+
+program
+    .command('deploy')
+    .description('Deploy a folder to a live URL')
+    .argument('<folder>', 'Path to the folder to deploy')
+    .option('--name <subdomain>', 'Use a custom subdomain (optional)')
+    .option('--expires <time>', 'Auto-delete after time (e.g., 30m, 2h, 1d). Minimum: 30m')
+    .option('--verbose', 'Show detailed error information')
+    .action(async (folder, options) => {
+        await deploy(folder, options);
+    });
+
+program
+    .command('list')
+    .description('List your past deployments')
+    .option('--json', 'Output as JSON')
+    .option('--local', 'Only show local deployments')
+    .option('--verbose', 'Show detailed error information')
+    .action(async (options) => {
+        await list(options);
+    });
+
+program
+    .command('versions')
+    .description('List all versions for a subdomain')
+    .argument('<subdomain>', 'The subdomain to list versions for')
+    .option('--json', 'Output as JSON')
+    .option('--verbose', 'Show detailed error information')
+    .action(async (subdomain, options) => {
+        await versions(subdomain, options);
+    });
+
+program
+    .command('rollback')
+    .description('Rollback a subdomain to a previous version')
+    .argument('<subdomain>', 'The subdomain to rollback')
+    .option('--to <n>', 'Specific version number to rollback to')
+    .option('--verbose', 'Show detailed error information')
+    .action(async (subdomain, options) => {
+        await rollback(subdomain, options);
+    });
+
+// Authentication commands
+program
+    .command('login')
+    .description('Login with your API key')
+    .action(async () => {
+        await login();
+    });
+
+program
+    .command('logout')
+    .description('Clear stored credentials')
+    .action(async () => {
+        await logout();
+    });
+
+program
+    .command('register')
+    .description('Open browser to create a new account')
+    .action(async () => {
+        await register();
+    });
+
+program
+    .command('whoami')
+    .description('Show current user info and quota status')
+    .action(async () => {
+        await whoami();
+    });
+
+program
+    .command('quota')
+    .description('Check current quota and usage')
+    .action(async () => {
+        await quota();
+    });
+
+program.parseAsync();

package/bin/setup.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+import { config } from '../src/config.js';
+import { info, success } from '../src/utils/logger.js';
+import chalk from 'chalk';
+
+/**
+ * Setup script to display CLI information
+ */
+async function setup() {
+    console.log('\n' + chalk.bold.blue('═══════════════════════════════════════'));
+    console.log(chalk.bold.blue('  Launchpd CLI'));
+    console.log(chalk.bold.blue('═══════════════════════════════════════\n'));
+
+    info('Launchpd is ready to use!\n');
+
+    console.log(chalk.bold('Configuration:'));
+    console.log(chalk.gray('─'.repeat(50)));
+    console.log(chalk.cyan('  Domain:        '), config.domain);
+    console.log(chalk.cyan('  API:           '), config.apiUrl);
+    console.log(chalk.cyan('  Version:       '), config.version);
+    console.log(chalk.gray('─'.repeat(50)) + '\n');
+
+    console.log(chalk.bold('Quick Start:'));
+    console.log(chalk.gray('  Deploy your first site:'));
+    console.log(chalk.cyan('     launchpd deploy ./your-folder\n'));
+
+    console.log(chalk.gray('  Login for more quota:'));
+    console.log(chalk.cyan('     launchpd login\n'));
+
+    console.log(chalk.gray('  List your deployments:'));
+    console.log(chalk.cyan('     launchpd list\n'));
+
+    success('No configuration needed - just deploy!');
+}
+
+setup().catch(err => {
+    console.error(`Setup failed: ${err.message}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,67 @@
+{
+    "name": "launchpd",
+    "version": "1.0.0",
+    "description": "Deploy static sites instantly to a live URL",
+    "keywords": [
+        "static",
+        "hosting",
+        "deploy",
+        "cli",
+        "cdn",
+        "website",
+        "publish"
+    ],
+    "homepage": "https://launchpd.cloud",
+    "bugs": {
+        "url": "https://github.com/kents00/launchpd/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/kents00/launchpd.git",
+        "directory": "cli"
+    },
+    "license": "MIT",
+    "author": "Kent John Edoloverio",
+    "type": "module",
+    "exports": {
+        ".": "./src/commands/index.js",
+        "./utils": "./src/utils/index.js"
+    },
+    "main": "./src/commands/index.js",
+    "bin": {
+        "launchpd": "bin/cli.js"
+    },
+    "directories": {
+        "test": "tests"
+    },
+    "files": [
+        "bin",
+        "src"
+    ],
+    "scripts": {
+        "start": "node bin/cli.js",
+        "dev": "node bin/cli.js deploy ../examples/test-site",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "lint": "eslint src bin --ext .js",
+        "lint:fix": "eslint src bin --ext .js --fix",
+        "prepublishOnly": "npm run lint && npm run test"
+    },
+    "dependencies": {
+        "chalk": "^5.4.0",
+        "commander": "^14.0.0",
+        "mime-types": "^2.1.35",
+        "nanoid": "^5.1.0",
+        "ora": "^8.0.1"
+    },
+    "devDependencies": {
+        "@eslint/js": "^9.39.2",
+        "@vitest/coverage-v8": "^2.1.0",
+        "eslint": "^9.0.0",
+        "vitest": "^2.1.0"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    }
+}

package/src/commands/auth.js

@@ -0,0 +1,357 @@
+/**
+ * Authentication commands for StaticLaunch CLI
+ * login, logout, register, whoami
+ */
+
+import { exec } from 'node:child_process';
+import { promptSecret } from '../utils/prompt.js';
+import { config } from '../config.js';
+import { getCredentials, saveCredentials, clearCredentials, isLoggedIn } from '../utils/credentials.js';
+import { success, error, errorWithSuggestions, info, warning, spinner } from '../utils/logger.js';
+import { formatBytes } from '../utils/quota.js';
+import chalk from 'chalk';
+
+const API_BASE_URL = config.apiUrl;
+const REGISTER_URL = `https://${config.domain}/`;
+
+
+/**
+ * Validate API key with the server
+ */
+async function validateApiKey(apiKey) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/api/quota`, {
+            headers: {
+                'X-API-Key': apiKey,
+            },
+        });
+
+        if (!response.ok) {
+            return null;
+        }
+
+        const data = await response.json();
+        if (data.authenticated) {
+            return data;
+        }
+        return null;
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * Background update credentials if new data (like apiSecret) is available
+ */
+async function updateCredentialsIfNeeded(creds, result) {
+    if (result.user?.api_secret && !creds.apiSecret) {
+        await saveCredentials({
+            ...creds,
+            apiSecret: result.user.api_secret,
+            userId: result.user.id || creds.userId,
+            email: result.user.email || creds.email,
+        });
+    }
+}
+
+/**
+ * Login command - prompts for API key and validates it
+ */
+export async function login() {
+    // Check if already logged in
+    if (await isLoggedIn()) {
+        const creds = await getCredentials();
+        warning(`Already logged in as ${chalk.cyan(creds.email || creds.userId)}`);
+        info('Run "launchpd logout" to switch accounts');
+        return;
+    }
+
+    console.log('\nLaunchpd Login\n');
+    console.log('Enter your API key from the dashboard.');
+    console.log(`Don't have one? Run ${chalk.cyan('"launchpd register"')} first.\n`);
+
+    const apiKey = await promptSecret('API Key: ');
+
+    if (!apiKey) {
+        errorWithSuggestions('API key is required', [
+            'Get your API key from the dashboard',
+            `Visit: https://${config.domain}/settings`,
+            'Run "launchpd register" if you don\'t have an account',
+        ]);
+        process.exit(1);
+    }
+
+    const validateSpinner = spinner('Validating API key...');
+
+    const result = await validateApiKey(apiKey);
+
+    if (!result) {
+        validateSpinner.fail('Invalid API key');
+        errorWithSuggestions('Please check and try again.', [
+            `Get your API key at: https://portal.${config.domain}/api-keys`,
+            'Make sure you copied the full key',
+            'API keys start with "lpd_"',
+        ]);
+        process.exit(1);
+    }
+
+    // Save credentials
+    await saveCredentials({
+        apiKey,
+        apiSecret: result.user?.api_secret,
+        userId: result.user?.id,
+        email: result.user?.email,
+        tier: result.tier,
+    });
+
+    validateSpinner.succeed('Logged in successfully!');
+    console.log('');
+    console.log(`  ${chalk.gray('Email:')} ${chalk.cyan(result.user?.email || 'N/A')}`);
+    console.log(`  ${chalk.gray('Tier:')} ${chalk.green(result.tier)}`);
+    console.log(`  ${chalk.gray('Sites:')} ${result.usage?.siteCount || 0}/${result.limits?.maxSites || '?'}`);
+    console.log(`  ${chalk.gray('Storage:')} ${result.usage?.storageUsedMB || 0}MB/${result.limits?.maxStorageMB || '?'}MB`);
+    console.log('');
+}
+
+/**
+ * Logout command - clears stored credentials
+ */
+export async function logout() {
+    const loggedIn = await isLoggedIn();
+
+    if (!loggedIn) {
+        warning('Not currently logged in');
+        return;
+    }
+
+    const creds = await getCredentials();
+    await clearCredentials();
+
+    success('Logged out successfully');
+    if (creds?.email) {
+        info(`Was logged in as: ${chalk.cyan(creds.email)}`);
+    }
+    console.log(`\nYou can still deploy anonymously (limited to ${chalk.yellow('3 sites')}, ${chalk.yellow('50MB')}).`);
+}
+
+/**
+ * Register command - opens browser to registration page
+ */
+export async function register() {
+    console.log('\nRegister for Launchpd\n');
+    console.log(`Opening registration page: ${chalk.cyan(REGISTER_URL)}\n`);
+
+    // Open browser based on platform
+    const platform = process.platform;
+    let cmd;
+
+    if (platform === 'darwin') {
+        cmd = `open "${REGISTER_URL}"`;
+    } else if (platform === 'win32') {
+        cmd = `start "" "${REGISTER_URL}"`;
+    } else {
+        cmd = `xdg-open "${REGISTER_URL}"`;
+    }
+
+    exec(cmd, (err) => {
+        if (err) {
+            console.log(`Please open this URL in your browser:\n  ${chalk.cyan(REGISTER_URL)}\n`);
+        }
+    });
+
+    console.log('After registering:');
+    console.log(`  1. Get your API key from the dashboard`);
+    console.log(`  2. Run: ${chalk.cyan('launchpd login')}`);
+    console.log('');
+
+    info('Registration benefits:');
+    console.log(`  ${chalk.green('✓')} ${chalk.white('10 sites')} ${chalk.gray('(instead of 3)')}`);
+    console.log(`  ${chalk.green('✓')} ${chalk.white('100MB storage')} ${chalk.gray('(instead of 50MB)')}`);
+    console.log(`  ${chalk.green('✓')} ${chalk.white('30-day retention')} ${chalk.gray('(instead of 7 days)')}`);
+    console.log(`  ${chalk.green('✓')} ${chalk.white('10 versions per site')}`);
+    console.log('');
+}
+
+/**
+ * Whoami command - shows current user info and quota status
+ */
+export async function whoami() {
+    const creds = await getCredentials();
+
+    if (!creds) {
+        console.log('\n👤 Not logged in (anonymous mode)\n');
+        console.log('Anonymous limits:');
+        console.log(`  • ${chalk.white('3 sites')} maximum`);
+        console.log(`  • ${chalk.white('50MB')} total storage`);
+        console.log(`  • ${chalk.white('7-day')} retention`);
+        console.log(`  • ${chalk.white('1 version')} per site`);
+        console.log(`\nRun ${chalk.cyan('"launchpd login"')} to authenticate`);
+        console.log(`Run ${chalk.cyan('"launchpd register"')} to create an account\n`);
+        return;
+    }
+
+    info('Fetching account status...');
+
+    // Validate and get current quota
+    const result = await validateApiKey(creds.apiKey);
+
+    if (!result) {
+        warning('Session expired or API key invalid');
+        await clearCredentials();
+        error('Please login again with: launchpd login');
+        process.exit(1);
+    }
+
+    // Background upgrade to apiSecret if missing
+    await updateCredentialsIfNeeded(creds, result);
+
+    console.log(`\nLogged in as: ${result.user?.email || result.user?.id}\n`);
+
+    console.log('Account Info:');
+    console.log(`  User ID: ${result.user?.id}`);
+    console.log(`  Email: ${result.user?.email || 'Not set'} ${result.user?.email_verified ? chalk.green('(Verified)') : chalk.yellow('(Unverified)')}`);
+    console.log(`  2FA: ${result.user?.is_2fa_enabled ? chalk.green('Enabled') : chalk.gray('Disabled')}`);
+    console.log(`  Tier: ${result.tier}`);
+    console.log('');
+
+    console.log('Usage:');
+    console.log(`  Sites: ${result.usage?.siteCount || 0} / ${result.limits?.maxSites}`);
+    console.log(`  Storage: ${result.usage?.storageUsedMB || 0}MB / ${result.limits?.maxStorageMB}MB`);
+    console.log(`  Sites remaining: ${result.usage?.sitesRemaining || 0}`);
+    console.log(`  Storage remaining: ${result.usage?.storageRemainingMB || 0}MB`);
+    console.log('');
+
+    console.log('Limits:');
+    console.log(`  Max versions per site: ${result.limits?.maxVersionsPerSite}`);
+    console.log(`  Retention: ${result.limits?.retentionDays} days`);
+    console.log('');
+
+    // Show warnings
+    if (result.warnings && result.warnings.length > 0) {
+        console.log('⚠️ Warnings:');
+        result.warnings.forEach(w => console.log(`  ${w}`));
+        console.log('');
+    }
+
+    if (!result.canCreateNewSite) {
+        warning('You cannot create new sites (limit reached)');
+        info('You can still update existing sites');
+    }
+}
+
+/**
+ * Quota command - shows detailed quota information
+ */
+export async function quota() {
+    const creds = await getCredentials();
+
+    if (!creds) {
+        console.log(`\n${chalk.bold('Anonymous Quota Status')}\n`);
+        console.log(chalk.gray('You are not logged in.'));
+        console.log('');
+        console.log(chalk.bold('Anonymous tier limits:'));
+        console.log(chalk.gray('  ┌─────────────────────────────────┐'));
+        console.log(chalk.gray('  │') + ` Sites:      ${chalk.white('3 maximum')}           ` + chalk.gray('│'));
+        console.log(chalk.gray('  │') + ` Storage:    ${chalk.white('50MB total')}          ` + chalk.gray('│'));
+        console.log(chalk.gray('  │') + ` Retention:  ${chalk.white('7 days')}              ` + chalk.gray('│'));
+        console.log(chalk.gray('  │') + ` Versions:   ${chalk.white('1 per site')}          ` + chalk.gray('│'));
+        console.log(chalk.gray('  └─────────────────────────────────┘'));
+        console.log('');
+        console.log(`${chalk.cyan('Register for FREE')} to unlock more:`);
+        console.log(`   ${chalk.green('→')} ${chalk.white('10 sites')}`);
+        console.log(`   ${chalk.green('→')} ${chalk.white('100MB storage')}`);
+        console.log(`   ${chalk.green('→')} ${chalk.white('30-day retention')}`);
+        console.log(`   ${chalk.green('→')} ${chalk.white('10 versions per site')}`);
+        console.log('');
+        console.log(`Run: ${chalk.cyan('launchpd register')}`);
+        console.log('');
+        return;
+    }
+
+    const fetchSpinner = spinner('Fetching quota status...');
+
+    const result = await validateApiKey(creds.apiKey);
+
+    if (!result) {
+        fetchSpinner.fail('Failed to fetch quota');
+        errorWithSuggestions('API key may be invalid.', [
+            'Run "launchpd login" to re-authenticate',
+            'Check your internet connection',
+        ]);
+        process.exit(1);
+    }
+
+    // Background upgrade to apiSecret if missing
+    await updateCredentialsIfNeeded(creds, result);
+
+    fetchSpinner.succeed('Quota fetched');
+    console.log(`\n${chalk.bold('Quota Status for:')} ${chalk.cyan(result.user?.email || creds.email)}\n`);
+
+    // Sites usage
+    const sitesUsed = result.usage?.siteCount || 0;
+    const sitesMax = result.limits?.maxSites || 10;
+    const sitesPercent = Math.round((sitesUsed / sitesMax) * 100);
+    const sitesBar = createProgressBar(sitesUsed, sitesMax);
+
+    console.log(`${chalk.gray('Sites:')}    ${sitesBar} ${chalk.white(sitesUsed)}/${sitesMax} (${getPercentColor(sitesPercent)})`);
+
+    // Storage usage
+    const storageBytes = result.usage?.storageUsed || 0;
+    const storageMaxBytes = result.limits?.maxStorageBytes || (result.limits?.maxStorageMB || 100) * 1024 * 1024;
+    const storagePercent = Math.round((storageBytes / storageMaxBytes) * 100);
+    const storageBar = createProgressBar(storageBytes, storageMaxBytes);
+
+    console.log(`${chalk.gray('Storage:')}  ${storageBar} ${chalk.white(formatBytes(storageBytes))}/${formatBytes(storageMaxBytes)} (${getPercentColor(storagePercent)})`);
+
+    console.log('');
+    console.log(`${chalk.gray('Tier:')}         ${chalk.green(result.tier || 'free')}`);
+    console.log(`${chalk.gray('Retention:')}    ${chalk.white(result.limits?.retentionDays || 30)} days`);
+    console.log(`${chalk.gray('Max versions:')} ${chalk.white(result.limits?.maxVersionsPerSite || 10)} per site`);
+    console.log('');
+
+    // Status indicators
+    if (result.canCreateNewSite === false) {
+        warning('Site limit reached - cannot create new sites');
+    }
+
+    if (storagePercent > 80) {
+        warning(`Storage ${storagePercent}% used - consider cleaning up old deployments`);
+    }
+
+    console.log('');
+}
+
+/**
+ * Create a simple progress bar with color coding
+ */
+function createProgressBar(current, max, width = 20) {
+    const filled = Math.round((current / max) * width);
+    const empty = width - filled;
+    const percent = (current / max) * 100;
+
+    const filledChar = '█';
+    let barColor;
+
+    if (percent >= 90) {
+        barColor = chalk.red;
+    } else if (percent >= 70) {
+        barColor = chalk.yellow;
+    } else {
+        barColor = chalk.green;
+    }
+
+    const bar = barColor(filledChar.repeat(filled)) + chalk.gray('░'.repeat(empty));
+    return `[${bar}]`;
+}
+
+/**
+ * Get colored percentage text
+ */
+function getPercentColor(percent) {
+    if (percent >= 90) {
+        return chalk.red(`${percent}%`);
+    } else if (percent >= 70) {
+        return chalk.yellow(`${percent}%`);
+    }
+    return chalk.green(`${percent}%`);
+}