@kardoe/quickback 0.4.0

package/dist/commands/create.js

@@ -0,0 +1,669 @@
+/**
+ * Create Command
+ *
+ * One-shot project creation with templates.
+ * Usage: quickback create <template> <app-name>
+ * Example: quickback create betterauth-d1-cloudflare my-app
+ */
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
+import { spawnSync } from "child_process";
+import pc from "picocolors";
+import ora from "ora";
+import prompts from "prompts";
+import { getTemplate, listTemplates, formatTemplateList, TEMPLATE_ALIASES, } from "../templates/registry.js";
+import { callCompiler } from "../lib/api-client.js";
+import { loadConfig, loadFeatures, findConfigPath, findFeaturesDir } from "../lib/file-loader.js";
+import { writeFiles } from "../lib/file-writer.js";
+// ============================================================================
+// Main Create Function
+// ============================================================================
+export async function create(args) {
+    console.log(pc.bold("\nQuickback Create") + pc.gray(" · One-shot project generator\n"));
+    try {
+        // Parse arguments
+        const options = await parseCreateArgs(args);
+        if (options.dryRun) {
+            await performDryRun(options);
+            return;
+        }
+        // Resolve template
+        const template = getTemplate(options.template);
+        if (!template) {
+            console.error(pc.red(`Unknown template: ${options.template}\n`));
+            console.log(formatTemplateList());
+            process.exit(1);
+        }
+        // Validate target directory
+        const targetDir = resolve(process.cwd(), options.appName);
+        if (existsSync(targetDir)) {
+            console.error(pc.red(`Directory already exists: ${options.appName}`));
+            console.log(pc.gray("Choose a different name or delete the existing directory."));
+            process.exit(1);
+        }
+        console.log(pc.cyan(`Creating ${template.name}...`));
+        console.log(pc.gray(`Template: ${options.template}`));
+        console.log(pc.gray(`Location: ${targetDir}\n`));
+        // Step 1: Create project directory
+        const spinner = ora("Creating project structure...").start();
+        mkdirSync(targetDir, { recursive: true });
+        mkdirSync(join(targetDir, "quickback"), { recursive: true });
+        mkdirSync(join(targetDir, "quickback", "definitions", "features", "todos"), { recursive: true });
+        spinner.succeed("Project structure created");
+        // Step 2: Generate config file
+        spinner.start("Generating configuration...");
+        generateConfigFile(targetDir, options.appName, template);
+        generateTodoFeature(targetDir);
+        generateAuthConfig(targetDir);
+        spinner.succeed("Configuration generated");
+        // Step 3: Setup Cloudflare resources (if applicable)
+        if (template.requiresCloudflare && !options.skipCloudflareSetup) {
+            await setupCloudflareResources(options.appName, targetDir, options.verbose);
+        }
+        // Step 4: Compile the project via remote API
+        spinner.start("Compiling via Quickback API...");
+        const quickbackDir = join(targetDir, "quickback");
+        const configPath = findConfigPath(quickbackDir);
+        if (!configPath) {
+            spinner.fail("Configuration not found");
+            throw new Error("Could not find quickback.config.ts");
+        }
+        const config = await loadConfig(configPath);
+        const featuresDir = findFeaturesDir(quickbackDir);
+        const features = featuresDir ? await loadFeatures(featuresDir) : [];
+        const result = await callCompiler({
+            config: {
+                name: config.name,
+                preset: config.preset,
+                template: config.template,
+                providers: config.providers,
+                build: config.build,
+            },
+            features: features.map((f) => ({
+                name: f.name,
+                schema: f.schema,
+                resource: f.resource,
+                actions: f.actions,
+            })),
+        });
+        // Write output files to project root
+        writeFiles(targetDir, result.files);
+        spinner.succeed(`Compiled ${result.meta.fileCount} files (v${result.meta.version})`);
+        // Step 5: Install dependencies
+        if (!options.skipInstall) {
+            spinner.start("Installing dependencies...");
+            // Prefer bun for bun templates (better peer dep handling)
+            const preferBun = template.preset === 'bun' || !template.requiresCloudflare;
+            const pm = detectPackageManager(preferBun);
+            const installResult = runCommand(pm, ["install"], targetDir, options.verbose);
+            if (installResult.success) {
+                spinner.succeed(`Dependencies installed with ${pm}`);
+            }
+            else {
+                spinner.warn("Dependency installation had issues");
+            }
+        }
+        // Step 6: Generate database schemas (drizzle-kit generate)
+        spinner.start("Generating database schemas...");
+        const schemaResult = runCommand("npx", ["drizzle-kit", "generate"], targetDir, options.verbose);
+        if (schemaResult.success) {
+            spinner.succeed("Database schemas generated");
+        }
+        else {
+            spinner.warn("Schema generation skipped (install dependencies first)");
+        }
+        // Step 7: Apply local migrations (for non-Cloudflare)
+        if (!template.requiresCloudflare && !options.skipMigrations) {
+            // Ensure data directory exists for SQLite
+            const dataDir = join(targetDir, "data");
+            if (!existsSync(dataDir)) {
+                mkdirSync(dataDir, { recursive: true });
+            }
+            spinner.start("Applying local migrations...");
+            const migrateResult = runCommand("npx", ["drizzle-kit", "migrate"], targetDir, options.verbose);
+            if (migrateResult.success) {
+                spinner.succeed("Local migrations applied");
+            }
+            else {
+                spinner.warn("Migrations skipped");
+            }
+        }
+        // Success!
+        printSuccessMessage(options.appName, template);
+    }
+    catch (error) {
+        console.error(pc.red("\nProject creation failed:"));
+        console.error(pc.red(String(error)));
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Argument Parsing
+// ============================================================================
+async function parseCreateArgs(args) {
+    let template;
+    let appName;
+    let skipCloudflareSetup = false;
+    let skipInstall = false;
+    let skipMigrations = false;
+    let dryRun = false;
+    let verbose = false;
+    // Parse flags and positional args
+    const positional = [];
+    for (const arg of args) {
+        if (arg === "--skip-cloudflare-setup" || arg === "--skip-cf") {
+            skipCloudflareSetup = true;
+        }
+        else if (arg === "--skip-install") {
+            skipInstall = true;
+        }
+        else if (arg === "--skip-migrations") {
+            skipMigrations = true;
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else if (arg === "--verbose" || arg === "-v") {
+            verbose = true;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === "--list" || arg === "-l") {
+            console.log(formatTemplateList());
+            process.exit(0);
+        }
+        else if (!arg.startsWith("-")) {
+            positional.push(arg);
+        }
+    }
+    // Extract template and appName from positional args
+    if (positional.length >= 2) {
+        template = positional[0];
+        appName = positional[1];
+    }
+    else if (positional.length === 1) {
+        // Could be template or app name - check if it's a known template
+        if (getTemplate(positional[0]) || TEMPLATE_ALIASES[positional[0]]) {
+            template = positional[0];
+        }
+        else {
+            appName = positional[0];
+        }
+    }
+    // Interactive prompts if needed
+    if (!template) {
+        const templates = listTemplates();
+        const response = await prompts({
+            type: "select",
+            name: "template",
+            message: "Choose a template",
+            choices: templates.map(t => ({
+                title: t.name,
+                description: t.description,
+                value: Object.entries(TEMPLATE_ALIASES).find(([_, v]) => v === Object.keys(TEMPLATE_ALIASES).find(k => getTemplate(k)?.name === t.name))?.[0] || t.name.toLowerCase().replace(/\s+/g, "-"),
+            })),
+        });
+        template = response.template;
+        if (!template) {
+            console.log(pc.yellow("\nOperation cancelled."));
+            process.exit(0);
+        }
+    }
+    if (!appName) {
+        const response = await prompts({
+            type: "text",
+            name: "appName",
+            message: "Project name",
+            validate: (v) => {
+                if (!v || v.trim().length === 0)
+                    return "Name is required";
+                if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(v)) {
+                    return "Use lowercase letters, numbers, and hyphens only";
+                }
+                return true;
+            },
+        });
+        appName = response.appName;
+        if (!appName) {
+            console.log(pc.yellow("\nOperation cancelled."));
+            process.exit(0);
+        }
+    }
+    return {
+        template: template,
+        appName: appName,
+        skipCloudflareSetup,
+        skipInstall,
+        skipMigrations,
+        dryRun,
+        verbose,
+    };
+}
+// ============================================================================
+// File Generation
+// ============================================================================
+function generateConfigFile(targetDir, appName, template) {
+    // Generate providers based on template preset
+    const providers = getProvidersForPreset(template.preset);
+    const configContent = `/**
+ * Quickback Configuration
+ * Generated by: quickback create ${template.preset} ${appName}
+ *
+ * Project structure:
+ *   ${appName}/
+ *   ├── quickback/              ← definitions live here
+ *   │   ├── quickback.config.ts
+ *   │   └── definitions/features/...
+ *   ├── src/                    ← compiled code
+ *   ├── drizzle/                ← migrations (or supabase/migrations/)
+ *   └── package.json
+ *
+ * Run 'quickback compile' to regenerate after editing definitions.
+ */
+
+export default {
+    name: "${appName}",
+    template: "hono",
+    providers: ${JSON.stringify(providers, null, 8).replace(/^/gm, '    ').trim()},
+};
+`;
+    writeFileSync(join(targetDir, "quickback", "quickback.config.ts"), configContent);
+}
+function getProvidersForPreset(preset) {
+    switch (preset) {
+        case "bun":
+            return {
+                runtime: { name: "bun", config: {} },
+                database: { name: "bun-sqlite", config: { path: "./data/app.db" } },
+                auth: { name: "better-auth", config: {} },
+            };
+        case "cloudflare":
+            return {
+                runtime: { name: "cloudflare", config: {} },
+                database: { name: "cloudflare-d1", config: { binding: "DB" } },
+                auth: { name: "better-auth", config: {} },
+            };
+        case "turso":
+            return {
+                runtime: { name: "bun", config: {} },
+                database: { name: "libsql", config: {} },
+                auth: { name: "better-auth", config: {} },
+            };
+        default:
+            return {
+                runtime: { name: "bun", config: {} },
+                database: { name: "bun-sqlite", config: {} },
+                auth: { name: "better-auth", config: {} },
+            };
+    }
+}
+function generateTodoFeature(targetDir) {
+    // Schema with all fields required for security pillars
+    const schemaContent = `/**
+ * Todo Feature Schema
+ * Demonstrates all 4 Security Pillars: Firewall, Guards, Safety, Masking
+ */
+import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
+
+export const todos = sqliteTable("todos", {
+    // Primary key
+    id: text("id").primaryKey().notNull(),
+
+    // Business fields
+    title: text("title").notNull(),
+    description: text("description"),
+    completed: integer("completed", { mode: "boolean" }).default(false),
+    priority: text("priority").default("medium"), // low, medium, high
+    dueDate: integer("due_date", { mode: "timestamp" }),
+
+    // Ownership (for Firewall)
+    organizationId: text("organization_id").notNull(),
+    ownerId: text("owner_id").notNull(),
+
+    // Audit trail (for Safety - immutable fields)
+    createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+    createdBy: text("created_by").notNull(),
+    modifiedAt: integer("modified_at", { mode: "timestamp" }).notNull(),
+    modifiedBy: text("modified_by").notNull(),
+
+    // Soft delete (for Firewall)
+    deletedAt: integer("deleted_at", { mode: "timestamp" }),
+});
+`;
+    // Resource definition with all 4 security pillars
+    const resourceContent = `/**
+ * Todo Resource Definition
+ * Demonstrates all 4 Security Pillars
+ */
+export default {
+    name: "todos",
+    schema: "./schema",
+
+    // =========================================================================
+    // PILLAR 1: FIREWALL
+    // Controls data isolation at the query level
+    // =========================================================================
+    firewall: {
+        organization: {
+            column: "organizationId",
+            source: "ctx.activeOrgId",
+        },
+        owner: {
+            column: "ownerId",
+            source: "ctx.userId",
+            mode: "optional", // Can filter by owner when needed
+        },
+        softDelete: {
+            column: "deletedAt",
+        },
+    },
+
+    // =========================================================================
+    // PILLAR 2: GUARDS (via CRUD config)
+    // Controls who can perform which operations
+    // =========================================================================
+    crud: {
+        list: {
+            guard: { roles: ["member", "admin"] },
+        },
+        get: {
+            guard: { roles: ["member", "admin"] },
+        },
+        create: {
+            guard: { roles: ["member", "admin"] },
+        },
+        update: {
+            guard: { roles: ["member", "admin"], record: { ownerId: { equals: "$ctx.userId" } } },
+        },
+        delete: {
+            guard: { roles: ["admin"] },
+            mode: "soft",
+        },
+    },
+
+    // =========================================================================
+    // PILLAR 3: SAFETY
+    // Protects data integrity with field-level validation
+    // =========================================================================
+    safety: {
+        // Fields that can be set on create
+        createable: [
+            "title",
+            "description",
+            "completed",
+            "priority",
+            "dueDate",
+        ],
+        // Fields that can be modified on update
+        updatable: [
+            "title",
+            "description",
+            "completed",
+            "priority",
+            "dueDate",
+        ],
+        // Fields that can never be changed after creation
+        immutable: [
+            "id",
+            "organizationId",
+            "ownerId",
+            "createdAt",
+            "createdBy",
+        ],
+    },
+
+    // =========================================================================
+    // PILLAR 4: MASKING
+    // Controls what data is visible based on context
+    // =========================================================================
+    masking: {
+        // Hide description for non-owners (privacy)
+        description: {
+            type: "redact",
+            show: {
+                roles: ["admin"],
+                or: "owner",
+            },
+        },
+    },
+};
+`;
+    // Actions definition for custom business logic
+    const actionsContent = `/**
+ * Todo Actions Definition
+ * Custom business logic with security guards
+ *
+ * Input schemas use JSON Schema format which gets converted to Zod at compile time.
+ */
+export default {
+    name: "todos",
+    schema: "./schema",
+
+    actions: {
+        // Mark a todo as complete
+        complete: {
+            description: "Mark todo as complete",
+            input: {
+                type: "object",
+                properties: {
+                    completedAt: { type: "string", format: "datetime", optional: true },
+                },
+            },
+            guard: {
+                roles: ["owner", "member", "admin"],
+                record: { completed: { equals: false } },
+            },
+            sideEffects: "sync",
+        },
+
+        // Mark a todo as incomplete
+        uncomplete: {
+            description: "Mark todo as incomplete",
+            input: { type: "object", properties: {} },
+            guard: {
+                roles: ["owner", "member", "admin"],
+                record: { completed: { equals: true } },
+            },
+            sideEffects: "sync",
+        },
+    },
+};
+`;
+    const featureDir = join(targetDir, "quickback", "definitions", "features", "todos");
+    writeFileSync(join(featureDir, "schema.ts"), schemaContent);
+    writeFileSync(join(featureDir, "resource.ts"), resourceContent);
+    writeFileSync(join(featureDir, "actions.ts"), actionsContent);
+}
+function generateAuthConfig(targetDir) {
+    const authContent = `/**
+ * Better Auth Configuration
+ */
+export default {
+    emailAndPassword: {
+        enabled: true,
+        requireEmailVerification: false,
+    },
+    plugins: ["anonymous"],
+    session: {
+        expiresInDays: 7,
+        updateAgeInDays: 1,
+    },
+    database: {
+        usePlural: true,
+        debugLogs: true,
+    },
+};
+`;
+    mkdirSync(join(targetDir, "quickback", "definitions", "auth", "better-auth"), { recursive: true });
+    writeFileSync(join(targetDir, "quickback", "definitions", "auth", "better-auth", "config.ts"), authContent);
+}
+// ============================================================================
+// Cloudflare Setup
+// ============================================================================
+async function setupCloudflareResources(appName, targetDir, verbose) {
+    const spinner = ora("Setting up Cloudflare resources...").start();
+    // Check if wrangler is available
+    const wranglerCheck = spawnSync("npx", ["wrangler", "--version"], { encoding: "utf-8" });
+    if (wranglerCheck.status !== 0) {
+        spinner.warn("Wrangler not available - skipping Cloudflare setup");
+        console.log(pc.gray("  Install wrangler and run: npx wrangler d1 create " + appName + "-db"));
+        return;
+    }
+    // Check authentication
+    const whoami = spawnSync("npx", ["wrangler", "whoami"], { encoding: "utf-8" });
+    if (whoami.status !== 0 || whoami.stdout.includes("not authenticated")) {
+        spinner.warn("Not authenticated with Cloudflare - skipping resource creation");
+        console.log(pc.gray("  Run 'npx wrangler login' first, then create resources manually."));
+        return;
+    }
+    // Create D1 database
+    spinner.text = `Creating D1 database: ${appName}-db`;
+    const d1Result = spawnSync("npx", ["wrangler", "d1", "create", `${appName}-db`], { encoding: "utf-8", cwd: targetDir });
+    if (d1Result.status === 0) {
+        // Extract database ID from output
+        const dbIdMatch = d1Result.stdout.match(/database_id\s*=\s*"([^"]+)"/);
+        if (dbIdMatch) {
+            spinner.succeed(`D1 database created: ${appName}-db (${dbIdMatch[1]})`);
+        }
+        else {
+            spinner.succeed(`D1 database created: ${appName}-db`);
+        }
+    }
+    else if (d1Result.stderr.includes("already exists")) {
+        spinner.info(`D1 database already exists: ${appName}-db`);
+    }
+    else {
+        spinner.warn("D1 database creation failed");
+        if (verbose) {
+            console.log(pc.gray(d1Result.stderr));
+        }
+    }
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function runCommand(cmd, args, cwd, verbose) {
+    const result = spawnSync(cmd, args, {
+        cwd,
+        encoding: "utf-8",
+        stdio: verbose ? "inherit" : "pipe",
+    });
+    return {
+        success: result.status === 0,
+        stdout: result.stdout || "",
+        stderr: result.stderr || "",
+    };
+}
+function detectPackageManager(preferBun = false) {
+    // Check for existing lockfiles first
+    if (existsSync("bun.lockb"))
+        return "bun";
+    if (existsSync("pnpm-lock.yaml"))
+        return "pnpm";
+    if (existsSync("yarn.lock"))
+        return "yarn";
+    // If preferBun and bun is available, use it (better peer dep handling)
+    if (preferBun) {
+        try {
+            const result = spawnSync("bun", ["--version"], { encoding: "utf-8" });
+            if (result.status === 0)
+                return "bun";
+        }
+        catch {
+            // bun not available, fall through
+        }
+    }
+    return "npm";
+}
+function performDryRun(options) {
+    const template = getTemplate(options.template);
+    console.log(pc.bold("Dry Run - No changes will be made\n"));
+    console.log(pc.cyan("Configuration:"));
+    console.log(`  Template:     ${options.template}${template ? ` (${template.name})` : ""}`);
+    console.log(`  App Name:     ${options.appName}`);
+    console.log(`  Target Dir:   ${resolve(process.cwd(), options.appName)}`);
+    console.log("");
+    console.log(pc.cyan("Steps that would be executed:"));
+    console.log("  1. Create project directory structure");
+    console.log("  2. Generate quickback.config.ts");
+    console.log("  3. Generate feature definitions");
+    if (template?.requiresCloudflare && !options.skipCloudflareSetup) {
+        console.log("  4. Create Cloudflare D1 database");
+    }
+    else {
+        console.log("  4. [SKIP] Cloudflare setup");
+    }
+    console.log("  5. Compile project (quickback compile)");
+    if (!options.skipInstall) {
+        console.log("  6. Install dependencies");
+    }
+    else {
+        console.log("  6. [SKIP] Install dependencies");
+    }
+    console.log("  7. Generate database schemas");
+    if (!template?.requiresCloudflare && !options.skipMigrations) {
+        console.log("  8. Apply local migrations");
+    }
+    else {
+        console.log("  8. [SKIP] Local migrations");
+    }
+    console.log(pc.green("\nDry run complete. Remove --dry-run to execute."));
+}
+function printSuccessMessage(appName, template) {
+    console.log("");
+    console.log(pc.green("✔ Project created successfully!"));
+    console.log("");
+    console.log(pc.bold("Next steps:"));
+    console.log(pc.cyan(`  cd ${appName}`));
+    console.log(pc.cyan("  npm run dev"));
+    console.log("");
+    if (template.requiresCloudflare) {
+        console.log(pc.bold("Deploy to Cloudflare:"));
+        console.log(pc.cyan("  npm run deploy"));
+        console.log("");
+    }
+    console.log(pc.bold("Useful commands:"));
+    console.log("  npm run dev              " + pc.gray("Start development server"));
+    console.log("  quickback compile        " + pc.gray("Regenerate after editing definitions"));
+    console.log("  npx drizzle-kit generate " + pc.gray("Generate new migrations"));
+    console.log("  npx drizzle-kit migrate  " + pc.gray("Apply database migrations"));
+    if (template.requiresCloudflare) {
+        console.log("  npm run deploy           " + pc.gray("Deploy to Cloudflare Workers"));
+    }
+    console.log("");
+    console.log(pc.bold("Project structure:"));
+    console.log(pc.gray(`  ${appName}/`));
+    console.log(pc.gray("  ├── quickback/           ← edit definitions here"));
+    console.log(pc.gray("  ├── src/                 ← generated API code"));
+    console.log(pc.gray("  └── drizzle/             ← database migrations"));
+    console.log("");
+}
+function printHelp() {
+    console.log(`
+${pc.bold("quickback create")} - Create a new Quickback project
+
+${pc.bold("Usage:")}
+  quickback create <template> <app-name>
+  quickback create <app-name>              ${pc.gray("(interactive template selection)")}
+
+${pc.bold("Examples:")}
+  quickback create betterauth-d1-cloudflare my-app
+  quickback create cloudflare my-app       ${pc.gray("(alias)")}
+  quickback create bun my-app              ${pc.gray("(local development)")}
+
+${pc.bold("Options:")}
+  --skip-cloudflare-setup   Skip automatic Cloudflare resource creation
+  --skip-install            Skip npm/bun install
+  --skip-migrations         Skip database migrations
+  --dry-run                 Preview what would be created
+  --verbose, -v             Show detailed output
+  --list, -l                List available templates
+  --help, -h                Show this help
+
+${pc.bold("Templates:")}
+${formatTemplateList()}
+`);
+}
+//# sourceMappingURL=create.js.map