Create Product Consumption Tracking Module

apps/customer-portal/backend/Dependencies.toml

@@ -366,10 +366,10 @@ modules = [
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.authorization"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.entity"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.product_consumption_subscription"},
+	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.product_consumption_tracking"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.registry"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.scim"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.types"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.updates"},
 	{org = "wso2", packageName = "customer_portal", moduleName = "customer_portal.user_management"}
 ]
-

apps/customer-portal/backend/modules/product_consumption_tracking/client.bal

@@ -0,0 +1,42 @@
+// Copyright (c) 2026 WSO2 LLC. (https://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.
+
+import ballerina/http;
+
+configurable string productConsumptionTrackingBaseUrl = ?;
+configurable ClientCredentialsOauth2Config clientCredentialsOauth2Config = ?;
+
+@display {
+    label: "Product Consumption Tracking",
+    id: "product-consumption-tracking"
+}
+final http:Client productConsumptionTrackingClient = check new (productConsumptionTrackingBaseUrl, {
+    auth: {...clientCredentialsOauth2Config},
+    httpVersion: http:HTTP_1_1,
+    http1Settings: {keepAlive: http:KEEPALIVE_NEVER},
+    timeout: 300.0,
+    retryConfig: {
+        count: 3,
+        interval: 2.0,
+        statusCodes: [
+            http:STATUS_INTERNAL_SERVER_ERROR,
+            http:STATUS_REQUEST_TIMEOUT,
+            http:STATUS_BAD_GATEWAY,
+            http:STATUS_SERVICE_UNAVAILABLE,
+            http:STATUS_GATEWAY_TIMEOUT
+        ]
+    }
+});

apps/customer-portal/backend/modules/product_consumption_tracking/constants.bal

@@ -0,0 +1,17 @@
+// Copyright (c) 2026 WSO2 LLC. (https://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.
+
+const CONTENT_TYPE_APPLICATION_ZIP = "application/zip";

apps/customer-portal/backend/modules/product_consumption_tracking/product_consumption_tracking.bal

@@ -0,0 +1,31 @@
+// Copyright (c) 2026 WSO2 LLC. (https://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.
+
+# Import deployment usage data from a zip file.
+#
+# + email - Email address of the importing user
+# + zipFile - Zip file content as bytes
+# + return - Deployment usage import response or error
+public isolated function importDeploymentUsage(string email, byte[] zipFile)
+        returns DeploymentUsageImportResponse|error {
+
+    http:Request req = new;
+    req.setBinaryPayload(zipFile);
+    req.setContentType(CONTENT_TYPE_APPLICATION_ZIP);
+
+    return productConsumptionTrackingClient->/deployment\-usage\-import.post(req, email);
+
+}

apps/customer-portal/backend/modules/product_consumption_tracking/types.bal

@@ -0,0 +1,34 @@
+// Copyright (c) 2026 WSO2 LLC. (https://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.
+
+# [Configurable] Client credentials grant type oauth2 configuration.
+public type ClientCredentialsOauth2Config record {|
+    # Token URL
+    string tokenUrl;
+    # Client ID
+    string clientId;
+    # Client Secret
+    string clientSecret;
+|};
+
+# Deployment usage import response.
+public type DeploymentUsageImportResponse record {|
+    # Response message
+    string message?;
+    # Response result
+    json result?;
+    json...;
+|};

apps/customer-portal/backend/service.bal

@@ -18,6 +18,7 @@ import customer_portal.ai_chat_agent;
 import customer_portal.authorization;
 import customer_portal.entity;
 import customer_portal.product_consumption_subscription;
+import customer_portal.product_consumption_tracking;
 import customer_portal.registry;
 import customer_portal.scim;
 import customer_portal.types;
@@ -4001,7 +4002,7 @@ service http:InterceptableService / on new http:Listener(9090, listenerConf) {
     resource function post projects/[entity:IdString id]/cases/time\-cards/search(http:RequestContext ctx,
             types:TimeCardSearchPayload payload)
         returns http:Ok|http:BadRequest|http:Unauthorized|http:Forbidden|http:InternalServerError {
-        
+
         authorization:UserInfoPayload|error userInfo = ctx.getWithType(authorization:HEADER_USER_INFO);
         if userInfo is error {
             return <http:InternalServerError>{
@@ -5108,6 +5109,65 @@ service http:InterceptableService / on new http:Listener(9090, listenerConf) {
         return licenseResponse;
     }
 
+    # Import product consumption usage from a zip file.
+    #
+    # + req - Request containing zip file binary body
+    # + return - Deployment usage import response or error
+    isolated resource function post deployment\-usage\-import(http:RequestContext ctx, http:Request req)
+        returns product_consumption_tracking:DeploymentUsageImportResponse|http:BadRequest|http:InternalServerError {
+
+        authorization:UserInfoPayload|error userInfo = ctx.getWithType(authorization:HEADER_USER_INFO);
+        if userInfo is error {
+            return <http:InternalServerError>{
+                body: {
+                    message: ERR_MSG_USER_INFO_HEADER_NOT_FOUND
+                }
+            };
+        }
+
+        string? validationError = validateDeploymentUsageImportRequest(req);
+        if validationError is string {
+            log:printWarn(validationError);
+            return <http:BadRequest>{
+                body: {
+                    message: validationError
+                }
+            };
+        }
+
+        byte[]|http:ClientError zipFile = req.getBinaryPayload();
+        if zipFile is http:ClientError {
+            string customError = "Failed to read deployment usage import zip file.";
+            log:printError(customError, zipFile);
+            return <http:BadRequest>{
+                body: {
+                    message: customError
+                }
+            };
+        }
+
+        product_consumption_tracking:DeploymentUsageImportResponse|error response =
+            product_consumption_tracking:importDeploymentUsage(userInfo.email, zipFile);
+        if response is error {
+            if getStatusCode(response) == http:STATUS_BAD_REQUEST {
+                return <http:BadRequest>{
+                    body: {
+                        message: "Invalid deployment usage import request."
+                    }
+                };
+            }
+
+            string customError = "Failed to import deployment usage data.";
+            log:printError(customError, response);
+            return <http:InternalServerError>{
+                body: {
+                    message: customError
+                }
+            };
+        }
+        return response;
+    }
+
     # Get usage stats for a specific project.
     #
     # + id - ID of the project

apps/customer-portal/backend/utils.bal

@@ -25,6 +25,23 @@ configurable types:FeatureFlags featureFlags = {
 };
 configurable string[] restrictedChangeRequestStateIds = ["-3", "-4", "-5"];
 
+# Validate deployment usage import request.
+#
+# + req - Request containing zip file binary body
+# + return - Error message if validation fails, nil otherwise
+isolated function validateDeploymentUsageImportRequest(http:Request req) returns string? {
+    string contentType = req.getContentType();
+    if contentType.trim().length() == 0 {
+        return "Content-Type header is required.";
+    }
+
+    string baseType = re `;`.split(contentType.trim().toLowerAscii())[0].trim();
+    if baseType != "application/zip" && baseType != "application/x-zip-compressed" {
+        return "Request body must be a zip file.";
+    }
+    return;
+}
+
 # Search cases for a given project.
 #
 # + idToken - ID token for authorization