@zukhruf/single-flight 0.3.15 → 0.3.16

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

@@ -0,0 +1,39 @@
+import { EventEmitter } from 'node:events';
+import type { Connector } from './connector.ts';
+export type SupervisorStatus = 'idle' | 'connecting' | 'connected' | 'unavailable' | 'closed';
+export interface SupervisorEvents<Incoming> {
+    /** A connection is open: the first one, or the replacement for a lost one. */
+    connected: [];
+    message: [message: Incoming];
+    /** The open connection is gone and a replacement is on its way. Nothing sent on it will be answered. */
+    disconnected: [];
+    /** The connector can never connect again. */
+    unavailable: [];
+    /** One attempt to connect failed; the next `open` tries again. */
+    failed: [error: unknown];
+}
+/**
+ * Keeps one connection open at a time. It connects on `open`, replaces a
+ * connection that is lost, and stops for good when its connector has no peer
+ * left. It never reads the messages it carries: what a replacement must be
+ * told again is for its listener to decide.
+ */
+export declare class ConnectionSupervisor<Outgoing, Incoming> extends EventEmitter<SupervisorEvents<Incoming>> {
+    #private;
+    constructor(connector: Connector<Outgoing, Incoming>);
+    get status(): SupervisorStatus;
+    /** Starts connecting, unless a connection is open, on its way, or never coming. */
+    open(): void;
+    /** Whether `message` was handed to an open connection. A failed delivery is reported as a loss. */
+    send(message: Outgoing): boolean;
+    /**
+     * Keeps the process alive through the open connection. A replacement starts
+     * with its adapter's default, so a listener that waits applies this again on
+     * `connected`.
+     */
+    ref(): void;
+    unref(): void;
+    /** Closes for good, after any connect still on its way has stopped. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=connection-supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection-supervisor.d.ts","sourceRoot":"","sources":["../../src/connection/connection-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAC1B,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IACxC,8EAA8E;IAC9E,SAAS,EAAE,EAAE,CAAC;IACd,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7B,wGAAwG;IACxG,YAAY,EAAE,EAAE,CAAC;IACjB,6CAA6C;IAC7C,WAAW,EAAE,EAAE,CAAC;IAChB,kEAAkE;IAClE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAE,SAAQ,YAAY,CACxE,gBAAgB,CAAC,QAAQ,CAAC,CAC3B;;gBAGa,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAKpD,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,mFAAmF;IACnF,IAAI;IAIJ,mGAAmG;IACnG,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIhC;;;;OAIG;IACH,GAAG;IAIH,KAAK;IAIL,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/connection/connection-supervisor.js

@@ -0,0 +1,195 @@
+import { EventEmitter } from 'node:events';
+import { Latch } from '@zukhruf/async';
+/**
+ * Keeps one connection open at a time. It connects on `open`, replaces a
+ * connection that is lost, and stops for good when its connector has no peer
+ * left. It never reads the messages it carries: what a replacement must be
+ * told again is for its listener to decide.
+ */
+export class ConnectionSupervisor extends EventEmitter {
+    #supervision;
+    constructor(connector) {
+        super();
+        this.#supervision = new Supervision(connector, this);
+    }
+    get status() {
+        return this.#supervision.state.status;
+    }
+    /** Starts connecting, unless a connection is open, on its way, or never coming. */
+    open() {
+        this.#supervision.state.open();
+    }
+    /** Whether `message` was handed to an open connection. A failed delivery is reported as a loss. */
+    send(message) {
+        return this.#supervision.state.send(message);
+    }
+    /**
+     * Keeps the process alive through the open connection. A replacement starts
+     * with its adapter's default, so a listener that waits applies this again on
+     * `connected`.
+     */
+    ref() {
+        this.#supervision.state.reference(true);
+    }
+    unref() {
+        this.#supervision.state.reference(false);
+    }
+    /** Closes for good, after any connect still on its way has stopped. */
+    close() {
+        return this.#supervision.state.close();
+    }
+}
+/** What the states share: the current state, and how to move to the next. */
+class Supervision {
+    connector;
+    events;
+    state;
+    constructor(connector, events) {
+        this.connector = connector;
+        this.events = events;
+        this.state = new Idle(this);
+    }
+    /** A state that stopped being current must not act on what it started. */
+    isCurrent(state) {
+        return this.state === state;
+    }
+    become(state) {
+        this.state = state;
+        state.enter();
+    }
+}
+class Idle {
+    status = 'idle';
+    #supervision;
+    constructor(supervision) {
+        this.#supervision = supervision;
+    }
+    enter() { }
+    open() {
+        this.#supervision.become(new Connecting(this.#supervision));
+    }
+    send() {
+        return false;
+    }
+    reference() { }
+    async close() {
+        this.#supervision.become(new Closed());
+    }
+}
+class Connecting {
+    status = 'connecting';
+    #supervision;
+    #abort = new AbortController();
+    /** Opens when the connect ends, so `close` can wait for it. */
+    #ended = new Latch();
+    constructor(supervision) {
+        this.#supervision = supervision;
+    }
+    enter() {
+        void this.#connect().finally(() => this.#ended.open());
+    }
+    async #connect() {
+        const supervision = this.#supervision;
+        let connection;
+        try {
+            connection = await Promise.try(() => supervision.connector.connect(this.#abort.signal));
+        }
+        catch (error) {
+            if (!supervision.isCurrent(this))
+                return;
+            supervision.become(new Idle(supervision));
+            supervision.events.emit('failed', error);
+            return;
+        }
+        if (!supervision.isCurrent(this)) {
+            connection?.close();
+            return;
+        }
+        supervision.become(connection
+            ? new Connected(supervision, connection)
+            : new Unavailable(supervision));
+    }
+    open() { }
+    send() {
+        return false;
+    }
+    reference() { }
+    async close() {
+        this.#supervision.become(new Closed());
+        this.#abort.abort();
+        await this.#ended.wait();
+    }
+}
+class Connected {
+    status = 'connected';
+    #supervision;
+    #connection;
+    constructor(supervision, connection) {
+        this.#supervision = supervision;
+        this.#connection = connection;
+    }
+    enter() {
+        const supervision = this.#supervision;
+        this.#connection.on('message', (message) => {
+            if (supervision.isCurrent(this))
+                supervision.events.emit('message', message);
+        });
+        this.#connection.once('close', () => this.#lose());
+        supervision.events.emit('connected');
+    }
+    open() { }
+    /** The connection may report its loss while it sends, so the state is checked after the call. */
+    send(message) {
+        this.#connection.send(message).catch(() => this.#lose());
+        return this.#supervision.isCurrent(this);
+    }
+    reference(referenced) {
+        if (referenced)
+            this.#connection.ref();
+        else
+            this.#connection.unref();
+    }
+    async close() {
+        this.#supervision.become(new Closed());
+        this.#connection.close();
+    }
+    /** A close event and a failed send can both report one loss; only the first counts. */
+    #lose() {
+        const supervision = this.#supervision;
+        if (!supervision.isCurrent(this))
+            return;
+        this.#connection.close();
+        // Leave this state before the listener hears of the loss, so its sends wait for the replacement.
+        supervision.become(new Connecting(supervision));
+        supervision.events.emit('disconnected');
+    }
+}
+class Unavailable {
+    status = 'unavailable';
+    #supervision;
+    constructor(supervision) {
+        this.#supervision = supervision;
+    }
+    enter() {
+        this.#supervision.events.emit('unavailable');
+    }
+    open() { }
+    send() {
+        return false;
+    }
+    reference() { }
+    async close() {
+        this.#supervision.become(new Closed());
+    }
+}
+class Closed {
+    status = 'closed';
+    enter() { }
+    open() { }
+    send() {
+        return false;
+    }
+    reference() { }
+    async close() { }
+}
+//# sourceMappingURL=connection-supervisor.js.map

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

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

