@churchapps/apphelper 0.11.0 → 0.13.0

package/dist/donations/providers/registry.d.ts

@@ -0,0 +1,6 @@
+import type { PaymentProvider } from "./types";
+export declare function registerPaymentProvider(provider: PaymentProvider): void;
+export declare function getPaymentProvider(provider: string | undefined | null): PaymentProvider;
+export declare function hasPaymentProvider(provider: string | undefined | null): boolean;
+export declare function listPaymentProviders(): PaymentProvider[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/donations/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/donations/providers/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiB/C,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEvE;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,eAAe,CAIvF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAG/E;AAED,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD"}

package/dist/donations/providers/registry.js

@@ -0,0 +1,36 @@
+import { DonationHelper } from "../helpers";
+import { StripeProvider } from "./StripeProvider";
+import { KingdomFundingProvider } from "./KingdomFundingProvider";
+import { PayPalProvider } from "./PayPalProvider";
+// Built-ins are referenced directly (not registered via a module side-effect),
+// so bundlers can't tree-shake the registration away. Built lazily on first
+// access so the providers/components import cycle is fully resolved by call time.
+const custom = new Map();
+let builtins = null;
+function getBuiltins() {
+    if (!builtins) {
+        builtins = new Map();
+        for (const p of [StripeProvider, KingdomFundingProvider, PayPalProvider])
+            builtins.set(p.key, p);
+    }
+    return builtins;
+}
+// Register an additional provider at runtime (e.g. a host app's custom gateway).
+export function registerPaymentProvider(provider) {
+    custom.set(provider.key, provider);
+}
+// Resolves by normalized provider name. Falls back to Stripe so an unknown or
+// misconfigured provider never hard-crashes the donor form.
+export function getPaymentProvider(provider) {
+    const key = DonationHelper.normalizeProvider(provider || "");
+    const all = getBuiltins();
+    return custom.get(key) ?? all.get(key) ?? all.get("stripe");
+}
+export function hasPaymentProvider(provider) {
+    const key = DonationHelper.normalizeProvider(provider || "");
+    return custom.has(key) || getBuiltins().has(key);
+}
+export function listPaymentProviders() {
+    return [...getBuiltins().values(), ...custom.values()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/donations/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/donations/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,+EAA+E;AAC/E,4EAA4E;AAC5E,kFAAkF;AAClF,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;AAClD,IAAI,QAAQ,GAAwC,IAAI,CAAC;AAEzD,SAAS,WAAW;IAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,sBAAsB,EAAE,cAAc,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,QAAmC;IACpE,MAAM,GAAG,GAAG,cAAc,CAAC,iBAAiB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAmC;IACpE,MAAM,GAAG,GAAG,cAAc,CAAC,iBAAiB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/donations/providers/types.d.ts

@@ -0,0 +1,113 @@
+import type { ReactNode, FC, ForwardRefExoticComponent, RefAttributes } from "react";
+import type { Stripe } from "@stripe/stripe-js";
+import type { PaymentGateway } from "../helpers";
+import type { PaperProps } from "@mui/material/Paper";
+export interface PaymentToken {
+    id: string;
+    type: "card" | "bank" | "paypal";
+    saved?: boolean;
+    brand?: string;
+    last4?: string;
+    expMonth?: string;
+    expYear?: string;
+}
+export interface ChargeContext {
+    provider: string;
+    gatewayId?: string;
+    churchId: string;
+    amount: number;
+    funds: {
+        id: string;
+        amount: number;
+    }[];
+    person: {
+        id: string;
+        email: string;
+        name: string;
+    };
+    notes?: string;
+    church: {
+        name: string;
+        subDomain: string;
+        churchURL: string;
+        logo: string;
+    };
+    recurring: boolean;
+    interval?: {
+        interval_count: number;
+        interval: string;
+    };
+    billingCycleAnchor?: number;
+    saveCard?: boolean;
+    customerId?: string;
+    currency?: string;
+}
+export interface ChargeRequest {
+    endpoint: "/donate/charge" | "/donate/subscribe";
+    body: any;
+}
+export interface FinalizeResult {
+    result: any;
+    requiresAction?: boolean;
+    success?: boolean;
+    error?: string;
+}
+export interface ProviderCapabilities {
+    savedCard: boolean;
+    savedBank: boolean;
+    guestAch: boolean;
+    memberNewCard: boolean;
+    recurring: boolean;
+    editRecurring: boolean;
+}
+export interface ProviderDescriptor {
+    adminValue: string;
+    label: string;
+    keyLabels: {
+        public: string;
+        private: string;
+        webhook?: string;
+    };
+    feeFields: ("card" | "ach" | "paypal" | "kf")[];
+    currencies: string[] | "all";
+    selectableInAdmin: boolean;
+    betaOnly?: boolean;
+    setupInstructionsKey?: string;
+    signupUrl?: (church: any, user: any) => string;
+}
+export interface MemberEntryHandle {
+    tokenize(): Promise<PaymentToken>;
+}
+export interface MemberEntryProps {
+    gateway: PaymentGateway;
+    getContext?: () => ChargeContext;
+}
+export interface GuestFormProps {
+    churchId: string;
+    gateway: PaymentGateway;
+    recaptchaSiteKey: string;
+    mainContainerCssProps?: PaperProps;
+    showHeader?: boolean;
+    churchLogo?: string;
+    allowSingleGift?: boolean;
+    allowRecurring?: boolean;
+    showFundSelector?: boolean;
+    allowedFundIds?: string[];
+    defaultFundId?: string;
+}
+export interface PaymentProvider {
+    readonly key: string;
+    readonly descriptor: ProviderDescriptor;
+    readonly capabilities: ProviderCapabilities;
+    MemberWrapper?: FC<{
+        stripePromise?: Promise<Stripe | null> | null;
+        children: ReactNode;
+    }>;
+    MemberEntry?: ForwardRefExoticComponent<MemberEntryProps & RefAttributes<MemberEntryHandle>>;
+    buildChargeRequest(ctx: ChargeContext, token: PaymentToken): ChargeRequest;
+    finalizeResult?(result: any, deps: {
+        stripe?: Stripe | null;
+    }): Promise<FinalizeResult>;
+    GuestForm: FC<GuestFormProps>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/donations/providers/types.d.ts.map

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

package/dist/donations/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/donations/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/donations/providers/types.ts"],"names":[],"mappings":""}

package/dist/public/locales/en.json

@@ -132,6 +132,30 @@
 			"notFound": "Payment method not found.",
 			"paymentMethod": "Payment Method",
 			"startDate": "Start Date"
+		},
+		"kingdomFunding": {
+			"providerName": "Kingdom Funding",
+			"loadingPaymentForm": "Loading payment form...",
+			"paymentFormNotAvailable": "Payment form not available",
+			"paymentFormNotInitialized": "Payment form not initialized",
+			"failedToInitPaymentForm": "Failed to initialize payment form",
+			"failedToLoadPaymentForm": "Failed to load payment form",
+			"failedToTokenizeCard": "Failed to tokenize card",
+			"missingTokenizationKey": "Missing tokenization key",
+			"failedToProcessCard": "Failed to process card. Please check your card details and try again.",
+			"unexpectedError": "An unexpected error occurred. Please try again.",
+			"errorProcessingDonation": "Error processing donation",
+			"enterBankDetails": "Enter your bank account details",
+			"enterCardDetails": "Enter card details",
+			"gatewayConfigMissing": "Payment form not available. Gateway configuration missing.",
+			"paymentProvider": "Payment Provider",
+			"memo": "Memo (optional)",
+			"validate": {
+				"routingNumber": "Please enter a valid routing number",
+				"accountNumber": "Please enter a valid account number",
+				"captchaRequired": "Please complete the reCAPTCHA verification",
+				"captchaFailed": "reCAPTCHA verification failed. Please try again."
+			}
 		}
 	},
 	"fileUpload": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@churchapps/apphelper",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Library of helper functions, components, and feature modules (donations/forms/login/markdown/website) for React and NextJS ChurchApps",
   "type": "module",
   "main": "dist/index.js",