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

lark/__init__.py

@@ -9,6 +9,8 @@ if typing.TYPE_CHECKING:
     from .types import (
         Aggregation,
         Aggregation_Count,
+        Aggregation_Last,
+        Aggregation_Max,
         Aggregation_Sum,
         Amount,
         BillingStateResponse,
@@ -16,23 +18,25 @@ if typing.TYPE_CHECKING:
         CountAggregationPricingMetricResource,
         CreateCustomerPortalSessionResponse,
         CreateFixedRateRequest,
-        CreatePricingMetricResponse,
         CreateSimpleUsageBasedRateRequest,
         CreateSubjectResponse,
         CreateSubscriptionCheckoutSessionResponse,
-        CreateUsageEventSummaryResponse,
+        CustomAggregationPricingMetricInterface,
         FixedRateInterface,
         FlatPrice,
-        GetPricingMetricResponse,
         HttpValidationError,
         InvoiceLineItemResource,
         InvoiceResource,
         InvoiceStatus,
+        LastAggregationPricingMetricInterface,
+        LastAggregationPricingMetricResource,
         ListInvoicesResponse,
         ListPricingMetricsResponse,
         ListRateCardsResponse,
         ListSubjectsResponse,
         ListSubscriptionsResponse,
+        MaxAggregationPricingMetricInterface,
+        MaxAggregationPricingMetricResource,
         PackagePrice,
         PackagePriceInputRoundingBehavior,
         PackagePriceOutputRoundingBehavior,
@@ -42,6 +46,7 @@ if typing.TYPE_CHECKING:
         Price_Flat,
         Price_Package,
         PricingMetricResource,
+        PricingMetricSummaryResource,
         RateCardResource,
         RateCardResourceBillingInterval,
         RateCardResourceUsageBasedRatesItem,
@@ -54,7 +59,6 @@ if typing.TYPE_CHECKING:
         SumAggregationPricingMetricResource,
         ValidationError,
         ValidationErrorLocItem,
-        Value,
     )
     from .errors import UnprocessableEntityError
     from . import (
@@ -70,17 +74,26 @@ if typing.TYPE_CHECKING:
     )
     from .client import AsyncLark, Lark
     from .environment import LarkEnvironment
-    from .pricing_metrics import PricingMetricAggregation, PricingMetricAggregation_Count, PricingMetricAggregation_Sum
+    from .pricing_metrics import (
+        PricingMetricAggregation,
+        PricingMetricAggregation_Count,
+        PricingMetricAggregation_Custom,
+        PricingMetricAggregation_Last,
+        PricingMetricAggregation_Max,
+        PricingMetricAggregation_Sum,
+    )
     from .rate_cards import (
         CreateRateCardRequestBillingInterval,
         CreateRateCardRequestUsageBasedRatesItem,
         CreateRateCardRequestUsageBasedRatesItem_Simple,
     )
-    from .usage_events import CreateUsageEventSummaryRequestAggregationType
+    from .usage_events import CreateUsageEventRequestDataValue
     from .version import __version__
 _dynamic_imports: typing.Dict[str, str] = {
     "Aggregation": ".types",
     "Aggregation_Count": ".types",
+    "Aggregation_Last": ".types",
+    "Aggregation_Max": ".types",
     "Aggregation_Sum": ".types",
     "Amount": ".types",
     "AsyncLark": ".client",
@@ -89,29 +102,31 @@ _dynamic_imports: typing.Dict[str, str] = {
     "CountAggregationPricingMetricResource": ".types",
     "CreateCustomerPortalSessionResponse": ".types",
     "CreateFixedRateRequest": ".types",
-    "CreatePricingMetricResponse": ".types",
     "CreateRateCardRequestBillingInterval": ".rate_cards",
     "CreateRateCardRequestUsageBasedRatesItem": ".rate_cards",
     "CreateRateCardRequestUsageBasedRatesItem_Simple": ".rate_cards",
     "CreateSimpleUsageBasedRateRequest": ".types",
     "CreateSubjectResponse": ".types",
     "CreateSubscriptionCheckoutSessionResponse": ".types",
-    "CreateUsageEventSummaryRequestAggregationType": ".usage_events",
-    "CreateUsageEventSummaryResponse": ".types",
+    "CreateUsageEventRequestDataValue": ".usage_events",
+    "CustomAggregationPricingMetricInterface": ".types",
     "FixedRateInterface": ".types",
     "FlatPrice": ".types",
-    "GetPricingMetricResponse": ".types",
     "HttpValidationError": ".types",
     "InvoiceLineItemResource": ".types",
     "InvoiceResource": ".types",
     "InvoiceStatus": ".types",
     "Lark": ".client",
     "LarkEnvironment": ".environment",
+    "LastAggregationPricingMetricInterface": ".types",
+    "LastAggregationPricingMetricResource": ".types",
     "ListInvoicesResponse": ".types",
     "ListPricingMetricsResponse": ".types",
     "ListRateCardsResponse": ".types",
     "ListSubjectsResponse": ".types",
     "ListSubscriptionsResponse": ".types",
+    "MaxAggregationPricingMetricInterface": ".types",
+    "MaxAggregationPricingMetricResource": ".types",
     "PackagePrice": ".types",
     "PackagePriceInputRoundingBehavior": ".types",
     "PackagePriceOutputRoundingBehavior": ".types",
@@ -122,8 +137,12 @@ _dynamic_imports: typing.Dict[str, str] = {
     "Price_Package": ".types",
     "PricingMetricAggregation": ".pricing_metrics",
     "PricingMetricAggregation_Count": ".pricing_metrics",
+    "PricingMetricAggregation_Custom": ".pricing_metrics",
+    "PricingMetricAggregation_Last": ".pricing_metrics",
+    "PricingMetricAggregation_Max": ".pricing_metrics",
     "PricingMetricAggregation_Sum": ".pricing_metrics",
     "PricingMetricResource": ".types",
+    "PricingMetricSummaryResource": ".types",
     "RateCardResource": ".types",
     "RateCardResourceBillingInterval": ".types",
     "RateCardResourceUsageBasedRatesItem": ".types",
@@ -137,7 +156,6 @@ _dynamic_imports: typing.Dict[str, str] = {
     "UnprocessableEntityError": ".errors",
     "ValidationError": ".types",
     "ValidationErrorLocItem": ".types",
-    "Value": ".types",
     "__version__": ".version",
     "checkout": ".checkout",
     "customer_access": ".customer_access",
@@ -175,6 +193,8 @@ def __dir__():
 __all__ = [
     "Aggregation",
     "Aggregation_Count",
+    "Aggregation_Last",
+    "Aggregation_Max",
     "Aggregation_Sum",
     "Amount",
     "AsyncLark",
@@ -183,29 +203,31 @@ __all__ = [
     "CountAggregationPricingMetricResource",
     "CreateCustomerPortalSessionResponse",
     "CreateFixedRateRequest",
-    "CreatePricingMetricResponse",
     "CreateRateCardRequestBillingInterval",
     "CreateRateCardRequestUsageBasedRatesItem",
     "CreateRateCardRequestUsageBasedRatesItem_Simple",
     "CreateSimpleUsageBasedRateRequest",
     "CreateSubjectResponse",
     "CreateSubscriptionCheckoutSessionResponse",
-    "CreateUsageEventSummaryRequestAggregationType",
-    "CreateUsageEventSummaryResponse",
+    "CreateUsageEventRequestDataValue",
+    "CustomAggregationPricingMetricInterface",
     "FixedRateInterface",
     "FlatPrice",
-    "GetPricingMetricResponse",
     "HttpValidationError",
     "InvoiceLineItemResource",
     "InvoiceResource",
     "InvoiceStatus",
     "Lark",
     "LarkEnvironment",
+    "LastAggregationPricingMetricInterface",
+    "LastAggregationPricingMetricResource",
     "ListInvoicesResponse",
     "ListPricingMetricsResponse",
     "ListRateCardsResponse",
     "ListSubjectsResponse",
     "ListSubscriptionsResponse",
+    "MaxAggregationPricingMetricInterface",
+    "MaxAggregationPricingMetricResource",
     "PackagePrice",
     "PackagePriceInputRoundingBehavior",
     "PackagePriceOutputRoundingBehavior",
@@ -216,8 +238,12 @@ __all__ = [
     "Price_Package",
     "PricingMetricAggregation",
     "PricingMetricAggregation_Count",
+    "PricingMetricAggregation_Custom",
+    "PricingMetricAggregation_Last",
+    "PricingMetricAggregation_Max",
     "PricingMetricAggregation_Sum",
     "PricingMetricResource",
+    "PricingMetricSummaryResource",
     "RateCardResource",
     "RateCardResourceBillingInterval",
     "RateCardResourceUsageBasedRatesItem",
@@ -231,7 +257,6 @@ __all__ = [
     "UnprocessableEntityError",
     "ValidationError",
     "ValidationErrorLocItem",
-    "Value",
     "__version__",
     "checkout",
     "customer_access",

lark/checkout/client.py

@@ -39,8 +39,10 @@ class CheckoutClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the checkout for.
 
         rate_card_id : str
+            The ID of the rate card to subscribe to.
 
         success_callback_url : str
             The URL to redirect to after the checkout is successful.
@@ -64,8 +66,8 @@ class CheckoutClient:
             api_key="YOUR_API_KEY",
         )
         client.checkout.create_subscription_checkout_session(
-            subject_id="subject_id",
-            rate_card_id="rate_card_id",
+            subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
+            rate_card_id="rc_AJWMxR81jxoRlli6p13uf3JB",
             success_callback_url="https://example.com/callback",
         )
         """
@@ -107,8 +109,10 @@ class AsyncCheckoutClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the checkout for.
 
         rate_card_id : str
+            The ID of the rate card to subscribe to.
 
         success_callback_url : str
             The URL to redirect to after the checkout is successful.
@@ -137,8 +141,8 @@ class AsyncCheckoutClient:
 
         async def main() -> None:
             await client.checkout.create_subscription_checkout_session(
-                subject_id="subject_id",
-                rate_card_id="rate_card_id",
+                subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
+                rate_card_id="rc_AJWMxR81jxoRlli6p13uf3JB",
                 success_callback_url="https://example.com/callback",
             )
 

lark/checkout/raw_client.py

@@ -33,8 +33,10 @@ class RawCheckoutClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the checkout for.
 
         rate_card_id : str
+            The ID of the rate card to subscribe to.
 
         success_callback_url : str
             The URL to redirect to after the checkout is successful.
@@ -109,8 +111,10 @@ class AsyncRawCheckoutClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the checkout for.
 
         rate_card_id : str
+            The ID of the rate card to subscribe to.
 
         success_callback_url : str
             The URL to redirect to after the checkout is successful.

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.8",
+            "User-Agent": "lark-billing/0.1.0",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "lark-billing",
-            "X-Fern-SDK-Version": "0.0.8",
+            "X-Fern-SDK-Version": "0.1.0",
             **(self.get_custom_headers() or {}),
         }
         headers["X-API-Key"] = self.api_key

lark/customer_portal/client.py

@@ -33,6 +33,7 @@ class CustomerPortalClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the customer portal session for.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -50,7 +51,7 @@ class CustomerPortalClient:
             api_key="YOUR_API_KEY",
         )
         client.customer_portal.create_customer_portal_session(
-            subject_id="subject_id",
+            subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
         )
         """
         _response = self._raw_client.create_customer_portal_session(
@@ -81,6 +82,7 @@ class AsyncCustomerPortalClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the customer portal session for.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -103,7 +105,7 @@ class AsyncCustomerPortalClient:
 
         async def main() -> None:
             await client.customer_portal.create_customer_portal_session(
-                subject_id="subject_id",
+                subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
             )
 
 

lark/customer_portal/raw_client.py

@@ -27,6 +27,7 @@ class RawCustomerPortalClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the customer portal session for.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -86,6 +87,7 @@ class AsyncRawCustomerPortalClient:
         Parameters
         ----------
         subject_id : str
+            The ID of the subject to create the customer portal session for.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.

lark/pricing_metrics/__init__.py

@@ -6,10 +6,20 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from .types import PricingMetricAggregation, PricingMetricAggregation_Count, PricingMetricAggregation_Sum
+    from .types import (
+        PricingMetricAggregation,
+        PricingMetricAggregation_Count,
+        PricingMetricAggregation_Custom,
+        PricingMetricAggregation_Last,
+        PricingMetricAggregation_Max,
+        PricingMetricAggregation_Sum,
+    )
 _dynamic_imports: typing.Dict[str, str] = {
     "PricingMetricAggregation": ".types",
     "PricingMetricAggregation_Count": ".types",
+    "PricingMetricAggregation_Custom": ".types",
+    "PricingMetricAggregation_Last": ".types",
+    "PricingMetricAggregation_Max": ".types",
     "PricingMetricAggregation_Sum": ".types",
 }
 
@@ -35,4 +45,11 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["PricingMetricAggregation", "PricingMetricAggregation_Count", "PricingMetricAggregation_Sum"]
+__all__ = [
+    "PricingMetricAggregation",
+    "PricingMetricAggregation_Count",
+    "PricingMetricAggregation_Custom",
+    "PricingMetricAggregation_Last",
+    "PricingMetricAggregation_Max",
+    "PricingMetricAggregation_Sum",
+]

lark/pricing_metrics/client.py

@@ -4,9 +4,10 @@ import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
-from ..types.create_pricing_metric_response import CreatePricingMetricResponse
-from ..types.get_pricing_metric_response import GetPricingMetricResponse
 from ..types.list_pricing_metrics_response import ListPricingMetricsResponse
+from ..types.period import Period
+from ..types.pricing_metric_resource import PricingMetricResource
+from ..types.pricing_metric_summary_resource import PricingMetricSummaryResource
 from .raw_client import AsyncRawPricingMetricsClient, RawPricingMetricsClient
 from .types.pricing_metric_aggregation import PricingMetricAggregation
 
@@ -67,40 +68,45 @@ class PricingMetricsClient:
         aggregation: PricingMetricAggregation,
         unit: str,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> CreatePricingMetricResponse:
+    ) -> PricingMetricResource:
         """
         Parameters
         ----------
         name : str
+            The name of the pricing metric.
 
         event_name : str
+            The name of the event that the pricing metric is computed on.
 
         aggregation : PricingMetricAggregation
+            The aggregation function used to compute the value of the pricing metric.
 
         unit : str
-            Unit of measurement for the pricing metric
+            Unit of measurement for the pricing metric.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        CreatePricingMetricResponse
+        PricingMetricResource
             Successful Response
 
         Examples
         --------
         from lark import Lark
-        from lark.pricing_metrics import PricingMetricAggregation_Count
+        from lark.pricing_metrics import PricingMetricAggregation_Sum
 
         client = Lark(
             api_key="YOUR_API_KEY",
         )
         client.pricing_metrics.create_pricing_metric(
-            name="name",
-            event_name="event_name",
-            aggregation=PricingMetricAggregation_Count(),
-            unit="unit",
+            name="Compute Hours",
+            event_name="job_completed",
+            aggregation=PricingMetricAggregation_Sum(
+                value_field="value_field",
+            ),
+            unit="hours",
         )
         """
         _response = self._raw_client.create_pricing_metric(
@@ -110,7 +116,7 @@ class PricingMetricsClient:
 
     def get_pricing_metric(
         self, pricing_metric_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> GetPricingMetricResponse:
+    ) -> PricingMetricResource:
         """
         Parameters
         ----------
@@ -121,7 +127,7 @@ class PricingMetricsClient:
 
         Returns
         -------
-        GetPricingMetricResponse
+        PricingMetricResource
             Successful Response
 
         Examples
@@ -138,6 +144,60 @@ class PricingMetricsClient:
         _response = self._raw_client.get_pricing_metric(pricing_metric_id, request_options=request_options)
         return _response.data
 
+    def create_pricing_metric_summary(
+        self,
+        pricing_metric_id: str,
+        *,
+        subject_id: str,
+        period: Period,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PricingMetricSummaryResource:
+        """
+        Parameters
+        ----------
+        pricing_metric_id : str
+
+        subject_id : str
+            The ID of the subject that the summary should be computed for.
+
+        period : Period
+            The period that the summary should be computed over.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PricingMetricSummaryResource
+            Successful Response
+
+        Examples
+        --------
+        import datetime
+
+        from lark import Lark, Period
+
+        client = Lark(
+            api_key="YOUR_API_KEY",
+        )
+        client.pricing_metrics.create_pricing_metric_summary(
+            pricing_metric_id="pricing_metric_id",
+            subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
+            period=Period(
+                start=datetime.datetime.fromisoformat(
+                    "2025-10-01 00:00:00+00:00",
+                ),
+                end=datetime.datetime.fromisoformat(
+                    "2025-11-01 00:00:00+00:00",
+                ),
+            ),
+        )
+        """
+        _response = self._raw_client.create_pricing_metric_summary(
+            pricing_metric_id, subject_id=subject_id, period=period, request_options=request_options
+        )
+        return _response.data
+
 
 class AsyncPricingMetricsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -200,25 +260,28 @@ class AsyncPricingMetricsClient:
         aggregation: PricingMetricAggregation,
         unit: str,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> CreatePricingMetricResponse:
+    ) -> PricingMetricResource:
         """
         Parameters
         ----------
         name : str
+            The name of the pricing metric.
 
         event_name : str
+            The name of the event that the pricing metric is computed on.
 
         aggregation : PricingMetricAggregation
+            The aggregation function used to compute the value of the pricing metric.
 
         unit : str
-            Unit of measurement for the pricing metric
+            Unit of measurement for the pricing metric.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        CreatePricingMetricResponse
+        PricingMetricResource
             Successful Response
 
         Examples
@@ -226,7 +289,7 @@ class AsyncPricingMetricsClient:
         import asyncio
 
         from lark import AsyncLark
-        from lark.pricing_metrics import PricingMetricAggregation_Count
+        from lark.pricing_metrics import PricingMetricAggregation_Sum
 
         client = AsyncLark(
             api_key="YOUR_API_KEY",
@@ -235,10 +298,12 @@ class AsyncPricingMetricsClient:
 
         async def main() -> None:
             await client.pricing_metrics.create_pricing_metric(
-                name="name",
-                event_name="event_name",
-                aggregation=PricingMetricAggregation_Count(),
-                unit="unit",
+                name="Compute Hours",
+                event_name="job_completed",
+                aggregation=PricingMetricAggregation_Sum(
+                    value_field="value_field",
+                ),
+                unit="hours",
             )
 
 
@@ -251,7 +316,7 @@ class AsyncPricingMetricsClient:
 
     async def get_pricing_metric(
         self, pricing_metric_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> GetPricingMetricResponse:
+    ) -> PricingMetricResource:
         """
         Parameters
         ----------
@@ -262,7 +327,7 @@ class AsyncPricingMetricsClient:
 
         Returns
         -------
-        GetPricingMetricResponse
+        PricingMetricResource
             Successful Response
 
         Examples
@@ -286,3 +351,64 @@ class AsyncPricingMetricsClient:
         """
         _response = await self._raw_client.get_pricing_metric(pricing_metric_id, request_options=request_options)
         return _response.data
+
+    async def create_pricing_metric_summary(
+        self,
+        pricing_metric_id: str,
+        *,
+        subject_id: str,
+        period: Period,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> PricingMetricSummaryResource:
+        """
+        Parameters
+        ----------
+        pricing_metric_id : str
+
+        subject_id : str
+            The ID of the subject that the summary should be computed for.
+
+        period : Period
+            The period that the summary should be computed over.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        PricingMetricSummaryResource
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+        import datetime
+
+        from lark import AsyncLark, Period
+
+        client = AsyncLark(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.pricing_metrics.create_pricing_metric_summary(
+                pricing_metric_id="pricing_metric_id",
+                subject_id="subj_VyX6Q96h5avMho8O7QWlKeXE",
+                period=Period(
+                    start=datetime.datetime.fromisoformat(
+                        "2025-10-01 00:00:00+00:00",
+                    ),
+                    end=datetime.datetime.fromisoformat(
+                        "2025-11-01 00:00:00+00:00",
+                    ),
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_pricing_metric_summary(
+            pricing_metric_id, subject_id=subject_id, period=period, request_options=request_options
+        )
+        return _response.data