@umituz/react-native-subscription 2.37.38 → 2.37.40

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 => {

package/src/utils/packageTypeDetector.ts

@@ -1,27 +1,12 @@
-/**
- * Package Type Detector
- * Detects subscription package type from RevenueCat package identifier
- */
-
 import { PACKAGE_TYPE, type PackageType } from "../domains/subscription/core/SubscriptionConstants";
 
 export type SubscriptionPackageType = PackageType;
 
-/**
- * Check if identifier is a credit package (consumable purchase)
- * Credit packages use a different system and don't need type detection
- */
 export function isCreditPackage(identifier: string): boolean {
   if (!identifier) return false;
-  // Matches "credit" as a word or part of a common naming pattern
-  // More strict to avoid false positives (e.g. "accredited")
   return /(?:^|[._-])credit(?:$|[._-])/i.test(identifier);
 }
 
-/**
- * Detect package type from product identifier
- * Supports common RevenueCat naming patterns with regex for better accuracy
- */
 export function detectPackageType(productIdentifier: string): SubscriptionPackageType {
   if (!productIdentifier) {
     return PACKAGE_TYPE.UNKNOWN;
@@ -29,27 +14,22 @@ export function detectPackageType(productIdentifier: string): SubscriptionPackag
 
   const normalized = productIdentifier.toLowerCase();
 
-  // Skip credit packages silently - they use creditPackageConfig instead
   if (isCreditPackage(normalized)) {
     return PACKAGE_TYPE.UNKNOWN;
   }
 
-  // Weekly detection: matches "weekly" or "week" as distinct parts of the ID
   if (/\bweekly?\b|_week_|-week-|\.week\./i.test(normalized)) {
     return PACKAGE_TYPE.WEEKLY;
   }
 
-  // Monthly detection: matches "monthly" or "month"
   if (/\bmonthly?\b|_month_|-month-|\.month\./i.test(normalized)) {
     return PACKAGE_TYPE.MONTHLY;
   }
 
-  // Yearly detection: matches "yearly", "year", or "annual"
   if (/\byearly?\b|_year_|-year-|\.year\.|annual/i.test(normalized)) {
     return PACKAGE_TYPE.YEARLY;
   }
-  
-  // Lifetime detection: matches "lifetime"
+
   if (/\blifetime\b|_lifetime_|-lifetime-|\.lifetime\./i.test(normalized)) {
       return PACKAGE_TYPE.LIFETIME;
   }

package/src/utils/premiumStatusUtils.ts

@@ -1,27 +1,14 @@
-/**
- * Premium Status Utilities
- *
- * Core premium status determination logic
- */
-
 import type { PremiumStatusFetcher } from './types';
 
-
-/**
- * Get isPremium value with centralized logic
- */
 export function getIsPremium(
   isAnonymous: boolean,
   userId: string | null,
   isPremiumOrFetcher: boolean | PremiumStatusFetcher,
 ): Promise<boolean> {
-  // Anonymous users NEVER have premium
   if (isAnonymous || userId === null) return Promise.resolve(false);
 
-  // Sync mode: return the provided isPremium value
   if (typeof isPremiumOrFetcher === 'boolean') return Promise.resolve(isPremiumOrFetcher);
 
-  // Async mode: fetch premium status
   return (async () => {
     try {
       return await isPremiumOrFetcher.isPremium(userId!);
@@ -31,4 +18,4 @@ export function getIsPremium(
       );
     }
   })();
-}
+}

package/src/utils/priceUtils.ts

@@ -1,14 +1,3 @@
-/**
- * Price Formatting Utilities
- * Apple App Store Guideline 3.1.2 Compliance
- */
-
-/**
- * Format price for display
- * @param price - Price value
- * @param currencyCode - Currency code (e.g., 'USD', 'EUR')
- * @returns Formatted price string
- */
 export function formatPrice(price: number, currencyCode: string): string {
   try {
     return new Intl.NumberFormat('en-US', {
@@ -28,35 +17,11 @@ const PERIOD_SUFFIX_MAP: Record<string, string> = {
   yearly: '/year',
 };
 
-/**
- * Extract billing period suffix from package identifier
- * Apple App Store Guideline 3.1.2 Compliance:
- * - Displays billing frequency clearly and conspicuously
- * - Format: /week, /month, /year
- *
- * @param identifier - RevenueCat package identifier (e.g., "$rc_weekly", "$rc_monthly", "$rc_annual")
- * @returns Billing period suffix (e.g., "/week", "/month", "/year") or empty string
- */
 export function getBillingPeriodSuffix(identifier: string): string {
   const packageType = detectPackageType(identifier);
   return PERIOD_SUFFIX_MAP[packageType] ?? '';
 }
 
-/**
- * Format price with billing period
- * Apple App Store Guideline 3.1.2 Compliance:
- * - Combines price with billing frequency for clear display
- * - Format: $2.99/week, $14.99/month, $39.99/year
- *
- * RevenueCat Best Practice:
- * - Follows recommended price_per_period format
- * - Clear and conspicuous billing frequency display
- *
- * @param price - Price value
- * @param currencyCode - Currency code (e.g., 'USD', 'EUR')
- * @param identifier - RevenueCat package identifier
- * @returns Formatted price with billing period (e.g., "$2.99/week")
- */
 export function formatPriceWithPeriod(
   price: number,
   currencyCode: string,

package/src/utils/tierUtils.ts

@@ -1,12 +1,5 @@
-/**
- * User Tier Core Utilities
- *
- * Core logic for determining user tier and premium status
- */
-
 import { USER_TIER, type UserTierInfo } from './types';
 
-
 export function getUserTierInfo(
   isAnonymous: boolean,
   userId: string | null,
@@ -38,4 +31,4 @@ export function checkPremiumAccess(
 ): boolean {
   if (isAnonymous || userId === null) return false;
   return isPremium;
-}
+}

package/src/utils/types.ts

@@ -1,40 +1,16 @@
-/**
- * User Tier Types
- *
- * Type definitions for user tier system
- */
-
 import { USER_TIER, type UserTierType } from '../domains/subscription/core/SubscriptionConstants';
 
 export type UserTier = UserTierType;
 export { USER_TIER };
 
 export interface UserTierInfo {
-  /** User tier classification */
   tier: UserTier;
-
-  /** Whether user has premium access */
   isPremium: boolean;
-
-  /** Whether user is anonymous (not authenticated) */
   isAnonymous: boolean;
-
-  /** Whether user is authenticated */
   isAuthenticated: boolean;
-
-  /** User ID (null for anonymous users) */
   userId: string | null;
 }
 
-/**
- * Premium status fetcher interface
- * Apps should implement this to provide premium status from their database
- */
 export interface PremiumStatusFetcher {
-  /**
-   * Check if user has active premium subscription
-   * @param userId - User ID (never null, this is only called for authenticated users)
-   * @returns Promise<boolean> - Whether user has premium subscription
-   */
   isPremium(userId: string): Promise<boolean>;
-}
+}

package/src/utils/validation.ts

@@ -1,9 +1,3 @@
-/**
- * User Tier Validation Utilities
- *
- * Type guards and validation functions for user tier system
- */
-
 import { USER_TIER, type UserTier, type UserTierInfo } from './types';
 
 export function isValidUserTier(value: unknown): value is UserTier {
@@ -20,4 +14,4 @@ export function isUserTierInfo(value: unknown): value is UserTierInfo {
     typeof obj.isAuthenticated === 'boolean' &&
     (obj.userId === null || typeof obj.userId === 'string')
   );
-}
+}

package/src/domains/README.md

@@ -1,52 +0,0 @@
-# Domains
-
-Specialized domain modules implementing specific business logic and features.
-
-## Location
-
-`src/domains/`
-
-## Strategy
-
-Implements Domain-Driven Design (DDD) principles with self-contained domains. Each domain includes domain layer (business logic, entities, value objects), infrastructure layer (external integrations, repositories), and presentation layer (domain-specific hooks and components).
-
-## Restrictions
-
-### REQUIRED
-
-- Domains MUST NOT directly depend on each other
-- MUST use well-defined interfaces between layers
-- MUST depend on abstractions, not concretions (Dependency Inversion)
-- All domains MUST be testable in isolation
-
-### PROHIBITED
-
-- MUST NOT share domain logic between domains (use shared kernel if needed)
-- MUST NOT create circular dependencies between domains
-- MUST NOT bypass domain layer from presentation
-- MUST NOT expose infrastructure details to other domains
-
-### CRITICAL
-
-- Always validate invariants at domain boundaries
-- Always implement domain errors for business rule violations
-- Never allow inconsistent domain state
-- Must implement proper transaction boundaries
-- Always sanitize inputs from external sources
-
-## AI Agent Guidelines
-
-When working with domains:
-1. Always respect domain boundaries
-2. Always use dependency inversion
-3. Always implement domain-specific errors
-4. Always validate invariants at boundaries
-5. Never create circular dependencies
-
-## Related Documentation
-
-- [Wallet Domain](wallet/README.md)
-- [Paywall Domain](paywall/README.md)
-- [Config Domain](config/README.md)
-- [Domain Layer](../domain/README.md)
-- [Infrastructure](../infrastructure/README.md)

package/src/domains/config/domain/README.md

@@ -1,37 +0,0 @@
-# Config Domain
-
-## Location
-Domain layer for configuration management.
-
-## Strategy
-This directory contains the business logic and domain models for subscription and feature configuration.
-
-## Restrictions
-
-### REQUIRED
-- Must use entities for domain models
-- Must validate in constructor
-- Must keep entities immutable
-
-### PROHIBITED
-- DO NOT bypass entity validation
-- DO NOT mutate entities after creation
-- DO NOT leak domain logic to application layer
-
-### CRITICAL SAFETY
-- All business rules MUST be enforced in entities
-- Validation failures MUST fail fast
-- Type safety MUST be maintained at compile time
-
-## AI Agent Guidelines
-1. When creating new configurations, use existing entities
-2. Always validate configuration data through entity constructors
-3. Encapsulate business logic within domain entities
-4. Implement proper equality methods for value objects
-5. Provide formatting methods for display purposes
-6. Maintain strict type safety with TypeScript
-
-## Related Documentation
-- [Config Domain](../../README.md)
-- [Config Entities](./entities/README.md)
-- [Config Value Objects](./value-objects/README.md)

package/src/domains/config/domain/entities/README.md

@@ -1,41 +0,0 @@
-# Config Domain Entities
-
-## Location
-Domain entities for configuration management.
-
-## Strategy
-This directory contains entity classes representing configuration concepts like packages, features, and paywalls with strict validation and immutability.
-
-## Restrictions
-
-### REQUIRED
-- Must validate all configuration in constructor
-- Must treat entities as immutable
-- Must provide clear error messages
-- Must use TypeScript strict mode
-
-### PROHIBITED
-- DO NOT modify entities after creation
-- DO NOT bypass validation logic
-- DO NOT expose mutable internal state
-- DO NOT allow invalid configuration
-
-### CRITICAL SAFETY
-- All validation MUST happen in constructor
-- Entities MUST fail fast on invalid input
-- Error messages MUST be descriptive
-- Factory functions MUST provide valid defaults
-
-## AI Agent Guidelines
-1. Always validate configuration data in entity constructors
-2. Treat all entities as immutable values
-3. Keep business logic encapsulated within entities
-4. Provide factory functions for common configurations
-5. Test validation logic thoroughly
-6. Use TypeScript strict types for all properties
-7. Return descriptive error messages for validation failures
-
-## Related Documentation
-- [Config Domain](../README.md)
-- [Config Value Objects](../value-objects/README.md)
-- [Config Utils](../../utils/README.md)

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

@@ -1,24 +0,0 @@
-import { ICreditStrategy, type CreditAllocationParams } from "./ICreditStrategy";
-
-/**
- * Strategy for status synchronization (app open, auth state changes).
- * ONLY preserves existing credits. NEVER allocates new credits.
- * New credits are ONLY allocated by purchase and renewal flows.
- */
-export class SyncCreditStrategy implements ICreditStrategy {
-    canHandle(params: CreditAllocationParams): boolean {
-        return params.isStatusSync;
-    }
-
-    execute(params: CreditAllocationParams): number {
-        // Status sync only preserves existing credits, never allocates new ones
-        const existingCredits = params.existingData?.credits;
-        if (typeof existingCredits === 'number' && existingCredits >= 0) {
-            return existingCredits;
-        }
-
-        // No existing credits = no document = return 0
-        // Credits are only allocated through purchase/renewal flows
-        return 0;
-    }
-}