opossum 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f835a756ad086cea7eb54dfbb798975cff69dd6d78b4d2b756a5eb9870818196
-  data.tar.gz: ee8f5c575cb49aa93002d00b955fd910029b752aee738464fc13c9d877e069c1
+  metadata.gz: 721a81517304c17e172662c5fbd1e055dd3d218658749d04efd02191cb866eb6
+  data.tar.gz: 006cdb6681a963740d03d62dd566f2a3323027556dacc8591afc6c3e8732fcc6
 SHA512:
-  metadata.gz: cbb2cb21287e5a5bf0547cf826a7c2f0f2fbf38dca6ae6651bec2ccc44190da8b2b2953c36a46be7df521ad565deadfd6e2ebdee988565c454f676e7d138db8e
-  data.tar.gz: 94a6445ba81cb9fe6450b600701e54bb69227c7ebb2a147b01857a40907a9e31fd7cd16757fc972c83822f4f517c372f6fd15ea4cf61424dd16f6370f50a350b
+  metadata.gz: 23a6aa7fe4861ca4c62eb3a293fe4d507c2b33d479253b1340cddf561f97a43827170fa29d4b7a8f3db2b72fc739a3423fea49645d88ede37f0b443e5fd47170
+  data.tar.gz: 7ce15a3f0382aa0b57671c6aa62fc53f1dec2c214e52a90bfec640f2ef2d8fb209d64d42c26abc5f28d2bbc01090979f6ca25136078e0d6a3772fd55ba3402cb

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [0.4.0] - 2026-10-06
+
+### Added
+- **Image stories** - `Publisher#publish_media` accepts `media_format: "IMAGE" | "VIDEO"` for `media_type: "STORIES"`
+  - `"IMAGE"` sends the media URL as `image_url`; `"VIDEO"` (and the default, unchanged) as `video_url`
+  - Other media types ignore `media_format`
+
+## [0.3.1] - 2025-01-27
+
+### Fixed
+- **API Error Handling** - Improved error handling in ApiHelper
+  - Enhanced error message extraction with fallback to nested error structure
+
 ## [0.3.0] - 2025-08-12
 
 ### Improved
@@ -66,7 +79,7 @@
 ### Added
 
 #### Core Architecture
-- **Authenticator class** - OAuth authentication with Instagram Basic Display API
+- **Authenticator class** - OAuth authentication with Instagram API with Instagram Login
   - Exchange authorization code for access token
   - Support for client credentials and redirect URI configuration
 

data/README.md

@@ -1,13 +1,13 @@
 # OpossumInstagramPublisher
 
-A Ruby gem for publishing media to Instagram using Instagram Basic Display API and Instagram Graph API. This gem provides a simple interface to authenticate users via Instagram Login and publish images, videos, and carousel posts to their Instagram accounts.
+A Ruby gem for publishing media to Instagram using Instagram API with Instagram Login. This gem provides a simple interface to authenticate users via Instagram Login and publish images, videos, and carousel posts to their Instagram accounts.
 
 ## Prerequisites
 
 Before using this gem, you need to:
 
-1. Create a Facebook App and configure Instagram Basic Display API
-2. Set up Instagram Basic Display API permissions
+1. Create a Facebook App and configure Instagram API with Instagram Login
+2. Set up Instagram API with Instagram Login permissions
 3. Configure OAuth redirect URIs in your Facebook App settings
 4. Obtain your Instagram Business Account ID
 
@@ -121,6 +121,13 @@ result = publisher.publish_media(
   caption: 'Photo collection from my trip ✈️ #travel #memories'
 )
 
+# Publish a story (media_format picks image_url vs video_url; default is VIDEO)
+result = publisher.publish_media(
+  media_url: 'https://example.com/story.jpg',
+  media_type: 'STORIES',
+  media_format: 'IMAGE'
+)
+
 # That's it! publish_media handles everything automatically:
 # - Creates media container(s)
 # - Waits for processing to complete  
@@ -163,7 +170,7 @@ end
 - **IMAGE** - Single images (JPEG, PNG) with optional caption
 - **VIDEO** - Single videos (MP4, MOV) with optional caption
 - **REELS** - Instagram Reels with optional caption
-- **STORIES** - Instagram Stories with optional caption
+- **STORIES** - Instagram Stories; pass `media_format: 'IMAGE'` or `'VIDEO'` (default) to choose the URL field
 - **CAROUSEL** - Multiple images in a single post with optional caption (automatically handled when passing an array of URLs)
 
 **Features:**

