@blumessage/react-chat 1.0.7 → 1.0.9
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/README.md +20 -35
- package/dist/BlumessageChat.js +16 -16
- package/dist/types/BlumessageChat.d.ts +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -83,7 +83,8 @@ function App() {
|
|
|
83
83
|
| `initialMessages` | `Message[]` | `[]` | Pre-populate with messages |
|
|
84
84
|
| `conversationId` | `string` | - | Continue specific conversation |
|
|
85
85
|
| `persistent` | `boolean` | `false` | Use localStorage vs sessionStorage |
|
|
86
|
-
| `showTimestamps` | `boolean` | `false` | Display timestamps: today="
|
|
86
|
+
| `showTimestamps` | `boolean` | `false` | Display timestamps: today="2:00 PM", older="17 July, 1:00 PM" |
|
|
87
|
+
| `typingText` | `string` | `"Agent is typing..."` | Custom text shown while waiting for assistant response |
|
|
87
88
|
| **Event Callbacks** |
|
|
88
89
|
| `onUserMessage` | `(message: Message) => void` | - | Called when user sends message |
|
|
89
90
|
| `onAssistantMessage` | `(message: Message) => void` | - | Called when assistant responds |
|
|
@@ -161,25 +162,37 @@ const initialMessages = [
|
|
|
161
162
|
```tsx
|
|
162
163
|
<BlumessageChat
|
|
163
164
|
apiKey="your-api-key"
|
|
164
|
-
showTimestamps={true} // Shows "
|
|
165
|
+
showTimestamps={true} // Shows "2:00 PM" or "17 July, 1:00 PM"
|
|
165
166
|
floating={false}
|
|
166
167
|
initialMessages={[
|
|
167
168
|
{
|
|
168
169
|
id: '1',
|
|
169
170
|
role: 'assistant' as const,
|
|
170
171
|
content: 'Message from today',
|
|
171
|
-
timestamp: Date.now() - (60 * 60 * 1000) // Shows: "
|
|
172
|
+
timestamp: Date.now() - (60 * 60 * 1000) // Shows: "2:00 PM" (or "14:00")
|
|
172
173
|
},
|
|
173
174
|
{
|
|
174
175
|
id: '2',
|
|
175
176
|
role: 'user' as const,
|
|
176
177
|
content: 'Message from yesterday',
|
|
177
|
-
timestamp: Date.now() - (24 * 60 * 60 * 1000) // Shows: "17 July,
|
|
178
|
+
timestamp: Date.now() - (24 * 60 * 60 * 1000) // Shows: "17 July, 1:00 PM"
|
|
178
179
|
}
|
|
179
180
|
]}
|
|
180
181
|
/>
|
|
181
182
|
```
|
|
182
183
|
|
|
184
|
+
### Custom Typing Indicator
|
|
185
|
+
|
|
186
|
+
```tsx
|
|
187
|
+
<BlumessageChat
|
|
188
|
+
apiKey="your-api-key"
|
|
189
|
+
typingText="Support agent is typing..." // Custom loading message
|
|
190
|
+
// Or use different text for different languages:
|
|
191
|
+
// typingText="L'agent écrit..." // French
|
|
192
|
+
// typingText="El agente está escribiendo..." // Spanish
|
|
193
|
+
/>
|
|
194
|
+
```
|
|
195
|
+
|
|
183
196
|
## Icon Options
|
|
184
197
|
|
|
185
198
|
The `icon` prop accepts **any lucide-react icon name** with flexible naming patterns. The component intelligently matches your input to the appropriate lucide-react icon:
|
|
@@ -262,36 +275,6 @@ interface Message {
|
|
|
262
275
|
}
|
|
263
276
|
```
|
|
264
277
|
|
|
265
|
-
## API Integration
|
|
266
|
-
|
|
267
|
-
### Message Sending
|
|
268
|
-
```
|
|
269
|
-
POST https://api.blumessage.com/api/v1/conversations
|
|
270
|
-
Content-Type: application/json
|
|
271
|
-
Authorization: Bearer {API_KEY}
|
|
272
|
-
|
|
273
|
-
{
|
|
274
|
-
"message": "user input",
|
|
275
|
-
"conversationId": "optional-existing-id"
|
|
276
|
-
}
|
|
277
|
-
```
|
|
278
|
-
|
|
279
|
-
### Conversation History
|
|
280
|
-
```
|
|
281
|
-
GET https://api.blumessage.com/api/v1/conversations/session/{conversationId}
|
|
282
|
-
Authorization: {API_KEY}
|
|
283
|
-
```
|
|
284
|
-
|
|
285
|
-
### API Key Validation
|
|
286
|
-
```
|
|
287
|
-
POST https://api.blumessage.com/api/v1/api-keys/validate
|
|
288
|
-
Content-Type: application/json
|
|
289
|
-
|
|
290
|
-
{
|
|
291
|
-
"apiKey": "your-api-key"
|
|
292
|
-
}
|
|
293
|
-
```
|
|
294
|
-
|
|
295
278
|
## Storage Behavior
|
|
296
279
|
|
|
297
280
|
- **SessionStorage (default)**: Conversations persist until browser tab closes
|
|
@@ -311,4 +294,6 @@ ISC
|
|
|
311
294
|
|
|
312
295
|
## Support
|
|
313
296
|
|
|
314
|
-
For issues and feature requests, please visit the [GitHub repository](https://github.com/Blumessage/react-chat).
|
|
297
|
+
For issues and feature requests, please visit the [GitHub repository](https://github.com/Blumessage/react-chat).
|
|
298
|
+
|
|
299
|
+
For technical support and assistance, please contact us at: **contact@blumessage.com**
|
package/dist/BlumessageChat.js
CHANGED
|
@@ -101,24 +101,24 @@ var clearStoredConversationId = function (persistent) {
|
|
|
101
101
|
}
|
|
102
102
|
};
|
|
103
103
|
export var BlumessageChat = function (_a) {
|
|
104
|
-
var apiKey = _a.apiKey, _b = _a.placeholder, placeholder = _b === void 0 ? "Type your message..." : _b, _c = _a.theme, theme = _c === void 0 ? 'light' : _c, width = _a.width, height = _a.height, _d = _a.size, size = _d === void 0 ? 'medium' : _d, _e = _a.name, name = _e === void 0 ? "Blumessage AI" : _e, _f = _a.subtitle, subtitle = _f === void 0 ? "Online • Instant responses" : _f, _g = _a.initialMessages, initialMessages = _g === void 0 ? [] : _g, onUserMessage = _a.onUserMessage, onAssistantMessage = _a.onAssistantMessage, initialConversationId = _a.conversationId, onConversationIdChange = _a.onConversationIdChange, onChatWidgetOpen = _a.onChatWidgetOpen, onChatWidgetClosed = _a.onChatWidgetClosed, onError = _a.onError, _h = _a.persistent, persistent = _h === void 0 ? false : _h, _j = _a.showTimestamps, showTimestamps = _j === void 0 ? false : _j,
|
|
104
|
+
var apiKey = _a.apiKey, _b = _a.placeholder, placeholder = _b === void 0 ? "Type your message..." : _b, _c = _a.theme, theme = _c === void 0 ? 'light' : _c, width = _a.width, height = _a.height, _d = _a.size, size = _d === void 0 ? 'medium' : _d, _e = _a.name, name = _e === void 0 ? "Blumessage AI" : _e, _f = _a.subtitle, subtitle = _f === void 0 ? "Online • Instant responses" : _f, _g = _a.initialMessages, initialMessages = _g === void 0 ? [] : _g, onUserMessage = _a.onUserMessage, onAssistantMessage = _a.onAssistantMessage, initialConversationId = _a.conversationId, onConversationIdChange = _a.onConversationIdChange, onChatWidgetOpen = _a.onChatWidgetOpen, onChatWidgetClosed = _a.onChatWidgetClosed, onError = _a.onError, _h = _a.persistent, persistent = _h === void 0 ? false : _h, _j = _a.showTimestamps, showTimestamps = _j === void 0 ? false : _j, _k = _a.typingText, typingText = _k === void 0 ? "Agent is typing..." : _k,
|
|
105
105
|
// Floating button props
|
|
106
|
-
|
|
106
|
+
_l = _a.floating,
|
|
107
107
|
// Floating button props
|
|
108
|
-
floating =
|
|
108
|
+
floating = _l === void 0 ? true : _l, _m = _a.buttonText, buttonText = _m === void 0 ? "Chat with us" : _m, _o = _a.buttonPosition, buttonPosition = _o === void 0 ? 'bottom-right' : _o, buttonStyle = _a.buttonStyle, _p = _a.defaultOpen, defaultOpen = _p === void 0 ? false : _p, _q = _a.maximizeToggleButton, maximizeToggleButton = _q === void 0 ? true : _q, _r = _a.fullScreen, fullScreen = _r === void 0 ? false : _r, _s = _a.icon, icon = _s === void 0 ? 'message-circle' : _s,
|
|
109
109
|
// Styling props
|
|
110
|
-
|
|
110
|
+
_t = _a.primaryColor,
|
|
111
111
|
// Styling props
|
|
112
|
-
primaryColor =
|
|
113
|
-
var
|
|
114
|
-
var
|
|
115
|
-
var
|
|
116
|
-
var
|
|
117
|
-
var
|
|
118
|
-
var
|
|
119
|
-
var
|
|
120
|
-
var
|
|
121
|
-
var
|
|
112
|
+
primaryColor = _t === void 0 ? "linear-gradient(to right, #3b82f6,rgb(8, 98, 242))" : _t;
|
|
113
|
+
var _u = useState(false), isInitialized = _u[0], setIsInitialized = _u[1];
|
|
114
|
+
var _v = useState(null), error = _v[0], setError = _v[1];
|
|
115
|
+
var _w = useState(initialMessages), messages = _w[0], setMessages = _w[1];
|
|
116
|
+
var _x = useState(''), inputValue = _x[0], setInputValue = _x[1];
|
|
117
|
+
var _y = useState(initialConversationId || getStoredConversationId(persistent)), conversationId = _y[0], setConversationId = _y[1];
|
|
118
|
+
var _z = useState(defaultOpen), isOpen = _z[0], setIsOpen = _z[1];
|
|
119
|
+
var _0 = useState(false), isAnimating = _0[0], setIsAnimating = _0[1];
|
|
120
|
+
var _1 = useState(false), isLoading = _1[0], setIsLoading = _1[1];
|
|
121
|
+
var _2 = useState(false), isMaximized = _2[0], setIsMaximized = _2[1];
|
|
122
122
|
var messagesEndRef = useRef(null);
|
|
123
123
|
var isInitialLoad = useRef(true);
|
|
124
124
|
// Helper function to format timestamp
|
|
@@ -170,7 +170,7 @@ export var BlumessageChat = function (_a) {
|
|
|
170
170
|
}
|
|
171
171
|
return dimensions;
|
|
172
172
|
};
|
|
173
|
-
var
|
|
173
|
+
var _3 = getDimensions(), actualWidth = _3.width, actualHeight = _3.height;
|
|
174
174
|
// Function to update conversation ID and notify parent
|
|
175
175
|
var updateConversationId = function (newConversationId) {
|
|
176
176
|
setConversationId(newConversationId);
|
|
@@ -633,7 +633,7 @@ export var BlumessageChat = function (_a) {
|
|
|
633
633
|
paddingRight: message.role === 'user' ? '16px' : '0'
|
|
634
634
|
}, children: formatTimestamp(message.timestamp) }))] }) }, message.id)); }), isLoading && (_jsx("div", { className: "flex justify-start", children: _jsx("div", { className: "px-4 py-3 rounded-2xl max-w-[80%] text-sm leading-6 shadow-sm ".concat(theme === 'dark'
|
|
635
635
|
? 'bg-gray-700 text-gray-100 border border-gray-600'
|
|
636
|
-
: 'bg-white text-gray-800 border border-gray-200'), children:
|
|
636
|
+
: 'bg-white text-gray-800 border border-gray-200'), children: _jsx("div", { className: "".concat(theme === 'dark' ? 'text-gray-300' : 'text-gray-600'), style: { fontStyle: 'italic' }, children: typingText }) }) })), messages.length === 0 && !isLoading && (_jsx("div", { className: "text-center text-sm py-8 ".concat(theme === 'dark' ? 'text-gray-400' : 'text-gray-500'), children: "No messages yet. Start a conversation!" })), _jsx("div", { ref: messagesEndRef })] }), _jsx("div", { className: "px-6 py-4 border-t ".concat(theme === 'dark'
|
|
637
637
|
? 'bg-gray-900 border-gray-700'
|
|
638
638
|
: 'bg-white border-gray-100'), children: _jsxs("div", { className: "flex items-center rounded-full px-4 py-3 border ".concat(theme === 'dark'
|
|
639
639
|
? 'bg-gray-800 border-gray-600'
|
|
@@ -36,6 +36,7 @@ export interface BlumessageChatProps {
|
|
|
36
36
|
onError?: (error: string, context?: string) => void;
|
|
37
37
|
persistent?: boolean;
|
|
38
38
|
showTimestamps?: boolean;
|
|
39
|
+
typingText?: string;
|
|
39
40
|
floating?: boolean;
|
|
40
41
|
buttonText?: string;
|
|
41
42
|
buttonPosition?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@blumessage/react-chat",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.9",
|
|
4
4
|
"description": "A React TypeScript chat widget component with floating button, theming, and Blumessage API integration",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Blumessage <contact@blumessage.com>",
|