opossum 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28f90ba90661894c077eb72004e0300f07e9c2d93059d8221985c396b467b74e
-  data.tar.gz: 29afd0da8dd9f9192caeea525f92365637b75d15816fca846a0a577049ea56d9
+  metadata.gz: f835a756ad086cea7eb54dfbb798975cff69dd6d78b4d2b756a5eb9870818196
+  data.tar.gz: ee8f5c575cb49aa93002d00b955fd910029b752aee738464fc13c9d877e069c1
 SHA512:
-  metadata.gz: cf6f1c1f02604906beb4ea09fb3af644ede569c4ec9dcf962a6f2d851f2ee5fbfedd4a2ade0831b0a677b8ae78e51ced66a919eb12237820658b74014c150d5f
-  data.tar.gz: ccba27fcb4c858e825ca63f494ab97d6246e58078a4369274373170dab71cb11e20dcec00789e924dc52312c696f1073b740a27bd76e99c6e3659dc6e49227c8
+  metadata.gz: cbb2cb21287e5a5bf0547cf826a7c2f0f2fbf38dca6ae6651bec2ccc44190da8b2b2953c36a46be7df521ad565deadfd6e2ebdee988565c454f676e7d138db8e
+  data.tar.gz: 94a6445ba81cb9fe6450b600701e54bb69227c7ebb2a147b01857a40907a9e31fd7cd16757fc972c83822f4f517c372f6fd15ea4cf61424dd16f6370f50a350b

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [0.3.0] - 2025-08-12
+
+### Improved
+- **Publisher Performance** - Enhanced carousel media processing with parallel execution
+  - `prepare_carousel_media` now uses Thread-based parallel processing for media container creation
+  - Significantly improved upload speed for carousels with multiple media items
+  - Each media URL in carousel is processed concurrently instead of sequentially
+- **Error Handling** - Enhanced Error class with additional error context
+  - Added `code` and `subcode` attributes to Error class for better error identification
+  - Improved error initialization with optional code and subcode parameters
+
+## [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,10 +36,8 @@ 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)
+        check_api_errors(parsed_response, response.success?)
         parsed_response
       rescue Faraday::Error => e
         raise Opossum::Error, "HTTP Error: #{e.message}"
@@ -51,12 +49,16 @@ module Opossum
         raise Opossum::Error, "JSON Parse Error: #{e.message}"
       end
 
-      def check_api_errors(parsed_response)
-        return unless parsed_response["error"]
+      def check_api_errors(parsed_response, success)
+        return if success
+
+        error_message = parsed_response["error_message"] || parsed_response.dig("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.new(
+          "Instagram API Error: #{error_message}",
+          code: parsed_response.dig("error", "code"),
+          subcode: parsed_response.dig("error", "subcode")
+        )
       end
     end
   end

data/lib/opossum/publisher.rb

@@ -35,10 +35,14 @@ module Opossum
     end
 
     def prepare_carousel_media(media_urls:, media_type:, caption:)
-      children_ids = media_urls.map do |url|
-        create_media_container(media_url: url, is_carousel_item: true, caption: caption)
+      threads = media_urls.map do |url|
+        Thread.new do
+          create_media_container(media_url: url, is_carousel_item: true, caption: caption)
+        end
       end
 
+      children_ids = threads.map(&:value)
+
       create_media_container(media_url: children_ids, media_type: media_type, caption: caption)
     end
 

data/lib/opossum/version.rb

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

data/lib/opossum.rb

@@ -6,5 +6,15 @@ require_relative "opossum/user_details"
 require_relative "opossum/publisher"
 
 module Opossum
-  class Error < StandardError; end
+  # Custom error class for Opossum gem
+  class Error < StandardError
+    attr_reader :code, :subcode
+
+    def initialize(message, code: nil, subcode: nil)
+      super(message)
+
+      @code = code
+      @subcode = subcode
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opossum
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Vadym Kruchyna
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-06 00:00:00.000000000 Z
+date: 2025-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday