@grom.js/effect-tg 0.6.0 → 0.8.0

package/src/internal/botApiTypes.gen.ts

@@ -104,6 +104,8 @@ export interface User {
   can_connect_to_business?: boolean
   /** _True_, if the bot has a main Web App. Returned only in [getMe](https://core.telegram.org/bots/api#getme). */
   has_main_web_app?: boolean
+  /** _True_, if the bot has forum topic mode enabled in private chats. Returned only in [getMe](https://core.telegram.org/bots/api#getme). */
+  has_topics_enabled?: boolean
 }
 
 /** This object represents a chat. */
@@ -222,13 +224,19 @@ export interface ChatFullInfo {
   linked_chat_id?: number
   /** For supergroups, the location to which the supergroup is connected */
   location?: ChatLocation
+  /** For private chats, the rating of the user if any */
+  rating?: UserRating
+  /** The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */
+  unique_gift_colors?: UniqueGiftColors
+  /** The number of Telegram Stars a general user have to pay to send a message to the chat */
+  paid_message_star_count?: number
 }
 
 /** This object represents a message. */
 export interface Message {
   /** Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
   message_id: number
-  /** Unique identifier of a message thread to which the message belongs; for supergroups only */
+  /** Unique identifier of a message thread or forum topic to which the message belongs; for supergroups and private chats only */
   message_thread_id?: number
   /** Information about the direct messages chat topic that contains the message */
   direct_messages_topic?: DirectMessagesTopic
@@ -248,7 +256,7 @@ export interface Message {
   chat: Chat
   /** Information about the original message for forwarded messages */
   forward_origin?: MessageOrigin
-  /** _True_, if the message is sent to a forum topic */
+  /** _True_, if the message is sent to a topic in a forum supergroup or a private chat with the bot */
   is_topic_message?: true
   /** _True_, if the message is a channel post that was automatically forwarded to the connected discussion group */
   is_automatic_forward?: true
@@ -368,6 +376,8 @@ export interface Message {
   gift?: GiftInfo
   /** Service message: a unique gift was sent or received */
   unique_gift?: UniqueGiftInfo
+  /** Service message: upgrade of a gift was purchased after the gift was sent */
+  gift_upgrade_sent?: GiftInfo
   /** The domain name of the website on which the user has logged in. [More about Telegram Login »](https://core.telegram.org/widgets/login) */
   connected_website?: string
   /** Service message: the user allowed the bot to write messages after adding it to the attachment or side menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method [requestWriteAccess](https://core.telegram.org/bots/webapps#initializing-mini-apps) */
@@ -893,8 +903,10 @@ export interface ChecklistTask {
   text: string
   /** Special entities that appear in the task text */
   text_entities?: Array<MessageEntity>
-  /** User that completed the task; omitted if the task wasn't completed */
+  /** User that completed the task; omitted if the task wasn't completed by a user */
   completed_by_user?: User
+  /** Chat that completed the task; omitted if the task wasn't completed by a chat */
+  completed_by_chat?: Chat
   /** Point in time (Unix timestamp) when the task was completed; 0 if the task wasn't completed */
   completion_date?: number
 }
@@ -1132,6 +1144,8 @@ export interface ForumTopicCreated {
   icon_color: number
   /** Unique identifier of the custom emoji shown as the topic icon */
   icon_custom_emoji_id?: string
+  /** _True_, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot */
+  is_name_implicit?: true
 }
 
 /** This object represents a service message about a forum topic closed in the chat. Currently holds no information. */
@@ -1987,6 +2001,18 @@ export interface BusinessOpeningHours {
   opening_hours: Array<BusinessOpeningHoursInterval>
 }
 
+/** This object describes the rating of a user based on their Telegram Star spendings. */
+export interface UserRating {
+  /** Current level of the user, indicating their reliability when purchasing digital goods and services. A higher level suggests a more trustworthy customer; a negative level is likely reason for concern. */
+  level: number
+  /** Numerical value of the user's rating; the higher the rating, the better */
+  rating: number
+  /** The rating value required to get the current level */
+  current_level_rating: number
+  /** The rating value required to get to the next level; omitted if the maximum level was reached */
+  next_level_rating?: number
+}
+
 /** Describes the position of a clickable area within a story. */
 export interface StoryAreaPosition {
   /** The abscissa of the area's center, as a percentage of the media width */
@@ -2173,6 +2199,18 @@ export interface ForumTopic {
   icon_color: number
   /** Unique identifier of the custom emoji shown as the topic icon */
   icon_custom_emoji_id?: string
+  /** _True_, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot */
+  is_name_implicit?: true
+}
+
+/** This object describes the background of a gift. */
+export interface GiftBackground {
+  /** Center color of the background in RGB format */
+  center_color: number
+  /** Edge color of the background in RGB format */
+  edge_color: number
+  /** Text color of the background in RGB format */
+  text_color: number
 }
 
 /** This object represents a gift that can be sent by the bot. */
@@ -2185,10 +2223,22 @@ export interface Gift {
   star_count: number
   /** The number of Telegram Stars that must be paid to upgrade the gift to a unique one */
   upgrade_star_count?: number
-  /** The total number of the gifts of this type that can be sent; for limited gifts only */
+  /** _True_, if the gift can only be purchased by Telegram Premium subscribers */
+  is_premium?: true
+  /** _True_, if the gift can be used (after being upgraded) to customize a user's appearance */
+  has_colors?: true
+  /** The total number of gifts of this type that can be sent by all users; for limited gifts only */
   total_count?: number
-  /** The number of remaining gifts of this type that can be sent; for limited gifts only */
+  /** The number of remaining gifts of this type that can be sent by all users; for limited gifts only */
   remaining_count?: number
+  /** The total number of gifts of this type that can be sent by the bot; for limited gifts only */
+  personal_total_count?: number
+  /** The number of remaining gifts of this type that can be sent by the bot; for limited gifts only */
+  personal_remaining_count?: number
+  /** Background of the gift */
+  background?: GiftBackground
+  /** The total number of different unique gifts that can be obtained by upgrading the gift */
+  unique_gift_variant_count?: number
   /** Information about the chat that published the gift */
   publisher_chat?: Chat
 }
@@ -2241,8 +2291,26 @@ export interface UniqueGiftBackdrop {
   rarity_per_mille: number
 }
 
+/** This object contains information about the color scheme for a user's name, message replies and link previews based on a unique gift. */
+export interface UniqueGiftColors {
+  /** Custom emoji identifier of the unique gift's model */
+  model_custom_emoji_id: string
+  /** Custom emoji identifier of the unique gift's symbol */
+  symbol_custom_emoji_id: string
+  /** Main color used in light themes; RGB format */
+  light_theme_main_color: number
+  /** List of 1-3 additional colors used in light themes; RGB format */
+  light_theme_other_colors: Array<number>
+  /** Main color used in dark themes; RGB format */
+  dark_theme_main_color: number
+  /** List of 1-3 additional colors used in dark themes; RGB format */
+  dark_theme_other_colors: Array<number>
+}
+
 /** This object describes a unique gift that was upgraded from a regular gift. */
 export interface UniqueGift {
+  /** Identifier of the regular gift from which the gift was upgraded */
+  gift_id: string
   /** Human-readable name of the regular gift from which this unique gift was upgraded */
   base_name: string
   /** Unique name of the gift. This name can be used in `https://t.me/nft/...` links and story areas */
@@ -2255,6 +2323,12 @@ export interface UniqueGift {
   symbol: UniqueGiftSymbol
   /** Backdrop of the gift */
   backdrop: UniqueGiftBackdrop
+  /** _True_, if the original regular gift was exclusively purchaseable by Telegram Premium subscribers */
+  is_premium?: true
+  /** _True_, if the gift is assigned from the TON blockchain and can't be resold or transferred in Telegram */
+  is_from_blockchain?: true
+  /** The color scheme that can be used by the gift's owner for the chat's name, replies to messages and link previews; for business account gifts and gifts that are currently on sale only */
+  colors?: UniqueGiftColors
   /** Information about the chat that published the gift */
   publisher_chat?: Chat
 }
@@ -2267,8 +2341,10 @@ export interface GiftInfo {
   owned_gift_id?: string
   /** Number of Telegram Stars that can be claimed by the receiver by converting the gift; omitted if conversion to Telegram Stars is impossible */
   convert_star_count?: number
-  /** Number of Telegram Stars that were prepaid by the sender for the ability to upgrade the gift */
+  /** Number of Telegram Stars that were prepaid for the ability to upgrade the gift */
   prepaid_upgrade_star_count?: number
+  /** _True_, if the gift's upgrade was purchased after the gift was sent */
+  is_upgrade_separate?: true
   /** _True_, if the gift can be upgraded to a unique gift */
   can_be_upgraded?: true
   /** Text of the message that was added to the gift */
@@ -2277,16 +2353,20 @@ export interface GiftInfo {
   entities?: Array<MessageEntity>
   /** _True_, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them */
   is_private?: true
+  /** Unique number reserved for this gift when upgraded. See the _number_ field in [UniqueGift](https://core.telegram.org/bots/api#uniquegift) */
+  unique_gift_number?: number
 }
 
 /** Describes a service message about a unique gift that was sent or received. */
 export interface UniqueGiftInfo {
   /** Information about the gift */
   gift: UniqueGift
-  /** Origin of the gift. Currently, either “upgrade” for gifts upgraded from regular gifts, “transfer” for gifts transferred from other users or channels, or “resale” for gifts bought from other users */
+  /** Origin of the gift. Currently, either “upgrade” for gifts upgraded from regular gifts, “transfer” for gifts transferred from other users or channels, “resale” for gifts bought from other users, “gifted\_upgrade” for upgrades purchased after the gift was sent, or “offer” for gifts bought or sold through gift purchase offers */
   origin: string
-  /** For gifts bought from other users, the price paid for the gift */
-  last_resale_star_count?: number
+  /** For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of “XTR” for Telegram Stars or “TON” for toncoins. */
+  last_resale_currency?: string
+  /** For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanotoncoins */
+  last_resale_amount?: number
   /** Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts */
   owned_gift_id?: string
   /** Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift */
@@ -2327,10 +2407,14 @@ export interface OwnedGiftRegular {
   can_be_upgraded?: true
   /** _True_, if the gift was refunded and isn't available anymore */
   was_refunded?: true
-  /** Number of Telegram Stars that can be claimed by the receiver instead of the gift; omitted if the gift cannot be converted to Telegram Stars */
+  /** Number of Telegram Stars that can be claimed by the receiver instead of the gift; omitted if the gift cannot be converted to Telegram Stars; for gifts received on behalf of business accounts only */
   convert_star_count?: number
-  /** Number of Telegram Stars that were paid by the sender for the ability to upgrade the gift */
+  /** Number of Telegram Stars that were paid for the ability to upgrade the gift */
   prepaid_upgrade_star_count?: number
+  /** _True_, if the gift's upgrade was purchased after the gift was sent; for gifts received on behalf of business accounts only */
+  is_upgrade_separate?: true
+  /** Unique number reserved for this gift when upgraded. See the _number_ field in [UniqueGift](https://core.telegram.org/bots/api#uniquegift) */
+  unique_gift_number?: number
 }
 
 /** Describes a unique gift received and owned by a user or a chat. */
@@ -2375,6 +2459,8 @@ export interface AcceptedGiftTypes {
   unique_gifts: boolean
   /** _True_, if a Telegram Premium subscription is accepted */
   premium_subscription: boolean
+  /** _True_, if transfers of unique gifts from channels are accepted */
+  gifts_from_channels: boolean
 }
 
 /** Describes an amount of Telegram Stars. */

package/src/internal/file.ts

@@ -0,0 +1,16 @@
+import type { FileId } from '../File.ts'
+import * as HttpClient from '@effect/platform/HttpClient'
+import * as Effect from 'effect/Effect'
+import * as BotApi from '../BotApi.ts'
+import * as BotApiUrl from '../BotApiUrl.ts'
+
+export const get = Effect.fnUntraced(
+  function* (fileId: FileId) {
+    const file = yield* BotApi.callMethod('getFile', { file_id: fileId })
+    if (file.file_path == null) {
+      return yield* Effect.die(new Error(`Bot API returned no file path for file "${fileId}".`))
+    }
+    const url = yield* BotApiUrl.BotApiUrl
+    return yield* HttpClient.get(url.toFile(file.file_path))
+  },
+)

package/src/internal/runner.ts

@@ -1,4 +1,4 @@
-import type { BotApiError } from '../BotApi.ts'
+import type { BotApiError } from '../BotApiError.ts'
 import type { BotApiTransportError } from '../BotApiTransport.ts'
 import type { Runner } from '../Runner.ts'
 import * as Duration from 'effect/Duration'
@@ -29,7 +29,7 @@ export const makeSimple = (options?: {
               schedule: Schedule.spaced(Duration.seconds(3)),
               while: error => Match.value(error).pipe(
                 Match.tagsExhaustive({
-                  '@grom.js/effect-tg/BotApi/BotApiError': error => Effect.succeed(
+                  '@grom.js/effect-tg/BotApiError': error => Effect.succeed(
                     error.code >= 500 || (
                       error.code !== 401
                       && error.code !== 403