@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/transport/peer_channel.js

@@ -0,0 +1,116 @@
+import { decodeClientFrameV2, encodeServerFrameV2, } from "../protocol/v2/index.js";
+import { decodeRoute, decodeRoutePayload, parseJson } from "../vendor/protocol/outer/index.js";
+/**
+ * A Host-side protocol-v2 channel for one authorized Owner. The relay
+ * authenticates and injects `source_owner_id` for Owner-to-Host routes; this
+ * channel only accepts routes for its immutable endpoint identity and owner.
+ */
+export class V2PeerChannel {
+    relay;
+    ownerId;
+    host;
+    onMessage;
+    unsubscribe;
+    constructor(relay, ownerId, host, onMessage) {
+        this.relay = relay;
+        this.ownerId = ownerId;
+        this.host = host;
+        this.onMessage = onMessage;
+        const listener = (line) => this.onLine(line);
+        relay.on("message", listener);
+        this.unsubscribe = () => relay.off("message", listener);
+    }
+    getPeerId() {
+        return this.ownerId;
+    }
+    sendV2(msg) {
+        try {
+            const ct = Buffer.from(encodeServerFrameV2(msg)).toString("base64");
+            this.relay.send(JSON.stringify({
+                type: "route",
+                purpose: msg.type === "pair_ok" || msg.type === "pair_error" ? "pairing" : "session",
+                device_id: this.host.deviceId,
+                endpoint_id: this.host.endpointId,
+                runtime_instance_id: this.host.runtimeInstanceId,
+                target_owner_id: this.ownerId,
+                ct,
+            }));
+            return true;
+        }
+        catch {
+            // Formal history recovers messages lost while the relay reconnects.
+            return false;
+        }
+    }
+    detach() {
+        this.unsubscribe();
+    }
+    onLine(line) {
+        const outer = parseIncomingRoute(line, this.host, this.ownerId);
+        if (!outer)
+            return;
+        const payload = decodeRoutePayload(outer);
+        if (!payload)
+            return;
+        try {
+            const frame = decodeClientFrameV2(payload);
+            // Pair requests have one owner in installOwnerRouter. Letting an active
+            // session binding process retries would duplicate or misroute replies.
+            if (frame.type === "pair_request")
+                return;
+            const expectedPurpose = "session";
+            if (outer.purpose !== expectedPurpose)
+                return;
+            this.onMessage(frame);
+        }
+        catch {
+            this.sendUpgradeRequired(outer.ct);
+        }
+    }
+    sendUpgradeRequired(ct) {
+        try {
+            const raw = JSON.parse(Buffer.from(ct, "base64").toString("utf8"));
+            const id = typeof raw.id === "string" ? raw.id : undefined;
+            const channelId = typeof raw.channel_id === "string" ? raw.channel_id : undefined;
+            if (!id)
+                return;
+            this.sendV2({
+                protocol_version: 2,
+                type: "protocol_error",
+                ...(channelId ? { target_channel_id: channelId } : {}),
+                in_reply_to: id,
+                code: "protocol_upgrade_required",
+                message: "Protocol v2 is required",
+            });
+        }
+        catch {
+            // Invalid bytes without a request id are not targetable.
+        }
+    }
+}
+export function parseIncomingRoute(line, host, ownerId) {
+    const route = decodeRoute(parseJson(line));
+    if (!route ||
+        route.device_id !== host.deviceId ||
+        route.endpoint_id !== host.endpointId ||
+        route.runtime_instance_id !== host.runtimeInstanceId ||
+        typeof route.source_owner_id !== "string" ||
+        route.target_owner_id !== undefined) {
+        return null;
+    }
+    if (ownerId !== undefined && route.source_owner_id !== ownerId)
+        return null;
+    return route;
+}
+export function sendRoute(relay, host, ownerId, purpose, ct) {
+    relay.send(JSON.stringify({
+        type: "route",
+        purpose,
+        device_id: host.deviceId,
+        endpoint_id: host.endpointId,
+        runtime_instance_id: host.runtimeInstanceId,
+        target_owner_id: ownerId,
+        ct,
+    }));
+}
+//# sourceMappingURL=peer_channel.js.map

package/dist/transport/peer_channel.js.map

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

package/dist/transport/relay_client.d.ts

@@ -0,0 +1,54 @@
+import { EventEmitter } from "node:events";
+import { type EndpointMetadata as WireEndpointMetadata } from "../vendor/protocol/outer/index.js";
+import type { Ed25519Keypair } from "../pairing/crypto.js";
+export type EndpointMetadata = {
+    [Key in keyof WireEndpointMetadata]: Exclude<WireEndpointMetadata[Key], null>;
+};
+export type HostConnectOptions = {
+    role: "host";
+    endpointId: string;
+    runtimeInstanceId: string;
+    metadata: EndpointMetadata;
+    authorizedOwnerIds: readonly string[];
+};
+export type OwnerConnectOptions = {
+    role: "owner";
+};
+export type ConnectOptions = HostConnectOptions | OwnerConnectOptions;
+export interface RelayClientEvents {
+    message: [line: string];
+    close: [];
+    error: [err: Error];
+}
+/** Authenticated WebSocket client for the endpoint relay. */
+export declare class RelayClient extends EventEmitter {
+    private readonly url;
+    private readonly keypair;
+    private ws;
+    private lastActivityAt;
+    private livenessTimer;
+    private livenessSocket;
+    private pendingConnection;
+    private pendingMessage;
+    constructor(url: string, keypair: Ed25519Keypair);
+    connect(options?: ConnectOptions): Promise<void>;
+    isOpen(): boolean;
+    send(line: string): void;
+    sendControl(frame: object): boolean;
+    close(): void;
+    private finishConnection;
+    private startLiveness;
+    private stopLiveness;
+    private authenticate;
+    private nextMessage;
+    private isPendingConnection;
+    private assertPendingConnection;
+    private resolvePendingConnection;
+    private abortPendingConnection;
+    private clearConnectTimer;
+    private clearPendingConnectionListeners;
+    private cancelPendingMessage;
+    private reportError;
+    private asError;
+    private rawSend;
+}

package/dist/transport/relay_client.js

