@kelviq/react-sdk 2.0.0-beta → 2.0.1-beta

package/dist/contexts/KelviqContext.d.ts

@@ -1,5 +1,6 @@
 import { Entitlement, EntitlementMap, EntitlementsResponse } from '../types/sdk.types';
 import { AsyncState } from '../types';
+import { RawSubscriptionData, RawCustomerApiResponse } from '../types/api.types';
 /** Defines the shape of the context value provided by KelviqProvider. */
 export interface KelviqContextValue {
     allEntitlements: AsyncState<EntitlementMap | null>;
@@ -14,6 +15,14 @@ export interface KelviqContextValue {
     getRawEntitlement: (featureId: string) => EntitlementsResponse | null;
     hasAccess: (featureId: string) => boolean;
     updateEntitlement: (featureId: string, data: Partial<Omit<Entitlement, 'featureId' | 'featureType' | 'items'>>) => void;
+    /** Subscription data for the customer. Only populated when fetchSubscriptionsOnMount is true. */
+    subscriptions: AsyncState<RawSubscriptionData[] | null>;
+    /** Manually refresh subscriptions data. */
+    refreshSubscriptions: () => Promise<void>;
+    /** Customer data. Only populated when fetchCustomerOnMount is true. */
+    customer: AsyncState<RawCustomerApiResponse | null>;
+    /** Manually refresh customer data. */
+    refreshCustomer: () => Promise<void>;
     isLoading: boolean;
     error: Error | null;
     customerId: string;

package/dist/hooks/useCustomer.d.ts

@@ -0,0 +1,9 @@
+import { AsyncState } from '../types';
+import { RawCustomerApiResponse } from '../types/api.types';
+/**
+ * Hook to get customer data.
+ * Only populated when `fetchCustomerOnMount` is enabled in the provider config,
+ * or after calling `refreshCustomer()` from `useKelviq()`.
+ * @returns AsyncState containing the customer data or null.
+ */
+export declare const useCustomer: () => AsyncState<RawCustomerApiResponse | null>;

package/dist/hooks/useSubscriptions.d.ts

@@ -0,0 +1,9 @@
+import { AsyncState } from '../types';
+import { RawSubscriptionData } from '../types/api.types';
+/**
+ * Hook to get the customer's subscription data.
+ * Only populated when `fetchSubscriptionsOnMount` is enabled in the provider config,
+ * or after calling `refreshSubscriptions()` from `useKelviq()`.
+ * @returns AsyncState containing the array of subscriptions or null.
+ */
+export declare const useSubscriptions: () => AsyncState<RawSubscriptionData[] | null>;

package/dist/index.d.ts

@@ -9,3 +9,5 @@ export * from './hooks/useAllEntitlements';
 export * from './hooks/useBooleanEntitlement';
 export * from './hooks/useCustomizableEntitlement';
 export * from './hooks/useMeteredEntitlement';
+export * from './hooks/useSubscriptions';
+export * from './hooks/useCustomer';

package/dist/kelviq-react-sdk.js

@@ -1,164 +1,164 @@
-import { jsx as v, Fragment as $ } from "react/jsx-runtime";
-import { createContext as N, useState as P, useCallback as T, useEffect as H, useMemo as G, useContext as W } from "react";
-const X = "GET", z = 5e3, J = 3, V = 1e3;
-function Y(t) {
+import { jsx as S, Fragment as M } from "react/jsx-runtime";
+import { createContext as Z, useState as T, useCallback as y, useEffect as Q, useMemo as ee, useContext as te } from "react";
+const re = "GET", ne = 5e3, se = 3, oe = 1e3;
+function O(n) {
   const {
-    method: r = X,
-    headers: s = {},
+    method: o = re,
+    headers: i = {},
     // Renamed to avoid conflict with internal 'headers' variable
-    body: e,
-    timeout: E = z,
-    maxRetries: A = J,
-    backoffBaseDelay: h = V,
-    queryParams: L,
-    accessToken: a
+    body: t,
+    timeout: g = ne,
+    maxRetries: m = se,
+    backoffBaseDelay: L = oe,
+    queryParams: v,
+    accessToken: l
     // Use the direct accessToken
-  } = t;
-  let { url: f } = t, y = 0;
-  return new Promise((K, p) => {
-    if (L) {
-      const o = new URLSearchParams();
-      for (const u in L)
-        L[u] !== void 0 && o.append(u, String(L[u]));
-      o.toString() && (f += (f.includes("?") ? "&" : "?") + o.toString());
+  } = n;
+  let { url: f } = n, p = 0;
+  return new Promise((U, b) => {
+    if (v) {
+      const s = new URLSearchParams();
+      for (const u in v)
+        v[u] !== void 0 && s.append(u, String(v[u]));
+      s.toString() && (f += (f.includes("?") ? "&" : "?") + s.toString());
     }
-    function g() {
-      const o = new XMLHttpRequest();
-      o.open(r, f, !0), o.timeout = E;
+    function C() {
+      const s = new XMLHttpRequest();
+      s.open(o, f, !0), s.timeout = g;
       const u = {
         Accept: "application/json",
         "X-Requested-With": "XMLHttpRequest",
-        ...s
+        ...i
         // Apply custom headers, allowing them to override defaults
       };
-      r !== "GET" && e && typeof e == "object" && !(e instanceof FormData) && (u["Content-Type"] || (u["Content-Type"] = "application/json")), a && (u.Authorization = `Bearer ${a}`);
-      for (const [i, c] of Object.entries(u))
-        o.setRequestHeader(i, c);
-      o.onload = function() {
-        const { status: i, statusText: c, responseText: U } = o;
-        if (i >= 200 && i < 300)
+      o !== "GET" && t && typeof t == "object" && !(t instanceof FormData) && (u["Content-Type"] || (u["Content-Type"] = "application/json")), l && (u.Authorization = `Bearer ${l}`);
+      for (const [a, w] of Object.entries(u))
+        s.setRequestHeader(a, w);
+      s.onload = function() {
+        const { status: a, statusText: w, responseText: P } = s;
+        if (a >= 200 && a < 300)
           try {
-            const w = U ? JSON.parse(U) : {};
-            K({ status: i, statusText: c, data: w });
-          } catch (w) {
-            const R = w instanceof Error ? w : new Error(String(w));
+            const A = P ? JSON.parse(P) : {};
+            U({ status: a, statusText: w, data: A });
+          } catch (A) {
+            const I = A instanceof Error ? A : new Error(String(A));
             console.error(
-              `Kelviq SDK (apiRequest): Invalid JSON response for URL ${f}. Error: ${R.message}. Response: ${U}`
-            ), p(
+              `Kelviq SDK (apiRequest): Invalid JSON response for URL ${f}. Error: ${I.message}. Response: ${P}`
+            ), b(
               new Error(
-                `Invalid JSON response: ${R.message}`
+                `Invalid JSON response: ${I.message}`
               )
             );
           }
         else
-          S(
-            `Request to ${f} failed with status ${i} ${c}. Response: ${U}`
+          h(
+            `Request to ${f} failed with status ${a} ${w}. Response: ${P}`
           );
-      }, o.onerror = () => S(
+      }, s.onerror = () => h(
         `Network error for URL ${f}. The request could not be completed.`
-      ), o.ontimeout = () => S(`Request to ${f} timed out.`);
-      function S(i) {
-        if (y < A) {
-          y++;
-          const c = Math.min(
-            h * Math.pow(2, y - 1),
+      ), s.ontimeout = () => h(`Request to ${f} timed out.`);
+      function h(a) {
+        if (p < m) {
+          p++;
+          const w = Math.min(
+            L * Math.pow(2, p - 1),
             3e4
             // Cap retry delay at 30 seconds
           );
           console.warn(
-            `Kelviq SDK (apiRequest): Retrying request to ${f}. Attempt ${y}/${A}. Error: ${i}. Retrying in ${c}ms.`
-          ), setTimeout(g, c);
+            `Kelviq SDK (apiRequest): Retrying request to ${f}. Attempt ${p}/${m}. Error: ${a}. Retrying in ${w}ms.`
+          ), setTimeout(C, w);
         } else
-          p(
+          b(
             new Error(
-              `${i} (Max retries ${A} reached)`
+              `${a} (Max retries ${m} reached)`
             )
           );
       }
       try {
-        let i = e;
-        e && typeof e == "object" && !(e instanceof FormData) && u["Content-Type"] === "application/json" && (i = JSON.stringify(e)), o.send(i);
-      } catch (i) {
-        const c = i instanceof Error ? i : new Error(String(i));
+        let a = t;
+        t && typeof t == "object" && !(t instanceof FormData) && u["Content-Type"] === "application/json" && (a = JSON.stringify(t)), s.send(a);
+      } catch (a) {
+        const w = a instanceof Error ? a : new Error(String(a));
         console.error(
           `Kelviq SDK (apiRequest): Error sending request to ${f}.`,
-          c
-        ), p(new Error(`Failed to send request: ${c.message}`));
+          w
+        ), b(new Error(`Failed to send request: ${w.message}`));
       }
     }
-    g();
+    C();
   });
 }
-function Z(t, r) {
-  const s = r[0].featureType;
-  if (s === "METER") {
-    let e = 0, E = 0, A = !1;
-    for (const L of r) {
-      const a = L, f = typeof a.usageLimit == "number" ? a.usageLimit : null, y = typeof a.currentUsage == "number" ? a.currentUsage : 0;
-      f === null && (e = null), e !== null && (e += f), E += y, a.hardLimit && (A = !0);
+function ie(n, o) {
+  const i = o[0].featureType;
+  if (i === "METER") {
+    let t = 0, g = 0, m = !1;
+    for (const v of o) {
+      const l = v, f = typeof l.usageLimit == "number" ? l.usageLimit : null, p = typeof l.currentUsage == "number" ? l.currentUsage : 0;
+      f === null && (t = null), t !== null && (t += f), g += p, l.hardLimit && (m = !0);
     }
-    const h = e !== null ? e - E : null;
+    const L = t !== null ? t - g : null;
     return {
-      featureId: t,
-      featureType: s,
-      hasAccess: h === null || h > 0,
-      currentUsage: E,
-      usageLimit: e,
-      remaining: h,
-      hardLimit: A,
-      items: r
+      featureId: n,
+      featureType: i,
+      hasAccess: L === null || L > 0,
+      currentUsage: g,
+      usageLimit: t,
+      remaining: L,
+      hardLimit: m,
+      items: o
     };
   }
-  if (s === "CUSTOMIZABLE") {
-    const e = r[0];
+  if (i === "CUSTOMIZABLE") {
+    const t = o[0];
     return {
-      featureId: t,
-      featureType: s,
-      hasAccess: r.some((E) => E.hasAccess),
-      currentUsage: typeof e.currentUsage == "number" ? e.currentUsage : 0,
-      usageLimit: typeof e.usageLimit == "number" ? e.usageLimit : null,
-      remaining: typeof e.remaining == "number" ? e.remaining : null,
-      hardLimit: e.hardLimit === !0,
-      items: r
+      featureId: n,
+      featureType: i,
+      hasAccess: o.some((g) => g.hasAccess),
+      currentUsage: typeof t.currentUsage == "number" ? t.currentUsage : 0,
+      usageLimit: typeof t.usageLimit == "number" ? t.usageLimit : null,
+      remaining: typeof t.remaining == "number" ? t.remaining : null,
+      hardLimit: t.hardLimit === !0,
+      items: o
     };
   }
   return {
-    featureId: t,
-    featureType: s,
-    hasAccess: r.some((e) => e.hasAccess),
+    featureId: n,
+    featureType: i,
+    hasAccess: o.some((t) => t.hasAccess),
     currentUsage: 0,
     usageLimit: null,
     remaining: null,
     hardLimit: !1,
-    items: r
+    items: o
   };
 }
-function Q(t) {
-  const r = {};
-  if (!t || !Array.isArray(t.entitlements))
+function ae(n) {
+  const o = {};
+  if (!n || !Array.isArray(n.entitlements))
     return console.warn(
       "Kelviq SDK: Invalid or empty entitlements array in API response.",
-      t
-    ), r;
-  const s = {};
-  for (const e of t.entitlements) {
-    if (!e || typeof e.featureId != "string" || typeof e.featureType != "string") {
+      n
+    ), o;
+  const i = {};
+  for (const t of n.entitlements) {
+    if (!t || typeof t.featureId != "string" || typeof t.featureType != "string") {
       console.warn(
         "Kelviq SDK: Skipping invalid raw entitlement object:",
-        e
+        t
       );
       continue;
     }
-    s[e.featureId] || (s[e.featureId] = []), s[e.featureId].push(e);
+    i[t.featureId] || (i[t.featureId] = []), i[t.featureId].push(t);
   }
-  for (const e in s)
-    r[e] = Z(
-      e,
-      s[e]
+  for (const t in i)
+    o[t] = ie(
+      t,
+      i[t]
     );
-  return r;
+  return o;
 }
-const B = {
+const J = {
   allEntitlements: {
     data: null,
     isLoading: !0,
@@ -177,281 +177,472 @@ const B = {
       "updateEntitlement called on default KelviqContext. Ensure KelviqProvider is properly set up."
     );
   },
+  subscriptions: {
+    data: null,
+    isLoading: !1,
+    error: null
+  },
+  refreshSubscriptions: () => (console.warn(
+    "refreshSubscriptions called on default KelviqContext. Ensure KelviqProvider is properly set up."
+  ), Promise.resolve()),
+  customer: {
+    data: null,
+    isLoading: !1,
+    error: null
+  },
+  refreshCustomer: () => (console.warn(
+    "refreshCustomer called on default KelviqContext. Ensure KelviqProvider is properly set up."
+  ), Promise.resolve()),
   isLoading: !0,
   error: null,
   apiUrl: "",
   environment: "production",
   entitlementsPath: "",
   customerId: ""
-}, O = N(
-  B
-), ee = "https://edge.api.kelviq.com/api/v1/", te = "https://edge.sandboxapi.kelviq.com/api/v1/", ne = "entitlements/", oe = ({
-  children: t,
-  apiUrl: r,
-  entitlementsPath: s = ne,
-  customerId: e,
-  environment: E = "production",
-  accessToken: A,
-  config: h = {}
+}, V = Z(
+  J
+), le = "https://edge.api.kelviq.com/api/v1/", ue = "https://edge.sandboxapi.kelviq.com/api/v1/", ce = "entitlements/", me = ({
+  children: n,
+  apiUrl: o,
+  entitlementsPath: i = ce,
+  customerId: t,
+  environment: g = "production",
+  accessToken: m,
+  config: L = {}
 }) => {
   const {
-    onError: L,
-    maxRetries: a,
+    onError: v,
+    maxRetries: l,
     timeout: f,
-    backoffBaseDelay: y,
-    fetchEntitlementsOnMount: K = !0
-  } = h, p = r || (E === "sandbox" ? te : ee), [g, o] = P({
+    backoffBaseDelay: p,
+    fetchEntitlementsOnMount: U = !0,
+    fetchSubscriptionsOnMount: b = !1,
+    fetchCustomerOnMount: C = !1
+  } = L, s = o || (g === "sandbox" ? ue : le), [u, h] = T({
     data: null,
-    isLoading: !!p && K,
+    isLoading: !!s && U,
     error: null
-  }), [u, S] = P(null), [i, c] = P(
-    !!p && K
-  ), [U, w] = P(null), R = T(
-    (d, l, n) => {
-      const m = new Error(
-        `Kelviq SDK (${l}): ${d}`
+  }), [a, w] = T(null), [P, A] = T({
+    data: null,
+    isLoading: !!s && b,
+    error: null
+  }), [I, $] = T({
+    data: null,
+    isLoading: !!s && C,
+    error: null
+  }), [D, K] = T(
+    !!s && U
+  ), [k, x] = T(null), E = y(
+    (c, e, r) => {
+      const d = new Error(
+        `Kelviq SDK (${e}): ${c}`
       );
-      console.error(m.message, n || ""), w((q) => q || m), L && L(m);
+      console.error(d.message, r || ""), x((q) => q || d), v && v(d);
     },
-    [L]
-  ), b = T(() => {
-    if (!p) {
-      const n = "API URL not configured. Cannot fetch entitlements.";
-      return o({
+    [v]
+  ), _ = y(() => {
+    if (!s) {
+      const r = "API URL not configured. Cannot fetch entitlements.";
+      return h({
         data: null,
         isLoading: !1,
-        error: new Error(n)
-      }), R(n, "fetchAllEntitlements"), c(!1), Promise.reject(new Error(n));
+        error: new Error(r)
+      }), E(r, "fetchAllEntitlements"), K(!1), Promise.reject(new Error(r));
     }
-    if (!e) {
-      const n = "CustomerId must be provided as props to KelviqProvider.";
-      return o(() => ({
+    if (!t) {
+      const r = "CustomerId must be provided as props to KelviqProvider.";
+      return h(() => ({
         data: null,
         isLoading: !1,
-        error: new Error(n)
-      })), R(n, "fetchAllEntitlements"), c(!1), Promise.reject(new Error(n));
+        error: new Error(r)
+      })), E(r, "fetchAllEntitlements"), K(!1), Promise.reject(new Error(r));
     }
-    o((n) => ({
-      ...n,
+    h((r) => ({
+      ...r,
       isLoading: !0,
       error: null
-    })), c(!0), w(null);
-    const d = `${p.replace(/\/$/, "")}/${s.replace(/^\//, "")}`;
-    return Y({
-      url: d,
+    })), K(!0), x(null);
+    const c = `${s.replace(/\/$/, "")}/${i.replace(/^\//, "")}`;
+    return O({
+      url: c,
       method: "GET",
       timeout: f,
-      maxRetries: a,
-      backoffBaseDelay: y,
-      accessToken: A,
+      maxRetries: l,
+      backoffBaseDelay: p,
+      accessToken: m,
       queryParams: {
-        customer_id: e
+        customer_id: t
       }
-    }).then((n) => {
-      if (n && n.data && Array.isArray(n.data.entitlements)) {
-        S(n.data);
-        const m = Q(
-          n.data
+    }).then((r) => {
+      if (r && r.data && Array.isArray(r.data.entitlements)) {
+        w(r.data);
+        const d = ae(
+          r.data
         );
-        o({
-          data: m,
+        h({
+          data: d,
           isLoading: !1,
           error: null
         });
       } else {
-        const m = new Error(
+        const d = new Error(
           "Received empty, malformed, or invalid data structure from entitlements API."
         );
-        throw o({
+        throw h({
           data: null,
           isLoading: !1,
-          error: m
-        }), R(
-          m.message,
+          error: d
+        }), E(
+          d.message,
           "fetchAllEntitlements",
-          n
-        ), m;
+          r
+        ), d;
       }
-    }).catch((n) => {
-      const m = n instanceof Error ? n : new Error(String(n));
-      return o((q) => ({
+    }).catch((r) => {
+      const d = r instanceof Error ? r : new Error(String(r));
+      return h((q) => ({
         ...q,
         isLoading: !1,
-        error: m
-      })), R(m.message, "fetchAllEntitlements", n), Promise.reject(m);
+        error: d
+      })), E(d.message, "fetchAllEntitlements", r), Promise.reject(d);
     }).finally(() => {
-      c(!1);
+      K(!1);
     });
   }, [
+    s,
+    t,
+    i,
+    f,
+    l,
     p,
-    e,
+    m,
+    E
+  ]), j = y(() => {
+    if (!s) {
+      const e = "API URL not configured. Cannot fetch subscriptions.";
+      return A({
+        data: null,
+        isLoading: !1,
+        error: new Error(e)
+      }), E(e, "fetchSubscriptions"), Promise.reject(new Error(e));
+    }
+    if (!t) {
+      const e = "CustomerId must be provided as props to KelviqProvider.";
+      return A({
+        data: null,
+        isLoading: !1,
+        error: new Error(e)
+      }), E(e, "fetchSubscriptions"), Promise.reject(new Error(e));
+    }
+    A((e) => ({
+      ...e,
+      isLoading: !0,
+      error: null
+    }));
+    const c = `${s.replace(/\/$/, "")}/subscriptions/`;
+    return O({
+      url: c,
+      method: "GET",
+      timeout: f,
+      maxRetries: l,
+      backoffBaseDelay: p,
+      accessToken: m,
+      queryParams: { customer_id: t }
+    }).then((e) => {
+      if (e && e.data && Array.isArray(e.data.results))
+        A({
+          data: e.data.results,
+          isLoading: !1,
+          error: null
+        });
+      else {
+        const r = new Error(
+          "Received empty, malformed, or invalid data structure from subscriptions API."
+        );
+        throw A({
+          data: null,
+          isLoading: !1,
+          error: r
+        }), E(
+          r.message,
+          "fetchSubscriptions",
+          e
+        ), r;
+      }
+    }).catch((e) => {
+      const r = e instanceof Error ? e : new Error(String(e));
+      return A((d) => ({
+        ...d,
+        isLoading: !1,
+        error: r
+      })), E(
+        r.message,
+        "fetchSubscriptions",
+        e
+      ), Promise.reject(r);
+    });
+  }, [
     s,
+    t,
     f,
-    a,
-    y,
-    A,
-    R
+    l,
+    p,
+    m,
+    E
+  ]), F = y(() => {
+    if (!s) {
+      const e = "API URL not configured. Cannot fetch customer.";
+      return $({
+        data: null,
+        isLoading: !1,
+        error: new Error(e)
+      }), E(e, "fetchCustomer"), Promise.reject(new Error(e));
+    }
+    if (!t) {
+      const e = "CustomerId must be provided as props to KelviqProvider.";
+      return $({
+        data: null,
+        isLoading: !1,
+        error: new Error(e)
+      }), E(e, "fetchCustomer"), Promise.reject(new Error(e));
+    }
+    $((e) => ({
+      ...e,
+      isLoading: !0,
+      error: null
+    }));
+    const c = `${s.replace(/\/$/, "")}/customers/${t}/`;
+    return O({
+      url: c,
+      method: "GET",
+      timeout: f,
+      maxRetries: l,
+      backoffBaseDelay: p,
+      accessToken: m
+    }).then((e) => {
+      if (e && e.data)
+        $({
+          data: e.data,
+          isLoading: !1,
+          error: null
+        });
+      else {
+        const r = new Error(
+          "Received empty or invalid data from customer API."
+        );
+        throw $({
+          data: null,
+          isLoading: !1,
+          error: r
+        }), E(
+          r.message,
+          "fetchCustomer",
+          e
+        ), r;
+      }
+    }).catch((e) => {
+      const r = e instanceof Error ? e : new Error(String(e));
+      return $((d) => ({
+        ...d,
+        isLoading: !1,
+        error: r
+      })), E(r.message, "fetchCustomer", e), Promise.reject(r);
+    });
+  }, [
+    s,
+    t,
+    f,
+    l,
+    p,
+    m,
+    E
   ]);
-  H(() => {
-    let d = !0;
-    if (!p) {
-      if (d) {
-        const l = new Error(
+  Q(() => {
+    let c = !0;
+    if (!s) {
+      if (c) {
+        const e = new Error(
           "KelviqProvider: `apiBaseUrl` must be provided in config."
         );
-        w(l), c(!1), o((n) => ({
-          ...n,
+        x(e), K(!1), h((r) => ({
+          ...r,
           isLoading: !1,
-          error: l
-        })), h.onError && h.onError(l);
+          error: e
+        })), L.onError && L.onError(e);
       }
       return;
     }
-    return K ? b().catch((l) => {
-      d && i && c(!1), console.error(
+    return U ? _().catch((e) => {
+      c && D && K(!1), console.error(
         "Kelviq SDK: Initial entitlement fetch failed.",
-        l
+        e
       );
-    }) : d && (o((l) => ({
-      ...l,
+    }) : c && (h((e) => ({
+      ...e,
       isLoading: !1,
       data: null,
       error: null
-    })), c(!1)), () => {
-      d = !1;
+    })), K(!1)), b && j().catch((e) => {
+      console.error(
+        "Kelviq SDK: Initial subscriptions fetch failed.",
+        e
+      );
+    }), C && F().catch((e) => {
+      console.error(
+        "Kelviq SDK: Initial customer fetch failed.",
+        e
+      );
+    }), () => {
+      c = !1;
     };
-  }, [p, K, h.onError]);
-  const x = T(
-    () => g.data ? g.data : {},
-    [g.data]
-  ), M = T(
-    () => u ? {
-      customerId: u.customer_id,
-      entitlements: u.entitlements
+  }, [s, U, b, C, L.onError]);
+  const N = y(
+    () => u.data ? u.data : {},
+    [u.data]
+  ), G = y(
+    () => a ? {
+      customerId: a.customerId,
+      entitlements: a.entitlements
     } : null,
-    [u]
-  ), C = T(
-    (d) => u ? {
-      customerId: u.customer_id,
-      entitlements: u.entitlements.filter(
-        (l) => l.featureId === d
+    [a]
+  ), H = y(
+    (c) => a ? {
+      customerId: a.customerId,
+      entitlements: a.entitlements.filter(
+        (e) => e.featureId === c
       )
     } : null,
-    [u]
-  ), _ = T(
-    (d) => g.data ? g.data[d] ?? null : null,
-    [g.data]
-  ), F = T(
-    (d, l) => {
-      o((n) => {
-        if (!n.data) return n;
-        const m = n.data[d];
-        if (!m) return n;
-        const q = { ...m, ...l };
-        return ("usageLimit" in l || "currentUsage" in l) && (q.remaining = q.usageLimit !== null ? q.usageLimit - q.currentUsage : null), {
-          ...n,
+    [a]
+  ), W = y(
+    (c) => u.data ? u.data[c] ?? null : null,
+    [u.data]
+  ), X = y(
+    (c, e) => {
+      h((r) => {
+        if (!r.data) return r;
+        const d = r.data[c];
+        if (!d) return r;
+        const q = { ...d, ...e };
+        return ("usageLimit" in e || "currentUsage" in e) && (q.remaining = q.usageLimit !== null ? q.usageLimit - q.currentUsage : null), {
+          ...r,
           data: {
-            ...n.data,
-            [d]: q
+            ...r.data,
+            [c]: q
           }
         };
       });
     },
     []
-  ), k = T(
-    (d) => {
-      if (!g.data) return !1;
-      const l = g.data[d];
-      return l ? l.hasAccess : !1;
+  ), z = y(
+    (c) => {
+      if (!u.data) return !1;
+      const e = u.data[c];
+      return e ? e.hasAccess : !1;
     },
-    [g.data]
-  ), j = G(
+    [u.data]
+  ), Y = ee(
     () => ({
-      allEntitlements: g,
-      refreshAllEntitlements: b,
-      getEntitlements: x,
-      getEntitlement: _,
-      getRawEntitlements: M,
-      getRawEntitlement: C,
-      hasAccess: k,
-      updateEntitlement: F,
-      isLoading: i,
-      error: U,
-      environment: E,
-      apiUrl: p,
-      entitlementsPath: s,
-      customerId: e
+      allEntitlements: u,
+      refreshAllEntitlements: _,
+      getEntitlements: N,
+      getEntitlement: W,
+      getRawEntitlements: G,
+      getRawEntitlement: H,
+      hasAccess: z,
+      updateEntitlement: X,
+      subscriptions: P,
+      refreshSubscriptions: j,
+      customer: I,
+      refreshCustomer: F,
+      isLoading: D,
+      error: k,
+      environment: g,
+      apiUrl: s,
+      entitlementsPath: i,
+      customerId: t
     }),
     [
-      g,
-      b,
-      x,
+      u,
       _,
-      M,
-      C,
-      k,
+      N,
+      W,
+      G,
+      H,
+      z,
+      X,
+      P,
+      j,
+      I,
       F,
-      i,
-      U,
-      E,
-      p,
+      D,
+      k,
+      g,
       s,
-      e
+      i,
+      t
     ]
   );
-  return /* @__PURE__ */ v(O.Provider, { value: j, children: t });
-}, D = () => {
-  const t = W(O);
-  if (t === void 0 || t === B)
+  return /* @__PURE__ */ S(V.Provider, { value: Y, children: n });
+}, R = () => {
+  const n = te(V);
+  if (n === void 0 || n === J)
     throw new Error(
       "useKelviq must be used within an initialized KelviqProvider."
     );
-  return t;
-}, I = ({
-  featureId: t,
-  children: r,
-  fallback: s = null,
-  loadingComponent: e,
-  condition: E
+  return n;
+}, B = ({
+  featureId: n,
+  children: o,
+  fallback: i = null,
+  loadingComponent: t,
+  condition: g
 }) => {
   const {
-    getEntitlement: A,
-    isLoading: h,
-    error: L
-  } = D(), a = A(t);
-  return h && !a ? /* @__PURE__ */ v($, { children: e !== void 0 ? e : s }) : L && !a ? /* @__PURE__ */ v($, { children: s }) : !a || !a.hasAccess || E && !E(a) ? /* @__PURE__ */ v($, { children: s }) : typeof r == "function" ? /* @__PURE__ */ v($, { children: r(a) }) : /* @__PURE__ */ v($, { children: r });
-}, ie = (t) => /* @__PURE__ */ v(I, { ...t }), le = (t) => {
-  const r = (s) => s.hasAccess && (s.remaining === null || s.remaining > 0);
-  return /* @__PURE__ */ v(
-    I,
+    getEntitlement: m,
+    isLoading: L,
+    error: v
+  } = R(), l = m(n);
+  return L && !l ? /* @__PURE__ */ S(M, { children: t !== void 0 ? t : i }) : v && !l ? /* @__PURE__ */ S(M, { children: i }) : !l || !l.hasAccess || g && !g(l) ? /* @__PURE__ */ S(M, { children: i }) : typeof o == "function" ? /* @__PURE__ */ S(M, { children: o(l) }) : /* @__PURE__ */ S(M, { children: o });
+}, Ee = (n) => /* @__PURE__ */ S(B, { ...n }), ge = (n) => {
+  const o = (i) => i.hasAccess && (i.remaining === null || i.remaining > 0);
+  return /* @__PURE__ */ S(
+    B,
     {
-      ...t,
-      condition: t.condition || r
+      ...n,
+      condition: n.condition || o
     }
   );
-}, ae = (t) => /* @__PURE__ */ v(I, { ...t }), ue = () => {
-  const { allEntitlements: t } = D();
-  return t;
-}, ce = (t) => {
-  const { getEntitlement: r } = D();
-  return r(t);
-}, de = (t) => {
-  const { getEntitlement: r } = D();
-  return r(t);
-}, me = (t) => {
-  const { getEntitlement: r } = D();
-  return r(t);
+}, pe = (n) => /* @__PURE__ */ S(B, { ...n }), he = () => {
+  const { allEntitlements: n } = R();
+  return n;
+}, Le = (n) => {
+  const { getEntitlement: o } = R();
+  return o(n);
+}, ve = (n) => {
+  const { getEntitlement: o } = R();
+  return o(n);
+}, we = (n) => {
+  const { getEntitlement: o } = R();
+  return o(n);
+}, Ae = () => {
+  const { subscriptions: n } = R();
+  return n;
+}, ye = () => {
+  const { customer: n } = R();
+  return n;
 };
 export {
-  O as KelviqContext,
-  oe as KelviqProvider,
-  ae as ShowWhenBooleanEntitled,
-  ie as ShowWhenCustomizableEntitled,
-  le as ShowWhenMeteredEntitled,
-  B as defaultKelviqContextValue,
-  ue as useAllEntitlements,
-  ce as useBooleanEntitlement,
-  de as useCustomizableEntitlement,
-  D as useKelviq,
-  me as useMeteredEntitlement
+  V as KelviqContext,
+  me as KelviqProvider,
+  pe as ShowWhenBooleanEntitled,
+  Ee as ShowWhenCustomizableEntitled,
+  ge as ShowWhenMeteredEntitled,
+  J as defaultKelviqContextValue,
+  he as useAllEntitlements,
+  Le as useBooleanEntitlement,
+  ye as useCustomer,
+  ve as useCustomizableEntitlement,
+  R as useKelviq,
+  we as useMeteredEntitlement,
+  Ae as useSubscriptions
 };

package/dist/kelviq-react-sdk.umd.cjs

@@ -1 +1 @@
-(function(a,u){typeof exports=="object"&&typeof module<"u"?u(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],u):(a=typeof globalThis<"u"?globalThis:a||self,u(a.KelviqReactSDK={},a.jsxRuntime,a.React))})(this,function(a,u,E){"use strict";const x="GET";function j(t){const{method:r=x,headers:s={},body:e,timeout:p=5e3,maxRetries:v=3,backoffBaseDelay:y=1e3,queryParams:q,accessToken:c}=t;let{url:h}=t,w=0;return new Promise((C,L)=>{if(q){const i=new URLSearchParams;for(const d in q)q[d]!==void 0&&i.append(d,String(q[d]));i.toString()&&(h+=(h.includes("?")?"&":"?")+i.toString())}function A(){const i=new XMLHttpRequest;i.open(r,h,!0),i.timeout=p;const d={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...s};r!=="GET"&&e&&typeof e=="object"&&!(e instanceof FormData)&&(d["Content-Type"]||(d["Content-Type"]="application/json")),c&&(d.Authorization=`Bearer ${c}`);for(const[o,f]of Object.entries(d))i.setRequestHeader(o,f);i.onload=function(){const{status:o,statusText:f,responseText:K}=i;if(o>=200&&o<300)try{const T=K?JSON.parse(K):{};C({status:o,statusText:f,data:T})}catch(T){const U=T instanceof Error?T:new Error(String(T));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${h}. Error: ${U.message}. Response: ${K}`),L(new Error(`Invalid JSON response: ${U.message}`))}else D(`Request to ${h} failed with status ${o} ${f}. Response: ${K}`)},i.onerror=()=>D(`Network error for URL ${h}. The request could not be completed.`),i.ontimeout=()=>D(`Request to ${h} timed out.`);function D(o){if(w<v){w++;const f=Math.min(y*Math.pow(2,w-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${h}. Attempt ${w}/${v}. Error: ${o}. Retrying in ${f}ms.`),setTimeout(A,f)}else L(new Error(`${o} (Max retries ${v} reached)`))}try{let o=e;e&&typeof e=="object"&&!(e instanceof FormData)&&d["Content-Type"]==="application/json"&&(o=JSON.stringify(e)),i.send(o)}catch(o){const f=o instanceof Error?o:new Error(String(o));console.error(`Kelviq SDK (apiRequest): Error sending request to ${h}.`,f),L(new Error(`Failed to send request: ${f.message}`))}}A()})}function N(t,r){const s=r[0].featureType;if(s==="METER"){let e=0,p=0,v=!1;for(const q of r){const c=q,h=typeof c.usageLimit=="number"?c.usageLimit:null,w=typeof c.currentUsage=="number"?c.currentUsage:0;h===null&&(e=null),e!==null&&(e+=h),p+=w,c.hardLimit&&(v=!0)}const y=e!==null?e-p:null;return{featureId:t,featureType:s,hasAccess:y===null||y>0,currentUsage:p,usageLimit:e,remaining:y,hardLimit:v,items:r}}if(s==="CUSTOMIZABLE"){const e=r[0];return{featureId:t,featureType:s,hasAccess:r.some(p=>p.hasAccess),currentUsage:typeof e.currentUsage=="number"?e.currentUsage:0,usageLimit:typeof e.usageLimit=="number"?e.usageLimit:null,remaining:typeof e.remaining=="number"?e.remaining:null,hardLimit:e.hardLimit===!0,items:r}}return{featureId:t,featureType:s,hasAccess:r.some(e=>e.hasAccess),currentUsage:0,usageLimit:null,remaining:null,hardLimit:!1,items:r}}function W(t){const r={};if(!t||!Array.isArray(t.entitlements))return console.warn("Kelviq SDK: Invalid or empty entitlements array in API response.",t),r;const s={};for(const e of t.entitlements){if(!e||typeof e.featureId!="string"||typeof e.featureType!="string"){console.warn("Kelviq SDK: Skipping invalid raw entitlement object:",e);continue}s[e.featureId]||(s[e.featureId]=[]),s[e.featureId].push(e)}for(const e in s)r[e]=N(e,s[e]);return r}const $={allEntitlements:{data:null,isLoading:!0,error:null},refreshAllEntitlements:()=>(console.warn("refreshAllEntitlements called on default KelviqContext. Ensure KelviqProvider is properly set up."),Promise.resolve()),getEntitlements:()=>({}),getEntitlement:()=>null,getRawEntitlements:()=>null,getRawEntitlement:()=>null,hasAccess:()=>!1,updateEntitlement:()=>{console.warn("updateEntitlement called on default KelviqContext. Ensure KelviqProvider is properly set up.")},isLoading:!0,error:null,apiUrl:"",environment:"production",entitlementsPath:"",customerId:""},M=E.createContext($),H="https://edge.api.kelviq.com/api/v1/",z="https://edge.sandboxapi.kelviq.com/api/v1/",X="entitlements/",G=({children:t,apiUrl:r,entitlementsPath:s=X,customerId:e,environment:p="production",accessToken:v,config:y={}})=>{const{onError:q,maxRetries:c,timeout:h,backoffBaseDelay:w,fetchEntitlementsOnMount:C=!0}=y,L=r||(p==="sandbox"?z:H),[A,i]=E.useState({data:null,isLoading:!!L&&C,error:null}),[d,D]=E.useState(null),[o,f]=E.useState(!!L&&C),[K,T]=E.useState(null),U=E.useCallback((m,l,n)=>{const g=new Error(`Kelviq SDK (${l}): ${m}`);console.error(g.message,n||""),T(S=>S||g),q&&q(g)},[q]),R=E.useCallback(()=>{if(!L){const n="API URL not configured. Cannot fetch entitlements.";return i({data:null,isLoading:!1,error:new Error(n)}),U(n,"fetchAllEntitlements"),f(!1),Promise.reject(new Error(n))}if(!e){const n="CustomerId must be provided as props to KelviqProvider.";return i(()=>({data:null,isLoading:!1,error:new Error(n)})),U(n,"fetchAllEntitlements"),f(!1),Promise.reject(new Error(n))}i(n=>({...n,isLoading:!0,error:null})),f(!0),T(null);const m=`${L.replace(/\/$/,"")}/${s.replace(/^\//,"")}`;return j({url:m,method:"GET",timeout:h,maxRetries:c,backoffBaseDelay:w,accessToken:v,queryParams:{customer_id:e}}).then(n=>{if(n&&n.data&&Array.isArray(n.data.entitlements)){D(n.data);const g=W(n.data);i({data:g,isLoading:!1,error:null})}else{const g=new Error("Received empty, malformed, or invalid data structure from entitlements API.");throw i({data:null,isLoading:!1,error:g}),U(g.message,"fetchAllEntitlements",n),g}}).catch(n=>{const g=n instanceof Error?n:new Error(String(n));return i(S=>({...S,isLoading:!1,error:g})),U(g.message,"fetchAllEntitlements",n),Promise.reject(g)}).finally(()=>{f(!1)})},[L,e,s,h,c,w,v,U]);E.useEffect(()=>{let m=!0;if(!L){if(m){const l=new Error("KelviqProvider: `apiBaseUrl` must be provided in config.");T(l),f(!1),i(n=>({...n,isLoading:!1,error:l})),y.onError&&y.onError(l)}return}return C?R().catch(l=>{m&&o&&f(!1),console.error("Kelviq SDK: Initial entitlement fetch failed.",l)}):m&&(i(l=>({...l,isLoading:!1,data:null,error:null})),f(!1)),()=>{m=!1}},[L,C,y.onError]);const _=E.useCallback(()=>A.data?A.data:{},[A.data]),F=E.useCallback(()=>d?{customerId:d.customer_id,entitlements:d.entitlements}:null,[d]),I=E.useCallback(m=>d?{customerId:d.customer_id,entitlements:d.entitlements.filter(l=>l.featureId===m)}:null,[d]),k=E.useCallback(m=>A.data?A.data[m]??null:null,[A.data]),B=E.useCallback((m,l)=>{i(n=>{if(!n.data)return n;const g=n.data[m];if(!g)return n;const S={...g,...l};return("usageLimit"in l||"currentUsage"in l)&&(S.remaining=S.usageLimit!==null?S.usageLimit-S.currentUsage:null),{...n,data:{...n.data,[m]:S}}})},[]),O=E.useCallback(m=>{if(!A.data)return!1;const l=A.data[m];return l?l.hasAccess:!1},[A.data]),ne=E.useMemo(()=>({allEntitlements:A,refreshAllEntitlements:R,getEntitlements:_,getEntitlement:k,getRawEntitlements:F,getRawEntitlement:I,hasAccess:O,updateEntitlement:B,isLoading:o,error:K,environment:p,apiUrl:L,entitlementsPath:s,customerId:e}),[A,R,_,k,F,I,O,B,o,K,p,L,s,e]);return u.jsx(M.Provider,{value:ne,children:t})},b=()=>{const t=E.useContext(M);if(t===void 0||t===$)throw new Error("useKelviq must be used within an initialized KelviqProvider.");return t},P=({featureId:t,children:r,fallback:s=null,loadingComponent:e,condition:p})=>{const{getEntitlement:v,isLoading:y,error:q}=b(),c=v(t);return y&&!c?u.jsx(u.Fragment,{children:e!==void 0?e:s}):q&&!c?u.jsx(u.Fragment,{children:s}):!c||!c.hasAccess||p&&!p(c)?u.jsx(u.Fragment,{children:s}):typeof r=="function"?u.jsx(u.Fragment,{children:r(c)}):u.jsx(u.Fragment,{children:r})},J=t=>u.jsx(P,{...t}),V=t=>{const r=s=>s.hasAccess&&(s.remaining===null||s.remaining>0);return u.jsx(P,{...t,condition:t.condition||r})},Y=t=>u.jsx(P,{...t}),Z=()=>{const{allEntitlements:t}=b();return t},Q=t=>{const{getEntitlement:r}=b();return r(t)},ee=t=>{const{getEntitlement:r}=b();return r(t)},te=t=>{const{getEntitlement:r}=b();return r(t)};a.KelviqContext=M,a.KelviqProvider=G,a.ShowWhenBooleanEntitled=Y,a.ShowWhenCustomizableEntitled=J,a.ShowWhenMeteredEntitled=V,a.defaultKelviqContextValue=$,a.useAllEntitlements=Z,a.useBooleanEntitlement=Q,a.useCustomizableEntitlement=ee,a.useKelviq=b,a.useMeteredEntitlement=te,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});
+(function(d,g){typeof exports=="object"&&typeof module<"u"?g(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],g):(d=typeof globalThis<"u"?globalThis:d||self,g(d.KelviqReactSDK={},d.jsxRuntime,d.React))})(this,function(d,g,f){"use strict";const V="GET";function I(n){const{method:o=V,headers:i={},body:t,timeout:L=5e3,maxRetries:h=3,backoffBaseDelay:w=1e3,queryParams:S,accessToken:a}=n;let{url:E}=n,v=0;return new Promise((T,K)=>{if(S){const s=new URLSearchParams;for(const u in S)S[u]!==void 0&&s.append(u,String(S[u]));s.toString()&&(E+=(E.includes("?")?"&":"?")+s.toString())}function M(){const s=new XMLHttpRequest;s.open(o,E,!0),s.timeout=L;const u={Accept:"application/json","X-Requested-With":"XMLHttpRequest",...i};o!=="GET"&&t&&typeof t=="object"&&!(t instanceof FormData)&&(u["Content-Type"]||(u["Content-Type"]="application/json")),a&&(u.Authorization=`Bearer ${a}`);for(const[l,q]of Object.entries(u))s.setRequestHeader(l,q);s.onload=function(){const{status:l,statusText:q,responseText:P}=s;if(l>=200&&l<300)try{const y=P?JSON.parse(P):{};T({status:l,statusText:q,data:y})}catch(y){const D=y instanceof Error?y:new Error(String(y));console.error(`Kelviq SDK (apiRequest): Invalid JSON response for URL ${E}. Error: ${D.message}. Response: ${P}`),K(new Error(`Invalid JSON response: ${D.message}`))}else A(`Request to ${E} failed with status ${l} ${q}. Response: ${P}`)},s.onerror=()=>A(`Network error for URL ${E}. The request could not be completed.`),s.ontimeout=()=>A(`Request to ${E} timed out.`);function A(l){if(v<h){v++;const q=Math.min(w*Math.pow(2,v-1),3e4);console.warn(`Kelviq SDK (apiRequest): Retrying request to ${E}. Attempt ${v}/${h}. Error: ${l}. Retrying in ${q}ms.`),setTimeout(M,q)}else K(new Error(`${l} (Max retries ${h} reached)`))}try{let l=t;t&&typeof t=="object"&&!(t instanceof FormData)&&u["Content-Type"]==="application/json"&&(l=JSON.stringify(t)),s.send(l)}catch(l){const q=l instanceof Error?l:new Error(String(l));console.error(`Kelviq SDK (apiRequest): Error sending request to ${E}.`,q),K(new Error(`Failed to send request: ${q.message}`))}}M()})}function Y(n,o){const i=o[0].featureType;if(i==="METER"){let t=0,L=0,h=!1;for(const S of o){const a=S,E=typeof a.usageLimit=="number"?a.usageLimit:null,v=typeof a.currentUsage=="number"?a.currentUsage:0;E===null&&(t=null),t!==null&&(t+=E),L+=v,a.hardLimit&&(h=!0)}const w=t!==null?t-L:null;return{featureId:n,featureType:i,hasAccess:w===null||w>0,currentUsage:L,usageLimit:t,remaining:w,hardLimit:h,items:o}}if(i==="CUSTOMIZABLE"){const t=o[0];return{featureId:n,featureType:i,hasAccess:o.some(L=>L.hasAccess),currentUsage:typeof t.currentUsage=="number"?t.currentUsage:0,usageLimit:typeof t.usageLimit=="number"?t.usageLimit:null,remaining:typeof t.remaining=="number"?t.remaining:null,hardLimit:t.hardLimit===!0,items:o}}return{featureId:n,featureType:i,hasAccess:o.some(t=>t.hasAccess),currentUsage:0,usageLimit:null,remaining:null,hardLimit:!1,items:o}}function Z(n){const o={};if(!n||!Array.isArray(n.entitlements))return console.warn("Kelviq SDK: Invalid or empty entitlements array in API response.",n),o;const i={};for(const t of n.entitlements){if(!t||typeof t.featureId!="string"||typeof t.featureType!="string"){console.warn("Kelviq SDK: Skipping invalid raw entitlement object:",t);continue}i[t.featureId]||(i[t.featureId]=[]),i[t.featureId].push(t)}for(const t in i)o[t]=Y(t,i[t]);return o}const R={allEntitlements:{data:null,isLoading:!0,error:null},refreshAllEntitlements:()=>(console.warn("refreshAllEntitlements called on default KelviqContext. Ensure KelviqProvider is properly set up."),Promise.resolve()),getEntitlements:()=>({}),getEntitlement:()=>null,getRawEntitlements:()=>null,getRawEntitlement:()=>null,hasAccess:()=>!1,updateEntitlement:()=>{console.warn("updateEntitlement called on default KelviqContext. Ensure KelviqProvider is properly set up.")},subscriptions:{data:null,isLoading:!1,error:null},refreshSubscriptions:()=>(console.warn("refreshSubscriptions called on default KelviqContext. Ensure KelviqProvider is properly set up."),Promise.resolve()),customer:{data:null,isLoading:!1,error:null},refreshCustomer:()=>(console.warn("refreshCustomer called on default KelviqContext. Ensure KelviqProvider is properly set up."),Promise.resolve()),isLoading:!0,error:null,apiUrl:"",environment:"production",entitlementsPath:"",customerId:""},F=f.createContext(R),Q="https://edge.api.kelviq.com/api/v1/",ee="https://edge.sandboxapi.kelviq.com/api/v1/",te="entitlements/",re=({children:n,apiUrl:o,entitlementsPath:i=te,customerId:t,environment:L="production",accessToken:h,config:w={}})=>{const{onError:S,maxRetries:a,timeout:E,backoffBaseDelay:v,fetchEntitlementsOnMount:T=!0,fetchSubscriptionsOnMount:K=!1,fetchCustomerOnMount:M=!1}=w,s=o||(L==="sandbox"?ee:Q),[u,A]=f.useState({data:null,isLoading:!!s&&T,error:null}),[l,q]=f.useState(null),[P,y]=f.useState({data:null,isLoading:!!s&&K,error:null}),[D,$]=f.useState({data:null,isLoading:!!s&&M,error:null}),[k,U]=f.useState(!!s&&T),[N,O]=f.useState(null),p=f.useCallback((c,e,r)=>{const m=new Error(`Kelviq SDK (${e}): ${c}`);console.error(m.message,r||""),O(b=>b||m),S&&S(m)},[S]),j=f.useCallback(()=>{if(!s){const r="API URL not configured. Cannot fetch entitlements.";return A({data:null,isLoading:!1,error:new Error(r)}),p(r,"fetchAllEntitlements"),U(!1),Promise.reject(new Error(r))}if(!t){const r="CustomerId must be provided as props to KelviqProvider.";return A(()=>({data:null,isLoading:!1,error:new Error(r)})),p(r,"fetchAllEntitlements"),U(!1),Promise.reject(new Error(r))}A(r=>({...r,isLoading:!0,error:null})),U(!0),O(null);const c=`${s.replace(/\/$/,"")}/${i.replace(/^\//,"")}`;return I({url:c,method:"GET",timeout:E,maxRetries:a,backoffBaseDelay:v,accessToken:h,queryParams:{customer_id:t}}).then(r=>{if(r&&r.data&&Array.isArray(r.data.entitlements)){q(r.data);const m=Z(r.data);A({data:m,isLoading:!1,error:null})}else{const m=new Error("Received empty, malformed, or invalid data structure from entitlements API.");throw A({data:null,isLoading:!1,error:m}),p(m.message,"fetchAllEntitlements",r),m}}).catch(r=>{const m=r instanceof Error?r:new Error(String(r));return A(b=>({...b,isLoading:!1,error:m})),p(m.message,"fetchAllEntitlements",r),Promise.reject(m)}).finally(()=>{U(!1)})},[s,t,i,E,a,v,h,p]),B=f.useCallback(()=>{if(!s){const e="API URL not configured. Cannot fetch subscriptions.";return y({data:null,isLoading:!1,error:new Error(e)}),p(e,"fetchSubscriptions"),Promise.reject(new Error(e))}if(!t){const e="CustomerId must be provided as props to KelviqProvider.";return y({data:null,isLoading:!1,error:new Error(e)}),p(e,"fetchSubscriptions"),Promise.reject(new Error(e))}y(e=>({...e,isLoading:!0,error:null}));const c=`${s.replace(/\/$/,"")}/subscriptions/`;return I({url:c,method:"GET",timeout:E,maxRetries:a,backoffBaseDelay:v,accessToken:h,queryParams:{customer_id:t}}).then(e=>{if(e&&e.data&&Array.isArray(e.data.results))y({data:e.data.results,isLoading:!1,error:null});else{const r=new Error("Received empty, malformed, or invalid data structure from subscriptions API.");throw y({data:null,isLoading:!1,error:r}),p(r.message,"fetchSubscriptions",e),r}}).catch(e=>{const r=e instanceof Error?e:new Error(String(e));return y(m=>({...m,isLoading:!1,error:r})),p(r.message,"fetchSubscriptions",e),Promise.reject(r)})},[s,t,E,a,v,h,p]),x=f.useCallback(()=>{if(!s){const e="API URL not configured. Cannot fetch customer.";return $({data:null,isLoading:!1,error:new Error(e)}),p(e,"fetchCustomer"),Promise.reject(new Error(e))}if(!t){const e="CustomerId must be provided as props to KelviqProvider.";return $({data:null,isLoading:!1,error:new Error(e)}),p(e,"fetchCustomer"),Promise.reject(new Error(e))}$(e=>({...e,isLoading:!0,error:null}));const c=`${s.replace(/\/$/,"")}/customers/${t}/`;return I({url:c,method:"GET",timeout:E,maxRetries:a,backoffBaseDelay:v,accessToken:h}).then(e=>{if(e&&e.data)$({data:e.data,isLoading:!1,error:null});else{const r=new Error("Received empty or invalid data from customer API.");throw $({data:null,isLoading:!1,error:r}),p(r.message,"fetchCustomer",e),r}}).catch(e=>{const r=e instanceof Error?e:new Error(String(e));return $(m=>({...m,isLoading:!1,error:r})),p(r.message,"fetchCustomer",e),Promise.reject(r)})},[s,t,E,a,v,h,p]);f.useEffect(()=>{let c=!0;if(!s){if(c){const e=new Error("KelviqProvider: `apiBaseUrl` must be provided in config.");O(e),U(!1),A(r=>({...r,isLoading:!1,error:e})),w.onError&&w.onError(e)}return}return T?j().catch(e=>{c&&k&&U(!1),console.error("Kelviq SDK: Initial entitlement fetch failed.",e)}):c&&(A(e=>({...e,isLoading:!1,data:null,error:null})),U(!1)),K&&B().catch(e=>{console.error("Kelviq SDK: Initial subscriptions fetch failed.",e)}),M&&x().catch(e=>{console.error("Kelviq SDK: Initial customer fetch failed.",e)}),()=>{c=!1}},[s,T,K,M,w.onError]);const W=f.useCallback(()=>u.data?u.data:{},[u.data]),G=f.useCallback(()=>l?{customerId:l.customerId,entitlements:l.entitlements}:null,[l]),H=f.useCallback(c=>l?{customerId:l.customerId,entitlements:l.entitlements.filter(e=>e.featureId===c)}:null,[l]),z=f.useCallback(c=>u.data?u.data[c]??null:null,[u.data]),X=f.useCallback((c,e)=>{A(r=>{if(!r.data)return r;const m=r.data[c];if(!m)return r;const b={...m,...e};return("usageLimit"in e||"currentUsage"in e)&&(b.remaining=b.usageLimit!==null?b.usageLimit-b.currentUsage:null),{...r,data:{...r.data,[c]:b}}})},[]),J=f.useCallback(c=>{if(!u.data)return!1;const e=u.data[c];return e?e.hasAccess:!1},[u.data]),fe=f.useMemo(()=>({allEntitlements:u,refreshAllEntitlements:j,getEntitlements:W,getEntitlement:z,getRawEntitlements:G,getRawEntitlement:H,hasAccess:J,updateEntitlement:X,subscriptions:P,refreshSubscriptions:B,customer:D,refreshCustomer:x,isLoading:k,error:N,environment:L,apiUrl:s,entitlementsPath:i,customerId:t}),[u,j,W,z,G,H,J,X,P,B,D,x,k,N,L,s,i,t]);return g.jsx(F.Provider,{value:fe,children:n})},C=()=>{const n=f.useContext(F);if(n===void 0||n===R)throw new Error("useKelviq must be used within an initialized KelviqProvider.");return n},_=({featureId:n,children:o,fallback:i=null,loadingComponent:t,condition:L})=>{const{getEntitlement:h,isLoading:w,error:S}=C(),a=h(n);return w&&!a?g.jsx(g.Fragment,{children:t!==void 0?t:i}):S&&!a?g.jsx(g.Fragment,{children:i}):!a||!a.hasAccess||L&&!L(a)?g.jsx(g.Fragment,{children:i}):typeof o=="function"?g.jsx(g.Fragment,{children:o(a)}):g.jsx(g.Fragment,{children:o})},ne=n=>g.jsx(_,{...n}),se=n=>{const o=i=>i.hasAccess&&(i.remaining===null||i.remaining>0);return g.jsx(_,{...n,condition:n.condition||o})},oe=n=>g.jsx(_,{...n}),ie=()=>{const{allEntitlements:n}=C();return n},le=n=>{const{getEntitlement:o}=C();return o(n)},ae=n=>{const{getEntitlement:o}=C();return o(n)},ue=n=>{const{getEntitlement:o}=C();return o(n)},ce=()=>{const{subscriptions:n}=C();return n},de=()=>{const{customer:n}=C();return n};d.KelviqContext=F,d.KelviqProvider=re,d.ShowWhenBooleanEntitled=oe,d.ShowWhenCustomizableEntitled=ne,d.ShowWhenMeteredEntitled=se,d.defaultKelviqContextValue=R,d.useAllEntitlements=ie,d.useBooleanEntitlement=le,d.useCustomer=de,d.useCustomizableEntitlement=ae,d.useKelviq=C,d.useMeteredEntitlement=ue,d.useSubscriptions=ce,Object.defineProperty(d,Symbol.toStringTag,{value:"Module"})});

package/dist/types/api.types.d.ts

@@ -40,10 +40,71 @@ export interface RawMeteredEntitlementData extends RawEntitlement {
 export type AnyRawEntitlementData = RawBooleanEntitlementData | RawCustomizableEntitlementData | RawMeteredEntitlementData;
 /**
  * Represents the expected raw API response structure when fetching all entitlements.
- * Example: { "customer_id": "128", "entitlements": [...] }
+ * Example: { "customerId": "128", "entitlements": [...] }
  */
 export interface RawEntitlementsApiResponse {
-    customer_id: string;
+    customerId: string;
     entitlements: AnyRawEntitlementData[];
 }
+export interface RawSubscriptionFeature {
+    featureId: string;
+    featureType: string;
+    hasAccess: boolean;
+    usageLimit: number | null;
+    currentUsage: number;
+    remaining: number | null;
+}
+export interface RawSubscriptionPlan {
+    name: string;
+    identifier: string;
+}
+export interface RawSubscriptionProduct {
+    name: string;
+    identifier: string;
+}
+/** A single subscription object as returned by the subscriptions API. */
+export interface RawSubscriptionData {
+    id: string;
+    externalSubscriptionId: string;
+    startDate: string;
+    endDate: string | null;
+    billingPeriodStartTime: string;
+    billingPeriodEndTime: string;
+    amount: string;
+    recurrence: string;
+    currency: string;
+    status: string;
+    product: RawSubscriptionProduct;
+    plan: RawSubscriptionPlan;
+    features: RawSubscriptionFeature[];
+    trialDaysRemaining: number | null;
+    customerId: string;
+}
+/** Paginated response from the subscriptions list endpoint. */
+export interface RawSubscriptionsApiResponse {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: RawSubscriptionData[];
+}
+export interface RawBillingAddress {
+    country: string;
+    line1: string;
+    line2: string;
+    postalCode: string;
+    city: string;
+    state: string;
+}
+/** Raw customer data as returned by the customer API. */
+export interface RawCustomerApiResponse {
+    id: string;
+    customerId: string;
+    name: string;
+    email: string;
+    details: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    billingAddress: RawBillingAddress | null;
+    createdOn: string;
+    modifiedOn: string;
+}
 export {};

package/dist/types/sdk.types.d.ts

@@ -63,4 +63,14 @@ export interface KelviqApiBehaviorOptions {
      * If not provided, the `apiRequest` service's default will be used.
      */
     backoffBaseDelay?: number;
+    /**
+     * If true, fetches the customer's subscriptions when the provider mounts.
+     * Defaults to false. When enabled, data is available via `useSubscriptions()`.
+     */
+    fetchSubscriptionsOnMount?: boolean;
+    /**
+     * If true, fetches customer data when the provider mounts.
+     * Defaults to false. When enabled, data is available via `useCustomer()`.
+     */
+    fetchCustomerOnMount?: boolean;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@kelviq/react-sdk",
     "private": false,
-    "version": "2.0.0-beta",
+    "version": "2.0.1-beta",
     "type": "module",
     "main": "dist/kelviq-react-sdk.js",
     "types": "dist/index.d.ts",