@ciridae/voice-conversations-react 0.0.0-stage → 0.1.0-nightly.0.bootstrap
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 +30 -2
- package/components/BrowserTalkButton.tsx +96 -0
- package/components/CallBanner.tsx +43 -0
- package/components/CallCaptions.tsx +38 -0
- package/components/CallEntry.tsx +89 -0
- package/components/CallTranscript.tsx +58 -0
- package/components/RecentCallEntries.tsx +211 -0
- package/components/describeBrowserTalkError.ts +39 -0
- package/components/formatCallClock.ts +9 -0
- package/components/useEndPresentCall.ts +45 -0
- package/components/voiceCall.css +225 -0
- package/dist/MalformedVoiceResponseError.d.ts +6 -0
- package/dist/MalformedVoiceResponseError.js +9 -0
- package/dist/NumberToCallQrCode.d.ts +12 -0
- package/dist/NumberToCallQrCode.js +29 -0
- package/dist/PhoneNumberDialog.d.ts +25 -0
- package/dist/PhoneNumberDialog.js +333 -0
- package/dist/PhoneNumbersAdminPanel.d.ts +11 -0
- package/dist/PhoneNumbersAdminPanel.js +85 -0
- package/dist/VoiceApiError.d.ts +18 -0
- package/dist/VoiceApiError.js +19 -0
- package/dist/VoiceRequestTimedOutError.d.ts +6 -0
- package/dist/VoiceRequestTimedOutError.js +9 -0
- package/dist/averageSpeechBinsIntoBands.d.ts +6 -0
- package/dist/averageSpeechBinsIntoBands.js +20 -0
- package/dist/browserApisForBrowserTalk.d.ts +17 -0
- package/dist/browserApisForBrowserTalk.js +42 -0
- package/dist/browserTalkError.d.ts +36 -0
- package/dist/browserTalkError.js +1 -0
- package/dist/chooseCallToShowCaptionsOf.d.ts +22 -0
- package/dist/chooseCallToShowCaptionsOf.js +26 -0
- package/dist/createBrowserTalk.d.ts +56 -0
- package/dist/createBrowserTalk.js +414 -0
- package/dist/createBrowserTalkErrorFollower.d.ts +17 -0
- package/dist/createBrowserTalkErrorFollower.js +76 -0
- package/dist/createCallPresenceWatcher.d.ts +25 -0
- package/dist/createCallPresenceWatcher.js +66 -0
- package/dist/createLiveCallCaptionsPoller.d.ts +24 -0
- package/dist/createLiveCallCaptionsPoller.js +58 -0
- package/dist/createVisibleTabPoller.d.ts +13 -0
- package/dist/createVisibleTabPoller.js +56 -0
- package/dist/deriveCallPresence.d.ts +23 -0
- package/dist/deriveCallPresence.js +58 -0
- package/dist/describePhoneNumberError.d.ts +7 -0
- package/dist/describePhoneNumberError.js +29 -0
- package/dist/entries/index.d.ts +26 -0
- package/dist/entries/index.js +22 -0
- package/dist/followBrowserTalkErrorAgainstPresence.d.ts +23 -0
- package/dist/followBrowserTalkErrorAgainstPresence.js +52 -0
- package/dist/formatPhoneNumberAsTyped.d.ts +31 -0
- package/dist/formatPhoneNumberAsTyped.js +85 -0
- package/dist/generated/index.d.ts +1 -0
- package/dist/generated/index.js +2 -0
- package/dist/generated/types.gen.d.ts +795 -0
- package/dist/generated/types.gen.js +2 -0
- package/dist/getBrowserTalkForThisTab.d.ts +3 -0
- package/dist/getBrowserTalkForThisTab.js +13 -0
- package/dist/getCallPresenceWatcherForThisTab.d.ts +3 -0
- package/dist/getCallPresenceWatcherForThisTab.js +9 -0
- package/dist/mapStartBrowserTalkFailureToBrowserTalkError.d.ts +7 -0
- package/dist/mapStartBrowserTalkFailureToBrowserTalkError.js +60 -0
- package/dist/parseVoiceApiResponses.d.ts +11 -0
- package/dist/parseVoiceApiResponses.js +344 -0
- package/dist/readCallSummaryUntilItHasDuration.d.ts +12 -0
- package/dist/readCallSummaryUntilItHasDuration.js +45 -0
- package/dist/readTheBrowsersTimeZone.d.ts +8 -0
- package/dist/readTheBrowsersTimeZone.js +17 -0
- package/dist/readTimestampMilliseconds.d.ts +8 -0
- package/dist/readTimestampMilliseconds.js +10 -0
- package/dist/requestEndOfCall.d.ts +7 -0
- package/dist/requestEndOfCall.js +11 -0
- package/dist/startBrowserTalkErrorFollowerForThisTab.d.ts +6 -0
- package/dist/startBrowserTalkErrorFollowerForThisTab.js +12 -0
- package/dist/useAdminPhoneNumbers.d.ts +47 -0
- package/dist/useAdminPhoneNumbers.js +76 -0
- package/dist/useBrowserTalk.d.ts +10 -0
- package/dist/useBrowserTalk.js +23 -0
- package/dist/useBrowserTalkErrorWhileItApplies.d.ts +10 -0
- package/dist/useBrowserTalkErrorWhileItApplies.js +13 -0
- package/dist/useCallPresence.d.ts +5 -0
- package/dist/useCallPresence.js +34 -0
- package/dist/useCallSummaries.d.ts +9 -0
- package/dist/useCallSummaries.js +22 -0
- package/dist/useCallSummary.d.ts +15 -0
- package/dist/useCallSummary.js +21 -0
- package/dist/useFinePointerWithHover.d.ts +10 -0
- package/dist/useFinePointerWithHover.js +19 -0
- package/dist/useLiveCallCaptions.d.ts +8 -0
- package/dist/useLiveCallCaptions.js +27 -0
- package/dist/useLiveCallCaptionsOfLatestCall.d.ts +13 -0
- package/dist/useLiveCallCaptionsOfLatestCall.js +23 -0
- package/dist/usePhoneNumber.d.ts +45 -0
- package/dist/usePhoneNumber.js +125 -0
- package/dist/voiceApiModels.d.ts +85 -0
- package/dist/voiceApiModels.js +1 -0
- package/dist/voiceConversationsApi.d.ts +44 -0
- package/dist/voiceConversationsApi.js +227 -0
- package/dist/voiceConversationsSettings.d.ts +20 -0
- package/dist/voiceConversationsSettings.js +26 -0
- package/package.json +41 -4
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Runs `read` repeatedly while the tab is visible: one read at a time, the next one
|
|
3
|
+
* `delayAfterReadMs()` after the last finished (null stops every read, focus and visibility reads
|
|
4
|
+
* included). A hidden tab pauses; becoming visible or focused reads at once. A `readNow` during a read runs one more read right after it, so an
|
|
5
|
+
* answer that started before the request (an End) never stands as the latest. Callers keep their
|
|
6
|
+
* last good answer when a read fails.
|
|
7
|
+
*/
|
|
8
|
+
export interface VisibleTabPoller {
|
|
9
|
+
start: () => void;
|
|
10
|
+
stop: () => void;
|
|
11
|
+
readNow: () => void;
|
|
12
|
+
}
|
|
13
|
+
export declare function createVisibleTabPoller(read: () => Promise<void>, delayAfterReadMs: () => number | null): VisibleTabPoller;
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
export function createVisibleTabPoller(read, delayAfterReadMs) {
|
|
2
|
+
let running = false;
|
|
3
|
+
let readInFlight = false;
|
|
4
|
+
let readAgainAfterThisOne = false;
|
|
5
|
+
let nextReadTimer;
|
|
6
|
+
function scheduleNextRead() {
|
|
7
|
+
clearTimeout(nextReadTimer);
|
|
8
|
+
const delay = delayAfterReadMs();
|
|
9
|
+
if (!running || delay === null || document.visibilityState === "hidden")
|
|
10
|
+
return;
|
|
11
|
+
nextReadTimer = setTimeout(readNow, delay);
|
|
12
|
+
}
|
|
13
|
+
function readNow() {
|
|
14
|
+
if (!running || delayAfterReadMs() === null)
|
|
15
|
+
return;
|
|
16
|
+
if (readInFlight) {
|
|
17
|
+
readAgainAfterThisOne = true;
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
clearTimeout(nextReadTimer);
|
|
21
|
+
readInFlight = true;
|
|
22
|
+
void read().finally(() => {
|
|
23
|
+
readInFlight = false;
|
|
24
|
+
if (readAgainAfterThisOne) {
|
|
25
|
+
readAgainAfterThisOne = false;
|
|
26
|
+
readNow();
|
|
27
|
+
}
|
|
28
|
+
else
|
|
29
|
+
scheduleNextRead();
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
function onVisibilityChange() {
|
|
33
|
+
if (document.visibilityState === "hidden")
|
|
34
|
+
clearTimeout(nextReadTimer);
|
|
35
|
+
else
|
|
36
|
+
readNow();
|
|
37
|
+
}
|
|
38
|
+
return {
|
|
39
|
+
start: () => {
|
|
40
|
+
if (running)
|
|
41
|
+
return;
|
|
42
|
+
running = true;
|
|
43
|
+
document.addEventListener("visibilitychange", onVisibilityChange);
|
|
44
|
+
window.addEventListener("focus", readNow);
|
|
45
|
+
if (document.visibilityState !== "hidden")
|
|
46
|
+
readNow();
|
|
47
|
+
},
|
|
48
|
+
stop: () => {
|
|
49
|
+
running = false;
|
|
50
|
+
clearTimeout(nextReadTimer);
|
|
51
|
+
document.removeEventListener("visibilitychange", onVisibilityChange);
|
|
52
|
+
window.removeEventListener("focus", readNow);
|
|
53
|
+
},
|
|
54
|
+
readNow,
|
|
55
|
+
};
|
|
56
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { BrowserTalkState } from "./createBrowserTalk.js";
|
|
2
|
+
import type { ServerCallPresence } from "./createCallPresenceWatcher.js";
|
|
3
|
+
import type { CallId, CallStartedThrough, CurrentCallStatus } from "./voiceApiModels.js";
|
|
4
|
+
/**
|
|
5
|
+
* `browser_talk_in_this_tab`: this tab's browser talk (authoritative for this tab). `browser_talk_in_another_tab`: a browser talk in
|
|
6
|
+
* another tab or device. `on_phone_call`: the member's phone call. `none`: nothing live.
|
|
7
|
+
*/
|
|
8
|
+
export type CallPresenceKind = "none" | "browser_talk_in_this_tab" | "browser_talk_in_another_tab" | "on_phone_call";
|
|
9
|
+
export interface PresentCall {
|
|
10
|
+
callId: CallId | null;
|
|
11
|
+
startedThrough: CallStartedThrough;
|
|
12
|
+
status: CurrentCallStatus;
|
|
13
|
+
startedAt: string | null;
|
|
14
|
+
endsAt: string | null;
|
|
15
|
+
serverOffsetMs: number;
|
|
16
|
+
}
|
|
17
|
+
export interface CallPresence {
|
|
18
|
+
presence: CallPresenceKind;
|
|
19
|
+
call: PresentCall | null;
|
|
20
|
+
elapsedSeconds: number | null;
|
|
21
|
+
remainingSeconds: number | null;
|
|
22
|
+
}
|
|
23
|
+
export declare function deriveCallPresence(server: ServerCallPresence, browserTalkState: BrowserTalkState, browserTalkStartedInThisTab: (callId: CallId) => boolean, browserNowMs: number): CallPresence;
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { readTimestampMilliseconds } from "./readTimestampMilliseconds.js";
|
|
2
|
+
export function deriveCallPresence(server, browserTalkState, browserTalkStartedInThisTab, browserNowMs) {
|
|
3
|
+
const local = readCallFromThisTabsBrowserTalk(browserTalkState);
|
|
4
|
+
if (local)
|
|
5
|
+
return withClock("browser_talk_in_this_tab", local, browserNowMs);
|
|
6
|
+
const serverCall = server.call;
|
|
7
|
+
// A browser talk this tab just ended still shows on the server until its next read.
|
|
8
|
+
if (serverCall === null ||
|
|
9
|
+
(serverCall.started_through === "browser_talk" &&
|
|
10
|
+
browserTalkStartedInThisTab(serverCall.call_id)))
|
|
11
|
+
return { presence: "none", call: null, elapsedSeconds: null, remainingSeconds: null };
|
|
12
|
+
return withClock(serverCall.started_through === "phone_call" ? "on_phone_call" : "browser_talk_in_another_tab", {
|
|
13
|
+
callId: serverCall.call_id,
|
|
14
|
+
startedThrough: serverCall.started_through,
|
|
15
|
+
status: serverCall.status,
|
|
16
|
+
startedAt: serverCall.started_at,
|
|
17
|
+
endsAt: serverCall.ends_at,
|
|
18
|
+
serverOffsetMs: server.serverOffsetMs,
|
|
19
|
+
}, browserNowMs);
|
|
20
|
+
}
|
|
21
|
+
function readCallFromThisTabsBrowserTalk(browserTalkState) {
|
|
22
|
+
switch (browserTalkState.status) {
|
|
23
|
+
case "idle":
|
|
24
|
+
return null;
|
|
25
|
+
case "requesting_microphone":
|
|
26
|
+
case "connecting":
|
|
27
|
+
return {
|
|
28
|
+
callId: browserTalkState.status === "connecting" ? browserTalkState.callId : null,
|
|
29
|
+
startedThrough: "browser_talk",
|
|
30
|
+
status: "connecting",
|
|
31
|
+
startedAt: null,
|
|
32
|
+
endsAt: null,
|
|
33
|
+
serverOffsetMs: 0,
|
|
34
|
+
};
|
|
35
|
+
case "live":
|
|
36
|
+
case "ending":
|
|
37
|
+
return {
|
|
38
|
+
callId: browserTalkState.callId,
|
|
39
|
+
startedThrough: "browser_talk",
|
|
40
|
+
status: browserTalkState.status,
|
|
41
|
+
startedAt: browserTalkState.startedAt,
|
|
42
|
+
endsAt: browserTalkState.endsAt,
|
|
43
|
+
serverOffsetMs: browserTalkState.serverOffsetMs,
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
function withClock(presence, call, browserNowMs) {
|
|
48
|
+
const serverNowMs = browserNowMs + call.serverOffsetMs;
|
|
49
|
+
const secondsFrom = (timestamp, sign) => timestamp === null
|
|
50
|
+
? null
|
|
51
|
+
: Math.max(0, Math.floor((sign * (serverNowMs - readTimestampMilliseconds(timestamp))) / 1000));
|
|
52
|
+
return {
|
|
53
|
+
presence,
|
|
54
|
+
call,
|
|
55
|
+
elapsedSeconds: secondsFrom(call.startedAt, 1),
|
|
56
|
+
remainingSeconds: secondsFrom(call.endsAt, -1),
|
|
57
|
+
};
|
|
58
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A sentence to show when a phone-number request fails. The package's own refusals carry a sentence
|
|
3
|
+
* written for the person (a number not in E.164 form, one another member has, someone not in the
|
|
4
|
+
* project), shown as it is. A `provider` refusal is Ciridae Auth refusing the app's own key, never
|
|
5
|
+
* the person's sign-in. Everything else is the host's or the network's.
|
|
6
|
+
*/
|
|
7
|
+
export declare function describePhoneNumberError(error: unknown): string;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { MalformedVoiceResponseError } from "./MalformedVoiceResponseError.js";
|
|
2
|
+
import { VoiceApiError } from "./VoiceApiError.js";
|
|
3
|
+
const HTTP_UNAUTHORIZED = 401;
|
|
4
|
+
const HTTP_FORBIDDEN = 403;
|
|
5
|
+
const HTTP_NOT_FOUND = 404;
|
|
6
|
+
/**
|
|
7
|
+
* A sentence to show when a phone-number request fails. The package's own refusals carry a sentence
|
|
8
|
+
* written for the person (a number not in E.164 form, one another member has, someone not in the
|
|
9
|
+
* project), shown as it is. A `provider` refusal is Ciridae Auth refusing the app's own key, never
|
|
10
|
+
* the person's sign-in. Everything else is the host's or the network's.
|
|
11
|
+
*/
|
|
12
|
+
export function describePhoneNumberError(error) {
|
|
13
|
+
if (error instanceof VoiceApiError) {
|
|
14
|
+
if (error.packageMessage !== null)
|
|
15
|
+
return error.packageMessage;
|
|
16
|
+
if (error.source === "provider")
|
|
17
|
+
return "Project membership could not be checked. Ask your admin to check the app's Auth Service settings.";
|
|
18
|
+
if (error.status === HTTP_UNAUTHORIZED)
|
|
19
|
+
return "Your sign-in has expired. Sign in again.";
|
|
20
|
+
if (error.status === HTTP_FORBIDDEN)
|
|
21
|
+
return "You are not allowed to do this here.";
|
|
22
|
+
if (error.status === HTTP_NOT_FOUND)
|
|
23
|
+
return "Phone numbers are not turned on for this app.";
|
|
24
|
+
return "The app could not answer right now. Try again shortly.";
|
|
25
|
+
}
|
|
26
|
+
if (error instanceof MalformedVoiceResponseError)
|
|
27
|
+
return "The app answered in a way this page does not understand. Reload and try again.";
|
|
28
|
+
return "The app could not be reached. Check your connection and try again.";
|
|
29
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export { configureVoiceConversations } from "../voiceConversationsSettings.js";
|
|
2
|
+
export type { VoiceConversationsSettings, VoiceConversationsSettingsInput, } from "../voiceConversationsSettings.js";
|
|
3
|
+
export { VoiceConversationsNotConfiguredError } from "../voiceConversationsSettings.js";
|
|
4
|
+
export { useBrowserTalk, type BrowserTalkControls } from "../useBrowserTalk.js";
|
|
5
|
+
export { useBrowserTalkErrorWhileItApplies } from "../useBrowserTalkErrorWhileItApplies.js";
|
|
6
|
+
export type { BrowserTalkState } from "../createBrowserTalk.js";
|
|
7
|
+
export type { BrowserTalkError } from "../browserTalkError.js";
|
|
8
|
+
export { useCallPresence } from "../useCallPresence.js";
|
|
9
|
+
export type { CallPresence, CallPresenceKind, PresentCall } from "../deriveCallPresence.js";
|
|
10
|
+
export { useLiveCallCaptions } from "../useLiveCallCaptions.js";
|
|
11
|
+
export { useLiveCallCaptionsOfLatestCall } from "../useLiveCallCaptionsOfLatestCall.js";
|
|
12
|
+
export { useCallSummary, type CallSummaryState } from "../useCallSummary.js";
|
|
13
|
+
export { useCallSummaries } from "../useCallSummaries.js";
|
|
14
|
+
export type { LiveCallCaptionsState } from "../createLiveCallCaptionsPoller.js";
|
|
15
|
+
export { VoiceApiError } from "../VoiceApiError.js";
|
|
16
|
+
export { MalformedVoiceResponseError } from "../MalformedVoiceResponseError.js";
|
|
17
|
+
export { VoiceRequestTimedOutError } from "../VoiceRequestTimedOutError.js";
|
|
18
|
+
export type * from "../voiceApiModels.js";
|
|
19
|
+
export { requestEndOfCall } from "../requestEndOfCall.js";
|
|
20
|
+
export { readTimestampMilliseconds } from "../readTimestampMilliseconds.js";
|
|
21
|
+
export type { EndCallOutcome } from "../voiceConversationsApi.js";
|
|
22
|
+
export { usePhoneNumber, type PhoneNumberChange, type PhoneNumberControls, type PhoneNumberLoadStatus, type PhoneNumberSaveOutcome, } from "../usePhoneNumber.js";
|
|
23
|
+
export { PhoneNumberDialog, type PhoneNumberDialogProps } from "../PhoneNumberDialog.js";
|
|
24
|
+
export { useAdminPhoneNumbers, type AdminPhoneNumberListStatus, type AdminPhoneNumbersControls, type AdminPhoneNumbersState, } from "../useAdminPhoneNumbers.js";
|
|
25
|
+
export { PhoneNumbersAdminPanel, type PhoneNumbersAdminPanelProps } from "../PhoneNumbersAdminPanel.js";
|
|
26
|
+
export { describePhoneNumberError } from "../describePhoneNumberError.js";
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export { configureVoiceConversations } from "../voiceConversationsSettings.js";
|
|
2
|
+
export { VoiceConversationsNotConfiguredError } from "../voiceConversationsSettings.js";
|
|
3
|
+
// Browser talk: the backend serves `POST /browser-talks` when the app passes `LiveCallAccess`.
|
|
4
|
+
// Phone calls need none of these.
|
|
5
|
+
export { useBrowserTalk } from "../useBrowserTalk.js";
|
|
6
|
+
export { useBrowserTalkErrorWhileItApplies } from "../useBrowserTalkErrorWhileItApplies.js";
|
|
7
|
+
export { useCallPresence } from "../useCallPresence.js";
|
|
8
|
+
export { useLiveCallCaptions } from "../useLiveCallCaptions.js";
|
|
9
|
+
export { useLiveCallCaptionsOfLatestCall } from "../useLiveCallCaptionsOfLatestCall.js";
|
|
10
|
+
export { useCallSummary } from "../useCallSummary.js";
|
|
11
|
+
export { useCallSummaries } from "../useCallSummaries.js";
|
|
12
|
+
export { VoiceApiError } from "../VoiceApiError.js";
|
|
13
|
+
export { MalformedVoiceResponseError } from "../MalformedVoiceResponseError.js";
|
|
14
|
+
export { VoiceRequestTimedOutError } from "../VoiceRequestTimedOutError.js";
|
|
15
|
+
export { requestEndOfCall } from "../requestEndOfCall.js";
|
|
16
|
+
export { readTimestampMilliseconds } from "../readTimestampMilliseconds.js";
|
|
17
|
+
// Phone numbers: the member's own, and an admin's list, single add or removal, and CSV upload.
|
|
18
|
+
export { usePhoneNumber, } from "../usePhoneNumber.js";
|
|
19
|
+
export { PhoneNumberDialog } from "../PhoneNumberDialog.js";
|
|
20
|
+
export { useAdminPhoneNumbers, } from "../useAdminPhoneNumbers.js";
|
|
21
|
+
export { PhoneNumbersAdminPanel } from "../PhoneNumbersAdminPanel.js";
|
|
22
|
+
export { describePhoneNumberError } from "../describePhoneNumberError.js";
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { CallPresence } from "./deriveCallPresence.js";
|
|
2
|
+
import type { BrowserTalkError } from "./browserTalkError.js";
|
|
3
|
+
import type { CallId } from "./voiceApiModels.js";
|
|
4
|
+
/** What the tab remembers between presence reads about the browser talk error it shows. */
|
|
5
|
+
export interface FollowedBrowserTalkError {
|
|
6
|
+
error: BrowserTalkError | null;
|
|
7
|
+
/** The call the error is about, once presence has shown it since the error appeared; null before. */
|
|
8
|
+
seenCallId: CallId | null;
|
|
9
|
+
}
|
|
10
|
+
export interface BrowserTalkErrorAgainstPresence {
|
|
11
|
+
followed: FollowedBrowserTalkError;
|
|
12
|
+
/** `ended`: the call the error is about was seen and is no longer present, so the error no longer applies. */
|
|
13
|
+
callEndedSinceError: "ended" | "not_ended";
|
|
14
|
+
}
|
|
15
|
+
export declare const NO_FOLLOWED_BROWSER_TALK_ERROR: FollowedBrowserTalkError;
|
|
16
|
+
/**
|
|
17
|
+
* Whether the browser talk's error still applies, given presence now. An error about another call (a phone
|
|
18
|
+
* call that took over or refused the browser talk, a browser talk in another tab) applies until presence has shown
|
|
19
|
+
* that call and then shows it no longer: nothing, or a different call. `already_on_a_browser_talk` names its
|
|
20
|
+
* browser talk, so only that browser talk counts as its call. Any other error has no call to wait for. Errors are
|
|
21
|
+
* new objects, so a new error starts unseen even when it is of the same kind.
|
|
22
|
+
*/
|
|
23
|
+
export declare function followBrowserTalkErrorAgainstPresence(previous: FollowedBrowserTalkError, error: BrowserTalkError | null, presence: Pick<CallPresence, "presence" | "call">): BrowserTalkErrorAgainstPresence;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
export const NO_FOLLOWED_BROWSER_TALK_ERROR = {
|
|
2
|
+
error: null,
|
|
3
|
+
seenCallId: null,
|
|
4
|
+
};
|
|
5
|
+
/**
|
|
6
|
+
* Whether the browser talk's error still applies, given presence now. An error about another call (a phone
|
|
7
|
+
* call that took over or refused the browser talk, a browser talk in another tab) applies until presence has shown
|
|
8
|
+
* that call and then shows it no longer: nothing, or a different call. `already_on_a_browser_talk` names its
|
|
9
|
+
* browser talk, so only that browser talk counts as its call. Any other error has no call to wait for. Errors are
|
|
10
|
+
* new objects, so a new error starts unseen even when it is of the same kind.
|
|
11
|
+
*/
|
|
12
|
+
export function followBrowserTalkErrorAgainstPresence(previous, error, presence) {
|
|
13
|
+
const presenceOfItsCall = error === null ? null : readPresenceOfTheCallItIsAbout(error);
|
|
14
|
+
if (error === null || presenceOfItsCall === null)
|
|
15
|
+
return { followed: { error, seenCallId: null }, callEndedSinceError: "not_ended" };
|
|
16
|
+
const presentCallId = presence.presence === presenceOfItsCall ? (presence.call?.callId ?? null) : null;
|
|
17
|
+
const presentCallIsItsCall = presentCallId !== null &&
|
|
18
|
+
(error.kind !== "already_on_a_browser_talk" ||
|
|
19
|
+
error.callId === null ||
|
|
20
|
+
error.callId === presentCallId);
|
|
21
|
+
const seenCallId = previous.error === error && previous.seenCallId !== null
|
|
22
|
+
? previous.seenCallId
|
|
23
|
+
: presentCallIsItsCall
|
|
24
|
+
? presentCallId
|
|
25
|
+
: null;
|
|
26
|
+
return {
|
|
27
|
+
followed: { error, seenCallId },
|
|
28
|
+
callEndedSinceError: seenCallId !== null && presentCallId !== seenCallId ? "ended" : "not_ended",
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
function readPresenceOfTheCallItIsAbout(error) {
|
|
32
|
+
switch (error.kind) {
|
|
33
|
+
case "phone_took_over":
|
|
34
|
+
case "on_a_phone_call":
|
|
35
|
+
return "on_phone_call";
|
|
36
|
+
case "already_on_a_browser_talk":
|
|
37
|
+
return "browser_talk_in_another_tab";
|
|
38
|
+
case "microphone_blocked":
|
|
39
|
+
case "no_microphone":
|
|
40
|
+
case "microphone_unavailable":
|
|
41
|
+
case "did_not_connect":
|
|
42
|
+
case "connection_dropped":
|
|
43
|
+
case "not_a_current_member":
|
|
44
|
+
case "voice_not_ready":
|
|
45
|
+
case "voice_unavailable":
|
|
46
|
+
case "time_limit_reached":
|
|
47
|
+
case "stopped_by_content_filter":
|
|
48
|
+
case "host_refused":
|
|
49
|
+
case "provider_rejected":
|
|
50
|
+
return null;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/** One change to the phone number field, as the browser reported it. */
|
|
2
|
+
export interface PhoneNumberFieldEdit {
|
|
3
|
+
/** What the field held before this change. */
|
|
4
|
+
previousValue: string;
|
|
5
|
+
/** What the field holds after this change, before formatting. */
|
|
6
|
+
value: string;
|
|
7
|
+
/** The caret's position in `value`. */
|
|
8
|
+
caret: number;
|
|
9
|
+
/**
|
|
10
|
+
* Backspace and Delete are told apart so that one removing only a formatting character removes
|
|
11
|
+
* the digit beside it instead, rather than leaving the caret stuck beside that character.
|
|
12
|
+
*/
|
|
13
|
+
kind: "delete_backward" | "delete_forward" | "other_edit";
|
|
14
|
+
}
|
|
15
|
+
/** The text the field should hold and where the caret goes in it. */
|
|
16
|
+
export interface FormattedPhoneNumberField {
|
|
17
|
+
value: string;
|
|
18
|
+
caret: number;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Formats a US phone number while the member types it: `(415`, `(415) 555`, `(415) 555-0123`,
|
|
22
|
+
* capped at 10 digits. A leading 1 (the US trunk prefix, since no US area code starts with 1) is
|
|
23
|
+
* kept and shown in front, as `1 (415) 555-0123`, with an 11-digit cap. Anything else typed or
|
|
24
|
+
* pasted (dots, spaces, letters) is dropped, so "415.555.0123" becomes "(415) 555-0123". A number
|
|
25
|
+
* starting with `+` is left exactly as typed: the backend reads international numbers itself.
|
|
26
|
+
*
|
|
27
|
+
* The caret stays after the same digit it followed before formatting, so typing, pasting and
|
|
28
|
+
* editing in the middle keep their place. Backspace or Delete that removed only a formatting
|
|
29
|
+
* character removes the digit beside it instead.
|
|
30
|
+
*/
|
|
31
|
+
export declare function formatPhoneNumberAsTyped(edit: PhoneNumberFieldEdit): FormattedPhoneNumberField;
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
const US_NUMBER_DIGITS = 10;
|
|
2
|
+
const US_TRUNK_PREFIX = "1";
|
|
3
|
+
/**
|
|
4
|
+
* Formats a US phone number while the member types it: `(415`, `(415) 555`, `(415) 555-0123`,
|
|
5
|
+
* capped at 10 digits. A leading 1 (the US trunk prefix, since no US area code starts with 1) is
|
|
6
|
+
* kept and shown in front, as `1 (415) 555-0123`, with an 11-digit cap. Anything else typed or
|
|
7
|
+
* pasted (dots, spaces, letters) is dropped, so "415.555.0123" becomes "(415) 555-0123". A number
|
|
8
|
+
* starting with `+` is left exactly as typed: the backend reads international numbers itself.
|
|
9
|
+
*
|
|
10
|
+
* The caret stays after the same digit it followed before formatting, so typing, pasting and
|
|
11
|
+
* editing in the middle keep their place. Backspace or Delete that removed only a formatting
|
|
12
|
+
* character removes the digit beside it instead.
|
|
13
|
+
*/
|
|
14
|
+
export function formatPhoneNumberAsTyped(edit) {
|
|
15
|
+
const { value, caret } = edit;
|
|
16
|
+
if (value.trimStart().startsWith("+"))
|
|
17
|
+
return { value, caret };
|
|
18
|
+
const { digits, digitsBeforeCaret } = removeDigitBesideRemovedFormatting(edit);
|
|
19
|
+
const digitCap = digits.startsWith(US_TRUNK_PREFIX) ? US_NUMBER_DIGITS + 1 : US_NUMBER_DIGITS;
|
|
20
|
+
const keptDigits = digits.slice(0, digitCap);
|
|
21
|
+
const formatted = formatUsDigits(keptDigits);
|
|
22
|
+
return {
|
|
23
|
+
value: formatted,
|
|
24
|
+
caret: findPositionAfterDigit(formatted, Math.min(digitsBeforeCaret, keptDigits.length)),
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
function removeDigitBesideRemovedFormatting(edit) {
|
|
28
|
+
const digits = keepDigits(edit.value);
|
|
29
|
+
const digitsBeforeCaret = keepDigits(edit.value.slice(0, edit.caret)).length;
|
|
30
|
+
const removedOnlyFormatting = edit.kind !== "other_edit" &&
|
|
31
|
+
// A + is part of an international number, not formatting this function added.
|
|
32
|
+
!edit.previousValue.trimStart().startsWith("+") &&
|
|
33
|
+
edit.value.length === edit.previousValue.length - 1 &&
|
|
34
|
+
digits === keepDigits(edit.previousValue);
|
|
35
|
+
if (!removedOnlyFormatting)
|
|
36
|
+
return { digits, digitsBeforeCaret };
|
|
37
|
+
if (edit.kind === "delete_backward") {
|
|
38
|
+
if (digitsBeforeCaret === 0)
|
|
39
|
+
return { digits, digitsBeforeCaret };
|
|
40
|
+
return {
|
|
41
|
+
digits: digits.slice(0, digitsBeforeCaret - 1) + digits.slice(digitsBeforeCaret),
|
|
42
|
+
digitsBeforeCaret: digitsBeforeCaret - 1,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
return {
|
|
46
|
+
digits: digits.slice(0, digitsBeforeCaret) + digits.slice(digitsBeforeCaret + 1),
|
|
47
|
+
digitsBeforeCaret,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
/** `(415`, `(415) 555`, `(415) 555-0123`; with the trunk prefix, `1 (415) 555-0123`. */
|
|
51
|
+
function formatUsDigits(digits) {
|
|
52
|
+
if (!digits.startsWith(US_TRUNK_PREFIX))
|
|
53
|
+
return formatTenDigitNumber(digits);
|
|
54
|
+
const rest = digits.slice(US_TRUNK_PREFIX.length);
|
|
55
|
+
return rest === "" ? US_TRUNK_PREFIX : `${US_TRUNK_PREFIX} ${formatTenDigitNumber(rest)}`;
|
|
56
|
+
}
|
|
57
|
+
/** Area code, exchange and line, each shown once the member reaches it. */
|
|
58
|
+
function formatTenDigitNumber(digits) {
|
|
59
|
+
const areaCode = digits.slice(0, 3);
|
|
60
|
+
const exchange = digits.slice(3, 6);
|
|
61
|
+
const line = digits.slice(6);
|
|
62
|
+
if (areaCode === "")
|
|
63
|
+
return "";
|
|
64
|
+
if (exchange === "")
|
|
65
|
+
return `(${areaCode}`;
|
|
66
|
+
if (line === "")
|
|
67
|
+
return `(${areaCode}) ${exchange}`;
|
|
68
|
+
return `(${areaCode}) ${exchange}-${line}`;
|
|
69
|
+
}
|
|
70
|
+
/** The position just after the `digitCount`-th digit, or the start for none. */
|
|
71
|
+
function findPositionAfterDigit(text, digitCount) {
|
|
72
|
+
if (digitCount === 0)
|
|
73
|
+
return 0;
|
|
74
|
+
let seen = 0;
|
|
75
|
+
for (let position = 0; position < text.length; position++) {
|
|
76
|
+
if (/\d/.test(text.charAt(position)))
|
|
77
|
+
seen++;
|
|
78
|
+
if (seen === digitCount)
|
|
79
|
+
return position + 1;
|
|
80
|
+
}
|
|
81
|
+
return text.length;
|
|
82
|
+
}
|
|
83
|
+
function keepDigits(text) {
|
|
84
|
+
return text.replace(/\D/g, "");
|
|
85
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export type { AddPhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersPostData, AddPhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersPostError, AddPhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersPostErrors, AddPhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersPostResponse, AddPhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersPostResponses, AdminAddedPhoneNumber, AdminListedPhoneNumber, AdminPhoneNumbersPage, AdminPhoneNumberToAdd, BrowserTalkStarted, CallCaption, CallCaptionsSoFar, CallSummary, ClientOptions, CurrentCall, CurrentCallDetails, DeleteOwnPhoneNumberVoiceConversationsMePhoneNumberDeleteData, DeleteOwnPhoneNumberVoiceConversationsMePhoneNumberDeleteResponse, DeleteOwnPhoneNumberVoiceConversationsMePhoneNumberDeleteResponses, GetCallCaptionsVoiceConversationsCallsCallIdCaptionsGetData, GetCallCaptionsVoiceConversationsCallsCallIdCaptionsGetError, GetCallCaptionsVoiceConversationsCallsCallIdCaptionsGetErrors, GetCallCaptionsVoiceConversationsCallsCallIdCaptionsGetResponse, GetCallCaptionsVoiceConversationsCallsCallIdCaptionsGetResponses, GetCurrentCallVoiceConversationsCallsCurrentGetData, GetCurrentCallVoiceConversationsCallsCurrentGetResponse, GetCurrentCallVoiceConversationsCallsCurrentGetResponses, GetOwnPhoneNumberVoiceConversationsMePhoneNumberGetData, GetOwnPhoneNumberVoiceConversationsMePhoneNumberGetResponse, GetOwnPhoneNumberVoiceConversationsMePhoneNumberGetResponses, GetTheSignedInMembersCallSummaryVoiceConversationsCallsCallIdGetData, GetTheSignedInMembersCallSummaryVoiceConversationsCallsCallIdGetError, GetTheSignedInMembersCallSummaryVoiceConversationsCallsCallIdGetErrors, GetTheSignedInMembersCallSummaryVoiceConversationsCallsCallIdGetResponse, GetTheSignedInMembersCallSummaryVoiceConversationsCallsCallIdGetResponses, HttpValidationError, IanaTimeZone, ListPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersGetData, ListPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersGetError, ListPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersGetErrors, ListPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersGetResponse, ListPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersGetResponses, MemberPhoneNumber, PhoneNumberToSave, PhoneNumberUploadReport, PostCallEndVoiceConversationsCallsCallIdEndPostData, PostCallEndVoiceConversationsCallsCallIdEndPostError, PostCallEndVoiceConversationsCallsCallIdEndPostErrors, PostCallEndVoiceConversationsCallsCallIdEndPostResponse, PostCallEndVoiceConversationsCallsCallIdEndPostResponses, PutOwnPhoneNumberVoiceConversationsMePhoneNumberPutData, PutOwnPhoneNumberVoiceConversationsMePhoneNumberPutError, PutOwnPhoneNumberVoiceConversationsMePhoneNumberPutErrors, PutOwnPhoneNumberVoiceConversationsMePhoneNumberPutResponse, PutOwnPhoneNumberVoiceConversationsMePhoneNumberPutResponses, RemovePhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersMemberUserIdDeleteData, RemovePhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersMemberUserIdDeleteError, RemovePhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersMemberUserIdDeleteErrors, RemovePhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersMemberUserIdDeleteResponse, RemovePhoneNumberAsAdminVoiceConversationsAdminPhoneNumbersMemberUserIdDeleteResponses, StartBrowserTalkRequest, StartBrowserTalkVoiceConversationsBrowserTalksPostData, StartBrowserTalkVoiceConversationsBrowserTalksPostError, StartBrowserTalkVoiceConversationsBrowserTalksPostErrors, StartBrowserTalkVoiceConversationsBrowserTalksPostResponse, StartBrowserTalkVoiceConversationsBrowserTalksPostResponses, TimeZoneNotReported, UploadedPhoneNumberAdded, UploadedPhoneNumberRefused, UploadPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersCsvPostData, UploadPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersCsvPostError, UploadPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersCsvPostErrors, UploadPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersCsvPostResponse, UploadPhoneNumbersAsAdminVoiceConversationsAdminPhoneNumbersCsvPostResponses, ValidationError, VoiceErrorBody, VoiceErrorDetail, VoiceErrorDetailNamingCall, } from "./types.gen.js";
|