wslog-proxy 0.0.0-stage → 0.1.1

package/dist/server/connections.d.ts

@@ -0,0 +1,21 @@
+import type { ConnectionInfo, Direction } from '../shared/protocol.js';
+import type { EventBus } from './events.js';
+export type NewConnection = Omit<ConnectionInfo, 'id' | 'status' | 'openedAt' | 'counts'>;
+/** Tracks proxied client connections and their per-second message rates. */
+export declare class ConnectionRegistry {
+    private readonly bus;
+    private readonly connections;
+    private ticks;
+    constructor(bus: EventBus);
+    create(init: NewConnection): ConnectionInfo;
+    update(id: string, patch: Partial<ConnectionInfo>): void;
+    /** Count a message; connection updates are pushed by the rate tick, not per message. */
+    countMessage(id: string, direction: Direction, bytes: number): void;
+    /** Returns and resets message counts since the last call. */
+    drainRates(): Record<string, number>;
+    get(id: string): ConnectionInfo | undefined;
+    list(): ConnectionInfo[];
+    /** "Clear" means a fresh start: forget finished connections and zero the counters of open ones. */
+    reset(): void;
+    private pruneClosed;
+}

package/dist/server/connections.js

@@ -0,0 +1,81 @@
+import { randomBytes } from 'node:crypto';
+/** Keeps the last N closed connections so the sidebar does not grow forever. */
+const MAX_CLOSED = 200;
+/** Tracks proxied client connections and their per-second message rates. */
+export class ConnectionRegistry {
+    bus;
+    connections = new Map();
+    ticks = new Map();
+    constructor(bus) {
+        this.bus = bus;
+    }
+    create(init) {
+        const connection = {
+            ...init,
+            id: randomBytes(4).toString('hex'),
+            status: 'connecting',
+            openedAt: Date.now(),
+            counts: { in: 0, out: 0, bytesIn: 0, bytesOut: 0 },
+        };
+        this.connections.set(connection.id, connection);
+        this.bus.emit('connection', connection);
+        return connection;
+    }
+    update(id, patch) {
+        const connection = this.connections.get(id);
+        if (!connection)
+            return;
+        Object.assign(connection, patch);
+        if (patch.status === 'closed' || patch.status === 'error') {
+            connection.closedAt ??= Date.now();
+            this.pruneClosed();
+        }
+        this.bus.emit('connection', connection);
+    }
+    /** Count a message; connection updates are pushed by the rate tick, not per message. */
+    countMessage(id, direction, bytes) {
+        const connection = this.connections.get(id);
+        if (!connection)
+            return;
+        connection.counts[direction]++;
+        if (direction === 'in')
+            connection.counts.bytesIn += bytes;
+        else
+            connection.counts.bytesOut += bytes;
+        this.ticks.set(id, (this.ticks.get(id) ?? 0) + 1);
+    }
+    /** Returns and resets message counts since the last call. */
+    drainRates() {
+        const rates = {};
+        for (const connection of this.connections.values()) {
+            if (connection.status === 'open')
+                rates[connection.id] = 0;
+        }
+        for (const [id, n] of this.ticks)
+            rates[id] = n;
+        this.ticks = new Map();
+        return rates;
+    }
+    get(id) {
+        return this.connections.get(id);
+    }
+    list() {
+        return [...this.connections.values()];
+    }
+    /** "Clear" means a fresh start: forget finished connections and zero the counters of open ones. */
+    reset() {
+        for (const c of this.list()) {
+            if (c.status === 'closed' || c.status === 'error')
+                this.connections.delete(c.id);
+            else
+                c.counts = { in: 0, out: 0, bytesIn: 0, bytesOut: 0 };
+        }
+        this.ticks = new Map();
+    }
+    pruneClosed() {
+        const closed = this.list().filter((c) => c.status === 'closed' || c.status === 'error');
+        for (const c of closed.slice(0, Math.max(0, closed.length - MAX_CLOSED)))
+            this.connections.delete(c.id);
+    }
+}
+//# sourceMappingURL=connections.js.map

package/dist/server/connections.js.map

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

package/dist/server/context.d.ts

