Add workflow APIs

components/org.wso2.carbon.identity.api.server.workflow/org.wso2.carbon.identity.api.server.workflow.common/pom.xml

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+  ~ Copyright (c) 2025, WSO2 LLC. (http://www.wso2.com).
+  ~
+  ~ WSO2 LLC. licenses this file to you under the Apache License,
+  ~ Version 2.0 (the "License"); you may not use this file except
+  ~ in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~ http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing,
+  ~ software distributed under the License is distributed on an
+  ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  ~ KIND, either express or implied.  See the License for the
+  ~ specific language governing permissions and limitations
+  ~ under the License.
+  -->
+
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.wso2.carbon.identity.server.api</groupId>
+        <artifactId>org.wso2.carbon.identity.api.server.workflow</artifactId>
+        <relativePath>../pom.xml</relativePath>
+        <version>1.3.84-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>org.wso2.carbon.identity.api.server.workflow.common</artifactId>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.workflow.impl.bps</groupId>
+            <artifactId>org.wso2.carbon.identity.workflow.mgt</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.wso2.carbon.identity.workflow.impl.bps</groupId>
+            <artifactId>org.wso2.carbon.identity.workflow.impl</artifactId>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+</project>

components/org.wso2.carbon.identity.api.server.workflow/org.wso2.carbon.identity.api.server.workflow.common/src/main/java/org/wso2/carbon/identity/api/server/workflow/common/Constants.java

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2025, WSO2 LLC. (http://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.wso2.carbon.identity.api.server.workflow.common;
+
+/**
+ * Common constants for workflow API.
+ */
+public class Constants {
+
+    public static final String WORKFLOW_PREFIX = "WF-";
+    public static final String APPROVAL_STEPS = "ApprovalSteps";
+    public static final String APPROVAL_STEP = "Step-";
+    public static final String TEMPLATE = "Template";
+    public static final String APPROVAL_TASK_SUBJECT = "ApprovalTaskSubject";
+    public static final String APPROVAL_TASK_DESCRIPTION = "ApprovalTaskDescription";
+    public static final String WORKFLOW_IMPLEMENTATION = "Workflowimpl";
+    public static final String WORKFLOW_NAME = "WorkflowName";
+
+    private Constants() {
+
+    }
+
+    /**
+     * Enum for error messages.
+     */
+    public enum ErrorMessage {
+
+        // Client errors starting from 510xx.
+        ERROR_CODE_WORKFLOW_NOT_FOUND("51001", "Resource not found.",
+                "Unable to find a resource matching the provided workflow identifier %s."),
+        ERROR_CODE_ASSOCIATION_NOT_FOUND("51002", "Resource not found.",
+                "Unable to find a resource matching the provided workflow association identifier %s."),
+        ERROR_CODE_CLIENT_ERROR_ADDING_WORKFLOW("51003", "Unable to add workflow",
+                "Encountered an error while adding the workflow."),
+        ERROR_CODE_CLIENT_ERROR_UPDATING_WORKFLOW("51004", "Unable to update workflow",
+                "Encountered an error while updating the workflow for identifier %s."),
+        ERROR_CODE_CLIENT_ERROR_LISTING_WORKFLOWS("51005", "Unable to list existing workflows",
+                "Encountered an error while listing the workflows."),
+        ERROR_CODE_CLIENT_ERROR_LISTING_ASSOCIATIONS("51006", "Unable to list existing workflow " +
+                "associations", "Encountered an error while listing the workflow associations."),
+        ERROR_CODE_CLIENT_ERROR_ADDING_ASSOCIATION("51007", "Unable to add workflow association",
+                "Encountered an error while adding the workflow association."),
+        ERROR_CODE_CLIENT_ERROR_UPDATING_ASSOCIATION("51008", "Unable to update workflow association",
+                "Encountered an error while updating the workflow association."),
+
+        // Server Errors starting from 500xx.
+        ERROR_CODE_ERROR_LISTING_WORKFLOWS("50020", "Unable to list existing workflows",
+                                                   "Server encountered an error while listing the workflows."),
+        ERROR_CODE_ERROR_REMOVING_WORKFLOW("50021", "Unable to delete the workflow",
+                                                   "Server encountered an error while deleting " +
+                                                           "the workflow for the identifier %s."),
+        ERROR_CODE_ERROR_RETRIEVING_WORKFLOW("50023", "Unable to retrieve workflow.",
+                                                     "Server encountered an error while " +
+                                                             "retrieving the workflow for identifier %s."),
+        ERROR_CODE_ERROR_ADDING_WORKFLOW("50024", "Unable to add workflow",
+                                                 "Server encountered an error while adding the workflow."),
+        ERROR_CODE_ERROR_UPDATING_WORKFLOW("50025", "Unable to update workflow",
+                                                   "Server encountered an error while updating the " +
+                                                           "workflow for identifier %s."),
+        ERROR_CODE_ERROR_ADDING_ASSOCIATION("50026", "Unable to add workflow association",
+                                                    "Server encountered an error while adding " +
+                                                            "the workflow association."),
+        ERROR_CODE_ERROR_LISTING_ASSOCIATIONS("50027", "Unable to list existing workflow associations",
+                                                      "Server encountered an error while " +
+                                                              "listing the workflow associations."),
+        ERROR_CODE_ERROR_REMOVING_ASSOCIATION("50028", "Unable to delete the workflow association",
+                                                      "Server encountered an error while deleting " +
+                                                              "the workflow association."),
+        ERROR_CODE_ERROR_RETRIEVING_ASSOCIATION("50029", "Unable to retrieve workflow association.",
+                                                        "Server encountered an error while retrieving " +
+                                                                "the workflow association for identifier %s."),
+        ERROR_CODE_ERROR_UPDATING_ASSOCIATION("50030", "Unable to update workflow association",
+                                                      "Server encountered an error while " +
+                                                              "updating the workflow association.");
+
+        private final String code;
+        private final String message;
+        private final String description;
+
+        ErrorMessage(String code, String message, String description) {
+
+            this.code = code;
+            this.message = message;
+            this.description = description;
+        }
+
+        public String getCode() {
+
+            return WORKFLOW_PREFIX + code;
+        }
+
+        public String getMessage() {
+
+            return message;
+        }
+
+        public String getDescription() {
+
+            return description;
+        }
+
+        @Override
+        public String toString() {
+
+            return code + " | " + message;
+        }
+    }
+}

components/org.wso2.carbon.identity.api.server.workflow/org.wso2.carbon.identity.api.server.workflow.common/src/main/java/org/wso2/carbon/identity/api/server/workflow/common/WorkflowServiceHolder.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2025, WSO2 LLC. (http://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.wso2.carbon.identity.api.server.workflow.common;
+
+import org.wso2.carbon.identity.workflow.impl.WorkflowImplServiceImpl;
+import org.wso2.carbon.identity.workflow.mgt.WorkflowManagementService;
+import org.wso2.carbon.identity.workflow.mgt.WorkflowManagementServiceImpl;
+
+/**
+ * Service holder class for workflow management.
+ */
+public class WorkflowServiceHolder {
+
+    private final static WorkflowManagementService service = new WorkflowManagementServiceImpl();
+    private final static WorkflowImplServiceImpl implService = new WorkflowImplServiceImpl();
+
+    public static WorkflowManagementService getWorkflowManagementService() {
+
+        return service;
+    }
+
+    public static WorkflowImplServiceImpl getWorkflowImplService() {
+
+        return implService;
+    }
+}