pact-v2 2.0.0.pre.preview2 → 2.0.0.pre.preview3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23f610401e860f40dadf011d0609bb01b240d6002f07800df3815b35435df4c1
-  data.tar.gz: 26235296c89f61bcbcc4e7b849793bfeeb286decef097a9168a9fdcb74a9c6ff
+  metadata.gz: 0f4ee103d30ead3e3bb7c57842add4eb6e0aea19da1ab945c4007631d49ffa94
+  data.tar.gz: 514b47642e7634b2b3232a353869277be5ca9f536a687a19f7eca366215dd9ee
 SHA512:
-  metadata.gz: 71746aac031e4164e75e3f315f9cd17e45b299d615b92aaf069c3d43dd392be708eaa9b83a11dd5026337ac1dc28314867bb9191214e0736768ebc9359299737
-  data.tar.gz: d3e77fe2177f4b1e7a549e4196c2cbb101f478d0ce04ab754c3d95802a9ba7ba8a0cce74391cbf84bb0f728777ec1e3902ab5f621aae0a95da96db907162ecf3
+  metadata.gz: db69fe7c250ffa31e0a19c5d11eb3626e843262146339267931c8aa4e8c8dc05d5016d73cedb287e72f7c6a1a558afd493a8ea5af649df24e12a5a8beff848f1
+  data.tar.gz: a3c315ac1a9beb4dc8da7778fcaae331496b880e287ea124b1b50ca53f36f260bfcf746fac8065e808935db5b12794f57ae75608154beda679589da053b7ffd6

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+<a name="v1.66.2"></a>
+### v1.66.2 (2025-10-03)
+
+#### Bug Fixes
+
+* **spec**
+  * update rspec keyword vs arg changes https://github.com/rspec/rspec-mocks/pull/1473	 ([c1c17fc](/../../commit/c1c17fc))
+
+* correct generators import and update specs	 ([d025342](/../../commit/d025342))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([4dfb3f5](/../../commit/4dfb3f5))
+* example/animal-service/Gemfile to reduce vulnerabilities	 ([3d8fa31](/../../commit/3d8fa31))
+* example/zoo-app/Gemfile to reduce vulnerabilities	 ([5ff8945](/../../commit/5ff8945))
+
 <a name="v1.66.1"></a>
 ### v1.66.1 (2025-01-20)
 

data/lib/pact/provider/request.rb

@@ -29,7 +29,7 @@ module Pact
           when String then expected_request.body
           when NullExpectation then ''
           else
-            Pact::Generators.apply_generators(expected_request, "body", reified_body, @state_params)
+            generated_body
           end
         end
 
@@ -60,6 +60,19 @@ module Pact
           end
         end
 
+        def generated_body
+          result = Pact::Generators.apply_generators(expected_request, "body", reified_body, @state_params)
+
+          case result
+          when Hash
+            result.to_json
+          when String
+            result
+          else
+            raise "Expected body to be a String or Hash, but was #{result.class} with value #{result.inspect}"
+          end
+        end
+
         def rack_request_header_for header
           with_http_prefix(header.to_s.upcase).tr('-', '_')
         end

data/lib/pact/v2/consumer/grpc_interaction_builder.rb

@@ -68,6 +68,13 @@ module Pact
           self
         end
 
+        def with_pact_protobuf_plugin_version(version)
+          raise InteractionBuilderError.new("version is required") if version.blank?
+
+          @proto_plugin_version = version
+          self
+        end
+
         def given(provider_state, metadata = {})
           @provider_state_meta = {provider_state => metadata}
           self
@@ -142,13 +149,13 @@ module Pact
 
           yield(message_pact, mock_server)
 
+        ensure
           if mock_server.matched?
             mock_server.write_pacts!(@pact_config.pact_dir)
           else
             msg = mismatches_error_msg(mock_server)
             raise InteractionMismatchesError.new(msg)
           end
-        ensure
           @used = true
           mock_server&.cleanup
           PactFfi::PluginConsumer.cleanup_plugins(pact_handle)
@@ -175,11 +182,11 @@ module Pact
         end
 
         def init_plugin!(pact_handle)
