# Change Log

<!-- next-header -->

## [Unreleased] - ReleaseDate

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.14.0...Unreleased)

## [v0.14.0] - 2024-09-23

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.13.0...v0.14.0)

### Breaking

- MSRV bumped to `1.70.0`

### Added

- Added new scopes `channel:manage:guest_star`, `channel:read:guest_star`, `moderator:manage:guest_star`, `moderator:manage:unban_requests`, `moderator:manage:warnings`, `moderator:read:banned_users`, `moderator:read:chat_messages`, `moderator:read:guest_star`, `moderator:read:moderators`, `moderator:read:suspicious_users`, `moderator:read:unban_requests`, `moderator:read:vips`, `moderator:read:warnings`, `user:read:emotes`

### Fixed

- Removed unused generic in `AppAccessToken::from_existing`

## [v0.13.0] - 2024-04-04

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.9...v0.13.0)

### Changed

- **BREAKING:** Updated `http` to `1.1.0` and `reqwest` to `0.12.2`

## [v0.12.9] - 2024-01-27

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.8...v0.12.9)

### Added

- Added new scope `user:write:chat`

## [v0.12.8] - 2024-01-09

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.7...v0.12.8)

### Added

- Added new scope `user:read:moderated_channels`

## [v0.12.7] - 2023-10-23

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.6...v0.12.7)

### Added

- Added new scopes `channel:bot`, `user:bot`, `user:read:chat`, `channel:manage:ads` and `channel:read:ads`.

## [v0.12.6] - 2023-09-17

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.5...v0.12.6)

## [v0.12.5] - 2023-09-17

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.4...v0.12.5)

## [v0.12.4] - 2023-05-29

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.3...v0.12.4)

## [v0.12.3] - 2023-05-28

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.2...v0.12.3)

## [v0.12.2] - 2023-05-06

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.1...v0.12.2)

### Changed

- Made `validator!()` work so that it returns an empty validator which matches anything.

## [v0.12.1] - 2023-05-06

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.12.0...v0.12.1)

### Added

- Added `Validator` and `validator!` for validating tokens.
- Added new function `UserToken::from_token` for creating a token with only a access token available.

## [v0.12.0] - 2023-05-01

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.11.1...v0.12.0)

### Added

- Added `moderator:read:followers` scope
- Added `Scope::all_slice`, `Scope::as_static_str` to do const operations
- Added `ValidationError::InvalidToken` to signify a invalid response for that specific token type

### Changed

- Made `Scope::description` const
- Made error enums non exhaustive
- Marked `user:edit:follows` as deprecated

### Removed

- Removed `ValidationError::NoLogin`, replaced with `ValidationError::InvalidToken`

## [v0.11.1] - 2023-02-01

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.11.0...v0.11.1)

### Added

- Added scopes for shoutouts

### Changed

- Marked `channel_subscriptions` as deprecated.

## [v0.11.0] - 2023-01-24

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.10.0...v0.11.0)

### Breaking

- Updated `twitch_types` to `0.4.0`
- MSRV bumped to `1.66.1`

## [v0.10.0] - 2022-12-19

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.9.2...v0.10.0)

### Breaking

- Changed `Client` trait to not be specified over a lifetime. Fixes an issue where &'1 Thing<'static> where: Thing<'static> would wrongly lower '1 to be specific. See https://github.com/twitch-rs/twitch_api/issues/236

## [v0.9.2] - 2022-12-04

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.9.1...v0.9.2)

## [v0.9.1] - 2022-12-03

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.9.0...v0.9.1)

### Added

- Added new scopes `moderator:read:chatters`, `moderator:read:shield_mode`, `moderator:manage:shield_mode`

## [v0.9.0] - 2022-10-15

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.8.0...v0.9.0)

### Breaking

- Added new feature flag `client` that enables client specific functions. Without this feature,
  `twitch_oauth2` will only provide non-async functions and
  provide library users functions that returns `http::Request`s and consume `http::Response`s.
- `ValidatedToken::expires_in` is now an `Option`.

## [v0.8.0] - 2022-08-27

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.7.1...v0.8.0)

### Breaking

- Bumped `aliri_braid` to `0.2`, this change means that the `new` method on the types in `types` only take an owned string now
  - `AccessToken::new`, `ClientId::new`, `ClientSecret::new`, `CsrfToken::new` and `RefreshToken::new` now take a `String` instead of `impl Into<String>`

## [v0.7.1] - 2022-08-27

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.7.0...v0.7.1)

