turbodesk-livechat-react-native 0.1.0-alpha.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.
Files changed (171) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +91 -0
  3. package/dist/api/conversation-api.d.ts +16 -0
  4. package/dist/api/conversation-api.d.ts.map +1 -0
  5. package/dist/api/conversation-api.js +44 -0
  6. package/dist/api/conversation-api.js.map +1 -0
  7. package/dist/api/file-api.d.ts +5 -0
  8. package/dist/api/file-api.d.ts.map +1 -0
  9. package/dist/api/file-api.js +15 -0
  10. package/dist/api/file-api.js.map +1 -0
  11. package/dist/api/widget-api.d.ts +4 -0
  12. package/dist/api/widget-api.d.ts.map +1 -0
  13. package/dist/api/widget-api.js +15 -0
  14. package/dist/api/widget-api.js.map +1 -0
  15. package/dist/axios/axios.d.ts +32 -0
  16. package/dist/axios/axios.d.ts.map +1 -0
  17. package/dist/axios/axios.js +120 -0
  18. package/dist/axios/axios.js.map +1 -0
  19. package/dist/core/config.d.ts +17 -0
  20. package/dist/core/config.d.ts.map +1 -0
  21. package/dist/core/config.js +42 -0
  22. package/dist/core/config.js.map +1 -0
  23. package/dist/core/http-client.d.ts +33 -0
  24. package/dist/core/http-client.d.ts.map +1 -0
  25. package/dist/core/http-client.js +104 -0
  26. package/dist/core/http-client.js.map +1 -0
  27. package/dist/core/identity.d.ts +7 -0
  28. package/dist/core/identity.d.ts.map +1 -0
  29. package/dist/core/identity.js +62 -0
  30. package/dist/core/identity.js.map +1 -0
  31. package/dist/core/visitor-params.d.ts +15 -0
  32. package/dist/core/visitor-params.d.ts.map +1 -0
  33. package/dist/core/visitor-params.js +45 -0
  34. package/dist/core/visitor-params.js.map +1 -0
  35. package/dist/hooks/use-conversations.d.ts +12 -0
  36. package/dist/hooks/use-conversations.d.ts.map +1 -0
  37. package/dist/hooks/use-conversations.js +177 -0
  38. package/dist/hooks/use-conversations.js.map +1 -0
  39. package/dist/hooks/use-live-chat.d.ts +30 -0
  40. package/dist/hooks/use-live-chat.d.ts.map +1 -0
  41. package/dist/hooks/use-live-chat.js +52 -0
  42. package/dist/hooks/use-live-chat.js.map +1 -0
  43. package/dist/hooks/use-messages.d.ts +11 -0
  44. package/dist/hooks/use-messages.d.ts.map +1 -0
  45. package/dist/hooks/use-messages.js +185 -0
  46. package/dist/hooks/use-messages.js.map +1 -0
  47. package/dist/hooks/use-send-message.d.ts +22 -0
  48. package/dist/hooks/use-send-message.d.ts.map +1 -0
  49. package/dist/hooks/use-send-message.js +125 -0
  50. package/dist/hooks/use-send-message.js.map +1 -0
  51. package/dist/index.d.ts +49 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +97 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/navigation/LiveChatPanel.d.ts +5 -0
  56. package/dist/navigation/LiveChatPanel.d.ts.map +1 -0
  57. package/dist/navigation/LiveChatPanel.js +81 -0
  58. package/dist/navigation/LiveChatPanel.js.map +1 -0
  59. package/dist/navigation/panel-router-context.d.ts +22 -0
  60. package/dist/navigation/panel-router-context.d.ts.map +1 -0
  61. package/dist/navigation/panel-router-context.js +42 -0
  62. package/dist/navigation/panel-router-context.js.map +1 -0
  63. package/dist/navigation/router-types.d.ts +2 -0
  64. package/dist/navigation/router-types.d.ts.map +1 -0
  65. package/dist/navigation/router-types.js +3 -0
  66. package/dist/navigation/router-types.js.map +1 -0
  67. package/dist/provider/LiveChatContext.d.ts +4 -0
  68. package/dist/provider/LiveChatContext.d.ts.map +1 -0
  69. package/dist/provider/LiveChatContext.js +35 -0
  70. package/dist/provider/LiveChatContext.js.map +1 -0
  71. package/dist/provider/LiveChatProvider.d.ts +3 -0
  72. package/dist/provider/LiveChatProvider.d.ts.map +1 -0
  73. package/dist/provider/LiveChatProvider.js +308 -0
  74. package/dist/provider/LiveChatProvider.js.map +1 -0
  75. package/dist/provider/types.d.ts +42 -0
  76. package/dist/provider/types.d.ts.map +1 -0
  77. package/dist/provider/types.js +3 -0
  78. package/dist/provider/types.js.map +1 -0
  79. package/dist/realtime/ws-client.d.ts +51 -0
  80. package/dist/realtime/ws-client.d.ts.map +1 -0
  81. package/dist/realtime/ws-client.js +322 -0
  82. package/dist/realtime/ws-client.js.map +1 -0
  83. package/dist/ui/components/AssigneeAvatar.d.ts +12 -0
  84. package/dist/ui/components/AssigneeAvatar.d.ts.map +1 -0
  85. package/dist/ui/components/AssigneeAvatar.js +58 -0
  86. package/dist/ui/components/AssigneeAvatar.js.map +1 -0
  87. package/dist/ui/components/Avatar.d.ts +10 -0
  88. package/dist/ui/components/Avatar.d.ts.map +1 -0
  89. package/dist/ui/components/Avatar.js +76 -0
  90. package/dist/ui/components/Avatar.js.map +1 -0
  91. package/dist/ui/components/ConversationHeader.d.ts +10 -0
  92. package/dist/ui/components/ConversationHeader.d.ts.map +1 -0
  93. package/dist/ui/components/ConversationHeader.js +90 -0
  94. package/dist/ui/components/ConversationHeader.js.map +1 -0
  95. package/dist/ui/components/ConversationListScreen.d.ts +9 -0
  96. package/dist/ui/components/ConversationListScreen.d.ts.map +1 -0
  97. package/dist/ui/components/ConversationListScreen.js +350 -0
  98. package/dist/ui/components/ConversationListScreen.js.map +1 -0
  99. package/dist/ui/components/ConversationScreen.d.ts +8 -0
  100. package/dist/ui/components/ConversationScreen.d.ts.map +1 -0
  101. package/dist/ui/components/ConversationScreen.js +235 -0
  102. package/dist/ui/components/ConversationScreen.js.map +1 -0
  103. package/dist/ui/components/HomeScreen.d.ts +6 -0
  104. package/dist/ui/components/HomeScreen.d.ts.map +1 -0
  105. package/dist/ui/components/HomeScreen.js +133 -0
  106. package/dist/ui/components/HomeScreen.js.map +1 -0
  107. package/dist/ui/components/LivechatMessageRenderer.d.ts +17 -0
  108. package/dist/ui/components/LivechatMessageRenderer.d.ts.map +1 -0
  109. package/dist/ui/components/LivechatMessageRenderer.js +122 -0
  110. package/dist/ui/components/LivechatMessageRenderer.js.map +1 -0
  111. package/dist/ui/components/LogMessage.d.ts +5 -0
  112. package/dist/ui/components/LogMessage.d.ts.map +1 -0
  113. package/dist/ui/components/LogMessage.js +83 -0
  114. package/dist/ui/components/LogMessage.js.map +1 -0
  115. package/dist/ui/components/MessageBubble.d.ts +15 -0
  116. package/dist/ui/components/MessageBubble.d.ts.map +1 -0
  117. package/dist/ui/components/MessageBubble.js +84 -0
  118. package/dist/ui/components/MessageBubble.js.map +1 -0
  119. package/dist/ui/components/MessageComposer.d.ts +31 -0
  120. package/dist/ui/components/MessageComposer.d.ts.map +1 -0
  121. package/dist/ui/components/MessageComposer.js +295 -0
  122. package/dist/ui/components/MessageComposer.js.map +1 -0
  123. package/dist/ui/components/WsStatusStrip.d.ts +2 -0
  124. package/dist/ui/components/WsStatusStrip.d.ts.map +1 -0
  125. package/dist/ui/components/WsStatusStrip.js +103 -0
  126. package/dist/ui/components/WsStatusStrip.js.map +1 -0
  127. package/dist/ui/icons.d.ts +22 -0
  128. package/dist/ui/icons.d.ts.map +1 -0
  129. package/dist/ui/icons.js +71 -0
  130. package/dist/ui/icons.js.map +1 -0
  131. package/dist/ui/theme.d.ts +72 -0
  132. package/dist/ui/theme.d.ts.map +1 -0
  133. package/dist/ui/theme.js +170 -0
  134. package/dist/ui/theme.js.map +1 -0
  135. package/docs/backend-contract.md +392 -0
  136. package/docs/migration-notes.md +32 -0
  137. package/package.json +60 -0
  138. package/src/api/conversation-api.ts +71 -0
  139. package/src/api/file-api.ts +14 -0
  140. package/src/api/widget-api.ts +12 -0
  141. package/src/axios/axios.ts +159 -0
  142. package/src/core/config.ts +54 -0
  143. package/src/core/http-client.ts +136 -0
  144. package/src/core/identity.ts +68 -0
  145. package/src/core/visitor-params.ts +48 -0
  146. package/src/hooks/use-conversations.ts +181 -0
  147. package/src/hooks/use-live-chat.ts +84 -0
  148. package/src/hooks/use-messages.ts +188 -0
  149. package/src/hooks/use-send-message.ts +159 -0
  150. package/src/index.ts +114 -0
  151. package/src/navigation/LiveChatPanel.tsx +118 -0
  152. package/src/navigation/panel-router-context.tsx +89 -0
  153. package/src/navigation/router-types.ts +1 -0
  154. package/src/provider/LiveChatContext.ts +33 -0
  155. package/src/provider/LiveChatProvider.tsx +380 -0
  156. package/src/provider/types.ts +57 -0
  157. package/src/realtime/ws-client.ts +369 -0
  158. package/src/types/react-native-svg.d.ts +10 -0
  159. package/src/ui/components/AssigneeAvatar.tsx +102 -0
  160. package/src/ui/components/Avatar.tsx +110 -0
  161. package/src/ui/components/ConversationHeader.tsx +202 -0
  162. package/src/ui/components/ConversationListScreen.tsx +454 -0
  163. package/src/ui/components/ConversationScreen.tsx +362 -0
  164. package/src/ui/components/HomeScreen.tsx +278 -0
  165. package/src/ui/components/LivechatMessageRenderer.tsx +268 -0
  166. package/src/ui/components/LogMessage.tsx +88 -0
  167. package/src/ui/components/MessageBubble.tsx +148 -0
  168. package/src/ui/components/MessageComposer.tsx +461 -0
  169. package/src/ui/components/WsStatusStrip.tsx +123 -0
  170. package/src/ui/icons.tsx +111 -0
  171. package/src/ui/theme.ts +237 -0
