dor-services-client 12.17.0 → 12.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28239d64f9889da5c2eb01d1f7c1a724454a3f9d6e5dc04454e6d537d8b1530c
-  data.tar.gz: abffc94573aa3106b599477bff35c786c4ce4d6ba6bc41e9dea37dc43e8b220a
+  metadata.gz: a474115832894037ecf11cebc49b133d19d18c5bf43eb24c41a58a8efd7fd0a3
+  data.tar.gz: c39cdb3823ebfcc28acc4cbff90a680560507c3099f15826abc1a2d122b17839
 SHA512:
-  metadata.gz: 70a705670a2f0ac259b7af85806f909311d2222eb0af263d1bcbd2d96bffb0cf34185e2a9a38f4ba8cd5e1da1f3f9d1c01d4d0c490ddf29873a421d40402212e
-  data.tar.gz: 5ff867b49a8d5a552a6d0d5ffada7298fec9d8e19df029f8b79de2899ed1ab65b4058ddf4c0986ae99f1e6c63749bea999e3f165e3bb369416986f19e7e488ad
+  metadata.gz: e986337c48ceab9a1a84479caa51f580c1e6cd6ab5c876fb85c64c5a5985824f23d86b9a4b9ab6a548c482532f23859e726b21f0063325f3d82c42d4f8c32da1
+  data.tar.gz: 86170854e8d54022a93e7a70f8527d1028153ab3f0cd1d49ac4cedb8caec39e8b1836a4b3832e38b479848a53cd4c822f2c69ddeefa5f75956c49a0f88677c9d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dor-services-client (12.17.0)
+    dor-services-client (12.18.0)
       activesupport (>= 4.2, < 8)
       cocina-models (~> 0.91.0)
       deprecation

data/README.md

@@ -141,6 +141,9 @@ object_client.version.close
 # Return the Cocina metadata
 object_client.find
 
+# Returns "lite" Cocina metadata (excluding specified attributes)
+object_client.find_lite(structural: false, geographic: false)
+
 # Query for an object's collections
 object_client.collections
 

data/lib/dor/services/client/object.rb

@@ -6,7 +6,7 @@ module Dor
   module Services
     class Client
       # API calls that are about a repository object
-      class Object < VersionedService
+      class Object < VersionedService # rubocop:disable Metrics/ClassLength
         extend Deprecation
         attr_reader :object_identifier
 
@@ -52,6 +52,35 @@ module Dor
           build_cocina_from_response(resp, validate: validate)
         end
 
+        BASE_ALLOWED_FIELDS = %i[external_identifier cocina_version label version administrative description].freeze
+        DRO_ALLOWED_FIELDS = BASE_ALLOWED_FIELDS + %i[content_type access identification structural geographic]
+
+        # rubocop:disable Metrics/MethodLength
+        # rubocop:disable Metrics/AbcSize
+        # rubocop:disable Metrics/CyclomaticComplexity
+        # rubocop:disable Metrics/ParameterLists
+        def find_lite(administrative: true, description: true, access: true, structural: true, identification: true, geographic: true)
+          fields = []
+          fields << :administrative if administrative
+          fields << :description if description
+          fields << :access if access
+          fields << :structural if structural
+          fields << :identification if identification
+          fields << :geographic if geographic
+
+          resp = connection.post '/graphql', query(fields),
+                                 'Content-Type' => 'application/json'
+          raise_exception_based_on_response!(resp) unless resp.success?
+          resp_json = JSON.parse(resp.body)
+          # GraphQL returns 200 even when an error
+          raise_graphql_exception(resp, resp_json)
+          Cocina::Models.build_lite(resp_json['data']['cocinaObject'])
+        end
+        # rubocop:enable Metrics/MethodLength
+        # rubocop:enable Metrics/AbcSize
+        # rubocop:enable Metrics/CyclomaticComplexity
+        # rubocop:enable Metrics/ParameterLists
+
         # Get a list of the collections. (Similar to Valkyrie's find_inverse_references_by)
         # @raise [UnexpectedResponse] if the request is unsuccessful.
         # @return [Array<Cocina::Models::DRO>]
@@ -140,6 +169,35 @@ module Dor
         def object_path
           "#{api_version}/objects/#{object_identifier}"
         end
+
+        DEFAULT_FIELDS = %i[externalIdentifier type version label cocinaVersion].freeze
+
+        def query(fields)
+          all_fields = DEFAULT_FIELDS + fields
+          {
+            query:
+          <<~GQL
+            {
+              cocinaObject(externalIdentifier: "#{object_identifier}") {
+                #{all_fields.join("\n")}
+              }
+            }
+          GQL
+          }.to_json
+        end
+
+        def raise_graphql_exception(resp, resp_json)
+          return unless resp_json['errors'].present?
+
+          exception_class = not_found_exception?(resp_json['errors'].first) ? NotFoundResponse : UnexpectedResponse
+          raise exception_class.new(response: resp,
+                                    object_identifier: object_identifier,
+                                    graphql_errors: resp_json['errors'])
+        end
+
+        def not_found_exception?(error)
+          error['message'] == 'Cocina object not found'
+        end
       end
     end
   end

data/lib/dor/services/client/version.rb

@@ -3,7 +3,7 @@
 module Dor
   module Services
     class Client
-      VERSION = '12.17.0'
+      VERSION = '12.18.0'
     end
   end
 end

data/lib/dor/services/client.rb

@@ -43,17 +43,21 @@ module Dor
         # @param [Faraday::Response] response
         # @param [String] object_identifier (nil)
         # @param [Hash<String,Object>] errors (nil) the JSON-API errors object
+        # @param [Hash<String,Object>] graphql_errors (nil) the GraphQL errors object
         # rubocop:disable Lint/MissingSuper
-        def initialize(response:, object_identifier: nil, errors: nil)
+        def initialize(response:, object_identifier: nil, errors: nil, graphql_errors: nil)
           @response = response
           @object_identifier = object_identifier
           @errors = errors
+          @graphql_errors = graphql_errors
         end
         # rubocop:enable Lint/MissingSuper
 
-        attr_accessor :errors
+        attr_accessor :errors, :graphql_errors
 
         def to_s
+          # For GraphQL errors, see https://graphql-ruby.org/errors/execution_errors
+          return graphql_errors.map { |e| e['message'] }.join(', ') if graphql_errors.present?
           return errors.map { |e| "#{e['title']} (#{e['detail']})" }.join(', ') if errors.present?
 
           ResponseErrorFormatter.format(response: @response, object_identifier: @object_identifier)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dor-services-client
 version: !ruby/object:Gem::Version
-  version: 12.17.0
+  version: 12.18.0
 platform: ruby
 authors:
 - Justin Coyne
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-13 00:00:00.000000000 Z
+date: 2023-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport