@umituz/react-native-subscription 2.14.98 → 2.14.100

package/src/revenuecat/README.md

@@ -1,523 +1,104 @@
 # RevenueCat Integration
 
-RevenueCat ile abonelik yönetimi için kapsamlı entegrasyon ve API wrapper.
+Comprehensive integration and API wrapper for subscription management with RevenueCat.
 
-## Özellikler
+## Location
 
-- **Otomatik Başlatma**: RevenueCat SDK otomatik başlatma ve konfigürasyon
-- **User ID Yönetimi**: Auth sistemleriyle entegre user ID yönetimi
-- **Purchase Flow**: Satın alma işlemleri için yönetilen flow
-- **Restore İşlemi**: Satın alma geri yükleme desteği
-- **Customer Info**: Kullanıcı abonelik bilgilerini takip
-- **Error Handling**: RevenueCat hatalarını yönetme
+- **Base Path**: `/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/revenuecat/`
+- **Domain**: `src/revenuecat/domain/`
+- **Infrastructure**: `src/revenuecat/infrastructure/`
+- **Presentation**: `src/revenuecat/presentation/`
 
-## Kurulum
-
-### 1. RevenueCat SDK Kurulumu
-
-```bash
-npm install react-native-purchases
-# veya
-yarn add react-native-purchases
-```
-
-### 2. Başlatma
-
-```typescript
-import {
-  initializeSubscription,
-  SubscriptionInitConfig,
-} from '@umituz/react-native-subscription';
-
-const config: SubscriptionInitConfig = {
-  revenueCatApiKey: 'your_api_key',
-  revenueCatEntitlementId: 'premium',
-
-  // Opsiyonel
-  userDefaultsSuiteName: 'app.revenuecat',
-  diagnosticsEnabled: __DEV__,
-};
-
-await initializeSubscription(config);
-```
-
-### 3. Provider ile Kullanım
-
-```typescript
-import { SubscriptionProvider } from '@umituz/react-native-subscription';
-
-function App() {
-  return (
-    <SubscriptionProvider config={config}>
-      <YourApp />
-    </SubscriptionProvider>
-  );
-}
-```
-
-## Hooks
-
-### useRevenueCat
-
-RevenueCat'e erişim ve temel işlemler için:
-
-```typescript
-import { useRevenueCat } from '@umituz/react-native-subscription';
-
-function RevenueCatExample() {
-  const {
-    isReady,
-    isInitialized,
-    error,
-    purchaserInfo,
-    offerings,
-  } = useRevenueCat();
-
-  if (!isInitialized) {
-    return <ActivityIndicator />;
-  }
-
-  return (
-    <View>
-      <Text>Status: {isReady ? 'Ready' : 'Loading'}</Text>
-    </View>
-  );
-}
-```
-
-### useCustomerInfo
-
-Kullanıcı abonelik bilgileri için:
-
-```typescript
-import { useCustomerInfo } from '@umituz/react-native-subscription';
-
-function SubscriptionStatus() {
-  const {
-    customerInfo,
-    isLoading,
-    error,
-    refetch,
-  } = useCustomerInfo();
-
-  if (isLoading) return <ActivityIndicator />;
-
-  const entitlement = customerInfo?.entitlements.active['premium'];
-
-  return (
-    <View>
-      <Text>
-        Status: {entitlement ? 'Premium' : 'Free'}
-      </Text>
-      {entitlement && (
-        <Text>
-          Expires: {new Date(entitlement.expirationDate).toLocaleDateString()}
-        </Text>
-      )}
-      <Button onPress={refetch} title="Refresh" />
-    </View>
-  );
-}
-```
-
-### useInitializeSubscription
-
-Başlatma durumu kontrolü için:
-
-```typescript
-import { useInitializeSubscription } from '@umituz/react-native-subscription';
-
-function InitCheck() {
-  const {
-    isInitialized,
-    isInitializing,
-    error,
-    initialize,
-  } = useInitializeSubscription();
-
-  useEffect(() => {
-    if (!isInitialized && !isInitializing) {
-      initialize();
-    }
-  }, []);
-
-  if (isInitializing) {
-    return <Text>Initializing...</Text>;
-  }
-
-  if (error) {
-    return <Text>Error: {error.message}</Text>;
-  }
-
-  return <Text>Ready!</Text>;
-}
-```
-
-### useSubscriptionPackages
-
-Mevcut abonelik paketleri için:
-
-```typescript
-import { useSubscriptionPackages } from '@umituz/react-native-subscription';
-
-function PackageList() {
-  const {
-    packages,
-    offerings,
-    isLoading,
-    error,
-  } = useSubscriptionPackages({
-    offeringId: 'default',
-  });
-
-  if (isLoading) return <ActivityIndicator />;
-
-  return (
-    <ScrollView>
-      {packages.map((pkg) => (
-        <PackageCard
-          key={pkg.identifier}
-          package={pkg}
-          onPress={() => handlePurchase(pkg)}
-        />
-      ))}
-    </ScrollView>
-  );
-}
-```
-
-### usePaywallFlow
-
-Tam paywall flow'u için:
-
-```typescript
-import { usePaywallFlow } from '@umituz/react-native-subscription';
-
-function Paywall() {
-  const {
-    packages,
-    selectedPackage,
-    isLoading,
-    error,
-    selectPackage,
-    purchaseSelectedPackage,
-    restorePurchases,
-  } = usePaywallFlow();
-
-  const handlePurchase = async () => {
-    try {
-      const result = await purchaseSelectedPackage();
-
-      if (result.success) {
-        Alert.alert('Success', 'You are now a premium user!');
-      } else {
-        Alert.alert('Error', result.error?.message);
-      }
-    } catch (err) {
-      Alert.alert('Error', 'Purchase failed');
-    }
-  };
-
-  return (
-    <View>
-      {packages.map((pkg) => (
-        <TouchableOpacity
-          key={pkg.identifier}
-          onPress={() => selectPackage(pkg)}
-          style={selectedPackage?.identifier === pkg.identifier &&
-            styles.selected
-          }
-        >
-          <Text>{pkg.product.title}</Text>
-          <Text>{pkg.product.priceString}</Text>
-        </TouchableOpacity>
-      ))}
-
-      <Button
-        onPress={handlePurchase}
-        disabled={!selectedPackage || isLoading}
-        title="Subscribe"
-      />
-
-      <Button
-        onPress={restorePurchases}
-        disabled={isLoading}
-        title="Restore"
-      />
-    </View>
-  );
-}
-```
-
-### useRestorePurchase
-
-Satın alma geri yükleme için:
-
-```typescript
-import { useRestorePurchase } from '@umituz/react-native-subscription';
-
-function RestoreButton() {
-  const { restorePurchase, isLoading, error, isRestored } = useRestorePurchase();
-
-  const handleRestore = async () => {
-    const result = await restorePurchase();
-
-    if (result.success) {
-      Alert.alert('Success', 'Purchase restored!');
-    } else {
-      Alert.alert('Error', result.error?.message || 'Restore failed');
-    }
-  };
-
-  return (
-    <Button
-      onPress={handleRestore}
-      disabled={isLoading}
-      title={isLoading ? 'Restoring...' : 'Restore Purchase'}
-    />
-  );
-}
-```
-
-## Hata Yönetimi
-
-### RevenueCatError
-
-```typescript
-import {
-  RevenueCatError,
-  ErrorCode,
-  handleRevenueCatError,
-} from '@umituz/react-native-subscription';
-
-try {
-  await purchasePackage(packageToPurchase);
-} catch (error) {
-  if (error instanceof RevenueCatError) {
-    switch (error.code) {
-      case ErrorCode.PurchaseCancelledError:
-        console.log('User cancelled');
-        break;
-      case ErrorCode.PurchaseInvalidError:
-        console.log('Invalid purchase');
-        break;
-      case ErrorCode.NetworkError:
-        console.log('Network error');
-        break;
-      default:
-        handleRevenueCatError(error);
-    }
-  }
-}
-```
-
-## User ID Yönetimi
-
-### Auth ile Entegrasyon
-
-```typescript
-import { useAuthSubscriptionSync } from '@umituz/react-native-subscription';
-
-function AuthSync() {
-  const { user } = useAuth();
-  const { syncUserId, clearUserId } = useAuthSubscriptionSync();
-
-  useEffect(() => {
-    if (user?.uid) {
-      // Kullanıcı giriş yaptığında
-      syncUserId(user.uid);
-    } else {
-      // Kullanıcı çıkış yaptığında
-      clearUserId();
-    }
-  }, [user?.uid]);
-
-  return null;
-}
-```
-
-### Manuel User ID
-
-```typescript
-import { configureUserId } from '@umituz/react-native-subscription';
-
-// Kullanıcı giriş yaptığında
-await configureUserId('user-123');
-
-// Kullanıcı çıkış yaptığında
-await configureUserId(null); // veya await resetUserId()
-```
-
-## API Key Çözümleme
-
-### Environment Bazlı API Keys
-
-```typescript
-import {
-  ApiKeyResolver,
-  resolveApiKey,
-} from '@umituz/react-native-subscription';
-
-const apiKeyResolver = new ApiKeyResolver({
-  development: 'dev_api_key',
-  production: 'prod_api_key',
-});
-
-const apiKey = apiKeyResolver.resolve(__DEV__ ? 'development' : 'production');
-```
-
-## SubscriptionManager
-
-Gelişmiş işlemler için SubscriptionManager kullanımı:
-
-```typescript
-import { SubscriptionManager } from '@umituz/react-native-subscription';
-
-const manager = new SubscriptionManager(config);
-
-// Başlatma
-await manager.initialize(userId);
-
-// Satın alma
-const result = await manager.purchasePackage(packageToPurchase);
-
-// Geri yükleme
-const restoreResult = await manager.restorePurchases();
-
-// Customer info
-const info = await manager.getCustomerInfo();
-
-// Offerings
-const offerings = await manager.getOfferings();
-```
-
-## Best Practices
-
-1. **User ID Sync**: Auth sistemiyle user ID'leri her zaman senkronize edin
-2. **Error Handling**: TümRevenueCat işlemlerinde hata yönetimi kullanın
-3. **Loading States**: Kullanıcıya uygun loading feedback'i verin
-4. **Restore**: Her zaman "Restore Purchase" seçeneği sunun
-5. **Test Mode**: Geliştirme sırasında test mode kullanın
-6. **Debug Mode**: Production'da debug modu kapalı tutun
-
-## Örnek Uygulama
-
-```typescript
-import React, { useEffect } from 'react';
-import { View, Text, Button, ActivityIndicator } from 'react-native';
-import {
-  usePaywallFlow,
-  useCustomerInfo,
-  useRestorePurchase,
-} from '@umituz/react-native-subscription';
-
-export default function SubscriptionScreen() {
-  const {
-    packages,
-    selectedPackage,
-    isLoading,
-    selectPackage,
-    purchaseSelectedPackage,
-  } = usePaywallFlow();
-
-  const { customerInfo, isLoading: infoLoading } = useCustomerInfo();
-  const { restorePurchase } = useRestorePurchase();
-
-  const entitlement = customerInfo?.entitlements.active['premium'];
-
-  const handleSubscribe = async () => {
-    if (!selectedPackage) return;
-
-    try {
-      const result = await purchaseSelectedPackage();
-
-      if (result.success) {
-        Alert.alert('Success', 'Welcome to Premium!');
-      } else {
-        Alert.alert('Error', result.error?.message || 'Purchase failed');
-      }
-    } catch (error) {
-      Alert.alert('Error', 'Something went wrong');
-    }
-  };
-
-  if (isLoading || infoLoading) {
-    return <ActivityIndicator />;
-  }
-
-  return (
-    <View>
-      {entitlement ? (
-        <>
-          <Text>You are Premium!</Text>
-          <Text>
-            Expires: {new Date(entitlement.expirationDate).toLocaleDateString()}
-          </Text>
-        </>
-      ) : (
-        <>
-          <Text>Choose your plan:</Text>
-          {packages.map((pkg) => (
-            <TouchableOpacity
-              key={pkg.identifier}
-              onPress={() => selectPackage(pkg)}
-              style={
-                selectedPackage?.identifier === pkg.identifier &&
-                styles.selected
-              }
-            >
-              <Text>{pkg.product.title}</Text>
-              <Text>{pkg.product.priceString}</Text>
-              <Text>{pkg.product.description}</Text>
-            </TouchableOpacity>
-          ))}
-
-          <Button
-            onPress={handleSubscribe}
-            disabled={!selectedPackage || isLoading}
-            title="Subscribe"
-          />
-
-          <Button onPress={restorePurchase} title="Restore" />
-        </>
-      )}
-    </View>
-  );
-}
-```
-
-## Tip Tanımlamaları
-
-```typescript
-interface RevenueCatConfig {
-  apiKey: string;
-  entitlements: {
-    premium: string;
-  };
-  userDefaultsSuiteName?: string;
-  diagnosticsEnabled?: boolean;
-}
-
-interface PurchaseResult {
-  success: boolean;
-  error?: Error;
-  customerInfo?: CustomerInfo;
-}
-
-interface CustomerInfo {
-  entitlements: {
-    active: Record<string, EntitlementInfo>;
-    all: Record<string, EntitlementInfo>;
-  };
-  activeSubscriptions: string[];
-  allPurchasedProductIdentifiers: string[];
-  latestExpirationDate: string;
-}
-
-interface Package {
-  identifier: string;
-  packageType: PACKAGE_TYPE;
-  product: Product;
-  offeringIdentifier: string;
-}
-```
+## Strategy
+
+### RevenueCat SDK Integration
+
+Seamless RevenueCat SDK initialization and configuration.
+
+- **Automatic Initialization**: SDK startup and configuration
+- **User ID Management**: Auth system integration
+- **Purchase Flow**: Managed purchase operations
+- **Restore Operations**: Purchase restoration support
+- **Error Handling**: RevenueCat error management
+
+### Hook Architecture
+
+React hooks for RevenueCat functionality.
+
+- **useRevenueCat**: Core RevenueCat access
+- **useCustomerInfo**: Subscription information tracking
+- **useInitializeSubscription**: Initialization status monitoring
+- **useSubscriptionPackages**: Package listing and selection
+- **usePaywallFlow**: Complete paywall flow management
+- **useRestorePurchase**: Purchase restoration
+
+### State Management
+
+Customer info and subscription state tracking.
+
+- **Customer Info Tracking**: Real-time subscription updates
+- **Offerings Management**: Package offering configuration
+- **Purchase State**: Purchase operation states
+- **Error States**: Comprehensive error handling
+
+### User ID Synchronization
+
+Auth system integration for user management.
+
+- **Auth Sync**: Automatic user ID synchronization
+- **Login/Logout**: User ID management on auth changes
+- **Anonymous Users**: Anonymous user support
+- **Migration**: User migration support
+
+## Restrictions
+
+### REQUIRED
+
+- **Initialization**: Must initialize before any operations
+- **User ID Sync**: Sync user IDs with auth system
+- **Error Handling**: All operations must handle errors
+- **Loading States**: Show appropriate loading indicators
+
+### PROHIBITED
+
+- **Direct SDK Calls**: Use hooks instead of direct RevenueCat calls
+- **Missing User IDs**: Operations require valid user IDs
+- **Uninitialized Access**: Don't call methods before initialization
+- **Ignoring Errors**: All errors must be handled
+
+### CRITICAL
+
+- **API Key Security**: Never expose API keys in client code
+- **User ID Consistency**: Maintain consistent user IDs
+- **Purchase Validation**: Validate all purchase results
+- **Entitlement Check**: Always verify entitlements
+
+## AI Agent Guidelines
+
+### When Modifying RevenueCat Integration
+
+1. **SDK Version**: Check RevenueCat SDK version compatibility
+2. **Type Definitions**: Update TypeScript types
+3. **Error Handling**: Maintain comprehensive error handling
+4. **Testing**: Test with different subscription states
+
+### When Adding New Hooks
+
+1. **Hook Pattern**: Follow existing hook patterns
+2. **State Management**: Proper state management
+3. **Error Handling**: Comprehensive error handling
+4. **Documentation**: Document hook usage and return values
+
+### When Fixing RevenueCat Bugs
+
+1. **SDK Integration**: Check RevenueCat SDK integration
+2. **State Updates**: Verify state update mechanisms
+3. **User ID**: Verify user ID consistency
+4. **Purchase Flow**: Test complete purchase flows
+
+## Related Documentation
+
+- [Paywall Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/paywall/README.md)
+- [Config Domain](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/domains/config/README.md)
+- [Infrastructure Layer](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/infrastructure/README.md)
+- [Application Layer](/Users/umituz/Desktop/github/umituz/apps/artificial_intelligence/npm-packages/react-native-subscription/src/application/README.md)

