From 3321a14cd3a881647613e4bf95cc89af75a676dd Mon Sep 17 00:00:00 2001 From: Dmitriy Derepko Date: Wed, 25 Mar 2026 09:06:25 +0400 Subject: [PATCH] chore: remove experimental/internal annotations from versioning-related classes and methods --- src/Client/GRPC/ServiceClient.php | 26 ------------------- src/Client/GRPC/ServiceClientInterface.php | 26 ------------------- src/Common/Versioning/VersioningBehavior.php | 2 -- src/Common/Versioning/VersioningOverride.php | 1 - .../Versioning/WorkerDeploymentVersion.php | 1 - src/Worker/WorkerDeploymentOptions.php | 2 -- src/Worker/WorkerOptions.php | 2 -- 7 files changed, 60 deletions(-) diff --git a/src/Client/GRPC/ServiceClient.php b/src/Client/GRPC/ServiceClient.php index 282d5102..70112f78 100644 --- a/src/Client/GRPC/ServiceClient.php +++ b/src/Client/GRPC/ServiceClient.php @@ -908,8 +908,6 @@ public function GetWorkerTaskReachability(V1\GetWorkerTaskReachabilityRequest $a /** * Describes a worker deployment. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `DescribeWorkerDeploymentVersion`. * * @throws ServiceClientException @@ -921,8 +919,6 @@ public function DescribeDeployment(V1\DescribeDeploymentRequest $arg, ?ContextIn /** * Describes a worker deployment version. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -935,8 +931,6 @@ public function DescribeWorkerDeploymentVersion(V1\DescribeWorkerDeploymentVersi * Lists worker deployments in the namespace. Optionally can filter based on * deployment series * name. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `ListWorkerDeployments`. * * @throws ServiceClientException @@ -958,8 +952,6 @@ public function ListDeployments(V1\ListDeploymentsRequest $arg, ?ContextInterfac * cached value. In such a case, the `last_update_time` will inform you about the * actual * reachability calculation time. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `DrainageInfo` returned by * `DescribeWorkerDeploymentVersion`. * @@ -972,8 +964,6 @@ public function GetDeploymentReachability(V1\GetDeploymentReachabilityRequest $a /** * Returns the current deployment (and its info) for a given deployment series. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced by `current_version` returned by * `DescribeWorkerDeployment`. * @@ -988,8 +978,6 @@ public function GetCurrentDeployment(V1\GetCurrentDeploymentRequest $arg, ?Conte * Sets a deployment as the current deployment for its deployment series. Can * optionally update * the metadata of the deployment as well. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced by `SetWorkerDeploymentCurrentVersion`. * * @throws ServiceClientException @@ -1003,8 +991,6 @@ public function SetCurrentDeployment(V1\SetCurrentDeploymentRequest $arg, ?Conte * Set/unset the Current Version of a Worker Deployment. Automatically unsets the * Ramping * Version if it is the Version being set as Current. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1015,8 +1001,6 @@ public function SetWorkerDeploymentCurrentVersion(V1\SetWorkerDeploymentCurrentV /** * Describes a Worker Deployment. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1028,8 +1012,6 @@ public function DescribeWorkerDeployment(V1\DescribeWorkerDeploymentRequest $arg /** * Deletes records of (an old) Deployment. A deployment can only be deleted if * it has no Version in it. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1047,8 +1029,6 @@ public function DeleteWorkerDeployment(V1\DeleteWorkerDeploymentRequest $arg, ?C * - It is not draining (see WorkerDeploymentVersionInfo.drainage_info). This * condition * can be skipped by passing `skip-drainage=true`. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1061,8 +1041,6 @@ public function DeleteWorkerDeploymentVersion(V1\DeleteWorkerDeploymentVersionRe * Set/unset the Ramping Version of a Worker Deployment and its ramp percentage. * Can be used for * gradual ramp to unversioned workers too. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1073,8 +1051,6 @@ public function SetWorkerDeploymentRampingVersion(V1\SetWorkerDeploymentRampingV /** * Lists all Worker Deployments that are tracked in the Namespace. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -1085,8 +1061,6 @@ public function ListWorkerDeployments(V1\ListWorkerDeploymentsRequest $arg, ?Con /** * Updates the user-given metadata attached to a Worker Deployment Version. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ diff --git a/src/Client/GRPC/ServiceClientInterface.php b/src/Client/GRPC/ServiceClientInterface.php index 8655fda7..1f262bfa 100644 --- a/src/Client/GRPC/ServiceClientInterface.php +++ b/src/Client/GRPC/ServiceClientInterface.php @@ -753,8 +753,6 @@ public function GetWorkerTaskReachability(V1\GetWorkerTaskReachabilityRequest $a /** * Describes a worker deployment. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `DescribeWorkerDeploymentVersion`. * * @throws ServiceClientException @@ -763,8 +761,6 @@ public function DescribeDeployment(V1\DescribeDeploymentRequest $arg, ?ContextIn /** * Describes a worker deployment version. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -774,8 +770,6 @@ public function DescribeWorkerDeploymentVersion(V1\DescribeWorkerDeploymentVersi * Lists worker deployments in the namespace. Optionally can filter based on * deployment series * name. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `ListWorkerDeployments`. * * @throws ServiceClientException @@ -794,8 +788,6 @@ public function ListDeployments(V1\ListDeploymentsRequest $arg, ?ContextInterfac * cached value. In such a case, the `last_update_time` will inform you about the * actual * reachability calculation time. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced with `DrainageInfo` returned by * `DescribeWorkerDeploymentVersion`. * @@ -805,8 +797,6 @@ public function GetDeploymentReachability(V1\GetDeploymentReachabilityRequest $a /** * Returns the current deployment (and its info) for a given deployment series. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced by `current_version` returned by * `DescribeWorkerDeployment`. * @@ -818,8 +808,6 @@ public function GetCurrentDeployment(V1\GetCurrentDeploymentRequest $arg, ?Conte * Sets a deployment as the current deployment for its deployment series. Can * optionally update * the metadata of the deployment as well. - * Experimental. This API might significantly change or be removed in a future - * release. * Deprecated. Replaced by `SetWorkerDeploymentCurrentVersion`. * * @throws ServiceClientException @@ -830,8 +818,6 @@ public function SetCurrentDeployment(V1\SetCurrentDeploymentRequest $arg, ?Conte * Set/unset the Current Version of a Worker Deployment. Automatically unsets the * Ramping * Version if it is the Version being set as Current. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -839,8 +825,6 @@ public function SetWorkerDeploymentCurrentVersion(V1\SetWorkerDeploymentCurrentV /** * Describes a Worker Deployment. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -849,8 +833,6 @@ public function DescribeWorkerDeployment(V1\DescribeWorkerDeploymentRequest $arg /** * Deletes records of (an old) Deployment. A deployment can only be deleted if * it has no Version in it. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -865,8 +847,6 @@ public function DeleteWorkerDeployment(V1\DeleteWorkerDeploymentRequest $arg, ?C * - It is not draining (see WorkerDeploymentVersionInfo.drainage_info). This * condition * can be skipped by passing `skip-drainage=true`. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -876,8 +856,6 @@ public function DeleteWorkerDeploymentVersion(V1\DeleteWorkerDeploymentVersionRe * Set/unset the Ramping Version of a Worker Deployment and its ramp percentage. * Can be used for * gradual ramp to unversioned workers too. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -885,8 +863,6 @@ public function SetWorkerDeploymentRampingVersion(V1\SetWorkerDeploymentRampingV /** * Lists all Worker Deployments that are tracked in the Namespace. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ @@ -894,8 +870,6 @@ public function ListWorkerDeployments(V1\ListWorkerDeploymentsRequest $arg, ?Con /** * Updates the user-given metadata attached to a Worker Deployment Version. - * Experimental. This API might significantly change or be removed in a future - * release. * * @throws ServiceClientException */ diff --git a/src/Common/Versioning/VersioningBehavior.php b/src/Common/Versioning/VersioningBehavior.php index da3080a3..9b3002ff 100644 --- a/src/Common/Versioning/VersioningBehavior.php +++ b/src/Common/Versioning/VersioningBehavior.php @@ -11,13 +11,11 @@ * Versions. The Versioning Behavior of a workflow execution is typically specified by the worker * who completes the first task of the execution, but is also overridable manually for new and * existing workflows (see VersioningOverride). - * Experimental. Worker Deployments are experimental and might significantly change in the future. * * @see \Temporal\Api\Enums\V1\VersioningBehavior * * @since SDK 2.16.0 * @since RoadRunner 2025.1.3 - * @internal Experimental */ enum VersioningBehavior: int { diff --git a/src/Common/Versioning/VersioningOverride.php b/src/Common/Versioning/VersioningOverride.php index 0073d595..71183c4f 100644 --- a/src/Common/Versioning/VersioningOverride.php +++ b/src/Common/Versioning/VersioningOverride.php @@ -16,7 +16,6 @@ * * @since SDK 2.16.0 * @since RoadRunner 2025.1.3 - * @internal Experimental */ final class VersioningOverride { diff --git a/src/Common/Versioning/WorkerDeploymentVersion.php b/src/Common/Versioning/WorkerDeploymentVersion.php index 11154f2f..8f3be786 100644 --- a/src/Common/Versioning/WorkerDeploymentVersion.php +++ b/src/Common/Versioning/WorkerDeploymentVersion.php @@ -15,7 +15,6 @@ * * @since SDK 2.16.0 * @since RoadRunner 2025.1.3 - * @internal Experimental */ class WorkerDeploymentVersion implements \Stringable { diff --git a/src/Worker/WorkerDeploymentOptions.php b/src/Worker/WorkerDeploymentOptions.php index 435a6b6a..cef3d937 100644 --- a/src/Worker/WorkerDeploymentOptions.php +++ b/src/Worker/WorkerDeploymentOptions.php @@ -12,8 +12,6 @@ /** * Options for configuring the Worker Versioning feature. - * - * @internal Experimental. */ class WorkerDeploymentOptions { diff --git a/src/Worker/WorkerOptions.php b/src/Worker/WorkerOptions.php index 704854b7..4fe7fded 100644 --- a/src/Worker/WorkerOptions.php +++ b/src/Worker/WorkerOptions.php @@ -318,7 +318,6 @@ class WorkerOptions * * @since SDK 2.16.0 * @since RoadRunner 2025.1.3 - * @internal Experimental. */ #[Marshal(name: 'DeploymentOptions')] public WorkerDeploymentOptions $deploymentOptions; @@ -845,7 +844,6 @@ public function withUseBuildIDForVersioning(bool $useBuildIDForVersioning = true * * @since SDK 2.16.0 * @since RoadRunner 2025.1.3 - * @internal Experimental. */ #[Pure] public function withDeploymentOptions(WorkerDeploymentOptions $deploymentOptions): self