mockserver-client 7.6.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5058c222282161435bc425f0993f4795a0d4d8ca0f8fd1a921f5848ebe7b7fe8
-  data.tar.gz: 91e14949df3f145e9c107374ee8edc6edea90343c91d509922495ea5eb220c37
+  metadata.gz: b32e53f8e5117c75dddf6e9b86e379892b47066fe7dbe3919da8d97232600fce
+  data.tar.gz: 64aa0e6608d0be522249a761e0009fce60058ebe2f6c67dbd9617bd3fffaa3fe
 SHA512:
-  metadata.gz: b038601c5a23e3d510d85f3a7843d9f53cf87b849c1b0c76e9bab0a7dfca5a30daf81e036384c36afdae28e09504ec4ff8ff27ebf2d31bbd03f0c348a5f567ba
-  data.tar.gz: 1b2958cd9f90ad4f8570f061d75fe20faf255eb427303056f8d7fdd4c6872c74dd504a05ed28a30694ecb0a4fc759411bdacf584c330e4f2b9bfd00b3b1d6398
+  metadata.gz: c87f1c996f7ec3f49502a5465c8990a076bef51262408570706cb520359f6446e9adbfafd0a9b6c1bace45b3164caaf3340fb1f4d848d877047c0f41d361a159
+  data.tar.gz: 741e8bd63ccb4d63edcfd7be2467d6b619fa5be8924f295d2f886da3af0017e201d8891adc8076c6af65c42dbbbf4202d259573e6c55f9a58f0a131993f4294d

data/README.md

@@ -353,7 +353,7 @@ launcher_path = MockServer::BinaryLauncher.ensure_launcher
 ### Specify a version
 
 ```ruby
-handle = MockServer::BinaryLauncher.start(port: 1080, version: '7.6.0')
+handle = MockServer::BinaryLauncher.start(port: 1080, version: '8.0.0')
 ```
 
 ### API reference

data/lib/mockserver/client.rb

@@ -862,8 +862,8 @@ module MockServer
     # (PUT /mockserver/verifySLO).
     #
     # The server encodes the verdict in the HTTP status: 200 for PASS or
-    # INCONCLUSIVE, 406 for FAIL, 400 for malformed criteria or when SLO tracking
-    # is disabled (+sloTrackingEnabled=false+). The decoded verdict Hash carries
+    # INCONCLUSIVE, 406 for FAIL, 403 when SLO tracking is disabled
+    # (+sloTrackingEnabled=false+) and 400 for malformed criteria. The decoded verdict Hash carries
     # the overall +result+ and the per-objective +objectiveResults+ so callers can
     # inspect why an SLO failed.
     #
@@ -875,7 +875,7 @@ module MockServer
     # @param criteria [Hash, #to_h] the SLO criteria
     # @return [Hash] the SLO verdict (result PASS or INCONCLUSIVE)
     # @raise [VerificationError] if the verdict is FAIL (HTTP 406)
-    # @raise [Error] if criteria are malformed or SLO tracking is disabled (HTTP 400),
+    # @raise [Error] if SLO tracking is disabled (HTTP 403) or criteria are malformed (HTTP 400),
     #   or on any other failure
     def verify_slo(criteria)
       payload = criteria.respond_to?(:to_h) ? criteria.to_h : criteria
@@ -884,9 +884,12 @@ module MockServer
       if status == 406
         raise VerificationError, (response_body && !response_body.empty? ? response_body : 'SLO verdict: FAIL')
       end
+      if status == 403
+        raise Error, 'SLO tracking is disabled — set sloTrackingEnabled=true ' \
+                     "on the server: #{response_body}"
+      end
       if status == 400
-        raise Error, 'Invalid SLO criteria (or SLO tracking disabled — set ' \
-                     "sloTrackingEnabled=true on the server): #{response_body}"
+        raise Error, "Invalid SLO criteria: #{response_body}"
       end
       if status >= 400
         raise Error, "Failed to verify SLO (status=#{status}): #{response_body}"
@@ -1129,6 +1132,116 @@ module MockServer
       []
     end
 
