zenrows 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e684c8840821205883d52bd782aa3d22c8c21404bc9e3a4ab068f9069389e575
-  data.tar.gz: eed9546964086c061082a55aa4fa9218c5c24dfa02b70f20297b04b55fa77891
+  metadata.gz: 90e01f2bc9ea6afa174e3e0f5c94856c3ec6767b987da51ff61eebd8dda07184
+  data.tar.gz: 6d755c3e3822639e8b7f3b16e258a06e372dd71d4438adb883ff75fbbc7d0223
 SHA512:
-  metadata.gz: 31a6e6f8d95e0431cd7ce0bf545e813c64954021914eb67cf8312155b0c9d7cdea2ab1ede5378972757c1b148be0cd7be13e7ddda5ed2fbdb83cb30aad9fc18a
-  data.tar.gz: 74584d555a2915b1e0f8ac2fd0fb46ca78b21a80430c0e20f252237497a27087b4027e244c450222ae322b2f1ae2f0a02b59652daddc2069ac48783525d5cc69
+  metadata.gz: b387107cb2b90c8395180764f8bcc50b025722068eb0eb755eeeb169d19044e3cfdebcd0a3ba13ffc5654403013972803a62afeb2964f074bbaeb5ab8e5273d9
+  data.tar.gz: ec6134a37c804d3f2cef3919211f38dc0d17f7c617823c9c157ecee10cbd74062f348fabefda1fb6ee60039d672136c23d44ae250668544789ca7491aff52f03

data/lib/zenrows/proxy.rb

@@ -25,6 +25,9 @@ module Zenrows
     # Valid sticky TTL values for HTTP proxy
     VALID_STICKY_TTL = %w[30s 5m 30m 1h 1d].freeze
 
