@ooneex/rate-limit 1.1.2 → 1.2.0

package/dist/index.d.ts

@@ -1,8 +1,5 @@
-import { Exception } from "@ooneex/exception";
-declare class RateLimitException extends Exception {
-	constructor(message: string, data?: Record<string, unknown>);
-}
-import { AppEnv } from "@ooneex/app-env";
+import { EContainerScope } from "@ooneex/container";
+import { Duration } from "@upstash/ratelimit";
 type RateLimiterClassType = new (...args: any[]) => IRateLimiter;
 type RedisRateLimiterOptionsType = {
 	connectionString?: string;
@@ -14,6 +11,27 @@ type RedisRateLimiterOptionsType = {
 	enableAutoPipelining?: boolean;
 	tls?: boolean | object;
 };
+type UpstashAlgorithmType = {
+	type: "fixedWindow";
+	limit: number;
+	window: Duration;
+} | {
+	type: "slidingWindow";
+	limit: number;
+	window: Duration;
+} | {
+	type: "tokenBucket";
+	refillRate: number;
+	interval: Duration;
+	maxTokens: number;
+};
+type UpstashRedisRateLimiterOptionsType = {
+	url?: string;
+	token?: string;
+	algorithm?: UpstashAlgorithmType;
+	prefix?: string;
+	analytics?: boolean;
+};
 type RateLimitResultType = {
 	limited: boolean;
 	remaining: number;
@@ -21,18 +39,40 @@ type RateLimitResultType = {
 	resetAt: Date;
 };
 interface IRateLimiter {
-	check: (key: string, limit: number, windowSeconds: number) => Promise<RateLimitResultType>;
+	check: (key: string) => Promise<RateLimitResultType>;
+	isLimited: (key: string) => Promise<boolean>;
 	reset: (key: string) => Promise<boolean>;
 	getCount: (key: string) => Promise<number>;
 }
+declare const decorator: {
+	rateLimit: (scope?: EContainerScope) => (target: RateLimiterClassType) => void;
+};
+import { Exception } from "@ooneex/exception";
+declare class RateLimitException extends Exception {
+	constructor(message: string, key: string, data?: Record<string, unknown>);
+}
+import { AppEnv } from "@ooneex/app-env";
 declare class RedisRateLimiter implements IRateLimiter {
 	private readonly env;
 	private client;
 	constructor(env: AppEnv, options?: RedisRateLimiterOptionsType);
 	private connect;
 	private getKey;
-	check(key: string, limit: number, windowSeconds: number): Promise<RateLimitResultType>;
+	check(key: string): Promise<RateLimitResultType>;
+	isLimited(key: string): Promise<boolean>;
+	reset(key: string): Promise<boolean>;
+	getCount(key: string): Promise<number>;
+}
+import { AppEnv as AppEnv2 } from "@ooneex/app-env";
+declare class UpstashRedisRateLimiter implements IRateLimiter {
+	private readonly env;
+	private ratelimit;
+	private static readonly DEFAULT_ALGORITHM;
+	constructor(env: AppEnv2, options?: UpstashRedisRateLimiterOptionsType);
+	private buildLimiter;
+	check(key: string): Promise<RateLimitResultType>;
+	isLimited(key: string): Promise<boolean>;
 	reset(key: string): Promise<boolean>;
 	getCount(key: string): Promise<number>;
 }
-export { RedisRateLimiterOptionsType, RedisRateLimiter, RateLimiterClassType, RateLimitResultType, RateLimitException, IRateLimiter };
+export { decorator, UpstashRedisRateLimiterOptionsType, UpstashRedisRateLimiter, UpstashAlgorithmType, RedisRateLimiterOptionsType, RedisRateLimiter, RateLimiterClassType, RateLimitResultType, RateLimitException, IRateLimiter };

package/dist/index.js

@@ -1,4 +1,219 @@
 // @bun
-var g=function(o,e,r,s){var t=arguments.length,n=t<3?e:s===null?s=Object.getOwnPropertyDescriptor(e,r):s,u;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")n=Reflect.decorate(o,e,r,s);else for(var a=o.length-1;a>=0;a--)if(u=o[a])n=(t<3?u(n):t>3?u(e,r,n):u(e,r))||n;return t>3&&n&&Object.defineProperty(e,r,n),n},l=(o,e)=>(r,s)=>e(r,s,o),x=(o,e)=>{if(typeof Reflect==="object"&&typeof Reflect.metadata==="function")return Reflect.metadata(o,e)};import{Exception as p}from"@ooneex/exception";import{HttpStatus as R}from"@ooneex/http-status";class b extends p{constructor(o,e={}){super(o,{status:R.Code.TooManyRequests,data:e});this.name="RateLimitException"}}import{AppEnv as f}from"@ooneex/app-env";import{inject as T,injectable as P}from"@ooneex/container";class m{env;client;constructor(o,e={}){this.env=o;let r=e.connectionString||this.env.RATE_LIMIT_REDIS_URL;if(!r)throw new b("Redis connection string is required. Please provide a connection string either through the constructor options or set the RATE_LIMIT_REDIS_URL environment variable.");let{connectionString:s,...t}=e,u={...{connectionTimeout:1e4,idleTimeout:30000,autoReconnect:!0,maxRetries:3,enableOfflineQueue:!0,enableAutoPipelining:!0},...t};this.client=new Bun.RedisClient(r,u)}async connect(){if(!this.client.connected)await this.client.connect()}getKey(o){return`ratelimit:${o}`}async check(o,e,r){try{await this.connect();let s=this.getKey(o),t=await this.client.incr(s);if(t===1)await this.client.expire(s,r);let n=await this.client.ttl(s),u=new Date(Date.now()+n*1000);return{limited:t>e,remaining:Math.max(0,e-t),total:e,resetAt:u}}catch(s){throw new b(`Failed to check rate limit for key "${o}": ${s}`)}}async reset(o){try{await this.connect();let e=this.getKey(o);return await this.client.del(e)>0}catch(e){throw new b(`Failed to reset rate limit for key "${o}": ${e}`)}}async getCount(o){try{await this.connect();let e=this.getKey(o),r=await this.client.get(e);if(r===null)return 0;return Number.parseInt(r,10)}catch(e){throw new b(`Failed to get count for key "${o}": ${e}`)}}}m=g([P(),l(0,T(f)),x("design:paramtypes",[typeof f==="undefined"?Object:f,typeof RedisRateLimiterOptionsType==="undefined"?Object:RedisRateLimiterOptionsType])],m);export{m as RedisRateLimiter,b as RateLimitException};
+var __legacyDecorateClassTS = function(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1;i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __legacyDecorateParamTS = (index, decorator) => (target, key) => decorator(target, key, index);
+var __legacyMetadataTS = (k, v) => {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+    return Reflect.metadata(k, v);
+};
 
-//# debugId=CDAEEEAB4BEE49B564756E2164756E21
+// src/decorators.ts
+import { container, EContainerScope } from "@ooneex/container";
+var decorator = {
+  rateLimit: (scope = EContainerScope.Singleton) => {
+    return (target) => {
+      container.add(target, scope);
+    };
+  }
+};
+// src/RateLimitException.ts
+import { Exception } from "@ooneex/exception";
+import { HttpStatus } from "@ooneex/http-status";
+
+class RateLimitException extends Exception {
+  constructor(message, key, data = {}) {
+    super(message, {
+      key,
+      status: HttpStatus.Code.TooManyRequests,
+      data
+    });
+    this.name = "RateLimitException";
+  }
+}
+// src/RedisRateLimiter.ts
+import { AppEnv } from "@ooneex/app-env";
+import { inject } from "@ooneex/container";
+class RedisRateLimiter {
+  env;
+  client;
+  constructor(env, options = {}) {
+    this.env = env;
+    const connectionString = options.connectionString || this.env.RATE_LIMIT_REDIS_URL;
+    if (!connectionString) {
+      throw new RateLimitException("Redis connection string is required. Please provide a connection string either through the constructor options or set the RATE_LIMIT_REDIS_URL environment variable.", "RATE_LIMIT_CONNECTION_FAILED");
+    }
+    const { connectionString: _, ...userOptions } = options;
+    const defaultOptions = {
+      connectionTimeout: 1e4,
+      idleTimeout: 30000,
+      autoReconnect: true,
+      maxRetries: 3,
+      enableOfflineQueue: true,
+      enableAutoPipelining: true
+    };
+    const clientOptions = { ...defaultOptions, ...userOptions };
+    this.client = new Bun.RedisClient(connectionString, clientOptions);
+  }
+  async connect() {
+    if (!this.client.connected) {
+      await this.client.connect();
+    }
+  }
+  getKey(key) {
+    return `ratelimit:${key}`;
+  }
+  async check(key) {
+    const limit = 120;
+    const windowSeconds = 60;
+    try {
+      await this.connect();
+      const rateLimitKey = this.getKey(key);
+      const count = await this.client.incr(rateLimitKey);
+      if (count === 1) {
+        await this.client.expire(rateLimitKey, windowSeconds);
+      }
+      const ttl = await this.client.ttl(rateLimitKey);
+      const resetAt = new Date(Date.now() + ttl * 1000);
+      return {
+        limited: count > limit,
+        remaining: Math.max(0, limit - count),
+        total: limit,
+        resetAt
+      };
+    } catch (error) {
+      throw new RateLimitException(`Failed to check rate limit for key "${key}": ${error}`, "RATE_LIMIT_CHECK_FAILED");
+    }
+  }
+  async isLimited(key) {
+    const result = await this.check(key);
+    return result.limited;
+  }
+  async reset(key) {
+    try {
+      await this.connect();
+      const rateLimitKey = this.getKey(key);
+      const result = await this.client.del(rateLimitKey);
+      return result > 0;
+    } catch (error) {
+      throw new RateLimitException(`Failed to reset rate limit for key "${key}": ${error}`, "RATE_LIMIT_RESET_FAILED");
+    }
+  }
+  async getCount(key) {
+    try {
+      await this.connect();
+      const rateLimitKey = this.getKey(key);
+      const value = await this.client.get(rateLimitKey);
+      if (value === null) {
+        return 0;
+      }
+      return Number.parseInt(value, 10);
+    } catch (error) {
+      throw new RateLimitException(`Failed to get count for key "${key}": ${error}`, "RATE_LIMIT_COUNT_FAILED");
+    }
+  }
+}
+RedisRateLimiter = __legacyDecorateClassTS([
+  decorator.rateLimit(),
+  __legacyDecorateParamTS(0, inject(AppEnv)),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof AppEnv === "undefined" ? Object : AppEnv,
+    typeof RedisRateLimiterOptionsType === "undefined" ? Object : RedisRateLimiterOptionsType
+  ])
+], RedisRateLimiter);
+// src/UpstashRedisRateLimiter.ts
+import { AppEnv as AppEnv2 } from "@ooneex/app-env";
+import { inject as inject2 } from "@ooneex/container";
+import { Ratelimit } from "@upstash/ratelimit";
+import { Redis } from "@upstash/redis";
+class UpstashRedisRateLimiter {
+  env;
+  ratelimit;
+  static DEFAULT_ALGORITHM = {
+    type: "slidingWindow",
+    limit: 120,
+    window: "60 s"
+  };
+  constructor(env, options = {}) {
+    this.env = env;
+    const url = options.url || this.env.RATE_LIMIT_UPSTASH_REDIS_URL;
+    const token = options.token || this.env.RATE_LIMIT_UPSTASH_REDIS_TOKEN;
+    if (!url || !token) {
+      throw new RateLimitException("Upstash Redis URL and token are required. Please provide them through the constructor options or set the RATE_LIMIT_UPSTASH_REDIS_URL and RATE_LIMIT_UPSTASH_REDIS_TOKEN environment variables.", "RATE_LIMIT_CONNECTION_FAILED");
+    }
+    const redis = new Redis({ url, token });
+    const limiter = this.buildLimiter(options.algorithm);
+    this.ratelimit = new Ratelimit({
+      redis,
+      limiter,
+      prefix: options.prefix ?? "@ooneex/ratelimit",
+      analytics: options.analytics ?? true
+    });
+  }
+  buildLimiter(algorithm = UpstashRedisRateLimiter.DEFAULT_ALGORITHM) {
+    switch (algorithm.type) {
+      case "fixedWindow":
+        return Ratelimit.fixedWindow(algorithm.limit, algorithm.window);
+      case "slidingWindow":
+        return Ratelimit.slidingWindow(algorithm.limit, algorithm.window);
+      case "tokenBucket":
+        return Ratelimit.tokenBucket(algorithm.refillRate, algorithm.interval, algorithm.maxTokens);
+    }
+  }
+  async check(key) {
+    try {
+      const result = await this.ratelimit.limit(key);
+      return {
+        limited: !result.success,
+        remaining: result.remaining,
+        total: result.limit,
+        resetAt: new Date(result.reset)
+      };
+    } catch (error) {
+      throw new RateLimitException(`Failed to check rate limit for key "${key}": ${error}`, "RATE_LIMIT_CHECK_FAILED");
+    }
+  }
+  async isLimited(key) {
+    const result = await this.check(key);
+    return result.limited;
+  }
+  async reset(key) {
+    try {
+      await this.ratelimit.resetUsedTokens(key);
+      return true;
+    } catch (error) {
+      throw new RateLimitException(`Failed to reset rate limit for key "${key}": ${error}`, "RATE_LIMIT_RESET_FAILED");
+    }
+  }
+  async getCount(key) {
+    try {
+      const { remaining } = await this.ratelimit.getRemaining(key);
+      return remaining;
+    } catch (error) {
+      throw new RateLimitException(`Failed to get count for key "${key}": ${error}`, "RATE_LIMIT_COUNT_FAILED");
+    }
+  }
+}
+UpstashRedisRateLimiter = __legacyDecorateClassTS([
+  decorator.rateLimit(),
+  __legacyDecorateParamTS(0, inject2(AppEnv2)),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof AppEnv2 === "undefined" ? Object : AppEnv2,
+    typeof UpstashRedisRateLimiterOptionsType === "undefined" ? Object : UpstashRedisRateLimiterOptionsType
+  ])
+], UpstashRedisRateLimiter);
+export {
+  decorator,
+  UpstashRedisRateLimiter,
+  RedisRateLimiter,
+  RateLimitException
+};
+
+//# debugId=8F06C17BF8E11C5C64756E2164756E21

