@kardoe/quickback 0.4.0

package/dist/commands/compile.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Compile Command
+ *
+ * Loads configuration and features from disk, calls the remote compiler API,
+ * writes the generated files to the project root, and runs post-compile commands.
+ *
+ * Project structure:
+ *   my-app/
+ *   ├── quickback/
+ *   │   ├── quickback.config.ts
+ *   │   └── definitions/features/...
+ *   ├── src/                       ← compiled code written here
+ *   ├── supabase/migrations/       ← for Supabase provider
+ *   ├── drizzle/                   ← for D1/SQLite providers
+ *   └── package.json
+ */
+export declare function compile(): Promise<void>;
+//# sourceMappingURL=compile.d.ts.map

package/dist/commands/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAqI7C"}

package/dist/commands/compile.js

@@ -0,0 +1,144 @@
+/**
+ * Compile Command
+ *
+ * Loads configuration and features from disk, calls the remote compiler API,
+ * writes the generated files to the project root, and runs post-compile commands.
+ *
+ * Project structure:
+ *   my-app/
+ *   ├── quickback/
+ *   │   ├── quickback.config.ts
+ *   │   └── definitions/features/...
+ *   ├── src/                       ← compiled code written here
+ *   ├── supabase/migrations/       ← for Supabase provider
+ *   ├── drizzle/                   ← for D1/SQLite providers
+ *   └── package.json
+ */
+import { join, dirname } from 'path';
+import pc from 'picocolors';
+import ora from 'ora';
+import { callCompiler } from '../lib/api-client.js';
+import { loadConfig, loadFeatures, findConfigPath, findFeaturesDir, loadDrizzleMeta } from '../lib/file-loader.js';
+import { writeFilesWithMerge } from '../lib/file-writer.js';
+import { runCommand } from '../lib/shell.js';
+export async function compile() {
+    console.log(pc.bold('Quickback Compiler'));
+    console.log(pc.gray('Compiling via remote API...\n'));
+    const spinner = ora('Loading configuration...').start();
+    try {
+        // Find config file
+        const configPath = findConfigPath();
+        if (!configPath) {
+            spinner.fail('Configuration not found');
+            console.error(pc.red('Error: quickback.config.ts not found'));
+            console.log("Run 'quickback init' to create a new project structure");
+            process.exit(1);
+        }
+        // Determine project root (parent of quickback/ folder)
+        const quickbackDir = dirname(configPath);
+        const projectRoot = configPath.includes('/quickback/')
+            ? dirname(quickbackDir) // Config in quickback/ folder → parent is project root
+            : process.cwd(); // Config at cwd → cwd is project root
+        // Load config
+        const config = await loadConfig(configPath);
+        spinner.succeed(`Configuration loaded: ${pc.cyan(config.name)}`);
+        // Load features
+        spinner.start('Loading features...');
+        const featuresDir = findFeaturesDir();
+        const features = featuresDir ? await loadFeatures(featuresDir) : [];
+        spinner.succeed(`Loaded ${features.length} feature(s)`);
+        // Determine output directory first (needed for loading existing meta)
+        const outputDir = config.build?.outputDir
+            ? join(quickbackDir, config.build.outputDir)
+            : projectRoot;
+        // Load existing drizzle meta for incremental migrations
+        const drizzleMeta = loadDrizzleMeta(outputDir);
+        if (drizzleMeta) {
+            console.log(pc.gray(`  Found existing migration state (${Object.keys(drizzleMeta).length} files)`));
+        }
+        // Call remote compiler API
+        spinner.start('Compiling via Quickback API...');
+        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,
+                tables: f.tables,
+                resourceSource: f.resourceSource,
+                actionsSource: f.actionsSource,
+                handlerFiles: f.handlerFiles,
+            })),
+            // Include existing migration state for incremental migrations
+            existingFiles: drizzleMeta,
+        }); // Type assertion for existingFiles
+        spinner.succeed(`Compiled ${result.meta.fileCount} files (v${result.meta.version})`);
+        // Display warnings if any
+        if (result.warnings && result.warnings.length > 0) {
+            console.log(pc.yellow('\n⚠ Compilation warnings:'));
+            for (const warning of result.warnings) {
+                console.log(pc.yellow(`  • ${warning}`));
+            }
+            console.log();
+        }
+        spinner.start('Writing output...');
+        // Use merge strategy - don't wipe existing files, just update generated ones
+        writeFilesWithMerge(outputDir, result.files);
+        spinner.succeed(`Output written to ${pc.cyan(outputDir)}`);
+        // Run post-compile commands from providers
+        if (result.commands && result.commands.length > 0) {
+            console.log(pc.gray('\nRunning post-compile commands...\n'));
+            for (const cmd of result.commands) {
+                // Replace {{OUTPUT_DIR}} placeholder with actual path
+                const command = cmd.command.replace(/\{\{OUTPUT_DIR\}\}/g, outputDir);
+                // Determine working directory based on command's cwd setting
+                // 'output' means project root (where compiled code lives)
+                const commandCwd = cmd.cwd === 'output' ? outputDir : projectRoot;
+                spinner.start(cmd.description);
+                try {
+                    await runCommand(command, { cwd: commandCwd });
+                    spinner.succeed(cmd.description);
+                }
+                catch (error) {
+                    if (cmd.optional) {
+                        spinner.warn(`${cmd.description} (skipped)`);
+                    }
+                    else {
+                        spinner.fail(cmd.description);
+                        throw error;
+                    }
+                }
+            }
+        }
+        // Print next steps
+        console.log(pc.green('\n✔ Compilation complete!'));
+        console.log(`\nGenerated files for: ${pc.cyan(result.meta.features.join(', ') || 'no features')}`);
+        console.log('\nNext steps:');
+        console.log(pc.gray('  npm run dev'));
+    }
+    catch (error) {
+        spinner.fail('Compilation failed');
+        if (error instanceof Error) {
+            console.error(pc.red('\nError:'), error.message);
+            // Check for specific error types
+            if (error.message.includes('requires a Pro account')) {
+                console.log(pc.yellow('\nThis template requires a Pro account.'));
+                console.log('Run: quickback login');
+            }
+            else if (error.message.includes('fetch')) {
+                console.log(pc.yellow('\nCould not connect to the Quickback API.'));
+                console.log('Check your internet connection and try again.');
+            }
+        }
+        else {
+            console.error(pc.red('\nError:'), error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"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"}

package/dist/commands/create.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Create Command
+ *
+ * One-shot project creation with templates.
+ * Usage: quickback create <template> <app-name>
+ * Example: quickback create betterauth-d1-cloudflare my-app
+ */
+export interface CreateOptions {
+    template: string;
+    appName: string;
+    skipCloudflareSetup?: boolean;
+    skipInstall?: boolean;
+    skipMigrations?: boolean;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export declare function create(args: string[]): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+I1D"}