instagram_connect 0.3.8 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e92666f3e02d64943e955f8e20162754255471dc92bd4fc2e54e3f6db3a68111
-  data.tar.gz: 4bc700ffa63d750b2ad1313d1015e8f799edc44e56c9520d6b7be10fd494631c
+  metadata.gz: 3a9c934d89a0e97c513a99c5352da9227b5133f1011557deb0ea87f4d8a6ce9d
+  data.tar.gz: a7b0af0a9b85bbeaf6c3015f45f3a467c9f7a23b5f73356ba34819389a887190
 SHA512:
-  metadata.gz: 0ba66b7cabad11d19321d2efa789728a97f5b668fb84c05bf3bf4c80277ab1df483e2e37ad85b87d3c6e3f6a0878a80608550e8ffb91154fb8f2e27f5490c698
-  data.tar.gz: de44cfd0f48eeafa8c4d2556d4f72de17c18218f2bba8ae9da9d8fa5f8bc67ceb41a840d8412f7a05181517288afd2c5fd92ff40128d676c6318379d389c595c
+  metadata.gz: 35cca9a90ea1822ff47b9b6fbb09addb00c60a0484519842fdd54285b51cb0643f41f64105bd6f9a96e157637dbf6daa3f5e9b5c2ea4dabb07a6436eb9201dcd
+  data.tar.gz: bdb981d70acbe14a489d95b7ea8ea5c5229aa2462f2998aca1ad8328146e25dec95101c3583da7a77901da5c16429d385b1860366454b5b1c921d6396e1b5ad2

data/CHANGELOG.md

@@ -6,6 +6,28 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.9] - 2026-07-27
+
+### Added
+
+- **Stories sync.** `SyncStoriesJob` walks the `/stories` edge and mirrors live stories as
+  `media_product_type: STORY` rows. Meta lists only the stories inside their 24 hours and sends no
+  expiry webhook, so the job upserts what it sees and marks nothing — expired stories keep their
+  rows forever, same never-delete rule as posts.
+- **Carousel slides.** `MEDIA_FIELDS` now requests `children{id,media_type,media_url,thumbnail_url}`
+  and the new `children` json column stores them, so hosts can render every frame of a carousel,
+  not just the cover. `media_product_type` is requested too (FEED vs REELS vs STORY).
+- **`MediaItem#live_story?`** — a story lives 24 hours from posting; unknown posted_at counts as expired.
+- **`MediaItem.posts` scope** — everything that belongs on a feed grid. NULL-safe: rows synced
+  before `media_product_type` was requested still count as posts.
+- `Client#list_stories`, and the media field lists now live on `Client`
+  (`Client::MEDIA_FIELDS` / `Client::STORY_FIELDS`).
+
+### Migration
+
+- `add_column :instagram_connect_media, :children, :json` (`if_not_exists`).
+
+
 ## [0.3.8] - 2026-07-27
 
 ### Added

data/app/jobs/instagram_connect/sync_media_job.rb

@@ -20,8 +20,7 @@ module InstagramConnect
     # like_count and comments_count come straight off the media node — no
     # insights permission needed for the account's own posts. thumbnail_url is
     # the poster frame for videos, whose media_url is a playable mp4.
-    MEDIA_FIELDS = "id,caption,media_type,media_url,thumbnail_url,permalink," \
-                   "timestamp,like_count,comments_count".freeze
+    MEDIA_FIELDS = Client::MEDIA_FIELDS
 
     def self.enqueue_throttled(account)
       Rails.cache.fetch("instagram_connect:sync_media:#{account.id}", expires_in: THROTTLE) do
@@ -69,6 +68,8 @@ module InstagramConnect
         thumbnail_url: item["thumbnail_url"],
         like_count: item["like_count"],
         comments_count: item["comments_count"],
+        media_product_type: item["media_product_type"],
+        children: item.dig("children", "data"),
         posted_at: parse_time(item["timestamp"]),
         synced_at: Time.current
       )

data/app/jobs/instagram_connect/sync_stories_job.rb

@@ -0,0 +1,60 @@
+module InstagramConnect
+  # Mirrors the account's stories. Meta's /stories edge returns only the
+  # stories still inside their 24 hours, and sends no webhook when one
+  # expires — so this walk upserts what it sees and marks nothing: a story
+  # that stops appearing has simply expired, which the row's posted_at
+  # already tells the host. Expired stories keep their rows forever, same
+  # never-delete rule as posts; their CDN URLs die with the story.
+  #
+  # Safe to re-run: MediaItem.record upserts on (account, ig_media_id).
+  class SyncStoriesJob < ApplicationJob
+    queue_as :default
+
+    # Hosts enqueue this from screens; the cache key stops a busy screen
+    # enqueueing it once per page view.
+    THROTTLE = 10.minutes
+
+    def self.enqueue_throttled(account)
+      Rails.cache.fetch("instagram_connect:sync_stories:#{account.id}", expires_in: THROTTLE) do
+        perform_later(account.id)
+        true
+      end
+    end
+
+    def perform(account_id)
+      account = Account.find_by(id: account_id)
+      return if account.nil? || !account.active?
+
+      result = account.client.list_stories
+      unless result.success?
+        return logger.error("[instagram_connect] stories sync failed for " \
+                            "account=#{account.id}: #{result.error_message}")
+      end
+
+      Array(result.data["data"]).each { |item| upsert(account, item) }
+    end
+
+    private
+
+    def upsert(account, item)
+      MediaItem.record(
+        account: account,
+        ig_media_id: item["id"],
+        media_type: item["media_type"],
+        media_product_type: item["media_product_type"] || "STORY",
+        caption: item["caption"],
+        permalink: item["permalink"],
+        media_url: item["media_url"],
+        thumbnail_url: item["thumbnail_url"],
+        posted_at: parse_time(item["timestamp"]),
+        synced_at: Time.current
+      )
+    end
+
+    def parse_time(value)
+      Time.zone.parse(value.to_s)
+    rescue ArgumentError, TypeError
+      nil
+    end
+  end
+end

