@actschurch/ccms-sdk 0.0.8 → 0.0.10

package/dist/services/vendors/VendorShopService.js

@@ -74,6 +74,22 @@ export class VendorShopService extends BaseService {
         const url = this.buildUrl(endpoint);
         return this.http.get(url);
     }
+    /**
+     * Get all confirmed vendors for a specific event
+     * GET /api/shop/events/{eventId}/vendors
+     */
+    async getVendorsForEvent(eventId) {
+        const response = await this.getVendorsForEventRaw(eventId);
+        return response.data ?? [];
+    }
+    /**
+     * Get vendors for event (raw response)
+     */
+    getVendorsForEventRaw(eventId) {
+        const endpoint = this.getEndpoint('vendors-for-event', `events/${eventId}/vendors`);
+        const url = this.buildUrl(endpoint);
+        return this.http.get(url);
+    }
     /**
      * Get active vendors filtered by type
      * GET /api/shop/vendors/by-type/{typeId}

package/dist/services/vendors/VendorShopService.js.map

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

package/dist/utils/PayFastCheckout.d.ts

@@ -0,0 +1,99 @@
+/**
+ * PayFastCheckout
+ * Framework-agnostic utility for handling PayFast payment redirects.
+ * Supports three redirect strategies: auto, form, and manual.
+ *
+ * Works in any browser environment (React, Vue, Angular, vanilla JS).
+ * For React-specific usage with state management, see usePayFastCheckout hook.
+ */
+import { PayFastPaymentResponse, PayFastPaymentReference, PayFastRedirectMode, PayFastPaymentType, PayFastPaymentRequest } from '../models/payments';
+import { PayFastPaymentService } from '../services/payments/PayFastPaymentService';
+/**
+ * Options for the checkout method.
+ */
+export interface PayFastCheckoutOptions {
+    /**
+     * Redirect strategy.
+     * - `'auto'`   — Injects the server-generated redirectHtml into the page (immediate redirect).
+     * - `'form'`   — Builds a hidden form from payFastFormData and submits it (allows pre-redirect logic).
+     * - `'manual'` — No redirect; returns the reference for the caller to handle.
+     *
+     * @default 'auto'
+     */
+    mode?: PayFastRedirectMode;
+    /**
+     * DOM element to inject the auto-redirect HTML into.
+     * Only used when mode is `'auto'`.
+     * Defaults to `document.body`.
+     */
+    container?: HTMLElement;
+    /**
+     * Target attribute for the hidden form submission.
+     * Only used when mode is `'form'`.
+     * Use `'_blank'` to open PayFast in a new tab.
+     * @default '_self'
+     */
+    formTarget?: string;
+    /**
+     * Callback invoked with the PayFastPaymentReference before the redirect happens.
+     * Useful for persisting the transactionID/paymentId to local storage or state.
+     * Only called for `'auto'` and `'form'` modes (manual mode returns the reference directly).
+     */
+    onBeforeRedirect?: (reference: PayFastPaymentReference) => void | Promise<void>;
+}
+/**
+ * Extract a PayFastPaymentReference from a PayFastPaymentResponse.
+ */
+export declare function toPayFastReference(response: PayFastPaymentResponse): PayFastPaymentReference;
+/**
+ * PayFastCheckout — static utility class for PayFast payment redirects.
+ *
+ * @example
+ * // Auto-redirect (simplest)
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'give');
+ *
+ * // Form redirect with pre-redirect callback
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'purchase', {
+ *   mode: 'form',
+ *   onBeforeRedirect: (ref) => localStorage.setItem('txn', ref.transactionID),
+ * });
+ *
+ * // Manual — no redirect, full control
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'donate', { mode: 'manual' });
+ * // ref.response.payFastProcessUrl, ref.response.payFastFormData available
+ *
+ * // Or redirect an existing response
+ * PayFastCheckout.redirect(existingResponse, { mode: 'form' });
+ */
+export declare class PayFastCheckout {
+    /**
+     * Full checkout flow: call the payment service, then redirect based on mode.
+     *
+     * @param service  - PayFastPaymentService instance
+     * @param request  - Payment request data
+     * @param type     - Payment type shorthand (maps to the service method)
+     * @param options  - Checkout options (mode, callbacks, etc.)
+     * @returns The payment reference (always returned, even for auto/form modes before redirect)
+     */
+    static checkout(service: PayFastPaymentService, request: PayFastPaymentRequest, type?: PayFastPaymentType, options?: PayFastCheckoutOptions): Promise<PayFastPaymentReference>;
+    /**
+     * Redirect the user to PayFast using an existing response.
+     * Use this when you already have a PayFastPaymentResponse and just need to handle the redirect.
+     */
+    static redirect(response: PayFastPaymentResponse, options?: PayFastCheckoutOptions): Promise<PayFastPaymentReference>;
+    /**
+     * Auto-redirect by injecting the server-generated HTML form into the DOM.
+     * The HTML contains a self-submitting form that redirects immediately.
+     */
+    static autoRedirect(response: PayFastPaymentResponse, container?: HTMLElement): void;
+    /**
+     * Form-redirect by programmatically creating a hidden form and submitting it.
+     * Gives the caller a chance to run pre-redirect logic (via onBeforeRedirect).
+     */
+    static formRedirect(response: PayFastPaymentResponse, target?: string): void;
+    /**
+     * Call the appropriate PayFastPaymentService method based on payment type.
+     */
+    private static callService;
+}
+//# sourceMappingURL=PayFastCheckout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PayFastCheckout.d.ts","sourceRoot":"","sources":["../../src/utils/PayFastCheckout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,uBAAuB,CAO5F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;OAQG;WACU,QAAQ,CACnB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE,kBAA+B,EACrC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IAOnC;;;OAGG;WACU,QAAQ,CACnB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IAuBnC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,sBAAsB,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI;IAwBpF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,sBAAsB,EAAE,MAAM,GAAE,MAAgB,GAAG,IAAI;IA4BrF;;OAEG;mBACkB,WAAW;CAsBjC"}

