lim 0.30.2 → 0.31.0

package/dist/lib/tunnel-command.test.js.map

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

package/dist/lib/tunnel-har.d.ts

@@ -0,0 +1,14 @@
+import { type DestinationTunnelInspectionComplete, type DestinationTunnelInspectionEvent } from '@limrun/api';
+export interface TunnelHarRecorder {
+    onEvent: (event: DestinationTunnelInspectionEvent) => void;
+    resetPending: () => void;
+    finalize: () => Promise<void>;
+    close: () => void;
+}
+/**
+ * Append-only NDJSON capture spool. Completed exchanges are durable
+ * independently, while finalization streams them into HAR 1.2.
+ */
+export declare function createTunnelHarRecorder(harPath: string, bodyLimit: number): TunnelHarRecorder;
+export declare function formatInspectionSummary(event: DestinationTunnelInspectionComplete): string;
+//# sourceMappingURL=tunnel-har.d.ts.map

package/dist/lib/tunnel-har.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-har.d.ts","sourceRoot":"","sources":["../../src/lib/tunnel-har.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EAEtC,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC3D,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAkE7F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mCAAmC,GAAG,MAAM,CAG1F"}

package/dist/lib/tunnel-har.js

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTunnelHarRecorder = createTunnelHarRecorder;
+exports.formatInspectionSummary = formatInspectionSummary;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const readline_1 = __importDefault(require("readline"));
+const api_1 = require("@limrun/api");
+/**
+ * Append-only NDJSON capture spool. Completed exchanges are durable
+ * independently, while finalization streams them into HAR 1.2.
+ */
+function createTunnelHarRecorder(harPath, bodyLimit) {
+    if (!Number.isInteger(bodyLimit) || bodyLimit < 1) {
+        throw new Error('HAR body limit must be a positive integer');
+    }
+    const finalPath = path_1.default.resolve(harPath);
+    const partialPath = `${finalPath}.partial`;
+    fs_1.default.mkdirSync(path_1.default.dirname(finalPath), { recursive: true });
+    ensureAppendBoundary(partialPath);
+    const descriptor = fs_1.default.openSync(partialPath, 'a', 0o600);
+    fs_1.default.fchmodSync(descriptor, 0o600);
+    const assembler = new api_1.DestinationTunnelHARAssembler(bodyLimit);
+    let closed = false;
+    const appendRecord = (record) => {
+        if (closed)
+            return;
+        fs_1.default.writeSync(descriptor, `${JSON.stringify(record)}\n`, undefined, 'utf8');
+    };
+    const onEvent = (event) => {
+        if (closed)
+            return;
+        if (event.type === 'gap') {
+            appendRecord({ type: 'gap', gap: event.data });
+            return;
+        }
+        const entry = assembler.add(event);
+        if (entry)
+            appendRecord({ type: 'entry', entry });
+    };
+    const resetPending = () => {
+        assembler.reset();
+    };
+    const close = () => {
+        if (closed)
+            return;
+        closed = true;
+        assembler.reset();
+        fs_1.default.fsyncSync(descriptor);
+        fs_1.default.closeSync(descriptor);
+    };
+    const finalize = async () => {
+        close();
+        const temporaryPath = `${finalPath}.${process.pid}.${Date.now()}.tmp`;
+        const output = fs_1.default.openSync(temporaryPath, 'wx', 0o600);
+        try {
+            fs_1.default.writeSync(output, '{"log":{"version":"1.2","creator":{"name":"Limrun CLI","version":"1"},"entries":[');
+            const gaps = await copySpoolRecords(partialPath, output);
+            fs_1.default.writeSync(output, '],"_limrun":{"gaps":[');
+            fs_1.default.writeSync(output, gaps.map((gap) => JSON.stringify(gap)).join(','));
+            fs_1.default.writeSync(output, ']}}}\n');
+            fs_1.default.fsyncSync(output);
+        }
+        catch (error) {
+            fs_1.default.closeSync(output);
+            fs_1.default.rmSync(temporaryPath, { force: true });
+            throw error;
+        }
+        fs_1.default.closeSync(output);
+        fs_1.default.chmodSync(temporaryPath, 0o600);
+        fs_1.default.renameSync(temporaryPath, finalPath);
+        fs_1.default.rmSync(partialPath, { force: true });
+    };
+    return { onEvent, resetPending, finalize, close };
+}
+function formatInspectionSummary(event) {
+    const outcome = event._limrun.error ? `ERROR ${event._limrun.error}` : String(event.response.status);
+    return `${event.request.method} ${event.request.url} ${outcome} ${event.time}ms ${event.response.bodySize} B`;
+}
+async function copySpoolRecords(partialPath, output) {
+    const lines = readline_1.default.createInterface({
+        input: fs_1.default.createReadStream(partialPath, { encoding: 'utf8' }),
+        crlfDelay: Infinity,
+    });
+    let first = true;
+    const gaps = [];
+    for await (const line of lines) {
+        const record = parseSpoolRecord(line);
+        if (!record)
+            continue;
+        if (record.type === 'gap') {
+            gaps.push(record.gap);
+            continue;
+        }
+        if (!first)
+            fs_1.default.writeSync(output, ',');
+        fs_1.default.writeSync(output, JSON.stringify(record.entry));
+        first = false;
+    }
+    return gaps;
+}
+function parseSpoolRecord(line) {
+    if (!line.trim())
+        return undefined;
+    try {
+        const value = JSON.parse(line);
+        if (value.type === 'entry' && typeof value.entry === 'object' && value.entry !== null) {
+            return { type: 'entry', entry: value.entry };
+        }
+        if (value.type === 'gap' && typeof value.gap === 'object' && value.gap !== null) {
+            const gap = value.gap;
+            if (Number.isSafeInteger(gap.fromSequence) &&
+                Number.isSafeInteger(gap.toSequence) &&
+                typeof gap.message === 'string') {
+                return { type: 'gap', gap };
+            }
+        }
+    }
+    catch {
+        // A crash may leave one torn final record; earlier newline-delimited
+        // records remain recoverable and are still finalized.
+    }
+    return undefined;
+}
+function ensureAppendBoundary(partialPath) {
+    try {
+        const descriptor = fs_1.default.openSync(partialPath, 'r+');
+        try {
+            fs_1.default.fchmodSync(descriptor, 0o600);
+            const size = fs_1.default.fstatSync(descriptor).size;
+            if (size === 0)
+                return;
+            const byte = Buffer.alloc(1);
+            fs_1.default.readSync(descriptor, byte, 0, 1, size - 1);
+            if (byte[0] !== 0x0a)
+                fs_1.default.writeSync(descriptor, '\n', size, 'utf8');
+        }
+        finally {
+            fs_1.default.closeSync(descriptor);
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+}
+//# sourceMappingURL=tunnel-har.js.map

package/dist/lib/tunnel-har.js.map

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

package/dist/lib/tunnel-har.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tunnel-har.test.d.ts.map

package/dist/lib/tunnel-har.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-har.test.d.ts","sourceRoot":"","sources":["../../src/lib/tunnel-har.test.ts"],"names":[],"mappings":""}

package/dist/lib/tunnel-har.test.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const tunnel_har_1 = require("./tunnel-har");
+describe('tunnel HAR capture', () => {
+    let directory;
+    beforeEach(() => {
+        directory = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'lim-har-'));
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(directory, { recursive: true, force: true });
+    });
+    test('spools bounded bodies and atomically finalizes HAR 1.2', async () => {
+        const harPath = path_1.default.join(directory, 'traffic.har');
+        const recorder = (0, tunnel_har_1.createTunnelHarRecorder)(harPath, 4);
+        recorder.onEvent(bodyEvent(1, 'request', Buffer.from('hello')));
+        recorder.onEvent(bodyEvent(2, 'response', Buffer.from([0, 1, 2])));
+        recorder.onEvent({
+            type: 'gap',
+            sequence: 4,
+            data: {
+                fromSequence: 3,
+                toSequence: 4,
+                message: 'Inspection stream gap: missing sequences 3-4',
+            },
+        });
+        recorder.onEvent({
+            type: 'complete',
+            sequence: 5,
+            requestId: 'request-1',
+            data: completeEvent(),
+        });
+        recorder.onEvent({
+            type: 'complete',
+            sequence: 6,
+            requestId: 'request-2',
+            data: {
+                ...completeEvent(),
+                _limrun: {
+                    ...completeEvent()._limrun,
+                    tunnelId: 'tunnel-2',
+                },
+            },
+        });
+        expect(fs_1.default.statSync(`${harPath}.partial`).mode & 0o777).toBe(0o600);
+        await recorder.finalize();
+        expect(fs_1.default.existsSync(`${harPath}.partial`)).toBe(false);
+        expect(fs_1.default.statSync(harPath).mode & 0o777).toBe(0o600);
+        const har = JSON.parse(fs_1.default.readFileSync(harPath, 'utf8'));
+        expect(har.log.version).toBe('1.2');
+        expect(har.log.entries).toHaveLength(2);
+        expect(har.log.entries[0].request.postData).toEqual({
+            mimeType: 'application/octet-stream',
+            text: 'aGVsbA==',
+        });
+        expect(har.log.entries[0].request.postData).not.toHaveProperty('_encoding');
+        expect(har.log.entries[0].response.content).toEqual({
+            size: 3,
+            mimeType: 'application/octet-stream',
+            text: 'AAEC',
+            encoding: 'base64',
+        });
+        expect(har.log.entries[0].response).not.toHaveProperty('trailers');
+        expect(har.log.entries[0].response).not.toHaveProperty('_trailers');
+        expect(har.log.entries[0].response.cookies[0]).not.toHaveProperty('sameSite');
+        expect(har.log.entries[0]._limrun).toEqual({
+            tunnelId: 'tunnel-1',
+            selectorId: 'selector-1',
+            responseTrailers: [{ name: 'grpc-status', value: '0' }],
+            responseCookieSameSite: [{ index: 0, value: 'Strict' }],
+            requestBodyEncoding: 'base64',
+            requestBodyTruncated: true,
+            responseBodyTruncated: false,
+        });
+        expect(har.log._limrun.gaps).toEqual([
+            {
+                fromSequence: 3,
+                toSequence: 4,
+                message: 'Inspection stream gap: missing sequences 3-4',
+            },
+        ]);
+        expect(har.log.entries[1]._limrun).toMatchObject({
+            tunnelId: 'tunnel-2',
+        });
+    });
+    test('drops incomplete body state between tunnel generations', async () => {
+        const harPath = path_1.default.join(directory, 'reconnected.har');
+        const recorder = (0, tunnel_har_1.createTunnelHarRecorder)(harPath, 1024);
+        recorder.onEvent(bodyEvent(1, 'request', Buffer.from('old generation')));
+        recorder.resetPending();
+        recorder.onEvent({
+            type: 'complete',
+            sequence: 2,
+            requestId: 'request-1',
+            data: completeEvent(),
+        });
+        await recorder.finalize();
+        const har = JSON.parse(fs_1.default.readFileSync(harPath, 'utf8'));
+        expect(har.log.entries[0].request.postData.text).toBe('original body');
+    });
+    test('recovers complete records before a torn final partial record', async () => {
+        const harPath = path_1.default.join(directory, 'recovered.har');
+        fs_1.default.writeFileSync(`${harPath}.partial`, '{"type":"entry","entry":{"startedDateTime":"2026-01-01T00:00:00Z"}}\n{"type":"entry"', { mode: 0o644 });
+        const recorder = (0, tunnel_har_1.createTunnelHarRecorder)(harPath, 1);
+        await recorder.finalize();
+        const har = JSON.parse(fs_1.default.readFileSync(harPath, 'utf8'));
+        expect(har.log.entries).toEqual([{ startedDateTime: '2026-01-01T00:00:00Z' }]);
+        expect(fs_1.default.statSync(harPath).mode & 0o777).toBe(0o600);
+    });
+    test('formats only the one-line completion summary', () => {
+        expect((0, tunnel_har_1.formatInspectionSummary)(completeEvent())).toBe('POST https://example.test/full?q=secret 201 25ms 3 B');
+        const failed = completeEvent();
+        failed._limrun.error = 'connection reset';
+        expect((0, tunnel_har_1.formatInspectionSummary)(failed)).toBe('POST https://example.test/full?q=secret ERROR connection reset 25ms 3 B');
+    });
+});
+function bodyEvent(sequence, direction, body) {
+    return { type: 'body', sequence, requestId: 'request-1', direction, body };
+}
+function completeEvent() {
+    return {
+        startedDateTime: '2026-08-29T09:00:00.000Z',
+        time: 25,
+        request: {
+            method: 'POST',
+            url: 'https://example.test/full?q=secret',
+            httpVersion: 'HTTP/1.1',
+            headers: [
+                { name: 'Content-Type', value: 'application/octet-stream' },
+                { name: 'Cookie', value: 'private=1' },
+            ],
+            queryString: [{ name: 'q', value: 'secret' }],
+            cookies: [{ name: 'private', value: '1' }],
+            headersSize: 50,
+            bodySize: 5,
+            postData: { mimeType: 'application/octet-stream', text: 'original body' },
+        },
+        response: {
+            status: 201,
+            statusText: 'Created',
+            httpVersion: 'HTTP/1.1',
+            headers: [{ name: 'Set-Cookie', value: 'private=2' }],
+            cookies: [{ name: 'private', value: '2' }],
+            content: { size: 3, mimeType: 'application/octet-stream' },
+            redirectURL: '',
+            headersSize: 20,
+            bodySize: 3,
+        },
+        cache: {},
+        timings: { blocked: 0, dns: 1, connect: 2, ssl: 3, send: 4, wait: 10, receive: 5 },
+        _limrun: {
+            tunnelId: 'tunnel-1',
+            selectorId: 'selector-1',
+            responseTrailers: [{ name: 'grpc-status', value: '0' }],
+            responseCookieSameSite: [{ index: 0, value: 'Strict' }],
+        },
+    };
+}
+//# sourceMappingURL=tunnel-har.test.js.map

