@bash-app/bash-common 29.42.1 → 29.42.2

package/src/utils/paymentUtils.ts

@@ -1,56 +1,56 @@
-import {BashEventPromoCode, TicketTier} from "@prisma/client";
-import {BASH_FEE_PERCENTAGE, NumberOfTicketsForDate, PRICE_DOLLARS_AND_CENTS_RATIO} from "../definitions";
-
-
-/**
- * Returns the amount of discount in dollars
- * @param totalInDollars
- * @param promoCode
- */
-export function calculateDiscountFromPromoCode(totalInDollars: number, promoCode: BashEventPromoCode | undefined): number {
-  if (promoCode) {
-    if (promoCode.discountAmountInCents) {
-      const discountInDollars = convertCentsToDollars(promoCode.discountAmountInCents);
-      return Math.max(0, discountInDollars); // Ensure we don't discount more than 100%
-    }
-    if (promoCode.discountAmountPercentage) {
-      const discountInDollars = totalInDollars * (promoCode.discountAmountPercentage / 100);
-      return Math.min(totalInDollars, discountInDollars); // Ensure we don't discount more than 100%
-    }
-  }
-  return 0;
-}
-
-
-/**
- * Returns the total price based on a map where the keys are the ticketTierIds
- * @param ticketTiers
- * @param ticketList
- */
-export function calculateTotalPriceWithoutTax(ticketTiers: TicketTier[], ticketList: Map<string, NumberOfTicketsForDate[]>): number {
-  let total = 0;
-  ticketTiers.forEach((tier: TicketTier) => {
-    const ticketListNumAndDate = ticketList.get(tier.id);
-    ticketListNumAndDate?.forEach((numAndDate: NumberOfTicketsForDate) => {
-      total += tier.price * (numAndDate.numberOfTickets ?? 0);
-    });
-  });
-  return total;
-}
-
-export function convertCentsToDollars(price: number | undefined | null): number {
-  if (!price) {
-    return 0;
-  }
-  return price / PRICE_DOLLARS_AND_CENTS_RATIO;
-}
-export function convertDollarsToCents(price: number | undefined | null): number {
-  if (!price) {
-    return 0;
-  }
-  return price * PRICE_DOLLARS_AND_CENTS_RATIO;
-}
-
-export function calculateBashAppFee(total: number): number {
-  return parseFloat((total * BASH_FEE_PERCENTAGE).toFixed(2));
-}
+import {BashEventPromoCode, TicketTier} from "@prisma/client";
+import {BASH_FEE_PERCENTAGE, NumberOfTicketsForDate, PRICE_DOLLARS_AND_CENTS_RATIO} from "../definitions";
+
+
+/**
+ * Returns the amount of discount in dollars
+ * @param totalInDollars
+ * @param promoCode
+ */
+export function calculateDiscountFromPromoCode(totalInDollars: number, promoCode: BashEventPromoCode | undefined): number {
+  if (promoCode) {
+    if (promoCode.discountAmountInCents) {
+      const discountInDollars = convertCentsToDollars(promoCode.discountAmountInCents);
+      return Math.max(0, discountInDollars); // Ensure we don't discount more than 100%
+    }
+    if (promoCode.discountAmountPercentage) {
+      const discountInDollars = totalInDollars * (promoCode.discountAmountPercentage / 100);
+      return Math.min(totalInDollars, discountInDollars); // Ensure we don't discount more than 100%
+    }
+  }
+  return 0;
+}
+
+
+/**
+ * Returns the total price based on a map where the keys are the ticketTierIds
+ * @param ticketTiers
+ * @param ticketList
+ */
+export function calculateTotalPriceWithoutTax(ticketTiers: TicketTier[], ticketList: Map<string, NumberOfTicketsForDate[]>): number {
+  let total = 0;
+  ticketTiers.forEach((tier: TicketTier) => {
+    const ticketListNumAndDate = ticketList.get(tier.id);
+    ticketListNumAndDate?.forEach((numAndDate: NumberOfTicketsForDate) => {
+      total += tier.price * (numAndDate.numberOfTickets ?? 0);
+    });
+  });
+  return total;
+}
+
+export function convertCentsToDollars(price: number | undefined | null): number {
+  if (!price) {
+    return 0;
+  }
+  return price / PRICE_DOLLARS_AND_CENTS_RATIO;
+}
+export function convertDollarsToCents(price: number | undefined | null): number {
+  if (!price) {
+    return 0;
+  }
+  return price * PRICE_DOLLARS_AND_CENTS_RATIO;
+}
+
+export function calculateBashAppFee(total: number): number {
+  return parseFloat((total * BASH_FEE_PERCENTAGE).toFixed(2));
+}

