@umituz/react-native-subscription 2.14.11 → 2.14.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.14.11",
+  "version": "2.14.14",
   "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/domain/errors/InsufficientCreditsError.ts

@@ -0,0 +1,32 @@
+/**
+ * InsufficientCreditsError
+ *
+ * Thrown when user doesn't have enough credits for an operation.
+ * Silently handled - triggers paywall display.
+ */
+
+export class InsufficientCreditsError extends Error {
+  public readonly requiredCredits: number;
+  public readonly availableCredits: number;
+  public readonly operationType: string;
+
+  constructor(
+    requiredCredits: number,
+    availableCredits: number,
+    operationType: string,
+  ) {
+    super(
+      `Insufficient credits: ${availableCredits} available, ${requiredCredits} required`,
+    );
+    this.name = "InsufficientCreditsError";
+    this.requiredCredits = requiredCredits;
+    this.availableCredits = availableCredits;
+    this.operationType = operationType;
+
+    Object.setPrototypeOf(this, InsufficientCreditsError.prototype);
+  }
+
+  get deficit(): number {
+    return this.requiredCredits - this.availableCredits;
+  }
+}

package/src/index.ts

@@ -233,6 +233,12 @@ export type {
 
 export { DEFAULT_CREDITS_CONFIG } from "./domain/entities/Credits";
 
+// =============================================================================
+// CREDITS SYSTEM - Errors
+// =============================================================================
+
+export { InsufficientCreditsError } from "./domain/errors/InsufficientCreditsError";
+
 // CreditCost, Transaction types, Wallet types, Credit-cost types
 // are now exported from "./domains/wallet"
 

package/src/presentation/hooks/useCredits.ts

@@ -38,6 +38,8 @@ export interface UseCreditsResult {
   textCreditsPercent: number;
   imageCreditsPercent: number;
   refetch: () => void;
+  /** Check if user can afford a specific credit cost */
+  canAfford: (cost: number, type?: CreditType) => boolean;
 }
 
 export const useCredits = ({
@@ -86,6 +88,13 @@ export const useCredits = ({
     ? Math.round((credits.imageCredits / config.imageCreditLimit) * 100)
     : 0;
 
+  const canAfford = (cost: number, type: CreditType = "text"): boolean => {
+    if (!credits) return false;
+    return type === "text"
+      ? credits.textCredits >= cost
+      : credits.imageCredits >= cost;
+  };
+
   return {
     credits,
     isLoading,
@@ -95,6 +104,7 @@ export const useCredits = ({
     textCreditsPercent,
     imageCreditsPercent,
     refetch,
+    canAfford,
   };
 };