davinci_pdex_test_kit 0.10.0 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24f9510b1d2105f4b1199d572e887929941fb34ee15a09ccb08faa34558c0561
-  data.tar.gz: caa1b93a05c412f9a75949dcbea9f0840fe18a43c195a41a76b6dc30a4f8caf5
+  metadata.gz: 07b20c46020a10992818e90e951939d60ca6127d0a9e82b3ccd8592c96d6f47c
+  data.tar.gz: 8b8c85a170b4bc89f38c427f303a4e76a256ef467c71226afa6dc14886a01be5
 SHA512:
-  metadata.gz: f14278dd56909c49768c2fc16578dd199a0e5f200af4c12a4eff4ad282eacd6e91ade0b7ed39778cd80b788e8835566fba6db642ec099028064d01e7751444a5
-  data.tar.gz: fc7b2623686c52477fdb32973b7bcf23ae103eb5eccd82c2da1ffe99626380497f48e5d30a64c0fa4c37ec228c2eb51f9954af99e75b7c1f672394617cdbda68
+  metadata.gz: 9dfd5abebf80197b094355572ca218624b4d05be33697bf97701c727d6957eb3881e204608a30f13f4a6240e8b5abcb141c7c2efbe9a8bbae362f2c795c5a8c6
+  data.tar.gz: d74a854a763402112e7628657a2f206822f02fb95d413ec79365576527217a2b3b3e35cfc031300ddb45a3b4b25e93388816622990afa35d2a29ec6a34ecbe45

data/lib/davinci_pdex_test_kit/mock_server.rb

@@ -17,7 +17,7 @@ module DaVinciPDexTestKit
       @server_proxy ||= Faraday.new(
           url: ENV.fetch('FHIR_REFERENCE_SERVER'),
           params: {},
-          headers: {'Content-Type' => 'application/json', 'Authorization' => 'Bearer SAMPLE_TOKEN'},
+          headers: {'Content-Type' => 'application/json', 'Authorization' => 'Bearer SAMPLE_TOKEN', 'Host' => ENV.fetch('HOST_HEADER')},
         )
     end
 
@@ -60,16 +60,38 @@ module DaVinciPDexTestKit
       request.response_body = replace_bundle_urls(FHIR.from_contents(response.body)).to_json
     end
 
-    # def export_response(request, test = nil, test_result = nil)
-    #   response = server_proxy.get do |req|
-    #     req.url 'Group/pdex-Group/$export' #TODO: change from static response
-    #     req.headers['Prefer'] = 'respond-async'
-    #     req.headers['Accept'] = 'application/fhir+json'
-    #   end
-    #   request.status = response.status
-    #   request.response_headers = response.env.response_headers
-    #   request.response_body = response.body
-    # end
+    def export_response(request, test = nil, test_result = nil)
+      headers_as_hash = request.request_headers.map { |header| {"#{header.name}": header.value}}.reduce({}) { |reduced, curr| reduced.merge(curr)}
+      response = server_proxy.get do |req|
+        req.url 'Group/pdex-Group/$export' #TODO: change from static response
+        req.headers = headers_as_hash.merge(server_proxy.headers)
+      end
+      request.status = response.status
+      request.response_headers = response.env.response_headers
+      request.response_header("content-location").value.gsub!(/(.*)\?/, "#{new_link}/$export-poll-status?")
+      request.response_body = response.body
+    end
+
+    def export_status_response(request, test = nil, test_result = nil)
+      headers_as_hash = request.request_headers.map { |header| {"#{header.name}": header.value}}.reduce({}) { |reduced, curr| reduced.merge(curr)}
+      response = server_proxy.get do |req|
+        req.url '$export-poll-status'
+        req.params = request.query_parameters
+        req.headers = headers_as_hash.merge(server_proxy.headers)
+      end
+      request.status = response.status
+      request.response_headers = response.env.response_headers
+      request.response_body = response.status.to_i == 200 ? replace_export_urls(JSON.parse(response.body)).to_json : response.body
+      request.response_header("content-length").value = request.response_body.length
+    end
+
+    def binary_read_response(request, test = nil, test_result = nil)
+      binary_id = request.url.split('/').last
+      response = server_proxy.get('Binary/'+binary_id)
+      request.status = response.status
+      request.response_headers = response.headers
+      request.response_body = response.body
+    end
 
     def member_match_response(request, test = nil, test_result = nil)
       #remove token from request as well
@@ -170,7 +192,7 @@ module DaVinciPDexTestKit
 
     def replace_bundle_urls(bundle)
       reference_server_base = ENV.fetch('FHIR_REFERENCE_SERVER')
-      bundle.link.map! {|link| {relation: link.relation, url: link.url.gsub(reference_server_base, new_link)}}
+      bundle&.link.map! {|link| {relation: link.relation, url: link.url.gsub(reference_server_base, new_link)}}
       bundle&.entry&.map! do |bundled_resource| 
         {fullUrl: bundled_resource.fullUrl.gsub(reference_server_base, new_link),
          resource: bundled_resource.resource,
@@ -180,8 +202,15 @@ module DaVinciPDexTestKit
       bundle
     end
 
+    def replace_export_urls(export_status_output)
+      reference_server_base = ENV.fetch('FHIR_REFERENCE_SERVER')
+      export_status_output['output'].map! { |binary| {type: binary["type"], url: binary["url"].gsub(reference_server_base, new_link)} }
+      export_status_output['request'] = new_link + '/Patient/$export'
+      export_status_output
+    end
+
     def new_link
-      "#{Inferno::Application['base_url']}/custom/pdex_payer_client/fhir"
+      "#{Inferno::Application['base_url']}\/custom\/pdex_payer_client\/fhir"
     end
 
     # @private

data/lib/davinci_pdex_test_kit/pdex_payer_client/client_validation_test.rb

@@ -14,54 +14,13 @@ module DaVinciPDexTestKit
       end
     end
 
-    # def collect_export_resources
-    #   export_payload = collect_export_payload
-    #   if export_payload
-    #     ndjson_list = JSON.parse(export_payload)
-    #     request_resources = ndjson_list['output'].map do |resource_binary|
-    #       retrieved_resources = Faraday.new(
-    #         url: resource_binary['url'],
-    #         headers: {'Content-Type' => 'application/json',
-    #                   'Authorization' => 'Bearer SAMPLE_TOKEN'}
-    #         ).get
-    #       connect_bundle(retrieved_resources.env.response_body) 
-    #     end
-    #     puts request_resources
-    #     request_resources.flatten
-    #   else
-    #     nil
-    #   end
-    # end
-
-    # def connect_bundle(export_binary)
-    #   export_binary.split(/(?<=}\n)(?={)/).map { |str| FHIR.from_contents(str)}
-    # end
-
-    # def collect_export_payload
-    #   url = export_request&.response_header('content-location')&.value
-    #   attempts = 0
-    #   return nil if url.nil?
-    #   while attempts < 5
-    #     request_attempt = Faraday.new(
-    #       url: url,
-    #       headers: {'Content-Type' => 'application/json',
-    #                 'Authorization' => 'Bearer SAMPLE_TOKEN',
-    #                 'Prefer' => 'respond-async',
-    #                 'Accept' => 'application/fhir+json'}
-    #       ).get
-    #     if request_attempt.status != 200
-    #       attempts += 1
-    #       sleep(2)
-    #     else
-    #       return request_attempt.env.response_body
-    #     end
-    #   end
-    #   return nil
-    # end
+    def connect_bundle(export_binary)
+      export_binary.split(/(?<=}\n)(?={)/).map { |str| FHIR.from_contents(str)}
+    end
 
-    # def export_resources
-    #   @export_resources ||= collect_export_resources 
-    # end
+    def export_resources
+      @export_resources ||= (load_tagged_requests(BINARY_TAG).map { |binary_read| binary_read.response_body.split("\n") }.flatten).map { |resource_in_binary| FHIR.from_contents(resource_in_binary)}
+    end
 
     def previous_clinical_data_requests
       @previous_clinical_data_requests ||= load_tagged_requests(SUBMIT_TAG) + [everything_request].compact
@@ -75,9 +34,13 @@ module DaVinciPDexTestKit
       @member_match_request ||= load_tagged_requests(MEMBER_MATCH_TAG).first
     end
 
-    # def export_request
-    #   @export_request ||= load_tagged_requests(EXPORT_TAG).first
-    # end
+    def export_request
+      @export_request ||= load_tagged_requests(EXPORT_TAG).first
+    end
+
+    def export_status_request
+      @export_status_request ||= load_tagged_requests(EXPORT_STATUS_TAG).first
+    end
 
     # def patient_id_from_match_request
     #   @patient_id_from_match_request ||= member_match_request ? "999" : nil #TODO: Change from static response

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/initial_scratch_storing.rb

@@ -17,15 +17,13 @@ module DaVinciPDexTestKit
           scratch[resource.resourceType.to_sym] |= [resource]
         end
       end
-      # if export_resources
-      #   info "Attempted an $export request"
-      #   export_resources.each do |resource|
-      #     scratch[resource.resourceType.to_sym] ||= []
-      #     scratch[resource.resourceType.to_sym] |= [resource]
-      #   end
-      # elsif export_request
-      #   info "Found an $export request, but no resources found.  It may not have had enough time to build"
-      # end
+      if !export_resources.empty?
+        info "Attempted an $export request"
+        export_resources.each do |resource|
+          scratch[resource.resourceType.to_sym] ||= []
+          scratch[resource.resourceType.to_sym] |= [resource]
+        end
+      end
       if everything_request
         info "Attempted an $everything request"
       end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/initial_wait_test.rb

@@ -19,6 +19,8 @@ module DaVinciPDexTestKit
           Submit PDex requests via at least one of the following methods:
           * Single Resource API: `#{submit_url}`, with `:endpoint` replaced with the endpoint you want to reach
           * $everything method: `#{everything_url}`, with `:patient` replaced with the patient you are matching
+          * $export method: `#{export_url}`, see workflow process at the [Bulk Data IG](https://hl7.org/fhir/uv/bulkdata/STU2/)
+          * $export-poll-status: `#{export_status_url}`, then continue to make reads from the binaries if a payload is delivered
           
           and [click here](#{resume_clinical_data_url}?token=#{access_token}) when done.
         )

data/lib/davinci_pdex_test_kit/pdex_payer_client_suite.rb

@@ -88,21 +88,31 @@ module DaVinciPDexTestKit
                             resumes: method(:test_resumes?) do |request|
         PDexPayerClientSuite.extract_bearer_token(request)
       end
-  
+
       record_response_route :get, SUBMIT_PATH, SUBMIT_TAG, method(:claim_response),
                             resumes: method(:test_resumes?) do |request|
         PDexPayerClientSuite.extract_bearer_token(request)
       end
 
+      record_response_route :get, BINARY_PATH, BINARY_TAG, method(:binary_read_response),
+                            resumes: method(:test_resumes?) do |request|
+        PDexPayerClientSuite.extract_bearer_token(request)
+      end
+
       record_response_route :get, EVERYTHING_PATH, EVERYTHING_TAG, method(:everything_response),
                             resumes: method(:test_resumes?) do |request|
         PDexPayerClientSuite.extract_bearer_token(request)
       end
 
-      # record_response_route :get, EXPORT_PATH, EXPORT_TAG, method(:export_response),
-      #                       resumes: method(:test_resumes?) do |request|
-      #   PDexPayerClientSuite.extract_bearer_token(request)
-      # end
+      record_response_route :get, EXPORT_PATH, EXPORT_TAG, method(:export_response),
+                            resumes: method(:test_resumes?) do |request|
+        PDexPayerClientSuite.extract_bearer_token(request)
+      end
+
+      record_response_route :get, EXPORT_STATUS_PATH, EXPORT_STATUS_TAG, method(:export_status_response),
+                            resumes: method(:test_resumes?) do |request|
+        PDexPayerClientSuite.extract_bearer_token(request)
+      end
 
       record_response_route :post, MEMBER_MATCH_PATH, MEMBER_MATCH_TAG, method(:member_match_response),
                             resumes: method(:test_resumes?) do |request|

data/lib/davinci_pdex_test_kit/pdex_payer_server/{coverage_to_link_has_minimal_data_test.rb → coverage_to_link_minimal_data_validation.rb}

@@ -1,9 +1,34 @@
 
 module DaVinciPDexTestKit
   module PDexPayerServer
-    class CoverageToLinkHasMinimalDataTest < Inferno::Test
 
-      id :coverage_to_link_has_minimal_data
+    # Factorized test for Member Match Request CoverageToLink parameter validation on PDex v2.0.0 and HRex v1.0.0.
+    #
+    # See https://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html#notes.
+    #
+    # ==== Inputs
+    #
+    # +member_match_request+ - Parameters FHIR resource JSON text with CoverageToLink parameter
+    #
+    # ==== Outputs
+    #
+    # (none)
+    #
+    # ==== Required Config
+    #
+    # (none)
+    #
+    # ==== Required Scratch
+    #
+    # (none)
+    #
+    # ==== Notes
+    #
+    # Skips if no CoverageToLink parameter provided.
+    #
+    class CoverageToLinkMinimalDataValidation < Inferno::Test
+
+      id :pdex_coverage_to_link_minimal_data_validation
       title '[USER INPUT VALIDATION] CoverageToLink parameter should not include any data elements not marked as mustSupport'
       optional
       description %{
@@ -45,7 +70,7 @@ module DaVinciPDexTestKit
         assert !coverage.network, 'CoverageToLink parameter has unecessary network field'
         assert coverage.costToBeneficiary.nil? || coverage.costToBeneficiary.empty?, 'CoverageToLink parameter has unnecessary costToBeneficiary field'
         assert coverage.subrogation.nil?, 'CoverageToLink parameter has unnecessary subrogation field'
-        assert !coverage.contract, 'CoverageToLink parameter has uncessary contract field'
+        assert coverage.contract.nil? || coverage.contract.empty?, 'CoverageToLink parameter has uncessary contract field'
       end
 
     end

data/lib/davinci_pdex_test_kit/pdex_payer_server/{coverage_to_link_must_support_test.rb → coverage_to_link_must_support_validation.rb}

@@ -1,9 +1,35 @@
 
 module DaVinciPDexTestKit
   module PDexPayerServer
-    class CoverageToLinkMustSupportTest < Inferno::Test
 
-      id :coverage_to_link_must_support
+    # Factorized test for Member Match Request CoverageToLink parameter validation on PDex v2.0.0 and HRex v1.0.0.
+    #
+    # See Documentation for CoverageToLink parameter at
+    # https://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html#membermatch
+    #
+    # ==== Inputs
+    #
+    # +member_match_request+ - Parameters FHIR resource JSON text with CoverageToLink parameter
+    #
+    # ==== Outputs
+    #
+    # (none)
+    #
+    # ==== Required Config
+    #
+    # (none)
+    #
+    # ==== Required Scratch
+    #
+    # (none)
+    #
+    # ==== Notes
+    #
+    # Fails if no CoverageToLink parameter provided.
+    #
+    class CoverageToLinkMustSupportValidation < Inferno::Test
+
+      id :pdex_coverage_to_link_must_support_validation
       title '[USER INPUT VALIDATION] CoverageToLink parameter is optional for generic FHIR clients, but required for Payer systems.'
       description 'See [CoverageToLink parameter documentation](https://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html).'
       optional

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit_group.rb

@@ -17,7 +17,8 @@ module DaVinciPDexTestKit
   module PDexPayerServer
 
     # PDex PriorAuthorization Profile for ExplanationOfBenefit Resource Test Group
-    class ExplanationOfBenefitTestGroup < Inferno::TestGroup
+    class ExplanationOfBenefitGroup < Inferno::TestGroup
+      id :pdex_explanation_of_benefit_group
       title 'PDex Prior Authorization Tests'
       short_description 'Verify support for the server capabilities required by the PDex Prior Authorization Profile.'
       description %(
@@ -81,7 +82,6 @@ The test will attempt to read each reference found and will fail if no
 read succeeds.
       )
 
-      id :pdex_explanation_of_benefit
       run_as_group
 
       def self.metadata

data/lib/davinci_pdex_test_kit/pdex_payer_server/export_patient_group.rb

@@ -2,12 +2,14 @@
 
 require 'tls_test_kit'
 
-require 'bulk_data_test_kit/v1.0.1/bulk_data_export_operation_support_test'
+# require 'bulk_data_test_kit/v1.0.1/bulk_data_export_operation_support_test'
 require 'bulk_data_test_kit/v1.0.1/bulk_data_no_auth_test'
 require 'bulk_data_test_kit/v1.0.1/bulk_data_export_kick_off_test'
 require 'bulk_data_test_kit/v1.0.1/bulk_data_status_check_test'
 require 'bulk_data_test_kit/v1.0.1/bulk_data_output_check_test'
 
+require_relative 'patient_operation_in_capability_statement_validation'
+
 module DaVinciPDexTestKit
   module PDexPayerServer
     class ExportPatientGroup < Inferno::TestGroup
@@ -37,38 +39,11 @@ module DaVinciPDexTestKit
 
       output :patient_requires_access_token, :patient_status_output, :patient_bulk_download_url
 
-      test from: :bulk_data_export_operation_support do
-        title 'Bulk Data Server declares support for Patient export operation in CapabilityStatement'
-        description <<~DESCRIPTION
-          This test verifies that the Bulk Data Server declares support for
-          `Patient/$export` operation in its server CapabilityStatement.
-
-          Given flexibility in the FHIR specification for declaring constrained
-          OperationDefinitions, this test only verifies that the server declares
-          any operation on the Patient resource.  It does not verify that it
-          declares the standard Patient export OperationDefinition provided in the
-          Bulk Data specification, nor does it attempt to resolve any non-standard
-          OperationDefinitions to verify if it is a constrained version of the
-          standard OperationDefintion.
-
-          This test will provide a warning if no operations are declared at
-          `Patient/$export`, via the
-          `CapabilityStatement.rest.resource.operation.name` element.  It will
-          also provide an informational message if an operation on the Patient
-          resource exists, but does not point to the standard OperationDefinition
-          canonical URL:
-          http://hl7.org/fhir/uv/bulkdata/OperationDefinition/patient-export
-
-          Additionally, this test provides a warning if the bulk data server does
-          not include the following URL in its `CapabilityStatement.instantiates`
-          element: http://hl7.org/fhir/uv/bulkdata/CapabilityStatement/bulk-data
-        DESCRIPTION
-        id :bulk_data_patient_export_operation_support
-
-        config(
-          options: { resource_type: 'Patient', require_absolute_urls_in_output: true }
-        )
-      end
+      test from: :patient_operation_in_capability_statement_validation,
+           title: 'Bulk Data Server declares support for Patient export operation in CapabilityStatement',
+           config: {
+             options: { operation_name: 'export', operation_url: 'http://hl7.org/fhir/uv/bulkdata/OperationDefinition/patient-export' }
+           }
 
       test from: :bulk_data_kick_off,
            id: :pdex_export_patient_kick_off,

data/lib/davinci_pdex_test_kit/pdex_payer_server/{abstract_member_match_request_local_references_test.rb → member_match_request_local_references_validation.rb}

@@ -1,18 +1,44 @@
 module DaVinciPDexTestKit
   module PDexPayerServer
 
-    # Exists to factorize input validation
-    class AbstractMemberMatchRequestLocalReferencesTest < Inferno::Test
-      id :abstract_member_match_request_local_references
+    # Factorized test for Member Match Request Profile local references on PDex v2.0.0 and HRex v1.0.0.
+    #
+    # See http://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html#resolving-parameter-references
+    #
+    # ==== Inputs
+    #
+    # +member_match_request+ - *Optional:* FHIR Parameters resource JSON text
+    #
+    # ==== Outputs
+    #
+    # (none)
+    #
+    # ==== Required Config
+    #
+    # (none)
+    #
+    # ==== Required Scratch
+    #
+    # (none)
+    #
+    # ==== Notes
+    #
+    # Skips if no input provided. This test does not validate all requirements of a Member Match Request
+    # resource. 
+    #
+    class MemberMatchRequestLocalReferencesValidation < Inferno::Test
+      id :pdex_member_match_request_local_references_validation
+
       title '[USER INPUT VALIDATION] Member match request only uses local references'
+
       description %{
         This test confirms that all Patient references inside the Consent and CoverageToMatch parameters are local references to the MemberPatient
         parameter. See
-        [resolving parameter references](http://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html#resolving-parameter-references)
+        [resolving parameter references](https://hl7.org/fhir/us/davinci-hrex/STU1/OperationDefinition-member-match.html#resolving-parameter-references)
         from the HRex 1.0.0. Implementation Guide.
       }
 
-      input :member_match_request # [String]
+      input :member_match_request
 
       # @param member_match_request_parameters [FHIR::Parameters]
       def assert_local_patient_references(member_match_request_parameters)

data/lib/davinci_pdex_test_kit/pdex_payer_server/{abstract_member_match_request_conformance_test.rb → member_match_request_profile_validation.rb}

@@ -1,9 +1,36 @@
+# frozen_string_literal: true
+
 module DaVinciPDexTestKit
   module PDexPayerServer
 
-    # Exists to factorize input validation
-    class AbstractMemberMatchRequestConformanceTest < Inferno::Test      
-      id :abstract_member_match_request_conformance
+    # Factorized test for Member Match Request Profile validation on PDex v2.0.0 and HRex v1.0.0.
+    #
+    # http://hl7.org/fhir/us/davinci-hrex/STU1/StructureDefinition-hrex-parameters-member-match-in.html
+    #
+    # ==== Inputs
+    #
+    # +member_match_request+ - *Optional:* JSON text to validate against profile
+    #
+    # ==== Outputs
+    #
+    # (none)
+    #
+    # ==== Required Config
+    #
+    # (none)
+    #
+    # ==== Required Scratch
+    #
+    # (none)
+    #
+    # ==== Notes
+    #
+    # Skips if no input provided. This test does not validate all requirements of a Member Match Request
+    # resource. 
+    #
+    class MemberMatchRequestProfileValidation < Inferno::Test
+      id :pdex_member_match_request_profile_validation
+
       input :member_match_request
 
       def assert_local_patient_references(member_match_request_parameters)

data/lib/davinci_pdex_test_kit/pdex_payer_server/multiple_member_matches_group.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
-require_relative 'abstract_member_match_request_conformance_test'
-require_relative 'abstract_member_match_request_local_references_test'
-require_relative 'coverage_to_link_has_minimal_data_test'
-require_relative 'coverage_to_link_must_support_test'
+require_relative 'member_match_request_profile_validation'
+require_relative 'member_match_request_local_references_validation'
+require_relative 'coverage_to_link_minimal_data_validation'
+require_relative 'coverage_to_link_must_support_validation'
 
 module DaVinciPDexTestKit
   module PDexPayerServer
     class MultipleMemberMatchesGroup < Inferno::TestGroup
 
-        id :multiple_member_matches_group
+        id :pdex_multiple_member_matches_group
         title '$member-match with multiple matches'
 
         run_as_group
@@ -21,8 +21,8 @@ module DaVinciPDexTestKit
 
         group_config = { inputs: { member_match_request: { name: :multiple_member_match_request } } }
   
-        test from: :abstract_member_match_request_conformance do
-          id :multiple_member_match_request_conformance
+        test from: :pdex_member_match_request_profile_validation do
+          id :multiple_member_match_request_profile_test
           config(group_config)
           title '[USER INPUT VALIDATION] Member match request for multiple matches is valid'
           description %{
@@ -35,13 +35,10 @@ module DaVinciPDexTestKit
           # Inherits
         end
 
-        test from: :abstract_member_match_request_local_references do
-          id :multiple_member_match_request_local_references
-          config(group_config)
-        end
+        test from: :pdex_member_match_request_local_references_validation, config: group_config
   
-        test from: :coverage_to_link_has_minimal_data, config: group_config
-        test from: :coverage_to_link_must_support, config: group_config
+        test from: :pdex_coverage_to_link_minimal_data_validation, config: group_config
+        test from: :pdex_coverage_to_link_must_support_validation, config: group_config
 
         test do
           id :member_match_has_multiple_matches

data/lib/davinci_pdex_test_kit/pdex_payer_server/no_member_matches_group.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
-require_relative 'abstract_member_match_request_conformance_test'
-require_relative 'abstract_member_match_request_local_references_test'
-require_relative 'coverage_to_link_has_minimal_data_test'
-require_relative 'coverage_to_link_must_support_test'
+require_relative 'member_match_request_profile_validation'
+require_relative 'member_match_request_local_references_validation'
+require_relative 'coverage_to_link_minimal_data_validation'
+require_relative 'coverage_to_link_must_support_validation'
 
 module DaVinciPDexTestKit
   module PDexPayerServer
     class NoMemberMatchesGroup < Inferno::TestGroup
-        id :no_member_matches_group
+        id :pdex_no_member_matches_group
         title '$member-match with no matches'
 
         run_as_group
@@ -20,8 +20,8 @@ module DaVinciPDexTestKit
 
         group_config = { inputs: { member_match_request: { name: :no_member_match_request } } }
 
-        test from: :abstract_member_match_request_conformance do
-          id :no_member_match_request_conformance
+        test from: :pdex_member_match_request_profile_validation do
+          id :no_member_match_request_profile_test
           config(group_config)
 
           title '[USER INPUT VALIDATION] Member match request for no matches is valid'
@@ -31,17 +31,12 @@ module DaVinciPDexTestKit
             ensuring subsequent tests can accurately simulate content. It also checks conformance to the [Parameters Resource](https://hl7.org/fhir/R4/parameters.html),
             mandatory elements, and terminology. It also checks that the Patient reference with the Consent and CoverageToMatch parameters are local references.
           }
-
-          # Inherits run
         end
 
-        test from: :abstract_member_match_request_local_references do
-          id :no_member_match_request_local_references
-          config(group_config)
-        end
+        test from: :pdex_member_match_request_local_references_validation, config: group_config
 
-        test from: :coverage_to_link_has_minimal_data, config: group_config
-        test from: :coverage_to_link_must_support, config: group_config
+        test from: :pdex_coverage_to_link_minimal_data_validation, config: group_config
+        test from: :pdex_coverage_to_link_must_support_validation, config: group_config
 
 
         test do

data/lib/davinci_pdex_test_kit/pdex_payer_server/patient_operation_in_capability_statement_validation.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    # Factorized test for asserting a patient resource opeartion in a Capability Statement
+    #
+    # ==== Inputs
+    #
+    # (none)
+    #
+    # ==== Outputs
+    #
+    # (none)
+    #
+    # ==== Required Config
+    #
+    # options:
+    #   operation_name: operation to check for, i.e: 'member-match'
+    #   operation_url: operation definition canonical URL
+    #
+    # ==== Required Scratch
+    #
+    # (none)
+    #
+    # ==== Notes
+    #
+    # Requires an Inferno fhir client configured.
+    #
+    class PatientOperationInCapabilityStatementValidation < Inferno::Test
+      id :patient_operation_in_capability_statement_validation
+
+      description %{
+        The [CapabilityStatement](https://hl7.org/fhir/R4/capabilitystatement.html) must declare support for the
+        patient resource-level operation in `CapabilityStatement.rest[].resource(type: Patient).operation` by
+        having both name (without `$`) and definition (canonical URL). See the operation definition for these
+        values.
+
+        The operation shall only be declared in one object in the `rest` array.
+      }
+
+      run do
+          fhir_get_capability_statement
+
+          assert_response_status(200)
+          assert_resource_type(:capability_statement)
+
+          assert(
+            resource.rest&.one? do |rest_metadata|
+              rest_metadata.resource&.find{|resource_metadata| resource_metadata.type == 'Patient'}
+                &.operation&.any? do |operation_metadata|
+                  operation_metadata.name == config.options[:operation_name] &&
+                  operation_metadata.definition == config.options[:operation_url]
+                end
+            end
+          )
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/{workflow_clinical_data.rb → workflow_clinical_data_group.rb}

@@ -2,8 +2,8 @@
 
 module DaVinciPDexTestKit
   module PDexPayerServer
-    class WorkflowClinicalData < Inferno::TestGroup
-      id :workflow_clinical_data
+    class WorkflowClinicalDataGroup < Inferno::TestGroup
+      id :pdex_workflow_clinical_data_group
       title 'Server can respond to search requests for clinical data on the matched patient'
       short_title 'Clinical data query'
       description %{
@@ -26,7 +26,7 @@ module DaVinciPDexTestKit
         optional: true
 
       test do
-        id :workflow_clinical_encounter_query
+        id :workflow_clinical_encounter_query_test
         title 'Server can provide clinical Encounter data from matched member identifier'
         description %{
           Server receives request `GET [baseURL]/Encounter?subject=Patient/[id]` and returns 200.
@@ -44,7 +44,7 @@ module DaVinciPDexTestKit
       end
 
       test do
-        id :workflow_clinical_encounter_validation
+        id :workflow_clinical_encounter_test
         title 'Server returned Search bundle with valid Encounter data'
         description %{
             Server returned search Bundle of Encounters with least 1 resource entry.

data/lib/davinci_pdex_test_kit/pdex_payer_server/{workflow_everything.rb → workflow_everything_group.rb}

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require_relative 'patient_operation_in_capability_statement_validation'
+
 module DaVinciPDexTestKit
   module PDexPayerServer
-    class WorkflowEverythingTestGroup < Inferno::TestGroup
+    class WorkflowEverythingGroup < Inferno::TestGroup
       title 'Server can respond to $everything requests on matched patient'
       short_title '$everything'
-      id :workflow_everything
+      id :pdex_workflow_everything_group
       optional
       description %{
         # Background
@@ -25,30 +27,15 @@ module DaVinciPDexTestKit
         description: 'Manual Patient ID for testing Clinical Query and $everything $export without $member-match.',
         optional: true
 
-
-      test do
-        title 'Server asserts Patient instance operation $everything in Capability Statement'
-
-        run do
-          fhir_get_capability_statement
-
-          assert_response_status 200
-          assert(
-            resource.rest.one? do |rest_metadata|
-              rest_metadata.resource.select { |resource_metadata| resource_metadata.type == 'Patient' }.first
-                .operation.any? do |operation_metadata|
-                  operation_metadata.name == 'everything' && operation_metadata.definition == 'http://hl7.org/fhir/OperationDefinition/Patient-everything'
-                end
-            end
-          )
-        end
-      end
+      test from: :patient_operation_in_capability_statement_validation,
+           title: 'Server declares support for Patient everything operation in CapabilityStatement',
+           config: {
+             options: { operation_name: 'everything', operation_url: 'http://hl7.org/fhir/OperationDefinition/Patient-everything' }
+           }
 
       test do
         title 'Server can handle GET /Patient/[ID]/$everything'
 
-        # input :patient_id # borrows properties from workflow_clinical_data
-
         makes_request :pdex_patient_everything
 
         run do
@@ -69,9 +56,9 @@ module DaVinciPDexTestKit
         uses_request :pdex_patient_everything
 
         run do
-          skip_if response[:status] != 200, 'Skipped because previous test did not pass'
           skip_if !patient_id
             'No Patient ID was derived from $member-match nor supplied from user input'
+          skip_if response[:status] != 200, 'Skipped because previous test did not pass'
 
           assert_valid_resource
           assert_resource_type(:bundle)
@@ -84,7 +71,6 @@ module DaVinciPDexTestKit
         end
       end
 
-
       # TODO: convert to attestation    
       # test do
       #   title %{

data/lib/davinci_pdex_test_kit/pdex_payer_server/{workflow_export.rb → workflow_export_group.rb}

@@ -7,8 +7,8 @@ require_relative 'export_validation_group'
 
 module DaVinciTestKit
   module PDexPayerServer
-    class WorkflowExportTestGroup < Inferno::TestGroup
-      id :workflow_export
+    class WorkflowExportGroup < Inferno::TestGroup
+      id :pdex_workflow_export_group
       title 'Server can respond to FHIR Bulk $export requests on the matched patient'
       short_title 'Bulk $export'
       optional

data/lib/davinci_pdex_test_kit/pdex_payer_server/{workflow_member_match.rb → workflow_member_match_group.rb}

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
-require_relative 'abstract_member_match_request_conformance_test'
-require_relative 'abstract_member_match_request_local_references_test'
-require_relative 'coverage_to_link_has_minimal_data_test'
-require_relative 'coverage_to_link_must_support_test'
+require_relative 'member_match_request_profile_validation'
+require_relative 'member_match_request_local_references_validation'
+require_relative 'coverage_to_link_minimal_data_validation'
+require_relative 'coverage_to_link_must_support_validation'
+
+require_relative 'patient_operation_in_capability_statement_validation'
 
 module DaVinciPDexTestKit
   module PDexPayerServer
-    class WorkflowMemberMatch < Inferno::TestGroup
+    class WorkflowMemberMatchGroup < Inferno::TestGroup
       title 'Server can return a matching member in response to $member-match request'
       short_title '$member-match'
-      id :workflow_member_match
+      id :pdex_workflow_member_match_group
       description %{
         # Background
 
@@ -36,35 +38,20 @@ module DaVinciPDexTestKit
 
       run_as_group
 
-      # TODO factorize cap statement tests
-      test do
-        id :member_match_in_capability_statement
-        title 'Server asserts Patient $member_match operation in capability statement.'
-
-        run do
-          fhir_get_capability_statement
-
-          assert_response_status(200)
-          assert_resource_type(:capability_statement)
-
-          assert(
-            resource.rest.one? do |rest_metadata|
-              rest_metadata.resource.select { |resource_metadata| resource_metadata.type == 'Patient' }.first
-                .operation.any? do |operation_metadata|
-                  operation_metadata.name == 'member-match' && operation_metadata.definition == 'http://hl7.org/fhir/us/davinci-hrex/OperationDefinition/member-match'
-                end
-            end
-          )
-        end
-      end
-
       input :member_match_request,
         title: 'Member Match Request for one match',
         description: "A JSON payload for server's $member-match endpoint that has **exactly one match**",
         type: 'textarea'
 
-      test from: :abstract_member_match_request_conformance do
-        id :member_match_request_request_conformance
+      test from: :patient_operation_in_capability_statement_validation,
+           id: :member_match_operation_in_capability_statement_test,
+           title: 'Server declares support for Patient member match operation in CapabilityStatement',
+           config: {
+             options: { operation_name: 'member-match', operation_url: 'http://hl7.org/fhir/us/davinci-hrex/OperationDefinition/member-match' }
+           }
+
+      test from: :pdex_member_match_request_profile_validation do
+        id :member_match_request_profile_test
         title '[USER INPUT VALIDATION] Member match request for exactly one match is valid'
         description %{
           This test validates the conformity of the user input to the
@@ -74,16 +61,16 @@ module DaVinciPDexTestKit
         }
       end
 
-      test from: :abstract_member_match_request_local_references do
-        id :member_match_request_local_references
+      test from: :pdex_member_match_request_local_references_validation do
+        id :member_match_request_local_references_test
         title '[USER INPUT VALIDATION] Member match request only uses local references'
       end
 
-      test from: :coverage_to_link_must_support
-      test from: :coverage_to_link_has_minimal_data
+      test from: :pdex_coverage_to_link_minimal_data_validation
+      test from: :pdex_coverage_to_link_must_support_validation
    
       test do
-        id :member_match_on_server
+        id :member_match_on_server_test
         title 'Server handles $member-match operation successfully'
         description 'Server receives request `POST [baseURL]/Patient/$member-match` and returns 200'
            
@@ -98,7 +85,7 @@ module DaVinciPDexTestKit
       end
   
       test do
-        id :member_match_response_conformance
+        id :member_match_response_profile_test
         title 'Server $member-match response conforms to profile'
         description %{
           The response body from the previous POST request to $member-match must be valid FHIR JSON conforming to

data/lib/davinci_pdex_test_kit/pdex_payer_server_suite.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require_relative 'pdex_payer_server/workflow_member_match'
-require_relative 'pdex_payer_server/workflow_clinical_data'
-require_relative 'pdex_payer_server/workflow_everything'
-require_relative 'pdex_payer_server/workflow_export'
+require_relative 'pdex_payer_server/workflow_member_match_group'
+require_relative 'pdex_payer_server/workflow_clinical_data_group'
+require_relative 'pdex_payer_server/workflow_everything_group'
+require_relative 'pdex_payer_server/workflow_export_group'
 
 require_relative 'pdex_payer_server/no_member_matches_group'
 require_relative 'pdex_payer_server/multiple_member_matches_group'
@@ -125,10 +125,10 @@ module DaVinciPDexTestKit
           See the corresponding test group's description for the testing methodology of each part.
         )
 
-        group from: :workflow_member_match
-        group from: :workflow_clinical_data
-        group from: :workflow_everything
-        group from: :workflow_export
+        group from: :pdex_workflow_member_match_group
+        group from: :pdex_workflow_clinical_data_group
+        group from: :pdex_workflow_everything_group
+        group from: :pdex_workflow_export_group
       end
 
       group do
@@ -157,15 +157,16 @@ module DaVinciPDexTestKit
 
           input_order :url, :credentials, :no_member_match_request, :multiple_member_match_request
 
-          group from: :no_member_matches_group
-          group from: :multiple_member_matches_group
+          group from: :pdex_no_member_matches_group
+          group from: :pdex_multiple_member_matches_group
         end
 
         group do
           title 'PDEX Search and Read API (US Core plus additional PDex resource types)' 
           id :search_and_read_api_coverage
           
-          group from: :pdex_explanation_of_benefit
+          group from: :pdex_explanation_of_benefit_group
+
           # Import all US Core v3.1.1 groups without the Suite
           Dir.glob(File.join($LOAD_PATH.find { |x| x.match? "us_core_test_kit" }, 'us_core_test_kit/generated/v3.1.1/*_group.rb')).each do |test_group_path|
             require_relative test_group_path

data/lib/davinci_pdex_test_kit/tags.rb

@@ -3,7 +3,9 @@
 module DaVinciPDexTestKit
   AUTH_TAG = 'pdex_auth'
   SUBMIT_TAG = 'pdex_submit'
-  # EXPORT_TAG = 'pdex_export'
+  BINARY_TAG = 'pdex_binary'
+  EXPORT_TAG = 'pdex_export'
+  EXPORT_STATUS_TAG = 'pdex_export_status'
   EVERYTHING_TAG = 'pdex_everything'
   MEMBER_MATCH_TAG = 'pdex_member_match'
 end

data/lib/davinci_pdex_test_kit/urls.rb

@@ -2,10 +2,12 @@ module DaVinciPDexTestKit
   TOKEN_PATH = '/mock_auth/token'
   PATIENT_PATH = '/fhir/Patient'
   SUBMIT_PATH = '/fhir/:endpoint'
+  BINARY_PATH = '/fhir/Binary/:id'
   METADATA_PATH = '/fhir/metadata'
   EVERYTHING_PATH = '/fhir/Patient/:patient/$everything'
   MEMBER_MATCH_PATH = '/fhir/Patient/$member-match'
-  # EXPORT_PATH = '/fhir/Patient/$export'
+  EXPORT_PATH = '/fhir/Patient/$export'
+  EXPORT_STATUS_PATH = '/fhir/$export-poll-status'
   BASE_FHIR_PATH = '/fhir'
   RESUME_PASS_PATH = '/resume_pass'
   RESUME_CLINICAL_DATA_PATH = '/resume_clinical_data'
@@ -32,6 +34,10 @@ module DaVinciPDexTestKit
       @submit_url ||= base_url + SUBMIT_PATH
     end
 
+    def binary_url
+      @binary_url ||= base_url + BINARY_PATH
+    end
+
     def metadata_url
       @metadata_url ||= base_url + METADATA_PATH
     end
@@ -44,9 +50,13 @@ module DaVinciPDexTestKit
       @member_match_url ||= base_url + MEMBER_MATCH_PATH
     end
 
-    # def export_url
-    #   @export_url ||= base_url + EXPORT_PATH
-    # end
+    def export_url
+      @export_url ||= base_url + EXPORT_PATH
+    end
+
+    def export_status_url
+      @export_status_url ||= base_url + EXPORT_STATUS_PATH
+    end
 
     def resume_pass_url
       @resume_pass_url ||= base_url + RESUME_PASS_PATH

data/lib/davinci_pdex_test_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DaVinciPDexTestKit
-  VERSION = '0.10.0'
+  VERSION = '0.10.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: davinci_pdex_test_kit
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.10.2
 platform: ruby
 authors:
 - Karl Naden
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-11 00:00:00.000000000 Z
+date: 2024-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inferno_core
@@ -110,6 +110,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.11'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
 description: Test Kit for the Da Vinci Payer Data Exchange (PDex) FHIR Implementation
   Guide
 email:
@@ -161,10 +175,8 @@ files:
 - lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/procedure_clinical_data_request_test.rb
 - lib/davinci_pdex_test_kit/pdex_payer_client/collection.rb
 - lib/davinci_pdex_test_kit/pdex_payer_client_suite.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/abstract_member_match_request_conformance_test.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/abstract_member_match_request_local_references_test.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/coverage_to_link_has_minimal_data_test.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/coverage_to_link_must_support_test.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/coverage_to_link_minimal_data_validation.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/coverage_to_link_must_support_validation.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_id_search_test.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_identifier_search_test.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_must_support_test.rb
@@ -180,12 +192,15 @@ files:
 - lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit_group.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/export_patient_group.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/export_validation_group.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/member_match_request_local_references_validation.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/member_match_request_profile_validation.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/multiple_member_matches_group.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server/no_member_matches_group.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_clinical_data.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_everything.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_export.rb
-- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_member_match.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/patient_operation_in_capability_statement_validation.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_clinical_data_group.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_everything_group.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_export_group.rb
+- lib/davinci_pdex_test_kit/pdex_payer_server/workflow_member_match_group.rb
 - lib/davinci_pdex_test_kit/pdex_payer_server_suite.rb
 - lib/davinci_pdex_test_kit/pdex_provider_client_suite.rb
 - lib/davinci_pdex_test_kit/tags.rb