@chaos-overlords/server 0.8.1 → 0.8.2

package/dist/sse/MatchLog.d.ts

@@ -0,0 +1,85 @@
+import type { EventRepository, PersistedEvent } from '@chaos-overlords/kernel';
+/** One event as it goes on the wire, formatted and validated exactly once. */
+export interface EventFrame {
+    seq: number;
+    /** The SSE frame, or null for a stored row this build's schema cannot read. */
+    text: string | null;
+}
+/**
+ * The shared read and the shared frame of one match's event log.
+ *
+ * Fan-out used to be per subscriber all the way down: waking eighteen streams for one event meant
+ * eighteen `listAfter` queries over the same rows, eighteen schema validations of the same payload
+ * and eighteen `JSON.stringify` calls producing the same string. The work is per EVENT, not per
+ * reader, so it is done here once and handed out.
+ *
+ * Three things follow from that, in order of how much they save:
+ *
+ * 1. **The notification carries the event.** `notify` already holds the durable row, so its frame
+ *    is formatted and kept here before any stream is woken. A stream whose cursor is exactly one
+ *    behind — which is every healthy stream of the match — finds it and never reads at all.
+ * 2. **Concurrent readers at the same cursor share one query.** A stream that does have to read
+ *    joins the request already in flight for that cursor instead of issuing its own.
+ * 3. **A heartbeat that has nothing to catch up on asks nothing.** The highest sequence this
+ *    process has been told about is known here, so a caught-up stream skips its periodic re-read.
+ *    At the default cap of 512 streams that was about twenty-five queries a second finding nothing,
+ *    on the same event loop that seals turns.
+ *
+ * None of it changes the contract that the LOG is the truth: every fast path is a memo of rows that
+ * were durable before they got here, and anything not covered falls through to a query.
+ */
+export declare class MatchLog {
+    private readonly matchId;
+    private readonly events;
+    /** Ascending by seq; trimmed from the front. A Map iterates in insertion order. */
+    private readonly frames;
+    private readonly inFlight;
+    /**
+     * The highest sequence a NOTIFICATION has carried, which is not the same as the highest this has
+     * ever read.
+     *
+     * Only a notification proves that this process is being told about the match's appends, and only
+     * that justifies answering "there is nothing further" without asking the database. A hub that is
+     * woken without the event body — the Durable Object is notified by match id — never sets this, so
+     * every one of its reads goes to the log exactly as before.
+     */
+    private notified;
+    constructor(matchId: string, events: EventRepository);
+    /**
+     * Remember a published event and its frame.
+     *
+     * Formatting here rather than in each stream is what turns a seal's burst from "events times
+     * subscribers" units of work into "events".
+     */
+    record(event: PersistedEvent): void;
+    /**
+     * Whether a stream at `lastSeq` holds every event this process has been told about.
+     *
+     * False whenever nothing has been (see `notified`), so an unsure answer is always the one that
+     * does the work. Callers use it to skip a periodic re-read, never to decide what to deliver.
+     */
+    caughtUp(lastSeq: number): boolean;
+    /**
+     * The next page after `afterSeq`, from memory when the tail covers it and from the log otherwise.
+     *
+     * A page served from memory is contiguous by construction: it stops at the first gap, so a
+     * caller can never be handed a frame whose predecessor it has not seen, which is the invariant
+     * the stream cursor rests on.
+     *
+     * `force` bypasses memory entirely and asks the log. The caller that passes it is the periodic
+     * catch-up, which exists precisely for what this process cannot be told: an append by another
+     * process against the same database. Everything else may take the short answer, because the
+     * events THIS process publishes are the events it is notified of.
+     *
+     * Bypassing the memo rather than only its "nothing further" answer is what makes the catch-up
+     * happen at all: the drain spends the force on its FIRST page, so a page served out of memory
+     * used it up without a read ever reaching the log, and the stream then waited another whole
+     * catch-up period to try again. A tail hit is the common case on a woken stream, so that was
+     * most of them.
+     */
+    page(afterSeq: number, force?: boolean): Promise<EventFrame[]>;
+    private pageFromMemory;
+    private read;
+    private trim;
+}
+//# sourceMappingURL=MatchLog.d.ts.map

package/dist/sse/MatchLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatchLog.d.ts","sourceRoot":"","sources":["../../src/sse/MatchLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAG9E,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,+EAA+E;IAC/E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAcD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAQ;IAgBjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBzB,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAI;IAEpB,YACmB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACtC;IAEJ;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAKlC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAejE;IAED,OAAO,CAAC,cAAc;YAUR,IAAI;IAalB,OAAO,CAAC,IAAI;CAOb"}

