@defra/flood-webchat 0.0.1-beta.5 → 0.0.1-beta.50

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 (50) hide show
  1. package/README.md +89 -1
  2. package/dist/client.js +1 -754
  3. package/dist/server.js +1 -379
  4. package/main.scss +10 -6
  5. package/package.json +8 -3
  6. package/src/client/components/availability/availability.jsx +79 -54
  7. package/src/client/components/availability/availability.scss +20 -32
  8. package/src/client/components/chat/chat.jsx +233 -0
  9. package/src/client/components/chat/chat.scss +260 -0
  10. package/src/client/components/errorSummary/error-summary.jsx +34 -0
  11. package/src/client/components/live-region.jsx +55 -0
  12. package/src/client/components/message/message.jsx +21 -0
  13. package/src/client/components/panel/panel-footer.jsx +9 -0
  14. package/src/client/components/panel/panel-header.jsx +55 -15
  15. package/src/client/components/panel/panel.jsx +128 -71
  16. package/src/client/components/panel/panel.scss +63 -22
  17. package/src/client/components/screens/end-chat.jsx +77 -0
  18. package/src/client/components/screens/feedback.jsx +65 -0
  19. package/src/client/components/screens/pre-chat.jsx +50 -30
  20. package/src/client/components/screens/request-chat.jsx +177 -4
  21. package/src/client/components/screens/settings.jsx +97 -0
  22. package/src/client/components/screens/unavailable.jsx +23 -0
  23. package/src/client/components/skip-link.jsx +42 -0
  24. package/src/client/hooks/useFocusedElements.js +80 -0
  25. package/src/client/hooks/useTextareaAutosize.js +13 -0
  26. package/src/client/index.jsx +18 -1
  27. package/src/client/lib/agent-status-headline.js +17 -0
  28. package/src/client/lib/check-availability.js +1 -0
  29. package/src/client/lib/history.js +13 -0
  30. package/src/client/lib/message-notification.js +30 -0
  31. package/src/client/lib/transform-messages.js +47 -0
  32. package/src/client/scss/_objects.scss +33 -0
  33. package/src/client/scss/_settings.scss +101 -0
  34. package/src/client/scss/_tools.scss +33 -0
  35. package/src/client/scss/_utilities.scss +25 -0
  36. package/src/client/store/AppProvider.jsx +183 -0
  37. package/src/client/store/actions-map.js +152 -0
  38. package/src/client/store/constants.js +3 -0
  39. package/src/client/store/reducer.js +31 -0
  40. package/src/client/store/useApp.js +5 -0
  41. package/src/client/store/useChatSdk.js +37 -0
  42. package/src/server/index.js +15 -6
  43. package/src/server/lib/client.js +31 -35
  44. package/src/server/lib/utils.js +5 -3
  45. package/webpack.config.mjs +0 -2
  46. package/webpack.prod.mjs +7 -0
  47. package/dist/client.js.map +0 -1
  48. package/dist/server.js.map +0 -1
  49. package/src/client/lib/external-stores.js +0 -4
  50. package/src/client/lib/external-sync-store.js +0 -42
@@ -1,73 +1,120 @@
1
- import React, { useEffect, useRef, useState } from 'react'
1
+ import React, { useEffect, useRef } from 'react'
2
+
2
3
  import { classnames } from '../../lib/classnames'
3
- import { useMessageThread, useWebchatOpenState } from '../../lib/external-stores'
4
4
  import { Panel } from '../panel/panel.jsx'
