@zukhruf/single-flight 0.3.15 → 0.3.17

package/dist/coordinator/party.d.ts

@@ -0,0 +1,38 @@
+import type { FlightResponse } from '../protocol/flight-protocol.ts';
+import type { Flight } from './flight.ts';
+/** Where a party's answers go: the session of the party's connection. */
+export interface Inbox {
+    reply(response: FlightResponse): void;
+    /** The party is answered for good, so the connection may use its id no more. */
+    forget(id: string): void;
+}
+/** What a party is to the coordinator now. */
+export type Role = 
+/** A run that waits for the grace window, a token, or the reassertion of its flight. */
+{
+    kind: 'waiting';
+} | {
+    kind: 'leading';
+    flight: Flight;
+} | {
+    kind: 'joining';
+    flight: Flight;
+}
+/** Answered for good, withdrawn, or its connection is gone. */
+ | {
+    kind: 'gone';
+};
+/** One request of one connection: a run that comes to lead a flight or to join one, until it is answered for good. */
+export declare class Party {
+    #private;
+    readonly id: string;
+    constructor(id: string, inbox: Inbox);
+    get role(): Role;
+    lead(flight: Flight): void;
+    /** A leader from before a failover claimed its flight again; it already knows that it leads. */
+    resume(flight: Flight): void;
+    join(flight: Flight): void;
+    /** Answers for good with `response`, or ends without an answer when it was withdrawn or its connection is gone. */
+    end(response?: FlightResponse): void;
+}
+//# sourceMappingURL=party.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"party.d.ts","sourceRoot":"","sources":["../../src/coordinator/party.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,yEAAyE;AACzE,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,gFAAgF;IAChF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,MAAM,IAAI;AACd,wFAAwF;AACtF;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrC,+DAA+D;GAC7D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,sHAAsH;AACtH,qBAAa,KAAK;;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAIR,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAKpC,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,CAAC,MAAM,EAAE,MAAM;IASnB,gGAAgG;IAChG,MAAM,CAAC,MAAM,EAAE,MAAM;IAIrB,IAAI,CAAC,MAAM,EAAE,MAAM;IASnB,mHAAmH;IACnH,GAAG,CAAC,QAAQ,CAAC,EAAE,cAAc;CAM9B"}

package/dist/coordinator/party.js

@@ -0,0 +1,43 @@
+/** One request of one connection: a run that comes to lead a flight or to join one, until it is answered for good. */
+export class Party {
+    id;
+    #inbox;
+    #role = { kind: 'waiting' };
+    constructor(id, inbox) {
+        this.id = id;
+        this.#inbox = inbox;
+    }
+    get role() {
+        return this.#role;
+    }
+    lead(flight) {
+        this.#role = { kind: 'leading', flight };
+        this.#inbox.reply({
+            op: 'lead',
+            id: this.id,
+            token: flight.token.toString(),
+        });
+    }
+    /** A leader from before a failover claimed its flight again; it already knows that it leads. */
+    resume(flight) {
+        this.#role = { kind: 'leading', flight };
+    }
+    join(flight) {
+        this.#role = { kind: 'joining', flight };
+        this.#inbox.reply({
+            op: 'joined',
+            id: this.id,
+            flight: flight.token.toString(),
+        });
+    }
+    /** Answers for good with `response`, or ends without an answer when it was withdrawn or its connection is gone. */
+    end(response) {
+        if (this.#role.kind === 'gone')
+            return;
+        this.#role = { kind: 'gone' };
+        this.#inbox.forget(this.id);
+        if (response)
+            this.#inbox.reply(response);
+    }
+}
+//# sourceMappingURL=party.js.map

package/dist/coordinator/party.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"party.js","sourceRoot":"","sources":["../../src/coordinator/party.ts"],"names":[],"mappings":"AAmBA,sHAAsH;AACtH,MAAM,OAAO,KAAK;IACP,EAAE,CAAS;IACX,MAAM,CAAQ;IACvB,KAAK,GAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAElC,YAAY,EAAU,EAAE,KAAY;QAClC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,MAAc;QACjB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,EAAE,EAAE,MAAM;YACV,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,gGAAgG;IAChG,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,MAAc;QACjB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,EAAE,EAAE,QAAQ;YACZ,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IAED,mHAAmH;IACnH,GAAG,CAAC,QAAyB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,QAAQ;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/coordinator/session.d.ts

