@gurulu/cli 0.4.0 → 0.4.2

package/dist/commands/funnels.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * `gurulu funnels list|show|create|update|delete` — manage conversion funnels.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.funnelsCommand = funnelsCommand;
+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 funnelsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'show':
+            return showCmd(args);
+        case 'create':
+            return createCmd(args);
+        case 'update':
+            return updateCmd(args);
+        case 'delete':
+            return deleteCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown funnels action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu funnels [list|show|create|update|delete]');
+            process.exit(1);
+    }
+}
+function parseSteps(stepsStr) {
+    return stepsStr
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((event_name) => ({ event_name }));
+}
+async function listCmd(args) {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels${qs}`, {
+        profile: args.profile,
+    });
+    const funnels = body.funnels || [];
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    if (funnels.length === 0) {
+        (0, ui_1.info)('No funnels yet.');
+        return;
+    }
+    process.stdout.write(['NAME', 'ID', 'STEPS', 'STATUS', 'UPDATED'].join('\t') + '\n');
+    for (const f of funnels) {
+        const stepCount = Array.isArray(f.steps) ? f.steps.length : 0;
+        process.stdout.write([
+            f.name,
+            f.id,
+            String(stepCount),
+            f.status,
+            String(f.updatedAt || '-').slice(0, 19),
+        ].join('\t') + '\n');
+    }
+}
+async function showCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels show <id>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const f = body.funnel;
+    const steps = Array.isArray(f.steps) ? f.steps : [];
+    process.stdout.write(`Name:        ${f.name}\n`);
+    process.stdout.write(`ID:          ${f.id}\n`);
+    process.stdout.write(`Site:        ${f.siteId}\n`);
+    process.stdout.write(`Description: ${f.description || '-'}\n`);
+    process.stdout.write(`Status:      ${f.status}\n`);
+    process.stdout.write(`Steps (${steps.length}):\n`);
+    for (let i = 0; i < steps.length; i++) {
+        const s = steps[i];
+        const label = s.label || s.event_name || s.eventName || '-';
+        process.stdout.write(`  ${i + 1}. ${label}\n`);
+    }
+    if (f.cachedMetrics) {
+        const m = f.cachedMetrics;
+        process.stdout.write(`Overall rate: ${m.overallRate ?? '-'}\n`);
+        process.stdout.write(`Computed at:  ${m.computedAt || f.lastComputedAt || '-'}\n`);
+    }
+    process.stdout.write(`Updated:     ${f.updatedAt}\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.site)
+        payload.siteId = args.site;
+    if (args.steps)
+        payload.steps = parseSteps(args.steps);
+    if (!payload.name) {
+        (0, ui_1.error)('name is required (pass --name or --from-file)');
+        process.exit(1);
+    }
+    if (!payload.siteId) {
+        (0, ui_1.error)('site is required (pass --site)');
+        process.exit(1);
+    }
+    if (!Array.isArray(payload.steps) || payload.steps.length < 2) {
+        (0, ui_1.error)('At least 2 steps are required (pass --steps as comma-separated event names)');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels${qs}`, {
+            profile: args.profile,
+            method: 'POST',
+            json: payload,
+        });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Create funnel '${payload.name}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/funnels', {
+        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 funnel ${body.funnel?.id ?? ''}`);
+}
+async function updateCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels update <id> [--name ...] [--steps ...]');
+        process.exit(1);
+    }
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.description !== undefined)
+        payload.description = args.description;
+    if (args.steps)
+        payload.steps = parseSteps(args.steps);
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'PUT', json: payload });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Update funnel '${args.target}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PUT', json: payload });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Updated funnel ${args.target}`);
+}
+async function deleteCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels delete <id>');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'DELETE' });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete funnel '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, {
+        profile: args.profile,
+        method: 'DELETE',
+    });
+    (0, ui_1.success)(`Deleted funnel ${args.target}`);
+}

package/dist/commands/goals.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `gurulu goals list|show|create|update|delete` — manage conversion goals.
+ */
+export interface GoalsArgs {
+    action?: string;
+    target?: string;
+    json?: boolean;
+    profile?: string;
+    fromFile?: string;
+    site?: string;
+    name?: string;
+    description?: string;
+    event?: string;
+    propertiesFilter?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+}
+export declare function goalsCommand(args: GoalsArgs): Promise<void>;

package/dist/commands/goals.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * `gurulu goals list|show|create|update|delete` — manage conversion goals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goalsCommand = goalsCommand;
+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 goalsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'show':
+            return showCmd(args);
+        case 'create':
+            return createCmd(args);
+        case 'update':
+            return updateCmd(args);
+        case 'delete':
+            return deleteCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown goals action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu goals [list|show|create|update|delete]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals${qs}`, {
+        profile: args.profile,
+    });
+    const goals = body.goals || [];
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    if (goals.length === 0) {
+        (0, ui_1.info)('No goals yet.');
+        return;
+    }
+    process.stdout.write(['NAME', 'ID', 'EVENT', 'STATUS', 'CONVERSIONS', 'UPDATED'].join('\t') + '\n');
+    for (const g of goals) {
+        const eventName = g.eventPattern?.event_name || '-';
+        process.stdout.write([
+            g.name,
+            g.id,
+            String(eventName),
+            g.status,
+            String(g.totalConversions ?? 0),
+            String(g.updatedAt || '-').slice(0, 19),
+        ].join('\t') + '\n');
+    }
+}
+async function showCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals show <id>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const g = body.goal;
+    const eventName = g.eventPattern?.event_name || '-';
+    const propsFilter = g.eventPattern?.properties_filter || null;
+    process.stdout.write(`Name:              ${g.name}\n`);
+    process.stdout.write(`ID:                ${g.id}\n`);
+    process.stdout.write(`Site:              ${g.siteId}\n`);
+    process.stdout.write(`Description:       ${g.description || '-'}\n`);
+    process.stdout.write(`Event:             ${eventName}\n`);
+    process.stdout.write(`Properties filter: ${propsFilter ? JSON.stringify(propsFilter) : '-'}\n`);
+    process.stdout.write(`Status:            ${g.status}\n`);
+    process.stdout.write(`Conversions:       ${g.totalConversions}\n`);
+    process.stdout.write(`Last converted:    ${g.lastConvertedAt || '-'}\n`);
+    process.stdout.write(`Updated:           ${g.updatedAt}\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.site)
+        payload.siteId = args.site;
+    // Build eventPattern from --event and --properties-filter
+    const eventPattern = payload.eventPattern || {};
+    if (args.event)
+        eventPattern.event_name = args.event;
+    if (args.propertiesFilter) {
+        try {
+            eventPattern.properties_filter = JSON.parse(args.propertiesFilter);
+        }
+        catch {
+            (0, ui_1.error)('--properties-filter must be valid JSON');
+            process.exit(1);
+        }
+    }
+    if (Object.keys(eventPattern).length > 0)
+        payload.eventPattern = eventPattern;
+    if (!payload.name) {
+        (0, ui_1.error)('name is required (pass --name or --from-file)');
+        process.exit(1);
+    }
+    if (!payload.siteId) {
+        (0, ui_1.error)('site is required (pass --site)');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals${qs}`, {
+            profile: args.profile,
+            method: 'POST',
+            json: payload,
+        });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Create goal '${payload.name}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/goals', {
+        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 goal ${body.goal?.id ?? ''}`);
+}
+async function updateCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals update <id> [--name ...] [--event ...]');
+        process.exit(1);
+    }
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.description !== undefined)
+        payload.description = args.description;
+    // Build eventPattern if --event or --properties-filter provided
+    if (args.event || args.propertiesFilter) {
+        const eventPattern = payload.eventPattern || {};
+        if (args.event)
+            eventPattern.event_name = args.event;
+        if (args.propertiesFilter) {
+            try {
+                eventPattern.properties_filter = JSON.parse(args.propertiesFilter);
+            }
+            catch {
+                (0, ui_1.error)('--properties-filter must be valid JSON');
+                process.exit(1);
+            }
+        }
+        payload.eventPattern = eventPattern;
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'PUT', json: payload });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Update goal '${args.target}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PUT', json: payload });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Updated goal ${args.target}`);
+}
+async function deleteCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals delete <id>');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'DELETE' });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete goal '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, {
+        profile: args.profile,
+        method: 'DELETE',
+    });
+    (0, ui_1.success)(`Deleted goal ${args.target}`);
+}

