hookd-client 0.1.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e733c25ddc48c4abc81de335f540b1c04b25e93d1ae662c4140ee1b4d735afc
-  data.tar.gz: 221c74e9d5d1bb915799cb9ec852f54e8ea1cea894bd5246982fab00726769c7
+  metadata.gz: ba2b5b2434c982f13d1515e488d1bcc30056f66448fe34d9529004ae0ea1229a
+  data.tar.gz: 437ffa486b1a4bb37c6c3e89dc33ab9dbb927b831496435948b47039b0d91384
 SHA512:
-  metadata.gz: 8f41965d7a08d776b63b91b03cef5275183de8a4f58eb76077633ebbe790b19c042f94ed2a42c664b92b162d07c55d3e0bd75985c359f656e6f25d30848c5382
-  data.tar.gz: e88fa863ced788b552d5430d68ee351e5c7ed7b28514a59314937dda1ce3a7250cf75c26cf8ce4346780d24b78ed742c1523d50a206e6d7062664cd6e6014ea1
+  metadata.gz: b3551c335feda2be9dfd807c1de65fe1f6f7e46698f193cb3112323c02c3b332e66aa9563caebdc3d24f730d5b8d49484099dfd7c0fd1e3f1370c9860350c79b
+  data.tar.gz: 4f162c429ea63559cac8749ffcdace2f80014317c30d2d06e6d8954a44a7c8cdd308222e9133bc292a16db9bddcd1283f25b5f762922b46a68eb130737f23432

data/README.md

@@ -63,18 +63,31 @@ The client requires two configuration parameters:
 
 Main client class for interacting with the Hookd server.
 
-##### `#register`
+##### `#register(count: nil)`
 
-Register a new hook and get DNS/HTTP endpoints.
+Register one or more hooks and get DNS/HTTP endpoints.
 
+**Single hook (default):**
 ```ruby
 hook = client.register
 # => #<Hookd::Hook id="abc123" dns="abc123.hookd.example.com" ...>
 ```
 
-Returns: `Hookd::Hook` object
+**Multiple hooks:**
+```ruby
+hooks = client.register(count: 5)
+# => [#<Hookd::Hook id="abc123" ...>, #<Hookd::Hook id="def456" ...>, ...]
+```
+
+Parameters:
+- `count` (Integer, optional) - Number of hooks to create (default: 1)
+
+Returns:
+- `Hookd::Hook` object when `count` is 1 or not specified
+- Array of `Hookd::Hook` objects when `count` > 1
 
 Raises:
+- `ArgumentError` - Invalid count parameter
 - `Hookd::AuthenticationError` - Authentication failed
 - `Hookd::ServerError` - Server error (5xx)
 - `Hookd::ConnectionError` - Connection failed

data/lib/hookd/client.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require 'net/http'
+require 'httpx'
 require 'json'
-require 'uri'
 
 module Hookd
   # HTTP client for interacting with Hookd server
@@ -12,17 +11,36 @@ module Hookd
     def initialize(server:, token:)
       @server = server
       @token = token
-      @uri = URI.parse(server)
+      @http = HTTPX.with(
+        headers: { 'X-API-Key' => token },
+        timeout: {
+          connect_timeout: 10,
+          read_timeout: 30
+        }
+      )
     end
 
-    # Register a new hook
-    # @return [Hookd::Hook] the newly registered hook
+    # Register one or more hooks
+    # @param count [Integer, nil] number of hooks to register (default: 1)
+    # @return [Hookd::Hook, Array<Hookd::Hook>] single hook or array of hooks
     # @raise [Hookd::AuthenticationError] if authentication fails
     # @raise [Hookd::ServerError] if server returns 5xx
     # @raise [Hookd::ConnectionError] if connection fails
-    def register
-      response = post('/register')
-      Hook.from_hash(response)
+    # @raise [ArgumentError] if count is invalid
+    def register(count: nil)
+      body = count.nil? ? nil : { count: count }
+
+      raise ArgumentError, 'count must be a positive integer' if count && (!count.is_a?(Integer) || count < 1)
+
+      response = post('/register', body)
+
+      # Single hook response (backward compatible)
+      return Hook.from_hash(response) if response.key?('id')
+
+      # Multiple hooks response
+      return [] if response['hooks'].nil? || response['hooks'].empty?
+
+      response['hooks'].map { |h| Hook.from_hash(h) }
     end
 
     # Poll for interactions on a hook
@@ -56,43 +74,43 @@ module Hookd
     private
 
     def get(path)
-      request = Net::HTTP::Get.new(path)
-      request['Authorization'] = "Bearer #{token}"
-      execute_request(request)
+      url = "#{@server}#{path}"
+      response = @http.get(url)
+      handle_response(response)
     end
 
     def post(path, body = nil)
-      request = Net::HTTP::Post.new(path)
-      request['Authorization'] = "Bearer #{token}"
-      request['Content-Type'] = 'application/json'
-      request.body = body.to_json if body
-      execute_request(request)
+      url = "#{@server}#{path}"
+      options = { headers: { 'Content-Type' => 'application/json' } }
+      options[:json] = body if body
+
+      response = @http.post(url, **options)
+      handle_response(response)
     end
 
-    def execute_request(request)
-      http = Net::HTTP.new(@uri.host, @uri.port)
-      http.use_ssl = @uri.scheme == 'https'
-      http.open_timeout = 10
-      http.read_timeout = 30
+    def handle_response(response)
+      # HTTPX returns HTTPX::ErrorResponse for connection/timeout errors
+      if response.is_a?(HTTPX::ErrorResponse)
+        error = response.error
+        raise ConnectionError, "Connection failed: #{error.message}"
+      end
 
-      response = http.request(request)
+      body = response.body.to_s
 
-      case response.code.to_i
+      case response.status
       when 200, 201
-        raise Error, 'Empty response body from server' if response.body.nil? || response.body.empty?
+        raise Error, 'Empty response body from server' if body.nil? || body.empty?
 
-        JSON.parse(response.body)
+        JSON.parse(body)
       when 401
-        raise AuthenticationError, "Authentication failed: #{response.body}"
+        raise AuthenticationError, "Authentication failed: #{body}"
       when 404
-        raise NotFoundError, "Resource not found: #{response.body}"
+        raise NotFoundError, "Resource not found: #{body}"
       when 500..599
-        raise ServerError, "Server error (#{response.code}): #{response.body}"
+        raise ServerError, "Server error (#{response.status}): #{body}"
       else
-        raise Error, "Unexpected response (#{response.code}): #{response.body}"
+        raise Error, "Unexpected response (#{response.status}): #{body}"
       end
-    rescue SocketError, Errno::ECONNREFUSED, Net::OpenTimeout, Net::ReadTimeout => e
-      raise ConnectionError, "Connection failed: #{e.message}"
     rescue JSON::ParserError => e
       raise Error, "Invalid JSON response: #{e.message}"
     end

data/lib/hookd/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hookd
-  VERSION = '0.1.1'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: hookd-client
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.1.0
 platform: ruby
 authors:
-- Jomar
+- Joshua MARTINELLE
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httpx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: Ruby client library for Hookd, a DNS/HTTP interaction server for security
   testing and debugging
 email:
@@ -24,12 +38,12 @@ files:
 - lib/hookd/hook.rb
 - lib/hookd/interaction.rb
 - lib/hookd/version.rb
-homepage: https://github.com/JoshuaMart/hookd
+homepage: https://github.com/JoshuaMart/Hookd
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/JoshuaMart/hookd
-  source_code_uri: https://github.com/jomar/hookd
+  homepage_uri: https://github.com/JoshuaMart/Hookd
+  source_code_uri: https://github.com/JoshuaMart/Hookd
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: