Added comments to the SupabasePatchHelper and PATCH Event in SupabaseConnector

Author: dean-journeyapps

demos/CommandLine/Helpers/SupabasePatchHelper.cs

@@ -7,28 +7,32 @@ namespace CommandLine.Helpers;
 
 public static class SupabasePatchHelper
 {
+    // Applies a "SET" operation to the table, setting the value of a specific property.
     public static IPostgrestTable<T> ApplySet<T>(
-        IPostgrestTable<T> table,
-        string jsonPropertyName,
-        object value
-    ) where T : BaseModel, new()
+        IPostgrestTable<T> table, // The table to apply the operation to
+        string jsonPropertyName,  // The name of the JSON property to update
+        object value              // The new value to set for the property
+    ) where T : BaseModel, new() // Ensures T is a subclass of BaseModel with a parameterless constructor
     {
-        // Find the property that matches the JsonProperty name
+        // Find the property on the model that matches the JSON property name
         var property = typeof(T)
-            .GetProperties()
+            .GetProperties()  // Get all properties of the model type
             .FirstOrDefault(p =>
+                // Check if the property has a JsonPropertyAttribute
                 p.GetCustomAttributes(typeof(JsonPropertyAttribute), true)
                 .FirstOrDefault() is JsonPropertyAttribute attr &&
-                attr.PropertyName == jsonPropertyName);
+                attr.PropertyName == jsonPropertyName);  // Check if the JSON property name matches
 
         if (property == null)
             throw new ArgumentException($"'{jsonPropertyName}' is not a valid property on type '{typeof(T).Name}'");
 
-        var parameter = Expression.Parameter(typeof(T), "x");
-        var propertyAccess = Expression.Property(parameter, property.Name);
-        var converted = Expression.Convert(propertyAccess, typeof(object));
-        var lambda = Expression.Lambda<Func<T, object>>(converted, parameter);
+        // Create an expression to access the specified property on the model
+        var parameter = Expression.Parameter(typeof(T), "x"); // Define a parameter for the expression
+        var propertyAccess = Expression.Property(parameter, property.Name); // Access the property
+        var converted = Expression.Convert(propertyAccess, typeof(object)); // Convert the value to object type
+        var lambda = Expression.Lambda<Func<T, object>>(converted, parameter); // Create a lambda expression for the property
 
+        // Apply the "SET" operation to the table using the lambda expression
         return table.Set(lambda, value);
     }
-}
+}

demos/CommandLine/SupabaseConnector.cs

@@ -108,25 +108,33 @@ public async Task UploadData(IPowerSyncDatabase database)
 
                         if (op.Table.ToLower().Trim() == "lists")
                         {
+                            // Create an update query for the 'Todo' table where the 'Id' matches 'op.Id'
                             IPostgrestTable<List> updateQuery = _supabase
                             .From<List>()
                             .Where(x => x.Id == op.Id);
 
+                            // Loop through each key-value pair in the operation data (op.OpData) to apply updates dynamically
                             foreach (var kvp in op.OpData)
                             {
+                                // Apply the "SET" operation for each key-value pair. 
+                                // The key represents the JSON property name and the value is the new value to be set
                                 updateQuery = SupabasePatchHelper.ApplySet(updateQuery, kvp.Key, kvp.Value);
                             }
 
                             _ = await updateQuery.Update();
                         }
                         else if (op.Table.ToLower().Trim() == "todos")
                         {
+                            // Create an update query for the 'Todo' table where the 'Id' matches 'op.Id'
                             IPostgrestTable<Todo> updateQuery = _supabase
-                            .From<Todo>()
-                            .Where(x => x.Id == op.Id);
+                                .From<Todo>()
+                                .Where(x => x.Id == op.Id);
 
+                            // Loop through each key-value pair in the operation data (op.OpData) to apply updates dynamically
                             foreach (var kvp in op.OpData)
                             {
+                                // Apply the "SET" operation for each key-value pair. 
+                                // The key represents the JSON property name and the value is the new value to be set
                                 updateQuery = SupabasePatchHelper.ApplySet(updateQuery, kvp.Key, kvp.Value);
                             }