package/dist/index.js.map

@@ -1,11 +1,13 @@
 {
   "version": 3,
-  "sources": ["src/RateLimitException.ts", "src/RedisRateLimiter.ts"],
+  "sources": ["src/decorators.ts", "src/RateLimitException.ts", "src/RedisRateLimiter.ts", "src/UpstashRedisRateLimiter.ts"],
   "sourcesContent": [
-    "import { Exception } from \"@ooneex/exception\";\nimport { HttpStatus } from \"@ooneex/http-status\";\n\nexport class RateLimitException extends Exception {\n  constructor(message: string, data: Record<string, unknown> = {}) {\n    super(message, {\n      status: HttpStatus.Code.TooManyRequests,\n      data,\n    });\n    this.name = \"RateLimitException\";\n  }\n}\n",
-    "import { AppEnv } from \"@ooneex/app-env\";\nimport { inject, injectable } from \"@ooneex/container\";\nimport { RateLimitException } from \"./RateLimitException\";\nimport type { IRateLimiter, RateLimitResultType, RedisRateLimiterOptionsType } from \"./types\";\n\n@injectable()\nexport class RedisRateLimiter implements IRateLimiter {\n  private client: Bun.RedisClient;\n\n  constructor(\n    @inject(AppEnv) private readonly env: AppEnv,\n    options: RedisRateLimiterOptionsType = {},\n  ) {\n    const connectionString = options.connectionString || this.env.RATE_LIMIT_REDIS_URL;\n\n    if (!connectionString) {\n      throw new RateLimitException(\n        \"Redis connection string is required. Please provide a connection string either through the constructor options or set the RATE_LIMIT_REDIS_URL environment variable.\",\n      );\n    }\n\n    const { connectionString: _, ...userOptions } = options;\n\n    const defaultOptions = {\n      connectionTimeout: 10_000,\n      idleTimeout: 30_000,\n      autoReconnect: true,\n      maxRetries: 3,\n      enableOfflineQueue: true,\n      enableAutoPipelining: true,\n    };\n\n    const clientOptions = { ...defaultOptions, ...userOptions };\n\n    this.client = new Bun.RedisClient(connectionString, clientOptions);\n  }\n\n  private async connect(): Promise<void> {\n    if (!this.client.connected) {\n      await this.client.connect();\n    }\n  }\n\n  private getKey(key: string): string {\n    return `ratelimit:${key}`;\n  }\n\n  public async check(key: string, limit: number, windowSeconds: number): Promise<RateLimitResultType> {\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n\n      // Increment counter\n      const count = await this.client.incr(rateLimitKey);\n\n      // Set expiry if this is the first request in window\n      if (count === 1) {\n        await this.client.expire(rateLimitKey, windowSeconds);\n      }\n\n      // Get TTL for reset time calculation\n      const ttl = await this.client.ttl(rateLimitKey);\n      const resetAt = new Date(Date.now() + ttl * 1000);\n\n      return {\n        limited: count > limit,\n        remaining: Math.max(0, limit - count),\n        total: limit,\n        resetAt,\n      };\n    } catch (error) {\n      throw new RateLimitException(`Failed to check rate limit for key \"${key}\": ${error}`);\n    }\n  }\n\n  public async reset(key: string): Promise<boolean> {\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n      const result = await this.client.del(rateLimitKey);\n\n      return result > 0;\n    } catch (error) {\n      throw new RateLimitException(`Failed to reset rate limit for key \"${key}\": ${error}`);\n    }\n  }\n\n  public async getCount(key: string): Promise<number> {\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n      const value = await this.client.get(rateLimitKey);\n\n      if (value === null) {\n        return 0;\n      }\n\n      return Number.parseInt(value, 10);\n    } catch (error) {\n      throw new RateLimitException(`Failed to get count for key \"${key}\": ${error}`);\n    }\n  }\n}\n"
+    "import { container, EContainerScope } from \"@ooneex/container\";\nimport type { RateLimiterClassType } from \"./types\";\n\nexport const decorator = {\n  rateLimit: (scope: EContainerScope = EContainerScope.Singleton) => {\n    return (target: RateLimiterClassType): void => {\n      container.add(target, scope);\n    };\n  },\n};\n",
+    "import { Exception } from \"@ooneex/exception\";\nimport { HttpStatus } from \"@ooneex/http-status\";\n\nexport class RateLimitException extends Exception {\n  constructor(message: string, key: string, data: Record<string, unknown> = {}) {\n    super(message, {\n      key,\n      status: HttpStatus.Code.TooManyRequests,\n      data,\n    });\n    this.name = \"RateLimitException\";\n  }\n}\n",
+    "import { AppEnv } from \"@ooneex/app-env\";\nimport { inject } from \"@ooneex/container\";\nimport { decorator } from \"./decorators\";\nimport { RateLimitException } from \"./RateLimitException\";\nimport type { IRateLimiter, RateLimitResultType, RedisRateLimiterOptionsType } from \"./types\";\n\n@decorator.rateLimit()\nexport class RedisRateLimiter implements IRateLimiter {\n  private client: Bun.RedisClient;\n\n  constructor(\n    @inject(AppEnv) private readonly env: AppEnv,\n    options: RedisRateLimiterOptionsType = {},\n  ) {\n    const connectionString = options.connectionString || this.env.RATE_LIMIT_REDIS_URL;\n\n    if (!connectionString) {\n      throw new RateLimitException(\n        \"Redis connection string is required. Please provide a connection string either through the constructor options or set the RATE_LIMIT_REDIS_URL environment variable.\",\n        \"RATE_LIMIT_CONNECTION_FAILED\",\n      );\n    }\n\n    const { connectionString: _, ...userOptions } = options;\n\n    const defaultOptions = {\n      connectionTimeout: 10_000,\n      idleTimeout: 30_000,\n      autoReconnect: true,\n      maxRetries: 3,\n      enableOfflineQueue: true,\n      enableAutoPipelining: true,\n    };\n\n    const clientOptions = { ...defaultOptions, ...userOptions };\n\n    this.client = new Bun.RedisClient(connectionString, clientOptions);\n  }\n\n  private async connect(): Promise<void> {\n    if (!this.client.connected) {\n      await this.client.connect();\n    }\n  }\n\n  private getKey(key: string): string {\n    return `ratelimit:${key}`;\n  }\n\n  public async check(key: string): Promise<RateLimitResultType> {\n    const limit = 120;\n    const windowSeconds = 60;\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n\n      // Increment counter\n      const count = await this.client.incr(rateLimitKey);\n\n      // Set expiry if this is the first request in window\n      if (count === 1) {\n        await this.client.expire(rateLimitKey, windowSeconds);\n      }\n\n      // Get TTL for reset time calculation\n      const ttl = await this.client.ttl(rateLimitKey);\n      const resetAt = new Date(Date.now() + ttl * 1000);\n\n      return {\n        limited: count > limit,\n        remaining: Math.max(0, limit - count),\n        total: limit,\n        resetAt,\n      };\n    } catch (error: unknown) {\n      throw new RateLimitException(`Failed to check rate limit for key \"${key}\": ${error}`, \"RATE_LIMIT_CHECK_FAILED\");\n    }\n  }\n\n  public async isLimited(key: string): Promise<boolean> {\n    const result = await this.check(key);\n\n    return result.limited;\n  }\n\n  public async reset(key: string): Promise<boolean> {\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n      const result = await this.client.del(rateLimitKey);\n\n      return result > 0;\n    } catch (error: unknown) {\n      throw new RateLimitException(`Failed to reset rate limit for key \"${key}\": ${error}`, \"RATE_LIMIT_RESET_FAILED\");\n    }\n  }\n\n  public async getCount(key: string): Promise<number> {\n    try {\n      await this.connect();\n\n      const rateLimitKey = this.getKey(key);\n      const value = await this.client.get(rateLimitKey);\n\n      if (value === null) {\n        return 0;\n      }\n\n      return Number.parseInt(value, 10);\n    } catch (error: unknown) {\n      throw new RateLimitException(`Failed to get count for key \"${key}\": ${error}`, \"RATE_LIMIT_COUNT_FAILED\");\n    }\n  }\n}\n",
+    "import { AppEnv } from \"@ooneex/app-env\";\nimport { inject } from \"@ooneex/container\";\nimport { Ratelimit } from \"@upstash/ratelimit\";\nimport { Redis } from \"@upstash/redis\";\nimport { decorator } from \"./decorators\";\nimport { RateLimitException } from \"./RateLimitException\";\nimport type {\n  IRateLimiter,\n  RateLimitResultType,\n  UpstashAlgorithmType,\n  UpstashRedisRateLimiterOptionsType,\n} from \"./types\";\n\n@decorator.rateLimit()\nexport class UpstashRedisRateLimiter implements IRateLimiter {\n  private ratelimit: Ratelimit;\n  // Default: 120 requests per 60-second sliding window (high traffic)\n  private static readonly DEFAULT_ALGORITHM: UpstashAlgorithmType = {\n    type: \"slidingWindow\",\n    limit: 120,\n    window: \"60 s\",\n  };\n\n  constructor(\n    @inject(AppEnv) private readonly env: AppEnv,\n    options: UpstashRedisRateLimiterOptionsType = {},\n  ) {\n    const url = options.url || this.env.RATE_LIMIT_UPSTASH_REDIS_URL;\n    const token = options.token || this.env.RATE_LIMIT_UPSTASH_REDIS_TOKEN;\n\n    if (!url || !token) {\n      throw new RateLimitException(\n        \"Upstash Redis URL and token are required. Please provide them through the constructor options or set the RATE_LIMIT_UPSTASH_REDIS_URL and RATE_LIMIT_UPSTASH_REDIS_TOKEN environment variables.\",\n        \"RATE_LIMIT_CONNECTION_FAILED\",\n      );\n    }\n\n    const redis = new Redis({ url, token });\n    const limiter = this.buildLimiter(options.algorithm);\n\n    this.ratelimit = new Ratelimit({\n      redis,\n      limiter,\n      prefix: options.prefix ?? \"@ooneex/ratelimit\",\n      analytics: options.analytics ?? true,\n    });\n  }\n\n  private buildLimiter(algorithm: UpstashAlgorithmType = UpstashRedisRateLimiter.DEFAULT_ALGORITHM) {\n    switch (algorithm.type) {\n      case \"fixedWindow\":\n        return Ratelimit.fixedWindow(algorithm.limit, algorithm.window);\n      case \"slidingWindow\":\n        return Ratelimit.slidingWindow(algorithm.limit, algorithm.window);\n      case \"tokenBucket\":\n        return Ratelimit.tokenBucket(algorithm.refillRate, algorithm.interval, algorithm.maxTokens);\n    }\n  }\n\n  public async check(key: string): Promise<RateLimitResultType> {\n    try {\n      const result = await this.ratelimit.limit(key);\n\n      return {\n        limited: !result.success,\n        remaining: result.remaining,\n        total: result.limit,\n        resetAt: new Date(result.reset),\n      };\n    } catch (error) {\n      throw new RateLimitException(`Failed to check rate limit for key \"${key}\": ${error}`, \"RATE_LIMIT_CHECK_FAILED\");\n    }\n  }\n\n  public async isLimited(key: string): Promise<boolean> {\n    const result = await this.check(key);\n\n    return result.limited;\n  }\n\n  public async reset(key: string): Promise<boolean> {\n    try {\n      await this.ratelimit.resetUsedTokens(key);\n\n      return true;\n    } catch (error) {\n      throw new RateLimitException(`Failed to reset rate limit for key \"${key}\": ${error}`, \"RATE_LIMIT_RESET_FAILED\");\n    }\n  }\n\n  public async getCount(key: string): Promise<number> {\n    try {\n      const { remaining } = await this.ratelimit.getRemaining(key);\n\n      return remaining;\n    } catch (error) {\n      throw new RateLimitException(`Failed to get count for key \"${key}\": ${error}`, \"RATE_LIMIT_COUNT_FAILED\");\n    }\n  }\n}\n"
   ],
-  "mappings": ";8cAAA,oBAAS,0BACT,qBAAS,4BAEF,MAAM,UAA2B,CAAU,CAChD,WAAW,CAAC,EAAiB,EAAgC,CAAC,EAAG,CAC/D,MAAM,EAAS,CACb,OAAQ,EAAW,KAAK,gBACxB,MACF,CAAC,EACD,KAAK,KAAO,qBAEhB,CCXA,iBAAS,wBACT,iBAAS,gBAAQ,0BAKV,MAAM,CAAyC,CAIjB,IAH3B,OAER,WAAW,CACwB,EACjC,EAAuC,CAAC,EACxC,CAFiC,WAGjC,IAAM,EAAmB,EAAQ,kBAAoB,KAAK,IAAI,qBAE9D,GAAI,CAAC,EACH,MAAM,IAAI,EACR,sKACF,EAGF,IAAQ,iBAAkB,KAAM,GAAgB,EAW1C,EAAgB,IATC,CACrB,kBAAmB,IACnB,YAAa,MACb,cAAe,GACf,WAAY,EACZ,mBAAoB,GACpB,qBAAsB,EACxB,KAE8C,CAAY,EAE1D,KAAK,OAAS,IAAI,IAAI,YAAY,EAAkB,CAAa,OAGrD,QAAO,EAAkB,CACrC,GAAI,CAAC,KAAK,OAAO,UACf,MAAM,KAAK,OAAO,QAAQ,EAItB,MAAM,CAAC,EAAqB,CAClC,MAAO,aAAa,SAGT,MAAK,CAAC,EAAa,EAAe,EAAqD,CAClG,GAAI,CACF,MAAM,KAAK,QAAQ,EAEnB,IAAM,EAAe,KAAK,OAAO,CAAG,EAG9B,EAAQ,MAAM,KAAK,OAAO,KAAK,CAAY,EAGjD,GAAI,IAAU,EACZ,MAAM,KAAK,OAAO,OAAO,EAAc,CAAa,EAItD,IAAM,EAAM,MAAM,KAAK,OAAO,IAAI,CAAY,EACxC,EAAU,IAAI,KAAK,KAAK,IAAI,EAAI,EAAM,IAAI,EAEhD,MAAO,CACL,QAAS,EAAQ,EACjB,UAAW,KAAK,IAAI,EAAG,EAAQ,CAAK,EACpC,MAAO,EACP,SACF,EACA,MAAO,EAAO,CACd,MAAM,IAAI,EAAmB,uCAAuC,OAAS,GAAO,QAI3E,MAAK,CAAC,EAA+B,CAChD,GAAI,CACF,MAAM,KAAK,QAAQ,EAEnB,IAAM,EAAe,KAAK,OAAO,CAAG,EAGpC,OAFe,MAAM,KAAK,OAAO,IAAI,CAAY,EAEjC,EAChB,MAAO,EAAO,CACd,MAAM,IAAI,EAAmB,uCAAuC,OAAS,GAAO,QAI3E,SAAQ,CAAC,EAA8B,CAClD,GAAI,CACF,MAAM,KAAK,QAAQ,EAEnB,IAAM,EAAe,KAAK,OAAO,CAAG,EAC9B,EAAQ,MAAM,KAAK,OAAO,IAAI,CAAY,EAEhD,GAAI,IAAU,KACZ,MAAO,GAGT,OAAO,OAAO,SAAS,EAAO,EAAE,EAChC,MAAO,EAAO,CACd,MAAM,IAAI,EAAmB,gCAAgC,OAAS,GAAO,GAGnF,CAnGa,EAAN,GADN,EAAW,EAKP,MAAO,CAAM,GAJX,8IAAM",
-  "debugId": "CDAEEEAB4BEE49B564756E2164756E21",
+  "mappings": "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",
+  "debugId": "8F06C17BF8E11C5C64756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ooneex/rate-limit",
   "description": "API rate limiting middleware with configurable throttling strategies, sliding window counters, and per-client request quota enforcement",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "type": "module",
   "files": [
     "dist",
@@ -28,14 +28,15 @@
     "npm:publish": "bun publish --tolerate-republish --force --production --access public"
   },
   "peerDependencies": {
-    "@ooneex/exception": "1.1.2",
-    "@ooneex/http-status": "1.1.2"
+    "@ooneex/exception": "1.1.3",
+    "@ooneex/http-status": "1.1.3"
   },
   "dependencies": {
-    "@ooneex/app-env": "1.2.0",
-    "@ooneex/exception": "1.1.2",
-    "@ooneex/container": "1.1.2",
-    "@ooneex/http-status": "1.1.2"
+    "@ooneex/app-env": "1.2.1",
+    "@ooneex/container": "1.2.1",
+    "@ooneex/exception": "1.1.3",
+    "@ooneex/http-status": "1.1.3",
+    "@upstash/ratelimit": "^2.0.8"
   },
   "keywords": [
     "api",