launchpd 0.1.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,183 @@
+# Launchpd
+
+Deploy static sites instantly to a live URL. No config, no complexity.
+
+## Quick Start
+
+```bash
+npm install -g launchpd
+launchpd deploy ./my-site
+# → https://abc123.launchpd.cloud
+```
+
+## 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
+# → https://my-project.launchpd.cloud
+```
+
+### Set expiration time
+
+```bash
+launchpd deploy ./my-folder --expires 2h
+# Auto-deletes after 2 hours
+```
+
+### Dry run (preview without uploading)
+
+```bash
+launchpd deploy ./my-folder --dry-run
+```
+
+### 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
+```
+
+## Tier Limits
+
+| Feature | Anonymous | Free (Registered) |
+|---------|-----------|-------------------|
+| Sites | 3 | 10 |
+| Storage | 50MB | 100MB |
+| Retention | 7 days | 30 days |
+| Versions | 1 | 10 |
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/your-username/launchpd.git
+cd launchpd/cli
+npm install
+cp ../.env.example ../.env
+# Edit ../.env with your Cloudflare R2 credentials
+```
+
+### Test locally
+
+```bash
+# Dry run mode (no R2 upload)
+npm run dev
+
+# Or test with a real folder
+node bin/cli.js deploy ../examples/test-site --dry-run
+```
+
+### Link for global testing
+
+```bash
+npm link
+launchpd deploy ./test-site --dry-run
+```
+
+### Run tests
+
+```bash
+npm test
+npm run test:watch
+npm run test:coverage
+```
+
+### Lint code
+
+```bash
+npm run lint
+npm run lint:fix
+```
+
+## Configuration
+
+The CLI loads configuration from environment variables. Create a `.env` file in the project root:
+
+```env
+R2_ACCOUNT_ID=your_cloudflare_account_id
+R2_ACCESS_KEY_ID=your_r2_access_key_id
+R2_SECRET_ACCESS_KEY=your_r2_secret_access_key
+R2_BUCKET_NAME=launchpd
+LAUNCHPD_DOMAIN=launchpd.cloud
+```
+
+## Architecture
+
+```
+CLI (Node.js + Commander.js)
+    ↓
+Upload files to Cloudflare R2
+    ↓
+Cloudflare Worker serves files
+    ↓
+https://{subdomain}.launchpd.cloud
+```
+
+## Publishing to npm
+
+```bash
+cd cli
+npm run lint
+npm test
+npm publish --access public
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,90 @@
+#!/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.0');
+
+program
+    .command('deploy')
+    .description('Deploy a folder to a live URL')
+    .argument('<folder>', 'Path to the folder to deploy')
+    .option('--dry-run', 'Simulate deployment without uploading to R2')
+    .option('--name <subdomain>', 'Use a custom subdomain (optional)')
+    .option('--expires <time>', 'Auto-delete after time (e.g., 30m, 2h, 1d). Minimum: 30m')
+    .action(async (folder, options) => {
+        await deploy(folder, options);
+    });
+
+program
+    .command('list')
+    .description('List your past deployments')
+    .option('--json', 'Output as JSON')
+    .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')
+    .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')
+    .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,62 @@
+#!/usr/bin/env node
+
+import { config, validateConfig } from '../src/config.js';
+import { info, success, error } from '../src/utils/logger.js';
+import chalk from 'chalk';
+
+/**
+ * Setup script to validate and display configuration status
+ */
+async function setup() {
+    console.log('\n' + chalk.bold.blue('═══════════════════════════════════════'));
+    console.log(chalk.bold.blue('  Launchpd Configuration Check'));
+    console.log(chalk.bold.blue('═══════════════════════════════════════\n'));
+
+    // Check environment variables
+    info('Checking configuration...\n');
+
+    const validation = validateConfig();
+
+    if (!validation.valid) {
+        error(`Missing required environment variables:`);
+        for (const missing of validation.missing) {
+            console.log(chalk.red(`  ✗ ${missing}`));
+        }
+        console.log('\n' + chalk.yellow('Setup Instructions:'));
+        console.log('  1. Copy .env.example to .env:');
+        console.log(chalk.gray('     cp .env.example .env'));
+        console.log('  2. Edit .env and add your Cloudflare R2 credentials');
+        console.log('  3. Get credentials from: https://dash.cloudflare.com → R2 → API Tokens\n');
+        process.exit(1);
+    }
+
+    // Display current configuration
+    console.log(chalk.green('✓ All required environment variables set\n'));
+
+    console.log(chalk.bold('Current Configuration:'));
+    console.log(chalk.gray('─'.repeat(50)));
+    console.log(chalk.cyan('  Domain:        '), config.domain);
+    console.log(chalk.cyan('  R2 Bucket:     '), config.r2.bucketName);
+    console.log(chalk.cyan('  Account ID:    '), config.r2.accountId ? '✓ Set' : '✗ Missing');
+    console.log(chalk.cyan('  Access Key:    '), config.r2.accessKeyId ? '✓ Set' : '✗ Missing');
+    console.log(chalk.cyan('  Secret Key:    '), config.r2.secretAccessKey ? '✓ Set' : '✗ Missing');
+    console.log(chalk.gray('─'.repeat(50)) + '\n');
+
+    // Next steps
+    console.log(chalk.bold('Next Steps:'));
+    console.log(chalk.gray('  1. Test dry-run deployment:'));
+    console.log(chalk.cyan('     npm run dev'));
+    console.log(chalk.gray('  2. Deploy Worker:'));
+    console.log(chalk.cyan('     cd worker && wrangler deploy'));
+    console.log(chalk.gray('  3. Verify DNS settings in Cloudflare Dashboard:'));
+    console.log(chalk.cyan(`     DNS → Records → Add A record * → 192.0.2.1 (Proxied)`));
+    console.log(chalk.gray('  4. Deploy your first site:'));
+    console.log(chalk.cyan('     launchpd deploy ./your-folder\n'));
+
+    success('Setup validation complete!');
+}
+
+setup().catch(err => {
+    error(`Setup failed: ${err.message}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,68 @@
+{
+    "name": "launchpd",
+    "version": "0.1.0",
+    "description": "Deploy static sites instantly to a live URL",
+    "type": "module",
+    "bin": {
+        "launchpd": "./bin/cli.js"
+    },
+    "main": "./src/commands/index.js",
+    "exports": {
+        ".": "./src/commands/index.js",
+        "./utils": "./src/utils/index.js"
+    },
+    "files": [
+        "bin",
+        "src"
+    ],
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "scripts": {
+        "start": "node bin/cli.js",
+        "dev": "node bin/cli.js deploy ../examples/test-site --dry-run",
+        "setup": "node bin/setup.js",
+        "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"
+    },
+    "keywords": [
+        "static",
+        "hosting",
+        "deploy",
+        "cli",
+        "cloudflare",
+        "r2",
+        "cdn",
+        "website",
+        "publish"
+    ],
+    "author": "Kent John Edoloverio",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/kents00/launchpd.git",
+        "directory": "cli"
+    },
+    "bugs": {
+        "url": "https://github.com/kents00/launchpd/issues"
+    },
+    "homepage": "https://launchpd.cloud",
+    "dependencies": {
+        "@aws-sdk/client-s3": "^3.700.0",
+        "chalk": "^5.4.0",
+        "commander": "^14.0.0",
+        "dotenv": "^16.4.0",
+        "mime-types": "^2.1.35",
+        "nanoid": "^5.1.0"
+    },
+    "devDependencies": {
+        "@eslint/js": "^9.39.2",
+        "@vitest/coverage-v8": "^2.1.0",
+        "eslint": "^9.0.0",
+        "vitest": "^2.1.0"
+    }
+}