@beignet/core 0.0.49 → 0.0.50

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @beignet/core
 
+## 0.0.50
+
+### Patch Changes
+
+- 6fe026a: Expose event-subscription readiness and asynchronous cleanup, await listener
+  registries during provider startup with bounded rollback, diagnose unsafe app
+  wiring, and make Redis subscription lifecycle failures observable with bounded
+  provider shutdown and recoverable channel state.
+- 4be4573: Keep mail content out of provider instrumentation, document the Redis
+  deployment policy required for monotonic fencing, and align generated agent
+  guidance with optional seed, worker, and migration paths.
+- ee402a9: Map invalid adapter URLs to framework responses, cancel oversized request
+  streams, distinguish typed idempotency inputs, preserve repeated response
+  headers, and match Unicode static routes against encoded URL pathnames.
+- d1db53e: Add a portable Server-Sent Events response helper with JSON framing,
+  heartbeats, bounded unread buffering, optional maximum lifetime,
+  cancellation-aware asynchronous setup, eventual late cleanup, and safe
+  response headers, expose native request cancellation through
+  `HttpRequestLike.signal`, and use recoverable bounded snapshots for the
+  Devtools live stream with visible partial-data reporting.
+- 7b0961b: Add a non-durable best-effort work port, a recording test adapter, and a Next.js `after()` adapter that isolates scheduler and callback failures.
+
 ## 0.0.49
 
 ### Patch Changes

package/README.md

@@ -72,11 +72,11 @@ name the framework area they depend on.
 | `@beignet/core/outbox` | Durable event and job outbox |
 | `@beignet/core/payments` | Payments port, memory payments adapter, and memory payments provider |
 | `@beignet/core/pagination` | Offset/cursor page types, normalizers, and result helpers |
-| `@beignet/core/ports` | App-facing ports, auth, audit, policies, cache, storage, logging, and redaction |
+| `@beignet/core/ports` | App-facing ports, auth, audit, policies, cache, storage, best-effort work, logging, and redaction |
 | `@beignet/core/providers` | Provider lifecycle and instrumentation primitives |
 | `@beignet/core/search` | Search index definitions, SearchPort, memory adapter, memory provider, and helpers |
 | `@beignet/core/schedules` | Schedule primitives |
-| `@beignet/core/server` | Framework-agnostic server runtime, security headers, CSRF, and hook helpers |
+| `@beignet/core/server` | Framework-agnostic server runtime, SSE responses, security headers, CSRF, and hook helpers |
 | `@beignet/core/server-only` | Static lint marker for modules that must stay out of client bundles |
 | `@beignet/core/tasks` | Operational task definitions and inline task execution |
 | `@beignet/core/tenancy` | Branded tenant scope helpers for repository boundaries |
@@ -313,6 +313,55 @@ and dead-lettered messages when you pass a devtools or instrumentation port to
 `drainOutbox(...)`. Pass `instrumentationContext` when the worker has request or
 trace IDs that should connect the drain to devtools rows.
 
+## Best-effort work
+
+`BestEffortWorkPort` lets application code request non-durable follow-up work
+without waiting for it in the originating operation:
+
+```ts
+import type { BestEffortWorkPort } from "@beignet/core/ports";
+
+export type AppPorts = {
+  bestEffortWork: BestEffortWorkPort;
+};
+
+ctx.ports.bestEffortWork.defer(() =>
+  ctx.ports.workspaceBroadcast.publish(workspaceId, message),
+);
+```
+
+Use it only when losing the callback does not change the operation's result,
+such as publishing a cache-invalidation hint after the authoritative write has
+committed. The adapter owns scheduler and callback error isolation. Use a job
+or transaction-scoped outbox when work must be retried or survive process
+termination.
+
+Tests can use `createRecordingBestEffortWork()` directly or the default
+`bestEffortWork` returned by `createTestPorts(...)`. Call
+`fixture.flushBestEffortWork()` to run the current queued batch deterministically;
+callbacks deferred by that batch remain pending until the next flush. A flush
+attempts the complete batch before rejecting with any callback failures.
+
+## Event subscriptions
+
+`EventBusPort.subscribe(...)` returns an `EventSubscription` with a `ready`
+promise and asynchronous, idempotent `unsubscribe()` method. Await `ready`
+before advertising that a process can receive events, and await
+`unsubscribe()` during shutdown. The memory adapter is ready immediately;
+transport adapters resolve readiness only after their initial subscription is
+active.
+
+`registerListeners(...)` combines a listener registry into one subscription.
+It waits for every child subscription and applies one 10-second registration
+deadline by default. When setup fails or times out, Beignet starts every child
+cleanup within the remaining deadline. If cleanup does not settle in time,
+`ready` rejects with both the startup failure and a
+`ListenerRegistrationCleanupTimeoutError` instead of hanging startup. Set
+`readyTimeoutMs` when the process needs a different bounded startup policy.
+Normal teardown after successful readiness still awaits transport cleanup;
+apply a host-level shutdown deadline when required. Readiness is an initial
+lifecycle signal, not an ongoing health check or durability guarantee.
+
 ## Provider-contributed ports
 
 Apps bind app-owned ports directly and defer the rest to providers with the
@@ -381,7 +430,9 @@ defer those ports before choosing production infrastructure.
 `createMemoryMailerProvider(options?)` contributes `{ mailer: MailerPort }`
 backed by `createMemoryMailer(...)`. Deliveries are captured in memory and
 recorded as `mail.sent` devtools events through the `mail` watcher when an
-instrumentation port is installed. Options extend
+instrumentation port is installed. Instrumentation records only the provider,
+recipient count, delivery ID, and duration; it does not record addresses,
+subjects, or message bodies. Options extend
 `CreateMemoryMailerOptions` (`defaultFrom`, `now`, `id`, `onSend`) plus a
 provider `name` that defaults to `"memory-mailer"`.
 
@@ -1080,6 +1131,78 @@ feeds metadata-driven hooks such as rate limiting exactly like contract
 metadata, and the route is not added to the registry — the adapter mounts
 the returned handler at the route's own path.
 
+### Server-sent events
+
+`createServerSentEventResponse(...)` creates a portable Fetch `Response` for
+an SSE endpoint. Use it from a contract handler or raw route after
+application-owned authentication and authorization:
+
+```ts
+import { createServerSentEventResponse } from "@beignet/core/server";
+
+return createServerSentEventResponse({
+  signal: req.signal,
+  maxLifetimeMs: 240_000,
+  start({ send }) {
+    send({ event: "reconcile", data: { workspaceId } });
+    const subscription = ctx.ports.workspaceBroadcast.subscribe(
+      workspaceId,
+      (change) => {
+        send({ event: "changed", data: change });
+      },
+    );
+    return { close: () => subscription.unsubscribe() };
+  },
+  onError: (error) => ctx.ports.logger.error("SSE stream failed", { error }),
+});
+```
+
+Event `data` is JSON-encoded. Optional `event`, `id`, and `retry` fields use
+standard SSE framing; `retry` sets the browser reconnection delay in
+milliseconds. `comment(...)` sends an explicit comment, and `close()` ends the
+response. `send(...)` and `comment(...)` return `true` when they enqueue a
+frame and `false` after closure, when framing or encoding fails, or when the
+unread byte limit would be exceeded. Event names and IDs must fit on one line,
+and IDs cannot contain null characters. A producer, framing, encoding, stream,
+or buffer-overflow failure reports through `onError` and closes the connection.
+
+Heartbeat comments default to 25 seconds; `heartbeatMs: false` disables them.
+`maxLifetimeMs` is opt-in. Both options accept `false` or an integer from `1`
+through `2_147_483_647`; `retry` accepts an integer from `0` through the same
+maximum. `start(...)` receives a stream-scoped `signal` that aborts whenever
+the response closes. Pass it to subscription APIs that perform asynchronous
+setup. `start(...)` may return a cleanup callback, a closeable subscription, a
+promise of either, or nothing. If it returns cleanup, request abort, response
+cancellation, explicit close, and maximum lifetime invoke that cleanup exactly
+once. `onError` also observes cleanup failures without creating an unhandled
+rejection. When stream closure aborts asynchronous setup, an expected
+`AbortError` rejection is treated as cancellation rather than a producer
+failure; other setup rejections still reach `onError`.
+
+Unread encoded frames are bounded to `1_048_576` bytes by default. Set
+`maxBufferedBytes` to an integer from `1` through `2_147_483_647` when the
+endpoint has a verified frame-size requirement. If one frame or the
+accumulated unread queue would exceed the limit, the helper reports a
+`RangeError` and closes the connection; the limit remains active even when
+`maxLifetimeMs` is disabled. Response-body cancellation waits for cleanup that
+has already been registered, but it does not wait indefinitely for pending
+asynchronous setup. The stream signal lets setup stop cooperatively, and any
+cleanup returned after closure still runs exactly once.
+
+The response always sets `Content-Type: text/event-stream`,
+`Cache-Control: no-store, no-transform`, and `X-Accel-Buffering: no`, removes
+`Content-Length` and hop-by-hop streaming headers, and preserves other custom
+headers supplied through `headers`. The helper does not own authorization,
+replay, durability, distributed connection limits, or client reconciliation.
+Keep authoritative state elsewhere and reconcile on initial connection and
+reconnect when messages are best-effort hints.
+
+Use a contract handler when the stream belongs in the route registry and
+OpenAPI document. Use a raw route when the endpoint is transport-only and the
+app owns its request and response shape. Document a contract stream with a
+`.responses({ 200: null })` success schema and an OpenAPI `text/event-stream`
+media override.
+
 Use `.headers(...)` for request headers that are part of the endpoint contract. Declare header keys in lowercase; server and client runtime matching is case-insensitive.
 
 Request bodies are supported for `POST`, `PUT`, and `PATCH` contracts only.
