mirah-ruby 0.1.0

data/lib/mirah/filters/patient_filters.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Filters
+    # Input parameters and filters for queries returning {Data::Patient} objects.
+    class PatientFilters < 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/practitioner_filters.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Filters
+    # Input parameters and filters for queries returning {Data::Practitioner} objects.
+    class PractitionerFilters < 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/graphql.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Mirah
+  # Graphql provides the direct interface with the graphql client library and can be used directly to query
+  # Mirah endpoints.
+  # @private
+  module Graphql
+    DEFAULT_ENDPOINT = '/integration_api/graphql'
+
+    raw_schema = JSON.parse(File.read(File.dirname(__FILE__) + '/../../schema.json'))
+    Schema = GraphQL::Schema::Loader.load(raw_schema)
+
+    # A graplql executor which will supply the correct HTTP headers to authenticate with Mirah servers.
+    class AuthorizedHttp < GraphQL::Client::HTTP
+      def headers(context)
+        {
+          "API_USER_ID": context[:user_id],
+          "API_KEY": context[:access_token]
+        }
+      end
+    end
+
+    # Create a new Graphql client for the given endpoint, authenticating with the given details.
+    def self.create_client(host:)
+      http = AuthorizedHttp.new(host + DEFAULT_ENDPOINT)
+      GraphQL::Client.new(schema: Schema, execute: http)
+    end
+
+    # In order to validate the queries in advance, we need a client, but we don't have an execution context,
+    # so we make a validation client to generate the query types.
+    ValidationClient = GraphQL::Client.new(schema: Schema)
+  end
+end

data/lib/mirah/graphql/fragments.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Graphql
+    # @private
+    module Fragments
+      PageInfoFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on PageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+      GRAPHQL
+
+      PatientFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on Patient {
+          id
+          externalId
+          givenName
+          familyName
+          birthDate
+          gender
+          primaryLanguage
+          email
+          phoneNumber
+          identifier {
+            value
+          }
+        }
+      GRAPHQL
+
+      OrganizationFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on Organization {
+          id
+          externalId
+          name
+          identifier {
+            value
+          }
+          partOf {
+            id
+            externalId
+          }
+        }
+      GRAPHQL
+
+      PractitionerFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on Practitioner {
+          id
+          externalId
+          givenName
+          familyName
+          title
+          suffix
+          email
+          defaultPractitionerRole
+          ssoUsername
+          identifier {
+            value
+          }
+          organizations {
+            id
+            externalId
+          }
+        }
+      GRAPHQL
+
+      AppointmentFragment = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        fragment on Appointment {
+          id
+          externalId
+          startDate
+          endDate
+          minutesDuration
+          status
+          patient {
+            id
+            externalId
+          }
+          organization {
+            id
+            externalId
+          }
+          organization {
+            id
+            externalId
+          }
+          practitioner {
+            id
+            externalId
+          }
+        }
+      GRAPHQL
+    end
+  end
+end

