@zyraxon-ai/core 19.0.5

package/dist/util/effect-flock.js

@@ -0,0 +1,179 @@
+import path from "path";
+import os from "os";
+import { randomUUID } from "crypto";
+import { Context, Effect, Function, Layer, Option, Schedule, Schema } from "effect";
+import { FSUtil } from "../fs-util";
+import { Global } from "../global";
+import { makeGlobalNode } from "../effect/app-node";
+import { Hash } from "./hash";
+export var EffectFlock;
+(function (EffectFlock) {
+    // ---------------------------------------------------------------------------
+    // Errors
+    // ---------------------------------------------------------------------------
+    class LockTimeoutError extends Schema.TaggedErrorClass()("LockTimeoutError", {
+        key: Schema.String,
+    }) {
+    }
+    EffectFlock.LockTimeoutError = LockTimeoutError;
+    class LockCompromisedError extends Schema.TaggedErrorClass()("LockCompromisedError", {
+        detail: Schema.String,
+    }) {
+    }
+    EffectFlock.LockCompromisedError = LockCompromisedError;
+    class ReleaseError extends Schema.TaggedErrorClass()("ReleaseError", {
+        detail: Schema.String,
+        cause: Schema.optional(Schema.Defect()),
+    }) {
+        get message() {
+            return this.detail;
+        }
+    }
+    /** Internal: signals "lock is held, retry later". Never leaks to callers. */
+    class NotAcquired extends Schema.TaggedErrorClass()("NotAcquired", {}) {
+    }
+    // ---------------------------------------------------------------------------
+    // Timing (baked in — no caller ever overrides these)
+    // ---------------------------------------------------------------------------
+    const STALE_MS = 60_000;
+    const TIMEOUT_MS = 5 * 60_000;
+    const BASE_DELAY_MS = 100;
+    const MAX_DELAY_MS = 2_000;
+    const HEARTBEAT_MS = Math.max(100, Math.floor(STALE_MS / 3));
+    const retrySchedule = Schedule.exponential(BASE_DELAY_MS, 1.7).pipe(Schedule.either(Schedule.spaced(MAX_DELAY_MS)), Schedule.jittered, Schedule.while((meta) => meta.elapsed < TIMEOUT_MS));
+    // ---------------------------------------------------------------------------
+    // Lock metadata schema
+    // ---------------------------------------------------------------------------
+    const LockMetaJson = Schema.fromJsonString(Schema.Struct({
+        token: Schema.String,
+        pid: Schema.Number,
+        hostname: Schema.String,
+        createdAt: Schema.String,
+    }));
+    const decodeMeta = Schema.decodeUnknownSync(LockMetaJson);
+    const encodeMeta = Schema.encodeSync(LockMetaJson);
+    class Service extends Context.Service()("EffectFlock") {
+    }
+    EffectFlock.Service = Service;
+    // ---------------------------------------------------------------------------
+    // Layer
+    // ---------------------------------------------------------------------------
+    function wall() {
+        return performance.timeOrigin + performance.now();
+    }
+    const mtimeMs = (info) => Option.getOrElse(info.mtime, () => new Date(0)).getTime();
+    const isPathGone = (e) => e.reason._tag === "NotFound" || e.reason._tag === "Unknown";
+    const layer = Layer.effect(Service, Effect.gen(function* () {
+        const global = yield* Global.Service;
+        const fs = yield* FSUtil.Service;
+        const lockRoot = path.join(global.state, "locks");
+        const hostname = os.hostname();
+        const ensuredDirs = new Set();
+        // -- helpers (close over fs) --
+        const safeStat = (file) => fs.stat(file).pipe(Effect.catchIf(isPathGone, () => Effect.void), Effect.orDie);
+        const forceRemove = (target) => fs.remove(target, { recursive: true }).pipe(Effect.ignore);
+        /** Atomic mkdir — returns true if created, false if already exists, dies on other errors. */
+        const atomicMkdir = (dir) => fs.makeDirectory(dir, { mode: 0o700 }).pipe(Effect.as(true), Effect.catchIf((e) => e.reason._tag === "AlreadyExists", () => Effect.succeed(false)), Effect.orDie);
+        /** Write with exclusive create — compromised error if file already exists. */
+        const exclusiveWrite = (filePath, content, lockDir, detail) => fs.writeFileString(filePath, content, { flag: "wx" }).pipe(Effect.catch(() => Effect.gen(function* () {
+            yield* forceRemove(lockDir);
+            return yield* new LockCompromisedError({ detail });
+        })));
+        const cleanStaleBreaker = Effect.fnUntraced(function* (breakerPath) {
+            const bs = yield* safeStat(breakerPath);
+            if (bs && wall() - mtimeMs(bs) > STALE_MS)
+                yield* forceRemove(breakerPath);
+            return false;
+        });
+        const ensureDir = Effect.fnUntraced(function* (dir) {
+            if (ensuredDirs.has(dir))
+                return;
+            yield* fs.makeDirectory(dir, { recursive: true }).pipe(Effect.orDie);
+            ensuredDirs.add(dir);
+        });
+        const isStale = Effect.fnUntraced(function* (lockDir, heartbeatPath, metaPath) {
+            const now = wall();
+            const hb = yield* safeStat(heartbeatPath);
+            if (hb)
+                return now - mtimeMs(hb) > STALE_MS;
+            const meta = yield* safeStat(metaPath);
+            if (meta)
+                return now - mtimeMs(meta) > STALE_MS;
+            const dir = yield* safeStat(lockDir);
+            if (!dir)
+                return false;
+            return now - mtimeMs(dir) > STALE_MS;
+        });
+        const tryAcquireLockDir = (lockDir, key) => Effect.gen(function* () {
+            const token = randomUUID();
+            const metaPath = path.join(lockDir, "meta.json");
+            const heartbeatPath = path.join(lockDir, "heartbeat");
+            // Atomic mkdir — the POSIX lock primitive
+            const created = yield* atomicMkdir(lockDir);
+            if (!created) {
+                if (!(yield* isStale(lockDir, heartbeatPath, metaPath)))
+                    return yield* new NotAcquired();
+                // Stale — race for breaker ownership
+                const breakerPath = lockDir + ".breaker";
+                const claimed = yield* fs.makeDirectory(breakerPath, { mode: 0o700 }).pipe(Effect.as(true), Effect.catchIf((e) => e.reason._tag === "AlreadyExists", () => cleanStaleBreaker(breakerPath)), Effect.catchIf(isPathGone, () => Effect.succeed(false)), Effect.orDie);
+                if (!claimed)
+                    return yield* new NotAcquired();
+                // We own the breaker — double-check staleness, nuke, recreate
+                const recreated = yield* Effect.gen(function* () {
+                    if (!(yield* isStale(lockDir, heartbeatPath, metaPath)))
+                        return false;
+                    yield* forceRemove(lockDir);
+                    return yield* atomicMkdir(lockDir);
+                }).pipe(Effect.ensuring(forceRemove(breakerPath)));
+                if (!recreated)
+                    return yield* new NotAcquired();
+            }
+            // We own the lock dir — write heartbeat + meta with exclusive create
+            yield* exclusiveWrite(heartbeatPath, "", lockDir, "heartbeat already existed");
+            const metaJson = encodeMeta({ token, pid: process.pid, hostname, createdAt: new Date().toISOString() });
+            yield* exclusiveWrite(metaPath, metaJson, lockDir, "meta.json already existed");
+            return { token, metaPath, heartbeatPath, lockDir };
+        }).pipe(Effect.withSpan("EffectFlock.tryAcquire", {
+            attributes: { key },
+        }));
+        // -- retry wrapper (preserves Handle type) --
+        const acquireHandle = (lockfile, key) => tryAcquireLockDir(lockfile, key).pipe(Effect.retry({
+            while: (err) => err._tag === "NotAcquired",
+            schedule: retrySchedule,
+        }), Effect.catchTag("NotAcquired", () => Effect.fail(new LockTimeoutError({ key }))));
+        // -- release --
+        const release = (handle) => Effect.gen(function* () {
+            const raw = yield* fs.readFileString(handle.metaPath).pipe(Effect.catch((err) => {
+                if (isPathGone(err))
+                    return Effect.die(new ReleaseError({ detail: "metadata missing" }));
+                return Effect.die(err);
+            }));
+            const parsed = yield* Effect.try({
+                try: () => decodeMeta(raw),
+                catch: (cause) => new ReleaseError({ detail: "metadata invalid", cause }),
+            }).pipe(Effect.orDie);
+            if (parsed.token !== handle.token)
+                return yield* Effect.die(new ReleaseError({ detail: "token mismatch" }));
+            yield* forceRemove(handle.lockDir);
+        });
+        // -- build service --
+        const acquire = Effect.fn("EffectFlock.acquire")(function* (key, dir) {
+            const lockDir = dir ?? lockRoot;
+            yield* ensureDir(lockDir);
+            const lockfile = path.join(lockDir, Hash.fast(key) + ".lock");
+            // acquireRelease: acquire is uninterruptible, release is guaranteed
+            const handle = yield* Effect.acquireRelease(acquireHandle(lockfile, key), (handle) => release(handle));
+            // Heartbeat fiber — scoped, so it's interrupted before release runs
+            yield* fs
+                .utimes(handle.heartbeatPath, new Date(), new Date())
+                .pipe(Effect.ignore, Effect.repeat(Schedule.spaced(HEARTBEAT_MS)), Effect.forkScoped);
+        });
+        const withLock = Function.dual((args) => Effect.isEffect(args[0]), (body, key, dir) => Effect.scoped(Effect.gen(function* () {
+            yield* acquire(key, dir);
+            return yield* body;
+        })));
+        return Service.of({ acquire, withLock });
+    }));
+    EffectFlock.node = makeGlobalNode({ service: Service, layer: layer, deps: [Global.node, FSUtil.node] });
+})(EffectFlock || (EffectFlock = {}));
+//# sourceMappingURL=effect-flock.js.map