+    # Valid mode values for adaptive stealth mode
+    VALID_MODES = %w[auto].freeze
+
     # Valid region codes for HTTP proxy
     VALID_REGIONS = {
       "africa" => "af",
@@ -82,6 +85,7 @@ module Zenrows
     # @option options [String] :device Device emulation ('mobile' or 'desktop')
     # @option options [Boolean] :antibot Enhanced antibot bypass mode
     # @option options [String] :session_ttl Session duration ('30s', '5m', '30m', '1h', '1d')
+    # @option options [String] :mode Adaptive stealth mode ('auto')
     # @return [Hash] Proxy configuration with :host, :port, :username, :password
     # @raise [WaitTimeError] if wait time exceeds 3 minutes
     # @raise [ArgumentError] if session_ttl is invalid
@@ -125,14 +129,34 @@ module Zenrows
     def build_params(opts)
       params = {}
 
+      # Adaptive stealth mode handling
+      if opts[:mode]
+        mode = opts[:mode].to_s.downcase
+        unless VALID_MODES.include?(mode)
+          raise ArgumentError, "Invalid mode: #{mode}. Valid values: #{VALID_MODES.join(", ")}"
+        end
+
+        # mode=auto manages js_render and premium_proxy - warn if user tries to set them
+        if mode == "auto"
+          if opts[:js_render]
+            warn "[Zenrows] Warning: js_render is ignored when mode=auto (auto-managed)"
+          end
+          if opts[:premium_proxy]
+            warn "[Zenrows] Warning: premium_proxy is ignored when mode=auto (auto-managed)"
+          end
+        end
+
+        params[:mode] = mode
+      end
+
       # Custom headers must be enabled first if we'll use headers
       params[:custom_headers] = true if opts[:custom_headers]
 
-      # JavaScript rendering
-      params[:js_render] = true if opts[:js_render]
+      # JavaScript rendering (skip if mode=auto manages it)
+      params[:js_render] = true if opts[:js_render] && !params[:mode]
 
-      # Premium proxy
-      params[:premium_proxy] = true if opts[:premium_proxy]
+      # Premium proxy (skip if mode=auto manages it)
+      params[:premium_proxy] = true if opts[:premium_proxy] && !params[:mode]
 
       # Wait time handling
       if opts[:wait]
@@ -204,8 +228,8 @@ module Zenrows
         params[:session_ttl] = ttl
       end
 
-      # Auto-enable js_render if needed
-      params[:js_render] = true if requires_js_render?(params)
+      # Auto-enable js_render if needed (skip if mode=auto manages it)
+      params[:js_render] = true if requires_js_render?(params) && !params[:mode]
 
       params
     end

data/lib/zenrows/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zenrows
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/sig/zenrows/proxy.rbs

@@ -1,6 +1,7 @@
 class Zenrows::Proxy
   MAX_WAIT_MS: Integer
   VALID_STICKY_TTL: Array[String]
+  VALID_MODES: Array[String]
   VALID_REGIONS: Hash[String, String]
 
   attr_reader api_key: String

data/test/zenrows/hooks_thread_safety_test.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HooksThreadSafetyTest < Minitest::Test
+  def setup
+    @hooks = Zenrows::Hooks.new
+  end
+
+  def test_concurrent_registration
+    threads = 10.times.map do |i|
+      Thread.new do
+        10.times do |j|
+          @hooks.register(:on_response) { |_r, _c| "thread_#{i}_#{j}" }
+        end
+      end
+    end
+
+    threads.each(&:join)
+
+    # Should have 100 callbacks registered without corruption
+    refute_predicate @hooks, :empty?
+  end
+
+  def test_concurrent_hook_execution
+    counter = 0
+    mutex = Mutex.new
+
+    @hooks.register(:on_response) do |_r, _c|
+      mutex.synchronize { counter += 1 }
+    end
+
+    threads = 20.times.map do
+      Thread.new do
+        50.times { @hooks.run(:on_response, nil, {}) }
+      end
+    end
+
+    threads.each(&:join)
+
+    assert_equal 1000, counter
+  end
+
+  def test_concurrent_registration_and_execution
+    execution_count = 0
+    mutex = Mutex.new
+
+    @hooks.register(:on_response) do |_r, _c|
+      mutex.synchronize { execution_count += 1 }
+    end
+
+    registrars = 5.times.map do
+      Thread.new do
+        10.times do
+          @hooks.register(:on_response) do |_r, _c|
+            mutex.synchronize { execution_count += 1 }
+          end
+          sleep 0.001
+        end
+      end
+    end
+
+    executors = 5.times.map do
+      Thread.new do
+        20.times do
+          @hooks.run(:on_response, nil, {})
+          sleep 0.001
+        end
+      end
+    end
+
+    (registrars + executors).each(&:join)
+
+    assert_operator execution_count, :>, 0
+  end
+
+  def test_concurrent_subscriber_addition
+    subscribers = 10.times.map do |i|
+      subscriber = Object.new
+      subscriber.define_singleton_method(:on_response) { |_r, _c| "sub_#{i}" }
+      subscriber
+    end
+
+    threads = subscribers.map do |sub|
+      Thread.new { @hooks.add_subscriber(sub) }
+    end
+
+    threads.each(&:join)
+
+    refute_predicate @hooks, :empty?
+  end
+
+  def test_concurrent_around_hooks
+    @hooks.register(:around_request) do |_ctx, &block|
+      block.call
+    end
+
+    threads = 10.times.map do
+      Thread.new do
+        @hooks.run_around({}) { :result }
+      end
+    end
+
+    results = threads.map(&:value)
+
+    assert results.all? { |r| r == :result }
+  end
+
+  def test_dup_is_thread_safe
+    @hooks.register(:on_response) { |_r, _c| "original" }
+
+    copies = []
+    mutex = Mutex.new
+
+    threads = 10.times.map do
+      Thread.new do
+        copy = @hooks.dup
+        mutex.synchronize { copies << copy }
+      end
+    end
+
+    threads.each(&:join)
+
+    assert_equal 10, copies.size
+    copies.each { |copy| refute_predicate copy, :empty? }
+  end
+
+  def test_empty_check_during_concurrent_registration
+    results = []
+    mutex = Mutex.new
+
+    threads = 10.times.map do
+      Thread.new do
+        was_empty = @hooks.empty?
+        @hooks.register(:on_response) { |_r, _c| nil }
+        mutex.synchronize { results << was_empty }
+      end
+    end
+
+    threads.each(&:join)
+
+    # At least one thread should have seen empty? as true
+    assert_includes results, true
+    refute_predicate @hooks, :empty?
+  end
+end

data/test/zenrows/proxy_test.rb

@@ -150,4 +150,54 @@ class ProxyTest < Minitest::Test
       @proxy.build(session_ttl: "invalid")
     end
   end
+
+  def test_build_with_mode_auto
+    config = @proxy.build(mode: "auto")
+
+    assert_includes config[:password], "mode=auto"
+  end
+
+  def test_mode_auto_does_not_include_js_render_or_premium_proxy
+    config = @proxy.build(mode: "auto")
+
+    refute_includes config[:password], "js_render"
+    refute_includes config[:password], "premium_proxy"
+  end
+
+  def test_mode_auto_with_other_options
+    config = @proxy.build(mode: "auto", session_id: 123, wait_for: ".content")
+
+    assert_includes config[:password], "mode=auto"
+    assert_includes config[:password], "session_id=123"
+    assert_includes config[:password], "wait_for=.content"
+    refute_includes config[:password], "js_render"
+  end
+
+  def test_mode_auto_warns_when_js_render_set
+    _out, err = capture_io do
+      config = @proxy.build(mode: "auto", js_render: true)
+
+      assert_includes config[:password], "mode=auto"
+      refute_includes config[:password], "js_render"
+    end
+
+    assert_match(/js_render is ignored/, err)
+  end
+
+  def test_mode_auto_warns_when_premium_proxy_set
+    _out, err = capture_io do
+      config = @proxy.build(mode: "auto", premium_proxy: true)
+
+      assert_includes config[:password], "mode=auto"
+      refute_includes config[:password], "premium_proxy"
+    end
+
+    assert_match(/premium_proxy is ignored/, err)
+  end
+
+  def test_raises_on_invalid_mode
+    assert_raises ArgumentError do
+      @proxy.build(mode: "invalid")
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: zenrows
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ernest Bursa
 bindir: exe
 cert_chain: []
-date: 2025-12-30 00:00:00.000000000 Z
+date: 2026-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -104,6 +104,7 @@ files:
 - test/zenrows/hooks/context_test.rb
 - test/zenrows/hooks/log_subscriber_test.rb
 - test/zenrows/hooks_test.rb
+- test/zenrows/hooks_thread_safety_test.rb
 - test/zenrows/instrumented_client_test.rb
 - test/zenrows/js_instructions_test.rb
 - test/zenrows/proxy_test.rb