@@ -0,0 +1,37 @@
+import type { IncomingMessage } from 'node:http';
+import type { AppInfo, Role, TargetInfo } from '../shared/protocol.js';
+import { type WslogConfig } from './config.js';
+import type { ConnectionRegistry } from './connections.js';
+import type { DemoController } from './demo/controller.js';
+import type { EventBus } from './events.js';
+import type { Router } from './http/router.js';
+import type { Masker } from './masking.js';
+import type { Recorder } from './recorder.js';
+import type { MessageStore } from './storage/types.js';
+import type { TargetRegistry } from './targets.js';
+import type { Logger } from './util/logger.js';
+/** Everything a route, plugin, or subsystem may need. Built once in `app.ts`. */
+export interface WslogContext {
+    readonly config: WslogConfig;
+    readonly version: string;
+    readonly logger: Logger;
+    readonly bus: EventBus;
+    readonly store: MessageStore;
+    readonly targets: TargetRegistry;
+    readonly connections: ConnectionRegistry;
+    readonly recorder: Recorder;
+    readonly masker: Masker;
+    readonly router: Router;
+    readonly demo: DemoController;
+    /** Port actually listened on (differs from config when config.port is 0). */
+    port(): number;
+}
+export declare function lanAddress(): string | undefined;
+/** The dashboard address wslog prints and hands out. `publicUrl` wins (e.g. Docker, where wslog cannot see the host's port). */
+export declare function dashboardUrl(ctx: WslogContext): string;
+export declare function shareUrl(ctx: WslogContext): string;
+/** A target as dashboards, share links, and exports see it: secrets in its URL masked. Proxying uses the real URL. */
+export declare function publicTarget<T extends TargetInfo>(ctx: WslogContext, target: T): T;
+export declare function publicTargets(ctx: WslogContext, targets?: TargetInfo[]): TargetInfo[];
+export declare function baseInfo(ctx: WslogContext, req?: IncomingMessage): Omit<AppInfo, 'role'>;
+export declare function appInfo(ctx: WslogContext, role: Role, req?: IncomingMessage): AppInfo;

package/dist/server/context.js

@@ -0,0 +1,64 @@
+import { networkInterfaces } from 'node:os';
+import { isLoopbackHost, isWildcardHost } from './config.js';
+/** Hostname other machines/apps should use to reach this wslog, when no request tells us better. */
+function publicHostname(config) {
+    if (isWildcardHost(config.host))
+        return lanAddress() || 'localhost';
+    return config.host.includes(':') ? `[${config.host}]` : config.host;
+}
+export function lanAddress() {
+    for (const addresses of Object.values(networkInterfaces())) {
+        for (const a of addresses ?? []) {
+            if (a.family === 'IPv4' && !a.internal)
+                return a.address;
+        }
+    }
+    return undefined;
+}
+/** The dashboard address wslog prints and hands out. `publicUrl` wins (e.g. Docker, where wslog cannot see the host's port). */
+export function dashboardUrl(ctx) {
+    if (ctx.config.publicUrl)
+        return ctx.config.publicUrl;
+    const hostname = publicHostname(ctx.config);
+    const display = isLoopbackHost(hostname) ? 'localhost' : hostname;
+    return `http://${display}:${ctx.port()}`;
+}
+export function shareUrl(ctx) {
+    return `${dashboardUrl(ctx)}/?token=${encodeURIComponent(ctx.config.shareToken)}`;
+}
+/**
+ * Base for the proxy URLs a dashboard shows. When wslog listens on every
+ * interface, the address the viewer's browser used is the one their apps can
+ * use too, including a Docker port mapping (`-p 8080:4000`).
+ */
+function proxyBaseUrl(ctx, req) {
+    if (isWildcardHost(ctx.config.host) && req?.headers.host)
+        return `ws://${req.headers.host}`;
+    if (ctx.config.publicUrl) {
+        const url = new URL(ctx.config.publicUrl);
+        return `${url.protocol === 'https:' ? 'wss' : 'ws'}://${url.host}`;
+    }
+    return `ws://${publicHostname(ctx.config)}:${ctx.port()}`;
+}
+/** A target as dashboards, share links, and exports see it: secrets in its URL masked. Proxying uses the real URL. */
+export function publicTarget(ctx, target) {
+    return { ...target, url: ctx.masker.url(target.url) };
+}
+export function publicTargets(ctx, targets = ctx.targets.list()) {
+    return targets.map((t) => publicTarget(ctx, t));
+}
+export function baseInfo(ctx, req) {
+    return {
+        name: 'wslog',
+        version: ctx.version,
+        proxyBaseUrl: proxyBaseUrl(ctx, req),
+        maskFields: [...ctx.masker.fields],
+        maxMessages: ctx.config.maxMessages,
+        storage: ctx.store.kind,
+        demoRunning: ctx.demo.running,
+    };
+}
+export function appInfo(ctx, role, req) {
+    return { ...baseInfo(ctx, req), role };
+}
+//# sourceMappingURL=context.js.map

