clara-temporalio 0.4.3

data/lib/temporalio/worker_deployment_version.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'temporalio/internal/bridge/worker'
+
+module Temporalio
+  WorkerDeploymentVersion = Data.define(
+    :deployment_name,
+    :build_id
+  )
+
+  # Represents the version of a specific worker deployment.
+  #
+  # WARNING: Experimental API.
+  class WorkerDeploymentVersion
+    # Parse a version from a canonical string, which must be in the format
+    # `<deployment_name>.<build_id>`. Deployment name must not have a `.` in it.
+    #
+    # @param canonical [String] The canonical string representation of the version.
+    # @return [WorkerDeploymentVersion] The parsed version.
+    def self.from_canonical_string(canonical)
+      parts = canonical.split('.', 2)
+      if parts.length != 2
+        raise ArgumentError,
+              "Cannot parse version string: #{canonical}, must be in format <deployment_name>.<build_id>"
+      end
+      new(deployment_name: parts[0], build_id: parts[1])
+    end
+
+    # @!visibility private
+    def self._from_bridge(bridge)
+      return nil if bridge.nil?
+
+      new(deployment_name: bridge.deployment_name, build_id: bridge.build_id)
+    end
+
+    # Create WorkerDeploymentVersion.
+    #
+    # @param deployment_name [String] The name of the deployment.
+    # @param build_id [String] The build identifier specific to this worker build.
+    def initialize(deployment_name:, build_id:) # rubocop:disable Lint/UselessMethodDefinition
+      super
+    end
+
+    # Returns the canonical string representation of the version.
+    #
+    # @return [String]
+    def to_canonical_string
+      "#{deployment_name}.#{build_id}"
+    end
+
+    # @!visibility private
+    def _to_bridge_options
+      Internal::Bridge::Worker::WorkerDeploymentVersion.new(
+        deployment_name: deployment_name,
+        build_id: build_id
+      )
+    end
+
+    # @!visibility private
+    def _to_proto
+      Api::Deployment::V1::WorkerDeploymentVersion.new(
+        deployment_name: deployment_name,
+        build_id: build_id
+      )
+    end
+  end
+end

data/lib/temporalio/workflow/activity_cancellation_type.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'temporalio/internal/bridge/api'
+
+module Temporalio
+  module Workflow
+    # Cancellation types for activities.
+    module ActivityCancellationType
+      # Initiate a cancellation request and immediately report cancellation to the workflow.
+      TRY_CANCEL = Internal::Bridge::Api::WorkflowCommands::ActivityCancellationType::TRY_CANCEL
+      # Wait for activity cancellation completion. Note that activity must heartbeat to receive a cancellation
+      # notification. This can block the cancellation for a long time if activity doesn't heartbeat or chooses to ignore
+      # the cancellation request.
+      WAIT_CANCELLATION_COMPLETED =
+        Internal::Bridge::Api::WorkflowCommands::ActivityCancellationType::WAIT_CANCELLATION_COMPLETED
+      # Do not request cancellation of the activity and immediately report cancellation to the workflow.
+      ABANDON = Internal::Bridge::Api::WorkflowCommands::ActivityCancellationType::ABANDON
+    end
+  end
+end

data/lib/temporalio/workflow/child_workflow_cancellation_type.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'temporalio/internal/bridge/api'
+
+module Temporalio
+  module Workflow
+    # Cancellation types for child workflows.
+    module ChildWorkflowCancellationType
+      # Do not request cancellation of the child workflow if already scheduled.
+      ABANDON = Internal::Bridge::Api::ChildWorkflow::ChildWorkflowCancellationType::ABANDON
+      # Initiate a cancellation request and immediately report cancellation to the parent.
+      TRY_CANCEL = Internal::Bridge::Api::ChildWorkflow::ChildWorkflowCancellationType::TRY_CANCEL
+      # Wait for child cancellation completion.
+      WAIT_CANCELLATION_COMPLETED =
+        Internal::Bridge::Api::ChildWorkflow::ChildWorkflowCancellationType::WAIT_CANCELLATION_COMPLETED
+      # Request cancellation of the child and wait for confirmation that the request was received.
+      WAIT_CANCELLATION_REQUESTED =
+        Internal::Bridge::Api::ChildWorkflow::ChildWorkflowCancellationType::WAIT_CANCELLATION_REQUESTED
+    end
+  end
+end

data/lib/temporalio/workflow/child_workflow_handle.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Temporalio
+  module Workflow
+    # Handle for interacting with a child workflow.
+    #
+    # This is created via {Workflow.start_child_workflow}, it is never instantiated directly.
+    class ChildWorkflowHandle
+      # @!visibility private
+      def initialize
+        raise NotImplementedError, 'Cannot instantiate a child handle directly'
+      end
+
+      # @return [String] ID for the workflow.
+      def id
+        raise NotImplementedError
+      end
+
+      # @return [String] Run ID for the workflow.
+      def first_execution_run_id
+        raise NotImplementedError
+      end
+
+      # Wait for the result.
+      #
+      # @return [Object] Result of the child workflow.
+      #
+      # @raise [Error::ChildWorkflowError] Workflow failed with +cause+ as the cause.
+      def result
+        raise NotImplementedError
+      end
+
+      # Signal the child workflow.
+      #
+      # @param signal [Workflow::Definition::Signal, Symbol, String] Signal definition or name.
+      # @param args [Array<Object>] Signal args.
+      # @param cancellation [Cancellation] Cancellation for canceling the signalling.
+      def signal(signal, *args, cancellation: Workflow.cancellation)
+        raise NotImplementedError
+      end
+    end
+  end
+end