temporalio 1.5.0 → 1.6.0

data/sig/temporalio/testing/workflow_environment.rbs

@@ -0,0 +1,141 @@
+module Temporalio
+  module Testing
+    class WorkflowEnvironment
+      attr_reader client: Client
+
+      def self.start_local: (
+        ?namespace: String,
+        ?data_converter: Converters::DataConverter,
+        ?interceptors: Array[Client::Interceptor],
+        ?logger: Logger,
+        ?default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        ?ip: String,
+        ?port: Integer?,
+        ?ui: bool,
+        ?ui_port: Integer?,
+        ?search_attributes: Array[SearchAttributes::Key],
+        ?runtime: Runtime,
+        ?dev_server_existing_path: String?,
+        ?dev_server_database_filename: String?,
+        ?dev_server_log_format: String,
+        ?dev_server_log_level: String,
+        ?dev_server_download_version: String,
+        ?dev_server_download_dest_dir: String?,
+        ?dev_server_extra_args: Array[String],
+        ?dev_server_download_ttl: Float?
+      ) -> WorkflowEnvironment
+      | [T] (
+        ?namespace: String,
+        ?data_converter: Converters::DataConverter,
+        ?interceptors: Array[Client::Interceptor],
+        ?logger: Logger,
+        ?default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        ?ip: String,
+        ?port: Integer?,
+        ?ui: bool,
+        ?ui_port: Integer?,
+        ?search_attributes: Array[SearchAttributes::Key],
+        ?runtime: Runtime,
+        ?dev_server_existing_path: String?,
+        ?dev_server_database_filename: String?,
+        ?dev_server_log_format: String,
+        ?dev_server_log_level: String,
+        ?dev_server_download_version: String,
+        ?dev_server_download_dest_dir: String?,
+        ?dev_server_extra_args: Array[String],
+        ?dev_server_download_ttl: Float?
+      ) { (WorkflowEnvironment) -> T } -> T
+
+      def self.start_time_skipping: (
+        ?data_converter: Converters::DataConverter,
+        ?interceptors: Array[Client::Interceptor],
+        ?logger: Logger,
+        ?default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        ?port: Integer?,
+        ?runtime: Runtime,
+        ?test_server_existing_path: String?,
+        ?test_server_download_version: String,
+        ?test_server_download_dest_dir: String?,
+        ?test_server_extra_args: Array[String],
+        ?test_server_download_ttl: Float?
+      ) -> WorkflowEnvironment
+      | [T] (
+        ?data_converter: Converters::DataConverter,
+        ?interceptors: Array[Client::Interceptor],
+        ?logger: Logger,
+        ?default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        ?port: Integer?,
+        ?runtime: Runtime,
+        ?test_server_existing_path: String?,
+        ?test_server_download_version: String,
+        ?test_server_download_dest_dir: String?,
+        ?test_server_extra_args: Array[String],
+        ?test_server_download_ttl: Float?
+      ) { (WorkflowEnvironment) -> T } -> T
+
+      def self._with_core_server: (
+        core_server: Internal::Bridge::Testing::EphemeralServer,
+        namespace: String,
+        data_converter: Converters::DataConverter,
+        interceptors: Array[Client::Interceptor],
+        logger: Logger,
+        default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        runtime: Runtime,
+        supports_time_skipping: bool
+      ) -> WorkflowEnvironment
+      | [T] (
+        core_server: Internal::Bridge::Testing::EphemeralServer,
+        namespace: String,
+        data_converter: Converters::DataConverter,
+        interceptors: Array[Client::Interceptor],
+        logger: Logger,
+        default_workflow_query_reject_condition: Client::WorkflowQueryRejectCondition::enum?,
+        runtime: Runtime,
+        supports_time_skipping: bool
+      ) { (WorkflowEnvironment) -> T } -> T
+
+      def initialize: (Client client) -> void
+
+      def shutdown: -> void
+
+      def supports_time_skipping?: -> bool
+
+      def sleep: (duration duration) -> void
+
+      def current_time: -> Time
+
+      def create_nexus_endpoint: (name: String, task_queue: String) -> Api::Nexus::V1::Endpoint
+
+      def delete_nexus_endpoint: (Api::Nexus::V1::Endpoint endpoint) -> nil
+
+      def auto_time_skipping_disabled: [T] { -> T } -> T
+
+      class Ephemeral < WorkflowEnvironment
+        def initialize: (
+          Client client,
+          Internal::Bridge::Testing::EphemeralServer core_server,
+          supports_time_skipping: bool
+        ) -> void
+
+        def time_skipping_unlocked: [T] { -> T } -> T
+      end
+
+      class TimeSkippingClientInterceptor
+        include Client::Interceptor
+
+        def initialize: (WorkflowEnvironment env) -> void
+
+        class Outbound < Client::Interceptor::Outbound
+          def initialize: (
+            Client::Interceptor::Outbound next_interceptor,
+            WorkflowEnvironment env
+          ) -> void
+        end
+
+        class TimeSkippingWorkflowHandle < Client::WorkflowHandle
+          def initialize: (Client::WorkflowHandle handle, WorkflowEnvironment env) -> void
+        end
+      end
+    end
+  end
+end

data/sig/temporalio/testing.rbs

@@ -0,0 +1,4 @@
+module Temporalio
+  module Testing
+  end
+end

data/sig/temporalio/version.rbs

@@ -0,0 +1,3 @@
+module Temporalio
+  VERSION: String
+end

data/sig/temporalio/versioning_override.rbs

@@ -0,0 +1,17 @@
+module Temporalio
+  class VersioningOverride
+    def _to_proto: -> Api::Workflow::V1::VersioningOverride
+
+    class Pinned < VersioningOverride
+        attr_reader version: WorkerDeploymentVersion
+
+        def initialize: (WorkerDeploymentVersion version) -> void
+        def _to_proto: -> Api::Workflow::V1::VersioningOverride
+    end
+
+    class AutoUpgrade < VersioningOverride
+        def initialize: -> void
+        def _to_proto: -> Api::Workflow::V1::VersioningOverride
+    end
+  end
+end

data/sig/temporalio/worker/activity_executor/fiber.rbs

@@ -0,0 +1,9 @@
+module Temporalio
+  class Worker
+    class ActivityExecutor
+      class Fiber < ActivityExecutor
+        def self.default: -> Fiber
+      end
+    end
+  end
+end

data/sig/temporalio/worker/activity_executor/thread_pool.rbs

@@ -0,0 +1,11 @@
+module Temporalio
+  class Worker
+    class ActivityExecutor
+      class ThreadPool < ActivityExecutor
+        def self.default: -> ThreadPool
+
+        def initialize: (?ThreadPool thread_poll) -> void
+      end
+    end
+  end
+end

data/sig/temporalio/worker/activity_executor.rbs

@@ -0,0 +1,12 @@
+module Temporalio
+  class Worker
+    class ActivityExecutor
+      def self.defaults: -> Hash[Symbol, ActivityExecutor]
+
+      def initialize_activity: (Activity::Definition::Info defn) -> void
+      def execute_activity: (Activity::Definition::Info defn) { -> void } -> void
+      def activity_context: -> Activity::Context?
+      def set_activity_context: (Activity::Definition::Info defn, Activity::Context? context) -> void
+    end
+  end
+end

data/sig/temporalio/worker/deployment_options.rbs

@@ -0,0 +1,17 @@
+module Temporalio
+  class Worker
+    class DeploymentOptions
+      attr_reader version: WorkerDeploymentVersion
+      attr_reader use_worker_versioning: bool
+      attr_reader default_versioning_behavior: VersioningBehavior::enum
+
+      def initialize: (
+        version: WorkerDeploymentVersion,
+        ?use_worker_versioning: bool,
+        ?default_versioning_behavior: VersioningBehavior::enum
+      ) -> void
+
+      def _to_bridge_options: -> Internal::Bridge::Worker::DeploymentOptions
+    end
+  end
+end

data/sig/temporalio/worker/illegal_workflow_call_validator.rbs

@@ -0,0 +1,25 @@
+module Temporalio
+  class Worker
+    class IllegalWorkflowCallValidator
+      class CallInfo
+        attr_reader class_name: String
+        attr_reader method_name: Symbol
+        attr_reader trace_point: TracePoint
+
+        def initialize: (
+          class_name: String,
+          method_name: Symbol,
+          trace_point: TracePoint
+        ) -> void
+      end
+
+      def self.default_time_validators: -> Array[IllegalWorkflowCallValidator]
+      def self.known_safe_mutex_validator: -> IllegalWorkflowCallValidator
+
+      attr_reader method_name: Symbol?
+      attr_reader block: ^(CallInfo) -> void
+
+      def initialize: (?method_name: Symbol?) { (CallInfo) -> void } -> void
+    end
+  end
+end

data/sig/temporalio/worker/interceptor.rbs