package/dist/sse/MatchLog.js

@@ -0,0 +1,147 @@
+import { tryFormatEvent } from './createSseResponse';
+/**
+ * Frames one match keeps in memory.
+ *
+ * Only the tail matters: every stream of a match sits within a few events of the others, so what
+ * this covers is the burst a seal emits and the moment after a reconnect. A straggler further back
+ * than this falls through to a query, which is what the durable log is for.
+ */
+const FRAMES_KEPT = 256;
+/** Events one query pages. */
+const PAGE_SIZE = 200;
+/**
+ * The shared read and the shared frame of one match's event log.
+ *
+ * Fan-out used to be per subscriber all the way down: waking eighteen streams for one event meant
+ * eighteen `listAfter` queries over the same rows, eighteen schema validations of the same payload
+ * and eighteen `JSON.stringify` calls producing the same string. The work is per EVENT, not per
+ * reader, so it is done here once and handed out.
+ *
+ * Three things follow from that, in order of how much they save:
+ *
+ * 1. **The notification carries the event.** `notify` already holds the durable row, so its frame
+ *    is formatted and kept here before any stream is woken. A stream whose cursor is exactly one
+ *    behind — which is every healthy stream of the match — finds it and never reads at all.
+ * 2. **Concurrent readers at the same cursor share one query.** A stream that does have to read
+ *    joins the request already in flight for that cursor instead of issuing its own.
+ * 3. **A heartbeat that has nothing to catch up on asks nothing.** The highest sequence this
+ *    process has been told about is known here, so a caught-up stream skips its periodic re-read.
+ *    At the default cap of 512 streams that was about twenty-five queries a second finding nothing,
+ *    on the same event loop that seals turns.
+ *
+ * None of it changes the contract that the LOG is the truth: every fast path is a memo of rows that
+ * were durable before they got here, and anything not covered falls through to a query.
+ */
+export class MatchLog {
+    matchId;
+    events;
+    /** Ascending by seq; trimmed from the front. A Map iterates in insertion order. */
+    frames = new Map();
+    inFlight = new Map();
+    /**
+     * The highest sequence a NOTIFICATION has carried, which is not the same as the highest this has
+     * ever read.
+     *
+     * Only a notification proves that this process is being told about the match's appends, and only
+     * that justifies answering "there is nothing further" without asking the database. A hub that is
+     * woken without the event body — the Durable Object is notified by match id — never sets this, so
+     * every one of its reads goes to the log exactly as before.
+     */
+    notified = 0;
+    constructor(matchId, events) {
+        this.matchId = matchId;
+        this.events = events;
+    }
+    /**
+     * Remember a published event and its frame.
+     *
+     * Formatting here rather than in each stream is what turns a seal's burst from "events times
+     * subscribers" units of work into "events".
+     */
+    record(event) {
+        if (event.seq > this.notified)
+            this.notified = event.seq;
+        if (this.frames.has(event.seq))
+            return;
+        this.frames.set(event.seq, { seq: event.seq, text: tryFormatEvent(event) });
+        this.trim();
+    }
+    /**
+     * Whether a stream at `lastSeq` holds every event this process has been told about.
+     *
+     * False whenever nothing has been (see `notified`), so an unsure answer is always the one that
+     * does the work. Callers use it to skip a periodic re-read, never to decide what to deliver.
+     */
+    caughtUp(lastSeq) {
+        return this.notified > 0 && lastSeq >= this.notified;
+    }
+    /**
+     * The next page after `afterSeq`, from memory when the tail covers it and from the log otherwise.
+     *
+     * A page served from memory is contiguous by construction: it stops at the first gap, so a
+     * caller can never be handed a frame whose predecessor it has not seen, which is the invariant
+     * the stream cursor rests on.
+     *
+     * `force` bypasses memory entirely and asks the log. The caller that passes it is the periodic
+     * catch-up, which exists precisely for what this process cannot be told: an append by another
+     * process against the same database. Everything else may take the short answer, because the
+     * events THIS process publishes are the events it is notified of.
+     *
+     * Bypassing the memo rather than only its "nothing further" answer is what makes the catch-up
+     * happen at all: the drain spends the force on its FIRST page, so a page served out of memory
+     * used it up without a read ever reaching the log, and the stream then waited another whole
+     * catch-up period to try again. A tail hit is the common case on a woken stream, so that was
+     * most of them.
+     */
+    async page(afterSeq, force = false) {
+        if (!force) {
+            const memoised = this.pageFromMemory(afterSeq);
+            if (memoised.length > 0)
+                return memoised;
+            if (this.caughtUp(afterSeq))
+                return [];
+        }
+        // A read already in flight for this cursor is a read of the log, forced or not, so joining it
+        // satisfies a forced caller too.
+        const shared = this.inFlight.get(afterSeq);
+        if (shared)
+            return shared;
+        const request = this.read(afterSeq).finally(() => {
+            this.inFlight.delete(afterSeq);
+        });
+        this.inFlight.set(afterSeq, request);
+        return request;
+    }
+    pageFromMemory(afterSeq) {
+        const page = [];
+        for (let seq = afterSeq + 1; page.length < PAGE_SIZE; seq += 1) {
+            const frame = this.frames.get(seq);
+            if (!frame)
+                break;
+            page.push(frame);
+        }
+        return page;
+    }
+    async read(afterSeq) {
+        const rows = await this.events.listAfter(this.matchId, afterSeq, PAGE_SIZE);
+        const page = rows.map((row) => {
+            const known = this.frames.get(row.seq);
+            if (known)
+                return known;
+            const frame = { seq: row.seq, text: tryFormatEvent(row) };
+            this.frames.set(row.seq, frame);
+            return frame;
+        });
+        this.trim();
+        return page;
+    }
+    trim() {
+        while (this.frames.size > FRAMES_KEPT) {
+            const oldest = this.frames.keys().next();
+            if (oldest.done)
+                return;
+            this.frames.delete(oldest.value);
+        }
+    }
+}
+//# sourceMappingURL=MatchLog.js.map