package/dist/server/context.js.map

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

package/dist/server/demo/bots.d.ts

@@ -0,0 +1,4 @@
+export interface Bots {
+    stop(): void;
+}
+export declare function startBots(proxyUrl: string): Bots;

package/dist/server/demo/bots.js

@@ -0,0 +1,90 @@
+import { randomBytes } from 'node:crypto';
+import WebSocket from 'ws';
+/** Simulated chat users that talk through the wslog proxy in demo mode. */
+const LINES = [
+    'anyone seen the deploy logs?',
+    'pushed a fix for the reconnect bug 🎉',
+    'lunch?',
+    'the websocket keeps dropping after 60s, probably the load balancer idle timeout',
+    'LGTM, merging',
+    'can someone review #42',
+    'coffee ☕',
+    'rate limit is 100 msg/s per connection',
+    'I think the heartbeat interval should be 25s',
+    'ship it 🚀',
+];
+const BOTS = ['ada', 'linus', 'grace'];
+const pick = (items) => items[Math.floor(Math.random() * items.length)];
+const between = (min, max) => min + Math.random() * (max - min);
+export function startBots(proxyUrl) {
+    const timers = new Set();
+    const sockets = new Set();
+    let stopped = false;
+    const later = (ms, fn) => {
+        const t = setTimeout(() => {
+            timers.delete(t);
+            if (!stopped)
+                fn();
+        }, ms);
+        timers.add(t);
+    };
+    function connect(user, leavesAfterMs) {
+        const ws = new WebSocket(`${proxyUrl}?room=general&client=${user}`);
+        sockets.add(ws);
+        const send = (payload) => ws.readyState === WebSocket.OPEN && ws.send(JSON.stringify(payload));
+        const talk = () => {
+            if (ws.readyState !== WebSocket.OPEN)
+                return;
+            const roll = Math.random();
+            if (roll < 0.6) {
+                send({ type: 'typing' });
+                later(between(400, 1200), () => send({ type: 'message', text: pick(LINES) }));
+            }
+            else if (roll < 0.75) {
+                send({
+                    type: 'message',
+                    text: 'here are the numbers',
+                    attachments: [
+                        { kind: 'table', rows: [{ region: 'eu-west', p50: 41, p99: 180 }, { region: 'us-east', p50: 37, p99: 152 }] },
+                        { kind: 'link', url: 'https://example.com/dashboards/latency', preview: { title: 'Latency', width: 1200, height: 630 } },
+                    ],
+                });
+            }
+            else if (roll < 0.85) {
+                ws.send(randomBytes(Math.floor(between(32, 256))), { binary: true });
+            }
+            else if (roll < 0.95) {
+                send({ type: 'ping', t: Date.now() });
+            }
+            else {
+                send({ type: 'auth.refresh', password: 'hunter2' });
+            }
+            later(between(1500, 5000), talk);
+        };
+        ws.on('open', () => {
+            send({ type: 'join', user, token: `tok_${randomBytes(10).toString('hex')}` });
+            later(between(500, 2000), talk);
+            if (leavesAfterMs)
+                later(leavesAfterMs, () => ws.close(1000, 'bye 👋'));
+        });
+        ws.on('close', () => {
+            sockets.delete(ws);
+            if (!stopped && leavesAfterMs)
+                later(3000, () => connect(user, between(30_000, 60_000)));
+        });
+        ws.on('error', () => {
+            // The proxy or chat server went away; the close handler decides what to do.
+        });
+    }
+    BOTS.forEach((user, i) => later(i * 700, () => connect(user, i === 2 ? between(30_000, 45_000) : undefined)));
+    return {
+        stop() {
+            stopped = true;
+            for (const t of timers)
+                clearTimeout(t);
+            for (const ws of sockets)
+                ws.close(1001, 'demo stopped');
+        },
+    };
+}
+//# sourceMappingURL=bots.js.map

