@churchapps/helpers 1.2.3 → 1.2.5

package/src/interfaces/Permissions.ts

@@ -1,92 +1,92 @@
-export class Permissions {
-  static attendanceApi = {
-    attendance: {
-      view: { api: "AttendanceApi", contentType: "Attendance", action: "View" },
-      viewSummary: {
-        api: "AttendanceApi",
-        contentType: "Attendance",
-        action: "View Summary"
-      },
-      edit: { api: "AttendanceApi", contentType: "Attendance", action: "Edit" }
-    },
-    services: {
-      edit: { api: "AttendanceApi", contentType: "Services", action: "Edit" }
-    }
-  };
-
-  static membershipApi = {
-    roles: {
-      view: { api: "MembershipApi", contentType: "Roles", action: "View" },
-      edit: { api: "MembershipApi", contentType: "Roles", action: "Edit" }
-    },
-    settings: {
-      edit: { api: "MembershipApi", contentType: "Settings", action: "Edit" }
-    },
-    server: {
-      admin: { api: "MembershipApi", contentType: "Server", action: "Admin" }
-    },
-    forms: {
-      admin: { api: "MembershipApi", contentType: "Forms", action: "Admin" },
-      edit: { api: "MembershipApi", contentType: "Forms", action: "Edit" }
-    },
-    groups: {
-      edit: { api: "MembershipApi", contentType: "Groups", action: "Edit" }
-    },
-    people: {
-      view: { api: "MembershipApi", contentType: "People", action: "View" },
-      viewMembers: {
-        api: "MembershipApi",
-        contentType: "People",
-        action: "View Members"
-      },
-      edit: { api: "MembershipApi", contentType: "People", action: "Edit" }
-    },
-    plans: {
-      edit: { api: "MembershipApi", contentType: "Plans", action: "Edit" }
-    },
-    groupMembers: {
-      edit: {
-        api: "MembershipApi",
-        contentType: "Group Members",
-        action: "Edit"
-      },
-      view: {
-        api: "MembershipApi",
-        contentType: "Group Members",
-        action: "View"
-      }
-    }
-  };
-
-  static givingApi = {
-    donations: {
-      viewSummary: {
-        api: "GivingApi",
-        contentType: "Donations",
-        action: "View Summary"
-      },
-      view: { api: "GivingApi", contentType: "Donations", action: "View" },
-      edit: { api: "GivingApi", contentType: "Donations", action: "Edit" }
-    },
-    settings: {
-      view: { api: "GivingApi", contentType: "Settings", action: "View" },
-      edit: { api: "GivingApi", contentType: "Settings", action: "Edit" }
-    }
-  };
-
-  static contentApi = {
-    chat: {
-      host: { api: "ContentApi", contentType: "Chat", action: "Host" }
-    },
-    content: {
-      edit: { api: "ContentApi", contentType: "Content", action: "Edit" }
-    },
-    streamingServices: {
-      edit: {
-        api: "ContentApi",
-        contentType: "StreamingServices",
-        action: "Edit"
-      }
-    }
-  };
-}
+export class Permissions {
+  static attendanceApi = {
+    attendance: {
+      view: { api: "AttendanceApi", contentType: "Attendance", action: "View" },
+      viewSummary: {
+        api: "AttendanceApi",
+        contentType: "Attendance",
+        action: "View Summary"
+      },
+      edit: { api: "AttendanceApi", contentType: "Attendance", action: "Edit" }
+    },
+    services: {
+      edit: { api: "AttendanceApi", contentType: "Services", action: "Edit" }
+    }
+  };
+
+  static membershipApi = {
+    roles: {
+      view: { api: "MembershipApi", contentType: "Roles", action: "View" },
+      edit: { api: "MembershipApi", contentType: "Roles", action: "Edit" }
+    },
+    settings: {
+      edit: { api: "MembershipApi", contentType: "Settings", action: "Edit" }
+    },
+    server: {
+      admin: { api: "MembershipApi", contentType: "Server", action: "Admin" }
+    },
+    forms: {
+      admin: { api: "MembershipApi", contentType: "Forms", action: "Admin" },
+      edit: { api: "MembershipApi", contentType: "Forms", action: "Edit" }
+    },
+    groups: {
+      edit: { api: "MembershipApi", contentType: "Groups", action: "Edit" }
+    },
+    people: {
+      view: { api: "MembershipApi", contentType: "People", action: "View" },
+      viewMembers: {
+        api: "MembershipApi",
+        contentType: "People",
+        action: "View Members"
+      },
+      edit: { api: "MembershipApi", contentType: "People", action: "Edit" }
+    },
+    plans: {
+      edit: { api: "MembershipApi", contentType: "Plans", action: "Edit" }
+    },
+    groupMembers: {
+      edit: {
+        api: "MembershipApi",
+        contentType: "Group Members",
+        action: "Edit"
+      },
+      view: {
+        api: "MembershipApi",
+        contentType: "Group Members",
+        action: "View"
+      }
+    }
+  };
+
+  static givingApi = {
+    donations: {
+      viewSummary: {
+        api: "GivingApi",
+        contentType: "Donations",
+        action: "View Summary"
+      },
+      view: { api: "GivingApi", contentType: "Donations", action: "View" },
+      edit: { api: "GivingApi", contentType: "Donations", action: "Edit" }
+    },
+    settings: {
+      view: { api: "GivingApi", contentType: "Settings", action: "View" },
+      edit: { api: "GivingApi", contentType: "Settings", action: "Edit" }
+    }
+  };
+
+  static contentApi = {
+    chat: {
+      host: { api: "ContentApi", contentType: "Chat", action: "Host" }
+    },
+    content: {
+      edit: { api: "ContentApi", contentType: "Content", action: "Edit" }
+    },
+    streamingServices: {
+      edit: {
+        api: "ContentApi",
+        contentType: "StreamingServices",
+        action: "Edit"
+      }
+    }
+  };
+}

