klaim 1.7.51 → 1.8.0

package/.github/workflows/update-minor.yml

@@ -0,0 +1,55 @@
+name: Manual Minor Update & Release
+
+on:
+    workflow_dispatch:
+
+jobs:
+    update-and-release-minor:
+        runs-on: ubuntu-latest
+        permissions:
+            id-token: write
+            contents: write
+            packages: write
+        steps:
+            -   uses: actions/checkout@v4
+                with:
+                    fetch-depth: 0
+                    token: ${{ secrets.GITHUB_TOKEN }}
+
+            -   name: Setup Node.js
+                uses: actions/setup-node@v4
+                with:
+                    node-version: '20'
+                    registry-url: 'https://registry.npmjs.org'
+
+            -   name: Configure NPM Authentication
+                run: |
+                    echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
+                    npm whoami
+                env:
+                    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+            -   name: Configure Git
+                run: |
+                    git config --global user.email "github-actions[bot]@users.noreply.github.com"
+                    git config --global user.name "GitHub Actions Bot"
+
+            -   name: Install dependencies
+                run: npm install
+
+            -   name: Update ALL dependencies
+                run: |
+                    npx npm-check-updates -u
+                    npm install
+
+            -   name: Test and build
+                run: |
+                    npm run test
+                    npm run build
+
+            -   name: Release Minor
+                run: npm run release:minor
+                env:
+                    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+                    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+                    NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -37,10 +37,10 @@
 - **Retry Mechanism**: Automatically retry failed requests to enhance reliability.
 - **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
 
-- Pagination (Version: 1.8)
 - Rate Limiting (Version: 1.9)
 - Login (Version: 1.10)
 - Time Out (Version: 1.11)
@@ -73,55 +73,57 @@ 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");
 });
 ```
 
 ### Route Definition
 
-Routes represent endpoints in your API and can be defined with different HTTP methods. Routes can include parameters and custom configurations:
+Routes represent endpoints in your API and can be defined with different HTTP methods. Routes can include parameters and
+custom configurations:
 
 ```typescript
 Api.create("api", "https://api.example.com", () => {
-    // Basic GET route
-    Route.get("listUsers", "/users");
-    
-    // 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" });
-    
-    // PUT route with parameter
-    Route.put("updateUser", "/users/[id]");
-    
-    // DELETE route
-    Route.delete("deleteUser", "/users/[id]");
-    
-    // PATCH route
-    Route.patch("updateUserStatus", "/users/[id]/status");
-    
-    // OPTIONS route
-    Route.options("userOptions", "/users");
+	// Basic GET route
+	Route.get("listUsers", "/users");
+
+	// 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"});
+
+	// PUT route with parameter
+	Route.put("updateUser", "/users/[id]");
+
+	// DELETE route
+	Route.delete("deleteUser", "/users/[id]");
+
+	// PATCH route
+	Route.patch("updateUserStatus", "/users/[id]/status");
+
+	// OPTIONS route
+	Route.options("userOptions", "/users");
 });
 ```
 
 ### Groups
 
-Klaim provides powerful grouping capabilities for both APIs and routes. Groups can be used to organize related elements, share configuration, and maintain a clean structure in your application.
+Klaim provides powerful grouping capabilities for both APIs and routes. Groups can be used to organize related elements,
+share configuration, and maintain a clean structure in your application.
 
 #### API Groups
 
@@ -132,21 +134,21 @@ 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
-await Klaim.userServices.auth.login({}, { username: "user", password: "pass" });
+await Klaim.userServices.auth.login({}, {username: "user", password: "pass"});
 await Klaim.userServices.users.list();
 ```
 
@@ -156,23 +158,23 @@ 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
 const users = await Klaim.hello.users.list();
-const product = await Klaim.hello.products.getOne({ id: 1 });
+const product = await Klaim.hello.products.getOne({id: 1});
 ```
 
 #### Nested Groups
@@ -181,32 +183,32 @@ 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
-await Klaim.services.internal.logs.write({}, { message: "Log entry" });
-await Klaim.services.external.weather.forecast({ city: "Paris" });
+await Klaim.services.internal.logs.write({}, {message: "Log entry"});
+await Klaim.services.external.weather.forecast({city: "Paris"});
 ```
 
 #### Group Configuration
