feat: add manual subscription finalization functionality and support for expired plan notifications

sysadmin/src/controllers/users.controller.ts

@@ -8,6 +8,7 @@ import {
     SysAdminOrganizationsStatusParams,
     SysAdminRecalculatePlanUsageCycleParams,
     SysAdminExtendUserSubscriptionParams,
+    SysAdminFinalizeUserSubscriptionParams,
     SysAdminUserSubscriptionDetailsParams,
 } from "../models/Users.Model";
 
@@ -101,4 +102,15 @@ export class UsersController {
             res.status(500).json(error?.response?.data || { success: false, message: "Internal Server Error" });
         }
     };
+
+    public finalizeSubscription = async (req: Request, res: Response): Promise<void> => {
+        try {
+            const data: SysAdminFinalizeUserSubscriptionParams = req.body;
+            const result = await usersService.finalizeSubscription(data);
+            res.json(result);
+        } catch (error: any) {
+            console.error("Error finalizing subscription:", error?.response?.data || error);
+            res.status(500).json(error?.response?.data || { success: false, message: "Internal Server Error" });
+        }
+    };
 }