package/src/utils/promoCodesUtils.ts

@@ -1,29 +1,29 @@
-import {BashEventExt, TicketTierExt} from "../extendedSchemas";
-import {BashEventPromoCode} from "@prisma/client";
-
-
-export function findPromoCodeFromBashEvent(bashEvent: BashEventExt | undefined | null,
-                                           promoCodeId: string | undefined): BashEventPromoCode | undefined {
-  if (!promoCodeId) {
-    return;
-  }
-  if (bashEvent?.ticketTiers.length) {
-    for (const tier of bashEvent?.ticketTiers) {
-      const foundPromoCode = tier.promoCodes.find((promoCode) => promoCode.id === promoCodeId);
-      if (foundPromoCode) {
-        return foundPromoCode;
-      }
-    }
-  }
-}
-
-export function getPromoCodesFromBashEvent(bashEvent: BashEventExt | undefined | null): BashEventPromoCode[] {
-  const ticketTiersWithPromoCode: TicketTierExt[] = bashEvent?.ticketTiers?.filter(ticketTier => ticketTier?.promoCodes?.length) ?? [];
-  return ticketTiersWithPromoCode.map(ticketTier => ticketTier.promoCodes).flat() as BashEventPromoCode[] ?? [];
-}
-
-export function updatePromoCodesOnBashEventTicketTiers(bashEvent: BashEventExt, promoCodes: BashEventPromoCode[]): void {
-  bashEvent.ticketTiers.forEach((tier) => {
-    tier.promoCodes = promoCodes.filter((pc) => tier.id === pc.ticketTierId);
-  });
-}
+import {BashEventExt, TicketTierExt} from "../extendedSchemas";
+import {BashEventPromoCode} from "@prisma/client";
+
+
+export function findPromoCodeFromBashEvent(bashEvent: BashEventExt | undefined | null,
+                                           promoCodeId: string | undefined): BashEventPromoCode | undefined {
+  if (!promoCodeId) {
+    return;
+  }
+  if (bashEvent?.ticketTiers.length) {
+    for (const tier of bashEvent?.ticketTiers) {
+      const foundPromoCode = tier.promoCodes.find((promoCode) => promoCode.id === promoCodeId);
+      if (foundPromoCode) {
+        return foundPromoCode;
+      }
+    }
+  }
+}
+
+export function getPromoCodesFromBashEvent(bashEvent: BashEventExt | undefined | null): BashEventPromoCode[] {
+  const ticketTiersWithPromoCode: TicketTierExt[] = bashEvent?.ticketTiers?.filter(ticketTier => ticketTier?.promoCodes?.length) ?? [];
+  return ticketTiersWithPromoCode.map(ticketTier => ticketTier.promoCodes).flat() as BashEventPromoCode[] ?? [];
+}
+
+export function updatePromoCodesOnBashEventTicketTiers(bashEvent: BashEventExt, promoCodes: BashEventPromoCode[]): void {
+  bashEvent.ticketTiers.forEach((tier) => {
+    tier.promoCodes = promoCodes.filter((pc) => tier.id === pc.ticketTierId);
+  });
+}

package/src/utils/qrCodeUtils.ts

@@ -1,23 +1,23 @@
-import QRCode from "qrcode";
-import { TICKET_DETAILS } from "../definitions";
-
-export function bashEventPrismaCheckoutQrCodeUrl(bashEventId: string | undefined | null, prismaCheckoutId: string | undefined | null): string {
-  return `${TICKET_DETAILS}/${bashEventId}/${prismaCheckoutId}`;
-}
-
-export function bashEventQrCodeUrl(bashEventId: string | undefined | null, ticketTierId?: string | undefined | null, ticketId?: string | undefined | null): string {
-  const baseUrl = `${TICKET_DETAILS}/${bashEventId}`;
-  if (ticketId) {
-    return `${baseUrl}/ticket/${ticketId}`;
-  }
-  else if (ticketTierId) {
-    return `${baseUrl}/ticket-tier/${ticketTierId}`;
-  }
-  return baseUrl;
-}
-
-export async function createQrCodeImage(qrData: string): Promise<string> {
-  return QRCode.toDataURL(qrData, {
-    errorCorrectionLevel: 'high',
-  });
-}
+import QRCode from "qrcode";
+import { TICKET_DETAILS } from "../definitions";
+
+export function bashEventPrismaCheckoutQrCodeUrl(bashEventId: string | undefined | null, prismaCheckoutId: string | undefined | null): string {
+  return `${TICKET_DETAILS}/${bashEventId}/${prismaCheckoutId}`;
+}
+
+export function bashEventQrCodeUrl(bashEventId: string | undefined | null, ticketTierId?: string | undefined | null, ticketId?: string | undefined | null): string {
+  const baseUrl = `${TICKET_DETAILS}/${bashEventId}`;
+  if (ticketId) {
+    return `${baseUrl}/ticket/${ticketId}`;
+  }
+  else if (ticketTierId) {
+    return `${baseUrl}/ticket-tier/${ticketTierId}`;
+  }
+  return baseUrl;
+}
+
+export async function createQrCodeImage(qrData: string): Promise<string> {
+  return QRCode.toDataURL(qrData, {
+    errorCorrectionLevel: 'high',
+  });
+}

package/src/utils/recurrenceUtils.ts

