capture_page 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c0646db848b7f2468b5115caed1a2101188c86f3e2fe7764eb84cb155003df1
-  data.tar.gz: 77cb86e03ebaa2692a1c186ed9b3540c8e6600ab49f74732eb1bf9e732a23358
+  metadata.gz: ede382d29f59a4c71e609f79d74574122e2432a5d145873d8a038f5c4bf850f3
+  data.tar.gz: 6ad9064e2506f3bd2bada3d4025d894cf87be551272161627c472dcdf06a40c4
 SHA512:
-  metadata.gz: f7070bb1dc03c587dd27f0f76dc7bb4a22fdd694707ef3026069248d11a72648c2c77139cfcf0c463423593695388415965c12066850dea2141f22c40e445909
-  data.tar.gz: 7aa49e640f95945ad92e9de26319769b76b148c518333d636fb0957330e846b0ec50de4b8bf2c9166be8bc819d1d6f35b6399a41c0bf3349fd3143a34b29e383
+  metadata.gz: 2f9ab18049ac143fe3aebd8b9c026705d5708c415743e639c3519b46ae30e6e9ffd4e69bb0af37b434849d350b3b86a407f2139bfa761778e26cc5ef9c99e0a9
+  data.tar.gz: c19f5374e91e3d332bc033684dfb25c3409dd8c7c14c199ada926a0f02b0b90fd61bfd58d6092d88b0c556aefdac88a3bba70d4dab656f1dc9cb5dbaa4b520ce

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.sessions.create("maxTtlSeconds" => 300)
+session_id = session["session"]["id"]
+
+client.sessions.action(session_id, "goto", "url" => "https://example.com")
+screenshot = client.sessions.action(session_id, "screenshot", "fullPage" => true)
+
+client.sessions.close(session_id)
+```
+
 ## Configuration Options
 
 ### Constructor Options

data/lib/capture.rb

@@ -5,11 +5,50 @@ 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 CaptureSessions
+  def initialize(client)
+    @client = client
+  end
+
+  def create(options = {})
+    options = options.nil? ? {} : options
+    raise TypeError, "options must be a Hash" unless options.is_a?(Hash)
+
+    @client.send(:sessions_request, "", :post, options)
+  end
+
+  def get(session_id)
+    @client.send(:sessions_request, "/#{@client.send(:escape_path, session_id)}", :get)
+  end
+
+  def close(session_id)
+    @client.send(:sessions_request, "/#{@client.send(:escape_path, session_id)}", :delete)
+  end
+
+  def action(session_id, action_type, payload = {})
+    payload = payload.nil? ? {} : payload
+    raise TypeError, "payload must be a Hash" unless payload.is_a?(Hash)
+
+    @client.send(:sessions_request, "/#{@client.send(:escape_path, session_id)}/actions", :post, "type" => action_type, "payload" => payload)
+  end
+end
+
 class Capture
   API_URL = "https://cdn.capture.page"
   EDGE_URL = "https://edge.capture.page"
 
-  attr_reader :key, :options
+  attr_reader :key, :options, :sessions
 
   def initialize(key, secret, options = {})
     @key = key
@@ -17,6 +56,7 @@ class Capture
     options = options.nil? ? {} : options
     raise TypeError, "options must be a Hash" unless options.is_a?(Hash)
     @options = options
+    @sessions = CaptureSessions.new(self)
   end
 
   def build_image_url(url, options = {})
@@ -110,4 +150,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.2.0
 platform: ruby
 authors:
 - Capture Team