crawlberg 1.3.3 → 1.4.2

data/lib/crawlberg/native.rb

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:468e05d35782efa941278f63a0e1f24595cf4a534fa469e7747a18fe91938bbf
+# alef:hash:925532ba2f606ce36a0d3444d5c96407ca56a1c55bcd256372a1ea2a383d11e5
 # To regenerate: alef generate
 # To verify freshness: alef verify
 # frozen_string_literal: true
@@ -18,7 +18,7 @@ library_candidates = dlexts.flat_map do |dlext|
     File.join(__dir__, "..", extension_name, ruby_abi, "#{extension_name}.#{dlext}"),
     File.join(__dir__, "..", extension_name, ruby_abi, "lib#{extension_name}.#{dlext}"),
     File.join(__dir__, "..", "#{extension_name}.#{dlext}"),
-    File.join(__dir__, "..", "lib#{extension_name}.#{dlext}"),
+    File.join(__dir__, "..", "lib#{extension_name}.#{dlext}")
   ]
 end
 
@@ -34,6 +34,7 @@ unless native_extension
 end
 
 require native_extension
+
 module Crawlberg
   # Authentication configuration.
   module AuthConfig
@@ -49,10 +50,14 @@ module Crawlberg
     def self.from_hash(hash)
       discriminator = hash[:type] || hash["type"]
       case discriminator
-      when "basic" then AuthConfigBasic.from_hash(hash)
-      when "bearer" then AuthConfigBearer.from_hash(hash)
-      when "header" then AuthConfigHeader.from_hash(hash)
-      else raise "Unknown discriminator: #{discriminator}"
+      when "basic"
+        AuthConfigBasic.from_hash(hash)
+      when "bearer"
+        AuthConfigBearer.from_hash(hash)
+      when "header"
+        AuthConfigHeader.from_hash(hash)
+      else
+        raise "Unknown discriminator: #{discriminator}"
       end
     end
   end
@@ -63,10 +68,12 @@ module Crawlberg
 
     # Username sent in the `Authorization: Basic` header.
     sig { returns(String) }
-    def username = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def username = super
     # Password sent in the `Authorization: Basic` header.
     sig { returns(String) }
-    def password = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def password = super
     sig { returns(T::Boolean) }
     def basic? = true
     sig { returns(T::Boolean) }
@@ -87,7 +94,8 @@ module Crawlberg
 
     # Token sent in the `Authorization: Bearer` header.
     sig { returns(String) }
-    def token = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def token = super
     sig { returns(T::Boolean) }
     def basic? = false
     sig { returns(T::Boolean) }
@@ -108,10 +116,12 @@ module Crawlberg
 
     # HTTP header name to set on each request.
     sig { returns(String) }
-    def name = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def name = super
     # HTTP header value to send.
     sig { returns(String) }
-    def value = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def value = super
     sig { returns(T::Boolean) }
     def basic? = false
     sig { returns(T::Boolean) }
@@ -147,10 +157,14 @@ module Crawlberg
     def self.from_hash(hash)
       discriminator = hash[:type] || hash["type"]
       case discriminator
-      when "page" then CrawlEventPage.from_hash(hash)
-      when "error" then CrawlEventError.from_hash(hash)
-      when "complete" then CrawlEventComplete.from_hash(hash)
-      else raise "Unknown discriminator: #{discriminator}"
+      when "page"
+        CrawlEventPage.from_hash(hash)
+      when "error"
+        CrawlEventError.from_hash(hash)
+      when "complete"
+        CrawlEventComplete.from_hash(hash)
+      else
+        raise "Unknown discriminator: #{discriminator}"
       end
     end
   end
@@ -161,7 +175,8 @@ module Crawlberg
 
     # The crawled page result.
     sig { returns(CrawlPageResult) }
-    def result = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def result = super
     sig { returns(T::Boolean) }
     def page? = true
     sig { returns(T::Boolean) }
@@ -182,10 +197,12 @@ module Crawlberg
 
     # The URL that failed.
     sig { returns(String) }
-    def url = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def url = super
     # The error message.
     sig { returns(String) }
-    def error = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def error = super
     sig { returns(T::Boolean) }
     def page? = false
     sig { returns(T::Boolean) }
@@ -206,7 +223,8 @@ module Crawlberg
 
     # Total number of pages crawled.
     sig { returns(Integer) }
-    def pages_crawled = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def pages_crawled = super
     sig { returns(T::Boolean) }
     def page? = false
     sig { returns(T::Boolean) }
@@ -222,6 +240,115 @@ module Crawlberg
   end
 end
 
+module Crawlberg
+  # Hostname/IP allowlist matcher for SSRF policy.
+  #
+  # Serializes as an internally-tagged object so each variant is distinguishable on the
+  # wire and round-trips losslessly:
+  #
+  # ```json
+  # {"type": "exact",  "value": "api.example.com"}
+  # {"type": "suffix", "value": ".example.com"}
+  # {"type": "cidr",   "value": "10.0.0.0/8"}
+  # ```
+  #
+  # A bare JSON string is still accepted on deserialization and resolves to [`Exact`],
+  # preserving configs written against the previous untagged representation.
+  #
+  # [`Exact`]: HostMatcher::Exact
+  module HostMatcher
+    extend T::Helpers
+    extend T::Sig
+
+    interface!
+
+    # Dispatch from a Hash to the appropriate variant constructor.
+    # @param hash [Hash] with discriminator field and variant-specific fields
+    # @return [variant_class] an instance of the appropriate variant
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.untyped) }
+    def self.from_hash(hash)
+      discriminator = hash[:type] || hash["type"]
+      case discriminator
+      when "exact"
+        HostMatcherExact.from_hash(hash)
+      when "suffix"
+        HostMatcherSuffix.from_hash(hash)
+      when "cidr"
+        HostMatcherCidr.from_hash(hash)
+      else
+        raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+  end
+  ## Exact hostname match (case-insensitive).
+  HostMatcherExact = Data.define(:value) do
+    include HostMatcher
+    extend T::Sig
+
+    # The hostname to match.
+    sig { returns(String) }
+    # rubocop:disable Lint/UselessMethodDefinition
+    def value = super
+    sig { returns(T::Boolean) }
+    def exact? = true
+    sig { returns(T::Boolean) }
+    def suffix? = false
+    sig { returns(T::Boolean) }
+    def cidr? = false
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(value: hash[:value] || hash["value"])
+    end
+  end
+  ## Suffix match: ".xberg.io" matches "api.xberg.io" and "xberg.io".
+  HostMatcherSuffix = Data.define(:value) do
+    include HostMatcher
+    extend T::Sig
+
+    # The dot-prefixed suffix to match. A leading dot is optional.
+    sig { returns(String) }
+    # rubocop:disable Lint/UselessMethodDefinition
+    def value = super
+    sig { returns(T::Boolean) }
+    def exact? = false
+    sig { returns(T::Boolean) }
+    def suffix? = true
+    sig { returns(T::Boolean) }
+    def cidr? = false
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(value: hash[:value] || hash["value"])
+    end
+  end
+  ## CIDR match: "10.0.0.0/8" matches IP addresses in that range.
+  HostMatcherCidr = Data.define(:value) do
+    include HostMatcher
+    extend T::Sig
+
+    # The CIDR block. Validated when built through [`HostMatcher::cidr`] or
+    # deserialization.
+    sig { returns(String) }
+    # rubocop:disable Lint/UselessMethodDefinition
+    def value = super
+    sig { returns(T::Boolean) }
+    def exact? = false
+    sig { returns(T::Boolean) }
+    def suffix? = false
+    sig { returns(T::Boolean) }
+    def cidr? = true
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(value: hash[:value] || hash["value"])
+    end
+  end
+end
+
 module Crawlberg
   # A single page interaction action.
   #
@@ -240,15 +367,24 @@ module Crawlberg
     def self.from_hash(hash)
       discriminator = hash[:type] || hash["type"]
       case discriminator
