dor-services-client 15.11.0 → 15.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18ff6ef4f51e40372f52681a6bbe257c347ab020e3512dd8d64b8b760c757a3b
-  data.tar.gz: 76eb8acbc819956390a0b60b20d88ffd62fdf698430d4b9c469daaea0b2160c9
+  metadata.gz: 565b25455d31d878a49e800e34b6b3b096322762300a7042ae677ed650ff21a5
+  data.tar.gz: 8c9f6acc0a76f4ac7da4b3190a3e1d4e5e349ccc9678d487f23fa3ee237e3d65
 SHA512:
-  metadata.gz: d5639ed16ce0185cc344ae98459593e91bf2286223500a182242e51820041021f8ac8b2685935a0213d842084e9a955b7bc482c03e639b6568768c3f128dc318
-  data.tar.gz: 14256c492c36a3c03975a00393325541e6a65896ee49ef2e0bfba40f283dd1e3bc56c36cd0f398b6a3851552d875f4e7edf5d5f916389fe6ccbf06c75d1915c1
+  metadata.gz: 94e719800898ca73d2028dd144a184e7ca98b5958b421846a8380bd176b7f5eef64e921e0cc3f973ed62b7607e29e801dfa64fc771d19d995cb7d00dec01f84a
+  data.tar.gz: 337a076d2a17c2eb7201fc7f038f53018582f26c22fdbbfd61caf05268e382e8911e6aafaa8f20aaa9c64aafcf3681fc84ce0efbb2dc31174b89c9c5ad10ec23

data/Gemfile.lock

@@ -1,12 +1,13 @@
 PATH
   remote: .
   specs:
-    dor-services-client (15.11.0)
+    dor-services-client (15.13.0)
       activesupport (>= 7.0.0)
-      cocina-models (~> 0.103.2)
+      cocina-models (~> 0.104.1)
       deprecation
       faraday (~> 2.0)
       faraday-retry
+      nokogiri
       zeitwerk (~> 2.1)
 
 GEM
@@ -31,9 +32,9 @@ GEM
     attr_extras (7.1.0)
     base64 (0.3.0)
     benchmark (0.4.1)
-    bigdecimal (3.2.1)
+    bigdecimal (3.2.2)
     byebug (12.0.0)
-    cocina-models (0.103.2)
+    cocina-models (0.104.1)
       activesupport
       deprecation
       dry-struct (~> 1.0)
@@ -72,7 +73,7 @@ GEM
       dry-types (~> 1.8, >= 1.8.2)
       ice_nine (~> 0.11)
       zeitwerk (~> 2.6)
-    dry-types (1.8.2)
+    dry-types (1.8.3)
       bigdecimal (~> 3.0)
       concurrent-ruby (~> 1.0)
       dry-core (~> 1.0)
@@ -87,9 +88,9 @@ GEM
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-net_http (3.4.0)
+    faraday-net_http (3.4.1)
       net-http (>= 0.5.0)
-    faraday-retry (2.3.1)
+    faraday-retry (2.3.2)
       faraday (~> 2.0)
     hashdiff (1.2.0)
     i18n (1.14.7)
@@ -139,7 +140,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.4)
-    rubocop (1.75.8)
+    rubocop (1.77.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -147,10 +148,10 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.45.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.1)
+    rubocop-ast (1.45.1)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-rspec (3.6.0)
@@ -164,7 +165,7 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
-    super_diff (0.15.0)
+    super_diff (0.16.0)
       attr_extras (>= 6.2.4)
       diff-lcs
       patience_diff

data/README.md

@@ -152,8 +152,23 @@ object_client.workspace.create(source: object_path_string)
 # Reindex
 object_client.reindex
 
+# List workflows
+object_client.workflows
+# Find workflow
+object_client.workflow('accessionWF').find
+# Create workflow
+object_client.workflow('etdSubmitWF').create(version: 2)
+
+# List milestones
+object_client.milestones.list
+# Get the date for a milestone
+object_client.milestones.date(milestone_name: 'published')
+
 # Search for administrative tags:
 Dor::Services::Client.administrative_tags.search(q: 'Project')
