Skip to content

TeleFlow 1.0.0-alpha.6

Pre-release
Pre-release

Choose a tag to compare

View all tags
@iriswolf iriswolf released this 01 Jul 14:14
v1.0.0-alpha.6
e0fcb4b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Summary

This alpha focuses on Microsoft.Extensions.Hosting integration, application lifecycle tasks, package graph naming stabilization, and release packaging hardening.

NuGet packages for 1.0.0-alpha.6 were published through the NuGet Trusted Publishing workflow and verified before this GitHub release.

Install

Handler-based long polling bot:

dotnet add package IWF.TeleFlow.Framework.LongPolling --prerelease
dotnet add package IWF.TeleFlow.Generators --prerelease
dotnet add package IWF.TeleFlow.Storage.Memory --prerelease

Optional Generic Host integration:

dotnet add package IWF.TeleFlow.Framework.Hosting --prerelease

Direct Telegram Bot API client:

dotnet add package IWF.TeleFlow.Telegram --prerelease

Added

  • Optional IWF.TeleFlow.Framework.Hosting package for running a configured TeleFlow application through Microsoft.Extensions.Hosting as an IHostedService.
  • Application startup and shutdown task contracts with DI registration helpers.
  • Lifecycle execution around update source startup and shutdown, including scoped task resolution, deterministic ordering, and failure propagation.

Changed

  • Framework runtime package names were stabilized before 1.0.0:
    • IWF.TeleFlow.Core became IWF.TeleFlow.Framework.Core.
    • IWF.TeleFlow.Telegram.Framework became IWF.TeleFlow.Framework.
    • IWF.TeleFlow.Telegram.Framework.LongPolling became IWF.TeleFlow.Framework.LongPolling.
    • IWF.TeleFlow.Telegram.Framework.Webhooks became IWF.TeleFlow.Framework.Webhooks.
  • Framework runtime namespaces now use TeleFlow.Framework.* instead of TeleFlow.Core.*.
  • Documentation and package descriptions now separate recommended entry packages from dependency and advanced packages.
  • Middleware options configuration is documented as normal .NET options configuration.
  • Release verification now checks that its packaged project list stays aligned with package smoke tests.

Fixed

  • Release verification now includes IWF.TeleFlow.Framework.Hosting, preventing a publish run from accidentally omitting the hosting package.

Deprecated

The old alpha package IDs were deprecated on NuGet with replacement package guidance:

  • IWF.TeleFlow.Core -> IWF.TeleFlow.Framework.Core.
  • IWF.TeleFlow.Telegram.Framework -> IWF.TeleFlow.Framework.
  • IWF.TeleFlow.Telegram.Framework.LongPolling -> IWF.TeleFlow.Framework.LongPolling.
  • IWF.TeleFlow.Telegram.Framework.Webhooks -> IWF.TeleFlow.Framework.Webhooks.

Breaking Changes

  • Applications using old alpha framework package IDs must migrate to the new IWF.TeleFlow.Framework.* package IDs.
  • Applications using TeleFlow.Core.* namespaces must migrate to TeleFlow.Framework.* namespaces.

Validation

  • NuGet Publish workflow completed successfully: https://github.com/IWFTech/TeleFlow/actions/runs/28522279727
  • Release-preparation checks for the changelog PR passed on Windows, Linux, and macOS.
  • A local smoke bot was built against the published 1.0.0-alpha.6 packages and manually checked through Telegram long polling.
Assets 2
Loading