proxyrequest-sdk 4.2.0__tar.gz → 4.2.1__tar.gz

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to the ProxyRequest Python SDK are documented here.
 
 ## Unreleased
 
+## 4.2.1 (2026-10-05)
+
+- Allow an explicit zero invoice total for free product purchases; setting any explicit total requires superuser authorization.
+- Restore PostgreSQL integer bounds and int64 formats in the bundled OpenAPI contract and regenerate the SDK.
+
 ## 4.2.0 (2026-10-05)
 
 - Add the optional price_total invoice creation field.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyrequest-sdk
-Version: 4.2.0
+Version: 4.2.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/

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/docs/reference/sdk-reference.json

@@ -4,7 +4,7 @@
     "id": "python",
     "label": "Python",
     "language": "Python",
-    "version": "4.2.0",
+    "version": "4.2.1",
     "package": "proxyrequest-sdk",
     "runtime": "Python 3.11 or later",
     "install": "python -m pip install proxyrequest-sdk",
@@ -17,7 +17,7 @@
       "operations": 85,
       "repository": "papaproxy/api",
       "schemas": 142,
-      "sha256": "08b890bf82142b5a60d198ef7cf53f5cbc073e8f4a44b7b7994b7a49baae4a88",
+      "sha256": "44538b2e5f651dc95ff0883b62239bb06b8803caf537d78e5a815e289a6545e5",
       "source": "openapi.yml"
     }
   },
@@ -3105,11 +3105,11 @@
           ],
           "example": {
             "language": "python",
-            "code": "result = client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           },
           "asyncExample": {
             "language": "python",
-            "code": "result = await async_client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = await async_client.coupons.create(\n        body=models.CouponCreateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           }
         },
         {
@@ -3362,11 +3362,11 @@
           ],
           "example": {
             "language": "python",
-            "code": "result = client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           },
           "asyncExample": {
             "language": "python",
-            "code": "result = await async_client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': 1, 'type': 'free_data'}),\n    )"
+            "code": "result = await async_client.coupons.replace(\n        id='550e8400-e29b-41d4-a716-446655440000',\n        body=models.CouponUpdateRequest.from_dict({'value': -9223372036854775808, 'type': 'free_data'}),\n    )"
           }
         },
         {
@@ -14264,7 +14264,7 @@
           "type": "int",
           "required": false,
           "default": null,
-          "description": "Optional final invoice total in the smallest currency unit, including tax and discounts. For a balance invoice, this is also the balance credit and takes precedence over amount. Only superusers or active superuser API keys may supply it, including during API-key impersonation; coupon_code cannot be supplied with price_total.",
+          "description": "Optional final invoice total in the smallest currency unit, including tax and discounts. Zero is allowed for a free product purchase. For a balance invoice, this is also the balance credit, must satisfy the balance top-up limits, and takes precedence over amount. Only superusers or active superuser API keys may supply it, including zero and during API-key impersonation; coupon_code cannot be supplied with price_total.",
           "enum": null,
           "modelRefs": []
         },

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/openapi/openapi.yaml

@@ -17983,6 +17983,9 @@ components:
           readOnly: true
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18000,6 +18003,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18051,6 +18056,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18074,6 +18082,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18166,6 +18176,9 @@ components:
           readOnly: true
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18183,6 +18196,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18242,6 +18257,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -18266,6 +18284,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -18699,11 +18719,13 @@ components:
             be left blank.
         connection_limit:
           type: integer
+          maximum: 2147483647
           minimum: -1
           description: The maximum number of concurrent connections allowed for this
             package.
         quantity:
           type: integer
+          maximum: 2147483647
           minimum: 0
           description: The number of proxies to assign.
         data:
@@ -18919,13 +18941,14 @@ components:
         price_total:
           type: integer
           maximum: 10000000000
-          minimum: 1
+          minimum: 0
           format: int64
           description: Optional final invoice total in the smallest currency unit,
-            including tax and discounts. For a balance invoice, this is also the balance
-            credit and takes precedence over amount. Only superusers or active superuser
-            API keys may supply it, including during API-key impersonation; coupon_code
-            cannot be supplied with price_total.
+            including tax and discounts. Zero is allowed for a free product purchase.
+            For a balance invoice, this is also the balance credit, must satisfy the
+            balance top-up limits, and takes precedence over amount. Only superusers
+            or active superuser API keys may supply it, including zero and during
+            API-key impersonation; coupon_code cannot be supplied with price_total.
         connection_limit:
           type: integer
           minimum: -1
@@ -19348,6 +19371,9 @@ components:
             order.
         latest_data_top_up:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           title: Latest Top-up (bytes)
           description: Amount of data added to this order in bytes during the most
             recent top-up.
@@ -19464,6 +19490,9 @@ components:
             orders. Not a complete history, and array position is not spending priority.
         latest_data_top_up:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           title: Latest Top-up (bytes)
           description: Amount of data added to this order in bytes during the most
             recent top-up.
@@ -19564,6 +19593,7 @@ components:
           $ref: '#/components/schemas/ProxyTypeEnum'
         order:
           type: integer
+          maximum: 2147483647
           minimum: 0
           description: Display order in the UI. Lower values appear first.
         is_continent_targeting:
@@ -19628,6 +19658,7 @@ components:
             will not enforce any bandwidth limit.
         billing_unlimited:
           type: integer
+          maximum: 2147483647
           minimum: 0
           title: Unlimited Price
           description: Price charged for unlimited data access on this package. Set
@@ -20201,6 +20232,9 @@ components:
       properties:
         value:
           type: integer
+          maximum: 9223372036854775807
+          minimum: -9223372036854775808
+          format: int64
           description: Arbitrary coupon value
         code:
           type: string
@@ -20225,6 +20259,8 @@ components:
           $ref: '#/components/schemas/CouponTypeEnum'
         limit:
           type: integer
+          maximum: 2147483647
+          minimum: -2147483648
           description: Number of times coupon can be used
         valid_until:
           type: string
@@ -20770,6 +20806,7 @@ components:
           readOnly: true
         balance:
           type: integer
+          maximum: 2147483647
           minimum: 0
           title: Balance (cents)
         data:
@@ -21316,6 +21353,7 @@ components:
           maxLength: 150
         balance:
           type: integer
+          maximum: 2147483647
           minimum: 0
         language:
           $ref: '#/components/schemas/LanguageEnum'
@@ -21366,6 +21404,7 @@ components:
           readOnly: true
         connection_limit:
           type: integer
+          maximum: 2147483647
           minimum: -1
           description: The maximum number of concurrent connections allowed for this
             package.

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/openapi/source.json

@@ -7,6 +7,6 @@
   "operations": 85,
   "repository": "papaproxy/api",
   "schemas": 142,
-  "sha256": "08b890bf82142b5a60d198ef7cf53f5cbc073e8f4a44b7b7994b7a49baae4a88",
+  "sha256": "44538b2e5f651dc95ff0883b62239bb06b8803caf537d78e5a815e289a6545e5",
   "source": "openapi.yml"
 }

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "proxyrequest-sdk"
-version = "4.2.0"
+version = "4.2.1"
 description = "Official sync and async Python SDK for the ProxyRequest public API."
 readme = "README.md"
 requires-python = ">=3.11"

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/src/proxyrequest_sdk/_generated/models/invoice_create_request.py

