athena_health 2.0.3 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72d528a701d5b4e4495d1e37121779dc39e6940e7dd761e199478e269c955f2e
-  data.tar.gz: 5849da85a6822b0a5f92f5c333ab51eb2cb75a8b9ea823a37282447b91651b0d
+  metadata.gz: 7c005b70b9fe653d511911dc8ae73886f54db577d45dfe1af197cd72f9a1f876
+  data.tar.gz: '0838c4499ddca040998cda0f095dcb6c2300273f84894ed49e5de6540f4cb5cb'
 SHA512:
-  metadata.gz: 1209d763734ae0fed0e659d87841215a3db81da08abae384d7e50abfaea8c8d66dfc55901dee7de408958df04fad37273b9f57236dcdf4172de946b249819a96
-  data.tar.gz: d327001b2902eb318b97bd3b3d294809c77b6b06d20ceb9614a7608ee63e412314c80f992d5518637ff540a2b2cea051d7388b80586582e704f577f8822c6a17
+  metadata.gz: 1da9ff931d0d983769fbb3447d552759ce75c8a905aa47bc3f213fc1bd81fa4cb80bb9536fa79e497ea48625fa97661e8d2cf62a474085ac51fdabb85a31afa6
+  data.tar.gz: 71637c8888c4ef43ca42798db02b6cd2cf54595fae51564eebbcf2129d3ba0a3828c479ad5d0f89089d8f822868a93a5cb2a3b9e09303aca5c59b705373c44f4

data/.gitignore

@@ -9,3 +9,4 @@
 /tmp/
 .idea
 .vscode/settings.json
+*.DS_Store

data/.rubocop.yml

@@ -0,0 +1,4 @@
+Metrics/BlockLength:
+  Enabled: false
+Metrics/ModuleLength:
+  Enabled: false

data/README.md

@@ -3,7 +3,7 @@
 
 # AthenaHealth
 
-Ruby wrapper for [Athenahealth API](https://developer.api.athena.io/).
+Ruby wrapper for [Athenahealth API](https://docs.athenahealth.com/api/).
 
 ## Updating from gem version 1 (Mashery API) to gem version 2 (https://developer.api.athena.io/ API)
 

data/lib/athena_health/base_collection.rb

@@ -1,7 +1,6 @@
+require_relative 'base_model'
 module AthenaHealth
-  class BaseCollection
-    include Virtus.model
-
+  class BaseCollection < BaseModel
     attribute :totalcount, Integer
     attribute :next,       String
     attribute :previous,   String

data/lib/athena_health/base_model.rb

@@ -1,5 +1,49 @@
+# frozen_string_literal: true
+
 module AthenaHealth
+  # all parsed models should inherit from here
   class BaseModel
     include Virtus.model
+
+    def self.model_attribute(field_name:, klass:, array: false)
+      define_method(field_name.to_sym) do
+        instance_variable_get("@#{field_name}")
+      end
+
+      instance_variable_set(:@internal_detail_fields, (@internal_detail_fields || []) + [{
+        field_name: field_name,
+        field_klass: klass,
+        array: array
+      }])
+    end
+
+    def initialize(args)
+      super(args)
+      parse_sub_objects(args)
+    end
+
+    private
+
+    def parse_sub_objects(args)
+      return if self.class.instance_variable_get(:@internal_detail_fields).nil?
+
+      self.class.instance_variable_get(:@internal_detail_fields).each do |internal_detail_field|
+        value = sub_object_value(internal_detail_field, args)
+
+        next if value.nil?
+
+        instance_variable_set("@#{internal_detail_field[:field_name]}", value)
+      end
+    end
+
+    def sub_object_value(internal_detail_field, args)
+      val = args[internal_detail_field[:field_name]]
+      return nil if val.nil?
+      return internal_detail_field[:field_klass].new(val) unless internal_detail_field[:array] == true
+
+      val.map do |x|
+        internal_detail_field[:field_klass].new(x)
+      end
+    end
   end
 end

data/lib/athena_health/endpoints/configurations.rb

@@ -68,6 +68,20 @@ module AthenaHealth
           )
         )
       end