+    # Send a retrieve request filtered by expectation id.
+    #
+    # An expectation id may be sent in place of a request matcher. For
+    # "ACTIVE_EXPECTATIONS" the server returns only the expectation with that id;
+    # for every other type it returns the entries matching that expectation's
+    # request, exactly as verify by expectation id matches them. An unknown id is
+    # rejected with a 400.
+    #
+    # @param expectation_id [String]
+    # @param query_params [Hash]
+    # @return [Array(Integer, String)] the status and response body
+    # @api private
+    def retrieve_by_id(expectation_id, query_params)
+      do_request(
+        'PUT', '/mockserver/retrieve', JSON.generate({ 'id' => expectation_id }), query_params
+      )
+    end
+    private :retrieve_by_id
+
+    # Retrieve the recorded requests matching the request of the expectation with the given id.
+    # @param expectation_id [String]
+    # @return [Array<HttpRequest>]
+    def retrieve_recorded_requests_by_id(expectation_id)
+      status, response_body = retrieve_by_id(
+        expectation_id, { 'type' => 'REQUESTS', 'format' => 'JSON' }
+      )
+      if status >= 400
+        raise Error, "Failed to retrieve recorded requests by id (status=#{status}): #{response_body}"
+      end
+
+      if response_body && !response_body.empty?
+        parsed = JSON.parse(response_body)
+        return parsed.map { |r| HttpRequest.from_hash(r) } if parsed.is_a?(Array)
+      end
+      []
+    end
+
+    # Retrieve the active expectation with the given id.
+    # @param expectation_id [String]
+    # @return [Array<Expectation>]
+    def retrieve_active_expectations_by_id(expectation_id)
+      status, response_body = retrieve_by_id(
+        expectation_id, { 'type' => 'ACTIVE_EXPECTATIONS', 'format' => 'JSON' }
+      )
+      if status >= 400
+        raise Error, "Failed to retrieve active expectations by id (status=#{status}): #{response_body}"
+      end
+
+      if response_body && !response_body.empty?
+        parsed = JSON.parse(response_body)
+        return parsed.map { |e| Expectation.from_hash(e) } if parsed.is_a?(Array)
+      end
+      []
+    end
+
+    # Retrieve the recorded expectations matching the request of the expectation with the given id.
+    # @param expectation_id [String]
+    # @return [Array<Expectation>]
+    def retrieve_recorded_expectations_by_id(expectation_id)
+      status, response_body = retrieve_by_id(
+        expectation_id, { 'type' => 'RECORDED_EXPECTATIONS', 'format' => 'JSON' }
+      )
+      if status >= 400
+        raise Error, "Failed to retrieve recorded expectations by id (status=#{status}): #{response_body}"
+      end
+
+      if response_body && !response_body.empty?
+        parsed = JSON.parse(response_body)
+        return parsed.map { |e| Expectation.from_hash(e) } if parsed.is_a?(Array)
+      end
+      []
+    end
+
+    # Retrieve the recorded requests and responses matching the request of the expectation with the given id.
+    # @param expectation_id [String]
+    # @return [Array<HttpRequestAndHttpResponse>]
+    def retrieve_recorded_requests_and_responses_by_id(expectation_id)
+      status, response_body = retrieve_by_id(
+        expectation_id, { 'type' => 'REQUEST_RESPONSES', 'format' => 'JSON' }
+      )
+      if status >= 400
+        raise Error, "Failed to retrieve request/responses by id (status=#{status}): #{response_body}"
+      end
+
+      if response_body && !response_body.empty?
+        parsed = JSON.parse(response_body)
+        return parsed.map { |rr| HttpRequestAndHttpResponse.from_hash(rr) } if parsed.is_a?(Array)
+      end
+      []
+    end
+
+    # Retrieve the log messages matching the request of the expectation with the given id.
+    # @param expectation_id [String]
+    # @return [Array<String>]
+    def retrieve_log_messages_by_id(expectation_id)
+      status, response_body = retrieve_by_id(expectation_id, { 'type' => 'LOGS' })
+      if status >= 400
+        raise Error, "Failed to retrieve log messages by id (status=#{status}): #{response_body}"
+      end
+
+      return [] unless response_body && !response_body.empty?
+
+      begin
+        parsed = JSON.parse(response_body)
+        parsed.is_a?(Array) ? parsed : []
+      rescue JSON::ParserError
+        response_body.split("------------------------------------\n")
+      end
+    end
+
     # Retrieve the active expectations as MockServer SDK setup code (the builder
     # code that recreates the expectations) in the requested language.
     # @param format [String] one of "java", "javascript", "python", "go",

data/lib/mockserver/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MockServer
-  VERSION = '7.6.0'
+  VERSION = '8.0.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mockserver-client
 version: !ruby/object:Gem::Version
-  version: 7.6.0
+  version: 8.0.0
 platform: ruby
 authors:
 - James Bloom
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-17 00:00:00.000000000 Z
+date: 2026-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger