@mrxsys/mrx-core 2.11.0-1-and-267-20250925 → 2.11.1-1-and-275-20251023

package/dist/modules/elysia/rate-limit/rate-limit.d.ts

@@ -1,42 +1,55 @@
-import { Elysia } from 'elysia';
+import type { KvStore } from '../../../modules/kv-store/types';
+import { Elysia, type HTTPHeaders, type StatusMap } from 'elysia';
 import type { RateLimitOptions } from './types/rate-limit-options';
 /**
- * The `rateLimitPlugin` provides rate limiting capabilities for Elysia applications,
- * protecting APIs from excessive use and potential abuse. It tracks request rates by client IP
- * and enforces configurable limits based on a sliding time window.
+ * Rate limiting plugin for Elysia applications that protects APIs from excessive use and potential abuse.
  *
- * ### Rate Limit Headers:
- * The plugin adds the following headers to all responses:
+ * The plugin tracks request rates by client IP address and enforces configurable limits based on a fixed time window.
+ * It supports multiple storage backends through the `@mrxsys/mrx-core/modules/kv-store` ecosystem for both single-instance and distributed deployments.
+ *
+ * ### How It Works
+ * - Rate limiting is applied per IP address and per route
+ * - Each route can have its own limit and time window configuration
+ * - Route-level rate limits override global rate limits
+ * - Headers are added to all responses indicating the current rate limit status
+ *
+ * ### Rate Limit Headers
+ * The plugin adds the following headers to all responses (including 429 errors):
  * - `X-RateLimit-Limit`: The maximum number of requests allowed in the window
  * - `X-RateLimit-Remaining`: The number of requests remaining in the current window
- * - `X-RateLimit-Reset`: The time in seconds until the rate limit resets
+ * - `X-RateLimit-Reset`: The time in seconds until the rate limit resets (Unix timestamp)
+ *
+ * When a rate limit is exceeded, the response includes a 429 (Too Many Requests) status code
+ * and the error key `elysia.rate-limit.error.exceeded`, along with the rate limit headers
+ * to help clients implement exponential backoff retry strategies.
  *
- * @param options - The configuration options for the rate limit plugin
+ * @param store - The KV store instance for tracking rate limits. Defaults to an in-memory store.
+ * Supports any `KvStore` implementation from `@mrxsys/mrx-core/modules/kv-store` (e.g., `MemoryStore`, `IoRedisStore`)
  *
- * @returns An {@link Elysia} plugin that adds rate limiting functionality
+ * @returns An {@link Elysia} plugin that adds rate limiting functionality via the `rateLimit` macro
  *
  * @example
- * Basic usage with default in-memory store
+ * Basic usage with default in-memory store (development)
  * ```ts
- * import { rateLimit } from '@nowarajs/elysia-ratelimit';
+ * import { rateLimit } from '@mrxsys/mrx-core/modules/elysia/elysia-ratelimit';
  * import { Elysia } from 'elysia';
  *
  * const app = new Elysia()
- *   .use(rateLimit({
- *     store: ':memory:',    // Use in-memory store
- *     limit: 100,           // 100 requests
- *     window: 60,           // per minute
- *   }))
- *   .get('/api/endpoint', () => ({ message: 'Hello World' }));
- *
- * app.listen(3000);
+ *   .use(rateLimit())
+ *   .get('/api/data', () => ({ message: 'Hello World' }), {
+ *     rateLimit: {
+ *       limit: 100,         // 100 requests
+ *       window: 60          // per minute
+ *     }
+ *   })
+ *   .listen(3000);
  * ```
  *
  * @example
- * Using Redis store for distributed rate limiting
+ * Using Redis store for distributed rate limiting (production)
  * ```ts
- * import { IoRedisStore } from '@nowarajs/kv-store';
- * import { rateLimit } from '@nowarajs/elysia-ratelimit';
+ * import { IoRedisStore } from '@mrxsys/mrx-core/modules/kv-store/ioredis'; // or use bun-redis
+ * import { rateLimit } from '@mrxsys/mrx-core/modules/elysia/elysia-ratelimit';
  * import { Elysia } from 'elysia';
  *
  * const redisStore = new IoRedisStore({
@@ -46,17 +59,40 @@ import type { RateLimitOptions } from './types/rate-limit-options';
  * await redisStore.connect();
  *
  * const app = new Elysia()
- *   .use(rateLimit({
- *     store: redisStore,
- *     limit: 1000,          // 1000 requests
- *     window: 3600,         // per hour
- *   }))
- *   .get('/api/endpoint', () => ({ message: 'Hello World' }));
+ *   .use(rateLimit(redisStore))
+ *   .get('/api/endpoint', () => ({ data: 'content' }), {
+ *     rateLimit: {
+ *       limit: 1000,        // 1000 requests
+ *       window: 3600        // per hour
+ *     }
+ *   })
+ *   .listen(3000);
+ * ```
  *
- * app.listen(3000);
+ * @example
+ * Global rate limit with route-level overrides
+ * ```ts
+ * const app = new Elysia()
+ *   .use(rateLimit())
+ *   .guard({
+ *     rateLimit: {
+ *       limit: 100,
+ *       window: 60
+ *     }
+ *   })
+ *   .get('/api/slow', () => 'content', {
+ *     rateLimit: {
+ *       limit: 10,          // Override global: stricter limit
+ *       window: 60
+ *     }
+ *   })
+ *   .get('/api/fast', () => 'content')  // Uses global limit
+ *   .listen(3000);
  * ```
+ *
+ * @throws ({@link HttpError}) – `elysia.rate-limit.error.exceeded` when the rate limit is exceeded (HTTP 429)
  */
