@type attr() ::
  {:headers, headers()}
  | {:params, params()}
  | {:next_cursor, Electric.Client.cursor()}
  | {:live, boolean()}
  | {:replica, Electric.Client.replica()}
  | {:shape_handle, Electric.Client.shape_handle() | nil}
  | {:offset, Electric.Client.offset()}
  | {:method, :get | :head | :delete | :options}
  | {:stream_id, term()}

@type attrs() ::
  [attr()]
  | %{
      stream_id: term(),
      method: :get | :head | :delete | :options,
      offset: Electric.Client.offset(),
      shape_handle: Electric.Client.shape_handle() | nil,
      replica: Electric.Client.replica(),
      live: boolean(),
      next_cursor: Electric.Client.cursor(),
      params: params(),
      headers: headers()
    }

@type authenticated() :: %Electric.Client.Fetch.Request{
  authenticated: true,
  endpoint: URI.t(),
  headers: headers(),
  live: boolean(),
  method: :get | :head | :delete | :options,
  next_cursor: Electric.Client.cursor(),
  offset: Electric.Client.offset(),
  params: params(),
  replica: Electric.Client.replica(),
  shape_handle: Electric.Client.shape_handle() | nil,
  stream_id: term()
}

@type headers() :: %{required(String.t()) => [String.t()] | String.t()}

@type params() :: %{required(String.t()) => String.t()}

@type t() :: unauthenticated() | authenticated()

@type unauthenticated() :: %Electric.Client.Fetch.Request{
  authenticated: false,
  endpoint: URI.t(),
  headers: headers(),
  live: boolean(),
  method: :get | :head | :delete | :options,
  next_cursor: Electric.Client.cursor(),
  offset: Electric.Client.offset(),
  params: params(),
  replica: Electric.Client.replica(),
  shape_handle: Electric.Client.shape_handle() | nil,
  stream_id: term()
}