getfluxly 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b116ab1581f3a4774402e520e226448ebb08e91f41472871b550fa2f5b90138
-  data.tar.gz: 2e727e895ae664cb6bbb6f8520b550466e39c4ef68e3940b29f07f93f50f3607
+  metadata.gz: a785fdebe171148a4796f039e87637fd1356c8236e962298399a1c6f0a2e735a
+  data.tar.gz: fd356389bcc839e35de4ac7d2942f796b8e045e815a455d9ebd9fb8d3b5db64d
 SHA512:
-  metadata.gz: a604060bfeccf108f38d1df090afcab54eaefe7bebb85320005978c7d250654df08faf26341b63e1dfe3a27306dac0207427e2bbf0d9f90871cf03ec4e0d8422
-  data.tar.gz: c3ae7ff9b11b088c972800e8bf4167d9ca4a6a58d8eb6cadb19ec836cf3616981575fa4aa3251a633130c5c58fb1fe5ac4883115c44ebc53223319a533a55545
+  metadata.gz: a6fb8a5a95dbd841e4e6a2c1844a28b4702a8be0798947ad1ecaaa4c1e30c2be21a468fa88a6fd4f6304bb06a4e8a745a85c082e2f16108934397b2da84b25a4
+  data.tar.gz: c698da31e1ad2814c7f3cf3fdcb16e86ad6b9da86040c1ae49247da6a9fbe6e194d579e42952e231b21e7242cd36fc3de69817962250cd7fdb9a32c50e4ea89f

data/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to `getfluxly` (Ruby) will be documented in this file.
 
+## [0.1.2] - 2026-07-03
+
+### Fixed
+- `flush_interval` now works: the client starts a background flusher thread
+  on the first enqueued event that drains the queue every `flush_interval`
+  seconds. Previously the parameter was accepted but never used, so events
+  only left the process when the queue reached `flush_at` (default 20), on an
+  explicit `flush`, or at graceful interpreter exit — low-volume producers
+  effectively never delivered. Set `flush_interval: 0` to disable the flusher
+  and restore the old behavior. The flusher survives `fork` (restarts in the
+  child) and a failed scheduled flush warns and retries on the next tick.
+
+## [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

@@ -4,8 +4,10 @@ module GetFluxly
   # Synchronous GetFluxly client.
   #
   # Batches events with retry, jitter, and X-Idempotency-Key.
-  # The background flusher thread drains the queue every
-  # `flush_interval` seconds. at_exit runs a final flush.
+  # A batch goes out when the queue reaches `flush_at`, when the
+  # background flusher thread fires (every `flush_interval` seconds
+  # once the first event is enqueued; `<= 0` disables it), on an
+  # explicit `flush`, and at_exit.
   class Client
     DEFAULT_API_HOST = "https://api.getfluxly.com"
     EVENTS_BATCH_PATH = "/v1/events/batch"
@@ -32,6 +34,11 @@ module GetFluxly
       @http = Http.new(token: token, api_host: api_host, timeout: timeout, max_retries: max_retries)
       @shutdown = false
       @shutdown_mutex = Mutex.new
+      @flusher = nil
+      @flusher_pid = nil
+      @wake_mutex = Mutex.new
+      @wake = ConditionVariable.new
+      @woken = false
 
       return unless register_atexit
 
@@ -50,7 +57,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 +75,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
@@ -132,11 +145,24 @@ module GetFluxly
     end
 
     def shutdown
+      flusher = nil
       @shutdown_mutex.synchronize do
         return Batch.empty_flush_result if @shutdown
 
         @shutdown = true
+        flusher = @flusher
+        @flusher = nil
       end
+      # Wake the flusher so it exits promptly, and wait for it so a
+      # scheduled flush can't race the final flush below. The join is
+      # bounded by one in-flight HTTP round-trip (timeout x retries).
+      # @woken makes the wake sticky: a broadcast that lands before the
+      # flusher reaches wait would otherwise be lost.
+      @wake_mutex.synchronize do
+        @woken = true
+        @wake.broadcast
+      end
+      flusher&.join(30) unless flusher == Thread.current
       flush
     end
 
@@ -146,9 +172,42 @@ module GetFluxly
 
     def enqueue(payload)
       size = @batch.enqueue(payload)
+      ensure_flusher
       return flush if size >= @flush_at
 
       nil
     end
+
+    def ensure_flusher
+      return if @flush_interval <= 0
+
+      @shutdown_mutex.synchronize do
+        return if @shutdown
+        # Threads don't survive fork; the pid check restarts the
+        # flusher in forked workers (puma, sidekiq).
+        return if @flusher&.alive? && @flusher_pid == Process.pid
+
+        @flusher_pid = Process.pid
+        @flusher = Thread.new { flush_loop }
+        @flusher.name = "getfluxly-flusher"
+      end
+    end
+
+    def flush_loop
+      loop do
+        @wake_mutex.synchronize do
+          @wake.wait(@wake_mutex, @flush_interval) unless @woken
+        end
+        return if @shutdown
+
+        begin
+          flush
+        rescue StandardError => e
+          # A failed scheduled flush must not kill the thread; flush
+          # already requeued any retryable batch.
+          warn("[GetFluxly] scheduled flush failed: #{e.class}: #{e.message}")
+        end
+      end
+    end
   end
 end

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.2"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: getfluxly
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - GetFluxly
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -95,6 +96,7 @@ metadata:
   bug_tracker_uri: https://github.com/dineshmiriyala/getfluxly/issues
   changelog_uri: https://github.com/dineshmiriyala/getfluxly/blob/main/packages/ruby/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -109,7 +111,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: GetFluxly Ruby SDK
 test_files: []