@churchapps/helpers 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Live Church Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# Helpers
+
+Library of helper functions not specific to any project or framework.
+
+## To Test
+
+1. After making changes run `npm build` followed by `npm link` to expose the package locally
+2. In your test project run `@npm link @churchapps/helpers`
+3. Rerun both after changes
+
+## To Publish
+
+1. Run `npm publish --access=public`

package/dist/ArrayHelper.d.ts

@@ -0,0 +1,12 @@
+export declare class ArrayHelper {
+    static getIds(array: any[], propertyName: string): string[];
+    static sortBy(array: any[], propertyName: string, descending?: boolean): void;
+    static getIndex(array: any[], propertyName: string, value: any): number;
+    static getOne(array: any[], propertyName: string, value: any): any;
+    static getAll(array: any[], propertyName: string, value: any): any[];
+    static getAllArray(array: any[], propertyName: string, values: any[]): any[];
+    private static compare;
+    static getUniqueValues(array: any[], propertyName: string): any[];
+    static getDeepValue(item: any, propertyName: string): any;
+}
+//# sourceMappingURL=ArrayHelper.d.ts.map

package/dist/ArrayHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayHelper.d.ts","sourceRoot":"","sources":["../src/ArrayHelper.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM;IAShD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe;IAS7E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAQ9D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAK5D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAQ5D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;IAMpE,OAAO,CAAC,MAAM,CAAC,OAAO;IAYtB,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM;IAUzD,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM;CASpD"}

package/dist/ArrayHelper.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayHelper = void 0;
+class ArrayHelper {
+    static getIds(array, propertyName) {
+        const result = [];
+        for (const item of array) {
+            const id = item[propertyName]?.toString();
+            if (id && result.indexOf(id) === -1)
+                result.push(id);
+        }
+        return result;
+    }
+    static sortBy(array, propertyName, descending = false) {
+        array.sort((a, b) => {
+            const valA = a[propertyName];
+            const valB = b[propertyName];
+            if (valA < valB)
+                return descending ? 1 : -1;
+            else
+                return descending ? -1 : 1;
+        });
+    }
+    static getIndex(array, propertyName, value) {
+        for (let i = 0; i < array.length; i++) {
+            const item = array[i];
+            if (ArrayHelper.compare(item, propertyName, value))
+                return i;
+        }
+        return -1;
+    }
+    static getOne(array, propertyName, value) {
+        for (const item of array || [])
+            if (ArrayHelper.compare(item, propertyName, value))
+                return item;
+        return null;
+    }
+    static getAll(array, propertyName, value) {
+        const result = [];
+        for (const item of array || []) {
+            if (ArrayHelper.compare(item, propertyName, value))
+                result.push(item);
+        }
+        return result;
+    }
+    static getAllArray(array, propertyName, values) {
+        const result = [];
+        for (const item of array || [])
+            if (values.indexOf(item[propertyName]) > -1)
+                result.push(item);
+        return result;
+    }
+    static compare(item, propertyName, value) {
+        const propChain = propertyName.split(".");
+        if (propChain.length === 1)
+            return item[propertyName] === value;
+        else {
+            let obj = item;
+            for (let i = 0; i < propChain.length - 1; i++) {
+                if (obj)
+                    obj = item[propChain[i]];
+            }
+            return obj[propChain[propChain.length - 1]] === value;
+        }
+    }
+    static getUniqueValues(array, propertyName) {
+        const result = [];
+        for (const item of array) {
+            const val = (propertyName.indexOf(".") === -1) ? item[propertyName] : this.getDeepValue(item, propertyName);
+            if (result.indexOf(val) === -1)
+                result.push(val);
+        }
+        return result;
+    }
+    static getDeepValue(item, propertyName) {
+        const propertyNames = propertyName.split(".");
+        let result = item;
+        propertyNames.forEach(name => {
+            result = result[name];
+        });
+        return result;
+    }
+}
+exports.ArrayHelper = ArrayHelper;
+//# sourceMappingURL=ArrayHelper.js.map

