Tags

Tags give the ability to mark specific points in history as being important

  • 0.3.0

    protected
    7ddce0c8 · merge: Provide a select-based API for getting answers to questions ·
    Release: 0.3.0 • Handlers can now wait for a specific update before further progress 
    Handlers can now wait for a specific update before further progress

### Handlers can now wait for successor events

This release contains utilities to wait for updates within a handler. This allows handlers to be stateful.

Until now, state needed to be global, and thus needed disambiguation and explicit synchronization:
```kotlin
val counterMessages = mutableMapOf<Message.Id, Message>()
val counters = mutableMapOf<Message.Id, Int>()
val lock = Mutex()

command("/counter") { msg ->
	bot.sendMessage(
		msg.chat.id,
		"0",
		replyMarkup = InlineKeyboardMarkup(
			listOf(listOf(InlineKeyboardButton("+", callbackData = "plus")))
		)
	)

	lock.withLock {
		counterMessages[msg.id] = msg
		counters[msg.id] = 0
	}

	// Clean up the resources in the future to avoid infinite memory growth
	GlobalScope.launch {
                delay(24.hours)
		lock.withLock {
			counterMessages.remove(msg.id)
			counters.remove(msg.id)
		}
	}
}

callbackQuery {
	val initialMessageId = (it.message as Message).id

	val (initialMessage, counter) = lock.withLock {
		val initialMessage = counterMessages[initialMessageId] ?: return@callbackQuery
		var counter = counters[initialMessageId] ?: return@callbackQuery

		counter++
		counters[initialMessageId] = counter

		initialMessage to counter
	}

	bot.editMessageText(
		chat = initialMessage.chat.id,
		messageId = initialMessageId,
		text = "$counter"
	)
}
```

In this version, route handlers gain the ability to wait until specific events themselves, which allows them to use local state:
```kotlin
command("/counter") { msg ->
	var counter = 0

	msg.reply(
		text = "0",
		replyMarkup = InlineKeyboardMarkup(
			InlineKeyboardButton("+", callbackData = "plus"),
		)
	)

	selectUntilStopped {
		timeout(24.hours) {
			stop()
		}

		msg.callbackQuery("plus") {
			counter++
			msg.edit(
				text = "$counter",
				replyMarkup = InlineKeyboardMarkup(
					InlineKeyboardButton("+", callbackData = "plus"),
				)
			)
		}
	}
}
```

### Entities

- Added a convenience constructor for a single-line `InlineKeyboardMarkup` (ca16161d, !47)

### SDK

- Added `Message.reply()` (f95ac860, !47)
- Added `Message.edit()` (002b0cb6, !47)
- Added `Message.awaitReply()` (fd0b362f, !47)
- Added `awaitUpdate()` (e76a8dfc, !47)
- Added `selectFirst {}` to wait for one of multiple updates (da160116, !47)
- Added `selectUntilStopped {}` to wait in a loop for one of multiple events (89d1f204, !47)
- All handlers are now executed concurrently (d02c76f3, !47)
- Added the bot as a receiver in all handlers (!45)
- Marked `sendMessage` and `editMessageText` as ignorable return values (#4, !44)
- Created `BotRouter.HandlerContext` to inject information into handlers (!47)

  • 0.2.0

    protected
    0f51f4e5 · merge: Edit messages ·
    Release: 0.2.0 • Edit messages 
    Edit messages

### SDK

- Added `TelegramBot.editMessageText()` (!43, thanks @depaze!)

### Dependencies

- Kotlin 2.3.10

  • 0.1.3

    protected
    cd8f7751 · merge: Dependency upgrades ·
    Release: 0.1.3 • Kotlin 2.3.0 
    Dependency upgrades

### Dependencies

- Kotlin 2.3.0

  • 0.1.2

    protected
    b2949e4e · merge: Support inline buttons ·
    Release: 0.1.2 • Exception handling & inline buttons 
    Exception handling & inline buttons

### SDK

- Don't crash when a router fails (#1, !35)
- Allow declaring buttons & other markup when sending messages (!33)
- Add support for callback queries (!33)

  • 0.1.1

    protected
    1e96e00b · merge: Automatically register commands when polling ·
    Release: 0.1.1 • Automatic registering of commands 
    Automatic registering of commands

### SDK

- Allow declaring a description to bot commands (!31)
- The bot automatically uploads the registered commands (!31)

  • 0.1.0

    protected
    5a0c4c62 · merge: Include the modules in the publication ·
    Release: 0.1.0 • Initial prototype 
    Initial prototype