@mhbdev/sms 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.2.4
+
+### Patch Changes
+
+- [#16](https://github.com/mhbdev/sms/pull/16) [`d248189`](https://github.com/mhbdev/sms/commit/d24818936f4b5be4362f7dce72d59e4c586e5625) Thanks [@dependabot](https://github.com/apps/dependabot)! - Update the runtime Zod dependency to 4.6.7 to include upstream security fixes.
+
+## 0.2.3
+
+### Patch Changes
+
+- [#12](https://github.com/mhbdev/sms/pull/12) [`1bca296`](https://github.com/mhbdev/sms/commit/1bca29622247b1f6297d57d921ecee0da83d22e8) Thanks [@mhbdev](https://github.com/mhbdev)! - Add `SmsProviderPool` with pluggable priority and weighted round-robin routing,
+  provider health tracking, safe send retry/failover, and typed adapters for
+  provider-specific batch operations. Send requests no longer use the legacy HTTP
+  retry policy; uncertain delivery outcomes stop with an explicit pool error.
+
 ## 0.2.2
 
 ### Patch Changes

package/README.md

@@ -21,19 +21,19 @@ npm install @mhbdev/sms
 import { KavenegarSmsProvider } from "@mhbdev/sms/kavenegar";
 
 const sms = new KavenegarSmsProvider({
-  apiKey: process.env.KAVENEGAR_API_KEY!,
-  sender: "90005738",
+	apiKey: process.env.KAVENEGAR_API_KEY!,
+	sender: "90005738",
 });
 
 await sms.sendMessage({
-  recipient: "+989121234567",
-  message: "Your order is ready.",
+	recipient: "+989121234567",
+	message: "Your order is ready.",
 });
 
 await sms.sendTemplate({
-  recipient: "+989121234567",
-  template: "my-otp-pattern",
-  parameters: ["123456"],
+	recipient: "+989121234567",
+	template: "my-otp-pattern",
+	parameters: ["123456"],
 });
 ```
 
@@ -42,9 +42,9 @@ options is the default sender number. A message-level `sender` overrides it:
 
 ```ts
 await sms.sendMessage({
-  recipient: "+989121234567",
-  message: "Sent from a specific line.",
-  sender: "10004346",
+	recipient: "+989121234567",
+	message: "Sent from a specific line.",
+	sender: "10004346",
 });
 ```
 
@@ -58,19 +58,19 @@ returned by Kavenegar is preserved in the normalized result when provided.
 import { SmsIrProvider } from "@mhbdev/sms/sms-ir";
 
 const sms = new SmsIrProvider({
-  apiKey: process.env.SMS_IR_API_KEY!,
-  lineNumber: "300000000000",
+	apiKey: process.env.SMS_IR_API_KEY!,
+	lineNumber: "300000000000",
 });
 
 await sms.sendMessage({
-  recipient: "09121234567",
-  message: "Your order is ready.",
+	recipient: "09121234567",
+	message: "Your order is ready.",
 });
 
 await sms.sendTemplate({
-  recipient: "09121234567",
-  templateId: 123456,
-  parameters: [{ name: "CODE", value: "123456" }],
+	recipient: "09121234567",
+	templateId: 123456,
+	parameters: [{ name: "CODE", value: "123456" }],
 });
 ```
 
@@ -106,13 +106,13 @@ because retrying after an unknown provider response can duplicate a paid SMS.
 
 ```ts
 const sms = new SmsIrProvider({
-  apiKey: process.env.SMS_IR_API_KEY!,
-  lineNumber: "300000000000",
-  retry: {
-    maxAttempts: 3,
-    initialDelayMs: 250,
-    maxDelayMs: 2_000,
-  },
+	apiKey: process.env.SMS_IR_API_KEY!,
+	lineNumber: "300000000000",
+	retry: {
+		maxAttempts: 3,
+		initialDelayMs: 250,
+		maxDelayMs: 2_000,
+	},
 });
 ```
 
@@ -120,6 +120,94 @@ Provider failures are represented by `KavenegarError` or `SmsIrError`. Errors
 retain their original `cause`, stable error codes, provider status, HTTP status,
 and retry metadata without including API keys in messages.
 
+Provider-level HTTP retries continue to apply to read operations. Send operations
+are issued once per provider attempt; the pool only retries or fails over when a
+provider explicitly reports that it rejected the send and marks that rejection
+retryable. Timeouts, connection loss, and server errors with an uncertain result
+produce an `SmsProviderPoolError` with `outcome: "unknown"` and stop routing.
+
+## Provider pools
+
+`SmsProviderPool` combines provider adapters for raw, template, bulk, and native
+batch sends. Adapters receive pool-neutral messages and can translate them to a
+provider's own template or batch contract. A provider without an adapter for an
+operation is skipped.
+
+```ts
+import {
+	PriorityRoutingStrategy,
+	SmsProviderPool,
+	WeightedRoundRobinStrategy,
+} from "@mhbdev/sms";
+import { KavenegarSmsProvider } from "@mhbdev/sms/kavenegar";
+import { SmsIrProvider } from "@mhbdev/sms/sms-ir";
+
+const kavenegar = new KavenegarSmsProvider({
+	apiKey: process.env.KAVENEGAR_API_KEY!,
+	sender: "90005738",
+});
+const smsIr = new SmsIrProvider({
+	apiKey: process.env.SMS_IR_API_KEY!,
+	lineNumber: "300000000000",
+});
+
+const pool = new SmsProviderPool({
+	strategy: new PriorityRoutingStrategy(), // Or new WeightedRoundRobinStrategy()
+	providers: [
+		{
+			name: "kavenegar",
+			priority: 1,
+			sendMessage: (message) => kavenegar.sendMessage(message),
+			sendTemplate: (message) => kavenegar.sendTemplate(message),
+			sendBulk: (message) => kavenegar.sendBulk(message),
+		},
+		{
+			name: "sms.ir",
+			priority: 2,
+			weight: 2,
+			sendMessage: (message) =>
+				smsIr.sendMessage({
+					recipient: message.recipient,
+					message: message.message,
+					sendAt: message.sendAt,
+					signal: message.signal,
+				}),
+			// Map portable template fields to SMS.ir's templateId and named parameters here.
+		},
+	],
+	circuitBreaker: { failureThreshold: 3, cooldownMs: 30_000 },
+});
+
+await pool.sendMessage({ recipient: "09121234567", message: "Your order is ready." });
+```
+
+Priority routing tries providers in ascending `priority` order (default `0`).
+Weighted round robin uses each provider's positive integer `weight` (default
+`1`) and keeps state per strategy instance. Both strategies return remaining
+eligible providers as failover candidates. Implement `SmsRoutingStrategy` to
+provide a custom ordering, or `SmsProviderHealth` to use external health state.
+For application adapters, set `deliveryOutcome: "rejected"` and
+`retryable: true` on a `SmsProviderError` only when the provider confirms the
+request was not accepted. Alternatively, use `classifyError` to map a provider's
+documented error responses to that classification; all unclassified errors stop
+with an unknown outcome.
+
+The default in-memory circuit breaker opens after three health failures for 30
+seconds, then permits one half-open probe. Set `circuitBreaker` to change those
+defaults or pass a custom `health` implementation. Health state is local to the
+pool instance. Optional `onEvent` reports selection, attempt, and circuit-state
+changes; observer exceptions do not affect delivery.
+
+Template adapters must map the template identifier and parameters explicitly.
+Batch adapters are operation specific (`sendArray` versus `sendLikeToLike`) and
+are never inferred.
+
+The pool defaults to one attempt per provider. `maxAttemptsPerProvider` and the
+backoff options enable retry after definitely rejected, retryable sends. They do
+not enable retry after unknown outcomes. This is a deliberate safety change from
+the legacy provider `retry` option: configured transport retries no longer replay
+send requests, while reads retain their existing retry behavior.
+
 ## Development
 
 ```sh

package/dist/contracts/pool.d.ts

@@ -0,0 +1,97 @@
+import type { SmsBatchMessage, SmsBulkMessage, SmsBulkSendResult, SmsMessage, SmsSendResult, SmsTemplateMessage } from "./sms.js";
+import type { SmsIrLikeToLikeMessage } from "./sms-ir.js";
+export type SmsPoolOperation = "sendMessage" | "sendTemplate" | "sendBulk" | "sendArray" | "sendLikeToLike";
+/** Adapters accept pool-neutral messages and translate to provider-specific inputs. */
+export type SmsProviderPoolEntry = Readonly<{
+    name: string;
+    /** Smaller values are preferred by priority routing. */
+    priority?: number;
+    /** Positive integer used by weighted round robin. */
+    weight?: number;
+    sendMessage?: (message: SmsMessage) => Promise<SmsSendResult>;
+    sendTemplate?: (message: SmsTemplateMessage) => Promise<SmsSendResult>;
+    sendBulk?: (message: SmsBulkMessage) => Promise<SmsBulkSendResult>;
+    /** Typed adapter for a provider's per-recipient batch operation. */
+    sendArray?: (messages: readonly SmsBatchMessage[], options?: Readonly<{
+        signal?: AbortSignal;
+    }>) => Promise<readonly SmsSendResult[]>;
+    /** Typed adapter for a provider's per-recipient-message batch operation. */
+    sendLikeToLike?: (message: SmsIrLikeToLikeMessage) => Promise<SmsBulkSendResult>;
+}>;
+export type SmsPoolFailureClassification = Readonly<{
+    outcome: "rejected" | "unknown";
+    retryable: boolean;
+    retryAfterMs?: number;
+    code?: string;
+    httpStatus?: number;
+    providerStatus?: number | string;
+}>;
+export type SmsPoolAttempt = Readonly<{
+    provider: string;
+    operation: SmsPoolOperation;
+    outcome: "accepted" | "rejected" | "unknown";
+    code?: string;
+    httpStatus?: number;
+    providerStatus?: number | string;
+    retryable?: boolean;
+}>;
+export type SmsPoolEvent = Readonly<{
+    type: "provider-selected";
+    provider: string;
+    operation: SmsPoolOperation;
+    attempt: number;
+}> | Readonly<{
+    type: "attempt-succeeded";
+    provider: string;
+    operation: SmsPoolOperation;
+    attempt: number;
+}> | Readonly<{
+    type: "attempt-failed";
+    provider: string;
+    operation: SmsPoolOperation;
+    attempt: number;
+    outcome: "rejected" | "unknown";
+    retryable: boolean;
+}> | Readonly<{
+    type: "circuit-state-changed";
+    provider: string;
+    state: SmsProviderCircuitState;
+}>;
+export type SmsProviderCircuitState = "closed" | "open" | "half-open";
+export type SmsRoutingContext = Readonly<{
+    operation: SmsPoolOperation;
+    providers: readonly SmsProviderPoolEntry[];
+}>;
+export interface SmsRoutingStrategy {
+    order(context: SmsRoutingContext): readonly string[];
+}
+export interface SmsProviderHealth {
+    getState(provider: string): SmsProviderCircuitState;
+    /** Acquires a normal slot or the single half-open probe slot. */
+    acquire(provider: string): boolean;
+    /** Releases an acquired half-open probe when no provider request was made. */
+    release(provider: string): void;
+    recordSuccess(provider: string): void;
+    recordFailure(provider: string): void;
+}
+export type SmsProviderPoolOptions = Readonly<{
+    providers: readonly SmsProviderPoolEntry[];
+    strategy?: SmsRoutingStrategy;
+    health?: SmsProviderHealth;
+    circuitBreaker?: Readonly<{
+        failureThreshold?: number;
+        cooldownMs?: number;
+        now?: () => number;
+    }>;
+    maxAttemptsPerProvider?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    sleep?: (delayMs: number, signal?: AbortSignal) => Promise<void>;
+    onEvent?: (event: SmsPoolEvent) => void;
+    classifyError?: (error: unknown, provider: SmsProviderPoolEntry, operation: SmsPoolOperation) => SmsPoolFailureClassification;
+}>;
+export type SmsPoolBatchInput = readonly SmsBatchMessage[];
+export type SmsPoolBatchResult = readonly SmsSendResult[];
+export type SmsPoolLikeToLikeInput = SmsIrLikeToLikeMessage;
+//# sourceMappingURL=pool.d.ts.map

package/dist/contracts/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/contracts/pool.ts"],"names":[],"mappings":"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"}

package/dist/contracts/pool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pool.js.map

package/dist/contracts/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/contracts/pool.ts"],"names":[],"mappings":""}

package/dist/errors/kavenegar-error.d.ts

@@ -6,6 +6,7 @@ export declare class KavenegarError extends SmsProviderError {
         providerStatus?: number | string;
         retryable?: boolean;
         retryAfterMs?: number;
+        deliveryOutcome?: "rejected" | "unknown";
     }>);
 }
 //# sourceMappingURL=kavenegar-error.d.ts.map

package/dist/errors/kavenegar-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kavenegar-error.d.ts","sourceRoot":"","sources":["../../src/errors/kavenegar-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,cAAe,SAAQ,gBAAgB;IACnD,YACC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAM,EAOP;CACD"}
+{"version":3,"file":"kavenegar-error.d.ts","sourceRoot":"","sources":["../../src/errors/kavenegar-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,cAAe,SAAQ,gBAAgB;IACnD,YACC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;KACzC,CAAM,EAOP;CACD"}

package/dist/errors/kavenegar-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"kavenegar-error.js","sourceRoot":"","sources":["../../src/errors/kavenegar-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IACnD,YACC,OAAe,EACf,OAAO,GAMF,EAAE;QAEP,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,IAAI,EAAE,iBAAiB;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD"}
+{"version":3,"file":"kavenegar-error.js","sourceRoot":"","sources":["../../src/errors/kavenegar-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IACnD,YACC,OAAe,EACf,OAAO,GAOF,EAAE;QAEP,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,IAAI,EAAE,iBAAiB;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD"}

package/dist/errors/sms-error.d.ts

@@ -5,6 +5,8 @@ export type SmsErrorOptions = Readonly<{
     providerStatus?: number | string;
     retryable?: boolean;
     retryAfterMs?: number;
+    /** Whether a send was definitely rejected or may have been accepted. */
+    deliveryOutcome?: "rejected" | "unknown";
 }>;
 export declare class SmsProviderError extends Error {
     readonly code: string;
@@ -13,6 +15,7 @@ export declare class SmsProviderError extends Error {
     readonly providerStatus?: number | string;
     readonly retryable?: boolean;
     readonly retryAfterMs?: number;
+    readonly deliveryOutcome?: "rejected" | "unknown";
     constructor(message: string, options?: SmsErrorOptions);
 }
 export declare class SmsValidationError extends SmsProviderError {

package/dist/errors/sms-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sms-error.d.ts","sourceRoot":"","sources":["../../src/errors/sms-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,QAAQ;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAQzD;CACD;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACvD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM,EAGvE;CACD;AAED,qBAAa,iBAAkB,SAAQ,gBAAgB;IACtD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM,EAGvE;CACD"}
+{"version":3,"file":"sms-error.d.ts","sourceRoot":"","sources":["../../src/errors/sms-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC,CAAC,CAAC;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,QAAQ;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAElD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EASzD;CACD;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACvD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM,EAGvE;CACD;AAED,qBAAa,iBAAkB,SAAQ,gBAAgB;IACtD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAM,EAGvE;CACD"}

package/dist/errors/sms-error.js

@@ -5,6 +5,7 @@ export class SmsProviderError extends Error {
     providerStatus;
     retryable;
     retryAfterMs;
+    deliveryOutcome;
     constructor(message, options = {}) {
         super(message, { cause: options.cause });
         this.name = "SmsProviderError";
@@ -13,6 +14,7 @@ export class SmsProviderError extends Error {
         this.providerStatus = options.providerStatus;
         this.retryable = options.retryable;
         this.retryAfterMs = options.retryAfterMs;
+        this.deliveryOutcome = options.deliveryOutcome;
     }
 }
 export class SmsValidationError extends SmsProviderError {

package/dist/errors/sms-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"sms-error.js","sourceRoot":"","sources":["../../src/errors/sms-error.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,IAAI,CAAS;IACb,aAAa,GAAG,IAAI,CAAC;IACrB,UAAU,CAAU;IACpB,cAAc,CAAmB;IACjC,SAAS,CAAW;IACpB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,OAAO,GAAoB,EAAE;QACzD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,oBAAoB,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1C,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACvD,YAAY,OAAe,EAAE,OAAO,GAAkC,EAAE;QACvE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACtD,YAAY,OAAe,EAAE,OAAO,GAAkC,EAAE;QACvE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD"}
+{"version":3,"file":"sms-error.js","sourceRoot":"","sources":["../../src/errors/sms-error.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,IAAI,CAAS;IACb,aAAa,GAAG,IAAI,CAAC;IACrB,UAAU,CAAU;IACpB,cAAc,CAAmB;IACjC,SAAS,CAAW;IACpB,YAAY,CAAU;IACtB,eAAe,CAA0B;IAElD,YAAY,OAAe,EAAE,OAAO,GAAoB,EAAE;QACzD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,oBAAoB,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAChD,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACvD,YAAY,OAAe,EAAE,OAAO,GAAkC,EAAE;QACvE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACtD,YAAY,OAAe,EAAE,OAAO,GAAkC,EAAE;QACvE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD"}

package/dist/errors/sms-ir-error.d.ts

@@ -6,6 +6,7 @@ export declare class SmsIrError extends SmsProviderError {
         providerStatus?: number | string;
         retryable?: boolean;
         retryAfterMs?: number;
+        deliveryOutcome?: "rejected" | "unknown";
     }>);
 }
 //# sourceMappingURL=sms-ir-error.d.ts.map

package/dist/errors/sms-ir-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sms-ir-error.d.ts","sourceRoot":"","sources":["../../src/errors/sms-ir-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,UAAW,SAAQ,gBAAgB;IAC/C,YACC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAM,EAOP;CACD"}
+{"version":3,"file":"sms-ir-error.d.ts","sourceRoot":"","sources":["../../src/errors/sms-ir-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,UAAW,SAAQ,gBAAgB;IAC/C,YACC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;KACzC,CAAM,EAOP;CACD"}

package/dist/errors/sms-ir-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"sms-ir-error.js","sourceRoot":"","sources":["../../src/errors/sms-ir-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IAC/C,YACC,OAAe,EACf,OAAO,GAMF,EAAE;QAEP,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,IAAI,EAAE,cAAc;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD"}
+{"version":3,"file":"sms-ir-error.js","sourceRoot":"","sources":["../../src/errors/sms-ir-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IAC/C,YACC,OAAe,EACf,OAAO,GAOF,EAAE;QAEP,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,IAAI,EAAE,cAAc;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD"}

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 export type { SmsHttpFetcher, SmsHttpOptions } from "./contracts/http.js";
 export type { KavenegarBulkRequest, KavenegarBulkResult, KavenegarCancellationResult, KavenegarCountQuery, KavenegarCountResult, KavenegarOutboxCountQuery, KavenegarReceivedMessage, KavenegarReceiveQuery, KavenegarSendArrayMessage, KavenegarSendResult, KavenegarSmsProviderOptions, KavenegarStatusQuery, KavenegarStatusResult, KavenegarTemplateMessage, } from "./contracts/kavenegar.js";
+export type { SmsPoolAttempt, SmsPoolBatchInput, SmsPoolBatchResult, SmsPoolEvent, SmsPoolFailureClassification, SmsPoolLikeToLikeInput, SmsPoolOperation, SmsProviderCircuitState, SmsProviderHealth, SmsProviderPoolEntry, SmsProviderPoolOptions, SmsRoutingContext, SmsRoutingStrategy, } from "./contracts/pool.js";
 export type { SmsBatchMessage, SmsBulkMessage, SmsBulkSender, SmsBulkSendResult, SmsCancellationResult, SmsCollection, SmsDeliveryStatus, SmsDeliveryStatusQuery, SmsDeliveryStatusReader, SmsInboxReader, SmsMessage, SmsMessageCancellationRequest, SmsMessageScheduler, SmsMessageSender, SmsPackScheduler, SmsPage, SmsReceivedMessage, SmsScheduler, SmsSendResult, SmsSendStatus, SmsTemplateMessage, SmsTemplateSender, } from "./contracts/sms.js";
 export type { SmsIrBulkMessage, SmsIrBulkSendResult, SmsIrCancellationResult, SmsIrLikeToLikeMessage, SmsIrMessage, SmsIrMessageStatus, SmsIrPackMessage, SmsIrPackQuery, SmsIrPackSummary, SmsIrParameter, SmsIrProviderOptions, SmsIrSendResult, SmsIrStatusQuery, SmsIrTemplateMessage, } from "./contracts/sms-ir.js";
 export { KavenegarError } from "./errors/kavenegar-error.js";
 export { SmsProviderError, SmsTransportError, SmsValidationError, } from "./errors/sms-error.js";
 export { SmsIrError } from "./errors/sms-ir-error.js";
+export type { InMemoryCircuitBreakerOptions } from "./pool/health.js";
+export { InMemoryCircuitBreaker } from "./pool/health.js";
+export { SmsProviderPool, SmsProviderPoolError } from "./pool/sms-provider-pool.js";
+export { PriorityRoutingStrategy, WeightedRoundRobinStrategy, } from "./pool/strategies.js";
 export { parseKavenegarCancellationResponse, parseKavenegarCountResponse, parseKavenegarPayload, parseKavenegarReceivedResponse, parseKavenegarResponse, parseKavenegarSendArrayResponse, parseKavenegarSendEntries, parseKavenegarStatusResponse, } from "./providers/kavenegar/kavenegar-api.js";
 export { KavenegarSmsProvider } from "./providers/kavenegar/kavenegar-sms-provider.js";
 export { parseSmsIrBulkResult, parseSmsIrCancellationResult, parseSmsIrMessageStatus, parseSmsIrPackMessages, parseSmsIrPackSummaries, parseSmsIrPayload, parseSmsIrSendResult, } from "./providers/sms-ir/sms-ir-api.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EACN,kCAAkC,EAClC,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EACN,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,aAAa,EACb,aAAa,IAAI,gBAAgB,GACjC,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACN,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,kCAAkC,EAClC,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EACN,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,aAAa,EACb,aAAa,IAAI,gBAAgB,GACjC,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,6 +1,9 @@
 export { KavenegarError } from "./errors/kavenegar-error.js";
 export { SmsProviderError, SmsTransportError, SmsValidationError, } from "./errors/sms-error.js";
 export { SmsIrError } from "./errors/sms-ir-error.js";
+export { InMemoryCircuitBreaker } from "./pool/health.js";
+export { SmsProviderPool, SmsProviderPoolError } from "./pool/sms-provider-pool.js";
+export { PriorityRoutingStrategy, WeightedRoundRobinStrategy, } from "./pool/strategies.js";
 export { parseKavenegarCancellationResponse, parseKavenegarCountResponse, parseKavenegarPayload, parseKavenegarReceivedResponse, parseKavenegarResponse, parseKavenegarSendArrayResponse, parseKavenegarSendEntries, parseKavenegarStatusResponse, } from "./providers/kavenegar/kavenegar-api.js";
 export { KavenegarSmsProvider } from "./providers/kavenegar/kavenegar-sms-provider.js";
 export { parseSmsIrBulkResult, parseSmsIrCancellationResult, parseSmsIrMessageStatus, parseSmsIrPackMessages, parseSmsIrPackSummaries, parseSmsIrPayload, parseSmsIrSendResult, } from "./providers/sms-ir/sms-ir-api.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyDA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EACN,kCAAkC,EAClC,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EACN,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,aAAa,EACb,aAAa,IAAI,gBAAgB,GACjC,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwEA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACN,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,kCAAkC,EAClC,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EACN,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,aAAa,EACb,aAAa,IAAI,gBAAgB,GACjC,MAAM,uCAAuC,CAAC"}

package/dist/pool/health.d.ts

@@ -0,0 +1,20 @@
+import type { SmsProviderCircuitState, SmsProviderHealth } from "../contracts/pool.js";
+export type InMemoryCircuitBreakerOptions = Readonly<{
+    failureThreshold?: number;
+    cooldownMs?: number;
+    now?: () => number;
+}>;
+export declare class InMemoryCircuitBreaker implements SmsProviderHealth {
+    private readonly circuits;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly now;
+    constructor(options?: InMemoryCircuitBreakerOptions);
+    getState(provider: string): SmsProviderCircuitState;
+    acquire(provider: string): boolean;
+    release(provider: string): void;
+    recordSuccess(provider: string): void;
+    recordFailure(provider: string): void;
+    private get;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/pool/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/pool/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB,CAAC,CAAC;AAIH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,YAAY,OAAO,GAAE,6BAAkC,EAQtD;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAKlD;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMjC;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE9B;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKpC;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOpC;IAED,OAAO,CAAC,GAAG;CAQX"}

package/dist/pool/health.js

@@ -0,0 +1,58 @@
+export class InMemoryCircuitBreaker {
+    circuits = new Map();
+    failureThreshold;
+    cooldownMs;
+    now;
+    constructor(options = {}) {
+        this.failureThreshold = options.failureThreshold ?? 3;
+        this.cooldownMs = options.cooldownMs ?? 30_000;
+        this.now = options.now ?? Date.now;
+        if (!Number.isSafeInteger(this.failureThreshold) || this.failureThreshold < 1)
+            throw new TypeError("Circuit failureThreshold must be a positive integer");
+        if (!Number.isFinite(this.cooldownMs) || this.cooldownMs < 0)
+            throw new TypeError("Circuit cooldownMs must be a non-negative number");
+    }
+    getState(provider) {
+        const circuit = this.get(provider);
+        if (circuit.openUntil === 0)
+            return "closed";
+        if (this.now() < circuit.openUntil)
+            return "open";
+        return "half-open";
+    }
+    acquire(provider) {
+        const circuit = this.get(provider);
+        if (circuit.openUntil === 0)
+            return true;
+        if (this.now() < circuit.openUntil || circuit.probeInFlight)
+            return false;
+        circuit.probeInFlight = true;
+        return true;
+    }
+    release(provider) {
+        this.get(provider).probeInFlight = false;
+    }
+    recordSuccess(provider) {
+        const circuit = this.get(provider);
+        circuit.failures = 0;
+        circuit.openUntil = 0;
+        circuit.probeInFlight = false;
+    }
+    recordFailure(provider) {
+        const circuit = this.get(provider);
+        circuit.probeInFlight = false;
+        circuit.failures += 1;
+        if (circuit.failures >= this.failureThreshold) {
+            circuit.openUntil = this.now() + this.cooldownMs;
+        }
+    }
+    get(provider) {
+        let circuit = this.circuits.get(provider);
+        if (!circuit) {
+            circuit = { failures: 0, openUntil: 0, probeInFlight: false };
+            this.circuits.set(provider, circuit);
+        }
+        return circuit;
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/pool/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/pool/health.ts"],"names":[],"mappings":"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"}

package/dist/pool/sms-provider-pool.d.ts

@@ -0,0 +1,46 @@
+import type { SmsPoolAttempt, SmsPoolOperation, SmsProviderPoolOptions } from "../contracts/pool.js";
+import type { SmsBatchMessage, SmsBulkMessage, SmsBulkSender, SmsBulkSendResult, SmsMessage, SmsMessageSender, SmsSendResult, SmsTemplateMessage, SmsTemplateSender } from "../contracts/sms.js";
+import type { SmsIrLikeToLikeMessage } from "../contracts/sms-ir.js";
+import { SmsProviderError } from "../errors/sms-error.js";
+export declare class SmsProviderPoolError extends SmsProviderError {
+    readonly operation: SmsPoolOperation;
+    readonly outcome: "unknown" | "rejected" | "unavailable";
+    readonly attempts: readonly SmsPoolAttempt[];
+    constructor(message: string, options: Readonly<{
+        operation: SmsPoolOperation;
+        outcome: "unknown" | "rejected" | "unavailable";
+        attempts: readonly SmsPoolAttempt[];
+        retryable?: boolean;
+        code?: string;
+    }>);
+}
+export declare class SmsProviderPool implements SmsMessageSender<SmsMessage>, SmsTemplateSender<SmsTemplateMessage>, SmsBulkSender<SmsBulkMessage> {
+    readonly name = "sms-pool";
+    private readonly providers;
+    private readonly strategy;
+    private readonly health;
+    private readonly maxAttemptsPerProvider;
+    private readonly initialDelayMs;
+    private readonly maxDelayMs;
+    private readonly backoffMultiplier;
+    private readonly sleep;
+    private readonly onEvent?;
+    private readonly classifyError?;
+    private readonly observedCircuitStates;
+    constructor(options: SmsProviderPoolOptions);
+    sendMessage(message: SmsMessage): Promise<SmsSendResult>;
+    sendTemplate(message: SmsTemplateMessage): Promise<SmsSendResult>;
+    sendBulk(message: SmsBulkMessage): Promise<SmsBulkSendResult>;
+    sendArray(messages: readonly SmsBatchMessage[], options?: Readonly<{
+        signal?: AbortSignal;
+    }>): Promise<readonly SmsSendResult[]>;
+    sendLikeToLike(message: SmsIrLikeToLikeMessage): Promise<SmsBulkSendResult>;
+    private execute;
+    private classify;
+    private updateHealth;
+    private observeCircuitState;
+    private emit;
+    private abortError;
+    private waitBeforeRetry;
+}
+//# sourceMappingURL=sms-provider-pool.d.ts.map

package/dist/pool/sms-provider-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms-provider-pool.d.ts","sourceRoot":"","sources":["../../src/pool/sms-provider-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,gBAAgB,EAEhB,sBAAsB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAsB,MAAM,wBAAwB,CAAC;AAI9E,qBAAa,oBAAqB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAE7C,YACC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC;QACjB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;QAChD,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;QACpC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,EAgBF;CACD;AAED,qBAAa,eACZ,YACC,gBAAgB,CAAC,UAAU,CAAC,EAC5B,iBAAiB,CAAC,kBAAkB,CAAC,EACrC,aAAa,CAAC,cAAc,CAAC;IAE9B,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAGlC;IAEJ,YAAY,OAAO,EAAE,sBAAsB,EAmD1C;IAEK,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAK7D;IAEK,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAKtE;IAEK,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKlE;IAEK,SAAS,CACd,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,GAAE,QAAQ,CAAC;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,CAAM,GAC9C,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAKnC;IAEK,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKhF;YAEa,OAAO;IAmJrB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,UAAU;YAeJ,eAAe;CAe7B"}