didww-otp_verification 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ff9c9fc68b3da5a2d330d5ddc3ef599f65feb79674fe93d302c393dabe6d5b3
-  data.tar.gz: 639dc28bfb09c2af89e98ec9845c0a5fb422d09b21e9e717b30cd6f28039b387
+  metadata.gz: 2d642797b509a6a3a07315a163ac283086e3877a7d6304f88fb968995ad16f09
+  data.tar.gz: 6656b36bd906929a5397887573d1d1b40ed29fb3cecbe8add71ec5cc2355934d
 SHA512:
-  metadata.gz: 7de05b4e0d44499d58f885db44190a09c199a014091efbce7060c2127fccd23c3ef2981832a298ed5ab52720a5de135e6f32b7eb4ffd1f859da77854c0bddb99
-  data.tar.gz: dca7699a26fc3dee4e717470be7d778cd0591acffb282ec70be84e8b880c963023cec1a8ae54f80f199238bac3913f97eb7a6d5223dfe15b79115ed08bb7f337
+  metadata.gz: c994241bc5f386def42788c2bc6d7b6fbad3050784de09a396252046343df7fa16cd8c6066df35a2168cbb101fffec56f2dded64d2a5d7ff82204e5c40e1683a
+  data.tar.gz: 8e3313f28b2c2327b5e73d31ba4b24d574981f89a4878089e584924dbc395035e1b86ea24c0a3d7622b68733e2bf1da8f26db6ea50e6c86828bf1f659a46cea0

data/CHANGELOG.md

@@ -6,6 +6,18 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html): from 1.0.0 onwards a breaking change
 to the public surface requires a major version.
 
+## [1.3.0] — 2026-11
+
+### Added
+
+- **`destination_prefix_rate_limited` error code**, raised as `RateLimitedError`
+  (429) from `start_verification` when there are too many verifications to a
+  number range. `#retry_after` carries the `Retry-After` wait in seconds; do not
+  retry it automatically.
+- **`channel_blocked` error code.** A start can be refused with a 422 carrying it
+  when the account can't use the requested delivery method. Contact DIDWW
+  support.
+
 ## [1.2.0] — 2026-10
 
 ### Added

data/README.md

@@ -449,7 +449,7 @@ Non-2xx responses raise a typed error under `DIDWW::OTPVerification::Error`:
 | `BalanceInsufficientError` | 402       | `balance_insufficient`                |
 | `NotFoundError`            | 404       | `not_found`                           |
 | `ValidationError`          | 400 / 422 | `parameter_missing` / per-field codes |
-| `RateLimitedError`         | 429       | `destination_in_cooldown`, `rate_limit_*`, `volume_limit_reached` |
+| `RateLimitedError`         | 429       | `destination_in_cooldown`, `rate_limit_*`, `volume_limit_reached`, `destination_prefix_rate_limited` |
 | `ServerError`              | 5xx       | `internal_error`                      |
 
 Every error carries the API's coded envelope: `#errors` is an array of
@@ -473,6 +473,9 @@ rescue DIDWW::OTPVerification::ValidationError => e
 end
 ```
 
+`channel_blocked` (422): the account can't use the requested delivery method.
+No verification is created; contact DIDWW support.
+
 ## Retries
 
 The SDK does **not** auto-retry. If you add `faraday-retry`, exclude `POST`
@@ -490,6 +493,9 @@ A 429 raises `RateLimitedError`, and its code says which limit was hit:
 - `volume_limit_reached`: the application reached its daily or monthly
   verification limit. `Retry-After` can be long (days) — surface it to the
   user instead of retrying. Contact support to raise the limit.
+- `destination_prefix_rate_limited`: too many verifications to this number range;
+  try again later. Wait `Retry-After` before starting another one, and show the
+  user "Too many verification requests right now. Please try again later."
 
 `#retry_after` gives the wait in seconds (`nil` if the `Retry-After` header is
 missing or unparseable) — wait that long before trying again yourself; never

data/lib/didww/otp_verification/errors.rb

@@ -50,8 +50,9 @@ module DIDWW
 
     # 429 Too Many Requests. +code+ says which limit was hit:
     # +destination_in_cooldown+ (this destination was requested too recently),
-    # a +rate_limit_*+ request limit, or +volume_limit_reached+ (a daily or
-    # monthly limit; +retry_after+ can be days).
+    # a +rate_limit_*+ request limit, +volume_limit_reached+ (a daily or
+    # monthly limit; +retry_after+ can be days), or +destination_prefix_rate_limited+
+    # (too many verifications to this number range; wait +retry_after+).
     # Never auto-retry this.
     class RateLimitedError < APIError
       # @return [Integer, nil] seconds to wait, from the Retry-After header.

data/lib/didww/otp_verification/version.rb

@@ -1,5 +1,5 @@
 module DIDWW
   module OTPVerification
-    VERSION = "1.2.0"
+    VERSION = "1.3.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: didww-otp_verification
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - DIDWW