@umituz/react-native-subscription 2.27.65 → 2.27.67

package/src/shared/infrastructure/SubscriptionEventBus.ts

@@ -0,0 +1,51 @@
+type EventCallback<T = any> = (data: T) => void;
+
+/**
+ * Simple EventBus Implementation
+ * Used to decouple services and provide an observer pattern for subscription events.
+ */
+export class SubscriptionEventBus {
+  private static instance: SubscriptionEventBus;
+  private listeners: Record<string, EventCallback[]> = {};
+
+  private constructor() {}
+
+  static getInstance(): SubscriptionEventBus {
+    if (!SubscriptionEventBus.instance) {
+      SubscriptionEventBus.instance = new SubscriptionEventBus();
+    }
+    return SubscriptionEventBus.instance;
+  }
+
+  on<T>(event: string, callback: EventCallback<T>): () => void {
+    if (!this.listeners[event]) {
+      this.listeners[event] = [];
+    }
+    this.listeners[event].push(callback);
+    
+    // Return unsubscribe function
+    return () => {
+      this.listeners[event] = this.listeners[event].filter(l => l !== callback);
+    };
+  }
+
+  emit<T>(event: string, data: T): void {
+    if (!this.listeners[event]) return;
+    this.listeners[event].forEach(callback => {
+      try {
+        callback(data);
+      } catch (error) {
+        if (__DEV__) console.error(`[SubscriptionEventBus] Error in listener for ${event}:`, error);
+      }
+    });
+  }
+}
+
+export const subscriptionEventBus = SubscriptionEventBus.getInstance();
+
+export const SUBSCRIPTION_EVENTS = {
+  CREDITS_UPDATED: "credits_updated",
+  PURCHASE_COMPLETED: "purchase_completed",
+  RENEWAL_DETECTED: "renewal_detected",
+  PREMIUM_STATUS_CHANGED: "premium_status_changed",
+};

package/src/utils/packageTypeDetector.ts

@@ -7,23 +7,22 @@ import { PACKAGE_TYPE, type PackageType } from "../domain/entities/SubscriptionC
 
 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
