@limrun/api 0.47.2 → 0.48.0

package/destination-tunnel.d.ts

@@ -0,0 +1,77 @@
+export declare const DESTINATION_TUNNEL_VERSION = 1;
+export declare const DESTINATION_TUNNEL_MAX_ROUTES = 10;
+export declare const DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES = 4;
+export interface DestinationTunnelRoute {
+    host: string;
+    port: number;
+}
+export type DestinationTunnelOpenFailureReason = 'dns_not_found' | 'dns_temporary_failure' | 'connection_refused' | 'connection_reset' | 'connection_timed_out' | 'unreachable' | 'permission_denied' | 'resource_exhausted' | 'route_not_allowed' | 'cancelled' | 'internal' | (string & {});
+export type DestinationTunnelResetReason = 'cancelled' | 'connection_error' | 'protocol_error' | 'resource_exhausted' | 'internal' | (string & {});
+export type DestinationTunnelSessionErrorCode = 'unsupported_version' | 'invalid_message' | 'invalid_route' | 'route_capacity' | 'already_active' | 'unavailable' | 'internal' | (string & {});
+export type DestinationTunnelClientMessage = {
+    type: 'start';
+    version: number;
+    routes: DestinationTunnelRoute[];
+} | {
+    type: 'openOk';
+    connId: number;
+} | {
+    type: 'openFail';
+    connId: number;
+    reason: DestinationTunnelOpenFailureReason;
+    osCode?: string;
+} | {
+    type: 'fin';
+    connId: number;
+} | {
+    type: 'reset';
+    connId: number;
+    reason: DestinationTunnelResetReason;
+    osCode?: string;
+};
+export type DestinationTunnelServerMessage = {
+    type: 'ready';
+    version: number;
+    tunnelId: string;
+} | {
+    type: 'open';
+    connId: number;
+    routeId: string;
+    host: string;
+    port: number;
+    proto: 'tcp';
+} | {
+    type: 'fin';
+    connId: number;
+} | {
+    type: 'reset';
+    connId: number;
+    reason: DestinationTunnelResetReason;
+    osCode?: string;
+} | {
+    type: 'error';
+    code: DestinationTunnelSessionErrorCode;
+};
+export type DestinationTunnelRouteErrorCode = 'empty' | 'too_many' | 'invalid_host' | 'invalid_port' | 'duplicate';
+export declare class DestinationTunnelRouteError extends Error {
+    readonly code: DestinationTunnelRouteErrorCode;
+    constructor(code: DestinationTunnelRouteErrorCode, message: string);
+}
+export declare class DestinationTunnelProtocolError extends Error {
+    constructor(message: string);
+}
+export declare function encodeDestinationTunnelDataFrame(connId: number, payload: Buffer): Buffer;
+export declare function decodeDestinationTunnelDataFrame(frame: Buffer): {
+    connId: number;
+    payload: Buffer;
+};
+export declare function validateDestinationTunnelRoutes(routes: readonly DestinationTunnelRoute[]): DestinationTunnelRoute[];
+export declare function assertDestinationTunnelOpenAllowed(message: Extract<DestinationTunnelServerMessage, {
+    type: 'open';
+}>, routes: readonly DestinationTunnelRoute[]): void;
+export declare function assertDestinationTunnelReady(message: Extract<DestinationTunnelServerMessage, {
+    type: 'ready';
+}>): void;
+export declare function encodeDestinationTunnelClientMessage(message: DestinationTunnelClientMessage): string;
+export declare function decodeDestinationTunnelServerMessage(value: unknown): DestinationTunnelServerMessage;
+//# sourceMappingURL=destination-tunnel.d.ts.map

package/destination-tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-tunnel.d.ts","sourceRoot":"","sources":["src/destination-tunnel.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,uCAAuC,IAAI,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,kCAAkC,GAC1C,eAAe,GACf,uBAAuB,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,sBAAsB,GACtB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,WAAW,GACX,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,4BAA4B,GACpC,WAAW,GACX,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,GACpB,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,iCAAiC,GACzC,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,8BAA8B,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,sBAAsB,EAAE,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kCAAkC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,MAAM,MAAM,8BAA8B,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,iCAAiC,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,+BAA+B,GACvC,OAAO,GACP,UAAU,GACV,cAAc,GACd,cAAc,GACd,WAAW,CAAC;AAEhB,qBAAa,2BAA4B,SAAQ,KAAK;IAElD,QAAQ,CAAC,IAAI,EAAE,+BAA+B;gBAArC,IAAI,EAAE,+BAA+B,EAC9C,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CASxF;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAQA;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,sBAAsB,EAAE,GACxC,sBAAsB,EAAE,CA0B1B;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,OAAO,CAAC,8BAA8B,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClE,MAAM,EAAE,SAAS,sBAAsB,EAAE,GACxC,IAAI,CAQN;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,CAAC,8BAA8B,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAClE,IAAI,CAIN;AAED,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM,CA2BpG;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAkCnG"}