-          result = PactFfi::PluginConsumer.using_plugin(pact_handle, PROTOBUF_PLUGIN_NAME, PROTOBUF_PLUGIN_VERSION)
+          result = PactFfi::PluginConsumer.using_plugin(pact_handle, PROTOBUF_PLUGIN_NAME, @proto_plugin_version || PROTOBUF_PLUGIN_VERSION)
           return result if INIT_PLUGIN_ERRORS[result].blank?
 
           error = INIT_PLUGIN_ERRORS[result]
-          raise PluginInitError.new("There was an error while trying to initialize plugin #{PROTOBUF_PLUGIN_NAME}/#{PROTOBUF_PLUGIN_VERSION}", error[:reason], error[:status])
+          raise PluginInitError.new("There was an error while trying to initialize plugin #{PROTOBUF_PLUGIN_NAME}/#{@proto_plugin_version || PROTOBUF_PLUGIN_VERSION}", error[:reason], error[:status])
         end
       end
     end

data/lib/pact/v2/consumer/http_interaction_builder.rb

@@ -9,7 +9,6 @@ module Pact
   module V2
     module Consumer
       class HttpInteractionBuilder
-        DESCRIPTION_PREFIX = "http: "
 
         # https://docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_interaction_contents.html
         CREATE_INTERACTION_ERRORS = {
@@ -114,13 +113,13 @@ module Pact
 
           yield(mock_server)
 
+        ensure
           if mock_server.matched?
             mock_server.write_pacts!(pact_config.pact_dir)
           else
             msg = mismatches_error_msg(mock_server)
             raise InteractionMismatchesError.new(msg)
           end
-        ensure
           @used = true
           mock_server&.cleanup
           # Reset the pact handle to allow for a new interaction to be built

data/lib/pact/v2/consumer/interaction_contents.rb

@@ -33,6 +33,10 @@ module Pact
             return hash.as_basic if format == :basic
             return hash.as_plugin if format == :plugin
           end
+          if hash.is_a?(Pact::V2::Generators::Base)
+            return hash.as_basic if format == :basic
+            return hash.as_plugin if format == :plugin
+          end
           hash.each_pair do |key, value|
             next serialize(value, format) if value.is_a?(Hash)
             next hash[key] = value.map { |v| serialize(v, format) } if value.is_a?(Array)
@@ -40,6 +44,10 @@ module Pact
               hash[key] = value.as_basic if format == :basic
               hash[key] = value.as_plugin if format == :plugin
             end
+            if value.is_a?(Pact::V2::Generators::Base)
+              hash[key] = value.as_basic if format == :basic
+              hash[key] = value.as_plugin if format == :plugin
+            end
           end
 
           hash

data/lib/pact/v2/consumer/message_interaction_builder.rb

@@ -86,6 +86,13 @@ module Pact
           self
         end
 
+        def with_pact_protobuf_plugin_version(version)
+          raise InteractionBuilderError.new("version is required") if version.blank?
+
+          @proto_plugin_version = version
+          self
+        end
+
         def with_proto_contents(contents_hash)
           @proto_contents = InteractionContents.plugin(contents_hash)
           self
@@ -257,11 +264,11 @@ module Pact
         end
 
         def init_plugin!(pact_handle)
-          result = PactFfi::PluginConsumer.using_plugin(pact_handle, PROTOBUF_PLUGIN_NAME, PROTOBUF_PLUGIN_VERSION)
+          result = PactFfi::PluginConsumer.using_plugin(pact_handle, PROTOBUF_PLUGIN_NAME, @proto_plugin_version || PROTOBUF_PLUGIN_VERSION)
           return result if INIT_PLUGIN_ERRORS[result].blank?
 
           error = INIT_PLUGIN_ERRORS[result]
-          raise PluginInitError.new("There was an error while trying to initialize plugin #{PROTOBUF_PLUGIN_NAME}/#{PROTOBUF_PLUGIN_VERSION}", error[:reason], error[:status])
+          raise PluginInitError.new("There was an error while trying to initialize plugin #{PROTOBUF_PLUGIN_NAME}/#{@proto_plugin_version || PROTOBUF_PLUGIN_VERSION}", error[:reason], error[:status])
         end
 
         def serialize_metadata(metadata_hash)

data/lib/pact/v2/consumer/mock_server.rb

@@ -11,8 +11,6 @@ module Pact
         TRANSPORT_HTTP = "http"
         TRANSPORT_GRPC = "grpc"
 
-        TRANSPORTS = [TRANSPORT_HTTP, TRANSPORT_GRPC].freeze
-
         class MockServerCreateError < Pact::V2::FfiError; end
 
         class WritePactsError < Pact::V2::FfiError; end
@@ -41,8 +39,11 @@ module Pact
           new(pact: pact, transport: TRANSPORT_HTTP, host: host, port: port)
         end
 
+        def self.create_for_transport!(pact:, transport:, host: "127.0.0.1", port: 0)
+          new(pact: pact, transport: transport, host: host, port: port)
+        end
+
         def initialize(pact:, transport:, host:, port:)
-          raise "Transport #{transport} is not supported yet, available transports are: #{TRANSPORTS.join(",")}" unless TRANSPORTS.include?(transport)
 
           @pact = pact
           @transport = transport

data/lib/pact/v2/consumer/pact_config/plugin_async_message.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Pact
+  module V2
+    module Consumer
+      module PactConfig
+        class PluginAsyncMessage < Base
+          attr_reader :mock_host, :mock_port
+
+          def initialize(consumer_name:, provider_name:, opts: {})
+            super
+
+            @mock_host = opts[:mock_host] || "127.0.0.1"
+            @mock_port = opts[:mock_port] || 0
+          end
+
+          def new_interaction(description = nil)
+            PluginAsyncMessageInteractionBuilder.new(self, description: description)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pact/v2/consumer/pact_config/plugin_http.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Pact
+  module V2
+    module Consumer
+      module PactConfig
+        class PluginHttp < Base
+          attr_reader :mock_host, :mock_port
+
+          def initialize(consumer_name:, provider_name:, opts: {})
+            super
+
+            @mock_host = opts[:mock_host] || "127.0.0.1"
+            @mock_port = opts[:mock_port] || 0
+          end
+
+          def new_interaction(description = nil)
+            PluginHttpInteractionBuilder.new(self, description: description)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pact/v2/consumer/pact_config/plugin_sync_message.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Pact
+  module V2
+    module Consumer
+      module PactConfig
+        class PluginSyncMessage < Base
+          attr_reader :mock_host, :mock_port
+
+          def initialize(consumer_name:, provider_name:, opts: {})
+            super
+
+            @mock_host = opts[:mock_host] || "127.0.0.1"
+            @mock_port = opts[:mock_port] || 0
+          end
+
+          def new_interaction(description = nil)
+            PluginSyncMessageInteractionBuilder.new(self, description: description)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pact/v2/consumer/pact_config.rb

@@ -14,6 +14,12 @@ module Pact
             Grpc.new(consumer_name: consumer_name, provider_name: provider_name, opts: opts)
           when :message
             Message.new(consumer_name: consumer_name, provider_name: provider_name, opts: opts)
+          when :plugin_sync_message
+            PluginSyncMessage.new(consumer_name: consumer_name, provider_name: provider_name, opts: opts)
+          when :plugin_async_message
+            PluginAsyncMessage.new(consumer_name: consumer_name, provider_name: provider_name, opts: opts)
+          when :plugin_http
+            PluginHttp.new(consumer_name: consumer_name, provider_name: provider_name, opts: opts)
           else
             raise ArgumentError, "unknown transport_type: #{transport_type}"
           end

data/lib/pact/v2/consumer/plugin_async_message_interaction_builder.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require "pact/ffi/async_message_pact"
+require "pact/ffi/plugin_consumer"
+require "pact/ffi/logger"
+
+module Pact
+  module V2
+    module Consumer
+      class PluginAsyncMessageInteractionBuilder
+
+        class PluginInitError < Pact::V2::FfiError; end
+
+        # https://docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_using_plugin.html
+        INIT_PLUGIN_ERRORS = {
+          1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
+          2 => {reason: :plugin_load_failed, status: 2, description: "Failed to load the plugin"},
+          3 => {reason: :invalid_handle, status: 3, description: "Pact Handle is not valid"}
+        }.freeze
+
+        # https://docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_interaction_contents.html
+        CREATE_INTERACTION_ERRORS = {
+          1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
+          2 => {reason: :mock_server_already_running, status: 2, description: "The mock server has already been started"},
+          3 => {reason: :invalid_handle, status: 3, description: "The interaction handle is invalid"},
+          4 => {reason: :invalid_content_type, status: 4, description: "The content type is not valid"},
+          5 => {reason: :invalid_contents, status: 5, description: "The contents JSON is not valid JSON"},
+          6 => {reason: :plugin_error, status: 6, description: "The plugin returned an error"}
+        }.freeze
+
+        class CreateInteractionError < Pact::V2::FfiError; end
+
+        class InteractionMismatchesError < Pact::V2::Error; end
+
+        class InteractionBuilderError < Pact::V2::Error; end
+
+        def initialize(pact_config, description: nil)
+          @pact_config = pact_config
+          @description = description || ""
+          @contents = nil
+          @provider_state_meta = nil
+        end
+
+        def with_plugin(plugin_name, plugin_version)
+          raise InteractionBuilderError.new("plugin_name is required") if plugin_name.blank?
+          raise InteractionBuilderError.new("plugin_version is required") if plugin_version.blank?
+
+          @plugin_name = plugin_name
+          @plugin_version = plugin_version
+          self
+        end
+
+        def given(provider_state, metadata = {})
+          @provider_state_meta = {provider_state => metadata}
+          self
+        end
+
+        def upon_receiving(description)
+          @description = description
+          self
+        end
+
+        def with_contents(contents_hash)
+          @contents = InteractionContents.plugin(contents_hash)
+          self
+        end
+
+        def with_content_type(content_type)
+          @interaction_content_type = content_type || @content_type
+          self
+        end
+
+        def with_plugin_metadata(meta_hash)
+          @plugin_metadata = meta_hash
+          self
+        end
+
+        def with_transport(transport)
+          @transport = transport
+          self
+        end
+
+        def interaction_json
+          result = {
+            contents: @contents
+          }
+          result.merge!(@plugin_metadata) if @plugin_metadata.is_a?(Hash)
+          JSON.dump(result)
+        end
+
+        def validate!
+          raise InteractionBuilderError.new("invalid contents format, should be a hash") unless @contents.is_a?(Hash)
+        end
+
+        def execute(&block)
+          raise InteractionBuilderError.new("interaction is designed to be used one-time only") if defined?(@used)
+
+          validate!
+
+          pact_handle = init_pact
+          init_plugin!(pact_handle)
+
+          interaction = PactFfi::AsyncMessageConsumer.new(pact_handle, @description)
+
+          @provider_state_meta&.each_pair do |provider_state, meta|
+            if meta.present?
+                meta.each_pair do |k, v|
+                if v.nil? || (v.respond_to?(:empty?) && v.empty?)
+                  PactFfi.given(interaction, provider_state)
+                else
+                  PactFfi.given_with_param(interaction, provider_state, k.to_s, v.to_s)
+                end
+                end
+            else
+              PactFfi.given(interaction, provider_state)
+            end
+          end
+
+          result = PactFfi.with_body(interaction, 0, @interaction_content_type, interaction_json)
+          if CREATE_INTERACTION_ERRORS[result].present?
+            error = CREATE_INTERACTION_ERRORS[result]
+            raise CreateInteractionError.new("There was an error while trying to add interaction \"#{@description}\"", error[:reason], error[:status])
+          end
+
+          mock_server = MockServer.create_for_transport!(pact: pact_handle, transport: @transport, host: @pact_config.mock_host, port: @pact_config.mock_port)
+
+          yield(pact_handle, mock_server)
+
+        ensure
+          if mock_server.matched?
+            mock_server.write_pacts!(@pact_config.pact_dir)
+          else
+            msg = mismatches_error_msg(mock_server)
+            raise InteractionMismatchesError.new(msg)
+          end
+          @used = true
+          mock_server&.cleanup
+          PactFfi::PluginConsumer.cleanup_plugins(pact_handle) if pact_handle
+          PactFfi.free_pact_handle(pact_handle) if pact_handle
+        end
+
+        private
+
+        def mismatches_error_msg(mock_server)
+          rspec_example_desc = RSpec.current_example&.description
+          return "interaction for has mismatches: #{mock_server.mismatches}" if rspec_example_desc.blank?
+
+          "#{rspec_example_desc} has mismatches: #{mock_server.mismatches}"
+        end
+
+        def init_pact
+          handle = PactFfi.new_pact(@pact_config.consumer_name, @pact_config.provider_name)
+          PactFfi.with_specification(handle, PactFfi::FfiSpecificationVersion["SPECIFICATION_VERSION_V4"])
+          PactFfi.with_pact_metadata(handle, "pact-ruby-v2", "pact-ffi", PactFfi.version)
+
+          Pact::V2::Native::Logger.log_to_stdout(@pact_config.log_level)
+
+          handle
+        end
+
+        def init_plugin!(pact_handle)
+          result = PactFfi::PluginConsumer.using_plugin(pact_handle, @plugin_name, @plugin_version)
+          return result if INIT_PLUGIN_ERRORS[result].blank?
+
+          error = INIT_PLUGIN_ERRORS[result]
+          raise PluginInitError.new("There was an error while trying to initialize plugin #{@plugin_name}/#{@plugin_version}", error[:reason], error[:status])
+        end
+      end
+    end
+  end
+end

data/lib/pact/v2/consumer/plugin_http_interaction_builder.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+require "pact/ffi/http_consumer"
+require "pact/ffi/plugin_consumer"
+require "pact/ffi/logger"
+
+module Pact
+  module V2
+    module Consumer
+      class PluginHttpInteractionBuilder
+
+        class PluginInitError < Pact::V2::FfiError; end
+
+        # https://docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_using_plugin.html
+        INIT_PLUGIN_ERRORS = {
+          1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
+          2 => {reason: :plugin_load_failed, status: 2, description: "Failed to load the plugin"},
+          3 => {reason: :invalid_handle, status: 3, description: "Pact Handle is not valid"}
+        }.freeze
+
+        # https://docs.rs/pact_ffi/0.4.17/pact_ffi/plugins/fn.pactffi_interaction_contents.html
+        CREATE_INTERACTION_ERRORS = {
+          1 => {reason: :internal_error, status: 1, description: "A general panic was caught"},
+          2 => {reason: :mock_server_already_running, status: 2, description: "The mock server has already been started"},
+          3 => {reason: :invalid_handle, status: 3, description: "The interaction handle is invalid"},
+          4 => {reason: :invalid_content_type, status: 4, description: "The content type is not valid"},
+          5 => {reason: :invalid_contents, status: 5, description: "The contents JSON is not valid JSON"},
+          6 => {reason: :plugin_error, status: 6, description: "The plugin returned an error"}
+        }.freeze
+
+        class CreateInteractionError < Pact::V2::FfiError; end
+
+        class InteractionMismatchesError < Pact::V2::Error; end
+
+        class InteractionBuilderError < Pact::V2::Error; end
+
+        def initialize(pact_config, description: nil)
+          @pact_config = pact_config
+          @description = description || ""
+          @contents = nil
+          @provider_state_meta = nil
+        end
+
+        def with_plugin(plugin_name, plugin_version)
+          raise InteractionBuilderError.new("plugin_name is required") if plugin_name.blank?
+          raise InteractionBuilderError.new("plugin_version is required") if plugin_version.blank?
+
+          @plugin_name = plugin_name
+          @plugin_version = plugin_version
+          self
+        end
+
+        def given(provider_state, metadata = {})
+          @provider_state_meta = {provider_state => metadata}
+          self
+        end
+
+        def upon_receiving(description)
+          @description = description
+          self
+        end
+
+        def with_request(method: nil, path: nil, query: {}, headers: {}, body: nil)
+          @request = {
+            method: method,
+            path: path,
+            query: query,
+            headers: headers,
+            body: body
+          }
+          self
+        end
+
+        def will_respond_with(status: nil, headers: {}, body: nil)
+          @response = {
+            status: status,
+            headers: headers,
+            body: body
+          }
+          self
+        end
+  
+        def with_content_type(content_type)
+          @content_type = content_type
+          self
+        end
+
+
+        def with_plugin_metadata(meta_hash)
+          @plugin_metadata = meta_hash
+          self
+        end
+
+        def with_transport(transport)
+          @transport = transport
+          self
+        end
+
+        def interaction_json
+          result = {
+            request: @request,
+            response: @response
+          }
+          result.merge!(@plugin_metadata) if @plugin_metadata.is_a?(Hash)
+          JSON.dump(result)
+        end
+
+        def validate!
+          raise InteractionBuilderError.new("invalid request format, should be a hash") unless @request.is_a?(Hash)
+          raise InteractionBuilderError.new("invalid response format, should be a hash") unless @response.is_a?(Hash)
+        end
+
+        def execute(&block)
+          raise InteractionBuilderError.new("interaction is designed to be used one-time only") if defined?(@used)
+
+          validate!
+
+          pact_handle = init_pact
+          init_plugin!(pact_handle)
+
+          interaction = PactFfi.new_interaction(pact_handle, @description)
+          @provider_state_meta&.each_pair do |provider_state, meta|
+            if meta.present?
+                meta.each_pair do |k, v|
+                if v.nil? || (v.respond_to?(:empty?) && v.empty?)
+                  PactFfi.given(interaction, provider_state)
+                else
+                  PactFfi.given_with_param(interaction, provider_state, k.to_s, v.to_s)
+                end
+                end
+            else
+              PactFfi.given(interaction, provider_state)
+            end
+          end
+          PactFfi::HttpConsumer.with_request(interaction, @request[:method], @request[:path])
+
+          result = PactFfi::PluginConsumer.interaction_contents(interaction, 0, @request[:headers]["content-type"], format_value(@request[:body]))
+          if CREATE_INTERACTION_ERRORS[result].present?
+            error = CREATE_INTERACTION_ERRORS[result]
+            raise CreateInteractionError.new("There was an error while trying to add interaction \"#{@description}\"", error[:reason], error[:status])
+          end
+          result = PactFfi::PluginConsumer.interaction_contents(interaction, 1, @response[:headers]["content-type"], format_value(@response[:body]))
+          if CREATE_INTERACTION_ERRORS[result].present?
+            error = CREATE_INTERACTION_ERRORS[result]
+            raise CreateInteractionError.new("There was an error while trying to add interaction \"#{@description}\"", error[:reason], error[:status])
+          end
+          mock_server = MockServer.create_for_transport!(pact: pact_handle, transport: @transport || 'http', host: @pact_config.mock_host, port: @pact_config.mock_port)
+          
+          yield(mock_server)
+
+        ensure
+          if mock_server.matched?
+            mock_server.write_pacts!(@pact_config.pact_dir)
+          else
+            msg = mismatches_error_msg(mock_server)
+            raise InteractionMismatchesError.new(msg)
+          end
+          @used = true
+          mock_server&.cleanup
+          PactFfi::PluginConsumer.cleanup_plugins(pact_handle) if pact_handle
+          PactFfi.free_pact_handle(pact_handle) if pact_handle
+        end
+
+        private
+
+        def mismatches_error_msg(mock_server)
+          rspec_example_desc = RSpec.current_example&.description
+          return "interaction for has mismatches: #{mock_server.mismatches}" if rspec_example_desc.blank?
+
+          "#{rspec_example_desc} has mismatches: #{mock_server.mismatches}"
+        end
+
+        def init_pact
+          handle = PactFfi.new_pact(@pact_config.consumer_name, @pact_config.provider_name)
+          PactFfi.with_specification(handle, PactFfi::FfiSpecificationVersion["SPECIFICATION_VERSION_V4"])
+          PactFfi.with_pact_metadata(handle, "pact-ruby-v2", "pact-ffi", PactFfi.version)
+
+          Pact::V2::Native::Logger.log_to_stdout(@pact_config.log_level)
+
+          handle
+        end
+
+        def init_plugin!(pact_handle)
+          result = PactFfi::PluginConsumer.using_plugin(pact_handle, @plugin_name, @plugin_version)
+          return result if INIT_PLUGIN_ERRORS[result].blank?
+
+          error = INIT_PLUGIN_ERRORS[result]
+          raise PluginInitError.new("There was an error while trying to initialize plugin #{@plugin_name}/#{@plugin_version}", error[:reason], error[:status])
+        end
+
+        def format_value(obj)
+          return obj if obj.is_a?(String)
+
+          return JSON.dump({value: obj}) if obj.is_a?(Array)
+
+          JSON.dump(obj)
+        end
+      end
+    end
+  end
+end