@zukhruf/single-flight 0.3.15 → 0.3.17

package/dist/protocol/flight-protocol.js

@@ -0,0 +1,61 @@
+import { FencingToken } from '@zukhruf/fencing';
+import { isRecord } from "../shared/is-record.js";
+const isToken = (value) => typeof value === 'string' && FencingToken.parse(value) !== null;
+export function isRequestEnvelope(message) {
+    return (isRecord(message) &&
+        typeof message.op === 'string' &&
+        typeof message.id === 'string');
+}
+/** Messages arrive from another process, so their shape is checked before use. */
+export function isFlightRequest(message) {
+    if (!isRecord(message) || typeof message.id !== 'string')
+        return false;
+    switch (message.op) {
+        case 'run':
+            return (typeof message.key === 'string' &&
+                (message.flight === undefined || isToken(message.flight)));
+        case 'land':
+            return isOutcome(message.outcome);
+        case 'cancel':
+            return true;
+        case 'reassert':
+            return typeof message.key === 'string' && isToken(message.token);
+        default:
+            return false;
+    }
+}
+export function isFlightResponse(message) {
+    if (!isRecord(message) || typeof message.id !== 'string')
+        return false;
+    switch (message.op) {
+        case 'lead':
+            return isToken(message.token);
+        case 'joined':
+            return isToken(message.flight);
+        case 'landed':
+            return isOutcome(message.outcome);
+        case 'interrupted':
+        case 'ack':
+        case 'rejected':
+        case 'unsupported':
+            return true;
+        default:
+            return false;
+    }
+}
+function isOutcome(value) {
+    if (!isRecord(value))
+        return false;
+    if ('value' in value)
+        return typeof value.value === 'string';
+    return isFailure(value.failure);
+}
+function isFailure(value) {
+    return (isRecord(value) &&
+        typeof value.name === 'string' &&
+        typeof value.message === 'string' &&
+        (value.code === undefined ||
+            typeof value.code === 'string' ||
+            typeof value.code === 'number'));
+}
+//# sourceMappingURL=flight-protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flight-protocol.js","sourceRoot":"","sources":["../../src/protocol/flight-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoDlD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAmB,EAAE,CAClD,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AAElE,MAAM,UAAU,iBAAiB,CAC/B,OAAgB;IAEhB,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC;QACjB,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvE,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,CACL,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;gBAC/B,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAC1D,CAAC;QACJ,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,UAAU;YACb,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnE;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvE,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,KAAK,aAAa,CAAC;QACnB,KAAK,KAAK,CAAC;QACX,KAAK,UAAU,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,OAAO,IAAI,KAAK;QAAE,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;IAC7D,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YACvB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAClC,CAAC;AACJ,CAAC"}

package/dist/shared/is-record.d.ts

@@ -0,0 +1,3 @@
+/** Narrows a parsed or received value to an object whose fields can be checked one by one. */
+export declare const isRecord: (value: unknown) => value is Readonly<Record<string, unknown>>;
+//# sourceMappingURL=is-record.d.ts.map

package/dist/shared/is-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.d.ts","sourceRoot":"","sources":["../../src/shared/is-record.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,GACnB,OAAO,OAAO,KACb,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACC,CAAC"}

package/dist/shared/is-record.js

@@ -0,0 +1,3 @@
+/** Narrows a parsed or received value to an object whose fields can be checked one by one. */
+export const isRecord = (value) => typeof value === 'object' && value !== null;
+//# sourceMappingURL=is-record.js.map

package/dist/shared/is-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.js","sourceRoot":"","sources":["../../src/shared/is-record.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,KAAc,EAC8B,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC"}

package/dist/shared/sqlite/is-busy.d.ts

@@ -0,0 +1,3 @@
+/** Whether `error` means another connection holds a conflicting lock right now. */
+export declare function isBusy(error: unknown): boolean;
+//# sourceMappingURL=is-busy.d.ts.map

package/dist/shared/sqlite/is-busy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-busy.d.ts","sourceRoot":"","sources":["../../../src/shared/sqlite/is-busy.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ9C"}

package/dist/shared/sqlite/is-busy.js

@@ -0,0 +1,10 @@
+const SQLITE_BUSY = 5;
+/** Whether `error` means another connection holds a conflicting lock right now. */
+export function isBusy(error) {
+    return (error instanceof Error &&
+        'errcode' in error &&
+        typeof error.errcode === 'number' &&
+        // The low byte is the primary result code, covering SQLITE_BUSY_* variants.
+        (error.errcode & 0xff) === SQLITE_BUSY);
+}
+//# sourceMappingURL=is-busy.js.map

