@umituz/react-native-subscription 2.37.39 → 2.37.41

package/src/domains/subscription/presentation/usePaywallVisibility.ts

@@ -1,9 +1,3 @@
-/**
- * Paywall Visibility Hook
- * Simple global state for paywall visibility using module-level state
- * Generic implementation for 100+ apps
- */
-
 import { useCallback, useSyncExternalStore } from "react";
 import type { PurchaseSource } from "../core/SubscriptionConstants";
 
@@ -29,9 +23,6 @@ const setPaywallState = (visible: boolean, source?: PurchaseSource): void => {
   listeners.forEach((listener) => listener());
 };
 
-/**
- * Direct paywall control for non-React services (e.g., appInitializer)
- */
 export const paywallControl = {
   open: (source?: PurchaseSource) => setPaywallState(true, source),
   close: () => setPaywallState(false, undefined),

package/src/domains/subscription/presentation/useSubscriptionStatus.ts

@@ -1,11 +1,11 @@
 import { useQuery, useQueryClient } from "@umituz/react-native-design-system";
 import { useEffect, useSyncExternalStore } from "react";
-import { useAuthStore, selectUserId } from "@umituz/react-native-auth";
+import { useAuthStore, selectUserId, selectIsAnonymous } from "@umituz/react-native-auth";
 import { SubscriptionManager } from "../infrastructure/managers/SubscriptionManager";
 import { initializationState } from "../infrastructure/state/initializationState";
 import { subscriptionEventBus, SUBSCRIPTION_EVENTS } from "../../../shared/infrastructure/SubscriptionEventBus";
 import { SubscriptionStatusResult } from "./useSubscriptionStatus.types";
-import { isAuthenticated } from "../utils/authGuards";
+import { isRegisteredUser } from "../utils/authGuards";
 import { NO_CACHE_QUERY_CONFIG } from "../../../shared/infrastructure/react-query/queryConfig";
 import { usePreviousUserCleanup } from "../../../shared/infrastructure/react-query/hooks/usePreviousUserCleanup";
 
@@ -17,32 +17,30 @@ export const subscriptionStatusQueryKeys = {
 
 export const useSubscriptionStatus = (): SubscriptionStatusResult => {
   const userId = useAuthStore(selectUserId);
+  const isAnonymous = useAuthStore(selectIsAnonymous);
   const queryClient = useQueryClient();
   const isConfigured = SubscriptionManager.isConfigured();
+  const isUserRegistered = isRegisteredUser(userId, isAnonymous);
 
-  // Reactive initialization state - triggers re-render when BackgroundInitializer completes
   const initState = useSyncExternalStore(
     initializationState.subscribe,
     initializationState.getSnapshot,
     initializationState.getSnapshot,
   );
 
-  // Check if initialized for this specific user (reactive)
   const isInitialized = userId
     ? initState.initialized && initState.userId === userId
     : false;
 
-  const queryEnabled = isAuthenticated(userId) && isConfigured && isInitialized;
+  const queryEnabled = isUserRegistered && isConfigured && isInitialized;
 
   const { data, status, error, refetch } = useQuery({
     queryKey: subscriptionStatusQueryKeys.user(userId),
     queryFn: async () => {
-      if (!isAuthenticated(userId)) {
+      if (!isUserRegistered) {
         return null;
       }
 
-      // No side effects - just check premium status
-      // Initialization is handled by BackgroundInitializer
       try {
         const result = await SubscriptionManager.checkPremiumStatus();
         return result;
@@ -54,11 +52,10 @@ export const useSubscriptionStatus = (): SubscriptionStatusResult => {
     ...NO_CACHE_QUERY_CONFIG,
   });
 
-  // Clean up previous user's cache on logout/user switch
   usePreviousUserCleanup(userId, queryClient, subscriptionStatusQueryKeys.user);
 
   useEffect(() => {
-    if (!isAuthenticated(userId)) return undefined;
+    if (!isUserRegistered) return undefined;
 
     const unsubscribe = subscriptionEventBus.on(
       SUBSCRIPTION_EVENTS.PREMIUM_STATUS_CHANGED,
@@ -72,7 +69,7 @@ export const useSubscriptionStatus = (): SubscriptionStatusResult => {
     );
 
     return unsubscribe;
-  }, [userId, queryClient]);
+  }, [userId, isUserRegistered, queryClient]);
 
   const isLoading = status === "pending";
 

package/src/domains/subscription/utils/authGuards.ts

@@ -4,3 +4,6 @@ export function isAuthenticated(userId: string | null | undefined): userId is st
   return isDefined(userId) && userId.length > 0;
 }
 
+export function isRegisteredUser(userId: string | null | undefined, isAnonymous: boolean): userId is string {
+  return isAuthenticated(userId) && !isAnonymous;
+}

package/src/domains/trial/application/TrialService.ts

@@ -1,7 +1,3 @@
-/**
- * Trial Service - Facade for device-based trial tracking
- */
-
 import { arrayUnion, type FieldValue } from "firebase/firestore";
 import { serverTimestamp } from "@umituz/react-native-firebase";
 import { PersistentDeviceIdService } from "@umituz/react-native-design-system";
@@ -10,7 +6,6 @@ import { TrialEligibilityService } from "./TrialEligibilityService";
 import type { TrialEligibilityResult } from "../core/TrialTypes";
 export type { TrialEligibilityResult };
 
-// Type for Firestore write operations with FieldValue
 interface TrialRecordWrite {
   deviceId?: string;
   hasUsedTrial?: boolean;
@@ -26,10 +21,6 @@ const repository = new DeviceTrialRepository();
 
 export const getDeviceId = () => PersistentDeviceIdService.getDeviceId();
 
-/**
- * Ensures a valid device ID is available
- * Uses provided deviceId if non-empty, otherwise fetches from PersistentDeviceIdService
- */
 async function ensureDeviceId(deviceId?: string): Promise<string> {
   return (deviceId && deviceId.length > 0) ? deviceId : await getDeviceId();
 }

package/src/domains/trial/core/TrialTypes.ts

@@ -1,15 +1,8 @@
-/**
- * Trial Types and Constants
- * Device-based trial tracking types
- */
-
-/** Trial constants */
 export const TRIAL_CONFIG = {
   DURATION_DAYS: 3,
   CREDITS: 0,
 } as const;
 
-/** Device trial record in Firestore */
 export interface DeviceTrialRecord {
   deviceId: string;
   hasUsedTrial: boolean;
@@ -23,7 +16,6 @@ export interface DeviceTrialRecord {
   updatedAt: Date;
 }
 
-/** Trial eligibility result */
 export interface TrialEligibilityResult {
   eligible: boolean;
   reason?: "already_used" | "device_not_found" | "error" | "user_already_used";

package/src/domains/wallet/domain/mappers/TransactionMapper.ts

@@ -1,8 +1,3 @@
-/**
- * Transaction Mapper
- * Maps Firestore data to CreditLog entity
- */
-
 import type { QueryDocumentSnapshot, DocumentData } from "firebase/firestore";
 import type { CreditLog } from "../types/transaction.types";
 

package/src/domains/wallet/domain/types/transaction.types.ts

@@ -1,10 +1,3 @@
-/**
- * Transaction Types
- *
- * Types for credit transaction history and logs.
- * Generic types for use across hundreds of apps.
- */
-
 export type TransactionReason =
   | "purchase"
   | "usage"

package/src/domains/wallet/index.ts

@@ -1,10 +1,3 @@
-/**
- * Wallet Domain
- *
- * Public API for wallet functionality.
- */
-
-// Screens
 export {
   WalletScreen,
 } from "./presentation/screens/WalletScreen";

package/src/domains/wallet/infrastructure/config/walletConfig.ts

@@ -1,13 +1,5 @@
-/**
- * Wallet Configuration
- *
- * Global configuration for wallet feature.
- * Set once at app init, used by WalletScreen automatically.
- */
-
 import type { WalletScreenTranslations } from "../../presentation/screens/WalletScreen.types";
 
-
 interface WalletConfiguration {
   translations: WalletScreenTranslations;
   transactionCollection: string;
@@ -41,9 +33,6 @@ const DEFAULT_CONFIG: WalletConfiguration = {
 
 let walletConfig: WalletConfiguration = { ...DEFAULT_CONFIG };
 
-/**
- * Get current wallet configuration
- */
 export function getWalletConfig(): WalletConfiguration {
   return walletConfig;
 }

package/src/domains/wallet/presentation/hooks/useTransactionHistory.ts

@@ -1,6 +1,6 @@
 import { useQuery } from "@umituz/react-native-design-system";
 import { useMemo } from "react";
-import { useAuthStore, selectUserId } from "@umituz/react-native-auth";
+import { useAuthStore, selectUserId, selectIsAnonymous } from "@umituz/react-native-auth";
 import { NO_CACHE_QUERY_CONFIG } from "../../../../shared/infrastructure/react-query/queryConfig";
 import type {
   CreditLog,
@@ -31,16 +31,19 @@ export function useTransactionHistory({
   limit = 50,
 }: UseTransactionHistoryParams): UseTransactionHistoryResult {
   const userId = useAuthStore(selectUserId);
+  const isAnonymous = useAuthStore(selectIsAnonymous);
 
   const repository = useMemo(
     () => new TransactionRepository(config),
     [config]
   );
 
+  const isUserRegistered = !!userId && !isAnonymous;
+
   const { data, isLoading, error, refetch } = useQuery({
     queryKey: [...transactionQueryKeys.user(userId ?? ""), limit],
     queryFn: async () => {
-      if (!userId) return [];
+      if (!userId || isAnonymous) return [];
 
       const result = await repository.getTransactions({
         userId,
@@ -53,7 +56,7 @@ export function useTransactionHistory({
 
       return result.data ?? [];
     },
-    enabled: !!userId,
+    enabled: isUserRegistered,
     ...NO_CACHE_QUERY_CONFIG,
   });
 

package/src/domains/wallet/presentation/hooks/useWallet.ts

@@ -1,10 +1,3 @@
-/**
- * useWallet Hook
- *
- * Orchestration hook for wallet functionality.
- * Combines balance, transactions, and purchase state.
- */
-
 import { useCallback, useMemo } from "react";
 import { useCredits } from "../../../credits/presentation/useCredits";
 import {

package/src/domains/wallet/utils/transactionIconMap.ts

@@ -1,8 +1,3 @@
-/**
- * Transaction Icon Mapping Utility
- * Maps transaction reasons to their corresponding icons
- */
-
 import type { TransactionReason } from "../domain/types/transaction.types";
 
 const ICON_MAP: Record<TransactionReason, string> = {
@@ -16,11 +11,6 @@ const ICON_MAP: Record<TransactionReason, string> = {
   expired: "clock",
 };
 
-/**
- * Get icon name for a transaction reason
- * @param reason - Transaction reason type
- * @returns Icon name for the transaction
- */
 export function getTransactionIcon(reason: TransactionReason): string {
   return ICON_MAP[reason] || "circle";
 }

package/src/global.d.ts

@@ -1,11 +1,5 @@
-/**
- * Global type declarations for React Native environment
- */
-
-/** React Native development flag */
 declare const __DEV__: boolean;
 
-/** Extend NodeJS namespace for React Native compatibility */
 declare namespace NodeJS {
   interface Global {
     __DEV__: boolean;

package/src/index.ts

@@ -1,7 +1,3 @@
-/**
- * React Native Subscription - Public API
- */
-
 // Domain Layer - Constants & Types
 export * from "./domains/subscription/core/SubscriptionConstants";
 export {
@@ -112,6 +108,7 @@ export type { PurchaseLoadingOverlayProps } from "./domains/subscription/present
 // Init Module Factory
 export {
   createSubscriptionInitModule,
+  cleanupSubscriptionModule,
   type SubscriptionInitModuleConfig,
 } from './init';
 

package/src/init/createSubscriptionInitModule.ts

@@ -7,6 +7,15 @@ export interface SubscriptionInitModuleConfig extends Omit<SubscriptionInitConfi
   dependsOn?: string[];
 }
 
+let subscriptionCleanup: (() => void) | null = null;
+
+export function cleanupSubscriptionModule(): void {
+  if (subscriptionCleanup) {
+    subscriptionCleanup();
+    subscriptionCleanup = null;
+  }
+}
+
 export function createSubscriptionInitModule(config: SubscriptionInitModuleConfig): InitModule {
   const { getApiKey, critical = false, dependsOn = ['auth'], ...subscriptionConfig } = config;
 
@@ -21,9 +30,10 @@ export function createSubscriptionInitModule(config: SubscriptionInitModuleConfi
           return true;
         }
 
-        await initializeSubscription({ apiKey, ...subscriptionConfig });
+        subscriptionCleanup = await initializeSubscription({ apiKey, ...subscriptionConfig });
         return true;
-      } catch {
+      } catch (error) {
+        console.error('[SubscriptionInitModule] Initialization failed:', error instanceof Error ? error.message : String(error));
         return false;
       }
     },

package/src/init/index.ts

@@ -1,9 +1,5 @@
-/**
- * Subscription Init Module
- * Provides factory for creating app initialization modules
- */
-
 export {
   createSubscriptionInitModule,
+  cleanupSubscriptionModule,
   type SubscriptionInitModuleConfig,
 } from './createSubscriptionInitModule';

package/src/presentation/hooks/feedback/useFeedbackSubmit.ts

@@ -1,8 +1,3 @@
-/**
- * Feedback Submit Hooks
- * React hooks for submitting feedback to Firestore
- */
-
 import { useCallback } from "react";
 import { useAuth } from "@umituz/react-native-auth";
 import {
@@ -16,9 +11,6 @@ export interface UsePaywallFeedbackSubmitOptions {
   onComplete?: () => void;
 }
 
-/**
- * Hook for submitting paywall decline feedback
- */
 export function usePaywallFeedbackSubmit(
   options: UsePaywallFeedbackSubmitOptions = {}
 ) {
@@ -63,9 +55,6 @@ export interface UseSettingsFeedbackSubmitOptions {
   onError?: (error: Error) => void;
 }
 
-/**
- * Hook for submitting general settings feedback
- */
 export function useSettingsFeedbackSubmit(
   options: UseSettingsFeedbackSubmitOptions = {}
 ) {

package/src/shared/application/FeedbackService.ts

@@ -1,11 +1,5 @@
-/**
- * Feedback Service
- * Handles feedback submission to Firestore
- * Feedback is stored under users/{userId}/feedback/{feedbackId}
- */
-
 import { collection, addDoc, doc } from "firebase/firestore";
-import { getFirestore } from "@umituz/react-native-firebase";
+import { getFirestore, serverTimestamp } from "@umituz/react-native-firebase";
 
 interface FeedbackData {
   userId: string | null;
@@ -22,10 +16,6 @@ export interface FeedbackSubmitResult {
   error?: Error;
 }
 
-/**
- * Submit feedback to Firestore
- * Stores under users/{userId}/feedback
- */
 async function submitFeedback(
   data: FeedbackData
 ): Promise<FeedbackSubmitResult> {
@@ -40,8 +30,6 @@ async function submitFeedback(
   }
 
   try {
-    const now = new Date().toISOString();
-
     const userDocRef = doc(db, "users", data.userId);
     const feedbackCollectionRef = collection(userDocRef, "feedback");
 
@@ -52,8 +40,8 @@ async function submitFeedback(
       description: data.description,
       rating: data.rating ?? null,
       status: data.status ?? "pending",
-      createdAt: now,
-      updatedAt: now,
+      createdAt: serverTimestamp(),
+      updatedAt: serverTimestamp(),
     });
 
     return { success: true };
@@ -65,9 +53,6 @@ async function submitFeedback(
   }
 }
 
-/**
- * Submit paywall decline feedback
- */
 export async function submitPaywallFeedback(
   userId: string | null,
   userEmail: string | null,
@@ -82,9 +67,6 @@ export async function submitPaywallFeedback(
   });
 }
 
-/**
- * Submit general settings feedback
- */
 export async function submitSettingsFeedback(
   userId: string | null,
   userEmail: string | null,

package/src/shared/application/ports/ISubscriptionRepository.ts

@@ -1,7 +1,3 @@
-/**
- * ISubscriptionRepository Interface
- */
-
 import { SubscriptionStatus } from '../../../domains/subscription/core/SubscriptionStatus';
 
 export interface ISubscriptionRepository {

package/src/shared/infrastructure/SubscriptionEventBus.ts

@@ -1,9 +1,5 @@
 type EventCallback<T = unknown> = (data: T) => void;
 
-/**
- * Simple EventBus Implementation
- * Used to decouple services and provide an observer pattern for subscription events.
- */
 class SubscriptionEventBus {
   private static instance: SubscriptionEventBus;
   private listeners: Record<string, EventCallback<any>[]> = {};
@@ -23,13 +19,11 @@ class SubscriptionEventBus {
     }
     this.listeners[event].push(callback);
 
-    // Return unsubscribe function
     return () => {
       const listeners = this.listeners[event];
       if (listeners) {
         this.listeners[event] = listeners.filter(l => l !== callback);
 
-        // Clean up empty event arrays to prevent memory leak
         if (this.listeners[event].length === 0) {
           delete this.listeners[event];
         }
@@ -53,10 +47,6 @@ class SubscriptionEventBus {
     });
   }
 
-  /**
-   * Clear all listeners for a specific event or all events
-   * Useful for cleanup during testing or app state reset
-   */
   clear(event?: string): void {
     if (event) {
       delete this.listeners[event];
@@ -65,9 +55,6 @@ class SubscriptionEventBus {
     }
   }
 
-  /**
-   * Get listener count for debugging
-   */
   getListenerCount(event?: string): number {
     if (event) {
       return this.listeners[event]?.length ?? 0;

package/src/shared/infrastructure/firestore/collectionUtils.ts

@@ -1,8 +1,3 @@
-/**
- * Firestore Collection Utilities
- * Shared utilities for building Firestore collection and document references
- */
-
 import { collection, doc } from "firebase/firestore";
 import {
   getFirestore,
@@ -16,10 +11,6 @@ export interface CollectionConfig {
   useUserSubcollection: boolean;
 }
 
-/**
- * Build a collection reference based on configuration
- * Supports both root collections and user subcollections
- */
 export function buildCollectionRef(
   db: Firestore,
   userId: string,
@@ -31,10 +22,6 @@ export function buildCollectionRef(
   return collection(db, config.collectionName);
 }
 
-/**
- * Build a document reference based on configuration
- * Supports both root collections and user subcollections
- */
 export function buildDocRef(
   db: Firestore,
   userId: string,
@@ -44,12 +31,9 @@ export function buildDocRef(
   if (config.useUserSubcollection) {
     return doc(db, "users", userId, config.collectionName, docId);
   }
-  return doc(db, config.collectionName, docId);
+  return doc(db, config.collectionName, userId);
 }
 
-/**
- * Get Firestore instance or throw error
- */
 export function requireFirestore(): Firestore {
   const db = getFirestore();
   if (!db) {

package/src/shared/infrastructure/firestore/index.ts

@@ -1,6 +1,2 @@
-/**
- * Firestore Infrastructure Utilities
- */
-
 export * from "./collectionUtils";
 export * from "./resultUtils";

package/src/shared/infrastructure/firestore/resultUtils.ts

@@ -1,8 +1,3 @@
-/**
- * Result Utilities
- * Shared helpers for working with Result pattern
- */
-
 import type { Result } from "../../utils/Result";
 import { failure } from "../../utils/Result";
 
@@ -11,9 +6,6 @@ interface ApiError {
   code: string;
 }
 
-/**
- * Create a standard error result
- */
 function createErrorResult(
   message: string,
   code: string = "UNKNOWN_ERROR"
@@ -21,12 +13,8 @@ function createErrorResult(
   return failure({ message, code });
 }
 
-/**
- * Map Error to ApiError result
- */
 export function mapErrorToResult<T>(error: unknown): Result<T, ApiError> {
   const message = error instanceof Error ? error.message : "An unknown error occurred";
   const code = error instanceof Error && "code" in error ? String(error.code) : "UNKNOWN_ERROR";
   return createErrorResult(message, code);
 }
-

package/src/shared/infrastructure/react-query/hooks/usePreviousUserCleanup.ts

@@ -1,23 +1,7 @@
-/**
- * User Cache Cleanup Hook
- * Automatically cleans up previous user's query cache when userId changes
- */
-
 import { useEffect, useRef } from "react";
 import type { QueryClient } from "@umituz/react-native-design-system";
 import { isAuthenticated } from "../../../../domains/subscription/utils/authGuards";
 
-/**
- * Cleans up previous user's cache when userId changes (logout or user switch)
- * Prevents data leakage between users
- *
- * @param userId - Current user ID
- * @param queryClient - TanStack Query client
- * @param queryKey - Query key factory function that takes userId
- *
- * @example
- * usePreviousUserCleanup(userId, queryClient, (id) => creditsQueryKeys.user(id));
- */
 export function usePreviousUserCleanup(
   userId: string | null | undefined,
   queryClient: QueryClient,
@@ -29,7 +13,6 @@ export function usePreviousUserCleanup(
     const prevUserId = prevUserIdRef.current;
     prevUserIdRef.current = userId;
 
-    // Clear previous user's cache when userId changes (logout or user switch)
     if (prevUserId !== userId && isAuthenticated(prevUserId)) {
       queryClient.removeQueries({
         queryKey: queryKey(prevUserId),

package/src/shared/infrastructure/react-query/queryConfig.ts

@@ -1,18 +1,3 @@
-/**
- * Shared TanStack Query Configuration
- * Common query configurations to ensure consistency across hooks
- */
-
-/**
- * Configuration for queries that should never cache
- * Used for real-time sensitive data (subscriptions, credits, transactions)
- *
- * - gcTime: 0 - Don't keep unused data in memory
- * - staleTime: 0 - Always consider data stale
- * - refetchOnMount: "always" - Always refetch when component mounts
- * - refetchOnWindowFocus: "always" - Always refetch when window regains focus
- * - refetchOnReconnect: "always" - Always refetch when reconnecting
- */
 export const NO_CACHE_QUERY_CONFIG = {
   gcTime: 0,
   staleTime: 0,

package/src/shared/utils/BaseError.ts

@@ -1,8 +1,3 @@
-/**
- * Base Error Class
- * Common base error for all domain errors
- */
-
 export abstract class BaseError extends Error {
     public readonly code: string;
     public readonly cause?: Error;