atomic-lockfile 0.0.1-security → 1.4.2

package/dist/esm/core/check.js

@@ -0,0 +1,62 @@
+import { resolveLockPath } from '../utils/path.js';
+import { fileExists, getFileMtimeMs } from '../utils/fs.js';
+import { readFileSafe } from '../utils/fs.js';
+import { safeDeserializeLockData } from '../utils/serialize.js';
+import { checkStale } from '../plugins/stale.js';
+import { DEFAULT_LOCK_EXTENSION, DEFAULT_STALE_AGE } from '../constants/defaults.js';
+export async function checkLock(filePath, options = {}) {
+    const lockPath = resolveLockPath(filePath, options.staleAge !== undefined ? DEFAULT_LOCK_EXTENSION : DEFAULT_LOCK_EXTENSION);
+    const exists = await fileExists(lockPath);
+    if (!exists) {
+        return {
+            path: filePath,
+            lockPath,
+            data: null,
+            exists: false,
+            readable: false,
+            writable: false,
+            stale: false,
+            expired: false,
+            ageMs: 0,
+        };
+    }
+    const raw = await readFileSafe(lockPath, filePath, lockPath).catch(() => null);
+    const data = raw ? safeDeserializeLockData(raw) : null;
+    const mtimeMs = await getFileMtimeMs(lockPath);
+    const ageMs = mtimeMs !== null ? Date.now() - mtimeMs : 0;
+    let stale = false;
+    let expired = false;
+    if (data) {
+        const staleResult = checkStale(data, options.staleAge ?? DEFAULT_STALE_AGE);
+        stale = staleResult.isStale && staleResult.reason === 'age';
+        expired = staleResult.isStale && staleResult.reason === 'expired';
+    }
+    return {
+        path: filePath,
+        lockPath,
+        data,
+        exists: true,
+        readable: raw !== null,
+        writable: true,
+        stale,
+        expired,
+        ageMs,
+    };
+}
+export async function isLocked(filePath, options = {}) {
+    const result = await checkLock(filePath, options);
+    return result.exists && !result.stale && !result.expired;
+}
+export async function getLockState(filePath, options = {}) {
+    const result = await checkLock(filePath, options);
+    if (!result.exists)
+        return 'unlocked';
+    if (result.expired)
+        return 'expired';
+    if (result.stale)
+        return 'stale';
+    if (!result.readable)
+        return 'unknown';
+    return 'locked';
+}
+//# sourceMappingURL=check.js.map

package/dist/esm/core/check.js.map

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

package/dist/esm/core/cleanup.js

@@ -0,0 +1,45 @@
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+import { checkStale } from '../plugins/stale.js';
+import { safeDeserializeLockData } from '../utils/serialize.js';
+import { DEFAULT_LOCK_EXTENSION, DEFAULT_STALE_AGE } from '../constants/defaults.js';
+export async function cleanupLocks(directory, options = {}) {
+    const ext = options.extension ?? DEFAULT_LOCK_EXTENSION;
+    const staleAge = options.staleAge ?? DEFAULT_STALE_AGE;
+    const result = { removed: [], errors: [], scanned: 0 };
+    let entries;
+    try {
+        entries = await fsp.readdir(directory, { withFileTypes: true, encoding: 'utf-8' });
+    }
+    catch (err) {
+        result.errors.push({ path: directory, error: err });
+        return result;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(ext))
+            continue;
+        const lockPath = join(directory, entry.name);
+        result.scanned++;
+        try {
+            const raw = await fsp.readFile(lockPath, 'utf-8');
+            const data = safeDeserializeLockData(raw);
+            if (!data) {
+                if (!options.dryRun)
+                    await fsp.unlink(lockPath);
+                result.removed.push(lockPath);
+                continue;
+            }
+            const staleResult = checkStale(data, staleAge);
+            if (staleResult.isStale) {
+                if (!options.dryRun)
+                    await fsp.unlink(lockPath);
+                result.removed.push(lockPath);
+            }
+        }
+        catch (err) {
+            result.errors.push({ path: lockPath, error: err });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/esm/core/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/core/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQrF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,UAAuE,EAAE;IAEzE,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAEtE,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAY,EAAE,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,OAAO,CAAC,MAAM;oBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,MAAM;oBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAY,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/core/handle.js

@@ -0,0 +1,43 @@
+import { releaseLock } from './release.js';
+import { startHeartbeat } from '../plugins/heartbeat.js';
+import { checkStale } from '../plugins/stale.js';
+import { isLockExpiredByTtl } from '../plugins/ttl.js';
+import { DEFAULT_HEARTBEAT_INTERVAL, DEFAULT_STALE_AGE } from '../constants/defaults.js';
+import { promises as fsp } from 'node:fs';
+import { serializeLockData } from '../utils/serialize.js';
+export function createHandle(filePath, lockPath, data, options) {
+    let acquired = true;
+    let heartbeat = null;
+    let currentData = { ...data };
+    if (options.heartbeatInterval !== undefined || options.ttl !== undefined) {
+        heartbeat = startHeartbeat(lockPath, () => currentData, options.heartbeatInterval ?? DEFAULT_HEARTBEAT_INTERVAL);
+    }
+    const handle = {
+        get path() { return filePath; },
+        get lockPath() { return lockPath; },
+        get data() { return { ...currentData }; },
+        get acquired() { return acquired; },
+        async release() {
+            if (!acquired)
+                return;
+            heartbeat?.stop();
+            await releaseLock(filePath, lockPath, currentData, {});
+            acquired = false;
+        },
+        async refresh() {
+            currentData = { ...currentData, updated: Date.now() };
+            await fsp.writeFile(lockPath, serializeLockData(currentData), 'utf-8');
+        },
+        isStale() {
+            return checkStale(currentData, options.staleAge ?? DEFAULT_STALE_AGE).isStale;
+        },
+        isExpired() {
+            return isLockExpiredByTtl(currentData);
+        },
+        toJSON() {
+            return { ...currentData };
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=handle.js.map

package/dist/esm/core/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../src/core/handle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,QAAgB,EAChB,IAAc,EACd,OAAuB;IAEvB,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,SAAS,GAA2B,IAAI,CAAC;IAC7C,IAAI,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzE,SAAS,GAAG,cAAc,CACxB,QAAQ,EACR,GAAG,EAAE,CAAC,WAAW,EACjB,OAAO,CAAC,iBAAiB,IAAI,0BAA0B,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAe;QACzB,IAAI,IAAI,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QAEnC,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,SAAS,EAAE,IAAI,EAAE,CAAC;YAClB,MAAM,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACvD,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACtD,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAED,OAAO;YACL,OAAO,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC,CAAC,OAAO,CAAC;QAChF,CAAC;QAED,SAAS;YACP,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;QAED,MAAM;YACJ,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/core/index.js

@@ -0,0 +1,8 @@
+export { acquireLock } from './acquire.js';
+export { releaseLock } from './release.js';
+export { checkLock, isLocked, getLockState } from './check.js';
+export { createHandle } from './handle.js';
+export { listLocks } from './list.js';
+export { cleanupLocks } from './cleanup.js';
+export { buildLockData } from './buildLockData.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/core/list.js

@@ -0,0 +1,38 @@
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+import { checkLock } from './check.js';
+import { DEFAULT_LOCK_EXTENSION } from '../constants/defaults.js';
+export async function listLocks(options = {}) {
+    const dir = options.directory ?? process.cwd();
+    const ext = options.lockExtension ?? DEFAULT_LOCK_EXTENSION;
+    const lockFiles = [];
+    const scanDir = async (directory) => {
+        let entries;
+        try {
+            entries = await fsp.readdir(directory, { withFileTypes: true, encoding: 'utf-8' });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = join(directory, entry.name);
+            if (entry.isDirectory() && options.recursive) {
+                await scanDir(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith(ext)) {
+                const filePath = fullPath.slice(0, -ext.length);
+                const lockFile = await checkLock(filePath).catch(() => null);
+                if (!lockFile)
+                    continue;
+                if (!options.includeStale && lockFile.stale)
+                    continue;
+                if (!options.includeExpired && lockFile.expired)
+                    continue;
+                lockFiles.push(lockFile);
+            }
+        }
+    };
+    await scanDir(dir);
+    return lockFiles;
+}
+//# sourceMappingURL=list.js.map

package/dist/esm/core/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/core/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAuB,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IAC5D,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,KAAK,EAAE,SAAiB,EAAiB,EAAE;QACzD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC7C,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAChD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC7D,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBACxB,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,KAAK;oBAAE,SAAS;gBACtD,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,OAAO;oBAAE,SAAS;gBAC1D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/core/release.js

@@ -0,0 +1,21 @@
+import { getAdapter } from '../adapters/index.js';
+import { fileExists, readFileSafe } from '../utils/fs.js';
+import { safeDeserializeLockData } from '../utils/serialize.js';
+import { LockError } from '../errors/LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+import { DEFAULT_ADAPTER } from '../constants/defaults.js';
+export async function releaseLock(filePath, lockPath, ownData, options = {}) {
+    const adapter = getAdapter(DEFAULT_ADAPTER);
+    const exists = await fileExists(lockPath);
+    if (!exists)
+        return;
+    if (!options.force) {
+        const raw = await readFileSafe(lockPath, filePath, lockPath).catch(() => null);
+        const current = raw ? safeDeserializeLockData(raw) : null;
+        if (current && current.nonce !== ownData.nonce) {
+            throw new LockError(ERROR_CODES.LOCK_NOT_OWNED, filePath, lockPath, `Cannot release lock owned by nonce ${current.nonce} (ours: ${ownData.nonce})`);
+        }
+    }
+    await adapter.release(lockPath);
+}
+//# sourceMappingURL=release.js.map

package/dist/esm/core/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../src/core/release.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAA0B,MAAM,0BAA0B,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,QAAgB,EAChB,OAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,SAAS,CACjB,WAAW,CAAC,cAAc,EAC1B,QAAQ,EACR,QAAQ,EACR,sCAAsC,OAAO,CAAC,KAAK,WAAW,OAAO,CAAC,KAAK,GAAG,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/esm/errors/AbortError.js

@@ -0,0 +1,18 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class AbortError extends LockError {
+    name = 'AbortError';
+    attempt;
+    constructor(path, lockPath, attempt) {
+        super(ERROR_CODES.LOCK_ABORTED, path, lockPath, `Lock acquisition on "${path}" was aborted after ${attempt} attempt(s)`);
+        this.attempt = attempt;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            attempt: this.attempt,
+        };
+    }
+}
+//# sourceMappingURL=AbortError.js.map

package/dist/esm/errors/AbortError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbortError.js","sourceRoot":"","sources":["../../../src/errors/AbortError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,UAAW,SAAQ,SAAS;IACvB,IAAI,GAAG,YAAY,CAAC;IACpB,OAAO,CAAS;IAEhC,YAAY,IAAY,EAAE,QAAgB,EAAE,OAAe;QACzD,KAAK,CACH,WAAW,CAAC,YAAY,EACxB,IAAI,EACJ,QAAQ,EACR,wBAAwB,IAAI,uBAAuB,OAAO,aAAa,CACxE,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/ConflictError.js

@@ -0,0 +1,20 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class ConflictError extends LockError {
+    name = 'ConflictError';
+    holderData;
+    constructor(path, lockPath, holderData) {
+        super(ERROR_CODES.LOCK_CONFLICT, path, lockPath, holderData
+            ? `Lock on "${path}" is held by PID ${holderData.pid} on ${holderData.hostname}`
+            : `Lock on "${path}" is already held`);
+        this.holderData = holderData;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            holderData: this.holderData,
+        };
+    }
+}
+//# sourceMappingURL=ConflictError.js.map

package/dist/esm/errors/ConflictError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictError.js","sourceRoot":"","sources":["../../../src/errors/ConflictError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,IAAI,GAAG,eAAe,CAAC;IACvB,UAAU,CAAkB;IAE5C,YAAY,IAAY,EAAE,QAAgB,EAAE,UAA2B;QACrE,KAAK,CACH,WAAW,CAAC,aAAa,EACzB,IAAI,EACJ,QAAQ,EACR,UAAU;YACR,CAAC,CAAC,YAAY,IAAI,oBAAoB,UAAU,CAAC,GAAG,OAAO,UAAU,CAAC,QAAQ,EAAE;YAChF,CAAC,CAAC,YAAY,IAAI,mBAAmB,CACxC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/IOError.js

@@ -0,0 +1,24 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class IOError extends LockError {
+    name = 'IOError';
+    operation;
+    syscall;
+    errno;
+    constructor(path, lockPath, operation, cause, syscall, errno) {
+        super(ERROR_CODES.LOCK_IO, path, lockPath, `I/O error during "${operation}" on "${lockPath}": ${cause.message}`, cause);
+        this.operation = operation;
+        this.syscall = syscall;
+        this.errno = errno;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            syscall: this.syscall,
+            errno: this.errno,
+        };
+    }
+}
+//# sourceMappingURL=IOError.js.map

package/dist/esm/errors/IOError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOError.js","sourceRoot":"","sources":["../../../src/errors/IOError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpB,IAAI,GAAG,SAAS,CAAC;IACjB,SAAS,CAAS;IAClB,OAAO,CAAqB;IAC5B,KAAK,CAAqB;IAE1C,YACE,IAAY,EACZ,QAAgB,EAChB,SAAiB,EACjB,KAAY,EACZ,OAAgB,EAChB,KAAc;QAEd,KAAK,CACH,WAAW,CAAC,OAAO,EACnB,IAAI,EACJ,QAAQ,EACR,qBAAqB,SAAS,SAAS,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,EACpE,KAAK,CACN,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/LockError.js

@@ -0,0 +1,30 @@
+import { ERROR_MESSAGES } from '../constants/errors.js';
+export class LockError extends Error {
+    name = 'LockError';
+    code;
+    path;
+    lockPath;
+    timestamp;
+    cause;
+    constructor(code, path, lockPath, message, cause) {
+        super(message ?? ERROR_MESSAGES[code]);
+        this.code = code;
+        this.path = path;
+        this.lockPath = lockPath;
+        this.timestamp = Date.now();
+        this.cause = cause;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            path: this.path,
+            lockPath: this.lockPath,
+            timestamp: this.timestamp,
+            cause: this.cause?.message,
+        };
+    }
+}
+//# sourceMappingURL=LockError.js.map

package/dist/esm/errors/LockError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockError.js","sourceRoot":"","sources":["../../../src/errors/LockError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,GAAW,WAAW,CAAC;IAC3B,IAAI,CAAY;IAChB,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,SAAS,CAAS;IACT,KAAK,CAAoB;IAElD,YACE,IAAe,EACf,IAAY,EACZ,QAAgB,EAChB,OAAgB,EAChB,KAAa;QAEb,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/PermissionError.js

@@ -0,0 +1,21 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class PermissionError extends LockError {
+    name = 'PermissionError';
+    operation;
+    requiredMode;
+    constructor(path, lockPath, operation, requiredMode, cause) {
+        super(ERROR_CODES.LOCK_PERMISSION, path, lockPath, `Permission denied: cannot perform "${operation}" on "${lockPath}" (requires ${requiredMode})`, cause);
+        this.operation = operation;
+        this.requiredMode = requiredMode;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            requiredMode: this.requiredMode,
+        };
+    }
+}
+//# sourceMappingURL=PermissionError.js.map

package/dist/esm/errors/PermissionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionError.js","sourceRoot":"","sources":["../../../src/errors/PermissionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,IAAI,GAAG,iBAAiB,CAAC;IACzB,SAAS,CAAS;IAClB,YAAY,CAAS;IAErC,YACE,IAAY,EACZ,QAAgB,EAChB,SAAiB,EACjB,YAAoB,EACpB,KAAa;QAEb,KAAK,CACH,WAAW,CAAC,eAAe,EAC3B,IAAI,EACJ,QAAQ,EACR,sCAAsC,SAAS,SAAS,QAAQ,eAAe,YAAY,GAAG,EAC9F,KAAK,CACN,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/StaleError.js

@@ -0,0 +1,27 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class StaleError extends LockError {
+    name = 'StaleError';
+    staleAgeMs;
+    actualAgeMs;
+    stalePid;
+    staleHostname;
+    constructor(path, lockPath, staleAgeMs, actualAgeMs, stalePid, staleHostname) {
+        super(ERROR_CODES.LOCK_STALE, path, lockPath, `Lock on "${path}" is stale: held by PID ${stalePid} on ${staleHostname} for ${actualAgeMs}ms (threshold: ${staleAgeMs}ms)`);
+        this.staleAgeMs = staleAgeMs;
+        this.actualAgeMs = actualAgeMs;
+        this.stalePid = stalePid;
+        this.staleHostname = staleHostname;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            staleAgeMs: this.staleAgeMs,
+            actualAgeMs: this.actualAgeMs,
+            stalePid: this.stalePid,
+            staleHostname: this.staleHostname,
+        };
+    }
+}
+//# sourceMappingURL=StaleError.js.map

