ferogram 0.2.2__tar.gz → 0.2.3__tar.gz

ferogram-0.2.3/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+## 0.2.3 (2026-05-14)
+
+### Client Builder
+
+Added 20 new kwargs to `Client(...)` so you can configure everything at construction time instead of touching internals.
+
+Network options: `proxy` (SOCKS5 or MTProxy t.me link), `allow_ipv6`, `dc_addr`, `probe_transport`, `resilient_connect`.
+
+Session backend: `session_string` and `in_memory` as alternatives to the default session file. Priority is `in_memory > session_string > file`.
+
+Update handling: `catch_up`, `pfs`, `update_queue_capacity`, `update_overflow` (`"drop_oldest"` or `"drop_newest"`), `low_memory_mode`.
+
+InitConnection identity: `device`, `system_version`, `app_version`, `lang_code`, `system_lang_code`, `lang_pack`.
+
+Experimental: `allow_missing_channel_hash`, `auto_resolve_peers`.
+
+### Inline Bots
+
+`InlineArticle`, `InlinePhoto`, and `InlineDocument` now expose all their fields. Previously only the 3 required fields worked. New fields: `description`, `url`, `thumb_url`, `reply_markup` on articles; `photo_url`, `photo_width`, `photo_height`, `thumb_url`, `mime_type`, `reply_markup` on photos; `document_url`, `mime_type`, `description`, `thumb_url`, `reply_markup` on documents.
+
+`answer_inline_query` now accepts `next_offset` for pagination and `switch_pm` to show a "go to PM" button in the results list.
+
+`answer_inline_query_articles` is now accessible from Python. Takes a plain list of `(id, title, text)` tuples and supports `next_offset`.
+
+`edit_inline_message` now accepts `reply_markup` so you can attach or update a keyboard when editing.
+
+`InlineSend` now exposes `msg_id_bytes` and `msg_id_dc` so you can build an `InlineMessageId` from the send event and edit the message later.
+
+### Participants
+
+Ten new methods for managing group and channel members.
+
+`get_participants(peer, limit=200)` fetches all members as a list of `ChatMember`.
+
+`get_participants_filtered(peer, filter, limit)` fetches a filtered subset. Filter values: `"recent"`, `"admins"`, `"kicked"`, `"banned"`, `"bots"`.
+
+`kick_participant(peer, user)` removes a user from the chat. They can rejoin if the chat is public or they have an invite link.
+
+`ban_participant(peer, user)` permanently bans a user until an admin manually lifts it.
+
+`ban_participant_until(peer, user, until_date)` bans until a unix timestamp, after which the ban lifts automatically.
+
+`promote_participant(peer, user, rights)` promotes to admin with specific rights. Pass `rights=None` to grant all. Valid right strings: `"change_info"`, `"post_messages"`, `"edit_messages"`, `"delete_messages"`, `"ban_users"`, `"invite_users"`, `"pin_messages"`, `"add_admins"`, `"manage_call"`.
+
+`demote_participant(peer, user)` strips all admin rights, leaving the user as a regular member.
+
+`get_profile_photos(peer, limit=100)` returns a list of `(file_id, access_hash, dc_id)` tuples.
+
+`search_peer(query)` searches the local peer cache by name or username and returns a list of peer identifier strings.
+
+`signal_network_restored()` (sync, not async) tells the client network is back so it attempts reconnect immediately instead of waiting for the retry timer.
+
+### Reactions and Polls
+
+`delete_reaction(peer, msg_id, participant)` was in Rust but had no Python wrapper. Now exposed. Removes a specific user's reaction from a message, admin only.
+
+`get_poll_results(peer, msg_id, poll_hash)` was in Rust but had no Python wrapper. Now exposed. Fetches and caches the latest poll results from Telegram.
+
+---
+
+## 0.2.2
+
+Previous release.

{ferogram-0.2.2 → ferogram-0.2.3}/Cargo.lock

@@ -274,9 +274,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08d5a9e0d5162e8eb981904b15c41d7f3089640632d51a3ffcab7713c4df409b"
+checksum = "0b72cbc599397f85947c77d7807db9b40baa047598ef17fb7b3425adf980ce48"
 dependencies = [
  "async-trait",
  "base64",
@@ -314,9 +314,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-connect"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8cdc49607faad2862b676b010b02e27d13ba2047d2253362cdf958c10efff92a"
+checksum = "48614f5825a4e069d8daf80998d0bda2c02b7e92e6116c789054ceef82568fd1"
 dependencies = [
  "ferogram-crypto",
  "ferogram-mtproto",
@@ -334,9 +334,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-crypto"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d9df71920e40c6b6938df3ac0f4e85fe13968b48f0cbb0d0c06d98020384b02b"
+checksum = "7e27eef45ed7600e3b93442602f1acbc82c86cbbd8be33395c64962333f4a9fe"
 dependencies = [
  "aes",
  "ctr",
@@ -349,9 +349,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-fsm"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "751b3d201d60c38679fb363022bc65646144943b79bc17e37997d8738e2f5143"
+checksum = "b06529ae56dbc45a50f10709572fa127c5c2a58132f4b1eaa90c826e51ae40a6"
 dependencies = [
  "async-trait",
  "dashmap",
@@ -362,9 +362,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-mtproto"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4aa9b9d4bf5a80270e8ee81e65055c8ed7de9b4887df7d94de48d18564c692c"
+checksum = "f14d5196b3f81974f7f990c822475354af4dd46a0d49c2d648e492c6084105a5"
 dependencies = [
  "ferogram-crypto",
  "ferogram-tl-types",
@@ -377,9 +377,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-mtsender"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c577e17c573111afe208b935c0a91ab51ab4df4040366010b3b4418d1fbdfecc"
+checksum = "f884b7cf4ff1a380559b057f569d6d884ec74405fda6f97ba79265f42ab22b3b"
 dependencies = [
  "ferogram-connect",
  "ferogram-crypto",
@@ -397,9 +397,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-parsers"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2616847253ad2b3c90b18f18d8f9239275c295a378ed4cd24bddaec50df3550e"
+checksum = "699accf665ae781947b041f9400f1a388ede032feb0a84c97247f1e6a79e1d31"
 dependencies = [
  "ferogram-tl-types",
  "pulldown-cmark",
@@ -407,7 +407,7 @@ dependencies = [
 
 [[package]]
 name = "ferogram-py"
-version = "0.2.2"
+version = "0.2.3"
 dependencies = [
  "ferogram",
  "hex",
@@ -418,9 +418,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-session"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "de8ac1fbffd7bb698fe3d78038edae17544220d2cf41fe583304efa61a551e94"
+checksum = "672fed4cda1078020cdfe3b0a76408224ba4dc265b26093d02342777d68cfb5f"
 dependencies = [
  "base64",
  "tracing",
@@ -428,24 +428,24 @@ dependencies = [
 
 [[package]]
 name = "ferogram-tl-gen"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9278407f5912be09141fa7827e39dd72851213ecf4b7c1462094a1012ffdef9"
+checksum = "b2c5767cecedb0e1df8f7c53f4dc1bfe0a3b686eb89bf4da26fa2d610e04fe8e"
 dependencies = [
  "ferogram-tl-parser",
 ]
 
 [[package]]
 name = "ferogram-tl-parser"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a2a592a2437f71ddda9ba45971bb70019c16a4cf5dd9afe941a7125232db1ff8"
+checksum = "9b655e882facfe8fb8326b4c63ac511089ce89f38c6b208111004256e2888483"
 
 [[package]]
 name = "ferogram-tl-types"
-version = "0.4.0"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1b23759e460988fda70e73ed25ae4bf633e3430c60f8fbe4620198536238bd7"
+checksum = "ed947864a8bdea862a8336a691d957f2ab8dfd8d08063a90d77d0b70f753705f"
 dependencies = [
  "ferogram-tl-gen",
  "ferogram-tl-parser",

{ferogram-0.2.2 → ferogram-0.2.3}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name        = "ferogram-py"
-version     = "0.2.2"
+version     = "0.2.3"
 edition     = "2024"
 description = "Python bindings for ferogram (Rust MTProto)"
 license     = "MIT OR Apache-2.0"
@@ -12,7 +12,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 hex                 = "0.4"
-ferogram            = "0.4.0"
+ferogram            = "0.4.1"
 pyo3                = { version = "0.24", features = ["extension-module", "abi3-py313"] }
 pyo3-async-runtimes = { version = "0.24", features = ["tokio-runtime"] }
 tokio               = { version = "1", features = ["full"] }

{ferogram-0.2.2 → ferogram-0.2.3}/FEATURES.md

@@ -2,7 +2,7 @@
 
 Python bindings for the ferogram MTProto client.
 
-All client methods are async. The `peer` parameter accepts "@username", "me", or a numeric ID (int or string).
+All client methods are async. The `peer` parameter accepts `"@username"`, `"me"`, or a numeric ID (int or string).
 
 
 ## Imports
@@ -16,9 +16,12 @@ from ferogram import ChatAction
 from ferogram import InlineArticle, InlinePhoto, InlineDocument
 from ferogram import InlineMessageId
 from ferogram import PrivacyKey, PrivacyRule
+from ferogram import InlineButton, InlineKeyboard
+from ferogram import ReplyButton, ReplyKeyboard
+from ferogram import RemoveKeyboard, ForceReply
 ```
 
-Raw API usage (four styles, see the [Raw API](https://github.com/ankit-chaubey/ferogram-py/edit/main/FEATURES.md#raw-api) section for details):
+Raw API usage (four styles, see the [Raw API](#raw-api) section for details):
 
 ```python
 # style 1: namespace proxy, no extra import needed
@@ -59,6 +62,55 @@ async with app as client:
 
 Credentials can also come from env vars: `API_ID`, `API_HASH`, `BOT_TOKEN`.
 
+### Full init signature
+
+These are all the kwargs you can pass to `Client(...)`. Most of them you will never need, but they are all there.
+
+```python
+app = Client(
+    session="mybot",                     # session file name (no .session extension)
+    api_id=123456,
+    api_hash="abc...",
+    bot_token="123:TOKEN",               # omit for userbot
+    phone="+1234567890",                 # for userbot interactive login
+    password="2fa_password",             # 2FA password if set
+
+    # Network
+    proxy=None,                          # "socks5://host:port" or an MTProxy t.me link
+    allow_ipv6=False,                    # connect over IPv6 when available
+    dc_addr=None,                        # override DC address, e.g. "149.154.167.51:443"
+    probe_transport=False,               # try multiple transports on first connect
+    resilient_connect=False,             # keep retrying on initial connect failure
+
+    # Session backend (priority: in_memory > session_string > session file)
+    session_string=None,                 # base64 session string instead of file
+    in_memory=False,                     # ephemeral session, nothing written to disk
+
+    # Sync and updates
+    catch_up=False,                      # fetch missed updates on reconnect
+    pfs=False,                           # Perfect Forward Secrecy for the session
+    update_queue_capacity=None,          # max pending updates before overflow kicks in
+    update_overflow=None,                # "drop_oldest" or "drop_newest"
+    low_memory_mode=False,               # smaller update queue, saves RAM on constrained devices
+
+    # InitConnection identity
+    device=None,                         # device model string sent in InitConnection
+    system_version=None,                 # OS version string
+    app_version=None,                    # app version string
+    lang_code=None,                      # IETF language tag, e.g. "en"
+    system_lang_code=None,               # system locale tag
+    lang_pack=None,                      # language pack name
+
+    # Experimental
+    allow_missing_channel_hash=False,    # skip access hash requirement for channels
+    auto_resolve_peers=False,            # resolve unknown peers automatically
+)
+```
+
+`proxy` supports two formats:
+- SOCKS5: `"socks5://host:port"`
+- MTProxy: `"https://t.me/proxy?server=...&port=...&secret=..."`
+
 
 ## Event Handlers
 
@@ -90,8 +142,8 @@ Handler signature: `async def handler(client, update):`
 
 ## Filters
 
-Import: 
-```
+Import:
+```python
 from ferogram import filters
 ```
 
@@ -185,9 +237,11 @@ filters.not_(f1)
 ## Messaging
 
 ```python
-await client.send_message(peer, text, parse_mode=None)
+await client.send_message(peer, text, parse_mode=None, reply_markup=None)
 # parse_mode: None (plain) | "html" | "markdown"
-# Note: "markdown" uses MarkdownV2 format since ferogram 0.3.9.
+# reply_markup: InlineKeyboard, ReplyKeyboard, RemoveKeyboard, or ForceReply
+#
+# "markdown" uses MarkdownV2 format since ferogram 0.3.9.
 #   __text__ = Underline (was Italic in V1)
 #   ~text~   = Strike    (was ~~text~~ in V1)
 #   > text   = Blockquote (new)
@@ -208,6 +262,7 @@ await client.pin_message(peer, message_id)
 await client.unpin_message(peer, message_id)
 await client.unpin_all_messages(peer)
 await client.get_messages_by_id(peer, [id1, id2])
+await client.get_message(peer, msg_id)                  # -> Message | None (single fetch)
 await client.get_message_history(peer, limit=100, offset_id=0)
 await client.get_pinned_message(peer)                   # -> Message | None
 await client.get_reply_to_message(peer, msg_id)         # -> Message | None
@@ -217,12 +272,14 @@ await client.send_reaction(peer, message_id, emoji)
 await client.read_reactions(peer)
 await client.clear_recent_reactions()
 await client.get_reaction_list(peer, msg_id, limit=100) # -> [(peer_id, emoji)]
-await client.delete_reaction(peer, msg_id, participant) # report/remove a user's reaction
+await client.delete_reaction(peer, msg_id, participant) # remove a specific user's reaction (admin only)
+async for reaction in client.iter_reaction_users(peer, msg_id, reaction=None):
+    ...                                                 # yields reaction objects
 await client.mark_as_read(peer)
 await client.clear_mentions(peer)
 await client.send_chat_action(peer, "typing")           # or ChatAction.TYPING
 await client.send_dice(peer, emoticon="🎲")
-await client.translate_messages(peer, [msg_id], to_lang="en")
+await client.translate_messages(peer, [msg_id], to_lang="en")   # -> [str]
 await client.get_web_page_preview(text)                 # -> url | None
 ```
 
@@ -245,6 +302,55 @@ await message.react(emoji)
 `is_forwarded`, `post_author`, `view_count`, `reply_count`
 
 
+## Keyboards
+
+Build and attach keyboards to messages.
+
+```python
+from ferogram import InlineButton, InlineKeyboard
+from ferogram import ReplyButton, ReplyKeyboard
+from ferogram import RemoveKeyboard, ForceReply
+```
+
+**Inline keyboard**
+
+```python
+kb = InlineKeyboard([
+    [InlineButton("Click me", data="btn1"), InlineButton("Other", data="btn2")],
+    [InlineButton("Open URL", url="https://example.com")],
+])
+
+await client.send_message(peer, "Pick one:", reply_markup=kb)
+```
+
+`InlineButton` takes `text` (required) and one of `data`, `url`, `switch_inline_query`, or `switch_inline_query_current_chat`.
+
+**Reply keyboard**
+
+```python
+kb = ReplyKeyboard([
+    [ReplyButton("Option A"), ReplyButton("Option B")],
+    [ReplyButton("Cancel")],
+], resize=True, one_time=True)
+
+await client.send_message(peer, "Choose:", reply_markup=kb)
+```
+
+**Remove keyboard**
+
+```python
+await client.send_message(peer, "Done.", reply_markup=RemoveKeyboard())
+```
+
+**Force reply**
+
+```python
+await client.send_message(peer, "Reply to this:", reply_markup=ForceReply())
+```
+
+`reply_markup` works on `send_message`, `send_photo`, `send_document`, `send_file`, and `edit_message`.
+
+
 ## Media
 
 ```python
@@ -276,29 +382,178 @@ await client.send_poll(
 )
 await client.send_vote(peer, msg_id, options=[b"\x00"])
 await client.get_poll_votes(peer, msg_id, limit=100)    # -> [(user_id, option_bytes)]
-await client.get_poll_results(peer, msg_id, poll_hash)
-await client.get_poll_stats(peer, msg_id)               # -> views count (int)
-await client.delete_reaction(peer, msg_id, participant) # report/remove a user's reaction
+await client.get_poll_results(peer, msg_id, poll_hash)  # fetch and cache latest results
+await client.get_poll_stats(peer, msg_id)               # -> int (interaction count)
 ```
 
 
 ## Inline Bots
 
+### Answering callback queries
+
 ```python
 await client.answer_callback_query(query_id, text=None, alert=False)
+```
+
+### Answering inline queries
 
+Use `InlineArticle`, `InlinePhoto`, or `InlineDocument` to build results and pass them to `answer_inline_query`.
+
+```python
 from ferogram import InlineArticle, InlinePhoto, InlineDocument
 
-await client.answer_inline_query(query_id, [
-    InlineArticle(id="1", title="Title", message_text="Hello!"),
-    InlinePhoto(id="2", title="Cat", message_text="🐱", thumb_url="..."),
-    InlineDocument(id="3", title="File", message_text="...", url="...", mime_type="application/pdf"),
-], cache_time=300, is_personal=False, next_offset=None)
+await client.answer_inline_query(
+    query_id,
+    results=[...],
+    cache_time=300,
+    is_personal=False,
+    next_offset=None,        # pass a string to enable pagination
+    switch_pm=None,          # ("Button text", "start_param") to show a "go to PM" button
+)
+```
+
+**InlineArticle**
+
+```python
+InlineArticle(
+    id="1",
+    title="My Article",
+    message_text="Text sent when user picks this result.",
+    description=None,        # subtitle shown in the result list
+    url=None,                # URL shown under the title
+    thumb_url=None,          # thumbnail URL
+    reply_markup=None,       # InlineKeyboard attached to the sent message
+)
+```
+
+**InlinePhoto**
+
+```python
+InlinePhoto(
+    id="2",
+    title="A Photo",
+    message_text="Caption for the photo.",
+    photo_url="https://example.com/photo.jpg",   # required, direct image URL
+    photo_width=0,           # optional dimensions hint
+    photo_height=0,
+    description=None,
+    thumb_url=None,
+    mime_type="image/jpeg",
+    reply_markup=None,
+)
+```
+
+**InlineDocument**
+
+```python
+InlineDocument(
+    id="3",
+    title="A File",
+    message_text="Here is the file.",
+    document_url="https://example.com/file.pdf",  # required, direct file URL
+    mime_type="application/pdf",                  # required
+    description=None,
+    thumb_url=None,
+    reply_markup=None,
+)
+```
+
+**Simple articles shortcut**
+
+If you only need plain text articles with no extra fields, there is a lighter helper:
+
+```python
+await client.answer_inline_query_articles(
+    query_id,
+    articles=[
+        ("id1", "Title One", "Message text one"),
+        ("id2", "Title Two", "Message text two"),
+    ],
+    cache_time=300,
+    is_personal=False,
+    next_offset=None,
+)
+```
 
+### Editing inline messages
+
+After answering an inline query, you can edit the message later using the ID from `InlineSend`.
+
+```python
 from ferogram import InlineMessageId
-await client.edit_inline_message(InlineMessageId(dc_id=2, id_bytes=b"..."), "new text")
+
+await client.edit_inline_message(
+    InlineMessageId(dc_id=2, id_bytes=b"..."),
+    "updated text",
+    reply_markup=None,       # optionally attach or update the keyboard
+)
+```
+
+To get the `InlineMessageId` from a send event:
+
+```python
+@app.on_inline_send()
+async def handler(client, send):
+    # send.user_id       int
+    # send.query         str
+    # send.result_id     str
+    # send.msg_id_bytes  bytes | None  (raw serialized InputBotInlineMessageId)
+    # send.msg_id_dc     int | None    (DC where the message lives)
+
+    if send.msg_id_bytes:
+        msg_id = InlineMessageId(send.msg_id_dc, bytes(send.msg_id_bytes))
+        await client.edit_inline_message(msg_id, "updated!")
+```
+
+`msg_id_bytes` and `msg_id_dc` are `None` when the bot did not request inline feedback for this query (i.e. the result was sent without enabling `@BotFather` inline feedback).
+
+
+## Participants
+
+These methods work on groups, supergroups, and channels.
+
+```python
+await client.get_participants(peer, limit=200)
+# -> list[ChatMember]
+
+await client.get_participants_filtered(peer, filter="recent", limit=200)
+# filter: "recent" | "admins" | "kicked" | "banned" | "bots"
+# -> list[ChatMember]
+
+await client.kick_participant(peer, user)
+# Removes the user from the chat. They can rejoin if the chat is public or they have an invite link.
+
+await client.ban_participant(peer, user)
+# Permanently bans until manually lifted.
+
+await client.ban_participant_until(peer, user, until_date)
+# until_date is a unix timestamp. The ban lifts automatically after that time.
+
+await client.promote_participant(peer, user, rights=None)
+# rights is a list of permission strings. Pass None to grant all admin rights.
+# Valid strings: "change_info", "post_messages", "edit_messages",
+#                "delete_messages", "ban_users", "invite_users",
+#                "pin_messages", "add_admins", "manage_call"
+
+await client.demote_participant(peer, user)
+# Removes all admin rights. The user stays as a regular member.
+
+await client.get_profile_photos(peer, limit=100)
+# -> list of (file_id, access_hash, dc_id) tuples
+
+await client.search_peer(query)
+# Search the local peer cache by name or username.
+# -> list[str] of matching peer identifiers
+
+client.signal_network_restored()
+# Not async. Call this when you know network is back to trigger an immediate
+# reconnect attempt instead of waiting for the retry timer.
 ```
 
+### ChatMember fields
+
+`user_id`, `first_name`, `last_name`, `username`, `bot`, `status`, `admin_rank`, `full_name`
+
 
 ## Chats & Groups
 
@@ -332,10 +587,6 @@ await client.get_pinned_dialogs(folder_id=0)         # 0=main, 1=archive
 await client.mark_dialog_read(peer)
 ```
 
-### ChatMember fields
-
-`user_id`, `first_name`, `last_name`, `username`, `bot`, `status`, `admin_rank`, `full_name`
-
 
 ## Forum Topics
 
@@ -355,6 +606,35 @@ await client.all_join_requests(peer, approve=True, link=None)
 ```
 
 
+## Invite Links
+
+```python
+await client.invite_links(peer)                          # -> [ExportedChatInvite]
+await client.invite_links(peer, primary_only=True)       # -> ExportedChatInvite (primary link)
+await client.invite_links(peer, revoked=True)            # -> [ExportedChatInvite] (revoked links)
+
+async for link in client.iter_invite_links(peer, revoked=False):
+    ...                                                  # yields ExportedChatInvite objects
+
+async for member in client.iter_invite_link_members(peer, link, requested=False):
+    ...                                                  # yields ChatInviteImporter objects
+
+await client.edit_invite_link(
+    peer, link,
+    expire_date=None,      # unix timestamp; None = no expiry
+    usage_limit=None,      # None = unlimited
+    request_needed=None,   # require admin approval to join
+    title=None,
+)
+await client.revoke_invite_link(peer, link)              # -> revoked ExportedChatInvite
+await client.delete_invite_link(peer, link)              # delete a revoked link permanently
+await client.clear_revoked_invite_links(peer)            # delete all revoked links
+
+await client.resolve_invite_link(link)                   # peek without joining -> ChatInvite
+await client.join_invite_link(link)                      # join and return InputPeer
+```
+
+
 ## Account & Profile
 
 ```python
@@ -362,6 +642,10 @@ await client.get_me()                               # -> User
 await client.get_users_by_id([user_id, ...])        # -> [User | None]
 await client.get_user_full(user_id)                 # -> UserFull
 await client.get_dialogs(limit=100)                 # -> [Dialog]
+async for dialog in client.iter_dialogs(limit=None):
+    ...                                             # yields Dialog objects
+async for msg in client.iter_messages(peer, limit=None, offset_id=0):
+    ...                                             # yields Message objects, newest first
 await client.set_profile(first_name=None, last_name=None, about=None)
 await client.set_username(username)
 await client.set_online()
@@ -432,7 +716,9 @@ await client.set_privacy(PrivacyKey.PHONE_NUMBER, PrivacyRule.ALLOW_CONTACTS)
 ## Sessions & Auth
 
 ```python
-await client.get_authorizations()
+await client.is_authorized()                        # -> bool
+await client.login_bot(token)                       # sign in as bot after start()
+await client.get_authorizations()                   # -> [Authorization]
 await client.terminate_session(hash)
 
 # QR login
@@ -455,10 +741,10 @@ await client.open_mini_app(peer, app_type="main", app_value="")   # -> MiniAppSe
 ## Stats
 
 ```python
-await client.get_broadcast_stats(peer)
-await client.get_megagroup_stats(peer)
+await client.get_broadcast_stats(peer)              # -> BroadcastStats
+await client.get_megagroup_stats(peer)              # -> MegagroupStats
 await client.get_game_high_scores(peer, msg_id, user_id)  # -> [(position, user_id, score)]
-await client.get_poll_stats(peer, msg_id)                 # -> views count (int)
+await client.get_poll_stats(peer, msg_id)           # -> int (interaction count)
 ```
 
 
@@ -475,6 +761,15 @@ await client.send_invoice(
 ```
 
 
+## Custom Emoji
+
+```python
+await client.get_custom_emoji_documents(document_ids=[...])
+# Pass a list of custom emoji document IDs.
+# Returns the subset of IDs that resolved successfully.
+```
+
+
 ## Peer Resolution
 
 ```python
@@ -640,4 +935,3 @@ ChatAction.RECORD_ROUND
 ChatAction.UPLOAD_ROUND
 ChatAction.CANCEL
 ```
-