diff --git a/src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts b/src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts index 027cadfa..f5e9f547 100644 --- a/src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts +++ b/src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts @@ -314,7 +314,8 @@ export function createBrowserCrossContextInvalidation( try { eventId = dependencies.createEventId(); } catch { - return invalidPublish(); + // The host's event IDs come from secure random (02-05). + return invalidPublish("SECURE_RANDOM_UNAVAILABLE"); } const candidate: CacheInvalidationWireEvent = Object.freeze({ protocolVersion: CACHE_INVALIDATION_PROTOCOL_VERSION, @@ -333,7 +334,7 @@ export function createBrowserCrossContextInvalidation( topicVersions, nowEpochMilliseconds: emittedAt, }); - if (!parsed.ok) return invalidPublish(); + if (!parsed.ok) return invalidPublish(parsed.reason); sequence = candidate.sequence; pruneTracking(emittedAt); @@ -364,12 +365,14 @@ export function createBrowserCrossContextInvalidation( return publishThroughStorage(candidate); } - function invalidPublish(): CrossContextInvalidationPublishResult { + function invalidPublish( + reason: CrossContextInvalidationObservationReason, + ): CrossContextInvalidationPublishResult { observe({ operation: "PUBLISH", outcome: "FAILED", transport: "NONE", - reason: "INVALID_ENVELOPE", + reason, }); return Object.freeze({ ok: false, reason: "INVALID_EVENT" }); } diff --git a/tests/unit/cross-tab-invalidation.test.ts b/tests/unit/cross-tab-invalidation.test.ts index c158edcc..d9fb4d7b 100644 --- a/tests/unit/cross-tab-invalidation.test.ts +++ b/tests/unit/cross-tab-invalidation.test.ts @@ -869,4 +869,42 @@ describe("browser cross-context invalidation transport", () => { expect(network.messages).toHaveLength(0); runtime.close(); }); + + it("observes why a publish failed instead of one envelope reason (2026-11-01 02-05)", () => { + const failedReasons = ( + overrides: Partial, + topicVersion: number, + ) => { + const reasons: string[] = []; + const runtime = createBrowserCrossContextInvalidation( + dependencies("tab-a", { + createBroadcastChannel: new FakeBroadcastNetwork().createChannel, + observe: (observation) => { + if (observation.operation === "PUBLISH") { + reasons.push(observation.reason); + } + }, + ...overrides, + }), + ); + expect(runtime.publish({ topic: TOPIC, topicVersion })).toEqual({ + ok: false, + reason: "INVALID_EVENT", + }); + runtime.close(); + return reasons; + }; + + expect( + failedReasons( + { + createEventId: () => { + throw new Error("secure random unavailable"); + }, + }, + 1, + ), + ).toEqual(["SECURE_RANDOM_UNAVAILABLE"]); + expect(failedReasons({}, 2)).toEqual(["TOPIC_REJECTED"]); + }); });