limitly 1.0.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +471 -22
  2. package/dist/algorithms/concurrency.d.ts +11 -0
  3. package/dist/algorithms/concurrency.d.ts.map +1 -0
  4. package/dist/algorithms/concurrency.js +19 -0
  5. package/dist/algorithms/concurrency.js.map +1 -0
  6. package/dist/algorithms/factory.d.ts +3 -2
  7. package/dist/algorithms/factory.d.ts.map +1 -1
  8. package/dist/algorithms/factory.js +9 -3
  9. package/dist/algorithms/factory.js.map +1 -1
  10. package/dist/algorithms/gcra.d.ts +10 -0
  11. package/dist/algorithms/gcra.d.ts.map +1 -0
  12. package/dist/algorithms/gcra.js +15 -0
  13. package/dist/algorithms/gcra.js.map +1 -0
  14. package/dist/algorithms/sliding-window.d.ts +4 -4
  15. package/dist/algorithms/sliding-window.d.ts.map +1 -1
  16. package/dist/algorithms/sliding-window.js +3 -23
  17. package/dist/algorithms/sliding-window.js.map +1 -1
  18. package/dist/algorithms/token-bucket.d.ts +4 -4
  19. package/dist/algorithms/token-bucket.d.ts.map +1 -1
  20. package/dist/algorithms/token-bucket.js +3 -20
  21. package/dist/algorithms/token-bucket.js.map +1 -1
  22. package/dist/index.d.ts +19 -1
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +46 -1
  25. package/dist/index.js.map +1 -1
  26. package/dist/limiter.d.ts +23 -7
  27. package/dist/limiter.d.ts.map +1 -1
  28. package/dist/limiter.js +86 -16
  29. package/dist/limiter.js.map +1 -1
  30. package/dist/middleware/bun.d.ts +9 -0
  31. package/dist/middleware/bun.d.ts.map +1 -0
  32. package/dist/middleware/bun.js +107 -0
  33. package/dist/middleware/bun.js.map +1 -0
  34. package/dist/middleware/express.d.ts.map +1 -1
  35. package/dist/middleware/express.js +30 -14
  36. package/dist/middleware/express.js.map +1 -1
  37. package/dist/middleware/fastify.d.ts +3 -3
  38. package/dist/middleware/fastify.d.ts.map +1 -1
  39. package/dist/middleware/fastify.js +34 -17
  40. package/dist/middleware/fastify.js.map +1 -1
  41. package/dist/middleware/hono.d.ts +5 -0
  42. package/dist/middleware/hono.d.ts.map +1 -0
  43. package/dist/middleware/hono.js +71 -0
  44. package/dist/middleware/hono.js.map +1 -0
  45. package/dist/middleware/koa.d.ts +5 -0
  46. package/dist/middleware/koa.d.ts.map +1 -0
  47. package/dist/middleware/koa.js +65 -0
  48. package/dist/middleware/koa.js.map +1 -0
  49. package/dist/middleware/nest.d.ts +14 -0
  50. package/dist/middleware/nest.d.ts.map +1 -0
  51. package/dist/middleware/nest.js +112 -0
  52. package/dist/middleware/nest.js.map +1 -0
  53. package/dist/observability/index.d.ts +4 -0
  54. package/dist/observability/index.d.ts.map +1 -0
  55. package/dist/observability/index.js +10 -0
  56. package/dist/observability/index.js.map +1 -0
  57. package/dist/observability/opentelemetry.d.ts +28 -0
  58. package/dist/observability/opentelemetry.d.ts.map +1 -0
  59. package/dist/observability/opentelemetry.js +85 -0
  60. package/dist/observability/opentelemetry.js.map +1 -0
  61. package/dist/observability/prometheus.d.ts +27 -0
  62. package/dist/observability/prometheus.d.ts.map +1 -0
  63. package/dist/observability/prometheus.js +88 -0
  64. package/dist/observability/prometheus.js.map +1 -0
  65. package/dist/observability/types.d.ts +9 -0
  66. package/dist/observability/types.d.ts.map +1 -0
  67. package/dist/observability/types.js +3 -0
  68. package/dist/observability/types.js.map +1 -0
  69. package/dist/prometheus.d.ts +3 -0
  70. package/dist/prometheus.d.ts.map +1 -0
  71. package/dist/prometheus.js +9 -0
  72. package/dist/prometheus.js.map +1 -0
  73. package/dist/scripts/concurrencyAcquire.lua +34 -0
  74. package/dist/scripts/concurrencyRelease.lua +9 -0
  75. package/dist/scripts/gcra.lua +38 -0
  76. package/dist/stores/factory.d.ts +5 -0
  77. package/dist/stores/factory.d.ts.map +1 -0
  78. package/dist/stores/factory.js +40 -0
  79. package/dist/stores/factory.js.map +1 -0
  80. package/dist/stores/memcached-store.d.ts +16 -0
  81. package/dist/stores/memcached-store.d.ts.map +1 -0
  82. package/dist/stores/memcached-store.js +211 -0
  83. package/dist/stores/memcached-store.js.map +1 -0
  84. package/dist/stores/redis-store.d.ts +19 -0
  85. package/dist/stores/redis-store.d.ts.map +1 -0
  86. package/dist/stores/redis-store.js +97 -0
  87. package/dist/stores/redis-store.js.map +1 -0
  88. package/dist/stores/types.d.ts +11 -0
  89. package/dist/stores/types.d.ts.map +1 -0
  90. package/dist/stores/types.js +3 -0
  91. package/dist/stores/types.js.map +1 -0
  92. package/dist/types/index.d.ts +94 -5
  93. package/dist/types/index.d.ts.map +1 -1
  94. package/dist/utils/defaults.d.ts +8 -0
  95. package/dist/utils/defaults.d.ts.map +1 -0
  96. package/dist/utils/defaults.js +100 -0
  97. package/dist/utils/defaults.js.map +1 -0
  98. package/dist/utils/limit-execution.d.ts +40 -0
  99. package/dist/utils/limit-execution.d.ts.map +1 -0
  100. package/dist/utils/limit-execution.js +50 -0
  101. package/dist/utils/limit-execution.js.map +1 -0
  102. package/dist/utils/memcached.d.ts +12 -0
  103. package/dist/utils/memcached.d.ts.map +1 -0
  104. package/dist/utils/memcached.js +103 -0
  105. package/dist/utils/memcached.js.map +1 -0
  106. package/dist/utils/metrics.d.ts +21 -0
  107. package/dist/utils/metrics.d.ts.map +1 -0
  108. package/dist/utils/metrics.js +99 -0
  109. package/dist/utils/metrics.js.map +1 -0
  110. package/dist/utils/redis.d.ts +5 -1
  111. package/dist/utils/redis.d.ts.map +1 -1
  112. package/dist/utils/redis.js +38 -3
  113. package/dist/utils/redis.js.map +1 -1
  114. package/dist/utils/scripts.d.ts +16 -2
  115. package/dist/utils/scripts.d.ts.map +1 -1
  116. package/dist/utils/scripts.js +79 -33
  117. package/dist/utils/scripts.js.map +1 -1
  118. package/package.json +86 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memcached-store.js","sourceRoot":"","sources":["../../src/stores/memcached-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { RedisClient } from "../types";
