@syncular/server-workers 0.15.47 → 0.16.1

package/README.md

@@ -139,6 +139,10 @@ 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.
+For commit-log pruning, expose the `SyncularRealtimeHost.pruneCommitLog` method
+through the owning Durable Object and call its RPC from the scheduler. This
+method uses the existing partition FIFO. Direct D1 pruning requires the same
+external serialization assertion as push application.
 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
@@ -263,6 +267,9 @@ const realtimeDOConfig = (env: Env): RealtimeDOConfig => ({
 export class SyncularRealtimeDO extends DurableObject<Env> {
   #host = new SyncularRealtimeHost(this.ctx, this.env.DB, realtimeDOConfig(this.env));
   fetch(request: Request) { return this.#host.fetch(request); }
+  pruneCommitLog(partition: string, nowMs: number) {
+    return this.#host.pruneCommitLog({ partition, nowMs });
+  }
   webSocketMessage(ws: WebSocket, msg: ArrayBuffer | string) {
     return this.#host.webSocketMessage(ws, msg);
   }

package/dist/realtime-do.d.ts

@@ -67,7 +67,7 @@
  * partition serialization may call `/__wake` after its own commit so sockets
  * re-pull. See `durableObjectRealtimeNotifier` for that caller side.
  */
-import { D1ServerStorage, type RealtimeHubConfig } from '@syncular/server';
+import { D1ServerStorage, type PruneOptions, type RealtimeHubConfig } from '@syncular/server';
 export interface DurableObjectStateLike {
     acceptWebSocket(ws: WebSocketLike, tags?: string[]): void;
     getWebSockets(tag?: string): WebSocketLike[];
@@ -153,6 +153,8 @@ export declare class SyncularRealtimeHost {
      * and accepts external-command wakes at `/__syncular_realtime/wake`.
      */
     fetch(request: Request): Promise<Response>;
+    /** Trusted maintenance shares the partition FIFO with HTTP/socket writes. */
+    pruneCommitLog(options: Omit<PruneOptions, 'storage'>): Promise<number>;
     /** Hibernation callback: an inbound frame. */
     webSocketMessage(ws: WebSocketLike, message: ArrayBuffer | string): Promise<void>;
     /** Hibernation callback: the socket closed. */

package/dist/realtime-do.js

@@ -67,7 +67,7 @@
  * partition serialization may call `/__wake` after its own commit so sockets
  * re-pull. See `durableObjectRealtimeNotifier` for that caller side.
  */
-import { createRealtimeHub, D1ServerStorage, errorBody, handleSyncRequest, SSP2_CONTENT_TYPE, SyncError, } from '@syncular/server';
+import { createRealtimeHub, D1ServerStorage, errorBody, handleSyncRequest, pruneCommitLog, SSP2_CONTENT_TYPE, SyncError, } from '@syncular/server';
 function isAttachment(value) {
     return (typeof value === 'object' &&
         value !== null &&
@@ -158,6 +158,13 @@ export class SyncularRealtimeHost {
         }
         return new Response('not found', { status: 404 });
     }
+    /** Trusted maintenance shares the partition FIFO with HTTP/socket writes. */
+    pruneCommitLog(options) {
+        return this.#serializePartition(async () => {
+            await this.#storage.migrate();
+            return pruneCommitLog({ ...options, storage: this.#storage });
+        });
+    }
     #serializePartition(operation) {
         const result = this.#partitionTail.then(operation, operation);
         this.#partitionTail = result.then(() => undefined, () => undefined);

package/package.json

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

package/src/realtime-do.ts

@@ -72,6 +72,8 @@ import {
   D1ServerStorage,
   errorBody,
   handleSyncRequest,
+  pruneCommitLog,
+  type PruneOptions,
   type RealtimeHub,
   type RealtimeHubConfig,
   type RealtimeSession,
@@ -249,6 +251,14 @@ export class SyncularRealtimeHost {
     return new Response('not found', { status: 404 });
   }
 
+  /** Trusted maintenance shares the partition FIFO with HTTP/socket writes. */
+  pruneCommitLog(options: Omit<PruneOptions, 'storage'>): Promise<number> {
+    return this.#serializePartition(async () => {
+      await this.#storage.migrate();
+      return pruneCommitLog({ ...options, storage: this.#storage });
+    });
+  }
+
   #serializePartition<T>(operation: () => Promise<T>): Promise<T> {
     const result = this.#partitionTail.then(operation, operation);
     this.#partitionTail = result.then(