capture_page 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c0646db848b7f2468b5115caed1a2101188c86f3e2fe7764eb84cb155003df1
-  data.tar.gz: 77cb86e03ebaa2692a1c186ed9b3540c8e6600ab49f74732eb1bf9e732a23358
+  metadata.gz: 3217118ed9497ccaaff219c4b5fd9345320790d99d88d252d14f363921832a4e
+  data.tar.gz: 3c96668a060f2771e1210583c2e9aeb65fbf75b9d508d5f475c1fc4098cdd6f7
 SHA512:
-  metadata.gz: f7070bb1dc03c587dd27f0f76dc7bb4a22fdd694707ef3026069248d11a72648c2c77139cfcf0c463423593695388415965c12066850dea2141f22c40e445909
-  data.tar.gz: 7aa49e640f95945ad92e9de26319769b76b148c518333d636fb0957330e846b0ec50de4b8bf2c9166be8bc819d1d6f35b6399a41c0bf3349fd3143a34b29e383
+  metadata.gz: cf1928267a630bc2f2e26cf5fc2db0443c995e523641f86ab8816038a52a5d388c0093973d3a33f97dbf5c509e6f054575cea7b2b5658575d46e96245338a1a8
+  data.tar.gz: 3b62f1f2d90d24af537bd56fa87a1303eef91bb3e3e5355e2ac7a2e4027d797d46220ebf6a8c9bad97bde5440ac234497ce5e7b1441d651e5f94741bd109a1da

data/README.md

@@ -34,6 +34,7 @@ puts image_url
 - **Content Extraction**: Extract HTML and text content from web pages
 - **Metadata Extraction**: Get page metadata (title, description, og tags, etc.)
 - **Animated GIFs**: Create animated GIFs of page interactions
+- **Browser Sessions**: Create stateful browser sessions and run actions
 - **Zero Dependencies**: Uses only Ruby standard library
 
 ## Usage
@@ -132,6 +133,18 @@ gif_data = client.fetch_animated("https://example.com")
 File.binwrite("animation.gif", gif_data)
 ```
 
+### Browser Sessions
+
+```ruby
+session = client.create_session("maxTtlSeconds" => 300)
+session_id = session["session"]["id"]
+
+client.execute_action(session_id, "goto", "url" => "https://example.com")
+screenshot = client.execute_action(session_id, "screenshot", "fullPage" => true)
+
+client.close_session(session_id)
+```
+
 ## Configuration Options
 
 ### Constructor Options

data/lib/capture.rb

@@ -5,6 +5,17 @@ require "net/http"
 require "uri"
 require "json"
 
+class CaptureSessionsError < StandardError
+  attr_reader :status, :body
+
+  def initialize(status, body)
+    message = body.is_a?(Hash) && body["error"].is_a?(String) ? body["error"] : "Capture Sessions API request failed with status #{status}"
+    super(message)
+    @status = status
+    @body = body
+  end
+end
+
 class Capture
   API_URL = "https://cdn.capture.page"
   EDGE_URL = "https://edge.capture.page"
@@ -59,6 +70,28 @@ class Capture
     fetch_binary(build_animated_url(url, options))
   end
 
+  def create_session(options = {})
+    options = options.nil? ? {} : options
+    raise TypeError, "options must be a Hash" unless options.is_a?(Hash)
+
+    sessions_request("", :post, options)
+  end
+
+  def get_session(session_id)
+    sessions_request("/#{escape_path(session_id)}", :get)
+  end
+
+  def close_session(session_id)
+    sessions_request("/#{escape_path(session_id)}", :delete)
+  end
+
+  def execute_action(session_id, action_type, payload = {})
+    payload = payload.nil? ? {} : payload
+    raise TypeError, "payload must be a Hash" unless payload.is_a?(Hash)
+
+    sessions_request("/#{escape_path(session_id)}/actions", :post, "type" => action_type, "payload" => payload)
+  end
+
   private
 
   def build_url(url, request_type, options)
@@ -110,4 +143,54 @@ class Capture
 
     JSON.parse(response.body)
   end
+
+  def sessions_bearer_token
+    raise TypeError, "key and secret must be strings" unless @key.is_a?(String) && @secret.is_a?(String)
+    raise ArgumentError, "Key and Secret is required" if @key.empty? || @secret.empty?
+
+    ["#{@key}:#{@secret}"].pack("m0")
+  end
+
+  def session_url(path = "")
+    "#{EDGE_URL}/v1/sessions#{path}"
+  end
+
+  def sessions_request(path, method, body = nil)
+    uri = URI.parse(session_url(path))
+    request = case method
+              when :post then Net::HTTP::Post.new(uri)
+              when :get then Net::HTTP::Get.new(uri)
+              when :delete then Net::HTTP::Delete.new(uri)
+              else raise ArgumentError, "unsupported sessions request method"
+              end
+
+    request["Authorization"] = "Bearer #{sessions_bearer_token}"
+    unless body.nil?
+      request["Content-Type"] = "application/json"
+      request.body = JSON.generate(body)
+    end
+
+    response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+      http.request(request)
+    end
+    response_body = parse_json_response(response.body)
+
+    raise CaptureSessionsError.new(response.code.to_i, response_body) unless response.is_a?(Net::HTTPSuccess)
+
+    response_body
+  end
+
+  def parse_json_response(body)
+    return {} if body.nil? || body.empty?
+
+    JSON.parse(body)
+  rescue JSON::ParserError
+    {}
+  end
+
+  def escape_path(value)
+    raise ArgumentError, "session_id is required" if value.nil? || value.to_s.empty?
+
+    URI.encode_www_form_component(value.to_s)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capture_page
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Capture Team