@umituz/web-polar-payment 1.0.14 → 1.0.16

package/dist/index.mjs

@@ -1,18 +1,164 @@
-// 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"
+// src/presentation/components/PolarProvider.tsx
+import {
+  useEffect,
+  useState,
+  useCallback,
+  useRef,
+  useMemo
+} from "react";
+
+// src/presentation/hooks/usePolarBilling.ts
+import { createContext, useContext } from "react";
+var PolarContext = createContext(void 0);
+function usePolarBilling() {
+  const ctx = useContext(PolarContext);
+  if (!ctx) throw new Error("usePolarBilling must be used within <PolarProvider>");
+  return ctx;
+}
+
+// src/infrastructure/utils/validations.util.ts
+function normalizeUserId(userId) {
+  if (typeof userId !== "string") return void 0;
+  const trimmed = userId.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function isValidProductId(productId) {
+  return typeof productId === "string" && productId.trim().length > 0;
+}
+function isValidCheckoutUrl(url) {
+  return url.startsWith("https://") || url.startsWith("http://");
+}
+function isProductionInsecureUrl(url) {
+  return url.startsWith("http://") && !url.includes("localhost") && !url.includes("127.0.0.1");
+}
+
+// src/presentation/components/PolarProvider.tsx
+import { jsx } from "react/jsx-runtime";
+var FREE_STATUS = {
+  plan: "free",
+  subscriptionStatus: "none"
 };
+function PolarProvider({ adapter, userId, children }) {
+  const [status, setStatus] = useState(FREE_STATUS);
+  const [loading, setLoading] = useState(true);
+  const adapterRef = useRef(adapter);
+  const statusRef = useRef({ setStatus, setLoading });
+  const userIdRef = useRef(normalizeUserId(userId));
+  const refreshMountedRef = useRef(true);
+  adapterRef.current = adapter;
+  statusRef.current = { setStatus, setLoading };
+  userIdRef.current = normalizeUserId(userId);
+  const refresh = useCallback(async () => {
+    const uid = userIdRef.current;
+    const { setStatus: setStatus2, setLoading: setLoading2 } = statusRef.current;
+    if (!uid) {
+      setStatus2(FREE_STATUS);
+      setLoading2(false);
+      return;
+    }
+    refreshMountedRef.current = true;
+    try {
+      setLoading2(true);
+      const s = await adapterRef.current.getStatus(uid);
+      if (refreshMountedRef.current) setStatus2(s);
+    } catch (err) {
+      if (refreshMountedRef.current) {
+        setStatus2(FREE_STATUS);
+      }
+    } finally {
+      if (refreshMountedRef.current) setLoading2(false);
+    }
+  }, []);
+  useEffect(() => {
+    refreshMountedRef.current = true;
+    refresh();
+    return () => {
+      refreshMountedRef.current = false;
+    };
+  }, [userId]);
+  const startCheckout = useCallback(async (params) => {
+    if (!isValidProductId(params.productId)) {
+      throw new Error("[polar-billing] Invalid productId: must be a non-empty string");
+    }
+    const uid = userIdRef.current;
+    const result = await adapterRef.current.createCheckout({ ...params, userId: uid ?? void 0 });
+    if (!isValidCheckoutUrl(result.url)) {
+      throw new Error("[polar-billing] Invalid checkout URL returned: URL must start with https:// or http://");
+    }
+    if (isProductionInsecureUrl(result.url)) {
+      throw new Error("[polar-billing] ERROR: Using insecure http:// URL in production environment");
+    }
+    window.location.href = result.url;
+  }, []);
+  const syncSubscription = useCallback(async () => {
+    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;
+  }, [refresh]);
+  const getBillingHistory = useCallback(async () => {
+    const uid = userIdRef.current;
+    if (!uid) return [];
+    return adapterRef.current.getBillingHistory(uid);
+  }, []);
+  const cancelSubscription = useCallback(
+    async (reason) => {
+      const result = await adapterRef.current.cancelSubscription(reason);
+      if (result.success) await refresh();
+      return result;
+    },
+    [refresh]
+  );
+  const getPortalUrl = useCallback(async () => {
+    const uid = userIdRef.current;
+    if (!uid) throw new Error("[polar-billing] Cannot get portal URL: No authenticated user");
+    return adapterRef.current.getPortalUrl(uid);
+  }, []);
+  const value = useMemo(
+    () => ({
+      status,
+      loading,
+      refresh,
+      startCheckout,
+      syncSubscription,
+      getBillingHistory,
+      cancelSubscription,
+      getPortalUrl
+    }),
+    [status, loading, refresh, syncSubscription]
+  );
+  return /* @__PURE__ */ jsx(PolarContext.Provider, { value, children });
+}
+
+// src/infrastructure/constants/billing.constants.ts
+var SUBSCRIPTION_STATUS = Object.freeze({
+  ACTIVE: "active",
+  CANCELED: "canceled",
+  REVOKED: "revoked",
+  TRIALING: "trialing",
+  PAST_DUE: "past_due",
+  INCOMPLETE: "incomplete",
+  INCOMPLETE_EXPIRED: "incomplete_expired",
+  UNPAID: "unpaid",
+  NONE: "none"
+});
+
+// src/infrastructure/utils/normalization.util.ts
+var STATUS_MAP = Object.freeze({
+  [SUBSCRIPTION_STATUS.ACTIVE]: SUBSCRIPTION_STATUS.ACTIVE,
+  [SUBSCRIPTION_STATUS.CANCELED]: SUBSCRIPTION_STATUS.CANCELED,
+  [SUBSCRIPTION_STATUS.REVOKED]: SUBSCRIPTION_STATUS.REVOKED,
+  [SUBSCRIPTION_STATUS.TRIALING]: SUBSCRIPTION_STATUS.TRIALING,
+  [SUBSCRIPTION_STATUS.PAST_DUE]: SUBSCRIPTION_STATUS.PAST_DUE,
+  [SUBSCRIPTION_STATUS.INCOMPLETE]: SUBSCRIPTION_STATUS.INCOMPLETE,
+  [SUBSCRIPTION_STATUS.INCOMPLETE_EXPIRED]: SUBSCRIPTION_STATUS.INCOMPLETE_EXPIRED,
+  [SUBSCRIPTION_STATUS.UNPAID]: SUBSCRIPTION_STATUS.UNPAID,
+  [SUBSCRIPTION_STATUS.NONE]: SUBSCRIPTION_STATUS.NONE
+});
 function normalizeStatus(raw) {
-  if (typeof raw !== "string") return "none";
+  if (raw == null || typeof raw !== "string") return "none";
   return STATUS_MAP[raw.toLowerCase()] ?? "none";
 }
 function normalizeBillingCycle(interval) {
@@ -23,7 +169,7 @@ function normalizeBillingCycle(interval) {
   return "monthly";
 }
 
-// src/infrastructure/services/firebase-billing.service.ts
+// src/infrastructure/utils/firebase-helpers.util.ts
 function asString(value) {
   if (typeof value === "string") return value;
   return void 0;
@@ -33,8 +179,10 @@ function asBoolean(value) {
   return void 0;
 }
 function isTimestamp(value) {
-  return typeof value === "object" && value !== null && "toDate" in value && typeof value.toDate === "function";
+  return typeof value === "object" && value !== null && "toDate" in value && "function" === typeof value.toDate;
 }
+
+// src/infrastructure/services/firebase-billing.service.ts
 function createFirebaseAdapter(config) {
   const functions = config.functions;
   const firestore = config.firestore;
@@ -60,7 +208,7 @@ function createFirebaseAdapter(config) {
   async function getHttpsCallable() {
     if (!httpsCallableCache) {
       const mod = await import("firebase/functions");
-      httpsCallableCache = mod.httpsCallable;
+      httpsCallableCache = mod.httpsCallable(functions);
     }
     return httpsCallableCache;
   }
@@ -73,15 +221,17 @@ function createFirebaseAdapter(config) {
   }
   async function callable(name, data) {
     const httpsCallable = await getHttpsCallable();
-    const fn = httpsCallable(functions, name);
+    const fn = httpsCallable(name);
     const result = await fn(data);
     return result.data;
   }
   return {
     async getStatus(userId) {
       const { doc, getDoc } = await getFirestore();
-      const snap = await getDoc(doc(firestore, db.collection, userId));
-      if (!snap.exists()) {
+      const docRef = doc(firestore, db.collection, userId);
+      const snap = await getDoc(docRef);
+      const exists = snap.exists;
+      if (!exists) {
         return { plan: "free", subscriptionStatus: "none" };
       }
       const d = snap.data();
@@ -107,174 +257,31 @@ function createFirebaseAdapter(config) {
     async createCheckout(params) {
       return callable(callables.createCheckout, params);
     },
-    async syncSubscription(_userId, _checkoutId) {
-      return callable(callables.sync, {});
+    async syncSubscription(userId, checkoutId) {
+      return callable(callables.sync, { userId, checkoutId });
     },
-    async getBillingHistory(_userId) {
+    async getBillingHistory(userId) {
       const result = await callable(
         callables.billing,
-        {}
+        { userId }
       );
       return result.orders ?? [];
     },
     async cancelSubscription(reason) {
       return callable(callables.cancel, { reason });
     },
-    async getPortalUrl(_userId) {
+    async getPortalUrl(userId) {
       const result = await callable(
         callables.portal,
-        {}
+        { userId }
       );
-      const url = result.url ?? result.customerPortalUrl;
-      if (!url) throw new Error("No portal URL returned from Cloud Function");
-      return url;
+      return result.url;
     }
   };
 }
-
-// src/infrastructure/constants/billing.constants.ts
-var SUBSCRIPTION_STATUS = Object.freeze({
-  ACTIVE: "active",
-  CANCELED: "canceled",
-  REVOKED: "revoked",
-  TRIALING: "trialing",
-  PAST_DUE: "past_due",
-  INCOMPLETE: "incomplete",
-  INCOMPLETE_EXPIRED: "incomplete_expired",
-  UNPAID: "unpaid",
-  NONE: "none"
-});
-var FREE_PLAN = "free";
-
-// src/presentation/components/PolarProvider.tsx
-import {
-  useEffect,
-  useState,
-  useCallback,
-  useRef,
-  useMemo
-} from "react";
-
-// src/presentation/hooks/usePolarBilling.ts
-import { createContext, useContext } from "react";
-var PolarContext = createContext(void 0);
-function usePolarBilling() {
-  const ctx = useContext(PolarContext);
-  if (!ctx) throw new Error("usePolarBilling must be used within <PolarProvider>");
-  return ctx;
-}
-var useSubscription = usePolarBilling;
-
-// src/presentation/components/PolarProvider.tsx
-import { jsx } from "react/jsx-runtime";
-var FREE_STATUS = {
-  plan: "free",
-  subscriptionStatus: "none"
-};
-function normalizeUserId(userId) {
-  if (typeof userId !== "string") return void 0;
-  const trimmed = userId.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-function PolarProvider({ adapter, userId, children }) {
-  const [status, setStatus] = useState(FREE_STATUS);
-  const [loading, setLoading] = useState(true);
-  const adapterRef = useRef(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 = userIdRef.current;
-    const { setStatus: setStatus2, setLoading: setLoading2 } = statusRef.current;
-    if (!uid) {
-      setStatus2(FREE_STATUS);
-      setLoading2(false);
-      return;
-    }
-    refreshAbortRef.current?.abort();
-    const ctrl = new AbortController();
-    refreshAbortRef.current = ctrl;
-    try {
-      setLoading2(true);
-      const s = await adapterRef.current.getStatus(uid);
-      if (!ctrl.signal.aborted) setStatus2(s);
-    } catch (err) {
-      if (!ctrl.signal.aborted) {
-        console.error("[polar-billing] getStatus failed:", err);
-        setStatus2(FREE_STATUS);
-      }
-    } finally {
-      if (!ctrl.signal.aborted) setLoading2(false);
-    }
-  }, []);
-  useEffect(() => {
-    refresh();
-    return () => {
-      refreshAbortRef.current?.abort();
-    };
-  }, [refresh]);
-  const startCheckout = useCallback(async (params) => {
-    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;
-  }, []);
-  const syncSubscription = useCallback(async () => {
-    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;
-  }, [refresh]);
-  const getBillingHistory = useCallback(async () => {
-    const uid = userIdRef.current;
-    if (!uid) return [];
-    return adapterRef.current.getBillingHistory(uid);
-  }, []);
-  const cancelSubscription = useCallback(
-    async (reason) => {
-      const result = await adapterRef.current.cancelSubscription(reason);
-      if (result.success) await refresh();
-      return result;
-    },
-    [refresh]
-    // Only depends on stable refresh
-  );
-  const getPortalUrl = useCallback(async () => {
-    const uid = userIdRef.current;
-    if (!uid) throw new Error("[polar-billing] Cannot get portal URL: No authenticated user");
-    return adapterRef.current.getPortalUrl(uid);
-  }, []);
-  const value = useMemo(
-    () => ({
-      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 });
-}
 export {
-  FREE_PLAN,
-  PolarContext,
   PolarProvider,
   SUBSCRIPTION_STATUS,
   createFirebaseAdapter,
-  normalizeBillingCycle,
-  normalizeStatus,
-  usePolarBilling,
-  useSubscription
+  usePolarBilling
 };

package/package.json

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

package/src/domain/entities/cancellation.entity.ts

@@ -1,8 +1,3 @@
-/**
- * Cancellation Entity
- * @description Types for subscription cancellation reasons and outcomes
- */
-
 export type CancellationReason =
   | 'too_expensive'
   | 'missing_features'

package/src/domain/entities/checkout.entity.ts

@@ -1,14 +1,8 @@
-/**
- * Checkout Entity
- * @description Types for initiating and following process of checkouts
- */
-
 export interface CheckoutParams {
   productId: string;
   planKey?: string;
   billingCycle?: 'monthly' | 'yearly';
   successUrl?: string;
-  /** Injected automatically by PolarProvider — do not pass manually */
   userId?: string;
 }
 

package/src/domain/entities/order.entity.ts

@@ -1,8 +1,3 @@
-/**
- * Order Entity
- * @description Types for billing history items
- */
-
 export interface OrderItem {
   id: string;
   createdAt: string;

package/src/domain/entities/subscription.entity.ts

@@ -1,8 +1,3 @@
-/**
- * Subscription Entity
- * @description Types for subscription status and billing cycles
- */
-
 export type SubscriptionStatusValue =
   | 'active'
   | 'canceled'
@@ -24,6 +19,5 @@ export interface SubscriptionStatus {
   currentPeriodEnd?: string;
   billingCycle?: BillingCycle;
   polarCustomerId?: string;
-  /** Token balance (for token-based projects like Aria) */
   tokens?: number;
 }

package/src/domain/entities/sync.entity.ts

@@ -1,8 +1,3 @@
-/**
- * Sync Entity
- * @description Type for subscription synchronization results
- */
-
 export interface SyncResult {
   synced: boolean;
   plan?: string;

package/src/domain/index.ts

@@ -1,7 +1,2 @@
-/**
- * Domain Layer
- * Subpath: @umituz/web-polar-payment/domain
- */
-
 export * from './entities';
 export * from './interfaces';

package/src/domain/interfaces/polar-adapter.interface.ts

@@ -8,14 +8,9 @@ import type {
   SyncResult,
 } from '../entities';
 
-/**
- * Backend-agnostic interface every adapter must implement.
- * @description Contract for Polar billing adapters (Firebase, Supabase, etc.)
- */
 export interface PolarAdapter {
   getStatus(userId: string): Promise<SubscriptionStatus>;
   createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
-  /** checkoutId is read from URL by the context and passed explicitly */
   syncSubscription(userId: string, checkoutId?: string): Promise<SyncResult>;
   getBillingHistory(userId: string): Promise<OrderItem[]>;
   cancelSubscription(reason?: CancellationReason): Promise<CancelResult>;

package/src/index.ts

@@ -1,11 +1,9 @@
-/**
- * @umituz/web-polar-payment
- * Universal Polar.sh subscription billing — Firebase adapter
- *
- * IMPORTANT: Apps should NOT use this root barrel export.
- * Use subpath imports instead: "@umituz/web-polar-payment/domain"
- */
-
-export * from './domain';
-export * from './infrastructure';
-export * from './presentation';
+export { PolarProvider } from './presentation/components/PolarProvider';
+export { usePolarBilling } from './presentation/hooks/usePolarBilling';
+export type { PolarContextValue } from './presentation/hooks/usePolarBilling';
+export { createFirebaseAdapter } from './infrastructure/services/firebase-billing.service';
+export type { FirebaseAdapterConfig } from './infrastructure/services/firebase-billing.service';
+export { SUBSCRIPTION_STATUS } from './infrastructure/constants/billing.constants';
+export type { SubscriptionStatusValue, BillingCycle } from './domain/entities/subscription.entity';
+export type { SubscriptionStatus, CheckoutParams, CheckoutResult, OrderItem, CancellationReason, CancelResult, SyncResult } from './domain/entities';
+export type { PolarAdapter } from './domain/interfaces';

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

@@ -1,9 +1,3 @@
-/**
- * Billing Constants
- * @description Standardized subscription states and plan names
- */
-
-// Object.freeze() prevents accidental mutations and enables V8 optimizations
 export const SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: 'active' as const,
   CANCELED: 'canceled' as const,
@@ -25,5 +19,3 @@ export const SUBSCRIPTION_STATUS = Object.freeze({
   UNPAID: 'unpaid';
   NONE: 'none';
 }>;
-
-export const FREE_PLAN = 'free';

package/src/infrastructure/index.ts

@@ -1,8 +1,5 @@
-/**
- * Infrastructure Layer
- * Subpath: @umituz/web-polar-payment/infrastructure
- */
-
 export * from './services/firebase-billing.service';
 export * from './constants/billing.constants';
 export * from './utils/normalization.util';
+export * from './utils/validations.util';
+export * from './utils/firebase-helpers.util';