@jellyfungus/hono-rate-limiter 0.1.0

package/dist/store/cloudflare-kv.js

@@ -0,0 +1,64 @@
+// src/store/cloudflare-kv.ts
+var CloudflareKVStore = class {
+  namespace;
+  prefix;
+  windowMs = 6e4;
+  constructor(options) {
+    this.namespace = options.namespace;
+    this.prefix = options.prefix ?? "rl:";
+  }
+  init(windowMs) {
+    this.windowMs = windowMs;
+  }
+  async increment(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const now = Date.now();
+    const ttlSeconds = Math.max(60, Math.ceil(this.windowMs / 1e3));
+    const existing = await this.namespace.get(fullKey, {
+      type: "json"
+    });
+    let count;
+    let reset;
+    if (!existing || existing.reset <= now) {
+      count = 1;
+      reset = now + this.windowMs;
+    } else {
+      count = existing.count + 1;
+      reset = existing.reset;
+    }
+    await this.namespace.put(fullKey, JSON.stringify({ count, reset }), {
+      expirationTtl: ttlSeconds
+    });
+    return { count, reset };
+  }
+  async get(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const data = await this.namespace.get(fullKey, { type: "json" });
+    if (!data || data.reset <= Date.now()) {
+      return void 0;
+    }
+    return { count: data.count, reset: data.reset };
+  }
+  async decrement(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const now = Date.now();
+    const existing = await this.namespace.get(fullKey, {
+      type: "json"
+    });
+    if (existing && existing.count > 0 && existing.reset > now) {
+      const ttlSeconds = Math.max(60, Math.ceil((existing.reset - now) / 1e3));
+      await this.namespace.put(
+        fullKey,
+        JSON.stringify({ count: existing.count - 1, reset: existing.reset }),
+        { expirationTtl: ttlSeconds }
+      );
+    }
+  }
+  async resetKey(key) {
+    await this.namespace.delete(`${this.prefix}${key}`);
+  }
+};
+export {
+  CloudflareKVStore
+};
+//# sourceMappingURL=cloudflare-kv.js.map