package/dist/esm/errors/StaleError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaleError.js","sourceRoot":"","sources":["../../../src/errors/StaleError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,UAAW,SAAQ,SAAS;IACvB,IAAI,GAAG,YAAY,CAAC;IACpB,UAAU,CAAS;IACnB,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,aAAa,CAAS;IAEtC,YACE,IAAY,EACZ,QAAgB,EAChB,UAAkB,EAClB,WAAmB,EACnB,QAAgB,EAChB,aAAqB;QAErB,KAAK,CACH,WAAW,CAAC,UAAU,EACtB,IAAI,EACJ,QAAQ,EACR,YAAY,IAAI,2BAA2B,QAAQ,OAAO,aAAa,QAAQ,WAAW,kBAAkB,UAAU,KAAK,CAC5H,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/TimeoutError.js

@@ -0,0 +1,21 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class TimeoutError extends LockError {
+    name = 'TimeoutError';
+    timeoutMs;
+    attempts;
+    constructor(path, lockPath, timeoutMs, attempts) {
+        super(ERROR_CODES.LOCK_TIMEOUT, path, lockPath, `Timed out after ${timeoutMs}ms and ${attempts} attempt(s) waiting for lock on "${path}"`);
+        this.timeoutMs = timeoutMs;
+        this.attempts = attempts;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            timeoutMs: this.timeoutMs,
+            attempts: this.attempts,
+        };
+    }
+}
+//# sourceMappingURL=TimeoutError.js.map

