paid-python 0.0.5a40__py3-none-any.whl → 0.1.0__py3-none-any.whl

paid/client.py

@@ -1,6 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
-
 import typing
+import warnings
 
 import httpx
 from .agents.client import AgentsClient, AsyncAgentsClient
@@ -9,16 +9,18 @@ from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from .customers.client import AsyncCustomersClient, CustomersClient
 from .environment import PaidEnvironment
 from .orders.client import AsyncOrdersClient, OrdersClient
-from .tracing.signal import _signal
-from .tracing.tracing import (
-    _initialize_tracing,
-    _trace_async,
-    _trace_sync,
-    generate_and_set_tracing_token,
+from .tracing.distributed_tracing import (
     generate_tracing_token,
     set_tracing_token,
     unset_tracing_token,
 )
+from .tracing.signal import signal
+from .tracing.tracing import (
+    DEFAULT_COLLECTOR_ENDPOINT,
+    initialize_tracing_,
+    trace_async_,
+    trace_sync_,
+)
 from .usage.client import AsyncUsageClient, UsageClient
 
 T = typing.TypeVar("T")
@@ -35,20 +37,12 @@ class Paid:
 
     environment : PaidEnvironment
         The environment to use for requests from the client. from .environment import PaidEnvironment
-
-
-
         Defaults to PaidEnvironment.PRODUCTION
-
-
-
     token : typing.Union[str, typing.Callable[[], str]]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
-
     follow_redirects : typing.Optional[bool]
         Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
-
     httpx_client : typing.Optional[httpx.Client]
         The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
 
@@ -90,80 +84,138 @@ class Paid:
         self.orders = OrdersClient(client_wrapper=self._client_wrapper)
         self.usage = UsageClient(client_wrapper=self._client_wrapper)
 
-    def initialize_tracing(self, collector_endpoint: str = "https://collector.agentpaid.io:4318/v1/traces") -> None:
+    def initialize_tracing(self, collector_endpoint: str = DEFAULT_COLLECTOR_ENDPOINT) -> None:
         """
-        Initializes tracing for the Paid client.
-        Call this method before using tracing features to ensure proper setup.
+        Deprecated: Use the @paid_tracing decorator or context manager instead.
+
+        This method is deprecated and will be removed in a future version.
+        The @paid_tracing decorator automatically initializes tracing as needed.
 
-        Returns
-        -------
-        None
+        Instead of:
+            client.initialize_tracing()
+            client.trace(external_customer_id="...", fn=lambda: ...)
+
+        Use:
+            from paid.tracing import paid_tracing
+
+            @paid_tracing(external_customer_id="...", external_agent_id="...")
+            def my_function():
+                ...
+
+        Or as a context manager:
+            with paid_tracing(external_customer_id="..."):
+                result = agent_workflow()
         """
+        warnings.warn(
+            "Paid.initialize_tracing() is deprecated and will be removed in a future version. "
+            "Use @paid_tracing decorator/context manager directly, which auto-initializes tracing. "
+            "See documentation: https://docs.paid.ai/documentation/getting-started/integrate-signals-and-cost-tracking-to-your-codebase",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         token = self._client_wrapper._get_token()
-        _initialize_tracing(token, collector_endpoint=collector_endpoint)
+        initialize_tracing_(token, collector_endpoint=collector_endpoint)
 
     def generate_tracing_token(self) -> int:
         """
-        This will generate and return a tracing token but it will not set it
-        for the tracing context. Needed when you only want to store or send a tracing token
-        somewhere else.
-        """
-        return generate_tracing_token()
+        Deprecated: Import and use generate_tracing_token() directly from paid.tracing.
 
-    def generate_and_set_tracing_token(self) -> int:
-        """
-        *Advanced feature*
-        In cases when you can't share the same Paid.trace() context with
-        code that you want to track together (complex concurrency logic,
-        or disjoint workflows, or work is separated between processes),
-        then you can manually generate a tracing token with generate_and_set_traceing_token()
-        and share it with the other parts of your application or service using set_tracing_token().
-
-        This function returns tracing token and attaches it to all consequent
-        Paid.trace() tracing contexts. So all the costs and signals that share this
-        tracing context are associated with each other.
-
-        To stop associating the traces one can either call
-        generate_and_set_tracing_token() once again or call unset_tracing_token().
-        The former is suitable if you still want to trace but in a fresh
-        context, and the latter will go back to unique traces per Paid.trace().
+        This method is deprecated and will be removed in a future version.
+        Use the standalone function instead.
+
+        Instead of:
+            from paid import Paid
+            client = Paid(token="...")
+            token = client.generate_tracing_token()
+
+        Use:
+            from paid.tracing import generate_tracing_token
+            token = generate_tracing_token()
         """
-        return generate_and_set_tracing_token()
+        warnings.warn(
+            "Paid.generate_tracing_token() is deprecated and will be removed in a future version. "
+            "Import and use generate_tracing_token() directly from paid.tracing instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return generate_tracing_token()
 
     def set_tracing_token(self, token: int):
         """
-        *Advanced feature*
-        In cases when you can't share the same Paid.trace() context with
-        code that you want to track together (complex concurrency logic,
-        or disjoint workflows, or work is separated between processes),
-        then you can manually generate a tracing token with generate_and_set_traceing_token()
-        and share it with the other parts of your application or service using set_tracing_token().
-
-        Sets tracing token. Provided token should come from generate_and_set_tracing_token().
-        Once set, the consequent traces will be related to each other.
-        """
+        Deprecated: Pass tracing_token directly to @paid_tracing() decorator instead.
+
+        This method is deprecated and will be removed in a future version.
+        Use the tracing_token parameter in @paid_tracing() to link traces across processes.
+
+        Instead of:
+            from paid import Paid
+            client = Paid(token="...")
+            token = load_from_storage("workflow_123")
+            client.set_tracing_token(token)
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            def process_workflow():
+                ...
+            client.unset_tracing_token()
+
+        Use:
+            from paid.tracing import paid_tracing
+            token = load_from_storage("workflow_123")
+
+            @paid_tracing(
+                external_customer_id="cust_123",
+                external_agent_id="agent_456",
+                tracing_token=token
+            )
+            def process_workflow():
+                ...
 
+        Parameters
+        ----------
+        token : int
+            A tracing token to use for the next traces.
+        """
+        warnings.warn(
+            "Paid.set_tracing_token() is deprecated and will be removed in a future version. "
+            "Pass tracing_token directly to @paid_tracing(tracing_token=...) decorator instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         set_tracing_token(token)
 
     def unset_tracing_token(self):
         """
-        Unsets the token previously set by generate_and_set_tracing_token()
-        or by set_tracing_token(token). Does nothing if the token was never set.
-        When tracing token is unset, traces are unique for a single Paid.trace() context.
+        Deprecated: No longer needed. Use tracing_token parameter in @paid_tracing() instead.
+
+        This method is deprecated and will be removed in a future version.
+        Since tracing_token is now passed directly to @paid_tracing(), there's no need
+        to manually set/unset tokens in the context.
+
+        Old pattern (no longer recommended):
+            from paid import Paid
+            client = Paid(token="...")
+            client.set_tracing_token(token)
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            def my_function():
+                ...
+            client.unset_tracing_token()
+
+        New pattern (recommended):
+            from paid.tracing import paid_tracing
+            @paid_tracing(
+                external_customer_id="cust_123",
+                external_agent_id="agent_456",
+                tracing_token=token
+            )
+            def my_function():
+                ...
         """
-        unset_tracing_token()
-
-    def capture(
-        self,
-        external_customer_id: str,
-        fn: typing.Callable[[], T],
-        args: typing.Optional[typing.Tuple] = None,
-        kwargs: typing.Optional[typing.Dict] = None,
-    ) -> T:
-        print("capture() is deprecated. Please rename it to trace() to remove this message.")
-        return _trace_sync(
-            external_customer_id=external_customer_id, fn=fn, external_agent_id=None, args=args, kwargs=kwargs
+        warnings.warn(
+            "Paid.unset_tracing_token() is deprecated and will be removed in a future version. "
+            "Use tracing_token parameter in @paid_tracing(tracing_token=...) decorator instead.",
+            DeprecationWarning,
+            stacklevel=2,
         )
+        unset_tracing_token()
 
     def trace(
         self,
@@ -176,31 +228,40 @@ class Paid:
         kwargs: typing.Optional[typing.Dict] = None,
     ) -> T:
         """
-        Traces the execution of the provided function.
+        Deprecated: Use the @paid_tracing decorator or context manager instead.
 
-        Parameters
-        ----------
-        external_customer_id : str
-            The external customer ID to associate with the trace.
-        fn : typing.Callable[[], T]
-            The function to be traced.
-        external_agent_id : typing.Optional[str], optional
-            The external agent ID to associate with the trace, by default None.
-        tracing_token : typing.Optional[int], optional
-            The tracing token for distributed tracing, by default None.
-        metadata : typing.Optional[typing.Dict[str, typing.Any]], optional
-            Additional metadata to associate with the trace, by default None.
-        args : typing.Optional[typing.Tuple], optional
-            Positional arguments to pass to the function, by default None.
-        kwargs : typing.Optional[typing.Dict], optional
-            Keyword arguments to pass to the function, by default None.
-
-        Returns
-        -------
-        T
-            The result of the traced function.
+        This method is deprecated and will be removed in a future version.
+        The callback-based tracing via Paid.trace() is being replaced with the more
+        Pythonic @paid_tracing decorator and context manager.
+
+        Instead of:
+            result = client.trace(
+                external_customer_id="cust_123",
+                fn=lambda: agent_workflow(),
+                external_agent_id="agent_456"
+            )
+
+        Use the decorator:
+            from paid.tracing import paid_tracing
+
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            def agent_workflow():
+                ...
+
+            result = agent_workflow()
+
+        Or use the context manager:
+            with paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456"):
+                result = agent_workflow()
         """
-        return _trace_sync(
+        warnings.warn(
+            "Paid.trace() is deprecated and will be removed in a future version. "
+            "Use the @paid_tracing decorator or context manager instead. "
+            "See documentation: https://docs.paid.ai/documentation/getting-started/integrate-signals-and-cost-tracking-to-your-codebase",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return trace_sync_(
             external_customer_id=external_customer_id,
             fn=fn,
             external_agent_id=external_agent_id,
@@ -218,36 +279,27 @@ class Paid:
         enable_cost_tracing: bool = False,
     ) -> None:
         """
-        Sends Paid signal. Needs to be called as part of callback to Paid.trace().
-        When enable_cost_tracing flag is on, signal is associated
-        with cost traces from the same Paid.trace() context.
+        Deprecated: Import and use signal() directly from paid.tracing.
 
-        Parameters
-        ----------
-        event_name : str
-            The name of the signal.
-        data : typing.Optional[typing.Dict[str, typing.Any]], optional
-            Additional data to include with the signal event.
-        enable_cost_tracing : bool, optional
-            Whether to associate this signal with cost traces from the current Paid.trace() context.
-            Defaults to False.
-
-        Usage
-        -----
-        signal("event_name")
-        signal("event_name", data={"key": "value"})
-        signal("event_name", enable_cost_tracing=True)
-        signal("event_name", enable_cost_tracing=True, data={"key": "value"})
-
-        Notes
-        -----
-        When enable_cost_tracing is on, the signal will be associated with cost
-        traces within the same Paid.trace() context.
-        It is advised to only make one call to this function
-        with enable_cost_tracing per Paid.trace() context.
-        Otherwise, there will be multiple signals that refer to the same costs.
+        This method is deprecated and will be removed in a future version.
+        Use the standalone function instead.
+
+        Instead of:
+            from paid import Paid
+            client = Paid(token="...")
+            client.signal("event_name", data={...})
+
+        Use:
+            from paid.tracing import signal
+            signal("event_name", data={...})
         """
-        _signal(event_name=event_name, enable_cost_tracing=enable_cost_tracing, data=data)
+        warnings.warn(
+            "Paid.signal() is deprecated and will be removed in a future version. "
+            "Import and use signal() directly from paid.tracing instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        signal(event_name=event_name, enable_cost_tracing=enable_cost_tracing, data=data)
 
 
 class AsyncPaid:
@@ -261,13 +313,7 @@ class AsyncPaid:
 
     environment : PaidEnvironment
         The environment to use for requests from the client. from .environment import PaidEnvironment
-
-
-
         Defaults to PaidEnvironment.PRODUCTION
-
-
-
     token : typing.Union[str, typing.Callable[[], str]]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
@@ -316,80 +362,140 @@ class AsyncPaid:
         self.orders = AsyncOrdersClient(client_wrapper=self._client_wrapper)
         self.usage = AsyncUsageClient(client_wrapper=self._client_wrapper)
 
-    def initialize_tracing(self, collector_endpoint: str = "https://collector.agentpaid.io:4318/v1/traces") -> None:
+    def initialize_tracing(self, collector_endpoint: str = DEFAULT_COLLECTOR_ENDPOINT) -> None:
         """
-        Initializes tracing for the AsyncPaid client.
-        Call this method before using tracing features to ensure proper setup.
+        Deprecated: Use the @paid_tracing decorator or context manager instead.
+
+        This method is deprecated and will be removed in a future version.
+        The @paid_tracing decorator automatically initializes tracing as needed.
+
+        Instead of:
+            client.initialize_tracing()
+            await client.trace(external_customer_id="...", fn=async_func)
+
+        Use:
+            from paid.tracing import paid_tracing
+
+            @paid_tracing(external_customer_id="...", external_agent_id="...")
+            async def my_async_function():
+                ...
 
-        Returns
-        -------
-        None
+            await my_async_function()
+
+        Or as an async context manager:
+            async with paid_tracing(external_customer_id="..."):
+                result = await async_operation()
         """
+        warnings.warn(
+            "AsyncPaid.initialize_tracing() is deprecated and will be removed in a future version. "
+            "Use @paid_tracing decorator/context manager directly, which auto-initializes tracing. "
+            "See documentation: https://docs.paid.ai/documentation/getting-started/integrate-signals-and-cost-tracking-to-your-codebase",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         token = self._client_wrapper._get_token()
-        _initialize_tracing(token, collector_endpoint=collector_endpoint)
+        initialize_tracing_(token, collector_endpoint=collector_endpoint)
 
     def generate_tracing_token(self) -> int:
         """
-        This will generate and return a tracing token but it will not set it
-        for the tracing context. Needed when you only want to store or send a tracing token
-        somewhere else.
-        """
-        return generate_tracing_token()
+        Deprecated: Import and use generate_tracing_token() directly from paid.tracing.
 
-    def generate_and_set_tracing_token(self) -> int:
-        """
-        *Advanced feature*
-        In cases when you can't share the same Paid.trace() or @paid_tracing() context with
-        code that you want to track together (complex concurrency logic,
-        or disjoint workflows, or work is separated between processes),
-        then you can manually generate a tracing token with generate_and_set_traceing_token()
-        and share it with the other parts of your application or service using set_tracing_token().
-
-        This function returns tracing token and attaches it to all consequent
-        Paid.trace() or @paid_tracing() tracing contexts. So all the costs and signals that share this
-        tracing context are associated with each other.
-
-        To stop associating the traces one can either call
-        generate_and_set_tracing_token() once again or call unset_tracing_token().
-        The former is suitable if you still want to trace but in a fresh
-        context, and the latter will go back to unique traces per Paid.trace() or @paid_tracing().
+        This method is deprecated and will be removed in a future version.
+        Use the standalone function instead.
+
+        Instead of:
+            from paid import AsyncPaid
+            client = AsyncPaid(token="...")
+            token = client.generate_tracing_token()
+
+        Use:
+            from paid.tracing import generate_tracing_token
+            token = generate_tracing_token()
         """
-        return generate_and_set_tracing_token()
+        warnings.warn(
+            "AsyncPaid.generate_tracing_token() is deprecated and will be removed in a future version. "
+            "Import and use generate_tracing_token() directly from paid.tracing instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return generate_tracing_token()
 
     def set_tracing_token(self, token: int):
         """
-        *Advanced feature*
-        In cases when you can't share the same Paid.trace() or @paid_tracing() context with
-        code that you want to track together (complex concurrency logic,
-        or disjoint workflows, or work is separated between processes),
-        then you can manually generate a tracing token with generate_and_set_traceing_token()
-        and share it with the other parts of your application or service using set_tracing_token().
-
-        Sets tracing token. Provided token should come from generate_and_set_tracing_token().
-        Once set, the consequent traces will be related to each other.
-        """
+        Deprecated: Pass tracing_token directly to @paid_tracing() decorator instead.
+
+        This method is deprecated and will be removed in a future version.
+        Use the tracing_token parameter in @paid_tracing() to link traces across processes.
+
+        Instead of:
+            from paid import AsyncPaid
+            client = AsyncPaid(token="...")
+            token = load_from_storage("workflow_123")
+            client.set_tracing_token(token)
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            async def process_workflow():
+                ...
+            client.unset_tracing_token()
+
+        Use:
+            from paid.tracing import paid_tracing
+            token = load_from_storage("workflow_123")
+
+            @paid_tracing(
+                external_customer_id="cust_123",
+                external_agent_id="agent_456",
+                tracing_token=token
+            )
+            async def process_workflow():
+                ...
 
+        Parameters
+        ----------
+        token : int
+            A tracing token to use for the next traces.
+        """
+        warnings.warn(
+            "AsyncPaid.set_tracing_token() is deprecated and will be removed in a future version. "
+            "Pass tracing_token directly to @paid_tracing(tracing_token=...) decorator instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         set_tracing_token(token)
 
     def unset_tracing_token(self):
         """
-        Unsets the token previously set by generate_and_set_tracing_token()
-        or by set_tracing_token(token). Does nothing if the token was never set.
-        When tracing token is unset, traces are unique for a single Paid.trace() or @paid_tracing() context.
+        Deprecated: No longer needed. Use tracing_token parameter in @paid_tracing() instead.
+
+        This method is deprecated and will be removed in a future version.
+        Since tracing_token is now passed directly to @paid_tracing(), there's no need
+        to manually set/unset tokens in the context.
+
+        Old pattern (no longer recommended):
+            from paid import AsyncPaid
+            client = AsyncPaid(token="...")
+            client.set_tracing_token(token)
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            async def my_function():
+                ...
+            client.unset_tracing_token()
+
+        New pattern (recommended):
+            from paid.tracing import paid_tracing
+            @paid_tracing(
+                external_customer_id="cust_123",
+                external_agent_id="agent_456",
+                tracing_token=token
+            )
+            async def my_function():
+                ...
         """
-        unset_tracing_token()
-
-    async def capture(
-        self,
-        external_customer_id: str,
-        fn: typing.Callable[[], typing.Awaitable[T]],
-        args: typing.Optional[typing.Tuple] = None,
-        kwargs: typing.Optional[typing.Dict] = None,
-    ) -> typing.Union[T, typing.Awaitable[T]]:
-        print("capture() is deprecated. Please rename it to trace() to remove this message.")
-        return await _trace_async(
-            external_customer_id=external_customer_id, fn=fn, external_agent_id=None, args=args, kwargs=kwargs
+        warnings.warn(
+            "AsyncPaid.unset_tracing_token() is deprecated and will be removed in a future version. "
+            "Use tracing_token parameter in @paid_tracing(tracing_token=...) decorator instead.",
+            DeprecationWarning,
+            stacklevel=2,
         )
+        unset_tracing_token()
 
     async def trace(
         self,
@@ -402,31 +508,40 @@ class AsyncPaid:
         kwargs: typing.Optional[typing.Dict] = None,
     ) -> typing.Union[T, typing.Awaitable[T]]:
         """
-        Traces the execution of the provided function asynchronously.
+        Deprecated: Use the @paid_tracing decorator or context manager instead.
 
-        Parameters
-        ----------
-        external_customer_id : str
-            The external customer ID to associate with the trace.
-        fn : typing.Callable[[], typing.Awaitable[T]]
-            The async function to be traced.
-        external_agent_id : typing.Optional[str], optional
-            The external agent ID to associate with the trace, by default None.
-        tracing_token : typing.Optional[int], optional
-            The tracing token for distributed tracing, by default None.
-        metadata : typing.Optional[typing.Dict[str, typing.Any]], optional
-            Additional metadata to associate with the trace, by default None.
-        args : typing.Optional[typing.Tuple], optional
-            Positional arguments to pass to the function, by default None.
-        kwargs : typing.Optional[typing.Dict], optional
-            Keyword arguments to pass to the function, by default None.
-
-        Returns
-        -------
-        T
-            The result of the traced function.
+        This method is deprecated and will be removed in a future version.
+        The callback-based tracing via AsyncPaid.trace() is being replaced with the more
+        Pythonic @paid_tracing decorator and context manager.
+
+        Instead of:
+            result = await client.trace(
+                external_customer_id="cust_123",
+                fn=agent_workflow,
+                external_agent_id="agent_456"
+            )
+
+        Use the decorator:
+            from paid.tracing import paid_tracing
+
+            @paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456")
+            async def agent_workflow():
+                ...
+
+            result = await agent_workflow()
+
+        Or use the async context manager:
+            async with paid_tracing(external_customer_id="cust_123", external_agent_id="agent_456"):
+                result = await agent_workflow()
         """
-        return await _trace_async(
+        warnings.warn(
+            "AsyncPaid.trace() is deprecated and will be removed in a future version. "
+            "Use the @paid_tracing decorator or context manager instead. "
+            "See documentation: https://docs.paid.ai/documentation/getting-started/integrate-signals-and-cost-tracking-to-your-codebase",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return await trace_async_(
             external_customer_id=external_customer_id,
             fn=fn,
             external_agent_id=external_agent_id,
@@ -444,36 +559,27 @@ class AsyncPaid:
         enable_cost_tracing: bool = False,
     ) -> None:
         """
-        Sends Paid signal. Needs to be called as part of callback to Paid.trace().
-        When enable_cost_tracing flag is on, signal is associated
-        with cost traces from the same Paid.trace() context.
+        Deprecated: Import and use signal() directly from paid.tracing.
 
-        Parameters
-        ----------
-        event_name : str
-            The name of the signal.
-        data : typing.Optional[typing.Dict[str, typing.Any]], optional
-            Additional data to include with the signal event.
-        enable_cost_tracing : bool, optional
-            Whether to associate this signal with cost traces from the current Paid.trace() context.
-            Defaults to False.
-
-        Usage
-        -----
-        signal("event_name")
-        signal("event_name", data={"key": "value"})
-        signal("event_name", enable_cost_tracing=True)
-        signal("event_name", enable_cost_tracing=True, data={"key": "value"})
-
-        Notes
-        -----
-        When enable_cost_tracing is on, the signal will be associated with cost
-        traces within the same Paid.trace() context.
-        It is advised to only make one call to this function
-        with enable_cost_tracing per Paid.trace() context.
-        Otherwise, there will be multiple signals that refer to the same costs.
+        This method is deprecated and will be removed in a future version.
+        Use the standalone function instead.
+
+        Instead of:
+            from paid import AsyncPaid
+            client = AsyncPaid(token="...")
+            client.signal("event_name", data={...})
+
+        Use:
+            from paid.tracing import signal
+            signal("event_name", data={...})
         """
-        _signal(event_name=event_name, enable_cost_tracing=enable_cost_tracing, data=data)
+        warnings.warn(
+            "AsyncPaid.signal() is deprecated and will be removed in a future version. "
+            "Import and use signal() directly from paid.tracing instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        signal(event_name=event_name, enable_cost_tracing=enable_cost_tracing, data=data)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: PaidEnvironment) -> str: