mp-js-api 0.0.4 → 0.0.5

package/dist/tables/households.js

@@ -1,60 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapHouseholdRecord = mapHouseholdRecord;
-exports.mapHouseholdToHouseholdRecord = mapHouseholdToHouseholdRecord;
-function mapHouseholdRecord(householdRecord) {
-    return {
-        householdID: householdRecord.Household_ID,
-        householdName: householdRecord.Household_Name,
-        addressID: householdRecord.Address_ID,
-        homePhone: householdRecord.Home_Phone,
-        congregationID: householdRecord.Congregation_ID,
-        carePerson: householdRecord.Care_Person,
-        householdSourceID: householdRecord.Household_Source_ID,
-        familyCallNumber: householdRecord.Family_Call_Number,
-        householdPreferences: householdRecord.Household_Preferences,
-        homePhoneUnlisted: householdRecord.Home_Phone_Unlisted,
-        homeAddressUnlisted: householdRecord.Home_Address_Unlisted,
-        bulkMailOptOut: householdRecord.Bulk_Mail_Opt_Out,
-        firstDonation: householdRecord._First_Donation,
-        lastDonation: householdRecord._Last_Donation,
-        lastActivity: householdRecord._Last_Activity,
-        seasonalAlternateAddressSettings: householdRecord.Seasonal_Alternate_Address_Settings,
-        alternateMailingAddress: householdRecord.Alternate_Mailing_Address,
-        seasonStart: householdRecord.Season_Start,
-        seasonEnd: householdRecord.Season_End,
-        repeatsAnnually: householdRecord.Repeats_Annually,
-        endSeasonalAlternateAddressSettings: householdRecord.End_Seasonal_Alternate_Address_Settings,
-        congregationDriveTime: householdRecord.Congregation_Drive_Time,
-        drivingDistance: householdRecord.Driving_Distance,
-        drivingTime: householdRecord.Driving_Time,
-    };
-}
-function mapHouseholdToHouseholdRecord(household) {
-    return {
-        Household_ID: household.householdID,
-        Household_Name: household.householdName,
-        Address_ID: household.addressID,
-        Home_Phone: household.homePhone,
-        Congregation_ID: household.congregationID,
-        Care_Person: household.carePerson,
-        Household_Source_ID: household.householdSourceID,
-        Family_Call_Number: household.familyCallNumber,
-        Household_Preferences: household.householdPreferences,
-        Home_Phone_Unlisted: household.homePhoneUnlisted,
-        Home_Address_Unlisted: household.homeAddressUnlisted,
-        Bulk_Mail_Opt_Out: household.bulkMailOptOut,
-        _First_Donation: household.firstDonation,
-        _Last_Donation: household.lastDonation,
-        _Last_Activity: household.lastActivity,
-        Seasonal_Alternate_Address_Settings: household.seasonalAlternateAddressSettings,
-        Alternate_Mailing_Address: household.alternateMailingAddress,
-        Season_Start: household.seasonStart,
-        Season_End: household.seasonEnd,
-        Repeats_Annually: household.repeatsAnnually,
-        End_Seasonal_Alternate_Address_Settings: household.endSeasonalAlternateAddressSettings,
-        Congregation_Drive_Time: household.congregationDriveTime,
-        Driving_Distance: household.drivingDistance,
-        Driving_Time: household.drivingTime,
-    };
-}

package/dist/tables/participants.d.ts

@@ -58,6 +58,4 @@ export interface Participant {
     birthCertificateCity: null | string;
     birthCertificateState: null | string;
 }
-export declare function mapParticipantRecord(record: ParticipantRecord): Participant;
-export declare function mapParticipantToParticipantRecord(participant: Participant): ParticipantRecord;
 //# sourceMappingURL=participants.d.ts.map

package/dist/tables/participants.d.ts.map

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

package/dist/tables/participants.js

@@ -1,68 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapParticipantRecord = mapParticipantRecord;
-exports.mapParticipantToParticipantRecord = mapParticipantToParticipantRecord;
-function mapParticipantRecord(record) {
-    return {
-        participantID: record.Participant_ID,
-        redFlagNotes: record.Red_Flag_Notes,
-        contactID: record.Contact_ID,
-        participantTypeID: record.Participant_Type_ID,
-        memberStatusID: record.Member_Status_ID,
-        participantEngagementID: record.Participant_Engagement_ID,
-        participantStartDate: record.Participant_Start_Date,
-        participantEndDate: record.Participant_End_Date,
-        notes: record.Notes,
-        firstAttendanceEver: record._First_Attendance_Ever,
-        secondAttendanceEver: record._Second_Attendance_Ever,
-        thirdAttendanceEver: record._Third_Attendance_Ever,
-        lastAttendanceEver: record._Last_Attendance_Ever,
-        subStatusName: record.SubStatus_Name,
-        statusDate: record.Status_Date,
-        formerDenomination: record.Former_Denomination,
-        formerChurch: record.Former_Church,
-        backgroundCheckInformation: record._Background_Check_Information,
-        backgroundCheckType: record._Background_Check_Type,
-        backgroundCheckStatus: record._Background_Check_Status,
-        backgroundCheckDate: record._Background_Check_Date,
-        sacramentInformation: record.Sacrament_Information,
-        churchOfRecord: record.Church_of_Record,
-        baptismParishName: record.Baptism_Parish_Name,
-        baptismParishAddress: record.Baptism_Parish_Address,
-        birthCertificateAddress: record.Birth_Certificate_Address,
-        birthCertificateCity: record.Birth_Certificate_City,
-        birthCertificateState: record.Birth_Certificate_State,
-    };
-}
-function mapParticipantToParticipantRecord(participant) {
-    return {
-        Participant_ID: participant.participantID,
-        Red_Flag_Notes: participant.redFlagNotes,
-        Contact_ID: participant.contactID,
-        Participant_Type_ID: participant.participantTypeID,
-        Member_Status_ID: participant.memberStatusID,
-        Participant_Engagement_ID: participant.participantEngagementID,
-        Participant_Start_Date: participant.participantStartDate,
-        Participant_End_Date: participant.participantEndDate,
-        Notes: participant.notes,
-        _First_Attendance_Ever: participant.firstAttendanceEver,
-        _Second_Attendance_Ever: participant.secondAttendanceEver,
-        _Third_Attendance_Ever: participant.thirdAttendanceEver,
-        _Last_Attendance_Ever: participant.lastAttendanceEver,
-        SubStatus_Name: participant.subStatusName,
-        Status_Date: participant.statusDate,
-        Former_Denomination: participant.formerDenomination,
-        Former_Church: participant.formerChurch,
-        _Background_Check_Information: participant.backgroundCheckInformation,
-        _Background_Check_Type: participant.backgroundCheckType,
-        _Background_Check_Status: participant.backgroundCheckStatus,
-        _Background_Check_Date: participant.backgroundCheckDate,
-        Sacrament_Information: participant.sacramentInformation,
-        Church_of_Record: participant.churchOfRecord,
-        Baptism_Parish_Name: participant.baptismParishName,
-        Baptism_Parish_Address: participant.baptismParishAddress,
-        Birth_Certificate_Address: participant.birthCertificateAddress,
-        Birth_Certificate_City: participant.birthCertificateCity,
-        Birth_Certificate_State: participant.birthCertificateState,
-    };
-}

package/dist/utils/strings.d.ts

@@ -1,7 +1,16 @@
+export declare function stringifyURLParams<T = any>(mpOptions?: Record<string, T>): string;
 export declare function escapeSql(str: string): string;
-export declare function toCamelCase(str: string): string;
-export declare function toCapitalSnakeCase(str: string): string;
-export declare function caseConverter<T>(obj: T, type: 'toCamel' | 'toSnake'): any;
-export declare function convertToCamelCase<T = any, R = any>(obj: T): R;
-export declare function convertToSnakeCase<T = any, R = any>(obj: T): R;
+export declare function toCamelCase(str: string, { capitalIds }?: {
+    capitalIds?: boolean;
+}): string;
+export declare function toCapitalSnakeCase(str: string, { capitalIds, capitalSnake }?: {
+    capitalIds?: boolean;
+    capitalSnake?: boolean;
+}): string;
+export declare function caseConverter<T>(obj: T, { type, capitalIds }: {
+    type: 'toCamel' | 'toSnake';
+    capitalIds?: boolean;
+}): any;
+export declare function convertToCamelCase<T = any, R = any>(obj: Partial<T>, capitalIds?: boolean): R;
+export declare function convertToSnakeCase<T = any, R = any>(obj: Partial<T>, capitalIds?: boolean): R;
 //# sourceMappingURL=strings.d.ts.map

package/dist/utils/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,UA2BpC;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,UAKtC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAK7C;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,OAkBnE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAE9D;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAE9D"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAM,UAS5E;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,UA2BpC;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,UAAkB,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;CAAM,UAM7F;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,UAAkB,EAAE,YAAmB,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAAM,UAKjJ;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,UAAkB,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAAE,OAkB5H;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,UAAO,GAAG,CAAC,CAE1F;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,UAAO,GAAG,CAAC,CAE1F"}

package/dist/utils/strings.js

@@ -1,11 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringifyURLParams = stringifyURLParams;
 exports.escapeSql = escapeSql;
 exports.toCamelCase = toCamelCase;
 exports.toCapitalSnakeCase = toCapitalSnakeCase;
 exports.caseConverter = caseConverter;
 exports.convertToCamelCase = convertToCamelCase;
 exports.convertToSnakeCase = convertToSnakeCase;
+function stringifyURLParams(mpOptions = {}) {
+    return escapeSql(Object.entries(mpOptions).reduce((acc, [key, value]) => {
+        if (!acc) {
+            acc += `?$${key}=${value}`;
+        }
+        else {
+            acc += `&$${key}=${value}`;
+        }
+        return acc;
+    }, ''));
+}
 function escapeSql(str) {
     return str.replace(/%|(?<=\w)'(?=\w)/g, function (char) {
         switch (char) {
@@ -34,39 +46,40 @@ function escapeSql(str) {
         }
     });
 }
