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

server/src/api/SysAdmin/Subscriptions/SysAdminSubscriptions.Controller.ts

@@ -4,6 +4,8 @@ import { sysAdminAuthMiddleware } from "../../../middleware/sysadminAuth";
 import {
     SysAdminExtendUserSubscriptionParams,
     SysAdminExtendUserSubscriptionResult,
+    SysAdminFinalizeUserSubscriptionParams,
+    SysAdminFinalizeUserSubscriptionResult,
     SysAdminUserSubscriptionDetailsParams,
     SysAdminUserSubscriptionDetailsResult,
 } from "../../../Models/Users/Users.Interface";
@@ -29,6 +31,23 @@ export class SysAdminSubscriptionsController extends Controller {
         }
     }
 
+    @Response<ApiValidationError>(500, "Ha ocurrido un error")
+    @SuccessResponse(200, "Done")
+    @Post("finalize-user")
+    public async finalizeUserSubscription(
+        @Body() requestBody: SysAdminFinalizeUserSubscriptionParams
+    ): Promise<SysAdminFinalizeUserSubscriptionResult | ApiValidationError> {
+        try {
+            const result = await new SysAdminSubscriptionsService().finalizeUserSubscription(requestBody);
+            this.setStatus(200);
+            return result;
+        } catch (e) {
+            const errorOccurred: Error = e as Error;
+            this.setStatus(500);
+            return new ApiValidationError(500, errorOccurred.message);
+        }
+    }
+
     @Response<ApiValidationError>(500, "Ha ocurrido un error")
     @SuccessResponse(200, "Done")
     @Post("user-details")