package/dist/esm/errors/TimeoutError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutError.js","sourceRoot":"","sources":["../../../src/errors/TimeoutError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzB,IAAI,GAAG,cAAc,CAAC;IACtB,SAAS,CAAS;IAClB,QAAQ,CAAS;IAEjC,YAAY,IAAY,EAAE,QAAgB,EAAE,SAAiB,EAAE,QAAgB;QAC7E,KAAK,CACH,WAAW,CAAC,YAAY,EACxB,IAAI,EACJ,QAAQ,EACR,mBAAmB,SAAS,UAAU,QAAQ,oCAAoC,IAAI,GAAG,CAC1F,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/ValidationError.js

@@ -0,0 +1,21 @@
+import { LockError } from './LockError.js';
+import { ERROR_CODES } from '../constants/errors.js';
+export class ValidationError extends LockError {
+    name = 'ValidationError';
+    field;
+    received;
+    constructor(path, lockPath, field, received, reason) {
+        super(ERROR_CODES.LOCK_VALIDATION, path, lockPath, `Validation failed for field "${field}": ${reason} (received: ${JSON.stringify(received)})`);
+        this.field = field;
+        this.received = received;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            field: this.field,
+            received: this.received,
+        };
+    }
+}
+//# sourceMappingURL=ValidationError.js.map

