chore: checkpoint current backend/runtime changes

backend/src/services/base/supabase.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+from supabase import create_client
+
+from core.config.settings import SupabaseSettings, config
+
+from .service_interface import BaseServiceProvider, register_service_instance
+
+
+class SupabaseService(BaseServiceProvider):
+    def __init__(self, settings: SupabaseSettings | None = None) -> None:
+        super().__init__("supabase")
+        self._settings = settings or config.supabase
+        self._client: Any = None
+        self._admin_client: Any = None
+
+    async def initialize(self, **_: Any) -> bool:
+        try:
+            self._client = create_client(
+                self._settings.url,
+                self._settings.anon_key,
+            )
+            self._admin_client = create_client(
+                self._settings.url,
+                self._settings.service_role_key,
+            )
+            self._set_initialized(True)
+            self.logger.info("Supabase service initialized")
+            return True
+        except Exception as exc:  # noqa: BLE001
+            self.logger.warning("Supabase service initialization failed", error=str(exc))
+            self._client = None
+            self._admin_client = None
+            self._set_initialized(False)
+            return False
+
+    async def close(self) -> bool:
+        self._client = None
+        self._admin_client = None
+        self._set_initialized(False)
+        self.logger.info("Supabase service closed")
+        return True
+
+    async def health_check(self) -> dict[str, Any]:
+        client = self._client
+        admin_client = self._admin_client
+        if client is None or admin_client is None:
+            return {"status": "unhealthy", "details": {"error": "not initialized"}}
+        try:
+            await asyncio.to_thread(client.auth.get_session)
+            await asyncio.to_thread(admin_client.auth.admin.list_users, page=1, per_page=1)
+            return {
+                "status": "healthy",
+                "details": {
+                    "anon_client": "ready",
+                    "admin_client": "ready",
+                },
+            }
+        except Exception as exc:  # noqa: BLE001
+            self.logger.warning("Supabase health check failed", error=str(exc))
+            return {"status": "unhealthy", "details": {"error": str(exc)}}
+
+    def get_client(self) -> Any:
+        return self._require_client()
+
+    def get_admin_client(self) -> Any:
+        return self._require_admin_client()
+
+    def _require_client(self) -> Any:
+        client = self._client
+        if client is None:
+            raise RuntimeError("Supabase client is not initialized")
+        return client
+
+    def _require_admin_client(self) -> Any:
+        admin_client = self._admin_client
+        if admin_client is None:
+            raise RuntimeError("Supabase admin client is not initialized")
+        return admin_client
+
+
+supabase_service: SupabaseService = register_service_instance(
+    "supabase", SupabaseService()
+)
+
+__all__ = ["SupabaseService", "supabase_service"]