# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========

import time
from typing import Any

from mirage.accessor.s3 import S3Accessor
from mirage.cache.index import NULL_INDEX, IndexCacheStore
from mirage.core.s3.client import _client_kwargs, _key, async_session
from mirage.observe.context import record, revision_for
from mirage.types import PathSpec
from mirage.utils.errors import enoent
from mirage.utils.ranges import range_header


def _fp_rev_from_response(
        resp: dict[str, Any]) -> tuple[str | None, str | None]:
    """Extract ``(fingerprint, revision)`` from a boto GET response.

    Args:
        resp (dict): The raw response dict from ``client.get_object``.

    Returns:
        tuple[str | None, str | None]: ``(ETag-without-quotes,
        VersionId)``. ``VersionId`` is None on non-versioned buckets
        (boto returns the literal string ``"null"`` there, which we
        normalize to None).
    """
    etag = resp.get("ETag", "").strip('"') or None
    vid = resp.get("VersionId")
    if vid == "null":
        vid = None
    return etag, vid


async def read_bytes(accessor: S3Accessor,
                     path_spec: PathSpec,
                     index: IndexCacheStore = NULL_INDEX,
                     offset: int = 0,
                     size: int | None = None) -> bytes:
    """Read bytes from S3, with optional range read.

    Args:
        accessor (S3Accessor): S3 accessor.
        path_spec (PathSpec): Object path.
        index: Index cache store.
        offset (int): Byte offset for range reads.
        size (int | None): Number of bytes for range reads.
    """
    virtual = path_spec.virtual
    path = path_spec.mount_path
    config = accessor.config
    key = _key(path, config)
    kwargs = {"Bucket": config.bucket, "Key": key}
    pinned_revision = revision_for(virtual)
    if pinned_revision is not None:
        kwargs["VersionId"] = pinned_revision
    window = range_header(offset, size)
    if window is not None:
        kwargs["Range"] = window
    session = async_session(config)
    start_ms = int(time.monotonic() * 1000)
    try:
        async with session.client(**_client_kwargs(config)) as client:
            resp = await client.get_object(**kwargs)
            data = await resp["Body"].read()
            fingerprint, revision = _fp_rev_from_response(resp)
            record("read",
                   path,
                   "s3",
                   len(data),
                   start_ms,
                   fingerprint=fingerprint,
                   revision=revision)
            return data
    except Exception as exc:
        if (hasattr(exc, "response")
                and exc.response.get("Error", {}).get("Code") == "NoSuchKey"):
            raise enoent(virtual)
        raise
