@solucx/react-native-solucx-widget 0.1.15 → 0.2.0

package/src/__tests__/integration/webview-communication.test.tsx

@@ -0,0 +1,417 @@
+/**
+ * INTEGRATION TEST: WebView Communication
+ * 
+ * CRITICAL: Tests the core WebView message passing bridge between
+ * the embedded widget and React Native.
+ * 
+ * Coverage Target: handleWebViewMessage, handleWebViewLoad, handleClose
+ * Previous Coverage: 0% (CRITICAL GAP)
+ * 
+ * Strategy: Minimal mocking - use real WidgetEventService and components
+ */
+
+import React from 'react';
+import { render, waitFor, fireEvent } from '@testing-library/react-native';
+import { SoluCXWidget } from '../../SoluCXWidget';
+import type { WidgetCallbacks } from '../../interfaces';
+
+// Mock only external dependencies we can't control
+jest.mock('react-native-webview', () => {
+    const React = require('react');
+    const { View } = require('react-native');
+    return {
+        __esModule: true,
+        WebView: React.forwardRef((props: any, ref: any) => {
+            // Store ref methods for testing
+            React.useImperativeHandle(ref, () => ({
+                injectJavaScript: jest.fn((script) => {
+                    // Simulate successful injection
+                    if (props.onLoadEnd) props.onLoadEnd();
+                }),
+            }));
+            
+            return (
+                <View testID="webview" {...props}>
+                    {/* Expose onMessage handler for testing */}
+                    {props.children}
+                </View>
+            );
+        }),
+    };
+});
+
+jest.mock('../../services/widgetBootstrapService', () => ({
+    requestWidgetUrl: jest.fn().mockResolvedValue('https://mock.widget.url/form123'),
+}));
+
+jest.mock('../../utils/urlUtils', () => ({
+    buildWidgetURL: jest.fn().mockReturnValue('https://mock.widget.url/form123'),
+}));
+
+jest.mock('../../services/widgetValidationService', () => ({
+    WidgetValidationService: jest.fn().mockImplementation(() => ({
+        shouldDisplayWidget: jest.fn().mockResolvedValue({ canDisplay: true }),
+    })),
+}));
+
+// Mock storage but keep it functional
+const mockStorage: Record<string, string> = {};
+jest.mock('@react-native-async-storage/async-storage', () => ({
+    __esModule: true,
+    default: {
+        getItem: jest.fn((key: string) => Promise.resolve(mockStorage[key] || null)),
+        setItem: jest.fn((key: string, value: string) => {
+            mockStorage[key] = value;
+            return Promise.resolve();
+        }),
+        removeItem: jest.fn((key: string) => {
+            delete mockStorage[key];
+            return Promise.resolve();
+        }),
+    },
+}));
+
+describe('Integration: WebView Communication', () => {
+    const baseProps = {
+        soluCXKey: 'test-key-123',
+        type: 'modal' as const,
+        data: { 
+            customer_id: 'user-456',
+            form_id: 'form-789', // Required for form mode
+        },
+        options: {
+            height: 400,
+        },
+    };
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        Object.keys(mockStorage).forEach(key => delete mockStorage[key]);
+    });
+
+    describe('Message Handling - Form Events', () => {
+        it('should handle FORM_CLOSE message and call onClosed callback', async () => {
+            const mockOnClosed = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onClosed: mockOnClosed,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            // Wait for widget to be ready
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            const webview = getByTestId('webview');
+
+            // Simulate WebView sending FORM_CLOSE message
+            fireEvent(webview, 'message', {
+                nativeEvent: { data: 'FORM_CLOSE' },
+            });
+
+            // Verify callback was called
+            await waitFor(() => {
+                expect(mockOnClosed).toHaveBeenCalledTimes(1);
+            });
+        }, 15000); // 15 second timeout for slower CI environments
+
+        it('should handle FORM_ERROR message with error text', async () => {
+            const mockOnError = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onError: mockOnError,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Simulate error message with details
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'FORM_ERROR-Network timeout occurred' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnError).toHaveBeenCalledWith('Network timeout occurred');
+            });
+        });
+
+        it('should handle FORM_RESIZE message and update height', async () => {
+            const mockOnResize = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onResize: mockOnResize,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Simulate resize message
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'FORM_RESIZE-650' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnResize).toHaveBeenCalledWith('650');
+            });
+        });
+
+        it('should handle FORM_COMPLETED message with userId', async () => {
+            const mockOnPartialCompleted = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onPartialCompleted: mockOnPartialCompleted,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Simulate form completion
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'FORM_COMPLETED' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnPartialCompleted).toHaveBeenCalledWith(expect.any(String));
+            });
+        });
+
+        it('should handle FORM_PAGECHANGED message', async () => {
+            const mockOnPageChanged = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onPageChanged: mockOnPageChanged,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Simulate page change
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'FORM_PAGECHANGED-2' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnPageChanged).toHaveBeenCalledWith('2');
+            });
+        });
+
+        it('should handle QUESTION_ANSWERED message', async () => {
+            const mockOnQuestionAnswered = jest.fn();
+            const callbacks: WidgetCallbacks = {
+                onQuestionAnswered: mockOnQuestionAnswered,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Simulate question answered
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'QUESTION_ANSWERED' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnQuestionAnswered).toHaveBeenCalledTimes(1);
+            });
+        });
+    });
+
+    describe('Message Handling - Survey Events', () => {
+        const surveyProps = {
+            ...baseProps,
+            data: {
+                customer_id: 'user-456',
+                // No form_id = survey mode
+            },
+        };
+
+        it('should handle closeSoluCXWidget survey event', async () => {
+            const mockOnClosed = jest.fn();
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...surveyProps} callbacks={{ onClosed: mockOnClosed }} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            // Survey uses different event names
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'closeSoluCXWidget' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnClosed).toHaveBeenCalledTimes(1);
+            });
+        });
+
+        it('should handle resizeSoluCXWidget survey event', async () => {
+            const mockOnResize = jest.fn();
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...surveyProps} callbacks={{ onResize: mockOnResize }} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'resizeSoluCXWidget-800' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnResize).toHaveBeenCalledWith('800');
+            });
+        });
+
+        it('should handle completeSoluCXWidget survey event', async () => {
+            const mockOnPartialCompleted = jest.fn();
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...surveyProps} callbacks={{ onPartialCompleted: mockOnPartialCompleted }} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            fireEvent(getByTestId('webview'), 'message', {
+                nativeEvent: { data: 'completeSoluCXWidget' },
+            });
+
+            await waitFor(() => {
+                expect(mockOnPartialCompleted).toHaveBeenCalled();
+            });
+        });
+    });
+
+    describe('Edge Cases - Message Handling', () => {
+        it('should handle rapid successive messages', async () => {
+            const mockOnResize = jest.fn();
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={{ onResize: mockOnResize }} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            const webview = getByTestId('webview');
+
+            // Send 10 resize messages rapidly
+            for (let i = 0; i < 10; i++) {
+                fireEvent(webview, 'message', {
+                    nativeEvent: { data: `FORM_RESIZE-${300 + i * 10}` },
+                });
+            }
+
+            // All should be processed
+            await waitFor(() => {
+                expect(mockOnResize).toHaveBeenCalledTimes(10);
+            });
+
+            // Verify last call had correct value
+            expect(mockOnResize).toHaveBeenLastCalledWith('390');
+        });
+    });
+
+    describe('Close Button Integration', () => {
+        it('should render close button in modal', async () => {
+            const { getByText, getByTestId } = render(
+                <SoluCXWidget {...baseProps} type="modal" />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+                expect(getByText('✕')).toBeTruthy();
+            });
+        });
+    });
+
+    describe('Multiple Callbacks in Single Flow', () => {
+        it('should call multiple callbacks during form interaction flow', async () => {
+            const mockOnPageChanged = jest.fn();
+            const mockOnQuestionAnswered = jest.fn();
+            const mockOnResize = jest.fn();
+            const mockOnPartialCompleted = jest.fn();
+            const mockOnClosed = jest.fn();
+
+            const callbacks: WidgetCallbacks = {
+                onPageChanged: mockOnPageChanged,
+                onQuestionAnswered: mockOnQuestionAnswered,
+                onResize: mockOnResize,
+                onPartialCompleted: mockOnPartialCompleted,
+                onClosed: mockOnClosed,
+            };
+
+            const { getByTestId } = render(
+                <SoluCXWidget {...baseProps} callbacks={callbacks} />
+            );
+
+            await waitFor(() => {
+                expect(getByTestId('webview')).toBeTruthy();
+            });
+
+            const webview = getByTestId('webview');
+
+            // Simulate complete user flow
+            // 1. Form resizes
+            fireEvent(webview, 'message', { nativeEvent: { data: 'FORM_RESIZE-400' } });
+            
+            // 2. User goes to page 2
+            fireEvent(webview, 'message', { nativeEvent: { data: 'FORM_PAGECHANGED-2' } });
+            
+            // 3. User answers a question
+            fireEvent(webview, 'message', { nativeEvent: { data: 'QUESTION_ANSWERED' } });
+            
+            // 4. Form resizes again
+            fireEvent(webview, 'message', { nativeEvent: { data: 'FORM_RESIZE-500' } });
+            
+            // 5. User completes form
+            fireEvent(webview, 'message', { nativeEvent: { data: 'FORM_COMPLETED' } });
+            
+            // 6. User closes
+            fireEvent(webview, 'message', { nativeEvent: { data: 'FORM_CLOSE' } });
+
+            // Verify all callbacks were called in order
+            await waitFor(() => {
+                expect(mockOnResize).toHaveBeenCalledTimes(2);
+                expect(mockOnPageChanged).toHaveBeenCalledTimes(1);
+                expect(mockOnQuestionAnswered).toHaveBeenCalledTimes(1);
+                expect(mockOnPartialCompleted).toHaveBeenCalledTimes(1);
+                expect(mockOnClosed).toHaveBeenCalledTimes(1);
+            });
+
+            // Verify correct arguments
+            expect(mockOnResize).toHaveBeenNthCalledWith(1, '400');
+            expect(mockOnResize).toHaveBeenNthCalledWith(2, '500');
+            expect(mockOnPageChanged).toHaveBeenCalledWith('2');
+        });
+    });
+});

