mirah-ruby 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d6112c2bab9f017614f4ff32fec8d1a79bd53d3099f68a86679563dc6aae644
-  data.tar.gz: 49592ec2080f7af06bdb559f4f9d10cb3ee0acbbc12f9184a4a53544ac3fa429
+  metadata.gz: 41451cd5cce251f00e1436c8a7aae2140fe8fbc0c34b8a559531684cbc415c10
+  data.tar.gz: 51b5c3d5095058f4da1b2e0ac5fd36f9fcfdf00ac43dba25b499a0254b87b05b
 SHA512:
-  metadata.gz: a913e4a74bea01d36cdd9b9a1045ba0af9872afd2caf75cbbaad6b251cc6d2f1466d134af9c1e97424dbbdb1a5f92bb9b7176a3d98a5fc9b41323cdb8a9c2119
-  data.tar.gz: 8d3743ef319ccdd90200993c78a201fa3003d07a28319c0666a5276a5cae0f4f2716dc4e691f985f4c8030edba1c87033f47fb639537501dfc5c17e53a0b4f3a
+  metadata.gz: 8a0f1ccd84d3b52be85a2639127815ee2614f1a629c72f88d2b0e2629989b69112343f49990f732bc346016b79ffbc19c0fc26e208e06a065f2e9fc72321dc05
+  data.tar.gz: a2e0cb5cfb08bb316255ab708c1167d555e29b67cd753ac97a5aca447a640c20f67c497d9a8aa92a1b124045c1957d9420d501ae43a524c425d635ab623baec0

data/lib/mirah/client.rb

@@ -104,7 +104,8 @@ module Mirah
     # @option input_values [String, nil] :primary_language see {Data::Patient#primary_language}
     # @option input_values [String, nil] :email see {Data::Patient#email}
     # @option input_values [String, nil] :phone_number see {Data::Patient#phone_number}
-    # @option input_values [String, nil] :external_managing_organization_id see {Data::Patient#external_managing_organization_id}
+    # @option input_values [String, nil] :external_managing_organization_id
+    #                                     see {Data::Patient#external_managing_organization_id}
     # @return [PushResult<Data::Patient>] the operation result with a patient on success
     def push_patient(external_id:, **input_values)
       mutate(Graphql::Mutations::CreateOrUpdatePatientMutation,
@@ -301,6 +302,123 @@ module Mirah
              Data::Appointment, 'createOrUpdateAppointment')
     end
 