package/dist/esm/errors/ValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,IAAI,GAAG,iBAAiB,CAAC;IACzB,KAAK,CAAS;IACd,QAAQ,CAAU;IAElC,YAAY,IAAY,EAAE,QAAgB,EAAE,KAAa,EAAE,QAAiB,EAAE,MAAc;QAC1F,KAAK,CACH,WAAW,CAAC,eAAe,EAC3B,IAAI,EACJ,QAAQ,EACR,gCAAgC,KAAK,MAAM,MAAM,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAC5F,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/index.js

@@ -0,0 +1,24 @@
+export { LockError } from './LockError.js';
+export { TimeoutError } from './TimeoutError.js';
+export { StaleError } from './StaleError.js';
+export { ConflictError } from './ConflictError.js';
+export { ValidationError } from './ValidationError.js';
+export { PermissionError } from './PermissionError.js';
+export { IOError } from './IOError.js';
+export { AbortError } from './AbortError.js';
+export function isLockError(err) {
+    return err instanceof Error && err.name.endsWith('Error') && 'code' in err && 'lockPath' in err;
+}
+export function isConflictError(err) {
+    return err instanceof Error && err.name === 'ConflictError';
+}
+export function isTimeoutError(err) {
+    return err instanceof Error && err.name === 'TimeoutError';
+}
+export function isStaleError(err) {
+    return err instanceof Error && err.name === 'StaleError';
+}
+export function isAbortError(err) {
+    return err instanceof Error && err.name === 'AbortError';
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AAC3D,CAAC"}

package/dist/esm/events/emitter.js

@@ -0,0 +1,41 @@
+export class LockEventEmitter {
+    handlers = new Map();
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+        return this;
+    }
+    once(event, handler) {
+        const wrapper = (e) => {
+            handler(e);
+            this.off(event, wrapper);
+        };
+        return this.on(event, wrapper);
+    }
+    emit(event) {
+        const specific = this.handlers.get(event.name);
+        const wildcard = this.handlers.get('*');
+        specific?.forEach((h) => h(event));
+        wildcard?.forEach((h) => h(event));
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+        return this;
+    }
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+}
+export const globalEmitter = new LockEventEmitter();
+//# sourceMappingURL=emitter.js.map

