@rudderjs/cli 4.3.0 → 4.5.0

package/dist/commands/remove.d.ts

@@ -0,0 +1,24 @@
+import type { Command } from 'commander';
+/**
+ * Walk the registry and return the aliases of packages that:
+ *   1. Are currently installed, AND
+ *   2. List `alias` in their `requires` array.
+ *
+ * Used to refuse a remove that would leave dependent packages in a broken
+ * state (e.g. `rudder remove auth` while sanctum/passport are still
+ * installed would crash both providers at boot).
+ */
+export declare function findInstalledDependents(cwd: string, alias: string): string[];
+/**
+ * Remove the `import <key> from './<key>.js'` line + the `<key>` entry in
+ * the `const configs = { ... }` object. Mirror of `registerConfigKey` in
+ * add.ts. Idempotent — bails cleanly if the key isn't currently registered.
+ *
+ * Returns `'ok' | 'not-registered' | 'unrecognized-shape'`.
+ */
+export declare function unregisterConfigKey(indexPath: string, key: string): 'ok' | 'not-registered' | 'unrecognized-shape';
+export declare function removeCommand(program: Command): void;
+export declare const _testInternal: {
+    findInstalledDependents: typeof findInstalledDependents;
+};
+//# sourceMappingURL=remove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA8BxC;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK5E;AAID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,oBAAoB,CAoClH;AAcD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoFpD;AAGD,eAAO,MAAM,aAAa;;CAA8B,CAAA"}

package/dist/commands/remove.js

