ratelimit

package

v0.5.0 Latest Latest Go to latest Published: Jul 3, 2026 License: Apache-2.0 Imports: 2 Imported by: 0

Details

Package ratelimit provides a sliding-window start limiter — the windowed timestamp pattern from internal/action/auto.go:reserve(), reusable.

This section is empty.

This section is empty.

This section is empty.

type Window struct {
	// contains filtered or unexported fields
}

Window allows up to max events per sliding window. max <= 0 is unlimited. Safe for concurrent use; clock injectable for tests.

func New(maxEvents int, window time.Duration) *Window

New returns a Window allowing maxEvents per window.

func (w *Window) Allow() bool

Allow reports whether an event fits the budget, recording it if so.

func (w *Window) Count() int

Count returns the number of events currently in the window (peek; no record).

func (w *Window) Window() time.Duration

Window returns the configured sliding-window duration.