package/dist/ArrayHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayHelper.js","sourceRoot":"","sources":["../src/ArrayHelper.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { ArrayHelper } from "./ArrayHelper";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayHelper = void 0;
+var ArrayHelper_1 = require("./ArrayHelper");
+Object.defineProperty(exports, "ArrayHelper", { enumerable: true, get: function () { return ArrayHelper_1.ArrayHelper; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAAlC,0GAAA,WAAW,OAAA"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@churchapps/helpers",
+  "version": "1.0.0",
+  "description": "Library of helper functions not specific to any one ChurchApps project or framework.",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "clean": "rimraf dist",
+    "tsc": "tsc",
+    "build": "npm-run-all clean tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LiveChurchSolutions/Helpers.git"
+  },
+  "keywords": [
+    "ChurchApps"
+  ],
+  "author": "ChurchApps.org",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/LiveChurchSolutions/Helpers/issues"
+  },
+  "homepage": "https://github.com/LiveChurchSolutions/Helpers#readme",
+  "devDependencies": {
+    "@types/node": "^20.5.6",
+    "npm-run-all": "^4.1.5",
+    "rimraf": "^5.0.1",
+    "typescript": "^5.2.2"
+  },
+  "dependencies": {
+    "date-fns": "^2.30.0",
+    "react-ga4": "^2.1.0",
+    "rrule": "^2.7.2"
+  }
+}

package/src/ApiHelper.ts

@@ -0,0 +1,125 @@
+import { ApiConfig, RolePermissionInterface, ApiListType } from "./interfaces";
+import { ErrorHelper } from "./ErrorHelper";
+
+export class ApiHelper {
+
+  static apiConfigs: ApiConfig[] = [];
+  static isAuthenticated = false;
+
+  static getConfig(keyName: string) {
+    let result: ApiConfig = null;
+    this.apiConfigs.forEach(config => { if (config.keyName === keyName) result = config });
+    //if (result === null) throw new Error("Unconfigured API: " + keyName);
+    return result;
+  }
+
+  static setDefaultPermissions(jwt: string) {
+    this.apiConfigs.forEach(config => {
+      config.jwt = jwt;
+      config.permisssions = [];
+    });
+    this.isAuthenticated = true;
+  }
+
+  static setPermissions(keyName: string, jwt: string, permissions: RolePermissionInterface[]) {
+    this.apiConfigs.forEach(config => {
+      if (config.keyName === keyName) {
+        config.jwt = jwt;
+        config.permisssions = permissions;
+      }
+    });
+    this.isAuthenticated = true;
+  }
+
+  static clearPermissions() {
+    this.apiConfigs.forEach(config => { config.jwt = ""; config.permisssions = []; });
+    this.isAuthenticated = false;
+  }
+
+  static async get(path: string, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = { method: "GET", headers: { Authorization: "Bearer " + config.jwt } };
+    return await this.fetchWithErrorHandling(config.url + path, requestOptions);
+  }
+
+  static async getAnonymous(path: string, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = { method: "GET" };
+    return await this.fetchWithErrorHandling(config.url + path, requestOptions);
+  }
+
+  static async post(path: string, data: any[] | {}, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = {
+      method: "POST",
+      headers: { Authorization: "Bearer " + config.jwt, "Content-Type": "application/json" },
+      body: JSON.stringify(data)
+    };
+    return await this.fetchWithErrorHandling(config.url + path, requestOptions);
+  }
+
+  static async patch(path: string, data: any[] | {}, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = {
+      method: "PATCH",
+      headers: { Authorization: "Bearer " + config.jwt, "Content-Type": "application/json" },
+      body: JSON.stringify(data)
+    };
+    return await this.fetchWithErrorHandling(config.url + path, requestOptions);
+  }
+
+  static async delete(path: string, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = {
+      method: "DELETE",
+      headers: { Authorization: "Bearer " + config.jwt }
+    };
+    try {
+      const response = await fetch(config.url + path, requestOptions);
+      if (!response.ok) await this.throwApiError(response);
+    } catch (e) {
+      console.log(e)
+      throw (e);
+    }
+  }
+
+  static async postAnonymous(path: string, data: any[] | {}, apiName: ApiListType) {
+    const config = this.getConfig(apiName);
+    const requestOptions = {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(data)
+    };
+    console.log(config.url + path, requestOptions);
+    return await this.fetchWithErrorHandling(config.url + path, requestOptions);
+  }
+
+  static async fetchWithErrorHandling(url: string, requestOptions: any) {
+    try {
+      const response = await fetch(url, requestOptions);
+      if (!response.ok) await this.throwApiError(response);
+      else {
+        if (response.status !== 204 ) {
+          return response.json();
+        }
+      }
+    } catch (e) {
+      console.log("Error loading url: " + url);
+      console.log(e)
+      throw (e);
+    }
+  }
+
+  private static async throwApiError(response: Response) {
+    console.log("THROW API ERROR");
+    let msg = response.statusText;
+    try {
+      const json = await response.json();
+      msg = json.errors[0];
+    } catch { }
+    console.log("RESPONSE", response)
+    ErrorHelper.logError(response.status.toString(), response.url, msg);
+    throw new Error(msg || "Error");
+  }
+
+}

