setRate

Updates rate.

Existing token balance is preserved and clamped by burst rules. When the new rate is higher than current burst, burst is raised to the new rate. setRate() never decreases burst; use withBurst() when explicitly lowering burst capacity is required.

Parameters:

permitsPerSecond

permits generated per second.

Returns:

Result.ok(true) when rate is updated, or Result.error(RateLimiterError.INVALID_ARGUMENT) when permitsPerSecond is not positive.