proxyrequest-sdk 4.3.0__tar.gz → 4.4.1__tar.gz

{proxyrequest_sdk-4.3.0 → proxyrequest_sdk-4.4.1}/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to the ProxyRequest Python SDK are documented here.
 
 ## Unreleased
 
+
+## 4.4.1 (2026-11-12)
+
+- Document administrative traffic grants and debits for independent customers through the existing add/subtract methods. This capability requires the corresponding PapaProxy API update.
+- Refresh the bundled contract documentation while preserving request fields, response types and existing method signatures.
+
+## 4.4.0 (2026-10-08)
+
+- Add optional `impersonate_user_id` to every synchronous and asynchronous resource operation, plus raw requests. The `X-Impersonate-User` header is scoped to each call, so the same client can mix ordinary and impersonated requests.
+- Accept a string or UUID and reject blank IDs before sending the request. Existing calls keep their behavior and argument order.
+- Regenerate typed methods and reference documentation from the pinned public API contract.
+
 ## 4.3.0 (2026-10-07)
 
 - Add `include_geo` to synchronous and asynchronous `locations.list_asns()`. Set it to `True` to request country, region, and city scopes in each ASN's `geo` list; the API returns an empty list by default.

{proxyrequest_sdk-4.3.0 → proxyrequest_sdk-4.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyrequest-sdk
-Version: 4.3.0
+Version: 4.4.1
 Summary: Official sync and async Python SDK for the ProxyRequest public API.
 Project-URL: Homepage, https://proxyrequest.com
 Project-URL: Documentation, https://proxyrequest.com/docs/
@@ -339,6 +339,19 @@ update it. Generation is pinned and CI rejects uncommitted contract changes.
 
 MIT
 
+## Per-call reseller impersonation
+
+The generated resource methods accept an optional `impersonate_user_id`. The
+header applies only to that request, so one client can make scoped and ordinary
+calls, including concurrently.
+
+```python
+child = client.users.get(id=child_id, impersonate_user_id=str(reseller_id))
+admin = client.users.get(id=admin_id)
+```
+
+The API key must have permission to impersonate the selected reseller.
+
 ## Reset remaining data (SDK 2.1.0+)
 
 ```python
@@ -372,3 +385,7 @@ Provider byte amounts are exact decimal **strings**, including history entries;
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
 
 `client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.
+
+## Local independent-customer traffic extension
+
+See [independent customer traffic](docs/independent-customer-traffic.md) for the additive backend behavior of existing data methods. This extension has not been published.

{proxyrequest_sdk-4.3.0 → proxyrequest_sdk-4.4.1}/README.md

@@ -309,6 +309,19 @@ update it. Generation is pinned and CI rejects uncommitted contract changes.
 
 MIT
 
+## Per-call reseller impersonation
+
+The generated resource methods accept an optional `impersonate_user_id`. The
+header applies only to that request, so one client can make scoped and ordinary
+calls, including concurrently.
+
+```python
+child = client.users.get(id=child_id, impersonate_user_id=str(reseller_id))
+admin = client.users.get(id=admin_id)
+```
+
+The API key must have permission to impersonate the selected reseller.
+
 ## Reset remaining data (SDK 2.1.0+)
 
 ```python
@@ -342,3 +355,7 @@ Provider byte amounts are exact decimal **strings**, including history entries;
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
 
 `client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.
+
+## Local independent-customer traffic extension
+
+See [independent customer traffic](docs/independent-customer-traffic.md) for the additive backend behavior of existing data methods. This extension has not been published.

proxyrequest_sdk-4.4.1/docs/independent-customer-traffic.md

@@ -0,0 +1,15 @@
+# Independent customer traffic (backend extension)
+
+The existing users addData / subtractData methods (Python: add_data / subtract_data)
+now support independent customers when authenticated as an active superuser.
+No signature or response type changes are required. Send package_id and positive
+integer-byte data, and persist one Idempotency-Key per logical operation.
+
+Add creates a missing finite residential order without an invoice or wallet debit.
+Subtract removes only available unexpired bytes; insufficient data fails atomically.
+Usage history and existing expiration dates remain unchanged. Reset uses resetData
+(reset_data), with package_id only. Existing parent/child allocation behavior remains.
+
+Independent customer grants require the corresponding PapaProxy API update.
+The SDK release alone does not enable this server-side capability. Existing
+released SDK methods can serialize the same requests.