@rudderjs/cli 4.3.0 → 4.5.0

package/dist/commands/add.d.ts

@@ -0,0 +1,42 @@
+import type { Command } from 'commander';
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+/** Detect PM from npm_config_user_agent (set by every modern PM). Falls back to pnpm. */
+declare function detectPackageManager(): PackageManager;
+type PackageSpec = {
+    /** Short name used in `rudder add <name>`. */
+    alias: string;
+    /** Full npm package name. */
+    npmName: string;
+    /** Generates the config file body. Pure — no I/O. */
+    config?: {
+        key: string;
+        template: (ctx: {
+            orm: 'prisma' | 'drizzle' | null;
+        }) => string;
+    };
+    /** Other aliases that must already be installed (or selected in the same `add` run). */
+    requires?: string[];
+    /** When set, the project must use this ORM. */
+    requiresOrm?: 'prisma';
+    /** One-line post-install hint printed to the user. */
+    hint?: string;
+};
+declare function findSpec(name: string): PackageSpec | null;
+declare function detectOrm(cwd: string): 'prisma' | 'drizzle' | null;
+/**
+ * Insert a new `import <key> from './<key>.js'` line + a new entry in the
+ * `const configs = { ... }` object. Idempotent — bails cleanly if the key is
+ * already present or the file shape is too custom to safely edit.
+ *
+ * Returns `'ok' | 'already-registered' | 'unrecognized-shape'`.
+ */
+export declare function registerConfigKey(indexPath: string, key: string): 'ok' | 'already-registered' | 'unrecognized-shape';
+export declare function addCommand(program: Command): void;
+export declare const _internal: {
+    REGISTRY: readonly PackageSpec[];
+    findSpec: typeof findSpec;
+    detectOrm: typeof detectOrm;
+    detectPackageManager: typeof detectPackageManager;
+};
+export {};
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAErD,yFAAyF;AACzF,iBAAS,oBAAoB,IAAI,cAAc,CAS9C;AAsBD,KAAK,WAAW,GAAG;IACjB,8CAA8C;IAC9C,KAAK,EAAK,MAAM,CAAA;IAChB,6BAA6B;IAC7B,OAAO,EAAG,MAAM,CAAA;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,EAAE;YAAE,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAA;SAAE,KAAK,MAAM,CAAA;KAAE,CAAA;IAC1F,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,QAAQ,CAAA;IACtB,sDAAsD;IACtD,IAAI,CAAC,EAAK,MAAM,CAAA;CACjB,CAAA;AA6CD,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGlD;AAID,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAQ3D;AAYD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB,GAAG,oBAAoB,CAmCpH;AAcD,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2FjD;AA6QD,eAAO,MAAM,SAAS;;;;;CAA0D,CAAA"}

package/dist/commands/add.js

