@hs-x/cli 0.3.7 → 0.4.1

package/dist/dev/port-process.js

@@ -0,0 +1,145 @@
+import { execFile } from 'node:child_process';
+import { readlink } from 'node:fs/promises';
+export function isHubSpotDevPortConflict(error) {
+    const messages = [];
+    let current = error;
+    for (let depth = 0; depth < 4 && current; depth += 1) {
+        if (current instanceof Error)
+            messages.push(current.message);
+        else if (typeof current === 'string')
+            messages.push(current);
+        current =
+            typeof current === 'object' && current !== null && 'cause' in current
+                ? current.cause
+                : undefined;
+    }
+    return messages.some((message) => /another instance is already running|port\s+\d+\s+is already in use|EADDRINUSE/i.test(message));
+}
+export async function findListeningProcess(port) {
+    if (!Number.isInteger(port) || port < 1 || port > 65535)
+        return undefined;
+    const pid = process.platform === 'win32'
+        ? await findWindowsListeningPid(port)
+        : await findUnixListeningPid(port);
+    if (!pid)
+        return undefined;
+    const [command, cwd] = await Promise.all([readProcessCommand(pid), readProcessCwd(pid)]);
+    return {
+        port,
+        pid,
+        ...(command ? { command } : {}),
+        ...(cwd ? { cwd } : {}),
+    };
+}
+export async function terminateProcessGracefully(pid, options = {}) {
+    if (!Number.isInteger(pid) || pid <= 1 || pid === process.pid) {
+        return { ok: false, message: `Refusing to stop invalid process ${pid}.` };
+    }
+    const kill = options.kill ?? process.kill.bind(process);
+    const delay = options.delay ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const timeoutMs = options.timeoutMs ?? 3_000;
+    const pollMs = options.pollMs ?? 100;
+    try {
+        kill(pid, 'SIGTERM');
+    }
+    catch (error) {
+        if (isMissingProcessError(error))
+            return { ok: true };
+        return { ok: false, message: error instanceof Error ? error.message : String(error) };
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await delay(pollMs);
+        try {
+            kill(pid, 0);
+        }
+        catch (error) {
+            if (isMissingProcessError(error))
+                return { ok: true };
+            return { ok: false, message: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    return {
+        ok: false,
+        message: `Process ${pid} did not exit after SIGTERM. It was left running.`,
+    };
+}
+export function stopProcessCommand(pid) {
+    return process.platform === 'win32' ? `taskkill /PID ${pid}` : `kill -TERM ${pid}`;
+}
+export function redactProcessCommand(command) {
+    return command
+        .replace(/(--(?:personal-access-key|pak|token|api-token|client-secret|password)(?:=|\s+))\S+/gi, '$1[REDACTED]')
+        .replace(/\b((?:HSX|HUBSPOT|CLOUDFLARE)[A-Z0-9_]*(?:TOKEN|SECRET|KEY|PASSWORD)=)\S+/g, '$1[REDACTED]')
+        .slice(0, 2_000);
+}
+async function findUnixListeningPid(port) {
+    const output = await execFileText('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-Fp']);
+    const match = output?.match(/^p(\d+)$/m);
+    return match?.[1] ? Number(match[1]) : undefined;
+}
+async function findWindowsListeningPid(port) {
+    const output = await execFileText('netstat', ['-ano', '-p', 'tcp']);
+    if (!output)
+        return undefined;
+    for (const line of output.split(/\r?\n/)) {
+        const fields = line.trim().split(/\s+/);
+        if (fields.length < 5 || fields[3]?.toUpperCase() !== 'LISTENING')
+            continue;
+        const local = fields[1] ?? '';
+        if (!local.endsWith(`:${port}`))
+            continue;
+        const pid = Number(fields[4]);
+        if (Number.isInteger(pid) && pid > 0)
+            return pid;
+    }
+    return undefined;
+}
+async function readProcessCommand(pid) {
+    if (process.platform === 'win32') {
+        const output = await execFileText('wmic', [
+            'process',
+            'where',
+            `ProcessId=${pid}`,
+            'get',
+            'CommandLine',
+            '/value',
+        ]);
+        const command = output?.match(/^CommandLine=(.+)$/m)?.[1]?.trim();
+        return command ? redactProcessCommand(command) : undefined;
+    }
+    const command = (await execFileText('ps', ['-p', String(pid), '-o', 'command=']))?.trim();
+    return command ? redactProcessCommand(command) : undefined;
+}
+async function readProcessCwd(pid) {
+    if (process.platform === 'linux') {
+        try {
+            return await readlink(`/proc/${pid}/cwd`);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (process.platform === 'darwin') {
+        const output = await execFileText('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn']);
+        return output?.match(/^n(.+)$/m)?.[1];
+    }
+    return undefined;
+}
+function execFileText(command, args) {
+    return new Promise((resolve) => {
+        execFile(command, [...args], { encoding: 'utf8', timeout: 2_000 }, (error, stdout) => {
+            if (error && !stdout)
+                resolve(undefined);
+            else
+                resolve(stdout || undefined);
+        });
+    });
+}
+function isMissingProcessError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ESRCH');
+}
+//# sourceMappingURL=port-process.js.map

package/dist/dev/port-process.js.map

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

package/dist/dev/session-manager.d.ts

@@ -9,11 +9,21 @@
  *
  * See docs/phase-1.5/spike-ui-extension-dev-session.md.
  */
+import { type CapturedConsoleEntry } from './console-capture.js';
+import { type FrontendLogEntry } from './frontend-log-relay.js';
 export interface DevSessionStart {
-    readonly accountId: number;
+    /** Backward-compatible shorthand when project and testing accounts are the same. */
+    readonly accountId?: number;
+    readonly projectAccountId?: number;
+    readonly testingAccountId?: number;
     readonly projectDir: string;
+    readonly profile?: string;
     /** Optional whitelist — only these node UIDs are registered. */
     readonly selectedNodeUids?: readonly string[];
+    /** Receives console/logger calls relayed through HubSpot's worker channel. */
+    readonly onFrontendLog?: (entry: FrontendLogEntry) => void;
+    /** Receives stdout/stderr-style logs from locally executed HubSpot app functions. */
+    readonly onBackendLog?: (entry: CapturedConsoleEntry) => void;
     /** Called every successful heartbeat (used by the request-log renderer). */
     readonly onHeartbeat?: (info: {
         at: Date;

package/dist/dev/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/dev/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID,wBAAsB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqHvF"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/dev/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3D,qFAAqF;IACrF,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID,wBAAsB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuKvF"}

package/dist/dev/session-manager.js

@@ -12,52 +12,80 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { createDevSessionsClient } from '@hs-x/hubspot-cli';
+import { createHubSpotDevBrowserLogInstrumentor } from './browser-log-bridge.js';
 import { loadDevStack } from './compat-shim.js';
+import { filterHubSpotDevSessionNodes, listHubSpotDevComponentCandidates, } from './component-selection.js';
+import { captureConsole } from './console-capture.js';
+import { createFrontendLogRelay, } from './frontend-log-relay.js';
 import { withLoopbackHttpListener } from './loopback-http-listener.js';
 const HEARTBEAT_INTERVAL_MS = 30_000;
 export async function startDevSession(input) {
     const stack = await loadDevStack();
-    if (!stack.getAccountConfig(input.accountId)) {
-        throw new DevSessionStartError('HSX_E_DEV_SESSION_NO_HUBSPOT_ACCOUNT', `HubSpot CLI config has no account ${input.accountId}. Run \`hs accounts auth\` or \`hs-x connect\`.`);
+    const projectAccountId = input.projectAccountId ?? input.accountId;
+    const testingAccountId = input.testingAccountId ?? projectAccountId;
+    if (!projectAccountId || !stack.getAccountConfig(projectAccountId)) {
+        throw new DevSessionStartError('HSX_E_DEV_SESSION_NO_HUBSPOT_ACCOUNT', `HubSpot CLI config has no project account ${projectAccountId ?? '(missing)'}. Run \`hs account auth\` or pass --project-account.`);
+    }
+    if (!testingAccountId || !stack.getAccountConfig(testingAccountId)) {
+        throw new DevSessionStartError('HSX_E_DEV_SESSION_NO_HUBSPOT_ACCOUNT', `HubSpot CLI config has no testing account ${testingAccountId ?? '(missing)'}. Run \`hs account auth\` or pass --testing-account.`);
     }
     const projectConfigRaw = await readFile(join(input.projectDir, 'hsproject.json'), 'utf8');
     const projectConfig = JSON.parse(projectConfigRaw);
     const ir = await stack.translateForLocalDev({
         projectSourceDir: join(input.projectDir, projectConfig.srcDir),
         platformVersion: projectConfig.platformVersion,
-        accountId: input.accountId,
-    }, {});
+        accountId: projectAccountId,
+    }, input.profile ? { profile: input.profile } : {});
     let nodesByUid = ir.intermediateNodesIndexedByUid;
+    let activeNodeUids = listHubSpotDevComponentCandidates(nodesByUid).map((candidate) => candidate.uid);
     if (input.selectedNodeUids && input.selectedNodeUids.length > 0) {
-        const allowed = new Set(input.selectedNodeUids);
-        nodesByUid = Object.fromEntries(Object.entries(nodesByUid).filter(([uid]) => allowed.has(uid)));
-        if (Object.keys(nodesByUid).length === 0) {
+        const filtered = filterHubSpotDevSessionNodes(nodesByUid, input.selectedNodeUids);
+        nodesByUid = filtered.nodesByUid;
+        activeNodeUids = [...filtered.activeNodeUids];
+        if (activeNodeUids.length === 0) {
             throw new DevSessionStartError('HSX_E_DEV_SESSION_NO_NODES', 'None of the selected nodes were found in the project IR.');
         }
     }
     await stack.startPortManagerServer();
+    let frontendLogRelay;
+    let stopBackendConsoleCapture;
+    let stopBrowserLogWatcher;
     try {
+        frontendLogRelay = input.onFrontendLog
+            ? await createFrontendLogRelay({ nodesByUid, onEntry: input.onFrontendLog })
+            : undefined;
+        const sessionNodesByUid = frontendLogRelay?.nodesByUid ?? nodesByUid;
+        const browserLogs = frontendLogRelay
+            ? createHubSpotDevBrowserLogInstrumentor({
+                nodesByUid: sessionNodesByUid,
+                relayFunctionName: frontendLogRelay.functionUid,
+                logger: stack.logger,
+            })
+            : undefined;
+        stopBackendConsoleCapture = input.onBackendLog ? captureConsole(input.onBackendLog) : undefined;
         await stack.uie.setup({
-            components: nodesByUid,
+            components: sessionNodesByUid,
             profileData: ir.profileData,
-            logger: stack.logger,
+            logger: browserLogs?.logger ?? stack.logger,
             urls: {
                 api: stack.getHubSpotApiOrigin(),
                 web: stack.getHubSpotWebsiteOrigin(),
             },
         });
         await withLoopbackHttpListener(() => stack.uie.start({
-            accountId: input.accountId,
+            accountId: testingAccountId,
             projectConfig: projectConfig,
             requestPorts: stack.requestPorts,
         }));
+        browserLogs?.patchBundles();
+        stopBrowserLogWatcher = browserLogs?.watchBundles();
         const activeServers = await stack.getActiveServers();
         const ports = Object.entries(activeServers).map(([serverId, port]) => ({
             serverId,
             port,
         }));
         const client = await createDevSessionsClient({
-            accountId: input.accountId,
+            accountId: testingAccountId,
         });
         const { sessionId } = await client.register({ ports });
         const heartbeat = setInterval(async () => {
@@ -76,6 +104,7 @@ export async function startDevSession(input) {
                 return;
             cleanedUp = true;
             clearInterval(heartbeat);
+            stopBrowserLogWatcher?.();
             const errors = [];
             try {
                 await client.delete({ sessionId });
@@ -95,6 +124,13 @@ export async function startDevSession(input) {
             catch (e) {
                 errors.push(`port manager: ${e.message}`);
             }
+            try {
+                await frontendLogRelay?.cleanup();
+            }
+            catch (e) {
+                errors.push(`frontend log relay: ${e.message}`);
+            }
+            stopBackendConsoleCapture?.();
             if (errors.length > 0) {
                 throw new DevSessionCleanupError(errors.join('; '));
             }
@@ -102,17 +138,31 @@ export async function startDevSession(input) {
         return {
             sessionId,
             ports,
-            nodeUids: Object.keys(nodesByUid),
+            nodeUids: activeNodeUids,
             cleanup,
         };
     }
     catch (error) {
+        stopBrowserLogWatcher?.();
+        try {
+            await stack.uie.cleanup();
+        }
+        catch {
+            // Best-effort rollback for partially-started UI-extension servers.
+        }
         try {
             await stack.stopPortManagerServer();
         }
         catch {
             // best-effort
         }
+        try {
+            await frontendLogRelay?.cleanup();
+        }
+        catch {
+            // best-effort
+        }
+        stopBackendConsoleCapture?.();
         throw error;
     }
 }

package/dist/dev/session-manager.js.map

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

package/dist/dev/stream-event-format.d.ts

@@ -0,0 +1,14 @@
+import { type Style } from '../reporter/style.js';
+import type { DevEvent } from './event-bus.js';
+import type { ManagedDevStoredEvent } from './managed-session.js';
+/**
+ * Restore the canonical in-process event shape from the durable managed-log
+ * envelope. Machine output keeps the stored envelope and cursor unchanged;
+ * human output can therefore reuse the exact same formatter and renderer as
+ * foreground `hs-x dev`.
+ */
+export declare function managedDevEventToDevEvent(event: ManagedDevStoredEvent): DevEvent;
+export declare function formatDevStreamEvent(event: DevEvent, style: Style, count?: number): string;
+export declare function renderDevEventDetails(event: DevEvent, count: number, style: Style, columns: number): string;
+export declare function devEventFingerprint(event: DevEvent): string;
+//# sourceMappingURL=stream-event-format.d.ts.map

package/dist/dev/stream-event-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-event-format.d.ts","sourceRoot":"","sources":["../../src/dev/stream-event-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AASlE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CAqBhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,SAAI,GAAG,MAAM,CAYrF;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAoCR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAI3D"}

package/dist/dev/stream-event-format.js

@@ -0,0 +1,262 @@
+import { wrapVisible } from '../reporter/style.js';
+const LANE_LABEL = {
+    frontend: 'frontend',
+    backend: 'backend ',
+    request: 'request ',
+    hubspot: 'hubspot ',
+};
+/**
+ * Restore the canonical in-process event shape from the durable managed-log
+ * envelope. Machine output keeps the stored envelope and cursor unchanged;
+ * human output can therefore reuse the exact same formatter and renderer as
+ * foreground `hs-x dev`.
+ */
+export function managedDevEventToDevEvent(event) {
+    const parsedTimestamp = Date.parse(event.ts);
+    const ts = Number.isFinite(parsedTimestamp) ? parsedTimestamp : 0;
+    if (event.type === 'log') {
+        return {
+            lane: event.lane,
+            level: event.level,
+            ts,
+            msg: event.message,
+            ...(event.source ? { source: event.source } : {}),
+            ...(event.fields ? { fields: event.fields } : {}),
+        };
+    }
+    return {
+        lane: 'backend',
+        level: event.state === 'failed' ? 'error' : 'info',
+        ts,
+        source: 'session',
+        msg: event.message ? `${event.state} · ${event.message}` : event.state,
+        fields: { generation: event.generation },
+    };
+}
+export function formatDevStreamEvent(event, style, count = 1) {
+    const ts = style.dim(formatTimestamp(event.ts));
+    const lane = paintLane(event.lane, style);
+    const level = paintLevel(event.level, style);
+    const source = event.source ? `${style.cyan(event.source)}  ` : '';
+    const message = formatMessage(event, style);
+    const [first = '', ...continuations] = message.split('\n');
+    const headline = count > 1 ? `${first} ${style.dim(`×${count}`)}` : first;
+    const continuationRail = style.dim(style.unicode ? '  │ ' : '  | ');
+    return `  ${ts}  ${lane}  ${level}  ${source}${headline}${continuations
+        .map((line) => `\n${continuationRail}${line}`)
+        .join('')}`;
+}
+export function renderDevEventDetails(event, count, style, columns) {
+    const rail = style.dim(style.unicode ? '│' : '|');
+    const lines = [
+        `  ${style.dim('time')}    ${formatTimestamp(event.ts)}`,
+        `  ${style.dim('lane')}    ${paintLane(event.lane, style).trimEnd()}`,
+        `  ${style.dim('level')}   ${paintLevel(event.level, style).trimEnd()}`,
+        ...(event.source ? [`  ${style.dim('source')}  ${style.cyan(event.source)}`] : []),
+        ...(count > 1 ? [`  ${style.dim('repeat')}  ×${count}`] : []),
+        ...(typeof event.fields?.api === 'string'
+            ? [`  ${style.dim('api')}     ${event.fields.api}`]
+            : []),
+        '',
+        `  ${style.dim('message')}`,
+        ...event.msg.split('\n').map((line) => `  ${rail} ${line}`),
+    ];
+    if (Array.isArray(event.fields?.args)) {
+        lines.push('', `  ${style.dim('arguments')}`);
+        lines.push(...prettyJson(event.fields.args)
+            .split('\n')
+            .map((line) => `  ${rail} ${line}`));
+    }
+    const metadata = Object.fromEntries(Object.entries(event.fields ?? {}).filter(([key]) => key !== 'api' && key !== 'args'));
+    if (Object.keys(metadata).length > 0) {
+        lines.push('', `  ${style.dim('metadata')}`);
+        lines.push(...prettyJson(metadata)
+            .split('\n')
+            .map((line) => `  ${rail} ${line}`));
+    }
+    return lines.map((line) => wrapVisible(line, Math.max(20, columns - 1), '    ')).join('\n');
+}
+export function devEventFingerprint(event) {
+    return [event.lane, event.level, event.source ?? '', event.msg, safeJson(event.fields)].join('\u0000');
+}
+function prettyJson(value) {
+    try {
+        return JSON.stringify(value, null, 2) ?? String(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+function formatMessage(event, style) {
+    const structuredArgs = formatStructuredArgs(event.fields?.args, style);
+    const structured = structuredArgs ? undefined : splitStructuredMessage(event.msg);
+    const lines = structuredArgs
+        ? structuredArgs
+        : [structured?.summary || (structured ? 'details' : event.msg)];
+    if (structured)
+        lines.push(...formatStructuredTree(structured.value, style));
+    // The frontend bridge records the originating console/logger API for
+    // diagnostics. It is transport metadata, not useful long-form event data,
+    // and rendering it as a JSON blob made every browser line noisy.
+    const displayFields = Object.fromEntries(Object.entries(event.fields ?? {}).filter(([key]) => key !== 'api' && key !== 'args'));
+    const fields = formatFields(displayFields);
+    if (fields)
+        lines[0] = `${lines[0]} ${style.dim(fields)}`;
+    return lines.join('\n');
+}
+function formatStructuredArgs(value, style) {
+    if (!Array.isArray(value))
+        return undefined;
+    const structured = value
+        .map((item, index) => ({ index, item }))
+        .filter(({ item }) => item !== null && typeof item === 'object');
+    if (structured.length === 0)
+        return undefined;
+    const summary = value
+        .filter((item) => item === null || typeof item !== 'object')
+        .filter((item) => item !== '[undefined]' && typeof item !== 'undefined')
+        .map(formatConsolePrimitive)
+        .filter(Boolean)
+        .join(' ');
+    const lines = [summary || 'details'];
+    if (structured.length === 1) {
+        const item = structured[0]?.item;
+        if (item && typeof item === 'object') {
+            lines.push(...formatStructuredTree(item, style));
+        }
+        return lines;
+    }
+    for (const { index, item } of structured) {
+        lines.push(...formatStructuredTree({ [`arg ${index + 1}`]: item }, style));
+    }
+    return lines;
+}
+function formatConsolePrimitive(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null)
+        return 'null';
+    return String(value);
+}
+function formatFields(fields) {
+    if (Object.keys(fields).length === 0)
+        return undefined;
+    try {
+        return JSON.stringify(fields);
+    }
+    catch {
+        return '[unserializable fields]';
+    }
+}
+function splitStructuredMessage(message) {
+    const text = message.trimEnd();
+    for (let index = 0; index < text.length; index += 1) {
+        const token = text[index];
+        if (token !== '{' && token !== '[')
+            continue;
+        if (index > 0 && !/\s/.test(text[index - 1] ?? ''))
+            continue;
+        try {
+            const value = JSON.parse(text.slice(index));
+            if (!value || typeof value !== 'object')
+                continue;
+            return {
+                summary: text.slice(0, index).trimEnd(),
+                value: value,
+            };
+        }
+        catch {
+            // Prefixes such as "[component]" contain JSON-looking tokens. Keep
+            // scanning until a suffix parses as a complete structured value.
+        }
+    }
+    return undefined;
+}
+function formatStructuredTree(value, style) {
+    const entries = Array.isArray(value)
+        ? value.map((item, index) => [String(index), item])
+        : Object.entries(value);
+    const maxEntries = 12;
+    const shown = entries.slice(0, maxEntries);
+    const lines = shown.map(([key, item], index) => {
+        const isLast = index === shown.length - 1 && entries.length <= maxEntries;
+        const branch = style.unicode ? (isLast ? '└─' : '├─') : isLast ? '`-' : '|-';
+        return `  ${style.dim(branch)} ${style.cyan(key)}${style.dim(':')} ${formatStructuredValue(item)}`;
+    });
+    if (entries.length > maxEntries) {
+        const branch = style.unicode ? '└─' : '`-';
+        lines.push(`  ${style.dim(branch)} ${style.dim(`… ${entries.length - maxEntries} more fields`)}`);
+    }
+    return lines;
+}
+function formatStructuredValue(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string') {
+        return /\s/.test(value) ? truncateValue(JSON.stringify(value), 260) : truncateValue(value, 260);
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (typeof value === 'undefined')
+        return 'undefined';
+    if (Array.isArray(value))
+        return truncateValue(safeJson(value), 260);
+    if (typeof value === 'object') {
+        const pairs = Object.entries(value).map(([key, nested]) => `${key}=${formatNestedValue(nested)}`);
+        return truncateValue(pairs.join(' '), 260);
+    }
+    return truncateValue(String(value), 260);
+}
+function formatNestedValue(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return /\s/.test(value) ? JSON.stringify(value) : value;
+    if (typeof value === 'object')
+        return safeJson(value);
+    return String(value);
+}
+function safeJson(value) {
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+function truncateValue(value, max) {
+    return value.length <= max ? value : `${value.slice(0, Math.max(0, max - 1))}…`;
+}
+function formatTimestamp(ts) {
+    const d = new Date(ts);
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    const ss = String(d.getSeconds()).padStart(2, '0');
+    const ms = String(d.getMilliseconds()).padStart(3, '0');
+    return `${hh}:${mm}:${ss}.${ms}`;
+}
+function paintLane(lane, style) {
+    const label = LANE_LABEL[lane];
+    if (lane === 'frontend')
+        return style.orange(label);
+    if (lane === 'backend')
+        return style.green(label);
+    if (lane === 'hubspot')
+        return style.yellow(label);
+    return style.dim(label);
+}
+function paintLevel(level, style) {
+    const padded = level.padEnd(5, ' ');
+    switch (level) {
+        case 'error':
+            return style.red(padded);
+        case 'warn':
+            return style.yellow(padded);
+        case 'debug':
+            return style.dim(padded);
+        default:
+            return style.dim(padded);
+    }
+}
+//# sourceMappingURL=stream-event-format.js.map