davinci_pas_test_kit 0.14.1 → 0.15.0

data/lib/davinci_pas_test_kit/server/generated/v2.2.1/subscriber/server_submit_request_must_support_subscriber_test.rb

@@ -0,0 +1,54 @@
+require_relative '../../../../cross_suite/must_support/must_support_test'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class ServerSubmitRequestMustSupportSubscriberTest < DaVinciPASTestKit::MustSupportTest
+      id :pas_server_v221_submit_request_must_support_subscriber
+      title 'All must support elements for profile PAS Subscriber Patient are observed on $submit requests'
+      description %(
+        
+        **USER INPUT VALIDATION**: This test validates input provided by the user instead of the system under test. Errors encountered will be treated as a skip instead of a failure.
+
+        PAS server systems are required to be able to receive all
+        must support elements on instances of all profiles included in 
+        requests, including instances of the PAS Subscriber Patient Profile.
+        This test checks all identified instances of the PAS Subscriber Patient
+        Profile on requests sent to the server to ensure that the following
+        must support elements are observed:
+
+        * Patient.address
+        * Patient.address.city
+        * Patient.address.country
+        * Patient.address.district
+        * Patient.address.line
+        * Patient.address.postalCode
+        * Patient.address.state
+        * Patient.birthDate
+        * Patient.communication.language
+        * Patient.gender
+        * Patient.identifier
+        * Patient.identifier.system
+        * Patient.identifier.value
+        * Patient.name
+        * Patient.name.family
+        * Patient.name.given
+        * Patient.name.prefix
+        * Patient.name.suffix
+        * Patient.telecom.system
+        * Patient.telecom.use
+        * Patient.telecom.value
+      )
+
+      config(
+        options: {
+          resource_type: 'Patient',
+          profile_key: 'subscriber',
+          user_input_validation: true,
+          ig_version: 'v2.2.1',
+          type: 'request',
+          operation: 'submit'
+        }
+      )
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/generated/v2.2.1/task/server_inquire_response_must_support_task_test.rb

@@ -0,0 +1,55 @@
+require_relative '../../../../cross_suite/must_support/must_support_test'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class ServerInquireResponseMustSupportTaskTest < DaVinciPASTestKit::MustSupportTest
+      id :pas_server_v221_inquire_response_must_support_task
+      title 'All must support elements for profile PAS Task are observed on $inquire responses'
+      description %(
+        
+        PAS server systems are required to be able to populate all
+        must support elements on instances of all profiles included in 
+        responses, including instances of the PAS Task Profile.
+        This test checks all identified instances of the PAS Task
+        Profile on responses returned by the server to ensure that the following
+        must support elements are observed:
+
+        * Task.code
+        * Task.for
+        * Task.identifier
+        * Task.input
+        * Task.input:AttachmentsNeeded
+        * Task.input:AttachmentsNeeded.extension:contentModifier
+        * Task.input:AttachmentsNeeded.extension:paLineNumber
+        * Task.input:AttachmentsNeeded.type
+        * Task.input:AttachmentsNeeded.value[x]
+        * Task.input:PayerURL
+        * Task.input:QuestionnaireContext
+        * Task.input:QuestionnaireContext.extension:paLineNumber
+        * Task.input:QuestionnaireContext.type
+        * Task.input:QuestionnaireContext.value[x]
+        * Task.intent
+        * Task.owner
+        * Task.owner.identifier
+        * Task.reasonCode.coding.code
+        * Task.reasonReference
+        * Task.requester
+        * Task.requester.identifier
+        * Task.restriction.period
+        * Task.status
+        * Task.statusReason
+      )
+
+      config(
+        options: {
+          resource_type: 'Task',
+          profile_key: 'task',
+          user_input_validation: false,
+          ig_version: 'v2.2.1',
+          type: 'response',
+          operation: 'inquire'
+        }
+      )
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/generated/v2.2.1/task/server_submit_response_must_support_task_test.rb

