@codesinger0/shared-components 1.0.45 → 1.0.46

package/dist/hooks/useFirestoreCollection.js

@@ -0,0 +1,243 @@
+import { useState } from 'react';
+import {
+  collection,
+  doc,
+  getDocs,
+  getDoc,
+  addDoc,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  orderBy,
+  query,
+  serverTimestamp
+} from 'firebase/firestore';
+
+/**
+ * Generic Firestore Collection Hook
+ * 
+ * @param {string} collectionName - Name of the Firestore collection
+ * @param {Function} ModelClass - Constructor function for the model class
+ * @param {Object} options - Configuration options
+ * @param {string} options.defaultSortField - Default field to sort by (default: 'createdAt')
+ * @param {string} options.defaultSortOrder - Default sort order ('asc' or 'desc', default: 'desc')
+ * @param {Object} options.errorMessages - Custom error messages for operations
+ * @returns {Object} Hook state and methods
+ */
+export const useFirestoreCollection = (
+  collectionName,
+  ModelClass,
+  options = {},
+  db
+) => {
+  const {
+    defaultSortField = 'createdAt',
+    defaultSortOrder = 'desc',
+    errorMessages = {}
+  } = options;
+
+  // Default error messages with option to override
+  const defaultErrorMessages = {
+    get: 'קבלת נתונים',
+    getById: 'קבלת פריט',
+    create: 'יצירת פריט',
+    update: 'עדכון פריט',
+    delete: 'מחיקת פריט',
+    notFound: 'פריט לא נמצא',
+    ...errorMessages
+  };
+
+  const [items, setItems] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+
+  // Helper function to clear error
+  const clearError = () => setError(null);
+
+  // Helper function to handle errors
+  const handleError = (error, operation) => {
+    console.error(`Error in ${operation}:`, error);
+    setError(`שגיאה ב${defaultErrorMessages[operation] || operation}: ${error.message}`);
+    setLoading(false);
+  };
+
+  // Get all items
+  const getItems = async (sortField = defaultSortField, sortOrder = defaultSortOrder) => {
+    setLoading(true);
+    clearError();
+
+    try {
+      const q = query(
+        collection(db, collectionName), 
+        orderBy(sortField, sortOrder)
+      );
+      const querySnapshot = await getDocs(q);
+
+      const itemsData = [];
+      querySnapshot.forEach((doc) => {
+        itemsData.push(new ModelClass({
+          ...doc.data(),
+          id: doc.id
+        }));
+      });
+
+      setItems(itemsData);
+      setLoading(false);
+      return itemsData;
+    } catch (error) {
+      handleError(error, 'get');
+      return [];
+    }
+  };
+
+  // Get single item by ID
+  const getItem = async (itemId) => {
+    setLoading(true);
+    clearError();
+
+    try {
+      const docRef = doc(db, collectionName, itemId);
+      const docSnap = await getDoc(docRef);
+
+      if (docSnap.exists()) {
+        const itemData = new ModelClass({
+          ...docSnap.data(),
+          id: docSnap.id
+        });
+        setLoading(false);
+        return itemData;
+      } else {
+        const errorMsg = defaultErrorMessages.notFound;
+        setError(errorMsg);
+        setLoading(false);
+        throw new Error(errorMsg);
+      }
+    } catch (error) {
+      handleError(error, 'getById');
+      return null;
+    }
+  };
+
+  // Create new item
+const createItem = async (itemData, customId = null) => {
+    setLoading(true);
+    clearError();
+
+    try {
+      // Create Model instance and validate
+      const item = new ModelClass(itemData);
+      const validation = item.validate();
+
+      if (!validation.isValid) {
+        throw new Error(validation.errors.join(', '));
+      }
+
+      // Prepare item data with timestamps
+      const firestoreData = {
+        ...item.toFirestore(),
+        createdAt: serverTimestamp(),
+        updatedAt: serverTimestamp()
+      };
+
+      let docRef;
+      if (customId) {
+        // Use custom ID
+        docRef = doc(db, collectionName, customId);
+        await setDoc(docRef, firestoreData);
+      } else {
+        // Auto-generate ID
+        docRef = await addDoc(collection(db, collectionName), firestoreData);
+      }
+
+      // Return Model instance
+      const newItem = new ModelClass({
+        id: docRef.id,
+        ...item.toFirestore(),
+        createdAt: firestoreData.createdAt,
+        updatedAt: firestoreData.updatedAt
+      });
+
+      setLoading(false);
+      return newItem;
+    } catch (error) {
+      handleError(error, 'create');
+      return null;
+    }
+  };
+
+  const updateItem = async (itemId, updates) => {
+    setLoading(true);
+    clearError();
+
+    try {
+      // Get existing document first
+      const docRef = doc(db, collectionName, itemId);
+      const existingDoc = await getDoc(docRef);
+
+      if (!existingDoc.exists()) {
+        throw new Error('Document not found');
+      }
+
+      // Merge existing data with updates
+      const existingData = existingDoc.data();
+      const mergedData = { ...existingData, ...updates, id: itemId };
+
+      // Create Model instance and validate
+      const item = new ModelClass(mergedData);
+      const validation = item.validate();
+
+      if (!validation.isValid) {
+        throw new Error(validation.errors.join(', '));
+      }
+
+      // Prepare updates with timestamp
+      const updateData = {
+        ...item.toFirestore(),
+        updatedAt: serverTimestamp()
+      };
+
+      await updateDoc(docRef, updateData);
+      setLoading(false);
+
+      // Return Model instance
+      return new ModelClass({ id: itemId, ...updateData });
+    } catch (error) {
+      handleError(error, 'update');
+      return null;
+    }
+  };
+
+  // Delete item
+  const deleteItem = async (itemId) => {
+    setLoading(true);
+    clearError();
+
+    try {
+      const docRef = doc(db, collectionName, itemId);
+      await deleteDoc(docRef);
+      setLoading(false);
+
+      return true;
+    } catch (error) {
+      handleError(error, 'delete');
+      return false;
+    }
+  };
+
+  return {
+    // State
+    items,
+    loading,
+    error,
+
+    // Actions
+    getItems,
+    getItem,
+    createItem,
+    updateItem,
+    deleteItem,
+
+    // Utility
+    clearError
+  };
+};

package/dist/index.js

@@ -19,4 +19,5 @@ export { ToastProvider, useToast } from './components/ToastProvider'
 export { CartProvider, useCart } from './context/CartContext'
 
 // Hooks
-export { default as useScrollLock } from './hooks/useScrollLock'
+export { default as useScrollLock } from './hooks/useScrollLock'
+export { useFirestoreCollection } from './hooks/useFirestoreCollection'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codesinger0/shared-components",
-  "version": "1.0.45",
+  "version": "1.0.46",
   "description": "Shared React components for customer projects",
   "main": "dist/index.js",
   "files": [