@robylon/react-native-sdk 2.0.22-dev.0 → 2.0.22-staging.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.npmignore.development +18 -0
- package/.npmignore.production +8 -0
- package/.npmignore.staging +7 -0
- package/babel.config.js +17 -0
- package/lib/commonjs/openChatbot.js +1 -2
- package/lib/commonjs/openChatbot.js.map +1 -1
- package/lib/commonjs/version.js +1 -1
- package/lib/commonjs/versions/version.staging.js +1 -1
- package/lib/module/version.js +1 -1
- package/lib/module/versions/version.staging.js +1 -1
- package/lib/typescript/version.d.ts +1 -1
- package/lib/typescript/version.d.ts.map +1 -1
- package/lib/typescript/versions/version.staging.d.ts +1 -1
- package/package.json +1 -1
- package/scripts/create-branch.js +577 -0
- package/scripts/create-version-tag.js +29 -0
- package/scripts/get-next-version.js +29 -0
- package/scripts/husky-setup.js +32 -0
- package/scripts/prevent-direct-branch.js +37 -0
- package/scripts/publish-version.js +13 -0
- package/scripts/release.js +77 -0
- package/scripts/setup-git-hooks.js +18 -0
- package/scripts/update-version.js +28 -0
- package/scripts/validate-branch-name.sh +65 -0
- package/scripts/validate-publish.js +48 -0
- package/src/Chatbotsdk.tsx +782 -0
- package/src/FloatingButton/launchers/ImageLauncher.tsx +75 -0
- package/src/FloatingButton/launchers/TextLauncher.tsx +84 -0
- package/src/FloatingButton/launchers/TextualImageLauncher.tsx +133 -0
- package/src/FloatingButton.tsx +97 -0
- package/src/LoadingIndicator.tsx +11 -0
- package/src/Toast.tsx +65 -0
- package/src/components/DebugButton.tsx +46 -0
- package/src/components/ErrorBoundary.tsx +38 -0
- package/src/config.ts +4 -0
- package/src/constants/errorConstants.ts +21 -0
- package/src/constants/fontStyles.ts +3 -0
- package/src/constants.ts +4 -0
- package/src/global.d.ts +11 -0
- package/src/hooks/useChatbotEvents.ts +93 -0
- package/src/index.tsx +10 -0
- package/src/openChatbot.ts +11 -0
- package/src/openChatbot.tsx +0 -0
- package/src/services/ErrorTrackingService.ts +217 -0
- package/src/types/events.ts +25 -0
- package/src/types/react-native-flipper-performance-plugin.d.ts +3 -0
- package/src/types/react-native-globals.d.ts +10 -0
- package/src/utils/animations.ts +120 -0
- package/src/utils/colorUtils.ts +35 -0
- package/src/utils/cookieUtils.ts +7 -0
- package/src/utils/debugConfig.ts +56 -0
- package/src/utils/debugMenu.ts +14 -0
- package/src/utils/errorHandler.ts +58 -0
- package/src/utils/logger.ts +14 -0
- package/src/utils/systemInfo.ts +84 -0
- package/src/utils/webViewStorage.ts +62 -0
- package/src/version.ts +2 -0
- package/src/versions/version.dev.ts +2 -0
- package/src/versions/version.production.ts +2 -0
- package/src/versions/version.staging.ts +2 -0
- package/tsconfig.build.json +16 -0
- package/tsconfig.json +26 -0
- package/usage/react-native-ios-docs.md +0 -185
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { logger } from "./logger";
|
|
2
|
+
|
|
3
|
+
export enum StorageMessageType {
|
|
4
|
+
GET_STORAGE = "GET_STORAGE",
|
|
5
|
+
SET_STORAGE = "SET_STORAGE",
|
|
6
|
+
STORAGE_READY = "STORAGE_READY",
|
|
7
|
+
STORAGE_ERROR = "STORAGE_ERROR",
|
|
8
|
+
STORAGE_RESPONSE = "STORAGE_RESPONSE",
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export interface StorageMessage {
|
|
12
|
+
type: StorageMessageType;
|
|
13
|
+
key?: string;
|
|
14
|
+
value?: string;
|
|
15
|
+
error?: string;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export const getStorageScript = () => `
|
|
19
|
+
window.handleStorageOperation = function(message) {
|
|
20
|
+
try {
|
|
21
|
+
switch(message.type) {
|
|
22
|
+
case '${StorageMessageType.GET_STORAGE}':
|
|
23
|
+
const value = localStorage.getItem(message.key);
|
|
24
|
+
window.ReactNativeWebView.postMessage(JSON.stringify({
|
|
25
|
+
type: '${StorageMessageType.STORAGE_RESPONSE}',
|
|
26
|
+
key: message.key,
|
|
27
|
+
value: value
|
|
28
|
+
}));
|
|
29
|
+
break;
|
|
30
|
+
case '${StorageMessageType.SET_STORAGE}':
|
|
31
|
+
localStorage.setItem(message.key, message.value);
|
|
32
|
+
window.ReactNativeWebView.postMessage(JSON.stringify({
|
|
33
|
+
type: '${StorageMessageType.STORAGE_RESPONSE}',
|
|
34
|
+
key: message.key,
|
|
35
|
+
value: message.value
|
|
36
|
+
}));
|
|
37
|
+
break;
|
|
38
|
+
}
|
|
39
|
+
} catch (error) {
|
|
40
|
+
window.ReactNativeWebView.postMessage(JSON.stringify({
|
|
41
|
+
type: '${StorageMessageType.STORAGE_ERROR}',
|
|
42
|
+
error: error.message
|
|
43
|
+
}));
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
window.ReactNativeWebView.postMessage(JSON.stringify({
|
|
48
|
+
type: '${StorageMessageType.STORAGE_READY}'
|
|
49
|
+
}));
|
|
50
|
+
`;
|
|
51
|
+
|
|
52
|
+
export const createStorageMessage = (
|
|
53
|
+
type: StorageMessageType,
|
|
54
|
+
key?: string,
|
|
55
|
+
value?: string
|
|
56
|
+
): string => {
|
|
57
|
+
return `window.handleStorageOperation(${JSON.stringify({
|
|
58
|
+
type,
|
|
59
|
+
key,
|
|
60
|
+
value,
|
|
61
|
+
})});`;
|
|
62
|
+
};
|
package/src/version.ts
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"extends": "./tsconfig",
|
|
3
|
+
"compilerOptions": {
|
|
4
|
+
"declaration": true,
|
|
5
|
+
"outDir": "./lib/typescript"
|
|
6
|
+
},
|
|
7
|
+
"exclude": [
|
|
8
|
+
"**/__tests__",
|
|
9
|
+
"**/__mocks__",
|
|
10
|
+
"**/__fixtures__",
|
|
11
|
+
"node_modules",
|
|
12
|
+
"babel.config.js",
|
|
13
|
+
"metro.config.js",
|
|
14
|
+
"jest.config.js"
|
|
15
|
+
]
|
|
16
|
+
}
|
package/tsconfig.json
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "esnext",
|
|
4
|
+
"module": "esnext",
|
|
5
|
+
"lib": ["esnext"],
|
|
6
|
+
"jsx": "react-native",
|
|
7
|
+
"strict": true,
|
|
8
|
+
"moduleResolution": "node",
|
|
9
|
+
"allowSyntheticDefaultImports": true,
|
|
10
|
+
"esModuleInterop": true,
|
|
11
|
+
"skipLibCheck": true,
|
|
12
|
+
"forceConsistentCasingInFileNames": true,
|
|
13
|
+
"resolveJsonModule": true,
|
|
14
|
+
"isolatedModules": true,
|
|
15
|
+
"noEmit": false,
|
|
16
|
+
"emitDeclarationOnly": true,
|
|
17
|
+
"declaration": true,
|
|
18
|
+
"types": ["react-native", "node"]
|
|
19
|
+
},
|
|
20
|
+
"exclude": [
|
|
21
|
+
"node_modules",
|
|
22
|
+
"babel.config.js",
|
|
23
|
+
"metro.config.js",
|
|
24
|
+
"jest.config.js"
|
|
25
|
+
]
|
|
26
|
+
}
|
|
@@ -1,185 +0,0 @@
|
|
|
1
|
-
# Robylon React Native SDK Documentation
|
|
2
|
-
|
|
3
|
-
## Installation
|
|
4
|
-
|
|
5
|
-
First, install the package using npm or yarn:
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
# Using npm
|
|
9
|
-
npm install @robylon/react-native-sdk react-native-webview
|
|
10
|
-
|
|
11
|
-
# Using yarn
|
|
12
|
-
yarn add @robylon/react-native-sdk react-native-webview
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## Prerequisites
|
|
16
|
-
|
|
17
|
-
- React Native project set up for iOS
|
|
18
|
-
- `react-native-webview` installed and configured
|
|
19
|
-
- Valid Robylon API key
|
|
20
|
-
|
|
21
|
-
## Basic Implementation
|
|
22
|
-
|
|
23
|
-
### 1. Import the SDK
|
|
24
|
-
|
|
25
|
-
```typescript
|
|
26
|
-
import { ChatbotSDK } from "@robylon/react-native-sdk";
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### 2. Basic Usage
|
|
30
|
-
|
|
31
|
-
```typescript
|
|
32
|
-
import React from "react";
|
|
33
|
-
import { View } from "react-native";
|
|
34
|
-
import { ChatbotSDK } from "@robylon/react-native-sdk";
|
|
35
|
-
|
|
36
|
-
const App = () => {
|
|
37
|
-
return (
|
|
38
|
-
<View style={{ flex: 1 }}>
|
|
39
|
-
<ChatbotSDK
|
|
40
|
-
api_key="YOUR_API_KEY"
|
|
41
|
-
user_id="USER_ID"
|
|
42
|
-
user_token="USER_TOKEN"
|
|
43
|
-
/>
|
|
44
|
-
</View>
|
|
45
|
-
);
|
|
46
|
-
};
|
|
47
|
-
|
|
48
|
-
export default App;
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## Props Reference
|
|
52
|
-
|
|
53
|
-
### Required Props
|
|
54
|
-
|
|
55
|
-
| Prop | Type | Description |
|
|
56
|
-
| --------- | ------ | ------------------------------ |
|
|
57
|
-
| `api_key` | string | Your Robylon API key |
|
|
58
|
-
| `user_id` | string | Unique identifier for the user |
|
|
59
|
-
|
|
60
|
-
### Optional Props
|
|
61
|
-
|
|
62
|
-
| Prop | Type | Default | Description |
|
|
63
|
-
| ---------------------- | ---------------------- | --------- | -------------------------------------------- |
|
|
64
|
-
| `user_token` | string | undefined | Authentication token for the user |
|
|
65
|
-
| `additional_params` | Record<string, string> | {} | Additional parameters to pass to the chatbot |
|
|
66
|
-
| `show_floating_button` | boolean | true | Whether to show the floating button |
|
|
67
|
-
| `isFullScreen` | boolean | true | Whether to display in fullscreen mode |
|
|
68
|
-
| `enableAnimation` | boolean | true | Enable/disable animations |
|
|
69
|
-
| `onMessage` | (message: any) => void | undefined | Callback for chatbot messages |
|
|
70
|
-
| `onOpen` | () => void | undefined | Callback when chatbot opens |
|
|
71
|
-
| `onClose` | () => void | undefined | Callback when chatbot closes |
|
|
72
|
-
|
|
73
|
-
## Advanced Implementation
|
|
74
|
-
|
|
75
|
-
### Custom Configuration Example
|
|
76
|
-
|
|
77
|
-
```typescript
|
|
78
|
-
import React from "react";
|
|
79
|
-
import { View } from "react-native";
|
|
80
|
-
import { ChatbotSDK } from "@robylon/react-native-sdk";
|
|
81
|
-
|
|
82
|
-
const App = () => {
|
|
83
|
-
const handleMessage = (message) => {
|
|
84
|
-
console.log("Received message:", message);
|
|
85
|
-
};
|
|
86
|
-
|
|
87
|
-
const handleOpen = () => {
|
|
88
|
-
console.log("Chatbot opened");
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
const handleClose = () => {
|
|
92
|
-
console.log("Chatbot closed");
|
|
93
|
-
};
|
|
94
|
-
|
|
95
|
-
return (
|
|
96
|
-
<View style={{ flex: 1 }}>
|
|
97
|
-
<ChatbotSDK
|
|
98
|
-
api_key="YOUR_API_KEY"
|
|
99
|
-
user_id="USER_ID"
|
|
100
|
-
user_token="USER_TOKEN"
|
|
101
|
-
additional_params={{
|
|
102
|
-
theme: "light",
|
|
103
|
-
language: "en",
|
|
104
|
-
}}
|
|
105
|
-
show_floating_button={true}
|
|
106
|
-
isFullScreen={true}
|
|
107
|
-
enableAnimation={true}
|
|
108
|
-
onMessage={handleMessage}
|
|
109
|
-
onOpen={handleOpen}
|
|
110
|
-
onClose={handleClose}
|
|
111
|
-
/>
|
|
112
|
-
</View>
|
|
113
|
-
);
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
export default App;
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
<!-- ### Handling Messages
|
|
120
|
-
|
|
121
|
-
The `onMessage` callback receives messages in the following format:
|
|
122
|
-
|
|
123
|
-
```typescript
|
|
124
|
-
interface ChatbotMessage {
|
|
125
|
-
type: string;
|
|
126
|
-
data?: any;
|
|
127
|
-
}
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
Example message handler:
|
|
131
|
-
|
|
132
|
-
```typescript
|
|
133
|
-
const handleMessage = (message: ChatbotMessage) => {
|
|
134
|
-
switch (message.type) {
|
|
135
|
-
case 'user_message':
|
|
136
|
-
console.log('User sent:', message.data);
|
|
137
|
-
break;
|
|
138
|
-
case 'bot_response':
|
|
139
|
-
console.log('Bot responded:', message.data);
|
|
140
|
-
break;
|
|
141
|
-
// Handle other message types
|
|
142
|
-
}
|
|
143
|
-
};
|
|
144
|
-
``` -->
|
|
145
|
-
|
|
146
|
-
## Styling and Customization
|
|
147
|
-
|
|
148
|
-
The SDK automatically fetches and applies your organization's branding configuration, including:
|
|
149
|
-
|
|
150
|
-
- Brand color
|
|
151
|
-
- Launcher logo
|
|
152
|
-
- Welcome message
|
|
153
|
-
|
|
154
|
-
<!-- These are fetched using the provided API key and user credentials. -->
|
|
155
|
-
|
|
156
|
-
## Best Practices
|
|
157
|
-
|
|
158
|
-
1. **Error Handling**: Always implement error handling for network requests and message processing.
|
|
159
|
-
2. **User Authentication**: Ensure user_id and user_token are properly managed and updated.
|
|
160
|
-
3. **Performance**: Consider using `useMemo` or `useCallback` for callback functions to optimize performance.
|
|
161
|
-
4. **Testing**: Test the implementation across different iOS devices and orientations.
|
|
162
|
-
|
|
163
|
-
## Troubleshooting
|
|
164
|
-
|
|
165
|
-
Common issues and solutions:
|
|
166
|
-
|
|
167
|
-
1. **WebView Not Loading**
|
|
168
|
-
|
|
169
|
-
- Verify internet connectivity
|
|
170
|
-
- Check if API key is valid
|
|
171
|
-
- Ensure WebView permissions are properly configured
|
|
172
|
-
|
|
173
|
-
2. **Authentication Issues**
|
|
174
|
-
|
|
175
|
-
- Verify user_token is valid and not expired
|
|
176
|
-
- Check if user_id is correctly formatted
|
|
177
|
-
|
|
178
|
-
3. **UI Issues**
|
|
179
|
-
- Ensure proper layout hierarchy
|
|
180
|
-
- Check for conflicts with other UI elements
|
|
181
|
-
- Verify styling properties
|
|
182
|
-
|
|
183
|
-
## Support
|
|
184
|
-
|
|
185
|
-
For additional support or to report issues, please contact Robylon support or refer to the official documentation.
|