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