Add more Walkthrough sections

Author: rojvv

src/account-and-app-settings.md

@@ -0,0 +1,119 @@
+---
+title: Account and App Settings
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 25
+---
+
+Users can manage general account behavior and retrieve Telegram app information.
+
+## Updating the Profile
+
+{{ "updateProfile" |> m }} changes the current user's name or bio.
+
+```ts
+await client.updateProfile({ firstName: "Ada", bio: "Hello" });
+```
+
+{{ "setIsOnline" |> m }} updates the account's online status.
+
+```ts
+await client.setIsOnline(true);
+```
+
+## Emoji Statuses
+
+{{ "setEmojiStatus" |> m }} and {{ "removeEmojiStatus" |> m }} set or remove the account's status.
+
+```ts
+await client.setEmojiStatus({ type: "customEmoji", customEmojiId });
+await client.removeEmojiStatus();
+```
+
+Channels have corresponding {{ "setChannelEmojiStatus" |> m }} and {{ "removeChannelEmojiStatus" |> m }} methods.
+
+```ts
+await client.setChannelEmojiStatus(channelId, { type: "customEmoji", customEmojiId });
+await client.removeChannelEmojiStatus(channelId);
+```
+
+Recent statuses come from {{ "getRecentEmojiStatuses" |> m }} and can be cleared with {{ "clearRecentEmojiStatuses" |> m }}.
+
+```ts
+const statuses = await client.getRecentEmojiStatuses();
+await client.clearRecentEmojiStatuses();
+```
+
+## Bot Permissions
+
+{{ "allowBotToSetCustomEmojiStatus" |> m }} and {{ "disallowBotToSetCustomEmojiStatus" |> m }} grant or revoke a bot's permission to change the status.
+
+```ts
+await client.allowBotToSetCustomEmojiStatus(botId);
+await client.disallowBotToSetCustomEmojiStatus(botId);
+```
+
+Attachment-menu bots are managed through {{ "addBotToAttachmentsMenu" |> m }} and {{ "removeBotFromAttachmentsMenu" |> m }}.
+
+```ts
+await client.addBotToAttachmentsMenu(botId);
+await client.removeBotFromAttachmentsMenu(botId);
+```
+
+## Paid Messages
+
+Exceptions for paid incoming messages are managed by {{ "allowUnpaidMessagesFromUser" |> m }} and {{ "disallowUnpaidMessagesFromUser" |> m }}.
+
+```ts
+await client.allowUnpaidMessagesFromUser(userId);
+await client.disallowUnpaidMessagesFromUser(userId);
+```
+
+## New Chats
+
+{{ "getArchiveAndMuteNewChatsFromUnknownUsers" |> m }} reads the automatic-archiving setting, and {{ "setArchiveAndMuteNewChatsFromUnknownUsers" |> m }} changes it.
+
+```ts
+const isEnabled = await client.getArchiveAndMuteNewChatsFromUnknownUsers();
+await client.setArchiveAndMuteNewChatsFromUnknownUsers(true);
+```
+
+{{ "getNewChatPrivacy" |> m }} and {{ "setNewChatPrivacy" |> m }} control who can start new chats with the account.
+
+```ts
+const privacy = await client.getNewChatPrivacy();
+await client.setNewChatPrivacy({
+  isNewChatFromNonPremiumUsersAllowed: true,
+  messagePrice: 0,
+});
+```
+
+## Gifts
+
+Gift visibility is available through {{ "getGiftPrivacy" |> m }} and {{ "setGiftPrivacy" |> m }}.
+
+```ts
+const privacy = await client.getGiftPrivacy();
+await client.setGiftPrivacy({
+  isGiftButtonDisplayed: true,
+  isRegularGiftAccepted: true,
+});
+```
+
+## Sponsored Messages
+
+Sponsored messages are controlled by {{ "enableSponsoredMessages" |> m }} and {{ "disableSponsoredMessages" |> m }}.
+
+```ts
+await client.enableSponsoredMessages();
+await client.disableSponsoredMessages();
+```
+
+## Deleting the Account
+
+Permanently delete the current account through {{ "deleteAccount" |> m }}.
+
+```ts
+await client.deleteAccount("No longer needed");
+```

src/account-auto-deletion.md

@@ -10,7 +10,7 @@ Users can control when an inactive account is automatically deleted.
 
 ## Getting the Auto-Deletion Period
 
-Use {{ "getAccountTtl" |> m }} to get the period in days.
+{{ "getAccountTtl" |> m }} lets you get the period in days.
 
 ```ts
 const dayCount = await client.getAccountTtl();
@@ -20,7 +20,7 @@ console.log(dayCount);
 
 ## Setting the Auto-Deletion Period
 
-Use {{ "setAccountTtl" |> m }} with the period in days.
+{{ "setAccountTtl" |> m }} accepts the period in days.
 
 ```ts
 await client.setAccountTtl(365);

src/administered-chats.md

@@ -0,0 +1,13 @@
+---
+title: Administered Chats
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 50
+---
+
+{{ "getAdministeredChats" |> m }} lists chats administered by the current account.
+
+```ts
+const chats = await client.getAdministeredChats();
+```

src/administration-log.md

