@hs-x/cli 0.1.0

package/dist/dev/event-bus.d.ts

@@ -0,0 +1,27 @@
+/**
+ * In-process event bus for `hs-x dev` unified output.
+ *
+ * Three lanes:
+ *   - frontend: logs from card iframe (via @hs-x/sdk-ui `logger` → /__hsx/log)
+ *   - backend:  stdout/stderr from local handler process (e.g. wrangler dev) — lane wired later
+ *   - request:  inbound proxied request summaries from local dev-proxy receiver — lane wired later
+ *
+ * Subscribers (the reporter renderer) interleave events by arrival order.
+ */
+export type DevLane = 'frontend' | 'backend' | 'request';
+export type DevLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface DevEvent {
+    readonly lane: DevLane;
+    readonly level: DevLevel;
+    readonly ts: number;
+    readonly msg: string;
+    readonly source?: string;
+    readonly fields?: Record<string, unknown>;
+}
+export type DevEventListener = (event: DevEvent) => void;
+export interface DevEventBus {
+    emit(event: DevEvent): void;
+    subscribe(listener: DevEventListener): () => void;
+}
+export declare function createDevEventBus(): DevEventBus;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/dev/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/dev/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAmB/C"}

package/dist/dev/event-bus.js

@@ -0,0 +1,32 @@
+/**
+ * In-process event bus for `hs-x dev` unified output.
+ *
+ * Three lanes:
+ *   - frontend: logs from card iframe (via @hs-x/sdk-ui `logger` → /__hsx/log)
+ *   - backend:  stdout/stderr from local handler process (e.g. wrangler dev) — lane wired later
+ *   - request:  inbound proxied request summaries from local dev-proxy receiver — lane wired later
+ *
+ * Subscribers (the reporter renderer) interleave events by arrival order.
+ */
+export function createDevEventBus() {
+    const listeners = new Set();
+    return {
+        emit(event) {
+            for (const listener of listeners) {
+                try {
+                    listener(event);
+                }
+                catch {
+                    // A subscriber throwing should not stop other subscribers from receiving the event.
+                }
+            }
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/dev/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/dev/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,OAAO;QACL,IAAI,CAAC,KAAK;YACR,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACP,oFAAoF;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/dev/log-server.d.ts

@@ -0,0 +1,52 @@
+/**
+ * HS-X dev sidecar HTTP server.
+ *
+ * Separate from HubSpot's `ui-extensions-dev-server` — we own this. Hosts the
+ * frontend logger ingest endpoint, and will host other dev-only routes
+ * (request inspector, etc.) as they land.
+ *
+ * Routes:
+ *   POST /__hsx/log   — single log or batched array. CORS open for localhost callers.
+ *   GET  /__hsx/health
+ */
+import type { DevEventBus } from './event-bus.js';
+export interface DevLogServer {
+    readonly port: number;
+    readonly url: string;
+    close(): Promise<void>;
+}
+export interface DevLogServerOptions {
+    readonly bus: DevEventBus;
+    /** 0 picks a free port. Provide a stable value if the bundle hard-codes it. */
+    readonly port?: number;
+    readonly host?: string;
+    /** Cap on a single POST body to prevent runaway accumulators. */
+    readonly maxBodyBytes?: number;
+}
+interface IncomingLog {
+    readonly level?: string;
+    readonly msg?: string;
+    readonly ts?: number;
+    readonly source?: string;
+    readonly fields?: Record<string, unknown>;
+}
+/**
+ * Envelope POSTed by the deployed Cloudflare Worker per handled request.
+ * The shape mirrors what the runtime's logger collector emits in
+ * `packages/runtime/src/index.ts`.
+ */
+export interface TelemetryEnvelope {
+    readonly request?: {
+        readonly method?: string;
+        readonly path?: string;
+        readonly url?: string;
+        readonly status?: number;
+        readonly durationMs?: number;
+        readonly capabilityId?: string;
+        readonly portalId?: string;
+    };
+    readonly logs?: ReadonlyArray<IncomingLog>;
+}
+export declare function startDevLogServer(opts: DevLogServerOptions): Promise<DevLogServer>;
+export {};
+//# sourceMappingURL=log-server.d.ts.map

package/dist/dev/log-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-server.d.ts","sourceRoot":"","sources":["../../src/dev/log-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,gBAAgB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC5C;AAKD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuBxF"}

package/dist/dev/log-server.js

@@ -0,0 +1,216 @@
+/**
+ * HS-X dev sidecar HTTP server.
+ *
+ * Separate from HubSpot's `ui-extensions-dev-server` — we own this. Hosts the
+ * frontend logger ingest endpoint, and will host other dev-only routes
+ * (request inspector, etc.) as they land.
+ *
+ * Routes:
+ *   POST /__hsx/log   — single log or batched array. CORS open for localhost callers.
+ *   GET  /__hsx/health
+ */
+import { createServer } from 'node:http';
+const DEFAULT_MAX_BODY_BYTES = 256 * 1024;
+const ALLOWED_LEVELS = new Set(['debug', 'info', 'warn', 'error']);
+export async function startDevLogServer(opts) {
+    const { bus, host = '127.0.0.1', port = 0, maxBodyBytes = DEFAULT_MAX_BODY_BYTES } = opts;
+    const server = createServer((req, res) => {
+        handle(req, res, { bus, maxBodyBytes });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const boundPort = typeof address === 'object' && address ? address.port : port;
+    return {
+        port: boundPort,
+        url: `http://${host}:${boundPort}`,
+        close: () => closeServer(server),
+    };
+}
+function handle(req, res, ctx) {
+    applyCors(req, res);
+    if (req.method === 'OPTIONS') {
+        res.statusCode = 204;
+        res.end();
+        return;
+    }
+    if (req.method === 'GET' && req.url === '/__hsx/health') {
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/json');
+        res.end('{"ok":true}');
+        return;
+    }
+    if (req.method === 'POST' && req.url === '/__hsx/log') {
+        void readJsonBody(req, ctx.maxBodyBytes).then((result) => {
+            if (result.kind === 'error') {
+                const status = result.reason === 'BODY_TOO_LARGE' ? 413 : 400;
+                res.writeHead(status, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: result.reason }));
+                return;
+            }
+            const logs = normalizeBody(result.body);
+            for (const log of logs) {
+                ingestOne(ctx.bus, log);
+            }
+            res.statusCode = 204;
+            res.end();
+        });
+        return;
+    }
+    if (req.method === 'POST' && req.url === '/__hsx/event') {
+        // Telemetry ingest from the deployed Cloudflare Worker. The Worker POSTs
+        // `{request:{...}, logs:[...]}` after each handled request. Today this is
+        // unauthenticated; the threat model is "anyone who guesses the random
+        // trycloudflare URL within the dev session's TTL can inject log lines into
+        // the developer's terminal." Mitigated by: 127.0.0.1 bind for the
+        // origin server, fresh tunnel URL per session, short TTL, capped body
+        // size. Not safe against an attacker who can observe the tunnel URL.
+        //
+        // To harden: distribute a per-session HMAC key. The runtime's existing
+        // `signRuntimeDevProxyRequest` primitive is the right signing scheme, but
+        // the key-distribution channel is unresolved — schema docs in
+        // packages/types/src/schemas/index.ts explicitly exclude signing secrets
+        // from `DevOverrideRegistration` (the public read model). Options:
+        //   (a) extend `DevOverrideRegisterRequest` with `telemetryHmacKey` and
+        //       have the control plane stash it on the runtime-internal record
+        //       only (never echo on the public registration shape);
+        //   (b) encode the key in the `telemetryUrl` (fragment or query param)
+        //       so it travels with the existing field and never needs to be
+        //       stored on the control-plane side;
+        //   (c) tie telemetry signing to the existing runtime `signingSecret`
+        //       (currently only used inbound, and itself not yet wired through
+        //       deployment config — would need that plumbing first).
+        // Pick one before shipping public dev sessions or running on shared
+        // tunnels.
+        void readJsonBody(req, ctx.maxBodyBytes).then((result) => {
+            if (result.kind === 'error') {
+                const status = result.reason === 'BODY_TOO_LARGE' ? 413 : 400;
+                res.writeHead(status, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: result.reason }));
+                return;
+            }
+            const envelope = result.body;
+            if (envelope && typeof envelope === 'object') {
+                ingestEnvelope(ctx.bus, envelope);
+            }
+            res.statusCode = 204;
+            res.end();
+        });
+        return;
+    }
+    res.statusCode = 404;
+    res.end();
+}
+function applyCors(req, res) {
+    // Dev-only sidecar. HubSpot iframe origin varies per portal, so reflect.
+    const origin = req.headers.origin ?? '*';
+    res.setHeader('Access-Control-Allow-Origin', origin);
+    res.setHeader('Vary', 'Origin');
+    res.setHeader('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+}
+async function readJsonBody(req, maxBytes) {
+    // Drain the body fully before deciding — throwing mid-iteration on some
+    // runtimes (Bun's node:http compat) interferes with writing the response.
+    let received = 0;
+    let overflowed = false;
+    const chunks = [];
+    for await (const chunk of req) {
+        const buf = chunk;
+        received += buf.length;
+        if (received > maxBytes) {
+            overflowed = true;
+            continue;
+        }
+        chunks.push(buf);
+    }
+    if (overflowed)
+        return { kind: 'error', reason: 'BODY_TOO_LARGE' };
+    if (chunks.length === 0)
+        return { kind: 'ok', body: null };
+    const text = Buffer.concat(chunks).toString('utf8');
+    try {
+        return { kind: 'ok', body: JSON.parse(text) };
+    }
+    catch {
+        return { kind: 'error', reason: 'INVALID_JSON' };
+    }
+}
+function normalizeBody(body) {
+    if (Array.isArray(body))
+        return body;
+    if (body && typeof body === 'object')
+        return [body];
+    return [];
+}
+function ingestEnvelope(bus, envelope) {
+    const req = envelope.request;
+    if (req) {
+        const path = req.path ?? (req.url ? safePath(req.url) : '/');
+        const method = req.method ?? 'GET';
+        const status = typeof req.status === 'number' ? req.status : 0;
+        const duration = typeof req.durationMs === 'number' ? `${req.durationMs}ms` : '';
+        const summary = `${method.padEnd(4, ' ')} ${path}  ${String(status).padStart(3, ' ')}${duration ? `  ${duration}` : ''}`;
+        const level = status >= 500 ? 'error' : status >= 400 ? 'warn' : 'info';
+        bus.emit({
+            lane: 'request',
+            level,
+            ts: Date.now(),
+            msg: summary,
+            ...(req.capabilityId ? { source: req.capabilityId } : {}),
+        });
+    }
+    if (envelope.logs) {
+        for (const log of envelope.logs) {
+            const event = {
+                lane: 'backend',
+                level: ALLOWED_LEVELS.has(log.level) ? log.level : 'info',
+                ts: typeof log.ts === 'number' ? log.ts : Date.now(),
+                msg: typeof log.msg === 'string' ? log.msg : '',
+                ...(typeof log.source === 'string' ? { source: log.source } : {}),
+                ...(log.fields ? { fields: log.fields } : {}),
+            };
+            if (event.msg)
+                bus.emit(event);
+        }
+    }
+}
+function safePath(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+function ingestOne(bus, log) {
+    const level = ALLOWED_LEVELS.has(log.level) ? log.level : 'info';
+    const msg = typeof log.msg === 'string' ? log.msg : '';
+    if (!msg)
+        return;
+    const event = {
+        lane: 'frontend',
+        level,
+        ts: typeof log.ts === 'number' ? log.ts : Date.now(),
+        msg,
+        ...(typeof log.source === 'string' ? { source: log.source } : {}),
+        ...(log.fields ? { fields: log.fields } : {}),
+    };
+    bus.emit(event);
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+//# sourceMappingURL=log-server.js.map

package/dist/dev/log-server.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Drives the HubSpot dev-session handshake end-to-end:
+ *   1. Translate project → IR
+ *   2. Start PortManagerServer
+ *   3. setup + start ui-extensions-dev-server
+ *   4. Register dev session
+ *   5. Heartbeat every 30s
+ *   6. cleanup() tears everything down (call on SIGINT / Esc)
+ *
+ * See docs/phase-1.5/spike-ui-extension-dev-session.md.
+ */
+export interface DevSessionStart {
+    readonly accountId: number;
+    readonly projectDir: string;
+    /** Optional whitelist — only these node UIDs are registered. */
+    readonly selectedNodeUids?: readonly string[];
+    /** Called every successful heartbeat (used by the request-log renderer). */
+    readonly onHeartbeat?: (info: {
+        at: Date;
+        sessionId: number;
+    }) => void;
+}
+export interface DevSessionHandle {
+    readonly sessionId: number;
+    readonly ports: ReadonlyArray<{
+        serverId: string;
+        port: number;
+    }>;
+    readonly nodeUids: readonly string[];
+    cleanup(): Promise<void>;
+}
+export declare function startDevSession(input: DevSessionStart): Promise<DevSessionHandle>;
+//# sourceMappingURL=session-manager.d.ts.map

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

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

package/dist/dev/session-manager.js

@@ -0,0 +1,132 @@
+/**
+ * Drives the HubSpot dev-session handshake end-to-end:
+ *   1. Translate project → IR
+ *   2. Start PortManagerServer
+ *   3. setup + start ui-extensions-dev-server
+ *   4. Register dev session
+ *   5. Heartbeat every 30s
+ *   6. cleanup() tears everything down (call on SIGINT / Esc)
+ *
+ * See docs/phase-1.5/spike-ui-extension-dev-session.md.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createDevSessionsClient } from '@hs-x/hubspot-cli';
+import { loadDevStack } from './compat-shim.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 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,
+    }, {});
+    let nodesByUid = ir.intermediateNodesIndexedByUid;
+    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) {
+            throw new DevSessionStartError('HSX_E_DEV_SESSION_NO_NODES', 'None of the selected nodes were found in the project IR.');
+        }
+    }
+    await stack.startPortManagerServer();
+    try {
+        await stack.uie.setup({
+            components: nodesByUid,
+            profileData: ir.profileData,
+            logger: stack.logger,
+            urls: {
+                api: stack.getHubSpotApiOrigin(),
+                web: stack.getHubSpotWebsiteOrigin(),
+            },
+        });
+        await stack.uie.start({
+            accountId: input.accountId,
+            projectConfig: projectConfig,
+            requestPorts: stack.requestPorts,
+        });
+        const activeServers = await stack.getActiveServers();
+        const ports = Object.entries(activeServers).map(([serverId, port]) => ({
+            serverId,
+            port,
+        }));
+        const client = await createDevSessionsClient({
+            accountId: input.accountId,
+        });
+        const { sessionId } = await client.register({ ports });
+        const heartbeat = setInterval(async () => {
+            try {
+                await client.heartbeat({ sessionId });
+                input.onHeartbeat?.({ at: new Date(), sessionId });
+            }
+            catch {
+                // Best-effort. The next heartbeat will retry; if the session is dead the
+                // user will notice and can restart.
+            }
+        }, HEARTBEAT_INTERVAL_MS);
+        let cleanedUp = false;
+        const cleanup = async () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            clearInterval(heartbeat);
+            const errors = [];
+            try {
+                await client.delete({ sessionId });
+            }
+            catch (e) {
+                errors.push(`delete: ${e.message}`);
+            }
+            try {
+                await stack.uie.cleanup();
+            }
+            catch (e) {
+                errors.push(`uie cleanup: ${e.message}`);
+            }
+            try {
+                await stack.stopPortManagerServer();
+            }
+            catch (e) {
+                errors.push(`port manager: ${e.message}`);
+            }
+            if (errors.length > 0) {
+                throw new DevSessionCleanupError(errors.join('; '));
+            }
+        };
+        return {
+            sessionId,
+            ports,
+            nodeUids: Object.keys(nodesByUid),
+            cleanup,
+        };
+    }
+    catch (error) {
+        try {
+            await stack.stopPortManagerServer();
+        }
+        catch {
+            // best-effort
+        }
+        throw error;
+    }
+}
+class DevSessionStartError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'DevSessionStartError';
+        this.code = code;
+    }
+}
+class DevSessionCleanupError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DevSessionCleanupError';
+    }
+}
+//# sourceMappingURL=session-manager.js.map

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

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

package/dist/dev/stream-renderer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Renders dev event-bus events to stderr as interleaved, timestamped lanes.
+ *
+ *   14:03:21.480  frontend  info   logger.info  hello from the card
+ *   14:03:21.418  backend   info                fetched contact 12345
+ *   14:03:21.412  request   ok     POST /actions/sync-contact 200  142ms
+ *
+ * The lane prefix tells the developer which surface emitted the line; the
+ * level color matches conventions used elsewhere in the reporter.
+ */
+import type { DevEventBus } from './event-bus.js';
+export interface DevStreamRendererOptions {
+    readonly bus: DevEventBus;
+    readonly stderr?: NodeJS.WritableStream;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly isTTY?: boolean;
+}
+export interface DevStreamRenderer {
+    stop(): void;
+}
+export declare function startDevStreamRenderer(opts: DevStreamRendererOptions): DevStreamRenderer;
+//# sourceMappingURL=stream-renderer.d.ts.map

package/dist/dev/stream-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-renderer.d.ts","sourceRoot":"","sources":["../../src/dev/stream-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAY,WAAW,EAAY,MAAM,gBAAgB,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,IAAI,CAAC;CACd;AAQD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CAaxF"}

package/dist/dev/stream-renderer.js

@@ -0,0 +1,65 @@
+/**
+ * Renders dev event-bus events to stderr as interleaved, timestamped lanes.
+ *
+ *   14:03:21.480  frontend  info   logger.info  hello from the card
+ *   14:03:21.418  backend   info                fetched contact 12345
+ *   14:03:21.412  request   ok     POST /actions/sync-contact 200  142ms
+ *
+ * The lane prefix tells the developer which surface emitted the line; the
+ * level color matches conventions used elsewhere in the reporter.
+ */
+import { detectColor, detectUnicode, makeStyle } from '../reporter/style.js';
+const LANE_LABEL = {
+    frontend: 'frontend',
+    backend: 'backend ',
+    request: 'request ',
+};
+export function startDevStreamRenderer(opts) {
+    const stderr = opts.stderr ?? process.stderr;
+    const env = opts.env ?? process.env;
+    const isTTY = opts.isTTY ?? Boolean(stderr.isTTY);
+    const style = makeStyle(detectColor(env, isTTY), detectUnicode(env));
+    const unsubscribe = opts.bus.subscribe((event) => {
+        stderr.write(`${formatLine(event, style)}\n`);
+    });
+    return {
+        stop: unsubscribe,
+    };
+}
+function formatLine(event, style) {
+    const ts = style.dim(formatTimestamp(event.ts));
+    const lane = paintLane(event.lane, style);
+    const level = paintLevel(event.level, style);
+    const source = event.source ? `${style.dim(event.source)}  ` : '';
+    return `  ${ts}  ${lane}  ${level}  ${source}${event.msg}`;
+}
+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);
+    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-renderer.js.map

package/dist/dev/stream-renderer.js.map

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