/** * Spec ยง34. Operational amplification metrics. * * - request amplification = physical requests / logical interactions * - retry amplification = total physical attempts / initial requests * - telemetry amplification = telemetry sends / logical failures or events */ function ratio(numerator: number, denominator: number, name: string): number { if (!Number.isFinite(denominator) || denominator <= 0) { throw new RangeError(`${name} denominator must be positive: ${denominator}`); } if (!Number.isFinite(numerator) || numerator < 0) { throw new RangeError(`${name} numerator must be non-negative: ${numerator}`); } return Math.round((numerator / denominator) * 1e9) / 1e9; } export function requestAmplification( input: Readonly<{ interactions: number; physicalRequests: number }>, ): number { return ratio(input.physicalRequests, input.interactions, "request amplification"); } export function retryAmplification( input: Readonly<{ initialRequests: number; totalRequests: number }>, ): number { return ratio(input.totalRequests, input.initialRequests, "retry amplification"); } export function telemetryAmplification( input: Readonly<{ logicalEvents: number; telemetrySends: number }>, ): number { return ratio(input.telemetrySends, input.logicalEvents, "telemetry amplification"); }