klaim 1.8.87 → 1.9.1

package/README.md

@@ -6,19 +6,20 @@
 - [Next features](#-next-features)
 - [Installation](#-installation)
 - [Usage](#-usage)
-    - [Basic API Configuration](#basic-api-configuration)
-    - [Route Definition](#route-definition)
-    - [Request Handling](#request-handling)
-    - [Groups](#groups)
-        - [API Groups](#api-groups)
-        - [Route Groups](#route-groups)
-        - [Nested Groups](#nested-groups)
-        - [Group Configuration](#group-configuration)
-    - [Middleware Usage](#middleware-usage)
-    - [Hook Subscription](#hook-subscription)
-    - [Caching Requests](#caching-requests)
-    - [Retry Mechanism](#retry-mechanism)
-    - [Response Validation](#response-validation)
+  - [Basic API Configuration](#basic-api-configuration)
+  - [Route Definition](#route-definition)
+  - [Request Handling](#request-handling)
+  - [Groups](#groups)
+    - [API Groups](#api-groups)
+    - [Route Groups](#route-groups)
+    - [Nested Groups](#nested-groups)
+    - [Group Configuration](#group-configuration)
+  - [Middleware Usage](#middleware-usage)
+  - [Hook Subscription](#hook-subscription)
+  - [Caching Requests](#caching-requests)
+  - [Retry Mechanism](#retry-mechanism)
+  - [Rate Limiting](#rate-limiting)
+  - [Response Validation](#response-validation)
 - [Links](#-links)
 - [Contributing](#-contributing)
 - [License](#-license)
@@ -35,13 +36,13 @@
 - **Hook System**: Subscribe to hooks to monitor and react to specific events.
 - **Caching**: Enable caching on requests to reduce network load and improve performance.
 - **Retry Mechanism**: Automatically retry failed requests to enhance reliability.
+- **Rate Limiting**: Control the frequency of API calls to prevent abuse and respect API provider limits.
 - **TypeScript Support**: Fully typed for enhanced code quality and developer experience.
 - **Response Validation**: Validate responses using schemas for increased reliability and consistency.
 - **Pagination**: Handle paginated requests easily with support for both page and offset based pagination.
 
 ## ⌛ Next features
 
-- Rate Limiting (Version: 1.9)
 - Login (Version: 1.10)
 - Time Out (Version: 1.11)
 - Error Handling (Version: 1.12)
@@ -73,18 +74,18 @@ import {Api, Route} from 'klaim';
 
 // Your simple Todo type
 type Todo = {
-	userId: number;
-	id: number;
-	title: string;
-	completed: boolean;
+    userId: number;
+    id: number;
+    title: string;
+    completed: boolean;
 };
 
 // Create a new API with the name "hello" and the base URL "https://jsonplaceholder.typicode.com/"
 Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Define routes for the API
-	Route.get<Todo[]>("listTodos", "todos");
-	Route.get<Todo>("getTodo", "todos/[id]");
-	Route.post<Todo>("addTodo", "todos");
+    // Define routes for the API
+    Route.get<Todo[]>("listTodos", "todos");
+    Route.get<Todo>("getTodo", "todos/[id]");
+    Route.post<Todo>("addTodo", "todos");
 });
 ```
 
@@ -95,28 +96,28 @@ custom configurations:
 
 ```typescript
 Api.create("api", "https://api.example.com", () => {
-	// Basic GET route
-	Route.get("listUsers", "/users");
+    // Basic GET route
+    Route.get("listUsers", "/users");
 
-	// GET route with URL parameter
-	Route.get("getUser", "/users/[id]");
+    // GET route with URL parameter
+    Route.get("getUser", "/users/[id]");
 
-	// POST route with custom headers and body
-	Route.post("createUser", "/users", {
-		"Content-Type": "application/json"
-	}, {userId: 1, name: "John Doe"});
+    // POST route with custom headers and body
+    Route.post("createUser", "/users", {
+        "Content-Type": "application/json"
+    }, {userId: 1, name: "John Doe"});
 
-	// PUT route with parameter
-	Route.put("updateUser", "/users/[id]");
+    // PUT route with parameter
+    Route.put("updateUser", "/users/[id]");
 
-	// DELETE route
-	Route.delete("deleteUser", "/users/[id]");
+    // DELETE route
+    Route.delete("deleteUser", "/users/[id]");
 
-	// PATCH route
-	Route.patch("updateUserStatus", "/users/[id]/status");
+    // PATCH route
+    Route.patch("updateUserStatus", "/users/[id]/status");
 
-	// OPTIONS route
-	Route.options("userOptions", "/users");
+    // OPTIONS route
+    Route.options("userOptions", "/users");
 });
 ```
 
@@ -134,17 +135,17 @@ import {Group, Api, Route} from 'klaim';
 
 // Create a group for user-related services
 Group.create("userServices", () => {
-	// Authentication API
-	Api.create("auth", "https://auth.example.com", () => {
-		Route.post("login", "/login");
-		Route.post("register", "/register");
-	});
-
-	// User Management API
-	Api.create("users", "https://users.example.com", () => {
-		Route.get("list", "/users");
-		Route.get("getOne", "/users/[id]");
-	});
+    // Authentication API
+    Api.create("auth", "https://auth.example.com", () => {
+        Route.post("login", "/login");
+        Route.post("register", "/register");
+    });
+
+    // User Management API
+    Api.create("users", "https://users.example.com", () => {
+        Route.get("list", "/users");
+        Route.get("getOne", "/users/[id]");
+    });
 }).withRetry(3); // Apply retry mechanism to all APIs in the group
 
 // Access grouped APIs
@@ -158,18 +159,18 @@ Organize routes within an API into logical groups:
 
 ```typescript
 Api.create("hello", "https://api.example.com/", () => {
-	// Group user-related routes
-	Group.create("users", () => {
-		Route.get<User[]>("list", "/users");
-		Route.get<User>("getOne", "/users/[id]");
-		Route.post<User>("create", "/users");
-	}).withCache(60);  // Cache all user routes for 60 seconds
-
-	// Group product-related routes
-	Group.create("products", () => {
-		Route.get("list", "/products");
-		Route.get("getOne", "/products/[id]");
-	});
+    // Group user-related routes
+    Group.create("users", () => {
+        Route.get<User[]>("list", "/users");
+        Route.get<User>("getOne", "/users/[id]");
+        Route.post<User>("create", "/users");
+    }).withCache(60);  // Cache all user routes for 60 seconds
+
+    // Group product-related routes
+    Group.create("products", () => {
+        Route.get("list", "/products");
+        Route.get("getOne", "/products/[id]");
+    });
 });
 
 // Use grouped routes
@@ -183,27 +184,27 @@ Create complex hierarchies with nested groups:
 
 ```typescript
 Group.create("services", () => {
-	// Internal services group
-	Group.create("internal", () => {
-		Api.create("logs", "https://logs.internal.example.com", () => {
-			Route.post("write", "/logs");
-		});
-
-		Api.create("metrics", "https://metrics.internal.example.com", () => {
-			Route.post("track", "/metrics");
-		});
-	}).withRetry(5);  // More retries for internal services
-
-	// External services group
-	Group.create("external", () => {
-		Api.create("weather", "https://api.weather.com", () => {
-			Route.get("forecast", "/forecast/[city]");
-		});
-
-		Api.create("geocoding", "https://api.geocoding.com", () => {
-			Route.get("search", "/search/[query]");
-		});
-	}).withCache(300);  // Cache external services longer
+    // Internal services group
+    Group.create("internal", () => {
+        Api.create("logs", "https://logs.internal.example.com", () => {
+            Route.post("write", "/logs");
+        });
+
+        Api.create("metrics", "https://metrics.internal.example.com", () => {
+            Route.post("track", "/metrics");
+        });
+    }).withRetry(5);  // More retries for internal services
+
+    // External services group
+    Group.create("external", () => {
+        Api.create("weather", "https://api.weather.com", () => {
+            Route.get("forecast", "/forecast/[city]");
+        });
+
+        Api.create("geocoding", "https://api.geocoding.com", () => {
+            Route.get("search", "/search/[query]");
+        });
+    }).withCache(300);  // Cache external services longer
 });
 
 // Access nested groups
@@ -217,22 +218,22 @@ Groups can share configuration among all their members:
 
 ```typescript
 Group.create("apis", () => {
-	Api.create("service1", "https://api1.example.com", () => {
-		Route.get("test", "/test");
-	});
+    Api.create("service1", "https://api1.example.com", () => {
+        Route.get("test", "/test");
+    });
 
-	Api.create("service2", "https://api2.example.com", () => {
-		Route.get("test", "/test");
-	});
+    Api.create("service2", "https://api2.example.com", () => {
+        Route.get("test", "/test");
+    });
 })
-	.withCache(60)  // Enable caching for all APIs
-	.withRetry(3)   // Enable retries for all APIs
-	.before(({config}) => {  // Add authentication for all APIs
-		config.headers.Authorization = `Bearer ${getToken()}`;
-	})
-	.after(({data}) => {  // Process all responses
-		logResponse(data);
-	});
+    .withCache(60)  // Enable caching for all APIs
+    .withRetry(3)   // Enable retries for all APIs
+    .before(({config}) => {  // Add authentication for all APIs
+        config.headers.Authorization = `Bearer ${getToken()}`;
+    })
+    .after(({data}) => {  // Process all responses
+        logResponse(data);
+    });
 ```
 
 ### Request Handling
@@ -260,16 +261,16 @@ and `after` middleware to process responses:
 
 ```typescript
 Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// With before middleware
-	Route.get<Todo>("getRandomTodo", "todos")
-		.before(({url}) => {
-			const random = Math.floor(Math.random() * 10) + 1;
-			return {url: `${url}/${random}`};
-		});
-
-	// With after middleware
-	Route.get<Todo>("getFirstTodo", "todos")
-		.after(({data: [first]}) => ({data: first}));
+    // With before middleware
+    Route.get<Todo>("getRandomTodo", "todos")
+        .before(({url}) => {
+            const random = Math.floor(Math.random() * 10) + 1;
+            return {url: `${url}/${random}`};
+        });
+
+    // With after middleware
+    Route.get<Todo>("getFirstTodo", "todos")
+        .after(({data: [first]}) => ({data: first}));
 });
 ```
 
@@ -283,7 +284,7 @@ import {Hook} from 'klaim';
 
 // Subscribe to the "hello.getFirstTodo" hook
 Hook.subscribe("hello.getFirstTodo", ({url}) => {
-	console.log(`Requesting ${url}`);
+    console.log(`Requesting ${url}`);
 });
 ```
 
@@ -298,14 +299,14 @@ You can enable caching on individual routes:
 
 ```typescript
 Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Get a list of todos with default cache duration (20 seconds)
-	Route.get<Todo[]>("listTodos", "todos").withCache();
+    // Get a list of todos with default cache duration (20 seconds)
+    Route.get<Todo[]>("listTodos", "todos").withCache();
 
-	// Get a specific todo by id with custom cache duration (300 seconds)
-	Route.get<Todo>("getTodo", "todos/[id]").withCache(300);
+    // Get a specific todo by id with custom cache duration (300 seconds)
+    Route.get<Todo>("getTodo", "todos/[id]").withCache(300);
 
-	// Add a new todo (no cache)
-	Route.post<Todo>("addTodo", "todos");
+    // Add a new todo (no cache)
+    Route.post<Todo>("addTodo", "todos");
 });
 ```
 
@@ -317,49 +318,58 @@ You can also enable caching for all routes defined within an API:
 
 ```typescript
 Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Define routes for the API
-	Route.get<Todo[]>("listTodos", "todos");
-	Route.get<Todo>("getTodo", "todos/[id]");
-	Route.post<Todo>("addTodo", "todos");
+    // Define routes for the API
+    Route.get<Todo[]>("listTodos", "todos");
+    Route.get<Todo>("getTodo", "todos/[id]");
+    Route.post<Todo>("addTodo", "todos");
 }).withCache(); // Enable default cache duration (20 seconds) for all routes
 ```
 
 ### Retry Mechanism
 
-Automatically retry failed requests to enhance reliability. You can specify the number of retry attempts for individual
-routes or for the entire API.
-
-#### Retry on Individual Routes
-
-Enable retry on individual routes:
+Configure automatic retries for failed requests:
 
 ```typescript
-Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Get a list of todos with retry mechanism (default: 2)
-	Route.get<Todo[]>("listTodos", "todos").withRetry();
-
-	// Get a specific todo by id with retry mechanism (specified to 5)
-	Route.get<Todo>("getTodo", "todos/[id]").withRetry(5);
+// Apply retry at the API level
+Api.create("api", "https://api.example.com", () => {
+    Route.get("users", "/users");
+}).withRetry(3);  // Will retry failed requests up to 3 times
 
-	// Add a new todo (no retry)
-	Route.post<Todo>("addTodo", "todos");
+// Apply retry at the route level
+Api.create("api", "https://api.example.com", () => {
+    Route.get("unstableRoute", "/unstable-endpoint").withRetry(5);  // Will retry up to 5 times
 });
 ```
 
-#### Retry the Entire API
+### Rate Limiting
 
-Enable retry for all routes defined within an API:
+Control the frequency of API calls to prevent abuse and respect API provider rate limits:
 
 ```typescript
-Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Define routes for the API
-	Route.get<Todo[]>("listTodos", "todos");
-	Route.get<Todo>("getTodo", "todos/[id]");
-	Route.post<Todo>("addTodo", "todos");
-}).withRetry();
-```
+// Apply rate limiting at the API level
+Api.create("api", "https://api.example.com", () => {
+    Route.get("users", "/users");
+    Route.get("posts", "/posts");
+}).withRate({ limit: 5, duration: 10 });  // Max 5 requests every 10 seconds for this API
+
+// Apply rate limiting at the route level
+Api.create("api", "https://api.example.com", () => {
+    // This route has its own stricter limits
+    Route.get("expensive", "/expensive-operation").withRate({ limit: 2, duration: 60 });  // Max 2 requests per minute
+    
+    // This route uses the default limits (5 per 10 seconds if not specified)
+    Route.get("normal", "/normal-operation").withRate();
+});
 
-Now, when a request fails, it will be retried the specified number of times before ultimately failing.
+// Handling rate limit errors
+try {
+    await Klaim.api.expensive();
+} catch (error) {
+    if (error.message.includes('Rate limit exceeded')) {
+        console.log('Please wait before trying again');
+    }
+}
+```
 
 ### Response Validation
 
@@ -378,15 +388,15 @@ import * as yup from 'yup';
 
 // Define the schema using Yup
 const todoSchema = yup.object().shape({
-	userId: yup.number().required(),
-	id: yup.number().min(1).max(10).required(),
-	title: yup.string().required(),
-	completed: yup.boolean().required()
+    userId: yup.number().required(),
+    id: yup.number().min(1).max(10).required(),
+    title: yup.string().required(),
+    completed: yup.boolean().required()
 });
 
 Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
-	// Get a specific todo by id with validation
-	Route.get<Todo>("getTodo", "todos/[id]").validate(todoSchema);
+    // Get a specific todo by id with validation
+    Route.get<Todo>("getTodo", "todos/[id]").validate(todoSchema);
 });
 
 // This request will fail because the id is out of range
@@ -403,12 +413,12 @@ Configure pagination for routes that require it:
 ```typescript
 // Basic usage with custom limit and offset parameter
 Api.create("api", "https://api.example.com", () => {
-	Route.get("list", "/items").withPagination({
-		limit: 20,          // Items per page
-		page: 1,            // Default page number
-		pageParam: "offset", // Parameter name for page/offset or any other custom parameter
-		limitParam: "limit"  // Parameter name for limit
-	}); // All options are optional
+    Route.get("list", "/items").withPagination({
+        limit: 20,          // Items per page
+        page: 1,            // Default page number
+        pageParam: "offset", // Parameter name for page/offset or any other custom parameter
+        limitParam: "limit"  // Parameter name for limit
+    }); // All options are optional
 });
 
 // Using paginated endpoints

package/deno.json

@@ -1,6 +1,6 @@
 {
     "name": "@antharuu/klaim",
-    "version": "1.8.87",
+    "version": "1.9.1",
     "description": "Klaim is a lightweight TypeScript library designed to manage APIs and record requests, optimized for an optimal user experience.",
     "repository": {
         "type": "git",

package/dist/klaim.cjs

@@ -1 +1 @@
-"use strict";var O=Object.defineProperty;var U=(n,t,e)=>t in n?O(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var o=(n,t,e)=>U(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function E(n){return n.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function D(n){return n.trim().replace(/^\/|\/$/g,"")}const j={page:1,pageParam:"page",limit:10,limitParam:"limit"};class ${constructor(t,e,a,r={}){o(this,"type");o(this,"name");o(this,"url");o(this,"headers");o(this,"parent");o(this,"method");o(this,"arguments",new Set);o(this,"schema");o(this,"pagination");o(this,"callbacks",{before:null,after:null,call:null});o(this,"cache",!1);o(this,"retry",!1);o(this,"withCache",(t=20)=>(this.cache=t,this));o(this,"withRetry",(t=2)=>(this.retry=t,this));this.type=t,this.name=E(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=D(a),this.headers=r||{}}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}onCall(t){return this.callbacks.call=t,this}withPagination(t={}){return this.pagination={...j,...t},this}}const p=class p{constructor(){o(this,"cache");this.cache=new Map}static get i(){return p._instance||(p._instance=new p),p._instance}set(t,e,a=0){const r=Date.now()+a;this.cache.set(t,{data:e,expiry:r})}has(t){const e=this.cache.get(t);return e?Date.now()>e.expiry?(this.cache.delete(t),!1):!0:!1}get(t){return this.has(t)?this.cache.get(t).data:null}};o(p,"_instance");let d=p;function x(n){let a=2166136261;for(let i=0;i<n.length;i++)a^=n.charCodeAt(i),a*=16777619;let r=(a>>>0).toString(16).padStart(8,"0");for(;r.length<32;)a^=r.charCodeAt(r.length%r.length),a*=16777619,r+=(a>>>0).toString(16).padStart(8,"0");return r.substring(0,32)}async function H(n,t,e){const a=`${n.toString()}${JSON.stringify(t)}`,r=x(a);if(d.i.has(r))return d.i.get(r);const c=await(await fetch(n,t)).json();return d.i.set(r,c,e),c}class A{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o(A,"_callbacks",new Map);const C={};function I(n,t){return async(...e)=>{if(t.pagination){const[i=0,c={},l={}]=e;return F(n,t,i,c,l)}const[a={},r={}]=e;return F(n,t,void 0,a,r)}}async function F(n,t,e,a={},r={}){const i=n.split(".");let c;for(let g=0;g<i.length;g++){const y=i[g];if(c=s.i.getApi(y),c)break}if(!t||!c||t.type!=="route"||c.type!=="api")throw new Error(`Invalid path: ${n}.${t.name}`);let l=W(`${c.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:g="page",limit:y=10,limitParam:K="limit"}=t.pagination,b=new URLSearchParams;b.append(g,String(e)),b.append(K,String(y));const G=l.includes("?")?"&":"?";l=`${l}${G}${b.toString()}`}let u={};r&&t.method!=="GET"&&(u.body=JSON.stringify(r)),u.headers={"Content-Type":"application/json",...c.headers,...t.headers},u.method=t.method;const{beforeRoute:f,beforeApi:P,beforeUrl:m,beforeConfig:v}=J({route:t,api:c,url:l,config:u});l=m,u=v,s.updateElement(P),s.updateElement(f);let w=await M(c,t,l,u);t.schema&&"validate"in t.schema&&(w=await t.schema.validate(w));const{afterRoute:T,afterApi:N,afterData:R}=z({route:t,api:c,response:w,data:w});return s.updateElement(N),s.updateElement(T),A.run(`${c.name}.${t.name}`),R}async function L(n,t,e,a){return n?await H(t,e,a.cache):await(await fetch(t,e)).json()}async function M(n,t,e,a){var f,P;const r=n.cache||t.cache,i=t.retry||n.retry||0;let c,l=!1,u=0;for(;u<=i&&!l;)try{(f=t.callbacks)!=null&&f.call?t.callbacks.call({}):(P=n.callbacks)!=null&&P.call&&n.callbacks.call({}),c=await L(!!r,e,a,n),l=!0}catch(m){if(u++,u>i)throw m.message=`Failed to fetch ${e} after ${i} attempts`,m}return c}function W(n,t,e){let a=n;return t.arguments.forEach(r=>{if(e[r]===void 0)throw new Error(`Argument ${r} is missing`);a=a.replace(`[${r}]`,e[r])}),a}function J({route:n,api:t,url:e,config:a}){var i,c;const r=(c=(i=n.callbacks).before)==null?void 0:c.call(i,{route:n,api:t,url:e,config:a});return{beforeRoute:(r==null?void 0:r.route)||n,beforeApi:(r==null?void 0:r.api)||t,beforeUrl:(r==null?void 0:r.url)||e,beforeConfig:(r==null?void 0:r.config)||a}}function z({route:n,api:t,response:e,data:a}){var i,c;const r=(c=(i=n.callbacks).after)==null?void 0:c.call(i,{route:n,api:t,response:e,data:a});return{afterRoute:(r==null?void 0:r.route)||n,afterApi:(r==null?void 0:r.api)||t,afterResponse:(r==null?void 0:r.response)||e,afterData:(r==null?void 0:r.data)||a}}const h=class h{constructor(){o(this,"_elements",new Map);o(this,"_currentParent",null)}static get i(){return h._instance||(h._instance=new h),h._instance}registerElement(t){const e=this._currentParent;e&&(t.parent=this.getFullPath(e));const a=this.getElementKey(t);if(this._elements.set(a,t),t.type==="api"||t.type==="group"){let r=C;if(e){const i=this.getFullPath(e).split(".");for(const c of i)r[c]||(r[c]={}),r=r[c]}r[t.name]||(r[t.name]={})}}getCurrentParent(){return this._currentParent}setCurrentParent(t){const e=this._elements.get(t);if(!e||e.type!=="api"&&e.type!=="group")throw new Error(`Element ${t} not found or not a valid parent type`);this._currentParent=e}clearCurrentParent(){this._currentParent=null}registerRoute(t){if(!this._currentParent)throw new Error("No current parent set, use Route only inside Api or Group create callback");t.parent=this.getFullPath(this._currentParent);const e=this.getElementKey(t);this._elements.set(e,t),this.addToKlaimRoute(t)}addToKlaimRoute(t){if(!t.parent)return;let e=C;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=I(t.parent,t)}getElementKey(t){return t?t.parent?`${t.parent}.${t.name}`:t.name:""}getFullPath(t){if(!t)return"";if(!t.parent)return t.name;const e=[t.name];let a=t;for(;a.parent;){const r=this._elements.get(a.parent);if(!r)break;e.unshift(r.name),a=r}return e.join(".")}getRoute(t,e){return this._elements.get(`${t}.${e}`)}getChildren(t){const e=[];return this._elements.forEach(a=>{a.parent===t&&e.push(a)}),e}static updateElement(t){return h.i._elements.get(h.i.getElementKey(t))||t}getApi(t){const e=this._elements.get(t);if(!e){for(const[a,r]of this._elements.entries())if(r.type==="api"&&a.endsWith(`.${t}`))return r;return}return e.type==="api"?e:this.findApi(e)}findApi(t){if(!t||!t.parent)return;const e=t.parent.split(".");for(let a=e.length;a>=0;a--){const r=e.slice(0,a).join("."),i=this._elements.get(r);if((i==null?void 0:i.type)==="api")return i}}};o(h,"_instance");let s=h;class k extends ${static create(t,e,a,r={}){const i=E(t);i!==t&&console.warn(`API name "${t}" has been camelCased to "${i}"`);const c=new k(i,e,r),l=s.i.getCurrentParent();s.i.registerElement(c);const u=l?s.i.getFullPath(l):"",f=u?`${u}.${i}`:i;return s.i.setCurrentParent(f),a(),l?s.i.setCurrentParent(s.i.getFullPath(l)):s.i.clearCurrentParent(),c}constructor(t,e,a={}){super("api",t,e,a)}}class S extends ${static create(t,e){const a=E(t),r=s.i.getCurrentParent(),i=r?s.i.getFullPath(r):"",c=i?`${i}.${a}`:a,l=new S(a,"");a!==t&&console.warn(`Group name "${t}" has been camelCased to "${a}"`),s.i.registerElement(l);const u=s.i.getCurrentParent();return s.i.setCurrentParent(c),e(),u?s.i.setCurrentParent(s.i.getFullPath(u)):s.i.clearCurrentParent(),l}constructor(t,e,a={}){super("group",t,e,a)}withCache(t=20){return super.withCache(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.cache||(e.cache=t)}),this}withRetry(t=2){return super.withRetry(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.retry||(e.retry=t)}),this}before(t){return super.before(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.before||(e.callbacks.before=t)}),this}after(t){return super.after(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.after||(e.callbacks.after=t)}),this}onCall(t){return super.onCall(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.call||(e.callbacks.call=t)}),this}}class _ extends ${constructor(t,e,a={},r="GET"){super("route",t,e,a),this.method=r,this.detectArguments()}static createRoute(t,e,a={},r){const i=new _(t,e,a,r);return s.i.registerRoute(i),i}static get(t,e,a={}){return this.createRoute(t,e,a,"GET")}static post(t,e,a={}){return this.createRoute(t,e,a,"POST")}static put(t,e,a={}){return this.createRoute(t,e,a,"PUT")}static delete(t,e,a={}){return this.createRoute(t,e,a,"DELETE")}static patch(t,e,a={}){return this.createRoute(t,e,a,"PATCH")}static options(t,e,a={}){return this.createRoute(t,e,a,"OPTIONS")}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const a=e.replace("[","").replace("]","");this.arguments.add(a)})}validate(t){return this.schema=t,this}}exports.Api=k;exports.Group=S;exports.Hook=A;exports.Klaim=C;exports.Registry=s;exports.Route=_;
+"use strict";var L=Object.defineProperty;var G=(n,t,e)=>t in n?L(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var o=(n,t,e)=>G(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function T(n){return n.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function M(n){return n.trim().replace(/^\/|\/$/g,"")}const O={limit:5,duration:10},$=new Map;function v(n,t){const e=Date.now(),a=t.duration*1e3;let r=$.get(n);r||(r={timestamps:[]},$.set(n,r));const i=r.timestamps.filter(s=>e-s<a);return i.length>=t.limit?!1:(i.push(e),r.timestamps=i,!0)}function N(n,t){const e=$.get(n);if(!e||e.timestamps.length<t.limit)return 0;const a=Date.now(),r=t.duration*1e3,l=[...e.timestamps].sort((u,f)=>u-f)[0]+r-a;return Math.max(0,l)}const j={page:1,pageParam:"page",limit:10,limitParam:"limit"};class k{constructor(t,e,a,r={}){o(this,"type");o(this,"name");o(this,"url");o(this,"headers");o(this,"parent");o(this,"method");o(this,"arguments",new Set);o(this,"schema");o(this,"pagination");o(this,"callbacks",{before:null,after:null,call:null});o(this,"cache",!1);o(this,"retry",!1);o(this,"rate",!1);o(this,"withCache",(t=20)=>(this.cache=t,this));o(this,"withRetry",(t=2)=>(this.retry=t,this));o(this,"withRate",(t={})=>(this.rate={...O,...t},this));this.type=t,this.name=T(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=M(a),this.headers=r||{}}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}onCall(t){return this.callbacks.call=t,this}withPagination(t={}){return this.pagination={...j,...t},this}}const d=class d{constructor(){o(this,"cache");this.cache=new Map}static get i(){return d._instance||(d._instance=new d),d._instance}set(t,e,a=0){const r=Date.now()+a;this.cache.set(t,{data:e,expiry:r})}has(t){const e=this.cache.get(t);return e?Date.now()>e.expiry?(this.cache.delete(t),!1):!0:!1}get(t){return this.has(t)?this.cache.get(t).data:null}};o(d,"_instance");let P=d;function H(n){let a=2166136261;for(let i=0;i<n.length;i++)a^=n.charCodeAt(i),a*=16777619;let r=(a>>>0).toString(16).padStart(8,"0");for(;r.length<32;)a^=r.charCodeAt(r.length%r.length),a*=16777619,r+=(a>>>0).toString(16).padStart(8,"0");return r.substring(0,32)}async function W(n,t,e){const a=`${n.toString()}${JSON.stringify(t)}`,r=H(a);if(P.i.has(r))return P.i.get(r);const s=await(await fetch(n,t)).json();return P.i.set(r,s,e),s}class _{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o(_,"_callbacks",new Map);const A={};function q(n,t){return async(...e)=>{if(t.pagination){const[i=0,s={},l={}]=e;return x(n,t,i,s,l)}const[a={},r={}]=e;return x(n,t,void 0,a,r)}}async function x(n,t,e,a={},r={}){const i=n.split(".");let s;for(let w=0;w<i.length;w++){const C=i[w];if(s=c.i.getApi(C),s)break}if(!t||!s||t.type!=="route"||s.type!=="api")throw new Error(`Invalid path: ${n}.${t.name}`);let l=z(`${s.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:w="page",limit:C=10,limitParam:D="limit"}=t.pagination,E=new URLSearchParams;E.append(w,String(e)),E.append(D,String(C));const I=l.includes("?")?"&":"?";l=`${l}${I}${E.toString()}`}let u={};r&&t.method!=="GET"&&(u.body=JSON.stringify(r)),u.headers={"Content-Type":"application/json",...s.headers,...t.headers},u.method=t.method;const{beforeRoute:f,beforeApi:y,beforeUrl:h,beforeConfig:b}=B({route:t,api:s,url:l,config:u});l=h,u=b,c.updateElement(y),c.updateElement(f);let g=await V(s,t,l,u);t.schema&&"validate"in t.schema&&(g=await t.schema.validate(g));const{afterRoute:m,afterApi:K,afterData:U}=Q({route:t,api:s,response:g,data:g});return c.updateElement(K),c.updateElement(m),_.run(`${s.name}.${t.name}`),U}async function J(n,t,e,a){return n?await W(t,e,a.cache):await(await fetch(t,e)).json()}async function V(n,t,e,a){var f,y;const r=n.cache||t.cache,i=t.retry||n.retry||0;if(t.rate){const h=`${n.name}.${t.name}`;if(!v(h,t.rate)){const g=N(h,t.rate),m=Math.ceil(g/1e3);throw new Error(`Rate limit exceeded for ${h}. Try again in ${m} seconds.`)}}else if(n.rate){const h=`${n.name}`;if(!v(h,n.rate)){const g=N(h,n.rate),m=Math.ceil(g/1e3);throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${m} seconds.`)}}let s,l=!1,u=0;for(;u<=i&&!l;)try{(f=t.callbacks)!=null&&f.call?t.callbacks.call({}):(y=n.callbacks)!=null&&y.call&&n.callbacks.call({}),s=await J(!!r,e,a,n),l=!0}catch(h){if(u++,u>i)throw h.message=`Failed to fetch ${e} after ${i} attempts`,h}return s}function z(n,t,e){let a=n;return t.arguments.forEach(r=>{if(e[r]===void 0)throw new Error(`Argument ${r} is missing`);a=a.replace(`[${r}]`,e[r])}),a}function B({route:n,api:t,url:e,config:a}){var i,s;const r=(s=(i=n.callbacks).before)==null?void 0:s.call(i,{route:n,api:t,url:e,config:a});return{beforeRoute:(r==null?void 0:r.route)||n,beforeApi:(r==null?void 0:r.api)||t,beforeUrl:(r==null?void 0:r.url)||e,beforeConfig:(r==null?void 0:r.config)||a}}function Q({route:n,api:t,response:e,data:a}){var i,s;const r=(s=(i=n.callbacks).after)==null?void 0:s.call(i,{route:n,api:t,response:e,data:a});return{afterRoute:(r==null?void 0:r.route)||n,afterApi:(r==null?void 0:r.api)||t,afterResponse:(r==null?void 0:r.response)||e,afterData:(r==null?void 0:r.data)||a}}const p=class p{constructor(){o(this,"_elements",new Map);o(this,"_currentParent",null)}static get i(){return p._instance||(p._instance=new p),p._instance}registerElement(t){const e=this._currentParent;e&&(t.parent=this.getFullPath(e));const a=this.getElementKey(t);if(this._elements.set(a,t),t.type==="api"||t.type==="group"){let r=A;if(e){const i=this.getFullPath(e).split(".");for(const s of i)r[s]||(r[s]={}),r=r[s]}r[t.name]||(r[t.name]={})}}getCurrentParent(){return this._currentParent}setCurrentParent(t){const e=this._elements.get(t);if(!e||e.type!=="api"&&e.type!=="group")throw new Error(`Element ${t} not found or not a valid parent type`);this._currentParent=e}clearCurrentParent(){this._currentParent=null}registerRoute(t){if(!this._currentParent)throw new Error("No current parent set, use Route only inside Api or Group create callback");t.parent=this.getFullPath(this._currentParent);const e=this.getElementKey(t);this._elements.set(e,t),this.addToKlaimRoute(t)}addToKlaimRoute(t){if(!t.parent)return;let e=A;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=q(t.parent,t)}getElementKey(t){return t?t.parent?`${t.parent}.${t.name}`:t.name:""}getFullPath(t){if(!t)return"";if(!t.parent)return t.name;const e=[t.name];let a=t;for(;a.parent;){const r=this._elements.get(a.parent);if(!r)break;e.unshift(r.name),a=r}return e.join(".")}getRoute(t,e){return this._elements.get(`${t}.${e}`)}getChildren(t){const e=[];return this._elements.forEach(a=>{a.parent===t&&e.push(a)}),e}static updateElement(t){return p.i._elements.get(p.i.getElementKey(t))||t}getApi(t){const e=this._elements.get(t);if(!e){for(const[a,r]of this._elements.entries())if(r.type==="api"&&a.endsWith(`.${t}`))return r;return}return e.type==="api"?e:this.findApi(e)}findApi(t){if(!t||!t.parent)return;const e=t.parent.split(".");for(let a=e.length;a>=0;a--){const r=e.slice(0,a).join("."),i=this._elements.get(r);if((i==null?void 0:i.type)==="api")return i}}};o(p,"_instance");let c=p;class S extends k{static create(t,e,a,r={}){const i=T(t);i!==t&&console.warn(`API name "${t}" has been camelCased to "${i}"`);const s=new S(i,e,r),l=c.i.getCurrentParent();c.i.registerElement(s);const u=l?c.i.getFullPath(l):"",f=u?`${u}.${i}`:i;return c.i.setCurrentParent(f),a(),l?c.i.setCurrentParent(c.i.getFullPath(l)):c.i.clearCurrentParent(),s}constructor(t,e,a={}){super("api",t,e,a)}}class F extends k{static create(t,e){const a=T(t),r=c.i.getCurrentParent(),i=r?c.i.getFullPath(r):"",s=i?`${i}.${a}`:a,l=new F(a,"");a!==t&&console.warn(`Group name "${t}" has been camelCased to "${a}"`),c.i.registerElement(l);const u=c.i.getCurrentParent();return c.i.setCurrentParent(s),e(),u?c.i.setCurrentParent(c.i.getFullPath(u)):c.i.clearCurrentParent(),l}constructor(t,e,a={}){super("group",t,e,a)}withCache(t=20){return super.withCache(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.cache||(e.cache=t)}),this}withRetry(t=2){return super.withRetry(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.retry||(e.retry=t)}),this}before(t){return super.before(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.before||(e.callbacks.before=t)}),this}after(t){return super.after(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.after||(e.callbacks.after=t)}),this}onCall(t){return super.onCall(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.call||(e.callbacks.call=t)}),this}}class R extends k{constructor(t,e,a={},r="GET"){super("route",t,e,a),this.method=r,this.detectArguments()}static createRoute(t,e,a={},r){const i=new R(t,e,a,r);return c.i.registerRoute(i),i}static get(t,e,a={}){return this.createRoute(t,e,a,"GET")}static post(t,e,a={}){return this.createRoute(t,e,a,"POST")}static put(t,e,a={}){return this.createRoute(t,e,a,"PUT")}static delete(t,e,a={}){return this.createRoute(t,e,a,"DELETE")}static patch(t,e,a={}){return this.createRoute(t,e,a,"PATCH")}static options(t,e,a={}){return this.createRoute(t,e,a,"OPTIONS")}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const a=e.replace("[","").replace("]","");this.arguments.add(a)})}validate(t){return this.schema=t,this}}exports.Api=S;exports.Group=F;exports.Hook=_;exports.Klaim=A;exports.Registry=c;exports.Route=R;

package/dist/klaim.es.js

@@ -1,19 +1,40 @@
-var x = Object.defineProperty;
-var D = (n, t, e) => t in n ? x(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
-var o = (n, t, e) => D(n, typeof t != "symbol" ? t + "" : t, e);
-function b(n) {
+var L = Object.defineProperty;
+var G = (n, t, e) => t in n ? L(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
+var o = (n, t, e) => G(n, typeof t != "symbol" ? t + "" : t, e);
+function A(n) {
   return n.replace(/([-_][a-z])/gi, (t) => t.toUpperCase().replace("-", "").replace("_", "")).replace(/(^\w)/, (t) => t.toLowerCase());
 }
-function G(n) {
+function M(n) {
   return n.trim().replace(/^\/|\/$/g, "");
 }
 const O = {
+  limit: 5,
+  duration: 10
+  // seconds
+}, b = /* @__PURE__ */ new Map();
+function k(n, t) {
+  const e = Date.now(), a = t.duration * 1e3;
+  let r = b.get(n);
+  r || (r = { timestamps: [] }, b.set(n, r));
+  const i = r.timestamps.filter(
+    (s) => e - s < a
+  );
+  return i.length >= t.limit ? !1 : (i.push(e), r.timestamps = i, !0);
+}
+function _(n, t) {
+  const e = b.get(n);
+  if (!e || e.timestamps.length < t.limit)
+    return 0;
+  const a = Date.now(), r = t.duration * 1e3, l = [...e.timestamps].sort((h, f) => h - f)[0] + r - a;
+  return Math.max(0, l);
+}
+const j = {
   page: 1,
   pageParam: "page",
   limit: 10,
   limitParam: "limit"
 };
-class E {
+class T {
   /**
    * Creates a new element with the specified properties
    * @param {("api"|"route"|"group")} type - Element type identifier
@@ -38,6 +59,7 @@ class E {
     });
     o(this, "cache", !1);
     o(this, "retry", !1);
+    o(this, "rate", !1);
     /**
      * Enables response caching for this element
      * @param {number} [duration=20] - Cache duration in seconds
@@ -50,7 +72,20 @@ class E {
      * @returns {this} The element instance for chaining
      */
     o(this, "withRetry", (t = 2) => (this.retry = t, this));
-    this.type = t, this.name = b(e), this.name !== e && console.warn(`Name "${e}" has been camelCased to "${this.name}"`), this.url = G(a), this.headers = r || {};
+    /**
+     * Enables rate limiting for this element
+     * @param {Partial<IRateLimitConfig>} [config] - Rate limiting configuration options
+     * @returns {this} The element instance for chaining
+     * @example
+     * ```typescript
+     * Route.get("getUser", "/users/[id]").withRate({ limit: 5, duration: 10 });
+     * ```
+     */
+    o(this, "withRate", (t = {}) => (this.rate = {
+      ...O,
+      ...t
+    }, this));
+    this.type = t, this.name = A(e), this.name !== e && console.warn(`Name "${e}" has been camelCased to "${this.name}"`), this.url = M(a), this.headers = r || {};
   }
   /**
    * Adds a before-request middleware callback
@@ -92,12 +127,12 @@ class E {
    */
   withPagination(t = {}) {
     return this.pagination = {
-      ...O,
+      ...j,
       ...t
     }, this;
   }
 }
-const p = class p {
+const d = class d {
   /**
    * Private constructor to enforce singleton pattern.
    * Initializes an empty cache storage.
@@ -125,7 +160,7 @@ const p = class p {
    * ```
    */
   static get i() {
-    return p._instance || (p._instance = new p()), p._instance;
+    return d._instance || (d._instance = new d()), d._instance;
   }
   /**
    * Stores a value in the cache with an optional time-to-live duration.
@@ -188,9 +223,9 @@ const p = class p {
  *
  * @private
  */
-o(p, "_instance");
-let d = p;
-function I(n) {
+o(d, "_instance");
+let P = d;
+function H(n) {
   let a = 2166136261;
   for (let i = 0; i < n.length; i++)
     a ^= n.charCodeAt(i), a *= 16777619;
@@ -199,14 +234,14 @@ function I(n) {
     a ^= r.charCodeAt(r.length % r.length), a *= 16777619, r += (a >>> 0).toString(16).padStart(8, "0");
   return r.substring(0, 32);
 }
-async function j(n, t, e) {
-  const a = `${n.toString()}${JSON.stringify(t)}`, r = I(a);
-  if (d.i.has(r))
-    return d.i.get(r);
+async function W(n, t, e) {
+  const a = `${n.toString()}${JSON.stringify(t)}`, r = H(a);
+  if (P.i.has(r))
+    return P.i.get(r);
   const s = await (await fetch(n, t)).json();
-  return d.i.set(r, s, e), s;
+  return P.i.set(r, s, e), s;
 }
-class k {
+class R {
   /**
    * Registers a callback function for a specific route.
    * If a callback already exists for the route, it will be replaced.
@@ -248,33 +283,33 @@ class k {
  *
  * @private
  */
-o(k, "_callbacks", /* @__PURE__ */ new Map());
-const $ = {};
-function H(n, t) {
+o(R, "_callbacks", /* @__PURE__ */ new Map());
+const F = {};
+function q(n, t) {
   return async (...e) => {
     if (t.pagination) {
       const [i = 0, s = {}, l = {}] = e;
-      return A(n, t, i, s, l);
+      return S(n, t, i, s, l);
     }
     const [a = {}, r = {}] = e;
-    return A(n, t, void 0, a, r);
+    return S(n, t, void 0, a, r);
   };
 }
-async function A(n, t, e, a = {}, r = {}) {
+async function S(n, t, e, a = {}, r = {}) {
   const i = n.split(".");
   let s;
-  for (let g = 0; g < i.length; g++) {
-    const y = i[g];
-    if (s = c.i.getApi(y), s) break;
+  for (let w = 0; w < i.length; w++) {
+    const E = i[w];
+    if (s = c.i.getApi(E), s) break;
   }
   if (!t || !s || t.type !== "route" || s.type !== "api")
     throw new Error(`Invalid path: ${n}.${t.name}`);
-  let l = W(`${s.url}/${t.url}`, t, a);
+  let l = z(`${s.url}/${t.url}`, t, a);
   if (t.pagination && typeof e < "u") {
-    const { pageParam: g = "page", limit: y = 10, limitParam: K = "limit" } = t.pagination, C = new URLSearchParams();
-    C.append(g, String(e)), C.append(K, String(y));
-    const U = l.includes("?") ? "&" : "?";
-    l = `${l}${U}${C.toString()}`;
+    const { pageParam: w = "page", limit: E = 10, limitParam: I = "limit" } = t.pagination, $ = new URLSearchParams();
+    $.append(w, String(e)), $.append(I, String(E));
+    const K = l.includes("?") ? "&" : "?";
+    l = `${l}${K}${$.toString()}`;
   }
   let h = {};
   r && t.method !== "GET" && (h.body = JSON.stringify(r)), h.headers = {
@@ -284,37 +319,50 @@ async function A(n, t, e, a = {}, r = {}) {
   }, h.method = t.method;
   const {
     beforeRoute: f,
-    beforeApi: P,
-    beforeUrl: m,
-    beforeConfig: v
-  } = J({ route: t, api: s, url: l, config: h });
-  l = m, h = v, c.updateElement(P), c.updateElement(f);
-  let w = await M(s, t, l, h);
-  t.schema && "validate" in t.schema && (w = await t.schema.validate(w));
+    beforeApi: y,
+    beforeUrl: u,
+    beforeConfig: C
+  } = B({ route: t, api: s, url: l, config: h });
+  l = u, h = C, c.updateElement(y), c.updateElement(f);
+  let g = await V(s, t, l, h);
+  t.schema && "validate" in t.schema && (g = await t.schema.validate(g));
   const {
-    afterRoute: T,
-    afterApi: N,
-    afterData: R
-  } = z({ route: t, api: s, response: w, data: w });
-  return c.updateElement(N), c.updateElement(T), k.run(`${s.name}.${t.name}`), R;
+    afterRoute: m,
+    afterApi: U,
+    afterData: D
+  } = Q({ route: t, api: s, response: g, data: g });
+  return c.updateElement(U), c.updateElement(m), R.run(`${s.name}.${t.name}`), D;
 }
-async function L(n, t, e, a) {
-  return n ? await j(t, e, a.cache) : await (await fetch(t, e)).json();
+async function J(n, t, e, a) {
+  return n ? await W(t, e, a.cache) : await (await fetch(t, e)).json();
 }
-async function M(n, t, e, a) {
-  var f, P;
+async function V(n, t, e, a) {
+  var f, y;
   const r = n.cache || t.cache, i = t.retry || n.retry || 0;
+  if (t.rate) {
+    const u = `${n.name}.${t.name}`;
+    if (!k(u, t.rate)) {
+      const g = _(u, t.rate), m = Math.ceil(g / 1e3);
+      throw new Error(`Rate limit exceeded for ${u}. Try again in ${m} seconds.`);
+    }
+  } else if (n.rate) {
+    const u = `${n.name}`;
+    if (!k(u, n.rate)) {
+      const g = _(u, n.rate), m = Math.ceil(g / 1e3);
+      throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${m} seconds.`);
+    }
+  }
   let s, l = !1, h = 0;
   for (; h <= i && !l; )
     try {
-      (f = t.callbacks) != null && f.call ? t.callbacks.call({}) : (P = n.callbacks) != null && P.call && n.callbacks.call({}), s = await L(!!r, e, a, n), l = !0;
-    } catch (m) {
+      (f = t.callbacks) != null && f.call ? t.callbacks.call({}) : (y = n.callbacks) != null && y.call && n.callbacks.call({}), s = await J(!!r, e, a, n), l = !0;
+    } catch (u) {
       if (h++, h > i)
-        throw m.message = `Failed to fetch ${e} after ${i} attempts`, m;
+        throw u.message = `Failed to fetch ${e} after ${i} attempts`, u;
     }
   return s;
 }
-function W(n, t, e) {
+function z(n, t, e) {
   let a = n;
   return t.arguments.forEach((r) => {
     if (e[r] === void 0)
@@ -322,7 +370,7 @@ function W(n, t, e) {
     a = a.replace(`[${r}]`, e[r]);
   }), a;
 }
-function J({ route: n, api: t, url: e, config: a }) {
+function B({ route: n, api: t, url: e, config: a }) {
   var i, s;
   const r = (s = (i = n.callbacks).before) == null ? void 0 : s.call(i, { route: n, api: t, url: e, config: a });
   return {
@@ -332,7 +380,7 @@ function J({ route: n, api: t, url: e, config: a }) {
     beforeConfig: (r == null ? void 0 : r.config) || a
   };
 }
-function z({ route: n, api: t, response: e, data: a }) {
+function Q({ route: n, api: t, response: e, data: a }) {
   var i, s;
   const r = (s = (i = n.callbacks).after) == null ? void 0 : s.call(i, { route: n, api: t, response: e, data: a });
   return {
@@ -342,7 +390,7 @@ function z({ route: n, api: t, response: e, data: a }) {
     afterData: (r == null ? void 0 : r.data) || a
   };
 }
-const u = class u {
+const p = class p {
   constructor() {
     /**
      * Map storing all registered elements with their full paths as keys
@@ -360,7 +408,7 @@ const u = class u {
    * @returns The singleton Registry instance
    */
   static get i() {
-    return u._instance || (u._instance = new u()), u._instance;
+    return p._instance || (p._instance = new p()), p._instance;
   }
   /**
    * Registers a new element in the registry and updates the Klaim object structure
@@ -377,7 +425,7 @@ const u = class u {
     e && (t.parent = this.getFullPath(e));
     const a = this.getElementKey(t);
     if (this._elements.set(a, t), t.type === "api" || t.type === "group") {
-      let r = $;
+      let r = F;
       if (e) {
         const i = this.getFullPath(e).split(".");
         for (const s of i)
@@ -432,11 +480,11 @@ const u = class u {
    */
   addToKlaimRoute(t) {
     if (!t.parent) return;
-    let e = $;
+    let e = F;
     const a = t.parent.split(".");
     for (const r of a)
       e[r] || (e[r] = {}), e = e[r];
-    e[t.name] = H(t.parent, t);
+    e[t.name] = q(t.parent, t);
   }
   /**
    * Generates a unique key for an element based on its path
@@ -494,7 +542,7 @@ const u = class u {
    * @returns The updated element
    */
   static updateElement(t) {
-    return u.i._elements.get(u.i.getElementKey(t)) || t;
+    return p.i._elements.get(p.i.getElementKey(t)) || t;
   }
   /**
    * Retrieves an API element by name, searching through the entire registry if necessary
@@ -528,9 +576,9 @@ const u = class u {
     }
   }
 };
-o(u, "_instance");
-let c = u;
-class _ extends E {
+o(p, "_instance");
+let c = p;
+class v extends T {
   /**
    * Creates and registers a new API instance with the given configuration
    *
@@ -550,9 +598,9 @@ class _ extends E {
    * ```
    */
   static create(t, e, a, r = {}) {
-    const i = b(t);
+    const i = A(t);
     i !== t && console.warn(`API name "${t}" has been camelCased to "${i}"`);
-    const s = new _(i, e, r), l = c.i.getCurrentParent();
+    const s = new v(i, e, r), l = c.i.getCurrentParent();
     c.i.registerElement(s);
     const h = l ? c.i.getFullPath(l) : "", f = h ? `${h}.${i}` : i;
     return c.i.setCurrentParent(f), a(), l ? c.i.setCurrentParent(c.i.getFullPath(l)) : c.i.clearCurrentParent(), s;
@@ -570,7 +618,7 @@ class _ extends E {
     super("api", t, e, a);
   }
 }
-class F extends E {
+class N extends T {
   /**
    * Creates a new group and registers it in the Registry.
    * Supports nested groups and inheritable configurations.
@@ -596,7 +644,7 @@ class F extends E {
    * ```
    */
   static create(t, e) {
-    const a = b(t), r = c.i.getCurrentParent(), i = r ? c.i.getFullPath(r) : "", s = i ? `${i}.${a}` : a, l = new F(a, "");
+    const a = A(t), r = c.i.getCurrentParent(), i = r ? c.i.getFullPath(r) : "", s = i ? `${i}.${a}` : a, l = new N(a, "");
     a !== t && console.warn(`Group name "${t}" has been camelCased to "${a}"`), c.i.registerElement(l);
     const h = c.i.getCurrentParent();
     return c.i.setCurrentParent(s), e(), h ? c.i.setCurrentParent(c.i.getFullPath(h)) : c.i.clearCurrentParent(), l;
@@ -720,7 +768,7 @@ class F extends E {
     }), this;
   }
 }
-class S extends E {
+class x extends T {
   /**
    * Creates a new Route instance.
    *
@@ -743,7 +791,7 @@ class S extends E {
    * @private
    */
   static createRoute(t, e, a = {}, r) {
-    const i = new S(t, e, a, r);
+    const i = new x(t, e, a, r);
     return c.i.registerRoute(i), i;
   }
   /**
@@ -903,10 +951,10 @@ class S extends E {
   }
 }
 export {
-  _ as Api,
-  F as Group,
-  k as Hook,
-  $ as Klaim,
+  v as Api,
+  N as Group,
+  R as Hook,
+  F as Klaim,
   c as Registry,
-  S as Route
+  x as Route
 };

package/dist/klaim.umd.js

@@ -1 +1 @@
-(function(u,p){typeof exports=="object"&&typeof module<"u"?p(exports):typeof define=="function"&&define.amd?define(["exports"],p):(u=typeof globalThis<"u"?globalThis:u||self,p(u.klaim={}))})(this,function(u){"use strict";var z=Object.defineProperty;var B=(u,p,d)=>p in u?z(u,p,{enumerable:!0,configurable:!0,writable:!0,value:d}):u[p]=d;var o=(u,p,d)=>B(u,typeof p!="symbol"?p+"":p,d);function p(i){return i.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function d(i){return i.trim().replace(/^\/|\/$/g,"")}const N={page:1,pageParam:"page",limit:10,limitParam:"limit"};class E{constructor(t,e,a,r={}){o(this,"type");o(this,"name");o(this,"url");o(this,"headers");o(this,"parent");o(this,"method");o(this,"arguments",new Set);o(this,"schema");o(this,"pagination");o(this,"callbacks",{before:null,after:null,call:null});o(this,"cache",!1);o(this,"retry",!1);o(this,"withCache",(t=20)=>(this.cache=t,this));o(this,"withRetry",(t=2)=>(this.retry=t,this));this.type=t,this.name=p(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=d(a),this.headers=r||{}}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}onCall(t){return this.callbacks.call=t,this}withPagination(t={}){return this.pagination={...N,...t},this}}const g=class g{constructor(){o(this,"cache");this.cache=new Map}static get i(){return g._instance||(g._instance=new g),g._instance}set(t,e,a=0){const r=Date.now()+a;this.cache.set(t,{data:e,expiry:r})}has(t){const e=this.cache.get(t);return e?Date.now()>e.expiry?(this.cache.delete(t),!1):!0:!1}get(t){return this.has(t)?this.cache.get(t).data:null}};o(g,"_instance");let P=g;function R(i){let a=2166136261;for(let n=0;n<i.length;n++)a^=i.charCodeAt(n),a*=16777619;let r=(a>>>0).toString(16).padStart(8,"0");for(;r.length<32;)a^=r.charCodeAt(r.length%r.length),a*=16777619,r+=(a>>>0).toString(16).padStart(8,"0");return r.substring(0,32)}async function K(i,t,e){const a=`${i.toString()}${JSON.stringify(t)}`,r=R(a);if(P.i.has(r))return P.i.get(r);const c=await(await fetch(i,t)).json();return P.i.set(r,c,e),c}class ${static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o($,"_callbacks",new Map);const A={};function G(i,t){return async(...e)=>{if(t.pagination){const[n=0,c={},l={}]=e;return v(i,t,n,c,l)}const[a={},r={}]=e;return v(i,t,void 0,a,r)}}async function v(i,t,e,a={},r={}){const n=i.split(".");let c;for(let y=0;y<n.length;y++){const F=n[y];if(c=s.i.getApi(F),c)break}if(!t||!c||t.type!=="route"||c.type!=="api")throw new Error(`Invalid path: ${i}.${t.name}`);let l=j(`${c.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:y="page",limit:F=10,limitParam:W="limit"}=t.pagination,T=new URLSearchParams;T.append(y,String(e)),T.append(W,String(F));const J=l.includes("?")?"&":"?";l=`${l}${J}${T.toString()}`}let h={};r&&t.method!=="GET"&&(h.body=JSON.stringify(r)),h.headers={"Content-Type":"application/json",...c.headers,...t.headers},h.method=t.method;const{beforeRoute:m,beforeApi:w,beforeUrl:b,beforeConfig:I}=D({route:t,api:c,url:l,config:h});l=b,h=I,s.updateElement(w),s.updateElement(m);let C=await U(c,t,l,h);t.schema&&"validate"in t.schema&&(C=await t.schema.validate(C));const{afterRoute:L,afterApi:M,afterData:x}=H({route:t,api:c,response:C,data:C});return s.updateElement(M),s.updateElement(L),$.run(`${c.name}.${t.name}`),x}async function O(i,t,e,a){return i?await K(t,e,a.cache):await(await fetch(t,e)).json()}async function U(i,t,e,a){var m,w;const r=i.cache||t.cache,n=t.retry||i.retry||0;let c,l=!1,h=0;for(;h<=n&&!l;)try{(m=t.callbacks)!=null&&m.call?t.callbacks.call({}):(w=i.callbacks)!=null&&w.call&&i.callbacks.call({}),c=await O(!!r,e,a,i),l=!0}catch(b){if(h++,h>n)throw b.message=`Failed to fetch ${e} after ${n} attempts`,b}return c}function j(i,t,e){let a=i;return t.arguments.forEach(r=>{if(e[r]===void 0)throw new Error(`Argument ${r} is missing`);a=a.replace(`[${r}]`,e[r])}),a}function D({route:i,api:t,url:e,config:a}){var n,c;const r=(c=(n=i.callbacks).before)==null?void 0:c.call(n,{route:i,api:t,url:e,config:a});return{beforeRoute:(r==null?void 0:r.route)||i,beforeApi:(r==null?void 0:r.api)||t,beforeUrl:(r==null?void 0:r.url)||e,beforeConfig:(r==null?void 0:r.config)||a}}function H({route:i,api:t,response:e,data:a}){var n,c;const r=(c=(n=i.callbacks).after)==null?void 0:c.call(n,{route:i,api:t,response:e,data:a});return{afterRoute:(r==null?void 0:r.route)||i,afterApi:(r==null?void 0:r.api)||t,afterResponse:(r==null?void 0:r.response)||e,afterData:(r==null?void 0:r.data)||a}}const f=class f{constructor(){o(this,"_elements",new Map);o(this,"_currentParent",null)}static get i(){return f._instance||(f._instance=new f),f._instance}registerElement(t){const e=this._currentParent;e&&(t.parent=this.getFullPath(e));const a=this.getElementKey(t);if(this._elements.set(a,t),t.type==="api"||t.type==="group"){let r=A;if(e){const n=this.getFullPath(e).split(".");for(const c of n)r[c]||(r[c]={}),r=r[c]}r[t.name]||(r[t.name]={})}}getCurrentParent(){return this._currentParent}setCurrentParent(t){const e=this._elements.get(t);if(!e||e.type!=="api"&&e.type!=="group")throw new Error(`Element ${t} not found or not a valid parent type`);this._currentParent=e}clearCurrentParent(){this._currentParent=null}registerRoute(t){if(!this._currentParent)throw new Error("No current parent set, use Route only inside Api or Group create callback");t.parent=this.getFullPath(this._currentParent);const e=this.getElementKey(t);this._elements.set(e,t),this.addToKlaimRoute(t)}addToKlaimRoute(t){if(!t.parent)return;let e=A;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=G(t.parent,t)}getElementKey(t){return t?t.parent?`${t.parent}.${t.name}`:t.name:""}getFullPath(t){if(!t)return"";if(!t.parent)return t.name;const e=[t.name];let a=t;for(;a.parent;){const r=this._elements.get(a.parent);if(!r)break;e.unshift(r.name),a=r}return e.join(".")}getRoute(t,e){return this._elements.get(`${t}.${e}`)}getChildren(t){const e=[];return this._elements.forEach(a=>{a.parent===t&&e.push(a)}),e}static updateElement(t){return f.i._elements.get(f.i.getElementKey(t))||t}getApi(t){const e=this._elements.get(t);if(!e){for(const[a,r]of this._elements.entries())if(r.type==="api"&&a.endsWith(`.${t}`))return r;return}return e.type==="api"?e:this.findApi(e)}findApi(t){if(!t||!t.parent)return;const e=t.parent.split(".");for(let a=e.length;a>=0;a--){const r=e.slice(0,a).join("."),n=this._elements.get(r);if((n==null?void 0:n.type)==="api")return n}}};o(f,"_instance");let s=f;class k extends E{static create(t,e,a,r={}){const n=p(t);n!==t&&console.warn(`API name "${t}" has been camelCased to "${n}"`);const c=new k(n,e,r),l=s.i.getCurrentParent();s.i.registerElement(c);const h=l?s.i.getFullPath(l):"",m=h?`${h}.${n}`:n;return s.i.setCurrentParent(m),a(),l?s.i.setCurrentParent(s.i.getFullPath(l)):s.i.clearCurrentParent(),c}constructor(t,e,a={}){super("api",t,e,a)}}class S extends E{static create(t,e){const a=p(t),r=s.i.getCurrentParent(),n=r?s.i.getFullPath(r):"",c=n?`${n}.${a}`:a,l=new S(a,"");a!==t&&console.warn(`Group name "${t}" has been camelCased to "${a}"`),s.i.registerElement(l);const h=s.i.getCurrentParent();return s.i.setCurrentParent(c),e(),h?s.i.setCurrentParent(s.i.getFullPath(h)):s.i.clearCurrentParent(),l}constructor(t,e,a={}){super("group",t,e,a)}withCache(t=20){return super.withCache(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.cache||(e.cache=t)}),this}withRetry(t=2){return super.withRetry(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.retry||(e.retry=t)}),this}before(t){return super.before(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.before||(e.callbacks.before=t)}),this}after(t){return super.after(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.after||(e.callbacks.after=t)}),this}onCall(t){return super.onCall(t),s.i.getChildren(s.i.getFullPath(this)).forEach(e=>{e.callbacks.call||(e.callbacks.call=t)}),this}}class _ extends E{constructor(t,e,a={},r="GET"){super("route",t,e,a),this.method=r,this.detectArguments()}static createRoute(t,e,a={},r){const n=new _(t,e,a,r);return s.i.registerRoute(n),n}static get(t,e,a={}){return this.createRoute(t,e,a,"GET")}static post(t,e,a={}){return this.createRoute(t,e,a,"POST")}static put(t,e,a={}){return this.createRoute(t,e,a,"PUT")}static delete(t,e,a={}){return this.createRoute(t,e,a,"DELETE")}static patch(t,e,a={}){return this.createRoute(t,e,a,"PATCH")}static options(t,e,a={}){return this.createRoute(t,e,a,"OPTIONS")}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const a=e.replace("[","").replace("]","");this.arguments.add(a)})}validate(t){return this.schema=t,this}}u.Api=k,u.Group=S,u.Hook=$,u.Klaim=A,u.Registry=s,u.Route=_,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})});
+(function(h,p){typeof exports=="object"&&typeof module<"u"?p(exports):typeof define=="function"&&define.amd?define(["exports"],p):(h=typeof globalThis<"u"?globalThis:h||self,p(h.klaim={}))})(this,function(h){"use strict";var Q=Object.defineProperty;var X=(h,p,P)=>p in h?Q(h,p,{enumerable:!0,configurable:!0,writable:!0,value:P}):h[p]=P;var o=(h,p,P)=>X(h,typeof p!="symbol"?p+"":p,P);function p(n){return n.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function P(n){return n.trim().replace(/^\/|\/$/g,"")}const I={limit:5,duration:10},$=new Map;function K(n,t){const e=Date.now(),a=t.duration*1e3;let r=$.get(n);r||(r={timestamps:[]},$.set(n,r));const i=r.timestamps.filter(s=>e-s<a);return i.length>=t.limit?!1:(i.push(e),r.timestamps=i,!0)}function U(n,t){const e=$.get(n);if(!e||e.timestamps.length<t.limit)return 0;const a=Date.now(),r=t.duration*1e3,l=[...e.timestamps].sort((u,d)=>u-d)[0]+r-a;return Math.max(0,l)}const L={page:1,pageParam:"page",limit:10,limitParam:"limit"};class A{constructor(t,e,a,r={}){o(this,"type");o(this,"name");o(this,"url");o(this,"headers");o(this,"parent");o(this,"method");o(this,"arguments",new Set);o(this,"schema");o(this,"pagination");o(this,"callbacks",{before:null,after:null,call:null});o(this,"cache",!1);o(this,"retry",!1);o(this,"rate",!1);o(this,"withCache",(t=20)=>(this.cache=t,this));o(this,"withRetry",(t=2)=>(this.retry=t,this));o(this,"withRate",(t={})=>(this.rate={...I,...t},this));this.type=t,this.name=p(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=P(a),this.headers=r||{}}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}onCall(t){return this.callbacks.call=t,this}withPagination(t={}){return this.pagination={...L,...t},this}}const w=class w{constructor(){o(this,"cache");this.cache=new Map}static get i(){return w._instance||(w._instance=new w),w._instance}set(t,e,a=0){const r=Date.now()+a;this.cache.set(t,{data:e,expiry:r})}has(t){const e=this.cache.get(t);return e?Date.now()>e.expiry?(this.cache.delete(t),!1):!0:!1}get(t){return this.has(t)?this.cache.get(t).data:null}};o(w,"_instance");let y=w;function G(n){let a=2166136261;for(let i=0;i<n.length;i++)a^=n.charCodeAt(i),a*=16777619;let r=(a>>>0).toString(16).padStart(8,"0");for(;r.length<32;)a^=r.charCodeAt(r.length%r.length),a*=16777619,r+=(a>>>0).toString(16).padStart(8,"0");return r.substring(0,32)}async function M(n,t,e){const a=`${n.toString()}${JSON.stringify(t)}`,r=G(a);if(y.i.has(r))return y.i.get(r);const s=await(await fetch(n,t)).json();return y.i.set(r,s,e),s}class T{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o(T,"_callbacks",new Map);const k={};function O(n,t){return async(...e)=>{if(t.pagination){const[i=0,s={},l={}]=e;return D(n,t,i,s,l)}const[a={},r={}]=e;return D(n,t,void 0,a,r)}}async function D(n,t,e,a={},r={}){const i=n.split(".");let s;for(let C=0;C<i.length;C++){const v=i[C];if(s=c.i.getApi(v),s)break}if(!t||!s||t.type!=="route"||s.type!=="api")throw new Error(`Invalid path: ${n}.${t.name}`);let l=H(`${s.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:C="page",limit:v=10,limitParam:z="limit"}=t.pagination,N=new URLSearchParams;N.append(C,String(e)),N.append(z,String(v));const B=l.includes("?")?"&":"?";l=`${l}${B}${N.toString()}`}let u={};r&&t.method!=="GET"&&(u.body=JSON.stringify(r)),u.headers={"Content-Type":"application/json",...s.headers,...t.headers},u.method=t.method;const{beforeRoute:d,beforeApi:E,beforeUrl:f,beforeConfig:R}=W({route:t,api:s,url:l,config:u});l=f,u=R,c.updateElement(E),c.updateElement(d);let m=await j(s,t,l,u);t.schema&&"validate"in t.schema&&(m=await t.schema.validate(m));const{afterRoute:b,afterApi:J,afterData:V}=q({route:t,api:s,response:m,data:m});return c.updateElement(J),c.updateElement(b),T.run(`${s.name}.${t.name}`),V}async function x(n,t,e,a){return n?await M(t,e,a.cache):await(await fetch(t,e)).json()}async function j(n,t,e,a){var d,E;const r=n.cache||t.cache,i=t.retry||n.retry||0;if(t.rate){const f=`${n.name}.${t.name}`;if(!K(f,t.rate)){const m=U(f,t.rate),b=Math.ceil(m/1e3);throw new Error(`Rate limit exceeded for ${f}. Try again in ${b} seconds.`)}}else if(n.rate){const f=`${n.name}`;if(!K(f,n.rate)){const m=U(f,n.rate),b=Math.ceil(m/1e3);throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${b} seconds.`)}}let s,l=!1,u=0;for(;u<=i&&!l;)try{(d=t.callbacks)!=null&&d.call?t.callbacks.call({}):(E=n.callbacks)!=null&&E.call&&n.callbacks.call({}),s=await x(!!r,e,a,n),l=!0}catch(f){if(u++,u>i)throw f.message=`Failed to fetch ${e} after ${i} attempts`,f}return s}function H(n,t,e){let a=n;return t.arguments.forEach(r=>{if(e[r]===void 0)throw new Error(`Argument ${r} is missing`);a=a.replace(`[${r}]`,e[r])}),a}function W({route:n,api:t,url:e,config:a}){var i,s;const r=(s=(i=n.callbacks).before)==null?void 0:s.call(i,{route:n,api:t,url:e,config:a});return{beforeRoute:(r==null?void 0:r.route)||n,beforeApi:(r==null?void 0:r.api)||t,beforeUrl:(r==null?void 0:r.url)||e,beforeConfig:(r==null?void 0:r.config)||a}}function q({route:n,api:t,response:e,data:a}){var i,s;const r=(s=(i=n.callbacks).after)==null?void 0:s.call(i,{route:n,api:t,response:e,data:a});return{afterRoute:(r==null?void 0:r.route)||n,afterApi:(r==null?void 0:r.api)||t,afterResponse:(r==null?void 0:r.response)||e,afterData:(r==null?void 0:r.data)||a}}const g=class g{constructor(){o(this,"_elements",new Map);o(this,"_currentParent",null)}static get i(){return g._instance||(g._instance=new g),g._instance}registerElement(t){const e=this._currentParent;e&&(t.parent=this.getFullPath(e));const a=this.getElementKey(t);if(this._elements.set(a,t),t.type==="api"||t.type==="group"){let r=k;if(e){const i=this.getFullPath(e).split(".");for(const s of i)r[s]||(r[s]={}),r=r[s]}r[t.name]||(r[t.name]={})}}getCurrentParent(){return this._currentParent}setCurrentParent(t){const e=this._elements.get(t);if(!e||e.type!=="api"&&e.type!=="group")throw new Error(`Element ${t} not found or not a valid parent type`);this._currentParent=e}clearCurrentParent(){this._currentParent=null}registerRoute(t){if(!this._currentParent)throw new Error("No current parent set, use Route only inside Api or Group create callback");t.parent=this.getFullPath(this._currentParent);const e=this.getElementKey(t);this._elements.set(e,t),this.addToKlaimRoute(t)}addToKlaimRoute(t){if(!t.parent)return;let e=k;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=O(t.parent,t)}getElementKey(t){return t?t.parent?`${t.parent}.${t.name}`:t.name:""}getFullPath(t){if(!t)return"";if(!t.parent)return t.name;const e=[t.name];let a=t;for(;a.parent;){const r=this._elements.get(a.parent);if(!r)break;e.unshift(r.name),a=r}return e.join(".")}getRoute(t,e){return this._elements.get(`${t}.${e}`)}getChildren(t){const e=[];return this._elements.forEach(a=>{a.parent===t&&e.push(a)}),e}static updateElement(t){return g.i._elements.get(g.i.getElementKey(t))||t}getApi(t){const e=this._elements.get(t);if(!e){for(const[a,r]of this._elements.entries())if(r.type==="api"&&a.endsWith(`.${t}`))return r;return}return e.type==="api"?e:this.findApi(e)}findApi(t){if(!t||!t.parent)return;const e=t.parent.split(".");for(let a=e.length;a>=0;a--){const r=e.slice(0,a).join("."),i=this._elements.get(r);if((i==null?void 0:i.type)==="api")return i}}};o(g,"_instance");let c=g;class _ extends A{static create(t,e,a,r={}){const i=p(t);i!==t&&console.warn(`API name "${t}" has been camelCased to "${i}"`);const s=new _(i,e,r),l=c.i.getCurrentParent();c.i.registerElement(s);const u=l?c.i.getFullPath(l):"",d=u?`${u}.${i}`:i;return c.i.setCurrentParent(d),a(),l?c.i.setCurrentParent(c.i.getFullPath(l)):c.i.clearCurrentParent(),s}constructor(t,e,a={}){super("api",t,e,a)}}class S extends A{static create(t,e){const a=p(t),r=c.i.getCurrentParent(),i=r?c.i.getFullPath(r):"",s=i?`${i}.${a}`:a,l=new S(a,"");a!==t&&console.warn(`Group name "${t}" has been camelCased to "${a}"`),c.i.registerElement(l);const u=c.i.getCurrentParent();return c.i.setCurrentParent(s),e(),u?c.i.setCurrentParent(c.i.getFullPath(u)):c.i.clearCurrentParent(),l}constructor(t,e,a={}){super("group",t,e,a)}withCache(t=20){return super.withCache(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.cache||(e.cache=t)}),this}withRetry(t=2){return super.withRetry(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.retry||(e.retry=t)}),this}before(t){return super.before(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.before||(e.callbacks.before=t)}),this}after(t){return super.after(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.after||(e.callbacks.after=t)}),this}onCall(t){return super.onCall(t),c.i.getChildren(c.i.getFullPath(this)).forEach(e=>{e.callbacks.call||(e.callbacks.call=t)}),this}}class F extends A{constructor(t,e,a={},r="GET"){super("route",t,e,a),this.method=r,this.detectArguments()}static createRoute(t,e,a={},r){const i=new F(t,e,a,r);return c.i.registerRoute(i),i}static get(t,e,a={}){return this.createRoute(t,e,a,"GET")}static post(t,e,a={}){return this.createRoute(t,e,a,"POST")}static put(t,e,a={}){return this.createRoute(t,e,a,"PUT")}static delete(t,e,a={}){return this.createRoute(t,e,a,"DELETE")}static patch(t,e,a={}){return this.createRoute(t,e,a,"PATCH")}static options(t,e,a={}){return this.createRoute(t,e,a,"OPTIONS")}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const a=e.replace("[","").replace("]","");this.arguments.add(a)})}validate(t){return this.schema=t,this}}h.Api=_,h.Group=S,h.Hook=T,h.Klaim=k,h.Registry=c,h.Route=F,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "klaim",
-    "version": "1.8.87",
+    "version": "1.9.1",
     "author": "antharuu",
     "repository": {
         "type": "git",
@@ -9,15 +9,15 @@
     "main": "dist/klaim.cjs.js",
     "module": "dist/klaim.es.js",
     "devDependencies": {
-        "@eslint/js": "9.25.1",
+        "@eslint/js": "9.26.0",
         "@stylistic/eslint-plugin": "4.2.0",
-        "@types/bun": "latest",
+        "@types/bun": "^1.2.11",
         "@types/eslint__js": "9.14.0",
         "@types/node": "^22.15.3",
         "@vitest/coverage-v8": "^3.1.2",
         "@vitest/ui": "^3.1.2",
         "dotenv-cli": "^8.0.0",
-        "eslint": "9.25.1",
+        "eslint": "9.26.0",
         "eslint-plugin-jsdoc": "50.6.11",
         "eslint-plugin-simple-import-sort": "12.1.1",
         "jsdom": "^26.1.0",

package/src/core/Element.ts

@@ -1,5 +1,6 @@
 import cleanUrl from "../tools/cleanUrl";
 import toCamelCase from "../tools/toCamelCase";
+import { IRateLimitConfig, DEFAULT_RATE_LIMIT_CONFIG } from "../tools/rateLimit";
 
 /**
  * Type definition for HTTP headers
@@ -96,6 +97,8 @@ export interface IElement {
 	cache: false | number;
 	/** Number of retry attempts, or false if retries are disabled */
 	retry: false | number;
+	/** Rate limiting configuration, or false if rate limiting is disabled */
+	rate: false | IRateLimitConfig;
 	/** Reference to parent element name */
 	parent?: string;
 	/** HTTP method for routes */
@@ -124,6 +127,9 @@ export interface IElement {
 
 	/** Configures pagination settings */
 	withPagination(config?: IPaginationConfig): this;
+
+	/** Enables rate limiting */
+	withRate(config?: Partial<IRateLimitConfig>): this;
 }
 
 /**
@@ -162,6 +168,7 @@ export abstract class Element implements IElement {
 
 	public cache: false | number = false;
 	public retry: false | number = false;
+	public rate: false | IRateLimitConfig = false;
 
 	/**
 	 * Creates a new element with the specified properties
@@ -257,4 +264,21 @@ export abstract class Element implements IElement {
 		};
 		return this;
 	}
+
+	/**
+	 * Enables rate limiting for this element
+	 * @param {Partial<IRateLimitConfig>} [config] - Rate limiting configuration options
+	 * @returns {this} The element instance for chaining
+	 * @example
+	 * ```typescript
+	 * Route.get("getUser", "/users/[id]").withRate({ limit: 5, duration: 10 });
+	 * ```
+	 */
+	public withRate = (config: Partial<IRateLimitConfig> = {}): this => {
+		this.rate = {
+			...DEFAULT_RATE_LIMIT_CONFIG,
+			...config
+		};
+		return this;
+	};
 }

package/src/core/Klaim.ts

@@ -1,4 +1,5 @@
 import fetchWithCache from "../tools/fetchWithCache";
+import { checkRateLimit, getTimeUntilNextRequest } from "../tools/rateLimit";
 import {IElement} from "./Element";
 import {Hook} from "./Hook";
 import {Registry} from "./Registry";
@@ -41,10 +42,7 @@ export type IApiReference = Record<string, IRouteReference>;
  * await Klaim.apiName.routeName();
  *
  * // With pagination
- * await Klaim.apiName.routeName(2, 10); // Page 2, 10 items per page
- *
- * // With pagination and additional parameters
- * await Klaim.apiName.routeName(2, 10, { filter: 'active' });
+ * await Klaim.apiName.routeName(2); // Page 2
  * ```
  */
 export const Klaim: IApiReference = {};
@@ -191,14 +189,14 @@ async function fetchData(
 }
 
 /**
- * Performs a fetch request with retry capability
+ * Performs a fetch request with retry capability and rate limiting
  *
  * @param api - API element containing retry settings
  * @param route - Route element containing retry settings
  * @param url - The URL to fetch from
  * @param config - Fetch configuration options
  * @returns Promise resolving to the parsed response
- * @throws Error after all retry attempts fail
+ * @throws Error after all retry attempts fail or if rate limited
  */
 async function fetchWithRetry(
 	api: IElement,
@@ -208,6 +206,31 @@ async function fetchWithRetry(
 ): Promise<any> {
 	const withCache = api.cache || route.cache;
 	const maxRetries = (route.retry || api.retry) || 0;
+	
+	// Check rate limiting
+	// Si la route a sa propre configuration de limite, on l'utilise avec une clé spécifique à la route
+	if (route.rate) {
+		const routeKey = `${api.name}.${route.name}`;
+		const allowed = checkRateLimit(routeKey, route.rate);
+		
+		if (!allowed) {
+			const waitTime = getTimeUntilNextRequest(routeKey, route.rate);
+			const waitSeconds = Math.ceil(waitTime / 1000);
+			throw new Error(`Rate limit exceeded for ${routeKey}. Try again in ${waitSeconds} seconds.`);
+		}
+	} 
+	// Si l'API a une configuration de limite et que la route n'en a pas, utiliser une clé au niveau de l'API
+	else if (api.rate) {
+		const apiKey = `${api.name}`;
+		const allowed = checkRateLimit(apiKey, api.rate);
+		
+		if (!allowed) {
+			const waitTime = getTimeUntilNextRequest(apiKey, api.rate);
+			const waitSeconds = Math.ceil(waitTime / 1000);
+			throw new Error(`Rate limit exceeded for ${api.name} API. Try again in ${waitSeconds} seconds.`);
+		}
+	}
+	
 	let response;
 	let success = false;
 	let attempt = 0;

package/src/tools/rateLimit.ts

@@ -0,0 +1,88 @@
+/**
+ * Configuration interface for rate limiting settings
+ * @interface IRateLimitConfig
+ * @property {number} limit - Maximum number of requests allowed in the given duration
+ * @property {number} duration - Time window in seconds for the rate limit
+ */
+export interface IRateLimitConfig {
+    limit: number;
+    duration: number;
+}
+
+/**
+ * Default configuration for rate limiting
+ * @constant DEFAULT_RATE_LIMIT_CONFIG
+ */
+export const DEFAULT_RATE_LIMIT_CONFIG: IRateLimitConfig = {
+    limit: 5,
+    duration: 10 // seconds
+};
+
+// Store request timestamps for rate limiting
+type RequestLog = {
+    timestamps: number[]; // Timestamps of requests
+};
+
+// Global request log
+const requestLogs: Map<string, RequestLog> = new Map();
+
+/**
+ * Checks if a request should be rate limited
+ * 
+ * @param key - Unique identifier for the API/route combination
+ * @param config - Rate limiting configuration
+ * @returns True if the request should be allowed, false if it should be rate limited
+ */
+export function checkRateLimit(key: string, config: IRateLimitConfig): boolean {
+    const now = Date.now();
+    const timeWindow = config.duration * 1000; // Convert to milliseconds
+    
+    // Get or initialize request log for this key
+    let requestLog = requestLogs.get(key);
+    if (!requestLog) {
+        requestLog = { timestamps: [] };
+        requestLogs.set(key, requestLog);
+    }
+    
+    // Clean up old timestamps outside the current time window
+    const validTimestamps = requestLog.timestamps.filter(
+        time => now - time < timeWindow
+    );
+    
+    // Check if we've hit the rate limit
+    if (validTimestamps.length >= config.limit) {
+        return false; // Rate limited
+    }
+    
+    // Add current timestamp and update the log
+    validTimestamps.push(now);
+    requestLog.timestamps = validTimestamps;
+    
+    return true; // Request allowed
+}
+
+/**
+ * Calculates time remaining until the next request is allowed
+ * 
+ * @param key - Unique identifier for the API/route combination
+ * @param config - Rate limiting configuration
+ * @returns Time in milliseconds until the next request is allowed, or 0 if not rate limited
+ */
+export function getTimeUntilNextRequest(key: string, config: IRateLimitConfig): number {
+    const requestLog = requestLogs.get(key);
+    if (!requestLog || requestLog.timestamps.length < config.limit) {
+        return 0; // Not rate limited
+    }
+    
+    const now = Date.now();
+    const timeWindow = config.duration * 1000;
+    
+    // Sort timestamps in ascending order
+    const sortedTimestamps = [...requestLog.timestamps].sort((a, b) => a - b);
+    
+    // Oldest timestamp + timeWindow = when it will expire
+    const oldestValidTime = sortedTimestamps[0];
+    const timeUntilExpiry = (oldestValidTime + timeWindow) - now;
+    
+    return Math.max(0, timeUntilExpiry);
+} 

package/tests/10.ratelimit.test.ts

@@ -0,0 +1,104 @@
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import { Api, Klaim, Route } from "../src";
+
+// Mock fetch pour simuler les réponses API sans faire de vraies requêtes
+global.fetch = vi.fn(() =>
+    Promise.resolve({
+        json: () => Promise.resolve({ success: true }),
+    })
+) as any;
+
+// Réinitialiser les mocks entre chaque test
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+
+describe("Rate Limiting", () => {
+    it("should allow requests within the rate limit", async () => {
+        const apiName = "testRateApi";
+        const apiUrl = "https://example.com";
+        const routeName = "testRateRoute";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName, "/test").withRate({ limit: 3, duration: 10 });
+        });
+
+        // Devrait permettre 3 requêtes successives sans problème
+        await Klaim[apiName][routeName]();
+        await Klaim[apiName][routeName]();
+        await Klaim[apiName][routeName]();
+
+        // Vérifier que fetch a été appelé 3 fois
+        expect(fetch).toHaveBeenCalledTimes(3);
+    });
+
+    it("should block requests that exceed the rate limit", async () => {
+        const apiName = "testRateApi2";
+        const apiUrl = "https://example.com";
+        const routeName = "testRateRoute2";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName, "/test").withRate({ limit: 2, duration: 10 });
+        });
+
+        // Les deux premières requêtes devraient réussir
+        await Klaim[apiName][routeName]();
+        await Klaim[apiName][routeName]();
+
+        // La troisième requête devrait être bloquée
+        await expect(Klaim[apiName][routeName]()).rejects.toThrow(/Rate limit exceeded/);
+
+        // Vérifier que fetch n'a été appelé que 2 fois
+        expect(fetch).toHaveBeenCalledTimes(2);
+    });
+
+    it("should apply rate limits at the API level", async () => {
+        const apiName = "testRateApi3";
+        const apiUrl = "https://example.com";
+        const routeName1 = "testRateRoute3A";
+        const routeName2 = "testRateRoute3B";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName1, "/test1");
+            Route.get(routeName2, "/test2");
+        }).withRate({ limit: 3, duration: 10 });
+
+        // Différentes routes mais même API - devrait compter pour la même limite
+        await Klaim[apiName][routeName1]();
+        await Klaim[apiName][routeName1]();
+        await Klaim[apiName][routeName2]();
+
+        // La quatrième requête devrait être bloquée
+        await expect(Klaim[apiName][routeName1]()).rejects.toThrow(/Rate limit exceeded/);
+
+        // Vérifier que fetch n'a été appelé que 3 fois
+        expect(fetch).toHaveBeenCalledTimes(3);
+    });
+
+    it("should respect route-specific rate limits over API-level limits", async () => {
+        const apiName = "testRateApi4";
+        const apiUrl = "https://example.com";
+        const routeName1 = "testRateRoute4A";
+        const routeName2 = "testRateRoute4B";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName1, "/test1").withRate({ limit: 1, duration: 10 }); // Limite plus stricte
+            Route.get(routeName2, "/test2"); // Utilise la limite de l'API
+        }).withRate({ limit: 5, duration: 10 });
+
+        // La première route a une limite de 1
+        await Klaim[apiName][routeName1]();
+        await expect(Klaim[apiName][routeName1]()).rejects.toThrow(/Rate limit exceeded/);
+
+        // La deuxième route utilise la limite de l'API (5)
+        await Klaim[apiName][routeName2]();
+        await Klaim[apiName][routeName2]();
+        await Klaim[apiName][routeName2]();
+        await Klaim[apiName][routeName2]();
+        await Klaim[apiName][routeName2]();
+        await expect(Klaim[apiName][routeName2]()).rejects.toThrow(/Rate limit exceeded/);
+
+        // Vérifier que fetch a été appelé 6 fois (1 + 5)
+        expect(fetch).toHaveBeenCalledTimes(6);
+    });
+});