maytes-api-client-py 0.1.1__py3-none-any.whl

maytes_api_client/exceptions.py

@@ -0,0 +1,218 @@
+"""
+    Maytes API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from typing import Any, Optional
+from typing_extensions import Self
+
+class OpenApiException(Exception):
+    """The base exception class for all OpenAPIExceptions"""
+
+
+class ApiTypeError(OpenApiException, TypeError):
+    def __init__(self, msg, path_to_item=None, valid_classes=None,
+                 key_type=None) -> None:
+        """ Raises an exception for TypeErrors
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list): a list of keys an indices to get to the
+                                 current_item
+                                 None if unset
+            valid_classes (tuple): the primitive classes that current item
+                                   should be an instance of
+                                   None if unset
+            key_type (bool): False if our value is a value in a dict
+                             True if it is a key in a dict
+                             False if our item is an item in a list
+                             None if unset
+        """
+        self.path_to_item = path_to_item
+        self.valid_classes = valid_classes
+        self.key_type = key_type
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiTypeError, self).__init__(full_msg)
+
+
+class ApiValueError(OpenApiException, ValueError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list) the path to the exception in the
+                received_data dict. None if unset
+        """
+
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiValueError, self).__init__(full_msg)
+
+
+class ApiAttributeError(OpenApiException, AttributeError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Raised when an attribute reference or assignment fails.
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiAttributeError, self).__init__(full_msg)
+
+
+class ApiKeyError(OpenApiException, KeyError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiKeyError, self).__init__(full_msg)
+
+
+class ApiException(OpenApiException):
+
+    def __init__(
+        self, 
+        status=None, 
+        reason=None, 
+        http_resp=None,
+        *,
+        body: Optional[str] = None,
+        data: Optional[Any] = None,
+    ) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        self.data = data
+        self.headers = None
+
+        if http_resp:
+            if self.status is None:
+                self.status = http_resp.status
+            if self.reason is None:
+                self.reason = http_resp.reason
+            if self.body is None:
+                try:
+                    self.body = http_resp.data.decode('utf-8')
+                except Exception:
+                    pass
+            self.headers = http_resp.headers
+
+    @classmethod
+    def from_response(
+        cls, 
+        *, 
+        http_resp, 
+        body: Optional[str], 
+        data: Optional[Any],
+    ) -> Self:
+        if http_resp.status == 400:
+            raise BadRequestException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 401:
+            raise UnauthorizedException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 403:
+            raise ForbiddenException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 404:
+            raise NotFoundException(http_resp=http_resp, body=body, data=data)
+
+        # Added new conditions for 409 and 422
+        if http_resp.status == 409:
+            raise ConflictException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 422:
+            raise UnprocessableEntityException(http_resp=http_resp, body=body, data=data)
+
+        if 500 <= http_resp.status <= 599:
+            raise ServiceException(http_resp=http_resp, body=body, data=data)
+        raise ApiException(http_resp=http_resp, body=body, data=data)
+
+    def __str__(self):
+        """Custom error messages for exception"""
+        error_message = "({0})\n"\
+                        "Reason: {1}\n".format(self.status, self.reason)
+        if self.headers:
+            error_message += "HTTP response headers: {0}\n".format(
+                self.headers)
+
+        if self.body:
+            error_message += "HTTP response body: {0}\n".format(self.body)
+
+        if self.data:
+            error_message += "HTTP response data: {0}\n".format(self.data)
+
+        return error_message
+
+
+class BadRequestException(ApiException):
+    pass
+
+
+class NotFoundException(ApiException):
+    pass
+
+
+class UnauthorizedException(ApiException):
+    pass
+
+
+class ForbiddenException(ApiException):
+    pass
+
+
+class ServiceException(ApiException):
+    pass
+
+
+class ConflictException(ApiException):
+    """Exception for HTTP 409 Conflict."""
+    pass
+
+
+class UnprocessableEntityException(ApiException):
+    """Exception for HTTP 422 Unprocessable Entity."""
+    pass
+
+
+def render_path(path_to_item):
+    """Returns a string representation of a path"""
+    result = ""
+    for pth in path_to_item:
+        if isinstance(pth, int):
+            result += "[{0}]".format(pth)
+        else:
+            result += "['{0}']".format(pth)
+    return result

