@gurulu/cli 0.4.6 → 1.0.0

package/dist/commands/watch.js

@@ -1,258 +0,0 @@
-"use strict";
-/**
- * Sprint B Group VII B14 — `gurulu watch` live event stream.
- *
- * Tail every event for the active tenant in near-real time, with optional
- * filtering by site / event types. Uses the existing CLI SSE endpoint
- * (/api/cli/events/tail) so we don't duplicate poll/heartbeat plumbing.
- *
- *   gurulu watch                              # all sites, all events
- *   gurulu watch --site=site_123              # one site
- *   gurulu watch --types=$purchase,page_view  # filter by event names (CSV)
- *   gurulu watch --tail=50                    # show last N before streaming
- *   gurulu watch --json                       # one JSON line per event
- *
- * Auth: bearer token from active profile (`loadActiveProfile` via cliApi).
- * Graceful shutdown: SIGINT cancels the fetch via AbortController.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.watchCommand = watchCommand;
-exports.formatEventLine = formatEventLine;
-const api_client_1 = require("../api-client");
-const ui_1 = require("../utils/ui");
-async function watchCommand(args) {
-    const types = parseTypes(args.types);
-    const tailCount = Math.max(0, Number(args.tail) || 0);
-    // 1. Optional tail of recent events before streaming.
-    if (tailCount > 0) {
-        await printTail(args, types, tailCount);
-    }
-    // 2. Open the SSE stream and forward events until SIGINT.
-    await streamEvents(args, types);
-}
-function parseTypes(raw) {
-    if (!raw)
-        return null;
-    const list = raw
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-    if (list.length === 0)
-        return null;
-    return new Set(list);
-}
-async function printTail(args, types, tailCount) {
-    const qs = new URLSearchParams();
-    if (args.site)
-        qs.set('site', args.site);
-    // The tail-history endpoint accepts a single event_name. When the user
-    // requested multiple, fetch the union and filter client-side.
-    if (types && types.size === 1) {
-        qs.set('event_name', Array.from(types)[0]);
-    }
-    qs.set('limit', String(Math.min(tailCount * (types ? 5 : 1), 500)));
-    qs.set('since', '24h');
-    const path = `/api/cli/events?${qs.toString()}`;
-    let body;
-    try {
-        body = await (0, api_client_1.cliApiJson)(path, {
-            profile: args.profile,
-        });
-    }
-    catch (err) {
-        (0, ui_1.error)(`Failed to fetch tail history: ${err.message}`);
-        return;
-    }
-    const all = body.events || [];
-    const filtered = (types ? all.filter((e) => e.event_name && types.has(e.event_name)) : all)
-        .slice(-tailCount) // keep the newest N (events arrive newest-first)
-        .reverse();
-    if (filtered.length === 0) {
-        if (!args.json)
-            (0, ui_1.info)('No prior events in the last 24h.');
-    }
-    for (const ev of filtered) {
-        process.stdout.write(formatEventLine(ev, !!args.json));
-    }
-    if (!args.json && filtered.length > 0) {
-        process.stdout.write((0, ui_1.dim)('  --- live stream ---\n'));
-    }
-}
-async function streamEvents(args, types) {
-    const qs = new URLSearchParams();
-    if (args.site)
-        qs.set('site', args.site);
-    // SSE backend accepts a single eventName. Multi-type filter is applied on
-    // the client. (Forwarded as a hint when only one is set so the server can
-    // skip irrelevant rows entirely.)
-    if (types && types.size === 1)
-        qs.set('event_name', Array.from(types)[0]);
-    const path = args.endpoint ||
-        `/api/cli/events/tail${qs.toString() ? `?${qs.toString()}` : ''}`;
-    // SIGINT → abort the fetch so the SSE socket is released cleanly.
-    const controller = new AbortController();
-    const onSigint = () => {
-        if (!args.json)
-            process.stderr.write((0, ui_1.dim)('\n[watch] disconnected\n'));
-        controller.abort();
-        // Give the abort path a tick to drain, then exit normally.
-        setTimeout(() => process.exit(0), 25);
-    };
-    process.on('SIGINT', onSigint);
-    process.on('SIGTERM', onSigint);
-    if (!args.json) {
-        (0, ui_1.info)(`Streaming events${args.site ? ` for site=${args.site}` : ''}${types ? ` types=[${Array.from(types).join(',')}]` : ''} — Ctrl+C to stop`);
-    }
-    // Reconnect loop — SSE streams cap at 10 minutes server-side. Honour the
-    // `reconnect` frame and any transient network drop.
-    let attempt = 0;
-    while (!controller.signal.aborted) {
-        try {
-            const res = await (0, api_client_1.cliApi)(path, {
-                profile: args.profile,
-                headers: { accept: 'text/event-stream' },
-                signal: controller.signal,
-            });
-            if (!res.body) {
-                (0, ui_1.error)('Watch stream returned no body.');
-                return;
-            }
-            attempt = 0; // reset backoff on successful connect
-            await consumeSseBody(res.body, types, !!args.json);
-            // Stream ended cleanly (max_lifetime). Re-open immediately.
-        }
-        catch (err) {
-            if (controller.signal.aborted)
-                return;
-            attempt += 1;
-            const wait = Math.min(15_000, 500 * 2 ** attempt);
-            if (!args.json) {
-                process.stderr.write((0, ui_1.dim)(`[watch] connection lost (${err.message}); reconnecting in ${wait}ms\n`));
-            }
-            await sleep(wait);
-        }
-    }
-}
-async function consumeSseBody(body, types, json) {
-    // Browser-style ReadableStream
-    const reader = body.getReader?.();
-    if (reader) {
-        const decoder = new TextDecoder();
-        let buffer = '';
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done)
-                return;
-            buffer += decoder.decode(value, { stream: true });
-            const flushed = drainSseBuffer(buffer);
-            buffer = flushed.tail;
-            for (const frame of flushed.frames)
-                emitFrame(frame, types, json);
-        }
-    }
-    // Node Readable fallback
-    let buffer = '';
-    for await (const chunk of body) {
-        buffer += Buffer.from(chunk).toString('utf8');
-        const flushed = drainSseBuffer(buffer);
-        buffer = flushed.tail;
-        for (const frame of flushed.frames)
-            emitFrame(frame, types, json);
-    }
-}
-function drainSseBuffer(buffer) {
-    const frames = [];
-    let idx = buffer.indexOf('\n\n');
-    while (idx !== -1) {
-        const block = buffer.slice(0, idx);
-        buffer = buffer.slice(idx + 2);
-        let event = 'message';
-        let data = '';
-        for (const line of block.split('\n')) {
-            if (line.startsWith('event: '))
-                event = line.slice(7).trim();
-            else if (line.startsWith('data: '))
-                data += line.slice(6);
-        }
-        if (data)
-            frames.push({ event, data });
-        idx = buffer.indexOf('\n\n');
-    }
-    return { frames, tail: buffer };
-}
-function emitFrame(frame, types, json) {
-    if (frame.event !== 'realtime_event')
-        return;
-    let row;
-    try {
-        row = JSON.parse(frame.data);
-    }
-    catch {
-        return;
-    }
-    if (types && row.event_name && !types.has(row.event_name))
-        return;
-    process.stdout.write(formatEventLine(row, json));
-}
-function formatEventLine(row, json) {
-    if (json)
-        return JSON.stringify(row) + '\n';
-    const ts = formatTimestamp(row.event_ts);
-    const name = String(row.event_name || '-').padEnd(14);
-    const namePainted = paintEvent(name, String(row.event_name || ''));
-    const who = formatActor(row);
-    const site = row.site_name || row.site_id ? `site=${row.site_name || row.site_id}` : '';
-    const tail = formatTail(row);
-    return `${(0, ui_1.dim)(ts)}  ${namePainted}  ${who}${site ? ' ' + (0, ui_1.dim)(site) : ''}${tail ? '  ' + tail : ''}\n`;
-}
-function formatTimestamp(ts) {
-    if (!ts)
-        return '----------------'.padEnd(19);
-    // ClickHouse format: '2026-04-27 14:23:01' (UTC) or ISO. Take the first 19.
-    const cleaned = ts.replace('T', ' ').slice(0, 19);
-    return cleaned.padEnd(19);
-}
-function paintEvent(padded, raw) {
-    if (!raw)
-        return padded;
-    if (raw.startsWith('$'))
-        return (0, ui_1.cyan)(padded); // system events
-    if (raw.startsWith('error'))
-        return (0, ui_1.yellow)(padded);
-    if (raw === 'page_view' || raw === 'pageview')
-        return (0, ui_1.dim)(padded);
-    return (0, ui_1.green)(padded);
-}
-function formatActor(row) {
-    if (row.user_id)
-        return `${(0, ui_1.bold)('user')}=${String(row.user_id).slice(0, 8)}`;
-    if (row.anonymous_id)
-        return `anon=${String(row.anonymous_id).slice(0, 6)}`;
-    return (0, ui_1.dim)('anon=?');
-}
-function formatTail(row) {
-    const parts = [];
-    const url = row.url || row.page_url;
-    if (url)
-        parts.push(stripHost(String(url)));
-    if (row.selector)
-        parts.push(`selector=${row.selector}`);
-    if (row.revenue_value != null && Number(row.revenue_value) > 0) {
-        const cur = row.revenue_currency || 'USD';
-        parts.push(`value=${row.revenue_value} ${cur}`);
-    }
-    return parts.join(' ');
-}
-function stripHost(url) {
-    try {
-        const u = new URL(url);
-        return u.pathname + (u.search || '');
-    }
-    catch {
-        return url;
-    }
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/dist/commands/whoami.d.ts

@@ -1,9 +0,0 @@
-/**
- * Phase 18.5 W2 — `gurulu whoami`. Loads the active profile and hits
- * `/api/cli/me` for a concise one-line summary. Supports --json.
- */
-export interface WhoamiArgs {
-    profile?: string;
-    json?: boolean;
-}
-export declare function whoamiCommand(args: WhoamiArgs): Promise<void>;

