wslog-proxy 0.0.0-stage → 0.1.1

package/dist/server/storage/index.js

@@ -0,0 +1,40 @@
+import { resolve } from 'node:path';
+import { JsonlStore } from './jsonl.js';
+import { MemoryStore } from './memory.js';
+import { SqliteStore } from './sqlite.js';
+export { MemoryStore, JsonlStore, SqliteStore };
+/**
+ * Store spec → factory. Specs look like `memory`, `./traffic.jsonl`,
+ * `./traffic.db`, or an explicit `jsonl:path` / `sqlite:path`.
+ */
+const factories = new Map([
+    ['memory', async (_path, options) => new MemoryStore(options)],
+    ['jsonl', (path, options) => JsonlStore.open(path, options)],
+    ['sqlite', (path, options) => SqliteStore.open(path, options)],
+]);
+/** Register a custom storage backend, used as `--store <scheme>:<path>`. */
+export function registerStore(scheme, factory) {
+    factories.set(scheme, factory);
+}
+export function parseStoreSpec(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed || trimmed === 'memory')
+        return { scheme: 'memory', path: '' };
+    const explicit = /^([a-z][a-z0-9+-]*):(?!\/\/|\\)(.+)$/i.exec(trimmed);
+    if (explicit && factories.has(explicit[1].toLowerCase())) {
+        return { scheme: explicit[1].toLowerCase(), path: explicit[2] };
+    }
+    if (/\.jsonl?$/i.test(trimmed))
+        return { scheme: 'jsonl', path: trimmed };
+    if (/\.(db|sqlite3?)$/i.test(trimmed))
+        return { scheme: 'sqlite', path: trimmed };
+    throw new Error(`Unknown --store "${spec}". Use "memory", a .jsonl path, or a .db/.sqlite path.`);
+}
+export async function createStore(spec, options) {
+    const { scheme, path } = parseStoreSpec(spec);
+    const factory = factories.get(scheme);
+    if (!factory)
+        throw new Error(`No storage backend registered for "${scheme}"`);
+    return factory(path ? resolve(path) : '', options);
+}
+//# sourceMappingURL=index.js.map

package/dist/server/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAIhD;;;GAGG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAuB;IAC9C,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;CAC/D,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAqB;IACjE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC1E,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAClF,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,wDAAwD,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,OAAqB;IACnE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,GAAG,CAAC,CAAC;IAC/E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/server/storage/jsonl.d.ts

@@ -0,0 +1,30 @@
+import type { MessageRecord } from '../../shared/protocol.js';
+import type { MessageQuery, MessageStore, StoreOptions } from './types.js';
+/**
+ * Append-only JSON Lines file with an in-memory index of the newest
+ * `maxMessages` records. Writes are batched per event-loop tick, and the
+ * file is compacted when it grows past twice the limit so disk use stays bounded.
+ */
+export declare class JsonlStore implements MessageStore {
+    private readonly path;
+    private readonly options;
+    readonly kind: string;
+    private readonly memory;
+    private fd;
+    private pending;
+    private flushScheduled;
+    private linesInFile;
+    private constructor();
+    static open(path: string, options: StoreOptions): Promise<JsonlStore>;
+    private load;
+    append(record: MessageRecord): void;
+    get(id: number): MessageRecord | undefined;
+    query(query: MessageQuery): MessageRecord[];
+    clear(): void;
+    count(): number;
+    lastId(): number;
+    close(): Promise<void>;
+    private flush;
+    /** Replace the file with exactly `records` (pending writes are included in memory). */
+    private rewrite;
+}

package/dist/server/storage/jsonl.js