+
+      def available_screening_questionaires(practice_id:, limit: nil, offset: nil)
+        params = {
+          limit: limit, offset: offset
+        }.reject { |_k, v| v.nil? }
+
+        AthenaHealth::ScreeningQuestionaire::ScreeningQuestionaireTemplateCollection.new(
+          @api.call(
+            endpoint: "#{practice_id}/chart/questionnairescreeners",
+            method: :get,
+            params: params
+          )
+        )
+      end
     end
   end
 end

data/lib/athena_health/endpoints/encounters.rb

@@ -16,7 +16,7 @@ module AthenaHealth
           method: :get
         )
         orders_collection = []
-        response.each {|x| orders_collection << OrderCollection.new(x)}
+        response.each { |x| orders_collection << OrderCollection.new(x) }
 
         orders_collection
       end
@@ -32,7 +32,7 @@ module AthenaHealth
 
       def encounter_summary(practice_id:, encounter_id:)
         response = @api.call(
-          endpoint:  "#{practice_id}/chart/encounters/#{encounter_id}/summary",
+          endpoint: "#{practice_id}/chart/encounters/#{encounter_id}/summary",
           method: :get
         )
         EncounterSummary.new(response)
@@ -61,6 +61,77 @@ module AthenaHealth
           body: body
         )
       end
+
+      def encounter_screening_questionnaires(practice_id:, encounter_id:, limit: nil, offset: nil)
+        params = {
+          limit: limit, offset: offset
+        }.reject { |_k, value| value.nil? }
+
+        response = @api.call(
+          endpoint: "#{practice_id}/chart/encounter/#{encounter_id}/questionnairescreeners",
+          params: params,
+          method: :get
+        )
+
+        ScreeningQuestionaire::ScreeningQuestionaireCollection.new(response)
+      end
+
+      def activate_screening_questionnaire(practice_id:, encounter_id:, template_id:)
+        @api.call(
+          endpoint: "#{practice_id}/chart/encounter/#{encounter_id}/questionnairescreeners",
+          body: {
+            templateid: template_id
+          },
+          method: :post
+        )
+      end
+
+      def update_screening_questionnaire_score_only(
+        practice_id:,
+        encounter_id:,
+        questionnaire_id:,
+        score:,
+        document_ids:,
+        note: nil
+      )
+
+        body = {
+          questionnaireid: questionnaire_id,
+          documentids: document_ids,
+          score: score, note: note
+        }.reject { |_k, value| value.nil? }
+
+        @api.call(
+          endpoint: "#{practice_id}/chart/encounter/#{encounter_id}/questionnairescreeners/scoreonly",
+          body: body,
+          method: :put
+        )
+      end
+
+      def update_screening_questionnaire(
+        practice_id:,
+        encounter_id:,
+        questionnaire_id:,
+        questions:,
+        score:,
+        document_ids:,
+        guidelines: nil,
+        state: nil,
+        note: nil
+      )
+
+        body = {
+          questionnaireid: questionnaire_id,
+          documentids: document_ids, guidelines: guidelines,
+          state: state, questions: questions, score: score, note: note
+        }.reject { |_k, value| value.nil? }
+
+        @api.call(
+          endpoint: "#{practice_id}/chart/encounter/#{encounter_id}/questionnairescreeners",
+          body: body,
+          method: :put
+        )
+      end
     end
   end
 end

data/lib/athena_health/endpoints/patients.rb

@@ -28,7 +28,7 @@ module AthenaHealth
           params: params.merge!(firstname: first_name, lastname: last_name, dob: date_of_birth)
         )
 
-        response.map{ |patient| Patient.new(patient) }
+        response.map { |patient| Patient.new(patient) }
       end
 
       def create_patient(practice_id:, department_id:, params: {})
@@ -141,13 +141,13 @@ module AthenaHealth
       end
 
       def patient_appointments(practice_id:, patient_id:, params: {})
-          response = @api.call(
-            endpoint: "#{practice_id}/patients/#{patient_id}/appointments",
-            method: :get,
-            params: params
-          )
+        response = @api.call(
+          endpoint: "#{practice_id}/patients/#{patient_id}/appointments",
+          method: :get,
+          params: params
+        )
 
-          AppointmentCollection.new(response)
+        AppointmentCollection.new(response)
       end
 
       def patient_documents(practice_id:, department_id:, patient_id:, params: {})
@@ -168,6 +168,20 @@ module AthenaHealth
         )
       end
 
+      def create_patient_encounter_document(practice_id:, department_id:, patient_id:, document_subclass:,
+                                            attachment_contents: nil, encounter_id: nil, params: {})
+        body = params.merge({
+          departmentid: department_id.to_s, documentsubclass: document_subclass,
+          attachmentcontents: attachment_contents, encounterid: encounter_id
+        }.reject { |_k, v| v.nil? })
+
+        @api.call(
+          endpoint: "#{practice_id}/patients/#{patient_id}/documents/encounterdocument",
+          method: :post,
+          body: body
+        )['encounterdocumentid']
+      end
+
       def patient_default_pharmacy(practice_id:, department_id:, patient_id:)
         response = @api.call(
           endpoint: "#{practice_id}/chart/#{patient_id}/pharmacies/default",
@@ -229,7 +243,7 @@ module AthenaHealth
           params: { departmentid: department_id }
         )
 
-        response.map {|template| AthenaHealth::Template.new(template) }
+        response.map { |template| AthenaHealth::Template.new(template) }
       end
 
       def set_patient_social_history_templates(practice_id:, department_id:, patient_id:, template_ids: [])
@@ -280,9 +294,9 @@ module AthenaHealth
 
       def update_patient_medications(practice_id:, department_id:, patient_id:, params: {})
         response = @api.call(
-            endpoint: "#{practice_id}/chart/#{patient_id}/medications",
-            method: :put,
-            body: params.merge!(departmentid: department_id)
+          endpoint: "#{practice_id}/chart/#{patient_id}/medications",
+          method: :put,
+          body: params.merge!(departmentid: department_id)
         )
       end
 
@@ -339,9 +353,9 @@ module AthenaHealth
 
       def update_patient_insurance_card_image(practice_id:, patient_id:, insurance_id:, image:, params: {})
         @api.call(
-          endpoint: "#{practice_id}/patients/#{patient_id}/insurances/#{insurance_id}/image", 
+          endpoint: "#{practice_id}/patients/#{patient_id}/insurances/#{insurance_id}/image",
           method: :put,
-          body: {image: image}
+          body: { image: image }
         )
       end
 

data/lib/athena_health/{claim → models/claim}/claim.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
-require 'athena_health/claim/diagnosis'
-require 'athena_health/claim/payer'
-require 'athena_health/claim/procedure'
+require_relative 'diagnosis'
+require_relative 'payer'
+require_relative 'procedure'
+require_relative 'claim_collection'
 module AthenaHealth
   module Claim
     class Claim < BaseModel

data/lib/athena_health/models/screening_questionnaire/meta_question.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module ScreeningQuestionaire
+    # Any meta questions related to a questionnaire.
+    # E.g., should this be considered generally as positive or negative?
+    class MetaQuestion < BaseModel
+      attribute :answertext, String
+      attribute :questiontext, String
+    end
+  end
+end

data/lib/athena_health/models/screening_questionnaire/question.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module ScreeningQuestionaire
+    # A specfic question in a screening questionaire
+    class Question < BaseModel
+      attribute :answer, String
+      attribute :hidden, String
+      attribute :key, String
+      attribute :possibleanswers, Array[String]
+      attribute :question, String
+      attribute :questionid, Integer
+    end
+  end
+end

data/lib/athena_health/models/screening_questionnaire/screening_questionnaire.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'question'
+require_relative 'meta_question'
+require_relative 'section'
+
+module AthenaHealth
+  module ScreeningQuestionaire
+    # The reason the patient declined
+    class DeclinedReason < BaseModel
+      attribute :declinedreasontext, String
+    end
+
+    # A Screening Questionnaire Available in the platform
+    class ScreeningQuestionaireTemplate < BaseModel
+      attribute :templateid, Integer
+      attribute :templatetype, String
+      attribute :name, String
+    end
+
+    # Screening Questionnaires are used to assess risk for or severity of disorders or
+    # conditions such as autism and depression. These questionnaires result in a score,
+    # and often include guidelines and proposed treatment actions. Screeners can be structured
+    # or score-only. The Screening Questionnaires Reference are configured in the system.
+    # The user will be able to retrieve the list of screening questionnaires for a specific
+    # encounter. Screeners can be structured or score-only.
+    class ScreeningQuestionaire < ScreeningQuestionaireTemplate
+      model_attribute(field_name: 'declinedreason', klass: DeclinedReason)
+      attribute :documentids, Array[String]
+      attribute :guidelines, String
+      attribute :maximumscore, Integer
+      model_attribute(field_name: 'metaquestions', klass: MetaQuestion, array: true)
+
+      attribute :note, String
+      attribute :questionnaireid, Integer
+      attribute :score, Integer
+      attribute :scoredby, String
+      attribute :scoreddate, String
+      attribute :scoringstatus, String
+      model_attribute(field_name: 'sections', klass: Section, array: true)
+    end
+  end
+end

