@edirect/rate-limit-module 1.0.9 → 2.0.1

package/README.md

@@ -1,102 +1,343 @@
 # 📈 Rate Limiting Module
 
-This module provides a flexible **rate-limiting system** where access to operations can be restricted based on dynamic **rule expressions** such as `count_quote > 1`. If the condition evaluates to `true`, access is **blocked**.
+  
+
+This module provides a flexible **rate-limiting system** where access to operations can be restricted based on dynamic **rule expressions** such as `count_quote( ) > 1`. If the condition evaluates to `true`, access is **blocked**.
+
+  
 
 ## ✨ Features
 
+  
+
 - Define rate-limiting rules with custom expressions.
+
 - Dynamically inject context-aware functions for rule evaluation.
+
 - Easily integrate with any resource via a decorator.
+
 - Built with extensibility and modularity in mind.
 
+  
+
 ## 🧱 How It Works
 
-1. You define a rule using a simple expression (e.g., `count_quote > 1`).
+  
+
+1. You define a rule using a simple expression (e.g., `count_quote( ) > 1`).
+
 2. The rule is evaluated in runtime using data injected from the request context.
+
 3. If the expression is true, the action is blocked.
 
+  
+
 ## 🧩 Usage
 
+  
+
 ### 1. Install the Module
 
+  
+
 ```ts
+
 @Module({
-  imports: [
-    RateLimitingModule,
-    RuleEngineModule.forFeatureAsync({
-      useFactory: async (quoteService: QuoteService) => {
-        return await quoteService.countQuote();
-      },
-      inject: [QuoteService],
-    }),
-  ],
+
+imports: [
+
+RateLimitingModule,
+
+RuleEngineModule.forFeatureAsync({
+
+useFactory: async (quoteService:  QuoteService) => {
+
+return  await quoteService.countQuote();
+
+},
+
+inject: [QuoteService],
+
+}),
+
+],
+
 })
-export class YourFeatureModule {}
+
+export  class  YourFeatureModule {}
+
 ```
 
+  
+
 ## 2. Decorate Your Handlers
 
+  
+
 Use the `@RateLimitingRuleMetadata` decorator to attach metadata used during rule evaluation.
 
+  
+
 ```ts
-import { RateLimitingRuleMetadata } from 'path-to-rate-limiting-module';
+
+import { RateLimitingRuleMetadata } from  'path-to-rate-limiting-module';
+
+  
 
 @RateLimitingRuleMetadata({
-  action: 'create_quote',
-  partnerPath: 'partner.partnerId',
-  providerPath: 'provider',
-  productTypePath: 'productType',
+
+action: 'create_quote',
+
+partnerPath: 'partner.partnerId',
+
+providerPath: 'provider',
+
+productTypePath: 'productType',
+
+marketPath: 'market',
+
 })
+
 @Post('quotes')
+
 createQuote(@Body() body: CreateQuoteDto) {
-  return this.quoteService.create(body);
+
+return  this.quoteService.create(body);
+
 }
+
 ```
 
-* `action`: Name of the action to be controlled.
-* `partnerPath`: Path to extract the partner ID from the request context.
-* `providerPath`: Path to extract the provider.
-* `productTypePath`: Path to extract the product type.
+  
+
+*  `action`: Name of the action to be controlled.
+
+*  `partnerPath`: Path to extract the partner ID from the request context.
+
+*  `providerPath`: Path to extract the provider.
+
+*  `productTypePath`: Path to extract the product type.
+
+  
 
 ## 🛠 Rule Engine Integration
 
+  
+
 This module depends on an underlying rule engine to evaluate expressions. You must provide the functions used in expressions through:
 
+  
+
 ```ts
+
 RuleEngineModule.forFeatureAsync({
-  useFactory: async (useCase: RateLimitingInjectFunctionsUseCase) => {
-    return await useCase.getFunctions();
-    // returns an object like { count_quote: async () => number }
-  },
-  inject: [RateLimitingInjectFunctionsUseCase],
+
+useFactory: async (useCase:  RateLimitingInjectFunctionsUseCase) => {
+
+return  await useCase.getFunctions();
+
+// returns an object like { count_quote: async () => number }
+
+},
+
+inject: [RateLimitingInjectFunctionsUseCase],
+
 });
+
 ```
 
