@zukhruf/single-flight 0.3.15 → 0.3.17

package/dist/connection/local-directory-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-directory-connector.d.ts","sourceRoot":"","sources":["../../src/connection/local-directory-connector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,eAAe;;gBAIjD,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe;IAKnD,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;CAM1E"}

package/dist/connection/local-directory-connector.js

@@ -0,0 +1,23 @@
+import { assertLocalDirectory } from '@zukhruf/fs';
+/**
+ * Refuses a flight directory on a network file system before the first
+ * connection exists. Every connect asks, but a directory that passed once is
+ * remembered, so a failover never fails here and never costs a flight that
+ * this process leads. Runs keep their call order, because the client queues
+ * them before it connects.
+ */
+export class LocalDirectoryConnector {
+    #directory;
+    #connector;
+    constructor(directory, connector) {
+        this.#directory = directory;
+        this.#connector = connector;
+    }
+    async connect(signal) {
+        signal.throwIfAborted();
+        await assertLocalDirectory(this.#directory);
+        signal.throwIfAborted();
+        return this.#connector.connect(signal);
+    }
+}
+//# sourceMappingURL=local-directory-connector.js.map

package/dist/connection/local-directory-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-directory-connector.js","sourceRoot":"","sources":["../../src/connection/local-directory-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IACzB,UAAU,CAAS;IACnB,UAAU,CAAkB;IAErC,YAAY,SAAiB,EAAE,SAA0B;QACvD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/connection/protocol-version-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The single flight's coordinator speaks another protocol version, so this
+ * process cannot use it. Run one version of the protocol per flight directory.
+ */
+export declare class ProtocolVersionError extends Error {
+    /** The protocol this process speaks. */
+    readonly ours: number;
+    /** The protocol the coordinator speaks, or `undefined` when it closed the handshake without saying. */
+    readonly theirs: number | undefined;
+    constructor(ours: number, theirs: number | undefined);
+}
+//# sourceMappingURL=protocol-version-error.d.ts.map

package/dist/connection/protocol-version-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-version-error.d.ts","sourceRoot":"","sources":["../../src/connection/protocol-version-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uGAAuG;IACvG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;CAUrD"}

package/dist/connection/protocol-version-error.js

@@ -0,0 +1,19 @@
+/**
+ * The single flight's coordinator speaks another protocol version, so this
+ * process cannot use it. Run one version of the protocol per flight directory.
+ */
+export class ProtocolVersionError extends Error {
+    /** The protocol this process speaks. */
+    ours;
+    /** The protocol the coordinator speaks, or `undefined` when it closed the handshake without saying. */
+    theirs;
+    constructor(ours, theirs) {
+        super(theirs === undefined
+            ? `The single flight's coordinator closed the handshake without an answer while it still coordinates, so it does not speak protocol version ${ours}.`
+            : `The single flight's coordinator speaks protocol version ${theirs}, and this process speaks version ${ours}. Run one version per flight directory.`);
+        this.name = 'ProtocolVersionError';
+        this.ours = ours;
+        this.theirs = theirs;
+    }
+}
+//# sourceMappingURL=protocol-version-error.js.map

package/dist/connection/protocol-version-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-version-error.js","sourceRoot":"","sources":["../../src/connection/protocol-version-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,wCAAwC;IAC/B,IAAI,CAAS;IACtB,uGAAuG;IAC9F,MAAM,CAAqB;IAEpC,YAAY,IAAY,EAAE,MAA0B;QAClD,KAAK,CACH,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,4IAA4I,IAAI,GAAG;YACrJ,CAAC,CAAC,2DAA2D,MAAM,qCAAqC,IAAI,yCAAyC,CACxJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/connection/socket-connection.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from 'node:events';
+import type { Socket } from 'node:net';
+import type { Connection, ConnectionEvents } from './connection.ts';
+/**
+ * Newline-delimited JSON over a stream socket. A stream has no message
+ * boundaries (writes arrive merged and split), and JSON escapes newlines inside
+ * strings, so one line is always one message. `isIncoming` checks each message
+ * from the peer; a line that is not one closes the connection.
+ */
+export declare class SocketConnection<Outgoing, Incoming> extends EventEmitter<ConnectionEvents<Incoming>> implements Connection<Outgoing, Incoming> {
+    #private;
+    constructor(socket: Socket, isIncoming: (message: unknown) => message is Incoming);
+    send(message: Outgoing): Promise<void>;
+    ref(): void;
+    unref(): void;
+    close(): void;
+}
+//# sourceMappingURL=socket-connection.d.ts.map

package/dist/connection/socket-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-connection.d.ts","sourceRoot":"","sources":["../../src/connection/socket-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAC9C,SAAQ,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAC/C,YAAW,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC;;gBAKvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,IAAI,QAAQ;IAqBvD,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC,GAAG;IAIH,KAAK;IAIL,KAAK;CAGN"}

package/dist/connection/socket-connection.js

@@ -0,0 +1,52 @@
+import { EventEmitter } from 'node:events';
+import { createInterface } from 'node:readline';
+/**
+ * Newline-delimited JSON over a stream socket. A stream has no message
+ * boundaries (writes arrive merged and split), and JSON escapes newlines inside
+ * strings, so one line is always one message. `isIncoming` checks each message
+ * from the peer; a line that is not one closes the connection.
+ */
+export class SocketConnection extends EventEmitter {
+    #socket;
+    constructor(socket, isIncoming) {
+        super();
+        this.#socket = socket;
+        // Every error is followed by `close`, which is where the peer's loss is handled.
+        socket.on('error', () => { });
+        createInterface({ input: socket, crlfDelay: Infinity })
+            .on('line', (line) => {
+            try {
+                const parsed = JSON.parse(line);
+                if (isIncoming(parsed))
+                    this.emit('message', parsed);
+                else
+                    this.close();
+            }
+            catch {
+                this.close();
+            }
+        })
+            // readline re-emits socket errors (e.g. EPIPE when the peer died); `close` reports the loss.
+            .on('error', () => { });
+        socket.once('close', () => this.emit('close'));
+    }
+    send(message) {
+        return new Promise((resolve, reject) => {
+            if (!this.#socket.writable) {
+                reject(new Error('The socket is closed.'));
+                return;
+            }
+            this.#socket.write(`${JSON.stringify(message)}\n`, (error) => error ? reject(error) : resolve());
+        });
+    }
+    ref() {
+        this.#socket.ref();
+    }
+    unref() {
+        this.#socket.unref();
+    }
+    close() {
+        this.#socket.destroy();
+    }
+}
+//# sourceMappingURL=socket-connection.js.map

package/dist/connection/socket-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-connection.js","sourceRoot":"","sources":["../../src/connection/socket-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,OAAO,gBACX,SAAQ,YAAwC;IAGvC,OAAO,CAAS;IAEzB,YACE,MAAc,EACd,UAAqD;QAErD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,iFAAiF;QACjF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7B,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;aACpD,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,UAAU,CAAC,MAAM,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;;oBAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC,CAAC;YACF,6FAA6F;aAC5F,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,OAAiB;QACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAC3C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAC3D,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAClC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,GAAG;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/connection/socket-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A Unix socket file in the directory on macOS and Linux. On Windows, a named
+ * pipe: pipe names are global, so the name comes from the directory, and
+ * Windows paths ignore case, so the path is lowercased first.
+ */
+export declare function socketPathFor(directory: string): string;
+//# sourceMappingURL=socket-path.d.ts.map

package/dist/connection/socket-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.d.ts","sourceRoot":"","sources":["../../src/connection/socket-path.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAevD"}

package/dist/connection/socket-path.js

@@ -0,0 +1,24 @@
+import { createHash } from 'node:crypto';
+import { join, resolve } from 'node:path';
+/** macOS allows 104 bytes including the terminating NUL; Linux allows 108. */
+const SOCKET_PATH_LIMIT = 103;
+/**
+ * A Unix socket file in the directory on macOS and Linux. On Windows, a named
+ * pipe: pipe names are global, so the name comes from the directory, and
+ * Windows paths ignore case, so the path is lowercased first.
+ */
+export function socketPathFor(directory) {
+    if (process.platform === 'win32') {
+        const id = createHash('sha256')
+            .update(resolve(directory).toLowerCase())
+            .digest('hex')
+            .slice(0, 32);
+        return `\\\\.\\pipe\\single-flight-${id}`;
+    }
+    const socketPath = join(directory, 'flight.sock');
+    if (Buffer.byteLength(socketPath) > SOCKET_PATH_LIMIT) {
+        throw new RangeError(`The socket path ${socketPath} exceeds ${SOCKET_PATH_LIMIT} bytes; choose a shorter directory.`);
+    }
+    return socketPath;
+}
+//# sourceMappingURL=socket-path.js.map

package/dist/connection/socket-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.js","sourceRoot":"","sources":["../../src/connection/socket-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;aACxC,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,OAAO,8BAA8B,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,iBAAiB,EAAE,CAAC;QACtD,MAAM,IAAI,UAAU,CAClB,mBAAmB,UAAU,YAAY,iBAAiB,qCAAqC,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/coordinator/flight-coordinator.d.ts

@@ -0,0 +1,33 @@
+import type { FencingToken, TokenSource } from '@zukhruf/fencing';
+import type { Connection } from '../connection/connection.ts';
+import type { FlightResponse, Outcome, RequestEnvelope } from '../protocol/flight-protocol.ts';
+import { Flight } from './flight.ts';
+import type { Party } from './party.ts';
+export interface FlightCoordinatorOptions {
+    /** Mints the lease token of each flight this coordinator starts. */
+    tokens: TokenSource;
+    /**
+     * Milliseconds after start during which no flight starts, so leaders from a
+     * previous coordinator can reassert their flights first. Zero for a
+     * coordinator that never replaces another.
+     */
+    graceWindow: number;
+}
+/**
+ * Coordinates the flights of one term. A run leads a new flight of its key, or
+ * joins the flight of that key in progress, in one step, so two runs never
+ * both lead. The outcome is pushed to every joiner as soon as it lands.
+ */
+export declare class FlightCoordinator {
+    #private;
+    constructor({ tokens, graceWindow }: FlightCoordinatorOptions);
+    serve(connection: Connection<FlightResponse, RequestEnvelope>): void;
+    run(party: Party, key: string): Promise<void>;
+    /** A joiner that lost its connection, back for the flight it joined: it never leads, so its work never runs twice. */
+    rejoin(party: Party, key: string, flight: string): Promise<void>;
+    reassert(party: Party, key: string, token: FencingToken): void;
+    land(flight: Flight, outcome: Outcome): void;
+    /** The leader withdrew or its connection is gone. */
+    interrupt(flight: Flight): void;
+}
+//# sourceMappingURL=flight-coordinator.d.ts.map

package/dist/coordinator/flight-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-coordinator.d.ts","sourceRoot":"","sources":["../../src/coordinator/flight-coordinator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,eAAe,EAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD;;;;GAIG;AACH,qBAAa,iBAAiB;;gBAGhB,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,wBAAwB;IAgB7D,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,IAAI;IAIpE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,sHAAsH;IACtH,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAI9D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI5C,qDAAqD;IACrD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/coordinator/flight-coordinator.js

@@ -0,0 +1,178 @@
+import { Latch } from '@zukhruf/async';
+import { Flight } from "./flight.js";
+import { Session } from "./session.js";
+/**
+ * Coordinates the flights of one term. A run leads a new flight of its key, or
+ * joins the flight of that key in progress, in one step, so two runs never
+ * both lead. The outcome is pushed to every joiner as soon as it lands.
+ */
+export class FlightCoordinator {
+    #phase;
+    constructor({ tokens, graceWindow }) {
+        const flights = new Map();
+        const coordinating = new Coordinating(flights, tokens);
+        if (graceWindow > 0) {
+            const over = new Latch();
+            this.#phase = new GraceWindow(flights, over, coordinating);
+            setTimeout(() => {
+                // Coordinating is current before the latch lets the waiting runs resume.
+                this.#phase = coordinating;
+                over.open();
+            }, graceWindow).unref();
+        }
+        else {
+            this.#phase = coordinating;
+        }
+    }
+    serve(connection) {
+        new Session(this, connection);
+    }
+    run(party, key) {
+        return this.#phase.run(party, key);
+    }
+    /** A joiner that lost its connection, back for the flight it joined: it never leads, so its work never runs twice. */
+    rejoin(party, key, flight) {
+        return this.#phase.rejoin(party, key, flight);
+    }
+    reassert(party, key, token) {
+        this.#phase.reassert(party, key, token);
+    }
+    land(flight, outcome) {
+        this.#phase.land(flight, outcome);
+    }
+    /** The leader withdrew or its connection is gone. */
+    interrupt(flight) {
+        this.#phase.interrupt(flight);
+    }
+}
+/** The only phase that starts flights. A leader that reasserts now is too late. */
+class Coordinating {
+    #flights;
+    #tokens;
+    constructor(flights, tokens) {
+        this.#flights = flights;
+        this.#tokens = tokens;
+    }
+    async run(party, key) {
+        // A token that goes unused is harmless: tokens only need to grow.
+        const token = await this.#tokens.next(key);
+        // The client may have withdrawn the run while the token was minted.
+        if (party.role.kind !== 'waiting')
+            return;
+        const inProgress = this.#flights.get(key);
+        if (inProgress)
+            return inProgress.add(party);
+        const flight = new Flight(key, token, party);
+        this.#flights.set(key, flight);
+        party.lead(flight);
+    }
+    /** A rejoin joins only its own flight; any other answer could be a second run of the work. */
+    async rejoin(party, key, flight) {
+        if (party.role.kind !== 'waiting')
+            return;
+        const inProgress = this.#flights.get(key);
+        if (inProgress?.is(flight))
+            return inProgress.add(party);
+        party.end({ op: 'interrupted', id: party.id });
+    }
+    reassert(party) {
+        party.end({ op: 'rejected', id: party.id });
+    }
+    land(flight, outcome) {
+        this.#forget(flight);
+        flight.land(outcome);
+    }
+    interrupt(flight) {
+        this.#forget(flight);
+        flight.interrupt();
+    }
+    #forget(flight) {
+        if (this.#flights.get(flight.key) === flight) {
+            this.#flights.delete(flight.key);
+        }
+    }
+}
+/** Starts no flight, so leaders from a previous coordinator can reassert theirs first. */
+class GraceWindow {
+    #flights;
+    #over;
+    #next;
+    #endings = new Map();
+    /** Wakes the rejoins that wait for a reassertion of their key. */
+    #wakers = new Map();
+    constructor(flights, over, next) {
+        this.#flights = flights;
+        this.#over = over;
+        this.#next = next;
+    }
+    /** A fresh run leads or joins only once every leader had its chance to reassert. */
+    async run(party, key) {
+        await this.#over.wait();
+        return this.#next.run(party, key);
+    }
+    /**
+     * A rejoin gets its flight's outcome when the flight's leader reasserted it
+     * and it ends during the window, and joins it while it is in progress. Once
+     * the window ends, it is answered as in any other phase.
+     */
+    async rejoin(party, key, flight) {
+        const over = this.#over.wait().then(() => 'over');
+        for (;;) {
+            if (party.role.kind !== 'waiting')
+                return;
+            const inProgress = this.#flights.get(key);
+            if (inProgress?.is(flight))
+                return inProgress.add(party);
+            const ending = this.#endings.get(key);
+            if (ending?.token === flight) {
+                return party.end('landed' in ending
+                    ? { op: 'landed', id: party.id, outcome: ending.landed }
+                    : { op: 'interrupted', id: party.id });
+            }
+            const woken = await Promise.race([over, this.#reassertionOf(key)]);
+            if (woken === 'over')
+                return this.#next.rejoin(party, key, flight);
+        }
+    }
+    /** For two claims on one key, the newer token wins, and the older flight is lost. */
+    reassert(party, key, token) {
+        const claimed = this.#flights.get(key);
+        if (claimed && !token.isNewerThan(claimed.token)) {
+            return party.end({ op: 'rejected', id: party.id });
+        }
+        if (claimed) {
+            claimed.leader.end({ op: 'rejected', id: claimed.leader.id });
+            this.interrupt(claimed);
+        }
+        const flight = new Flight(key, token, party);
+        this.#flights.set(key, flight);
+        party.resume(flight);
+        const wakers = this.#wakers.get(key);
+        this.#wakers.delete(key);
+        for (const wake of wakers ?? [])
+            wake();
+    }
+    land(flight, outcome) {
+        this.#endings.set(flight.key, {
+            token: flight.token.toString(),
+            landed: outcome,
+        });
+        this.#next.land(flight, outcome);
+    }
+    interrupt(flight) {
+        this.#endings.set(flight.key, {
+            token: flight.token.toString(),
+            interrupted: true,
+        });
+        this.#next.interrupt(flight);
+    }
+    #reassertionOf(key) {
+        const { promise, resolve } = Promise.withResolvers();
+        let wakers = this.#wakers.get(key);
+        if (!wakers)
+            this.#wakers.set(key, (wakers = new Set()));
+        wakers.add(() => resolve('reasserted'));
+        return promise;
+    }
+}
+//# sourceMappingURL=flight-coordinator.js.map

