CHANGELOG.md

Changelog

本文件記錄 fhsh-oauth-py-sdk 的所有重要變更。

格式基於 Keep a Changelog， 版本號遵循 Semantic Versioning。

[0.2.0] - 2026-02-09

🔧 修復

• API 端點路徑修正：修正 get_userinfo() 和 get_discovery() 端點路徑以符合 OpenAPI 規範
  • /userinfo → /oauth2/userinfo
  • /.well-known/openid-configuration → /oauth2/.well-known/openid-configuration

🔒 安全性

• 強化 mask_token() 函式，支援 None 和空字串處理
• 新增安全性警告文件，避免 client_secret 被記錄至日誌

✨ 新增

• 新增 HTTPValidationError 模型，對應 OpenAPI 規範的驗證錯誤格式
• 新增 ValidationErrorDetail 模型
• 新增完整測試套件：
  • test_security.py - 安全性測試
  • test_models.py - 模型測試

📚 文件

• 新增 CHANGELOG.md 變更日誌
• 新增 docs/USAGE.md 詳細使用說明
• 新增 docs/EXAMPLE.md 進階範例
• 新增 example/ 可執行範例程式目錄

[0.1.0] - 2026-01-24

✨ 首次發布

• OAuth2 Authorization Code Flow 完整實作
• 同步版本 FHSHOAuthClient
• 非同步版本 AsyncFHSHOAuthClient
• 支援 Token 交換、更新、撤銷
• 支援 UserInfo 端點
• 支援 Token Introspection
• 支援 OIDC Discovery
• 完整 Pydantic 模型驗證
• HTTP/2 可選支援