@@ -215,22 +217,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("service2", "https://api2.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");
+	});
 })
-    .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
@@ -258,16 +260,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}));
 });
 ```
 
@@ -281,7 +283,7 @@ import {Hook} from 'klaim';
 
 // Subscribe to the "hello.getFirstTodo" hook
 Hook.subscribe("hello.getFirstTodo", ({url}) => {
-    console.log(`Requesting ${url}`);
+	console.log(`Requesting ${url}`);
 });
 ```
 
@@ -296,14 +298,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");
 });
 ```
 
@@ -315,10 +317,10 @@ 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
 ```
 
@@ -333,14 +335,14 @@ Enable retry on individual routes:
 
 ```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 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);
+	// Get a specific todo by id with retry mechanism (specified to 5)
+	Route.get<Todo>("getTodo", "todos/[id]").withRetry(5);
 
-    // Add a new todo (no retry)
-    Route.post<Todo>("addTodo", "todos");
+	// Add a new todo (no retry)
+	Route.post<Todo>("addTodo", "todos");
 });
 ```
 
@@ -350,10 +352,10 @@ Enable retry 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");
 }).withRetry();
 ```
 
@@ -376,15 +378,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
@@ -394,6 +396,30 @@ const todoFail = await Klaim.hello.getTodo<Todo>({id: 15});
 const todo = await Klaim.hello.getTodo<Todo>({id: 1});
 ```
 