package/dist/util/effect-flock.js.map

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

package/dist/util/encode.js

@@ -0,0 +1,50 @@
+export function base64Encode(value) {
+    const bytes = new TextEncoder().encode(value);
+    const binary = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+export function base64Decode(value) {
+    const binary = atob(value.replace(/-/g, "+").replace(/_/g, "/"));
+    const bytes = Uint8Array.from(binary, (c) => c.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}
+export async function hash(content, algorithm = "SHA-256") {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(content);
+    const hashBuffer = await crypto.subtle.digest(algorithm, data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+    return hashHex;
+}
+export function checksum(content) {
+    if (!content)
+        return undefined;
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < content.length; i++) {
+        hash ^= content.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+export function sampledChecksum(content, limit = 500_000) {
+    if (!content)
+        return undefined;
+    if (content.length <= limit)
+        return checksum(content);
+    const size = 4096;
+    const points = [
+        0,
+        Math.floor(content.length * 0.25),
+        Math.floor(content.length * 0.5),
+        Math.floor(content.length * 0.75),
+        content.length - size,
+    ];
+    const hashes = points
+        .map((point) => {
+        const start = Math.max(0, Math.min(content.length - size, point - Math.floor(size / 2)));
+        return checksum(content.slice(start, start + size)) ?? "";
+    })
+        .join(":");
+    return `${content.length}:${hashes}`;
+}
+//# sourceMappingURL=encode.js.map

package/dist/util/encode.js.map

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

package/dist/util/error.js

@@ -0,0 +1,46 @@
+import { Schema } from "effect";
+export class NamedError extends Error {
+    static hasName(error, name) {
+        return (typeof error === "object" && error !== null && "name" in error && error.name === name);
+    }
+    static create(name, data) {
+        return NamedError.createSchemaClass(name, Schema.isSchema(data) ? data : Schema.Struct(data));
+    }
+    static createSchemaClass(name, data) {
+        const schema = Schema.Struct({
+            name: Schema.Literal(name),
+            data,
+        }).annotate({ identifier: name });
+        const result = class extends NamedError {
+            data;
+            static Schema = schema;
+            static EffectSchema = schema;
+            static tag = name;
+            name = name;
+            constructor(data, options) {
+                super(name, options);
+                this.data = data;
+                this.name = name;
+            }
+            static isInstance(input) {
+                return NamedError.hasName(input, name);
+            }
+            schema() {
+                return schema;
+            }
+            toObject() {
+                return {
+                    name: name,
+                    data: this.data,
+                };
+            }
+        };
+        Object.defineProperty(result, "name", { value: name });
+        return result;
+    }
+    static Unknown = NamedError.create("UnknownError", {
+        message: Schema.String,
+        ref: Schema.optional(Schema.String),
+    });
+}
+//# sourceMappingURL=error.js.map

package/dist/util/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,OAAgB,UAAW,SAAQ,KAAK;IAI5C,MAAM,CAAC,OAAO,CAAC,KAAc,EAAE,IAAY;QACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAK,KAAiC,CAAC,IAAI,KAAK,IAAI,CACnH,CAAA;IACH,CAAC;IAUD,MAAM,CAAC,MAAM,CAAsB,IAAU,EAAE,IAAuC;QACpF,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/F,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAqD,IAAU,EAAE,IAAgB;QAC/G,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAC1B,IAAI;SACL,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;QAGjC,MAAM,MAAM,GAAG,KAAM,SAAQ,UAAU;YAQnB;YAPX,MAAM,CAAU,MAAM,GAAG,MAAM,CAAA;YAC/B,MAAM,CAAU,YAAY,GAAG,MAAM,CAAA;YACrC,MAAM,CAAU,GAAG,GAAG,IAAI,CAAA;YAER,IAAI,GAAG,IAAI,CAAA;YAEpC,YACkB,IAAU,EAC1B,OAAsB;gBAEtB,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBAHJ,SAAI,GAAJ,IAAI,CAAM;gBAI1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;YAClB,CAAC;YAED,MAAM,CAAC,UAAU,CAAC,KAAc;gBAC9B,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACxC,CAAC;YAED,MAAM;gBACJ,OAAO,MAAM,CAAA;YACf,CAAC;YAED,QAAQ;gBACN,OAAO;oBACL,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAA;YACH,CAAC;SACF,CAAA;QACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,MAAM,CAAU,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,cAAc,EAAE;QACjE,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;KACpC,CAAC,CAAA"}

package/dist/util/flock.js

@@ -0,0 +1,274 @@
+import path from "path";
+import os from "os";
+import { randomBytes, randomUUID } from "crypto";
+import { mkdir, readFile, rm, stat, utimes, writeFile } from "fs/promises";
+import { Hash } from "./hash";
+import { Effect } from "effect";
+export var Flock;
+(function (Flock) {
+    let global;
+    function setGlobal(g) {
+        global = g;
+    }
+    Flock.setGlobal = setGlobal;
+    const root = () => {
+        if (!global)
+            throw new Error("Flock global not set");
+        return path.join(global.state, "locks");
+    };
+    // Defaults for callers that do not provide timing options.
+    const defaultOpts = {
+        staleMs: 60_000,
+        timeoutMs: 5 * 60_000,
+        baseDelayMs: 100,
+        maxDelayMs: 2_000,
+    };
+    function code(err) {
+        if (typeof err !== "object" || err === null || !("code" in err))
+            return;
+        const value = err.code;
+        if (typeof value !== "string")
+            return;
+        return value;
+    }
+    function sleep(ms, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(signal.reason ?? new Error("Aborted"));
+                return;
+            }
+            let timer;
+            const done = () => {
+                signal?.removeEventListener("abort", abort);
+                resolve();
+            };
+            const abort = () => {
+                if (timer) {
+                    clearTimeout(timer);
+                }
+                signal?.removeEventListener("abort", abort);
+                reject(signal?.reason ?? new Error("Aborted"));
+            };
+            signal?.addEventListener("abort", abort, { once: true });
+            timer = setTimeout(done, ms);
+        });
+    }
+    function jitter(ms) {
+        const j = Math.floor(ms * 0.3);
+        const d = Math.floor(Math.random() * (2 * j + 1)) - j;
+        return Math.max(0, ms + d);
+    }
+    function mono() {
+        return performance.now();
+    }
+    function wall() {
+        return performance.timeOrigin + mono();
+    }
+    async function stats(file) {
+        try {
+            return await stat(file);
+        }
+        catch (err) {
+            const errCode = code(err);
+            if (errCode === "ENOENT" || errCode === "ENOTDIR")
+                return;
+            throw err;
+        }
+    }
+    async function stale(lockDir, heartbeatPath, metaPath, staleMs) {
+        // Stale detection allows automatic recovery after crashed owners.
+        const now = wall();
+        const heartbeat = await stats(heartbeatPath);
+        if (heartbeat) {
+            return now - heartbeat.mtimeMs > staleMs;
+        }
+        const meta = await stats(metaPath);
+        if (meta) {
+            return now - meta.mtimeMs > staleMs;
+        }
+        const dir = await stats(lockDir);
+        if (!dir) {
+            return false;
+        }
+        return now - dir.mtimeMs > staleMs;
+    }
+    async function tryAcquireLockDir(lockDir, opts) {
+        const token = randomUUID?.() ?? randomBytes(16).toString("hex");
+        const metaPath = path.join(lockDir, "meta.json");
+        const heartbeatPath = path.join(lockDir, "heartbeat");
+        try {
+            await mkdir(lockDir, { mode: 0o700 });
+        }
+        catch (err) {
+            if (code(err) !== "EEXIST") {
+                throw err;
+            }
+            if (!(await stale(lockDir, heartbeatPath, metaPath, opts.staleMs))) {
+                return { acquired: false };
+            }
+            const breakerPath = lockDir + ".breaker";
+            try {
+                await mkdir(breakerPath, { mode: 0o700 });
+            }
+            catch (claimErr) {
+                const errCode = code(claimErr);
+                if (errCode === "EEXIST") {
+                    const breaker = await stats(breakerPath);
+                    if (breaker && wall() - breaker.mtimeMs > opts.staleMs) {
+                        await rm(breakerPath, { recursive: true, force: true }).catch(() => undefined);
+                    }
+                    return { acquired: false };
+                }
+                if (errCode === "ENOENT" || errCode === "ENOTDIR") {
+                    return { acquired: false };
+                }
+                throw claimErr;
+            }
+            try {
+                // Breaker ownership ensures only one contender performs stale cleanup.
+                if (!(await stale(lockDir, heartbeatPath, metaPath, opts.staleMs))) {
+                    return { acquired: false };
+                }
+                await rm(lockDir, { recursive: true, force: true });
+                try {
+                    await mkdir(lockDir, { mode: 0o700 });
+                }
+                catch (retryErr) {
+                    const errCode = code(retryErr);
+                    if (errCode === "EEXIST" || errCode === "ENOTEMPTY") {
+                        return { acquired: false };
+                    }
+                    throw retryErr;
+                }
+            }
+            finally {
+                await rm(breakerPath, { recursive: true, force: true }).catch(() => undefined);
+            }
+        }
+        const meta = {
+            token,
+            pid: process.pid,
+            hostname: os.hostname(),
+            createdAt: new Date().toISOString(),
+        };
+        await writeFile(heartbeatPath, "", { flag: "wx" }).catch(async () => {
+            await rm(lockDir, { recursive: true, force: true });
+            throw new Error("Lock acquired but heartbeat already existed (possible compromise).");
+        });
+        await writeFile(metaPath, JSON.stringify(meta, null, 2), { flag: "wx" }).catch(async () => {
+            await rm(lockDir, { recursive: true, force: true });
+            throw new Error("Lock acquired but meta.json already existed (possible compromise).");
+        });
+        let timer;
+        const startHeartbeat = (intervalMs = Math.max(100, Math.floor(opts.staleMs / 3))) => {
+            if (timer)
+                return;
+            // Heartbeat prevents long critical sections from being evicted as stale.
+            timer = setInterval(() => {
+                const t = new Date();
+                void utimes(heartbeatPath, t, t).catch(() => undefined);
+            }, intervalMs);
+            timer.unref?.();
+        };
+        const release = async () => {
+            if (timer) {
+                clearInterval(timer);
+                timer = undefined;
+            }
+            const current = await readFile(metaPath, "utf8")
+                .then((raw) => {
+                const parsed = JSON.parse(raw);
+                if (!parsed || typeof parsed !== "object")
+                    return {};
+                return {
+                    token: "token" in parsed && typeof parsed.token === "string" ? parsed.token : undefined,
+                };
+            })
+                .catch((err) => {
+                const errCode = code(err);
+                if (errCode === "ENOENT" || errCode === "ENOTDIR") {
+                    throw new Error("Refusing to release: lock is compromised (metadata missing).");
+                }
+                if (err instanceof SyntaxError) {
+                    throw new Error("Refusing to release: lock is compromised (metadata invalid).");
+                }
+                throw err;
+            });
+            // Token check prevents deleting a lock that was re-acquired by another process.
+            if (current.token !== token) {
+                throw new Error("Refusing to release: lock token mismatch (not the owner).");
+            }
+            await rm(lockDir, { recursive: true, force: true });
+        };
+        return {
+            acquired: true,
+            startHeartbeat,
+            release,
+        };
+    }
+    async function acquireLockDir(lockDir, input, opts) {
+        const stop = mono() + opts.timeoutMs;
+        let attempt = 0;
+        let waited = 0;
+        let delay = opts.baseDelayMs;
+        while (true) {
+            input.signal?.throwIfAborted();
+            const res = await tryAcquireLockDir(lockDir, opts);
+            if (res.acquired) {
+                return res;
+            }
+            if (mono() > stop) {
+                throw new Error(`Timed out waiting for lock: ${input.key}`);
+            }
+            attempt += 1;
+            const ms = jitter(delay);
+            await input.onWait?.({
+                key: input.key,
+                attempt,
+                delay: ms,
+                waited,
+            });
+            await sleep(ms, input.signal);
+            waited += ms;
+            delay = Math.min(opts.maxDelayMs, Math.floor(delay * 1.7));
+        }
+    }
+    async function acquire(key, input = {}) {
+        input.signal?.throwIfAborted();
+        const cfg = {
+            staleMs: input.staleMs ?? defaultOpts.staleMs,
+            timeoutMs: input.timeoutMs ?? defaultOpts.timeoutMs,
+            baseDelayMs: input.baseDelayMs ?? defaultOpts.baseDelayMs,
+            maxDelayMs: input.maxDelayMs ?? defaultOpts.maxDelayMs,
+        };
+        const dir = input.dir ?? root();
+        await mkdir(dir, { recursive: true });
+        const lockfile = path.join(dir, Hash.fast(key) + ".lock");
+        const lock = await acquireLockDir(lockfile, {
+            key,
+            onWait: input.onWait,
+            signal: input.signal,
+        }, cfg);
+        lock.startHeartbeat();
+        const release = () => lock.release();
+        return {
+            release,
+            [Symbol.asyncDispose]() {
+                return release();
+            },
+        };
+    }
+    Flock.acquire = acquire;
+    async function withLock(key, fn, input = {}) {
+        await using _ = await acquire(key, input);
+        input.signal?.throwIfAborted();
+        return await fn();
+    }
+    Flock.withLock = withLock;
+    Flock.effect = Effect.fn("Flock.effect")(function* (key, input = {}) {
+        return yield* Effect.acquireRelease(Effect.promise((signal) => Flock.acquire(key, { ...input, signal })).pipe(Effect.withSpan("Flock.acquire", {
+            attributes: { key },
+        })), (lock) => Effect.promise(() => lock.release()).pipe(Effect.withSpan("Flock.release"))).pipe(Effect.asVoid);
+    });
+})(Flock || (Flock = {}));
+//# sourceMappingURL=flock.js.map

package/dist/util/flock.js.map

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

package/dist/util/glob.js

@@ -0,0 +1,27 @@
+import { glob, globSync } from "glob";
+import { minimatch } from "minimatch";
+export var Glob;
+(function (Glob) {
+    function toGlobOptions(options) {
+        return {
+            cwd: options.cwd,
+            absolute: options.absolute,
+            dot: options.dot,
+            follow: options.symlink ?? false,
+            nodir: options.include !== "all",
+        };
+    }
+    async function scan(pattern, options = {}) {
+        return glob(pattern, toGlobOptions(options));
+    }
+    Glob.scan = scan;
+    function scanSync(pattern, options = {}) {
+        return globSync(pattern, toGlobOptions(options));
+    }
+    Glob.scanSync = scanSync;
+    function match(pattern, filepath) {
+        return minimatch(filepath, pattern, { dot: true });
+    }
+    Glob.match = match;
+})(Glob || (Glob = {}));
+//# sourceMappingURL=glob.js.map

package/dist/util/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/util/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAoB,MAAM,MAAM,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,KAAW,IAAI,CA8BpB;AA9BD,WAAiB,IAAI;IASnB,SAAS,aAAa,CAAC,OAAgB;QACrC,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YAChC,KAAK,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK;SACjC,CAAA;IACH,CAAC;IAEM,KAAK,UAAU,IAAI,CAAC,OAAe,EAAE,UAAmB,EAAE;QAC/D,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAsB,CAAA;IACnE,CAAC;IAFqB,SAAI,OAEzB,CAAA;IAED,SAAgB,QAAQ,CAAC,OAAe,EAAE,UAAmB,EAAE;QAC7D,OAAO,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAa,CAAA;IAC9D,CAAC;IAFe,aAAQ,WAEvB,CAAA;IAED,SAAgB,KAAK,CAAC,OAAe,EAAE,QAAgB;QACrD,OAAO,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC;IAFe,UAAK,QAEpB,CAAA;AACH,CAAC,EA9BgB,IAAI,KAAJ,IAAI,QA8BpB"}

package/dist/util/hash.js

@@ -0,0 +1,13 @@
+import { createHash } from "crypto";
+export var Hash;
+(function (Hash) {
+    function fast(input) {
+        return createHash("sha1").update(input).digest("hex");
+    }
+    Hash.fast = fast;
+    function sha256(input) {
+        return createHash("sha256").update(input).digest("hex");
+    }
+    Hash.sha256 = sha256;
+})(Hash || (Hash = {}));
+//# sourceMappingURL=hash.js.map

package/dist/util/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/util/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,MAAM,KAAW,IAAI,CAQpB;AARD,WAAiB,IAAI;IACnB,SAAgB,IAAI,CAAC,KAAsB;QACzC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;IAFe,SAAI,OAEnB,CAAA;IAED,SAAgB,MAAM,CAAC,KAAsB;QAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACzD,CAAC;IAFe,WAAM,SAErB,CAAA;AACH,CAAC,EARgB,IAAI,KAAJ,IAAI,QAQpB"}