+    #################################################################################################################
+    # DIAGNOSTIC CODE METHODS
+    #################################################################################################################
+
+    # Find an diagnostic code by the given Mirah internal UUID. This method should be used if you already know the Mirah
+    # identifier. If you wish to query by your own system identifier, you should use
+    # {#find_diagnostic_code_by_external_id}
+    #
+    # @since 0.4.0
+    # @param id [String] Mirah UUID for the diagnostic code
+    # @return [Data::DiagnosticCode, nil] the code, or nil if the record does not exist.
+    def find_diagnostic_code(id)
+      query_record(Graphql::Queries::DiagnosticCodeIdQuery, id, Data::DiagnosticCode, 'diagnosticCode')
+    end
+
+    # Find a diagnostic code by your external id. This is a convenience method. If you wish to query a list of
+    # codes by external id, please use {Client#query_diagnostic_codes}.
+    #
+    # @since 0.4.0
+    # @param external_id [String] The identifier of the system of record
+    # @return [Data::DiagnosticCode, nil] the code, or nil if the record does not exist.
+    def find_diagnostic_code_by_external_id(external_id)
+      query_record_by_external_id(Graphql::Queries::DiagnosticCodeExternalIdQuery,
+                                  external_id,
+                                  Data::DiagnosticCode,
+                                  'diagnosticCodeExternal')
+    end
+
+    # Query for diagnostic codes. You may specify a set of parameters as defined in
+    # {Mirah::Filters::DiagnosticCodeFilters}.
+    # Results are returned in a paginated format. See {Collection} for how to page results.
+    # @since 0.4.0
+    # @param external_id [Array<String>] See {Mirah::Filters::DiagnosticCodeFilters#external_id}
+    # @param search [Array<String>] See {Mirah::Filters::DiagnosticCodeFilters#search}
+    # @return [Collection<Data::Appointment>] a collection of pageable codes.
+    def query_diagnostic_codes(external_id: nil, search: nil)
+      query_connection(
+        Graphql::Queries::DiagnosticCodeQuery,
+        Filters::DiagnosticCodeFilters.new(external_id: external_id, search: search),
+        Filters::Paging.default,
+        Data::DiagnosticCode,
+        'diagnosticCodes'
+      )
+    end
+
+    # Create or update a diagnosis code. You must specify an external identifier, all other parameters are optional,
+    # but you may receive errors if you attempt to specify too few parameters for an appointment that does not exist.
+    #
+    # @since 0.1.0
+    # @param external_id [String] the external identifier for this code
+    # @option input_values [String, nil] :name see {Data::DiagnosticCode#name}
+    # @option input_values [String, nil] :code see {Data::DiagnosticCode#code}
+    # @return [PushResult<Data::DiagnosticCode>] the operation result with the code on success
+    def push_diagnostic_code(external_id:, **input_values)
+      mutate(Graphql::Mutations::CreateOrUpdateDiagnosticCodeMutation,
+             Inputs::DiagnosticCodeInput.new(input_values.merge(external_id: external_id)),
+             Data::DiagnosticCode, 'createOrUpdateDiagnosticCode')
+    end
+
+    #################################################################################################################
+    # PATIENT CONDITION METHODS
+    #################################################################################################################
+
+    # Find an condition by the given Mirah internal UUID. This method should be used if you already know the Mirah
+    # identifier. If you wish to query by your own system identifier, you should use
+    # {#find_patient_condition_by_external_id}
+    #
+    # @since 0.4.0
+    # @param id [String] Mirah UUID for the condition
+    # @return [Data::PatientCondition, nil] the code, or nil if the record does not exist.
+    def find_patient_condition(id)
+      query_record(Graphql::Queries::PatientConditionIdQuery, id, Data::PatientCondition, 'patientCondition')
+    end
+
+    # Find a condition by your external id. This is a convenience method. If you wish to query a list of
+    # codes by external id, please use {Client#query_patient_conditions}.
+    #
+    # @since 0.4.0
+    # @param external_id [String] The identifier of the system of record
+    # @return [Data::PatientCondition, nil] the code, or nil if the record does not exist.
+    def find_patient_condition_by_external_id(external_id)
+      query_record_by_external_id(Graphql::Queries::PatientConditionExternalIdQuery,
+                                  external_id,
+                                  Data::PatientCondition,
+                                  'patientConditionExternal')
+    end
+
+    # Query for conditions. You may specify a set of parameters as defined in
+    # {Mirah::Filters::PatientConditionFilters}.
+    # Results are returned in a paginated format. See {Collection} for how to page results.
+    # @since 0.4.0
+    # @param external_id [Array<String>] See {Mirah::Filters::PatientConditionFilters#external_id}
+    # @return [Collection<Data::Appointment>] a collection of pageable codes.
+    def query_patient_conditions(external_id: nil)
+      query_connection(
+        Graphql::Queries::PatientConditionQuery,
+        Filters::PatientConditionFilters.new(external_id: external_id),
+        Filters::Paging.default,
+        Data::PatientCondition,
+        'patientConditions'
+      )
+    end
+
+    # Create or update a condition. You must specify an external identifier, all other parameters are optional,
+    # but you may receive errors if you attempt to specify too few parameters for an appointment that does not exist.
+    #
+    # @since 0.1.0
+    # @param external_id [String] the external identifier for this code
+    # @option input_values [String, nil] :name see {Data::PatientCondition#name}
+    # @option input_values [String, nil] :code see {Data::PatientCondition#code}
+    # @return [PushResult<Data::PatientCondition>] the operation result with the code on success
+    def push_patient_condition(external_id:, **input_values)
+      mutate(Graphql::Mutations::CreateOrUpdatePatientConditionMutation,
+             Inputs::PatientConditionInput.new(input_values.merge(external_id: external_id)),
+             Data::PatientCondition, 'createOrUpdatePatientCondition')
+    end
+
     ##################################################################################################################
     # Internal methods
     ##################################################################################################################