@@ -0,0 +1,237 @@
1
+ import { useColorScheme } from "react-native";
2
+
3
+ export type AppearanceMode = "light" | "dark" | "system";
4
+
5
+ export type ThemeColors = {
6
+ brand: string;
7
+ background: string;
8
+ surface: string;
9
+ text: string;
10
+ textMuted: string;
11
+ bubbleIn: string;
12
+ bubbleOut: string;
13
+ bubbleTextIn: string;
14
+ bubbleTextOut: string;
15
+ border: string;
16
+ unreadBadge: string;
17
+ unreadBadgeText: string;
18
+ headerBackground: string;
19
+ headerText: string;
20
+ composerBackground: string;
21
+ composerBorder: string;
22
+ inputText: string;
23
+ sendButtonBackground: string;
24
+ sendButtonIcon: string;
25
+ error: string;
26
+ homeBackground: string;
27
+ homeHeaderText: string;
28
+ presenceActive: string;
29
+ presenceAway: string;
30
+ };
31
+
32
+ export type ThemeFontSizes = {
33
+ xs: number;
34
+ sm: number;
35
+ md: number;
36
+ lg: number;
37
+ xl: number;
38
+ };
39
+
40
+ export type ThemeSpacing = {
41
+ xs: number;
42
+ sm: number;
43
+ md: number;
44
+ lg: number;
45
+ xl: number;
46
+ };
47
+
48
+ export type ThemeBorderRadius = {
49
+ sm: number;
50
+ md: number;
51
+ lg: number;
52
+ bubble: number;
53
+ avatar: number;
54
+ };
55
+
56
+ export type ThemeConfig = {
57
+ colors: ThemeColors;
58
+ fontSizes: ThemeFontSizes;
59
+ spacing: ThemeSpacing;
60
+ borderRadius: ThemeBorderRadius;
61
+ appearance: AppearanceMode;
62
+ useBrandThemingForChat: boolean;
63
+ };
64
+
65
+ // ─── Defaults ─────────────────────────────────────────────────────────────────
66
+
67
+ const DEFAULT_BRAND = "#6366f1";
68
+ const DEFAULT_NOTIFICATION = "#ef4444";
69
+
70
+ const lightColors: ThemeColors = {
71
+ brand: DEFAULT_BRAND,
72
+ background: "#f9fafb",
73
+ surface: "#ffffff",
74
+ text: "#18181b",
75
+ textMuted: "#71717a",
76
+ bubbleIn: "#f3f4f6",
77
+ bubbleOut: DEFAULT_BRAND,
78
+ bubbleTextIn: "#18181b",
79
+ bubbleTextOut: "#ffffff",
80
+ border: "rgba(0,0,0,0.08)",
81
+ unreadBadge: DEFAULT_NOTIFICATION,
82
+ unreadBadgeText: "#ffffff",
83
+ headerBackground: "#ffffff",
84
+ headerText: "#18181b",
85
+ composerBackground: "#ffffff",
86
+ composerBorder: "rgba(0,0,0,0.12)",
87
+ inputText: "#18181b",
88
+ sendButtonBackground: DEFAULT_BRAND,
89
+ sendButtonIcon: "#ffffff",
90
+ error: DEFAULT_NOTIFICATION,
91
+ homeBackground: DEFAULT_BRAND,
92
+ homeHeaderText: "#ffffff",
93
+ presenceActive: "#10b981",
94
+ presenceAway: "#f59e0b",
95
+ };
96
+
97
+ const darkColors: ThemeColors = {
98
+ brand: DEFAULT_BRAND,
99
+ background: "#09090b",
100
+ surface: "#18181b",
101
+ text: "#fafafa",
102
+ textMuted: "#a1a1aa",
103
+ bubbleIn: "#27272a",
104
+ bubbleOut: DEFAULT_BRAND,
105
+ bubbleTextIn: "#fafafa",
106
+ bubbleTextOut: "#ffffff",
107
+ border: "rgba(255,255,255,0.08)",
108
+ unreadBadge: DEFAULT_NOTIFICATION,
109
+ unreadBadgeText: "#ffffff",
110
+ headerBackground: "#18181b",
111
+ headerText: "#fafafa",
112
+ composerBackground: "#18181b",
113
+ composerBorder: "rgba(255,255,255,0.12)",
114
+ inputText: "#fafafa",
115
+ sendButtonBackground: DEFAULT_BRAND,
116
+ sendButtonIcon: "#ffffff",
117
+ error: DEFAULT_NOTIFICATION,
118
+ homeBackground: "#18181b",
119
+ homeHeaderText: "#fafafa",
120
+ presenceActive: "#10b981",
121
+ presenceAway: "#f59e0b",
122
+ };
123
+
124
+ export const defaultTheme: ThemeConfig = {
125
+ appearance: "light",
126
+ useBrandThemingForChat: false,
127
+ colors: lightColors,
128
+ fontSizes: { xs: 11, sm: 13, md: 15, lg: 17, xl: 20 },
129
+ spacing: { xs: 4, sm: 8, md: 12, lg: 16, xl: 24 },
130
+ borderRadius: { sm: 4, md: 8, lg: 16, bubble: 18, avatar: 999 },
131
+ };
132
+
133
+ // ─── Helpers ──────────────────────────────────────────────────────────────────
134
+
135
+ export function getBrandColor(settings: any): string {
136
+ return settings?.brandColor?.trim() || DEFAULT_BRAND;
137
+ }
138
+
139
+ export function getNotificationIconColor(settings: any): string {
140
+ return settings?.notificationIconColor?.trim() || DEFAULT_NOTIFICATION;
141
+ }
142
+
143
+ /** Readable text on top of a hex brand color. */
144
+ export function contrastingTextOnBrand(hex: string): string {
145
+ const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
146
+ if (!m) return "#ffffff";
147
+ const n = parseInt(m[1], 16);
148
+ const r = (n >> 16) & 255;
149
+ const g = (n >> 8) & 255;
150
+ const b = n & 255;
151
+ const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
152
+ return luminance > 0.55 ? "#111827" : "#ffffff";
153
+ }
154
+
155
+ export function getWidgetName(config: any): string {
156
+ return config?.widgetName?.trim() || "Chat with us";
157
+ }
158
+
159
+ export function getWidgetGreeting(settings: any): string {
160
+ const g = (settings?.greetings ?? settings?.greeting ?? "").toString().trim();
161
+ return g || "Hi! How can we help you today?";
162
+ }
163
+
164
+ export function getWidgetTitle(config: any): string {
165
+ return config?.widgetSettings?.title?.trim() || "Chat with us";
166
+ }
167
+
168
+ export function getWidgetDescription(settings: any): string {
169
+ return settings?.description?.trim() || "We usually reply within a few minutes.";
170
+ }
171
+
172
+ export function getBrandLogoUrl(settings: any): string | undefined {
173
+ return settings?.brandLogoUrl?.trim() || undefined;
174
+ }
175
+
176
+ export const POWERED_BY_TEXT = "Powered by Turbodesk";
177
+
178
+ // ─── Theme resolution ─────────────────────────────────────────────────────────
179
+
180
+ /** Resolve appearance from widget settings + system color scheme. */
181
+ export function useEffectiveAppearance(settings: any): "light" | "dark" {
182
+ const systemScheme = useColorScheme();
183
+ const mode = settings?.theme as string | undefined;
184
+ if (mode === "dark" || mode === "custom") return "dark";
185
+ if (mode === "light") return "light";
186
+ if (mode === "system") return systemScheme === "dark" ? "dark" : "light";
187
+ return "light";
188
+ }
189
+
190
+ export function buildThemeFromBrand(
191
+ brandColor: string,
192
+ appearance: AppearanceMode,
193
+ useBrandThemingForChat: boolean,
194
+ override?: Partial<ThemeConfig>
195
+ ): ThemeConfig {
196
+ const isDark = appearance === "dark";
197
+ const base = isDark ? darkColors : lightColors;
198
+ const contrastText = contrastingTextOnBrand(brandColor);
199
+
200
+ const colors: ThemeColors = {
201
+ ...base,
202
+ brand: brandColor,
203
+ bubbleOut: brandColor,
204
+ sendButtonBackground: brandColor,
205
+ homeBackground: isDark ? base.homeBackground : brandColor,
206
+ homeHeaderText: isDark ? base.homeHeaderText : contrastText,
207
+ ...(useBrandThemingForChat
208
+ ? { bubbleOut: brandColor, bubbleTextOut: contrastText }
209
+ : {}),
210
+ };
211
+
212
+ return mergeTheme(
213
+ {
214
+ ...defaultTheme,
215
+ appearance,
216
+ useBrandThemingForChat,
217
+ colors,
218
+ },
219
+ override
220
+ );
221
+ }
222
+
223
+ export function mergeTheme(
224
+ base: ThemeConfig,
225
+ override?: Partial<ThemeConfig>
226
+ ): ThemeConfig {
227
+ if (!override) return base;
228
+ return {
229
+ colors: { ...base.colors, ...override.colors },
230
+ fontSizes: { ...base.fontSizes, ...override.fontSizes },
231
+ spacing: { ...base.spacing, ...override.spacing },
232
+ borderRadius: { ...base.borderRadius, ...override.borderRadius },
233
+ appearance: override.appearance ?? base.appearance,
234
+ useBrandThemingForChat:
235
+ override.useBrandThemingForChat ?? base.useBrandThemingForChat,
236
+ };
237
+ }