@@ -0,0 +1,373 @@
+module Temporalio
+  class Worker
+    module Interceptor
+      module Activity
+        def intercept_activity: (Inbound next_interceptor) -> Inbound
+
+        class ExecuteInput
+          attr_reader proc: Proc
+          attr_reader args: Array[Object?]
+          attr_reader arg_hints: Array[Object]?
+          attr_reader result_hint: Object?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            proc: Proc,
+            args: Array[Object?],
+            result_hint: Object?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class Inbound
+          attr_reader next_interceptor: Inbound
+
+          def initialize: (Inbound next_interceptor) -> void
+
+          def init: (Outbound outbound) -> Outbound
+
+          def execute: (ExecuteInput input) -> Object?
+        end
+
+        class HeartbeatInput
+          attr_reader details: Array[Object?]
+          attr_reader detail_hints: Array[Object]?
+
+          def initialize: (details: Array[Object?], detail_hints: Array[Object]?) -> void
+        end
+
+        class Outbound
+          attr_reader next_interceptor: Outbound
+
+          def initialize: (Outbound next_interceptor) -> void
+
+          def heartbeat: (HeartbeatInput input) -> void
+        end
+      end
+
+      module Workflow
+        def intercept_workflow: (Inbound next_interceptor) -> Inbound
+
+        class ExecuteInput
+          attr_reader args: Array[Object?]
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            args: Array[Object?],
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class HandleSignalInput
+          attr_reader signal: String
+          attr_reader args: Array[Object?]
+          attr_reader definition: Temporalio::Workflow::Definition::Signal
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            signal: String,
+            args: Array[Object?],
+            definition: Temporalio::Workflow::Definition::Signal,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class HandleQueryInput
+          attr_reader id: String
+          attr_reader query: String
+          attr_reader args: Array[Object?]
+          attr_reader definition: Temporalio::Workflow::Definition::Query
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            id: String,
+            query: String,
+            args: Array[Object?],
+            definition: Temporalio::Workflow::Definition::Query,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class HandleUpdateInput
+          attr_reader id: String
+          attr_reader update: String
+          attr_reader args: Array[Object?]
+          attr_reader definition: Temporalio::Workflow::Definition::Update
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            id: String,
+            update: String,
+            args: Array[Object?],
+            definition: Temporalio::Workflow::Definition::Update,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class Inbound
+          attr_reader next_interceptor: Inbound
+
+          def initialize: (Inbound next_interceptor) -> void
+
+          def init: (Outbound outbound) -> Outbound
+
+          def execute: (ExecuteInput input) -> Object?
+
+          def handle_signal: (HandleSignalInput input) -> void
+
+          def handle_query: (HandleQueryInput input) -> Object?
+
+          def validate_update: (HandleUpdateInput input) -> void
+
+          def handle_update: (HandleUpdateInput input) -> Object?
+        end
+
+        class CancelExternalWorkflowInput
+          attr_reader id: String
+          attr_reader run_id: String?
+
+          def initialize: (
+            id: String,
+            run_id: String?
+          ) -> void
+        end
+
+        class ExecuteActivityInput
+          attr_reader activity: String
+          attr_reader args: Array[Object?]
+          attr_reader task_queue: String
+          attr_reader summary: String?
+          attr_reader schedule_to_close_timeout: duration?
+          attr_reader schedule_to_start_timeout: duration?
+          attr_reader start_to_close_timeout: duration?
+          attr_reader heartbeat_timeout: duration?
+          attr_reader retry_policy: RetryPolicy?
+          attr_reader cancellation: Cancellation
+          attr_reader cancellation_type: Temporalio::Workflow::ActivityCancellationType::enum
+          attr_reader activity_id: String?
+          attr_reader disable_eager_execution: bool
+          attr_reader priority: Temporalio::Priority
+          attr_reader arg_hints: Array[Object]?
+          attr_reader result_hint: Object?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            activity: String,
+            args: Array[Object?],
+            task_queue: String,
+            summary: String?,
+            schedule_to_close_timeout: duration?,
+            schedule_to_start_timeout: duration?,
+            start_to_close_timeout: duration?,
+            heartbeat_timeout: duration?,
+            retry_policy: RetryPolicy?,
+            cancellation: Cancellation,
+            cancellation_type: Temporalio::Workflow::ActivityCancellationType::enum,
+            activity_id: String?,
+            disable_eager_execution: bool,
+            priority: Temporalio::Priority,
+            arg_hints: Array[Object]?,
+            result_hint: Object?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class ExecuteLocalActivityInput
+          attr_reader activity: String
+          attr_reader args: Array[Object?]
+          attr_reader summary: String?
+          attr_reader schedule_to_close_timeout: duration?
+          attr_reader schedule_to_start_timeout: duration?
+          attr_reader start_to_close_timeout: duration?
+          attr_reader retry_policy: RetryPolicy?
+          attr_reader local_retry_threshold: duration?
+          attr_reader cancellation: Cancellation
+          attr_reader cancellation_type: Temporalio::Workflow::ActivityCancellationType::enum
+          attr_reader activity_id: String?
+          attr_reader arg_hints: Array[Object]?
+          attr_reader result_hint: Object?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            activity: String,
+            args: Array[Object?],
+            summary: String?,
+            schedule_to_close_timeout: duration?,
+            schedule_to_start_timeout: duration?,
+            start_to_close_timeout: duration?,
+            retry_policy: RetryPolicy?,
+            local_retry_threshold: duration?,
+            cancellation: Cancellation,
+            cancellation_type: Temporalio::Workflow::ActivityCancellationType::enum,
+            activity_id: String?,
+            arg_hints: Array[Object]?,
+            result_hint: Object?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class InitializeContinueAsNewErrorInput
+          attr_reader error: Temporalio::Workflow::ContinueAsNewError
+
+          def initialize: (
+            error: Temporalio::Workflow::ContinueAsNewError
+          ) -> void
+        end
+
+        class SignalChildWorkflowInput
+          attr_reader id: String
+          attr_reader signal: String
+          attr_reader args: Array[Object?]
+          attr_reader cancellation: Cancellation
+          attr_reader arg_hints: Array[Object]?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            id: String,
+            signal: String,
+            args: Array[Object?],
+            cancellation: Cancellation,
+            arg_hints: Array[Object]?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class SignalExternalWorkflowInput
+          attr_reader id: String
+          attr_reader run_id: String?
+          attr_reader signal: String
+          attr_reader args: Array[Object?]
+          attr_reader cancellation: Cancellation
+          attr_reader arg_hints: Array[Object]?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            id: String,
+            run_id: String?,
+            signal: String,
+            args: Array[Object?],
+            cancellation: Cancellation,
+            arg_hints: Array[Object]?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class SleepInput
+          attr_reader duration: duration?
+          attr_reader summary: String?
+          attr_reader cancellation: Cancellation
+
+          def initialize: (
+            duration: duration?,
+            summary: String?,
+            cancellation: Cancellation
+          ) -> void
+        end
+
+        class StartChildWorkflowInput
+          attr_reader workflow: String
+          attr_reader args: Array[Object?]
+          attr_reader id: String
+          attr_reader task_queue: String
+          attr_reader static_summary: String?
+          attr_reader static_details: String?
+          attr_reader cancellation: Cancellation
+          attr_reader cancellation_type: Temporalio::Workflow::ChildWorkflowCancellationType::enum
+          attr_reader parent_close_policy: Temporalio::Workflow::ParentClosePolicy::enum
+          attr_reader execution_timeout: duration?
+          attr_reader run_timeout: duration?
+          attr_reader task_timeout: duration?
+          attr_reader id_reuse_policy: WorkflowIDReusePolicy::enum
+          attr_reader retry_policy: RetryPolicy?
+          attr_reader cron_schedule: String?
+          attr_reader memo: Hash[String | Symbol, Object?]?
+          attr_reader search_attributes: SearchAttributes?
+          attr_reader priority: Temporalio::Priority
+          attr_reader arg_hints: Array[Object]?
+          attr_reader result_hint: Object?
+          attr_reader headers: Hash[String, Object?]
+
+          def initialize: (
+            workflow: String,
+            args: Array[Object?],
+            id: String,
+            task_queue: String,
+            static_summary: String?,
+            static_details: String?,
+            cancellation: Cancellation,
+            cancellation_type: Temporalio::Workflow::ChildWorkflowCancellationType::enum,
+            parent_close_policy: Temporalio::Workflow::ParentClosePolicy::enum,
+            execution_timeout: duration?,
+            run_timeout: duration?,
+            task_timeout: duration?,
+            id_reuse_policy: WorkflowIDReusePolicy::enum,
+            retry_policy: RetryPolicy?,
+            cron_schedule: String?,
+            memo: Hash[String | Symbol, Object?]?,
+            search_attributes: SearchAttributes?,
+            priority: Temporalio::Priority,
+            arg_hints: Array[Object]?,
+            result_hint: Object?,
+            headers: Hash[String, Object?]
+          ) -> void
+        end
+
+        class StartNexusOperationInput
+          attr_reader endpoint: String
+          attr_reader service: String
+          attr_reader operation: String
+          attr_reader arg: Object?
+          attr_reader schedule_to_close_timeout: duration?
+          attr_reader schedule_to_start_timeout: duration?
+          attr_reader start_to_close_timeout: duration?
+          attr_reader cancellation_type: Temporalio::Workflow::NexusOperationCancellationType::enum
+          attr_reader summary: String?
+          attr_reader cancellation: Cancellation
+          attr_reader arg_hint: Object?
+          attr_reader result_hint: Object?
+          attr_reader headers: Hash[String, String]
+
+          def initialize: (
+            endpoint: String,
+            service: String,
+            operation: String,
+            arg: Object?,
+            schedule_to_close_timeout: duration?,
+            schedule_to_start_timeout: duration?,
+            start_to_close_timeout: duration?,
+            cancellation_type: Temporalio::Workflow::NexusOperationCancellationType::enum,
+            summary: String?,
+            cancellation: Cancellation,
+            arg_hint: Object?,
+            result_hint: Object?,
+            headers: Hash[String, String]
+          ) -> void
+        end
+
+        class Outbound
+          attr_reader next_interceptor: Outbound
+
+          def initialize: (Outbound next_interceptor) -> void
+
+          def cancel_external_workflow: (CancelExternalWorkflowInput input) -> void
+
+          def execute_activity: (ExecuteActivityInput input) -> Object?
+
+          def execute_local_activity: (ExecuteLocalActivityInput input) -> Object?
+
+          def initialize_continue_as_new_error: (InitializeContinueAsNewErrorInput input) -> void
+
+          def signal_child_workflow: (SignalChildWorkflowInput input) -> void
+
+          def signal_external_workflow: (SignalExternalWorkflowInput input) -> void
+
+          def sleep: (SleepInput input) -> void
+
+          def start_child_workflow: (StartChildWorkflowInput input) -> Temporalio::Workflow::ChildWorkflowHandle
+
+          def start_nexus_operation: (StartNexusOperationInput input) -> Temporalio::Workflow::NexusOperationHandle
+        end
+      end
+    end
+  end
+end

