releasebird-javascript-sdk 1.0.28 → 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.
- package/.idea/copilot.data.migration.agent.xml +6 -0
- package/.idea/copilot.data.migration.ask.xml +6 -0
- package/.idea/copilot.data.migration.ask2agent.xml +6 -0
- package/.idea/copilot.data.migration.edit.xml +6 -0
- package/README.md +156 -51
- package/build/index.js +1 -1
- package/package.json +1 -1
- package/published/1.0.29/index.js +1 -0
- package/published/1.0.30/index.js +1 -0
- package/published/latest/index.js +1 -1
- package/src/SVGEditor.js +84 -5
- package/src/Styles.js +14 -0
- package/webpack.config.js +1 -1
package/README.md
CHANGED
|
@@ -1,51 +1,156 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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.
|