Added #

• Network stability improvements:
  • Introduced RetryPolicy and retry() utility (lib/src/net/retry.dart)
  • Applied retry to OAuth server info fetch, token exchange, MiAuth check API, and /api/i user fetch
• Default networking timeouts (overridable): connect 10s / send 20s / receive 20s
  • MisskeyOAuthClient, MisskeyMiAuthClient, and MisskeyAuthManager now accept timeout overrides
• Documentation:
  • Added API doc comments for AccountKey, StoredToken, AccountEntry, TokenStore, SecureTokenStore, and MisskeyAuthManager

Changed #

• /api/i request now follows common Misskey style: send token in JSON body with {"i": "<token>"} (instead of Authorization header)
• Dio now receives Map bodies directly (Dio handles JSON encoding internally)

Removed #

• Unused/duplicated config model: lib/src/models/auth_config.dart
• Accidental lib/main.dart (prevented dartdoc pollution; example retains its own main)

Added #

• Multi-account token management via TokenStore abstraction
• Default secure implementation: SecureTokenStore (backed by flutter_secure_storage)
• High-level API MisskeyAuthManager to orchestrate OAuth/MiAuth authentication and token persistence
• Models and types for account/token management: StoredToken, AccountKey, AccountEntry
• Public exports for store/manager types from misskey_auth.dart

Changed #

• MisskeyOAuthClient and MisskeyMiAuthClient no longer persist tokens; they only perform the authentication flow and return results
• Constructors now focus on networking concerns (Dio and timeouts)

Removed #

• Storage-related APIs from clients:
  • MisskeyOAuthClient.getStoredAccessToken()
  • MisskeyOAuthClient.clearTokens()
  • MisskeyMiAuthClient.getStoredAccessToken()
  • MisskeyMiAuthClient.clearTokens()
• MisskeyMiAuthClient constructor parameter for storage injection

Breaking Changes #

• Removed storage APIs from both MisskeyOAuthClient and MisskeyMiAuthClient (use MisskeyAuthManager and TokenStore instead)
• MisskeyMiAuthClient constructor signature changed (storage parameter removed)
• Token lifecycle (save/read/delete) responsibilities moved from clients to TokenStore/MisskeyAuthManager

Added #

• MiAuth authentication support - Alternative authentication method for Misskey servers
• Comprehensive error handling system - Granular exception classes for different error scenarios

Changed #

• Error handling architecture - Replaced generic exceptions with specific MisskeyAuthException subclasses
• OAuth client improvements - Enhanced error mapping and better exception handling
• MiAuth client implementation - Complete MiAuth authentication flow with proper error handling

Features #

• MisskeyMiAuthClient - Main MiAuth authentication client
• MisskeyMiAuthConfig - Configuration class for MiAuth authentication
• MiAuthTokenResponse - Response model for MiAuth authentication
• Enhanced exception classes including:
  • OAuthNotSupportedException - Server doesn't support OAuth 2.0
  • MiAuthDeniedException - User denied MiAuth permission
  • NetworkException - Network connectivity issues
  • UserCancelledException - User cancelled authentication
  • CallbackSchemeErrorException - URL scheme configuration errors
  • And 15+ more specific exception classes

Changed #

• Platform support is now limited to iOS and Android only.

Added #

• Initial beta release
• OAuth 2.0 authentication for Misskey servers (v2023.9.0+)
• External browser authentication (no embedded WebViews)
• Secure token storage using flutter_secure_storage
• PKCE (Proof Key for Code Exchange) implementation
• Custom URL scheme handling for authentication callbacks
• Cross-platform support (iOS/Android)

Features #

• MisskeyOAuthClient - Main authentication client
• MisskeyOAuthConfig - Configuration class for authentication
• Comprehensive error handling with custom exceptions
• Support for custom callback schemes