@churchapps/apihelper 0.5.2 → 0.5.4

package/src/helpers/EmailHelper.ts

@@ -1,99 +0,0 @@
-import { SESClient, SendEmailCommand } from '@aws-sdk/client-ses';
-import nodemailer from 'nodemailer'
-// Removed nodemailer-direct-transport due to security vulnerabilities
-import { EnvironmentBase } from './EnvironmentBase.js';
-import { IEmailPayload } from './Interfaces.js';
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export class EmailHelper {
-
-  private static getSESClient(): SESClient {
-    return new SESClient({ region: "us-east-2" });
-  }
-
-  public static async sendTemplatedEmail(from: string, to: string, appName: string, appUrl: string, subject: string, contents: string, emailTemplate: "EmailTemplate.html" | "ChurchEmailTemplate.html" = "EmailTemplate.html", replyTo?: string) {
-    if (!appName) appName = "B1";
-    if (!appUrl) appUrl = "https://b1.church";
-
-    const template = EmailHelper.readTemplate(emailTemplate);
-    const emailBody = template
-      .replace("{appLink}", "<a target='_blank' rel='noreferrer noopener' href=\"" + appUrl + "/\">" + appName + "</a>")
-      .replace("{contents}", contents);
-    await EmailHelper.sendEmail({ from, to, subject, body: emailBody, replyTo });
-  }
-
-  public static readTemplate(templateFile?: string) {
-    if (!templateFile) templateFile = "EmailTemplate.html";
-    const filePath = path.join(__dirname, "../../src/tools/templates/" + templateFile);
-    const buffer = fs.readFileSync(filePath);
-    const contents = buffer.toString();
-    return contents;
-  }
-
-  private static async sendSes({ from, to, subject, body, replyTo }: IEmailPayload) {
-    const sesClient = this.getSESClient();
-      const sendCommand  = new SendEmailCommand({
-        Destination: {
-          ToAddresses: [to]
-        },
-        Message: {
-          Body: {
-            Html: {
-              Charset: 'UTF-8',
-              Data: body
-            }
-          },
-          Subject: {
-            Charset: 'UTF-8',
-            Data: subject
-          }
-        },
-        Source: from,
-        ReplyToAddresses: replyTo ? [replyTo] : undefined
-      });
-      await sesClient.send(sendCommand);
-  }
-
-  public static async sendEmail({ from, to, subject, body, replyTo }: IEmailPayload): Promise<void> {
-    try {
-      // Use a safer fallback - streamline transport (for testing/dev) or require proper SMTP config
-      let transporter: nodemailer.Transporter = nodemailer.createTransport({
-        streamTransport: true,
-        newline: 'unix',
-        buffer: true
-      });
-
-      if (EnvironmentBase.mailSystem === 'SES') {
-        await this.sendSes({ from, to, subject, body, replyTo });
-      } else {
-        if (EnvironmentBase.mailSystem === "SMTP") {
-          transporter = nodemailer.createTransport({
-            host: EnvironmentBase.smtpHost,
-            secure: EnvironmentBase.smtpSecure,
-            auth: {
-              user: EnvironmentBase.smtpUser,
-              pass: EnvironmentBase.smtpPass
-            }
-          });
-        }
-
-        if (EnvironmentBase.mailSystem === "") {
-          console.log("****Email server not configured: ");
-          console.log(subject);
-          console.log(body);
-        } else {
-          await transporter.sendMail({ from, to, subject, html: body, replyTo });
-        }
-      }
-      return null;
-    } catch (err) {
-      throw err;
-    }
-  }
-
-}

package/src/helpers/EncryptionHelper.ts

