@k-msg/core 0.1.5 → 0.2.0

package/README.md

@@ -17,6 +17,9 @@ bun add @k-msg/core
 - **Provider Management**: Multi-provider support and switching
 - **Feature Flags**: Configurable platform capabilities
 
+### 🔁 **Provider Rotation**
+- **RoundRobinRouterProvider**: Rotate across multiple upstream providers (round-robin)
+
 ### ⚠️ **Comprehensive Error Handling**
 - **KMessageError Hierarchy**: Structured error types for different scenarios
 - **Error Context**: Rich error information with operation context
@@ -59,6 +62,25 @@ const health = await platform.healthCheck();
 console.log(`Health: ${health.status}, Services: ${Object.keys(health.services).length}`);
 ```
 
+### Round-robin Provider Rotation
+
+```typescript
+import { RoundRobinRouterProvider, type BaseProvider } from "@k-msg/core";
+
+const router = new RoundRobinRouterProvider({
+  id: "router",
+  providers: [providerA, providerB] satisfies BaseProvider[],
+});
+
+await router.send({
+  channel: "SMS",
+  templateCode: "SMS_DIRECT",
+  phoneNumber: "01012345678",
+  variables: {},
+  text: "hello",
+});
+```
+
 ### Error Handling Patterns
 
 ```typescript
@@ -284,4 +306,4 @@ See the main [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
 
 ## License
 
-MIT License - see [LICENSE](../../LICENSE) for details.
+MIT License - see [LICENSE](../../LICENSE) for details.

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from "./provider";
 export * from "./provider-registry";
 export * from "./resilience/index";
 export * from "./result";
+export * from "./router/round-robin-router-provider";
 export * from "./test-utils";
 export * from "./types/index";
 export * from "./universal-provider";