Changelog
View SourceAll notable changes to this project will be documented in this file.
The format follows Keep a Changelog, and this project uses Semantic Versioning.
Unreleased
1.0.0 - 2026-06-12
Added
- Added complete Telegram Bot API method coverage for Bot API 10.1, published on June 11, 2026. Nadia now wraps all 180 official Bot API methods, with 0 missing and 0 extra remote methods in the release inventory.
- Added Bot API 10.1 rich-message wrappers for
sendRichMessageandsendRichMessageDraft, plusrich_messagerequest encoding foreditMessageText. - Added Bot API 10.1 join-request query wrappers for
answerChatJoinRequestQueryandsendChatJoinRequestWebApp. - Added focused Bot API 10.1 parser/model support for
User.supports_join_request_queries,Message.rich_message,ChatJoinRequest.query_id, andPollMedia.link. - Added Telegram poll response structs and parser coverage for
Message.poll, update-levelpollandpoll_answerupdates, poll option service messages, andstopPollresults. - Added Telegram reaction response structs and parser coverage for
message_reactionandmessage_reaction_countupdates. - Added Telegram chat boost response structs and parser coverage for
chat_boost,removed_chat_boost,Message.boost_added, andgetUserChatBoostsresults. - Added Telegram paid media response structs and parser coverage for
Message.paid_media,purchased_paid_mediaupdates, andsendPaidMediaresults. - Added Telegram managed bot response structs and parser coverage for
Message.managed_bot_created,managed_botupdates, andgetManagedBotAccessSettingsresults. - Added Telegram business and guest-query response structs and parser coverage
for
business_connection,deleted_business_messages, business chat profile fields, andanswerGuestQueryresults. - Added Bot API wrappers for guest queries, business connections, managed bot token/access settings, user chat boosts, and user personal chat messages.
- Added Bot API wrappers for business account read/delete, profile, gift settings, and Stars transfer maintenance.
- Added Bot API wrappers for business gift conversion, upgrade, and transfer maintenance.
- Added Bot API gift getter wrappers plus gift and owned-gift response structs/parser coverage.
- Added Bot API story wrappers plus
%Nadia.Model.Story{}response parser coverage. - Added Bot API Star balance getter wrappers and
%Nadia.Model.StarAmount{}parser/model support. - Added Bot API
getStarTransactionswrapper plus Star transaction response structs/parser coverage. - Added Bot API invoice wrappers for sending invoices and creating invoice links.
- Added Bot API wrappers for payment acknowledgement and Telegram Stars payment/subscription maintenance.
- Added Bot API wrappers for bulk message deletion and message reaction maintenance.
- Added Bot API wrappers for chat administration, membership restrictions, join-request moderation, chat metadata, pinned-message, and chat sticker-set maintenance.
- Added Bot API
setChatPhotowrapper with direct chat photo upload support. - Added Bot API wrappers for bot lifecycle and public bot settings maintenance, including commands, descriptions, menu button, default administrator rights, and user emoji status updates.
- Added Bot API wrappers and response structs for object-returning bot settings getters, including commands, profile names/descriptions, menu buttons, and default administrator rights.
- Added Bot API wrappers and response structs for bot profile photos and Mini App prepared inline messages and keyboard buttons.
- Added Bot API organization verification wrappers for users and chats.
- Added Bot API outgoing gift wrappers for gifts and Premium subscriptions.
- Added Bot API forum topic wrappers,
%Nadia.Model.ForumTopic{}, and parser coverage forcreateForumTopicandgetForumTopicIconStickersresults. - Added Bot API wrappers for modern sticker set and custom emoji sticker
maintenance, including
getCustomEmojiStickersparser coverage. - Added Bot API invite-link and user profile audio wrappers, plus
%Nadia.Model.ChatInviteLink{}and%Nadia.Model.UserProfileAudios{}parser/model support. - Added Bot API copy/forward wrappers for
copyMessage,copyMessages, andforwardMessages, plus%Nadia.Model.MessageId{}parser/model support. - Added Bot API send wrappers for
sendVideoNote,sendLivePhoto,sendMediaGroup,sendPaidMedia,sendPoll,sendDice, andsendMessageDraft. - Added Bot API
sendChecklistwrapper plus checklist model/parser support forMessage.checklist. - Added Bot API updating-message wrappers for editing media, live locations, checklists, stopping polls, and approving or declining suggested posts.
- Added Bot API wrappers and parser/model support for Web App query answers, games, game high scores, and Passport data errors.
Changed
- Prepared Nadia 1.0.0 as the first stable release after the transport, explicit-client, parser-safety, and complete Bot API method-coverage refresh.
- Upgraded Req to 0.6.1 for Nadia's default HTTP transport.
- Expanded Telegram response parsing for selected modern
Update,Message,User,MessageEntity, andPhotoSizefields, including fixture-backedgetUpdatescoverage with string-key JSON decoding and no atom creation for unknown response fields. - Preserved explicit
falseTelegram Bot API and Telegraph API request parameters while continuing to omitnilparameters. - Replaced obsolete Telegram Bot API method wrappers
kick_chat_memberandget_chat_members_countwith currentban_chat_memberandget_chat_member_countwrappers. - Added option-support arities for existing Bot API wrappers
forward_message,send_chat_action,delete_webhook,get_chat_administrators,unban_chat_member, andunpin_chat_message.
0.9.0 - 2026-06-05
Added
- Added
%Nadia.Client{}for explicit bot configuration, including default and named application-config constructors. - Added token-redacted inspect output for
%Nadia.Client{}. - Added client-aware public Telegram wrapper arities, such as
Nadia.send_message(client, chat_id, text, options), while preserving legacy single-bot arities. - Added client-aware
Nadia.API.request/4,Nadia.API.request?/4, andNadia.API.build_file_url/2. - Added a Nadia-owned HTTP boundary with normalized request/response structs and configurable HTTP adapters.
- Added default-off
:telegram_livesmoke tests for two explicit bot clients.
Changed
- Raised the minimum supported Elixir version to 1.20 and aligned CI/release workflows with Elixir 1.20 on current Erlang/OTP releases.
- Promoted Req to Nadia's production HTTP transport for both Telegram Bot API and Telegraph API requests.
- Decode Telegram Bot API and Telegraph API responses without creating atoms from remote JSON keys; unknown response fields remain ignored until Nadia explicitly models them.
- Replaced Bot API and Telegraph cassette coverage with deterministic offline request/response tests.
- Normalized Telegraph transport errors and malformed JSON responses into
Nadia.Graph.Model.Error.
Removed
- Removed HTTPoison, hackney, ExVCR, and hackney-specific SOCKS proxy configuration.
0.8.0 - 2026-06-02
Changed
- Raised the minimum supported Elixir version to 1.15.
- Refreshed runtime dependencies for modern Elixir and Erlang/OTP releases:
httpoison2.3,jason1.4, and the current compatible Hackney dependency graph. - Updated CI to verify formatting, compilation with warnings as errors, tests, and documentation generation on modern Elixir/OTP versions.
Removed
- Removed the legacy
inch_exdocumentation check in favor of ExDoc generation with warnings treated as errors.