davinci_dtr_test_kit 0.13.0 → 0.14.0

data/lib/davinci_dtr_test_kit/profiles/service_request/service_request_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class ServiceRequestReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct ServiceRequest resource from ServiceRequest read interaction'
+    description 'A server SHOULD support the ServiceRequest read interaction.'
+
+    id :service_request_read
+    output :service_request_resources
+
+    def resource_type
+      'ServiceRequest'
+    end
+
+    def service_request_id_list
+      return [nil] unless respond_to? :service_request_ids
+
+      service_request_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(service_request_id_list, resource_type)
+
+      output service_request_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/service_request/service_request_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class ServiceRequestValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'ServiceRequest resources returned during previous tests conform to the CRD ServiceRequest'
+    description %(
+This test verifies resources returned from the read step conform to
+the [CRD ServiceRequest](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest).
+Systems must demonstrate at least one valid example in order to pass this test.
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+    )
+
+    id :service_request_validation
+    input :service_request_resources,
+          optional: true
+
+    def resource_type
+      'ServiceRequest'
+    end
+
+    run do
+      skip_if(service_request_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(service_request_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-servicerequest|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/service_request_group.rb

@@ -0,0 +1,39 @@
+require_relative 'service_request/service_request_read'
+require_relative 'service_request/service_request_validation'
+
+module DaVinciDTRTestKit
+  class ServiceRequestGroup < Inferno::TestGroup
+    title 'CRD ServiceRequest Tests'
+    short_description 'Verify support for the server capabilities required by the CRD ServiceRequest Profile'
+    description %(
+      # Background
+
+    The CRD ServiceRequest sequence verifies that the system under test is
+    able to provide correct responses for ServiceRequest queries. These queries
+    must return resources conforming to the [CRD ServiceRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each ServiceRequest resource id provided in
+    the ServiceRequest IDs input. The server SHOULD be capable of returning a
+    ServiceRequest resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [CRD ServiceRequest Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-servicerequest.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    )
+    id :service_request_group
+    optional
+    run_as_group
+
+    input :service_request_ids,
+          title: 'Service Request IDs',
+          description: 'Comma separated list of ServiceRequest IDs',
+          optional: true
+
+    test from: :service_request_read
+    test from: :service_request_validation
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_create.rb

@@ -0,0 +1,26 @@
+require_relative '../../create_test'
+
+module DaVinciDTRTestKit
+  class TaskCreateTest < Inferno::Test
+    include DaVinciDTRTestKit::CreateTest
+
+    title 'Server is capable of creating a Task resource from Task create interaction'
+    description 'A server SHOULD support the Task create interaction'
+
+    id :task_create
+    input :create_task_resources,
+          type: 'textarea',
+          title: 'Create Task Resources',
+          description:
+          'Provide a list of Task resources to create. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'Task'
+    end
+
+    run do
+      perform_create_test(create_task_resources, resource_type)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class TaskReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct Task resource from Task read interaction'
+    description 'A server SHOULD support the Task read interaction.'
+
+    id :task_read
+    output :task_resources
+
+    def resource_type
+      'Task'
+    end
+
+    def task_id_list
+      return [nil] unless respond_to? :task_ids
+
+      task_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(task_id_list, resource_type)
+
+      output task_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_update.rb

@@ -0,0 +1,26 @@
+require_relative '../../update_test'
+
+module DaVinciDTRTestKit
+  class TaskUpdateTest < Inferno::Test
+    include DaVinciDTRTestKit::UpdateTest
+
+    title 'Server is capable of updating a Task resource from Task update interaction'
+    description 'A server SHOULD support the Task update interaction'
+
+    id :task_update
+    input :update_task_resources,
+          type: 'textarea',
+          title: 'Update Task Resources',
+          description:
+          'Provide a list of Task resources to update. e.g., [json_resource_1, json_resource_2]',
+          optional: true
+
+    def resource_type
+      'Task'
+    end
+
+    run do
+      perform_update_test(update_task_resources, resource_type)
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task/task_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class TaskValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'Task resources returned during previous tests conform to the PAS Task'
+    description %(
+This test verifies resources returned from the read step conform to
+the [PAS Task](http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-task).
+Systems must demonstrate at least one valid example in order to pass this test.
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+    )
+
+    id :task_validation
+    input :task_resources,
+          optional: true
+
+    def resource_type
+      'Task'
+    end
+
+    run do
+      skip_if(task_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(task_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-task|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/task_group.rb

@@ -0,0 +1,52 @@
+require_relative 'task/task_read'
+require_relative 'task/task_validation'
+require_relative 'task/task_create'
+require_relative 'task/task_update'
+
+module DaVinciDTRTestKit
+  class TaskGroup < Inferno::TestGroup
+    title 'PAS Task Tests'
+    short_description 'Verify support for the server capabilities required by the PAS Task Profile'
+    description %(
+      # Background
+
+    The PAS Task sequence verifies that the system under test is
+    able to provide correct responses for Task queries. These queries
+    must contain resources conforming to the [PAS Task Profile](http://hl7.org/fhir/us/davinci-pas/STU2/StructureDefinition-profile-task.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each Task resource id provided in
+    the Task IDs input. The server SHOULD be capable of returning a
+    Task resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [PAS Task Profile](http://hl7.org/fhir/us/davinci-pas/STU2/StructureDefinition-profile-task.html). Each
+    element is checked against terminology binding and cardinality requirements.
+
+    ## Create
+    This test sequence will perform create interactions with the provided json
+    Task resources. The server SHOULD be capable of creating a Task resource
+    using the create interaction.
+
+    ## Update
+    This test sequence will perform update interactions with the provided json
+    Task resources. The server SHOULD be capable of creating a Task resource
+    using the update interaction.
+          )
+    id :task_group
+    optional
+    run_as_group
+
+    input :task_ids,
+          title: 'Task IDs',
+          description: 'Comma separated list of Task IDs',
+          optional: true
+
+    test from: :task_read
+    test from: :task_validation
+    test from: :task_create
+    test from: :task_update
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/vision_prescription/vision_prescription_read.rb

@@ -0,0 +1,29 @@
+require_relative '../../read_test'
+
+module DaVinciDTRTestKit
+  class VisionPrescriptionReadTest < Inferno::Test
+    include DaVinciDTRTestKit::ReadTest
+
+    title 'Server returns correct VisionPrescription resource from VisionPrescription read interaction'
+    description 'A server SHOULD support the VisionPrescription read interaction.'
+
+    id :vision_prescription_read
+    output :vision_prescription_resources
+
+    def resource_type
+      'VisionPrescription'
+    end
+
+    def vision_prescription_id_list
+      return [nil] unless respond_to? :vision_prescription_ids
+
+      vision_prescription_ids&.split(',')&.map(&:strip)
+    end
+
+    run do
+      resources = perform_read_test(vision_prescription_id_list, resource_type)
+
+      output vision_prescription_resources: resources.to_json
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/vision_prescription/vision_prescription_validation.rb

@@ -0,0 +1,35 @@
+require_relative '../../validation_test'
+
+module DaVinciDTRTestKit
+  class VisionPrescriptionValidationTest < Inferno::Test
+    include DaVinciDTRTestKit::ValidationTest
+
+    title 'VisionPrescription resources returned during previous tests conform to the CRD VisionPrescription'
+    description %(
+This test verifies resources returned from the read step conform to
+the [CRD VisionPrescription](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-visionprescription).
+Systems must demonstrate at least one valid example in order to pass this test.
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+    )
+
+    id :vision_prescription_validation
+    input :vision_prescription_resources,
+          optional: true
+
+    def resource_type
+      'VisionPrescription'
+    end
+
+    run do
+      skip_if(vision_prescription_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      perform_profile_validation_test(vision_prescription_resources, resource_type,
+                                      'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/profile-visionprescription|2.0.1')
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/profiles/vision_prescription_group.rb

@@ -0,0 +1,39 @@
+require_relative 'vision_prescription/vision_prescription_read'
+require_relative 'vision_prescription/vision_prescription_validation'
+
+module DaVinciDTRTestKit
+  class VisionPrescriptionGroup < Inferno::TestGroup
+    title 'CRD VisionPrescription Tests'
+    short_description 'Verify support for the server capabilities required by the CRD VisionPrescription Profile'
+    description %(
+      # Background
+
+    The CRD VisionPrescription sequence verifies that the system under test is
+    able to provide correct responses for VisionPrescription queries. These queries
+    must return resources conforming to the [CRD VisionPrescription Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-visionprescription.html).
+
+    # Testing Methodology
+    ## Read
+    First, Inferno will attempt to read each VisionPrescription resource id provided in
+    the VisionPrescription IDs input. The server SHOULD be capable of returning a
+    VisionPrescription resource using the read interaction.
+
+    ## Profile Validation
+    Each resource returned from the read step SHALL conform to
+    the [CRD VisionPrescription Profile](https://hl7.org/fhir/us/davinci-crd/STU2/StructureDefinition-profile-visionprescription.html).
+    Each element is checked against terminology binding and cardinality requirements.
+
+    )
+    id :vision_prescription_group
+    optional
+    run_as_group
+
+    input :vision_prescription_ids,
+          title: 'Vision Prescription IDs',
+          description: 'Comma separated list of VisionPrescription IDs',
+          optional: true
+
+    test from: :vision_prescription_read
+    test from: :vision_prescription_validation
+  end
+end

data/lib/davinci_dtr_test_kit/read_test.rb

@@ -0,0 +1,22 @@
+module DaVinciDTRTestKit
+  module ReadTest
+    def perform_read_test(resource_ids, resource_type)
+      skip_if(resource_ids.nil?, "No `#{resource_type}` IDs provided, skipping test.")
+      resources = []
+      resource_ids.each do |id|
+        fhir_read resource_type, id
+
+        assert_response_status(200)
+        assert_resource_type(resource_type)
+        assert resource.id.present? && resource.id == id, bad_resource_id_message(id)
+
+        resources.push(resource)
+      end
+      resources
+    end
+
+    def bad_resource_id_message(expected_id)
+      "Expected resource to have id: `#{expected_id.inspect}`, but found `#{resource.id.inspect}`"
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/tags.rb

@@ -1,9 +1,7 @@
-# frozen_string_literal: true
-
 module DaVinciDTRTestKit
-  QUESTIONNAIRE_TAG = 'payer_server_questionnaire_package'
-  NEXT_TAG = 'payer_server_adaptive_questionnaire_package'
-  QUESTIONNAIRE_PACKAGE_TAG = 'dtr_questionnaire_package'
-  SMART_APP_EHR_REQUEST_TAG = 'dtr_smart_app_ehr_request'
-  EHR_AUTHORIZE_TAG = 'dtr_smart_app_ehr_authorize'
+  QUESTIONNAIRE_TAG = 'payer_server_questionnaire_package'.freeze
+  NEXT_TAG = 'payer_server_adaptive_questionnaire_package'.freeze
+  QUESTIONNAIRE_PACKAGE_TAG = 'dtr_questionnaire_package'.freeze
+  CLIENT_NEXT_TAG = 'dtr_questionnaire_next_question'.freeze
+  EHR_AUTHORIZE_TAG = 'dtr_smart_app_ehr_authorize'.freeze
 end

data/lib/davinci_dtr_test_kit/update_test.rb

@@ -0,0 +1,25 @@
+module DaVinciDTRTestKit
+  module UpdateTest
+    def perform_update_test(update_resources, resource_type)
+      skip_if(update_resources.blank?, "No `#{resource_type}` resources to update provided, skipping test.")
+      assert_valid_json(update_resources)
+      update_resources_list = JSON.parse(update_resources)
+      skip_if(!update_resources_list.is_a?(Array), 'Resources to update not inputted in list format, skipping test.')
+
+      valid_update_resources =
+        update_resources_list
+          .compact_blank
+          .map { |resource| FHIR.from_contents(resource.to_json) }
+          .select { |resource| resource.resourceType == resource_type }
+          .select { |resource| resource_is_valid?(resource:) }
+
+      skip_if(valid_update_resources.blank?,
+              %(No valid #{resource_type} resources were provided to send in Update requests, skipping test.))
+
+      valid_update_resources.each do |update_resource|
+        fhir_update(update_resource, update_resource.id)
+        assert_response_status([200, 201])
+      end
+    end
+  end
+end

data/lib/davinci_dtr_test_kit/validation_test.rb

@@ -25,6 +25,24 @@ module DaVinciDTRTestKit
       true
     end
 
+    def perform_profile_validation_test(
+      resources,
+      resource_type,
+      profile_url
+    )
+      skip_if(resources.nil?, "No `#{resource_type}` resources to validate, skipping test.")
+      resources = JSON.parse(resources)
+      resources = [resources] unless resources.is_a?(Array)
+      resources.each do |resource|
+        fhir_resource = FHIR.from_contents(resource.to_json)
+
+        assert fhir_resource.present?, 'Resource does not contain a recognized FHIR object'
+        assert_resource_type(resource_type, resource: fhir_resource)
+        assert_valid_resource(resource: fhir_resource,
+                              profile_url:)
+      end
+    end
+
     def perform_request_validation_test(
       resources,
       resource_type,
@@ -59,10 +77,7 @@ module DaVinciDTRTestKit
       omit_if resources.blank?,
               "No #{resource_type} resources provided so the #{profile_url} profile does not apply"
       resources.each_with_index do |resource, index|
-        assert_valid_json(resource.response[:body])
-        fhir_resource = FHIR.from_contents(resource.response[:body])
-        assert_response_status([200, 202], request: resource, response: resource.response)
-        validate_resource(fhir_resource, resource_type, profile_url, index)
+        validate_resource(resource, resource_type, profile_url, index)
       end
       return if tests_failed[profile_url].blank?
 

data/lib/davinci_dtr_test_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DaVinciDTRTestKit
-  VERSION = '0.13.0'
+  VERSION = '0.14.0'
 end