@oh-my-pi/pi-utils 18.2.8 → 18.2.10

package/dist/types/file-lock.d.ts

@@ -5,6 +5,8 @@ export interface FileLockOptions {
     retries?: number;
     /** Delay between acquisition attempts. */
     retryDelayMs?: number;
+    /** Cancel acquisition while waiting for another process to release the resource. */
+    signal?: AbortSignal;
 }
 /** An exclusive OS-backed lease. Releasing an already released handle is safe. */
 export interface FileLockHandle {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-utils",
-	"version": "18.2.8",
+	"version": "18.2.10",
 	"description": "Shared utilities for pi packages",
 	"keywords": [
 		"cli",
@@ -54,7 +54,7 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "18.2.8"
+		"@oh-my-pi/pi-natives": "18.2.10"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/file-lock.ts

@@ -5,6 +5,7 @@
  * mutexes, and other Unix platforms use `flock(2)` on `${filePath}.lock`.
  */
 import * as path from "node:path";
+import { scheduler } from "node:timers/promises";
 import { FileLock as NativeFileLock } from "@oh-my-pi/pi-natives";
 
 /** Controls bounded waiting when an advisory file lock is contended. */
@@ -13,6 +14,8 @@ export interface FileLockOptions {
 	retries?: number;
 	/** Delay between acquisition attempts. */
 	retryDelayMs?: number;
+	/** Cancel acquisition while waiting for another process to release the resource. */
+	signal?: AbortSignal;
 }
 
 /** An exclusive OS-backed lease. Releasing an already released handle is safe. */
@@ -20,7 +23,7 @@ export interface FileLockHandle {
 	release(): void;
 }
 
-const DEFAULT_OPTIONS: Required<FileLockOptions> = {
+const DEFAULT_OPTIONS = {
 	retries: 50,
 	retryDelayMs: 100,
 };
@@ -40,9 +43,10 @@ export async function acquireFileLock(filePath: string, options: FileLockOptions
 	const lockPath = getLockPath(filePath);
 
 	for (let attempt = 0; attempt < opts.retries; attempt++) {
+		opts.signal?.throwIfAborted();
 		const lock = tryAcquireLock(lockPath);
 		if (lock) return lock;
-		if (attempt + 1 < opts.retries) await Bun.sleep(opts.retryDelayMs);
+		if (attempt + 1 < opts.retries) await scheduler.wait(opts.retryDelayMs, { signal: opts.signal });
 	}
 
 	throw new Error(`Failed to acquire lock for ${filePath} after ${opts.retries} attempts`);
@@ -53,6 +57,7 @@ function acquireLockSync(filePath: string, options: FileLockOptions = {}): Nativ
 	const lockPath = getLockPath(filePath);
 
 	for (let attempt = 0; attempt < opts.retries; attempt++) {
+		opts.signal?.throwIfAborted();
 		const lock = tryAcquireLock(lockPath);
 		if (lock) return lock;
 		if (attempt + 1 < opts.retries && opts.retryDelayMs > 0) Bun.sleepSync(opts.retryDelayMs);