@trillboards/cli 0.1.0

package/dist/commands/generated/generated-playground-dry-run.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (partner-api-generated) -- do not edit manually
+// Regenerate with: npm run generate
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Playgrounddryrun extends BaseCommand {
+    static description = "Dry-run validate a request body against an operation schema";
+    static examples = [`$ trillboards generated playground-dry-run`];
+    static args = {
+        operation_id: Args.string({ description: 'The operationId of the endpoint to validate against.', required: true }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(Playgrounddryrun);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v1/playground/{operation_id}';
+        urlPath = urlPath.replace('{operation_id}', args['operation_id']);
+        const params = {};
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-request-metadata-get.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Getrequestmetadata extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        request_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-request-metadata-get.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (partner-api-generated) -- do not edit manually
+// Regenerate with: npm run generate
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Getrequestmetadata extends BaseCommand {
+    static description = "Look up metadata for a recent API request";
+    static examples = [`$ trillboards generated request-metadata get`];
+    static args = {
+        request_id: Args.string({ description: 'Server-generated request ID to look up.', required: true }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(Getrequestmetadata);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v1/requests/{request_id}';
+        urlPath = urlPath.replace('{request_id}', args['request_id']);
+        const params = {};
+        const result = await apiRequest('GET', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-sdk-enrich.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Sdkenrich extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-sdk-enrich.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (sdk-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Sdkenrich extends BaseCommand {
+    static description = "Census + demographic enrichment from the request IP.";
+    static examples = [`$ trillboards generated sdk-enrich`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Sdkenrich);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/sdk/enrich';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-sdk-impression.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Sdkimpression extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-sdk-impression.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (sdk-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Sdkimpression extends BaseCommand {
+    static description = "Ingest an enriched CTV/DOOH impression.";
+    static examples = [`$ trillboards generated sdk-impression`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Sdkimpression);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/sdk/impression';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-sdk-qr-beacon.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Sdkqrbeacon extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-sdk-qr-beacon.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (sdk-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Sdkqrbeacon extends BaseCommand {
+    static description = "Process beacon signals associated with a prior QR scan.";
+    static examples = [`$ trillboards generated sdk-qr-beacon`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Sdkqrbeacon);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/sdk/qr/beacon';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-sdk-qr-scan.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Sdkqrscan extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-sdk-qr-scan.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (sdk-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Sdkqrscan extends BaseCommand {
+    static description = "Record a QR-code scan for physical-to-digital attribution.";
+    static examples = [`$ trillboards generated sdk-qr-scan`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Sdkqrscan);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/sdk/qr/scan';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-sensing-paired-training-upload.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Sensingpairedtrainingupload extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-sensing-paired-training-upload.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (sensing-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Sensingpairedtrainingupload extends BaseCommand {
+    static description = "Upload a batch of paired camera/CSI training samples.";
+    static examples = [`$ trillboards generated sensing-paired-training-upload`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Sensingpairedtrainingupload);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/sensing/paired-training-samples';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/listen.d.ts

@@ -0,0 +1,39 @@
+import { BaseCommand } from '../base-command.js';
+interface SseEnvelope {
+    event?: string;
+    data: string;
+    id?: string;
+}
+export default class Listen extends BaseCommand {
+    static args: {
+        port: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        events: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private abortController?;
+    private reconnectAttempts;
+    private secret;
+    private shuttingDown;
+    run(): Promise<void>;
+    /** Compute HMAC-SHA256 hex of the payload with the session secret. */
+    static computeSignature(payload: string, secret: string): string;
+    /**
+     * Parse one or more SSE `event:` + `data:` blocks out of a raw buffer.
+     * Returns the list of complete envelopes and the remaining unparsed tail.
+     */
+    static parseSseBuffer(buffer: string): {
+        events: SseEnvelope[];
+        remainder: string;
+    };
+    static sleep(ms: number): Promise<void>;
+    private forward;
+    private streamOnce;
+}
+export {};

package/dist/commands/listen.js

@@ -0,0 +1,245 @@
+import { Args, Flags } from '@oclif/core';
+import crypto from 'node:crypto';
+import { BaseCommand } from '../base-command.js';
+import { colorize } from '../format-helpers.js';
+function maxReconnectAttempts() {
+    const raw = process.env.TRILLBOARDS_CLI_MAX_RECONNECTS;
+    if (raw === undefined || raw === '')
+        return 10;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : 10;
+}
+function reconnectDelayMs() {
+    const raw = process.env.TRILLBOARDS_CLI_RECONNECT_DELAY_MS;
+    if (raw === undefined || raw === '')
+        return 3000;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : 3000;
+}
+function forwardTimeoutMs() {
+    const raw = process.env.TRILLBOARDS_CLI_FORWARD_TIMEOUT_MS;
+    if (raw === undefined || raw === '')
+        return 5000;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : 5000;
+}
+export default class Listen extends BaseCommand {
+    static args = {
+        port: Args.integer({
+            description: 'Local port to forward webhook events to',
+            required: true,
+        }),
+    };
+    static description = 'Forward live SSE events to a local HTTP server (webhook dev loop)';
+    static examples = [
+        '<%= config.bin %> listen 3000',
+        '<%= config.bin %> listen 3000 --path /hooks',
+        '<%= config.bin %> listen 4000 --events request.logged,error.occurred',
+    ];
+    static flags = {
+        events: Flags.string({
+            default: '*',
+            description: 'Comma-separated SSE event types to subscribe to ("*" = all)',
+        }),
+        path: Flags.string({
+            default: '/webhook',
+            description: 'HTTP path on the local server to POST events to',
+        }),
+    };
+    abortController;
+    reconnectAttempts = 0;
+    secret = '';
+    shuttingDown = false;
+    async run() {
+        const { args, flags } = await this.parse(Listen);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const port = args.port;
+        if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+            this.error(`Invalid port: ${port}. Must be 1-65535.`, { exit: 1 });
+        }
+        const baseUrl = this.getBaseUrl();
+        const events = flags.events || '*';
+        const path = flags.path || '/webhook';
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        // Session-local signing secret — printed for the user to configure verification.
+        this.secret = crypto.randomBytes(24).toString('hex');
+        this.log(colorize('Trillboards webhook forwarder', 'bold'));
+        this.log('');
+        this.log(`Forwarding to: ${colorize(`http://localhost:${port}${normalizedPath}`, 'green')}`);
+        this.log(`Events:        ${events}`);
+        this.log('');
+        this.log(colorize('Signing secret (use this to verify X-Trillboards-Signature):', 'dim'));
+        this.log(`  ${this.secret}`);
+        this.log('');
+        this.log(colorize('Press Ctrl+C to stop', 'dim'));
+        this.log('');
+        const cleanup = () => {
+            this.shuttingDown = true;
+            if (this.abortController)
+                this.abortController.abort();
+            this.log('\nStopped forwarding.');
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+        while (!this.shuttingDown) {
+            try {
+                await this.streamOnce(apiKey, baseUrl, events, port, normalizedPath);
+            }
+            catch (error) {
+                if (this.shuttingDown)
+                    return;
+                const msg = error instanceof Error ? error.message : String(error);
+                this.log(colorize(`Stream error: ${msg}`, 'red'));
+            }
+            if (this.shuttingDown)
+                return;
+            const maxAttempts = maxReconnectAttempts();
+            this.reconnectAttempts += 1;
+            if (this.reconnectAttempts > maxAttempts) {
+                this.error(`Gave up after ${maxAttempts} reconnect attempts.`, { exit: 1 });
+            }
+            const delayMs = reconnectDelayMs();
+            this.log(colorize(`Reconnecting (${this.reconnectAttempts}/${maxAttempts}) in ${delayMs / 1000}s...`, 'yellow'));
+            if (delayMs > 0)
+                await Listen.sleep(delayMs);
+        }
+    }
+    /** Compute HMAC-SHA256 hex of the payload with the session secret. */
+    static computeSignature(payload, secret) {
+        return crypto.createHmac('sha256', secret).update(payload).digest('hex');
+    }
+    /**
+     * Parse one or more SSE `event:` + `data:` blocks out of a raw buffer.
+     * Returns the list of complete envelopes and the remaining unparsed tail.
+     */
+    static parseSseBuffer(buffer) {
+        const normalized = buffer.replace(/\r\n/g, '\n');
+        const parts = normalized.split('\n\n');
+        const remainder = parts.pop() ?? '';
+        const out = [];
+        for (const chunk of parts) {
+            if (!chunk.trim())
+                continue;
+            const lines = chunk.split('\n').filter((l) => l && !l.startsWith(':'));
+            if (lines.length === 0)
+                continue;
+            let eventType;
+            let id;
+            const dataLines = [];
+            for (const line of lines) {
+                if (line.startsWith('event:'))
+                    eventType = line.slice(6).trim();
+                else if (line.startsWith('id:'))
+                    id = line.slice(3).trim();
+                else if (line.startsWith('data:'))
+                    dataLines.push(line.slice(5).trim());
+            }
+            if (dataLines.length > 0) {
+                out.push({ data: dataLines.join('\n'), event: eventType, id });
+            }
+        }
+        return { events: out, remainder };
+    }
+    static sleep(ms) {
+        return new Promise((resolve) => {
+            setTimeout(resolve, ms);
+        });
+    }
+    async forward(envelope, port, path) {
+        if (!envelope.event || envelope.event === 'connected' || envelope.event === 'disconnected') {
+            return;
+        }
+        // Validate the envelope JSON once. If it's malformed we still forward the
+        // raw body so a local server can log and investigate.
+        let payloadString = envelope.data;
+        try {
+            const parsed = JSON.parse(envelope.data);
+            payloadString = JSON.stringify(parsed);
+        }
+        catch {
+            // use raw data string as-is
+        }
+        const signature = Listen.computeSignature(payloadString, this.secret);
+        const url = `http://localhost:${port}${path}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), forwardTimeoutMs());
+        const started = Date.now();
+        try {
+            const response = await fetch(url, {
+                body: payloadString,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Trillboards-Event': envelope.event,
+                    'X-Trillboards-Signature': signature,
+                },
+                method: 'POST',
+                signal: controller.signal,
+            });
+            const duration = Date.now() - started;
+            const status = response.status;
+            const color = status >= 500 ? 'red' : status >= 400 ? 'yellow' : 'green';
+            this.log(`${colorize(new Date().toISOString(), 'dim')}  ${colorize(String(status), color)}  POST ${url}  ${envelope.event}  ${colorize(`${duration}ms`, 'dim')}`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            const duration = Date.now() - started;
+            this.log(`${colorize(new Date().toISOString(), 'dim')}  ${colorize('---', 'red')}  POST ${url}  ${envelope.event}  ${colorize(`${duration}ms`, 'dim')}  ${colorize(msg, 'red')}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async streamOnce(apiKey, baseUrl, events, port, path) {
+        const url = new URL('/v1/partner/events/stream', baseUrl);
+        if (events && events !== '*') {
+            url.searchParams.set('events', events);
+        }
+        this.abortController = new AbortController();
+        const response = await fetch(url.toString(), {
+            headers: {
+                'Accept': 'text/event-stream',
+                'Authorization': `Bearer ${apiKey}`,
+                'User-Agent': 'trillboards-cli',
+                'X-Trillboards-Client-Type': 'agent',
+            },
+            signal: this.abortController.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Server returned ${response.status} ${response.statusText}`);
+        }
+        if (!response.body) {
+            throw new Error('Server returned an empty body');
+        }
+        this.reconnectAttempts = 0;
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder('utf-8');
+        let buffer = '';
+        try {
+            while (!this.shuttingDown) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const { events: parsed, remainder } = Listen.parseSseBuffer(buffer);
+                buffer = remainder;
+                for (const envelope of parsed) {
+                    // Fire-and-forget forwarding — don't block the stream read loop
+                    this.forward(envelope, port, path).catch(() => {
+                        // forward() already logs errors; swallow here
+                    });
+                }
+            }
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch { /* ignore */ }
+        }
+    }
+}

package/dist/commands/login.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from '../base-command.js';
+export default class Login extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private promptForKey;
+}