soapbox/app/soapbox/features/ads/components/ad.tsx

import { useQuery, useQueryClient } from '@tanstack/react-query';
import React, { useState, useEffect, useRef } from 'react';
import { FormattedMessage } from 'react-intl';
import { Link } from 'react-router-dom';
import HoverRefWrapper from 'soapbox/components/hover-ref-wrapper';

import { Avatar, Card, HStack, Icon, IconButton, Stack, Text } from 'soapbox/components/ui';
import StatusCard from 'soapbox/features/status/components/card';
import { useInstance } from 'soapbox/hooks';

import type { Ad as AdEntity } from 'soapbox/types/soapbox';

interface IAd {
  ad: AdEntity,
}

/** Displays an ad in sponsored post format. */
const Ad: React.FC<IAd> = ({ ad }) => {
  const queryClient = useQueryClient();
  const instance = useInstance();

  const timer = useRef<NodeJS.Timeout | undefined>(undefined);
  const infobox = useRef<HTMLDivElement>(null);
  const [showInfo, setShowInfo] = useState(false);

  // Fetch the impression URL (if any) upon displaying the ad.
  // Don't fetch it more than once.
  useQuery(['ads', 'impression', ad.impression], () => {
    if (ad.impression) {
      return fetch(ad.impression);
    }
  }, { cacheTime: Infinity, staleTime: Infinity });

  /** Invalidate query cache for ads. */
  const bustCache = (): void => {
    queryClient.invalidateQueries(['ads']);
  };

  /** Toggle the info box on click. */
  const handleInfoButtonClick: React.MouseEventHandler = () => {
    setShowInfo(!showInfo);
  };

  /** Hide the info box when clicked outside. */
  const handleClickOutside = (event: MouseEvent) => {
    if (event.target && infobox.current && !infobox.current.contains(event.target as any)) {
      setShowInfo(false);
    }
  };

  // Hide the info box when clicked outside.
  // https://stackoverflow.com/a/42234988
  useEffect(() => {
    document.addEventListener('mousedown', handleClickOutside);
    return () => {
      document.removeEventListener('mousedown', handleClickOutside);
    };
  }, [infobox]);

  // Wait until the ad expires, then invalidate cache.
  useEffect(() => {
    if (ad.expires_at) {
      const delta = new Date(ad.expires_at).getTime() - (new Date()).getTime();
      timer.current = setTimeout(bustCache, delta);
    }

    return () => {
      if (timer.current) {
        clearTimeout(timer.current);
      }
    };
  }, [ad.expires_at]);

  return (
    <div className='relative'>
      <Card className='py-6 sm:p-5' variant='rounded'>
        <Stack space={4}>
          <HStack alignItems='center' space={3}>
            {ad.account ? (
              <HoverRefWrapper accountId={ad.account.id} inline>
                <Link to={`/@${ad.account.acct}`}>
                  <Avatar src={ad.account.avatar} size={42} />
                </Link>
              </HoverRefWrapper>
            ) : (
              <Avatar src={instance.thumbnail} size={42} />
            )}

            <Stack grow>
              <HStack space={1}>
                <Text size='sm' weight='semibold' truncate>
                  {ad.account ? (
                    <HoverRefWrapper accountId={ad.account.id} inline>
                      <Link
                        to={`/@${ad.account.acct}`}
                        dangerouslySetInnerHTML={{ __html: ad.account.display_name_html }}
                      />
                    </HoverRefWrapper>
                  ) : (
                    instance.title
                  )}
                </Text>

                <Icon
                  className='w-5 h-5 stroke-accent-500'
                  src={require('@tabler/icons/timeline.svg')}
                />
              </HStack>

              <Stack>
                <HStack alignItems='center' space={1}>
                  <Text theme='muted' size='sm' truncate>
                    <FormattedMessage id='sponsored.subtitle' defaultMessage='Sponsored post' />
                  </Text>
                </HStack>
              </Stack>
            </Stack>

            <Stack justifyContent='center'>
              <IconButton
                iconClassName='stroke-gray-600 w-6 h-6'
                src={require('@tabler/icons/info-circle.svg')}
                onClick={handleInfoButtonClick}
              />
            </Stack>
          </HStack>

          <StatusCard card={ad.card} onOpenMedia={() => {}} horizontal />
        </Stack>
      </Card>

      {showInfo && (
        <div ref={infobox} className='absolute top-5 right-5 max-w-[234px]'>
          <Card variant='rounded'>
            <Stack space={2}>
              <Text size='sm' weight='bold'>
                <FormattedMessage id='sponsored.info.title' defaultMessage='Why am I seeing this ad?' />
              </Text>

              <Text size='sm' theme='muted'>
                {ad.reason ? (
                  ad.reason
                ) : (
                  <FormattedMessage
                    id='sponsored.info.message'
                    defaultMessage='{siteTitle} displays ads to help fund our service.'
                    values={{ siteTitle: instance.title }}
                  />
                )}
              </Text>
            </Stack>
          </Card>
        </div>
      )}
    </div>
  );
};

export default Ad;