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.
- package/README.md +471 -22
- package/dist/algorithms/concurrency.d.ts +11 -0
- package/dist/algorithms/concurrency.d.ts.map +1 -0
- package/dist/algorithms/concurrency.js +19 -0
- package/dist/algorithms/concurrency.js.map +1 -0
- package/dist/algorithms/factory.d.ts +3 -2
- package/dist/algorithms/factory.d.ts.map +1 -1
- package/dist/algorithms/factory.js +9 -3
- package/dist/algorithms/factory.js.map +1 -1
- package/dist/algorithms/gcra.d.ts +10 -0
- package/dist/algorithms/gcra.d.ts.map +1 -0
- package/dist/algorithms/gcra.js +15 -0
- package/dist/algorithms/gcra.js.map +1 -0
- package/dist/algorithms/sliding-window.d.ts +4 -4
- package/dist/algorithms/sliding-window.d.ts.map +1 -1
- package/dist/algorithms/sliding-window.js +3 -23
- package/dist/algorithms/sliding-window.js.map +1 -1
- package/dist/algorithms/token-bucket.d.ts +4 -4
- package/dist/algorithms/token-bucket.d.ts.map +1 -1
- package/dist/algorithms/token-bucket.js +3 -20
- package/dist/algorithms/token-bucket.js.map +1 -1
- package/dist/index.d.ts +19 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +46 -1
- package/dist/index.js.map +1 -1
- package/dist/limiter.d.ts +23 -7
- package/dist/limiter.d.ts.map +1 -1
- package/dist/limiter.js +86 -16
- package/dist/limiter.js.map +1 -1
- package/dist/middleware/bun.d.ts +9 -0
- package/dist/middleware/bun.d.ts.map +1 -0
- package/dist/middleware/bun.js +107 -0
- package/dist/middleware/bun.js.map +1 -0
- package/dist/middleware/express.d.ts.map +1 -1
- package/dist/middleware/express.js +30 -14
- package/dist/middleware/express.js.map +1 -1
- package/dist/middleware/fastify.d.ts +3 -3
- package/dist/middleware/fastify.d.ts.map +1 -1
- package/dist/middleware/fastify.js +34 -17
- package/dist/middleware/fastify.js.map +1 -1
- package/dist/middleware/hono.d.ts +5 -0
- package/dist/middleware/hono.d.ts.map +1 -0
- package/dist/middleware/hono.js +71 -0
- package/dist/middleware/hono.js.map +1 -0
- package/dist/middleware/koa.d.ts +5 -0
- package/dist/middleware/koa.d.ts.map +1 -0
- package/dist/middleware/koa.js +65 -0
- package/dist/middleware/koa.js.map +1 -0
- package/dist/middleware/nest.d.ts +14 -0
- package/dist/middleware/nest.d.ts.map +1 -0
- package/dist/middleware/nest.js +112 -0
- package/dist/middleware/nest.js.map +1 -0
- package/dist/observability/index.d.ts +4 -0
- package/dist/observability/index.d.ts.map +1 -0
- package/dist/observability/index.js +10 -0
- package/dist/observability/index.js.map +1 -0
- package/dist/observability/opentelemetry.d.ts +28 -0
- package/dist/observability/opentelemetry.d.ts.map +1 -0
- package/dist/observability/opentelemetry.js +85 -0
- package/dist/observability/opentelemetry.js.map +1 -0
- package/dist/observability/prometheus.d.ts +27 -0
- package/dist/observability/prometheus.d.ts.map +1 -0
- package/dist/observability/prometheus.js +88 -0
- package/dist/observability/prometheus.js.map +1 -0
- package/dist/observability/types.d.ts +9 -0
- package/dist/observability/types.d.ts.map +1 -0
- package/dist/observability/types.js +3 -0
- package/dist/observability/types.js.map +1 -0
- package/dist/prometheus.d.ts +3 -0
- package/dist/prometheus.d.ts.map +1 -0
- package/dist/prometheus.js +9 -0
- package/dist/prometheus.js.map +1 -0
- package/dist/scripts/concurrencyAcquire.lua +34 -0
- package/dist/scripts/concurrencyRelease.lua +9 -0
- package/dist/scripts/gcra.lua +38 -0
- package/dist/stores/factory.d.ts +5 -0
- package/dist/stores/factory.d.ts.map +1 -0
- package/dist/stores/factory.js +40 -0
- package/dist/stores/factory.js.map +1 -0
- package/dist/stores/memcached-store.d.ts +16 -0
- package/dist/stores/memcached-store.d.ts.map +1 -0
- package/dist/stores/memcached-store.js +211 -0
- package/dist/stores/memcached-store.js.map +1 -0
- package/dist/stores/redis-store.d.ts +19 -0
- package/dist/stores/redis-store.d.ts.map +1 -0
- package/dist/stores/redis-store.js +97 -0
- package/dist/stores/redis-store.js.map +1 -0
- package/dist/stores/types.d.ts +11 -0
- package/dist/stores/types.d.ts.map +1 -0
- package/dist/stores/types.js +3 -0
- package/dist/stores/types.js.map +1 -0
- package/dist/types/index.d.ts +94 -5
- package/dist/types/index.d.ts.map +1 -1
- package/dist/utils/defaults.d.ts +8 -0
- package/dist/utils/defaults.d.ts.map +1 -0
- package/dist/utils/defaults.js +100 -0
- package/dist/utils/defaults.js.map +1 -0
- package/dist/utils/limit-execution.d.ts +40 -0
- package/dist/utils/limit-execution.d.ts.map +1 -0
- package/dist/utils/limit-execution.js +50 -0
- package/dist/utils/limit-execution.js.map +1 -0
- package/dist/utils/memcached.d.ts +12 -0
- package/dist/utils/memcached.d.ts.map +1 -0
- package/dist/utils/memcached.js +103 -0
- package/dist/utils/memcached.js.map +1 -0
- package/dist/utils/metrics.d.ts +21 -0
- package/dist/utils/metrics.d.ts.map +1 -0
- package/dist/utils/metrics.js +99 -0
- package/dist/utils/metrics.js.map +1 -0
- package/dist/utils/redis.d.ts +5 -1
- package/dist/utils/redis.d.ts.map +1 -1
- package/dist/utils/redis.js +38 -3
- package/dist/utils/redis.js.map +1 -1
- package/dist/utils/scripts.d.ts +16 -2
- package/dist/utils/scripts.d.ts.map +1 -1
- package/dist/utils/scripts.js +79 -33
- package/dist/utils/scripts.js.map +1 -1
- package/package.json +86 -3
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memcached-store.js","sourceRoot":"","sources":["../../src/stores/memcached-store.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAGpC,0CAA0C;AAC1C,kDAO4B;AAG5B,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAa,cAAc;IAKzB,YAAY,MAAuB,EAAE,SAAiB;QAJ7C,SAAI,GAAG,WAAoB,CAAC;QAKnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,KAAa,EACb,MAAc;QAEd,MAAM,OAAO,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC;QACjD,MAAM,cAAc,GAAG,aAAa,GAAG,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAEjD,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,aAAa,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,GAAG,OAAO,IAAI,cAAc,EAAE,CAAC;QAEnD,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAErE,MAAM,WAAW,GAAG,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,aAAa,GACjB,aAAa,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC;QAEpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QAEjD,IAAI,aAAa,IAAI,KAAK,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC;gBACzD,KAAK;aACN,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,CAAC,EACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,CACvC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,SAAS,EAAE,CAAC;YACZ,KAAK;YACL,UAAU;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,GAAW,EACX,QAAgB,EAChB,UAAkB;QAElB,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAEjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAE5D,IAAI,MAAc,CAAC;YACnB,IAAI,UAAkB,CAAC;YAEvB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,QAAQ,CAAC;gBAClB,UAAU,GAAG,GAAG,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAGvC,CAAC;gBACF,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBACvB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACjC,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;YAC1C,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;YAC3D,UAAU,GAAG,GAAG,CAAC;YAEjB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;gBACrE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;gBAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAA,wBAAY,EAChB,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EACtC,GAAG,CACJ,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAA,wBAAY,EAChB,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EACtC,QAAQ,CAAC,GAAG,EACZ,GAAG,CACJ,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,CAAC;oBACZ,KAAK;oBACL,UAAU;iBACX,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAEvD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;oBACxD,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,KAAK,EAAE,QAAQ;wBACf,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;wBAC7B,KAAK,EACH,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;4BACrB,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC;qBAC9C,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAY,EAChC,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,OAAO,EACP,QAAQ,CAAC,GAAG,EACZ,GAAG,CACJ,CAAC;YAEF,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;oBAC7B,KAAK,EACH,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;wBACrB,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC;iBAC9C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAW,EACX,KAAa,EACb,MAAc;QAEd,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;QACjD,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACpD,MAAM,QAAQ,GAAG,GAAG,GAAG,cAAc,CAAC;YAEtC,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;gBACnB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACnE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;gBAEpC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK;oBACL,SAAS,EAAE,CAAC;oBACZ,KAAK;oBACL,UAAU;iBACX,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,gBAAgB,CAAC;YACrD,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CACxB,CAAC,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,gBAAgB,CAAC,GAAG,gBAAgB,CACtE,CAAC;YACF,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAE/B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;oBACxD,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,KAAK;wBACL,SAAS;wBACT,KAAK;qBACN,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAY,EAChC,IAAI,CAAC,MAAM,EACX,QAAQ,EACR,OAAO,EACP,QAAQ,CAAC,GAAG,EACZ,GAAG,CACJ,CAAC;YAEF,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,KAAK;oBACL,SAAS;oBACT,KAAK;iBACN,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,GAAW,EACX,KAAa,EACb,GAAW;QAEX,MAAM,UAAU,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;QAE5B,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;QAEjD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;YAClB,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK;gBACL,SAAS,EAAE,CAAC;gBACZ,KAAK;gBACL,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;YACrC,KAAK;YACL,MAAM;SACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAW,EAAE,OAAe;QACnD,MAAM,UAAU,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QAEzD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAY,EAChC,IAAI,CAAC,MAAM,EACX,UAAU,EACV,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EACjB,OAAO,CAAC,GAAG,EACX,GAAG,CACJ,CAAC;YAEF,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAxSD,wCAwSC"}
|
|
@@ -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 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stores/types.ts"],"names":[],"mappings":""}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -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
|
|
7
|
+
export type RedisClusterConfig = {
|
|
4
8
|
nodes: {
|
|
5
9
|
host: string;
|
|
6
10
|
port: number;
|
|
7
11
|
}[];
|
|
8
|
-
options?:
|
|
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
|
|
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
|
|
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;
|
|
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"}
|