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")

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

@@ -6,6 +6,8 @@ import PlansList from "../../../Models/Plans/Plans";
 import {
     SysAdminExtendUserSubscriptionParams,
     SysAdminExtendUserSubscriptionResult,
+    SysAdminFinalizeUserSubscriptionParams,
+    SysAdminFinalizeUserSubscriptionResult,
     SysAdminUserSubscriptionDetailsParams,
     SysAdminUserSubscriptionDetailsResult,
 } from "../../../Models/Users/Users.Interface";
@@ -86,6 +88,42 @@ export class SysAdminSubscriptionsService {
         };
     }
 
+    public async finalizeUserSubscription(
+        params: SysAdminFinalizeUserSubscriptionParams
+    ): Promise<SysAdminFinalizeUserSubscriptionResult> {
+        await connect(`${process.env.DATABASE_CONNECTION}`);
+
+        if (!params.userId || !isValidObjectId(params.userId)) {
+            throw new Error("User id is required");
+        }
+
+        const subscription = await PlanSubscriptionsList.findOne({ sessionUser: params.userId });
+        if (!subscription) {
+            throw new Error("No subscription found for user");
+        }
+
+        const previousEndDate = subscription.endDate ? new Date(subscription.endDate) : new Date();
+        const newEndDate = dayjs().subtract(1, "day").startOf("day").toDate();
+        const plan = await PlansList.plans.findOne({ _id: String(subscription.planId) });
+
+        subscription.endDate = newEndDate;
+        await subscription.save();
+
+        if (plan && plan.price > 0) {
+            await PlanSubscriptionsList.toFreePlan({
+                sessionUser: params.userId,
+                downgradeReason: "expired",
+            });
+        }
+
+        return {
+            userId: params.userId,
+            subscriptionId: String(subscription.id),
+            previousEndDate,
+            newEndDate,
+        };
+    }
+
     public async getUserSubscriptionDetails(
         params: SysAdminUserSubscriptionDetailsParams
     ): Promise<SysAdminUserSubscriptionDetailsResult> {