Add Initial Governance Core Implementation

components/apimgt/org.wso2.carbon.apimgt.governance.api/.gitignore

@@ -0,0 +1,38 @@
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store

components/apimgt/org.wso2.carbon.apimgt.governance.api/pom.xml

@@ -0,0 +1,65 @@
+<?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">
+
+    <parent>
+        <groupId>org.wso2.carbon.apimgt</groupId>
+        <artifactId>apimgt</artifactId>
+        <version>9.30.99-SNAPSHOT</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>org.wso2.carbon.apimgt.governance.api</artifactId>
+    <packaging>bundle</packaging>
+    <name>WSO2 API Manager Governance API</name>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.felix</groupId>
+                <artifactId>maven-bundle-plugin</artifactId>
+                <extensions>true</extensions>
+                <configuration>
+                    <instructions>
+                        <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName>
+                        <Bundle-Name>${project.artifactId}</Bundle-Name>
+                        <Export-Package>
+                            org.wso2.carbon.apimgt.governance.api.*;version="${carbon.apimgt.version}"
+                        </Export-Package>
+                        <Import-Package>
+                            *;resolution:=optional
+                        </Import-Package>
+                    </instructions>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ComplianceManager.java

@@ -0,0 +1,63 @@
+/*
+ * 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.apimgt.governance.api;
+
+import org.wso2.carbon.apimgt.governance.api.error.GovernanceException;
+import org.wso2.carbon.apimgt.governance.api.model.ArtifactType;
+
+import java.util.List;
+
+/**
+ * This interface represents the Compliance Manager, which is responsible for managing compliance related operations
+ */
+public interface ComplianceManager {
+
+    /**
+     * Handle Policy Change Event
+     *
+     * @param policyId     Policy ID
+     * @param organization Organization
+     */
+    void handlePolicyChangeEvent(String policyId, String organization) throws GovernanceException;
+
+
+    /**
+     * Handle Ruleset Change Event
+     *
+     * @param rulesetId    Ruleset ID
+     * @param organization Organization
+     */
+    void handleRulesetChangeEvent(String rulesetId, String organization) throws GovernanceException;
+
+
+    /**
+     * Handle API Compliance Evaluation Request Async
+     *
+     * @param artifactId   Artifact ID
+     * @param artifactType Artifact Type
+     * @param govPolicies  List of governance policies to be evaluated
+     * @param organization Organization
+     * @throws GovernanceException If an error occurs while handling the API compliance evaluation
+     */
+    void handleComplianceEvaluationAsync(String artifactId, ArtifactType artifactType,
+                                         List<String> govPolicies, String organization)
+            throws GovernanceException;
+
+
+}

components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/GovernanceAPIConstants.java

@@ -0,0 +1,38 @@
+/*
+ * 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.apimgt.governance.api;
+
+/**
+ * This class represents a governance API constants
+ */
+public class GovernanceAPIConstants {
+    public static final String ORGANIZATION = "organization";
+    public static final String RULESET_PATH = "/rulesets";
+    public static final String POLICY_PATH = "/governance-policies";
+
+    public static final String LIMIT_PARAM = "{limit}";
+    public static final String OFFSET_PARAM = "{offset}";
+
+    public static final String RULESETS_GET_URL =
+            RULESET_PATH + "?limit=" + LIMIT_PARAM + "&offset=" + OFFSET_PARAM;
+
+    public static final String POLICIES_GET_URL =
+            POLICY_PATH + "?limit=" + LIMIT_PARAM + "&offset=" + OFFSET_PARAM;
+
+}

components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/PolicyManager.java

@@ -0,0 +1,130 @@
+/*
+ * 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.apimgt.governance.api;
+
+import org.wso2.carbon.apimgt.governance.api.error.GovernanceException;
+import org.wso2.carbon.apimgt.governance.api.model.GovernableState;
+import org.wso2.carbon.apimgt.governance.api.model.GovernancePolicy;
+import org.wso2.carbon.apimgt.governance.api.model.GovernancePolicyList;
+import org.wso2.carbon.apimgt.governance.api.model.Ruleset;
+
+import java.util.List;
+
+/**
+ * This interface represents the Governance Policy Manager
+ */
+public interface PolicyManager {
+    /**
+     * Create a new Governance Policy
+     *
+     * @param organization     Organization
+     * @param governancePolicy Governance Policy
+     * @return GovernancePolicyInfo Created object
+     * @throws GovernanceException If an error occurs while creating the policy
+     */
+    GovernancePolicy createGovernancePolicy(String organization, GovernancePolicy
+            governancePolicy) throws GovernanceException;
+
+    /**
+     * Get Governance Policy by Name
+     *
+     * @param organization Organization
+     * @param policyID     Policy ID
+     * @return GovernancePolicyInfo
+     * @throws GovernanceException If an error occurs while retrieving the policy
+     */
+    GovernancePolicy getGovernancePolicyByID(String organization, String policyID) throws GovernanceException;
+
+    /**
+     * Get Governance Policies
+     *
+     * @param organization Organization
+     * @return GovernancePolicyList
+     * @throws GovernanceException If an error occurs while retrieving the policies
+     */
+    GovernancePolicyList getGovernancePolicies(String organization) throws GovernanceException;
+
+    /**
+     * Delete a Governance Policy
+     *
+     * @param policyId     Policy ID
+     * @param organization Organization
+     * @throws GovernanceException If an error occurs while deleting the policy
+     */
+    void deletePolicy(String policyId, String organization) throws GovernanceException;
+
+    /**
+     * Update a Governance Policy
+     *
+     * @param policyId                           Policy ID
+     * @param organization                       Organization
+     * @param governancePolicy Governance Policy Info
+     * @return GovernancePolicyInfo Updated object
+     * @throws GovernanceException If an error occurs while updating the policy
+     */
+    GovernancePolicy updateGovernancePolicy(String policyId, String organization,
+                                            GovernancePolicy
+                                                    governancePolicy)
+            throws GovernanceException;
+
+
+    /**
+     * Get the list of rulesets for a given policy
+     *
+     * @param policyId Policy ID
+     * @return List of rulesets
+     * @throws GovernanceException If an error occurs while getting the rulesets
+     */
+    List<Ruleset> getRulesetsByPolicyId(String policyId) throws GovernanceException;
+
+    /**
+     * Get the list of policies by label and state
+     *
+     * @param label        label
+     * @param state        governable state for policy
+     * @param organization organization
+     * @return List of policy IDs
+     * @throws GovernanceException If an error occurs while getting the policies
+     */
+    List<String> getPoliciesByLabelAndState(String label, GovernableState state,
+                                            String organization) throws GovernanceException;
+
+    /**
+     * Get the list of organization wide policies by state
+     *
+     * @param state        governable state for policy
+     * @param organization organization
+     * @return List of policy IDs
+     * @throws GovernanceException If an error occurs while getting the policies
+     */
+    List<String> getOrganizationWidePoliciesByState(GovernableState state,
+                                                    String organization) throws GovernanceException;
+
+    /**
+     * This method checks whether a blocking action is present for a given governable state of a policy
+     *
+     * @param policyId Policy ID
+     * @param state    Governable State
+     * @return
+     * @throws GovernanceException
+     */
+    boolean isBlockingActionPresentForState(String policyId, GovernableState state)
+            throws GovernanceException;
+
+}