ScuroNeko/Laniakea
1
1
Fork 0
Code Issues 1 Pull Requests Actions Packages Releases 27 Wiki Activity
REPOSITORY / ScuroNeko/Laniakea

Releases

RELEASES REPOSITORY

27 Releases 77 Tags

RSS Feed
  • v1.0.0-rc.10 158625c220
    Compare

    1.0.0 RC 10 Pre-Release

    ScuroNeko released this 2026-03-25 18:07:41 +03:00 | 57 commits to dev since this release

    Added

    • Plugin.AddUpdateHandler for routing non-command Telegram updates by tgapi.UpdateType.
    • Derived tgapi.Update.Type assignment during JSON decoding, plus tgapi.UpdateTypeUnknown for unmatched payloads.
    • tgapi.API.OpenFileByLink(...) and OpenFileByLinkWithContext(...) for streaming downloads from Telegram's file server.
    • Regression tests for update dispatch, keyboard builders, localization fallback, runners, rate limiting, parse mode encoding, streaming downloads, and context isolation.
    • Regression tests for bot single-run enforcement, nil plugin registration, L10n concurrent access, API.Close() idle-connection cleanup, and tgapi worker-pool edge cases.
    • SEMVER.md documenting versioning expectations for the project.

    Changed

    • NewBot now returns (*Bot[T], error) instead of terminating the host process on configuration or startup failures.
    • Run and RunWithContext now return errors; RunWithContext returns ErrNoPrefixes and ErrNoPlugins for invalid bot configuration.
    • Polling retries now use exponential backoff instead of busy-looping on repeated getUpdates failures.
    • Bot is now explicitly single-use; repeated Run() or RunWithContext(...) calls return ErrBotAlreadyRun.
    • Database context wiring now uses T consistently instead of forcing *T; shared dependencies should typically use pointer types such as *sql.DB.
    • DatabaseContext, GetDBContext, and DbLogger were updated to the new T-based dependency model.
    • DatabaseContext(...) now warns once when T is a value type, to highlight likely unintended copying of shared dependencies.
    • AddDatabaseLoggerWriter(...) now skips unset and nil database contexts instead of calling the writer with invalid values.
    • L10n is now safe for concurrent use and copies added dictionary entries to avoid external mutation after registration.
    • Plugin registration now snapshots commands, payloads, middlewares, and update handlers so later mutations of the original *Plugin do not leak into the bot.
    • AddPlugins(...) now skips nil plugin pointers instead of panicking.
    • GetUpdateTypes() now returns a copy instead of exposing internal slice state.
    • Update handling now normalizes MsgContext for more Telegram update kinds and routes plugin-level update handlers with isolated context copies.
    • message, channel_post, and callback_query remain on the command/payload flow; non-command updates can be handled through plugin update handlers.
    • Command auto-generation now validates Telegram command names with the correct character set and 1..32 length limit, and emits commands in deterministic sorted order.
    • Builder-style APIs were normalized to value returns for NewCommandArg, NewMiddleware, NewRunner, and NewCallbackData.
    • MenuButton replaced BaseMenuButton, and GetChatMenuButton(...) now returns the renamed type.
    • Several Telegram DTOs were tightened for optionality and serialization correctness, including InputPaidMedia, MenuButton, optional gift fields, and message entity slices.
    • tgapi.NewRequest(...), NewRequestWithChatID(...), NewUploaderRequest(...), and NewUploaderRequestWithChatID(...) are now documented as low-level unsafe escape hatches rather than internal helpers.
    • tgapi.API.Close() now closes idle HTTP connections before releasing logger resources.
    • Multipart form encoding now writes scalar field bytes directly instead of converting through temporary strings.
    • README, README_RU, package docs, and exported godoc were updated to match the current APIs and concurrency/lifecycle model.
    • Version constants were bumped to v1.0.0-rc.10.

    Fixed

    • Required command arguments are now enforced by declared argument index, not only by total required count.
    • ParseNone now omits parse_mode from JSON requests instead of serializing "None".
    • Upload file type detection is now case-insensitive for file extensions.
    • Draft creation no longer panics when no limiter is configured, and draft flushing now rejects zero chat IDs before sending invalid requests.
    • Channel posts with SenderChat no longer panic in the command path and now preserve the expected MsgContext fields.
    • File logger initialization now falls back to stdout loggers instead of terminating the process on logger setup failures.
    • GetChatMenuButton and SetChatMenuButton now serialize chat_id correctly when omitted.
    • Update decoding tests now match the canonical deleted_business_messages model and no longer rely on the removed singular alias.

    Breaking Changes

    • NewBot[T](opts) now returns (*Bot[T], error).
    • Run() now returns error.
    • RunWithContext(ctx) now returns error.
    • Run() and RunWithContext(ctx) are now single-use per bot instance; create a new Bot after they return.
    • Database context handlers now receive T instead of *T. For shared dependencies, instantiate the bot with a pointer type, for example Bot[*sql.DB].
    • DatabaseContext(...) now takes T instead of *T.
    • GetDBContext() now returns T instead of *T.
    • DbLogger[T] now receives T instead of *T.
    • NewCommandArg(...), NewMiddleware(...), NewRunner(...), and NewCallbackData(...) now return values instead of pointers.
    • BaseMenuButton was renamed to MenuButton, and GetChatMenuButton(...) now returns MenuButton.
    • tgapi.Update no longer exposes the deprecated DeletedBusinessMessage alias; use DeletedBusinessMessages.

    Tests

    • Added coverage for polling backoff helpers, command sorting, database logger safety checks, update handler routing, update-context isolation, channel posts with SenderChat, parse mode encoding, streaming downloads, and rate limiter behavior.

    Full Changelog: v1.0.0-rc.9...v1.0.0-rc.10

    Downloads
  • v1.0.0-rc.7 7776acaf12
    Compare

    1.0.0 RC 7 Pre-Release

    ScuroNeko released this 2026-03-24 13:45:19 +03:00 | 63 commits to dev since this release

    Release Notes

    • Extracted shared logger construction into package-level helpers: utils.CreateLogger(prefix, level) and utils.CreateFileLogger(prefix, level, filePath).
    • Unified logger initialization across Bot, tgapi.API, and tgapi.Uploader.
    • Added MsgContext.Logger, populated from the matched plugin and falling back to the bot logger when no plugin logger is configured.
    • Added plugin lifecycle/configuration methods: SetLogger, RemoveLogger, SetOnClose, and Close.
    • Bot.Close() now performs local resource teardown only and also invokes Plugin.Close() for registered plugins.
    • Added Bot.CloseRemote(ctx) for Telegram Bot API close, separating remote close from local cleanup.
    • Renamed local tgapi.API shutdown to Close().
    • Renamed Telegram Bot API close wrappers in tgapi.API to CloseRemote() and CloseRemoteWithContext().
    • Bot.Debug() now updates log levels for the bot logger, request logger, and already registered plugin loggers.
    • Bot.AddPlugins() now creates a default plugin logger automatically when one is not provided.
    • Bot.AddDatabaseLoggerWriter() now also attaches the writer to already registered plugin loggers.
    • Updated tests for the new shutdown and logging behavior.
    • Expanded godoc for the new APIs and documented plugin registration as a configuration commit point.

    Breaking Changes

    • (*Bot).Close(ctx context.Context) was replaced with (*Bot).Close().
    • (*Bot).CloseRemote(ctx context.Context) was added as the explicit wrapper for Telegram Bot API close.
    • (*tgapi.API).CloseApi() was renamed to (*tgapi.API).Close().
    • (*tgapi.API).Close() was renamed to (*tgapi.API).CloseRemote().
    • (*tgapi.API).CloseWithContext() was renamed to (*tgapi.API).CloseRemoteWithContext().

    Migration Guide

    • Replace bot.Close(ctx) with bot.Close().
    • If you need Telegram Bot API close, use bot.CloseRemote(ctx).
    • Replace api.CloseApi() with api.Close().
    • Replace api.Close() with api.CloseRemote().
    • Replace api.CloseWithContext(ctx) with api.CloseRemoteWithContext(ctx).
    • If you configure plugin loggers or OnClose, do so before calling bot.AddPlugins(...).

    Notes

    • Registering a plugin via AddPlugins is a configuration commit point; the plugin should not be mutated through the original *Plugin afterward.
    • If plugin loggers must receive a database writer, call AddDatabaseLoggerWriter(...) after registering plugins.

    Full Changelog: v1.0.0-rc.5...v1.0.0-rc.7

    Downloads
  • v1.0.0-rc.4 6b9075c722
    Compare

    1.0.0 RC 4 Pre-Release

    ScuroNeko released this 2026-03-19 15:10:49 +03:00 | 67 commits to dev since this release

    What's New

    Context-aware method coverage

    Added WithContext variants across tgapi API and uploader methods so callers can pass cancellation/deadline contexts consistently.

    Documentation improvements

    Improved GoDoc for new context-aware methods and updated See references to method-specific Telegram Bot API anchors.

    Telegram API compatibility fixes

    Adjusted several request parameter structs to match current Telegram Bot API docs:

    • EditMessageTextP: added entities, link_preview_options
    • EditMessageCaptionP: added caption_entities, show_caption_above_media
    • StopPollP: now uses reply_markup (removed inline_message_id)
    • SendStickerP: added reply/suggested-post related fields
    • Added missing media thumbnail fields where applicable
    • SendDocumentP: added disable_content_type_detection
    • SendInvoiceP: removed unsupported business_connection_id

    Webhook certificate upload flow

    setWebhook certificate is now treated as multipart upload:

    • added uploader constant: UploaderCertificateType
    • added UploadSetWebhookP
    • added Uploader.SetWebhook(...) and Uploader.SetWebhookWithContext(...)
    • SetWebhookP no longer contains certificate; GoDoc points to uploader API for certificate upload

    Compatibility

    • Existing non-context methods remain available and unchanged in call style (Do(...) path preserved).
    • Users sending webhook certificates via JSON SetWebhookP.Certificate must migrate to Uploader.SetWebhook(...).

    Full Changelog: v1.0.0-rc.3...v1.0.0-rc.4

    Downloads
  • v1.0.0-rc.3 c59dd1fe8e
    Compare

    1.0.0 RC 3 Pre-Release

    ScuroNeko released this 2026-03-19 14:16:31 +03:00 | 69 commits to dev since this release

    Changelog

    Fixed

    • Stopped the update polling loop from logging and retrying after context.Canceled during shutdown.
    • Removed the extra retry delay on canceled polling requests so RunWithContext can exit immediately when the bot is stopping.

    Changed

    • Bumped version to v1.0.0-rc.3.
    • Kept shutdown behavior explicit: callers remain responsible for invoking Close() after RunWithContext returns.

    Full Changelog: v1.0.0-rc.2...v1.0.0-rc.3

    Downloads
  • v1.0.0-rc.2 2fc171d9a3
    Compare

    1.0.0 RC 2 Pre-Release

    ScuroNeko released this 2026-03-19 14:07:03 +03:00 | 70 commits to dev since this release

    Changelog

    Fixed

    • Fixed a shutdown crash caused by DatabaseWriter calling Close() through an uninitialized embedded logger writer.
    • Fixed bot shutdown hanging during Telegram long polling by making update polling use a cancelable context.
    • Reduced the chance of container termination with exit code 137 during shutdown by allowing getUpdates to stop promptly on cancellation.

    Changed

    • Switched the project to use the local laniakea replacement for the shutdown fix.
    • Updated laniakea docs to clarify lifecycle behavior: RunWithContext no longer closes resources automatically, and callers must invoke Close() explicitly.
    • Updated Updates documentation to describe context-driven cancellation behavior.

    Tests

    • Added regression tests for the database logger writer shutdown behavior.

    Full Changelog: v1.0.0-rc.1...v1.0.0-rc.2

    Downloads
  • v1.0.0-rc.1 4ebe76dd4a
    Compare

    1.0.0 RC 1 Pre-Release

    ScuroNeko released this 2026-03-17 16:17:26 +03:00 | 71 commits to dev since this release

    Downloads
  • v1.0.0-beta.22 1e043da05d
    Compare

    1.0.0 Beta 22 Pre-Release

    ScuroNeko released this 2026-03-17 13:24:12 +03:00 | 72 commits to dev since this release

    Downloads
  • v1.0.0-beta.21 389ec9f9d7
    Compare

    1.0.0 Beta 21 Pre-Release

    ScuroNeko released this 2026-03-16 10:39:33 +03:00 | 73 commits to dev since this release

    Downloads
  • v1.0.0-beta.20 fb81bb91bd
    Compare

    1.0.0 Beta 20 Pre-Release

    ScuroNeko released this 2026-03-13 13:37:20 +03:00 | 74 commits to dev since this release

    Downloads
  • v1.0.0-beta.19 5976fcd0b8
    Compare

    1.0.0 Beta 19 Pre-Release

    ScuroNeko released this 2026-03-13 12:25:53 +03:00 | 76 commits to dev since this release

    Downloads