instagram_connect 0.3.6 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8f007049f1317825ec16b8574067644b890352e47f04f987b779a9b893584a5
-  data.tar.gz: 714e3b145ab61b7e9e469890efe362630ddd269afae1f156050b6171ce748524
+  metadata.gz: 9cb1aea4b378e02bab73277ace0304ecdd751c54e535bc6840670870b844fddd
+  data.tar.gz: acc6b2589e468d17333a6920c1c5e4c609d8a636629e4ee62e35d8bb5e8cc6fa
 SHA512:
-  metadata.gz: 24d080252c2155439ee8515953a2037c071001933d0f1ff6083c66a40b7f5b7504b642df340521196f4e9c40cbb18ebaed0a89a3215abb87ed87afe06cc5ad3f
-  data.tar.gz: fc1e3e4ee479b7c6813e4e5a6bf3e567ae9b49360c8f57e5896d59e7f1528061945d7d7e5a3112420323b12d5270e272d902eb85fa234c30e9ecc1523a590e77
+  metadata.gz: d61e2c92a923fdc3b4fe5b47ecdc9709044635fc658fcc2251928dc0bbf44d3b4234916d4416142a89241caaf667ea2f7635569d0cbd6dfe98cfd478fbd42f42
+  data.tar.gz: e81459599d577b340e459571f643dace5a94a3a353921147877c89ac6e99a7647a8808da6ad5f5a00b85c943b4bf175b6903431a18efec073834c0aa6944f92f

data/CHANGELOG.md

@@ -6,6 +6,23 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.7] - 2026-07-27
+
+### Added
+
+- **`SyncMediaJob` — the gem now owns the post mirror.** Walks the account's entire media listing
+  (single page by default, full history with cursors via `full: true`), upserting caption,
+  permalink, type and timestamps into `MediaItem`. A host built this app-side first; per the
+  boundary rule — the gem owns the Graph protocol and every Instagram row — it moves here, and the
+  host's copy should be deleted on upgrade.
+- **`removed_from_instagram_at` on media, with `MediaItem#removed?`.** Instagram sends no webhook
+  for a deleted post; absence from the account's own **completed** listing is the only signal. A
+  vanished post is stamped, never destroyed, so hosts can render it grayed and locked. A failed or
+  partial walk marks nothing. The migration uses `if_not_exists` because one host added the column
+  app-side before the gem owned it.
+- `SyncMediaJob.enqueue_throttled(account)` for screen-triggered refreshes (10-minute throttle).
+
+
 ## [0.3.6] - 2026-07-26
 
 ### Fixed

data/app/jobs/instagram_connect/sync_media_job.rb

