Create read-imms-api CLI tool

This is a feature which will `read` a vaccination record in the Imms API, and either print out the resulting JSON, or save it to a file.

It is possible to either search for an existing `VaccinationRecord` by ID, or by an Imms API ID

Author: alistair-white-horne-tng

app/lib/mavis_cli.rb

@@ -57,3 +57,4 @@ def self.progress_bar(total)
 require_relative "mavis_cli/vaccination_records/sync"
 require_relative "mavis_cli/vaccination_records/create_from_fhir"
 require_relative "mavis_cli/vaccination_records/search_imms_api"
+require_relative "mavis_cli/vaccination_records/read_imms_api"

app/lib/mavis_cli/vaccination_records/read_imms_api.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module MavisCLI
+  module VaccinationRecords
+    class ReadImmsAPI < Dry::CLI::Command
+      desc "Search vaccination records in NHS Immunisations API for a patient"
+
+      option :vaccination_record_id,
+             required: false,
+             desc: "Mavis ID of the vaccination record"
+      option :imms_api_id,
+             required: false,
+             desc: "The Imms API ID of the vaccination record"
+      option :output_file,
+             required: false,
+             desc: "File path to save JSON output"
+
+      def call(
+        vaccination_record_id: nil,
+        imms_api_id: nil,
+        output_file: nil,
+        **
+      )
+        MavisCLI.load_rails
+
+        unless Flipper.enabled?(:imms_api_integration)
+          puts "Cannot search: Feature flag :imms_api_integration is not enabled"
+          return
+        end
+
+        if vaccination_record_id.blank? && imms_api_id.blank?
+          puts "Error: Provide either --vaccination-record-id or --imms-api-id"
+          return
+        end
+
+        if vaccination_record_id.present? && imms_api_id.present?
+          puts "Error: Provide only one of --vaccination-record-id or --imms-api-id"
+          return
+        end
+
+        if imms_api_id.present?
+          fhir_record =
+            NHS::ImmunisationsAPI.read_immunisation_by_nhs_immunisations_api_id(
+              imms_api_id
+            )
+        else
+          vaccination_record =
+            VaccinationRecord.find_by(id: vaccination_record_id)
+          if vaccination_record.nil?
+            puts "Error: Vaccination record with ID #{vaccination_record_id} not found"
+            return
+          end
+
+          fhir_record =
+            NHS::ImmunisationsAPI.read_immunisation(vaccination_record)
+        end
+
+        if fhir_record.nil?
+          puts "No result returned"
+          return
+        end
+
+        json = fhir_record.to_json
+        pretty = JSON.pretty_generate(JSON.parse(json))
+
+        if output_file && !output_file.strip.empty?
+          File.write(output_file, pretty)
+          puts "Saved JSON to #{output_file}"
+        else
+          puts pretty
+        end
+      end
+    end
+  end
+
+  register "vaccination-records" do |prefix|
+    prefix.register "read-imms-api", VaccinationRecords::ReadImmsAPI
+  end
+end