@geohar/un-bien 0.7.0

package/dist/session/broker_remote.js

@@ -0,0 +1,581 @@
+import { asTransportErrorBody, envelope, isUuid, parse, serialize, uuidv7, } from "./envelope.js";
+import { canonicalizeEd25519PublicKey, decodeEd25519PublicKey, encodeEd25519PublicKey, publicKeyFingerprint, } from "../mesh/encoding.js";
+import { isBoundedPeerAddresses, isBoundedPeerRoster } from "./peer_limits.js";
+const CACHE_TTL_MS = 5 * 60_000;
+const PEERS_REQUEST_TIMEOUT_MS = 2_000;
+const REANNOUNCE_INTERVAL_MS = 2 * 60_000;
+const BROKER_NAME = "broker";
+const LEGACY_RELAY_ID_RE = /^[0-9a-f]{32}$/;
+function compareAscii(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function validateAlias(alias, field) {
+    if (typeof alias !== "string" || alias.length === 0 || alias.includes(":")) {
+        throw new Error(`mesh: ${field} is not a valid routing alias`);
+    }
+    return alias;
+}
+function validateLegacyPcLabel(label, field) {
+    if (typeof label !== "string" || label.length === 0) {
+        throw new Error(`mesh: ${field} is not a valid legacy PC label`);
+    }
+    return label;
+}
+function buildRoutingState(topology, expectedSelfPubkey) {
+    const selfLabel = validateAlias(topology.self?.pcLabel, "self.pcLabel");
+    const selfLegacyPcLabel = validateLegacyPcLabel(topology.self?.legacyPcLabel, "self.legacyPcLabel");
+    const selfPubkey = canonicalizeEd25519PublicKey(topology.self?.pcPubkey, "self public key");
+    if (expectedSelfPubkey && selfPubkey !== expectedSelfPubkey) {
+        throw new Error("mesh: self public key cannot change");
+    }
+    const normalizedSiblings = topology.siblings
+        .map((sibling, index) => ({
+        pcLabel: validateAlias(sibling?.pcLabel, `siblings[${index}].pcLabel`),
+        legacyPcLabel: validateLegacyPcLabel(sibling?.legacyPcLabel, `siblings[${index}].legacyPcLabel`),
+        pcPubkey: canonicalizeEd25519PublicKey(sibling?.pcPubkey, `siblings[${index}].pcPubkey`),
+    }))
+        .filter((sibling) => sibling.pcPubkey !== selfPubkey)
+        .sort((left, right) => compareAscii(left.pcPubkey, right.pcPubkey));
+    const siblingByLabel = new Map();
+    const siblingByPubkey = new Map();
+    const siblingLegacyLabelByPubkey = new Map();
+    for (const sibling of normalizedSiblings) {
+        if (sibling.pcLabel === selfLabel) {
+            throw new Error("mesh: sibling routing alias conflicts with self");
+        }
+        if (siblingByPubkey.has(sibling.pcPubkey)) {
+            throw new Error("mesh: duplicate sibling public key");
+        }
+        if (siblingByLabel.has(sibling.pcLabel)) {
+            throw new Error("mesh: duplicate sibling routing alias");
+        }
+        siblingByLabel.set(sibling.pcLabel, sibling.pcPubkey);
+        siblingByPubkey.set(sibling.pcPubkey, sibling.pcLabel);
+        siblingLegacyLabelByPubkey.set(sibling.pcPubkey, sibling.legacyPcLabel);
+    }
+    return {
+        self: Object.freeze({
+            pcLabel: selfLabel,
+            pcPubkey: selfPubkey,
+            legacyPcLabel: selfLegacyPcLabel,
+        }),
+        siblingByLabel,
+        siblingByPubkey,
+        siblingLegacyLabelByPubkey,
+    };
+}
+export class BrokerRemote {
+    broker;
+    pi;
+    technicalSelfPubkey;
+    cacheTtlMs;
+    reannounceIntervalMs;
+    log;
+    routing;
+    /** Canonical sibling pubkey → cached local roster. */
+    remotePeers = new Map();
+    /** Canonical sibling pubkeys whose active topology refresh must be retried. */
+    topologyRefreshNeeded = new Set();
+    /** Canonical sibling pubkey → in-flight roster fills. */
+    pendingFills = new Map();
+    onIncoming;
+    reannounceTimer = null;
+    lifecycle = "dormant";
+    constructor(opts) {
+        this.broker = opts.broker;
+        this.pi = opts.pi;
+        this.routing = buildRoutingState(opts.topology);
+        this.technicalSelfPubkey = this.routing.self.pcPubkey;
+        this.cacheTtlMs = opts.cacheTtlMs ?? CACHE_TTL_MS;
+        this.reannounceIntervalMs =
+            opts.reannounceIntervalMs ?? REANNOUNCE_INTERVAL_MS;
+        this.log = opts.log ?? ((message) => console.error(message));
+        this.onIncoming = (env, fromPc) => this.handleIncoming(env, fromPc);
+        if (opts.activateOnConstruct !== false)
+            this.activate();
+    }
+    activate() {
+        if (this.lifecycle === "active")
+            return;
+        if (this.lifecycle === "detached") {
+            throw new Error("mesh: BrokerRemote is detached");
+        }
+        try {
+            this.pi.on("envelope", this.onIncoming);
+            this.broker.setRemoteRouter(this);
+            this._bootstrapWithSiblings();
+            this.topologyRefreshNeeded.clear();
+            if (this.reannounceIntervalMs > 0) {
+                this.reannounceTimer = setInterval(() => {
+                    if (this.lifecycle !== "active" ||
+                        this.routing.siblingByPubkey.size === 0) {
+                        return;
+                    }
+                    try {
+                        this._bootstrapWithSiblings();
+                        this.topologyRefreshNeeded.clear();
+                    }
+                    catch {
+                        this._logMetadataOnly("[broker_remote] event=reannounce_failed reason=send_failure");
+                    }
+                }, this.reannounceIntervalMs);
+                this.reannounceTimer.unref?.();
+            }
+            this.lifecycle = "active";
+        }
+        catch (error) {
+            if (this.reannounceTimer) {
+                clearInterval(this.reannounceTimer);
+                this.reannounceTimer = null;
+            }
+            try {
+                this.pi.off("envelope", this.onIncoming);
+            }
+            catch {
+                // best-effort rollback
+            }
+            try {
+                this.broker.clearRemoteRouter(this);
+            }
+            catch {
+                // preserve the activation error
+            }
+            this.lifecycle = "detached";
+            throw error;
+        }
+    }
+    detach() {
+        if (this.lifecycle === "detached")
+            return;
+        const wasActive = this.lifecycle === "active";
+        this.lifecycle = "detached";
+        if (this.reannounceTimer) {
+            clearInterval(this.reannounceTimer);
+            this.reannounceTimer = null;
+        }
+        this._clearAllPendingFills();
+        this.topologyRefreshNeeded.clear();
+        if (!wasActive)
+            return;
+        this.pi.off("envelope", this.onIncoming);
+        this.broker.clearRemoteRouter(this);
+    }
+    setTopology(next) {
+        if (this.lifecycle === "detached") {
+            throw new Error("mesh: BrokerRemote is detached");
+        }
+        const previous = this.routing;
+        const replacement = buildRoutingState(next, this.technicalSelfPubkey);
+        for (const pcPubkey of [...this.remotePeers.keys()]) {
+            if (!replacement.siblingByPubkey.has(pcPubkey)) {
+                this.remotePeers.delete(pcPubkey);
+            }
+        }
+        for (const pcPubkey of [...this.pendingFills.keys()]) {
+            if (!replacement.siblingByPubkey.has(pcPubkey)) {
+                this._clearPendingFills(pcPubkey);
+            }
+        }
+        for (const pcPubkey of [...this.topologyRefreshNeeded]) {
+            if (!replacement.siblingByPubkey.has(pcPubkey)) {
+                this.topologyRefreshNeeded.delete(pcPubkey);
+            }
+        }
+        this.routing = replacement;
+        if (this.lifecycle !== "active")
+            return;
+        const refreshKeys = new Set(this.topologyRefreshNeeded);
+        for (const [pcPubkey, alias] of replacement.siblingByPubkey) {
+            if (previous.siblingByPubkey.get(pcPubkey) !== alias ||
+                previous.siblingLegacyLabelByPubkey.get(pcPubkey) !==
+                    replacement.siblingLegacyLabelByPubkey.get(pcPubkey)) {
+                refreshKeys.add(pcPubkey);
+            }
+        }
+        if (previous.self.pcLabel !== replacement.self.pcLabel ||
+            previous.self.legacyPcLabel !== replacement.self.legacyPcLabel) {
+            for (const pcPubkey of replacement.siblingByPubkey.keys()) {
+                refreshKeys.add(pcPubkey);
+            }
+        }
+        if (refreshKeys.size === 0)
+            return;
+        let body;
+        try {
+            body = this._localPeersBody();
+        }
+        catch {
+            for (const pcPubkey of refreshKeys) {
+                this.topologyRefreshNeeded.add(pcPubkey);
+            }
+            this._logMetadataOnly("[broker_remote] event=topology_refresh_failed reason=inventory_failure");
+            return;
+        }
+        for (const pcPubkey of refreshKeys) {
+            let failed = false;
+            try {
+                this._sendControlEnvelope(pcPubkey, { type: "peers_request" });
+            }
+            catch {
+                failed = true;
+            }
+            try {
+                this._sendControlEnvelope(pcPubkey, body);
+            }
+            catch {
+                failed = true;
+            }
+            if (failed) {
+                this.topologyRefreshNeeded.add(pcPubkey);
+                this._logMetadataOnly("[broker_remote] event=topology_refresh_failed reason=send_failure");
+            }
+            else {
+                this.topologyRefreshNeeded.delete(pcPubkey);
+            }
+        }
+    }
+    _bootstrapWithSiblings() {
+        const body = this._localPeersBody();
+        for (const pcPubkey of this.routing.siblingByPubkey.keys()) {
+            this._sendControlEnvelope(pcPubkey, { type: "peers_request" });
+            this._sendControlEnvelope(pcPubkey, body);
+        }
+    }
+    _localPeersBody() {
+        const detailed = this.broker.localPeerInfos();
+        if (!isBoundedPeerRoster(detailed)) {
+            throw new Error("mesh: local peer roster exceeds wire limits");
+        }
+        const peers = detailed.map((peer) => peer.address);
+        if (!isBoundedPeerAddresses(peers)) {
+            throw new Error("mesh: local peer addresses exceed wire limits");
+        }
+        return {
+            type: "peers_update",
+            peers,
+            peers_detailed: detailed.map((peer) => ({
+                cwd: peer.cwd,
+                name: peer.name,
+                address: peer.address,
+            })),
+        };
+    }
+    _remoteInfosByPubkey(pcPubkey) {
+        const entry = this.remotePeers.get(pcPubkey);
+        if (!entry)
+            return [];
+        if (Date.now() - entry.ts > this.cacheTtlMs) {
+            this.remotePeers.delete(pcPubkey);
+            return [];
+        }
+        return entry.infos;
+    }
+    getRemotePeers(pcLabel) {
+        const pcPubkey = this.routing.siblingByLabel.get(pcLabel);
+        return pcPubkey
+            ? this._remoteInfosByPubkey(pcPubkey).map((info) => info.address)
+            : [];
+    }
+    getAllRemote() {
+        const entries = [];
+        for (const [pcPubkey, pcLabel] of this.routing.siblingByPubkey) {
+            const peers = this._remoteInfosByPubkey(pcPubkey).map((info) => info.address);
+            if (peers.length > 0)
+                entries.push([pcLabel, peers]);
+        }
+        return Object.fromEntries(entries);
+    }
+    listRemotePeers() {
+        const output = [];
+        for (const [pcPubkey, pcLabel] of this.routing.siblingByPubkey) {
+            for (const info of this._remoteInfosByPubkey(pcPubkey)) {
+                output.push(`${pcLabel}:${info.address}`);
+            }
+        }
+        return output;
+    }
+    listRemotePeerInfos() {
+        const output = [];
+        for (const [pcPubkey, pcLabel] of this.routing.siblingByPubkey) {
+            for (const info of this._remoteInfosByPubkey(pcPubkey)) {
+                output.push({
+                    pc: pcLabel,
+                    cwd: info.cwd,
+                    name: info.name,
+                    address: `${pcLabel}:${info.address}`,
+                });
+            }
+        }
+        return output;
+    }
+    onLocalPeersChanged(_peers) {
+        if (this.lifecycle !== "active" ||
+            this.routing.siblingByPubkey.size === 0) {
+            return;
+        }
+        let body;
+        try {
+            body = this._localPeersBody();
+        }
+        catch {
+            this._logMetadataOnly("[broker_remote] event=local_roster_dropped reason=wire_limits");
+            return;
+        }
+        for (const pcPubkey of this.routing.siblingByPubkey.keys()) {
+            this._sendControlEnvelope(pcPubkey, body);
+        }
+    }
+    tryRouteOutbound(env) {
+        if (this.lifecycle !== "active" || typeof env.to !== "string") {
+            return false;
+        }
+        const parsed = parseAddress(env.to);
+        if (!parsed)
+            return false;
+        const siblingKey = this.routing.siblingByLabel.get(parsed.pcLabel);
+        if (siblingKey)
+            return this._routeToCanonicalSibling(siblingKey, env);
+        return false;
+    }
+    _routeToCanonicalSibling(siblingKey, env) {
+        const destination = parseAddress(env.to);
+        const legacyDestinationLabel = this.routing.siblingLegacyLabelByPubkey.get(siblingKey);
+        if (!destination || !legacyDestinationLabel)
+            return false;
+        const rewritten = {
+            ...env,
+            from: `${this.routing.self.legacyPcLabel}:${env.from}`,
+            to: `${legacyDestinationLabel}:${destination.peerName}`,
+        };
+        this.pi.sendEnvelopeToPi(siblingKey, rewritten);
+        if (!this.remotePeers.has(siblingKey)) {
+            this._sendControlEnvelope(siblingKey, { type: "peers_request" });
+            void this._awaitPeersFill(siblingKey, PEERS_REQUEST_TIMEOUT_MS);
+        }
+        return true;
+    }
+    handleIncoming(env, fromPc) {
+        if (this.lifecycle !== "active")
+            return;
+        if (fromPc === "_relay") {
+            this._propagateTransportError(env);
+            return;
+        }
+        let canonicalFromPc;
+        let fromPcBytes;
+        try {
+            fromPcBytes = decodeEd25519PublicKey(fromPc, "from_pc");
+            canonicalFromPc = encodeEd25519PublicKey(fromPcBytes);
+        }
+        catch {
+            this._dropMetadataOnly("invalid_from_pc");
+            return;
+        }
+        const localAlias = this.routing.siblingByPubkey.get(canonicalFromPc);
+        if (!localAlias) {
+            this._dropMetadataOnly("unknown_from_pc", publicKeyFingerprint(fromPcBytes));
+            return;
+        }
+        if (typeof env.to !== "string") {
+            this._dropMetadataOnly("invalid_to");
+            return;
+        }
+        const senderLegacyLabel = this.routing.siblingLegacyLabelByPubkey.get(canonicalFromPc);
+        const senderLocalAddress = stripKnownPcPrefix(env.from, senderLegacyLabel);
+        const targetLocalAddress = stripKnownPcPrefix(env.to, this.routing.self.legacyPcLabel);
+        if (!senderLocalAddress || !targetLocalAddress) {
+            this._dropMetadataOnly("invalid_cross_pc_address");
+            return;
+        }
+        let normalized;
+        try {
+            // Cross-PC frames bypass the UDS parser. Round-trip their rewritten
+            // envelope before inspecting a body or mutating control/cache state.
+            normalized = parse(serialize({
+                ...env,
+                from: `${localAlias}:${senderLocalAddress}`,
+                to: targetLocalAddress,
+            }));
+        }
+        catch {
+            this._dropMetadataOnly("invalid_envelope");
+            return;
+        }
+        if (typeof normalized.to !== "string") {
+            this._dropMetadataOnly("invalid_envelope");
+            return;
+        }
+        const body = normalized.body;
+        const bodyType = body && typeof body === "object" ? body.type : undefined;
+        const isControlEndpoint = senderLocalAddress === "_broker_remote" &&
+            targetLocalAddress === "_broker_remote";
+        if (isControlEndpoint && bodyType === "peers_update") {
+            const infos = _parsePeersUpdate(body);
+            if (!infos) {
+                this._dropMetadataOnly("invalid_peers_update");
+                return;
+            }
+            this._setRemoteCache(canonicalFromPc, infos);
+            return;
+        }
+        if (isControlEndpoint && bodyType === "peers_request") {
+            try {
+                this._sendControlEnvelope(canonicalFromPc, this._localPeersBody());
+            }
+            catch {
+                this._logMetadataOnly("[broker_remote] event=control_reply_failed reason=inventory_failure");
+            }
+            return;
+        }
+        const status = this.broker.injectFromRemote(normalized);
+        if (bodyType === "ack")
+            return;
+        const ackBody = {
+            type: "ack",
+            status,
+            target: normalized.to,
+        };
+        const ackEnv = {
+            from: `${this.routing.self.legacyPcLabel}:${BROKER_NAME}`,
+            to: env.from,
+            id: uuidv7(),
+            re: normalized.id,
+            body: ackBody,
+        };
+        this.pi.sendEnvelopeToPi(canonicalFromPc, ackEnv);
+    }
+    _setRemoteCache(pcPubkey, infos) {
+        this.remotePeers.set(pcPubkey, {
+            infos,
+            pcPubkey,
+            ts: Date.now(),
+        });
+        this._clearPendingFills(pcPubkey);
+    }
+    _awaitPeersFill(pcPubkey, timeoutMs) {
+        return new Promise((resolve) => {
+            const slot = {
+                resolve,
+                timer: setTimeout(() => {
+                    const pending = this.pendingFills.get(pcPubkey);
+                    pending?.delete(slot);
+                    if (pending?.size === 0)
+                        this.pendingFills.delete(pcPubkey);
+                    resolve();
+                }, timeoutMs),
+            };
+            const pending = this.pendingFills.get(pcPubkey) ?? new Set();
+            pending.add(slot);
+            this.pendingFills.set(pcPubkey, pending);
+        });
+    }
+    _clearPendingFills(pcPubkey) {
+        const pending = this.pendingFills.get(pcPubkey);
+        if (!pending)
+            return;
+        for (const slot of pending) {
+            clearTimeout(slot.timer);
+            slot.resolve();
+        }
+        this.pendingFills.delete(pcPubkey);
+    }
+    _clearAllPendingFills() {
+        for (const pcPubkey of [...this.pendingFills.keys()]) {
+            this._clearPendingFills(pcPubkey);
+        }
+    }
+    _propagateTransportError(env) {
+        const body = asTransportErrorBody(env.body);
+        const target = typeof env.to === "string"
+            ? stripKnownPcPrefix(env.to, this.routing.self.legacyPcLabel)
+            : null;
+        // Relay-first compatibility: only the authenticated Relay sentinel may
+        // carry its former lowercase 32-hex id shape. Normalize it locally before
+        // it reaches Broker's normal strict envelope boundary.
+        const normalizedId = LEGACY_RELAY_ID_RE.test(env.id)
+            ? `${env.id.slice(0, 8)}-${env.id.slice(8, 12)}-${env.id.slice(12, 16)}-${env.id.slice(16, 20)}-${env.id.slice(20)}`
+            : isUuid(env.id)
+                ? env.id
+                : null;
+        if (env.from !== "_relay" ||
+            !normalizedId ||
+            !isUuid(env.re) ||
+            !target ||
+            target === "broadcast" ||
+            !body) {
+            this._dropMetadataOnly("invalid_relay_error");
+            return;
+        }
+        this.broker.injectFromRemote({
+            ...env,
+            id: normalizedId,
+            from: BROKER_NAME,
+            to: target,
+            body,
+        });
+    }
+    _sendControlEnvelope(toPc, body) {
+        const env = envelope(`${this.routing.self.legacyPcLabel}:_broker_remote`, `${this._legacyLabelForPubkey(toPc) ?? "?"}:_broker_remote`, body, null);
+        this.pi.sendEnvelopeToPi(toPc, env);
+    }
+    _legacyLabelForPubkey(pcPubkey) {
+        return this.routing.siblingLegacyLabelByPubkey.get(pcPubkey);
+    }
+    _dropMetadataOnly(reason, fingerprint) {
+        this._logMetadataOnly(`[broker_remote] event=drop reason=${reason}` +
+            (fingerprint ? ` fingerprint=${fingerprint}` : ""));
+    }
+    _logMetadataOnly(message) {
+        try {
+            this.log(message);
+        }
+        catch {
+            // Diagnostics are best-effort and must not break routing or timers.
+        }
+    }
+}
+export function parseAddress(to) {
+    const separator = to.indexOf(":");
+    if (separator <= 0 || separator === to.length - 1)
+        return null;
+    return {
+        pcLabel: to.slice(0, separator),
+        peerName: to.slice(separator + 1),
+    };
+}
+function stripKnownPcPrefix(value, legacyPcLabel) {
+    if (typeof value !== "string")
+        return null;
+    const exactPrefix = legacyPcLabel === undefined ? undefined : `${legacyPcLabel}:`;
+    if (exactPrefix && value.startsWith(exactPrefix)) {
+        const remainder = value.slice(exactPrefix.length);
+        return remainder.length > 0 ? remainder : null;
+    }
+    // Legacy labels are display-only after Relay authentication. Preserve the
+    // old first-colon behavior for a divergent receiver view rather than using
+    // text as an additional authorization gate.
+    return stripRequiredPcPrefix(value);
+}
+function stripRequiredPcPrefix(value) {
+    const separator = value.indexOf(":");
+    if (separator <= 0 || separator === value.length - 1)
+        return null;
+    return value.slice(separator + 1);
+}
+function _parsePeersUpdate(body) {
+    const peers = body.peers;
+    if (!Array.isArray(peers) || !isBoundedPeerAddresses(peers))
+        return null;
+    const detailed = body.peers_detailed;
+    if (Array.isArray(detailed)) {
+        if (!isBoundedPeerRoster(detailed))
+            return null;
+        return detailed.map((entry) => ({
+            cwd: entry.cwd,
+            name: entry.name,
+            address: entry.address,
+        }));
+    }
+    return peers.map((address) => ({ cwd: "", name: address, address }));
+}
+//# sourceMappingURL=broker_remote.js.map

package/dist/session/broker_remote.js.map

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

package/dist/session/cwd_lock.d.ts

@@ -0,0 +1,33 @@
+export interface AcquiredLock {
+    ok: true;
+    /** Manual release. Optional — process exit cleans up too. */
+    release(): void;
+}
+export interface RefusedLock {
+    ok: false;
+    /** Where the live lock socket lives, in case the caller wants to log it. */
+    lockPath: string;
+}
+export type CwdLockResult = AcquiredLock | RefusedLock;
+/**
+ * Local-IPC address of the lock for a given (cwd, name). Pure helper (no IO).
+ * POSIX → a `.sock` file under `locksDir()`; Windows → a per-user named pipe.
+ */
+export declare function lockPathFor(cwd: string, name?: string): string;
+/** Back-compat alias: the cwd-only lock path (no name component). */
+export declare function lockPathForCwd(cwd: string): string;
+/**
+ * Attempts to acquire the cwd lock. Resolves with either:
+ *   - `{ ok: true, release }` when we own it (server bound + retained).
+ *   - `{ ok: false, lockPath }` when a live Pi already holds the lock.
+ *
+ * Self-healing path: if the prior holder crashed, the leftover socket file
+ * fails `tryConnect` (ECONNREFUSED). We unlink it and retry the bind — the
+ * second attempt then succeeds.
+ *
+ * The server holds no actual listener logic; its only job is to keep the
+ * UDS endpoint pinned by the OS. No incoming connection ever does anything
+ * useful — the next-Pi-attempt's `tryConnect` succeeding is the entire
+ * signal we care about.
+ */
+export declare function acquireCwdLock(cwd: string, name?: string): Promise<CwdLockResult>;