@@ -1,25 +0,0 @@
-import crypto from "crypto";
-import { EnvironmentBase } from "./EnvironmentBase.js";
-
-export class EncryptionHelper {
-  private static algorithm = 'aes-256-ctr';
-
-  static encrypt = (plainValue: string) => {
-    const iv = crypto.randomBytes(16);
-    const cipher = crypto.createCipheriv(EncryptionHelper.algorithm, EnvironmentBase.encryptionKey, iv);
-    const encrypted = Buffer.concat([cipher.update(plainValue), cipher.final()]);
-    return iv.toString('base64') + "|" + encrypted.toString('base64');
-  }
-
-  static decrypt = (encryptedPair: string) => {
-    const parts = encryptedPair.split("|");
-    if (parts.length !== 2) return "";
-    else {
-      const iv = Buffer.from(parts[0], 'base64');
-      const content = Buffer.from(parts[1], 'base64');
-      const decipher = crypto.createDecipheriv(EncryptionHelper.algorithm, EnvironmentBase.encryptionKey, iv);
-      const decrpyted = Buffer.concat([decipher.update(content), decipher.final()]);
-      return decrpyted.toString();
-    }
-  }
-}

package/src/helpers/EnvironmentBase.ts

@@ -1,36 +0,0 @@
-import { AwsHelper } from "./AwsHelper.js";
-
-export class EnvironmentBase {
-  static appEnv: string;
-  static appName: string;
-  static s3Bucket: string;
-  static connectionString: string;
-  static contentRoot: string;
-  static encryptionKey: string;
-  static fileStore: string;
-  static jwtSecret: string;
-
-  static mailSystem: string;
-  static smtpHost: string;
-  static smtpPass: string;
-  static smtpSecure: boolean;
-  static smtpUser: string;
-
-
-  static async populateBase(jsonData: Record<string, unknown>, appName:string, appEnv: string) {
-    EnvironmentBase.appName = jsonData.appName as string;
-    EnvironmentBase.appEnv = jsonData.appEnv as string;
-    EnvironmentBase.connectionString = process.env.CONNECTION_STRING || await AwsHelper.readParameter(`/${appEnv}/${appName}/connectionString`);
-    EnvironmentBase.contentRoot = jsonData.contentRoot as string;
-    EnvironmentBase.encryptionKey = process.env.ENCRYPTION_KEY || await AwsHelper.readParameter(`/${appEnv}/encryptionKey`);
-    EnvironmentBase.fileStore = jsonData.fileStore as string;
-    EnvironmentBase.jwtSecret = process.env.JWT_SECRET || await AwsHelper.readParameter(`/${appEnv}/jwtSecret`);
-    EnvironmentBase.mailSystem = jsonData.mailSystem as string;
-    EnvironmentBase.s3Bucket = jsonData.s3Bucket as string;
-    EnvironmentBase.smtpHost = process.env.SMTP_HOST;
-    EnvironmentBase.smtpPass = process.env.SMTP_PASS;
-    EnvironmentBase.smtpSecure = process.env.SMTP_SECURE === "true";
-    EnvironmentBase.smtpUser = process.env.SMTP_USER;
-  }
-
-}

package/src/helpers/FileStorageHelper.ts

@@ -1,71 +0,0 @@
-import { AwsHelper } from "./AwsHelper.js";
-import fs from "fs";
-import path from "path";
-import { EnvironmentBase } from "./EnvironmentBase.js";
-
-export class FileStorageHelper {
-  private static rootPath = path.resolve("./content") + "/";
-
-  static list = async (filePath: string) => {
-    let result = []
-    switch (EnvironmentBase.fileStore) {
-      case "S3": result = await AwsHelper.S3List(filePath); break;
-      default: result = await FileStorageHelper.listLocal(filePath); break;
-    }
-    return result
-  }
-
-  static move = async (oldKey: string, newKey: string) => {
-    switch (EnvironmentBase.fileStore) {
-      case "S3": await AwsHelper.S3Move(oldKey, newKey); break;
-      default: await FileStorageHelper.moveLocal(oldKey, newKey); break;
-    }
-  }
-
-  static store = async (key: string, contentType: string, contents: Buffer) => {
-    switch (EnvironmentBase.fileStore) {
-      case "S3": await AwsHelper.S3Upload(key, contentType, contents); break;
-      default: await FileStorageHelper.storeLocal(key, contents); break;
-    }
-  }
-
-  static remove = async (key: string) => {
-    switch (EnvironmentBase.fileStore) {
-      case "S3": await AwsHelper.S3Remove(key); break;
-      default: await FileStorageHelper.removeLocal(key); break;
-    }
-  }
-
-  static removeFolder = async (key: string) => {
-    switch (EnvironmentBase.fileStore) {
-      case "S3": break; // no need on s3
-      default: await FileStorageHelper.removeLocalFolder(key); break;
-    }
-  }
-
-  private static storeLocal = async (key: string, contents: Buffer) => {
-    const fileName = FileStorageHelper.rootPath + key;
-    const dirName = path.dirname(fileName);
-    if (!fs.existsSync(dirName)) fs.mkdirSync(dirName, { recursive: true });
-    fs.writeFileSync(fileName, contents);
-  }
-
-  private static moveLocal = async (oldKey: string, newKey: string) => {
-    fs.rename(oldKey, newKey, err => { throw err; });
-  }
-
-  private static removeLocal = async (key: string) => {
-    fs.unlinkSync(FileStorageHelper.rootPath + key);
-  }
-
-  private static removeLocalFolder = async (key: string) => {
-    fs.rmdirSync(FileStorageHelper.rootPath + key);
-  }
-
-  private static listLocal = async (filePath: string) => {
-    const fullPath = FileStorageHelper.rootPath + filePath;
-    if (!fs.existsSync(fullPath)) return [];
-    else return fs.readdirSync(FileStorageHelper.rootPath + filePath);
-  }
-
-}

