react-native-iinstall 0.2.12 → 0.2.13

package/INTEGRATION_GUIDE.md

@@ -48,14 +48,14 @@ yarn add react-native-iinstall
 
 **Note**: The SDK automatically includes necessary dependencies like `react-native-sensors` and `react-native-view-shot`.
 
-### Updating to Latest Version (v0.2.7)
+### Updating to Latest Version (v0.2.13)
 
 If you're using an older version, update to get the latest audio/video improvements:
 
 ```bash
-npm install react-native-iinstall@0.2.7
+npm install react-native-iinstall@0.2.13
 # OR
-yarn add react-native-iinstall@0.2.7
+yarn add react-native-iinstall@0.2.13
 ```
 
 **Key improvements in v0.2.7:**
@@ -98,7 +98,45 @@ export default App;
 
 ---
 
-## 5. Audio & Video Feedback (v0.2.7+)
+## 5. Push Notification Token Registration (v0.2.13+)
+
+If you pass `pushToken`, SDK auto-registers it to the backend using:
+
+`POST /api/notifications/push/register`
+
+```tsx
+import React from 'react';
+import messaging from '@react-native-firebase/messaging';
+import { IInstall } from 'react-native-iinstall';
+
+const App = () => {
+  const [pushToken, setPushToken] = React.useState<string>();
+
+  React.useEffect(() => {
+    messaging().getToken().then(setPushToken).catch(() => undefined);
+  }, []);
+
+  return (
+    <IInstall
+      apiKey="YOUR_COPIED_API_KEY_FROM_STEP_1"
+      apiEndpoint="https://iinstall.app"
+      pushToken={pushToken}
+    >
+      <AppNavigation />
+    </IInstall>
+  );
+};
+```
+
+Manual helpers are also exported:
+
+```tsx
+import { registerPushToken, unregisterPushToken } from 'react-native-iinstall';
+```
+
+---
+
+## 6. Audio & Video Feedback (v0.2.7+)
 
 The SDK now supports **Audio Feedback** (Voice Notes) and **Screen Recording** with enhanced compatibility and reliability.
 
@@ -155,7 +193,7 @@ Add these keys inside the `<dict>` tag:
 
 ---
 
-## 6. Generate & Upload Installer
+## 7. Generate & Upload Installer
 
 1.  **Build your app**:
     *   **Android**: `./gradlew assembleRelease` (outputs `.apk`)

package/README.md

@@ -49,13 +49,24 @@ Wrap your main app component with the `<IInstall>` provider.
 import React from 'react';
 import { IInstall } from 'react-native-iinstall';
 import AppNavigation from './src/AppNavigation';
