sudhanva 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbe82330602c646a93171c209c60239fc9ada05a2f6ec12595f0f18c8daff762
-  data.tar.gz: 8b1a707ca41396832b107df893fa08032832663b63610a4c9fc26ed16f306960
+  metadata.gz: 6efe7d85f59f7bfcb72b959ff3a183467a8803376fa3877778ce2ddd005ff33e
+  data.tar.gz: e530372b176598e5c49ad188f734d15095e3a932c414ab633f3bef1be646fa60
 SHA512:
-  metadata.gz: d2c6bcddb7efe2d5671a28ca756f6cd0dc4e72c534bd61266ae1aebdca98e2e9628814fd534483f78b0aba3bba111d8873a1852232c4752bd4c88ce7c62e264b
-  data.tar.gz: 5edcb475d5f20bca97689cf312afa7242818d17e0858f6af9da75c21c2482cda3df7fc51a6eaab752cfbf55531d0f25d3b954699392f1a44e3f697699ead225d
+  metadata.gz: 692ad73bb3d682ecc4c1a9c9c8ebe9334361f608c23ab06d488e2bd60d1c530c134121cf8fcc05839c333fee1f4aafdb482c07f058eea25ac8789e27d3b6a711
+  data.tar.gz: 6a4cafdade895142218580a49ed98324ac9d980cdc5f61a14630fee6664de2d1d599aaaec73dd9407281a1c5e3d3045e78bbf58835ebc563fa37902192121b43

data/README.md

@@ -9,14 +9,16 @@ The API is public and requires no credentials. Do not send private data.
 
 ## Install
 
+Requires Ruby 3.3 or newer.
+
 ```bash
-gem install sudhanva
+gem install sudhanva --version 0.2.0
 ```
 
 Or add it to a `Gemfile`:
 
 ```ruby
-gem "sudhanva", "~> 0.1"
+gem "sudhanva", "~> 0.2.0"
 ```
 
 ## Use
@@ -39,7 +41,9 @@ result = client.wait_for_profile_insight(job["job_id"])
 ```
 
 All methods return decoded JSON hashes. Non-success responses raise `Sudhanva::APIError` with
-`status`, `code`, and the decoded response body.
+`status`, `code`, `hint`, `docs_url`, and the decoded response body; the exception message includes
+the API's explanation. RFC 9457 problem responses from the profile-insight endpoints map `detail`
+(or `title`) to the message and the last segment of `type` to `code`.
 
 ## API coverage
 

data/lib/sudhanva/client.rb

@@ -8,14 +8,55 @@ module Sudhanva
   Response = Struct.new(:status, :headers, :body, keyword_init: true)
 
   class APIError < StandardError
-    attr_reader :status, :code, :body
+    attr_reader :status, :code, :body, :hint, :docs_url
 
-    def initialize(status:, code:, message:, body:)
+    def initialize(status:, code:, message:, body:, hint: nil, docs_url: nil)
       super("#{status} #{code}: #{message}")
       @status = status
       @code = code
       @body = body
+      @hint = hint
+      @docs_url = docs_url
     end
+
+    # Builds an error from the standard envelope or an RFC 9457 problem.
+    def self.from_response(status, payload)
+      body = payload.is_a?(Hash) ? payload : {}
+      nested = body["error"]
+      error = nested.is_a?(Hash) ? nested : body
+
+      code = text(error["code"]) || text(body["code"])
+      message = text(error["message"]) || text(body["message"])
+      if code.nil? && message.nil?
+        title = text(body["title"])
+        code = problem_code(text(body["type"])) || title
+        message = text(body["detail"]) || title
+      end
+      message ||= nested if nested.is_a?(String) && !nested.empty?
+
+      new(
+        status: status,
+        code: code || "api_error",
+        message: message || "Request failed",
+        body: payload,
+        hint: text(error["hint"]),
+        docs_url: text(error["docs_url"])
+      )
+    end
+
+    def self.text(value)
+      value if value.is_a?(String) && !value.empty?
+    end
+
+    # Returns the last fragment or path segment of a problem type URI.
+    def self.problem_code(type)
+      return nil if type.nil? || type == "about:blank"
+
+      base, _, fragment = type.partition("#")
+      text(fragment) || text(base.sub(%r{/+\z}, "").split("/").last)
+    end
+
+    private_class_method :text, :problem_code
   end
 
   class Client
@@ -127,10 +168,7 @@ module Sudhanva
       response = @transport.call(method, uri, request_headers, body, @timeout)
       payload = response.body.to_s.empty? ? {} : JSON.parse(response.body)
       unless response.status.between?(200, 299)
-        error = payload.fetch("error", payload)
-        code = error.fetch("code", payload.fetch("code", "api_error"))
-        message = error.fetch("message", payload.fetch("message", "Request failed"))
-        raise APIError.new(status: response.status, code: code, message: message, body: payload)
+        raise APIError.from_response(response.status, payload)
       end
 
       raise APIError.new(status: response.status, code: "invalid_response", message: "API returned a non-object response", body: payload) unless payload.is_a?(Hash)

data/lib/sudhanva/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sudhanva
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,15 +1,42 @@
 --- !ruby/object:Gem::Specification
 name: sudhanva
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Sudhanva Narayana
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
-dependencies: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
 description: A dependency-free client for published profile data, articles, search,
   batch reads, and profile-insight jobs.
 email:
@@ -32,7 +59,6 @@ metadata:
   documentation_uri: https://sudhanva.me/developers/sdks/
   bug_tracker_uri: https://github.com/nsudhanva/sudhanva-ruby/issues
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -40,15 +66,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Minimal Ruby client for the public sudhanva.me API.
 test_files: []