tina4ruby 3.11.16 → 3.11.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a33bdb237a1acedfe4903a9145ded69e405e9e63403c9a8c2e548795060d2740
-  data.tar.gz: bf61f8a4a84be8f910c9767a23437ec8fbc4820fb3eb05da3ef73657b16f2585
+  metadata.gz: 2aa9ce02d7a7c924ae48d78b5ed1485261b85cde643ab13501040ea5bc7145da
+  data.tar.gz: f97407bec1e490e48714ae6d00ee78ad211b74e50ec0f94325d92f3dbf935e43
 SHA512:
-  metadata.gz: 1c43c2556e8b8b742a1cb1cb52e26b011b1c64b56cdfb636fbfdf569789f0c7fa0d25094a201cda3d301fc9982832acfe60c01c4221b033e58a41dc6b06e7eea
-  data.tar.gz: 8b38f262f9a5e41f3635000b22668200127c20cfe864bc18b316758ebbefeb58c4a4022961e929b0213a3a0e1657becf2348cdbcecf79c37f3f9561f7fa3bbdc
+  metadata.gz: c2bfb361e4de75738221dbdfb8f7a070cf224b71d02c389b0bc62171dd6566dea13d8fb0677f119ef331295d234fb1269d4a5a6573d026302d1c9d6c1b75a8e4
+  data.tar.gz: ac914458d86220ae3788f9a7da1a3cd427d4b0901139b53f57e007f93103bb5d82ded233b449dcebad4ae8145624ca971e9d056d36ae103f808b66c5a67689b3

data/lib/tina4/background.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Tina4
+  # Periodic background task registry.
+  #
+  # Matches Python's `tina4_python.core.server.background(fn, interval)` and
+  # PHP's `$app->background($callback, $interval)` — a callback that runs
+  # periodically alongside the server lifecycle.
+  #
+  # Ruby has no asyncio event loop, so each task runs in its own thread.
+  # The GIL keeps it cooperative-enough for the periodic work this is meant
+  # for (queue draining, health checks, simulators). Errors in the callback
+  # are caught and logged so they don't kill the thread.
+  module Background
+    class << self
+      # Register a periodic callback.
+      #
+      # @param callback [#call, nil] Object responding to `call` with no args.
+      # @param interval [Float] Seconds between invocations (default 1.0).
+      # @param block    [Proc]   Optional block (used if callback is nil).
+      # @return [Hash] The registered task descriptor.
+      def register(callback = nil, interval: 1.0, &block)
+        cb = callback || block
+        raise ArgumentError, "background requires a callback or block" if cb.nil?
+        raise ArgumentError, "callback must respond to :call" unless cb.respond_to?(:call)
+
+        task = { callback: cb, interval: interval.to_f, thread: nil, running: false }
+        mutex.synchronize { tasks << task }
+        start_task(task)
+        task
+      end
+
+      # All registered task descriptors. Tests use this for introspection.
+      def tasks
+        @tasks ||= []
+      end
+
+      # Stop and join every running task. Called on graceful shutdown.
+      def stop_all(timeout: 2.0)
+        snapshot = mutex.synchronize { tasks.dup }
+        snapshot.each { |task| stop_task(task, timeout: timeout) }
+        mutex.synchronize { tasks.clear }
+      end
+
+      # Stop a single task. Used by tests that register, fire, then stop.
+      def stop_task(task, timeout: 2.0)
+        task[:running] = false
+        thread = task[:thread]
+        return unless thread
+
+        thread.join(timeout) || thread.kill
+        task[:thread] = nil
+      end
+
+      private
+
+      def mutex
+        @mutex ||= Mutex.new
+      end
+
+      def start_task(task)
+        task[:running] = true
+        task[:thread] = Thread.new do
+          while task[:running]
+            sleep task[:interval]
+            break unless task[:running]
+
+            begin
+              task[:callback].call
+            rescue => e
+              # Never let a callback error kill the thread — next interval still fires.
+              if defined?(Tina4::Log) && Tina4::Log.respond_to?(:error)
+                Tina4::Log.error("background task error: #{e.class}: #{e.message}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tina4/dev_admin.rb

@@ -407,7 +407,9 @@ module Tina4
           resolved = id ? error_tracker.resolve(id) : false
           json_response({ resolved: resolved, id: id })
         when ["POST", "/__dev/api/broken/clear"]
-          error_tracker.clear_resolved
+          # "Clear All" button — flush every tracked error, not only the
+          # ones individually marked resolved. Matches PHP/Python.
+          error_tracker.clear_all
           json_response({ cleared: true })
         when ["GET", "/__dev/api/websockets"]
           json_response({ connections: [], count: 0 })