2
+ import type { RateLimitStore, StoreType } from "./types";
3
+ export declare class RedisStore implements RateLimitStore {
4
+ readonly type: StoreType;
5
+ private readonly client;
6
+ private readonly keyPrefix;
7
+ private readonly hashTag?;
8
+ constructor(client: RedisClient, keyPrefix: string, type?: StoreType, options?: {
9
+ hashTag?: string;
10
+ warmupScripts?: boolean;
11
+ });
12
+ getClient(): RedisClient;
13
+ slidingWindow(key: string, limit: number, window: number): Promise<import("../types").RateLimitResult>;
14
+ tokenBucket(key: string, capacity: number, refillRate: number): Promise<import("../types").RateLimitResult>;
15
+ concurrencyAcquire(key: string, limit: number, ttl: number): Promise<import("../types").RateLimitResult>;
16
+ concurrencyRelease(key: string, slotId: string): Promise<void>;
17
+ gcra(key: string, limit: number, window: number): Promise<import("../types").RateLimitResult>;
18
+ }
19
+ //# sourceMappingURL=redis-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAGhC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAmB,EACzB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO;IAiB7D,SAAS,IAAI,WAAW;IAIlB,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;IAuBxC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;IAqBxC,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;IAwBxC,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,UAAU,EAAE,eAAe,CAAC;CAoB/C"}
@@ -0,0 +1,97 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.RedisStore = void 0;
4
+ const crypto_1 = require("crypto");
5
+ const redis_1 = require("../utils/redis");
6
+ const scripts_1 = require("../utils/scripts");
7
+ class RedisStore {
8
+ constructor(client, keyPrefix, type = "redis", options = {}) {
9
+ this.client = client;
10
+ this.keyPrefix = keyPrefix;
11
+ this.type = type;
12
+ this.hashTag = options.hashTag;
13
+ const shouldWarmup = options.warmupScripts ?? (0, redis_1.isRedisCluster)(client);
14
+ if (shouldWarmup) {
15
+ void (0, scripts_1.warmupRedisScripts)(client).catch(() => {
16
+ // Warmup is best-effort; checks still work via defineCommand fallbacks.
17
+ });
18
+ }
19
+ }
20
+ getClient() {
21
+ return this.client;
22
+ }
23
+ async slidingWindow(key, limit, window) {
24
+ const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `sw:${key}`, this.hashTag);
25
+ const now = Date.now();
26
+ const requestId = (0, crypto_1.randomUUID)();
27
+ const result = await (0, scripts_1.evalScript)(this.client, "sliding", [redisKey], [
28
+ limit,
29
+ window,
30
+ now,
31
+ requestId,
32
+ ]);
33
+ const parsed = (0, scripts_1.parseScriptResult)(result);
34
+ return {
35
+ allowed: parsed.allowed,
36
+ limit: parsed.limit,
37
+ remaining: parsed.remaining,
38
+ reset: parsed.reset,
39
+ retryAfter: parsed.retryAfter || undefined,
40
+ };
41
+ }
42
+ async tokenBucket(key, capacity, refillRate) {
43
+ const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `tb:${key}`, this.hashTag);
44
+ const now = Date.now();
45
+ const result = await (0, scripts_1.evalScript)(this.client, "token", [redisKey], [
46
+ capacity,
47
+ refillRate,
48
+ now,
49
+ ]);
50
+ const parsed = (0, scripts_1.parseScriptResult)(result);
51
+ return {
52
+ allowed: parsed.allowed,
53
+ limit: parsed.limit,
54
+ remaining: parsed.remaining,
55
+ reset: parsed.reset,
56
+ retryAfter: parsed.retryAfter || undefined,
57
+ };
58
+ }
59
+ async concurrencyAcquire(key, limit, ttl) {
60
+ const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `cc:${key}`, this.hashTag);
61
+ const now = Date.now();
62
+ const slotId = (0, crypto_1.randomUUID)();
63
+ const result = await (0, scripts_1.evalScript)(this.client, "concurrencyAcquire", [redisKey], [limit, ttl, slotId, now]);
64
+ const parsed = (0, scripts_1.parseScriptResult)(result);
65
+ return {
66
+ allowed: parsed.allowed,
67
+ limit: parsed.limit,
68
+ remaining: parsed.remaining,
69
+ reset: parsed.reset,
70
+ retryAfter: parsed.retryAfter || undefined,
71
+ slotId: parsed.slotId,
72
+ };
73
+ }
74
+ async concurrencyRelease(key, slotId) {
75
+ const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `cc:${key}`, this.hashTag);
76
+ await (0, scripts_1.evalScript)(this.client, "concurrencyRelease", [redisKey], [slotId]);
77
+ }
78
+ async gcra(key, limit, window) {
79
+ const redisKey = (0, redis_1.buildKey)(this.keyPrefix, `gcra:${key}`, this.hashTag);
80
+ const now = Date.now();
81
+ const result = await (0, scripts_1.evalScript)(this.client, "gcra", [redisKey], [
82
+ limit,
83
+ window,
84
+ now,
85
+ ]);
86
+ const parsed = (0, scripts_1.parseScriptResult)(result);
87
+ return {
88
+ allowed: parsed.allowed,
89
+ limit: parsed.limit,
90
+ remaining: parsed.remaining,
91
+ reset: parsed.reset,
92
+ retryAfter: parsed.retryAfter || undefined,
93
+ };
94
+ }
95
+ }
96
+ exports.RedisStore = RedisStore;
97
+ //# sourceMappingURL=redis-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redis-store.js","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { RateLimitResult } from "../types";
2
+ export type StoreType = "redis" | "valkey" | "dragonfly" | "memcached";
3
+ export interface RateLimitStore {
4
+ readonly type: StoreType;
5
+ slidingWindow(key: string, limit: number, window: number): Promise<RateLimitResult>;
6
+ tokenBucket(key: string, capacity: number, refillRate: number): Promise<RateLimitResult>;
7
+ concurrencyAcquire(key: string, limit: number, ttl: number): Promise<RateLimitResult>;
8
+ concurrencyRelease(key: string, slotId: string): Promise<void>;
9
+ gcra(key: string, limit: number, window: number): Promise<RateLimitResult>;
10
+ }
11
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stores/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,aAAa,CACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,WAAW,CACT,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5E"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stores/types.ts"],"names":[],"mappings":""}
@@ -1,16 +1,46 @@
1
- import type { Cluster, Redis, RedisOptions } from "ioredis";
1
+ import type { Cluster, ClusterOptions, Redis, RedisOptions } from "ioredis";
2
+ import type Memcached from "memcached";
3
+ import type { RateLimitTracer } from "../observability/types";
4
+ import type { StoreType } from "../stores/types";
5
+ export type { StoreType };
2
6
  export type RedisClient = Redis | Cluster;
