opinionated-machine 10.5.0 → 11.2.0

package/dist/lib/sse/eventIds.js

@@ -0,0 +1,155 @@
+/**
+ * Monotonic event-id helpers for SSE streams.
+ *
+ * The polling-fallback pattern (and `Last-Event-ID` reconnection/replay in
+ * general) needs event ids a client can ORDER, not just deduplicate: the
+ * client keeps a high-watermark and drops anything at or below it. Random
+ * UUIDs (the `broadcastToRoom` default) are unique but unordered; use a
+ * sequence from {@link createEventIdSequence} instead and pass its ids
+ * explicitly:
+ *
+ * ```ts
+ * const seq = createEventIdSequence()
+ * await broadcaster.broadcastToRoom(room, statusEvent, data, { id: seq.next() })
+ * ```
+ *
+ * Keep one sequence per ordering scope (per room, per resource, per stream) —
+ * ids from different scopes are not comparable. Stamp the same underlying
+ * version into the sync (poll) response body so the client can order
+ * snapshots against events.
+ *
+ * ## Choosing an id source
+ *
+ * Prefer a **domain version** (`job.version`, a revision column, an updated-at
+ * revision counter) over a generated sequence whenever the resource has one.
+ * A domain version is per-scope and writer-independent: any pod that writes the
+ * resource reads the same version, and the same number is already what the
+ * snapshot body has to carry for the client's version gate. Use
+ * {@link createEventIdSequence} when the resource has no version of its own.
+ *
+ * ## Hazard: per-process sequences are single-writer only
+ *
+ * {@link createEventIdSequence} is in-memory and per-process. Its epoch
+ * defaults to the process start time, and the client's default extractor
+ * orders by epoch first. That is safe only when a single writer owns the
+ * ordering scope.
+ *
+ * If two pods of the same service broadcast into the same room, each with its
+ * own per-process sequence, their epochs differ. The events interleave, the
+ * client's high-watermark lands on the newer epoch, and every subsequent event
+ * from the older-epoch pod compares as stale and is **silently dropped**. The
+ * failure only appears under horizontal scale, so it reaches production.
+ *
+ * For a multi-writer scope use one of:
+ *
+ * - a domain version (see above), or
+ * - a shared counter, e.g. `createRedisEventIdSequence()` from
+ *   `@opinionated-machine/sse-rooms-redis`, which backs the counter with
+ *   Redis `INCR` and shares one epoch across pods, or
+ * - a fixed `epoch` plus a `start` handed out from shared storage, so every
+ *   writer contributes to a single ordered run.
+ */
+/**
+ * Epochs are digits only, and so are counters.
+ *
+ * The client's default version extractor (`@opinionated-machine/sse-fallback`)
+ * has to tell a generated id apart from any other id shape a stream might
+ * carry, and a UUID matches `<anything>-<digits>` too — ordering events by a
+ * chunk of a UUID drops them at random. Restricting the epoch to digits is what
+ * makes `<digits>-<digits>` an unambiguous marker, so every id these helpers
+ * produce is one that extractor can order. Any other id scheme needs
+ * `version.ofEvent` declared on the client.
+ */
+const NUMERIC_EPOCH_PATTERN = /^\d+$/;
+const COUNTER_PAD = 12;
+/**
+ * Largest counter value that still fits in {@link COUNTER_PAD} digits. Beyond
+ * this the id grows a digit and stops sorting after its predecessor, so
+ * {@link createEventIdSequence} refuses to produce it.
+ */
+export const MAX_EVENT_ID_COUNTER = 999_999_999_999;
+/**
+ * Create a monotonic event-id sequence.
+ *
+ * Ids look like `"1754838000000-000000000042"`. Within one epoch they order
+ * lexicographically (fixed-width zero-padded counter).
+ *
+ * Sequences are in-memory and per-process, which makes them safe only for a
+ * single-writer ordering scope. See the module docs for the multi-writer
+ * hazard and the alternatives (domain versions, or a Redis-backed sequence).
+ *
+ * @throws TypeError if `epoch` is not a string of digits, or if `start` is not
+ *   an integer in `[0, MAX_EVENT_ID_COUNTER - 1]`.
+ */
+export function createEventIdSequence(options) {
+    const epoch = options?.epoch ?? String(Date.now());
+    if (!NUMERIC_EPOCH_PATTERN.test(epoch)) {
+        throw new TypeError(`createEventIdSequence: \`epoch\` must be a non-empty string of digits, got "${epoch}"`);
+    }
+    const start = options?.start ?? 0;
+    if (!Number.isInteger(start) || start < 0 || start >= MAX_EVENT_ID_COUNTER) {
+        throw new TypeError(`createEventIdSequence: \`start\` must be an integer in [0, ${MAX_EVENT_ID_COUNTER - 1}], got ${String(start)}`);
+    }
+    let counter = start;
+    let current;
+    return {
+        next() {
+            if (counter >= MAX_EVENT_ID_COUNTER) {
+                throw new RangeError(`createEventIdSequence: counter exhausted at ${MAX_EVENT_ID_COUNTER}; start a new epoch`);
+            }
+            counter += 1;
+            current = `${epoch}-${String(counter).padStart(COUNTER_PAD, '0')}`;
+            return current;
+        },
+        get current() {
+            return current;
+        },
+    };
+}
+const EVENT_ID_PATTERN = /^(\d+)-(\d+)$/;
+/**
+ * Compare two event ids produced by {@link createEventIdSequence}.
+ *
+ * Returns `-1` / `0` / `1` when both ids belong to the same epoch, and
+ * `undefined` when they don't (or when either id doesn't match the expected
+ * format). An `undefined` result means the ids are not ordered relative to
+ * each other — clients should treat that as "resynchronize via a snapshot
+ * poll" rather than guess.
+ */
+export function compareEventIds(a, b) {
+    const parsedA = EVENT_ID_PATTERN.exec(a);
+    const parsedB = EVENT_ID_PATTERN.exec(b);
+    if (!parsedA || !parsedB)
+        return undefined;
+    if (parsedA[1] !== parsedB[1])
+        return undefined;
+    const counterA = BigInt(parsedA[2]);
+    const counterB = BigInt(parsedB[2]);
+    if (counterA < counterB)
+        return -1;
+    if (counterA > counterB)
+        return 1;
+    return 0;
+}
+/**
+ * Format a counter value as an event id in the shape
+ * {@link createEventIdSequence} produces, so ids from a shared counter compare
+ * against ids from an in-process sequence with the same epoch.
+ *
+ * @throws TypeError if `epoch` is not a string of digits.
+ *   `createEventIdSequence()` refuses the same input: an id whose epoch is
+ *   empty (`"-000000000001"`) or free-form is one {@link compareEventIds}
+ *   cannot parse, so nothing downstream can order it.
+ * @throws RangeError if the counter does not fit the fixed id width.
+ */
+export function formatEventId(epoch, counter) {
+    if (!NUMERIC_EPOCH_PATTERN.test(epoch)) {
+        throw new TypeError(`formatEventId: \`epoch\` must be a non-empty string of digits, got "${epoch}"`);
+    }
+    const asBigInt = typeof counter === 'bigint' ? counter : BigInt(counter);
+    if (asBigInt < 1n || asBigInt > BigInt(MAX_EVENT_ID_COUNTER)) {
+        throw new RangeError(`formatEventId: counter must be in [1, ${MAX_EVENT_ID_COUNTER}], got ${String(counter)}`);
+    }
+    return `${epoch}-${asBigInt.toString().padStart(COUNTER_PAD, '0')}`;
+}
+//# sourceMappingURL=eventIds.js.map

package/dist/lib/sse/eventIds.js.map

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

package/dist/lib/sse/index.d.ts

@@ -1,9 +1,10 @@
 export type { AllContractEventNames, AllContractEvents, AnySSEContractDefinition, ExtractEventSchema, SSEContractDefinition, SSEEventSchemas, SSEMethod, } from '@lokalise/api-contracts';
+export { createSSEStreamParser, type ParsedSSEEvent, type ParseSSEBufferResult, type ParseSSEStreamOptions, parseSSEBuffer, parseSSEEvents, parseSSEResponse, parseSSEStream, type SSEResponseLike, type SSEStreamParser, type SSEStreamParserOptions, } from '@opinionated-machine/sse-parser';
 export { type BuildFastifySSERoutesReturnType, buildFastifyRoute, buildHandler, type FastifySSEHandlerConfig, type FastifySSEPreHandler, type FastifySSERouteOptions, type InferSSERequest, type RegisterSSERoutesOptions, type SSEContext, type SSEOnlyHandlers, type SSERouteHandler, type SSESession, } from '../routes/index.js';
 export { AbstractSSEController, type SSEControllerConfig, type SSEEventSender, type SSELogger, type SSEMessage, } from './AbstractSSEController.js';
 export { defineEvent, type SSEEventDefinition } from './defineEvent.js';
