pratka 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b7fcba8830d7b2a64d6eface4623a15a44f88891a3642ef144fcef3df7af4e9
-  data.tar.gz: 141e3f04d803fd70e8e1173334b10ce88e1908d8f9c1d711bbd27e02de265547
+  metadata.gz: 7940c2073d0fbeec909b2f5f545729474e26f1113c4d9dd154046ae7f8e7780f
+  data.tar.gz: 58293d9ab43d5addb4e84208bff655d76db9fd84c14a74acb43d50cd3376c6ba
 SHA512:
-  metadata.gz: 90e43c700109947503183ab11b2d8601be0ddeb69c1d9736ae71124e56a2546f8a08ebe43a18647add64412ab39e45b2a6379091af8e2383763ef604457bbe37
-  data.tar.gz: be018a707f9cc0fe0d7dd665b7dfbe672557ffc9f83cac1a1b46aa53cf741f8428f8024bc8cf2706c4514a476b7b1d99ec9c707dd2d09bce00f6a5eaf08ab809
+  metadata.gz: fe7b5484ea064bc9ff8dc3e42b31fe24c6bfcab9231c7f6e35140beba7b7dd2a2c43c85f4087e52af6684167aa80c093ab0f6386f3b167293523ad1b079b1e02
+  data.tar.gz: 7e1b7237afd97ef8d001e861953b55b7e6bb6c55888f22f4a285c5db531475b9d3f9103e806c83cb39950e8d9e89ed31da15fcb46fc2d10a532662b0128a4cea

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.1.2] - 2026-10-12
+
+### Changed
+
+- Invalid params raise `Pratka::Speedy::InvalidParamsError` instead of `ArgumentError`, so `rescue Pratka::Error` covers every failure
+
 ## [0.1.1] - 2026-10-08
 
 ### Added

data/README.md

@@ -258,7 +258,7 @@ Returns raw PDF or ZPL bytes if the request is successful and the parcel exists
 
 If the parcels don't exist in Speedy, `print_label` raises `Pratka::Speedy::Error` with the message `Speedy returned an empty label; check the parcel IDs`
 
-If you send empty parcels, `print_label` raises `ArgumentError` with the message `Missing params: parcels`
+If you send empty parcels, `print_label` raises `Pratka::Speedy::InvalidParamsError` with the message `Missing params: parcels`
 
 #### Fetch payment details
 
@@ -427,7 +427,7 @@ Returns the parsed JSON response with one tracked parcel per matched parcel. A `
 
 A parcel Speedy can't find comes back with its own `error` object instead of operations. `track` doesn't raise for it, so check each parcel
 
-Speedy enforces 10 parcels limit per request. If you send more than 10 parcels it raises `ArgumentError` with the message `Speedy tracks at most 10 parcels per call`. Split larger lists into batches, for example with `each_slice(10)`
+Speedy enforces 10 parcels limit per request. If you send more than 10 parcels it raises `Pratka::Speedy::InvalidParamsError` with the message `Speedy tracks at most 10 parcels per call`. Split larger lists into batches, for example with `each_slice(10)`
 
 Example response:
 
@@ -445,18 +445,17 @@ Example response:
 
 ### Errors
 
-Every network and API failure raises a subclass of `Pratka::Speedy::Error`, which inherits from `Pratka::Error`
+Every failure raises a subclass of `Pratka::Speedy::Error`, which inherits from `Pratka::Error`, so `rescue Pratka::Error` covers them all
 
 | Error | Raised when | Extra attributes |
 | --- | --- | --- |
+| `Pratka::Speedy::InvalidParamsError` | A param is unknown, missing or over a limit. Raised before any request is sent | |
 | `Pratka::Speedy::TimeoutError` | The connection or read times out | |
 | `Pratka::Speedy::ConnectionError` | DNS, socket or SSL failure | |
 | `Pratka::Speedy::HTTPError` | Speedy returns a non-2xx status | `status`, `body` |
 | `Pratka::Speedy::APIError` | Speedy returns 2xx with an `error` object in the body | `code`, `context`, `id` |
 | `Pratka::Speedy::Error` | The response is malformed, has invalid JSON, or has an unexpected format | |
 
-Bad arguments raise `ArgumentError` before any request is sent, for example an unknown option or a missing `site_id`
-
 ```ruby
 begin
   client.fetch_streets(site_id: 36124, name: "Алеко")

data/lib/pratka/speedy/client.rb

@@ -191,7 +191,7 @@ module Pratka
       # Returns one tracked parcel per matched parcel. A ref can match up to 10. Each tracked parcel carries its own error if Speedy can't track it
       def track(**options)
         params = map_params(options, TRACK_PARAMS, required: [:parcels])
-        raise ArgumentError, "Speedy tracks at most #{TRACK_MAX_PARCELS} parcels per call" if params[:parcels].size > TRACK_MAX_PARCELS
+        raise InvalidParamsError, "Speedy tracks at most #{TRACK_MAX_PARCELS} parcels per call" if params[:parcels].size > TRACK_MAX_PARCELS
 
         call(TRACK_ENDPOINT, params)
       end
@@ -204,10 +204,10 @@ module Pratka
 
       def map_params(options, mapping, required: [])
         unknown = options.keys - mapping.keys
-        raise ArgumentError, "Unknown params: #{unknown.join(", ")}" if unknown.any?
+        raise InvalidParamsError, "Unknown params: #{unknown.join(", ")}" if unknown.any?
 
         missing = required.select { |key| blank?(options[key]) }
-        raise ArgumentError, "Missing params: #{missing.join(", ")}" if missing.any?
+        raise InvalidParamsError, "Missing params: #{missing.join(", ")}" if missing.any?
 
         options.transform_keys(mapping)
       end

data/lib/pratka/speedy/errors.rb

@@ -7,6 +7,7 @@ module Pratka
     class Error < Pratka::Error; end
     class TimeoutError < Error; end
     class ConnectionError < Error; end
+    class InvalidParamsError < Error; end
 
     class HTTPError < Error
       attr_reader :status, :body

data/lib/pratka/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pratka
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pratka
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Stilqn Bairski