@churchapps/helpers 1.2.23 → 1.2.25

package/src/DateHelper.ts

@@ -1,183 +0,0 @@
-import dayjs from "dayjs"
-import utc from "dayjs/plugin/utc.js";
-import customParseFormat from "dayjs/plugin/customParseFormat.js";
-
-// Extend dayjs with plugins
-dayjs.extend(utc);
-dayjs.extend(customParseFormat);
-
-export class DateHelper {
-
-  //Fixes timezone issues when you just need the date.
-  static toDate(input: any) {
-    const str = input.toString();
-    // Check if it's a YYYY-MM-DD format (HTML5 date input)
-    const dateOnlyMatch = str.match(/^(\d{4})-(\d{2})-(\d{2})$/);
-    if (dateOnlyMatch) {
-      // Parse as local date at noon to avoid timezone issues
-      const [, year, month, day] = dateOnlyMatch;
-      return new Date(parseInt(year), parseInt(month) - 1, parseInt(day), 12, 0, 0);
-    }
-    // For other formats, use existing behavior
-    return new Date(Date.parse(str.replace("Z", "")));
-  }
-
-  static toDateTime(input: any) {
-    return new Date(Date.parse(input.toString()));
-  }
-
-  //obsolete.  Do not use
-  static convertToDate(input: any) {
-    return this.toDateTime(input);
-  }
-
-  static addDays(date: Date, days: number) {
-    const result = new Date(date.getTime());
-    result.setDate(result.getDate() + days);
-    return result;
-  }
-
-  static prettyDate(date: Date) {
-    if (date === undefined || date === null) return "";
-    return this.formatDateTime(date, "MMM d, yyyy");
-  }
-
-  static prettyDateTime(date: Date) {
-    if (date === undefined || date === null) return "";
-    return this.formatDateTime(date, "MMM d, yyyy h:mm a");
-  }
-
-  static prettyTime(date: Date) {
-    if (date === undefined || date === null) return "";
-    return this.formatDateTime(date, "h:mm a");
-  }
-
-  static getLastSunday() {
-    let result = new Date();
-    while (result.getDay() !== 0) result.setDate(result.getDate() - 1);
-    return result;
-  }
-
-  static getNextSunday() {
-    let result = this.getLastSunday();
-    result.setDate(result.getDate() + 7);
-    return result;
-  }
-
-  static getWeekSunday(year: number, week: number) {
-    let result = new Date(year, 0, 1);
-    while (result.getDay() !== 0) result.setDate(result.getDate() + 1);
-    result.setDate(result.getDate() + ((week - 1) * 7));
-    return result;
-  }
-
-  static formatHtml5Date(date: Date | string | null | undefined): string {
-    if (!date) return "";
-
-    // If already a YYYY-MM-DD string, return as-is
-    if (typeof date === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(date)) return date;
-
-    // If ISO string, extract date portion (ignore timezone)
-    if (typeof date === 'string') {
-      const match = date.match(/^(\d{4}-\d{2}-\d{2})/);
-      if (match) return match[1];
-    }
-
-    // For Date objects, use LOCAL year/month/day (not UTC)
-    const d = date instanceof Date ? date : new Date(date);
-    if (isNaN(d.getTime())) return "";
-
-    const year = d.getFullYear();
-    const month = String(d.getMonth() + 1).padStart(2, '0');
-    const day = String(d.getDate()).padStart(2, '0');
-    return `${year}-${month}-${day}`;
-  }
-
-  // For DATE-only fields - preserves calendar date without timezone conversion
-  static toMysqlDateOnly(date: Date | string | null | undefined): string | null {
-    if (date === null || date === undefined) return null;
-
-    if (typeof date === 'string') {
-      const match = date.match(/^(\d{4}-\d{2}-\d{2})/);
-      return match ? match[1] : null;
-    }
-
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, '0');
-    const day = String(date.getDate()).padStart(2, '0');
-    return `${year}-${month}-${day}`;
-  }
-
-  static formatHtml5Time(time: Date): string {
-    if (time === undefined || time === null) return "";
-    let h = time.getHours();
-    let m = time.getMinutes();
-    let s = time.getSeconds();
-    return `${h < 10 ? ("0" + h) : h}:${m < 10 ? ("0" + m) : m}:${s < 10 ? ("0" + s) : s}`;
-  }
-
-  static formatHtml5DateTime(date: Date): string {
-    if (date === undefined || date === null) return "";
-    else {
-      return this.formatDateTime(date, "yyyy-MM-dd") + "T" + this.formatDateTime(date, "HH:mm");
-    }
-  }
-
-  static getDisplayDuration(d: Date): string {
-    let seconds = Math.round((new Date().getTime() - d.getTime()) / 1000);
-    if (seconds > 86400) {
-      let days = Math.floor(seconds / 86400);
-      return (days === 1) ? "1d" : days.toString() + "d";
-    }
-    else if (seconds > 3600) {
-      let hours = Math.floor(seconds / 3600);
-      return (hours === 1) ? "1h" : hours.toString() + "h";
-    }
-    else if (seconds > 60) {
-      let minutes = Math.floor(seconds / 60);
-      return (minutes === 1) ? "1m" : minutes.toString() + "m";
-    }
-    else return (seconds === 1) ? "1s" : Math.floor(seconds).toString() + "s";
-  }
-
-  static getShortDate(d: Date): string {
-    return (d.getMonth() + 1).toString() + "/" + (d.getDate()).toString() + "/" + d.getFullYear().toString();
-  }
-
-  static convertDatePickerFormat(d: Date): Date {
-    const date = this.formatHtml5Date(d).split("-");
-    if (date.length === 3) return new Date(`${date[1]}-${date[2]}-${date[0]}`);
-    return new Date();
-  }
-
-  private static formatDateTime(date: Date, format: string) {
-    try {
-      // Convert date-fns format to dayjs format
-      const dayjsFormat = format
-        .replace(/yyyy/g, 'YYYY')
-        .replace(/yy/g, 'YY')
-        .replace(/d/g, 'D')
-        .replace(/DD/g, 'DD')
-        .replace(/a/g, 'A');
-      
-      return dayjs(date).format(dayjsFormat);
-    } catch { return ""; }
-  }
-
-  public static toMysqlDate(d: Date) {
-    if (d === null || d === undefined) {
-        return undefined;
-    }
-    return dayjs(d).format("YYYY-MM-DD HH:mm:ss")
-  }
-
-  public static subtractHoursFromNow(hour: number) {
-      const now = new Date();
-      return new Date(now.setHours(now.getHours() - hour));
-  }
-
-  public static toUTCDate(d: Date) {
-    return dayjs(d).utc().format("YYYY-MM-DD HH:mm:ss");
-  }
-
-}