package/dist/shared/sqlite/is-busy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-busy.js","sourceRoot":"","sources":["../../../src/shared/sqlite/is-busy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,4EAA4E;QAC5E,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,WAAW,CACvC,CAAC;AACJ,CAAC"}

package/dist/single-flight.d.ts

@@ -1,23 +1,57 @@
+import type { FencedLease } from '@zukhruf/fencing';
+import type { Codec } from './codec.ts';
+export interface SingleFlightOptions<T> {
+    /**
+     * The local folder where the processes that share flights meet. They keep
+     * `flight.lock`, `flight.epoch` and `flight.sock` there, so every process
+     * that names the same folder is in one group, and callers of one key share
+     * a flight across that group. There is no default: one shared default would
+     * put every application on the host into one group, and unrelated
+     * applications that use the same key would join each other's flights. It
+     * must be on a local file system.
+     */
+    directory: string;
+    /** Turns the flight's value into text for the processes that joined it, and back. */
+    codec: Codec<T>;
+    /**
+     * Milliseconds that a new coordinator starts no flight after the previous
+     * one stopped, so the leaders of flights in progress can claim them again.
+     * Must exceed how long a process takes to reconnect. Defaults to 500.
+     */
+    graceWindow?: number;
+}
 export interface RunOptions {
-    /** Called once, before this caller starts to wait for a flight that another caller started. */
+    /** Called once, when this caller joins a flight that another caller leads. */
     onJoin?: (() => void) | undefined;
     /** Stops the wait of this caller only, which then rejects with `signal.reason`. The flight runs on. */
     signal?: AbortSignal | undefined;
 }
-/** What a caller gets: the value of the flight, and whether the caller joined a flight that another caller started. */
+/** What a caller gets: the value of the flight, and whether the caller joined a flight that another caller led. */
 export interface FlightValue<T> {
     readonly value: T;
     readonly joined: boolean;
 }