package/src/revenuecat/application/README.md

@@ -0,0 +1,43 @@
+# RevenueCat Application Layer
+
+## Location
+Application layer for RevenueCat integration, containing use cases and orchestration logic.
+
+## Strategy
+This directory contains use cases and application-level operations for managing RevenueCat subscriptions and purchases with proper error handling and state synchronization.
+
+## Restrictions
+
+### REQUIRED
+- Must handle RevenueCat errors gracefully
+- Must provide user ID when available
+- Must use entitlements instead of product IDs
+- Must keep local state synchronized
+
+### PROHIBITED
+- DO NOT ignore RevenueCat errors
+- DO NOT skip user ID provision
+- DO NOT use product IDs directly
+- DO NOT allow state desynchronization
+
+### CRITICAL SAFETY
+- All errors MUST be handled gracefully
+- User IDs MUST be provided when available
+- Entitlements MUST be used for flexibility
+- Local state MUST stay synchronized
+
+## AI Agent Guidelines
+1. Always handle RevenueCat errors with proper recovery
+2. Provide user ID when available for better tracking
+3. Use entitlements instead of product IDs for flexibility
+4. Check if offerings are available before purchasing
+5. Validate customer info after purchases
+6. Keep local state synchronized with RevenueCat
+7. Handle network timeouts appropriately
+8. Log all RevenueCat operations for debugging
+
+## Related Documentation
+- [RevenueCat Integration](../README.md)
+- [RevenueCat Domain](../domain/README.md)
+- [RevenueCat Infrastructure](../infrastructure/README.md)
+- [Application Ports](./ports/README.md)