package/dist/store/cloudflare-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/store/cloudflare-kv.ts"],"sourcesContent":["/**\n * Cloudflare KV store for rate limiting.\n *\n * Note: KV is eventually consistent (~60s propagation).\n * For strict rate limiting, consider Durable Objects.\n */\n\nimport type { RateLimitStore, StoreResult } from \"../index\";\n\n/**\n * Cloudflare KV Namespace interface\n */\nexport type KVNamespace = {\n  get: <T = string>(\n    key: string,\n    options?: { type: \"json\" },\n  ) => Promise<T | null>;\n  put: (\n    key: string,\n    value: string,\n    options?: { expirationTtl?: number },\n  ) => Promise<void>;\n  delete: (key: string) => Promise<void>;\n};\n\n/**\n * Options for Cloudflare KV store\n */\nexport type CloudflareKVStoreOptions = {\n  /**\n   * KV Namespace binding\n   */\n  namespace: KVNamespace;\n\n  /**\n   * Key prefix for rate limit entries\n   * @default 'rl:'\n   */\n  prefix?: string;\n};\n\ntype KVEntry = {\n  count: number;\n  reset: number;\n};\n\n/**\n * Cloudflare KV store for rate limiting in Workers.\n *\n * @example\n * ```ts\n * import { rateLimiter } from 'hono-rate-limit'\n * import { CloudflareKVStore } from 'hono-rate-limit/store/cloudflare-kv'\n *\n * type Bindings = { RATE_LIMIT_KV: KVNamespace }\n *\n * app.use('*', async (c, next) => {\n *   const limiter = rateLimiter({\n *     store: new CloudflareKVStore({ namespace: c.env.RATE_LIMIT_KV }),\n *   })\n *   return limiter(c, next)\n * })\n * ```\n */\nexport class CloudflareKVStore implements RateLimitStore {\n  private namespace: KVNamespace;\n  private prefix: string;\n  private windowMs = 60_000;\n\n  constructor(options: CloudflareKVStoreOptions) {\n    this.namespace = options.namespace;\n    this.prefix = options.prefix ?? \"rl:\";\n  }\n\n  init(windowMs: number): void {\n    this.windowMs = windowMs;\n  }\n\n  async increment(key: string): Promise<StoreResult> {\n    const fullKey = `${this.prefix}${key}`;\n    const now = Date.now();\n\n    // KV minimum TTL is 60 seconds\n    const ttlSeconds = Math.max(60, Math.ceil(this.windowMs / 1000));\n\n    const existing = await this.namespace.get<KVEntry>(fullKey, {\n      type: \"json\",\n    });\n\n    let count: number;\n    let reset: number;\n\n    if (!existing || existing.reset <= now) {\n      // New window\n      count = 1;\n      reset = now + this.windowMs;\n    } else {\n      // Increment\n      count = existing.count + 1;\n      reset = existing.reset;\n    }\n\n    await this.namespace.put(fullKey, JSON.stringify({ count, reset }), {\n      expirationTtl: ttlSeconds,\n    });\n\n    return { count, reset };\n  }\n\n  async get(key: string): Promise<StoreResult | undefined> {\n    const fullKey = `${this.prefix}${key}`;\n    const data = await this.namespace.get<KVEntry>(fullKey, { type: \"json\" });\n\n    if (!data || data.reset <= Date.now()) {\n      return undefined;\n    }\n\n    return { count: data.count, reset: data.reset };\n  }\n\n  async decrement(key: string): Promise<void> {\n    const fullKey = `${this.prefix}${key}`;\n    const now = Date.now();\n\n    const existing = await this.namespace.get<KVEntry>(fullKey, {\n      type: \"json\",\n    });\n\n    if (existing && existing.count > 0 && existing.reset > now) {\n      const ttlSeconds = Math.max(60, Math.ceil((existing.reset - now) / 1000));\n      await this.namespace.put(\n        fullKey,\n        JSON.stringify({ count: existing.count - 1, reset: existing.reset }),\n        { expirationTtl: ttlSeconds },\n      );\n    }\n  }\n\n  async resetKey(key: string): Promise<void> {\n    await this.namespace.delete(`${this.prefix}${key}`);\n  }\n}\n"],"mappings":";AAgEO,IAAM,oBAAN,MAAkD;AAAA,EAC/C;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EAEnB,YAAY,SAAmC;AAC7C,SAAK,YAAY,QAAQ;AACzB,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA,EAEA,KAAK,UAAwB;AAC3B,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,MAAM,UAAU,KAAmC;AACjD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,MAAM,KAAK,IAAI;AAGrB,UAAM,aAAa,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,WAAW,GAAI,CAAC;AAE/D,UAAM,WAAW,MAAM,KAAK,UAAU,IAAa,SAAS;AAAA,MAC1D,MAAM;AAAA,IACR,CAAC;AAED,QAAI;AACJ,QAAI;AAEJ,QAAI,CAAC,YAAY,SAAS,SAAS,KAAK;AAEtC,cAAQ;AACR,cAAQ,MAAM,KAAK;AAAA,IACrB,OAAO;AAEL,cAAQ,SAAS,QAAQ;AACzB,cAAQ,SAAS;AAAA,IACnB;AAEA,UAAM,KAAK,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,MAAM,CAAC,GAAG;AAAA,MAClE,eAAe;AAAA,IACjB,CAAC;AAED,WAAO,EAAE,OAAO,MAAM;AAAA,EACxB;AAAA,EAEA,MAAM,IAAI,KAA+C;AACvD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,OAAO,MAAM,KAAK,UAAU,IAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAExE,QAAI,CAAC,QAAQ,KAAK,SAAS,KAAK,IAAI,GAAG;AACrC,aAAO;AAAA,IACT;AAEA,WAAO,EAAE,OAAO,KAAK,OAAO,OAAO,KAAK,MAAM;AAAA,EAChD;AAAA,EAEA,MAAM,UAAU,KAA4B;AAC1C,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,MAAM,KAAK,IAAI;AAErB,UAAM,WAAW,MAAM,KAAK,UAAU,IAAa,SAAS;AAAA,MAC1D,MAAM;AAAA,IACR,CAAC;AAED,QAAI,YAAY,SAAS,QAAQ,KAAK,SAAS,QAAQ,KAAK;AAC1D,YAAM,aAAa,KAAK,IAAI,IAAI,KAAK,MAAM,SAAS,QAAQ,OAAO,GAAI,CAAC;AACxE,YAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA,KAAK,UAAU,EAAE,OAAO,SAAS,QAAQ,GAAG,OAAO,SAAS,MAAM,CAAC;AAAA,QACnE,EAAE,eAAe,WAAW;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAA4B;AACzC,UAAM,KAAK,UAAU,OAAO,GAAG,KAAK,MAAM,GAAG,GAAG,EAAE;AAAA,EACpD;AACF;","names":[]}

