@fonderie/react-billing 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -6,23 +6,27 @@ interface IUseBillingPortalReturn {
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useBillingPortal(client: BillingClient): IUseBillingPortalReturn;
+declare function useBillingPortal(client?: BillingClient): IUseBillingPortalReturn;
 
 interface IUseCheckoutReturn {
     checkout: (input: ICheckoutInput) => Promise<string>;
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useCheckout(client: BillingClient): IUseCheckoutReturn;
+declare function useCheckout(client?: BillingClient): IUseCheckoutReturn;
 
 interface IUsePlanReturn {
     plan: IPlanDTO | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
 }
-declare function usePlan(client: BillingClient, planId: string): IUsePlanReturn;
+declare function usePlan(planId: string): IUsePlanReturn;
+declare function usePlan(client: BillingClient | undefined, planId: string): IUsePlanReturn;
 
+/** @deprecated Use `usePlans().createPlan` / `updatePlan` / `deletePlan` instead — the list hook self-refreshes after each write. */
 interface IUsePlanAdminReturn {
     createPlan: (input: ICreatePlanInput) => Promise<IPlanDTO>;
     updatePlan: (planId: string, input: IUpdatePlanInput) => Promise<IPlanDTO>;
@@ -30,37 +34,51 @@ interface IUsePlanAdminReturn {
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function usePlanAdmin(client: BillingClient): IUsePlanAdminReturn;
+/** @deprecated Use `usePlans().createPlan` / `updatePlan` / `deletePlan` instead — the list hook self-refreshes after each write. */
+declare function usePlanAdmin(client?: BillingClient): IUsePlanAdminReturn;
 
 interface IUsePlansReturn {
     plans: IPlanDTO[];
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
+    createPlan: (input: ICreatePlanInput) => Promise<IPlanDTO>;
+    updatePlan: (planId: string, input: IUpdatePlanInput) => Promise<IPlanDTO>;
+    deletePlan: (planId: string) => Promise<void>;
 }
-declare function usePlans(client: BillingClient): IUsePlansReturn;
+declare function usePlans(client?: BillingClient): IUsePlansReturn;
 
+/** @deprecated Use `useUsage(metric).recordUsage` instead — the usage hook self-refreshes after the write. */
 interface IUseRecordUsageReturn {
     recordUsage: (input: IRecordUsageInput) => Promise<void>;
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useRecordUsage(client: BillingClient): IUseRecordUsageReturn;
+/** @deprecated Use `useUsage(metric).recordUsage` instead — the usage hook self-refreshes after the write. */
+declare function useRecordUsage(client?: BillingClient): IUseRecordUsageReturn;
 
 interface IUseSubscriptionReturn {
     subscription: ISubscriptionDTO | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
 }
-declare function useSubscription(client: BillingClient): IUseSubscriptionReturn;
+declare function useSubscription(client?: BillingClient): IUseSubscriptionReturn;
 
 interface IUseUsageReturn {
     total: number | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
+    recordUsage: (input: IRecordUsageInput) => Promise<void>;
 }
-declare function useUsage(client: BillingClient, metric: string): IUseUsageReturn;
+declare function useUsage(metric: string): IUseUsageReturn;
+declare function useUsage(client: BillingClient | undefined, metric: string): IUseUsageReturn;
 
 export { type IUseBillingPortalReturn, type IUseCheckoutReturn, type IUsePlanAdminReturn, type IUsePlanReturn, type IUsePlansReturn, type IUseRecordUsageReturn, type IUseSubscriptionReturn, type IUseUsageReturn, useBillingPortal, useCheckout, usePlan, usePlanAdmin, usePlans, useRecordUsage, useSubscription, useUsage };

package/dist/index.d.ts

@@ -6,23 +6,27 @@ interface IUseBillingPortalReturn {
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useBillingPortal(client: BillingClient): IUseBillingPortalReturn;
+declare function useBillingPortal(client?: BillingClient): IUseBillingPortalReturn;
 
 interface IUseCheckoutReturn {
     checkout: (input: ICheckoutInput) => Promise<string>;
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useCheckout(client: BillingClient): IUseCheckoutReturn;
+declare function useCheckout(client?: BillingClient): IUseCheckoutReturn;
 
 interface IUsePlanReturn {
     plan: IPlanDTO | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
 }
-declare function usePlan(client: BillingClient, planId: string): IUsePlanReturn;
+declare function usePlan(planId: string): IUsePlanReturn;
+declare function usePlan(client: BillingClient | undefined, planId: string): IUsePlanReturn;
 
+/** @deprecated Use `usePlans().createPlan` / `updatePlan` / `deletePlan` instead — the list hook self-refreshes after each write. */
 interface IUsePlanAdminReturn {
     createPlan: (input: ICreatePlanInput) => Promise<IPlanDTO>;
     updatePlan: (planId: string, input: IUpdatePlanInput) => Promise<IPlanDTO>;
@@ -30,37 +34,51 @@ interface IUsePlanAdminReturn {
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function usePlanAdmin(client: BillingClient): IUsePlanAdminReturn;
+/** @deprecated Use `usePlans().createPlan` / `updatePlan` / `deletePlan` instead — the list hook self-refreshes after each write. */
+declare function usePlanAdmin(client?: BillingClient): IUsePlanAdminReturn;
 
 interface IUsePlansReturn {
     plans: IPlanDTO[];
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
+    createPlan: (input: ICreatePlanInput) => Promise<IPlanDTO>;
+    updatePlan: (planId: string, input: IUpdatePlanInput) => Promise<IPlanDTO>;
+    deletePlan: (planId: string) => Promise<void>;
 }
-declare function usePlans(client: BillingClient): IUsePlansReturn;
+declare function usePlans(client?: BillingClient): IUsePlansReturn;
 
+/** @deprecated Use `useUsage(metric).recordUsage` instead — the usage hook self-refreshes after the write. */
 interface IUseRecordUsageReturn {
     recordUsage: (input: IRecordUsageInput) => Promise<void>;
     isLoading: boolean;
     error: FonderieApiError | null;
 }
-declare function useRecordUsage(client: BillingClient): IUseRecordUsageReturn;
+/** @deprecated Use `useUsage(metric).recordUsage` instead — the usage hook self-refreshes after the write. */
+declare function useRecordUsage(client?: BillingClient): IUseRecordUsageReturn;
 
 interface IUseSubscriptionReturn {
     subscription: ISubscriptionDTO | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
 }
-declare function useSubscription(client: BillingClient): IUseSubscriptionReturn;
+declare function useSubscription(client?: BillingClient): IUseSubscriptionReturn;
 
 interface IUseUsageReturn {
     total: number | null;
     isLoading: boolean;
     error: FonderieApiError | null;
-    refresh: () => Promise<void>;
+    refresh: (opts?: {
+        force?: boolean;
+    }) => Promise<void>;
+    recordUsage: (input: IRecordUsageInput) => Promise<void>;
 }
-declare function useUsage(client: BillingClient, metric: string): IUseUsageReturn;
+declare function useUsage(metric: string): IUseUsageReturn;
+declare function useUsage(client: BillingClient | undefined, metric: string): IUseUsageReturn;
 
 export { type IUseBillingPortalReturn, type IUseCheckoutReturn, type IUsePlanAdminReturn, type IUsePlanReturn, type IUsePlansReturn, type IUseRecordUsageReturn, type IUseSubscriptionReturn, type IUseUsageReturn, useBillingPortal, useCheckout, usePlan, usePlanAdmin, usePlans, useRecordUsage, useSubscription, useUsage };

package/dist/index.js

@@ -3,15 +3,17 @@ import { FonderieApiError as FonderieApiError9 } from "@fonderie/client";
 
 // src/hooks/useBillingPortal.ts
 import { FonderieApiError } from "@fonderie/client";
+import { useFonderieSubClient } from "@fonderie/react";
 import { useCallback, useState } from "react";
 function useBillingPortal(client) {
+  const billing = useFonderieSubClient(client, (c) => c.billing, "useBillingPortal");
   const [isLoading, setIsLoading] = useState(false);
   const [error, setError] = useState(null);
   const openPortal = useCallback(async () => {
     setIsLoading(true);
     setError(null);
     try {
-      const { result } = await client.createPortalSession();
+      const { result } = await billing.createPortalSession();
       return result.url;
     } catch (err) {
       const apiError = err instanceof FonderieApiError ? err : new FonderieApiError("unknown", String(err), 0);
@@ -20,14 +22,16 @@ function useBillingPortal(client) {
     } finally {
       setIsLoading(false);
     }
-  }, [client]);
+  }, [billing]);
   return { openPortal, isLoading, error };
 }
 
 // src/hooks/useCheckout.ts
 import { FonderieApiError as FonderieApiError2 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient2 } from "@fonderie/react";
 import { useCallback as useCallback2, useState as useState2 } from "react";
 function useCheckout(client) {
+  const billing = useFonderieSubClient2(client, (c) => c.billing, "useCheckout");
   const [isLoading, setIsLoading] = useState2(false);
   const [error, setError] = useState2(null);
   const checkout = useCallback2(
@@ -35,7 +39,7 @@ function useCheckout(client) {
       setIsLoading(true);
       setError(null);
       try {
-        const { result } = await client.createCheckoutSession(input);
+        const { result } = await billing.createCheckoutSession(input);
         return result.url;
       } catch (err) {
         const apiError = err instanceof FonderieApiError2 ? err : new FonderieApiError2("unknown", String(err), 0);
@@ -45,31 +49,39 @@ function useCheckout(client) {
         setIsLoading(false);
       }
     },
-    [client]
+    [billing]
   );
   return { checkout, isLoading, error };
 }
 
 // src/hooks/usePlan.ts
-import { FonderieApiError as FonderieApiError3 } from "@fonderie/client";
+import { BillingClient, FonderieApiError as FonderieApiError3 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient3 } from "@fonderie/react";
 import { useCallback as useCallback3, useEffect, useState as useState3 } from "react";
-function usePlan(client, planId) {
+function usePlan(clientOrPlanId, maybePlanId) {
+  const firstIsClient = clientOrPlanId === void 0 || clientOrPlanId instanceof BillingClient;
+  const explicit = firstIsClient ? clientOrPlanId : void 0;
+  const planId = firstIsClient ? maybePlanId : clientOrPlanId;
+  const billing = useFonderieSubClient3(explicit, (c) => c.billing, "usePlan");
   const [plan, setPlan] = useState3(null);
   const [isLoading, setIsLoading] = useState3(true);
   const [error, setError] = useState3(null);
-  const refresh = useCallback3(async () => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const { result } = await client.getPlan(planId);
-      setPlan(result.plan);
-    } catch (err) {
-      const apiError = err instanceof FonderieApiError3 ? err : new FonderieApiError3("unknown", String(err), 0);
-      setError(apiError);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [client, planId]);
+  const refresh = useCallback3(
+    async (opts) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const { result } = await billing.getPlan(planId, { bust: opts?.force });
+        setPlan(result.plan);
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError3 ? err : new FonderieApiError3("unknown", String(err), 0);
+        setError(apiError);
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [billing, planId]
+  );
   useEffect(() => {
     void refresh();
   }, [refresh]);
@@ -78,8 +90,10 @@ function usePlan(client, planId) {
 
 // src/hooks/usePlanAdmin.ts
 import { FonderieApiError as FonderieApiError4 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient4 } from "@fonderie/react";
 import { useCallback as useCallback4, useState as useState4 } from "react";
 function usePlanAdmin(client) {
+  const billing = useFonderieSubClient4(client, (c) => c.billing, "usePlanAdmin");
   const [isLoading, setIsLoading] = useState4(false);
   const [error, setError] = useState4(null);
   const createPlan = useCallback4(
@@ -87,7 +101,7 @@ function usePlanAdmin(client) {
       setIsLoading(true);
       setError(null);
       try {
-        const { result } = await client.createPlan(input);
+        const { result } = await billing.createPlan(input);
         return result.plan;
       } catch (err) {
         const apiError = err instanceof FonderieApiError4 ? err : new FonderieApiError4("unknown", String(err), 0);
@@ -97,14 +111,14 @@ function usePlanAdmin(client) {
         setIsLoading(false);
       }
     },
-    [client]
+    [billing]
   );
   const updatePlan = useCallback4(
     async (planId, input) => {
       setIsLoading(true);
       setError(null);
       try {
-        const { result } = await client.updatePlan(planId, input);
+        const { result } = await billing.updatePlan(planId, input);
         return result.plan;
       } catch (err) {
         const apiError = err instanceof FonderieApiError4 ? err : new FonderieApiError4("unknown", String(err), 0);
@@ -114,14 +128,14 @@ function usePlanAdmin(client) {
         setIsLoading(false);
       }
     },
-    [client]
+    [billing]
   );
   const deletePlan = useCallback4(
     async (planId) => {
       setIsLoading(true);
       setError(null);
       try {
-        await client.deletePlan(planId);
+        await billing.deletePlan(planId);
       } catch (err) {
         const apiError = err instanceof FonderieApiError4 ? err : new FonderieApiError4("unknown", String(err), 0);
         setError(apiError);
@@ -130,41 +144,92 @@ function usePlanAdmin(client) {
         setIsLoading(false);
       }
     },
-    [client]
+    [billing]
   );
   return { createPlan, updatePlan, deletePlan, isLoading, error };
 }
 
 // src/hooks/usePlans.ts
 import { FonderieApiError as FonderieApiError5 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient5 } from "@fonderie/react";
 import { useCallback as useCallback5, useEffect as useEffect2, useState as useState5 } from "react";
 function usePlans(client) {
+  const billing = useFonderieSubClient5(client, (c) => c.billing, "usePlans");
   const [plans, setPlans] = useState5([]);
   const [isLoading, setIsLoading] = useState5(true);
   const [error, setError] = useState5(null);
-  const refresh = useCallback5(async () => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const { result } = await client.listPlans();
-      setPlans(result.plans);
-    } catch (err) {
-      const apiError = err instanceof FonderieApiError5 ? err : new FonderieApiError5("unknown", String(err), 0);
-      setError(apiError);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [client]);
+  const refresh = useCallback5(
+    async (opts) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const { result } = await billing.listPlans({ bust: opts?.force });
+        setPlans(result.plans);
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError5 ? err : new FonderieApiError5("unknown", String(err), 0);
+        setError(apiError);
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [billing]
+  );
+  const createPlan = useCallback5(
+    async (input) => {
+      setError(null);
+      try {
+        const { result } = await billing.createPlan(input);
+        await refresh();
+        return result.plan;
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError5 ? err : new FonderieApiError5("unknown", String(err), 0);
+        setError(apiError);
+        throw apiError;
+      }
+    },
+    [billing, refresh]
+  );
+  const updatePlan = useCallback5(
+    async (planId, input) => {
+      setError(null);
+      try {
+        const { result } = await billing.updatePlan(planId, input);
+        await refresh();
+        return result.plan;
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError5 ? err : new FonderieApiError5("unknown", String(err), 0);
+        setError(apiError);
+        throw apiError;
+      }
+    },
+    [billing, refresh]
+  );
+  const deletePlan = useCallback5(
+    async (planId) => {
+      setError(null);
+      try {
+        await billing.deletePlan(planId);
+        await refresh();
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError5 ? err : new FonderieApiError5("unknown", String(err), 0);
+        setError(apiError);
+        throw apiError;
+      }
+    },
+    [billing, refresh]
+  );
   useEffect2(() => {
     void refresh();
   }, [refresh]);
-  return { plans, isLoading, error, refresh };
+  return { plans, isLoading, error, refresh, createPlan, updatePlan, deletePlan };
 }
 
 // src/hooks/useRecordUsage.ts
 import { FonderieApiError as FonderieApiError6 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient6 } from "@fonderie/react";
 import { useCallback as useCallback6, useState as useState6 } from "react";
 function useRecordUsage(client) {
+  const billing = useFonderieSubClient6(client, (c) => c.billing, "useRecordUsage");
   const [isLoading, setIsLoading] = useState6(false);
   const [error, setError] = useState6(null);
   const recordUsage = useCallback6(
@@ -172,7 +237,7 @@ function useRecordUsage(client) {
       setIsLoading(true);
       setError(null);
       try {
-        await client.recordUsage(input);
+        await billing.recordUsage(input);
       } catch (err) {
         const apiError = err instanceof FonderieApiError6 ? err : new FonderieApiError6("unknown", String(err), 0);
         setError(apiError);
@@ -181,32 +246,37 @@ function useRecordUsage(client) {
         setIsLoading(false);
       }
     },
-    [client]
+    [billing]
   );
   return { recordUsage, isLoading, error };
 }
 
 // src/hooks/useSubscription.ts
 import { FonderieApiError as FonderieApiError7 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient7 } from "@fonderie/react";
 import { useCallback as useCallback7, useEffect as useEffect3, useState as useState7 } from "react";
 function useSubscription(client) {
+  const billing = useFonderieSubClient7(client, (c) => c.billing, "useSubscription");
   const [subscription, setSubscription] = useState7(null);
   const [isLoading, setIsLoading] = useState7(true);
   const [error, setError] = useState7(null);
-  const refresh = useCallback7(async () => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const { result } = await client.getSubscription();
-      setSubscription(result.subscription);
-    } catch (err) {
-      const apiError = err instanceof FonderieApiError7 ? err : new FonderieApiError7("unknown", String(err), 0);
-      if (apiError.status !== 404) setError(apiError);
-      setSubscription(null);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [client]);
+  const refresh = useCallback7(
+    async (opts) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const { result } = await billing.getSubscription({ bust: opts?.force });
+        setSubscription(result.subscription);
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError7 ? err : new FonderieApiError7("unknown", String(err), 0);
+        if (apiError.status !== 404) setError(apiError);
+        setSubscription(null);
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [billing]
+  );
   useEffect3(() => {
     void refresh();
   }, [refresh]);
@@ -214,29 +284,51 @@ function useSubscription(client) {
 }
 
 // src/hooks/useUsage.ts
-import { FonderieApiError as FonderieApiError8 } from "@fonderie/client";
+import { BillingClient as BillingClient2, FonderieApiError as FonderieApiError8 } from "@fonderie/client";
+import { useFonderieSubClient as useFonderieSubClient8 } from "@fonderie/react";
 import { useCallback as useCallback8, useEffect as useEffect4, useState as useState8 } from "react";
-function useUsage(client, metric) {
+function useUsage(clientOrMetric, maybeMetric) {
+  const firstIsClient = clientOrMetric === void 0 || clientOrMetric instanceof BillingClient2;
+  const explicit = firstIsClient ? clientOrMetric : void 0;
+  const metric = firstIsClient ? maybeMetric : clientOrMetric;
+  const billing = useFonderieSubClient8(explicit, (c) => c.billing, "useUsage");
   const [total, setTotal] = useState8(null);
   const [isLoading, setIsLoading] = useState8(true);
   const [error, setError] = useState8(null);
-  const refresh = useCallback8(async () => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const { result } = await client.getUsage(metric);
-      setTotal(result.total);
-    } catch (err) {
-      const apiError = err instanceof FonderieApiError8 ? err : new FonderieApiError8("unknown", String(err), 0);
-      setError(apiError);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [client, metric]);
+  const refresh = useCallback8(
+    async (opts) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const { result } = await billing.getUsage(metric, { bust: opts?.force });
+        setTotal(result.total);
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError8 ? err : new FonderieApiError8("unknown", String(err), 0);
+        setError(apiError);
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [billing, metric]
+  );
+  const recordUsage = useCallback8(
+    async (input) => {
+      setError(null);
+      try {
+        await billing.recordUsage(input);
+        await refresh();
+      } catch (err) {
+        const apiError = err instanceof FonderieApiError8 ? err : new FonderieApiError8("unknown", String(err), 0);
+        setError(apiError);
+        throw apiError;
+      }
+    },
+    [billing, refresh]
+  );
   useEffect4(() => {
     void refresh();
   }, [refresh]);
-  return { total, isLoading, error, refresh };
+  return { total, isLoading, error, refresh, recordUsage };
 }
 export {
   FonderieApiError9 as FonderieApiError,