-export { defineRoom, InMemoryAdapter, type PreDeliveryFilter, type RoomBroadcastOptions, type RoomNameResolver, type SSERoomAdapter, SSERoomBroadcaster, SSERoomManager, type SSERoomManagerConfig, type SSERoomMessageHandler, type SSERoomOperations, } from './rooms/index.js';
+export { type AsyncEventIdSequence, type CreateEventIdSequenceOptions, compareEventIds, createEventIdSequence, type EventIdSequence, formatEventId, MAX_EVENT_ID_COUNTER, } from './eventIds.js';
+export { defineRoom, InMemoryAdapter, type PreDeliveryFilter, type RoomBroadcastOptions, type RoomNameResolver, type SSELogContext, type SSERoomAdapter, SSERoomBroadcaster, SSERoomEventPublisher, type SSERoomEventPublisherDependencies, type SSERoomEventPublishOptions, SSERoomManager, type SSERoomManagerConfig, type SSERoomMessageHandler, type SSERoomOperations, } from './rooms/index.js';
 export { type SpiedSSESession, type SSESessionEvent, SSESessionSpy } from './SSESessionSpy.js';
-export { type ParsedSSEEvent, type ParseSSEBufferResult, parseSSEBuffer, parseSSEEvents, } from './sseParser.js';
 export { SSE_DIAGNOSTICS_HEADER, type SSEDiagnosticsScope, type SSESendFailure, } from './sseSendDiagnostics.js';
 export { defineEventMetadata, type ExtractMetadata, type FilterVerdict, type IncomingEvent, type MetadataGuard, type MetadataGuards, type PublishResult, type ResolverResult, SSESubscriptionManager, type SSESubscriptionManagerConfig, type SubscriptionContext, type SubscriptionPolicy, type SubscriptionResolver, } from './subscriptions/index.js';

package/dist/lib/sse/index.js

@@ -1,11 +1,15 @@
+// The wire-format parser lives in its own package so that the browser client
+// (@opinionated-machine/sse-fallback) frames the stream with the same code the
+// server's test helpers do.
+export { createSSEStreamParser, parseSSEBuffer, parseSSEEvents, parseSSEResponse, parseSSEStream, } from '@opinionated-machine/sse-parser';
 // Re-export route types from routes module
 export { buildFastifyRoute, buildHandler, } from '../routes/index.js';
 export { AbstractSSEController, } from './AbstractSSEController.js';
 export { defineEvent } from './defineEvent.js';
+export { compareEventIds, createEventIdSequence, formatEventId, MAX_EVENT_ID_COUNTER, } from './eventIds.js';
 // Re-export room types and classes
-export { defineRoom, InMemoryAdapter, SSERoomBroadcaster, SSERoomManager, } from './rooms/index.js';
+export { defineRoom, InMemoryAdapter, SSERoomBroadcaster, SSERoomEventPublisher, SSERoomManager, } from './rooms/index.js';
 export { SSESessionSpy } from './SSESessionSpy.js';
-export { parseSSEBuffer, parseSSEEvents, } from './sseParser.js';
 export { SSE_DIAGNOSTICS_HEADER, } from './sseSendDiagnostics.js';
 // SSE Subscriptions
 export { defineEventMetadata, SSESubscriptionManager, } from './subscriptions/index.js';

package/dist/lib/sse/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/sse/index.ts"],"names":[],"mappings":"AAUA,2CAA2C;AAC3C,OAAO,EAEL,iBAAiB,EACjB,YAAY,GAUb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,qBAAqB,GAKtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAA;AACvE,mCAAmC;AACnC,OAAO,EACL,UAAU,EACV,eAAe,EAKf,kBAAkB,EAClB,cAAc,GAIf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAA8C,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC9F,OAAO,EAGL,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAA;AAChC,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EAQnB,sBAAsB,GAKvB,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/sse/index.ts"],"names":[],"mappings":"AAUA,6EAA6E;AAC7E,+EAA+E;AAC/E,4BAA4B;AAC5B,OAAO,EACL,qBAAqB,EAIrB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GAIf,MAAM,iCAAiC,CAAA;AACxC,2CAA2C;AAC3C,OAAO,EAEL,iBAAiB,EACjB,YAAY,GAUb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,qBAAqB,GAKtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAGL,eAAe,EACf,qBAAqB,EAErB,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAA;AACtB,mCAAmC;AACnC,OAAO,EACL,UAAU,EACV,eAAe,EAMf,kBAAkB,EAClB,qBAAqB,EAGrB,cAAc,GAIf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAA8C,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC9F,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAA;AAChC,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EAQnB,sBAAsB,GAKvB,MAAM,0BAA0B,CAAA"}

