Feature/v2.0.0

CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [2.0.0] - 2025-11-17
+
+### Changed
+- `lock(name).request()` now returns `Promise<ReleasableLock | null>` instead of `Promise<ReleasableLock | NotHaveLock>`.
+- When a lock cannot be acquired (e.g., `ifAvailable: true`), `null` is returned instead of a dummy object.
+- Ensures compatibility with `await using` and AsyncDisposable patterns.
+
+---
+
 ## [1.0.1] - 2025-11-14
 
 ### Fixed
@@ -28,5 +37,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+[2.0.0]: https://github.com/juner/disposable-lock/releases/tag/v2.0.0
 [1.0.1]: https://github.com/juner/disposable-lock/releases/tag/v1.0.1  
 [1.0.0]: https://github.com/juner/disposable-lock/releases/tag/v1.0.0

README.md

@@ -37,7 +37,7 @@ async function main() {
   // Request a lock
   const acquired = await request({ mode: "exclusive" });
 
-  if (acquired.name) {
+  if (acquired) {
     console.log(`✅ Lock acquired: ${acquired.name}`);
 
     // Do something critical
@@ -62,7 +62,12 @@ async function autoRelease() {
   // Automatically releases the lock when the block ends
   await using acquired = await cacheLock.request();
 
-  console.log("Inside critical section...");
+  if (acquired) {
+    // Do something critical
+    await doSomething();
+  } else {
+    console.warn("⚠️ Lock was not available");
+  }
 }
 ```
 
@@ -76,7 +81,7 @@ Returns an object with:
 
 | Method | Description
 | - | -
-| `request(options?: LockOptions)` | Request a lock. Returns a `ReleasableLock` or a `NotHaveLock`.
+| `request(options?: LockOptions)` | Request a lock. Returns a `ReleasableLock` or a null.
 | `query()` | Query the current state (held and pending locks) for this name.
 
 Throws if `navigator.locks` is unavailable and no custom `LockManager` is provided.
@@ -94,16 +99,6 @@ Represents a successfully acquired lock.
 | `release()` | `() => Promise<boolean>` | Releases the lock
 | `[Symbol.asyncDispose]()` | `() => Promise<void>` | Enables await using syntax
 
-### `NotHaveLock`
-
-Returned when the lock cannot be obtained (for example, when using `{ ifAvailable: true }`).
-
-| Property / Method | Type | Description
-| `name` | `undefined` | —
-| `mode` | `undefined` | —
-| `release()` | `() => Promise<false>` | No-op release
-| `[Symbol.asyncDispose]()` | `() => Promise<void>` | No-op
-
 ## Querying lock state
 
 ```ts

package.json

@@ -1,6 +1,6 @@
 {
   "name": "disposable-lock",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "A disposable lock controller that wraps navigator.locks",
   "type": "module",
   "main": "./index.js",