@edge-base/cli 0.1.1

package/dist/commands/export.js

@@ -0,0 +1,142 @@
+import { Command } from 'commander';
+import { writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import chalk from 'chalk';
+import { isCliStructuredError, raiseCliError } from '../lib/agent-contract.js';
+import { spin } from '../lib/spinner.js';
+import { isJson, isQuiet } from '../lib/cli-context.js';
+import { promptText } from '../lib/prompts.js';
+import { fetchWithTimeout } from '../lib/fetch-with-timeout.js';
+import { resolveServiceKey, resolveServerUrl } from '../lib/resolve-options.js';
+/**
+ * `npx edgebase export` — Export table data as JSON.
+ *
+ * - `--format json` (only JSON supported)
+ * - `--table <name>` — Required: specific table to export
+ * - `--output <path>` — Output file path
+ * - `--url <url>` — Server URL (or EDGEBASE_URL env)
+ * - `--service-key <key>` — Service Key (or EDGEBASE_SERVICE_KEY env, or .edgebase/secrets.json)
+ *
+ * Uses Service Key authentication to call the backup export API endpoint.
+ * Authentication/URL resolution follows the same pattern as `backup` command.
+ */
+export const exportCommand = new Command('export')
+    .description('Export table data as JSON')
+    .option('--format <type>', 'Export format (only "json" supported)', 'json')
+    .option('--table <name>', 'Table to export')
+    .option('--output <path>', 'Output file path')
+    .option('--url <url>', 'Server URL (or EDGEBASE_URL env)')
+    .option('--service-key <key>', 'Service Key (or EDGEBASE_SERVICE_KEY env)')
+    .action(async (options) => {
+    const format = options.format.toLowerCase();
+    if (format !== 'json') {
+        raiseCliError({
+            code: 'export_format_unsupported',
+            field: 'format',
+            message: `Unsupported format: "${format}". Only "json" is currently supported.`,
+            hint: 'Rerun with --format json.',
+        });
+    }
+    // Interactive prompt for --table if missing (TTY only)
+    if (!options.table) {
+        options.table = await promptText('Which table to export?', undefined, {
+            field: 'table',
+            hint: 'Rerun with --table <name>.',
+            message: 'A table name is required before export can continue.',
+        });
+    }
+    // Resolve Service Key and URL via shared utilities
+    const serviceKey = resolveServiceKey(options);
+    const serverUrl = resolveServerUrl(options);
+    const tableName = options.table;
+    const defaultName = `${tableName}-export.json`;
+    const outputPath = resolve(options.output || `./${defaultName}`);
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    if (!isQuiet()) {
+        console.log(chalk.blue('📦 Exporting table data...'));
+        console.log(chalk.dim(`  Table: ${tableName}`));
+        console.log(chalk.dim(`  Format: ${format}`));
+        console.log(chalk.dim(`  Output: ${outputPath}`));
+        console.log();
+    }
+    // Call Export API endpoint (Service Key path)
+    const exportUrl = `${serverUrl.replace(/\/$/, '')}/admin/api/backup/export/${encodeURIComponent(tableName)}?format=json`;
+    const s = spin('Fetching data from server...');
+    try {
+        const response = await fetchWithTimeout(exportUrl, {
+            headers: {
+                'X-EdgeBase-Service-Key': serviceKey,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            let message;
+            try {
+                const parsed = JSON.parse(error);
+                message = parsed.message || error;
+            }
+            catch {
+                message = error;
+            }
+            s.fail(`Export failed (${response.status})`);
+            raiseCliError({
+                code: response.status === 404 ? 'export_table_not_found' : 'export_failed',
+                message,
+                hint: response.status === 401
+                    ? 'Check your Service Key. It may have been rotated.'
+                    : response.status === 404
+                        ? `Table "${tableName}" not found. Check the table name and retry.`
+                        : 'Check the server URL and ensure the server is running.',
+                details: {
+                    table: tableName,
+                    status: response.status,
+                },
+            });
+        }
+        const data = await response.text();
+        writeFileSync(outputPath, data, 'utf-8');
+        // Count records
+        let recordCount = 0;
+        try {
+            const parsed = JSON.parse(data);
+            recordCount = Array.isArray(parsed) ? parsed.length : 0;
+        }
+        catch { /* ignore */ }
+        s.succeed(`Exported ${recordCount} record(s) from "${tableName}"`);
+        // Show server notice if present (e.g., View table warning)
+        const notice = response.headers.get('x-edgebase-notice');
+        if (notice) {
+            console.log(chalk.yellow('⚠'), chalk.yellow(notice));
+        }
+        if (isJson()) {
+            console.log(JSON.stringify({
+                status: 'success',
+                table: tableName,
+                records: recordCount,
+                output: outputPath,
+            }));
+        }
+        else if (!isQuiet()) {
+            console.log(chalk.dim(`  → ${outputPath}`));
+        }
+    }
+    catch (err) {
+        if (isCliStructuredError(err))
+            throw err;
+        s.fail('Export failed');
+        raiseCliError({
+            code: 'export_failed',
+            message: err.message,
+            hint: 'Check the server URL and ensure the server is running.',
+            details: {
+                table: tableName,
+                output: outputPath,
+            },
+        });
+    }
+});
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * `edgebase init [dir]` — Project scaffolding.
+ * Creates edgebase.config.ts, functions/ directory, env files, and .gitignore.
+ */
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;GAGG;AACH,eAAO,MAAM,WAAW,SAqLpB,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,506 @@
+import { Command } from 'commander';
+import { randomBytes } from 'node:crypto';
+import { writeFileSync, mkdirSync, existsSync, chmodSync, readFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import { deriveProjectSlug, ensureLocalWranglerToml, ensureRuntimeScaffold } from '../lib/runtime-scaffold.js';
+/**
+ * `edgebase init [dir]` — Project scaffolding.
+ * Creates edgebase.config.ts, functions/ directory, env files, and .gitignore.
+ */
+export const initCommand = new Command('init')
+    .description('Initialize a new EdgeBase project')
+    .argument('[dir]', 'Project directory', '.')
+    .option('--no-dev', 'Skip automatically starting the dev server after scaffolding')
+    .option('--no-open', 'Do not open the Admin Dashboard when auto-starting the dev server')
+    .action(async (dir, options) => {
+    const projectDir = resolve(dir);
+    const localCliEntry = resolveLocalCliEntry(projectDir);
+    const edgebaseBin = localCliEntry ? `node ${localCliEntry}` : 'npx edgebase';
+    const needsPublishedPackages = localCliEntry === null;
+    console.log(chalk.blue('⚡ Initializing EdgeBase project...'));
+    console.log();
+    // Create project directory if needed
+    if (!existsSync(projectDir)) {
+        mkdirSync(projectDir, { recursive: true });
+    }
+    const configPath = join(projectDir, 'edgebase.config.ts');
+    // Create edgebase.config.ts template
+    if (!existsSync(configPath)) {
+        writeFileSync(configPath, CONFIG_TEMPLATE);
+        console.log(chalk.green('  ✓'), 'edgebase.config.ts');
+    }
+    else {
+        console.log(chalk.yellow('  ⏭'), 'edgebase.config.ts (already exists)');
+    }
+    const configDir = join(projectDir, 'config');
+    const rateLimitsPath = join(configDir, 'rate-limits.ts');
+    if (!existsSync(rateLimitsPath)) {
+        mkdirSync(configDir, { recursive: true });
+        writeFileSync(rateLimitsPath, RATE_LIMITS_TEMPLATE);
+        console.log(chalk.green('  ✓'), 'config/rate-limits.ts');
+    }
+    else {
+        console.log(chalk.yellow('  ⏭'), 'config/rate-limits.ts (already exists)');
+    }
+    // Create functions/ directory
+    const functionsDir = join(projectDir, 'functions');
+    if (!existsSync(functionsDir)) {
+        mkdirSync(functionsDir, { recursive: true });
+        // Create example function
+        writeFileSync(join(functionsDir, 'health.ts'), EXAMPLE_FUNCTION_TEMPLATE);
+        console.log(chalk.green('  ✓'), 'functions/health.ts');
+    }
+    else {
+        console.log(chalk.yellow('  ⏭'), 'functions/ (already exists)');
+    }
+    // Create .env.development for local development secrets
+    const envDevPath = join(projectDir, '.env.development');
+    if (!existsSync(envDevPath)) {
+        const devUserSecret = generateDevSecret();
+        const devAdminSecret = generateDevSecret();
+        writeFileSync(envDevPath, ENV_DEVELOPMENT_TEMPLATE
+            .replace('JWT_USER_SECRET=', `JWT_USER_SECRET=${devUserSecret}`)
+            .replace('JWT_ADMIN_SECRET=', `JWT_ADMIN_SECRET=${devAdminSecret}`));
+        console.log(chalk.green('  ✓'), '.env.development (JWT secrets auto-generated)');
+        // Also save to .edgebase/secrets.json for local key management
+        const edgebaseDir = join(projectDir, '.edgebase');
+        const secretsJsonPath = join(edgebaseDir, 'secrets.json');
+        if (!existsSync(edgebaseDir))
+            mkdirSync(edgebaseDir, { recursive: true });
+        writeFileSync(secretsJsonPath, JSON.stringify({ JWT_USER_SECRET: devUserSecret, JWT_ADMIN_SECRET: devAdminSecret }, null, 2), 'utf-8');
+        chmodSync(secretsJsonPath, 0o600);
+    }
+    // Create example env files (committed to repo for onboarding)
+    const envDevExamplePath = join(projectDir, '.env.development.example');
+    if (!existsSync(envDevExamplePath)) {
+        writeFileSync(envDevExamplePath, ENV_DEVELOPMENT_TEMPLATE);
+        console.log(chalk.green('  ✓'), '.env.development.example');
+    }
+    const envReleaseExamplePath = join(projectDir, '.env.release.example');
+    if (!existsSync(envReleaseExamplePath)) {
+        writeFileSync(envReleaseExamplePath, ENV_RELEASE_TEMPLATE);
+        console.log(chalk.green('  ✓'), '.env.release.example');
+    }
+    const packageJsonPath = join(projectDir, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        writeFileSync(packageJsonPath, PACKAGE_JSON_TEMPLATE(deriveProjectSlug(projectDir), localCliEntry, needsPublishedPackages));
+        console.log(chalk.green('  ✓'), 'package.json');
+    }
+    else {
+        const packageJsonChanged = ensureScaffoldPackageJson(packageJsonPath, deriveProjectSlug(projectDir), localCliEntry, needsPublishedPackages);
+        console.log(packageJsonChanged ? chalk.green('  ✓') : chalk.yellow('  ⏭'), packageJsonChanged ? 'package.json (updated)' : 'package.json (already exists)');
+    }
+    const wranglerPath = join(projectDir, 'wrangler.toml');
+    if (!existsSync(wranglerPath)) {
+        ensureLocalWranglerToml(projectDir);
+        console.log(chalk.green('  ✓'), 'wrangler.toml');
+    }
+    else {
+        console.log(chalk.yellow('  ⏭'), 'wrangler.toml (already exists)');
+    }
+    const gitignorePath = join(projectDir, '.gitignore');
+    const hadGitignore = existsSync(gitignorePath);
+    const gitignoreChanged = ensureScaffoldGitignore(gitignorePath);
+    console.log(gitignoreChanged ? chalk.green('  ✓') : chalk.yellow('  ⏭'), !hadGitignore
+        ? '.gitignore'
+        : gitignoreChanged
+            ? '.gitignore (updated)'
+            : '.gitignore (already exists)');
+    ensureRuntimeScaffold(projectDir);
+    console.log(chalk.green('  ✓'), '.edgebase/runtime scaffold');
+    console.log();
+    console.log(chalk.green('✨'), 'Project initialized!');
+    console.log();
+    // Auto-start dev server with admin dashboard
+    if (!options.dev) {
+        console.log(chalk.bold('Next steps:'));
+        console.log(`  1. Edit ${chalk.cyan('edgebase.config.ts')} to define your schema and auth settings`);
+        if (needsPublishedPackages && shouldShowInstallStep()) {
+            console.log(`  2. Run ${chalk.cyan(`'npm install'`)} to install the local EdgeBase CLI`);
+            console.log(`  3. Run ${chalk.cyan(`'${edgebaseBin} dev'`)} to start the local development server`);
+            console.log(`  4. Open the Admin Dashboard to explore your API`);
+            console.log(`  5. Read the docs: ${chalk.cyan('https://edgebase.fun/docs/getting-started/quickstart')}`);
+        }
+        else if (needsPublishedPackages) {
+            console.log(`  2. Run ${chalk.cyan(`'${edgebaseBin} dev'`)} to start the local development server`);
+            console.log(`  3. Open the Admin Dashboard to explore your API`);
+            console.log(`  4. Read the docs: ${chalk.cyan('https://edgebase.fun/docs/getting-started/quickstart')}`);
+        }
+        else {
+            console.log(`  2. Run ${chalk.cyan(`'${edgebaseBin} dev'`)} to start the local development server`);
+            console.log(`  3. Open the Admin Dashboard to explore your API`);
+            console.log(`  4. Read the docs: ${chalk.cyan('https://edgebase.fun/docs/getting-started/quickstart')}`);
+        }
+        console.log();
+        console.log(chalk.dim('When you\'re ready for production:'));
+        const publishedInstallStep = needsPublishedPackages && shouldShowInstallStep();
+        console.log(`  ${publishedInstallStep ? '6' : '5'}. Set ${chalk.cyan('release: true')} in edgebase.config.ts`);
+        console.log(`  ${publishedInstallStep ? '7' : '6'}. Run ${chalk.cyan(`'${edgebaseBin} deploy'`)} to deploy to Cloudflare`);
+        return;
+    }
+    console.log(chalk.bold('Next steps:'));
+    console.log(`  1. Edit ${chalk.cyan('edgebase.config.ts')} to define your schema and auth settings`);
+    console.log(`  2. Open the Admin Dashboard to explore your API`);
+    console.log(`  3. Read the docs: ${chalk.cyan('https://edgebase.fun/docs/getting-started/quickstart')}`);
+    console.log();
+    console.log(chalk.dim('When you\'re ready for production:'));
+    console.log(`  4. Set ${chalk.cyan('release: true')} in edgebase.config.ts`);
+    console.log(`  5. Run ${chalk.cyan(`'${edgebaseBin} deploy'`)} to deploy to Cloudflare`);
+    console.log();
+    console.log(chalk.blue('⚡'), 'Starting dev server...');
+    console.log();
+    // Run dev in the project directory (same process, no redundant npx spawn)
+    process.chdir(projectDir);
+    const { devCommand } = await import('./dev.js');
+    const devArgs = options.open ? [] : ['--no-open'];
+    await devCommand.parseAsync(devArgs, { from: 'user' });
+});
+function generateDevSecret() {
+    return randomBytes(32).toString('hex');
+}
+// ─── Templates ───
+const CONFIG_TEMPLATE = `import { defineConfig } from '@edge-base/shared';
+import { rateLimiting } from './config/rate-limits';
+
+export default defineConfig({
+  // release: false (default) — access policies are bypassed during development.
+  // Set release: true before production deployment to enable deny-by-default access.
+
+  databases: {
+    // Add your first DB block here, for example:
+    // app: {
+    //   tables: {
+    //     posts: {
+    //       schema: {
+    //         title: { type: 'string', required: true },
+    //         content: { type: 'text' },
+    //       },
+    //     },
+    //   },
+    // },
+  },
+
+  // Optional rooms use handlers.lifecycle / handlers.actions / handlers.timers:
+  // rooms: {
+  //   game: {
+  //     maxPlayers: 8,
+  //     handlers: {
+  //       lifecycle: {
+  //         onCreate(room) {
+  //           room.setSharedState(() => ({ status: 'waiting' }));
+  //         },
+  //       },
+  //       actions: {
+  //         PING: (_payload, room) => {
+  //           room.broadcast('PONG', { at: Date.now() });
+  //         },
+  //       },
+  //     },
+  //   },
+  // },
+
+  auth: {
+    emailAuth: true,
+  },
+
+  storage: {
+    buckets: {
+      uploads: {
+        // Uses the generated STORAGE R2 binding by default.
+        // Add access policies here when ready for production:
+        // access: {
+        //   read: () => true,
+        //   write: (auth) => auth !== null,
+        //   delete: (auth) => auth !== null,
+        // },
+      },
+    },
+  },
+
+  serviceKeys: {
+    keys: [
+      {
+        kid: 'root',
+        tier: 'root',
+        scopes: ['*'],
+        secretSource: 'dashboard',
+        secretRef: 'SERVICE_KEY',
+      },
+    ],
+  },
+
+  rateLimiting,
+
+  cors: {
+    origin: '*',
+  },
+});
+`;
+const RATE_LIMITS_TEMPLATE = `export const rateLimiting = {
+  global: {
+    requests: 10_000_000,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1001' },
+  },
+  db: {
+    requests: 100,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1002' },
+  },
+  storage: {
+    requests: 50,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1003' },
+  },
+  functions: {
+    requests: 50,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1004' },
+  },
+  auth: {
+    requests: 30,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1005' },
+  },
+  authSignin: {
+    requests: 10,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1006' },
+  },
+  authSignup: {
+    requests: 10,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1007' },
+  },
+  events: {
+    requests: 100,
+    window: '60s',
+    binding: { limit: 10_000_000, period: 60, namespaceId: '1008' },
+  },
+} as const;
+`;
+const EXAMPLE_FUNCTION_TEMPLATE = `import { defineFunction } from '@edge-base/shared';
+
+export const GET = defineFunction(async () => {
+  return Response.json({ ok: true });
+});
+`;
+const GITIGNORE_RULES = [
+    'node_modules/',
+    'dist/',
+    '.wrangler/',
+    '.wrangler.generated.*',
+    '.dev.vars',
+    '.env.development',
+    '.env.release',
+    '.edgebase/',
+    'edgebase.d.ts',
+    '*.local',
+];
+const GITIGNORE_TEMPLATE = `${GITIGNORE_RULES.join('\n')}\n`;
+function resolveLocalCliEntry(projectDir) {
+    let currentDir = resolve(projectDir);
+    while (true) {
+        const repoPackageJsonPath = join(currentDir, 'package.json');
+        const workspacePath = join(currentDir, 'pnpm-workspace.yaml');
+        const cliEntryPath = join(currentDir, 'packages', 'cli', 'dist', 'index.js');
+        if (existsSync(repoPackageJsonPath) && existsSync(workspacePath) && existsSync(cliEntryPath)) {
+            try {
+                const repoPackageJson = JSON.parse(readFileSync(repoPackageJsonPath, 'utf-8'));
+                if (repoPackageJson.name === 'edgebase') {
+                    return toPosixPath(relative(projectDir, cliEntryPath));
+                }
+            }
+            catch {
+                // Ignore malformed repo metadata and keep walking upward.
+            }
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+function toPosixPath(path) {
+    return path.replace(/\\/g, '/');
+}
+function readPackageJsonFromUrl(relativePath) {
+    try {
+        const packageJsonPath = fileURLToPath(new URL(relativePath, import.meta.url));
+        return JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function resolveScaffoldDependencyVersion(packageName) {
+    const cliPackageJson = readPackageJsonFromUrl('../../package.json');
+    const cliVersion = typeof cliPackageJson?.version === 'string' ? cliPackageJson.version : '0.1.0';
+    const cliDependencies = typeof cliPackageJson?.dependencies === 'object' && cliPackageJson.dependencies !== null
+        ? cliPackageJson.dependencies
+        : {};
+    const declaredVersion = cliDependencies[packageName];
+    if (typeof declaredVersion === 'string' && !declaredVersion.startsWith('workspace:')) {
+        return /^\d+\.\d+\.\d+(?:[-+].+)?$/.test(declaredVersion)
+            ? `^${declaredVersion}`
+            : declaredVersion;
+    }
+    if (packageName === '@edge-base/shared') {
+        const sharedPackageJson = readPackageJsonFromUrl('../../../shared/package.json');
+        if (typeof sharedPackageJson?.version === 'string') {
+            return `^${sharedPackageJson.version}`;
+        }
+    }
+    return `^${cliVersion}`;
+}
+const PACKAGE_JSON_TEMPLATE = (name, localCliEntry, needsPublishedPackages) => {
+    return `${JSON.stringify(buildPackageJsonObject(name, localCliEntry, needsPublishedPackages), null, 2)}\n`;
+};
+function buildPackageJsonObject(name, localCliEntry, needsPublishedPackages) {
+    const scriptPrefix = localCliEntry ? `node ${localCliEntry}` : 'edgebase';
+    const packageJson = {
+        name,
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: `${scriptPrefix} dev`,
+            deploy: `${scriptPrefix} deploy`,
+            typegen: `${scriptPrefix} typegen`,
+        },
+        engines: {
+            node: '^22.0.0 || ^24.0.0',
+        },
+    };
+    if (needsPublishedPackages) {
+        packageJson.devDependencies = {
+            '@edge-base/cli': resolveScaffoldDependencyVersion('@edge-base/cli'),
+            '@edge-base/shared': resolveScaffoldDependencyVersion('@edge-base/shared'),
+        };
+    }
+    return packageJson;
+}
+// ─── Env File Templates ───
+function shouldShowInstallStep() {
+    return process.env.EDGEBASE_BOOTSTRAP_WRAPPER !== '1';
+}
+function ensureScaffoldPackageJson(packageJsonPath, name, localCliEntry, needsPublishedPackages) {
+    let existing;
+    try {
+        existing = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    }
+    catch {
+        return false;
+    }
+    const generated = buildPackageJsonObject(name, localCliEntry, needsPublishedPackages);
+    let changed = false;
+    if (existing.name === undefined) {
+        existing.name = generated.name;
+        changed = true;
+    }
+    if (existing.private === undefined) {
+        existing.private = generated.private;
+        changed = true;
+    }
+    if (existing.type === undefined) {
+        existing.type = generated.type;
+        changed = true;
+    }
+    const existingScripts = ensureStringMap(existing, 'scripts');
+    for (const [key, value] of Object.entries(generated.scripts ?? {})) {
+        if (existingScripts[key] === undefined) {
+            existingScripts[key] = value;
+            changed = true;
+        }
+    }
+    const existingEngines = ensureStringMap(existing, 'engines');
+    if (generated.engines?.node && existingEngines.node === undefined) {
+        existingEngines.node = generated.engines.node;
+        changed = true;
+    }
+    if (needsPublishedPackages) {
+        const existingDependencies = ensureStringMap(existing, 'dependencies');
+        const existingDevDependencies = ensureStringMap(existing, 'devDependencies');
+        const existingPeerDependencies = ensureStringMap(existing, 'peerDependencies');
+        const existingOptionalDependencies = ensureStringMap(existing, 'optionalDependencies');
+        for (const [key, value] of Object.entries(generated.devDependencies ?? {})) {
+            if (existingDependencies[key] === undefined
+                && existingDevDependencies[key] === undefined
+                && existingPeerDependencies[key] === undefined
+                && existingOptionalDependencies[key] === undefined) {
+                existingDevDependencies[key] = value;
+                changed = true;
+            }
+        }
+    }
+    if (!changed) {
+        return false;
+    }
+    writeFileSync(packageJsonPath, `${JSON.stringify(existing, null, 2)}\n`, 'utf-8');
+    return true;
+}
+function ensureScaffoldGitignore(gitignorePath) {
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, GITIGNORE_TEMPLATE, 'utf-8');
+        return true;
+    }
+    const existing = readFileSync(gitignorePath, 'utf-8');
+    const existingRules = new Set(existing
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0));
+    const missingRules = GITIGNORE_RULES.filter((rule) => !existingRules.has(rule));
+    if (missingRules.length === 0) {
+        return false;
+    }
+    const prefix = existing.length === 0 || existing.endsWith('\n') ? '' : '\n';
+    writeFileSync(gitignorePath, `${existing}${prefix}${missingRules.join('\n')}\n`, 'utf-8');
+    return true;
+}
+function ensureStringMap(target, key) {
+    const current = target[key];
+    if (current && typeof current === 'object' && !Array.isArray(current)) {
+        return current;
+    }
+    const next = {};
+    target[key] = next;
+    return next;
+}
+const ENV_DEVELOPMENT_TEMPLATE = `# EdgeBase Development Environment Variables
+# This file is git-ignored. Copy from .env.development.example to get started.
+#
+# JWT secrets below are auto-generated by EdgeBase project scaffolding.
+# Add any development/test API keys below.
+
+JWT_USER_SECRET=
+JWT_ADMIN_SECRET=
+
+# Example: Stripe test keys
+# STRIPE_SECRET_KEY=sk_test_...
+# STRIPE_WEBHOOK_SECRET=whsec_...
+
+# Example: Email provider (Resend, etc.)
+# EMAIL_API_KEY=re_test_...
+`;
+const ENV_RELEASE_TEMPLATE = `# EdgeBase Production Environment Variables
+# This file is git-ignored. Copy from .env.release.example to get started.
+#
+# On \`edgebase deploy\`, these are auto-synced to Cloudflare Secrets.
+# SERVICE_KEY is auto-managed by the deploy pipeline — do not include it here.
+
+JWT_USER_SECRET=
+JWT_ADMIN_SECRET=
+
+# Database provider connection strings (only if using provider: 'neon' or 'postgres')
+# DB_POSTGRES_SHARED_URL=postgres://user:pass@host/db?sslmode=require
+
+# Example: Stripe live keys
+# STRIPE_SECRET_KEY=sk_live_...
+# STRIPE_WEBHOOK_SECRET=whsec_...
+
+# Example: Email provider (Resend, etc.)
+# EMAIL_API_KEY=re_...
+`;
+//# sourceMappingURL=init.js.map