add support of getBusinessAccountGifts

2025-09-03 15:19:30 +00:00 · 2025-05-10 10:57:33 +06:00
parent d2395e836c
commit d36b11c002
6 changed files with 263 additions and 0 deletions
--- a/tgbotapi.api/api/tgbotapi.api.api
+++ b/tgbotapi.api/api/tgbotapi.api.api
@@ -338,6 +338,13 @@ public final class dev/inmo/tgbotapi/extensions/api/business/DeleteBusinessMessa
 	public static final fun deleteBusinessMessages-wC12z2M (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;Ljava/util/List;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
 }

+public final class dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountGiftsKt {
+	public static final fun getBusinessAccountGifts-LATcL_E (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;ZZZZZZLjava/lang/String;Ljava/lang/Integer;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
+	public static synthetic fun getBusinessAccountGifts-LATcL_E$default (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;ZZZZZZLjava/lang/String;Ljava/lang/Integer;Lkotlin/coroutines/Continuation;ILjava/lang/Object;)Ljava/lang/Object;
+	public static final fun getBusinessAccountGiftsFlow-LATcL_E (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;ZZZZZZLjava/lang/String;Ljava/lang/Integer;Lkotlin/jvm/functions/Function2;)Lkotlinx/coroutines/flow/Flow;
+	public static synthetic fun getBusinessAccountGiftsFlow-LATcL_E$default (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;ZZZZZZLjava/lang/String;Ljava/lang/Integer;Lkotlin/jvm/functions/Function2;ILjava/lang/Object;)Lkotlinx/coroutines/flow/Flow;
+}
+
 public final class dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountStarBalanceKt {
 	public static final fun getBusinessAccountStarBalance-spp27rg (Ldev/inmo/tgbotapi/bot/RequestsExecutor;Ljava/lang/String;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
 }
--- a/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountGifts.kt
+++ b/tgbotapi.api/src/commonMain/kotlin/dev/inmo/tgbotapi/extensions/api/business/GetBusinessAccountGifts.kt
@@ -0,0 +1,94 @@
+package dev.inmo.tgbotapi.extensions.api.business
+
+import dev.inmo.tgbotapi.bot.TelegramBot
+import dev.inmo.tgbotapi.requests.business_connection.GetBusinessAccountGifts
+import dev.inmo.tgbotapi.types.business_connection.BusinessConnectionId
+import dev.inmo.tgbotapi.types.OwnedGifts
+import dev.inmo.tgbotapi.types.gifts.GiftSentOrReceived
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.flow
+import kotlin.runCatching
+
+public suspend fun TelegramBot.getBusinessAccountGifts(
+    businessConnectionId: BusinessConnectionId,
+    excludeUnsaved: Boolean = false,
+    excludeSaved: Boolean = false,
+    excludeUnlimited: Boolean = false,
+    excludeLimited: Boolean = false,
+    excludeUnique: Boolean = false,
+    sortByPrice: Boolean = false,
+    offset: String? = null,
+    limit: Int? = null
+): OwnedGifts<GiftSentOrReceived.ReceivedInBusinessAccount> = execute(
+    GetBusinessAccountGifts(
+        businessConnectionId,
+        excludeUnsaved,
+        excludeSaved,
+        excludeUnlimited,
+        excludeLimited,
+        excludeUnique,
+        sortByPrice,
+        offset,
+        limit
+    )
+)
+
+/**
+ * Creates a flow that emits business account gifts in a paginated manner.
+ *
+ * This function will automatically handle pagination by using the `nextOffset` from each response
+ * to fetch the next page of gifts until there are no more gifts to fetch.
+ *
+ * @param businessConnectionId The ID of the business connection
+ * @param excludeUnsaved Whether to exclude unsaved gifts
+ * @param excludeSaved Whether to exclude saved gifts
+ * @param excludeUnlimited Whether to exclude unlimited gifts
+ * @param excludeLimited Whether to exclude limited gifts
+ * @param excludeUnique Whether to exclude unique gifts
+ * @param sortByPrice Whether to sort gifts by price
+ * @param initialOffset The initial offset to start fetching from. If null, starts from the beginning
+ * @param limit The maximum number of gifts to fetch per request
+ * @param onErrorContinueChecker A function that determines whether to continue fetching on error.
+ *                              Returns true to continue, false to stop. Default is to stop on any error.
+ * @return A flow that emits [OwnedGifts] containing the fetched gifts
+ */
+public fun TelegramBot.getBusinessAccountGiftsFlow(
+    businessConnectionId: BusinessConnectionId,
+    excludeUnsaved: Boolean = false,
+    excludeSaved: Boolean = false,
+    excludeUnlimited: Boolean = false,
+    excludeLimited: Boolean = false,
+    excludeUnique: Boolean = false,
+    sortByPrice: Boolean = false,
+    initialOffset: String? = null,
+    limit: Int? = null,
+    onErrorContinueChecker: suspend (Throwable?) -> Boolean = { false }
+): Flow<OwnedGifts<GiftSentOrReceived.ReceivedInBusinessAccount>> = flow {
+    var currentOffset = initialOffset
+    do {
+        val response = runCatching {
+            getBusinessAccountGifts(
+                businessConnectionId,
+                excludeUnsaved,
+                excludeSaved,
+                excludeUnlimited,
+                excludeLimited,
+                excludeUnique,
+                sortByPrice,
+                currentOffset,
+                limit
+            )
+        }
+        if (response.isSuccess) {
+            val result = response.getOrThrow()
+            emit(result)
+            currentOffset = result.nextOffset
+        } else {
+            if (onErrorContinueChecker(response.exceptionOrNull())) {
+                continue
+            } else {
+                break
+            }
+        }
+    } while (currentOffset != null)
+}