smspva-sdk 0.1.0a1__tar.gz

smspva_sdk-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SMSPVA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

smspva_sdk-0.1.0a1/MANIFEST.in

@@ -0,0 +1,3 @@
+include METHODS.md
+include LICENSE
+prune tests

smspva_sdk-0.1.0a1/METHODS.md

@@ -0,0 +1,76 @@
+# SDK method index
+
+All six packages cover these same 56 methods. Both Python clients use the Python names. PHP and Java use the JavaScript camelCase method names, with their own resource access syntax. Go capitalizes the first letter (for example, `GetBalance`); C# also appends `Async` (`GetBalanceAsync`). See each package README for request types and working usage. Parameters retain their API spelling.
+
+## activation
+
+| Python (sync and async) | JavaScript / TypeScript | HTTP |
+| --- | --- | --- |
+| `client.activation.get_balance` | `client.activation.getBalance` | `GET /activation/balance` |
+| `client.activation.get_user_info` | `client.activation.getUserInfo` | `GET /activation/userinfo` |
+| `client.activation.get_operators` | `client.activation.getOperators` | `GET /activation/operators/{country}` |
+| `client.activation.get_conversions` | `client.activation.getConversions` | `GET /activation/conversions/{service}` |
+| `client.activation.get_message_type_settings` | `client.activation.getMessageTypeSettings` | `GET /activation/countryservicesettings` |
+| `client.activation.get_all_number_counts` | `client.activation.getAllNumberCounts` | `GET /activation/countnumbers` |
+| `client.activation.get_country_number_counts` | `client.activation.getCountryNumberCounts` | `GET /activation/countnumbers/{country}` |
+| `client.activation.get_service_price` | `client.activation.getServicePrice` | `GET /activation/serviceprice/{country}/{service}` |
+| `client.activation.get_country_operator_prices` | `client.activation.getCountryOperatorPrices` | `GET /activation/serviceprice/{country}` |
+| `client.activation.get_service_prices` | `client.activation.getServicePrices` | `GET /activation/serviceprices/{service}` |
+| `client.activation.get_all_service_prices` | `client.activation.getAllServicePrices` | `GET /activation/servicesprices` |
+| `client.activation.get_number` | `client.activation.getNumber` | `GET /activation/number/{country}/{service}` |
+| `client.activation.get_number_by_operator` | `client.activation.getNumberByOperator` | `GET /activation/number/{country}/{service}/{operator}` |
+| `client.activation.receive_sms` | `client.activation.receiveSms` | `GET /activation/sms/{orderid}` |
+| `client.activation.get_orders` | `client.activation.getOrders` | `GET /activation/orders` |
+| `client.activation.get_number_status` | `client.activation.getNumberStatus` | `GET /activation/numberstatus/{number}/{service}` |
+| `client.activation.clear_sms` | `client.activation.clearSms` | `PUT /activation/clearsms/{orderid}` |
+| `client.activation.stop_sms` | `client.activation.stopSms` | `PUT /activation/stopsms/{orderid}` |
+| `client.activation.cancel_order` | `client.activation.cancelOrder` | `PUT /activation/cancelorder/{orderid}` |
+| `client.activation.block_number` | `client.activation.blockNumber` | `PUT /activation/blocknumber/{orderid}` |
+
+## rental
+
+| Python (sync and async) | JavaScript / TypeScript | HTTP |
+| --- | --- | --- |
+| `client.rental.get_countries` | `client.rental.getCountries` | `GET /api/rent.php?method=getcountries` |
+| `client.rental.get_default_services` | `client.rental.getDefaultServices` | `GET /api/rent.php?method=get_default_services` |
+| `client.rental.get_countries_by_service` | `client.rental.getCountriesByService` | `GET /api/rent.php?method=get_country_by_service` |
+| `client.rental.get_data` | `client.rental.getData` | `GET /api/rent.php?method=getdata` |
+| `client.rental.get_data_with_providers` | `client.rental.getDataWithProviders` | `GET /api/rent.php?method=getdataWithProviders` |
+| `client.rental.get_count` | `client.rental.getCount` | `GET /api/rent.php?method=getcount` |
+| `client.rental.get_count_with_providers` | `client.rental.getCountWithProviders` | `GET /api/rent.php?method=getCountWithProviders` |
+| `client.rental.get_multi_service_count` | `client.rental.getMultiServiceCount` | `GET /api/rent.php?method=get_count_multi` |
+| `client.rental.get_canada_paypal_days` | `client.rental.getCanadaPaypalDays` | `GET /api/rent.php?method=get_days_canada_paypal` |
+| `client.rental.get_minimum_paypal_days` | `client.rental.getMinimumPaypalDays` | `GET /api/rent.php?method=get_min_paypal_days` |
+| `client.rental.create` | `client.rental.create` | `GET /api/rent.php?method=create` |
+| `client.rental.create_multi` | `client.rental.createMulti` | `GET /api/rent.php?method=create_multi` |
+| `client.rental.add_service_to_order` | `client.rental.addServiceToOrder` | `GET /api/rent.php?method=add_service_to_order` |
+| `client.rental.get_orders` | `client.rental.getOrders` | `GET /api/rent.php?method=orders` |
+| `client.rental.activate` | `client.rental.activate` | `GET /api/rent.php?method=activate` |
+| `client.rental.get_sms` | `client.rental.getSms` | `GET /api/rent.php?method=sms` |
+| `client.rental.prolong` | `client.rental.prolong` | `GET /api/rent.php?method=prolong` |
+| `client.rental.prolong_by_days` | `client.rental.prolongByDays` | `GET /api/rent.php?method=prolong_max` |
+| `client.rental.delete_order` | `client.rental.deleteOrder` | `GET /api/rent.php?method=delete` |
+| `client.rental.get_history` | `client.rental.getHistory` | `GET /api/rent.php?method=get_rent_history` |
+| `client.rental.get_restore_cost` | `client.rental.getRestoreCost` | `GET /api/rent.php?method=restore_user_precalc` |
+| `client.rental.restore` | `client.rental.restore` | `GET /api/rent.php?method=restore_user` |
+
+## email
+
+| Python (sync and async) | JavaScript / TypeScript | HTTP |
+| --- | --- | --- |
+| `client.email.get_providers` | `client.email.getProviders` | `GET /api/rent_email.php?method=get_providers` |
+| `client.email.get_data` | `client.email.getData` | `GET /api/rent_email.php?method=get_data` |
+| `client.email.get_count` | `client.email.getCount` | `GET /api/rent_email.php?method=get_count` |
+| `client.email.create_order` | `client.email.createOrder` | `GET /api/rent_email.php?method=create_order` |
+| `client.email.get_orders` | `client.email.getOrders` | `GET /api/rent_email.php?method=get_orders` |
+| `client.email.get_mails` | `client.email.getMails` | `GET /api/rent_email.php?method=get_mails` |
+| `client.email.get_mail_body` | `client.email.getMailBody` | `GET /api/rent_email.php?method=get_mail_body` |
+| `client.email.buy_alias` | `client.email.buyAlias` | `GET /api/rent_email.php?method=buy_alias` |
+| `client.email.get_mails_by_alias` | `client.email.getMailsByAlias` | `GET /api/rent_email.php?method=get_mails_by_alias` |
+| `client.email.prolong_order` | `client.email.prolongOrder` | `GET /api/rent_email.php?method=prolong_order` |
+| `client.email.cancel_order` | `client.email.cancelOrder` | `GET /api/rent_email.php?method=cancel_order` |
+| `client.email.get_archived_orders` | `client.email.getArchivedOrders` | `GET /api/rent_email.php?method=get_archived_orders` |
+| `client.email.calc_restore_order` | `client.email.calcRestoreOrder` | `GET /api/rent_email.php?method=calc_restore_order` |
+| `client.email.restore_order` | `client.email.restoreOrder` | `GET /api/rent_email.php?method=restore_order` |
+
+Activation also provides `wait_for_sms` / `waitForSms`. It polls an existing order until a caller-supplied expiry, without purchasing or cancelling an order.