maytes_api_client/managed_client.py

@@ -0,0 +1,199 @@
+"""Bundled with the generated SDK via bin/postprocess-python.sh.
+
+Lives at build/python-client/maytes_api_client/managed_client.py after a
+`make generate-python`. Exported from maytes_api_client/__init__.py.
+
+Adds OAuth2 client_credentials credential management on top of the raw
+DefaultApi using a **reactive 401-retry** pattern:
+
+  1. First authed call mints a token via GetOAuthToken (a @auth([]) op) and
+     caches it.
+  2. Subsequent calls send the cached token as-is — no client-side expiry
+     math, no proactive refresh.
+  3. If the server returns 401, _ManagedApiClient catches the ApiException,
+     refreshes the token, and retries the call once. If the retry also 401s,
+     the error propagates.
+
+Concurrent 401s deduplicate via `refresh_if_stale(stale_token)`: only the
+first caller to acquire the lock mints; others see the cache already updated
+and use that token instead.
+"""
+
+from __future__ import annotations
+
+import threading
+from typing import Any, Optional
+
+from uuid import UUID
+
+from .api.default_api import DefaultApi
+from .api_client import ApiClient
+from .configuration import Configuration
+from .exceptions import ApiException
+from .models.o_auth_token_request import (
+    OAuthTokenRequest,
+)
+
+
+class OAuthTokenProvider:
+    """Caches an OAuth2 client_credentials token; refreshes only on demand.
+
+    Threadsafe — concurrent refreshes serialize behind a lock and dedup
+    via the `stale_token` snapshot.
+    """
+
+    def __init__(
+        self,
+        endpoint: str,
+        client_id: str,
+        client_secret: str,
+        initial_token: Optional[str] = None,
+    ) -> None:
+        self._endpoint = endpoint
+        self._client_id = client_id
+        self._client_secret = client_secret
+        self._token: Optional[str] = initial_token
+        self._lock = threading.Lock()
+        self._unauthed_api = DefaultApi(ApiClient(Configuration(host=endpoint)))
+
+    def get(self) -> str:
+        if self._token is not None:
+            return self._token
+        with self._lock:
+            if self._token is not None:
+                return self._token
+            return self._mint_unlocked()
+
+    def refresh_if_stale(self, stale_token: Optional[str]) -> str:
+        """Mint a new token only if the cache still holds the stale one the
+        caller observed. If another concurrent caller already refreshed,
+        return that newer token instead — no second mint.
+        """
+        with self._lock:
+            if self._token is not None and self._token != stale_token:
+                return self._token
+            return self._mint_unlocked()
+
+    def _mint_unlocked(self) -> str:
+        response = self._unauthed_api.get_o_auth_token(
+            OAuthTokenRequest(
+                grant_type="client_credentials",
+                client_id=UUID(self._client_id),
+                client_secret=self._client_secret,
+            )
+        )
+        assert response.access_token is not None
+        self._token = response.access_token
+        return self._token
+
+
+class _ManagedConfiguration(Configuration):
+    """Configuration whose access_token always delegates to the provider.
+
+    Property + setter combo so Configuration.__init__'s `self.access_token =
+    access_token` doesn't blow up — the setter just no-ops.
+    """
+
+    def __init__(self, provider: OAuthTokenProvider, *, host: str) -> None:
+        super().__init__(host=host)
+        object.__setattr__(self, "_provider", provider)
+
+    @property  # type: ignore[override]
+    def access_token(self) -> str:
+        return self._provider.get()
+
+    @access_token.setter
+    def access_token(self, value: Optional[str]) -> None:
+        # Configuration.__init__ sets self.access_token = None — accept + ignore.
+        pass
+
+
+class _ManagedApiClient(ApiClient):
+    """ApiClient that intercepts 401 *responses* (status code, not exception)
+    inside call_api, refreshes the token, and replays the request once with
+    the new Authorization header.
+
+    Recent openapi-generator-cli Python templates split the HTTP layer in two:
+    `call_api` performs the request and returns a raw RESTResponse (status +
+    headers + body); the downstream `response_deserialize` is what turns a
+    non-2xx status into an ApiException. So the retry has to live inside
+    `call_api` — by the time `response_deserialize` raises, we no longer have
+    the request parameters needed to replay.
+    """
+
+    def __init__(self, configuration: Configuration, provider: OAuthTokenProvider) -> None:
+        super().__init__(configuration)
+        self._provider = provider
+
+    def call_api(
+        self,
+        method: str,
+        url: str,
+        header_params: Optional[dict] = None,
+        body: Any = None,
+        post_params: Any = None,
+        _request_timeout: Any = None,
+    ) -> Any:
+        # Snapshot the token actually used on the wire so refresh_if_stale can
+        # dedup against concurrent refreshes. Parsed from the Authorization
+        # header rather than re-asking the provider, because by the time we
+        # get here the header has already been built upstream.
+        stale_token: Optional[str] = None
+        if header_params and isinstance(header_params.get("Authorization"), str):
+            auth = header_params["Authorization"]
+            if auth.startswith("Bearer "):
+                stale_token = auth[len("Bearer "):]
+
+        response = super().call_api(
+            method, url,
+            header_params=header_params,
+            body=body,
+            post_params=post_params,
+            _request_timeout=_request_timeout,
+        )
+
+        if response.status != 401 or stale_token is None:
+            return response
+
+        # 401 — refresh, rebuild auth header, retry once. If the retry also
+        # 401s, return that response and let response_deserialize raise.
+        new_token = self._provider.refresh_if_stale(stale_token)
+        retry_headers = dict(header_params) if header_params else {}
+        retry_headers["Authorization"] = "Bearer " + new_token
+        return super().call_api(
+            method, url,
+            header_params=retry_headers,
+            body=body,
+            post_params=post_params,
+            _request_timeout=_request_timeout,
+        )
+
+
+def create_maytes_api_client(
+    endpoint: str,
+    client_id: str,
+    client_secret: str,
+    initial_token: Optional[str] = None,
+) -> DefaultApi:
+    """Returns a fully managed DefaultApi.
+
+    Tokens are minted on first authed call, cached, and refreshed reactively
+    when the server returns 401. Operations declared @auth([]) in the Smithy
+    (getHealth, getOAuthToken) carry no security requirement and skip the Authorization header.
+
+        from maytes_api_client import create_maytes_api_client
+        api = create_maytes_api_client(
+            endpoint="https://api.maytes.co",
+            client_id="...",
+            client_secret="...",
+        )
+        result = api.create_checkout(CreateCheckoutRequest(...))
+
+    `initial_token` is an SDK-test-only escape hatch — seeds the cache with a
+    pre-minted JWT. Used by the E2E test path to verify the wrapper's reactive
+    401-retry behavior when the seeded token expires. Production callers omit
+    this; the first authed call will mint via /oauth/token.
+    """
+    provider = OAuthTokenProvider(endpoint, client_id, client_secret, initial_token)
+    config = _ManagedConfiguration(provider, host=endpoint)
+    return DefaultApi(_ManagedApiClient(config, provider))

