@heramb1/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { deployCommand } from './commands/deploy.js';
+import { statusCommand } from './commands/status.js';
+import { envPushCommand, envPullCommand } from './commands/env.js';
+import { wsTestCommand } from './commands/ws.js';
+import { logsCommand } from './commands/logs.js';
+import { migrateCommand } from './commands/migrate.js';
+import { planCommand } from './commands/plan.js';
+const program = new Command();
+program
+    .name('heramb')
+    .description('Removes deploy obstacles — orchestration across any platform')
+    .version('0.1.0');
+program
+    .command('plan')
+    .description('Scan project and recommend deployment platforms')
+    .action(planCommand);
+program
+    .command('init')
+    .description('Detect stack, create config, validate tokens')
+    .action(initCommand);
+program
+    .command('deploy')
+    .description('Full orchestrated deploy')
+    .option('--backend-only', 'Skip frontend deploy')
+    .option('--frontend-only', 'Skip backend and Redis')
+    .option('--env <environment>', 'Deploy environment: production or preview', 'production')
+    .option('--branch <name>', 'Git branch for preview deploys')
+    .action((opts) => deployCommand({
+    backendOnly: opts.backendOnly,
+    frontendOnly: opts.frontendOnly,
+    env: opts.env === 'preview' ? 'preview' : 'production',
+    branch: opts.branch,
+}));
+program
+    .command('status')
+    .description('Unified status across all providers')
+    .action(statusCommand);
+const envCmd = program.command('env').description('Sync environment variables');
+envCmd
+    .command('push')
+    .description('Sync local .env to all services')
+    .action(envPushCommand);
+envCmd
+    .command('pull')
+    .description('Pull remote env vars to local .env')
+    .action(envPullCommand);
+const wsCmd = program.command('ws').description('WebSocket utilities');
+wsCmd
+    .command('test [url]')
+    .description('WebSocket smoke test')
+    .action(wsTestCommand);
+program
+    .command('logs <service>')
+    .description('Tail logs from a service')
+    .action(logsCommand);
+program
+    .command('migrate [service]')
+    .description('Move a service to another provider')
+    .option('--from <provider>', 'Source provider (e.g. heroku)')
+    .option('--to <provider>', 'Target provider (e.g. render)')
+    .option('--dry-run', 'Show migration plan without changing config')
+    .action((service, opts) => migrateCommand({
+    service,
+    from: opts.from,
+    to: opts.to,
+    dryRun: opts.dryRun,
+}));
+program.parse();
+//# 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/utils/config.d.ts