@@ -0,0 +1,55 @@
+require_relative '../../../../cross_suite/must_support/must_support_test'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class ServerSubmitResponseMustSupportTaskTest < DaVinciPASTestKit::MustSupportTest
+      id :pas_server_v221_submit_response_must_support_task
+      title 'All must support elements for profile PAS Task are observed on $submit responses'
+      description %(
+        
+        PAS server systems are required to be able to populate all
+        must support elements on instances of all profiles included in 
+        responses, including instances of the PAS Task Profile.
+        This test checks all identified instances of the PAS Task
+        Profile on responses returned by the server to ensure that the following
+        must support elements are observed:
+
+        * Task.code
+        * Task.for
+        * Task.identifier
+        * Task.input
+        * Task.input:AttachmentsNeeded
+        * Task.input:AttachmentsNeeded.extension:contentModifier
+        * Task.input:AttachmentsNeeded.extension:paLineNumber
+        * Task.input:AttachmentsNeeded.type
+        * Task.input:AttachmentsNeeded.value[x]
+        * Task.input:PayerURL
+        * Task.input:QuestionnaireContext
+        * Task.input:QuestionnaireContext.extension:paLineNumber
+        * Task.input:QuestionnaireContext.type
+        * Task.input:QuestionnaireContext.value[x]
+        * Task.intent
+        * Task.owner
+        * Task.owner.identifier
+        * Task.reasonCode.coding.code
+        * Task.reasonReference
+        * Task.requester
+        * Task.requester.identifier
+        * Task.restriction.period
+        * Task.status
+        * Task.statusReason
+      )
+
+      config(
+        options: {
+          resource_type: 'Task',
+          profile_key: 'task',
+          user_input_validation: false,
+          ig_version: 'v2.2.1',
+          type: 'response',
+          operation: 'submit'
+        }
+      )
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/pas_claim_response_decision_test.rb

@@ -0,0 +1,73 @@
+require_relative '../cross_suite/pas_constants'
+require_relative '../cross_suite/tags'
+
+module DaVinciPASTestKit
+  class PasClaimResponseDecisionTest < Inferno::Test
+    id :prior_auth_claim_response_decision_validation
+    title 'Server response includes the expected decision code in the ClaimResponse instance'
+    description %(
+      This test checks that the decision in the returned ClaimResponse matches
+      the decision code required for the workflow under examination.
+    )
+
+    def use_case
+      config.options[:use_case]
+    end
+
+    def operation
+      config.options[:operation]
+    end
+
+    def target_adjudication_code
+      @target_adjudication_code ||= PASConstants::X12_ADJUDICATION_CODES[use_case.to_sym]
+    end
+
+    def response_has_expected_adjudication_code?(response_bundle)
+      response_bundle.resourceType == 'Bundle' && response_bundle.entry.any? do |entry|
+        entry.resource&.resourceType == 'ClaimResponse' && entry.resource.item.any? do |item|
+          item.adjudication.any? do |adjudication|
+            adjudication.extension.any? do |adjudication_ext|
+              next unless adjudication_ext.url == 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-reviewAction'
+
+              adjudication_ext.extension.any? do |review_action_ext|
+                next unless review_action_ext.url == 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-reviewActionCode'
+
+                review_action_ext.valueCodeableConcept&.coding&.any? do |coding|
+                  coding.system == 'https://codesystem.x12.org/005010/306' &&
+                    coding.code == target_adjudication_code
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+
+    def load_response_bundles
+      requests = load_tagged_requests(DaVinciPASTestKit.use_case_tag(use_case),
+                                      DaVinciPASTestKit.operation_tag(operation))
+      resources = requests.map(&:response_body).uniq.map do |response_body|
+        FHIR.from_contents(response_body)
+      rescue StandardError
+        nil
+      end.compact
+
+      resources.select { |response| response.is_a?(FHIR::Bundle) } # rubocop:disable Style/SelectByKind
+    end
+
+    run do
+      bundles_to_check = load_response_bundles
+
+      skip_if bundles_to_check.blank?,
+              "No Bundles to check - No $#{operation} requests made during the #{use_case.titleize} " \
+              'workflow tests returned Bundles.'
+
+      codes_ok = bundles_to_check.all? do |response_bundle|
+        response_has_expected_adjudication_code?(response_bundle)
+      end
+
+      assert codes_ok,
+             "One or more response Bundles did not have the expected adjudication code #{target_adjudication_code}."
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/server_request_bundle_validation_test.rb

