# Changelog

## [3.0.0-rc.1] - 2023-08-03

### Changes

- Add HTTP client for `Finch`

## [3.0.0-rc.0] - 2023-08-06

### Breaking Changes

- Allow to customize the HTTP client
- Remove `:proxy` option

### Changes

- Log a warning if sending fails

### Bug fixes

- Escape metadata fields
- Fix deprecation warnings

### Upgrade Instructions

#### Migrate to `:logger_backends`

If you are using Elixir 1.15, add `:logger_telegram_backend` to your list of dependencies in `mix.exs`:

```elixir
  def deps do
    [
      {:logger_telegram_backend, "~> 3.0-rc"},
      {:logger_backends, "~> 1.0"}
    ]
  end
```

In your `Application.start/2` callback, add the `LoggerTelegramBackend` backend:

```elixir
@impl true
def start(_type, _args) do
  LoggerBackends.add(LoggerTelegramBackend)

  # ...
end
```

Remove the `:backends` configuration from `:logger`:

```elixir
config :logger,
  # Remove this line
  backends: [LoggerTelegramBackend, :console]
```

#### Config

Configuration is now done via `config :logger, LoggerTelegramBackend`.

**Before:**

```elixir
config :logger, :telegram,
  # ...
```

**After:**

```elixir
config :logger, LoggerTelegramBackend,
  # ...
```

#### HTTP client (optional)

Remove the `:adapter` configuration:

```elixir
config :logger, LoggerTelegramBackend,
  # Remove this line
  adapter: {Tesla.Adapter.Finch, name: MyFinch}
```

Add the `:client` option and pass your own module that implements the `LoggerTelegramBackend.HTTPClient` behaviour:

```elixir
config :logger, LoggerTelegramBackend,
  client: MyFinchClient
```

See the documentation for `LoggerTelegramBackend.HTTPClient` and the README for more information.

#### SOCKS5 Proxy (optional)

Remove the `:proxy` configuration:

```elixir
config :logger, LoggerTelegramBackend,
  # Remove this line
  proxy: "socks5://127.0.0.1:9050"
```

And add the following `:hackney_opts`:

```elixir
config :logger, LoggerTelegramBackend,
  hackney_opts: [
    ssl: [verify: :verify_none],
    hackney: [insecure: true],
    proxy: {:socks5, ~c"127.0.0.1", 9050}
  ]
```

## [2.0.1] - 2021-05-02

### Fixed

- Don't crash if sending an event does not succeed

## [2.0.0] - 2020-12-22

### Changed

- Use [tesla](https://github.com/teamon/tesla) to make the underlying HTTP client configurable

### Breaking Changes

- Make hackney an optional dependency. To use the default `hackney` based adapter, add it to the list of dependencies:

  ```elixir
  def deps do
    [
      {:logger_telegram_backend, "~> 2.0.0"},
      {:hackney, "~> 1.17"}
    ]
  end
  ```

## [1.3.0] - 2019-07-22

### Changed

- Respect maximum message length to avoid [MESSAGE_TOO_LONG errors](https://core.telegram.org/method/messages.sendMessage#return-errors)
- Bump ex_doc from 0.20.2 to 0.21.1

## [1.2.1] - 2019-05-27

### Changed

- Bump httpoison from 1.4.0 to 1.5.1
- Bump ex_doc from 0.19.1 to 0.20.2

## [1.2.0] - 2018-11-28

### Added

- Add proxy support (from [@mvalitov](https://github.com/mvalitov))

## [1.1.0] - 2018-11-26

### Changed

- Remove dependency on `Poison`: the success of a request is now solely determined by the HTTP status code.
- Remove `GenStage` and simplify the overall event handling logic
- Update dependencies

## [1.0.3] - 2018-05-25

### Added

- Add `@impl` attributes

### Changed

- Update dependencies
- Format code

### Fixed

- Fix typo in README

## [1.0.2] - 2018-03-01

### Changed

- Update `httpoison` to 1.0

## [1.0.1] - 2018-02-10

### Changed

- Update Dependencies

## [1.0.0] - 2018-01-14

[3.0.0-rc.1]: https://github.com/adriankumpf/logger-telegram-backend/compare/v3.0.0-rc.0...v3.0.0-rc.1
[3.0.0-rc.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v2.0.1...v3.0.0-rc.0
[2.0.1]: https://github.com/adriankumpf/logger-telegram-backend/compare/v2.0.0...v2.0.1
[2.0.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.3.0...v2.0.0
[1.3.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.2.1...v1.3.0
[1.2.1]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.2.0...v1.2.1
[1.2.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.0.3...v1.1.0
[1.0.3]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.0.2...v1.0.3
[1.0.2]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.0.1...v1.0.2
[1.0.1]: https://github.com/adriankumpf/logger-telegram-backend/compare/v1.0.0...v1.0.1
[1.0.0]: https://github.com/adriankumpf/logger-telegram-backend/compare/v0.1.0...v1.0.0