bytekit-sdk 0.9.0__tar.gz → 0.9.2__tar.gz

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/CHANGELOG.md

@@ -5,6 +5,32 @@ PyPI distribution: `bytekit-sdk`. Import name: `bytekit`.
 
 ## Unreleased
 
+## 0.9.2
+
+_Release cut 2026-10-02._
+
+### Changed
+
+- **Account `terms_version` docstring describes the new onboarding contract** (#5055) — an empty
+  string now means the account has not accepted the Terms yet (bootstrap no longer records
+  acceptance; `POST /v1/account/accept-terms` does). Docstring only, no model field changes.
+  Regenerated from `docs/api/openapi.yaml`.
+
+## 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._

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: bytekit-sdk
-Version: 0.9.0
+Version: 0.9.2
 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.9.0 → bytekit_sdk-0.9.2}/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.9.0"
+version = "0.9.2"
 description = "Official Python SDK for the ByteKit API"
 readme = "README.md"
 requires-python = ">=3.10"

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/src/bytekit/models/account_session_response.py

@@ -36,8 +36,9 @@ class AccountSessionResponse:
             owner_user_id (Union[None, str]): Prefixed user id of the calling admin user. Null for non-admin members.
             notifications (AccountSessionResponseNotifications): Account notification preferences (bandwidth alerts).
             terms_version (str): The Terms of Service version this account has accepted. An empty string means the account
-                predates clickwrap acceptance (issue #1025). The dashboard diffs this against the published current version to
-                decide whether to show the re-acceptance prompt.
+                has not accepted the Terms yet; acceptance is recorded only by `POST /v1/account/accept-terms`, never by
+                bootstrap (issue #5055). The dashboard diffs this against the published current version to decide whether to
+                show the re-acceptance prompt.
             created_at (datetime.datetime):
             has_activity (bool): True once the account has SUCCESSFULLY COMPLETED at least one billable request (a
                 scrape/screenshot/fetch/… that settled and was charged credits), regardless of whether it was authenticated with

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/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.9.0 → bytekit_sdk-0.9.2}/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.9.0 → bytekit_sdk-0.9.2}/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.9.0 → bytekit_sdk-0.9.2}/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.9.0 → bytekit_sdk-0.9.2}/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.9.0 → bytekit_sdk-0.9.2}/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,
         )

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/src/bytekit/models/get_bulk_response_202.py

@@ -27,8 +27,14 @@ class GetBulkResponse202:
         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 GetBulkResponse202:
     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 GetBulkResponse202:
         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 GetBulkResponse202:
                 "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 GetBulkResponse202:
             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 GetBulkResponse202:
             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.9.0 → bytekit_sdk-0.9.2}/src/bytekit/models/get_fetch_bulk_response_200.py

@@ -37,8 +37,14 @@ class GetFetchBulkResponse200:
         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)
@@ -57,6 +63,7 @@ class GetFetchBulkResponse200:
     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
     next_cursor: Union[None, str]
@@ -95,6 +102,9 @@ class GetFetchBulkResponse200:
         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
 
@@ -127,6 +137,7 @@ class GetFetchBulkResponse200:
                 "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,
                 "next_cursor": next_cursor,
@@ -183,6 +194,13 @@ class GetFetchBulkResponse200:
             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
@@ -242,6 +260,7 @@ class GetFetchBulkResponse200:
             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,
             next_cursor=next_cursor,

{bytekit_sdk-0.9.0 → bytekit_sdk-0.9.2}/src/bytekit/models/get_fetch_bulk_response_202.py

@@ -37,8 +37,14 @@ class GetFetchBulkResponse202:
         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)
@@ -57,6 +63,7 @@ class GetFetchBulkResponse202:
     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
     next_cursor: Union[None, str]
@@ -95,6 +102,9 @@ class GetFetchBulkResponse202:
         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
 
@@ -127,6 +137,7 @@ class GetFetchBulkResponse202:
                 "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,
                 "next_cursor": next_cursor,
@@ -183,6 +194,13 @@ class GetFetchBulkResponse202:
             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
@@ -242,6 +260,7 @@ class GetFetchBulkResponse202:
             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,
             next_cursor=next_cursor,