vizzly 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83c5bb29a091449d684562effec3161f0ddab82fe2be22b3d357cb66723d44b9
-  data.tar.gz: 1a97c02f6b0d670a6841d9536ee7fe434340b5ca210bf315f764a03e350e360c
+  metadata.gz: 0d871ec31907ae78a9790e8763340300d5b3b0860048ad3bde1d540e8de746e2
+  data.tar.gz: e03b0e7d53d526c82d813a3a9435cb3bb77a7af9450c2de5ddc03f09f7c05815
 SHA512:
-  metadata.gz: 64a47f4a33270a9a82c4c1edbe267e4ef2eedd7f0f096859f28a306aa53d90401ffb3440cc5f7191a2138e2a6ac732dc1214b4d029c911e3d7d705f30a692056
-  data.tar.gz: f16bd4924bcfc9a2ddadbe0d639f01267853a1d2107dab97eb65e2d7ff1f01d63a21bd8db82a76cb4d1c281bacde9bc3fae38d194733dfb26f1f465a98ff68b3
+  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,19 +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)
@@ -124,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}"
@@ -131,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.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Vizzly
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-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