@@ -1177,7 +1300,8 @@ const tester = createUseCaseTester<AppContext>(createContext);
 The returned fixture exposes captured side effects such as `events`,
 `dispatchedJobs`, `audit.entries`, `mailer.deliveries`,
 `notifications.deliveries`, `outbox.messages`, and memory storage for
-assertions.
+assertions. Its default `bestEffortWork` port queues callbacks in
+`pendingBestEffortWork`; call `flushBestEffortWork()` to run the current batch.
 
 `overrides` is typed as `TestPortsOverrides<Ports>`, which accepts typed
 partial ports without casts. The partial rule is one level deep: an
@@ -1821,6 +1945,14 @@ import { createMemoryIdempotencyStore } from "@beignet/core/idempotency";
 const idempotency = createMemoryIdempotencyStore();
 ```
 
+`createIdempotencyFingerprint(...)` sorts object keys and tags non-JSON values
+before hashing while retaining the stable representation of ordinary JSON
+payloads. BigInts and Dates therefore remain distinct from same-looking
+strings; invalid dates, non-finite numbers, circular values, and the reserved
+tag key fail instead of producing ambiguous fingerprints. Non-plain objects
+other than `Date` fail as unsupported; project them to plain command data
+before hashing.
+
 Reservation tokens use Web Crypto `randomUUID()` or `getRandomValues()` when
 available and securely fall back to `node:crypto` on supported Node runtimes.
 The memory adapter accepts `createReservationToken` when a deterministic test
@@ -2053,6 +2185,24 @@ Use `{ contract, handle }` as the escape hatch for response headers,
 streaming, and multi-status responses. `defineRoute` remains
 available for full handlers that read hook-added `ctx` fields.
 
+Framework-neutral response header values may be strings or string arrays.
+Use an array for repeated fields such as `Set-Cookie`; Web-compatible adapters
+append every item separately, and hooks receive the same string-or-array
+header record:
+
+```ts
+return {
+  status: 200,
+  headers: {
+    "set-cookie": [
+      "session=abc; Path=/; HttpOnly; Secure; SameSite=Lax",
+      "theme=dark; Path=/; Secure; SameSite=Lax",
+    ],
+  },
+  body: { ok: true },
+};
+```
+
 When credentials live in request headers, declare a `headers` schema on the
 auth hooks. The hook validates the raw lowercase request header record before
 `resolve` runs, so `resolve` receives typed header values; on `required()`
@@ -2154,13 +2304,17 @@ status, including when reading the response stream itself fails.
 request validation, response validation, error mapping, and provider lifecycle.
 Adapters own the platform edge only:
 
-- Convert the native request into `HttpRequestLike`
+- Convert the native request into `HttpRequestLike`, including its abort
+  signal when the platform exposes one
 - Call `server.api(...)` or a single route handler
 - Convert `HttpResponse` back into the native response type
 
 The public adapter contract is `HttpAdapter<NativeRequest, NativeResponse>`.
 Use it when building a runtime package beyond the first-party `@beignet/web`
-and `@beignet/next` adapters.
+and `@beignet/next` adapters. Custom adapters must supply an absolute HTTP or
+HTTPS `HttpRequestLike.url`; invalid values are converted to a framework-owned
+`400 INVALID_REQUEST_URL` response instead of escaping as a rejected handler
+promise.
 
 ### Health and readiness
 

package/dist/events/index.d.ts

@@ -47,6 +47,45 @@ export interface EventPublishOptions {
     /** Versioned trace context captured by the event producer. */
     trace?: TraceCarrier;
 }
+/**
+ * Lifecycle handle for one event subscription or a composed listener
+ * registration.
+ *
+ * `ready` proves initial transport readiness. It does not represent ongoing
+ * connectivity, durability, replay, or handler success after startup.
+ */
+export interface EventSubscription {
+    /** Resolves when the subscription can receive events. */
+    readonly ready: Promise<void>;
+    /** Stop local delivery and await transport cleanup. Idempotent. */
+    unsubscribe(): Promise<void>;
+}
+/** Error used when a subscription closes before initial readiness. */
+export declare class EventSubscriptionClosedError extends Error {
+    constructor(message?: string);
+}
+/** Error thrown when a listener registry misses its readiness deadline. */
+export declare class ListenerRegistrationTimeoutError extends Error {
+    /** Configured readiness deadline in milliseconds. */
+    readonly timeoutMs: number;
+    /** Listener names that were part of the registration. */
+    readonly listenerNames: readonly string[];
+    constructor(args: {
+        timeoutMs: number;
+        listenerNames: readonly string[];
+    });
+}
+/** Error thrown when listener rollback misses the registration deadline. */
+export declare class ListenerRegistrationCleanupTimeoutError extends Error {
+    /** Configured registration deadline in milliseconds. */
+    readonly timeoutMs: number;
+    /** Listener names that were part of the registration. */
+    readonly listenerNames: readonly string[];
+    constructor(args: {
+        timeoutMs: number;
+        listenerNames: readonly string[];
+    });
+}
 /**
  * Options for `defineEvent(...)`.
  */
@@ -120,9 +159,9 @@ export interface EventBusLike {
      */
     publish<E extends EventPayloadDef>(event: E, payload: InferEventPayload<E>, options?: EventPublishOptions): MaybePromise<void>;
     /**
-     * Subscribe to an event and return an unsubscribe function.
+     * Subscribe to an event and return its readiness and cleanup handle.
      */
-    subscribe<E extends EventPayloadDef>(event: E, handler: (payload: InferEventPayload<E>, options?: EventPublishOptions) => MaybePromise<void>): () => void;
+    subscribe<E extends EventPayloadDef>(event: E, handler: (payload: InferEventPayload<E>, options?: EventPublishOptions) => MaybePromise<void>): EventSubscription;
 }
 /**
  * Options for `registerListeners(...)`.
@@ -142,6 +181,12 @@ export interface RegisterListenersOptions<Ctx> {
      * the event bus subscription callback.
      */
     onError?: (error: unknown, listener: ListenerDef<EventDef, Ctx>) => void;
+    /**
+     * Maximum time for the complete listener registry to become ready. The same
+     * registration deadline bounds automatic rollback after startup failure.
+     * Defaults to 10 seconds.
+     */
+    readyTimeoutMs?: number;
 }
 /**
  * Context-bound listener helper factory.
@@ -181,12 +226,16 @@ export declare function parseEventPayload<E extends EventPayloadDef>(event: E, p
  */
 export declare function publishEvent<E extends EventPayloadDef>(eventBus: EventBusLike, event: E, payload: InferEventPayload<E>, options?: EventPublishOptions): Promise<void>;
 /**
- * Register listeners against an event bus and return an unsubscribe function.
+ * Register listeners against an event bus and return a composite lifecycle
+ * handle.
  *
  * Payloads are validated before listener handlers run. Listener context is
- * resolved per delivery when `options.ctx` is a factory.
+ * resolved per delivery when `options.ctx` is a factory. Initial registration
+ * starts every child cleanup after a synchronous subscribe failure, rejected
+ * readiness promise, or readiness timeout. Cleanup that cannot finish inside
+ * the registration deadline is reported without extending startup forever.
  */
-export declare function registerListeners<Ctx>(eventBus: EventBusLike, listeners: readonly ListenerDef<EventDef, Ctx>[], options?: RegisterListenersOptions<Ctx>): () => void;
+export declare function registerListeners<Ctx>(eventBus: EventBusLike, listeners: readonly ListenerDef<EventDef, Ctx>[], options?: RegisterListenersOptions<Ctx>): EventSubscription;
 /**
  * Create listener helper methods bound to an application context type.
  *

package/dist/events/index.d.ts.map

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

package/dist/events/index.js

@@ -1,5 +1,46 @@
 import { runWithResolvedTracingContext } from "../tracing/execution.js";
 import { parseTraceCarrier, } from "../tracing/index.js";
+const DEFAULT_LISTENER_READY_TIMEOUT_MS = 10_000;
+const MAX_TIMER_MS = 2_147_483_647;
+/** Error used when a subscription closes before initial readiness. */
+export class EventSubscriptionClosedError extends Error {
+    constructor(message = "Event subscription closed before it became ready.") {
+        super(message);
+        this.name = "EventSubscriptionClosedError";
+    }
+}
+/** Error thrown when a listener registry misses its readiness deadline. */
+export class ListenerRegistrationTimeoutError extends Error {
+    /** Configured readiness deadline in milliseconds. */
+    timeoutMs;
+    /** Listener names that were part of the registration. */
+    listenerNames;
+    constructor(args) {
+        const suffix = args.listenerNames.length
+            ? `: ${args.listenerNames.join(", ")}`
+            : "";
+        super(`Listeners did not become ready within ${args.timeoutMs}ms${suffix}.`);
+        this.name = "ListenerRegistrationTimeoutError";
+        this.timeoutMs = args.timeoutMs;
+        this.listenerNames = [...args.listenerNames];
+    }
+}
+/** Error thrown when listener rollback misses the registration deadline. */
+export class ListenerRegistrationCleanupTimeoutError extends Error {
+    /** Configured registration deadline in milliseconds. */
+    timeoutMs;
+    /** Listener names that were part of the registration. */
+    listenerNames;
+    constructor(args) {
+        const suffix = args.listenerNames.length
+            ? `: ${args.listenerNames.join(", ")}`
+            : "";
+        super(`Listener cleanup did not finish before the ${args.timeoutMs}ms registration deadline${suffix}.`);
+        this.name = "ListenerRegistrationCleanupTimeoutError";
+        this.timeoutMs = args.timeoutMs;
+        this.listenerNames = [...args.listenerNames];
+    }
+}
 /**
  * Error thrown when event payload validation fails.
  */
@@ -81,48 +122,158 @@ export async function publishEvent(eventBus, event, payload, options) {
     await parseEventPayload(event, payload);
     await eventBus.publish(event, payload, options);
 }
+function assertReadyTimeoutMs(value) {
+    if (Number.isInteger(value) && value >= 1 && value <= MAX_TIMER_MS)
+        return;
+    throw new RangeError(`readyTimeoutMs must be an integer between 1 and ${MAX_TIMER_MS} milliseconds.`);
+}
+function errorsFromCleanup(error) {
+    return error instanceof AggregateError ? [...error.errors] : [error];
+}
+function unsubscribeAllSettled(subscriptions) {
+    const attempts = [];
+    for (const subscription of [...subscriptions].reverse()) {
+        try {
+            attempts.push(Promise.resolve(subscription.unsubscribe()));
+        }
+        catch (error) {
+            attempts.push(Promise.reject(error));
+        }
+    }
+    return Promise.allSettled(attempts);
+}
+function throwSubscriptionCleanupErrors(results) {
+    const errors = results.flatMap((result) => result.status === "rejected" ? errorsFromCleanup(result.reason) : []);
+    if (errors.length > 0) {
+        throw new AggregateError(errors, "Event subscription cleanup failed");
+    }
+}
+function withListenerDeadline(operation, args) {
+    let timeout;
+    const timedOut = new Promise((_, reject) => {
+        timeout = setTimeout(() => {
+            reject(args.timeoutError);
+        }, Math.max(0, args.deadlineAt - performance.now()));
+    });
+    return Promise.race([operation, timedOut]).finally(() => {
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+    });
+}
 /**
- * Register listeners against an event bus and return an unsubscribe function.
+ * Register listeners against an event bus and return a composite lifecycle
+ * handle.
  *
  * Payloads are validated before listener handlers run. Listener context is
- * resolved per delivery when `options.ctx` is a factory.
+ * resolved per delivery when `options.ctx` is a factory. Initial registration
+ * starts every child cleanup after a synchronous subscribe failure, rejected
+ * readiness promise, or readiness timeout. Cleanup that cannot finish inside
+ * the registration deadline is reported without extending startup forever.
  */
 export function registerListeners(eventBus, listeners, options = {}) {
-    const unsubscribes = listeners.map((listener) => eventBus.subscribe(listener.event, async (rawPayload, publishOptions) => {
+    const readyTimeoutMs = options.readyTimeoutMs ?? DEFAULT_LISTENER_READY_TIMEOUT_MS;
+    assertReadyTimeoutMs(readyTimeoutMs);
+    const registrationDeadlineAt = performance.now() + readyTimeoutMs;
+    const listenerNames = listeners.map(({ name }) => name);
+    const subscriptions = [];
+    let registrationError;
+    for (const listener of listeners) {
         try {
-            const payload = await parseEventPayload(listener.event, rawPayload);
-            const traceAttributes = {
-                "beignet.listener.name": listener.name,
-                "beignet.event.name": listener.event.name,
-            };
-            await runWithResolvedTracingContext({
-                tracing: options.tracing,
-                ctx: options.ctx,
-                operation: {
-                    name: `beignet.listener ${listener.name}`,
-                    type: "listener",
-                    kind: "consumer",
-                    parent: parseTraceCarrier(publishOptions?.trace),
-                    attributes: traceAttributes,
-                    metricAttributes: traceAttributes,
-                },
-                run: (ctx) => listener.handle({
-                    event: listener.event,
-                    payload,
-                    ctx,
-                }),
-            });
+            subscriptions.push(eventBus.subscribe(listener.event, async (rawPayload, publishOptions) => {
+                try {
+                    const payload = await parseEventPayload(listener.event, rawPayload);
+                    const traceAttributes = {
+                        "beignet.listener.name": listener.name,
+                        "beignet.event.name": listener.event.name,
+                    };
+                    await runWithResolvedTracingContext({
+                        tracing: options.tracing,
+                        ctx: options.ctx,
+                        operation: {
+                            name: `beignet.listener ${listener.name}`,
+                            type: "listener",
+                            kind: "consumer",
+                            parent: parseTraceCarrier(publishOptions?.trace),
+                            attributes: traceAttributes,
+                            metricAttributes: traceAttributes,
+                        },
+                        run: (ctx) => listener.handle({
+                            event: listener.event,
+                            payload,
+                            ctx,
+                        }),
+                    });
+                }
+                catch (error) {
+                    options.onError?.(error, listener);
+                    if (!options.onError)
+                        throw error;
+                }
+            }));
         }
         catch (error) {
-            options.onError?.(error, listener);
-            if (!options.onError)
-                throw error;
+            registrationError = error;
+            break;
         }
-    }));
-    return () => {
-        for (const unsubscribe of [...unsubscribes].reverse()) {
-            unsubscribe();
+    }
+    let rejectClosed;
+    const closedBeforeReady = new Promise((_, reject) => {
+        rejectClosed = reject;
+    });
+    // A consumer may only await cleanup. Keep an explicit observer on the
+    // cancellation signal so that use does not create an unhandled rejection.
+    void closedBeforeReady.catch(() => undefined);
+    let cleanupPromise;
+    const cleanup = (deadlineAt) => {
+        if (cleanupPromise)
+            return cleanupPromise;
+        const operation = unsubscribeAllSettled(subscriptions);
+        cleanupPromise =
+            deadlineAt === undefined
+                ? operation.then(throwSubscriptionCleanupErrors)
+                : withListenerDeadline(operation, {
+                    deadlineAt,
+                    timeoutError: new ListenerRegistrationCleanupTimeoutError({
+                        timeoutMs: readyTimeoutMs,
+                        listenerNames,
+                    }),
+                }).then(throwSubscriptionCleanupErrors);
+        return cleanupPromise;
+    };
+    const initialReadiness = registrationError
+        ? Promise.reject(registrationError)
+        : Promise.all(subscriptions.map(({ ready }) => ready)).then(() => undefined);
+    let readySettled = false;
+    const ready = withListenerDeadline(Promise.race([initialReadiness, closedBeforeReady]), {
+        deadlineAt: registrationDeadlineAt,
+        timeoutError: new ListenerRegistrationTimeoutError({
+            timeoutMs: readyTimeoutMs,
+            listenerNames,
+        }),
+    })
+        .catch(async (primaryError) => {
+        try {
+            await cleanup(registrationDeadlineAt);
+        }
+        catch (cleanupError) {
+            throw new AggregateError([primaryError, ...errorsFromCleanup(cleanupError)], "Listener registration failed and cleanup failed");
         }
+        throw primaryError;
+    })
+        .finally(() => {
+        readySettled = true;
+    });
+    // EventSubscription allows callers that only own cleanup. Preserve the
+    // rejection for awaiters while preventing process-level unhandled noise.
+    void ready.catch(() => undefined);
+    return {
+        ready,
+        unsubscribe() {
+            if (!readySettled) {
+                rejectClosed(new EventSubscriptionClosedError());
+            }
+            return cleanup(readySettled ? undefined : registrationDeadlineAt);
+        },
     };
 }
 /**

package/dist/events/index.js.map

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

package/dist/idempotency/index.d.ts

@@ -410,9 +410,13 @@ export declare function runIdempotently<Result>(idempotency: IdempotencyPort, op
 /**
  * Create a SHA-256 fingerprint from a canonicalized value.
  *
- * Object keys are sorted, `undefined` and functions are omitted, `Date` values
- * become ISO strings, BigInts become strings, and circular or non-finite values
- * throw. Exact omit paths may be supplied as dotted strings or string arrays.
+ * Object keys are sorted, while non-JSON values carry reserved type tags so
+ * BigInts and Dates cannot collide with same-looking strings. Ordinary JSON
+ * inputs retain their existing canonical representation. `undefined` values
+ * and functions are omitted from objects and represented as omitted array
+ * positions. Circular or unsupported object values, reserved tag keys,
+ * invalid dates, and non-finite numbers throw. Exact omit paths may be supplied
+ * as dotted strings or string arrays.
  */
 export declare function createIdempotencyFingerprint(value: unknown, options?: CreateIdempotencyFingerprintOptions): Promise<string>;
 //# sourceMappingURL=index.d.ts.map