lark-billing 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

lark/__init__.py

@@ -9,46 +9,47 @@ if typing.TYPE_CHECKING:
     from .types import (
         Aggregation,
         Aggregation_Count,
-        Aggregation_Custom,
-        Aggregation_Last,
-        Aggregation_Max,
         Aggregation_Sum,
         Amount,
         BillingStateResponse,
         CountAggregationPricingMetricInterface,
         CountAggregationPricingMetricResource,
         CreateCustomerPortalSessionResponse,
-        CreateFixedRateInterface,
+        CreateFixedRateRequest,
         CreatePricingMetricResponse,
-        CreateSimpleUsageBasedRateInterface,
+        CreateSimpleUsageBasedRateRequest,
         CreateSubjectResponse,
         CreateSubscriptionCheckoutSessionResponse,
         CreateUsageEventSummaryResponse,
-        CustomPricingMetricResource,
         FixedRateInterface,
         FlatPrice,
         GetPricingMetricResponse,
         HttpValidationError,
-        LastAggregationPricingMetricResource,
+        InvoiceLineItemResource,
+        InvoiceResource,
+        InvoiceStatus,
+        ListInvoicesResponse,
+        ListPricingMetricsResponse,
         ListRateCardsResponse,
         ListSubjectsResponse,
         ListSubscriptionsResponse,
-        MaxAggregationPricingMetricResource,
         PackagePrice,
         PackagePriceInputRoundingBehavior,
         PackagePriceOutputRoundingBehavior,
         Period,
+        PeriodResource,
         Price,
         Price_Flat,
         Price_Package,
+        PricingMetricResource,
         RateCardResource,
         RateCardResourceBillingInterval,
         RateCardResourceUsageBasedRatesItem,
         RateCardResourceUsageBasedRatesItem_Simple,
         SimpleUsageBasedRateInterface,
-        Status,
         SubjectResource,
         SubscriptionResource,
+        SubscriptionStatus,
         SumAggregationPricingMetricInterface,
         SumAggregationPricingMetricResource,
         ValidationError,
@@ -60,6 +61,7 @@ if typing.TYPE_CHECKING:
         checkout,
         customer_access,
         customer_portal,
+        invoices,
         pricing_metrics,
         rate_cards,
         subjects,
@@ -69,15 +71,16 @@ if typing.TYPE_CHECKING:
     from .client import AsyncLark, Lark
     from .environment import LarkEnvironment
     from .pricing_metrics import PricingMetricAggregation, PricingMetricAggregation_Count, PricingMetricAggregation_Sum
-    from .rate_cards import CreateRateCardRequestBillingInterval
+    from .rate_cards import (
+        CreateRateCardRequestBillingInterval,
+        CreateRateCardRequestUsageBasedRatesItem,
+        CreateRateCardRequestUsageBasedRatesItem_Simple,
+    )
     from .usage_events import CreateUsageEventSummaryRequestAggregationType
     from .version import __version__
 _dynamic_imports: typing.Dict[str, str] = {
     "Aggregation": ".types",
     "Aggregation_Count": ".types",
-    "Aggregation_Custom": ".types",
-    "Aggregation_Last": ".types",
-    "Aggregation_Max": ".types",
     "Aggregation_Sum": ".types",
     "Amount": ".types",
     "AsyncLark": ".client",
@@ -85,44 +88,50 @@ _dynamic_imports: typing.Dict[str, str] = {
     "CountAggregationPricingMetricInterface": ".types",
     "CountAggregationPricingMetricResource": ".types",
     "CreateCustomerPortalSessionResponse": ".types",
-    "CreateFixedRateInterface": ".types",
+    "CreateFixedRateRequest": ".types",
     "CreatePricingMetricResponse": ".types",
     "CreateRateCardRequestBillingInterval": ".rate_cards",
-    "CreateSimpleUsageBasedRateInterface": ".types",
+    "CreateRateCardRequestUsageBasedRatesItem": ".rate_cards",
+    "CreateRateCardRequestUsageBasedRatesItem_Simple": ".rate_cards",
+    "CreateSimpleUsageBasedRateRequest": ".types",
     "CreateSubjectResponse": ".types",
     "CreateSubscriptionCheckoutSessionResponse": ".types",
     "CreateUsageEventSummaryRequestAggregationType": ".usage_events",
     "CreateUsageEventSummaryResponse": ".types",
-    "CustomPricingMetricResource": ".types",
     "FixedRateInterface": ".types",
     "FlatPrice": ".types",
     "GetPricingMetricResponse": ".types",
     "HttpValidationError": ".types",
+    "InvoiceLineItemResource": ".types",
+    "InvoiceResource": ".types",
+    "InvoiceStatus": ".types",
     "Lark": ".client",
     "LarkEnvironment": ".environment",
-    "LastAggregationPricingMetricResource": ".types",
+    "ListInvoicesResponse": ".types",
+    "ListPricingMetricsResponse": ".types",
     "ListRateCardsResponse": ".types",
     "ListSubjectsResponse": ".types",
     "ListSubscriptionsResponse": ".types",
-    "MaxAggregationPricingMetricResource": ".types",
     "PackagePrice": ".types",
     "PackagePriceInputRoundingBehavior": ".types",
     "PackagePriceOutputRoundingBehavior": ".types",
     "Period": ".types",
+    "PeriodResource": ".types",
     "Price": ".types",
     "Price_Flat": ".types",
     "Price_Package": ".types",
     "PricingMetricAggregation": ".pricing_metrics",
     "PricingMetricAggregation_Count": ".pricing_metrics",
     "PricingMetricAggregation_Sum": ".pricing_metrics",
+    "PricingMetricResource": ".types",
     "RateCardResource": ".types",
     "RateCardResourceBillingInterval": ".types",
     "RateCardResourceUsageBasedRatesItem": ".types",
     "RateCardResourceUsageBasedRatesItem_Simple": ".types",
     "SimpleUsageBasedRateInterface": ".types",
-    "Status": ".types",
     "SubjectResource": ".types",
     "SubscriptionResource": ".types",
+    "SubscriptionStatus": ".types",
     "SumAggregationPricingMetricInterface": ".types",
     "SumAggregationPricingMetricResource": ".types",
     "UnprocessableEntityError": ".errors",
@@ -133,6 +142,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "checkout": ".checkout",
     "customer_access": ".customer_access",
     "customer_portal": ".customer_portal",
+    "invoices": ".invoices",
     "pricing_metrics": ".pricing_metrics",
     "rate_cards": ".rate_cards",
     "subjects": ".subjects",
@@ -165,9 +175,6 @@ def __dir__():
 __all__ = [
     "Aggregation",
     "Aggregation_Count",
-    "Aggregation_Custom",
-    "Aggregation_Last",
-    "Aggregation_Max",
     "Aggregation_Sum",
     "Amount",
     "AsyncLark",
@@ -175,44 +182,50 @@ __all__ = [
     "CountAggregationPricingMetricInterface",
     "CountAggregationPricingMetricResource",
     "CreateCustomerPortalSessionResponse",
-    "CreateFixedRateInterface",
+    "CreateFixedRateRequest",
     "CreatePricingMetricResponse",
     "CreateRateCardRequestBillingInterval",
-    "CreateSimpleUsageBasedRateInterface",
+    "CreateRateCardRequestUsageBasedRatesItem",
+    "CreateRateCardRequestUsageBasedRatesItem_Simple",
+    "CreateSimpleUsageBasedRateRequest",
     "CreateSubjectResponse",
     "CreateSubscriptionCheckoutSessionResponse",
     "CreateUsageEventSummaryRequestAggregationType",
     "CreateUsageEventSummaryResponse",
-    "CustomPricingMetricResource",
     "FixedRateInterface",
     "FlatPrice",
     "GetPricingMetricResponse",
     "HttpValidationError",
+    "InvoiceLineItemResource",
+    "InvoiceResource",
+    "InvoiceStatus",
     "Lark",
     "LarkEnvironment",
-    "LastAggregationPricingMetricResource",
+    "ListInvoicesResponse",
+    "ListPricingMetricsResponse",
     "ListRateCardsResponse",
     "ListSubjectsResponse",
     "ListSubscriptionsResponse",
-    "MaxAggregationPricingMetricResource",
     "PackagePrice",
     "PackagePriceInputRoundingBehavior",
     "PackagePriceOutputRoundingBehavior",
     "Period",
+    "PeriodResource",
     "Price",
     "Price_Flat",
     "Price_Package",
     "PricingMetricAggregation",
     "PricingMetricAggregation_Count",
     "PricingMetricAggregation_Sum",
+    "PricingMetricResource",
     "RateCardResource",
     "RateCardResourceBillingInterval",
     "RateCardResourceUsageBasedRatesItem",
     "RateCardResourceUsageBasedRatesItem_Simple",
     "SimpleUsageBasedRateInterface",
-    "Status",
     "SubjectResource",
     "SubscriptionResource",
+    "SubscriptionStatus",
     "SumAggregationPricingMetricInterface",
     "SumAggregationPricingMetricResource",
     "UnprocessableEntityError",
@@ -223,6 +236,7 @@ __all__ = [
     "checkout",
     "customer_access",
     "customer_portal",
+    "invoices",
     "pricing_metrics",
     "rate_cards",
     "subjects",

lark/checkout/client.py

@@ -31,7 +31,8 @@ class CheckoutClient:
         *,
         subject_id: str,
         rate_card_id: str,
-        callback_url: str,
+        success_callback_url: str,
+        cancel_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateSubscriptionCheckoutSessionResponse:
         """
@@ -41,7 +42,11 @@ class CheckoutClient:
 
         rate_card_id : str
 
-        callback_url : str
+        success_callback_url : str
+            The URL to redirect to after the checkout is successful.
+
+        cancel_url : typing.Optional[str]
+            The URL to redirect to after the checkout is cancelled.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -61,11 +66,15 @@ class CheckoutClient:
         client.checkout.create_subscription_checkout_session(
             subject_id="subject_id",
             rate_card_id="rate_card_id",
-            callback_url="callback_url",
+            success_callback_url="https://example.com/callback",
         )
         """
         _response = self._raw_client.create_subscription_checkout_session(
-            subject_id=subject_id, rate_card_id=rate_card_id, callback_url=callback_url, request_options=request_options
+            subject_id=subject_id,
+            rate_card_id=rate_card_id,
+            success_callback_url=success_callback_url,
+            cancel_url=cancel_url,
+            request_options=request_options,
         )
         return _response.data
 
@@ -90,7 +99,8 @@ class AsyncCheckoutClient:
         *,
         subject_id: str,
         rate_card_id: str,
-        callback_url: str,
+        success_callback_url: str,
+        cancel_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateSubscriptionCheckoutSessionResponse:
         """
@@ -100,7 +110,11 @@ class AsyncCheckoutClient:
 
         rate_card_id : str
 
-        callback_url : str
+        success_callback_url : str
+            The URL to redirect to after the checkout is successful.
+
+        cancel_url : typing.Optional[str]
+            The URL to redirect to after the checkout is cancelled.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -125,13 +139,17 @@ class AsyncCheckoutClient:
             await client.checkout.create_subscription_checkout_session(
                 subject_id="subject_id",
                 rate_card_id="rate_card_id",
-                callback_url="callback_url",
+                success_callback_url="https://example.com/callback",
             )
 
 
         asyncio.run(main())
         """
         _response = await self._raw_client.create_subscription_checkout_session(
-            subject_id=subject_id, rate_card_id=rate_card_id, callback_url=callback_url, request_options=request_options
+            subject_id=subject_id,
+            rate_card_id=rate_card_id,
+            success_callback_url=success_callback_url,
+            cancel_url=cancel_url,
+            request_options=request_options,
         )
         return _response.data

lark/checkout/raw_client.py

@@ -25,7 +25,8 @@ class RawCheckoutClient:
         *,
         subject_id: str,
         rate_card_id: str,
-        callback_url: str,
+        success_callback_url: str,
+        cancel_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[CreateSubscriptionCheckoutSessionResponse]:
         """
@@ -35,7 +36,11 @@ class RawCheckoutClient:
 
         rate_card_id : str
 
-        callback_url : str
+        success_callback_url : str
+            The URL to redirect to after the checkout is successful.
+
+        cancel_url : typing.Optional[str]
+            The URL to redirect to after the checkout is cancelled.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -51,7 +56,8 @@ class RawCheckoutClient:
             json={
                 "subject_id": subject_id,
                 "rate_card_id": rate_card_id,
-                "callback_url": callback_url,
+                "success_callback_url": success_callback_url,
+                "cancel_url": cancel_url,
             },
             headers={
                 "content-type": "application/json",
@@ -95,7 +101,8 @@ class AsyncRawCheckoutClient:
         *,
         subject_id: str,
         rate_card_id: str,
-        callback_url: str,
+        success_callback_url: str,
+        cancel_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[CreateSubscriptionCheckoutSessionResponse]:
         """
@@ -105,7 +112,11 @@ class AsyncRawCheckoutClient:
 
         rate_card_id : str
 
-        callback_url : str
+        success_callback_url : str
+            The URL to redirect to after the checkout is successful.
+
+        cancel_url : typing.Optional[str]
+            The URL to redirect to after the checkout is cancelled.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -121,7 +132,8 @@ class AsyncRawCheckoutClient:
             json={
                 "subject_id": subject_id,
                 "rate_card_id": rate_card_id,
-                "callback_url": callback_url,
+                "success_callback_url": success_callback_url,
+                "cancel_url": cancel_url,
             },
             headers={
                 "content-type": "application/json",

lark/client.py

@@ -12,6 +12,7 @@ if typing.TYPE_CHECKING:
     from .checkout.client import AsyncCheckoutClient, CheckoutClient
     from .customer_access.client import AsyncCustomerAccessClient, CustomerAccessClient
     from .customer_portal.client import AsyncCustomerPortalClient, CustomerPortalClient
+    from .invoices.client import AsyncInvoicesClient, InvoicesClient
     from .pricing_metrics.client import AsyncPricingMetricsClient, PricingMetricsClient
     from .rate_cards.client import AsyncRateCardsClient, RateCardsClient
     from .subjects.client import AsyncSubjectsClient, SubjectsClient
@@ -92,6 +93,7 @@ class Lark:
         self._subjects: typing.Optional[SubjectsClient] = None
         self._pricing_metrics: typing.Optional[PricingMetricsClient] = None
         self._customer_access: typing.Optional[CustomerAccessClient] = None
+        self._invoices: typing.Optional[InvoicesClient] = None
 
     @property
     def checkout(self):
@@ -157,6 +159,14 @@ class Lark:
             self._customer_access = CustomerAccessClient(client_wrapper=self._client_wrapper)
         return self._customer_access
 
+    @property
+    def invoices(self):
+        if self._invoices is None:
+            from .invoices.client import InvoicesClient  # noqa: E402
+
+            self._invoices = InvoicesClient(client_wrapper=self._client_wrapper)
+        return self._invoices
+
 
 class AsyncLark:
     """
@@ -231,6 +241,7 @@ class AsyncLark:
         self._subjects: typing.Optional[AsyncSubjectsClient] = None
         self._pricing_metrics: typing.Optional[AsyncPricingMetricsClient] = None
         self._customer_access: typing.Optional[AsyncCustomerAccessClient] = None
+        self._invoices: typing.Optional[AsyncInvoicesClient] = None
 
     @property
     def checkout(self):
@@ -296,6 +307,14 @@ class AsyncLark:
             self._customer_access = AsyncCustomerAccessClient(client_wrapper=self._client_wrapper)
         return self._customer_access
 
+    @property
+    def invoices(self):
+        if self._invoices is None:
+            from .invoices.client import AsyncInvoicesClient  # noqa: E402
+
+            self._invoices = AsyncInvoicesClient(client_wrapper=self._client_wrapper)
+        return self._invoices
+
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: LarkEnvironment) -> str:
     if base_url is not None:

lark/core/client_wrapper.py

@@ -22,10 +22,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "lark-billing/0.0.7",
+            "User-Agent": "lark-billing/0.0.8",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "lark-billing",
-            "X-Fern-SDK-Version": "0.0.7",
+            "X-Fern-SDK-Version": "0.0.8",
             **(self.get_custom_headers() or {}),
         }
         headers["X-API-Key"] = self.api_key

lark/core/http_sse/__init__.py

@@ -0,0 +1,42 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from ._api import EventSource, aconnect_sse, connect_sse
+    from ._exceptions import SSEError
+    from ._models import ServerSentEvent
+_dynamic_imports: typing.Dict[str, str] = {
+    "EventSource": "._api",
+    "SSEError": "._exceptions",
+    "ServerSentEvent": "._models",
+    "aconnect_sse": "._api",
+    "connect_sse": "._api",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["EventSource", "SSEError", "ServerSentEvent", "aconnect_sse", "connect_sse"]

lark/core/http_sse/_api.py

@@ -0,0 +1,112 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import re
+from contextlib import asynccontextmanager, contextmanager
+from typing import Any, AsyncGenerator, AsyncIterator, Iterator, cast
+
+import httpx
+from ._decoders import SSEDecoder
+from ._exceptions import SSEError
+from ._models import ServerSentEvent
+
+
+class EventSource:
+    def __init__(self, response: httpx.Response) -> None:
+        self._response = response
+
+    def _check_content_type(self) -> None:
+        content_type = self._response.headers.get("content-type", "").partition(";")[0]
+        if "text/event-stream" not in content_type:
+            raise SSEError(
+                f"Expected response header Content-Type to contain 'text/event-stream', got {content_type!r}"
+            )
+
+    def _get_charset(self) -> str:
+        """Extract charset from Content-Type header, fallback to UTF-8."""
+        content_type = self._response.headers.get("content-type", "")
+
+        # Parse charset parameter using regex
+        charset_match = re.search(r"charset=([^;\s]+)", content_type, re.IGNORECASE)
+        if charset_match:
+            charset = charset_match.group(1).strip("\"'")
+            # Validate that it's a known encoding
+            try:
+                # Test if the charset is valid by trying to encode/decode
+                "test".encode(charset).decode(charset)
+                return charset
+            except (LookupError, UnicodeError):
+                # If charset is invalid, fall back to UTF-8
+                pass
+
+        # Default to UTF-8 if no charset specified or invalid charset
+        return "utf-8"
+
+    @property
+    def response(self) -> httpx.Response:
+        return self._response
+
+    def iter_sse(self) -> Iterator[ServerSentEvent]:
+        self._check_content_type()
+        decoder = SSEDecoder()
+        charset = self._get_charset()
+
+        buffer = ""
+        for chunk in self._response.iter_bytes():
+            # Decode chunk using detected charset
+            text_chunk = chunk.decode(charset, errors="replace")
+            buffer += text_chunk
+
+            # Process complete lines
+            while "\n" in buffer:
+                line, buffer = buffer.split("\n", 1)
+                line = line.rstrip("\r")
+                sse = decoder.decode(line)
+                # when we reach a "\n\n" => line = ''
+                # => decoder will attempt to return an SSE Event
+                if sse is not None:
+                    yield sse
+
+        # Process any remaining data in buffer
+        if buffer.strip():
+            line = buffer.rstrip("\r")
+            sse = decoder.decode(line)
+            if sse is not None:
+                yield sse
+
+    async def aiter_sse(self) -> AsyncGenerator[ServerSentEvent, None]:
+        self._check_content_type()
+        decoder = SSEDecoder()
+        lines = cast(AsyncGenerator[str, None], self._response.aiter_lines())
+        try:
+            async for line in lines:
+                line = line.rstrip("\n")
+                sse = decoder.decode(line)
+                if sse is not None:
+                    yield sse
+        finally:
+            await lines.aclose()
+
+
+@contextmanager
+def connect_sse(client: httpx.Client, method: str, url: str, **kwargs: Any) -> Iterator[EventSource]:
+    headers = kwargs.pop("headers", {})
+    headers["Accept"] = "text/event-stream"
+    headers["Cache-Control"] = "no-store"
+
+    with client.stream(method, url, headers=headers, **kwargs) as response:
+        yield EventSource(response)
+
+
+@asynccontextmanager
+async def aconnect_sse(
+    client: httpx.AsyncClient,
+    method: str,
+    url: str,
+    **kwargs: Any,
+) -> AsyncIterator[EventSource]:
+    headers = kwargs.pop("headers", {})
+    headers["Accept"] = "text/event-stream"
+    headers["Cache-Control"] = "no-store"
+
+    async with client.stream(method, url, headers=headers, **kwargs) as response:
+        yield EventSource(response)

lark/core/http_sse/_decoders.py

@@ -0,0 +1,61 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from typing import List, Optional
+
+from ._models import ServerSentEvent
+
+
+class SSEDecoder:
+    def __init__(self) -> None:
+        self._event = ""
+        self._data: List[str] = []
+        self._last_event_id = ""
+        self._retry: Optional[int] = None
+
+    def decode(self, line: str) -> Optional[ServerSentEvent]:
+        # See: https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation  # noqa: E501
+
+        if not line:
+            if not self._event and not self._data and not self._last_event_id and self._retry is None:
+                return None
+
+            sse = ServerSentEvent(
+                event=self._event,
+                data="\n".join(self._data),
+                id=self._last_event_id,
+                retry=self._retry,
+            )
+
+            # NOTE: as per the SSE spec, do not reset last_event_id.
+            self._event = ""
+            self._data = []
+            self._retry = None
+
+            return sse
+
+        if line.startswith(":"):
+            return None
+
+        fieldname, _, value = line.partition(":")
+
+        if value.startswith(" "):
+            value = value[1:]
+
+        if fieldname == "event":
+            self._event = value
+        elif fieldname == "data":
+            self._data.append(value)
+        elif fieldname == "id":
+            if "\0" in value:
+                pass
+            else:
+                self._last_event_id = value
+        elif fieldname == "retry":
+            try:
+                self._retry = int(value)
+            except (TypeError, ValueError):
+                pass
+        else:
+            pass  # Field is ignored.
+
+        return None

lark/core/http_sse/_exceptions.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import httpx
+
+
+class SSEError(httpx.TransportError):
+    pass

lark/core/http_sse/_models.py

@@ -0,0 +1,17 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import json
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+@dataclass(frozen=True)
+class ServerSentEvent:
+    event: str = "message"
+    data: str = ""
+    id: str = ""
+    retry: Optional[int] = None
+
+    def json(self) -> Any:
+        """Parse the data field as JSON."""
+        return json.loads(self.data)