element-call/src/ErrorView.tsx

/*
Copyright 2025 New Vector Ltd.

SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
Please see LICENSE in the repository root for full details.
*/

import { BigIcon, Button, Heading } from "@vector-im/compound-web";
import {
  useCallback,
  type ComponentType,
  type FC,
  type ReactNode,
  type SVGAttributes,
  type ReactElement,
} from "react";
import { useTranslation } from "react-i18next";
import { logger } from "matrix-js-sdk/lib/logger";

import { RageshakeButton } from "./settings/RageshakeButton";
import styles from "./ErrorView.module.css";
import { useUrlParams } from "./UrlParams";
import { useLeaveToHome } from "./LeaveToHomeContext";
import { useHostBridge } from "./HostBridge.ts";

interface Props {
  Icon: ComponentType<SVGAttributes<SVGElement>>;
  title: string;
  /**
   * Show an option to submit a rageshake.
   * @default false
   */
  rageshake?: boolean;
  /**
   * Whether the error is considered fatal, i.e. non-recoverable. Causes the app
   * to fully reload when clicking 'return to home'.
   * @default false
   */
  fatal?: boolean;
  children: ReactNode;
}

export const ErrorView: FC<Props> = ({
  Icon,
  title,
  rageshake,
  fatal,
  children,
}) => {
  const { t } = useTranslation();
  const { confineToRoom } = useUrlParams();
  const hostBridge = useHostBridge();
  const leaveToHome = useLeaveToHome();

  const onReload = useCallback(() => {
    window.location.href = "/";
  }, []);

  const CloseButton: FC<{ close: () => Promise<void> }> = ({
    close,
  }): ReactElement => {
    // When the host can dismiss us, offer that instead of a link home
    const onClose = (): void => {
      close().catch((e) => {
        // What to do here?
        logger.error("Failed to ask the host to close Element Call", e);
      });
    };
    return (
      <Button kind="primary" onClick={onClose}>
        {t("action.close")}
      </Button>
    );
  };

  // Whether the error is considered fatal or pathname is `/` then reload the all app.
  // If not then navigate to home page. Neither applies when there is no home
  // to go to.
  const ReturnToHomeButton = (): ReactElement | null => {
    if (leaveToHome === null) return null;
    return (
      <Button
        kind="tertiary"
        className={styles.homeLink}
        onClick={fatal || location.pathname === "/" ? onReload : leaveToHome}
      >
        {t("return_home_button")}
      </Button>
    );
  };

  return (
    <div className={styles.error}>
      <BigIcon className={styles.icon}>
        <Icon aria-hidden />
      </BigIcon>
      <Heading as="h1" weight="semibold" size="md">
        {title}
      </Heading>
      {children}
      {rageshake && (
        <RageshakeButton description={`***Error View***: ${title}`} />
      )}
      {hostBridge.close ? (
        <CloseButton close={hostBridge.close} />
      ) : (
        !confineToRoom && <ReturnToHomeButton />
      )}
    </div>
  );
};