@umituz/react-native-subscription 2.14.97 → 2.14.99

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

@@ -0,0 +1,350 @@
+# Config Domain Entities
+
+Domain entities for configuration management.
+
+## Overview
+
+This directory contains entity classes representing configuration concepts like packages, features, and paywalls.
+
+## Entities
+
+### PackageConfig
+
+Represents a subscription package configuration.
+
+**File**: `PackageConfig.ts`
+
+```typescript
+class PackageConfig {
+  readonly identifier: string;
+  readonly productId: string;
+  readonly period: PackagePeriod;
+  readonly price: Money;
+  readonly features: string[];
+  readonly credits?: number;
+  readonly metadata: PackageMetadata;
+
+  // Methods
+  isAnnual(): boolean;
+  isMonthly(): boolean;
+  isLifetime(): boolean;
+  hasCredits(): boolean;
+  isRecommended(): boolean;
+  isHighlighted(): boolean;
+  getPerMonthPrice(): Money | null;
+  getDiscountPercentage(): number | null;
+  getBadge(): string | null;
+}
+```
+
+**Usage:**
+```typescript
+const pkg = new PackageConfig({
+  identifier: 'premium_annual',
+  productId: 'com.app.premium.annual',
+  period: 'annual',
+  price: 79.99,
+  currency: 'USD',
+  features: ['Unlimited Access', 'Ad-Free'],
+  credits: 1200,
+  metadata: {
+    recommended: true,
+    badge: 'Best Value',
+    discount: { percentage: 20, description: 'Save 20%' },
+  },
+});
+
+console.log(pkg.isAnnual()); // true
+console.log(pkg.getPerMonthPrice()?.format()); // '$6.67'
+console.log(pkg.getDiscountPercentage()); // 20
+```
+
+### FeatureConfig
+
+Represents a feature configuration with gating rules.
+
+**File**: `FeatureConfig.ts`
+
+```typescript
+class FeatureConfig {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+  readonly requiresPremium: boolean;
+  readonly requiresCredits: boolean;
+  readonly creditCost?: number;
+  readonly enabled: boolean;
+  readonly gateType: 'premium' | 'credits' | 'both';
+
+  // Methods
+  isAccessible(userHasPremium: boolean, userCredits: number): boolean;
+  getRequiredCredits(): number;
+}
+```
+
+**Usage:**
+```typescript
+const feature = new FeatureConfig({
+  id: 'ai_generation',
+  name: 'AI Generation',
+  requiresPremium: false,
+  requiresCredits: true,
+  creditCost: 5,
+  enabled: true,
+  gateType: 'credits',
+});
+
+console.log(feature.isAccessible(false, 10)); // true
+console.log(feature.isAccessible(false, 3)); // false
+console.log(feature.getRequiredCredits()); // 5
+```
+
+### PaywallConfig
+
+Represents a paywall screen configuration.
+
+**File**: `PaywallConfig.ts`
+
+```typescript
+class PaywallConfig {
+  readonly id: string;
+  readonly title: string;
+  readonly subtitle?: string;
+  readonly features: string[];
+  readonly packages: PackageConfig[];
+  readonly highlightPackage?: string;
+  readonly style: PaywallStyle;
+  readonly triggers: PaywallTrigger[];
+
+  // Methods
+  getHighlightedPackage(): PackageConfig | null;
+  getPackageByIdentifier(identifier: string): PackageConfig | null;
+  shouldTrigger(triggerType: string): boolean;
+}
+```
+
+**Usage:**
+```typescript
+const paywall = new PaywallConfig({
+  id: 'premium_upgrade',
+  title: 'Upgrade to Premium',
+  features: ['Unlimited Access', 'Ad-Free'],
+  packages: [monthlyPkg, annualPkg],
+  highlightPackage: 'premium_annual',
+  style: {
+    primaryColor: '#007AFF',
+    backgroundColor: '#FFFFFF',
+  },
+  triggers: [{ type: 'credit_gate', enabled: true }],
+});
+
+const highlighted = paywall.getHighlightedPackage();
+console.log(highlighted?.identifier); // 'premium_annual'
+```
+
+### SubscriptionSettingsConfig
+
+Represents subscription settings configuration.
+
+**File**: `SubscriptionSettingsConfig.ts`
+
+```typescript
+class SubscriptionSettingsConfig {
+  readonly showSubscriptionDetails: boolean;
+  readonly showCreditBalance: boolean;
+  readonly allowRestorePurchases: boolean;
+  readonly showManageSubscriptionButton: boolean;
+  readonly subscriptionManagementURL: string;
+  readonly supportEmail: string;
+
+  // Methods
+  getAvailableActions(): string[];
+  isRestoreAllowed(): boolean;
+}
+```
+
+**Usage:**
+```typescript
+const settings = new SubscriptionSettingsConfig({
+  showSubscriptionDetails: true,
+  showCreditBalance: true,
+  allowRestorePurchases: true,
+  showManageSubscriptionButton: true,
+  subscriptionManagementURL: 'https://apps.apple.com/account/subscriptions',
+  supportEmail: 'support@example.com',
+});
+
+console.log(settings.isRestoreAllowed()); // true
+```
+
+## Supporting Types
+
+### PackageMetadata
+
+```typescript
+interface PackageMetadata {
+  highlight?: boolean;
+  recommended?: boolean;
+  discount?: {
+    percentage: number;
+    description: string;
+  };
+  badge?: string;
+}
+```
+
+### PaywallStyle
+
+```typescript
+interface PaywallStyle {
+  primaryColor: string;
+  backgroundColor: string;
+  textColor?: string;
+  image?: string;
+  logo?: string;
+}
+```
+
+### PaywallTrigger
+
+```typescript
+interface PaywallTrigger {
+  type: string;
+  enabled: boolean;
+  conditions?: Record<string, unknown>;
+}
+```
+
+## Factory Functions
+
+### createDefaultPackages
+
+Create default package configurations.
+
+```typescript
+function createDefaultPackages(): PackageConfig[] {
+  return [
+    new PackageConfig({
+      identifier: 'premium_monthly',
+      productId: 'com.app.premium.monthly',
+      period: 'monthly',
+      price: 9.99,
+      currency: 'USD',
+      features: ['Unlimited Access', 'Ad-Free'],
+      credits: 100,
+    }),
+    new PackageConfig({
+      identifier: 'premium_annual',
+      productId: 'com.app.premium.annual',
+      period: 'annual',
+      price: 79.99,
+      currency: 'USD',
+      features: ['Unlimited Access', 'Ad-Free', 'Save 20%'],
+      credits: 1200,
+      metadata: {
+        recommended: true,
+        badge: 'Best Value',
+        discount: { percentage: 20, description: 'Save 20%' },
+      },
+    }),
+  ];
+}
+```
+
+### createDefaultPaywall
+
+Create default paywall configuration.
+
+```typescript
+function createDefaultPaywall(): PaywallConfig {
+  return new PaywallConfig({
+    id: 'default_paywall',
+    title: 'Upgrade to Premium',
+    subtitle: 'Get unlimited access to all features',
+    features: [
+      'Unlimited Access',
+      'Ad-Free Experience',
+      'Priority Support',
+      'Exclusive Features',
+    ],
+    packages: createDefaultPackages(),
+    highlightPackage: 'premium_annual',
+    style: {
+      primaryColor: '#007AFF',
+      backgroundColor: '#FFFFFF',
+    },
+    triggers: [
+      { type: 'premium_feature', enabled: true },
+      { type: 'credit_gate', enabled: true },
+    ],
+  });
+}
+```
+
+## Usage Examples
+
+### Validating Package Configuration
+
+```typescript
+function validatePackage(config: PackageConfigData): boolean {
+  try {
+    new PackageConfig(config);
+    return true;
+  } catch (error) {
+    console.error('Invalid package config:', error.message);
+    return false;
+  }
+}
+```
+
+### Finding Recommended Package
+
+```typescript
+function findRecommendedPackage(packages: PackageConfig[]): PackageConfig | null {
+  return packages.find(pkg => pkg.isRecommended()) ?? null;
+}
+
+const recommended = findRecommendedPackage(packages);
+console.log('Recommended:', recommended?.identifier);
+```
+
+### Filtering Packages by Period
+
+```typescript
+function getPackagesByPeriod(packages: PackageConfig[], period: 'monthly' | 'annual'): PackageConfig[] {
+  return packages.filter(pkg => {
+    if (period === 'monthly') return pkg.isMonthly();
+    if (period === 'annual') return pkg.isAnnual();
+    return false;
+  });
+}
+
+const monthlyPackages = getPackagesByPeriod(packages, 'monthly');
+```
+
+### Checking Feature Access
+
+```typescript
+function canUserAccessFeature(feature: FeatureConfig, user: User): boolean {
+  return feature.isAccessible(user.isPremium, user.credits);
+}
+
+const aiFeature = new FeatureConfig({ /* ... */ });
+const canAccess = canUserAccessFeature(aiFeature, currentUser);
+```
+
+## Best Practices
+
+1. **Validation**: Always validate configuration in constructor
+2. **Immutability**: Never modify entities after creation
+3. **Business Logic**: Keep business logic in entities
+4. **Type Safety**: Use TypeScript strictly
+5. **Error Messages**: Provide clear error messages
+6. **Defaults**: Provide factory functions for defaults
+7. **Testing**: Test validation logic thoroughly
+
+## Related
+
+- [Config Domain](../README.md)
+- [Config Value Objects](../value-objects/README.md)
+- [Config Utils](../../utils/README.md)

