@sudobility/building_blocks_rn 0.0.36 → 0.0.38

package/building-blocks-rn-macos.podspec

@@ -14,7 +14,7 @@ Pod::Spec.new do |s|
   s.osx.deployment_target = '14.0'
 
   s.source_files = 'macos/**/*.{h,m,mm}'
-  s.frameworks   = 'AuthenticationServices', 'Security'
+  s.frameworks   = 'AuthenticationServices', 'Security', 'StoreKit'
 
   s.dependency 'React-Core'
 end

package/dist/index.d.ts

@@ -21,3 +21,5 @@ export type { ErrorBoundaryProps } from './src/components/error';
 export { initializeI18nRN, getI18n, i18n } from './src/i18n';
 export type { I18nConfig } from './src/i18n';
 export { authenticate as webAuthAuthenticate, generateCodeVerifier as webAuthGenerateCodeVerifier, sha256Base64Url as webAuthSha256Base64Url, } from './src/native/WebAuth';
+export { isInAppReviewAvailable, requestInAppReview, recordSuccessfulActionAndPromptForReview, } from './src/review';
+export type { ReviewPromptOptions, ReviewPromptResult } from './src/review';

package/dist/index.js

@@ -27,3 +27,5 @@ export { ErrorBoundary } from './src/components/error';
 export { initializeI18nRN, getI18n, i18n } from './src/i18n';
 // Native modules (desktop only)
 export { authenticate as webAuthAuthenticate, generateCodeVerifier as webAuthGenerateCodeVerifier, sha256Base64Url as webAuthSha256Base64Url, } from './src/native/WebAuth';
+// Review prompts
+export { isInAppReviewAvailable, requestInAppReview, recordSuccessfulActionAndPromptForReview, } from './src/review';

package/dist/src/native/InAppReview.d.ts

@@ -0,0 +1,2 @@
+export declare function isNativeDesktopReviewAvailable(): Promise<boolean>;
+export declare function requestNativeDesktopReview(): Promise<boolean>;

package/dist/src/native/InAppReview.js

@@ -0,0 +1,14 @@
+import { NativeModules, Platform } from 'react-native';
+const { InAppReviewModule } = NativeModules;
+export async function isNativeDesktopReviewAvailable() {
+    if (Platform.OS !== 'macos' || !InAppReviewModule) {
+        return false;
+    }
+    return InAppReviewModule.isAvailable();
+}
+export async function requestNativeDesktopReview() {
+    if (Platform.OS !== 'macos' || !InAppReviewModule) {
+        return false;
+    }
+    return InAppReviewModule.requestReview();
+}

package/dist/src/review/inAppReview.d.ts

@@ -0,0 +1,13 @@
+export interface ReviewPromptOptions {
+    storagePrefix?: string;
+    minSuccessCount?: number;
+    cooldownDays?: number;
+}
+export interface ReviewPromptResult {
+    prompted: boolean;
+    available: boolean;
+    successCount: number;
+}
+export declare function isInAppReviewAvailable(): Promise<boolean>;
+export declare function requestInAppReview(): Promise<boolean>;
+export declare function recordSuccessfulActionAndPromptForReview(options?: ReviewPromptOptions): Promise<ReviewPromptResult>;

package/dist/src/review/inAppReview.js

