src/hyperview/storage/memory_backend.py

"""In-memory storage backend for testing and development."""

import time
from collections.abc import Callable, Iterator

import numpy as np

from hyperview.core.sample import Sample
from hyperview.storage.backend import StorageBackend
from hyperview.storage.schema import LayoutInfo, SpaceInfo, make_space_key


class MemoryBackend(StorageBackend):
    """In-memory storage backend for testing and development."""

    def __init__(self, dataset_name: str):
        self.dataset_name = dataset_name
        self._samples: dict[str, Sample] = {}
        self._spaces: dict[str, SpaceInfo] = {}
        self._embeddings: dict[str, dict[str, np.ndarray]] = {}
        self._layout_registry: dict[str, LayoutInfo] = {}
        self._layouts: dict[str, dict[str, tuple[float, float]]] = {}

    def add_sample(self, sample: Sample) -> None:
        self._samples[sample.id] = sample

    def add_samples_batch(self, samples: list[Sample]) -> None:
        for sample in samples:
            self._samples[sample.id] = sample

    def get_sample(self, sample_id: str) -> Sample | None:
        return self._samples.get(sample_id)

    def get_samples_paginated(
        self,
        offset: int = 0,
        limit: int = 100,
        label: str | None = None,
    ) -> tuple[list[Sample], int]:
        samples = list(self._samples.values())
        if label:
            samples = [s for s in samples if s.label == label]
        total = len(samples)
        return samples[offset : offset + limit], total

    def get_all_samples(self) -> list[Sample]:
        return list(self._samples.values())

    def update_sample(self, sample: Sample) -> None:
        self._samples[sample.id] = sample

    def update_samples_batch(self, samples: list[Sample]) -> None:
        for sample in samples:
            self._samples[sample.id] = sample

    def delete_sample(self, sample_id: str) -> bool:
        if sample_id in self._samples:
            del self._samples[sample_id]
            return True
        return False

    def __len__(self) -> int:
        return len(self._samples)

    def __iter__(self) -> Iterator[Sample]:
        return iter(self._samples.values())

    def __contains__(self, sample_id: str) -> bool:
        return sample_id in self._samples

    def get_unique_labels(self) -> list[str]:
        return sorted({s.label for s in self._samples.values() if s.label})

    def get_existing_ids(self, sample_ids: list[str]) -> set[str]:
        return {sid for sid in sample_ids if sid in self._samples}

    def get_samples_by_ids(self, sample_ids: list[str]) -> list[Sample]:
        return [s for sid in sample_ids if (s := self._samples.get(sid)) is not None]

    def get_labels_by_ids(self, sample_ids: list[str]) -> dict[str, str | None]:
        return {sid: s.label for sid in sample_ids if (s := self._samples.get(sid)) is not None}

    def filter(self, predicate: Callable[[Sample], bool]) -> list[Sample]:
        return [s for s in self._samples.values() if predicate(s)]

    def list_spaces(self) -> list[SpaceInfo]:
        return list(self._spaces.values())

    def get_space(self, space_key: str) -> SpaceInfo | None:
        return self._spaces.get(space_key)

    def ensure_space(
        self,
        model_id: str,
        dim: int,
        config: dict | None = None,
        space_key: str | None = None,
    ) -> SpaceInfo:
        if space_key is None:
            space_key = make_space_key(model_id)
        if space_key in self._spaces:
            existing = self._spaces[space_key]
            if existing.dim != dim:
                raise ValueError(f"Space '{space_key}' exists with dim={existing.dim}, requested dim={dim}")
            return existing

        now = int(time.time())
        space_info = SpaceInfo(
            space_key=space_key,
            model_id=model_id,
            dim=dim,
            count=0,
            created_at=now,
            updated_at=now,
            config=config,
        )
        self._spaces[space_key] = space_info
        self._embeddings[space_key] = {}
        return space_info

    def delete_space(self, space_key: str) -> bool:
        if space_key in self._spaces:
            del self._spaces[space_key]
            self._embeddings.pop(space_key, None)
            return True
        return False

    def add_embeddings(self, space_key: str, ids: list[str], vectors: np.ndarray) -> None:
        if len(ids) != len(vectors) or len(ids) == 0:
            return
        if space_key not in self._spaces:
            raise ValueError(f"Space not found: {space_key}")

        space = self._spaces[space_key]
        emb_store = self._embeddings.setdefault(space_key, {})
        for id_, vec in zip(ids, vectors):
            emb_store[id_] = vec.astype(np.float32)
        space.count = len(emb_store)
        space.updated_at = int(time.time())

    def get_embeddings(self, space_key: str, ids: list[str] | None = None) -> tuple[list[str], np.ndarray]:
        if space_key not in self._spaces:
            raise ValueError(f"Space not found: {space_key}")

        space = self._spaces[space_key]
        emb_store = self._embeddings.get(space_key, {})

        if ids is not None:
            out_ids = [id_ for id_ in ids if id_ in emb_store]
        else:
            out_ids = list(emb_store.keys())

        if not out_ids:
            return [], np.empty((0, space.dim), dtype=np.float32)
        return out_ids, np.array([emb_store[id_] for id_ in out_ids], dtype=np.float32)

    def get_embedded_ids(self, space_key: str) -> set[str]:
        return set(self._embeddings.get(space_key, {}).keys())

    def get_missing_embedding_ids(self, space_key: str) -> list[str]:
        embedded = self.get_embedded_ids(space_key)
        return [id_ for id_ in self._samples.keys() if id_ not in embedded]

    def list_layouts(self) -> list[LayoutInfo]:
        return list(self._layout_registry.values())

    def get_layout(self, layout_key: str) -> LayoutInfo | None:
        return self._layout_registry.get(layout_key)

    def ensure_layout(
        self,
        layout_key: str,
        space_key: str,
        method: str,
        geometry: str,
        params: dict | None = None,
    ) -> LayoutInfo:
        if layout_key in self._layout_registry:
            return self._layout_registry[layout_key]

        layout_info = LayoutInfo(
            layout_key=layout_key,
            space_key=space_key,
            method=method,
            geometry=geometry,
            count=0,
            created_at=int(time.time()),
            params=params,
        )
        self._layout_registry[layout_key] = layout_info
        self._layouts[layout_key] = {}
        return layout_info

    def delete_layout(self, layout_key: str) -> bool:
        deleted = layout_key in self._layouts or layout_key in self._layout_registry
        self._layouts.pop(layout_key, None)
        self._layout_registry.pop(layout_key, None)
        return deleted

    def add_layout_coords(self, layout_key: str, ids: list[str], coords: np.ndarray) -> None:
        if len(ids) != len(coords):
            raise ValueError("ids and coords must have same length")
        if layout_key not in self._layout_registry:
            raise ValueError(f"Layout '{layout_key}' not registered")

        layout_store = self._layouts.setdefault(layout_key, {})
        for id_, coord in zip(ids, coords):
            layout_store[id_] = (float(coord[0]), float(coord[1]))
        self._layout_registry[layout_key].count = len(layout_store)

    def get_layout_coords(self, layout_key: str, ids: list[str] | None = None) -> tuple[list[str], np.ndarray]:
        layout_store = self._layouts.get(layout_key, {})
        out_ids = [id_ for id_ in ids if id_ in layout_store] if ids is not None else list(layout_store.keys())
        if not out_ids:
            return [], np.empty((0, 2), dtype=np.float32)
        return out_ids, np.array([layout_store[id_] for id_ in out_ids], dtype=np.float32)

    def get_lasso_candidates_aabb(
        self,
        *,
        layout_key: str,
        x_min: float,
        x_max: float,
        y_min: float,
        y_max: float,
    ) -> tuple[list[str], np.ndarray]:
        layout_store = self._layouts.get(layout_key, {})
        ids, coords = [], []
        for id_, (x, y) in layout_store.items():
            if x_min <= x <= x_max and y_min <= y <= y_max:
                ids.append(id_)
                coords.append([x, y])
        return ids, np.array(coords, dtype=np.float32) if coords else np.empty((0, 2), dtype=np.float32)

    def find_similar(self, sample_id: str, k: int = 10, space_key: str | None = None) -> list[tuple[Sample, float]]:
        if space_key is None:
            if not self._spaces:
                raise ValueError("No embedding spaces available")
            space_key = next(iter(self._spaces))

        emb_store = self._embeddings.get(space_key, {})
        if sample_id not in emb_store:
            raise ValueError(f"Sample {sample_id} has no embedding in space {space_key}")

        results = self.find_similar_by_vector(emb_store[sample_id], k + 1, space_key)
        return [(s, d) for s, d in results if s.id != sample_id][:k]

    def find_similar_by_vector(
        self,
        vector: list[float] | np.ndarray,
        k: int = 10,
        space_key: str | None = None,
    ) -> list[tuple[Sample, float]]:
        if space_key is None:
            if not self._spaces:
                raise ValueError("No embedding spaces available")
            space_key = next(iter(self._spaces))

        emb_store = self._embeddings.get(space_key, {})
        query = np.array(vector, dtype=np.float32)
        norm_query = np.linalg.norm(query)

        distances: list[tuple[Sample, float]] = []
        for id_, vec in emb_store.items():
            sample = self._samples.get(id_)
            if sample is None:
                continue
            norm_vec = np.linalg.norm(vec)
            if norm_query == 0 or norm_vec == 0:
                distance = 1.0
            else:
                distance = 1 - np.dot(query, vec) / (norm_query * norm_vec)
            distances.append((sample, float(distance)))

        distances.sort(key=lambda x: x[1])
        return distances[:k]

    def close(self) -> None:
        pass