-      when "click" then PageActionClick.from_hash(hash)
-      when "type" then PageActionTypeText.from_hash(hash)
-      when "press" then PageActionPress.from_hash(hash)
-      when "scroll" then PageActionScroll.from_hash(hash)
-      when "wait" then PageActionWait.from_hash(hash)
-      when "screenshot" then PageActionScreenshot.from_hash(hash)
-      when "executeJs" then PageActionExecuteJs.from_hash(hash)
-      when "scrape" then PageActionScrape.from_hash(hash)
-      else raise "Unknown discriminator: #{discriminator}"
+      when "click"
+        PageActionClick.from_hash(hash)
+      when "type"
+        PageActionTypeText.from_hash(hash)
+      when "press"
+        PageActionPress.from_hash(hash)
+      when "scroll"
+        PageActionScroll.from_hash(hash)
+      when "wait"
+        PageActionWait.from_hash(hash)
+      when "screenshot"
+        PageActionScreenshot.from_hash(hash)
+      when "executeJs"
+        PageActionExecuteJs.from_hash(hash)
+      when "scrape"
+        PageActionScrape.from_hash(hash)
+      else
+        raise "Unknown discriminator: #{discriminator}"
       end
     end
   end
@@ -259,7 +395,8 @@ module Crawlberg
 
     # CSS selector for the element to click.
     sig { returns(String) }
-    def selector = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def selector = super
     sig { returns(T::Boolean) }
     def click? = true
     sig { returns(T::Boolean) }
@@ -290,10 +427,12 @@ module Crawlberg
 
     # CSS selector for the input element.
     sig { returns(String) }
-    def selector = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def selector = super
     # Text to type into the element.
     sig { returns(String) }
-    def text = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def text = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -324,7 +463,8 @@ module Crawlberg
 
     # Key name to press.
     sig { returns(String) }
-    def key = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def key = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -355,13 +495,16 @@ module Crawlberg
 
     # Direction to scroll.
     sig { returns(ScrollDirection) }
-    def direction = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def direction = super
     # Optional CSS selector for a scrollable element. Scrolls the page if absent.
     sig { returns(T.nilable(String)) }
-    def selector = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def selector = super
     # Optional pixel amount to scroll. Uses a default if absent.
     sig { returns(T.nilable(Integer)) }
-    def amount = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def amount = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -382,7 +525,11 @@ module Crawlberg
     # @return [self]
     sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
     def self.from_hash(hash)
-      new(direction: hash[:direction] || hash["direction"], selector: hash[:selector] || hash["selector"], amount: hash[:amount] || hash["amount"])
+      new(
+        direction: hash[:direction] || hash["direction"],
+        selector: hash[:selector] || hash["selector"],
+        amount: hash[:amount] || hash["amount"]
+      )
     end
   end
   ## Wait for a duration or for an element to appear.
@@ -392,10 +539,12 @@ module Crawlberg
 
     # Milliseconds to wait. Ignored if `selector` is provided.
     sig { returns(T.nilable(Integer)) }
-    def milliseconds = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def milliseconds = super
     # CSS selector to wait for.
     sig { returns(T.nilable(String)) }
-    def selector = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def selector = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -430,7 +579,8 @@ module Crawlberg
     # `full_page` (snake_case) alias so language bindings and fixtures can
     # use either convention without error.
     sig { returns(T.nilable(T::Boolean)) }
-    def full_page = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def full_page = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -466,7 +616,8 @@ module Crawlberg
 
     # JavaScript source code to execute. Max 1 MB.
     sig { returns(String) }
-    def script = super # rubocop:disable Lint/UselessMethodDefinition
+    # rubocop:disable Lint/UselessMethodDefinition
+    def script = super
     sig { returns(T::Boolean) }
     def click? = false
     sig { returns(T::Boolean) }
@@ -519,105 +670,3 @@ module Crawlberg
     end
   end
 end