@@ -0,0 +1,6 @@
+import { type HerambConfig } from '@heramb1/core';
+export declare function findConfigPath(cwd?: string): string;
+export declare function loadHerambConfig(cwd?: string): HerambConfig;
+export declare function saveHerambConfig(config: HerambConfig, cwd?: string): void;
+export declare function configExists(cwd?: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAI9D,wBAAgB,cAAc,CAAC,GAAG,SAAgB,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,SAAgB,GAAG,YAAY,CAOlE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,SAAgB,GAAG,IAAI,CAGhF;AAED,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,OAAO,CAEzD"}

package/dist/utils/config.js

@@ -0,0 +1,23 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadConfig } from '@heramb1/core';
+const CONFIG_FILE = 'heramb.config.json';
+export function findConfigPath(cwd = process.cwd()) {
+    return resolve(cwd, CONFIG_FILE);
+}
+export function loadHerambConfig(cwd = process.cwd()) {
+    const path = findConfigPath(cwd);
+    if (!existsSync(path)) {
+        throw new Error(`No ${CONFIG_FILE} found — run \`heramb init\` first`);
+    }
+    const raw = JSON.parse(readFileSync(path, 'utf-8'));
+    return loadConfig(raw);
+}
+export function saveHerambConfig(config, cwd = process.cwd()) {
+    const path = findConfigPath(cwd);
+    writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+}
+export function configExists(cwd = process.cwd()) {
+    return existsSync(findConfigPath(cwd));
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAChD,OAAO,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAClD,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW,oCAAoC,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACxE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9C,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/connect.d.ts

@@ -0,0 +1,7 @@
+import type { StackDetection } from '@heramb1/core';
+export declare function connectProviders(providers: string[], options?: {
+    skipExisting?: boolean;
+}): Promise<string[]>;
+export declare function providersForStack(stack: StackDetection): string[];
+export declare function promptProviderConnect(provider: string): Promise<void>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/utils/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/utils/connect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CASjE;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF3E"}

package/dist/utils/connect.js

@@ -0,0 +1,101 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { buildDeployPlan, getProvider, providersNeededForPlan, topProviderForRole, deriveRequirements } from '@heramb1/core';
+import { saveCredential, getProviderToken } from './credentials.js';
+export async function connectProviders(providers, options) {
+    const connected = [];
+    for (const provider of providers) {
+        if (options?.skipExisting && getProviderToken(provider)) {
+            connected.push(provider);
+            continue;
+        }
+        await promptProviderConnect(provider);
+        connected.push(provider);
+    }
+    return connected;
+}
+export function providersForStack(stack) {
+    const plan = buildDeployPlan(stack);
+    const req = deriveRequirements(stack);
+    const choices = {
+        frontend: topProviderForRole('frontend', req)?.provider ?? '',
+        backend: topProviderForRole('backend', req)?.provider ?? '',
+        cache: topProviderForRole('cache', req)?.provider ?? '',
+    };
+    return providersNeededForPlan(plan, choices);
+}
+export async function promptProviderConnect(provider) {
+    const guide = getProvider(provider);
+    if (!guide) {
+        throw new Error(`Unknown provider: ${provider}`);
+    }
+    if (getProviderToken(provider)) {
+        console.log(chalk.green('✓') + ` ${guide.name} already connected`);
+        return;
+    }
+    console.log(chalk.cyan(`\n→ Connect ${guide.name}`));
+    console.log(chalk.dim(`  Sign up:  ${guide.signupUrl}`));
+    console.log(chalk.dim(`  Get key:  ${guide.tokenUrl}\n`));
+    const { hasAccount } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'hasAccount',
+            message: `Do you already have a ${guide.name} account?`,
+            default: false,
+        },
+    ]);
+    if (!hasAccount) {
+        console.log(chalk.yellow('⚠') +
+            ` Create your account at ${chalk.underline(guide.signupUrl)} then paste your API key below.`);
+    }
+    switch (provider) {
+        case 'upstash': {
+            const { email, apiKey } = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'email',
+                    message: 'Upstash account email:',
+                    validate: (v) => v.includes('@') || 'Valid email required',
+                },
+                {
+                    type: 'password',
+                    name: 'apiKey',
+                    message: 'Upstash API key:',
+                    validate: (v) => v.length > 0 || 'API key required',
+                },
+            ]);
+            saveCredential('upstash', { email, apiKey, token: apiKey });
+            break;
+        }
+        case 'vercel': {
+            const { token, teamId } = await inquirer.prompt([
+                {
+                    type: 'password',
+                    name: 'token',
+                    message: 'Vercel API token:',
+                    validate: (v) => v.length > 0 || 'Token required',
+                },
+                {
+                    type: 'input',
+                    name: 'teamId',
+                    message: 'Vercel team ID (optional):',
+                },
+            ]);
+            saveCredential('vercel', { token, ...(teamId ? { teamId } : {}) });
+            break;
+        }
+        default: {
+            const { token } = await inquirer.prompt([
+                {
+                    type: 'password',
+                    name: 'token',
+                    message: `${guide.name} API token:`,
+                    validate: (v) => v.length > 0 || 'Token required',
+                },
+            ]);
+            saveCredential(provider, { token });
+        }
+    }
+    console.log(chalk.green('✓') + ` ${guide.name} connected`);
+}
+//# sourceMappingURL=connect.js.map

package/dist/utils/connect.js.map

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

package/dist/utils/credentials.d.ts

