@feltdb/core 0.4.2 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +11 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -53,6 +53,17 @@ Browser mutations resolve after their IndexedDB transaction commits. The
53
53
  durable change journal replays after reload and coordinates live collections
54
54
  across tabs through `BroadcastChannel` when available.
55
55
 
56
+ ## Concurrency Model
57
+
58
+ FeltDB 0.4.3 uses a **single-writer, multi-reader** model:
59
+
60
+ - **Single concurrent writer:** Only one process may call `database.mutate()` at a time
61
+ - **Multiple readers:** Any number of processes may call read operations (`collection.all()`, etc.)
62
+ - **Enforcement:** File lock acquired at database open, held for lifetime
63
+ - **Multi-writer error:** Attempting to open database from second process returns clear error: "Database is locked by another process. Only one process may write to a FeltDB database at a time."
64
+
65
+ **Not suitable for:** Multi-process concurrent writes. See Phase 3 roadmap for multi-writer replication model.
66
+
56
67
  ## API
57
68
 
58
69
  ### createFeltDB(options)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@feltdb/core",
3
- "version": "0.4.2",
3
+ "version": "0.4.3",
4
4
  "description": "FeltDB Core - Application-facing database API with state-first reactivity",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -38,7 +38,7 @@
38
38
  ],
39
39
  "author": "FeltDB Contributors",
40
40
  "dependencies": {
41
- "@feltdb/wasm": "^0.4.2"
41
+ "@feltdb/wasm": "^0.4.3"
42
42
  },
43
43
  "devDependencies": {
44
44
  "typescript": "^5.0.0",