lumera 0.5.3__py3-none-any.whl → 0.6.0__py3-none-any.whl

lumera/pb.py

@@ -60,6 +60,11 @@ __all__ = [
     "upsert",
     "delete",
     "iter_all",
+    # Bulk operations
+    "bulk_delete",
+    "bulk_update",
+    "bulk_upsert",
+    "bulk_insert",
     # Collection operations
     "list_collections",
     "get_collection",
@@ -70,7 +75,7 @@ __all__ = [
 ]
 
 # Import underlying SDK functions (prefixed with _ to indicate internal use)
-from .exceptions import LumeraAPIError
+from ._utils import LumeraAPIError
 from .sdk import (
     create_collection as _create_collection,
 )
@@ -107,6 +112,18 @@ from .sdk import (
 from .sdk import (
     upsert_record as _upsert_record,
 )
+from .sdk import (
+    bulk_delete_records as _bulk_delete_records,
+)
+from .sdk import (
+    bulk_update_records as _bulk_update_records,
+)
+from .sdk import (
+    bulk_upsert_records as _bulk_upsert_records,
+)
+from .sdk import (
+    bulk_insert_records as _bulk_insert_records,
+)
 
 
 def search(
@@ -296,6 +313,104 @@ def delete(collection: str, record_id: str) -> None:
     _delete_record(collection, record_id)
 
 
+# =============================================================================
+# Bulk Operations
+# =============================================================================
+
+
+def bulk_delete(collection: str, record_ids: Sequence[str]) -> dict[str, Any]:
+    """Delete multiple records by ID.
+
+    Args:
+        collection: Collection name or ID
+        record_ids: List of record IDs to delete (max 1000)
+
+    Returns:
+        Result with succeeded/failed counts and any errors:
+        {
+            "succeeded": 10,
+            "failed": 0,
+            "errors": []
+        }
+
+    Example:
+        >>> result = pb.bulk_delete("deposits", ["id1", "id2", "id3"])
+        >>> print(f"Deleted {result['succeeded']} records")
+    """
+    return _bulk_delete_records(collection, record_ids)
+
+
+def bulk_update(
+    collection: str,
+    record_ids: Sequence[str],
+    data: dict[str, Any],
+) -> dict[str, Any]:
+    """Update multiple records with the same data.
+
+    Args:
+        collection: Collection name or ID
+        record_ids: List of record IDs to update (max 1000)
+        data: Fields to update on all records
+
+    Returns:
+        Result with succeeded/failed counts
+
+    Example:
+        >>> result = pb.bulk_update("deposits", ["id1", "id2"], {"status": "processed"})
+        >>> print(f"Updated {result['succeeded']} records")
+    """
+    return _bulk_update_records(collection, record_ids, data)
+
+
+def bulk_upsert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str, Any]:
+    """Create or update multiple records by ID.
+
+    Each record can include an "id" field. Records with matching IDs will be
+    updated; records without IDs or with non-existent IDs create new records.
+
+    Args:
+        collection: Collection name or ID
+        records: List of records (max 1000)
+
+    Returns:
+        Result with succeeded/failed counts and created record IDs
+
+    Example:
+        >>> result = pb.bulk_upsert("deposits", [
+        ...     {"id": "existing_id", "amount": 100},
+        ...     {"amount": 200},  # creates new record
+        ... ])
+    """
+    return _bulk_upsert_records(collection, records)
+
+
+def bulk_insert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str, Any]:
+    """Insert multiple new records.
+
+    Args:
+        collection: Collection name or ID
+        records: List of records to create (max 1000)
+
+    Returns:
+        Result with succeeded/failed counts and created record IDs:
+        {
+            "succeeded": 2,
+            "failed": 0,
+            "errors": [],
+            "records": [{"id": "..."}, {"id": "..."}]
+        }
+
+    Example:
+        >>> result = pb.bulk_insert("deposits", [
+        ...     {"external_id": "dep-001", "amount": 100},
+        ...     {"external_id": "dep-002", "amount": 200},
+        ... ])
+        >>> for rec in result["records"]:
+        ...     print(f"Created: {rec['id']}")
+    """
+    return _bulk_insert_records(collection, records)
+
+
 def iter_all(
     collection: str,
     *,

lumera/sdk.py

@@ -576,6 +576,113 @@ def delete_record(collection_id_or_name: str, record_id: str) -> None:
     _api_request("DELETE", path)
 
 
+# =============================================================================
+# Bulk Record Operations
+# =============================================================================
+
+
+def bulk_delete_records(
+    collection_id_or_name: str,
+    record_ids: Sequence[str],
+) -> dict[str, Any]:
+    """Bulk delete records by IDs.
+
+    Args:
+        collection_id_or_name: Collection name or ID
+        record_ids: List of record IDs to delete (max 1000)
+
+    Returns:
+        Result with succeeded/failed counts and any errors
+    """
+    if not collection_id_or_name:
+        raise ValueError("collection_id_or_name is required")
+    if not record_ids:
+        raise ValueError("record_ids is required")
+
+    path = f"collections/{collection_id_or_name}/records/bulk/delete"
+    result = _api_request("POST", path, json_body={"ids": list(record_ids)})
+    return result if isinstance(result, dict) else {}
+
+
+def bulk_update_records(
+    collection_id_or_name: str,
+    record_ids: Sequence[str],
+    data: Mapping[str, Any],
+) -> dict[str, Any]:
+    """Update multiple records with the same data.
+
+    Args:
+        collection_id_or_name: Collection name or ID
+        record_ids: List of record IDs to update (max 1000)
+        data: Fields to update on all records
+
+    Returns:
+        Result with succeeded/failed counts
+    """
+    if not collection_id_or_name:
+        raise ValueError("collection_id_or_name is required")
+    if not record_ids:
+        raise ValueError("record_ids is required")
+    if not data:
+        raise ValueError("data is required")
+
+    path = f"collections/{collection_id_or_name}/records/bulk/update"
+    result = _api_request(
+        "POST", path, json_body={"ids": list(record_ids), "data": dict(data)}
+    )
+    return result if isinstance(result, dict) else {}
+
+
+def bulk_upsert_records(
+    collection_id_or_name: str,
+    records: Sequence[Mapping[str, Any]],
+) -> dict[str, Any]:
+    """Upsert multiple records (create or update by ID).
+
+    Args:
+        collection_id_or_name: Collection name or ID
+        records: List of records (max 1000). Include 'id' field to update existing.
+
+    Returns:
+        Result with succeeded/failed counts and created record IDs
+    """
+    if not collection_id_or_name:
+        raise ValueError("collection_id_or_name is required")
+    if not records:
+        raise ValueError("records is required")
+
+    path = f"collections/{collection_id_or_name}/records/bulk/upsert"
+    result = _api_request(
+        "POST", path, json_body={"records": [dict(r) for r in records]}
+    )
+    return result if isinstance(result, dict) else {}
+
+
+def bulk_insert_records(
+    collection_id_or_name: str,
+    records: Sequence[Mapping[str, Any]],
+) -> dict[str, Any]:
+    """Insert multiple new records.
+
+    Args:
+        collection_id_or_name: Collection name or ID
+        records: List of records to create (max 1000)
+
+    Returns:
+        Result with succeeded/failed counts and created record IDs
+    """
+    if not collection_id_or_name:
+        raise ValueError("collection_id_or_name is required")
+    if not records:
+        raise ValueError("records is required")
+
+    path = f"collections/{collection_id_or_name}/records/bulk/insert"
+    result = _api_request(
+        "POST", path, json_body={"records": [dict(r) for r in records]}
+    )
+    return result if isinstance(result, dict) else {}
+
+
 def replay_hook(
     collection_id_or_name: str,
     event: str,

{lumera-0.5.3.dist-info → lumera-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.5.3
+Version: 0.6.0
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests

{lumera-0.5.3.dist-info → lumera-0.6.0.dist-info}/RECORD

@@ -4,10 +4,10 @@ lumera/exceptions.py,sha256=bNsx4iYaroAAGsYxErfELC2B5ZJ3w5lVa1kKdIx5s9g,2173
 lumera/google.py,sha256=3IVNL1HaOtsTmunl0alnGFuUAkzQQRyCEA3CKjlPqO0,10183
 lumera/llm.py,sha256=pUTZK7t3GTK0vfxMI1PJgJwNendyuiJc5MB1pUj2vxE,14412
 lumera/locks.py,sha256=8l_qxb8nrxge7YJ-ApUTJ5MeYpIdxDeEa94Eim9O-YM,6806
-lumera/pb.py,sha256=E8TRw7mQ9i0vpmC46azwT7O7EP2w7w4O5ZgcrQyInyI,14915
-lumera/sdk.py,sha256=6Vw0f5MX-yjmy7KBZzEYNdjtXk2P4Oxibpa_UpcM7bs,26859
+lumera/pb.py,sha256=oJf37awGIoJ25VA1eSA3lMUXorOtNynVC7yG30X4-lU,18236
+lumera/sdk.py,sha256=XnzVtAGonhhQ2pDMtNKEOG5ZVH1sPLK-gsyTfCfBLSA,30233
 lumera/storage.py,sha256=kQQJYVRnxcpDZQ_gB2iZy6anb3hyZN7b8a_oNuE2yYE,8191
-lumera-0.5.3.dist-info/METADATA,sha256=6aLRahUomaWUUSfqSzj2_8fwTSLt08nW3BrERVVnf-Q,1611
-lumera-0.5.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lumera-0.5.3.dist-info/top_level.txt,sha256=HgfK4XQkpMTnM2E5iWM4kB711FnYqUY9dglzib3pWlE,7
-lumera-0.5.3.dist-info/RECORD,,
+lumera-0.6.0.dist-info/METADATA,sha256=4rhyTGFp6Iw1Zv-ZOtDcyThUvMSljTTtyLp-EKnEyvE,1611
+lumera-0.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lumera-0.6.0.dist-info/top_level.txt,sha256=HgfK4XQkpMTnM2E5iWM4kB711FnYqUY9dglzib3pWlE,7
+lumera-0.6.0.dist-info/RECORD,,