package/dist/connection/connection.d.ts

@@ -0,0 +1,21 @@
+import type { EventEmitter } from 'node:events';
+export interface ConnectionEvents<Incoming> {
+    message: [message: Incoming];
+    /** Emitted once, when the peer is gone. */
+    close: [];
+}
+/**
+ * A message channel to one peer. Adapters wrap IPC channels and sockets.
+ * Subscribe in the task that receives the connection: a message that arrives
+ * while nobody listens is not kept.
+ */
+export interface Connection<Outgoing, Incoming> extends EventEmitter<ConnectionEvents<Incoming>> {
+    /** Rejects when the message cannot be delivered because the peer is gone. */
+    send(message: Outgoing): Promise<void>;
+    /** Keeps the process alive while its owner waits for a message. */
+    ref(): void;
+    /** Lets the process exit; messages and closure are still reported while it runs. */
+    unref(): void;
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IACxC,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,EAAE,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAE,SAAQ,YAAY,CAClE,gBAAgB,CAAC,QAAQ,CAAC,CAC3B;IACC,6EAA6E;IAC7E,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,mEAAmE;IACnE,GAAG,IAAI,IAAI,CAAC;IACZ,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/connection/connection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection.js.map

package/dist/connection/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection/connection.ts"],"names":[],"mappings":""}

package/dist/connection/connector.d.ts

@@ -0,0 +1,15 @@
+import type { FlightRequest, FlightResponse } from '../protocol/flight-protocol.ts';
+import type { Connection } from './connection.ts';
+export type FlightConnection = Connection<FlightRequest, FlightResponse>;
+/** Decides how a client reaches its coordinator, and whether it can again after losing it. */
+export interface Connector<Outgoing, Incoming> {
+    /**
+     * Resolves to `undefined` when the coordinator is gone for good and nothing
+     * can replace it.
+     * Rejects when this attempt failed and a later one may succeed. Once
+     * `signal` aborts, rejects with its reason and leaves nothing started.
+     */
+    connect(signal: AbortSignal): Promise<Connection<Outgoing, Incoming> | undefined>;
+}
+export type FlightConnector = Connector<FlightRequest, FlightResponse>;
+//# sourceMappingURL=connector.d.ts.map

package/dist/connection/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/connection/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,MAAM,WAAW,SAAS,CAAC,QAAQ,EAAE,QAAQ;IAC3C;;;;;OAKG;IACH,OAAO,CACL,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC"}

package/dist/connection/connector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connector.js.map

package/dist/connection/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../src/connection/connector.ts"],"names":[],"mappings":""}

package/dist/connection/electing-connector.d.ts

@@ -0,0 +1,23 @@
+import type { LeaderElection } from '../election/leader-election.ts';
+import type { Leadership } from '../election/leadership.ts';
+import type { FlightConnection, FlightConnector } from './connector.ts';
+export interface ElectingConnectorOptions {
+    socketPath: string;
+    /** The connector only campaigns, so it needs only that part of an election. */
+    election: Pick<LeaderElection, 'campaign'>;
+    pollInterval: number;
+    /** Starts serving for a term this process just won. */
+    serve(leadership: Leadership): Promise<void>;
+}
+/**
+ * Reaches the coordinator's socket, and when nobody serves it, campaigns to
+ * become the coordinator. Never gives up: a lost coordinator is always
+ * replaced by a candidate. An aborted connect never starts serving: a term
+ * won after the abort is resigned.
+ */
+export declare class ElectingConnector implements FlightConnector {
+    #private;
+    constructor(options: ElectingConnectorOptions);
+    connect(signal: AbortSignal): Promise<FlightConnection>;
+}
+//# sourceMappingURL=electing-connector.d.ts.map

package/dist/connection/electing-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electing-connector.d.ts","sourceRoot":"","sources":["../../src/connection/electing-connector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWxE,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,eAAe;;gBAG3C,OAAO,EAAE,wBAAwB;IAIvC,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2F9D"}

package/dist/connection/electing-connector.js

@@ -0,0 +1,148 @@
+import { connect } from 'node:net';
+import { setTimeout as delay } from 'node:timers/promises';
+import { untilAborted } from '@zukhruf/async';
+import { isFlightResponse, } from "../protocol/flight-protocol.js";
+import { PROTOCOL_VERSION, greet } from "./handshake.js";
+import { ProtocolVersionError } from "./protocol-version-error.js";
+import { SocketConnection } from "./socket-connection.js";
+/**
+ * How long a coordinator may keep its term while it hangs up on every hello.
+ * One that stops ends its term within moments.
+ */
+const HANDSHAKE_PATIENCE = 1000;
+/**
+ * Reaches the coordinator's socket, and when nobody serves it, campaigns to
+ * become the coordinator. Never gives up: a lost coordinator is always
+ * replaced by a candidate. An aborted connect never starts serving: a term
+ * won after the abort is resigned.
+ */
+export class ElectingConnector {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    async connect(signal) {
+        const { socketPath, pollInterval } = this.#options;
+        for (;;) {
+            const coordinator = await reachUnlessAborted(socketPath, signal);
+            if (coordinator) {
+                const connection = (await this.#follow(coordinator, signal)) ??
+                    (await this.#outlastHangUp(signal));
+                if (connection)
+                    return connection;
+            }
+            const leadership = await this.#campaign(pollInterval, signal);
+            if (leadership) {
+                const own = await this.#coordinate(leadership, signal);
+                if (own)
+                    return own;
+            }
+            else {
+                await delay(pollInterval, undefined, { signal });
+            }
+        }
+    }
+    /**
+     * After a coordinator hung up on the hello: a coordinator that stops frees
+     * its term within moments, so this process coordinates or reaches the
+     * successor soon enough to reassert its flights in the successor's grace
+     * window. A coordinator that keeps its term and hangs up on every hello
+     * fails the connect after HANDSHAKE_PATIENCE. Resolves `undefined` once
+     * nothing listens.
+     */
+    async #outlastHangUp(signal) {
+        const { socketPath, pollInterval } = this.#options;
+        const deadline = performance.now() + HANDSHAKE_PATIENCE;
+        for (;;) {
+            const leadership = await this.#campaign(0, signal);
+            if (leadership)
+                return this.#coordinate(leadership, signal);
+            const again = await reachUnlessAborted(socketPath, signal);
+            if (!again)
+                return undefined;
+            const connection = await this.#follow(again, signal);
+            if (connection)
+                return connection;
+            if (performance.now() >= deadline) {
+                throw new ProtocolVersionError(PROTOCOL_VERSION, undefined);
+            }
+            await delay(pollInterval, undefined, { signal });
+        }
+    }
+    /** Campaigns until `timeout`; a term won after `signal` aborted is resigned. */
+    async #campaign(timeout, signal) {
+        const leadership = await this.#options.election.campaign({ timeout });
+        if (signal.aborted)
+            await leadership?.resign();
+        signal.throwIfAborted();
+        return leadership;
+    }
+    /** Serves the term this process just won, and reaches its own server like any other process. */
+    async #coordinate(leadership, signal) {
+        try {
+            await this.#options.serve(leadership);
+        }
+        catch (error) {
+            // A term that nothing serves would stop every other candidate from coordinating.
+            await leadership.resign();
+            throw error;
+        }
+        const own = await reachUnlessAborted(this.#options.socketPath, signal);
+        if (!own)
+            return undefined;
+        const greeting = await greetUnlessAborted(own, signal);
+        if (greeting.kind === 'welcome')
+            return flightConnection(own);
+        own.destroy();
+        return undefined;
+    }
+    /** Uses the coordinator on `socket` if it speaks this protocol; `undefined` when it hung up on the hello. */
+    async #follow(socket, signal) {
+        const greeting = await greetUnlessAborted(socket, signal);
+        if (greeting.kind === 'welcome')
+            return flightConnection(socket);
+        socket.destroy();
+        if (greeting.kind === 'refused') {
+            throw new ProtocolVersionError(PROTOCOL_VERSION, greeting.version);
+        }
+        return undefined;
+    }
+}
+function flightConnection(socket) {
+    return new SocketConnection(socket, isFlightResponse);
+}
+/** Like `reach`, but a socket reached after `signal` aborted is destroyed, not returned. */
+async function reachUnlessAborted(socketPath, signal) {
+    signal.throwIfAborted();
+    const socket = await reach(socketPath);
+    if (signal.aborted)
+        socket?.destroy();
+    signal.throwIfAborted();
+    return socket;
+}
+/** Resolves `undefined` when nothing listens yet (no file, or a dead coordinator's file). */
+function reach(socketPath) {
+    return new Promise((resolve) => {
+        const socket = connect(socketPath);
+        const fail = () => {
+            socket.destroy();
+            resolve(undefined);
+        };
+        socket.once('error', fail);
+        socket.once('connect', () => {
+            socket.off('error', fail);
+            resolve(socket);
+        });
+    });
+}
+/** Greets the coordinator on `socket`; a client that closes meanwhile gives the socket up. */
+async function greetUnlessAborted(socket, signal) {
+    try {
+        return await untilAborted(greet(socket), signal);
+    }
+    catch (error) {
+        socket.destroy();
+        throw error;
+    }
+}
+//# sourceMappingURL=electing-connector.js.map

