umpordez 0.0.3 → 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(chmod:*)",
+      "Bash(node -e:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(xargs cat:*)",
+      "Bash(node:*)",
+      "Bash(echo:*)",
+      "WebFetch(domain:umpordez.com)",
+      "Bash(curl:*)",
+      "Bash(python3:*)"
+    ]
+  }
+}

package/build.mjs

@@ -0,0 +1,409 @@
+import chalk from 'chalk';
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+
+// umpordez.com design tokens
+const green = chalk.hex('#02e027');
+const cyan = chalk.hex('#00fff9');
+const red = chalk.hex('#ff3c00');
+const dim = chalk.hex('#a0a0a0');
+
+function run(cmd, cwd) {
+    execSync(cmd, { cwd, stdio: 'inherit' });
+}
+
+function runSilent(cmd, cwd) {
+    execSync(cmd, { cwd, stdio: 'ignore' });
+}
+
+// ─── build ───────────────────────────────────────────────────────────────────
+// Run locally. Compiles TypeScript + Vite, moves artifacts to builds repo.
+// Does NOT install node_modules — that's build-deps on the target machine.
+
+export async function buildProject(appDir, buildDir) {
+    appDir = path.resolve(appDir);
+    buildDir = path.resolve(buildDir);
+
+    if (!fs.existsSync(appDir)) {
+        console.log(red(`App directory not found: ${appDir}`));
+        process.exit(1);
+    }
+
+    if (!fs.existsSync(buildDir)) {
+        console.log(red(`Build directory not found: ${buildDir}`));
+        console.log(dim('Create it first: mkdir -p ' + buildDir));
+        process.exit(1);
+    }
+
+    console.log('');
+    console.log(green.bold('=== umpordez build ==='));
+    console.log('');
+    console.log(`  ${chalk.bold('Source:')}  ${cyan(appDir)}`);
+    console.log(`  ${chalk.bold('Output:')}  ${cyan(buildDir)}`);
+    console.log('');
+
+    // Pull builds repo if git
+    if (fs.existsSync(path.join(buildDir, '.git'))) {
+        console.log(dim('  Pulling builds repo...'));
+        runSilent('git pull', buildDir);
+    }
+
+    // Bump build number
+    const buildNumberFile = path.join(buildDir, 'build-number');
+    let number = 0;
+    if (fs.existsSync(buildNumberFile)) {
+        number = parseInt(
+            fs.readFileSync(buildNumberFile, 'utf-8').trim(),
+            10,
+        ) || 0;
+    }
+    const nextNumber = number + 1;
+
+    // ─── Admin UI ────────────────────────────────────────────────
+    // Static files (HTML/CSS/JS) — no node_modules needed at runtime
+
+    const adminDir = path.join(appDir, 'ui', 'admin');
+    if (fs.existsSync(adminDir)) {
+        console.log(green('[1/3]') + ' Building Admin UI...');
+
+        const distDir = path.join(adminDir, 'dist');
+        if (fs.existsSync(distDir)) {
+            fs.rmSync(distDir, { recursive: true });
+        }
+
+        run('npm run build', adminDir);
+
+        const buildAdminOut = path.join(buildDir, 'ui', 'admin');
+        if (fs.existsSync(buildAdminOut)) {
+            fs.rmSync(buildAdminOut, { recursive: true });
+        }
+        fs.mkdirSync(buildAdminOut, { recursive: true });
+
+        run(`rsync -av dist/* "${buildAdminOut}"`, adminDir);
+    }
+
+    // ─── Site UI ─────────────────────────────────────────────────
+    // Express + EJS — needs node_modules at runtime (installed by build-deps)
+
+    const siteDir = path.join(appDir, 'ui', 'site');
+    if (fs.existsSync(siteDir)) {
+        console.log(green('[2/3]') + ' Building Site UI...');
+
+        const siteBuildDir = path.join(siteDir, 'build');
+        if (fs.existsSync(siteBuildDir)) {
+            fs.rmSync(siteBuildDir, { recursive: true });
+        }
+
+        run('npm run build', siteDir);
+
+        const buildSiteOut = path.join(buildDir, 'ui', 'site');
+
+        // Preserve node_modules + .env from previous build-deps
+        const tmpModules = `/tmp/_umpordez_site_modules_${nextNumber}`;
+        const siteModules = path.join(buildSiteOut, 'node_modules');
+        if (fs.existsSync(siteModules)) {
+            fs.renameSync(siteModules, tmpModules);
+        }
+
+        const tmpEnv = `/tmp/_umpordez_site_env_${nextNumber}`;
+        const siteEnv = path.join(buildSiteOut, '.env');
+        if (fs.existsSync(siteEnv)) {
+            fs.renameSync(siteEnv, tmpEnv);
+        }
+
+        if (fs.existsSync(buildSiteOut)) {
+            fs.rmSync(buildSiteOut, { recursive: true });
+        }
+        fs.mkdirSync(buildSiteOut, { recursive: true });
+
+        run(`rsync -av build/ "${buildSiteOut}/"`, siteDir);
+
+        const viewsDir = path.join(siteDir, 'views');
+        if (fs.existsSync(viewsDir)) {
+            run(`rsync -av views "${buildSiteOut}/"`, siteDir);
+        }
+
+        const publicDir = path.join(siteDir, 'public');
+        if (fs.existsSync(publicDir)) {
+            run(`rsync -av public "${buildSiteOut}/"`, siteDir);
+        }
+
+        fs.copyFileSync(
+            path.join(siteDir, 'package.json'),
+            path.join(buildSiteOut, 'package.json'),
+        );
+
+        const lockFile = path.join(siteDir, 'package-lock.json');
+        if (fs.existsSync(lockFile)) {
+            fs.copyFileSync(
+                lockFile,
+                path.join(buildSiteOut, 'package-lock.json'),
+            );
+        }
+
+        // Restore .env and node_modules from previous build-deps
+        if (fs.existsSync(tmpEnv)) {
+            fs.renameSync(tmpEnv, path.join(buildSiteOut, '.env'));
+        }
+        if (fs.existsSync(tmpModules)) {
+            fs.renameSync(
+                tmpModules,
+                path.join(buildSiteOut, 'node_modules'),
+            );
+        }
+    }
+
+    // ─── Server ──────────────────────────────────────────────────
+    // Node.js — needs node_modules at runtime (installed by build-deps)
+
+    const serverDir = path.join(appDir, 'server');
+    if (fs.existsSync(serverDir)) {
+        console.log(green('[3/3]') + ' Building Server...');
+
+        const serverBuildDir = path.join(serverDir, 'build');
+        if (fs.existsSync(serverBuildDir)) {
+            fs.rmSync(serverBuildDir, { recursive: true });
+        }
+
+        run('npm run build', serverDir);
+
+        fs.copyFileSync(
+            path.join(serverDir, 'package.json'),
+            path.join(serverBuildDir, 'package.json'),
+        );
+
+        const serverLock = path.join(serverDir, 'package-lock.json');
+        if (fs.existsSync(serverLock)) {
+            fs.copyFileSync(
+                serverLock,
+                path.join(serverBuildDir, 'package-lock.json'),
+            );
+        }
+
+        // Copy email templates
+        const emailsDir = path.join(serverDir, 'emails');
+        if (fs.existsSync(emailsDir)) {
+            const buildEmails = path.join(serverBuildDir, 'emails');
+            fs.mkdirSync(buildEmails, { recursive: true });
+            for (const f of fs.readdirSync(emailsDir)) {
+                fs.copyFileSync(
+                    path.join(emailsDir, f),
+                    path.join(buildEmails, f),
+                );
+            }
+        }
+
+        // Remove .ts and .map from compiled migrations
+        const migrationsDir = path.join(serverBuildDir, 'migrations');
+        if (fs.existsSync(migrationsDir)) {
+            for (const f of fs.readdirSync(migrationsDir)) {
+                if (f.endsWith('.ts') || f.endsWith('.map')) {
+                    fs.unlinkSync(path.join(migrationsDir, f));
+                }
+            }
+        }
+
+        const buildServerOut = path.join(buildDir, 'server');
+
+        // Preserve node_modules and .env from previous build-deps
+        const tmpServerModules = `/tmp/_umpordez_server_modules_${nextNumber}`;
+        const serverModules = path.join(buildServerOut, 'node_modules');
+        if (fs.existsSync(serverModules)) {
+            fs.renameSync(serverModules, tmpServerModules);
+        }
+
+        const tmpServerEnv = `/tmp/_umpordez_server_env_${nextNumber}`;
+        const serverEnv = path.join(buildServerOut, '.env');
+        if (fs.existsSync(serverEnv)) {
+            fs.renameSync(serverEnv, tmpServerEnv);
+        }
+
+        if (fs.existsSync(buildServerOut)) {
+            fs.rmSync(buildServerOut, { recursive: true });
+        }
+        fs.mkdirSync(buildServerOut, { recursive: true });
+
+        run(`rsync -av build/* "${buildServerOut}"`, serverDir);
+
+        // Write knex.sh for the build repo (local knex + .js knexfile)
+        const knexSh = '#!/bin/bash\n'
+            + 'node ./node_modules/knex/bin/cli.js \\\n'
+            + '    --knexfile core/knexfile.js \\\n'
+            + '    --migrations-directory ../migrations $@\n';
+        fs.writeFileSync(
+            path.join(buildServerOut, 'knex.sh'),
+            knexSh,
+            { mode: 0o755 }
+        );
+
+        // Restore node_modules and .env
+        if (fs.existsSync(tmpServerEnv)) {
+            fs.renameSync(tmpServerEnv, path.join(buildServerOut, '.env'));
+        }
+        if (fs.existsSync(tmpServerModules)) {
+            fs.renameSync(
+                tmpServerModules,
+                path.join(buildServerOut, 'node_modules')
+            );
+        }
+    }
+
+    // ─── Version & Git ───────────────────────────────────────────
+
+    fs.writeFileSync(buildNumberFile, String(nextNumber), 'utf-8');
+
+    if (fs.existsSync(path.join(buildDir, '.git'))) {
+        console.log(dim('  Committing build...'));
+
+        try {
+            run('git add .', buildDir);
+            run(
+                `git commit -m "build: #${nextNumber}"`,
+                buildDir,
+            );
+        } catch {
+            // nothing to commit
+        }
+
+        // Tag if doesn't exist
+        try {
+            execSync(
+                `git rev-parse "${nextNumber}"`,
+                { cwd: buildDir, stdio: 'ignore' },
+            );
+        } catch {
+            run(
+                `git tag -a "${nextNumber}" -m "#${nextNumber}"`,
+                buildDir,
+            );
+            run('git push origin --tags', buildDir);
+        }
+
+        run('git push', buildDir);
+    }
+
+    console.log('');
+    console.log(green.bold(`=== Build #${nextNumber} complete ===`));
+    console.log('');
+    console.log(`  ${chalk.bold('Admin UI:')}  ${cyan(path.join(buildDir, 'ui', 'admin'))}`);
+    console.log(`  ${chalk.bold('Site UI:')}   ${cyan(path.join(buildDir, 'ui', 'site'))}`);
+    console.log(`  ${chalk.bold('Server:')}    ${cyan(path.join(buildDir, 'server'))}`);
+    console.log('');
+    console.log(dim('  Next: run umpordez build-deps on the target machine'));
+    console.log('');
+}
+
+// ─── build-deps ──────────────────────────────────────────────────────────────
+// Run on prod/staging. Installs production node_modules in the builds repo
+// so native bindings match the target OS. After this, the repo is ready to run.
+
+export async function buildDeps(buildDir) {
+    buildDir = path.resolve(buildDir);
+
+    if (!fs.existsSync(buildDir)) {
+        console.log(red(`Build directory not found: ${buildDir}`));
+        console.log(dim('Run umpordez build first.'));
+        process.exit(1);
+    }
+
+    console.log('');
+    console.log(green.bold('=== umpordez build-deps ==='));
+    console.log('');
+    console.log(`  ${chalk.bold('Output:')}  ${cyan(buildDir)}`);
+    console.log('');
+
+    // Pull builds repo if git
+    if (fs.existsSync(path.join(buildDir, '.git'))) {
+        console.log(dim('  Pulling builds repo...'));
+        runSilent('git pull', buildDir);
+    }
+
+    let step = 1;
+    const parts = [];
+
+    const buildServerOut = path.join(buildDir, 'server');
+    const buildSiteOut = path.join(buildDir, 'ui', 'site');
+
+    if (fs.existsSync(buildServerOut)) {
+        parts.push('server');
+    }
+    if (fs.existsSync(buildSiteOut)) {
+        parts.push('site');
+    }
+
+    if (parts.length === 0) {
+        console.log(red('No build output found.'));
+        console.log(dim('Run umpordez build first.'));
+        process.exit(1);
+    }
+
+    const total = parts.length;
+
+    // ─── Server deps ─────────────────────────────────────────────
+
+    if (parts.includes('server')) {
+        console.log(
+            green(`[${step}/${total}]`)
+            + ' Installing server dependencies...',
+        );
+
+        const serverModules = path.join(buildServerOut, 'node_modules');
+        if (fs.existsSync(serverModules)) {
+            fs.rmSync(serverModules, { recursive: true });
+        }
+
+        try {
+            run('npm ci --omit=dev', buildServerOut);
+        } catch {
+            run('npm install --omit=dev', buildServerOut);
+        }
+
+        step++;
+    }
+
+    // ─── Site UI deps ────────────────────────────────────────────
+
+    if (parts.includes('site')) {
+        console.log(
+            green(`[${step}/${total}]`)
+            + ' Installing site dependencies...',
+        );
+
+        const siteModules = path.join(buildSiteOut, 'node_modules');
+        if (fs.existsSync(siteModules)) {
+            fs.rmSync(siteModules, { recursive: true });
+        }
+
+        try {
+            run('npm ci --omit=dev', buildSiteOut);
+        } catch {
+            run('npm install --omit=dev', buildSiteOut);
+        }
+
+        step++;
+    }
+
+    // ─── Git commit ──────────────────────────────────────────────
+
+    if (fs.existsSync(path.join(buildDir, '.git'))) {
+        console.log(dim('  Committing dependencies...'));
+
+        try {
+            run('git add .', buildDir);
+            run(
+                'git commit -m "deps: update node_modules"',
+                buildDir,
+            );
+            run('git push', buildDir);
+        } catch {
+            console.log(dim('  No dependency changes to commit.'));
+        }
+    }
+
+    console.log('');
+    console.log(green.bold('=== Dependencies ready ==='));
+    console.log('');
+    console.log(dim('  Add .env and start the services.'));
+    console.log('');
+}