+  
+
 ## 🧪 Example Rule
 
+  
 A rule stored in your system might look like:
 
+
 ```json
+
 {
-  "expression": "count_quote > 1",
-  "action": "create_quote"
+	"expression": "count_quote() > 1",
+	"action": "create_quote"
 }
+
 ```
 
+  
+
 If the expression returns `true`, the rate limiter will block further `create_quote` actions for the user based on the context values.
 
+  
+## 🧠 Dynamic Parameter Resolution
+
+When building queries based on request context, it's possible to reference nested values using paths. This system supports:
+
+-   Resolving values using variable placeholders like `:applicant.documents[0].value`.
+    
+-   Interpreting date expressions safely, like `date(-5d)` (5 days ago), without using `eval`.
+
+### Supported Syntax
+```json
+
+{
+  "value": ":applicant.documents[0].value",
+  "label": "applicant.documents.value"
+}
+
+```
+
+Will extract the value from the context:
+
+```json
+{
+  "applicant": {
+    "documents": [
+      { "type": "NIF", "value": "ABCDE" }
+    ]
+  }
+}
+```
+Result: `"ABCDE"`
+
+
+You can also use dynamic dates:
+
+```json
+{
+  "value": "date(-7d)",
+  "label": "createdAt",
+  "op": "gte"
+}
+```
+
+Result: `"2025-07-10T00:00:00.000Z"` (7 days ago)
+
+### Supported Date Units
+
+-   `d`: Days (default)
+    
+-   `M`: Months
+    
+-   `y`: Years
+
+Examples:
+
+-   `date(-5d)` → 5 days ago
+    
+-   `date(-1M)` → 1 month ago
+    
+-   `date(0)` → Today
+
+No dynamic code execution (`eval`, `new Function`) is used — expressions are parsed securely.
+
+## ⚙️ Supported Operators (`op`)
+
+You can optionally define an `op` (operation) field to specify how the value should be interpreted. The system currently supports:
+
+### `gte` — Greater Than or Equal (usually for dates)
+
+```json
+{
+  "value": "date(-7d)",
+  "label": "createdAt",
+  "op": "gte"
+}
+```
+🔍 This means: only include records created after **7 days ago**.
+
+```json
+{
+  "value": {
+    "from": 1,
+    "to": 10
+  },
+  "label": "createdAt",
+  "op": "range"
+}
+```
+🔍 This sets a static date or value range. Can be used for numbers, dates, or custom fields.
+
+### `rangeDate` — Dynamic Date Range
+
+```json
+{
+  "value": {
+    "from": "date(-30d)",
+    "to": "date(0)"
+  },
+  "label": "createdAt",
+  "op": "rangeDate"
+}
+```
+🔍 This automatically resolves both `from` and `to` values as dates. For example, this would generate a date range from **30 days ago** to **now**.
+
+
+## 🧬 DSL Support and MongoDB Integration
+
+This module uses a lightweight **DSL (Domain-Specific Language)** to define rules and filters in a declarative and expressive way.
+
+### What is a DSL?
+
+A **DSL** is a simplified, pseudo-language designed for expressing business logic in a readable and configurable format. In this module, the DSL is used to define:
+
+- Conditional expressions (e.g., `count_quote() > 1`)
+- Filter structures using dynamic context variables and operators (`eq`, `range`, `gte`, etc.)
+
+These DSL expressions are **not executed as raw code**, but safely parsed and evaluated using resolvers and expression evaluators.
+
+---
+
+### DSL to MongoDB Filter Conversion
+
+One powerful feature of this module is the ability to **transform DSL filters into MongoDB-compatible query objects**.
+
+For example, the following DSL input:
+```json
+{
+  createdAt: {
+    $gte: new Date('2025-06-17T00:00:00.000Z'),
+    $lte: new Date('2025-07-17T00:00:00.000Z')
+  }
+}
+```
+This is handled by utility functions like `buildDlsOp`, which map DSL constructs to database query.
+
+### ✅ Benefits of Using DSL
+
+-   **Separation of logic from code:** Business rules can be stored in DB or configs
+    
+-   **Extensibility:** Easy to support new operators or DB backends (e.g., SQL, Elasticsearch)
+    
+-   **Security:** No raw `eval` or dynamic JS execution
+    
+-   **Readability:** DSL is expressive for non-technical stakeholders
+
+By combining DSL definitions with path-based context extraction and safe runtime resolution, this module provides a highly flexible and secure rate-limiting engine ready for dynamic environments.
+
+
 ## 🧰 Requirements
 
