paid-python 1.5.0__tar.gz → 1.6.0__tar.gz

{paid_python-1.5.0 → paid_python-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 1.5.0
+Version: 1.6.0
 Summary: 
 Requires-Python: >=3.10,<3.14
 Classifier: Intended Audience :: Developers

{paid_python-1.5.0 → paid_python-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "paid-python"
-version = "1.5.0"
+version = "1.6.0"
 description = ""
 readme = "README.md"
 authors = []
@@ -64,7 +64,7 @@ claude-agent-sdk = ">=0.1.0,<0.1.49"
 google-genai = ">=1.19.0"
 instructor = ">=1.0.0"
 langchain-core = ">=0.1.0"
-mistralai = ">=1.9.0,<2.0.0"
+mistralai = ">=1.9.0, <2.0.0"
 openai = ">=1.12.0"
 openai-agents = ">=0.2.0"
 pydantic-ai = ">=1.41.0"

{paid_python-1.5.0 → paid_python-1.6.0}/src/paid/__init__.py

@@ -20,6 +20,11 @@ if typing.TYPE_CHECKING:
         ContactRolesItem,
         CreateOrderLineAttributeRequest,
         CreateOrderLineRequest,
+        CreditBalance,
+        CreditBalanceListResponse,
+        CreditBalanceRecipient,
+        CreditCurrency,
+        CreditCurrencyListResponse,
         Customer,
         CustomerAttribution,
         CustomerBillingAddress,
@@ -55,7 +60,7 @@ if typing.TYPE_CHECKING:
         UpdateProductRequest,
     )
     from .errors import BadRequestError, ForbiddenError, InternalServerError, NotFoundError
-    from . import checkouts, contacts, customers, invoices, orders, products, signals
+    from . import checkouts, contacts, credits, customers, invoices, orders, products, signals
     from .checkouts import ListCheckoutsRequestStatus
     from .client import AsyncPaid, Paid
     from .contacts import CreateContactRequestRolesItem
@@ -78,6 +83,11 @@ _dynamic_imports: typing.Dict[str, str] = {
     "CreateContactRequestRolesItem": ".contacts",
     "CreateOrderLineAttributeRequest": ".types",
     "CreateOrderLineRequest": ".types",
+    "CreditBalance": ".types",
+    "CreditBalanceListResponse": ".types",
+    "CreditBalanceRecipient": ".types",
+    "CreditCurrency": ".types",
+    "CreditCurrencyListResponse": ".types",
     "Customer": ".types",
     "CustomerAttribution": ".types",
     "CustomerBillingAddress": ".types",
@@ -120,6 +130,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "__version__": ".version",
     "checkouts": ".checkouts",
     "contacts": ".contacts",
+    "credits": ".credits",
     "customers": ".customers",
     "invoices": ".invoices",
     "orders": ".orders",
@@ -166,6 +177,11 @@ __all__ = [
     "CreateContactRequestRolesItem",
     "CreateOrderLineAttributeRequest",
     "CreateOrderLineRequest",
+    "CreditBalance",
+    "CreditBalanceListResponse",
+    "CreditBalanceRecipient",
+    "CreditCurrency",
+    "CreditCurrencyListResponse",
     "Customer",
     "CustomerAttribution",
     "CustomerBillingAddress",
@@ -208,6 +224,7 @@ __all__ = [
     "__version__",
     "checkouts",
     "contacts",
+    "credits",
     "customers",
     "invoices",
     "orders",

{paid_python-1.5.0 → paid_python-1.6.0}/src/paid/client.py

@@ -11,6 +11,7 @@ from .environment import PaidEnvironment
 if typing.TYPE_CHECKING:
     from .checkouts.client import AsyncCheckoutsClient, CheckoutsClient
     from .contacts.client import AsyncContactsClient, ContactsClient
+    from .credits.client import AsyncCreditsClient, CreditsClient
     from .customers.client import AsyncCustomersClient, CustomersClient
     from .invoices.client import AsyncInvoicesClient, InvoicesClient
     from .orders.client import AsyncOrdersClient, OrdersClient
@@ -89,6 +90,7 @@ class Paid:
         self._orders: typing.Optional[OrdersClient] = None
         self._invoices: typing.Optional[InvoicesClient] = None
         self._signals: typing.Optional[SignalsClient] = None
+        self._credits: typing.Optional[CreditsClient] = None
         self._checkouts: typing.Optional[CheckoutsClient] = None
 
     @property
@@ -139,6 +141,14 @@ class Paid:
             self._signals = SignalsClient(client_wrapper=self._client_wrapper)
         return self._signals
 
+    @property
+    def credits(self):
+        if self._credits is None:
+            from .credits.client import CreditsClient  # noqa: E402
+
+            self._credits = CreditsClient(client_wrapper=self._client_wrapper)
+        return self._credits
+
     @property
     def checkouts(self):
         if self._checkouts is None:
@@ -219,6 +229,7 @@ class AsyncPaid:
         self._orders: typing.Optional[AsyncOrdersClient] = None
         self._invoices: typing.Optional[AsyncInvoicesClient] = None
         self._signals: typing.Optional[AsyncSignalsClient] = None
+        self._credits: typing.Optional[AsyncCreditsClient] = None
         self._checkouts: typing.Optional[AsyncCheckoutsClient] = None
 
     @property
@@ -269,6 +280,14 @@ class AsyncPaid:
             self._signals = AsyncSignalsClient(client_wrapper=self._client_wrapper)
         return self._signals
 
+    @property
+    def credits(self):
+        if self._credits is None:
+            from .credits.client import AsyncCreditsClient  # noqa: E402
+
+            self._credits = AsyncCreditsClient(client_wrapper=self._client_wrapper)
+        return self._credits
+
     @property
     def checkouts(self):
         if self._checkouts is None:

{paid_python-1.5.0 → paid_python-1.6.0}/src/paid/core/client_wrapper.py

@@ -24,12 +24,12 @@ class BaseClientWrapper:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "paid-python/1.5.0",
+            "User-Agent": "paid-python/1.6.0",
             "X-Fern-Language": "Python",
             "X-Fern-Runtime": f"python/{platform.python_version()}",
             "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",
             "X-Fern-SDK-Name": "paid-python",
-            "X-Fern-SDK-Version": "1.5.0",
+            "X-Fern-SDK-Version": "1.6.0",
             **(self.get_custom_headers() or {}),
         }
         headers["Authorization"] = f"Bearer {self._get_token()}"

paid_python-1.6.0/src/paid/credits/client.py

@@ -0,0 +1,104 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.credit_currency_list_response import CreditCurrencyListResponse
+from .raw_client import AsyncRawCreditsClient, RawCreditsClient
+
+
+class CreditsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawCreditsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawCreditsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawCreditsClient
+        """
+        return self._raw_client
+
+    def list_credit_currencies(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditCurrencyListResponse:
+        """
+        List credit currencies for the organization
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditCurrencyListResponse
+            200
+
+        Examples
+        --------
+        from paid import Paid
+
+        client = Paid(
+            token="YOUR_TOKEN",
+        )
+        client.credits.list_credit_currencies()
+        """
+        _response = self._raw_client.list_credit_currencies(request_options=request_options)
+        return _response.data
+
+
+class AsyncCreditsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawCreditsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawCreditsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawCreditsClient
+        """
+        return self._raw_client
+
+    async def list_credit_currencies(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditCurrencyListResponse:
+        """
+        List credit currencies for the organization
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditCurrencyListResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from paid import AsyncPaid
+
+        client = AsyncPaid(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.credits.list_credit_currencies()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_credit_currencies(request_options=request_options)
+        return _response.data

paid_python-1.6.0/src/paid/credits/raw_client.py

@@ -0,0 +1,140 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..errors.forbidden_error import ForbiddenError
+from ..errors.internal_server_error import InternalServerError
+from ..types.credit_currency_list_response import CreditCurrencyListResponse
+from ..types.error_response import ErrorResponse
+
+
+class RawCreditsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list_credit_currencies(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[CreditCurrencyListResponse]:
+        """
+        List credit currencies for the organization
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreditCurrencyListResponse]
+            200
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "credits/currencies",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreditCurrencyListResponse,
+                    parse_obj_as(
+                        type_=CreditCurrencyListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            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(),
+                        ),
+                    ),
+                )
+            _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 AsyncRawCreditsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list_credit_currencies(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[CreditCurrencyListResponse]:
+        """
+        List credit currencies for the organization
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreditCurrencyListResponse]
+            200
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "credits/currencies",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreditCurrencyListResponse,
+                    parse_obj_as(
+                        type_=CreditCurrencyListResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            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(),
+                        ),
+                    ),
+                )
+            _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)

{paid_python-1.5.0 → paid_python-1.6.0}/src/paid/customers/client.py

@@ -5,6 +5,7 @@ import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
+from ..types.credit_balance_list_response import CreditBalanceListResponse
 from ..types.customer import Customer
 from ..types.customer_billing_address import CustomerBillingAddress
 from ..types.customer_creation_state import CustomerCreationState
@@ -435,6 +436,72 @@ class CustomersClient:
         _response = self._raw_client.delete_customer_by_external_id(external_id, request_options=request_options)
         return _response.data
 
+    def get_customer_credit_balances(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditBalanceListResponse:
+        """
+        Get current customer credit balances grouped by currency
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditBalanceListResponse
+            200
+
+        Examples
+        --------
+        from paid import Paid
+
+        client = Paid(
+            token="YOUR_TOKEN",
+        )
+        client.customers.get_customer_credit_balances(
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_customer_credit_balances(id, request_options=request_options)
+        return _response.data
+
+    def get_customer_credit_balances_by_external_id(
+        self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditBalanceListResponse:
+        """
+        Get current customer credit balances grouped by currency, looked up by external ID
+
+        Parameters
+        ----------
+        external_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditBalanceListResponse
+            200
+
+        Examples
+        --------
+        from paid import Paid
+
+        client = Paid(
+            token="YOUR_TOKEN",
+        )
+        client.customers.get_customer_credit_balances_by_external_id(
+            external_id="externalId",
+        )
+        """
+        _response = self._raw_client.get_customer_credit_balances_by_external_id(
+            external_id, request_options=request_options
+        )
+        return _response.data
+
 
 class AsyncCustomersClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -918,3 +985,85 @@ class AsyncCustomersClient:
         """
         _response = await self._raw_client.delete_customer_by_external_id(external_id, request_options=request_options)
         return _response.data
+
+    async def get_customer_credit_balances(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditBalanceListResponse:
+        """
+        Get current customer credit balances grouped by currency
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditBalanceListResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from paid import AsyncPaid
+
+        client = AsyncPaid(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.customers.get_customer_credit_balances(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_customer_credit_balances(id, request_options=request_options)
+        return _response.data
+
+    async def get_customer_credit_balances_by_external_id(
+        self, external_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> CreditBalanceListResponse:
+        """
+        Get current customer credit balances grouped by currency, looked up by external ID
+
+        Parameters
+        ----------
+        external_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CreditBalanceListResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from paid import AsyncPaid
+
+        client = AsyncPaid(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.customers.get_customer_credit_balances_by_external_id(
+                external_id="externalId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_customer_credit_balances_by_external_id(
+            external_id, request_options=request_options
+        )
+        return _response.data