feat: Dynamic Recurring Event Instances Generation during Queries

INSTALLATION.md

@@ -41,7 +41,7 @@ This document provides instructions on how to set up and start a running instanc
       - [Setting up the RECAPTCHA_SECRET_KEY](#setting-up-the-recaptcha_secret_key)
       - [Setting up .env MAIL_USERNAME and MAIL_PASSWORD ReCAPTCHA Parameters](#setting-up-env-mail_username-and-mail_password-recaptcha-parameters)
     - [Setting up SMTP Email Variables in the .env File](#setting-up-smtp-email-variables-in-the-env-file)
-    - [Setting up Logger configurations _(optional)_](#setting-up-logger-configurations-_optional_)
+    - [Setting up Logger configurations](#setting-up-logger-configurations)
       - [Setting up COLORIZE_LOGS in .env file](#setting-up-colorize_logs-in-env-file)
       - [Setting up LOG_LEVEL in .env file](#setting-up-log_level-in-env-file)
 - [Importing Sample Database](#importing-sample-database)

src/constants.ts

@@ -545,6 +545,11 @@ export const RECURRING_EVENT_INSTANCES_WEEKLY_LIMIT = 2;
 export const RECURRING_EVENT_INSTANCES_MONTHLY_LIMIT = 5;
 export const RECURRING_EVENT_INSTANCES_YEARLY_LIMIT = 10;
 
+// recurrence rules query date limit in years
+// i.e. query limit date to find the pending recurrence patterns
+// and then generate new instances ahead of this date
+export const RECURRING_EVENT_INSTANCES_QUERY_LIMIT = 1;
+
 // recurring event days
 export const RECURRENCE_WEEKDAYS = [
   "MONDAY",

src/helpers/event/createEventHelpers/createRecurringEventInstancesDuringQuery.ts

@@ -0,0 +1,154 @@
+import { addDays, addYears } from "date-fns";
+import { RecurrenceRule } from "../../../models/RecurrenceRule";
+import { convertToUTCDate } from "../../../utilities/recurrenceDatesUtil";
+import { Event } from "../../../models";
+import {
+  generateRecurringEventInstances,
+  getRecurringInstanceDates,
+} from "../recurringEventHelpers";
+import { session } from "../../../db";
+import type { Recurrance } from "../../../types/generatedGraphQLTypes";
+import type { InterfaceRecurringEvent } from "../recurringEventHelpers/generateRecurringEventInstances";
+import { RECURRING_EVENT_INSTANCES_QUERY_LIMIT } from "../../../constants";
+
+/**
+ * This function creates the instances of a recurring event upto a certain date during queries.
+ * @param organizationId - _id of the organization the events belong to
+ * @remarks The following steps are followed:
+ * 1. Get the limit date upto which we would want to query the recurrenceRules and generate new instances.
+ * 2. Get the recurrence rules to be used for instance generation during this query.
+ * 3. For every recurrence rule found:
+ *   - find the base recurring event to get the data to be used for new instance generation.
+ *   - get the number of existing instances and how many more to generate based on the recurrenceRule's count (if specified).
+ *   - generate new instances after their latestInstanceDates.
+ *   - update the latestInstanceDate.
+ */
+
+export const createRecurringEventInstancesDuringQuery = async (
+  organizationId: string | undefined | null,
+): Promise<void> => {
+  if (!organizationId) {
+    return;
+  }
+
+  // get the current calendar date in UTC midnight
+  const calendarDate = convertToUTCDate(new Date());
+  const queryUptoDate = addYears(
+    calendarDate,
+    RECURRING_EVENT_INSTANCES_QUERY_LIMIT,
+  );
+
+  // get the recurrenceRules
+  const recurrenceRules = await RecurrenceRule.find({
+    organizationId,
+    latestInstanceDate: { $lt: queryUptoDate },
+  }).lean();
+
+  await Promise.all(
+    recurrenceRules.map(async (recurrenceRule) => {
+      // find the baseRecurringEvent for the recurrenceRule
+      const baseRecurringEvent = await Event.find({
+        _id: recurrenceRule.baseRecurringEventId,
+      }).lean();
+
+      // get the data from the baseRecurringEvent
+      const {
+        _id: baseRecurringEventId,
+        recurrance,
+        ...data
+      } = baseRecurringEvent[0];
+
+      // get the input data for the generateRecurringEventInstances function
+      const currentInputData: InterfaceRecurringEvent = {
+        ...data,
+        organizationId: recurrenceRule.organizationId.toString(),
+        recurrance: recurrance as Recurrance,
+      };
+
+      // get the properties from recurrenceRule
+      const {
+        _id: recurrenceRuleId,
+        latestInstanceDate,
+        recurrenceRuleString,
+        endDate: recurrenceEndDate,
+        count: totalInstancesCount,
+      } = recurrenceRule;
+
+      // get the date from which new instances would be generated
+      const currentRecurrenceStartDate = addDays(latestInstanceDate, 1);
+
+      // get the dates for recurrence
+      let recurringInstanceDates = getRecurringInstanceDates(
+        recurrenceRuleString,
+        currentRecurrenceStartDate,
+        recurrenceEndDate,
+        queryUptoDate,
+      );
+
+      // find out how many instances following the recurrence rule already exist and how many more to generate
+      if (totalInstancesCount) {
+        const totalExistingInstances = await Event.countDocuments({
+          recurrenceRuleId,
+        });
+
+        const remainingInstances = totalInstancesCount - totalExistingInstances;
+
+        recurringInstanceDates = recurringInstanceDates.slice(
+          0,
+          Math.min(recurringInstanceDates.length, remainingInstances),
+        );
+      }
+
+      /* c8 ignore start */
+      if (session) {
+        // start a transaction
+        session.startTransaction();
+      }
+
+      /* c8 ignore stop */
+      try {
+        if (recurringInstanceDates && recurringInstanceDates.length) {
+          const updatedLatestRecurringInstanceDate =
+            recurringInstanceDates[recurringInstanceDates.length - 1];
+
+          // update the latestInstanceDate of the recurrenceRule
+          await RecurrenceRule.updateOne(
+            {
+              _id: recurrenceRuleId,
+            },
+            {
+              latestInstanceDate: updatedLatestRecurringInstanceDate,
+            },
+            { session },
+          );
+
+          // generate recurring event instances
+          await generateRecurringEventInstances({
+            data: currentInputData,
+            baseRecurringEventId: baseRecurringEventId.toString(),
+            recurrenceRuleId: recurrenceRuleId.toString(),
+            recurringInstanceDates,
+            creatorId: baseRecurringEvent[0].creatorId.toString(),
+            organizationId,
+            session,
+          });
+        }
+
+        /* c8 ignore start */
+        if (session) {
+          // commit transaction if everything's successful
+          await session.commitTransaction();
+        }
+      } catch (error) {
+        if (session) {
+          // abort transaction if something fails
+          await session.abortTransaction();
+        }
+
+        throw error;
+      }
+
+      /* c8 ignore stop */
+    }),
+  );
+};

src/helpers/event/createEventHelpers/index.ts

@@ -1,2 +1,3 @@
 export { createSingleEvent } from "./createSingleEvent";
 export { createRecurringEvent } from "./createRecurringEvent";
+export { createRecurringEventInstancesDuringQuery } from "./createRecurringEventInstancesDuringQuery";

src/helpers/event/recurringEventHelpers/generateRecurringEventInstances.ts

@@ -21,22 +21,24 @@ import { cacheEvents } from "../../../services/EventCache/cacheEvents";
  */
 
 interface InterfaceGenerateRecurringInstances {
-  data: EventInput;
+  data: InterfaceRecurringEvent;
   baseRecurringEventId: string;
   recurrenceRuleId: string;
   recurringInstanceDates: Date[];
   creatorId: string;
   organizationId: string;
+  status?: string;
   session: mongoose.ClientSession;
 }
 
-interface InterfaceRecurringEvent extends EventInput {
-  isBaseRecurringEvent: boolean;
-  recurrenceRuleId: string;
-  baseRecurringEventId: string;
-  creatorId: string;
-  admins: string[];
-  organization: string;
+export interface InterfaceRecurringEvent extends EventInput {
+  isBaseRecurringEvent?: boolean;
+  recurrenceRuleId?: string;
+  baseRecurringEventId?: string;
+  creatorId?: string;
+  admins?: string[];
+  organization?: string;
+  status?: string;
 }
 
 export const generateRecurringEventInstances = async ({
@@ -49,7 +51,7 @@ export const generateRecurringEventInstances = async ({
   session,
 }: InterfaceGenerateRecurringInstances): Promise<InterfaceEvent> => {
   const recurringInstances: InterfaceRecurringEvent[] = [];
-  recurringInstanceDates.map((date) => {
+  recurringInstanceDates.map((date): void => {
     const createdEventInstance = {
       ...data,
       startDate: date,
@@ -59,8 +61,9 @@ export const generateRecurringEventInstances = async ({
       recurrenceRuleId,
       baseRecurringEventId,
       creatorId,
-      admins: [creatorId],
+      admins: data.admins && data.admins.length ? data.admins : [creatorId],
       organization: organizationId,
+      status: data.status,
     };
 
     recurringInstances.push(createdEventInstance);

src/resolvers/Query/eventsByOrganizationConnection.ts

@@ -3,9 +3,14 @@ import type { InterfaceEvent } from "../../models";
 import { Event } from "../../models";
 import { getSort } from "./helperFunctions/getSort";
 import { getWhere } from "./helperFunctions/getWhere";
+import { createRecurringEventInstancesDuringQuery } from "../../helpers/event/createEventHelpers";
 
 export const eventsByOrganizationConnection: QueryResolvers["eventsByOrganizationConnection"] =
   async (_parent, args) => {
+    // dynamically generate recurring event instances upto a certain date during this query
+    await createRecurringEventInstancesDuringQuery(args.where?.organization_id);
+
+    // get the where and sort
     let where = getWhere<InterfaceEvent>(args.where);
     const sort = getSort(args.orderBy);
 
@@ -15,6 +20,7 @@ export const eventsByOrganizationConnection: QueryResolvers["eventsByOrganizatio
       isBaseRecurringEvent: false,
     };
 
+    // find all the events according to the requirements
     const events = await Event.find(where)
       .sort(sort)
       .limit(args.first ?? 0)