folio_api_client 0.3.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd0f25ee382d9468806b7ae7c39a0d7801f43d5e45c7f7bd248565673fe9da23
-  data.tar.gz: e05cb433eb2134c574d2de93a3e9de4cdad6a4c9bd9c6ae3f67483179f64e855
+  metadata.gz: b840ff7acc1495be7cb4dc3895c9a0e372d98df6db09bd45e5a77725e1cc3444
+  data.tar.gz: 187a19aa42bfe6e1f64e859dfd1b7d71c03db8a0967ab93a7df2318bdc2c4b32
 SHA512:
-  metadata.gz: f68f5dab0e5080f62b307c8f72bf2fb75e5d4033f7fb70fdfdd99f749edf821ae2c9d1c697e31f70f8af4e1be60aa55c930c9c9bd494348fbff9fe1e7337e563
-  data.tar.gz: 6cdc0f1d8a571a11599ae906f985f0e2901dedcbc07b8f26f71f316337507693dd22ea0f8a841bbd6083ce6436c5b7dbebe252f4f54d685bb1366c66ec29ebdf
+  metadata.gz: 4b1d313a2cf74cd8b28f5d151239136a3fd8c7fe4db9a2bb85c924dd9390ab464e733012fc95d8bc8bf274db6571e2638f66ab0e4fa0633e4e0b5f372184647c
+  data.tar.gz: 52216d3b49b1b5d5c45c3698eb95eb8350aca7b59846de99f9498524c3e2fe8f202f7a8227a7f53b9f5b6e03da9ad6d33be816e7e87a12412579ecd6c1e445ee

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 The Trustees of Columbia University in the City of New York
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -47,9 +47,16 @@ client.delete(path, body, content_type: 'application/json'))
 
 client.find_item_record(barcode: 'some-barcode')
 client.find_location_record(location_id: 'some-location-id')
+client.find_material_type_record(material_type_id: 'some-material-type-id')
 client.find_holdings_record(holdings_record_id: 'some-holdings-record-id')
 client.find_instance_record(instance_record_id: 'some-instance-record-id')