5
+ import { SkipLink } from '../skip-link.jsx'
6
+
7
+ import { useApp } from '../../store/useApp'
8
+ import { historyPushState, historyReplaceState } from '../../lib/history.js'
9
+ import { LiveRegion } from '../live-region.jsx'
10
+
11
+ export function Availability () {
12
+ const { availability, isChatOpen, setChatVisibility, unseenCount, threadId, setUnseenCount, setInstigatorId, setLiveRegionText } = useApp()
5
13
 
6
- export function Availability (props) {
7
- const [isOpen, setOpen] = useWebchatOpenState()
8
- const [isFixed, setFixed] = useState(false)
9
14
  const buttonRef = useRef()
10
- const onClick = () => {
11
- setOpen(!isOpen)
15
+
16
+ const showUnseenCount = unseenCount > 0 && !isChatOpen
17
+
18
+ const messageText = unseenCount > 1 ? 'new messages' : 'new message'
19
+
20
+ const onClick = e => {
21
+ e.preventDefault()
22
+ setUnseenCount(0)
23
+ setChatVisibility(!isChatOpen)
24
+ setInstigatorId(e.target.id)
25
+
26
+ if (!isChatOpen) {
27
+ historyPushState()
28
+ } else {
29
+ historyReplaceState()
30
+ }
12
31
  }
32
+
13
33
  const onKeyDown = event => {
14
34
  if (event.key === ' ') {
15
35
  event.preventDefault()
16
36
  }
17
37
  }
38
+
18
39
  const onKeyUp = event => {
19
40
  if (event.key === ' ') {
20
- setOpen(!isOpen)
41
+ setUnseenCount(0)
42
+ setChatVisibility(!isChatOpen)
21
43
  }
22
44
  }
23
45
 
24
- const intersectionCallback = entries => {
25
- const [entry] = entries
26
- const isBelowFold = !entry.isIntersecting && entry.boundingClientRect.top > 0
27
- setFixed(!isOpen && isBelowFold)
28
- }
29
-
30
46
  useEffect(() => {
31
- const observer = new window.IntersectionObserver(intersectionCallback, {
32
- rootMargin: '35px'
33
- })
34
- const parentElement = buttonRef.current?.parentElement
35
- if (parentElement) {
36
- observer.observe(parentElement)
47
+ if (showUnseenCount) {
48
+ setLiveRegionText(`Floodline webchat - ${unseenCount} ${messageText}`)
37
49
  }
50
+
38
51
  return () => {
39
- if (parentElement) {
40
- observer.unobserve(parentElement)
41
- }
52
+ setLiveRegionText()
42
53
  }
43
- }, [buttonRef, isOpen])
54
+ }, [unseenCount, isChatOpen])
44
55
 
45
56
  useEffect(() => {
46
- document.documentElement.classList.toggle('wc-scroll-padding', isFixed)
47
- document.body.classList.toggle('wc-scroll-padding', isFixed)
48
- }, [isFixed])
57
+ const onScroll = () => {
58
+ if (!threadId) {
59
+ return
60
+ }
49
61
 
50
- switch (props.availability) {
62
+ if (availability !== 'AVAILABLE') {
63
+ return
64
+ }
65
+
66
+ const rect = buttonRef.current.parentElement.getBoundingClientRect()
67
+
68
+ const isBelowFold = rect.top + 35 > (window.innerHeight || document.documentElement.clientHeight)
69
+ const isFixed = !isChatOpen && isBelowFold
70
+
71
+ document.documentElement.classList.toggle('wc-u-scroll-padding', isFixed)
72
+ document.body.classList.toggle('wc-u-scroll-padding', isFixed)
73
+ buttonRef.current.classList.toggle('wc-availability--fixed', isFixed)
74
+ }
75
+
76
+ document.addEventListener('scroll', onScroll)
77
+ onScroll()
78
+
79
+ return () => {
80
+ document.removeEventListener('scroll', onScroll)
81
+ }
82
+ }, [threadId, isChatOpen, availability])
83
+
84
+ switch (availability) {
51
85
  case 'AVAILABLE':
52
86
  return (
53
87
  <>
54
88
  <div
55
- className={classnames('wc-availability', isFixed && 'wc-availability--fixed')}
89
+ className={classnames('wc-availability', isChatOpen && 'wc-open')}
56
90
  ref={buttonRef}
57
91
  >
58
92
  <div className='wc-availability__inner'>
59
93
  <a
94
+ id='webchat-start-chat-link'
60
95
  className='wc-availability__link'
61
- href='#webchat' role='button' draggable='false'
96
+ href='#webchat'
97
+ draggable='false'
62
98
  onClick={onClick}
63
99
  onKeyUp={onKeyUp}
64
100
  onKeyDown={onKeyDown}
101
+ role='button'
102
+ data-module='govuk-button'
65
103
  >
66
- <AvailabilityContent />
104
+ {!threadId ? <>Start chat</> : <>Show chat</>}
105
+ {showUnseenCount
106
+ ? (
107
+ <span className='wc-availability__unseen'>
108
+ {unseenCount}
109
+ <span className='govuk-visually-hidden'> {messageText}</span>
110
+ </span>
111
+ )
112
+ : null}
67
113
  </a>
68
114
  </div>
69
115
  </div>
70
- {isOpen && <Panel screenNumber={0} onClose={onClick} />}
116
+ {!isChatOpen ? <LiveRegion /> : <Panel />}
117
+ <SkipLink />
71
118
  </>
72
119
  )
73
120
  case 'EXISTING':
@@ -81,25 +128,3 @@ export function Availability (props) {
81
128
  )
82
129
  }
83
130
  }
