@syncular/server-workers 0.15.44 → 0.15.46

package/README.md

@@ -1,6 +1,6 @@
 # @syncular/server-workers
 
-The Cloudflare Workers entry for the Syncular sync server (TODO §4.2). It
+The Cloudflare Workers entry for the Syncular sync server. It
 wires the runtime-neutral server core to Workers bindings — **D1** for
 storage, **R2** for durable segment/blob bytes, secrets for signing and
 auth — behind a standard Workers module `fetch` handler.
@@ -113,7 +113,9 @@ wrangler d1 migrations apply syncular
 
 The schema is plain SQLite DDL (shared with `bun:sqlite` via
 `sqlite-dialect.ts`), so it is portable across the two SQLite-family
-storages.
+storages. Regenerate and apply a migration when upgrading Syncular adds a core
+table. The durable reaction queue uses `sync_reactions`; a Worker running a
+reaction planner or runner fails closed if that migration is absent.
 
 ## Storage: D1 (`D1ServerStorage`)
 
@@ -129,6 +131,19 @@ immediately (autocommit) and **buffers** writes, flushing them as one atomic
 rolls back by never flushing). A read-your-own-writes overlay makes `getRow`
 see buffered writes of the same commit.
 
+Durable reactions use the same model. Planned rows join the source commit's
+atomic batch. `ReactionRunner` claims due rows with one
+`UPDATE ... RETURNING` statement, so concurrent Workers have no select/update
+gap. Reaction handlers execute outside the source transaction. Run the runner
+from a Worker scheduler, queue consumer, Workflow step, or Durable Object
+alarm according to the application's hosting model.
+
+Schedule `pruneReactions` per partition as a separate maintenance pass.
+Defaults retain completed rows for 30 days and dead-lettered rows for 90 days,
+with at most 1,000 deletions per pass. Repeat while `mayHaveMore` is true.
+Pending and leased rows are never eligible. D1 executes each bounded cleanup
+as one `DELETE ... RETURNING` statement.
+
 **Concurrency posture.** Every push, not only whole-commit validation, must
 serialize before operation reads and re-check idempotency under that boundary.
 `createWorkersFetchHandler` forwards `/sync` to one DO per authenticated

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * `@syncular/server-workers` — the Cloudflare Workers entry (TODO §4.2).
+ * `@syncular/server-workers` — the Cloudflare Workers entry.
  *
  * This is deliberately thin. `createSyncularHono` (server-hono) is already
  * Workers-native: it routes with Hono (which runs unmodified on `workerd`)

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * `@syncular/server-workers` — the Cloudflare Workers entry (TODO §4.2).
+ * `@syncular/server-workers` — the Cloudflare Workers entry.
  *
  * This is deliberately thin. `createSyncularHono` (server-hono) is already
  * Workers-native: it routes with Hono (which runs unmodified on `workerd`)

package/dist/realtime-do.d.ts

@@ -1,6 +1,6 @@
 /**
  * `SyncularRealtimeDO` — the Cloudflare Durable Object realtime host (§8, the
- * second binding of §1.1). ROADMAP block 2: the designed-but-deferred half of
+ * second binding of §1.1). The deferred half of
  * the Workers deployment matrix, now built.
  *
  * ## The shape

package/dist/realtime-do.js

@@ -1,6 +1,6 @@
 /**
  * `SyncularRealtimeDO` — the Cloudflare Durable Object realtime host (§8, the
- * second binding of §1.1). ROADMAP block 2: the designed-but-deferred half of
+ * second binding of §1.1). The deferred half of
  * the Workers deployment matrix, now built.
  *
  * ## The shape

package/package.json

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

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * `@syncular/server-workers` — the Cloudflare Workers entry (TODO §4.2).
+ * `@syncular/server-workers` — the Cloudflare Workers entry.
  *
  * This is deliberately thin. `createSyncularHono` (server-hono) is already
  * Workers-native: it routes with Hono (which runs unmodified on `workerd`)

package/src/realtime-do.ts

@@ -1,6 +1,6 @@
 /**
  * `SyncularRealtimeDO` — the Cloudflare Durable Object realtime host (§8, the
- * second binding of §1.1). ROADMAP block 2: the designed-but-deferred half of
+ * second binding of §1.1). The deferred half of
  * the Workers deployment matrix, now built.
  *
  * ## The shape