feat: expose WebhooksList and JsonSerializable from public types module (#800)

## Summary

- Move `WebhooksList` and `JsonSerializable` from the private
`_internal_types.py` to the public `apify_client.types` module so users
writing custom HTTP clients or consuming public method signatures can
import them.
- Update all internal importers to the new location and drop the
now-empty `_internal_types.py` (its only remaining alias,
`TerminalActorJobStatus`, had zero importers — the actually-used
`_TerminalActorJobStatus` lives privately in
`_resource_clients/_resource_client.py`).

Author: vdusek

src/apify_client/_internal_types.py

@@ -35,7 +35,6 @@
     from decimal import Decimal
     from logging import Logger
 
-    from apify_client._internal_types import WebhooksList
     from apify_client._literals import ActorJobStatus, ActorPermissionLevel, RunOrigin
     from apify_client._resource_clients import (
         ActorVersionClient,
@@ -53,7 +52,7 @@
         WebhookCollectionClient,
         WebhookCollectionClientAsync,
     )
-    from apify_client.types import Timeout
+    from apify_client.types import Timeout, WebhooksList
 
 _PricingInfo = (
     PayPerEventActorPricingInfo

src/apify_client/_resource_clients/actor.py

@@ -20,10 +20,9 @@
     from collections.abc import AsyncIterator, Iterator
     from datetime import timedelta
 
-    from apify_client._internal_types import JsonSerializable
     from apify_client._literals import GeneralAccess
     from apify_client.http_clients import HttpResponse
-    from apify_client.types import Timeout
+    from apify_client.types import JsonSerializable, Timeout
 
 
 @docs_group('Other')

src/apify_client/_resource_clients/dataset.py

@@ -19,7 +19,6 @@
 if TYPE_CHECKING:
     from datetime import timedelta
 
-    from apify_client._internal_types import WebhooksList
     from apify_client._literals import ActorJobStatus, RunOrigin
     from apify_client._resource_clients import (
         RunClient,
@@ -30,7 +29,7 @@
         WebhookCollectionClientAsync,
     )
     from apify_client._typeddicts import TaskInputDict
-    from apify_client.types import Timeout
+    from apify_client.types import Timeout, WebhooksList
 
 
 @docs_group('Resource clients')

src/apify_client/_resource_clients/task.py

@@ -20,9 +20,9 @@
 if TYPE_CHECKING:
     from datetime import timedelta
 
-    from apify_client._internal_types import WebhooksList
     from apify_client.errors import ApifyApiError
     from apify_client.http_clients import HttpResponse
+    from apify_client.types import WebhooksList
 
 T = TypeVar('T')
 

src/apify_client/_utils.py

@@ -25,8 +25,7 @@
 if TYPE_CHECKING:
     from collections.abc import AsyncIterator, Iterator, Mapping
 
-    from apify_client._internal_types import JsonSerializable
-    from apify_client.types import Timeout
+    from apify_client.types import JsonSerializable, Timeout
 
 
 @docs_group('HTTP clients')

src/apify_client/http_clients/_base.py

@@ -27,10 +27,9 @@
 if TYPE_CHECKING:
     from collections.abc import Awaitable, Callable
 
-    from apify_client._internal_types import JsonSerializable
     from apify_client._statistics import ClientStatistics
     from apify_client.http_clients._base import HttpResponse
-    from apify_client.types import Timeout
+    from apify_client.types import JsonSerializable, Timeout
 
 T = TypeVar('T')
 

src/apify_client/http_clients/_impit.py

@@ -3,13 +3,46 @@
 from datetime import timedelta
 from typing import Literal
 
+from apify_client._models import WebhookCreate, WebhookRepresentation
+from apify_client._typeddicts import (
+    WebhookCreateCamelDict,
+    WebhookCreateDict,
+    WebhookRepresentationCamelDict,
+    WebhookRepresentationDict,
+)
+
 Timeout = timedelta | Literal['no_timeout', 'short', 'medium', 'long']
 """Type for the `timeout` parameter on resource client methods.
 
 `'short'`, `'medium'`, and `'long'` are tier literals resolved by the HTTP client to configured values.
 A `timedelta` overrides the timeout for this call, and `'no_timeout'` disables the timeout entirely.
 """
 
+WebhooksList = (
+    list[WebhookCreate]
+    | list[WebhookCreateDict]
+    | list[WebhookCreateCamelDict]
+    | list[WebhookRepresentation]
+    | list[WebhookRepresentationDict]
+    | list[WebhookRepresentationCamelDict]
+)
+"""Type for the `webhooks` parameter on resource-client `start`/`call` methods and `from_webhooks`.
+
+`WebhookRepresentation` / `WebhookRepresentationDict` / `WebhookRepresentationCamelDict` are the minimal ad-hoc
+webhook shape (only `event_types` and `request_url` required). `WebhookCreate` / `WebhookCreateDict` /
+`WebhookCreateCamelDict` are accepted so a persistent-webhook definition can be reused; their fields not relevant
+to ad-hoc webhooks (e.g. `condition`) are ignored at runtime. The `*CamelDict` variants accept camelCase keys
+matching the Apify API spelling.
+"""
+
+JsonSerializable = dict[str, 'JsonSerializable'] | list['JsonSerializable'] | str | int | float | bool | None
+"""Recursive type for JSON-serializable values - primitives plus objects and arrays with JSON-serializable contents.
+
+Based on the definition discussed in https://github.com/python/typing/issues/182.
+"""
+
 __all__ = [
+    'JsonSerializable',
     'Timeout',
+    'WebhooksList',
 ]