sfeos-helpers 6.10.0__py3-none-any.whl → 6.10.1__py3-none-any.whl

{sfeos_helpers-6.10.0.dist-info → sfeos_helpers-6.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sfeos_helpers
-Version: 6.10.0
+Version: 6.10.1
 Summary: Helper library for the Elasticsearch and Opensearch stac-fastapi backends.
 Project-URL: Homepage, https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch
 License: MIT
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.11
-Requires-Dist: stac-fastapi-core==6.10.0
+Requires-Dist: stac-fastapi-core==6.10.1
 Description-Content-Type: text/markdown
 
 # sfeos-helpers

{sfeos_helpers-6.10.0.dist-info → sfeos_helpers-6.10.1.dist-info}/RECORD

@@ -1,18 +1,18 @@
 stac_fastapi/sfeos_helpers/mappings.py,sha256=U0zrBZ-foLtPy25PwSJSJW5EFBMin03aTrw53natt3g,12964
-stac_fastapi/sfeos_helpers/version.py,sha256=bQiD_D-FuZl4YJZxrz9LK-THtzxnF7e-QdjJAiGBoSY,46
+stac_fastapi/sfeos_helpers/version.py,sha256=AD8oiYJE5bGoF51nIlCATcNL2aBRMbKASqetnSyzqGA,46
 stac_fastapi/sfeos_helpers/aggregation/README.md,sha256=SDlvCOpKyaJrlJvx84T2RzCnGALe_PK51zNeo3RP9ac,2122
 stac_fastapi/sfeos_helpers/aggregation/__init__.py,sha256=Mym17lFh90by1GnoQgMyIKAqRNJnvCgVSXDYzjBiPQk,1210
 stac_fastapi/sfeos_helpers/aggregation/client.py,sha256=eaH1kTBRuBbt1Ikqk0rR8hcY3LEFr9_06UgMGP44ZcQ,17861
 stac_fastapi/sfeos_helpers/aggregation/format.py,sha256=qUW1jjh2EEjy-V7riliFR77grpi-AgsTmP76z60K5Lo,2011
 stac_fastapi/sfeos_helpers/database/README.md,sha256=TVYFDD4PqDD57ZsWBv4i4LawaL_DAEIOjM6OQuqwLAU,4049
-stac_fastapi/sfeos_helpers/database/__init__.py,sha256=M3EBI5X4QD_x0oG976ZNLvUSYSMJ2UJPMj4nkDMSXYg,3425
+stac_fastapi/sfeos_helpers/database/__init__.py,sha256=DATeB7mvDzu26O09QJG_DOmFcKRClMZ9x47224-2W68,3655
 stac_fastapi/sfeos_helpers/database/catalogs.py,sha256=Sux7VAeCLWTk6845pt2YHFEJaecPxZ5vP2RT0G-M45k,6425
 stac_fastapi/sfeos_helpers/database/datetime.py,sha256=yVD-FQCmjjJGM0CxAKqzOWfdotHvVup1r8Pvd68WjTU,8578
 stac_fastapi/sfeos_helpers/database/document.py,sha256=LtjX15gvaOuZC_k2t_oQhys_c-zRTLN5rwX0hNJkHnM,1725
-stac_fastapi/sfeos_helpers/database/index.py,sha256=GS7xwkhG3ccUG4EY4KCzW_YQO3CxXbJ1QaGnv_E7pEg,8536
+stac_fastapi/sfeos_helpers/database/index.py,sha256=Eqa94G_lYBGYmscNTC0NPuH9n9EkqGyxV1zidf_xB8I,8587
 stac_fastapi/sfeos_helpers/database/mapping.py,sha256=4vGUuBLGoBOkQ984pYOciiz9UUWb4sbZyt-iViIsmdM,3809
 stac_fastapi/sfeos_helpers/database/query.py,sha256=Qe78ZmFTyWMKBmz8PpJ3CUiWuoTojbTo9seSxNteC9E,9477
-stac_fastapi/sfeos_helpers/database/utils.py,sha256=FfQsO-01kn1Znw9qSrXDr-SBnJOXridMO1MpRphDEms,12732
+stac_fastapi/sfeos_helpers/database/utils.py,sha256=p3kmY9fC08l_OKYGfKQWqQpjX4K27R_2iBv8xM8N58o,14751
 stac_fastapi/sfeos_helpers/filter/README.md,sha256=Rb5qHmDkI-7-o3I82Lb_zfmrviqUj958wef021xI6pQ,1955
 stac_fastapi/sfeos_helpers/filter/__init__.py,sha256=n3zL_MhEGOoxMz1KeijyK_UKiZ0MKPl90zHtYI5RAy8,1557
 stac_fastapi/sfeos_helpers/filter/client.py,sha256=_LX3mlW9MYhoMGxvyi7Eg-LJICElQXYGbzzhSPXYRtw,6517
@@ -23,13 +23,13 @@ stac_fastapi/sfeos_helpers/search_engine/__init__.py,sha256=Bi0cAtul3FuLjFceTPtE
 stac_fastapi/sfeos_helpers/search_engine/base.py,sha256=ww1yCDVuXCK7nIYwmmyxywIvDeB-l5ITVoxkSkdOoT0,2337
 stac_fastapi/sfeos_helpers/search_engine/factory.py,sha256=nPty3L8esypSVIzl5IKfmqQ1hVUIjMQ183Ksistr1bM,1066
 stac_fastapi/sfeos_helpers/search_engine/index_operations.py,sha256=AYc8lJ7TAK9tADw4kHDKvzF3nF8uUaCPPXRhWQzNHFo,7809
-stac_fastapi/sfeos_helpers/search_engine/inserters.py,sha256=HO0jm4zx9sRI_ioWVNQbkSCNeejQHM-8zOZJNHzn_50,13709
+stac_fastapi/sfeos_helpers/search_engine/inserters.py,sha256=spyGwbKLT7u9qOMdOCyPS5zoLh8p4KTEPOOy04Uvrho,13780
 stac_fastapi/sfeos_helpers/search_engine/managers.py,sha256=fODO2aAiRhiuEEJic6JgIIR-RnI-EjUCWse0YkEdvM4,18000
 stac_fastapi/sfeos_helpers/search_engine/selection/__init__.py,sha256=qKd4KzZkERwF_yhIeFcjAUnq5vQarr3CuXxE3SWmt6c,441
 stac_fastapi/sfeos_helpers/search_engine/selection/base.py,sha256=YANRYcosHsZQ1jnkjBUFoNF5V_Xh2efg9BGh411MGxI,1067
 stac_fastapi/sfeos_helpers/search_engine/selection/cache_manager.py,sha256=dLIZRWSQ-t4YWXHDw4pyr1My3G26ewIg53zkKUvWGbo,6086
 stac_fastapi/sfeos_helpers/search_engine/selection/factory.py,sha256=vbgNVCUW2lviePqzpgsPLxp6IEqcX3GHiahqN2oVObA,1305
-stac_fastapi/sfeos_helpers/search_engine/selection/selectors.py,sha256=LH_JZUs_gJSvACLL8BHOg0594ePCQ_XFtG_OSZx5Oj0,7117
-sfeos_helpers-6.10.0.dist-info/METADATA,sha256=0ftfZvtVk3oxJiDcetPSVOqwDy_mi4AsXlv37kzoPH0,3116
-sfeos_helpers-6.10.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-sfeos_helpers-6.10.0.dist-info/RECORD,,
+stac_fastapi/sfeos_helpers/search_engine/selection/selectors.py,sha256=L_NKw1BNNBgu6o6HNupUFinYDFUex2GItr2jABx_0UE,7116
+sfeos_helpers-6.10.1.dist-info/METADATA,sha256=z6T2mi71Kb-r3QHwekALGZSDVf7of943gssfB9---Rs,3116
+sfeos_helpers-6.10.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+sfeos_helpers-6.10.1.dist-info/RECORD,,

stac_fastapi/sfeos_helpers/database/__init__.py

@@ -60,7 +60,14 @@ from .query import (
     apply_intersects_filter_shared,
     populate_sort_shared,
 )
-from .utils import add_bbox_shape_to_collection, get_bool_env, validate_refresh
+from .utils import (
+    ItemAlreadyExistsError,
+    add_bbox_shape_to_collection,
+    check_item_exists_in_alias,
+    check_item_exists_in_alias_sync,
+    get_bool_env,
+    validate_refresh,
+)
 
 __all__ = [
     # Catalog operations
@@ -90,6 +97,10 @@ __all__ = [
     "validate_refresh",
     "get_bool_env",
     "add_bbox_shape_to_collection",
+    "check_item_exists_in_alias",
+    "check_item_exists_in_alias_sync",
+    # Errors
+    "ItemAlreadyExistsError",
     # Datetime utilities
     "return_date",
     "extract_date",

stac_fastapi/sfeos_helpers/database/index.py

@@ -165,7 +165,8 @@ def filter_indexes_by_datetime(
             datetime_alias if use_datetime else start_datetime_alias
         )
 
-        filtered_indexes.append(primary_datetime_alias)
+        if primary_datetime_alias is not None:
+            filtered_indexes.append(primary_datetime_alias)
 
     return filtered_indexes
 

stac_fastapi/sfeos_helpers/database/utils.py

@@ -14,10 +14,73 @@ from stac_fastapi.extensions.core.transaction.request import (
     PatchRemove,
 )
 from stac_fastapi.sfeos_helpers.models.patch import ElasticPath, ESCommandSet
+from stac_fastapi.types.errors import ConflictError
 
 logger = logging.getLogger(__name__)
 
 
+class ItemAlreadyExistsError(ConflictError):
+    """Error raised when attempting to create an item that already exists.
+
+    Attributes:
+        item_id: The ID of the item that already exists.
+        collection_id: The ID of the collection containing the item.
+    """
+
+    def __init__(self, item_id: str, collection_id: str):
+        """Initialize the error with item and collection IDs."""
+        self.item_id = item_id
+        self.collection_id = collection_id
+        message = f"Item {item_id} in collection {collection_id} already exists"
+        super().__init__(message)
+
+
+async def check_item_exists_in_alias(client: Any, alias: str, doc_id: str) -> bool:
+    """Check if an item exists across all indexes for an alias.
+
+    Args:
+        client: The async Elasticsearch/OpenSearch client.
+        alias: The index alias to search against.
+        doc_id: The document ID to check for existence.
+
+    Returns:
+        bool: True if the item exists in any index under the alias, False otherwise.
+    """
+    resp = await client.search(
+        index=alias,
+        body={
+            "query": {"ids": {"values": [doc_id]}},
+            "_source": False,
+        },
+        size=0,
+        terminate_after=1,
+    )
+    return bool(resp["hits"]["total"]["value"])
+
+
+def check_item_exists_in_alias_sync(client: Any, alias: str, doc_id: str) -> bool:
+    """Check if an item exists across all indexes for an alias (sync).
+
+    Args:
+        client: The sync Elasticsearch/OpenSearch client.
+        alias: The index alias to search against.
+        doc_id: The document ID to check for existence.
+
+    Returns:
+        bool: True if the item exists in any index under the alias, False otherwise.
+    """
+    resp = client.search(
+        index=alias,
+        body={
+            "query": {"ids": {"values": [doc_id]}},
+            "_source": False,
+        },
+        size=0,
+        terminate_after=1,
+    )
+    return bool(resp["hits"]["total"]["value"])
+
+
 def add_bbox_shape_to_collection(collection: Dict[str, Any]) -> bool:
     """Add bbox_shape field to a collection document for spatial queries.
 

stac_fastapi/sfeos_helpers/search_engine/inserters.py

@@ -257,8 +257,10 @@ class DatetimeIndexInserter(BaseIndexInserter):
                     extract_date(latest_item["_source"]["properties"]["datetime"])
                 ),
                 end_datetime=str(
-                    extract_date(latest_item["_source"]["properties"]["end_datetime"])
-                ),
+                    extract_first_date_from_index(aliases_dict["end_datetime"])
+                )
+                if aliases_dict.get("end_datetime")
+                else None,
             )
 
             await self.datetime_manager.handle_oversized_index(

stac_fastapi/sfeos_helpers/search_engine/selection/selectors.py

@@ -1,5 +1,4 @@
 """Async index selectors with datetime-based filtering."""
-
 from typing import Any, Dict, List, Optional, Tuple
 
 from stac_fastapi.core.utilities import get_bool_env

stac_fastapi/sfeos_helpers/version.py

@@ -1,2 +1,2 @@
 """library version."""
-__version__ = "6.10.0"
+__version__ = "6.10.1"