botframework-webchat-api 4.13.0 → 4.15.0

package/src/hooks/{useDirection.js → useDirection.ts}

@@ -14,7 +14,7 @@ function determineDirection(dir, language) {
   return 'ltr';
 }
 
-export default function useDirection() {
+export default function useDirection(): ['auto' | 'ltr' | 'rtl'] {
   const [dir] = useDirFromProps();
   const [language] = useLanguage();
   const determinedDirection = useMemo(() => determineDirection(dir, language), [dir, language]);

package/src/hooks/{useDisabled.js → useDisabled.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useDisabled() {
+export default function useDisabled(): [boolean] {
   return [useWebChatAPIContext().disabled];
 }

package/src/hooks/{useDismissNotification.js → useDismissNotification.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useDismissNotification() {
+export default function useDismissNotification(): (id: string) => void {
   return useWebChatAPIContext().dismissNotification;
 }

package/src/hooks/{useEmitTypingIndicator.js → useEmitTypingIndicator.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useEmitTypingIndicator() {
+export default function useEmitTypingIndicator(): () => void {
   return useWebChatAPIContext().emitTypingIndicator;
 }

package/src/hooks/useGetActivityByKey.ts

@@ -0,0 +1,3 @@
+import useGetActivityByKey from '../providers/ActivityKeyer/useGetActivityByKey';
+
+export default useGetActivityByKey;

package/src/hooks/useGetHasAcknowledgedByActivityKey.ts

@@ -0,0 +1,3 @@
+import useGetHasAcknowledgedByActivityKey from '../providers/ActivityAcknowledgement/useGetHasAcknowledgedByActivityKey';
+
+export default useGetHasAcknowledgedByActivityKey;

package/src/hooks/useGetKeyByActivity.ts

@@ -0,0 +1,3 @@
+import useGetKeyByActivity from '../providers/ActivityKeyer/useGetKeyByActivity';
+
+export default useGetKeyByActivity;

package/src/hooks/useGetKeyByActivityId.ts

@@ -0,0 +1,3 @@
+import useGetKeyByActivityId from '../providers/ActivityKeyer/useGetKeyByActivityId';
+
+export default useGetKeyByActivityId;

package/src/hooks/useGetSendTimeoutForActivity.ts

@@ -0,0 +1,20 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
+import { useMemo } from 'react';
+
+import useStyleOptions from './useStyleOptions';
+
+export default function useGetSendTimeoutForActivity(): ({ activity }: { activity: DirectLineActivity }) => number {
+  const [{ sendTimeout, sendTimeoutForAttachments }] = useStyleOptions();
+
+  return useMemo(
+    () =>
+      ({ activity }) => {
+        if (typeof sendTimeout === 'function') {
+          return sendTimeout(activity);
+        }
+
+        return activity.attachments && activity.attachments.length ? sendTimeoutForAttachments : sendTimeout;
+      },
+    [sendTimeout, sendTimeoutForAttachments]
+  );
+}

package/src/hooks/{useGrammars.js → useGrammars.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useGrammars() {
+export default function useGrammars(): [any] {
   return [useWebChatAPIContext().grammars];
 }

package/src/hooks/useGroupActivities.ts

@@ -0,0 +1,10 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
+
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function useGroupActivities(): ({ activities }: { activities: DirectLineActivity[] }) => {
+  sender: DirectLineActivity[][];
+  status: DirectLineActivity[][];
+} {
+  return useWebChatAPIContext().groupActivities;
+}

package/src/hooks/{useGroupTimestamp.js → useGroupTimestamp.ts}

@@ -1,6 +1,6 @@
 import useStyleOptions from './useStyleOptions';
 
-export default function useGroupTimestamp() {
+export default function useGroupTimestamp(): [boolean | number] {
   const [{ groupTimestamp }] = useStyleOptions();
 
   return [groupTimestamp];

package/src/hooks/{useLanguage.js → useLanguage.ts}

@@ -1,7 +1,7 @@
 import useLocalizedStrings from './internal/useLocalizedStrings';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useLanguage(options) {
+export default function useLanguage(options?: 'speech'): [string] {
   const { language } = useWebChatAPIContext();
   const localizedStrings = useLocalizedStrings();
 

package/src/hooks/useLastAcknowledgedActivityKey.ts

@@ -0,0 +1,3 @@
+import useLastAcknowledgedActivityKey from '../providers/ActivityAcknowledgement/useLastAcknowledgedActivityKey';
+
+export default useLastAcknowledgedActivityKey;

package/src/hooks/useLastReadActivityKey.ts

@@ -0,0 +1,3 @@
+import useLastReadActivityKey from '../providers/ActivityAcknowledgement/useLastReadActivityKey';
+
+export default useLastReadActivityKey;

package/src/hooks/{useLastTypingAt.js → useLastTypingAt.ts}

@@ -2,7 +2,8 @@ import { useSelector } from './internal/WebChatReduxContext';
 
 let showDeprecationNotes = true;
 
-export default function useLastTypingAt() {
+/** @deprecated Please use "useActiveTyping" instead. */
+export default function useLastTypingAt(): [{ [userId: string]: number }] {
   if (showDeprecationNotes) {
     console.warn(
       'botframework-webchat: "useLastTypingAt" is deprecated. Please use "useActiveTyping" instead. This hook will be removed on or after 2022-02-16.'

package/src/hooks/{useLocalize.js → useLocalize.ts}

@@ -2,7 +2,9 @@ import useLanguage from './useLanguage';
 
 import { localize } from '../localization/Localize';
 
-export default function useLocalize(text, ...args) {
+// TODO: Remove on or after 2022-02-12.
+/** @deprecated Please use "useLocalizer" instead. */
+export default function useLocalize(text: string, ...args: string[]): boolean | string {
   const [language] = useLanguage();
 
   // TODO: [P3] Use useMemo to cache the result.

package/src/hooks/{useLocalizeDate.js → useLocalizeDate.ts}

@@ -4,7 +4,8 @@ import getLocaleString from '../localization/getLocaleString';
 
 let deprecationNotesShown;
 
-export default function useLocalizeDate(date) {
+/** @deprecated Please use useDateFormatter() instead. */
+export default function useLocalizeDate(date: Date | number | string): string {
   if (!deprecationNotesShown) {
     console.warn(
       'botframework-webchat: useLocalizeDate() is deprecated. Please use the useDateFormatter() hooks instead. This hook will be removed on or after 2022-02-12.'

package/src/hooks/{useLocalizer.js → useLocalizer.ts}

@@ -1,3 +1,4 @@
+import { isForbiddenPropertyName } from 'botframework-webchat-core';
 import { useCallback } from 'react';
 
 import getAllLocalizedStrings from '../localization/getAllLocalizedStrings';
@@ -7,22 +8,37 @@ import isObject from '../utils/isObject';
 
 const DEFAULT_STRINGS = getAllLocalizedStrings()['en-US'];
 
-export default function useLocalizer({ plural } = {}) {
+type Plural = {
+  zero?: string;
+  one?: string;
+  two?: string;
+  few?: string;
+  many?: string;
+  other: string;
+};
+
+export default function useLocalizer({ plural }: { plural?: boolean } = {}) {
   const [globalize] = useLocalizedGlobalize();
   const localizedStrings = useLocalizedStrings();
 
   return useCallback(
-    (id, ...args) => {
+    (id: string | Plural, ...args: [(number | string)?, ...string[]]) => {
+      let stringId = id as string;
+
       if (plural) {
-        if (!isObject(id)) {
+        const pluralId = id as Plural;
+
+        if (!isObject(pluralId)) {
           throw new Error('useLocalizer: Plural string must pass "id" as a map instead of string.');
-        } else if (typeof id.other !== 'string') {
+        } else if (typeof pluralId.other !== 'string') {
           throw new Error('useLocalizer: Plural string must have "id.other" of string.');
         } else if (typeof args[0] !== 'number') {
           throw new Error('useLocalizer: Plural string must have first argument as a number.');
         }
 
         for (const pluralForm of ['zero', 'one', 'two', 'few', 'many']) {
+          // Mitigation through allowlisting.
+          // eslint-disable-next-line security/detect-object-injection
           const type = typeof id[pluralForm];
 
           if (type !== 'string' && type !== 'undefined') {
@@ -42,14 +58,16 @@ export default function useLocalizer({ plural } = {}) {
           );
         }
 
-        id = id[globalize.plural(args[0])] || id.other;
+        stringId = pluralId[globalize.plural(args[0])] || pluralId.other;
       } else if (typeof id !== 'string') {
         throw new Error('useLocalizer: "id" must be a string.');
       }
 
       return Object.entries(args).reduce(
         (str, [index, arg]) => str.replace(`$${+index + 1}`, arg),
-        localizedStrings[id] || DEFAULT_STRINGS[id] || ''
+        // Mitigation through denylisting.
+        // eslint-disable-next-line security/detect-object-injection
+        isForbiddenPropertyName(stringId) ? '' : localizedStrings[stringId] || DEFAULT_STRINGS[stringId] || ''
       );
     },
     [globalize, localizedStrings, plural]

package/src/hooks/{useMarkActivityAsSpoken.js → useMarkActivityAsSpoken.ts}

@@ -1,8 +1,9 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
 import { useCallback } from 'react';
 
 import useMarkActivity from './internal/useMarkActivity';
 
-export default function useMarkActivityAsSpoken() {
+export default function useMarkActivityAsSpoken(): (activity: DirectLineActivity) => void {
   const markActivity = useMarkActivity();
 
   return useCallback(activity => markActivity(activity, 'speak', false), [markActivity]);

package/src/hooks/useMarkActivityKeyAsRead.ts

@@ -0,0 +1,3 @@
+import useMarkActivityKeyAsRead from '../providers/ActivityAcknowledgement/useMarkActivityKeyAsRead';
+
+export default useMarkActivityKeyAsRead;

package/src/hooks/useMarkAllAsAcknowledged.ts

@@ -0,0 +1,3 @@
+import useMarkAllAsAcknowledged from '../providers/ActivityAcknowledgement/useMarkAllAsAcknowledged';
+
+export default useMarkAllAsAcknowledged;

package/src/hooks/{useNotifications.js → useNotifications.ts}

@@ -1,5 +1,6 @@
 import { useSelector } from './internal/WebChatReduxContext';
+import Notification from '../types/Notification';
 
-export default function useNotifications() {
+export default function useNotifications(): [Notification[]] {
   return [useSelector(({ notifications }) => notifications)];
 }

package/src/hooks/usePerformCardAction.ts

@@ -0,0 +1,6 @@
+import { PerformCardAction } from '../types/CardActionMiddleware';
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function usePerformCardAction(): PerformCardAction {
+  return useWebChatAPIContext().onCardAction;
+}

package/src/hooks/usePostActivity.ts

@@ -0,0 +1,8 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
+import Observable from 'core-js/features/observable';
+
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function usePostActivity(): (activity: DirectLineActivity) => Observable<string> {
+  return useWebChatAPIContext().postActivity;
+}

package/src/hooks/{useReferenceGrammarID.js → useReferenceGrammarID.ts}

@@ -1,5 +1,5 @@
 import { useSelector } from './internal/WebChatReduxContext';
 
-export default function useReferenceGrammarID() {
+export default function useReferenceGrammarID(): [string] {
   return [useSelector(({ referenceGrammarID }) => referenceGrammarID)];
 }

package/src/hooks/{useRelativeTimeFormatter.js → useRelativeTimeFormatter.ts}

@@ -6,7 +6,7 @@ import useDateFormatter from './useDateFormatter';
 import useLocalizedGlobalize from './internal/useLocalizedGlobalize';
 import useLocalizer from './useLocalizer';
 
-export default function useRelativeTimeFormatter() {
+export default function useRelativeTimeFormatter(): (dateOrString: Date | string) => string {
   const formatDate = useDateFormatter();
   const localize = useLocalizer();
   const [globalize] = useLocalizedGlobalize();

package/src/hooks/useRenderActivity.js

@@ -17,6 +17,7 @@ import useCreateActivityRendererInternal from './internal/useCreateActivityRende
 
 let showDeprecationNotes = true;
 
+/** @deprecated Please use `useCreateActivityRenderer()` instead. */
 export default function useRenderActivity(renderAttachment) {
   if (showDeprecationNotes) {
     console.warn(
@@ -33,19 +34,20 @@ export default function useRenderActivity(renderAttachment) {
   const createActivityRenderer = useCreateActivityRendererInternal(renderAttachment);
 
   return useMemo(
-    () => (renderActivityArg, renderOptions = {}) => {
-      const { activity } = renderActivityArg || {};
+    () =>
+      (renderActivityArg, renderOptions = {}) => {
+        const { activity } = renderActivityArg || {};
 
-      if (!activity) {
-        throw new Error(
-          'botframework-webchat: First argument passed to the callback of useRenderActivity() must contain an "activity" property.'
-        );
-      }
+        if (!activity) {
+          throw new Error(
+            'botframework-webchat: First argument passed to the callback of useRenderActivity() must contain an "activity" property.'
+          );
+        }
 
-      const renderActivity = createActivityRenderer(renderActivityArg);
+        const renderActivity = createActivityRenderer(renderActivityArg);
 
-      return !!renderActivity && renderActivity(renderOptions);
-    },
+        return !!renderActivity && renderActivity(renderOptions);
+      },
     [createActivityRenderer]
   );
 }

package/src/hooks/useRenderActivityStatus.js

@@ -16,6 +16,7 @@ import useCreateActivityStatusRenderer from './useCreateActivityStatusRenderer';
 
 let showDeprecationNotes = true;
 
+/** @deprecated Please use `useCreateActivityStatusRenderer()` instead. */
 export default function useRenderActivityStatus({ activity, nextVisibleActivity }) {
   if (showDeprecationNotes) {
     console.warn(

package/src/hooks/useRenderAvatar.js

@@ -2,6 +2,7 @@ import useCreateAvatarRenderer from './useCreateAvatarRenderer';
 
 let showDeprecationNotes = true;
 
+/** @deprecated Please use "useRenderAvatar()" instead. */
 export default function useRenderAvatar({ activity }) {
   if (showDeprecationNotes) {
     console.warn(

package/src/hooks/{useRenderToast.js → useRenderToast.ts}

@@ -1,5 +1,6 @@
+import { RenderToast } from '../types/ToastMiddleware';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useRenderToast() {
+export default function useRenderToast(): RenderToast {
   return useWebChatAPIContext().toastRenderer;
 }

package/src/hooks/useRenderTypingIndicator.ts

@@ -0,0 +1,6 @@
+import { RenderTypingIndicator } from '../types/TypingIndicatorMiddleware';
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function useRenderTypingIndicator(): RenderTypingIndicator {
+  return useWebChatAPIContext().typingIndicatorRenderer;
+}

package/src/hooks/{useSendBoxValue.js → useSendBoxValue.ts}

@@ -1,6 +1,6 @@
 import { useSelector } from './internal/WebChatReduxContext';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSendBoxValue() {
+export default function useSendBoxValue(): [string, (value: string) => void] {
   return [useSelector(({ sendBoxValue }) => sendBoxValue), useWebChatAPIContext().setSendBox];
 }

package/src/hooks/{useSendEvent.js → useSendEvent.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSendEvent() {
+export default function useSendEvent(): (name: string, value: any) => void {
   return useWebChatAPIContext().sendEvent;
 }

package/src/hooks/{useSendFiles.js → useSendFiles.ts}

@@ -5,7 +5,7 @@ import { useCallback } from 'react';
 import useTrackEvent from './useTrackEvent';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSendFiles() {
+export default function useSendFiles(): (files: File[]) => void {
   const { sendFiles } = useWebChatAPIContext();
   const trackEvent = useTrackEvent();
 

package/src/hooks/useSendMessage.ts

@@ -0,0 +1,9 @@
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function useSendMessage(): (
+  text: string,
+  method?: string,
+  { channelData }?: { channelData?: any }
+) => void {
+  return useWebChatAPIContext().sendMessage;
+}

package/src/hooks/{useSendMessageBack.js → useSendMessageBack.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSendMessageBack() {
+export default function useSendMessageBack(): (value: any, text?: string, displayText?: string) => void {
   return useWebChatAPIContext().sendMessageBack;
 }

package/src/hooks/{useSendPostBack.js → useSendPostBack.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSendPostBack() {
+export default function useSendPostBack(): (value?: any) => void {
   return useWebChatAPIContext().sendPostBack;
 }

package/src/hooks/{useSendTimeoutForActivity.js → useSendTimeoutForActivity.ts}

@@ -1,8 +1,11 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
+
 import useGetSendTimeoutForActivity from './useGetSendTimeoutForActivity';
 
 let showDeprecationNotes = true;
 
-export default function useSendTimeoutForActivity(activity) {
+/** @deprecated Please use "useGetSendTimeoutForActivity()" instead. */
+export default function useSendTimeoutForActivity(activity: DirectLineActivity) {
   if (showDeprecationNotes) {
     console.warn(
       'botframework-webchat: "useSendTimeoutForActivity" is deprecated and will be removed on or after 2022-07-28. Please use "useGetSendTimeoutForActivity()" instead.'

package/src/hooks/{useSendTypingIndicator.js → useSendTypingIndicator.ts}

@@ -1,5 +1,5 @@
 import { useSelector } from './internal/WebChatReduxContext';
 
-export default function useSendTypingIndicator() {
+export default function useSendTypingIndicator(): [boolean] {
   return [useSelector(({ sendTypingIndicator }) => sendTypingIndicator)];
 }

package/src/hooks/useSetNotification.ts

@@ -0,0 +1,6 @@
+import Notification from '../types/Notification';
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function useSetNotification(): (notification: Notification) => void {
+  return useWebChatAPIContext().setNotification;
+}

package/src/hooks/{useShouldSpeakIncomingActivity.js → useShouldSpeakIncomingActivity.ts}

@@ -3,7 +3,7 @@ import { useCallback } from 'react';
 import { useSelector } from './internal/WebChatReduxContext';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useShouldSpeakIncomingActivity() {
+export default function useShouldSpeakIncomingActivity(): [boolean, (value: boolean) => void] {
   const { startSpeakingActivity, stopSpeakingActivity } = useWebChatAPIContext();
 
   return [

package/src/hooks/{useStartDictate.js → useStartDictate.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useStartDictate() {
+export default function useStartDictate(): () => void {
   return useWebChatAPIContext().startDictate;
 }

package/src/hooks/{useStopDictate.js → useStopDictate.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useStopDictate() {
+export default function useStopDictate(): () => void {
   return useWebChatAPIContext().stopDictate;
 }

package/src/hooks/useStyleOptions.ts

@@ -0,0 +1,6 @@
+import { StrictStyleOptions } from '../StyleOptions';
+import useWebChatAPIContext from './internal/useWebChatAPIContext';
+
+export default function useStyleOptions(): [StrictStyleOptions] {
+  return [useWebChatAPIContext().styleOptions];
+}

package/src/hooks/{useSubmitSendBox.js → useSubmitSendBox.ts}

@@ -3,18 +3,15 @@ import { useCallback } from 'react';
 import useTrackEvent from './useTrackEvent';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSubmitSendBox() {
+export default function useSubmitSendBox(): (method?: string, { channelData }?: { channelData: any }) => void {
   const { submitSendBox } = useWebChatAPIContext();
   const trackEvent = useTrackEvent();
 
   return useCallback(
-    (...args) => {
-      // We cannot use spread operator as it broken in Angular.
-      const method = args[0] || 'keyboard';
-
+    (method: string, { channelData }: { channelData?: any } = {}) => {
       trackEvent('submitSendBox', method);
 
-      return submitSendBox(...args);
+      return submitSendBox(method, channelData && { channelData });
     },
     [submitSendBox, trackEvent]
   );

package/src/hooks/{useSuggestedActions.js → useSuggestedActions.ts}

@@ -1,9 +1,13 @@
+import { DirectLineSuggestedAction } from 'botframework-webchat-core';
 import { useCallback } from 'react';
 
 import { useSelector } from './internal/WebChatReduxContext';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useSuggestedActions() {
+export default function useSuggestedActions(): [
+  DirectLineSuggestedAction[],
+  (suggestedActions: DirectLineSuggestedAction[]) => void
+] {
   const value = useSelector(({ suggestedActions }) => suggestedActions);
   const { clearSuggestedActions } = useWebChatAPIContext();
 

package/src/hooks/useTimeoutForSend.ts

@@ -0,0 +1,9 @@
+import { DirectLineActivity } from 'botframework-webchat-core';
+
+import useStyleOptions from './useStyleOptions';
+
+export default function useTimeoutForSend(): [number | ((activity: DirectLineActivity) => number)] {
+  const [{ sendTimeout }] = useStyleOptions();
+
+  return [sendTimeout];
+}

package/src/hooks/{useTrackDimension.js → useTrackDimension.ts}

@@ -1,6 +1,6 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useTrackDimension() {
+export default function useTrackDimension(): (name: string, data: any) => void {
   const { trackDimension } = useWebChatAPIContext();
 
   return trackDimension;

package/src/hooks/{useTrackEvent.js → useTrackEvent.ts}

@@ -9,7 +9,15 @@ function isNonNegativeFiniteNumberOrString(value) {
   return (typeof value === 'number' && isFinite(value) && value >= 0) || typeof value === 'string';
 }
 
-export default function useTrackEvent() {
+type TrackEventFunction = {
+  (name: string, data: any): void;
+  debug: (name: string, data: any) => void;
+  error: (name: string, data: any) => void;
+  info: (name: string, data: any) => void;
+  warn: (name: string, data: any) => void;
+};
+
+export default function useTrackEvent(): TrackEventFunction {
   const { onTelemetry } = useWebChatAPIContext();
   const readTelemetryDimensions = useReadTelemetryDimensions();
 
@@ -40,7 +48,7 @@ export default function useTrackEvent() {
   );
 
   return useMemo(() => {
-    const info = trackEvent.bind(null, 'info');
+    const info: TrackEventFunction = trackEvent.bind(null, 'info');
 
     info.debug = trackEvent.bind(null, 'debug');
     info.error = trackEvent.bind(null, 'error');

package/src/hooks/{useTrackException.js → useTrackException.ts}

@@ -4,7 +4,7 @@ import createCustomEvent from '../utils/createCustomEvent';
 import useReadTelemetryDimensions from './internal/useReadTelemetryDimensions';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useTrackException() {
+export default function useTrackException(): (error: Error, fatal: boolean) => void {
   const { onTelemetry } = useWebChatAPIContext();
   const readTelemetryDimensions = useReadTelemetryDimensions();
 

package/src/hooks/{useTrackTiming.js → useTrackTiming.ts}

@@ -6,7 +6,10 @@ import useReadTelemetryDimensions from './internal/useReadTelemetryDimensions';
 import useTrackException from './useTrackException';
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useTrackTiming() {
+export default function useTrackTiming<T>(): (
+  name: string,
+  functionOrPromise: (() => T) | Promise<T>
+) => Promise<T | void> {
   const { onTelemetry } = useWebChatAPIContext();
   const readTelemetryDimensions = useReadTelemetryDimensions();
   const trackException = useTrackException();

package/src/hooks/{useUserID.js → useUserID.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useUserID() {
+export default function useUserID(): [string] {
   return [useWebChatAPIContext().userID];
 }

package/src/hooks/{useUsername.js → useUsername.ts}

@@ -1,5 +1,5 @@
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useUsername() {
+export default function useUsername(): [string] {
   return [useWebChatAPIContext().username];
 }

package/src/hooks/{useVoiceSelector.js → useVoiceSelector.ts}

@@ -1,7 +1,10 @@
 import { useCallback } from 'react';
+
 import useWebChatAPIContext from './internal/useWebChatAPIContext';
 
-export default function useVoiceSelector(activity) {
+export default function useVoiceSelector(
+  activity
+): (voices: typeof window.SpeechSynthesisVoice[]) => typeof window.SpeechSynthesisVoice {
   const context = useWebChatAPIContext();
 
   return useCallback(voices => context.selectVoice(voices, activity), [activity, context]);