package/dist/lib/sse/rooms/SSERoomEventPublisher.d.ts

@@ -0,0 +1,121 @@
+import { type Either, InternalError } from '@lokalise/node-core';
+import type { z } from 'zod';
+import type { SSEEventDefinition } from '../defineEvent.js';
+import type { SSELogger } from '../sseTypes.js';
+import type { SSERoomBroadcaster } from './SSERoomBroadcaster.js';
+import type { RoomBroadcastOptions } from './types.js';
+export type SSERoomEventPublisherDependencies = {
+    sseRoomBroadcaster: SSERoomBroadcaster;
+    logger: SSELogger;
+};
+/**
+ * Whatever the caller is working on behalf of, narrowed to the one thing the publisher needs
+ * from it. `@lokalise/fastify-extras`' `RequestContext` satisfies this structurally, as does a
+ * job or consumer context of your own, so neither this package nor its callers need an adapter.
+ */
+export type SSELogContext = {
+    logger: SSELogger;
+};
+/**
+ * Everything {@link SSERoomBroadcaster.broadcastToRoom} accepts, so the publisher is not a lossy
+ * wrapper over it.
+ */
+export type SSERoomEventPublishOptions = RoomBroadcastOptions & {
+    /**
+     * The SSE `id:` put on the wire. Defaults to a random UUID. Set it to a value a client can
+     * order, such as the sequence from `createEventIdSequence()`, when consumers deduplicate or
+     * resume by event id.
+     */
+    id?: string;
+    /** The SSE `retry:` hint, in milliseconds: how long a client waits before reconnecting. */
+    retry?: number;
+    /**
+     * Per-broadcast context handed to the pre-delivery filter, and to other nodes alongside the
+     * message. Only a filter reads it (`SSESubscriptionManager` installs one to evaluate its
+     * resolver pipeline), so it is redundant unless one is installed.
+     */
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Fire-and-forget broadcasting for domain code: a room event goes out and the caller does not
+ * await the fan-out.
+ *
+ * The typical producer is an event listener or a message handler whose primary work has already
+ * committed. It cannot retry a dropped hint, and awaiting the fan-out would tie its latency to
+ * the number of open connections. Code that needs the delivered count, or that can act on a
+ * delivery failure, should use {@link SSERoomBroadcaster} directly.
+ *
+ * The two ways publishing fails are treated differently, because they are different kinds of
+ * problem:
+ *
+ * - **A payload that violates its own event schema is a bug in the producer.** Nobody receives
+ *   the event, so swallowing it means believing you published something you did not.
+ *   {@link publish} throws. {@link safePublish} returns the error instead, for a caller that
+ *   cannot absorb a throw.
+ * - **A failed broadcast is the world's problem**, and no caller here can retry it, so both
+ *   methods log it. It also happens after the call has returned, which is why neither method can
+ *   report it in a return value.
+ *
+ * @example
+ * ```typescript
+ * // In your DI module
+ * sseRoomEventPublisher: asSingletonClass(SSERoomEventPublisher),
+ *
+ * // In a listener. `requestContext` is passed straight through: the publisher reads its
+ * // logger, so a dropped event carries the correlation id of whatever produced it.
+ * this.publisher.publish(
+ *   ProjectSse.roomResolver(projectId),
+ *   ProjectSse.events.updated,
+ *   payload,
+ *   requestContext,
+ * )
+ * ```
+ */
+export declare class SSERoomEventPublisher {
+    private readonly sseRoomBroadcaster;
+    private readonly logger;
+    constructor({ sseRoomBroadcaster, logger }: SSERoomEventPublisherDependencies);
+    /**
+     * Validate `data` against the event's own schema and broadcast it to `room`, throwing if it
+     * fails.
+     *
+     * Validating here rather than leaving it to delivery is what makes the throw possible at all.
+     * Delivery-time validation runs once per connection, so it reports a mismatch once per open
+     * connection on every node, names the event but not the code that produced it, and does not
+     * run at all when nobody has joined the room. By then the call has long returned and there is
+     * nothing left to throw to.
+     *
+     * What goes on the wire is the parsed value, so a schema default is filled in once here
+     * instead of being left to every client. Delivery-time validation discards its own result and
+     * serializes what it was handed, so calling {@link SSERoomBroadcaster.broadcastToRoom}
+     * directly sends the unparsed input.
+     *
+     * `context` is whatever the caller is acting on behalf of; only its logger is read, so a
+     * request context goes in as-is. Omit it in a caller that has none and the injected logger is
+     * used, which costs a logged failure its correlation id and nothing else.
+     *
+     * @throws {InternalError} if `data` does not satisfy the event's schema.
+     */
+    publish<T extends z.ZodType>(room: string | string[], event: SSEEventDefinition<string, T>, data: z.input<T>, context?: SSELogContext, options?: SSERoomEventPublishOptions): void;
+    /**
+     * {@link publish}, but a payload that fails its schema comes back as an error instead of being
+     * thrown.
+     *
+     * For a producer that cannot absorb a throw: a message handler whose primary work has already
+     * committed would be retried in full and redo it, and the retry cannot succeed anyway, since a
+     * malformed payload fails the same way every time. Prefer {@link publish} everywhere else.
+     *
+     * The failure is logged as well as returned, so a caller that ignores the result still leaves
+     * a trace rather than silence.
+     *
+     * @returns `{ result: true }` once the payload has been validated and handed to the
+     * broadcaster. That is acceptance, not delivery: the fan-out has not happened yet, and its
+     * own failure is logged rather than returned.
+     */
+    safePublish<T extends z.ZodType>(room: string | string[], event: SSEEventDefinition<string, T>, data: z.input<T>, context?: SSELogContext, options?: SSERoomEventPublishOptions): Either<InternalError, true>;
+    /**
+     * The shared tail of both methods. A failed broadcast is logged rather than surfaced: it
+     * happens after the caller has returned, and none of these callers could retry it anyway.
+     */
+    private broadcast;
+}

package/dist/lib/sse/rooms/SSERoomEventPublisher.js

@@ -0,0 +1,119 @@
+import { InternalError } from '@lokalise/node-core';
+/** The same error either way, so a caller switching between the two methods sees one shape. */
+const validationError = (room, event, error) => new InternalError({
+    message: `SSE event validation failed for event "${event}": ${error.message}`,
+    errorCode: 'SSE_EVENT_VALIDATION_FAILED',
+    details: { room: Array.isArray(room) ? room.join(',') : room, event },
+});
+/**
+ * Fire-and-forget broadcasting for domain code: a room event goes out and the caller does not
+ * await the fan-out.
+ *
+ * The typical producer is an event listener or a message handler whose primary work has already
+ * committed. It cannot retry a dropped hint, and awaiting the fan-out would tie its latency to
+ * the number of open connections. Code that needs the delivered count, or that can act on a
+ * delivery failure, should use {@link SSERoomBroadcaster} directly.
+ *
+ * The two ways publishing fails are treated differently, because they are different kinds of
+ * problem:
+ *
+ * - **A payload that violates its own event schema is a bug in the producer.** Nobody receives
+ *   the event, so swallowing it means believing you published something you did not.
+ *   {@link publish} throws. {@link safePublish} returns the error instead, for a caller that
+ *   cannot absorb a throw.
+ * - **A failed broadcast is the world's problem**, and no caller here can retry it, so both
+ *   methods log it. It also happens after the call has returned, which is why neither method can
+ *   report it in a return value.
+ *
+ * @example
+ * ```typescript
+ * // In your DI module
+ * sseRoomEventPublisher: asSingletonClass(SSERoomEventPublisher),
+ *
+ * // In a listener. `requestContext` is passed straight through: the publisher reads its
+ * // logger, so a dropped event carries the correlation id of whatever produced it.
+ * this.publisher.publish(
+ *   ProjectSse.roomResolver(projectId),
+ *   ProjectSse.events.updated,
+ *   payload,
+ *   requestContext,
+ * )
+ * ```
+ */
+export class SSERoomEventPublisher {
+    sseRoomBroadcaster;
+    logger;
+    constructor({ sseRoomBroadcaster, logger }) {
+        this.sseRoomBroadcaster = sseRoomBroadcaster;
+        this.logger = logger;
+    }
+    /**
+     * Validate `data` against the event's own schema and broadcast it to `room`, throwing if it
+     * fails.
+     *
+     * Validating here rather than leaving it to delivery is what makes the throw possible at all.
+     * Delivery-time validation runs once per connection, so it reports a mismatch once per open
+     * connection on every node, names the event but not the code that produced it, and does not
+     * run at all when nobody has joined the room. By then the call has long returned and there is
+     * nothing left to throw to.
+     *
+     * What goes on the wire is the parsed value, so a schema default is filled in once here
+     * instead of being left to every client. Delivery-time validation discards its own result and
+     * serializes what it was handed, so calling {@link SSERoomBroadcaster.broadcastToRoom}
+     * directly sends the unparsed input.
+     *
+     * `context` is whatever the caller is acting on behalf of; only its logger is read, so a
+     * request context goes in as-is. Omit it in a caller that has none and the injected logger is
+     * used, which costs a logged failure its correlation id and nothing else.
+     *
+     * @throws {InternalError} if `data` does not satisfy the event's schema.
+     */
+    publish(room, event, data, context, options) {
+        const validation = event.schema.safeParse(data);
+        if (!validation.success) {
+            throw validationError(room, event.event, validation.error);
+        }
+        this.broadcast(room, event, validation.data, context, options);
+    }
+    /**
+     * {@link publish}, but a payload that fails its schema comes back as an error instead of being
+     * thrown.
+     *
+     * For a producer that cannot absorb a throw: a message handler whose primary work has already
+     * committed would be retried in full and redo it, and the retry cannot succeed anyway, since a
+     * malformed payload fails the same way every time. Prefer {@link publish} everywhere else.
+     *
+     * The failure is logged as well as returned, so a caller that ignores the result still leaves
+     * a trace rather than silence.
+     *
+     * @returns `{ result: true }` once the payload has been validated and handed to the
+     * broadcaster. That is acceptance, not delivery: the fan-out has not happened yet, and its
+     * own failure is logged rather than returned.
+     */
+    safePublish(room, event, data, context, options) {
+        const validation = event.schema.safeParse(data);
+        if (!validation.success) {
+            const logger = context?.logger ?? this.logger;
+            logger.error({ room, event: event.event, issues: validation.error.issues }, 'Refusing to broadcast an SSE event that fails its own schema');
+            return { error: validationError(room, event.event, validation.error) };
+        }
+        this.broadcast(room, event, validation.data, context, options);
+        return { result: true };
+    }
+    /**
+     * The shared tail of both methods. A failed broadcast is logged rather than surfaced: it
+     * happens after the caller has returned, and none of these callers could retry it anyway.
+     */
+    broadcast(room, event, 
+    // Already schema-valid, so the re-parse at delivery accepts it. The cast below is only
+    // needed because `z.output` is not `z.input` for a schema that defaults or transforms.
+    parsed, context, options) {
+        const logger = context?.logger ?? this.logger;
+        this.sseRoomBroadcaster
+            .broadcastToRoom(room, event, parsed, options)
+            .catch((error) => {
+            logger.error({ error, room, event: event.event }, 'Failed to broadcast SSE event');
+        });
+    }
+}
+//# sourceMappingURL=SSERoomEventPublisher.js.map

package/dist/lib/sse/rooms/SSERoomEventPublisher.js.map

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

package/dist/lib/sse/rooms/index.d.ts

@@ -1,5 +1,6 @@
 export { InMemoryAdapter } from './adapters/InMemoryAdapter.js';
 export { defineRoom } from './defineRoom.js';
 export { SSERoomBroadcaster } from './SSERoomBroadcaster.js';
+export { type SSELogContext, SSERoomEventPublisher, type SSERoomEventPublisherDependencies, type SSERoomEventPublishOptions, } from './SSERoomEventPublisher.js';
 export { SSERoomManager } from './SSERoomManager.js';
 export type { PreDeliveryFilter, RoomBroadcastOptions, RoomNameResolver, SSERoomAdapter, SSERoomManagerConfig, SSERoomMessageHandler, SSERoomOperations, } from './types.js';

package/dist/lib/sse/rooms/index.js

@@ -3,5 +3,6 @@
 export { InMemoryAdapter } from './adapters/InMemoryAdapter.js';
 export { defineRoom } from './defineRoom.js';
 export { SSERoomBroadcaster } from './SSERoomBroadcaster.js';
+export { SSERoomEventPublisher, } from './SSERoomEventPublisher.js';
 export { SSERoomManager } from './SSERoomManager.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/sse/rooms/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/sse/rooms/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AAEpB,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/sse/rooms/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AAEpB,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAEL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/lib/testing/apiSseEventValidation.d.ts

@@ -7,7 +7,7 @@
  */
 import type { SSEEventSchemas } from '@lokalise/api-contracts';
 import { type ApiContract } from '@lokalise/api-contracts';
-import type { ParsedSSEEvent } from '../sse/sseParser.ts';
+import type { ParsedSSEEvent } from '@opinionated-machine/sse-parser';
 import type { ApiSSEEvent } from './apiSseTestTypes.ts';
 /**
  * The contract's SSE schemas, merged across every declared status, or a thrown error naming

package/dist/lib/testing/apiSseInjectHelpers.js

@@ -1,5 +1,5 @@
 import { buildRequestPath, resolveResponseEntry, } from '@lokalise/api-contracts';
-import { parseSSEBuffer, parseSSEEvents } from "../sse/sseParser.js";
+import { createSSEStreamParser, parseSSEEvents, } from '@opinionated-machine/sse-parser';
 import { describeSendFailures, openSSEDiagnosticsScope, unhandledSendFailures, } from "../sse/sseSendDiagnostics.js";
 import { assertSSEResponse, mediaTypeOf, resolveApiSseSchemas, SSE_CONTENT_TYPE, validateApiSseEvent, } from "./apiSseEventValidation.js";
 import { truncateBody } from "./sseInjectShared.js";
@@ -156,15 +156,15 @@ class InjectedSSEStream {
             throw err;
         }
         let body = '';
-        let buffer = '';
         const decoder = new TextDecoder();
+        // Owns the partial frame across chunks, so a frame split by a flush boundary
+        // is not read as two.
+        const parser = createSSEStreamParser();
         try {
             for await (const chunk of res.stream()) {
                 const text = typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true });
                 body += text;
-                buffer += text;
-                const { events, remaining } = parseSSEBuffer(buffer);
-                buffer = remaining;
+                const events = parser.push(text);
                 if (events.length > 0) {
                     this.received.push(...events);
                     this.notify();
@@ -175,11 +175,10 @@ class InjectedSSEStream {
             this.fail(err);
             throw err;
         }
-        // A stream that ended without a terminating blank line still carries one last event.
-        const trailing = parseSSEEvents(buffer);
-        if (trailing.length > 0) {
-            this.received.push(...trailing);
-        }
+        // Anything still buffered is a frame the response ended in the middle of. The spec
+        // discards pending data at the end of a stream, so it is not delivered as an event:
+        // a truncated payload reported as a real one hides the handler bug that produced it.
+        // The raw text is still on `body` for a test that wants to look.
         this.ended = true;
         this.notify();
         return {

package/dist/lib/testing/apiSseInjectHelpers.js.map

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

package/dist/lib/testing/sseHttpClient.d.ts

@@ -1,7 +1,7 @@
 import type { ApiContract } from '@lokalise/api-contracts';
+import { type ParsedSSEEvent } from '@opinionated-machine/sse-parser';
 import type { SSESession } from '../routes/fastifyRouteTypes.ts';
 import type { SpiedSSESession, SSESessionSpy } from '../sse/SSESessionSpy.ts';
-import { type ParsedSSEEvent } from '../sse/sseParser.ts';
 import type { ApiSSEEvent } from './apiSseTestTypes.ts';
 /**
  * Interface for objects that have a sessionSpy (e.g., SSE controllers in test mode).
@@ -163,11 +163,19 @@ export declare class SSEHttpClient {
      * subsequent body read with an `AbortError`.
      */
     readonly response: Response;
+    /**
+     * Optional hook invoked with every decoded raw text chunk as it arrives —
+     * including comment frames (e.g. `: heartbeat`) that the SSE parser drops.
+     * Useful for asserting heartbeat delivery or tracking byte-level liveness.
+     * Only fires while the stream is being consumed via events()/collectEvents().
+     */
+    onRawChunk?: (chunk: string) => void;
     private readonly abortController;
     private readonly responseBody;
     private streamReader;
     private readonly decoder;
-    private buffer;
+    /** Owns the partial-frame buffer and the Last-Event-ID cursor across chunks. */
+    private readonly parser;
     private closed;
     private constructor();
     /**