package/dist/sse/MatchLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatchLog.js","sourceRoot":"","sources":["../../src/sse/MatchLog.ts"],"names":[],"mappings":"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"}

package/dist/sse/createSseResponse.d.ts

@@ -1,7 +1,20 @@
 import type { PersistedEvent } from '@chaos-overlords/kernel';
+import type { EventFrame } from './MatchLog';
 export interface EventStreamSource {
-    /** Persisted events after `afterSeq`, ascending, at most one page. */
-    listAfter(afterSeq: number): Promise<PersistedEvent[]>;
+    /**
+     * Formatted frames after `afterSeq`, ascending, at most one page.
+     *
+     * Frames rather than rows because the validation and the serialisation of one event are the same
+     * work for every reader of it; see `MatchLog`.
+     */
+    page(afterSeq: number, force?: boolean): Promise<EventFrame[]>;
+    /**
+     * Whether a stream at `lastSeq` is known to have everything.
+     *
+     * Only ever used to skip a periodic catch-up read that would have found nothing, so an
+     * implementation that cannot tell must answer false.
+     */
+    caughtUp(lastSeq: number): boolean;
     /**
      * Register a wake-up for new events; returns the unsubscribe.
      *
@@ -15,6 +28,8 @@ export interface SseOptions {
     afterSeq: number;
     heartbeatMs: number;
     signal: AbortSignal;
+    /** Told the sequence of a stored event this build cannot validate, so it can be logged. */
+    onUnreadable?: (seq: number) => void;
 }
 /**
  * A server-sent event stream over a persisted, sequence-numbered log.
@@ -43,4 +58,14 @@ export declare function createSseResponse(source: EventStreamSource, options: Ss
  * payload, which is unaffected.
  */
 export declare function formatEvent(event: PersistedEvent): string;
+/** The same frame, or null when the stored row does not fit this build's schema. */
+export declare function tryFormatEvent(event: PersistedEvent): string | null;
+/**
+ * Whether a stored row fits this build's schema, without building a frame from it.
+ *
+ * The REST read of the log uses this to leave an unreadable row out of its page. Asking
+ * `tryFormatEvent` there meant serialising every event of the page once to throw the string away
+ * and once more inside `c.json`.
+ */
+export declare function isReadableEvent(event: PersistedEvent): boolean;
 //# sourceMappingURL=createSseResponse.d.ts.map

