@zukhruf/single-flight 0.3.14 → 0.3.16

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"}

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>);
-    /** Settles as the work settled. */
-    get ended(): Promise<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;;gBAMP,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC;IAOxD,mCAAmC;IACnC,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAEtB;IAED,2EAA2E;IAC3E,IAAI,SAAS,IAAI,WAAW,CAE3B;IAED,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;CAWlD"}

package/dist/flight.js

@@ -1,33 +0,0 @@
-import { 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 {
-    #ended = Promise.withResolvers();
-    #abandoned = new AbortController();
-    /** The callers that wait for the flight now. */
-    #waiting = 0;
-    constructor(work) {
-        Promise.try(work, this.#abandoned.signal).then(this.#ended.resolve, this.#ended.reject);
-    }
-    /** Settles as the work settled. */
-    get ended() {
-        return this.#ended.promise;
-    }
-    /** 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. */
-    wait(signal) {
-        this.#waiting++;
-        const leave = () => {
-            this.#waiting--;
-            if (this.#waiting === 0)
-                this.#abandoned.abort();
-        };
-        signal?.addEventListener('abort', leave, { once: true });
-        const stopListening = () => signal?.removeEventListener('abort', leave);
-        this.#ended.promise.then(stopListening, stopListening);
-        return untilAborted(this.#ended.promise, signal);
-    }
-}
-//# 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,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,mGAAmG;AACnG,MAAM,OAAO,MAAM;IACR,MAAM,GAAG,OAAO,CAAC,aAAa,EAAK,CAAC;IACpC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,GAAG,CAAC,CAAC;IAEb,YAAY,IAA4C;QACtD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CACnB,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,2EAA2E;IAC3E,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,MAA+B;QAClC,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,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,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.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.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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"}