package/dist/esm/events/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/events/emitter.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAe,IAAI,GAAG,EAAE,CAAC;IAElD,EAAE,CAAyB,KAA0B,EAAE,OAA4B;QACjF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAA2B,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAyB,KAA0B,EAAE,OAA4B;QAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAA2B,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAyB,KAA0B,EAAE,OAA4B;QACnF,MAAM,OAAO,GAAqB,CAAC,CAAC,EAAE,EAAE;YACtC,OAAO,CAAC,CAAM,CAAC,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,KAAmB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,kBAAkB,CAAC,KAA2B;QAC5C,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,KAA0B;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/esm/events/index.js

@@ -0,0 +1,3 @@
+export { LockEventEmitter, globalEmitter } from './emitter.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,cAAc,YAAY,CAAC"}

package/dist/esm/events/types.js

@@ -0,0 +1,15 @@
+export const LOCK_EVENT_NAMES = [
+    'acquiring',
+    'acquired',
+    'releasing',
+    'released',
+    'refreshing',
+    'refreshed',
+    'stale',
+    'expired',
+    'conflict',
+    'retry',
+    'timeout',
+    'error',
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/events/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,UAAU;IACV,WAAW;IACX,UAAU;IACV,YAAY;IACZ,WAAW;IACX,OAAO;IACP,SAAS;IACT,UAAU;IACV,OAAO;IACP,SAAS;IACT,OAAO;CACC,CAAC"}

package/dist/esm/hooks/afterLock.js

@@ -0,0 +1,18 @@
+const afterLockHooks = [];
+export function addAfterLockHook(hook) {
+    afterLockHooks.push(hook);
+}
+export function removeAfterLockHook(hook) {
+    const idx = afterLockHooks.indexOf(hook);
+    if (idx !== -1)
+        afterLockHooks.splice(idx, 1);
+}
+export async function runAfterLockHooks(handle) {
+    for (const hook of afterLockHooks) {
+        await hook(handle);
+    }
+}
+export function clearAfterLockHooks() {
+    afterLockHooks.length = 0;
+}
+//# sourceMappingURL=afterLock.js.map

package/dist/esm/hooks/afterLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"afterLock.js","sourceRoot":"","sources":["../../../src/hooks/afterLock.ts"],"names":[],"mappings":"AAIA,MAAM,cAAc,GAAoB,EAAE,CAAC;AAE3C,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAkB;IACxD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/esm/hooks/afterUnlock.js

@@ -0,0 +1,18 @@
+const afterUnlockHooks = [];
+export function addAfterUnlockHook(hook) {
+    afterUnlockHooks.push(hook);
+}
+export function removeAfterUnlockHook(hook) {
+    const idx = afterUnlockHooks.indexOf(hook);
+    if (idx !== -1)
+        afterUnlockHooks.splice(idx, 1);
+}
+export async function runAfterUnlockHooks(handle) {
+    for (const hook of afterUnlockHooks) {
+        await hook(handle);
+    }
+}
+export function clearAfterUnlockHooks() {
+    afterUnlockHooks.length = 0;
+}
+//# sourceMappingURL=afterUnlock.js.map