@@ -0,0 +1,16 @@
+import type { Connection } from '../connection/connection.ts';
+import { type FlightResponse, type RequestEnvelope } from '../protocol/flight-protocol.ts';
+import type { FlightCoordinator } from './flight-coordinator.ts';
+import { type Inbox } from './party.ts';
+/**
+ * One client connection. It turns each request into a party of the
+ * coordinator, and when the connection is gone, it withdraws them all: the
+ * flights it leads are interrupted, and the flights it joined lose a joiner.
+ */
+export declare class Session implements Inbox {
+    #private;
+    constructor(coordinator: FlightCoordinator, connection: Connection<FlightResponse, RequestEnvelope>);
+    reply(response: FlightResponse): void;
+    forget(id: string): void;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/coordinator/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAErB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,OAAQ,YAAW,KAAK;;gBAMjC,WAAW,EAAE,iBAAiB,EAC9B,UAAU,EAAE,UAAU,CAAC,cAAc,EAAE,eAAe,CAAC;IAQzD,KAAK,CAAC,QAAQ,EAAE,cAAc;IAI9B,MAAM,CAAC,EAAE,EAAE,MAAM;CAgElB"}

package/dist/coordinator/session.js

@@ -0,0 +1,103 @@
+import { FencingToken } from '@zukhruf/fencing';
+import { isFlightRequest, } from "../protocol/flight-protocol.js";
+import { Party } from "./party.js";
+/**
+ * One client connection. It turns each request into a party of the
+ * coordinator, and when the connection is gone, it withdraws them all: the
+ * flights it leads are interrupted, and the flights it joined lose a joiner.
+ */
+export class Session {
+    #coordinator;
+    #parties = new Map();
+    #phase;
+    constructor(coordinator, connection) {
+        this.#coordinator = coordinator;
+        this.#phase = new Serving(connection);
+        connection.on('message', (request) => this.#handle(request));
+        connection.once('close', () => this.#end());
+    }
+    reply(response) {
+        this.#phase.reply(response);
+    }
+    forget(id) {
+        this.#parties.delete(id);
+    }
+    #handle(request) {
+        // A newer process may ask what this version does not know. The answer
+        // keeps its connection, and with it every flight it leads.
+        if (!isFlightRequest(request)) {
+            return this.reply({ op: 'unsupported', id: request.id });
+        }
+        switch (request.op) {
+            case 'run': {
+                const party = this.#open(request.id);
+                if (!party)
+                    return;
+                void (request.flight === undefined
+                    ? this.#coordinator.run(party, request.key)
+                    : this.#coordinator.rejoin(party, request.key, request.flight)).catch(() => this.#phase.close());
+                return;
+            }
+            case 'land': {
+                const role = this.#parties.get(request.id)?.role;
+                if (role?.kind !== 'leading') {
+                    return this.reply({ op: 'rejected', id: request.id });
+                }
+                return this.#coordinator.land(role.flight, request.outcome);
+            }
+            case 'cancel':
+                return this.#withdraw(request.id);
+            case 'reassert': {
+                const party = this.#open(request.id);
+                if (!party)
+                    return;
+                return this.#coordinator.reassert(party, request.key, FencingToken.parse(request.token));
+            }
+        }
+    }
+    /** A client never sends one id twice on one connection; a second request with it is ignored. */
+    #open(id) {
+        if (this.#parties.has(id))
+            return undefined;
+        const party = new Party(id, this);
+        this.#parties.set(id, party);
+        return party;
+    }
+    #withdraw(id) {
+        const party = this.#parties.get(id);
+        if (!party)
+            return;
+        const role = party.role;
+        party.end();
+        if (role.kind === 'joining')
+            role.flight.remove(party);
+        if (role.kind === 'leading')
+            this.#coordinator.interrupt(role.flight);
+    }
+    /** Ends Serving first, so nothing is answered on a connection that is gone. */
+    #end() {
+        this.#phase = new Ended();
+        for (const id of [...this.#parties.keys()])
+            this.#withdraw(id);
+    }
+}
+/** The client is connected: the session answers it. */
+class Serving {
+    #connection;
+    constructor(connection) {
+        this.#connection = connection;
+    }
+    reply(response) {
+        // A failed send means the client is gone; `close` then withdraws its parties.
+        this.#connection.send(response).catch(() => { });
+    }
+    close() {
+        this.#connection.close();
+    }
+}
+/** The client is gone: nothing is answered. */
+class Ended {
+    reply() { }
+    close() { }
+}
+//# sourceMappingURL=session.js.map

package/dist/coordinator/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/coordinator/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAGL,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAc,KAAK,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAO,OAAO;IACT,YAAY,CAAoB;IAChC,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC7C,MAAM,CAAe;IAErB,YACE,WAA8B,EAC9B,UAAuD;QAEvD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAwB;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,OAAwB;QAC9B,sEAAsE;QACtE,2DAA2D;QAC3D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;YACnB,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,KAAK,CACH,OAAO,CAAC,MAAM,KAAK,SAAS;oBAC1B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;oBAC3C,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CACjE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;gBACjD,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9D,CAAC;YACD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpC,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAC/B,KAAK,EACL,OAAO,CAAC,GAAG,EACX,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAE,CACnC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,EAAU;QACd,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,KAAK,CAAC,GAAG,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,+EAA+E;IAC/E,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAOD,uDAAuD;AACvD,MAAM,OAAO;IACF,WAAW,CAA8C;IAElE,YAAY,UAAuD;QACjE,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAwB;QAC5B,8EAA8E;QAC9E,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,KAAK;IACT,KAAK,KAAI,CAAC;IAEV,KAAK,KAAI,CAAC;CACX"}

package/dist/election/leader-election.d.ts

@@ -0,0 +1,24 @@
+import { Leadership } from './leadership.ts';
+export interface LeaderElectionOptions {
+    /** Milliseconds between attempts while another process coordinates. */
+    pollInterval?: number;
+}
+export interface CampaignOptions {
+    /** Milliseconds to keep trying before conceding to the current coordinator. */
+    timeout?: number;
+}
+/**
+ * Elects the coordinator among the processes sharing `directory`. The claim is
+ * an exclusive SQLite transaction on `flight.lock`, held for the whole term, so
+ * the kernel ends the term if the coordinator dies. Each term gets a higher
+ * epoch than every term before it, recorded in `flight.epoch`. Never delete
+ * `flight.lock` while campaigners run: a new file would let a second
+ * coordinator win.
+ */
+export declare class LeaderElection {
+    #private;
+    constructor(directory: string, { pollInterval }?: LeaderElectionOptions);
+    /** Resolves with the new term, or `undefined` if another process still coordinates after `timeout`. */
+    campaign({ timeout }?: CampaignOptions): Promise<Leadership | undefined>;
+}
+//# sourceMappingURL=leader-election.d.ts.map

package/dist/election/leader-election.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-election.d.ts","sourceRoot":"","sources":["../../src/election/leader-election.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;;gBAKvB,SAAS,EAAE,MAAM,EACjB,EAAE,YAAiB,EAAE,GAAE,qBAA0B;IAMnD,uGAAuG;IACjG,QAAQ,CAAC,EAAE,OAAW,EAAE,GAAE,eAAoB,GAAG,OAAO,CAC5D,UAAU,GAAG,SAAS,CACvB;CAyCF"}

package/dist/election/leader-election.js

@@ -0,0 +1,78 @@
+import { mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { setTimeout as delay } from 'node:timers/promises';
+import { assertLocalDirectory, durableWrite, isErrno } from '@zukhruf/fs';
+import { isBusy } from "../shared/sqlite/is-busy.js";
+import { Leadership } from "./leadership.js";
+/**
+ * Elects the coordinator among the processes sharing `directory`. The claim is
+ * an exclusive SQLite transaction on `flight.lock`, held for the whole term, so
+ * the kernel ends the term if the coordinator dies. Each term gets a higher
+ * epoch than every term before it, recorded in `flight.epoch`. Never delete
+ * `flight.lock` while campaigners run: a new file would let a second
+ * coordinator win.
+ */
+export class LeaderElection {
+    #directory;
+    #pollInterval;
+    constructor(directory, { pollInterval = 10 } = {}) {
+        this.#directory = directory;
+        this.#pollInterval = pollInterval;
+    }
+    /** Resolves with the new term, or `undefined` if another process still coordinates after `timeout`. */
+    async campaign({ timeout = 0 } = {}) {
+        await assertLocalDirectory(this.#directory);
+        await mkdir(this.#directory, { recursive: true });
+        // A busy timeout above zero would block this process's event loop while it
+        // waits, so the claim is retried here instead.
+        const claim = new DatabaseSync(join(this.#directory, 'flight.lock'), {
+            timeout: 0,
+        });
+        const deadline = performance.now() + timeout;
+        try {
+            for (;;) {
+                if (this.#tryClaim(claim))
+                    return new Leadership(await this.#nextEpoch(), claim);
+                if (performance.now() >= deadline)
+                    break;
+                await delay(this.#pollInterval);
+            }
+        }
+        catch (error) {
+            claim.close();
+            throw error;
+        }
+        claim.close();
+        return undefined;
+    }
+    #tryClaim(claim) {
+        try {
+            claim.exec('BEGIN EXCLUSIVE');
+            return true;
+        }
+        catch (error) {
+            if (isBusy(error))
+                return false;
+            throw error;
+        }
+    }
+    /** Safe without further locking: only the claim holder gets here. */
+    async #nextEpoch() {
+        const path = join(this.#directory, 'flight.epoch');
+        const epoch = (await readEpoch(path)) + 1n;
+        await durableWrite(path, epoch.toString());
+        return epoch;
+    }
+}
+async function readEpoch(path) {
+    try {
+        return BigInt(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        if (isErrno(error, 'ENOENT'))
+            return 0n;
+        throw error;
+    }
+}
+//# sourceMappingURL=leader-election.js.map

package/dist/election/leader-election.js.map

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

package/dist/election/leadership.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * One term as the elected coordinator. It lasts until `resign` or until the
+ * process dies, when the kernel releases the claim and another campaigner can win.
+ */
+export declare class Leadership implements AsyncDisposable {
+    #private;
+    /** Grows with every term, so a newer coordinator's tokens always outrank an older one's. */
+    readonly epoch: bigint;
+    constructor(epoch: bigint, claim: DatabaseSync);
+    resign(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=leadership.d.ts.map

package/dist/election/leadership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leadership.d.ts","sourceRoot":"","sources":["../../src/election/leadership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,qBAAa,UAAW,YAAW,eAAe;;IAChD,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGX,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;IAKxC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/election/leadership.js

@@ -0,0 +1,23 @@
+/**
+ * One term as the elected coordinator. It lasts until `resign` or until the
+ * process dies, when the kernel releases the claim and another campaigner can win.
+ */
+export class Leadership {
+    /** Grows with every term, so a newer coordinator's tokens always outrank an older one's. */
+    epoch;
+    #claim;
+    constructor(epoch, claim) {
+        this.epoch = epoch;
+        this.#claim = claim;
+    }
+    async resign() {
+        if (!this.#claim.isOpen)
+            return;
+        this.#claim.exec('ROLLBACK');
+        this.#claim.close();
+    }
+    [Symbol.asyncDispose]() {
+        return this.resign();
+    }
+}
+//# sourceMappingURL=leadership.js.map

package/dist/election/leadership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leadership.js","sourceRoot":"","sources":["../../src/election/leadership.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,4FAA4F;IACnF,KAAK,CAAS;IACd,MAAM,CAAe;IAE9B,YAAY,KAAa,EAAE,KAAmB;QAC5C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,CAAC,MAAM,CAAC,YAAY,CAAC;QACnB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -1,22 +1,19 @@
-import type { RecordedError } from './flight-records.ts';
-/** The flight that this caller joined in another process failed. `failure` is the error that its leader recorded. */
+import type { Failure } from './protocol/flight-protocol.ts';
+/** The work of the flight that this caller joined failed. `failure` describes the error that its leader got. */
 export declare class FlightFailedError extends Error {
     readonly key: string;
-    readonly failure: RecordedError;
-    constructor(key: string, failure: RecordedError);
+    readonly failure: Failure;
+    constructor(key: string, failure: Failure);
 }
 /**
- * The holder of the flight that this caller joined stopped before the flight
- * had an outcome: its process stopped, its lease was lost, or its records
- * refused the outcome.
+ * The flight that this caller joined ended without an outcome: its leader's
+ * process stopped, or its leader lost the flight. The work is never run again
+ * for this caller; a new call starts a new flight.
  */
 export declare class FlightInterruptedError extends Error {
     readonly key: string;
     constructor(key: string);
 }
-/** The record of the flight that this caller joined was gone before the caller read its outcome. */
-export declare class FlightOutcomeLostError extends Error {
-    readonly key: string;
-    constructor(key: string);
-}
+/** The parts of a thrown value that cross to the joiners. A value that is not an error keeps only its text. */
+export declare function failureOf(error: unknown): Failure;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qHAAqH;AACrH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;CAQhD;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAOxB;AAED,oGAAoG;AACpG,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAOxB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7D,gHAAgH;AAChH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CAQ1C;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAOxB;AAED,+GAA+G;AAC/G,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASjD"}

package/dist/errors.js

@@ -1,4 +1,4 @@
-/** The flight that this caller joined in another process failed. `failure` is the error that its leader recorded. */
+/** The work of the flight that this caller joined failed. `failure` describes the error that its leader got. */
 export class FlightFailedError extends Error {
     key;
     failure;
@@ -10,9 +10,9 @@ export class FlightFailedError extends Error {
     }
 }
 /**
- * The holder of the flight that this caller joined stopped before the flight
- * had an outcome: its process stopped, its lease was lost, or its records
- * refused the outcome.
+ * The flight that this caller joined ended without an outcome: its leader's
+ * process stopped, or its leader lost the flight. The work is never run again
+ * for this caller; a new call starts a new flight.
  */
 export class FlightInterruptedError extends Error {
     key;
@@ -22,13 +22,15 @@ export class FlightInterruptedError extends Error {
         this.key = key;
     }
 }
-/** The record of the flight that this caller joined was gone before the caller read its outcome. */
-export class FlightOutcomeLostError extends Error {
-    key;
-    constructor(key) {
-        super(`The record of the flight of ${JSON.stringify(key)} that this caller joined was gone before the caller read its outcome.`);
-        this.name = 'FlightOutcomeLostError';
-        this.key = key;
+/** The parts of a thrown value that cross to the joiners. A value that is not an error keeps only its text. */
+export function failureOf(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 };
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qHAAqH;AACrH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,GAAG,CAAS;IACZ,OAAO,CAAgB;IAEhC,YAAY,GAAW,EAAE,OAAsB;QAC7C,KAAK,CACH,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,KAAK,CACH,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,4DAA4D,CACjG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,KAAK,CACH,+BAA+B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uEAAuE,CAC1H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,gHAAgH;AAChH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,GAAG,CAAS;IACZ,OAAO,CAAU;IAE1B,YAAY,GAAW,EAAE,OAAgB;QACvC,KAAK,CACH,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,KAAK,CACH,iBAAiB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,4DAA4D,CACjG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED,+GAA+G;AAC/G,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,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"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { type FlightValue, type RunOptions, SingleFlight, } from './single-flight.ts';
-export type { Finished, FlightRecords, LatestFlight, Outcome, RecordedError, Status, } from './flight-records.ts';
-export { FileFlightRecords, type FileFlightRecordsOptions, } from './file-flight-records.ts';
-export { SharedFlight, type SharedFlightOptions } from './shared-flight.ts';
-export { FlightFailedError, FlightInterruptedError, FlightOutcomeLostError, } from './errors.ts';
+export { type FlightValue, type RunOptions, SingleFlight, type SingleFlightOptions, } from './single-flight.ts';
+export type { Codec } from './codec.ts';
+export type { Failure } from './protocol/flight-protocol.ts';
+export { FlightFailedError, FlightInterruptedError } from './errors.ts';
+export { ProtocolVersionError } from './connection/protocol-version-error.ts';
+export { NetworkDirectoryError } from '@zukhruf/fs';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,OAAO,EACP,aAAa,EACb,MAAM,GACP,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { SingleFlight, } from "./single-flight.js";
-export { FileFlightRecords, } from "./file-flight-records.js";
-export { SharedFlight } from "./shared-flight.js";
-export { FlightFailedError, FlightInterruptedError, FlightOutcomeLostError, } from "./errors.js";
+export { FlightFailedError, FlightInterruptedError } from "./errors.js";
+export { ProtocolVersionError } from "./connection/protocol-version-error.js";
+export { NetworkDirectoryError } from '@zukhruf/fs';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,94 @@
+/** A leader's error as text, because an Error object cannot cross a process boundary. */
+export interface Failure {
+    readonly name: string;
+    readonly message: string;
+    /** The error's `code`, when it has one, as Node.js errors do. */
+    readonly code?: string | number;
+}
+/** How a flight landed: the value as the codec encoded it, or the leader's failure. */
+export type Outcome = {
+    value: string;
+} | {
+    failure: Failure;
+};
+/** Tokens and flights travel as decimal strings because JSON has no bigint. */
+export type FlightRequest = 
+/**
+ * Leads the flight of `key` when none is in progress, or joins the flight in
+ * progress. After a lost connection, a run that the coordinator had told
+ * which flight it joined is sent again with that flight's token: such a
+ * rejoin never leads, so a joiner whose leader died never runs the work
+ * again. A run that got no answer has joined nothing, and goes again as a
+ * plain run.
+ */
+{
+    op: 'run';
+    id: string;
+    key: string;
+    flight?: string;
+}
+/** The leader of `id` ends its flight with `outcome`. Kept by the client until the coordinator acknowledges it. */
+ | {
+    op: 'land';
+    id: string;
+    outcome: Outcome;
+}
+/** Withdraws a run that is not answered yet, or a joiner from its flight. */
+ | {
+    op: 'cancel';
+    id: string;
+}
+/** A leader from before a failover claims its flight again, during the new coordinator's grace window. */
+ | {
+    op: 'reassert';
+    id: string;
+    key: string;
+    token: string;
+};
+export type FlightResponse = 
+/** The run leads a new flight; `token` is its lease's fencing token. */
+{
+    op: 'lead';
+    id: string;
+    token: string;
+}
+/** The run joined the flight in progress, whose leader holds the token `flight`. */
+ | {
+    op: 'joined';
+    id: string;
+    flight: string;
+} | {
+    op: 'landed';
+    id: string;
+    outcome: Outcome;
+}
+/** The flight that the run joined ended without an outcome: its leader stopped or lost its lease. */
+ | {
+    op: 'interrupted';
+    id: string;
+}
+/** The coordinator handed a landing to the joiners. */
+ | {
+    op: 'ack';
+    id: string;
+}
+/** The flight of `id` is no longer its leader's: a reassertion or a landing came too late. */
+ | {
+    op: 'rejected';
+    id: string;
+}
+/** The coordinator does not know the request: it runs an older version. */
+ | {
+    op: 'unsupported';
+    id: string;
+};
+/** A request whose `op` this process may not know. A coordinator answers one it does not know with `unsupported`. */
+export interface RequestEnvelope {
+    op: string;
+    id: string;
+}
+export declare function isRequestEnvelope(message: unknown): message is RequestEnvelope;
+/** Messages arrive from another process, so their shape is checked before use. */
+export declare function isFlightRequest(message: unknown): message is FlightRequest;
+export declare function isFlightResponse(message: unknown): message is FlightResponse;
+//# sourceMappingURL=flight-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flight-protocol.d.ts","sourceRoot":"","sources":["../../src/protocol/flight-protocol.ts"],"names":[],"mappings":"AAIA,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED,uFAAuF;AACvF,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/D,+EAA+E;AAC/E,MAAM,MAAM,aAAa;AACvB;;;;;;;GAOG;AACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACzD,mHAAmH;GACjH;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAC9C,6EAA6E;GAC3E;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAC9B,0GAA0G;GACxG;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,cAAc;AACxB,wEAAwE;AACtE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC3C,oFAAoF;GAClF;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAChD,qGAAqG;GACnG;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACnC,uDAAuD;GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAC3B,8FAA8F;GAC5F;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAChC,2EAA2E;GACzE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,qHAAqH;AACrH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAKD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,eAAe,CAM5B;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,aAAa,CAiB1E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,cAAc,CAiB5E"}