@@ -0,0 +1,89 @@
+module InstagramConnect
+  # Mirrors the account's posts — every post, from any app, not just ones
+  # published through this gem.
+  #
+  # The comments webhook names only a media id, so without this a host shows
+  # conversations grouped under bare 17-digit numbers. And Instagram sends no
+  # webhook when a post is deleted, so absence from the account's own COMPLETED
+  # listing is the only deletion signal there is: a vanished post is stamped
+  # removed_from_instagram_at, never destroyed. A partial or failed walk marks
+  # nothing — absence from an incomplete listing proves nothing.
+  #
+  # Safe to re-run: MediaItem.record upserts on (account, ig_media_id).
+  class SyncMediaJob < ApplicationJob
+    queue_as :default
+
+    # Hosts enqueue this from screens; the cache key stops a busy inbox
+    # enqueueing it once per page view.
+    THROTTLE = 10.minutes
+
+    MEDIA_FIELDS = "id,caption,media_type,media_url,permalink,timestamp".freeze
+
+    def self.enqueue_throttled(account)
+      Rails.cache.fetch("instagram_connect:sync_media:#{account.id}", expires_in: THROTTLE) do
+        perform_later(account.id)
+        true
+      end
+    end
+
+    # full: walks the entire history with cursors and, having seen it all,
+    # marks the known posts the listing no longer contains.
+    def perform(account_id, full: false)
+      account = Account.find_by(id: account_id)
+      return if account.nil? || !account.active?
+
+      started_at = Time.current
+      result = fetch(account, full: full)
+      unless result.success?
+        # A sync that fails must say so — the silent version of this class of
+        # job has already cost a production afternoon.
+        return logger.error("[instagram_connect] media sync failed for " \
+                            "account=#{account.id}: #{result.error_message}")
+      end
+
+      Array(result.data["data"]).each { |item| upsert(account, item) }
+      mark_removed(account, started_at) if full
+    end
+
+    private
+
+    def fetch(account, full:)
+      return account.client.list_media unless full
+
+      account.client.collect("/#{account.ig_user_id}/media",
+                             { fields: MEDIA_FIELDS, limit: 25 })
+    end
+
+    def upsert(account, item)
+      media = MediaItem.record(
+        account: account,
+        ig_media_id: item["id"],
+        media_type: item["media_type"],
+        caption: item["caption"],
+        permalink: item["permalink"],
+        media_url: item["media_url"],
+        posted_at: parse_time(item["timestamp"]),
+        synced_at: Time.current
+      )
+      # Explicit, because record compacts nils out of its attributes: a post
+      # that reappears in the listing un-grays.
+      media.update!(removed_from_instagram_at: nil) if media.removed_from_instagram_at
+    end
+
+    def mark_removed(account, started_at)
+      marked = MediaItem.where(account_id: account.id, removed_from_instagram_at: nil)
+                        .where(synced_at: ...started_at)
+                        .update_all(removed_from_instagram_at: Time.current)
+      return unless marked.positive?
+
+      logger.info("[instagram_connect] #{marked} post(s) newly absent from " \
+                  "Instagram for account=#{account.id}")
+    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

@@ -22,6 +22,12 @@ module InstagramConnect
     # Upserts by Meta's id. Media arrives from several directions — a webhook
     # about a comment, a story expiring, a sync — and whichever gets there first
     # should create the row without the others having to care.
+    # Stamped by SyncMediaJob when a completed listing no longer contains this
+    # post. Deleted on Instagram never means deleted here.
+    def removed?
+      removed_from_instagram_at.present?
+    end
+
     def self.record(account:, ig_media_id:, **attributes)
       media = find_or_initialize_by(account_id: account.id, ig_media_id: ig_media_id.to_s)
       media.assign_attributes(attributes.compact)

data/db/migrate/20260727074500_add_removed_flag_to_instagram_connect_media.rb

@@ -0,0 +1,13 @@
+class AddRemovedFlagToInstagramConnectMedia < ActiveRecord::Migration[7.1]
+  # Instagram sends no webhook when a post is deleted; absence from the
+  # account's own completed listing is the only signal there is. A vanished
+  # post is stamped, never destroyed — hosts render it as a locked, grayed,
+  # still-viewable row.
+  #
+  # if_not_exists because one host added this column app-side before the gem
+  # owned it; re-running here must be a no-op there.
+  def change
+    add_column :instagram_connect_media, :removed_from_instagram_at, :datetime,
+               if_not_exists: true
+  end
+end

data/lib/instagram_connect/version.rb

@@ -1,3 +1,3 @@
 module InstagramConnect
-  VERSION = "0.3.6"
+  VERSION = "0.3.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.7
 platform: ruby
 authors:
 - Kshitiz Sinha
@@ -101,6 +101,7 @@ files:
 - app/jobs/instagram_connect/replay_events_job.rb
 - 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/models/instagram_connect/account.rb
 - app/models/instagram_connect/api_budget.rb
 - app/models/instagram_connect/application_record.rb
@@ -143,6 +144,7 @@ files:
 - db/migrate/20260725204022_add_per_account_token_fields.rb
 - 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
 - docs/CONFIGURATION.md
 - docs/app_review_guide.md
 - docs/auth_paths.md