react-native-iinstall 0.2.12 → 0.2.14

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

@@ -34,9 +34,12 @@ Transform your app's feedback collection with our powerful shake-to-report SDK.
    npm install react-native-iinstall
    ```
 
-   **Note**: This package automatically installs required dependencies (`react-native-sensors`, `react-native-view-shot`, etc.).
+2. Install required native peer dependencies in your app root:
+   ```bash
+   npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+   ```
 
-2. Link native modules (iOS only, non-Expo):
+3. Link native modules (iOS only, non-Expo):
    ```bash
    cd ios && pod install
    ```
@@ -49,13 +52,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 +145,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
@@ -143,6 +177,7 @@ Add to `Info.plist`:
 - **Network errors?** Verify `apiEndpoint` is base URL only (not `/api/sdk/issue`)
 - **Permissions denied?** Check platform-specific setup in integration guide
 - **Audio issues?** Ensure SDK v0.2.7+ for AAC codec support
+- **Native module is null/undefined?** Reinstall peer deps in app root, run `cd ios && pod install`, then rebuild the app
 
 ### Getting Help
 - 📖 [Complete Integration Guide](INTEGRATION_GUIDE.md)

package/RELEASE_MANIFEST.json

@@ -0,0 +1,8 @@
+{
+  "version": "0.2.14",
+  "highlights": [
+    "Auto push token registration support via IInstall pushToken prop",
+    "Manual helpers: registerPushToken and unregisterPushToken",
+    "Maintains audio/video feedback workflow and emulator floating button"
+  ]
+}

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/lib/scripts/check-release-manifest.d.mts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/scripts/check-release-manifest.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+"use strict";
+import fs from 'node:fs';
+import path from 'node:path';
+const cwd = process.cwd();
+const packagePath = path.join(cwd, 'package.json');
+const manifestPath = path.join(cwd, 'RELEASE_MANIFEST.json');
+function readJson(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+try {
+    if (!fs.existsSync(manifestPath)) {
+        console.error('RELEASE_MANIFEST.json not found');
+        process.exit(1);
+    }
+    const pkg = readJson(packagePath);
+    const manifest = readJson(manifestPath);
+    const packageVersion = String(pkg?.version || '').trim();
+    const manifestVersion = String(manifest?.version || '').trim();
+    if (!packageVersion) {
+        console.error('SDK package version missing in package.json');
+        process.exit(1);
+    }
+    if (!manifestVersion) {
+        console.error('RELEASE_MANIFEST version missing');
+        process.exit(1);
+    }
+    if (packageVersion !== manifestVersion) {
+        console.error(`Release mismatch: package.json=${packageVersion}, RELEASE_MANIFEST.json=${manifestVersion}`);
+        process.exit(1);
+    }
+    console.log(`Release manifest check OK: react-native-iinstall@${packageVersion}`);
+}
+catch (error) {
+    console.error('Failed to verify RELEASE_MANIFEST:', error);
+    process.exit(1);
+}

package/lib/scripts/sync-release-manifest.d.mts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/scripts/sync-release-manifest.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+"use strict";
+import fs from 'node:fs';
+import path from 'node:path';
+const cwd = process.cwd();
+const packagePath = path.join(cwd, 'package.json');
+const manifestPath = path.join(cwd, 'RELEASE_MANIFEST.json');
+function readJson(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+function writeJson(filePath, value) {
+    fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+try {
+    const pkg = readJson(packagePath);
+    const packageVersion = String(pkg?.version || '').trim();
+    if (!packageVersion) {
+        console.error('SDK package version missing in package.json');
+        process.exit(1);
+    }
+    let manifest = {
+        version: packageVersion,
+        highlights: [],
+    };
+    if (fs.existsSync(manifestPath)) {
+        manifest = {
+            ...readJson(manifestPath),
+            version: packageVersion,
+        };
+    }
+    writeJson(manifestPath, manifest);
+    console.log(`Synced RELEASE_MANIFEST -> react-native-iinstall@${packageVersion}`);
+}
+catch (error) {
+    console.error('Failed to sync RELEASE_MANIFEST:', error);
+    process.exit(1);
+}

package/lib/src/FeedbackModal.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface FeedbackModalProps {
+    visible: boolean;
+    onClose: () => void;
+    screenshotUri: string | null;
+    videoUri?: string | null;
+    onStartRecording?: () => void;
+    apiKey: string;
+    apiEndpoint: string;
+}
+export declare const FeedbackModal: React.FC<FeedbackModalProps>;
+export {};