smspva_sdk-0.1.0a1/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: smspva-sdk
+Version: 0.1.0a1
+Summary: Typed sync and async clients for SMSPVA Activation V2, Rental and Private Email
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SMSPVA/smspva-python
+Project-URL: Documentation, https://docs.smspva.com
+Project-URL: Repository, https://github.com/SMSPVA/smspva-python
+Project-URL: Issues, https://github.com/SMSPVA/smspva-python/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: typing_extensions>=4.12
+Dynamic: license-file
+
+# SMSPVA Python SDK
+
+[![CI](https://github.com/SMSPVA/smspva-python/actions/workflows/ci.yml/badge.svg)](https://github.com/SMSPVA/smspva-python/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)
+
+Python 3.10+, synchronous `SMSPVA` and asynchronous `AsyncSMSPVA`, with the same 56 typed methods. Covers Activation V2 (20), Rental (22) and Private Email (14). Alternative API is excluded. This is an alpha release. PyPI publication is pending.
+
+Install from source:
+
+```sh
+git clone https://github.com/SMSPVA/smspva-python.git
+cd smspva-python
+python -m pip install .
+```
+
+```python
+import os
+from smspva import SMSPVA
+
+with SMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+    print(client.activation.get_balance())
+    print(client.rental.get_countries())
+    print(client.email.get_providers())
+```
+
+```python
+import asyncio
+import os
+from smspva import AsyncSMSPVA
+
+async def main():
+    async with AsyncSMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+        result = await client.activation.get_balance()
+        print(result)
+
+asyncio.run(main())
+```
+
+Use the client as a context manager, or call `close()` / `await aclose()` yourself. Async uses HTTPX `AsyncClient`, not worker threads.
+
+## Requests and results
+
+- Activation V2 sends the key in the `apikey` header. Rental and Email use the `apikey` query parameter. Public methods send no key or cookies. Optional-key rental methods use the client key unless you pass `use_api_key=False`.
+- Returned dictionaries preserve wire field names and values, including string prices, timestamps, and IDs. Types follow the source schemas; a field not marked required remains optional.
+- `is_pending(result)` recognises Activation SMS HTTP 202 / `SMS_NOT_YET_RECEIVED`. `is_no_stock(result)` recognises Email creation `status=2`. Both return the original response instead of raising a generic error.
+- All documented optional parameters are available, including `partnerkey`, `partner_key`, `provider`, `extend`, pagination and search. Query and path values are encoded. Email `pcode=None` or `pcode=""` is omitted entirely.
+- `rental.get_multi_service_count` requires explicit `dtype` and `dcount` because the docs warn that backend defaults are unreliable. The wire method remains `get_count_multi`.
+
+```python
+# Public reference data, without an API key.
+with SMSPVA() as client:
+    services = client.email.get_data(pcode="CODE_FROM_GET_PROVIDERS")
+```
+
+Paid example (run only when you intend to create a rental):
+
+```python
+from smspva import is_no_stock
+
+with SMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+    result = client.email.create_order(
+        scode="CODE_FROM_GET_DATA", dtype="week", dcount=1
+    )
+    if is_no_stock(result):
+        print("No mailbox available; refresh counts before trying again.")
+    else:
+        print(result)
+```
+
+## Waiting for SMS
+
+Save an expiry once when the number is created. `wait_for_sms` polls only Receive SMS, never creates another order, and stops on terminal errors, expiry or a transport failure. A new SMS retrieval can trigger payment.
+
+```python
+import time
+
+# number_result is the successful response from your own get_number request.
+expires_at = time.time() + number_result["data"]["orderExpireIn"]
+result = client.activation.wait_for_sms(
+    orderid=number_result["data"]["orderId"], expires_at=expires_at
+)
+```
+
+Use `await client.activation.wait_for_sms(...)` with `AsyncSMSPVA`. The helper waits at least five seconds between pending responses; this is a helper policy, not a claim about an API-wide rate limit. Request deadlines are bounded by the saved expiry. HTTPX timeouts apply to individual network operations; the async polling helper also enforces an overall remaining deadline.
+
+## Errors and timeouts
+
+`ApiError` retains `family`, `operation`, `http_status`, `code` and the original `response`. `ProtocolError` means the body was not a usable JSON envelope. `TransportError` and `RequestTimeoutError` mean the request outcome may be unknown (`outcome_unknown` for state-changing/paid methods). No requests are retried automatically; inspect current orders before repeating a paid operation.
+
+Exception messages omit request URLs and keys. Query credentials may still appear if you enable HTTPX request logging; redact those logs. Do not put account keys in browser code.
+
+The default timeout is 30 seconds per HTTPX network operation. Override at client construction or per call with `timeout=...`. Advanced transports, proxies and test doubles can be supplied through `transport=httpx.HTTPTransport(...)` or `httpx.AsyncHTTPTransport(...)`; environment proxies/cookies are not inherited. Redirects are never followed.
+
+The generated method index is in `METHODS.md`. Response TypedDicts and input aliases are available in `smspva.types`; the package includes `py.typed`.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Development
+
+```sh
+python -m pip install -e . build mypy
+python -m unittest discover -s tests -v
+python -m mypy
+python -m build
+```
+
+Tests use synthetic fixtures and local transports; they do not buy numbers or call the production API.
+
+## Documentation
+
+[API documentation](https://docs.smspva.com)
+
+The new documentation is being prepared in English, Spanish and Chinese. Localized links will be added when it is deployed.
+
+The SDK covers Activation V2, Rental and Private Email. Alternative API is not supported.

smspva_sdk-0.1.0a1/README.md

@@ -0,0 +1,116 @@
+# SMSPVA Python SDK
+
+[![CI](https://github.com/SMSPVA/smspva-python/actions/workflows/ci.yml/badge.svg)](https://github.com/SMSPVA/smspva-python/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)
+
+Python 3.10+, synchronous `SMSPVA` and asynchronous `AsyncSMSPVA`, with the same 56 typed methods. Covers Activation V2 (20), Rental (22) and Private Email (14). Alternative API is excluded. This is an alpha release. PyPI publication is pending.
+
+Install from source:
+
+```sh
+git clone https://github.com/SMSPVA/smspva-python.git
+cd smspva-python
+python -m pip install .
+```
+
+```python
+import os
+from smspva import SMSPVA
+
+with SMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+    print(client.activation.get_balance())
+    print(client.rental.get_countries())
+    print(client.email.get_providers())
+```
+
+```python
+import asyncio
+import os
+from smspva import AsyncSMSPVA
+
+async def main():
+    async with AsyncSMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+        result = await client.activation.get_balance()
+        print(result)
+
+asyncio.run(main())
+```
+
+Use the client as a context manager, or call `close()` / `await aclose()` yourself. Async uses HTTPX `AsyncClient`, not worker threads.
+
+## Requests and results
+
+- Activation V2 sends the key in the `apikey` header. Rental and Email use the `apikey` query parameter. Public methods send no key or cookies. Optional-key rental methods use the client key unless you pass `use_api_key=False`.
+- Returned dictionaries preserve wire field names and values, including string prices, timestamps, and IDs. Types follow the source schemas; a field not marked required remains optional.
+- `is_pending(result)` recognises Activation SMS HTTP 202 / `SMS_NOT_YET_RECEIVED`. `is_no_stock(result)` recognises Email creation `status=2`. Both return the original response instead of raising a generic error.
+- All documented optional parameters are available, including `partnerkey`, `partner_key`, `provider`, `extend`, pagination and search. Query and path values are encoded. Email `pcode=None` or `pcode=""` is omitted entirely.
+- `rental.get_multi_service_count` requires explicit `dtype` and `dcount` because the docs warn that backend defaults are unreliable. The wire method remains `get_count_multi`.
+
+```python
+# Public reference data, without an API key.
+with SMSPVA() as client:
+    services = client.email.get_data(pcode="CODE_FROM_GET_PROVIDERS")
+```
+
+Paid example (run only when you intend to create a rental):
+
+```python
+from smspva import is_no_stock
+
+with SMSPVA(os.environ["SMSPVA_API_KEY"]) as client:
+    result = client.email.create_order(
+        scode="CODE_FROM_GET_DATA", dtype="week", dcount=1
+    )
+    if is_no_stock(result):
+        print("No mailbox available; refresh counts before trying again.")
+    else:
+        print(result)
+```
+
+## Waiting for SMS
+
+Save an expiry once when the number is created. `wait_for_sms` polls only Receive SMS, never creates another order, and stops on terminal errors, expiry or a transport failure. A new SMS retrieval can trigger payment.
+
+```python
+import time
+
+# number_result is the successful response from your own get_number request.
+expires_at = time.time() + number_result["data"]["orderExpireIn"]
+result = client.activation.wait_for_sms(
+    orderid=number_result["data"]["orderId"], expires_at=expires_at
+)
+```
+
+Use `await client.activation.wait_for_sms(...)` with `AsyncSMSPVA`. The helper waits at least five seconds between pending responses; this is a helper policy, not a claim about an API-wide rate limit. Request deadlines are bounded by the saved expiry. HTTPX timeouts apply to individual network operations; the async polling helper also enforces an overall remaining deadline.
+
+## Errors and timeouts
+
+`ApiError` retains `family`, `operation`, `http_status`, `code` and the original `response`. `ProtocolError` means the body was not a usable JSON envelope. `TransportError` and `RequestTimeoutError` mean the request outcome may be unknown (`outcome_unknown` for state-changing/paid methods). No requests are retried automatically; inspect current orders before repeating a paid operation.
+
+Exception messages omit request URLs and keys. Query credentials may still appear if you enable HTTPX request logging; redact those logs. Do not put account keys in browser code.
+
+The default timeout is 30 seconds per HTTPX network operation. Override at client construction or per call with `timeout=...`. Advanced transports, proxies and test doubles can be supplied through `transport=httpx.HTTPTransport(...)` or `httpx.AsyncHTTPTransport(...)`; environment proxies/cookies are not inherited. Redirects are never followed.
+
+The generated method index is in `METHODS.md`. Response TypedDicts and input aliases are available in `smspva.types`; the package includes `py.typed`.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Development
+
+```sh
+python -m pip install -e . build mypy
+python -m unittest discover -s tests -v
+python -m mypy
+python -m build
+```
+
+Tests use synthetic fixtures and local transports; they do not buy numbers or call the production API.
+
+## Documentation
+
+[API documentation](https://docs.smspva.com)
+
+The new documentation is being prepared in English, Spanish and Chinese. Localized links will be added when it is deployed.
+
+The SDK covers Activation V2, Rental and Private Email. Alternative API is not supported.

smspva_sdk-0.1.0a1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "smspva-sdk"
+version = "0.1.0a1"
+description = "Typed sync and async clients for SMSPVA Activation V2, Rental and Private Email"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+dependencies = ["httpx>=0.28,<1", "typing_extensions>=4.12"]
+classifiers = ["Development Status :: 3 - Alpha", "Typing :: Typed", "Programming Language :: Python :: 3"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+smspva = ["py.typed", "_contracts.json"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = ["src/smspva"]
+
+[tool.setuptools]
+include-package-data = true
+
+[project.urls]
+Homepage = "https://github.com/SMSPVA/smspva-python"
+Documentation = "https://docs.smspva.com"
+Repository = "https://github.com/SMSPVA/smspva-python"
+Issues = "https://github.com/SMSPVA/smspva-python/issues"

smspva_sdk-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

smspva_sdk-0.1.0a1/src/smspva/__init__.py

@@ -0,0 +1,6 @@
+from ._client import SMSPVA, AsyncSMSPVA
+from ._polling import is_pending, is_no_stock
+from .errors import SMSPVAError, ApiError, ProtocolError, TransportError, RequestTimeoutError, PollingTimeoutError, ValidationError
+
+__version__ = "0.1.0a1"
+__all__ = ["SMSPVA", "AsyncSMSPVA", "is_pending", "is_no_stock", "SMSPVAError", "ApiError", "ProtocolError", "TransportError", "RequestTimeoutError", "PollingTimeoutError", "ValidationError"]

smspva_sdk-0.1.0a1/src/smspva/_client.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from types import TracebackType
+import httpx
+
+from ._transport import Transport, AsyncTransport
+from ._resources import Activation, Rental, Email, AsyncActivation, AsyncRental, AsyncEmail
+
+
+class SMSPVA:
+    def __init__(self, api_key: str | None = None, *, timeout: float = 30, activation_base_url: str | None = None,
+                 rental_base_url: str | None = None, email_base_url: str | None = None, transport: httpx.BaseTransport | None = None):
+        self._transport = Transport(api_key, timeout, {"activation": activation_base_url, "rental": rental_base_url, "email": email_base_url}, transport)
+        self.activation = Activation(self._transport)
+        self.rental = Rental(self._transport)
+        self.email = Email(self._transport)
+
+    def close(self) -> None:
+        self._transport.close()
+
+    def __enter__(self) -> SMSPVA:
+        return self
+
+    def __exit__(self, exc_type: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None) -> None:
+        self.close()
+
+
+class AsyncSMSPVA:
+    def __init__(self, api_key: str | None = None, *, timeout: float = 30, activation_base_url: str | None = None,
+                 rental_base_url: str | None = None, email_base_url: str | None = None, transport: httpx.AsyncBaseTransport | None = None):
+        self._transport = AsyncTransport(api_key, timeout, {"activation": activation_base_url, "rental": rental_base_url, "email": email_base_url}, transport)
+        self.activation = AsyncActivation(self._transport)
+        self.rental = AsyncRental(self._transport)
+        self.email = AsyncEmail(self._transport)
+
+    async def aclose(self) -> None:
+        await self._transport.close()
+
+    async def __aenter__(self) -> AsyncSMSPVA:
+        return self
+
+    async def __aexit__(self, exc_type: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None) -> None:
+        await self.aclose()