@zukhruf/single-flight 0.3.15 → 0.3.17

package/dist/flight-records.js

@@ -1,38 +0,0 @@
-/** The parts of a thrown value that a record keeps. A value that is not an error keeps only its text. */
-export function recordedError(error) {
-    if (!(error instanceof Error))
-        return { name: 'Error', message: String(error) };
-    const { name, message } = error;
-    const code = 'code' in error ? error.code : undefined;
-    return typeof code === 'string' || typeof code === 'number'
-        ? { name, message, code }
-        : { name, message };
-}
-export const isRecord = (value) => typeof value === 'object' && value !== null;
-export function isRecordedError(value) {
-    if (!isRecord(value))
-        return false;
-    const { name, message, code } = value;
-    return (typeof name === 'string' &&
-        typeof message === 'string' &&
-        (code === undefined || typeof code === 'string' || typeof code === 'number'));
-}
-export function isOutcome(value) {
-    if (!isRecord(value))
-        return false;
-    switch (value['status']) {
-        case 'running':
-        case 'missing':
-            return true;
-        case 'succeeded':
-            return 'value' in value;
-        case 'failed':
-            return isRecordedError(value['error']);
-        case 'interrupted':
-            return (value['successor'] === undefined ||
-                typeof value['successor'] === 'string');
-        default:
-            return false;
-    }
-}
-//# sourceMappingURL=flight-records.js.map

package/dist/flight-records.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flight-records.js","sourceRoot":"","sources":["../src/flight-records.ts"],"names":[],"mappings":"AAsDA,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;QACzD,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,KAAc,EAC8B,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAE9C,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACtC,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,OAAO,OAAO,KAAK,QAAQ;QAC3B,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,QAAQ,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,WAAW;YACd,OAAO,OAAO,IAAI,KAAK,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,KAAK,aAAa;YAChB,OAAO,CACL,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS;gBAChC,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ,CACvC,CAAC;QACJ;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/flight.d.ts

@@ -1,12 +0,0 @@
-/** One run of the work for a key in this process. Every caller that joins it gets how it ended. */
-export declare class Flight<T> {
-    #private;
-    constructor(work: (abandoned: AbortSignal) => Promise<T>);
-    /** The outcome of the work, once it ended. Never rejects. */
-    get ended(): Promise<PromiseSettledResult<Awaited<T>>>;
-    /** Aborts when every caller cancelled its wait before the flight ended. */
-    get abandoned(): AbortSignal;
-    /** Waits for the flight for one caller, until it ends or `signal` aborts. */
-    wait(signal: AbortSignal | undefined): Promise<T>;
-}
-//# sourceMappingURL=flight.d.ts.map

package/dist/flight.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flight.d.ts","sourceRoot":"","sources":["../src/flight.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,qBAAa,MAAM,CAAC,CAAC;;gBAOP,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC;IAMxD,6DAA6D;IAC7D,IAAI,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAErD;IAED,2EAA2E;IAC3E,IAAI,SAAS,IAAI,WAAW,CAE3B;IAED,6EAA6E;IACvE,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;CAcxD"}

package/dist/flight.js

