paid-python 0.4.1a0__py3-none-any.whl → 0.5.0__py3-none-any.whl

paid/products/types/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .product_create_type import ProductCreateType
+
+__all__ = ["ProductCreateType"]

paid/products/types/product_create_type.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ProductCreateType = typing.Union[typing.Literal["agent", "product", "prepaidCreditBundle"], typing.Any]

paid/traces/__init__.py

@@ -0,0 +1,4 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+

paid/traces/client.py

@@ -0,0 +1,218 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.traces_response import TracesResponse
+from .raw_client import AsyncRawTracesClient, RawTracesClient
+
+
+class TracesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawTracesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawTracesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawTracesClient
+        """
+        return self._raw_client
+
+    def get_traces(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        start_time: typing.Optional[dt.datetime] = None,
+        end_time: typing.Optional[dt.datetime] = None,
+        external_customer_id: typing.Optional[str] = None,
+        external_product_id: typing.Optional[str] = None,
+        external_agent_id: typing.Optional[str] = None,
+        metadata: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> TracesResponse:
+        """
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            Maximum number of traces to return (1-1000)
+
+        offset : typing.Optional[int]
+            Number of traces to skip for pagination
+
+        start_time : typing.Optional[dt.datetime]
+            Filter traces starting from this time (ISO 8601 format)
+
+        end_time : typing.Optional[dt.datetime]
+            Filter traces up to this time (ISO 8601 format)
+
+        external_customer_id : typing.Optional[str]
+            Filter traces by external customer ID
+
+        external_product_id : typing.Optional[str]
+            Filter traces by external product ID
+
+        external_agent_id : typing.Optional[str]
+            DEPRECATED: Use externalProductId instead. Filter traces by external agent ID
+
+        metadata : typing.Optional[str]
+            Filter traces by metadata fields. Must be a valid JSON object (e.g., {"key1":"value1","key2":"value2"}). All specified fields must match (AND logic).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        TracesResponse
+            Success response
+
+        Examples
+        --------
+        import datetime
+
+        from paid import Paid
+
+        client = Paid(
+            token="YOUR_TOKEN",
+        )
+        client.traces.get_traces(
+            limit=1,
+            offset=1,
+            start_time=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            end_time=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            external_customer_id="externalCustomerId",
+            external_product_id="externalProductId",
+            external_agent_id="externalAgentId",
+            metadata="metadata",
+        )
+        """
+        _response = self._raw_client.get_traces(
+            limit=limit,
+            offset=offset,
+            start_time=start_time,
+            end_time=end_time,
+            external_customer_id=external_customer_id,
+            external_product_id=external_product_id,
+            external_agent_id=external_agent_id,
+            metadata=metadata,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncTracesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawTracesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawTracesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawTracesClient
+        """
+        return self._raw_client
+
+    async def get_traces(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        start_time: typing.Optional[dt.datetime] = None,
+        end_time: typing.Optional[dt.datetime] = None,
+        external_customer_id: typing.Optional[str] = None,
+        external_product_id: typing.Optional[str] = None,
+        external_agent_id: typing.Optional[str] = None,
+        metadata: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> TracesResponse:
+        """
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            Maximum number of traces to return (1-1000)
+
+        offset : typing.Optional[int]
+            Number of traces to skip for pagination
+
+        start_time : typing.Optional[dt.datetime]
+            Filter traces starting from this time (ISO 8601 format)
+
+        end_time : typing.Optional[dt.datetime]
+            Filter traces up to this time (ISO 8601 format)
+
+        external_customer_id : typing.Optional[str]
+            Filter traces by external customer ID
+
+        external_product_id : typing.Optional[str]
+            Filter traces by external product ID
+
+        external_agent_id : typing.Optional[str]
+            DEPRECATED: Use externalProductId instead. Filter traces by external agent ID
+
+        metadata : typing.Optional[str]
+            Filter traces by metadata fields. Must be a valid JSON object (e.g., {"key1":"value1","key2":"value2"}). All specified fields must match (AND logic).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        TracesResponse
+            Success response
+
+        Examples
+        --------
+        import asyncio
+        import datetime
+
+        from paid import AsyncPaid
+
+        client = AsyncPaid(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.traces.get_traces(
+                limit=1,
+                offset=1,
+                start_time=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                end_time=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                external_customer_id="externalCustomerId",
+                external_product_id="externalProductId",
+                external_agent_id="externalAgentId",
+                metadata="metadata",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_traces(
+            limit=limit,
+            offset=offset,
+            start_time=start_time,
+            end_time=end_time,
+            external_customer_id=external_customer_id,
+            external_product_id=external_product_id,
+            external_agent_id=external_agent_id,
+            metadata=metadata,
+            request_options=request_options,
+        )
+        return _response.data

paid/traces/raw_client.py

@@ -0,0 +1,226 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.datetime_utils import serialize_datetime
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..errors.bad_request_error import BadRequestError
+from ..errors.forbidden_error import ForbiddenError
+from ..types.error import Error
+from ..types.traces_response import TracesResponse
+
+
+class RawTracesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get_traces(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        start_time: typing.Optional[dt.datetime] = None,
+        end_time: typing.Optional[dt.datetime] = None,
+        external_customer_id: typing.Optional[str] = None,
+        external_product_id: typing.Optional[str] = None,
+        external_agent_id: typing.Optional[str] = None,
+        metadata: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[TracesResponse]:
+        """
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            Maximum number of traces to return (1-1000)
+
+        offset : typing.Optional[int]
+            Number of traces to skip for pagination
+
+        start_time : typing.Optional[dt.datetime]
+            Filter traces starting from this time (ISO 8601 format)
+
+        end_time : typing.Optional[dt.datetime]
+            Filter traces up to this time (ISO 8601 format)
+
+        external_customer_id : typing.Optional[str]
+            Filter traces by external customer ID
+
+        external_product_id : typing.Optional[str]
+            Filter traces by external product ID
+
+        external_agent_id : typing.Optional[str]
+            DEPRECATED: Use externalProductId instead. Filter traces by external agent ID
+
+        metadata : typing.Optional[str]
+            Filter traces by metadata fields. Must be a valid JSON object (e.g., {"key1":"value1","key2":"value2"}). All specified fields must match (AND logic).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[TracesResponse]
+            Success response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "traces",
+            method="GET",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "startTime": serialize_datetime(start_time) if start_time is not None else None,
+                "endTime": serialize_datetime(end_time) if end_time is not None else None,
+                "externalCustomerId": external_customer_id,
+                "externalProductId": external_product_id,
+                "externalAgentId": external_agent_id,
+                "metadata": metadata,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TracesResponse,
+                    parse_obj_as(
+                        type_=TracesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        Error,
+                        parse_obj_as(
+                            type_=Error,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        Error,
+                        parse_obj_as(
+                            type_=Error,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawTracesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get_traces(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        start_time: typing.Optional[dt.datetime] = None,
+        end_time: typing.Optional[dt.datetime] = None,
+        external_customer_id: typing.Optional[str] = None,
+        external_product_id: typing.Optional[str] = None,
+        external_agent_id: typing.Optional[str] = None,
+        metadata: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[TracesResponse]:
+        """
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            Maximum number of traces to return (1-1000)
+
+        offset : typing.Optional[int]
+            Number of traces to skip for pagination
+
+        start_time : typing.Optional[dt.datetime]
+            Filter traces starting from this time (ISO 8601 format)
+
+        end_time : typing.Optional[dt.datetime]
+            Filter traces up to this time (ISO 8601 format)
+
+        external_customer_id : typing.Optional[str]
+            Filter traces by external customer ID
+
+        external_product_id : typing.Optional[str]
+            Filter traces by external product ID
+
+        external_agent_id : typing.Optional[str]
+            DEPRECATED: Use externalProductId instead. Filter traces by external agent ID
+
+        metadata : typing.Optional[str]
+            Filter traces by metadata fields. Must be a valid JSON object (e.g., {"key1":"value1","key2":"value2"}). All specified fields must match (AND logic).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[TracesResponse]
+            Success response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "traces",
+            method="GET",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "startTime": serialize_datetime(start_time) if start_time is not None else None,
+                "endTime": serialize_datetime(end_time) if end_time is not None else None,
+                "externalCustomerId": external_customer_id,
+                "externalProductId": external_product_id,
+                "externalAgentId": external_agent_id,
+                "metadata": metadata,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TracesResponse,
+                    parse_obj_as(
+                        type_=TracesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        Error,
+                        parse_obj_as(
+                            type_=Error,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        Error,
+                        parse_obj_as(
+                            type_=Error,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

paid/tracing/context_manager.py

@@ -23,8 +23,11 @@ class paid_tracing:
     ----------
     external_customer_id : str
         The external customer ID to associate with the trace.
+    external_product_id : Optional[str], optional
+        The external product ID to associate with the trace, by default None.
     external_agent_id : Optional[str], optional
-        The external agent ID to associate with the trace, by default None.
+        **Deprecated.** Use external_product_id instead. The external agent ID to associate
+        with the trace, by default None.
     tracing_token : Optional[int], optional
         Optional tracing token for distributed tracing, by default None.
     store_prompt : bool, optional
@@ -37,7 +40,7 @@ class paid_tracing:
     Examples
     --------
     As a decorator (sync):
-    >>> @paid_tracing(external_customer_id="customer123", external_agent_id="agent456")
+    >>> @paid_tracing(external_customer_id="customer123", external_product_id="product456")
     ... def my_function(arg1, arg2):
     ...     return arg1 + arg2
 
@@ -47,7 +50,7 @@ class paid_tracing:
     ...     return arg1 + arg2
 
     As a context manager (sync):
-    >>> with paid_tracing(external_customer_id="customer123", external_agent_id="agent456"):
+    >>> with paid_tracing(external_customer_id="customer123", external_product_id="product456"):
     ...     result = expensive_computation()
 
     As a context manager (async):
@@ -64,6 +67,7 @@ class paid_tracing:
         self,
         external_customer_id: Optional[str] = None,
         *,
+        external_product_id: Optional[str] = None,
         external_agent_id: Optional[str] = None,
         tracing_token: Optional[int] = None,
         store_prompt: bool = False,
@@ -71,7 +75,8 @@ class paid_tracing:
         metadata: Optional[Dict[str, Any]] = None,
     ):
         self.external_customer_id = external_customer_id
-        self.external_agent_id = external_agent_id
+        # external_product_id overrides external_agent_id for backwards compatibility
+        self.external_agent_id = external_product_id if external_product_id else external_agent_id
         self.tracing_token = tracing_token
         self.store_prompt = store_prompt
         self.collector_endpoint = collector_endpoint

paid/types/__init__.py

@@ -24,17 +24,32 @@ from .error import Error
 from .order import Order
 from .order_line import OrderLine
 from .order_line_attribute import OrderLineAttribute
-from .order_line_attribute_create import OrderLineAttributeCreate
+from .order_line_attribute_create_one import OrderLineAttributeCreateOne
 from .order_line_attribute_pricing import OrderLineAttributePricing
 from .order_line_create import OrderLineCreate
 from .pagination_meta import PaginationMeta
+from .plan import Plan
+from .plan_plan_products_item import PlanPlanProductsItem
+from .plan_plan_products_item_plan_product_attribute_item import PlanPlanProductsItemPlanProductAttributeItem
 from .price_point import PricePoint
 from .pricing import Pricing
 from .pricing_model_type import PricingModelType
+from .product import Product
+from .product_type import ProductType
+from .product_update import ProductUpdate
+from .product_update_type import ProductUpdateType
 from .salutation import Salutation
 from .signal import Signal
+from .signal_v_2 import SignalV2
 from .tax_exempt_status import TaxExemptStatus
 from .tier import Tier
+from .trace import Trace
+from .traces_response import TracesResponse
+from .usage_pagination_meta import UsagePaginationMeta
+from .usage_summaries_response import UsageSummariesResponse
+from .usage_summary import UsageSummary
+from .usage_summary_order import UsageSummaryOrder
+from .usage_summary_order_line import UsageSummaryOrderLine
 
 __all__ = [
     "Address",
@@ -59,15 +74,30 @@ __all__ = [
     "Order",
     "OrderLine",
     "OrderLineAttribute",
-    "OrderLineAttributeCreate",
+    "OrderLineAttributeCreateOne",
     "OrderLineAttributePricing",
     "OrderLineCreate",
     "PaginationMeta",
+    "Plan",
+    "PlanPlanProductsItem",
+    "PlanPlanProductsItemPlanProductAttributeItem",
     "PricePoint",
     "Pricing",
     "PricingModelType",
+    "Product",
+    "ProductType",
+    "ProductUpdate",
+    "ProductUpdateType",
     "Salutation",
     "Signal",
+    "SignalV2",
     "TaxExemptStatus",
     "Tier",
+    "Trace",
+    "TracesResponse",
+    "UsagePaginationMeta",
+    "UsageSummariesResponse",
+    "UsageSummary",
+    "UsageSummaryOrder",
+    "UsageSummaryOrderLine",
 ]

paid/types/cost_trace.py

@@ -24,6 +24,11 @@ class CostTrace(UniversalBaseModel):
     The vendor/provider (e.g., "openai", "anthropic", "mistral")
     """
 
+    model: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The model used for the operation (e.g., "gpt-4o-mini", "claude-3-sonnet")
+    """
+
     cost: CostAmount
     start_time_unix_nano: typing_extensions.Annotated[str, FieldMetadata(alias="startTimeUnixNano")] = pydantic.Field()
     """
@@ -37,7 +42,7 @@ class CostTrace(UniversalBaseModel):
 
     attributes: typing.Dict[str, typing.Optional[typing.Any]] = pydantic.Field()
     """
-    Additional metadata about the trace (e.g., model, tokens, etc.)
+    Additional metadata about the trace (e.g., tokens, etc.)
     """
 
     if IS_PYDANTIC_V2:

paid/types/customer.py

@@ -16,7 +16,6 @@ class Customer(UniversalBaseModel):
     id: str
     organization_id: typing_extensions.Annotated[str, FieldMetadata(alias="organizationId")]
     name: str
-    email: typing.Optional[str] = None
     external_id: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="externalId")] = None
     phone: typing.Optional[str] = None
     employee_count: typing_extensions.Annotated[typing.Optional[float], FieldMetadata(alias="employeeCount")] = None
@@ -32,8 +31,10 @@ class Customer(UniversalBaseModel):
     ] = None
     website: typing.Optional[str] = None
     billing_address: typing_extensions.Annotated[typing.Optional[Address], FieldMetadata(alias="billingAddress")] = None
-    vat_number: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="vatNumber")] = None
-    research: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Flexible JSON field for storing custom metadata about the customer
+    """
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

paid/types/customer_update.py

@@ -13,7 +13,6 @@ from .tax_exempt_status import TaxExemptStatus
 
 class CustomerUpdate(UniversalBaseModel):
     name: typing.Optional[str] = None
-    email: typing.Optional[str] = None
     external_id: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="externalId")] = None
     phone: typing.Optional[str] = None
     employee_count: typing_extensions.Annotated[typing.Optional[float], FieldMetadata(alias="employeeCount")] = None
@@ -26,7 +25,10 @@ class CustomerUpdate(UniversalBaseModel):
     ] = None
     website: typing.Optional[str] = None
     billing_address: typing_extensions.Annotated[typing.Optional[Address], FieldMetadata(alias="billingAddress")] = None
-    vat_number: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="vatNumber")] = None
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Flexible JSON field for storing custom metadata about the customer
+    """
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

paid/types/order_line_attribute_create_one.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+OrderLineAttributeCreateOne = typing.Optional[typing.Any]