package/src/helpers/Interfaces.ts

@@ -1,2 +0,0 @@
-export interface IPermission { contentType: string; action: string; apiName?: string }
-export interface IEmailPayload { from: string, to: string, subject: string, body: string, replyTo?: string }

package/src/helpers/LoggingHelper.ts

@@ -1,71 +0,0 @@
-import winston from "winston";
-import WinstonCloudWatch from "winston-cloudwatch";
-//import AWS from "aws-sdk";
-import { EnvironmentBase } from "./EnvironmentBase.js";
-
-export class LoggingHelper {
-  private static _current: LoggingHelper = null;
-  public static getCurrent = () => {
-    if (LoggingHelper._current === null) {
-      LoggingHelper._current = new LoggingHelper();
-      LoggingHelper._current.init("API");
-    }
-    return LoggingHelper._current;
-  }
-
-  private _logger: winston.Logger = null;
-  private wc: WinstonCloudWatch;
-  private pendingMessages = false;
-  private logGroupName = EnvironmentBase.appName + "_" + EnvironmentBase.appEnv;
-  private logDestination = "console";
-
-
-
-  public error(msg: string | object) {
-    throw msg instanceof Error ? msg : new Error(typeof msg === 'string' ? msg : JSON.stringify(msg));
-  }
-
-  public info(msg: string | object) {
-    if (this._logger === null) this.init("API");
-    this.pendingMessages = true;
-    this._logger.info(msg);
-  }
-
-  public log(streamName: string, level: string, msg: string | object) {
-    if (this._logger === null) this.init(streamName);
-    this.pendingMessages = true;
-    if (level === "info") this._logger.info(msg);
-    else this._logger.error(msg);
-  }
-
-
-  private init(streamName: string) {
-    this.pendingMessages = false;
-    //AWS.config.update({ region: "us-east-2" });
-    if (EnvironmentBase.appEnv === "staging") this.logDestination = "cloudwatch";
-    else if (EnvironmentBase.appEnv === "prod") this.logDestination = "cloudwatch";
-
-    if (this.logDestination === "cloudwatch") {
-      this.wc = new WinstonCloudWatch({ logGroupName: this.logGroupName, logStreamName: streamName, name: this.logGroupName + "_" + streamName });
-      this._logger = winston.createLogger({ transports: [this.wc], format: winston.format.json() });
-    } else this._logger = winston.createLogger({ transports: [new winston.transports.Console()], format: winston.format.json() });
-    this._logger.info("Logger initialized");
-  }
-
-  public flush() {
-    const promise = new Promise((resolve) => {
-      if (this.pendingMessages) {
-        if (this.wc) {
-          this.wc.kthxbye(() => {
-            // this._logger = null;
-            this.pendingMessages = false;
-          });
-        }
-        resolve(null);
-      } else resolve(null);
-    });
-    return promise;
-  }
-
-
-}

package/src/helpers/MySqlHelper.ts

@@ -1,5 +0,0 @@
-export class MySqlHelper {
-    static toQuotedAndCommaSeparatedString(values: string[]) {
-        return values.length === 0 ? "" : "'" + values.join("','") + "'";
-    }
-}