data/sig/temporalio/worker/plugin.rbs

@@ -0,0 +1,47 @@
+module Temporalio
+  class Worker
+    module Plugin
+      class RunWorkerOptions
+        attr_reader worker: Worker
+        attr_reader cancellation: Cancellation
+        attr_reader shutdown_signals: Array[String | Integer]
+        attr_reader raise_in_block_on_shutdown: Exception?
+
+        def initialize: (
+          worker: Worker,
+          cancellation: Cancellation,
+          shutdown_signals: Array[String | Integer],
+          raise_in_block_on_shutdown: Exception?
+        ) -> void
+
+        def with: (**untyped) -> RunWorkerOptions
+      end
+
+      class WithWorkflowReplayWorkerOptions
+        attr_reader worker: WorkflowReplayer::ReplayWorker
+
+        def initialize: (
+          worker: WorkflowReplayer::ReplayWorker
+        ) -> void
+
+        def with: (**untyped) -> WithWorkflowReplayWorkerOptions
+      end
+
+      def name: -> String
+
+      def configure_worker: (Options options) -> Options
+
+      def run_worker: (
+        RunWorkerOptions options,
+        ^(RunWorkerOptions) -> untyped next_call
+      ) -> untyped
+
+      def configure_workflow_replayer: (WorkflowReplayer::Options options) -> WorkflowReplayer::Options
+
+      def with_workflow_replay_worker: (
+        WithWorkflowReplayWorkerOptions options,
+        ^(WithWorkflowReplayWorkerOptions) -> untyped next_call
+      ) -> untyped
+    end
+  end
+end

data/sig/temporalio/worker/poller_behavior.rbs

@@ -0,0 +1,23 @@
+module Temporalio
+  class Worker
+    class PollerBehavior
+      def _to_bridge_options: -> untyped
+
+      class SimpleMaximum < PollerBehavior
+        attr_reader maximum: Integer
+
+        def initialize: (Integer) -> void
+        def _to_bridge_options: -> Internal::Bridge::Worker::PollerBehaviorSimpleMaximum
+      end
+
+      class Autoscaling < PollerBehavior
+        attr_reader minimum: Integer
+        attr_reader maximum: Integer
+        attr_reader initial: Integer
+
+        def initialize: (?minimum: Integer, ?maximum: Integer, ?initial: Integer) -> void
+        def _to_bridge_options: -> Internal::Bridge::Worker::PollerBehaviorAutoscaling
+      end
+    end
+  end
+end