linkedapi 1.2.0__tar.gz → 1.3.0__tar.gz

{linkedapi-1.2.0 → linkedapi-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkedapi
-Version: 1.2.0
+Version: 1.3.0
 Summary: Official synchronous Python SDK for Linked API.
 Project-URL: Homepage, https://linkedapi.io
 Project-URL: Repository, https://github.com/Linked-API/linkedapi-python

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/__init__.py

@@ -68,13 +68,14 @@ from linkedapi.operations import (
     SendMessage,
     SyncConversation,
     SyncInbox,
+    SyncNetwork,
     WithdrawConnectionRequest,
 )
 from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
 from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -142,6 +143,7 @@ __all__ = [
     "SimpleWorkflowMapper",
     "SyncConversation",
     "SyncInbox",
+    "SyncNetwork",
     "ThenWorkflowMapper",
     "VoidWorkflowMapper",
     "WithdrawConnectionRequest",

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/client.py

@@ -41,6 +41,7 @@ from linkedapi.operations import (
     SendMessage,
     SyncConversation,
     SyncInbox,
+    SyncNetwork,
     WithdrawConnectionRequest,
 )
 from linkedapi.types import AccountInfo, LinkedApiActionError, serialize_value
@@ -50,6 +51,7 @@ from linkedapi.types.message import (
     InboxMessage,
     InboxPollRequest,
 )
+from linkedapi.types.network import NetworkEvent, NetworkPollRequest
 from linkedapi.types.statistics import ApiUsageAction, ApiUsageParams
 
 
@@ -67,6 +69,7 @@ class LinkedApi:
         self.send_message = SendMessage(self.http_client)
         self.sync_conversation = SyncConversation(self.http_client)
         self.sync_inbox = SyncInbox(self.http_client)
+        self.sync_network = SyncNetwork(self.http_client)
         self.manage_conversation = ManageConversation(self.http_client)
         self.check_connection_status = CheckConnectionStatus(self.http_client)
         self.send_connection_request = SendConnectionRequest(self.http_client)
@@ -103,6 +106,7 @@ class LinkedApi:
             self.send_message,
             self.sync_conversation,
             self.sync_inbox,
+            self.sync_network,
             self.manage_conversation,
             self.check_connection_status,
             self.send_connection_request,
@@ -189,6 +193,30 @@ class LinkedApi:
             ],
         )
 
+    def poll_network(
+        self,
+        request: NetworkPollRequest | None = None,
+    ) -> MappedResponse[list[NetworkEvent]]:
+        """Read the monitored network connection events, newest events first."""
+
+        payload = serialize_value(request) if request is not None else {}
+        response = self.http_client.post("/network/poll", payload)
+        if response.success and response.result is not None:
+            events = response.result.get("events", [])
+            return MappedResponse(
+                data=[NetworkEvent.model_validate(item) for item in events],
+                errors=[],
+            )
+        return MappedResponse(
+            data=None,
+            errors=[
+                LinkedApiActionError(
+                    type=response.error.type if response.error else "",
+                    message=response.error.message if response.error else "",
+                ),
+            ],
+        )
+
     def get_account_info(self) -> MappedResponse[AccountInfo]:
         """Retrieve basic information about the current LinkedIn account."""
 

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/mappers/__init__.py

@@ -1,5 +1,6 @@
 from linkedapi.mappers.array import ArrayWorkflowMapper
 from linkedapi.mappers.base import BaseMapper, MappedResponse
+from linkedapi.mappers.send_message import SendMessageMapper
 from linkedapi.mappers.simple import SimpleWorkflowMapper
 from linkedapi.mappers.then import ActionConfig, ResponseMapping, ThenWorkflowMapper
 from linkedapi.mappers.void import VoidWorkflowMapper
