mirror of
https://github.com/lukaszraczylo/go-telegram.git
synced 2026-06-05 22:43:59 +00:00
refactor(api): typed enums for emoji-list fields (DiceEmoji, ReactionEmoji)
Two API fields carry restricted emoji-value sets that the scraper's
curly-quote regex strips during IR extraction (multi-byte boundary
issue): ReactionTypeEmoji.Emoji and sendDice.Emoji. They previously
typed as plain string with no compile-time guarantee on values.
Add hand-curated typed-string enums in api/enums.go (the manual file,
not enums.gen.go):
- DiceEmoji: 6 constants (Dice, Dart, Basketball, Football, Bowling,
SlotMachine) covering Telegram's full set for sendDice.
- ReactionEmoji: 73 constants covering the canonical reaction set
from https://core.telegram.org/bots/api#reactiontypeemoji. Names
follow Unicode CLDR short names where one exists, otherwise stable
common-English labels (e.g. ThumbsUp, Heart, Clown, ManTechnologist).
Wire the field-type override via cmd/genapi/emitter.go:
- fieldTypeOverrides map keyed "<TypeOrParamsName>.<FieldName>".
- goField/multipartFieldEntry consult the override after the enum-plan
lookup; falls through to the default goType when nothing matches.
- methods.tmpl gains goFieldP/multipartFieldEntryP helpers that pass
the params type name as override-parent (the params struct doesn't
share a Go type with the field, so the existing parent="" enum-key
convention is preserved).
Regenerated api/types.gen.go and api/methods.gen.go now type the two
fields as ReactionEmoji and DiceEmoji respectively. No other Emoji
field is affected (override is scoped per parent type). regen-from-
fixture is byte-deterministic across runs.
Add api/emoji_enums_test.go covering const wire values, reflection
checks on field types, and a marshal/unmarshal round-trip for
ReactionTypeEmoji.
This commit is contained in:
+115
-2
@@ -289,6 +289,7 @@ Package api contains the Telegram Bot API object types and method wrappers, gene
|
||||
- [type DeleteStoryParams](<#DeleteStoryParams>)
|
||||
- [type DeleteWebhookParams](<#DeleteWebhookParams>)
|
||||
- [type Dice](<#Dice>)
|
||||
- [type DiceEmoji](<#DiceEmoji>)
|
||||
- [type DirectMessagePriceChanged](<#DirectMessagePriceChanged>)
|
||||
- [type DirectMessagesTopic](<#DirectMessagesTopic>)
|
||||
- [type Document](<#Document>)
|
||||
@@ -651,6 +652,7 @@ Package api contains the Telegram Bot API object types and method wrappers, gene
|
||||
- [type ProximityAlertTriggered](<#ProximityAlertTriggered>)
|
||||
- [type ReactionCount](<#ReactionCount>)
|
||||
- [func \(m \*ReactionCount\) UnmarshalJSON\(data \[\]byte\) error](<#ReactionCount.UnmarshalJSON>)
|
||||
- [type ReactionEmoji](<#ReactionEmoji>)
|
||||
- [type ReactionType](<#ReactionType>)
|
||||
- [func UnmarshalReactionType\(data \[\]byte\) \(ReactionType, error\)](<#UnmarshalReactionType>)
|
||||
- [type ReactionTypeCustomEmoji](<#ReactionTypeCustomEmoji>)
|
||||
@@ -4884,6 +4886,28 @@ type Dice struct {
|
||||
}
|
||||
```
|
||||
|
||||
<a name="DiceEmoji"></a>
|
||||
## type [DiceEmoji](<https://github.com/lukaszraczylo/go-telegram/blob/main/api/enums.go#L42>)
|
||||
|
||||
DiceEmoji is the set of emoji values accepted by sendDice. Telegram's canonical list is "🎲", "🎯", "🏀", "⚽", "🎳", "🎰". The codegen scraper drops these values during regex extraction \(multi\-byte boundary issues with curly\-quoted emoji\), so this enum is hand\- curated and wired into SendDiceParams.Emoji via the per\-field type override in cmd/genapi/emitter.go.
|
||||
|
||||
```go
|
||||
type DiceEmoji string
|
||||
```
|
||||
|
||||
<a name="DiceEmojiDice"></a>
|
||||
|
||||
```go
|
||||
const (
|
||||
DiceEmojiDice DiceEmoji = "🎲"
|
||||
DiceEmojiDart DiceEmoji = "🎯"
|
||||
DiceEmojiBasketball DiceEmoji = "🏀"
|
||||
DiceEmojiFootball DiceEmoji = "⚽"
|
||||
DiceEmojiBowling DiceEmoji = "🎳"
|
||||
DiceEmojiSlotMachine DiceEmoji = "🎰"
|
||||
)
|
||||
```
|
||||
|
||||
<a name="DirectMessagePriceChanged"></a>
|
||||
## type [DirectMessagePriceChanged](<https://github.com/lukaszraczylo/go-telegram/blob/main/api/types.gen.go#L2179-L2184>)
|
||||
|
||||
@@ -11289,6 +11313,95 @@ func (m *ReactionCount) UnmarshalJSON(data []byte) error
|
||||
|
||||
UnmarshalJSON decodes ReactionCount by dispatching union\-typed fields \(Type\) through their concrete UnmarshalXxx helpers.
|
||||
|
||||
<a name="ReactionEmoji"></a>
|
||||
## type [ReactionEmoji](<https://github.com/lukaszraczylo/go-telegram/blob/main/api/enums.go#L62>)
|
||||
|
||||
ReactionEmoji is the set of emoji Telegram allows in a ReactionTypeEmoji.Emoji value. Hand\-curated from https://core.telegram.org/bots/api#reactiontypeemoji because the scraper's curly\-quote regex strips the emoji literals \(byte\-boundary issue on multi\-byte sequences\). Names mirror the Unicode CLDR short name where one exists; otherwise a stable common\-English label. Telegram occasionally extends this set — passers of unrecognised strings still type\-check \(ReactionEmoji is a string alias\) so this list need not block runtime use of newer values.
|
||||
|
||||
```go
|
||||
type ReactionEmoji string
|
||||
```
|
||||
|
||||
<a name="ReactionEmojiHeart"></a>
|
||||
|
||||
```go
|
||||
const (
|
||||
ReactionEmojiHeart ReactionEmoji = "❤"
|
||||
ReactionEmojiThumbsUp ReactionEmoji = "👍"
|
||||
ReactionEmojiThumbsDown ReactionEmoji = "👎"
|
||||
ReactionEmojiFire ReactionEmoji = "🔥"
|
||||
ReactionEmojiSmilingFaceWithHearts ReactionEmoji = "🥰"
|
||||
ReactionEmojiClappingHands ReactionEmoji = "👏"
|
||||
ReactionEmojiBeamingFace ReactionEmoji = "😁"
|
||||
ReactionEmojiThinkingFace ReactionEmoji = "🤔"
|
||||
ReactionEmojiExplodingHead ReactionEmoji = "🤯"
|
||||
ReactionEmojiScreamingFace ReactionEmoji = "😱"
|
||||
ReactionEmojiCursingFace ReactionEmoji = "🤬"
|
||||
ReactionEmojiCryingFace ReactionEmoji = "😢"
|
||||
ReactionEmojiPartyPopper ReactionEmoji = "🎉"
|
||||
ReactionEmojiStarStruck ReactionEmoji = "🤩"
|
||||
ReactionEmojiVomiting ReactionEmoji = "🤮"
|
||||
ReactionEmojiPileOfPoo ReactionEmoji = "💩"
|
||||
ReactionEmojiFoldedHands ReactionEmoji = "🙏"
|
||||
ReactionEmojiOKHand ReactionEmoji = "👌"
|
||||
ReactionEmojiDove ReactionEmoji = "🕊"
|
||||
ReactionEmojiClown ReactionEmoji = "🤡"
|
||||
ReactionEmojiYawning ReactionEmoji = "🥱"
|
||||
ReactionEmojiWoozyFace ReactionEmoji = "🥴"
|
||||
ReactionEmojiHeartEyes ReactionEmoji = "😍"
|
||||
ReactionEmojiWhale ReactionEmoji = "🐳"
|
||||
ReactionEmojiHeartOnFire ReactionEmoji = "❤🔥"
|
||||
ReactionEmojiNewMoonFace ReactionEmoji = "🌚"
|
||||
ReactionEmojiHotDog ReactionEmoji = "🌭"
|
||||
ReactionEmojiHundredPoints ReactionEmoji = "💯"
|
||||
ReactionEmojiRollingOnFloor ReactionEmoji = "🤣"
|
||||
ReactionEmojiLightning ReactionEmoji = "⚡"
|
||||
ReactionEmojiBanana ReactionEmoji = "🍌"
|
||||
ReactionEmojiTrophy ReactionEmoji = "🏆"
|
||||
ReactionEmojiBrokenHeart ReactionEmoji = "💔"
|
||||
ReactionEmojiRaisedEyebrow ReactionEmoji = "🤨"
|
||||
ReactionEmojiNeutralFace ReactionEmoji = "😐"
|
||||
ReactionEmojiStrawberry ReactionEmoji = "🍓"
|
||||
ReactionEmojiChampagne ReactionEmoji = "🍾"
|
||||
ReactionEmojiKissMark ReactionEmoji = "💋"
|
||||
ReactionEmojiMiddleFinger ReactionEmoji = "🖕"
|
||||
ReactionEmojiDevil ReactionEmoji = "😈"
|
||||
ReactionEmojiSleeping ReactionEmoji = "😴"
|
||||
ReactionEmojiLoudlyCrying ReactionEmoji = "😭"
|
||||
ReactionEmojiNerd ReactionEmoji = "🤓"
|
||||
ReactionEmojiGhost ReactionEmoji = "👻"
|
||||
ReactionEmojiManTechnologist ReactionEmoji = "👨💻"
|
||||
ReactionEmojiEyes ReactionEmoji = "👀"
|
||||
ReactionEmojiJackOLantern ReactionEmoji = "🎃"
|
||||
ReactionEmojiSeeNoEvil ReactionEmoji = "🙈"
|
||||
ReactionEmojiHalo ReactionEmoji = "😇"
|
||||
ReactionEmojiFearful ReactionEmoji = "😨"
|
||||
ReactionEmojiHandshake ReactionEmoji = "🤝"
|
||||
ReactionEmojiWriting ReactionEmoji = "✍"
|
||||
ReactionEmojiHugging ReactionEmoji = "🤗"
|
||||
ReactionEmojiSaluting ReactionEmoji = "🫡"
|
||||
ReactionEmojiSantaClaus ReactionEmoji = "🎅"
|
||||
ReactionEmojiChristmasTree ReactionEmoji = "🎄"
|
||||
ReactionEmojiSnowman ReactionEmoji = "☃"
|
||||
ReactionEmojiNailPolish ReactionEmoji = "💅"
|
||||
ReactionEmojiZanyFace ReactionEmoji = "🤪"
|
||||
ReactionEmojiMoai ReactionEmoji = "🗿"
|
||||
ReactionEmojiCool ReactionEmoji = "🆒"
|
||||
ReactionEmojiHeartWithArrow ReactionEmoji = "💘"
|
||||
ReactionEmojiHearNoEvil ReactionEmoji = "🙉"
|
||||
ReactionEmojiUnicorn ReactionEmoji = "🦄"
|
||||
ReactionEmojiKissingFace ReactionEmoji = "😘"
|
||||
ReactionEmojiPill ReactionEmoji = "💊"
|
||||
ReactionEmojiSpeakNoEvil ReactionEmoji = "🙊"
|
||||
ReactionEmojiSmilingFaceWithSunglasses ReactionEmoji = "😎"
|
||||
ReactionEmojiAlienMonster ReactionEmoji = "👾"
|
||||
ReactionEmojiManShrugging ReactionEmoji = "🤷♂"
|
||||
ReactionEmojiPersonShrugging ReactionEmoji = "🤷"
|
||||
ReactionEmojiWomanShrugging ReactionEmoji = "🤷♀"
|
||||
ReactionEmojiPoutingFace ReactionEmoji = "😡"
|
||||
)
|
||||
```
|
||||
|
||||
<a name="ReactionType"></a>
|
||||
## type [ReactionType](<https://github.com/lukaszraczylo/go-telegram/blob/main/api/types.gen.go#L3433>)
|
||||
|
||||
@@ -11348,7 +11461,7 @@ type ReactionTypeEmoji struct {
|
||||
// Type of the reaction, always “emoji”
|
||||
Type ReactionTypeKind `json:"type"`
|
||||
// Reaction emoji. Currently, it can be one of "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""
|
||||
Emoji string `json:"emoji"`
|
||||
Emoji ReactionEmoji `json:"emoji"`
|
||||
}
|
||||
```
|
||||
|
||||
@@ -12150,7 +12263,7 @@ type SendDiceParams struct {
|
||||
// Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat
|
||||
DirectMessagesTopicID *int64 `json:"direct_messages_topic_id,omitempty"`
|
||||
// Emoji on which the dice throw animation is based. Currently, must be one of “”, “”, “”, “”, “”, or “”. Dice can have values 1-6 for “”, “” and “”, values 1-5 for “” and “”, and values 1-64 for “”. Defaults to “”
|
||||
Emoji string `json:"emoji,omitempty"`
|
||||
Emoji DiceEmoji `json:"emoji,omitempty"`
|
||||
// Sends the message silently. Users will receive a notification with no sound.
|
||||
DisableNotification *bool `json:"disable_notification,omitempty"`
|
||||
// Protects the contents of the sent message from forwarding
|
||||
|
||||
Reference in New Issue
Block a user