package/dist/coordinator/flight-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-coordinator.js","sourceRoot":"","sources":["../../src/coordinator/flight-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AASvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqBvC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAQ;IAEd,YAAY,EAAE,MAAM,EAAE,WAAW,EAA4B;QAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC3D,UAAU,CAAC,GAAG,EAAE;gBACd,yEAAyE;gBACzE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;gBAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAuD;QAC3D,IAAI,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,KAAY,EAAE,GAAW;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,sHAAsH;IACtH,MAAM,CAAC,KAAY,EAAE,GAAW,EAAE,MAAc;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,KAAY,EAAE,GAAW,EAAE,KAAmB;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAgB;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,qDAAqD;IACrD,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,YAAY;IACP,QAAQ,CAAsB;IAC9B,OAAO,CAAc;IAE9B,YAAY,OAA4B,EAAE,MAAmB;QAC3D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAY,EAAE,GAAW;QACjC,kEAAkE;QAClE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,oEAAoE;QACpE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,MAAM,CAAC,KAAY,EAAE,GAAW,EAAE,MAAc;QACpD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC;YAAE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,KAAY;QACnB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAgB;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAKD,0FAA0F;AAC1F,MAAM,WAAW;IACN,QAAQ,CAAsB;IAC9B,KAAK,CAAQ;IACb,KAAK,CAAe;IACpB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,kEAAkE;IACzD,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD,YAAY,OAA4B,EAAE,IAAW,EAAE,IAAkB;QACvE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,GAAG,CAAC,KAAY,EAAE,GAAW;QACjC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,KAAY,EAAE,GAAW,EAAE,MAAc;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAe,CAAC,CAAC;QAC3D,SAAS,CAAC;YACR,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC;gBAAE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,MAAM,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC,GAAG,CACd,QAAQ,IAAI,MAAM;oBAChB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;oBACxD,CAAC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CACxC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,QAAQ,CAAC,KAAY,EAAE,GAAW,EAAE,KAAmB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE;YAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAgB;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,OAAO;SAChB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,GAAW;QACxB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAgB,CAAC;QACnE,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/coordinator/flight-server.d.ts

