klaim 1.9.39 → 1.10.0

package/README.md

@@ -37,15 +37,14 @@
 - **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.
+- **Timeout**: Abort requests that exceed a specified duration with an optional custom error message.
 - **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
 
-- Login (Version: 1.10)
-- Time Out (Version: 1.11)
-- Error Handling (Version: 1.12)
+- Error Handling (Version: 1.11)
 
 ## 📥 Installation
 
@@ -371,6 +370,22 @@ try {
 }
 ```
 
+### Request Timeout
+
+Abort requests that take too long to respond. You can specify the timeout duration in seconds and optionally provide a custom message.
+
+```typescript
+Api.create("api", "https://api.example.com", () => {
+    Route.get("slow", "/slow").withTimeout(5, "Too slow");
+}).withTimeout(10);
+
+try {
+    await Klaim.api.slow();
+} catch (error) {
+    console.error(error);
+}
+```
+
 ### Response Validation
 
 You can use [Yup](https://www.npmjs.com/package/yup) to validate the response schema for increased reliability and

package/deno.json

@@ -1,6 +1,6 @@
 {
     "name": "@antharuu/klaim",
-    "version": "1.9.39",
+    "version": "1.10.0",
     "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 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;
+"use strict";var O=Object.defineProperty;var G=(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)=>G(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function k(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 j={limit:5,duration:10},A=new Map;function U(n,t){const e=Date.now(),a=t.duration*1e3;let r=A.get(n);r||(r={timestamps:[]},A.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 I(n,t){const e=A.get(n);if(!e||e.timestamps.length<t.limit)return 0;const a=Date.now(),r=t.duration*1e3,l=[...e.timestamps].sort((u,p)=>u-p)[0]+r-a;return Math.max(0,l)}const b={duration:5,message:"Request timed out"};async function H(n,t){const{duration:e,message:a}=t;return Promise.race([n,new Promise((r,i)=>{const s=setTimeout(()=>{clearTimeout(s),i(new Error(a))},e*1e3)})])}const q={page:1,pageParam:"page",limit:10,limitParam:"limit"};class F{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,"timeout",!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={...j,...t},this));o(this,"withTimeout",(t=b.duration,e=b.message)=>(this.timeout={duration:t,message:e},this));this.type=t,this.name=k(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={...q,...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 y=g;function W(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 J(n,t,e){const a=`${n.toString()}${JSON.stringify(t)}`,r=W(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 S{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o(S,"_callbacks",new Map);const _={};function V(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 P=0;P<i.length;P++){const $=i[P];if(s=c.i.getApi($),s)break}if(!t||!s||t.type!=="route"||s.type!=="api")throw new Error(`Invalid path: ${n}.${t.name}`);let l=Q(`${s.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:P="page",limit:$=10,limitParam:K="limit"}=t.pagination,T=new URLSearchParams;T.append(P,String(e)),T.append(K,String($));const L=l.includes("?")?"&":"?";l=`${l}${L}${T.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:p,beforeApi:C,beforeUrl:E,beforeConfig:h}=X({route:t,api:s,url:l,config:u});l=E,u=h,c.updateElement(C),c.updateElement(p);let m=await B(s,t,l,u);t.schema&&"validate"in t.schema&&(m=await t.schema.validate(m));const{afterRoute:d,afterApi:w,afterData:D}=Y({route:t,api:s,response:m,data:m});return c.updateElement(w),c.updateElement(d),S.run(`${s.name}.${t.name}`),D}async function z(n,t,e,a){return n?await J(t,e,a.cache):await(await fetch(t,e)).json()}async function B(n,t,e,a){var C,E;const r=n.cache||t.cache,i=t.retry||n.retry||0,s=t.timeout||n.timeout;if(t.rate){const h=`${n.name}.${t.name}`;if(!U(h,t.rate)){const d=I(h,t.rate),w=Math.ceil(d/1e3);throw new Error(`Rate limit exceeded for ${h}. Try again in ${w} seconds.`)}}else if(n.rate){const h=`${n.name}`;if(!U(h,n.rate)){const d=I(h,n.rate),w=Math.ceil(d/1e3);throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${w} seconds.`)}}let l,u=!1,p=0;for(;p<=i&&!u;)try{(C=t.callbacks)!=null&&C.call?t.callbacks.call({}):(E=n.callbacks)!=null&&E.call&&n.callbacks.call({});const h=z(!!r,e,a,n);l=s?await H(h,s):await h,u=!0}catch(h){if(p++,p>i)throw h.message||(h.message=`Failed to fetch ${e} after ${i} attempts`),h}return l}function Q(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 X({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 Y({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 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=_;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=_;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=V(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("."),i=this._elements.get(r);if((i==null?void 0:i.type)==="api")return i}}};o(f,"_instance");let c=f;class R extends F{static create(t,e,a,r={}){const i=k(t);i!==t&&console.warn(`API name "${t}" has been camelCased to "${i}"`);const s=new R(i,e,r),l=c.i.getCurrentParent();c.i.registerElement(s);const u=l?c.i.getFullPath(l):"",p=u?`${u}.${i}`:i;return c.i.setCurrentParent(p),a(),l?c.i.setCurrentParent(c.i.getFullPath(l)):c.i.clearCurrentParent(),s}constructor(t,e,a={}){super("api",t,e,a)}}class v extends F{static create(t,e){const a=k(t),r=c.i.getCurrentParent(),i=r?c.i.getFullPath(r):"",s=i?`${i}.${a}`:a,l=new v(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}withTimeout(t=b.duration,e=b.message){return super.withTimeout(t,e),c.i.getChildren(c.i.getFullPath(this)).forEach(a=>{a.timeout||(a.timeout={duration:t,message:e})}),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 N extends F{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 N(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=R;exports.Group=v;exports.Hook=S;exports.Klaim=_;exports.Registry=c;exports.Route=N;

package/dist/klaim.es.js

@@ -1,40 +1,55 @@
-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 = Object.defineProperty;
+var G = (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) => G(n, typeof t != "symbol" ? t + "" : t, e);
-function A(n) {
+function _(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 = {
+const j = {
   limit: 5,
   duration: 10
   // seconds
-}, b = /* @__PURE__ */ new Map();
-function k(n, t) {
+}, A = /* @__PURE__ */ new Map();
+function F(n, t) {
   const e = Date.now(), a = t.duration * 1e3;
-  let r = b.get(n);
-  r || (r = { timestamps: [] }, b.set(n, r));
+  let r = A.get(n);
+  r || (r = { timestamps: [] }, A.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);
+function S(n, t) {
+  const e = A.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;
+  const a = Date.now(), r = t.duration * 1e3, l = [...e.timestamps].sort((u, p) => u - p)[0] + r - a;
   return Math.max(0, l);
 }
-const j = {
+const $ = {
+  duration: 5,
+  message: "Request timed out"
+};
+async function q(n, t) {
+  const { duration: e, message: a } = t;
+  return Promise.race([
+    n,
+    new Promise((r, i) => {
+      const s = setTimeout(() => {
+        clearTimeout(s), i(new Error(a));
+      }, e * 1e3);
+    })
+  ]);
+}
+const H = {
   page: 1,
   pageParam: "page",
   limit: 10,
   limitParam: "limit"
 };
-class T {
+class k {
   /**
    * Creates a new element with the specified properties
    * @param {("api"|"route"|"group")} type - Element type identifier
@@ -60,6 +75,7 @@ class T {
     o(this, "cache", !1);
     o(this, "retry", !1);
     o(this, "rate", !1);
+    o(this, "timeout", !1);
     /**
      * Enables response caching for this element
      * @param {number} [duration=20] - Cache duration in seconds
@@ -82,10 +98,17 @@ class T {
      * ```
      */
     o(this, "withRate", (t = {}) => (this.rate = {
-      ...O,
+      ...j,
       ...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 || {};
+    /**
+     * Enables request timeout for this element
+     * @param {number} [duration] - Timeout duration in seconds
+     * @param {string} [message] - Custom error message
+     * @returns {this} The element instance for chaining
+     */
+    o(this, "withTimeout", (t = $.duration, e = $.message) => (this.timeout = { duration: t, message: e }, this));
+    this.type = t, this.name = _(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
@@ -127,12 +150,12 @@ class T {
    */
   withPagination(t = {}) {
     return this.pagination = {
-      ...j,
+      ...H,
       ...t
     }, this;
   }
 }
-const d = class d {
+const g = class g {
   /**
    * Private constructor to enforce singleton pattern.
    * Initializes an empty cache storage.
@@ -160,7 +183,7 @@ const d = class d {
    * ```
    */
   static get i() {
-    return d._instance || (d._instance = new d()), d._instance;
+    return g._instance || (g._instance = new g()), g._instance;
   }
   /**
    * Stores a value in the cache with an optional time-to-live duration.
@@ -223,9 +246,9 @@ const d = class d {
  *
  * @private
  */
-o(d, "_instance");
-let P = d;
-function H(n) {
+o(g, "_instance");
+let y = g;
+function W(n) {
   let a = 2166136261;
   for (let i = 0; i < n.length; i++)
     a ^= n.charCodeAt(i), a *= 16777619;
@@ -234,14 +257,14 @@ function H(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 W(n, t, e) {
-  const a = `${n.toString()}${JSON.stringify(t)}`, r = H(a);
-  if (P.i.has(r))
-    return P.i.get(r);
+async function J(n, t, e) {
+  const a = `${n.toString()}${JSON.stringify(t)}`, r = W(a);
+  if (y.i.has(r))
+    return y.i.get(r);
   const s = await (await fetch(n, t)).json();
-  return P.i.set(r, s, e), s;
+  return y.i.set(r, s, e), s;
 }
-class R {
+class v {
   /**
    * Registers a callback function for a specific route.
    * If a callback already exists for the route, it will be replaced.
@@ -283,86 +306,88 @@ class R {
  *
  * @private
  */
-o(R, "_callbacks", /* @__PURE__ */ new Map());
-const F = {};
-function q(n, t) {
+o(v, "_callbacks", /* @__PURE__ */ new Map());
+const R = {};
+function V(n, t) {
   return async (...e) => {
     if (t.pagination) {
       const [i = 0, s = {}, l = {}] = e;
-      return S(n, t, i, s, l);
+      return N(n, t, i, s, l);
     }
     const [a = {}, r = {}] = e;
-    return S(n, t, void 0, a, r);
+    return N(n, t, void 0, a, r);
   };
 }
-async function S(n, t, e, a = {}, r = {}) {
+async function N(n, t, e, a = {}, r = {}) {
   const i = n.split(".");
   let s;
-  for (let w = 0; w < i.length; w++) {
-    const E = i[w];
-    if (s = c.i.getApi(E), s) break;
+  for (let P = 0; P < i.length; P++) {
+    const b = i[P];
+    if (s = c.i.getApi(b), 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);
+  let l = Q(`${s.url}/${t.url}`, t, a);
   if (t.pagination && typeof e < "u") {
-    const { pageParam: w = "page", limit: E = 10, limitParam: I = "limit" } = t.pagination, $ = new URLSearchParams();
-    $.append(w, String(e)), $.append(I, String(E));
+    const { pageParam: P = "page", limit: b = 10, limitParam: L = "limit" } = t.pagination, T = new URLSearchParams();
+    T.append(P, String(e)), T.append(L, String(b));
     const K = l.includes("?") ? "&" : "?";
-    l = `${l}${K}${$.toString()}`;
+    l = `${l}${K}${T.toString()}`;
   }
-  let h = {};
-  r && t.method !== "GET" && (h.body = JSON.stringify(r)), h.headers = {
+  let u = {};
+  r && t.method !== "GET" && (u.body = JSON.stringify(r)), u.headers = {
     "Content-Type": "application/json",
     ...s.headers,
     ...t.headers
-  }, h.method = t.method;
+  }, u.method = t.method;
   const {
-    beforeRoute: f,
-    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));
+    beforeRoute: p,
+    beforeApi: C,
+    beforeUrl: E,
+    beforeConfig: h
+  } = X({ route: t, api: s, url: l, config: u });
+  l = E, u = h, c.updateElement(C), c.updateElement(p);
+  let m = await B(s, t, l, u);
+  t.schema && "validate" in t.schema && (m = await t.schema.validate(m));
   const {
-    afterRoute: m,
-    afterApi: U,
+    afterRoute: d,
+    afterApi: w,
     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;
+  } = Y({ route: t, api: s, response: m, data: m });
+  return c.updateElement(w), c.updateElement(d), v.run(`${s.name}.${t.name}`), D;
 }
-async function J(n, t, e, a) {
-  return n ? await W(t, e, a.cache) : await (await fetch(t, e)).json();
+async function z(n, t, e, a) {
+  return n ? await J(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;
+async function B(n, t, e, a) {
+  var C, E;
+  const r = n.cache || t.cache, i = t.retry || n.retry || 0, s = t.timeout || n.timeout;
   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.`);
+    const h = `${n.name}.${t.name}`;
+    if (!F(h, t.rate)) {
+      const d = S(h, t.rate), w = Math.ceil(d / 1e3);
+      throw new Error(`Rate limit exceeded for ${h}. Try again in ${w} 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.`);
+    const h = `${n.name}`;
+    if (!F(h, n.rate)) {
+      const d = S(h, n.rate), w = Math.ceil(d / 1e3);
+      throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${w} seconds.`);
     }
   }
-  let s, l = !1, h = 0;
-  for (; h <= i && !l; )
+  let l, u = !1, p = 0;
+  for (; p <= i && !u; )
     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 (u) {
-      if (h++, h > i)
-        throw u.message = `Failed to fetch ${e} after ${i} attempts`, u;
+      (C = t.callbacks) != null && C.call ? t.callbacks.call({}) : (E = n.callbacks) != null && E.call && n.callbacks.call({});
+      const h = z(!!r, e, a, n);
+      l = s ? await q(h, s) : await h, u = !0;
+    } catch (h) {
+      if (p++, p > i)
+        throw h.message || (h.message = `Failed to fetch ${e} after ${i} attempts`), h;
     }
-  return s;
+  return l;
 }
-function z(n, t, e) {
+function Q(n, t, e) {
   let a = n;
   return t.arguments.forEach((r) => {
     if (e[r] === void 0)
@@ -370,7 +395,7 @@ function z(n, t, e) {
     a = a.replace(`[${r}]`, e[r]);
   }), a;
 }
-function B({ route: n, api: t, url: e, config: a }) {
+function X({ 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 {
@@ -380,7 +405,7 @@ function B({ route: n, api: t, url: e, config: a }) {
     beforeConfig: (r == null ? void 0 : r.config) || a
   };
 }
-function Q({ route: n, api: t, response: e, data: a }) {
+function Y({ 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 {
@@ -390,7 +415,7 @@ function Q({ route: n, api: t, response: e, data: a }) {
     afterData: (r == null ? void 0 : r.data) || a
   };
 }
-const p = class p {
+const f = class f {
   constructor() {
     /**
      * Map storing all registered elements with their full paths as keys
@@ -408,7 +433,7 @@ const p = class p {
    * @returns The singleton Registry instance
    */
   static get i() {
-    return p._instance || (p._instance = new p()), p._instance;
+    return f._instance || (f._instance = new f()), f._instance;
   }
   /**
    * Registers a new element in the registry and updates the Klaim object structure
@@ -425,7 +450,7 @@ const p = class p {
     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 = F;
+      let r = R;
       if (e) {
         const i = this.getFullPath(e).split(".");
         for (const s of i)
@@ -480,11 +505,11 @@ const p = class p {
    */
   addToKlaimRoute(t) {
     if (!t.parent) return;
-    let e = F;
+    let e = R;
     const a = t.parent.split(".");
     for (const r of a)
       e[r] || (e[r] = {}), e = e[r];
-    e[t.name] = q(t.parent, t);
+    e[t.name] = V(t.parent, t);
   }
   /**
    * Generates a unique key for an element based on its path
@@ -542,7 +567,7 @@ const p = class p {
    * @returns The updated element
    */
   static updateElement(t) {
-    return p.i._elements.get(p.i.getElementKey(t)) || t;
+    return f.i._elements.get(f.i.getElementKey(t)) || t;
   }
   /**
    * Retrieves an API element by name, searching through the entire registry if necessary
@@ -576,9 +601,9 @@ const p = class p {
     }
   }
 };
-o(p, "_instance");
-let c = p;
-class v extends T {
+o(f, "_instance");
+let c = f;
+class U extends k {
   /**
    * Creates and registers a new API instance with the given configuration
    *
@@ -598,12 +623,12 @@ class v extends T {
    * ```
    */
   static create(t, e, a, r = {}) {
-    const i = A(t);
+    const i = _(t);
     i !== t && console.warn(`API name "${t}" has been camelCased to "${i}"`);
-    const s = new v(i, e, r), l = c.i.getCurrentParent();
+    const s = new U(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;
+    const u = l ? c.i.getFullPath(l) : "", p = u ? `${u}.${i}` : i;
+    return c.i.setCurrentParent(p), a(), l ? c.i.setCurrentParent(c.i.getFullPath(l)) : c.i.clearCurrentParent(), s;
   }
   /**
    * Creates a new API instance
@@ -618,7 +643,7 @@ class v extends T {
     super("api", t, e, a);
   }
 }
-class N extends T {
+class x extends k {
   /**
    * Creates a new group and registers it in the Registry.
    * Supports nested groups and inheritable configurations.
@@ -644,10 +669,10 @@ class N extends T {
    * ```
    */
   static create(t, e) {
-    const a = A(t), r = c.i.getCurrentParent(), i = r ? c.i.getFullPath(r) : "", s = i ? `${i}.${a}` : a, l = new N(a, "");
+    const a = _(t), r = c.i.getCurrentParent(), i = r ? c.i.getFullPath(r) : "", s = i ? `${i}.${a}` : a, l = new x(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;
+    const u = c.i.getCurrentParent();
+    return c.i.setCurrentParent(s), e(), u ? c.i.setCurrentParent(c.i.getFullPath(u)) : c.i.clearCurrentParent(), l;
   }
   /**
    * Creates a new Group instance.
@@ -701,6 +726,15 @@ class N extends T {
       e.retry || (e.retry = t);
     }), this;
   }
+  /**
+   * Enables request timeout for the group and its children.
+   * Children can override with their own timeout configuration.
+   */
+  withTimeout(t = $.duration, e = $.message) {
+    return super.withTimeout(t, e), c.i.getChildren(c.i.getFullPath(this)).forEach((a) => {
+      a.timeout || (a.timeout = { duration: t, message: e });
+    }), this;
+  }
   /**
    * Adds a before-request middleware to the group and all its children.
    * Children can override this middleware with their own.
@@ -768,7 +802,7 @@ class N extends T {
     }), this;
   }
 }
-class x extends T {
+class I extends k {
   /**
    * Creates a new Route instance.
    *
@@ -791,7 +825,7 @@ class x extends T {
    * @private
    */
   static createRoute(t, e, a = {}, r) {
-    const i = new x(t, e, a, r);
+    const i = new I(t, e, a, r);
     return c.i.registerRoute(i), i;
   }
   /**
@@ -951,10 +985,10 @@ class x extends T {
   }
 }
 export {
-  v as Api,
-  N as Group,
-  R as Hook,
-  F as Klaim,
+  U as Api,
+  x as Group,
+  v as Hook,
+  R as Klaim,
   c as Registry,
-  x as Route
+  I as Route
 };

package/dist/klaim.umd.js

@@ -1 +1 @@
-(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"})});
+(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 Y=Object.defineProperty;var Z=(u,p,w)=>p in u?Y(u,p,{enumerable:!0,configurable:!0,writable:!0,value:w}):u[p]=w;var o=(u,p,w)=>Z(u,typeof p!="symbol"?p+"":p,w);function p(n){return n.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function w(n){return n.trim().replace(/^\/|\/$/g,"")}const O={limit:5,duration:10},k=new Map;function D(n,t){const e=Date.now(),a=t.duration*1e3;let r=k.get(n);r||(r={timestamps:[]},k.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 K(n,t){const e=k.get(n);if(!e||e.timestamps.length<t.limit)return 0;const a=Date.now(),r=t.duration*1e3,l=[...e.timestamps].sort((h,g)=>h-g)[0]+r-a;return Math.max(0,l)}const $={duration:5,message:"Request timed out"};async function G(n,t){const{duration:e,message:a}=t;return Promise.race([n,new Promise((r,i)=>{const s=setTimeout(()=>{clearTimeout(s),i(new Error(a))},e*1e3)})])}const M={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,"rate",!1);o(this,"timeout",!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));o(this,"withTimeout",(t=$.duration,e=$.message)=>(this.timeout={duration:t,message:e},this));this.type=t,this.name=p(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=w(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={...M,...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 y=d;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 j(n,t,e){const a=`${n.toString()}${JSON.stringify(t)}`,r=x(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 F{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}o(F,"_callbacks",new Map);const S={};function H(n,t){return async(...e)=>{if(t.pagination){const[i=0,s={},l={}]=e;return L(n,t,i,s,l)}const[a={},r={}]=e;return L(n,t,void 0,a,r)}}async function L(n,t,e,a={},r={}){const i=n.split(".");let s;for(let b=0;b<i.length;b++){const U=i[b];if(s=c.i.getApi(U),s)break}if(!t||!s||t.type!=="route"||s.type!=="api")throw new Error(`Invalid path: ${n}.${t.name}`);let l=J(`${s.url}/${t.url}`,t,a);if(t.pagination&&typeof e<"u"){const{pageParam:b="page",limit:U=10,limitParam:Q="limit"}=t.pagination,I=new URLSearchParams;I.append(b,String(e)),I.append(Q,String(U));const X=l.includes("?")?"&":"?";l=`${l}${X}${I.toString()}`}let h={};r&&t.method!=="GET"&&(h.body=JSON.stringify(r)),h.headers={"Content-Type":"application/json",...s.headers,...t.headers},h.method=t.method;const{beforeRoute:g,beforeApi:T,beforeUrl:A,beforeConfig:f}=V({route:t,api:s,url:l,config:h});l=A,h=f,c.updateElement(T),c.updateElement(g);let P=await W(s,t,l,h);t.schema&&"validate"in t.schema&&(P=await t.schema.validate(P));const{afterRoute:C,afterApi:E,afterData:B}=z({route:t,api:s,response:P,data:P});return c.updateElement(E),c.updateElement(C),F.run(`${s.name}.${t.name}`),B}async function q(n,t,e,a){return n?await j(t,e,a.cache):await(await fetch(t,e)).json()}async function W(n,t,e,a){var T,A;const r=n.cache||t.cache,i=t.retry||n.retry||0,s=t.timeout||n.timeout;if(t.rate){const f=`${n.name}.${t.name}`;if(!D(f,t.rate)){const C=K(f,t.rate),E=Math.ceil(C/1e3);throw new Error(`Rate limit exceeded for ${f}. Try again in ${E} seconds.`)}}else if(n.rate){const f=`${n.name}`;if(!D(f,n.rate)){const C=K(f,n.rate),E=Math.ceil(C/1e3);throw new Error(`Rate limit exceeded for ${n.name} API. Try again in ${E} seconds.`)}}let l,h=!1,g=0;for(;g<=i&&!h;)try{(T=t.callbacks)!=null&&T.call?t.callbacks.call({}):(A=n.callbacks)!=null&&A.call&&n.callbacks.call({});const f=q(!!r,e,a,n);l=s?await G(f,s):await f,h=!0}catch(f){if(g++,g>i)throw f.message||(f.message=`Failed to fetch ${e} after ${i} attempts`),f}return l}function J(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 V({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 z({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 m=class m{constructor(){o(this,"_elements",new Map);o(this,"_currentParent",null)}static get i(){return m._instance||(m._instance=new m),m._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=S;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=S;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=H(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 m.i._elements.get(m.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(m,"_instance");let c=m;class R extends _{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 R(i,e,r),l=c.i.getCurrentParent();c.i.registerElement(s);const h=l?c.i.getFullPath(l):"",g=h?`${h}.${i}`:i;return c.i.setCurrentParent(g),a(),l?c.i.setCurrentParent(c.i.getFullPath(l)):c.i.clearCurrentParent(),s}constructor(t,e,a={}){super("api",t,e,a)}}class v extends _{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 v(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}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}withTimeout(t=$.duration,e=$.message){return super.withTimeout(t,e),c.i.getChildren(c.i.getFullPath(this)).forEach(a=>{a.timeout||(a.timeout={duration:t,message:e})}),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 N 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 N(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}}u.Api=R,u.Group=v,u.Hook=F,u.Klaim=S,u.Registry=c,u.Route=N,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "klaim",
-    "version": "1.9.39",
+    "version": "1.10.0",
     "author": "antharuu",
     "repository": {
         "type": "git",
@@ -13,12 +13,12 @@
         "@stylistic/eslint-plugin": "4.4.1",
         "@types/bun": "^1.2.15",
         "@types/eslint__js": "9.14.0",
-        "@types/node": "^22.15.30",
+        "@types/node": "^24.0.1",
         "@vitest/coverage-v8": "^3.2.3",
         "@vitest/ui": "^3.2.3",
         "dotenv-cli": "^8.0.0",
         "eslint": "9.28.0",
-        "eslint-plugin-jsdoc": "50.7.1",
+        "eslint-plugin-jsdoc": "50.8.0",
         "eslint-plugin-simple-import-sort": "12.1.1",
         "jsdom": "^26.1.0",
         "release-it": "^19.0.3",

package/src/core/Element.ts

@@ -1,6 +1,7 @@
 import cleanUrl from "../tools/cleanUrl";
 import toCamelCase from "../tools/toCamelCase";
 import { IRateLimitConfig, DEFAULT_RATE_LIMIT_CONFIG } from "../tools/rateLimit";
+import { ITimeoutConfig, DEFAULT_TIMEOUT_CONFIG } from "../tools/timeout";
 
 /**
  * Type definition for HTTP headers
@@ -97,8 +98,10 @@ 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;
+        /** Rate limiting configuration, or false if rate limiting is disabled */
+        rate: false | IRateLimitConfig;
+        /** Request timeout configuration, or false if disabled */
+        timeout: false | ITimeoutConfig;
 	/** Reference to parent element name */
 	parent?: string;
 	/** HTTP method for routes */
@@ -128,8 +131,11 @@ export interface IElement {
 	/** Configures pagination settings */
 	withPagination(config?: IPaginationConfig): this;
 
-	/** Enables rate limiting */
-	withRate(config?: Partial<IRateLimitConfig>): this;
+        /** Enables rate limiting */
+        withRate(config?: Partial<IRateLimitConfig>): this;
+
+        /** Enables request timeout */
+        withTimeout(duration?: number, message?: string): this;
 }
 
 /**
@@ -166,9 +172,10 @@ export abstract class Element implements IElement {
 		call: null
 	};
 
-	public cache: false | number = false;
-	public retry: false | number = false;
-	public rate: false | IRateLimitConfig = false;
+        public cache: false | number = false;
+        public retry: false | number = false;
+        public rate: false | IRateLimitConfig = false;
+        public timeout: false | ITimeoutConfig = false;
 
 	/**
 	 * Creates a new element with the specified properties
@@ -274,11 +281,25 @@ export abstract class Element implements IElement {
 	 * 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;
-	};
+        public withRate = (config: Partial<IRateLimitConfig> = {}): this => {
+                this.rate = {
+                        ...DEFAULT_RATE_LIMIT_CONFIG,
+                        ...config
+                };
+                return this;
+        };
+
+        /**
+         * Enables request timeout for this element
+         * @param {number} [duration] - Timeout duration in seconds
+         * @param {string} [message] - Custom error message
+         * @returns {this} The element instance for chaining
+         */
+        public withTimeout = (
+                duration: number = DEFAULT_TIMEOUT_CONFIG.duration,
+                message: string = DEFAULT_TIMEOUT_CONFIG.message
+        ): this => {
+                this.timeout = { duration, message };
+                return this;
+        };
 }

package/src/core/Group.ts

@@ -1,6 +1,7 @@
 import toCamelCase from "../tools/toCamelCase";
 
 import { Element, ICallback, ICallbackAfterArgs, ICallbackBeforeArgs, ICallbackCallArgs, IHeaders } from "./Element";
+import { DEFAULT_TIMEOUT_CONFIG } from "../tools/timeout";
 import { Registry } from "./Registry";
 
 /**
@@ -163,6 +164,21 @@ export class Group extends Element {
         return this;
     }
 
+    /**
+     * Enables request timeout for the group and its children.
+     * Children can override with their own timeout configuration.
+     */
+    public withTimeout(duration = DEFAULT_TIMEOUT_CONFIG.duration, message = DEFAULT_TIMEOUT_CONFIG.message): this {
+        super.withTimeout(duration, message);
+        Registry.i.getChildren(Registry.i.getFullPath(this))
+            .forEach(child => {
+                if (!child.timeout) {
+                    child.timeout = { duration, message };
+                }
+            });
+        return this;
+    }
+
     /**
      * Adds a before-request middleware to the group and all its children.
      * Children can override this middleware with their own.

package/src/core/Klaim.ts

@@ -1,5 +1,6 @@
 import fetchWithCache from "../tools/fetchWithCache";
 import { checkRateLimit, getTimeUntilNextRequest } from "../tools/rateLimit";
+import { withTimeout } from "../tools/timeout";
 import {IElement} from "./Element";
 import {Hook} from "./Hook";
 import {Registry} from "./Registry";
@@ -204,8 +205,9 @@ async function fetchWithRetry(
 	url: string,
 	config: any
 ): Promise<any> {
-	const withCache = api.cache || route.cache;
-	const maxRetries = (route.retry || api.retry) || 0;
+        const withCache = api.cache || route.cache;
+        const maxRetries = (route.retry || api.retry) || 0;
+        const timeoutCfg = route.timeout || api.timeout;
 	
 	// Check rate limiting
 	// Si la route a sa propre configuration de limite, on l'utilise avec une clé spécifique à la route
@@ -242,15 +244,18 @@ async function fetchWithRetry(
 			} else if (api.callbacks?.call) {
 				api.callbacks.call({});
 			}
-			response = await fetchData(!!withCache, url, config, api);
+                        const fetchPromise = fetchData(!!withCache, url, config, api);
+                        response = timeoutCfg ? await withTimeout(fetchPromise, timeoutCfg) : await fetchPromise;
 			success = true;
-		} catch (error: any) {
-			attempt++;
-			if (attempt > maxRetries) {
-				error.message = `Failed to fetch ${url} after ${maxRetries} attempts`;
-				throw error;
-			}
-		}
+                } catch (error: any) {
+                        attempt++;
+                        if (attempt > maxRetries) {
+                                if (!error.message) {
+                                        error.message = `Failed to fetch ${url} after ${maxRetries} attempts`;
+                                }
+                                throw error;
+                        }
+                }
 	}
 
 	return response;

package/src/tools/timeout.ts

@@ -0,0 +1,22 @@
+export interface ITimeoutConfig {
+    duration: number; // seconds
+    message: string;
+}
+
+export const DEFAULT_TIMEOUT_CONFIG: ITimeoutConfig = {
+    duration: 5,
+    message: 'Request timed out'
+};
+
+export async function withTimeout<T>(promise: Promise<T>, config: ITimeoutConfig): Promise<T> {
+    const { duration, message } = config;
+    return Promise.race([
+        promise,
+        new Promise<T>((_, reject) => {
+            const id = setTimeout(() => {
+                clearTimeout(id);
+                reject(new Error(message));
+            }, duration * 1000);
+        })
+    ]);
+}

package/tests/11.timeout.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import { Api, Klaim, Route } from "../src";
+
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+
+describe("Timeout", () => {
+    it("should throw on timeout", async () => {
+        global.fetch = vi.fn(() =>
+            new Promise(resolve => {
+                setTimeout(() => resolve({ json: () => Promise.resolve({ ok: true }) }), 200);
+            })
+        ) as any;
+
+        const apiName = "timeoutApi";
+        const apiUrl = "https://example.com";
+        const routeName = "slow";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName, "/slow").withTimeout(0.05);
+        });
+
+        await expect(Klaim[apiName][routeName]()).rejects.toThrow(/Request timed out/);
+    });
+
+    it("should use custom message", async () => {
+        global.fetch = vi.fn(() =>
+            new Promise(resolve => {
+                setTimeout(() => resolve({ json: () => Promise.resolve({ ok: true }) }), 200);
+            })
+        ) as any;
+
+        const apiName = "timeoutApi2";
+        const apiUrl = "https://example.com";
+        const routeName = "slow2";
+
+        Api.create(apiName, apiUrl, () => {
+            Route.get(routeName, "/slow").withTimeout(0.05, "Too slow");
+        });
+
+        await expect(Klaim[apiName][routeName]()).rejects.toThrow(/Too slow/);
+    });
+});