@spec checked_float_add(term(), term()) :: {:ok, float()} | :error | :overflow

Adds numeric operands without allowing float conversion or arithmetic exceptions to escape.

@spec decode_ratelimit(binary()) :: {integer(), integer(), integer()}

Decodes rate limiter state from its fixed-width 24-byte binary format.

@spec decode_ratelimit(binary(), integer()) :: {integer(), integer(), integer()}

Decodes rate limiter state, using fallback_start_ms for malformed values.

Raft apply paths pass their stamped apply time here so corrupted or malformed state is repaired deterministically on every replica.

@spec encode_ratelimit(integer(), integer(), integer()) :: binary()

Encodes rate limiter state as a fixed 24-byte binary.

~10x faster than the old string format ("#{cur}:#{start}:#{prev}"). No allocation, no parsing — just bit packing.

@spec format_float(float()) :: binary()

Formats a float for Redis INCRBYFLOAT output: compact decimals, strips trailing zeros and unnecessary decimal point.

Uses :binary.match/2 instead of String.contains?/2 and removes the dead-code no-op then that was present in the original duplicated versions.

@spec number_to_float(number()) :: {:ok, float()} | :error

Converts an integer or float to a finite BEAM float without raising.

@spec parse_float(binary()) :: {:ok, float()} | :error

Parses a binary as a float. Accepts integer strings ("10") and float strings ("3.14"). Returns {:ok, float} or :error.

@spec parse_integer(binary()) :: {:ok, integer()} | :error

Parses a binary as an integer. Returns {:ok, integer} or :error.