import { describe, expect, it, vi } from "vitest"; import { createReferenceFeatureInput } from "../../../src/features/reference-feature/application/reference-feature-api.ts"; import { createFailure } from "../../../src/contracts/errors.ts"; import type { TelemetryPort } from "../../../src/platform/telemetry/telemetry-port.ts"; import { createTelemetryPipeline } from "../../../src/platform/telemetry/telemetry-pipeline.ts"; import { REFERENCE_FEATURE_ADAPTER_CONTRIBUTION } from "../../../src/features/reference-feature/adapters/create-reference-feature-input.ts"; function failingGateway() { const failure = Object.freeze({ ok: false as const, error: createFailure("REQUEST_TIMEOUT", "LIST_REFERENCE_RESOURCES", 0), }); return Object.freeze({ list: vi.fn(async () => failure), get: vi.fn(async () => failure), create: vi.fn(async () => failure), }); } describe("reference feature telemetry through the platform port", () => { it("declares the provider-neutral telemetry capability", () => { expect(REFERENCE_FEATURE_ADAPTER_CONTRIBUTION.needs).toContain("telemetry"); }); it("emits a feature-owned event with a bounded payload on load failure", async () => { const emit = vi.fn(); const input = createReferenceFeatureInput(failingGateway(), { telemetry: { emit } }); const result = await input.listResources({ limit: 20 }); expect(result.ok).toBe(false); expect(emit).toHaveBeenCalledWith({ kind: "reference.load.failed", severity: "warning", featureId: "reference-feature", payload: { operation: "list", reason: "REQUEST_TIMEOUT" }, }); }); it("returns the business result even when the port throws or rejects", async () => { const throwing = createReferenceFeatureInput(failingGateway(), { telemetry: { emit() { throw new Error("port broken"); }, }, }); const rejecting = createReferenceFeatureInput(failingGateway(), { telemetry: { emit: () => Promise.reject(new Error("collector down")) }, }); await expect(throwing.getResource("id-1")).resolves.toMatchObject({ ok: false }); await expect(rejecting.getResource("id-1")).resolves.toMatchObject({ ok: false }); }); it("collapses a failure storm into bounded sends via the pipeline", async () => { const send = vi.fn(); const pipeline = createTelemetryPipeline({ transport: { send } }); const input = createReferenceFeatureInput(failingGateway(), { telemetry: pipeline }); for (let i = 0; i < 500; i += 1) await input.listResources({ limit: 20 }); await pipeline.flush(); expect(send).toHaveBeenCalledTimes(1); expect(pipeline.stats().deduplicated).toBe(499); pipeline.dispose(); }); });