package/dist/store/redis.cjs

@@ -0,0 +1,92 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/store/redis.ts
+var redis_exports = {};
+__export(redis_exports, {
+  RedisStore: () => RedisStore
+});
+module.exports = __toCommonJS(redis_exports);
+var INCR_SCRIPT = `
+local key = KEYS[1]
+local window = tonumber(ARGV[1])
+local now = tonumber(ARGV[2])
+
+local count = redis.call('INCR', key)
+if count == 1 then
+  redis.call('PEXPIRE', key, window)
+end
+
+local ttl = redis.call('PTTL', key)
+local reset = now + ttl
+
+return {count, reset}
+`;
+var RedisStore = class {
+  client;
+  prefix;
+  windowMs = 6e4;
+  constructor(options) {
+    this.client = options.client;
+    this.prefix = options.prefix ?? "rl:";
+  }
+  init(windowMs) {
+    this.windowMs = windowMs;
+  }
+  async increment(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const now = Date.now();
+    const result = await this.client.eval(
+      INCR_SCRIPT,
+      [fullKey],
+      [this.windowMs, now]
+    );
+    return {
+      count: result[0],
+      reset: result[1]
+    };
+  }
+  async get(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const value = await this.client.get(fullKey);
+    if (!value) {
+      return void 0;
+    }
+    return {
+      count: parseInt(value, 10),
+      reset: Date.now() + this.windowMs
+    };
+  }
+  async decrement(key) {
+    const fullKey = `${this.prefix}${key}`;
+    await this.client.eval(
+      'local count = redis.call("GET", KEYS[1]); if count and tonumber(count) > 0 then redis.call("DECR", KEYS[1]) end',
+      [fullKey],
+      []
+    );
+  }
+  async resetKey(key) {
+    await this.client.del(`${this.prefix}${key}`);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RedisStore
+});
+//# sourceMappingURL=redis.cjs.map

package/dist/store/redis.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/store/redis.ts"],"sourcesContent":["/**\n * Redis store for rate limiting.\n * Compatible with ioredis, @upstash/redis, and similar clients.\n */\n\nimport type { RateLimitStore, StoreResult } from \"../index\";\n\n/**\n * Redis client interface\n */\nexport type RedisClient = {\n  eval: (\n    script: string,\n    keys: string[],\n    args: (string | number)[],\n  ) => Promise<unknown> | unknown;\n  get: (key: string) => Promise<string | null> | string | null;\n  del: (...keys: string[]) => Promise<number> | number;\n};\n\n/**\n * Options for Redis store\n */\nexport type RedisStoreOptions = {\n  /**\n   * Redis client instance\n   */\n  client: RedisClient;\n\n  /**\n   * Key prefix for rate limit entries\n   * @default 'rl:'\n   */\n  prefix?: string;\n};\n\n// Lua script for atomic increment with expiry\nconst INCR_SCRIPT = `\nlocal key = KEYS[1]\nlocal window = tonumber(ARGV[1])\nlocal now = tonumber(ARGV[2])\n\nlocal count = redis.call('INCR', key)\nif count == 1 then\n  redis.call('PEXPIRE', key, window)\nend\n\nlocal ttl = redis.call('PTTL', key)\nlocal reset = now + ttl\n\nreturn {count, reset}\n`;\n\n/**\n * Redis store for distributed rate limiting.\n *\n * @example\n * ```ts\n * import { rateLimiter } from 'hono-rate-limit'\n * import { RedisStore } from 'hono-rate-limit/store/redis'\n * import Redis from 'ioredis'\n *\n * const redis = new Redis(process.env.REDIS_URL)\n *\n * app.use(rateLimiter({\n *   store: new RedisStore({ client: redis }),\n * }))\n * ```\n */\nexport class RedisStore implements RateLimitStore {\n  private client: RedisClient;\n  private prefix: string;\n  private windowMs = 60_000;\n\n  constructor(options: RedisStoreOptions) {\n    this.client = options.client;\n    this.prefix = options.prefix ?? \"rl:\";\n  }\n\n  init(windowMs: number): void {\n    this.windowMs = windowMs;\n  }\n\n  async increment(key: string): Promise<StoreResult> {\n    const fullKey = `${this.prefix}${key}`;\n    const now = Date.now();\n\n    const result = (await this.client.eval(\n      INCR_SCRIPT,\n      [fullKey],\n      [this.windowMs, now],\n    )) as [number, number];\n\n    return {\n      count: result[0],\n      reset: result[1],\n    };\n  }\n\n  async get(key: string): Promise<StoreResult | undefined> {\n    const fullKey = `${this.prefix}${key}`;\n    const value = await this.client.get(fullKey);\n\n    if (!value) {\n      return undefined;\n    }\n\n    return {\n      count: parseInt(value, 10),\n      reset: Date.now() + this.windowMs,\n    };\n  }\n\n  async decrement(key: string): Promise<void> {\n    const fullKey = `${this.prefix}${key}`;\n    await this.client.eval(\n      'local count = redis.call(\"GET\", KEYS[1]); if count and tonumber(count) > 0 then redis.call(\"DECR\", KEYS[1]) end',\n      [fullKey],\n      [],\n    );\n  }\n\n  async resetKey(key: string): Promise<void> {\n    await this.client.del(`${this.prefix}${key}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCA,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCb,IAAM,aAAN,MAA2C;AAAA,EACxC;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EAEnB,YAAY,SAA4B;AACtC,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA,EAEA,KAAK,UAAwB;AAC3B,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,MAAM,UAAU,KAAmC;AACjD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,MAAM,KAAK,IAAI;AAErB,UAAM,SAAU,MAAM,KAAK,OAAO;AAAA,MAChC;AAAA,MACA,CAAC,OAAO;AAAA,MACR,CAAC,KAAK,UAAU,GAAG;AAAA,IACrB;AAEA,WAAO;AAAA,MACL,OAAO,OAAO,CAAC;AAAA,MACf,OAAO,OAAO,CAAC;AAAA,IACjB;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,KAA+C;AACvD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,OAAO;AAE3C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,OAAO,SAAS,OAAO,EAAE;AAAA,MACzB,OAAO,KAAK,IAAI,IAAI,KAAK;AAAA,IAC3B;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,KAA4B;AAC1C,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,CAAC,OAAO;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAA4B;AACzC,UAAM,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,EAAE;AAAA,EAC9C;AACF;","names":[]}

