Add deprecation warnings to Steps from Apps components (#1319)

Author: seratch

bolt/src/main/java/com/slack/api/bolt/App.java

@@ -772,14 +772,26 @@ public App viewClosed(Pattern callbackId, ViewClosedHandler handler) {
     // Workflows: Steps from Apps
     // https://api.slack.com/workflows/steps
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App step(WorkflowStep step) {
         return this.use(step);
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepEdit(String callbackId, WorkflowStepEditHandler handler) {
         return workflowStepEdit(Pattern.compile("^" + Pattern.quote(callbackId) + "$"), handler);
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepEdit(Pattern callbackId, WorkflowStepEditHandler handler) {
         if (workflowStepEditHandlers.get(callbackId) != null) {
             log.warn("Replaced the handler for {}", callbackId);
@@ -788,10 +800,18 @@ public App workflowStepEdit(Pattern callbackId, WorkflowStepEditHandler handler)
         return this;
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepSave(String callbackId, WorkflowStepSaveHandler handler) {
         return workflowStepSave(Pattern.compile("^" + Pattern.quote(callbackId) + "$"), handler);
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepSave(Pattern callbackId, WorkflowStepSaveHandler handler) {
         if (workflowStepSaveHandlers.get(callbackId) != null) {
             log.warn("Replaced the handler for {}", callbackId);
@@ -800,10 +820,18 @@ public App workflowStepSave(Pattern callbackId, WorkflowStepSaveHandler handler)
         return this;
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepExecute(String pattern, WorkflowStepExecuteHandler handler) {
         return workflowStepExecute(Pattern.compile("^.*" + Pattern.quote(pattern) + ".*$"), handler);
     }
 
+    /**
+     * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+     */
+    @Deprecated
     public App workflowStepExecute(Pattern pattern, WorkflowStepExecuteHandler handler) {
         if (workflowStepExecuteHandlers.get(pattern) != null) {
             log.warn("Replaced the handler for {}", pattern);

bolt/src/main/java/com/slack/api/bolt/context/WorkflowCompleteUtility.java

@@ -3,12 +3,14 @@
 import com.slack.api.methods.MethodsClient;
 import com.slack.api.methods.SlackApiException;
 import com.slack.api.methods.response.workflows.WorkflowsStepCompletedResponse;
-import com.slack.api.model.workflow.WorkflowStepOutput;
 
 import java.io.IOException;
-import java.util.List;
 import java.util.Map;
 
+/**
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+ */
+@Deprecated
 public interface WorkflowCompleteUtility {
 
     String getWorkflowStepExecuteId();

bolt/src/main/java/com/slack/api/bolt/context/WorkflowConfigureUtility.java

@@ -10,6 +10,10 @@
 
 import static com.slack.api.model.view.Views.view;
 
+/**
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+ */
+@Deprecated
 public interface WorkflowConfigureUtility {
 
     String getTriggerId();

bolt/src/main/java/com/slack/api/bolt/context/WorkflowFailUtility.java

@@ -2,12 +2,15 @@
 
 import com.slack.api.methods.MethodsClient;
 import com.slack.api.methods.SlackApiException;
-import com.slack.api.methods.response.workflows.WorkflowsStepCompletedResponse;
 import com.slack.api.methods.response.workflows.WorkflowsStepFailedResponse;
 
 import java.io.IOException;
 import java.util.Map;
 
+/**
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+ */
+@Deprecated
 public interface WorkflowFailUtility {
 
     String getWorkflowStepExecuteId();

bolt/src/main/java/com/slack/api/bolt/context/WorkflowUpdateUtility.java

@@ -10,6 +10,10 @@
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+ */
+@Deprecated
 public interface WorkflowUpdateUtility {
 
     String getWorkflowStepEditId();

bolt/src/main/java/com/slack/api/bolt/context/builtin/WorkflowStepEditContext.java

@@ -6,6 +6,7 @@
 
 /**
  * workflow_step_edit type request's context.
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
  */
 @Getter
 @Setter
@@ -14,6 +15,7 @@
 @AllArgsConstructor
 @ToString(callSuper = true)
 @EqualsAndHashCode(callSuper = false)
+@Deprecated
 public class WorkflowStepEditContext extends Context implements WorkflowConfigureUtility {
 
     private String triggerId;

bolt/src/main/java/com/slack/api/bolt/context/builtin/WorkflowStepExecuteContext.java

@@ -6,7 +6,8 @@
 import lombok.*;
 
 /**
- * workflow_step_edit type request's context.
+ * workflow_step_execute type request's context.
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
  */
 @Getter
 @Setter
@@ -15,6 +16,7 @@
 @AllArgsConstructor
 @ToString(callSuper = true)
 @EqualsAndHashCode(callSuper = false)
+@Deprecated
 public class WorkflowStepExecuteContext extends Context
         implements WorkflowCompleteUtility, WorkflowFailUtility {
     private String callbackId;

bolt/src/main/java/com/slack/api/bolt/context/builtin/WorkflowStepSaveContext.java

@@ -10,13 +10,18 @@
 
 import java.util.Map;
 
+/**
+ * workflow_step_save type request's context.
+ * @deprecated Use new custom steps: https://api.slack.com/automation/functions/custom-bolt
+ */
 @Getter
 @Setter
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
 @ToString(callSuper = true)
 @EqualsAndHashCode(callSuper = false)
+@Deprecated
 public class WorkflowStepSaveContext extends Context implements WorkflowUpdateUtility {
 
     private String workflowStepEditId;

bolt/src/main/java/com/slack/api/bolt/handler/builtin/WorkflowStepEditHandler.java

@@ -6,5 +6,6 @@
 import com.slack.api.bolt.response.Response;
 
 @FunctionalInterface
+@Deprecated
 public interface WorkflowStepEditHandler extends Handler<WorkflowStepEditContext, WorkflowStepEditRequest, Response> {
 }

bolt/src/main/java/com/slack/api/bolt/handler/builtin/WorkflowStepExecuteHandler.java

@@ -6,5 +6,6 @@
 import com.slack.api.bolt.response.Response;
 
 @FunctionalInterface
+@Deprecated
 public interface WorkflowStepExecuteHandler extends Handler<WorkflowStepExecuteContext, WorkflowStepExecuteRequest, Response> {
 }