@@ -0,0 +1,24 @@
+import type { Leadership } from '../election/leadership.ts';
+export interface FlightServerOptions {
+    /** Milliseconds the new term starts no flight, so leaders from the last term can reassert theirs. */
+    graceWindow: number;
+}
+/**
+ * Serves a `FlightCoordinator` on a Unix socket for one term. Lease tokens
+ * carry the term's epoch, so they outrank every token of earlier terms.
+ */
+export declare class FlightServer {
+    #private;
+    private constructor();
+    static start(socketPath: string, leadership: Leadership, { graceWindow }: FlightServerOptions): Promise<FlightServer>;
+    /**
+     * Hands the term over. Ending every connection tells the other processes to
+     * elect a successor and reassert their flights during its grace window;
+     * `close` alone would wait for clients that never disconnect on their own.
+     * Each connection ends only after what was written to it, such as an
+     * outcome for a joiner, is sent. The term ends only after the socket is
+     * gone: in the other order, this close could remove a successor's socket file.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=flight-server.d.ts.map

package/dist/coordinator/flight-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-server.d.ts","sourceRoot":"","sources":["../../src/coordinator/flight-server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,MAAM,WAAW,mBAAmB;IAClC,qGAAqG;IACrG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,YAAY;;IAKvB,OAAO;WAUM,KAAK,CAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,UAAU,EACtB,EAAE,WAAW,EAAE,EAAE,mBAAmB,GACnC,OAAO,CAAC,YAAY,CAAC;IAwCxB;;;;;;;OAOG;IACG,KAAK;CAQZ"}

package/dist/coordinator/flight-server.js

@@ -0,0 +1,74 @@
+import { unlink } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { EpochTokenSource } from '@zukhruf/fencing';
+import { isErrno } from '@zukhruf/fs';
+import { welcome } from "../connection/handshake.js";
+import { SocketConnection } from "../connection/socket-connection.js";
+import { isRequestEnvelope, } from "../protocol/flight-protocol.js";
+import { FlightCoordinator } from "./flight-coordinator.js";
+/**
+ * Serves a `FlightCoordinator` on a Unix socket for one term. Lease tokens
+ * carry the term's epoch, so they outrank every token of earlier terms.
+ */
+export class FlightServer {
+    #server;
+    #connections;
+    #leadership;
+    constructor(server, connections, leadership) {
+        this.#server = server;
+        this.#connections = connections;
+        this.#leadership = leadership;
+    }
+    static async start(socketPath, leadership, { graceWindow }) {
+        // Only the coordinator gets here, so removing a dead coordinator's socket file cannot race another server.
+        // Windows removes a named pipe when its process stops, so there is no file to remove.
+        if (process.platform !== 'win32') {
+            await unlink(socketPath).catch((error) => {
+                if (!isErrno(error, 'ENOENT'))
+                    throw error;
+            });
+        }
+        const coordinator = new FlightCoordinator({
+            tokens: new EpochTokenSource(leadership.epoch),
+            graceWindow,
+        });
+        const connections = new Set();
+        // Serving others never keeps the coordinator alive: when its own work ends, it exits and another process takes over.
+        const server = createServer((socket) => {
+            socket.unref();
+            connections.add(socket);
+            socket.once('close', () => connections.delete(socket));
+            // Only a process that speaks this protocol is served, so this coordinator never reads a message it would misread.
+            void welcome(socket).then((speaksOurs) => {
+                if (!speaksOurs)
+                    return;
+                coordinator.serve(new SocketConnection(socket, isRequestEnvelope));
+            });
+        });
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(socketPath, () => {
+                server.off('error', reject);
+                resolve();
+            });
+        });
+        server.unref();
+        return new FlightServer(server, connections, leadership);
+    }
+    /**
+     * Hands the term over. Ending every connection tells the other processes to
+     * elect a successor and reassert their flights during its grace window;
+     * `close` alone would wait for clients that never disconnect on their own.
+     * Each connection ends only after what was written to it, such as an
+     * outcome for a joiner, is sent. The term ends only after the socket is
+     * gone: in the other order, this close could remove a successor's socket file.
+     */
+    async close() {
+        const closed = new Promise((resolve) => this.#server.close(() => resolve()));
+        for (const socket of this.#connections)
+            socket.destroySoon();
+        await closed;
+        await this.#leadership.resign();
+    }
+}
+//# sourceMappingURL=flight-server.js.map

package/dist/coordinator/flight-server.js.map

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

package/dist/coordinator/flight.d.ts

@@ -0,0 +1,20 @@
+import type { FencingToken } from '@zukhruf/fencing';
+import type { Outcome } from '../protocol/flight-protocol.ts';
+import type { Party } from './party.ts';
+/** A flight in progress: the key, the leader that runs the work, its lease token, and the parties that joined. */
+export declare class Flight {
+    #private;
+    readonly key: string;
+    readonly token: FencingToken;
+    readonly leader: Party;
+    constructor(key: string, token: FencingToken, leader: Party);
+    /** Whether this is the flight with the token `flight`, which a rejoin names. */
+    is(flight: string): boolean;
+    add(joiner: Party): void;
+    remove(joiner: Party): void;
+    /** Pushes the outcome to every joiner, then tells the leader that it was handed over. */
+    land(outcome: Outcome): void;
+    /** Ends without an outcome: every joiner learns that its flight is lost, and none runs the work again. */
+    interrupt(): void;
+}
+//# sourceMappingURL=flight.d.ts.map

package/dist/coordinator/flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight.d.ts","sourceRoot":"","sources":["../../src/coordinator/flight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,kHAAkH;AAClH,qBAAa,MAAM;;IACjB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;gBAGX,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK;IAM3D,gFAAgF;IAChF,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI3B,GAAG,CAAC,MAAM,EAAE,KAAK;IAKjB,MAAM,CAAC,MAAM,EAAE,KAAK;IAIpB,yFAAyF;IACzF,IAAI,CAAC,OAAO,EAAE,OAAO;IAQrB,0GAA0G;IAC1G,SAAS;CAMV"}

package/dist/coordinator/flight.js

@@ -0,0 +1,39 @@
+/** A flight in progress: the key, the leader that runs the work, its lease token, and the parties that joined. */
+export class Flight {
+    key;
+    token;
+    leader;
+    #joiners = new Set();
+    constructor(key, token, leader) {
+        this.key = key;
+        this.token = token;
+        this.leader = leader;
+    }
+    /** Whether this is the flight with the token `flight`, which a rejoin names. */
+    is(flight) {
+        return flight === this.token.toString();
+    }
+    add(joiner) {
+        this.#joiners.add(joiner);
+        joiner.join(this);
+    }
+    remove(joiner) {
+        this.#joiners.delete(joiner);
+    }
+    /** Pushes the outcome to every joiner, then tells the leader that it was handed over. */
+    land(outcome) {
+        for (const joiner of this.#joiners) {
+            joiner.end({ op: 'landed', id: joiner.id, outcome });
+        }
+        this.#joiners.clear();
+        this.leader.end({ op: 'ack', id: this.leader.id });
+    }
+    /** Ends without an outcome: every joiner learns that its flight is lost, and none runs the work again. */
+    interrupt() {
+        for (const joiner of this.#joiners) {
+            joiner.end({ op: 'interrupted', id: joiner.id });
+        }
+        this.#joiners.clear();
+    }
+}
+//# sourceMappingURL=flight.js.map

package/dist/coordinator/flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight.js","sourceRoot":"","sources":["../../src/coordinator/flight.ts"],"names":[],"mappings":"AAKA,kHAAkH;AAClH,MAAM,OAAO,MAAM;IACR,GAAG,CAAS;IACZ,KAAK,CAAe;IACpB,MAAM,CAAQ;IACd,QAAQ,GAAG,IAAI,GAAG,EAAS,CAAC;IAErC,YAAY,GAAW,EAAE,KAAmB,EAAE,MAAa;QACzD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,gFAAgF;IAChF,EAAE,CAAC,MAAc;QACf,OAAO,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,MAAa;QACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,MAAa;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,OAAgB;QACnB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,0GAA0G;IAC1G,SAAS;QACP,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}