package/src/helpers/OmitEmpty.ts

@@ -1,128 +0,0 @@
-// Based on https://www.npmjs.com/package/omit-empty
-// The project appears to be abandoned, but needed modification to allow for empty arrays.
-
-"use strict";
-
-
-interface OmitEmptyOptions {
-    omitZero?: boolean;
-    omitEmptyArray?: boolean;
-    excludedProperties?: string[];
-}
-
-interface RuntimeOptions {
-    omitZero: boolean;
-    omitEmptyArray: boolean;
-    excludedProperties: string[];
-}
-
-export class OmitEmpty {
-    public static omitEmpty(obj: unknown, options: OmitEmptyOptions = {}): unknown {
-        const runtimeOpts = OmitEmpty._buildRuntimeOpts(options);
-
-        const omit = (value: unknown, opts: RuntimeOptions): unknown => {
-            if (Array.isArray(value)) {
-                value = value.map(v => omit(v, opts)).filter(v => !OmitEmpty.isEmpty(v, opts));
-            }
-
-            if (OmitEmpty.getType(value) === "object" && value !== null) {
-                const result: Record<string, unknown> = {};
-                for (const key of Object.keys(value as Record<string, unknown>)) {
-                    if (!opts.excludedProperties.includes(key)) {
-                        const val = omit((value as Record<string, unknown>)[key], opts);
-                        if (val !== void 0) {
-                            result[key] = val;
-                        }
-                    }
-                }
-                value = result;
-            }
-
-            if (!OmitEmpty.isEmpty(value, opts)) {
-                return value;
-            }
-        };
-
-        const res = omit(obj, runtimeOpts);
-        if (res === void 0) {
-            return OmitEmpty.getType(obj) === "object" ? {} : res;
-        }
-        return res;
-    }
-
-
-    private static _buildRuntimeOpts(options: OmitEmptyOptions = {}): RuntimeOptions {
-        return {
-            omitZero: options.omitZero || false,
-            omitEmptyArray: options.omitEmptyArray || false,
-            excludedProperties: options.excludedProperties || []
-        };
-    };
-
-    private static getType(value: unknown): string {
-        if (value === null) return "null";
-        if (value === undefined) return "undefined";
-        if (Array.isArray(value)) return "array";
-        if (value instanceof Date) return "date";
-        if (value instanceof RegExp) return "regexp";
-        if (value instanceof Error) return "error";
-        if (value instanceof Map) return "map";
-        if (value instanceof Set) return "set";
-        if (value instanceof File) return "file";
-        
-        const type = typeof value;
-        if (type === "object") {
-            // Check if it's an arguments object
-            if (Object.prototype.toString.call(value) === '[object Arguments]') {
-                return "arguments";
-            }
-        }
-        return type;
-    }
-
-    private static isEmpty(value: unknown, runtimeOpts: RuntimeOptions): boolean {
-        switch (OmitEmpty.getType(value)) {
-            case "null":
-            case "undefined":
-                return true;
-            case "boolean":
-            case "function":
-            case "date":
-            case "regexp":
-                return false;
-            case "string":
-            case "arguments":
-                return (value as string).length === 0;
-            case "file":
-            case "map":
-            case "set":
-                return (value as { size: number }).size === 0;
-            case "number":
-                return runtimeOpts.omitZero ? value === 0 : false;
-            case "error":
-                return (value as Error).message === "";
-            case "array":
-                if (runtimeOpts.omitEmptyArray) {
-                    for (const ele of (value as unknown[])) {
-                        if (!OmitEmpty.isEmpty(ele, runtimeOpts)) {
-                            return false;
-                        }
-                    }
-                    return true;
-                } else {
-                    return false;
-                }
-            case "object":
-                for (const key of Object.keys(value as Record<string, unknown>)) {
-                    if (!OmitEmpty.isEmpty((value as Record<string, unknown>)[key], runtimeOpts)) {
-                        return false;
-                    }
-                }
-                return true;
-            default: {
-                return true;
-            }
-        }
-    }
-
-}

package/src/helpers/Pool.ts