maytes_api_client/models/__init__.py

@@ -0,0 +1,64 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+    Maytes API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+# import models into model package
+from maytes_api_client.models.cancel_checkout409_response import CancelCheckout409Response
+from maytes_api_client.models.cancel_checkout_request import CancelCheckoutRequest
+from maytes_api_client.models.cancel_checkout_response import CancelCheckoutResponse
+from maytes_api_client.models.capture_checkout409_response import CaptureCheckout409Response
+from maytes_api_client.models.capture_checkout422_response import CaptureCheckout422Response
+from maytes_api_client.models.capture_checkout_request import CaptureCheckoutRequest
+from maytes_api_client.models.capture_checkout_response import CaptureCheckoutResponse
+from maytes_api_client.models.checkout import Checkout
+from maytes_api_client.models.checkout_cancelled import CheckoutCancelled
+from maytes_api_client.models.checkout_captured import CheckoutCaptured
+from maytes_api_client.models.checkout_created import CheckoutCreated
+from maytes_api_client.models.checkout_discount import CheckoutDiscount
+from maytes_api_client.models.checkout_fee import CheckoutFee
+from maytes_api_client.models.create_checkout401_response import CreateCheckout401Response
+from maytes_api_client.models.create_checkout409_response import CreateCheckout409Response
+from maytes_api_client.models.create_checkout422_response import CreateCheckout422Response
+from maytes_api_client.models.create_checkout_request import CreateCheckoutRequest
+from maytes_api_client.models.create_checkout_response import CreateCheckoutResponse
+from maytes_api_client.models.create_refund_request import CreateRefundRequest
+from maytes_api_client.models.customer_data import CustomerData
+from maytes_api_client.models.digital_goods_custom_data import DigitalGoodsCustomData
+from maytes_api_client.models.digital_goods_line_item import DigitalGoodsLineItem
+from maytes_api_client.models.donation_line_item import DonationLineItem
+from maytes_api_client.models.error_response_dto import ErrorResponseDto
+from maytes_api_client.models.fee import Fee
+from maytes_api_client.models.fee_breakdown_line import FeeBreakdownLine
+from maytes_api_client.models.food_beverage_line_item import FoodBeverageLineItem
+from maytes_api_client.models.get_checkout404_response import GetCheckout404Response
+from maytes_api_client.models.get_checkout422_response import GetCheckout422Response
+from maytes_api_client.models.get_checkout_response import GetCheckoutResponse
+from maytes_api_client.models.get_settlement_response import GetSettlementResponse
+from maytes_api_client.models.health_response import HealthResponse
+from maytes_api_client.models.line_item import LineItem
+from maytes_api_client.models.list_settlements_response import ListSettlementsResponse
+from maytes_api_client.models.o_auth_token_request import OAuthTokenRequest
+from maytes_api_client.models.o_auth_token_response import OAuthTokenResponse
+from maytes_api_client.models.other_line_item import OtherLineItem
+from maytes_api_client.models.physical_goods_custom_data import PhysicalGoodsCustomData
+from maytes_api_client.models.physical_goods_line_item import PhysicalGoodsLineItem
+from maytes_api_client.models.refund_checkout402_response import RefundCheckout402Response
+from maytes_api_client.models.refund_checkout409_response import RefundCheckout409Response
+from maytes_api_client.models.service_custom_data import ServiceCustomData
+from maytes_api_client.models.service_line_item import ServiceLineItem
+from maytes_api_client.models.settlement import Settlement
+from maytes_api_client.models.tax import Tax
+from maytes_api_client.models.ticket_custom_data import TicketCustomData
+from maytes_api_client.models.ticket_line_item import TicketLineItem
+from maytes_api_client.models.ticket_seating import TicketSeating
+