package/dist/connection/electing-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electing-connector.js","sourceRoot":"","sources":["../../src/connection/electing-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EAGL,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAiB,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAWhC;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACnB,QAAQ,CAA2B;IAE5C,YAAY,OAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnD,SAAS,CAAC;YACR,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACjE,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,UAAU,GACd,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;oBACzC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtC,IAAI,UAAU;oBAAE,OAAO,UAAU,CAAC;YACpC,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC9D,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACvD,IAAI,GAAG;oBAAE,OAAO,GAAG,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,MAAmB;QAEnB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,kBAAkB,CAAC;QACxD,SAAS,CAAC;YACR,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,UAAU;gBAAE,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,UAAU;gBAAE,OAAO,UAAU,CAAC;YAClC,IAAI,WAAW,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,SAAS,CACb,OAAe,EACf,MAAmB;QAEnB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,UAAU,EAAE,MAAM,EAAE,CAAC;QAC/C,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,WAAW,CACf,UAAsB,EACtB,MAAmB;QAEnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iFAAiF;YACjF,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,6GAA6G;IAC7G,KAAK,CAAC,OAAO,CACX,MAAc,EACd,MAAmB;QAEnB,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,OAAO,IAAI,gBAAgB,CACzB,MAAM,EACN,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,KAAK,UAAU,kBAAkB,CAC/B,UAAkB,EAClB,MAAmB;IAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACtC,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6FAA6F;AAC7F,SAAS,KAAK,CAAC,UAAkB;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,kBAAkB,CAC/B,MAAc,EACd,MAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/connection/handshake.d.ts

