Cascade terminate/Purge Workflow Support

Makefile

@@ -373,8 +373,8 @@ test-integration: test-deps
 ################################################################################
 # Target: lint                                                                 #
 ################################################################################
-# Please use golangci-lint version v1.51.2 , otherwise you might encounter errors.
-# You can download version v1.51.2 at https://github.com/golangci/golangci-lint/releases/tag/v1.51.2
+# Please use golangci-lint version v1.55.2 , otherwise you might encounter errors.
+# You can download version v1.55.2 at https://github.com/golangci/golangci-lint/releases/tag/v1.55.2
 .PHONY: lint
 lint: check-linter
 	$(GOLANGCI_LINT) run --build-tags=allcomponents --timeout=20m

dapr/proto/runtime/v1/dapr.proto

@@ -1066,6 +1066,8 @@ message TerminateWorkflowRequest {
   string instance_id = 1 [json_name = "instanceID"];
   // Name of the workflow component.
   string workflow_component = 2 [json_name = "workflowComponent"];
+  // Indicates whether this is a non_recursive terminate request
+  bool non_recursive = 3 [json_name = "non_recursive"];
 }
 
 // PauseWorkflowRequest is the request for PauseWorkflowBeta1.
@@ -1102,6 +1104,8 @@ message PurgeWorkflowRequest {
   string instance_id = 1 [json_name = "instanceID"];
   // Name of the workflow component.
   string workflow_component = 2 [json_name = "workflowComponent"];
+  // Indicates whether this is a non_recursive purge request
+  bool non_recursive = 3 [json_name = "non_recursive"];
 }
 
 // ShutdownRequest is the request for Shutdown.

go.mod

@@ -36,7 +36,7 @@ require (
 	github.com/jhump/protoreflect v1.15.2
 	github.com/kelseyhightower/envconfig v1.4.0
 	github.com/lestrrat-go/jwx/v2 v2.0.18
-	github.com/microsoft/durabletask-go v0.4.0
+	github.com/microsoft/durabletask-go v0.4.1-0.20231222205218-fc5756737d3c
 	github.com/mitchellh/mapstructure v1.5.1-0.20220423185008-bf980b35cac4
 	github.com/phayes/freeport v0.0.0-20220201140144-74d24b5ae9f5
 	github.com/prometheus/client_golang v1.16.0

go.sum

@@ -1160,8 +1160,8 @@ github.com/matttproud/golang_protobuf_extensions v1.0.4 h1:mmDVorXM7PCGKw94cs5zk
 github.com/matttproud/golang_protobuf_extensions v1.0.4/go.mod h1:BSXmuO+STAnVfrANrmjBb36TMTDstsz7MSK+HVaYKv4=
 github.com/microcosm-cc/bluemonday v1.0.24 h1:NGQoPtwGVcbGkKfvyYk1yRqknzBuoMiUrO6R7uFTPlw=
 github.com/microcosm-cc/bluemonday v1.0.24/go.mod h1:ArQySAMps0790cHSkdPEJ7bGkF2VePWH773hsJNSHf8=
-github.com/microsoft/durabletask-go v0.4.0 h1:rGqKRZYyvxBaD/UIfVUnlGqrycqBg30Ngpt0ODcIzqY=
-github.com/microsoft/durabletask-go v0.4.0/go.mod h1:svScWPnRqjf9YgxeCB3CkYLMAyvuu+qqNf4Hl9dmvcg=
+github.com/microsoft/durabletask-go v0.4.1-0.20231222205218-fc5756737d3c h1:eng0MBn0jE65oWhzHbCugaGs6JetgfkdVW36nIJ0vgI=
+github.com/microsoft/durabletask-go v0.4.1-0.20231222205218-fc5756737d3c/go.mod h1:OSZ4K7SgqBEsaouk3lAVdDzvanIzsdj7angZ0FTeSAU=
 github.com/microsoft/go-mssqldb v1.6.0 h1:mM3gYdVwEPFrlg/Dvr2DNVEgYFG7L42l+dGc67NNNpc=
 github.com/microsoft/go-mssqldb v1.6.0/go.mod h1:00mDtPbeQCRGC1HwOOR5K/gr30P1NcEG0vx6Kbv2aJU=
 github.com/miekg/dns v1.0.14/go.mod h1:W1PPwlIAgtquWBMBEV9nkV9Cazfe8ScdGz/Lj7v3Nrg=

pkg/api/http/http.go

@@ -99,6 +99,7 @@ const (
 	workflowComponent        = "workflowComponent"
 	workflowName             = "workflowName"
 	instanceID               = "instanceID"
+	nonRecursive             = "non_recursive"
 	eventName                = "eventName"
 	consistencyParam         = "consistency"
 	concurrencyParam         = "concurrency"

pkg/api/http/http_test.go

@@ -2821,6 +2821,30 @@ func TestV1Beta1Workflow(t *testing.T) {
 		assert.Nil(t, resp.ErrorBody)
 	})
 
+	t.Run("Terminate with non_recursive set to false", func(t *testing.T) {
+		// This has the same behavior as the case when non_recursive parameter is not set.
+		// This is because default case is set to recursive termination.
+
+		apiPath := "v1.0-beta1/workflows/dapr/instanceID/terminate?non_recursive=false"
+
+		resp := fakeServer.DoRequest("POST", apiPath, nil, nil)
+		assert.Equal(t, 202, resp.StatusCode)
+
+		// assert
+		assert.Nil(t, resp.ErrorBody)
+	})
+
+	t.Run("Terminate with non_recursive true", func(t *testing.T) {
+		// Note that in case of non_recursive true, MockWorkflow intentionally returns fake error, even when it is not an actual error.
+		// This is to test that non_recursive flag is being passed correctly to the workflow component.
+
+		apiPath := "v1.0-beta1/workflows/dapr/instanceID/terminate?non_recursive=true"
+		resp := fakeServer.DoRequest("POST", apiPath, nil, nil)
+		assert.Equal(t, 500, resp.StatusCode)
+		assert.Equal(t, "ERR_TERMINATE_WORKFLOW", resp.ErrorBody["errorCode"])
+		assert.Equal(t, fmt.Sprintf(messages.ErrTerminateWorkflow.Message(), "instanceID", daprt.ErrFakeWorkflowNonRecursiveTerminateError), resp.ErrorBody["message"])
+	})
+
 	///////////////////////////
 	// RAISE EVENT API TESTS //
 	///////////////////////////
@@ -2931,6 +2955,28 @@ func TestV1Beta1Workflow(t *testing.T) {
 		// assert
 		assert.Nil(t, resp.ErrorBody)
 	})
