@churchapps/helpers 1.2.23 → 1.2.25

package/src/UserHelper.ts

@@ -1,62 +0,0 @@
-import { ApiHelper } from "./ApiHelper.js"
-import { UserInterface, UserContextInterface, IApiPermission, PersonInterface, LoginUserChurchInterface } from "./interfaces/index.js";
-
-export class UserHelper {
-  static currentUserChurch: LoginUserChurchInterface;
-  static userChurches: LoginUserChurchInterface[];
-  static user: UserInterface;
-  static churchChanged: boolean = false;
-  static person: PersonInterface;
-
-  static selectChurch = async (context?: UserContextInterface, churchId?: string, keyName?: string) => {
-    let userChurch = null;
-
-    if (churchId) {
-      UserHelper.userChurches.forEach(uc => {
-        if (uc.church.id === churchId) userChurch = uc;
-      });
-    }
-    else if (keyName) UserHelper.userChurches.forEach(uc => { if (uc.church.subDomain === keyName) userChurch = uc; });
-    else userChurch = UserHelper.userChurches[0];
-    if (!userChurch) return;
-    else {
-      UserHelper.currentUserChurch = userChurch;
-      UserHelper.setupApiHelper(UserHelper.currentUserChurch);
-      // TODO - remove context code from here and perform the logic in the component itself.
-      if (context) {
-        if (context.userChurch !== null) UserHelper.churchChanged = true;
-        context.setUserChurch(UserHelper.currentUserChurch);
-      }
-    }
-  }
-
-  static setupApiHelper(userChurch: LoginUserChurchInterface) {
-    ApiHelper.setDefaultPermissions(userChurch.jwt);
-    userChurch.apis.forEach(api => { ApiHelper.setPermissions(api.keyName, api.jwt, api.permissions); });
-  }
-
-  static setupApiHelperNoChurch(user: LoginUserChurchInterface) {
-    ApiHelper.setDefaultPermissions(user.jwt);
-  }
-
-  static checkAccess({ api, contentType, action }: IApiPermission): boolean {
-    const config = ApiHelper.getConfig(api);
-    if (!config) return false;
-    const permissions = config.permissions;
-
-    let result = false;
-    if (permissions !== undefined) {
-      permissions.forEach(element => {
-        if (element.contentType === contentType && element.action === action) result = true;
-      });
-    }
-    return result;
-  }
-
-  static createAppUrl(appUrl: string, returnUrl: string) {
-    const config = ApiHelper.getConfig("MembershipApi");
-    const jwt = config?.jwt || "";
-
-    return `${appUrl}/login/?jwt=${jwt}&returnUrl=${returnUrl}`;
-  }
-}

package/src/contentProviders/ContentProvider.ts

@@ -1,15 +0,0 @@
-import type { PlanInterface, PlanItemInterface, PlanItemContentInterface } from "../interfaces/index.js";
-
-export interface ContentProviderInterface {
-  // Unique identifier for this provider
-  readonly providerId: string;
-
-  // Check if this provider handles the given plan/planItem
-  canHandle(plan: PlanInterface, planItem: PlanItemInterface): boolean;
-
-  // Fetch content for multiple planItems (batch for efficiency)
-  fetchContent(
-    plan: PlanInterface,
-    planItems: PlanItemInterface[]
-  ): Promise<Map<string, PlanItemContentInterface>>;
-}

package/src/contentProviders/LessonsContentProvider.ts

