import { describe, expect, it } from "vitest"; import type { TelemetryEvent } from "../../../src/platform/telemetry/telemetry-event.ts"; import { isTelemetryEnvelopeValid } from "../../../src/platform/telemetry/telemetry-event.ts"; import { failOpenTelemetryPort, NO_OP_TELEMETRY_PORT, type TelemetryPort, } from "../../../src/platform/telemetry/telemetry-port.ts"; describe("TelemetryPort", () => { it("accepts feature-owned payloads through a generic envelope", async () => { const seen: TelemetryEvent[] = []; const port: TelemetryPort = { emit(event) { seen.push(event); }, }; await port.emit({ kind: "catalog.load.failed", severity: "error", contextId: "commerce", featureId: "catalog", interactionId: "i-1", payload: { reason: "timeout" }, }); expect(seen).toHaveLength(1); }); it("contains a throwing or rejecting implementation", async () => { const throwing = failOpenTelemetryPort({ emit() { throw new Error("vendor down"); }, }); const rejecting = failOpenTelemetryPort({ emit: () => Promise.reject(new Error("vendor down")), }); await expect(throwing.emit({ kind: "a.b", severity: "info" })).resolves.toBeUndefined(); await expect(rejecting.emit({ kind: "a.b", severity: "info" })).resolves.toBeUndefined(); expect(() => NO_OP_TELEMETRY_PORT.emit({ kind: "a.b", severity: "info" })).not.toThrow(); }); it("admits only bounded envelope identifiers", () => { expect(isTelemetryEnvelopeValid({ kind: "catalog.load.failed", severity: "warning" })).toBe(true); expect(isTelemetryEnvelopeValid({ kind: "Free Text Kind", severity: "warning" })).toBe(false); expect( isTelemetryEnvelopeValid({ kind: "a.b", severity: "warning", featureId: "/users/123", }), ).toBe(false); expect( isTelemetryEnvelopeValid({ kind: "a.b", severity: "verbose" as never, }), ).toBe(false); }); });