package/dist/server/demo/bots.js.map

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

package/dist/server/demo/chat-server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A tiny fake chat server used by demo mode. It speaks a JSON protocol
+ * with a few message shapes so the dashboard has something realistic to show.
+ */
+export interface ChatServer {
+    url: string;
+    close(): Promise<void>;
+}
+export declare function startChatServer(): Promise<ChatServer>;

package/dist/server/demo/chat-server.js

@@ -0,0 +1,90 @@
+import { randomBytes } from 'node:crypto';
+import WebSocket, { WebSocketServer } from 'ws';
+export async function startChatServer() {
+    const wss = new WebSocketServer({ host: '127.0.0.1', port: 0, path: '/chat' });
+    await new Promise((resolve) => wss.once('listening', resolve));
+    const { port } = wss.address();
+    const members = new Set();
+    let nextMessageId = 1;
+    const startedAt = Date.now();
+    const broadcast = (payload) => {
+        const data = JSON.stringify(payload);
+        for (const m of members)
+            if (m.ws.readyState === WebSocket.OPEN)
+                m.ws.send(data);
+    };
+    const online = () => [...members].map((m) => m.user);
+    wss.on('connection', (ws, req) => {
+        const room = new URL(req.url ?? '/', 'http://x').searchParams.get('room') ?? 'general';
+        let member;
+        ws.on('message', (data, isBinary) => {
+            if (isBinary) {
+                ws.send(JSON.stringify({ type: 'ack', kind: 'binary', bytes: data.length }));
+                return;
+            }
+            let msg;
+            try {
+                msg = JSON.parse(String(data));
+            }
+            catch {
+                ws.send(JSON.stringify({ type: 'error', code: 'bad_json', message: 'Expected JSON' }));
+                return;
+            }
+            switch (msg.type) {
+                case 'join': {
+                    member = { user: String(msg.user ?? 'anon'), ws };
+                    members.add(member);
+                    ws.send(JSON.stringify({
+                        type: 'welcome',
+                        room,
+                        session: { id: randomBytes(6).toString('hex'), token: `sess_${randomBytes(12).toString('hex')}`, expiresIn: 3600 },
+                        online: online(),
+                    }));
+                    broadcast({ type: 'presence', event: 'joined', user: member.user, online: online() });
+                    break;
+                }
+                case 'typing':
+                    broadcast({ type: 'typing', user: member?.user });
+                    break;
+                case 'message':
+                    broadcast({
+                        type: 'message',
+                        id: nextMessageId++,
+                        room,
+                        user: member?.user,
+                        text: msg.text,
+                        attachments: msg.attachments ?? [],
+                        ts: new Date().toISOString(),
+                    });
+                    break;
+                case 'auth.refresh':
+                    ws.send(JSON.stringify({ type: 'auth.ok', token: `sess_${randomBytes(12).toString('hex')}` }));
+                    break;
+                case 'ping':
+                    ws.send(JSON.stringify({ type: 'pong', t: msg.t }));
+                    break;
+                default:
+                    ws.send(JSON.stringify({ type: 'error', code: 'unknown_type', message: `Unknown type ${String(msg.type)}` }));
+            }
+        });
+        ws.on('close', () => {
+            if (!member)
+                return;
+            members.delete(member);
+            broadcast({ type: 'presence', event: 'left', user: member.user, online: online() });
+        });
+    });
+    const stats = setInterval(() => {
+        broadcast({ type: 'stats', online: members.size, messages: nextMessageId - 1, uptimeSec: Math.round((Date.now() - startedAt) / 1000) });
+    }, 10_000);
+    return {
+        url: `ws://127.0.0.1:${port}/chat`,
+        close: () => new Promise((resolve) => {
+            clearInterval(stats);
+            for (const client of wss.clients)
+                client.terminate();
+            wss.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=chat-server.js.map

package/dist/server/demo/chat-server.js.map

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

package/dist/server/demo/controller.d.ts

@@ -0,0 +1,21 @@
+import type { TargetInfo } from '../../shared/protocol.js';
+import type { TargetRegistry } from '../targets.js';
+import type { Logger } from '../util/logger.js';
+export interface DemoDeps {
+    targets: TargetRegistry;
+    logger: Logger;
+    /** Base URL the bots use to reach the proxy, e.g. `ws://127.0.0.1:4000`. */
+    localProxyBase(): string;
+}
+/** Starts the fake chat server plus bots that talk to it through the proxy. */
+export declare class DemoController {
+    private readonly deps;
+    private server?;
+    private bots?;
+    private target?;
+    private starting?;
+    constructor(deps: DemoDeps);
+    get running(): boolean;
+    start(): Promise<TargetInfo>;
+    stop(): Promise<void>;
+}

package/dist/server/demo/controller.js

@@ -0,0 +1,37 @@
+import { startBots } from './bots.js';
+import { startChatServer } from './chat-server.js';
+/** Starts the fake chat server plus bots that talk to it through the proxy. */
+export class DemoController {
+    deps;
+    server;
+    bots;
+    target;
+    starting;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get running() {
+        return Boolean(this.target);
+    }
+    start() {
+        if (this.target)
+            return Promise.resolve(this.target);
+        this.starting ??= (async () => {
+            this.server = await startChatServer();
+            const target = this.deps.targets.add(this.server.url, { demo: true });
+            this.bots = startBots(`${this.deps.localProxyBase()}${target.proxyPath}`);
+            this.target = target;
+            this.deps.logger.debug(`demo chat server at ${this.server.url}`);
+            return target;
+        })();
+        return this.starting;
+    }
+    async stop() {
+        this.bots?.stop();
+        await this.server?.close();
+        if (this.target)
+            this.deps.targets.remove(this.target.id);
+        this.server = this.bots = this.target = this.starting = undefined;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/server/demo/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/server/demo/controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AASpE,+EAA+E;AAC/E,MAAM,OAAO,cAAc;IAMI;IALrB,MAAM,CAAc;IACpB,IAAI,CAAQ;IACZ,MAAM,CAAc;IACpB,QAAQ,CAAuB;IAEvC,YAA6B,IAAc;QAAd,SAAI,GAAJ,IAAI,CAAU;IAAG,CAAC;IAE/C,IAAI,OAAO;QACT,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IACpE,CAAC;CACF"}

package/dist/server/events.d.ts

@@ -0,0 +1,19 @@
+import type { ConnectionInfo, MessageRecord, TargetInfo } from '../shared/protocol.js';
+/** Everything that happens inside wslog. Plugins and the live hub subscribe here. */
+export interface WslogEvents {
+    message: [MessageRecord];
+    connection: [ConnectionInfo];
+    targets: [TargetInfo[]];
+    cleared: [];
+    info: [];
+}
+type Listener<K extends keyof WslogEvents> = (...args: WslogEvents[K]) => void;
+/** Thin typed wrapper over EventEmitter. */
+export declare class EventBus {
+    private readonly emitter;
+    constructor();
+    on<K extends keyof WslogEvents>(event: K, listener: Listener<K>): () => void;
+    off<K extends keyof WslogEvents>(event: K, listener: Listener<K>): void;
+    emit<K extends keyof WslogEvents>(event: K, ...args: WslogEvents[K]): void;
+}
+export {};

package/dist/server/events.js

@@ -0,0 +1,19 @@
+import { EventEmitter } from 'node:events';
+/** Thin typed wrapper over EventEmitter. */
+export class EventBus {
+    emitter = new EventEmitter();
+    constructor() {
+        this.emitter.setMaxListeners(100);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return () => this.off(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    emit(event, ...args) {
+        this.emitter.emit(event, ...args);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/server/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/server/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C,4CAA4C;AAC5C,MAAM,OAAO,QAAQ;IACF,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAE9C;QACE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAA8B,KAAQ,EAAE,QAAqB;QAC7D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QACjE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAA8B,KAAQ,EAAE,QAAqB;QAC9D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CAA8B,KAAQ,EAAE,GAAG,IAAoB;QACjE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/server/http/api.d.ts

@@ -0,0 +1,6 @@
+import { type MessageRecord } from '../../shared/protocol.js';
+import { type WslogContext } from '../context.js';
+import type { Router } from './router.js';
+/** Shorten payloads for list/live transport. Full records come from `GET /api/messages/:id`. */
+export declare function toPartial(record: MessageRecord): MessageRecord;
+export declare function registerApiRoutes(router: Router, ctx: WslogContext): void;

package/dist/server/http/api.js

@@ -0,0 +1,89 @@
+import { filterFromSearchParams } from '../../shared/filter.js';
+import { LIVE_PAYLOAD_LIMIT } from '../../shared/protocol.js';
+import { appInfo, publicTarget, publicTargets, shareUrl } from '../context.js';
+import { isWildcardHost } from '../config.js';
+import { probeTarget, TargetError } from '../targets.js';
+import { HttpError } from './auth.js';
+const DEFAULT_PAGE = 500;
+const MAX_PAGE = 5000;
+/** Shorten payloads for list/live transport. Full records come from `GET /api/messages/:id`. */
+export function toPartial(record) {
+    if (record.payload.length <= LIVE_PAYLOAD_LIMIT)
+        return record;
+    return { ...record, payload: record.payload.slice(0, LIVE_PAYLOAD_LIMIT), partial: true };
+}
+export function registerApiRoutes(router, ctx) {
+    const { store, targets, connections, bus } = ctx;
+    router.get('/api/health', () => ({ ok: true }));
+    router.get('/api/info', ({ role, req }) => appInfo(ctx, role, req));
+    router.get('/api/targets', () => publicTargets(ctx));
+    router.post('/api/targets', async ({ body }) => {
+        const { url } = await body();
+        if (typeof url !== 'string')
+            throw new HttpError(400, 'Body must be {"url": "ws://..."}');
+        let target;
+        try {
+            target = targets.add(url);
+        }
+        catch (err) {
+            if (err instanceof TargetError)
+                throw new HttpError(400, err.message);
+            throw err;
+        }
+        // Say so now, not when the app first fails to connect.
+        const unreachable = await probeTarget(target.url);
+        return publicTarget(ctx, unreachable ? { ...target, unreachable } : target);
+    }, { role: 'admin' });
+    router.delete('/api/targets/:id', ({ params }) => {
+        if (!targets.remove(params.id))
+            throw new HttpError(404, 'Unknown target');
+    }, { role: 'admin' });
+    router.get('/api/connections', () => connections.list());
+    router.get('/api/messages', ({ url }) => {
+        const limit = clamp(Number(url.searchParams.get('limit') ?? DEFAULT_PAGE), 1, MAX_PAGE);
+        const before = url.searchParams.get('beforeId');
+        return store
+            .query({ ...filterFromSearchParams(url.searchParams), limit, beforeId: before ? Number(before) : undefined })
+            .map(toPartial);
+    });
+    router.get('/api/messages/:id', ({ params }) => {
+        const record = store.get(Number(params.id));
+        if (!record)
+            throw new HttpError(404, 'Message not found (it may have been dropped by the storage limit)');
+        return record;
+    });
+    router.delete('/api/messages', () => {
+        store.clear();
+        connections.reset();
+        bus.emit('cleared');
+    }, { role: 'admin' });
+    router.get('/api/export', ({ url, res }) => {
+        const filter = filterFromSearchParams(url.searchParams);
+        const body = JSON.stringify({
+            exportedAt: new Date().toISOString(),
+            wslog: ctx.version,
+            filter,
+            targets: publicTargets(ctx),
+            connections: connections.list(),
+            messages: store.query(filter),
+        }, null, 2);
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        res.writeHead(200, {
+            'Content-Type': 'application/json; charset=utf-8',
+            'Content-Disposition': `attachment; filename="wslog-${stamp}.json"`,
+            'Content-Length': Buffer.byteLength(body),
+            'Cache-Control': 'no-store',
+        });
+        res.end(body);
+    });
+    router.get('/api/share', () => ({ url: shareUrl(ctx), networkReachable: isWildcardHost(ctx.config.host) }), { role: 'admin' });
+    router.post('/api/demo', async () => {
+        const target = await ctx.demo.start();
+        bus.emit('info');
+        return publicTarget(ctx, target);
+    }, { role: 'admin' });
+}
+function clamp(n, min, max) {
+    return Number.isFinite(n) ? Math.min(max, Math.max(min, Math.floor(n))) : min;
+}
+//# sourceMappingURL=api.js.map