package/dist/store/redis.d.cts

@@ -0,0 +1,59 @@
+import { RateLimitStore, StoreResult } from '../index.cjs';
+import 'hono';
+
+/**
+ * Redis store for rate limiting.
+ * Compatible with ioredis, @upstash/redis, and similar clients.
+ */
+
+/**
+ * Redis client interface
+ */
+type RedisClient = {
+    eval: (script: string, keys: string[], args: (string | number)[]) => Promise<unknown> | unknown;
+    get: (key: string) => Promise<string | null> | string | null;
+    del: (...keys: string[]) => Promise<number> | number;
+};
+/**
+ * Options for Redis store
+ */
+type RedisStoreOptions = {
+    /**
+     * Redis client instance
+     */
+    client: RedisClient;
+    /**
+     * Key prefix for rate limit entries
+     * @default 'rl:'
+     */
+    prefix?: string;
+};
+/**
+ * Redis store for distributed rate limiting.
+ *
+ * @example
+ * ```ts
+ * import { rateLimiter } from 'hono-rate-limit'
+ * import { RedisStore } from 'hono-rate-limit/store/redis'
+ * import Redis from 'ioredis'
+ *
+ * const redis = new Redis(process.env.REDIS_URL)
+ *
+ * app.use(rateLimiter({
+ *   store: new RedisStore({ client: redis }),
+ * }))
+ * ```
+ */
+declare class RedisStore implements RateLimitStore {
+    private client;
+    private prefix;
+    private windowMs;
+    constructor(options: RedisStoreOptions);
+    init(windowMs: number): void;
+    increment(key: string): Promise<StoreResult>;
+    get(key: string): Promise<StoreResult | undefined>;
+    decrement(key: string): Promise<void>;
+    resetKey(key: string): Promise<void>;
+}
+
+export { type RedisClient, RedisStore, type RedisStoreOptions };

package/dist/store/redis.d.ts

