@umituz/web-polar-payment 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,174 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * Subscription Entity
+ * @description Types for subscription status and billing cycles
+ */
+type SubscriptionStatusValue = 'active' | 'canceled' | 'revoked' | 'trialing' | 'past_due' | 'incomplete' | 'incomplete_expired' | 'unpaid' | 'none';
+type BillingCycle = 'monthly' | 'yearly';
+interface SubscriptionStatus {
+    plan: string;
+    subscriptionId?: string;
+    subscriptionStatus: SubscriptionStatusValue;
+    cancelAtPeriodEnd?: boolean;
+    currentPeriodEnd?: string;
+    billingCycle?: BillingCycle;
+    polarCustomerId?: string;
+    /** Token balance (for token-based projects like Aria) */
+    tokens?: number;
+}
+
+/**
+ * Order Entity
+ * @description Types for billing history items
+ */
+interface OrderItem {
+    id: string;
+    createdAt: string;
+    amount: number;
+    currency: string;
+    status: string;
+    paid: boolean;
+    productName: string;
+    invoiceUrl?: string;
+}
+
+/**
+ * Checkout Entity
+ * @description Types for initiating and following process of checkouts
+ */
+interface CheckoutParams {
+    productId: string;
+    planKey?: string;
+    billingCycle?: 'monthly' | 'yearly';
+    successUrl?: string;
+    /** Injected automatically by PolarProvider — do not pass manually */
+    userId?: string;
+}
+interface CheckoutResult {
+    url: string;
+    id: string;
+}
+
+/**
+ * Cancellation Entity
+ * @description Types for subscription cancellation reasons and outcomes
+ */
+type CancellationReason = 'too_expensive' | 'missing_features' | 'switched_service' | 'unused' | 'customer_service' | 'low_quality' | 'too_complex' | 'other';
+interface CancelResult {
+    success: boolean;
+    endsAt?: string;
+}
+
+/**
+ * Sync Entity
+ * @description Type for subscription synchronization results
+ */
+interface SyncResult {
+    synced: boolean;
+    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>;
+}
+
+type FirebaseFunctions = any;
+type FirebaseFirestore = any;
+interface FirebaseAdapterConfig {
+    functions: FirebaseFunctions;
+    firestore: FirebaseFirestore;
+    callables?: {
+        createCheckout?: string;
+        syncSubscription?: string;
+        getBillingHistory?: string;
+        cancelSubscription?: string;
+        getPortalUrl?: string;
+    };
+    db?: {
+        usersCollection?: string;
+        planField?: string;
+        billingCycleField?: string;
+        subscriptionIdField?: string;
+        subscriptionStatusField?: string;
+        polarCustomerIdField?: string;
+        cancelAtPeriodEndField?: string;
+        currentPeriodEndField?: string;
+    };
+}
+/**
+ * Firebase Billing Service
+ * @description Implementation of PolarAdapter for Firebase Functions and Firestore.
+ */
+declare function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapter;
+
+/**
+ * Billing Constants
+ * @description Standardized subscription states and plan names
+ */
+declare const SUBSCRIPTION_STATUS: {
+    ACTIVE: "active";
+    CANCELED: "canceled";
+    REVOKED: "revoked";
+    TRIALING: "trialing";
+    PAST_DUE: "past_due";
+    INCOMPLETE: "incomplete";
+    INCOMPLETE_EXPIRED: "incomplete_expired";
+    UNPAID: "unpaid";
+    NONE: "none";
+};
+declare const FREE_PLAN = "free";
+
+/**
+ * Normalize a raw Polar status string to a known value.
+ * @description Defaults to 'none' for unknown statuses.
+ */
+declare function normalizeStatus(raw: string): SubscriptionStatusValue;
+/**
+ * Normalize billing interval
+ * @description Maps 'month'/'year' to 'monthly'/'yearly'
+ */
+declare function normalizeBillingCycle(interval: string): BillingCycle;
+
+/**
+ * PolarProvider Component
+ * @description Context provider for Polar billing management.
+ */
+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>;
+/**
+ * usePolarBilling Hook
+ * @description Hook to access Polar billing context
+ */
+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, createFirebaseAdapter, normalizeBillingCycle, normalizeStatus, usePolarBilling, useSubscription };

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * Subscription Entity
+ * @description Types for subscription status and billing cycles
+ */
+type SubscriptionStatusValue = 'active' | 'canceled' | 'revoked' | 'trialing' | 'past_due' | 'incomplete' | 'incomplete_expired' | 'unpaid' | 'none';
+type BillingCycle = 'monthly' | 'yearly';
+interface SubscriptionStatus {
+    plan: string;
+    subscriptionId?: string;
+    subscriptionStatus: SubscriptionStatusValue;
+    cancelAtPeriodEnd?: boolean;
+    currentPeriodEnd?: string;
+    billingCycle?: BillingCycle;
+    polarCustomerId?: string;
+    /** Token balance (for token-based projects like Aria) */
+    tokens?: number;
+}
+
+/**
+ * Order Entity
+ * @description Types for billing history items
+ */
+interface OrderItem {
+    id: string;
+    createdAt: string;
+    amount: number;
+    currency: string;
+    status: string;
+    paid: boolean;
+    productName: string;
+    invoiceUrl?: string;
+}
+
+/**
+ * Checkout Entity
+ * @description Types for initiating and following process of checkouts
+ */
+interface CheckoutParams {
+    productId: string;
+    planKey?: string;
+    billingCycle?: 'monthly' | 'yearly';
+    successUrl?: string;
+    /** Injected automatically by PolarProvider — do not pass manually */
+    userId?: string;
+}
+interface CheckoutResult {
+    url: string;
+    id: string;
+}
+
+/**
+ * Cancellation Entity
+ * @description Types for subscription cancellation reasons and outcomes
+ */
+type CancellationReason = 'too_expensive' | 'missing_features' | 'switched_service' | 'unused' | 'customer_service' | 'low_quality' | 'too_complex' | 'other';
+interface CancelResult {
+    success: boolean;
+    endsAt?: string;
+}
+
+/**
+ * Sync Entity
+ * @description Type for subscription synchronization results
+ */
+interface SyncResult {
+    synced: boolean;
+    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>;
+}
+
+type FirebaseFunctions = any;
+type FirebaseFirestore = any;
+interface FirebaseAdapterConfig {
+    functions: FirebaseFunctions;
+    firestore: FirebaseFirestore;
+    callables?: {
+        createCheckout?: string;
+        syncSubscription?: string;
+        getBillingHistory?: string;
+        cancelSubscription?: string;
+        getPortalUrl?: string;
+    };
+    db?: {
+        usersCollection?: string;
+        planField?: string;
+        billingCycleField?: string;
+        subscriptionIdField?: string;
+        subscriptionStatusField?: string;
+        polarCustomerIdField?: string;
+        cancelAtPeriodEndField?: string;
+        currentPeriodEndField?: string;
+    };
+}
+/**
+ * Firebase Billing Service
+ * @description Implementation of PolarAdapter for Firebase Functions and Firestore.
+ */
+declare function createFirebaseAdapter(config: FirebaseAdapterConfig): PolarAdapter;
+
+/**
+ * Billing Constants
+ * @description Standardized subscription states and plan names
+ */
+declare const SUBSCRIPTION_STATUS: {
+    ACTIVE: "active";
+    CANCELED: "canceled";
+    REVOKED: "revoked";
+    TRIALING: "trialing";
+    PAST_DUE: "past_due";
+    INCOMPLETE: "incomplete";
+    INCOMPLETE_EXPIRED: "incomplete_expired";
+    UNPAID: "unpaid";
+    NONE: "none";
+};
+declare const FREE_PLAN = "free";
+
+/**
+ * Normalize a raw Polar status string to a known value.
+ * @description Defaults to 'none' for unknown statuses.
+ */
+declare function normalizeStatus(raw: string): SubscriptionStatusValue;
+/**
+ * Normalize billing interval
+ * @description Maps 'month'/'year' to 'monthly'/'yearly'
+ */
+declare function normalizeBillingCycle(interval: string): BillingCycle;
+
+/**
+ * PolarProvider Component
+ * @description Context provider for Polar billing management.
+ */
+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>;
+/**
+ * usePolarBilling Hook
+ * @description Hook to access Polar billing context
+ */
+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, createFirebaseAdapter, normalizeBillingCycle, normalizeStatus, usePolarBilling, useSubscription };