@@ -0,0 +1,107 @@
+import { closeSync, createReadStream, existsSync, mkdirSync, openSync, renameSync, writeFileSync, writeSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createInterface } from 'node:readline';
+import { ensurePrivateFile } from '../paths.js';
+import { MemoryStore } from './memory.js';
+/**
+ * Append-only JSON Lines file with an in-memory index of the newest
+ * `maxMessages` records. Writes are batched per event-loop tick, and the
+ * file is compacted when it grows past twice the limit so disk use stays bounded.
+ */
+export class JsonlStore {
+    path;
+    options;
+    kind;
+    memory;
+    fd = -1;
+    pending = [];
+    flushScheduled = false;
+    linesInFile = 0;
+    constructor(path, options) {
+        this.path = path;
+        this.options = options;
+        this.kind = `jsonl:${path}`;
+        this.memory = new MemoryStore(options);
+    }
+    static async open(path, options) {
+        const store = new JsonlStore(path, options);
+        await store.load();
+        return store;
+    }
+    async load() {
+        mkdirSync(dirname(this.path), { recursive: true });
+        ensurePrivateFile(this.path);
+        if (existsSync(this.path)) {
+            const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });
+            for await (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    this.memory.append(JSON.parse(line));
+                    this.linesInFile++;
+                }
+                catch {
+                    // Skip a corrupt line (e.g. a partial write after a crash).
+                }
+            }
+        }
+        this.fd = openSync(this.path, 'a');
+        if (this.linesInFile > this.options.maxMessages)
+            this.rewrite(this.memory.all());
+    }
+    append(record) {
+        this.memory.append(record);
+        this.pending.push(`${JSON.stringify(record)}\n`);
+        if (++this.linesInFile > this.options.maxMessages * 2) {
+            this.rewrite(this.memory.all());
+            return;
+        }
+        if (!this.flushScheduled) {
+            this.flushScheduled = true;
+            setImmediate(() => this.flush());
+        }
+    }
+    get(id) {
+        return this.memory.get(id);
+    }
+    query(query) {
+        return this.memory.query(query);
+    }
+    clear() {
+        this.memory.clear();
+        this.rewrite([]);
+    }
+    count() {
+        return this.memory.count();
+    }
+    lastId() {
+        return this.memory.lastId();
+    }
+    async close() {
+        this.flush();
+        if (this.fd !== -1)
+            closeSync(this.fd);
+        this.fd = -1;
+    }
+    flush() {
+        this.flushScheduled = false;
+        if (!this.pending.length || this.fd === -1)
+            return;
+        const chunk = this.pending.join('');
+        this.pending = [];
+        writeSync(this.fd, chunk);
+    }
+    /** Replace the file with exactly `records` (pending writes are included in memory). */
+    rewrite(records) {
+        this.pending = [];
+        if (this.fd !== -1)
+            closeSync(this.fd);
+        const tmp = `${this.path}.tmp`;
+        writeFileSync(tmp, records.map((r) => `${JSON.stringify(r)}\n`).join(''), { mode: 0o600 });
+        ensurePrivateFile(tmp);
+        renameSync(tmp, this.path);
+        this.linesInFile = records.length;
+        this.fd = openSync(this.path, 'a');
+    }
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/server/storage/jsonl.js.map

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

package/dist/server/storage/memory.d.ts

@@ -0,0 +1,24 @@
+import type { MessageRecord } from '../../shared/protocol.js';
+import type { MessageQuery, MessageStore, StoreOptions } from './types.js';
+/**
+ * Ring buffer of records ordered by id. Appends are O(1); `get` is O(1)
+ * because ids are increasing, so we can binary search.
+ */
+export declare class MemoryStore implements MessageStore {
+    private readonly options;
+    readonly kind: string;
+    private items;
+    private start;
+    private maxId;
+    constructor(options: StoreOptions);
+    append(record: MessageRecord): void;
+    get(id: number): MessageRecord | undefined;
+    query(query: MessageQuery): MessageRecord[];
+    clear(): void;
+    count(): number;
+    lastId(): number;
+    /** All live records, oldest first. */
+    all(): MessageRecord[];
+    close(): Promise<void>;
+    private indexOf;
+}

package/dist/server/storage/memory.js