maytes_api_client/models/cancel_checkout409_response.py

@@ -0,0 +1,101 @@
+# coding: utf-8
+
+"""
+    Maytes API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class CancelCheckout409Response(BaseModel):
+    """
+    CancelCheckout409Response
+    """ # noqa: E501
+    message: StrictStr
+    error: StrictStr
+    code: StrictStr
+    metadata: Optional[Dict[str, Any]] = None
+    __properties: ClassVar[List[str]] = ["message", "error", "code", "metadata"]
+
+    @field_validator('code')
+    def code_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['session_not_voidable']):
+            raise ValueError("must be one of enum values ('session_not_voidable')")
+        return value
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of CancelCheckout409Response from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of CancelCheckout409Response from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "message": obj.get("message"),
+            "error": obj.get("error"),
+            "code": obj.get("code"),
+            "metadata": obj.get("metadata")
+        })
+        return _obj
+
+

maytes_api_client/models/cancel_checkout_request.py

@@ -0,0 +1,88 @@
+# coding: utf-8
+
+"""
+    Maytes API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class CancelCheckoutRequest(BaseModel):
+    """
+    CancelCheckoutRequest
+    """ # noqa: E501
+    merchant_order_id: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["merchant_order_id"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of CancelCheckoutRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of CancelCheckoutRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "merchant_order_id": obj.get("merchant_order_id")
+        })
+        return _obj
+
+