package/src/revenuecat/application/ports/README.md

@@ -0,0 +1,41 @@
+# RevenueCat Application Ports
+
+## Location
+Interface definitions for RevenueCat service layer.
+
+## Strategy
+This directory defines the ports (interfaces) that the RevenueCat infrastructure must implement, following the Dependency Inversion Principle for testability and flexibility.
+
+## Restrictions
+
+### REQUIRED
+- Must define clear interfaces for all operations
+- Must support mocking for testing
+- Must enable implementation swapping
+- Must maintain contracts between layers
+
+### PROHIBITED
+- DO NOT depend on concrete implementations
+- DO NOT create interfaces without clear purpose
+- DO NOT break interface contracts
+- DO NOT couple application to infrastructure
+
+### CRITICAL SAFETY
+- All dependencies MUST be inverted
+- Interfaces MUST be clearly defined
+- Implementations MUST be swappable
+- Contracts MUST be maintained
+
+## AI Agent Guidelines
+1. Define clear interfaces for all RevenueCat operations
+2. Design interfaces for easy mocking in tests
+3. Enable implementation swapping when needed
+4. Keep application layer decoupled from infrastructure
+5. Maintain clear contracts between layers
+6. Document interface behavior thoroughly
+7. Test with mock implementations
+
+## Related Documentation
+- [RevenueCat Application Layer](../README.md)
+- [RevenueCat Infrastructure](../infrastructure/README.md)
+- [RevenueCat Domain](../domain/README.md)