@@ -0,0 +1,8 @@
+import type { Credentials } from '@heramb1/core';
+export declare function loadCredentials(): Credentials;
+export declare function saveCredential(provider: string, data: Record<string, string>): void;
+export declare function getProviderToken(provider: string): string | undefined;
+export declare function getProviderCredential(provider: string, field: string): string | undefined;
+export declare function requireProviderToken(provider: string): string;
+export declare function getCredentialsPath(): string;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/utils/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AASjD,wBAAgB,eAAe,IAAI,WAAW,CAE7C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAInF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBrE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYzF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/utils/credentials.js

@@ -0,0 +1,56 @@
+import Conf from 'conf';
+const store = new Conf({
+    projectName: 'heramb',
+    cwd: `${process.env.HOME ?? process.env.USERPROFILE}/.heramb`,
+    configName: 'keys',
+    defaults: { keys: {} },
+});
+export function loadCredentials() {
+    return store.get('keys');
+}
+export function saveCredential(provider, data) {
+    const keys = loadCredentials();
+    keys[provider] = { ...keys[provider], ...data };
+    store.set('keys', keys);
+}
+export function getProviderToken(provider) {
+    const fromStore = loadCredentials()[provider]?.token;
+    if (fromStore)
+        return fromStore;
+    const envKeys = {
+        railway: ['RAILWAY_TOKEN'],
+        vercel: ['VERCEL_TOKEN'],
+        upstash: ['UPSTASH_API_KEY', 'UPSTASH_TOKEN'],
+        render: ['RENDER_API_KEY'],
+        netlify: ['NETLIFY_TOKEN'],
+        heroku: ['HEROKU_API_KEY'],
+    };
+    for (const key of envKeys[provider] ?? []) {
+        if (process.env[key])
+            return process.env[key];
+    }
+    return undefined;
+}
+export function getProviderCredential(provider, field) {
+    const fromStore = loadCredentials()[provider]?.[field];
+    if (fromStore)
+        return fromStore;
+    if (provider === 'upstash' && field === 'email') {
+        return process.env.UPSTASH_EMAIL;
+    }
+    if (provider === 'vercel' && field === 'teamId') {
+        return process.env.VERCEL_TEAM_ID;
+    }
+    return undefined;
+}
+export function requireProviderToken(provider) {
+    const token = getProviderToken(provider);
+    if (!token) {
+        throw new Error(`Key not found — run \`heramb init\` to add your ${provider} token`);
+    }
+    return token;
+}
+export function getCredentialsPath() {
+    return store.path;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/utils/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAwB;IAC5C,WAAW,EAAE,QAAQ;IACrB,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU;IAC7D,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAA4B;IAC3E,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IAChD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IACrD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,OAAO,GAA6B;QACxC,OAAO,EAAE,CAAC,eAAe,CAAC;QAC1B,MAAM,EAAE,CAAC,cAAc,CAAC;QACxB,OAAO,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC;QAC7C,MAAM,EAAE,CAAC,gBAAgB,CAAC;QAC1B,OAAO,EAAE,CAAC,eAAe,CAAC;QAC1B,MAAM,EAAE,CAAC,gBAAgB,CAAC;KAC3B,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,KAAa;IACnE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACnC,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,QAAQ,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,5 @@
+export declare const HERAMB_GITIGNORE_SECTION = "# Heramb \u2014 secrets (do not commit)";
+export declare const HERAMB_GITIGNORE_ENTRIES: string[];
+export type EnsureGitignoreResult = 'created' | 'updated' | 'unchanged';
+export declare function ensureGitignore(cwd?: string): EnsureGitignoreResult;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/utils/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,4CAAuC,CAAC;AAE7E,eAAO,MAAM,wBAAwB,UAMpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAUxE,wBAAgB,eAAe,CAAC,GAAG,SAAgB,GAAG,qBAAqB,CAsB1E"}

package/dist/utils/gitignore.js

@@ -0,0 +1,35 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const HERAMB_GITIGNORE_SECTION = '# Heramb — secrets (do not commit)';
+export const HERAMB_GITIGNORE_ENTRIES = [
+    '.env',
+    '.env.*',
+    '!.env.example',
+    '.heramb/',
+    'keys.json',
+];
+function hasGitignoreLine(content, entry) {
+    return content.split('\n').some((line) => line.trim() === entry);
+}
+function formatBlock(entries) {
+    return `${HERAMB_GITIGNORE_SECTION}\n${entries.join('\n')}\n`;
+}
+export function ensureGitignore(cwd = process.cwd()) {
+    const gitignorePath = join(cwd, '.gitignore');
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, formatBlock(HERAMB_GITIGNORE_ENTRIES));
+        return 'created';
+    }
+    const content = readFileSync(gitignorePath, 'utf-8');
+    const missing = HERAMB_GITIGNORE_ENTRIES.filter((entry) => !hasGitignoreLine(content, entry));
+    if (missing.length === 0) {
+        return 'unchanged';
+    }
+    const hasSection = content.includes(HERAMB_GITIGNORE_SECTION);
+    const suffix = hasSection
+        ? `\n${missing.join('\n')}\n`
+        : `\n${formatBlock(missing)}`;
+    writeFileSync(gitignorePath, content.trimEnd() + suffix);
+    return 'updated';
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/utils/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/utils/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,wBAAwB,GAAG,oCAAoC,CAAC;AAE7E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM;IACN,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;CACZ,CAAC;AAIF,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAa;IACtD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,WAAW,CAAC,OAAiB;IACpC,OAAO,GAAG,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACjD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAE9F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,UAAU;QACvB,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAC7B,CAAC,CAAC,KAAK,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAEhC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,23 @@
+export declare function printBanner(): void;
+export declare function printUnlock(report: {
+    aiCalls: number;
+    tokensUsed: number;
+    resolved: Record<string, string>;
+}): void;
+export declare function printPreviewReady(report: {
+    aiCalls: number;
+    tokensUsed: number;
+    resolved: Record<string, string>;
+    steps?: Array<{
+        step: {
+            type: string;
+        };
+        success: boolean;
+        value?: string;
+    }>;
+}): void;
+export declare function printError(message: string): void;
+export declare function formatStepLabel(index: number, total: number, label: string): string;
+export declare function formatStepSuccess(value?: string): string;
+export declare function formatStepFailure(error?: string): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,IAAI,CAGP;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E,GAAG,IAAI,CAoBP;AAqBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/utils/output.js

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+export function printBanner() {
+    console.log(chalk.bold.cyan('\nHeramb 🐘'));
+    console.log(chalk.dim('Removes the obstacles between your code and production\n'));
+}
+export function printUnlock(report) {
+    console.log(chalk.green.bold('\n🔑 Unlocked\n'));
+    printDeploySummary(report);
+}
+export function printPreviewReady(report) {
+    console.log(chalk.green.bold('\nPreview environment ready 🔑\n'));
+    if (report.resolved['FRONTEND_URL']) {
+        console.log(`  Frontend : ${report.resolved['FRONTEND_URL']}`);
+    }
+    if (report.resolved['BACKEND_URL']) {
+        console.log(`  Backend  : ${report.resolved['BACKEND_URL']}`);
+    }
+    if (report.resolved['REDIS_URL']) {
+        console.log(`  Redis    : provisioned (preview tier)`);
+    }
+    const wsStep = report.steps?.find((s) => s.step.type === 'test' && s.success);
+    if (wsStep?.value) {
+        console.log(`  WS test  : ✓ ${wsStep.value}`);
+    }
+    console.log('');
+    printDeploySummary(report);
+}
+function printDeploySummary(report) {
+    console.log(chalk.dim('─'.repeat(40)));
+    console.log(`AI calls this deploy : ${report.aiCalls}`);
+    console.log(`Tokens used          : ${report.tokensUsed}`);
+    console.log(`Cost                 : $${(report.tokensUsed * 0.000002).toFixed(2)}`);
+    console.log(chalk.dim('─'.repeat(40)));
+    if (report.resolved['FRONTEND_URL']) {
+        console.log(chalk.cyan(`Frontend: ${report.resolved['FRONTEND_URL']}`));
+    }
+    if (report.resolved['BACKEND_URL']) {
+        console.log(chalk.cyan(`Backend:  ${report.resolved['BACKEND_URL']}`));
+    }
+}
+export function printError(message) {
+    console.error(chalk.red(`\n✗ ${message}\n`));
+}
+export function formatStepLabel(index, total, label) {
+    return chalk.dim(`[${index}/${total}]`) + ' ' + label;
+}
+export function formatStepSuccess(value) {
+    return chalk.green('✓') + (value ? chalk.dim(` ${value}`) : '');
+}
+export function formatStepFailure(error) {
+    return chalk.red('✗') + (error ? chalk.red(` ${error}`) : '');
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/dist/utils/preview.d.ts

@@ -0,0 +1,7 @@
+import type { HerambConfig } from '@heramb1/core';
+export type DeployEnv = 'production' | 'preview';
+export declare function slugifyBranch(branch: string): string;
+export declare function resolveBranch(explicit?: string): string | undefined;
+/** Scope config to a preview branch — isolated Redis and service names */
+export declare function applyPreviewContext(config: HerambConfig, branch: string): HerambConfig;
+//# sourceMappingURL=preview.d.ts.map

package/dist/utils/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/utils/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAatF"}

package/dist/utils/preview.js

@@ -0,0 +1,31 @@
+export function slugifyBranch(branch) {
+    return branch
+        .replace(/^refs\/heads\//, '')
+        .replace(/[^a-z0-9-]/gi, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase()
+        .slice(0, 40);
+}
+export function resolveBranch(explicit) {
+    if (explicit)
+        return explicit;
+    return (process.env.GITHUB_HEAD_REF ??
+        process.env.GITHUB_REF_NAME ??
+        process.env.CI_BRANCH ??
+        undefined);
+}
+/** Scope config to a preview branch — isolated Redis and service names */
+export function applyPreviewContext(config, branch) {
+    const slug = slugifyBranch(branch);
+    const scoped = structuredClone(config);
+    scoped.project = `${config.project}-${slug}`;
+    for (const svc of Object.values(scoped.services)) {
+        if ('provider' in svc) {
+            svc.serviceId = undefined;
+            svc.projectId = svc.projectId ? `${svc.projectId}-${slug}` : undefined;
+        }
+    }
+    return scoped;
+}
+//# sourceMappingURL=preview.js.map

package/dist/utils/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/utils/preview.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM;SACV,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,eAAe;QAC3B,OAAO,CAAC,GAAG,CAAC,eAAe;QAC3B,OAAO,CAAC,GAAG,CAAC,SAAS;QACrB,SAAS,CACV,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,MAAoB,EAAE,MAAc;IACtE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,GAAiB,eAAe,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,OAAO,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;IAE7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;YAC1B,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/provider-pick.d.ts

@@ -0,0 +1,5 @@
+import { type DeployPlan, type ProjectRequirements, type ServiceRole } from '@heramb1/core';
+import type { HerambConfig, StackDetection } from '@heramb1/core';
+export declare function pickProviders(plan: DeployPlan): Promise<Record<ServiceRole, string>>;
+export declare function generateConfigFromChoices(projectName: string, stack: StackDetection, choices: Record<ServiceRole, string>, req: ProjectRequirements): HerambConfig;
+//# sourceMappingURL=provider-pick.d.ts.map

package/dist/utils/provider-pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-pick.d.ts","sourceRoot":"","sources":["../../src/utils/provider-pick.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAIjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElE,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CA6D1F;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,mBAAmB,GACvB,YAAY,CAoDd"}

package/dist/utils/provider-pick.js

@@ -0,0 +1,110 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { validateProviderChoice, recommendForRole, getProvider, } from '@heramb1/core';
+export async function pickProviders(plan) {
+    const choices = {};
+    const req = plan.requirements;
+    for (const svc of plan.services) {
+        const ranked = svc.recommendations.filter((r) => r.score > 0);
+        const defaultChoice = ranked.find((r) => r.implemented)?.provider ?? ranked[0]?.provider ?? 'railway';
+        console.log(chalk.cyan(`\n→ Where should Heramb deploy your ${svc.label.toLowerCase()}?`));
+        for (const warning of svc.warnings.slice(0, 2)) {
+            console.log(chalk.yellow('  ⚠') + ` ${warning}`);
+        }
+        const { provider } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'provider',
+                message: `${svc.label} platform:`,
+                default: defaultChoice,
+                choices: svc.recommendations.slice(0, 8).map((r) => {
+                    const tags = [];
+                    if (r.implemented)
+                        tags.push('ready');
+                    if (r.score > 0 && r === ranked[0])
+                        tags.push('recommended');
+                    if (r.blockers.length > 0)
+                        tags.push('blocked');
+                    const suffix = tags.length > 0 ? chalk.dim(` (${tags.join(', ')})`) : '';
+                    const label = r.score > 0 ? r.name : `${r.name} — ${r.blockers[0] ?? 'unsuitable'}`;
+                    return {
+                        name: `${label}${suffix}`,
+                        value: r.provider,
+                        disabled: r.blockers.length > 0 ? r.blockers[0] : false,
+                    };
+                }),
+            },
+        ]);
+        const validation = validateProviderChoice(svc.role, provider, req);
+        for (const warning of validation.warnings) {
+            console.log(chalk.yellow('  ⚠') + ` ${warning}`);
+        }
+        if (!validation.ok) {
+            console.log(chalk.red('  ✗') + ` ${validation.blockers.join('; ')}`);
+            console.log(chalk.dim('  Pick a different platform for this role.\n'));
+            const fallback = recommendForRole(svc.role, req).find((r) => r.implemented && r.score > 0);
+            if (!fallback) {
+                throw new Error(`No suitable platform for ${svc.label}`);
+            }
+            choices[svc.role] = fallback.provider;
+            console.log(chalk.dim(`  Using ${fallback.name} instead.`));
+        }
+        else {
+            choices[svc.role] = provider;
+        }
+        const guide = getProvider(provider);
+        if (guide) {
+            console.log(chalk.dim(`  ${guide.name}: ${guide.signupUrl}`));
+        }
+    }
+    return choices;
+}
+export function generateConfigFromChoices(projectName, stack, choices, req) {
+    const config = {
+        project: projectName,
+        services: {},
+        wsConfig: {
+            pingInterval: 25000,
+            transport: 'websocket-only',
+        },
+        env: {
+            manual: ['JWT_SECRET'],
+        },
+    };
+    if (req.redis && choices.cache) {
+        config.services.redis = {
+            provider: choices.cache,
+            produces: ['REDIS_URL'],
+        };
+    }
+    if (stack.backend && choices.backend) {
+        config.services.backend = {
+            provider: choices.backend,
+            path: stack.backend.path,
+            needs: req.redis ? ['REDIS_URL'] : [],
+            produces: ['BACKEND_URL'],
+            derives: req.websocket
+                ? { WS_URL: 'BACKEND_URL → wss://' }
+                : undefined,
+        };
+    }
+    if (stack.frontend && choices.frontend) {
+        const isVite = stack.frontend.framework === 'vite';
+        config.services.frontend = {
+            provider: choices.frontend,
+            path: stack.frontend.path,
+            needs: isVite
+                ? ['VITE_API_URL']
+                : ['NEXT_PUBLIC_API_URL', ...(req.websocket ? ['NEXT_PUBLIC_WS_URL'] : [])],
+            produces: ['FRONTEND_URL'],
+        };
+        config.services['backend-cors'] = {
+            action: 'patch-env',
+            target: 'backend',
+            vars: isVite ? { WEB_URL: 'FRONTEND_URL' } : { CORS_ORIGIN: 'FRONTEND_URL' },
+            then: 'redeploy',
+        };
+    }
+    return config;
+}
+//# sourceMappingURL=provider-pick.js.map