@@ -1,279 +0,0 @@
-import { ApiHelper } from "../ApiHelper.js";
-import type { PlanInterface, PlanItemInterface, PlanItemContentInterface, ExternalVenueRefInterface } from "../interfaces/index.js";
-import type { VenuePlanItemsResponseInterface, VenueActionResponseInterface, LessonTreeInterface, LessonActionTreeInterface } from "../interfaces/Lessons.js";
-import type { ContentProviderInterface } from "./ContentProvider.js";
-
-export class LessonsContentProvider implements ContentProviderInterface {
-  readonly providerId = "lessons";
-
-  private lessonsUrl: string;
-
-  constructor(lessonsUrl: string = "https://lessons.church") {
-    this.lessonsUrl = lessonsUrl;
-  }
-
-  canHandle(plan: PlanInterface, planItem: PlanItemInterface): boolean {
-    // Handles: lessonAction, lessonAddOn, lessonSection, and items with relatedId when plan has lesson
-    const lessonTypes = ["lessonAction", "lessonAddOn", "lessonSection"];
-    const hasLessonPlan = plan?.contentType === "venue" || plan?.contentType === "externalVenue";
-
-    if (lessonTypes.includes(planItem.itemType) && planItem.relatedId) return true;
-    if (planItem.itemType === "item" && planItem.relatedId && hasLessonPlan) return true;
-
-    return false;
-  }
-
-  async fetchContent(
-    plan: PlanInterface,
-    planItems: PlanItemInterface[]
-  ): Promise<Map<string, PlanItemContentInterface>> {
-    const result = new Map<string, PlanItemContentInterface>();
-
-    // Group by type for efficient batching
-    const actions = planItems.filter(p => p.itemType === "lessonAction" && p.relatedId);
-    const addOns = planItems.filter(p => p.itemType === "lessonAddOn" && p.relatedId);
-    const sections = planItems.filter(p =>
-      (p.itemType === "lessonSection" || p.itemType === "item") && p.relatedId
-    );
-
-    const externalRef = this.getExternalRef(plan);
-
-    // Build embed URLs for each item
-    for (const item of actions) {
-      result.set(item.id, {
-        provider: this.providerId,
-        embedUrl: externalRef
-          ? `${this.lessonsUrl}/embed/external/${externalRef.externalProviderId}/action/${item.relatedId}`
-          : `${this.lessonsUrl}/embed/action/${item.relatedId}`
-      });
-    }
-
-    for (const item of addOns) {
-      result.set(item.id, {
-        provider: this.providerId,
-        embedUrl: externalRef
-          ? `${this.lessonsUrl}/embed/external/${externalRef.externalProviderId}/addon/${item.relatedId}`
-          : `${this.lessonsUrl}/embed/addon/${item.relatedId}`
-      });
-    }
-
-    for (const item of sections) {
-      result.set(item.id, {
-        provider: this.providerId,
-        embedUrl: externalRef
-          ? `${this.lessonsUrl}/embed/external/${externalRef.externalProviderId}/section/${item.relatedId}`
-          : `${this.lessonsUrl}/embed/section/${item.relatedId}`
-      });
-    }
-
-    return result;
-  }
-
-  // ============================================
-  // Plan/Lesson Association Methods
-  // ============================================
-
-  hasAssociatedLesson(plan: PlanInterface): boolean {
-    return (plan?.contentType === "venue" || plan?.contentType === "externalVenue") && !!plan?.contentId;
-  }
-
-  isExternalVenue(plan: PlanInterface): boolean {
-    return plan?.contentType === "externalVenue";
-  }
-
-  getExternalRef(plan: PlanInterface): ExternalVenueRefInterface | null {
-    if (!this.isExternalVenue(plan) || !plan?.contentId) return null;
-    try {
-      return JSON.parse(plan.contentId);
-    } catch {
-      return null;
-    }
-  }
-
-  getVenueId(plan: PlanInterface): string | null {
-    if (!this.hasAssociatedLesson(plan)) return null;
-    if (this.isExternalVenue(plan)) {
-      return this.getExternalRef(plan)?.venueId || null;
-    }
-    return plan.contentId || null;
-  }
-
-  // ============================================
-  // API Fetch Methods
-  // ============================================
-
-  /**
-   * Fetch venue plan items - the basic hierarchical structure
-   * Returns: headers with children (sections), but sections don't have their actions
-   * Use this for preview mode display
-   */
-  async fetchVenuePlanItems(plan: PlanInterface): Promise<VenuePlanItemsResponseInterface> {
-    if (!this.hasAssociatedLesson(plan)) return { items: [] };
-    const externalRef = this.getExternalRef(plan);
-    if (externalRef) {
-      return await ApiHelper.getAnonymous(
-        `/externalProviders/${externalRef.externalProviderId}/venue/${externalRef.venueId}/planItems`,
-        "LessonsApi"
-      );
-    }
-    return await ApiHelper.getAnonymous(`/venues/public/planItems/${plan.contentId}`, "LessonsApi");
-  }
-
-  /**
-   * Fetch venue actions - sections with their full action lists
-   * Use this for action selection dialogs and full expansion
-   */
-  async fetchVenueActions(plan: PlanInterface): Promise<VenueActionResponseInterface> {
-    if (!this.hasAssociatedLesson(plan)) return { sections: [] };
-    const externalRef = this.getExternalRef(plan);
-    if (externalRef) {
-      return await ApiHelper.getAnonymous(
-        `/externalProviders/${externalRef.externalProviderId}/venue/${externalRef.venueId}/actions`,
-        "LessonsApi"
-      );
-    }
-    return await ApiHelper.getAnonymous(`/venues/public/actions/${plan.contentId}`, "LessonsApi");
-  }
-
-  /**
-   * Fetch the full lesson tree for browsing (programs -> studies -> lessons -> venues)
-   */
-  async fetchLessonTree(): Promise<LessonTreeInterface> {
-    return await ApiHelper.getAnonymous("/lessons/public/tree", "LessonsApi");
-  }
-
-  /**
-   * Fetch the action tree for action selection (includes actions in each venue section)
-   */
-  async fetchActionTree(): Promise<LessonActionTreeInterface> {
-    return await ApiHelper.getAnonymous("/lessons/public/actionTree", "LessonsApi");
-  }
-
-  // ============================================
-  // Display List Methods (for preview/display without full actions)
-  // ============================================
-
-  /**
-   * Get the display list - hierarchical items suitable for preview
-   * Structure: headers -> sections (no actions expanded)
-   * This is the lightweight version for showing what a lesson contains
-   */
-  async getDisplayList(plan: PlanInterface): Promise<PlanItemInterface[]> {
-    const response = await this.fetchVenuePlanItems(plan);
-    return response?.items || [];
-  }
-
-  /**
-   * Get display list with sections only (strip actions from children)
-   * Use this when importing a lesson as editable plan items
-   */
-  async getSectionsOnlyList(plan: PlanInterface): Promise<PlanItemInterface[]> {
-    const response = await this.fetchVenuePlanItems(plan);
-    if (!response?.items) return [];
-
-    return response.items.map(item => ({
-      ...item,
-      children: item.children?.map(section => ({
-        ...section,
-        children: undefined // Remove actions from sections
-      }))
-    }));
-  }
-
-  // ============================================
-  // Expanded List Methods (with full actions)
-  // ============================================
-
-  /**
-   * Get the fully expanded list - items with all actions populated in sections
-   * Merges fetchVenuePlanItems with fetchVenueActions to get complete data
-   */
-  async getExpandedList(plan: PlanInterface): Promise<PlanItemInterface[]> {
-    const [planItemsResponse, actionsResponse] = await Promise.all([
-      this.fetchVenuePlanItems(plan),
-      this.fetchVenueActions(plan)
-    ]);
-
-    if (!planItemsResponse?.items) return [];
-
-    // Create a map of section ID -> actions
-    const sectionActionsMap = new Map<string, PlanItemInterface[]>();
-    if (actionsResponse?.sections) {
-      for (const section of actionsResponse.sections) {
-        if (section.id && section.actions) {
-          sectionActionsMap.set(section.id, section.actions.map(action => ({
-            itemType: "lessonAction",
-            relatedId: action.id,
-            label: action.name,
-            description: action.actionType,
-            seconds: action.seconds
-          })));
-        }
-      }
-    }
-
-    // Recursively expand sections with their actions
-    const expandItem = (item: PlanItemInterface): PlanItemInterface => {
-      if (!item.children) return item;
-
-      return {
-        ...item,
-        children: item.children.map(child => {
-          // If this is a section (has relatedId), try to get its actions
-          if (child.relatedId && sectionActionsMap.has(child.relatedId)) {
-            return {
-              ...child,
-              children: sectionActionsMap.get(child.relatedId)
-            };
-          }
-          // Otherwise recursively process
-          return expandItem(child);
-        })
-      };
-    };
-
-    return planItemsResponse.items.map(expandItem);
-  }
-
-  // ============================================
-  // Embed URL Helpers
-  // ============================================
-
-  /**
-   * Get embed URL for an action
-   */
-  getActionEmbedUrl(actionId: string, externalProviderId?: string): string {
-    if (externalProviderId) {
-      return `${this.lessonsUrl}/embed/external/${externalProviderId}/action/${actionId}`;
-    }
-    return `${this.lessonsUrl}/embed/action/${actionId}`;
-  }
-
-  /**
-   * Get embed URL for an add-on
-   */
-  getAddOnEmbedUrl(addOnId: string, externalProviderId?: string): string {
-    if (externalProviderId) {
-      return `${this.lessonsUrl}/embed/external/${externalProviderId}/addon/${addOnId}`;
-    }
-    return `${this.lessonsUrl}/embed/addon/${addOnId}`;
-  }
-
-  /**
-   * Get embed URL for a section
-   */
-  getSectionEmbedUrl(sectionId: string, externalProviderId?: string): string {
-    if (externalProviderId) {
-      return `${this.lessonsUrl}/embed/external/${externalProviderId}/section/${sectionId}`;
-    }
-    return `${this.lessonsUrl}/embed/section/${sectionId}`;
-  }
-
-  /**
-   * Get the external provider ID from a plan (if external)
-   */
-  getExternalProviderId(plan: PlanInterface): string | null {
-    const externalRef = this.getExternalRef(plan);
-    return externalRef?.externalProviderId || null;
-  }
-}