data/lib/athena_health/models/screening_questionnaire/screening_questionnaire_collection.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'screening_questionnaire'
+module AthenaHealth
+  module ScreeningQuestionaire
+    # a collection of screening questionaires
+    class ScreeningQuestionaireCollection < BaseModel
+      model_attribute(field_name: 'questionnairescreeners', klass: ScreeningQuestionaire, array: true)
+    end
+  end
+end

data/lib/athena_health/models/screening_questionnaire/screening_questionnaire_template_collection.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'screening_questionnaire'
+module AthenaHealth
+  module ScreeningQuestionaire
+    # a collection of screening questionaire templates
+    class ScreeningQuestionaireTemplateCollection < BaseCollection
+      model_attribute(field_name: 'questionnairescreeners', klass: ScreeningQuestionaireTemplate, array: true)
+    end
+  end
+end

data/lib/athena_health/models/screening_questionnaire/section.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AthenaHealth
+  module ScreeningQuestionaire
+    # The section of a screening questionaire
+    class Section < BaseModel
+      attribute :headertext, String
+      model_attribute(field_name: 'questionlist', klass: Question, array: true)
+    end
+  end
+end

data/lib/athena_health/version.rb

@@ -1,3 +1,3 @@
 module AthenaHealth
-  VERSION = '2.0.3'.freeze
+  VERSION = '2.0.4'.freeze
 end

data/lib/athena_health.rb

@@ -81,8 +81,10 @@ require 'athena_health/user_medication_sig'
 require 'athena_health/user_medication'
 require 'athena_health/user_medication_collection'
 require 'athena_health/subscription'
-require 'athena_health/claim/claim'
-require 'athena_health/claim/claim_collection'
+
+require 'athena_health/models/claim/claim'
+require 'athena_health/models/screening_questionnaire/screening_questionnaire_collection'
+require 'athena_health/models/screening_questionnaire/screening_questionnaire_template_collection'
 
 module AthenaHealth
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: athena_health
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors:
 - Mateusz Urbański
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-20 00:00:00.000000000 Z
+date: 2023-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -135,6 +135,7 @@ files:
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".ruby-version"
 - ".travis.yml"
 - Gemfile
@@ -157,11 +158,6 @@ files:
 - lib/athena_health/balance.rb
 - lib/athena_health/base_collection.rb
 - lib/athena_health/base_model.rb
-- lib/athena_health/claim/claim.rb
-- lib/athena_health/claim/claim_collection.rb
-- lib/athena_health/claim/diagnosis.rb
-- lib/athena_health/claim/payer.rb
-- lib/athena_health/claim/procedure.rb
 - lib/athena_health/client.rb
 - lib/athena_health/connection.rb
 - lib/athena_health/custom_field.rb
@@ -196,6 +192,17 @@ files:
 - lib/athena_health/lab_result_collection.rb
 - lib/athena_health/laboratory.rb
 - lib/athena_health/medication.rb
+- lib/athena_health/models/claim/claim.rb
+- lib/athena_health/models/claim/claim_collection.rb
+- lib/athena_health/models/claim/diagnosis.rb
+- lib/athena_health/models/claim/payer.rb
+- lib/athena_health/models/claim/procedure.rb
+- lib/athena_health/models/screening_questionnaire/meta_question.rb
+- lib/athena_health/models/screening_questionnaire/question.rb
+- lib/athena_health/models/screening_questionnaire/screening_questionnaire.rb
+- lib/athena_health/models/screening_questionnaire/screening_questionnaire_collection.rb
+- lib/athena_health/models/screening_questionnaire/screening_questionnaire_template_collection.rb
+- lib/athena_health/models/screening_questionnaire/section.rb
 - lib/athena_health/note.rb
 - lib/athena_health/note_collection.rb
 - lib/athena_health/order.rb