-client.find_marc_record(instance_record_id: 'some-instance-record-id') # returns a MARC::Record
+client.find_instance_record(instance_record_hrid: 'some-instance-record-hrid')
+client.find_source_record(instance_record_id: 'some-instance-record-id')
+client.find_source_record(instance_record_hrid: 'some-instance-record-hrid')
+
+# Convert a FOLIO MARC source record to a marc gem MARC::Record object:
+source_record = client.find_source_record(instance_record_id: 'some-instance-record-id')
+marc_record = MARC::Record.new_from_hash(source_record['parsedRecord']['content'])
 ```
 
 See [https://dev.folio.org/reference/api/](https://dev.folio.org/reference/api/) for the full list of available FOLIO API endpoints.

data/lib/folio_api_client/finders.rb

@@ -11,40 +11,83 @@ class FolioApiClient
               'Only expected one item with this barcode, but found more than one.'
       end
 
-      item_record_id = item_search_results.first['id']
-      self.get("/item-storage/items/#{item_record_id}")
+      item_search_results.first
     end
 
     def find_location_record(location_id:)
+      return nil if location_id.nil?
+
       self.get("/locations/#{location_id}")
+    rescue Faraday::ResourceNotFound
+      nil
+    end
+
+    def find_material_type_record(material_type_id:)
+      return nil if material_type_id.nil?
+
+      self.get("/material-types/#{material_type_id}")
+    rescue Faraday::ResourceNotFound
+      nil
+    end
+
+    def find_loan_type_record(loan_type_id:)
+      self.get("/loan-types/#{loan_type_id}")
     end
 
     def find_holdings_record(holdings_record_id:)
       self.get("/holdings-storage/holdings/#{holdings_record_id}")
     end
 
-    def find_instance_record(instance_record_id:)
-      self.get("/instance-storage/instances/#{instance_record_id}")
+    def find_instance_record(instance_record_id: nil, instance_record_hrid: nil)
+      instance_search_results = self.get(
+        '/instance-storage/instances',
+        instance_record_query(instance_record_id: instance_record_id, instance_record_hrid: instance_record_hrid)
+      )['instances']
+      return nil if instance_search_results.empty?
+
+      if instance_search_results.length > 1
+        raise FolioApiClient::Exceptions::UnexpectedMultipleRecordsFoundError,
+              'Only expected one instance with this '\
+              "#{instance_record_id ? 'instance_record_id' : 'instance_record_hrid'}, "\
+              'but found more than one.'
+      end
+
+      instance_search_results.first
     end
 
-    # Find a MARC::Record by its instance record id or instance record hrid
-    def find_marc_record(instance_record_id: nil, instance_record_hrid: nil)
+    # Find a source record by its instance record id or instance record hrid.
+    # @return [Hash] A Source Record (which can hold data for a MARC record).
+    def find_source_record(instance_record_id: nil, instance_record_hrid: nil)
       source_record_search_results = self.get(
         '/source-storage/source-records',
-        marc_record_query(instance_record_id: instance_record_id, instance_record_hrid: instance_record_hrid)
+        source_record_query(instance_record_id: instance_record_id, instance_record_hrid: instance_record_hrid)
       )
       return nil if source_record_search_results['totalRecords'].zero?
 
-      bib_record_marc_hash = source_record_search_results['sourceRecords'].first['parsedRecord']['content']
-      MARC::Record.new_from_hash(bib_record_marc_hash)
+      if source_record_search_results['totalRecords'] > 1
+        raise FolioApiClient::Exceptions::UnexpectedMultipleRecordsFoundError,
+              'Only expected one record with this '\
+              "#{instance_record_id ? 'instance_record_id' : 'instance_record_hrid'}, "\
+              'but found more than one.'
+      end
+
+      source_record_search_results['sourceRecords'].first
     end
 
-    def marc_record_query(instance_record_id: nil, instance_record_hrid: nil)
+    def source_record_query(instance_record_id: nil, instance_record_hrid: nil)
       return { instanceId: instance_record_id } if instance_record_id
       return { instanceHrid: instance_record_hrid } if instance_record_hrid
 
       raise FolioApiClient::Exceptions::MissingQueryFieldError,
             'Missing query field.  Must supply either an instance_record_id or instance_record_hrid.'
     end
+
+    def instance_record_query(instance_record_id: nil, instance_record_hrid: nil)
+      return { query: "id==#{instance_record_id}", limit: 2 } if instance_record_id
+      return { query: "hrid==#{instance_record_hrid}", limit: 2 } if instance_record_hrid
+
+      raise FolioApiClient::Exceptions::MissingQueryFieldError,
+            'Missing query field.  Must supply either an instance_record_id or instance_record_hrid.'
+    end
   end
 end

data/lib/folio_api_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class FolioApiClient
-  VERSION = '0.3.0'
+  VERSION = '0.4.2'
 end

data/lib/folio_api_client.rb

@@ -38,7 +38,7 @@ class FolioApiClient
   end
 
   def retrieve_new_auth_token
-    response = connection.post('/authn/login', { username: config.username, password: config.password }.to_json)
+    response = connection.post('/authn/login', JSON.generate({ username: config.username, password: config.password }))
     response_data = JSON.parse(response.body)
     response_data['okapiToken']
   end
@@ -68,12 +68,12 @@ class FolioApiClient
   end
 
   def exec_request_with_body(method, path, body = nil, content_type: 'application/json')
-    body = body.to_json if content_type == 'application/json' && !body.is_a?(String)
+    body = JSON.generate(body) if content_type == 'application/json' && !body.is_a?(String)
     response = with_token_refresh_attempt_when_unauthorized do
       connection.send(method, path, body, { 'x-okapi-token': config.token, 'content-type': content_type })
     end
 
-    response.body.nil? ? nil : JSON.parse(response.body)
+    response.body.nil? || response.body == '' ? nil : JSON.parse(response.body)
   end
 
   def post(path, body = nil, content_type: 'application/json')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: folio_api_client
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Eric O'Hanlon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -63,6 +63,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
+- LICENSE
 - README.md
 - Rakefile
 - lib/folio_api_client.rb
@@ -71,7 +72,8 @@ files:
 - lib/folio_api_client/finders.rb
 - lib/folio_api_client/version.rb
 homepage: https://www.github.com/cul/folio_api_client
-licenses: []
+licenses:
+- Apache-2.0
 metadata:
   homepage_uri: https://www.github.com/cul/folio_api_client
   source_code_uri: https://www.github.com/cul/folio_api_client