# This file was auto-generated by Fern from our API Definition.

import datetime as dt
import typing

from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ..core.request_options import RequestOptions
from ..types.execute_skill_response import ExecuteSkillResponse
from ..types.marketplace_skill_list_response import MarketplaceSkillListResponse
from ..types.marketplace_skill_response import MarketplaceSkillResponse
from ..types.skill_category import SkillCategory
from ..types.skill_response import SkillResponse
from .raw_client import AsyncRawSkillsMarketplaceClient, RawSkillsMarketplaceClient

# this is used as the default value for optional parameters
OMIT = typing.cast(typing.Any, ...)


class SkillsMarketplaceClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._raw_client = RawSkillsMarketplaceClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> RawSkillsMarketplaceClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        RawSkillsMarketplaceClient
        """
        return self._raw_client

    def list_skills(
        self,
        *,
        page_size: typing.Optional[int] = None,
        page_number: typing.Optional[int] = None,
        query: typing.Optional[str] = None,
        category: typing.Optional[SkillCategory] = None,
        from_date: typing.Optional[dt.datetime] = None,
        to_date: typing.Optional[dt.datetime] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> MarketplaceSkillListResponse:
        """
        List all public skills available in the marketplace with optional filtering.

        Parameters
        ----------
        page_size : typing.Optional[int]

        page_number : typing.Optional[int]

        query : typing.Optional[str]

        category : typing.Optional[SkillCategory]

        from_date : typing.Optional[dt.datetime]

        to_date : typing.Optional[dt.datetime]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        MarketplaceSkillListResponse
            Successful Response

        Examples
        --------
        from browser_use_sdk import BrowserUse

        client = BrowserUse(
            api_key="YOUR_API_KEY",
        )
        client.skills_marketplace.list_skills()
        """
        _response = self._raw_client.list_skills(
            page_size=page_size,
            page_number=page_number,
            query=query,
            category=category,
            from_date=from_date,
            to_date=to_date,
            request_options=request_options,
        )
        return _response.data

    def get_skill(
        self, skill_slug: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> MarketplaceSkillResponse:
        """
        Get details of a specific public skill from the marketplace.

        Parameters
        ----------
        skill_slug : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        MarketplaceSkillResponse
            Successful Response

        Examples
        --------
        from browser_use_sdk import BrowserUse

        client = BrowserUse(
            api_key="YOUR_API_KEY",
        )
        client.skills_marketplace.get_skill(
            skill_slug="skill_slug",
        )
        """
        _response = self._raw_client.get_skill(skill_slug, request_options=request_options)
        return _response.data

    def clone_skill(self, skill_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> SkillResponse:
        """
        Clone a public marketplace skill to the user's project.

        Parameters
        ----------
        skill_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        SkillResponse
            Successful Response

        Examples
        --------
        from browser_use_sdk import BrowserUse

        client = BrowserUse(
            api_key="YOUR_API_KEY",
        )
        client.skills_marketplace.clone_skill(
            skill_id="skill_id",
        )
        """
        _response = self._raw_client.clone_skill(skill_id, request_options=request_options)
        return _response.data

    def execute_skill(
        self,
        skill_id: str,
        *,
        parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
        session_id: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExecuteSkillResponse:
        """
        Execute a skill with the provided parameters.

        Parameters
        ----------
        skill_id : str

        parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
            Parameters to pass to the skill handler

        session_id : typing.Optional[str]
            Optional session ID (UUID) for IP persistence.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExecuteSkillResponse
            Successful Response

        Examples
        --------
        from browser_use_sdk import BrowserUse

        client = BrowserUse(
            api_key="YOUR_API_KEY",
        )
        client.skills_marketplace.execute_skill(
            skill_id="skill_id",
        )
        """
        _response = self._raw_client.execute_skill(
            skill_id, parameters=parameters, session_id=session_id, request_options=request_options
        )
        return _response.data


class AsyncSkillsMarketplaceClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._raw_client = AsyncRawSkillsMarketplaceClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> AsyncRawSkillsMarketplaceClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        AsyncRawSkillsMarketplaceClient
        """
        return self._raw_client

    async def list_skills(
        self,
        *,
        page_size: typing.Optional[int] = None,
        page_number: typing.Optional[int] = None,
        query: typing.Optional[str] = None,
        category: typing.Optional[SkillCategory] = None,
        from_date: typing.Optional[dt.datetime] = None,
        to_date: typing.Optional[dt.datetime] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> MarketplaceSkillListResponse:
        """
        List all public skills available in the marketplace with optional filtering.

        Parameters
        ----------
        page_size : typing.Optional[int]

        page_number : typing.Optional[int]

        query : typing.Optional[str]

        category : typing.Optional[SkillCategory]

        from_date : typing.Optional[dt.datetime]

        to_date : typing.Optional[dt.datetime]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        MarketplaceSkillListResponse
            Successful Response

        Examples
        --------
        import asyncio

        from browser_use_sdk import AsyncBrowserUse

        client = AsyncBrowserUse(
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.skills_marketplace.list_skills()


        asyncio.run(main())
        """
        _response = await self._raw_client.list_skills(
            page_size=page_size,
            page_number=page_number,
            query=query,
            category=category,
            from_date=from_date,
            to_date=to_date,
            request_options=request_options,
        )
        return _response.data

    async def get_skill(
        self, skill_slug: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> MarketplaceSkillResponse:
        """
        Get details of a specific public skill from the marketplace.

        Parameters
        ----------
        skill_slug : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        MarketplaceSkillResponse
            Successful Response

        Examples
        --------
        import asyncio

        from browser_use_sdk import AsyncBrowserUse

        client = AsyncBrowserUse(
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.skills_marketplace.get_skill(
                skill_slug="skill_slug",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.get_skill(skill_slug, request_options=request_options)
        return _response.data

    async def clone_skill(
        self, skill_id: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> SkillResponse:
        """
        Clone a public marketplace skill to the user's project.

        Parameters
        ----------
        skill_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        SkillResponse
            Successful Response

        Examples
        --------
        import asyncio

        from browser_use_sdk import AsyncBrowserUse

        client = AsyncBrowserUse(
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.skills_marketplace.clone_skill(
                skill_id="skill_id",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.clone_skill(skill_id, request_options=request_options)
        return _response.data

    async def execute_skill(
        self,
        skill_id: str,
        *,
        parameters: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
        session_id: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExecuteSkillResponse:
        """
        Execute a skill with the provided parameters.

        Parameters
        ----------
        skill_id : str

        parameters : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
            Parameters to pass to the skill handler

        session_id : typing.Optional[str]
            Optional session ID (UUID) for IP persistence.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExecuteSkillResponse
            Successful Response

        Examples
        --------
        import asyncio

        from browser_use_sdk import AsyncBrowserUse

        client = AsyncBrowserUse(
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.skills_marketplace.execute_skill(
                skill_id="skill_id",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.execute_skill(
            skill_id, parameters=parameters, session_id=session_id, request_options=request_options
        )
        return _response.data