@umituz/react-native-subscription 1.0.6 → 1.1.0

package/lib/utils/subscriptionConstants.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Subscription Constants
+ * Centralized constants for subscription operations
+ *
+ * Following SOLID, DRY, KISS principles:
+ * - Single Responsibility: Only constants, no logic
+ * - DRY: All constants in one place
+ * - KISS: Simple, clear constant definitions
+ */
+/**
+ * Subscription plan types
+ */
+export declare const SUBSCRIPTION_PLAN_TYPES: {
+    readonly WEEKLY: "weekly";
+    readonly MONTHLY: "monthly";
+    readonly YEARLY: "yearly";
+    readonly UNKNOWN: "unknown";
+};
+export type SubscriptionPlanType = (typeof SUBSCRIPTION_PLAN_TYPES)[keyof typeof SUBSCRIPTION_PLAN_TYPES];
+/**
+ * Minimum expected subscription durations in days
+ * Used to detect sandbox accelerated timers
+ * Includes 1 day tolerance for clock skew
+ */
+export declare const MIN_SUBSCRIPTION_DURATIONS_DAYS: {
+    readonly WEEKLY: 6;
+    readonly MONTHLY: 28;
+    readonly YEARLY: 360;
+    readonly UNKNOWN: 28;
+};
+/**
+ * Subscription period multipliers
+ * Days to add for each subscription type
+ */
+export declare const SUBSCRIPTION_PERIOD_DAYS: {
+    readonly WEEKLY: 7;
+};
+/**
+ * Date calculation constants
+ */
+export declare const DATE_CONSTANTS: {
+    readonly MILLISECONDS_PER_DAY: number;
+    readonly DEFAULT_LOCALE: "en-US";
+};
+/**
+ * Subscription period unit mappings
+ * Maps RevenueCat period units to our internal types
+ */
+export declare const SUBSCRIPTION_PERIOD_UNITS: {
+    readonly WEEK: "WEEK";
+    readonly MONTH: "MONTH";
+    readonly YEAR: "YEAR";
+};
+/**
+ * Product ID keywords for plan detection
+ */
+export declare const PRODUCT_ID_KEYWORDS: {
+    readonly WEEKLY: readonly ["weekly", "week"];
+    readonly MONTHLY: readonly ["monthly", "month"];
+    readonly YEARLY: readonly ["yearly", "year", "annual"];
+};
+//# sourceMappingURL=subscriptionConstants.d.ts.map

package/lib/utils/subscriptionConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionConstants.d.ts","sourceRoot":"","sources":["../../src/utils/subscriptionConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;CAKlC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;CAE3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC"}

package/lib/utils/subscriptionConstants.js

@@ -0,0 +1,61 @@
+/**
+ * Subscription Constants
+ * Centralized constants for subscription operations
+ *
+ * Following SOLID, DRY, KISS principles:
+ * - Single Responsibility: Only constants, no logic
+ * - DRY: All constants in one place
+ * - KISS: Simple, clear constant definitions
+ */
+/**
+ * Subscription plan types
+ */
+export const SUBSCRIPTION_PLAN_TYPES = {
+    WEEKLY: 'weekly',
+    MONTHLY: 'monthly',
+    YEARLY: 'yearly',
+    UNKNOWN: 'unknown',
+};
+/**
+ * Minimum expected subscription durations in days
+ * Used to detect sandbox accelerated timers
+ * Includes 1 day tolerance for clock skew
+ */
+export const MIN_SUBSCRIPTION_DURATIONS_DAYS = {
+    WEEKLY: 6,
+    MONTHLY: 28,
+    YEARLY: 360,
+    UNKNOWN: 28,
+};
+/**
+ * Subscription period multipliers
+ * Days to add for each subscription type
+ */
+export const SUBSCRIPTION_PERIOD_DAYS = {
+    WEEKLY: 7,
+};
+/**
+ * Date calculation constants
+ */
+export const DATE_CONSTANTS = {
+    MILLISECONDS_PER_DAY: 1000 * 60 * 60 * 24,
+    DEFAULT_LOCALE: 'en-US',
+};
+/**
+ * Subscription period unit mappings
+ * Maps RevenueCat period units to our internal types
+ */
+export const SUBSCRIPTION_PERIOD_UNITS = {
+    WEEK: 'WEEK',
+    MONTH: 'MONTH',
+    YEAR: 'YEAR',
+};
+/**
+ * Product ID keywords for plan detection
+ */
+export const PRODUCT_ID_KEYWORDS = {
+    WEEKLY: ['weekly', 'week'],
+    MONTHLY: ['monthly', 'month'],
+    YEARLY: ['yearly', 'year', 'annual'],
+};
+//# sourceMappingURL=subscriptionConstants.js.map