+  
 * NestJS
+
 * RuleEngineModule (compatible expression parser/executor)
+
 * Custom service to inject context functions (like `RateLimitingInjectFunctionsUseCase`)
 
+
 ## 📎 Notes
+  
 
 * Rules should be defined and stored externally (e.g., DB, config).
+
 * The context extractor paths must match the structure of your handler inputs (e.g., body, params).
+
 * Ensure `getFunctions()` returns **async functions** that provide the required values for the expression.
 
+  
+
 ## 🧾 License
 
+  
+
 MIT

package/dist/src/guards/rate-limiting.guard.js

@@ -60,30 +60,27 @@ let RateLimitingRuleGuard = RateLimitingRuleGuard_1 = class RateLimitingRuleGuar
             if (!rules || !rules.length)
                 return true;
             for (const rule of rules) {
-                const contextVars = {
-                    ...entity,
-                    ...rule.variables,
-                };
+                const contextVars = resolveVariables(rule.variables, entity);
                 const invalidExpressionMessage = this.ruleService.validateRuleExpression(rule.expression);
                 if (invalidExpressionMessage && invalidExpressionMessage.length) {
-                    throw new common_1.NotAcceptableException(invalidExpressionMessage);
+                    throw new common_1.HttpException(invalidExpressionMessage, common_1.HttpStatus.TOO_MANY_REQUESTS);
                 }
                 const invalidFunctions = this.ruleEngine.validateFunctionsAreValid(rule.expression);
                 if (invalidFunctions && invalidFunctions.length) {
-                    throw new common_1.NotAcceptableException(`these functions are not allowed ${invalidFunctions.join(', ')}`);
+                    throw new common_1.HttpException(`these functions are not allowed ${invalidFunctions.join(', ')}`, common_1.HttpStatus.TOO_MANY_REQUESTS);
                 }
                 if (rule.variablesRequired) {
                     const missingVars = await this.ruleEngine.validateExpressionVariables(rule.expression, contextVars);
                     if (missingVars && missingVars.length) {
                         this.logger.debug(`[RATE LIMITER] rule - ${rule.name} requires theses variables ${JSON.stringify(missingVars)}`);
-                        throw new common_1.NotAcceptableException(`For rate limiting validation these variables are required ${JSON.stringify(missingVars)}`);
+                        throw new common_1.HttpException(`For rate limiting validation these variables are required ${JSON.stringify(missingVars)}`, common_1.HttpStatus.TOO_MANY_REQUESTS);
                     }
                 }
                 const safeContextVars = (0, object_utils_1.withDefaultNull)(contextVars);
                 const notAllowed = await this.ruleEngine.evaluate(rule.expression, safeContextVars);
                 this.logger.debug(`[RATE LIMITER] rule - ${rule.name} reached the limit`);
                 if (notAllowed)
-                    throw new common_1.NotAcceptableException(rule.errorMessage || `Rate Limiting rule reached limit`);
+                    throw new common_1.HttpException(rule.errorMessage || `Rate Limiting rule reached limit`, common_1.HttpStatus.TOO_MANY_REQUESTS);
             }
             return true;
         }
@@ -109,4 +106,66 @@ function getValueFromPathOrRoot(obj, path) {
     }
     return obj?.[path];
 }
