Merge branch 'main' into CAT-1449

Author: YuriZmytrakov

CHANGELOG.md

@@ -19,6 +19,16 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Updated
 
+## [v6.7.3] - 2025-11-07
+
+### Added
+
+- Added validator for `REDIS_MAX_CONNECTIONS` to handle empty or null-like values ("", "null", None) and return None instead. [#519](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/519)
+
+### Removed
+
+- Removed `/collections-search` endpoint from default landing page. It now only shows when `ENABLE_COLLECTIONS_SEARCH_ROUTE` is set to `True`. [#524](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/524)
+
 ## [v6.7.2] - 2025-11-04
 
 ### Fixed
@@ -623,7 +633,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Use genexp in execute_search and get_all_collections to return results.
 - Added db_to_stac serializer to item_collection method in core.py.
 
-[Unreleased]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.7.2...main
+[Unreleased]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.7.3...main
+[v6.7.3]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.7.2...v6.7.3
 [v6.7.2]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.7.1...v6.7.2
 [v6.7.1]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.7.0...v6.7.1
 [v6.7.0]: https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/compare/v6.6.0...v6.7.0

README.md

@@ -30,6 +30,7 @@ The following organizations have contributed time and/or funding to support the
 
 ## Latest News
 
+- **11/07/2025:** 🌍 The SFEOS STAC Viewer is now available at: https://healy-hyperspatial.github.io/sfeos-web. Use this site to examine your data and test your STAC API!
 - **10/24/2025:** Added `previous_token` pagination using Redis for efficient navigation. This feature allows users to navigate backwards through large result sets by storing pagination state in Redis. To use this feature, ensure Redis is configured (see [Redis for navigation](#redis-for-navigation)) and set `REDIS_ENABLE=true` in your environment.
 - **10/23/2025:** The `EXCLUDED_FROM_QUERYABLES` environment variable was added to exclude fields from the `queryables` endpoint. See [docs](#excluding-fields-from-queryables).
 - **10/15/2025:** 🚀 SFEOS Tools v0.1.0 Released! - The new `sfeos-tools` CLI is now available on [PyPI](https://pypi.org/project/sfeos-tools/)
@@ -94,6 +95,7 @@ This project is built on the following technologies: STAC, stac-fastapi, FastAPI
   - [Table of Contents](#table-of-contents)
   - [Collection Search Extensions](#collection-search-extensions)
   - [Documentation & Resources](#documentation--resources)
+  - [SFEOS STAC Viewer](#sfeos-stac-viewer)
   - [Package Structure](#package-structure)
   - [Examples](#examples)
   - [Performance](#performance)
@@ -137,6 +139,31 @@ This project is built on the following technologies: STAC, stac-fastapi, FastAPI
   - [Gitter Chat](https://app.gitter.im/#/room/#stac-fastapi-elasticsearch_community:gitter.im) - For real-time discussions
   - [GitHub Discussions](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/discussions) - For longer-form questions and answers
 
+## SFEOS STAC Viewer
+
+The SFEOS STAC viewer is a web-based application for examining and testing STAC APIs. It provides an interactive interface to explore geospatial data catalogs, visualize spatial extents, and test API endpoints.
+
+### Access
+
+The viewer is available at: https://healy-hyperspatial.github.io/sfeos-web/
+
+### Features
+
+- Browse collections and items interactively
+- Interactive map visualization of spatial extents
+- Test API endpoints directly from the interface
+- Search and filter capabilities for exploring data
+
+### Usage
+
+Navigate to the URL above and connect to your SFEOS API instance by providing the base URL of your STAC API. This is done with the `API SERVER` button on the right side of the page. 
+
+You can also override the default STAC API URL by appending the `stacApiUrl` parameter to the application URL. For example:
+
+https://healy-hyperspatial.github.io/sfeos-web?stacApiUrl=http://localhost:8080
+
+**Note**: The parameter name `stacApiUrl` is case-sensitive. This allows you to connect to different STAC API servers without modifying the web app configuration.
+
 ## Collection Search Extensions
 
 SFEOS provides enhanced collection search capabilities through two primary routes:

stac_fastapi/core/stac_fastapi/core/core.py

@@ -137,20 +137,6 @@ def _landing_page(
                     "href": urljoin(base_url, "search"),
                     "method": "POST",
                 },
-                {
-                    "rel": "collections-search",
-                    "type": "application/json",
-                    "title": "Collections Search",
-                    "href": urljoin(base_url, "collections-search"),
-                    "method": "GET",
-                },
-                {
-                    "rel": "collections-search",
-                    "type": "application/json",
-                    "title": "Collections Search",
-                    "href": urljoin(base_url, "collections-search"),
-                    "method": "POST",
-                },
             ],
             stac_extensions=extension_schemas,
         )
@@ -202,6 +188,26 @@ async def landing_page(self, **kwargs) -> stac_types.LandingPage:
                 ]
             )
 
+        if self.extension_is_enabled("CollectionsSearchEndpointExtension"):
+            landing_page["links"].extend(
+                [
+                    {
+                        "rel": "collections-search",
+                        "type": "application/json",
+                        "title": "Collections Search",
+                        "href": urljoin(base_url, "collections-search"),
+                        "method": "GET",
+                    },
+                    {
+                        "rel": "collections-search",
+                        "type": "application/json",
+                        "title": "Collections Search",
+                        "href": urljoin(base_url, "collections-search"),
+                        "method": "POST",
+                    },
+                ]
+            )
+
         # Add OpenAPI URL
         landing_page["links"].append(
             {

stac_fastapi/core/stac_fastapi/core/redis_utils.py

@@ -36,6 +36,14 @@ def validate_db_sentinel(cls, v: int) -> int:
             raise ValueError("REDIS_DB must be a positive integer")
         return v
 
+    @field_validator("REDIS_MAX_CONNECTIONS", mode="before")
+    @classmethod
+    def validate_max_connections(cls, v):
+        """Handle empty/None values for REDIS_MAX_CONNECTIONS."""
+        if v in ["", "null", "Null", "NULL", "none", "None", "NONE", None]:
+            return None
+        return v
+
     @field_validator("REDIS_SELF_LINK_TTL")
     @classmethod
     def validate_self_link_ttl_sentinel(cls, v: int) -> int:
@@ -118,6 +126,14 @@ def validate_db_standalone(cls, v: int) -> int:
             raise ValueError("REDIS_DB must be a positive integer")
         return v
 
+    @field_validator("REDIS_MAX_CONNECTIONS", mode="before")
+    @classmethod
+    def validate_max_connections(cls, v):
+        """Handle empty/None values for REDIS_MAX_CONNECTIONS."""
+        if v in ["", "null", "Null", "NULL", "none", "None", "NONE", None]:
+            return None
+        return v
+
     @field_validator("REDIS_SELF_LINK_TTL")
     @classmethod
     def validate_self_link_ttl_standalone(cls, v: int) -> int:

stac_fastapi/core/stac_fastapi/core/version.py

@@ -1,2 +1,2 @@
 """library version."""
-__version__ = "6.7.2"
+__version__ = "6.7.3"

stac_fastapi/elasticsearch/pyproject.toml

@@ -30,8 +30,8 @@ keywords = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "stac-fastapi-core==6.7.2",
-    "sfeos-helpers==6.7.2",
+    "stac-fastapi-core==6.7.3",
+    "sfeos-helpers==6.7.3",
     "elasticsearch[async]~=8.19.1",
     "uvicorn~=0.23.0",
     "starlette>=0.35.0,<0.36.0",

stac_fastapi/elasticsearch/stac_fastapi/elasticsearch/version.py

@@ -1,2 +1,2 @@
 """library version."""
-__version__ = "6.7.2"
+__version__ = "6.7.3"

stac_fastapi/opensearch/pyproject.toml

@@ -30,8 +30,8 @@ keywords = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "stac-fastapi-core==6.7.2",
-    "sfeos-helpers==6.7.2",
+    "stac-fastapi-core==6.7.3",
+    "sfeos-helpers==6.7.3",
     "opensearch-py~=2.8.0",
     "opensearch-py[async]~=2.8.0",
     "uvicorn~=0.23.0",

stac_fastapi/opensearch/stac_fastapi/opensearch/version.py

@@ -1,2 +1,2 @@
 """library version."""
-__version__ = "6.7.2"
+__version__ = "6.7.3"

stac_fastapi/sfeos_helpers/pyproject.toml

@@ -31,7 +31,7 @@ keywords = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "stac-fastapi.core==6.7.2",
+    "stac-fastapi.core==6.7.3",
 ]
 
 [project.urls]