@@ -0,0 +1,31 @@
+import type { Socket } from 'node:net';
+/**
+ * The version of the messages a single flight's processes exchange. It changes
+ * only when they change, so processes that run different package versions
+ * with the same protocol still share a directory. The `hello` and the
+ * `refused` answer keep their shape in every version: they are how two
+ * versions find out that they differ.
+ */
+export declare const PROTOCOL_VERSION = 1;
+/** What the coordinator answered to this process's `hello`. */
+export type Greeting = {
+    kind: 'welcome';
+} | {
+    kind: 'refused';
+    version: number;
+}
+/** The coordinator closed the connection without an answer: it stops. */
+ | {
+    kind: 'closed';
+};
+/** Says which protocol this process speaks, and reads the coordinator's answer. */
+export declare function greet(socket: Socket): Promise<Greeting>;
+/**
+ * Reads a new process's `hello`. A process that speaks this protocol is
+ * welcomed. A `hello` of another protocol or version is refused with this
+ * coordinator's version, and the connection ends once that answer is
+ * written. A process that opens with anything else is no single flight, and
+ * its connection ends at once.
+ */
+export declare function welcome(socket: Socket): Promise<boolean>;
+//# sourceMappingURL=handshake.d.ts.map

package/dist/connection/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/connection/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAOvC;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACtC,yEAAyE;GACvE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,mFAAmF;AACnF,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAc7D;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB9D"}

package/dist/connection/handshake.js

@@ -0,0 +1,102 @@
+import { isRecord } from "../shared/is-record.js";
+/** The protocol a single flight's processes speak, named in every hello, so no process of another protocol is ever served. */
+const PROTOCOL = 'single-flight';
+/**
+ * The version of the messages a single flight's processes exchange. It changes
+ * only when they change, so processes that run different package versions
+ * with the same protocol still share a directory. The `hello` and the
+ * `refused` answer keep their shape in every version: they are how two
+ * versions find out that they differ.
+ */
+export const PROTOCOL_VERSION = 1;
+/** Says which protocol this process speaks, and reads the coordinator's answer. */
+export async function greet(socket) {
+    socket.write(`${JSON.stringify({ op: 'hello', protocol: PROTOCOL, version: PROTOCOL_VERSION })}\n`);
+    const answer = parse(await readLine(socket));
+    if (isRecord(answer) && answer.op === 'welcome')
+        return { kind: 'welcome' };
+    if (isRecord(answer) &&
+        answer.op === 'refused' &&
+        typeof answer.version === 'number') {
+        return { kind: 'refused', version: answer.version };
+    }
+    return { kind: 'closed' };
+}
+/**
+ * Reads a new process's `hello`. A process that speaks this protocol is
+ * welcomed. A `hello` of another protocol or version is refused with this
+ * coordinator's version, and the connection ends once that answer is
+ * written. A process that opens with anything else is no single flight, and
+ * its connection ends at once.
+ */
+export async function welcome(socket) {
+    const hello = parse(await readLine(socket));
+    if (!isRecord(hello) || hello.op !== 'hello') {
+        socket.destroy();
+        return false;
+    }
+    if (hello.protocol === PROTOCOL && hello.version === PROTOCOL_VERSION) {
+        socket.write(`${JSON.stringify({ op: 'welcome' })}\n`);
+        return true;
+    }
+    // Destroyed once the answer is written: a paused socket would never see a silent process hang up.
+    socket.end(`${JSON.stringify({ op: 'refused', protocol: PROTOCOL, version: PROTOCOL_VERSION })}\n`, () => socket.destroy());
+    return false;
+}
+function parse(line) {
+    if (line === undefined)
+        return undefined;
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A hello and each answer to it are one short line, so a longer first line is none of them. */
+const FIRST_LINE_LIMIT = 1024;
+/**
+ * Reads exactly one line and puts back whatever arrived after it, so the
+ * reader that takes over the socket next sees every later message. Resolves
+ * `undefined` when the socket closes first, or when the line grows past
+ * FIRST_LINE_LIMIT bytes: a process that never ends its line cannot fill the
+ * memory of this one.
+ */
+function readLine(socket) {
+    const { promise, resolve } = Promise.withResolvers();
+    const chunks = [];
+    let lineBytes = 0;
+    const stop = () => {
+        socket.off('data', onData);
+        socket.off('close', onClose);
+        socket.pause();
+    };
+    const onData = (chunk) => {
+        const end = chunk.indexOf(0x0a);
+        lineBytes += end === -1 ? chunk.length : end;
+        if (lineBytes > FIRST_LINE_LIMIT) {
+            stop();
+            resolve(undefined);
+            return;
+        }
+        if (end === -1) {
+            chunks.push(chunk);
+            return;
+        }
+        stop();
+        const rest = chunk.subarray(end + 1);
+        if (rest.length > 0)
+            socket.unshift(rest);
+        resolve(Buffer.concat([...chunks, chunk.subarray(0, end)]).toString('utf8'));
+    };
+    const onClose = () => {
+        socket.off('data', onData);
+        resolve(undefined);
+    };
+    // Every error is followed by `close`, which reports the lost connection as no answer.
+    socket.on('error', () => { });
+    socket.on('data', onData);
+    socket.once('close', onClose);
+    return promise;
+}
+//# sourceMappingURL=handshake.js.map

package/dist/connection/handshake.js.map

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

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

@@ -0,0 +1,14 @@
+import type { FlightConnection, FlightConnector } from './connector.ts';
+/**
+ * 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 declare class LocalDirectoryConnector implements FlightConnector {
+    #private;
+    constructor(directory: string, connector: FlightConnector);
+    connect(signal: AbortSignal): Promise<FlightConnection | undefined>;
+}
+//# sourceMappingURL=local-directory-connector.d.ts.map