kard-financial-sdk 0.0.78939__py3-none-any.whl → 1.0.0__py3-none-any.whl

kard/core/client_wrapper.py

@@ -22,10 +22,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "kard-financial-sdk/0.0.78939",
+            "User-Agent": "kard-financial-sdk/1.0.0",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "kard-financial-sdk",
-            "X-Fern-SDK-Version": "0.0.78939",
+            "X-Fern-SDK-Version": "1.0.0",
             **(self.get_custom_headers() or {}),
         }
         token = self._get_token()

kard/users/__init__.py

@@ -20,7 +20,7 @@ if typing.TYPE_CHECKING:
         UserResponseUnionNoData_User,
     )
     from .errors import MultiStatus
-    from . import attributions, rewards, uploads
+    from . import attributions, auth, rewards, uploads
     from .attributions import (
         CreateAttributionRequestObject,
         CreateAttributionRequestUnion,
@@ -35,6 +35,7 @@ if typing.TYPE_CHECKING:
         OfferAttributionRequest,
         OfferMedium,
     )
+    from .auth import WebviewTokenResponse
     from .rewards import (
         Amount,
         AmountType,
@@ -178,7 +179,9 @@ _dynamic_imports: typing.Dict[str, str] = {
     "UserResponseNoData": ".types",
     "UserResponseUnionNoData": ".types",
     "UserResponseUnionNoData_User": ".types",
+    "WebviewTokenResponse": ".auth",
     "attributions": ".attributions",
+    "auth": ".auth",
     "rewards": ".rewards",
     "uploads": ".uploads",
 }
@@ -287,7 +290,9 @@ __all__ = [
     "UserResponseNoData",
     "UserResponseUnionNoData",
     "UserResponseUnionNoData_User",
+    "WebviewTokenResponse",
     "attributions",
+    "auth",
     "rewards",
     "uploads",
 ]

kard/users/auth/__init__.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import WebviewTokenResponse
+_dynamic_imports: typing.Dict[str, str] = {"WebviewTokenResponse": ".types"}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["WebviewTokenResponse"]

kard/users/auth/client.py

@@ -0,0 +1,128 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ...commons.types.organization_id import OrganizationId
+from ...commons.types.user_id import UserId
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.request_options import RequestOptions
+from .raw_client import AsyncRawAuthClient, RawAuthClient
+from .types.webview_token_response import WebviewTokenResponse
+
+
+class AuthClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAuthClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAuthClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAuthClient
+        """
+        return self._raw_client
+
+    def get_webview_token(
+        self,
+        organization_id: OrganizationId,
+        user_id: UserId,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> WebviewTokenResponse:
+        """
+        Retrieves an OAuth token for webview authentication.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : UserId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WebviewTokenResponse
+
+        Examples
+        --------
+        from kard import KardApi
+
+        client = KardApi(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.users.auth.get_webview_token(
+            organization_id="organization-123",
+            user_id="user-123",
+        )
+        """
+        _response = self._raw_client.get_webview_token(organization_id, user_id, request_options=request_options)
+        return _response.data
+
+
+class AsyncAuthClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAuthClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAuthClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAuthClient
+        """
+        return self._raw_client
+
+    async def get_webview_token(
+        self,
+        organization_id: OrganizationId,
+        user_id: UserId,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> WebviewTokenResponse:
+        """
+        Retrieves an OAuth token for webview authentication.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : UserId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        WebviewTokenResponse
+
+        Examples
+        --------
+        import asyncio
+
+        from kard import AsyncKardApi
+
+        client = AsyncKardApi(
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.users.auth.get_webview_token(
+                organization_id="organization-123",
+                user_id="user-123",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_webview_token(organization_id, user_id, request_options=request_options)
+        return _response.data

kard/users/auth/raw_client.py

@@ -0,0 +1,157 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ...commons.errors.internal_server_error import InternalServerError
+from ...commons.errors.unauthorized_error import UnauthorizedError
+from ...commons.types.error_response import ErrorResponse
+from ...commons.types.organization_id import OrganizationId
+from ...commons.types.user_id import UserId
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.pydantic_utilities import parse_obj_as
+from ...core.request_options import RequestOptions
+from .types.webview_token_response import WebviewTokenResponse
+
+
+class RawAuthClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get_webview_token(
+        self,
+        organization_id: OrganizationId,
+        user_id: UserId,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[WebviewTokenResponse]:
+        """
+        Retrieves an OAuth token for webview authentication.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : UserId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[WebviewTokenResponse]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/auth/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/token",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    WebviewTokenResponse,
+                    parse_obj_as(
+                        type_=WebviewTokenResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawAuthClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get_webview_token(
+        self,
+        organization_id: OrganizationId,
+        user_id: UserId,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[WebviewTokenResponse]:
+        """
+        Retrieves an OAuth token for webview authentication.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : UserId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[WebviewTokenResponse]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/auth/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/token",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    WebviewTokenResponse,
+                    parse_obj_as(
+                        type_=WebviewTokenResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

kard/users/auth/types/__init__.py

@@ -0,0 +1,34 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .webview_token_response import WebviewTokenResponse
+_dynamic_imports: typing.Dict[str, str] = {"WebviewTokenResponse": ".webview_token_response"}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["WebviewTokenResponse"]

kard/users/auth/types/webview_token_response.py

@@ -0,0 +1,35 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ....core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class WebviewTokenResponse(UniversalBaseModel):
+    """
+    An OAuth token response.
+
+    Examples
+    --------
+    from kard.users.auth import WebviewTokenResponse
+
+    WebviewTokenResponse(
+        access_token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+        expires_in=3600,
+        token_type="Bearer",
+    )
+    """
+
+    access_token: str
+    expires_in: int
+    token_type: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

kard/users/client.py

@@ -16,6 +16,7 @@ from .types.user_request_data_union import UserRequestDataUnion
 
 if typing.TYPE_CHECKING:
     from .attributions.client import AsyncAttributionsClient, AttributionsClient
+    from .auth.client import AsyncAuthClient, AuthClient
     from .rewards.client import AsyncRewardsClient, RewardsClient
     from .uploads.client import AsyncUploadsClient, UploadsClient
 # this is used as the default value for optional parameters
@@ -27,6 +28,7 @@ class UsersClient:
         self._raw_client = RawUsersClient(client_wrapper=client_wrapper)
         self._client_wrapper = client_wrapper
         self._attributions: typing.Optional[AttributionsClient] = None
+        self._auth: typing.Optional[AuthClient] = None
         self._rewards: typing.Optional[RewardsClient] = None
         self._uploads: typing.Optional[UploadsClient] = None
 
@@ -234,6 +236,14 @@ class UsersClient:
             self._attributions = AttributionsClient(client_wrapper=self._client_wrapper)
         return self._attributions
 
+    @property
+    def auth(self):
+        if self._auth is None:
+            from .auth.client import AuthClient  # noqa: E402
+
+            self._auth = AuthClient(client_wrapper=self._client_wrapper)
+        return self._auth
+
     @property
     def rewards(self):
         if self._rewards is None:
@@ -256,6 +266,7 @@ class AsyncUsersClient:
         self._raw_client = AsyncRawUsersClient(client_wrapper=client_wrapper)
         self._client_wrapper = client_wrapper
         self._attributions: typing.Optional[AsyncAttributionsClient] = None
+        self._auth: typing.Optional[AsyncAuthClient] = None
         self._rewards: typing.Optional[AsyncRewardsClient] = None
         self._uploads: typing.Optional[AsyncUploadsClient] = None
 
@@ -495,6 +506,14 @@ class AsyncUsersClient:
             self._attributions = AsyncAttributionsClient(client_wrapper=self._client_wrapper)
         return self._attributions
 
+    @property
+    def auth(self):
+        if self._auth is None:
+            from .auth.client import AsyncAuthClient  # noqa: E402
+
+            self._auth = AsyncAuthClient(client_wrapper=self._client_wrapper)
+        return self._auth
+
     @property
     def rewards(self):
         if self._rewards is None:

{kard_financial_sdk-0.0.78939.dist-info → kard_financial_sdk-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kard-financial-sdk
-Version: 0.0.78939
+Version: 1.0.0
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{kard_financial_sdk-0.0.78939.dist-info → kard_financial_sdk-1.0.0.dist-info}/RECORD

@@ -39,7 +39,7 @@ kard/commons/types/subscription_id.py,sha256=ftC0pKiUnQhd0vuGIjrK9NDTQeAjPALtrYb
 kard/commons/types/user_id.py,sha256=S2yE4rCRcapLUQ4_49O2n-Ph5Bm8uywFdnSXSz-otCU,78
 kard/core/__init__.py,sha256=GkNNgA0CeqvpCzo2vVtAafE8YcnGV-VGtbU5op93lbc,3624
 kard/core/api_error.py,sha256=44vPoTyWN59gonCIZMdzw7M1uspygiLnr3GNFOoVL2Q,614
-kard/core/client_wrapper.py,sha256=Q1JK8rzgnMKvi0aoh-knZ9PJubYtOFHnR3o7kjXdaI0,3293
+kard/core/client_wrapper.py,sha256=u8pDJtUskT2TK71RWfilZXZsI_FAIJ9ToXsfcd5spFU,3285
 kard/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 kard/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 kard/core/force_multipart.py,sha256=cH981xLy0kZVKiZZkFoeUjgJ2Zuq7KXB2aRAnmHzRDc,477
@@ -208,7 +208,7 @@ kard/transactions/types/transactions_response.py,sha256=J_GYrJ3Rs8fXakrdrlzemMaF
 kard/transactions/types/transactions_response_data.py,sha256=nHFzk-sgUHea2c-LZ5cH5sNTUXMB2RNF5pUcNsFdwzA,740
 kard/transactions/types/visa_mid.py,sha256=inLd8mrhQ1hmdHo7g03NYMbGtq-UGo6OuhR9IFtKVjY,658
 kard/transactions/types/visa_mid_details.py,sha256=TKck88YVWuhUvvydkfB-xUfNa1sx3h2Q8GSsiCBLqiM,724
-kard/users/__init__.py,sha256=iAhq11fmBfS5KxNgEGEXxT-i-SpQ7b6_jUPZ89II7iw,10400
+kard/users/__init__.py,sha256=pV4d3eJhMlb9c2P6hEd1CTujgmRZspD1TznlA23FLuk,10547
 kard/users/attributions/__init__.py,sha256=kKMcKJ2Sjlc-1Mi2BERYYA8VPUXSTQjDqi7VTJ82y94,2446
 kard/users/attributions/client.py,sha256=VTEw6XP9Ey9O6gRZhgdXeY7ox21F02lLvhwsZ9HqjT4,8614
 kard/users/attributions/raw_client.py,sha256=fqZre0qsFvgk-gWWfvvbjmH1gk21RgTakGUldNnIeBI,8999
@@ -223,7 +223,12 @@ kard/users/attributions/types/notification_medium.py,sha256=2ay0h6nIqf0DeolWfk9d
 kard/users/attributions/types/offer_attribution_attributes.py,sha256=B2FZiEgSeQbF3yHZ5rSnBLYuOTBx1zNIgO5MPYdY_9g,1169
 kard/users/attributions/types/offer_attribution_request.py,sha256=aU4vKiuKv-YRlyKdvY-90jNUXEmvHtMll1FvPii8MFU,630
 kard/users/attributions/types/offer_medium.py,sha256=5K3bGlrPdxFu4FSPvYRqdjSY5VD7DYnX43nUJ1IqnDQ,171
-kard/users/client.py,sha256=uWmsS_ADD385A8_69-xJhR-VfTQIvQPZ7iaNsQTaofA,15251
+kard/users/auth/__init__.py,sha256=v2IcrKuUr-jatX1SYrXq5BBWHaJElel8vC_8TXlZ1xQ,1080
+kard/users/auth/client.py,sha256=mVe77Mq0JG3qFgw8mZ7f47DHEAQgxNk3CntQMmrgTaE,3494
+kard/users/auth/raw_client.py,sha256=53IWsFINVLRVX0l7BDScmAH5fejU0yx9L_-M1VvK13k,6007
+kard/users/auth/types/__init__.py,sha256=ySRGQnVJk_77Dr7dSHg3bLpyHeDNL5REl3PhrSrl1To,1114
+kard/users/auth/types/webview_token_response.py,sha256=YMYgo72zFTluKp5MfVsmKu12cNmT-fFQgTiVGCyqVbI,854
+kard/users/client.py,sha256=PV2xvrB2fbcxgx75WD-eRjlyEDSMbh0XBeRTkosuQzc,15889
 kard/users/errors/__init__.py,sha256=BYAoqh-RDSspC-n4ilOC_7zA1XRP7cHdikIiLsD2BkU,1067
 kard/users/errors/multi_status.py,sha256=6SScVu3LIZ_AghltI8DKd1g8l-1KJdEo9GwjP0TwmsE,424
 kard/users/raw_client.py,sha256=vGX7EYcyivMXrf6egmpePuD6gHy6WkcQ2B9UeT9ksGg,30492
@@ -297,6 +302,6 @@ kard/users/uploads/types/update_upload_response_data.py,sha256=au2tb-iSvkMBDhU6s
 kard/users/uploads/types/update_upload_response_data_union.py,sha256=717YqC18LeMNyAkDgYZM2Us40enHiatm3s6UXiMCMPA,871
 kard/users/uploads/types/update_upload_response_object.py,sha256=0iwmSNlgVGPGh9BwzteN1FrhArQStYfjeBkwhOUNAMY,1087
 kard/version.py,sha256=V9m3K1LBEp-MG1T3GWvmb-JWKp8CK-cti5N4GIfQe2I,85
-kard_financial_sdk-0.0.78939.dist-info/METADATA,sha256=YV3E5oDZJKZjECr9o4GVTPLc4tUlMNK2hg8snoN6uC0,7054
-kard_financial_sdk-0.0.78939.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-kard_financial_sdk-0.0.78939.dist-info/RECORD,,
+kard_financial_sdk-1.0.0.dist-info/METADATA,sha256=aAdCKKMf_aTY09Sk7VJ204RX8ocwLgjHL0LvrsNDVqs,7050
+kard_financial_sdk-1.0.0.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+kard_financial_sdk-1.0.0.dist-info/RECORD,,