instagram_connect 0.3.9 → 0.3.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a9c934d89a0e97c513a99c5352da9227b5133f1011557deb0ea87f4d8a6ce9d
-  data.tar.gz: a7b0af0a9b85bbeaf6c3015f45f3a467c9f7a23b5f73356ba34819389a887190
+  metadata.gz: bea234dd4fd6e4a37c8c06f26c2b5101fc4a3b1b2037ea8c646fa6382e36555b
+  data.tar.gz: f4ead074b0eba3f7dc961bacccf661f45ad586a90661243aa465d2e79f4a4212
 SHA512:
-  metadata.gz: 35cca9a90ea1822ff47b9b6fbb09addb00c60a0484519842fdd54285b51cb0643f41f64105bd6f9a96e157637dbf6daa3f5e9b5c2ea4dabb07a6436eb9201dcd
-  data.tar.gz: bdb981d70acbe14a489d95b7ea8ea5c5229aa2462f2998aca1ad8328146e25dec95101c3583da7a77901da5c16429d385b1860366454b5b1c921d6396e1b5ad2
+  metadata.gz: 4c793edf0d1f244413a20cf705a277ca8f1927ceb888db77078c93813b208fdcb8f768cf3918c0d027b1ab5a607028481493c0f659ea10e9f09109ad00588752
+  data.tar.gz: 0d051c02f9538c9aaeb258e8220f15897042fb333dd63983fd6d3daa29f3dc796aff903dddad2dff4e5563a92c7b215075fb6f62e9b3cb20487fe9b33488b3fe

data/CHANGELOG.md

@@ -6,6 +6,17 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.10] - 2026-07-27
+
+### Added
+
+- **Comment history sync.** `SyncCommentsJob` walks a post's comments edge — replies expanded,
+  cursors followed — and upserts by Meta's id, so webhook-created rows are enriched, never
+  duplicated. Webhooks only cover comments made after the subscription existed; this imports
+  everything before. `SyncMediaJob`'s full walk now enqueues one comment walk per post that
+  actually has comments. Meta stays the source of truth for hidden, both directions.
+
+
 ## [0.3.9] - 2026-07-27
 
 ### Added

data/app/jobs/instagram_connect/sync_comments_job.rb

@@ -0,0 +1,74 @@
+module InstagramConnect
+  # Imports a post's existing comments — the ones that happened before the
+  # webhook subscription existed, which the webhook can never deliver. The
+  # comments edge is walked with cursors, replies expanded inline, and every
+  # comment upserted by Meta's id, so re-running never duplicates and a
+  # webhook-created row is simply enriched.
+  #
+  # Meta is the source of truth for hidden: a comment hidden from the app on
+  # the phone arrives hidden here, and one unhidden there un-hides here.
+  class SyncCommentsJob < ApplicationJob
+    queue_as :default
+
+    THROTTLE = 10.minutes
+
+    REPLY_FIELDS = "id,text,timestamp,username,from,parent_id,hidden,like_count".freeze
+    COMMENT_FIELDS = "#{REPLY_FIELDS},replies{#{REPLY_FIELDS}}".freeze
+
+    # One key per post: opening a busy post's comments repeatedly enqueues one
+    # import, not one per page view.
+    def self.enqueue_throttled(account, ig_media_id)
+      Rails.cache.fetch("instagram_connect:sync_comments:#{account.id}:#{ig_media_id}",
+                        expires_in: THROTTLE) do
+        perform_later(account.id, ig_media_id.to_s)
+        true
+      end
+    end
+
+    def perform(account_id, ig_media_id)
+      account = Account.find_by(id: account_id)
+      return if account.nil? || !account.active?
+
+      result = account.client.collect("/#{ig_media_id}/comments",
+                                      { fields: COMMENT_FIELDS, limit: 50 })
+      unless result.success?
+        return logger.error("[instagram_connect] comment sync failed for " \
+                            "account=#{account.id} media=#{ig_media_id}: #{result.error_message}")
+      end
+
+      Array(result.data["data"]).each do |item|
+        upsert(account, ig_media_id, item)
+        Array(item.dig("replies", "data")).each do |reply|
+          # Meta omits parent_id inside the replies expansion — the nesting
+          # itself is the statement.
+          upsert(account, ig_media_id, reply.merge("parent_id" => reply["parent_id"] || item["id"]))
+        end
+      end
+    end
+
+    private
+
+    def upsert(account, ig_media_id, item)
+      comment = Comment.record(
+        account: account,
+        comment_id: item["id"],
+        media_id: ig_media_id.to_s,
+        text: item["text"],
+        from_username: item["username"] || item.dig("from", "username"),
+        parent_id: item["parent_id"]
+      )
+      comment.update!(
+        from_ig_id: item.dig("from", "id") || comment.from_ig_id,
+        commented_at: parse_time(item["timestamp"]) || comment.commented_at,
+        like_count: item["like_count"],
+        hidden_at: item["hidden"] ? (comment.hidden_at || Time.current) : nil
+      )
+    end
+
+    def parse_time(value)
+      Time.zone.parse(value.to_s)
+    rescue ArgumentError, TypeError
+      nil
+    end
+  end
+end

data/app/jobs/instagram_connect/sync_media_job.rb

@@ -45,7 +45,14 @@ module InstagramConnect
       end
 
       Array(result.data["data"]).each { |item| upsert(account, item) }
-      mark_removed(account, started_at) if full
+      if full
+        mark_removed(account, started_at)
+        # The full walk is the moment to fetch comment history too: webhooks
+        # only cover comments made after the subscription existed. One extra
+        # job per post that actually has comments — bounded by reality, and
+        # the walk is operator-triggered.
+        backfill_comments(account, result)
+      end
     end
 
     private
@@ -78,6 +85,14 @@ module InstagramConnect
       media.update!(removed_from_instagram_at: nil) if media.removed_from_instagram_at
     end
 
+    def backfill_comments(account, result)
+      Array(result.data["data"]).each do |item|
+        next unless item["comments_count"].to_i.positive?
+
+        SyncCommentsJob.perform_later(account.id, item["id"].to_s)
+      end
+    end
+
     def mark_removed(account, started_at)
       marked = MediaItem.where(account_id: account.id, removed_from_instagram_at: nil)
                         .where(synced_at: ...started_at)

data/lib/instagram_connect/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.3.10
 platform: ruby
 authors:
 - Kshitiz Sinha
@@ -100,6 +100,7 @@ files:
 - app/jobs/instagram_connect/refresh_tokens_job.rb
 - app/jobs/instagram_connect/replay_events_job.rb
 - app/jobs/instagram_connect/send_message_job.rb
+- app/jobs/instagram_connect/sync_comments_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