@@ -0,0 +1,170 @@
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { _internal } from './add.js';
+const { REGISTRY, findSpec, detectPackageManager } = _internal;
+function pmRemove(pm, dep) {
+    switch (pm) {
+        case 'pnpm': return ['remove', dep];
+        case 'npm': return ['uninstall', dep];
+        case 'yarn': return ['remove', dep];
+        case 'bun': return ['remove', dep];
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────
+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;
+}
+/**
+ * Walk the registry and return the aliases of packages that:
+ *   1. Are currently installed, AND
+ *   2. List `alias` in their `requires` array.
+ *
+ * Used to refuse a remove that would leave dependent packages in a broken
+ * state (e.g. `rudder remove auth` while sanctum/passport are still
+ * installed would crash both providers at boot).
+ */
+export function findInstalledDependents(cwd, alias) {
+    return REGISTRY
+        .filter(spec => spec.requires?.includes(alias))
+        .filter(spec => isInstalled(cwd, spec.npmName))
+        .map(spec => spec.alias);
+}
+// ── config/index.ts surgical un-register ─────────────────────
+/**
+ * Remove the `import <key> from './<key>.js'` line + the `<key>` entry in
+ * the `const configs = { ... }` object. Mirror of `registerConfigKey` in
+ * add.ts. Idempotent — bails cleanly if the key isn't currently registered.
+ *
+ * Returns `'ok' | 'not-registered' | 'unrecognized-shape'`.
+ */
+export function unregisterConfigKey(indexPath, key) {
+    const src = readFileSync(indexPath, 'utf8');
+    // Find the import line for this key.
+    // Match: optional leading newline, `import <key>` (any whitespace), `from './<key>.js'`, trailing newline.
+    const importLineRe = new RegExp(`\\n?import\\s+${key}\\s+from\\s+'\\./${key}\\.js'\\s*\\n?`);
+    const importMatch = importLineRe.exec(src);
+    if (!importMatch)
+        return 'not-registered';
+    // Find the configs block.
+    const configsRe = /const\s+configs\s*=\s*\{([^}]*)\}/;
+    const configsMatch = configsRe.exec(src);
+    if (!configsMatch)
+        return 'unrecognized-shape';
+    // Strip the key from the configs object literal.
+    const keys = configsMatch[1].split(',').map(s => s.trim()).filter(Boolean);
+    if (!keys.includes(key))
+        return 'unrecognized-shape'; // import present but key absent — manual edit, bail
+    const remainingKeys = keys.filter(k => k !== key);
+    // Splice both edits. Apply the configs replacement first (further right in
+    // the file) so its offset stays stable while we then drop the import line.
+    let out = src.slice(0, configsMatch.index)
+        + `const configs = { ${remainingKeys.join(', ')} }`
+        + src.slice(configsMatch.index + configsMatch[0].length);
+    // Re-run the import regex on the mutated string — offsets shifted.
+    const newImportMatch = importLineRe.exec(out);
+    if (newImportMatch) {
+        // Preserve a single newline at the seam so the surrounding imports still
+        // form a contiguous block with no double blank lines.
+        const replacement = newImportMatch[0].startsWith('\n') && newImportMatch[0].endsWith('\n') ? '\n' : '';
+        out = out.slice(0, newImportMatch.index) + replacement + out.slice(newImportMatch.index + newImportMatch[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 removeCommand(program) {
+    program
+        .command('remove <package>')
+        .description('Uninstall a RudderJS package — reverses `rudder add` (removes dep, config file, and unregisters)')
+        .option('--keep-config', 'Leave config/<name>.ts and the config/index.ts entry in place')
+        .action(async (packageName, opts) => {
+        const cwd = process.cwd();
+        const spec = findSpec(packageName);
+        if (!spec) {
+            const valid = REGISTRY.map(p => p.alias).join(', ');
+            console.error(`[rudder remove] Unknown package "${packageName}".\n  Available: ${valid}`);
+            process.exit(1);
+        }
+        // Idempotency — already gone?
+        if (!isInstalled(cwd, spec.npmName)) {
+            console.log(`  ${spec.npmName} is not installed — nothing to remove.`);
+            // Still try to clean any leftover config files (e.g. config wired but
+            // dep already removed by hand). Surfaces inconsistent state.
+            if (!opts.keepConfig && spec.config) {
+                const configFile = path.join(cwd, 'config', `${spec.config.key}.ts`);
+                const indexFile = path.join(cwd, 'config', 'index.ts');
+                if (existsSync(configFile)) {
+                    unlinkSync(configFile);
+                    console.log(`  Cleaned up orphaned config/${spec.config.key}.ts`);
+                }
+                if (existsSync(indexFile)) {
+                    const result = unregisterConfigKey(indexFile, spec.config.key);
+                    if (result === 'ok')
+                        console.log(`  Cleaned up orphaned entry in config/index.ts`);
+                }
+            }
+            return;
+        }
+        // Refuse if other installed packages depend on this one.
+        const dependents = findInstalledDependents(cwd, spec.alias);
+        if (dependents.length > 0) {
+            console.error(`[rudder remove] Cannot remove ${spec.alias} — these installed packages depend on it: ${dependents.join(', ')}`);
+            console.error(`  Remove them first, or keep ${spec.alias} installed.`);
+            process.exit(1);
+        }
+        const pm = detectPackageManager();
+        // 1. Uninstall the dependency
+        console.log(`\n  Removing ${spec.npmName}...`);
+        const ok = await runChild(pm, pmRemove(pm, spec.npmName), cwd);
+        if (!ok) {
+            console.error(`[rudder remove] ${pm} ${pmRemove(pm, spec.npmName).join(' ')} failed.`);
+            process.exit(1);
+        }
+        // 2. Delete config file (unless --keep-config)
+        if (!opts.keepConfig && spec.config) {
+            const configFile = path.join(cwd, 'config', `${spec.config.key}.ts`);
+            if (existsSync(configFile)) {
+                unlinkSync(configFile);
+                console.log(`  Deleted config/${spec.config.key}.ts`);
+            }
+            // 3. Unregister from config/index.ts
+            const indexFile = path.join(cwd, 'config', 'index.ts');
+            if (existsSync(indexFile)) {
+                const result = unregisterConfigKey(indexFile, spec.config.key);
+                if (result === 'ok') {
+                    console.log(`  Unregistered "${spec.config.key}" in config/index.ts`);
+                }
+                else if (result === 'unrecognized-shape') {
+                    console.warn(`  ⚠ Could not auto-edit config/index.ts (custom shape).`);
+                    console.warn(`    Remove manually: the import line and key for "${spec.config.key}".`);
+                }
+                // 'not-registered' is silent — nothing to do.
+            }
+        }
+        // 4. Refresh provider manifest so the freshly-removed provider drops out.
+        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.`);
+        }
+        console.log();
+        console.log(`  ✓ ${spec.alias} removed.`);
+    });
+}
+// ── Test exports ──────────────────────────────────────────────
+export const _testInternal = { findInstalledDependents };
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

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

package/dist/doctor/boot-status.d.ts

@@ -0,0 +1,10 @@
+export interface BootStatus {
+    ok: boolean;
+    error?: string;
+    /** Wall-clock ms the bootApp() call took (success or failure). */
+    durationMs: number;
+}
+export declare function setBootStatus(status: BootStatus): void;
+export declare function getBootStatus(): BootStatus | null;
+export declare function clearBootStatus(): void;
+//# sourceMappingURL=boot-status.d.ts.map

package/dist/doctor/boot-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-status.d.ts","sourceRoot":"","sources":["../../src/doctor/boot-status.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAK,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEtD;AAED,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/doctor/boot-status.js

@@ -0,0 +1,15 @@
+// Boot status singleton — set by the doctor command's --deep path, read by
+// runtime checks. Lives on globalThis so per-package checks (which import
+// from @rudderjs/cli's dist subpath) see the same value.
+const KEY = '__rudderjs_doctor_boot_status__';
+export function setBootStatus(status) {
+    ;
+    globalThis[KEY] = status;
+}
+export function getBootStatus() {
+    return globalThis[KEY];
+}
+export function clearBootStatus() {
+    delete globalThis[KEY];
+}
+//# sourceMappingURL=boot-status.js.map

package/dist/doctor/boot-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-status.js","sourceRoot":"","sources":["../../src/doctor/boot-status.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,yDAAyD;AASzD,MAAM,GAAG,GAAG,iCAAiC,CAAA;AAE7C,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,CAAC;IAAC,UAAsC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAQ,UAAsC,CAAC,GAAG,CAAsB,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAQ,UAAsC,CAAC,GAAG,CAAC,CAAA;AACrD,CAAC"}

package/dist/doctor/built-in/_fs.d.ts

@@ -0,0 +1,11 @@
+/** True if `<cwd>/<rel>` exists and is a file. */
+export declare function fileExists(rel: string): boolean;
+/** Read `<cwd>/<rel>` as a UTF-8 string. Returns null on any error. */
+export declare function readFileSafe(rel: string): string | null;
+/** `fs.stat(<cwd>/<rel>).mtimeMs` or null on error. */
+export declare function mtimeMs(rel: string): number | null;
+/** True if any of the given relative paths exists (file or dir). */
+export declare function anyExists(rels: string[]): boolean;
+/** Read JSON file at `<cwd>/<rel>` or null on error. */
+export declare function readJsonSafe<T = unknown>(rel: string): T | null;
+//# sourceMappingURL=_fs.d.ts.map

package/dist/doctor/built-in/_fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fs.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/_fs.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlD;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAQjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAQ/D"}

package/dist/doctor/built-in/_fs.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/** True if `<cwd>/<rel>` exists and is a file. */
+export function fileExists(rel) {
+    try {
+        return fs.statSync(path.join(process.cwd(), rel)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Read `<cwd>/<rel>` as a UTF-8 string. Returns null on any error. */
+export function readFileSafe(rel) {
+    try {
+        return fs.readFileSync(path.join(process.cwd(), rel), 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** `fs.stat(<cwd>/<rel>).mtimeMs` or null on error. */
+export function mtimeMs(rel) {
+    try {
+        return fs.statSync(path.join(process.cwd(), rel)).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/** True if any of the given relative paths exists (file or dir). */
+export function anyExists(rels) {
+    for (const rel of rels) {
+        try {
+            fs.statSync(path.join(process.cwd(), rel));
+            return true;
+        }
+        catch { /* keep looking */ }
+    }
+    return false;
+}
+/** Read JSON file at `<cwd>/<rel>` or null on error. */
+export function readJsonSafe(rel) {
+    const text = readFileSafe(rel);
+    if (text === null)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=_fs.js.map

package/dist/doctor/built-in/_fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fs.js","sourceRoot":"","sources":["../../../src/doctor/built-in/_fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,kDAAkD;AAClD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;YAC1C,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAc,GAAW;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/doctor/built-in/deps.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deps.d.ts.map

package/dist/doctor/built-in/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/deps.ts"],"names":[],"mappings":""}

package/dist/doctor/built-in/deps.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { registerDoctorCheck } from '@rudderjs/console';
+import { fileExists, mtimeMs, readJsonSafe } from './_fs.js';
+function isResolvable(pkg) {
+    const target = path.join(process.cwd(), 'node_modules', pkg, 'package.json');
+    try {
+        return fs.statSync(target).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+registerDoctorCheck({
+    id: 'deps:providers-manifest',
+    category: 'deps',
+    title: 'providers manifest',
+    run() {
+        const manifest = 'bootstrap/cache/providers.json';
+        if (!fileExists(manifest)) {
+            return {
+                status: 'warn',
+                message: 'missing — providers won\'t auto-discover',
+                fix: 'pnpm rudder providers:discover',
+            };
+        }
+        const manifestMtime = mtimeMs(manifest);
+        const pkgMtime = mtimeMs('package.json');
+        if (manifestMtime !== null && pkgMtime !== null && manifestMtime < pkgMtime) {
+            return {
+                status: 'warn',
+                message: 'older than package.json — packages added since last refresh',
+                fix: 'pnpm rudder providers:discover',
+            };
+        }
+        return { status: 'ok', message: 'present and current' };
+    },
+    async fixer() {
+        // Same logic as `rudder providers:discover` but invoked in-process so
+        // --fix doesn't shell out. `@rudderjs/core/commands/providers-discover`
+        // re-exports the two pure pieces — scanner + writer.
+        try {
+            const { scanProviders, writeProviderManifest } = await import(
+            /* @vite-ignore */ '@rudderjs/core/commands/providers-discover');
+            const sorted = scanProviders(process.cwd());
+            writeProviderManifest(process.cwd(), sorted);
+            return { status: 'ok', message: `regenerated (${sorted.length} provider${sorted.length === 1 ? '' : 's'})` };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { status: 'error', message: `could not regenerate: ${msg}` };
+        }
+    },
+});
+registerDoctorCheck({
+    id: 'deps:declared-installed',
+    category: 'deps',
+    title: '@rudderjs/* installed',
+    run() {
+        const pkg = readJsonSafe('package.json');
+        if (!pkg) {
+            return { status: 'error', message: 'package.json unreadable', fix: 'Check the file exists and is valid JSON' };
+        }
+        const declared = [
+            ...Object.keys(pkg.dependencies ?? {}),
+            ...Object.keys(pkg.devDependencies ?? {}),
+        ].filter(name => name.startsWith('@rudderjs/') || name === 'create-rudder-app');
+        const missing = declared.filter(name => !isResolvable(name));
+        if (missing.length > 0) {
+            return {
+                status: 'error',
+                message: `${missing.length} declared but not in node_modules: ${missing.join(', ')}`,
+                fix: 'Run your package manager install (e.g. `pnpm install`)',
+            };
+        }
+        return { status: 'ok', message: `${declared.length} declared, all resolvable` };
+    },
+});
+// `deps:auth-views` moved to @rudderjs/auth/doctor in Phase 3 — it's a
+// package-specific concern that lives with the package that owns it.
+//# sourceMappingURL=deps.js.map

package/dist/doctor/built-in/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../src/doctor/built-in/deps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAqB,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAO5D,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,CAAC,CAAA;IAC5E,IAAI,CAAC;QAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;AACpE,CAAC;AAED,mBAAmB,CAAC;IAClB,EAAE,EAAQ,yBAAyB;IACnC,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAK,oBAAoB;IAC9B,GAAG;QACD,MAAM,QAAQ,GAAG,gCAAgC,CAAA;QACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,MAAM,EAAG,MAAM;gBACf,OAAO,EAAE,0CAA0C;gBACnD,GAAG,EAAM,gCAAgC;aAC1C,CAAA;QACH,CAAC;QACD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAQ,OAAO,CAAC,cAAc,CAAC,CAAA;QAC7C,IAAI,aAAa,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,IAAI,aAAa,GAAG,QAAQ,EAAE,CAAC;YAC5E,OAAO;gBACL,MAAM,EAAG,MAAM;gBACf,OAAO,EAAE,6DAA6D;gBACtE,GAAG,EAAM,gCAAgC;aAC1C,CAAA;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAA;IACzD,CAAC;IACD,KAAK,CAAC,KAAK;QACT,sEAAsE;QACtE,wEAAwE;QACxE,qDAAqD;QACrD,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM;YAC3D,kBAAkB,CAAC,4CAA4C,CACD,CAAA;YAChE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;YAC3C,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;YAC5C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAA;QAC9G,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YACtD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,GAAG,EAAE,EAAE,CAAA;QACrE,CAAC;IACH,CAAC;CACF,CAAC,CAAA;AAEF,mBAAmB,CAAC;IAClB,EAAE,EAAQ,yBAAyB;IACnC,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAK,uBAAuB;IACjC,GAAG;QACD,MAAM,GAAG,GAAG,YAAY,CAAS,cAAc,CAAC,CAAA;QAChD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,GAAG,EAAE,yCAAyC,EAAE,CAAA;QAChH,CAAC;QACD,MAAM,QAAQ,GAAG;YACf,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAO,EAAE,CAAC;YACzC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;SAC1C,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,KAAK,mBAAmB,CAAC,CAAA;QAE/E,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAG,OAAO;gBAChB,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACpF,GAAG,EAAM,wDAAwD;aAClE,CAAA;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,2BAA2B,EAAE,CAAA;IACjF,CAAC;CACF,CAAC,CAAA;AAEF,uEAAuE;AACvE,qEAAqE"}

package/dist/doctor/built-in/env-vars.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env-vars.d.ts.map

package/dist/doctor/built-in/env-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-vars.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/env-vars.ts"],"names":[],"mappings":""}

package/dist/doctor/built-in/env-vars.js

@@ -0,0 +1,99 @@
+import { registerDoctorCheck } from '@rudderjs/console';
+import { readFileSafe, fileExists } from './_fs.js';
+/**
+ * Minimal `.env` parser — covers `KEY=value`, `KEY="value"`, comments, blanks.
+ * Doesn't expand `${VAR}` references; we only need to check declared keys.
+ */
+function parseEnvText(text) {
+    const out = new Map();
+    for (const rawLine of text.split('\n')) {
+        const line = rawLine.replace(/^\s+|\s+$/g, '');
+        if (!line || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out.set(key, value);
+    }
+    return out;
+}
+registerDoctorCheck({
+    id: 'env:dotenv-loadable',
+    category: 'env',
+    title: '.env file',
+    run() {
+        if (!fileExists('.env')) {
+            const exampleHint = fileExists('.env.example')
+                ? 'Run `cp .env.example .env` and fill in the secrets'
+                : 'Create a .env file with your config (APP_KEY, AUTH_SECRET, etc.)';
+            return { status: 'error', message: 'missing', fix: exampleHint };
+        }
+        const text = readFileSafe('.env');
+        if (text === null) {
+            return { status: 'error', message: 'present but unreadable', fix: 'Check file permissions on .env' };
+        }
+        const parsed = parseEnvText(text);
+        return { status: 'ok', message: `parses (${parsed.size} keys)` };
+    },
+});
+registerDoctorCheck({
+    id: 'env:app-key',
+    category: 'env',
+    title: 'APP_KEY',
+    run() {
+        const v = process.env['APP_KEY'];
+        if (!v) {
+            return {
+                status: 'error',
+                message: 'unset',
+                fix: 'Generate a 32-byte base64 key (e.g. `node -e "console.log(require(\'crypto\').randomBytes(32).toString(\'base64\'))"`) and put it in .env',
+            };
+        }
+        // APP_KEY can be raw or base64-encoded. Accept either form, validate decoded length.
+        let decodedLen;
+        try {
+            decodedLen = Buffer.from(v, 'base64').length;
+        }
+        catch {
+            decodedLen = Buffer.byteLength(v);
+        }
+        if (decodedLen < 32) {
+            return {
+                status: 'warn',
+                message: `present but only ${decodedLen} bytes — needs ≥ 32 for AES-256`,
+                fix: 'Generate a fresh 32-byte key with `node -e "console.log(require(\'crypto\').randomBytes(32).toString(\'base64\'))"`',
+            };
+        }
+        return { status: 'ok', message: `set, ${decodedLen} bytes` };
+    },
+});
+registerDoctorCheck({
+    id: 'env:app-env',
+    category: 'env',
+    title: 'APP_ENV',
+    run() {
+        const v = process.env['APP_ENV'] ?? process.env['NODE_ENV'];
+        if (!v) {
+            return {
+                status: 'warn',
+                message: 'unset — defaults to "production" in many adapters',
+                fix: 'Add `APP_ENV=local` (or `dev`/`staging`/`production`) to .env',
+            };
+        }
+        const known = ['local', 'dev', 'development', 'test', 'staging', 'production'];
+        if (!known.includes(v)) {
+            return {
+                status: 'warn',
+                message: `non-standard value "${v}"`,
+                fix: `Use one of: ${known.join(', ')}`,
+            };
+        }
+        return { status: 'ok', message: v };
+    },
+});
+//# sourceMappingURL=env-vars.js.map

package/dist/doctor/built-in/env-vars.js.map

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

package/dist/doctor/built-in/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in doctor checks owned by `@rudderjs/cli`. Each module's side-effect
+ * import calls `registerDoctorCheck()` so the checks are visible to the
+ * orchestrator after `loadBuiltInChecks()` runs.
+ */
+import './node-version.js';
+import './package-manager.js';
+import './env-vars.js';
+import './structure.js';
+import './deps.js';
+import './runtime.js';
+export declare function loadBuiltInChecks(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/doctor/built-in/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,mBAAmB,CAAA;AAC1B,OAAO,sBAAsB,CAAA;AAC7B,OAAO,eAAe,CAAA;AACtB,OAAO,gBAAgB,CAAA;AACvB,OAAO,WAAW,CAAA;AAClB,OAAO,cAAc,CAAA;AAErB,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}

package/dist/doctor/built-in/index.js

@@ -0,0 +1,18 @@
+/**
+ * Built-in doctor checks owned by `@rudderjs/cli`. Each module's side-effect
+ * import calls `registerDoctorCheck()` so the checks are visible to the
+ * orchestrator after `loadBuiltInChecks()` runs.
+ */
+import './node-version.js';
+import './package-manager.js';
+import './env-vars.js';
+import './structure.js';
+import './deps.js';
+import './runtime.js';
+export function loadBuiltInChecks() {
+    // Module loading is sufficient — side-effect imports above call
+    // registerDoctorCheck() at module-init time. This function exists so the
+    // doctor command can force the imports (otherwise tree-shaking would
+    // drop them).
+}
+//# sourceMappingURL=index.js.map

package/dist/doctor/built-in/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,mBAAmB,CAAA;AAC1B,OAAO,sBAAsB,CAAA;AAC7B,OAAO,eAAe,CAAA;AACtB,OAAO,gBAAgB,CAAA;AACvB,OAAO,WAAW,CAAA;AAClB,OAAO,cAAc,CAAA;AAErB,MAAM,UAAU,iBAAiB;IAC/B,gEAAgE;IAChE,yEAAyE;IACzE,qEAAqE;IACrE,cAAc;AAChB,CAAC"}

package/dist/doctor/built-in/node-version.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-version.d.ts.map

package/dist/doctor/built-in/node-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/node-version.ts"],"names":[],"mappings":""}