84
-
85
- function AvailabilityContent () {
86
- const [thread] = useMessageThread()
87
- const unreadMessageCount = thread.filter(message => !message.read).length
88
- if (!thread.length) {
89
- return (
90
- <>
91
- Start Chat
92
- </>
93
- )
94
- }
95
- return (
96
- <>
97
- Show Chat {!!unreadMessageCount && (
98
- <>
99
- <span className='wc-availability__unseen'>{unreadMessageCount}</span>
100
- <span className='govuk-visually-hidden'> {unreadMessageCount === 1 ? 'new message' : 'new messages'}</span>
101
- </>
102
- )}
103
- </>
104
- )
105
- }
@@ -1,3 +1,8 @@
1
+ // stylelint-disable selector-max-id
2
+ #wc-availability {
3
+ margin-bottom: govuk-spacing(4);
4
+ }
5
+ // stylelint-enable selector-max-id
1
6
 
2
7
  .wc-availability__inner {
3
8
  max-width: 960px;
@@ -12,6 +17,10 @@
12
17
  right: 0;
13
18
  padding-left: 15px;
14
19
  padding-right: 15px;
20
+ border: 1px solid transparent;
21
+ @media (forced-colors: active) {
22
+ border-color: currentColor;
23
+ }
15
24
 
16
25
  @include mq ($from: 'tablet') {
17
26
  padding-left: 30px;
@@ -27,52 +36,31 @@
27
36
  }
28
37
 
29
38
  .wc-availability__link {
39
+ @extend %govuk-link;
40
+ display: inline-block;
30
41
  @include govuk-font($size: 19);
31
- position:relative;
32
- display:inline-block;
33
42
  margin-right: 5px;
34
- margin-bottom: 0;
35
- fill: govuk-colour('black');
36
43
 
37
- @include mq ($from: tablet) {
38
- margin-right: 10px;
44
+ &:visited:not(:hover):not(:focus) {
45
+ color: govuk-colour('blue');
39
46
  }
40
47
 
41
48
  .govuk-visually-hidden, .wc-availability__unseen {
42
49
  pointer-events: none;
43
50
  }
44
51
 
45
- &:hover {
46
- color: $govuk-link-hover-colour;
47
- }
48
-
49
- &:active {
50
- color: govuk-colour('black');
51
- }
52
-
53
- &:visited {
54
- color: $govuk-link-colour;
55
- }
56
-
57
- &:focus {
58
- box-shadow: none;
59
- background-color: transparent;
60
- text-decoration: underline;
61
- color: $govuk-focus-colour;
62
- }
63
-
64
- &:hover:not(:focus):not(:active) {
65
- color: $govuk-link-hover-colour;
66
-
67
- .wc-availability__unseen {
68
- background-color: govuk-colour('dark-blue');
69
- }
52
+ &:hover:not(:focus):not(:active) .wc-availability__unseen {
53
+ background-color: govuk-colour('dark-blue');
70
54
  }
71
55
  }
72
56
 
73
57
  .wc-availability__unseen {
74
58
  display: inline-block;
75
59
  position: relative;
60
+ border: 1px solid transparent;
61
+ @media (forced-colors: active) {
62
+ border-color: currentColor;
63
+ }
76
64
  border-radius: 10px;
77
65
  background-color: govuk-colour('black');
78
66
  color: govuk-colour('white');
@@ -86,4 +74,4 @@
86
74
  padding-left: 7px;
87
75
  padding-right: 7px;
88
76
  }
89
- }
77
+ }
@@ -0,0 +1,233 @@
1
+ import React, { useEffect, useRef, useState } from 'react'
2
+
3
+ import { PanelHeader } from '../panel/panel-header.jsx'
4
+ import { PanelFooter } from '../panel/panel-footer.jsx'
5
+ import { Message } from '../message/message.jsx'
6
+
7
+ import { useApp } from '../../store/useApp.js'
8
+ import { useTextareaAutosize } from '../../hooks/useTextareaAutosize.js'
9
+ import { formatTranscript } from '../../lib/transform-messages.js'
10
+ import { agentStatusHeadline } from '../../lib/agent-status-headline.js'
11
+
12
+ export function Chat ({ onEndChatScreen, onSettingsScreen }) {
13
+ const { availability, thread, messages, agent, agentStatus, isAgentTyping, isChatOpen, settings, isKeyboard, setLiveRegionText } = useApp()
14
+
15
+ const [userMessage, setUserMessage] = useState('')
16
+ const [focusVisibleWithin, setFocusVisibleWithin] = useState(false)
17
+
18
+ const messageRef = useRef()
19
+
20
+ useTextareaAutosize(messageRef.current, userMessage)
21
+
22
+ useEffect(() => {
23
+ if (settings.scroll && messages.length !== 0) {
24
+ const chatBody = document.querySelector('.wc-body')
25
+ chatBody.scrollTop = chatBody.scrollHeight
26
+ }
27
+ }, [messages, isAgentTyping])
28
+
29
+ useEffect(() => {
30
+ const label = document.querySelector('.wc-form__label')
31
+
32
+ if (userMessage.length === 0) {
33
+ label.classList.remove('govuk-visually-hidden')
34
+ } else {
35
+ label.classList.add('govuk-visually-hidden')
36
+ }
37
+ }, [userMessage])
38
+
39
+ const onChange = e => {
40
+ setUserMessage(e.target?.value)
41
+ }
42
+
43
+ const agentName = agent?.nickname || agent?.firstName
44
+
45
+ const connectionHeadlineText = agentStatusHeadline(availability, agentStatus, agentName)
46
+
47
+ useEffect(() => {
48
+ if (connectionHeadlineText) {
49
+ setLiveRegionText(`Floodline webchat - ${connectionHeadlineText}`)
50
+ }
51
+
52
+ return () => {
53
+ setLiveRegionText()
54
+ }
55
+ }, [connectionHeadlineText])
56
+
57
+ useEffect(() => {
58
+ if (isAgentTyping && isChatOpen) {
59
+ setLiveRegionText(`${agentName} is typing...`)
60
+ }
61
+
62
+ return () => {
63
+ setLiveRegionText()
64
+ }
65
+ }, [isAgentTyping, isChatOpen])
66
+
67
+ useEffect(() => {
68
+ const lastAgentMessage = messages[messages.length - 1]
69
+
70
+ if (agentStatus !== 'closed' && lastAgentMessage?.direction === 'outbound') {
71
+ setLiveRegionText(`${agentName} said: ${lastAgentMessage.text}`)
72
+ }
73
+
74
+ return () => {
75
+ setLiveRegionText()
76
+ }
77
+ }, [messages])
78
+
79
+ const sendMessage = () => {
80
+ if (messageRef.current.value.length === 0 || agentStatus === 'closed') {
81
+ return
82
+ }
83
+
84
+ try {
85
+ const message = messageRef.current.value.trim()
86
+ thread.sendTextMessage(message)
87
+ setLiveRegionText(`You said: ${message}`)
88
+ } catch (err) {
89
+ console.log('[Chat Error] sendMessage', err)
90
+ }
91
+
92
+ setUserMessage('')
93
+ }
94
+
95
+ const handleSubmit = e => {
96
+ e.preventDefault()
97
+ sendMessage()
98
+ }
99
+
100
+ const saveChat = () => {
101
+ const transcript = formatTranscript(messages)
102
+
103
+ const saveChatLink = document.querySelector('#transcript-download')
104
+
105
+ saveChatLink.setAttribute('href', `data:text/plain;charset=utf-8,${transcript}`)
106
+ }
107
+
108
+ const handleKeyPress = e => {
109
+ if (e.key === 'Enter' && !e.shiftKey) {
110
+ switch (e.target.id) {
111
+ case 'text-area':
112
+ e.preventDefault()
113
+ sendMessage()
114
+ break
115
+ case 'end-chat':
116
+ onEndChatScreen(e)
117
+ break
118
+ case 'wc-settings':
119
+ onSettingsScreen(e)
120
+ break
121
+ case 'transcript-download':
122
+ saveChat()
123
+ break
124
+ default:
125
+ break
126
+ }
127
+ }
128
+ if (e.key === ' ') {
129
+ if (e.target.id === 'end-chat') {
130
+ onEndChatScreen(e)
131
+ }
132
+ if (e.target.id === 'wc-settings') {
133
+ onSettingsScreen(e)
134
+ }
135
+ }
136
+ }
137
+
138
+ return (
139
+ <>
140
+ <PanelHeader />
141
+
142
+ <div className='wc-status'>
143
+ <p className='wc-status__availability'>{connectionHeadlineText}</p>
144
+ <a
145
+ id='end-chat'
146
+ className='wc-status__link'
147
+ href='#'
148
+ data-module='govuk-button'
149
+ role='button'
150
+ onClick={onEndChatScreen}
151
+ onKeyDown={handleKeyPress}
152
+ >
153
+ End chat
154
+ </a>
155
+ </div>
156
+
157
+ <div className='wc-body' tabIndex='0'>
158
+ <ul className='wc-chat'>
159
+ {messages.length
160
+ ? messages.map((msg, index) => <Message key={msg.id} message={msg} previousMessage={messages[index - 1]} />)
161
+ : null}
162
+ {isAgentTyping
163
+ ? (
164
+ <li className='wc-chat__message outbound'>
165
+ <div className='wc-chat__from'>{agentName} is typing</div>
166
+ <div className='wc-chat__text outbound'>
167
+ <svg width='28' height='16' x='0px' y='0px' viewBox='0 0 28 16'>
168
+ <circle stroke='none' cx='3' cy='8' r='3' fill='currentColor' />
169
+ <circle stroke='none' cx='14' cy='8' r='3' fill='currentColor' />
170
+ <circle stroke='none' cx='25' cy='8' r='3' fill='currentColor' />
171
+ </svg>
172
+ </div>
173
+ </li>
174
+ )
175
+ : null}
176
+ </ul>
177
+ </div>
178
+
179
+ <PanelFooter>
180
+ <form className={`wc-form${focusVisibleWithin ? ' wc-focus-within' : ''}`} noValidate onSubmit={handleSubmit}>
181
+ <label className='govuk-label wc-form__label' htmlFor='wc-form-textarea'>
182
+ Your message<span className='govuk-visually-hidden'> (enter key submits)</span>
183
+ </label>
184
+
185
+ <textarea
186
+ ref={messageRef}
187
+ rows='1'
188
+ aria-required='true'
189
+ className='wc-form__textarea'
190
+ id='text-area'
191
+ name='message'
192
+ onChange={onChange}
193
+ onKeyDown={handleKeyPress}
194
+ onFocus={() => { setFocusVisibleWithin(isKeyboard) }}
195
+ onBlur={() => { setFocusVisibleWithin(false) }}
196
+ value={userMessage}
197
+ />
198
+
199
+ <input
200
+ type='submit'
201
+ className='wc-form__button govuk-button'
202
+ value='Send'
203
+ data-prevent-double-click='true'
204
+ />
205
+ </form>
206
+
207
+ <div className='wc-footer__settings'>
208
+ <a
209
+ href='#'
210
+ id='wc-settings'
211
+ className='wc-footer__settings-link'
212
+ data-module='govuk-button'
213
+ onKeyDown={handleKeyPress}
214
+ onClick={onSettingsScreen}
215
+ >
216
+ Settings
217
+ </a>
218
+ <a
219
+ href='#'
220
+ id='transcript-download'
221
+ className='wc-footer__settings-link'
222
+ data-module='govuk-button'
223
+ download='floodline-webchat-transcript.txt'
224
+ onKeyDown={handleKeyPress}
225
+ onClick={saveChat}
226
+ >
227
+ Save chat
228
+ </a>
229
+ </div>
230
+ </PanelFooter>
231
+ </>
232
+ )
233
+ }