klaim 1.0.6 → 1.1.2

package/README.md

@@ -3,12 +3,18 @@
 Klaim is a lightweight TypeScript library designed to manage APIs and record requests, optimized for an optimal user
 experience.
 
+## Links
+
+- [NPM](https://www.npmjs.com/package/klaim)
+- [GitHub](https://github.com/antharuu/klaim)
+
 ## 🚀 Features
 
 - **Efficient API Management**: Easily manage multiple APIs with streamlined integration and interaction capabilities.
 - **Request Recording**: Seamlessly track requests for debugging and monitoring.
 - **User Experience Optimization**: Focused on performance and usability for a smooth user experience.
 - **Lightweight**: Minimal footprint for fast load times and minimal performance impact.
+- **Middleware Support**: Easily add middleware to modify requests and responses (`before` and `after`).
 - **TypeScript Support**: Fully typed for enhanced code quality and developer experience.
 
 ## 📥 Installation
@@ -49,6 +55,17 @@ Api.create("hello", "https://jsonplaceholder.typicode.com/", () => {
 
     // You can also define routes in post, (put, delete, etc)
     Route.post<Todo>("addTodo", "todos");
+
+    // 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}));
 });
 
 // --- Usage

package/dist/klaim.cjs

@@ -0,0 +1 @@
+"use strict";var C=Object.defineProperty;var $=(a,t,e)=>t in a?C(a,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):a[t]=e;var s=(a,t,e)=>$(a,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function d(a){return a.trim().replace(/^\/|\/$/g,"")}function m(a){return a.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}var A=(a=>(a.GET="GET",a.POST="POST",a.PUT="PUT",a.DELETE="DELETE",a.PATCH="PATCH",a.OPTIONS="OPTIONS",a))(A||{});class p{constructor(t,e,n,r="GET"){s(this,"api","undefined");s(this,"name");s(this,"url");s(this,"method");s(this,"headers");s(this,"arguments",new Set);s(this,"callbacks",{before:null,after:null});this.name=m(t),this.name!==t&&console.warn(`Route name "${t}" has been camelCased to "${this.name}"`),this.url=d(e),this.headers=n||{},this.method=r,this.detectArguments()}static createRoute(t,e,n,r){const i=new p(t,e,n,r);return o.i.registerRoute(i),i}static get(t,e,n={}){return this.createRoute(t,e,n,"GET")}static post(t,e,n){return this.createRoute(t,e,n,"POST")}static put(t,e,n){return this.createRoute(t,e,n,"PUT")}static delete(t,e,n){return this.createRoute(t,e,n,"DELETE")}static patch(t,e,n){return this.createRoute(t,e,n,"PATCH")}static options(t,e,n){return this.createRoute(t,e,n,"OPTIONS")}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const n=e.replace(/\[|]/g,"");this.arguments.add(n)})}}const l={};async function O(a,t,e={},n={}){let r=y(`${a.url}/${t.url}`,t,e),i={};n&&t.method!==A.GET&&(i.body=JSON.stringify(n)),i.headers={"Content-Type":"application/json",...a.headers,...t.headers},i.method=t.method;const{beforeRoute:u,beforeApi:g,beforeUrl:w,beforeConfig:T}=S({route:t,api:a,url:r,config:i});r=w,i=T,a=o.updateApi(g),t=o.updateRoute(u);const f=await fetch(r,i),{afterRoute:E,afterApi:P,afterData:b}=I({route:t,api:a,response:f,data:await f.json()});return o.updateApi(P),o.updateRoute(E),b}function y(a,t,e){let n=a;return t.arguments.forEach(r=>{if(e[r]===void 0)throw new Error(`Argument ${r} is missing`);n=n.replace(`[${r}]`,e[r])}),n}function S({route:a,api:t,url:e,config:n}){var i,u;const r=(u=(i=a.callbacks).before)==null?void 0:u.call(i,{route:a,api:t,url:e,config:n});return{beforeRoute:(r==null?void 0:r.route)||a,beforeApi:(r==null?void 0:r.api)||t,beforeUrl:(r==null?void 0:r.url)||e,beforeConfig:(r==null?void 0:r.config)||n}}function I({route:a,api:t,response:e,data:n}){var i,u;const r=(u=(i=a.callbacks).after)==null?void 0:u.call(i,{route:a,api:t,response:e,data:n});return{afterRoute:(r==null?void 0:r.route)||a,afterApi:(r==null?void 0:r.api)||t,afterResponse:(r==null?void 0:r.response)||e,afterData:(r==null?void 0:r.data)||n}}const c=class c{constructor(){s(this,"_apis",new Map);s(this,"_currentApi",null)}static get i(){return c._instance||(c._instance=new c),c._instance}registerApi(t){this._apis.set(t.name,t),l[t.name]={}}setCurrent(t){const e=this._apis.get(t);if(!e)throw new Error(`API ${t} not found`);this._currentApi=e}clearCurrent(){this._currentApi=null}registerRoute(t){if(!this._currentApi)throw new Error("No current API set, use Route only inside Api.create callback");t.api=this._currentApi.name,this._currentApi.routes.set(t.name,t),this.addToKlaimRoute(t.api,t)}getApi(t){return this._apis.get(t)}getRoute(t,e){const n=this._apis.get(t);if(!n)throw new Error(`API ${t} not found`);return n.routes.get(e)}static updateApi(t){return c.i._apis.has(t.name)||c.i.registerApi(t),c.i._apis.set(t.name,t),t}static updateRoute(t){const e=c.i._apis.get(t.api);if(!e)throw new Error(`API ${t.api} not found`);return e.routes.set(t.name,t),t}addToKlaimRoute(t,e){l[t][e.name]=async(n={},r={})=>{const i=c.i._apis.get(t);if(!i)throw new Error(`API ${e.api} not found`);return O(i,e,n,r)}}};s(c,"_instance");let o=c;class h{constructor(t,e,n){s(this,"name");s(this,"url");s(this,"headers");s(this,"routes",new Map);this.name=t,this.url=d(e),this.headers=n||{}}static create(t,e,n,r={}){const i=m(t);i!==t&&console.warn(`API name "${t}" has been camelCased to "${i}"`);const u=new h(i,e,r);return o.i.registerApi(u),o.i.setCurrent(i),n(),o.i.clearCurrent(),u}}exports.Api=h;exports.Klaim=l;exports.Registry=o;exports.Route=p;

