# ========= 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 dataclasses
from typing import Any

from mirage.accessor.s3 import S3Accessor, S3Config
from mirage.commands.builtin.s3 import COMMANDS as S3_COMMANDS
from mirage.core.s3.constants import SCOPE_ERROR
from mirage.core.s3.copy import copy
from mirage.core.s3.create import create
from mirage.core.s3.du import entries as du_entries
from mirage.core.s3.du import size as du_size
from mirage.core.s3.exists import exists
from mirage.core.s3.find import find
from mirage.core.s3.mkdir import mkdir
from mirage.core.s3.read import read_bytes
from mirage.core.s3.readdir import readdir
from mirage.core.s3.rename import rename
from mirage.core.s3.rm import rm_r
from mirage.core.s3.rmdir import rmdir
from mirage.core.s3.stat import stat as s3_stat
from mirage.core.s3.stream import range_read, read_stream
from mirage.core.s3.truncate import truncate
from mirage.core.s3.unlink import unlink
from mirage.core.s3.watch import build_delta_hook
from mirage.core.s3.write import write_bytes
from mirage.ops.s3 import OPS as S3_OPS
from mirage.resource.base import BaseResource
from mirage.resource.s3.prompt import PROMPT
from mirage.types import PathSpec, ResourceName
from mirage.utils.glob_walk import make_resolve_glob
from mirage.utils.key_prefix import mount_key
from mirage.watch.base import DeltaHook

_resolve_glob = make_resolve_glob(readdir, SCOPE_ERROR)

_S3_OPS = {
    "read_bytes": read_bytes,
    "write": write_bytes,
    "readdir": readdir,
    "stat": s3_stat,
    "unlink": unlink,
    "rmdir": rmdir,
    "copy": copy,
    "rename": rename,
    "mkdir": mkdir,
    "read_stream": read_stream,
    "range_read": range_read,
    "rm_recursive": rm_r,
    "du_size": du_size,
    "du_entries": du_entries,
    "create": create,
    "truncate": truncate,
    "exists": exists,
    "find_flat": find,
}


class S3Resource(BaseResource):

    accessor: S3Accessor
    name: str = ResourceName.S3
    # byte store: stat() sizes every file from metadata
    SIZES_ALWAYS_KNOWN: bool = True
    caches_reads: bool = True
    _ops: dict[str, Any] = _S3_OPS
    PROMPT: str = PROMPT
    SUPPORTS_SNAPSHOT: bool = True

    def __init__(self, config: S3Config) -> None:
        super().__init__()
        self.config = config
        self.accessor = S3Accessor(self.config)
        for fn in S3_COMMANDS:
            self.register(fn)
        for op in S3_OPS:
            self.register_op(op)

    def storage_id(self) -> str:
        # Endpoint, bucket and key prefix pin the object namespace. The
        # endpoint matters because the same bucket name on two providers
        # (AWS vs MinIO vs R2) is two different stores. The prefix joins
        # path-like so two mounts whose prefixes nest still resolve to
        # one key once the mount-relative path is appended.
        cfg = self.config
        prefix = (cfg.key_prefix or "").strip("/")
        base = f"{self.name}:{cfg.endpoint_url or 'aws'}:{cfg.bucket}"
        return f"{base}/{prefix}" if prefix else base

    def delta_hook(self) -> DeltaHook:
        return build_delta_hook(self.accessor)

    async def resolve_glob(
        self,
        paths: list[PathSpec],
        prefix: str = '',
    ) -> list[PathSpec]:
        if prefix:
            paths = [
                dataclasses.replace(p,
                                    resource_path=mount_key(p.virtual, prefix))
                if isinstance(p, PathSpec) else p for p in paths
            ]
        return await _resolve_glob(self.accessor, paths, self._index)

    def get_state(self) -> dict[str, Any]:
        return self.config_state(self.config)

    def load_state(self, state: dict[str, Any]) -> None:
        # No-op: S3Resource holds no local content. Reconstruction
        # happens via the resources= override at load time.
        pass
