vizzly 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0011bf796b1114bd00011a649d41cb860d4658cc4d98164f53d4e2308404d6c2
-  data.tar.gz: 14551857950efde73e174cb04d46be7192724262978f4a009f99bde06da9daea
+  metadata.gz: 0d871ec31907ae78a9790e8763340300d5b3b0860048ad3bde1d540e8de746e2
+  data.tar.gz: e03b0e7d53d526c82d813a3a9435cb3bb77a7af9450c2de5ddc03f09f7c05815
 SHA512:
-  metadata.gz: c66401d88b74442243b1f01c44a479d58844c0448c3b954bedcd823ea777a96408d87ce98e6b02b8a3812751a4381ff0073a448d469c2156a45169a17154d104
-  data.tar.gz: 3c30f1d6e5cd13ce62a2a779fce10410f8b0f525e29fa92ecfe10cf520c7ac4db33ff9defb241967ee21c0fff94a8293cae6aee009b274ba5dadfc1437baaa90
+  metadata.gz: b482c246a5e588d07548a4ffdcf8a9bf61f158510ad49238e242a8fc5a26f0eb24ff02603a3623c9414ca069a6e553248d0d1aae0bd4da2dcdb7711d97ca18c1
+  data.tar.gz: 1109017a272528539721084733f5f5ad0b6e1d50cbd9b077c0cecec588544cdf684dffea7f408dfc0cfbdf1a1dbcab28d898711e00f454a748b0c09e4b62b484

data/lib/vizzly.rb

@@ -27,6 +27,7 @@ module Vizzly
     # @param options [Hash] Optional configuration
     # @option options [Hash] :properties Additional properties to attach
     # @option options [Integer] :threshold Pixel difference threshold (0-100)
+    # @option options [Integer] :min_cluster_size Minimum cluster size to count as a real difference (default: 2)
     # @option options [Boolean] :full_page Whether this is a full page screenshot
     #
     # @return [Hash, nil] Response data or nil if disabled/failed
@@ -41,6 +42,7 @@ module Vizzly
     #     properties: { browser: 'chrome', viewport: { width: 1920, height: 1080 } },
     #     threshold: 5
     #   )
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
     def screenshot(name, image_data, options = {})
       return nil if disabled?
 
@@ -52,20 +54,26 @@ module Vizzly
 
       image_base64 = Base64.strict_encode64(image_data)
 
+      # Build properties hash - comparison options merged with user properties
+      # Server extracts threshold/minClusterSize from properties, not top-level
+      properties = (options[:properties] || {}).merge(
+        threshold: options[:threshold],
+        minClusterSize: options[:min_cluster_size],
+        fullPage: options[:full_page]
+      ).compact
+
       payload = {
         name: name,
         image: image_base64,
         type: 'base64',
         buildId: ENV.fetch('VIZZLY_BUILD_ID', nil),
-        threshold: options[:threshold] || 0,
-        fullPage: options[:full_page] || false,
-        properties: options[:properties] || {}
+        properties: properties
       }.compact
 
       uri = URI("#{@server_url}/screenshot")
 
       begin
-        response = Net::HTTP.start(uri.host, uri.port, read_timeout: 30) do |http|
+        response = Net::HTTP.start(uri.host, uri.port, open_timeout: 10, read_timeout: 30) do |http|
           request = Net::HTTP::Post.new(uri)
           request['Content-Type'] = 'application/json'
           request.body = JSON.generate(payload)
@@ -125,6 +133,18 @@ module Vizzly
         # Disable the SDK after first failure to prevent spam
         disable!('failure')
 
+        nil
+      rescue Net::OpenTimeout
+        warn "Vizzly connection timed out for #{name}: couldn't connect within 10s"
+        warn "Server URL: #{@server_url}/screenshot"
+        warn 'This usually means the server is unreachable (firewall, network issue, or wrong host)'
+        disable!('failure')
+        nil
+      rescue Net::ReadTimeout
+        warn "Vizzly request timed out for #{name}: no response within 30s"
+        warn "Server URL: #{@server_url}/screenshot"
+        warn 'The server may be overloaded or processing is taking too long'
+        disable!('failure')
         nil
       rescue StandardError => e
         warn "Vizzly screenshot failed for #{name}: #{e.message}"
@@ -132,6 +152,7 @@ module Vizzly
         nil
       end
     end
+    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
     # Wait for all queued screenshots to be processed
     # (Simple client doesn't need explicit flushing)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vizzly
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Vizzly
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-07 00:00:00.000000000 Z
+date: 2026-02-04 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight client SDK for capturing screenshots and sending them to
   Vizzly for visual regression testing