@spec batch_send_emails(
  domain :: t(),
  body :: ApolloSignal.Types.BatchSendRequest.t(),
  options :: keyword()
) ::
  {:ok, ApolloSignal.Types.BatchSendResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec bulk_cancel_emails(domain :: t(), options :: keyword()) ::
  {:ok, ApolloSignal.Types.BulkCancelResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec cancel_email(domain :: t(), email_id :: String.t(), options :: keyword()) ::
  {:ok, ApolloSignal.Types.CancelResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec get_email(domain :: t(), email_id :: String.t(), options :: keyword()) ::
  {:ok, ApolloSignal.Types.EmailDetailResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec issue_stream_token(
  domain :: t(),
  project_id :: String.t(),
  options :: keyword()
) ::
  {:ok, ApolloSignal.Types.StreamTokenResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec new(ApolloSignal.Client.t()) :: t()

@spec send_email(
  domain :: t(),
  body :: ApolloSignal.Types.SendEmailRequest.t(),
  options :: keyword()
) ::
  {:ok, ApolloSignal.Types.SendEmailResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}

@spec stream_email_events(domain :: t(), options :: keyword()) ::
  {:ok,
   ApolloSignal.Transport.SSEStream.t(
     ApolloSignal.Types.StreamEventResponse.t()
   )}
  | {:error, ApolloSignal.Errors.t()}

@spec validate_links(
  domain :: t(),
  body :: ApolloSignal.Types.ValidateLinksRequest.t(),
  options :: keyword()
) ::
  {:ok, ApolloSignal.Types.ValidateLinksResponse.t(),
   ApolloSignal.Transport.metadata()}
  | {:error, ApolloSignal.Errors.t()}