@@ -10,6 +11,7 @@ __all__ = [
     "BaseMapper",
     "MappedResponse",
     "ResponseMapping",
+    "SendMessageMapper",
     "SimpleWorkflowMapper",
     "ThenWorkflowMapper",
     "VoidWorkflowMapper",

linkedapi-1.3.0/linkedapi/mappers/send_message.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from typing import Any
+
+from linkedapi.mappers.base import (
+    BaseMapper,
+    MappedResponse,
+    as_action_dict,
+    collect_action_errors,
+)
+from linkedapi.types import WorkflowCompletion, WorkflowDefinition, serialize_model
+from linkedapi.types.message import SendMessageParams
+
+
+class SendMessageMapper(BaseMapper[SendMessageParams, None]):
+    def map_request(self, params: SendMessageParams | None = None) -> WorkflowDefinition:
+        serialized = serialize_model(params)
+        manage_conversation = serialized.pop("manageConversation", None)
+        definition: dict[str, Any] = {"actionType": "st.sendMessage", **serialized}
+        # The child st.manageConversation acts on the conversation this message was
+        # sent into, so it carries only `operation` (no threadId — Core rejects a
+        # threadId on a child manageConversation). Guard on `operation` so an empty
+        # passthrough (e.g. Make sending {"operation": ""}) is ignored.
+        if manage_conversation and manage_conversation.get("operation"):
+            definition["then"] = {
+                "actionType": "st.manageConversation",
+                "operation": manage_conversation["operation"],
+            }
+        return definition
+
+    def map_response(self, completion: WorkflowCompletion) -> MappedResponse[None]:
+        if isinstance(completion, list):
+            errors = collect_action_errors(
+                [as_action_dict(action).get("error") for action in completion]
+            )
+            return MappedResponse(data=None, errors=errors)
+
+        action = as_action_dict(completion)
+        raw_errors: list[Any] = [action.get("error")]
+
+        single_data = action.get("data")
+        if single_data is not None:
+            then_actions = as_action_dict(single_data).get("then")
+            if then_actions:
+                child_actions = then_actions if isinstance(then_actions, list) else [then_actions]
+                raw_errors.extend(as_action_dict(child).get("error") for child in child_actions)
+
+        return MappedResponse(data=None, errors=collect_action_errors(raw_errors))

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/operations/__init__.py

@@ -31,6 +31,7 @@ from linkedapi.operations.send_connection_request import SendConnectionRequest
 from linkedapi.operations.send_message import SendMessage
 from linkedapi.operations.sync_conversation import SyncConversation
 from linkedapi.operations.sync_inbox import SyncInbox
+from linkedapi.operations.sync_network import SyncNetwork
 from linkedapi.operations.withdraw_connection_request import WithdrawConnectionRequest
 
 __all__ = [
@@ -73,5 +74,6 @@ __all__ = [
     "SendMessage",
     "SyncConversation",
     "SyncInbox",
+    "SyncNetwork",
     "WithdrawConnectionRequest",
 ]

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/operations/send_message.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from linkedapi.core import Operation
-from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.mappers import SendMessageMapper
 from linkedapi.types import SendMessageParams
 
 
@@ -9,4 +9,4 @@ class SendMessage(Operation[SendMessageParams, None]):
     """Send a standard LinkedIn message."""
 
     operation_name = "sendMessage"
-    mapper = VoidWorkflowMapper[SendMessageParams]("st.sendMessage")
+    mapper = SendMessageMapper()

linkedapi-1.3.0/linkedapi/operations/sync_network.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.types import SyncNetworkParams
+
+
+class SyncNetwork(Operation[SyncNetworkParams, None]):
+    """Enable whole-network monitoring for standard LinkedIn connections."""
+
+    operation_name = "syncNetwork"
+    mapper = VoidWorkflowMapper[SyncNetworkParams]("st.syncNetwork")

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/types/__init__.py

@@ -113,10 +113,17 @@ from linkedapi.types.message import (
     NvSendMessageParams,
     NvSyncConversationParams,
     NvSyncInboxParams,
+    SendMessageManageConversation,
     SendMessageParams,
     SyncConversationParams,
     SyncInboxParams,
 )
+from linkedapi.types.network import (
+    NetworkEvent,
+    NetworkEventType,
+    NetworkPollRequest,
+    SyncNetworkParams,
+)
 from linkedapi.types.params import BaseActionParams, LimitParams, LimitSinceParams
 from linkedapi.types.person import (
     BaseFetchPersonParams,
@@ -194,6 +201,8 @@ from linkedapi.types.webhooks import (
     DeleteWebhookParams,
     MessageWebhookEvent,
     MessageWebhookEventData,
+    NetworkWebhookEvent,
+    NetworkWebhookEventData,
     ReplayWebhookDeliveryParams,
     SetWebhookParams,
     SetWebhookPayloadModeParams,
@@ -312,6 +321,11 @@ __all__ = [
     "MessageWebhookEvent",
     "MessageWebhookEventData",
     "MinAnnualRevenue",
+    "NetworkEvent",
+    "NetworkEventType",
+    "NetworkPollRequest",
+    "NetworkWebhookEvent",
+    "NetworkWebhookEventData",
     "NvBaseFetchCompanyParams",
     "NvBaseFetchCompanyParamsWide",
     "NvCompany",
@@ -381,6 +395,7 @@ __all__ = [
     "SearchPeopleResult",
     "SeatType",
     "SendConnectionRequestParams",
+    "SendMessageManageConversation",
     "SendMessageParams",
     "SetLimitEntry",
     "SetLimitsParams",
@@ -399,6 +414,7 @@ __all__ = [
     "SubscriptionStatusValue",
     "SyncConversationParams",
     "SyncInboxParams",
+    "SyncNetworkParams",
     "WebhookDelivery",
     "WebhookDeliveryStatus",
     "WebhookEvent",

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/types/message.py

@@ -9,10 +9,15 @@ ConversationType = Literal["st", "nv"]
 MessageSender = Literal["us", "them"]
 
 
+class SendMessageManageConversation(LinkedApiModel):
+    operation: str
+
+
 class SendMessageParams(BaseActionParams):
     text: str
     person_url: str | None = None
     thread_id: str | None = None
+    manage_conversation: SendMessageManageConversation | None = None
 
 
 class SyncConversationParams(BaseActionParams):

linkedapi-1.3.0/linkedapi/types/network.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from linkedapi.types.base import LinkedApiModel
+from linkedapi.types.params import BaseActionParams
+
+NetworkEventType = Literal[
+    "connectionAccepted",
+    "connectionAdded",
+    "connectionRequestReceived",
+]
+
+
+class SyncNetworkParams(BaseActionParams):
+    pass
+
+
+class NetworkPollRequest(LinkedApiModel):
+    since: str | None = None
+    type: NetworkEventType | None = None
+
+
+class NetworkEvent(LinkedApiModel):
+    id: str | None = None
+    type: NetworkEventType | None = None
+    person_url: str | None = None
+    detected_at: str | None = None

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/types/webhooks.py

@@ -16,6 +16,9 @@ WebhookEventType = Literal[
     "account.deleted",
     "inbox.messageReceived",
     "inbox.messageSent",
+    "network.connectionAccepted",
+    "network.connectionAdded",
+    "network.connectionRequestReceived",
     "webhook.test",
 ]
 WebhookDeliveryStatus = Literal["pending", "delivering", "success", "failed"]
@@ -112,6 +115,23 @@ class MessageWebhookEvent(LinkedApiModel):
     data: MessageWebhookEventData
 
 
+class NetworkWebhookEventData(LinkedApiModel):
+    account_id: str | None = None
+    person_url: str | None = None
+    detected_at: str | None = None
+
+
+class NetworkWebhookEvent(LinkedApiModel):
+    id: str
+    type: Literal[
+        "network.connectionAccepted",
+        "network.connectionAdded",
+        "network.connectionRequestReceived",
+    ]
+    created_at: str | None = None
+    data: NetworkWebhookEventData
+
+
 class WebhookTestEventData(LinkedApiModel):
     message: str | None = None
 
@@ -124,5 +144,9 @@ class WebhookTestEvent(LinkedApiModel):
 
 
 WebhookEvent = (
-    WorkflowWebhookEvent | AccountWebhookEvent | MessageWebhookEvent | WebhookTestEvent
+    WorkflowWebhookEvent
+    | AccountWebhookEvent
+    | MessageWebhookEvent
+    | NetworkWebhookEvent
+    | WebhookTestEvent
 )

{linkedapi-1.2.0 → linkedapi-1.3.0}/linkedapi/webhooks/parse.py

@@ -5,6 +5,7 @@ import json
 from linkedapi.types.webhooks import (
     AccountWebhookEvent,
     MessageWebhookEvent,
+    NetworkWebhookEvent,
     WebhookEvent,
     WebhookTestEvent,
     WorkflowWebhookEvent,
@@ -44,6 +45,8 @@ def parse_webhook_event(raw_body: str | bytes) -> WebhookEvent:
         return AccountWebhookEvent.model_validate(parsed)
     if event_type.startswith("inbox."):
         return MessageWebhookEvent.model_validate(parsed)
+    if event_type.startswith("network."):
+        return NetworkWebhookEvent.model_validate(parsed)
     if event_type == "webhook.test":
         return WebhookTestEvent.model_validate(parsed)
 

{linkedapi-1.2.0 → linkedapi-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "linkedapi"
-version = "1.2.0"
+version = "1.3.0"
 description = "Official synchronous Python SDK for Linked API."
 readme = "README.md"
 requires-python = ">=3.10"

{linkedapi-1.2.0 → linkedapi-1.3.0}/tests/test_operations.py

@@ -38,6 +38,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "send_message",
         "sync_conversation",
         "sync_inbox",
+        "sync_network",
         "manage_conversation",
         "nv_send_message",
         "nv_sync_conversation",
@@ -55,7 +56,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         assert hasattr(operation, "execute")
         assert hasattr(operation, "result")
         assert hasattr(operation, "cancel")
-    assert len(linkedapi.operations) == 34
+    assert len(linkedapi.operations) == 35
 
 
 def test_operation_mappers_match_node_contract() -> None: