![]() Server : Apache/2 System : Linux server-15-235-50-60 5.15.0-164-generic #174-Ubuntu SMP Fri Nov 14 20:25:16 UTC 2025 x86_64 User : gositeme ( 1004) PHP Version : 8.2.29 Disable Function : exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname Directory : /home/gositeme/domains/lavocat.quebec/private_html/node_modules/effect/dist/esm/ |
import * as internal from "./internal/rateLimiter.js";
/**
* Constructs a new `RateLimiter` which will utilize the specified algorithm
* to limit requests (defaults to `token-bucket`).
*
* Notes
* - Only the moment of starting the effect is rate limited. The number of concurrent executions is not bounded.
* - Instances of `RateLimiter` can be composed.
* - The "cost" per effect can be changed. See {@link withCost}
*
* @example
* ```ts
* import { Effect, RateLimiter } from "effect";
* import { compose } from "effect/Function"
*
* const program = Effect.scoped(
* Effect.gen(function* ($) {
* const perMinuteRL = yield* $(RateLimiter.make({ limit: 30, interval: "1 minutes" }))
* const perSecondRL = yield* $(RateLimiter.make({ limit: 2, interval: "1 seconds" }))
*
* // This rate limiter respects both the 30 calls per minute
* // and the 2 calls per second constraints.
* const rateLimit = compose(perMinuteRL, perSecondRL)
*
* // simulate repeated calls
* for (let n = 0; n < 100; n++) {
* // wrap the effect we want to limit with rateLimit
* yield* $(rateLimit(Effect.log("Calling RateLimited Effect")));
* }
* })
* );
* ```
*
* @since 2.0.0
* @category constructors
*/
export const make = internal.make;
/**
* Alters the per-effect cost of the rate-limiter.
*
* This can be used for "credit" based rate-limiting where different API endpoints
* cost a different number of credits within a time window.
* Eg: 1000 credits / hour, where a query costs 1 credit and a mutation costs 5 credits.
*
* @example
* ```ts
* import { Effect, RateLimiter } from "effect";
* import { compose } from "effect/Function";
*
* const program = Effect.scoped(
* Effect.gen(function* ($) {
* // Create a rate limiter that has an hourly limit of 1000 credits
* const rateLimiter = yield* $(RateLimiter.make({ limit: 1000, interval: "1 hours" }));
* // Query API costs 1 credit per call ( 1 is the default cost )
* const queryAPIRL = compose(rateLimiter, RateLimiter.withCost(1));
* // Mutation API costs 5 credits per call
* const mutationAPIRL = compose(rateLimiter, RateLimiter.withCost(5));
* // Use the pre-defined rate limiters
* yield* $(queryAPIRL(Effect.log("Sample Query")));
* yield* $(mutationAPIRL(Effect.log("Sample Mutation")));
*
* // Or set a cost on-the-fly
* yield* $(
* rateLimiter(Effect.log("Another query with a different cost")).pipe(
* RateLimiter.withCost(3)
* )
* );
* })
* );
* ```
*
* @since 2.0.0
* @category combinators
*/
export const withCost = internal.withCost;
//# sourceMappingURL=RateLimiter.js.map