Create user client (#34)

* Create user client

* update

* model init

* model init

* model init

* alias

Author: heyitsaamir

packages/api/src/microsoft/teams/api/clients/__init__.py

@@ -7,8 +7,11 @@
 from .bot import __all__ as bot_all
 from .conversation import *  # noqa: F403
 from .conversation import __all__ as conversation_all
+from .user import *  # noqa: F403
+from .user import __all__ as user_all
 
 __all__ = [
     *conversation_all,
+    *user_all,
     *bot_all,
 ]

packages/api/src/microsoft/teams/api/clients/base_client.py

@@ -17,7 +17,12 @@ def __init__(self, options: Optional[Union[Client, ClientOptions]] = None) -> No
         Args:
             options: Optional Client or ClientOptions instance. If not provided, a default Client will be created.
         """
-        self._http = Client(options or ClientOptions())
+        if options is None:
+            self._http = Client(ClientOptions())
+        elif isinstance(options, Client):
+            self._http = options
+        else:
+            self._http = Client(options)
 
     @property
     def http(self) -> Client:

packages/api/src/microsoft/teams/api/clients/bot/client.py

@@ -24,3 +24,15 @@ def __init__(self, options: Optional[Union[Client, ClientOptions]] = None) -> No
         super().__init__(options)
         self.token = BotTokenClient(self.http)
         self.sign_in = BotSignInClient(self.http)
+
+    @property
+    def http(self) -> Client:
+        """Get the HTTP client instance."""
+        return self._http
+
+    @http.setter
+    def http(self, value: Client) -> None:
+        """Set the HTTP client instance and propagate to sub-clients."""
+        self._http = value
+        self.token.http = value
+        self.sign_in.http = value

packages/api/src/microsoft/teams/api/clients/bot/params.py

@@ -5,15 +5,15 @@
 
 from typing import Optional
 
-from pydantic import AliasGenerator, BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict
 from pydantic.alias_generators import to_camel
 
 
 class GetBotSignInUrlParams(BaseModel):
     """Parameters for getting a bot sign-in URL."""
 
     model_config = ConfigDict(
-        alias_generator=AliasGenerator(serialization_alias=to_camel),
+        alias_generator=to_camel,
         extra="allow",
     )
 
@@ -39,7 +39,7 @@ class GetBotSignInResourceParams(BaseModel):
     """Parameters for getting a bot sign-in resource."""
 
     model_config = ConfigDict(
-        alias_generator=AliasGenerator(serialization_alias=to_camel),
+        alias_generator=to_camel,
         extra="allow",
     )
 

packages/api/src/microsoft/teams/api/clients/conversation/client.py

@@ -74,6 +74,18 @@ def __init__(self, service_url: str, options: Optional[Union[Client, ClientOptio
         self._activities = ConversationActivityClient(service_url, self.http)
         self._members = ConversationMemberClient(service_url, self.http)
 
+    @property
+    def http(self) -> Client:
+        """Get the HTTP client instance."""
+        return self._http
+
+    @http.setter
+    def http(self, value: Client) -> None:
+        """Set the HTTP client instance and propagate to sub-clients."""
+        self._http = value
+        self._activities.http = value
+        self._members.http = value
+
     def activities(self, conversation_id: str) -> ActivityOperations:
         """Get activity operations for a conversation.
 

packages/api/src/microsoft/teams/api/clients/user/__init__.py

@@ -0,0 +1,24 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from .client import UserClient
+from .params import (
+    ExchangeUserTokenParams,
+    GetUserAADTokenParams,
+    GetUserTokenParams,
+    GetUserTokenStatusParams,
+    SignOutUserParams,
+)
+from .token_client import UserTokenClient
+
+__all__ = [
+    "UserClient",
+    "UserTokenClient",
+    "GetUserTokenParams",
+    "GetUserAADTokenParams",
+    "GetUserTokenStatusParams",
+    "SignOutUserParams",
+    "ExchangeUserTokenParams",
+]

packages/api/src/microsoft/teams/api/clients/user/client.py

@@ -0,0 +1,37 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from typing import Optional, Union
+
+from microsoft.teams.common.http import Client, ClientOptions
+
+from ..base_client import BaseClient
+from .token_client import UserTokenClient
+
+
+class UserClient(BaseClient):
+    """Client for managing Teams users."""
+
+    def __init__(self, options: Optional[Union[Client, ClientOptions]] = None) -> None:
+        """
+        Initialize the UserClient.
+
+        Args:
+            options: Optional Client or ClientOptions instance. If not provided, a default Client will be created.
+        """
+        super().__init__(options)
+
+        self.token = UserTokenClient(self.http)
+
+    @property
+    def http(self) -> Client:
+        """Get the HTTP client instance."""
+        return self._http
+
+    @http.setter
+    def http(self, value: Client) -> None:
+        """Set the HTTP client instance and propagate to sub-clients."""
+        self._http = value
+        self.token.http = value

packages/api/src/microsoft/teams/api/clients/user/params.py

@@ -0,0 +1,143 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from typing import List, Optional
+
+from pydantic import AliasGenerator, BaseModel, ConfigDict
+from pydantic.alias_generators import to_camel
+
+from ...models import ChannelID, TokenExchangeRequest
+
+
+class GetUserTokenParams(BaseModel):
+    """Parameters for getting a user token."""
+
+    model_config = ConfigDict(
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+        extra="allow",
+    )
+
+    user_id: str
+    """
+    The user ID.
+    """
+    connection_name: str
+    """
+    The connection name.
+    """
+    channel_id: Optional[ChannelID] = None
+    """
+    The channel ID.
+    """
+    code: Optional[str] = None
+    """
+    The authorization code.
+    """
+
+
+class GetUserAADTokenParams(BaseModel):
+    """Parameters for getting AAD tokens for a user."""
+
+    model_config = ConfigDict(
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+        extra="allow",
+    )
+
+    user_id: str
+    """
+    The user ID.
+    """
+    connection_name: str
+    """
+    The connection name.
+    """
+    resource_urls: List[str]
+    """
+    The resource URLs.
+    """
+    channel_id: ChannelID
+    """
+    The channel ID.
+    """
+
+
+class GetUserTokenStatusParams(BaseModel):
+    """Parameters for getting token status for a user."""
+
+    model_config = ConfigDict(
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+        extra="allow",
+    )
+
+    user_id: str
+    """
+    The user ID.
+    """
+    channel_id: ChannelID
+    """
+    The channel ID.
+    """
+    include_filter: str
+    """
+    The include filter.
+    """
+
+
+class SignOutUserParams(BaseModel):
+    """Parameters for signing out a user."""
+
+    model_config = ConfigDict(
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+        extra="allow",
+    )
+
+    user_id: str
+    """
+    The user ID.
+    """
+    connection_name: str
+    """
+    The connection name.
+    """
+    channel_id: ChannelID
+    """
+    The channel ID.
+    """
+
+
+class ExchangeUserTokenParams(BaseModel):
+    """Parameters for exchanging a user token."""
+
+    model_config = ConfigDict(
+        alias_generator=AliasGenerator(
+            serialization_alias=to_camel,
+        ),
+        extra="allow",
+    )
+
+    user_id: str
+    """
+    The user ID.
+    """
+    connection_name: str
+    """
+    The connection name.
+    """
+    channel_id: ChannelID
+    """
+    The channel ID.
+    """
+    exchange_request: TokenExchangeRequest
+    """
+    The token exchange request.
+    """