+
+# Get a list of workflow templates
+Dor::Services::Client.workflows.templates
 ```
 
 ## Asynchronous results

data/dor-services-client.gemspec

@@ -25,10 +25,11 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 3.0', '< 4'
 
   spec.add_dependency 'activesupport', '>= 7.0.0'
-  spec.add_dependency 'cocina-models', '~> 0.103.2'
+  spec.add_dependency 'cocina-models', '~> 0.104.1'
   spec.add_dependency 'deprecation', '>= 0'
   spec.add_dependency 'faraday', '~> 2.0'
   spec.add_dependency 'faraday-retry'
+  spec.add_dependency 'nokogiri'
   spec.add_dependency 'zeitwerk', '~> 2.1'
 
   spec.add_development_dependency 'bundler'

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    class Client
+      # API calls around milestones
+      class Milestones < VersionedService
+        # @param object_identifier [String] the druid for the object
+        def initialize(connection:, version:, object_identifier:)
+          super(connection: connection, version: version)
+          @object_identifier = object_identifier
+        end
+
+        # Returns the Date for a requested milestone from workflow lifecycle
+        #
+        # @param [String] druid object id
+        # @param [String] milestone_name the name of the milestone being queried for
+        # @param [Number] version (nil) the version to query for
+        # @param [Boolean] active_only (false) if true, return only lifecycle steps for versions that have all processes complete
+        # @return [Time] when the milestone was achieved.  Returns nil if the milestone does not exist
+        def date(milestone_name:, version: nil, active_only: false)
+          filter_milestone(query_lifecycle(version: version, active_only: active_only), milestone_name)
+        end
+
+        # @return [Array<Hash>]
+        def list
+          doc = query_lifecycle(active_only: false)
+          doc.xpath('//lifecycle/milestone').collect do |node|
+            { milestone: node.text, at: Time.parse(node['date']), version: node['version'] }
+          end
+        end
+
+        private
+
+        attr_reader :object_identifier
+
+        def filter_milestone(lifecycle_doc, milestone_name)
+          milestone = lifecycle_doc.at_xpath("//lifecycle/milestone[text() = '#{milestone_name}']")
+          return unless milestone
+
+          Time.parse(milestone['date'])
+        end
+
+        # @param [String] druid object id
+        # @param [Boolean] active_only (false) if true, return only lifecycle steps for versions that have all processes complete
+        # @param [Number] version the version to query for
+        # @return [Nokogiri::XML::Document]
+        # @example An example lifecycle xml from the workflow service.
+        #   <lifecycle objectId="druid:ct011cv6501">
+        #     <milestone date="2010-04-27T11:34:17-0700">registered</milestone>
+        #     <milestone date="2010-04-29T10:12:51-0700">inprocess</milestone>
+        #     <milestone date="2010-06-15T16:08:58-0700">released</milestone>
+        #   </lifecycle>
+        #
+        def query_lifecycle(active_only:, version: nil)
+          resp = connection.get do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/lifecycles"
+            req.headers['Accept'] = 'application/xml'
+            req.params['version'] = version if version
+            req.params['active-only'] = 'true' if active_only
+          end
+          raise_exception_based_on_response!(resp) unless resp.success?
+
+          Nokogiri::XML(resp.body)
+        end
+      end
+    end
+  end
+end

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

@@ -46,6 +46,18 @@ module Dor
           @accession ||= Accession.new(**parent_params.merge(params))
         end
 
+        def milestones
+          @milestones ||= Milestones.new(**parent_params)
+        end
+
+        def workflows
+          @workflows ||= ObjectWorkflows.new(**parent_params).list
+        end
+
+        def workflow(workflow_name)
+          @workflow ||= ObjectWorkflow.new(**parent_params.merge({ workflow_name: workflow_name }))
+        end
+
         # Retrieves the Cocina model
         # @param [boolean] validate validate the response object
         # @raise [NotFoundResponse] when the response is a 404 (object not found)

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    class Client
+      # API calls around workflow for an object.
+      class ObjectWorkflow < VersionedService
+        # @param object_identifier [String] the druid for the object
+        # @param [String] workflow_name The name of the workflow
+        def initialize(connection:, version:, object_identifier:, workflow_name:)
+          super(connection: connection, version: version)
+          @object_identifier = object_identifier
+          @workflow_name = workflow_name
+        end
+
+        # @return [Workflow::Response::Workflow]
+        def find
+          resp = connection.get do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}"
+            req.headers['Accept'] = 'application/xml'
+          end
+          raise_exception_based_on_response!(resp) unless resp.success?
+
+          Dor::Services::Response::Workflow.new(xml: Nokogiri::XML(resp.body))
+        end
+
+        # Creates a workflow for a given object in the repository.  If this particular workflow for this objects exists,
+        # it will replace the old workflow.
+        # @param [Integer] version
+        # @param [String] lane_id adds laneId attribute to all process elements in the wf_xml workflow xml.  Defaults to a value of 'default'
+        # @param [Hash] context optional context to be included in the workflow (same for all processes for a given druid/version pair)
+        def create(version:, lane_id: 'default', context: nil) # rubocop:disable Metrics/AbcSize
+          resp = connection.post do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}"
+            req.params['version'] = version
+            req.params['lane-id'] = lane_id
+            req.headers['Content-Type'] = 'application/json'
+            req.body = { context: context }.to_json if context
+          end
+          raise_exception_based_on_response!(resp) unless resp.success?
+        end
+
+        private
+
+        attr_reader :object_identifier, :workflow_name
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    class Client
+      # API calls around workflows for an object.
+      class ObjectWorkflows < VersionedService
+        # @param object_identifier [String] the druid for the object
+        def initialize(connection:, version:, object_identifier:)
+          super(connection: connection, version: version)
+          @object_identifier = object_identifier
+        end
+
+        # Retrieves all workflows for the given object
+        # @return [Dor::Services::Response::Workflows]
+        def list
+          resp = connection.get do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/workflows"
+            req.headers['Accept'] = 'application/xml'
+          end
+          raise_exception_based_on_response!(resp) unless resp.success?
+
+          Dor::Services::Response::Workflows.new(xml: Nokogiri::XML(resp.body))
+        end
+
+        private
+
+        attr_reader :object_identifier
+      end
+    end
+  end
+end

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

@@ -3,7 +3,7 @@
 module Dor
   module Services
     class Client
-      VERSION = '15.11.0'
+      VERSION = '15.13.0'
     end
   end
 end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    class Client
+      # API calls around workflows in DOR
+      class Workflows < VersionedService
+        # Retrieves a list of workflow template name
+        # @return [Array<String>] the list of templates
+        def templates
+          resp = connection.post do |req|
+            req.url "#{api_version}/workflow_templates"
+            req.headers['Content-Type'] = 'application/json'
+            req.headers['Accept'] = 'application/json'
+          end
+          raise_exception_based_on_response!(resp) unless resp.success?
+
+          JSON.parse(resp.body)
+        end
+      end
+    end
+  end
+end

data/lib/dor/services/client.rb

@@ -10,6 +10,7 @@ require 'active_support/json'
 require 'cocina/models'
 require 'faraday'
 require 'faraday/retry'
+require 'nokogiri'
 require 'singleton'
 require 'zeitwerk'
 
@@ -116,6 +117,11 @@ module Dor
         @background_job_results ||= BackgroundJobResults.new(connection: connection, version: DEFAULT_VERSION)
       end
 
+      # @return [Dor::Services::Client::Workflows] an instance of the `Client::Workflows` class
+      def workflows
+        @workflows ||= Workflows.new(connection: connection, version: DEFAULT_VERSION)
+      end
+
       class << self
         # @param [String] url the base url of the endpoint the client should connect to (required)
         # @param [String] token a bearer token for HTTP authentication (required)
@@ -133,7 +139,7 @@ module Dor
           self
         end
 
-        delegate :background_job_results, :objects, :object, :virtual_objects, :administrative_tags, to: :instance
+        delegate :background_job_results, :objects, :object, :virtual_objects, :administrative_tags, :workflows, to: :instance
       end
 
       attr_writer :url, :token, :connection, :enable_get_retries, :logger

data/lib/dor/services/response/process.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    module Response
+      # Represents the status of an object doing a workflow process
+      class Process
+        # @params [Workflow] parent
+        # @params [Hash] attributes
+        def initialize(parent:, **attributes)
+          @parent = parent
+          @attributes = attributes
+        end
+
+        def name
+          @attributes[:name].presence
+        end
+
+        def status
+          @attributes[:status].presence
+        end
+
+        def datetime
+          @attributes[:datetime].presence
+        end
+
+        def elapsed
+          @attributes[:elapsed].presence
+        end
+
+        def attempts
+          @attributes[:attempts].presence
+        end
+
+        def lifecycle
+          @attributes[:lifecycle].presence
+        end
+
+        def note
+          @attributes[:note].presence
+        end
+
+        def error_message
+          @attributes[:errorMessage].presence
+        end
+
+        def lane_id
+          @attributes[:laneId].presence
+        end
+
+        # @return [Hash] the context for the process (or empty hash if none present)
+        def context
+          return {} unless @attributes[:context].present?
+
+          JSON.parse(@attributes[:context])
+        end
+
+        delegate :pid, :workflow_name, to: :parent
+
+        private
+
+        attr_reader :parent
+      end
+    end
+  end
+end

data/lib/dor/services/response/workflow.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    module Response
+      # The response from asking the server about a workflow for an item
+      class Workflow
+        def initialize(xml:)
+          @xml = xml
+        end
+
+        def pid
+          workflow['objectId']
+        end
+
+        def workflow_name
+          workflow['id']
+        end
+
+        # Check if there are any processes for the provided version.
+        # @param [Integer] version the version we are checking for.
+        def active_for?(version:)
+          result = ng_xml.at_xpath("/workflow/process[@version=#{version}]")
+          result ? true : false
+        end
+
+        # Returns the process, for the most recent version that matches the given name:
+        def process_for_recent_version(name:)
+          nodes = process_nodes_for(name: name)
+          node = nodes.max { |a, b| a.attr('version').to_i <=> b.attr('version').to_i }
+          to_process(node)
+        end
+
+        def empty?
+          ng_xml.xpath('/workflow/process').empty?
+        end
+
+        # Check if all processes are skipped or complete for the provided version.
+        # @param [Integer] version the version we are checking for.
+        def complete_for?(version:)
+          # ng_xml.xpath("/workflow/process[@version=#{version}]/@status").map(&:value).all? { |p| %w[skipped completed].include?(p) }
+          incomplete_processes_for(version: version).empty?
+        end
+
+        def complete?
+          complete_for?(version: version)
+        end
+
+        def incomplete_processes_for(version:)
+          process_nodes = ng_xml.xpath("/workflow/process[@version=#{version}]")
+          incomplete_process_nodes = process_nodes.reject { |process_node| %w[skipped completed].include?(process_node.attr('status')) }
+          incomplete_process_nodes.map { |process_node| to_process(process_node) }
+        end
+
+        def incomplete_processes
+          incomplete_processes_for(version: version)
+        end
+
+        attr_reader :xml
+
+        private
+
+        # Return the max version in this workflow document
+        def version
+          ng_xml.xpath('/workflow/process/@version').map { |attr| attr.value.to_i }.max
+        end
+
+        def workflow
+          ng_xml.at_xpath('workflow')
+        end
+
+        def process_nodes_for(name:)
+          ng_xml.xpath("/workflow/process[@name = '#{name}']")
+        end
+
+        def ng_xml
+          @ng_xml ||= Nokogiri::XML(@xml)
+        end
+
+        def to_process(node)
+          attributes = node ? node.attributes.to_h { |k, v| [k.to_sym, v.value] } : {}
+          Process.new(parent: self, **attributes)
+        end
+      end
+    end
+  end
+end

data/lib/dor/services/response/workflows.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    module Response
+      # The response from asking the server about all workflows for an item
+      class Workflows
+        def initialize(xml:)
+          @xml = xml
+        end
+
+        def pid
+          ng_xml.at_xpath('/workflows/@objectId').text
+        end
+
+        def workflows
+          @workflows ||= ng_xml.xpath('/workflows/workflow').map do |node|
+            Workflow.new(xml: node.to_xml)
+          end
+        end
+
+        # @return [Array<String>] returns a list of errors for any process for the current version
+        def errors_for(version:)
+          ng_xml.xpath("//workflow/process[@version='#{version}' and @status='error']/@errorMessage")
+                .map(&:text)
+        end
+
+        attr_reader :xml
+
+        private
+
+        def ng_xml
+          @ng_xml ||= Nokogiri::XML(@xml)
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dor-services-client
 version: !ruby/object:Gem::Version
-  version: 15.11.0
+  version: 15.13.0
 platform: ruby
 authors:
 - Justin Coyne
 - Michael Giarlo
 bindir: exe
 cert_chain: []
-date: 2025-06-05 00:00:00.000000000 Z
+date: 2025-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.103.2
+        version: 0.104.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.103.2
+        version: 0.104.1
 - !ruby/object:Gem::Dependency
   name: deprecation
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -237,9 +251,12 @@ files:
 - lib/dor/services/client/error_faraday_middleware.rb
 - lib/dor/services/client/events.rb
 - lib/dor/services/client/members.rb
+- lib/dor/services/client/milestones.rb
 - lib/dor/services/client/mutate.rb
 - lib/dor/services/client/object.rb
 - lib/dor/services/client/object_version.rb
+- lib/dor/services/client/object_workflow.rb
+- lib/dor/services/client/object_workflows.rb
 - lib/dor/services/client/objects.rb
 - lib/dor/services/client/release_tag.rb
 - lib/dor/services/client/release_tags.rb
@@ -248,7 +265,11 @@ files:
 - lib/dor/services/client/version.rb
 - lib/dor/services/client/versioned_service.rb
 - lib/dor/services/client/virtual_objects.rb
+- lib/dor/services/client/workflows.rb
 - lib/dor/services/client/workspace.rb
+- lib/dor/services/response/process.rb
+- lib/dor/services/response/workflow.rb
+- lib/dor/services/response/workflows.rb
 homepage: https://github.com/sul-dlss/dor-services-client
 licenses: []
 metadata:
@@ -270,7 +291,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A client for dor-services-app
 test_files: []