import { beforeEach, describe, expect, it, vi } from "vitest"; import { getWebMetrics, resetWebMetricsForTests } from "./registry.js"; import { recordAuthorizedStorageDownload } from "./storage-traffic.js"; beforeEach(() => { resetWebMetricsForTests(); }); describe("recordAuthorizedStorageDownload", () => { it("records a bounded authorization count and known whole-object bytes", async () => { recordAuthorizedStorageDownload({ surface: "files", delivery: "signed_redirect", objectSizeBytes: 1_048_576, }); const text = await getWebMetrics().registry.metrics(); expect(text).toContain( 'storage_authorized_downloads_total{surface="files",delivery="signed_redirect",size_known="known",service="web",runtime_surface="core"} 1' ); expect(text).toContain( 'storage_authorized_download_object_bytes_total{surface="files",delivery="signed_redirect",service="web",runtime_surface="core"} 1048576' ); }); it.each([undefined, null, -1, Number.NaN, 1.5])("records an unknown size without inventing byte volume for %s", async (objectSizeBytes) => { recordAuthorizedStorageDownload({ surface: "portal_document", delivery: "signed_redirect", objectSizeBytes }); const text = await getWebMetrics().registry.metrics(); expect(text).toContain( 'storage_authorized_downloads_total{surface="portal_document",delivery="signed_redirect",size_known="unknown",service="web",runtime_surface="core"} 1' ); expect(text).not.toContain("storage_authorized_download_object_bytes_total{"); }); it("separates portal download counters from the Core runtime", async () => { const previousSurface = process.env.WEB_RUNTIME_SURFACE; process.env.WEB_RUNTIME_SURFACE = "portal"; resetWebMetricsForTests(); try { recordAuthorizedStorageDownload({ surface: "portal_document", delivery: "signed_redirect", objectSizeBytes: 512 }); const text = await getWebMetrics().registry.metrics(); expect(text).toContain('runtime_surface="portal"'); expect(text).not.toContain('runtime_surface="core"'); } finally { if (previousSurface === undefined) delete process.env.WEB_RUNTIME_SURFACE; else process.env.WEB_RUNTIME_SURFACE = previousSurface; resetWebMetricsForTests(); } }); it("folds impossible runtime label values into other and never exports them", async () => { recordAuthorizedStorageDownload({ surface: "tenant-secret" as "files", delivery: "https://objects.example.test/signed" as "signed_redirect", objectSizeBytes: 10, }); const text = await getWebMetrics().registry.metrics(); expect(text).toContain('delivery="other"'); expect(text).toContain('surface="other"'); expect(text).not.toContain("tenant-secret"); expect(text).not.toContain("objects.example.test"); }); it("stays fail-open when either counter rejects an observation", () => { const throwingCounter = { labels: vi.fn(() => ({ inc: vi.fn(() => { throw new Error("metrics down"); }), })), }; const metrics = { storageAuthorizedDownloadsTotal: throwingCounter, storageAuthorizedDownloadObjectBytesTotal: throwingCounter, } as unknown as NonNullable[1]>["metrics"]; expect(() => recordAuthorizedStorageDownload({ surface: "files", delivery: "signed_redirect", objectSizeBytes: 42 }, { metrics })).not.toThrow(); expect(throwingCounter.labels).toHaveBeenCalledTimes(2); }); });