+function resolveDateExpr(expr) {
+    const match = expr.match(/^date\(([-\d]+)([dMy])?\)$/);
+    if (!match)
+        return expr;
+    const amount = parseInt(match[1], 10);
+    const unit = match[2] || 'd';
+    const date = new Date();
+    switch (unit) {
+        case 'd':
+            date.setDate(date.getDate() + amount);
+            break;
+        case 'M':
+            date.setMonth(date.getMonth() + amount);
+            break;
+        case 'y':
+            date.setFullYear(date.getFullYear() + amount);
+            break;
+    }
+    return date.toISOString();
+}
+function resolveValue(raw, context) {
+    if (typeof raw === 'string') {
+        if (raw.startsWith(':')) {
+            const path = raw.slice(1);
+            const val = getByPath(context, path);
+            return resolveValue(val, context);
+        }
+        if (raw.startsWith('date(')) {
+            return resolveDateExpr(raw);
+        }
+        return raw;
+    }
+    if (typeof raw === 'object' && raw !== null && raw.from && raw.to) {
+        return {
+            from: resolveValue(raw.from, context),
+            to: resolveValue(raw.to, context)
+        };
+    }
+    return raw;
+}
+function resolveVariables(vars, context) {
+    return {
+        queries: vars.queries.map(q => ({
+            ...q,
+            query: q.query.map(entry => ({
+                ...entry,
+                value: resolveValue(entry.value, context)
+            }))
+        }))
+    };
+}
+function getByPath(obj, path) {
+    if (!path)
+        return undefined;
+    const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
+    return parts.reduce((acc, key) => {
+        if (acc && typeof acc === 'object') {
+            return acc[key];
+        }
+        return undefined;
+    }, obj);
+}
 //# sourceMappingURL=rate-limiting.guard.js.map

package/dist/src/guards/rate-limiting.guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiting.guard.js","sourceRoot":"","sources":["../../../src/guards/rate-limiting.guard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limiting.guard.js","sourceRoot":"","sources":["../../../src/guards/rate-limiting.guard.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,6 +1,8 @@
 export * from './decorators/rate-limiting-rule.decorator';
 export * from './guards/rate-limiting.guard';
 export * from './rate-limiting.module';
+export * from './shared/dsl/dsl.interface';
+export * from './shared/dsl/dsl.service';
 export * from './shared/rule-engine/rule-engine.module';
 export * from './validators/rule.constraint';
 export declare const RULE_ENGINE_INSTANCE = "RULE_ENGINE_INSTANCE";

package/dist/src/index.js

@@ -18,6 +18,8 @@ exports.CUSTOM_RULE_FUNCTIONS = exports.RULE_ENGINE_INSTANCE = void 0;
 __exportStar(require("./decorators/rate-limiting-rule.decorator"), exports);
 __exportStar(require("./guards/rate-limiting.guard"), exports);
 __exportStar(require("./rate-limiting.module"), exports);
+__exportStar(require("./shared/dsl/dsl.interface"), exports);
+__exportStar(require("./shared/dsl/dsl.service"), exports);
 __exportStar(require("./shared/rule-engine/rule-engine.module"), exports);
 __exportStar(require("./validators/rule.constraint"), exports);
 exports.RULE_ENGINE_INSTANCE = 'RULE_ENGINE_INSTANCE';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4EAA0D;AAC1D,+DAA6C;AAC7C,yDAAuC;AACvC,0EAAwD;AACxD,+DAA6C;AAGhC,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAC9C,QAAA,qBAAqB,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4EAA0D;AAC1D,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,2DAAyC;AACzC,0EAAwD;AACxD,+DAA6C;AAEhC,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAC9C,QAAA,qBAAqB,GAAG,uBAAuB,CAAC"}

package/dist/src/shared/dls/dsl.interface.d.ts

@@ -0,0 +1,42 @@
+type Primitive = string | number | boolean | Date;
+interface EqFilter<T = Primitive> {
+    eq: T;
+}
+interface InFilter<T = Primitive> {
+    in: T[];
+}
+interface RangeFilter<T = Date | number> {
+    range: {
+        from?: T;
+        to?: T;
+    };
+}
+interface GteFilter<T = Date | number> {
+    gte: T;
+}
+interface LteFilter<T = Date | number> {
+    lte: T;
+}
+interface ElemMatchFilter {
+    elemMatch: FilterDsl;
+}
+type FieldFilter = EqFilter | InFilter | RangeFilter | ElemMatchFilter | LteFilter | GteFilter;
+export interface FilterDsl {
+    or?: FilterDsl[];
+    [field: string]: FieldFilter | FilterDsl[] | undefined;
+}
+export interface IDlsQuery {
+    fnContext: string;
+    query: IDlsQueryItem[];
+}
+export interface IDlsQueryItem {
+    label: string;
+    value: unknown;
+    op: OperationDlsEnum;
+}
+export declare enum OperationDlsEnum {
+    EQ = "eq",
+    RANGE = "range",
+    GTE = "gte"
+}
+export {};