@@ -1,38 +0,0 @@
-import { Latch, untilAborted } from '@zukhruf/async';
-/** One run of the work for a key in this process. Every caller that joins it gets how it ended. */
-export class Flight {
-    /** Opens with the outcome of the work. An error is data here, so the latch never rejects; each caller throws it. */
-    #ended = new Latch();
-    #abandoned = new AbortController();
-    /** The callers that wait for the flight now. */
-    #waiting = 0;
-    constructor(work) {
-        void Promise.allSettled([Promise.try(work, this.#abandoned.signal)]).then(([outcome]) => this.#ended.open(outcome));
-    }
-    /** The outcome of the work, once it ended. Never rejects. */
-    get ended() {
-        return this.#ended.wait();
-    }
-    /** Aborts when every caller cancelled its wait before the flight ended. */
-    get abandoned() {
-        return this.#abandoned.signal;
-    }
-    /** Waits for the flight for one caller, until it ends or `signal` aborts. */
-    async wait(signal) {
-        this.#waiting++;
-        const leave = () => {
-            this.#waiting--;
-            if (this.#waiting === 0)
-                this.#abandoned.abort();
-        };
-        signal?.addEventListener('abort', leave, { once: true });
-        void this.#ended
-            .wait()
-            .then(() => signal?.removeEventListener('abort', leave));
-        const outcome = await untilAborted(this.#ended.wait(), signal);
-        if (outcome.status === 'rejected')
-            throw outcome.reason;
-        return outcome.value;
-    }
-}
-//# sourceMappingURL=flight.js.map

package/dist/flight.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flight.js","sourceRoot":"","sources":["../src/flight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAErD,mGAAmG;AACnG,MAAM,OAAO,MAAM;IACjB,oHAAoH;IAC3G,MAAM,GAAG,IAAI,KAAK,EAAoC,CAAC;IACvD,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,GAAG,CAAC,CAAC;IAEb,YAAY,IAA4C;QACtD,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CACvE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAC3E,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,KAAK,IAAI,CAAC,MAAM;aACb,IAAI,EAAE;aACN,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,OAAO,CAAC,MAAM,CAAC;QACxD,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC;CACF"}

package/dist/follow.d.ts

@@ -1,31 +0,0 @@
-import type { Mutex } from '@zukhruf/mutex';
-import type { FlightRecords, LatestFlight } from './flight-records.ts';
-/** What a joiner watches while it waits for a flight in another process, and how often it looks. */
-export interface Watch {
-    readonly records: FlightRecords;
-    readonly mutex: Mutex;
-    readonly key: string;
-    readonly pollInterval: number;
-    /** Aborts when no caller in this process waits any more: the watch then stops. */
-    readonly abandoned: AbortSignal;
-}
-/**
- * The flight that holds the key now, found by its record. `undefined` when
- * the key became free and no new flight began, so the caller can try to lead.
- */
-export declare function findFlight({ records, mutex, key, pollInterval, abandoned }: Watch, before: LatestFlight | undefined): Promise<string | undefined>;
-/** How following ended: with the value of the flight, or with no flight to follow, so the caller tries to lead. */
-export type Followed = {
-    readonly followed: true;
-    readonly value: unknown;
-} | {
-    readonly followed: false;
-};
-/**
- * Waits for flight `id` to end and gives its value. It reads the record, not
- * the lock: back-to-back holders can keep the key held at every look, so
- * waiting for a free key could wait forever. The lock only tells whether a
- * running flight still has a holder.
- */
-export declare function follow({ records, mutex, key, pollInterval, abandoned }: Watch, first: string): Promise<Followed>;
-//# sourceMappingURL=follow.d.ts.map

package/dist/follow.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../src/follow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAO5C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvE,oGAAoG;AACpG,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,KAAK,EACvD,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAED,mHAAmH;AACnH,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,KAAK,EACvD,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC,CAkCnB"}

package/dist/follow.js

@@ -1,60 +0,0 @@
-import { setTimeout as delay } from 'node:timers/promises';
-import { FlightFailedError, FlightInterruptedError, FlightOutcomeLostError, } from "./errors.js";
-/**
- * The flight that holds the key now, found by its record. `undefined` when
- * the key became free and no new flight began, so the caller can try to lead.
- */
-export async function findFlight({ records, mutex, key, pollInterval, abandoned }, before) {
-    for (;;) {
-        await delay(pollInterval, undefined, { signal: abandoned });
-        const now = await records.latest(key);
-        if (now && (now.id !== before?.id || before.status === 'running'))
-            return now.id;
-        if (!(await mutex.isHeld(key)))
-            return undefined;
-    }
-}
-/**
- * Waits for flight `id` to end and gives its value. It reads the record, not
- * the lock: back-to-back holders can keep the key held at every look, so
- * waiting for a free key could wait forever. The lock only tells whether a
- * running flight still has a holder.
- */
-export async function follow({ records, mutex, key, pollInterval, abandoned }, first) {
-    let id = first;
-    let seenHeld = false;
-    for (;;) {
-        const outcome = await records.outcome(key, id);
-        switch (outcome.status) {
-            case 'succeeded':
-                return { followed: true, value: outcome.value };
-            case 'failed':
-                throw new FlightFailedError(key, outcome.error);
-            case 'interrupted':
-                if (outcome.successor === undefined)
-                    throw new FlightInterruptedError(key);
-                // The next holder closed a flight whose holder stopped, and began its own.
-                id = outcome.successor;
-                seenHeld = false;
-                continue;
-            case 'running':
-                if (await mutex.isHeld(key)) {
-                    seenHeld = true;
-                    await delay(pollInterval, undefined, { signal: abandoned });
-                    continue;
-                }
-                // The holder can finish between the two looks: read the record again.
-                if ((await records.outcome(key, id)).status !== 'running')
-                    continue;
-                // A record that was running before this joiner came was left by a
-                // holder that stopped long ago: there is no flight to join.
-                if (!seenHeld)
-                    return { followed: false };
-                // This joiner saw the holder run the flight, and the holder stopped.
-                throw new FlightInterruptedError(key);
-            case 'missing':
-                throw new FlightOutcomeLostError(key);
-        }
-    }
-}
-//# sourceMappingURL=follow.js.map

package/dist/follow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"follow.js","sourceRoot":"","sources":["../src/follow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAarB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAS,EACvD,MAAgC;IAEhC,SAAS,CAAC;QACR,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;YAC/D,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IACnD,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAS,EACvD,KAAa;IAEb,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,SAAS,CAAC;QACR,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/C,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,WAAW;gBACd,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAClD,KAAK,QAAQ;gBACX,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAClD,KAAK,aAAa;gBAChB,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;oBACjC,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;gBACxC,2EAA2E;gBAC3E,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;gBACvB,QAAQ,GAAG,KAAK,CAAC;gBACjB,SAAS;YACX,KAAK,SAAS;gBACZ,IAAI,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBAC5D,SAAS;gBACX,CAAC;gBACD,sEAAsE;gBACtE,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS;oBAAE,SAAS;gBACpE,kEAAkE;gBAClE,4DAA4D;gBAC5D,IAAI,CAAC,QAAQ;oBAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBAC1C,qEAAqE;gBACrE,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;YACxC,KAAK,SAAS;gBACZ,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/patiently.d.ts

@@ -1,3 +0,0 @@
-/** Runs `operation`, and runs it again while Windows refuses the file for a moment. */
-export declare function patiently<T>(operation: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=patiently.d.ts.map

package/dist/patiently.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"patiently.d.ts","sourceRoot":"","sources":["../src/patiently.ts"],"names":[],"mappings":"AAoBA,uFAAuF;AACvF,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAc1E"}

package/dist/patiently.js

@@ -1,31 +0,0 @@
-import { setTimeout as delay } from 'node:timers/promises';
-/** How long to retry a file operation that Windows refuses for a moment. */
-const WINDOWS_PATIENCE = 1000;
-/**
- * Windows refuses a file for a moment while another process has it open, for
- * example a joiner that reads the record while the holder replaces it. The
- * error code is the same as for a real permission denial, so a refusal is
- * retried only for a limited time.
- */
-function isRefusedForNow(error) {
-    return (process.platform === 'win32' &&
-        error instanceof Error &&
-        'code' in error &&
-        ['EPERM', 'EACCES', 'EBUSY'].includes(String(error.code)));
-}
-/** Runs `operation`, and runs it again while Windows refuses the file for a moment. */
-export async function patiently(operation) {
-    const started = performance.now();
-    for (let attempt = 0;; attempt++) {
-        try {
-            return await operation();
-        }
-        catch (error) {
-            if (!isRefusedForNow(error) ||
-                performance.now() - started > WINDOWS_PATIENCE)
-                throw error;
-            await delay(Math.min(5 * 2 ** attempt, 100));
-        }
-    }
-}
-//# sourceMappingURL=patiently.js.map

package/dist/patiently.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"patiently.js","sourceRoot":"","sources":["../src/patiently.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC5B,KAAK,YAAY,KAAK;QACtB,MAAM,IAAI,KAAK;QACf,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,SAA2B;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,CAAC,eAAe,CAAC,KAAK,CAAC;gBACvB,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,gBAAgB;gBAE9C,MAAM,KAAK,CAAC;YACd,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/shared-flight.d.ts

@@ -1,25 +0,0 @@
-import { type Lease, type Mutex } from '@zukhruf/mutex';
-import { type FlightRecords } from './flight-records.ts';
-import { type FlightValue, type RunOptions } from './single-flight.ts';
-export interface SharedFlightOptions<T> {
-    /** Decides who flies: only the holder of the key runs the work. */
-    mutex: Mutex;
-    /** Where the outcomes live, so callers in other processes can join. Never the lock directory of the mutex. */
-    records: FlightRecords;
-    /** Turns a value read back from a record into `T`. Every caller, the leader too, gets `parse` of the value as JSON. */
-    parse: (value: unknown) => T;
-    /** Milliseconds between two looks at a record while a caller joins. Defaults to 100. */
-    pollInterval?: number;
-}
-/**
- * Callers of one key share the flight in progress, in this process and in
- * other processes. Callers in this process share one flight first. The holder
- * of the key leads the flight, and the records let callers in other
- * processes join it.
- */
-export declare class SharedFlight<T> {
-    #private;
-    constructor({ mutex, records, parse, pollInterval, }: SharedFlightOptions<T>);
-    run(key: string, work: (lease: Lease) => Promise<T>, options?: RunOptions): Promise<FlightValue<T>>;
-}
-//# sourceMappingURL=shared-flight.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shared-flight.d.ts","sourceRoot":"","sources":["../src/shared-flight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAS,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AAExE,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,mEAAmE;IACnE,KAAK,EAAE,KAAK,CAAC;IACb,8GAA8G;IAC9G,OAAO,EAAE,aAAa,CAAC;IACvB,uHAAuH;IACvH,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IAC7B,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAcD;;;;;GAKG;AACH,qBAAa,YAAY,CAAC,CAAC;;gBAOb,EACV,KAAK,EACL,OAAO,EACP,KAAK,EACL,YAAkB,GACnB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAYnB,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA0E3B"}

package/dist/shared-flight.js

@@ -1,89 +0,0 @@
-import { Modes } from '@zukhruf/mutex';
-import { recordedError } from "./flight-records.js";
-import { findFlight, follow } from "./follow.js";
-import { SingleFlight, } from "./single-flight.js";
-const skipIfBusy = Modes.skipIfBusy();
-/** Values travel as JSON, so every caller gets the value in the shape that a joiner in another process reads. */
-const encode = (value) => JSON.parse(JSON.stringify(value) ?? 'null');
-/**
- * Callers of one key share the flight in progress, in this process and in
- * other processes. Callers in this process share one flight first. The holder
- * of the key leads the flight, and the records let callers in other
- * processes join it.
- */
-export class SharedFlight {
-    #local = new SingleFlight();
-    #mutex;
-    #records;
-    #parse;
-    #pollInterval;
-    constructor({ mutex, records, parse, pollInterval = 100, }) {
-        if (!(pollInterval >= 0) || !Number.isFinite(pollInterval)) {
-            throw new RangeError(`pollInterval must be a finite number of milliseconds >= 0, got ${pollInterval}.`);
-        }
-        this.#mutex = mutex;
-        this.#records = records;
-        this.#parse = parse;
-        this.#pollInterval = pollInterval;
-    }
-    async run(key, work, options = {}) {
-        const { value, joined } = await this.#local.run(key, (abandoned) => this.#leadOrFollow(key, work, options.onJoin, abandoned), options);
-        return { value: value.value, joined: joined || value.followed };
-    }
-    /**
-     * Runs for the first caller in this process. The callers that joined it
-     * here heard `onJoin` already; this caller hears it once it joins a flight
-     * of another process. Once no caller here waits (`abandoned`), it stops
-     * looking and never takes the key; a flight that it leads runs to its end,
-     * because callers in other processes can wait for its outcome.
-     */
-    async #leadOrFollow(key, work, onJoin, abandoned) {
-        const watch = {
-            records: this.#records,
-            mutex: this.#mutex,
-            key,
-            pollInterval: this.#pollInterval,
-            abandoned,
-        };
-        let told = false;
-        for (;;) {
-            const before = await this.#records.latest(key);
-            const led = await this.#mutex.acquire(key, (lease) => this.#lead(key, work, lease), { mode: skipIfBusy, signal: abandoned });
-            if (led.acquired)
-                return { value: led.value, followed: false };
-            const id = await findFlight(watch, before);
-            if (id === undefined)
-                continue;
-            if (!told)
-                onJoin?.();
-            told = true;
-            const followed = await follow(watch, id);
-            if (followed.followed)
-                return { value: this.#parse(followed.value), followed: true };
-        }
-    }
-    async #lead(key, work, lease) {
-        const id = await this.#records.begin(key);
-        let value;
-        try {
-            // A value that JSON cannot carry fails the flight: no joiner could read it.
-            value = encode(await work(lease));
-        }
-        catch (error) {
-            await this.#records.finish(key, id, {
-                status: 'failed',
-                error: recordedError(error),
-            });
-            throw error;
-        }
-        // Another holder may have run the work too: the value is not the outcome of one flight.
-        if (lease.signal.aborted) {
-            await this.#records.finish(key, id, { status: 'interrupted' });
-            throw lease.signal.reason;
-        }
-        // A throw here rejects the leader, although the work did its side effects.
-        await this.#records.finish(key, id, { status: 'succeeded', value });
-        return this.#parse(value);
-    }
-}
-//# sourceMappingURL=shared-flight.js.map

package/dist/shared-flight.js.map

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