data/app/models/instagram_connect/media_item.rb

@@ -17,6 +17,10 @@ module InstagramConnect
     validates :ig_media_id, presence: true, uniqueness: { scope: :account_id }
 
     scope :stories, -> { where(media_product_type: "STORY") }
+    # Everything that belongs on a feed grid. NULL-safe on purpose: rows
+    # synced before media_product_type was requested have nil there, and a
+    # plain where.not would silently drop them.
+    scope :posts, -> { where("media_product_type IS NULL OR media_product_type <> 'STORY'") }
     scope :recent, -> { order(Arel.sql("posted_at IS NULL, posted_at DESC")) }
 
     # Upserts by Meta's id. Media arrives from several directions — a webhook
@@ -40,5 +44,12 @@ module InstagramConnect
     def story?
       media_product_type == "STORY"
     end
+
+    # A story lives for 24 hours from posting; after that Instagram drops it
+    # and its CDN URLs die. Unknown posted_at counts as expired — better a
+    # grayed card than a player pointed at a dead URL.
+    def live_story?
+      story? && posted_at.present? && posted_at > 24.hours.ago
+    end
   end
 end

data/db/migrate/20260727110000_add_children_to_instagram_connect_media.rb

@@ -0,0 +1,9 @@
+class AddChildrenToInstagramConnectMedia < ActiveRecord::Migration[8.0]
+  # The slides of a carousel post, as Meta returns them: an array of
+  # {id, media_type, media_url, thumbnail_url} hashes. json, not jsonb,
+  # because the gem runs on sqlite too. if_not_exists so a host that ran a
+  # copy of this migration before adopting the gem version is unaffected.
+  def change
+    add_column :instagram_connect_media, :children, :json, if_not_exists: true
+  end
+end

data/lib/instagram_connect/client.rb

@@ -131,11 +131,28 @@ module InstagramConnect
 
     # --- Reads -----------------------------------------------------------
 
+    # Everything the mirror stores about a post: engagement counts come straight
+    # off the media node (no insights permission needed for the account's own
+    # posts), thumbnail_url is the video poster frame, media_product_type tells
+    # FEED from REELS, and children are a carousel's slides.
+    MEDIA_FIELDS = "id,caption,media_type,media_url,thumbnail_url,permalink," \
+                   "timestamp,like_count,comments_count,media_product_type," \
+                   "children{id,media_type,media_url,thumbnail_url}".freeze
+
+    # A story is a media node too, but the engagement fields don't exist on it.
+    STORY_FIELDS = "id,caption,media_type,media_url,thumbnail_url,permalink," \
+                   "timestamp,media_product_type".freeze
+
     def list_media(ig_user_id: @ig_user_id, limit: 25)
       get("/#{require_ig_user_id(ig_user_id)}/media",
-          { fields: "id,caption,media_type,media_url,thumbnail_url,permalink," \
-                    "timestamp,like_count,comments_count",
-            limit: limit })
+          { fields: MEDIA_FIELDS, limit: limit })
+    end
+
+    # The account's LIVE stories — Meta returns only the ones still inside
+    # their 24 hours. Expired stories simply stop appearing here.
+    def list_stories(ig_user_id: @ig_user_id, limit: 25)
+      get("/#{require_ig_user_id(ig_user_id)}/stories",
+          { fields: STORY_FIELDS, limit: limit })
     end
 
     def media_insights(media_id:, metrics: %w[reach likes comments])

data/lib/instagram_connect/version.rb

@@ -1,3 +1,3 @@
 module InstagramConnect
-  VERSION = "0.3.8"
+  VERSION = "0.3.9"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.8
+  version: 0.3.9
 platform: ruby
 authors:
 - Kshitiz Sinha
@@ -102,6 +102,7 @@ files:
 - app/jobs/instagram_connect/send_message_job.rb
 - app/jobs/instagram_connect/sync_conversations_job.rb
 - app/jobs/instagram_connect/sync_media_job.rb
+- app/jobs/instagram_connect/sync_stories_job.rb
 - app/models/instagram_connect/account.rb
 - app/models/instagram_connect/api_budget.rb
 - app/models/instagram_connect/application_record.rb
@@ -145,6 +146,7 @@ files:
 - db/migrate/20260725204815_create_instagram_connect_api_budgets.rb
 - db/migrate/20260725205417_add_conversation_profile_fields.rb
 - db/migrate/20260727074500_add_removed_flag_to_instagram_connect_media.rb
+- db/migrate/20260727110000_add_children_to_instagram_connect_media.rb
 - docs/CONFIGURATION.md
 - docs/app_review_guide.md
 - docs/auth_paths.md