Fix mypy error in delete(), restore __init__ exports, add large-batch docstring tips

Author: Saurabh Badenkal

src/PowerPlatform/Dataverse/operations/__init__.py

@@ -8,6 +8,4 @@
 SDK operations into logical groups: records, query, and tables.
 """
 
-from .dataframe import DataFrameOperations
-
-__all__ = ["DataFrameOperations"]
+__all__: list[str] = []

src/PowerPlatform/Dataverse/operations/dataframe.py

@@ -154,6 +154,11 @@ def create(
         :raises ValueError: If ``records`` is empty or the number of returned
             IDs does not match the number of input rows.
 
+        .. tip::
+            All rows are sent in a single ``CreateMultiple`` request. For very
+            large DataFrames, consider splitting into smaller batches to avoid
+            request timeouts.
+
         Example:
             Create records from a DataFrame::
 
@@ -208,6 +213,11 @@ def update(
         :raises TypeError: If ``changes`` is not a pandas DataFrame.
         :raises ValueError: If ``id_column`` is not found in the DataFrame.
 
+        .. tip::
+            All rows are sent in a single ``UpdateMultiple`` request (or a
+            single PATCH for one row). For very large DataFrames, consider
+            splitting into smaller batches to avoid request timeouts.
+
         Example:
             Update records with different values per row::
 
@@ -300,6 +310,6 @@ def delete(
             )
 
         if len(id_list) == 1:
-            return self._client.records.delete(table, id_list[0])
-        else:
-            return self._client.records.delete(table, id_list, use_bulk_delete=use_bulk_delete)
+            self._client.records.delete(table, id_list[0])
+            return None
+        return self._client.records.delete(table, id_list, use_bulk_delete=use_bulk_delete)