@@ -0,0 +1,270 @@
+import { EventEmitter } from "node:events";
+import WebSocket from "ws";
+import { PROTOCOL_VERSION } from "../vendor/protocol/outer/index.js";
+import { ed25519Sign } from "../pairing/crypto.js";
+const CONNECT_TIMEOUT_MS = 10_000;
+const AUTH_TIMEOUT_MS = 5_000;
+const LIVENESS_TIMEOUT_MS = 70_000;
+const LIVENESS_CHECK_MS = 20_000;
+/** Authenticated WebSocket client for the endpoint relay. */
+export class RelayClient extends EventEmitter {
+    url;
+    keypair;
+    ws = null;
+    lastActivityAt = 0;
+    livenessTimer = null;
+    livenessSocket = null;
+    pendingConnection = null;
+    pendingMessage = null;
+    constructor(url, keypair) {
+        super();
+        this.url = url;
+        this.keypair = keypair;
+    }
+    connect(options = { role: "owner" }) {
+        this.close();
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url);
+            const onEarlyClose = () => this.abortPendingConnection(ws, new Error("relay connection closed"), false);
+            const onOpen = () => {
+                this.clearConnectTimer(ws);
+                void this.finishConnection(ws, options);
+            };
+            this.ws = ws;
+            const pending = { ws, resolve, reject, onEarlyClose, onOpen, connectTimer: null };
+            this.pendingConnection = pending;
+            pending.connectTimer = setTimeout(() => this.abortPendingConnection(ws, new Error("relay connection timeout"), true), CONNECT_TIMEOUT_MS);
+            ws.on("error", (error) => {
+                if (this.ws !== ws)
+                    return;
+                this.reportError(error);
+                if (this.isPendingConnection(ws))
+                    this.abortPendingConnection(ws, error, true);
+            });
+            ws.once("close", onEarlyClose);
+            ws.once("open", onOpen);
+        });
+    }
+    isOpen() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    send(line) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error("relay: not connected");
+        }
+        this.ws.send(line);
+    }
+    sendControl(frame) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return false;
+        try {
+            this.ws.send(JSON.stringify(frame));
+            return true;
+        }
+        catch (error) {
+            this.reportError(this.asError(error));
+            return false;
+        }
+    }
+    close() {
+        const ws = this.ws;
+        if (!ws)
+            return;
+        this.stopLiveness(ws);
+        if (this.isPendingConnection(ws)) {
+            this.abortPendingConnection(ws, new Error("relay connection closed"), true);
+            return;
+        }
+        this.ws = null;
+        ws.close();
+    }
+    async finishConnection(ws, options) {
+        if (!this.isPendingConnection(ws))
+            return;
+        try {
+            await this.authenticate(ws, options);
+            if (!this.isPendingConnection(ws))
+                return;
+            this.lastActivityAt = Date.now();
+            const pending = this.pendingConnection;
+            if (!pending || pending.ws !== ws)
+                return;
+            ws.removeListener("close", pending.onEarlyClose);
+            ws.on("message", (raw) => {
+                if (this.ws !== ws)
+                    return;
+                this.lastActivityAt = Date.now();
+                const text = Buffer.isBuffer(raw) ? raw.toString() : String(raw);
+                for (const line of text.split("\n")) {
+                    const trimmed = line.trim();
+                    if (trimmed)
+                        this.emit("message", trimmed);
+                }
+            });
+            ws.on("ping", () => { if (this.ws === ws)
+                this.lastActivityAt = Date.now(); });
+            ws.on("pong", () => { if (this.ws === ws)
+                this.lastActivityAt = Date.now(); });
+            ws.on("close", () => {
+                if (this.ws !== ws)
+                    return;
+                this.stopLiveness(ws);
+                this.ws = null;
+                this.emit("close");
+            });
+            this.startLiveness(ws);
+            this.resolvePendingConnection(ws);
+        }
+        catch (error) {
+            this.abortPendingConnection(ws, this.asError(error), true);
+        }
+    }
+    startLiveness(ws) {
+        this.stopLiveness();
+        this.livenessSocket = ws;
+        this.livenessTimer = setInterval(() => {
+            if (Date.now() - this.lastActivityAt > LIVENESS_TIMEOUT_MS) {
+                this.stopLiveness(ws);
+                ws.terminate();
+            }
+        }, LIVENESS_CHECK_MS);
+    }
+    stopLiveness(ws) {
+        if (!this.livenessTimer || (ws && this.livenessSocket !== ws))
+            return;
+        clearInterval(this.livenessTimer);
+        this.livenessTimer = null;
+        this.livenessSocket = null;
+    }
+    async authenticate(ws, options) {
+        this.assertPendingConnection(ws);
+        const pubkey = Buffer.from(this.keypair.publicKey).toString("base64");
+        const hello = options.role === "host"
+            ? {
+                type: "hello",
+                protocol_version: PROTOCOL_VERSION,
+                role: "host",
+                pubkey,
+                endpoint_id: options.endpointId,
+                runtime_instance_id: options.runtimeInstanceId,
+                metadata: options.metadata,
+                authorized_owner_ids: options.authorizedOwnerIds,
+            }
+            : { type: "hello", protocol_version: PROTOCOL_VERSION, role: "owner", pubkey };
+        this.rawSend(ws, JSON.stringify(hello));
+        const challengeRaw = await this.nextMessage(ws);
+        this.assertPendingConnection(ws);
+        let challenge;
+        try {
+            challenge = JSON.parse(challengeRaw);
+        }
+        catch {
+            throw new Error(`relay auth_failed: not JSON: ${challengeRaw}`);
+        }
+        if (challenge.type === "error") {
+            const detail = challenge.code || challenge.message || "unknown";
+            throw new Error(`relay rejected hello: ${detail}`);
+        }
+        if (challenge.type !== "challenge" || !challenge.nonce) {
+            throw new Error(`relay auth_failed: expected challenge, got ${challengeRaw}`);
+        }
+        const nonce = Buffer.from(challenge.nonce, "base64");
+        const auth = {
+            type: "auth",
+            sig: Buffer.from(ed25519Sign(this.keypair.secretKey, nonce)).toString("base64"),
+        };
+        this.assertPendingConnection(ws);
+        this.rawSend(ws, JSON.stringify(auth));
+    }
+    nextMessage(ws) {
+        return new Promise((resolve, reject) => {
+            let timer = null;
+            let settled = false;
+            const cleanup = () => {
+                if (timer)
+                    clearTimeout(timer);
+                ws.removeListener("message", onMessage);
+                ws.removeListener("error", onError);
+                ws.removeListener("close", onClose);
+                if (this.pendingMessage?.ws === ws)
+                    this.pendingMessage = null;
+            };
+            const finish = (settle) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                settle();
+            };
+            const onMessage = (raw) => finish(() => resolve(Buffer.isBuffer(raw) ? raw.toString() : String(raw)));
+            const onError = (error) => finish(() => reject(error));
+            const onClose = () => finish(() => reject(new Error("relay connection closed")));
+            timer = setTimeout(() => finish(() => reject(new Error("relay auth timeout"))), AUTH_TIMEOUT_MS);
+            ws.once("message", onMessage);
+            ws.once("error", onError);
+            ws.once("close", onClose);
+            this.pendingMessage = { ws, cancel: (error) => finish(() => reject(error)) };
+        });
+    }
+    isPendingConnection(ws) {
+        return this.ws === ws && this.pendingConnection?.ws === ws;
+    }
+    assertPendingConnection(ws) {
+        if (!this.isPendingConnection(ws))
+            throw new Error("relay connection closed");
+    }
+    resolvePendingConnection(ws) {
+        const pending = this.pendingConnection;
+        if (!pending || pending.ws !== ws)
+            return;
+        this.pendingConnection = null;
+        this.clearPendingConnectionListeners(pending);
+        pending.resolve();
+    }
+    abortPendingConnection(ws, error, terminate) {
+        const pending = this.pendingConnection;
+        if (!pending || pending.ws !== ws)
+            return;
+        this.pendingConnection = null;
+        this.clearPendingConnectionListeners(pending);
+        this.cancelPendingMessage(ws, error);
+        this.stopLiveness(ws);
+        if (this.ws === ws)
+            this.ws = null;
+        pending.reject(error);
+        if (terminate)
+            ws.terminate();
+    }
+    clearConnectTimer(ws) {
+        const pending = this.pendingConnection;
+        if (!pending || pending.ws !== ws || !pending.connectTimer)
+            return;
+        clearTimeout(pending.connectTimer);
+        pending.connectTimer = null;
+    }
+    clearPendingConnectionListeners(pending) {
+        if (pending.connectTimer)
+            clearTimeout(pending.connectTimer);
+        pending.connectTimer = null;
+        pending.ws.removeListener("close", pending.onEarlyClose);
+        pending.ws.removeListener("open", pending.onOpen);
+    }
+    cancelPendingMessage(ws, error) {
+        const pending = this.pendingMessage;
+        if (!pending || pending.ws !== ws)
+            return;
+        this.pendingMessage = null;
+        pending.cancel(error);
+    }
+    reportError(error) {
+        if (this.listenerCount("error") > 0)
+            this.emit("error", error);
+    }
+    asError(error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    rawSend(ws, data) {
+        ws.send(data);
+    }
+}
+//# sourceMappingURL=relay_client.js.map