package/dist/commands/install.d.ts

@@ -38,6 +38,14 @@ export interface InstallArgs {
     autoProperties?: boolean;
     /** Internal: path to the serialized intent JSON forwarded to the agentic-install script. */
     intentResultPath?: string;
+    /**
+     * Internal: API token (active profile secret key) forwarded to the
+     * agentic-install script as `--token`. The script's `tryLlmExtraction`
+     * needs this to call the LLM property-extraction endpoint; without it
+     * extraction silently 401s and every injected `gurulu.track(...)` ends
+     * up with `// TODO: <prop>` placeholders. See Sprint A fix A2.
+     */
+    authToken?: string;
 }
 export interface IntentPreSeedResult {
     ok: boolean;

package/dist/commands/install.js

@@ -323,6 +323,11 @@ async function runInstallFlow(args, deps, scriptsDir) {
     if (args.framework) {
         planArgs.push('--framework', args.framework);
     }
+    // Sprint A fix A2 — forward the active profile's secret key so the planner
+    // can call the LLM property-extraction endpoint while building the diff.
+    if (args.authToken) {
+        planArgs.push('--token', args.authToken);
+    }
     // Phase 18.7 B — include auto-instrument diff in the dry-run plan so the
     // consent prompt / preview shows both script-tag + track-call changes.
     if (args.autoInstrument) {
@@ -366,6 +371,14 @@ async function runInstallFlow(args, deps, scriptsDir) {
         if (args.framework) {
             applyArgs.push('--framework', args.framework);
         }
+        // Sprint A fix A2 — forward the active profile's secret key so the
+        // agentic-install script's `tryLlmExtraction` can authenticate against
+        // the LLM property-extraction endpoint. Without it the request 401s and
+        // every injected `gurulu.track(...)` falls back to `// TODO: <prop>`
+        // placeholders, breaking the auto-instrument feature.
+        if (args.authToken) {
+            applyArgs.push('--token', args.authToken);
+        }
         // Phase 18.7 B — forward auto-instrument flag + intent result path.
         if (args.autoInstrument) {
             applyArgs.push('--auto-instrument');
@@ -571,6 +584,32 @@ async function runInstallFlow(args, deps, scriptsDir) {
         console.log((0, ui_1.dim)('  │ ') + 'Docs: https://gurulu.io/docs/quick-start');
         console.log((0, ui_1.dim)('  └─────────────────────────────────────────────'));
         console.log('');
+        // Goals & funnels management
+        log(deps, 'info', `${(0, ui_1.cyan)('Goals & Funnels')}`);
+        log(deps, 'info', `  ${(0, ui_1.cyan)('gurulu goals list')}       ${(0, ui_1.dim)('List all conversion goals')}`);
+        log(deps, 'info', `  ${(0, ui_1.cyan)('gurulu goals create')}     ${(0, ui_1.dim)('Create a new goal interactively')}`);
+        log(deps, 'info', `  ${(0, ui_1.cyan)('gurulu funnels create')}   ${(0, ui_1.dim)('Define a multi-step funnel')}`);
+        console.log('');
+        // Server-side setup
+        log(deps, 'info', `${(0, ui_1.cyan)('Server-Side Tracking')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Add server-side event tracking with:')} ${(0, ui_1.cyan)('gurulu add-server')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Or manually:')}`);
+        log(deps, 'info', `    ${(0, ui_1.cyan)('npm install @gurulu/node')}`);
+        log(deps, 'info', `    ${(0, ui_1.dim)('import { Gurulu } from \'@gurulu/node\';')}`);
+        log(deps, 'info', `    ${(0, ui_1.dim)('const gurulu = new Gurulu({ siteId, serverApiKey });')}`);
+        log(deps, 'info', `    ${(0, ui_1.dim)('gurulu.track(\'order_completed\', { userId, revenue });')}`);
+        console.log('');
+        // DataLayer Bridge for GTM
+        log(deps, 'info', `${(0, ui_1.cyan)('DataLayer Bridge')} ${(0, ui_1.dim)('(for GTM users)')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Auto-capture all Google Tag Manager events:')}`);
+        log(deps, 'info', `  ${(0, ui_1.cyan)('window.gurulu.loadDataLayerBridge()')}`);
+        console.log('');
+        // identify() guidance
+        log(deps, 'info', `${(0, ui_1.cyan)('User Identification')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Web:')}    ${(0, ui_1.cyan)('window.gurulu.identify(\'user_123\', { email, plan })')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Server:')} ${(0, ui_1.cyan)('gurulu.identify(\'user_123\', { email, plan })')}`);
+        log(deps, 'info', `  ${(0, ui_1.dim)('Call on login/signup to link events to known users.')}`);
+        console.log('');
     }
     return summary;
 }
@@ -821,6 +860,9 @@ async function runAuthenticatedInstallFlow(args, authDeps, installDeps, scriptsD
         ...filled,
         autoInstrument: autoInstrumentEnabled,
         intentResultPath,
+        // Sprint A fix A2 — propagate the active profile secret key so the core
+        // flow can forward it to the agentic-install script as `--token`.
+        authToken: authDeps.profile.secret_key,
     };
     // Run the core flow.
     const summary = await runInstallFlow(runArgs, installDeps, scriptsDir);
@@ -901,6 +943,13 @@ async function runAuthenticatedInstallFlow(args, authDeps, installDeps, scriptsD
 async function installCommand(args) {
     const scriptsDir = resolveScriptsDir();
     const deps = createDefaultDeps(scriptsDir);
+    // Sprint A fix A3 — make `--verify` opt-in (default false). The verifier
+    // (`scripts/gurulu-verify-install.lib.cjs:312`) hard-`require`s
+    // `playwright-core`, which is NOT a runtime dependency of @gurulu/cli, so a
+    // default-on verify aborts every fresh install with "Verify threw". Treat
+    // verify as strictly opt-in: only `args.verify === true` runs it. We also
+    // patch the CLI option default in `src/index.ts` so the flag matches.
+    args = { ...args, verify: args.verify === true };
     // Legacy unauthenticated path: --site-id passed explicitly and no active profile.
     const profile = await (0, config_1.getActiveProfile)({ profile: args.profile });
     const legacyMode = !!args.siteId && !profile;
@@ -914,7 +963,14 @@ async function installCommand(args) {
             if (!tenantId)
                 tenantId = await deps.prompt('  Tenant ID: ');
         }
-        const filled = { ...args, siteId, tenantId };
+        // Sprint A fix A2 — legacy callers can supply a token via env so that
+        // auto-instrument property extraction still works without a profile.
+        const filled = {
+            ...args,
+            siteId,
+            tenantId,
+            authToken: args.authToken || process.env.GURULU_API_KEY || process.env.GURULU_SECRET_KEY,
+        };
         const summary = await runInstallFlow(filled, deps, scriptsDir);
         if (summary.errors.length > 0)
             process.exit(1);

package/dist/commands/sourcemap.d.ts

@@ -1,21 +1,33 @@
 /**
  * `gurulu sourcemap upload` — Upload source maps for error deobfuscation.
  *
- * Reads all `.map` files from the specified directory and POSTs them to
- * `/api/errors/sourcemaps` with Bearer auth. The server stores them on
- * disk for later stack trace deobfuscation (follow-up task).
- *
- * Usage:
+ * Web (default):
  *   gurulu sourcemap upload --release v1.0.0 --dir .next/static/
+ *
+ * Native (C3 — iOS dSYM / Android ProGuard):
+ *   gurulu sourcemap upload --platform=ios     --version=1.4.2 --bundle-id=com.example.app --file=app.xcarchive/dSYMs/MyApp.dSYM.zip
+ *   gurulu sourcemap upload --platform=android --version=1.4.2 --bundle-id=com.example.app --file=app/build/outputs/mapping/release/mapping.txt
+ *
+ * The native variant POSTs a single `file` to `/api/sourcemap/native`, which
+ * persists it under {SOURCEMAP_STORAGE_PATH}/native/{siteId}/{platform}/{release}/
+ * and registers a `NativeSymbolFile` row.
  */
 import { loadActiveProfile } from '../config';
 export interface SourcemapArgs {
     action?: string;
     release?: string;
+    /** Alias of --release for native uploads. */
+    version?: string;
     dir?: string;
+    /** Native uploads: path to the dSYM zip or `mapping.txt`. */
+    file?: string;
+    /** Native uploads: iOS bundleId or Android applicationId. */
+    bundleId?: string;
+    appId?: string;
     site?: string;
     profile?: string;
     json?: boolean;
+    platform?: 'web' | 'server' | 'ios' | 'android';
 }
 export declare function sourcemapCommand(args: SourcemapArgs): Promise<void>;
 export declare const _loadActiveProfile: typeof loadActiveProfile;