@gurulu/cli 0.4.7 → 1.0.0

package/dist/commands/upgrade.d.ts

@@ -1,21 +0,0 @@
-/**
- * FA-1 P1-4 — `gurulu upgrade` command.
- *
- * Bumps installed @gurulu/* packages to the latest version published on npm.
- * Reads current versions from `npm ls --depth=0 --json` so it works regardless
- * of which package manager is in use, then dispatches to the same `pm`
- * detection install.ts uses (npm/pnpm/yarn/bun) for the actual upgrade.
- *
- * Usage:
- *   gurulu upgrade                    # default: bump @gurulu/web
- *   gurulu upgrade --package=@gurulu/cli
- *   gurulu upgrade --all              # bump @gurulu/cli + @gurulu/node + @gurulu/web
- *   gurulu upgrade --dry-run          # show plan without executing
- */
-export interface UpgradeArgs {
-    package?: string;
-    all?: boolean;
-    dryRun?: boolean;
-    path?: string;
-}
-export declare function upgradeCommand(args: UpgradeArgs): Promise<void>;

package/dist/commands/upgrade.js

@@ -1,183 +0,0 @@
-"use strict";
-/**
- * FA-1 P1-4 — `gurulu upgrade` command.
- *
- * Bumps installed @gurulu/* packages to the latest version published on npm.
- * Reads current versions from `npm ls --depth=0 --json` so it works regardless
- * of which package manager is in use, then dispatches to the same `pm`
- * detection install.ts uses (npm/pnpm/yarn/bun) for the actual upgrade.
- *
- * Usage:
- *   gurulu upgrade                    # default: bump @gurulu/web
- *   gurulu upgrade --package=@gurulu/cli
- *   gurulu upgrade --all              # bump @gurulu/cli + @gurulu/node + @gurulu/web
- *   gurulu upgrade --dry-run          # show plan without executing
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.upgradeCommand = upgradeCommand;
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-const ui_1 = require("../utils/ui");
-const install_1 = require("./install");
-const DEFAULT_PACKAGES = ['@gurulu/cli', '@gurulu/node', '@gurulu/web'];
-function runCmd(cmd, args, opts = {}) {
-    return new Promise((resolve) => {
-        const child = (0, child_process_1.spawn)(cmd, args, {
-            cwd: opts.cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-            shell: process.platform === 'win32',
-        });
-        let stdout = '';
-        let stderr = '';
-        child.stdout.on('data', (c) => (stdout += c.toString()));
-        child.stderr.on('data', (c) => (stderr += c.toString()));
-        child.on('close', (code) => resolve({ code: code ?? 0, stdout, stderr }));
-        child.on('error', (err) => resolve({ code: 1, stdout, stderr: String(err) }));
-    });
-}
-async function getCurrentVersion(repoRoot, pkg) {
-    // `npm ls --depth=0 --json` works in any project regardless of which PM
-    // wrote the lockfile (npm reads node_modules directly). When the package
-    // is missing from node_modules the JSON is still valid; we just see no
-    // entry under `dependencies`.
-    const res = await runCmd('npm', ['ls', pkg, '--depth=0', '--json'], { cwd: repoRoot });
-    if (!res.stdout)
-        return null;
-    try {
-        const parsed = JSON.parse(res.stdout);
-        const dep = parsed.dependencies && parsed.dependencies[pkg];
-        if (dep && typeof dep.version === 'string')
-            return dep.version;
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-async function getLatestVersion(pkg) {
-    const res = await runCmd('npm', ['view', pkg, 'version']);
-    if (res.code !== 0)
-        return null;
-    const v = res.stdout.trim();
-    return v || null;
-}
-function pmUpgradeArgs(pm, pkg) {
-    if (pm === 'pnpm')
-        return ['update', '--latest', pkg];
-    if (pm === 'yarn')
-        return ['upgrade', `${pkg}@latest`];
-    if (pm === 'bun')
-        return ['update', pkg];
-    return ['install', `${pkg}@latest`];
-}
-function compareSemver(a, b) {
-    // Returns -1 if a < b, 0 if equal, 1 if a > b. Strips any leading `v` and
-    // pre-release suffixes ("1.2.3-rc.1" → ["1","2","3"]).
-    const norm = (s) => s
-        .replace(/^v/, '')
-        .split('-')[0]
-        .split('.')
-        .map((n) => parseInt(n, 10) || 0);
-    const aa = norm(a);
-    const bb = norm(b);
-    for (let i = 0; i < Math.max(aa.length, bb.length); i++) {
-        const x = aa[i] || 0;
-        const y = bb[i] || 0;
-        if (x < y)
-            return -1;
-        if (x > y)
-            return 1;
-    }
-    return 0;
-}
-async function upgradeCommand(args) {
-    const repoRoot = path.resolve(args.path || process.cwd());
-    const targets = args.all
-        ? DEFAULT_PACKAGES
-        : [args.package || '@gurulu/web'];
-    (0, ui_1.info)(`${(0, ui_1.bold)('gurulu upgrade')} — checking ${targets.length} package(s) in ${(0, ui_1.cyan)(repoRoot)}`);
-    const pm = (0, install_1.detectPackageManager)(repoRoot);
-    (0, ui_1.step)(`Package manager: ${(0, ui_1.bold)(pm)}`);
-    const plans = [];
-    for (const pkg of targets) {
-        const [current, latest] = await Promise.all([
-            getCurrentVersion(repoRoot, pkg),
-            getLatestVersion(pkg),
-        ]);
-        plans.push({ pkg, current, latest });
-    }
-    const toBump = [];
-    for (const p of plans) {
-        if (!p.latest) {
-            (0, ui_1.warn)(`${p.pkg}: could not resolve latest version (npm view failed).`);
-            continue;
-        }
-        if (!p.current) {
-            (0, ui_1.info)(`${p.pkg}: not installed — skipping (run \`gurulu install\` first).`);
-            continue;
-        }
-        const cmp = compareSemver(p.current, p.latest);
-        if (cmp >= 0) {
-            (0, ui_1.success)(`${p.pkg}: up-to-date (${p.current})`);
-            continue;
-        }
-        (0, ui_1.info)(`${p.pkg}: ${(0, ui_1.dim)(p.current)} → ${(0, ui_1.cyan)(p.latest)}`);
-        toBump.push(p);
-    }
-    if (toBump.length === 0) {
-        (0, ui_1.success)('All packages up-to-date.');
-        return;
-    }
-    if (args.dryRun) {
-        (0, ui_1.info)(`Dry-run: would upgrade ${toBump.length} package(s).`);
-        return;
-    }
-    let failures = 0;
-    for (const p of toBump) {
-        (0, ui_1.step)(`Upgrading ${p.pkg} via ${pm}...`);
-        const res = await runCmd(pm, pmUpgradeArgs(pm, p.pkg), { cwd: repoRoot });
-        if (res.code !== 0) {
-            failures++;
-            (0, ui_1.error)(`${pm} upgrade failed for ${p.pkg} (exit ${res.code}): ${res.stderr.trim()}`);
-        }
-        else {
-            (0, ui_1.success)(`${p.pkg} upgraded.`);
-        }
-    }
-    if (failures > 0) {
-        process.exit(1);
-    }
-}

package/dist/commands/warehouse.d.ts

@@ -1,20 +0,0 @@
-/**
- * Phase 18 B1 — `gurulu warehouse export` — manually trigger a warehouse
- * export run from the CLI. Uses the multi-profile config and Bearer auth
- * via cliApi.
- *
- * Usage:
- *   gurulu warehouse export --export <warehouseExportId>
- *
- * The `--tenant` flag is accepted for forward compatibility (Phase 18 B2
- * will route to a tenant-aware endpoint) but is not required today —
- * tenant scoping is derived server-side from the authenticated session.
- */
-interface WarehouseArgs {
-    tenant?: string;
-    export?: string;
-    json?: boolean;
-    profile?: string;
-}
-export declare function warehouseExportCommand(args: WarehouseArgs): Promise<void>;
-export {};

package/dist/commands/warehouse.js

@@ -1,65 +0,0 @@
-"use strict";
-/**
- * Phase 18 B1 — `gurulu warehouse export` — manually trigger a warehouse
- * export run from the CLI. Uses the multi-profile config and Bearer auth
- * via cliApi.
- *
- * Usage:
- *   gurulu warehouse export --export <warehouseExportId>
- *
- * The `--tenant` flag is accepted for forward compatibility (Phase 18 B2
- * will route to a tenant-aware endpoint) but is not required today —
- * tenant scoping is derived server-side from the authenticated session.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.warehouseExportCommand = warehouseExportCommand;
-const config_1 = require("../config");
-const api_client_1 = require("../api-client");
-const ui_1 = require("../utils/ui");
-async function warehouseExportCommand(args) {
-    let profile;
-    try {
-        profile = await (0, config_1.loadActiveProfile)({ profile: args.profile });
-    }
-    catch {
-        if (args.json)
-            console.log(JSON.stringify({ error: 'not_authenticated' }));
-        else
-            (0, ui_1.error)('Not authenticated. Run "gurulu login" first.');
-        process.exit(1);
-    }
-    if (!args.export) {
-        if (args.json)
-            console.log(JSON.stringify({ error: 'export_id_required' }));
-        else
-            (0, ui_1.error)('--export <id> is required');
-        process.exit(1);
-    }
-    const url = `/api/warehouses/exports/${encodeURIComponent(args.export)}/trigger`;
-    try {
-        const res = await (0, api_client_1.cliApi)(url, {
-            method: 'POST',
-            preloadedProfile: profile,
-        });
-        if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`HTTP ${res.status}: ${text}`);
-        }
-        const body = await res.json();
-        if (args.json) {
-            console.log(JSON.stringify(body, null, 2));
-            return;
-        }
-        (0, ui_1.info)(`Warehouse export ${args.export} triggered`);
-        (0, ui_1.success)(`Status: ${body?.result?.status ?? 'ok'}`);
-    }
-    catch (err) {
-        if (args.json) {
-            console.log(JSON.stringify({ error: err.message }));
-        }
-        else {
-            (0, ui_1.error)(`Trigger failed: ${err.message}`);
-        }
-        process.exit(1);
-    }
-}

package/dist/commands/warehouses.d.ts

@@ -1,17 +0,0 @@
-/**
- * Phase 19.5 W2 B6 — `gurulu warehouses list|runs <id>`.
- * Phase 20  W2 B5 — `create|update|delete|run`.
- */
-export interface WarehousesArgs {
-    action?: string;
-    target?: string;
-    json?: boolean;
-    profile?: string;
-    fromFile?: string;
-    name?: string;
-    type?: string;
-    schedule?: string;
-    yes?: boolean;
-    dryRun?: boolean;
-}
-export declare function warehousesCommand(args: WarehousesArgs): Promise<void>;