package/src/__tests__/urlUtils.test.ts

@@ -1,56 +1,56 @@
-import { buildWidgetURL } from '../utils/urlUtils';
-
-describe('urlUtils', () => {
-    describe('buildWidgetURL', () => {
-        const mockKey = 'test-widget-key';
-
-        it('should build URL with transaction_id when provided', () => {
-            const data = {
-                customer_id: 'customer123',
-                form_id: 'form456',
-                transaction_id: 'trans789'
-            };
-
-            const result = buildWidgetURL(mockKey, data);
-
-            expect(result).toContain('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget');
-            expect(result).toContain('customer_id=customer123');
-            expect(result).toContain('form_id=form456');
-            expect(result).toContain('transaction_id=trans789');
-        });
-
-        it('should build URL with empty transaction_id when not provided', () => {
-            const data = {
-                customer_id: 'customer123',
-                form_id: 'form456'
-            };
-
-            const result = buildWidgetURL(mockKey, data);
-
-            expect(result).toContain('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget');
-            expect(result).toContain('transaction_id=&');
-            expect(result).toContain('customer_id=customer123');
-            expect(result).toContain('form_id=form456');
-        });
-
-        it('should handle empty data object', () => {
-            const data = {};
-
-            const result = buildWidgetURL(mockKey, data);
-
-            expect(result).toBe('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget&transaction_id=&');
-        });
-
-        it('should encode URL parameters correctly', () => {
-            const data = {
-                email: 'test@example.com',
-                name: 'John Doe'
-            };
-
-            const result = buildWidgetURL(mockKey, data);
-
-            expect(result).toContain('email=test%40example.com');
-            expect(result).toContain('name=John+Doe');
-        });
-    });
-});
+import { buildWidgetURL } from '../utils/urlUtils';
+
+describe('urlUtils', () => {
+    describe('buildWidgetURL', () => {
+        const mockKey = 'test-widget-key';
+
+        it('should build URL with transaction_id when provided', () => {
+            const data = {
+                customer_id: 'customer123',
+                form_id: 'form456',
+                transaction_id: 'trans789'
+            };
+
+            const result = buildWidgetURL(mockKey, data);
+
+            expect(result).toContain('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget');
+            expect(result).toContain('customer_id=customer123');
+            expect(result).toContain('form_id=form456');
+            expect(result).toContain('transaction_id=trans789');
+        });
+
+        it('should build URL with empty transaction_id when not provided', () => {
+            const data = {
+                customer_id: 'customer123',
+                form_id: 'form456'
+            };
+
+            const result = buildWidgetURL(mockKey, data);
+
+            expect(result).toContain('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget');
+            expect(result).toContain('transaction_id=&');
+            expect(result).toContain('customer_id=customer123');
+            expect(result).toContain('form_id=form456');
+        });
+
+        it('should handle empty data object', () => {
+            const data = {};
+
+            const result = buildWidgetURL(mockKey, data);
+
+            expect(result).toBe('https://survey-link.solucx.com.br/link/test-widget-key/?mode=widget&transaction_id=&');
+        });
+
+        it('should encode URL parameters correctly', () => {
+            const data = {
+                email: 'test@example.com',
+                name: 'John Doe'
+            };
+
+            const result = buildWidgetURL(mockKey, data);
+
+            expect(result).toContain('email=test%40example.com');
+            expect(result).toContain('name=John+Doe');
+        });
+    });
+});