package/dist/klaim.es.js

@@ -1,14 +1,14 @@
-var f = Object.defineProperty;
-var A = (n, t, e) => t in n ? f(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
-var i = (n, t, e) => A(n, typeof t != "symbol" ? t + "" : t, e);
-function l(n) {
-  return n.trim().replace(/^\/|\/$/g, "");
+var b = Object.defineProperty;
+var $ = (a, t, e) => t in a ? b(a, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : a[t] = e;
+var s = (a, t, e) => $(a, typeof t != "symbol" ? t + "" : t, e);
+function h(a) {
+  return a.trim().replace(/^\/|\/$/g, "");
 }
-function p(n) {
-  return n.replace(/([-_][a-z])/gi, (t) => t.toUpperCase().replace("-", "").replace("_", "")).replace(/(^\w)/, (t) => t.toLowerCase());
+function f(a) {
+  return a.replace(/([-_][a-z])/gi, (t) => t.toUpperCase().replace("-", "").replace("_", "")).replace(/(^\w)/, (t) => t.toLowerCase());
 }
-var m = /* @__PURE__ */ ((n) => (n.GET = "GET", n.POST = "POST", n.PUT = "PUT", n.DELETE = "DELETE", n.PATCH = "PATCH", n.OPTIONS = "OPTIONS", n))(m || {});
-class d {
+var d = /* @__PURE__ */ ((a) => (a.GET = "GET", a.POST = "POST", a.PUT = "PUT", a.DELETE = "DELETE", a.PATCH = "PATCH", a.OPTIONS = "OPTIONS", a))(d || {});
+class A {
   /**
    * Constructor
    *
@@ -17,14 +17,24 @@ class d {
    * @param headers - The headers to be sent with the request
    * @param method - The HTTP method of the route
    */
-  constructor(t, e, r, a = "GET") {
-    i(this, "api", "undefined");
-    i(this, "name");
-    i(this, "url");
-    i(this, "method");
-    i(this, "headers");
-    i(this, "arguments", /* @__PURE__ */ new Set());
-    this.name = p(t), this.name !== t && console.warn(`Route name "${t}" has been camelCased to "${this.name}"`), this.url = l(e), this.headers = r || {}, this.method = a, this.detectArguments();
+  constructor(t, e, n, r = "GET") {
+    s(this, "api", "undefined");
+    s(this, "name");
+    s(this, "url");
+    s(this, "method");
+    s(this, "headers");
+    s(this, "arguments", /* @__PURE__ */ new Set());
+    s(this, "callbacks", {
+      /**
+       * Called before the request is sent
+       */
+      before: null,
+      /**
+       * Called after the request is sent and before the data is returned
+       */
+      after: null
+    });
+    this.name = f(t), this.name !== t && console.warn(`Route name "${t}" has been camelCased to "${this.name}"`), this.url = h(e), this.headers = n || {}, this.method = r, this.detectArguments();
   }
   /**
    * Creates a new route
@@ -35,9 +45,9 @@ class d {
    * @param method - The HTTP method of the route
    * @returns The new route
    */
-  static createRoute(t, e, r, a) {
-    const s = new d(t, e, r, a);
-    return o.i.registerRoute(s), s;
+  static createRoute(t, e, n, r) {
+    const i = new A(t, e, n, r);
+    return u.i.registerRoute(i), i;
   }
   /**
    * Creates a new route with the GET method
@@ -47,11 +57,11 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static get(t, e, r = {}) {
+  static get(t, e, n = {}) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "GET"
       /* GET */
     );
@@ -64,11 +74,11 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static post(t, e, r) {
+  static post(t, e, n) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "POST"
       /* POST */
     );
@@ -81,11 +91,11 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static put(t, e, r) {
+  static put(t, e, n) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "PUT"
       /* PUT */
     );
@@ -98,11 +108,11 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static delete(t, e, r) {
+  static delete(t, e, n) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "DELETE"
       /* DELETE */
     );
@@ -115,11 +125,11 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static patch(t, e, r) {
+  static patch(t, e, n) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "PATCH"
       /* PATCH */
     );
@@ -132,50 +142,101 @@ class d {
    * @param headers - The headers to be sent with the request
    * @returns The new route
    */
-  static options(t, e, r) {
+  static options(t, e, n) {
     return this.createRoute(
       t,
       e,
-      r,
+      n,
       "OPTIONS"
       /* OPTIONS */
     );
   }
+  /**
+   * Sets the before callback
+   *
+   * @param callback - The callback
+   * @returns The route
+   */
+  before(t) {
+    return this.callbacks.before = t, this;
+  }
+  /**
+   * Sets the after callback
+   *
+   * @param callback - The callback
+   * @returns The route
+   */
+  after(t) {
+    return this.callbacks.after = t, this;
+  }
   /**
    * Detects the arguments in the URL
    */
   detectArguments() {
     const t = this.url.match(/\[([^\]]+)]/g);
     t && t.forEach((e) => {
-      const r = e.replace(/\[|]/g, "");
-      this.arguments.add(r);
+      const n = e.replace(/\[|]/g, "");
+      this.arguments.add(n);
     });
   }
 }
-const h = {};
-async function T(n, t, e = {}, r = {}) {
-  const a = g(`${n.url}/${t.url}`, t, e), s = {};
-  return r && t.method !== m.GET && (s.body = JSON.stringify(r)), s.headers = {
+const p = {};
+async function O(a, t, e = {}, n = {}) {
+  let r = I(`${a.url}/${t.url}`, t, e), i = {};
+  n && t.method !== d.GET && (i.body = JSON.stringify(n)), i.headers = {
     "Content-Type": "application/json",
-    ...n.headers,
+    ...a.headers,
     ...t.headers
-  }, s.method = t.method, await (await fetch(a, s)).json();
+  }, i.method = t.method;
+  const {
+    beforeRoute: o,
+    beforeApi: w,
+    beforeUrl: g,
+    beforeConfig: T
+  } = _({ route: t, api: a, url: r, config: i });
+  r = g, i = T, a = u.updateApi(w), t = u.updateRoute(o);
+  const l = await fetch(r, i), {
+    afterRoute: E,
+    afterApi: P,
+    afterData: C
+  } = S({ route: t, api: a, response: l, data: await l.json() });
+  return u.updateApi(P), u.updateRoute(E), C;
 }
-function g(n, t, e) {
-  let r = n;
-  return t.arguments.forEach((a) => {
-    if (e[a] === void 0)
-      throw new Error(`Argument ${a} is missing`);
-    r = r.replace(`[${a}]`, e[a]);
-  }), r;
+function I(a, t, e) {
+  let n = a;
+  return t.arguments.forEach((r) => {
+    if (e[r] === void 0)
+      throw new Error(`Argument ${r} is missing`);
+    n = n.replace(`[${r}]`, e[r]);
+  }), n;
+}
+function _({ route: a, api: t, url: e, config: n }) {
+  var i, o;
+  const r = (o = (i = a.callbacks).before) == null ? void 0 : o.call(i, { route: a, api: t, url: e, config: n });
+  return {
+    beforeRoute: (r == null ? void 0 : r.route) || a,
+    beforeApi: (r == null ? void 0 : r.api) || t,
+    beforeUrl: (r == null ? void 0 : r.url) || e,
+    beforeConfig: (r == null ? void 0 : r.config) || n
+  };
+}
+function S({ route: a, api: t, response: e, data: n }) {
+  var i, o;
+  const r = (o = (i = a.callbacks).after) == null ? void 0 : o.call(i, { route: a, api: t, response: e, data: n });
+  return {
+    afterRoute: (r == null ? void 0 : r.route) || a,
+    afterApi: (r == null ? void 0 : r.api) || t,
+    afterResponse: (r == null ? void 0 : r.response) || e,
+    afterData: (r == null ? void 0 : r.data) || n
+  };
 }
 const c = class c {
   /**
    * Constructor
    */
   constructor() {
-    i(this, "_apis", /* @__PURE__ */ new Map());
-    i(this, "_currentApi", null);
+    s(this, "_apis", /* @__PURE__ */ new Map());
+    s(this, "_currentApi", null);
   }
   /**
    * Singleton instance
@@ -191,7 +252,7 @@ const c = class c {
    * @param api - The API to register
    */
   registerApi(t) {
-    this._apis.set(t.name, t), h[t.name] = {};
+    this._apis.set(t.name, t), p[t.name] = {};
   }
   /**
    * Sets the current API
@@ -237,10 +298,31 @@ const c = class c {
    * @returns The route
    */
   getRoute(t, e) {
-    const r = this._apis.get(t);
-    if (!r)
+    const n = this._apis.get(t);
+    if (!n)
       throw new Error(`API ${t} not found`);
-    return r.routes.get(e);
+    return n.routes.get(e);
+  }
+  /**
+   * Updates an API
+   *
+   * @param api - The API to update
+   * @returns The updated API
+   */
+  static updateApi(t) {
+    return c.i._apis.has(t.name) || c.i.registerApi(t), c.i._apis.set(t.name, t), t;
+  }
+  /**
+   * Updates a route
+   *
+   * @param route - The route to update
+   * @returns The updated route
+   */
+  static updateRoute(t) {
+    const e = c.i._apis.get(t.api);
+    if (!e)
+      throw new Error(`API ${t.api} not found`);
+    return e.routes.set(t.name, t), t;
   }
   /**
    * Adds a route to Klaim object
@@ -249,17 +331,17 @@ const c = class c {
    * @param route - The route to add
    */
   addToKlaimRoute(t, e) {
-    h[t][e.name] = async (r = {}, a = {}) => {
-      const s = c.i._apis.get(t);
-      if (!s)
+    p[t][e.name] = async (n = {}, r = {}) => {
+      const i = c.i._apis.get(t);
+      if (!i)
         throw new Error(`API ${e.api} not found`);
-      return T(s, e, r, a);
+      return O(i, e, n, r);
     };
   }
 };
-i(c, "_instance");
-let o = c;
-class w {
+s(c, "_instance");
+let u = c;
+class m {
   /**
    * Constructor
    *
@@ -267,12 +349,12 @@ class w {
    * @param url - The base URL of the API
    * @param headers - The headers to be sent with each request
    */
-  constructor(t, e, r) {
-    i(this, "name");
-    i(this, "url");
-    i(this, "headers");
-    i(this, "routes", /* @__PURE__ */ new Map());
-    this.name = t, this.url = l(e), this.headers = r || {};
+  constructor(t, e, n) {
+    s(this, "name");
+    s(this, "url");
+    s(this, "headers");
+    s(this, "routes", /* @__PURE__ */ new Map());
+    this.name = t, this.url = h(e), this.headers = n || {};
   }
   /**
    * Creates a new API
@@ -283,16 +365,16 @@ class w {
    * @param headers - The headers to be sent with each request
    * @returns The new API
    */
-  static create(t, e, r, a = {}) {
-    const s = p(t);
-    s !== t && console.warn(`API name "${t}" has been camelCased to "${s}"`);
-    const u = new w(s, e, a);
-    return o.i.registerApi(u), o.i.setCurrent(s), r(), o.i.clearCurrent(), u;
+  static create(t, e, n, r = {}) {
+    const i = f(t);
+    i !== t && console.warn(`API name "${t}" has been camelCased to "${i}"`);
+    const o = new m(i, e, r);
+    return u.i.registerApi(o), u.i.setCurrent(i), n(), u.i.clearCurrent(), o;
   }
 }
 export {
-  w as Api,
-  h as Klaim,
-  o as Registry,
-  d as Route
+  m as Api,
+  p as Klaim,
+  u as Registry,
+  A as Route
 };

package/dist/klaim.umd.js

@@ -0,0 +1 @@
+(function(s,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(s=typeof globalThis<"u"?globalThis:s||self,o(s.klaim={}))})(this,function(s){"use strict";var I=Object.defineProperty;var _=(s,o,h)=>o in s?I(s,o,{enumerable:!0,configurable:!0,writable:!0,value:h}):s[o]=h;var c=(s,o,h)=>_(s,typeof o!="symbol"?o+"":o,h);function o(i){return i.trim().replace(/^\/|\/$/g,"")}function h(i){return i.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}var A=(i=>(i.GET="GET",i.POST="POST",i.PUT="PUT",i.DELETE="DELETE",i.PATCH="PATCH",i.OPTIONS="OPTIONS",i))(A||{});class f{constructor(t,e,r,n="GET"){c(this,"api","undefined");c(this,"name");c(this,"url");c(this,"method");c(this,"headers");c(this,"arguments",new Set);c(this,"callbacks",{before:null,after:null});this.name=h(t),this.name!==t&&console.warn(`Route name "${t}" has been camelCased to "${this.name}"`),this.url=o(e),this.headers=r||{},this.method=n,this.detectArguments()}static createRoute(t,e,r,n){const a=new f(t,e,r,n);return l.i.registerRoute(a),a}static get(t,e,r={}){return this.createRoute(t,e,r,"GET")}static post(t,e,r){return this.createRoute(t,e,r,"POST")}static put(t,e,r){return this.createRoute(t,e,r,"PUT")}static delete(t,e,r){return this.createRoute(t,e,r,"DELETE")}static patch(t,e,r){return this.createRoute(t,e,r,"PATCH")}static options(t,e,r){return this.createRoute(t,e,r,"OPTIONS")}before(t){return this.callbacks.before=t,this}after(t){return this.callbacks.after=t,this}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const r=e.replace(/\[|]/g,"");this.arguments.add(r)})}}const d={};async function w(i,t,e={},r={}){let n=T(`${i.url}/${t.url}`,t,e),a={};r&&t.method!==A.GET&&(a.body=JSON.stringify(r)),a.headers={"Content-Type":"application/json",...i.headers,...t.headers},a.method=t.method;const{beforeRoute:p,beforeApi:b,beforeUrl:C,beforeConfig:$}=E({route:t,api:i,url:n,config:a});n=C,a=$,i=l.updateApi(b),t=l.updateRoute(p);const g=await fetch(n,a),{afterRoute:y,afterApi:O,afterData:S}=P({route:t,api:i,response:g,data:await g.json()});return l.updateApi(O),l.updateRoute(y),S}function T(i,t,e){let r=i;return t.arguments.forEach(n=>{if(e[n]===void 0)throw new Error(`Argument ${n} is missing`);r=r.replace(`[${n}]`,e[n])}),r}function E({route:i,api:t,url:e,config:r}){var a,p;const n=(p=(a=i.callbacks).before)==null?void 0:p.call(a,{route:i,api:t,url:e,config:r});return{beforeRoute:(n==null?void 0:n.route)||i,beforeApi:(n==null?void 0:n.api)||t,beforeUrl:(n==null?void 0:n.url)||e,beforeConfig:(n==null?void 0:n.config)||r}}function P({route:i,api:t,response:e,data:r}){var a,p;const n=(p=(a=i.callbacks).after)==null?void 0:p.call(a,{route:i,api:t,response:e,data:r});return{afterRoute:(n==null?void 0:n.route)||i,afterApi:(n==null?void 0:n.api)||t,afterResponse:(n==null?void 0:n.response)||e,afterData:(n==null?void 0:n.data)||r}}const u=class u{constructor(){c(this,"_apis",new Map);c(this,"_currentApi",null)}static get i(){return u._instance||(u._instance=new u),u._instance}registerApi(t){this._apis.set(t.name,t),d[t.name]={}}setCurrent(t){const e=this._apis.get(t);if(!e)throw new Error(`API ${t} not found`);this._currentApi=e}clearCurrent(){this._currentApi=null}registerRoute(t){if(!this._currentApi)throw new Error("No current API set, use Route only inside Api.create callback");t.api=this._currentApi.name,this._currentApi.routes.set(t.name,t),this.addToKlaimRoute(t.api,t)}getApi(t){return this._apis.get(t)}getRoute(t,e){const r=this._apis.get(t);if(!r)throw new Error(`API ${t} not found`);return r.routes.get(e)}static updateApi(t){return u.i._apis.has(t.name)||u.i.registerApi(t),u.i._apis.set(t.name,t),t}static updateRoute(t){const e=u.i._apis.get(t.api);if(!e)throw new Error(`API ${t.api} not found`);return e.routes.set(t.name,t),t}addToKlaimRoute(t,e){d[t][e.name]=async(r={},n={})=>{const a=u.i._apis.get(t);if(!a)throw new Error(`API ${e.api} not found`);return w(a,e,r,n)}}};c(u,"_instance");let l=u;class m{constructor(t,e,r){c(this,"name");c(this,"url");c(this,"headers");c(this,"routes",new Map);this.name=t,this.url=o(e),this.headers=r||{}}static create(t,e,r,n={}){const a=h(t);a!==t&&console.warn(`API name "${t}" has been camelCased to "${a}"`);const p=new m(a,e,n);return l.i.registerApi(p),l.i.setCurrent(a),r(),l.i.clearCurrent(),p}}s.Api=m,s.Klaim=d,s.Registry=l,s.Route=f,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});

package/index.ts

@@ -1 +1,2 @@
 export * from './src';
+

package/package.json

@@ -20,7 +20,7 @@
     },
     "homepage": "https://github.com/antharuu/klaim#readme",
     "type": "module",
-    "version": "1.0.6",
+    "version": "1.1.2",
     "main": "dist/klaim.cjs.js",
     "module": "dist/klaim.es.js",
     "types": "dist/index.d.ts",

package/src/core/Klaim.ts

@@ -1,5 +1,6 @@
 import { Api } from "./Api";
-import { Route, RouteMethod } from "./Route";
+import { Registry } from "./Registry";
+import { ICallbackAfter, ICallbackBefore, Route, RouteMethod } from "./Route";
 
 export type IArgs = Record<string, unknown>;
 
@@ -21,9 +22,9 @@ export const Klaim: IApiReference = {};
  * @returns The response
  */
 export async function callApi<T> (api: Api, route: Route, args: IArgs = {}, body: IBody = {}): Promise<T> {
-    const url = applyArgs(`${api.url}/${route.url}`, route, args);
+    let url = applyArgs(`${api.url}/${route.url}`, route, args);
 
-    const config: Record<string, unknown> = {};
+    let config: Record<string, unknown> = {};
 
     if (body && route.method !== RouteMethod.GET) {
         config.body = JSON.stringify(body);
@@ -37,10 +38,28 @@ export async function callApi<T> (api: Api, route: Route, args: IArgs = {}, body
 
     config.method = route.method;
 
+    const {
+        beforeRoute,
+        beforeApi,
+        beforeUrl,
+        beforeConfig
+    } = applyBefore({ route, api, url, config });
+    url = beforeUrl;
+    config = beforeConfig;
+    api = Registry.updateApi(beforeApi);
+    route = Registry.updateRoute(beforeRoute);
+
     const response = await fetch(url, config);
 
-    const data = await response.json();
-    return data as T;
+    const {
+        afterRoute,
+        afterApi,
+        afterData
+    } = applyAfter({ route, api, response, data: await response.json() });
+    Registry.updateApi(afterApi);
+    Registry.updateRoute(afterRoute);
+
+    return afterData as T;
 }
 
 /**
@@ -64,3 +83,53 @@ function applyArgs (url: string, route: Route, args: IArgs): string {
 
     return newUrl;
 }
+
+/**
+ * Applies the before callback
+ *
+ * @param callbackArgs - The arguments to pass to the callback
+ * @param callbackArgs.route - The route
+ * @param callbackArgs.api - The API
+ * @param callbackArgs.url - The URL
+ * @param callbackArgs.config - The config
+ * @returns The new args
+ */
+function applyBefore ({ route, api, url, config }: ICallbackBefore): {
+    beforeRoute: Route;
+    beforeApi: Api;
+    beforeUrl: string;
+    beforeConfig: Record<string, unknown>;
+} {
+    const beforeRes = route.callbacks.before?.({ route, api, url, config });
+    return {
+        beforeRoute: beforeRes?.route || route,
+        beforeApi: beforeRes?.api || api,
+        beforeUrl: beforeRes?.url || url,
+        beforeConfig: beforeRes?.config || config
+    };
+}
+
+/**
+ * Applies the after callback
+ *
+ * @param callbackArgs - The arguments to pass to the callback
+ * @param callbackArgs.route - The route
+ * @param callbackArgs.api - The API
+ * @param callbackArgs.response - The response
+ * @param callbackArgs.data - The data
+ * @returns The new data
+ */
+function applyAfter ({ route, api, response, data }: ICallbackAfter): {
+    afterRoute: Route;
+    afterApi: Api;
+    afterResponse: Response;
+    afterData: any;
+} {
+    const afterRes = route.callbacks.after?.({ route, api, response, data });
+    return {
+        afterRoute: afterRes?.route || route,
+        afterApi: afterRes?.api || api,
+        afterResponse: afterRes?.response || response,
+        afterData: afterRes?.data || data
+    };
+}

package/src/core/Registry.ts

@@ -101,6 +101,39 @@ export class Registry {
         return apiObj.routes.get(name) as Route;
     }
 
+    /**
+     * Updates an API
+     *
+     * @param api - The API to update
+     * @returns The updated API
+     */
+    public static updateApi (api: Api): Api {
+        if (!Registry.i._apis.has(api.name)) {
+            Registry.i.registerApi(api);
+        }
+
+        Registry.i._apis.set(api.name, api);
+
+        return api;
+    }
+
+    /**
+     * Updates a route
+     *
+     * @param route - The route to update
+     * @returns The updated route
+     */
+    public static updateRoute (route: Route): Route {
+        const api = Registry.i._apis.get(route.api);
+        if (!api) {
+            throw new Error(`API ${route.api} not found`);
+        }
+
+        api.routes.set(route.name, route);
+
+        return route;
+    }
+
     /**
      * Adds a route to Klaim object
      *

package/src/core/Route.ts

@@ -13,6 +13,25 @@ export enum RouteMethod {
     OPTIONS = "OPTIONS"
 }
 
+export interface ICallbackBefore {
+    route: Route;
+    api: Api;
+    url: string;
+    config: Record<string, unknown>;
+}
+
+export interface ICallbackAfter {
+    route: Route;
+    api: Api;
+    response: Response;
+    data: any;
+}
+
+interface IRouteCallbacks {
+    before: ((args: ICallbackBefore) => (Partial<ICallbackBefore> | void)) | null;
+    after: ((args: ICallbackAfter) => (Partial<ICallbackAfter> | void)) | null;
+}
+
 interface IRoute {
     api: Api["name"];
     name: string;
@@ -20,6 +39,10 @@ interface IRoute {
     method: RouteMethod;
     headers: IHeaders;
     arguments: Set<string>;
+    callbacks: IRouteCallbacks;
+
+    before: (callback: (args: ICallbackBefore) => (Partial<ICallbackBefore> | void)) => Route;
+    after: (callback: (args: ICallbackAfter) => (Partial<ICallbackAfter> | void)) => Route;
 }
 
 /**
@@ -38,6 +61,17 @@ export class Route implements IRoute {
 
     public arguments: Set<string> = new Set<string>();
 
+    public callbacks: IRouteCallbacks = {
+        /**
+         * Called before the request is sent
+         */
+        before: null,
+        /**
+         * Called after the request is sent and before the data is returned
+         */
+        after: null
+    };
+
     /**
      * Constructor
      *
@@ -146,6 +180,28 @@ export class Route implements IRoute {
         return this.createRoute(name, url, headers, RouteMethod.OPTIONS);
     }
 
+    /**
+     * Sets the before callback
+     *
+     * @param callback - The callback
+     * @returns The route
+     */
+    public before (callback: (args: ICallbackBefore) => (Partial<ICallbackBefore> | void)): this {
+        this.callbacks.before = callback;
+        return this;
+    }
+
+    /**
+     * Sets the after callback
+     *
+     * @param callback - The callback
+     * @returns The route
+     */
+    public after (callback: (args: ICallbackAfter) => (Partial<ICallbackAfter> | void)): this {
+        this.callbacks.after = callback;
+        return this;
+    }
+
     /**
      * Detects the arguments in the URL
      */

package/vite.config.ts

@@ -7,8 +7,11 @@ export default defineConfig({
         lib: {
             entry: path.resolve(__dirname, 'src/index.ts'),
             name: 'klaim',
-            fileName: format => `klaim.${format}.js`,
-            formats: ['es', 'cjs']
+            fileName: format => {
+                if (format === 'cjs') return `klaim.${format}`;
+                return `klaim.${format}.js`;
+            },
+            formats: ['es', 'cjs', 'umd']
         },
         rollupOptions: {
             external: [],

package/dist/klaim.cjs.js

@@ -1 +0,0 @@
-"use strict";var g=Object.defineProperty;var w=(n,t,e)=>t in n?g(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var a=(n,t,e)=>w(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function m(n){return n.trim().replace(/^\/|\/$/g,"")}function d(n){return n.replace(/([-_][a-z])/gi,t=>t.toUpperCase().replace("-","").replace("_","")).replace(/(^\w)/,t=>t.toLowerCase())}var f=(n=>(n.GET="GET",n.POST="POST",n.PUT="PUT",n.DELETE="DELETE",n.PATCH="PATCH",n.OPTIONS="OPTIONS",n))(f||{});class h{constructor(t,e,r,i="GET"){a(this,"api","undefined");a(this,"name");a(this,"url");a(this,"method");a(this,"headers");a(this,"arguments",new Set);this.name=d(t),this.name!==t&&console.warn(`Route name "${t}" has been camelCased to "${this.name}"`),this.url=m(e),this.headers=r||{},this.method=i,this.detectArguments()}static createRoute(t,e,r,i){const s=new h(t,e,r,i);return o.i.registerRoute(s),s}static get(t,e,r={}){return this.createRoute(t,e,r,"GET")}static post(t,e,r){return this.createRoute(t,e,r,"POST")}static put(t,e,r){return this.createRoute(t,e,r,"PUT")}static delete(t,e,r){return this.createRoute(t,e,r,"DELETE")}static patch(t,e,r){return this.createRoute(t,e,r,"PATCH")}static options(t,e,r){return this.createRoute(t,e,r,"OPTIONS")}detectArguments(){const t=this.url.match(/\[([^\]]+)]/g);t&&t.forEach(e=>{const r=e.replace(/\[|]/g,"");this.arguments.add(r)})}}const l={};async function A(n,t,e={},r={}){const i=T(`${n.url}/${t.url}`,t,e),s={};return r&&t.method!==f.GET&&(s.body=JSON.stringify(r)),s.headers={"Content-Type":"application/json",...n.headers,...t.headers},s.method=t.method,await(await fetch(i,s)).json()}function T(n,t,e){let r=n;return t.arguments.forEach(i=>{if(e[i]===void 0)throw new Error(`Argument ${i} is missing`);r=r.replace(`[${i}]`,e[i])}),r}const c=class c{constructor(){a(this,"_apis",new Map);a(this,"_currentApi",null)}static get i(){return c._instance||(c._instance=new c),c._instance}registerApi(t){this._apis.set(t.name,t),l[t.name]={}}setCurrent(t){const e=this._apis.get(t);if(!e)throw new Error(`API ${t} not found`);this._currentApi=e}clearCurrent(){this._currentApi=null}registerRoute(t){if(!this._currentApi)throw new Error("No current API set, use Route only inside Api.create callback");t.api=this._currentApi.name,this._currentApi.routes.set(t.name,t),this.addToKlaimRoute(t.api,t)}getApi(t){return this._apis.get(t)}getRoute(t,e){const r=this._apis.get(t);if(!r)throw new Error(`API ${t} not found`);return r.routes.get(e)}addToKlaimRoute(t,e){l[t][e.name]=async(r={},i={})=>{const s=c.i._apis.get(t);if(!s)throw new Error(`API ${e.api} not found`);return A(s,e,r,i)}}};a(c,"_instance");let o=c;class p{constructor(t,e,r){a(this,"name");a(this,"url");a(this,"headers");a(this,"routes",new Map);this.name=t,this.url=m(e),this.headers=r||{}}static create(t,e,r,i={}){const s=d(t);s!==t&&console.warn(`API name "${t}" has been camelCased to "${s}"`);const u=new p(s,e,i);return o.i.registerApi(u),o.i.setCurrent(s),r(),o.i.clearCurrent(),u}}exports.Api=p;exports.Klaim=l;exports.Registry=o;exports.Route=h;