Table of Contents

v1.1.4 "Chōwa" - Interface Harmony

Release Date: July 21, 2025
Code Name: "Chōwa" (調和 - Harmony)
Type: Patch Release

🎯 Overview

Version 1.1.4 is a patch release focused on improving the clarity and harmony of WebSocket interface naming conventions. This release addresses developer feedback about confusing interface names, making the Jiro.Shared library more intuitive and easier to understand for developers integrating with the ecosystem.

✨ Features Added

  • Clearer Interface Naming: Renamed WebSocket interfaces to better reflect their purpose and communication direction.
  • Improved Developer Experience: Interface names now immediately convey whether they handle server-to-client or client-to-server communication.

🐛 Bug Fixes

  • N/A (No user-facing bugs fixed in this release)

🔄 Changes

Interface Renames

  • IJiroClient → IServerToClientEvents: Now clearly indicates this interface handles server-to-client push events.
  • IJiroHubClient → IClientToServerResponses: Now clearly indicates this interface handles client-to-server responses in strongly-typed hubs.
  • IJiroSocketClient → IJiroClient: Simplified naming for the main client implementation interface.

Documentation Updates

  • Updated all XML documentation to reflect the new interface purposes.
  • Enhanced region names within interfaces for better code organization.
  • Improved method and event descriptions for clarity.

🛠️ Technical Details

  • Breaking Change: This is a breaking change for consumers using the old interface names. Update your code to use the new interface names.
  • Migration Path: Simple find-and-replace of interface names in consuming code.
  • Type Safety: All functionality remains unchanged; only names have been updated.
  • Documentation: Comprehensive XML documentation updated throughout.

💻 Migration Guide

// Old usage
public class MyHub : Hub<IJiroClient> { }
public class MyClient : IJiroSocketClient { }

// New usage
public class MyHub : Hub<IServerToClientEvents> { }
public class MyClient : IJiroClient { }

🚀 Deployment

  • Version 1.1.4 has been built, tested, and is ready for deployment to NuGet.org.
  • All tests pass on .NET 9.0 runtime.
  • Package metadata updated with latest version information.

Note: This release brings harmony to the interface naming conventions, making the Jiro.Shared library more approachable and reducing cognitive load for developers working with the WebSocket communication layer.

Edit this page