@@ -0,0 +1,64 @@
+require_relative '../cross_suite/pas_bundle_validation'
+
+module DaVinciPASTestKit
+  class ServerRequestBundleValidationTest < Inferno::Test
+    include DaVinciPASTestKit::PasBundleValidation
+
+    id :pas_server_request_bundle_validation_test
+    title 'PAS Request Bundle is conformant'
+
+    input :bundle_payload,
+          type: 'textarea',
+          optional: true
+
+    input_order :server_endpoint, :smart_credentials
+
+    def operation
+      config.options[:operation]
+    end
+
+    def ig_version
+      config.options[:ig_version]
+    end
+
+    def use_case
+      config.options[:use_case]
+    end
+
+    def bundles
+      parsed_payload = JSON.parse(bundle_payload)
+      fhir_resources =
+        [parsed_payload].flatten.compact.uniq.map do |payload|
+          FHIR.from_contents(payload.to_json)
+        rescue StandardError
+          nil
+        end.compact
+      fhir_resources.select { |res| res.resourceType == 'Bundle' }
+    end
+
+    run do
+      skip_if bundle_payload.blank?, 'No bundle request input provided.'
+      assert_valid_json(bundle_payload,
+                        "Provide valid json to use for the $#{operation} during the #{use_case.titleize} workflow.")
+      bundles_to_verify = bundles
+
+      assert bundles_to_verify.present?, 'Provided input is not a Bundle or list of Bundles.'
+
+      bundles_to_verify.each do |bundle|
+        perform_bundle_validation(
+          bundle,
+          operation,
+          'request',
+          ig_version
+        )
+      end
+
+      validation_error_messages.each do |msg|
+        messages << { type: 'error', message: msg }
+      end
+
+      skip_if validation_error_messages.present?,
+              'Bundle(s) provided are not conformant. Check messages for issues found.'
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/server_response_bundle_validation_test.rb

@@ -0,0 +1,76 @@
+require_relative '../cross_suite/pas_bundle_validation'
+require_relative '../cross_suite/tags'
+
+module DaVinciPASTestKit
+  class ServerResponseBundleValidationTest < Inferno::Test
+    include DaVinciPASTestKit::PasBundleValidation
+
+    id :pas_server_response_bundle_validation_test
+    title 'PAS Bundle is valid'
+
+    input_order :server_endpoint, :smart_credentials
+
+    def operation
+      config.options[:operation]
+    end
+
+    def ig_version
+      config.options[:ig_version]
+    end
+
+    def use_case
+      config.options[:use_case]
+    end
+
+    # Tests that tag a single submission with an explicit `request_tag` (e.g. Claim Updates)
+    # reload by that tag; standard workflow tests fall back to the use-case-derived tag.
+    def workflow_tag
+      config.options[:request_tag].presence || DaVinciPASTestKit.use_case_tag(use_case)
+    end
+
+    def response_bundles
+      requests = load_tagged_requests(DaVinciPASTestKit.operation_tag(operation),
+                                      workflow_tag)
+      bundles = []
+      requests.map(&:response_body).compact.uniq.each do |response_body|
+        resource = FHIR.from_contents(response_body)
+        next unless resource.present?
+
+        # Handle Parameters resource (v2.2.1 inquire responses)
+        if resource.resourceType == 'Parameters'
+          # Extract all Bundles from Parameters.parameter entries
+          parameter_bundles = extract_bundles_from_pas_inquiry_response_parameters(resource)
+          bundles.concat(parameter_bundles)
+        elsif resource.is_a?(FHIR::Bundle)
+          # Handle Bundle resource (v2.0.1 or v2.2.1 non-inquire)
+          bundles << resource
+        end
+      rescue StandardError
+        next
+      end
+
+      bundles
+    end
+
+    run do
+      bundles_to_verify = response_bundles
+      assert bundles_to_verify.present?,
+             "No successful $#{operation} requests made during the #{use_case.titleize} workflow tests."
+
+      bundles_to_verify.each do |bundle|
+        perform_bundle_validation(
+          bundle,
+          operation,
+          'response',
+          ig_version
+        )
+      end
+
+      validation_error_messages.each do |msg|
+        messages << { type: 'error', message: msg }
+      end
+      assert validation_error_messages.blank?,
+             'Bundle response(s) returned are not conformant. Check messages for issues found.'
+    end
+  end
+end

