@ridwan-retainer/paywall 0.1.0

package/dist/purchase/purchaseCache.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cachePurchaseAttempt = cachePurchaseAttempt;
+exports.getLastPurchaseAttempt = getLastPurchaseAttempt;
+exports.clearPurchaseAttempt = clearPurchaseAttempt;
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const PURCHASE_ATTEMPT_KEY = '@paywall/purchase-attempt';
+/**
+ * Cache last purchase attempt for retry on network failure
+ */
+async function cachePurchaseAttempt(pkg) {
+    try {
+        const attempt = {
+            packageIdentifier: pkg.identifier,
+            timestamp: Date.now(),
+        };
+        await async_storage_1.default.setItem(PURCHASE_ATTEMPT_KEY, JSON.stringify(attempt));
+    }
+    catch (error) {
+        console.warn('[PurchaseCache] Failed to cache purchase attempt:', error);
+    }
+}
+/**
+ * Get last purchase attempt
+ */
+async function getLastPurchaseAttempt() {
+    try {
+        const cached = await async_storage_1.default.getItem(PURCHASE_ATTEMPT_KEY);
+        if (!cached)
+            return null;
+        const attempt = JSON.parse(cached);
+        // Only return if attempt is less than 5 minutes old
+        const fiveMinutes = 5 * 60 * 1000;
+        if (Date.now() - attempt.timestamp < fiveMinutes) {
+            return attempt;
+        }
+        return null;
+    }
+    catch (error) {
+        console.warn('[PurchaseCache] Failed to get purchase attempt:', error);
+        return null;
+    }
+}
+/**
+ * Clear purchase attempt cache
+ */
+async function clearPurchaseAttempt() {
+    try {
+        await async_storage_1.default.removeItem(PURCHASE_ATTEMPT_KEY);
+    }
+    catch (error) {
+        console.warn('[PurchaseCache] Failed to clear purchase attempt:', error);
+    }
+}

package/dist/purchase/types.d.ts

@@ -0,0 +1,23 @@
+import type { CustomerInfo } from 'react-native-purchases';
+export interface PurchaseResult {
+    customerInfo: CustomerInfo;
+    productIdentifier: string;
+}
+export interface PurchaseError {
+    message: string;
+    userCancelled: boolean;
+    code?: string;
+}
+export declare enum PurchaseState {
+    IDLE = "IDLE",
+    PURCHASING = "PURCHASING",
+    SUCCESS = "SUCCESS",
+    ERROR = "ERROR",
+    CANCELLED = "CANCELLED"
+}
+export interface PurchaseStatus {
+    state: PurchaseState;
+    error: PurchaseError | null;
+    customerInfo: CustomerInfo | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/purchase/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/purchase/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}

package/dist/purchase/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurchaseState = void 0;
+var PurchaseState;
+(function (PurchaseState) {
+    PurchaseState["IDLE"] = "IDLE";
+    PurchaseState["PURCHASING"] = "PURCHASING";
+    PurchaseState["SUCCESS"] = "SUCCESS";
+    PurchaseState["ERROR"] = "ERROR";
+    PurchaseState["CANCELLED"] = "CANCELLED";
+})(PurchaseState || (exports.PurchaseState = PurchaseState = {}));

package/dist/restore/RestoreManager.d.ts

@@ -0,0 +1,26 @@
+import type { CustomerInfo } from 'react-native-purchases';
+import type { RestoreResult } from './types';
+export declare class RestoreManager {
+    /**
+     * Restore purchases from App Store / Play Store
+     * Official docs: https://www.revenuecat.com/docs/getting-started/restoring-purchases
+     *
+     * From docs: "Reactivates previously purchased content.
+     * May trigger OS-level sign-in prompts."
+     */
+    restorePurchases(): Promise<RestoreResult>;
+    /**
+     * Sync purchases programmatically (no OS prompts)
+     * Official docs: https://www.revenuecat.com/docs/getting-started/restoring-purchases
+     *
+     * From docs: "Used for programmatic restoration without user interaction
+     * and without OS prompts. Respects logged-in user's ID."
+     */
+    syncPurchases(): Promise<CustomerInfo>;
+    /**
+     * Handle restore errors
+     */
+    private handleRestoreError;
+}
+export declare const restoreManager: RestoreManager;
+//# sourceMappingURL=RestoreManager.d.ts.map

