releasebird-javascript-sdk 1.0.29 → 1.0.30

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.
@@ -0,0 +1,6 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="AgentMigrationStateService">
4
+ <option name="migrationStatus" value="COMPLETED" />
5
+ </component>
6
+ </project>
@@ -0,0 +1,6 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="AskMigrationStateService">
4
+ <option name="migrationStatus" value="COMPLETED" />
5
+ </component>
6
+ </project>
@@ -0,0 +1,6 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="Ask2AgentMigrationStateService">
4
+ <option name="migrationStatus" value="COMPLETED" />
5
+ </component>
6
+ </project>
@@ -0,0 +1,6 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="EditMigrationStateService">
4
+ <option name="migrationStatus" value="COMPLETED" />
5
+ </component>
6
+ </project>
package/README.md CHANGED
@@ -1,51 +1,156 @@
1
- ![image info](./image.webp)
2
-
3
- # Javascript SDK
4
-
5
- - PING ✅
6
- - Screenshot ✅
7
- - Video ✅
8
- - Badge
9
- - Identify ✅
10
- - Widget Bubble ✅
11
- - Show Image ✅
12
-
13
- # iOS SDK
14
-
15
- - PING ✅
16
- - Screenshot ❌
17
- - Video
18
- - Badge ✅
19
- - Identify
20
- - Show Image ✅
21
- - Widget Bubble ✅
22
-
23
- # Android SDK
24
-
25
- - PING ✅
26
- - Screenshot ❌
27
- - Video ❌
28
- - Badge
29
- - Identify ✅
30
- - Show Image ✅
31
- - Widget Bubble ✅
32
-
33
- # React Native SDK
34
-
35
- - PING ✅
36
- - Screenshot
37
- - Video ❌
38
- - Badge
39
- - Identify ✅
40
- - Show Image ✅
41
- - Widget Bubble
42
-
43
- # Capacitor SDK
44
-
45
- - PING ❌
46
- - Screenshot ❌
47
- - Video ❌
48
- - Badge ❌
49
- - Identify ❌
50
- - Show Image ❌
51
- - Widget Bubble ❌
1
+ # Releasebird JavaScript SDK
2
+
3
+ Official JavaScript SDK for [Releasebird](https://releasebird.com) - Collect user feedback, bug reports, and feature requests directly from your web application.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install releasebird-javascript-sdk
9
+ ```
10
+
11
+ or
12
+
13
+ ```bash
14
+ yarn add releasebird-javascript-sdk
15
+ ```
16
+
17
+ ## Quick Start
18
+
19
+ ### Basic Setup
20
+
21
+ ```javascript
22
+ import Rbird from 'releasebird-javascript-sdk';
23
+
24
+ // Initialize with your API key
25
+ Rbird.initialize('YOUR_API_KEY');
26
+ ```
27
+
28
+ ### Initialize without the default widget button
29
+
30
+ ```javascript
31
+ Rbird.initialize('YOUR_API_KEY', false);
32
+ ```
33
+
34
+ ## API Reference
35
+
36
+ ### `Rbird.initialize(apiKey, showButton?)`
37
+
38
+ Initializes the Releasebird SDK.
39
+
40
+ **Parameters:**
41
+ - `apiKey` (string, required): Your Releasebird API key
42
+ - `showButton` (boolean, optional): Show the feedback widget button. Default: `true`
43
+
44
+ **Example:**
45
+ ```javascript
46
+ Rbird.initialize('YOUR_API_KEY');
47
+ // or
48
+ Rbird.initialize('YOUR_API_KEY', true);
49
+ ```
50
+
51
+ ### `Rbird.identify(userId, hash?)`
52
+
53
+ Identify a user for tracking feedback and session data.
54
+
55
+ **Parameters:**
56
+ - `userId` (string, required): Unique identifier for the user
57
+ - `hash` (string, optional): Security hash for user verification
58
+
59
+ **Example:**
60
+ ```javascript
61
+ Rbird.identify('user@example.com');
62
+ // or with hash
63
+ Rbird.identify('user@example.com', 'security-hash');
64
+ ```
65
+
66
+ ### `Rbird.showWidget()`
67
+
68
+ Programmatically open the feedback widget.
69
+
70
+ **Example:**
71
+ ```javascript
72
+ Rbird.showWidget();
73
+ ```
74
+
75
+ ### `Rbird.showButton(visible)`
76
+
77
+ Show or hide the feedback widget button.
78
+
79
+ **Parameters:**
80
+ - `visible` (boolean, required): `true` to show, `false` to hide
81
+
82
+ **Example:**
83
+ ```javascript
84
+ Rbird.showButton(true); // Show button
85
+ Rbird.showButton(false); // Hide button
86
+ ```
87
+
88
+ ### `Rbird.logout()`
89
+
90
+ Clear the current user session.
91
+
92
+ **Example:**
93
+ ```javascript
94
+ Rbird.logout();
95
+ ```
96
+
97
+ ### `Rbird.setStyles(backgroundColor?, textColor?, launcherColor?, launcherPosition?, spaceLeftRight?, spaceBottom?)`
98
+
99
+ Customize the appearance of the feedback widget.
100
+
101
+ **Parameters:**
102
+ - `backgroundColor` (string, optional): Widget background color. Default: `'blue'`
103
+ - `textColor` (string, optional): Widget text color. Default: `'red'`
104
+ - `launcherColor` (string, optional): Launcher button color. Default: `'orange'`
105
+ - `launcherPosition` (string, optional): Position of the launcher. Default: `'bottom'`
106
+ - `spaceLeftRight` (number, optional): Horizontal spacing in pixels. Default: `30`
107
+ - `spaceBottom` (number, optional): Bottom spacing in pixels. Default: `30`
108
+
109
+ **Example:**
110
+ ```javascript
111
+ Rbird.setStyles('#000000', '#FFFFFF', '#FF5722', 'bottom', 20, 20);
112
+ ```
113
+
114
+ ## Features
115
+
116
+ - ✅ Automatic session tracking
117
+ - ✅ Screenshot capture
118
+ - ✅ Video recording
119
+ - ✅ Badge notifications
120
+ - ✅ User identification
121
+ - ✅ Customizable widget appearance
122
+ - ✅ Console log tracking
123
+ - ✅ Mobile responsive
124
+
125
+ ## TypeScript Support
126
+
127
+ This package includes TypeScript definitions out of the box.
128
+
129
+ ```typescript
130
+ import Rbird from 'releasebird-javascript-sdk';
131
+
132
+ Rbird.initialize('YOUR_API_KEY');
133
+ Rbird.identify('user@example.com');
134
+ ```
135
+
136
+ ## Requirements
137
+
138
+ - Modern browser with ES6+ support
139
+ - DOM environment (browser, not Node.js)
140
+
141
+ ## License
142
+
143
+ Commercial - See LICENSE file for details
144
+
145
+ ## Support
146
+
147
+ - **Issues**: [GitHub Issues](https://github.com/bxt-team/releasebird-javascript-sdk/issues)
148
+ - **Website**: [https://releasebird.com](https://releasebird.com)
149
+
150
+ ## Author
151
+
152
+ buildnext GmbH
153
+
154
+ ---
155
+
156
+ **Note**: This SDK is designed for browser environments only and requires access to the DOM and browser APIs.