experimental-a2 0.20.0 → 0.22.0

package/src/session-socket.ts

@@ -364,7 +364,7 @@ const handleSocketPush = async (
       return
     }
     activate()
-    // oxlint-disable-next-line a2/await-handler-append -- this transport append is awaited before its ack
+    // oxlint-disable-next-line a2/await-consumer-append -- this transport append is awaited before its ack
     const appended = await target.append(...events)
     activate()
     shell.send(socketAckFor(req, appended, ackSessionId))

package/src/store-codec.ts

@@ -1,3 +1,5 @@
+import type { EventCause, StoredCursor } from './store.ts'
+
 export const decodeReturnedEventIds = (value: unknown): string[] => {
   const decoded: unknown = typeof value === 'string' ? JSON.parse(value) : value
   if (
@@ -8,3 +10,67 @@ export const decodeReturnedEventIds = (value: unknown): string[] => {
   }
   return decoded
 }
+
+const positive = (value: unknown): value is number =>
+  Number.isInteger(value) && Number(value) >= 1
+
+/** A stored causal edge, from its JSON text or parsed value. */
+export const decodeCause = (value: unknown): EventCause | null => {
+  if (value === null || value === undefined) return null
+  const decoded = (typeof value === 'string' ? JSON.parse(value) : value) as {
+    consumer?: unknown
+    lane?: unknown
+    index?: unknown
+    attempt?: unknown
+    batchSize?: unknown
+  }
+  if (
+    typeof decoded.consumer !== 'string' ||
+    decoded.consumer.length === 0 ||
+    (decoded.lane !== null && typeof decoded.lane !== 'string') ||
+    !positive(decoded.index) ||
+    !positive(decoded.attempt) ||
+    (decoded.batchSize !== undefined && !positive(decoded.batchSize))
+  ) {
+    throw new TypeError('stored event has an invalid cause')
+  }
+  return {
+    consumer: decoded.consumer,
+    lane: decoded.lane,
+    index: Number(decoded.index),
+    attempt: Number(decoded.attempt),
+    ...(decoded.batchSize === undefined
+      ? {}
+      : { batchSize: Number(decoded.batchSize) }),
+  }
+}
+
+/** The key of a cursor within its consumer: its lane, or its one event. */
+export const cursorKeyOf = (lane: string | null, index: number): string =>
+  lane === null ? `#${index}` : `L${lane}`
+
+/**
+ * A log cursor a store doesn't hold, at `position` with nothing to run:
+ * what `wakeLog` returns for a session with nothing after its latest clear,
+ * where it writes nothing.
+ */
+export const idleLogCursor = (
+  consumer: string,
+  lane: string,
+  position: number,
+): StoredCursor => ({
+  consumer,
+  lane,
+  position,
+  head: null,
+  firstClaimedAt: null,
+  lastClaimedAt: null,
+  attemptCount: 0,
+  claimHolder: null,
+  claimExpiresAt: null,
+  failureCount: 0,
+  lastFailedAt: null,
+  lastFailedAttempt: null,
+  lastError: null,
+  failedAt: null,
+})