package/dist/restore/RestoreManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestoreManager.d.ts","sourceRoot":"","sources":["../../src/restore/RestoreManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,SAAS,CAAC;AAG3D,qBAAa,cAAc;IACzB;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAoBhD;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAiB5C;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/restore/RestoreManager.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoreManager = exports.RestoreManager = void 0;
+const react_native_purchases_1 = __importDefault(require("react-native-purchases"));
+const CustomerInfoManager_1 = require("../entitlements/CustomerInfoManager");
+class RestoreManager {
+    /**
+     * Restore purchases from App Store / Play Store
+     * Official docs: https://www.revenuecat.com/docs/getting-started/restoring-purchases
+     *
+     * From docs: "Reactivates previously purchased content.
+     * May trigger OS-level sign-in prompts."
+     */
+    async restorePurchases() {
+        try {
+            // Official restore method
+            const customerInfo = await react_native_purchases_1.default.restorePurchases();
+            // Clear cache to force refresh with restored purchases
+            CustomerInfoManager_1.customerInfoManager.clearCache();
+            // Check if any entitlements were restored
+            const hasActiveEntitlements = Object.keys(customerInfo.entitlements.active).length > 0;
+            return {
+                customerInfo,
+                entitlementsRestored: hasActiveEntitlements,
+            };
+        }
+        catch (error) {
+            throw this.handleRestoreError(error);
+        }
+    }
+    /**
+     * Sync purchases programmatically (no OS prompts)
+     * Official docs: https://www.revenuecat.com/docs/getting-started/restoring-purchases
+     *
+     * From docs: "Used for programmatic restoration without user interaction
+     * and without OS prompts. Respects logged-in user's ID."
+     */
+    async syncPurchases() {
+        try {
+            // Sync purchases for current logged-in user
+            await react_native_purchases_1.default.syncPurchases();
+            // Get updated customer info
+            const customerInfo = await react_native_purchases_1.default.getCustomerInfo();
+            // Clear cache
+            CustomerInfoManager_1.customerInfoManager.clearCache();
+            return customerInfo;
+        }
+        catch (error) {
+            throw this.handleRestoreError(error);
+        }
+    }
+    /**
+     * Handle restore errors
+     */
+    handleRestoreError(error) {
+        const err = error;
+        const restoreError = {
+            message: err.message || 'Failed to restore purchases',
+            code: err.code,
+        };
+        if (__DEV__) {
+            console.error('[RestoreManager] Restore error:', restoreError);
+        }
+        return restoreError;
+    }
+}
+exports.RestoreManager = RestoreManager;
+// Singleton instance
+exports.restoreManager = new RestoreManager();

package/dist/restore/autoRestore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Automatically sync purchases when user signs in
+ * Use syncPurchases() to avoid OS prompts
+ *
+ * Note: This should be called by auth integration, not in this package directly
+ */
+export declare function syncPurchasesOnSignIn(): Promise<void>;
+/**
+ * Automatically sync purchases when app becomes active
+ * Useful for detecting external purchases (e.g., from App Store listing)
+ */
+export declare function syncPurchasesOnAppActive(): Promise<void>;
+//# sourceMappingURL=autoRestore.d.ts.map

package/dist/restore/autoRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoRestore.d.ts","sourceRoot":"","sources":["../../src/restore/autoRestore.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3D;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS9D"}

package/dist/restore/autoRestore.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncPurchasesOnSignIn = syncPurchasesOnSignIn;
+exports.syncPurchasesOnAppActive = syncPurchasesOnAppActive;
+const RestoreManager_1 = require("./RestoreManager");
+/**
+ * Automatically sync purchases when user signs in
+ * Use syncPurchases() to avoid OS prompts
+ *
+ * Note: This should be called by auth integration, not in this package directly
+ */
+async function syncPurchasesOnSignIn() {
+    try {
+        await RestoreManager_1.restoreManager.syncPurchases();
+    }
+    catch (error) {
+        // Log error but don't throw - sign-in should succeed even if sync fails
+        if (__DEV__) {
+            console.warn('[AutoRestore] Failed to sync purchases on sign-in:', error);
+        }
+    }
+}
+/**
+ * Automatically sync purchases when app becomes active
+ * Useful for detecting external purchases (e.g., from App Store listing)
+ */
+async function syncPurchasesOnAppActive() {
+    try {
+        await RestoreManager_1.restoreManager.syncPurchases();
+    }
+    catch (error) {
+        // Silent fail - don't interrupt user
+        if (__DEV__) {
+            console.warn('[AutoRestore] Failed to sync purchases on app active:', error);
+        }
+    }
+}

package/dist/restore/errorHandling.d.ts

@@ -0,0 +1,10 @@
+import type { RestoreError } from './types';
+/**
+ * Get user-friendly error message for restore failures
+ */
+export declare function getRestoreErrorMessage(error: RestoreError): string;
+/**
+ * Check if restore error is recoverable
+ */
+export declare function isRecoverableRestoreError(error: RestoreError): boolean;
+//# sourceMappingURL=errorHandling.d.ts.map

package/dist/restore/errorHandling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../../src/restore/errorHandling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAelE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAOtE"}

package/dist/restore/errorHandling.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRestoreErrorMessage = getRestoreErrorMessage;
+exports.isRecoverableRestoreError = isRecoverableRestoreError;
+/**
+ * Get user-friendly error message for restore failures
+ */
+function getRestoreErrorMessage(error) {
+    switch (error.code) {
+        case 'NETWORK_ERROR':
+            return 'Network connection error. Please check your internet and try again.';
+        case 'INVALID_CREDENTIALS':
+            return 'Unable to verify your account. Please sign in and try again.';
+        case 'STORE_PROBLEM':
+            return 'There was a problem connecting to the App Store. Please try again later.';
+        case 'UNKNOWN':
+        default:
+            return error.message || 'Failed to restore purchases. Please try again.';
+    }
+}
+/**
+ * Check if restore error is recoverable
+ */
+function isRecoverableRestoreError(error) {
+    const recoverableCodes = [
+        'NETWORK_ERROR',
+        'UNKNOWN',
+    ];
+    return recoverableCodes.includes(error.code || '');
+}

package/dist/restore/types.d.ts

@@ -0,0 +1,22 @@
+import type { CustomerInfo } from 'react-native-purchases';
+export interface RestoreResult {
+    customerInfo: CustomerInfo;
+    entitlementsRestored: boolean;
+}
+export interface RestoreError {
+    message: string;
+    code?: string;
+}
+export declare enum RestoreState {
+    IDLE = "IDLE",
+    RESTORING = "RESTORING",
+    SUCCESS = "SUCCESS",
+    ERROR = "ERROR",
+    NO_PURCHASES = "NO_PURCHASES"
+}
+export interface RestoreStatus {
+    state: RestoreState;
+    error: RestoreError | null;
+    customerInfo: CustomerInfo | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/restore/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/restore/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}

package/dist/restore/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestoreState = void 0;
+var RestoreState;
+(function (RestoreState) {
+    RestoreState["IDLE"] = "IDLE";
+    RestoreState["RESTORING"] = "RESTORING";
+    RestoreState["SUCCESS"] = "SUCCESS";
+    RestoreState["ERROR"] = "ERROR";
+    RestoreState["NO_PURCHASES"] = "NO_PURCHASES";
+})(RestoreState || (exports.RestoreState = RestoreState = {}));

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@ridwan-retainer/paywall",
+  "version": "0.1.0",
+  "description": "Revenue-first monetization layer using RevenueCat for in-app purchases and subscriptions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RidwanHamid501/app-factory.git",
+    "directory": "packages/paywall"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.0",
+    "react-native-purchases": "^9.10.5",
+    "react-native-purchases-ui": "^9.10.5"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-native": ">=0.78.0"
+  },
+  "devDependencies": {
+    "@testing-library/react-native": "^13.3.3",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-native": "^0.73.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "jest": "^29.7.0",
+    "react": "^19.0.0",
+    "react-native": "^0.73.0",
+    "react-test-renderer": "^19.1.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0"
+  },
+  "keywords": [
+    "revenuecat",
+    "subscriptions",
+    "in-app-purchases",
+    "paywall",
+    "monetization"
+  ],
+  "license": "MIT"
+}