experimental-a2 0.19.0 → 0.21.1

package/src/scheduler-task.ts

@@ -5,7 +5,7 @@ export type ScheduledEvent = {
   payload: unknown
 }
 
-/** A durable wake-up for pending handler work. */
+/** A durable wake-up for pending consumer work. */
 export type SchedulerDrainTask = {
   version: 1
   kind: 'drain'
@@ -26,7 +26,7 @@ export type SchedulerAppendTask = {
   /** Earliest useful delivery as epoch milliseconds. */
   dueAt: number
   events: readonly ScheduledEvent[]
-  /** The scheduling handler's event; delivery skips once it is cleared. */
+  /** The scheduling consumer's event; delivery skips once it is cleared. */
   originIndex?: number
 }
 

package/src/scheduler-vercel.ts

@@ -14,7 +14,8 @@
  *   the configured deployment scope for sending and receiving.
  * - `handler(...servers)` is the delivery route: look up the server for
  *   the contract named in the message and drain it. Settled drains ack;
- *   contention and handler failure arm a later watchdog before acking.
+ *   contention, consumer failure, and a drain that throws after arming its
+ *   successor all ack once a later watchdog is durable.
  *
  * `@vercel/queue` is an optional peer dependency, imported lazily. The
  * `transport` option is the injection seam — tests run a real little
@@ -342,9 +343,14 @@ export function vercelQueues(options: VercelQueuesOptions = {}): A2Scheduler {
               }
           if (result.settled) return
 
-          if (result.outcome === 'busy' || result.outcome === 'stalled') {
-            // The live owner arms its own claim windows, and the store holds
-            // a failed event until its retry time. Ensure a later slot here
+          if (
+            result.outcome === 'busy' ||
+            result.outcome === 'stalled' ||
+            result.outcome === 'failed'
+          ) {
+            // The live owner arms its own claim windows, the store holds
+            // a failed event until its retry time, and a drain that failed
+            // after claiming armed its successor. Ensure a later slot here
             // as well before relinquishing this durable delivery. If the queue is down, the
             // throw leaves the current message unacked for visibility-timeout
             // redelivery.

package/src/server.browser.ts

@@ -2,7 +2,7 @@
  * The browser build of experimental-a2/server. There isn't one — on purpose.
  * Contracts and reducers (from `experimental-a2`) and the session client (from
  * `experimental-a2/client` / `experimental-a2/react`) are the isomorphic surface; the server is
- * where handlers and storage live. This module existing in a client
+ * where consumers and storage live. This module existing in a client
  * bundle means a `'use client'` file (or something it imports)
  * value-imported your server module.
  */