package/destination-tunnel.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestinationTunnelProtocolError = exports.DestinationTunnelRouteError = exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES = exports.DESTINATION_TUNNEL_MAX_ROUTES = exports.DESTINATION_TUNNEL_VERSION = void 0;
+exports.encodeDestinationTunnelDataFrame = encodeDestinationTunnelDataFrame;
+exports.decodeDestinationTunnelDataFrame = decodeDestinationTunnelDataFrame;
+exports.validateDestinationTunnelRoutes = validateDestinationTunnelRoutes;
+exports.assertDestinationTunnelOpenAllowed = assertDestinationTunnelOpenAllowed;
+exports.assertDestinationTunnelReady = assertDestinationTunnelReady;
+exports.encodeDestinationTunnelClientMessage = encodeDestinationTunnelClientMessage;
+exports.decodeDestinationTunnelServerMessage = decodeDestinationTunnelServerMessage;
+const tslib_1 = require("./internal/tslib.js");
+const net_1 = tslib_1.__importDefault(require("net"));
+exports.DESTINATION_TUNNEL_VERSION = 1;
+exports.DESTINATION_TUNNEL_MAX_ROUTES = 10;
+exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES = 4;
+class DestinationTunnelRouteError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'DestinationTunnelRouteError';
+    }
+}
+exports.DestinationTunnelRouteError = DestinationTunnelRouteError;
+class DestinationTunnelProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DestinationTunnelProtocolError';
+    }
+}
+exports.DestinationTunnelProtocolError = DestinationTunnelProtocolError;
+function encodeDestinationTunnelDataFrame(connId, payload) {
+    validateConnectionId(connId);
+    if (payload.length === 0) {
+        throw new DestinationTunnelProtocolError('tunnel data frame must include a payload');
+    }
+    const frame = Buffer.allocUnsafe(exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES + payload.length);
+    frame.writeUInt32BE(connId, 0);
+    payload.copy(frame, exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES);
+    return frame;
+}
+function decodeDestinationTunnelDataFrame(frame) {
+    if (frame.length <= exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES) {
+        throw new DestinationTunnelProtocolError('tunnel data frame must include a payload');
+    }
+    return {
+        connId: frame.readUInt32BE(0),
+        payload: frame.subarray(exports.DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES),
+    };
+}
+function validateDestinationTunnelRoutes(routes) {
+    if (routes.length === 0) {
+        throw new DestinationTunnelRouteError('empty', 'at least one tunnel route is required');
+    }
+    if (routes.length > exports.DESTINATION_TUNNEL_MAX_ROUTES) {
+        throw new DestinationTunnelRouteError('too_many', `at most ${exports.DESTINATION_TUNNEL_MAX_ROUTES} tunnel routes are allowed`);
+    }
+    const canonicalRoutes = [];
+    const seen = new Set();
+    for (const route of routes) {
+        const canonical = canonicalizeDestinationTunnelRoute(route);
+        const key = `${canonical.host}\0${canonical.port}`;
+        if (seen.has(key)) {
+            throw new DestinationTunnelRouteError('duplicate', `duplicate tunnel route ${canonical.host}:${canonical.port}`);
+        }
+        seen.add(key);
+        canonicalRoutes.push(canonical);
+    }
+    return canonicalRoutes;
+}
+function assertDestinationTunnelOpenAllowed(message, routes) {
+    const index = parseRouteId(message.routeId);
+    const route = routes[index];
+    if (!route || message.host !== route.host || message.port !== route.port || message.proto !== 'tcp') {
+        throw new DestinationTunnelProtocolError(`server requested undeclared route ${message.routeId} ${message.host}:${message.port}/${message.proto}`);
+    }
+}
+function assertDestinationTunnelReady(message) {
+    if (message.version !== exports.DESTINATION_TUNNEL_VERSION) {
+        throw new DestinationTunnelProtocolError(`unsupported tunnel version ${message.version}`);
+    }
+}
+function encodeDestinationTunnelClientMessage(message) {
+    const record = readRecord(message, 'tunnel control message');
+    const type = readString(record, 'type');
+    switch (type) {
+        case 'start': {
+            const version = readInteger(record, 'version');
+            if (version !== exports.DESTINATION_TUNNEL_VERSION) {
+                throw new DestinationTunnelProtocolError(`unsupported tunnel version ${version}`);
+            }
+            const routes = validateDestinationTunnelRoutes(readArray(record, 'routes').map(readRoute));
+            return JSON.stringify({ type, version, routes });
+        }
+        case 'openOk':
+        case 'fin':
+            return JSON.stringify({ type, connId: readConnectionId(record) });
+        case 'openFail':
+        case 'reset':
+            return JSON.stringify({
+                type,
+                connId: readConnectionId(record),
+                reason: readString(record, 'reason'),
+                ...readOptionalString(record, 'osCode'),
+            });
+        default:
+            throw new DestinationTunnelProtocolError(`unknown tunnel control message type ${type}`);
+    }
+}
+function decodeDestinationTunnelServerMessage(value) {
+    const message = readRecord(value, 'tunnel control message');
+    const type = readString(message, 'type');
+    switch (type) {
+        case 'ready':
+            return {
+                type,
+                version: readInteger(message, 'version'),
+                tunnelId: readString(message, 'tunnelId'),
+            };
+        case 'open':
+            return {
+                type,
+                connId: readConnectionId(message),
+                routeId: readString(message, 'routeId'),
+                host: readString(message, 'host'),
+                port: readPort(message, 'port'),
+                proto: readTCP(message),
+            };
+        case 'fin':
+            return { type, connId: readConnectionId(message) };
+        case 'reset':
+            return {
+                type,
+                connId: readConnectionId(message),
+                reason: readString(message, 'reason'),
+                ...readOptionalString(message, 'osCode'),
+            };
+        case 'error':
+            return { type, code: readString(message, 'code') };
+        default:
+            throw new DestinationTunnelProtocolError(`unknown tunnel control message type ${type}`);
+    }
+}
+function canonicalizeDestinationTunnelRoute(route) {
+    if (!Number.isInteger(route.port) || route.port < 1 || route.port > 65535 || route.port === 53) {
+        throw new DestinationTunnelRouteError('invalid_port', `invalid tunnel route port ${route.port}`);
+    }
+    const asciiHost = Buffer.byteLength(route.host, 'utf8') === route.host.length;
+    if (asciiHost && route.host.toLowerCase() === 'localhost') {
+        return { host: 'localhost', port: route.port };
+    }
+    const ipVersion = net_1.default.isIP(route.host);
+    if (ipVersion === 4) {
+        return { host: route.host, port: route.port };
+    }
+    if (ipVersion === 6) {
+        const hostname = new URL(`http://[${route.host}]/`).hostname;
+        const canonical = hostname.slice(1, -1);
+        if (canonical !== '::1' && /^::(?:[0-9a-f]{1,4}:)?[0-9a-f]{1,4}$/.test(canonical)) {
+            throw new DestinationTunnelRouteError('invalid_host', `invalid tunnel route host ${route.host}`);
+        }
+        return { host: canonicalizeIPv6(canonical), port: route.port };
+    }
+    throw new DestinationTunnelRouteError('invalid_host', `invalid tunnel route host ${route.host}`);
+}
+function canonicalizeIPv6(host) {
+    const mappedIPv4 = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(host);
+    if (!mappedIPv4?.[1] || !mappedIPv4[2]) {
+        return host;
+    }
+    const high = Number.parseInt(mappedIPv4[1], 16);
+    const low = Number.parseInt(mappedIPv4[2], 16);
+    return `${high >> 8}.${high & 0xff}.${low >> 8}.${low & 0xff}`;
+}
+function parseRouteId(routeId) {
+    const match = /^route-([1-9]\d*)$/.exec(routeId);
+    if (!match?.[1]) {
+        return -1;
+    }
+    return Number(match[1]) - 1;
+}
+function readRoute(value) {
+    const route = readRecord(value, 'tunnel route');
+    return {
+        host: readString(route, 'host'),
+        port: readPort(route, 'port'),
+    };
+}
+function readRecord(value, name) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new DestinationTunnelProtocolError(`${name} must be an object`);
+    }
+    return value;
+}
+function readArray(record, key) {
+    const value = record[key];
+    if (!Array.isArray(value)) {
+        throw new DestinationTunnelProtocolError(`${key} must be an array`);
+    }
+    return value;
+}
+function readString(record, key) {
+    const value = record[key];
+    if (typeof value !== 'string') {
+        throw new DestinationTunnelProtocolError(`${key} must be a string`);
+    }
+    return value;
+}
+function readOptionalString(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return {};
+    }
+    if (typeof value !== 'string') {
+        throw new DestinationTunnelProtocolError(`${key} must be a string`);
+    }
+    return { [key]: value };
+}
+function readInteger(record, key) {
+    const value = record[key];
+    if (!Number.isInteger(value)) {
+        throw new DestinationTunnelProtocolError(`${key} must be an integer`);
+    }
+    return value;
+}
+function readPort(record, key) {
+    const value = readInteger(record, key);
+    if (value < 1 || value > 65535) {
+        throw new DestinationTunnelProtocolError(`${key} must be between 1 and 65535`);
+    }
+    return value;
+}
+function readConnectionId(record) {
+    const value = readInteger(record, 'connId');
+    validateConnectionId(value);
+    return value;
+}
+function validateConnectionId(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 4294967295) {
+        throw new DestinationTunnelProtocolError('connId must be an unsigned 32-bit integer');
+    }
+}
+function readTCP(record) {
+    const value = readString(record, 'proto');
+    if (value !== 'tcp') {
+        throw new DestinationTunnelProtocolError(`unsupported tunnel transport ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=destination-tunnel.js.map

package/destination-tunnel.js.map

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

package/destination-tunnel.mjs

@@ -0,0 +1,236 @@
+import net from 'net';
+export const DESTINATION_TUNNEL_VERSION = 1;
+export const DESTINATION_TUNNEL_MAX_ROUTES = 10;
+export const DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES = 4;
+export class DestinationTunnelRouteError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'DestinationTunnelRouteError';
+    }
+}
+export class DestinationTunnelProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DestinationTunnelProtocolError';
+    }
+}
+export function encodeDestinationTunnelDataFrame(connId, payload) {
+    validateConnectionId(connId);
+    if (payload.length === 0) {
+        throw new DestinationTunnelProtocolError('tunnel data frame must include a payload');
+    }
+    const frame = Buffer.allocUnsafe(DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES + payload.length);
+    frame.writeUInt32BE(connId, 0);
+    payload.copy(frame, DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES);
+    return frame;
+}
+export function decodeDestinationTunnelDataFrame(frame) {
+    if (frame.length <= DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES) {
+        throw new DestinationTunnelProtocolError('tunnel data frame must include a payload');
+    }
+    return {
+        connId: frame.readUInt32BE(0),
+        payload: frame.subarray(DESTINATION_TUNNEL_CONN_ID_HEADER_BYTES),
+    };
+}
+export function validateDestinationTunnelRoutes(routes) {
+    if (routes.length === 0) {
+        throw new DestinationTunnelRouteError('empty', 'at least one tunnel route is required');
+    }
+    if (routes.length > DESTINATION_TUNNEL_MAX_ROUTES) {
+        throw new DestinationTunnelRouteError('too_many', `at most ${DESTINATION_TUNNEL_MAX_ROUTES} tunnel routes are allowed`);
+    }
+    const canonicalRoutes = [];
+    const seen = new Set();
+    for (const route of routes) {
+        const canonical = canonicalizeDestinationTunnelRoute(route);
+        const key = `${canonical.host}\0${canonical.port}`;
+        if (seen.has(key)) {
+            throw new DestinationTunnelRouteError('duplicate', `duplicate tunnel route ${canonical.host}:${canonical.port}`);
+        }
+        seen.add(key);
+        canonicalRoutes.push(canonical);
+    }
+    return canonicalRoutes;
+}
+export function assertDestinationTunnelOpenAllowed(message, routes) {
+    const index = parseRouteId(message.routeId);
+    const route = routes[index];
+    if (!route || message.host !== route.host || message.port !== route.port || message.proto !== 'tcp') {
+        throw new DestinationTunnelProtocolError(`server requested undeclared route ${message.routeId} ${message.host}:${message.port}/${message.proto}`);
+    }
+}
+export function assertDestinationTunnelReady(message) {
+    if (message.version !== DESTINATION_TUNNEL_VERSION) {
+        throw new DestinationTunnelProtocolError(`unsupported tunnel version ${message.version}`);
+    }
+}
+export function encodeDestinationTunnelClientMessage(message) {
+    const record = readRecord(message, 'tunnel control message');
+    const type = readString(record, 'type');
+    switch (type) {
+        case 'start': {
+            const version = readInteger(record, 'version');
+            if (version !== DESTINATION_TUNNEL_VERSION) {
+                throw new DestinationTunnelProtocolError(`unsupported tunnel version ${version}`);
+            }
+            const routes = validateDestinationTunnelRoutes(readArray(record, 'routes').map(readRoute));
+            return JSON.stringify({ type, version, routes });
+        }
+        case 'openOk':
+        case 'fin':
+            return JSON.stringify({ type, connId: readConnectionId(record) });
+        case 'openFail':
+        case 'reset':
+            return JSON.stringify({
+                type,
+                connId: readConnectionId(record),
+                reason: readString(record, 'reason'),
+                ...readOptionalString(record, 'osCode'),
+            });
+        default:
+            throw new DestinationTunnelProtocolError(`unknown tunnel control message type ${type}`);
+    }
+}
+export function decodeDestinationTunnelServerMessage(value) {
+    const message = readRecord(value, 'tunnel control message');
+    const type = readString(message, 'type');
+    switch (type) {
+        case 'ready':
+            return {
+                type,
+                version: readInteger(message, 'version'),
+                tunnelId: readString(message, 'tunnelId'),
+            };
+        case 'open':
+            return {
+                type,
+                connId: readConnectionId(message),
+                routeId: readString(message, 'routeId'),
+                host: readString(message, 'host'),
+                port: readPort(message, 'port'),
+                proto: readTCP(message),
+            };
+        case 'fin':
+            return { type, connId: readConnectionId(message) };
+        case 'reset':
+            return {
+                type,
+                connId: readConnectionId(message),
+                reason: readString(message, 'reason'),
+                ...readOptionalString(message, 'osCode'),
+            };
+        case 'error':
+            return { type, code: readString(message, 'code') };
+        default:
+            throw new DestinationTunnelProtocolError(`unknown tunnel control message type ${type}`);
+    }
+}
+function canonicalizeDestinationTunnelRoute(route) {
+    if (!Number.isInteger(route.port) || route.port < 1 || route.port > 65535 || route.port === 53) {
+        throw new DestinationTunnelRouteError('invalid_port', `invalid tunnel route port ${route.port}`);
+    }
+    const asciiHost = Buffer.byteLength(route.host, 'utf8') === route.host.length;
+    if (asciiHost && route.host.toLowerCase() === 'localhost') {
+        return { host: 'localhost', port: route.port };
+    }
+    const ipVersion = net.isIP(route.host);
+    if (ipVersion === 4) {
+        return { host: route.host, port: route.port };
+    }
+    if (ipVersion === 6) {
+        const hostname = new URL(`http://[${route.host}]/`).hostname;
+        const canonical = hostname.slice(1, -1);
+        if (canonical !== '::1' && /^::(?:[0-9a-f]{1,4}:)?[0-9a-f]{1,4}$/.test(canonical)) {
+            throw new DestinationTunnelRouteError('invalid_host', `invalid tunnel route host ${route.host}`);
+        }
+        return { host: canonicalizeIPv6(canonical), port: route.port };
+    }
+    throw new DestinationTunnelRouteError('invalid_host', `invalid tunnel route host ${route.host}`);
+}
+function canonicalizeIPv6(host) {
+    const mappedIPv4 = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(host);
+    if (!mappedIPv4?.[1] || !mappedIPv4[2]) {
+        return host;
+    }
+    const high = Number.parseInt(mappedIPv4[1], 16);
+    const low = Number.parseInt(mappedIPv4[2], 16);
+    return `${high >> 8}.${high & 0xff}.${low >> 8}.${low & 0xff}`;
+}
+function parseRouteId(routeId) {
+    const match = /^route-([1-9]\d*)$/.exec(routeId);
+    if (!match?.[1]) {
+        return -1;
+    }
+    return Number(match[1]) - 1;
+}
+function readRoute(value) {
+    const route = readRecord(value, 'tunnel route');
+    return {
+        host: readString(route, 'host'),
+        port: readPort(route, 'port'),
+    };
+}
+function readRecord(value, name) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new DestinationTunnelProtocolError(`${name} must be an object`);
+    }
+    return value;
+}
+function readArray(record, key) {
+    const value = record[key];
+    if (!Array.isArray(value)) {
+        throw new DestinationTunnelProtocolError(`${key} must be an array`);
+    }
+    return value;
+}
+function readString(record, key) {
+    const value = record[key];
+    if (typeof value !== 'string') {
+        throw new DestinationTunnelProtocolError(`${key} must be a string`);
+    }
+    return value;
+}
+function readOptionalString(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return {};
+    }
+    if (typeof value !== 'string') {
+        throw new DestinationTunnelProtocolError(`${key} must be a string`);
+    }
+    return { [key]: value };
+}
+function readInteger(record, key) {
+    const value = record[key];
+    if (!Number.isInteger(value)) {
+        throw new DestinationTunnelProtocolError(`${key} must be an integer`);
+    }
+    return value;
+}
+function readPort(record, key) {
+    const value = readInteger(record, key);
+    if (value < 1 || value > 65535) {
+        throw new DestinationTunnelProtocolError(`${key} must be between 1 and 65535`);
+    }
+    return value;
+}
+function readConnectionId(record) {
+    const value = readInteger(record, 'connId');
+    validateConnectionId(value);
+    return value;
+}
+function validateConnectionId(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 4294967295) {
+        throw new DestinationTunnelProtocolError('connId must be an unsigned 32-bit integer');
+    }
+}
+function readTCP(record) {
+    const value = readString(record, 'proto');
+    if (value !== 'tcp') {
+        throw new DestinationTunnelProtocolError(`unsupported tunnel transport ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=destination-tunnel.mjs.map

package/destination-tunnel.mjs.map

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

package/internal/destination-tunnel-management.d.mts

@@ -0,0 +1,23 @@
+import { type DestinationTunnelRoute } from "../destination-tunnel.mjs";
+export interface DestinationTunnelStatus {
+    active?: {
+        tunnelId: string;
+        state: 'starting' | 'ready' | 'stopping';
+        routes: DestinationTunnelRoute[];
+    };
+    lastFailure?: {
+        tunnelId: string;
+        code: string;
+    };
+    lastDialFailure?: {
+        tunnelId: string;
+        connectionId: number;
+        routeId: string;
+        reason: string;
+        osCode?: string;
+    };
+}
+export declare function getDestinationTunnelStatus(apiUrl: string, token: string): Promise<DestinationTunnelStatus>;
+export declare function stopDestinationTunnel(apiUrl: string, token: string, tunnelId: string): Promise<void>;
+export declare function decodeDestinationTunnelStatus(value: unknown): DestinationTunnelStatus;
+//# sourceMappingURL=destination-tunnel-management.d.mts.map

package/internal/destination-tunnel-management.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-tunnel-management.d.mts","sourceRoot":"","sources":["../src/internal/destination-tunnel-management.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmC,KAAK,sBAAsB,EAAE,kCAA8B;AAErG,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;QACzC,MAAM,EAAE,sBAAsB,EAAE,CAAC;KAClC,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1G;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAarF"}

package/internal/destination-tunnel-management.d.ts

@@ -0,0 +1,23 @@
+import { type DestinationTunnelRoute } from "../destination-tunnel.js";
+export interface DestinationTunnelStatus {
+    active?: {
+        tunnelId: string;
+        state: 'starting' | 'ready' | 'stopping';
+        routes: DestinationTunnelRoute[];
+    };
+    lastFailure?: {
+        tunnelId: string;
+        code: string;
+    };
+    lastDialFailure?: {
+        tunnelId: string;
+        connectionId: number;
+        routeId: string;
+        reason: string;
+        osCode?: string;
+    };
+}
+export declare function getDestinationTunnelStatus(apiUrl: string, token: string): Promise<DestinationTunnelStatus>;
+export declare function stopDestinationTunnel(apiUrl: string, token: string, tunnelId: string): Promise<void>;
+export declare function decodeDestinationTunnelStatus(value: unknown): DestinationTunnelStatus;
+//# sourceMappingURL=destination-tunnel-management.d.ts.map

package/internal/destination-tunnel-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-tunnel-management.d.ts","sourceRoot":"","sources":["../src/internal/destination-tunnel-management.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmC,KAAK,sBAAsB,EAAE,iCAA8B;AAErG,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;QACzC,MAAM,EAAE,sBAAsB,EAAE,CAAC;KAClC,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1G;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAarF"}