suparisma 1.0.12 → 1.1.1

package/dist/generators/coreGenerator.js

@@ -91,9 +91,14 @@ export type FilterOperators<T> = {
   isEmpty?: T extends Array<any> ? boolean : never;
 };
 
-// Type for a single field in an advanced where filter
+// Type for a single field in an advanced where filter with OR/AND support
 export type AdvancedWhereInput<T> = {
   [K in keyof T]?: T[K] | FilterOperators<T[K]>;
+} & {
+  /** Match ANY of the provided conditions */
+  OR?: AdvancedWhereInput<T>[];
+  /** Match ALL of the provided conditions */
+  AND?: AdvancedWhereInput<T>[];
 };
 
 /**
@@ -210,14 +215,26 @@ function compareValues(a: any, b: any, direction: 'asc' | 'desc'): number {
 
 /**
  * Convert a type-safe where filter to Supabase filter string
+ * Note: Complex OR/AND operations may not be fully supported in realtime filters
+ * and will fall back to client-side filtering
  */
 export function buildFilterString<T>(where?: T): string | undefined {
   if (!where) return undefined;
   
+  const whereObj = where as any;
+  
+  // Check for OR/AND operations - these are complex for realtime filters
+  if (whereObj.OR || whereObj.AND) {
+    console.log('⚠️ Complex OR/AND filters detected - realtime will use client-side filtering');
+    // For complex logical operations, we'll rely on client-side filtering
+    // Return undefined to indicate no database-level filter should be applied
+    return undefined;
+  }
+  
   const filters: string[] = [];
   
-  for (const [key, value] of Object.entries(where)) {
-    if (value !== undefined) {
+  for (const [key, value] of Object.entries(whereObj)) {
+    if (value !== undefined && key !== 'OR' && key !== 'AND') {
       if (typeof value === 'object' && value !== null) {
         // Handle advanced operators
         const advancedOps = value as unknown as FilterOperators<any>;
@@ -301,19 +318,18 @@ export function buildFilterString<T>(where?: T): string | undefined {
 }
 
 /**
- * Apply filter to the query builder
+ * Apply a single condition group to the query builder
  */
-export function applyFilter<T>(
+function applyConditionGroup<T>(
   query: SupabaseQueryBuilder, 
-  where: T
+  conditions: T
 ): SupabaseQueryBuilder {
-  if (!where) return query;
+  if (!conditions) return query;
 
   let filteredQuery = query;
   
-  // Apply each filter condition
-  for (const [key, value] of Object.entries(where)) {
-    if (value !== undefined) {
+  for (const [key, value] of Object.entries(conditions)) {
+    if (value !== undefined && key !== 'OR' && key !== 'AND') {
       if (typeof value === 'object' && value !== null) {
         // Handle advanced operators
         const advancedOps = value as unknown as FilterOperators<any>;
@@ -409,6 +425,209 @@ export function applyFilter<T>(
   return filteredQuery;
 }
 
+/**
+ * Apply filter to the query builder with OR/AND support
+ */
+export function applyFilter<T>(
+  query: SupabaseQueryBuilder, 
+  where: T
+): SupabaseQueryBuilder {
+  if (!where) return query;
+
+  const whereObj = where as any;
+  let filteredQuery = query;
+  
+  // Handle regular conditions first (these are implicitly AND-ed)
+  filteredQuery = applyConditionGroup(filteredQuery, whereObj);
+  
+  // Handle OR conditions
+  if (whereObj.OR && Array.isArray(whereObj.OR) && whereObj.OR.length > 0) {
+    // @ts-ignore: Supabase typing issue
+    filteredQuery = filteredQuery.or(
+      whereObj.OR.map((orCondition: any, index: number) => {
+        // Convert each OR condition to a filter string
+        const orFilters: string[] = [];
+        
+        for (const [key, value] of Object.entries(orCondition)) {
+          if (value !== undefined && key !== 'OR' && key !== 'AND') {
+            if (typeof value === 'object' && value !== null) {
+              const advancedOps = value as unknown as FilterOperators<any>;
+              
+              if ('equals' in advancedOps && advancedOps.equals !== undefined) {
+                orFilters.push(\`\${key}.eq.\${advancedOps.equals}\`);
+              } else if ('not' in advancedOps && advancedOps.not !== undefined) {
+                orFilters.push(\`\${key}.neq.\${advancedOps.not}\`);
+              } else if ('gt' in advancedOps && advancedOps.gt !== undefined) {
+                orFilters.push(\`\${key}.gt.\${advancedOps.gt}\`);
+              } else if ('gte' in advancedOps && advancedOps.gte !== undefined) {
+                orFilters.push(\`\${key}.gte.\${advancedOps.gte}\`);
+              } else if ('lt' in advancedOps && advancedOps.lt !== undefined) {
+                orFilters.push(\`\${key}.lt.\${advancedOps.lt}\`);
+              } else if ('lte' in advancedOps && advancedOps.lte !== undefined) {
+                orFilters.push(\`\${key}.lte.\${advancedOps.lte}\`);
+              } else if ('in' in advancedOps && advancedOps.in?.length) {
+                orFilters.push(\`\${key}.in.(\${advancedOps.in.join(',')})\`);
+              } else if ('contains' in advancedOps && advancedOps.contains !== undefined) {
+                orFilters.push(\`\${key}.ilike.*\${advancedOps.contains}*\`);
+              } else if ('startsWith' in advancedOps && advancedOps.startsWith !== undefined) {
+                orFilters.push(\`\${key}.ilike.\${advancedOps.startsWith}%\`);
+              } else if ('endsWith' in advancedOps && advancedOps.endsWith !== undefined) {
+                orFilters.push(\`\${key}.ilike.%\${advancedOps.endsWith}\`);
+              } else if ('has' in advancedOps && advancedOps.has !== undefined) {
+                orFilters.push(\`\${key}.ov.\${JSON.stringify(advancedOps.has)}\`);
+              } else if ('hasEvery' in advancedOps && advancedOps.hasEvery !== undefined) {
+                orFilters.push(\`\${key}.cs.\${JSON.stringify(advancedOps.hasEvery)}\`);
+              } else if ('hasSome' in advancedOps && advancedOps.hasSome !== undefined) {
+                orFilters.push(\`\${key}.ov.\${JSON.stringify(advancedOps.hasSome)}\`);
+              } else if ('isEmpty' in advancedOps && advancedOps.isEmpty !== undefined) {
+                if (advancedOps.isEmpty) {
+                  orFilters.push(\`\${key}.eq.{}\`);
+                } else {
+                  orFilters.push(\`\${key}.neq.{}\`);
+                }
+              }
+            } else {
+              // Simple equality
+              orFilters.push(\`\${key}.eq.\${value}\`);
+            }
+          }
+        }
+        
+        return orFilters.join(',');
+      }).join(',')
+    );
+  }
+  
+  // Handle AND conditions (these are applied in addition to regular conditions)
+  if (whereObj.AND && Array.isArray(whereObj.AND) && whereObj.AND.length > 0) {
+    for (const andCondition of whereObj.AND) {
+      filteredQuery = applyConditionGroup(filteredQuery, andCondition);
+    }
+  }
+  
+  return filteredQuery;
+}
+
+/**
+ * Evaluate if a record matches filter criteria (including OR/AND logic)
+ */
+function matchesFilter<T>(record: any, filter: T): boolean {
+  if (!filter) return true;
+  
+  const filterObj = filter as any;
+  
+  // Separate regular conditions from OR/AND
+  const hasOr = filterObj.OR && Array.isArray(filterObj.OR) && filterObj.OR.length > 0;
+  const hasAnd = filterObj.AND && Array.isArray(filterObj.AND) && filterObj.AND.length > 0;
+  
+  // Check regular field conditions (these are implicitly AND-ed)
+  const regularConditions: any = {};
+  for (const [key, value] of Object.entries(filterObj)) {
+    if (value !== undefined && key !== 'OR' && key !== 'AND') {
+      regularConditions[key] = value;
+    }
+  }
+  
+  // Helper function to check individual field conditions
+  const checkFieldConditions = (conditions: any): boolean => {
+    for (const [key, value] of Object.entries(conditions)) {
+      if (value !== undefined) {
+        const recordValue = record[key];
+        
+        if (typeof value === 'object' && value !== null) {
+          // Handle advanced operators
+          const advancedOps = value as unknown as FilterOperators<any>;
+          
+          if ('equals' in advancedOps && advancedOps.equals !== undefined) {
+            if (recordValue !== advancedOps.equals) return false;
+          }
+          
+          if ('not' in advancedOps && advancedOps.not !== undefined) {
+            if (recordValue === advancedOps.not) return false;
+          }
+          
+          if ('gt' in advancedOps && advancedOps.gt !== undefined) {
+            if (!(recordValue > advancedOps.gt)) return false;
+          }
+          
+          if ('gte' in advancedOps && advancedOps.gte !== undefined) {
+            if (!(recordValue >= advancedOps.gte)) return false;
+          }
+          
+          if ('lt' in advancedOps && advancedOps.lt !== undefined) {
+            if (!(recordValue < advancedOps.lt)) return false;
+          }
+          
+          if ('lte' in advancedOps && advancedOps.lte !== undefined) {
+            if (!(recordValue <= advancedOps.lte)) return false;
+          }
+          
+          if ('in' in advancedOps && advancedOps.in?.length) {
+            if (!advancedOps.in.includes(recordValue)) return false;
+          }
+          
+          if ('contains' in advancedOps && advancedOps.contains !== undefined) {
+            if (!recordValue || !String(recordValue).toLowerCase().includes(String(advancedOps.contains).toLowerCase())) return false;
+          }
+          
+          if ('startsWith' in advancedOps && advancedOps.startsWith !== undefined) {
+            if (!recordValue || !String(recordValue).toLowerCase().startsWith(String(advancedOps.startsWith).toLowerCase())) return false;
+          }
+          
+          if ('endsWith' in advancedOps && advancedOps.endsWith !== undefined) {
+            if (!recordValue || !String(recordValue).toLowerCase().endsWith(String(advancedOps.endsWith).toLowerCase())) return false;
+          }
+          
+          // Array-specific operators
+          if ('has' in advancedOps && advancedOps.has !== undefined) {
+            if (!Array.isArray(recordValue) || !advancedOps.has.some((item: any) => recordValue.includes(item))) return false;
+          }
+          
+          if ('hasEvery' in advancedOps && advancedOps.hasEvery !== undefined) {
+            if (!Array.isArray(recordValue) || !advancedOps.hasEvery.every((item: any) => recordValue.includes(item))) return false;
+          }
+          
+          if ('hasSome' in advancedOps && advancedOps.hasSome !== undefined) {
+            if (!Array.isArray(recordValue) || !advancedOps.hasSome.some((item: any) => recordValue.includes(item))) return false;
+          }
+          
+          if ('isEmpty' in advancedOps && advancedOps.isEmpty !== undefined) {
+            const isEmpty = !Array.isArray(recordValue) || recordValue.length === 0;
+            if (isEmpty !== advancedOps.isEmpty) return false;
+          }
+        } else {
+          // Simple equality
+          if (recordValue !== value) return false;
+        }
+      }
+    }
+    return true;
+  };
+  
+  // All conditions that must be true
+  const conditions: boolean[] = [];
+  
+  // Regular field conditions (implicitly AND-ed)
+  if (Object.keys(regularConditions).length > 0) {
+    conditions.push(checkFieldConditions(regularConditions));
+  }
+  
+  // AND conditions (all must be true)
+  if (hasAnd) {
+    const andResult = filterObj.AND.every((andCondition: any) => matchesFilter(record, andCondition));
+    conditions.push(andResult);
+  }
+  
+  // OR conditions (at least one must be true)
+  if (hasOr) {
+    const orResult = filterObj.OR.some((orCondition: any) => matchesFilter(record, orCondition));
+    conditions.push(orResult);
+  }
+  
+  // All conditions must be true
+  return conditions.every(condition => condition);
+}
+
 /**
  * Apply order by to the query builder
  */
@@ -900,7 +1119,7 @@ export function createSuparismaHook<
       }
     }, []);
 
-    // Set up realtime subscription for the list
+        // Set up realtime subscription for the list - ONCE and listen to ALL events
     useEffect(() => {
       if (!realtime) return;
       
@@ -912,44 +1131,14 @@ export function createSuparismaHook<
       
       const channelId = channelName || \`changes_to_\${tableName}_\${Math.random().toString(36).substring(2, 15)}\`;
       
-      // Check if we have complex array filters that should be handled client-side only
-      let hasComplexArrayFilters = false;
-      if (where) {
-        for (const [key, value] of Object.entries(where)) {
-          if (typeof value === 'object' && value !== null) {
-            const advancedOps = value as any;
-            // Check for complex array operators
-            if ('has' in advancedOps || 'hasEvery' in advancedOps || 'hasSome' in advancedOps || 'isEmpty' in advancedOps) {
-              hasComplexArrayFilters = true;
-              break;
-            }
-          }
-        }
-      }
-      
-      // For complex array filters, use no database filter and rely on client-side filtering
-      // For simple filters, use database-level filtering
+      // ALWAYS listen to ALL events and filter client-side for maximum reliability
       let subscriptionConfig: any = {
         event: '*',
         schema: 'public',
         table: tableName,
       };
       
-      if (hasComplexArrayFilters) {
-        // Don't include filter at all for complex array operations
-        console.log(\`Setting up subscription for \${tableName} with NO FILTER (complex array filters detected) - will receive ALL events\`);
-      } else if (where) {
-        // Include filter for simple operations
-        const filter = buildFilterString(where);
-        if (filter) {
-          subscriptionConfig.filter = filter;
-        }
-        console.log(\`Setting up subscription for \${tableName} with database filter: \${filter}\`);
-      } else if (realtimeFilter) {
-        // Use custom realtime filter if provided
-        subscriptionConfig.filter = realtimeFilter;
-        console.log(\`Setting up subscription for \${tableName} with custom filter: \${realtimeFilter}\`);
-      }
+      console.log(\`Setting up subscription for \${tableName} - listening to ALL events (client-side filtering)\`);
       
       const channel = supabase
         .channel(channelId)
@@ -979,56 +1168,10 @@ export function createSuparismaHook<
                   console.log(\`Processing INSERT for \${tableName}\`, { newRecord });
                   
                   // ALWAYS check if this record matches our filter client-side
-                  // This is especially important for complex array filters
-                  if (currentWhere) { // Use ref value
-                    let matchesFilter = true;
-                    
-                    // Check each filter condition client-side for complex filters
-                    for (const [key, value] of Object.entries(currentWhere)) {
-                      if (typeof value === 'object' && value !== null) {
-                        // Handle complex array filters client-side
-                        const advancedOps = value as any;
-                        const recordValue = newRecord[key as keyof typeof newRecord] as any;
-                        
-                        // Array-specific operators validation
-                        if ('has' in advancedOps && advancedOps.has !== undefined) {
-                          // Array contains ANY of the specified items
-                          if (!Array.isArray(recordValue) || !advancedOps.has.some((item: any) => recordValue.includes(item))) {
-                            matchesFilter = false;
-                            break;
-                          }
-                        } else if ('hasEvery' in advancedOps && advancedOps.hasEvery !== undefined) {
-                          // Array contains ALL of the specified items
-                          if (!Array.isArray(recordValue) || !advancedOps.hasEvery.every((item: any) => recordValue.includes(item))) {
-                            matchesFilter = false;
-                            break;
-                          }
-                        } else if ('hasSome' in advancedOps && advancedOps.hasSome !== undefined) {
-                          // Array contains ANY of the specified items
-                          if (!Array.isArray(recordValue) || !advancedOps.hasSome.some((item: any) => recordValue.includes(item))) {
-                            matchesFilter = false;
-                            break;
-                          }
-                        } else if ('isEmpty' in advancedOps && advancedOps.isEmpty !== undefined) {
-                          // Array is empty or not empty
-                          const isEmpty = !Array.isArray(recordValue) || recordValue.length === 0;
-                          if (isEmpty !== advancedOps.isEmpty) {
-                            matchesFilter = false;
-                            break;
-                          }
-                        }
-                        // Add other complex filter validations as needed
-                      } else if (newRecord[key as keyof typeof newRecord] !== value) {
-                        matchesFilter = false;
-                        console.log(\`Filter mismatch on \${key}\`, { expected: value, actual: newRecord[key as keyof typeof newRecord] });
-                        break;
-                      }
-                    }
-                    
-                    if (!matchesFilter) {
+                  // This is especially important for complex OR/AND/array filters
+                  if (currentWhere && !matchesFilter(newRecord, currentWhere)) {
                       console.log('New record does not match filter criteria, skipping');
                       return prev;
-                    }
                   }
                   
                   // Check if record already exists (avoid duplicates)
@@ -1108,56 +1251,12 @@ export function createSuparismaHook<
                 const updatedRecord = payload.new as TWithRelations;
                 
                 // Check if the updated record still matches our current filter
-                if (currentWhere) {
-                  let matchesFilter = true;
-                  
-                  for (const [key, value] of Object.entries(currentWhere)) {
-                    if (typeof value === 'object' && value !== null) {
-                      // Handle complex array filters client-side
-                      const advancedOps = value as any;
-                      const recordValue = updatedRecord[key as keyof typeof updatedRecord] as any;
-                      
-                      // Array-specific operators validation
-                      if ('has' in advancedOps && advancedOps.has !== undefined) {
-                        // Array contains ANY of the specified items
-                        if (!Array.isArray(recordValue) || !advancedOps.has.some((item: any) => recordValue.includes(item))) {
-                          matchesFilter = false;
-                          break;
-                        }
-                      } else if ('hasEvery' in advancedOps && advancedOps.hasEvery !== undefined) {
-                        // Array contains ALL of the specified items
-                        if (!Array.isArray(recordValue) || !advancedOps.hasEvery.every((item: any) => recordValue.includes(item))) {
-                          matchesFilter = false;
-                          break;
-                        }
-                      } else if ('hasSome' in advancedOps && advancedOps.hasSome !== undefined) {
-                        // Array contains ANY of the specified items
-                        if (!Array.isArray(recordValue) || !advancedOps.hasSome.some((item: any) => recordValue.includes(item))) {
-                          matchesFilter = false;
-                          break;
-                        }
-                      } else if ('isEmpty' in advancedOps && advancedOps.isEmpty !== undefined) {
-                        // Array is empty or not empty
-                        const isEmpty = !Array.isArray(recordValue) || recordValue.length === 0;
-                        if (isEmpty !== advancedOps.isEmpty) {
-                          matchesFilter = false;
-                          break;
-                        }
-                      }
-                    } else if (updatedRecord[key as keyof typeof updatedRecord] !== value) {
-                      matchesFilter = false;
-                      break;
-                    }
-                  }
-                  
-                  // If the updated record doesn't match the filter, remove it from the list
-                  if (!matchesFilter) {
+                if (currentWhere && !matchesFilter(updatedRecord, currentWhere)) {
                     console.log('Updated record no longer matches filter, removing from list');
                     return prev.filter((item) =>
                       // @ts-ignore: Supabase typing issue
                       !('id' in item && 'id' in updatedRecord && item.id === updatedRecord.id)
                     );
-                  }
                 }
                 
                 const newData = prev.map((item) =>
@@ -1324,7 +1423,7 @@ export function createSuparismaHook<
           searchTimeoutRef.current = null;
         }
       };
-    }, [realtime, channelName, tableName, where, initialLoadRef]); // Added 'where' back so subscription updates when filter changes
+    }, [realtime, channelName, tableName]); // NEVER include 'where' - subscription should persist
 
     // Create a memoized options object to prevent unnecessary re-renders
     const optionsRef = useRef({ where, orderBy, limit, offset });
@@ -1353,7 +1452,7 @@ export function createSuparismaHook<
       return false;
     }, [where, orderBy, limit, offset]);
 
-    // Load initial data based on options
+    // Load initial data and refetch when options change (BUT NEVER TOUCH SUBSCRIPTION)
     useEffect(() => {
       // Skip if search is active
       if (isSearchingRef.current) return;
@@ -1362,7 +1461,7 @@ export function createSuparismaHook<
       if (initialLoadRef.current) {
         // Only reload if options have changed significantly
         if (optionsChanged()) {
-          console.log(\`Options changed for \${tableName}, reloading data\`);
+          console.log(\`Options changed for \${tableName}, refetching data (subscription stays alive)\`);
           findMany({
             where,
             orderBy,
@@ -1392,6 +1491,8 @@ export function createSuparismaHook<
     /**
      * Create a new record with the provided data.
      * Default values from the schema will be applied if not provided.
+     * NOTE: This operation does NOT immediately update the local state.
+     * The state will be updated when the realtime INSERT event is received.
      * 
      * @param data - The data to create the record with
      * @returns A promise with the created record or error
@@ -1464,8 +1565,8 @@ export function createSuparismaHook<
         
         if (error) throw error;
         
-        // Update the total count after a successful creation
-        setTimeout(() => fetchTotalCount(), 0);
+        // DO NOT UPDATE LOCAL STATE HERE - Let realtime INSERT event handle it
+        console.log('✅ Created ' + tableName + ' record, waiting for realtime INSERT event to update state');
         
         // Return created record
         return { data: result?.[0] as TWithRelations, error: null };
@@ -1476,10 +1577,12 @@ export function createSuparismaHook<
       } finally {
         setLoading(false);
       }
-    }, [fetchTotalCount]);
+    }, []);
 
     /**
      * Update an existing record identified by a unique identifier.
+     * NOTE: This operation does NOT immediately update the local state.
+     * The state will be updated when the realtime UPDATE event is received.
      * 
      * @param params - Object containing the identifier and update data
      * @returns A promise with the updated record or error
@@ -1541,10 +1644,8 @@ export function createSuparismaHook<
         
         if (error) throw error;
         
-        // Update the total count after a successful update
-        // This is for consistency with other operations, and because
-        // updates can sometimes affect filtering based on updated values
-        setTimeout(() => fetchTotalCount(), 0);
+        // DO NOT UPDATE LOCAL STATE HERE - Let realtime UPDATE event handle it
+        console.log('✅ Updated ' + tableName + ' record, waiting for realtime UPDATE event to update state');
         
         // Return updated record
         return { data: data?.[0] as TWithRelations, error: null };
@@ -1555,10 +1656,12 @@ export function createSuparismaHook<
       } finally {
         setLoading(false);
       }
-    }, [fetchTotalCount]);
+    }, []);
 
     /**
      * Delete a record by its unique identifier.
+     * NOTE: This operation does NOT immediately update the local state.
+     * The state will be updated when the realtime DELETE event is received.
      * 
      * @param where - The unique identifier to delete the record by
      * @returns A promise with the deleted record or error
@@ -1608,8 +1711,8 @@ export function createSuparismaHook<
         
         if (error) throw error;
         
-        // Update the total count after a successful deletion
-        setTimeout(() => fetchTotalCount(), 0);
+        // DO NOT UPDATE LOCAL STATE HERE - Let realtime DELETE event handle it
+        console.log('✅ Deleted ' + tableName + ' record, waiting for realtime DELETE event to update state');
         
         // Return the deleted record
         return { data: recordToDelete as TWithRelations, error: null };
@@ -1620,10 +1723,12 @@ export function createSuparismaHook<
       } finally {
         setLoading(false);
       }
-    }, [fetchTotalCount]);
+    }, []);
 
     /**
      * Delete multiple records matching the filter criteria.
+     * NOTE: This operation does NOT immediately update the local state.
+     * The state will be updated when realtime DELETE events are received for each record.
      * 
      * @param params - Query parameters for filtering records to delete
      * @returns A promise with the count of deleted records or error
@@ -1633,7 +1738,7 @@ export function createSuparismaHook<
      * const result = await users.deleteMany({
      *   where: { active: false }
      * });
-     * console.log(\`Deleted \${result.count} inactive users\`);
+     * console.log('Deleted ' + result.count + ' inactive users');
      * 
      * @example
      * // Delete all records (use with caution!)
@@ -1677,8 +1782,8 @@ export function createSuparismaHook<
         
         if (deleteError) throw deleteError;
         
-        // Update the total count after a successful bulk deletion
-        setTimeout(() => fetchTotalCount(), 0);
+        // DO NOT UPDATE LOCAL STATE HERE - Let realtime DELETE events handle it
+        console.log('✅ Deleted ' + recordsToDelete.length + ' ' + tableName + ' records, waiting for realtime DELETE events to update state');
         
         // Return the count of deleted records
         return { count: recordsToDelete.length, error: null };
@@ -1689,7 +1794,7 @@ export function createSuparismaHook<
       } finally {
         setLoading(false);
       }
-    }, [fetchTotalCount]);
+    }, []);
 
     /**
      * Find the first record matching the filter criteria.

package/dist/generators/typeGenerator.js

@@ -219,6 +219,7 @@ export type ${modelName}UpdateInput = Partial<${modelName}CreateInput>;
 /**
  * Filter type for querying ${modelName} records.
  * You can filter by any field in the model using equality or advanced filter operators.
+ * Supports OR and AND logical operations for complex queries.
  * 
  * @example
  * // Basic filtering
@@ -250,6 +251,40 @@ ${withRelationsProps
  * });
  * 
  * @example
+ * // OR conditions - match ANY condition
+ * ${modelName.toLowerCase()}.findMany({
+ *   where: {
+ *     OR: [
+ *       { ${withRelationsProps.slice(0, 1).map(p => p.trim().split(':')[0].trim())[0] || 'field1'}: "value1" },
+ *       { ${withRelationsProps.slice(1, 2).map(p => p.trim().split(':')[0].trim())[0] || 'field2'}: { contains: "value2" } }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
+ * // AND conditions - match ALL conditions
+ * ${modelName.toLowerCase()}.findMany({
+ *   where: {
+ *     AND: [
+ *       { ${withRelationsProps.slice(0, 1).map(p => p.trim().split(':')[0].trim())[0] || 'field1'}: "value1" },
+ *       { ${withRelationsProps.slice(1, 2).map(p => p.trim().split(':')[0].trim())[0] || 'field2'}: { gt: 100 } }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
+ * // Complex nested logic
+ * ${modelName.toLowerCase()}.findMany({
+ *   where: {
+ *     active: true, // Regular condition (implicit AND)
+ *     OR: [
+ *       { role: "admin" },
+ *       { role: "moderator" }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
  * // Array filtering (for array fields)
  * ${modelName.toLowerCase()}.findMany({
  *   where: {
@@ -286,6 +321,11 @@ ${model.fields
         return '';
     }).filter(Boolean))
         .join('\n')}
+} & {
+  /** Match ANY of the provided conditions */
+  OR?: ${modelName}WhereInput[];
+  /** Match ALL of the provided conditions */
+  AND?: ${modelName}WhereInput[];
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "suparisma",
-	"version": "1.0.12",
+	"version": "1.1.1",
 	"description": "Opinionated typesafe React realtime CRUD hooks generator for all your Supabase tables, powered by Prisma.",
 	"main": "dist/index.js",
 	"repository": {