@@ -0,0 +1,59 @@
+import { RateLimitStore, StoreResult } from '../index.js';
+import 'hono';
+
+/**
+ * Redis store for rate limiting.
+ * Compatible with ioredis, @upstash/redis, and similar clients.
+ */
+
+/**
+ * Redis client interface
+ */
+type RedisClient = {
+    eval: (script: string, keys: string[], args: (string | number)[]) => Promise<unknown> | unknown;
+    get: (key: string) => Promise<string | null> | string | null;
+    del: (...keys: string[]) => Promise<number> | number;
+};
+/**
+ * Options for Redis store
+ */
+type RedisStoreOptions = {
+    /**
+     * Redis client instance
+     */
+    client: RedisClient;
+    /**
+     * Key prefix for rate limit entries
+     * @default 'rl:'
+     */
+    prefix?: string;
+};
+/**
+ * Redis store for distributed rate limiting.
+ *
+ * @example
+ * ```ts
+ * import { rateLimiter } from 'hono-rate-limit'
+ * import { RedisStore } from 'hono-rate-limit/store/redis'
+ * import Redis from 'ioredis'
+ *
+ * const redis = new Redis(process.env.REDIS_URL)
+ *
+ * app.use(rateLimiter({
+ *   store: new RedisStore({ client: redis }),
+ * }))
+ * ```
+ */
+declare class RedisStore implements RateLimitStore {
+    private client;
+    private prefix;
+    private windowMs;
+    constructor(options: RedisStoreOptions);
+    init(windowMs: number): void;
+    increment(key: string): Promise<StoreResult>;
+    get(key: string): Promise<StoreResult | undefined>;
+    decrement(key: string): Promise<void>;
+    resetKey(key: string): Promise<void>;
+}
+
+export { type RedisClient, RedisStore, type RedisStoreOptions };

package/dist/store/redis.js

@@ -0,0 +1,67 @@
+// src/store/redis.ts
+var INCR_SCRIPT = `
+local key = KEYS[1]
+local window = tonumber(ARGV[1])
+local now = tonumber(ARGV[2])
+
+local count = redis.call('INCR', key)
+if count == 1 then
+  redis.call('PEXPIRE', key, window)
+end
+
+local ttl = redis.call('PTTL', key)
+local reset = now + ttl
+
+return {count, reset}
+`;
+var RedisStore = class {
+  client;
+  prefix;
+  windowMs = 6e4;
+  constructor(options) {
+    this.client = options.client;
+    this.prefix = options.prefix ?? "rl:";
+  }
+  init(windowMs) {
+    this.windowMs = windowMs;
+  }
+  async increment(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const now = Date.now();
+    const result = await this.client.eval(
+      INCR_SCRIPT,
+      [fullKey],
+      [this.windowMs, now]
+    );
+    return {
+      count: result[0],
+      reset: result[1]
+    };
+  }
+  async get(key) {
+    const fullKey = `${this.prefix}${key}`;
+    const value = await this.client.get(fullKey);
+    if (!value) {
+      return void 0;
+    }
+    return {
+      count: parseInt(value, 10),
+      reset: Date.now() + this.windowMs
+    };
+  }
+  async decrement(key) {
+    const fullKey = `${this.prefix}${key}`;
+    await this.client.eval(
+      'local count = redis.call("GET", KEYS[1]); if count and tonumber(count) > 0 then redis.call("DECR", KEYS[1]) end',
+      [fullKey],
+      []
+    );
+  }
+  async resetKey(key) {
+    await this.client.del(`${this.prefix}${key}`);
+  }
+};
+export {
+  RedisStore
+};
+//# sourceMappingURL=redis.js.map