@@ -52,10 +52,10 @@ class InvoiceCreateRequest:
     """ Account balance amount to purchase, in the smallest currency unit. Use for a wallet top-up without
     package_id, not for buying proxy data. """
     price_total: int | Unset = UNSET
-    """ Optional final invoice total in the smallest currency unit, including tax and discounts. For a balance
-    invoice, this is also the balance credit and takes precedence over amount. Only superusers or active superuser
-    API keys may supply it, including during API-key impersonation; coupon_code cannot be supplied with price_total.
-    """
+    """ Optional final invoice total in the smallest currency unit, including tax and discounts. Zero is allowed for
+    a free product purchase. For a balance invoice, this is also the balance credit, must satisfy the balance top-up
+    limits, and takes precedence over amount. Only superusers or active superuser API keys may supply it, including
+    zero and during API-key impersonation; coupon_code cannot be supplied with price_total. """
     connection_limit: int | Unset = UNSET
     expires: int | Unset = UNSET
     """ Optional future expiration as a Unix timestamp in seconds, not milliseconds. Otherwise a positive package

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/tests/test_backend_compatibility.py

@@ -22,6 +22,7 @@ from proxyrequest_sdk.models import (
     Invoice,
     InvoiceCreateRequest,
     InvoiceCreateRequestGatewayEnum,
+    InvoiceCreateRequestStatusEnum,
     InvoiceGatewayEnum,
     InvoiceShort,
     LoginRequest,
@@ -246,6 +247,32 @@ async def test_runtime_user_variants(asynchronous: bool, mode: str) -> None:
         assert ("data" in user.to_dict()) == (mode == "legacy")
 
 
+@pytest.mark.asyncio
+@pytest.mark.parametrize("asynchronous", [False, True])
+@pytest.mark.parametrize("total", [None, 0, 2375, 10_000_000_000])
+async def test_explicit_invoice_totals_are_preserved_on_the_wire(
+    asynchronous: bool, total: int | None
+) -> None:
+    async with mocked_client(
+        asynchronous, [httpx.Response(201, json=FIXTURES["invoice_full"])]
+    ) as (client, requests):
+        await result(
+            client.invoices.create(
+                body=InvoiceCreateRequest(
+                    gateway=InvoiceCreateRequestGatewayEnum.MANUAL,
+                    status=InvoiceCreateRequestStatusEnum.PAID,
+                    data=1_073_741_824,
+                    price_total=UNSET if total is None else total,
+                )
+            )
+        )
+        sent = json.loads(requests[0].content)
+        if total is None:
+            assert "price_total" not in sent
+        else:
+            assert sent["price_total"] == total
+
+
 @pytest.mark.asyncio
 @pytest.mark.parametrize("asynchronous", [False, True])
 async def test_runtime_invoice_variants_and_new_payment_fields(asynchronous: bool) -> None:

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/tests/test_contract.py

@@ -138,7 +138,7 @@ def test_generated_reference_covers_public_operations_and_examples_parse() -> No
         manifest["sdk"]["openapi"]["excludedOperations"]
     )
     assert manifest["schemaVersion"] == 3
-    assert manifest["sdk"]["version"] == "4.2.0"
+    assert manifest["sdk"]["version"] == "4.2.1"
     assert len(methods) == expected
     assert len({method["operationId"] for method in methods}) == len(methods)
     assert len(manifest["models"]) > 100

{proxyrequest_sdk-4.2.0 → proxyrequest_sdk-4.2.1}/uv.lock

@@ -870,7 +870,7 @@ wheels = [
 
 [[package]]
 name = "proxyrequest-sdk"
-version = "4.2.0"
+version = "4.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "attrs" },