-function toCamelCase(str) {
-    str = str.replace(/((?<=^_|^__))[^\W_]/g, match => match.at(-1)?.toLowerCase() || ''); // keep underscore if first char
+function toCamelCase(str, { capitalIds = false } = {}) {
+    str = str.replace('-', '');
+    str = str.replace(/^_?[A-Z]{1,3}/, match => match.toLowerCase()); // Don't convert if start with ID, HS, SMS, etc
+    str = str.replace(/(?<=^_|^__)[^\W_]/g, match => match.at(-1)?.toLowerCase() || ''); // keep underscore if first char
     str = str.replace(/(?<!^_|^)_[^\W_]/g, match => match.charAt(1).toUpperCase()); // remove underscore if not first char
-    str = str.charAt(0).toLowerCase() + str.slice(1);
-    return str.replace(/id$/i, 'ID');
+    return capitalIds ? str.replace(/id$/i, 'ID') : str;
 }
-function toCapitalSnakeCase(str) {
+function toCapitalSnakeCase(str, { capitalIds = false, capitalSnake = true } = {}) {
     str = str.replace(/(?<=^_|^__)[^\W_]/, match => match.at(0)?.toUpperCase() || '');
     str = str.replace(/(?<!_|\/)(ID|[A-Z])/g, match => `_${match}`);
-    str = str.charAt(0).toUpperCase() + str.slice(1);
-    return str.replace(/_id$/i, '_ID');
+    str = capitalSnake ? str.charAt(0).toUpperCase() + str.slice(1) : str;
+    return capitalIds ? str.replace(/_id$/i, '_ID') : str;
 }
 // Function to recursively convert object keys to Capital_Snake_Case
-function caseConverter(obj, type) {
+function caseConverter(obj, { type, capitalIds = false }) {
     const caseFn = type === 'toCamel' ? toCamelCase : toCapitalSnakeCase;
     if (Array.isArray(obj)) {
-        return obj.map(val => caseConverter(val, type)); // Recursively process each array element
+        return obj.map(val => caseConverter(val, { type })); // Recursively process each array element
     }
     if (obj !== null && typeof obj === 'object') {
         const snakeCaseObj = {};
         for (const key in obj) {
             if (obj.hasOwnProperty(key)) {
-                const snakeCaseKey = caseFn(key); // Convert key to Snake_Case
-                snakeCaseObj[snakeCaseKey] = caseConverter(obj[key], type); // Recursively process nested objects
+                const snakeCaseKey = caseFn(key, { capitalIds }); // Convert key to Snake_Case
+                snakeCaseObj[snakeCaseKey] = caseConverter(obj[key], { type }); // Recursively process nested objects
             }
         }
         return snakeCaseObj;
     }
     return obj; // Return value if it's neither an array nor an object
 }
-function convertToCamelCase(obj) {
-    return caseConverter(obj, 'toCamel');
+function convertToCamelCase(obj, capitalIds = true) {
+    return caseConverter(obj, { type: 'toCamel', capitalIds });
 }
-function convertToSnakeCase(obj) {
-    return caseConverter(obj, 'toSnake');
+function convertToSnakeCase(obj, capitalIds = true) {
+    return caseConverter(obj, { type: 'toSnake', capitalIds });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mp-js-api",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Node MinistryPlatform API",
   "main": "dist/index.js",
   "scripts": {

package/src/api.ts

@@ -0,0 +1,266 @@
+import axios, { AxiosError, AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
+import { URLSearchParams } from 'url';
+import { convertToCamelCase, convertToSnakeCase, stringifyURLParams } from './utils/strings';
+
+
+export type APIGetOneInstance = <T, R>({ id, path, mpOptions, config }: APIGetParameter & { id: number; }) => Promise<R | undefined | { error: ErrorDetails; }>;
+export type APIGetMultipleInstance = <T, R>({ path, mpOptions, config }: APIGetParameter) => Promise<R[] | { error: ErrorDetails; }>;
+export type APICreateInstance = <T, R>({ path, mpOptions, params, config }: APICreateParameter<T>) => Promise<R | { error: ErrorDetails; }>;
+export type APIUpdateInstance = <T, R>({ path, mpOptions, params, config }: APIUpdateParameter<T>) => Promise<R[] | { error: ErrorDetails; }>;
+
+
+export interface MPApiBase {
+  getOne: APIGetOneInstance;
+  getMultiple: APIGetMultipleInstance;
+  create: APICreateInstance;
+  update: APIUpdateInstance;
+  get: AxiosInstance['get'];
+  post: AxiosInstance['post'];
+  put: AxiosInstance['put'];
+  getError: (error: AxiosError) => ErrorDetails;
+}
+
+export interface ErrorDetails {
+  message: string;
+  name: string;
+  code?: string;
+  status?: number;
+  method?: string;
+  url?: string;
+  data: string;
+  error: true;
+}
+
+
+const createTokenGetter = (auth: { username: string; password: string; }) => {
+  let token: AccessToken | undefined;
+
+  return async () => {
+    // If the token is near expiration, get a new one.
+    if (!token || token.expiration - 60000 < Date.now()) {
+      const tokenRes = await axios.post<TokenData>(
+        'https://mp.revival.com/ministryplatformapi/oauth/connect/token',
+        new URLSearchParams({
+          grant_type: 'client_credentials',
+          scope: 'http://www.thinkministry.com/dataplatform/scopes/all',
+        }).toString(),
+        { auth }
+      );
+      const [, payload] = tokenRes.data.access_token.split('.');
+      try {
+        const jsonPayload: { exp: number; } = JSON.parse(
+          Buffer.from(payload, 'base64url').toString()
+        );
+        token = {
+          digest: tokenRes.data.access_token,
+          expiration: jsonPayload.exp * 1000,
+        };
+        return token.digest;
+      } catch (err) {
+        console.error(err);
+      }
+    } else {
+      return token.digest;
+    }
+  };
+};
+
+export const createApiBase = ({ auth }: { auth: { username: string; password: string; }; }): MPApiBase => {
+  /**
+   * Gets MP oauth token.
+   * @returns token
+   */
+  const getToken = createTokenGetter(auth);
+  const api = axios.create({
+    baseURL: 'https://mp.revival.com/ministryplatformapi',
+  });
+
+  const getOne: APIGetOneInstance = async <T, R>({ id, path, mpOptions, config }) => {
+    try {
+      const url = `${path}/${id}` + stringifyURLParams(mpOptions);
+      const res = await api.get<T>(url, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          Authorization: `Bearer ${await getToken()}`,
+        },
+      });
+      return res.data[0] ? convertToCamelCase<T, R>(res.data[0]) : undefined;
+    }
+    catch (err) {
+      return { error: getError(err) };
+    }
+  };
+
+  const getMultiple: APIGetMultipleInstance = async <T, R>({ path, mpOptions, config }: APIGetParameter) => {
+    try {
+      const url = path + stringifyURLParams(mpOptions);
+      const res = await api.get<T[]>(url, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          Authorization: `Bearer ${await getToken()}`,
+        },
+      });
+      return res.data.map(record => convertToCamelCase<T, R>(record));
+    }
+    catch (err) {
+      return { error: getError(err) };
+    }
+  };
+
+
+  const create: APICreateInstance = async <T, R>({ path, mpOptions, params, config }: APICreateParameter<T>) => {
+    const query = stringifyURLParams(mpOptions);
+    const data = [convertToSnakeCase<T>(params)];
+    try {
+      const res = await api.post(path + query, data, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          Authorization: `Bearer ${await getToken()}`,
+        },
+      });
+      return convertToCamelCase<any, R>(res.data[0]);
+    }
+    catch (err) {
+      return { error: getError(err) };
+    }
+
+  };
+
+
+  const update: APIUpdateInstance = async <T, R>({ path, mpOptions, params, config }: APIUpdateParameter<T>) => {
+    const query = stringifyURLParams(mpOptions);
+    const data = params.map(r => convertToSnakeCase<T>(r));
+    try {
+      const res = await api.put(path + query, data, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          Authorization: `Bearer ${await getToken()}`,
+        },
+      });
+      return res.data.map(record => convertToCamelCase<any, R>(record));
+    }
+    catch (err) {
+      return { error: getError(err) };
+    }
+
+  };
+
+  const get = async <T = any, R = AxiosResponse<T, any>>(
+    url: string,
+    config?: AxiosRequestConfig
+  ) =>
+    api.get<T, R>(url, {
+      ...config,
+      headers: {
+        ...config?.headers,
+        Authorization: `Bearer ${await getToken()}`,
+      },
+    });
+
+  const post = async <T, R = AxiosResponse<T, any>>(
+    url: string,
+    data?: any,
+    config?: AxiosRequestConfig
+  ) =>
+    api.post<T, R>(url, data, {
+      ...config,
+      headers: {
+        ...config?.headers,
+        Authorization: `Bearer ${await getToken()}`,
+      },
+    });
+
+  const put = async <T, R = AxiosResponse<T, any>>(
+    url: string,
+    data?: any,
+    config?: AxiosRequestConfig
+  ) =>
+    api.put<T, R>(url, data, {
+      ...config,
+      headers: {
+        ...config?.headers,
+        Authorization: `Bearer ${await getToken()}`,
+      },
+    });
+
+
+  const getError = function (error: AxiosError): ErrorDetails {
+    return {
+      error: true,
+      message: error.message,
+      name: error.name,
+      code: error.code,
+      status: error.status,
+      method: error.config?.method,
+      url: error.config?.url,
+      data: error.config?.data
+    };
+  };
+
+  return {
+    create,
+    update,
+    get,
+    put,
+    post,
+    getOne,
+    getMultiple,
+    getError
+  };
+};
+
+
+
+
+
+interface TokenData {
+  access_token: string;
+  expires_in: number;
+  token_type: 'Bearer';
+}
+
+interface AccessToken {
+  digest: string;
+  expiration: number;
+}
+
+export type MPGetOptions = {
+  select?: string;
+  filter?: string;
+  orderBy?: string;
+  groupBy?: string;
+  top?: number;
+  skip?: number;
+  distinct?: boolean;
+};
+
+export type MPCreateOptions = {
+  userId?: number;
+  select?: string;
+};
+
+export type MPUpdateOptions = MPCreateOptions;
+
+interface APIGetParameter {
+  path: string;
+  mpOptions?: MPGetOptions;
+  config?: AxiosRequestConfig;
+}
+
+interface APICreateParameter<T> {
+  path: string;
+  params: T,
+  mpOptions?: MPCreateOptions;
+  config?: AxiosRequestConfig;
+};
+
+interface APIUpdateParameter<T> {
+  path: string;
+  params: T[],
+  mpOptions?: MPCreateOptions;
+  config?: AxiosRequestConfig;
+};