@@ -411,7 +529,7 @@ module Mirah
         if response.errors[:data] == ['401 Unauthorized'] # rubocop:disable Style/GuardClause
           raise Errors::InvalidCredentials, 'The credentials you have supplied are invalid'
         else
-          raise Errors::ServerError, 'Unknown error from Mirah server: ' + response.errors.values.flatten.join(',')
+          raise Errors::ServerError, "Unknown error from Mirah server: #{response.errors.values.flatten.join(',')}"
         end
       end
 

data/lib/mirah/data/diagnostic_code.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Data
+    # Diagnostic codes represent ICD10 or other codes that contain information on diagnosis. The Mirah system models
+    # this simply as a code and a name, effectively operating like a tag.
+    # For example, Major Depressive Disorder could be represented with the code F320.
+    class DiagnosticCode < BaseObject
+      # @!attribute [r] id
+      #   @return [string] The internal Mirah identifier
+      attribute :id
+
+      # @!attribute [r] external_id
+      #   @return [string] The identifier provided by your system
+      attribute :external_id
+
+      # @!attribute [r] name
+      #   @return [string] A description of the code, e.g. "Major Depressive Disorder"
+      attribute :name
+
+      # @!attribute [r] code
+      #   @return [string] A string representing the code, e.g. "F320"
+      attribute :code
+    end
+  end
+end

data/lib/mirah/data/patient_condition.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Data
+    class PatientCondition < BaseObject
+      # @!attribute [r] id
+      #   @return [string] The internal Mirah identifier
+      attribute :id
+
+      # @!attribute [r] external_id
+      #   @return [string] The identifier provided by your system
+      attribute :external_id
+
+      # @!attribute [r] status
+      #   @return [string] The status of this condition
+      attribute :status
+
+      # @!attribute [r] onset_date
+      #   @return [string] The date of onset
+      attribute :onset_date, serializer: Serializers::DateTimeSerializer.new
+
+      # @!attribute [r] abatement_date
+      #   @return [string] The date of abatement
+      attribute :abatement_date, serializer: Serializers::DateTimeSerializer.new
+
+      # @!attribute [r] patient_id
+      #   @return [string] The internal mirah id of the patient the condition applies to
+      attribute :patient_id, path: %w[patient], target: 'id'
+
+      # @!attribute [r] external_patient_id
+      #   @return [string] Your system identifier for the patient the condition applies to
+      attribute :external_patient_id, path: %w[patient], target: 'externalId'
+
+      # @!attribute [r] diagnostic_code_id
+      #   @return [string] The internal mirah id of the code the patient has been diagnosed with
+      attribute :diagnostic_code_id, path: %w[diagnosticCode], target: 'id'
+
+      # @!attribute [r] external_diagnostic_code_id
+      #   @return [string] Your system identifier for the code the patient has been diagnosed with
+      attribute :external_diagnostic_code_id, path: %w[diagnosticCode], target: 'externalId'
+    end
+  end
+end

data/lib/mirah/filters/diagnostic_code_filters.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Filters
+    # Input parameters and filters for queries returning {Data::DiagnosticCode} objects.
+    class DiagnosticCodeFilters < BaseObject
+      # @!attribute [r] external_id
+      #   @return [Array<string>] An array of external identifiers to match.
+      attribute :external_id
+
+      # @!attribute [r] search
+      #   @return [string] Smart search by name and other fields where appropriate
+      attribute :search
+    end
+  end
+end

data/lib/mirah/filters/patient_condition_filters.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Filters
+    # Input parameters and filters for queries returning {Data::PatientCondition} objects.
+    class PatientConditionFilters < BaseObject
+      # @!attribute [r] external_id
+      #   @return [Array<string>] An array of external identifiers to match.
+      attribute :external_id
+    end
+  end
+end

data/lib/mirah/graphql/fragments.rb

@@ -107,6 +107,39 @@ module Mirah
           }
         }
       GRAPHQL
