instagram_connect 0.3.17 → 0.3.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e14ef34f00e794b30aa2426b8c98c2b8dda7546c8b8c9ef86703b22a7ecbed4
-  data.tar.gz: 0a8ef8889d73b990c0cb643c23ac285b3758a7b56526fed12039f6d9fb25c501
+  metadata.gz: 1a7dcce7b2dae41f81ed1e5d6f03a34a629c6e5ae90125bb673cb47eaea098f1
+  data.tar.gz: 8941b7ec8f788b2cd8e007282ba06d1a1480d2ed89bf2fd4f177e56aed384b1b
 SHA512:
-  metadata.gz: f90f4345d58617e5a70ff2f138f4151e73d7bc09976537e9c0e9553aa16b6b0443ca4330534712e7b048f214e5c4104d422fe4efcf2aa03380730e6c39998348
-  data.tar.gz: 17fc37a2ae066b15f0d3978e3483d4b5c69bd91203c8d8c07ec09e03bd0836b788e55cc706c6bd6958912d58902042a6975e760f78d6bc1c02f59a544d1ec2cc
+  metadata.gz: 779d9af0a92b505f7a93ca0b6502b8c82e6a4286782da41ddeb26f698a227e8107b56458d6a9a13bd504ff4d625a2a5414d062dfbec15f6b8eaeb33aeec794f3
+  data.tar.gz: 846973e8a0ed72106f650fa4342d493c15c4f5e4d79b87155c32a84e7545d96487403d5659d0587be3a4c7de2068089eb59afb3c8c003ac787746f8eac787c7a

data/CHANGELOG.md

@@ -6,6 +6,23 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.18] - 2026-07-28
+
+### Added
+
+- **The comment-triggered DM (private reply) can carry quick replies.** It rides the full
+  messaging endpoint, so a funnel can open with buttons — titles clipped to Meta's 20 characters.
+
+### Fixed
+
+- **Comment webhooks no longer arrive stamped January 1970.** Meta sends messaging-webhook
+  timestamps in MILLISECONDS but comment/mention change webhooks in SECONDS; dividing everything
+  by 1000 collapsed every comment's clock to the epoch — which downstream read as "older than
+  Meta's 7-day reply window" and silently skipped every realtime comment automation.
+  `Envelope.time_from` now decides the unit by magnitude, so no caller has to know which field a
+  value came from.
+
+
 ## [0.3.17] - 2026-07-28
 
 ### Added

data/lib/instagram_connect/client.rb

@@ -89,8 +89,19 @@ module InstagramConnect
     end
 
     # One-time private reply to a comment (comment -> DM), valid 7 days.
-    def private_reply(comment_id:, text:)
-      post("/me/messages", { recipient: { comment_id: comment_id }, message: { text: text } })
+    # The one DM a comment entitles us to send. It rides the full messaging
+    # endpoint (recipient by comment_id), so it can carry quick replies —
+    # which is how a comment-triggered funnel opens with buttons.
+    def private_reply(comment_id:, text:, quick_replies: nil)
+      message = { text: text }
+      if quick_replies.present?
+        message[:quick_replies] = Array(quick_replies).map do |reply|
+          { content_type: "text",
+            title: reply[:title].to_s[0, 20],
+            payload: reply[:payload].to_s }
+        end
+      end
+      post("/me/messages", { recipient: { comment_id: comment_id }, message: message })
     end
 
     # --- Comments --------------------------------------------------------

data/lib/instagram_connect/ingest/envelope.rb

@@ -11,13 +11,23 @@ module InstagramConnect
       # storing it would corrupt every ordering that reads occurred_at.
       MAX_SECONDS = 4_102_444_800 # 2100-01-01
 
-      # Meta timestamps are milliseconds since the epoch. Ordering off this
-      # rather than our own created_at is what stops a delayed webhook batch
-      # silently reordering a conversation.
-      def self.time_from(millis)
-        return nil if millis.nil?
+      # Below this, a value can only be SECONDS since the epoch: the smallest
+      # millisecond timestamp Meta could send (year 2001+) is ~10^12, and a
+      # second-count will not reach 10^11 until the year 5138.
+      MILLIS_FLOOR = 100_000_000_000
 
-        seconds = millis.to_i / 1000.0
+      # Meta is inconsistent on the wire: messaging webhooks stamp in
+      # MILLISECONDS, comment/mention change webhooks stamp entry.time in
+      # SECONDS. Dividing everything by 1000 turned every comment webhook's
+      # clock into January 1970 — which read as "older than Meta's 7-day
+      # reply window" and silently skipped every realtime comment automation.
+      # The magnitude decides the unit; no caller has to know which field it
+      # came from.
+      def self.time_from(value)
+        return nil if value.nil?
+
+        number = value.to_i
+        seconds = number >= MILLIS_FLOOR ? number / 1000.0 : number.to_f
         return nil unless seconds.finite? && seconds >= 0 && seconds <= MAX_SECONDS
 
         Time.at(seconds).utc

data/lib/instagram_connect/usage.rb

@@ -1,5 +1,9 @@
 require "json"
 
+# blank?/present? on plain objects — this file must not depend on which
+# spec or host loaded ActiveSupport core extensions first.
+require "active_support/core_ext/object/blank"
+
 module InstagramConnect
   # Meta's own account of how much of the rate budget a call just consumed,
   # parsed from the response headers.

data/lib/instagram_connect/version.rb

@@ -1,3 +1,3 @@
 module InstagramConnect
-  VERSION = "0.3.17"
+  VERSION = "0.3.18"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.17
+  version: 0.3.18
 platform: ruby
 authors:
 - Kshitiz Sinha