@@ -0,0 +1,77 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import InAppReview from 'react-native-in-app-review';
+import { Platform } from 'react-native';
+import { isNativeDesktopReviewAvailable, requestNativeDesktopReview, } from '../native/InAppReview';
+const DEFAULT_STORAGE_PREFIX = '@sudobility.review_prompt';
+const DEFAULT_MIN_SUCCESS_COUNT = 3;
+const DEFAULT_COOLDOWN_DAYS = 30;
+function getStorageKeys(storagePrefix) {
+    return {
+        successCount: `${storagePrefix}.success_count`,
+        lastPromptedAt: `${storagePrefix}.last_prompted_at`,
+    };
+}
+async function isPackageReviewAvailable() {
+    if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+        return false;
+    }
+    try {
+        return Boolean(InAppReview.isAvailable());
+    }
+    catch {
+        return false;
+    }
+}
+export async function isInAppReviewAvailable() {
+    if (Platform.OS === 'ios' || Platform.OS === 'android') {
+        return isPackageReviewAvailable();
+    }
+    if (Platform.OS === 'macos') {
+        return isNativeDesktopReviewAvailable();
+    }
+    return false;
+}
+export async function requestInAppReview() {
+    if (Platform.OS === 'ios' || Platform.OS === 'android') {
+        if (!(await isPackageReviewAvailable())) {
+            return false;
+        }
+        try {
+            await InAppReview.RequestInAppReview();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    if (Platform.OS === 'macos') {
+        return requestNativeDesktopReview();
+    }
+    return false;
+}
+export async function recordSuccessfulActionAndPromptForReview(options = {}) {
+    const storagePrefix = options.storagePrefix ?? DEFAULT_STORAGE_PREFIX;
+    const minSuccessCount = options.minSuccessCount ?? DEFAULT_MIN_SUCCESS_COUNT;
+    const cooldownDays = options.cooldownDays ?? DEFAULT_COOLDOWN_DAYS;
+    const cooldownMs = cooldownDays * 24 * 60 * 60 * 1000;
+    const keys = getStorageKeys(storagePrefix);
+    const storedCount = await AsyncStorage.getItem(keys.successCount);
+    const successCount = (Number.parseInt(storedCount ?? '0', 10) || 0) + 1;
+    await AsyncStorage.setItem(keys.successCount, String(successCount));
+    const available = await isInAppReviewAvailable();
+    if (!available || successCount < minSuccessCount) {
+        return { prompted: false, available, successCount };
+    }
+    const lastPromptedAt = await AsyncStorage.getItem(keys.lastPromptedAt);
+    if (lastPromptedAt) {
+        const elapsedMs = Date.now() - Number.parseInt(lastPromptedAt, 10);
+        if (Number.isFinite(elapsedMs) && elapsedMs < cooldownMs) {
+            return { prompted: false, available, successCount };
+        }
+    }
+    const prompted = await requestInAppReview();
+    if (prompted) {
+        await AsyncStorage.setItem(keys.lastPromptedAt, String(Date.now()));
+    }
+    return { prompted, available, successCount };
+}

package/dist/src/review/index.d.ts

@@ -0,0 +1,2 @@
+export { isInAppReviewAvailable, requestInAppReview, recordSuccessfulActionAndPromptForReview, } from './inAppReview';
+export type { ReviewPromptOptions, ReviewPromptResult } from './inAppReview';

package/dist/src/review/index.js

@@ -0,0 +1 @@
+export { isInAppReviewAvailable, requestInAppReview, recordSuccessfulActionAndPromptForReview, } from './inAppReview';

package/macos/InAppReviewModule.h

@@ -0,0 +1,4 @@
+#import <React/RCTBridgeModule.h>
+
+@interface InAppReviewModule : NSObject <RCTBridgeModule>
+@end

package/macos/InAppReviewModule.m

@@ -0,0 +1,25 @@
+#import "InAppReviewModule.h"
+#import <StoreKit/StoreKit.h>
+
+@implementation InAppReviewModule
+
+RCT_EXPORT_MODULE();
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+RCT_EXPORT_METHOD(isAvailable:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+  resolve(@YES);
+}
+
+RCT_EXPORT_METHOD(requestReview:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [SKStoreReviewController requestReview];
+    resolve(@YES);
+  });
+}
+
+@end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/building_blocks_rn",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "description": "Higher-level shared UI building blocks for Sudobility React Native apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,8 @@
     "i18next": "^23.0.0 || ^24.0.0 || ^25.0.0",
     "react-i18next": "^14.0.0 || ^15.0.0 || ^16.0.0",
     "@react-native-async-storage/async-storage": ">=1.0.0",
-    "@sudobility/design": "^1.1.30"
+    "@sudobility/design": "^1.1.30",
+    "react-native-in-app-review": ">=4.4.2"
   },
   "peerDependenciesMeta": {
     "firebase": {
@@ -64,6 +65,9 @@
     },
     "@sudobility/types": {
       "optional": true
+    },
+    "react-native-in-app-review": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -71,7 +75,7 @@
     "@react-native-async-storage/async-storage": "2.2.0",
     "@react-navigation/native": "^7.1.28",
     "@react-navigation/native-stack": "^7.10.1",
-    "@sudobility/types": "^1.9.61",
+    "@sudobility/types": "^1.9.62",
     "@tanstack/react-query": "^5.90.19",
     "@types/react": "~19.1.0",
     "@types/react-dom": "^19.2.3",