@@ -0,0 +1,13 @@
+---
+title: Administration Log
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 49
+---
+
+{{ "getRecentActions" |> m }} returns recent administrative actions in a chat.
+
+```ts
+const actions = await client.getRecentActions(chatId);
+```

src/app-support.md

@@ -0,0 +1,21 @@
+---
+title: App Support
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 42
+---
+
+Users can retrieve the support information associated with their Telegram application.
+
+{{ "getAppSupport" |> m }} returns the support user and message.
+
+```ts
+const support = await client.getAppSupport();
+```
+
+{{ "getAppSupportName" |> m }} returns the application's support name.
+
+```ts
+const supportName = await client.getAppSupportName();
+```

src/application-configuration.md

@@ -0,0 +1,13 @@
+---
+title: Application Configuration
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 40
+---
+
+{{ "getApplicationConfiguration" |> m }} returns Telegram's current application configuration.
+
+```ts
+const configuration = await client.getApplicationConfiguration();
+```

src/archived-chats.md

@@ -10,15 +10,15 @@ Users can move chats between the main and archived chat lists.
 
 ## Archiving a Chat
 
-Use {{ "archiveChat" |> m }} with the chat's identifier.
+{{ "archiveChat" |> m }} moves a chat to the archive.
 
 ```ts
 await client.archiveChat(chatId);
 ```
 
 ## Listing Archived Chats
 
-Use {{ "getChats" |> m }} with `from` set to `"archived"`.
+{{ "getChats" |> m }} lists the archive when `from` is set to `"archived"`.
 
 ```ts
 const chats = await client.getChats({ from: "archived" });
@@ -30,8 +30,17 @@ for (const { chat } of chats) {
 
 ## Unarchiving a Chat
 
-Use {{ "unarchiveChat" |> m }} with the chat's identifier.
+{{ "unarchiveChat" |> m }} moves it back to the main list.
 
 ```ts
 await client.unarchiveChat(chatId);
 ```
+
+## Moving Multiple Chats
+
+{{ "archiveChats" |> m }} and {{ "unarchiveChats" |> m }} move several chats at once.
+
+```ts
+await client.archiveChats(chatIds);
+await client.unarchiveChats(chatIds);
+```

src/authorization-sessions.md

@@ -10,7 +10,7 @@ Users can view and remove the account's authorization sessions.
 
 ## Listing Sessions
 
-Use {{ "getAuthorizationSessions" |> m }} to get the sessions as {{ "AuthorizationSession" |> t }} objects.
+To get the sessions as {{ "AuthorizationSession" |> t }} objects, call {{ "getAuthorizationSessions" |> m }}.
 
 ```ts
 const sessions = await client.getAuthorizationSessions();
@@ -24,15 +24,15 @@ The current session has `isCurrent` set to `true`.
 
 ## Removing a Session
 
-Use {{ "removeAuthorizationSession" |> m }} with the session's identifier.
+{{ "removeAuthorizationSession" |> m }} accepts the session's identifier.
 
 ```ts
 await client.removeAuthorizationSession(sessionId);
 ```
 
 ## Removing Other Sessions
 
-Use {{ "removeAuthorizationSessions" |> m }} to remove every session except the current one.
+{{ "removeAuthorizationSessions" |> m }} removes every session except the current one.
 
 ```ts
 await client.removeAuthorizationSessions();

src/birthday.md

@@ -10,7 +10,7 @@ Users can set or remove the account's birthday.
 
 ## Setting a Birthday
 
-Use {{ "setBirthday" |> m }} with the day, month, and optionally the year.
+{{ "setBirthday" |> m }} accepts the day, month, and optionally the year.
 
 ```ts
 await client.setBirthday({
@@ -20,8 +20,16 @@ await client.setBirthday({
 
 ## Removing the Birthday
 
-Call {{ "setBirthday" |> m }} without a birthday.
+An empty {{ "setBirthday" |> m }} call removes the birthday.
 
 ```ts
 await client.setBirthday();
 ```
+
+## Suggesting a Birthday
+
+{{ "suggestBirthday" |> m }} suggests a birthday to another user.
+
+```ts
+await client.suggestBirthday(userId, { day: 1, month: 1, year: 2000 });
+```

src/blocked-users.md

@@ -10,15 +10,15 @@ Users can block users and manage the account's block list.
 
 ## Blocking a User
 
-Use {{ "blockUser" |> m }} with the user's identifier.
+{{ "blockUser" |> m }} accepts the user's identifier.
 
 ```ts
 await client.blockUser(userId);
 ```
 
 ## Listing Blocked Users
 
-Use {{ "getBlockedUsers" |> m }} to get a {{ "BlockedUserList" |> t }}.
+{{ "getBlockedUsers" |> m }} lets you get a {{ "BlockedUserList" |> t }}.
 
 ```ts
 const { blockedUsers } = await client.getBlockedUsers();
@@ -30,7 +30,7 @@ for (const { user, blockedAt } of blockedUsers) {
 
 ## Unblocking a User
 
-Use {{ "unblockUser" |> m }} with the user's identifier.
+{{ "unblockUser" |> m }} accepts the user's identifier.
 
 ```ts
 await client.unblockUser(userId);