@umituz/web-dashboard 2.2.0 → 2.3.0

package/src/domains/billing/components/PlanComparison.tsx

@@ -0,0 +1,199 @@
+/**
+ * Plan Comparison Component
+ *
+ * Configurable plan selection and comparison
+ */
+
+import { Check, Loader2 } from "lucide-react";
+import { cn } from "@umituz/web-design-system/utils";
+import { Button } from "@umituz/web-design-system/atoms";
+import type { PlanComparisonProps } from "../types/billing";
+import { formatPrice, getPlanPrice, calculateDiscount, isPopularPlan, formatFeature } from "../utils/billing";
+
+export const PlanComparison = ({
+  plans,
+  selectedPlan,
+  cycle = "monthly",
+  showCycleToggle = true,
+  showFeatures = true,
+  onPlanSelect,
+  onCycleChange,
+  loading = false,
+}: PlanComparisonProps) => {
+  const handleCycleChange = (newCycle: "monthly" | "yearly") => {
+    onCycleChange?.(newCycle);
+  };
+
+  const handleSelectPlan = (planId: string) => {
+    if (!loading) {
+      onPlanSelect?.(planId);
+    }
+  };
+
+  return (
+    <div className="w-full space-y-8">
+      {/* Billing Cycle Toggle */}
+      {showCycleToggle && (
+        <div className="flex items-center justify-center">
+          <div className="inline-flex items-center bg-muted rounded-full p-1">
+            <button
+              onClick={() => handleCycleChange("monthly")}
+              className={cn(
+                "px-6 py-2 rounded-full text-sm font-medium transition-all",
+                cycle === "monthly"
+                  ? "bg-background text-foreground shadow-sm"
+                  : "text-muted-foreground hover:text-foreground"
+              )}
+            >
+              Monthly
+            </button>
+            <button
+              onClick={() => handleCycleChange("yearly")}
+              className={cn(
+                "px-6 py-2 rounded-full text-sm font-medium transition-all relative",
+                cycle === "yearly"
+                  ? "bg-background text-foreground shadow-sm"
+                  : "text-muted-foreground hover:text-foreground"
+              )}
+            >
+              Yearly
+              <span className="ml-1 text-xs bg-primary text-primary-foreground px-2 py-0.5 rounded-full">
+                Save 17%
+              </span>
+            </button>
+          </div>
+        </div>
+      )}
+
+      {/* Plans Grid */}
+      <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
+        {plans.map((plan) => {
+          const isSelected = selectedPlan === plan.id;
+          const price = getPlanPrice(plan, cycle);
+          const isPopular = isPopularPlan(plan, plans);
+          const discount = calculateDiscount(plan.monthlyPrice, plan.yearlyPrice);
+
+          return (
+            <div
+              key={plan.id}
+              className={cn(
+                "relative bg-background border-2 rounded-2xl p-6 transition-all",
+                isSelected
+                  ? "border-primary shadow-lg shadow-primary/20"
+                  : "border-border hover:border-primary/50",
+                isPopular && "border-primary shadow-lg shadow-primary/20"
+              )}
+            >
+              {/* Popular Badge */}
+              {isPopular && (
+                <div className="absolute -top-3 left-1/2 -translate-x-1/2">
+                  <span className="bg-primary text-primary-foreground text-xs font-bold px-4 py-1 rounded-full">
+                    Most Popular
+                  </span>
+                </div>
+              )}
+
+              {/* Plan Badge */}
+              {plan.badge && (
+                <div className="mb-4">
+                  <span
+                    className={cn(
+                      "text-xs font-bold uppercase tracking-wider px-3 py-1 rounded-full",
+                      plan.badgeColor || "bg-primary/10 text-primary"
+                    )}
+                  >
+                    {plan.badge}
+                  </span>
+                </div>
+              )}
+
+              {/* Plan Name */}
+              <h3 className="text-2xl font-bold text-foreground mb-2">
+                {plan.name}
+              </h3>
+
+              {/* Description */}
+              <p className="text-muted-foreground text-sm mb-6">
+                {plan.description}
+              </p>
+
+              {/* Price */}
+              <div className="mb-6">
+                <div className="flex items-baseline gap-1">
+                  <span className="text-4xl font-extrabold text-foreground">
+                    {formatPrice(price, plan.currency)}
+                  </span>
+                  <span className="text-muted-foreground">
+                    /{cycle === "monthly" ? "mo" : "yr"}
+                  </span>
+                </div>
+
+                {cycle === "yearly" && (
+                  <p className="text-sm text-green-600 dark:text-green-500 mt-1">
+                    Save {discount}% with yearly billing
+                  </p>
+                )}
+              </div>
+
+              {/* Features */}
+              {showFeatures && plan.features.length > 0 && (
+                <ul className="space-y-3 mb-6 flex-1">
+                  {plan.features.map((feature, index) => {
+                    const { text, bold, included } = formatFeature(feature);
+
+                    return (
+                      <li
+                        key={index}
+                        className={cn(
+                          "flex items-start gap-3 text-sm",
+                          included === false && "opacity-50 line-through"
+                        )}
+                      >
+                        <Check
+                          className={cn(
+                            "h-5 w-5 shrink-0 mt-0.5",
+                            included === false
+                              ? "text-muted-foreground"
+                              : "text-primary"
+                          )}
+                        />
+                        <span className={cn(bold && "font-semibold", "text-foreground")}>
+                          {text}
+                        </span>
+                      </li>
+                    );
+                  })}
+                </ul>
+              )}
+
+              {/* Select Button */}
+              <Button
+                onClick={() => handleSelectPlan(plan.id)}
+                disabled={loading}
+                className={cn(
+                  "w-full rounded-full py-6",
+                  isSelected || isPopular
+                    ? "bg-primary text-primary-foreground hover:bg-primary/90"
+                    : "bg-muted text-foreground hover:bg-muted/80"
+                )}
+              >
+                {loading ? (
+                  <>
+                    <Loader2 className="h-4 w-4 mr-2 animate-spin" />
+                    Processing...
+                  </>
+                ) : isSelected ? (
+                  "Current Plan"
+                ) : (
+                  "Select Plan"
+                )}
+              </Button>
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+};
+
+export default PlanComparison;

package/src/domains/billing/components/UsageCard.tsx

@@ -0,0 +1,103 @@
+/**
+ * Usage Card Component
+ *
+ * Display usage metrics with progress bar
+ */
+
+import { AlertTriangle, TrendingUp } from "lucide-react";
+import { cn } from "@umituz/web-design-system/utils";
+import type { UsageCardProps } from "../types/billing";
+import { calculateUsagePercentage, isNearLimit, formatNumber } from "../utils/billing";
+
+export const UsageCard = ({
+  metric,
+  showProgress = true,
+  showLimit = true,
+}: UsageCardProps) => {
+  const percentage = calculateUsagePercentage(metric);
+  const nearLimit = isNearLimit(metric);
+  const isOverLimit = metric.current > metric.limit;
+
+  return (
+    <div className="p-6 rounded-xl border border-border bg-background">
+      {/* Header */}
+      <div className="flex items-start justify-between mb-4">
+        <div>
+          <p className="text-sm text-muted-foreground mb-1">{metric.name}</p>
+          <p className="text-3xl font-bold text-foreground">
+            {formatNumber(metric.current)}
+            <span className="text-base font-normal text-muted-foreground ml-1">
+              {metric.unit}
+            </span>
+          </p>
+        </div>
+
+        {/* Warning Icon */}
+        {(nearLimit || isOverLimit) && (
+          <div
+            className={cn(
+              "w-10 h-10 rounded-lg flex items-center justify-center",
+              isOverLimit
+                ? "bg-destructive/10 text-destructive"
+                : "bg-orange-500/10 text-orange-600 dark:text-orange-500"
+            )}
+          >
+            {isOverLimit ? (
+              <AlertTriangle className="h-5 w-5" />
+            ) : (
+              <TrendingUp className="h-5 w-5" />
+            )}
+          </div>
+        )}
+      </div>
+
+      {/* Progress Bar */}
+      {showProgress && (
+        <div className="space-y-2">
+          <div className="flex items-center justify-between text-xs">
+            {showLimit && (
+              <span className="text-muted-foreground">
+                {formatNumber(metric.limit)} {metric.unit} limit
+              </span>
+            )}
+            <span
+              className={cn(
+                "font-medium",
+                isOverLimit
+                  ? "text-destructive"
+                  : nearLimit
+                  ? "text-orange-600 dark:text-orange-500"
+                  : "text-foreground"
+              )}
+            >
+              {percentage.toFixed(0)}%
+            </span>
+          </div>
+
+          <div className="w-full h-2 bg-muted rounded-full overflow-hidden">
+            <div
+              className={cn(
+                "h-full transition-all duration-500",
+                isOverLimit
+                  ? "bg-destructive"
+                  : nearLimit
+                  ? "bg-orange-500"
+                  : "bg-primary"
+              )}
+              style={{ width: `${Math.min(percentage, 100)}%` }}
+            />
+          </div>
+
+          {/* Reset Info */}
+          {metric.resetAt && (
+            <p className="text-xs text-muted-foreground mt-2">
+              Resets {new Date(metric.resetAt).toLocaleDateString()}
+            </p>
+          )}
+        </div>
+      )}
+    </div>
+  );
+};
+
+export default UsageCard;

package/src/domains/billing/components/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Billing Components
+ *
+ * Export all billing components
+ */
+
+export { PlanComparison } from "./PlanComparison";
+export { PaymentMethodsList } from "./PaymentMethodsList";
+export { InvoiceCard } from "./InvoiceCard";
+export { UsageCard } from "./UsageCard";
+export { BillingPortal } from "./BillingPortal";
+export { BillingLayout } from "./BillingLayout";

package/src/domains/billing/hooks/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Billing Hooks
+ *
+ * Export all billing hooks
+ */
+
+export { useBilling } from "./useBilling";

package/src/domains/billing/hooks/useBilling.ts

@@ -0,0 +1,385 @@
+/**
+ * useBilling Hook
+ *
+ * Core billing hook for managing subscription and payments
+ */
+
+import { useState, useCallback, useEffect } from "react";
+import type {
+  BillingSummary,
+  BillingCycle,
+  PlanTier,
+  PaymentMethod,
+  Invoice,
+  UsageMetric,
+} from "../types/billing";
+import { formatPrice } from "../utils/billing";
+
+interface UseBillingOptions {
+  /** Billing API base URL */
+  apiUrl?: string;
+  /** Initial billing data */
+  initialData?: BillingSummary;
+}
+
+interface BillingActions {
+  /** Load billing summary */
+  loadBilling: () => Promise<void>;
+  /** Update subscription plan */
+  updatePlan: (planId: string) => Promise<void>;
+  /** Cancel subscription */
+  cancelSubscription: () => Promise<void>;
+  /** Update billing cycle */
+  updateCycle: (cycle: BillingCycle) => Promise<void>;
+  /** Add payment method */
+  addPaymentMethod: (paymentMethodDetails: any) => Promise<PaymentMethod>;
+  /** Remove payment method */
+  removePaymentMethod: (methodId: string) => Promise<void>;
+  /** Set default payment method */
+  setDefaultPaymentMethod: (methodId: string) => Promise<void>;
+  /** Get invoice URL */
+  getInvoiceUrl: (invoiceId: string) => Promise<string>;
+}
+
+/**
+ * useBilling hook
+ *
+ * Manages billing state and actions
+ *
+ * @param options - Hook options
+ * @returns Billing state and actions
+ */
+export function useBilling(options: UseBillingOptions = {}) {
+  const { apiUrl = "/api/billing", initialData } = options;
+
+  // State
+  const [billing, setBilling] = useState<BillingSummary | null>(initialData || null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  // Load billing summary
+  const loadBilling = useCallback(async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // const response = await fetch(apiUrl);
+      // const data = await response.json();
+
+      // Mock data for demo
+      const mockBilling: BillingSummary = {
+        subscription: {
+          id: "sub_123",
+          planId: "pro",
+          plan: {
+            id: "pro",
+            type: "pro",
+            name: "Pro Plan",
+            description: "For growing teams",
+            monthlyPrice: 49,
+            yearlyPrice: 490,
+            currency: "USD",
+            features: [
+              "Up to 10 users",
+              "100GB storage",
+              "100K API calls/month",
+              "Priority support",
+            ],
+          },
+          status: "active",
+          cycle: "monthly",
+          currentPeriodStart: new Date().toISOString(),
+          currentPeriodEnd: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
+          seats: 5,
+        },
+        paymentMethods: [
+          {
+            id: "pm_123",
+            type: "card",
+            isDefault: true,
+            card: {
+              last4: "4242",
+              brand: "Visa",
+              expiryMonth: 12,
+              expiryYear: 2025,
+              name: "John Doe",
+            },
+            createdAt: new Date().toISOString(),
+          },
+        ],
+        defaultPaymentMethod: {
+          id: "pm_123",
+          type: "card",
+          isDefault: true,
+          card: {
+            last4: "4242",
+            brand: "Visa",
+            expiryMonth: 12,
+            expiryYear: 2025,
+            name: "John Doe",
+          },
+          createdAt: new Date().toISOString(),
+        },
+        upcomingInvoice: {
+          amount: 49,
+          currency: "USD",
+          date: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
+        },
+        usage: [
+          {
+            id: "storage",
+            name: "Storage",
+            current: 67.5,
+            limit: 100,
+            unit: "GB",
+            resetPeriod: "monthly",
+            resetAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
+          },
+          {
+            id: "api",
+            name: "API Calls",
+            current: 75000,
+            limit: 100000,
+            unit: "calls",
+            resetPeriod: "monthly",
+            resetAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
+          },
+        ],
+        recentInvoices: [],
+      };
+
+      setBilling(mockBilling);
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to load billing";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Update subscription plan
+  const updatePlan = useCallback(async (planId: string) => {
+    if (!billing) return;
+
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // await fetch(`${apiUrl}/subscription`, {
+      //   method: 'PATCH',
+      //   body: JSON.stringify({ planId }),
+      // });
+
+      // Mock update
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          subscription: {
+            ...prev.subscription,
+            planId,
+          },
+        };
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to update plan";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl, billing]);
+
+  // Cancel subscription
+  const cancelSubscription = useCallback(async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // await fetch(`${apiUrl}/subscription/cancel`, { method: 'POST' });
+
+      // Mock cancel
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          subscription: {
+            ...prev.subscription,
+            status: "canceled",
+            cancelAtPeriodEnd: true,
+          },
+        };
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to cancel subscription";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Update billing cycle
+  const updateCycle = useCallback(async (cycle: BillingCycle) => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // await fetch(`${apiUrl}/subscription/cycle`, {
+      //   method: 'PATCH',
+      //   body: JSON.stringify({ cycle }),
+      // });
+
+      // Mock update
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          subscription: {
+            ...prev.subscription,
+            cycle,
+          },
+        };
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to update cycle";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Add payment method
+  const addPaymentMethod = useCallback(async (paymentMethodDetails: any) => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // const response = await fetch(`${apiUrl}/payment-methods`, {
+      //   method: 'POST',
+      //   body: JSON.stringify(paymentMethodDetails),
+      // });
+      // const newMethod = await response.json();
+
+      // Mock add
+      const newMethod: PaymentMethod = {
+        id: `pm_${Date.now()}`,
+        type: "card",
+        isDefault: false,
+        card: paymentMethodDetails,
+        createdAt: new Date().toISOString(),
+      };
+
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          paymentMethods: [...prev.paymentMethods, newMethod],
+        };
+      });
+
+      return newMethod;
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to add payment method";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Remove payment method
+  const removePaymentMethod = useCallback(async (methodId: string) => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // await fetch(`${apiUrl}/payment-methods/${methodId}`, {
+      //   method: 'DELETE',
+      // });
+
+      // Mock remove
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          paymentMethods: prev.paymentMethods.filter((pm) => pm.id !== methodId),
+        };
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to remove payment method";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Set default payment method
+  const setDefaultPaymentMethod = useCallback(async (methodId: string) => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // In production, call your billing API
+      // await fetch(`${apiUrl}/payment-methods/${methodId}/default`, {
+      //   method: 'PATCH',
+      // });
+
+      // Mock update
+      setBilling((prev) => {
+        if (!prev) return null;
+        return {
+          ...prev,
+          paymentMethods: prev.paymentMethods.map((pm) => ({
+            ...pm,
+            isDefault: pm.id === methodId,
+          })),
+          defaultPaymentMethod: prev.paymentMethods.find((pm) => pm.id === methodId),
+        };
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Failed to set default payment method";
+      setError(errorMessage);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [apiUrl]);
+
+  // Get invoice URL
+  const getInvoiceUrl = useCallback(async (invoiceId: string) => {
+    // In production, call your billing API
+    // const response = await fetch(`${apiUrl}/invoices/${invoiceId}`);
+    // const data = await response.json();
+    // return data.invoiceUrl;
+
+    return `#invoice-${invoiceId}`;
+  }, [apiUrl]);
+
+  const actions: BillingActions = {
+    loadBilling,
+    updatePlan,
+    cancelSubscription,
+    updateCycle,
+    addPaymentMethod,
+    removePaymentMethod,
+    setDefaultPaymentMethod,
+    getInvoiceUrl,
+  };
+
+  return {
+    billing,
+    isLoading,
+    error,
+    ...actions,
+  };
+}