package/src/domains/paywall/README.md

@@ -0,0 +1,371 @@
+# Paywall Domain
+
+Abonelik ve kredi satın alımı için kullanıcı dostu ödeme duvarı (paywall) bileşenleri ve hooks.
+
+## Özellikler
+
+- **Hazır Paywall Bileşenleri**: Önceden tasarlanmış, özelleştirilebilir paywall UI'ları
+- **Modal ve Full-Screen Desteği**: Modal veya tam ekran paywall seçenekleri
+- **Çoklu Dil Desteği**: Built-in i18n desteği
+- **A/B Test Hazır**: Farklı paywall varyantları kolayca oluşturulabilir
+- **Analytics Entegrasyonu**: Kullanıcı davranışlarını takip edin
+
+## Kurulum
+
+### Temel Konfigürasyon
+
+```typescript
+import { SubscriptionProvider } from '@umituz/react-native-subscription';
+
+function App() {
+  return (
+    <SubscriptionProvider
+      config={{
+        revenueCatApiKey: 'your_api_key',
+        entitlementId: 'premium',
+      }}
+    >
+      {/* Your app */}
+    </SubscriptionProvider>
+  );
+}
+```
+
+## Kullanım
+
+### PaywallModal
+
+Modal paywall gösterimi için:
+
+```typescript
+import { PaywallModal } from '@umituz/react-native-subscription';
+
+function MyComponent() {
+  const [isVisible, setIsVisible] = useState(false);
+
+  return (
+    <>
+      <Button onPress={() => setIsVisible(true)} title="Upgrade to Premium" />
+
+      <PaywallModal
+        isVisible={isVisible}
+        onClose={() => setIsVisible(false)}
+        config={{
+          title: 'Unlock Premium Features',
+          description: 'Get unlimited access to all features',
+          features: [
+            { icon: 'star', text: 'Unlimited credits' },
+            { icon: 'zap', text: 'AI-powered tools' },
+            { icon: 'shield', text: 'Ad-free experience' },
+          ],
+        }}
+      />
+    </>
+  );
+}
+```
+
+### usePaywall Hook
+
+Paywall görünürlüğünü ve davranışlarını kontrol etmek için:
+
+```typescript
+import { usePaywall } from '@umituz/react-native-subscription';
+
+function PremiumFeature() {
+  const { showPaywall, hidePaywall, isPaywallVisible } = usePaywall();
+
+  const handleUpgradeClick = () => {
+    showPaywall({
+      trigger: 'premium_button',
+      featureId: 'ai_tools',
+    });
+  };
+
+  return (
+    <View>
+      <Text>Premium Feature</Text>
+      <Button onPress={handleUpgradeClick} title="Unlock" />
+    </View>
+  );
+}
+```
+
+### usePaywallActions Hook
+
+Paywall aksiyonları için:
+
+```typescript
+import { usePaywallActions } from '@umituz/react-native-subscription';
+
+function PaywallHandler() {
+  const { handlePurchase, handleRestore, isLoading } = usePaywallActions();
+
+  return (
+    <View>
+      <Button
+        onPress={handlePurchase}
+        disabled={isLoading}
+        title="Subscribe Now"
+      />
+      <Button onPress={handleRestore} title="Restore Purchase" />
+    </View>
+  );
+}
+```
+
+### useSubscriptionModal Hook
+
+Subscription modal yönetimi için:
+
+```typescript
+import { useSubscriptionModal } from '@umituz/react-native-subscription';
+
+function SubscriptionButton() {
+  const { openModal, closeModal, isModalOpen } = useSubscriptionModal();
+
+  return (
+    <>
+      <Button onPress={openModal} title="View Plans" />
+      <SubscriptionModal
+        isOpen={isModalOpen}
+        onClose={closeModal}
+      />
+    </>
+  );
+}
+```
+
+## Bileşenler
+
+### PaywallContainer
+
+Paywall içerik wrapper'ı:
+
+```typescript
+import { PaywallContainer } from '@umituz/react-native-subscription';
+
+<PaywallContainer
+  config={{
+    theme: 'dark',
+    showCloseButton: true,
+    closeOnBackdropPress: false,
+  }}
+>
+  {/* Paywall content */}
+</PaywallContainer>
+```
+
+### PaywallScreen
+
+Tam ekran paywall:
+
+```typescript
+import { PaywallScreen } from '@umituz/react-native-subscription';
+
+<PaywallScreen
+  packages={subscriptionPackages}
+  onPackageSelect={handlePackageSelect}
+  config={{
+    highlightPackage: 'annual',
+    showPerks: true,
+    showTerms: true,
+  }}
+  translations={{
+    title: 'Choose Your Plan',
+    subtitle: 'Cancel anytime',
+    terms: 'Terms & Privacy Policy',
+  }}
+/>
+```
+
+## Hooks Referansı
+
+### usePaywall
+
+```typescript
+const {
+  showPaywall,      // Paywall göster
+  hidePaywall,      // Paywall gizle
+  isPaywallVisible, // Paywall görünürlük durumu
+  paywallConfig,    // Mevcut konfigürasyon
+} = usePaywall();
+```
+
+### usePaywallActions
+
+```typescript
+const {
+  handlePurchase,     // Satın alma işlemi
+  handleRestore,      // Satın alma geri yükleme
+  isLoading,          // Yüklenme durumu
+  error,             // Hata mesajı
+  selectedPackage,   // Seçili paket
+} = usePaywallActions();
+```
+
+### usePaywallTranslations
+
+```typescript
+const {
+  translations,      // Çeviri objeleri
+  t,                // Çeviri fonksiyonu
+  isLoading,        // Yüklenme durumu
+} = usePaywallTranslations({
+  language: 'tr',
+  fallbackLanguage: 'en',
+});
+```
+
+## Özelleştirme
+
+### Tema Konfigürasyonu
+
+```typescript
+const customTheme = {
+  colors: {
+    primary: '#FF6B6B',
+    background: '#1A1A1A',
+    text: '#FFFFFF',
+    textSecondary: '#A0A0A0',
+  },
+  fonts: {
+    title: { fontSize: 28, fontWeight: 'bold' },
+    body: { fontSize: 16, fontWeight: 'normal' },
+  },
+};
+
+<PaywallModal theme={customTheme} />
+```
+
+### Özel Feature Listesi
+
+```typescript
+const customFeatures = [
+  {
+    id: 'feature1',
+    icon: 'rocket',
+    title: 'AI-Powered Tools',
+    description: 'Advanced AI features',
+    highlight: true,
+  },
+  {
+    id: 'feature2',
+    icon: 'infinity',
+    title: 'Unlimited Credits',
+    description: 'Never run out of credits',
+  },
+];
+
+<PaywallScreen features={customFeatures} />
+```
+
+## Event Tracking
+
+Analytics entegrasyonu için:
+
+```typescript
+import { usePaywallFeedback } from '@umituz/react-native-subscription';
+
+function PaywallWithTracking() {
+  const { trackEvent, trackPurchase, trackDismiss } = usePaywallFeedback();
+
+  useEffect(() => {
+    trackEvent('paywall_impression', {
+      source: 'home_screen',
+    });
+  }, []);
+
+  const handlePurchase = async () => {
+    await purchasePackage();
+    trackPurchase('premium_monthly', {
+      revenue: 9.99,
+      currency: 'USD',
+    });
+  };
+
+  const handleClose = () => {
+    trackDismiss('paywall_closed', {
+      duration: 30, // seconds
+    });
+    closeModal();
+  };
+}
+```
+
+## Best Practices
+
+1. **Trigger Bazlı Gösterim**: Farklı trigger'lar için farklı paywall'lar kullanın
+2. **A/B Test**: Farklı varyasyonları test edin
+3. **Analytics**: Kullanıcı davranışlarını takip edin
+4. **Copywriting**: Farklı dillerde optimize edilmiş copy kullanın
+5. **Loading States**: Satın alma sırasında loading gösterin
+6. **Error Handling**: Hataları kullanıcı dostu mesajlarla gösterin
+
+## Örnek Uygulama
+
+```typescript
+import React, { useState } from 'react';
+import { View, Button } from 'react-native';
+import {
+  PaywallModal,
+  usePaywall,
+  usePaywallActions,
+} from '@umituz/react-native-subscription';
+
+export default function PaywallExample() {
+  const { isPaywallVisible, showPaywall, hidePaywall } = usePaywall();
+  const { handlePurchase, isLoading } = usePaywallActions();
+
+  return (
+    <View>
+      <Button
+        onPress={() => showPaywall({ trigger: 'upgrade_button' })}
+        title="Upgrade to Premium"
+      />
+
+      <PaywallModal
+        isVisible={isPaywallVisible}
+        onClose={hidePaywall}
+        config={{
+          title: 'Go Premium',
+          description: 'Unlock all features',
+          features: [
+            { icon: 'star', text: 'Unlimited access' },
+            { icon: 'zap', text: 'AI features' },
+            { icon: 'shield', text: 'No ads' },
+          ],
+        }}
+        onPurchase={handlePurchase}
+        isLoading={isLoading}
+      />
+    </View>
+  );
+}
+```
+
+## Tip Tanımlamaları
+
+```typescript
+interface PaywallConfig {
+  title?: string;
+  description?: string;
+  features?: PaywallFeature[];
+  theme?: 'light' | 'dark';
+  showCloseButton?: boolean;
+  closeOnBackdropPress?: boolean;
+}
+
+interface PaywallFeature {
+  icon: string;
+  text: string;
+  description?: string;
+  highlight?: boolean;
+}
+
+interface PaywallTrigger {
+  trigger: string;
+  featureId?: string;
+  source?: string;
+}
+```