diff --git a/lib/analytics/__tests__/client-error-reporting-with-redaction.test.ts b/lib/analytics/__tests__/client-error-reporting-with-redaction.test.ts new file mode 100644 index 0000000..72f93c5 --- /dev/null +++ b/lib/analytics/__tests__/client-error-reporting-with-redaction.test.ts @@ -0,0 +1,14 @@ +import { describe, expect, it } from "vitest"; +import { evaluateClientErrorReportingWithRedaction } from "../client-error-reporting-with-redaction"; + +describe("evaluateClientErrorReportingWithRedaction", () => { + it("evaluates nominal, elevated, and critical thresholds deterministically", () => { + expect(evaluateClientErrorReportingWithRedaction({ contextId: "ctx-1", primaryMetric: 15, secondaryMetric: 10, limitThreshold: 100 }).status).toBe("nominal"); + expect(evaluateClientErrorReportingWithRedaction({ contextId: "ctx-2", primaryMetric: 40, secondaryMetric: 20 }).status).toBe("elevated"); + expect(evaluateClientErrorReportingWithRedaction({ contextId: "ctx-3", primaryMetric: 70, secondaryMetric: 25, limitThreshold: 100 }).status).toBe("critical"); + }); + + it("rejects blank contextId", () => { + expect(() => evaluateClientErrorReportingWithRedaction({ contextId: " ", primaryMetric: 1, secondaryMetric: 1 })).toThrow(/contextId is required/); + }); +}); diff --git a/lib/analytics/client-error-reporting-with-redaction.ts b/lib/analytics/client-error-reporting-with-redaction.ts new file mode 100644 index 0000000..ee0fbe2 --- /dev/null +++ b/lib/analytics/client-error-reporting-with-redaction.ts @@ -0,0 +1,40 @@ +export interface ClientErrorReportingWithRedactionSummaryInput { + contextId: string; + primaryMetric: number; + secondaryMetric: number; + limitThreshold?: number; +} + +export interface ClientErrorReportingWithRedactionSummary { + contextId: string; + primaryMetric: number; + secondaryMetric: number; + scoreBps: number; + status: "nominal" | "elevated" | "critical"; +} + +export function evaluateClientErrorReportingWithRedaction(input: ClientErrorReportingWithRedactionSummaryInput): ClientErrorReportingWithRedactionSummary { + const contextId = input.contextId.trim(); + if (!contextId) { + throw new Error("evaluateClientErrorReportingWithRedaction: contextId is required"); + } + const primaryMetric = Math.max(0, Math.trunc(input.primaryMetric)); + const secondaryMetric = Math.max(0, Math.trunc(input.secondaryMetric)); + const limit = Math.max(1, Math.trunc(input.limitThreshold ?? 100)); + + const scoreBps = Math.min(10000, Math.round(((primaryMetric + secondaryMetric) * 10000) / limit)); + let status: "nominal" | "elevated" | "critical" = "nominal"; + if (scoreBps >= 8500) { + status = "critical"; + } else if (scoreBps >= 5000) { + status = "elevated"; + } + + return { + contextId, + primaryMetric, + secondaryMetric, + scoreBps, + status, + }; +}