@umituz/web-polar-payment 1.0.13 → 1.0.14

package/dist/index.d.mts

@@ -118,7 +118,7 @@ declare function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdap
  * Billing Constants
  * @description Standardized subscription states and plan names
  */
-declare const SUBSCRIPTION_STATUS: {
+declare const SUBSCRIPTION_STATUS: Readonly<{
     ACTIVE: "active";
     CANCELED: "canceled";
     REVOKED: "revoked";
@@ -128,7 +128,7 @@ declare const SUBSCRIPTION_STATUS: {
     INCOMPLETE_EXPIRED: "incomplete_expired";
     UNPAID: "unpaid";
     NONE: "none";
-};
+}>;
 declare const FREE_PLAN = "free";
 
 /**

package/dist/index.d.ts

@@ -118,7 +118,7 @@ declare function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdap
  * Billing Constants
  * @description Standardized subscription states and plan names
  */
-declare const SUBSCRIPTION_STATUS: {
+declare const SUBSCRIPTION_STATUS: Readonly<{
     ACTIVE: "active";
     CANCELED: "canceled";
     REVOKED: "revoked";
@@ -128,7 +128,7 @@ declare const SUBSCRIPTION_STATUS: {
     INCOMPLETE_EXPIRED: "incomplete_expired";
     UNPAID: "unpaid";
     NONE: "none";
-};
+}>;
 declare const FREE_PLAN = "free";
 
 /**

package/dist/index.js

@@ -43,21 +43,21 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/infrastructure/utils/normalization.util.ts
+var STATUS_MAP = {
+  active: "active",
+  trialing: "trialing",
+  past_due: "past_due",
+  incomplete: "incomplete",
+  incomplete_expired: "incomplete_expired",
+  unpaid: "unpaid",
+  canceled: "canceled",
+  cancelled: "canceled",
+  revoked: "revoked",
+  none: "none"
+};
 function normalizeStatus(raw) {
-  const map = {
-    active: "active",
-    trialing: "trialing",
-    past_due: "past_due",
-    incomplete: "incomplete",
-    incomplete_expired: "incomplete_expired",
-    unpaid: "unpaid",
-    canceled: "canceled",
-    cancelled: "canceled",
-    revoked: "revoked",
-    none: "none"
-  };
   if (typeof raw !== "string") return "none";
-  return map[raw.toLowerCase()] ?? "none";
+  return STATUS_MAP[raw.toLowerCase()] ?? "none";
 }
 function normalizeBillingCycle(interval) {
   if (typeof interval !== "string") return "monthly";
@@ -99,15 +99,31 @@ function createFirebaseAdapter(config) {
     cancelAtPeriodEnd: config.db?.cancelAtPeriodEndField ?? "cancelAtPeriodEnd",
     currentPeriodEnd: config.db?.currentPeriodEndField ?? "currentPeriodEnd"
   };
+  let httpsCallableCache = null;
+  let firestoreCache = null;
+  async function getHttpsCallable() {
+    if (!httpsCallableCache) {
+      const mod = await import("firebase/functions");
+      httpsCallableCache = mod.httpsCallable;
+    }
+    return httpsCallableCache;
+  }
+  async function getFirestore() {
+    if (!firestoreCache) {
+      const mod = await import("firebase/firestore");
+      firestoreCache = { doc: mod.doc, getDoc: mod.getDoc };
+    }
+    return firestoreCache;
+  }
   async function callable(name, data) {
-    const { httpsCallable } = await import("firebase/functions");
+    const httpsCallable = await getHttpsCallable();
     const fn = httpsCallable(functions, name);
     const result = await fn(data);
     return result.data;
   }
   return {
     async getStatus(userId) {
-      const { doc, getDoc } = await import("firebase/firestore");
+      const { doc, getDoc } = await getFirestore();
       const snap = await getDoc(doc(firestore, db.collection, userId));
       if (!snap.exists()) {
         return { plan: "free", subscriptionStatus: "none" };
@@ -161,7 +177,7 @@ function createFirebaseAdapter(config) {
 }
 
 // src/infrastructure/constants/billing.constants.ts
-var SUBSCRIPTION_STATUS = {
+var SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: "active",
   CANCELED: "canceled",
   REVOKED: "revoked",
@@ -171,7 +187,7 @@ var SUBSCRIPTION_STATUS = {
   INCOMPLETE_EXPIRED: "incomplete_expired",
   UNPAID: "unpaid",
   NONE: "none"
-};
+});
 var FREE_PLAN = "free";
 
 // src/presentation/components/PolarProvider.tsx
@@ -202,31 +218,36 @@ function PolarProvider({ adapter, userId, children }) {
   const [status, setStatus] = (0, import_react2.useState)(FREE_STATUS);
   const [loading, setLoading] = (0, import_react2.useState)(true);
   const adapterRef = (0, import_react2.useRef)(adapter);
-  adapterRef.current = adapter;
+  const statusRef = (0, import_react2.useRef)({ setStatus, setLoading });
+  const userIdRef = (0, import_react2.useRef)(normalizeUserId(userId));
   const refreshAbortRef = (0, import_react2.useRef)(null);
+  adapterRef.current = adapter;
+  statusRef.current = { setStatus, setLoading };
+  userIdRef.current = normalizeUserId(userId);
   const refresh = (0, import_react2.useCallback)(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
+    const { setStatus: setStatus2, setLoading: setLoading2 } = statusRef.current;
     if (!uid) {
-      setStatus(FREE_STATUS);
-      setLoading(false);
+      setStatus2(FREE_STATUS);
+      setLoading2(false);
       return;
     }
     refreshAbortRef.current?.abort();
     const ctrl = new AbortController();
     refreshAbortRef.current = ctrl;
     try {
-      setLoading(true);
+      setLoading2(true);
       const s = await adapterRef.current.getStatus(uid);
-      if (!ctrl.signal.aborted) setStatus(s);
+      if (!ctrl.signal.aborted) setStatus2(s);
     } catch (err) {
       if (!ctrl.signal.aborted) {
         console.error("[polar-billing] getStatus failed:", err);
-        setStatus(FREE_STATUS);
+        setStatus2(FREE_STATUS);
       }
     } finally {
-      if (!ctrl.signal.aborted) setLoading(false);
+      if (!ctrl.signal.aborted) setLoading2(false);
     }
-  }, [userId]);
+  }, []);
   (0, import_react2.useEffect)(() => {
     refresh();
     return () => {
@@ -234,26 +255,26 @@ function PolarProvider({ adapter, userId, children }) {
     };
   }, [refresh]);
   const startCheckout = (0, import_react2.useCallback)(async (params) => {
-    const uid = normalizeUserId(userId);
-    const result = await adapterRef.current.createCheckout({ ...params, userId: uid });
+    const uid = userIdRef.current;
+    const result = await adapterRef.current.createCheckout({ ...params, userId: uid ?? void 0 });
     if (!result.url.startsWith("https://")) {
       throw new Error("[polar-billing] Invalid checkout URL returned: URL must start with https://");
     }
     window.location.href = result.url;
-  }, [userId]);
+  }, []);
   const syncSubscription = (0, import_react2.useCallback)(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return { synced: false };
     const checkoutId = new URLSearchParams(window.location.search).get("checkout_id") ?? void 0;
     const result = await adapterRef.current.syncSubscription(uid, checkoutId);
     if (result.synced) await refresh();
     return result;
-  }, [userId, refresh]);
+  }, [refresh]);
   const getBillingHistory = (0, import_react2.useCallback)(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return [];
     return adapterRef.current.getBillingHistory(uid);
-  }, [userId]);
+  }, []);
   const cancelSubscription = (0, import_react2.useCallback)(
     async (reason) => {
       const result = await adapterRef.current.cancelSubscription(reason);
@@ -261,12 +282,13 @@ function PolarProvider({ adapter, userId, children }) {
       return result;
     },
     [refresh]
+    // Only depends on stable refresh
   );
   const getPortalUrl = (0, import_react2.useCallback)(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) throw new Error("[polar-billing] Cannot get portal URL: No authenticated user");
     return adapterRef.current.getPortalUrl(uid);
-  }, [userId]);
+  }, []);
   const value = (0, import_react2.useMemo)(
     () => ({
       status,
@@ -278,7 +300,8 @@ function PolarProvider({ adapter, userId, children }) {
       cancelSubscription,
       getPortalUrl
     }),
-    [status, loading, refresh, startCheckout, syncSubscription, getBillingHistory, cancelSubscription, getPortalUrl]
+    [status, loading, refresh, syncSubscription]
+    // startCheckout, getBillingHistory, cancelSubscription, getPortalUrl are stable
   );
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PolarContext.Provider, { value, children });
 }

package/dist/index.mjs

@@ -1,19 +1,19 @@
 // src/infrastructure/utils/normalization.util.ts
+var STATUS_MAP = {
+  active: "active",
+  trialing: "trialing",
+  past_due: "past_due",
+  incomplete: "incomplete",
+  incomplete_expired: "incomplete_expired",
+  unpaid: "unpaid",
+  canceled: "canceled",
+  cancelled: "canceled",
+  revoked: "revoked",
+  none: "none"
+};
 function normalizeStatus(raw) {
-  const map = {
-    active: "active",
-    trialing: "trialing",
-    past_due: "past_due",
-    incomplete: "incomplete",
-    incomplete_expired: "incomplete_expired",
-    unpaid: "unpaid",
-    canceled: "canceled",
-    cancelled: "canceled",
-    revoked: "revoked",
-    none: "none"
-  };
   if (typeof raw !== "string") return "none";
-  return map[raw.toLowerCase()] ?? "none";
+  return STATUS_MAP[raw.toLowerCase()] ?? "none";
 }
 function normalizeBillingCycle(interval) {
   if (typeof interval !== "string") return "monthly";
@@ -55,15 +55,31 @@ function createFirebaseAdapter(config) {
     cancelAtPeriodEnd: config.db?.cancelAtPeriodEndField ?? "cancelAtPeriodEnd",
     currentPeriodEnd: config.db?.currentPeriodEndField ?? "currentPeriodEnd"
   };
+  let httpsCallableCache = null;
+  let firestoreCache = null;
+  async function getHttpsCallable() {
+    if (!httpsCallableCache) {
+      const mod = await import("firebase/functions");
+      httpsCallableCache = mod.httpsCallable;
+    }
+    return httpsCallableCache;
+  }
+  async function getFirestore() {
+    if (!firestoreCache) {
+      const mod = await import("firebase/firestore");
+      firestoreCache = { doc: mod.doc, getDoc: mod.getDoc };
+    }
+    return firestoreCache;
+  }
   async function callable(name, data) {
-    const { httpsCallable } = await import("firebase/functions");
+    const httpsCallable = await getHttpsCallable();
     const fn = httpsCallable(functions, name);
     const result = await fn(data);
     return result.data;
   }
   return {
     async getStatus(userId) {
-      const { doc, getDoc } = await import("firebase/firestore");
+      const { doc, getDoc } = await getFirestore();
       const snap = await getDoc(doc(firestore, db.collection, userId));
       if (!snap.exists()) {
         return { plan: "free", subscriptionStatus: "none" };
@@ -117,7 +133,7 @@ function createFirebaseAdapter(config) {
 }
 
 // src/infrastructure/constants/billing.constants.ts
-var SUBSCRIPTION_STATUS = {
+var SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: "active",
   CANCELED: "canceled",
   REVOKED: "revoked",
@@ -127,7 +143,7 @@ var SUBSCRIPTION_STATUS = {
   INCOMPLETE_EXPIRED: "incomplete_expired",
   UNPAID: "unpaid",
   NONE: "none"
-};
+});
 var FREE_PLAN = "free";
 
 // src/presentation/components/PolarProvider.tsx
@@ -164,31 +180,36 @@ function PolarProvider({ adapter, userId, children }) {
   const [status, setStatus] = useState(FREE_STATUS);
   const [loading, setLoading] = useState(true);
   const adapterRef = useRef(adapter);
-  adapterRef.current = adapter;
+  const statusRef = useRef({ setStatus, setLoading });
+  const userIdRef = useRef(normalizeUserId(userId));
   const refreshAbortRef = useRef(null);
+  adapterRef.current = adapter;
+  statusRef.current = { setStatus, setLoading };
+  userIdRef.current = normalizeUserId(userId);
   const refresh = useCallback(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
+    const { setStatus: setStatus2, setLoading: setLoading2 } = statusRef.current;
     if (!uid) {
-      setStatus(FREE_STATUS);
-      setLoading(false);
+      setStatus2(FREE_STATUS);
+      setLoading2(false);
       return;
     }
     refreshAbortRef.current?.abort();
     const ctrl = new AbortController();
     refreshAbortRef.current = ctrl;
     try {
-      setLoading(true);
+      setLoading2(true);
       const s = await adapterRef.current.getStatus(uid);
-      if (!ctrl.signal.aborted) setStatus(s);
+      if (!ctrl.signal.aborted) setStatus2(s);
     } catch (err) {
       if (!ctrl.signal.aborted) {
         console.error("[polar-billing] getStatus failed:", err);
-        setStatus(FREE_STATUS);
+        setStatus2(FREE_STATUS);
       }
     } finally {
-      if (!ctrl.signal.aborted) setLoading(false);
+      if (!ctrl.signal.aborted) setLoading2(false);
     }
-  }, [userId]);
+  }, []);
   useEffect(() => {
     refresh();
     return () => {
@@ -196,26 +217,26 @@ function PolarProvider({ adapter, userId, children }) {
     };
   }, [refresh]);
   const startCheckout = useCallback(async (params) => {
-    const uid = normalizeUserId(userId);
-    const result = await adapterRef.current.createCheckout({ ...params, userId: uid });
+    const uid = userIdRef.current;
+    const result = await adapterRef.current.createCheckout({ ...params, userId: uid ?? void 0 });
     if (!result.url.startsWith("https://")) {
       throw new Error("[polar-billing] Invalid checkout URL returned: URL must start with https://");
     }
     window.location.href = result.url;
-  }, [userId]);
+  }, []);
   const syncSubscription = useCallback(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return { synced: false };
     const checkoutId = new URLSearchParams(window.location.search).get("checkout_id") ?? void 0;
     const result = await adapterRef.current.syncSubscription(uid, checkoutId);
     if (result.synced) await refresh();
     return result;
-  }, [userId, refresh]);
+  }, [refresh]);
   const getBillingHistory = useCallback(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return [];
     return adapterRef.current.getBillingHistory(uid);
-  }, [userId]);
+  }, []);
   const cancelSubscription = useCallback(
     async (reason) => {
       const result = await adapterRef.current.cancelSubscription(reason);
@@ -223,12 +244,13 @@ function PolarProvider({ adapter, userId, children }) {
       return result;
     },
     [refresh]
+    // Only depends on stable refresh
   );
   const getPortalUrl = useCallback(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) throw new Error("[polar-billing] Cannot get portal URL: No authenticated user");
     return adapterRef.current.getPortalUrl(uid);
-  }, [userId]);
+  }, []);
   const value = useMemo(
     () => ({
       status,
@@ -240,7 +262,8 @@ function PolarProvider({ adapter, userId, children }) {
       cancelSubscription,
       getPortalUrl
     }),
-    [status, loading, refresh, startCheckout, syncSubscription, getBillingHistory, cancelSubscription, getPortalUrl]
+    [status, loading, refresh, syncSubscription]
+    // startCheckout, getBillingHistory, cancelSubscription, getPortalUrl are stable
   );
   return /* @__PURE__ */ jsx(PolarContext.Provider, { value, children });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-polar-payment",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Universal Polar.sh subscription billing — Firebase adapter",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/infrastructure/constants/billing.constants.ts

@@ -3,7 +3,8 @@
  * @description Standardized subscription states and plan names
  */
 
-export const SUBSCRIPTION_STATUS = {
+// Object.freeze() prevents accidental mutations and enables V8 optimizations
+export const SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: 'active' as const,
   CANCELED: 'canceled' as const,
   REVOKED: 'revoked' as const,
@@ -13,6 +14,16 @@ export const SUBSCRIPTION_STATUS = {
   INCOMPLETE_EXPIRED: 'incomplete_expired' as const,
   UNPAID: 'unpaid' as const,
   NONE: 'none' as const,
-};
+}) as Readonly<{
+  ACTIVE: 'active';
+  CANCELED: 'canceled';
+  REVOKED: 'revoked';
+  TRIALING: 'trialing';
+  PAST_DUE: 'past_due';
+  INCOMPLETE: 'incomplete';
+  INCOMPLETE_EXPIRED: 'incomplete_expired';
+  UNPAID: 'unpaid';
+  NONE: 'none';
+}>;
 
 export const FREE_PLAN = 'free';

package/src/infrastructure/services/firebase-billing.service.ts

@@ -95,8 +95,29 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
     currentPeriodEnd: config.db?.currentPeriodEndField ?? 'currentPeriodEnd',
   };
 