package/lib/utils/subscriptionConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionConstants.js","sourceRoot":"","sources":["../../src/utils/subscriptionConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,oBAAoB,EAAE,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACzC,cAAc,EAAE,OAAO;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;CAC5B,CAAC"}

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "@umituz/react-native-subscription",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Subscription management system for React Native apps - Database-first approach with secure validation",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "scripts": {
+    "build": "tsc",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build",
     "version:patch": "npm version patch -m 'chore: release v%s'",
     "version:minor": "npm version minor -m 'chore: release v%s'",
     "version:major": "npm version major -m 'chore: release v%s'"
@@ -37,16 +42,21 @@
     "react-native": ">=0.74.0"
   },
   "devDependencies": {
+    "@types/jest": "^29.5.14",
     "@types/react": "^18.2.45",
     "@types/react-native": "^0.73.0",
+    "find-up": "^8.0.0",
+    "jest": "^29.7.0",
     "react": "^18.2.0",
     "react-native": "^0.74.0",
+    "ts-jest": "^29.4.6",
     "typescript": "^5.3.3"
   },
   "publishConfig": {
     "access": "public"
   },
   "files": [
+    "lib",
     "src",
     "README.md",
     "LICENSE"

package/src/application/ports/ISubscriptionRepository.ts

@@ -30,3 +30,13 @@ export interface ISubscriptionRepository {
   isSubscriptionValid(status: SubscriptionStatus): boolean;
 }
 
+
+
+
+
+
+
+
+
+
+

package/src/application/ports/ISubscriptionService.ts

@@ -39,3 +39,13 @@ export interface ISubscriptionService {
   ): Promise<SubscriptionStatus>;
 }
 
+
+
+
+
+
+
+
+
+
+

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

@@ -0,0 +1,106 @@
+/**
+ * Tests for Subscription Status Entity
+ */
+
+import {
+  createDefaultSubscriptionStatus,
+  isSubscriptionValid,
+} 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,
+      });
+    });
+  });
+
+  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 true for subscription expired within 24 hour buffer', () => {
+      const pastDate = new Date();
+      pastDate.setDate(pastDate.getDate() - 1);
+      pastDate.setHours(pastDate.getHours() + 1); // 23 hours ago
+      
+      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(true);
+    });
+
+    it('should return false for expired subscription beyond buffer', () => {
+      const pastDate = new Date();
+      pastDate.setDate(pastDate.getDate() - 2);
+      
+      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);
+    });
+  });
+});

package/src/domain/entities/SubscriptionStatus.ts

@@ -62,3 +62,13 @@ export function isSubscriptionValid(status: SubscriptionStatus | null): boolean
   return expirationDate.getTime() > now.getTime() - bufferMs;
 }
 
+
+
+
+
+
+
+
+
+
+

package/src/domain/errors/SubscriptionError.ts

@@ -31,3 +31,13 @@ export class SubscriptionConfigurationError extends SubscriptionError {
   }
 }
 
+
+
+
+
+
+
+
+
+
+

package/src/index.ts

@@ -66,12 +66,19 @@ export type { UseSubscriptionResult } from './presentation/hooks/useSubscription
 
 // Date utilities
 export {
-  isSubscriptionExpired,
-  getDaysUntilExpiration,
   formatExpirationDate,
   calculateExpirationDate,
 } from './utils/dateUtils';
 
+export {
+  isSubscriptionExpired,
+  getDaysUntilExpiration,
+} from './utils/dateValidationUtils';
+
+export {
+  extractPlanFromProductId,
+} from './utils/planDetectionUtils';
+
 // Price utilities
 export { formatPrice } from './utils/priceUtils';
 

package/src/infrastructure/services/ActivationHandler.ts

@@ -0,0 +1,108 @@
+/**
+ * Activation Handler
+ * Handles subscription activation and deactivation
+ */
+
+import type { ISubscriptionRepository } from "../../application/ports/ISubscriptionRepository";
+import type { SubscriptionStatus } from "../../domain/entities/SubscriptionStatus";
+import { SubscriptionRepositoryError } from "../../domain/errors/SubscriptionError";
+
+export interface ActivationHandlerConfig {
+  repository: ISubscriptionRepository;
+  onStatusChanged?: (
+    userId: string,
+    status: SubscriptionStatus
+  ) => Promise<void> | void;
+  onError?: (error: Error, context: string) => Promise<void> | void;
+}
+
+/**
+ * Activate subscription for user
+ */
+export async function activateSubscription(
+  config: ActivationHandlerConfig,
+  userId: string,
+  productId: string,
+  expiresAt: string | null
+): Promise<SubscriptionStatus> {
+  try {
+    if (typeof globalThis !== 'undefined' && (globalThis as any).__DEV__) {
+      console.log("[Subscription] Activating subscription in handler", { userId, productId, expiresAt });
+    }
+    
+    const updatedStatus = await config.repository.updateSubscriptionStatus(
+      userId,
+      {
+        isPremium: true,
+        productId,
+        expiresAt,
+        purchasedAt: new Date().toISOString(),
+        syncedAt: new Date().toISOString(),
+      }
+    );
+
+    await notifyStatusChange(config, userId, updatedStatus);
+    return updatedStatus;
+  } catch (error) {
+    await handleError(config, error, "activateSubscription");
+    throw new SubscriptionRepositoryError("Failed to activate subscription");
+  }
+}
+
+/**
+ * Deactivate subscription for user
+ */
+export async function deactivateSubscription(
+  config: ActivationHandlerConfig,
+  userId: string
+): Promise<SubscriptionStatus> {
+  try {
+    if (typeof globalThis !== 'undefined' && (globalThis as any).__DEV__) {
+      console.log("[Subscription] Deactivating subscription in handler", { userId });
+    }
+    
+    const updatedStatus = await config.repository.updateSubscriptionStatus(
+      userId,
+      {
+        isPremium: false,
+        expiresAt: null,
+        productId: null,
+      }
+    );
+
+    await notifyStatusChange(config, userId, updatedStatus);
+    return updatedStatus;
+  } catch (error) {
+    await handleError(config, error, "deactivateSubscription");
+    throw new SubscriptionRepositoryError("Failed to deactivate subscription");
+  }
+}
+
+async function notifyStatusChange(
+  config: ActivationHandlerConfig,
+  userId: string,
+  status: SubscriptionStatus
+): Promise<void> {
+  if (!config.onStatusChanged) return;
+
+  try {
+    await config.onStatusChanged(userId, status);
+  } catch (error) {
+    await handleError(config, error, "onStatusChanged");
+  }
+}
+
+async function handleError(
+  config: ActivationHandlerConfig,
+  error: unknown,
+  context: string
+): Promise<void> {
+  if (!config.onError) return;
+
+  try {
+    const err = error instanceof Error ? error : new Error("Unknown error");
+    await config.onError(err, `ActivationHandler.${context}`);
+  } catch {
+    // Ignore callback errors
+  }
+}