@umituz/react-native-subscription 2.37.39 → 2.37.40

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();
 }

package/src/utils/dateUtils.format.ts

@@ -1,13 +1,5 @@
-/**
- * Date Utilities - Formatting
- * Date display and formatting functions
- */
-
 import type { DateLike } from "./dateUtils.core";
 
-/**
- * Format date to locale string
- */
 export function formatLocale(
   date: DateLike,
   options?: Intl.DateTimeFormatOptions,
@@ -20,9 +12,6 @@ export function formatLocale(
   return d.toLocaleDateString(locale, options);
 }
 
-/**
- * Format date to relative time (e.g., "2 days ago", "in 3 hours")
- */
 export function formatRelative(date: DateLike, now: Date = new Date()): string {
   const target = new Date(date);
   if (isNaN(target.getTime())) {
@@ -49,37 +38,22 @@ export function formatRelative(date: DateLike, now: Date = new Date()): string {
   return rtf.format(diffSecs, "second");
 }
 
-/**
- * Format date to short date string (e.g., "1/1/2024")
- */
 export function formatShort(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { month: "numeric", day: "numeric", year: "numeric" }, locale);
 }
 
-/**
- * Format date to medium date string (e.g., "Jan 1, 2024")
- */
 export function formatMedium(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { month: "short", day: "numeric", year: "numeric" }, locale);
 }
 
-/**
- * Format date to long date string (e.g., "January 1, 2024")
- */
 export function formatLong(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { month: "long", day: "numeric", year: "numeric" }, locale);
 }
 
-/**
- * Format date to time string
- */
 export function formatTime(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { hour: "numeric", minute: "numeric" }, locale);
 }
 
-/**
- * Format date to date and time string
- */
 export function formatDateTime(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(
     date,
@@ -88,9 +62,6 @@ export function formatDateTime(date: DateLike, locale: string = "en-US"): string
   );
 }
 
-/**
- * Convert milliseconds to human-readable duration
- */
 export function formatDuration(ms: number): string {
   const seconds = Math.floor(ms / 1000);
   const minutes = Math.floor(seconds / 60);
@@ -109,30 +80,18 @@ export function formatDuration(ms: number): string {
   return `${seconds}s`;
 }
 
-/**
- * Format date to weekday name (e.g., "Monday")
- */
 export function formatWeekday(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { weekday: "long" }, locale);
 }
 
-/**
- * Format date to short weekday name (e.g., "Mon")
- */
 export function formatWeekdayShort(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { weekday: "short" }, locale);
 }
 
-/**
- * Format date to month name (e.g., "January")
- */
 export function formatMonth(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { month: "long" }, locale);
 }
 
-/**
- * Format date to short month name (e.g., "Jan")
- */
 export function formatMonthShort(date: DateLike, locale: string = "en-US"): string {
   return formatLocale(date, { month: "short" }, locale);
 }

package/src/utils/dateUtils.math.ts

@@ -1,83 +1,51 @@
-/**
- * Date Utilities - Math Operations
- * Date arithmetic and manipulation functions
- */
-
 import type { DateLike } from "./dateUtils.core";
 
-/**
- * Add days to a date
- */
 export function addDays(date: DateLike, days: number): Date {
   const result = new Date(date);
   result.setDate(result.getDate() + days);
   return result;
 }
 
-/**
- * Add hours to a date
- */
 export function addHours(date: DateLike, hours: number): Date {
   const result = new Date(date);
   result.setHours(result.getHours() + hours);
   return result;
 }
 
-/**
- * Add minutes to a date
- */
 export function addMinutes(date: DateLike, minutes: number): Date {
   const result = new Date(date);
   result.setMinutes(result.getMinutes() + minutes);
   return result;
 }
 
-/**
- * Add months to a date
- */
 export function addMonths(date: DateLike, months: number): Date {
   const result = new Date(date);
   result.setMonth(result.getMonth() + months);
   return result;
 }
 
-/**
- * Add years to a date
- */
 export function addYears(date: DateLike, years: number): Date {
   const result = new Date(date);
   result.setFullYear(result.getFullYear() + years);
   return result;
 }
 
-/**
- * Subtract days from a date
- */
 export function subtractDays(date: DateLike, days: number): Date {
   return addDays(date, -days);
 }
 
-/**
- * Get start of day (midnight)
- */
 export function startOfDay(date: DateLike): Date {
   const d = new Date(date);
   d.setHours(0, 0, 0, 0);
   return d;
 }
 
-/**
- * Get end of day (23:59:59.999)
- */
 export function endOfDay(date: DateLike): Date {
   const d = new Date(date);
   d.setHours(23, 59, 59, 999);
   return d;
 }
 
-/**
- * Get start of week (Sunday)
- */
 export function startOfWeek(date: DateLike): Date {
   const d = new Date(date);
   const day = d.getDay();
@@ -85,9 +53,6 @@ export function startOfWeek(date: DateLike): Date {
   return new Date(d.setDate(diff));
 }
 
-/**
- * Get end of week (Saturday)
- */
 export function endOfWeek(date: DateLike): Date {
   const d = new Date(date);
   const day = d.getDay();
@@ -95,17 +60,11 @@ export function endOfWeek(date: DateLike): Date {
   return new Date(d.setDate(diff));
 }
 
-/**
- * Get start of month
- */
 export function startOfMonth(date: DateLike): Date {
   const d = new Date(date);
   return new Date(d.getFullYear(), d.getMonth(), 1);
 }
 
-/**
- * Get end of month
- */
 export function endOfMonth(date: DateLike): Date {
   const d = new Date(date);
   return new Date(d.getFullYear(), d.getMonth() + 1, 0);

package/src/utils/dateUtils.ts

@@ -1,8 +1,3 @@
-/**
- * Date Utilities
- * Re-exports all date utility modules
- */
-
 export type { DateLike } from "./dateUtils.core";
 export * from "./dateUtils.core";
 export * from "./dateUtils.compare";

package/src/utils/packagePeriodUtils.ts

@@ -1,13 +1,5 @@
-/**
- * Package Period Utilities
- * Helper functions for working with subscription periods
- */
-
 import type { PurchasesPackage } from "react-native-purchases";
 
-/**
- * Get period label from subscription period string
- */
 export const getPeriodLabel = (period: string | null | undefined): string => {
     if (!period) return "";
     if (period.includes("Y") || period.includes("year")) return "yearly";
@@ -17,33 +9,21 @@ export const getPeriodLabel = (period: string | null | undefined): string => {
     return "";
 };
 
-/**
- * Check if a package has a yearly subscription period
- */
 export const isYearlyPackage = (pkg: PurchasesPackage): boolean => {
     const period = pkg.product.subscriptionPeriod;
     return period?.includes("Y") || period?.includes("year") || false;
 };
 
-/**
- * Check if a package has a monthly subscription period
- */
 export const isMonthlyPackage = (pkg: PurchasesPackage): boolean => {
     const period = pkg.product.subscriptionPeriod;
     return period?.includes("M") || period?.includes("month") || false;
 };
 
-/**
- * Check if a package has a weekly subscription period
- */
 export const isWeeklyPackage = (pkg: PurchasesPackage): boolean => {
     const period = pkg.product.subscriptionPeriod;
     return period?.includes("W") || period?.includes("week") || false;
 };
 
-/**
- * Find the first yearly package in an array of packages
- */
 export const findYearlyPackage = (
     packages: PurchasesPackage[]
 ): PurchasesPackage | undefined => {