@edge-base/cli 0.1.1

package/dist/index.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+import { Command, CommanderError } from 'commander';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { initCommand } from './commands/init.js';
+import { devCommand } from './commands/dev.js';
+import { deployCommand } from './commands/deploy.js';
+import { destroyCommand } from './commands/destroy.js';
+import { secretCommand } from './commands/secret.js';
+import { keysCommand } from './commands/keys.js';
+import { backupCommand } from './commands/backup.js';
+import { exportCommand } from './commands/export.js';
+import { typegenCommand } from './commands/typegen.js';
+import { logsCommand } from './commands/logs.js';
+import { migrationCommand } from './commands/migration.js';
+import { migrateCommand } from './commands/migrate.js';
+import { upgradeCommand } from './commands/upgrade.js';
+import { seedCommand } from './commands/seed.js';
+import { adminCommand } from './commands/admin.js';
+import { neonCommand } from './commands/neon.js';
+import { dockerCommand } from './commands/docker.js';
+import { pluginsCommand } from './commands/plugins.js';
+import { createPluginCommand } from './commands/create-plugin.js';
+import { webhookTestCommand } from './commands/webhook-test.js';
+import { completionCommand } from './commands/completion.js';
+import { telemetryCommand } from './commands/telemetry.js';
+import { realtimeCommand } from './commands/realtime.js';
+import { describeCommand } from './commands/describe.js';
+import { setContext } from './lib/cli-context.js';
+import { isCliStructuredError, renderStructuredIssue } from './lib/agent-contract.js';
+import { checkForUpdates } from './lib/update-check.js';
+import { recordEvent, showTelemetryNoticeOnce } from './lib/telemetry.js';
+// ─── Dynamic version from package.json ───
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new Command();
+function hasRawFlag(rawArgs, longFlag, shortFlag) {
+    return rawArgs.some((arg) => {
+        if (arg === longFlag)
+            return true;
+        if (!shortFlag || !arg.startsWith('-') || arg.startsWith('--'))
+            return false;
+        return arg.slice(1).includes(shortFlag.slice(1));
+    });
+}
+program
+    .name('edgebase')
+    .description('EdgeBase CLI — Serverless BaaS on Cloudflare Edge')
+    .version(pkg.version)
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Suppress non-essential output')
+    .option('--json', 'Output results as JSON')
+    .option('--non-interactive', 'Disable prompts and return structured input/user-action requirements');
+// ─── First-run telemetry notice ───
+const rawArgs = process.argv.slice(2);
+setContext({
+    verbose: hasRawFlag(rawArgs, '--verbose', '-v'),
+    quiet: hasRawFlag(rawArgs, '--quiet', '-q'),
+    json: hasRawFlag(rawArgs, '--json'),
+    nonInteractive: hasRawFlag(rawArgs, '--non-interactive'),
+});
+showTelemetryNoticeOnce({
+    suppressOutput: hasRawFlag(rawArgs, '--json')
+        || hasRawFlag(rawArgs, '--quiet', '-q'),
+});
+// ─── Global hooks ───
+let _startTime = Date.now();
+let _telemetryCommandPath = null;
+function buildCommandPath(command) {
+    const names = [];
+    let current = command;
+    while (current) {
+        names.push(current.name());
+        current = current.parent;
+    }
+    return names.reverse().join(' ');
+}
+function resolveCommandPath(actionCommand, rawArgs = process.argv.slice(2)) {
+    if (actionCommand) {
+        return buildCommandPath(actionCommand);
+    }
+    const path = [program.name()];
+    let current = program;
+    for (const token of rawArgs) {
+        if (!token || token === '--')
+            break;
+        if (token.startsWith('-'))
+            continue;
+        const next = current.commands.find((candidate) => candidate.name() === token || candidate.aliases().includes(token));
+        if (!next) {
+            path.push(token);
+            break;
+        }
+        path.push(next.name());
+        current = next;
+    }
+    return path.join(' ');
+}
+program.exitOverride();
+program.hook('preAction', (thisCommand, actionCommand) => {
+    const opts = thisCommand.opts();
+    setContext({
+        verbose: !!opts.verbose,
+        quiet: !!opts.quiet,
+        json: !!opts.json,
+        nonInteractive: !!opts.nonInteractive,
+    });
+    _startTime = Date.now();
+    _telemetryCommandPath = resolveCommandPath(actionCommand);
+});
+program.hook('postAction', (_thisCommand, actionCommand) => {
+    _telemetryCommandPath = resolveCommandPath(actionCommand);
+    recordEvent(_telemetryCommandPath, true, Date.now() - _startTime);
+});
+// ─── Core ───
+program.addCommand(initCommand);
+program.addCommand(devCommand);
+program.addCommand(deployCommand);
+program.addCommand(destroyCommand);
+program.addCommand(logsCommand);
+program.addCommand(upgradeCommand);
+// ─── Database ───
+program.addCommand(migrationCommand);
+program.addCommand(migrateCommand);
+program.addCommand(seedCommand);
+program.addCommand(backupCommand);
+program.addCommand(exportCommand);
+program.addCommand(typegenCommand);
+program.addCommand(neonCommand);
+// ─── Security ───
+program.addCommand(secretCommand);
+program.addCommand(keysCommand);
+program.addCommand(adminCommand);
+// ─── Plugins & Tools ───
+program.addCommand(pluginsCommand);
+program.addCommand(createPluginCommand);
+program.addCommand(dockerCommand);
+program.addCommand(webhookTestCommand);
+program.addCommand(completionCommand);
+program.addCommand(describeCommand);
+program.addCommand(telemetryCommand);
+program.addCommand(realtimeCommand);
+// ─── Help Text Grouping ───
+program.addHelpText('after', `
+Commands by category:
+  Core:         init, dev (dv), deploy (dp), destroy, logs (l), upgrade (up)
+  Database:     migration (mg), migrate, seed, backup (bk), export, typegen (tg), neon
+  Security:     secret, keys, admin
+  Plugins:      plugins, create-plugin, docker, webhook-test
+  Utilities:    completion, describe, telemetry, realtime
+
+Environment variables:
+  NO_COLOR=1              Disable colored output
+  EDGEBASE_SERVICE_KEY    Service Key for backup/export/admin commands
+  EDGEBASE_URL            Default server URL for remote commands
+`);
+let parseFailed = false;
+try {
+    await program.parseAsync(process.argv);
+}
+catch (error) {
+    const commandPath = _telemetryCommandPath ?? resolveCommandPath(undefined, process.argv.slice(2));
+    recordEvent(commandPath, false, Date.now() - _startTime);
+    if (error instanceof CommanderError) {
+        parseFailed = true;
+        process.exitCode = error.exitCode;
+    }
+    else if (isCliStructuredError(error)) {
+        parseFailed = true;
+        process.exitCode = error.exitCode;
+        renderStructuredIssue(error.payload);
+    }
+    else {
+        throw error;
+    }
+}
+// ─── Post-run update check (non-blocking) ───
+const currentCommand = process.argv[2];
+if (!parseFailed && !['init', 'dev', 'dv'].includes(currentCommand ?? '')) {
+    checkForUpdates(pkg.version);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/agent-contract.d.ts

@@ -0,0 +1,36 @@
+export interface CliChoice {
+    label: string;
+    value: string;
+    hint?: string;
+    args?: string[];
+}
+export interface CliUserAction {
+    type: 'open_browser' | 'confirm' | 'rerun_with_flags';
+    title?: string;
+    message: string;
+    command?: string;
+    args?: string[];
+    instructions?: string[];
+}
+export interface CliStructuredIssue {
+    status: 'needs_input' | 'needs_user_action' | 'error';
+    code: string;
+    message: string;
+    field?: string;
+    hint?: string;
+    retryable?: boolean;
+    details?: Record<string, unknown> | unknown[];
+    choices?: CliChoice[];
+    action?: CliUserAction;
+}
+export declare class CliStructuredError extends Error {
+    readonly payload: CliStructuredIssue;
+    readonly exitCode: number;
+    constructor(payload: CliStructuredIssue, exitCode?: number);
+}
+export declare function isCliStructuredError(error: unknown): error is CliStructuredError;
+export declare function raiseNeedsInput(payload: Omit<CliStructuredIssue, 'status'>): never;
+export declare function raiseNeedsUserAction(payload: Omit<CliStructuredIssue, 'status'>): never;
+export declare function raiseCliError(payload: Omit<CliStructuredIssue, 'status'>, exitCode?: number): never;
+export declare function renderStructuredIssue(issue: CliStructuredIssue): void;
+//# sourceMappingURL=agent-contract.d.ts.map

package/dist/lib/agent-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../../src/lib/agent-contract.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,kBAAkB,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,GAAG,mBAAmB,GAAG,OAAO,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,kBAAkB,EAAE,QAAQ,SAAI;CAMtD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,KAAK,CAMlF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,KAAK,CAMvF;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,EAC3C,QAAQ,SAAI,GACX,KAAK,CAMP;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CA+CrE"}

package/dist/lib/agent-contract.js

@@ -0,0 +1,78 @@
+import chalk from 'chalk';
+import { isJson } from './cli-context.js';
+export class CliStructuredError extends Error {
+    payload;
+    exitCode;
+    constructor(payload, exitCode = 2) {
+        super(payload.message);
+        this.name = 'CliStructuredError';
+        this.payload = payload;
+        this.exitCode = exitCode;
+    }
+}
+export function isCliStructuredError(error) {
+    return error instanceof CliStructuredError;
+}
+export function raiseNeedsInput(payload) {
+    throw new CliStructuredError({
+        retryable: true,
+        ...payload,
+        status: 'needs_input',
+    });
+}
+export function raiseNeedsUserAction(payload) {
+    throw new CliStructuredError({
+        retryable: true,
+        ...payload,
+        status: 'needs_user_action',
+    });
+}
+export function raiseCliError(payload, exitCode = 1) {
+    throw new CliStructuredError({
+        retryable: false,
+        ...payload,
+        status: 'error',
+    }, exitCode);
+}
+export function renderStructuredIssue(issue) {
+    if (isJson()) {
+        console.log(JSON.stringify(issue));
+        return;
+    }
+    const icon = issue.status === 'error'
+        ? chalk.red('✗')
+        : chalk.yellow('⚠');
+    console.error(icon, issue.message);
+    if (issue.field) {
+        console.error(chalk.dim(`  Field: ${issue.field}`));
+    }
+    if (issue.hint) {
+        console.error(chalk.dim(`  Hint: ${issue.hint}`));
+    }
+    if (issue.details && !Array.isArray(issue.details) && Object.keys(issue.details).length > 0) {
+        console.error(chalk.dim(`  Details: ${JSON.stringify(issue.details)}`));
+    }
+    if (issue.choices && issue.choices.length > 0) {
+        console.error(chalk.dim('  Choices:'));
+        for (const choice of issue.choices) {
+            const argsText = choice.args && choice.args.length > 0
+                ? ` (${choice.args.join(' ')})`
+                : '';
+            const hintText = choice.hint ? ` — ${choice.hint}` : '';
+            console.error(chalk.dim(`    • ${choice.label}${argsText}${hintText}`));
+        }
+    }
+    if (issue.action) {
+        if (issue.action.title) {
+            console.error(chalk.dim(`  Action: ${issue.action.title}`));
+        }
+        console.error(chalk.dim(`  ${issue.action.message}`));
+        if (issue.action.command) {
+            console.error(chalk.dim(`  Command: ${issue.action.command}`));
+        }
+        for (const line of issue.action.instructions ?? []) {
+            console.error(chalk.dim(`  ${line}`));
+        }
+    }
+}
+//# sourceMappingURL=agent-contract.js.map

package/dist/lib/agent-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../../src/lib/agent-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA8B1C,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,OAAO,CAAqB;IAC5B,QAAQ,CAAS;IAE1B,YAAY,OAA2B,EAAE,QAAQ,GAAG,CAAC;QACnD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA2C;IACzE,MAAM,IAAI,kBAAkB,CAAC;QAC3B,SAAS,EAAE,IAAI;QACf,GAAG,OAAO;QACV,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA2C;IAC9E,MAAM,IAAI,kBAAkB,CAAC;QAC3B,SAAS,EAAE,IAAI;QACf,GAAG,OAAO;QACV,MAAM,EAAE,mBAAmB;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAA2C,EAC3C,QAAQ,GAAG,CAAC;IAEZ,MAAM,IAAI,kBAAkB,CAAC;QAC3B,SAAS,EAAE,KAAK;QAChB,GAAG,OAAO;QACV,MAAM,EAAE,OAAO;KAChB,EAAE,QAAQ,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO;QACnC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAChB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEtB,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5F,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACpD,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;gBAC/B,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/cf-auth.d.ts

@@ -0,0 +1,76 @@
+export interface CloudflareAuth {
+    accountId: string;
+    accountName: string;
+    authMethod: 'oauth' | 'api_token';
+}
+export interface CloudflareAccount {
+    name: string;
+    id: string;
+}
+/**
+ * Full Auth Gate: check auth → login if needed → extract account_id.
+ * Returns CloudflareAuth or exits the process on failure.
+ *
+ * Resolution order for account_id:
+ *   1. CLOUDFLARE_ACCOUNT_ID env var
+ *   2. .edgebase/cloudflare.json cache
+ *   3. wrangler.toml account_id field
+ *   4. wrangler whoami output
+ */
+export declare function ensureCloudflareAuth(projectDir: string, isTTY: boolean): Promise<CloudflareAuth>;
+/**
+ * Check if user is authenticated via `wrangler whoami`.
+ * Returns parsed account info or null if not authenticated.
+ *
+ * Checks in order:
+ *   1. CLOUDFLARE_ACCOUNT_ID env (+ verify via whoami if possible)
+ *   2. Cached .edgebase/cloudflare.json
+ *   3. wrangler.toml account_id
+ *   4. wrangler whoami output
+ */
+export declare function checkWranglerAuth(projectDir: string): CloudflareAuth | null;
+/**
+ * Parse `wrangler whoami` table output to extract account names and IDs.
+ *
+ * Wrangler outputs a pipe-delimited table like:
+ * ┌──────────────────┬──────────────────────────────────┐
+ * │ Account Name     │ Account ID                       │
+ * ├──────────────────┼──────────────────────────────────┤
+ * │ John's Account   │ abcdef1234567890abcdef1234567890 │
+ * └──────────────────┴──────────────────────────────────┘
+ */
+export declare function parseWhoamiOutput(output: string): CloudflareAccount[];
+/**
+ * Trigger `wrangler login` (browser OAuth flow).
+ * Only works in interactive terminals. Blocks until complete.
+ */
+export declare function triggerWranglerLogin(projectDir: string): boolean;
+/**
+ * Ensure wrangler.toml exists at project root with account_id.
+ * - If exists: inject/update account_id
+ * - If missing: create minimal template
+ *
+ * Returns the path to wrangler.toml.
+ */
+export declare function ensureWranglerToml(projectDir: string, accountId: string): string;
+/**
+ * Load cached account_id from .edgebase/cloudflare.json.
+ */
+export declare function loadCachedAccountId(projectDir: string): string | null;
+/**
+ * Save account_id to .edgebase/cloudflare.json.
+ */
+export declare function saveCachedAccountId(projectDir: string, accountId: string, accountName: string): void;
+/**
+ * Read the OAuth token from wrangler's local config file.
+ */
+export declare function readWranglerOauthToken(): string | null;
+/**
+ * Resolve a Cloudflare API token from env var or wrangler OAuth login.
+ * Used by deploy (to store as Worker secret) and realtime provisioning.
+ */
+export declare function resolveApiToken(): {
+    token: string;
+    source: 'env' | 'wrangler_oauth';
+};
+//# sourceMappingURL=cf-auth.d.ts.map

package/dist/lib/cf-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-auth.d.ts","sourceRoot":"","sources":["../../src/lib/cf-auth.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAID;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,cAAc,CAAC,CAiEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA+E3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAiBrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuChF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAcN;AAkBD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAUtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,gBAAgB,CAAA;CAAE,CAarF"}