v3.0.2

changelog.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 2025-11-24 - 3.0.2 - fix(readme)
+Update README to document 3.0.0+ changes: architecture refactor, streaming improvements, health check and circular dependency fixes
+
+- Documented major refactor to a Clean OOP / Facade pattern with DockerHost as the single entry point
+- Added/clarified real-time container streaming APIs: streamLogs(), attach(), exec()
+- Clarified support for flexible descriptors (accept both string references and class instances)
+- Documented complete container lifecycle API (start, stop, remove, logs, inspect, stats)
+- Documented new ping() health check method to verify Docker daemon availability
+- Noted fix for circular dependency issues in Node.js by using type-only imports
+- Mentioned improved TypeScript definitions and expanded examples, migration guides, and real-world use cases
+
 ## 2025-11-24 - 3.0.1 - fix(classes.base)
 Use type-only import for DockerHost in classes.base to avoid runtime side-effects
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apiclient.xyz/docker",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Provides easy communication with Docker remote API from Node.js, with TypeScript support.",
   "private": false,
   "main": "dist_ts/index.js",

readme.md

@@ -904,15 +904,17 @@ async function healthCheckService() {
 
 ## 🆕 Recent Updates
 
-### Version 2.1.0 - Architecture & Features
+### Version 3.0.0+ - Architecture & Stability
 
 - ✨ **Clean OOP Architecture**: Refactored to Facade pattern with DockerHost as single entry point
-- ✨ **Container Streaming**: Added `streamLogs()`, `attach()`, and `exec()` methods
-- ✨ **Flexible Descriptors**: Support both string references and class instances
-- ✨ **Complete Container API**: All lifecycle methods (start, stop, remove, logs, inspect, stats)
-- ✨ **DockerResource Base Class**: Consistent patterns across all resources
-- 🔧 **Improved Type Safety**: Better TypeScript definitions throughout
-- 📚 **Enhanced Documentation**: Comprehensive examples and migration guides
+- ✨ **Container Streaming**: Real-time `streamLogs()`, `attach()`, and `exec()` methods for interactive containers
+- ✨ **Flexible Descriptors**: Support both string references and class instances in all creation methods
+- ✨ **Complete Container API**: Full lifecycle methods (start, stop, remove, logs, inspect, stats)
+- ✨ **DockerResource Base Class**: Consistent patterns and type safety across all resources
+- ✨ **Health Check Support**: New `ping()` method to verify Docker daemon availability
+- 🐛 **Fixed Circular Dependencies**: Resolved Node.js module loading issues with type-only imports
+- 🔧 **Improved Type Safety**: Better TypeScript definitions and interfaces throughout
+- 📚 **Enhanced Documentation**: Comprehensive examples, migration guides, and real-world use cases
 
 ## License and Legal Information
 

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@apiclient.xyz/docker',
-  version: '3.0.1',
+  version: '3.0.2',
   description: 'Provides easy communication with Docker remote API from Node.js, with TypeScript support.'
 }