@umituz/react-native-subscription 2.27.58 → 2.27.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.27.58",
+  "version": "2.27.60",
   "description": "Complete subscription management with RevenueCat, paywall UI, and credits system for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/presentation/hooks/index.ts

@@ -6,6 +6,7 @@ export * from "./useDeductCredit";
 export * from "./useFeatureGate";
 export * from "./usePaywallVisibility";
 export * from "./usePremium";
+export * from "./usePremiumGate";
 export * from "./useSubscriptionSettingsConfig";
 export * from "./useSubscriptionStatus";
 export * from "./feedback/usePaywallFeedback";

package/src/presentation/hooks/usePremiumGate.ts

@@ -0,0 +1,84 @@
+/**
+ * usePremiumGate Hook
+ *
+ * Simplified hook for premium-only apps (no credit system).
+ * Provides screen-level and action-level premium gates.
+ *
+ * @example Screen-Level Gate
+ * ```tsx
+ * const { isPremium, requireScreen } = usePremiumGate();
+ *
+ * useEffect(() => {
+ *   requireScreen(); // Auto-opens paywall if not premium
+ * }, [requireScreen]);
+ *
+ * if (!isPremium) return null;
+ * ```
+ *
+ * @example Action-Level Gate
+ * ```tsx
+ * const { requirePremium } = usePremiumGate();
+ *
+ * const handleAction = () => {
+ *   requirePremium(() => {
+ *     // Action code here
+ *   });
+ * };
+ * ```
+ */
+
+import { useCallback, useEffect } from "react";
+import { useSubscriptionStatus } from "./useSubscriptionStatus";
+import { paywallControl } from "./usePaywallVisibility";
+
+export interface UsePremiumGateResult {
+  /** Whether user has premium access */
+  isPremium: boolean;
+  /** Whether subscription status is loading */
+  isLoading: boolean;
+  /** Action-level gate: runs callback only if user has premium */
+  requirePremium: (onSuccess: () => void) => void;
+  /** Screen-level gate: opens paywall if not premium */
+  requireScreen: () => void;
+}
+
+export const usePremiumGate = (): UsePremiumGateResult => {
+  const { isPremium, isLoading } = useSubscriptionStatus();
+
+  const requirePremium = useCallback(
+    (onSuccess: () => void) => {
+      if (isLoading) {
+        return;
+      }
+
+      if (isPremium) {
+        onSuccess();
+        return;
+      }
+
+      paywallControl.open();
+    },
+    [isPremium, isLoading]
+  );
+
+  const requireScreen = useCallback(() => {
+    if (!isLoading && !isPremium) {
+      paywallControl.open();
+    }
+  }, [isPremium, isLoading]);
+
+  return {
+    isPremium,
+    isLoading,
+    requirePremium,
+    requireScreen,
+  };
+};
+
+/**
+ * useSubscription Hook (Alias for usePremiumGate)
+ *
+ * Simpler name for premium-only apps.
+ * Same functionality as usePremiumGate.
+ */
+export const useSubscription = usePremiumGate;