+
+      DiagnosticCodeFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on DiagnosticCode {
+          id
+          externalId
+          name
+          code
+          identifier {
+            value
+          }
+        }
+      GRAPHQL
+
+      PatientConditionFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on PatientCondition {
+          id
+          externalId
+          patient {
+            id
+            externalId
+          }
+          diagnosticCode {
+            id
+            externalId
+          }
+          identifier {
+            value
+          }
+          onsetDate
+          abatementDate
+          status
+        }
+      GRAPHQL
     end
   end
 end

data/lib/mirah/graphql/mutations.rb

@@ -67,6 +67,38 @@ module Mirah
           }
         }
       GRAPHQL
+
+      # Create or update a diagnostic code
+      CreateOrUpdateDiagnosticCodeMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdateDiagnosticCodeInput!) {
+          createOrUpdateDiagnosticCode(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::DiagnosticCodeFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      # Create or update a patient condition
+      CreateOrUpdatePatientConditionMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdatePatientConditionInput!) {
+          createOrUpdatePatientCondition(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::PatientConditionFragment
+            }
+          }
+        }
+      GRAPHQL
     end
   end
 end

data/lib/mirah/graphql/queries.rb

@@ -191,6 +191,98 @@ module Mirah
           }
         }
       GRAPHQL
+
+      #========================================================================
+      # DIAGNOSTIC CODE QUERIES
+      #========================================================================
+
+      DiagnosticCodeQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!],
+          $search: String
+        ) {
+          diagnosticCodes(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId,
+            search: $search
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::DiagnosticCodeFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      DiagnosticCodeIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          diagnosticCode(id: $id) {
+            ...Mirah::Graphql::Fragments::DiagnosticCodeFragment
+          }
+        }
+      GRAPHQL
+
+      DiagnosticCodeExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          diagnosticCodeExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::DiagnosticCodeFragment
+          }
+        }
+      GRAPHQL
+
+      #========================================================================
+      # PATIENT CONDITION QUERIES
+      #========================================================================
+
+      PatientConditionQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!]
+        ) {
+          patientConditions(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::PatientConditionFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      PatientConditionIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          patientCondition(id: $id) {
+            ...Mirah::Graphql::Fragments::PatientConditionFragment
+          }
+        }
+      GRAPHQL
+
+      PatientConditionExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          patientConditionExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::PatientConditionFragment
+          }
+        }
+      GRAPHQL
     end
   end
 end

data/lib/mirah/inputs/diagnostic_code_input.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Inputs
+    # A set of parameters for updating a {Data::DiagnosticCocde}
+    class DiagnosticCodeInput < BaseInputObject
+      # @!attribute [r] external_id
+      #   @return (see Mirah::Data::DiagnosticCode#external_id)
+      input :external_id, required: true
+
+      # @!attribute [r] name
+      #   @return (see Mirah::Data::DiagnosticCode#name)
+      input :name, required: false
+
+      # @!attribute [r] name
+      #   @return (see Mirah::Data::DiagnosticCode#code)
+      input :code, required: false
+    end
+  end
+end

data/lib/mirah/inputs/patient_condition_input.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Inputs
+    # A set of parameters for updating a {Data::Appointment}
+    class PatientConditionInput < BaseInputObject
+      # @!attribute [r] external_id
+      #   @return (see Mirah::Data::PatientCondition#external_id)
+      input :external_id, required: true
+
+      # @!attribute [r] onset_date
+      #   @return (see Mirah::Data::PatientCondition#onset_date)
+      input :onset_date, required: false, serializer: Serializers::DateTimeSerializer.new
+
+      # @!attribute [r] abatement_date
+      #   @return (see Mirah::Data::PatientCondition#abatement_date)
+      input :abatement_date, required: false, serializer: Serializers::DateTimeSerializer.new
+
+      # @!attribute [r] status
+      #   @return (see Mirah::Data::PatientCondition#status)
+      input :status, required: true
+
+      # @!attribute [r] external_patient_id
+      #   @return (see Mirah::Data::PatientCondition#external_patient_id)
+      input :external_patient_id, required: false
+
+      # @!attribute [r] external_diagnostic_code_id
+      #   @return (see Mirah::Data::PatientCondition#external_diagnostic_code_id)
+      input :external_diagnostic_code_id, required: false
+    end
+  end
+end

data/lib/mirah/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mirah
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end