agent-comms 8.3.1 → 8.4.0

package/dist/test/coordinator-claim-sessions.integration.test.js

@@ -0,0 +1,276 @@
+/**
+ * Which sessions a store accepts coordinator claims from, and announces its own over (agent-comms#341), against real sockets. A claim is a bid for this machine's coordinator duties, so it may only come from a trusted session to a peer on this machine: never from a session that may cross machines (an addListener listener, a connectToRemote dial, a data dial at an address other than a loopback one), and never from a session on the well-known port before it has introduced itself. A hand-built peer on the far end of each session sends a claim at a term above the store's own, so an accepted claim would visibly replace the store's; a manage-request sent after the claim over the same session, and answered, proves the store has read the claim before the test looks at its state.
+ */
+import * as os from "node:os";
+import { test, expect } from "vitest";
+import { createTlsTransport } from "wire-mesh-core/adapters/tls-transport";
+import { acceptMeshSession, } from "wire-mesh-core/domain/mesh-session";
+import { deviceIdFromHex, deviceIdToHex, } from "wire-mesh-core/domain/device-id";
+import { generateIdentity } from "../core/identity.js";
+import { listenerPort } from "../core/listener-registry.js";
+import { MeshStore } from "../core/mesh-store.js";
+import { DOMAIN, FRAME_SCOPE, buildCommand, } from "../core/wire-mesh-transport.js";
+import { toIdentityPort } from "../core/wire-mesh-identity.js";
+import { TeardownStack, freeLocalPort } from "./hub-helpers.js";
+import { wireTestTransport } from "./test-transport.js";
+/** Above the term 0 a lone store claims at, so accepting this claim would supersede the store's own. */
+const ROGUE_TERM = 7;
+function rawPeer() {
+    const identity = generateIdentity();
+    return {
+        deviceHex: deviceIdToHex(Uint8Array.from(identity.deviceId)),
+        identity,
+        transport: createTlsTransport({
+            certificatePem: identity.certificate,
+            privateKeyPem: identity.privateKey,
+        }),
+    };
+}
+async function openSession(peer, connection, teardown) {
+    const session = await acceptMeshSession(connection, await toIdentityPort(peer.identity), [DOMAIN]);
+    teardown.push(async () => {
+        await session.close();
+    });
+    return session;
+}
+async function dialAsRawPeer(peer, port, teardown) {
+    const connection = await peer.transport.connect(`127.0.0.1:${String(port)}`);
+    return openSession(peer, connection, teardown);
+}
+/** A lone store on its own well-known port, holding the role at term 0 as it claims when nothing else could reach it. */
+async function startLoneHolder(teardown) {
+    const store = new MeshStore({ coordinatorPort: await freeLocalPort() });
+    await wireTestTransport(store);
+    teardown.push(async () => {
+        await store.shutdown();
+    });
+    await store.init();
+    expect(store.coordinatorClaim).toEqual({ term: 0, holder: store.peerId });
+    return store;
+}
+function rogueClaim(holderHex) {
+    return {
+        type: "coordinator",
+        term: ROGUE_TERM,
+        coordinator: deviceIdFromHex(holderHex),
+    };
+}
+/** Sends a request the store answers once it has read everything sent before it on this session. */
+async function roundTrip(session) {
+    const outcome = await session.sendManageRequest(buildCommand({ method: "peer_list", peers: [] }), FRAME_SCOPE);
+    expect(outcome.result).toBe("ok");
+}
+async function introduce(session, peer) {
+    // Nothing listens on this port, so the store's dial back at the raw peer's data server fails, which none of these tests depend on.
+    const dataPort = await freeLocalPort();
+    const outcome = await session.sendManageRequest(buildCommand({ method: "introduce", peerId: peer.deviceHex, dataPort }), FRAME_SCOPE);
+    expect(outcome.result).toBe("ok");
+}
+async function firstCoordinatorFrame(session) {
+    for await (const frame of session.coordinatorFrames)
+        return frame;
+    throw new Error("the session ended before any coordinator-frame arrived");
+}
+test("a claim from a peer introduced on the well-known port is accepted", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const session = await dialAsRawPeer(peer, store.coordinatorPort, teardown);
+        await introduce(session, peer);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({
+            term: ROGUE_TERM,
+            holder: peer.deviceHex,
+        });
+        expect(store.holdsCoordinatorRole).toBe(false);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("a claim sent on the well-known port before introduce is dropped, and the peer is told the incumbent once it introduces itself", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const session = await dialAsRawPeer(peer, store.coordinatorPort, teardown);
+        const announced = firstCoordinatorFrame(session);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await introduce(session, peer);
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({ term: 0, holder: store.peerId });
+        expect(store.holdsCoordinatorRole).toBe(true);
+        expect(await announced).toEqual({
+            type: "coordinator",
+            term: 0,
+            coordinator: deviceIdFromHex(store.peerId),
+        });
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("a claim from a peer introduced on an addListener listener is dropped, since that listener may be reached from another machine", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const listenerId = await store.addListener("127.0.0.1", 0, "full");
+        const listener = store
+            .listListeners()
+            .find((entry) => entry.id === listenerId);
+        if (listener === undefined)
+            throw new Error("expected the added listener");
+        const peer = rawPeer();
+        const session = await dialAsRawPeer(peer, listener.port, teardown);
+        await introduce(session, peer);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({ term: 0, holder: store.peerId });
+        expect(store.holdsCoordinatorRole).toBe(true);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("a claim from the far end of a connectToRemote dial is dropped, since that dial may reach another machine", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const accepted = new Promise((resolve, reject) => {
+            void peer.transport
+                .listen("127.0.0.1:0", (connection) => {
+                openSession(peer, connection, teardown).then(resolve, reject);
+            })
+                .then(async (listener) => {
+                teardown.push(async () => {
+                    await listener.close();
+                });
+                await store.connectToRemote("127.0.0.1", listenerPort(listener));
+            })
+                .catch(reject);
+        });
+        const session = await accepted;
+        for await (const request of session.incomingManageRequests) {
+            // The dial's connect_request, answered as an approving operator would.
+            await request.respond({ result: "ok" });
+            break;
+        }
+        // Answered only once the store is reading this session, so the claim below cannot arrive before the store has decided whether to enrol it.
+        await roundTrip(session);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({ term: 0, holder: store.peerId });
+        expect(store.holdsCoordinatorRole).toBe(true);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("a store that dials a peer's data server tells it the incumbent, not only the side that accepted", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const accepted = new Promise((resolve, reject) => {
+            void peer.transport
+                .listen("127.0.0.1:0", (connection) => {
+                openSession(peer, connection, teardown).then(resolve, reject);
+            })
+                .then((listener) => {
+                teardown.push(async () => {
+                    await listener.close();
+                });
+                store.events.onPeerList([
+                    {
+                        id: peer.deviceHex,
+                        port: listenerPort(listener),
+                        startedAt: new Date().toISOString(),
+                    },
+                ]);
+            })
+                .catch(reject);
+        });
+        const session = await accepted;
+        expect(await firstCoordinatorFrame(session)).toEqual({
+            type: "coordinator",
+            term: 0,
+            coordinator: deviceIdFromHex(store.peerId),
+        });
+    }
+    finally {
+        await teardown.run();
+    }
+});
+/** An address of this machine's own that is not a loopback one, so a dial at it reaches a listener here while naming an address another machine on the LAN could equally hold. */
+function nonLoopbackAddress() {
+    const address = Object.values(os.networkInterfaces())
+        .flat()
+        .find((entry) => entry?.family === "IPv4" && !entry.internal);
+    if (address === undefined) {
+        throw new Error("this test needs a non-loopback IPv4 interface to dial a listener through");
+    }
+    return address.address;
+}
+/** Has the store dial a raw peer's listener at the given host through the ordinary peer-list path (the one first contact feeds discovered peers into), returning the raw peer's end of the session once the store is reading it. */
+async function dialedByStore(store, peer, host, teardown) {
+    const session = await new Promise((resolve, reject) => {
+        void peer.transport
+            .listen("0.0.0.0:0", (connection) => {
+            openSession(peer, connection, teardown).then(resolve, reject);
+        })
+            .then((listener) => {
+            teardown.push(async () => {
+                await listener.close();
+            });
+            store.events.onPeerList([
+                {
+                    id: peer.deviceHex,
+                    host,
+                    port: listenerPort(listener),
+                    startedAt: new Date().toISOString(),
+                },
+            ]);
+        })
+            .catch(reject);
+    });
+    // Answered only once the store is reading this session, so the claim the caller sends next cannot arrive before the store has decided whether to enrol it.
+    await roundTrip(session);
+    return session;
+}
+test("a claim over a data dial at a non-loopback address is dropped, since that address may belong to another machine on the LAN", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const session = await dialedByStore(store, peer, nonLoopbackAddress(), teardown);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({ term: 0, holder: store.peerId });
+        expect(store.holdsCoordinatorRole).toBe(true);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("a claim over a data dial at a loopback address is accepted", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const store = await startLoneHolder(teardown);
+        const peer = rawPeer();
+        const session = await dialedByStore(store, peer, "127.0.0.1", teardown);
+        await session.sendCoordinatorClaim(rogueClaim(peer.deviceHex));
+        await roundTrip(session);
+        expect(store.coordinatorClaim).toEqual({
+            term: ROGUE_TERM,
+            holder: peer.deviceHex,
+        });
+        expect(store.holdsCoordinatorRole).toBe(false);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+//# sourceMappingURL=coordinator-claim-sessions.integration.test.js.map

package/dist/test/coordinator-claim-sessions.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-claim-sessions.integration.test.js","sourceRoot":"","sources":["../../src/test/coordinator-claim-sessions.integration.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EACL,iBAAiB,GAElB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,MAAM,EACN,WAAW,EACX,YAAY,GACb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wGAAwG;AACxG,MAAM,UAAU,GAAG,CAAC,CAAC;AAQrB,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,OAAO;QACL,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5D,QAAQ;QACR,SAAS,EAAE,kBAAkB,CAAC;YAC5B,cAAc,EAAE,QAAQ,CAAC,WAAW;YACpC,aAAa,EAAE,QAAQ,CAAC,UAAU;SACnC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAuB,EACvB,UAAgC,EAChC,QAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,UAAU,EACV,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EACnC,CAAC,MAAM,CAAC,CACT,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,IAAuB,EACvB,IAAY,EACZ,QAAuB;IAEvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,OAAO,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,yHAAyH;AACzH,KAAK,UAAU,eAAe,CAAC,QAAuB;IACpD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,eAAe,EAAE,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,eAAe,CAAC,SAAS,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,KAAK,UAAU,SAAS,CAAC,OAA4B;IACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAChD,WAAW,CACZ,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,OAA4B,EAC5B,IAAuB;IAEvB,mIAAmI;IACnI,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,EACvE,WAAW,CACZ,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAA4B;IAE5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;AAC5E,CAAC;AAED,IAAI,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;IACnF,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAE3E,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC;YACrC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,SAAS;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+HAA+H,EAAE,KAAK,IAAI,EAAE;IAC/I,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEjD,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,CAAC;YAC9B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+HAA+H,EAAE,KAAK,IAAI,EAAE;IAC/I,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,KAAK;aACnB,aAAa,EAAE;aACf,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEnE,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0GAA0G,EAAE,KAAK,IAAI,EAAE;IAC1H,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpE,KAAK,IAAI,CAAC,SAAS;iBAChB,MAAM,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,EAAE;gBACpC,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC,CAAC;iBACD,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACvB,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;oBACvB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACzB,CAAC,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC;iBACD,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC/B,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;YAC3D,uEAAuE;YACvE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,MAAM;QACR,CAAC;QACD,2IAA2I;QAC3I,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iGAAiG,EAAE,KAAK,IAAI,EAAE;IACjH,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpE,KAAK,IAAI,CAAC,SAAS;iBAChB,MAAM,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,EAAE;gBACpC,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;oBACvB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACzB,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;oBACtB;wBACE,EAAE,EAAE,IAAI,CAAC,SAAS;wBAClB,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC;wBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC;iBACF,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAE/B,MAAM,CAAC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,kLAAkL;AAClL,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC;SAClD,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC;AAED,oOAAoO;AACpO,KAAK,UAAU,aAAa,CAC1B,KAAgB,EAChB,IAAuB,EACvB,IAAY,EACZ,QAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzE,KAAK,IAAI,CAAC,SAAS;aAChB,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE;YAClC,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;gBACtB;oBACE,EAAE,EAAE,IAAI,CAAC,SAAS;oBAClB,IAAI;oBACJ,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC;oBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,2JAA2J;IAC3J,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,IAAI,CAAC,4HAA4H,EAAE,KAAK,IAAI,EAAE;IAC5I,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,KAAK,EACL,IAAI,EACJ,kBAAkB,EAAE,EACpB,QAAQ,CACT,CAAC;QAEF,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC5E,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAExE,MAAM,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC;YACrC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,SAAS;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/test/coordinator-election.integration.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The elected coordinator role over real localhost sockets (agent-comms#341): several MeshStore instances, each on its own WireMeshTransport, gossiping coordinator claims over their machine-local sessions. Asserts that exactly one store holds the role and every store agrees which, that a store which never bound the well-known port can hold it and keeps it when lower-id stores arrive, that stores which each claimed alone converge, and that the holder's loss is recovered by a survivor raising the term. Which sessions a claim is accepted from is covered by coordinator-claim-sessions.integration.test.ts; the decision logic is unit-tested against fakes in coordinator-role.unit.test.ts and coordinator-failover.unit.test.ts.
+ */
+export {};
+//# sourceMappingURL=coordinator-election.integration.test.d.ts.map

package/dist/test/coordinator-election.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-election.integration.test.d.ts","sourceRoot":"","sources":["../../src/test/coordinator-election.integration.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/test/coordinator-election.integration.test.js

@@ -0,0 +1,182 @@
+/**
+ * The elected coordinator role over real localhost sockets (agent-comms#341): several MeshStore instances, each on its own WireMeshTransport, gossiping coordinator claims over their machine-local sessions. Asserts that exactly one store holds the role and every store agrees which, that a store which never bound the well-known port can hold it and keeps it when lower-id stores arrive, that stores which each claimed alone converge, and that the holder's loss is recovered by a survivor raising the term. Which sessions a claim is accepted from is covered by coordinator-claim-sessions.integration.test.ts; the decision logic is unit-tested against fakes in coordinator-role.unit.test.ts and coordinator-failover.unit.test.ts.
+ */
+import * as net from "node:net";
+import { test, expect } from "vitest";
+import { deviceIdToHex } from "wire-mesh-core/domain/device-id";
+import { generateIdentity } from "../core/identity.js";
+import { MeshStore } from "../core/mesh-store.js";
+import { TeardownStack, freeLocalPort } from "./hub-helpers.js";
+import { waitFor, wireTestTransportWithHub } from "./test-transport.js";
+/** A claim wait for a store the test starts with nobody else to meet: there is no incumbent it could hear, so waiting any longer would only slow the test. */
+const NOTHING_TO_WAIT_FOR_MS = 0;
+async function startNode(name, options, teardown, identity) {
+    const store = new MeshStore(options);
+    const { transport } = await wireTestTransportWithHub(store, identity === undefined ? undefined : { identityLoader: () => identity });
+    const roleChanges = [];
+    store.onCoordinatorRoleChanged = (isCoordinator) => {
+        roleChanges.push(isCoordinator);
+    };
+    teardown.push(async () => {
+        await store.shutdown().catch(() => undefined);
+    });
+    await store.init();
+    return { name, store, transport, roleChanges };
+}
+function holders(nodes) {
+    return nodes.filter((node) => node.store.holdsCoordinatorRole);
+}
+/** Whether every node accepts the same claim and exactly one of them is the holder that claim names. */
+function settledOnOneHolder(nodes) {
+    const [first, ...rest] = nodes;
+    const claim = first?.store.coordinatorClaim;
+    if (claim === undefined)
+        return false;
+    const agreed = rest.every((node) => node.store.coordinatorClaim?.holder === claim.holder &&
+        node.store.coordinatorClaim.term === claim.term);
+    const held = holders(nodes);
+    return agreed && held.length === 1 && held[0]?.store.peerId === claim.holder;
+}
+/** A TCP server on the given port that drops every connection at once, standing in for a stale process holding the well-known port: nothing on it ever answers as a port holder, and nobody else can bind it. */
+async function occupyPort(port, teardown) {
+    const squatter = net.createServer((socket) => {
+        socket.destroy();
+    });
+    await new Promise((resolve, reject) => {
+        squatter.once("error", reject);
+        squatter.listen(port, "127.0.0.1", () => {
+            resolve();
+        });
+    });
+    teardown.push(async () => {
+        await new Promise((resolve) => {
+            squatter.close(() => {
+                resolve();
+            });
+        });
+    });
+}
+test("exactly one of three stores holds the elected coordinator role, and every store agrees which", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const coordinatorPort = await freeLocalPort();
+        const first = await startNode("first", { coordinatorPort }, teardown);
+        const second = await startNode("second", { coordinatorPort }, teardown);
+        const third = await startNode("third", { coordinatorPort }, teardown);
+        const nodes = [first, second, third];
+        await waitFor(() => settledOnOneHolder(nodes), "every store accepts one claim naming a single holder");
+        // Only the first store was alone when it started, so it is the only one that claimed; the joiners learned its claim instead of contesting it.
+        expect(first.store.holdsCoordinatorRole).toBe(true);
+        expect(first.store.coordinatorClaim).toEqual({
+            term: 0,
+            holder: first.store.peerId,
+        });
+        expect(first.roleChanges).toEqual([true]);
+        expect(second.roleChanges).toEqual([]);
+        expect(third.roleChanges).toEqual([]);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+/** Three fresh identities, in ascending device-id order. */
+function identitiesByDeviceId() {
+    const hex = (identity) => deviceIdToHex(Uint8Array.from(identity.deviceId));
+    const [lowest, middle, highest] = [
+        generateIdentity(),
+        generateIdentity(),
+        generateIdentity(),
+    ].sort((a, b) => (hex(a) < hex(b) ? -1 : 1));
+    if (lowest === undefined || middle === undefined || highest === undefined) {
+        throw new Error("expected three identities");
+    }
+    return [lowest, middle, highest];
+}
+test("an existing mesh behind a squatted port keeps its holder when a lower-id store joins through first contact", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const coordinatorPort = await freeLocalPort();
+        const firstContactPort = await freeLocalPort();
+        await occupyPort(coordinatorPort, teardown);
+        const [lowest, middle, highest] = identitiesByDeviceId();
+        const holder = await startNode("holder", {
+            coordinatorPort,
+            firstContactPort,
+            coordinatorClaimWaitMs: NOTHING_TO_WAIT_FOR_MS,
+        }, teardown, highest);
+        await waitFor(() => holder.store.holdsCoordinatorRole, "the store started alone behind the squatted port claims the role");
+        // The joiners keep the default claim wait, which is what gives the holder's announcement time to reach each of them over first contact before it would claim.
+        const member = await startNode("member", { coordinatorPort, firstContactPort }, teardown, middle);
+        await waitFor(() => settledOnOneHolder([holder, member]), "the second store learned the incumbent through first contact");
+        const newcomer = await startNode("newcomer", { coordinatorPort, firstContactPort }, teardown, lowest);
+        const nodes = [holder, member, newcomer];
+        await waitFor(() => settledOnOneHolder(nodes), "the newcomer learned the incumbent through first contact");
+        expect(newcomer.store.peerId < member.store.peerId).toBe(true);
+        expect(member.store.peerId < holder.store.peerId).toBe(true);
+        for (const node of nodes) {
+            expect(node.transport.isCoordinator).toBe(false);
+            expect(node.store.coordinatorClaim).toEqual({
+                term: 0,
+                holder: holder.store.peerId,
+            });
+        }
+        expect(holder.roleChanges).toEqual([true]);
+        expect(member.roleChanges).toEqual([]);
+        expect(newcomer.roleChanges).toEqual([]);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("two stores that each claimed alone behind a squatted port converge on the lower device-id once first contact joins them", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const coordinatorPort = await freeLocalPort();
+        const firstContactPort = await freeLocalPort();
+        await occupyPort(coordinatorPort, teardown);
+        const options = {
+            coordinatorPort,
+            firstContactPort,
+            coordinatorClaimWaitMs: NOTHING_TO_WAIT_FOR_MS,
+        };
+        const left = await startNode("left", options, teardown);
+        const right = await startNode("right", options, teardown);
+        const nodes = [left, right];
+        await waitFor(() => settledOnOneHolder(nodes), "first contact brought both claims together and one superseded the other");
+        const [holder] = holders(nodes);
+        if (holder === undefined)
+            throw new Error("expected a holder");
+        // Both claimed term 0 while alone, so the equal-term tiebreak by lowest device-id decided it.
+        expect(holder.store.peerId).toBe([left.store.peerId, right.store.peerId].sort()[0]);
+        expect(holder.store.coordinatorClaim?.term).toBe(0);
+        expect(holder.roleChanges).toEqual([true]);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+test("the holder's loss is recovered by a surviving store raising the term, and every survivor agrees on it", async () => {
+    const teardown = new TeardownStack();
+    try {
+        const coordinatorPort = await freeLocalPort();
+        const first = await startNode("first", { coordinatorPort }, teardown);
+        const second = await startNode("second", { coordinatorPort }, teardown);
+        const third = await startNode("third", { coordinatorPort }, teardown);
+        await waitFor(() => settledOnOneHolder([first, second, third]), "the mesh settled on the first store as holder before it is lost");
+        const lostTerm = first.store.coordinatorClaim?.term;
+        expect(first.store.holdsCoordinatorRole).toBe(true);
+        // A crash, not a shutdown: the transport goes down without the store giving anything up, as when the process is killed.
+        await first.transport.shutdown();
+        const survivors = [second, third];
+        await waitFor(() => settledOnOneHolder(survivors), "the survivors settled on one new holder");
+        const claim = second.store.coordinatorClaim;
+        expect(claim?.term).toBe((lostTerm ?? 0) + 1);
+        expect(claim?.holder).toBe([second.store.peerId, third.store.peerId].sort()[0]);
+        const [holder] = holders(survivors);
+        expect(holder?.roleChanges).toEqual([true]);
+    }
+    finally {
+        await teardown.run();
+    }
+});
+//# sourceMappingURL=coordinator-election.integration.test.js.map

package/dist/test/coordinator-election.integration.test.js.map

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

package/dist/test/coordinator-failover.unit.test.d.ts

@@ -1,5 +1,5 @@
 /**
- * PeerLifecycle's crash-race coordinator failover decision (agent-comms#285), exercised against fakes: which disconnects contest the vacated coordinator role, what a peer that loses the bind race does instead, and who retires a departed peer's own agent record. The real-socket counterpart lives in coordinator-failover.integration.test.ts.
+ * PeerLifecycle's failover decisions, exercised against fakes with a real CoordinatorRole: which disconnects contest the vacated well-known port (agent-comms#285), what a peer that loses the bind race does instead, how the elected coordinator role is recovered when its holder departs (agent-comms#341), and who retires a departed peer's own agent record. The real-socket counterparts live in coordinator-failover.integration.test.ts and coordinator-election.integration.test.ts.
  */
 export {};
 //# sourceMappingURL=coordinator-failover.unit.test.d.ts.map