package/dist/sse/createSseResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSseResponse.d.ts","sourceRoot":"","sources":["../../src/sse/createSseResponse.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAG7D,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACtD;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC3D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;CACpB;AAaD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,CA2H1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAIzD"}
+{"version":3,"file":"createSseResponse.d.ts","sourceRoot":"","sources":["../../src/sse/createSseResponse.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC9D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC3D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC;AAkCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,CAiK1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAIzD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAMnE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAO9D"}

package/dist/sse/createSseResponse.js

@@ -1,5 +1,24 @@
 import { MATCH_EVENT_SSE_NAME, matchEventSchema, SSE_HEARTBEAT_COMMENT, } from '@chaos-overlords/contracts';
 import { validateSync } from '@toad-contracts/core';
+/**
+ * Heartbeats between two catch-up reads a caught-up stream cannot talk its way out of.
+ *
+ * `caughtUp` answers from what THIS process has been told, which is everything on a single Node
+ * process and inside a Durable Object, and not necessarily everything when several processes share
+ * one database. This bounds how long such a stream can be behind without knowing it, at the cost of
+ * one query per stream every hundred seconds or so instead of one every twenty.
+ */
+const CATCH_UP_EVERY_HEARTBEATS = 5;
+/**
+ * Heartbeats a consumer may leave the drain parked on backpressure before the stream is dropped.
+ *
+ * `enqueue` never refuses, so a connection that has stopped being read — a suspended phone, a
+ * half-open TCP connection a NAT forgot — is invisible from this side: the drain parks correctly,
+ * but the slot, its heartbeat timer and its catch-up reads persist until the OS retransmit timer
+ * gives up, which on Linux is fifteen to thirty minutes. Dropping it costs the client nothing it
+ * cannot recover: it reconnects and resumes from its `Last-Event-ID`.
+ */
+const STALLED_HEARTBEATS_BEFORE_DROP = 3;
 const encoder = new TextEncoder();
 /**
  * Frames buffered for a consumer that is not keeping up, before the drain parks.
@@ -25,6 +44,7 @@ const STREAM_HIGH_WATER_MARK = 32;
  * again; the log keeps the events in the meantime, which is the whole point of it being the truth.
  */
 export function createSseResponse(source, options) {
+    const { onUnreadable } = options;
     let lastSeq = options.afterSeq;
     let draining = null;
     let wakeAgain = false;
@@ -41,28 +61,45 @@ export function createSseResponse(source, options) {
                     controller.enqueue(encoder.encode(text));
             };
             /** Wait until the consumer wants more, or the stream closes. */
-            const awaitDemand = (controller) => new Promise((resolve) => {
+            const awaitDemand = () => new Promise((resolve) => {
                 if (closed || (controller.desiredSize ?? 1) > 0)
                     return resolve();
                 demand = resolve;
             });
-            const drain = async () => {
+            const drain = async (force) => {
+                let first = force;
                 while (!closed) {
-                    await awaitDemand(controller);
+                    await awaitDemand();
                     if (closed)
                         return;
-                    const events = await source.listAfter(lastSeq);
-                    if (events.length === 0)
+                    // Only the first page of a forced drain has to reach the log — and it does, because
+                    // `force` bypasses the source's memo rather than only its "nothing further" answer.
+                    // Once it has, the cursor is beyond whatever this process did not know about.
+                    const frames = await source.page(lastSeq, first);
+                    first = false;
+                    if (frames.length === 0)
                         return;
-                    for (const event of events) {
-                        send(formatEvent(event));
-                        lastSeq = Math.max(lastSeq, event.seq);
+                    for (const frame of frames) {
+                        // A stored row this build cannot validate is skipped, not fatal. Failing the drain
+                        // errored the stream, and the client reconnected with the same `Last-Event-ID`, read
+                        // the same row and failed again, for good — and a payload reshaped by a server
+                        // upgrade is a protocol change, which AGENTS.md says stored matches survive.
+                        if (frame.text === null) {
+                            onUnreadable?.(frame.seq);
+                        }
+                        else {
+                            send(frame.text);
+                        }
+                        lastSeq = Math.max(lastSeq, frame.seq);
                     }
                 }
             };
-            const wake = () => {
+            /** True when a drain must reach the log rather than trust what this process was told. */
+            let forceNext = false;
+            const wake = (force = false) => {
                 if (closed)
                     return;
+                forceNext ||= force;
                 if (draining) {
                     wakeAgain = true;
                     return;
@@ -70,7 +107,9 @@ export function createSseResponse(source, options) {
                 draining = (async () => {
                     do {
                         wakeAgain = false;
-                        await drain();
+                        const forced = forceNext;
+                        forceNext = false;
+                        await drain(forced);
                     } while (wakeAgain && !closed);
                 })()
                     .catch((error) => {
@@ -100,14 +139,31 @@ export function createSseResponse(source, options) {
             // A thunk, not `shutdown` itself: the real one is assigned a few lines below and the
             // placeholder above it only flips `closed`, so passing the reference here would hand the
             // hub a close that leaves the heartbeat running and the subscription in place.
-            const unsubscribe = source.subscribe(wake, () => {
+            const unsubscribe = source.subscribe(() => wake(), () => {
                 shutdown();
             });
+            let beats = 0;
+            let stalledBeats = 0;
             const heartbeat = setInterval(() => {
+                // A consumer that is not reading is not a consumer. The queue is full, so this frame
+                // would only buffer; after a few beats of that the connection is gone in every way that
+                // matters and the stream is dropped rather than held; see the constant above.
+                if ((controller.desiredSize ?? 1) <= 0) {
+                    stalledBeats += 1;
+                    if (stalledBeats >= STALLED_HEARTBEATS_BEFORE_DROP)
+                        shutdown();
+                    return;
+                }
+                stalledBeats = 0;
                 send(`: ${SSE_HEARTBEAT_COMMENT}\n\n`);
                 // Fan-out is deliberately best-effort. Re-read the durable log even when the socket is
-                // healthy so a failed or process-local notification cannot strand this client forever.
-                wake();
+                // healthy so a failed or process-local notification cannot strand this client forever —
+                // but only when this process is not already certain there is nothing to read, because an
+                // idle server was otherwise issuing one query per stream per heartbeat to find nothing.
+                beats += 1;
+                const overdue = beats % CATCH_UP_EVERY_HEARTBEATS === 0;
+                if (overdue || !source.caughtUp(lastSeq))
+                    wake(overdue);
             }, options.heartbeatMs);
             shutdown = () => {
                 if (closed)
@@ -127,7 +183,8 @@ export function createSseResponse(source, options) {
             };
             options.signal.addEventListener('abort', shutdown, { once: true });
             send(': connected\n\n');
-            wake();
+            // The opening catch-up always reaches the log: a fresh stream has been told nothing.
+            wake(true);
         },
         // The consumer read enough to want more: let a drain parked on backpressure continue.
         pull() {
@@ -164,4 +221,29 @@ export function formatEvent(event) {
     const data = JSON.stringify(validated);
     return `id: ${validated.seq}\nevent: ${MATCH_EVENT_SSE_NAME}\ndata: ${data}\n\n`;
 }
+/** The same frame, or null when the stored row does not fit this build's schema. */
+export function tryFormatEvent(event) {
+    try {
+        return formatEvent(event);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether a stored row fits this build's schema, without building a frame from it.
+ *
+ * The REST read of the log uses this to leave an unreadable row out of its page. Asking
+ * `tryFormatEvent` there meant serialising every event of the page once to throw the string away
+ * and once more inside `c.json`.
+ */
+export function isReadableEvent(event) {
+    try {
+        validateSync(matchEventSchema, event);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=createSseResponse.js.map

package/dist/sse/createSseResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSseResponse.js","sourceRoot":"","sources":["../../src/sse/createSseResponse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createSseResponse.js","sourceRoot":"","sources":["../../src/sse/createSseResponse.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaos-overlords/server",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "The Hono application both runtimes serve: REST intents, the SSE event stream, auth and the error envelope. Takes its ports through a container.",
   "keywords": [
     "chaos-overlords",
@@ -48,16 +48,16 @@
     "provenance": true
   },
   "dependencies": {
-    "@chaos-overlords/bug-reports": "0.8.1",
-    "@chaos-overlords/contracts": "0.8.1",
-    "@chaos-overlords/kernel": "0.8.1",
+    "@chaos-overlords/bug-reports": "0.8.2",
+    "@chaos-overlords/contracts": "0.8.2",
+    "@chaos-overlords/kernel": "0.8.2",
     "@toad-contracts/core": "1.0.0",
     "@toad-contracts/hono": "1.0.0",
-    "hono": "^4.13.7"
+    "hono": "^4.13.8"
   },
   "devDependencies": {
-    "@chaos-overlords/conformance": "0.8.1",
-    "typescript": "^5.9.3",
+    "@chaos-overlords/conformance": "0.8.2",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.11"
   },
   "scripts": {