opossum 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28f90ba90661894c077eb72004e0300f07e9c2d93059d8221985c396b467b74e
-  data.tar.gz: 29afd0da8dd9f9192caeea525f92365637b75d15816fca846a0a577049ea56d9
+  metadata.gz: fc7e39df727f7bb72b25088d9dccf4a0926dcaba41c624e27045f455c08650be
+  data.tar.gz: 32977c12dca6c24b2182e791cb3081705a08fd2b5c76f717ecceb0db03e5e14d
 SHA512:
-  metadata.gz: cf6f1c1f02604906beb4ea09fb3af644ede569c4ec9dcf962a6f2d851f2ee5fbfedd4a2ade0831b0a677b8ae78e51ced66a919eb12237820658b74014c150d5f
-  data.tar.gz: ccba27fcb4c858e825ca63f494ab97d6246e58078a4369274373170dab71cb11e20dcec00789e924dc52312c696f1073b740a27bd76e99c6e3659dc6e49227c8
+  metadata.gz: a34ab41b169655e35028138e18cb111810c2ecd4beef2e83fd4b9ecad8b1f3bdc59fb6c1a0cbb124c0bcc5675637095411443472d248fb722dc1e66067bc6865
+  data.tar.gz: 26319316d4a349ca1c3b0a6663d6e8e6198b714c60a151d800f6bff13a956cd0444e19b6f34a2a69efb29c3531ffed7d045c5cf0321403f931d9c048a54c5cb3

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.2.1] - 2025-08-07
+
+### Improved
+- **Instagram API Response Handling** - Enhanced error handling and response processing
+  - Improved JSON parsing with better error messages when API returns invalid JSON
+  - Added specific Instagram API error detection and messaging via `error_message` field
+  - Enhanced HTTP error handling with more descriptive error messages
+  - Better separation of concerns in ApiHelper with dedicated private methods for response processing
+  - More robust error handling chain: HTTP errors → JSON parsing errors → Instagram API errors
+
 ## [0.2.0] - 2025-08-06
 
 ### Changed

data/README.md

@@ -131,7 +131,7 @@ result = publisher.publish_media(
 
 ## Error Handling
 
-The gem includes comprehensive error handling for API responses:
+The gem includes comprehensive error handling for API responses with enhanced Instagram API error detection:
 
 ```ruby
 begin
@@ -145,9 +145,19 @@ begin
   )
 rescue Opossum::Error => e
   puts "Error: #{e.message}"
+  # Examples of error messages:
+  # "HTTP Error: Connection failed"
+  # "JSON Parse Error: Unexpected token"
+  # "Instagram API Error: Invalid media URL"
 end
 ```
 
+**Error Handling Features:**
+- **HTTP Error Detection** - Catches network and connection issues with descriptive messages
+- **JSON Parsing** - Handles malformed API responses with clear error descriptions
+- **Instagram API Errors** - Automatically detects and reports Instagram-specific errors via `error_message` field
+- **Error Chain Processing** - Processes errors in logical order: HTTP → JSON → Instagram API
+
 ## Supported Media Types
 
 - **IMAGE** - Single images (JPEG, PNG) with optional caption

data/lib/opossum/api_helper.rb

@@ -36,8 +36,6 @@ module Opossum
       end
 
       def handle_response(response)
-        raise Opossum::Error, "HTTP #{response.status}: #{response.body}" unless response.success?
-
         parsed_response = parse_json(response.body)
         check_api_errors(parsed_response)
         parsed_response
@@ -52,11 +50,9 @@ module Opossum
       end
 
       def check_api_errors(parsed_response)
-        return unless parsed_response["error"]
+        return unless parsed_response["error_message"]
 
-        error_message = "Instagram API Error: #{parsed_response["error"]}"
-        error_message += " - #{parsed_response["error_description"]}" if parsed_response["error_description"]
-        raise Opossum::Error, error_message
+        raise Opossum::Error, "Instagram API Error: #{parsed_response["error_message"]}"
       end
     end
   end

data/lib/opossum/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opossum
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Vadym Kruchyna