@umituz/web-polar-payment 1.0.15 → 1.0.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 umituz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @umituz/web-polar-payment
+
+Polar payment integration for web applications with subscription management.
+
+## Features
+
+- Checkout integration
+- Subscription management
+- Webhook handling
+- Customer portal
+
+## Installation
+
+```bash
+npm install @umituz/web-polar-payment
+```
+
+## Usage
+
+```typescript
+import { PolarCheckout } from '@umituz/web-polar-payment';
+
+<PolarCheckout
+  productId="prod_xxx"
+  onSuccess={(session) => console.log(session)}
+/>
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
 import { ReactNode } from 'react';
 
 type SubscriptionStatusValue = 'active' | 'canceled' | 'revoked' | 'trialing' | 'past_due' | 'incomplete' | 'incomplete_expired' | 'unpaid' | 'none';
@@ -49,24 +48,36 @@ interface SyncResult {
     plan?: string;
 }
 
-/**
- * Backend-agnostic interface every adapter must implement.
- * @description Contract for Polar billing adapters (Firebase, Supabase, etc.)
- */
 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>;
     getPortalUrl(userId: string): Promise<string>;
 }
 
+interface PolarProviderProps {
+    adapter: PolarAdapter;
+    userId?: string;
+    children: ReactNode;
+}
+declare function PolarProvider({ adapter, userId, children }: PolarProviderProps): react_jsx_runtime.JSX.Element;
+
+interface PolarContextValue {
+    status: SubscriptionStatus;
+    loading: boolean;
+    refresh: () => Promise<void>;
+    startCheckout: (params: CheckoutParams) => Promise<void>;
+    syncSubscription: () => Promise<SyncResult>;
+    getBillingHistory: () => Promise<OrderItem[]>;
+    cancelSubscription: (reason?: CancellationReason) => Promise<CancelResult>;
+    getPortalUrl: () => Promise<string>;
+}
+declare function usePolarBilling(): PolarContextValue;
+
 interface FirebaseAdapterConfig {
-    /** Firebase Functions instance from firebase/functions */
     functions: unknown;
-    /** Firebase Firestore instance from firebase/firestore */
     firestore: unknown;
     callables?: {
         createCheckout?: string;
@@ -99,41 +110,5 @@ declare const SUBSCRIPTION_STATUS: Readonly<{
     UNPAID: "unpaid";
     NONE: "none";
 }>;
-declare const FREE_PLAN = "free";
-
-declare function normalizeStatus(raw: string): SubscriptionStatusValue;
-declare function normalizeBillingCycle(interval: string): BillingCycle;
-
-declare function normalizeUserId(userId: string | undefined): string | undefined;
-declare function isValidProductId(productId: unknown): productId is string;
-declare function isValidCheckoutUrl(url: string): boolean;
-declare function isProductionInsecureUrl(url: string): boolean;
-
-declare function asString(value: unknown): string | undefined;
-declare function asBoolean(value: unknown): boolean | undefined;
-declare function isTimestamp(value: unknown): value is {
-    toDate(): Date;
-};
-
-interface PolarProviderProps {
-    adapter: PolarAdapter;
-    userId?: string;
-    children: ReactNode;
-}
-declare function PolarProvider({ adapter, userId, children }: PolarProviderProps): react_jsx_runtime.JSX.Element;
-
-interface PolarContextValue {
-    status: SubscriptionStatus;
-    loading: boolean;
-    refresh: () => Promise<void>;
-    startCheckout: (params: CheckoutParams) => Promise<void>;
-    syncSubscription: () => Promise<SyncResult>;
-    getBillingHistory: () => Promise<OrderItem[]>;
-    cancelSubscription: (reason?: CancellationReason) => Promise<CancelResult>;
-    getPortalUrl: () => Promise<string>;
-}
-declare const PolarContext: react.Context<PolarContextValue | undefined>;
-declare function usePolarBilling(): PolarContextValue;
-declare const useSubscription: typeof usePolarBilling;
 
-export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, FREE_PLAN, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, PolarContext, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, asBoolean, asString, createFirebaseAdapter, isProductionInsecureUrl, isTimestamp, isValidCheckoutUrl, isValidProductId, normalizeBillingCycle, normalizeStatus, normalizeUserId, usePolarBilling, useSubscription };
+export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, createFirebaseAdapter, usePolarBilling };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
 import { ReactNode } from 'react';
 
 type SubscriptionStatusValue = 'active' | 'canceled' | 'revoked' | 'trialing' | 'past_due' | 'incomplete' | 'incomplete_expired' | 'unpaid' | 'none';
@@ -49,24 +48,36 @@ interface SyncResult {
     plan?: string;
 }
 
-/**
- * Backend-agnostic interface every adapter must implement.
- * @description Contract for Polar billing adapters (Firebase, Supabase, etc.)
- */
 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>;
     getPortalUrl(userId: string): Promise<string>;
 }
 
+interface PolarProviderProps {
+    adapter: PolarAdapter;
+    userId?: string;
+    children: ReactNode;
+}
+declare function PolarProvider({ adapter, userId, children }: PolarProviderProps): react_jsx_runtime.JSX.Element;
+
+interface PolarContextValue {
+    status: SubscriptionStatus;
+    loading: boolean;
+    refresh: () => Promise<void>;
+    startCheckout: (params: CheckoutParams) => Promise<void>;
+    syncSubscription: () => Promise<SyncResult>;
+    getBillingHistory: () => Promise<OrderItem[]>;
+    cancelSubscription: (reason?: CancellationReason) => Promise<CancelResult>;
+    getPortalUrl: () => Promise<string>;
+}
+declare function usePolarBilling(): PolarContextValue;
+
 interface FirebaseAdapterConfig {
-    /** Firebase Functions instance from firebase/functions */
     functions: unknown;
-    /** Firebase Firestore instance from firebase/firestore */
     firestore: unknown;
     callables?: {
         createCheckout?: string;
@@ -99,41 +110,5 @@ declare const SUBSCRIPTION_STATUS: Readonly<{
     UNPAID: "unpaid";
     NONE: "none";
 }>;
-declare const FREE_PLAN = "free";
-
-declare function normalizeStatus(raw: string): SubscriptionStatusValue;
-declare function normalizeBillingCycle(interval: string): BillingCycle;
-
-declare function normalizeUserId(userId: string | undefined): string | undefined;
-declare function isValidProductId(productId: unknown): productId is string;
-declare function isValidCheckoutUrl(url: string): boolean;
-declare function isProductionInsecureUrl(url: string): boolean;
-
-declare function asString(value: unknown): string | undefined;
-declare function asBoolean(value: unknown): boolean | undefined;
-declare function isTimestamp(value: unknown): value is {
-    toDate(): Date;
-};
-
-interface PolarProviderProps {
-    adapter: PolarAdapter;
-    userId?: string;
-    children: ReactNode;
-}
-declare function PolarProvider({ adapter, userId, children }: PolarProviderProps): react_jsx_runtime.JSX.Element;
-
-interface PolarContextValue {
-    status: SubscriptionStatus;
-    loading: boolean;
-    refresh: () => Promise<void>;
-    startCheckout: (params: CheckoutParams) => Promise<void>;
-    syncSubscription: () => Promise<SyncResult>;
-    getBillingHistory: () => Promise<OrderItem[]>;
-    cancelSubscription: (reason?: CancellationReason) => Promise<CancelResult>;
-    getPortalUrl: () => Promise<string>;
-}
-declare const PolarContext: react.Context<PolarContextValue | undefined>;
-declare function usePolarBilling(): PolarContextValue;
-declare const useSubscription: typeof usePolarBilling;
 
-export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, FREE_PLAN, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, PolarContext, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, asBoolean, asString, createFirebaseAdapter, isProductionInsecureUrl, isTimestamp, isValidCheckoutUrl, isValidProductId, normalizeBillingCycle, normalizeStatus, normalizeUserId, usePolarBilling, useSubscription };
+export { type BillingCycle, type CancelResult, type CancellationReason, type CheckoutParams, type CheckoutResult, type FirebaseAdapterConfig, type OrderItem, type PolarAdapter, type PolarContextValue, PolarProvider, SUBSCRIPTION_STATUS, type SubscriptionStatus, type SubscriptionStatusValue, type SyncResult, createFirebaseAdapter, usePolarBilling };

package/dist/index.js

@@ -30,25 +30,141 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  FREE_PLAN: () => FREE_PLAN,
-  PolarContext: () => PolarContext,
   PolarProvider: () => PolarProvider,
   SUBSCRIPTION_STATUS: () => SUBSCRIPTION_STATUS,
-  asBoolean: () => asBoolean,
-  asString: () => asString,
   createFirebaseAdapter: () => createFirebaseAdapter,
-  isProductionInsecureUrl: () => isProductionInsecureUrl,
-  isTimestamp: () => isTimestamp,
-  isValidCheckoutUrl: () => isValidCheckoutUrl,
-  isValidProductId: () => isValidProductId,
-  normalizeBillingCycle: () => normalizeBillingCycle,
-  normalizeStatus: () => normalizeStatus,
-  normalizeUserId: () => normalizeUserId,
-  usePolarBilling: () => usePolarBilling,
-  useSubscription: () => useSubscription
+  usePolarBilling: () => usePolarBilling
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/presentation/components/PolarProvider.tsx
+var import_react2 = require("react");
+
+// src/presentation/hooks/usePolarBilling.ts
+var import_react = require("react");
+var PolarContext = (0, import_react.createContext)(void 0);
+function usePolarBilling() {
+  const ctx = (0, import_react.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
+var import_jsx_runtime = require("react/jsx-runtime");
+var FREE_STATUS = {
+  plan: "free",
+  subscriptionStatus: "none"
+};
+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);
+  const statusRef = (0, import_react2.useRef)({ setStatus, setLoading });
+  const userIdRef = (0, import_react2.useRef)(normalizeUserId(userId));
+  const refreshMountedRef = (0, import_react2.useRef)(true);
+  adapterRef.current = adapter;
+  statusRef.current = { setStatus, setLoading };
+  userIdRef.current = normalizeUserId(userId);
+  const refresh = (0, import_react2.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);
+    }
+  }, []);
+  (0, import_react2.useEffect)(() => {
+    refreshMountedRef.current = true;
+    refresh();
+    return () => {
+      refreshMountedRef.current = false;
+    };
+  }, [userId]);
+  const startCheckout = (0, import_react2.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 = (0, import_react2.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 = (0, import_react2.useCallback)(async () => {
+    const uid = userIdRef.current;
+    if (!uid) return [];
+    return adapterRef.current.getBillingHistory(uid);
+  }, []);
+  const cancelSubscription = (0, import_react2.useCallback)(
+    async (reason) => {
+      const result = await adapterRef.current.cancelSubscription(reason);
+      if (result.success) await refresh();
+      return result;
+    },
+    [refresh]
+  );
+  const getPortalUrl = (0, import_react2.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 = (0, import_react2.useMemo)(
+    () => ({
+      status,
+      loading,
+      refresh,
+      startCheckout,
+      syncSubscription,
+      getBillingHistory,
+      cancelSubscription,
+      getPortalUrl
+    }),
+    [status, loading, refresh, syncSubscription]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PolarContext.Provider, { value, children });
+}
+
 // src/infrastructure/constants/billing.constants.ts
 var SUBSCRIPTION_STATUS = Object.freeze({
   ACTIVE: "active",
@@ -61,7 +177,6 @@ var SUBSCRIPTION_STATUS = Object.freeze({
   UNPAID: "unpaid",
   NONE: "none"
 });
-var FREE_PLAN = "free";
 
 // src/infrastructure/utils/normalization.util.ts
 var STATUS_MAP = Object.freeze({
@@ -97,7 +212,7 @@ 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
@@ -126,7 +241,7 @@ function createFirebaseAdapter(config) {
   async function getHttpsCallable() {
     if (!httpsCallableCache) {
       const mod = await import("firebase/functions");
-      httpsCallableCache = mod.httpsCallable;
+      httpsCallableCache = mod.httpsCallable(functions);
     }
     return httpsCallableCache;
   }
@@ -139,15 +254,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();
@@ -173,174 +290,32 @@ 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 }
       );
       return result.url;
     }
   };
 }
-
-// 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
-var import_react2 = require("react");
-
-// src/presentation/hooks/usePolarBilling.ts
-var import_react = require("react");
-var PolarContext = (0, import_react.createContext)(void 0);
-function usePolarBilling() {
-  const ctx = (0, import_react.useContext)(PolarContext);
-  if (!ctx) throw new Error("usePolarBilling must be used within <PolarProvider>");
-  return ctx;
-}
-var useSubscription = usePolarBilling;
-
-// src/presentation/components/PolarProvider.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-var FREE_STATUS = {
-  plan: "free",
-  subscriptionStatus: "none"
-};
-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);
-  const statusRef = (0, import_react2.useRef)({ setStatus, setLoading });
-  const userIdRef = (0, import_react2.useRef)(normalizeUserId(userId));
-  const refreshMountedRef = (0, import_react2.useRef)(true);
-  adapterRef.current = adapter;
-  statusRef.current = { setStatus, setLoading };
-  userIdRef.current = normalizeUserId(userId);
-  const refresh = (0, import_react2.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) {
-        console.error("[polar-billing] getStatus failed:", err);
-        setStatus2(FREE_STATUS);
-      }
-    } finally {
-      if (refreshMountedRef.current) setLoading2(false);
-    }
-  }, []);
-  (0, import_react2.useEffect)(() => {
-    refreshMountedRef.current = true;
-    refresh();
-    return () => {
-      refreshMountedRef.current = false;
-    };
-  }, [userId]);
-  const startCheckout = (0, import_react2.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)) {
-      console.warn("[polar-billing] WARNING: Using insecure http:// URL in production environment");
-    }
-    window.location.href = result.url;
-  }, []);
-  const syncSubscription = (0, import_react2.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 = (0, import_react2.useCallback)(async () => {
-    const uid = userIdRef.current;
-    if (!uid) return [];
-    return adapterRef.current.getBillingHistory(uid);
-  }, []);
-  const cancelSubscription = (0, import_react2.useCallback)(
-    async (reason) => {
-      const result = await adapterRef.current.cancelSubscription(reason);
-      if (result.success) await refresh();
-      return result;
-    },
-    [refresh]
-  );
-  const getPortalUrl = (0, import_react2.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 = (0, import_react2.useMemo)(
-    () => ({
-      status,
-      loading,
-      refresh,
-      startCheckout,
-      syncSubscription,
-      getBillingHistory,
-      cancelSubscription,
-      getPortalUrl
-    }),
-    [status, loading, refresh, syncSubscription]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PolarContext.Provider, { value, children });
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  FREE_PLAN,
-  PolarContext,
   PolarProvider,
   SUBSCRIPTION_STATUS,
-  asBoolean,
-  asString,
   createFirebaseAdapter,
-  isProductionInsecureUrl,
-  isTimestamp,
-  isValidCheckoutUrl,
-  isValidProductId,
-  normalizeBillingCycle,
-  normalizeStatus,
-  normalizeUserId,
-  usePolarBilling,
-  useSubscription
+  usePolarBilling
 });

package/dist/index.mjs

@@ -1,3 +1,137 @@
+// 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",
@@ -10,7 +144,6 @@ var SUBSCRIPTION_STATUS = Object.freeze({
   UNPAID: "unpaid",
   NONE: "none"
 });
-var FREE_PLAN = "free";
 
 // src/infrastructure/utils/normalization.util.ts
 var STATUS_MAP = Object.freeze({
@@ -46,7 +179,7 @@ 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
@@ -75,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;
   }
@@ -88,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();
@@ -122,179 +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 }
       );
       return result.url;
     }
   };
 }
-
-// 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 {
-  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 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) {
-        console.error("[polar-billing] getStatus failed:", err);
-        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)) {
-      console.warn("[polar-billing] WARNING: 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 });
-}
 export {
-  FREE_PLAN,
-  PolarContext,
   PolarProvider,
   SUBSCRIPTION_STATUS,
-  asBoolean,
-  asString,
   createFirebaseAdapter,
-  isProductionInsecureUrl,
-  isTimestamp,
-  isValidCheckoutUrl,
-  isValidProductId,
-  normalizeBillingCycle,
-  normalizeStatus,
-  normalizeUserId,
-  usePolarBilling,
-  useSubscription
+  usePolarBilling
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-polar-payment",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Universal Polar.sh subscription billing — Firebase adapter",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -41,6 +41,14 @@
   ],
   "author": "umituz",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/umituz/web-polar-payment"
+  },
+  "bugs": {
+    "url": "https://github.com/umituz/web-polar-payment/issues"
+  },
+  "homepage": "https://github.com/umituz/web-polar-payment#readme",
   "peerDependencies": {
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"

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,3 +1,9 @@
-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

@@ -19,5 +19,3 @@ export const SUBSCRIPTION_STATUS = Object.freeze({
   UNPAID: 'unpaid';
   NONE: 'none';
 }>;
-
-export const FREE_PLAN = 'free';

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

@@ -11,13 +11,13 @@ import type {
 import { normalizeStatus, normalizeBillingCycle } from '../utils/normalization.util';
 import { asString, asBoolean, isTimestamp } from '../utils/firebase-helpers.util';
 
-type FirebaseFunctions = any;
-type FirebaseFirestore = any;
+type FirestoreDoc = (firestore: unknown, collectionPath: string, docId: string) => unknown;
+type FirestoreGetDoc = (ref: unknown) => Promise<{ exists: boolean; data(): Record<string, unknown> }>;
+type HttpsCallableFn = <T = unknown, R = unknown>(data?: T) => Promise<{ data: R }>;
+type HttpsCallable = (name: string) => HttpsCallableFn;
 
 export interface FirebaseAdapterConfig {
-  /** Firebase Functions instance from firebase/functions */
   functions: unknown;
-  /** Firebase Firestore instance from firebase/firestore */
   firestore: unknown;
   callables?: {
     createCheckout?: string;
@@ -39,8 +39,8 @@ export interface FirebaseAdapterConfig {
 }
 
 export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapter {
-  const functions = config.functions as FirebaseFunctions;
-  const firestore = config.firestore as FirebaseFirestore;
+  const functions = config.functions;
+  const firestore = config.firestore;
 
   const callables = {
     createCheckout: config.callables?.createCheckout ?? 'createCheckoutSession',
@@ -61,28 +61,28 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
     currentPeriodEnd: config.db?.currentPeriodEndField ?? 'currentPeriodEnd',
   };
 
-  let httpsCallableCache: typeof import('firebase/functions')['httpsCallable'] | null = null;
-  let firestoreCache: { doc: any; getDoc: any } | null = null;
+  let httpsCallableCache: HttpsCallable | null = null;
+  let firestoreCache: { doc: FirestoreDoc; getDoc: FirestoreGetDoc } | null = null;
 
-  async function getHttpsCallable() {
+  async function getHttpsCallable(): Promise<HttpsCallable> {
     if (!httpsCallableCache) {
       const mod = await import('firebase/functions');
-      httpsCallableCache = mod.httpsCallable;
+      httpsCallableCache = mod.httpsCallable(functions) as HttpsCallable;
     }
     return httpsCallableCache;
   }
 
-  async function getFirestore() {
+  async function getFirestore(): Promise<{ doc: FirestoreDoc; getDoc: FirestoreGetDoc }> {
     if (!firestoreCache) {
       const mod = await import('firebase/firestore');
-      firestoreCache = { doc: mod.doc, getDoc: mod.getDoc };
+      firestoreCache = { doc: mod.doc as FirestoreDoc, getDoc: mod.getDoc as FirestoreGetDoc };
     }
     return firestoreCache;
   }
 
   async function callable<T = unknown, R = unknown>(name: string, data?: T): Promise<R> {
     const httpsCallable = await getHttpsCallable();
-    const fn = (httpsCallable as any)(functions, name) as (data?: T) => Promise<{ data: R }>;
+    const fn = httpsCallable(name) as (data?: T) => Promise<{ data: R }>;
     const result = await fn(data);
     return result.data;
   }
@@ -90,13 +90,15 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
   return {
     async getStatus(userId: string): Promise<SubscriptionStatus> {
       const { doc, getDoc } = await getFirestore();
-      const snap = await getDoc((doc as any)(firestore, db.collection, userId));
+      const docRef = doc(firestore, db.collection, userId);
+      const snap = await getDoc(docRef);
 
-      if (!snap.exists()) {
+      const exists = (snap as { exists: boolean }).exists;
+      if (!exists) {
         return { plan: 'free', subscriptionStatus: 'none' };
       }
 
-      const d = snap.data() as Record<string, unknown>;
+      const d = snap.data();
 
       let currentPeriodEnd: string | undefined;
       const rawEnd = d[db.currentPeriodEnd];
@@ -123,14 +125,14 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
       return callable<CheckoutParams, CheckoutResult>(callables.createCheckout, params);
     },
 
-    async syncSubscription(_userId: string, _checkoutId?: string): Promise<SyncResult> {
-      return callable<Record<string, never>, SyncResult>(callables.sync, {});
+    async syncSubscription(userId: string, checkoutId?: string): Promise<SyncResult> {
+      return callable<{ userId: string; checkoutId?: string }, SyncResult>(callables.sync, { userId, checkoutId });
     },
 
-    async getBillingHistory(_userId: string): Promise<OrderItem[]> {
-      const result = await callable<Record<string, never>, { orders?: OrderItem[] }>(
+    async getBillingHistory(userId: string): Promise<OrderItem[]> {
+      const result = await callable<{ userId: string }, { orders?: OrderItem[] }>(
         callables.billing,
-        {},
+        { userId },
       );
       return result.orders ?? [];
     },
@@ -139,10 +141,10 @@ export function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapt
       return callable<{ reason?: string }, CancelResult>(callables.cancel, { reason });
     },
 
-    async getPortalUrl(_userId: string): Promise<string> {
-      const result = await callable<Record<string, never>, { url: string }>(
+    async getPortalUrl(userId: string): Promise<string> {
+      const result = await callable<{ userId: string }, { url: string }>(
         callables.portal,
-        {},
+        { userId },
       );
       return result.url;
     },

package/src/infrastructure/utils/firebase-helpers.util.ts

@@ -13,6 +13,6 @@ export function isTimestamp(value: unknown): value is { toDate(): Date } {
     typeof value === 'object' &&
     value !== null &&
     'toDate' in value &&
-    typeof (value as { toDate: unknown }).toDate === 'function'
+    'function' === typeof (value as { toDate?: unknown }).toDate
   );
 }

package/src/presentation/components/PolarProvider.tsx

@@ -60,7 +60,6 @@ export function PolarProvider({ adapter, userId, children }: PolarProviderProps)
       if (refreshMountedRef.current) setStatus(s);
     } catch (err) {
       if (refreshMountedRef.current) {
-        console.error('[polar-billing] getStatus failed:', err);
         setStatus(FREE_STATUS);
       }
     } finally {
@@ -87,7 +86,7 @@ export function PolarProvider({ adapter, userId, children }: PolarProviderProps)
     }
 
     if (isProductionInsecureUrl(result.url)) {
-      console.warn('[polar-billing] WARNING: Using insecure http:// URL in production environment');
+      throw new Error('[polar-billing] ERROR: Using insecure http:// URL in production environment');
     }
 
     window.location.href = result.url;

package/src/presentation/hooks/usePolarBilling.ts

@@ -26,5 +26,3 @@ export function usePolarBilling(): PolarContextValue {
   if (!ctx) throw new Error('usePolarBilling must be used within <PolarProvider>');
   return ctx;
 }
-
-export const useSubscription = usePolarBilling;