dodopayments 1.51.0__py3-none-any.whl → 1.52.4__py3-none-any.whl

dodopayments/_client.py

@@ -25,6 +25,7 @@ from .resources import (
     misc,
     addons,
     brands,
+    meters,
     payouts,
     refunds,
     disputes,
@@ -32,6 +33,7 @@ from .resources import (
     payments,
     discounts,
     license_keys,
+    usage_events,
     subscriptions,
     checkout_sessions,
     license_key_instances,
@@ -84,6 +86,8 @@ class DodoPayments(SyncAPIClient):
     addons: addons.AddonsResource
     brands: brands.BrandsResource
     webhooks: webhooks.WebhooksResource
+    usage_events: usage_events.UsageEventsResource
+    meters: meters.MetersResource
     with_raw_response: DodoPaymentsWithRawResponse
     with_streaming_response: DodoPaymentsWithStreamedResponse
 
@@ -182,6 +186,8 @@ class DodoPayments(SyncAPIClient):
         self.addons = addons.AddonsResource(self)
         self.brands = brands.BrandsResource(self)
         self.webhooks = webhooks.WebhooksResource(self)
+        self.usage_events = usage_events.UsageEventsResource(self)
+        self.meters = meters.MetersResource(self)
         self.with_raw_response = DodoPaymentsWithRawResponse(self)
         self.with_streaming_response = DodoPaymentsWithStreamedResponse(self)
 
@@ -310,6 +316,8 @@ class AsyncDodoPayments(AsyncAPIClient):
     addons: addons.AsyncAddonsResource
     brands: brands.AsyncBrandsResource
     webhooks: webhooks.AsyncWebhooksResource
+    usage_events: usage_events.AsyncUsageEventsResource
+    meters: meters.AsyncMetersResource
     with_raw_response: AsyncDodoPaymentsWithRawResponse
     with_streaming_response: AsyncDodoPaymentsWithStreamedResponse
 
@@ -408,6 +416,8 @@ class AsyncDodoPayments(AsyncAPIClient):
         self.addons = addons.AsyncAddonsResource(self)
         self.brands = brands.AsyncBrandsResource(self)
         self.webhooks = webhooks.AsyncWebhooksResource(self)
+        self.usage_events = usage_events.AsyncUsageEventsResource(self)
+        self.meters = meters.AsyncMetersResource(self)
         self.with_raw_response = AsyncDodoPaymentsWithRawResponse(self)
         self.with_streaming_response = AsyncDodoPaymentsWithStreamedResponse(self)
 
@@ -539,6 +549,8 @@ class DodoPaymentsWithRawResponse:
         self.addons = addons.AddonsResourceWithRawResponse(client.addons)
         self.brands = brands.BrandsResourceWithRawResponse(client.brands)
         self.webhooks = webhooks.WebhooksResourceWithRawResponse(client.webhooks)
+        self.usage_events = usage_events.UsageEventsResourceWithRawResponse(client.usage_events)
+        self.meters = meters.MetersResourceWithRawResponse(client.meters)
 
 
 class AsyncDodoPaymentsWithRawResponse:
@@ -564,6 +576,8 @@ class AsyncDodoPaymentsWithRawResponse:
         self.addons = addons.AsyncAddonsResourceWithRawResponse(client.addons)
         self.brands = brands.AsyncBrandsResourceWithRawResponse(client.brands)
         self.webhooks = webhooks.AsyncWebhooksResourceWithRawResponse(client.webhooks)
+        self.usage_events = usage_events.AsyncUsageEventsResourceWithRawResponse(client.usage_events)
+        self.meters = meters.AsyncMetersResourceWithRawResponse(client.meters)
 
 
 class DodoPaymentsWithStreamedResponse:
@@ -589,6 +603,8 @@ class DodoPaymentsWithStreamedResponse:
         self.addons = addons.AddonsResourceWithStreamingResponse(client.addons)
         self.brands = brands.BrandsResourceWithStreamingResponse(client.brands)
         self.webhooks = webhooks.WebhooksResourceWithStreamingResponse(client.webhooks)
+        self.usage_events = usage_events.UsageEventsResourceWithStreamingResponse(client.usage_events)
+        self.meters = meters.MetersResourceWithStreamingResponse(client.meters)
 
 
 class AsyncDodoPaymentsWithStreamedResponse:
@@ -614,6 +630,8 @@ class AsyncDodoPaymentsWithStreamedResponse:
         self.addons = addons.AsyncAddonsResourceWithStreamingResponse(client.addons)
         self.brands = brands.AsyncBrandsResourceWithStreamingResponse(client.brands)
         self.webhooks = webhooks.AsyncWebhooksResourceWithStreamingResponse(client.webhooks)
+        self.usage_events = usage_events.AsyncUsageEventsResourceWithStreamingResponse(client.usage_events)
+        self.meters = meters.AsyncMetersResourceWithStreamingResponse(client.meters)
 
 
 Client = DodoPayments

dodopayments/_models.py

@@ -304,7 +304,7 @@ class BaseModel(pydantic.BaseModel):
                 exclude_none=exclude_none,
             )
 
-            return cast(dict[str, Any], json_safe(dumped)) if mode == "json" else dumped
+            return cast("dict[str, Any]", json_safe(dumped)) if mode == "json" else dumped
 
         @override
         def model_dump_json(

dodopayments/_types.py

@@ -13,10 +13,21 @@ from typing import (
     Mapping,
     TypeVar,
     Callable,
+    Iterator,
     Optional,
     Sequence,
 )
-from typing_extensions import Set, Literal, Protocol, TypeAlias, TypedDict, override, runtime_checkable
+from typing_extensions import (
+    Set,
+    Literal,
+    Protocol,
+    TypeAlias,
+    TypedDict,
+    SupportsIndex,
+    overload,
+    override,
+    runtime_checkable,
+)
 
 import httpx
 import pydantic
@@ -217,3 +228,26 @@ class _GenericAlias(Protocol):
 class HttpxSendArgs(TypedDict, total=False):
     auth: httpx.Auth
     follow_redirects: bool
+
+
+_T_co = TypeVar("_T_co", covariant=True)
+
+
+if TYPE_CHECKING:
+    # This works because str.__contains__ does not accept object (either in typeshed or at runtime)
+    # https://github.com/hauntsaninja/useful_types/blob/5e9710f3875107d068e7679fd7fec9cfab0eff3b/useful_types/__init__.py#L285
+    class SequenceNotStr(Protocol[_T_co]):
+        @overload
+        def __getitem__(self, index: SupportsIndex, /) -> _T_co: ...
+        @overload
+        def __getitem__(self, index: slice, /) -> Sequence[_T_co]: ...
+        def __contains__(self, value: object, /) -> bool: ...
+        def __len__(self) -> int: ...
+        def __iter__(self) -> Iterator[_T_co]: ...
+        def index(self, value: Any, start: int = 0, stop: int = ..., /) -> int: ...
+        def count(self, value: Any, /) -> int: ...
+        def __reversed__(self) -> Iterator[_T_co]: ...
+else:
+    # just point this to a normal `Sequence` at runtime to avoid having to special case
+    # deserializing our custom sequence type
+    SequenceNotStr = Sequence

dodopayments/_utils/__init__.py

@@ -38,6 +38,7 @@ from ._typing import (
     extract_type_arg as extract_type_arg,
     is_iterable_type as is_iterable_type,
     is_required_type as is_required_type,
+    is_sequence_type as is_sequence_type,
     is_annotated_type as is_annotated_type,
     is_type_alias_type as is_type_alias_type,
     strip_annotated_type as strip_annotated_type,

dodopayments/_utils/_transform.py

@@ -16,6 +16,7 @@ from ._utils import (
     lru_cache,
     is_mapping,
     is_iterable,
+    is_sequence,
 )
 from .._files import is_base64_file_input
 from ._typing import (
@@ -24,6 +25,7 @@ from ._typing import (
     extract_type_arg,
     is_iterable_type,
     is_required_type,
+    is_sequence_type,
     is_annotated_type,
     strip_annotated_type,
 )
@@ -184,6 +186,8 @@ def _transform_recursive(
         (is_list_type(stripped_type) and is_list(data))
         # Iterable[T]
         or (is_iterable_type(stripped_type) and is_iterable(data) and not isinstance(data, str))
+        # Sequence[T]
+        or (is_sequence_type(stripped_type) and is_sequence(data) and not isinstance(data, str))
     ):
         # dicts are technically iterable, but it is an iterable on the keys of the dict and is not usually
         # intended as an iterable, so we don't transform it.
@@ -346,6 +350,8 @@ async def _async_transform_recursive(
         (is_list_type(stripped_type) and is_list(data))
         # Iterable[T]
         or (is_iterable_type(stripped_type) and is_iterable(data) and not isinstance(data, str))
+        # Sequence[T]
+        or (is_sequence_type(stripped_type) and is_sequence(data) and not isinstance(data, str))
     ):
         # dicts are technically iterable, but it is an iterable on the keys of the dict and is not usually
         # intended as an iterable, so we don't transform it.

dodopayments/_utils/_typing.py

@@ -26,6 +26,11 @@ def is_list_type(typ: type) -> bool:
     return (get_origin(typ) or typ) == list
 
 
+def is_sequence_type(typ: type) -> bool:
+    origin = get_origin(typ) or typ
+    return origin == typing_extensions.Sequence or origin == typing.Sequence or origin == _c_abc.Sequence
+
+
 def is_iterable_type(typ: type) -> bool:
     """If the given type is `typing.Iterable[T]`"""
     origin = get_origin(typ) or typ

dodopayments/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "dodopayments"
-__version__ = "1.51.0"  # x-release-please-version
+__version__ = "1.52.4"  # x-release-please-version

dodopayments/resources/__init__.py

@@ -24,6 +24,14 @@ from .brands import (
     BrandsResourceWithStreamingResponse,
     AsyncBrandsResourceWithStreamingResponse,
 )
+from .meters import (
+    MetersResource,
+    AsyncMetersResource,
+    MetersResourceWithRawResponse,
+    AsyncMetersResourceWithRawResponse,
+    MetersResourceWithStreamingResponse,
+    AsyncMetersResourceWithStreamingResponse,
+)
 from .payouts import (
     PayoutsResource,
     AsyncPayoutsResource,
@@ -112,6 +120,14 @@ from .license_keys import (
     LicenseKeysResourceWithStreamingResponse,
     AsyncLicenseKeysResourceWithStreamingResponse,
 )
+from .usage_events import (
+    UsageEventsResource,
+    AsyncUsageEventsResource,
+    UsageEventsResourceWithRawResponse,
+    AsyncUsageEventsResourceWithRawResponse,
+    UsageEventsResourceWithStreamingResponse,
+    AsyncUsageEventsResourceWithStreamingResponse,
+)
 from .subscriptions import (
     SubscriptionsResource,
     AsyncSubscriptionsResource,
@@ -240,4 +256,16 @@ __all__ = [
     "AsyncWebhooksResourceWithRawResponse",
     "WebhooksResourceWithStreamingResponse",
     "AsyncWebhooksResourceWithStreamingResponse",
+    "UsageEventsResource",
+    "AsyncUsageEventsResource",
+    "UsageEventsResourceWithRawResponse",
+    "AsyncUsageEventsResourceWithRawResponse",
+    "UsageEventsResourceWithStreamingResponse",
+    "AsyncUsageEventsResourceWithStreamingResponse",
+    "MetersResource",
+    "AsyncMetersResource",
+    "MetersResourceWithRawResponse",
+    "AsyncMetersResourceWithRawResponse",
+    "MetersResourceWithStreamingResponse",
+    "AsyncMetersResourceWithStreamingResponse",
 ]

dodopayments/resources/discounts.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Optional
+from typing import Union, Optional
 from datetime import datetime
 
 import httpx
 
 from ..types import DiscountType, discount_list_params, discount_create_params, discount_update_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, SequenceNotStr
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -54,7 +54,7 @@ class DiscountsResource(SyncAPIResource):
         code: Optional[str] | NotGiven = NOT_GIVEN,
         expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        restricted_to: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
         usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -165,7 +165,7 @@ class DiscountsResource(SyncAPIResource):
         code: Optional[str] | NotGiven = NOT_GIVEN,
         expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        restricted_to: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
         type: Optional[DiscountType] | NotGiven = NOT_GIVEN,
         usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
@@ -341,7 +341,7 @@ class AsyncDiscountsResource(AsyncAPIResource):
         code: Optional[str] | NotGiven = NOT_GIVEN,
         expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        restricted_to: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
         usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -452,7 +452,7 @@ class AsyncDiscountsResource(AsyncAPIResource):
         code: Optional[str] | NotGiven = NOT_GIVEN,
         expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        restricted_to: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
         type: Optional[DiscountType] | NotGiven = NOT_GIVEN,
         usage_limit: Optional[int] | NotGiven = NOT_GIVEN,

dodopayments/resources/invoices/payments.py

@@ -74,6 +74,38 @@ class PaymentsResource(SyncAPIResource):
             cast_to=BinaryAPIResponse,
         )
 
+    def retrieve_refund(
+        self,
+        refund_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BinaryAPIResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not refund_id:
+            raise ValueError(f"Expected a non-empty value for `refund_id` but received {refund_id!r}")
+        extra_headers = {"Accept": "application/pdf", **(extra_headers or {})}
+        return self._get(
+            f"/invoices/refunds/{refund_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BinaryAPIResponse,
+        )
+
 
 class AsyncPaymentsResource(AsyncAPIResource):
     @cached_property
@@ -127,6 +159,38 @@ class AsyncPaymentsResource(AsyncAPIResource):
             cast_to=AsyncBinaryAPIResponse,
         )
 
+    async def retrieve_refund(
+        self,
+        refund_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> AsyncBinaryAPIResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not refund_id:
+            raise ValueError(f"Expected a non-empty value for `refund_id` but received {refund_id!r}")
+        extra_headers = {"Accept": "application/pdf", **(extra_headers or {})}
+        return await self._get(
+            f"/invoices/refunds/{refund_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AsyncBinaryAPIResponse,
+        )
+
 
 class PaymentsResourceWithRawResponse:
     def __init__(self, payments: PaymentsResource) -> None:
@@ -136,6 +200,10 @@ class PaymentsResourceWithRawResponse:
             payments.retrieve,
             BinaryAPIResponse,
         )
+        self.retrieve_refund = to_custom_raw_response_wrapper(
+            payments.retrieve_refund,
+            BinaryAPIResponse,
+        )
 
 
 class AsyncPaymentsResourceWithRawResponse:
@@ -146,6 +214,10 @@ class AsyncPaymentsResourceWithRawResponse:
             payments.retrieve,
             AsyncBinaryAPIResponse,
         )
+        self.retrieve_refund = async_to_custom_raw_response_wrapper(
+            payments.retrieve_refund,
+            AsyncBinaryAPIResponse,
+        )
 
 
 class PaymentsResourceWithStreamingResponse:
@@ -156,6 +228,10 @@ class PaymentsResourceWithStreamingResponse:
             payments.retrieve,
             StreamedBinaryAPIResponse,
         )
+        self.retrieve_refund = to_custom_streamed_response_wrapper(
+            payments.retrieve_refund,
+            StreamedBinaryAPIResponse,
+        )
 
 
 class AsyncPaymentsResourceWithStreamingResponse:
@@ -166,3 +242,7 @@ class AsyncPaymentsResourceWithStreamingResponse:
             payments.retrieve,
             AsyncStreamedBinaryAPIResponse,
         )
+        self.retrieve_refund = async_to_custom_streamed_response_wrapper(
+            payments.retrieve_refund,
+            AsyncStreamedBinaryAPIResponse,
+        )