package/src/interfaces/Reporting.ts

@@ -1,41 +1,41 @@
-export interface ReportResultInterface {
-  displayName: string;
-  description: string;
-  table: any[];
-  outputs: ReportOutputInterface[];
-}
-export interface ReportInterface {
-  keyName: string;
-  displayName: string;
-  description: string;
-  parameters: ParameterInterface[];
-  permissions: ReportPermissionGroupInterface[];
-}
-export interface ParameterInterface {
-  keyName: string;
-  displayName?: string;
-  source: string;
-  sourceKey: string;
-  options: { value: string; text: string }[];
-  value?: string;
-  requiredParentIds?: string[];
-  defaultValue: string;
-}
-export interface ReportOutputInterface {
-  outputType: string;
-  columns: ColumnInterface[];
-  groupings?: number[];
-}
-export interface ColumnInterface {
-  header: string;
-  value: string;
-  formatter: string;
-}
-export interface ReportPermissionGroupInterface {
-  requireOne: ReportPermissionInterface[];
-}
-export interface ReportPermissionInterface {
-  api: string;
-  contentType: string;
-  action: string;
-}
+export interface ReportResultInterface {
+  displayName: string;
+  description: string;
+  table: any[];
+  outputs: ReportOutputInterface[];
+}
+export interface ReportInterface {
+  keyName: string;
+  displayName: string;
+  description: string;
+  parameters: ParameterInterface[];
+  permissions: ReportPermissionGroupInterface[];
+}
+export interface ParameterInterface {
+  keyName: string;
+  displayName?: string;
+  source: string;
+  sourceKey: string;
+  options: { value: string; text: string }[];
+  value?: string;
+  requiredParentIds?: string[];
+  defaultValue: string;
+}
+export interface ReportOutputInterface {
+  outputType: string;
+  columns: ColumnInterface[];
+  groupings?: number[];
+}
+export interface ColumnInterface {
+  header: string;
+  value: string;
+  formatter: string;
+}
+export interface ReportPermissionGroupInterface {
+  requireOne: ReportPermissionInterface[];
+}
+export interface ReportPermissionInterface {
+  api: string;
+  contentType: string;
+  action: string;
+}

package/src/interfaces/UserContextInterface.ts

@@ -1,13 +1,13 @@
-import { LoginUserChurchInterface, UserInterface } from "./Access";
-import { PersonInterface } from "./Membership";
-
-export interface UserContextInterface {
-  user: UserInterface;
-  setUser: (user: UserInterface) => void;
-  person: PersonInterface;
-  setPerson: (person: PersonInterface) => void;
-  userChurch: LoginUserChurchInterface;
-  setUserChurch: (userChurch: LoginUserChurchInterface) => void;
-  userChurches: LoginUserChurchInterface[];
-  setUserChurches: (userChurches: LoginUserChurchInterface[]) => void;
-}
+import { LoginUserChurchInterface, UserInterface } from "./Access";
+import { PersonInterface } from "./Membership";
+
+export interface UserContextInterface {
+  user: UserInterface;
+  setUser: (user: UserInterface) => void;
+  person: PersonInterface;
+  setPerson: (person: PersonInterface) => void;
+  userChurch: LoginUserChurchInterface;
+  setUserChurch: (userChurch: LoginUserChurchInterface) => void;
+  userChurches: LoginUserChurchInterface[];
+  setUserChurches: (userChurches: LoginUserChurchInterface[]) => void;
+}

package/src/interfaces/index.ts

@@ -1,13 +1,13 @@
-export * from "./Error";
-export * from "./UserContextInterface";
-export * from "./Permissions";
-
-// API interfaces
-export * from "./Access";
-export * from "./Attendance";
-export * from "./Content";
-export * from "./Doing";
-export * from "./Donation";
-export * from "./Membership";
-export * from "./Messaging";
-export * from "./Reporting";
+export * from "./Error";
+export * from "./UserContextInterface";
+export * from "./Permissions";
+
+// API interfaces
+export * from "./Access";
+export * from "./Attendance";
+export * from "./Content";
+export * from "./Doing";
+export * from "./Donation";
+export * from "./Membership";
+export * from "./Messaging";
+export * from "./Reporting";

package/tsconfig.json

@@ -1,36 +1,36 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "typeRoots": [
-      "./types",
-      "node_modules/@types"
-    ],
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "ES2022"
-    ],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": false,
-    "forceConsistentCasingInFileNames": true,
-    "module": "commonjs",
-    "moduleResolution": "node",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "sourceMap": true,
-    "allowUnreachableCode": false,
-    "allowUnusedLabels": false,
-    "declaration": true,
-    "declarationMap": true,
-    "noImplicitReturns": true,
-    "pretty": true,
-    "paths": {},
-    "outDir": "dist"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "typeRoots": [
+      "./types",
+      "node_modules/@types"
+    ],
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "ES2022"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": false,
+    "forceConsistentCasingInFileNames": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "sourceMap": true,
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    "declaration": true,
+    "declarationMap": true,
+    "noImplicitReturns": true,
+    "pretty": true,
+    "paths": {},
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/CLAUDE.md

@@ -1,98 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is the `@churchapps/helpers` package - a foundational TypeScript library providing framework-agnostic utilities, interfaces, and helper classes for ChurchApps church management applications. It serves as the core dependency for other ChurchApps packages (ApiHelper, AppHelper, MobileHelper).
-
-## Development Commands
-
-**This project uses Yarn exclusively. npm is disabled to prevent script execution vulnerabilities.**
-
-```bash
-yarn clean      # Remove dist folder
-yarn tsc        # TypeScript compilation only
-yarn build      # Full build (clean + tsc)
-yarn lint       # ESLint check
-yarn lint:fix   # ESLint with auto-fix
-yarn format     # Prettier formatting
-```
-
-## Local Development Workflow
-
-```bash
-# After making changes:
-yarn build
-yarn link
-
-# In consuming project:
-yarn link @churchapps/helpers
-
-# After further changes, repeat build + link cycle
-```
-
-## Publishing
-
-```bash
-# 1. Update version in package.json
-# 2. Build and publish:
-yarn build
-yarn publish --access=public
-```
-
-## Security Notes
-
-- Script execution is disabled by default in `.yarnrc.yml`
-- Only whitelisted packages can run install scripts
-- npm is disabled via `.npmrc` with `engine-strict=true`
-
-## Architecture
-
-### Core Structure
-
-The package follows a static utility class pattern with comprehensive TypeScript interfaces:
-
-- **Helper Classes**: Static utility classes (`ApiHelper`, `DateHelper`, `ArrayHelper`, etc.)
-- **Interfaces**: Church management domain models organized by feature area
-- **Zero Runtime Dependencies**: Framework-agnostic with minimal external deps
-
-### Key Helper Categories
-
-1. **ApiHelper**: Multi-API HTTP client with JWT auth for ChurchApps microservices
-2. **Data Helpers**: Array manipulation, date/time processing, currency formatting
-3. **User Management**: Multi-church user sessions, permissions, person data
-4. **Business Logic**: Donation processing, file uploads, appearance theming
-5. **System Utilities**: Error handling, environment config, unique ID generation
-
-### Interface Organization
-
-Interfaces in `src/interfaces/` are grouped by domain:
-- **Access**: Authentication, users, churches, roles, permissions
-- **Membership**: People, groups, households, forms, campus management  
-- **Content**: Sermons, playlists, streaming, events
-- **Donation**: Financial transactions, Stripe integration
-- **Attendance**: Service tracking
-- **Messaging**: Communication interfaces
-- **Reporting**: Data analysis interfaces
-
-### TypeScript Configuration
-
-- Target: ES2020 with CommonJS modules
-- Declaration files generated (`.d.ts`)
-- Strict mode disabled for flexibility
-- Supports React JSX and DOM types
-
-### Key Dependencies
-
-- `date-fns` & `dayjs`: Date manipulation
-- `rrule`: Recurring event rules
-- `react-ga4`: Analytics (peer dependency pattern)
-
-## Important Patterns
-
-- **Multi-tenancy**: Most entities include `churchId` for church-scoped data
-- **Optional Properties**: Extensive use for flexible partial updates
-- **Static Methods**: All helpers use static methods for stateless operations
-- **Error Resilience**: Comprehensive error handling with graceful degradation
-- **Environment Flexibility**: Works across React, Next.js, React Native platforms