@limrun/api 0.48.4 → 0.49.1

package/destination-tunnel-inspection.d.ts

@@ -0,0 +1,71 @@
+import type { Entry, Header } from 'har-format';
+export { deriveDestinationTunnelInspectionURL } from "./internal/destination-tunnel-url.js";
+export interface DestinationTunnelInspectionExtension {
+    tunnelId: string;
+    selectorId: string;
+    error?: string;
+    requestBodyTruncated?: boolean;
+    responseBodyTruncated?: boolean;
+    responseTrailers?: Header[];
+    responseCookieSameSite?: Array<{
+        index: number;
+        value: string;
+    }>;
+}
+export type DestinationTunnelInspectionComplete = Entry & {
+    _limrun: DestinationTunnelInspectionExtension;
+};
+export interface DestinationTunnelInspectionGap {
+    fromSequence: number;
+    toSequence: number;
+    message: string;
+}
+export type DestinationTunnelInspectionMetadataEvent = {
+    type: 'complete';
+    sequence: number;
+    requestId: string;
+    data: DestinationTunnelInspectionComplete;
+} | {
+    type: 'gap';
+    sequence: number;
+    data: DestinationTunnelInspectionGap;
+} | {
+    type: 'inspection_error';
+    sequence: number;
+    requestId?: string;
+    data: {
+        message: string;
+        [key: string]: unknown;
+    };
+};
+export interface DestinationTunnelInspectionBodyEvent {
+    type: 'body';
+    sequence: number;
+    requestId: string;
+    direction: 'request' | 'response';
+    body: Uint8Array;
+}
+export type DestinationTunnelInspectionEvent = DestinationTunnelInspectionMetadataEvent | DestinationTunnelInspectionBodyEvent;
+export type DestinationTunnelInspectionEventCallback = (event: DestinationTunnelInspectionEvent) => void;
+export type DestinationTunnelInspectionErrorCallback = (error: Error) => void;
+export interface DestinationTunnelInspectionStreamOptions {
+    onEvent?: DestinationTunnelInspectionEventCallback;
+    onError?: DestinationTunnelInspectionErrorCallback;
+    reconnectInitialDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+}
+export interface DestinationTunnelInspectionStream {
+    close: () => void;
+}
+/**
+ * Follow one tunnel's inspection SSE feed independently from its data
+ * WebSocket. Authentication is carried in `?token=` so the same endpoint can
+ * be consumed by browser-native EventSource.
+ */
+export declare function startDestinationTunnelInspectionStream(remoteURL: string, tunnelId: string, token: string, options?: DestinationTunnelInspectionStreamOptions): DestinationTunnelInspectionStream;
+/**
+ * Decode one browser/EventSource message while keeping the public inspection
+ * event API independent of SSE transport details.
+ */
+export declare function decodeDestinationTunnelInspectionSSEEvent(lastEventId: string | undefined, text: string): DestinationTunnelInspectionEvent;
+//# sourceMappingURL=destination-tunnel-inspection.d.ts.map

package/destination-tunnel-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-tunnel-inspection.d.ts","sourceRoot":"","sources":["src/destination-tunnel-inspection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAchD,OAAO,EAAE,oCAAoC,EAAE,6CAA0C;AAEzF,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,mCAAmC,GAAG,KAAK,GAAG;IACxD,OAAO,EAAE,oCAAoC,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,wCAAwC,GAChD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,mCAAmC,CAAC;CAC3C,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,8BAA8B,CAAC;CACtC,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACnD,CAAC;AAEN,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,MAAM,gCAAgC,GACxC,wCAAwC,GACxC,oCAAoC,CAAC;AAEzC,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;AACzG,MAAM,MAAM,wCAAwC,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAE9E,MAAM,WAAW,wCAAwC;IACvD,OAAO,CAAC,EAAE,wCAAwC,CAAC;IACnD,OAAO,CAAC,EAAE,wCAAwC,CAAC;IACnD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wCAA6C,GACrD,iCAAiC,CAiFnC;AAED;;;GAGG;AACH,wBAAgB,yCAAyC,CACvD,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,gCAAgC,CAyClC"}

package/destination-tunnel-inspection.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveDestinationTunnelInspectionURL = void 0;
+exports.startDestinationTunnelInspectionStream = startDestinationTunnelInspectionStream;
+exports.decodeDestinationTunnelInspectionSSEEvent = decodeDestinationTunnelInspectionSSEEvent;
+const eventsource_client_1 = require("eventsource-client");
+const proxy_transport_1 = require("./internal/proxy-transport.js");
+const destination_tunnel_url_1 = require("./internal/destination-tunnel-url.js");
+const destination_tunnel_wire_reader_1 = require("./internal/destination-tunnel-wire-reader.js");
+var destination_tunnel_url_2 = require("./internal/destination-tunnel-url.js");
+Object.defineProperty(exports, "deriveDestinationTunnelInspectionURL", { enumerable: true, get: function () { return destination_tunnel_url_2.deriveDestinationTunnelInspectionURL; } });
+/**
+ * Follow one tunnel's inspection SSE feed independently from its data
+ * WebSocket. Authentication is carried in `?token=` so the same endpoint can
+ * be consumed by browser-native EventSource.
+ */
+function startDestinationTunnelInspectionStream(remoteURL, tunnelId, token, options = {}) {
+    let active = true;
+    let lastSequence = 0;
+    const reportError = (error) => {
+        invokeSafely(options.onError, error);
+    };
+    const emitGap = (fromSequence, toSequence) => {
+        invokeSafely(options.onEvent, {
+            type: 'gap',
+            sequence: toSequence,
+            data: {
+                fromSequence,
+                toSequence,
+                message: `Inspection stream gap: missing sequences ${fromSequence}-${toSequence}`,
+            },
+        }, reportError);
+    };
+    const acceptSequence = (sequence, explicitGap) => {
+        if (!Number.isSafeInteger(sequence) || sequence < 0) {
+            throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection sequence must be a safe non-negative integer');
+        }
+        if (sequence <= lastSequence) {
+            throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError(`inspection sequence ${sequence} is not newer than ${lastSequence}`);
+        }
+        if (explicitGap) {
+            if (explicitGap.fromSequence !== lastSequence + 1 ||
+                explicitGap.toSequence !== sequence ||
+                explicitGap.fromSequence > explicitGap.toSequence) {
+                throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('invalid inspection gap range');
+            }
+            emitGap(explicitGap.fromSequence, explicitGap.toSequence);
+        }
+        else if (sequence > lastSequence + 1) {
+            emitGap(lastSequence + 1, sequence - 1);
+        }
+        lastSequence = sequence;
+    };
+    const url = (0, destination_tunnel_url_1.deriveDestinationTunnelInspectionURL)(remoteURL, tunnelId, lastSequence, token);
+    const source = (0, eventsource_client_1.createEventSource)({
+        url,
+        fetch: proxy_transport_1.nodeProxyTransport.fetch.bind(proxy_transport_1.nodeProxyTransport),
+        onMessage: (message) => {
+            if (!active)
+                return;
+            try {
+                const event = decodeDestinationTunnelInspectionSSEEvent(message.id, message.data);
+                if (event.type === 'gap') {
+                    acceptSequence(event.sequence, event.data);
+                }
+                else {
+                    acceptSequence(event.sequence);
+                    invokeSafely(options.onEvent, event, reportError);
+                }
+            }
+            catch (error) {
+                reportError(error instanceof Error ? error : new Error(String(error)));
+            }
+        },
+        onDisconnect: () => {
+            if (active)
+                reportError(new Error('Inspection SSE disconnected; reconnecting'));
+        },
+    });
+    const close = () => {
+        if (!active)
+            return;
+        active = false;
+        source.close();
+    };
+    return { close };
+}
+/**
+ * Decode one browser/EventSource message while keeping the public inspection
+ * event API independent of SSE transport details.
+ */
+function decodeDestinationTunnelInspectionSSEEvent(lastEventId, text) {
+    if (lastEventId === undefined || !/^(0|[1-9]\d*)$/.test(lastEventId)) {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection SSE event ID must be an unsigned integer');
+    }
+    const sequence = Number(lastEventId);
+    if (!Number.isSafeInteger(sequence)) {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection sequence must be a safe non-negative integer');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection SSE data must be valid JSON');
+    }
+    const record = (0, destination_tunnel_wire_reader_1.readRecord)(parsed, 'inspection event');
+    if (record['sequence'] !== undefined) {
+        const envelopeSequence = (0, destination_tunnel_wire_reader_1.readSafeNonNegativeInteger)(record['sequence'], 'inspection sequence');
+        if (envelopeSequence !== sequence) {
+            throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection SSE event ID does not match envelope sequence');
+        }
+    }
+    if ((0, destination_tunnel_wire_reader_1.readString)(record, 'type') !== 'body') {
+        return decodeDestinationTunnelInspectionMetadataRecord(record, sequence);
+    }
+    const requestId = readRequiredRequestId(record);
+    const data = (0, destination_tunnel_wire_reader_1.readRecord)(record['data'], 'inspection body data');
+    const direction = (0, destination_tunnel_wire_reader_1.readString)(data, 'direction');
+    if (direction !== 'request' && direction !== 'response') {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('invalid inspection body direction');
+    }
+    if ((0, destination_tunnel_wire_reader_1.readString)(data, 'encoding') !== 'base64') {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection body encoding must be base64');
+    }
+    const body = decodeCanonicalBase64((0, destination_tunnel_wire_reader_1.readString)(data, 'chunk'));
+    return {
+        type: 'body',
+        sequence,
+        requestId,
+        direction,
+        body,
+    };
+}
+function decodeDestinationTunnelInspectionMetadataRecord(record, sequence) {
+    const type = (0, destination_tunnel_wire_reader_1.readString)(record, 'type');
+    const data = (0, destination_tunnel_wire_reader_1.readRecord)(record['data'], 'inspection metadata data');
+    switch (type) {
+        case 'complete':
+            return {
+                type,
+                sequence,
+                requestId: readRequiredRequestId(record),
+                data: readComplete(data),
+            };
+        case 'gap': {
+            const fromSequence = (0, destination_tunnel_wire_reader_1.readSafeNonNegativeInteger)(data['fromSequence'], 'inspection sequence');
+            const toSequence = (0, destination_tunnel_wire_reader_1.readSafeNonNegativeInteger)(data['toSequence'], 'inspection sequence');
+            return {
+                type,
+                sequence,
+                data: {
+                    fromSequence,
+                    toSequence,
+                    message: `Inspection stream gap: missing sequences ${fromSequence}-${toSequence}`,
+                },
+            };
+        }
+        case 'inspection_error':
+            return {
+                type,
+                sequence,
+                ...(record['requestId'] === undefined ? {} : { requestId: readRequiredRequestId(record) }),
+                data: { ...data, message: (0, destination_tunnel_wire_reader_1.readString)(data, 'message') },
+            };
+        default:
+            throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError(`unknown inspection metadata type ${type}`);
+    }
+}
+function readComplete(record) {
+    readDateTime(record, 'startedDateTime');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'time');
+    readRequest((0, destination_tunnel_wire_reader_1.readRecord)(record['request'], 'inspection request'));
+    readResponse((0, destination_tunnel_wire_reader_1.readRecord)(record['response'], 'inspection response'));
+    readExtension((0, destination_tunnel_wire_reader_1.readRecord)(record['_limrun'], 'inspection extension'));
+    return record;
+}
+function readExtension(record) {
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'tunnelId');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'selectorId');
+    (0, destination_tunnel_wire_reader_1.readOptionalString)(record, 'error');
+    (0, destination_tunnel_wire_reader_1.readOptionalBoolean)(record, 'requestBodyTruncated');
+    (0, destination_tunnel_wire_reader_1.readOptionalBoolean)(record, 'responseBodyTruncated');
+    if (record['responseTrailers'] !== undefined) {
+        readNameValueArray(record['responseTrailers'], 'response trailers');
+    }
+    if (record['responseCookieSameSite'] !== undefined) {
+        for (const item of (0, destination_tunnel_wire_reader_1.readArray)(record, 'responseCookieSameSite')) {
+            const sameSite = (0, destination_tunnel_wire_reader_1.readRecord)(item, 'response cookie same-site metadata');
+            (0, destination_tunnel_wire_reader_1.readSafeNonNegativeInteger)(sameSite['index'], 'response cookie same-site index');
+            (0, destination_tunnel_wire_reader_1.readString)(sameSite, 'value');
+        }
+    }
+}
+function readRequest(record) {
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'method');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'url');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'httpVersion');
+    readNameValueArray(record['headers'], 'request headers');
+    readNameValueArray(record['queryString'], 'request query string');
+    readNameValueArray(record['cookies'], 'request cookies');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'headersSize');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'bodySize');
+    if (record['postData'] !== undefined) {
+        (0, destination_tunnel_wire_reader_1.readRecord)(record['postData'], 'request post data');
+    }
+}
+function readResponse(record) {
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'status');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'statusText');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'httpVersion');
+    readNameValueArray(record['headers'], 'response headers');
+    readNameValueArray(record['cookies'], 'response cookies');
+    const content = (0, destination_tunnel_wire_reader_1.readRecord)(record['content'], 'response content');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(content, 'size');
+    (0, destination_tunnel_wire_reader_1.readString)(content, 'mimeType');
+    (0, destination_tunnel_wire_reader_1.readString)(record, 'redirectURL');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'headersSize');
+    (0, destination_tunnel_wire_reader_1.readFiniteNumber)(record, 'bodySize');
+}
+function readNameValueArray(value, name) {
+    if (!Array.isArray(value)) {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError(`${name} must be an array`);
+    }
+    for (const item of value) {
+        const record = (0, destination_tunnel_wire_reader_1.readRecord)(item, name);
+        (0, destination_tunnel_wire_reader_1.readString)(record, 'name');
+        (0, destination_tunnel_wire_reader_1.readString)(record, 'value');
+    }
+}
+function readRequiredRequestId(record) {
+    const requestId = (0, destination_tunnel_wire_reader_1.readString)(record, 'requestId');
+    if (!requestId)
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection request ID must not be empty');
+    return requestId;
+}
+function readDateTime(record, key) {
+    const value = (0, destination_tunnel_wire_reader_1.readString)(record, key);
+    if (!Number.isFinite(Date.parse(value))) {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError(`${key} must be an ISO date-time`);
+    }
+    return value;
+}
+function invokeSafely(callback, value, onFailure) {
+    if (!callback)
+        return;
+    try {
+        callback(value);
+    }
+    catch (error) {
+        onFailure?.(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+function decodeCanonicalBase64(value) {
+    try {
+        if (value.length % 4 !== 0)
+            throw new Error('invalid base64 length');
+        const binary = atob(value);
+        if (btoa(binary) !== value)
+            throw new Error('non-canonical base64');
+        return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+    }
+    catch {
+        throw new destination_tunnel_wire_reader_1.DestinationTunnelProtocolError('inspection body chunk must be valid base64');
+    }
+}
+//# sourceMappingURL=destination-tunnel-inspection.js.map

package/destination-tunnel-inspection.js.map

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

package/destination-tunnel-inspection.mjs

@@ -0,0 +1,261 @@
+import { createEventSource } from 'eventsource-client';
+import { nodeProxyTransport } from "./internal/proxy-transport.mjs";
+import { deriveDestinationTunnelInspectionURL } from "./internal/destination-tunnel-url.mjs";
+import { DestinationTunnelProtocolError, readArray, readFiniteNumber, readOptionalBoolean, readOptionalString, readRecord, readSafeNonNegativeInteger, readString, } from "./internal/destination-tunnel-wire-reader.mjs";
+export { deriveDestinationTunnelInspectionURL } from "./internal/destination-tunnel-url.mjs";
+/**
+ * Follow one tunnel's inspection SSE feed independently from its data
+ * WebSocket. Authentication is carried in `?token=` so the same endpoint can
+ * be consumed by browser-native EventSource.
+ */
+export function startDestinationTunnelInspectionStream(remoteURL, tunnelId, token, options = {}) {
+    let active = true;
+    let lastSequence = 0;
+    const reportError = (error) => {
+        invokeSafely(options.onError, error);
+    };
+    const emitGap = (fromSequence, toSequence) => {
+        invokeSafely(options.onEvent, {
+            type: 'gap',
+            sequence: toSequence,
+            data: {
+                fromSequence,
+                toSequence,
+                message: `Inspection stream gap: missing sequences ${fromSequence}-${toSequence}`,
+            },
+        }, reportError);
+    };
+    const acceptSequence = (sequence, explicitGap) => {
+        if (!Number.isSafeInteger(sequence) || sequence < 0) {
+            throw new DestinationTunnelProtocolError('inspection sequence must be a safe non-negative integer');
+        }
+        if (sequence <= lastSequence) {
+            throw new DestinationTunnelProtocolError(`inspection sequence ${sequence} is not newer than ${lastSequence}`);
+        }
+        if (explicitGap) {
+            if (explicitGap.fromSequence !== lastSequence + 1 ||
+                explicitGap.toSequence !== sequence ||
+                explicitGap.fromSequence > explicitGap.toSequence) {
+                throw new DestinationTunnelProtocolError('invalid inspection gap range');
+            }
+            emitGap(explicitGap.fromSequence, explicitGap.toSequence);
+        }
+        else if (sequence > lastSequence + 1) {
+            emitGap(lastSequence + 1, sequence - 1);
+        }
+        lastSequence = sequence;
+    };
+    const url = deriveDestinationTunnelInspectionURL(remoteURL, tunnelId, lastSequence, token);
+    const source = createEventSource({
+        url,
+        fetch: nodeProxyTransport.fetch.bind(nodeProxyTransport),
+        onMessage: (message) => {
+            if (!active)
+                return;
+            try {
+                const event = decodeDestinationTunnelInspectionSSEEvent(message.id, message.data);
+                if (event.type === 'gap') {
+                    acceptSequence(event.sequence, event.data);
+                }
+                else {
+                    acceptSequence(event.sequence);
+                    invokeSafely(options.onEvent, event, reportError);
+                }
+            }
+            catch (error) {
+                reportError(error instanceof Error ? error : new Error(String(error)));
+            }
+        },
+        onDisconnect: () => {
+            if (active)
+                reportError(new Error('Inspection SSE disconnected; reconnecting'));
+        },
+    });
+    const close = () => {
+        if (!active)
+            return;
+        active = false;
+        source.close();
+    };
+    return { close };
+}
+/**
+ * Decode one browser/EventSource message while keeping the public inspection
+ * event API independent of SSE transport details.
+ */
+export function decodeDestinationTunnelInspectionSSEEvent(lastEventId, text) {
+    if (lastEventId === undefined || !/^(0|[1-9]\d*)$/.test(lastEventId)) {
+        throw new DestinationTunnelProtocolError('inspection SSE event ID must be an unsigned integer');
+    }
+    const sequence = Number(lastEventId);
+    if (!Number.isSafeInteger(sequence)) {
+        throw new DestinationTunnelProtocolError('inspection sequence must be a safe non-negative integer');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new DestinationTunnelProtocolError('inspection SSE data must be valid JSON');
+    }
+    const record = readRecord(parsed, 'inspection event');
+    if (record['sequence'] !== undefined) {
+        const envelopeSequence = readSafeNonNegativeInteger(record['sequence'], 'inspection sequence');
+        if (envelopeSequence !== sequence) {
+            throw new DestinationTunnelProtocolError('inspection SSE event ID does not match envelope sequence');
+        }
+    }
+    if (readString(record, 'type') !== 'body') {
+        return decodeDestinationTunnelInspectionMetadataRecord(record, sequence);
+    }
+    const requestId = readRequiredRequestId(record);
+    const data = readRecord(record['data'], 'inspection body data');
+    const direction = readString(data, 'direction');
+    if (direction !== 'request' && direction !== 'response') {
+        throw new DestinationTunnelProtocolError('invalid inspection body direction');
+    }
+    if (readString(data, 'encoding') !== 'base64') {
+        throw new DestinationTunnelProtocolError('inspection body encoding must be base64');
+    }
+    const body = decodeCanonicalBase64(readString(data, 'chunk'));
+    return {
+        type: 'body',
+        sequence,
+        requestId,
+        direction,
+        body,
+    };
+}
+function decodeDestinationTunnelInspectionMetadataRecord(record, sequence) {
+    const type = readString(record, 'type');
+    const data = readRecord(record['data'], 'inspection metadata data');
+    switch (type) {
+        case 'complete':
+            return {
+                type,
+                sequence,
+                requestId: readRequiredRequestId(record),
+                data: readComplete(data),
+            };
+        case 'gap': {
+            const fromSequence = readSafeNonNegativeInteger(data['fromSequence'], 'inspection sequence');
+            const toSequence = readSafeNonNegativeInteger(data['toSequence'], 'inspection sequence');
+            return {
+                type,
+                sequence,
+                data: {
+                    fromSequence,
+                    toSequence,
+                    message: `Inspection stream gap: missing sequences ${fromSequence}-${toSequence}`,
+                },
+            };
+        }
+        case 'inspection_error':
+            return {
+                type,
+                sequence,
+                ...(record['requestId'] === undefined ? {} : { requestId: readRequiredRequestId(record) }),
+                data: { ...data, message: readString(data, 'message') },
+            };
+        default:
+            throw new DestinationTunnelProtocolError(`unknown inspection metadata type ${type}`);
+    }
+}
+function readComplete(record) {
+    readDateTime(record, 'startedDateTime');
+    readFiniteNumber(record, 'time');
+    readRequest(readRecord(record['request'], 'inspection request'));
+    readResponse(readRecord(record['response'], 'inspection response'));
+    readExtension(readRecord(record['_limrun'], 'inspection extension'));
+    return record;
+}
+function readExtension(record) {
+    readString(record, 'tunnelId');
+    readString(record, 'selectorId');
+    readOptionalString(record, 'error');
+    readOptionalBoolean(record, 'requestBodyTruncated');
+    readOptionalBoolean(record, 'responseBodyTruncated');
+    if (record['responseTrailers'] !== undefined) {
+        readNameValueArray(record['responseTrailers'], 'response trailers');
+    }
+    if (record['responseCookieSameSite'] !== undefined) {
+        for (const item of readArray(record, 'responseCookieSameSite')) {
+            const sameSite = readRecord(item, 'response cookie same-site metadata');
+            readSafeNonNegativeInteger(sameSite['index'], 'response cookie same-site index');
+            readString(sameSite, 'value');
+        }
+    }
+}
+function readRequest(record) {
+    readString(record, 'method');
+    readString(record, 'url');
+    readString(record, 'httpVersion');
+    readNameValueArray(record['headers'], 'request headers');
+    readNameValueArray(record['queryString'], 'request query string');
+    readNameValueArray(record['cookies'], 'request cookies');
+    readFiniteNumber(record, 'headersSize');
+    readFiniteNumber(record, 'bodySize');
+    if (record['postData'] !== undefined) {
+        readRecord(record['postData'], 'request post data');
+    }
+}
+function readResponse(record) {
+    readFiniteNumber(record, 'status');
+    readString(record, 'statusText');
+    readString(record, 'httpVersion');
+    readNameValueArray(record['headers'], 'response headers');
+    readNameValueArray(record['cookies'], 'response cookies');
+    const content = readRecord(record['content'], 'response content');
+    readFiniteNumber(content, 'size');
+    readString(content, 'mimeType');
+    readString(record, 'redirectURL');
+    readFiniteNumber(record, 'headersSize');
+    readFiniteNumber(record, 'bodySize');
+}
+function readNameValueArray(value, name) {
+    if (!Array.isArray(value)) {
+        throw new DestinationTunnelProtocolError(`${name} must be an array`);
+    }
+    for (const item of value) {
+        const record = readRecord(item, name);
+        readString(record, 'name');
+        readString(record, 'value');
+    }
+}
+function readRequiredRequestId(record) {
+    const requestId = readString(record, 'requestId');
+    if (!requestId)
+        throw new DestinationTunnelProtocolError('inspection request ID must not be empty');
+    return requestId;
+}
+function readDateTime(record, key) {
+    const value = readString(record, key);
+    if (!Number.isFinite(Date.parse(value))) {
+        throw new DestinationTunnelProtocolError(`${key} must be an ISO date-time`);
+    }
+    return value;
+}
+function invokeSafely(callback, value, onFailure) {
+    if (!callback)
+        return;
+    try {
+        callback(value);
+    }
+    catch (error) {
+        onFailure?.(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+function decodeCanonicalBase64(value) {
+    try {
+        if (value.length % 4 !== 0)
+            throw new Error('invalid base64 length');
+        const binary = atob(value);
+        if (btoa(binary) !== value)
+            throw new Error('non-canonical base64');
+        return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+    }
+    catch {
+        throw new DestinationTunnelProtocolError('inspection body chunk must be valid base64');
+    }
+}
+//# sourceMappingURL=destination-tunnel-inspection.mjs.map

package/destination-tunnel-inspection.mjs.map

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