package/dist/transport/relay_client.js.map

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

package/dist/vendor/protocol/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const PROTOCOL_VERSION: 2;
+export declare const PAIRING_INVITE_TTL_MS = 300000;
+export declare const PAIR_TTL_MIN_MS = 10000;
+export declare const PAIR_TTL_MAX_MS = 300000;

package/dist/vendor/protocol/constants.js

@@ -0,0 +1,4 @@
+export const PROTOCOL_VERSION = 2;
+export const PAIRING_INVITE_TTL_MS = 300_000;
+export const PAIR_TTL_MIN_MS = 10_000;
+export const PAIR_TTL_MAX_MS = 300_000;

package/dist/vendor/protocol/encoding.d.ts

@@ -0,0 +1,9 @@
+export type Base64Variant = "standard" | "url";
+export declare function encodeBase64(bytes: Uint8Array, variant?: Base64Variant): string;
+export declare function decodeBase64(value: string, variant?: Base64Variant): Uint8Array;
+export declare function encodeUtf8(value: string): Uint8Array;
+export declare function decodeUtf8(bytes: Uint8Array): string;
+export declare function truncateUtf8(value: string, maxBytes: number): string;
+export declare function toWebSocketUrl(value: string | URL): string;
+/** Canonical device and owner identities are standard Ed25519 base64 values. */
+export declare function normalizeDeviceId(value: string): string;

package/dist/vendor/protocol/encoding.js

@@ -0,0 +1,66 @@
+function assertString(value) {
+    if (typeof value !== "string")
+        throw new TypeError("Expected a base64 string");
+}
+function normalizeBase64(value) {
+    const compact = value.replace(/\s+/g, "");
+    if (!compact || !/^[A-Za-z0-9+/_-]*={0,2}$/.test(compact))
+        throw new Error("Invalid base64");
+    const unpadded = compact.replace(/=+$/, "");
+    if (unpadded.length % 4 === 1)
+        throw new Error("Invalid base64 length");
+    return unpadded.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - (unpadded.length % 4)) % 4);
+}
+export function encodeBase64(bytes, variant = "standard") {
+    if (typeof btoa !== "function")
+        throw new Error("Browser base64 encoder is unavailable");
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    const encoded = btoa(binary);
+    return variant === "url" ? encoded.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "") : encoded;
+}
+export function decodeBase64(value, variant) {
+    assertString(value);
+    const normalized = normalizeBase64(value);
+    if (variant === "standard" && /[-_]/.test(value))
+        throw new Error("Expected standard base64");
+    if (variant === "url" && /[+/]/.test(value))
+        throw new Error("Expected URL-safe base64");
+    if (typeof atob !== "function")
+        throw new Error("Browser base64 decoder is unavailable");
+    const binary = atob(normalized);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1)
+        bytes[index] = binary.charCodeAt(index);
+    return bytes;
+}
+export function encodeUtf8(value) {
+    return new TextEncoder().encode(value);
+}
+export function decodeUtf8(bytes) {
+    return new TextDecoder().decode(bytes);
+}
+export function truncateUtf8(value, maxBytes) {
+    const bytes = encodeUtf8(value);
+    if (bytes.length <= maxBytes)
+        return value;
+    let end = Math.max(0, maxBytes);
+    while (end > 0 && (bytes[end] & 0xc0) === 0x80)
+        end -= 1;
+    return decodeUtf8(bytes.slice(0, end));
+}
+export function toWebSocketUrl(value) {
+    const url = new URL(value.toString());
+    if (url.protocol === "http:")
+        url.protocol = "ws:";
+    else if (url.protocol === "https:")
+        url.protocol = "wss:";
+    else if (url.protocol !== "ws:" && url.protocol !== "wss:")
+        throw new Error("Relay URL must use http(s) or ws(s)");
+    return url.toString();
+}
+/** Canonical device and owner identities are standard Ed25519 base64 values. */
+export function normalizeDeviceId(value) {
+    return encodeBase64(decodeBase64(value), "standard");
+}

package/dist/vendor/protocol/outer/codec.d.ts

@@ -0,0 +1,13 @@
+import type { ControlFrame, ControlOutbound, RelayFrame, RouteFrame } from "./types.js";
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function parseJson(value: unknown): unknown;
+export declare function decodeRoute(value: unknown): RouteFrame | undefined;
+export declare function decodeControlFrame(value: unknown): ControlFrame | undefined;
+export declare function decodeRelayFrame(value: unknown): RelayFrame | undefined;
+export declare function encodeRoutePayload(payload: Uint8Array | string): string;
+export declare function decodeRoutePayload(route: RouteFrame): Uint8Array | undefined;
+export declare function encodeControlFrame(frame: ControlOutbound): string;
+export declare function decodeChallenge(value: unknown): {
+    type: "challenge";
+    nonce: string;
+} | undefined;