@umituz/react-native-subscription 2.37.38 → 2.37.40

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;

package/src/shared/utils/Result.ts

@@ -1,47 +1,33 @@
-/**
- * Result Pattern
- * Type-safe error handling without exceptions.
- * Inspired by Rust's Result<T, E> and functional programming patterns.
- */
-
-/** Success result containing data */
 export interface Success<T> {
   readonly success: true;
   readonly data: T;
   readonly error?: never;
 }
 
-/** Failure result containing error */
 export interface Failure<E = Error> {
   readonly success: false;
   readonly data?: never;
   readonly error: E;
 }
 
-/** Union type representing either success or failure */
 export type Result<T, E = Error> = Success<T> | Failure<E>;
 
-/** Create a success result */
 export function success<T>(data: T): Success<T> {
   return { success: true, data };
 }
 
-/** Create a failure result */
 export function failure<E = Error>(error: E): Failure<E> {
   return { success: false, error };
 }
 
-/** Type guard to check if result is success */
 export function isSuccess<T, E>(result: Result<T, E>): result is Success<T> {
   return result.success === true;
 }
 
-/** Type guard to check if result is failure */
 export function isFailure<T, E>(result: Result<T, E>): result is Failure<E> {
   return result.success === false;
 }
 
-/** Unwrap result or throw if failure */
 export function unwrap<T, E extends Error>(result: Result<T, E>): T {
   if (isSuccess(result)) {
     return result.data;
@@ -49,7 +35,6 @@ export function unwrap<T, E extends Error>(result: Result<T, E>): T {
   throw result.error;
 }
 
-/** Unwrap result or return default value */
 export function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {
   if (isSuccess(result)) {
     return result.data;
@@ -57,7 +42,6 @@ export function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {
   return defaultValue;
 }
 
-/** Map success value to new value */
 export function map<T, U, E>(
   result: Result<T, E>,
   fn: (data: T) => U
@@ -68,7 +52,6 @@ export function map<T, U, E>(
   return result;
 }
 
-/** Chain results (flatMap) */
 export function flatMap<T, U, E>(
   result: Result<T, E>,
   fn: (data: T) => Result<U, E>
@@ -79,7 +62,6 @@ export function flatMap<T, U, E>(
   return result;
 }
 
-/** Execute async function and wrap result */
 export async function tryCatch<T>(
   fn: () => Promise<T>,
   errorMapper?: (error: unknown) => Error
@@ -97,7 +79,6 @@ export async function tryCatch<T>(
   }
 }
 
-/** Execute sync function and wrap result */
 export function tryCatchSync<T>(
   fn: () => T,
   errorMapper?: (error: unknown) => Error
@@ -115,7 +96,6 @@ export function tryCatchSync<T>(
   }
 }
 
-/** Combine multiple results into one */
 export function combine<T, E>(results: Result<T, E>[]): Result<T[], E> {
   const data: T[] = [];
   for (const result of results) {

package/src/shared/utils/dateConverter.ts

@@ -1,13 +1,7 @@
-/**
- * Date Converter Utilities
- * Centralized date conversion and validation logic
- * Handles Date objects, ISO strings, timestamps, and null values safely
- */
-
-/**
- * Safely converts any date-like value to a Date object or null
- * Handles: Date objects, ISO strings, timestamps, null, undefined, invalid values
- */
+import { Timestamp } from "@umituz/react-native-firebase";
+
+type FirestoreTimestamp = ReturnType<typeof Timestamp.fromDate>;
+
 export function toDate(value: Date | string | number | null | undefined): Date | null {
   if (value === null || value === undefined) {
     return null;
@@ -25,64 +19,39 @@ export function toDate(value: Date | string | number | null | undefined): Date |
   return null;
 }
 
-/**
- * Safely converts any date-like value to an ISO string or null
- * Handles: Date objects, ISO strings, timestamps, null, undefined, invalid values
- */
 export function toISOString(value: Date | string | number | null | undefined): string | null {
   if (value === null || value === undefined) {
     return null;
   }
 
-  // If already a string, validate it
   if (typeof value === 'string') {
     const parsed = new Date(value);
-    return isValidDate(parsed) ? value : null;
+    return isValidDate(parsed) ? parsed.toISOString() : null;
   }
 
-  // Convert to Date and then to ISO string
   const date = toDate(value);
   return date ? date.toISOString() : null;
 }
 
-/**
- * Checks if a Date object is valid (not Invalid Date)
- * @internal - Use for internal validation only
- */
 function isValidDate(date: Date): boolean {
   return date instanceof Date && !isNaN(date.getTime());
 }
 
-/**
- * Safely converts a Date or string to a Firestore Timestamp
- * Returns null if the value is invalid
- */
-export function toTimestamp(value: Date | string | number | null | undefined): any {
+export function toTimestamp(value: Date | string | number | null | undefined): FirestoreTimestamp | null {
   const date = toDate(value);
   if (!date) return null;
 
-  // Lazy import to avoid circular dependencies
-  const { Timestamp } = require('firebase/firestore');
   return Timestamp.fromDate(date);
 }
 
-/**
- * Gets current date as ISO string
- */
 export function getCurrentISOString(): string {
   return new Date().toISOString();
 }
 
-/**
- * Gets current date as Date object
- */
 export function getCurrentDate(): Date {
   return new Date();
 }
 
-/**
- * Compares two dates and returns if first is before second
- */
 export function isBefore(date1: Date | string | null | undefined, date2: Date | string | null | undefined): boolean {
   const d1 = toDate(date1);
   const d2 = toDate(date2);
@@ -91,9 +60,6 @@ export function isBefore(date1: Date | string | null | undefined, date2: Date |
   return d1.getTime() < d2.getTime();
 }
 
-/**
- * Compares two dates and returns if first is after second
- */
 export function isAfter(date1: Date | string | null | undefined, date2: Date | string | null | undefined): boolean {
   const d1 = toDate(date1);
   const d2 = toDate(date2);
@@ -102,18 +68,12 @@ export function isAfter(date1: Date | string | null | undefined, date2: Date | s
   return d1.getTime() > d2.getTime();
 }
 
-/**
- * Checks if a date is in the past
- */
 export function isInPast(date: Date | string | null | undefined): boolean {
   const d = toDate(date);
   if (!d) return false;
   return d.getTime() < Date.now();
 }
 
-/**
- * Checks if a date is in the future
- */
 export function isInFuture(date: Date | string | null | undefined): boolean {
   const d = toDate(date);
   if (!d) return false;

package/src/utils/appUtils.ts

@@ -1,18 +1,8 @@
-/**
- * App and Platform Utilities
- */
 import { Platform } from "react-native";
 import Constants from "expo-constants";
 
-/**
- * Development mode flag
- * Safe check for __DEV__ that works in all environments
- */
 export const IS_DEV_MODE = typeof __DEV__ !== "undefined" && __DEV__;
 
-/**
- * Gets the current app version from Expo constants
- */
 export function getAppVersion(): string {
   const version = Constants.expoConfig?.version;
 
@@ -22,9 +12,6 @@ export function getAppVersion(): string {
   return version;
 }
 
-/**
- * Validates if the current platform is supported
- */
 export function validatePlatform(): "ios" | "android" {
   const platform = Platform.OS;
   if (platform !== "ios" && platform !== "android") {
@@ -33,9 +20,6 @@ export function validatePlatform(): "ios" | "android" {
   return platform;
 }
 
-/**
- * Checks if the app is currently in development mode
- */
 export function isDev(): boolean {
   return __DEV__;
 }

package/src/utils/creditMapper.ts

@@ -1,9 +1,6 @@
 import { detectPackageType, type SubscriptionPackageType } from "./packageTypeDetector";
 import type { PackageAllocationMap } from "../domains/credits/core/Credits";
 
-/**
- * Get credit allocation for a package type from provided allocations map
- */
 export function getCreditAllocation(
   packageType: SubscriptionPackageType,
   allocations?: PackageAllocationMap
@@ -12,10 +9,6 @@ export function getCreditAllocation(
   return allocations[packageType]?.credits ?? null;
 }
 
-/**
- * Create credit amounts mapping for PaywallModal from RevenueCat packages
- * Maps product.identifier to credit amount using dynamic allocations
- */
 export function createCreditAmountsFromPackages(
   packages: Array<{ product: { identifier: string } }>,
   allocations?: PackageAllocationMap

package/src/utils/dateUtils.compare.ts

@@ -1,14 +1,6 @@
-/**
- * Date Utilities - Comparison Operations
- * Date comparison and calculation functions
- */
-
 import { isValidDate, isPast, currentDate } from "./dateUtils.core";
 import { addDays } from "./dateUtils.math";
 
-/**
- * Calculate difference in days between two dates
- */
 export function daysBetween(date1: Date | string | number, date2: Date | string | number): number {
   const d1 = new Date(date1);
   const d2 = new Date(date2);
@@ -16,10 +8,6 @@ export function daysBetween(date1: Date | string | number, date2: Date | string
   return Math.floor(diffTime / (1000 * 60 * 60 * 24));
 }
 
-/**
- * Calculate days remaining until a date
- * Returns null if date is in the past or invalid
- */
 export function daysUntil(date: Date | string | number): number | null {
   const target = new Date(date);
   if (!isValidDate(target) || isPast(target)) {
@@ -28,9 +16,6 @@ export function daysUntil(date: Date | string | number): number | null {
   return daysBetween(currentDate(), target);
 }
 
-/**
- * Check if two dates are the same day
- */
 export function isSameDay(date1: Date | string | number, date2: Date | string | number): boolean {
   const d1 = new Date(date1);
   const d2 = new Date(date2);
@@ -41,24 +26,15 @@ export function isSameDay(date1: Date | string | number, date2: Date | string |
   );
 }
 
-/**
- * Check if a date is today
- */
 export function isToday(date: Date | string | number): boolean {
   return isSameDay(date, currentDate());
 }
 
-/**
- * Check if a date is yesterday
- */
 export function isYesterday(date: Date | string | number): boolean {
   const yesterday = addDays(currentDate(), -1);
   return isSameDay(date, yesterday);
 }
 
-/**
- * Check if a date is tomorrow
- */
 export function isTomorrow(date: Date | string | number): boolean {
   const tomorrow = addDays(currentDate(), 1);
   return isSameDay(date, tomorrow);

package/src/utils/dateUtils.core.ts

@@ -1,56 +1,26 @@
-/**
- * Date Utilities - Core Operations
- * Basic date manipulation and validation functions
- */
-
 export type DateLike = Date | string | number;
 
-/**
- * Checks if a date is in the past (strictly before now)
- * @param date - The date to check
- * @returns true if date < now, false if date >= now
- * @note A date exactly equal to Date.now() returns false (not past)
- */
 export function isPast(date: DateLike): boolean {
   const d = new Date(date);
   return d.getTime() < Date.now();
 }
 
-/**
- * Checks if a date is in the future (strictly after now)
- * @param date - The date to check
- * @returns true if date > now, false if date <= now
- * @note A date exactly equal to Date.now() returns false (not future)
- */
 export function isFuture(date: DateLike): boolean {
   const d = new Date(date);
   return d.getTime() > Date.now();
 }
 
-/**
- * Checks if a date is approximately now (within margin)
- * Useful for handling edge cases where isPast/isFuture might flicker
- * @param date - The date to check
- * @param marginMs - Margin in milliseconds (default: 1000ms)
- * @returns true if date is within margin of Date.now()
- */
 export function isNow(date: DateLike, marginMs: number = 1000): boolean {
   const d = new Date(date);
   const diff = Math.abs(d.getTime() - Date.now());
   return diff <= marginMs;
 }
 
-/**
- * Checks if a date is valid
- */
 export function isValidDate(date: DateLike): boolean {
   const d = date instanceof Date ? date : new Date(date);
   return !isNaN(d.getTime());
 }
 
-/**
- * Converts various timestamp formats to a safe Date object
- */
 export function toSafeDate(ts: unknown): Date | null {
   if (!ts) return null;
   if (typeof ts === "object" && ts !== null && "toDate" in ts && typeof ts.toDate === "function") {
@@ -64,23 +34,14 @@ export function toSafeDate(ts: unknown): Date | null {
   return null;
 }
 
-/**
- * Formats a date to ISO string safely
- */
 export function formatISO(date: Date | null): string | null {
   return date ? date.toISOString() : null;
 }
 
-/**
- * Get current timestamp in milliseconds
- */
 export function now(): number {
   return Date.now();
 }
 
-/**
- * Get current date
- */
 export function currentDate(): Date {
   return new Date();
 }