@umituz/react-native-subscription 2.27.11 → 2.27.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.27.11",
+  "version": "2.27.13",
   "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/index.ts

@@ -96,3 +96,18 @@ export * from "./utils";
 
 // RevenueCat
 export * from "./revenuecat";
+
+// App Service Helpers (for configureAppServices)
+export {
+  createCreditService,
+  createPaywallService,
+  type CreditServiceConfig,
+  type ICreditService,
+  type IPaywallService,
+} from "./infrastructure/services/app-service-helpers";
+
+// Init Module Factory
+export {
+  createSubscriptionInitModule,
+  type SubscriptionInitModuleConfig,
+} from './init';

package/src/infrastructure/services/app-service-helpers.ts

@@ -0,0 +1,115 @@
+/**
+ * App Service Helpers
+ * Creates ready-to-use service implementations for configureAppServices
+ */
+
+import {
+  getCreditsRepository,
+  getRevenueCatService,
+  getPremiumEntitlement,
+} from "./SubscriptionInitializer";
+import { creditsQueryKeys } from "../../presentation/hooks/useCredits";
+import { paywallControl } from "../../domains/paywall/hooks/usePaywall";
+import {
+  getGlobalQueryClient,
+  hasGlobalQueryClient,
+} from "@umituz/react-native-design-system";
+import {
+  useAuthStore,
+  selectUserId,
+} from "@umituz/react-native-auth";
+
+declare const __DEV__: boolean;
+
+export interface CreditServiceConfig {
+  entitlementId: string;
+}
+
+export interface ICreditService {
+  checkCredits: (cost: number) => Promise<boolean>;
+  deductCredits: (cost: number) => Promise<void>;
+  refundCredits: (amount: number, error?: unknown) => Promise<void>;
+  calculateCost: (capability: string, metadata?: Record<string, unknown>) => number;
+}
+
+export interface IPaywallService {
+  showPaywall: (requiredCredits: number) => void;
+}
+
+const checkPremiumStatus = async (entitlementId: string): Promise<boolean> => {
+  try {
+    const rcService = getRevenueCatService();
+    if (!rcService) return false;
+
+    const customerInfo = await rcService.getCustomerInfo();
+    if (!customerInfo) return false;
+
+    return !!getPremiumEntitlement(customerInfo, entitlementId);
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * Creates a credit service implementation
+ */
+export function createCreditService(config: CreditServiceConfig): ICreditService {
+  const { entitlementId } = config;
+
+  return {
+    checkCredits: async (cost: number): Promise<boolean> => {
+      const userId = selectUserId(useAuthStore.getState());
+      if (!userId) return false;
+
+      // Premium users bypass credit check
+      if (await checkPremiumStatus(entitlementId)) return true;
+
+      try {
+        const repository = getCreditsRepository();
+        const result = await repository.getCredits(userId);
+        if (!result.success || !result.data) return false;
+        return (result.data.credits ?? 0) >= cost;
+      } catch {
+        return false;
+      }
+    },
+
+    deductCredits: async (cost: number): Promise<void> => {
+      const userId = selectUserId(useAuthStore.getState());
+      if (!userId) return;
+
+      // Premium users don't consume credits
+      if (await checkPremiumStatus(entitlementId)) return;
+
+      try {
+        const repository = getCreditsRepository();
+        await repository.deductCredit(userId, cost);
+
+        if (hasGlobalQueryClient()) {
+          getGlobalQueryClient().invalidateQueries({
+            queryKey: creditsQueryKeys.user(userId),
+          });
+        }
+      } catch (error) {
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.error("[CreditService] Deduct error:", error);
+        }
+      }
+    },
+
+    refundCredits: async (): Promise<void> => {
+      // No-op for now
+    },
+
+    calculateCost: (): number => 1,
+  };
+}
+
+/**
+ * Creates a paywall service implementation
+ */
+export function createPaywallService(): IPaywallService {
+  return {
+    showPaywall: () => paywallControl.open(),
+  };
+}

package/src/init/createSubscriptionInitModule.ts

@@ -0,0 +1,121 @@
+/**
+ * Subscription Init Module Factory
+ * Creates a ready-to-use InitModule for app initialization
+ */
+
+import { initializeSubscription, type SubscriptionInitConfig } from '../infrastructure/services/SubscriptionInitializer';
+
+declare const __DEV__: boolean;
+
+/**
+ * InitModule interface (from @umituz/react-native-design-system)
+ */
+export interface InitModule {
+  name: string;
+  init: () => Promise<boolean>;
+  critical?: boolean;
+  dependsOn?: string[];
+}
+
+export interface SubscriptionInitModuleConfig extends Omit<SubscriptionInitConfig, 'apiKey'> {
+  /**
+   * RevenueCat API key getter function
+   * Returns the API key or undefined if not available
+   */
+  getApiKey: () => string | undefined;
+
+  /**
+   * Optional RevenueCat test store key getter
+   */
+  getTestStoreKey?: () => string | undefined;
+
+  /**
+   * Whether this module is critical for app startup
+   * @default true
+   */
+  critical?: boolean;
+
+  /**
+   * Module dependencies
+   * @default ["auth"]
+   */
+  dependsOn?: string[];
+}
+
+/**
+ * Creates a Subscription initialization module for use with createAppInitializer
+ *
+ * @example
+ * ```typescript
+ * import { createAppInitializer } from "@umituz/react-native-design-system";
+ * import { createFirebaseInitModule } from "@umituz/react-native-firebase";
+ * import { createAuthInitModule } from "@umituz/react-native-auth";
+ * import { createSubscriptionInitModule } from "@umituz/react-native-subscription";
+ *
+ * export const initializeApp = createAppInitializer({
+ *   modules: [
+ *     createFirebaseInitModule(),
+ *     createAuthInitModule({ userCollection: "users" }),
+ *     createSubscriptionInitModule({
+ *       getApiKey: () => getRevenueCatApiKey(),
+ *       entitlementId: "premium",
+ *       credits: {
+ *         collectionName: "credits",
+ *         creditLimit: 500,
+ *         enableFreeCredits: true,
+ *         freeCredits: 1,
+ *       },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export function createSubscriptionInitModule(
+  config: SubscriptionInitModuleConfig
+): InitModule {
+  const {
+    getApiKey,
+    getTestStoreKey,
+    critical = true,
+    dependsOn = ['auth'],
+    ...subscriptionConfig
+  } = config;
+
+  return {
+    name: 'subscription',
+    critical,
+    dependsOn,
+    init: async () => {
+      try {
+        const apiKey = getApiKey();
+
+        if (!apiKey) {
+          if (typeof __DEV__ !== 'undefined' && __DEV__) {
+            console.log('[createSubscriptionInitModule] No API key - skipping');
+          }
+          return true; // Not an error, just skip
+        }
+
+        const testStoreKey = getTestStoreKey?.();
+
+        await initializeSubscription({
+          apiKey,
+          testStoreKey,
+          ...subscriptionConfig,
+        });
+
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.log('[createSubscriptionInitModule] Subscription initialized');
+        }
+
+        return true;
+      } catch (error) {
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.error('[createSubscriptionInitModule] Error:', error);
+        }
+        // Continue on error - subscription is not critical for app launch
+        return true;
+      }
+    },
+  };
+}

package/src/init/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Subscription Init Module
+ * Provides factory for creating app initialization modules
+ */
+
+export {
+  createSubscriptionInitModule,
+  type SubscriptionInitModuleConfig,
+  type InitModule,
+} from './createSubscriptionInitModule';