@churchapps/apphelper 0.6.15 → 0.6.16

package/src/helpers/DateHelper.ts

@@ -1,116 +0,0 @@
-import { format as dateFormat } from "date-fns"
-
-export class DateHelper {
-
-  //Fixes timezone issues when you just need the date.
-  static toDate(input: any) {
-    return new Date(Date.parse(input.toString().replace("Z", "")));
-  }
-
-  static toDateTime(input: any) {
-    return new Date(Date.parse(input.toString()));
-  }
-
-  static addDays(date: Date, days: number) {
-    date.setDate(date.getDate() + days);
-    return date;
-  }
-
-  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 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}`;
-  }
-
-  static formatHtml5Time(time: Date): string {
-    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 if (seconds < 1) return "now";
-    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 {
-      return dateFormat(date, format);
-    } catch { return ""; }
-  }
-}

package/src/helpers/ErrorHelper.ts

@@ -1,41 +0,0 @@
-import { ErrorLogInterface, ErrorAppDataInterface } from "@churchapps/helpers";
-import { ApiHelper } from "@churchapps/helpers";
-
-
-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;
-		if (log.message.indexOf("clientErrors") > -1) return;
-		try {
-			// Error posting to /errors endpoint disabled
-			// ApiHelper.postAnonymous("/clientErrors", [log], "MembershipApi");
-		} catch (error) {
-		}
-		if (ErrorHelper.customErrorHandler) ErrorHelper.customErrorHandler(log);
-	}
-}
-
-}

package/src/helpers/EventHelper.ts

@@ -1,49 +0,0 @@
-import { EventInterface } from "@churchapps/helpers";
-import { RRule } from "rrule";
-import { ParsedOptions } from "rrule/dist/esm/types";
-
-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 => {
-      d.setHours(start.getHours());
-      d.setMinutes(start.getMinutes());
-      d.setSeconds(start.getSeconds());
-    })
-    return dates;
-  }
-
-  static getFullRRule = (event:EventInterface) => {
-    let rrule = RRule.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=>new Date(d).toISOString());
-        if (parsedDates.indexOf(events[i].start.toISOString())>-1) events.splice(i,1);
-      }
-    }
-  }
-
-  static getPartialRRuleString = (options:ParsedOptions) => {
-    const parts = new RRule(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;
-  }
-
-}

package/src/helpers/FileHelper.ts

@@ -1,31 +0,0 @@
-import axios from "axios";
-
-export class FileHelper {
-
-  static postPresignedFile = (presigned: any, uploadedFile: File, progressCallback: (percent: number) => void) => {
-    const formData = new FormData();
-    //formData.append("key", presigned.key); //no longer needed with new aws sdk
-    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);
-
-    const axiosConfig = {
-      headers: { "Content-Type": "multipart/form-data" },
-      onUploadProgress: (data: any) => {
-        progressCallback(Math.round((100 * data.loaded) / data.total));
-      }
-    };
-
-    return axios.post(presigned.url, formData, axiosConfig);
-  };
-
-  static dataURLtoBlob(dataurl: string) {
-    let arr = dataurl.split(","), mime = arr[0].match(/:(.*?);/)[1],
-      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/helpers/Locale.ts

@@ -1,457 +0,0 @@
-import i18n from "i18next";
-import { initReactI18next } from "react-i18next/initReactI18next";
-import LanguageDetector from "i18next-browser-languagedetector";
-import Backend from "i18next-chained-backend";
-
-interface TranslationResources {
-	[key: string]: {
-		translation: Record<string, unknown>;
-	};
-}
-
-interface ExtraLanguageCodes {
-	[key: string]: string[];
-}
-
-export class Locale {
-	private static readonly supportedLanguages: string[] = [
-		"de",
-		"en",
-		"es",
-		"fr",
-		"hi",
-		"it",
-		"ko",
-		"no",
-		"pt",
-		"ru",
-		"tl",
-		"zh",
-	];
-	private static readonly extraCodes: ExtraLanguageCodes = { no: ["nb", "nn"] };
-
-	// Hard-coded English fallbacks for when locale files are not available
-	private static readonly englishFallbacks: Record<string, any> = {
-		"b1Share": {
-			"comment": "Comment",
-			"commentPlaceholder": "Include a comment with your post.",
-			"contentShared": "Content Shared",
-			"group": "Group",
-			"sharingToGroup": "Sharing {} to B1 Group",
-			"validate": {
-				"addComment": "Please add a comment.",
-				"loginFirst": "Please login first.",
-				"notMember": "You are not currently a member of any groups on B1.",
-				"selectGroup": "Please select a group."
-			}
-		},
-		"common": {
-			"add": "Add",
-			"cancel": "Cancel",
-			"close": "Close",
-			"date": "Date",
-			"delete": "Delete",
-			"edit": "Edit",
-			"error": "Error",
-			"pleaseWait": "Please wait...",
-			"save": "Save",
-			"search": "Search",
-			"submit": "Submit",
-			"update": "Update"
-		},
-		"createPerson": {
-			"addNewPerson": "Add a New Person",
-			"firstName": "First Name",
-			"lastName": "Last Name",
-			"email": "Email"
-		},
-		"donation": {
-			"bankForm": {
-				"accountNumber": "Account Number",
-				"added": "Bank account added. Verify your bank account to make a donation.",
-				"company": "Company",
-				"firstDeposit": "First Deposit",
-				"holderName": "Account holder name is required.",
-				"individual": "Individual",
-				"name": "Account Holder Name",
-				"needVerified": "Bank accounts will need to be verified before making any donations. Your account will receive two small deposits in approximately 1-3 business days. You will need to enter those deposit amounts to finish verifying your account by selecting the verify account link next to your bank account under the payment methods section.",
-				"routingNumber": "Routing Number",
-				"secondDeposit": "Second Deposit",
-				"twoDeposits": "Enter the two deposits you received in your account to finish verifying your bank account.",
-				"updated": "Bank account updated.",
-				"verified": "Bank account verified.",
-				"validate": {
-					"accountNumber": "Routing and account number are required.",
-					"holderName": "Account holder name is required."
-				}
-			},
-			"cardForm": {
-				"addNew": "Add New Card",
-				"added": "Card added successfully.",
-				"expirationMonth": "Expiration Month:",
-				"expirationYear": "Expiration Year:",
-				"updated": "Card updated successfully."
-			},
-			"common": {
-				"cancel": "Cancel",
-				"error": "Error"
-			},
-			"donationForm": {
-				"annually": "Annually",
-				"biWeekly": "Bi-Weekly",
-				"cancelled": "Recurring donation cancelled.",
-				"confirmDelete": "Are you sure you wish to delete this recurring donation?",
-				"cover": "I'll generously add {} to cover the transaction fees so you can keep 100% of my donation.",
-				"donate": "Donate",
-				"editRecurring": "Edit Recurring Donation",
-				"fees": "Transaction fees of {} are applied.",
-				"frequency": "Frequency",
-				"fund": "Fund",
-				"funds": "Funds",
-				"make": "Make a Donation",
-				"makeRecurring": "Make a Recurring Donation",
-				"method": "Method",
-				"monthly": "Monthly",
-				"notes": "Notes",
-				"preview": "Preview Donation",
-				"quarterly": "Quarterly",
-				"recurringUpdated": "Recurring donation updated.",
-				"startDate": "Start Date",
-				"thankYou": "Thank you for your donation!",
-				"tooLow": "Donation amount must be greater than $0.50",
-				"total": "Total Donation Amount",
-				"validate": {
-					"amount": "Amount cannot be $0.",
-					"email": "Please enter your email address.",
-					"firstName": "Please enter your first name.",
-					"lastName": "Please enter your last name.",
-					"validEmail": "Please enter a valid email address."
-				},
-				"weekly": "Weekly"
-			},
-			"fundDonations": {
-				"addMore": "Add More",
-				"amount": "Amount",
-				"fund": "Fund"
-			},
-			"paymentMethods": {
-				"addBank": "Add Bank Account",
-				"addCard": "Add Card",
-				"confirmDelete": "Are you sure you wish to delete this payment method?",
-				"deleted": "Payment method deleted.",
-				"noMethod": "No payment methods. Add a payment method to make a donation.",
-				"verify": "Verify Account"
-			},
-			"page": {
-				"amount": "Amount",
-				"batch": "Batch",
-				"date": "Date",
-				"fund": "Fund",
-				"method": "Method",
-				"willAppear": "Donations will appear once a donation has been entered."
-			},
-			"preview": {
-				"date": "Donation Date",
-				"donate": "Donate",
-				"every": "Recurring Every",
-				"fee": "Transaction Fee",
-				"funds": "Funds",
-				"method": "Donation Method",
-				"notes": "Notes",
-				"startingOn": "Starting On",
-				"total": "Total",
-				"type": "Donation Type",
-				"weekly": "Weekly"
-			},
-			"recurring": {
-				"amount": "Amount",
-				"every": "Every",
-				"interval": "Interval",
-				"notFound": "Payment method not found.",
-				"paymentMethod": "Payment Method",
-				"startDate": "Start Date"
-			}
-		},
-		"formSubmissionEdit": {
-			"confirmDelete": "Are you sure you wish to delete this form data?",
-			"editForm": "Edit Form",
-			"isRequired": "is required",
-			"submit": "Submit"
-		},
-		"gallery": {
-			"aspectRatio": "Aspect Ratio",
-			"confirmDelete": "Are you sure you wish to delete this image from gallery?",
-			"freeForm": "Free Form"
-		},
-		"iconPicker": {
-			"iconsAvailable": "icons available",
-			"matchingResults": "matching results",
-			"search": "Search icons..."
-		},
-		"login": {
-			"createAccount": "Create an Account",
-			"email": "Email",
-			"expiredLink": "The current link is expired.",
-			"forgot": "Forgot Password",
-			"goLogin": "Go to Login",
-			"login": "Login",
-			"password": "Password",
-			"register": "Register",
-			"registerThankYou": "Thank you for registering! Please check your email to verify your account.",
-			"requestLink": "Request a new reset link",
-			"reset": "Reset",
-			"resetInstructions": "Enter your email address to request a password reset.",
-			"resetPassword": "Reset Password",
-			"resetSent": "Password reset email sent!",
-			"setPassword": "Set Password",
-			"signIn": "Sign In",
-			"signInTitle": "Please Sign In",
-			"verifyPassword": "Verify Password",
-			"validate": {
-				"email": "Please enter a valid email address.",
-				"firstName": "Please enter your first name.",
-				"invalid": "Invalid login. Please check your email or password.",
-				"lastName": "Please enter your last name.",
-				"password": "Please enter a password.",
-				"passwordLength": "Password must be at least 8 characters long.",
-				"passwordMatch": "Passwords do not match.",
-				"selectingChurch": "Error in selecting church. Please verify and try again"
-			},
-			"welcomeBack": "Welcome back",
-			"welcomeName": "Welcome back, <b>{}</b>! Please wait while we load your data."
-		},
-		"markdownEditor": {
-			"content": "Content",
-			"markdownEditor": "Markdown Editor",
-			"markdownGuide": "Markdown Guide"
-		},
-		"month": {
-			"april": "April",
-			"august": "August",
-			"december": "December",
-			"february": "February",
-			"january": "January",
-			"july": "July",
-			"june": "June",
-			"march": "March",
-			"may": "May",
-			"november": "November",
-			"october": "October",
-			"september": "September"
-		},
-		"notes": {
-			"comment": "comment",
-			"comments": "comments",
-			"notes": "Notes",
-			"startConversation": "Start a conversation",
-			"validate": {
-				"content": "Please enter a note."
-			},
-			"viewAll": "View all"
-		},
-		"person": {
-			"email": "Email",
-			"firstName": "First Name",
-			"lastName": "Last Name",
-			"name": "Name",
-			"person": "Person",
-			"years": "years",
-			"noRec": "Don't have a person record?"
-		},
-		"reporting": {
-			"detailed": "Detailed Report",
-			"summary": "Summary",
-			"sampleTemplate": "Sample Word Template",
-			"downloadOptions": "Download Options",
-			"noData": "There is no data to display.",
-			"runReport": "Run Report",
-			"useFilter": "Use the filter to run the report."
-		},
-		"selectChurch": {
-			"address1": "Address Line 1",
-			"address2": "Address Line 2",
-			"another": "Choose another church",
-			"city": "City",
-			"confirmRegister": "Are you sure you wish to register a new church?",
-			"country": "Country",
-			"name": "Church Name",
-			"noMatches": "No matches found.",
-			"register": "Register a New Church",
-			"selectChurch": "Select a Church",
-			"state": "State / Province",
-			"zip": "Zip / Postal Code",
-			"validate": {
-				"address": "Address cannot be blank.",
-				"city": "City cannot be blank.",
-				"country": "Country cannot be blank.",
-				"name": "Church name cannot be blank.",
-				"state": "State/Province cannot be blank.",
-				"zip": "Zip/Postal code cannot be blank."
-			}
-		},
-		"stockPhotos": {
-			"photoBy": "Photo by:",
-			"providedBy": "Stock photos provided by"
-		},
-		"support": {
-			"documentation": "Documentation",
-			"discussions": "Support Forum"
-		},
-		"wrapper": {
-			"chatWith": "Chat with",
-			"deleteChurch": "Delete",
-			"logout": "Logout",
-			"messages": "Messages",
-			"newPrivateMessage": "New Private Message",
-			"notifications": "Notifications",
-			"privateMessage": "Private Message",
-			"privateConversation": "Private Conversation",
-			"profile": "Profile",
-			"searchForPerson": "Search for a person",
-			"support": "Support",
-			"sureRemoveChurch": "Are you sure you wish to delete this church? You no longer will be a member of {}.",
-			"switchApp": "Switch App",
-			"switchChurch": "Switch Church"
-		}
-	};
-
-	static init = async (backends: string[]): Promise<void> => {
-		const resources: TranslationResources = {};
-		let langs = ["en"];
-
-		if (typeof navigator !== "undefined") {
-			const browserLang = navigator.language.split("-")[0];
-			const mappedLang
-				= Object.keys(this.extraCodes).find((code) =>
-					this.extraCodes[code].includes(browserLang),
-				) || browserLang;
-			const notSupported = this.supportedLanguages.indexOf(mappedLang) === -1;
-			langs = mappedLang === "en" || notSupported ? ["en"] : ["en", mappedLang];
-		}
-
-		// Load translations for each language
-		for (const lang of langs) {
-			resources[lang] = { translation: {} };
-			for (const backend of backends) {
-				const url = backend.replace("{{lng}}", lang);
-				try {
-					const data = await fetch(url).then((response) => response.json());
-					resources[lang].translation = this.deepMerge(
-						resources[lang].translation,
-						data,
-					);
-				} catch (error) {
-					// If fetching fails, we'll rely on the hard-coded fallbacks
-					console.warn(`Failed to load translations from ${url}:`, error);
-				}
-			}
-		}
-
-		// Initialize i18n
-		await i18n
-			.use(Backend)
-			.use(LanguageDetector)
-			.use(initReactI18next)
-			.init({
-				resources,
-				fallbackLng: "en",
-				debug: false,
-				interpolation: {
-					escapeValue: false,
-				},
-				detection: {
-					order: ["navigator"],
-					caches: ["localStorage"],
-				},
-			});
-	};
-
-	private static deepMerge(
-		target: Record<string, unknown>,
-		source: Record<string, unknown>,
-	): Record<string, unknown> {
-		for (const key in source) {
-			if (this.isObject(source[key])) {
-				if (!target[key]) Object.assign(target, { [key]: {} });
-				this.deepMerge(
-					target[key] as Record<string, unknown>,
-					source[key] as Record<string, unknown>,
-				);
-			} else Object.assign(target, { [key]: source[key] });
-		}
-		return target;
-	}
-
-	private static isObject(obj: unknown): boolean {
-		return obj !== null && typeof obj === "object" && !Array.isArray(obj);
-	}
-
-	// Helper method to get value from nested object using dot notation
-	private static getNestedValue(obj: Record<string, any>, path: string): any {
-		return path.split('.').reduce((current, key) => {
-			return current && current[key] !== undefined ? current[key] : undefined;
-		}, obj);
-	}
-
-	// New helper method that uses i18n with hard-coded English fallback
-	static t(key: string, options?: Record<string, unknown>): string {
-		try {
-			// Check if i18n is initialized and has the key
-			if (i18n && i18n.isInitialized && i18n.exists(key)) {
-				const translation = i18n.t(key, options);
-				// If translation is not the same as the key, return it
-				if (translation !== key) {
-					return translation;
-				}
-			}
-		} catch (error) {
-			// If i18n fails, fall through to hard-coded fallback
-			console.warn(`i18n translation failed for key "${key}":`, error);
-		}
-
-		// Fallback to hard-coded English translations
-		const fallbackValue = this.getNestedValue(this.englishFallbacks, key);
-		if (fallbackValue !== undefined) {
-			// Handle simple string interpolation for options
-			if (typeof fallbackValue === 'string' && options) {
-				let result = fallbackValue;
-				Object.keys(options).forEach(optionKey => {
-					const placeholder = `{{${optionKey}}}`;
-					if (result.includes(placeholder)) {
-						result = result.replace(new RegExp(placeholder, 'g'), String(options[optionKey]));
-					}
-					// Also handle {} placeholder for backward compatibility
-					if (result.includes('{}')) {
-						result = result.replace('{}', String(options[optionKey]));
-					}
-				});
-				return result;
-			}
-			return String(fallbackValue);
-		}
-
-		// If no fallback found, return the key itself
-		return key;
-	}
-
-	// Keep the old method for backward compatibility
-	static label(key: string, fallback?: string): string {
-		const translation = this.t(key);
-		// If translation equals the key, it means no translation was found
-		if (translation === key && fallback) {
-			return fallback;
-		}
-		return translation;
-	}
-
-	// Helper method to check if i18n is initialized
-	static isInitialized(): boolean {
-		return i18n && i18n.isInitialized;
-	}
-
-	// Method to set up basic fallback-only mode (no i18n)
-	static setupFallbackMode(): void {
-		// This method can be called if apps want to use only the hard-coded fallbacks
-		// without initializing the full i18n system
-	}
-}