@syncular/server-workers 0.8.0 → 0.10.0

package/README.md

@@ -136,6 +136,17 @@ writes with a coordinating primitive (a DO or a Queue). This mirrors
 Postgres's per-partition row lock, achieved by placement rather than a lock
 D1 does not expose. Cross-partition pushes never contend.
 
+**Whole-commit validation fails closed without that coordinator.** SPEC §6.8
+must hold serialization from before candidate reads through commit. A plain
+`new D1ServerStorage(env.DB)` therefore rejects a push whenever
+`commitValidator` is configured. The storage created inside
+`SyncularRealtimeHost` opts in because that host is already one
+single-threaded DO per partition. A custom coordinated host may construct
+`new D1ServerStorage(env.DB, { commitValidationSerialized: true })`, but MUST
+never set that assertion in a stateless HTTP Worker. A realtime notifier wakes
+sockets after an HTTP commit; it does not serialize that HTTP write and is not
+sufficient for §6.8 by itself.
+
 ## Workers realtime — the Durable Object
 
 The realtime channel (§8) needs a durable, stateful WebSocket host. On Workers

package/dist/realtime-do.js

@@ -118,7 +118,11 @@ export class SyncularRealtimeHost {
     #swallowHello = new Set();
     constructor(state, db, config) {
         this.#state = state;
-        this.#storage = new D1ServerStorage(db);
+        this.#storage = new D1ServerStorage(db, {
+            // This host is one Durable Object per partition, so the §6.8 storage
+            // precondition is true for socket rounds handled inside the object.
+            commitValidationSerialized: true,
+        });
         this.#config = config;
     }
     #getHub() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/server-workers",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Cloudflare Workers adapter for the Syncular sync server",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -45,11 +45,11 @@
     "!dist/**/*.test.d.ts"
   ],
   "dependencies": {
-    "@syncular/server": "0.8.0",
-    "@syncular/server-hono": "0.8.0",
+    "@syncular/server": "0.10.0",
+    "@syncular/server-hono": "0.10.0",
     "hono": "^4.11.0"
   },
   "devDependencies": {
-    "@syncular/core": "0.8.0"
+    "@syncular/core": "0.10.0"
   }
 }

package/src/realtime-do.ts

@@ -190,7 +190,11 @@ export class SyncularRealtimeHost {
     config: RealtimeDOConfig,
   ) {
     this.#state = state;
-    this.#storage = new D1ServerStorage(db);
+    this.#storage = new D1ServerStorage(db, {
+      // This host is one Durable Object per partition, so the §6.8 storage
+      // precondition is true for socket rounds handled inside the object.
+      commitValidationSerialized: true,
+    });
     this.#config = config;
   }