1.14.1 - Patch release

[DennisDyallo]

1.14.1

Release date: October 23rd, 2025

This patch release addresses critical stability issues in the YubiKey device listener system across all platforms (Windows, macOS, Linux). The primary focus is on improving resource management, disposal patterns, and exception handling to prevent memory leaks, orphaned threads, and race conditions during device enumeration and monitoring.

Bug Fixes:

• Fixed critical disposal timing and resource management issues in DesktopSmartCardDeviceListener and WindowsHidDeviceListener to prevent resource leaks and ensure idempotent disposal operations. (#325)
• Corrected race conditions in the StopListening method across multiple device listeners that could cause deadlocks or orphaned resources. (#325)
• MacOS: Fixed delegate lifecycle issue that could cause callbacks on disposed delegates. (#325, #320)
• Added comprehensive try-catch blocks around event handler invocations to prevent user exceptions from crashing background listener threads. (#325)
• Wrapped listener thread logic in try-catch blocks for MacOSHidDeviceListener, DesktopSmartCardDeviceListener, and LinuxHidDeviceListener with improved logging. (#325)
• Added try-catch around cleanup in ListeningThread to prevent P/Invoke exceptions during shutdown. (#325)
• Enhanced device update logic and event firing to prevent deadlocks. (#325)
• Linux: Corrected file descriptor type from pointer to int in PollFd.fd to align with Linux pollfd struct specification and ensure compatibility with poll() system call. (#325)
• Windows: Enhanced CmDevice initialization and error handling during device enumeration. (#318)
• Windows: Wrapped Windows HID event handler logic inside try-catch blocks. (#318, #144)
• Fixed logic in FIDO2 AddPermissions that was incorrectly throwing exceptions. (#316)
• Refactored authentication token retrieval to use more suitable logic in FIDO2 GetAuthToken. (#316)

Features:

• Implemented polling mechanism for udev events in Linux HID device listener to improve responsiveness during shutdown (#325)
• Added comprehensive disposal pattern implementation for smartcardDeviceListener with proper resource cleanup. (#325)

Testing:

• Added comprehensive manual and stress tests for HID device listener to verify device arrival/removal events with detailed execution instructions. (#325)
• Added integration tests for SmartCard device listener with support for rapid insertion/removal scenarios. (#325)
• Introduced disposal and resource management tests for Linux, macOS, and Windows HID Device Listeners with thread safety and timing validations. (#325)

Refactoring:

• Centralized timeout configurations across HID and SmartCard listeners with shared constants (MaxDisposalWaitTime, CheckForChangesWaitTime) for uniform timing behaviors. (#325)
• Improved disposal timing and handler invocation consistency in YubiKeyDeviceListener. (#325)

Dependencies:

• Updated Microsoft Extensions packages from 9.0.9 to 9.0.10: Microsoft.Bcl.AsyncInterfaces, Microsoft.Bcl.Cryptography, Microsoft.Extensions.Configuration.Json, Microsoft.Extensions.Logging.Abstractions, Microsoft.Extensions.Logging.Console, Microsoft.Extensions.Options.ConfigurationExtensions, System.Configuration.ConfigurationManager, System.Formats.Asn1, System.Formats.Cbor. (#317, #327)
• Updated test frameworks: Microsoft.NET.Test.Sdk (17.10.0 → 18.0.0), coverlet.collector (6.0.2 → 6.0.4), xunit (2.8.1 → 2.9.3), xunit.runner.visualstudio (2.8.1/3.1.4 → 3.1.5), Xunit.SkippableFact (1.4.13 → 1.5.23). (#317)
• Updated build tools: Microsoft.SourceLink.GitHub (1.1.1 → 8.0.0). (#317)

Documentation:

• Fixed FIDO2 PIN information and general improvements in FIDO2/U2F documentation. (#321)
• Edited product name references for consistency. (#322)
• Removed statements in U2F documentation that were redundant with FIDO2 docs. (#322)

Miscellaneous:

• Removed deprecated PythonForNet example files and project configuration. (#325)
• Updated dev-container configuration. (#325)

---

This discussion was created from the release 1.14.1 - Patch release.