@actschurch/ccms-sdk 0.0.1

package/dist/react/hooks/useServiceQuery.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Service Query Hooks
+ * React hooks for service method calls with state management
+ */
+import { CCMSError } from '../../models/common/CCMSError';
+/**
+ * State for service queries
+ */
+export interface ServiceQueryState<T> {
+    data: T | null;
+    isLoading: boolean;
+    error: CCMSError | null;
+    isSuccess: boolean;
+    isError: boolean;
+}
+/**
+ * Options for useServiceQuery hook
+ */
+export interface UseServiceQueryOptions<T> {
+    /** Enable/disable automatic fetching (default: true) */
+    enabled?: boolean;
+    /** Initial data */
+    initialData?: T;
+    /** Refetch on window focus */
+    refetchOnFocus?: boolean;
+    /** Polling interval in ms */
+    pollingInterval?: number;
+    /** On success callback */
+    onSuccess?: (data: T) => void;
+    /** On error callback */
+    onError?: (error: CCMSError) => void;
+}
+/**
+ * Hook for service method calls with caching and state management
+ *
+ * @example
+ * ```tsx
+ * function TaskList() {
+ *   const taskService = useTaskService();
+ *
+ *   const { data: tasks, isLoading, error, refetch } = useServiceQuery(
+ *     () => taskService.listView(),
+ *     { enabled: true }
+ *   );
+ *
+ *   if (isLoading) return <Loading />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   return <ul>{tasks?.map(t => <li key={t.taskID}>{t.title}</li>)}</ul>;
+ * }
+ * ```
+ */
+export declare function useServiceQuery<T>(queryFn: () => Promise<T>, options?: UseServiceQueryOptions<T>): ServiceQueryState<T> & {
+    refetch: () => Promise<void>;
+};
+/**
+ * State for service mutations
+ */
+export interface ServiceMutationState<T> {
+    data: T | null;
+    isLoading: boolean;
+    error: CCMSError | null;
+    isSuccess: boolean;
+    isError: boolean;
+}
+/**
+ * Options for useServiceMutation hook
+ */
+export interface UseServiceMutationOptions<T, V> {
+    /** On success callback */
+    onSuccess?: (data: T, variables: V) => void;
+    /** On error callback */
+    onError?: (error: CCMSError, variables: V) => void;
+    /** On settled callback (called on success or error) */
+    onSettled?: (data: T | null, error: CCMSError | null, variables: V) => void;
+}
+/**
+ * Hook for service mutations (create, update, delete)
+ *
+ * @example
+ * ```tsx
+ * function CreateTaskForm() {
+ *   const taskService = useTaskService();
+ *
+ *   const { mutate, isLoading, error } = useServiceMutation(
+ *     (data: CreateTask) => taskService.create(data),
+ *     {
+ *       onSuccess: (task) => {
+ *         console.log('Created task:', task.taskID);
+ *       }
+ *     }
+ *   );
+ *
+ *   const handleSubmit = (data: CreateTask) => {
+ *     mutate(data);
+ *   };
+ *
+ *   return (// form JSX);
+ * }
+ * ```
+ */
+export declare function useServiceMutation<T, V = void>(mutationFn: (variables: V) => Promise<T>, options?: UseServiceMutationOptions<T, V>): ServiceMutationState<T> & {
+    mutate: (variables: V) => void;
+    mutateAsync: (variables: V) => Promise<T>;
+    reset: () => void;
+};
+/**
+ * Hook for lazy service queries (manual trigger)
+ *
+ * @example
+ * ```tsx
+ * function TaskDetail({ id }: { id: number }) {
+ *   const taskService = useTaskService();
+ *   const { execute, data, isLoading, error } = useLazyServiceQuery(
+ *     () => taskService.getView(id)
+ *   );
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={execute}>Load Task</button>
+ *       {isLoading && <Loading />}
+ *       {data && <TaskView task={data} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLazyServiceQuery<T>(queryFn: () => Promise<T>, options?: Omit<UseServiceQueryOptions<T>, 'enabled'>): ServiceQueryState<T> & {
+    execute: () => Promise<void>;
+};
+//# sourceMappingURL=useServiceQuery.d.ts.map

package/dist/react/hooks/useServiceQuery.d.ts.map

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

package/dist/react/hooks/useServiceQuery.js

@@ -0,0 +1,227 @@
+/**
+ * Service Query Hooks
+ * React hooks for service method calls with state management
+ */
+import { useState, useCallback, useRef, useEffect } from 'react';
+import { CCMSError } from '../../models/common/CCMSError';
+/**
+ * Hook for service method calls with caching and state management
+ *
+ * @example
+ * ```tsx
+ * function TaskList() {
+ *   const taskService = useTaskService();
+ *
+ *   const { data: tasks, isLoading, error, refetch } = useServiceQuery(
+ *     () => taskService.listView(),
+ *     { enabled: true }
+ *   );
+ *
+ *   if (isLoading) return <Loading />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   return <ul>{tasks?.map(t => <li key={t.taskID}>{t.title}</li>)}</ul>;
+ * }
+ * ```
+ */
+export function useServiceQuery(queryFn, options = {}) {
+    const { enabled = true, initialData = null, refetchOnFocus = false, pollingInterval, onSuccess, onError, } = options;
+    const [state, setState] = useState({
+        data: initialData,
+        isLoading: enabled,
+        error: null,
+        isSuccess: false,
+        isError: false,
+    });
+    const isMounted = useRef(true);
+    const queryFnRef = useRef(queryFn);
+    // Update ref when queryFn changes
+    useEffect(() => {
+        queryFnRef.current = queryFn;
+    }, [queryFn]);
+    const fetchData = useCallback(async () => {
+        if (!isMounted.current)
+            return;
+        setState((prev) => ({ ...prev, isLoading: true, error: null }));
+        try {
+            const data = await queryFnRef.current();
+            if (isMounted.current) {
+                setState({
+                    data,
+                    isLoading: false,
+                    error: null,
+                    isSuccess: true,
+                    isError: false,
+                });
+                onSuccess?.(data);
+            }
+        }
+        catch (error) {
+            if (isMounted.current) {
+                const ccmsError = error instanceof CCMSError
+                    ? error
+                    : new CCMSError({
+                        code: 'UNKNOWN_ERROR',
+                        message: error instanceof Error ? error.message : 'An unknown error occurred',
+                        raw: error,
+                    });
+                setState({
+                    data: null,
+                    isLoading: false,
+                    error: ccmsError,
+                    isSuccess: false,
+                    isError: true,
+                });
+                onError?.(ccmsError);
+            }
+        }
+    }, [onSuccess, onError]);
+    // Initial fetch
+    useEffect(() => {
+        isMounted.current = true;
+        if (enabled) {
+            fetchData();
+        }
+        return () => {
+            isMounted.current = false;
+        };
+    }, [enabled, fetchData]);
+    // Refetch on focus
+    useEffect(() => {
+        if (!refetchOnFocus || typeof window === 'undefined')
+            return;
+        const handleFocus = () => {
+            if (enabled)
+                fetchData();
+        };
+        window.addEventListener('focus', handleFocus);
+        return () => window.removeEventListener('focus', handleFocus);
+    }, [refetchOnFocus, enabled, fetchData]);
+    // Polling
+    useEffect(() => {
+        if (!pollingInterval || !enabled)
+            return;
+        const interval = setInterval(fetchData, pollingInterval);
+        return () => clearInterval(interval);
+    }, [pollingInterval, enabled, fetchData]);
+    return { ...state, refetch: fetchData };
+}
+/**
+ * Hook for service mutations (create, update, delete)
+ *
+ * @example
+ * ```tsx
+ * function CreateTaskForm() {
+ *   const taskService = useTaskService();
+ *
+ *   const { mutate, isLoading, error } = useServiceMutation(
+ *     (data: CreateTask) => taskService.create(data),
+ *     {
+ *       onSuccess: (task) => {
+ *         console.log('Created task:', task.taskID);
+ *       }
+ *     }
+ *   );
+ *
+ *   const handleSubmit = (data: CreateTask) => {
+ *     mutate(data);
+ *   };
+ *
+ *   return (// form JSX);
+ * }
+ * ```
+ */
+export function useServiceMutation(mutationFn, options = {}) {
+    const { onSuccess, onError, onSettled } = options;
+    const [state, setState] = useState({
+        data: null,
+        isLoading: false,
+        error: null,
+        isSuccess: false,
+        isError: false,
+    });
+    const mutationFnRef = useRef(mutationFn);
+    // Update ref when mutationFn changes
+    useEffect(() => {
+        mutationFnRef.current = mutationFn;
+    }, [mutationFn]);
+    const reset = useCallback(() => {
+        setState({
+            data: null,
+            isLoading: false,
+            error: null,
+            isSuccess: false,
+            isError: false,
+        });
+    }, []);
+    const mutateAsync = useCallback(async (variables) => {
+        setState((prev) => ({ ...prev, isLoading: true, error: null }));
+        try {
+            const data = await mutationFnRef.current(variables);
+            setState({
+                data,
+                isLoading: false,
+                error: null,
+                isSuccess: true,
+                isError: false,
+            });
+            onSuccess?.(data, variables);
+            onSettled?.(data, null, variables);
+            return data;
+        }
+        catch (error) {
+            const ccmsError = error instanceof CCMSError
+                ? error
+                : new CCMSError({
+                    code: 'UNKNOWN_ERROR',
+                    message: error instanceof Error ? error.message : 'An unknown error occurred',
+                    raw: error,
+                });
+            setState({
+                data: null,
+                isLoading: false,
+                error: ccmsError,
+                isSuccess: false,
+                isError: true,
+            });
+            onError?.(ccmsError, variables);
+            onSettled?.(null, ccmsError, variables);
+            throw ccmsError;
+        }
+    }, [onSuccess, onError, onSettled]);
+    const mutate = useCallback((variables) => {
+        mutateAsync(variables).catch(() => {
+            // Error is already handled in state
+        });
+    }, [mutateAsync]);
+    return { ...state, mutate, mutateAsync, reset };
+}
+/**
+ * Hook for lazy service queries (manual trigger)
+ *
+ * @example
+ * ```tsx
+ * function TaskDetail({ id }: { id: number }) {
+ *   const taskService = useTaskService();
+ *   const { execute, data, isLoading, error } = useLazyServiceQuery(
+ *     () => taskService.getView(id)
+ *   );
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={execute}>Load Task</button>
+ *       {isLoading && <Loading />}
+ *       {data && <TaskView task={data} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useLazyServiceQuery(queryFn, options = {}) {
+    const { refetch, ...state } = useServiceQuery(queryFn, {
+        ...options,
+        enabled: false,
+    });
+    return { ...state, execute: refetch };
+}
+//# sourceMappingURL=useServiceQuery.js.map

package/dist/react/hooks/useServiceQuery.js.map

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

package/dist/react/hooks/useServices.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Service Hooks
+ * Re-exports all service hooks from domain-specific files
+ *
+ * Each domain has its own hook file in ./services/:
+ * - useTaskServices.ts - Task management hooks
+ * - useUsersServices.ts - User management hooks
+ * - (future domains will be added as separate files)
+ */
+export * from './services';
+//# sourceMappingURL=useServices.d.ts.map

