@lickle/lock 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/cjs/backend/node.js

@@ -1,118 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeLockHooks = exports.NodeFileHandle = exports.createNodeBackend = void 0;
-const node_worker_threads_1 = require("node:worker_threads");
-const node_fs_1 = __importDefault(require("node:fs"));
-const lockable_js_1 = require("./lockable.js");
-/**
- * Create the default Node.js backend using native OS locks (flock on Unix, LockFileEx on Windows).
- * Registers cleanup hooks for process exit, signals, and GC.
- *
- * @example
- * const backend = createNodeBackend()
- * await exclusive('/tmp/my.lock', { backend })
- */
-const createNodeBackend = () => {
-    const hooks = new NodeLockHooks();
-    return {
-        async open(file) {
-            const handle = await node_fs_1.default.promises.open(file, node_fs_1.default.constants.O_CREAT | node_fs_1.default.constants.O_RDWR);
-            return new NodeFileHandle(handle, file);
-        },
-        ...(0, lockable_js_1.createLockable)(hooks),
-    };
-};
-exports.createNodeBackend = createNodeBackend;
-/** Wraps a Node.js `fs.promises.FileHandle` to satisfy the `FileHandle` interface. */
-class NodeFileHandle {
-    handle;
-    path;
-    constructor(handle, path) {
-        this.handle = handle;
-        this.path = path;
-    }
-    get fd() {
-        return this.handle.fd;
-    }
-    close() {
-        return this.handle.close();
-    }
-}
-exports.NodeFileHandle = NodeFileHandle;
-/**
- * Track active locks and ensure they are released on process exit,
- * SIGINT, SIGTERM, and GC finalization.
- */
-class NodeLockHooks {
-    _active = new Set();
-    _handlingSignal = false;
-    _finalizer = new FinalizationRegistry((held) => {
-        try {
-            node_fs_1.default.closeSync(held.fd);
-        }
-        catch {
-            // EBADF (Bad file descriptor) is expected if the user or Node already closed it
-        }
-    });
-    async register(handle) {
-        if (this._active.size === 0)
-            this._listen();
-        this._active.add(handle.fd);
-        this._finalizer.register(handle, { fd: handle.fd, path: handle.path }, handle);
-    }
-    async unregister(handle) {
-        this._finalizer.unregister(handle);
-        this._active.delete(handle.fd);
-        if (this._active.size === 0)
-            this._unlisten();
-    }
-    _listen() {
-        if (node_worker_threads_1.isMainThread) {
-            process.on('exit', this._onExit);
-            process.on('SIGINT', this._onSignal);
-            process.on('SIGTERM', this._onSignal);
-        }
-        else {
-            node_worker_threads_1.parentPort?.on('close', this._onExit);
-        }
-    }
-    _unlisten() {
-        if (node_worker_threads_1.isMainThread) {
-            process.off('exit', this._onExit);
-            process.off('SIGINT', this._onSignal);
-            process.off('SIGTERM', this._onSignal);
-        }
-        else {
-            node_worker_threads_1.parentPort?.off('close', this._onExit);
-        }
-    }
-    _onExit = () => {
-        for (const fd of Array.from(this._active.values()).reverse()) {
-            try {
-                node_fs_1.default.closeSync(fd);
-            }
-            catch {
-                // EBADF (Bad file descriptor) is expected if the user or Node already closed it
-            }
-        }
-        this._active.clear();
-    };
-    _onSignal = (signal) => {
-        if (this._handlingSignal)
-            return;
-        this._handlingSignal = true;
-        this._unlisten();
-        this._onExit();
-        try {
-            process.kill(process.pid, signal);
-        }
-        catch {
-            process.exit(1);
-        }
-    };
-}
-exports.NodeLockHooks = NodeLockHooks;
-//# sourceMappingURL=node.js.map

package/dist/cjs/backend/node.js.map

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

package/dist/cjs/backend/types.d.ts