@@ -0,0 +1,74 @@
+import { createMatcher } from '../../shared/filter.js';
+/**
+ * Ring buffer of records ordered by id. Appends are O(1); `get` is O(1)
+ * because ids are increasing, so we can binary search.
+ */
+export class MemoryStore {
+    options;
+    kind = 'memory';
+    items = [];
+    start = 0;
+    maxId = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    append(record) {
+        this.items.push(record);
+        this.maxId = Math.max(this.maxId, record.id);
+        if (this.count() > this.options.maxMessages)
+            this.start++;
+        // Compact occasionally so dropped records can be garbage collected.
+        if (this.start > 1024 && this.start > this.items.length / 2) {
+            this.items = this.items.slice(this.start);
+            this.start = 0;
+        }
+    }
+    get(id) {
+        const index = this.indexOf(id);
+        return index === -1 ? undefined : this.items[index];
+    }
+    query(query) {
+        const limit = query.limit ?? this.options.maxMessages;
+        const matches = createMatcher(query);
+        const out = [];
+        for (let i = this.items.length - 1; i >= this.start && out.length < limit; i--) {
+            const record = this.items[i];
+            if (query.beforeId !== undefined && record.id >= query.beforeId)
+                continue;
+            if (matches(record))
+                out.push(record);
+        }
+        return out.reverse();
+    }
+    clear() {
+        this.items = [];
+        this.start = 0;
+    }
+    count() {
+        return this.items.length - this.start;
+    }
+    lastId() {
+        return this.maxId;
+    }
+    /** All live records, oldest first. */
+    all() {
+        return this.items.slice(this.start);
+    }
+    async close() { }
+    indexOf(id) {
+        let lo = this.start;
+        let hi = this.items.length - 1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >>> 1;
+            const midId = this.items[mid].id;
+            if (midId === id)
+                return mid;
+            if (midId < id)
+                lo = mid + 1;
+            else
+                hi = mid - 1;
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/server/storage/memory.js.map

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

package/dist/server/storage/sqlite.d.ts

@@ -0,0 +1,23 @@
+import type { MessageRecord } from '../../shared/protocol.js';
+import type { MessageQuery, MessageStore, StoreOptions } from './types.js';
+/** SQLite storage via the built-in `node:sqlite` module (Node 22.13+). */
+export declare class SqliteStore implements MessageStore {
+    private readonly db;
+    private readonly options;
+    readonly kind: string;
+    private readonly insert;
+    private readonly prune;
+    private readonly byId;
+    private inserted;
+    private maxId;
+    private constructor();
+    static open(path: string, options: StoreOptions): Promise<SqliteStore>;
+    append(r: MessageRecord): void;
+    get(id: number): MessageRecord | undefined;
+    query(query: MessageQuery): MessageRecord[];
+    clear(): void;
+    count(): number;
+    lastId(): number;
+    close(): Promise<void>;
+    private enforceLimit;
+}

package/dist/server/storage/sqlite.js

@@ -0,0 +1,125 @@
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { ensurePrivateFile } from '../paths.js';
+/** SQLite storage via the built-in `node:sqlite` module (Node 22.13+). */
+export class SqliteStore {
+    db;
+    options;
+    kind;
+    insert;
+    prune;
+    byId;
+    inserted = 0;
+    maxId;
+    constructor(db, path, options) {
+        this.db = db;
+        this.options = options;
+        this.kind = `sqlite:${path}`;
+        db.exec(`
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = NORMAL;
+      CREATE TABLE IF NOT EXISTS messages (
+        id INTEGER PRIMARY KEY,
+        connection_id TEXT NOT NULL,
+        target_id TEXT NOT NULL,
+        direction TEXT NOT NULL,
+        time INTEGER NOT NULL,
+        size INTEGER NOT NULL,
+        kind TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        truncated INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE INDEX IF NOT EXISTS messages_connection ON messages (connection_id, id);
+    `);
+        this.insert = db.prepare(`INSERT INTO messages (id, connection_id, target_id, direction, time, size, kind, payload, truncated)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        this.prune = db.prepare('DELETE FROM messages WHERE id <= ?');
+        this.byId = db.prepare('SELECT * FROM messages WHERE id = ? AND id > ?');
+        this.maxId = Number(db.prepare('SELECT COALESCE(MAX(id), 0) AS id FROM messages').get()?.id ?? 0);
+        this.enforceLimit();
+    }
+    static async open(path, options) {
+        let sqlite;
+        try {
+            sqlite = (await import('node:sqlite'));
+        }
+        catch {
+            throw new Error(`SQLite storage needs Node.js 22.13 or newer (running ${process.version}). Use a .jsonl file instead.`);
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        // Before SQLite opens it: the -wal and -shm files copy the database's permissions.
+        ensurePrivateFile(path);
+        return new SqliteStore(new sqlite.DatabaseSync(path), path, options);
+    }
+    append(r) {
+        this.insert.run(r.id, r.connectionId, r.targetId, r.direction, r.time, r.size, r.kind, r.payload, r.truncated ? 1 : 0);
+        this.maxId = Math.max(this.maxId, r.id);
+        // Prune in batches rather than on every insert.
+        if (++this.inserted % 256 === 0)
+            this.enforceLimit();
+    }
+    get(id) {
+        const row = this.byId.get(id, this.maxId - this.options.maxMessages);
+        return row ? toRecord(row) : undefined;
+    }
+    query(query) {
+        const where = ['id > ?'];
+        const params = [this.maxId - this.options.maxMessages];
+        if (query.beforeId !== undefined) {
+            where.push('id < ?');
+            params.push(query.beforeId);
+        }
+        if (query.direction) {
+            where.push('direction = ?');
+            params.push(query.direction);
+        }
+        if (query.connectionId) {
+            where.push('connection_id = ?');
+            params.push(query.connectionId);
+        }
+        if (query.targetId) {
+            where.push('target_id = ?');
+            params.push(query.targetId);
+        }
+        if (query.q?.trim()) {
+            where.push("payload LIKE ? ESCAPE '\\'");
+            params.push(`%${query.q.trim().replace(/[\\%_]/g, '\\$&')}%`);
+        }
+        params.push(query.limit ?? this.options.maxMessages);
+        const rows = this.db
+            .prepare(`SELECT * FROM messages WHERE ${where.join(' AND ')} ORDER BY id DESC LIMIT ?`)
+            .all(...params);
+        return rows.reverse().map(toRecord);
+    }
+    clear() {
+        this.db.exec('DELETE FROM messages');
+    }
+    count() {
+        const row = this.db.prepare('SELECT COUNT(*) AS n FROM messages WHERE id > ?').get(this.maxId - this.options.maxMessages);
+        return Number(row?.n ?? 0);
+    }
+    lastId() {
+        return this.maxId;
+    }
+    async close() {
+        this.enforceLimit();
+        this.db.close();
+    }
+    enforceLimit() {
+        this.prune.run(this.maxId - this.options.maxMessages);
+    }
+}
+function toRecord(row) {
+    return {
+        id: row.id,
+        connectionId: row.connection_id,
+        targetId: row.target_id,
+        direction: row.direction,
+        time: row.time,
+        size: row.size,
+        kind: row.kind,
+        payload: row.payload,
+        truncated: row.truncated === 1,
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/server/storage/sqlite.js.map

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

package/dist/server/storage/types.d.ts

@@ -0,0 +1,30 @@
+import type { MessageFilter } from '../../shared/filter.js';
+import type { MessageRecord } from '../../shared/protocol.js';
+export interface MessageQuery extends MessageFilter {
+    /** Only messages with `id < beforeId` (for paging backwards). */
+    beforeId?: number;
+    /** Max results; the newest matching messages are returned, oldest first. */
+    limit?: number;
+}
+/**
+ * Storage adapter contract. Implementations must keep at most `maxMessages`
+ * records and drop the oldest first. Records arrive already masked.
+ *
+ * To add a backend, implement this interface and register a factory in
+ * `storage/index.ts`.
+ */
+export interface MessageStore {
+    /** Human-readable description, e.g. `memory` or `jsonl:./traffic.jsonl`. */
+    readonly kind: string;
+    append(record: MessageRecord): void;
+    get(id: number): MessageRecord | undefined;
+    query(query: MessageQuery): MessageRecord[];
+    clear(): void;
+    count(): number;
+    /** Highest id ever stored (0 if empty) so ids keep increasing across restarts. */
+    lastId(): number;
+    close(): Promise<void>;
+}
+export interface StoreOptions {
+    maxMessages: number;
+}

package/dist/server/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":""}

package/dist/server/targets.d.ts

@@ -0,0 +1,41 @@
+import { type TargetInfo } from '../shared/protocol.js';
+import type { EventBus } from './events.js';
+import type { Logger } from './util/logger.js';
+export declare class TargetError extends Error {
+}
+/** Normalize user input into a ws:// or wss:// URL, or throw a friendly error. */
+export declare function normalizeTargetUrl(input: string): string;
+/** Stable id from the URL so the proxy URL survives restarts. */
+export declare function targetIdFor(url: string): string;
+export declare class TargetRegistry {
+    private readonly bus;
+    private readonly targets;
+    constructor(bus: EventBus);
+    add(input: string, options?: {
+        demo?: boolean;
+    }): TargetInfo;
+    remove(id: string): boolean;
+    get(id: string): TargetInfo | undefined;
+    list(): TargetInfo[];
+}
+/**
+ * Can wslog reach the target's host and port right now? Resolves `undefined`
+ * if so, otherwise why not, in words. A plain TCP connect, not a WebSocket
+ * handshake, so the target never sees a fake client.
+ */
+export declare function probeTarget(url: string, timeoutMs?: number): Promise<string | undefined>;
+/**
+ * Re-register targets saved by an earlier run, then keep `file` in sync.
+ * Demo targets are skipped: their server gets a new port on every start.
+ * The file is private (0600) because target URLs can carry credentials.
+ */
+export declare function persistTargets(registry: TargetRegistry, bus: EventBus, file: string, logger: Logger): void;
+/**
+ * Build the upstream URL for a proxied request.
+ * `/p/<id>/chat?room=1` on target `ws://host:8080/ws` → `ws://host:8080/ws/chat?room=1`.
+ *
+ * The app's query string is passed through as sent (repeated keys, encoding,
+ * order), so signed URLs keep working. A key the app sends replaces the same
+ * key in the target URL.
+ */
+export declare function buildUpstreamUrl(target: TargetInfo, requestPath: string): string;