clefbase 1.1.5 → 1.2.0

package/dist/cli-src/cli/commands/deploy.js

@@ -0,0 +1,285 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDeploy = runDeploy;
+exports.runHostingInit = runHostingInit;
+exports.runStatus = runStatus;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+// ─── MIME map ─────────────────────────────────────────────────────────────────
+const MIME = {
+    ".html": "text/html", ".htm": "text/html",
+    ".css": "text/css",
+    ".js": "application/javascript", ".mjs": "application/javascript", ".cjs": "application/javascript",
+    ".json": "application/json", ".map": "application/json",
+    ".ts": "application/typescript",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff", ".woff2": "font/woff2",
+    ".ttf": "font/ttf", ".otf": "font/otf",
+    ".txt": "text/plain", ".md": "text/markdown",
+    ".xml": "application/xml",
+    ".pdf": "application/pdf",
+    ".webmanifest": "application/manifest+json",
+};
+function mimeFor(filePath) {
+    return MIME[path_1.default.extname(filePath).toLowerCase()] ?? "application/octet-stream";
+}
+const SKIP_FILES = new Set([".DS_Store", "Thumbs.db", ".gitkeep", ".gitignore"]);
+const SKIP_DIRS = new Set(["node_modules", ".git", ".svn", ".hg"]);
+function scanDir(dir, base, out) {
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        if (SKIP_FILES.has(entry.name))
+            continue;
+        const full = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name))
+                scanDir(full, base, out);
+        }
+        else if (entry.isFile()) {
+            const stat = fs_1.default.statSync(full);
+            out.push({
+                absPath: full,
+                deployPath: path_1.default.relative(base, full).replace(/\\/g, "/"),
+                size: stat.size,
+            });
+        }
+    }
+}
+function fmtBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(2)} MB`;
+}
+// ─── deploy ───────────────────────────────────────────────────────────────────
+async function runDeploy(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const cfg = (0, config_1.requireConfig)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold.cyan("  Clefbase Deploy"));
+    console.log();
+    // ── Resolve / pick a site ─────────────────────────────────────────────────
+    let siteId = opts.site ?? cfg.hosting?.siteId ?? "";
+    let siteName = cfg.hosting?.siteName ?? "";
+    if (!siteId) {
+        siteId = await pickOrCreateSite(cfg);
+        const sites = await (0, api_1.listSites)(cfg).catch(() => []);
+        siteName = sites.find(s => s.id === siteId)?.name ?? siteId;
+        cfg.hosting = {
+            siteId,
+            siteName,
+            distDir: cfg.hosting?.distDir ?? "dist",
+            entrypoint: cfg.hosting?.entrypoint ?? "index.html",
+        };
+        (0, config_1.saveConfig)(cfg, cwd);
+    }
+    // ── Resolve dist dir ──────────────────────────────────────────────────────
+    const distDir = opts.dir ?? cfg.hosting?.distDir ?? await promptDistDir(cwd);
+    const absDir = path_1.default.isAbsolute(distDir) ? distDir : path_1.default.join(cwd, distDir);
+    if (!fs_1.default.existsSync(absDir)) {
+        console.error(chalk_1.default.red(`\n  ✗ Directory not found: ${absDir}`));
+        console.error(chalk_1.default.dim("    Build your project first (e.g. npm run build), then redeploy.\n"));
+        process.exit(1);
+    }
+    // ── Scan ──────────────────────────────────────────────────────────────────
+    const scanSpinner = (0, ora_1.default)("Scanning files…").start();
+    const files = [];
+    scanDir(absDir, absDir, files);
+    const totalBytes = files.reduce((a, f) => a + f.size, 0);
+    scanSpinner.succeed(`${chalk_1.default.bold(files.length)} files  ${chalk_1.default.dim("(" + fmtBytes(totalBytes) + ")")}`);
+    if (files.length === 0) {
+        console.error(chalk_1.default.red(`  ✗ No files found in ${distDir}\n`));
+        process.exit(1);
+    }
+    const entrypoint = cfg.hosting?.entrypoint ?? "index.html";
+    if (!files.some(f => f.deployPath === entrypoint)) {
+        console.warn(chalk_1.default.yellow(`  ⚠  Entrypoint "${entrypoint}" not found — is your build output correct?`));
+    }
+    // ── Summary ───────────────────────────────────────────────────────────────
+    console.log();
+    console.log(`  ${chalk_1.default.bold("Site:")}   ${siteName}  ${chalk_1.default.dim(siteId)}`);
+    console.log(`  ${chalk_1.default.bold("From:")}   ${path_1.default.relative(cwd, absDir)}`);
+    console.log(`  ${chalk_1.default.bold("Files:")}  ${files.length}  ${chalk_1.default.dim("(" + fmtBytes(totalBytes) + ")")}`);
+    console.log();
+    // ── Create deploy ─────────────────────────────────────────────────────────
+    const deploySpinner = (0, ora_1.default)("Creating deploy…").start();
+    let deploy;
+    try {
+        deploy = await (0, api_1.createDeploy)(cfg, siteId, entrypoint);
+        deploySpinner.succeed(`Deploy created  ${chalk_1.default.dim(deploy.id)}`);
+    }
+    catch (err) {
+        deploySpinner.fail(`Failed: ${err.message}`);
+        process.exit(1);
+    }
+    // ── Upload in batches of 20 ───────────────────────────────────────────────
+    const BATCH = 20;
+    let uploaded = 0;
+    const allErrors = [];
+    const upSpinner = (0, ora_1.default)(`Uploading  0 / ${files.length}`).start();
+    for (let i = 0; i < files.length; i += BATCH) {
+        const batch = files.slice(i, i + BATCH).map(f => ({
+            path: f.deployPath,
+            buffer: fs_1.default.readFileSync(f.absPath),
+        }));
+        try {
+            const result = await (0, api_1.uploadFileBatch)(cfg, deploy.id, batch);
+            uploaded += result.uploaded ?? batch.length;
+            if (result.errors?.length)
+                allErrors.push(...result.errors);
+        }
+        catch (err) {
+            allErrors.push(`Batch ${i + 1}–${Math.min(i + BATCH, files.length)}: ${err.message}`);
+        }
+        const done = Math.min(i + BATCH, files.length);
+        upSpinner.text = `Uploading  ${done} / ${files.length}`;
+    }
+    if (allErrors.length > 0) {
+        upSpinner.warn(`Uploaded ${uploaded} / ${files.length}  (${allErrors.length} error(s))`);
+        allErrors.forEach(e => console.log(chalk_1.default.dim(`    • ${e}`)));
+    }
+    else {
+        upSpinner.succeed(`Uploaded ${chalk_1.default.bold(uploaded)} files`);
+    }
+    // ── Finalize ──────────────────────────────────────────────────────────────
+    const finSpinner = (0, ora_1.default)("Going live…").start();
+    try {
+        await (0, api_1.finalizeDeploy)(cfg, deploy.id, opts.message);
+        finSpinner.succeed(chalk_1.default.green("Live!"));
+    }
+    catch (err) {
+        finSpinner.fail(`Finalize failed: ${err.message}`);
+        process.exit(1);
+    }
+    // ── Result ────────────────────────────────────────────────────────────────
+    const url = `${cfg.serverUrl.replace(/\/+$/, "")}/hosted/${cfg.projectId}/${siteId}`;
+    console.log();
+    console.log(chalk_1.default.green.bold(`  ✓  ${url}`));
+    console.log();
+}
+// ─── hosting:init ─────────────────────────────────────────────────────────────
+async function runHostingInit(cwd = process.cwd()) {
+    const cfg = (0, config_1.requireConfig)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold.cyan("  Hosting Setup"));
+    console.log();
+    const siteId = await pickOrCreateSite(cfg);
+    const sites = await (0, api_1.listSites)(cfg).catch(() => []);
+    const siteName = sites.find(s => s.id === siteId)?.name ?? siteId;
+    const { distDir } = await inquirer_1.default.prompt([{
+            type: "input", name: "distDir",
+            message: "Build output directory",
+            default: cfg.hosting?.distDir ?? guessDistDir(cwd),
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const { entrypoint } = await inquirer_1.default.prompt([{
+            type: "input", name: "entrypoint",
+            message: "HTML entrypoint",
+            default: cfg.hosting?.entrypoint ?? "index.html",
+        }]);
+    cfg.services.hosting = true;
+    cfg.hosting = { siteId, siteName, distDir: distDir.trim(), entrypoint: entrypoint.trim() };
+    (0, config_1.saveConfig)(cfg, cwd);
+    console.log();
+    console.log(chalk_1.default.green(`  ✓  Linked to "${siteName}"`));
+    console.log(chalk_1.default.dim("  Run `clefbase deploy` to go live."));
+    console.log();
+}
+// ─── hosting:status ───────────────────────────────────────────────────────────
+async function runStatus(cwd = process.cwd()) {
+    const cfg = (0, config_1.requireConfig)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold("  Deploy Status"));
+    console.log();
+    if (!cfg.hosting?.siteId) {
+        console.log(chalk_1.default.yellow("  No site linked. Run `clefbase hosting:init` first.\n"));
+        return;
+    }
+    const sp = (0, ora_1.default)("Fetching active deploy…").start();
+    try {
+        const active = await (0, api_1.getActiveDeploy)(cfg, cfg.hosting.siteId);
+        if (!active) {
+            sp.info("No active deploy yet.");
+        }
+        else {
+            sp.succeed("Active deploy");
+            const d = active.deploy;
+            const url = `${cfg.serverUrl.replace(/\/+$/, "")}/hosted/${cfg.projectId}/${cfg.hosting.siteId}`;
+            console.log();
+            console.log(`  ${chalk_1.default.bold("Site:")}     ${cfg.hosting.siteName}  ${chalk_1.default.dim(cfg.hosting.siteId)}`);
+            console.log(`  ${chalk_1.default.bold("Deploy:")}   ${chalk_1.default.dim(d.id)}`);
+            console.log(`  ${chalk_1.default.bold("Status:")}   ${chalk_1.default.green(d.status)}`);
+            console.log(`  ${chalk_1.default.bold("Files:")}    ${d.fileCount}  ${chalk_1.default.dim(fmtBytes(d.totalBytes ?? 0))}`);
+            console.log(`  ${chalk_1.default.bold("Deployed:")} ${new Date(d.finishedAt ?? d.createdAt).toLocaleString()}`);
+            console.log(`  ${chalk_1.default.bold("URL:")}      ${url}`);
+        }
+    }
+    catch (err) {
+        sp.fail(err.message);
+    }
+    console.log();
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+async function pickOrCreateSite(cfg) {
+    const sp = (0, ora_1.default)("Fetching sites…").start();
+    let sites = [];
+    try {
+        sites = await (0, api_1.listSites)(cfg);
+        sp.succeed(`${sites.length} site(s)`);
+    }
+    catch {
+        sp.warn("Could not fetch sites");
+    }
+    if (sites.length > 0) {
+        const choices = [
+            ...sites.map(s => ({ name: `${s.name}  ${chalk_1.default.dim(s.id)}`, value: s.id })),
+            { name: chalk_1.default.cyan("+ Create a new site"), value: "__new__" },
+        ];
+        const { chosen } = await inquirer_1.default.prompt([{
+                type: "list", name: "chosen",
+                message: "Which site should receive this deploy?",
+                choices,
+            }]);
+        if (chosen !== "__new__")
+            return chosen;
+    }
+    const { name } = await inquirer_1.default.prompt([{
+            type: "input", name: "name",
+            message: "New site name",
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const s = (0, ora_1.default)(`Creating "${name}"…`).start();
+    const site = await (0, api_1.createSite)(cfg, name.trim());
+    s.succeed(chalk_1.default.green(`Created "${site.name}"  ${chalk_1.default.dim(site.id)}`));
+    return site.id;
+}
+async function promptDistDir(cwd) {
+    const { dir } = await inquirer_1.default.prompt([{
+            type: "input", name: "dir",
+            message: "Build output directory",
+            default: guessDistDir(cwd),
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    return dir.trim();
+}
+function guessDistDir(cwd) {
+    for (const c of ["dist", "build", "out", ".next", "public"]) {
+        if (fs_1.default.existsSync(path_1.default.join(cwd, c)))
+            return c;
+    }
+    return "dist";
+}

package/dist/cli-src/cli/commands/info.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInfo = runInfo;
+exports.runSitesList = runSitesList;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+async function runInfo(cwd = process.cwd()) {
+    const cfg = (0, config_1.requireConfig)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold("  Project Info"));
+    console.log();
+    console.log(`  ${chalk_1.default.bold("Server:")}     ${cfg.serverUrl}`);
+    console.log(`  ${chalk_1.default.bold("Project ID:")} ${cfg.projectId}`);
+    console.log(`  ${chalk_1.default.bold("API Key:")}    ${cfg.apiKey.slice(0, 8)}${"●".repeat(10)}`);
+    console.log();
+    console.log(`  ${chalk_1.default.bold("Services:")}`);
+    for (const [svc, on] of Object.entries(cfg.services)) {
+        console.log(`    ${on ? chalk_1.default.green("✓") : chalk_1.default.dim("✗")}  ${svc}`);
+    }
+    if (cfg.hosting) {
+        const url = `${cfg.serverUrl.replace(/\/+$/, "")}/hosted/${cfg.projectId}/${cfg.hosting.siteId}`;
+        console.log();
+        console.log(`  ${chalk_1.default.bold("Hosting:")}`);
+        console.log(`    ${chalk_1.default.dim("Site:")}     ${cfg.hosting.siteName}  ${chalk_1.default.dim(cfg.hosting.siteId)}`);
+        console.log(`    ${chalk_1.default.dim("Dist:")}     ${cfg.hosting.distDir}`);
+        console.log(`    ${chalk_1.default.dim("Entry:")}    ${cfg.hosting.entrypoint}`);
+        console.log(`    ${chalk_1.default.dim("URL:")}      ${url}`);
+    }
+    console.log();
+    const sp = (0, ora_1.default)("Checking connection…").start();
+    const ok = await (0, api_1.testConnection)(cfg);
+    ok
+        ? sp.succeed(chalk_1.default.green("Server reachable"))
+        : sp.fail(chalk_1.default.red("Cannot reach server"));
+    console.log();
+}
+async function runSitesList(cwd = process.cwd()) {
+    const cfg = (0, config_1.requireConfig)(cwd);
+    const sp = (0, ora_1.default)("Fetching sites…").start();
+    try {
+        const sites = await (0, api_1.listSites)(cfg);
+        sp.succeed(`${sites.length} site(s)`);
+        console.log();
+        if (sites.length === 0) {
+            console.log(chalk_1.default.dim("  No sites yet. Run `clefbase hosting:init` to create one.\n"));
+            return;
+        }
+        const linked = cfg.hosting?.siteId;
+        for (const s of sites) {
+            const tag = s.id === linked ? chalk_1.default.cyan("  ← linked") : "";
+            const url = `${cfg.serverUrl.replace(/\/+$/, "")}/hosted/${cfg.projectId}/${s.id}`;
+            console.log(`  ${chalk_1.default.bold(s.name)}${tag}`);
+            console.log(`    ${chalk_1.default.dim("ID:")}      ${s.id}`);
+            console.log(`    ${chalk_1.default.dim("Status:")}  ${s.status}`);
+            console.log(`    ${chalk_1.default.dim("URL:")}     ${url}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        sp.fail(err.message);
+    }
+}