package/src/contentProviders/index.ts

@@ -1,2 +0,0 @@
-export type { ContentProviderInterface } from "./ContentProvider.js";
-export { LessonsContentProvider } from "./LessonsContentProvider.js";

package/src/index.ts

@@ -1,16 +0,0 @@
-export * from "./interfaces/index.js";
-export { ApiHelper } from "./ApiHelper.js";
-export { AppearanceHelper } from "./AppearanceHelper.js";
-export { ArrayHelper } from "./ArrayHelper.js";
-export { CommonEnvironmentHelper } from "./CommonEnvironmentHelper.js";
-export { CurrencyHelper } from "./CurrencyHelper.js";
-export { DateHelper } from "./DateHelper.js";
-export { DonationHelper } from "./DonationHelper.js";
-export { ErrorHelper } from "./ErrorHelper.js";
-export { EventHelper } from "./EventHelper.js";
-export { FileHelper } from "./FileHelper.js";
-export { PersonHelper } from "./PersonHelper.js";
-export { UserHelper } from "./UserHelper.js";
-export { UniqueIdHelper } from "./UniqueIdHelper.js";
-export { PlanHelper } from "./PlanHelper.js";
-export * from "./contentProviders/index.js";

package/src/interfaces/Access.ts

@@ -1,138 +0,0 @@
-import { PersonInterface } from "./Membership.js";
-
-export interface ApiInterface {
-  name: string;
-  keyName?: string;
-  permissions: RolePermissionInterface[];
-  jwt: string;
-}
-export interface ChurchInterface {
-  id?: string;
-  name?: string;
-  registrationDate?: Date;
-  address1?: string;
-  address2?: string;
-  city?: string;
-  state?: string;
-  zip?: string;
-  country?: string;
-  subDomain?: string;
-  settings?: GenericSettingInterface[];
-  archivedDate?: Date;
-}
-export interface DomainInterface {
-  id?: string;
-  domainName?: string;
-}
-export interface RegisterChurchRequestInterface extends ChurchInterface {
-  appName?: string;
-}
-export interface LoadCreateUserRequestInterface {
-  userEmail: string;
-  fromEmail?: string;
-  subject?: string;
-  body?: string;
-  firstName: string;
-  lastName: string;
-}
-export interface LoginResponseInterface {
-  user: UserInterface;
-  userChurches: LoginUserChurchInterface[];
-  errors: string[];
-}
-export interface LoginUserChurchInterface {
-  person: PersonInterface;
-  church: ChurchInterface;
-  apis: ApiInterface[];
-  jwt: string;
-  groups: { id: string; tags: string; name: string; leader: boolean }[];
-}
-
-export interface PermissionInterface {
-  apiName?: string;
-  section?: string;
-  action?: string;
-  displaySection?: string;
-  displayAction?: string;
-}
-export interface RegisterUserInterface {
-  firstName?: string;
-  lastName: string;
-  email?: string;
-  appName: string;
-  appUrl: string;
-}
-export interface RoleInterface {
-  id?: string;
-  churchId?: string;
-  name?: string;
-}
-export interface RolePermissionInterface {
-  id?: string;
-  churchId?: string;
-  roleId?: string;
-  apiName?: string;
-  contentType?: string;
-  contentId?: string;
-  action?: string;
-}
-export interface RoleMemberInterface {
-  id?: string;
-  churchId?: string;
-  roleId?: string;
-  userId?: string;
-  user?: UserInterface;
-  personId?: string;
-}
-export interface ResetPasswordRequestInterface {
-  userEmail: string;
-}
-export interface ResetPasswordResponseInterface {
-  emailed: boolean;
-}
-export interface UserInterface {
-  id?: string;
-  email?: string;
-  authGuid?: string;
-  firstName?: string;
-  lastName?: string;
-  registrationDate?: Date;
-  lastLogin?: Date;
-  password?: string;
-  jwt?: string;
-}
-export interface GenericSettingInterface {
-  id?: string;
-  churchId?: string;
-  keyName?: string;
-  value?: string;
-  public?: number;
-}
-export interface UserChurchInterface {
-  id?: string;
-  userId?: string;
-  churchId?: string;
-  personId?: string;
-}
-
-export interface ApiConfig {
-  keyName: string;
-  url: string;
-  jwt: string;
-  permissions: RolePermissionInterface[];
-}
-export type ApiListType =
-  | "MembershipApi"
-  | "AttendanceApi"
-  | "GivingApi"
-  | "DoingApi"
-  | "MessagingApi"
-  | "LessonsApi"
-  | "ReportingApi"
-  | "ContentApi"
-  | "AskApi";
-export interface IApiPermission {
-  api: string;
-  contentType: string;
-  action: string;
-}