-/** Callers of one key in this process share the flight in progress. */
-export declare class SingleFlight<T> {
+/**
+ * Callers of one key share the flight in progress, in this process and in
+ * every process that uses the same directory. One process of the group is
+ * elected the coordinator. Each call asks it, in one step, to lead a new
+ * flight of the key or to join the flight in progress. The leader runs the
+ * work, and the coordinator pushes the outcome to every joiner.
+ */
+export declare class SingleFlight<T> implements AsyncDisposable {
     #private;
+    constructor({ directory, codec, graceWindow }: SingleFlightOptions<T>);
     /**
-     * Runs `work` for `key`, or joins the flight of `key` in progress. `work`
-     * gets a signal that aborts only when every caller of the flight cancelled:
-     * work that can stop early may read it. Work that ignores it runs on, and
-     * the next call starts a new flight either way.
+     * Runs `work` for `key` as the leader of a new flight, or joins the flight
+     * of `key` in progress. `work` gets the flight's lease: its token, and a
+     * signal that aborts with `LeaseLostError` once the flight is no longer this
+     * leader's. After that loss, the leader's call rejects with `LeaseLostError`,
+     * also when the work throws its own error. A joiner gets the leader's value
+     * through the codec, or rejects with `FlightFailedError` or
+     * `FlightInterruptedError`.
      */
-    run(key: string, work: (abandoned: AbortSignal) => Promise<T>, { onJoin, signal }?: RunOptions): Promise<FlightValue<T>>;
+    run(key: string, work: (lease: FencedLease) => Promise<T>, { onJoin, signal }?: RunOptions): Promise<FlightValue<T>>;
+    /** Disconnects, and stops serving as the coordinator: the other processes elect a successor. */
+    [Symbol.asyncDispose](): Promise<void>;
 }
 //# sourceMappingURL=single-flight.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"single-flight.d.ts","sourceRoot":"","sources":["../src/single-flight.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAClC,uGAAuG;IACvG,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,uHAAuH;AACvH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,uEAAuE;AACvE,qBAAa,YAAY,CAAC,CAAC;;IAIzB;;;;;OAKG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC5C,EAAE,MAAM,EAAE,MAAM,EAAE,GAAE,UAAe,GAClC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAyB3B"}
+{"version":3,"file":"single-flight.d.ts","sourceRoot":"","sources":["../src/single-flight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAiBxC,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC;;;;;;;;OAQG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAClC,uGAAuG;IACvG,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,mHAAmH;AACnH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAKD;;;;;;GAMG;AACH,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,eAAe;;gBAMzC,EAAE,SAAS,EAAE,KAAK,EAAE,WAAiB,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IA+B3E;;;;;;;;OAQG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACxC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAE,UAAe,GAClC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAmB1B,gGAAgG;IAC1F,CAAC,MAAM,CAAC,YAAY,CAAC;CAmC5B"}

package/dist/single-flight.js

@@ -1,39 +1,106 @@
-import { Flight } from "./flight.js";
-/** Callers of one key in this process share the flight in progress. */
+import { untilAborted } from '@zukhruf/async';
+import { LeaseLostError } from '@zukhruf/lease';
+import { FlightClient } from "./client/flight-client.js";
+import { ConnectionSupervisor } from "./connection/connection-supervisor.js";
+import { ElectingConnector } from "./connection/electing-connector.js";
+import { LocalDirectoryConnector } from "./connection/local-directory-connector.js";
+import { socketPathFor } from "./connection/socket-path.js";
+import { FlightServer } from "./coordinator/flight-server.js";
+import { LeaderElection } from "./election/leader-election.js";
+import { FlightFailedError, FlightInterruptedError, failureOf, } from "./errors.js";
+/** Milliseconds between two attempts to reach the coordinator or to win its term. */
+const POLL_INTERVAL = 10;
+/**
+ * Callers of one key share the flight in progress, in this process and in
+ * every process that uses the same directory. One process of the group is
+ * elected the coordinator. Each call asks it, in one step, to lead a new
+ * flight of the key or to join the flight in progress. The leader runs the
+ * work, and the coordinator pushes the outcome to every joiner.
+ */
 export class SingleFlight {
-    /** Only the flights in progress: a flight that ended leaves, so the next call starts a new one. */
-    #flights = new Map();
+    #client;
+    #codec;
+    /** The flight servers this process started; disposing closes them. */
+    #servers = new AsyncDisposableStack();
+    constructor({ directory, codec, graceWindow = 500 }) {
+        this.#codec = codec;
+        const socketPath = socketPathFor(directory);
+        this.#client = new FlightClient(new ConnectionSupervisor(new LocalDirectoryConnector(directory, new ElectingConnector({
+            socketPath,
+            election: new LeaderElection(directory, {
+                pollInterval: POLL_INTERVAL,
+            }),
+            pollInterval: POLL_INTERVAL,
+            serve: async (leadership) => {
+                // Until serving has fully started, a failure closes the new server, so no server outlives its term.
+                await using starting = new AsyncDisposableStack();
+                starting.adopt(await FlightServer.start(socketPath, leadership, {
+                    // The first term of a directory has no flights to wait for.
+                    graceWindow: leadership.epoch > 1n ? graceWindow : 0,
+                }), (started) => started.close());
+                this.#servers.use(starting.move());
+            },
+        }))));
+    }
     /**
-     * Runs `work` for `key`, or joins the flight of `key` in progress. `work`
-     * gets a signal that aborts only when every caller of the flight cancelled:
-     * work that can stop early may read it. Work that ignores it runs on, and
-     * the next call starts a new flight either way.
+     * Runs `work` for `key` as the leader of a new flight, or joins the flight
+     * of `key` in progress. `work` gets the flight's lease: its token, and a
+     * signal that aborts with `LeaseLostError` once the flight is no longer this
+     * leader's. After that loss, the leader's call rejects with `LeaseLostError`,
+     * also when the work throws its own error. A joiner gets the leader's value
+     * through the codec, or rejects with `FlightFailedError` or
+     * `FlightInterruptedError`.
      */
     async run(key, work, { onJoin, signal } = {}) {
-        // A caller that already cancelled neither starts nor joins a flight.
-        signal?.throwIfAborted();
-        // No await before the flight is in the map: a second caller must find it.
-        const inProgress = this.#flights.get(key);
-        const flight = inProgress ?? this.#start(key, work);
-        const joined = inProgress !== undefined;
-        if (joined)
-            onJoin?.();
-        // The signal stops only this caller's wait. The work never sees it, so
-        // the other callers still get the value.
-        return { value: await flight.wait(signal), joined };
+        const answer = await this.#client.run(key, { signal, onJoin });
+        switch (answer.kind) {
+            case 'landed':
+                return { value: this.#read(key, answer.outcome), joined: true };
+            case 'interrupted':
+                throw new FlightInterruptedError(key);
+            case 'lead': {
+                // The signal stops only this caller's wait. The flight runs on for its joiners.
+                const settled = await untilAborted(this.#fly(key, work, answer.lead), signal);
+                if ('error' in settled)
+                    throw settled.error;
+                return { value: settled.value, joined: false };
+            }
+        }
+    }
+    /** Disconnects, and stops serving as the coordinator: the other processes elect a successor. */
+    async [Symbol.asyncDispose]() {
+        await this.#client.close();
+        await this.#servers.disposeAsync();
+    }
+    /** Runs the work and lands its outcome. Never rejects, so a caller that stopped waiting leaves no rejection behind. */
+    async #fly(key, work, lead) {
+        const { token, signal: lost } = lead;
+        let text;
+        try {
+            text = this.#codec.encode(await work({ token, signal: lost }));
+        }
+        catch (error) {
+            lead.land({ failure: failureOf(error) });
+            // After a loss, every failure rejects with LeaseLostError: the work did not run alone (ADR 0007).
+            if (!lost.aborted || error === lost.reason)
+                return { error };
+            return { error: new LeaseLostError(key, { cause: error }) };
+        }
+        // A lost flight's joiners were told that it is interrupted, so this value reaches nobody.
+        if (lost.aborted)
+            return { error: lost.reason };
+        lead.land({ value: text });
+        try {
+            return { value: this.#codec.decode(text) };
+        }
+        catch (error) {
+            return { error };
+        }
     }
-    #start(key, work) {
-        const flight = new Flight(work);
-        this.#flights.set(key, flight);
-        const leave = () => {
-            if (this.#flights.get(key) === flight)
-                this.#flights.delete(key);
-        };
-        void flight.ended.then(leave);
-        // In the same step as the abort, so no caller joins a flight that nobody
-        // waits for (Go issue 22724: a new lookup joined a cancelled one).
-        flight.abandoned.addEventListener('abort', leave, { once: true });
-        return flight;
+    #read(key, outcome) {
+        if ('failure' in outcome)
+            throw new FlightFailedError(key, outcome.failure);
+        return this.#codec.decode(outcome.value);
     }
 }
 //# sourceMappingURL=single-flight.js.map

package/dist/single-flight.js.map

@@ -1 +1 @@
-{"version":3,"file":"single-flight.js","sourceRoot":"","sources":["../src/single-flight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAerC,uEAAuE;AACvE,MAAM,OAAO,YAAY;IACvB,mGAAmG;IAC1F,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEjD;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CACP,GAAW,EACX,IAA4C,EAC5C,EAAE,MAAM,EAAE,MAAM,KAAiB,EAAE;QAEnC,qEAAqE;QACrE,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,0EAA0E;QAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,KAAK,SAAS,CAAC;QACxC,IAAI,MAAM;YAAE,MAAM,EAAE,EAAE,CAAC;QACvB,uEAAuE;QACvE,yCAAyC;QACzC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,IAA4C;QAC9D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnE,CAAC,CAAC;QACF,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"single-flight.js","sourceRoot":"","sources":["../src/single-flight.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zukhruf/single-flight",
-  "version": "0.3.15",
-  "description": "Callers of one key share the run already in flight, in one process or across processes, and get its outcome instead of a busy error.",
+  "version": "0.3.17",
+  "description": "Callers of one key share the run already in flight, in one process or across the processes that use one directory, and get its outcome instead of a busy error.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -41,10 +41,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@zukhruf/async": "^0.3.13"
-  },
-  "peerDependencies": {
-    "@zukhruf/mutex": "^0.3.11"
+    "@zukhruf/async": "^0.3.13",
+    "@zukhruf/fencing": "^0.3.16",
+    "@zukhruf/fs": "^0.3.16",
+    "@zukhruf/lease": "^0.3.16"
   },
   "devDependencies": {
     "@zukhruf/mutex": "^0.3.11"

package/dist/file-flight-records.d.ts

@@ -1,22 +0,0 @@
-import { type Finished, type FlightRecords, type LatestFlight, type Outcome } from './flight-records.ts';
-export interface FileFlightRecordsOptions {
-    /**
-     * Milliseconds that the outcome of a flight stays readable after the flight
-     * ended. A joiner reads it once per poll interval, so keep it at least 20
-     * times the `pollInterval` of every joiner. Defaults to 60 000.
-     */
-    keepFor?: number;
-}
-/**
- * Keeps the flight records of each key in one JSON file in `directory`. Give
- * the records a directory of their own, never the lock directory of a mutex.
- */
-export declare class FileFlightRecords implements FlightRecords {
-    #private;
-    constructor(directory: string, { keepFor }?: FileFlightRecordsOptions);
-    begin(key: string): Promise<string>;
-    finish(key: string, id: string, outcome: Finished): Promise<void>;
-    latest(key: string): Promise<LatestFlight | undefined>;
-    outcome(key: string, id: string): Promise<Outcome>;
-}
-//# sourceMappingURL=file-flight-records.d.ts.map

package/dist/file-flight-records.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-flight-records.d.ts","sourceRoot":"","sources":["../src/file-flight-records.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,OAAO,EAGb,MAAM,qBAAqB,CAAC;AAyB7B,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,aAAa;;gBAKnD,SAAS,EAAE,MAAM,EACjB,EAAE,OAAgB,EAAE,GAAE,wBAA6B;IAW/C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAejE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAKtD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA0DzD"}

package/dist/file-flight-records.js

@@ -1,124 +0,0 @@
-import { createHash, randomUUID } from 'node:crypto';
-import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { isOutcome, isRecord, } from "./flight-records.js";
-import { patiently } from "./patiently.js";
-const isEntry = (value) => isRecord(value) &&
-    typeof value['id'] === 'string' &&
-    isOutcome(value['outcome']) &&
-    value['outcome'].status !== 'missing' &&
-    (value['endedAt'] === undefined || typeof value['endedAt'] === 'number');
-const isFlightFile = (value) => isRecord(value) &&
-    Array.isArray(value['flights']) &&
-    value['flights'].every(isEntry);
-/**
- * Keeps the flight records of each key in one JSON file in `directory`. Give
- * the records a directory of their own, never the lock directory of a mutex.
- */
-export class FileFlightRecords {
-    #directory;
-    #keepFor;
-    constructor(directory, { keepFor = 60_000 } = {}) {
-        if (!(keepFor >= 0) || !Number.isFinite(keepFor)) {
-            throw new RangeError(`keepFor must be a finite number of milliseconds >= 0, got ${keepFor}.`);
-        }
-        this.#directory = directory;
-        this.#keepFor = keepFor;
-    }
-    async begin(key) {
-        const id = randomUUID();
-        const endedAt = Date.now();
-        const flights = (await this.#read(key)).map((flight) => flight.outcome.status === 'running'
-            ? {
-                id: flight.id,
-                outcome: { status: 'interrupted', successor: id },
-                endedAt,
-            }
-            : flight);
-        await this.#write(key, [
-            ...flights,
-            { id, outcome: { status: 'running' } },
-        ]);
-        return id;
-    }
-    async finish(key, id, outcome) {
-        const flights = await this.#read(key);
-        const running = flights.some((flight) => flight.id === id && flight.outcome.status === 'running');
-        if (!running)
-            return;
-        const endedAt = Date.now();
-        await this.#write(key, flights.map((flight) => flight.id === id ? { id, outcome, endedAt } : flight));
-    }
-    async latest(key) {
-        const last = (await this.#read(key)).at(-1);
-        return last && { id: last.id, status: last.outcome.status };
-    }
-    async outcome(key, id) {
-        const flight = (await this.#read(key)).find((flight) => flight.id === id);
-        return flight?.outcome ?? { status: 'missing' };
-    }
-    /**
-     * A key can hold characters that no file name can, such as `:` on Windows
-     * or `/`, and two keys can differ only by case, which a case-insensitive
-     * file system ignores. The hex digest has none of these problems. It digests
-     * the UTF-16 code units: UTF-8 would turn every lone surrogate into U+FFFD
-     * and give such keys one record.
-     */
-    #pathOf(key) {
-        const name = createHash('sha256').update(key, 'utf16le').digest('hex');
-        return join(this.#directory, `${name}.json`);
-    }
-    /**
-     * A finished flight leaves once it ended `keepFor` ago. The flight that
-     * began last always stays, so `latest` still knows it.
-     */
-    #kept(flights, now) {
-        return flights.filter((flight, index) => index === flights.length - 1 ||
-            flight.endedAt === undefined ||
-            now - flight.endedAt < this.#keepFor);
-    }
-    async #read(key) {
-        const path = this.#pathOf(key);
-        let text;
-        try {
-            text = await patiently(() => readFile(path, 'utf8'));
-        }
-        catch (error) {
-            if (isErrno(error, 'ENOENT'))
-                return [];
-            throw error;
-        }
-        const content = parseJson(text, path);
-        if (!isFlightFile(content))
-            throw notAFlightFile(path);
-        return content.flights;
-    }
-    /** Replaces the file in one step, so a joiner reads the old records or the new ones, never a part. */
-    async #write(key, flights) {
-        const path = this.#pathOf(key);
-        const draft = `${path}.${randomUUID()}.tmp`;
-        const kept = this.#kept(flights, Date.now());
-        await mkdir(this.#directory, { recursive: true });
-        try {
-            await writeFile(draft, JSON.stringify({ key, flights: kept }));
-            await patiently(() => rename(draft, path));
-        }
-        catch (error) {
-            await rm(draft, { force: true });
-            throw error;
-        }
-    }
-}
-function parseJson(text, path) {
-    try {
-        return JSON.parse(text);
-    }
-    catch (error) {
-        throw notAFlightFile(path, { cause: error });
-    }
-}
-const notAFlightFile = (path, options) => new Error(`${JSON.stringify(path)} is not a file of flight records. Give the records a directory of their own.`, options);
-function isErrno(error, code) {
-    return error instanceof Error && 'code' in error && error.code === code;
-}
-//# sourceMappingURL=file-flight-records.js.map

package/dist/file-flight-records.js.map

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

package/dist/flight-records.d.ts

@@ -1,67 +0,0 @@
-/** An error as a flight record keeps it: the parts that JSON carries to another process. */
-export interface RecordedError {
-    readonly name: string;
-    readonly message: string;
-    readonly code?: string | number;
-}
-/** Where a flight is: still running, or how it ended. */
-export type Status = 'running' | 'succeeded' | 'failed' | 'interrupted';
-/** How a flight ended, as its leader records it. */
-export type Finished = {
-    readonly status: 'succeeded';
-    readonly value: unknown;
-} | {
-    readonly status: 'failed';
-    readonly error: RecordedError;
-} | {
-    readonly status: 'interrupted';
-};
-/** What a joiner reads about a flight: running, how it ended, or missing when its record is gone. */
-export type Outcome = {
-    readonly status: 'running';
-} | {
-    readonly status: 'succeeded';
-    readonly value: unknown;
-} | {
-    readonly status: 'failed';
-    readonly error: RecordedError;
-} | {
-    readonly status: 'interrupted';
-    readonly successor?: string;
-} | {
-    readonly status: 'missing';
-};
-/** The flight that a key began last. */
-export interface LatestFlight {
-    readonly id: string;
-    readonly status: Status;
-}
-/**
- * Where the outcomes of flights live, so that callers in other processes can
- * join a flight. Only the holder of a key writes the records of the key.
- * Joiners only read them.
- */
-export interface FlightRecords {
-    /**
-     * Records a new running flight of `key` and returns its id. A flight of the
-     * key that is still running stopped before it had an outcome: it becomes
-     * interrupted, with the new flight as its successor.
-     */
-    begin(key: string): Promise<string>;
-    /** Records how flight `id` ended. Does nothing when the flight is no longer running. */
-    finish(key: string, id: string, outcome: Finished): Promise<void>;
-    /** The flight that `key` began last, or `undefined` when the key has no record. */
-    latest(key: string): Promise<LatestFlight | undefined>;
-    /**
-     * The outcome of flight `id`. An outcome stays readable for a time after
-     * its flight ended, so a joiner that reads it late finds it after newer
-     * flights of the key began.
-     */
-    outcome(key: string, id: string): Promise<Outcome>;
-}
-/** The parts of a thrown value that a record keeps. A value that is not an error keeps only its text. */
-export declare function recordedError(error: unknown): RecordedError;
-export declare const isRecord: (value: unknown) => value is Readonly<Record<string, unknown>>;
-export declare function isRecordedError(value: unknown): value is RecordedError;
-export declare function isOutcome(value: unknown): value is Outcome;
-//# sourceMappingURL=flight-records.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"flight-records.d.ts","sourceRoot":"","sources":["../src/flight-records.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAExE,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAEvC,qGAAqG;AACrG,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnC,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,wFAAwF;IACxF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,mFAAmF;IACnF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACvD;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAQ3D;AAED,eAAO,MAAM,QAAQ,GACnB,OAAO,OAAO,KACb,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACC,CAAC;AAE9C,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAkB1D"}