pact 2.0.3 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fedd79fe261a6e6b2a21eba15e1adfddd50ae8a39c947894284eaa693c2a7c0
-  data.tar.gz: 9f07589709bc8423566ca1eb7621240bd3e8cca1e4ebc31c1e018c0f7aa70890
+  metadata.gz: 5981192ff0284632e39d26660bf25cb35109ab17f8e6da065114b46a77e8bf77
+  data.tar.gz: 57c68d0b0217c0c51b55d5ef7d37a56b2fb2db1211de1693cd4020455614a3c2
 SHA512:
-  metadata.gz: 876698c72508446aecad3723893eb3b68e789042801b39c4da3f661c6e5c22bb1bdc7f06de2b7fe93a1ff9b69a01468efefe4acba3c77288784ab40bfd2aca67
-  data.tar.gz: 0d4342358605a35a9da2a1e441e5b25f82957211627c2cf7bea5f6fea2bf556083d329c976ff18e9a32821f66b6da2e52d07deb376db661d930e935a87de1d89
+  metadata.gz: 5af0dcba077273ed185fd2793c4f2183d301d4ae826860cd2e57503d06970ef8dbb36d8c9a4fac266429f847feaee5706fb728e18293201ea4ea285561eb0602
+  data.tar.gz: 6c7cff40d5dac6a7c1ae2d7095486ed73455219b5b03e9fc70c0bc68cb44c7d71f04a6810855ac85586a66d0f52f7b7b9f5a5e2210d367e6902451e3dcbc3ec8

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+<a name="v2.1.0"></a>
+### v2.1.0 (2026-09-14)
+
+#### Features
+
+* add interaction reference (#416)	 ([7953bca](/../../commit/7953bca))
+
 <a name="v2.0.3"></a>
 ### v2.0.3 (2026-09-12)
 

data/lib/pact/consumer/grpc_interaction_builder.rb

@@ -48,6 +48,7 @@ module Pact
         @response = nil
         @response_meta = nil
         @provider_state_meta = nil
+        @references = []
       end
 
       def with_service(proto_path, method, include_dirs = [])
@@ -89,6 +90,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def will_respond_with(resp_hash)
         @response = InteractionContents.plugin(resp_hash)
         self
@@ -138,6 +147,10 @@ module Pact
           end
         end
 
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         result = PactFfi::PluginConsumer.interaction_contents(message_pact, 0, GRPC_CONTENT_TYPE, interaction_json)
         if CREATE_INTERACTION_ERRORS[result].present?
           error = CREATE_INTERACTION_ERRORS[result]

data/lib/pact/consumer/http_interaction_builder.rb

@@ -34,6 +34,7 @@ module Pact
       def initialize(pact_config, description: nil)
         @pact_config = pact_config
         @description = description || ""
+        @references = []
 
         @pact_handle = pact_config.pact_handle ||= init_pact
         @pact_interaction = PactFfi.new_interaction(pact_handle, @description)
@@ -88,6 +89,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def will_respond_with(status: nil, headers: {}, body: nil)
         interaction_part = PactFfi::FfiInteractionPart["INTERACTION_PART_RESPONSE"]
         PactFfi.response_status(pact_interaction, status)
@@ -106,6 +115,10 @@ module Pact
       def execute(&block)
         raise InteractionBuilderError.new("interaction is designed to be used one-time only") if defined?(@used)
 
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         mock_server = MockServer.create_for_http!(
           pact: pact_handle, host: pact_config.mock_host, port: pact_config.mock_port
         )

data/lib/pact/consumer/message_interaction_builder.rb

@@ -58,6 +58,7 @@ module Pact
         @meta = {}
         @headers = {}
         @provider_state_meta = nil
+        @references = []
       end
 
       def given(provider_state, metadata = {})
@@ -75,6 +76,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def with_proto_class(proto_path, message_class_name, include_dirs = [])
         absolute_path = File.expand_path(proto_path)
         raise InteractionBuilderError.new("proto file #{proto_path} does not exist") unless File.exist?(absolute_path)
@@ -131,6 +140,10 @@ module Pact
 
         message_pact = PactFfi::MessageConsumer.new_message_interaction(pact_handle, @description)
 
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         configure_interaction!(message_pact)
 
         # strip out matchers and get raw payload/metadata

data/lib/pact/consumer/plugin_async_message_interaction_builder.rb

@@ -38,6 +38,7 @@ module Pact
         @description = description || ""
         @contents = nil
         @provider_state_meta = nil
+        @references = []
       end
 
       def with_plugin(plugin_name, plugin_version)
@@ -79,6 +80,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def interaction_json
         result = {
           contents: @contents
@@ -101,6 +110,10 @@ module Pact
 
         interaction = PactFfi::AsyncMessageConsumer.new(pact_handle, @description)
 
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         @provider_state_meta&.each_pair do |provider_state, meta|
           if meta.present?
               meta.each_pair do |k, v|

data/lib/pact/consumer/plugin_http_interaction_builder.rb

@@ -38,6 +38,7 @@ module Pact
         @description = description || ""
         @contents = nil
         @provider_state_meta = nil
+        @references = []
       end
 
       def with_plugin(plugin_name, plugin_version)
@@ -95,6 +96,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def interaction_json
         result = {
           request: @request,
@@ -118,6 +127,11 @@ module Pact
         init_plugin!(pact_handle)
 
         interaction = PactFfi.new_interaction(pact_handle, @description)
+
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         @provider_state_meta&.each_pair do |provider_state, meta|
           if meta.present?
               meta.each_pair do |k, v|

data/lib/pact/consumer/plugin_sync_message_interaction_builder.rb

@@ -40,6 +40,7 @@ module Pact
         @response = nil
         @response_meta = nil
         @provider_state_meta = nil
+        @references = []
       end
 
       def with_plugin(plugin_name, plugin_version)
@@ -91,6 +92,14 @@ module Pact
         self
       end
 
+      def reference(group, name, value)
+        raise InteractionBuilderError.new("group is required") if group.blank?
+        raise InteractionBuilderError.new("name is required") if name.blank?
+        raise InteractionBuilderError.new("value is required") if value.blank?
+        @references << [group, name, value]
+        self
+      end
+
       def interaction_json
         result = {
           request: @request
@@ -117,6 +126,11 @@ module Pact
         init_plugin!(pact_handle)
 
         message_pact = PactFfi::SyncMessageConsumer.new_interaction(pact_handle, @description)
+
+        @references.each do |group, name, value|
+          PactFfi.add_interaction_reference(pact_handle, group, name, value)
+        end
+
         @provider_state_meta&.each_pair do |provider_state, meta|
           if meta.present?
             meta.each_pair { |k, v| PactFfi.given_with_param(message_pact, provider_state, k.to_s, v.to_s) }

data/lib/pact/version.rb

@@ -1,4 +1,4 @@
 # Remember to bump pact-provider-proxy when this changes major version
 module Pact
-  VERSION = "2.0.3"
+  VERSION = "2.1.0"
 end

data/pact.gemspec

@@ -36,7 +36,7 @@ Gem::Specification.new do |gem|
   # Core dependencies (code loading)
   gem.add_dependency 'zeitwerk', '~> 2.3'
   # For Pact support via Pact Rust Core
-  gem.add_dependency 'pact-ffi', '~> 0.4.28'
+  gem.add_dependency 'pact-ffi', '~> 0.5.8'
   # For Provider Side Verification
   gem.add_dependency 'rack'
   gem.add_dependency 'rack-proxy'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pact
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.1.0
 platform: ruby
 authors:
 - James Fraser
@@ -33,14 +33,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.28
+        version: 0.5.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.28
+        version: 0.5.8
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement