fireemu 0.2.0 → 0.4.0

package/README.md

@@ -1,17 +1,17 @@
 # fireemu
 
-A deterministic, test-only local runtime for Firebase SDK and Functions code, written in Rust.
-
-`fireemu` is not a faster re-implementation of the Firebase Emulator Suite. Its core is a
-deterministic state machine that detects missing Firestore indexes, production limit violations
-and inefficient queries locally; isolates state, events, time and Function execution per project
-so parallel tests stay deterministic; runs scheduled Functions against a virtual clock and offers
-`await-idle` instead of `sleep`; reproduces retries, duplicate delivery, delays and conflicts as
-seeded fault injection; and never claims compatibility it cannot show -- every feature is declared
-in a Capability Manifest with an explicit precision.
-
-The real `firebase-admin`, `firebase` (Node and browser) and `firebase/firestore/lite` SDKs run
-against it unchanged.
+An experimental local runtime for testing Firebase SDK and Functions code.
+
+Some Firebase failures are easy to miss locally. A query may need a composite index in production even though it passes against the official emulator. Production limits may reject a request that looked fine during development. Finding those problems only after running against a real Firebase project makes the feedback loop slow and can leave test data behind.
+
+fireemu was built for two jobs:
+
+- catch selected production-facing problems earlier, including missing Firestore indexes and production limit violations;
+- keep local test runs fast, with no JVM emulator to start and a single command that starts the services, runs the test command, and shuts everything down.
+
+fireemu is experimental. It is not a replacement for the official Firebase Emulator Suite or for testing against a real Firebase project. Use it as an additional test target, keep the official emulator in your test matrix, and verify important flows against production before shipping.
+
+The real `firebase-admin`, `firebase` (Node and browser) and `firebase/firestore/lite` SDKs run against it unchanged. Run `npx fireemu capabilities` before depending on a specific API: each capability records whether it is implemented, partial, validation-only, or unsupported. The full feature summary, the known gaps from production Firebase and from the official Emulator Suite, and the project status are in the repository README linked below.
 
 ## Install
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fireemu",
-  "version": "0.2.0",
-  "description": "A deterministic, test-only local runtime for Firebase SDK and Functions code",
+  "version": "0.4.0",
+  "description": "An experimental local runtime for testing Firebase SDK and Functions code",
   "keywords": [
     "emulator",
     "firebase",
@@ -27,11 +27,11 @@
   ],
   "type": "module",
   "optionalDependencies": {
-    "@fireemu/darwin-arm64": "0.2.0",
-    "@fireemu/darwin-x64": "0.2.0",
-    "@fireemu/linux-x64": "0.2.0",
-    "@fireemu/linux-arm64": "0.2.0",
-    "@fireemu/win32-x64": "0.2.0"
+    "@fireemu/darwin-arm64": "0.4.0",
+    "@fireemu/darwin-x64": "0.4.0",
+    "@fireemu/linux-x64": "0.4.0",
+    "@fireemu/linux-arm64": "0.4.0",
+    "@fireemu/win32-x64": "0.4.0"
   },
   "engines": {
     "node": ">=20"