package/dist/index.js

@@ -0,0 +1,274 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FREE_PLAN: () => FREE_PLAN,
+  PolarContext: () => PolarContext,
+  PolarProvider: () => PolarProvider,
+  SUBSCRIPTION_STATUS: () => SUBSCRIPTION_STATUS,
+  createFirebaseAdapter: () => createFirebaseAdapter,
+  normalizeBillingCycle: () => normalizeBillingCycle,
+  normalizeStatus: () => normalizeStatus,
+  usePolarBilling: () => usePolarBilling,
+  useSubscription: () => useSubscription
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/infrastructure/utils/normalization.util.ts
+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"
+  };
+  return map[raw?.toLowerCase()] ?? "none";
+}
+function normalizeBillingCycle(interval) {
+  if (interval === "month" || interval === "monthly") return "monthly";
+  if (interval === "year" || interval === "yearly") return "yearly";
+  return "monthly";
+}
+
+// src/infrastructure/services/firebase-billing.service.ts
+function createFirebaseAdapter(config) {
+  const callables = {
+    createCheckout: config.callables?.createCheckout ?? "createCheckoutSession",
+    sync: config.callables?.syncSubscription ?? "syncSubscription",
+    billing: config.callables?.getBillingHistory ?? "getBillingHistory",
+    cancel: config.callables?.cancelSubscription ?? "cancelSubscription",
+    portal: config.callables?.getPortalUrl ?? "getCustomerPortalUrl"
+  };
+  const db = {
+    collection: config.db?.usersCollection ?? "users",
+    plan: config.db?.planField ?? "plan",
+    billingCycle: config.db?.billingCycleField ?? "billingCycle",
+    subscriptionId: config.db?.subscriptionIdField ?? "subscriptionId",
+    subscriptionStatus: config.db?.subscriptionStatusField ?? "subscriptionStatus",
+    polarCustomerId: config.db?.polarCustomerIdField ?? "polarCustomerId",
+    cancelAtPeriodEnd: config.db?.cancelAtPeriodEndField ?? "cancelAtPeriodEnd",
+    currentPeriodEnd: config.db?.currentPeriodEndField ?? "currentPeriodEnd"
+  };
+  async function callable(name, data) {
+    const { httpsCallable } = await import("firebase/functions");
+    const fn = httpsCallable(config.functions, name);
+    const result = await fn(data);
+    return result.data;
+  }
+  return {
+    async getStatus(userId) {
+      const { doc, getDoc } = await import("firebase/firestore");
+      const snap = await getDoc(doc(config.firestore, db.collection, userId));
+      if (!snap.exists()) {
+        return { plan: "free", subscriptionStatus: "none" };
+      }
+      const d = snap.data();
+      let currentPeriodEnd;
+      const rawEnd = d[db.currentPeriodEnd];
+      if (rawEnd != null) {
+        if (typeof rawEnd === "object" && "toDate" in rawEnd) {
+          currentPeriodEnd = rawEnd.toDate().toISOString();
+        } else if (typeof rawEnd === "string") {
+          currentPeriodEnd = rawEnd;
+        }
+      }
+      return {
+        plan: d[db.plan] ?? "free",
+        billingCycle: normalizeBillingCycle(d[db.billingCycle] ?? "monthly"),
+        subscriptionId: d[db.subscriptionId],
+        subscriptionStatus: normalizeStatus(d[db.subscriptionStatus] ?? "none"),
+        polarCustomerId: d[db.polarCustomerId],
+        cancelAtPeriodEnd: d[db.cancelAtPeriodEnd],
+        currentPeriodEnd
+      };
+    },
+    async createCheckout(params) {
+      return callable(callables.createCheckout, params);
+    },
+    async syncSubscription(_userId, _checkoutId) {
+      return callable(callables.sync, {});
+    },
+    async getBillingHistory(_userId) {
+      const result = await callable(
+        callables.billing,
+        {}
+      );
+      return result.orders ?? [];
+    },
+    async cancelSubscription(reason) {
+      return callable(callables.cancel, { reason });
+    },
+    async getPortalUrl(_userId) {
+      const result = await callable(
+        callables.portal,
+        {}
+      );
+      const url = result.url ?? result.customerPortalUrl;
+      if (!url) throw new Error("No portal URL returned from Cloud Function");
+      return url;
+    }
+  };
+}
+
+// src/infrastructure/constants/billing.constants.ts
+var SUBSCRIPTION_STATUS = {
+  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
+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);
+  adapterRef.current = adapter;
+  const refreshAbortRef = (0, import_react2.useRef)(null);
+  const refresh = (0, import_react2.useCallback)(async () => {
+    const uid = userId?.trim();
+    if (!uid) {
+      setStatus(FREE_STATUS);
+      setLoading(false);
+      return;
+    }
+    refreshAbortRef.current?.abort();
+    const ctrl = new AbortController();
+    refreshAbortRef.current = ctrl;
+    try {
+      setLoading(true);
+      const s = await adapterRef.current.getStatus(uid);
+      if (!ctrl.signal.aborted) setStatus(s);
+    } catch (err) {
+      if (!ctrl.signal.aborted) {
+        console.error("[polar-billing] getStatus failed:", err);
+        setStatus(FREE_STATUS);
+      }
+    } finally {
+      if (!ctrl.signal.aborted) setLoading(false);
+    }
+  }, [userId]);
+  (0, import_react2.useEffect)(() => {
+    refresh();
+    return () => {
+      refreshAbortRef.current?.abort();
+    };
+  }, [refresh]);
+  const startCheckout = (0, import_react2.useCallback)(async (params) => {
+    const result = await adapterRef.current.createCheckout({ ...params, userId: userId?.trim() });
+    if (!result.url.startsWith("https://")) {
+      throw new Error("Invalid checkout URL returned");
+    }
+    window.location.href = result.url;
+  }, [userId]);
+  const syncSubscription = (0, import_react2.useCallback)(async () => {
+    const uid = userId?.trim();
+    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]);
+  const getBillingHistory = (0, import_react2.useCallback)(async () => {
+    const uid = userId?.trim();
+    if (!uid) return [];
+    return adapterRef.current.getBillingHistory(uid);
+  }, [userId]);
+  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 = userId?.trim();
+    if (!uid) throw new Error("No authenticated user");
+    return adapterRef.current.getPortalUrl(uid);
+  }, [userId]);
+  const value = (0, import_react2.useMemo)(
+    () => ({
+      status,
+      loading,
+      refresh,
+      startCheckout,
+      syncSubscription,
+      getBillingHistory,
+      cancelSubscription,
+      getPortalUrl
+    }),
+    [status, loading, refresh, startCheckout, syncSubscription, getBillingHistory, cancelSubscription, getPortalUrl]
+  );
+  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,
+  createFirebaseAdapter,
+  normalizeBillingCycle,
+  normalizeStatus,
+  usePolarBilling,
+  useSubscription
+});

