@effect-ak/tg-bot-api 1.0.0 → 1.3.0

package/dist/index.d.ts

@@ -681,6 +681,7 @@ interface ChatFullInfo {
     linked_chat_id?: number;
     location?: ChatLocation;
     rating?: UserRating;
+    first_profile_audio?: Audio;
     unique_gift_colors?: UniqueGiftColors;
     paid_message_star_count?: number;
 }
@@ -782,6 +783,12 @@ interface ChatMemberUpdated {
     via_join_request?: boolean;
     via_chat_folder_invite_link?: boolean;
 }
+interface ChatOwnerChanged {
+    new_owner: User;
+}
+interface ChatOwnerLeft {
+    new_owner?: User;
+}
 interface ChatPermissions {
     can_send_messages?: boolean;
     can_send_audios?: boolean;
@@ -1037,6 +1044,8 @@ interface InaccessibleMessage {
 }
 interface InlineKeyboardButton {
     text: string;
+    icon_custom_emoji_id?: string;
+    style?: "danger" | "success" | "primary";
     url?: string;
     callback_data?: string;
     web_app?: WebAppInfo;
@@ -1517,6 +1526,8 @@ interface Invoice {
 }
 interface KeyboardButton {
     text: string;
+    icon_custom_emoji_id?: string;
+    style?: "danger" | "success" | "primary";
     request_users?: KeyboardButtonRequestUsers;
     request_chat?: KeyboardButtonRequestChat;
     request_contact?: boolean;
@@ -1654,6 +1665,8 @@ interface Message {
     location?: Location;
     new_chat_members?: User[];
     left_chat_member?: User;
+    chat_owner_left?: ChatOwnerLeft;
+    chat_owner_changed?: ChatOwnerChanged;
     new_chat_title?: string;
     new_chat_photo?: PhotoSize[];
     delete_chat_photo?: boolean;
@@ -2221,6 +2234,7 @@ interface UniqueGift {
     symbol: UniqueGiftSymbol;
     backdrop: UniqueGiftBackdrop;
     is_premium?: boolean;
+    is_burned?: boolean;
     is_from_blockchain?: boolean;
     colors?: UniqueGiftColors;
     publisher_chat?: Chat;
@@ -2257,6 +2271,7 @@ interface UniqueGiftModel {
     name: string;
     sticker: Sticker;
     rarity_per_mille: number;
+    rarity?: "uncommon" | "rare" | "epic" | "legendary";
 }
 interface UniqueGiftSymbol {
     name: string;
@@ -2304,10 +2319,15 @@ interface User {
     can_connect_to_business?: boolean;
     has_main_web_app?: boolean;
     has_topics_enabled?: boolean;
+    allows_users_to_create_topics?: boolean;
 }
 interface UserChatBoosts {
     boosts: ChatBoost[];
 }
+interface UserProfileAudios {
+    total_count: number;
+    audios: Audio[];
+}
 interface UserProfilePhotos {
     total_count: number;
     photos: PhotoSize[][];
@@ -2340,6 +2360,7 @@ interface Video {
     thumbnail?: PhotoSize;
     cover?: PhotoSize[];
     start_timestamp?: number;
+    qualities?: VideoQuality[];
     file_name?: string;
     mime_type?: string;
     file_size?: number;
@@ -2362,6 +2383,14 @@ interface VideoNote {
     thumbnail?: PhotoSize;
     file_size?: number;
 }
+interface VideoQuality {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    codec: string;
+    file_size?: number;
+}
 interface Voice {
     file_id: string;
     file_unique_id: string;
@@ -2469,6 +2498,7 @@ interface Api {
     get_updates(_: GetUpdatesInput): Update[];
     get_user_chat_boosts(_: GetUserChatBoostsInput): UserChatBoosts;
     get_user_gifts(_: GetUserGiftsInput): OwnedGifts;
+    get_user_profile_audios(_: GetUserProfileAudiosInput): UserProfileAudios;
     get_user_profile_photos(_: GetUserProfilePhotosInput): UserProfilePhotos;
     get_webhook_info(_: GetWebhookInfoInput): WebhookInfo;
     gift_premium_subscription(_: GiftPremiumSubscriptionInput): boolean;
@@ -2482,6 +2512,7 @@ interface Api {
     refund_star_payment(_: RefundStarPaymentInput): boolean;
     remove_business_account_profile_photo(_: RemoveBusinessAccountProfilePhotoInput): boolean;
     remove_chat_verification(_: RemoveChatVerificationInput): boolean;
+    remove_my_profile_photo(_: RemoveMyProfilePhotoInput): boolean;
     remove_user_verification(_: RemoveUserVerificationInput): boolean;
     reopen_forum_topic(_: ReopenForumTopicInput): boolean;
     reopen_general_forum_topic(_: ReopenGeneralForumTopicInput): boolean;
@@ -2531,6 +2562,7 @@ interface Api {
     set_my_default_administrator_rights(_: SetMyDefaultAdministratorRightsInput): boolean;
     set_my_description(_: SetMyDescriptionInput): boolean;
     set_my_name(_: SetMyNameInput): boolean;
+    set_my_profile_photo(_: SetMyProfilePhotoInput): boolean;
     set_my_short_description(_: SetMyShortDescriptionInput): boolean;
     set_passport_data_errors(_: SetPassportDataErrorsInput): boolean;
     set_sticker_emoji_list(_: SetStickerEmojiListInput): boolean;
@@ -2982,6 +3014,11 @@ interface GetUserGiftsInput {
     offset?: string;
     limit?: number;
 }
+interface GetUserProfileAudiosInput {
+    user_id: number;
+    offset?: number;
+    limit?: number;
+}
 interface GetUserProfilePhotosInput {
     user_id: number;
     offset?: number;
@@ -3058,6 +3095,8 @@ interface RemoveBusinessAccountProfilePhotoInput {
 interface RemoveChatVerificationInput {
     chat_id: number | string;
 }
+interface RemoveMyProfilePhotoInput {
+}
 interface RemoveUserVerificationInput {
     user_id: number;
 }
@@ -3570,6 +3609,9 @@ interface SetMyNameInput {
     name?: string;
     language_code?: string;
 }
+interface SetMyProfilePhotoInput {
+    photo: InputProfilePhoto;
+}
 interface SetMyShortDescriptionInput {
     short_description?: string;
     language_code?: string;
@@ -3688,4 +3730,4 @@ interface VerifyUserInput {
     custom_description?: string;
 }
 
-export type { Accelerometer, AccelerometerStartParams, AcceptedGiftTypes, AddStickerToSetInput, AffiliateInfo, AllowedUpdateName, Animation, AnswerCallbackQueryInput, AnswerInlineQueryInput, AnswerPreCheckoutQueryInput, AnswerShippingQueryInput, AnswerWebAppQueryInput, Api, ApproveChatJoinRequestInput, ApproveSuggestedPostInput, Audio, BackButton, BackgroundFill, BackgroundFillFreeformGradient, BackgroundFillGradient, BackgroundFillSolid, BackgroundType, BackgroundTypeChatTheme, BackgroundTypeFill, BackgroundTypePattern, BackgroundTypeWallpaper, BanChatMemberInput, BanChatSenderChatInput, BindOrUnbindEventHandler, BiometricAuthenticateParams, BiometricManager, BiometricRequestAccessParams, Birthdate, BotCommand, BotCommandScope, BotCommandScopeAllChatAdministrators, BotCommandScopeAllGroupChats, BotCommandScopeAllPrivateChats, BotCommandScopeChat, BotCommandScopeChatAdministrators, BotCommandScopeChatMember, BotCommandScopeDefault, BotDescription, BotName, BotShortDescription, BottomButton, BusinessBotRights, BusinessConnection, BusinessIntro, BusinessLocation, BusinessMessagesDeleted, BusinessOpeningHours, BusinessOpeningHoursInterval, CallbackGame, CallbackQuery, Chat, ChatAdministratorRights, ChatBackground, ChatBoost, ChatBoostAdded, ChatBoostRemoved, ChatBoostSource, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway, ChatBoostSourcePremium, ChatBoostUpdated, ChatFullInfo, ChatInviteLink, ChatJoinRequest, ChatLocation, ChatMember, ChatMemberAdministrator, ChatMemberBanned, ChatMemberLeft, ChatMemberMember, ChatMemberOwner, ChatMemberRestricted, ChatMemberUpdated, ChatPermissions, ChatPhoto, ChatShared, Checklist, ChecklistTask, ChecklistTasksAdded, ChecklistTasksDone, ChosenInlineResult, CloseForumTopicInput, CloseGeneralForumTopicInput, CloseInput, CloudStorage, Contact, ContentSafeAreaInset, ConvertGiftToStarsInput, CopyMessageInput, CopyMessagesInput, CopyTextButton, CreateChatInviteLinkInput, CreateChatSubscriptionInviteLinkInput, CreateForumTopicInput, CreateInvoiceLinkInput, CreateNewStickerSetInput, DeclineChatJoinRequestInput, DeclineSuggestedPostInput, DeleteBusinessMessagesInput, DeleteChatPhotoInput, DeleteChatStickerSetInput, DeleteForumTopicInput, DeleteMessageInput, DeleteMessagesInput, DeleteMyCommandsInput, DeleteStickerFromSetInput, DeleteStickerSetInput, DeleteStoryInput, DeleteWebhookInput, DeviceOrientation, DeviceOrientationStartParams, DeviceStorage, Dice, DirectMessagePriceChanged, DirectMessagesTopic, Document, DownloadFileParams, EditChatInviteLinkInput, EditChatSubscriptionInviteLinkInput, EditForumTopicInput, EditGeneralForumTopicInput, EditMessageCaptionInput, EditMessageChecklistInput, EditMessageLiveLocationInput, EditMessageMediaInput, EditMessageReplyMarkupInput, EditMessageTextInput, EditStoryInput, EditUserStarSubscriptionInput, EmojiStatusParams, EncryptedCredentials, EncryptedPassportElement, EventHandlers, ExportChatInviteLinkInput, ExternalReplyInfo, File, ForceReply, ForumTopic, ForumTopicClosed, ForumTopicCreated, ForumTopicEdited, ForumTopicReopened, ForwardMessageInput, ForwardMessagesInput, Game, GameHighScore, GeneralForumTopicHidden, GeneralForumTopicUnhidden, GetAvailableGiftsInput, GetBusinessAccountGiftsInput, GetBusinessAccountStarBalanceInput, GetBusinessConnectionInput, GetChatAdministratorsInput, GetChatGiftsInput, GetChatInput, GetChatMemberCountInput, GetChatMemberInput, GetChatMenuButtonInput, GetCustomEmojiStickersInput, GetFileInput, GetForumTopicIconStickersInput, GetGameHighScoresInput, GetMeInput, GetMyCommandsInput, GetMyDefaultAdministratorRightsInput, GetMyDescriptionInput, GetMyNameInput, GetMyShortDescriptionInput, GetMyStarBalanceInput, GetStarTransactionsInput, GetStickerSetInput, GetUpdatesInput, GetUserChatBoostsInput, GetUserGiftsInput, GetUserProfilePhotosInput, GetWebhookInfoInput, Gift, GiftBackground, GiftInfo, GiftPremiumSubscriptionInput, Gifts, Giveaway, GiveawayCompleted, GiveawayCreated, GiveawayWinners, Gyroscope, GyroscopeStartParams, HapticFeedback, HideGeneralForumTopicInput, InaccessibleMessage, InlineKeyboardButton, InlineKeyboardMarkup, InlineQuery, InlineQueryResult, InlineQueryResultArticle, InlineQueryResultAudio, InlineQueryResultCachedAudio, InlineQueryResultCachedDocument, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedPhoto, InlineQueryResultCachedSticker, InlineQueryResultCachedVideo, InlineQueryResultCachedVoice, InlineQueryResultContact, InlineQueryResultDocument, InlineQueryResultGame, InlineQueryResultGif, InlineQueryResultLocation, InlineQueryResultMpeg4Gif, InlineQueryResultPhoto, InlineQueryResultVenue, InlineQueryResultVideo, InlineQueryResultVoice, InlineQueryResultsButton, InputChecklist, InputChecklistTask, InputContactMessageContent, InputFile, InputInvoiceMessageContent, InputLocationMessageContent, InputMedia, InputMediaAnimation, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, InputMessageContent, InputPaidMedia, InputPaidMediaPhoto, InputPaidMediaVideo, InputPollOption, InputProfilePhoto, InputProfilePhotoAnimated, InputProfilePhotoStatic, InputSticker, InputStoryContent, InputStoryContentPhoto, InputStoryContentVideo, InputTextMessageContent, InputVenueMessageContent, Invoice, KeyboardButton, KeyboardButtonPollType, KeyboardButtonRequestChat, KeyboardButtonRequestUsers, LabeledPrice, LeaveChatInput, LinkPreviewOptions, Location, LocationAddress, LocationData, LocationManager, LogOutInput, LoginUrl, MaskPosition, MaybeInaccessibleMessage, MenuButton, MenuButtonCommands, MenuButtonDefault, MenuButtonWebApp, Message, MessageAutoDeleteTimerChanged, MessageEntity, MessageId, MessageOrigin, MessageOriginChannel, MessageOriginChat, MessageOriginHiddenUser, MessageOriginUser, MessageReactionCountUpdated, MessageReactionUpdated, OrderInfo, OwnedGift, OwnedGiftRegular, OwnedGiftUnique, OwnedGifts, PaidMedia, PaidMediaInfo, PaidMediaPhoto, PaidMediaPreview, PaidMediaPurchased, PaidMediaVideo, PaidMessagePriceChanged, PassportData, PassportElementError, PassportElementErrorDataField, PassportElementErrorFile, PassportElementErrorFiles, PassportElementErrorFrontSide, PassportElementErrorReverseSide, PassportElementErrorSelfie, PassportElementErrorTranslationFile, PassportElementErrorTranslationFiles, PassportElementErrorUnspecified, PassportFile, PhotoSize, PinChatMessageInput, Poll, PollAnswer, PollOption, PopupButton, PopupParams, PostStoryInput, PreCheckoutQuery, PreparedInlineMessage, PromoteChatMemberInput, ProximityAlertTriggered, ReactionCount, ReactionType, ReactionTypeCustomEmoji, ReactionTypeEmoji, ReactionTypePaid, ReadBusinessMessageInput, RefundStarPaymentInput, RefundedPayment, RemoveBusinessAccountProfilePhotoInput, RemoveChatVerificationInput, RemoveUserVerificationInput, ReopenForumTopicInput, ReopenGeneralForumTopicInput, ReplaceStickerInSetInput, ReplyKeyboardMarkup, ReplyKeyboardRemove, ReplyParameters, RepostStoryInput, ResponseParameters, RestrictChatMemberInput, RevenueWithdrawalState, RevenueWithdrawalStateFailed, RevenueWithdrawalStatePending, RevenueWithdrawalStateSucceeded, RevokeChatInviteLinkInput, SafeAreaInset, SavePreparedInlineMessageInput, ScanQrPopupParams, SecureStorage, SendAnimationInput, SendAudioInput, SendChatActionInput, SendChecklistInput, SendContactInput, SendDiceInput, SendDocumentInput, SendGameInput, SendGiftInput, SendInvoiceInput, SendLocationInput, SendMediaGroupInput, SendMessageDraftInput, SendMessageInput, SendPaidMediaInput, SendPhotoInput, SendPollInput, SendStickerInput, SendVenueInput, SendVideoInput, SendVideoNoteInput, SendVoiceInput, SentWebAppMessage, SetBusinessAccountBioInput, SetBusinessAccountGiftSettingsInput, SetBusinessAccountNameInput, SetBusinessAccountProfilePhotoInput, SetBusinessAccountUsernameInput, SetChatAdministratorCustomTitleInput, SetChatDescriptionInput, SetChatMenuButtonInput, SetChatPermissionsInput, SetChatPhotoInput, SetChatStickerSetInput, SetChatTitleInput, SetCustomEmojiStickerSetThumbnailInput, SetGameScoreInput, SetMessageReactionInput, SetMyCommandsInput, SetMyDefaultAdministratorRightsInput, SetMyDescriptionInput, SetMyNameInput, SetMyShortDescriptionInput, SetPassportDataErrorsInput, SetStickerEmojiListInput, SetStickerKeywordsInput, SetStickerMaskPositionInput, SetStickerPositionInSetInput, SetStickerSetThumbnailInput, SetStickerSetTitleInput, SetUserEmojiStatusInput, SetWebhookInput, SettingsButton, SharedUser, ShippingAddress, ShippingOption, ShippingQuery, StarAmount, StarTransaction, StarTransactions, Sticker, StickerSet, StopMessageLiveLocationInput, StopPollInput, Story, StoryArea, StoryAreaPosition, StoryAreaType, StoryAreaTypeLink, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeUniqueGift, StoryAreaTypeWeather, StoryShareParams, StoryWidgetLink, SuccessfulPayment, SuggestedPostApprovalFailed, SuggestedPostApproved, SuggestedPostDeclined, SuggestedPostInfo, SuggestedPostPaid, SuggestedPostParameters, SuggestedPostPrice, SuggestedPostRefunded, SwitchInlineQueryChosenChat, TextQuote, ThemeParams, TransactionPartner, TransactionPartnerAffiliateProgram, TransactionPartnerChat, TransactionPartnerFragment, TransactionPartnerOther, TransactionPartnerTelegramAds, TransactionPartnerTelegramApi, TransactionPartnerUser, TransferBusinessAccountStarsInput, TransferGiftInput, UnbanChatMemberInput, UnbanChatSenderChatInput, UnhideGeneralForumTopicInput, UniqueGift, UniqueGiftBackdrop, UniqueGiftBackdropColors, UniqueGiftColors, UniqueGiftInfo, UniqueGiftModel, UniqueGiftSymbol, UnpinAllChatMessagesInput, UnpinAllForumTopicMessagesInput, UnpinAllGeneralForumTopicMessagesInput, UnpinChatMessageInput, Update, UpgradeGiftInput, UploadStickerFileInput, User, UserChatBoosts, UserProfilePhotos, UserRating, UsersShared, Venue, VerifyChatInput, VerifyUserInput, Video, VideoChatEnded, VideoChatParticipantsInvited, VideoChatScheduled, VideoChatStarted, VideoNote, Voice, WebApp, WebAppChat, WebAppData, WebAppInfo, WebAppInitData, WebAppUser, WebhookInfo, WriteAccessAllowed };
+export type { Accelerometer, AccelerometerStartParams, AcceptedGiftTypes, AddStickerToSetInput, AffiliateInfo, AllowedUpdateName, Animation, AnswerCallbackQueryInput, AnswerInlineQueryInput, AnswerPreCheckoutQueryInput, AnswerShippingQueryInput, AnswerWebAppQueryInput, Api, ApproveChatJoinRequestInput, ApproveSuggestedPostInput, Audio, BackButton, BackgroundFill, BackgroundFillFreeformGradient, BackgroundFillGradient, BackgroundFillSolid, BackgroundType, BackgroundTypeChatTheme, BackgroundTypeFill, BackgroundTypePattern, BackgroundTypeWallpaper, BanChatMemberInput, BanChatSenderChatInput, BindOrUnbindEventHandler, BiometricAuthenticateParams, BiometricManager, BiometricRequestAccessParams, Birthdate, BotCommand, BotCommandScope, BotCommandScopeAllChatAdministrators, BotCommandScopeAllGroupChats, BotCommandScopeAllPrivateChats, BotCommandScopeChat, BotCommandScopeChatAdministrators, BotCommandScopeChatMember, BotCommandScopeDefault, BotDescription, BotName, BotShortDescription, BottomButton, BusinessBotRights, BusinessConnection, BusinessIntro, BusinessLocation, BusinessMessagesDeleted, BusinessOpeningHours, BusinessOpeningHoursInterval, CallbackGame, CallbackQuery, Chat, ChatAdministratorRights, ChatBackground, ChatBoost, ChatBoostAdded, ChatBoostRemoved, ChatBoostSource, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway, ChatBoostSourcePremium, ChatBoostUpdated, ChatFullInfo, ChatInviteLink, ChatJoinRequest, ChatLocation, ChatMember, ChatMemberAdministrator, ChatMemberBanned, ChatMemberLeft, ChatMemberMember, ChatMemberOwner, ChatMemberRestricted, ChatMemberUpdated, ChatOwnerChanged, ChatOwnerLeft, ChatPermissions, ChatPhoto, ChatShared, Checklist, ChecklistTask, ChecklistTasksAdded, ChecklistTasksDone, ChosenInlineResult, CloseForumTopicInput, CloseGeneralForumTopicInput, CloseInput, CloudStorage, Contact, ContentSafeAreaInset, ConvertGiftToStarsInput, CopyMessageInput, CopyMessagesInput, CopyTextButton, CreateChatInviteLinkInput, CreateChatSubscriptionInviteLinkInput, CreateForumTopicInput, CreateInvoiceLinkInput, CreateNewStickerSetInput, DeclineChatJoinRequestInput, DeclineSuggestedPostInput, DeleteBusinessMessagesInput, DeleteChatPhotoInput, DeleteChatStickerSetInput, DeleteForumTopicInput, DeleteMessageInput, DeleteMessagesInput, DeleteMyCommandsInput, DeleteStickerFromSetInput, DeleteStickerSetInput, DeleteStoryInput, DeleteWebhookInput, DeviceOrientation, DeviceOrientationStartParams, DeviceStorage, Dice, DirectMessagePriceChanged, DirectMessagesTopic, Document, DownloadFileParams, EditChatInviteLinkInput, EditChatSubscriptionInviteLinkInput, EditForumTopicInput, EditGeneralForumTopicInput, EditMessageCaptionInput, EditMessageChecklistInput, EditMessageLiveLocationInput, EditMessageMediaInput, EditMessageReplyMarkupInput, EditMessageTextInput, EditStoryInput, EditUserStarSubscriptionInput, EmojiStatusParams, EncryptedCredentials, EncryptedPassportElement, EventHandlers, ExportChatInviteLinkInput, ExternalReplyInfo, File, ForceReply, ForumTopic, ForumTopicClosed, ForumTopicCreated, ForumTopicEdited, ForumTopicReopened, ForwardMessageInput, ForwardMessagesInput, Game, GameHighScore, GeneralForumTopicHidden, GeneralForumTopicUnhidden, GetAvailableGiftsInput, GetBusinessAccountGiftsInput, GetBusinessAccountStarBalanceInput, GetBusinessConnectionInput, GetChatAdministratorsInput, GetChatGiftsInput, GetChatInput, GetChatMemberCountInput, GetChatMemberInput, GetChatMenuButtonInput, GetCustomEmojiStickersInput, GetFileInput, GetForumTopicIconStickersInput, GetGameHighScoresInput, GetMeInput, GetMyCommandsInput, GetMyDefaultAdministratorRightsInput, GetMyDescriptionInput, GetMyNameInput, GetMyShortDescriptionInput, GetMyStarBalanceInput, GetStarTransactionsInput, GetStickerSetInput, GetUpdatesInput, GetUserChatBoostsInput, GetUserGiftsInput, GetUserProfileAudiosInput, GetUserProfilePhotosInput, GetWebhookInfoInput, Gift, GiftBackground, GiftInfo, GiftPremiumSubscriptionInput, Gifts, Giveaway, GiveawayCompleted, GiveawayCreated, GiveawayWinners, Gyroscope, GyroscopeStartParams, HapticFeedback, HideGeneralForumTopicInput, InaccessibleMessage, InlineKeyboardButton, InlineKeyboardMarkup, InlineQuery, InlineQueryResult, InlineQueryResultArticle, InlineQueryResultAudio, InlineQueryResultCachedAudio, InlineQueryResultCachedDocument, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedPhoto, InlineQueryResultCachedSticker, InlineQueryResultCachedVideo, InlineQueryResultCachedVoice, InlineQueryResultContact, InlineQueryResultDocument, InlineQueryResultGame, InlineQueryResultGif, InlineQueryResultLocation, InlineQueryResultMpeg4Gif, InlineQueryResultPhoto, InlineQueryResultVenue, InlineQueryResultVideo, InlineQueryResultVoice, InlineQueryResultsButton, InputChecklist, InputChecklistTask, InputContactMessageContent, InputFile, InputInvoiceMessageContent, InputLocationMessageContent, InputMedia, InputMediaAnimation, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, InputMessageContent, InputPaidMedia, InputPaidMediaPhoto, InputPaidMediaVideo, InputPollOption, InputProfilePhoto, InputProfilePhotoAnimated, InputProfilePhotoStatic, InputSticker, InputStoryContent, InputStoryContentPhoto, InputStoryContentVideo, InputTextMessageContent, InputVenueMessageContent, Invoice, KeyboardButton, KeyboardButtonPollType, KeyboardButtonRequestChat, KeyboardButtonRequestUsers, LabeledPrice, LeaveChatInput, LinkPreviewOptions, Location, LocationAddress, LocationData, LocationManager, LogOutInput, LoginUrl, MaskPosition, MaybeInaccessibleMessage, MenuButton, MenuButtonCommands, MenuButtonDefault, MenuButtonWebApp, Message, MessageAutoDeleteTimerChanged, MessageEntity, MessageId, MessageOrigin, MessageOriginChannel, MessageOriginChat, MessageOriginHiddenUser, MessageOriginUser, MessageReactionCountUpdated, MessageReactionUpdated, OrderInfo, OwnedGift, OwnedGiftRegular, OwnedGiftUnique, OwnedGifts, PaidMedia, PaidMediaInfo, PaidMediaPhoto, PaidMediaPreview, PaidMediaPurchased, PaidMediaVideo, PaidMessagePriceChanged, PassportData, PassportElementError, PassportElementErrorDataField, PassportElementErrorFile, PassportElementErrorFiles, PassportElementErrorFrontSide, PassportElementErrorReverseSide, PassportElementErrorSelfie, PassportElementErrorTranslationFile, PassportElementErrorTranslationFiles, PassportElementErrorUnspecified, PassportFile, PhotoSize, PinChatMessageInput, Poll, PollAnswer, PollOption, PopupButton, PopupParams, PostStoryInput, PreCheckoutQuery, PreparedInlineMessage, PromoteChatMemberInput, ProximityAlertTriggered, ReactionCount, ReactionType, ReactionTypeCustomEmoji, ReactionTypeEmoji, ReactionTypePaid, ReadBusinessMessageInput, RefundStarPaymentInput, RefundedPayment, RemoveBusinessAccountProfilePhotoInput, RemoveChatVerificationInput, RemoveMyProfilePhotoInput, RemoveUserVerificationInput, ReopenForumTopicInput, ReopenGeneralForumTopicInput, ReplaceStickerInSetInput, ReplyKeyboardMarkup, ReplyKeyboardRemove, ReplyParameters, RepostStoryInput, ResponseParameters, RestrictChatMemberInput, RevenueWithdrawalState, RevenueWithdrawalStateFailed, RevenueWithdrawalStatePending, RevenueWithdrawalStateSucceeded, RevokeChatInviteLinkInput, SafeAreaInset, SavePreparedInlineMessageInput, ScanQrPopupParams, SecureStorage, SendAnimationInput, SendAudioInput, SendChatActionInput, SendChecklistInput, SendContactInput, SendDiceInput, SendDocumentInput, SendGameInput, SendGiftInput, SendInvoiceInput, SendLocationInput, SendMediaGroupInput, SendMessageDraftInput, SendMessageInput, SendPaidMediaInput, SendPhotoInput, SendPollInput, SendStickerInput, SendVenueInput, SendVideoInput, SendVideoNoteInput, SendVoiceInput, SentWebAppMessage, SetBusinessAccountBioInput, SetBusinessAccountGiftSettingsInput, SetBusinessAccountNameInput, SetBusinessAccountProfilePhotoInput, SetBusinessAccountUsernameInput, SetChatAdministratorCustomTitleInput, SetChatDescriptionInput, SetChatMenuButtonInput, SetChatPermissionsInput, SetChatPhotoInput, SetChatStickerSetInput, SetChatTitleInput, SetCustomEmojiStickerSetThumbnailInput, SetGameScoreInput, SetMessageReactionInput, SetMyCommandsInput, SetMyDefaultAdministratorRightsInput, SetMyDescriptionInput, SetMyNameInput, SetMyProfilePhotoInput, SetMyShortDescriptionInput, SetPassportDataErrorsInput, SetStickerEmojiListInput, SetStickerKeywordsInput, SetStickerMaskPositionInput, SetStickerPositionInSetInput, SetStickerSetThumbnailInput, SetStickerSetTitleInput, SetUserEmojiStatusInput, SetWebhookInput, SettingsButton, SharedUser, ShippingAddress, ShippingOption, ShippingQuery, StarAmount, StarTransaction, StarTransactions, Sticker, StickerSet, StopMessageLiveLocationInput, StopPollInput, Story, StoryArea, StoryAreaPosition, StoryAreaType, StoryAreaTypeLink, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeUniqueGift, StoryAreaTypeWeather, StoryShareParams, StoryWidgetLink, SuccessfulPayment, SuggestedPostApprovalFailed, SuggestedPostApproved, SuggestedPostDeclined, SuggestedPostInfo, SuggestedPostPaid, SuggestedPostParameters, SuggestedPostPrice, SuggestedPostRefunded, SwitchInlineQueryChosenChat, TextQuote, ThemeParams, TransactionPartner, TransactionPartnerAffiliateProgram, TransactionPartnerChat, TransactionPartnerFragment, TransactionPartnerOther, TransactionPartnerTelegramAds, TransactionPartnerTelegramApi, TransactionPartnerUser, TransferBusinessAccountStarsInput, TransferGiftInput, UnbanChatMemberInput, UnbanChatSenderChatInput, UnhideGeneralForumTopicInput, UniqueGift, UniqueGiftBackdrop, UniqueGiftBackdropColors, UniqueGiftColors, UniqueGiftInfo, UniqueGiftModel, UniqueGiftSymbol, UnpinAllChatMessagesInput, UnpinAllForumTopicMessagesInput, UnpinAllGeneralForumTopicMessagesInput, UnpinChatMessageInput, Update, UpgradeGiftInput, UploadStickerFileInput, User, UserChatBoosts, UserProfileAudios, UserProfilePhotos, UserRating, UsersShared, Venue, VerifyChatInput, VerifyUserInput, Video, VideoChatEnded, VideoChatParticipantsInvited, VideoChatScheduled, VideoChatStarted, VideoNote, VideoQuality, Voice, WebApp, WebAppChat, WebAppData, WebAppInfo, WebAppInitData, WebAppUser, WebhookInfo, WriteAccessAllowed };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-ak/tg-bot-api",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "type": "module",
   "description": "TypeScript types for Telegram Bot Api and Telegram Mini Apps",
   "license": "MIT",
@@ -15,7 +15,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/effect-ak/tg-bot-client",
+    "url": "https://github.com/kondaurovDev/tg-bot-client",
     "directory": "packages/api"
   },
   "bugs": {
@@ -38,8 +38,16 @@
     "dist/*.cjs",
     "dist/*.d.ts"
   ],
+  "devDependencies": {
+    "node-html-parser": "^7.0.1",
+    "ts-morph": "^27.0.2"
+  },
   "scripts": {
     "build": "tsup",
-    "typecheck": "tsc"
+    "typecheck": "tsc",
+    "gen": "pnpm run gen:bot:api && pnpm run gen:webapp:api",
+    "gen:bot:api": "MODULE_NAME=bot_api tsx ./codegen/main.ts",
+    "gen:webapp:api": "MODULE_NAME=webapp tsx ./codegen/main.ts",
+    "test": "vitest run"
   }
 }

package/readme.md

@@ -1,17 +1,16 @@
-![Telegram Bot API](https://img.shields.io/badge/BotApi-9.2-blue?link=)
+[![NPM Version](https://img.shields.io/npm/v/%40effect-ak%2Ftg-bot-api)](https://www.npmjs.com/package/@effect-ak/tg-bot-api)
+![Telegram Bot API](https://img.shields.io/badge/BotApi-9.4-blue?link=)
 ![Telegram WebApp](https://img.shields.io/badge/Telegram.WebApp-9.1-blue?link=)
-[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-blue.svg)](https://effect-ak.github.io/telegram-bot-api/)
 
 ## Highlights:
 
 - **Complete and Up-to-Date Telegram Bot API**: The entire API is generated from [the official documentation](https://core.telegram.org/bots/api) using a [code generator](./codegen/main.ts), ensuring this client remains in sync and supports every method and type provided by the **Telegram Bot API**.
 - **[Types for Webapps](#webapps-typings)** Types that describe `Telegram.WebApp`. Created by [code generator](./codegen/main.ts) as well.
-- **[ChatBot runner](#chatbot-runner)**: Focus on the logic of your chat bot
 - **Type Mapping**: Types from the documentation are converted to TypeScript types:
   - `Integer` → `number`
   - `True` → `boolean`
   - `String or Number` → `string | number`
-  - Enumerated types, such as `"Type of the chat can be either “private”, “group”, “supergroup” or “channel”"`, are converted to a standard union of literal types `"private" | "group" | "supergroup" | "channel"`
+  - Enumerated types, such as `"Type of the chat can be either "private", "group", "supergroup" or "channel""`, are converted to a standard union of literal types `"private" | "group" | "supergroup" | "channel"`
   - And more...
 
 ## Webapps typings
@@ -35,3 +34,260 @@ const saveData = () => {
   })
 }
 ```
+
+## Code generation
+
+Scrapes the official Telegram documentation HTML and generates:
+
+- **TypeScript types** for Bot API and Mini Apps (`src/specification/`)
+- **Markdown docs** with method/type reference pages (`docs/`)
+
+### Pipeline
+
+```
+core.telegram.org/bots/api          core.telegram.org/bots/webapps
+            |                                    |
+       fetch & cache                        fetch & cache
+       (input/api.html)                     (input/webapp.html)
+            |                                    |
+            v                                    v
+        DocPage                             WebAppPage
+            |                                    |
+     ┌──────┴──────┐                             |
+     v             v                             v
+ ExtractedType  ExtractedMethod           ExtractedWebApp
+     |             |                       |          |
+     v             v                       v          v
+  types.ts      api.ts                 webapp.ts   (types)
+     |             |
+     └──────┬──────┘
+            v
+     docs/ (markdown)
+```
+
+1. **Fetch** — `PageProviderService` downloads HTML from `core.telegram.org` and caches it locally in `input/`.
+
+2. **Parse** — `DocPage` / `WebAppPage` parse the HTML into a DOM tree (`node-html-parser`). Each entity is located by its `<a class="anchor">` tag.
+
+3. **Extract entities** — for every `<h4>` heading on the page the extraction pipeline deterministically converts HTML into typed structures. See [Extraction semantics](#extraction-semantics) below for the full details.
+
+4. **Generate TypeScript** — `BotApiCodeWriterService` and `WebAppCodeWriterService` use `ts-morph` to emit `.ts` files with interfaces, type aliases, and method signatures.
+
+5. **Generate Markdown** — `MarkdownWriterService` converts the same extracted data into browsable `.md` files with cross-linked types.
+
+### Usage
+
+```bash
+# generate everything (Bot API types + docs + Mini Apps types)
+pnpm gen
+
+# or individually
+pnpm gen:bot:api
+pnpm gen:webapp:api
+```
+
+### Tests
+
+```bash
+pnpm test
+```
+
+Tests use cached HTML fixtures from `input/` — no network requests during test runs after the first download.
+
+## Extraction semantics
+
+The Telegram Bot API documentation page (`core.telegram.org/bots/api`) is a single long HTML page with a regular, predictable structure. Every type and method is defined as a sequence of sibling HTML elements under its heading. The codegen exploits this regularity to extract everything deterministically, without any heuristic guessing.
+
+### Page layout: H3 groups and H4 entities
+
+```
+<h3>Getting updates</h3>           ← group name (section header)
+  <h4><a class="anchor" name="getUpdates"/>getUpdates</h4>   ← entity
+    <p>...</p>                      ← description paragraph(s)
+    <table>...</table>              ← field definitions (or <ul> for union types)
+  <h4><a class="anchor" name="update"/>Update</h4>
+    <p>...</p>
+    <table>...</table>
+```
+
+The batch extractor (`entities.ts`) walks all `<h3>` and `<h4>` nodes in document order:
+- **`<h3>`** sets the current section group (e.g. "Getting updates", "Available types").
+- **`<h4>`** is an individual entity — a type or a method.
+
+### Locating a single entity
+
+Every `<h4>` heading contains an `<a class="anchor" name="...">` child. This gives a stable, lowercase slug for the entity (e.g. `name="sendmessage"`). To look up a specific entity, `DocPage.getEntity()` does:
+
+```ts
+this.node.querySelector(`a.anchor[name="${name.toLowerCase()}"]`)
+```
+
+then extracts from the anchor's parent `<h4>` node.
+
+### Type vs Method — first character case
+
+There is no HTML attribute that distinguishes a type from a method. Instead, Telegram consistently uses:
+
+- **Uppercase first letter** → Type definition (e.g. `User`, `Chat`, `Message`)
+- **Lowercase first letter** → API method (e.g. `sendMessage`, `getUpdates`, `setWebhook`)
+
+The `isComplexType` / `startsWithUpperCase` helper makes this check. It is the single decision point: uppercase entities are extracted as `ExtractedType`, lowercase as `ExtractedMethod`.
+
+### Entity structure: walking siblings from H4
+
+Starting from the `<h4>` node, the extractor walks `nextElementSibling` to collect:
+
+1. **`<p>` paragraphs** — entity description, and (for methods) the return type sentence.
+2. **`<table>`** — field/parameter definitions → produces `EntityFields` (an object type with named properties).
+3. **`<ul>`** — union type members → produces `NormalType` (a union `A | B | C`).
+
+The walk stops when it hits another `<h4>` (next entity), a `<table>`, or a `<ul>`. A safety limit of 10 sibling steps prevents runaway walks on malformed HTML.
+
+### Description and return type extraction
+
+Description `<p>` paragraphs are split on `. ` (period + space) or `.<br>` into individual sentences. Each sentence is stripped of HTML tags to get plain text.
+
+For **methods**, return type sentences are identified by three patterns:
+
+| Pattern | Example |
+|---------|---------|
+| Starts with `"On success"` | "On success, a Message object is returned" |
+| Starts with `"Returns "` | "Returns an Array of Update objects" |
+| Ends with `"is returned"` | "The sent Message is returned" |
+
+Type names are extracted from `<a>` and `<em>` tags inside these sentences using the regex `/\w+(?=<\/(a\|em)>)/g` — this matches the word just before a closing `</a>` or `</em>` tag. Only uppercase-initial names pass (primitives like "true" are skipped).
+
+Array return types are detected by checking for `"an array of <TypeName>"` (case-insensitive) in the plain text.
+
+### Table parsing: 3-column vs 4-column
+
+Telegram uses two table layouts:
+
+**4-column tables** (method parameters):
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| chat_id | Integer or String | Yes | Unique identifier... |
+| text | String | Yes | Text of the message... |
+| parse_mode | String | Optional | Mode for parsing... |
+
+Columns: `name` (0), `type` (1), `required` (2), `description` (3).
+Column 2 is either `"Yes"` or `"Optional"`.
+
+**3-column tables** (type fields):
+
+| Field | Type | Description |
+|-------|------|-------------|
+| message_id | Integer | Unique message identifier... |
+| from | User | Optional. Sender of the message... |
+
+Columns: `name` (0), `type` (1), `description` (2).
+There is no explicit "Required" column — instead, optional fields have their description start with `"Optional."`. The extractor checks:
+
+```ts
+if (all.length == 3) {
+  const isOptional = description[0].includes("Optional")
+  required = !isOptional
+}
+```
+
+Required fields are sorted before optional ones in the output.
+
+### Union types from `<ul>` lists
+
+Some types are defined not by a table but by a bulleted list:
+
+```html
+<h4>ChatMemberStatus</h4>
+<p>This object represents ...</p>
+<ul>
+  <li>ChatMemberOwner</li>
+  <li>ChatMemberAdministrator</li>
+  <li>ChatMemberMember</li>
+  ...
+</ul>
+```
+
+Each `<li>` text becomes one arm of the TypeScript union:
+
+```ts
+type ChatMemberStatus = ChatMemberOwner | ChatMemberAdministrator | ChatMemberMember | ...
+```
+
+### Pseudo-type mapping
+
+Telegram uses its own type names (pseudo-types). The mapping is straightforward:
+
+| Telegram pseudo-type | TypeScript |
+|---------------------|------------|
+| `String` | `string` |
+| `Integer`, `Int` | `number` |
+| `Float` | `number` |
+| `Boolean`, `True`, `False` | `boolean` |
+| `Array of X` | `X[]` |
+| `X or Y` | `X \| Y` |
+| `InputFile` | `{ file_content: Uint8Array, file_name: string }` |
+
+Nested arrays (`Array of Array of PhotoSize`) are handled by counting `Array of` occurrences and appending the matching number of `[]` brackets.
+
+### Enum extraction from descriptions
+
+Some `String` fields actually represent a finite set of values. The descriptions contain natural-language hints:
+
+> Type of the emoji, currently one of "dice", "darts", "bowling", "basketball", "football", "slot_machine"
+
+The extractor looks for **indicator keywords**: `"must be"`, `"always"`, `"one of"`, `"can be"`. When found, it extracts quoted values using a regex that handles both straight quotes (`"`) and Unicode curly quotes (`\u201C`/`\u201D`), which appear in different parts of the Telegram docs.
+
+These are emitted as string literal unions:
+
+```ts
+emoji: "dice" | "darts" | "bowling" | "basketball" | "football" | "slot_machine"
+```
+
+The `parse_mode` field is a special case — it is always overridden to `"HTML" | "MarkdownV2"` regardless of the description text.
+
+### The `Function` pseudo-type (Mini Apps)
+
+The Mini Apps documentation uses `Function` as a pseudo-type for callable fields. When the table says:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| sendData() | Function | ... |
+| isVersionAtLeast() | Function | ... |
+
+The extractor detects `pseudoType == "Function"` and converts:
+- Fields ending with `()` → function signatures (return type derived from the entity name)
+- The field name is trimmed to remove the `()` suffix
+
+Since the documentation doesn't specify parameter types for these functions, most webapp methods have **manual type overrides** in `typeOverrides` (see `type-system.ts`).
+
+### Manual overrides
+
+Some types cannot be inferred from the HTML structure alone. Three override mechanisms handle these:
+
+1. **`typeOverrides`** — per-entity, per-field type replacements. Used extensively for Mini Apps methods (callbacks, complex parameter types) and a few Bot API fields like `allowed_updates` and `sendChatAction.action`.
+
+2. **`typeAliasOverrides`** — for types that have no `<table>` or `<ul>` (e.g. `InputFile`). When `findTypeNode` hits the next `<h4>` without finding a type definition, the override provides the TypeScript type.
+
+3. **`returnTypeOverrides`** — for methods whose return type sentence is ambiguous or missing (e.g. `sendMediaGroup` returns `Message[]`).
+
+## Module map
+
+```
+codegen/
+├── main.ts              entry point, reads MODULE_NAME env var
+├── runtime.ts           Effect runtimes (DI wiring)
+├── types.ts             shared type aliases (HtmlElement, TsSourceFile)
+│
+├── scrape/
+│   ├── type-system.ts   type representation & conversion (NormalType, EntityFields)
+│   ├── entity.ts        single-entity extraction from HTML nodes
+│   ├── page.ts          DocPage & WebAppPage — HTML page models
+│   └── entities.ts      batch extraction — walks full page, collects all types & methods
+│
+└── service/
+    ├── index.ts          barrel re-exports
+    ├── page-provider.ts  fetches & caches documentation HTML
+    ├── code-writers.ts   ts-morph TypeScript code generation
+    └── markdown.ts       markdown docs generation
+```