@beignet/provider-locks-redis 0.0.32 → 0.0.33

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @beignet/provider-locks-redis
 
+## 0.0.33
+
+### Patch Changes
+
+- c6c4434: Add live Redis coverage for lock contention, fencing, stale owners, bounded waits, and timeouts, with explicit topology limits.
+
 ## 0.0.32
 
 ### Patch Changes

package/README.md

@@ -117,12 +117,28 @@ Use app-owned fake locks or an in-memory `LocksPort` in use-case tests when
 lease behavior is not the subject of the test. Use `createRedisLocks(...)` with
 a test Redis client for provider-level tests that need Lua/fencing semantics.
 
+This package also includes an opt-in live Redis suite. It uses independent
+Redis connections to exercise concurrent acquisition, monotonic fencing,
+expired-owner rejection, bounded waiting, and timeouts. The default
+`bun run test` command remains hermetic. Set `REDIS_LOCKS_TEST_URL` or the
+shared `REDIS_TEST_URL` for the live suite:
+
+```bash
+REDIS_LOCKS_TEST_URL=redis://localhost:6379 bun run test:live
+```
+
 ## Deployment notes
 
-Use a Redis deployment with persistence and predictable latency for work that
-depends on lease timing. Locks reduce duplicate work but do not replace
-database transactions, unique constraints, idempotency keys, or outbox claim
-state for business correctness.
+Use a single Redis primary with persistence and predictable latency for work
+that depends on lease timing. The provider's two-key Lua acquisition does not
+currently support Redis Cluster. Primary failover with asynchronous replication
+can lose recent lease or fencing-counter writes, and the live suite does not
+simulate failover or network partitions.
+
+Fencing tokens become a correctness boundary only when the protected durable
+resource atomically accepts tokens strictly greater than the last token it
+observed. Without that downstream check, use the lease to reduce duplicate
+work, not to prove that duplicates are impossible.
 
 ## Correctness note
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-locks-redis",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "type": "module",
   "description": "Redis-backed lock and lease provider for Beignet",
   "main": "./dist/index.js",
@@ -25,8 +25,9 @@
     "prepack": "bun run build",
     "dev": "tsc --watch",
     "clean": "rm -rf dist coverage .turbo",
-    "test": "bun test",
-    "test:coverage": "bun test --coverage",
+    "test": "bun test src/index.test.ts",
+    "test:live": "bun test src/redis-live.test.ts",
+    "test:coverage": "bun test --coverage src/index.test.ts",
     "lint": "biome check ."
   },
   "keywords": [