package/dist/utils/PayFastCheckout.js

@@ -0,0 +1,154 @@
+/**
+ * PayFastCheckout
+ * Framework-agnostic utility for handling PayFast payment redirects.
+ * Supports three redirect strategies: auto, form, and manual.
+ *
+ * Works in any browser environment (React, Vue, Angular, vanilla JS).
+ * For React-specific usage with state management, see usePayFastCheckout hook.
+ */
+/**
+ * Extract a PayFastPaymentReference from a PayFastPaymentResponse.
+ */
+export function toPayFastReference(response) {
+    return {
+        transactionID: response.transactionID,
+        paymentId: response.paymentId,
+        isSandbox: response.isSandbox,
+        response,
+    };
+}
+/**
+ * PayFastCheckout — static utility class for PayFast payment redirects.
+ *
+ * @example
+ * // Auto-redirect (simplest)
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'give');
+ *
+ * // Form redirect with pre-redirect callback
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'purchase', {
+ *   mode: 'form',
+ *   onBeforeRedirect: (ref) => localStorage.setItem('txn', ref.transactionID),
+ * });
+ *
+ * // Manual — no redirect, full control
+ * const ref = await PayFastCheckout.checkout(payFastService, request, 'donate', { mode: 'manual' });
+ * // ref.response.payFastProcessUrl, ref.response.payFastFormData available
+ *
+ * // Or redirect an existing response
+ * PayFastCheckout.redirect(existingResponse, { mode: 'form' });
+ */
+export class PayFastCheckout {
+    /**
+     * Full checkout flow: call the payment service, then redirect based on mode.
+     *
+     * @param service  - PayFastPaymentService instance
+     * @param request  - Payment request data
+     * @param type     - Payment type shorthand (maps to the service method)
+     * @param options  - Checkout options (mode, callbacks, etc.)
+     * @returns The payment reference (always returned, even for auto/form modes before redirect)
+     */
+    static async checkout(service, request, type = 'initiate', options = {}) {
+        const response = await PayFastCheckout.callService(service, request, type);
+        const reference = toPayFastReference(response);
+        await PayFastCheckout.redirect(response, options);
+        return reference;
+    }
+    /**
+     * Redirect the user to PayFast using an existing response.
+     * Use this when you already have a PayFastPaymentResponse and just need to handle the redirect.
+     */
+    static async redirect(response, options = {}) {
+        const { mode = 'auto' } = options;
+        const reference = toPayFastReference(response);
+        if (options.onBeforeRedirect && mode !== 'manual') {
+            await options.onBeforeRedirect(reference);
+        }
+        switch (mode) {
+            case 'auto':
+                PayFastCheckout.autoRedirect(response, options.container);
+                break;
+            case 'form':
+                PayFastCheckout.formRedirect(response, options.formTarget);
+                break;
+            case 'manual':
+                // No redirect — caller handles it
+                break;
+        }
+        return reference;
+    }
+    /**
+     * Auto-redirect by injecting the server-generated HTML form into the DOM.
+     * The HTML contains a self-submitting form that redirects immediately.
+     */
+    static autoRedirect(response, container) {
+        if (typeof document === 'undefined') {
+            throw new Error('PayFastCheckout.autoRedirect requires a browser environment (document is not defined).');
+        }
+        const target = container ?? document.body;
+        const div = document.createElement('div');
+        div.innerHTML = response.redirectHtml;
+        target.appendChild(div);
+        // The redirectHtml contains a self-submitting form with a <script> tag.
+        // Re-execute any scripts inside the injected HTML since innerHTML doesn't run scripts.
+        const scripts = div.querySelectorAll('script');
+        scripts.forEach((oldScript) => {
+            const newScript = document.createElement('script');
+            if (oldScript.src) {
+                newScript.src = oldScript.src;
+            }
+            else {
+                newScript.textContent = oldScript.textContent;
+            }
+            oldScript.parentNode?.replaceChild(newScript, oldScript);
+        });
+    }
+    /**
+     * Form-redirect by programmatically creating a hidden form and submitting it.
+     * Gives the caller a chance to run pre-redirect logic (via onBeforeRedirect).
+     */
+    static formRedirect(response, target = '_self') {
+        if (typeof document === 'undefined') {
+            throw new Error('PayFastCheckout.formRedirect requires a browser environment (document is not defined).');
+        }
+        const form = document.createElement('form');
+        form.method = 'POST';
+        form.action = response.payFastProcessUrl;
+        form.target = target;
+        form.style.display = 'none';
+        for (const [key, value] of Object.entries(response.payFastFormData)) {
+            const input = document.createElement('input');
+            input.type = 'hidden';
+            input.name = key;
+            input.value = value;
+            form.appendChild(input);
+        }
+        document.body.appendChild(form);
+        form.submit();
+        // Clean up the form after submission
+        setTimeout(() => {
+            document.body.removeChild(form);
+        }, 100);
+    }
+    /**
+     * Call the appropriate PayFastPaymentService method based on payment type.
+     */
+    static async callService(service, request, type) {
+        switch (type) {
+            case 'initiate':
+                return service.initiate(request);
+            case 'give':
+                return service.give(request);
+            case 'purchase':
+                return service.purchase(request);
+            case 'donate':
+                return service.donate(request);
+            case 'service':
+                return service.service(request);
+            case 'vendor':
+                return service.vendor(request);
+            default:
+                throw new Error(`Unknown payment type: ${type}`);
+        }
+    }
+}
+//# sourceMappingURL=PayFastCheckout.js.map