data/lib/opossum/api_helper.rb

@@ -57,7 +57,7 @@ module Opossum
         raise Opossum::Error.new(
           "Instagram API Error: #{error_message}",
           code: parsed_response.dig("error", "code"),
-          subcode: parsed_response.dig("error", "subcode")
+          subcode: parsed_response.dig("error", "subcode") || parsed_response.dig("error", "error_subcode")
         )
       end
     end

data/lib/opossum/publisher.rb

@@ -12,9 +12,12 @@ module Opossum
       @ig_id = ig_id
     end
 
-    def publish_media(media_url:, media_type: "IMAGE", caption: nil)
+    # media_format applies to STORIES only: "IMAGE" sends the url as image_url,
+    # "VIDEO" (the default) as video_url. Other media types ignore it.
+    def publish_media(media_url:, media_type: "IMAGE", caption: nil, media_format: nil)
       path = "#{INSTAGRAM_GRAPH_API_ENDPOINT}/#{GRAPH_API_VERSION}/#{ig_id}/media_publish"
-      media_container_id = prepare_media_container(media_url: media_url, media_type: media_type, caption: caption)
+      media_container_id = prepare_media_container(media_url: media_url, media_type: media_type, caption: caption,
+                                                   media_format: media_format)
 
       ApiHelper.post(
         path: path,
@@ -26,11 +29,12 @@ module Opossum
 
     attr_reader :ig_id
 
-    def prepare_media_container(media_url:, media_type:, caption:)
+    def prepare_media_container(media_url:, media_type:, caption:, media_format: nil)
       if media_url.is_a?(Array)
         prepare_carousel_media(media_urls: media_url, media_type: media_type, caption: caption)
       else
-        create_media_container(media_url: media_url, media_type: media_type, caption: caption)
+        create_media_container(media_url: media_url, media_type: media_type, caption: caption,
+                               media_format: media_format)
       end
     end
 
@@ -46,10 +50,10 @@ module Opossum
       create_media_container(media_url: children_ids, media_type: media_type, caption: caption)
     end
 
-    def create_media_container(media_url:, media_type: "IMAGE", is_carousel_item: false, upload_type: nil, caption: nil)
+    # options: is_carousel_item:, upload_type:, media_format:
+    def create_media_container(media_url:, media_type: "IMAGE", caption: nil, **options)
       path = "#{INSTAGRAM_GRAPH_API_ENDPOINT}/#{GRAPH_API_VERSION}/#{ig_id}/media"
-      body = build_media_container_body(media_url: media_url, media_type: media_type, caption: caption,
-                                        is_carousel_item: is_carousel_item, upload_type: upload_type)
+      body = build_media_container_body(media_url: media_url, media_type: media_type, caption: caption, **options)
 
       response = ApiHelper.post(path: path, body: body)
       media_container_id = response["id"]
@@ -58,20 +62,22 @@ module Opossum
       media_container_id
     end
 
-    def build_media_container_body(media_url:, media_type:, caption:, is_carousel_item:, upload_type:)
+    def build_media_container_body(media_url:, media_type:, caption:, **options)
       body = { access_token: access_token, media_type: media_type, caption: caption }
-      set_media_url_field(body, media_url, media_type)
-      body[:is_carousel_item] = is_carousel_item if is_carousel_item
-      body[:upload_type] = upload_type if upload_type
+      set_media_url_field(body, media_url, media_type, options[:media_format])
+      body[:is_carousel_item] = options[:is_carousel_item] if options[:is_carousel_item]
+      body[:upload_type] = options[:upload_type] if options[:upload_type]
       body
     end
 
-    def set_media_url_field(body, media_url, media_type)
+    def set_media_url_field(body, media_url, media_type, media_format = nil)
       case media_type
       when "IMAGE"
         body[:image_url] = media_url
-      when "VIDEO", "REELS", "STORIES"
+      when "VIDEO", "REELS"
         body[:video_url] = media_url
+      when "STORIES"
+        body[media_format.to_s.upcase == "IMAGE" ? :image_url : :video_url] = media_url
       when "CAROUSEL"
         body[:children] = media_url
       end

data/lib/opossum/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opossum
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Vadym Kruchyna
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2026-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -133,6 +133,6 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Ruby gem for publishing media to Instagram using Instagram Basic Display
-  API
+summary: Ruby gem for publishing media to Instagram using Instagram API with Instagram
+  Login
 test_files: []