@gurulu/cli 0.4.5 → 0.4.6

package/dist/api-client.d.ts

@@ -12,6 +12,12 @@ export interface CliApiOptions extends RequestInit {
     preloadedProfile?: ActiveProfile;
     /** Disable process.exit for tests. */
     noExitOnError?: boolean;
+    /**
+     * Surface raw error bodies on 5xx instead of the generic "temporarily
+     * unavailable" message. Caller should pass true when --json / --show-sql
+     * / any verbose flag is set. GURULU_DEBUG=1 also forces verbose globally.
+     */
+    verbose?: boolean;
 }
 export declare class CliApiError extends Error {
     status: number;

package/dist/api-client.js

@@ -129,6 +129,31 @@ async function cliApi(path, init = {}) {
         fatal(`Rate limited by Gurulu${retry ? ` — try again in ${retry}s` : ''}. Try again shortly.`, init);
     }
     if (res.status >= 500) {
+        const verbose = init.verbose === true || process.env.GURULU_DEBUG === '1';
+        if (verbose) {
+            let detail = '';
+            try {
+                const body = await res.clone().json();
+                const msg = body?.error || body?.message;
+                if (msg) {
+                    detail = ` ${typeof msg === 'string' ? msg : JSON.stringify(msg)}`;
+                }
+                else {
+                    detail = ` ${JSON.stringify(body)}`;
+                }
+            }
+            catch {
+                try {
+                    const txt = await res.clone().text();
+                    if (txt)
+                        detail = ` ${txt.slice(0, 500)}`;
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            fatal(`Gurulu is temporarily unavailable (HTTP ${res.status}).${detail}`, init);
+        }
         fatal(`Gurulu is temporarily unavailable (HTTP ${res.status}).`, init);
     }
     return res;

package/dist/commands/auth.js

@@ -54,22 +54,38 @@ const login_1 = require("./login");
 const config_1 = require("../config");
 const api_client_1 = require("../api-client");
 const ui_1 = require("../utils/ui");
+function isHeadless() {
+    if (!process.stdout.isTTY)
+        return true;
+    if (process.env.SSH_CLIENT || process.env.SSH_TTY || process.env.SSH_CONNECTION)
+        return true;
+    if (process.platform === 'linux' && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
+        return true;
+    return false;
+}
 function tryOpenBrowser(url) {
     const platform = process.platform;
     const cmd = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
+    // On Windows the URL goes as a positional after an empty title arg to `start`.
+    const args = platform === 'win32' ? ['', url] : [url];
     try {
-        const child = (0, child_process_1.spawn)(cmd, [url], {
+        const child = (0, child_process_1.spawn)(cmd, args, {
             detached: true,
             stdio: 'ignore',
             shell: platform === 'win32',
         });
+        let errored = false;
         child.on('error', () => {
-            /* ignore — fall back to manual */
+            errored = true;
         });
         child.unref();
+        // spawn() returns synchronously; if the binary is missing on PATH we'll
+        // catch the synchronous throw below. The async 'error' handler covers
+        // post-fork failures but we can't await it here without blocking the flow.
+        return !errored;
     }
     catch {
-        /* ignore — we printed the URL already */
+        return false;
     }
 }
 function sleep(ms) {
@@ -121,8 +137,17 @@ async function authCommand(args) {
     console.log(`  ${(0, ui_1.dim)('Visit:')}         ${verifyUrl}`);
     console.log(`  ${(0, ui_1.dim)('Device:')}        CLI — ${deviceLabel}`);
     console.log('');
-    if (!args.noBrowser) {
-        tryOpenBrowser(verifyUrl);
+    if (args.noBrowser) {
+        (0, ui_1.info)(`Open this URL manually: ${verifyUrl}`);
+    }
+    else if (isHeadless()) {
+        (0, ui_1.info)(`Headless/SSH session detected — open this URL on another device: ${verifyUrl}`);
+    }
+    else {
+        const opened = tryOpenBrowser(verifyUrl);
+        if (!opened) {
+            (0, ui_1.info)(`Could not auto-open the browser. Open this URL manually: ${verifyUrl}`);
+        }
     }
     const expiresAtMs = new Date(expiresAt).getTime();
     const interval = Math.max(1000, pollIntervalMs || 2000);
@@ -195,16 +220,26 @@ async function authCommand(args) {
         process.exit(1);
     }
     const fullKey = approved.secretKey.fullKey;
+    const userRequestedKeychain = args.useKeychain === true;
+    const keychainAvailable = (0, config_1.isKeychainAvailable)();
+    if (userRequestedKeychain && !keychainAvailable) {
+        (0, ui_1.warn)('Keychain requested via --keychain but the optional `keytar` module is not installed. ' +
+            'Falling back to plaintext storage in ~/.gurulu/config.json. ' +
+            'Install `keytar` (`npm i -g keytar`) or unset --keychain to silence this warning.');
+    }
     const { storedInKeychain } = await (0, config_1.saveProfile)(profileName, {
         email: `cli-${deviceLabel}@gurulu.local`,
         secret_key: fullKey,
         api_base: apiBase,
-    }, { useKeychain: args.useKeychain ?? (0, config_1.isKeychainAvailable)() });
+    }, { useKeychain: args.useKeychain ?? keychainAvailable });
     const tail = fullKey.slice(-6);
     (0, ui_1.success)(`Device paired. Key …${tail} saved to profile "${profileName}".`);
     if (storedInKeychain) {
         (0, ui_1.info)(`  Stored in macOS Keychain (${(0, ui_1.dim)('io.gurulu.cli')})`);
     }
+    else if (userRequestedKeychain) {
+        (0, ui_1.info)(`  Stored in plaintext at ~/.gurulu/config.json (keychain unavailable).`);
+    }
     if (approved.secretKey.expiresAt) {
         (0, ui_1.info)(`  Expires: ${approved.secretKey.expiresAt}`);
     }

package/dist/commands/doctor.js

@@ -23,6 +23,9 @@ async function doctorCommand(args) {
     const checks = [];
     // 1. Framework detection
     const framework = (0, detect_1.detectFramework)(projectDir);
+    // If the user explicitly passed --site, the cwd-derived checks should not
+    // imply that the *production site* is broken — they're informational only.
+    const isLocalProjectDetected = framework !== 'unknown';
     checks.push({
         name: 'Framework Detection',
         status: framework !== 'unknown' ? 'pass' : 'warn',
@@ -30,6 +33,7 @@ async function doctorCommand(args) {
             ? `Detected ${(0, detect_1.getFrameworkDisplayName)(framework)}`
             : 'Could not detect framework',
         fix: framework === 'unknown' ? 'Run "gurulu init --framework <name>" to specify manually' : undefined,
+        section: 'local',
     });
     // 2. SDK installed
     const pkgPath = path_1.default.join(projectDir, 'package.json');
@@ -78,18 +82,35 @@ async function doctorCommand(args) {
                     : hasAndroidSDK ? 'Android SDK found in build.gradle'
                         : setupFiles.length > 0 ? `Setup file found: ${setupFiles[0]}`
                             : 'No client SDK detected';
+    // When --site was passed but cwd is not a Gurulu project, downgrade local
+    // SDK failures to "skip" so they don't masquerade as production-site issues.
+    const localChecksAreInformational = !!siteId && !isLocalProjectDetected;
     checks.push({
         name: 'Client SDK',
-        status: hasSetup ? 'pass' : 'fail',
-        message: sdkLabel,
-        fix: !hasSetup ? 'Run "gurulu init" to set up analytics' : undefined,
+        status: hasSetup ? 'pass' : localChecksAreInformational ? 'skip' : 'fail',
+        message: hasSetup
+            ? sdkLabel
+            : localChecksAreInformational
+                ? 'No client SDK detected in this directory (informational — site checks below)'
+                : sdkLabel,
+        fix: !hasSetup && !localChecksAreInformational
+            ? 'Run "gurulu init" to set up analytics'
+            : undefined,
+        section: 'local',
     });
     // 3. Server SDK
     checks.push({
         name: 'Server SDK',
-        status: hasNodeSDK ? 'pass' : 'warn',
-        message: hasNodeSDK ? '@gurulu/node installed' : 'Server SDK not installed (optional)',
-        fix: !hasNodeSDK ? 'Run "gurulu add-server" for server-side tracking' : undefined,
+        status: hasNodeSDK ? 'pass' : localChecksAreInformational ? 'skip' : 'warn',
+        message: hasNodeSDK
+            ? '@gurulu/node installed'
+            : localChecksAreInformational
+                ? 'Server SDK check skipped (no local project detected)'
+                : 'Server SDK not installed (optional)',
+        fix: !hasNodeSDK && !localChecksAreInformational
+            ? 'Run "gurulu add-server" for server-side tracking'
+            : undefined,
+        section: 'local',
     });
     // 4. Site ID configured
     checks.push({
@@ -263,6 +284,7 @@ async function doctorCommand(args) {
             status: envHasSiteId ? 'pass' : 'warn',
             message: envHasSiteId ? 'Site ID found in env file' : 'No GURULU_SITE_ID in env files',
             fix: !envHasSiteId ? 'Run "gurulu init" to auto-configure .env.local' : undefined,
+            section: 'local',
         });
     }
     // Output
@@ -281,16 +303,36 @@ async function doctorCommand(args) {
     };
     let failCount = 0;
     let warnCount = 0;
-    for (const check of checks) {
-        const icon = icons[check.status];
-        console.log(`  ${icon} ${(0, ui_1.bold)(check.name)}: ${check.message}`);
-        if (check.fix) {
-            console.log(`    ${(0, ui_1.dim)('\u2192')} ${(0, ui_1.dim)(check.fix)}`);
+    const localChecks = checks.filter((c) => c.section === 'local');
+    const siteChecks = checks.filter((c) => c.section !== 'local');
+    const printGroup = (title, items, note) => {
+        if (items.length === 0)
+            return;
+        console.log(`  ${(0, ui_1.bold)(title)}`);
+        if (note)
+            console.log(`  ${(0, ui_1.dim)(note)}`);
+        for (const check of items) {
+            const icon = icons[check.status];
+            console.log(`    ${icon} ${(0, ui_1.bold)(check.name)}: ${check.message}`);
+            if (check.fix) {
+                console.log(`      ${(0, ui_1.dim)('\u2192')} ${(0, ui_1.dim)(check.fix)}`);
+            }
+            if (check.status === 'fail')
+                failCount++;
+            if (check.status === 'warn')
+                warnCount++;
         }
-        if (check.status === 'fail')
-            failCount++;
-        if (check.status === 'warn')
-            warnCount++;
+        console.log('');
+    };
+    if (localChecks.length > 0) {
+        const localNote = siteId && !isLocalProjectDetected
+            ? `(Local project not detected \u2014 running site-only checks for ${siteId}.)`
+            : undefined;
+        printGroup('Local Project', localChecks, localNote);
+    }
+    if (siteChecks.length > 0) {
+        const siteTitle = siteId ? `Site (${siteId})` : 'Site';
+        printGroup(siteTitle, siteChecks);
     }
     console.log('');
     if (failCount === 0 && warnCount === 0) {

package/dist/commands/events.js

@@ -76,10 +76,10 @@ async function listCmd(args) {
     process.stdout.write(['TS', 'EVENT', 'SITE', 'URL'].join('\t') + '\n');
     for (const e of events) {
         process.stdout.write([
-            String(e.event_ts || '-'),
+            String(e.timestamp || e.event_ts || '-'),
             String(e.event_name || '-'),
             String(e.site_id || '-'),
-            String(e.url || '-').slice(0, 60),
+            String(e.page_url || e.url || '-').slice(0, 60),
         ].join('\t') + '\n');
     }
 }

package/dist/commands/whoami.js

@@ -31,7 +31,10 @@ async function whoamiCommand(args) {
         const sites = (me.sites || []).length;
         const keys = (me.apiKeys || []).length;
         const installs = me.quota?.installsThisMonth ?? 0;
-        const limit = me.quota?.installsLimit ?? '∞';
+        const rawLimit = me.quota?.installsLimit;
+        const limit = rawLimit === -1 || rawLimit === null || rawLimit === undefined
+            ? 'unlimited'
+            : rawLimit;
         process.stdout.write(`${me.user?.email} · ${me.tenant?.name} · ${me.tenant?.plan} plan · ${me.tenant?.id}\n`);
         process.stdout.write(`Sites: ${sites} | API keys: ${keys} | Installs this month: ${installs}/${limit}\n`);
     }

package/dist/index.js

@@ -99,7 +99,7 @@ const secrets_1 = require("./commands/secrets");
     .option('key', { type: 'string', describe: 'Secret key (gsk_live_... or gsk_test_...) — legacy manual flow' })
     .option('email', { type: 'string', describe: 'Email address (legacy flow)' })
     .option('secret-key', { type: 'string', describe: 'Secret key (legacy flow alias for --key)' })
-    .option('no-browser', { type: 'boolean', describe: 'Do not auto-open the browser' })
+    .option('browser', { type: 'boolean', default: true, describe: 'Auto-open the browser (use --no-browser to disable)' })
     .option('no-interactive', { type: 'boolean', describe: 'Non-interactive mode (legacy flow)' })
     .option('keychain', { type: 'boolean', describe: 'Store secret in macOS Keychain if available' })
     .option('api-base', { type: 'string', describe: 'Override API base URL' }), (args) => (0, auth_1.authCommand)({
@@ -110,7 +110,7 @@ const secrets_1 = require("./commands/secrets");
     noInteractive: args['no-interactive'],
     useKeychain: args.keychain,
     apiBase: args['api-base'],
-    noBrowser: args['no-browser'],
+    noBrowser: args.browser === false ? true : undefined,
 }))
     .command('logout', 'Remove a stored profile', (y) => y
     .option('all', { type: 'boolean', describe: 'Remove all profiles' })
@@ -635,8 +635,8 @@ const secrets_1 = require("./commands/secrets");
     // ── Error tracking — source map upload ────────────────────────────────
     .command('sourcemap <action>', 'Upload source maps for error deobfuscation (upload). Supports web/server JS .map and native dSYM/ProGuard.', (y) => y
     .positional('action', { type: 'string', describe: 'upload' })
-    .option('release', { type: 'string', describe: 'Release version (e.g. v1.0.0). Web/server only — alias of --version.' })
-    .option('version', { type: 'string', describe: 'App version (e.g. 1.4.2). Required for native uploads.' })
+    .option('release', { type: 'string', describe: 'Release version (e.g. v1.0.0). Web/server only — alias of --app-version.' })
+    .option('app-version', { type: 'string', describe: 'App version (e.g. 1.4.2). Required for native uploads.' })
     .option('dir', { type: 'string', describe: 'Directory containing .map files (web/server)' })
     .option('file', { type: 'string', describe: 'Path to dSYM zip (iOS) or mapping.txt (Android)' })
     .option('bundle-id', { type: 'string', describe: 'iOS bundleId or Android applicationId (native only)' })
@@ -645,7 +645,7 @@ const secrets_1 = require("./commands/secrets");
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, sourcemap_1.sourcemapCommand)({
     action: args.action,
     release: args.release,
-    version: args.version,
+    version: args['app-version'],
     dir: args.dir,
     file: args.file,
     bundleId: args['bundle-id'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"