+
+	t.Run("Purge with non_recursive false", func(t *testing.T) {
+		// This has the same behavior as the case when non_recursive parameter is not set.
+		// This is because default case is set to recursive purge.
+
+		apiPath := "v1.0-beta1/workflows/dapr/instanceID/purge?non_recursive=false"
+		resp := fakeServer.DoRequest("POST", apiPath, nil, nil)
+		assert.Equal(t, 202, resp.StatusCode)
+
+		// assert
+		assert.Nil(t, resp.ErrorBody)
+	})
+	t.Run("Purge with non_recursive true", func(t *testing.T) {
+		// Note that in case of non_recursive true, MockWorkflow intentionally returns fake error, even when it is not an actual error.
+		// This is to test that non_recursive flag is being passed correctly to the workflow component.
+
+		apiPath := "v1.0-beta1/workflows/dapr/instanceID/purge?non_recursive=true"
+		resp := fakeServer.DoRequest("POST", apiPath, nil, nil)
+		assert.Equal(t, 500, resp.StatusCode)
+		assert.Equal(t, "ERR_PURGE_WORKFLOW", resp.ErrorBody["errorCode"])
+		assert.Equal(t, fmt.Sprintf(messages.ErrPurgeWorkflow.Message(), "instanceID", daprt.ErrFakeWorkflowNonRecurisvePurgeError), resp.ErrorBody["message"])
+	})
 }
 
 func buildHTTPPineline(spec config.PipelineSpec) httpMiddleware.Pipeline {

pkg/api/http/workflow.go

@@ -16,6 +16,7 @@
 import (
 	"io"
 	"net/http"
+	"strconv"
 
 	"github.com/go-chi/chi/v5"
 	"github.com/google/uuid"
@@ -238,7 +239,21 @@
 	return UniversalHTTPHandler(
 		a.universal.TerminateWorkflowBeta1,
 		UniversalHTTPHandlerOpts[*runtimev1pb.TerminateWorkflowRequest, *emptypb.Empty]{
-			InModifier:        workflowInModifier[*runtimev1pb.TerminateWorkflowRequest],
+			InModifier: func(r *http.Request, in *runtimev1pb.TerminateWorkflowRequest) (*runtimev1pb.TerminateWorkflowRequest, error) {
+				in.SetWorkflowComponent(chi.URLParam(r, workflowComponent))
+				in.SetInstanceId(chi.URLParam(r, instanceID))
+
+				// Extract non_recursive option from query string
+				nonRecursive := r.URL.Query().Get(nonRecursive)
+				if nonRecursive != "" {
+					var err error
+					in.NonRecursive, err = strconv.ParseBool(nonRecursive)
+					if err != nil {
+						return nil, err
+					}
+				}
+				return in, nil
+			},
 			SuccessStatusCode: http.StatusAccepted,
 		})
 }
@@ -292,7 +307,21 @@
 	return UniversalHTTPHandler(
 		a.universal.PurgeWorkflowBeta1,
 		UniversalHTTPHandlerOpts[*runtimev1pb.PurgeWorkflowRequest, *emptypb.Empty]{
-			InModifier:        workflowInModifier[*runtimev1pb.PurgeWorkflowRequest],
+			InModifier: func(r *http.Request, in *runtimev1pb.PurgeWorkflowRequest) (*runtimev1pb.PurgeWorkflowRequest, error) {
+				in.SetWorkflowComponent(chi.URLParam(r, workflowComponent))
+				in.SetInstanceId(chi.URLParam(r, instanceID))
+
+				// Extract non_recursive option from query string
+				nonRecursive := r.URL.Query().Get(nonRecursive)
+				if nonRecursive != "" {
+					var err error
+					in.NonRecursive, err = strconv.ParseBool(nonRecursive)
+					if err != nil {
+						return nil, err
+					}
+				}
+				return in, nil
+			},
 			SuccessStatusCode: http.StatusAccepted,
 		})
 }

pkg/api/universal/workflow.go

@@ -125,6 +125,7 @@
 
 	req := &workflows.TerminateRequest{
 		InstanceID: in.GetInstanceId(),
+		Recursive:  !in.GetNonRecursive(),
 	}
 	if err := workflowComponent.Terminate(ctx, req); err != nil {
 		if errors.Is(err, api.ErrInstanceNotFound) {
@@ -247,6 +248,7 @@
 
 	req := workflows.PurgeRequest{
 		InstanceID: in.GetInstanceId(),
+		Recursive:  !in.GetNonRecursive(),
 	}
 
 	err = workflowComponent.Purge(ctx, &req)