@@ -1,56 +0,0 @@
-import dotenv from "dotenv";
-import mysql from "mysql2";
-import { EnvironmentBase } from "./EnvironmentBase.js";
-
-dotenv.config();
-
-export class Pool {
-  public static current: mysql.Pool;
-
-  public static initPool() {
-    const config = this.getConfig(EnvironmentBase.connectionString);
-
-    Pool.current = mysql.createPool({
-      connectionLimit: 3,
-      host: config.host,
-      port: config.port,
-      database: config.database,
-      user: config.userName,
-      password: config.password,
-      multipleStatements: true,
-      waitForConnections: true,
-      queueLimit: 9999,
-      charset: 'utf8mb4',
-      typeCast: function castField(field: mysql.Field, useDefaultTypeCasting: () => unknown) {
-        // convert bit(1) to bool
-        if ((field.type === "BIT") && (field.length === 1)) {
-          try {
-            const bytes = field.buffer();
-            return (bytes[0] === 1);
-          } catch { return false; }
-        }
-        return useDefaultTypeCasting();
-      }
-    });
-  }
-
-  // a bit of a hack
-  private static getConfig = (connectionString: string) => {
-    // mysql://user:password@host:port/dbName
-    const firstSplit = connectionString.replace("mysql://", "").split("@");
-    const userPass = firstSplit[0].split(":");
-    const userName = userPass[0];
-    const password = userPass[1];
-
-    const hostDb = firstSplit[1].split("/");
-    const database = hostDb[1];
-    const hostPort = hostDb[0].split(':');
-    const host = hostPort[0];
-    const port = parseInt(hostPort[1], 0)
-
-    return { host, port, database, userName, password }
-
-  }
-
-}
-

package/src/helpers/SlugHelper.ts

@@ -1,37 +0,0 @@
-
-export class SlugHelper {
-
-  static slugifyString(string: string, removeCharacters?: string[]) {
-    const charactersToRemove = removeCharacters ? removeCharacters : ["for", "and", "nor", "but", "or", "yet", "so", "the", "a", "an"];
-    const characStr = charactersToRemove.join("|");
-    const regex = new RegExp('\\b(' + characStr + ')\\b', 'gi')
-    const cleaned = string.replace(regex, '');
-
-    const initialSlug = cleaned.replace(/ /g, "-").toLowerCase();
-    const verfiedSlug = this.numerifySlug(initialSlug);
-    return verfiedSlug;
-  }
-
-  //remove multiple numbers in sequence
-  static numerifySlug(slug: string) {
-    let initialString = slug;
-    const regex = /\d+(?:-\d+)+|\d+/g;
-    const matchedArray = initialString.match(regex);
-
-    if (matchedArray) {
-      matchedArray.forEach((data) => {
-        const length = data.length;
-        let splitResult = data;
-        if (length > 1) {
-          const array = data.split("");
-          splitResult = array[0];
-        }
-        const replacedString = initialString.replace(data, splitResult);
-        initialString = replacedString;
-      });
-    }
-
-    return initialString;
-  }
-
-}

package/src/helpers/index.ts

@@ -1,17 +0,0 @@
-export * from "@churchapps/helpers";
-
-// Export all local helpers
-export * from "./AwsHelper.js";
-export * from "./DB.js";
-export * from "./DBCreator.js";
-export * from "./EncryptionHelper.js";
-export * from "./EnvironmentBase.js";
-export * from "./FileStorageHelper.js";
-export * from "./Interfaces.js";
-export * from "./LoggingHelper.js";
-export * from "./OmitEmpty.js";
-export * from "./BasePermissions.js";
-export * from "./EmailHelper.js";
-export * from "./MySqlHelper.js";
-export * from "./Pool.js";
-export * from "./SlugHelper.js";

package/src/index.ts

@@ -1,3 +0,0 @@
-export * from "./helpers/index.js";
-export * from "./auth/index.js";
-export * from "./controllers/index.js";

package/src/models/ErrorLog.ts

@@ -1,7 +0,0 @@
-
-export class ErrorLog {
-  public application?: string;
-  public level?: string;
-  public message?: string;
-  public additionalDetails?: string;
-}

package/src/models/index.ts

@@ -1 +0,0 @@
-export { ErrorLog } from "./ErrorLog.js";