package/dist/src/shared/dls/dsl.interface.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationDlsEnum = void 0;
+var OperationDlsEnum;
+(function (OperationDlsEnum) {
+    OperationDlsEnum["EQ"] = "eq";
+    OperationDlsEnum["RANGE"] = "range";
+    OperationDlsEnum["GTE"] = "gte";
+})(OperationDlsEnum || (exports.OperationDlsEnum = OperationDlsEnum = {}));
+//# sourceMappingURL=dsl.interface.js.map

package/dist/src/shared/dls/dsl.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.interface.js","sourceRoot":"","sources":["../../../../src/shared/dls/dsl.interface.ts"],"names":[],"mappings":";;;AAsDA,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,6BAAS,CAAA;IACT,mCAAe,CAAA;IACf,+BAAW,CAAA;AACb,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B"}

package/dist/src/shared/dls/dsl.utils.d.ts

@@ -0,0 +1,3 @@
+import { FilterDsl, IDlsQueryItem } from './dsl.interface';
+export declare const buildDlsFilter: (query: IDlsQueryItem[]) => FilterDsl;
+export declare const dslToMongoQuery: (filter: Record<string, any>) => Record<string, any>;

package/dist/src/shared/dls/dsl.utils.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dslToMongoQuery = exports.buildDlsFilter = void 0;
+const dayjs_1 = require("dayjs");
+const buildDlsFilter = (query) => {
+    return query.reduce((acc, cur) => {
+        if (!cur || (!cur.label && !cur.value))
+            return acc;
+        return {
+            ...acc,
+            [cur.label]: buildDlsOp(cur.op, cur.value),
+        };
+    }, {});
+};
+exports.buildDlsFilter = buildDlsFilter;
+const buildDlsOp = (op, value) => {
+    if (op === 'rangeDate') {
+        const data = value;
+        return { range: {
+                from: data.from ||
+                    (0, dayjs_1.default)().subtract(1, 'month').toDate(),
+                to: data.to || new Date(),
+            } };
+    }
+    if (op === 'range') {
+        const data = value;
+        return {
+            range: {
+                from: data.from,
+                to: data.to,
+            }
+        };
+    }
+    return { [op || 'eq']: value };
+};
+const dslToMongoQuery = (filter) => {
+    const query = {};
+    for (const key in filter) {
+        const condition = filter[key];
+        if (key === 'or') {
+            query['$or'] = condition.map((subCond) => (0, exports.dslToMongoQuery)(subCond));
+            continue;
+        }
+        if (condition.eq !== undefined) {
+            query[key] = condition.eq;
+        }
+        if (condition.in) {
+            query[key] = { $in: condition.in };
+        }
+        if (condition.range) {
+            query[key] = {};
+            if (condition.range.from)
+                query[key]['$gte'] = condition.range.from;
+            if (condition.range.to)
+                query[key]['$lte'] = condition.range.to;
+        }
+        if (condition.gte) {
+            query[key] = {};
+            query[key]['$gte'] = condition.gte;
+        }
+        if (condition.lte) {
+            query[key]['$lte'] = condition.lte;
+        }
+        if (condition.elemMatch) {
+            query[key] = {
+                $elemMatch: (0, exports.dslToMongoQuery)(condition.elemMatch),
+            };
+        }
+    }
+    return query;
+};
+exports.dslToMongoQuery = dslToMongoQuery;
+//# sourceMappingURL=dsl.utils.js.map

package/dist/src/shared/dls/dsl.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.utils.js","sourceRoot":"","sources":["../../../../src/shared/dls/dsl.utils.ts"],"names":[],"mappings":"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"}