package/dist/cli-src/cli/commands/init.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../config");
+const api_1 = require("../api");
+const DEFAULT_SERVER = "https://api.cleforyx.com";
+async function runInit(cwd = process.cwd()) {
+    console.log();
+    console.log(chalk_1.default.bold.cyan("  ╔══════════════════════════════════╗"));
+    console.log(chalk_1.default.bold.cyan("  ║    Clefbase  ·  Project Setup    ║"));
+    console.log(chalk_1.default.bold.cyan("  ╚══════════════════════════════════╝"));
+    console.log();
+    // ── Step 1: Credentials ───────────────────────────────────────────────────
+    const { serverUrl } = await inquirer_1.default.prompt([{
+            type: "input",
+            name: "serverUrl",
+            message: "Server URL",
+            default: DEFAULT_SERVER,
+            validate: (v) => {
+                try {
+                    new URL(v);
+                    return true;
+                }
+                catch {
+                    return "Please enter a valid URL";
+                }
+            },
+        }]);
+    const { projectId } = await inquirer_1.default.prompt([{
+            type: "input",
+            name: "projectId",
+            message: "Project ID",
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const { apiKey } = await inquirer_1.default.prompt([{
+            type: "password",
+            name: "apiKey",
+            message: "API Key  (x-cfx-key)",
+            mask: "●",
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const { adminSecret } = await inquirer_1.default.prompt([{
+            type: "password",
+            name: "adminSecret",
+            message: "Admin Secret  (x-admin-secret, needed for hosting)",
+            mask: "●",
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const cfg = {
+        serverUrl: serverUrl.replace(/\/+$/, ""),
+        projectId: projectId.trim(),
+        apiKey: apiKey.trim(),
+        adminSecret: adminSecret.trim(),
+        services: { database: false, auth: false, storage: false, hosting: false },
+    };
+    // ── Step 2: Connection test ───────────────────────────────────────────────
+    const connSpinner = (0, ora_1.default)("Testing connection…").start();
+    const ok = await (0, api_1.testConnection)(cfg);
+    if (ok) {
+        connSpinner.succeed(chalk_1.default.green("Connected to server"));
+    }
+    else {
+        connSpinner.warn(chalk_1.default.yellow("Could not reach server — config will be saved anyway"));
+    }
+    // ── Step 3: Services ──────────────────────────────────────────────────────
+    console.log();
+    const { services } = await inquirer_1.default.prompt([{
+            type: "checkbox",
+            name: "services",
+            message: "Which services will you use?",
+            choices: [
+                { name: "Database  — store and query documents", value: "database", checked: true },
+                { name: "Auth      — user sign-up / sign-in", value: "auth", checked: true },
+                { name: "Storage   — file uploads", value: "storage", checked: false },
+                { name: "Hosting   — deploy static sites", value: "hosting", checked: false },
+            ],
+        }]);
+    cfg.services = {
+        database: services.includes("database"),
+        auth: services.includes("auth"),
+        storage: services.includes("storage"),
+        hosting: services.includes("hosting"),
+    };
+    // ── Step 4: Hosting setup ─────────────────────────────────────────────────
+    if (cfg.services.hosting) {
+        await setupHosting(cfg, cwd);
+    }
+    // ── Step 5: Write config files ────────────────────────────────────────────
+    const configPath = (0, config_1.saveConfig)(cfg, cwd);
+    (0, config_1.ensureGitignore)(cwd);
+    (0, config_1.writeEnvExample)(cfg, cwd);
+    console.log();
+    console.log(chalk_1.default.green.bold("  ✓ Project initialised!"));
+    console.log();
+    console.log(chalk_1.default.dim(`  Config:      ${path_1.default.relative(cwd, configPath)}`));
+    console.log(chalk_1.default.dim("  Secrets:     clefbase.json has been added to .gitignore"));
+    console.log(chalk_1.default.dim("  Env example: .env.example created"));
+    console.log();
+    printUsageHint(cfg);
+}
+// ─── Hosting sub-flow ─────────────────────────────────────────────────────────
+async function setupHosting(cfg, cwd) {
+    console.log();
+    console.log(chalk_1.default.bold("  Hosting"));
+    console.log();
+    // Fetch existing sites
+    let existing = [];
+    const siteSpinner = (0, ora_1.default)("Fetching existing sites…").start();
+    try {
+        existing = await (0, api_1.listSites)(cfg);
+        siteSpinner.succeed(existing.length > 0
+            ? `Found ${existing.length} existing site(s)`
+            : "No sites yet — will create one");
+    }
+    catch {
+        siteSpinner.warn("Could not fetch sites — you can set this up later with `clefbase hosting:init`");
+        return;
+    }
+    let siteId = "";
+    let siteName = "";
+    if (existing.length > 0) {
+        const choices = [
+            ...existing.map(s => ({ name: `${s.name}  ${chalk_1.default.dim(s.id)}`, value: s.id })),
+            { name: chalk_1.default.cyan("+ Create a new site"), value: "__new__" },
+        ];
+        const { chosen } = await inquirer_1.default.prompt([{
+                type: "list",
+                name: "chosen",
+                message: "Which site should this project deploy to?",
+                choices,
+            }]);
+        if (chosen !== "__new__") {
+            siteId = chosen;
+            siteName = existing.find(s => s.id === chosen)?.name ?? chosen;
+        }
+    }
+    if (!siteId) {
+        const { newName } = await inquirer_1.default.prompt([{
+                type: "input",
+                name: "newName",
+                message: "Site name",
+                validate: (v) => v.trim().length > 0 || "Required",
+            }]);
+        const s = (0, ora_1.default)(`Creating site "${newName}"…`).start();
+        try {
+            const site = await (0, api_1.createSite)(cfg, newName.trim());
+            siteId = site.id;
+            siteName = site.name;
+            s.succeed(chalk_1.default.green(`Created "${siteName}"  ${chalk_1.default.dim(siteId)}`));
+        }
+        catch (err) {
+            s.fail(`Failed: ${err.message}`);
+            console.log(chalk_1.default.dim("  Run `clefbase hosting:init` to retry later."));
+            return;
+        }
+    }
+    const { distDir } = await inquirer_1.default.prompt([{
+            type: "input",
+            name: "distDir",
+            message: "Build output directory",
+            default: guessDistDir(cwd),
+            validate: (v) => v.trim().length > 0 || "Required",
+        }]);
+    const { entrypoint } = await inquirer_1.default.prompt([{
+            type: "input",
+            name: "entrypoint",
+            message: "HTML entrypoint",
+            default: "index.html",
+        }]);
+    cfg.hosting = {
+        siteId,
+        siteName,
+        distDir: distDir.trim(),
+        entrypoint: entrypoint.trim(),
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function guessDistDir(cwd) {
+    for (const c of ["dist", "build", "out", ".next", "public"]) {
+        if (fs_1.default.existsSync(path_1.default.join(cwd, c)))
+            return c;
+    }
+    return "dist";
+}
+function printUsageHint(cfg) {
+    const imports = ["initClefbase"];
+    if (cfg.services.database)
+        imports.push("getDatabase");
+    if (cfg.services.auth)
+        imports.push("getAuth");
+    if (cfg.services.storage)
+        imports.push("getStorage");
+    if (cfg.services.hosting)
+        imports.push("getHosting");
+    console.log(chalk_1.default.bold("  Quick start:"));
+    console.log();
+    console.log(chalk_1.default.cyan(`  import { ${imports.join(", ")} } from "clefbase";`));
+    console.log(chalk_1.default.cyan(`  import config from "./clefbase.json";`));
+    console.log();
+    console.log(chalk_1.default.cyan(`  const app = initClefbase(config);`));
+    if (cfg.services.database) {
+        console.log();
+        console.log(chalk_1.default.cyan(`  const db   = getDatabase(app);`));
+        console.log(chalk_1.default.cyan(`  const docs = await db.collection("items").getDocs();`));
+    }
+    if (cfg.services.auth) {
+        console.log();
+        console.log(chalk_1.default.cyan(`  const auth = getAuth(app);`));
+        console.log(chalk_1.default.cyan(`  const { user } = await auth.signIn("email", "pass");`));
+    }
+    if (cfg.services.hosting && cfg.hosting) {
+        console.log();
+        console.log(chalk_1.default.bold("  Deploy:"));
+        console.log(chalk_1.default.cyan(`  $ npm run build && clefbase deploy`));
+        console.log(chalk_1.default.dim(`  Site: ${cfg.serverUrl}/hosted/${cfg.projectId}/${cfg.hosting.siteId}`));
+    }
+    console.log();
+}

package/dist/cli-src/cli/config.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findConfigPath = findConfigPath;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.requireConfig = requireConfig;
+exports.ensureGitignore = ensureGitignore;
+exports.writeEnvExample = writeEnvExample;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// ─── File helpers ─────────────────────────────────────────────────────────────
+const CONFIG_FILE = "clefbase.json";
+/** Walk up the directory tree looking for clefbase.json (max 5 levels). */
+function findConfigPath(cwd = process.cwd()) {
+    let dir = cwd;
+    for (let i = 0; i < 6; i++) {
+        const candidate = path_1.default.join(dir, CONFIG_FILE);
+        if (fs_1.default.existsSync(candidate))
+            return candidate;
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function loadConfig(cwd = process.cwd()) {
+    const p = findConfigPath(cwd);
+    if (!p)
+        return null;
+    try {
+        return JSON.parse(fs_1.default.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveConfig(config, cwd = process.cwd()) {
+    const p = path_1.default.join(cwd, CONFIG_FILE);
+    fs_1.default.writeFileSync(p, JSON.stringify(config, null, 2) + "\n");
+    return p;
+}
+function requireConfig(cwd = process.cwd()) {
+    const config = loadConfig(cwd);
+    if (!config) {
+        throw new Error(`No ${CONFIG_FILE} found. Run "clefbase init" to set up this project.`);
+    }
+    return config;
+}
+// ─── Gitignore ────────────────────────────────────────────────────────────────
+/** Ensure clefbase.json (which contains secrets) is in .gitignore. */
+function ensureGitignore(cwd = process.cwd()) {
+    const p = path_1.default.join(cwd, ".gitignore");
+    const entry = "clefbase.json";
+    if (fs_1.default.existsSync(p)) {
+        const content = fs_1.default.readFileSync(p, "utf-8");
+        if (!content.split("\n").some(l => l.trim() === entry)) {
+            fs_1.default.appendFileSync(p, `\n# Clefbase config (contains secrets)\n${entry}\n`);
+        }
+    }
+    else {
+        fs_1.default.writeFileSync(p, `# Clefbase config (contains secrets)\n${entry}\n`);
+    }
+}
+// ─── .env.example ─────────────────────────────────────────────────────────────
+/** Write a .env.example if one doesn't already exist. */
+function writeEnvExample(cfg, cwd = process.cwd()) {
+    const p = path_1.default.join(cwd, ".env.example");
+    if (fs_1.default.existsSync(p))
+        return;
+    const lines = [
+        "# Clefbase — copy to .env and fill in your values",
+        `CLEFBASE_SERVER_URL=${cfg.serverUrl}`,
+        `CLEFBASE_PROJECT_ID=${cfg.projectId}`,
+        "CLEFBASE_API_KEY=your_api_key_here",
+        "CLEFBASE_ADMIN_SECRET=your_admin_secret_here",
+    ];
+    fs_1.default.writeFileSync(p, lines.join("\n") + "\n");
+}