@umituz/react-native-subscription 2.37.109 → 2.37.110

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.37.109",
+  "version": "2.37.110",
   "description": "Complete subscription management with RevenueCat, paywall UI, and credits system for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domains/credits/application/CreditsInitializer.ts

@@ -41,14 +41,14 @@ export async function initializeCreditsTransaction(
 
         // Global cross-user deduplication: prevent the same Apple/Google transaction
         // from allocating credits under multiple Firebase UIDs.
-        if (metadata.originalTransactionId) {
-            const globalRef = doc(_db, GLOBAL_TRANSACTION_COLLECTION, metadata.originalTransactionId);
+        if (metadata.storeTransactionId) {
+            const globalRef = doc(_db, GLOBAL_TRANSACTION_COLLECTION, metadata.storeTransactionId);
             const globalDoc = await transaction.get(globalRef);
             if (globalDoc.exists()) {
                 const globalData = globalDoc.data();
                 if (globalData?.ownerUserId && globalData.ownerUserId !== userId) {
                     console.warn(
-                        `[CreditsInitializer] Transaction ${metadata.originalTransactionId} already processed by user ${globalData.ownerUserId}, skipping for ${userId}`
+                        `[CreditsInitializer] Transaction ${metadata.storeTransactionId} already processed by user ${globalData.ownerUserId}, skipping for ${userId}`
                     );
                     return {
                         credits: existingData.credits,
@@ -89,8 +89,8 @@ export async function initializeCreditsTransaction(
         transaction.set(creditsRef, creditsData, { merge: true });
 
         // Register transaction globally so other UIDs cannot claim the same purchase.
-        if (metadata.originalTransactionId) {
-            const globalRef = doc(_db, GLOBAL_TRANSACTION_COLLECTION, metadata.originalTransactionId);
+        if (metadata.storeTransactionId) {
+            const globalRef = doc(_db, GLOBAL_TRANSACTION_COLLECTION, metadata.storeTransactionId);
             transaction.set(globalRef, {
                 ownerUserId: userId,
                 purchaseId,

package/src/domains/credits/application/creditDocumentHelpers.ts

@@ -38,7 +38,7 @@ export function getCreditDocumentOrDefault(
         willRenew: false,
         productId: null,
         packageType: null,
-        originalTransactionId: null,
+        storeTransactionId: null,
         store: null,
         ownershipType: null,
         appVersion: null,

package/src/domains/credits/application/creditOperationUtils.ts

@@ -68,7 +68,7 @@ export function buildCreditsData({
     ...(isPurchaseOrRenewal && { lastPurchaseAt: serverTimestamp() }),
     ...(expirationTimestamp && { expirationDate: expirationTimestamp }),
     ...(metadata.willRenew !== undefined && { willRenew: metadata.willRenew }),
-    ...(metadata.originalTransactionId && { originalTransactionId: metadata.originalTransactionId }),
+    ...(metadata.storeTransactionId && { storeTransactionId: metadata.storeTransactionId }),
     ...(canceledAtTimestamp && { canceledAt: canceledAtTimestamp }),
     ...(billingIssueTimestamp && { billingIssueDetectedAt: billingIssueTimestamp }),
     ...(metadata.store && { store: metadata.store }),

package/src/domains/credits/core/Credits.ts

@@ -19,7 +19,7 @@ export interface UserCredits {
   willRenew: boolean | null;
   productId: string | null;
   packageType: PackageType | null;
-  originalTransactionId: string | null;
+  storeTransactionId: string | null;
   periodType: string | null;
   credits: number;
   creditLimit: number;

package/src/domains/credits/core/CreditsMapper.ts

@@ -41,7 +41,7 @@ export function mapCreditsDocumentToEntity(doc: UserCreditsDocumentRead): UserCr
     willRenew: doc.willRenew,
     productId: doc.productId,
     packageType: doc.packageType,
-    originalTransactionId: doc.originalTransactionId,
+    storeTransactionId: doc.storeTransactionId,
     periodType,
     credits: doc.credits,
     creditLimit: doc.creditLimit,

package/src/domains/credits/core/UserCreditsDocument.ts

@@ -42,7 +42,7 @@ export interface UserCreditsDocumentRead {
     willRenew: boolean | null;
     productId: string | null;
     packageType: PackageType | null;
-    originalTransactionId: string | null;
+    storeTransactionId: string | null;
     store: Store | null;
     ownershipType: OwnershipType | null;
     periodType: string | null;

package/src/domains/credits/infrastructure/CreditsRepository.ts

@@ -92,7 +92,7 @@ export class CreditsRepository extends BaseRepository {
     willRenew: boolean,
     expirationDate: string | null,
     periodType: string | null,
-    originalTransactionId?: string | null,
+    storeTransactionId?: string | null,
   ): Promise<boolean> {
     const db = requireFirestore();
     const creditLimit = calculateCreditLimit(productId, this.config);
@@ -105,7 +105,7 @@ export class CreditsRepository extends BaseRepository {
       periodType,
       db,
       userId,
-      originalTransactionId,
+      storeTransactionId,
     );
   }
 }

package/src/domains/credits/infrastructure/operations/CreditsInitializer.ts

@@ -63,7 +63,7 @@ export async function initializeCreditsWithRetry(params: InitializeCreditsParams
           source,
           expirationDate: revenueCatData.expirationDate,
           willRenew: revenueCatData.willRenew,
-          originalTransactionId: revenueCatData.originalTransactionId,
+          storeTransactionId: revenueCatData.storeTransactionId,
           isPremium: revenueCatData.isPremium,
           periodType: revenueCatData.periodType,
           unsubscribeDetectedAt: revenueCatData.unsubscribeDetectedAt,

package/src/domains/credits/infrastructure/operations/CreditsWriter.ts

@@ -78,7 +78,7 @@ export async function syncPremiumMetadata(
  * This handles edge cases like test store purchases, reinstalls, or failed initializations.
  * Returns true if a new document was created, false if one already existed.
  *
- * Cross-user guard: if originalTransactionId is provided and already registered
+ * Cross-user guard: if storeTransactionId is provided and already registered
  * to a different user in the global processedTransactions collection, the recovery
  * document is NOT created (the subscription belongs to another UID).
  */
@@ -91,22 +91,22 @@ export async function createRecoveryCreditsDocument(
   periodType: string | null,
   db?: Firestore,
   userId?: string,
-  originalTransactionId?: string | null,
+  storeTransactionId?: string | null,
 ): Promise<boolean> {
   const existingDoc = await getDoc(ref);
   if (existingDoc.exists()) return false;
 
   // Cross-user deduplication: if this transaction was already processed by another
   // user, skip recovery to prevent double credit allocation across UIDs.
-  if (db && userId && originalTransactionId) {
+  if (db && userId && storeTransactionId) {
     try {
-      const globalRef = doc(db, GLOBAL_TRANSACTION_COLLECTION, originalTransactionId);
+      const globalRef = doc(db, GLOBAL_TRANSACTION_COLLECTION, storeTransactionId);
       const globalDoc = await getDoc(globalRef);
       if (globalDoc.exists()) {
         const globalData = globalDoc.data();
         if (globalData?.ownerUserId && globalData.ownerUserId !== userId) {
           console.warn(
-            `[CreditsWriter] Recovery skipped: transaction ${originalTransactionId} belongs to user ${globalData.ownerUserId}, not ${userId}`
+            `[CreditsWriter] Recovery skipped: transaction ${storeTransactionId} belongs to user ${globalData.ownerUserId}, not ${userId}`
           );
           return false;
         }

package/src/domains/revenuecat/core/types/RevenueCatData.ts

@@ -3,7 +3,7 @@ import type { Store, OwnershipType, PackageType } from "./RevenueCatTypes";
 export interface RevenueCatData {
   expirationDate: string | null;
   willRenew: boolean | null;
-  originalTransactionId: string | null;
+  storeTransactionId: string | null;
   isPremium: boolean;
   periodType: string | null;
   packageType: PackageType | null;

package/src/domains/revenuecat/infrastructure/services/userSwitchHandler.ts

@@ -196,7 +196,7 @@ export async function handleInitialConfiguration(
             expiresAt: premiumEntitlement.expirationDate ?? undefined,
             willRenew: premiumEntitlement.willRenew,
             periodType: premiumEntitlement.periodType as PeriodType | undefined,
-            originalTransactionId: subscription?.storeTransactionId ?? undefined,
+            storeTransactionId: subscription?.storeTransactionId ?? undefined,
           });
         } else {
           await deps.config.onPremiumStatusChanged({

package/src/domains/subscription/application/SubscriptionInitializerTypes.ts

@@ -34,7 +34,7 @@ export interface InitializeCreditsMetadata {
   type: PurchaseType;
   expirationDate: string | null;
   willRenew: boolean | null;
-  originalTransactionId: string | null;
+  storeTransactionId: string | null;
   isPremium: boolean;
   periodType: string | null;
   unsubscribeDetectedAt: string | null;

package/src/domains/subscription/application/SubscriptionSyncProcessor.ts

@@ -110,7 +110,7 @@ export class SubscriptionSyncProcessor {
       revenueCatData.packageType = event.packageType ?? null;
       const revenueCatAppUserId = await this.getRevenueCatAppUserId();
       revenueCatData.revenueCatUserId = revenueCatAppUserId ?? event.userId;
-      const purchaseId = generatePurchaseId(revenueCatData.originalTransactionId, event.productId);
+      const purchaseId = generatePurchaseId(revenueCatData.storeTransactionId, event.productId);
 
       const creditsUserId = await this.getCreditsUserId(event.userId);
 
@@ -140,7 +140,7 @@ export class SubscriptionSyncProcessor {
       revenueCatData.expirationDate = event.newExpirationDate ?? revenueCatData.expirationDate;
       const revenueCatAppUserId = await this.getRevenueCatAppUserId();
       revenueCatData.revenueCatUserId = revenueCatAppUserId ?? event.userId;
-      const purchaseId = generateRenewalId(revenueCatData.originalTransactionId, event.productId, event.newExpirationDate);
+      const purchaseId = generateRenewalId(revenueCatData.storeTransactionId, event.productId, event.newExpirationDate);
 
       const creditsUserId = await this.getCreditsUserId(event.userId);
 
@@ -222,7 +222,7 @@ export class SubscriptionSyncProcessor {
         event.willRenew ?? false,
         event.expiresAt ?? null,
         event.periodType ?? null,
-        event.originalTransactionId,
+        event.storeTransactionId,
       );
       if (__DEV__ && created) {
         console.log('[SubscriptionSyncProcessor] Recovery: created missing credits document for premium user', {

package/src/domains/subscription/application/SubscriptionSyncUtils.ts

@@ -23,7 +23,7 @@ export const extractRevenueCatData = (customerInfo: CustomerInfo, entitlementId:
     return {
       expirationDate: null,
       willRenew: null,
-      originalTransactionId: null,
+      storeTransactionId: null,
       periodType: null,
       packageType: null,
       isPremium: false,
@@ -39,11 +39,11 @@ export const extractRevenueCatData = (customerInfo: CustomerInfo, entitlementId:
   return {
     expirationDate: entitlement.expirationDate ?? null,
     willRenew: entitlement.willRenew ?? null,
-    // Maps SDK's `storeTransactionId` (current transaction ID from Apple/Google)
-    // to our domain's `originalTransactionId`. Used as dedup key in processedTransactions.
-    // Note: The SDK does not expose `original_store_transaction_id` (the first purchase's
-    // ID that stays constant across renewals) — only available via server-side webhooks.
-    originalTransactionId: subscription?.storeTransactionId ?? null,
+    // Current transaction ID from Apple/Google — changes with each renewal.
+    // Used as dedup key in processedTransactions collection.
+    // Note: original_store_transaction_id (stable across renewals) is only
+    // available server-side (webhooks/REST API), not in the client SDK.
+    storeTransactionId: subscription?.storeTransactionId ?? null,
     periodType: validatePeriodType(entitlement.periodType),
     packageType: null,
     isPremium: true,

package/src/domains/subscription/application/syncIdGenerators.ts

@@ -1,13 +1,13 @@
 const uniqueSuffix = (): string => `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
 
-export const generatePurchaseId = (originalTransactionId: string | null, productId: string): string => {
-  return originalTransactionId
-    ? `purchase_${originalTransactionId}`
+export const generatePurchaseId = (storeTransactionId: string | null, productId: string): string => {
+  return storeTransactionId
+    ? `purchase_${storeTransactionId}`
     : `purchase_${productId}_${uniqueSuffix()}`;
 };
 
-export const generateRenewalId = (originalTransactionId: string | null, productId: string, expirationDate: string): string => {
-  return originalTransactionId
-    ? `renewal_${originalTransactionId}_${expirationDate}`
+export const generateRenewalId = (storeTransactionId: string | null, productId: string, expirationDate: string): string => {
+  return storeTransactionId
+    ? `renewal_${storeTransactionId}_${expirationDate}`
     : `renewal_${productId}_${uniqueSuffix()}`;
 };

package/src/domains/subscription/core/SubscriptionEvents.ts

@@ -24,7 +24,7 @@ export interface PremiumStatusChangedEvent {
   expiresAt?: string;
   willRenew?: boolean;
   periodType?: PeriodType;
-  originalTransactionId?: string;
+  storeTransactionId?: string;
 }
 
 export interface PlanChangedEvent {

package/src/domains/subscription/infrastructure/utils/PremiumStatusSyncer.ts

@@ -39,7 +39,7 @@ export async function syncPremiumStatus(
                 expiresAt: premiumEntitlement.expirationDate ?? undefined,
                 willRenew: premiumEntitlement.willRenew,
                 periodType: premiumEntitlement.periodType as PeriodType | undefined,
-                originalTransactionId: subscription?.storeTransactionId ?? undefined,
+                storeTransactionId: subscription?.storeTransactionId ?? undefined,
             });
         } else {
             await config.onPremiumStatusChanged({ userId, isPremium: false });