Merge pull request #18 from hpkv-io/feature/add-throttle

## Description

This pull request introduces a comprehensive adaptive request throttling system to the HPKV WebSocket Client SDK along with significant code restructuring and documentation improvements.

### Throttling Feature
- Added an **adaptive request throttling system** that dynamically adjusts request rates based on:
  - Network latency (Round Trip Time measurements)
  - Server responses (handling 429 Too Many Requests errors)
  - Configurable rate limits
- Implemented queue management to ensure requests are processed optimally
- Added exponential backoff for handling rate-limited scenarios
- Provided monitoring capabilities for throttling metrics

### Code Refactoring
- Reorganized file structure for better modularity:
  - Moved token management to utilities directory
  - Restructured WebSocket adapters for browser and Node.js environments
  - Consolidated exports in index files
- Enhanced error handling and message processing
- Improved type definitions and interfaces for better type safety
- Created new `SimpleEventEmitter` for efficient event handling

### Documentation Updates
- Added comprehensive documentation for the throttling feature in README.md
- Included configuration examples and monitoring instructions
- Added a table of contents for better navigation

Author: ehsanaslani

README.md

@@ -35,6 +35,8 @@ Currently, only the NodeJS SDK is available, with more language implementations
 ## Available SDKs
 
 ### NodeJS
+[![npm version](https://img.shields.io/npm/v/@hpkv/websocket-client.svg)](https://www.npmjs.com/package/@hpkv/websocket-client)
+[![npm downloads](https://img.shields.io/npm/dm/@hpkv/websocket-client.svg)](https://www.npmjs.com/package/@hpkv/websocket-client)
 
 - [NodeJS SDK Documentation](sdk/node/README.md)
 - Installation: `npm install @hpkv/websocket-client`
@@ -86,7 +88,7 @@ npm install @hpkv/websocket-client
 
 - [HPKV Overview](https://hpkv.io/docs/overview)
 - [WebSocket API Documentation](https://hpkv.io/docs/websocket-api)
-- [Getting Started Guide](https://hpkv.io/docs/getting-started)
+- [SDKs Documentation](https://hpkv.io/docs/sdk-guides)
 - [Real-time Pub-Sub Blog Post](https://hpkv.io/blog/2025/03/real-time-pub-sub)
 
 ## License

sdk/node/CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to the HPKV WebSocket Client SDK will be documented in this
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.7] - Released at 2025-04-27
+### Added
+- Dynamic Request Throttling feature
+
 ## [1.2.6] - Released at 2025-04-22
 ### Changed
 - Enhanced connection and error management