package/src/__tests__/useDeviceInfoCollector.test.ts

@@ -0,0 +1,109 @@
+import { Platform, Dimensions } from 'react-native';
+import { getDeviceInfo } from '../hooks/useDeviceInfoCollector';
+
+jest.mock('react-native', () => ({
+  Platform: {
+    OS: 'ios',
+    Version: '16.0',
+    constants: {},
+  },
+  Dimensions: {
+    get: jest.fn(),
+  },
+}));
+
+jest.mock('react-native-device-info', () => ({
+  getModel: () => 'iPhone 14',
+}), { virtual: true });
+
+const mockDimensionsGet = Dimensions.get as jest.MockedFunction<typeof Dimensions.get>;
+
+describe('useDeviceInfoCollector', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('getDeviceInfo', () => {
+    it('should return complete device information', () => {
+      mockDimensionsGet.mockImplementation((type) => {
+        if (type === 'screen') {
+          return { width: 390, height: 844, scale: 3, fontScale: 1 };
+        }
+        return { width: 390, height: 844, scale: 3, fontScale: 1 };
+      });
+
+      const deviceInfo = getDeviceInfo();
+
+      expect(deviceInfo).toEqual({
+        platform: 'ios',
+        osVersion: '16.0',
+        screenWidth: 390,
+        screenHeight: 844,
+        windowWidth: 390,
+        windowHeight: 844,
+        scale: 3,
+        fontScale: 1,
+        deviceType: 'phone',
+        model: 'iPhone 14',
+      });
+    });
+
+    it('should identify device as tablet when dimensions are large', () => {
+      mockDimensionsGet.mockImplementation((type) => {
+        if (type === 'screen') {
+          return { width: 768, height: 1024, scale: 2, fontScale: 1 };
+        }
+        return { width: 768, height: 1024, scale: 2, fontScale: 1 };
+      });
+
+      const deviceInfo = getDeviceInfo();
+
+      expect(deviceInfo.deviceType).toBe('tablet');
+    });
+
+    it('should identify device as phone when dimensions are small', () => {
+      mockDimensionsGet.mockImplementation((type) => {
+        if (type === 'screen') {
+          return { width: 375, height: 812, scale: 3, fontScale: 1 };
+        }
+        return { width: 375, height: 812, scale: 3, fontScale: 1 };
+      });
+
+      const deviceInfo = getDeviceInfo();
+
+      expect(deviceInfo.deviceType).toBe('phone');
+    });
+
+    it('should return model from react-native-device-info', () => {
+      mockDimensionsGet.mockImplementation(() => ({
+        width: 390,
+        height: 844,
+        scale: 3,
+        fontScale: 1,
+      }));
+
+      const deviceInfo = getDeviceInfo();
+
+      expect(deviceInfo.model).toBe('iPhone 14');
+    });
+  });
+
+  describe('platform detection', () => {
+    it('should detect Android platform', () => {
+      (Platform.OS as any) = 'android';
+      (Platform.Version as any) = 33;
+
+      mockDimensionsGet.mockImplementation(() => ({
+        width: 412,
+        height: 915,
+        scale: 2.625,
+        fontScale: 1,
+      }));
+
+      const deviceInfo = getDeviceInfo();
+
+      expect(deviceInfo.platform).toBe('android');
+      expect(deviceInfo.osVersion).toBe('33');
+    });
+  });
+});