tina4ruby 3.10.11 → 3.10.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4966bc1955a5ee02eba12ebc9d43a72ba8f1572a2953dc285857f1f6d0f42a02
-  data.tar.gz: eabb1a3be1213f34353a0adf4bca93fba38f7bb7e15574ee76888e02d163f29a
+  metadata.gz: 58885d2a44c72f086b6359780fe7f01f88870bf3491973d9f1068934bb8780e1
+  data.tar.gz: c567b4d7a4a027d460da4bd528204ffd7ba3ce4aa6e0b3e5d303c748d00f12fe
 SHA512:
-  metadata.gz: de40973a6d1f36c8dc4b18a6a360e9647d59aa5b94803890d32a9f39bd0bd9350d208683337082f49a4df6dbde066eacdd63aaa4bb8a070dc68feddf9d0a5612
-  data.tar.gz: 80bbc66c2c78d07177bcee66f21fd9fb0f5ef4b4a7148284dd65b6cb4c5344f2132c9bbe4a1dae2839ab0803865f78660dad318099354625454b26b4c4cf61b6
+  metadata.gz: 409514dda53214f3f02d36dacd58b845cd9c282e63e814590be34c13e4cac839e8c8f6c6dc571575c434d0736a055109f12e3b56f76087ceee2d4b046930b1e8
+  data.tar.gz: caaa5dc05a96d5061bc3e70af18371d5e3fb7e8c10bd8e03cc84ca47be1863527814d478ec5788654b417d13ee754cc84f575ccb3ec43a5c16826fff798a5a52

data/lib/tina4/rack_app.rb

@@ -107,6 +107,16 @@ module Tina4
         if request_obj&.instance_variable_get(:@session)
           sess = request_obj.session
           sess.save
+
+          # Probabilistic garbage collection (~1% of requests)
+          if rand(1..100) == 1
+            begin
+              sess.gc
+            rescue StandardError
+              # GC failure is non-critical — silently ignore
+            end
+          end
+
           sid = sess.id
           cookie_val = (env["HTTP_COOKIE"] || "")[/tina4_session=([^;]+)/, 1]
           if sid && sid != cookie_val

data/lib/tina4/session_handlers/database_handler.rb

@@ -56,6 +56,12 @@ module Tina4
         @db.execute("DELETE FROM #{TABLE_NAME} WHERE expires_at > 0 AND expires_at < ?", [Time.now.to_f])
       end
 
+      # Garbage-collect expired sessions. Matches the Python interface.
+      # @param max_age [Integer] maximum session age in seconds (unused — expiry is absolute)
+      def gc(max_age)
+        @db.execute("DELETE FROM #{TABLE_NAME} WHERE expires_at > 0 AND expires_at < ?", [Time.now.to_f])
+      end
+
       private
 
       def ensure_table

data/lib/tina4/session_handlers/file_handler.rb

@@ -44,6 +44,18 @@ module Tina4
         end
       end
 
+      # Garbage-collect expired sessions. Matches the Python interface.
+      # @param max_age [Integer] maximum session age in seconds
+      def gc(max_age)
+        return unless Dir.exist?(@dir)
+        now = Time.now
+        Dir.glob(File.join(@dir, "sess_*")).each do |file|
+          File.delete(file) if File.mtime(file) + max_age < now
+        rescue StandardError
+          # Corrupt or locked file — skip
+        end
+      end
+
       private
 
       def session_path(session_id)

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.10.11"
+  VERSION = "3.10.12"
 end

data/lib/tina4/websocket_backplane.rb

@@ -56,7 +56,7 @@ module Tina4
       when "redis"
         RedisBackplane.new(url: url)
       when "nats"
-        raise NotImplementedError, "NATS backplane is on the roadmap but not yet implemented."
+        NATSBackplane.new(url: url)
       when ""
         nil
       else
@@ -115,4 +115,76 @@ module Tina4
       @redis.close
     end
   end
+
+  # NATS pub/sub backplane.
+  #
+  # Requires the +nats-pure+ gem (+gem install nats-pure+). The require is
+  # deferred so the rest of Tina4 works fine without it installed — an error
+  # is raised only when this class is actually instantiated.
+  #
+  # NATS is async-native, so we run a background thread with an event
+  # machine for the subscription listener.
+  class NATSBackplane < WebSocketBackplane
+    def initialize(url: nil)
+      begin
+        require "nats/client"
+      rescue LoadError
+        raise LoadError,
+          "The 'nats-pure' gem is required for NATSBackplane. " \
+          "Install it with: gem install nats-pure"
+      end
+
+      @url = url || ENV.fetch("TINA4_WS_BACKPLANE_URL", "nats://localhost:4222")
+      @subs = {}
+      @threads = {}
+      @running = true
+      @mutex = Mutex.new
+
+      # Connect to NATS in a background thread with its own event loop
+      @nats = NATS::IO::Client.new
+      @nats.connect(@url)
+    end
+
+    def publish(channel, message)
+      @nats.publish(channel, message)
+      @nats.flush
+    end
+
+    def subscribe(channel, &block)
+      @mutex.synchronize do
+        sid = @nats.subscribe(channel) do |msg|
+          block.call(msg.data) if @running
+        end
+        @subs[channel] = sid
+
+        # Run NATS event processing in a background thread
+        @threads[channel] ||= Thread.new do
+          loop do
+            break unless @running
+            sleep 0.01
+          end
+        end
+      end
+    end
+
+    def unsubscribe(channel)
+      @mutex.synchronize do
+        sid = @subs.delete(channel)
+        @nats.unsubscribe(sid) if sid
+        thread = @threads.delete(channel)
+        thread&.kill
+      end
+    end
+
+    def close
+      @running = false
+      @mutex.synchronize do
+        @subs.each_value { |sid| @nats.unsubscribe(sid) rescue nil }
+        @subs.clear
+        @threads.each_value { |t| t.kill }
+        @threads.clear
+      end
+      @nats.close
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.10.11
+  version: 3.10.12
 platform: ruby
 authors:
 - Tina4 Team