### Changed

- Organization moved to `twitch-rs`

### Added

- Added scopes `channel:manage:raids`, `channel:manage:moderators`, `channel:manage:vips`, `channel:read:charity`,
  `channel:read:vips`, `moderator:manage:announcements`, `moderator:manage:chat_messages`, `user:manage:chat_color` and
  `user:manage:whispers`

## [v0.7.0] - 2022-05-08

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.6.1...v0.7.0)

### Breaking changes

- switch to [`twitch_types`](https://crates.io/crates/twitch_types) for `UserId` and `Nickname`/`UserName`
- bump MSRV to 1.60, also changes the feature names for clients to their simpler variant `surf` and `client`

## [v0.6.1] - 2021-11-23

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.6.0...v0.6.1)

### Added

- Added new scopes `moderator:manage:automod_settings`, `moderator:manage:banned_users`,
  `moderator:manage:blocked_terms`, `moderator:manage:chat_settings`, `moderator:read:automod_settings`,
  `moderator:read:blocked_terms` and `moderator:read:chat_settings`

## [v0.6.0] - 2021-09-27

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.5.2...v0.6.0)

### Breaking changes

- All types associated with tokens are now defined in this crate. This is a consequence of the `oauth2` dependency being removed from tree.
  Additionally, as another consequence, clients are now able to be specified as a `for<'a> &'a T where T: Client<'a>`, meaning `twitch_api` can use its clients as an interface to token requests,
  and clients can persist instead of being rebuilt every call. Care should be taken when making clients, as SSRF and similar attacks are possible with improper client configurations.

### Added

- Added types/braids `ClientId`, `ClientSecret`, `AccessToken`, `RefreshToken` and `CsrfToken`.
- Added way to interact with the Twitch-CLI [mock API](https://github.com/twitchdev/twitch-cli/blob/main/docs/mock-api.md) using environment variables.
  See static variables `AUTH_URL`, `TOKEN_URL`, `VALIDATE_URL` and `REVOKE_URL` for more information.
- Added `impl Borrow<str> for Scope`, meaning it can be used in places it couldn't be used before. Primarily, it allows the following code to work:
  ```rust
  let scopes = vec![Scope::ChatEdit, Scope::ChatRead];
  let space_separated_scope: String = scopes.as_slice().join(" ");
  ```
- Added scope `channel:read:goals`

### Changed

- Requests to `id.twitch.tv` now follow the documentation, instead of following a subset of the RFC for oauth2.
- URLs are now initialized lazily and specified as `url::Url`s.

### Removed

- Removed `oauth2` dependency.

## [v0.5.2] - 2021-06-18

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.5.1...v0.5.2)

### Added

- Added new scope `channel:manage:schedule`

## [v0.5.1] - 2021-05-16

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/v0.5.0...v0.5.1)

### Added

- Added new scopes `channel:manage:polls`, `channel:manage:predictions`, `channel:read:polls`, `channel:read:predictions`, and `moderator:manage:automod`,
- Added function `Scope::description` to get the description of the scope

## [v0.5.0] - 2021-05-08

[Commits](https://github.com/twitch-rs/twitch_oauth2/compare/49a083ceda6768cc52a1f8f1714bb7f942f24c01...v0.5.0)

### Added

- Made crate runtime agnostic with custom clients.
- Updated deps.
- Add an extra (optional) client secret field to `UserToken::from_existing` (thanks [Dinnerbone](https://github.com/Dinnerbone))
- Added `channel:manage:redemptions`, `channel:read:editors`, `channel:manage:videos`, `user:read:blocked_users`, `user:manage:blocked_users`, `user:read:subscriptions` and `user:read:follows`
- Implemented [OAuth Authorization Code Flow](https://dev.twitch.tv/docs/authentication/getting-tokens-oauth/#authorization-code-grant-flow) with `UserTokenBuilder`
- Added a way to suggest or infer that an user token is never expiring, making `is_elapsed` return false and `expires_in` a bogus (max) duration.

### Changed

- MSRV: 1.51
- Made scope take `Cow<&'static str>`
- Made fields `access_token`, `refresh_token`, `user_id` and `login` `pub` on `UserToken` and `AppAccessToken` (where applicable)
- Fixed wrong scope `user:read:stream_key` -> `channel:read:stream_key`
- BREAKING: changed `TwitchToken::expires` -> `TwitchToken::expires_in` to calculate current lifetime of token

## End of Changelog

Changelog starts on v0.5.0