data/lib/davinci_pas_test_kit/{custom_groups → server}/v2.0.1/error_tests/pas_inquiry_error_test.rb

@@ -1,7 +1,7 @@
 module DaVinciPASTestKit
   module DaVinciPASV201
-    class PasInquiryErrorTest < Inferno::Test
-      id :prior_auth_inquiry_error
+    class PasServerInquiryErrorTest < Inferno::Test
+      id :pas_server_v201_prior_auth_inquiry_error
       title %(
         Server returns OperationOutcome instance when invoking the $inquire operation on the Claim endpoint
         (/Claim/$inquire) with nonconformant PAS Request Bundle

data/lib/davinci_pas_test_kit/{custom_groups → server}/v2.0.1/error_tests/pas_submission_error_test.rb

@@ -1,7 +1,7 @@
 module DaVinciPASTestKit
   module DaVinciPASV201
-    class PasSubmissionErrorTest < Inferno::Test
-      id :prior_auth_submission_error
+    class PasServerSubmissionErrorTest < Inferno::Test
+      id :pas_server_v201_prior_auth_submission_error
       title %(
         Server returns OperationOutcome instance when invoking the $submit operation on the Claim endpoint
         (/Claim/$submit) with nonconformant PAS Request Bundle

data/lib/davinci_pas_test_kit/{custom_groups/v2.0.1/must_support/pas_server_must_support_requirement_test.rb → server/v2.0.1/must_support/pas_server_must_support_request_profiles_test.rb}

@@ -1,14 +1,9 @@
-require_relative '../../../must_support_test'
-require_relative '../../../generator/group_metadata'
+require_relative '../../../cross_suite/must_support/must_support_request_type_test'
 
 module DaVinciPASTestKit
   module DaVinciPASV201
-    class PasServerMustSupportRequirementTest < Inferno::Test
-      include DaVinciPASTestKit::MustSupportTest
-
-      attr_accessor :resource_type
-
-      id :pas_server_submit_v201_must_support_requirement
+    class PasServerMustSupportRequestProfilesTest < DaVinciPASTestKit::MustSupportRequestTypeTest
+      id :pas_server_v201_must_support_request_profiles
       title %(
         At least one instance of a request profile (PAS Medication Request, PAS Service Request,
         PAS Device Request, or PAS Nutrition Order) is observed with all of its must support elements
@@ -77,43 +72,15 @@ module DaVinciPASTestKit
         * NutritionOrder.patient
       )
 
-      def resource_types
-        ['DeviceRequest', 'MedicationRequest', 'NutritionOrder', 'ServiceRequest']
-      end
-
-      def self.metadata
-        metadata_file_name = "#{@@resource_type.underscore}_metadata.yml"
-        Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, metadata_file_name),
-                                                    aliases: true))
-      end
-
-      def scratch_resources
-        scratch[:submit_request_resources] ||= {}
-      end
-
-      def all_scratch_resources
-        scratch_resources[:all] ||= []
-      end
-
-      def resources_of_interest
-        all_scratch_resources.select { |resource| resource_types.include?(resource.resourceType) }
-      end
-
-      def grouped_resources
-        resources_of_interest.group_by(&:resourceType)
-      end
-
-      run do
-        msg = 'Request Bundle must include at least one instance of either DeviceRequest, MedicationRequest,
-                NutritionOrder, or ServiceRequest resource'
-        assert resources_of_interest.present?, msg
-
-        grouped_resources.each do |type, resources|
-          @@resource_type = @resource_type = type # rubocop:disable Style/ClassVars
-          perform_must_support_test(resources)
-        end
-        validate_must_support(true)
-      end
+      config(
+        options: {
+          profile_keys: ['device_request', 'medication_request', 'nutrition_order', 'service_request'],
+          user_input_validation: true,
+          ig_version: 'v2.0.1',
+          type: 'request',
+          operation: 'submit'
+        }
+      )
     end
   end
 end

data/lib/davinci_pas_test_kit/{custom_groups → server}/v2.0.1/pas_error_group.rb