package/cli.mjs

@@ -1,130 +1,108 @@
 #!/usr/bin/env node
 
-import inquirer from 'inquirer';
 import chalk from 'chalk';
 import figlet from 'figlet';
+import { createRequire } from 'node:module';
 
-import fs from 'node:fs';
+import { createProject } from './create.mjs';
+import { buildProject, buildDeps } from './build.mjs';
 
-console.log(chalk.green(figlet.textSync('umpordez')));
-console.log('');
+const require = createRequire(import.meta.url);
+const { version } = require('./package.json');
 
-function sample(arr) {
-    return arr[Math.floor(Math.random() * arr.length)];
-}
-
-async function saveUser(user) {
-    await fs.promises.writeFile('_user.json', JSON.stringify(user));
+// umpordez.com design tokens
+const green = chalk.hex('#02e027');
+const cyan = chalk.hex('#00fff9');
+const red = chalk.hex('#ff3c00');
+const dim = chalk.hex('#a0a0a0');
 
+function showBanner() {
+    console.log('');
+    console.log(green(figlet.textSync('umpordez', { font: 'Small' })));
+    console.log(dim('  SaaS starter kit generator'));
+    console.log(dim('  TypeScript + React + PostgreSQL + multi-tenant'));
+    console.log(cyan('  youtube.com/ligeiro'));
+    console.log('');
 }
 
-async function getUser() {
-    try {
-        const data = await fs.promises.readFile('_user.json');
-        return JSON.parse(data);
-    } catch (ex) { }
-}
-
-let user = await getUser();
+function showHelp() {
+    showBanner();
 
-if (user?.id) {
-    console.log(`Logged in as /${user.login} \o/`);
+    console.log(green.bold('Usage:'));
+    console.log(`  umpordez              ${dim('Create a new project')}`);
+    console.log(`  umpordez create       ${dim('Create a new project')}`);
+    console.log(`  umpordez build ${dim('<app> <builds>')}       ${dim('Build for production')}`);
+    console.log(`  umpordez build-deps ${dim('<builds>')}        ${dim('Install deps in build')}`);
+    console.log(`  umpordez --help                  ${dim('Show this help')}`);
+    console.log(`  umpordez --version               ${dim('Show version')}`);
+    console.log('');
+    console.log(green.bold('What you get:'));
+    console.log(`  ${green('>')} Multi-tenant auth (cookie-based JWT)`);
+    console.log(`  ${green('>')} Admin API + Site API (Express)`);
+    console.log(`  ${green('>')} React admin panel (Vite + shadcn/ui)`);
+    console.log(`  ${green('>')} PostgreSQL + Knex.js migrations`);
+    console.log(`  ${green('>')} S3 file uploads with signed URLs`);
+    console.log(`  ${green('>')} EJS-based public site`);
+    console.log(`  ${green('>')} Console task runner`);
+    console.log(`  ${green('>')} Role-based access (admin/owner/manager/user)`);
+    console.log(`  ${green('>')} Production build system with versioning`);
     console.log('');
 }
 
-const API_URL = `http://localhost:9000/rest`;
-
-async function tryAuthenticate(token) {
-    const res = await fetch(API_URL, {
-        headers: {
-            Authorization: token
-        }
-    });
-
-    return res.json();
+function showVersion() {
+    console.log(`${green('umpordez')} ${dim('v' + version)}`);
 }
 
-function getChoices() {
-    const choices = {
-        'I want to authenticate myself': async () => {
-            const res = await inquirer.prompt([
-                {
-                    type: 'password',
-                    name: 'key',
-                    message: `So, please tell me... what's your key?`
-                }
-            ]);
-
-            await saveUser({ id: null, token: res.key });
-
-            console.log('');
-            console.log(chalk.green('Cool!! 😎 trying to login'));
-            console.log(chalk.green('...'));
-
-            const authUser = await tryAuthenticate(res.key);
-
-            if (!authUser || !authUser.id) {
-                console.error('OH NO, invalid credentials or something with your network dude');
-                return promptMain();
-            }
-
-            await saveUser({ ...authUser, token: res.key });
-
-            user = authUser;
-            console.log(`Hello hello ${user.login}!!!`);
-
-            return promptMain();
-        },
-        'I want to logout': async () => {
-            await saveUser({});
-            user = {};
-
-            console.log(chalk.green('ciao'));
-            return promptMain();
-        },
-        'I want to leave': () => {
-            console.log(chalk.green('So, my friend...'));
-            console.log(chalk.green('farewell o/'));
-        },
-    };
-
-    if (user?.id) {
-        delete choices['I want to authenticate myself'];
-    } else {
-        delete choices['I want to logout'];
+async function runBuild(args) {
+    const appDir = args[1];
+    const buildDir = args[2];
+
+    if (!appDir || !buildDir) {
+        console.log(red('Usage: umpordez build <app-dir> <build-dir>'));
+        console.log('');
+        console.log(dim('  <app-dir>    Path to the project (source)'));
+        console.log(dim('  <build-dir>  Path to the builds output'));
+        console.log('');
+        console.log(dim('  Example:'));
+        console.log(`  ${green('$')} umpordez build ../app ../builds`);
+        process.exit(1);
     }
 
-    return choices;
+    await buildProject(appDir, buildDir);
 }
 
+async function runBuildDeps(args) {
+    const buildDir = args[1];
+
+    if (!buildDir) {
+        console.log(red('Usage: umpordez build-deps <build-dir>'));
+        console.log('');
+        console.log(dim('  <build-dir>  Path to the builds output'));
+        console.log('');
+        console.log(dim('  Example:'));
+        console.log(`  ${green('$')} umpordez build-deps ../builds`);
+        process.exit(1);
+    }
 
-const welcomeMessages = [
-    'hello, my young padawan',
-    'how you doin?',
-    'whats up?',
-    'heeeey yooo'
-];
-
-
-async function promptMain() {
-    const choices = getChoices();
-
-    const option = await inquirer.prompt([
-        {
-            type: 'rawlist',
-            name: 'task',
-            message: `${sample(welcomeMessages)}\n  Please, choose one:`,
-            choices: Object.keys(choices)
-        }
-    ]);
-
-
-    console.log('');
-    console.log('You have choose:');
-    console.log(chalk.cyan(option.task));
-    console.log('');
-
-    await choices[option.task]();
+    await buildDeps(buildDir);
 }
 
-await promptMain();
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (!command || command === 'create') {
+    showBanner();
+    await createProject();
+} else if (command === 'build') {
+    await runBuild(args);
+} else if (command === 'build-deps') {
+    await runBuildDeps(args);
+} else if (command === '--help' || command === '-h' || command === 'help') {
+    showHelp();
+} else if (command === '--version' || command === '-v') {
+    showVersion();
+} else {
+    console.log(red(`Unknown command: ${command}`));
+    console.log(`Run ${green('umpordez --help')} to see available commands.`);
+    process.exit(1);
+}