+  // Cache imports to avoid repeated dynamic import overhead
+  // Reduces latency on subsequent calls and GC pressure
+  let httpsCallableCache: typeof import('firebase/functions')['httpsCallable'] | null = null;
+  let firestoreCache: { doc: any; getDoc: any } | null = null;
+
+  async function getHttpsCallable() {
+    if (!httpsCallableCache) {
+      const mod = await import('firebase/functions');
+      httpsCallableCache = mod.httpsCallable;
+    }
+    return httpsCallableCache;
+  }
+
+  async function getFirestore() {
+    if (!firestoreCache) {
+      const mod = await import('firebase/firestore');
+      firestoreCache = { doc: mod.doc, getDoc: mod.getDoc };
+    }
+    return firestoreCache;
+  }
+
   async function callable<T = unknown, R = unknown>(name: string, data?: T): Promise<R> {
-    const { httpsCallable } = await import('firebase/functions');
+    const httpsCallable = await getHttpsCallable();
     const fn = (httpsCallable as any)(functions, name) as (data?: T) => Promise<{ data: R }>;
     const result = await fn(data);
     return result.data;
@@ -104,7 +125,7 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
 
   return {
     async getStatus(userId: string): Promise<SubscriptionStatus> {
-      const { doc, getDoc } = await import('firebase/firestore');
+      const { doc, getDoc } = await getFirestore();
       const snap = await getDoc((doc as any)(firestore, db.collection, userId));
 
       if (!snap.exists()) {

package/src/infrastructure/utils/normalization.util.ts

@@ -1,25 +1,27 @@
 import type { SubscriptionStatusValue, BillingCycle } from '../../domain/entities';
 
+// Static map outside function scope - created once, reused forever
+// Reduces GC pressure from repeated object allocations
+const STATUS_MAP: Readonly<Record<string, SubscriptionStatusValue>> = {
+  active: 'active',
+  trialing: 'trialing',
+  past_due: 'past_due',
+  incomplete: 'incomplete',
+  incomplete_expired: 'incomplete_expired',
+  unpaid: 'unpaid',
+  canceled: 'canceled',
+  cancelled: 'canceled',
+  revoked: 'revoked',
+  none: 'none',
+};
+
 /**
  * Normalize a raw Polar status string to a known value.
  * @description Defaults to 'none' for unknown statuses or non-string input.
  */
 export function normalizeStatus(raw: string): SubscriptionStatusValue {
-  const map: Record<string, SubscriptionStatusValue> = {
-    active: 'active',
-    trialing: 'trialing',
-    past_due: 'past_due',
-    incomplete: 'incomplete',
-    incomplete_expired: 'incomplete_expired',
-    unpaid: 'unpaid',
-    canceled: 'canceled',
-    cancelled: 'canceled',
-    revoked: 'revoked',
-    none: 'none',
-  };
-
   if (typeof raw !== 'string') return 'none';
-  return map[raw.toLowerCase()] ?? 'none';
+  return STATUS_MAP[raw.toLowerCase()] ?? 'none';
 }
 
 /**

package/src/presentation/components/PolarProvider.tsx

@@ -42,12 +42,23 @@ function normalizeUserId(userId: string | undefined): string | undefined {
 export function PolarProvider({ adapter, userId, children }: PolarProviderProps) {
   const [status, setStatus] = useState<SubscriptionStatus>(FREE_STATUS);
   const [loading, setLoading] = useState(true);
+
+  // Store adapter and setters in refs to create stable callbacks
   const adapterRef = useRef(adapter);
-  adapterRef.current = adapter;
+  const statusRef = useRef({ setStatus, setLoading });
+  const userIdRef = useRef(normalizeUserId(userId));
   const refreshAbortRef = useRef<AbortController | null>(null);
 
+  // Keep refs in sync
+  adapterRef.current = adapter;
+  statusRef.current = { setStatus, setLoading };
+  userIdRef.current = normalizeUserId(userId);
+
+  // Stable refresh function with no dependencies - prevents cascading re-renders
   const refresh = useCallback(async () => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
+    const { setStatus, setLoading } = statusRef.current;
+
     if (!uid) {
       setStatus(FREE_STATUS);
       setLoading(false);
@@ -70,37 +81,37 @@ export function PolarProvider({ adapter, userId, children }: PolarProviderProps)
     } finally {
       if (!ctrl.signal.aborted) setLoading(false);
     }
-  }, [userId]);
+  }, []); // No dependencies - completely stable
 
   useEffect(() => {
     refresh();
     return () => { refreshAbortRef.current?.abort(); };
-  }, [refresh]);
+  }, [refresh]); // Only re-run if refresh identity changes (never)
 
   const startCheckout = useCallback(async (params: CheckoutParams) => {
-    const uid = normalizeUserId(userId);
-    const result = await adapterRef.current.createCheckout({ ...params, userId: uid });
+    const uid = userIdRef.current;
+    const result = await adapterRef.current.createCheckout({ ...params, userId: uid ?? undefined });
     if (!result.url.startsWith('https://')) {
       throw new Error('[polar-billing] Invalid checkout URL returned: URL must start with https://');
     }
     window.location.href = result.url;
-  }, [userId]);
+  }, []); // No dependencies - stable
 
   const syncSubscription = useCallback(async (): Promise<SyncResult> => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return { synced: false };
 
     const checkoutId = new URLSearchParams(window.location.search).get('checkout_id') ?? undefined;
     const result = await adapterRef.current.syncSubscription(uid, checkoutId);
     if (result.synced) await refresh();
     return result;
-  }, [userId, refresh]);
+  }, [refresh]); // Only depends on stable refresh
 
   const getBillingHistory = useCallback(async (): Promise<OrderItem[]> => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) return [];
     return adapterRef.current.getBillingHistory(uid);
-  }, [userId]);
+  }, []); // No dependencies - stable
 
   const cancelSubscription = useCallback(
     async (reason?: CancellationReason): Promise<CancelResult> => {
@@ -108,15 +119,17 @@ export function PolarProvider({ adapter, userId, children }: PolarProviderProps)
       if (result.success) await refresh();
       return result;
     },
-    [refresh],
+    [refresh], // Only depends on stable refresh
   );
 
   const getPortalUrl = useCallback(async (): Promise<string> => {
-    const uid = normalizeUserId(userId);
+    const uid = userIdRef.current;
     if (!uid) throw new Error('[polar-billing] Cannot get portal URL: No authenticated user');
     return adapterRef.current.getPortalUrl(uid);
-  }, [userId]);
+  }, []); // No dependencies - stable
 
+  // Memoized context value - only recreates when status/loading changes
+  // All functions are stable, so they don't trigger re-creation
   const value = useMemo(
     () => ({
       status,
@@ -128,7 +141,7 @@ export function PolarProvider({ adapter, userId, children }: PolarProviderProps)
       cancelSubscription,
       getPortalUrl,
     }),
-    [status, loading, refresh, startCheckout, syncSubscription, getBillingHistory, cancelSubscription, getPortalUrl],
+    [status, loading, refresh, syncSubscription], // startCheckout, getBillingHistory, cancelSubscription, getPortalUrl are stable
   );
 
   return <PolarContext.Provider value={value}>{children}</PolarContext.Provider>;