package/dist/index.mjs

@@ -0,0 +1,235 @@
+// src/infrastructure/utils/normalization.util.ts
+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"
+  };
+  return map[raw?.toLowerCase()] ?? "none";
+}
+function normalizeBillingCycle(interval) {
+  if (interval === "month" || interval === "monthly") return "monthly";
+  if (interval === "year" || interval === "yearly") return "yearly";
+  return "monthly";
+}
+
+// src/infrastructure/services/firebase-billing.service.ts
+function createFirebaseAdapter(config) {
+  const callables = {
+    createCheckout: config.callables?.createCheckout ?? "createCheckoutSession",
+    sync: config.callables?.syncSubscription ?? "syncSubscription",
+    billing: config.callables?.getBillingHistory ?? "getBillingHistory",
+    cancel: config.callables?.cancelSubscription ?? "cancelSubscription",
+    portal: config.callables?.getPortalUrl ?? "getCustomerPortalUrl"
+  };
+  const db = {
+    collection: config.db?.usersCollection ?? "users",
+    plan: config.db?.planField ?? "plan",
+    billingCycle: config.db?.billingCycleField ?? "billingCycle",
+    subscriptionId: config.db?.subscriptionIdField ?? "subscriptionId",
+    subscriptionStatus: config.db?.subscriptionStatusField ?? "subscriptionStatus",
+    polarCustomerId: config.db?.polarCustomerIdField ?? "polarCustomerId",
+    cancelAtPeriodEnd: config.db?.cancelAtPeriodEndField ?? "cancelAtPeriodEnd",
+    currentPeriodEnd: config.db?.currentPeriodEndField ?? "currentPeriodEnd"
+  };
+  async function callable(name, data) {
+    const { httpsCallable } = await import("firebase/functions");
+    const fn = httpsCallable(config.functions, name);
+    const result = await fn(data);
+    return result.data;
+  }
+  return {
+    async getStatus(userId) {
+      const { doc, getDoc } = await import("firebase/firestore");
+      const snap = await getDoc(doc(config.firestore, db.collection, userId));
+      if (!snap.exists()) {
+        return { plan: "free", subscriptionStatus: "none" };
+      }
+      const d = snap.data();
+      let currentPeriodEnd;
+      const rawEnd = d[db.currentPeriodEnd];
+      if (rawEnd != null) {
+        if (typeof rawEnd === "object" && "toDate" in rawEnd) {
+          currentPeriodEnd = rawEnd.toDate().toISOString();
+        } else if (typeof rawEnd === "string") {
+          currentPeriodEnd = rawEnd;
+        }
+      }
+      return {
+        plan: d[db.plan] ?? "free",
+        billingCycle: normalizeBillingCycle(d[db.billingCycle] ?? "monthly"),
+        subscriptionId: d[db.subscriptionId],
+        subscriptionStatus: normalizeStatus(d[db.subscriptionStatus] ?? "none"),
+        polarCustomerId: d[db.polarCustomerId],
+        cancelAtPeriodEnd: d[db.cancelAtPeriodEnd],
+        currentPeriodEnd
+      };
+    },
+    async createCheckout(params) {
+      return callable(callables.createCheckout, params);
+    },
+    async syncSubscription(_userId, _checkoutId) {
+      return callable(callables.sync, {});
+    },
+    async getBillingHistory(_userId) {
+      const result = await callable(
+        callables.billing,
+        {}
+      );
+      return result.orders ?? [];
+    },
+    async cancelSubscription(reason) {
+      return callable(callables.cancel, { reason });
+    },
+    async getPortalUrl(_userId) {
+      const result = await callable(
+        callables.portal,
+        {}
+      );
+      const url = result.url ?? result.customerPortalUrl;
+      if (!url) throw new Error("No portal URL returned from Cloud Function");
+      return url;
+    }
+  };
+}
+
+// src/infrastructure/constants/billing.constants.ts
+var SUBSCRIPTION_STATUS = {
+  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 PolarProvider({ adapter, userId, children }) {
+  const [status, setStatus] = useState(FREE_STATUS);
+  const [loading, setLoading] = useState(true);
+  const adapterRef = useRef(adapter);
+  adapterRef.current = adapter;
+  const refreshAbortRef = useRef(null);
+  const refresh = useCallback(async () => {
+    const uid = userId?.trim();
+    if (!uid) {
+      setStatus(FREE_STATUS);
+      setLoading(false);
+      return;
+    }
+    refreshAbortRef.current?.abort();
+    const ctrl = new AbortController();
+    refreshAbortRef.current = ctrl;
+    try {
+      setLoading(true);
+      const s = await adapterRef.current.getStatus(uid);
+      if (!ctrl.signal.aborted) setStatus(s);
+    } catch (err) {
+      if (!ctrl.signal.aborted) {
+        console.error("[polar-billing] getStatus failed:", err);
+        setStatus(FREE_STATUS);
+      }
+    } finally {
+      if (!ctrl.signal.aborted) setLoading(false);
+    }
+  }, [userId]);
+  useEffect(() => {
+    refresh();
+    return () => {
+      refreshAbortRef.current?.abort();
+    };
+  }, [refresh]);
+  const startCheckout = useCallback(async (params) => {
+    const result = await adapterRef.current.createCheckout({ ...params, userId: userId?.trim() });
+    if (!result.url.startsWith("https://")) {
+      throw new Error("Invalid checkout URL returned");
+    }
+    window.location.href = result.url;
+  }, [userId]);
+  const syncSubscription = useCallback(async () => {
+    const uid = userId?.trim();
+    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]);
+  const getBillingHistory = useCallback(async () => {
+    const uid = userId?.trim();
+    if (!uid) return [];
+    return adapterRef.current.getBillingHistory(uid);
+  }, [userId]);
+  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 = userId?.trim();
+    if (!uid) throw new Error("No authenticated user");
+    return adapterRef.current.getPortalUrl(uid);
+  }, [userId]);
+  const value = useMemo(
+    () => ({
+      status,
+      loading,
+      refresh,
+      startCheckout,
+      syncSubscription,
+      getBillingHistory,
+      cancelSubscription,
+      getPortalUrl
+    }),
+    [status, loading, refresh, startCheckout, syncSubscription, getBillingHistory, cancelSubscription, getPortalUrl]
+  );
+  return /* @__PURE__ */ jsx(PolarContext.Provider, { value, children });
+}
+export {
+  FREE_PLAN,
+  PolarContext,
+  PolarProvider,
+  SUBSCRIPTION_STATUS,
+  createFirebaseAdapter,
+  normalizeBillingCycle,
+  normalizeStatus,
+  usePolarBilling,
+  useSubscription
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@umituz/web-polar-payment",
+  "version": "1.0.0",
+  "description": "Universal Polar.sh subscription billing — Supabase & Firebase adapters",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./domain": "./src/domain/index.ts",
+    "./infrastructure": "./src/infrastructure/index.ts",
+    "./presentation": "./src/presentation/index.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external firebase --external firebase/functions --external firebase/firestore",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --external firebase --external firebase/functions --external firebase/firestore",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "polar",
+    "subscription",
+    "billing",
+    "firebase",
+    "react"
+  ],
+  "author": "Antigravity",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "firebase": "^10.14.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}