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

sysadmin-cli/src/api/sysadmin.ts

@@ -109,6 +109,23 @@ export const extendUserSubscription = async (data: ExtendUserSubscriptionPayload
     return res.data;
 };
 
+export type FinalizeUserSubscriptionPayload = {
+    userId: string;
+    reason?: string;
+};
+
+export type FinalizeUserSubscriptionResult = {
+    userId: string;
+    subscriptionId: string;
+    previousEndDate: string;
+    newEndDate: string;
+};
+
+export const finalizeUserSubscription = async (data: FinalizeUserSubscriptionPayload): Promise<FinalizeUserSubscriptionResult> => {
+    const res = await sysadminApi.post('/users/finalize-subscription', data);
+    return res.data;
+};
+
 export type Plan = {
     id?: string;
     _id?: string;