@daiso-tech/core
Version:
The library offers flexible, framework-agnostic solutions for modern web applications, built on adaptable components that integrate seamlessly with popular frameworks like Next Js.
70 lines (69 loc) • 2.83 kB
TypeScript
/**
* @module RateLimiter
*/
import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
import { type ConstantBackoffSettingsEnum } from "../../../backoff-policies/implementations/_module.js";
import { type IRateLimiterAdapter } from "../../../rate-limiter/contracts/_module.js";
import { type SlidingWindowLimiterSettingsEnum } from "../../../rate-limiter/implementations/policies/_module.js";
import { type ITimeSpan } from "../../../time-span/contracts/_module.js";
import { type Promisable } from "../../../utilities/_module.js";
/**
* IMPORT_PATH: `"@daiso-tech/core/rate-limiter/test-utilities"`
* @group TestUtilities
*/
export type SlidingWindowLimiterTestSuiteSettings = {
expect: ExpectStatic;
test: TestAPI;
describe: SuiteAPI;
beforeEach: typeof beforeEach;
createAdapter: () => Promisable<IRateLimiterAdapter>;
/**
* @default
* ```ts
* import { TimeSpan } from "@daiso-tech/core/time-span";
*
* TimeSpan.fromMilliseconds(10)
* ```
*/
delayBuffer?: ITimeSpan;
};
/**
* IMPORT_PATH: `"@daiso-tech/core/rate-limiter/test-utilities"`
* @group TestUtilities
*
* @example
* ```ts
* import { beforeEach, describe, expect, test } from "vitest";
* import { DatabaseRateLimiterAdapter } from "@daiso-tech/core/rate-limiter/database-rate-limiter-adapter";
* import { SlidingWindowLimiter } from "@daiso-tech/core/rate-limiter/policies";
* import { slidingWindowLimiterTestSuite } from "@daiso-tech/core/rate-limiter/test-utilities";
* import { constantBackoff } from "@daiso-tech/core/backoff-policies";
* import { MemoryRateLimiterStorageAdapter } from "@daiso-tech/core/rate-limiter/memory-rate-limiter-storage-adapter";
*
* describe("sliding-window-limiter class: DatabaseRateLimiterAdapter", () => {
* slidingWindowLimiterTestSuite({
* createAdapter: () => {
* const adapter = new DatabaseRateLimiterAdapter({
* adapter: new MemoryRateLimiterStorageAdapter(),
* backoffPolicy: constantBackoff(
* slidingWindowLimiterTestSuite.backoffPolicySettings,
* ),
* rateLimiterPolicy: new SlidingWindowLimiter(
* slidingWindowLimiterTestSuite.rateLimiterPolicySettings,
* ),
* });
* return adapter;
* },
* beforeEach,
* describe,
* expect,
* test,
* });
* });
* ```
*/
export declare function slidingWindowLimiterTestSuite(settings: SlidingWindowLimiterTestSuiteSettings): void;
export declare namespace slidingWindowLimiterTestSuite {
var rateLimiterPolicySettings: Required<SlidingWindowLimiterSettingsEnum>;
var backoffPolicySettings: Required<ConstantBackoffSettingsEnum>;
}