-export declare const rateLimit: ({ store, limit, window }: RateLimitOptions) => Elysia<"", {
+export declare const rateLimit: (store?: KvStore) => Elysia<"", {
     decorator: {};
     store: {};
     derive: {};
@@ -67,8 +103,301 @@ export declare const rateLimit: ({ store, limit, window }: RateLimitOptions) =>
 }, {
     schema: {};
     standaloneSchema: {};
-    macro: {};
-    macroFn: {};
+    macro: Partial<{
+        readonly rateLimit: RateLimitOptions;
+    }>;
+    macroFn: {
+        readonly rateLimit: ({ limit, window }: RateLimitOptions) => {
+            readonly transform: ({ request }: {
+                body: unknown;
+                query: Record<string, string>;
+                params: {};
+                headers: Record<string, string | undefined>;
+                cookie: Record<string, import("elysia").Cookie<unknown>>;
+                server: import("elysia/universal/server").Server | null;
+                redirect: import("elysia").redirect;
+                set: {
+                    headers: HTTPHeaders;
+                    status?: number | keyof StatusMap;
+                    redirect?: string;
+                    cookie?: Record<string, import("elysia/cookies").ElysiaCookie>;
+                };
+                path: string;
+                route: string;
+                request: Request;
+                store: {};
+                status: <const Code extends number | keyof StatusMap, const T = Code extends 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 | 300 | 301 | 302 | 303 | 304 | 307 | 308 | 420 ? {
+                    readonly 100: "Continue";
+                    readonly 101: "Switching Protocols";
+                    readonly 102: "Processing";
+                    readonly 103: "Early Hints";
+                    readonly 200: "OK";
+                    readonly 201: "Created";
+                    readonly 202: "Accepted";
+                    readonly 203: "Non-Authoritative Information";
+                    readonly 204: "No Content";
+                    readonly 205: "Reset Content";
+                    readonly 206: "Partial Content";
+                    readonly 207: "Multi-Status";
+                    readonly 208: "Already Reported";
+                    readonly 300: "Multiple Choices";
+                    readonly 301: "Moved Permanently";
+                    readonly 302: "Found";
+                    readonly 303: "See Other";
+                    readonly 304: "Not Modified";
+                    readonly 307: "Temporary Redirect";
+                    readonly 308: "Permanent Redirect";
+                    readonly 400: "Bad Request";
+                    readonly 401: "Unauthorized";
+                    readonly 402: "Payment Required";
+                    readonly 403: "Forbidden";
+                    readonly 404: "Not Found";
+                    readonly 405: "Method Not Allowed";
+                    readonly 406: "Not Acceptable";
+                    readonly 407: "Proxy Authentication Required";
+                    readonly 408: "Request Timeout";
+                    readonly 409: "Conflict";
+                    readonly 410: "Gone";
+                    readonly 411: "Length Required";
+                    readonly 412: "Precondition Failed";
+                    readonly 413: "Payload Too Large";
+                    readonly 414: "URI Too Long";
+                    readonly 415: "Unsupported Media Type";
+                    readonly 416: "Range Not Satisfiable";
+                    readonly 417: "Expectation Failed";
+                    readonly 418: "I'm a teapot";
+                    readonly 420: "Enhance Your Calm";
+                    readonly 421: "Misdirected Request";
+                    readonly 422: "Unprocessable Content";
+                    readonly 423: "Locked";
+                    readonly 424: "Failed Dependency";
+                    readonly 425: "Too Early";
+                    readonly 426: "Upgrade Required";
+                    readonly 428: "Precondition Required";
+                    readonly 429: "Too Many Requests";
+                    readonly 431: "Request Header Fields Too Large";
+                    readonly 451: "Unavailable For Legal Reasons";
+                    readonly 500: "Internal Server Error";
+                    readonly 501: "Not Implemented";
+                    readonly 502: "Bad Gateway";
+                    readonly 503: "Service Unavailable";
+                    readonly 504: "Gateway Timeout";
+                    readonly 505: "HTTP Version Not Supported";
+                    readonly 506: "Variant Also Negotiates";
+                    readonly 507: "Insufficient Storage";
+                    readonly 508: "Loop Detected";
+                    readonly 510: "Not Extended";
+                    readonly 511: "Network Authentication Required";
+                }[Code] : Code>(code: Code, response?: T) => import("elysia").ElysiaCustomStatusResponse<Code, T, Code extends "Continue" | "Switching Protocols" | "Processing" | "Early Hints" | "OK" | "Created" | "Accepted" | "Non-Authoritative Information" | "No Content" | "Reset Content" | "Partial Content" | "Multi-Status" | "Already Reported" | "Multiple Choices" | "Moved Permanently" | "Found" | "See Other" | "Not Modified" | "Temporary Redirect" | "Permanent Redirect" | "Bad Request" | "Unauthorized" | "Payment Required" | "Forbidden" | "Not Found" | "Method Not Allowed" | "Not Acceptable" | "Proxy Authentication Required" | "Request Timeout" | "Conflict" | "Gone" | "Length Required" | "Precondition Failed" | "Payload Too Large" | "URI Too Long" | "Unsupported Media Type" | "Range Not Satisfiable" | "Expectation Failed" | "I'm a teapot" | "Enhance Your Calm" | "Misdirected Request" | "Unprocessable Content" | "Locked" | "Failed Dependency" | "Too Early" | "Upgrade Required" | "Precondition Required" | "Too Many Requests" | "Request Header Fields Too Large" | "Unavailable For Legal Reasons" | "Internal Server Error" | "Not Implemented" | "Bad Gateway" | "Service Unavailable" | "Gateway Timeout" | "HTTP Version Not Supported" | "Variant Also Negotiates" | "Insufficient Storage" | "Loop Detected" | "Not Extended" | "Network Authentication Required" ? {
+                    readonly Continue: 100;
+                    readonly "Switching Protocols": 101;
+                    readonly Processing: 102;
+                    readonly "Early Hints": 103;
+                    readonly OK: 200;
+                    readonly Created: 201;
+                    readonly Accepted: 202;
+                    readonly "Non-Authoritative Information": 203;
+                    readonly "No Content": 204;
+                    readonly "Reset Content": 205;
+                    readonly "Partial Content": 206;
+                    readonly "Multi-Status": 207;
+                    readonly "Already Reported": 208;
+                    readonly "Multiple Choices": 300;
+                    readonly "Moved Permanently": 301;
+                    readonly Found: 302;
+                    readonly "See Other": 303;
+                    readonly "Not Modified": 304;
+                    readonly "Temporary Redirect": 307;
+                    readonly "Permanent Redirect": 308;
+                    readonly "Bad Request": 400;
+                    readonly Unauthorized: 401;
+                    readonly "Payment Required": 402;
+                    readonly Forbidden: 403;
+                    readonly "Not Found": 404;
+                    readonly "Method Not Allowed": 405;
+                    readonly "Not Acceptable": 406;
+                    readonly "Proxy Authentication Required": 407;
+                    readonly "Request Timeout": 408;
+                    readonly Conflict: 409;
+                    readonly Gone: 410;
+                    readonly "Length Required": 411;
+                    readonly "Precondition Failed": 412;
+                    readonly "Payload Too Large": 413;
+                    readonly "URI Too Long": 414;
+                    readonly "Unsupported Media Type": 415;
+                    readonly "Range Not Satisfiable": 416;
+                    readonly "Expectation Failed": 417;
+                    readonly "I'm a teapot": 418;
+                    readonly "Enhance Your Calm": 420;
+                    readonly "Misdirected Request": 421;
+                    readonly "Unprocessable Content": 422;
+                    readonly Locked: 423;
+                    readonly "Failed Dependency": 424;
+                    readonly "Too Early": 425;
+                    readonly "Upgrade Required": 426;
+                    readonly "Precondition Required": 428;
+                    readonly "Too Many Requests": 429;
+                    readonly "Request Header Fields Too Large": 431;
+                    readonly "Unavailable For Legal Reasons": 451;
+                    readonly "Internal Server Error": 500;
+                    readonly "Not Implemented": 501;
+                    readonly "Bad Gateway": 502;
+                    readonly "Service Unavailable": 503;
+                    readonly "Gateway Timeout": 504;
+                    readonly "HTTP Version Not Supported": 505;
+                    readonly "Variant Also Negotiates": 506;
+                    readonly "Insufficient Storage": 507;
+                    readonly "Loop Detected": 508;
+                    readonly "Not Extended": 510;
+                    readonly "Network Authentication Required": 511;
+                }[Code] : Code>;
+            }) => void;
+            readonly beforeHandle: ({ set, request, server }: {
+                body: unknown;
+                query: Record<string, string>;
+                params: {};
+                headers: Record<string, string | undefined>;
+                cookie: Record<string, import("elysia").Cookie<unknown>>;
+                server: import("elysia/universal/server").Server | null;
+                redirect: import("elysia").redirect;
+                set: {
+                    headers: HTTPHeaders;
+                    status?: number | keyof StatusMap;
+                    redirect?: string;
+                    cookie?: Record<string, import("elysia/cookies").ElysiaCookie>;
+                };
+                path: string;
+                route: string;
+                request: Request;
+                store: {};
+                status: <const Code extends number | keyof StatusMap, const T = Code extends 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 | 300 | 301 | 302 | 303 | 304 | 307 | 308 | 420 ? {
+                    readonly 100: "Continue";
+                    readonly 101: "Switching Protocols";
+                    readonly 102: "Processing";
+                    readonly 103: "Early Hints";
+                    readonly 200: "OK";
+                    readonly 201: "Created";
+                    readonly 202: "Accepted";
+                    readonly 203: "Non-Authoritative Information";
+                    readonly 204: "No Content";
+                    readonly 205: "Reset Content";
+                    readonly 206: "Partial Content";
+                    readonly 207: "Multi-Status";
+                    readonly 208: "Already Reported";
+                    readonly 300: "Multiple Choices";
+                    readonly 301: "Moved Permanently";
+                    readonly 302: "Found";
+                    readonly 303: "See Other";
+                    readonly 304: "Not Modified";
+                    readonly 307: "Temporary Redirect";
+                    readonly 308: "Permanent Redirect";
+                    readonly 400: "Bad Request";
+                    readonly 401: "Unauthorized";
+                    readonly 402: "Payment Required";
+                    readonly 403: "Forbidden";
+                    readonly 404: "Not Found";
+                    readonly 405: "Method Not Allowed";
+                    readonly 406: "Not Acceptable";
+                    readonly 407: "Proxy Authentication Required";
+                    readonly 408: "Request Timeout";
+                    readonly 409: "Conflict";
+                    readonly 410: "Gone";
+                    readonly 411: "Length Required";
+                    readonly 412: "Precondition Failed";
+                    readonly 413: "Payload Too Large";
+                    readonly 414: "URI Too Long";
+                    readonly 415: "Unsupported Media Type";
+                    readonly 416: "Range Not Satisfiable";
+                    readonly 417: "Expectation Failed";
+                    readonly 418: "I'm a teapot";
+                    readonly 420: "Enhance Your Calm";
+                    readonly 421: "Misdirected Request";
+                    readonly 422: "Unprocessable Content";
+                    readonly 423: "Locked";
+                    readonly 424: "Failed Dependency";
+                    readonly 425: "Too Early";
+                    readonly 426: "Upgrade Required";
+                    readonly 428: "Precondition Required";
+                    readonly 429: "Too Many Requests";
+                    readonly 431: "Request Header Fields Too Large";
+                    readonly 451: "Unavailable For Legal Reasons";
+                    readonly 500: "Internal Server Error";
+                    readonly 501: "Not Implemented";
+                    readonly 502: "Bad Gateway";
+                    readonly 503: "Service Unavailable";
+                    readonly 504: "Gateway Timeout";
+                    readonly 505: "HTTP Version Not Supported";
+                    readonly 506: "Variant Also Negotiates";
+                    readonly 507: "Insufficient Storage";
+                    readonly 508: "Loop Detected";
+                    readonly 510: "Not Extended";
+                    readonly 511: "Network Authentication Required";
+                }[Code] : Code>(code: Code, response?: T) => import("elysia").ElysiaCustomStatusResponse<Code, T, Code extends "Continue" | "Switching Protocols" | "Processing" | "Early Hints" | "OK" | "Created" | "Accepted" | "Non-Authoritative Information" | "No Content" | "Reset Content" | "Partial Content" | "Multi-Status" | "Already Reported" | "Multiple Choices" | "Moved Permanently" | "Found" | "See Other" | "Not Modified" | "Temporary Redirect" | "Permanent Redirect" | "Bad Request" | "Unauthorized" | "Payment Required" | "Forbidden" | "Not Found" | "Method Not Allowed" | "Not Acceptable" | "Proxy Authentication Required" | "Request Timeout" | "Conflict" | "Gone" | "Length Required" | "Precondition Failed" | "Payload Too Large" | "URI Too Long" | "Unsupported Media Type" | "Range Not Satisfiable" | "Expectation Failed" | "I'm a teapot" | "Enhance Your Calm" | "Misdirected Request" | "Unprocessable Content" | "Locked" | "Failed Dependency" | "Too Early" | "Upgrade Required" | "Precondition Required" | "Too Many Requests" | "Request Header Fields Too Large" | "Unavailable For Legal Reasons" | "Internal Server Error" | "Not Implemented" | "Bad Gateway" | "Service Unavailable" | "Gateway Timeout" | "HTTP Version Not Supported" | "Variant Also Negotiates" | "Insufficient Storage" | "Loop Detected" | "Not Extended" | "Network Authentication Required" ? {
+                    readonly Continue: 100;
+                    readonly "Switching Protocols": 101;
+                    readonly Processing: 102;
+                    readonly "Early Hints": 103;
+                    readonly OK: 200;
+                    readonly Created: 201;
+                    readonly Accepted: 202;
+                    readonly "Non-Authoritative Information": 203;
+                    readonly "No Content": 204;
+                    readonly "Reset Content": 205;
+                    readonly "Partial Content": 206;
+                    readonly "Multi-Status": 207;
+                    readonly "Already Reported": 208;
+                    readonly "Multiple Choices": 300;
+                    readonly "Moved Permanently": 301;
+                    readonly Found: 302;
+                    readonly "See Other": 303;
+                    readonly "Not Modified": 304;
+                    readonly "Temporary Redirect": 307;
+                    readonly "Permanent Redirect": 308;
+                    readonly "Bad Request": 400;
+                    readonly Unauthorized: 401;
+                    readonly "Payment Required": 402;
+                    readonly Forbidden: 403;
+                    readonly "Not Found": 404;
+                    readonly "Method Not Allowed": 405;
+                    readonly "Not Acceptable": 406;
+                    readonly "Proxy Authentication Required": 407;
+                    readonly "Request Timeout": 408;
+                    readonly Conflict: 409;
+                    readonly Gone: 410;
+                    readonly "Length Required": 411;
+                    readonly "Precondition Failed": 412;
+                    readonly "Payload Too Large": 413;
+                    readonly "URI Too Long": 414;
+                    readonly "Unsupported Media Type": 415;
+                    readonly "Range Not Satisfiable": 416;
+                    readonly "Expectation Failed": 417;
+                    readonly "I'm a teapot": 418;
+                    readonly "Enhance Your Calm": 420;
+                    readonly "Misdirected Request": 421;
+                    readonly "Unprocessable Content": 422;
+                    readonly Locked: 423;
+                    readonly "Failed Dependency": 424;
+                    readonly "Too Early": 425;
+                    readonly "Upgrade Required": 426;
+                    readonly "Precondition Required": 428;
+                    readonly "Too Many Requests": 429;
+                    readonly "Request Header Fields Too Large": 431;
+                    readonly "Unavailable For Legal Reasons": 451;
+                    readonly "Internal Server Error": 500;
+                    readonly "Not Implemented": 501;
+                    readonly "Bad Gateway": 502;
+                    readonly "Service Unavailable": 503;
+                    readonly "Gateway Timeout": 504;
+                    readonly "HTTP Version Not Supported": 505;
+                    readonly "Variant Also Negotiates": 506;
+                    readonly "Insufficient Storage": 507;
+                    readonly "Loop Detected": 508;
+                    readonly "Not Extended": 510;
+                    readonly "Network Authentication Required": 511;
+                }[Code] : Code>;
+            }) => Promise<void>;
+        };
+    };
     parser: {};
     response: {};
 }, {}, {

package/dist/modules/elysia/rate-limit/types/rate-limit-options.d.ts

@@ -1,13 +1,4 @@
-import type { KvStore } from '../../../../modules/kv-store/types/kv-store';
 export interface RateLimitOptions {
-    /**
-     * Storage backend for rate limit data.
-     *
-     * - If not specified, defaults to in-memory storage
-     * - Use ':memory:' to explicitly specify in-memory storage
-     * - Provide a KvStore instance for persistent distributed storage
-     */
-    readonly store?: ':memory:' | KvStore;
     /**
      * Maximum number of requests allowed in the time window.
      *

package/dist/modules/jwt/index.js

@@ -8,8 +8,8 @@ import {
 import"../../chunk-12qzn7jw.js";
 import {
   HttpError
-} from "../../chunk-00s6t4tw.js";
-import"../../chunk-h9t48r9q.js";
+} from "../../chunk-7t524zqh.js";
+import"../../chunk-sqts8vyk.js";
 import"../../chunk-9cgzhc50.js";
 
 // source/modules/jwt/jwt.ts

package/dist/modules/kv-store/bun-redis/bun-redis-store.d.ts

@@ -0,0 +1,25 @@
+import { type RedisOptions } from 'bun';
+import type { KvStore } from '../../../modules/kv-store/types/kv-store';
+/**
+ * Redis-based key-value store implementation using Bun's Redis client.
+ *
+ * Provides a Redis-backed implementation of the KvStore interface with
+ * automatic JSON serialization/deserialization and proper error handling.
+ */
+export declare class BunRedisStore implements KvStore {
+    /**
+     * Redis client instance.
+     */
+    private readonly _client;
+    constructor(url?: string, options?: RedisOptions);
+    connect(): Promise<void>;
+    close?(): void;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T = unknown>(key: string, value: T, ttlSec?: number): Promise<void>;
+    increment(key: string, amount?: number): Promise<number>;
+    decrement(key: string, amount?: number): Promise<number>;
+    del(key: string): Promise<boolean>;
+    expire(key: string, ttlSec: number): Promise<boolean>;
+    ttl(key: string): Promise<number>;
+    clean(): Promise<number>;
+}

package/dist/modules/kv-store/bun-redis/index.d.ts

@@ -0,0 +1 @@
+export { BunRedisStore } from './bun-redis-store';

package/dist/modules/kv-store/bun-redis/index.js

@@ -0,0 +1,76 @@
+// @bun
+import {
+  KV_STORE_ERROR_KEYS
+} from "../../../chunk-xhhj1gvj.js";
+import {
+  BaseError
+} from "../../../chunk-9cgzhc50.js";
+
+// source/modules/kv-store/bun-redis/bun-redis-store.ts
+var {RedisClient } = globalThis.Bun;
+class BunRedisStore {
+  _client;
+  constructor(url, options) {
+    this._client = new RedisClient(url, options);
+  }
+  async connect() {
+    await this._client.connect();
+  }
+  close() {
+    this._client.close();
+  }
+  async get(key) {
+    const value = await this._client.get(key);
+    if (value === null)
+      return null;
+    try {
+      return JSON.parse(value);
+    } catch {
+      return value;
+    }
+  }
+  async set(key, value, ttlSec) {
+    const serialized = typeof value === "string" ? value : JSON.stringify(value);
+    if (ttlSec)
+      await this._client.set(key, serialized, "EX", ttlSec);
+    else
+      await this._client.set(key, serialized);
+  }
+  async increment(key, amount) {
+    let current = Number(await this._client.get(key));
+    if (current !== null && isNaN(current))
+      throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
+    current += amount ?? 1;
+    await this._client.set(key, current.toString());
+    return current;
+  }
+  async decrement(key, amount) {
+    let current = Number(await this._client.get(key));
+    if (current !== null && isNaN(current))
+      throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
+    current -= amount ?? 1;
+    await this._client.set(key, current.toString());
+    return current;
+  }
+  async del(key) {
+    const res = await this._client.del(key);
+    return res === 1;
+  }
+  async expire(key, ttlSec) {
+    const res = await this._client.expire(key, ttlSec);
+    return res === 1;
+  }
+  async ttl(key) {
+    const res = await this._client.ttl(key);
+    return res;
+  }
+  async clean() {
+    const keys = await this._client.keys("*");
+    if (keys.length === 0)
+      return 0;
+    return this._client.del(...keys);
+  }
+}
+export {
+  BunRedisStore
+};

package/dist/modules/kv-store/ioredis/index.js

@@ -49,22 +49,16 @@ class IoRedisStore {
   }
   async increment(key, amount = 1) {
     const current = await this._client.get(key);
-    if (current !== null) {
-      const parsed = Number(current);
-      if (Number.isNaN(parsed))
-        throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
-    }
+    if (current !== null && isNaN(Number(current)))
+      throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
     if (amount === 1)
       return this._client.incr(key);
     return this._client.incrby(key, amount);
   }
   async decrement(key, amount = 1) {
     const current = await this._client.get(key);
-    if (current !== null) {
-      const parsed = Number(current);
-      if (Number.isNaN(parsed))
-        throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
-    }
+    if (current !== null && isNaN(Number(current)))
+      throw new BaseError(KV_STORE_ERROR_KEYS.NOT_INTEGER);
     if (amount === 1)
       return this._client.decr(key);
     return this._client.decrby(key, amount);