package/dist/commands/whoami.js

@@ -1,50 +0,0 @@
-"use strict";
-/**
- * Phase 18.5 W2 — `gurulu whoami`. Loads the active profile and hits
- * `/api/cli/me` for a concise one-line summary. Supports --json.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.whoamiCommand = whoamiCommand;
-const config_1 = require("../config");
-const api_client_1 = require("../api-client");
-const ui_1 = require("../utils/ui");
-async function whoamiCommand(args) {
-    let profile;
-    try {
-        profile = await (0, config_1.loadActiveProfile)({ profile: args.profile });
-    }
-    catch {
-        if (args.json) {
-            process.stdout.write(JSON.stringify({ error: 'not_logged_in' }) + '\n');
-        }
-        else {
-            (0, ui_1.error)('Not logged in. Run `gurulu login` first.');
-        }
-        process.exit(1);
-    }
-    try {
-        const me = await (0, api_client_1.cliApiJson)('/api/cli/me', { preloadedProfile: profile });
-        if (args.json) {
-            process.stdout.write(JSON.stringify(me, null, 2) + '\n');
-            return;
-        }
-        const sites = (me.sites || []).length;
-        const keys = (me.apiKeys || []).length;
-        const installs = me.quota?.installsThisMonth ?? 0;
-        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`);
-    }
-    catch (err) {
-        if (args.json) {
-            process.stdout.write(JSON.stringify({ error: err.message }) + '\n');
-        }
-        else {
-            (0, ui_1.error)(`whoami failed: ${err.message}`);
-        }
-        process.exit(1);
-    }
-}

package/dist/config.d.ts

@@ -1,75 +0,0 @@
-/**
- * Phase 18.5 W2 — Multi-profile CLI config.
- *
- * Replaces the single-profile `~/.gurulu/config.json` used by earlier phases
- * with a profile-aware store, while keeping backward compatibility for
- * commands that still call `utils/config.ts` (they now read from the
- * currently-active profile).
- *
- * Resolution order for a live session:
- *   1. GURULU_SECRET_KEY  (env-var override — bypasses the file entirely)
- *   2. --profile <name>   (CLI flag)
- *   3. GURULU_PROFILE     (env)
- *   4. default_profile    (from file)
- *   5. 'personal'         (final fallback)
- *
- * Optional macOS keychain integration: if `keytar` is available at runtime,
- * secrets can be stored there under service 'io.gurulu.cli' account
- * `<profile>`. If unavailable, secrets fall back to the plaintext file.
- * Keytar is a **soft runtime require** — never a hard dependency, because
- * it's a native module and we don't want to force its install.
- */
-export interface ProfileConfig {
-    email: string;
-    secret_key: string;
-    api_base: string;
-}
-export interface StoredProfile {
-    email: string;
-    secret_key?: string;
-    api_base: string;
-    keychain?: boolean;
-}
-export interface ConfigFile {
-    default_profile: string;
-    profiles: Record<string, StoredProfile>;
-}
-export interface ActiveProfile extends ProfileConfig {
-    name: string;
-    source: 'env' | 'file' | 'keychain';
-}
-export interface CliFlags {
-    profile?: string;
-}
-export declare function configPath(): string;
-export declare function readKeychainSecret(profile: string): Promise<string | null>;
-export declare function writeKeychainSecret(profile: string, secret: string): Promise<boolean>;
-export declare function deleteKeychainSecret(profile: string): Promise<void>;
-export declare function isKeychainAvailable(): boolean;
-export declare function listProfiles(): Array<{
-    name: string;
-    email: string;
-    api_base: string;
-    isDefault: boolean;
-    keychain: boolean;
-}>;
-export declare function getStoredProfile(name: string): StoredProfile | null;
-export declare function getDefaultProfileName(): string;
-export declare function setDefaultProfile(name: string): void;
-export declare function saveProfile(name: string, profile: ProfileConfig, opts?: {
-    useKeychain?: boolean;
-}): Promise<{
-    storedInKeychain: boolean;
-}>;
-export declare function deleteProfile(name: string): Promise<boolean>;
-export declare function deleteAllProfiles(): Promise<string[]>;
-/**
- * Resolve the active profile given CLI flags. Throws if no usable profile.
- * Accepts the `GURULU_SECRET_KEY` env var as an override for CI.
- */
-export declare function loadActiveProfile(flags?: CliFlags): Promise<ActiveProfile>;
-export declare function getActiveProfile(flags?: CliFlags): Promise<ActiveProfile | null>;
-export declare class ProfileNotFoundError extends Error {
-    constructor(name: string);
-}
-export declare function defaultApiBase(): string;