@umituz/react-native-subscription 2.37.39 → 2.37.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.37.39",
+  "version": "2.37.41",
   "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/domains/credits/application/CreditLimitCalculator.ts

@@ -1,20 +1,14 @@
 import type { CreditsConfig } from "../core/Credits";
 import { detectPackageType } from "../../../utils/packageTypeDetector";
 import { getCreditAllocation } from "../../../utils/creditMapper";
-import { NO_SUBSCRIPTION_PRODUCT_ID } from "../../subscription/application/syncConstants";
 
 export function calculateCreditLimit(productId: string | undefined, config: CreditsConfig): number {
   if (!productId) {
     throw new Error("[CreditLimitCalculator] Cannot calculate credit limit without productId");
   }
 
-  // Free tier users (no subscription) get 0 credits - strict paywall
-  if (productId === NO_SUBSCRIPTION_PRODUCT_ID) {
-    return 0;
-  }
-
   const explicitAmount = config.creditPackageAmounts?.[productId];
-  if (explicitAmount) return explicitAmount;
+  if (explicitAmount !== undefined && explicitAmount !== null) return explicitAmount;
 
   const packageType = detectPackageType(productId);
   const dynamicLimit = getCreditAllocation(packageType, config.packageAllocations);
@@ -25,5 +19,3 @@ export function calculateCreditLimit(productId: string | undefined, config: Cred
 
   return dynamicLimit;
 }
-
-

package/src/domains/credits/application/DeductCreditsCommand.ts

@@ -3,10 +3,6 @@ import type { DeductCreditsResult } from "../core/Credits";
 import { CREDIT_ERROR_CODES } from "../core/CreditsConstants";
 import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
 
-/**
- * Deducts credits from a user's balance.
- * Encapsulates the domain rules and transaction logic for credit usage.
- */
 export async function deductCreditsOperation(
   _db: Firestore,
   creditsRef: DocumentReference,
@@ -24,6 +20,18 @@ export async function deductCreditsOperation(
     };
   }
 
+  const MAX_SINGLE_DEDUCTION = 10000;
+  if (cost <= 0 || !Number.isFinite(cost) || cost > MAX_SINGLE_DEDUCTION) {
+    return {
+      success: false,
+      remainingCredits: null,
+      error: {
+        message: `Cost must be a positive finite number not exceeding ${MAX_SINGLE_DEDUCTION}`,
+        code: 'INVALID_AMOUNT'
+      }
+    };
+  }
+
   try {
     const remaining = await runTransaction(async (tx: Transaction) => {
       const docSnap = await tx.get(creditsRef);
@@ -32,7 +40,8 @@ export async function deductCreditsOperation(
         throw new Error(CREDIT_ERROR_CODES.NO_CREDITS);
       }
 
-      const current = docSnap.data().credits as number;
+      const rawCredits = docSnap.data().credits;
+      const current = typeof rawCredits === "number" && Number.isFinite(rawCredits) ? rawCredits : 0;
       if (current < cost) {
         throw new Error(CREDIT_ERROR_CODES.CREDITS_EXHAUSTED);
       }
@@ -55,8 +64,8 @@ export async function deductCreditsOperation(
     };
   } catch (e: unknown) {
     const message = e instanceof Error ? e.message : String(e);
-    const code = (message === CREDIT_ERROR_CODES.NO_CREDITS || message === CREDIT_ERROR_CODES.CREDITS_EXHAUSTED) 
-      ? message 
+    const code = (message === CREDIT_ERROR_CODES.NO_CREDITS || message === CREDIT_ERROR_CODES.CREDITS_EXHAUSTED)
+      ? message
       : CREDIT_ERROR_CODES.DEDUCT_ERR;
 
     return {

package/src/domains/credits/application/RefundCreditsCommand.ts

@@ -3,10 +3,6 @@ import type { DeductCreditsResult } from "../core/Credits";
 import { CREDIT_ERROR_CODES } from "../core/CreditsConstants";
 import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
 
-/**
- * Refunds credits to a user's balance.
- * Used for optimistic billing rollbacks when generation fails due to transient errors.
- */
 export async function refundCreditsOperation(
   _db: Firestore,
   creditsRef: DocumentReference,
@@ -24,7 +20,7 @@ export async function refundCreditsOperation(
     };
   }
 
-  if (amount <= 0) {
+  if (amount <= 0 || !Number.isFinite(amount)) {
     return {
       success: false,
       remainingCredits: null,

package/src/domains/credits/application/credit-strategies/TrialCreditStrategy.ts

@@ -2,13 +2,9 @@ import { ICreditStrategy, type CreditAllocationParams } from "./ICreditStrategy"
 import { SUBSCRIPTION_STATUS } from "../../../subscription/core/SubscriptionConstants";
 import { TRIAL_CONFIG } from "../../../trial/core/TrialTypes";
 
-/**
- * Strategy for Trial and Trial Canceled users.
- * Allocates credits based on trial configuration.
- */
 export class TrialCreditStrategy implements ICreditStrategy {
     canHandle(params: CreditAllocationParams): boolean {
-        return params.status === SUBSCRIPTION_STATUS.TRIAL || 
+        return params.status === SUBSCRIPTION_STATUS.TRIAL ||
                params.status === SUBSCRIPTION_STATUS.TRIAL_CANCELED;
     }
 

package/src/domains/credits/application/creditDocumentHelpers.ts

@@ -1,14 +1,7 @@
-/**
- * Credit Document Helpers
- * Utilities for getting and creating credit documents
- */
-
 import type { UserCreditsDocumentRead } from "../core/UserCreditsDocument";
 import { serverTimestamp, type DocumentSnapshot } from "@umituz/react-native-firebase";
 import { SUBSCRIPTION_STATUS, type Platform } from "../../subscription/core/SubscriptionConstants";
-/**
- * Get existing credit document or create default
- */
+
 export function getCreditDocumentOrDefault(
     creditsDoc: DocumentSnapshot,
     platform: Platform
@@ -17,7 +10,7 @@ export function getCreditDocumentOrDefault(
         return creditsDoc.data() as UserCreditsDocumentRead;
     }
 
-    const now = serverTimestamp() as any; // FieldValue for Firestore write
+    const now = serverTimestamp() as any;
 
     const defaultDocument: UserCreditsDocumentRead = {
         credits: 0,

package/src/domains/credits/core/Credits.ts

@@ -1,12 +1,4 @@
-/**
- * Credits Domain Entities
- *
- * Generic credit system types for subscription-based apps.
- * Designed to be used across hundreds of apps with configurable limits.
- */
-
 import type { SubscriptionPackageType } from "../../../utils/packageTypeDetector";
-// Types imported from SubscriptionConstants are used directly in UserCredits interface
 import type {
   SubscriptionStatusType,
   PackageType,
@@ -17,37 +9,25 @@ import type {
 
 export type CreditType = "text" | "image";
 
-/** Single Source of Truth for user subscription + credits data */
 export interface UserCredits {
-  // Core subscription
   isPremium: boolean;
   status: SubscriptionStatusType;
-
-  // Dates
   purchasedAt: Date | null;
   expirationDate: Date | null;
   lastUpdatedAt: Date | null;
   lastPurchaseAt: Date | null;
-
-  // RevenueCat subscription details
   willRenew: boolean | null;
   productId: string | null;
   packageType: PackageType | null;
   originalTransactionId: string | null;
-
-  // Trial fields - periodType comes from RevenueCat SDK
   periodType: string | null;
   isTrialing: boolean | null;
   trialStartDate: Date | null;
   trialEndDate: Date | null;
   trialCredits: number | null;
   convertedFromTrial: boolean | null;
-
-  // Credits
   credits: number;
   creditLimit: number;
-
-  // Metadata
   purchaseSource: PurchaseSource | null;
   purchaseType: PurchaseType | null;
   platform: Platform;
@@ -66,11 +46,8 @@ export type PackageAllocationMap = Partial<Record<
 export interface CreditsConfig {
   collectionName: string;
   creditLimit: number;
-  /** When true, stores credits at users/{userId}/credits instead of {collectionName}/{userId} */
   useUserSubcollection: boolean;
-  /** Credit amounts per product ID for consumable credit packages */
   creditPackageAmounts: Record<string, number>;
-  /** Credit allocations for different subscription types (weekly, monthly, yearly) */
   packageAllocations: PackageAllocationMap;
 }
 

package/src/domains/credits/core/CreditsMapper.ts

@@ -3,9 +3,6 @@ import { resolveSubscriptionStatus, type SubscriptionStatusType } from "../../su
 import type { UserCreditsDocumentRead } from "./UserCreditsDocument";
 import { toSafeDate } from "../../../utils/dateUtils";
 
-/**
- * Validate subscription status against expirationDate and periodType
- */
 function validateSubscription(
   doc: UserCreditsDocumentRead,
   expirationDate: Date | null,
@@ -28,9 +25,6 @@ function validateSubscription(
   };
 }
 
-/** 
- * Maps Firestore document to domain entity with expiration validation 
- */
 export function mapCreditsDocumentToEntity(doc: UserCreditsDocumentRead): UserCredits {
   const expirationDate = toSafeDate(doc.expirationDate);
   const periodType = doc.periodType;

package/src/domains/credits/core/UserCreditsDocument.ts

@@ -30,41 +30,29 @@ export interface PurchaseMetadata {
   timestamp: FirestoreTimestamp;
 }
 
-/** Single Source of Truth for user subscription data */
 export interface UserCreditsDocumentRead {
-    // Core subscription status
     isPremium: boolean;
     status: SubscriptionStatusType;
-
-    // Dates (all from RevenueCat)
     purchasedAt: FirestoreTimestamp;
     expirationDate: FirestoreTimestamp | null;
     lastUpdatedAt: FirestoreTimestamp;
     lastPurchaseAt: FirestoreTimestamp | null;
     canceledAt: FirestoreTimestamp | null;
     billingIssueDetectedAt: FirestoreTimestamp | null;
-
-    // RevenueCat subscription details
     willRenew: boolean | null;
     productId: string | null;
     packageType: PackageType | null;
     originalTransactionId: string | null;
     store: Store | null;
     ownershipType: OwnershipType | null;
-
-    // Trial fields
     periodType: string | null;
     isTrialing: boolean | null;
     trialStartDate: FirestoreTimestamp | null;
     trialEndDate: FirestoreTimestamp | null;
     trialCredits: number | null;
     convertedFromTrial: boolean | null;
-
-    // Credits
     credits: number;
     creditLimit: number;
-
-    // Metadata
     purchaseSource: PurchaseSource | null;
     purchaseType: PurchaseType | null;
     platform: Platform;

package/src/domains/credits/infrastructure/CreditsRepositoryManager.ts

@@ -1,9 +1,3 @@
-/**
- * Credits Repository Manager
- * Module-level singleton for credits repository configuration
- * Provides a clean, testable approach for repository access
- */
-
 import type { CreditsConfig } from "../core/Credits";
 import type { CreditsRepository } from "./CreditsRepository";
 import { createCreditsRepository } from "./CreditsRepository";
@@ -11,26 +5,15 @@ import { createCreditsRepository } from "./CreditsRepository";
 let globalRepository: CreditsRepository | null = null;
 let globalConfig: CreditsConfig | null = null;
 
-/**
- * Configure credits repository for the application
- * Must be called once during app initialization
- */
 export function configureCreditsRepository(config: CreditsConfig): void {
   globalConfig = config;
   globalRepository = createCreditsRepository(globalConfig);
 }
 
-/**
- * Check if credits repository is configured
- */
 export function isCreditsRepositoryConfigured(): boolean {
   return globalRepository !== null;
 }
 
-/**
- * Get the configured credits repository
- * Throws if repository not configured
- */
 export function getCreditsRepository(): CreditsRepository {
   if (!globalRepository) {
     throw new Error(
@@ -40,9 +23,6 @@ export function getCreditsRepository(): CreditsRepository {
   return globalRepository;
 }
 
-/**
- * Get the current credits configuration
- */
 export function getCreditsConfig(): CreditsConfig {
   if (!globalConfig) {
     throw new Error(
@@ -51,4 +31,3 @@ export function getCreditsConfig(): CreditsConfig {
   }
   return globalConfig;
 }
-

package/src/domains/credits/infrastructure/operations/CreditsWriter.ts

@@ -4,6 +4,7 @@ import { serverTimestamp } from "@umituz/react-native-firebase";
 import { SUBSCRIPTION_STATUS } from "../../../subscription/core/SubscriptionConstants";
 import { resolveSubscriptionStatus } from "../../../subscription/core/SubscriptionStatus";
 import { toTimestamp } from "../../../../shared/utils/dateConverter";
+import { isPast } from "../../../../utils/dateUtils";
 
 export async function syncExpiredStatus(ref: DocumentReference): Promise<void> {
   const doc = await getDoc(ref);
@@ -36,7 +37,7 @@ export async function syncPremiumMetadata(
   const doc = await getDoc(ref);
   if (!doc.exists()) return;
 
-  const isExpired = false;
+  const isExpired = metadata.expirationDate ? isPast(metadata.expirationDate) : false;
   const status = resolveSubscriptionStatus({
     isPremium: metadata.isPremium,
     willRenew: metadata.willRenew,

package/src/domains/credits/presentation/deduct-credit/useDeductCredit.ts

@@ -35,9 +35,9 @@ export const useDeductCredit = ({
       console.error('[useDeductCredit] Unexpected error during credit deduction', {
         cost,
         userId,
-        error
+        error: error instanceof Error ? error.message : String(error)
       });
-      throw error;
+      return false;
     }
   }, [onCreditsExhausted, userId]);
 

package/src/domains/credits/presentation/useCredits.ts

@@ -1,6 +1,6 @@
 import { useQuery, useQueryClient } from "@umituz/react-native-design-system";
 import { useCallback, useMemo, useEffect } from "react";
-import { useAuthStore, selectUserId } from "@umituz/react-native-auth";
+import { useAuthStore, selectUserId, selectIsAnonymous } from "@umituz/react-native-auth";
 import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
 import { NO_CACHE_QUERY_CONFIG } from "../../../shared/infrastructure/react-query/queryConfig";
 import { usePreviousUserCleanup } from "../../../shared/infrastructure/react-query/hooks/usePreviousUserCleanup";
@@ -10,7 +10,7 @@ import {
   isCreditsRepositoryConfigured,
 } from "../infrastructure/CreditsRepositoryManager";
 import { calculateSafePercentage, canAffordAmount } from "../utils/creditValidation";
-import { isAuthenticated } from "../../subscription/utils/authGuards";
+import { isRegisteredUser } from "../../subscription/utils/authGuards";
 import { creditsQueryKeys } from "./creditsQueryKeys";
 import type { UseCreditsResult, CreditsLoadStatus } from "./useCredits.types";
 
@@ -26,15 +26,17 @@ const deriveLoadStatus = (
 
 export const useCredits = (): UseCreditsResult => {
   const userId = useAuthStore(selectUserId);
+  const isAnonymous = useAuthStore(selectIsAnonymous);
   const isConfigured = isCreditsRepositoryConfigured();
 
   const config = isConfigured ? getCreditsConfig() : null;
-  const queryEnabled = isAuthenticated(userId) && isConfigured;
+  const isUserRegistered = isRegisteredUser(userId, isAnonymous);
+  const queryEnabled = isUserRegistered && isConfigured;
 
   const { data, status, error, refetch } = useQuery({
     queryKey: creditsQueryKeys.user(userId),
     queryFn: async () => {
-      if (!isAuthenticated(userId) || !isConfigured) return null;
+      if (!isUserRegistered || !isConfigured) return null;
 
       const repository = getCreditsRepository();
       const result = await repository.getCredits(userId);
@@ -51,11 +53,10 @@ export const useCredits = (): UseCreditsResult => {
 
   const queryClient = useQueryClient();
 
-  // Clean up previous user's cache on logout/user switch
   usePreviousUserCleanup(userId, queryClient, creditsQueryKeys.user);
 
   useEffect(() => {
-    if (!isAuthenticated(userId)) return undefined;
+    if (!isUserRegistered) return undefined;
 
     const unsubscribe = subscriptionEventBus.on(SUBSCRIPTION_EVENTS.CREDITS_UPDATED, (updatedUserId) => {
       if (updatedUserId === userId) {
@@ -64,13 +65,13 @@ export const useCredits = (): UseCreditsResult => {
     });
 
     return unsubscribe;
-  }, [userId, queryClient]);
+  }, [userId, isUserRegistered, queryClient]);
 
   const credits = data ?? null;
 
   const derivedValues = useMemo(() => {
     const has = (credits?.credits ?? 0) > 0;
-    const limit = config?.creditLimit ?? 0;
+    const limit = credits?.creditLimit ?? config?.creditLimit ?? 0;
     const percent = calculateSafePercentage(credits?.credits, limit);
     return { hasCredits: has, creditsPercent: percent };
   }, [credits, config?.creditLimit]);
@@ -95,4 +96,4 @@ export const useCredits = (): UseCreditsResult => {
     refetch,
     canAfford,
   };
-};
+};

package/src/domains/paywall/components/PaywallContainer.types.ts

@@ -1,57 +1,29 @@
-/**
- * PaywallContainer Types
- * Props for subscription paywall
- */
-
 import type { ImageSourcePropType } from "react-native";
 import type { PaywallTranslations, PaywallLegalUrls, SubscriptionFeature } from "../entities/types";
 import type { PurchaseSource } from "../../subscription/core/SubscriptionConstants";
 import type { PackageAllocationMap } from "../../credits/core/Credits";
 
-/**
- * Trial display configuration
- * Controls how free trial info is displayed (Apple-compliant)
- */
 export interface TrialConfig {
-  /** Enable trial display (default: false) */
   readonly enabled: boolean;
-  /** Product IDs that have trial offers (if empty, checks all via RevenueCat) */
   readonly eligibleProductIds?: readonly string[];
-  /** Trial duration in days (default: 7) */
   readonly durationDays?: number;
-  /** Text to show for trial (e.g., "7 days free, then billed") */
   readonly trialText?: string;
 }
 
 export interface PaywallContainerProps {
-  /** Paywall translations - no defaults, must be provided */
   readonly translations: PaywallTranslations;
-  /** Legal URLs for privacy and terms */
   readonly legalUrls?: PaywallLegalUrls;
-  /** Feature list to display */
   readonly features?: readonly SubscriptionFeature[];
-  /** Hero image for paywall header */
   readonly heroImage?: ImageSourcePropType;
-  /** Best value package identifier for badge */
   readonly bestValueIdentifier?: string;
-  /** Credit amounts per product identifier (takes precedence over packageAllocations) */
   readonly creditAmounts?: Record<string, number>;
-  /** Credits label text (e.g., "credits") */
   readonly creditsLabel?: string;
-  /** Package allocations for auto-computing creditAmounts (used when creditAmounts not provided) */
   readonly packageAllocations?: PackageAllocationMap;
-  /** Source of the paywall - affects pending purchase handling */
   readonly source?: PurchaseSource;
-  /** Callback when purchase succeeds */
   readonly onPurchaseSuccess?: () => void;
-  /** Callback when purchase fails */
   readonly onPurchaseError?: (error: Error | string) => void;
-  /** Callback when auth is required (for anonymous users) */
   readonly onAuthRequired?: () => void;
-  /** Visibility override */
   readonly visible?: boolean;
-  /** Callback when paywall is closed */
   readonly onClose?: () => void;
-  /** Trial display configuration (Apple-compliant) */
   readonly trialConfig?: TrialConfig;
 }

package/src/domains/paywall/components/PaywallModal.styles.ts

@@ -1,7 +1,3 @@
-/**
- * PaywallModal Styles
- */
-
 import { StyleSheet } from "react-native";
 
 export const paywallModalStyles = StyleSheet.create({

package/src/domains/paywall/entities/types.ts

@@ -1,8 +1,3 @@
-/**
- * Paywall Types
- * All paywall-related type definitions
- */
-
 export interface SubscriptionFeature {
     icon: string;
     text: string;

package/src/domains/paywall/hooks/usePaywallActions.ts

@@ -1,7 +1,3 @@
-/**
- * usePaywallActions Hook
- * Encapsulates purchase and restore flow for the paywall.
- */
 import { useState, useCallback, useRef, useEffect } from "react";
 import type { PurchasesPackage } from "react-native-purchases";
 import { usePurchaseLoadingStore } from "../../subscription/presentation/stores";
@@ -52,7 +48,6 @@ export function usePaywallActions({
   });
 
   const handlePurchase = useCallback(async () => {
-
     if (!selectedPlanId) {
       return;
     }
@@ -71,7 +66,7 @@ export function usePaywallActions({
 
     if (!pkg) {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
-        console.error("[usePaywallActions] ❌ Package not found", {
+        console.error("[usePaywallActions] Package not found", {
           selectedPlanId,
           availablePackages: packages.map(p => p.product.identifier),
         });
@@ -85,18 +80,12 @@ export function usePaywallActions({
     startPurchase(selectedPlanId, "manual");
 
     try {
-
       const success = await onPurchaseRef.current(pkg);
 
       if (success === true) {
         onPurchaseSuccessRef.current?.();
         onCloseRef.current?.();
-      } else if (success === false) {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.warn("[usePaywallActions] ⚠️ Purchase returned false (user cancelled or failed)");
-        }
       }
-      // else: success is undefined/null - no action needed
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
       onPurchaseErrorRef.current?.(err);
@@ -107,7 +96,6 @@ export function usePaywallActions({
   }, [selectedPlanId, packages, isProcessing, startPurchase, endPurchase]);
 
   const handleRestore = useCallback(async () => {
-
     if (!onRestoreRef.current) {
       const err = new Error("Restore handler not configured");
       onPurchaseErrorRef.current?.(err);
@@ -120,13 +108,11 @@ export function usePaywallActions({
 
     setIsLocalProcessing(true);
     try {
-
       const success = await onRestoreRef.current();
 
       if (success === true) {
         onPurchaseSuccessRef.current?.();
       }
-      // else: success is false/undefined - restore failed or user cancelled, no action needed
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
       onPurchaseErrorRef.current?.(err);

package/src/domains/revenuecat/core/errors/RevenueCatError.ts

@@ -1,8 +1,3 @@
-/**
- * RevenueCat Error Classes
- * Domain-specific error types for RevenueCat operations
- */
-
 import { BaseError } from "../../../../shared/utils/BaseError";
 
 class RevenueCatError extends BaseError {
@@ -49,4 +44,3 @@ export class RevenueCatNetworkError extends RevenueCatError {
         this.name = "RevenueCatNetworkError";
     }
 }
-

package/src/domains/revenuecat/core/errors/RevenueCatErrorHandler.ts

@@ -1,8 +1,3 @@
-/**
- * RevenueCat Error Handler
- * Error code mapping and message resolution utilities
- */
-
 import Purchases from "react-native-purchases";
 import {
   ERROR_MESSAGES_MAP,
@@ -11,12 +6,7 @@ import {
   type PurchasesErrorCode,
 } from "./RevenueCatErrorMessages";
 
-/**
- * Error Code to Enum Mapping
- * Maps both string keys and numeric codes to Purchases error enum values
- */
 const ERROR_CODE_MAP = new Map<string, PurchasesErrorCode>([
-  // String error codes
   ["PURCHASE_CANCELLED_ERROR", Purchases.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR],
   ["PURCHASE_NOT_ALLOWED_ERROR", Purchases.PURCHASES_ERROR_CODE.PURCHASE_NOT_ALLOWED_ERROR],
   ["PURCHASE_INVALID_ERROR", Purchases.PURCHASES_ERROR_CODE.PURCHASE_INVALID_ERROR],
@@ -31,7 +21,6 @@ const ERROR_CODE_MAP = new Map<string, PurchasesErrorCode>([
   ["STORE_PROBLEM_ERROR", Purchases.PURCHASES_ERROR_CODE.STORE_PROBLEM_ERROR],
   ["PAYMENT_PENDING_ERROR", Purchases.PURCHASES_ERROR_CODE.PAYMENT_PENDING_ERROR],
 
-  // Numeric error codes as fallback
   ["1", Purchases.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR],
   ["2", Purchases.PURCHASES_ERROR_CODE.STORE_PROBLEM_ERROR],
   ["3", Purchases.PURCHASES_ERROR_CODE.PURCHASE_NOT_ALLOWED_ERROR],
@@ -47,13 +36,6 @@ const ERROR_CODE_MAP = new Map<string, PurchasesErrorCode>([
   ["0", Purchases.PURCHASES_ERROR_CODE.UNKNOWN_ERROR],
 ]);
 
-/**
- * Get error message configuration for a given error code
- * Strategy Pattern with Map lookup - O(1) complexity
- *
- * @param errorCode - Error code string from RevenueCat error
- * @returns ErrorMessage configuration
- */
 function getErrorMessageForCode(errorCode: string | null | undefined): ErrorMessage {
   if (!errorCode) {
     return DEFAULT_ERROR_MESSAGE;
@@ -70,12 +52,6 @@ function getErrorMessageForCode(errorCode: string | null | undefined): ErrorMess
   return DEFAULT_ERROR_MESSAGE;
 }
 
-/**
- * Get error message from RevenueCat error object
- *
- * @param error - RevenueCat error object
- * @returns ErrorMessage configuration
- */
 export function getErrorMessage(error: unknown): ErrorMessage {
   if (!error || typeof error !== "object") {
     return DEFAULT_ERROR_MESSAGE;