package/dist/lib/tunnel-har.test.js.map

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

package/dist/lib/tunnel-process.d.ts

@@ -0,0 +1,98 @@
+import { type ChildProcess } from 'child_process';
+import { type DestinationTunnelSelectors, type DestinationTunnelStatus } from '@limrun/api';
+export declare const TUNNELS_ROOT: string;
+export type TunnelProduct = 'ios' | 'android';
+export interface TunnelProcessState {
+    owner: string;
+    pid: number;
+    instanceId: string;
+    product: TunnelProduct;
+    status: 'starting' | 'ready';
+    selectors: DestinationTunnelSelectors;
+    inspect?: boolean;
+    persist?: boolean;
+    ttlSeconds?: number;
+    harPath?: string;
+    harBodyLimit?: number;
+    startedAt: string;
+    logPath: string;
+    tunnelId?: string;
+}
+export type ReadyTunnelProcessState = TunnelProcessState & {
+    status: 'ready';
+    tunnelId: string;
+};
+export type TunnelOwnerProcessIdentity = 'match' | 'mismatch' | 'missing' | 'unknown';
+export interface TunnelProcessPaths {
+    directory: string;
+    state: string;
+    log: string;
+    cancelled: string;
+}
+export declare function parseTunnelSelectors(values: readonly string[], options?: {
+    minPort?: number;
+    allowDomains?: boolean;
+}): DestinationTunnelSelectors;
+export declare function newTunnelOwner(): string;
+export declare function formatTunnelSelectors(selectors: DestinationTunnelSelectors): string[];
+export declare function formatTunnelDialFailure(failure: NonNullable<DestinationTunnelStatus['lastDialFailure']>): string;
+export declare function buildTunnelServeArgs(options: {
+    scriptPath: string;
+    product: TunnelProduct;
+    instanceId: string;
+    owner: string;
+    selectors: DestinationTunnelSelectors;
+    inspect?: boolean;
+    persist?: boolean;
+    ttlSeconds?: number;
+    harPath?: string;
+    harBodyLimit?: number;
+    verbose?: boolean;
+}): string[];
+export declare function tunnelChildEnvironment(apiKey: string | undefined, environment?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function waitForTunnelProcessReady(options: {
+    load: () => TunnelProcessState | undefined;
+    isAlive: () => boolean;
+    sleep: (milliseconds: number) => Promise<void>;
+    now?: () => number;
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<{
+    outcome: 'ready';
+    state: ReadyTunnelProcessState;
+} | {
+    outcome: 'exited';
+} | {
+    outcome: 'timeout';
+}>;
+export declare function tunnelProcessPaths(instanceId: string, owner: string, root?: string): TunnelProcessPaths;
+export declare function claimTunnelProcess(state: TunnelProcessState, root?: string): boolean;
+export declare function updateTunnelProcess(state: TunnelProcessState, expectedOwner: string, root?: string): void;
+export declare function loadTunnelProcess(instanceId: string, owner: string, root?: string): TunnelProcessState | undefined;
+export declare function listTunnelProcesses(instanceId: string, root?: string): TunnelProcessState[];
+export declare function selectTunnelOwnersForStop(owners: TunnelProcessState[], tunnelId: string | undefined): TunnelProcessState[];
+export interface TunnelLike {
+    getConnectionState: () => 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+    onConnectionStateChange: (callback: (state: 'connecting' | 'connected' | 'disconnected' | 'reconnecting') => void) => () => void;
+}
+export declare function subscribeTunnelDisconnect(tunnel: TunnelLike, onDisconnect: () => void): () => void;
+export declare function stopTunnelErrorIsNotFound(error: unknown): boolean;
+/**
+ * Mark an owner as cancelled without removing its state. Cancellation is
+ * observed by the serving child before every reconnect attempt and by every
+ * state update, so a cancelled starting owner can never recreate the tunnel
+ * between our stop signal and its exit.
+ */
+export declare function markTunnelProcessCancelled(instanceId: string, owner: string, root?: string): void;
+export declare function isTunnelProcessCancelled(instanceId: string, owner: string, root?: string): boolean;
+export declare function clearTunnelProcess(instanceId: string, owner: string, root?: string): boolean;
+export declare function pruneTunnelLogs(instanceId: string, root?: string, retain?: number): void;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function isSpawnedTunnelProcessAlive(child: Pick<ChildProcess, 'exitCode' | 'signalCode'>, pid: number): boolean;
+export declare function tunnelProcessStartingLeaseExpired(state: TunnelProcessState, now?: number): boolean;
+export declare function tunnelOwnerProcessIdentity(state: TunnelProcessState): TunnelOwnerProcessIdentity;
+export declare function signalTunnelOwner(state: TunnelProcessState, signal: NodeJS.Signals): 'signaled' | TunnelOwnerProcessIdentity;
+export declare function prepareTunnelLog(logPath: string, maxBytes?: number): number;
+export declare function readTunnelLogTail(logPath: string, lines?: number, maxBytes?: number): string;
+export declare function capTunnelLog(logPath: string, maxBytes?: number): boolean;
+//# sourceMappingURL=tunnel-process.d.ts.map

package/dist/lib/tunnel-process.d.ts.map

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