data/lib/mirah/graphql/mutations.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Graphql
+    # @private
+    module Mutations
+      # Create or update a patient
+      CreateOrUpdatePatientMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdatePatientInput!) {
+          createOrUpdatePatient(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::PatientFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      # Create or update an organization
+      CreateOrUpdateOrganizationMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdateOrganizationInput!) {
+          createOrUpdateOrganization(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::OrganizationFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      # Create or update a practitioner
+      CreateOrUpdatePractitionerMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdatePractitionerInput!) {
+          createOrUpdatePractitioner(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::PractitionerFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      # Create or update an appointment
+      CreateOrUpdateAppointmentMutation = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        mutation($input: CreateOrUpdateAppointmentInput!) {
+          createOrUpdateAppointment(input: $input) {
+            status
+            errors {
+              path
+              message
+            }
+            result {
+            ...Mirah::Graphql::Fragments::AppointmentFragment
+            }
+          }
+        }
+      GRAPHQL
+    end
+  end
+end

data/lib/mirah/graphql/queries.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Graphql
+    # @private
+    module Queries # rubocop:disable Metrics/ModuleLength
+      #========================================================================
+      # PATIENT QUERIES
+      #========================================================================
+
+      PatientQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!],
+          $search: String
+        ) {
+          patients(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId,
+            search: $search
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::PatientFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      PatientIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          patient(id: $id) {
+            ...Mirah::Graphql::Fragments::PatientFragment
+          }
+        }
+      GRAPHQL
+
+      PatientExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          patientExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::PatientFragment
+          }
+        }
+      GRAPHQL
+
+      #========================================================================
+      # ORGANIZATION QUERIES
+      #========================================================================
+
+      OrganizationQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!],
+          $search: String
+        ) {
+          organizations(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId,
+            search: $search
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::OrganizationFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      OrganizationIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          organization(id: $id) {
+            ...Mirah::Graphql::Fragments::OrganizationFragment
+          }
+        }
+      GRAPHQL
+
+      OrganizationExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          organizationExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::OrganizationFragment
+          }
+        }
+      GRAPHQL
+
+      #========================================================================
+      # PRACTITIONER QUERIES
+      #========================================================================
+
+      PractitionerQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!]
+          $search: String
+        ) {
+          practitioners(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId,
+            search: $search
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::PractitionerFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      PractitionerIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          practitioner(id: $id) {
+            ...Mirah::Graphql::Fragments::PractitionerFragment
+          }
+        }
+      GRAPHQL
+
+      PractitionerExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          practitionerExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::PractitionerFragment
+          }
+        }
+      GRAPHQL
+
+      #========================================================================
+      # APPOINTMENT QUERIES
+      #========================================================================
+
+      AppointmentQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query(
+          $first: Int
+          $last: Int
+          $after: String
+          $before: String,
+          $externalId: [String!]
+          $status: [AppointmentStatus!]
+        ) {
+          appointments(
+            first: $first
+            after: $after
+            before: $before
+            last: $last,
+            externalId: $externalId,
+            status: $status
+          ) {
+            nodes {
+              ...Mirah::Graphql::Fragments::AppointmentFragment
+            }
+            pageInfo {
+              ...Mirah::Graphql::Fragments::PageInfoFragment
+            }
+          }
+        }
+      GRAPHQL
+
+      AppointmentIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($id: ID!) {
+          appointment(id: $id) {
+            ...Mirah::Graphql::Fragments::AppointmentFragment
+          }
+        }
+      GRAPHQL
+
+      AppointmentExternalIdQuery = Graphql::ValidationClient.parse <<-'GRAPHQL'
+        query($externalId: String!) {
+          appointmentExternal(externalId: $externalId) {
+            ...Mirah::Graphql::Fragments::AppointmentFragment
+          }
+        }
+      GRAPHQL
+    end
+  end
+end

data/lib/mirah/inputs.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Mirah
+  # These filters represent ways of querying data. Each endpoint has a set of filters that you can apply.
+  module Inputs
+  end
+end

data/lib/mirah/inputs/appointment_input.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Mirah
+  module Inputs
+    # A set of parameters for updating a {Data::Appointment}
+    class AppointmentInput < BaseInputObject
+      # @!attribute [r] external_id
+      #   @return (see Mirah::Data::Appointment#external_id)
+      input :external_id, required: true
+
+      # @!attribute [r] start_date
+      #   @return (see Mirah::Data::Appointment#start_date)
+      input :start_date, required: false, serializer: Serializers::DateTimeSerializer
+
+      # @!attribute [r] end_date
+      #   @return (see Mirah::Data::Appointment#end_date)
+      input :end_date, required: false, serializer: Serializers::DateTimeSerializer
+
+      # @!attribute [r] minutes_duration
+      #   @return (see Mirah::Data::Appointment#minutes_duration)
+      input :minutes_duration, required: false
+
+      # @!attribute [r] status
+      #   @return (see Mirah::Data::Appointment#status)
+      input :status, required: true
+
+      # @!attribute [r] external_patient_id
+      #   @return (see Mirah::Data::Appointment#external_patient_id)
+      input :external_patient_id, required: false
+
+      # @!attribute [r] external_organization_id
+      #   @return (see Mirah::Data::Appointment#external_organization_id)
+      input :external_organization_id, required: false
+
+      # @!attribute [r] external_practitioner_id
+      #   @return (see Mirah::Data::Appointment#external_practitioner_id)
+      input :external_practitioner_id, required: false
+    end
+  end
+end