Skip HTTP proxy in base class for TCP-only extensions

When all container ports are TCP-only and no host restriction is set,
the base class now skips setting up the catch-all HTTP proxy that would
intercept all requests. This moves the logic from ParadeDB's override
into ProxiedDockerContainerExtension directly.

Also temporarily rewrites localstack-extensions-utils dependencies to
git+https for CI testing of the utils change across all extensions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: whummer

paradedb/localstack_paradedb/extension.py

@@ -3,7 +3,6 @@
 
 from localstack_extensions.utils.docker import ProxiedDockerContainerExtension
 from localstack import config
-from localstack.extensions.api import http
 
 # Environment variables for configuration
 ENV_POSTGRES_USER = "PARADEDB_POSTGRES_USER"
@@ -57,23 +56,6 @@ def _tcp_health_check():
             tcp_ports=[postgres_port],  # Enable TCP proxying through gateway
         )
 
-    # TODO: this should be migrated into the base class directly ..!
-    def update_gateway_routes(self, router: http.Router[http.RouteHandler]):
-        """
-        Override to set up only TCP routing without HTTP proxy.
-
-        ParadeDB uses the native PostgreSQL wire protocol (not HTTP), so we
-        only need TCP protocol routing - not HTTP proxying. Adding an HTTP
-        proxy without a host restriction would cause all HTTP requests to be
-        forwarded to the PostgreSQL container, breaking other services.
-        """
-        # Start the container
-        self.start_container()
-
-        # Set up only TCP protocol routing (skip HTTP proxy from base class)
-        if self.tcp_ports:
-            self._setup_tcp_protocol_routing()
-
     def tcp_connection_matcher(self, data: bytes) -> bool:
         """
         Identify PostgreSQL/ParadeDB connections by protocol handshake.

paradedb/pyproject.toml

@@ -14,7 +14,7 @@ authors = [
 keywords = ["LocalStack", "ParadeDB", "PostgreSQL", "Search", "Analytics"]
 classifiers = []
 dependencies = [
-    "localstack-extensions-utils"
+    "localstack-extensions-utils @ git+https://github.com/localstack/localstack-extensions.git@fix/tcp-only-base-class#egg=localstack-extensions-utils&subdirectory=utils"
 ]
 
 [project.urls]

typedb/pyproject.toml

@@ -14,7 +14,7 @@ authors = [
 keywords = ["LocalStack", "TypeDB"]
 classifiers = []
 dependencies = [
-    "localstack-extensions-utils"
+    "localstack-extensions-utils @ git+https://github.com/localstack/localstack-extensions.git@fix/tcp-only-base-class#egg=localstack-extensions-utils&subdirectory=utils"
 ]
 
 [project.urls]

utils/localstack_extensions/utils/docker.py

@@ -129,11 +129,22 @@ def update_gateway_routes(self, router: http.Router[http.RouteHandler]):
             )
         # note: for simplicity, starting the external container at startup - could be optimized over time ...
         self.start_container()
-        # add resource for HTTP/1.1 requests
-        resource = RuleAdapter(ProxyResource(self.container_host, self.main_port))
-        if self.host:
-            resource = WithHost(self.host, [resource])
-        router.add(resource)
+
+        # Determine if HTTP proxy should be set up. Skip it when all container ports are
+        # TCP-only and no host restriction is set, since a catch-all HTTP proxy would
+        # intercept all requests and break other services.
+        tcp_only = (
+            self.tcp_ports
+            and not self.host
+            and set(self.container_ports) == set(self.tcp_ports)
+        )
+
+        if not tcp_only:
+            # add resource for HTTP/1.1 requests
+            resource = RuleAdapter(ProxyResource(self.container_host, self.main_port))
+            if self.host:
+                resource = WithHost(self.host, [resource])
+            router.add(resource)
 
         # apply patches to serve HTTP/2 requests
         for port in self.http2_ports or []:

wiremock/pyproject.toml

@@ -15,7 +15,7 @@ keywords = ["LocalStack", "WireMock"]
 classifiers = []
 dependencies = [
     "priority",
-    "localstack-extensions-utils"
+    "localstack-extensions-utils @ git+https://github.com/localstack/localstack-extensions.git@fix/tcp-only-base-class#egg=localstack-extensions-utils&subdirectory=utils"
 ]
 
 [project.urls]