package/dist/react/hooks/useServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServices.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useServices.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC"}

package/dist/react/hooks/useServices.js

@@ -0,0 +1,11 @@
+/**
+ * Service Hooks
+ * Re-exports all service hooks from domain-specific files
+ *
+ * Each domain has its own hook file in ./services/:
+ * - useTaskServices.ts - Task management hooks
+ * - useUsersServices.ts - User management hooks
+ * - (future domains will be added as separate files)
+ */
+export * from './services';
+//# sourceMappingURL=useServices.js.map

package/dist/react/hooks/useServices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServices.js","sourceRoot":"","sources":["../../../src/react/hooks/useServices.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC"}

package/dist/react/hooks/useUpload.d.ts

@@ -0,0 +1,217 @@
+/**
+ * React Hooks for File Upload
+ * Progress tracking, queue management, and upload state
+ */
+import { UploadStatus, UploadProgress, UploadOptions, ChunkedUploadOptions } from '../../utils/upload';
+/**
+ * Single file upload hook options
+ */
+export interface UseUploadOptions extends Omit<UploadOptions, 'onProgress' | 'onComplete' | 'onError' | 'onStateChange'> {
+    /** Auto-start upload when file is set */
+    autoUpload?: boolean;
+    /** Validation constraints */
+    validation?: {
+        maxSize?: number;
+        allowedMimeTypes?: string[];
+        allowedExtensions?: string[];
+    };
+}
+/**
+ * Single file upload hook result
+ */
+export interface UseUploadResult {
+    /** Current upload status */
+    status: UploadStatus | null;
+    /** Upload progress */
+    progress: UploadProgress | null;
+    /** Is currently uploading */
+    isUploading: boolean;
+    /** Is upload complete */
+    isComplete: boolean;
+    /** Has error */
+    hasError: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Server response */
+    response: unknown;
+    /** Start upload with file */
+    upload: (file: File) => Promise<unknown>;
+    /** Cancel current upload */
+    cancel: () => void;
+    /** Reset state */
+    reset: () => void;
+    /** Validate file before upload */
+    validate: (file: File) => Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /** Formatted progress string */
+    progressText: string;
+    /** Formatted speed string */
+    speedText: string;
+    /** Formatted ETA string */
+    etaText: string;
+}
+/**
+ * Hook for single file upload with progress tracking
+ */
+export declare function useUpload(options: UseUploadOptions): UseUploadResult;
+/**
+ * Chunked upload hook options
+ */
+export interface UseChunkedUploadOptions extends Omit<ChunkedUploadOptions, 'onProgress' | 'onComplete' | 'onError' | 'onStateChange'> {
+    /** Validation constraints */
+    validation?: {
+        maxSize?: number;
+        allowedMimeTypes?: string[];
+        allowedExtensions?: string[];
+    };
+}
+/**
+ * Chunked upload hook result
+ */
+export interface UseChunkedUploadResult extends Omit<UseUploadResult, 'upload'> {
+    /** Current chunk info */
+    chunkInfo: {
+        current: number;
+        total: number;
+    } | null;
+    /** Is paused */
+    isPaused: boolean;
+    /** Start upload */
+    upload: (file: File) => Promise<unknown>;
+    /** Pause upload */
+    pause: () => void;
+    /** Resume upload */
+    resume: (file: File) => Promise<unknown>;
+}
+/**
+ * Hook for chunked file upload with pause/resume capability
+ */
+export declare function useChunkedUpload(options: UseChunkedUploadOptions): UseChunkedUploadResult;
+/**
+ * Upload queue hook options
+ */
+export interface UseUploadQueueOptions {
+    /** Maximum concurrent uploads */
+    maxConcurrent?: number;
+    /** Default upload options */
+    defaultOptions: Omit<UploadOptions, 'onProgress' | 'onComplete' | 'onError' | 'onStateChange'>;
+    /** Validation constraints */
+    validation?: {
+        maxSize?: number;
+        allowedMimeTypes?: string[];
+        allowedExtensions?: string[];
+    };
+}
+/**
+ * Upload queue status
+ */
+export interface QueueStatus {
+    queued: number;
+    active: number;
+    completed: number;
+    failed: number;
+    isPaused: boolean;
+    totalProgress: number;
+}
+/**
+ * Upload queue hook result
+ */
+export interface UseUploadQueueResult {
+    /** Queue status */
+    queueStatus: QueueStatus;
+    /** All upload statuses */
+    uploads: UploadStatus[];
+    /** Add file to queue */
+    addFile: (file: File, options?: Partial<UploadOptions>) => string;
+    /** Add multiple files */
+    addFiles: (files: File[], options?: Partial<UploadOptions>) => string[];
+    /** Pause queue */
+    pause: () => void;
+    /** Resume queue */
+    resume: () => void;
+    /** Cancel specific upload */
+    cancel: (id: string) => void;
+    /** Cancel all uploads */
+    cancelAll: () => void;
+    /** Clear completed uploads */
+    clearCompleted: () => void;
+    /** Validate file */
+    validate: (file: File) => Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+}
+/**
+ * Hook for managing multiple file uploads with queue
+ */
+export declare function useUploadQueue(options: UseUploadQueueOptions): UseUploadQueueResult;
+/**
+ * Hook for drag and drop file upload
+ */
+export interface UseDropzoneOptions {
+    /** Accepted file types */
+    accept?: string[];
+    /** Multiple files allowed */
+    multiple?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Max files (if multiple) */
+    maxFiles?: number;
+    /** Called when files are dropped */
+    onDrop?: (files: File[]) => void;
+    /** Called when files are rejected */
+    onReject?: (files: File[], errors: string[]) => void;
+    /** Validation constraints */
+    validation?: {
+        maxSize?: number;
+        allowedMimeTypes?: string[];
+        allowedExtensions?: string[];
+    };
+}
+/**
+ * Dropzone state and handlers
+ */
+export interface UseDropzoneResult {
+    /** Is drag active over dropzone */
+    isDragActive: boolean;
+    /** Is drag over valid (acceptable files) */
+    isDragAccept: boolean;
+    /** Is drag over invalid (rejected files) */
+    isDragReject: boolean;
+    /** Root props for dropzone element */
+    getRootProps: () => {
+        onDragEnter: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+        onDragLeave: (e: React.DragEvent) => void;
+        onDrop: (e: React.DragEvent) => void;
+        onClick: () => void;
+    };
+    /** Props for hidden input element */
+    getInputProps: () => {
+        type: 'file';
+        accept?: string;
+        multiple?: boolean;
+        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+        style: {
+            display: 'none';
+        };
+        ref: React.RefObject<HTMLInputElement>;
+    };
+    /** Open file dialog programmatically */
+    open: () => void;
+    /** Accepted files */
+    acceptedFiles: File[];
+    /** Rejected files with errors */
+    rejectedFiles: Array<{
+        file: File;
+        errors: string[];
+    }>;
+}
+/**
+ * Hook for drag and drop file handling
+ */
+export declare function useDropzone(options?: UseDropzoneOptions): UseDropzoneResult;
+export { formatBytes, formatDuration, FileValidation, FileTypePresets } from '../../utils/upload';
+//# sourceMappingURL=useUpload.d.ts.map

package/dist/react/hooks/useUpload.d.ts.map

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