getfluxly 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b553cd969af21278e3071f204d9d411f3834b4adfa8bf550c0b89c19808080f
-  data.tar.gz: ad1dd0761594bbdb6e51bdfa96ce953f5c024835eb1a6fd4a3dc9c881155a51c
+  metadata.gz: a785fdebe171148a4796f039e87637fd1356c8236e962298399a1c6f0a2e735a
+  data.tar.gz: fd356389bcc839e35de4ac7d2942f796b8e045e815a455d9ebd9fb8d3b5db64d
 SHA512:
-  metadata.gz: 28d163f2f11fb101529abc046586c4e095a64a5a16bd42b9b605f1f0862f7d5ef63eb2d90e04a585619080618bd38eade3d86a0fa989a4140316c95ffe1b75a8
-  data.tar.gz: 4434c2e2c16c502e1e2ae00c88d86b6c65fd6526c651e7c7f064fddd3db8886f33eb1a35767e84f051cb012e81aa79093dcef5ccaff1a71de8a76014ac2b935b
+  metadata.gz: a6fb8a5a95dbd841e4e6a2c1844a28b4702a8be0798947ad1ecaaa4c1e30c2be21a468fa88a6fd4f6304bb06a4e8a745a85c082e2f16108934397b2da84b25a4
+  data.tar.gz: c698da31e1ad2814c7f3cf3fdcb16e86ad6b9da86040c1ae49247da6a9fbe6e194d579e42952e231b21e7242cd36fc3de69817962250cd7fdb9a32c50e4ea89f

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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

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
 
@@ -138,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
 
@@ -152,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/version.rb

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

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: getfluxly
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  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: []