@@ -0,0 +1,475 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+/** Detect PM from npm_config_user_agent (set by every modern PM). Falls back to pnpm. */
+function detectPackageManager() {
+    const ua = process.env['npm_config_user_agent'] ?? '';
+    if (ua.startsWith('pnpm'))
+        return 'pnpm';
+    if (ua.startsWith('yarn'))
+        return 'yarn';
+    if (ua.startsWith('bun'))
+        return 'bun';
+    if (ua.startsWith('npm'))
+        return 'npm';
+    // If invoked directly via `node bin/rudder.js`, the env var is absent.
+    // pnpm-workspace.yaml is the strongest signal for our monorepo / scaffolded apps.
+    return 'pnpm';
+}
+function pmAdd(pm, dep) {
+    switch (pm) {
+        case 'pnpm': return ['add', dep];
+        case 'npm': return ['install', dep];
+        case 'yarn': return ['add', dep];
+        case 'bun': return ['add', dep];
+    }
+}
+const REGISTRY = [
+    // Auth & Security
+    { alias: 'auth', npmName: '@rudderjs/auth', config: { key: 'auth', template: () => CFG_AUTH } },
+    { alias: 'sanctum', npmName: '@rudderjs/sanctum', config: { key: 'sanctum', template: () => CFG_SANCTUM }, requires: ['auth'] },
+    { alias: 'passport', npmName: '@rudderjs/passport', config: { key: 'passport', template: () => CFG_PASSPORT }, requires: ['auth'], requiresOrm: 'prisma', hint: 'OAuth2 ready: /oauth/authorize, /oauth/token  — run `rudder passport:keys` then `rudder passport:client <name>`' },
+    { alias: 'socialite', npmName: '@rudderjs/socialite', config: { key: 'socialite', template: () => CFG_SOCIALITE }, hint: 'Set <PROVIDER>_CLIENT_ID and <PROVIDER>_CLIENT_SECRET in .env (e.g. GITHUB_CLIENT_ID).' },
+    { alias: 'crypt', npmName: '@rudderjs/crypt', config: { key: 'crypt', template: () => CFG_CRYPT }, hint: 'Set APP_KEY in .env (32-byte base64) before encrypting anything.' },
+    // Infrastructure
+    { alias: 'queue', npmName: '@rudderjs/queue', config: { key: 'queue', template: () => CFG_QUEUE }, hint: 'Background jobs: `import { Bus } from "@rudderjs/queue"; Bus.dispatch(new MyJob())`.' },
+    { alias: 'storage', npmName: '@rudderjs/storage', config: { key: 'storage', template: () => CFG_STORAGE }, hint: 'File uploads: `import { Storage } from "@rudderjs/storage"; Storage.disk().put(...)`.' },
+    { alias: 'scheduler', npmName: '@rudderjs/schedule', hint: 'Schedule tasks in routes/console.ts via `Schedule.command(...)`.' },
+    // Communication
+    { alias: 'mail', npmName: '@rudderjs/mail', config: { key: 'mail', template: () => CFG_MAIL }, hint: 'Default mailer is `log` (writes to stdout). Set MAIL_MAILER=smtp + SMTP_* in .env for real delivery.' },
+    { alias: 'notifications', npmName: '@rudderjs/notification', hint: 'Multi-channel notifications: `rudder make:notification Welcome`.' },
+    { alias: 'broadcast', npmName: '@rudderjs/broadcast', hint: 'Real-time channels: define them in routes/channels.ts.' },
+    { alias: 'sync', npmName: '@rudderjs/sync', config: { key: 'sync', template: ({ orm }) => buildSyncConfig(orm) }, hint: 'Collaborative Yjs docs: WebSocket endpoint at /ws-sync.' },
+    // i18n
+    { alias: 'localization', npmName: '@rudderjs/localization', config: { key: 'localization', template: () => CFG_LOCALIZATION }, hint: 'i18n: `import { trans } from "@rudderjs/localization"`.' },
+    // Developer experience
+    { alias: 'pennant', npmName: '@rudderjs/pennant', config: { key: 'pennant', template: () => CFG_PENNANT }, hint: 'Feature flags: `import { Feature } from "@rudderjs/pennant"`.' },
+    { alias: 'http', npmName: '@rudderjs/http', hint: 'Fluent fetch client: `import { Http } from "@rudderjs/http"`.' },
+    { alias: 'process', npmName: '@rudderjs/process', hint: 'Shell execution: `import { Process } from "@rudderjs/process"`.' },
+    { alias: 'concurrency', npmName: '@rudderjs/concurrency', hint: 'Worker threads: `import { pool } from "@rudderjs/concurrency"`.' },
+    { alias: 'terminal', npmName: '@rudderjs/terminal', hint: 'Rich terminal UI: `rudder make:terminal <Name>`.' },
+    // Media
+    { alias: 'image', npmName: '@rudderjs/image', hint: 'Image processing: `import { Image } from "@rudderjs/image"`.' },
+    // Observability
+    { alias: 'telescope', npmName: '@rudderjs/telescope', config: { key: 'telescope', template: () => CFG_TELESCOPE }, hint: 'Telescope dashboard: /telescope  (requests, queries, jobs, exceptions).' },
+    { alias: 'pulse', npmName: '@rudderjs/pulse', config: { key: 'pulse', template: () => CFG_PULSE }, hint: 'Pulse dashboard: /pulse  (throughput, latency, hit rates).' },
+    { alias: 'horizon', npmName: '@rudderjs/horizon', config: { key: 'horizon', template: () => CFG_HORIZON }, hint: 'Horizon dashboard: /horizon  (queue lifecycle, workers).' },
+    // AI & tooling
+    { alias: 'ai', npmName: '@rudderjs/ai', config: { key: 'ai', template: () => CFG_AI }, hint: 'AI agents: set ANTHROPIC_API_KEY (or OPENAI_API_KEY / GOOGLE_AI_API_KEY) in .env.' },
+    { alias: 'mcp', npmName: '@rudderjs/mcp', hint: 'Model Context Protocol: `rudder make:mcp-server <Name>`.' },
+    { alias: 'boost', npmName: '@rudderjs/boost', hint: 'AI coding DX: `rudder boost:install` to wire your assistant.' },
+];
+function findSpec(name) {
+    const normalized = name.startsWith('@rudderjs/') ? name.slice('@rudderjs/'.length) : name;
+    return REGISTRY.find(p => p.alias === normalized) ?? null;
+}
+// ── ORM detection ─────────────────────────────────────────────
+function detectOrm(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!existsSync(pkgPath))
+        return null;
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if ('@rudderjs/orm-prisma' in deps)
+        return 'prisma';
+    if ('@rudderjs/orm-drizzle' in deps)
+        return 'drizzle';
+    return null;
+}
+function isInstalled(cwd, npmName) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    return npmName in deps;
+}
+// ── config/index.ts surgical edit ─────────────────────────────
+/**
+ * Insert a new `import <key> from './<key>.js'` line + a new entry in the
+ * `const configs = { ... }` object. Idempotent — bails cleanly if the key is
+ * already present or the file shape is too custom to safely edit.
+ *
+ * Returns `'ok' | 'already-registered' | 'unrecognized-shape'`.
+ */
+export function registerConfigKey(indexPath, key) {
+    const src = readFileSync(indexPath, 'utf8');
+    // Already wired? Check both the import and the configs map.
+    if (new RegExp(`from '\\./${key}\\.js'`).test(src))
+        return 'already-registered';
+    // Find the last `import X from './X.js'` line.
+    const importRe = /^import\s+\w+\s+from\s+'\.\/(\w+)\.js'\s*$/gm;
+    let lastImportEnd = -1;
+    let match;
+    while ((match = importRe.exec(src)) !== null)
+        lastImportEnd = match.index + match[0].length;
+    if (lastImportEnd === -1)
+        return 'unrecognized-shape';
+    // Find `const configs = { ... }` block.
+    const configsRe = /const\s+configs\s*=\s*\{([^}]*)\}/;
+    const configsMatch = configsRe.exec(src);
+    if (!configsMatch)
+        return 'unrecognized-shape';
+    // Compose the inserts. Use a uniform import format (no fancy column alignment
+    // — we don't try to match the user's spacing — but pad to the visual width of
+    // the longest existing import so it still reads cleanly).
+    const longestKey = Math.max(...[...src.matchAll(importRe)].map(m => m[1].length));
+    const padded = key.padEnd(Math.max(longestKey, key.length));
+    const newImport = `\nimport ${padded} from './${key}.js'`;
+    const existingKeys = configsMatch[1].trim();
+    const newKeys = existingKeys
+        ? `${existingKeys.replace(/,?\s*$/, '')}, ${key}`
+        : key;
+    const out = src.slice(0, lastImportEnd) + newImport + src.slice(lastImportEnd, configsMatch.index)
+        + `const configs = { ${newKeys} }` + src.slice(configsMatch.index + configsMatch[0].length);
+    writeFileSync(indexPath, out);
+    return 'ok';
+}
+// ── Child-process runner ──────────────────────────────────────
+function runChild(cmd, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, { cwd, stdio: 'inherit', shell: false });
+        child.on('close', (code) => resolve(code === 0));
+        child.on('error', () => resolve(false));
+    });
+}
+// ── Command ───────────────────────────────────────────────────
+export function addCommand(program) {
+    program
+        .command('add <package>')
+        .description('Install a RudderJS package — handles deps, config, and provider discovery')
+        .action(async (packageName) => {
+        const cwd = process.cwd();
+        const spec = findSpec(packageName);
+        if (!spec) {
+            const valid = REGISTRY.map(p => p.alias).join(', ');
+            console.error(`[rudder add] Unknown package "${packageName}".\n  Available: ${valid}`);
+            process.exit(1);
+        }
+        // Idempotency — already installed?
+        if (isInstalled(cwd, spec.npmName)) {
+            console.log(`  ${spec.npmName} is already installed.`);
+            if (spec.config && existsSync(path.join(cwd, 'config', `${spec.config.key}.ts`))) {
+                console.log(`  config/${spec.config.key}.ts exists — nothing to do.`);
+                return;
+            }
+            // Package installed but config missing — continue and generate it.
+        }
+        // ORM requirement
+        const orm = detectOrm(cwd);
+        if (spec.requiresOrm && orm !== spec.requiresOrm) {
+            console.error(`[rudder add] ${spec.alias} requires Prisma. Detected: ${orm ?? 'none'}.`);
+            console.error(`  Add the ORM first: pnpm add @rudderjs/orm @rudderjs/orm-${spec.requiresOrm}`);
+            process.exit(1);
+        }
+        // Dependency requirements
+        if (spec.requires?.length) {
+            const pkg = JSON.parse(readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+            const deps = pkg.dependencies ?? {};
+            for (const req of spec.requires) {
+                const reqSpec = REGISTRY.find(p => p.alias === req);
+                if (reqSpec && !(reqSpec.npmName in deps)) {
+                    console.error(`[rudder add] ${spec.alias} requires ${req}. Run \`rudder add ${req}\` first.`);
+                    process.exit(1);
+                }
+            }
+        }
+        // 1. Install the dependency
+        const pm = detectPackageManager();
+        if (!isInstalled(cwd, spec.npmName)) {
+            console.log(`\n  Adding ${spec.npmName}...`);
+            const ok = await runChild(pm, pmAdd(pm, spec.npmName), cwd);
+            if (!ok) {
+                console.error(`[rudder add] ${pm} ${pmAdd(pm, spec.npmName).join(' ')} failed.`);
+                process.exit(1);
+            }
+        }
+        // 2. Generate config file (idempotent — skip if exists)
+        if (spec.config) {
+            const configDir = path.join(cwd, 'config');
+            mkdirSync(configDir, { recursive: true });
+            const configFile = path.join(configDir, `${spec.config.key}.ts`);
+            if (!existsSync(configFile)) {
+                const body = spec.config.template({ orm });
+                writeFileSync(configFile, body);
+                console.log(`  Generated config/${spec.config.key}.ts`);
+            }
+            // 3. Wire into config/index.ts
+            const indexFile = path.join(configDir, 'index.ts');
+            if (existsSync(indexFile)) {
+                const result = registerConfigKey(indexFile, spec.config.key);
+                if (result === 'ok') {
+                    console.log(`  Registered "${spec.config.key}" in config/index.ts`);
+                }
+                else if (result === 'unrecognized-shape') {
+                    console.warn(`  ⚠ Could not auto-wire config/index.ts (custom shape).`);
+                    console.warn(`    Add manually: import ${spec.config.key} from './${spec.config.key}.js'`);
+                }
+            }
+        }
+        // 4. Refresh provider manifest
+        console.log(`  Refreshing provider manifest...`);
+        const discoverOk = await runChild(pm, [...(pm === 'npm' ? ['exec'] : []), 'rudder', 'providers:discover'], cwd);
+        if (!discoverOk) {
+            console.warn(`  ⚠ providers:discover failed — run \`${pm} rudder providers:discover\` manually.`);
+        }
+        // 5. Print the post-install hint
+        console.log();
+        console.log(`  ✓ ${spec.alias} is ready.`);
+        if (spec.hint)
+            console.log(`    ${spec.hint}`);
+    });
+}
+// ── Config templates (vendored from create-rudder-app for runtime use) ─────
+//
+// Kept inline here rather than pulled from create-rudder-app via subpath so
+// that @rudderjs/cli stays standalone and doesn't depend on the scaffolder.
+// These are intentionally near-verbatim copies — the scaffolder owns the
+// canonical templates for new-project scaffolding, and this command owns the
+// runtime-add path. When the canonical templates evolve, this file gets
+// updated in lockstep (one PR touches both).
+const CFG_AUTH = `import type { AuthConfig } from '@rudderjs/auth'
+import { User } from '../app/Models/User.js'
+
+export default {
+  defaults: { guard: 'web' },
+  guards: {
+    web: { driver: 'session', provider: 'users' },
+  },
+  providers: {
+    users: { driver: 'eloquent', model: User },
+  },
+} satisfies AuthConfig
+`;
+const CFG_SANCTUM = `import { Env } from '@rudderjs/support'
+import type { SanctumConfig } from '@rudderjs/sanctum'
+
+export default {
+  expiration: Env.getNumber('SANCTUM_TOKEN_EXPIRATION_MINUTES', 0),
+  prefix:     Env.get('SANCTUM_TOKEN_PREFIX', ''),
+
+  // Default abilities granted on token creation.
+  defaultAbilities: ['*'],
+} satisfies SanctumConfig
+`;
+const CFG_PASSPORT = `import { Env } from '@rudderjs/support'
+
+export default {
+  // Path to the RSA keypair generated by \`rudder passport:keys\`.
+  privateKey: Env.get('PASSPORT_PRIVATE_KEY_PATH', 'storage/oauth-private.key'),
+  publicKey:  Env.get('PASSPORT_PUBLIC_KEY_PATH',  'storage/oauth-public.key'),
+
+  // Token lifetimes (in seconds).
+  accessTokenTtl:  Env.getNumber('PASSPORT_ACCESS_TOKEN_TTL',  3600),     // 1h
+  refreshTokenTtl: Env.getNumber('PASSPORT_REFRESH_TOKEN_TTL', 1209600),  // 14d
+}
+`;
+const CFG_SOCIALITE = `import { Env } from '@rudderjs/support'
+
+export default {
+  github: {
+    clientId:     Env.get('GITHUB_CLIENT_ID',     ''),
+    clientSecret: Env.get('GITHUB_CLIENT_SECRET', ''),
+    redirectUri:  Env.get('GITHUB_REDIRECT_URI',  'http://localhost:3000/auth/github/callback'),
+  },
+  google: {
+    clientId:     Env.get('GOOGLE_CLIENT_ID',     ''),
+    clientSecret: Env.get('GOOGLE_CLIENT_SECRET', ''),
+    redirectUri:  Env.get('GOOGLE_REDIRECT_URI',  'http://localhost:3000/auth/google/callback'),
+  },
+}
+`;
+const CFG_CRYPT = `import { Env } from '@rudderjs/support'
+
+export default {
+  // 32-byte base64 key. Generate with: openssl rand -base64 32
+  // Stored in .env as APP_KEY — never commit it.
+  key:    Env.get('APP_KEY', ''),
+  cipher: Env.get('APP_CIPHER', 'aes-256-cbc'),
+}
+`;
+const CFG_QUEUE = `import { Env, isWebContainer } from '@rudderjs/support'
+import type { QueueConfig } from '@rudderjs/queue'
+
+// In WebContainer, BullMQ (Redis over raw TCP) doesn't work — fall back to
+// the in-process \`sync\` driver.
+const defaultConnection = isWebContainer() ? 'sync' : Env.get('QUEUE_CONNECTION', 'sync')
+
+export default {
+  default: defaultConnection,
+
+  connections: {
+    sync: {
+      driver: 'sync',
+    },
+
+    inngest: {
+      driver:     'inngest',
+      appId:      Env.get('INNGEST_APP_ID',      'my-app'),
+      eventKey:   Env.get('INNGEST_EVENT_KEY',   ''),
+      signingKey: Env.get('INNGEST_SIGNING_KEY',  ''),
+      jobs: [],
+    },
+  },
+} satisfies QueueConfig
+`;
+const CFG_STORAGE = `import { Env } from '@rudderjs/support'
+import type { StorageConfig } from '@rudderjs/storage'
+
+export default {
+  default: Env.get('STORAGE_DISK', 'local'),
+
+  disks: {
+    local: {
+      driver: 'local',
+      root:   Env.get('STORAGE_LOCAL_ROOT', 'storage/app'),
+    },
+
+    s3: {
+      driver:    's3',
+      key:       Env.get('AWS_ACCESS_KEY_ID',     ''),
+      secret:    Env.get('AWS_SECRET_ACCESS_KEY', ''),
+      region:    Env.get('AWS_DEFAULT_REGION',    'us-east-1'),
+      bucket:    Env.get('AWS_BUCKET',            ''),
+      endpoint:  Env.get('AWS_ENDPOINT',          ''),
+    },
+  },
+} satisfies StorageConfig
+`;
+const CFG_MAIL = `import { Env, isWebContainer } from '@rudderjs/support'
+
+// In WebContainer, raw SMTP (TCP) doesn't work — fall back to the log driver
+// (writes the rendered email to stdout instead of sending).
+const defaultMailer = isWebContainer() ? 'log' : Env.get('MAIL_MAILER', 'log')
+
+export default {
+  default: defaultMailer,
+
+  from: {
+    address: Env.get('MAIL_FROM_ADDRESS', 'hello@example.com'),
+    name:    Env.get('MAIL_FROM_NAME',    'RudderJS'),
+  },
+
+  mailers: {
+    log: {
+      driver: 'log',
+    },
+
+    smtp: {
+      driver:     'smtp',
+      host:       Env.get('MAIL_HOST',     'localhost'),
+      port:       Env.getNumber('MAIL_PORT', 587),
+      username:   Env.get('MAIL_USERNAME', ''),
+      password:   Env.get('MAIL_PASSWORD', ''),
+      encryption: Env.get('MAIL_ENCRYPTION', 'tls'),
+    },
+  },
+}
+`;
+function buildSyncConfig(orm) {
+    const persistenceImport = orm === 'prisma' ? "\nimport { syncPrisma } from '@rudderjs/sync'" : '';
+    const persistenceLine = orm === 'prisma'
+        ? '\n  // Server-side persistence — Y.Docs survive server restarts\n  persistence: syncPrisma(),\n'
+        : '';
+    return `import { Env } from '@rudderjs/support'${persistenceImport}
+import type { SyncConfig } from '@rudderjs/sync'
+
+export default {
+  path: Env.get('SYNC_PATH', '/ws-sync'),
+${persistenceLine}
+  // Client-side providers
+  providers: ['websocket', 'indexeddb'],
+} satisfies SyncConfig
+`;
+}
+const CFG_LOCALIZATION = `import { Env } from '@rudderjs/support'
+
+export default {
+  locale:         Env.get('APP_LOCALE',          'en'),
+  fallbackLocale: Env.get('APP_FALLBACK_LOCALE', 'en'),
+
+  // Path to translation files (relative to project root).
+  path: 'lang',
+}
+`;
+const CFG_PENNANT = `import { Env } from '@rudderjs/support'
+import type { PennantConfig } from '@rudderjs/pennant'
+
+export default {
+  default: Env.get('PENNANT_STORE', 'array'),
+
+  stores: {
+    array:    { driver: 'array' },
+    database: { driver: 'database', table: 'feature_flags' },
+  },
+} satisfies PennantConfig
+`;
+const CFG_TELESCOPE = `import { Env } from '@rudderjs/support'
+import type { TelescopeConfig } from '@rudderjs/telescope'
+
+export default {
+  enabled: Env.getBool('TELESCOPE_ENABLED', true),
+  path:    Env.get('TELESCOPE_PATH',        '/telescope'),
+
+  storage: {
+    driver: Env.get('TELESCOPE_STORAGE', 'memory'),
+  },
+} satisfies TelescopeConfig
+`;
+const CFG_PULSE = `import { Env } from '@rudderjs/support'
+import type { PulseConfig } from '@rudderjs/pulse'
+
+export default {
+  enabled: Env.getBool('PULSE_ENABLED', true),
+  path:    Env.get('PULSE_PATH',        '/pulse'),
+
+  storage: {
+    driver: Env.get('PULSE_STORAGE', 'memory'),
+  },
+} satisfies PulseConfig
+`;
+const CFG_HORIZON = `import { Env } from '@rudderjs/support'
+import type { HorizonConfig } from '@rudderjs/horizon'
+
+export default {
+  enabled: Env.getBool('HORIZON_ENABLED', true),
+  path:    Env.get('HORIZON_PATH',        '/horizon'),
+
+  storage: {
+    driver: Env.get('HORIZON_STORAGE', 'memory'),
+  },
+} satisfies HorizonConfig
+`;
+const CFG_AI = `import { Env } from '@rudderjs/support'
+import type { AiConfig } from '@rudderjs/ai'
+
+export default {
+  default: Env.get('AI_MODEL', 'anthropic/claude-sonnet-4-5'),
+
+  providers: {
+    anthropic: {
+      driver: 'anthropic',
+      apiKey: Env.get('ANTHROPIC_API_KEY', ''),
+    },
+
+    openai: {
+      driver: 'openai',
+      apiKey: Env.get('OPENAI_API_KEY', ''),
+    },
+
+    google: {
+      driver: 'google',
+      apiKey: Env.get('GOOGLE_AI_API_KEY', ''),
+    },
+
+    ollama: {
+      driver:  'ollama',
+      baseUrl: Env.get('OLLAMA_BASE_URL', 'http://localhost:11434'),
+    },
+  },
+} satisfies AiConfig
+`;
+// ── Test exports ──────────────────────────────────────────────
+// (not part of the runtime API, but tests import these directly)
+export const _internal = { REGISTRY, findSpec, detectOrm, detectPackageManager };
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,12 @@
+import type { Command as CommanderCommand } from 'commander';
+export interface DoctorCommandDeps {
+    /**
+     * Inject the CLI's bootApp so the doctor command can boot the app under
+     * `--deep`. Passed by reference rather than imported because the CLI's
+     * bootApp suppresses console output (provider chatter is noise here too)
+     * and the doctor command shouldn't reimplement that.
+     */
+    bootApp: () => Promise<void>;
+}
+export declare function doctorCommand(program: CommanderCommand, deps: DoctorCommandDeps): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAQ5D,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAmFtF"}

package/dist/commands/doctor.js

@@ -0,0 +1,83 @@
+import { runChecks } from '../doctor/orchestrator.js';
+import { renderReport, renderFixReport, exitCodeFor } from '../doctor/reporter.js';
+import { loadPackageChecks } from '../doctor/load-package-checks.js';
+import { loadBuiltInChecks } from '../doctor/built-in/index.js';
+import { setBootStatus } from '../doctor/boot-status.js';
+import { applyFixes } from '../doctor/fixer.js';
+export function doctorCommand(program, deps) {
+    program
+        .command('doctor')
+        .description('Diagnose common setup issues in a RudderJS app')
+        .option('--deep', 'Also run checks that require booting the app (DB connect, port, …)')
+        .option('--fix', 'Auto-apply safe fixes for any failures that declare a fixer')
+        .option('--yes', 'Skip fix-mode prompts and apply every fixable failure')
+        .option('--verbose', 'Show detail block under each check (not just failures)')
+        .option('--json', 'Reserved for a future machine-readable output mode')
+        .option('--only <substring>', 'Only run checks whose id contains <substring>')
+        .action(async (opts) => {
+        if (opts.json) {
+            console.error('rudder doctor: --json is reserved for a future release (v1 has no JSON output).');
+            process.exit(2);
+        }
+        // Built-in CLI-owned checks (env, structure, deps, runtime) — registered
+        // eagerly via side-effect imports so they're present even if no framework
+        // package contributed any.
+        loadBuiltInChecks();
+        // Lazy-load package-contributed checks.
+        await loadPackageChecks();
+        // --deep boots the app once so runtime checks can interrogate the live
+        // DI container (DB client, queue connection, mail transport, etc.).
+        // Boot failure is captured as a check result, not a crash — the rest
+        // of the runtime suite then short-circuits to skipped, but the user
+        // still sees the boot error verbatim with the failing provider.
+        if (opts.deep) {
+            const t0 = performance.now();
+            try {
+                await deps.bootApp();
+                setBootStatus({ ok: true, durationMs: performance.now() - t0 });
+            }
+            catch (e) {
+                setBootStatus({
+                    ok: false,
+                    error: e instanceof Error ? `${e.message}\n${e.stack ?? ''}` : String(e),
+                    durationMs: performance.now() - t0,
+                });
+            }
+        }
+        const runOpts = {};
+        if (opts.deep)
+            runOpts.deep = true;
+        if (opts.only !== undefined)
+            runOpts.filter = opts.only;
+        const reportOpts = {};
+        if (opts.verbose)
+            reportOpts.verbose = true;
+        // First pass — surface every failure to the user before touching anything.
+        const result = await runChecks(runOpts);
+        console.log(renderReport(result, reportOpts));
+        if (!opts.fix) {
+            process.exit(exitCodeFor(result));
+        }
+        // ── --fix path ──────────────────────────────────────
+        // Only fixable checks (warn/error with a fixer) are eligible. Prompt
+        // each unless --yes; never modify .env or package.json — fixers are
+        // idempotent regenerate-style operations only.
+        const fixOpts = {};
+        if (opts.yes)
+            fixOpts.yes = true;
+        const fixResult = await applyFixes(result.outcomes, fixOpts);
+        console.log('');
+        console.log(renderFixReport(fixResult, reportOpts));
+        // Second pass — confirm the fixers actually resolved the issues so
+        // the user doesn't have to eyeball it. Same runOpts so deep/only flags
+        // carry through.
+        if (fixResult.applied > 0) {
+            console.log('');
+            const second = await runChecks(runOpts);
+            console.log(renderReport(second, reportOpts));
+            process.exit(exitCodeFor(second));
+        }
+        process.exit(exitCodeFor(result));
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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