@@ -1,36 +0,0 @@
-/**
- * Backend for file operations.
- *
- * @example Customize file open:
- * ```ts
- * import { createLockable } from '@lickle/lock'
- * const backend = {
- *   open: async (file: string) => your open logic,
- *   ...createLockable(),
- * }
- * ```
- */
-export interface Backend<H extends FileHandle> extends Lockable<H> {
-    /** Open (or create) the lock file and return a handle. */
-    open(file: string): Promise<H>;
-}
-/** Lock/unlock operations, separated from file opening for composability. */
-export interface Lockable<H extends FileHandle> {
-    /** Acquire a lock, polling until available or timeout is reached. */
-    lock: (handle: H, mode: 'exclusive' | 'shared', options?: {
-        pollMs?: number;
-        timeout?: number;
-    }) => Promise<void>;
-    /** Try to acquire a lock without waiting. Return true if acquired. */
-    tryLock: (handle: H, mode: 'exclusive' | 'shared') => Promise<boolean>;
-    /** Release a previously acquired lock. */
-    unlock: (handle: H) => Promise<void>;
-}
-/** Represents an open file descriptor with its path. */
-export interface FileHandle {
-    readonly fd: number;
-    readonly path: string;
-    close(): Promise<void>;
-    handle: any;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/backend/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../lib/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAChE,0DAA0D;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,UAAU;IAC5C,qEAAqE;IACrE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjH,sEAAsE;IACtE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,0CAA0C;IAC1C,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,EAAE,GAAG,CAAA;CACZ"}

package/dist/cjs/backend/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cjs/backend/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../lib/backend/types.ts"],"names":[],"mappings":""}

package/dist/esm/backend/guard.d.ts

@@ -1,31 +0,0 @@
-import type { Backend, FileHandle } from './index.js';
-/**
- * RAII guard that holds a file lock. Unlocks and closes the file on drop.
- * Supports `await using` via `Symbol.asyncDispose`.
- *
- * @example
- * await using guard = await exclusive('/tmp/my.lock')
- * // lock is released when guard goes out of scope
- *
- * @example
- * const guard = await exclusive('/tmp/my.lock')
- * try { /* work *\/ } finally { await guard.drop() }
- */
-export declare class FileGuard<H extends FileHandle> {
-    private backend;
-    private hndl;
-    private _dropped;
-    /** The lock file path. */
-    readonly path: string;
-    /** The file descriptor number. */
-    readonly fd: number;
-    constructor(backend: Backend<H>, hndl: H);
-    /** The underlying file handle. Throws if the guard has been dropped. */
-    get handle(): H['handle'];
-    /** True if the lock has been released. */
-    get dropped(): boolean;
-    /** Release the lock and close the file. Safe to call multiple times. */
-    drop(): Promise<void>;
-    [Symbol.asyncDispose](): Promise<void>;
-}
-//# sourceMappingURL=guard.d.ts.map

package/dist/esm/backend/guard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../lib/backend/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErD;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,UAAU;IAQvC,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IARd,OAAO,CAAC,QAAQ,CAA2B;IAC3C,0BAA0B;IAC1B,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,kCAAkC;IAClC,SAAgB,EAAE,EAAE,MAAM,CAAA;gBAGhB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC;IAMjB,wEAAwE;IACxE,IAAI,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,CAGxB;IAED,0CAA0C;IAC1C,IAAI,OAAO,YAEV;IAED,wEAAwE;IACxE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/esm/backend/guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../lib/backend/guard.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,SAAS;IAQV;IACA;IARF,QAAQ,CAA2B;IAC3C,0BAA0B;IACV,IAAI,CAAQ;IAC5B,kCAAkC;IAClB,EAAE,CAAQ;IAE1B,YACU,OAAmB,EACnB,IAAO;QADP,YAAO,GAAP,OAAO,CAAY;QACnB,SAAI,GAAJ,IAAI,CAAG;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;IACnB,CAAC;IAED,wEAAwE;IACxE,IAAI,MAAM;QACR,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAChE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAA;IACzB,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAA;IACxB,CAAC;IAED,wEAAwE;IACxE,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACtC,CAAC;wBAAS,CAAC;oBACT,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;gBACzB,CAAC;YACH,CAAC,CAAC,EAAE,CAAA;QACN,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,CAAC,MAAM,CAAC,YAAY,CAAC;QACnB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAA;IACpB,CAAC;CACF"}

package/dist/esm/backend/index.d.ts

@@ -1,8 +0,0 @@
-import { NodeFileHandle } from './node.js';
-import { type Backend } from './types.js';
-export * from './lockable.js';
-export * from './types.js';
-export * from './guard.js';
-export * from './node.js';
-export declare const defaultBackend: () => Backend<NodeFileHandle>;
-//# sourceMappingURL=index.d.ts.map

package/dist/esm/backend/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AAIzB,eAAO,MAAM,cAAc,+BAG1B,CAAA"}

package/dist/esm/backend/index.js

@@ -1,13 +0,0 @@
-import { createNodeBackend } from './node.js';
-export * from './lockable.js';
-export * from './types.js';
-export * from './guard.js';
-export * from './node.js';
-/** Return the shared default Node backend singleton. */
-let _defaultBackend;
-export const defaultBackend = () => {
-    if (!_defaultBackend)
-        _defaultBackend = createNodeBackend();
-    return _defaultBackend;
-};
-//# sourceMappingURL=index.js.map

package/dist/esm/backend/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAkB,MAAM,WAAW,CAAA;AAG7D,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AAEzB,wDAAwD;AACxD,IAAI,eAAoD,CAAA;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,IAAI,CAAC,eAAe;QAAE,eAAe,GAAG,iBAAiB,EAAE,CAAA;IAC3D,OAAO,eAAe,CAAA;AACxB,CAAC,CAAA"}

package/dist/esm/backend/lockable.d.ts

@@ -1,15 +0,0 @@
-import type { FileHandle, Lockable } from '../index.js';
-/** Lifecycle hooks called when locks are acquired and released. */
-export interface LockHooks<H extends FileHandle> {
-    register: (handle: H) => Promise<void>;
-    unregister: (handle: H) => Promise<void>;
-}
-/**
- * Create a `Lockable` using native OS lock bindings (flock on Unix, LockFileEx on Windows).
- * Optional hooks are notified on lock/unlock for cleanup tracking.
- *
- * @example
- * const lockable = createLockable(myHooks)
- */
-export declare const createLockable: <H extends FileHandle>(hooks?: LockHooks<H>) => Lockable<H>;
-//# sourceMappingURL=lockable.d.ts.map

package/dist/esm/backend/lockable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lockable.d.ts","sourceRoot":"","sources":["../../../lib/backend/lockable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAIvD,mEAAmE;AACnE,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,UAAU;IAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,UAAU,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC,KAAG,QAAQ,CAAC,CAAC,CA0BrF,CAAA"}

package/dist/esm/backend/lockable.js

@@ -1,39 +0,0 @@
-import * as native from '#native';
-/**
- * Create a `Lockable` using native OS lock bindings (flock on Unix, LockFileEx on Windows).
- * Optional hooks are notified on lock/unlock for cleanup tracking.
- *
- * @example
- * const lockable = createLockable(myHooks)
- */
-export const createLockable = (hooks) => {
-    const lock = (handle, mode, options) => {
-        if (mode === 'exclusive')
-            return native.exclusive(handle.fd, options);
-        else
-            return native.shared(handle.fd, options);
-    };
-    const tryLock = (handle, mode) => {
-        if (mode === 'exclusive')
-            return native.tryExclusive(handle.fd);
-        else
-            return native.tryShared(handle.fd);
-    };
-    return {
-        async lock(handle, mode, options) {
-            await lock(handle, mode, options);
-            await hooks?.register(handle);
-        },
-        async tryLock(handle, mode) {
-            const locked = await tryLock(handle, mode);
-            if (locked)
-                await hooks?.register(handle);
-            return locked;
-        },
-        async unlock(handle) {
-            await hooks?.unregister(handle);
-            await native.unlock(handle.fd);
-        },
-    };
-};
-//# sourceMappingURL=lockable.js.map

package/dist/esm/backend/lockable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lockable.js","sourceRoot":"","sources":["../../../lib/backend/lockable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,SAAS,CAAA;AAQjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAuB,KAAoB,EAAe,EAAE;IACxF,MAAM,IAAI,GAAG,CAAC,MAAS,EAAE,IAA4B,EAAE,OAAiC,EAAiB,EAAE;QACzG,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;;YAChE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/C,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,MAAS,EAAE,IAA4B,EAAoB,EAAE;QAC5E,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;;YAC1D,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAS,EAAE,IAA4B,EAAE,OAAiC;YACnF,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;YACjC,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,MAAS,EAAE,IAA4B;YACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC1C,IAAI,MAAM;gBAAE,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YACzC,OAAO,MAAM,CAAA;QACf,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,MAAS;YACpB,MAAM,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;YAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/backend/node.d.ts

@@ -1,36 +0,0 @@
-import fs from 'node:fs';
-import { type LockHooks } from './lockable.js';
-import type { Backend, FileHandle } from './types.js';
-/**
- * Create the default Node.js backend using native OS locks (flock on Unix, LockFileEx on Windows).
- * Registers cleanup hooks for process exit, signals, and GC.
- *
- * @example
- * const backend = createNodeBackend()
- * await exclusive('/tmp/my.lock', { backend })
- */
-export declare const createNodeBackend: () => Backend<NodeFileHandle>;
-/** Wraps a Node.js `fs.promises.FileHandle` to satisfy the `FileHandle` interface. */
-export declare class NodeFileHandle implements FileHandle {
-    readonly handle: fs.promises.FileHandle;
-    readonly path: string;
-    constructor(handle: fs.promises.FileHandle, path: string);
-    get fd(): number;
-    close(): Promise<void>;
-}
-/**
- * Track active locks and ensure they are released on process exit,
- * SIGINT, SIGTERM, and GC finalization.
- */
-export declare class NodeLockHooks implements LockHooks<FileHandle> {
-    private _active;
-    private _handlingSignal;
-    private _finalizer;
-    register(handle: FileHandle): Promise<void>;
-    unregister(handle: FileHandle): Promise<void>;
-    private _listen;
-    private _unlisten;
-    private _onExit;
-    private _onSignal;
-}
-//# sourceMappingURL=node.d.ts.map

package/dist/esm/backend/node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../lib/backend/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,SAAS,CAAA;AAExB,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,QAAO,OAAO,CAAC,cAAc,CAU1D,CAAA;AAED,sFAAsF;AACtF,qBAAa,cAAe,YAAW,UAAU;IAE7C,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAC9B,IAAI,EAAE,MAAM;IAGvB,IAAI,EAAE,WAEL;IAED,KAAK;CAGN;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,SAAS,CAAC,UAAU,CAAC;IACzD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,eAAe,CAAQ;IAE/B,OAAO,CAAC,UAAU,CAMhB;IAEI,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,OAAO,CASd;IAED,OAAO,CAAC,SAAS,CAWhB;CACF"}

package/dist/esm/backend/node.js

@@ -1,109 +0,0 @@
-import { isMainThread, parentPort } from 'node:worker_threads';
-import fs from 'node:fs';
-import { createLockable } from './lockable.js';
-/**
- * Create the default Node.js backend using native OS locks (flock on Unix, LockFileEx on Windows).
- * Registers cleanup hooks for process exit, signals, and GC.
- *
- * @example
- * const backend = createNodeBackend()
- * await exclusive('/tmp/my.lock', { backend })
- */
-export const createNodeBackend = () => {
-    const hooks = new NodeLockHooks();
-    return {
-        async open(file) {
-            const handle = await fs.promises.open(file, fs.constants.O_CREAT | fs.constants.O_RDWR);
-            return new NodeFileHandle(handle, file);
-        },
-        ...createLockable(hooks),
-    };
-};
-/** Wraps a Node.js `fs.promises.FileHandle` to satisfy the `FileHandle` interface. */
-export class NodeFileHandle {
-    handle;
-    path;
-    constructor(handle, path) {
-        this.handle = handle;
-        this.path = path;
-    }
-    get fd() {
-        return this.handle.fd;
-    }
-    close() {
-        return this.handle.close();
-    }
-}
-/**
- * Track active locks and ensure they are released on process exit,
- * SIGINT, SIGTERM, and GC finalization.
- */
-export class NodeLockHooks {
-    _active = new Set();
-    _handlingSignal = false;
-    _finalizer = new FinalizationRegistry((held) => {
-        try {
-            fs.closeSync(held.fd);
-        }
-        catch {
-            // EBADF (Bad file descriptor) is expected if the user or Node already closed it
-        }
-    });
-    async register(handle) {
-        if (this._active.size === 0)
-            this._listen();
-        this._active.add(handle.fd);
-        this._finalizer.register(handle, { fd: handle.fd, path: handle.path }, handle);
-    }
-    async unregister(handle) {
-        this._finalizer.unregister(handle);
-        this._active.delete(handle.fd);
-        if (this._active.size === 0)
-            this._unlisten();
-    }
-    _listen() {
-        if (isMainThread) {
-            process.on('exit', this._onExit);
-            process.on('SIGINT', this._onSignal);
-            process.on('SIGTERM', this._onSignal);
-        }
-        else {
-            parentPort?.on('close', this._onExit);
-        }
-    }
-    _unlisten() {
-        if (isMainThread) {
-            process.off('exit', this._onExit);
-            process.off('SIGINT', this._onSignal);
-            process.off('SIGTERM', this._onSignal);
-        }
-        else {
-            parentPort?.off('close', this._onExit);
-        }
-    }
-    _onExit = () => {
-        for (const fd of Array.from(this._active.values()).reverse()) {
-            try {
-                fs.closeSync(fd);
-            }
-            catch {
-                // EBADF (Bad file descriptor) is expected if the user or Node already closed it
-            }
-        }
-        this._active.clear();
-    };
-    _onSignal = (signal) => {
-        if (this._handlingSignal)
-            return;
-        this._handlingSignal = true;
-        this._unlisten();
-        this._onExit();
-        try {
-            process.kill(process.pid, signal);
-        }
-        catch {
-            process.exit(1);
-        }
-    };
-}
-//# sourceMappingURL=node.js.map

package/dist/esm/backend/node.js.map

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

package/dist/esm/backend/types.d.ts

@@ -1,36 +0,0 @@
-/**
- * Backend for file operations.
- *
- * @example Customize file open:
- * ```ts
- * import { createLockable } from '@lickle/lock'
- * const backend = {
- *   open: async (file: string) => your open logic,
- *   ...createLockable(),
- * }
- * ```
- */
-export interface Backend<H extends FileHandle> extends Lockable<H> {
-    /** Open (or create) the lock file and return a handle. */
-    open(file: string): Promise<H>;
-}
-/** Lock/unlock operations, separated from file opening for composability. */
-export interface Lockable<H extends FileHandle> {
-    /** Acquire a lock, polling until available or timeout is reached. */
-    lock: (handle: H, mode: 'exclusive' | 'shared', options?: {
-        pollMs?: number;
-        timeout?: number;
-    }) => Promise<void>;
-    /** Try to acquire a lock without waiting. Return true if acquired. */
-    tryLock: (handle: H, mode: 'exclusive' | 'shared') => Promise<boolean>;
-    /** Release a previously acquired lock. */
-    unlock: (handle: H) => Promise<void>;
-}
-/** Represents an open file descriptor with its path. */
-export interface FileHandle {
-    readonly fd: number;
-    readonly path: string;
-    close(): Promise<void>;
-    handle: any;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/esm/backend/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../lib/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAChE,0DAA0D;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,UAAU;IAC5C,qEAAqE;IACrE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjH,sEAAsE;IACtE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,0CAA0C;IAC1C,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,EAAE,GAAG,CAAA;CACZ"}

package/dist/esm/backend/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/esm/backend/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../lib/backend/types.ts"],"names":[],"mappings":""}