@@ -1,175 +1,175 @@
-import {DayOfWeek, Recurrence, RecurringFrequency} from "@prisma/client";
-import dayjs, {Dayjs} from "dayjs";
-import dayjsWeekDay from "dayjs/plugin/weekday";
-import {DateTimeArgType} from "../definitions";
-import {compareDateTime, DATETIME_FORMAT_ISO_LIKE} from "./dateTimeUtils";
-
-dayjs.extend(dayjsWeekDay);
-
-
-export function getRecurringBashEventPossibleDateTimes(startDateTime: DateTimeArgType,
-                                                       recurrence: Recurrence | undefined | null): Date[] {
-  return getRecurringBashEventPossibleDatesTimesInternal(startDateTime, recurrence, true) as Date[];
-}
-
-export function getRecurringBashEventPossibleDayjsTimes(startDateTime: DateTimeArgType,
-                                                        recurrence: Recurrence | undefined | null): Dayjs[] {
-  return getRecurringBashEventPossibleDatesTimesInternal(startDateTime, recurrence, false) as Dayjs[];
-}
-
-
-function getRecurringBashEventPossibleDatesTimesInternal(startDateTime: DateTimeArgType,
-                                                         recurrence: Recurrence | undefined | null,
-                                                         toDate: boolean): (Dayjs | Date)[] {
-  if (!recurrence || !recurrence.frequency || recurrence.frequency === RecurringFrequency.Never) {
-    return [];
-  }
-
-  let recurrenceDates: Dayjs[] = [];
-  const beginningDate = findEarliestPossibleBashEventDate(startDateTime) as Dayjs; // Don't allow dates before the current date
-
-  switch (recurrence.frequency) {
-    case RecurringFrequency.Weekly:
-      recurrenceDates = getWeeklyRecurringDates(beginningDate, recurrence);
-      break;
-    default:
-      console.error(`Only weekly frequency is currently supported`);
-  }
-  return recurrenceDates.map((date: Dayjs): string => date.format(DATETIME_FORMAT_ISO_LIKE))
-                        .sort()
-                        .map((dateStr: string): Dayjs | Date => {
-                          if (toDate) {
-                            return dayjs(dateStr).toDate();
-                          }
-                          else {
-                            return dayjs(dateStr);
-                          }
-                        });
-}
-
-/**
- * Get the weekly recurring dates
- * @param beginningDateTime The beginning DateTime of the event, adjusted to be no earlier than now.
- * @param recurrence
- */
-function getWeeklyRecurringDates(beginningDateTime: Dayjs, recurrence: Recurrence): Dayjs[] {
-  if (recurrence.frequency !== RecurringFrequency.Weekly) {
-    throw new Error(`Cannot do a weekly recurrence if the frequency isn't weekly.`);
-  }
-
-  const interval = recurrence.interval ?? 1;
-  const recurrenceEnds = dayjs(recurrence.ends).endOf('day'); // Get the end of the day to not miss the last day
-  const numberOfDays = recurrenceEnds.diff(beginningDateTime, 'days');
-  const numberOfWeeks = Math.ceil((numberOfDays / 7) / interval); // Get the number of days and then round up so that we include the ending date
-
-  const recurrenceDates: Dayjs[] = [];
-  let theNextWeekOfRecurrences = beginningDateTime;
-
-  // Go week by week getting the next recurrence date
-  for (let i = 0; i < numberOfWeeks; i++) {
-    let weekday: Dayjs | null = null;
-    for (const dayOfWeekEnum of recurrence.repeatOnDays) {
-      const dayOfWeekNum = dayOfWeekEnumToDayNumber(dayOfWeekEnum);
-      weekday = theNextWeekOfRecurrences.weekday(dayOfWeekNum);
-      if (weekday > recurrenceEnds || weekday < beginningDateTime) {
-        continue; // Continue because repeatOnDays isn't sorted by the day of the week
-      }
-      // Set the time on the date so that it matches the time when the event starts
-      weekday = copyTimeToDate(beginningDateTime, weekday);
-      recurrenceDates.push(weekday);
-    }
-    if (weekday) {
-      theNextWeekOfRecurrences = getBeginningOfWeekInterval(weekday, interval);
-    }
-  }
-  return recurrenceDates;
-}
-
-function copyTimeToDate(dateWithTimeToCopy: Dayjs, dateWhoseTimeToChange: Dayjs): Dayjs {
-  if (dateWithTimeToCopy.second() !== 0) {
-    console.warn(`dateWithTimeToCopy has non-zero seconds: ${dateWithTimeToCopy.toString()} \nFixing...`);
-    dateWithTimeToCopy = dateWithTimeToCopy.set('seconds', 0);
-  }
-  dateWhoseTimeToChange = dateWhoseTimeToChange.set('hours', dateWithTimeToCopy.hour());
-  dateWhoseTimeToChange = dateWhoseTimeToChange.set('minutes', dateWithTimeToCopy.minute());
-  dateWhoseTimeToChange = dateWhoseTimeToChange.set('seconds', 0); // Should be 0
-  return dateWhoseTimeToChange;
-}
-
-function dayOfWeekEnumToDayNumber(dayEnum: DayOfWeek): number {
-  switch (dayEnum) {
-    case DayOfWeek.Sunday:
-      return 0;
-    case DayOfWeek.Monday:
-      return 1;
-    case DayOfWeek.Tuesday:
-      return 2;
-    case DayOfWeek.Wednesday:
-      return 3;
-    case DayOfWeek.Thursday:
-      return 4;
-    case DayOfWeek.Friday:
-      return 5;
-    case DayOfWeek.Saturday:
-      return 6;
-    default:
-      throw new Error(`How did this happen? Invalid DayOfWeek: ${dayEnum}`); // Shouldn't happen
-  }
-}
-
-/**
- * Get the next week determined by the interval by going to the end of the week interval and adding one day
- * @param date
- * @param interval
- */
-function getBeginningOfWeekInterval(date: Dayjs, interval: number): Dayjs {
-  if (!interval) {
-    interval = 1; // Avoid 0
-  }
-  // An interval of 2 would be (2 - 1) * 7 + 1 = 8 days to add to skip a week and go into the next week
-  const numberOfDaysToAdd = interval > 1 ? (interval - 1) * 7 + 1 : 1;
-  return date.endOf('week').add(numberOfDaysToAdd, 'day');
-}
-
-export function freqToGrammarString(freq: RecurringFrequency, interval: number | undefined, toLowerCase: boolean = false): string {
-  if (!interval) {
-    return freq;
-  }
-  const isPlural = interval > 1;
-  let result: string = freq;
-  switch (freq) {
-    case RecurringFrequency.Daily:
-      result = isPlural ? 'Days' : 'Day';
-      break;
-    case RecurringFrequency.Weekly:
-      result = isPlural ? 'Weeks' : 'Week';
-      break;
-    case RecurringFrequency.Monthly:
-      result = isPlural ? 'Months' : 'Month';
-      break;
-    case RecurringFrequency.Yearly:
-      result = isPlural ? 'Years' : 'Year';
-      break;
-  }
-  return toLowerCase ? result.toLowerCase() : result;
-}
-
-export function findEarliestPossibleBashEventDate(startDateTimeArg: DateTimeArgType): Dayjs | undefined {
-  return findEarliestOrLatestPossibleBashEventDate(startDateTimeArg, true);
-}
-
-function findEarliestOrLatestPossibleBashEventDate(startDateTimeArg: DateTimeArgType, findEarly: boolean): Dayjs | undefined {
-  if (!startDateTimeArg) {
-    return;
-  }
-  // Don't allow dates before the current date
-  const startDateTime = dayjs(startDateTimeArg);
-  const currentDateTime = dayjs();
-  const comparedDateTime = compareDateTime(currentDateTime.toDate(), startDateTimeArg);
-  if (findEarly) {
-    return comparedDateTime > 0 ? currentDateTime : startDateTime;
-  }
-  else {
-    return comparedDateTime < 0 ? currentDateTime : startDateTime;
-  }
-}
+import {DayOfWeek, Recurrence, RecurringFrequency} from "@prisma/client";
+import dayjs, {Dayjs} from "dayjs";
+import dayjsWeekDay from "dayjs/plugin/weekday";
+import {DateTimeArgType} from "../definitions";
+import {compareDateTime, DATETIME_FORMAT_ISO_LIKE} from "./dateTimeUtils";
+
+dayjs.extend(dayjsWeekDay);
+
+
+export function getRecurringBashEventPossibleDateTimes(startDateTime: DateTimeArgType,
+                                                       recurrence: Recurrence | undefined | null): Date[] {
+  return getRecurringBashEventPossibleDatesTimesInternal(startDateTime, recurrence, true) as Date[];
+}
+
+export function getRecurringBashEventPossibleDayjsTimes(startDateTime: DateTimeArgType,
+                                                        recurrence: Recurrence | undefined | null): Dayjs[] {
+  return getRecurringBashEventPossibleDatesTimesInternal(startDateTime, recurrence, false) as Dayjs[];
+}
+
+
+function getRecurringBashEventPossibleDatesTimesInternal(startDateTime: DateTimeArgType,
+                                                         recurrence: Recurrence | undefined | null,
+                                                         toDate: boolean): (Dayjs | Date)[] {
+  if (!recurrence || !recurrence.frequency || recurrence.frequency === RecurringFrequency.Never) {
+    return [];
+  }
+
+  let recurrenceDates: Dayjs[] = [];
+  const beginningDate = findEarliestPossibleBashEventDate(startDateTime) as Dayjs; // Don't allow dates before the current date
+
+  switch (recurrence.frequency) {
+    case RecurringFrequency.Weekly:
+      recurrenceDates = getWeeklyRecurringDates(beginningDate, recurrence);
+      break;
+    default:
+      console.error(`Only weekly frequency is currently supported`);
+  }
+  return recurrenceDates.map((date: Dayjs): string => date.format(DATETIME_FORMAT_ISO_LIKE))
+                        .sort()
+                        .map((dateStr: string): Dayjs | Date => {
+                          if (toDate) {
+                            return dayjs(dateStr).toDate();
+                          }
+                          else {
+                            return dayjs(dateStr);
+                          }
+                        });
+}
+
+/**
+ * Get the weekly recurring dates
+ * @param beginningDateTime The beginning DateTime of the event, adjusted to be no earlier than now.
+ * @param recurrence
+ */
+function getWeeklyRecurringDates(beginningDateTime: Dayjs, recurrence: Recurrence): Dayjs[] {
+  if (recurrence.frequency !== RecurringFrequency.Weekly) {
+    throw new Error(`Cannot do a weekly recurrence if the frequency isn't weekly.`);
+  }
+
+  const interval = recurrence.interval ?? 1;
+  const recurrenceEnds = dayjs(recurrence.ends).endOf('day'); // Get the end of the day to not miss the last day
+  const numberOfDays = recurrenceEnds.diff(beginningDateTime, 'days');
+  const numberOfWeeks = Math.ceil((numberOfDays / 7) / interval); // Get the number of days and then round up so that we include the ending date
+
+  const recurrenceDates: Dayjs[] = [];
+  let theNextWeekOfRecurrences = beginningDateTime;
+
+  // Go week by week getting the next recurrence date
+  for (let i = 0; i < numberOfWeeks; i++) {
+    let weekday: Dayjs | null = null;
+    for (const dayOfWeekEnum of recurrence.repeatOnDays) {
+      const dayOfWeekNum = dayOfWeekEnumToDayNumber(dayOfWeekEnum);
+      weekday = theNextWeekOfRecurrences.weekday(dayOfWeekNum);
+      if (weekday > recurrenceEnds || weekday < beginningDateTime) {
+        continue; // Continue because repeatOnDays isn't sorted by the day of the week
+      }
+      // Set the time on the date so that it matches the time when the event starts
+      weekday = copyTimeToDate(beginningDateTime, weekday);
+      recurrenceDates.push(weekday);
+    }
+    if (weekday) {
+      theNextWeekOfRecurrences = getBeginningOfWeekInterval(weekday, interval);
+    }
+  }
+  return recurrenceDates;
+}
+
+function copyTimeToDate(dateWithTimeToCopy: Dayjs, dateWhoseTimeToChange: Dayjs): Dayjs {
+  if (dateWithTimeToCopy.second() !== 0) {
+    console.warn(`dateWithTimeToCopy has non-zero seconds: ${dateWithTimeToCopy.toString()} \nFixing...`);
+    dateWithTimeToCopy = dateWithTimeToCopy.set('seconds', 0);
+  }
+  dateWhoseTimeToChange = dateWhoseTimeToChange.set('hours', dateWithTimeToCopy.hour());
+  dateWhoseTimeToChange = dateWhoseTimeToChange.set('minutes', dateWithTimeToCopy.minute());
+  dateWhoseTimeToChange = dateWhoseTimeToChange.set('seconds', 0); // Should be 0
+  return dateWhoseTimeToChange;
+}
+
+function dayOfWeekEnumToDayNumber(dayEnum: DayOfWeek): number {
+  switch (dayEnum) {
+    case DayOfWeek.Sunday:
+      return 0;
+    case DayOfWeek.Monday:
+      return 1;
+    case DayOfWeek.Tuesday:
+      return 2;
+    case DayOfWeek.Wednesday:
+      return 3;
+    case DayOfWeek.Thursday:
+      return 4;
+    case DayOfWeek.Friday:
+      return 5;
+    case DayOfWeek.Saturday:
+      return 6;
+    default:
+      throw new Error(`How did this happen? Invalid DayOfWeek: ${dayEnum}`); // Shouldn't happen
+  }
+}
+
+/**
+ * Get the next week determined by the interval by going to the end of the week interval and adding one day
+ * @param date
+ * @param interval
+ */
+function getBeginningOfWeekInterval(date: Dayjs, interval: number): Dayjs {
+  if (!interval) {
+    interval = 1; // Avoid 0
+  }
+  // An interval of 2 would be (2 - 1) * 7 + 1 = 8 days to add to skip a week and go into the next week
+  const numberOfDaysToAdd = interval > 1 ? (interval - 1) * 7 + 1 : 1;
+  return date.endOf('week').add(numberOfDaysToAdd, 'day');
+}
+
+export function freqToGrammarString(freq: RecurringFrequency, interval: number | undefined, toLowerCase: boolean = false): string {
+  if (!interval) {
+    return freq;
+  }
+  const isPlural = interval > 1;
+  let result: string = freq;
+  switch (freq) {
+    case RecurringFrequency.Daily:
+      result = isPlural ? 'Days' : 'Day';
+      break;
+    case RecurringFrequency.Weekly:
+      result = isPlural ? 'Weeks' : 'Week';
+      break;
+    case RecurringFrequency.Monthly:
+      result = isPlural ? 'Months' : 'Month';
+      break;
+    case RecurringFrequency.Yearly:
+      result = isPlural ? 'Years' : 'Year';
+      break;
+  }
+  return toLowerCase ? result.toLowerCase() : result;
+}
+
+export function findEarliestPossibleBashEventDate(startDateTimeArg: DateTimeArgType): Dayjs | undefined {
+  return findEarliestOrLatestPossibleBashEventDate(startDateTimeArg, true);
+}
+
+function findEarliestOrLatestPossibleBashEventDate(startDateTimeArg: DateTimeArgType, findEarly: boolean): Dayjs | undefined {
+  if (!startDateTimeArg) {
+    return;
+  }
+  // Don't allow dates before the current date
+  const startDateTime = dayjs(startDateTimeArg);
+  const currentDateTime = dayjs();
+  const comparedDateTime = compareDateTime(currentDateTime.toDate(), startDateTimeArg);
+  if (findEarly) {
+    return comparedDateTime > 0 ? currentDateTime : startDateTime;
+  }
+  else {
+    return comparedDateTime < 0 ? currentDateTime : startDateTime;
+  }
+}