@kelviq/js-sdk 2.0.0-beta → 2.0.0

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export interface RawEntitlement {
 	remaining?: number | null;
 }
 export interface RawEntitlementsApiResponse {
-	customer_id: string;
+	customerId: string;
 	entitlements: RawEntitlement[];
 }
 export interface Entitlement {

package/dist/kelviq-js-sdk.iife.js

@@ -1 +1 @@
-var kelviqSDK=function(){"use strict";var I=Object.defineProperty;var _=(y,d,q)=>d in y?I(y,d,{enumerable:!0,configurable:!0,writable:!0,value:q}):y[d]=q;var E=(y,d,q)=>_(y,typeof d!="symbol"?d+"":d,q);function y(a){const e={};if(!a||!Array.isArray(a.entitlements))return console.warn("[Kelviq SDK] transformApiEntitlements: Invalid or empty entitlements array in API response.",a),e;const i={};a.entitlements.forEach(t=>{if(!t||typeof t.featureId!="string"||typeof t.featureType!="string"){console.warn("[Kelviq SDK] transformApiEntitlements: Skipping invalid raw entitlement object:",t);return}i[t.featureId]||(i[t.featureId]=[]),i[t.featureId].push(t)});for(const t of Object.keys(i)){const c=i[t],u=c[0].featureType;let A=0,r=null,f=null,l=!1,m=!1;if(u==="METER"){let n=!0;for(const s of c)A+=typeof s.currentUsage=="number"?s.currentUsage:0,typeof s.usageLimit=="number"&&(r=(r??0)+s.usageLimit,n=!1);n&&(r=null),f=r!==null?r-A:null,l=c.some(s=>s.hardLimit===!0),m=f===null||f>0}else if(u==="CUSTOMIZABLE"){const n=c[0];r=typeof n.usageLimit=="number"?n.usageLimit:null,A=typeof n.currentUsage=="number"?n.currentUsage:0,f=typeof n.remaining=="number"?n.remaining:null,l=n.hardLimit===!0,m=c.some(s=>s.hasAccess)}else if(u==="BOOLEAN")m=c.some(n=>n.hasAccess);else{console.warn(`[Kelviq SDK] transformApiEntitlements: Encountered unknown featureType: '${u}' for feature '${t}'. This entitlement will be ignored.`);continue}const R={featureId:t,featureType:u,hasAccess:m,hardLimit:l,currentUsage:A,usageLimit:r,remaining:f,items:c};e[t]=R}return e}const d="GET",q=5e3,K=3,P=1e3;function C(a){const{method:e=d,headers:i={},body:t,timeout:c=q,maxRetries:u=K,backoffBaseDelay:A=P,queryParams:r,accessToken:f}=a;let l=a.url,m=0;return new Promise((R,n)=>{if(r){const h=new URLSearchParams;for(const g in r)r[g]!==void 0&&h.append(g,String(r[g]));h.toString()&&(l=l+(l.includes("?")?"&":"?")+h.toString())}function s(){const h=new XMLHttpRequest;h.open(e,l,!0),h.timeout=c;const g={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...i};e!=="GET"&&t&&typeof t=="object"&&!(t instanceof FormData)&&(g["Content-Type"]||(g["Content-Type"]="application/json")),f&&(g.Authorization=`Bearer ${f}`);for(const[o,p]of Object.entries(g))h.setRequestHeader(o,p);h.onload=function(){const{status:o,statusText:p,responseText:F}=h;if(o>=200&&o<300)try{const v=F?JSON.parse(F):{};R({status:o,statusText:p,data:v})}catch(v){const w=v instanceof Error?v:new Error(String(v));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${l}. Error: ${w.message}. Response: ${F}`),n(new Error(`Invalid JSON response: ${w.message}`))}else S(`Request to ${l} failed with status ${o} ${p}. Response: ${F}`)},h.onerror=()=>S(`Network error for URL ${l}. The request could not be completed.`),h.ontimeout=()=>S(`Request to ${l} timed out.`);function S(o){if(m<u){m++;const p=Math.min(A*Math.pow(2,m-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${l}. Attempt ${m}/${u}. Error: ${o}. Retrying in ${p}ms.`),setTimeout(s,p)}else n(new Error(`${o} (Max retries ${u} reached)`))}try{let o=t;t&&typeof t=="object"&&!(t instanceof FormData)&&g["Content-Type"]==="application/json"&&(o=JSON.stringify(t)),h.send(o)}catch(o){const p=o instanceof Error?o:new Error(String(o));console.error(`Kelviq SDK (apiRequest): Error sending request to ${l}.`,p),n(new Error(`Failed to send request: ${p.message}`))}}s()})}const L="https://edge.api.kelviq.com/api/v1/",D="https://edge.sandboxapi.kelviq.com/api/v1/",T="entitlements/";class ${constructor(e,i){E(this,"options");E(this,"entitlementsCache",null);E(this,"rawApiResponse",null);E(this,"isFetching",!1);E(this,"inFlightPromise",null);E(this,"readyPromise",null);E(this,"lastFetchError",null);E(this,"apiRequestService");if(!e||!e.customerId)throw new Error("[Kelviq SDK] KelviqClient: CustomerId is required in options.");this.options={...e,apiConfig:e.apiConfig||{},entitlementsPath:e.entitlementsPath||T},this.apiRequestService=i||C}async fetchAllEntitlements(e=!1){if(this.inFlightPromise&&!e)return this.inFlightPromise;if(this.entitlementsCache&&!e)return Promise.resolve(this.entitlementsCache);this.isFetching=!0,this.lastFetchError=null;const{apiUrl:i=this.options.environment==="sandbox"?D:L,entitlementsPath:t,customerId:c,accessToken:u,apiConfig:A,onError:r}=this.options,f=i.replace(/\/$/,""),l=t.replace(/^\//,""),m=`${f}/${l}`,R={customer_id:c};return this.inFlightPromise=this.apiRequestService({url:m,method:"GET",queryParams:R,accessToken:u,...A||{}}).then(n=>{if(n&&n.data&&Array.isArray(n.data.entitlements))return this.rawApiResponse=n.data,this.entitlementsCache=y(n.data),this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache;{const s=new Error("[Kelviq SDK] Received empty, malformed, or invalid data structure from entitlements API.");throw this.lastFetchError=s,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(s),s}}).catch(n=>{const s=n instanceof Error?n:new Error(String(n));throw this.lastFetchError=s,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(s),s}),this.inFlightPromise}getEntitlement(e){return this.entitlementsCache?this.entitlementsCache[e]??null:(console.warn(`[Kelviq SDK] getEntitlement: Entitlements not fetched or cache is empty for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getEntitlements(){return this.entitlementsCache}getRawEntitlement(e){return this.rawApiResponse?this.rawApiResponse.entitlements.filter(i=>i.featureId===e):(console.warn(`[Kelviq SDK] getRawEntitlement: Entitlements not fetched for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getRawEntitlements(){return this.rawApiResponse}hasAccess(e){if(!this.entitlementsCache)return console.warn(`[Kelviq SDK] hasAccess: Entitlements not fetched yet for featureId '${e}'. Call fetchAllEntitlements() first. Returning false.`),!1;const i=this.entitlementsCache[e];return i?i.hasAccess:!1}isLoading(){return this.isFetching}getLastError(){return this.lastFetchError}ready(){return this.readyPromise??Promise.resolve()}_setReadyPromise(e){this.readyPromise=e}clearCache(){this.entitlementsCache=null,this.rawApiResponse=null,this.isFetching=!1,this.lastFetchError=null,console.log("[Kelviq SDK] Entitlement cache cleared.")}}function U(a,e){const i={...a,initializeAndFetch:a.initializeAndFetch??!0,apiConfig:a.apiConfig||{},environment:a.environment||"production",entitlementsPath:a.entitlementsPath||T},t=new $(i,e);if(i.initializeAndFetch===!0){const c=t.fetchAllEntitlements().catch(u=>{console.error("[Kelviq SDK] Initial fetch on client creation failed:",u.message)});t._setReadyPromise(c.then(()=>{}))}return t}return U}();
+var kelviqSDK=function(){"use strict";var U=Object.defineProperty;var _=(y,p,q)=>p in y?U(y,p,{enumerable:!0,configurable:!0,writable:!0,value:q}):y[p]=q;var E=(y,p,q)=>_(y,typeof p!="symbol"?p+"":p,q);function y(a){const e={};if(!a||!Array.isArray(a.entitlements))return console.warn("[Kelviq SDK] transformApiEntitlements: Invalid or empty entitlements array in API response.",a),e;const s={};a.entitlements.forEach(t=>{if(!t||typeof t.featureId!="string"||typeof t.featureType!="string"){console.warn("[Kelviq SDK] transformApiEntitlements: Skipping invalid raw entitlement object:",t);return}s[t.featureId]||(s[t.featureId]=[]),s[t.featureId].push(t)});for(const t of Object.keys(s)){const c=s[t],u=c[0].featureType;let A=0,r=null,f=null,l=!1,h=!1;if(u==="METER"){let n=!0;for(const i of c)A+=typeof i.currentUsage=="number"?i.currentUsage:0,typeof i.usageLimit=="number"&&(r=(r??0)+i.usageLimit,n=!1);n&&(r=null),f=r!==null?r-A:null,l=c.some(i=>i.hardLimit===!0),h=f===null||f>0}else if(u==="CUSTOMIZABLE"){const n=c[0];r=typeof n.usageLimit=="number"?n.usageLimit:null,A=typeof n.currentUsage=="number"?n.currentUsage:0,f=typeof n.remaining=="number"?n.remaining:null,l=n.hardLimit===!0,h=c.some(i=>i.hasAccess)}else if(u==="BOOLEAN")h=c.some(n=>n.hasAccess);else{console.warn(`[Kelviq SDK] transformApiEntitlements: Encountered unknown featureType: '${u}' for feature '${t}'. This entitlement will be ignored.`);continue}const R={featureId:t,featureType:u,hasAccess:h,hardLimit:l,currentUsage:A,usageLimit:r,remaining:f,items:c};e[t]=R}return e}const p="GET",q=5e3,K=3,P=1e3;function C(a){const{method:e=p,headers:s={},body:t,timeout:c=q,maxRetries:u=K,backoffBaseDelay:A=P,queryParams:r,accessToken:f}=a;let l=a.url,h=0;return new Promise((R,n)=>{if(r){const m=new URLSearchParams;for(const g in r)r[g]!==void 0&&m.append(g,String(r[g]));m.toString()&&(l=l+(l.includes("?")?"&":"?")+m.toString())}function i(){const m=new XMLHttpRequest;m.open(e,l,!0),m.timeout=c;const g={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...s};e!=="GET"&&t&&typeof t=="object"&&!(t instanceof FormData)&&(g["Content-Type"]||(g["Content-Type"]="application/json")),f&&(g.Authorization=`Bearer ${f}`);for(const[o,d]of Object.entries(g))m.setRequestHeader(o,d);m.onload=function(){const{status:o,statusText:d,responseText:F}=m;if(o>=200&&o<300)try{const v=F?JSON.parse(F):{};R({status:o,statusText:d,data:v})}catch(v){const w=v instanceof Error?v:new Error(String(v));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${l}. Error: ${w.message}. Response: ${F}`),n(new Error(`Invalid JSON response: ${w.message}`))}else S(`Request to ${l} failed with status ${o} ${d}. Response: ${F}`)},m.onerror=()=>S(`Network error for URL ${l}. The request could not be completed.`),m.ontimeout=()=>S(`Request to ${l} timed out.`);function S(o){if(h<u){h++;const d=Math.min(A*Math.pow(2,h-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${l}. Attempt ${h}/${u}. Error: ${o}. Retrying in ${d}ms.`),setTimeout(i,d)}else n(new Error(`${o} (Max retries ${u} reached)`))}try{let o=t;t&&typeof t=="object"&&!(t instanceof FormData)&&g["Content-Type"]==="application/json"&&(o=JSON.stringify(t)),m.send(o)}catch(o){const d=o instanceof Error?o:new Error(String(o));console.error(`Kelviq SDK (apiRequest): Error sending request to ${l}.`,d),n(new Error(`Failed to send request: ${d.message}`))}}i()})}const L="https://edge.api.kelviq.com/api/v1/",D="https://edge.sandboxapi.kelviq.com/api/v1/",T="entitlements/";class ${constructor(e,s){E(this,"options");E(this,"entitlementsCache",null);E(this,"rawApiResponse",null);E(this,"isFetching",!1);E(this,"inFlightPromise",null);E(this,"readyPromise",null);E(this,"lastFetchError",null);E(this,"apiRequestService");if(!e||!e.customerId)throw new Error("[Kelviq SDK] KelviqClient: CustomerId is required in options.");this.options={...e,apiConfig:e.apiConfig||{},entitlementsPath:e.entitlementsPath||T},this.apiRequestService=s||C}async fetchAllEntitlements(e=!1){if(this.inFlightPromise&&!e)return this.inFlightPromise;if(this.entitlementsCache&&!e)return Promise.resolve(this.entitlementsCache);this.isFetching=!0,this.lastFetchError=null;const{apiUrl:s=this.options.environment==="sandbox"?D:L,entitlementsPath:t,customerId:c,accessToken:u,apiConfig:A,onError:r}=this.options,f=s.replace(/\/$/,""),l=t.replace(/^\//,""),h=`${f}/${l}`,R={customer_id:c};return this.inFlightPromise=this.apiRequestService({url:h,method:"GET",queryParams:R,accessToken:u,...A||{}}).then(n=>{if(n&&n.data&&Array.isArray(n.data.entitlements)){const i=n.data;return this.rawApiResponse={customerId:i.customer_id??i.customerId,entitlements:i.entitlements},this.entitlementsCache=y(n.data),this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache}else{const i=new Error("[Kelviq SDK] Received empty, malformed, or invalid data structure from entitlements API.");throw this.lastFetchError=i,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(i),i}}).catch(n=>{const i=n instanceof Error?n:new Error(String(n));throw this.lastFetchError=i,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(i),i}),this.inFlightPromise}getEntitlement(e){return this.entitlementsCache?this.entitlementsCache[e]??null:(console.warn(`[Kelviq SDK] getEntitlement: Entitlements not fetched or cache is empty for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getEntitlements(){return this.entitlementsCache}getRawEntitlement(e){return this.rawApiResponse?this.rawApiResponse.entitlements.filter(s=>s.featureId===e):(console.warn(`[Kelviq SDK] getRawEntitlement: Entitlements not fetched for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getRawEntitlements(){return this.rawApiResponse}hasAccess(e){if(!this.entitlementsCache)return console.warn(`[Kelviq SDK] hasAccess: Entitlements not fetched yet for featureId '${e}'. Call fetchAllEntitlements() first. Returning false.`),!1;const s=this.entitlementsCache[e];return s?s.hasAccess:!1}isLoading(){return this.isFetching}getLastError(){return this.lastFetchError}ready(){return this.readyPromise??Promise.resolve()}_setReadyPromise(e){this.readyPromise=e}clearCache(){this.entitlementsCache=null,this.rawApiResponse=null,this.isFetching=!1,this.lastFetchError=null,console.log("[Kelviq SDK] Entitlement cache cleared.")}}function I(a,e){const s={...a,initializeAndFetch:a.initializeAndFetch??!0,apiConfig:a.apiConfig||{},environment:a.environment||"production",entitlementsPath:a.entitlementsPath||T},t=new $(s,e);if(s.initializeAndFetch===!0){const c=t.fetchAllEntitlements().catch(u=>{console.error("[Kelviq SDK] Initial fetch on client creation failed:",u.message)});t._setReadyPromise(c.then(()=>{}))}return t}return I}();

package/dist/kelviq-js-sdk.js

@@ -1,15 +1,15 @@
 var S = Object.defineProperty;
-var T = (s, e, i) => e in s ? S(s, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : s[e] = i;
-var g = (s, e, i) => T(s, typeof e != "symbol" ? e + "" : e, i);
-function w(s) {
+var T = (r, e, i) => e in r ? S(r, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : r[e] = i;
+var g = (r, e, i) => T(r, typeof e != "symbol" ? e + "" : e, i);
+function w(r) {
   const e = {};
-  if (!s || !Array.isArray(s.entitlements))
+  if (!r || !Array.isArray(r.entitlements))
     return console.warn(
       "[Kelviq SDK] transformApiEntitlements: Invalid or empty entitlements array in API response.",
-      s
+      r
     ), e;
   const i = {};
-  s.entitlements.forEach((t) => {
+  r.entitlements.forEach((t) => {
     if (!t || typeof t.featureId != "string" || typeof t.featureType != "string") {
       console.warn(
         "[Kelviq SDK] transformApiEntitlements: Skipping invalid raw entitlement object:",
@@ -21,17 +21,17 @@ function w(s) {
   });
   for (const t of Object.keys(i)) {
     const c = i[t], u = c[0].featureType;
-    let E = 0, l = null, f = null, o = !1, m = !1;
+    let E = 0, l = null, f = null, o = !1, h = !1;
     if (u === "METER") {
       let n = !0;
-      for (const r of c)
-        E += typeof r.currentUsage == "number" ? r.currentUsage : 0, typeof r.usageLimit == "number" && (l = (l ?? 0) + r.usageLimit, n = !1);
-      n && (l = null), f = l !== null ? l - E : null, o = c.some((r) => r.hardLimit === !0), m = f === null || f > 0;
+      for (const s of c)
+        E += typeof s.currentUsage == "number" ? s.currentUsage : 0, typeof s.usageLimit == "number" && (l = (l ?? 0) + s.usageLimit, n = !1);
+      n && (l = null), f = l !== null ? l - E : null, o = c.some((s) => s.hardLimit === !0), h = f === null || f > 0;
     } else if (u === "CUSTOMIZABLE") {
       const n = c[0];
-      l = typeof n.usageLimit == "number" ? n.usageLimit : null, E = typeof n.currentUsage == "number" ? n.currentUsage : 0, f = typeof n.remaining == "number" ? n.remaining : null, o = n.hardLimit === !0, m = c.some((r) => r.hasAccess);
+      l = typeof n.usageLimit == "number" ? n.usageLimit : null, E = typeof n.currentUsage == "number" ? n.currentUsage : 0, f = typeof n.remaining == "number" ? n.remaining : null, o = n.hardLimit === !0, h = c.some((s) => s.hasAccess);
     } else if (u === "BOOLEAN")
-      m = c.some((n) => n.hasAccess);
+      h = c.some((n) => n.hasAccess);
     else {
       console.warn(
         `[Kelviq SDK] transformApiEntitlements: Encountered unknown featureType: '${u}' for feature '${t}'. This entitlement will be ignored.`
@@ -41,7 +41,7 @@ function w(s) {
     const A = {
       featureId: t,
       featureType: u,
-      hasAccess: m,
+      hasAccess: h,
       hardLimit: o,
       currentUsage: E,
       usageLimit: l,
@@ -53,7 +53,7 @@ function w(s) {
   return e;
 }
 const P = "GET", C = 5e3, K = 3, L = 1e3;
-function $(s) {
+function $(r) {
   const {
     method: e = P,
     headers: i = {},
@@ -65,33 +65,33 @@ function $(s) {
     queryParams: l,
     accessToken: f
     // Use the direct accessToken
-  } = s;
-  let o = s.url, m = 0;
+  } = r;
+  let o = r.url, h = 0;
   return new Promise((A, n) => {
     if (l) {
-      const h = new URLSearchParams();
-      for (const d in l)
-        l[d] !== void 0 && h.append(d, String(l[d]));
-      h.toString() && (o = o + (o.includes("?") ? "&" : "?") + h.toString());
+      const m = new URLSearchParams();
+      for (const p in l)
+        l[p] !== void 0 && m.append(p, String(l[p]));
+      m.toString() && (o = o + (o.includes("?") ? "&" : "?") + m.toString());
     }
-    function r() {
-      const h = new XMLHttpRequest();
-      h.open(e, o, !0), h.timeout = c;
-      const d = {
+    function s() {
+      const m = new XMLHttpRequest();
+      m.open(e, o, !0), m.timeout = c;
+      const p = {
         Accept: "application/json",
         "X-Requested-With": "XMLHttpRequest",
         ...i
         // Apply custom headers, allowing them to override defaults
       };
-      e !== "GET" && t && typeof t == "object" && !(t instanceof FormData) && (d["Content-Type"] || (d["Content-Type"] = "application/json")), f && (d.Authorization = `Bearer ${f}`);
-      for (const [a, p] of Object.entries(d))
-        h.setRequestHeader(a, p);
-      h.onload = function() {
-        const { status: a, statusText: p, responseText: R } = h;
+      e !== "GET" && t && typeof t == "object" && !(t instanceof FormData) && (p["Content-Type"] || (p["Content-Type"] = "application/json")), f && (p.Authorization = `Bearer ${f}`);
+      for (const [a, d] of Object.entries(p))
+        m.setRequestHeader(a, d);
+      m.onload = function() {
+        const { status: a, statusText: d, responseText: R } = m;
         if (a >= 200 && a < 300)
           try {
             const y = R ? JSON.parse(R) : {};
-            A({ status: a, statusText: p, data: y });
+            A({ status: a, statusText: d, data: y });
           } catch (y) {
             const v = y instanceof Error ? y : new Error(String(y));
             console.error(
@@ -100,22 +100,22 @@ function $(s) {
           }
         else
           q(
-            `Request to ${o} failed with status ${a} ${p}. Response: ${R}`
+            `Request to ${o} failed with status ${a} ${d}. Response: ${R}`
           );
-      }, h.onerror = () => q(
+      }, m.onerror = () => q(
         `Network error for URL ${o}. The request could not be completed.`
-      ), h.ontimeout = () => q(`Request to ${o} timed out.`);
+      ), m.ontimeout = () => q(`Request to ${o} timed out.`);
       function q(a) {
-        if (m < u) {
-          m++;
-          const p = Math.min(
-            E * Math.pow(2, m - 1),
+        if (h < u) {
+          h++;
+          const d = Math.min(
+            E * Math.pow(2, h - 1),
             3e4
             // Cap retry delay at 30 seconds
           );
           console.warn(
-            `Kelviq SDK (apiRequest): Retrying request to ${o}. Attempt ${m}/${u}. Error: ${a}. Retrying in ${p}ms.`
-          ), setTimeout(r, p);
+            `Kelviq SDK (apiRequest): Retrying request to ${o}. Attempt ${h}/${u}. Error: ${a}. Retrying in ${d}ms.`
+          ), setTimeout(s, d);
         } else
           n(
             new Error(`${a} (Max retries ${u} reached)`)
@@ -123,20 +123,20 @@ function $(s) {
       }
       try {
         let a = t;
-        t && typeof t == "object" && !(t instanceof FormData) && d["Content-Type"] === "application/json" && (a = JSON.stringify(t)), h.send(a);
+        t && typeof t == "object" && !(t instanceof FormData) && p["Content-Type"] === "application/json" && (a = JSON.stringify(t)), m.send(a);
       } catch (a) {
-        const p = a instanceof Error ? a : new Error(String(a));
+        const d = a instanceof Error ? a : new Error(String(a));
         console.error(
           `Kelviq SDK (apiRequest): Error sending request to ${o}.`,
-          p
-        ), n(new Error(`Failed to send request: ${p.message}`));
+          d
+        ), n(new Error(`Failed to send request: ${d.message}`));
       }
     }
-    r();
+    s();
   });
 }
-const D = "https://edge.api.kelviq.com/api/v1/", U = "https://edge.sandboxapi.kelviq.com/api/v1/", F = "entitlements/";
-class I {
+const D = "https://edge.api.kelviq.com/api/v1/", I = "https://edge.sandboxapi.kelviq.com/api/v1/", F = "entitlements/";
+class U {
   /**
    * Creates an instance of KelviqClient.
    * Prefer using the `kelviqSDK` factory function for instantiation.
@@ -179,33 +179,37 @@ class I {
       return Promise.resolve(this.entitlementsCache);
     this.isFetching = !0, this.lastFetchError = null;
     const {
-      apiUrl: i = this.options.environment === "sandbox" ? U : D,
+      apiUrl: i = this.options.environment === "sandbox" ? I : D,
       entitlementsPath: t,
       customerId: c,
       accessToken: u,
       apiConfig: E,
       onError: l
-    } = this.options, f = i.replace(/\/$/, ""), o = t.replace(/^\//, ""), m = `${f}/${o}`, A = {
+    } = this.options, f = i.replace(/\/$/, ""), o = t.replace(/^\//, ""), h = `${f}/${o}`, A = {
       customer_id: c
     };
     return this.inFlightPromise = this.apiRequestService({
-      url: m,
+      url: h,
       method: "GET",
       queryParams: A,
       accessToken: u,
       ...E || {}
     }).then((n) => {
-      if (n && n.data && Array.isArray(n.data.entitlements))
-        return this.rawApiResponse = n.data, this.entitlementsCache = w(n.data), this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache;
-      {
-        const r = new Error(
+      if (n && n.data && Array.isArray(n.data.entitlements)) {
+        const s = n.data;
+        return this.rawApiResponse = {
+          customerId: s.customer_id ?? s.customerId,
+          entitlements: s.entitlements
+        }, this.entitlementsCache = w(n.data), this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache;
+      } else {
+        const s = new Error(
           "[Kelviq SDK] Received empty, malformed, or invalid data structure from entitlements API."
         );
-        throw this.lastFetchError = r, this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache = null, this.rawApiResponse = null, l && l(r), r;
+        throw this.lastFetchError = s, this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache = null, this.rawApiResponse = null, l && l(s), s;
       }
     }).catch((n) => {
-      const r = n instanceof Error ? n : new Error(String(n));
-      throw this.lastFetchError = r, this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache = null, this.rawApiResponse = null, l && l(r), r;
+      const s = n instanceof Error ? n : new Error(String(n));
+      throw this.lastFetchError = s, this.isFetching = !1, this.inFlightPromise = null, this.entitlementsCache = null, this.rawApiResponse = null, l && l(s), s;
     }), this.inFlightPromise;
   }
   /**
@@ -296,14 +300,14 @@ class I {
     this.entitlementsCache = null, this.rawApiResponse = null, this.isFetching = !1, this.lastFetchError = null, console.log("[Kelviq SDK] Entitlement cache cleared.");
   }
 }
-function b(s, e) {
+function b(r, e) {
   const i = {
-    ...s,
-    initializeAndFetch: s.initializeAndFetch ?? !0,
-    apiConfig: s.apiConfig || {},
-    environment: s.environment || "production",
-    entitlementsPath: s.entitlementsPath || F
-  }, t = new I(i, e);
+    ...r,
+    initializeAndFetch: r.initializeAndFetch ?? !0,
+    apiConfig: r.apiConfig || {},
+    environment: r.environment || "production",
+    entitlementsPath: r.entitlementsPath || F
+  }, t = new U(i, e);
   if (i.initializeAndFetch === !0) {
     const c = t.fetchAllEntitlements().catch((u) => {
       console.error(

package/dist/kelviq-js-sdk.umd.js

@@ -1 +1 @@
-(function(f,c){typeof exports=="object"&&typeof module<"u"?module.exports=c():typeof define=="function"&&define.amd?define(c):(f=typeof globalThis<"u"?globalThis:f||self,f.kelviqSDK=c())})(this,function(){"use strict";var I=Object.defineProperty;var b=(f,c,q)=>c in f?I(f,c,{enumerable:!0,configurable:!0,writable:!0,value:q}):f[c]=q;var A=(f,c,q)=>b(f,typeof c!="symbol"?c+"":c,q);function f(a){const e={};if(!a||!Array.isArray(a.entitlements))return console.warn("[Kelviq SDK] transformApiEntitlements: Invalid or empty entitlements array in API response.",a),e;const i={};a.entitlements.forEach(t=>{if(!t||typeof t.featureId!="string"||typeof t.featureType!="string"){console.warn("[Kelviq SDK] transformApiEntitlements: Skipping invalid raw entitlement object:",t);return}i[t.featureId]||(i[t.featureId]=[]),i[t.featureId].push(t)});for(const t of Object.keys(i)){const u=i[t],h=u[0].featureType;let y=0,r=null,p=null,o=!1,d=!1;if(h==="METER"){let n=!0;for(const s of u)y+=typeof s.currentUsage=="number"?s.currentUsage:0,typeof s.usageLimit=="number"&&(r=(r??0)+s.usageLimit,n=!1);n&&(r=null),p=r!==null?r-y:null,o=u.some(s=>s.hardLimit===!0),d=p===null||p>0}else if(h==="CUSTOMIZABLE"){const n=u[0];r=typeof n.usageLimit=="number"?n.usageLimit:null,y=typeof n.currentUsage=="number"?n.currentUsage:0,p=typeof n.remaining=="number"?n.remaining:null,o=n.hardLimit===!0,d=u.some(s=>s.hasAccess)}else if(h==="BOOLEAN")d=u.some(n=>n.hasAccess);else{console.warn(`[Kelviq SDK] transformApiEntitlements: Encountered unknown featureType: '${h}' for feature '${t}'. This entitlement will be ignored.`);continue}const R={featureId:t,featureType:h,hasAccess:d,hardLimit:o,currentUsage:y,usageLimit:r,remaining:p,items:u};e[t]=R}return e}const c="GET",q=5e3,K=3,P=1e3;function C(a){const{method:e=c,headers:i={},body:t,timeout:u=q,maxRetries:h=K,backoffBaseDelay:y=P,queryParams:r,accessToken:p}=a;let o=a.url,d=0;return new Promise((R,n)=>{if(r){const m=new URLSearchParams;for(const E in r)r[E]!==void 0&&m.append(E,String(r[E]));m.toString()&&(o=o+(o.includes("?")?"&":"?")+m.toString())}function s(){const m=new XMLHttpRequest;m.open(e,o,!0),m.timeout=u;const E={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...i};e!=="GET"&&t&&typeof t=="object"&&!(t instanceof FormData)&&(E["Content-Type"]||(E["Content-Type"]="application/json")),p&&(E.Authorization=`Bearer ${p}`);for(const[l,g]of Object.entries(E))m.setRequestHeader(l,g);m.onload=function(){const{status:l,statusText:g,responseText:T}=m;if(l>=200&&l<300)try{const v=T?JSON.parse(T):{};R({status:l,statusText:g,data:v})}catch(v){const w=v instanceof Error?v:new Error(String(v));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${o}. Error: ${w.message}. Response: ${T}`),n(new Error(`Invalid JSON response: ${w.message}`))}else F(`Request to ${o} failed with status ${l} ${g}. Response: ${T}`)},m.onerror=()=>F(`Network error for URL ${o}. The request could not be completed.`),m.ontimeout=()=>F(`Request to ${o} timed out.`);function F(l){if(d<h){d++;const g=Math.min(y*Math.pow(2,d-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${o}. Attempt ${d}/${h}. Error: ${l}. Retrying in ${g}ms.`),setTimeout(s,g)}else n(new Error(`${l} (Max retries ${h} reached)`))}try{let l=t;t&&typeof t=="object"&&!(t instanceof FormData)&&E["Content-Type"]==="application/json"&&(l=JSON.stringify(t)),m.send(l)}catch(l){const g=l instanceof Error?l:new Error(String(l));console.error(`Kelviq SDK (apiRequest): Error sending request to ${o}.`,g),n(new Error(`Failed to send request: ${g.message}`))}}s()})}const L="https://edge.api.kelviq.com/api/v1/",D="https://edge.sandboxapi.kelviq.com/api/v1/",S="entitlements/";class ${constructor(e,i){A(this,"options");A(this,"entitlementsCache",null);A(this,"rawApiResponse",null);A(this,"isFetching",!1);A(this,"inFlightPromise",null);A(this,"readyPromise",null);A(this,"lastFetchError",null);A(this,"apiRequestService");if(!e||!e.customerId)throw new Error("[Kelviq SDK] KelviqClient: CustomerId is required in options.");this.options={...e,apiConfig:e.apiConfig||{},entitlementsPath:e.entitlementsPath||S},this.apiRequestService=i||C}async fetchAllEntitlements(e=!1){if(this.inFlightPromise&&!e)return this.inFlightPromise;if(this.entitlementsCache&&!e)return Promise.resolve(this.entitlementsCache);this.isFetching=!0,this.lastFetchError=null;const{apiUrl:i=this.options.environment==="sandbox"?D:L,entitlementsPath:t,customerId:u,accessToken:h,apiConfig:y,onError:r}=this.options,p=i.replace(/\/$/,""),o=t.replace(/^\//,""),d=`${p}/${o}`,R={customer_id:u};return this.inFlightPromise=this.apiRequestService({url:d,method:"GET",queryParams:R,accessToken:h,...y||{}}).then(n=>{if(n&&n.data&&Array.isArray(n.data.entitlements))return this.rawApiResponse=n.data,this.entitlementsCache=f(n.data),this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache;{const s=new Error("[Kelviq SDK] Received empty, malformed, or invalid data structure from entitlements API.");throw this.lastFetchError=s,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(s),s}}).catch(n=>{const s=n instanceof Error?n:new Error(String(n));throw this.lastFetchError=s,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(s),s}),this.inFlightPromise}getEntitlement(e){return this.entitlementsCache?this.entitlementsCache[e]??null:(console.warn(`[Kelviq SDK] getEntitlement: Entitlements not fetched or cache is empty for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getEntitlements(){return this.entitlementsCache}getRawEntitlement(e){return this.rawApiResponse?this.rawApiResponse.entitlements.filter(i=>i.featureId===e):(console.warn(`[Kelviq SDK] getRawEntitlement: Entitlements not fetched for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getRawEntitlements(){return this.rawApiResponse}hasAccess(e){if(!this.entitlementsCache)return console.warn(`[Kelviq SDK] hasAccess: Entitlements not fetched yet for featureId '${e}'. Call fetchAllEntitlements() first. Returning false.`),!1;const i=this.entitlementsCache[e];return i?i.hasAccess:!1}isLoading(){return this.isFetching}getLastError(){return this.lastFetchError}ready(){return this.readyPromise??Promise.resolve()}_setReadyPromise(e){this.readyPromise=e}clearCache(){this.entitlementsCache=null,this.rawApiResponse=null,this.isFetching=!1,this.lastFetchError=null,console.log("[Kelviq SDK] Entitlement cache cleared.")}}function U(a,e){const i={...a,initializeAndFetch:a.initializeAndFetch??!0,apiConfig:a.apiConfig||{},environment:a.environment||"production",entitlementsPath:a.entitlementsPath||S},t=new $(i,e);if(i.initializeAndFetch===!0){const u=t.fetchAllEntitlements().catch(h=>{console.error("[Kelviq SDK] Initial fetch on client creation failed:",h.message)});t._setReadyPromise(u.then(()=>{}))}return t}return U});
+(function(f,c){typeof exports=="object"&&typeof module<"u"?module.exports=c():typeof define=="function"&&define.amd?define(c):(f=typeof globalThis<"u"?globalThis:f||self,f.kelviqSDK=c())})(this,function(){"use strict";var U=Object.defineProperty;var _=(f,c,q)=>c in f?U(f,c,{enumerable:!0,configurable:!0,writable:!0,value:q}):f[c]=q;var A=(f,c,q)=>_(f,typeof c!="symbol"?c+"":c,q);function f(a){const e={};if(!a||!Array.isArray(a.entitlements))return console.warn("[Kelviq SDK] transformApiEntitlements: Invalid or empty entitlements array in API response.",a),e;const s={};a.entitlements.forEach(t=>{if(!t||typeof t.featureId!="string"||typeof t.featureType!="string"){console.warn("[Kelviq SDK] transformApiEntitlements: Skipping invalid raw entitlement object:",t);return}s[t.featureId]||(s[t.featureId]=[]),s[t.featureId].push(t)});for(const t of Object.keys(s)){const u=s[t],m=u[0].featureType;let y=0,r=null,p=null,o=!1,d=!1;if(m==="METER"){let n=!0;for(const i of u)y+=typeof i.currentUsage=="number"?i.currentUsage:0,typeof i.usageLimit=="number"&&(r=(r??0)+i.usageLimit,n=!1);n&&(r=null),p=r!==null?r-y:null,o=u.some(i=>i.hardLimit===!0),d=p===null||p>0}else if(m==="CUSTOMIZABLE"){const n=u[0];r=typeof n.usageLimit=="number"?n.usageLimit:null,y=typeof n.currentUsage=="number"?n.currentUsage:0,p=typeof n.remaining=="number"?n.remaining:null,o=n.hardLimit===!0,d=u.some(i=>i.hasAccess)}else if(m==="BOOLEAN")d=u.some(n=>n.hasAccess);else{console.warn(`[Kelviq SDK] transformApiEntitlements: Encountered unknown featureType: '${m}' for feature '${t}'. This entitlement will be ignored.`);continue}const R={featureId:t,featureType:m,hasAccess:d,hardLimit:o,currentUsage:y,usageLimit:r,remaining:p,items:u};e[t]=R}return e}const c="GET",q=5e3,K=3,P=1e3;function C(a){const{method:e=c,headers:s={},body:t,timeout:u=q,maxRetries:m=K,backoffBaseDelay:y=P,queryParams:r,accessToken:p}=a;let o=a.url,d=0;return new Promise((R,n)=>{if(r){const h=new URLSearchParams;for(const E in r)r[E]!==void 0&&h.append(E,String(r[E]));h.toString()&&(o=o+(o.includes("?")?"&":"?")+h.toString())}function i(){const h=new XMLHttpRequest;h.open(e,o,!0),h.timeout=u;const E={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...s};e!=="GET"&&t&&typeof t=="object"&&!(t instanceof FormData)&&(E["Content-Type"]||(E["Content-Type"]="application/json")),p&&(E.Authorization=`Bearer ${p}`);for(const[l,g]of Object.entries(E))h.setRequestHeader(l,g);h.onload=function(){const{status:l,statusText:g,responseText:T}=h;if(l>=200&&l<300)try{const v=T?JSON.parse(T):{};R({status:l,statusText:g,data:v})}catch(v){const w=v instanceof Error?v:new Error(String(v));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${o}. Error: ${w.message}. Response: ${T}`),n(new Error(`Invalid JSON response: ${w.message}`))}else F(`Request to ${o} failed with status ${l} ${g}. Response: ${T}`)},h.onerror=()=>F(`Network error for URL ${o}. The request could not be completed.`),h.ontimeout=()=>F(`Request to ${o} timed out.`);function F(l){if(d<m){d++;const g=Math.min(y*Math.pow(2,d-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${o}. Attempt ${d}/${m}. Error: ${l}. Retrying in ${g}ms.`),setTimeout(i,g)}else n(new Error(`${l} (Max retries ${m} reached)`))}try{let l=t;t&&typeof t=="object"&&!(t instanceof FormData)&&E["Content-Type"]==="application/json"&&(l=JSON.stringify(t)),h.send(l)}catch(l){const g=l instanceof Error?l:new Error(String(l));console.error(`Kelviq SDK (apiRequest): Error sending request to ${o}.`,g),n(new Error(`Failed to send request: ${g.message}`))}}i()})}const L="https://edge.api.kelviq.com/api/v1/",D="https://edge.sandboxapi.kelviq.com/api/v1/",S="entitlements/";class ${constructor(e,s){A(this,"options");A(this,"entitlementsCache",null);A(this,"rawApiResponse",null);A(this,"isFetching",!1);A(this,"inFlightPromise",null);A(this,"readyPromise",null);A(this,"lastFetchError",null);A(this,"apiRequestService");if(!e||!e.customerId)throw new Error("[Kelviq SDK] KelviqClient: CustomerId is required in options.");this.options={...e,apiConfig:e.apiConfig||{},entitlementsPath:e.entitlementsPath||S},this.apiRequestService=s||C}async fetchAllEntitlements(e=!1){if(this.inFlightPromise&&!e)return this.inFlightPromise;if(this.entitlementsCache&&!e)return Promise.resolve(this.entitlementsCache);this.isFetching=!0,this.lastFetchError=null;const{apiUrl:s=this.options.environment==="sandbox"?D:L,entitlementsPath:t,customerId:u,accessToken:m,apiConfig:y,onError:r}=this.options,p=s.replace(/\/$/,""),o=t.replace(/^\//,""),d=`${p}/${o}`,R={customer_id:u};return this.inFlightPromise=this.apiRequestService({url:d,method:"GET",queryParams:R,accessToken:m,...y||{}}).then(n=>{if(n&&n.data&&Array.isArray(n.data.entitlements)){const i=n.data;return this.rawApiResponse={customerId:i.customer_id??i.customerId,entitlements:i.entitlements},this.entitlementsCache=f(n.data),this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache}else{const i=new Error("[Kelviq SDK] Received empty, malformed, or invalid data structure from entitlements API.");throw this.lastFetchError=i,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(i),i}}).catch(n=>{const i=n instanceof Error?n:new Error(String(n));throw this.lastFetchError=i,this.isFetching=!1,this.inFlightPromise=null,this.entitlementsCache=null,this.rawApiResponse=null,r&&r(i),i}),this.inFlightPromise}getEntitlement(e){return this.entitlementsCache?this.entitlementsCache[e]??null:(console.warn(`[Kelviq SDK] getEntitlement: Entitlements not fetched or cache is empty for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getEntitlements(){return this.entitlementsCache}getRawEntitlement(e){return this.rawApiResponse?this.rawApiResponse.entitlements.filter(s=>s.featureId===e):(console.warn(`[Kelviq SDK] getRawEntitlement: Entitlements not fetched for featureId '${e}'. Call fetchAllEntitlements() first.`),null)}getRawEntitlements(){return this.rawApiResponse}hasAccess(e){if(!this.entitlementsCache)return console.warn(`[Kelviq SDK] hasAccess: Entitlements not fetched yet for featureId '${e}'. Call fetchAllEntitlements() first. Returning false.`),!1;const s=this.entitlementsCache[e];return s?s.hasAccess:!1}isLoading(){return this.isFetching}getLastError(){return this.lastFetchError}ready(){return this.readyPromise??Promise.resolve()}_setReadyPromise(e){this.readyPromise=e}clearCache(){this.entitlementsCache=null,this.rawApiResponse=null,this.isFetching=!1,this.lastFetchError=null,console.log("[Kelviq SDK] Entitlement cache cleared.")}}function I(a,e){const s={...a,initializeAndFetch:a.initializeAndFetch??!0,apiConfig:a.apiConfig||{},environment:a.environment||"production",entitlementsPath:a.entitlementsPath||S},t=new $(s,e);if(s.initializeAndFetch===!0){const u=t.fetchAllEntitlements().catch(m=>{console.error("[Kelviq SDK] Initial fetch on client creation failed:",m.message)});t._setReadyPromise(u.then(()=>{}))}return t}return I});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kelviq/js-sdk",
-  "version": "2.0.0-beta",
+  "version": "2.0.0",
   "module": "./dist/kelviq-js-sdk.js",
   "type": "module",
   "files": [