@mhbdev/sms 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## 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
+
+- [`5f631f4`](https://github.com/mhbdev/sms/commit/5f631f4fe7cb8e0174b4bd2749d7b5afab4ed80c) Thanks [@mhbdev](https://github.com/mhbdev)! - Fix Kavenegar outbound reporting, harden transport cancellation and bounded retry behavior, enforce provider response cardinality, and strengthen runtime input validation.
+
 ## 0.2.1
 
 ### Patch Changes

package/README.md

@@ -120,6 +120,93 @@ 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/kavenegar.d.ts

@@ -40,6 +40,12 @@ export type KavenegarCountResult = Readonly<{
     endDate: number;
     count: number;
 }>;
+export type KavenegarOutboxCountQuery = Readonly<{
+    startDate: number;
+    endDate?: number;
+    status?: number;
+    signal?: AbortSignal;
+}>;
 export type KavenegarSearchQuery = Readonly<{
     messageIds?: readonly (string | number)[];
     startDate: number;

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

@@ -1 +1 @@
-{"version":3,"file":"kavenegar.d.ts","sourceRoot":"","sources":["../../src/contracts/kavenegar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CACjD,cAAc,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CACD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAC9C,QAAQ,CAAC;IACR,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEJ,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC3C,eAAe,EACf,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACpD,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"kavenegar.d.ts","sourceRoot":"","sources":["../../src/contracts/kavenegar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CACjD,cAAc,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CACD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAC9C,QAAQ,CAAC;IACR,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEJ,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC3C,eAAe,EACf,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAC/B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACpD,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC"}

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":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GACzB,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,gBAAgB,CAAC;AAEpB,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE,oEAAoE;IACpE,SAAS,CAAC,EAAE,CACX,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,KACxC,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACvC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjF,CAAC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IACnD,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,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;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GACrB,QAAQ,CAAC;IACT,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACf,CAAC,GACF,QAAQ,CAAC;IACT,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACf,CAAC,GACF,QAAQ,CAAC;IACT,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;CAClB,CAAC,GACF,QAAQ,CAAC;IACT,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,uBAAuB,CAAC;CAC9B,CAAC,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEtE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAAC;IACpD,iEAAiE;IACjE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,QAAQ,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,CACf,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,gBAAgB,KACvB,4BAA4B,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,SAAS,eAAe,EAAE,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,SAAS,aAAa,EAAE,CAAC;AAC1D,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC"}

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/contracts/sms.d.ts

@@ -4,7 +4,7 @@ export type SmsMessage = Readonly<{
     message: string;
     /** Provider sender number override, when the provider supports sender selection. */
     sender?: string;
-    sendAt?: number;
+    sendAt?: number | Date;
     localId?: string | number;
     tag?: string;
     signal?: AbortSignal;
@@ -22,7 +22,7 @@ export type SmsBatchMessage = Readonly<{
     message: string;
     /** Provider sender number override, when the provider supports sender selection. */
     sender?: string;
-    sendAt?: number;
+    sendAt?: number | Date;
     localId?: string | number;
     signal?: AbortSignal;
 }>;
@@ -32,7 +32,7 @@ export type SmsBulkMessage = Readonly<{
     message: string;
     /** Sender number override for the whole bulk request, when supported. */
     sender?: string;
-    sendAt?: number;
+    sendAt?: number | Date;
     signal?: AbortSignal;
 }>;
 /** Result status shared by all providers. */

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

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

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, KavenegarReceivedMessage, KavenegarReceiveQuery, KavenegarSendArrayMessage, KavenegarSendResult, KavenegarSmsProviderOptions, KavenegarStatusQuery, KavenegarStatusResult, KavenegarTemplateMessage, } from "./contracts/kavenegar.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,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":"AAwDA,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"}