trustcaptcha 2.0.0.pre.beta.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0676f4d7f6a64cf1dd91ed6a4a885a473693114b93ca71849ec45d2443905de8
+  data.tar.gz: 770e00c90e15ff986cff933633b8e9b1084a7697daaeefdc5da5fbe732b2cead
+SHA512:
+  metadata.gz: 5d434c2851df9a62a9e265b31537077e6bbe80291922633aa90e40a49285e1848219205e56f696c44fc797b8228dc2d59083c9e7c4419176b78945dddab5d05b
+  data.tar.gz: 1c07d37c1048627a6ded2963be0cb65ddba9c5fde7afc34b64f1229c49c1ad8baf74ce30a66a3c8e4a94fa8f1fc6695ed2609d596273fa26960bcf01c13ed0a7

data/lib/trustcaptcha/captcha_manager.rb

@@ -0,0 +1,49 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require_relative 'model/verification_token'
+require_relative 'model/verification_result'
+
+class CaptchaManager
+
+  class SecretKeyInvalidException < StandardError; end
+  class VerificationTokenInvalidException < StandardError; end
+  class VerificationNotFoundException < StandardError; end
+  class VerificationNotFinishedException < StandardError; end
+
+  def self.get_verification_result(secret_key, base64_verification_token)
+    verification_token = get_verification_token(base64_verification_token)
+    fetch_verification_result(verification_token, secret_key)
+  end
+
+  private
+
+  def self.get_verification_token(base64_verification_token)
+    VerificationToken.from_base64(base64_verification_token)
+  rescue StandardError => e
+    raise VerificationTokenInvalidException, "Invalid verification token: #{e.message}"
+  end
+
+  def self.fetch_verification_result(verification_token, access_token)
+    url = URI("#{verification_token.api_endpoint}/verifications/#{verification_token.verification_id}/assessments")
+    headers = {
+      "tc-authorization" => access_token,
+      "tc-library-language" => "ruby",
+      "tc-library-version" => "2.0"
+    }
+    response = Net::HTTP.get_response(url, headers)
+
+    case response.code.to_i
+    when 403
+      raise SecretKeyInvalidException, "Secret key is invalid"
+    when 404
+      raise VerificationNotFoundException, "Verification not found"
+    when 423
+      raise VerificationNotFinishedException, "Verification not finished"
+    else
+      raise "Failed to retrieve verification result: HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
+    end
+
+    VerificationResult.from_json(response.body)
+  end
+end

data/lib/trustcaptcha/model/verification_result.rb

@@ -0,0 +1,48 @@
+require 'json'
+
+class VerificationResult
+  attr_reader :captcha_id, :verification_id, :score, :reason, :mode, :origin, :ip_address,
+              :device_family, :operating_system, :browser, :creation_timestamp,
+              :release_timestamp, :retrieval_timestamp, :verification_passed
+
+  def initialize(data)
+    @captcha_id = data['captchaId']
+    @verification_id = data['verificationId']
+    @score = data['score']
+    @reason = data['reason']
+    @mode = data['mode']
+    @origin = data['origin']
+    @ip_address = data['ipAddress']
+    @device_family = data['deviceFamily']
+    @operating_system = data['operatingSystem']
+    @browser = data['browser']
+    @creation_timestamp = data['creationTimestamp']
+    @release_timestamp = data['releaseTimestamp']
+    @retrieval_timestamp = data['retrievalTimestamp']
+    @verification_passed = data['verificationPassed']
+  end
+
+  def self.from_json(json_data)
+    data = JSON.parse(json_data)
+    new(data)
+  end
+
+  def to_json(*_args)
+    {
+      captchaId: @captcha_id,
+      verificationId: @verification_id,
+      score: @score,
+      reason: @reason,
+      mode: @mode,
+      origin: @origin,
+      ipAddress: @ip_address,
+      deviceFamily: @device_family,
+      operatingSystem: @operating_system,
+      browser: @browser,
+      creationTimestamp: @creation_timestamp,
+      releaseTimestamp: @release_timestamp,
+      retrievalTimestamp: @retrieval_timestamp,
+      verificationPassed: @verification_passed
+    }.to_json
+  end
+end

data/lib/trustcaptcha/model/verification_token.rb

@@ -0,0 +1,18 @@
+require 'json'
+require 'securerandom'
+require 'base64'
+
+class VerificationToken
+  attr_reader :api_endpoint, :verification_id
+
+  def initialize(api_endpoint, verification_id)
+    @api_endpoint = api_endpoint
+    @verification_id = verification_id
+  end
+
+  def self.from_base64(base64_string)
+    json_string = Base64.decode64(base64_string)
+    data = JSON.parse(json_string)
+    new(data['apiEndpoint'], data['verificationId'])
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: trustcaptcha
+version: !ruby/object:Gem::Version
+  version: 2.0.0.pre.beta.0
+platform: ruby
+authors:
+- TrustComponent
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: TrustCaptcha – Privacy-first CAPTCHA solution for Ruby. GDPR-compliant,
+  bot protection made in Europe.
+email:
+- mail@trustcomponent.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/trustcaptcha/captcha_manager.rb
+- lib/trustcaptcha/model/verification_result.rb
+- lib/trustcaptcha/model/verification_token.rb
+homepage: https://www.trustcomponent.com/en/products/captcha/integrations/ruby-captcha
+licenses:
+- Apache-2.0
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: TrustCaptcha - CAPTCHA for Ruby
+test_files: []