@umituz/react-native-subscription 1.8.0 → 1.8.1

package/package.json

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

package/src/index.ts

@@ -231,3 +231,20 @@ export {
   type UsePremiumWithCreditsParams,
   type UsePremiumWithCreditsResult,
 } from "./presentation/hooks/usePremiumWithCredits";
+
+export {
+  useCreditChecker,
+  type UseCreditCheckerParams,
+  type UseCreditCheckerResult,
+} from "./presentation/hooks/useCreditChecker";
+
+// =============================================================================
+// CREDITS SYSTEM - Utilities
+// =============================================================================
+
+export {
+  createCreditChecker,
+  type CreditCheckResult,
+  type CreditCheckerConfig,
+  type CreditChecker,
+} from "./utils/creditChecker";

package/src/presentation/hooks/useCreditChecker.ts

@@ -0,0 +1,41 @@
+/**
+ * useCreditChecker Hook
+ *
+ * Provides credit checking utilities using context repository.
+ */
+
+import { useMemo } from "react";
+import type { CreditType } from "../../domain/entities/Credits";
+import { useCreditsRepository } from "../context/CreditsContext";
+import {
+  createCreditChecker,
+  type CreditCheckResult,
+} from "../../utils/creditChecker";
+
+export interface UseCreditCheckerParams {
+  getCreditType: (operationType: string) => CreditType;
+}
+
+export interface UseCreditCheckerResult {
+  checkCreditsAvailable: (
+    userId: string | undefined,
+    operationType: string
+  ) => Promise<CreditCheckResult>;
+  deductCreditsAfterSuccess: (
+    userId: string | undefined,
+    creditType: CreditType
+  ) => Promise<void>;
+}
+
+export const useCreditChecker = ({
+  getCreditType,
+}: UseCreditCheckerParams): UseCreditCheckerResult => {
+  const repository = useCreditsRepository();
+
+  const checker = useMemo(
+    () => createCreditChecker({ repository, getCreditType }),
+    [repository, getCreditType]
+  );
+
+  return checker;
+};

package/src/utils/creditChecker.ts

@@ -0,0 +1,79 @@
+/**
+ * Credit Checker Utility
+ *
+ * Validates credit availability before operations.
+ * Generic - works with any generation type mapping.
+ */
+
+import type { CreditType } from "../domain/entities/Credits";
+import type { CreditsRepository } from "../infrastructure/repositories/CreditsRepository";
+
+export interface CreditCheckResult {
+  success: boolean;
+  error?: string;
+  creditType?: CreditType;
+}
+
+export interface CreditCheckerConfig {
+  repository: CreditsRepository;
+  getCreditType: (operationType: string) => CreditType;
+}
+
+export const createCreditChecker = (config: CreditCheckerConfig) => {
+  const { repository, getCreditType } = config;
+
+  const checkCreditsAvailable = async (
+    userId: string | undefined,
+    operationType: string
+  ): Promise<CreditCheckResult> => {
+    if (!userId) {
+      return { success: false, error: "anonymous_user_blocked" };
+    }
+
+    const creditType = getCreditType(operationType);
+    const hasCreditsAvailable = await repository.hasCredits(userId, creditType);
+
+    if (!hasCreditsAvailable) {
+      return {
+        success: false,
+        error:
+          creditType === "image"
+            ? "credits_exhausted_image"
+            : "credits_exhausted_text",
+        creditType,
+      };
+    }
+
+    return { success: true, creditType };
+  };
+
+  const deductCreditsAfterSuccess = async (
+    userId: string | undefined,
+    creditType: CreditType
+  ): Promise<void> => {
+    if (!userId) return;
+
+    const maxRetries = 3;
+    let lastError: Error | null = null;
+
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      const result = await repository.deductCredit(userId, creditType);
+      if (result.success) {
+        return;
+      }
+      lastError = new Error(result.error?.message || "Deduction failed");
+      await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
+    }
+
+    if (lastError) {
+      throw lastError;
+    }
+  };
+
+  return {
+    checkCreditsAvailable,
+    deductCreditsAfterSuccess,
+  };
+};
+
+export type CreditChecker = ReturnType<typeof createCreditChecker>;