package/dist/commands/warehouses.js

@@ -1,182 +0,0 @@
-"use strict";
-/**
- * Phase 19.5 W2 B6 — `gurulu warehouses list|runs <id>`.
- * Phase 20  W2 B5 — `create|update|delete|run`.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.warehousesCommand = warehousesCommand;
-const api_client_1 = require("../api-client");
-const ui_1 = require("../utils/ui");
-const confirm_1 = require("../utils/confirm");
-const dry_run_1 = require("../utils/dry-run");
-const from_file_1 = require("../utils/from-file");
-async function warehousesCommand(args) {
-    const action = args.action || 'list';
-    switch (action) {
-        case 'list':
-            return listCmd(args);
-        case 'runs':
-            return runsCmd(args);
-        case 'create':
-            return createCmd(args);
-        case 'update':
-            return updateCmd(args);
-        case 'delete':
-            return deleteCmd(args);
-        case 'run':
-            return runManualCmd(args);
-        default:
-            (0, ui_1.error)(`Unknown warehouses action: ${action}`);
-            (0, ui_1.info)('Usage: gurulu warehouses [list|runs|create|update|delete|run]');
-            process.exit(1);
-    }
-}
-async function listCmd(args) {
-    const body = await (0, api_client_1.cliApiJson)('/api/cli/warehouses', {
-        profile: args.profile,
-    });
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    const rows = body.exports || [];
-    if (rows.length === 0) {
-        (0, ui_1.info)('No warehouse exports configured.');
-        return;
-    }
-    process.stdout.write(['ID', 'NAME', 'TYPE', 'SCHEDULE', 'LAST_RUN', 'STATUS'].join('\t') + '\n');
-    for (const e of rows) {
-        process.stdout.write([
-            e.id,
-            e.name,
-            e.type,
-            e.schedule,
-            String(e.lastRunAt || '-'),
-            e.lastRunStatus || '-',
-        ].join('\t') + '\n');
-    }
-}
-async function runsCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu warehouses runs <export-id>');
-        process.exit(1);
-    }
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}/runs`, { profile: args.profile });
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    const rows = body.runs || [];
-    if (rows.length === 0) {
-        (0, ui_1.info)('No runs yet.');
-        return;
-    }
-    process.stdout.write(['ID', 'STARTED', 'STATUS', 'TABLE', 'ROWS', 'BYTES'].join('\t') + '\n');
-    for (const r of rows) {
-        process.stdout.write([r.id, String(r.startedAt), r.status, r.tableName, r.rowsExported, r.bytesExported].join('\t') + '\n');
-    }
-}
-async function createCmd(args) {
-    let payload = {};
-    if (args.fromFile)
-        payload = (0, from_file_1.loadFromFile)(args.fromFile);
-    if (args.name)
-        payload.name = args.name;
-    if (args.type)
-        payload.type = args.type;
-    if (args.schedule)
-        payload.schedule = args.schedule;
-    if (!payload.name || !payload.type || !payload.credentialVaultId || !payload.config) {
-        (0, ui_1.error)('name, type, credentialVaultId, and config are all required.');
-        process.exit(1);
-    }
-    if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)('/api/cli/warehouses?dryRun=1', {
-            profile: args.profile,
-            method: 'POST',
-            json: payload,
-        });
-        (0, dry_run_1.printDryRun)(body, args.json);
-        return;
-    }
-    const ok = await (0, confirm_1.promptConfirm)(`Create warehouse export '${payload.name}'?`, {
-        yes: args.yes,
-        defaultYes: true,
-    });
-    if (!ok)
-        return (0, ui_1.info)('Aborted.');
-    const body = await (0, api_client_1.cliApiJson)('/api/cli/warehouses', {
-        profile: args.profile,
-        method: 'POST',
-        json: payload,
-    });
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    (0, ui_1.success)(`Created warehouse export ${body.export?.id ?? ''}`);
-}
-async function updateCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu warehouses update <id>');
-        process.exit(1);
-    }
-    let payload = {};
-    if (args.fromFile)
-        payload = (0, from_file_1.loadFromFile)(args.fromFile);
-    if (args.schedule)
-        payload.schedule = args.schedule;
-    if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'PATCH', json: payload });
-        (0, dry_run_1.printDryRun)(body, args.json);
-        return;
-    }
-    const ok = await (0, confirm_1.promptConfirm)(`Update warehouse export '${args.target}'?`, {
-        yes: args.yes,
-        defaultYes: true,
-    });
-    if (!ok)
-        return (0, ui_1.info)('Aborted.');
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PATCH', json: payload });
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    (0, ui_1.success)(`Updated warehouse export ${args.target}`);
-}
-async function deleteCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu warehouses delete <id>');
-        process.exit(1);
-    }
-    if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'DELETE' });
-        (0, dry_run_1.printDryRun)(body, args.json);
-        return;
-    }
-    const ok = await (0, confirm_1.promptConfirm)(`About to delete warehouse export '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
-    if (!ok)
-        return (0, ui_1.info)('Aborted.');
-    await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'DELETE' });
-    (0, ui_1.success)(`Deleted warehouse export ${args.target}`);
-}
-async function runManualCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu warehouses run <id>');
-        process.exit(1);
-    }
-    const ok = await (0, confirm_1.promptConfirm)(`Trigger warehouse export '${args.target}' now?`, {
-        yes: args.yes,
-        defaultYes: true,
-    });
-    if (!ok)
-        return (0, ui_1.info)('Aborted.');
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/warehouses/${encodeURIComponent(args.target)}/run${args.dryRun ? '?dryRun=1' : ''}`, { profile: args.profile, method: 'POST', json: {} });
-    if (args.dryRun)
-        return (0, dry_run_1.printDryRun)(body, args.json);
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    (0, ui_1.success)(`Triggered run for ${args.target}`);
-}

package/dist/commands/watch.d.ts

@@ -1,45 +0,0 @@
-/**
- * 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.
- */
-export interface WatchArgs {
-    site?: string;
-    types?: string;
-    tail?: number;
-    json?: boolean;
-    profile?: string;
-    /** Override the upstream SSE path — for tests/proxies. Defaults to the CLI
-     *  bearer-auth tail route. */
-    endpoint?: string;
-}
-interface RealtimeEventRow {
-    event_id?: string;
-    event_ts?: string;
-    event_name?: string;
-    site_id?: string;
-    site_name?: string;
-    url?: string;
-    page_url?: string;
-    anonymous_id?: string;
-    user_id?: string;
-    selector?: string;
-    revenue_value?: number | string;
-    revenue_currency?: string;
-    properties?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export declare function watchCommand(args: WatchArgs): Promise<void>;
-export declare function formatEventLine(row: RealtimeEventRow, json: boolean): string;
-export {};