@umituz/react-native-subscription 2.14.99 → 2.14.100

package/src/revenuecat/domain/value-objects/README.md

@@ -1,441 +1,41 @@
 # RevenueCat Domain Value Objects
 
+## Location
 Value objects for RevenueCat integration.
 
-## Overview
-
-This directory contains value objects - immutable types that represent concepts in the RevenueCat domain with no identity. Value objects are defined by their attributes rather than an identity.
-
-## Value Objects
-
-### EntitlementId
-
-Represents an entitlement identifier.
-
-```typescript
-class EntitlementId {
-  private readonly value: string;
-
-  constructor(value: string) {
-    if (!value || value.trim().length === 0) {
-      throw new Error('Entitlement ID cannot be empty');
-    }
-    this.value = value.trim();
-  }
-
-  getValue(): string {
-    return this.value;
-  }
-
-  equals(other: EntitlementId): boolean {
-    return this.value === other.value;
-  }
-
-  toString(): string {
-    return this.value;
-  }
-}
-
-// Usage
-const premiumId = new EntitlementId('premium');
-```
-
-### OfferingId
-
-Represents an offering identifier.
-
-```typescript
-class OfferingId {
-  private readonly value: string;
-
-  constructor(value: string) {
-    const validIds = ['default', 'annual_offer', 'lifetime_offer'];
-    if (!validIds.includes(value)) {
-      throw new Error(`Invalid offering ID: ${value}`);
-    }
-    this.value = value;
-  }
-
-  getValue(): string {
-    return this.value;
-  }
-
-  isDefault(): boolean {
-    return this.value === 'default';
-  }
-
-  equals(other: OfferingId): boolean {
-    return this.value === other.value;
-  }
-
-  toString(): string {
-    return this.value;
-  }
-}
-
-// Usage
-const defaultOffering = new OfferingId('default');
-const annualOffering = new OfferingId('annual_offer');
-```
-
-### PackageIdentifier
-
-Represents a package identifier.
-
-```typescript
-class PackageIdentifier {
-  private readonly value: string;
-
-  constructor(value: string) {
-    if (!value || value.trim().length === 0) {
-      throw new Error('Package identifier cannot be empty');
-    }
-    this.value = value;
-  }
-
-  getValue(): string {
-    return this.value;
-  }
-
-  getType(): PackageType {
-    if (this.value.includes('monthly')) return 'monthly';
-    if (this.value.includes('annual')) return 'annual';
-    if (this.value.includes('lifetime')) return 'lifetime';
-    if (this.value.includes('weekly')) return 'weekly';
-    return 'single_purchase';
-  }
-
-  isSubscription(): boolean {
-    const type = this.getType();
-    return type === 'monthly' || type === 'annual' || type === 'weekly';
-  }
-
-  equals(other: PackageIdentifier): boolean {
-    return this.value === other.value;
-  }
-
-  toString(): string {
-    return this.value;
-  }
-}
-
-// Usage
-const monthlyPackage = new PackageIdentifier('$rc_monthly');
-console.log(monthlyPackage.getType()); // 'monthly'
-console.log(monthlyPackage.isSubscription()); // true
-```
-
-### ProductId
-
-Represents a product identifier.
-
-```typescript
-class ProductId {
-  private readonly value: string;
-
-  constructor(value: string) {
-    if (!value || value.trim().length === 0) {
-      throw new Error('Product ID cannot be empty');
-    }
-    this.value = value;
-  }
-
-  getValue(): string {
-    return this.value;
-  }
-
-  equals(other: ProductId): boolean {
-    return this.value === other.value;
-  }
-
-  toString(): string {
-    return this.value;
-  }
-}
-
-// Usage
-const productId = new ProductId('com.app.premium.monthly');
-```
-
-### Money
-
-Represents monetary value with currency.
-
-```typescript
-class Money {
-  private readonly amount: number;
-  private readonly currency: string;
-
-  constructor(amount: number, currency: string) {
-    if (amount < 0) {
-      throw new Error('Amount cannot be negative');
-    }
-    if (currency.length !== 3) {
-      throw new Error('Currency must be ISO 4217 code (3 letters)');
-    }
-    this.amount = amount;
-    this.currency = currency.toUpperCase();
-  }
-
-  getAmount(): number {
-    return this.amount;
-  }
-
-  getCurrency(): string {
-    return this.currency;
-  }
-
-  format(locale: string = 'en-US'): string {
-    return new Intl.NumberFormat(locale, {
-      style: 'currency',
-      currency: this.currency,
-    }).format(this.amount);
-  }
-
-  add(other: Money): Money {
-    if (this.currency !== other.currency) {
-      throw new Error('Cannot add different currencies');
-    }
-    return new Money(this.amount + other.amount, this.currency);
-  }
-
-  multiply(factor: number): Money {
-    return new Money(this.amount * factor, this.currency);
-  }
-
-  equals(other: Money): boolean {
-    return this.amount === other.amount && this.currency === other.currency;
-  }
-
-  toString(): string {
-    return this.format();
-  }
-}
-
-// Usage
-const price = new Money(9.99, 'USD');
-console.log(price.format()); // '$9.99'
-console.log(price.format('tr-TR')); // '9,99 $'
-
-const annualPrice = price.multiply(12);
-console.log(annualPrice.format()); // '$119.88'
-```
-
-### SubscriptionPeriod
-
-Represents a subscription period.
-
-```typescript
-class SubscriptionPeriod {
-  private readonly value: number;
-  private readonly unit: 'day' | 'week' | 'month' | 'year';
-
-  constructor(value: number, unit: 'day' | 'week' | 'month' | 'year') {
-    if (value <= 0) {
-      throw new Error('Period value must be positive');
-    }
-    this.value = value;
-    this.unit = unit;
-  }
-
-  getValue(): number {
-    return this.value;
-  }
-
-  getUnit(): string {
-    return this.unit;
-  }
-
-  inDays(): number {
-    switch (this.unit) {
-      case 'day': return this.value;
-      case 'week': return this.value * 7;
-      case 'month': return this.value * 30; // Approximate
-      case 'year': return this.value * 365;
-    }
-  }
-
-  inMonths(): number {
-    switch (this.unit) {
-      case 'day': return this.value / 30;
-      case 'week': return this.value / 4;
-      case 'month': return this.value;
-      case 'year': return this.value * 12;
-    }
-  }
-
-  format(locale: string = 'en-US'): string {
-    const formatter = new Intl.RelativeTimeFormat(locale, { numeric: 'always' });
-    return formatter.format(this.value, this.unit);
-  }
-
-  equals(other: SubscriptionPeriod): boolean {
-    return this.value === other.value && this.unit === other.unit;
-  }
-
-  toString(): string {
-    return this.format();
-  }
-}
-
-// Usage
-const monthly = new SubscriptionPeriod(1, 'month');
-const annual = new SubscriptionPeriod(1, 'year');
-
-console.log(monthly.format()); // '1 month'
-console.log(annual.inDays()); // 365
-console.log(annual.inMonths()); // 12
-```
-
-### PurchaseToken
-
-Represents a purchase transaction token.
-
-```typescript
-class PurchaseToken {
-  private readonly value: string;
-
-  constructor(value: string) {
-    if (!value || value.trim().length === 0) {
-      throw new Error('Purchase token cannot be empty');
-    }
-    this.value = value;
-  }
-
-  getValue(): string {
-    return this.value;
-  }
-
-  equals(other: PurchaseToken): boolean {
-    return this.value === other.value;
-  }
-
-  toString(): string {
-    return this.value;
-  }
-
-  // Mask sensitive parts
-  mask(): string {
-    if (this.value.length <= 8) {
-      return '***';
-    }
-    const start = this.value.substring(0, 4);
-    const end = this.value.substring(this.value.length - 4);
-    return `${start}...${end}`;
-  }
-}
-
-// Usage
-const token = new PurchaseToken('abc123def456ghi789');
-console.log(token.mask()); // 'abc1...i789'
-```
-
-## Usage Examples
-
-### Creating Value Objects
-
-```typescript
-import {
-  EntitlementId,
-  OfferingId,
-  PackageIdentifier,
-  Money,
-  SubscriptionPeriod,
-} from './value-objects';
-
-// Create entitlement ID
-const premiumId = new EntitlementId('premium');
-
-// Create offering ID
-const defaultOffering = new OfferingId('default');
-
-// Create package identifier
-const monthlyPackage = new PackageIdentifier('$rc_monthly');
-
-// Create price
-const price = new Money(9.99, 'USD');
-
-// Create subscription period
-const period = new SubscriptionPeriod(1, 'month');
-```
-
-### Comparing Value Objects
-
-```typescript
-const id1 = new EntitlementId('premium');
-const id2 = new EntitlementId('premium');
-const id3 = new EntitlementId('pro');
-
-console.log(id1.equals(id2)); // true
-console.log(id1.equals(id3)); // false
-
-const price1 = new Money(9.99, 'USD');
-const price2 = new Money(9.99, 'USD');
-const price3 = new Money(19.99, 'USD');
-
-console.log(price1.equals(price2)); // true
-console.log(price1.equals(price3)); // false
-```
-
-### Performing Operations
-
-```typescript
-// Money arithmetic
-const monthlyPrice = new Money(9.99, 'USD');
-const annualPrice = monthlyPrice.multiply(12);
-const withDiscount = annualPrice.multiply(0.8); // 20% off
-
-console.log(monthlyPrice.format()); // '$9.99'
-console.log(annualPrice.format()); // '$119.88'
-console.log(withDiscount.format()); // '$95.90'
-
-// Period conversions
-const period = new SubscriptionPeriod(1, 'year');
-console.log(period.inDays()); // 365
-console.log(period.inMonths()); // 12
-console.log(period.format('tr-TR')); // '1 yıl'
-```
-
-### Validation
-
-```typescript
-// Valid values
-const validEntitlement = new EntitlementId('premium');
-const validMoney = new Money(10.00, 'USD');
-const validPeriod = new SubscriptionPeriod(1, 'month');
-
-// Invalid values (will throw)
-try {
-  new EntitlementId(''); // Error: Entitlement ID cannot be empty
-} catch (error) {
-  console.error(error.message);
-}
-
-try {
-  new Money(-10, 'USD'); // Error: Amount cannot be negative
-} catch (error) {
-  console.error(error.message);
-}
-
-try {
-  new SubscriptionPeriod(0, 'month'); // Error: Period value must be positive
-} catch (error) {
-  console.error(error.message);
-}
-```
-
-## Best Practices
-
-1. **Immutability**: Never modify value objects after creation
-2. **Validation**: Validate in constructor, fail fast
-3. **Equality**: Implement proper equality based on values
-4. **Formatting**: Provide locale-aware formatting
-5. **Operations**: Return new instances for operations
-6. **Type Safety**: Use TypeScript for compile-time checks
-7. **Serialization**: Provide toString/JSON methods if needed
-
-## Related
-
+## Strategy
+This directory contains value objects - immutable types that represent concepts in the RevenueCat domain with no identity, defined by their attributes rather than identity.
+
+## Restrictions
+
+### REQUIRED
+- Must validate in constructor
+- Must keep value objects immutable
+- Must implement proper equality based on values
+- Must provide locale-aware formatting
+
+### PROHIBITED
+- DO NOT modify value objects after creation
+- DO NOT bypass validation in constructor
+- DO NOT use identity-based equality
+- DO NOT ignore locale in formatting
+
+### CRITICAL SAFETY
+- All value objects MUST be immutable
+- Validation MUST happen in constructor
+- Equality MUST be based on values, not identity
+- Formatting MUST be locale-aware
+
+## AI Agent Guidelines
+1. Never modify value objects after creation
+2. Validate all inputs in constructor with fail-fast
+3. Implement proper equality based on values
+4. Provide locale-aware formatting methods
+5. Return new instances for all operations
+6. Use TypeScript for compile-time type safety
+7. Provide toString/JSON methods if needed for serialization
+
+## Related Documentation
 - [RevenueCat Domain](../README.md)
 - [RevenueCat Entities](../entities/README.md)
 - [RevenueCat Types](../types/README.md)