package/dist/store/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/store/redis.ts"],"sourcesContent":["/**\n * Redis store for rate limiting.\n * Compatible with ioredis, @upstash/redis, and similar clients.\n */\n\nimport type { RateLimitStore, StoreResult } from \"../index\";\n\n/**\n * Redis client interface\n */\nexport type RedisClient = {\n  eval: (\n    script: string,\n    keys: string[],\n    args: (string | number)[],\n  ) => Promise<unknown> | unknown;\n  get: (key: string) => Promise<string | null> | string | null;\n  del: (...keys: string[]) => Promise<number> | number;\n};\n\n/**\n * Options for Redis store\n */\nexport type RedisStoreOptions = {\n  /**\n   * Redis client instance\n   */\n  client: RedisClient;\n\n  /**\n   * Key prefix for rate limit entries\n   * @default 'rl:'\n   */\n  prefix?: string;\n};\n\n// Lua script for atomic increment with expiry\nconst INCR_SCRIPT = `\nlocal key = KEYS[1]\nlocal window = tonumber(ARGV[1])\nlocal now = tonumber(ARGV[2])\n\nlocal count = redis.call('INCR', key)\nif count == 1 then\n  redis.call('PEXPIRE', key, window)\nend\n\nlocal ttl = redis.call('PTTL', key)\nlocal reset = now + ttl\n\nreturn {count, reset}\n`;\n\n/**\n * Redis store for distributed rate limiting.\n *\n * @example\n * ```ts\n * import { rateLimiter } from 'hono-rate-limit'\n * import { RedisStore } from 'hono-rate-limit/store/redis'\n * import Redis from 'ioredis'\n *\n * const redis = new Redis(process.env.REDIS_URL)\n *\n * app.use(rateLimiter({\n *   store: new RedisStore({ client: redis }),\n * }))\n * ```\n */\nexport class RedisStore implements RateLimitStore {\n  private client: RedisClient;\n  private prefix: string;\n  private windowMs = 60_000;\n\n  constructor(options: RedisStoreOptions) {\n    this.client = options.client;\n    this.prefix = options.prefix ?? \"rl:\";\n  }\n\n  init(windowMs: number): void {\n    this.windowMs = windowMs;\n  }\n\n  async increment(key: string): Promise<StoreResult> {\n    const fullKey = `${this.prefix}${key}`;\n    const now = Date.now();\n\n    const result = (await this.client.eval(\n      INCR_SCRIPT,\n      [fullKey],\n      [this.windowMs, now],\n    )) as [number, number];\n\n    return {\n      count: result[0],\n      reset: result[1],\n    };\n  }\n\n  async get(key: string): Promise<StoreResult | undefined> {\n    const fullKey = `${this.prefix}${key}`;\n    const value = await this.client.get(fullKey);\n\n    if (!value) {\n      return undefined;\n    }\n\n    return {\n      count: parseInt(value, 10),\n      reset: Date.now() + this.windowMs,\n    };\n  }\n\n  async decrement(key: string): Promise<void> {\n    const fullKey = `${this.prefix}${key}`;\n    await this.client.eval(\n      'local count = redis.call(\"GET\", KEYS[1]); if count and tonumber(count) > 0 then redis.call(\"DECR\", KEYS[1]) end',\n      [fullKey],\n      [],\n    );\n  }\n\n  async resetKey(key: string): Promise<void> {\n    await this.client.del(`${this.prefix}${key}`);\n  }\n}\n"],"mappings":";AAqCA,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCb,IAAM,aAAN,MAA2C;AAAA,EACxC;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EAEnB,YAAY,SAA4B;AACtC,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA,EAEA,KAAK,UAAwB;AAC3B,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,MAAM,UAAU,KAAmC;AACjD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,MAAM,KAAK,IAAI;AAErB,UAAM,SAAU,MAAM,KAAK,OAAO;AAAA,MAChC;AAAA,MACA,CAAC,OAAO;AAAA,MACR,CAAC,KAAK,UAAU,GAAG;AAAA,IACrB;AAEA,WAAO;AAAA,MACL,OAAO,OAAO,CAAC;AAAA,MACf,OAAO,OAAO,CAAC;AAAA,IACjB;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,KAA+C;AACvD,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,OAAO;AAE3C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,OAAO,SAAS,OAAO,EAAE;AAAA,MACzB,OAAO,KAAK,IAAI,IAAI,KAAK;AAAA,IAC3B;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,KAA4B;AAC1C,UAAM,UAAU,GAAG,KAAK,MAAM,GAAG,GAAG;AACpC,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,CAAC,OAAO;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAA4B;AACzC,UAAM,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,EAAE;AAAA,EAC9C;AACF;","names":[]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@jellyfungus/hono-rate-limiter",
+  "version": "0.1.0",
+  "description": "Rate limiting middleware for Hono web framework",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./store/redis": {
+      "types": "./dist/store/redis.d.ts",
+      "import": "./dist/store/redis.js",
+      "require": "./dist/store/redis.cjs"
+    },
+    "./store/cloudflare-kv": {
+      "types": "./dist/store/cloudflare-kv.d.ts",
+      "import": "./dist/store/cloudflare-kv.js",
+      "require": "./dist/store/cloudflare-kv.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hono",
+    "rate-limit",
+    "rate-limiter",
+    "middleware",
+    "api",
+    "cloudflare",
+    "workers",
+    "deno",
+    "bun",
+    "node"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rokasta12/hono-rate-limiter.git"
+  },
+  "peerDependencies": {
+    "hono": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "hono": "^4.6.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}