package/src/interfaces/Attendance.ts

@@ -1,45 +0,0 @@
-import { CampusInterface, ServiceInterface, ServiceTimeInterface, PersonInterface } from "./index.js";
-
-export interface AttendanceInterface {
-  campus: CampusInterface;
-  service: ServiceInterface;
-  serviceTime: ServiceTimeInterface;
-  groupId: string;
-}
-export interface AttendanceRecordInterface {
-  serviceTime: ServiceTimeInterface;
-  service: ServiceInterface;
-  campus: CampusInterface;
-  week: number;
-  count: number;
-  visitDate: Date;
-  groupId: string;
-}
-export interface VisitInterface {
-  id?: string;
-  personId?: string;
-  serviceId?: string;
-  groupId?: string;
-  visitDate?: Date;
-  visitSessions?: VisitSessionInterface[];
-  person?: PersonInterface;
-}
-export interface VisitSessionInterface {
-  id?: string;
-  visitId?: string;
-  sessionId?: string;
-  visit?: VisitInterface;
-  session?: SessionInterface;
-}
-export interface SessionInterface {
-  id?: string;
-  groupId: string;
-  serviceTimeId: string;
-  sessionDate?: Date;
-  displayName: string;
-}
-export interface SettingInterface {
-  id?: string;
-  keyName?: string;
-  value?: string;
-}

package/src/interfaces/Content.ts

@@ -1,84 +0,0 @@
-export interface LinkInterface {
-  id?: string;
-  churchId?: string;
-  url?: string;
-  text?: string;
-  sort?: number;
-  linkType: string;
-  linkData: string;
-  icon: string;
-  category: string;
-  parentId?: string;
-  children?: any;
-}
-export interface SermonInterface {
-  id?: string;
-  churchId?: string;
-  playlistId?: string;
-  videoType?: string;
-  videoData?: string;
-  videoUrl?: string;
-  title?: string;
-  description?: string;
-  publishDate?: Date;
-  thumbnail?: string;
-  duration?: number;
-  permanentUrl?: boolean;
-}
-export interface PlaylistInterface {
-  id?: string;
-  churchId?: string;
-  title?: string;
-  description?: string;
-  publishDate?: Date;
-  thumbnail?: string;
-}
-export interface StreamingServiceInterface {
-  id?: string;
-  churchId?: string;
-  serviceTime?: Date;
-  earlyStart?: number;
-  duration: number;
-  chatBefore: number;
-  chatAfter: number;
-  provider: string;
-  providerKey: string;
-  videoUrl: string;
-  timezoneOffset: number;
-  recurring: boolean;
-  label: string;
-  sermonId?: string;
-}
-export interface EventInterface {
-  id?: string;
-  churchId?: string;
-  groupId?: string;
-  start?: Date;
-  end?: Date;
-  title?: string;
-  description?: string;
-  allDay?: boolean;
-  visibility?: string;
-  recurrenceRule?: string;
-  exceptionDates?: Date[];
-}
-export interface EventExceptionInterface {
-  id?: string;
-  churchId?: string;
-  eventId?: string;
-  exceptionDate?: Date;
-}
-export interface CuratedCalendarInterface {
-  id?: string;
-  churchId?: string;
-  name?: string;
-}
-export interface CuratedEventInterface {
-  id?: string;
-  churchId?: string;
-  curratedCalendarId?: string;
-  groupId?: string;
-  eventId?: string;
-}
-export interface CuratedEventWithEventInterface extends EventInterface, CuratedEventInterface {}
-export type VisibilityOptions = "public" | "private" | "hidden";