+ */
 /**
  * Check if identifier is a credit package (consumable purchase)
  * Credit packages use a different system and don't need type detection
  */
 function isCreditPackage(identifier: string): boolean {
-  return identifier.includes("credit");
+  // Matches "credit" as a word or part of a common naming pattern
+  return /\bcredit\b|_credit_|-credit-/i.test(identifier) || identifier.toLowerCase().includes("credit");
 }
 
 /**
  * Detect package type from product identifier
- * Supports common RevenueCat naming patterns:
- * - premium_weekly, weekly_premium, premium-weekly
- * - premium_monthly, monthly_premium, premium-monthly
- * - premium_yearly, yearly_premium, premium-yearly, premium_annual, annual_premium
- * - preview-product-id (Preview API mode in Expo Go)
- *
- * Note: Credit packages (consumable purchases) are skipped silently
+ * Supports common RevenueCat naming patterns with regex for better accuracy
  */
 export function detectPackageType(productIdentifier: string): SubscriptionPackageType {
   if (!productIdentifier) {
@@ -45,28 +44,24 @@ export function detectPackageType(productIdentifier: string): SubscriptionPackag
     return PACKAGE_TYPE.MONTHLY;
   }
 
-  // Weekly detection
-  if (normalized.includes("weekly") || normalized.includes("week")) {
+  // Weekly detection: matches "weekly" or "week" as distinct parts of the ID
+  if (/\bweekly?\b|_week_|-week-|\.week\./i.test(normalized)) {
     if (__DEV__) {
       console.log("[PackageTypeDetector] Detected: WEEKLY");
     }
     return PACKAGE_TYPE.WEEKLY;
   }
 
-  // Monthly detection
-  if (normalized.includes("monthly") || normalized.includes("month")) {
+  // Monthly detection: matches "monthly" or "month"
+  if (/\bmonthly?\b|_month_|-month-|\.month\./i.test(normalized)) {
     if (__DEV__) {
       console.log("[PackageTypeDetector] Detected: MONTHLY");
     }
     return PACKAGE_TYPE.MONTHLY;
   }
 
-  // Yearly detection (includes annual)
-  if (
-    normalized.includes("yearly") ||
-    normalized.includes("year") ||
-    normalized.includes("annual")
-  ) {
+  // Yearly detection: matches "yearly", "year", or "annual"
+  if (/\byearly?\b|_year_|-year-|\.year\.|annual/i.test(normalized)) {
     if (__DEV__) {
       console.log("[PackageTypeDetector] Detected: YEARLY");
     }

package/src/application/README.md

@@ -1,50 +0,0 @@
-# Application Layer
-
-Abonelik uygulamasının iş mantığını ve servis kontratlarını içeren katman.
-
-## Location
-
-`src/application/`
-
-## Strategy
-
-Ortak kullanım durumlarını gerçekleştiren, servis kontratlarını tanımlayan ve uygulama kurallarını yöneten katman. Dependency injection ve test edilebilirlik sağlar.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST use dependency injection pattern
-- MUST define service contracts through interfaces
-- MUST implement error handling and propagation
-- MUST ensure type safety for all operations
-- MUST support dependency inversion principle
-
-### PROHIBITED
-
-- MUST NOT contain direct infrastructure dependencies
-- MUST NOT bypass repository interfaces
-- MUST NOT leak implementation details
-- MUST NOT mix business logic with presentation
-
-### CRITICAL
-
-- Keep interfaces small and focused (Interface Segregation)
-- Maintain single responsibility for each service
-- Always handle errors appropriately and propagate upward
-- Ensure all operations are type-safe
-
-## AI Agent Guidelines
-
-When working with application layer:
-1. Interface Segregation - küçük, odaklanmış interface'ler tanımlayın
-2. Dependency Inversion - high-level modüller low-level modüllere bağımlı olmamalı
-3. Single Responsibility - her service/repository tek bir sorumluluğa sahip olmalı
-4. Error Handling - hataları uygun şekilde handle edin ve yukarı propagation edin
-5. Testing - interface'ler mock ile kolay test edilebilir
-
-## Related Documentation
-
-- [Domain Layer](../domain/README.md)
-- [Infrastructure Layer](../infrastructure/README.md)
-- [Ports](./ports/README.md)

package/src/domain/entities/README.md

@@ -1,50 +0,0 @@
-# Domain Entities
-
-Core domain entities for subscription management.
-
-## Location
-
-`src/domain/entities/`
-
-## Strategy
-
-Domain entities represent the core business concepts and rules of the subscription system. They are framework-agnostic and contain only business logic, ensuring pure domain modeling.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST validate themselves on creation
-- MUST remain immutable after creation
-- MUST encapsulate business logic internally
-- MUST use value objects for complex attributes
-- MUST be framework-agnostic
-
-### PROHIBITED
-
-- MUST NOT have framework dependencies
-- MUST NOT expose internal state directly
-- MUST NOT allow direct state modification
-- MUST NOT contain infrastructure concerns
-
-### CRITICAL
-
-- Always validate invariants to ensure valid state
-- Prevent direct state modification through immutability
-- Keep business rules encapsulated within entities
-- Maintain purity - no external dependencies
-
-## AI Agent Guidelines
-
-When working with domain entities:
-1. Keep entities pure - no framework dependencies
-2. Validate invariants - ensure valid state
-3. Use value objects - for complex attributes
-4. Encapsulate logic - keep business rules inside entities
-5. Make immutable - prevent direct state modification
-
-## Related Documentation
-
-- [Value Objects](../value-objects/README.md)
-- [Domain Errors](../errors/README.md)
-- [Domain Layer](../README.md)

package/src/domain/entities/SubscriptionStatus.test.ts

@@ -1,105 +0,0 @@
-import {
-  createDefaultSubscriptionStatus,
-  isSubscriptionValid,
-  calculateDaysRemaining,
-} from './SubscriptionStatus';
-
-describe('SubscriptionStatus', () => {
-  describe('createDefaultSubscriptionStatus', () => {
-    it('should create default subscription status', () => {
-      const status = createDefaultSubscriptionStatus();
-      
-      expect(status).toEqual({
-        isPremium: false,
-        expiresAt: null,
-        productId: null,
-        purchasedAt: null,
-        customerId: null,
-        syncedAt: null,
-        status: 'none',
-      });
-    });
-  });
-
-  describe('isSubscriptionValid', () => {
-    it('should return false for null status', () => {
-      expect(isSubscriptionValid(null)).toBe(false);
-    });
-
-    it('should return false for non-premium status', () => {
-      const status = {
-        isPremium: false,
-        expiresAt: null,
-        productId: null,
-        purchasedAt: null,
-        customerId: null,
-        syncedAt: null,
-      };
-      
-      expect(isSubscriptionValid(status)).toBe(false);
-    });
-
-    it('should return true for lifetime subscription', () => {
-      const status = {
-        isPremium: true,
-        expiresAt: null,
-        productId: 'lifetime',
-        purchasedAt: '2024-01-01T00:00:00.000Z',
-        customerId: 'customer123',
-        syncedAt: '2024-01-01T00:00:00.000Z',
-      };
-      
-      expect(isSubscriptionValid(status)).toBe(true);
-    });
-
-    it('should return true for active subscription', () => {
-      const futureDate = new Date();
-      futureDate.setDate(futureDate.getDate() + 30);
-      
-      const status = {
-        isPremium: true,
-        expiresAt: futureDate.toISOString(),
-        productId: 'monthly',
-        purchasedAt: '2024-01-01T00:00:00.000Z',
-        customerId: 'customer123',
-        syncedAt: '2024-01-01T00:00:00.000Z',
-      };
-      
-      expect(isSubscriptionValid(status)).toBe(true);
-    });
-
-    it('should return false for expired subscription', () => {
-      const pastDate = new Date();
-      pastDate.setDate(pastDate.getDate() - 1);
-      
-      const status = {
-        isPremium: true,
-        expiresAt: pastDate.toISOString(),
-        productId: 'monthly',
-        purchasedAt: '2024-01-01T00:00:00.000Z',
-        customerId: 'customer123',
-        syncedAt: '2024-01-01T00:00:00.000Z',
-      };
-      
-      expect(isSubscriptionValid(status)).toBe(false);
-    });
-  });
-
-  describe('calculateDaysRemaining', () => {
-    it('should return null for null input', () => {
-      expect(calculateDaysRemaining(null)).toBeNull();
-    });
-
-    it('should return positive days for future expiration', () => {
-      const futureDate = new Date();
-      futureDate.setDate(futureDate.getDate() + 5);
-      expect(calculateDaysRemaining(futureDate.toISOString())).toBe(5);
-    });
-
-    it('should return 0 for past expiration', () => {
-      const pastDate = new Date();
-      pastDate.setDate(pastDate.getDate() - 5);
-      expect(calculateDaysRemaining(pastDate.toISOString())).toBe(0);
-    });
-  });
-});

package/src/domain/errors/README.md

@@ -1,53 +0,0 @@
-# Domain Errors
-
-Domain-specific error types for subscription system.
-
-## Location
-
-`src/domain/errors/`
-
-## Strategy
-
-Domain errors provide typed, contextual error handling for business logic failures. They make error handling explicit and type-safe, enabling precise error management.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST use specific error types (not generic Error)
-- MUST include contextual information
-- MUST document all error codes
-- MUST handle errors gracefully with user-friendly messages
-- MUST log errors for debugging
-- MUST use type guards for type-safe error handling
-
-### PROHIBITED
-
-- MUST NOT swallow errors without handling
-- MUST NOT use generic Error class
-- MUST NOT expose sensitive information in error messages
-- MUST NOT ignore error conditions
-
-### CRITICAL
-
-- Always handle or rethrow errors
-- Include relevant context in error objects
-- Use type guards to enable type-safe error handling
-- Show user-friendly messages while logging technical details
-
-## AI Agent Guidelines
-
-When working with domain errors:
-1. Use specific error types - don't use generic Error
-2. Include context - add relevant data to errors
-3. Document error codes - list all possible errors
-4. Handle gracefully - show user-friendly messages
-5. Log errors - track for debugging
-6. Don't swallow errors - always handle or rethrow
-7. Use type guards - enable type-safe error handling
-
-## Related Documentation
-
-- [Domain Entities](../entities/README.md)
-- [Value Objects](../value-objects/README.md)
-- [Domain Layer](../README.md)

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

@@ -1,50 +0,0 @@
-# Domain Value Objects
-
-Value objects for the subscription domain.
-
-## Location
-
-`src/domain/value-objects/`
-
-## Strategy
-
-Value objects are immutable objects that represent concepts by their attributes rather than identity. They ensure validity and prevent primitive obsession by providing type-safe, validated representations.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST be immutable (all properties readonly)
-- MUST validate on creation (fail fast)
-- MUST override equality (compare by value, not reference)
-- MUST use for complex attributes (not simple primitives)
-- MUST be small and focused
-
-### PROHIBITED
-
-- MUST NOT allow mutation after creation
-- MUST NOT use reference equality for comparison
-- MUST NOT contain invalid states
-- MUST NOT have identity-based equality
-
-### CRITICAL
-
-- Always validate on creation
-- Implement value-based equality comparison
-- Keep value objects small and focused
-- Use only for complex attributes, not simple primitives
-
-## AI Agent Guidelines
-
-When working with value objects:
-1. Make immutable - all properties readonly
-2. Validate on creation - fail fast
-3. Override equality - compare by value, not reference
-4. Use for complex attributes - don't use for simple primitives
-5. Keep small - value objects should be focused
-
-## Related Documentation
-
-- [Domain Entities](../entities/README.md)
-- [Domain Errors](../errors/README.md)
-- [Domain Layer](../README.md)

package/src/infrastructure/README.md

@@ -1,55 +0,0 @@
-# Infrastructure Layer
-
-Abonelik sisteminin dış dünya ile iletişimini sağlayan implementations ve repositories içeren katman.
-
-## Location
-
-`src/infrastructure/`
-
-## Strategy
-
-Dış servis entegrasyonlarını (Firebase, RevenueCat), veri erişim implementasyonlarını ve karmaşık operasyon yöneticilerini içeren katman. Dependency injection ve test edilebilirlik sağlar.
-
-## Restrictions
-
-### REQUIRED
-
-- MUST implement all port interfaces from application layer
-- MUST handle all errors gracefully and propagate appropriately
-- MUST validate all inputs before processing
-- MUST implement caching for frequently accessed data
-- MUST support logging for debugging and monitoring
-- MUST be testable with mock implementations
-
-### PROHIBITED
-
-- MUST NOT contain business logic (belongs in domain/application)
-- MUST NOT bypass error handling
-- MUST NOT expose implementation details to other layers
-- MUST NOT create tight coupling with external services
-
-### CRITICAL
-
-- Always validate inputs before processing
-- Implement proper error handling for all external calls
-- Use dependency injection for all external dependencies
-- Ensure all implementations are mockable for testing
-- Implement retry logic for network operations
-
-## AI Agent Guidelines
-
-When working with infrastructure layer:
-1. Dependency Injection - repository'leri constructor'da alın
-2. Error Handling - tüm hataları yakalayın ve uygun şekilde handle edin
-3. Caching - sık kullanılan verileri cache'leyin
-4. Validation - girdileri validate edin
-5. Logging - önemli operasyonları log'layın
-6. Testing - mock implementasyonlarla test edilebilir yapın
-7. Retry Logic - network hataları için retry logic ekleyin
-
-## Related Documentation
-
-- [Application Layer](../application/README.md)
-- [Domain Layer](../domain/README.md)
-- [Repositories](./repositories/README.md)
-- [Services](./services/README.md)

package/src/infrastructure/mappers/README.md

@@ -1,21 +0,0 @@
-# Infrastructure Mappers
-
-Data transformation mappers between layers.
-
-## Overview
-
-This directory contains mapper functions that transform data between different layers (e.g., domain entities to DTOs, external API responses to domain models).
-
-## Contents
-
-- **subscriptionMapper.ts** - Maps between subscription entities and external formats
-- **creditsMapper.ts** - Maps between credit entities and Firestore documents
-
-## Purpose
-
-Mappers provide clean separation between layers:
-
-## Related
-
-- [Models](../models/README.md)
-- [Domain](../../domain/README.md)

package/src/infrastructure/models/README.md

@@ -1,26 +0,0 @@
-# Infrastructure Models
-
-Data models and schemas used by the infrastructure layer.
-
-## Overview
-
-This directory contains data models, schemas, and interfaces used by infrastructure implementations.
-
-## Contents
-
-- **SubscriptionModel.ts** - Subscription data model for persistence/transport
-- **CreditsModel.ts** - Credits data model for Firestore
-
-## Purpose
-
-Models provide structure for data storage and API communication:
-
-- **Validation**: Ensure data integrity
-- **Serialization**: Convert to/from storage formats
-- **Type Safety**: Provide TypeScript interfaces
-
-## Related
-
-- [Repositories](../repositories/README.md)
-- [Services](../services/README.md)
-- [Domain Entities](../../domain/entities/README.md)

package/src/infrastructure/repositories/CreditsRepository.ts

@@ -1,132 +0,0 @@
-/**
- * Credits Repository
- */
-
-import { doc, getDoc, runTransaction, serverTimestamp, type Firestore, type Transaction } from "firebase/firestore";
-import { BaseRepository, getFirestore } from "@umituz/react-native-firebase";
-import type { CreditsConfig, CreditsResult, DeductCreditsResult } from "../../domain/entities/Credits";
-import type { UserCreditsDocumentRead, PurchaseSource } from "../models/UserCreditsDocument";
-import { initializeCreditsTransaction, type InitializeCreditsMetadata } from "../services/CreditsInitializer";
-import { detectPackageType } from "../../utils/packageTypeDetector";
-import { getCreditAllocation } from "../../utils/creditMapper";
-import { CreditsMapper } from "../mappers/CreditsMapper";
-import type { RevenueCatData } from "../../domain/types/RevenueCatData";
-
-export type { RevenueCatData } from "../../domain/types/RevenueCatData";
-
-export class CreditsRepository extends BaseRepository {
-  constructor(private config: CreditsConfig) { super(); }
-
-  private getRef(db: Firestore, userId: string) {
-    return this.config.useUserSubcollection
-      ? doc(db, "users", userId, "credits", "balance")
-      : doc(db, this.config.collectionName, userId);
-  }
-
-  async getCredits(userId: string): Promise<CreditsResult> {
-    const db = getFirestore();
-    if (!db) {
-      if (__DEV__) console.log("[CreditsRepository] No Firestore instance");
-      return { success: false, error: { message: "No DB", code: "DB_ERR" } };
-    }
-    try {
-      const ref = this.getRef(db, userId);
-      if (__DEV__) console.log("[CreditsRepository] Fetching credits:", { userId: userId.slice(0, 8), path: ref.path });
-      const snap = await getDoc(ref);
-      if (!snap.exists()) {
-        if (__DEV__) console.log("[CreditsRepository] No credits document found");
-        return { success: true, data: undefined };
-      }
-      const d = snap.data() as UserCreditsDocumentRead;
-      const entity = CreditsMapper.toEntity(d);
-      if (__DEV__) console.log("[CreditsRepository] Credits fetched:", { credits: entity.credits, limit: entity.creditLimit });
-      return { success: true, data: entity };
-    } catch (e: unknown) {
-      const message = e instanceof Error ? e.message : String(e);
-      if (__DEV__) console.error("[CreditsRepository] Fetch error:", message);
-      return { success: false, error: { message, code: "FETCH_ERR" } };
-    }
-  }
-
-  async initializeCredits(
-    userId: string, purchaseId?: string, productId?: string,
-    source?: PurchaseSource, revenueCatData?: RevenueCatData
-  ): Promise<CreditsResult> {
-    const db = getFirestore();
-    if (!db) return { success: false, error: { message: "No DB", code: "INIT_ERR" } };
-    try {
-      let cfg = { ...this.config };
-      if (productId) {
-        const amt = this.config.creditPackageAmounts?.[productId];
-        if (amt) cfg = { ...cfg, creditLimit: amt };
-        else {
-          const packageType = detectPackageType(productId);
-          const dynamicLimit = getCreditAllocation(packageType, this.config.packageAllocations);
-          if (dynamicLimit !== null) cfg = { ...cfg, creditLimit: dynamicLimit };
-        }
-      }
-
-      const metadata: InitializeCreditsMetadata = {
-        productId, source,
-        expirationDate: revenueCatData?.expirationDate,
-        willRenew: revenueCatData?.willRenew,
-        originalTransactionId: revenueCatData?.originalTransactionId,
-        isPremium: revenueCatData?.isPremium,
-        periodType: revenueCatData?.periodType,
-      };
-
-      await initializeCreditsTransaction(db, this.getRef(db, userId), cfg, purchaseId, metadata);
-      // Re-fetch from Firestore to get the actual stored data with all fields
-      const snap = await getDoc(this.getRef(db, userId));
-      const fullData = snap.exists() ? snap.data() as UserCreditsDocumentRead : undefined;
-      return {
-        success: true,
-        data: fullData ? CreditsMapper.toEntity(fullData) : undefined,
-      };
-    } catch (e: unknown) {
-      const message = e instanceof Error ? e.message : String(e);
-      return { success: false, error: { message, code: "INIT_ERR" } };
-    }
-  }
-
-  async deductCredit(userId: string, cost: number = 1): Promise<DeductCreditsResult> {
-    const db = getFirestore();
-    if (!db) return { success: false, error: { message: "No DB", code: "ERR" } };
-    try {
-      const remaining = await runTransaction(db, async (tx: Transaction) => {
-        const docSnap = await tx.get(this.getRef(db, userId));
-        if (!docSnap.exists()) throw new Error("NO_CREDITS");
-        const current = docSnap.data().credits as number;
-        if (current < cost) throw new Error("CREDITS_EXHAUSTED");
-        const updated = current - cost;
-        tx.update(this.getRef(db, userId), { credits: updated, lastUpdatedAt: serverTimestamp() });
-        return updated;
-      });
-      return { success: true, remainingCredits: remaining };
-    } catch (e: unknown) {
-      const message = e instanceof Error ? e.message : String(e);
-      const code = message === "NO_CREDITS" || message === "CREDITS_EXHAUSTED" ? message : "DEDUCT_ERR";
-      return { success: false, error: { message, code } };
-    }
-  }
-
-  async hasCredits(userId: string, cost: number = 1): Promise<boolean> {
-    const res = await this.getCredits(userId);
-    return !!(res.success && res.data && res.data.credits >= cost);
-  }
-
-  async syncExpiredStatus(userId: string): Promise<void> {
-    const db = getFirestore();
-    if (!db) return;
-    try {
-      const ref = this.getRef(db, userId);
-      const { updateDoc } = await import("firebase/firestore");
-      await updateDoc(ref, { isPremium: false, status: "expired", lastUpdatedAt: serverTimestamp() });
-      if (__DEV__) console.log("[CreditsRepository] Synced expired status:", userId.slice(0, 8));
-    } catch (e) {
-      if (__DEV__) console.error("[CreditsRepository] Sync expired failed:", e);
-    }
-  }
-}
-
-export const createCreditsRepository = (c: CreditsConfig) => new CreditsRepository(c);