3
- export type RedisConfig = RedisClient | string | RedisOptions | {
7
+ export type RedisClusterConfig = {
4
8
  nodes: {
5
9
  host: string;
6
10
  port: number;
7
11
  }[];
8
- options?: RedisOptions;
12
+ options?: ClusterOptions;
13
+ };
14
+ export type RedisConfig = RedisClient | string | RedisOptions | RedisClusterConfig;
15
+ export type MemcachedClient = Memcached;
16
+ export type MemcachedOptions = Memcached.options;
17
+ export type MemcachedConfig = MemcachedClient | string | string[] | {
18
+ servers: string | string[];
19
+ options?: MemcachedOptions;
9
20
  };
10
21
  export interface RedisLimitOptions {
11
- redis: RedisConfig;
22
+ /** Storage backend. Defaults to "redis", or "memcached" when memcached config is provided. */
23
+ store?: StoreType;
24
+ /** Redis-compatible connection (Redis, Valkey, DragonflyDB) */
25
+ redis?: RedisConfig;
26
+ /** Memcached server(s) */
27
+ memcached?: MemcachedConfig;
12
28
  failOpen?: boolean;
29
+ /** Storage key prefix. Defaults to "limitly". Keys are stored as `{prefix}:sw:{id}` or `{prefix}:tb:{id}`. */
13
30
  keyPrefix?: string;
31
+ /**
32
+ * Redis Cluster hash tag for slot pinning. Keys become `{tag}:{prefix}:sw:{id}`.
33
+ * Leave unset to distribute keys across slots (recommended for throughput).
34
+ */
35
+ hashTag?: string;
36
+ /** Preload Lua scripts on all cluster masters at startup. Defaults to `true` for cluster. */
37
+ warmupScripts?: boolean;
38
+ /** Default rate limit config applied when middleware options omit algorithm settings. */
39
+ default?: MiddlewareOptionsInput;
40
+ /** Global metrics hook applied to all rate limit checks. */
41
+ onMetrics?: RateLimitMetricsHook | RateLimitMetricsHook[];
42
+ /** Global tracer for distributed tracing of rate limit checks. */
43
+ tracer?: RateLimitTracer;
14
44
  }
15
45
  export interface RateLimitResult {
16
46
  allowed: boolean;
@@ -18,9 +48,12 @@ export interface RateLimitResult {
18
48
  remaining: number;
19
49
  reset: number;
20
50
  retryAfter?: number;
51
+ /** Present when a concurrency slot was acquired. */
52
+ slotId?: string;
21
53
  }
22
54
  export interface RateLimitStrategy {
23
55
  consume(key: string): Promise<RateLimitResult>;
56
+ release?(key: string, slotId: string): Promise<void>;
24
57
  }
25
58
  export interface SlidingWindowConfig {
26
59
  algorithm: "sliding-window";
@@ -32,14 +65,70 @@ export interface TokenBucketConfig {
32
65
  capacity: number;
33
66
  refillRate: number;
34
67
  }
35
- export type AlgorithmConfig = SlidingWindowConfig | TokenBucketConfig;
68
+ export interface ConcurrencyConfig {
69
+ algorithm: "concurrency";
70
+ /** Maximum in-flight requests per key. */
71
+ limit: number;
72
+ /** Lease TTL in seconds for stale slot cleanup. Defaults to 300. */
73
+ ttl?: number;
74
+ }
75
+ export interface GcraConfig {
76
+ algorithm: "gcra";
77
+ limit: number;
78
+ window: number;
79
+ }
80
+ export type AlgorithmConfig = SlidingWindowConfig | TokenBucketConfig | ConcurrencyConfig | GcraConfig;
81
+ export type RateLimitMetricsEvent = {
82
+ type: "allowed";
83
+ key: string;
84
+ algorithm: AlgorithmConfig["algorithm"];
85
+ result: RateLimitResult;
86
+ durationMs: number;
87
+ store?: StoreType;
88
+ context?: unknown;
89
+ } | {
90
+ type: "blocked";
91
+ key: string;
92
+ algorithm: AlgorithmConfig["algorithm"];
93
+ result: RateLimitResult;
94
+ durationMs: number;
95
+ store?: StoreType;
96
+ context?: unknown;
97
+ } | {
98
+ type: "error";
99
+ key: string;
100
+ algorithm: AlgorithmConfig["algorithm"];
101
+ error: unknown;
102
+ durationMs: number;
103
+ failOpen: boolean;
104
+ store?: StoreType;
105
+ context?: unknown;
106
+ } | {
107
+ type: "fail_open";
108
+ key: string;
109
+ algorithm: AlgorithmConfig["algorithm"];
110
+ durationMs: number;
111
+ store?: StoreType;
112
+ context?: unknown;
113
+ };
114
+ export type RateLimitMetricsHook = (event: RateLimitMetricsEvent) => void | Promise<void>;
36
115
  export interface BaseMiddlewareOptions {
37
116
  key?: (req: unknown) => string | undefined;
38
117
  headers?: boolean;
39
118
  onLimitReached?: (req: unknown, res: unknown) => void | Promise<void>;
119
+ onMetrics?: RateLimitMetricsHook | RateLimitMetricsHook[];
120
+ tracer?: RateLimitTracer;
40
121
  failOpen?: boolean;
41
122
  }
42
123
  export type MiddlewareOptions = BaseMiddlewareOptions & AlgorithmConfig;
124
+ export type MiddlewareOptionsInput = BaseMiddlewareOptions & {
125
+ algorithm?: "sliding-window" | "token-bucket" | "concurrency" | "gcra";
126
+ limit?: number;
127
+ window?: number;
128
+ capacity?: number;
129
+ refillRate?: number;
130
+ ttl?: number;
131
+ };
43
132
  export interface RateLimitHeaders {
44
133
  "X-RateLimit-Limit": string;
45
134
  "X-RateLimit-Remaining": string;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,MAAM,GACN,YAAY,GACZ;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { AlgorithmConfig, ConcurrencyConfig, GcraConfig, MiddlewareOptions, MiddlewareOptionsInput, SlidingWindowConfig, TokenBucketConfig } from "../types";
2
+ export declare const DEFAULT_SLIDING_WINDOW: SlidingWindowConfig;
3
+ export declare const DEFAULT_TOKEN_BUCKET: TokenBucketConfig;
4
+ export declare const DEFAULT_CONCURRENCY: ConcurrencyConfig;
5
+ export declare const DEFAULT_GCRA: GcraConfig;
6
+ export declare function resolveMiddlewareOptions(options?: MiddlewareOptionsInput, defaults?: MiddlewareOptionsInput): MiddlewareOptions;
7
+ export declare function resolveAlgorithmConfig(options?: MiddlewareOptionsInput, defaults?: MiddlewareOptionsInput): AlgorithmConfig;
8
+ //# sourceMappingURL=defaults.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/utils/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,sBAAsB,EAAE,mBAIpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,iBAIjC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,UAI1B,CAAC;AAeF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,sBAA2B,EACpC,QAAQ,GAAE,sBAA2B,GACpC,iBAAiB,CAsCnB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,sBAA2B,EACpC,QAAQ,GAAE,sBAA2B,GACpC,eAAe,CA+BjB"}
@@ -0,0 +1,100 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DEFAULT_GCRA = exports.DEFAULT_CONCURRENCY = exports.DEFAULT_TOKEN_BUCKET = exports.DEFAULT_SLIDING_WINDOW = void 0;
4
+ exports.resolveMiddlewareOptions = resolveMiddlewareOptions;
5
+ exports.resolveAlgorithmConfig = resolveAlgorithmConfig;
6
+ exports.DEFAULT_SLIDING_WINDOW = {
7
+ algorithm: "sliding-window",
8
+ limit: 100,
9
+ window: 60,
10
+ };
11
+ exports.DEFAULT_TOKEN_BUCKET = {
12
+ algorithm: "token-bucket",
13
+ capacity: 100,
14
+ refillRate: 10,
15
+ };
16
+ exports.DEFAULT_CONCURRENCY = {
17
+ algorithm: "concurrency",
18
+ limit: 10,
19
+ ttl: 300,
20
+ };
21
+ exports.DEFAULT_GCRA = {
22
+ algorithm: "gcra",
23
+ limit: 100,
24
+ window: 60,
25
+ };
26
+ function pickBaseOptions(options) {
27
+ return {
28
+ key: options.key,
29
+ headers: options.headers,
30
+ onLimitReached: options.onLimitReached,
31
+ onMetrics: options.onMetrics,
32
+ tracer: options.tracer,
33
+ failOpen: options.failOpen,
34
+ };
35
+ }
36
+ function resolveMiddlewareOptions(options = {}, defaults = {}) {
37
+ const merged = { ...defaults, ...options };
38
+ const base = pickBaseOptions(merged);
39
+ const algorithm = merged.algorithm ?? exports.DEFAULT_GCRA.algorithm;
40
+ if (algorithm === "token-bucket") {
41
+ return {
42
+ ...base,
43
+ algorithm: "token-bucket",
44
+ capacity: merged.capacity ?? exports.DEFAULT_TOKEN_BUCKET.capacity,
45
+ refillRate: merged.refillRate ?? exports.DEFAULT_TOKEN_BUCKET.refillRate,
46
+ };
47
+ }
48
+ if (algorithm === "concurrency") {
49
+ return {
50
+ ...base,
51
+ algorithm: "concurrency",
52
+ limit: merged.limit ?? exports.DEFAULT_CONCURRENCY.limit,
53
+ ttl: merged.ttl ?? exports.DEFAULT_CONCURRENCY.ttl,
54
+ };
55
+ }
56
+ if (algorithm === "gcra") {
57
+ return {
58
+ ...base,
59
+ algorithm: "gcra",
60
+ limit: merged.limit ?? exports.DEFAULT_GCRA.limit,
61
+ window: merged.window ?? exports.DEFAULT_GCRA.window,
62
+ };
63
+ }
64
+ return {
65
+ ...base,
66
+ algorithm: "sliding-window",
67
+ limit: merged.limit ?? exports.DEFAULT_SLIDING_WINDOW.limit,
68
+ window: merged.window ?? exports.DEFAULT_SLIDING_WINDOW.window,
69
+ };
70
+ }
71
+ function resolveAlgorithmConfig(options = {}, defaults = {}) {
72
+ const resolved = resolveMiddlewareOptions(options, defaults);
73
+ if (resolved.algorithm === "token-bucket") {
74
+ return {
75
+ algorithm: "token-bucket",
76
+ capacity: resolved.capacity,
77
+ refillRate: resolved.refillRate,
78
+ };
79
+ }
80
+ if (resolved.algorithm === "concurrency") {
81
+ return {
82
+ algorithm: "concurrency",
83
+ limit: resolved.limit,
84
+ ttl: resolved.ttl ?? exports.DEFAULT_CONCURRENCY.ttl,
85
+ };
86
+ }
87
+ if (resolved.algorithm === "gcra") {
88
+ return {
89
+ algorithm: "gcra",
90
+ limit: resolved.limit,
91
+ window: resolved.window,
92
+ };
93
+ }
94
+ return {
95
+ algorithm: "sliding-window",
96
+ limit: resolved.limit,
97
+ window: resolved.window,
98
+ };
99
+ }
100
+ //# sourceMappingURL=defaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/utils/defaults.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { RedisLimit } from "../limiter";
2
+ import type { ConcurrencyConfig, MiddlewareOptions, RateLimitResult, RateLimitStrategy } from "../types";
3
+ export declare function isConcurrencyAlgorithm(options: MiddlewareOptions): options is MiddlewareOptions & ConcurrencyConfig;
4
+ export type LimitRequestOutcome = {
5
+ status: "allowed";
6
+ result: RateLimitResult;
7
+ slotId?: string;
8
+ } | {
9
+ status: "blocked";
10
+ result: RateLimitResult;
11
+ } | {
12
+ status: "error";
13
+ failOpen: boolean;
14
+ error: unknown;
15
+ };
16
+ export declare function processLimitRequest(params: {
17
+ limiter: RedisLimit;
18
+ strategy: RateLimitStrategy;
19
+ key: string;
20
+ options: MiddlewareOptions;
21
+ failOpen: boolean;
22
+ context?: unknown;
23
+ }): Promise<LimitRequestOutcome>;
24
+ type ReleaseEmitter = {
25
+ on?(event: "finish" | "close", listener: () => void): void;
26
+ addListener?(event: "finish" | "close", listener: () => void): void;
27
+ };
28
+ export declare function bindConcurrencyRelease(params: {
29
+ strategy: RateLimitStrategy;
30
+ key: string;
31
+ slotId: string;
32
+ emitter: ReleaseEmitter;
33
+ }): void;
34
+ export declare function releaseConcurrencySlot(params: {
35
+ strategy: RateLimitStrategy;
36
+ key: string;
37
+ slotId: string;
38
+ }): Promise<void>;
39
+ export {};
40
+ //# sourceMappingURL=limit-execution.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limit-execution.d.ts","sourceRoot":"","sources":["../../src/utils/limit-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAGlB,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,IAAI,iBAAiB,GAAG,iBAAiB,CAElD;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3D,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyB/B;AAED,KAAK,cAAc,GAAG;IACpB,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,WAAW,CAAC,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACrE,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,IAAI,CAcP;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB"}
@@ -0,0 +1,50 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isConcurrencyAlgorithm = isConcurrencyAlgorithm;
4
+ exports.processLimitRequest = processLimitRequest;
5
+ exports.bindConcurrencyRelease = bindConcurrencyRelease;
6
+ exports.releaseConcurrencySlot = releaseConcurrencySlot;
7
+ const metrics_1 = require("./metrics");
8
+ function isConcurrencyAlgorithm(options) {
9
+ return options.algorithm === "concurrency";
10
+ }
11
+ async function processLimitRequest(params) {
12
+ const { limiter, strategy, key, options, failOpen, context } = params;
13
+ const outcome = await (0, metrics_1.consumeRateLimit)({
14
+ strategy,
15
+ key,
16
+ options,
17
+ failOpen,
18
+ storeType: limiter.getStoreType(),
19
+ context,
20
+ });
21
+ if (outcome.status === "error") {
22
+ return { status: "error", failOpen, error: outcome.error };
23
+ }
24
+ const result = outcome.result;
25
+ if (!result.allowed) {
26
+ return { status: "blocked", result };
27
+ }
28
+ return {
29
+ status: "allowed",
30
+ result,
31
+ slotId: result.slotId,
32
+ };
33
+ }
34
+ function bindConcurrencyRelease(params) {
35
+ let released = false;
36
+ const release = () => {
37
+ if (released) {
38
+ return;
39
+ }
40
+ released = true;
41
+ void params.strategy.release?.(params.key, params.slotId);
42
+ };
43
+ const attach = params.emitter.on ?? params.emitter.addListener;
44
+ attach?.call(params.emitter, "finish", release);
45
+ attach?.call(params.emitter, "close", release);
46
+ }
47
+ async function releaseConcurrencySlot(params) {
48
+ await params.strategy.release?.(params.key, params.slotId);
49
+ }
50
+ //# sourceMappingURL=limit-execution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limit-execution.js","sourceRoot":"","sources":["../../src/utils/limit-execution.ts"],"names":[],"mappings":";;AASA,wDAIC;AAOD,kDAgCC;AAOD,wDAmBC;AAED,wDAMC;AA/ED,uCAA6C;AAE7C,SAAgB,sBAAsB,CACpC,OAA0B;IAE1B,OAAO,OAAO,CAAC,SAAS,KAAK,aAAa,CAAC;AAC7C,CAAC;AAOM,KAAK,UAAU,mBAAmB,CAAC,MAOzC;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAgB,EAAC;QACrC,QAAQ;QACR,GAAG;QACH,OAAO;QACP,QAAQ;QACR,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE;QACjC,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAOD,SAAgB,sBAAsB,CAAC,MAKtC;IACC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;IAC/D,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAAC,MAI5C;IACC,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,12 @@
1
+ import type { MemcachedConfig, MemcachedClient } from "../types";
2
+ export declare function createMemcachedClient(config: MemcachedConfig): MemcachedClient;
3
+ export declare function memcachedGet(client: MemcachedClient, key: string): Promise<string | undefined>;
4
+ export declare function memcachedGets(client: MemcachedClient, key: string): Promise<{
5
+ value: string;
6
+ cas: string;
7
+ } | undefined>;
8
+ export declare function memcachedIncr(client: MemcachedClient, key: string, amount?: number): Promise<number>;
9
+ export declare function memcachedDecr(client: MemcachedClient, key: string, amount?: number): Promise<number>;
10
+ export declare function memcachedAdd(client: MemcachedClient, key: string, value: string, ttl: number): Promise<void>;
11
+ export declare function memcachedCas(client: MemcachedClient, key: string, value: string, cas: string, ttl: number): Promise<boolean>;
12
+ //# sourceMappingURL=memcached.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memcached.d.ts","sourceRoot":"","sources":["../../src/utils/memcached.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAU9E;AAWD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAcrD;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,SAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,SAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAclB"}