@@ -3,7 +3,7 @@ require_relative 'error_tests/pas_inquiry_error_test'
 
 module DaVinciPASTestKit
   module DaVinciPASV201
-    class PASErrorGroup < Inferno::TestGroup
+    class PASServerErrorGroup < Inferno::TestGroup
       title 'Demonstrate Error Handling'
       description %(
         Validates Prior Authorization transaction error handling for malformed
@@ -13,8 +13,8 @@ module DaVinciPASTestKit
       id :pas_v201_error_group
       run_as_group
 
-      test from: :prior_auth_submission_error
-      test from: :prior_auth_inquiry_error
+      test from: :pas_server_v201_prior_auth_submission_error
+      test from: :pas_server_v201_prior_auth_inquiry_error
     end
   end
 end

data/lib/davinci_pas_test_kit/{custom_groups → server}/v2.0.1/pas_server_subscription_input_conformance.rb

@@ -1,12 +1,12 @@
-require_relative '../../pas_subscription_verification'
+require_relative '../../cross_suite/pas_subscription_verification'
 
 module DaVinciPASTestKit
   module DaVinciPASV201
     class PASServerSubscriptionInputConformance < Inferno::Test
       include PASSubscriptionVerification
 
-      id :pas_server_subscription_input_conformance
-      title '[USER INPUT VERIFICATION] Verify Subscription PAS conformance'
+      id :pas_server_v201_subscription_input_conformance
+      title 'Verify Subscription PAS conformance'
       description %(
         This test accepts a Subscription resource as an input and verifies that it is conformant to PAS requirements on
         the Subscriptions, including:
@@ -16,6 +16,7 @@ module DaVinciPASTestKit
         - Inclusion of filter criteria for the client's organization.
       )
       input :subscription_resource
+      simulation_verification
 
       run do
         omit_if subscription_resource.blank?, 'Did not input a Subscription resource of this type.'

data/lib/davinci_pas_test_kit/server/v2.0.1/pas_server_subscription_notification_wait_test.rb

@@ -0,0 +1,12 @@
+require_relative '../abstract_pas_subscription_notification_wait_test'
+require_relative 'server_urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASSubscriptionNotificationWaitTest < AbstractPASSubscriptionNotificationWaitTest
+      include ServerURLs
+
+      id :pas_server_v201_subscription_notification_wait
+    end
+  end
+end

data/lib/davinci_pas_test_kit/{custom_groups → server}/v2.0.1/pas_server_subscription_setup.rb

@@ -4,7 +4,7 @@ require_relative 'pas_server_subscription_input_conformance'
 module DaVinciPASTestKit
   module DaVinciPASV201
     class PASServerSubscriptionSetup < Inferno::TestGroup
-      id :pas_server_subscription_setup
+      id :pas_server_v201_subscription_setup
       title 'Subscription Setup'
       description %(
           The Subscription Setup tests verify that the server supports creation of a rest-hook Subscription. The
@@ -16,7 +16,9 @@ module DaVinciPASTestKit
       verifies_requirements 'hl7.fhir.us.davinci-pas_2.0.1@141'
       run_as_group
 
-      test from: :subscriptions_r4_server_subscription_conformance do
+      test from: :subscriptions_r4_server_subscription_conformance,
+           title: 'Verify Subscription to Send to Server',
+           simulation_verification: true do
         input :subscription_resource,
               title: 'Pended Prior Authorization Subscription',
               description: %(
@@ -26,7 +28,7 @@ module DaVinciPASTestKit
                      modify the Subscription before submission, e.g., to point to Inferno's notification endpoint.
                    )
       end
-      test from: :pas_server_subscription_input_conformance
+      test from: :pas_server_v201_subscription_input_conformance
       test from: :subscriptions_r4_server_notification_delivery,
            title: 'Send Subscription and Receive Handshake Notification from Server',
            description: %(

data/lib/davinci_pas_test_kit/server/v2.0.1/server_urls.rb

@@ -0,0 +1,13 @@
+require_relative '../../cross_suite/base_urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    module ServerURLs
+      include BaseURLs
+
+      def suite_id
+        DaVinciPASTestKit::DaVinciPASV201::ServerSuite.id
+      end
+    end
+  end
+end