@alchemy.run/node-utils 0.0.0

package/lib/adapter.d.ts

@@ -0,0 +1,14 @@
+type AnyFs = Record<string, any>;
+type AsyncMethod = (...args: any[]) => void;
+export declare function toPromise<T = any>(method: AsyncMethod): (...args: any[]) => Promise<T>;
+export declare function toSync<T = any>(method: AsyncMethod): (...args: any[]) => T;
+export interface SyncOptions {
+    fs?: AnyFs;
+    retries?: number | {
+        retries?: number;
+    };
+    [key: string]: any;
+}
+export declare function toSyncOptions(options?: SyncOptions): SyncOptions;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEjC,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AA0B5C,wBAAgB,SAAS,CAAC,CAAC,GAAG,GAAG,EAC/B,MAAM,EAAE,WAAW,GAClB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAahC;AAED,wBAAgB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAkB1E;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAoBhE"}

package/lib/adapter.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+function createSyncFs(fs) {
+    const methods = ["mkdir", "realpath", "stat", "rmdir", "utimes"];
+    const newFs = { ...fs };
+    methods.forEach((method) => {
+        newFs[method] = (...args) => {
+            const callback = args.pop();
+            let ret;
+            try {
+                ret = fs[`${method}Sync`](...args);
+            }
+            catch (err) {
+                return callback(err);
+            }
+            callback(null, ret);
+        };
+    });
+    return newFs;
+}
+// ----------------------------------------------------------
+export function toPromise(method) {
+    return (...args) => new Promise((resolve, reject) => {
+        args.push((err, result) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(result);
+            }
+        });
+        method(...args);
+    });
+}
+export function toSync(method) {
+    return (...args) => {
+        let err;
+        let result;
+        args.push((_err, _result) => {
+            err = _err;
+            result = _result;
+        });
+        method(...args);
+        if (err) {
+            throw err;
+        }
+        return result;
+    };
+}
+export function toSyncOptions(options) {
+    // Shallow clone options because we are going to mutate them
+    const next = { ...options };
+    // Transform fs to use the sync methods instead
+    next.fs = createSyncFs(next.fs || fs);
+    // Retries are not allowed because it requires the flow to be sync
+    if ((typeof next.retries === "number" && next.retries > 0) ||
+        (next.retries &&
+            typeof next.retries.retries === "number" &&
+            next.retries.retries > 0)) {
+        throw Object.assign(new Error("Cannot use retries with the sync api"), {
+            code: "ESYNC",
+        });
+    }
+    return next;
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAMzB,SAAS,YAAY,CAAC,EAAS;IAC7B,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;IAC1E,MAAM,KAAK,GAAU,EAAE,GAAG,EAAE,EAAE,CAAC;IAE/B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAiB,CAAC;YAC3C,IAAI,GAAG,CAAC;YAER,IAAI,CAAC;gBACH,GAAG,GAAG,EAAE,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,GAA4B,CAAC,CAAC;YAChD,CAAC;YAED,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAE7D,MAAM,UAAU,SAAS,CACvB,MAAmB;IAEnB,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CACxB,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAiC,EAAE,MAAS,EAAE,EAAE;YACzD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,MAAM,CAAU,MAAmB;IACjD,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;QACxB,IAAI,GAA6C,CAAC;QAClD,IAAI,MAAqB,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,CAAC,IAAkC,EAAE,OAAU,EAAE,EAAE;YAC3D,GAAG,GAAG,IAAI,CAAC;YACX,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAEhB,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO,MAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,4DAA4D;IAC5D,MAAM,IAAI,GAAgB,EAAE,GAAG,OAAO,EAAE,CAAC;IAEzC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,kEAAkE;IAClE,IACE,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACtD,CAAC,IAAI,CAAC,OAAO;YACX,OAAQ,IAAI,CAAC,OAAgC,CAAC,OAAO,KAAK,QAAQ;YAChE,IAAI,CAAC,OAAgC,CAAC,OAAkB,GAAG,CAAC,CAAC,EACjE,CAAC;QACD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,EAAE;YACrE,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/exit-hook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Lightweight replacement for the `exit-hook` npm package.
+ *
+ * The third-party `exit-hook` registers process listeners (`exit`, `SIGINT`,
+ * `SIGTERM`, and `message`) that are never removed — even after every
+ * callback has been unregistered.  Those dangling listeners are harmless in
+ * long-running processes, but in short-lived child processes (e.g. those
+ * spawned by `node --test`) they can prevent clean exit by holding refs on
+ * handles such as the IPC channel.
+ *
+ * This module tracks the number of active registrations and removes **all**
+ * process listeners once the last registration is unregistered, so they
+ * cannot keep the event loop alive after dispose.
+ */
+/**
+ * Register a callback to run when the process exits.  Returns a function
+ * that unregisters the callback.  When the last callback is unregistered,
+ * all underlying process listeners are removed so they cannot keep the
+ * event loop alive.
+ */
+export declare function exitHook(callback: () => void): () => void;
+//# sourceMappingURL=exit-hook.d.ts.map

package/lib/exit-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-hook.d.ts","sourceRoot":"","sources":["../src/exit-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA+DH;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAazD"}

package/lib/exit-hook.js

@@ -0,0 +1,86 @@
+/**
+ * Lightweight replacement for the `exit-hook` npm package.
+ *
+ * The third-party `exit-hook` registers process listeners (`exit`, `SIGINT`,
+ * `SIGTERM`, and `message`) that are never removed — even after every
+ * callback has been unregistered.  Those dangling listeners are harmless in
+ * long-running processes, but in short-lived child processes (e.g. those
+ * spawned by `node --test`) they can prevent clean exit by holding refs on
+ * handles such as the IPC channel.
+ *
+ * This module tracks the number of active registrations and removes **all**
+ * process listeners once the last registration is unregistered, so they
+ * cannot keep the event loop alive after dispose.
+ */
+const callbacks = new Set();
+let registered = false;
+let called = false;
+function runCallbacks() {
+    if (called) {
+        return;
+    }
+    called = true;
+    for (const callback of callbacks) {
+        callback();
+    }
+}
+function onExit() {
+    runCallbacks();
+}
+function onSignalInt() {
+    runCallbacks();
+    // eslint-disable-next-line unicorn/no-process-exit -- intentional: replicate default SIGINT behavior
+    process.exit(128 + 2);
+}
+function onSignalTerm() {
+    runCallbacks();
+    // eslint-disable-next-line unicorn/no-process-exit -- intentional: replicate default SIGTERM behavior
+    process.exit(128 + 15);
+}
+function onMessage(message) {
+    if (message === "shutdown") {
+        runCallbacks();
+        // eslint-disable-next-line unicorn/no-process-exit -- intentional: PM2 graceful shutdown
+        process.exit(0);
+    }
+}
+function addListeners() {
+    registered = true;
+    called = false;
+    process.on("exit", onExit);
+    process.on("SIGINT", onSignalInt);
+    process.on("SIGTERM", onSignalTerm);
+    // Only listen for IPC "shutdown" messages (PM2 support) when the process
+    // actually has an IPC channel.  Even without this guard the listener is
+    // harmless when there is no channel, but being explicit avoids any
+    // accidental ref of a future channel.
+    if (process.send !== undefined) {
+        process.on("message", onMessage);
+    }
+}
+function removeListeners() {
+    registered = false;
+    process.removeListener("exit", onExit);
+    process.removeListener("SIGINT", onSignalInt);
+    process.removeListener("SIGTERM", onSignalTerm);
+    process.removeListener("message", onMessage);
+}
+/**
+ * Register a callback to run when the process exits.  Returns a function
+ * that unregisters the callback.  When the last callback is unregistered,
+ * all underlying process listeners are removed so they cannot keep the
+ * event loop alive.
+ */
+export function exitHook(callback) {
+    callbacks.add(callback);
+    if (!registered) {
+        addListeners();
+    }
+    return () => {
+        callbacks.delete(callback);
+        if (callbacks.size === 0 && registered) {
+            removeListeners();
+        }
+    };
+}
+//# sourceMappingURL=exit-hook.js.map

package/lib/exit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-hook.js","sourceRoot":"","sources":["../src/exit-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AACxC,IAAI,UAAU,GAAG,KAAK,CAAC;AACvB,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,SAAS,YAAY;IACnB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IACD,MAAM,GAAG,IAAI,CAAC;IACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,MAAM;IACb,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,WAAW;IAClB,YAAY,EAAE,CAAC;IACf,qGAAqG;IACrG,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,YAAY;IACnB,YAAY,EAAE,CAAC;IACf,sGAAsG;IACtG,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,SAAS,CAAC,OAAgB;IACjC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,YAAY,EAAE,CAAC;QACf,yFAAyF;QACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,UAAU,GAAG,IAAI,CAAC;IAClB,MAAM,GAAG,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACpC,yEAAyE;IACzE,wEAAwE;IACxE,mEAAmE;IACnE,sCAAsC;IACtC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,UAAU,GAAG,KAAK,CAAC;IACnB,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAChD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAoB;IAC3C,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAExB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACvC,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+import type { CheckOptions, LockOptions, ReleaseFn, UnlockOptions } from "./lockfile.ts";
+export type { CheckOptions, LockOptions, ReleaseFn, UnlockOptions };
+export declare function lock(file: string, options?: LockOptions): Promise<() => Promise<void>>;
+export declare function lockSync(file: string, options?: LockOptions): () => void;
+export declare function unlock(file: string, options?: UnlockOptions): Promise<void>;
+export declare function unlockSync(file: string, options?: UnlockOptions): void;
+export declare function check(file: string, options?: CheckOptions): Promise<boolean>;
+export declare function checkSync(file: string, options?: CheckOptions): boolean;
+export default lock;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACd,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEpE,wBAAsB,IAAI,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAI9B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAOxE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAEtE;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAEvE;AAED,eAAe,IAAI,CAAC"}

package/lib/index.js

@@ -0,0 +1,24 @@
+import { toPromise, toSync, toSyncOptions } from "./adapter.js";
+import * as lockfile from "./lockfile.js";
+export async function lock(file, options) {
+    const release = await toPromise(lockfile.lock)(file, options);
+    return toPromise(release);
+}
+export function lockSync(file, options) {
+    const release = toSync(lockfile.lock)(file, toSyncOptions(options));
+    return toSync(release);
+}
+export function unlock(file, options) {
+    return toPromise(lockfile.unlock)(file, options);
+}
+export function unlockSync(file, options) {
+    return toSync(lockfile.unlock)(file, toSyncOptions(options));
+}
+export function check(file, options) {
+    return toPromise(lockfile.check)(file, options);
+}
+export function checkSync(file, options) {
+    return toSync(lockfile.check)(file, toSyncOptions(options));
+}
+export default lock;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOhE,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAI1C,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,IAAY,EACZ,OAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAY,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzE,OAAO,SAAS,CAAO,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAqB;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAY,QAAQ,CAAC,IAAI,CAAC,CAC9C,IAAI,EACJ,aAAa,CAAC,OAAO,CAAC,CACvB,CAAC;IAEF,OAAO,MAAM,CAAO,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,OAAuB;IAC1D,OAAO,SAAS,CAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAuB;IAC9D,OAAO,MAAM,CAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,OAAsB;IACxD,OAAO,SAAS,CAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAsB;IAC5D,OAAO,MAAM,CAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,eAAe,IAAI,CAAC"}

package/lib/lockfile.d.ts

@@ -0,0 +1,53 @@
+import type { MtimePrecision } from "./mtime-precision.ts";
+import * as retry from "./retry.ts";
+type AnyFs = Record<string, any>;
+export interface LockOptions {
+    stale?: number;
+    update?: number | null;
+    realpath?: boolean;
+    retries?: number | retry.OperationOptions;
+    fs?: AnyFs;
+    onCompromised?: (err: Error) => void;
+    lockfilePath?: string;
+}
+interface ResolvedLockOptions {
+    stale: number;
+    update: number;
+    realpath: boolean;
+    retries: retry.OperationOptions;
+    fs: AnyFs;
+    onCompromised: (err: Error) => void;
+    lockfilePath?: string;
+}
+export interface UnlockOptions {
+    realpath?: boolean;
+    fs?: AnyFs;
+    lockfilePath?: string;
+}
+export interface CheckOptions {
+    stale?: number;
+    realpath?: boolean;
+    fs?: AnyFs;
+    lockfilePath?: string;
+}
+interface InternalLock {
+    lockfilePath: string;
+    mtime: Date;
+    mtimePrecision: MtimePrecision;
+    options: ResolvedLockOptions;
+    lastUpdate: number;
+    updateDelay?: number | null;
+    updateTimeout?: ReturnType<typeof setTimeout> | null;
+    released?: boolean;
+}
+type ReleaseCallback = (err?: NodeJS.ErrnoException | null) => void;
+export type ReleaseFn = (releasedCallback?: ReleaseCallback) => void;
+type LockCallback = (err: NodeJS.ErrnoException | null, release?: ReleaseFn) => void;
+type UnlockCallback = (err?: NodeJS.ErrnoException | null) => void;
+type CheckCallback = (err: NodeJS.ErrnoException | null, locked?: boolean) => void;
+export declare function lock(file: string, options: LockOptions | undefined, callback: LockCallback): void;
+export declare function unlock(file: string, options: UnlockOptions | undefined, callback: UnlockCallback): void;
+export declare function check(file: string, options: CheckOptions | undefined, callback: CheckCallback): void;
+export declare function getLocks(): Record<string, InternalLock>;
+export {};
+//# sourceMappingURL=lockfile.d.ts.map

package/lib/lockfile.d.ts.map

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

package/lib/lockfile.js

@@ -0,0 +1,287 @@
+import fs from "node:fs";
+import path from "node:path";
+import { exitHook } from "./exit-hook.js";
+import * as mtimePrecision from "./mtime-precision.js";
+import * as retry from "./retry.js";
+const locks = {};
+function getLockFile(file, options) {
+    return options.lockfilePath || `${file}.lock`;
+}
+function resolveCanonicalPath(file, options, callback) {
+    if (!options.realpath) {
+        return callback(null, path.resolve(file));
+    }
+    // Use realpath to resolve symlinks
+    // It also resolves relative paths
+    options.fs.realpath(file, callback);
+}
+function acquireLock(file, options, callback) {
+    const lockfilePath = getLockFile(file, options);
+    // Use mkdir to create the lockfile (atomic operation)
+    options.fs.mkdir(lockfilePath, (err) => {
+        if (!err) {
+            // At this point, we acquired the lock!
+            // Probe the mtime precision
+            return mtimePrecision.probe(lockfilePath, options.fs, (err, mtime, precision) => {
+                /* istanbul ignore if */
+                if (err) {
+                    options.fs.rmdir(lockfilePath, () => { });
+                    return callback(err);
+                }
+                callback(null, mtime, precision);
+            });
+        }
+        // If error is not EEXIST then some other error occurred while locking
+        if (err.code !== "EEXIST") {
+            return callback(err);
+        }
+        // Otherwise, check if lock is stale by analyzing the file mtime
+        if (options.stale <= 0) {
+            return callback(Object.assign(new Error("Lock file is already being held"), {
+                code: "ELOCKED",
+                file,
+            }));
+        }
+        options.fs.stat(lockfilePath, (err, stat) => {
+            if (err) {
+                // Retry if the lockfile has been removed (meanwhile)
+                // Skip stale check to avoid recursiveness
+                if (err.code === "ENOENT") {
+                    return acquireLock(file, { ...options, stale: 0 }, callback);
+                }
+                return callback(err);
+            }
+            if (!isLockStale(stat, options)) {
+                return callback(Object.assign(new Error("Lock file is already being held"), {
+                    code: "ELOCKED",
+                    file,
+                }));
+            }
+            // If it's stale, remove it and try again!
+            // Skip stale check to avoid recursiveness
+            removeLock(file, options, (err) => {
+                if (err) {
+                    return callback(err);
+                }
+                acquireLock(file, { ...options, stale: 0 }, callback);
+            });
+        });
+    });
+}
+function isLockStale(stat, options) {
+    return stat.mtime.getTime() < Date.now() - options.stale;
+}
+function removeLock(file, options, callback) {
+    options.fs.rmdir(getLockFile(file, options), (err) => {
+        if (err && err.code !== "ENOENT") {
+            return callback(err);
+        }
+        callback();
+    });
+}
+function updateLock(file, options) {
+    const lock = locks[file];
+    /* istanbul ignore if */
+    if (lock.updateTimeout) {
+        return;
+    }
+    lock.updateDelay = lock.updateDelay || options.update;
+    lock.updateTimeout = setTimeout(() => {
+        lock.updateTimeout = null;
+        // Stat the file to check if mtime is still ours
+        // If it is, we can still recover from a system sleep or a busy event loop
+        options.fs.stat(lock.lockfilePath, (err, stat) => {
+            const isOverThreshold = lock.lastUpdate + options.stale < Date.now();
+            // If it failed to update the lockfile, keep trying unless
+            // the lockfile was deleted or we are over the threshold
+            if (err) {
+                if (err.code === "ENOENT" || isOverThreshold) {
+                    return setLockAsCompromised(file, lock, Object.assign(err, { code: "ECOMPROMISED" }));
+                }
+                lock.updateDelay = 1000;
+                return updateLock(file, options);
+            }
+            const isMtimeOurs = lock.mtime.getTime() === stat.mtime.getTime();
+            if (!isMtimeOurs) {
+                return setLockAsCompromised(file, lock, Object.assign(new Error("Unable to update lock within the stale threshold"), { code: "ECOMPROMISED" }));
+            }
+            const mtime = mtimePrecision.getMtime(lock.mtimePrecision);
+            options.fs.utimes(lock.lockfilePath, mtime, mtime, (err) => {
+                const isOverThreshold = lock.lastUpdate + options.stale < Date.now();
+                if (lock.released) {
+                    return;
+                }
+                // If it failed to update the lockfile, keep trying unless
+                // the lockfile was deleted or we are over the threshold
+                if (err) {
+                    if (err.code === "ENOENT" || isOverThreshold) {
+                        return setLockAsCompromised(file, lock, Object.assign(err, { code: "ECOMPROMISED" }));
+                    }
+                    lock.updateDelay = 1000;
+                    return updateLock(file, options);
+                }
+                // All ok, keep updating..
+                lock.mtime = mtime;
+                lock.lastUpdate = Date.now();
+                lock.updateDelay = null;
+                updateLock(file, options);
+            });
+        });
+    }, lock.updateDelay);
+    // Unref the timer so that the nodejs process can exit freely
+    // This is safe because all acquired locks will be automatically released
+    // on process exit
+    // We first check that `lock.updateTimeout.unref` exists because some users
+    // may be using this module outside of NodeJS (e.g., in an electron app),
+    // and in those cases `setTimeout` returns an integer.
+    /* istanbul ignore else */
+    if (lock.updateTimeout &&
+        lock.updateTimeout.unref) {
+        lock.updateTimeout.unref();
+    }
+}
+function setLockAsCompromised(file, lock, err) {
+    lock.released = true;
+    // Cancel lock mtime update
+    /* istanbul ignore if */
+    if (lock.updateTimeout) {
+        clearTimeout(lock.updateTimeout);
+    }
+    if (locks[file] === lock) {
+        delete locks[file];
+    }
+    lock.options.onCompromised(err);
+}
+// ----------------------------------------------------------
+export function lock(file, options, callback) {
+    /* istanbul ignore next */
+    const merged = {
+        stale: 10000,
+        update: null,
+        realpath: true,
+        retries: 0,
+        fs: fs,
+        onCompromised: ((err) => {
+            throw err;
+        }),
+        ...options,
+    };
+    const retriesValue = merged.retries || 0;
+    const resolved = {
+        stale: Math.max(merged.stale || 0, 2000),
+        update: 0,
+        realpath: merged.realpath,
+        retries: typeof retriesValue === "number"
+            ? { retries: retriesValue }
+            : retriesValue,
+        fs: merged.fs,
+        onCompromised: merged.onCompromised,
+        lockfilePath: merged.lockfilePath,
+    };
+    const updateRaw = merged.update == null ? resolved.stale / 2 : merged.update || 0;
+    resolved.update = Math.max(Math.min(updateRaw, resolved.stale / 2), 1000);
+    // Resolve to a canonical file path
+    resolveCanonicalPath(file, resolved, (err, file) => {
+        if (err) {
+            return callback(err);
+        }
+        // Attempt to acquire the lock
+        const operation = retry.operation(resolved.retries);
+        operation.attempt(() => {
+            acquireLock(file, resolved, (err, mtime, precision) => {
+                if (operation.retry(err)) {
+                    return;
+                }
+                if (err) {
+                    return callback(operation.mainError());
+                }
+                // We now own the lock
+                const internalLock = (locks[file] = {
+                    lockfilePath: getLockFile(file, resolved),
+                    mtime: mtime,
+                    mtimePrecision: precision,
+                    options: resolved,
+                    lastUpdate: Date.now(),
+                });
+                // We must keep the lock fresh to avoid staleness
+                updateLock(file, resolved);
+                callback(null, (releasedCallback) => {
+                    if (internalLock.released) {
+                        return (releasedCallback &&
+                            releasedCallback(Object.assign(new Error("Lock is already released"), {
+                                code: "ERELEASED",
+                            })));
+                    }
+                    // Not necessary to use realpath twice when unlocking
+                    unlock(file, { ...resolved, realpath: false }, releasedCallback || (() => { }));
+                });
+            });
+        });
+    });
+}
+export function unlock(file, options, callback) {
+    const resolved = {
+        fs: fs,
+        realpath: true,
+        ...options,
+    };
+    // Resolve to a canonical file path
+    resolveCanonicalPath(file, resolved, (err, file) => {
+        if (err) {
+            return callback(err);
+        }
+        const lock = locks[file];
+        if (!lock) {
+            return callback(Object.assign(new Error("Lock is not acquired/owned by you"), {
+                code: "ENOTACQUIRED",
+            }));
+        }
+        if (lock.updateTimeout) {
+            clearTimeout(lock.updateTimeout);
+        }
+        lock.released = true;
+        delete locks[file];
+        removeLock(file, resolved, callback);
+    });
+}
+export function check(file, options, callback) {
+    const resolved = {
+        stale: 10000,
+        realpath: true,
+        fs: fs,
+        ...options,
+    };
+    resolved.stale = Math.max(resolved.stale || 0, 2000);
+    // Resolve to a canonical file path
+    resolveCanonicalPath(file, resolved, (err, file) => {
+        if (err) {
+            return callback(err);
+        }
+        // Check if lockfile exists
+        resolved.fs.stat(getLockFile(file, resolved), (err, stat) => {
+            if (err) {
+                // If does not exist, file is not locked. Otherwise, callback with error
+                return err.code === "ENOENT" ? callback(null, false) : callback(err);
+            }
+            // Otherwise, check if lock is stale by analyzing the file mtime
+            return callback(null, !isLockStale(stat, resolved));
+        });
+    });
+}
+export function getLocks() {
+    return locks;
+}
+// Remove acquired locks on exit
+/* istanbul ignore next */
+exitHook(() => {
+    for (const file in locks) {
+        const options = locks[file].options;
+        try {
+            options.fs.rmdirSync(getLockFile(file, options));
+        }
+        catch (e) {
+            /* Empty */
+        }
+    }
+});
+//# sourceMappingURL=lockfile.js.map

package/lib/lockfile.js.map

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

package/lib/mtime-precision.d.ts

@@ -0,0 +1,11 @@
+import type { Stats } from "node:fs";
+export type MtimePrecision = "s" | "ms";
+export interface MtimePrecisionFs {
+    stat(path: string, callback: (err: NodeJS.ErrnoException | null, stats: Stats) => void): void;
+    utimes(path: string, atime: Date, mtime: Date, callback: (err: NodeJS.ErrnoException | null) => void): void;
+}
+type ProbeCallback = (err: NodeJS.ErrnoException | null, mtime?: Date, precision?: MtimePrecision) => void;
+export declare function probe(file: string, fs: MtimePrecisionFs, callback: ProbeCallback): void;
+export declare function getMtime(precision: MtimePrecision): Date;
+export {};
+//# sourceMappingURL=mtime-precision.d.ts.map

package/lib/mtime-precision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mtime-precision.d.ts","sourceRoot":"","sources":["../src/mtime-precision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAClE,IAAI,CAAC;IACR,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,IAAI,EACX,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,KAAK,IAAI,GACpD,IAAI,CAAC;CACT;AAED,KAAK,aAAa,GAAG,CACnB,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,EACjC,KAAK,CAAC,EAAE,IAAI,EACZ,SAAS,CAAC,EAAE,cAAc,KACvB,IAAI,CAAC;AAQV,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,gBAAgB,EACpB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAuCN;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAQxD"}