package/src/revenuecat/infrastructure/README.md

@@ -1,50 +1,41 @@
 # RevenueCat Infrastructure
 
+## Location
 Infrastructure layer for RevenueCat integration.
 
-## Overview
-
-This directory contains concrete implementations of RevenueCat interfaces, handling communication with the RevenueCat SDK and external services.
-
-## Structure
-
-```
-infrastructure/
-├── handlers/     # Event handlers and callbacks
-├── services/     # Service implementations
-└── utils/        # Utility functions
-```
-
-## Components
-
-### Handlers
-
-Event handlers for RevenueCat lifecycle events.
-
-**See**: [Handlers README](./handlers/README.md)
-
-### Services
-
-Service implementations for RevenueCat operations.
-
-**See**: [Services README](./services/README.md)
-
-### Utils
-
-Utility functions for common operations.
-
-**See**: [Utils README](./utils/README.md)
-
-## Key Responsibilities
-
-1. **SDK Integration**: Direct integration with RevenueCat SDK
-2. **Error Handling**: Converting SDK errors to domain errors
-3. **Data Transformation**: Mapping SDK types to domain types
-4. **Event Handling**: Managing purchase and customer info events
-5. **Configuration**: Setting up and configuring RevenueCat
-
-## Related
-
+## Strategy
+This directory contains concrete implementations of RevenueCat interfaces, handling communication with the RevenueCat SDK and external services with proper error handling and data transformation.
+
+## Restrictions
+
+### REQUIRED
+- Must integrate directly with RevenueCat SDK
+- Must convert SDK errors to domain errors
+- Must map SDK types to domain types
+- Must manage purchase and customer info events
+
+### PROHIBITED
+- DO NOT expose SDK errors directly to application
+- DO NOT use SDK types in domain layer
+- DO NOT skip error mapping
+- DO NOT ignore lifecycle events
+
+### CRITICAL SAFETY
+- All SDK errors MUST be converted to domain errors
+- All SDK types MUST be mapped to domain types
+- All events MUST be handled appropriately
+- Configuration MUST be set up correctly
+
+## AI Agent Guidelines
+1. Integrate directly with RevenueCat SDK
+2. Convert all SDK errors to domain errors
+3. Map all SDK types to domain types
+4. Manage purchase and customer info events properly
+5. Set up and configure RevenueCat correctly
+6. Test SDK integration thoroughly
+7. Handle all edge cases in SDK communication
+
+## Related Documentation
 - [RevenueCat Integration](../README.md)
 - [RevenueCat Application](../application/README.md)
 - [RevenueCat Domain](../domain/README.md)

