getfluxly 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b116ab1581f3a4774402e520e226448ebb08e91f41472871b550fa2f5b90138
-  data.tar.gz: 2e727e895ae664cb6bbb6f8520b550466e39c4ef68e3940b29f07f93f50f3607
+  metadata.gz: 7b553cd969af21278e3071f204d9d411f3834b4adfa8bf550c0b89c19808080f
+  data.tar.gz: ad1dd0761594bbdb6e51bdfa96ce953f5c024835eb1a6fd4a3dc9c881155a51c
 SHA512:
-  metadata.gz: a604060bfeccf108f38d1df090afcab54eaefe7bebb85320005978c7d250654df08faf26341b63e1dfe3a27306dac0207427e2bbf0d9f90871cf03ec4e0d8422
-  data.tar.gz: c3ae7ff9b11b088c972800e8bf4167d9ca4a6a58d8eb6cadb19ec836cf3616981575fa4aa3251a633130c5c58fb1fe5ac4883115c44ebc53223319a533a55545
+  metadata.gz: 28d163f2f11fb101529abc046586c4e095a64a5a16bd42b9b605f1f0862f7d5ef63eb2d90e04a585619080618bd38eade3d86a0fa989a4140316c95ffe1b75a8
+  data.tar.gz: 4434c2e2c16c502e1e2ae00c88d86b6c65fd6526c651e7c7f064fddd3db8886f33eb1a35767e84f051cb012e81aa79093dcef5ccaff1a71de8a76014ac2b935b

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `getfluxly` (Ruby) will be documented in this file.
 
+## [0.1.1] - 2026-06-23
+
+### Added
+- Each event payload now carries a stable `message_id` (UUID v4, snake_case key)
+  generated at build time in `track` and `identify`. The backend derives the
+  stored row id from `(project_id + message_id)` to deduplicate duplicate
+  deliveries. The per-batch `X-Idempotency-Key` header is unchanged.
+
 ## [0.1.0] - 2026-05-16
 
 ### Added

data/README.md

@@ -69,6 +69,10 @@ Defaults match Node and Python.
 
 Retries: 408, 425, 429, and 5xx with exponential backoff and +/- 25% jitter. `Retry-After` is honored. Each batch carries a unique `X-Idempotency-Key`.
 
+## Event deduplication
+
+Every event built by `track` and `identify` includes a `message_id` field (UUID v4) generated once when the payload is created. The backend derives the stored row id from `(project_id + message_id)` so retried batches are idempotent — duplicate deliveries of the same event are dropped automatically.
+
 ## Errors
 
 ```ruby

data/lib/getfluxly/client.rb

@@ -50,7 +50,7 @@ module GetFluxly
         user_id: user_id
       )
 
-      payload = { "event" => event }
+      payload = { "event" => event, "message_id" => Http.generate_message_id }
       payload["anonymous_id"] = anonymous_id if anonymous_id
       payload["external_id"] = external_id if external_id
       payload["user_id"] = user_id if user_id
@@ -68,7 +68,13 @@ module GetFluxly
         user_id: user_id
       )
 
-      payload = { "event" => "$identify" }
+      # FIXME: identify is not wired end to end. The backend treats only
+      # event == "identify" as an identify, but this sends "$identify", so
+      # identity stitching never runs. A plain rename will not fix it: the
+      # backend identify path requires BOTH anonymous_id and external_id,
+      # which a server identify usually lacks. Needs a server side identify
+      # contract first; until then use track() (see the SDK docs callout).
+      payload = { "event" => "$identify", "message_id" => Http.generate_message_id }
       payload["anonymous_id"] = anonymous_id if anonymous_id
       payload["external_id"] = external_id if external_id
       payload["user_id"] = user_id if user_id

data/lib/getfluxly/http.rb

@@ -54,6 +54,10 @@ module GetFluxly
       SecureRandom.uuid
     end
 
+    def self.generate_message_id
+      SecureRandom.uuid
+    end
+
     private
 
     def perform(uri, payload, headers)

data/lib/getfluxly/version.rb

@@ -4,5 +4,5 @@
 # run `ruby scripts/sync_version.rb` to regenerate.
 
 module GetFluxly
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: getfluxly
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - GetFluxly