castle-rb 9.0.0 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '085ac2cdd6ebd7b69ab9171c72009c3f3d792c3d21d55b93d914abd93425098d'
-  data.tar.gz: c31f5076e77d08c27d06b7722558b816a56868a51e7a2f885b9fc9236fc50615
+  metadata.gz: c138f51f6546b1a01b53f8542506e6e8566928d4b0907992d33dcb648788c9ee
+  data.tar.gz: d8f282e27ad75bad8e0d137b21ca15158ac3b6c3603f89098a3d77487cfa3658
 SHA512:
-  metadata.gz: ecf515a3a5ff3a264a749171a6507d1c03635415359a392b8daafbf1e57291749e509501d449c902b1811903688a2499b7b845bc9cf27d167faa8412cb3ff40e
-  data.tar.gz: 125266f1b4875f105b024b4bef5baf38175af1741e53c35cfe66ab7051dceb6adb76dda87b330ccdd48b06fc30bd4434283868e8be4de540752fbbbe06028ff9
+  metadata.gz: 9b5c96cf024088766cd6cf1dad0b6c371dcfee03241ec695fc148c08d5bafd5658b4731514db4e8cf88ad430607cf26650077ce0db2ee9b95d56d62459b6a987
+  data.tar.gz: 054deed51da4427e2c715b2e5f63a646d8acc73125e64d30b5d3fa2fadbd42119baf536d2b83e31b158fb5423f0b18b7d0bda67613d0f1fbb360c59c8f4959e3

data/CHANGELOG.md

@@ -1,7 +1,29 @@
 # Changelog
 
+## 9.1.0
+
+**Enhancements:**
+
+- Add Events API support (enterprise) — three new client methods for querying event data:
+  - `events_schema` — `GET /v1/events/schema`
+  - `query_events` — `POST /v1/events/query`
+  - `group_events` — `POST /v1/events/group`
+
+**Housekeeping:**
+
+- Remove unused `Castle::Validators::NotSupported` (dead code)
+- Remove unused `Session::HTTPS_SCHEME` constant; inline the comparison in `GetConnection`
+- Replace deprecated `:mingw, :x64_mingw` Bundler platforms with `:windows`
+- Bump Bundler 2.6.9 → 2.7.2
+- Bump json 2.19.5 → 2.19.7
+
 ## master
 
+- Bump dependencies (rack 3.1.19 → 3.2.6, rake, rspec-\*, timecop, simplecov-html, diff-lcs)
+- Bump Ruby to 3.4.9 (zlib CVE-2026-27820)
+- Bump Node.js to 24.16.0 in `.tool-versions`
+- Repair `yarn format:check`: add `syntax_tree` to the dev group (required by `@prettier/plugin-ruby` 4.x), reformat 11 spec files, and disable rubocop cops that conflict with prettier-ruby (`Layout/SpaceInsideHashLiteralBraces`, `Style/EmptyMethod`)
+
 ## 9.0.0
 
 **BREAKING CHANGES:**

data/lib/castle/api/events/group.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Castle
+  module API
+    module Events
+      # Sends POST /events/group request
+      module Group
+        class << self
+          # @param options [Hash]
+          # @return [Hash]
+          def call(options = {})
+            options = Castle::Utils::DeepSymbolizeKeys.call(options || {})
+            http = options.delete(:http)
+            config = options.delete(:config) || Castle.config
+
+            Castle::API.call(Castle::Commands::Events::Group.build(options), {}, http, config)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/api/events/query.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Castle
+  module API
+    module Events
+      # Sends POST /events/query request
+      module Query
+        class << self
+          # @param options [Hash]
+          # @return [Hash]
+          def call(options = {})
+            options = Castle::Utils::DeepSymbolizeKeys.call(options || {})
+            http = options.delete(:http)
+            config = options.delete(:config) || Castle.config
+
+            Castle::API.call(Castle::Commands::Events::Query.build(options), {}, http, config)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/api/events/schema.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Castle
+  module API
+    module Events
+      # Sends GET /events/schema request
+      module Schema
+        class << self
+          # @param options [Hash]
+          # @return [Hash]
+          def call(options = {})
+            options = Castle::Utils::DeepSymbolizeKeys.call(options || {})
+            http = options.delete(:http)
+            config = options.delete(:config) || Castle.config
+
+            Castle::API.call(Castle::Commands::Events::Schema.build(options), {}, http, config)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/client.rb

@@ -3,6 +3,7 @@
 module Castle
   # Castle's client.
   class Client
+    include Castle::ClientActions::Events
     include Castle::ClientActions::ListItems
     include Castle::ClientActions::Lists
     include Castle::ClientActions::Privacy

data/lib/castle/client_actions/events.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Castle
+  module ClientActions
+    # Client actions for the Events API
+    module Events
+      # @param options [Hash]
+      def events_schema(options = {})
+        Castle::API::Events::Schema.call(options)
+      end
+
+      # @param options [Hash]
+      def query_events(options = {})
+        Castle::API::Events::Query.call(options)
+      end
+
+      # @param options [Hash]
+      def group_events(options = {})
+        Castle::API::Events::Group.call(options)
+      end
+    end
+  end
+end

data/lib/castle/commands/events/group.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Castle
+  module Commands
+    module Events
+      # Builds the command to query aggregated events
+      class Group
+        class << self
+          # @param options [Hash]
+          # @return [Castle::Command]
+          def build(options = {})
+            options[:filters]&.each { |f| Castle::Validators::Present.call(f, %i[field op value]) }
+            Castle::Validators::Present.call(options[:sort], %i[field order]) if options[:sort]
+
+            Castle::Command.new('events/group', options, :post)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/commands/events/query.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Castle
+  module Commands
+    module Events
+      # Builds the command to query raw events
+      class Query
+        class << self
+          # @param options [Hash]
+          # @return [Castle::Command]
+          def build(options = {})
+            options[:filters]&.each { |f| Castle::Validators::Present.call(f, %i[field op value]) }
+            Castle::Validators::Present.call(options[:sort], %i[field order]) if options[:sort]
+
+            Castle::Command.new('events/query', options, :post)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/commands/events/schema.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Castle
+  module Commands
+    module Events
+      # Builds the command to get the events schema
+      class Schema
+        class << self
+          # @param options [Hash]
+          # @return [Castle::Command]
+          def build(_options = {})
+            Castle::Command.new('events/schema', nil, :get)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castle/core/get_connection.rb

@@ -4,8 +4,6 @@ module Castle
   module Core
     # this module returns a new configured Net::HTTP object
     module GetConnection
-      HTTPS_SCHEME = 'https'
-
       class << self
         # @param config [Castle::Configuration, Castle::SingletonConfiguration]
         # @return [Net::HTTP]
@@ -18,7 +16,7 @@ module Castle
           http.open_timeout = timeout_seconds
           http.read_timeout = timeout_seconds
 
-          if config.base_url.scheme == HTTPS_SCHEME
+          if config.base_url.scheme == 'https'
             http.use_ssl = true
             http.verify_mode = OpenSSL::SSL::VERIFY_PEER
           end

data/lib/castle/session.rb

@@ -5,8 +5,6 @@ module Castle
   # and provides start method for persistent connection usage
   # when there is a need of sending multiple requests at once
   module Session
-    HTTPS_SCHEME = 'https'
-
     class << self
       def call(&block)
         return unless block

data/lib/castle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Castle
-  VERSION = '9.0.0'
+  VERSION = '9.1.0'
 end

data/lib/castle.rb

@@ -14,7 +14,6 @@
   castle/utils/get_timestamp
   castle/utils/secure_compare
   castle/validators/present
-  castle/validators/not_supported
   castle/webhooks/verify
   castle/context/merge
   castle/context/sanitize
@@ -37,6 +36,9 @@
   castle/commands/list_items/query
   castle/commands/list_items/unarchive
   castle/commands/list_items/update
+  castle/commands/events/schema
+  castle/commands/events/query
+  castle/commands/events/group
   castle/commands/privacy/request_data
   castle/commands/privacy/delete_data
   castle/api/filter
@@ -56,6 +58,9 @@
   castle/api/list_items/query
   castle/api/list_items/unarchive
   castle/api/list_items/update
+  castle/api/events/schema
+  castle/api/events/query
+  castle/api/events/group
   castle/api/privacy/request_data
   castle/api/privacy/delete_data
   castle/payload/prepare
@@ -64,6 +69,7 @@
   castle/logger
   castle/failover/prepare_response
   castle/failover/strategy
+  castle/client_actions/events
   castle/client_actions/lists
   castle/client_actions/list_items
   castle/client_actions/privacy

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: castle-rb
 version: !ruby/object:Gem::Version
-  version: 9.0.0
+  version: 9.1.0
 platform: ruby
 authors:
 - Johan Brissmyr
@@ -40,6 +40,9 @@ files:
 - lib/castle-rb.rb
 - lib/castle.rb
 - lib/castle/api.rb
+- lib/castle/api/events/group.rb
+- lib/castle/api/events/query.rb
+- lib/castle/api/events/schema.rb
 - lib/castle/api/filter.rb
 - lib/castle/api/list_items/archive.rb
 - lib/castle/api/list_items/count.rb
@@ -60,11 +63,15 @@ files:
 - lib/castle/api/privacy/request_data.rb
 - lib/castle/api/risk.rb
 - lib/castle/client.rb
+- lib/castle/client_actions/events.rb
 - lib/castle/client_actions/list_items.rb
 - lib/castle/client_actions/lists.rb
 - lib/castle/client_actions/privacy.rb
 - lib/castle/client_id/extract.rb
 - lib/castle/command.rb
+- lib/castle/commands/events/group.rb
+- lib/castle/commands/events/query.rb
+- lib/castle/commands/events/schema.rb
 - lib/castle/commands/filter.rb
 - lib/castle/commands/list_items/archive.rb
 - lib/castle/commands/list_items/count.rb
@@ -113,7 +120,6 @@ files:
 - lib/castle/utils/get_timestamp.rb
 - lib/castle/utils/merge.rb
 - lib/castle/utils/secure_compare.rb
-- lib/castle/validators/not_supported.rb
 - lib/castle/validators/present.rb
 - lib/castle/verdict.rb
 - lib/castle/version.rb
@@ -141,7 +147,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.8
 specification_version: 4
 summary: Official Ruby SDK for the Castle fraud and account-abuse prevention platform
 test_files: []

data/lib/castle/validators/not_supported.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Castle
-  module Validators
-    # Checks if required keys are supported
-    class NotSupported
-      class << self
-        def call(options, keys)
-          keys.each do |key|
-            next unless options.key?(key)
-
-            raise Castle::InvalidParametersError, "#{key} is/are not supported"
-          end
-        end
-      end
-    end
-  end
-end