package/src/AppearanceHelper.ts

@@ -0,0 +1,69 @@
+
+export interface AppearanceInterface { primaryColor?: string, primaryContrast?: string, secondaryColor?: string, secondaryContrast?: string, logoLight?: string, logoDark?: string, favicon_400x400?: string, favicon_16x16?: string }
+
+export class AppearanceHelper {
+
+  public static getLogoDark(appearanceSettings: AppearanceInterface, defaultLogo: string) {
+    return (appearanceSettings?.logoDark) ? appearanceSettings.logoDark : defaultLogo;
+  }
+
+  public static getLogoLight(appearanceSettings: AppearanceInterface, defaultLogo: string) {
+    return (appearanceSettings?.logoLight) ? appearanceSettings.logoLight : defaultLogo;
+  }
+
+  public static getFavicon(appearanceSettings: AppearanceInterface, size: "400" | "16") {
+    if (size === "400") {
+      return appearanceSettings?.favicon_400x400;
+    }
+
+    if (size === "16") {
+      return appearanceSettings?.favicon_16x16;
+    }
+
+    return;
+  }
+
+  public static getLogo(appearanceSettings: AppearanceInterface, defaultLogoLight: string, defaultLogoDark: string, backgroundColor: string) {
+    const isDark = (appearanceSettings.logoDark) ? this.isDark(backgroundColor) : false;
+    if (isDark) return this.getLogoDark(appearanceSettings, defaultLogoDark);
+    else return this.getLogoLight(appearanceSettings, defaultLogoLight);
+  }
+
+  private static isDark(backgroundColor: string) {
+    let valid = false;
+    let r = 0;
+    let g = 0;
+    let b = 0;
+
+    if (backgroundColor.match(/#[0-9a-fA-F{6}]/)) {
+      r = this.getHexValue(backgroundColor.substring(1, 2));
+      g = this.getHexValue(backgroundColor.substring(3, 4));
+      b = this.getHexValue(backgroundColor.substring(5, 6));
+      valid = true;
+    } else if (backgroundColor.match(/#[0-9a-fA-F{3}]/)) {
+      r = this.getHexValue(backgroundColor.substring(1, 1));
+      g = this.getHexValue(backgroundColor.substring(2, 2));
+      b = this.getHexValue(backgroundColor.substring(3, 3));
+      valid = true;
+    }
+
+    if (!valid) return false;
+    else {
+      //HSP brightness formula.  Some colors have a bigger impact on our perceived brightness than others.
+      const rWeight = .299 * Math.pow(r, 2);
+      const gWeight = .587 * Math.pow(g, 2);
+      const bWeight = .114 * Math.pow(b, 2);
+      const brightness = Math.sqrt(rWeight + gWeight + bWeight);
+      //return brightness < 128;  //
+      return brightness < 156;
+    }
+
+  }
+
+  private static getHexValue(hex: string) {
+    let result = parseInt(hex, 16);
+    if (hex.length === 1) result = result * 16;
+    return result;
+  }
+
+}

package/src/ArrayHelper.ts

@@ -0,0 +1,80 @@
+import { UniqueIdHelper } from "./UniqueIdHelper";
+
+export class ArrayHelper {
+  static getIds(array: any[], propertyName: string) {
+    const result: string[] = [];
+    for (const item of array) {
+      const id = item[propertyName]?.toString();
+      if (!UniqueIdHelper.isMissing(id) && result.indexOf(id) === -1) result.push(id);
+    }
+    return result;
+  }
+
+  static sortBy(array: any[], propertyName: string, descending: boolean = false) {
+    array.sort((a, b) => {
+      const valA = a[propertyName];
+      const valB = b[propertyName];
+      if (valA < valB) return descending ? 1 : -1;
+      else return descending ? -1 : 1;
+    });
+  }
+
+  static getIndex(array: any[], propertyName: string, value: any) {
+    for (let i = 0; i < array.length; i++) {
+      const item = array[i];
+      if (ArrayHelper.compare(item, propertyName, value)) return i;
+    }
+    return -1;
+  }
+
+  static getOne(array: any[], propertyName: string, value: any) {
+    for (const item of array || []) if (ArrayHelper.compare(item, propertyName, value)) return item;
+    return null
+  }
+
+  static getAll(array: any[], propertyName: string, value: any) {
+    const result: any[] = []
+    for (const item of array || []) {
+      if (ArrayHelper.compare(item, propertyName, value)) result.push(item);
+    }
+    return result;
+  }
+
+  static getAllArray(array: any[], propertyName: string, values: any[]) {
+    const result: any[] = []
+    for (const item of array || []) if (values.indexOf(item[propertyName]) > -1) result.push(item);
+    return result;
+  }
+
+  private static compare(item: any, propertyName: string, value: any) {
+    const propChain = propertyName.split(".");
+    if (propChain.length === 1) return item[propertyName] === value;
+    else {
+      let obj = item;
+      for (let i = 0; i < propChain.length - 1; i++) {
+        if (obj) obj = item[propChain[i]];
+      }
+      return obj[propChain[propChain.length - 1]] === value;
+    }
+  }
+
+  static getUniqueValues(array: any[], propertyName: string) {
+    const result: any[] = [];
+
+    for (const item of array) {
+      const val = (propertyName.indexOf(".") === -1) ? item[propertyName] : this.getDeepValue(item, propertyName)
+      if (result.indexOf(val) === -1) result.push(val);
+    }
+    return result;
+  }
+
+  static getDeepValue(item: any, propertyName: string) {
+    const propertyNames = propertyName.split(".");
+    let result: any = item;
+    propertyNames.forEach(name => {
+      result = result[name];
+    });
+    return result;
+  }
+
+}

package/src/CommonEnvironmentHelper.ts

@@ -0,0 +1,80 @@
+
+export class CommonEnvironmentHelper {
+  public static AttendanceApi = "";
+  public static DoingApi = "";
+  public static GivingApi = "";
+  public static MembershipApi = "";
+  public static ReportingApi = "";
+  public static MessagingApi = "";
+  public static MessagingApiSocket = "";
+  public static ContentApi = "";
+  public static GoogleAnalyticsTag = "";
+
+  static ContentRoot = "";
+  static B1Root = "";
+  static ChumsRoot = "";
+  static LessonsRoot = "";
+
+  static init = (stage: string) => {
+    switch (stage) {
+      case "staging": CommonEnvironmentHelper.initStaging(); break;
+      case "prod": CommonEnvironmentHelper.initProd(); break;
+      default: CommonEnvironmentHelper.initDev(); break;
+    }
+  }
+
+  static initDev = () => {
+    this.initStaging(); //Use staging values for anything not provided
+    CommonEnvironmentHelper.AttendanceApi = process.env.REACT_APP_ATTENDANCE_API || process.env.NEXT_PUBLIC_ATTENDANCE_API || CommonEnvironmentHelper.AttendanceApi;
+    CommonEnvironmentHelper.DoingApi = process.env.REACT_APP_DOING_API || process.env.NEXT_PUBLIC_DOING_API || CommonEnvironmentHelper.DoingApi;
+    CommonEnvironmentHelper.GivingApi = process.env.REACT_APP_GIVING_API || process.env.NEXT_PUBLIC_GIVING_API || CommonEnvironmentHelper.GivingApi;
+    CommonEnvironmentHelper.MembershipApi = process.env.REACT_APP_MEMBERSHIP_API || process.env.NEXT_PUBLIC_MEMBERSHIP_API || CommonEnvironmentHelper.MembershipApi;
+    CommonEnvironmentHelper.ReportingApi = process.env.REACT_APP_REPORTING_API || process.env.NEXT_PUBLIC_REPORTING_API || CommonEnvironmentHelper.ReportingApi;
+    CommonEnvironmentHelper.MessagingApi = process.env.REACT_APP_MESSAGING_API || process.env.NEXT_PUBLIC_MESSAGING_API || CommonEnvironmentHelper.MessagingApi;
+    CommonEnvironmentHelper.MessagingApiSocket = process.env.REACT_APP_MESSAGING_API_SOCKET || process.env.NEXT_PUBLIC_MESSAGING_API_SOCKET || CommonEnvironmentHelper.MessagingApiSocket;
+    CommonEnvironmentHelper.ContentApi = process.env.REACT_APP_CONTENT_API || process.env.NEXT_PUBLIC_CONTENT_API || CommonEnvironmentHelper.ContentApi;
+    CommonEnvironmentHelper.GoogleAnalyticsTag = process.env.REACT_APP_GOOGLE_ANALYTICS || process.env.NEXT_PUBLIC_GOOGLE_ANALYTICS || CommonEnvironmentHelper.GoogleAnalyticsTag;
+
+    CommonEnvironmentHelper.ContentRoot = process.env.REACT_APP_CONTENT_ROOT || process.env.NEXT_PUBLIC_CONTENT_ROOT || CommonEnvironmentHelper.ContentRoot;
+    CommonEnvironmentHelper.B1Root = process.env.REACT_APP_B1_ROOT || process.env.NEXT_PUBLIC_B1_ROOT || CommonEnvironmentHelper.B1Root;
+    CommonEnvironmentHelper.ChumsRoot = process.env.REACT_APP_CHUMS_ROOT || process.env.NEXT_PUBLIC_CHUMS_ROOT || CommonEnvironmentHelper.ChumsRoot;
+    CommonEnvironmentHelper.LessonsRoot = process.env.REACT_APP_LESSONS_ROOT || process.env.NEXT_PUBLIC_LESSONS_ROOT || CommonEnvironmentHelper.LessonsRoot;
+  }
+
+  //NOTE: None of these values are secret.
+  static initStaging = () => {
+    CommonEnvironmentHelper.AttendanceApi = "https://attendanceapi.staging.churchapps.org";
+    CommonEnvironmentHelper.DoingApi = "https://doingapi.staging.churchapps.org";
+    CommonEnvironmentHelper.GivingApi = "https://givingapi.staging.churchapps.org";
+    CommonEnvironmentHelper.MembershipApi = "https://membershipapi.staging.churchapps.org";
+    CommonEnvironmentHelper.ReportingApi = "https://reportingapi.staging.churchapps.org";
+    CommonEnvironmentHelper.MessagingApi = "https://messagingapi.staging.churchapps.org";
+    CommonEnvironmentHelper.MessagingApiSocket = "wss://socket.staging.churchapps.org";
+    CommonEnvironmentHelper.ContentApi = "https://contentapi.staging.churchapps.org";
+    CommonEnvironmentHelper.GoogleAnalyticsTag = "";
+
+    CommonEnvironmentHelper.ContentRoot = "https://content.staging.churchapps.org";
+    CommonEnvironmentHelper.B1Root = "https://{key}.staging.b1.church";
+    CommonEnvironmentHelper.ChumsRoot = "https://app.staging.chums.org";
+    CommonEnvironmentHelper.LessonsRoot = "https://staging.lessons.church";
+  }
+
+  //NOTE: None of these values are secret.
+  static initProd = () => {
+    CommonEnvironmentHelper.AttendanceApi = "https://attendanceapi.churchapps.org";
+    CommonEnvironmentHelper.DoingApi = "https://doingapi.churchapps.org";
+    CommonEnvironmentHelper.GivingApi = "https://givingapi.churchapps.org";
+    CommonEnvironmentHelper.MembershipApi = "https://membershipapi.churchapps.org";
+    CommonEnvironmentHelper.ReportingApi = "https://reportingapi.churchapps.org";
+    CommonEnvironmentHelper.MessagingApi = "https://messagingapi.churchapps.org";
+    CommonEnvironmentHelper.MessagingApiSocket = "wss://socket.churchapps.org";
+    CommonEnvironmentHelper.ContentApi = "https://contentapi.churchapps.org";
+
+    CommonEnvironmentHelper.ContentRoot = "https://content.churchapps.org";
+    CommonEnvironmentHelper.B1Root = "https://{key}.b1.church";
+    CommonEnvironmentHelper.ChumsRoot = "https://app.chums.org";
+    CommonEnvironmentHelper.LessonsRoot = "https://lessons.church";
+  }
+
+}
+

package/src/CurrencyHelper.ts

@@ -0,0 +1,10 @@
+export class CurrencyHelper {
+  static formatCurrency(amount: number) {
+    const formatter = new Intl.NumberFormat("en-US", {
+      style: "currency",
+      currency: "USD",
+      minimumFractionDigits: 2
+    });
+    return formatter.format(amount);
+  }
+}