bytekit-sdk 0.8.2__tar.gz → 0.9.1__tar.gz

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/CHANGELOG.md

@@ -5,6 +5,38 @@ PyPI distribution: `bytekit-sdk`. Import name: `bytekit`.
 
 ## Unreleased
 
+## 0.9.1
+
+_Release cut 2026-09-30._
+
+### Changed
+
+- **Bulk job models add `total_billed_bytes`** (#5021) — new `Union[None, int]` on the bulk job
+  response models (`CreateBulkResponse202`, `GetBulkResponse200`/`202`, `DeleteBulkResponse200`,
+  and the create/get models of `/v1/scrape/bulk` and `/v1/fetch/bulk`) and on
+  `BulkCompletedWebhook`: the bandwidth billed for the job, in bytes,
+  after multipliers. `None` on the create response and for a bulk that predates the field.
+  `total_credits_charged` and the bulk item `credits_charged` are deprecated in the spec and
+  report `0` under the `dual` and `bytes` billing modes. Additive, patch-level. Regenerated from
+  `docs/api/openapi.yaml`.
+
+## 0.9.0
+
+_Release cut 2026-09-24._
+
+### Changed
+
+- **`CreateSearchResponse502` is renamed `CreateSearchResponse503`** (#4891, BREAKING), and
+  `CreateSearchResponse502Error` is renamed `CreateSearchResponse503Error`. The gateway now answers
+  a search-provider failure with HTTP `503` instead of `502`, because Cloudflare replaced the `502`
+  body with its own plain-text page and the `search_provider_error` code never reached the caller.
+  The body shape is unchanged. Regenerated from `docs/api/openapi.yaml`.
+- **`get_fetch` and `post_fetch` no longer declare a `502` response** (#4891). The gateway relays
+  a target's `502` or `504` at HTTP `503`, with the true upstream status kept in the body's
+  `error.http_status`, and the `503` branch already parsed that `Error` envelope. A `502` is now
+  undocumented, so the default client raises `bytekit.errors.UnexpectedStatus` for it. Regenerated
+  from `docs/api/openapi.yaml`.
+
 ## 0.8.2
 
 _Release cut 2026-09-23._

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: bytekit-sdk
-Version: 0.8.2
+Version: 0.9.1
 Summary: Official Python SDK for the ByteKit API
 Project-URL: Homepage, https://bytekit.com
 Project-URL: Repository, https://github.com/Hunt-Labs-Inc/ByteKit

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/pyproject.toml

@@ -7,7 +7,7 @@
 # `pip install bytekit-sdk` yields a working `import bytekit`. Mirrors the npm sibling
 # @hunt-labs/bytekit-sdk.
 name = "bytekit-sdk"
-version = "0.8.2"
+version = "0.9.1"
 description = "Official Python SDK for the ByteKit API"
 readme = "README.md"
 requires-python = ">=3.10"

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/api/fetch/get_fetch.py

@@ -66,10 +66,6 @@ def _parse_response(
         response_429 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
         return response_429
-    if response.status_code == 502:
-        response_502 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
-
-        return response_502
     if response.status_code == 503:
         response_503 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/api/fetch/post_fetch.py

@@ -50,10 +50,6 @@ def _parse_response(
         response_429 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
         return response_429
-    if response.status_code == 502:
-        response_502 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
-
-        return response_502
     if response.status_code == 503:
         response_503 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/api/search/create_search.py

@@ -6,7 +6,7 @@ from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.create_search_body import CreateSearchBody
 from ...models.create_search_response_200 import CreateSearchResponse200
-from ...models.create_search_response_502 import CreateSearchResponse502
+from ...models.create_search_response_503 import CreateSearchResponse503
 from ...models.error import Error
 from ...types import Response
 
@@ -32,7 +32,7 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     if response.status_code == 200:
         response_200 = errors.bytekit_parse(CreateSearchResponse200.from_dict, client=client, response=response)
 
@@ -53,10 +53,10 @@ def _parse_response(
         response_500 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
         return response_500
-    if response.status_code == 502:
-        response_502 = errors.bytekit_parse(CreateSearchResponse502.from_dict, client=client, response=response)
+    if response.status_code == 503:
+        response_503 = errors.bytekit_parse(CreateSearchResponse503.from_dict, client=client, response=response)
 
-        return response_502
+        return response_503
     if client.raise_on_unexpected_status:
         raise errors.bytekit_unexpected(response)  # BYTEKIT-OP-GUARD
     else:
@@ -65,7 +65,7 @@ def _parse_response(
 
 def _build_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Response[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     return Response(
         status_code=errors.bytekit_status_code(response.status_code),  # BYTEKIT-STATUS-COERCE
         content=response.content,
@@ -78,7 +78,7 @@ def sync_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateSearchBody,
-) -> Response[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Response[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     """Search the web
 
      Runs a web search for `query` and returns ranked organic results with
@@ -100,7 +100,7 @@ def sync_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]
+        Response[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]
     """
 
     kwargs = _get_kwargs(
@@ -118,7 +118,7 @@ def sync(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateSearchBody,
-) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     """Search the web
 
      Runs a web search for `query` and returns ranked organic results with
@@ -140,7 +140,7 @@ def sync(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[CreateSearchResponse200, CreateSearchResponse502, Error]
+        Union[CreateSearchResponse200, CreateSearchResponse503, Error]
     """
 
     return sync_detailed(
@@ -153,7 +153,7 @@ async def asyncio_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateSearchBody,
-) -> Response[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Response[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     """Search the web
 
      Runs a web search for `query` and returns ranked organic results with
@@ -175,7 +175,7 @@ async def asyncio_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]
+        Response[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]
     """
 
     kwargs = _get_kwargs(
@@ -191,7 +191,7 @@ async def asyncio(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateSearchBody,
-) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse502, Error]]:
+) -> Optional[Union[CreateSearchResponse200, CreateSearchResponse503, Error]]:
     """Search the web
 
      Runs a web search for `query` and returns ranked organic results with
@@ -213,7 +213,7 @@ async def asyncio(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[CreateSearchResponse200, CreateSearchResponse502, Error]
+        Union[CreateSearchResponse200, CreateSearchResponse503, Error]
     """
 
     return (

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/__init__.py

@@ -89,8 +89,8 @@ from .create_search_response_200_results_item import CreateSearchResponse200Resu
 from .create_search_response_200_results_item_image import (
     CreateSearchResponse200ResultsItemImage,
 )
-from .create_search_response_502 import CreateSearchResponse502
-from .create_search_response_502_error import CreateSearchResponse502Error
+from .create_search_response_503 import CreateSearchResponse503
+from .create_search_response_503_error import CreateSearchResponse503Error
 from .credit_balance import CreditBalance
 from .delete_bulk_response_200 import DeleteBulkResponse200
 from .delete_bulk_response_200_status import DeleteBulkResponse200Status
@@ -336,8 +336,8 @@ __all__ = (
     "CreateSearchResponse200",
     "CreateSearchResponse200ResultsItem",
     "CreateSearchResponse200ResultsItemImage",
-    "CreateSearchResponse502",
-    "CreateSearchResponse502Error",
+    "CreateSearchResponse503",
+    "CreateSearchResponse503Error",
     "CreditBalance",
     "DeleteBulkResponse200",
     "DeleteBulkResponse200Status",

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/bulk_completed_webhook.py

@@ -117,7 +117,12 @@ class BulkCompletedWebhook:
         total (int):
         completed (int):
         failed (int):
-        total_credits_charged (float):
+        total_credits_charged (float): Deprecated: bulk jobs are billed on bandwidth, read
+            `total_billed_bytes`. 0 under the `dual` and `bytes` billing modes.
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the
+            settled amount after multipliers. None for a bulk with a completed child missing
+            from the sum (completed before the field, or with no settled amount), never a
+            partial sum.
         webhook_url (str):
         items (list[BulkCompletedWebhookItemsItem]): Complete item records included before
             the 500-item or 1-MiB manifest bound.
@@ -137,6 +142,7 @@ class BulkCompletedWebhook:
     completed: int
     failed: int
     total_credits_charged: float
+    total_billed_bytes: Union[None, int]
     webhook_url: str
     items: list["BulkCompletedWebhookItemsItem"]
     recovery_api: BulkCompletedWebhookRecoveryApi
@@ -159,6 +165,7 @@ class BulkCompletedWebhook:
                 "completed": self.completed,
                 "failed": self.failed,
                 "total_credits_charged": self.total_credits_charged,
+                "total_billed_bytes": self.total_billed_bytes,
                 "webhook_url": self.webhook_url,
                 "items": [item.to_dict() for item in self.items],
                 "recovery_api": self.recovery_api,
@@ -183,6 +190,7 @@ class BulkCompletedWebhook:
             completed=d.pop("completed"),
             failed=d.pop("failed"),
             total_credits_charged=d.pop("total_credits_charged"),
+            total_billed_bytes=d.pop("total_billed_bytes"),
             webhook_url=d.pop("webhook_url"),
             items=[BulkCompletedWebhookItemsItem.from_dict(i) for i in d.pop("items")],
             recovery_api=d.pop("recovery_api"),

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/create_bulk_response_202.py

@@ -27,10 +27,13 @@ class CreateBulkResponse202:
         failed (int):
         created_at (datetime.datetime):
         completed_at (Union[None, datetime.datetime]):
-        total_credits_charged (Union[None, float]): Always null on the create response — the job has not been billed yet
-            (routes/bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are
-            NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share
-            one shape.
+        total_credits_charged (Union[None, float]): Deprecated: bulk jobs are billed on bandwidth — read
+            `total_billed_bytes`. Reports `0` under the `dual` and `bytes` billing modes, where no credits are drawn. Under
+            `credits` it is always null on the create response — the job has not been billed yet (routes/bulk.ts builds the
+            202 body from a partial job row).
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the settled amount after
+            multipliers, summed over every settled child's `billing.billed_bytes` across the whole job (not raw wire bytes,
+            not just this page). Always null on the create response — nothing has settled yet.
         estimated_credits (Union[None, float]): Estimated credits at submission time. Null in GET responses. Fetch-bulk
             items use the raw fetch bandwidth billing factor.
         webhook_url (str): Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason
@@ -45,6 +48,7 @@ class CreateBulkResponse202:
     created_at: datetime.datetime
     completed_at: Union[None, datetime.datetime]
     total_credits_charged: Union[None, float]
+    total_billed_bytes: Union[None, int]
     estimated_credits: Union[None, float]
     webhook_url: str
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -71,6 +75,9 @@ class CreateBulkResponse202:
         total_credits_charged: Union[None, float]
         total_credits_charged = self.total_credits_charged
 
+        total_billed_bytes: Union[None, int]
+        total_billed_bytes = self.total_billed_bytes
+
         estimated_credits: Union[None, float]
         estimated_credits = self.estimated_credits
 
@@ -88,6 +95,7 @@ class CreateBulkResponse202:
                 "created_at": created_at,
                 "completed_at": completed_at,
                 "total_credits_charged": total_credits_charged,
+                "total_billed_bytes": total_billed_bytes,
                 "estimated_credits": estimated_credits,
                 "webhook_url": webhook_url,
             }
@@ -134,6 +142,13 @@ class CreateBulkResponse202:
             d.pop("total_credits_charged")
         )
 
+        def _parse_total_billed_bytes(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        total_billed_bytes = _parse_total_billed_bytes(d.pop("total_billed_bytes"))
+
         def _parse_estimated_credits(data: object) -> Union[None, float]:
             if data is None:
                 return data
@@ -152,6 +167,7 @@ class CreateBulkResponse202:
             created_at=created_at,
             completed_at=completed_at,
             total_credits_charged=total_credits_charged,
+            total_billed_bytes=total_billed_bytes,
             estimated_credits=estimated_credits,
             webhook_url=webhook_url,
         )

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/create_fetch_bulk_response_202.py

@@ -29,10 +29,13 @@ class CreateFetchBulkResponse202:
         failed (int):
         created_at (datetime.datetime):
         completed_at (Union[None, datetime.datetime]):
-        total_credits_charged (Union[None, float]): Always null on the create response — the job has not been billed yet
-            (routes/fetch-bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are
-            NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share
-            one shape.
+        total_credits_charged (Union[None, float]): Deprecated: bulk jobs are billed on bandwidth — read
+            `total_billed_bytes`. Reports `0` under the `dual` and `bytes` billing modes, where no credits are drawn. Under
+            `credits` it is always null on the create response — the job has not been billed yet (routes/fetch-bulk.ts
+            builds the 202 body from a partial job row).
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the settled amount after
+            multipliers, summed over every settled child's `billing.billed_bytes` across the whole job (not raw wire bytes,
+            not just this page). Always null on the create response — nothing has settled yet.
         estimated_credits (Union[None, float]): Estimated credits at submission time. Null in GET responses. Fetch items
             are raw passthrough requests and use the raw fetch bandwidth billing factor.
         webhook_url (str): Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason
@@ -47,6 +50,7 @@ class CreateFetchBulkResponse202:
     created_at: datetime.datetime
     completed_at: Union[None, datetime.datetime]
     total_credits_charged: Union[None, float]
+    total_billed_bytes: Union[None, int]
     estimated_credits: Union[None, float]
     webhook_url: str
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -73,6 +77,9 @@ class CreateFetchBulkResponse202:
         total_credits_charged: Union[None, float]
         total_credits_charged = self.total_credits_charged
 
+        total_billed_bytes: Union[None, int]
+        total_billed_bytes = self.total_billed_bytes
+
         estimated_credits: Union[None, float]
         estimated_credits = self.estimated_credits
 
@@ -90,6 +97,7 @@ class CreateFetchBulkResponse202:
                 "created_at": created_at,
                 "completed_at": completed_at,
                 "total_credits_charged": total_credits_charged,
+                "total_billed_bytes": total_billed_bytes,
                 "estimated_credits": estimated_credits,
                 "webhook_url": webhook_url,
             }
@@ -136,6 +144,13 @@ class CreateFetchBulkResponse202:
             d.pop("total_credits_charged")
         )
 
+        def _parse_total_billed_bytes(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        total_billed_bytes = _parse_total_billed_bytes(d.pop("total_billed_bytes"))
+
         def _parse_estimated_credits(data: object) -> Union[None, float]:
             if data is None:
                 return data
@@ -154,6 +169,7 @@ class CreateFetchBulkResponse202:
             created_at=created_at,
             completed_at=completed_at,
             total_credits_charged=total_credits_charged,
+            total_billed_bytes=total_billed_bytes,
             estimated_credits=estimated_credits,
             webhook_url=webhook_url,
         )

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/create_scrape_bulk_response_202.py

@@ -29,10 +29,13 @@ class CreateScrapeBulkResponse202:
         failed (int):
         created_at (datetime.datetime):
         completed_at (Union[None, datetime.datetime]):
-        total_credits_charged (Union[None, float]): Always null on the create response — the job has not been billed yet
-            (routes/scrape-bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are
-            NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share
-            one shape.
+        total_credits_charged (Union[None, float]): Deprecated: bulk jobs are billed on bandwidth — read
+            `total_billed_bytes`. Reports `0` under the `dual` and `bytes` billing modes, where no credits are drawn. Under
+            `credits` it is always null on the create response — the job has not been billed yet (routes/scrape-bulk.ts
+            builds the 202 body from a partial job row).
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the settled amount after
+            multipliers, summed over every settled child's `billing.billed_bytes` across the whole job (not raw wire bytes,
+            not just this page). Always null on the create response — nothing has settled yet.
         estimated_credits (Union[None, float]): Estimated credits at submission time. Null in GET responses. Fetch-bulk
             items use the raw fetch bandwidth billing factor.
         webhook_url (str): Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason
@@ -47,6 +50,7 @@ class CreateScrapeBulkResponse202:
     created_at: datetime.datetime
     completed_at: Union[None, datetime.datetime]
     total_credits_charged: Union[None, float]
+    total_billed_bytes: Union[None, int]
     estimated_credits: Union[None, float]
     webhook_url: str
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -73,6 +77,9 @@ class CreateScrapeBulkResponse202:
         total_credits_charged: Union[None, float]
         total_credits_charged = self.total_credits_charged
 
+        total_billed_bytes: Union[None, int]
+        total_billed_bytes = self.total_billed_bytes
+
         estimated_credits: Union[None, float]
         estimated_credits = self.estimated_credits
 
@@ -90,6 +97,7 @@ class CreateScrapeBulkResponse202:
                 "created_at": created_at,
                 "completed_at": completed_at,
                 "total_credits_charged": total_credits_charged,
+                "total_billed_bytes": total_billed_bytes,
                 "estimated_credits": estimated_credits,
                 "webhook_url": webhook_url,
             }
@@ -136,6 +144,13 @@ class CreateScrapeBulkResponse202:
             d.pop("total_credits_charged")
         )
 
+        def _parse_total_billed_bytes(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        total_billed_bytes = _parse_total_billed_bytes(d.pop("total_billed_bytes"))
+
         def _parse_estimated_credits(data: object) -> Union[None, float]:
             if data is None:
                 return data
@@ -154,6 +169,7 @@ class CreateScrapeBulkResponse202:
             created_at=created_at,
             completed_at=completed_at,
             total_credits_charged=total_credits_charged,
+            total_billed_bytes=total_billed_bytes,
             estimated_credits=estimated_credits,
             webhook_url=webhook_url,
         )

bytekit_sdk-0.8.2/src/bytekit/models/create_search_response_502.py → bytekit_sdk-0.9.1/src/bytekit/models/create_search_response_503.py

@@ -3,23 +3,23 @@ from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 
-from ..models.create_search_response_502_error import CreateSearchResponse502Error
+from ..models.create_search_response_503_error import CreateSearchResponse503Error
 
-T = TypeVar("T", bound="CreateSearchResponse502")
+T = TypeVar("T", bound="CreateSearchResponse503")
 
 
 @_attrs_define
-class CreateSearchResponse502:
+class CreateSearchResponse503:
     """
     Example:
         {'error': 'search_provider_error'}
 
     Attributes:
-        error (CreateSearchResponse502Error): Fixed vendor-masked error code. Always `search_provider_error`; the
+        error (CreateSearchResponse503Error): Fixed vendor-masked error code. Always `search_provider_error`; the
             upstream provider's identity and failure detail are withheld by design.
     """
 
-    error: CreateSearchResponse502Error
+    error: CreateSearchResponse503Error
 
     def to_dict(self) -> dict[str, Any]:
         error = self.error.value
@@ -37,10 +37,10 @@ class CreateSearchResponse502:
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         d = dict(src_dict)
-        error = CreateSearchResponse502Error(d.pop("error"))
+        error = CreateSearchResponse503Error(d.pop("error"))
 
-        create_search_response_502 = cls(
+        create_search_response_503 = cls(
             error=error,
         )
 
-        return create_search_response_502
+        return create_search_response_503

bytekit_sdk-0.8.2/src/bytekit/models/create_search_response_502_error.py → bytekit_sdk-0.9.1/src/bytekit/models/create_search_response_503_error.py

@@ -1,7 +1,7 @@
 from enum import Enum
 
 
-class CreateSearchResponse502Error(str, Enum):
+class CreateSearchResponse503Error(str, Enum):
     SEARCH_PROVIDER_ERROR = "search_provider_error"
 
     def __str__(self) -> str:

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/delete_bulk_response_200.py

@@ -27,8 +27,14 @@ class DeleteBulkResponse200:
         failed (int):
         created_at (datetime.datetime):
         completed_at (Union[None, datetime.datetime]):
-        total_credits_charged (Union[None, float]): Total credits billed for the job. Null until the job is billed.
-            Fractional — credits are NUMERIC(10,2).
+        total_credits_charged (Union[None, float]): Deprecated: bulk jobs are billed on bandwidth — read
+            `total_billed_bytes`. Reports `0` under the `dual` and `bytes` billing modes, where no credits are drawn. Under
+            `credits` it is the total credits billed for the job, null until the job is billed; fractional — credits are
+            NUMERIC(10,2).
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the settled amount after
+            multipliers, summed over every settled child's `billing.billed_bytes` across the whole job (not raw wire bytes,
+            not just this page). Null for a bulk with a completed child missing from the sum (completed before this field,
+            or with no settled amount) — never a partial sum.
         estimated_credits (Union[None, float]): Null in cancel responses (computed at submission time only).
         webhook_url (str): Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason
             scheme_unsupported)
@@ -42,6 +48,7 @@ class DeleteBulkResponse200:
     created_at: datetime.datetime
     completed_at: Union[None, datetime.datetime]
     total_credits_charged: Union[None, float]
+    total_billed_bytes: Union[None, int]
     estimated_credits: Union[None, float]
     webhook_url: str
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -68,6 +75,9 @@ class DeleteBulkResponse200:
         total_credits_charged: Union[None, float]
         total_credits_charged = self.total_credits_charged
 
+        total_billed_bytes: Union[None, int]
+        total_billed_bytes = self.total_billed_bytes
+
         estimated_credits: Union[None, float]
         estimated_credits = self.estimated_credits
 
@@ -85,6 +95,7 @@ class DeleteBulkResponse200:
                 "created_at": created_at,
                 "completed_at": completed_at,
                 "total_credits_charged": total_credits_charged,
+                "total_billed_bytes": total_billed_bytes,
                 "estimated_credits": estimated_credits,
                 "webhook_url": webhook_url,
             }
@@ -131,6 +142,13 @@ class DeleteBulkResponse200:
             d.pop("total_credits_charged")
         )
 
+        def _parse_total_billed_bytes(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        total_billed_bytes = _parse_total_billed_bytes(d.pop("total_billed_bytes"))
+
         def _parse_estimated_credits(data: object) -> Union[None, float]:
             if data is None:
                 return data
@@ -149,6 +167,7 @@ class DeleteBulkResponse200:
             created_at=created_at,
             completed_at=completed_at,
             total_credits_charged=total_credits_charged,
+            total_billed_bytes=total_billed_bytes,
             estimated_credits=estimated_credits,
             webhook_url=webhook_url,
         )

{bytekit_sdk-0.8.2 → bytekit_sdk-0.9.1}/src/bytekit/models/get_bulk_response_200.py

@@ -27,8 +27,14 @@ class GetBulkResponse200:
         failed (int):
         created_at (datetime.datetime):
         completed_at (Union[None, datetime.datetime]):
-        total_credits_charged (Union[None, float]): Total credits billed for the job. Null until the job is billed.
-            Fractional — credits are NUMERIC(10,2).
+        total_credits_charged (Union[None, float]): Deprecated: bulk jobs are billed on bandwidth — read
+            `total_billed_bytes`. Reports `0` under the `dual` and `bytes` billing modes, where no credits are drawn. Under
+            `credits` it is the total credits billed for the job, null until the job is billed; fractional — credits are
+            NUMERIC(10,2).
+        total_billed_bytes (Union[None, int]): Bandwidth billed for the job, in bytes: the settled amount after
+            multipliers, summed over every settled child's `billing.billed_bytes` across the whole job (not raw wire bytes,
+            not just this page). Null for a bulk with a completed child missing from the sum (completed before this field,
+            or with no settled amount) — never a partial sum.
         estimated_credits (Union[None, float]): Null in GET responses (computed at submission time only).
         webhook_url (str): Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason
             scheme_unsupported)
@@ -42,6 +48,7 @@ class GetBulkResponse200:
     created_at: datetime.datetime
     completed_at: Union[None, datetime.datetime]
     total_credits_charged: Union[None, float]
+    total_billed_bytes: Union[None, int]
     estimated_credits: Union[None, float]
     webhook_url: str
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -68,6 +75,9 @@ class GetBulkResponse200:
         total_credits_charged: Union[None, float]
         total_credits_charged = self.total_credits_charged
 
+        total_billed_bytes: Union[None, int]
+        total_billed_bytes = self.total_billed_bytes
+
         estimated_credits: Union[None, float]
         estimated_credits = self.estimated_credits
 
@@ -85,6 +95,7 @@ class GetBulkResponse200:
                 "created_at": created_at,
                 "completed_at": completed_at,
                 "total_credits_charged": total_credits_charged,
+                "total_billed_bytes": total_billed_bytes,
                 "estimated_credits": estimated_credits,
                 "webhook_url": webhook_url,
             }
@@ -131,6 +142,13 @@ class GetBulkResponse200:
             d.pop("total_credits_charged")
         )
 
+        def _parse_total_billed_bytes(data: object) -> Union[None, int]:
+            if data is None:
+                return data
+            return cast(Union[None, int], data)
+
+        total_billed_bytes = _parse_total_billed_bytes(d.pop("total_billed_bytes"))
+
         def _parse_estimated_credits(data: object) -> Union[None, float]:
             if data is None:
                 return data
@@ -149,6 +167,7 @@ class GetBulkResponse200:
             created_at=created_at,
             completed_at=completed_at,
             total_credits_charged=total_credits_charged,
+            total_billed_bytes=total_billed_bytes,
             estimated_credits=estimated_credits,
             webhook_url=webhook_url,
         )