-
-module Crawlberg
-  # Hostname/IP allowlist matcher for SSRF policy.
-  #
-  # Serializes as an internally-tagged object so each variant is distinguishable on the
-  # wire and round-trips losslessly:
-  #
-  # ```json
-  # {"type": "exact",  "value": "api.example.com"}
-  # {"type": "suffix", "value": ".example.com"}
-  # {"type": "cidr",   "value": "10.0.0.0/8"}
-  # ```
-  #
-  # A bare JSON string is still accepted on deserialization and resolves to [`Exact`],
-  # preserving configs written against the previous untagged representation.
-  #
-  # [`Exact`]: HostMatcher::Exact
-  module HostMatcher
-    extend T::Helpers
-    extend T::Sig
-
-    interface!
-
-    # Dispatch from a Hash to the appropriate variant constructor.
-    # @param hash [Hash] with discriminator field and variant-specific fields
-    # @return [variant_class] an instance of the appropriate variant
-    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.untyped) }
-    def self.from_hash(hash)
-      discriminator = hash[:type] || hash["type"]
-      case discriminator
-      when "exact" then HostMatcherExact.from_hash(hash)
-      when "suffix" then HostMatcherSuffix.from_hash(hash)
-      when "cidr" then HostMatcherCidr.from_hash(hash)
-      else raise "Unknown discriminator: #{discriminator}"
-      end
-    end
-  end
-  ## Exact hostname match (case-insensitive).
-  HostMatcherExact = Data.define(:value) do
-    include HostMatcher
-    extend T::Sig
-
-    # The hostname to match.
-    sig { returns(String) }
-    def value = super # rubocop:disable Lint/UselessMethodDefinition
-    sig { returns(T::Boolean) }
-    def exact? = true
-    sig { returns(T::Boolean) }
-    def suffix? = false
-    sig { returns(T::Boolean) }
-    def cidr? = false
-    # @param hash [Hash] deserialized from the native extension
-    # @return [self]
-    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
-    def self.from_hash(hash)
-      new(value: hash[:value] || hash["value"])
-    end
-  end
-  ## Suffix match: ".xberg.io" matches "api.xberg.io" and "xberg.io".
-  HostMatcherSuffix = Data.define(:value) do
-    include HostMatcher
-    extend T::Sig
-
-    # The dot-prefixed suffix to match. A leading dot is optional.
-    sig { returns(String) }
-    def value = super # rubocop:disable Lint/UselessMethodDefinition
-    sig { returns(T::Boolean) }
-    def exact? = false
-    sig { returns(T::Boolean) }
-    def suffix? = true
-    sig { returns(T::Boolean) }
-    def cidr? = false
-    # @param hash [Hash] deserialized from the native extension
-    # @return [self]
-    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
-    def self.from_hash(hash)
-      new(value: hash[:value] || hash["value"])
-    end
-  end
-  ## CIDR match: "10.0.0.0/8" matches IP addresses in that range.
-  HostMatcherCidr = Data.define(:value) do
-    include HostMatcher
-    extend T::Sig
-
-    # The CIDR block. Validated when built through [`HostMatcher::cidr`] or
-    # deserialization.
-    sig { returns(String) }
-    def value = super # rubocop:disable Lint/UselessMethodDefinition
-    sig { returns(T::Boolean) }
-    def exact? = false
-    sig { returns(T::Boolean) }
-    def suffix? = false
-    sig { returns(T::Boolean) }
-    def cidr? = true
-    # @param hash [Hash] deserialized from the native extension
-    # @return [self]
-    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
-    def self.from_hash(hash)
-      new(value: hash[:value] || hash["value"])
-    end
-  end
-end

data/lib/crawlberg/version.rb

@@ -1,10 +1,10 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:9716830c37f9c6de3924a6ebdc2f8f077d296794b443399aa1d4c4f0d483169a
+# alef:hash:9ea9a14d259e4988466100a061689d975727c16c521c140aef2205c9b97bf831
 # To regenerate: alef generate
 # To verify freshness: alef verify
 # frozen_string_literal: true
 
 module Crawlberg
   ## The version string for this package.
-  VERSION = "1.3.3"
+  VERSION = "1.4.2"
 end

data/lib/crawlberg.rb

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:5f14772be973afec2e94293f27da4258e3399457f1e279dc68d4d55a011f6b3a
+# alef:hash:ed4c2274eb4834de21c62fc789eebe8acea49536e10970e2634ab6608966ec3d
 # To regenerate: alef generate
 # To verify freshness: alef verify
 # frozen_string_literal: true