atomic-lockfile 0.0.1-security → 1.4.2

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to `atomic-lockfile` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-06-10
+
+### Added
+- Initial release of `atomic-lockfile`
+- Atomic file locking via hard-link strategy (`atomic` adapter)
+- Multiple adapters: `fs`, `atomic`, `mkdir`, `symlink`
+- Multiple strategies: `exclusive`, `shared`, `advisory`, `optimistic`
+- TTL support with automatic expiry
+- Heartbeat mechanism to refresh lock timestamps
+- PID tracking and orphan detection (stale lock removal)
+- Stale lock detection based on age, PID liveness, and TTL expiry
+- Retry logic with `linear`, `exponential`, `fibonacci`, and `jitter` backoff
+- `AbortSignal` support for cancellation
+- Synchronous API (`lockSync`, `unlockSync`, `checkSync`)
+- Async/Promise API (`lock`, `unlock`, `check`, `withLock`)
+- Event system with typed events (`LockEventEmitter`)
+- Lifecycle hooks (`beforeLock`, `afterLock`, `beforeUnlock`, `afterUnlock`, `onError`, `onStale`, `onTimeout`)
+- Middleware system (`withLoggingMiddleware`, `withTimeoutMiddleware`, `withRetryMiddleware`, `createMetricsCollector`)
+- Plugin system (stale, heartbeat, PID file, TTL, cleanup)
+- Global and local lock registries
+- Global configuration management
+- CLI with `lock`, `unlock`, `status`, `list`, `cleanup` commands
+- Multiple output formats for CLI: `text`, `json`, `table`
+- Backwards-compatibility layer (`v1` API)
+- Full TypeScript support with strict types
+- ESM and CommonJS dual package
+- Comprehensive test suite
+- Benchmarks

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 atomic-lockfile contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,209 @@
-# Security holding package
+# atomic-lockfile
 
-This package contained malicious code and was removed from the registry by the npm security team. A placeholder was published to ensure users are not affected in the future.
+> Atomic file-based locking with retry, TTL, heartbeat, PID tracking, stale detection, and multi-strategy support.
 
-Please refer to www.npmjs.com/advisories?search=atomic-lockfile for more information.
+[![npm version](https://img.shields.io/npm/v/atomic-lockfile.svg)](https://www.npmjs.com/package/atomic-lockfile)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+
+---
+
+## Installation
+
+```bash
+npm install atomic-lockfile
+```
+
+---
+
+## Quick Start
+
+```ts
+import { withLock, lock, lockSync } from 'atomic-lockfile';
+
+// Wrap a function in a lock (auto-released)
+await withLock('/tmp/my-resource', async () => {
+  // only one process runs this at a time
+});
+
+// Manual acquire / release
+const handle = await lock('/tmp/my-resource');
+try {
+  // critical section
+} finally {
+  await handle.release();
+}
+
+// Synchronous API
+const { release } = lockSync('/tmp/my-resource');
+release();
+```
+
+---
+
+## Features
+
+| Feature | Description |
+|---|---|
+| **Atomic writes** | Uses hard-link strategy — no partial writes |
+| **Multiple adapters** | `fs`, `atomic`, `mkdir`, `symlink` |
+| **Multiple strategies** | `exclusive`, `shared`, `advisory`, `optimistic` |
+| **TTL** | Locks auto-expire after a configurable duration |
+| **Heartbeat** | Refreshes lock timestamps to prevent false stale detection |
+| **PID tracking** | Detects orphaned locks from dead processes |
+| **Stale detection** | By age, PID liveness, or TTL expiry |
+| **Retry + backoff** | `linear`, `exponential`, `fibonacci`, `jitter` |
+| **AbortSignal** | Cancel acquisition at any point |
+| **Sync API** | `lockSync`, `unlockSync`, `checkSync` |
+| **Events** | Typed event system for monitoring |
+| **Hooks** | Lifecycle hooks: `beforeLock`, `afterLock`, etc. |
+| **Middleware** | Compose option transformers |
+| **CLI** | `lock`, `unlock`, `status`, `list`, `cleanup` |
+| **TypeScript** | 100% typed, strict mode |
+| **ESM + CJS** | Dual package |
+
+---
+
+## API
+
+### `lock(path, options?)` → `Promise<LockHandle>`
+
+Acquire a lock. Retries with backoff on conflict.
+
+```ts
+const handle = await lock('/tmp/resource', {
+  retries: 10,
+  retryBackoff: 'exponential',
+  ttl: 30_000,
+  heartbeatInterval: 5_000,
+  removeStale: true,
+});
+await handle.release();
+```
+
+### `withLock(path, fn, options?)` → `Promise<T>`
+
+Acquire, run `fn`, release — even on error.
+
+```ts
+const result = await withLock('/tmp/resource', async () => {
+  return computeSomething();
+});
+```
+
+### `lockSync(path, options?)` → `{ lockPath, release }`
+
+Synchronous lock (no retry, no heartbeat).
+
+### `checkLock(path)` → `Promise<LockFile>`
+
+Inspect a lock without acquiring it.
+
+### `isLocked(path)` → `Promise<boolean>`
+
+Returns `true` if a non-stale lock exists.
+
+### `cleanupLocks(dir, options?)` → `Promise<CleanupResult>`
+
+Remove stale lock files from a directory.
+
+---
+
+## Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `retries` | `number` | `5` | Max retry attempts |
+| `retryDelay` | `number` | `100` | Base delay in ms |
+| `retryBackoff` | `string` | `'exponential'` | Backoff strategy |
+| `retryMaxDelay` | `number` | `5000` | Max delay cap in ms |
+| `timeout` | `number` | `60000` | Total acquisition timeout |
+| `ttl` | `number` | `null` | Lock TTL in ms |
+| `heartbeatInterval` | `number` | `5000` | Heartbeat refresh interval |
+| `staleAge` | `number` | `30000` | Age threshold for stale detection |
+| `removeStale` | `boolean` | `false` | Auto-remove stale locks |
+| `strategy` | `string` | `'exclusive'` | Lock strategy |
+| `adapter` | `string` | `'atomic'` | File-system adapter |
+| `signal` | `AbortSignal` | — | Cancellation signal |
+| `meta` | `object` | `{}` | Arbitrary metadata stored in lock file |
+
+---
+
+## CLI
+
+```bash
+# Acquire a lock
+atomic-lockfile lock /tmp/resource --ttl 30000
+
+# Release a lock
+atomic-lockfile unlock /tmp/resource
+
+# Check status
+atomic-lockfile status /tmp/resource --json
+
+# List all locks in a directory
+atomic-lockfile list --dir /tmp --recursive --table
+
+# Clean up stale locks
+atomic-lockfile cleanup --dir /tmp --stale-age 60000 --dry-run
+```
+
+---
+
+## Adapters
+
+| Adapter | Atomic | Cross-platform | Notes |
+|---|---|---|---|
+| `atomic` (default) | ✅ | ✅ | Hard-link strategy |
+| `fs` | ❌ | ✅ | Simple `wx` flag write |
+| `mkdir` | ✅ | ✅ | `mkdir` is atomic on most FS |
+| `symlink` | ✅ | ⚠️ Unix only | Symlink as lock token |
+
+---
+
+## Events
+
+```ts
+import { globalEmitter } from 'atomic-lockfile';
+
+globalEmitter.on('acquired', (event) => {
+  console.log('Lock acquired:', event.lockPath, 'after', event.elapsed, 'ms');
+});
+
+globalEmitter.on('stale', (event) => {
+  console.warn('Stale lock detected:', event.lockPath);
+});
+```
+
+---
+
+## Hooks
+
+```ts
+import { addBeforeLockHook, addAfterLockHook } from 'atomic-lockfile';
+
+addBeforeLockHook(async (path, lockPath, options) => {
+  console.log(`About to lock ${path}`);
+});
+
+addAfterLockHook(async (handle) => {
+  console.log(`Acquired lock on ${handle.path}, PID ${handle.data.pid}`);
+});
+```
+
+---
+
+## Middleware
+
+```ts
+import { withLoggingMiddleware, withRetryMiddleware, composeMiddleware } from 'atomic-lockfile';
+
+const middleware = composeMiddleware(withLoggingMiddleware, withRetryMiddleware);
+const handle = await lock('/tmp/resource', middleware({}));
+```
+
+---
+
+## License
+
+MIT © atomic-lockfile contributors

package/dist/esm/adapters/atomic.js

@@ -0,0 +1,42 @@
+import { promises as fsp } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { generateNonce } from '../utils/random.js';
+export const atomicAdapter = {
+    name: 'atomic',
+    atomic: true,
+    crossPlatform: true,
+    async acquire(lockPath, content) {
+        const dir = dirname(lockPath);
+        const tmp = join(dir, `.alftmp-${generateNonce(8)}`);
+        try {
+            await fsp.writeFile(tmp, content, { encoding: 'utf-8' });
+            await fsp.link(tmp, lockPath);
+        }
+        finally {
+            try {
+                await fsp.unlink(tmp);
+            }
+            catch { /* ignore */ }
+        }
+    },
+    async release(lockPath) {
+        try {
+            await fsp.unlink(lockPath);
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== 'ENOENT')
+                throw err;
+        }
+    },
+    async check(lockPath) {
+        try {
+            await fsp.access(lockPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=atomic.js.map

package/dist/esm/adapters/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../../src/adapters/atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IAEnB,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBAAC,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/esm/adapters/fs.js

@@ -0,0 +1,29 @@
+import { promises as fsp } from 'node:fs';
+export const fsAdapter = {
+    name: 'fs',
+    atomic: false,
+    crossPlatform: true,
+    async acquire(lockPath, content) {
+        await fsp.writeFile(lockPath, content, { encoding: 'utf-8', flag: 'wx' });
+    },
+    async release(lockPath) {
+        try {
+            await fsp.unlink(lockPath);
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== 'ENOENT')
+                throw err;
+        }
+    },
+    async check(lockPath) {
+        try {
+            await fsp.access(lockPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=fs.js.map

package/dist/esm/adapters/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/adapters/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,KAAK;IACb,aAAa,EAAE,IAAI;IAEnB,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/esm/adapters/index.js

@@ -0,0 +1,27 @@
+export { fsAdapter } from './fs.js';
+export { atomicAdapter } from './atomic.js';
+export { mkdirAdapter } from './mkdir.js';
+export { symlinkAdapter } from './symlink.js';
+import { fsAdapter } from './fs.js';
+import { atomicAdapter } from './atomic.js';
+import { mkdirAdapter } from './mkdir.js';
+import { symlinkAdapter } from './symlink.js';
+const adapterRegistry = new Map([
+    ['fs', fsAdapter],
+    ['atomic', atomicAdapter],
+    ['mkdir', mkdirAdapter],
+    ['symlink', symlinkAdapter],
+]);
+export function getAdapter(name) {
+    const adapter = adapterRegistry.get(name);
+    if (!adapter)
+        throw new Error(`Unknown adapter: "${name}"`);
+    return adapter;
+}
+export function registerAdapter(adapter) {
+    adapterRegistry.set(adapter.name, adapter);
+}
+export function listAdapters() {
+    return [...adapterRegistry.keys()];
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAuB;IACpD,CAAC,IAAI,EAAE,SAAS,CAAC;IACjB,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,SAAS,EAAE,cAAc,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/esm/adapters/mkdir.js

@@ -0,0 +1,31 @@
+import { promises as fsp } from 'node:fs';
+import { join } from 'node:path';
+export const mkdirAdapter = {
+    name: 'mkdir',
+    atomic: true,
+    crossPlatform: true,
+    async acquire(lockPath, content) {
+        await fsp.mkdir(lockPath, { recursive: false });
+        await fsp.writeFile(join(lockPath, 'data.json'), content, 'utf-8');
+    },
+    async release(lockPath) {
+        try {
+            await fsp.rm(lockPath, { recursive: true, force: true });
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== 'ENOENT')
+                throw err;
+        }
+    },
+    async check(lockPath) {
+        try {
+            const stat = await fsp.stat(lockPath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=mkdir.js.map

package/dist/esm/adapters/mkdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/adapters/mkdir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IAEnB,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/esm/adapters/symlink.js

@@ -0,0 +1,29 @@
+import { promises as fsp } from 'node:fs';
+export const symlinkAdapter = {
+    name: 'symlink',
+    atomic: true,
+    crossPlatform: false,
+    async acquire(lockPath, content) {
+        await fsp.symlink(content, lockPath);
+    },
+    async release(lockPath) {
+        try {
+            await fsp.unlink(lockPath);
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== 'ENOENT')
+                throw err;
+        }
+    },
+    async check(lockPath) {
+        try {
+            await fsp.lstat(lockPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=symlink.js.map

package/dist/esm/adapters/symlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink.js","sourceRoot":"","sources":["../../../src/adapters/symlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,KAAK;IAEpB,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/esm/async/check.js

@@ -0,0 +1,11 @@
+import { checkLock, isLocked, getLockState } from '../core/check.js';
+export async function check(path, options) {
+    return checkLock(path, options);
+}
+export async function locked(path, options) {
+    return isLocked(path, options);
+}
+export async function state(path, options) {
+    return getLockState(path, options);
+}
+//# sourceMappingURL=check.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/async/check.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,OAAsB;IAC9D,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,OAAsB;IAC/D,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,OAAsB;IAC9D,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/esm/async/index.js

@@ -0,0 +1,4 @@
+export { lock, tryLock } from './lock.js';
+export { unlock, forceUnlock } from './unlock.js';
+export { check, locked, state } from './check.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/async/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/async/lock.js

@@ -0,0 +1,13 @@
+import { acquireLock } from '../core/acquire.js';
+export async function lock(path, options) {
+    return acquireLock(path, options);
+}
+export async function tryLock(path, options) {
+    try {
+        return await acquireLock(path, { ...options, retries: 0 });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/esm/async/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/async/lock.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY,EAAE,OAAwB;IAC/D,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAAwB;IAClE,IAAI,CAAC;QACH,OAAO,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/async/unlock.js

@@ -0,0 +1,8 @@
+export async function unlock(handle, options) {
+    await handle.release();
+}
+export async function forceUnlock(path, lockExtension = '.lock') {
+    const { unlinkSafe } = await import('../utils/fs.js');
+    await unlinkSafe(path + lockExtension);
+}
+//# sourceMappingURL=unlock.js.map

package/dist/esm/async/unlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock.js","sourceRoot":"","sources":["../../../src/async/unlock.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAkB,EAAE,OAAwB;IACvE,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,aAAa,GAAG,OAAO;IACrE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,UAAU,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC;AACzC,CAAC"}

package/dist/esm/cli/commands/cleanup.js

@@ -0,0 +1,28 @@
+import { cleanupLocks } from '../../core/cleanup.js';
+export async function cleanupCommand(args) {
+    const dirIdx = args.indexOf('--dir');
+    const directory = dirIdx !== -1 ? (args[dirIdx + 1] ?? process.cwd()) : process.cwd();
+    const dryRun = args.includes('--dry-run');
+    const staleAgeIdx = args.indexOf('--stale-age');
+    const staleAge = staleAgeIdx !== -1 ? parseInt(args[staleAgeIdx + 1] ?? '30000', 10) : undefined;
+    try {
+        const result = await cleanupLocks(directory, {
+            dryRun,
+            ...(staleAge !== undefined ? { staleAge } : {}),
+        });
+        console.log(`Scanned: ${result.scanned} lock files`);
+        console.log(`Removed: ${result.removed.length} stale locks${dryRun ? ' (dry run)' : ''}`);
+        if (result.removed.length > 0) {
+            result.removed.forEach((p) => console.log(`  - ${p}`));
+        }
+        if (result.errors.length > 0) {
+            console.error(`Errors: ${result.errors.length}`);
+            result.errors.forEach((e) => console.error(`  - ${e.path}: ${e.error.message}`));
+        }
+    }
+    catch (err) {
+        console.error(`Cleanup failed: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/esm/cli/commands/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../../src/cli/commands/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACtF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE;YAC3C,MAAM;YACN,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,eAAe,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1F,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mBAAoB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/esm/cli/commands/list.js

@@ -0,0 +1,26 @@
+import { listLocks } from '../../core/list.js';
+import { formatOutput } from '../formatters/index.js';
+export async function listCommand(args) {
+    const dirIdx = args.indexOf('--dir');
+    const directory = dirIdx !== -1 ? args[dirIdx + 1] : process.cwd();
+    const recursive = args.includes('--recursive');
+    const includeStale = args.includes('--stale');
+    const includeExpired = args.includes('--expired');
+    const json = args.includes('--json');
+    const table = args.includes('--table');
+    const format = json ? 'json' : table ? 'table' : 'text';
+    try {
+        const locks = await listLocks({
+            ...(directory !== undefined ? { directory } : {}),
+            recursive,
+            includeStale,
+            includeExpired,
+        });
+        console.log(formatOutput(locks, format));
+    }
+    catch (err) {
+        console.error(`Error listing locks: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/esm/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,MAAM,GAAiB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC;YAC5B,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,SAAS;YACT,YAAY;YACZ,cAAc;SACf,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wBAAyB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/esm/cli/commands/lock.js

@@ -0,0 +1,26 @@
+import { acquireLock } from '../../core/acquire.js';
+export async function lockCommand(args) {
+    const path = args[0];
+    if (!path) {
+        console.error('Usage: atomic-lockfile lock <path> [--ttl <ms>] [--retries <n>]');
+        process.exit(1);
+        return;
+    }
+    const ttlIdx = args.indexOf('--ttl');
+    const ttl = ttlIdx !== -1 ? parseInt(args[ttlIdx + 1] ?? '0', 10) : undefined;
+    const retriesIdx = args.indexOf('--retries');
+    const retries = retriesIdx !== -1 ? parseInt(args[retriesIdx + 1] ?? '5', 10) : 5;
+    try {
+        const handle = await acquireLock(path, {
+            ...(ttl !== undefined ? { ttl } : {}),
+            retries,
+        });
+        console.log(`Locked: ${handle.lockPath}`);
+        console.log(JSON.stringify(handle.data, null, 2));
+    }
+    catch (err) {
+        console.error(`Failed to lock: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/esm/cli/commands/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../../src/cli/commands/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE;YACrC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO;SACR,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mBAAoB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/esm/cli/commands/status.js

@@ -0,0 +1,27 @@
+import { checkLock } from '../../core/check.js';
+import { formatLockFileText } from '../formatters/text.js';
+import { formatLockFileJson } from '../formatters/json.js';
+export async function statusCommand(args) {
+    const path = args[0];
+    if (!path) {
+        console.error('Usage: atomic-lockfile status <path> [--json]');
+        process.exit(1);
+        return;
+    }
+    const useJson = args.includes('--json');
+    try {
+        const lockFile = await checkLock(path);
+        if (useJson) {
+            console.log(formatLockFileJson(lockFile));
+        }
+        else {
+            console.log(formatLockFileText(lockFile));
+        }
+        process.exit(lockFile.exists && !lockFile.stale && !lockFile.expired ? 1 : 0);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/esm/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}