package/src/revenuecat/infrastructure/config/README.md

@@ -2,39 +2,48 @@
 
 RevenueCat SDK configuration and initialization.
 
-## Overview
+## Location
 
-This directory contains configuration utilities and setup for the RevenueCat SDK.
+`src/revenuecat/infrastructure/config/`
 
-## Contents
+## Strategy
 
-- **revenueCatConfig.ts** - RevenueCat configuration object and setup
+Configuration utilities and setup for the RevenueCat SDK, providing centralized configuration management for the subscription system.
 
-## Configuration
+## Restrictions
 
-```typescript
-interface RevenueCatConfig {
-  apiKey: string;
-  entitlementId: string;
-  [key: string]: any;
-}
-```
+### REQUIRED
 
-## Usage
+- MUST configure RevenueCat at app startup
+- MUST use valid API keys from environment configuration
+- MUST initialize before any purchase operations
+- MUST handle configuration errors gracefully
 
-Configure RevenueCat at app startup:
+### PROHIBITED
 
-```typescript
-import { revenueCatConfig } from './config/revenueCatConfig';
+- MUST NOT expose API keys in source code
+- MUST NOT hardcode configuration values
+- MUST NOT initialize RevenueCat multiple times
+- MUST NOT bypass configuration validation
 
-// In your app initializer
-await Purchases.configure({
-  apiKey: revenueCatConfig.apiKey,
-  appUserID: userId,
-});
-```
+### CRITICAL
 
-## Related
+- Always validate configuration before initialization
+- Never expose sensitive API keys or tokens
+- Handle all configuration errors gracefully
+- Ensure configuration is loaded before any operations
+
+## AI Agent Guidelines
+
+When working with RevenueCat configuration:
+1. Always validate configuration before use
+2. Never hardcode API keys or secrets
+3. Handle all configuration errors gracefully
+4. Ensure proper initialization order
+5. Test with both valid and invalid configurations
+
+## Related Documentation
 
 - [Managers](../managers/README.md)
 - [Services](../services/README.md)
+- [RevenueCat README](../../README.md)