package/src/DonationHelper.ts

@@ -1,26 +0,0 @@
-export class DonationHelper {
-
-  static getInterval(intervalName:string) {
-    let intervalCount = 1;
-    let intervalType = "month";
-    let parts = intervalName.split("_");
-    if (parts.length === 2) {
-      switch (parts[0])
-      {
-        case "two": intervalCount = 2; break;
-        case "three": intervalCount = 3; break;
-      }
-      intervalType = parts[1];
-    }
-    let result = { interval_count: intervalCount, interval: intervalType };
-    return result;
-  }
-
-  static getIntervalKeyName(intervalCount: number, intervalType: string) {
-    let firstPart = "one";
-    if (intervalCount === 2) firstPart = "two";
-    else if (intervalCount === 3) firstPart = "three";
-    return firstPart + "_" + intervalType;
-  }
-
-}

package/src/ErrorHelper.ts

@@ -1,39 +0,0 @@
-import { ErrorLogInterface, ErrorAppDataInterface } from "./interfaces/Error.js";
-import { ApiHelper } from "./ApiHelper.js";
-
-
-export class ErrorHelper {
-
-  static getAppData: () => { churchId: string, userId: string, originUrl: string, application: string };
-  static customErrorHandler: (errorLog: ErrorLogInterface) => void;
-
-  static init = (getAppData: () => ErrorAppDataInterface, customErrorHandler: (errorLog: ErrorLogInterface) => void) => {
-    ErrorHelper.getAppData = getAppData;
-    ErrorHelper.customErrorHandler = customErrorHandler;
-  }
-
-  static logError = (errorType: string, message: string, details: string) => {
-
-
-    if (this.getAppData) {
-      const data = this.getAppData();
-      const log: ErrorLogInterface = {
-        application: data.application,
-        errorTime: new Date(),
-        userId: data.userId,
-        churchId: data.churchId,
-        originUrl: data.originUrl,
-        errorType: errorType,
-        message: message,
-        details: details
-      }
-
-      if (log.errorType === "401" && log.message.indexOf("/users/login") > -1) return;
-      //temporarily disabled error logging
-      //ApiHelper.postAnonymous("/errors", [log], "MembershipApi");
-      if (ErrorHelper.customErrorHandler) ErrorHelper.customErrorHandler(log);
-    }
-  }
-
-
-}

package/src/EventHelper.ts

@@ -1,84 +0,0 @@
-import { EventInterface } from "./interfaces/index.js";
-
-// Lazy initialization to handle both bundlers and Node.js ESM
-let RRule: any = null;
-let initPromise: Promise<void> | null = null;
-
-const ensureRRule = () => {
-  if (RRule) return Promise.resolve();
-  if (!initPromise) {
-    initPromise = import("rrule").then((mod) => {
-      RRule = (mod as any).RRule ?? (mod as any).default?.RRule ?? mod;
-    });
-  }
-  return initPromise;
-};
-
-// Synchronous getter for RRule - throws if not initialized
-const getRRule = () => {
-  if (!RRule) {
-    throw new Error("EventHelper: RRule not initialized. Ensure ensureRRule() is called first.");
-  }
-  return RRule;
-};
-
-// Initialize on first use for bundlers (they process the dynamic import statically)
-// The promise is created immediately to start loading
-initPromise = import("rrule").then((mod) => {
-  RRule = (mod as any).RRule ?? (mod as any).default?.RRule ?? mod;
-}).catch(() => {
-  // rrule not available - EventHelper methods will fail gracefully
-});
-
-// Define ParsedOptions as any since RRule is dynamically loaded
-type ParsedOptions = any;
-
-export class EventHelper {
-
-  static getRange = (event:EventInterface, startDate:Date, endDate:Date) => {
-    const start = new Date(event.start);
-    const rrule = EventHelper.getFullRRule(event);
-
-    const dates = rrule.between(startDate, endDate);
-
-    dates.forEach((d: Date) => {
-      d.setHours(start.getHours());
-      d.setMinutes(start.getMinutes());
-      d.setSeconds(start.getSeconds());
-    })
-    return dates;
-  }
-
-  static getFullRRule = (event:EventInterface) => {
-    const RR = getRRule();
-    let rrule = RR.fromString(event.recurrenceRule);
-    rrule.options.dtstart = new Date(event.start);
-    return rrule;
-  }
-
-  static removeExcludeDates = (events:EventInterface[]) => {
-    for (let i=events.length-1; i>=0; i--) {
-      if (events[i].exceptionDates?.length>0)
-      {
-        const parsedDates = events[i].exceptionDates.map((d: string | Date)=>new Date(d).toISOString());
-        if (parsedDates.indexOf(events[i].start.toISOString())>-1) events.splice(i,1);
-      }
-    }
-  }
-
-  static getPartialRRuleString = (options:ParsedOptions) => {
-    const RR = getRRule();
-    const parts = new RR(options).toString().split("RRULE:");
-    const result = parts.length===2 ? parts[1] : "";
-    return result;
-  }
-
-  static cleanRule = (options:ParsedOptions) => {
-    options.byhour = undefined;
-    options.byminute = undefined;
-    options.bysecond = undefined;
-  }
-
-  // Export for consumers who need to ensure initialization
-  static ensureInitialized = ensureRRule;
-}

package/src/FileHelper.ts

@@ -1,55 +0,0 @@
-export class FileHelper {
-
-  static postPresignedFile = (presigned: any, uploadedFile: File, progressCallback: (percent: number) => void) => {
-    const formData = new FormData();
-    formData.append("key", presigned.key);
-    formData.append("acl", "public-read");
-    formData.append("Content-Type", uploadedFile.type);
-    for (const property in presigned.fields) formData.append(property, presigned.fields[property]);
-    formData.append("file", uploadedFile);
-
-    // Use XMLHttpRequest for upload progress tracking since fetch doesn't support it natively
-    return new Promise((resolve, reject) => {
-      const xhr = new XMLHttpRequest();
-
-      xhr.upload.addEventListener('progress', (event) => {
-        if (event.lengthComputable) {
-          const percent = Math.round((event.loaded / event.total) * 100);
-          progressCallback(percent);
-        }
-      });
-
-      xhr.addEventListener('load', () => {
-        if (xhr.status >= 200 && xhr.status < 300) {
-          resolve({
-            status: xhr.status,
-            statusText: xhr.statusText,
-            data: xhr.responseText
-          });
-        } else {
-          reject(new Error(`HTTP Error: ${xhr.status} ${xhr.statusText}`));
-        }
-      });
-
-      xhr.addEventListener('error', () => {
-        reject(new Error('Network error occurred'));
-      });
-
-      xhr.open('POST', presigned.url);
-      xhr.send(formData);
-    });
-  };
-
-  static dataURLtoBlob(dataurl: string) {
-    let arr = dataurl.split(",");
-    if (arr.length < 2) throw new Error("Invalid data URL format");
-    let mimeMatch = arr[0].match(/:(.*?);/);
-    if (!mimeMatch) throw new Error("Invalid MIME type in data URL");
-    let mime = mimeMatch[1];
-    let bstr = atob(arr[1]), n = bstr.length, u8arr = new Uint8Array(n);
-    while (n--) {
-      u8arr[n] = bstr.charCodeAt(n);
-    }
-    return new Blob([u8arr], { type: mime });
-  }
-}

package/src/PersonHelper.ts

@@ -1,82 +0,0 @@
-import { PersonInterface, ContactInfoInterface } from "./interfaces/index.js";
-import { CommonEnvironmentHelper } from "./CommonEnvironmentHelper.js";
-
-export class PersonHelper {
-
-  public static getPhotoPath(churchId: string, person: any) {
-    if (!person.photoUpdated) {
-      if (person.id?.startsWith("PER0000")) return "https://app.staging.b1.church/images/demo/avatars/" + person.id + ".svg";
-      else return "";
-    }
-    else return "/" + churchId + "/membership/people/" + person.id + ".png?dt=" + new Date(person.photoUpdated).getTime().toString();
-  }
-
-  static getPhotoUrl(person: PersonInterface) {
-    if (!person?.photo) return "/images/sample-profile.png"
-    else {
-      return (person?.photo?.startsWith("data:image/png;base64,") || person.photo?.indexOf("://") > -1)
-        ? person.photo
-        : CommonEnvironmentHelper.ContentRoot + person.photo;
-    }
-  }
-
-  static getAge(birthdate: Date): string {
-    if (birthdate !== undefined && birthdate !== null) {
-      let ageDifMs = Date.now() - new Date(birthdate).getTime();
-      let ageDate = new Date(ageDifMs);
-      let years = Math.abs(ageDate.getUTCFullYear() - 1970);
-      return years + " years";
-    }
-    else return "";
-  }
-
-  public static getDisplayNameFromPerson(person: any) {
-    if (person?.name?.nick !== null && person?.name?.nick !== "" && person?.name?.nick !== undefined) return person.name.first + " \"" + person.name.nick + "\" " + person.name.last;
-    else return person.name.first + " " + person.name.last;
-  }
-
-  static getDisplayName(firstName: string, lastName: string, nickName: string): string {
-    if (nickName !== undefined && nickName !== null && nickName.length > 0) return firstName + ' "' + nickName + '" ' + lastName;
-    else return firstName + " " + lastName;
-  }
-
-  public static getBirthMonth(birthdate: Date): number {
-    if (birthdate) return new Date(birthdate).getMonth() + 1;
-    else return -1;
-  }
-
-  public static compareAddress(address1: ContactInfoInterface, address2: ContactInfoInterface): boolean {
-    const displayAddress1: string = this.addressToString(address1).trim();
-    const displayAddress2: string = this.addressToString(address2).trim();
-
-    if (displayAddress1 !== displayAddress2) {
-      return true
-    }
-    return false
-  }
-
-  public static addressToString(address: ContactInfoInterface): string {
-    return `${address.address1 || ""} ${address.address2 || ""} ${address.city || ""}${(address.city && address.state) ? "," : ""} ${address.state || ""} ${address.zip || ""}`
-  }
-
-  public static changeOnlyAddress(contactInfo1: ContactInfoInterface, contactInfo2: ContactInfoInterface): ContactInfoInterface {
-    const updatedAddress: ContactInfoInterface = {
-      ...contactInfo1,
-      address1: contactInfo2.address1,
-      address2: contactInfo2.address2,
-      city: contactInfo2.city,
-      state: contactInfo2.state,
-      zip: contactInfo2.zip
-    }
-
-    return updatedAddress
-  }
-
-  public static checkAddressAvailabilty(person: PersonInterface): boolean {
-    const addressString: string = this.addressToString(person.contactInfo).trim();
-    if (addressString !== "") {
-      return true;
-    }
-    return false;
-  }
-}

package/src/PlanHelper.ts

@@ -1,137 +0,0 @@
-import type { PlanInterface, PlanItemInterface, PlanItemContentInterface } from "./interfaces/index.js";
-import type { ContentProviderInterface } from "./contentProviders/ContentProvider.js";
-import { LessonsContentProvider } from "./contentProviders/LessonsContentProvider.js";
-
-export class PlanHelper {
-  private static providers: ContentProviderInterface[] = [
-    new LessonsContentProvider()
-  ];
-
-  // Register additional content providers
-  static registerProvider(provider: ContentProviderInterface): void {
-    // Avoid duplicates
-    if (!this.providers.find(p => p.providerId === provider.providerId)) {
-      this.providers.push(provider);
-    }
-  }
-
-  // Replace a provider (useful for configuring with different URLs)
-  static replaceProvider(provider: ContentProviderInterface): void {
-    const index = this.providers.findIndex(p => p.providerId === provider.providerId);
-    if (index >= 0) {
-      this.providers[index] = provider;
-    } else {
-      this.providers.push(provider);
-    }
-  }
-
-  // Main method: populate planItems with their content
-  static async populate(
-    plan: PlanInterface,
-    planItems: PlanItemInterface[]
-  ): Promise<PlanItemInterface[]> {
-    // Flatten hierarchy to get all items
-    const allItems = this.flattenItems(planItems);
-
-    // Group items by provider
-    const itemsByProvider = new Map<ContentProviderInterface, PlanItemInterface[]>();
-
-    for (const item of allItems) {
-      for (const provider of this.providers) {
-        if (provider.canHandle(plan, item)) {
-          const existing = itemsByProvider.get(provider) || [];
-          existing.push(item);
-          itemsByProvider.set(provider, existing);
-          break; // First matching provider wins
-        }
-      }
-    }
-
-    // Fetch content from each provider in parallel
-    const fetchPromises: Promise<void>[] = [];
-    const contentMap = new Map<string, PlanItemContentInterface>();
-
-    for (const [provider, items] of itemsByProvider) {
-      fetchPromises.push(
-        provider.fetchContent(plan, items).then(providerContent => {
-          for (const [itemId, content] of providerContent) {
-            contentMap.set(itemId, content);
-          }
-        })
-      );
-    }
-
-    await Promise.all(fetchPromises);
-
-    // Attach content to items (mutates in place for efficiency)
-    this.attachContent(planItems, contentMap);
-
-    return planItems;
-  }
-
-  // Flatten nested planItems for processing
-  private static flattenItems(items: PlanItemInterface[]): PlanItemInterface[] {
-    const result: PlanItemInterface[] = [];
-
-    const collect = (itemList: PlanItemInterface[]) => {
-      for (const item of itemList) {
-        result.push(item);
-        if (item.children?.length) {
-          collect(item.children);
-        }
-      }
-    };
-
-    collect(items);
-    return result;
-  }
-
-  // Attach content to items recursively
-  private static attachContent(
-    items: PlanItemInterface[],
-    contentMap: Map<string, PlanItemContentInterface>
-  ): void {
-    for (const item of items) {
-      const content = contentMap.get(item.id);
-      if (content) {
-        item.content = content;
-      }
-      if (item.children?.length) {
-        this.attachContent(item.children, contentMap);
-      }
-    }
-  }
-
-  // Convenience: Get the lessons provider for direct lesson operations
-  static getLessonsProvider(): LessonsContentProvider {
-    return this.providers.find(p => p.providerId === "lessons") as LessonsContentProvider;
-  }
-
-  // ============================================
-  // Time Formatting Utilities
-  // ============================================
-
-  /**
-   * Format seconds as MM:SS string
-   * @param seconds - Number of seconds to format
-   * @returns Formatted time string (e.g., "3:45")
-   */
-  static formatTime(seconds: number): string {
-    const mins = Math.floor(seconds / 60);
-    const secs = seconds % 60;
-    return mins + ":" + (secs < 10 ? "0" : "") + secs;
-  }
-
-  /**
-   * Calculate total duration of a section's children
-   * @param section - PlanItem with children
-   * @returns Total seconds from all children
-   */
-  static getSectionDuration(section: PlanItemInterface): number {
-    let totalSeconds = 0;
-    section.children?.forEach((child) => {
-      totalSeconds += child.seconds || 0;
-    });
-    return totalSeconds;
-  }
-}

package/src/UniqueIdHelper.ts

@@ -1,36 +0,0 @@
-export class UniqueIdHelper {
-
-  static chars = ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z",
-    "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z",
-    "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
-    "-", "_"];
-
-  static alphanumericChars = ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z",
-    "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z",
-    "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"];
-
-  public static isMissing(obj: any) {
-    if (obj === undefined || obj === null) return true;
-    else if (obj.toString() === "") return true;
-    else return false;
-  }
-
-  public static shortId() {
-    return this.generate(UniqueIdHelper.chars, 11);
-  }
-
-  public static generateAlphanumeric() {
-    return this.generate(UniqueIdHelper.alphanumericChars, 11);
-  }
-
-  public static generate(charList: string[], length: number) {
-    let result = "";
-    for (let i = 0; i < length; i++) {
-      const idx = Math.floor(Math.random() * charList.length);
-      const c = charList[idx];
-      result += c;
-    }
-    return result;
-  }
-
-}