@umituz/react-native-subscription 2.14.9 → 2.14.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "2.14.9",
+  "version": "2.14.11",
   "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/paywall/components/PaywallTabBar.tsx

@@ -62,7 +62,7 @@ export const PaywallTabBar: React.FC<PaywallTabBarProps> = React.memo(
         return (
             <View style={[styles.container, { backgroundColor: tokens.colors.surfaceSecondary }]}>
                 <Animated.View
-                    style={[styles.indicator, { backgroundColor: tokens.colors.surface, left: indicatorLeft }]}
+                    style={[styles.indicator, { backgroundColor: tokens.colors.surface, left: indicatorLeft }] as any}
                 />
                 {renderTab("credits", creditsLabel)}
                 {renderTab("subscription", subscriptionLabel)}

package/src/domains/wallet/domain/entities/CreditCost.ts

@@ -0,0 +1,45 @@
+/**
+ * Credit Cost Entity
+ *
+ * Configurable credit cost configuration for AI operations.
+ * Apps can override default costs based on their pricing model.
+ */
+
+import type { AICreditCosts } from "../types/credit-cost.types";
+
+import {
+  DEFAULT_AI_CREDIT_COSTS,
+  createCreditCostConfig,
+} from "../types/credit-cost.types";
+
+export interface CreditCostEntity {
+  costs: AICreditCosts;
+  pricePerCredit: number;
+  getCost: (operation: keyof AICreditCosts) => number;
+  getDollarValue: (operation: keyof AICreditCosts) => number;
+  getCustomCost: (operation: string) => number;
+}
+
+export function createCreditCostEntity(
+  overrides?: Partial<AICreditCosts>,
+  pricePerCredit: number = 0.1
+): CreditCostEntity {
+  const costs = createCreditCostConfig(overrides);
+
+  return {
+    costs,
+    pricePerCredit,
+    getCost: (operation: keyof AICreditCosts): number => {
+      return costs[operation];
+    },
+    getDollarValue: (operation: keyof AICreditCosts): number => {
+      return costs[operation] * pricePerCredit;
+    },
+    getCustomCost: (operation: string): number => {
+      return (costs as unknown as Record<string, number>)[operation] ?? 0;
+    },
+  };
+}
+
+export { DEFAULT_AI_CREDIT_COSTS, createCreditCostConfig };
+export type { AICreditCosts };

package/src/domains/wallet/domain/errors/WalletError.ts

@@ -0,0 +1,169 @@
+/**
+ * Wallet Error
+ *
+ * Custom error classes for wallet and payment operations.
+ * Follows the same pattern as SubscriptionError.
+ */
+
+export type WalletErrorCategory =
+  | "PAYMENT"
+  | "VALIDATION"
+  | "INFRASTRUCTURE"
+  | "BUSINESS";
+
+export abstract class WalletError extends Error {
+  abstract readonly code: string;
+  abstract readonly userMessage: string;
+  abstract readonly category: WalletErrorCategory;
+
+  constructor(
+    message: string,
+    public readonly cause?: Error
+  ) {
+    super(message);
+    this.name = this.constructor.name;
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      userMessage: this.userMessage,
+      category: this.category,
+      message: this.message,
+      cause: this.cause?.message,
+    };
+  }
+}
+
+export class PaymentValidationError extends WalletError {
+  readonly code = "PAYMENT_VALIDATION_ERROR";
+  readonly category = "PAYMENT" as const;
+  readonly userMessage: string;
+
+  constructor(message: string, cause?: Error) {
+    super(message, cause);
+    this.userMessage = "Payment validation failed. Please try again.";
+  }
+}
+
+export class PaymentProviderError extends WalletError {
+  readonly code = "PAYMENT_PROVIDER_ERROR";
+  readonly category = "PAYMENT" as const;
+  readonly userMessage: string;
+
+  constructor(message: string, cause?: Error) {
+    super(message, cause);
+    this.userMessage = "Payment provider error. Please try again.";
+  }
+}
+
+export class DuplicatePaymentError extends WalletError {
+  readonly code = "DUPLICATE_PAYMENT";
+  readonly category = "PAYMENT" as const;
+  readonly userMessage: string;
+
+  constructor(message: string) {
+    super(message);
+    this.userMessage = "This payment has already been processed.";
+  }
+}
+
+export class UserValidationError extends WalletError {
+  readonly code = "USER_VALIDATION_ERROR";
+  readonly category = "VALIDATION" as const;
+  readonly userMessage: string;
+
+  constructor(message: string) {
+    super(message);
+    this.userMessage = "Invalid user information. Please log in again.";
+  }
+}
+
+export class PackageValidationError extends WalletError {
+  readonly code = "PACKAGE_VALIDATION_ERROR";
+  readonly category = "VALIDATION" as const;
+  readonly userMessage: string;
+
+  constructor(message: string) {
+    super(message);
+    this.userMessage = "Invalid credit package. Please select a valid package.";
+  }
+}
+
+export class ReceiptValidationError extends WalletError {
+  readonly code = "RECEIPT_VALIDATION_ERROR";
+  readonly category = "VALIDATION" as const;
+  readonly userMessage: string;
+
+  constructor(message: string) {
+    super(message);
+    this.userMessage = "Invalid payment receipt. Please contact support.";
+  }
+}
+
+export class TransactionError extends WalletError {
+  readonly code = "TRANSACTION_ERROR";
+  readonly category = "INFRASTRUCTURE" as const;
+  readonly userMessage: string;
+
+  constructor(message: string, cause?: Error) {
+    super(message, cause);
+    this.userMessage = "Transaction failed. Please try again.";
+  }
+}
+
+export class NetworkError extends WalletError {
+  readonly code = "NETWORK_ERROR";
+  readonly category = "INFRASTRUCTURE" as const;
+  readonly userMessage: string;
+
+  constructor(message: string, cause?: Error) {
+    super(message, cause);
+    this.userMessage = "Network error. Please check your connection.";
+  }
+}
+
+export class CreditLimitError extends WalletError {
+  readonly code = "CREDIT_LIMIT_ERROR";
+  readonly category = "BUSINESS" as const;
+  readonly userMessage: string;
+
+  constructor(message: string) {
+    super(message);
+    this.userMessage = "Credit limit exceeded. Please contact support.";
+  }
+}
+
+export class RefundError extends WalletError {
+  readonly code = "REFUND_ERROR";
+  readonly category = "BUSINESS" as const;
+  readonly userMessage: string;
+
+  constructor(message: string, cause?: Error) {
+    super(message, cause);
+    this.userMessage = "Refund failed. Please contact support.";
+  }
+}
+
+export function handleWalletError(error: unknown): WalletError {
+  if (error instanceof WalletError) {
+    return error;
+  }
+
+  if (error instanceof Error) {
+    const message = error.message.toLowerCase();
+
+    if (message.includes("network") || message.includes("timeout")) {
+      return new NetworkError(error.message, error);
+    }
+
+    if (message.includes("permission") || message.includes("unauthorized")) {
+      return new UserValidationError("Authentication failed");
+    }
+
+    return new TransactionError(error.message, error);
+  }
+
+  return new TransactionError("Unexpected error occurred");
+}

package/src/domains/wallet/domain/types/credit-cost.types.ts

@@ -0,0 +1,86 @@
+/**
+ * Credit Cost Types
+ *
+ * Types for configurable AI operation credit costs.
+ * Apps can override these costs based on their pricing model.
+ */
+
+export interface CreditCostConfig {
+  [operationKey: string]: number;
+}
+
+export interface AICreditCosts {
+  IMAGE: number;
+  VIDEO_5S: number;
+  VIDEO_10S: number;
+  VOICE: number;
+  UPSCALE: number;
+  PHOTO_RESTORE: number;
+  REMOVE_BACKGROUND: number;
+  ANIME_SELFIE: number;
+  FACE_SWAP: number;
+  REMOVE_OBJECT: number;
+  REPLACE_BACKGROUND: number;
+  INPAINTING: number;
+  IMAGE_TO_IMAGE: number;
+  AI_HUG: number;
+  AI_KISS: number;
+  IMAGE_TO_VIDEO_5S: number;
+  IMAGE_TO_VIDEO_10S: number;
+  TEXT_TO_VIDEO_5S: number;
+  TEXT_TO_VIDEO_10S: number;
+  TREND_VIDEO: number;
+  EFFECT_VIDEO: number;
+}
+
+export const DEFAULT_AI_CREDIT_COSTS: AICreditCosts = {
+  IMAGE: 2,
+  VIDEO_5S: 20,
+  VIDEO_10S: 35,
+  VOICE: 3,
+  UPSCALE: 2,
+  PHOTO_RESTORE: 2,
+  REMOVE_BACKGROUND: 2,
+  ANIME_SELFIE: 3,
+  FACE_SWAP: 4,
+  REMOVE_OBJECT: 5,
+  REPLACE_BACKGROUND: 5,
+  INPAINTING: 5,
+  IMAGE_TO_IMAGE: 3,
+  AI_HUG: 15,
+  AI_KISS: 15,
+  IMAGE_TO_VIDEO_5S: 20,
+  IMAGE_TO_VIDEO_10S: 35,
+  TEXT_TO_VIDEO_5S: 25,
+  TEXT_TO_VIDEO_10S: 45,
+  TREND_VIDEO: 20,
+  EFFECT_VIDEO: 15,
+};
+
+export interface CreditCostResult {
+  cost: number;
+  dollarValue: number;
+}
+
+export function getCreditCost(
+  config: CreditCostConfig,
+  operation: string
+): number {
+  return config[operation] ?? 0;
+}
+
+export function creditsToDollars(
+  credits: number,
+  pricePerCredit: number = 0.1
+): number {
+  return credits * pricePerCredit;
+}
+
+export function createCreditCostConfig(
+  overrides?: Partial<AICreditCosts>
+): AICreditCosts {
+  return {
+    ...DEFAULT_AI_CREDIT_COSTS,
+    ...overrides,
+  };
+}

package/src/domains/wallet/domain/types/index.ts

@@ -0,0 +1,33 @@
+/**
+ * Wallet Domain Types
+ */
+
+export type {
+  TransactionReason,
+  CreditLog,
+  TransactionRepositoryConfig,
+  TransactionQueryOptions,
+  TransactionResult,
+} from "./transaction.types";
+
+export type {
+  WalletConfig,
+  ProductType,
+  ProductMetadata,
+  ProductMetadataConfig,
+  CreditBalance,
+  WalletTranslations,
+} from "./wallet.types";
+
+export type {
+  CreditCostConfig,
+  AICreditCosts,
+  CreditCostResult,
+} from "./credit-cost.types";
+
+export {
+  DEFAULT_AI_CREDIT_COSTS,
+  getCreditCost,
+  creditsToDollars,
+  createCreditCostConfig,
+} from "./credit-cost.types";

package/src/domains/wallet/domain/types/transaction.types.ts

@@ -0,0 +1,49 @@
+/**
+ * Transaction Types
+ *
+ * Types for credit transaction history and logs.
+ * Generic types for use across hundreds of apps.
+ */
+
+export type TransactionReason =
+  | "purchase"
+  | "usage"
+  | "refund"
+  | "bonus"
+  | "subscription"
+  | "admin"
+  | "reward"
+  | "expired";
+
+export interface CreditLog {
+  id: string;
+  userId: string;
+  change: number;
+  reason: TransactionReason;
+  feature?: string;
+  jobId?: string;
+  packageId?: string;
+  subscriptionPlan?: string;
+  description?: string;
+  createdAt: number;
+}
+
+export interface TransactionRepositoryConfig {
+  collectionName: string;
+  useUserSubcollection?: boolean;
+}
+
+export interface TransactionQueryOptions {
+  userId: string;
+  limit?: number;
+  startAfter?: number;
+}
+
+export interface TransactionResult<T = CreditLog[]> {
+  success: boolean;
+  data?: T;
+  error?: {
+    message: string;
+    code: string;
+  };
+}

package/src/domains/wallet/domain/types/wallet.types.ts

@@ -0,0 +1,50 @@
+/**
+ * Wallet Types
+ *
+ * Types for wallet configuration and product metadata.
+ * Generic types for use across hundreds of apps.
+ */
+
+export interface WalletConfig {
+  transactionCollectionName: string;
+  productMetadataCollectionName: string;
+  useUserSubcollection?: boolean;
+  cacheTTL?: number;
+}
+
+export type ProductType = "credits" | "subscription";
+
+export interface ProductMetadata {
+  productId: string;
+  type: ProductType;
+  name: string;
+  description?: string;
+  credits?: number;
+  bonus?: number;
+  popular?: boolean;
+  features?: string[];
+  order?: number;
+}
+
+export interface ProductMetadataConfig {
+  collectionName: string;
+  cacheTTL?: number;
+}
+
+export interface CreditBalance {
+  credits: number;
+  textCredits?: number;
+  imageCredits?: number;
+}
+
+export interface WalletTranslations {
+  title: string;
+  balance: string;
+  availableCredits: string;
+  transactionHistory: string;
+  noTransactions: string;
+  loading: string;
+  purchase: string;
+  packages: string;
+  viewHistory: string;
+}

package/src/domains/wallet/index.ts

@@ -0,0 +1,116 @@
+/**
+ * Wallet Domain
+ *
+ * Public API for wallet functionality.
+ */
+
+// Types
+export type {
+  TransactionReason,
+  CreditLog,
+  TransactionRepositoryConfig,
+  TransactionQueryOptions,
+  TransactionResult,
+  WalletConfig,
+  ProductType,
+  ProductMetadata,
+  ProductMetadataConfig,
+  CreditBalance,
+  WalletTranslations,
+  CreditCostConfig,
+  AICreditCosts,
+  CreditCostResult,
+} from "./domain/types";
+
+export {
+  DEFAULT_AI_CREDIT_COSTS,
+  getCreditCost,
+  creditsToDollars,
+  createCreditCostConfig,
+} from "./domain/types";
+
+// Errors
+export {
+  WalletError,
+  PaymentValidationError,
+  PaymentProviderError,
+  DuplicatePaymentError,
+  UserValidationError,
+  PackageValidationError,
+  ReceiptValidationError,
+  TransactionError,
+  NetworkError,
+  CreditLimitError,
+  RefundError,
+  handleWalletError,
+  type WalletErrorCategory,
+} from "./domain/errors/WalletError";
+
+// Entities
+export {
+  createCreditCostEntity,
+  type CreditCostEntity,
+} from "./domain/entities/CreditCost";
+
+// Repositories
+export {
+  TransactionRepository,
+  createTransactionRepository,
+} from "./infrastructure/repositories/TransactionRepository";
+
+// Services
+export {
+  ProductMetadataService,
+  createProductMetadataService,
+  configureProductMetadataService,
+  getProductMetadataService,
+  resetProductMetadataService,
+} from "./infrastructure/services/ProductMetadataService";
+
+// Hooks
+export {
+  useWallet,
+  type UseWalletParams,
+  type UseWalletResult,
+} from "./presentation/hooks/useWallet";
+
+export {
+  useTransactionHistory,
+  transactionQueryKeys,
+  type UseTransactionHistoryParams,
+  type UseTransactionHistoryResult,
+} from "./presentation/hooks/useTransactionHistory";
+
+export {
+  useProductMetadata,
+  productMetadataQueryKeys,
+  type UseProductMetadataParams,
+  type UseProductMetadataResult,
+} from "./presentation/hooks/useProductMetadata";
+
+// Components
+export {
+  BalanceCard,
+  type BalanceCardProps,
+  type BalanceCardTranslations,
+} from "./presentation/components/BalanceCard";
+
+export {
+  TransactionItem,
+  type TransactionItemProps,
+  type TransactionItemTranslations,
+} from "./presentation/components/TransactionItem";
+
+export {
+  TransactionList,
+  type TransactionListProps,
+  type TransactionListTranslations,
+} from "./presentation/components/TransactionList";
+
+// Screens
+export {
+  WalletScreen,
+  type WalletScreenProps,
+  type WalletScreenConfig,
+  type WalletScreenTranslations,
+} from "./presentation/screens/WalletScreen";