pact_broker 2.119.0 → 2.121.0

data/Gemfile

@@ -5,8 +5,6 @@ gemspec
 
 gem "rake", "~> 13.3"
 gem "sqlite3", ">=2.0.0"
-gem "conventional-changelog", "~>1.3"
-gem "bump", "~> 0.5"
 gem "padrino-core", ">= 0.16.0.pre3", require: false
 gem "rackup", "~> 2.2"
 gem "thor", "~> 1.4" # thor is secondary dependency but bumping here to avoid CVEs
@@ -21,6 +19,8 @@ end
 
 group :test do
   gem "simplecov", :require => false
+  gem "simplecov-cobertura", :require => false
+  gem "rspec_junit_formatter", :require => false
   if ENV["X_PACT_DEVELOPMENT"] == "true"
     gem "pact", path: "../pact-ruby"
     gem "pact-ffi", path: "../pact-ruby-ffi"
@@ -47,10 +47,6 @@ group :pg, optional: true do
   gem "pg", "~>1.6"
 end
 
-group :mysql, optional: true do
-  gem "mysql2", "~>0.5"
-end
-
 if ENV["X_PACT_DEVELOPMENT"] == "true"
   gem "pact-support", path: "../pact-support"
 end

data/README.md

@@ -151,7 +151,6 @@ You can use the [Pact Broker Docker image][docker] or [Terraform on AWS][terrafo
 * Are you sure you don't just want to use the [Pact Broker Docker image][docker]? No Docker at your company yet? Ah well, keep reading.
 * Create a PostgreSQL database.
   * To ensure you're on a supported version of the database that you choose, check the [.github/workflows/test.yml](.github/workflows/test.yml) file to see which versions we're currently running our tests against.
-  * MySQL was supported for the native Ruby application until around 2021, but the official `pactfoundation/pact-broker` Docker image does not support it. New features will not be optimised for MySQL, and some new features may not even be supported on it (eg. the database clean feature).
 * You'll find a sample database creation script in the [example/config.ru](https://github.com/pact-foundation/pact_broker/blob/master/example/config.ru).
 * Install ruby 2.7 and the latest version of bundler (if you've come this far, I'm assuming you know how to do both of these. Did I mention there was a [Docker][docker] image?)
 * Copy the [pact\_broker](https://github.com/DiUS/pact_broker-docker/tree/master/pact_broker) directory from the Pact Broker Docker project. This will have the recommended settings for database connections, logging, basic auth etc. Note that the Docker image uses Phusion Passenger as the web application server in front of the Pact Broker Ruby application, which is the recommended set up if you are not using a containerized solution.
@@ -170,7 +169,7 @@ Please read the [UPGRADING.md](UPGRADING.md) documentation before upgrading your
 
 The Pact Broker follows the [semantic versioning](https://semver.org/) scheme.
 
-[decouple]: https://www.rea-group.com/blog/enter-the-pact-matrix-or-how-to-decouple-the-release-cycles-of-your-microservices/
+[decouple]: https://docs.pact.io/pact_broker/can_i_deploy
 [pact]: https://github.com/pact-foundation/pact-ruby
 [nerf]: https://github.com/pact-foundation/pact_broker/wiki/pact-broker-ci-nerf-gun
 [different-teams]: https://github.com/pact-foundation/pact-ruby/wiki/Using-pact-where-the-consumer-team-is-different-from-the-provider-team

data/db/migrations/000015_create_pact_version_content.rb

@@ -5,7 +5,7 @@ Sequel.migration do
   change do
     create_table(:pact_version_contents, charset: "utf8") do
       String :sha, primary_key: true, null: false, primary_key_constraint_name: "pk_pact_version_contents"
-      String :content, type: PactBroker::MigrationHelper.large_text_type
+      column :content, PactBroker::MigrationHelper.large_text_type
       DateTime :created_at, null: false
       DateTime :updated_at, null: false
     end

data/db/migrations/000023_create_pact_versions_table.rb

@@ -7,7 +7,7 @@ Sequel.migration do
       foreign_key :consumer_id, :pacticipants
       foreign_key :provider_id, :pacticipants
       String :sha, null: false
-      String :content, type: PactBroker::MigrationHelper.large_text_type
+      column :content, PactBroker::MigrationHelper.large_text_type
       index [:consumer_id, :provider_id, :sha], unique: true, name: "unq_pvc_con_prov_sha"
       DateTime :created_at, null: false
     end

data/db/migrations/000033_create_config_table.rb

@@ -6,7 +6,7 @@ Sequel.migration do
       primary_key :id
       String :name, null: false
       String :type, null: false
-      String :value, type: PactBroker::MigrationHelper.large_text_type
+      column :value, PactBroker::MigrationHelper.large_text_type
       DateTime :created_at, null: false
       DateTime :updated_at, null: false
       index [:name], unique: true, name: "unq_config_name"

data/db/migrations/000036_create_webhook_execution.rb

@@ -9,7 +9,7 @@ Sequel.migration do
       foreign_key :consumer_id, :pacticipants, null: false
       foreign_key :provider_id, :pacticipants, null: false
       Boolean :success, null: false
-      String :logs, type: PactBroker::MigrationHelper.large_text_type
+      column :logs, PactBroker::MigrationHelper.large_text_type
       DateTime :created_at, null: false
     end
   end

data/db/migrations/20180108_create_certificates_table.rb

@@ -6,7 +6,7 @@ Sequel.migration do
       primary_key :id
       String :uuid, null: false, unique: true, unique_constraint_name: "uq_certificate_uuid"
       String :description, null: true
-      String :content, null: false, type: PactBroker::MigrationHelper.large_text_type
+      column :content, PactBroker::MigrationHelper.large_text_type, null: false
       DateTime :created_at, null: false
       DateTime :updated_at, null: false
     end

data/db/migrations/migration_helper.rb

@@ -10,7 +10,7 @@ module PactBroker
     end
 
     def large_text_type
-      if postgres?
+      if postgres? || sqlite?
         :text
       else
         # Assume mysql
@@ -32,6 +32,10 @@ module PactBroker
       adapter =~ /postgres/
     end
 
+    def sqlite?
+      adapter =~ /sqlite/
+    end
+
     def adapter
       Sequel::Model.db.adapter_scheme.to_s
     end

data/docs/CONFIGURATION.md

@@ -34,6 +34,25 @@ The application log format. Can be any value supported by Semantic Logger.
 **Allowed values:** `default`, `json`, `color`<br/>
 **More information:** https://github.com/rocketjob/semantic_logger/tree/master/lib/semantic_logger/formatters<br/>
 
+### log_otel_enabled
+
+Controls whether logs are also emitted to the OpenTelemetry logs pipeline.
+
+`auto` (the default) adds the OpenTelemetry appender only when the
+`opentelemetry-logs-sdk` gem is installed and an OpenTelemetry logger provider
+is configured. `true` forces the appender on and raises an error if the gem is
+not available. `false` disables it entirely.
+
+The `opentelemetry-logs-sdk` gem is an optional, runtime-detected dependency and
+is not bundled with the Pact Broker. When `log_format` is set to `json`, active
+trace and span IDs are also embedded in the JSON log output.
+
+**Supported versions:** From v2.120.0<br/>
+**Environment variable name:** `PACT_BROKER_LOG_OTEL_ENABLED`<br/>
+**YAML configuration key name:** `log_otel_enabled`<br/>
+**Default:** `auto`<br/>
+**Allowed values:** `auto`, `true`, `false`<br/>
+
 ### log_dir
 
 The log file directory
@@ -248,8 +267,8 @@ The number of seconds after which an SQL query will be aborted. Only supported f
 
 **Environment variable name:** `PACT_BROKER_DATABASE_STATEMENT_TIMEOUT`<br/>
 **YAML configuration key name:** `database_statement_timeout`<br/>
-**Default:** `15000`<br/>
-**Allowed values:** A positive integer in milliseconds<br/>
+**Default:** `15`<br/>
+**Allowed values:** A positive integer or float.<br/>
 **More information:** https://www.postgresql.org/docs/9.3/runtime-config-client.html<br/>
 
 ### metrics_sql_statement_timeout
@@ -533,6 +552,14 @@ The URL of the shields.io server used to generate the README badges.
 **Default:** `https://img.shields.io`<br/>
 **More information:** https://shields.io<br/>
 
+### badge_default_cache_setting
+
+Cache Control header value for the badge, this  sets the cache-control header for the badge image, for more information on header formats see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/cache-control
+
+**Environment variable name:** `PACT_BROKER_BADGE_DEFAULT_CACHE_SETTING`<br/>
+**YAML configuration key name:** `badge_default_cache_setting`<br/>
+**Default:** `max-age=30`<br/>
+
 ### badge_provider_mode
 
 The method by which the badges are generated. When set to `redirect`, a request to the Pact Broker for a badge will be sent a redirect response

data/docs/matrix-optimisation/README.md

@@ -0,0 +1,85 @@
+# Matrix query baselines
+
+Tooling to capture a query-profile baseline (per-request query count, exact SQL,
+and `EXPLAIN` plans) for the `/matrix` and `/can-i-deploy` endpoints, so query
+cost can be compared before and after changes to the query engine.
+
+The generated baseline files (`baseline-*.md`) are **git-ignored** — generate them
+locally and diff two runs; they are not committed.
+
+## Generate a baseline (Postgres)
+
+Baselines are generated against **Postgres** (the production backend). Start a
+throwaway Postgres with the dev compose file:
+
+    docker compose -f docker-compose-dev-postgres.yml up -d postgres
+
+The Postgres version is controlled by `POSTGRES_VERSION` (default `15`),
+so a baseline can be captured against a specific major version:
+
+    POSTGRES_VERSION=14 docker compose -f docker-compose-dev-postgres.yml up -d postgres
+
+The `pg` driver lives in an optional bundle group, so it must be installed and
+enabled explicitly — without `BUNDLE_WITH=pg` the run fails with
+`LoadError: cannot load such file -- pg`:
+
+    BUNDLE_WITH=pg bundle install
+
+Point the suite at the database and run the generator:
+
+    BUNDLE_WITH=pg \
+      PACT_BROKER_TEST_DATABASE_URL="postgres://postgres:postgres@localhost:5432/postgres" \
+      bundle exec rspec spec/benchmarks/matrix_baseline_spec.rb --tag matrix_baseline
+
+This writes `docs/matrix-optimisation/baseline-postgres.md`. Tear the container down
+with `docker compose -f docker-compose-dev-postgres.yml down -v` when done.
+
+> Postgres 18 and later relocated the data directory, which is incompatible with
+> the `/var/lib/postgresql/data` volume mount in `docker-compose-dev-postgres.yml`;
+> the container exits on startup. Use a tag of `17` or lower until that mount is
+> updated.
+
+The generator is tagged `matrix_baseline` and excluded from the default test run;
+it only executes when invoked with `--tag matrix_baseline`. Against a non-Postgres
+database it skips with a message.
+
+## What's captured
+
+For each request shape (see `spec/support/matrix_baseline/shapes.rb`), the file
+records, inside collapsible sections:
+
+- the number of SQL statements the request issued (main query + eager loads);
+- the exact SQL of each statement;
+- its `EXPLAIN` plan.
+
+Plans are captured with `EXPLAIN (ANALYZE, BUFFERS, TIMING OFF)`. That keeps the
+measures of work done — estimated cost, actual row counts, buffer hit/read
+counts, sort and hash memory usage — and drops the measures of how fast this
+particular machine did it. Wall-clock figures are excluded deliberately: they
+vary with unrelated load and would swamp the diff.
+
+## Comparing runs
+
+**Two runs against unchanged code produce a byte-identical file.** Any diff at
+all is a real difference in what the query engine did. Regenerate and diff two
+`baseline-postgres.md` files to compare:
+
+- **query count** per shape (the `N queries` in each section heading);
+- **plan shape** — sequential vs index scans, sorts, join types, UNION branch count;
+- **estimated cost, actual rows, buffers and memory usage** per plan node.
+
+Determinism depends on the generator resetting the database itself — it
+truncates with `RESTART IDENTITY` so surrogate keys in the captured SQL are
+stable, and runs `VACUUM ANALYZE` so plans are chosen against real statistics
+on an unbloated heap. That is why it is tagged `no_db_clean` and will wipe the
+database it is pointed at. **Point it at a throwaway Postgres, never at a
+database whose contents you want to keep.**
+
+## Limitations
+
+- The seed is a few hundred rows per table. Postgres will often choose a
+  sequential scan at this size regardless of index quality, so a plan-shape
+  change here does not automatically imply the same change in production. Query
+  counts and join structure transfer; scan choice on small tables may not.
+- The success filter and can-i-deploy's `--ignore` are applied in Ruby after
+  the query, so their shapes exercise no extra SQL beyond selector resolution.

data/lib/pact/doc/interaction_view_model.rb

@@ -1,6 +1,7 @@
 require "pact/shared/active_support_support"
 require "pact/reification"
 require "cgi"
+require "pact/doc"
 
 module Pact
   module Doc
@@ -149,7 +150,7 @@ module Pact
 
       def markdown_escape string
         return nil unless string
-        string.gsub("*","\\*").gsub("_","\\_")
+        string.gsub(Pact::Doc::MARKDOWN_SPECIAL_CHARS_REGEXP) { |char| "\\#{char}" }
       end
     end
   end

data/lib/pact/doc/markdown/consumer_contract_renderer.rb

@@ -1,6 +1,7 @@
 require "pact/doc/markdown/interaction_renderer"
 require "pact/doc/sort_interactions"
 require "rack/utils"
+require "pact/doc"
 
 module Pact
   module Doc
@@ -60,7 +61,8 @@ module Pact
         end
 
         def markdown_escape string
-          string.gsub("*","\\*").gsub("_","\\_")
+          return nil unless string
+          string.gsub(Pact::Doc::MARKDOWN_SPECIAL_CHARS_REGEXP) { |char| "\\#{char}" }
         end
 
         def h(text)

data/lib/pact/doc.rb

@@ -0,0 +1,5 @@
+module Pact
+  module Doc
+    MARKDOWN_SPECIAL_CHARS_REGEXP = /[\\`*_\[\](){}#+\-.!|]/
+  end
+end

data/lib/pact_broker/api/contracts/put_pact_params_contract.rb

@@ -10,6 +10,8 @@ module PactBroker
           required(:name_in_pact).maybe(:string)
         end
 
+        rule(:name).validate(:not_blank_if_present)
+
         rule(:name, :name_in_pact) do
           if name_in_pact_does_not_match_name_in_url_path?(values)
             key.failure(validation_message("pact_name_in_path_mismatch_name_in_pact", name_in_pact: values[:name_in_pact], name_in_path: values[:name]))

data/lib/pact_broker/api/decorators/provider_states_decorator.rb

@@ -26,7 +26,7 @@ module PactBroker
             end
 
             consumers_map.map do |(name, params), consumers|
-              { name: name, params: params, consumers: consumers.uniq }.transform_keys(&:to_sym)
+              { name: name, params: params, consumers: consumers.uniq.sort }
             end
           .sort_by { |provider_state| provider_state[:name] }
         }, :extend => PactBroker::Api::Decorators::ProviderStateDecorator

data/lib/pact_broker/api/decorators/triggered_webhook_logs_decorator.rb

@@ -11,6 +11,10 @@ module PactBroker
         end
 
 
+        property :event_name, as: :eventName
+        property :consumer_name, as: :consumerName
+        property :provider_name, as: :providerName
+
         nested :triggeredWebhook, embedded: true do
           property :uuid
         end

data/lib/pact_broker/api/decorators/version_decorator.rb

@@ -1,6 +1,7 @@
 require_relative "base_decorator"
 require_relative "embedded_tag_decorator"
 require_relative "embedded_branch_version_decorator"
+require_relative "format_date_time"
 
 module PactBroker
   module Api
@@ -74,21 +75,45 @@ module PactBroker
         end
 
         links :'pb:deployed-environments' do | context |
-          # I couldn't another way to check if call is from a collection or a single item 🤷‍♂️
-          # Also not sure why the heck .to_a?(Hash) doesn't work, I mean what...
-          deployed_versions = context[:deployed_versions].class.to_s == "Hash" ? context[:deployed_versions][represented.id] : context[:deployed_versions]
+          # NB: use fully-qualified ::Hash. The tins gem shadows the bare `Hash`
+          # constant in this scope, so `is_a?(Hash)` returns false even for a real
+          # Hash (this is the collection-vs-single-item branch: the collection
+          # resource passes a version_id-keyed Hash, the single resource an Array).
+          deployed_versions = context.dig(:deployed_versions)
+          deployed_versions = deployed_versions[represented.id] if deployed_versions.is_a?(::Hash)
           deployed_versions&.collect do | deployed_version |
             {
               title: "Version deployed to #{deployed_version.environment.display_name}",
               name: deployed_version.environment.display_name,
               href: deployed_version_url(deployed_version, context.fetch(:base_url)),
-              currently_deployed: deployed_version.currently_deployed
+              currently_deployed: deployed_version.currently_deployed,
+              deployed_at: FormatDateTime.call(deployed_version.created_at),
+              undeployed_at: FormatDateTime.call(deployed_version.undeployed_at)
             }.tap do |hash|
               hash[:application_instance] = deployed_version.application_instance unless deployed_version.application_instance.nil?
             end
           end
         end
 
+        links :'pb:released-environments' do | context |
+          # NB: use fully-qualified ::Hash. The tins gem shadows the bare `Hash`
+          # constant in this scope, so `is_a?(Hash)` returns false even for a real
+          # Hash (this is the collection-vs-single-item branch: the collection
+          # resource passes a version_id-keyed Hash, the single resource an Array).
+          released_versions = context.dig(:released_versions)
+          released_versions = released_versions[represented.id] if released_versions.is_a?(::Hash)
+          released_versions&.collect do | released_version |
+            {
+              title: "Version released to #{released_version.environment.display_name}",
+              name: released_version.environment.display_name,
+              href: released_version_url(released_version, context.fetch(:base_url)),
+              currently_supported: released_version.currently_supported,
+              released_at: FormatDateTime.call(released_version.created_at),
+              support_ended_at: FormatDateTime.call(released_version.support_ended_at)
+            }
+          end
+        end
+
         links :'pb:record-deployment' do | context |
           context[:environments]&.collect do | environment |
             {

data/lib/pact_broker/api/pact_broker_urls.rb

@@ -370,6 +370,10 @@ module PactBroker
         "#{environments_url(base_url)}/#{environment.uuid}"
       end
 
+      def environment_versions_url(pacticipant, environment, base_url = "")
+        "#{pacticipant_url(base_url, pacticipant)}/environments/#{environment.uuid}/versions"
+      end
+
       def deployed_versions_for_version_and_environment_url(version, environment, base_url = "")
         "#{version_url(base_url, version)}/deployed-versions/environment/#{environment.uuid}"
       end

data/lib/pact_broker/api/resources/branch_versions.rb

@@ -27,7 +27,7 @@ module PactBroker
         end
 
         def to_json
-          decorator_class(:versions_decorator).new(versions).to_json(**decorator_options(identifier_from_path.merge(resource_title: resource_title, deployed_versions: deployed_versions)))
+          decorator_class(:versions_decorator).new(versions).to_json(**decorator_options(identifier_from_path.merge(resource_title: resource_title, deployed_versions: deployed_versions, released_versions: released_versions)))
         end
 
         def versions
@@ -38,6 +38,10 @@ module PactBroker
           @deployed_versions ||= deployed_version_service.find_deployed_versions_for_versions(versions)
         end
 
+        def released_versions
+          @released_versions ||= released_version_service.find_released_versions_for_versions(versions)
+        end
+
         def policy_name
           :'versions::versions'
         end

data/lib/pact_broker/api/resources/can_i_deploy_pacticipant_version_by_branch_to_environment.rb

@@ -37,8 +37,11 @@ module PactBroker
         end
 
         def options
+          # "cvpv" (not "cvp") so that every version of an integrated application that is currently
+          # released/deployed to the environment is evaluated independently, rather than collapsing
+          # to just the latest provider version (which hides still-live incompatible versions). See issue #903.
           @options ||=  {
-                          latestby: "cvp",
+                          latestby: "cvpv",
                           environment_name: identifier_from_path[:environment_name]
                         }
         end

data/lib/pact_broker/api/resources/can_i_deploy_pacticipant_version_by_branch_to_environment_badge.rb

@@ -1,4 +1,5 @@
 require "pact_broker/api/resources/can_i_deploy_pacticipant_version_by_branch_to_environment"
+require "pact_broker/api/resources/badge_methods"
 
 module PactBroker
   module Api

data/lib/pact_broker/api/resources/clean.rb

@@ -1,5 +1,6 @@
 require "pact_broker/api/resources/base_resource"
 require "pact_broker/db/clean"
+require "pact_broker/db/clean/branch_selector"
 require "pact_broker/matrix/unresolved_selector"
 
 # Not exposed yet as we'd need to support administrator auth first
@@ -22,7 +23,14 @@ module PactBroker
               PactBroker::DB::Clean::Selector.new(hash)
             end
 
-            result = PactBroker::DB::Clean.call(Sequel::Model.db, { keep: keep_selectors })
+            keep_branch_selectors = (params[:keep_branches] || []).collect do | hash |
+              PactBroker::DB::Clean::BranchSelector.from_hash(hash)
+            end
+
+            result = PactBroker::DB::Clean.call(Sequel::Model.db, {
+              keep: keep_selectors,
+              keep_branches: keep_branch_selectors.empty? ? nil : keep_branch_selectors
+            })
             response.body = result.to_json
           else
             415

data/lib/pact_broker/api/resources/deployed_or_released_versions.rb

@@ -0,0 +1,78 @@
+require "pact_broker/api/resources/base_resource"
+require "pact_broker/api/decorators/versions_decorator"
+require "pact_broker/api/resources/pagination_methods"
+
+module PactBroker
+  module Api
+    module Resources
+      class DeployedOrReleasedVersions < BaseResource
+        include PaginationMethods
+
+        def content_types_provided
+          [["application/hal+json", :to_json]]
+        end
+
+        def allowed_methods
+          ["GET", "OPTIONS"]
+        end
+
+        def malformed_request?
+          super || request.get? && validation_errors_for_schema?(schema, request.query)
+        end
+
+        def resource_exists?
+          !!pacticipant
+        end
+
+        def to_json
+          decorator_class(:versions_decorator).new(versions).to_json(
+            **decorator_options(
+              identifier_from_path.merge(
+                resource_title: "Versions of #{pacticipant_name} that have been deployed or released",
+                deployed_versions: deployed_versions,
+                released_versions: released_versions
+              )
+            )
+          )
+        end
+
+        def policy_name
+          :'versions::versions'
+        end
+
+        private
+
+        def versions
+          @versions ||= version_service.find_by_ids_in_reverse_order(
+            version_ids,
+            pagination_options,
+            decorator_class(:versions_decorator).eager_load_associations
+          )
+        end
+
+        def version_ids
+          PactBroker::Deployments::DeployedVersion
+            .for_pacticipant_name(pacticipant_name)
+            .select(:version_id)
+            .union(
+              PactBroker::Deployments::ReleasedVersion
+                .for_pacticipant_name(pacticipant_name)
+                .select(:version_id)
+            )
+        end
+
+        def deployed_versions
+          @deployed_versions ||= deployed_version_service.find_deployed_versions_for_versions(versions)
+        end
+
+        def released_versions
+          @released_versions ||= released_version_service.find_released_versions_for_versions(versions)
+        end
+
+        def schema
+          PactBroker::Api::Contracts::PaginationQueryParamsSchema if request.get?
+        end
+      end
+    end
+  end
+end

data/lib/pact_broker/api/resources/environment_versions.rb

@@ -0,0 +1,89 @@
+require "pact_broker/api/resources/base_resource"
+require "pact_broker/api/decorators/versions_decorator"
+require "pact_broker/api/resources/pagination_methods"
+
+module PactBroker
+  module Api
+    module Resources
+      class EnvironmentVersions < BaseResource
+        include PaginationMethods
+
+        def content_types_provided
+          [["application/hal+json", :to_json]]
+        end
+
+        def allowed_methods
+          ["GET", "OPTIONS"]
+        end
+
+        def malformed_request?
+          super || request.get? && validation_errors_for_schema?(schema, request.query)
+        end
+
+        def resource_exists?
+          !!environment && !!pacticipant
+        end
+
+        def to_json
+          decorator_class(:versions_decorator).new(versions).to_json(
+            **decorator_options(
+              identifier_from_path.merge(
+                resource_title: resource_title,
+                deployed_versions: deployed_versions,
+                released_versions: released_versions
+              )
+            )
+          )
+        end
+
+        def policy_name
+          :'versions::versions'
+        end
+
+        private
+
+        def versions
+          @versions ||= version_service.find_by_ids_in_reverse_order(
+            version_ids,
+            pagination_options,
+            decorator_class(:versions_decorator).eager_load_associations
+          )
+        end
+
+        def version_ids
+          deployed_ids = PactBroker::Deployments::DeployedVersion
+            .for_environment(environment)
+            .for_pacticipant_name(pacticipant_name)
+            .select_map(:version_id)
+
+          released_ids = PactBroker::Deployments::ReleasedVersion
+            .for_environment(environment)
+            .for_pacticipant_name(pacticipant_name)
+            .select_map(:version_id)
+
+          (deployed_ids + released_ids).uniq
+        end
+
+        def deployed_versions
+          @deployed_versions ||= deployed_version_service.find_deployed_versions_for_versions(versions)
+        end
+
+        def released_versions
+          @released_versions ||= released_version_service.find_released_versions_for_versions(versions)
+        end
+
+        def environment
+          @environment ||= environment_service.find(identifier_from_path[:environment_uuid])
+        end
+
+        def resource_title
+          "Versions for #{pacticipant.name} in environment #{environment.display_name}"
+        end
+
+        def schema
+          PactBroker::Api::Contracts::PaginationQueryParamsSchema if request.get?
+        end
+      end
+    end
+  end
+end