+import messaging from '@react-native-firebase/messaging';
 
 const App = () => {
+  const [pushToken, setPushToken] = React.useState<string>();
+
+  React.useEffect(() => {
+    messaging()
+      .getToken()
+      .then(setPushToken)
+      .catch(() => undefined);
+  }, []);
+
   return (
     // Get your API Key from the IInstall Dashboard (Project Settings)
     <IInstall 
       apiKey="YOUR_PROJECT_API_KEY" 
       apiEndpoint="https://iinstall.app" // Optional, defaults to production
+      pushToken={pushToken} // Optional: auto-registers token to iinstall backend
       enabled={__DEV__} // Optional: Only enable in dev/test builds
     >
       <AppNavigation />
@@ -131,6 +142,26 @@ Add to `Info.plist`:
 </IInstall>
 ```
 
+### Push Token Registration Helpers
+
+You can also register/unregister tokens manually:
+
+```tsx
+import { registerPushToken, unregisterPushToken } from 'react-native-iinstall';
+
+await registerPushToken({
+  token: fcmToken,
+  apiKey: 'YOUR_PROJECT_API_KEY',
+  apiEndpoint: 'https://iinstall.app',
+});
+
+await unregisterPushToken({
+  token: fcmToken,
+  apiKey: 'YOUR_PROJECT_API_KEY',
+  apiEndpoint: 'https://iinstall.app',
+});
+```
+
 ### Custom Triggers (Coming Soon)
 - Button-based feedback
 - Screenshot-only mode

package/lib/IInstallWrapper.d.ts

@@ -7,6 +7,10 @@ interface IInstallWrapperProps {
     showDebugButton?: boolean;
     showFloatingButtonOnEmulator?: boolean;
     floatingButtonLabel?: string;
+    pushToken?: string;
+    autoRegisterPushToken?: boolean;
+    projectId?: string;
+    onPushTokenRegisterError?: (error: string) => void;
 }
 export declare const IInstallWrapper: React.FC<IInstallWrapperProps>;
 export default IInstallWrapper;

package/lib/IInstallWrapper.js

@@ -9,8 +9,8 @@ const index_1 = require("./index");
 // Backward-compatible wrapper. The core IInstall component now handles:
 // - shake gesture on real devices
 // - floating manual trigger button on simulator/emulator
-const IInstallWrapper = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enabled = true, showDebugButton: _showDebugButton = false, showFloatingButtonOnEmulator = true, floatingButtonLabel = 'Report Issue', }) => {
-    return (<index_1.IInstall apiKey={apiKey} apiEndpoint={apiEndpoint} enabled={enabled} showFloatingButtonOnEmulator={showFloatingButtonOnEmulator} floatingButtonLabel={floatingButtonLabel}>
+const IInstallWrapper = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enabled = true, showDebugButton: _showDebugButton = false, showFloatingButtonOnEmulator = true, floatingButtonLabel = 'Report Issue', pushToken, autoRegisterPushToken = true, projectId, onPushTokenRegisterError, }) => {
+    return (<index_1.IInstall apiKey={apiKey} apiEndpoint={apiEndpoint} enabled={enabled} showFloatingButtonOnEmulator={showFloatingButtonOnEmulator} floatingButtonLabel={floatingButtonLabel} pushToken={pushToken} autoRegisterPushToken={autoRegisterPushToken} projectId={projectId} onPushTokenRegisterError={onPushTokenRegisterError}>
       {children}
     </index_1.IInstall>);
 };

package/lib/index.d.ts

@@ -6,7 +6,12 @@ interface IInstallProps {
     enabled?: boolean;
     showFloatingButtonOnEmulator?: boolean;
     floatingButtonLabel?: string;
+    pushToken?: string;
+    autoRegisterPushToken?: boolean;
+    projectId?: string;
+    onPushTokenRegisterError?: (error: string) => void;
 }
 export declare const IInstall: React.FC<IInstallProps>;
 export default IInstall;
 export { IInstallWrapper } from './IInstallWrapper';
+export { registerPushToken, unregisterPushToken, type RegisterPushTokenParams, type UnregisterPushTokenParams, type PushRegistrationResult, type PushPlatform, } from './pushRegistration';

package/lib/index.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IInstallWrapper = exports.IInstall = void 0;
+exports.unregisterPushToken = exports.registerPushToken = exports.IInstallWrapper = exports.IInstall = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const react_native_view_shot_1 = require("react-native-view-shot");
@@ -44,13 +44,15 @@ const ShakeDetector_1 = require("./ShakeDetector");
 const FeedbackModal_1 = require("./FeedbackModal");
 const react_native_record_screen_1 = __importDefault(require("react-native-record-screen"));
 const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
-const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enabled = true, showFloatingButtonOnEmulator = true, floatingButtonLabel = 'Report Issue', }) => {
+const pushRegistration_1 = require("./pushRegistration");
+const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enabled = true, showFloatingButtonOnEmulator = true, floatingButtonLabel = 'Report Issue', pushToken, autoRegisterPushToken = true, projectId, onPushTokenRegisterError, }) => {
     const [modalVisible, setModalVisible] = (0, react_1.useState)(false);
     const [screenshotUri, setScreenshotUri] = (0, react_1.useState)(null);
     const [videoUri, setVideoUri] = (0, react_1.useState)(null);
     const [isRecording, setIsRecording] = (0, react_1.useState)(false);
     const [isEmulator, setIsEmulator] = (0, react_1.useState)(false);
     const shakeDetectorRef = (0, react_1.useRef)(null);
+    const lastRegisteredPushTokenRef = (0, react_1.useRef)(null);
     // Refs for stable access in shake callback
     const isRecordingRef = (0, react_1.useRef)(isRecording);
     const modalVisibleRef = (0, react_1.useRef)(modalVisible);
@@ -108,6 +110,55 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
             shakeDetectorRef.current?.stop();
         };
     }, [enabled, isEmulator]);
+    (0, react_1.useEffect)(() => {
+        if (!enabled || !autoRegisterPushToken || !pushToken)
+            return;
+        if (lastRegisteredPushTokenRef.current === pushToken)
+            return;
+        let cancelled = false;
+        const syncPushToken = async () => {
+            const deviceUdid = await react_native_device_info_1.default.getUniqueId().catch(() => undefined);
+            const result = await (0, pushRegistration_1.registerPushToken)({
+                token: pushToken,
+                apiKey,
+                apiEndpoint,
+                deviceUdid,
+                projectId,
+            });
+            if (cancelled)
+                return;
+            if (result.success) {
+                lastRegisteredPushTokenRef.current = pushToken;
+            }
+            else {
+                const message = result.error || 'Failed to register push token';
+                console.warn('IInstall: push token registration failed', message);
+                if (onPushTokenRegisterError) {
+                    onPushTokenRegisterError(message);
+                }
+            }
+        };
+        syncPushToken().catch((error) => {
+            if (cancelled)
+                return;
+            const message = error instanceof Error ? error.message : 'Failed to register push token';
+            console.warn('IInstall: push token registration failed', message);
+            if (onPushTokenRegisterError) {
+                onPushTokenRegisterError(message);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        enabled,
+        autoRegisterPushToken,
+        pushToken,
+        apiKey,
+        apiEndpoint,
+        projectId,
+        onPushTokenRegisterError,
+    ]);
     const handleFloatingButtonPress = async () => {
         await handleShakeCallback.current();
     };
@@ -292,3 +343,6 @@ exports.default = exports.IInstall;
 // Export the wrapper component for simulator/emulator support
 var IInstallWrapper_1 = require("./IInstallWrapper");
 Object.defineProperty(exports, "IInstallWrapper", { enumerable: true, get: function () { return IInstallWrapper_1.IInstallWrapper; } });
+var pushRegistration_2 = require("./pushRegistration");
+Object.defineProperty(exports, "registerPushToken", { enumerable: true, get: function () { return pushRegistration_2.registerPushToken; } });
+Object.defineProperty(exports, "unregisterPushToken", { enumerable: true, get: function () { return pushRegistration_2.unregisterPushToken; } });

package/lib/pushRegistration.d.ts

@@ -0,0 +1,22 @@
+export type PushPlatform = 'IOS' | 'ANDROID';
+export interface RegisterPushTokenParams {
+    token: string;
+    apiKey: string;
+    apiEndpoint?: string;
+    deviceUdid?: string;
+    projectId?: string;
+    platform?: PushPlatform;
+}
+export interface UnregisterPushTokenParams {
+    token: string;
+    apiKey: string;
+    apiEndpoint?: string;
+}
+export interface PushRegistrationResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    status: number;
+}
+export declare function registerPushToken({ token, apiKey, apiEndpoint, deviceUdid, projectId, platform, }: RegisterPushTokenParams): Promise<PushRegistrationResult>;
+export declare function unregisterPushToken({ token, apiKey, apiEndpoint, }: UnregisterPushTokenParams): Promise<PushRegistrationResult>;

package/lib/pushRegistration.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPushToken = registerPushToken;
+exports.unregisterPushToken = unregisterPushToken;
+const react_native_1 = require("react-native");
+function normalizeApiEndpoint(apiEndpoint) {
+    return apiEndpoint.replace(/\/+$/, '');
+}
+function resolvePlatform(platform) {
+    if (platform)
+        return platform;
+    return react_native_1.Platform.OS === 'ios' ? 'IOS' : 'ANDROID';
+}
+async function registerPushToken({ token, apiKey, apiEndpoint = 'https://iinstall.app', deviceUdid, projectId, platform, }) {
+    try {
+        const response = await fetch(`${normalizeApiEndpoint(apiEndpoint)}/api/notifications/push/register`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                token,
+                apiKey,
+                deviceUdid,
+                projectId,
+                platform: resolvePlatform(platform),
+            }),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const data = await response.json().catch(() => ({}));
+        return {
+            success: response.ok,
+            status: response.status,
+            data,
+            error: response.ok ? undefined : data?.error || 'Failed to register push token',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            status: 500,
+            error: error instanceof Error ? error.message : 'Unknown register push error',
+        };
+    }
+}
+async function unregisterPushToken({ token, apiKey, apiEndpoint = 'https://iinstall.app', }) {
+    try {
+        const response = await fetch(`${normalizeApiEndpoint(apiEndpoint)}/api/notifications/push/register`, {
+            method: 'DELETE',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                token,
+                apiKey,
+            }),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const data = await response.json().catch(() => ({}));
+        return {
+            success: response.ok,
+            status: response.status,
+            data,
+            error: response.ok ? undefined : data?.error || 'Failed to unregister push token',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            status: 500,
+            error: error instanceof Error ? error.message : 'Unknown unregister push error',
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iinstall",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "🎯 IInstall React Native SDK - The ultimate beta testing & QA feedback tool. Shake-to-report with voice recordings, screen recordings, and screenshots. Zero-config setup with TypeScript support. Perfect for beta testing, QA teams, and user feedback collection.",
   "author": "TesterFlow Team",
   "license": "MIT",

package/src/IInstallWrapper.tsx

@@ -10,6 +10,10 @@ interface IInstallWrapperProps {
   showDebugButton?: boolean;
   showFloatingButtonOnEmulator?: boolean;
   floatingButtonLabel?: string;
+  pushToken?: string;
+  autoRegisterPushToken?: boolean;
+  projectId?: string;
+  onPushTokenRegisterError?: (error: string) => void;
 }
 
 // Backward-compatible wrapper. The core IInstall component now handles:
@@ -23,6 +27,10 @@ export const IInstallWrapper: React.FC<IInstallWrapperProps> = ({
   showDebugButton: _showDebugButton = false,
   showFloatingButtonOnEmulator = true,
   floatingButtonLabel = 'Report Issue',
+  pushToken,
+  autoRegisterPushToken = true,
+  projectId,
+  onPushTokenRegisterError,
 }) => {
   return (
     <IInstall
@@ -31,6 +39,10 @@ export const IInstallWrapper: React.FC<IInstallWrapperProps> = ({
       enabled={enabled}
       showFloatingButtonOnEmulator={showFloatingButtonOnEmulator}
       floatingButtonLabel={floatingButtonLabel}
+      pushToken={pushToken}
+      autoRegisterPushToken={autoRegisterPushToken}
+      projectId={projectId}
+      onPushTokenRegisterError={onPushTokenRegisterError}
     >
       {children}
     </IInstall>

package/src/index.tsx

@@ -5,6 +5,7 @@ import { ShakeDetector } from './ShakeDetector';
 import { FeedbackModal } from './FeedbackModal';
 import RecordScreen from 'react-native-record-screen';
 import DeviceInfo from 'react-native-device-info';
+import { registerPushToken } from './pushRegistration';
 
 interface IInstallProps {
   apiKey: string;
@@ -13,6 +14,10 @@ interface IInstallProps {
   enabled?: boolean;
   showFloatingButtonOnEmulator?: boolean;
   floatingButtonLabel?: string;
+  pushToken?: string;
+  autoRegisterPushToken?: boolean;
+  projectId?: string;
+  onPushTokenRegisterError?: (error: string) => void;
 }
 
 export const IInstall: React.FC<IInstallProps> = ({ 
@@ -22,6 +27,10 @@ export const IInstall: React.FC<IInstallProps> = ({
   enabled = true,
   showFloatingButtonOnEmulator = true,
   floatingButtonLabel = 'Report Issue',
+  pushToken,
+  autoRegisterPushToken = true,
+  projectId,
+  onPushTokenRegisterError,
 }) => {
   const [modalVisible, setModalVisible] = useState(false);
   const [screenshotUri, setScreenshotUri] = useState<string | null>(null);
@@ -30,6 +39,7 @@ export const IInstall: React.FC<IInstallProps> = ({
   const [isEmulator, setIsEmulator] = useState(false);
   
   const shakeDetectorRef = useRef<ShakeDetector | null>(null);
+  const lastRegisteredPushTokenRef = useRef<string | null>(null);
   
   // Refs for stable access in shake callback
   const isRecordingRef = useRef(isRecording);
@@ -96,6 +106,58 @@ export const IInstall: React.FC<IInstallProps> = ({
     };
   }, [enabled, isEmulator]);
 
+  useEffect(() => {
+    if (!enabled || !autoRegisterPushToken || !pushToken) return;
+    if (lastRegisteredPushTokenRef.current === pushToken) return;
+
+    let cancelled = false;
+
+    const syncPushToken = async () => {
+      const deviceUdid = await DeviceInfo.getUniqueId().catch(() => undefined);
+      const result = await registerPushToken({
+        token: pushToken,
+        apiKey,
+        apiEndpoint,
+        deviceUdid,
+        projectId,
+      });
+
+      if (cancelled) return;
+
+      if (result.success) {
+        lastRegisteredPushTokenRef.current = pushToken;
+      } else {
+        const message = result.error || 'Failed to register push token';
+        console.warn('IInstall: push token registration failed', message);
+        if (onPushTokenRegisterError) {
+          onPushTokenRegisterError(message);
+        }
+      }
+    };
+
+    syncPushToken().catch((error) => {
+      if (cancelled) return;
+      const message =
+        error instanceof Error ? error.message : 'Failed to register push token';
+      console.warn('IInstall: push token registration failed', message);
+      if (onPushTokenRegisterError) {
+        onPushTokenRegisterError(message);
+      }
+    });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    enabled,
+    autoRegisterPushToken,
+    pushToken,
+    apiKey,
+    apiEndpoint,
+    projectId,
+    onPushTokenRegisterError,
+  ]);
+
   const handleFloatingButtonPress = async () => {
     await handleShakeCallback.current();
   };
@@ -329,3 +391,11 @@ export default IInstall;
 
 // Export the wrapper component for simulator/emulator support
 export { IInstallWrapper } from './IInstallWrapper';
+export {
+  registerPushToken,
+  unregisterPushToken,
+  type RegisterPushTokenParams,
+  type UnregisterPushTokenParams,
+  type PushRegistrationResult,
+  type PushPlatform,
+} from './pushRegistration';

package/src/pushRegistration.ts

@@ -0,0 +1,111 @@
+import { Platform } from 'react-native';
+
+export type PushPlatform = 'IOS' | 'ANDROID';
+
+export interface RegisterPushTokenParams {
+  token: string;
+  apiKey: string;
+  apiEndpoint?: string;
+  deviceUdid?: string;
+  projectId?: string;
+  platform?: PushPlatform;
+}
+
+export interface UnregisterPushTokenParams {
+  token: string;
+  apiKey: string;
+  apiEndpoint?: string;
+}
+
+export interface PushRegistrationResult {
+  success: boolean;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  data?: any;
+  error?: string;
+  status: number;
+}
+
+function normalizeApiEndpoint(apiEndpoint: string): string {
+  return apiEndpoint.replace(/\/+$/, '');
+}
+
+function resolvePlatform(platform?: PushPlatform): PushPlatform {
+  if (platform) return platform;
+  return Platform.OS === 'ios' ? 'IOS' : 'ANDROID';
+}
+
+export async function registerPushToken({
+  token,
+  apiKey,
+  apiEndpoint = 'https://iinstall.app',
+  deviceUdid,
+  projectId,
+  platform,
+}: RegisterPushTokenParams): Promise<PushRegistrationResult> {
+  try {
+    const response = await fetch(
+      `${normalizeApiEndpoint(apiEndpoint)}/api/notifications/push/register`,
+      {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          token,
+          apiKey,
+          deviceUdid,
+          projectId,
+          platform: resolvePlatform(platform),
+        }),
+      }
+    );
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const data: any = await response.json().catch(() => ({}));
+    return {
+      success: response.ok,
+      status: response.status,
+      data,
+      error: response.ok ? undefined : data?.error || 'Failed to register push token',
+    };
+  } catch (error) {
+    return {
+      success: false,
+      status: 500,
+      error: error instanceof Error ? error.message : 'Unknown register push error',
+    };
+  }
+}
+
+export async function unregisterPushToken({
+  token,
+  apiKey,
+  apiEndpoint = 'https://iinstall.app',
+}: UnregisterPushTokenParams): Promise<PushRegistrationResult> {
+  try {
+    const response = await fetch(
+      `${normalizeApiEndpoint(apiEndpoint)}/api/notifications/push/register`,
+      {
+        method: 'DELETE',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          token,
+          apiKey,
+        }),
+      }
+    );
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const data: any = await response.json().catch(() => ({}));
+    return {
+      success: response.ok,
+      status: response.status,
+      data,
+      error: response.ok ? undefined : data?.error || 'Failed to unregister push token',
+    };
+  } catch (error) {
+    return {
+      success: false,
+      status: 500,
+      error: error instanceof Error ? error.message : 'Unknown unregister push error',
+    };
+  }
+}