A payload's per-job key selection. Defaults to unlimited. Only limited payloads need an instance.

A selective description of the rate-limit key for a payload. Evaluation returns the job key. Static inspection returns the reachable policies.

This payload is unlimited.

Limit by a fixed policy, keyed by a per-job suffix (e.g. a tenant id).

Limit by a fixed policy under one shared key (a single global bucket).

Select between two selectors with a job predicate. Policy collection inspects both branches.

N-way chooseWhen. Maps the job to a finite tag, then each tag to its selector. Policy collection evaluates every tag in [minBound..maxBound]. The tag's Bounded/Enum and the selector must be total over k.

A token-bucket policy. Burst policyMax, refilling policyRefill every policyInterval. A policyRefill of 0 is a manually-refilled bucket.

"N per period" with burst N (max = refill = n). The period is floored to a tiny positive value. The prefix must not contain :, the key separator. The migration enforces this.

Whether the rate-limit bucket table is WAL-logged. Set at migration time.

A policy with its default and override params plus live bucket and throttle stats. The effective param is override when set, else default.

A single key's bucket: current tokens, effective max, and fill fraction.

A patch over a policy's override params. Per field: Nothing leaves it unchanged, Just Nothing clears the override (reverts to the default), and Just (Just v) sets it.

Add tokens to a key's bucket, capped at max, and wake any of its jobs parked mid-wait. A no-op without a policy.

Delete reclaimable idle (full) buckets. Returns the number pruned. The worker reaper runs this. A full bucket re-seeds at full on next use.

Reset every bucket for a prefix to full and wake its throttled jobs. Returns the number of buckets reset. A manual (0-refill) policy plus a cron calling this at the boundary is a fixed window.

List every rate-limit policy with its params, bucket stats, and a live count of currently-throttled jobs per prefix across the registry's queues.

List a prefix's buckets with fill levels, paginated.

Set or clear a policy's override params and wake the prefix's parked jobs. Returns rows affected (0 if absent).

Override a policy with this shape, until it is cleared. Returns rows affected.

Drop a policy's overrides. Its declared params apply again. Returns rows affected.

A resolved key with a prefix and per-key suffix. The stored form is prefix:suffix. The separate prefix supports policy lookup.