+### Pagination
+
+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
+});
+
+// Using paginated endpoints
+const page1 = await Klaim.api.list();        // First page
+const page2 = await Klaim.api.list(2);       // Second page
+const customPage = await Klaim.api.list(5);  // Fifth page
+```
+
+⚠️ **Note**: The pagination feature simplifies your pagination parameters, but your API/backend needs to respond to these
+parameters. Klaim does not handle the pagination logic, only the parameters management.
+
 ## 🔗 Links
 
 - [NPM](https://www.npmjs.com/package/klaim)

package/deno.json

@@ -1,6 +1,6 @@
 {
     "name": "@antharuu/klaim",
-    "version": "1.7.51",
+    "version": "1.8.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 R=Object.defineProperty;var v=(s,t,e)=>t in s?R(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e;var l=(s,t,e)=>v(s,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function b(s){return s.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}function K(s){return s.trim().replace(/^\/|\/$/g,"")}class C{constructor(t,e,a,r={}){l(this,"type");l(this,"name");l(this,"url");l(this,"headers");l(this,"parent");l(this,"method");l(this,"arguments",new Set);l(this,"schema");l(this,"callbacks",{before:null,after:null,call:null});l(this,"cache",!1);l(this,"retry",!1);this.type=t,this.name=b(e),this.name!==e&&console.warn(`Name "${e}" has been camelCased to "${this.name}"`),this.url=K(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}withCache(t=20){return this.cache=t,this}withRetry(t=2){return this.retry=t,this}}const p=class p{constructor(){l(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}};l(p,"_instance");let g=p;function N(s){let a=2166136261;for(let n=0;n<s.length;n++)a^=s.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 j(s,t,e){const a=`${s.toString()}${JSON.stringify(t)}`,r=N(a);if(g.i.has(r))return g.i.get(r);const c=await(await fetch(s,t)).json();return g.i.set(r,c,e),c}class E{static subscribe(t,e){this._callbacks.set(t,e)}static run(t){const e=this._callbacks.get(t);e&&e()}}l(E,"_callbacks",new Map);const m={};async function x(s,t,e={},a={}){const r=s.split(".");let n;for(let y=0;y<r.length;y++){const T=r[y];if(n=i.i.getApi(T),n)break}if(!t||!n||t.type!=="route"||n.type!=="api")throw new Error(`Invalid path: ${s}.${t.name}`);let c=O(`${n.url}/${t.url}`,t,e),o={};a&&t.method!=="GET"&&(o.body=JSON.stringify(a)),o.headers={"Content-Type":"application/json",...n.headers,...t.headers},o.method=t.method;const{beforeRoute:u,beforeApi:f,beforeUrl:d,beforeConfig:P}=U({route:t,api:n,url:c,config:o});c=d,o=P,i.updateElement(f),i.updateElement(u);let w=await G(n,t,c,o);t.schema&&"validate"in t.schema&&(w=await t.schema.validate(w));const{afterRoute:_,afterApi:F,afterData:S}=H({route:t,api:n,response:w,data:w});return i.updateElement(F),i.updateElement(_),E.run(`${n.name}.${t.name}`),S}async function D(s,t,e,a){return s?await j(t,e,a.cache):await(await fetch(t,e)).json()}async function G(s,t,e,a){var f,d;const r=s.cache||t.cache,n=t.retry||s.retry||0;let c,o=!1,u=0;for(;u<=n&&!o;)try{(f=t.callbacks)!=null&&f.call?t.callbacks.call({}):(d=s.callbacks)!=null&&d.call&&s.callbacks.call({}),c=await D(!!r,e,a,s),o=!0}catch(P){if(u++,u>n)throw P.message=`Failed to fetch ${e} after ${n} attempts`,P}return c}function O(s,t,e){let a=s;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 U({route:s,api:t,url:e,config:a}){var n,c;const r=(c=(n=s.callbacks).before)==null?void 0:c.call(n,{route:s,api:t,url:e,config:a});return{beforeRoute:(r==null?void 0:r.route)||s,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:s,api:t,response:e,data:a}){var n,c;const r=(c=(n=s.callbacks).after)==null?void 0:c.call(n,{route:s,api:t,response:e,data:a});return{afterRoute:(r==null?void 0:r.route)||s,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(){l(this,"_elements",new Map);l(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=m;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=m;const a=t.parent.split(".");for(const r of a)e[r]||(e[r]={}),e=e[r];e[t.name]=function(r={},n={}){return x(t.parent,t,r,n)}}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("."),n=this._elements.get(r);if((n==null?void 0:n.type)==="api")return n}}};l(h,"_instance");let i=h;class $ extends C{static create(t,e,a,r={}){const n=b(t);n!==t&&console.warn(`API name "${t}" has been camelCased to "${n}"`);const c=new $(n,e,r),o=i.i.getCurrentParent();i.i.registerElement(c);const u=o?i.i.getFullPath(o):"",f=u?`${u}.${n}`:n;return i.i.setCurrentParent(f),a(),o?i.i.setCurrentParent(i.i.getFullPath(o)):i.i.clearCurrentParent(),c}constructor(t,e,a={}){super("api",t,e,a)}}class k extends C{static create(t,e){const a=b(t),r=i.i.getCurrentParent(),n=r?i.i.getFullPath(r):"",c=n?`${n}.${a}`:a,o=new k(a,"");a!==t&&console.warn(`Group name "${t}" has been camelCased to "${a}"`),i.i.registerElement(o);const u=i.i.getCurrentParent();return i.i.setCurrentParent(c),e(),u?i.i.setCurrentParent(i.i.getFullPath(u)):i.i.clearCurrentParent(),o}constructor(t,e,a={}){super("group",t,e,a)}withCache(t=20){return super.withCache(t),i.i.getChildren(i.i.getFullPath(this)).forEach(e=>{e.cache||(e.cache=t)}),this}withRetry(t=2){return super.withRetry(t),i.i.getChildren(i.i.getFullPath(this)).forEach(e=>{e.retry||(e.retry=t)}),this}before(t){return super.before(t),i.i.getChildren(i.i.getFullPath(this)).forEach(e=>{e.callbacks.before||(e.callbacks.before=t)}),this}after(t){return super.after(t),i.i.getChildren(i.i.getFullPath(this)).forEach(e=>{e.callbacks.after||(e.callbacks.after=t)}),this}onCall(t){return super.onCall(t),i.i.getChildren(i.i.getFullPath(this)).forEach(e=>{e.callbacks.call||(e.callbacks.call=t)}),this}}class A extends C{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 A(t,e,a,r);return i.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}}exports.Api=$;exports.Group=k;exports.Hook=E;exports.Klaim=m;exports.Registry=i;exports.Route=A;
+"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:T}=J({route:t,api:c,url:l,config:u});l=m,u=T,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:N,afterApi:R,afterData:v}=z({route:t,api:c,response:w,data:w});return s.updateElement(R),s.updateElement(N),A.run(`${c.name}.${t.name}`),v}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=_;