Hikari

Breaking Changes

- Removed case of `Member.mention` returning bang (`!`) mention, as it is deprecated by Discord. ([1207](https://github.com/hikari-py/hikari/issues/1207))

Deprecation

- `RESTClient.edit_permission_overwrites` renamed to `RESTClient.edit_permission_overwrite` ([1195](https://github.com/hikari-py/hikari/issues/1195))

Features

- Add `hikari.events.StickersUpdateEvent` and relevant cache internals.
Add sticker related public methods onto `hikari.impl.CacheImpl` and `hikari.guilds.Guild`. ([1126](https://github.com/hikari-py/hikari/issues/1126))
- `GuildVoiceChannel` now inherits from `TextableGuildChannel` instead of `GuildChannel`. ([1189](https://github.com/hikari-py/hikari/issues/1189))
- Add the `app_permissions` field to command and component interactions. ([1201](https://github.com/hikari-py/hikari/issues/1201))
- Add application command badge ([1225](https://github.com/hikari-py/hikari/issues/1225))

Bugfixes

- Fix how CommandBuilder handles `default_member_permissions` to match the behaviour on PartialCommand. ([1212](https://github.com/hikari-py/hikari/issues/1212))

---

Breaking Changes

- Removal of all application commands v1 related fields and endpoints.
- Discord has completely disabled some endpoints, so we unfortunately can't
deprecate them instead of removing them ([1148](https://github.com/hikari-py/hikari/issues/1148))
- Removed the `resolved` attribute from `AutocompleteInteraction` as autocomplete interactions never have resolved objects. ([1152](https://github.com/hikari-py/hikari/issues/1152))
- `build` methods are now typed as returning `MutableMapping[str, typing.Any]`. ([1164](https://github.com/hikari-py/hikari/issues/1164))

Deprecation

- `messages.Mentions` object deprecated
- Alternatives can be found in the base message object ([1149](https://github.com/hikari-py/hikari/issues/1149))

Features

- Add `create` method to `CommandBuilder`. ([1016](https://github.com/hikari-py/hikari/issues/1016))
- Support for attachments in REST-based interaction responses. ([1048](https://github.com/hikari-py/hikari/issues/1048))
- Add option to disable automatic member chunking.
Added the `auto_chunk_members` kwarg to `GatewayBot` and `EventManagerImpl`, which when `False` will disable automatic member chunking. ([1084](https://github.com/hikari-py/hikari/issues/1084))
- Allow passing multiple event types to the listen decorator.
Parse union type hints for events if listen decorator is empty. ([1103](https://github.com/hikari-py/hikari/issues/1103))
- Animated guild banner support. ([1116](https://github.com/hikari-py/hikari/issues/1116))
- Implement application commands permission v2.
- New `default_member_permissions` and `is_dm_enabled` related fields.
- Added `hikari.events.application_events.ApplicationCommandPermissionsUpdate`.
- Added `APPLICATION_COMMAND_PERMISSION_UPDATE` audit log entry ([1148](https://github.com/hikari-py/hikari/issues/1148))

Bugfixes

- Improved pyright support. ([1108](https://github.com/hikari-py/hikari/issues/1108))
- `RESTClientImpl.fetch_bans` now return a `LazyIterator` to allow pagination of values. ([1119](https://github.com/hikari-py/hikari/issues/1119))
- Fix unicode decode error caused by `latin-1` encoding when sending the banner. ([1120](https://github.com/hikari-py/hikari/issues/1120))
- Don't error on an out-of-spec HTTP status code (e.g one of Cloudflare's custom status codes).
`HTTPResponseError.status` may now be of type `http.HTTPStatus` or `int`. ([1121](https://github.com/hikari-py/hikari/issues/1121))
- Fix name of polish locale (`hikari.Locale.OL` -> `hikari.Locale.PL`) ([1144](https://github.com/hikari-py/hikari/issues/1144))
- Properly garbage collect message references in the cache
- Properly deserialize `PartialMessage.referenced_message` as a partial message ([1192](https://github.com/hikari-py/hikari/issues/1192))

---

Breaking Changes

- `hikari.config` has now been split up to `hikari.api.config` and `hikari.impl.config` to avoid leaking impl detail.
This also means that config types are no-longer accessible at the top level (directly on `hikari`). ([1067](https://github.com/hikari-py/hikari/issues/1067))
- Hide the entity factory's component deserialize methods. ([1074](https://github.com/hikari-py/hikari/issues/1074))
- Remove nonce parameter from create message.
This was purposely removed from the bot api documentation inferring that its no-longer officially supported. ([1075](https://github.com/hikari-py/hikari/issues/1075))
- Remove `VoiceRegion.is_vip` due to Discord no longer sending it. ([1086](https://github.com/hikari-py/hikari/issues/1086))
- Remove store sku related application fields and store channels. ([1092](https://github.com/hikari-py/hikari/issues/1092))

Deprecation

- Renamed `nick` argument to `nickname` for edit member and add user to guild REST methods. ([1095](https://github.com/hikari-py/hikari/issues/1095))

Features

- Scheduled event support. ([1056](https://github.com/hikari-py/hikari/issues/1056))
- `get_guild()` is now available on `hikari.GuildChannel`. ([1057](https://github.com/hikari-py/hikari/issues/1057))
- Optimize receiving websocket JSON for the happy path. ([1058](https://github.com/hikari-py/hikari/issues/1058))
- The threaded file reader now persists the open file pointer while the context manager is active. ([1073](https://github.com/hikari-py/hikari/issues/1073))
- Optimize event dispatching by only deserializing events when they are needed. ([1094](https://github.com/hikari-py/hikari/issues/1094))
- Add `hikari.locales.Locale` to help with Discord locale strings. ([1090](https://github.com/hikari-py/hikari/issues/1090))

Bugfixes

- `fetch_my_guilds` no-longer returns duplicate guilds nor makes unnecessary (duplicated) requests when `newest_first` is set to `True`. ([1059](https://github.com/hikari-py/hikari/issues/1059))
- Add `InviteEvent` to `hikari.events.channel_events.__all__`, `hikari.events.__all__` and `hikari.__all__`. ([1065](https://github.com/hikari-py/hikari/issues/1065))
- Fix incorrect type for ATTACHMENT option values. ([1066](https://github.com/hikari-py/hikari/issues/1066))
- `EventManager.get_listeners` now correctly defines polymorphic and returns accordingly. ([1094](https://github.com/hikari-py/hikari/issues/1094))
- Take the major param for webhook without token endpoints when handling bucket ratelimits. ([1102](https://github.com/hikari-py/hikari/issues/1102))
- Fix incorrect value for `GuildFeature.MORE_STICKERS`. ([1989](https://github.com/hikari-py/hikari/issues/1989))

---

Features

- Added a `total_length` function to `hikari.embeds.Embed`
- Takes into account the character length of the embed's title, description, fields (all field names and values), footer, and author combined.
- Useful for determining if the embed exceeds Discord's 6000 character limit. ([796](https://github.com/hikari-py/hikari/issues/796))
- Added attachment command option type support. ([1015](https://github.com/hikari-py/hikari/issues/1015))
- Add MESSAGE_CONTENT intent. ([1021](https://github.com/hikari-py/hikari/issues/1021))
- Custom substitutions can now be used in `hikari.internal.ux.print_banner`. ([1022](https://github.com/hikari-py/hikari/issues/1022))
- `get_guild()` is now available on `hikari.Member`. ([1025](https://github.com/hikari-py/hikari/issues/1025))
- The notorious "failed to communicate with server" log message is now a warning rather than an error. ([1041](https://github.com/hikari-py/hikari/issues/1041))
- `hikari.applications`, `hikari.files`, `hikari.snowflakes` and `hikari.undefined` are now all explicitly exported by `hikari.__init__`, allowing pyright to see them without a direct import. ([1042](https://github.com/hikari-py/hikari/issues/1042))

Bugfixes

- Fix bucket lock not being released on errors while being acquired, which locked the bucket infinitely ([841](https://github.com/hikari-py/hikari/issues/841))
- `enable_signal_handlers` now only defaults to `True` when the run/start method is called in the main thread.
This avoids these functions from always raising when being run in a threaded environment as only the main thread can register signal handlers. ([998](https://github.com/hikari-py/hikari/issues/998))
- Sub-command options are now properly deserialized in the autocomplete flow to `AutocompleteInteractionOption` instead of `CommandInteractionOption`. ([1012](https://github.com/hikari-py/hikari/issues/1012))
- Attempt to reconnect on a gateway `TimeoutError`. ([1014](https://github.com/hikari-py/hikari/issues/1014))
- Properly close `GatewayBot` when not fully started. ([1023](https://github.com/hikari-py/hikari/issues/1023))
- The async context manager returned by `File.stream` now errors on enter if the target file doesn't exist to improve error handling when a file that doesn't exist is sent as an attachment.

The multiprocessing file reader strategy now expands user relative (`~`) links (like the threaded strategy). ([1046](https://github.com/hikari-py/hikari/issues/1046))

---

Breaking Changes

- Running the standard interaction server implementation now requires a `hikari[server]` install.

This matches a switch over to PyNacl for the cryptographic payload validation. ([986](https://github.com/hikari-py/hikari/issues/986))

Deprecation

- Deprecated `RESTClient.command_builder` and `RESTClient.create_application_command`.

You should switch to `RESTClient.slash_command_builder`and `RESTClient.create_slash_command` respectively. ([924](https://github.com/hikari-py/hikari/issues/924))

Features

- Add context menu commands and command autocomplete. ([924](https://github.com/hikari-py/hikari/issues/924))
- Added support for GET /users/me/guilds/{guild}/member. ([955](https://github.com/hikari-py/hikari/issues/955))
- Add the `SUPPRESS_USER_JOIN_REPLIES` system channel flag. ([957](https://github.com/hikari-py/hikari/issues/957))
- Add new message content intent related application flags. ([958](https://github.com/hikari-py/hikari/issues/958))
- Add the `BOT_HTTP_INTERACTIONS` user flag. ([959](https://github.com/hikari-py/hikari/issues/959))
- Add new presence activity flags. ([960](https://github.com/hikari-py/hikari/issues/960))
- Add URL methods and properties for rich presence assets. ([961](https://github.com/hikari-py/hikari/issues/961))
- Add `locale` and `guild_locale` properties to interactions. ([962](https://github.com/hikari-py/hikari/issues/962))
- Add ability to send attachments in an interaction initial response. ([971](https://github.com/hikari-py/hikari/issues/971))
- Add `display_avatar_url` property to `hikari.Member` and `hikari.User`. ([975](https://github.com/hikari-py/hikari/issues/975))
- old_x keyword arguments in the event factory now default to `None`. ([984](https://github.com/hikari-py/hikari/issues/984))
- Strip tokens in the standard bot impls and RESTApp.

This helps avoids a common mistake with trailing new-lines which leads to confusing errors on request. ([989](https://github.com/hikari-py/hikari/issues/989))

Bugfixes

- Relaxed typing of methods with union entry specific specialisations through overloads. ([876](https://github.com/hikari-py/hikari/issues/876))
- Fix deprecation warnings raised by usage of `asyncio.gather` outside of an active event loop in `GatewayBot.run`. ([954](https://github.com/hikari-py/hikari/issues/954))
- UTF-8 characters are now properly handled for audit-log reasons in REST requests. ([963](https://github.com/hikari-py/hikari/issues/963))
- Fix magic methods for `UserImpl` and its subclasses. ([982](https://github.com/hikari-py/hikari/issues/982))

---

Features

- Add min_value and max_value to `CommandOption` ([920](https://github.com/hikari-py/hikari/issues/920))
- Add `flags` attribute to Application ([939](https://github.com/hikari-py/hikari/issues/939))
- Implement member timeouts
- Add `raw_communication_disabled_until` and `communication_disabled_until` to `Member`
- Add `MODERATE_MEMBERS` to `Permission`
- Add `communication_disabled_until` attribute to `edit_member` ([940](https://github.com/hikari-py/hikari/issues/940))

Bugfixes

- Improved pyright compatibility and introduced pyright "type-completeness" checking. ([916](https://github.com/hikari-py/hikari/issues/916))
- Add EventStream.filter specialisation to the abc. ([917](https://github.com/hikari-py/hikari/issues/917))
- Update the app command name regex to account for more recently documented support for non-english characters on Discord's end. ([918](https://github.com/hikari-py/hikari/issues/918))
- Fix reposition_roles using the wrong route. ([928](https://github.com/hikari-py/hikari/issues/928))
- Fix `PartialSticker.image_url` not passing the hash as a string ([930](https://github.com/hikari-py/hikari/issues/930))
- Fixed the url being generated for role icons to not erroneously insert ".png" before the file extension ([931](https://github.com/hikari-py/hikari/issues/931))
- Fix some bugs in message deserialization
- Remove case for setting `member` and `reference_message` to `undefined.Undefined` in full message deserialization
- Don't set `message.member` to `undefined.UNDEFINED` on partial message deserialization if message was sent by a webhook ([933](https://github.com/hikari-py/hikari/issues/933))

---