package/dist/utils/PayFastCheckout.js.map

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

package/dist/utils/index.d.ts

@@ -20,4 +20,5 @@ export * from './error';
 export * from './device';
 export * from './api';
 export * from './hooks';
+export * from './PayFastCheckout';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAG7B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAG7B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -37,4 +37,6 @@ export * from './device';
 export * from './api';
 // React hooks utilities
 export * from './hooks';
+// PayFast checkout utilities
+export * from './PayFastCheckout';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,0BAA0B;AAC1B,cAAc,SAAS,CAAC;AAExB,wBAAwB;AACxB,cAAc,UAAU,CAAC;AAEzB,wCAAwC;AACxC,cAAc,WAAW,CAAC;AAE1B,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,cAAc,YAAY,CAAC;AAE3B,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,uBAAuB;AACvB,cAAc,cAAc,CAAC;AAE7B,wBAAwB;AACxB,cAAc,OAAO,CAAC;AAEtB,2BAA2B;AAC3B,cAAc,SAAS,CAAC;AAExB,4BAA4B;AAC5B,cAAc,UAAU,CAAC;AAEzB,uBAAuB;AACvB,cAAc,OAAO,CAAC;AAEtB,wBAAwB;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,0BAA0B;AAC1B,cAAc,SAAS,CAAC;AAExB,wBAAwB;AACxB,cAAc,UAAU,CAAC;AAEzB,wCAAwC;AACxC,cAAc,WAAW,CAAC;AAE1B,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,cAAc,YAAY,CAAC;AAE3B,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,uBAAuB;AACvB,cAAc,cAAc,CAAC;AAE7B,wBAAwB;AACxB,cAAc,OAAO,CAAC;AAEtB,2BAA2B;AAC3B,cAAc,SAAS,CAAC;AAExB,4BAA4B;AAC5B,cAAc,UAAU,CAAC;AAEzB,uBAAuB;AACvB,cAAc,OAAO,CAAC;AAEtB,wBAAwB;AACxB,cAAc,SAAS,CAAC;AAExB,6BAA6B;AAC7B,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actschurch/ccms-sdk",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "CCMS TypeScript SDK for Web APIs and WebSockets (Express, Web, React Native)",
   "license": "MIT",
   "main": "dist/index.js",