linkedapi 1.3.5__tar.gz → 1.3.7__tar.gz

{linkedapi-1.3.5 → linkedapi-1.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkedapi
-Version: 1.3.5
+Version: 1.3.7
 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.3.5 → linkedapi-1.3.7}/linkedapi/__init__.py

@@ -78,7 +78,7 @@ from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
 from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.3.5"
+__version__ = "1.3.7"
 PredefinedOperation = Operation
 
 __all__ = [

{linkedapi-1.3.5 → linkedapi-1.3.7}/linkedapi/core/operation.py

@@ -60,6 +60,7 @@ class Operation(ABC, Generic[TParams, TResult]):
                 workflow_id=workflow_id,
                 workflow_status=workflow_result.workflow_status,
                 message=workflow_result.message,
+                pending_reason=workflow_result.pending_reason,
             )
 
         completion = self._get_completion(workflow_result)

{linkedapi-1.3.5 → linkedapi-1.3.7}/linkedapi/errors.py

@@ -66,6 +66,8 @@ LinkedApiErrorType = Literal[
     "linkedinAccountSignedOut",
     "languageNotSupported",
     "workflowTimeout",
+    "outsideWorkingHours",
+    "workingHoursWaitExpired",
     "httpError",
     "tooManyRequests",
     "accountNotFound",
@@ -87,6 +89,8 @@ LINKED_API_ERROR_TYPES: tuple[str, ...] = (
     "linkedinAccountSignedOut",
     "languageNotSupported",
     "workflowTimeout",
+    "outsideWorkingHours",
+    "workingHoursWaitExpired",
     "httpError",
     "tooManyRequests",
     "accountNotFound",

linkedapi-1.3.7/linkedapi/operations/nv_sync_conversation.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import NvSyncConversationParams, NvSyncConversationResult
+
+
+class NvSyncConversation(Operation[NvSyncConversationParams, NvSyncConversationResult]):
+    """Sync a Sales Navigator conversation."""
+
+    operation_name = "nvSyncConversation"
+    mapper = SimpleWorkflowMapper[NvSyncConversationParams, NvSyncConversationResult](
+        "nv.syncConversation",
+        result_model=NvSyncConversationResult,
+    )

linkedapi-1.3.7/linkedapi/operations/sync_conversation.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import SyncConversationParams, SyncConversationResult
+
+
+class SyncConversation(Operation[SyncConversationParams, SyncConversationResult]):
+    """Sync a standard LinkedIn conversation."""
+
+    operation_name = "syncConversation"
+    mapper = SimpleWorkflowMapper[SyncConversationParams, SyncConversationResult](
+        "st.syncConversation",
+        result_model=SyncConversationResult,
+    )

{linkedapi-1.3.5 → linkedapi-1.3.7}/linkedapi/types/__init__.py

@@ -115,10 +115,12 @@ from linkedapi.types.message import (
     NvManageConversationParams,
     NvSendMessageParams,
     NvSyncConversationParams,
+    NvSyncConversationResult,
     NvSyncInboxParams,
     SendMessageManageConversation,
     SendMessageParams,
     SyncConversationParams,
+    SyncConversationResult,
     SyncInboxParams,
 )
 from linkedapi.types.network import (
@@ -235,6 +237,7 @@ from linkedapi.types.workflow import (
     WorkflowFailure,
     WorkflowInProgressResponse,
     WorkflowInProgressStatus,
+    WorkflowPendingReason,
     WorkflowResponse,
     WorkflowStartedResponse,
     WorkflowStatus,
@@ -360,6 +363,7 @@ __all__ = [
     "NvSearchPeopleResult",
     "NvSendMessageParams",
     "NvSyncConversationParams",
+    "NvSyncConversationResult",
     "NvSyncInboxParams",
     "PendingConnectionSession",
     "Person",
@@ -430,6 +434,7 @@ __all__ = [
     "SubscriptionStatus",
     "SubscriptionStatusValue",
     "SyncConversationParams",
+    "SyncConversationResult",
     "SyncInboxParams",
     "SyncNetworkParams",
     "WebhookDelivery",
@@ -448,6 +453,7 @@ __all__ = [
     "WorkflowFailure",
     "WorkflowInProgressResponse",
     "WorkflowInProgressStatus",
+    "WorkflowPendingReason",
     "WorkflowResponse",
     "WorkflowStartedResponse",
     "WorkflowStatus",

{linkedapi-1.3.5 → linkedapi-1.3.7}/linkedapi/types/message.py

@@ -22,6 +22,11 @@ class SendMessageParams(BaseActionParams):
 
 class SyncConversationParams(BaseActionParams):
     person_url: str
+    days: int | None = None
+
+
+class SyncConversationResult(LinkedApiModel):
+    sync_until: str
 
 
 class SyncInboxParams(BaseActionParams):
@@ -42,6 +47,11 @@ class NvSendMessageParams(BaseActionParams):
 
 class NvSyncConversationParams(BaseActionParams):
     person_url: str
+    days: int | None = None
+
+
+class NvSyncConversationResult(LinkedApiModel):
+    sync_until: str
 
 
 class NvSyncInboxParams(BaseActionParams):
@@ -72,6 +82,7 @@ class ConversationPollResult(LinkedApiModel):
     type: ConversationType | None = None
     messages: list[Message] | None = None
     since: str | None = None
+    sync_until: str | None = None
 
 
 class InboxPollRequest(LinkedApiModel):

{linkedapi-1.3.5 → linkedapi-1.3.7}/linkedapi/types/workflow.py

@@ -9,6 +9,7 @@ WorkflowPendingStatus = Literal["pending"]
 WorkflowRunningStatus = Literal["running"]
 WorkflowInProgressStatus = Literal["pending", "running"]
 WorkflowStatus = Literal["pending", "running", "completed", "failed"]
+WorkflowPendingReason = Literal["queued", "outsideWorkingHours"]
 WorkflowDefinition = dict[str, Any] | list[dict[str, Any]]
 WorkflowCompletion = dict[str, Any] | list[dict[str, Any]]
 
@@ -22,12 +23,15 @@ class WorkflowStartedResponse(LinkedApiModel):
     workflow_id: str
     workflow_status: WorkflowInProgressStatus
     message: str | None = None
+    # Optional so an older API that does not send it still parses.
+    pending_reason: WorkflowPendingReason | None = None
 
 
 class WorkflowInProgressResponse(LinkedApiModel):
     workflow_id: str
     workflow_status: WorkflowInProgressStatus
     message: str | None = None
+    pending_reason: WorkflowPendingReason | None = None
 
 
 class WorkflowFailure(LinkedApiModel):
@@ -43,6 +47,7 @@ class WorkflowResponse(LinkedApiModel):
     workflow_id: str
     workflow_status: WorkflowStatus
     message: str | None = None
+    pending_reason: WorkflowPendingReason | None = None
     completion: WorkflowCompletion | None = None
     failure: WorkflowFailure | None = None
 

{linkedapi-1.3.5 → linkedapi-1.3.7}/pyproject.toml

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

{linkedapi-1.3.5 → linkedapi-1.3.7}/tests/test_errors.py

@@ -21,6 +21,8 @@ def test_error_type_sets_match_node_contract() -> None:
         "linkedinAccountSignedOut",
         "languageNotSupported",
         "workflowTimeout",
+        "outsideWorkingHours",
+        "workingHoursWaitExpired",
         "httpError",
         "tooManyRequests",
         "accountNotFound",

linkedapi-1.3.7/tests/test_working_hours_contract.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+from typing import Any
+from unittest.mock import Mock
+
+import pytest
+
+from linkedapi.core.operation import Operation
+from linkedapi.errors import LINKED_API_ERROR_TYPES
+from linkedapi.types import (
+    WorkflowInProgressResponse,
+    WorkflowResponse,
+    WorkflowStartedResponse,
+)
+
+
+class _StubMapper:
+    def map_request(self, params: Any) -> Any:
+        return params
+
+    def map_response(self, completion: Any) -> Any:
+        return completion
+
+
+class _StubOperation(Operation):  # type: ignore[type-arg]
+    operation_name = "fetchPerson"
+
+    def __init__(self, http_client: Any) -> None:
+        super().__init__(http_client)
+        self.mapper = _StubMapper()  # type: ignore[assignment]
+
+
+def _operation(workflow_result: dict[str, Any]) -> _StubOperation:
+    http_client = Mock()
+    http_client.get.return_value = Mock(
+        error=None,
+        result=WorkflowResponse.model_validate(workflow_result),
+    )
+    return _StubOperation(http_client)
+
+
+class TestPendingReasonModels:
+    def test_in_progress_response_accepts_a_pending_reason(self) -> None:
+        response = WorkflowInProgressResponse(
+            workflowId="wf-1",
+            workflowStatus="pending",
+            pendingReason="outsideWorkingHours",
+        )
+
+        assert response.pending_reason == "outsideWorkingHours"
+
+    def test_started_response_accepts_a_pending_reason(self) -> None:
+        response = WorkflowStartedResponse(
+            workflowId="wf-1",
+            workflowStatus="pending",
+            pendingReason="queued",
+        )
+
+        assert response.pending_reason == "queued"
+
+    @pytest.mark.parametrize(
+        "model",
+        [WorkflowInProgressResponse, WorkflowStartedResponse, WorkflowResponse],
+    )
+    def test_field_is_optional_for_back_compat(self, model: Any) -> None:
+        response = model(workflowId="wf-1", workflowStatus="running")
+
+        assert response.pending_reason is None
+
+
+class TestStatusCarriesPendingReason:
+    def test_carries_the_outside_working_hours_reason(self) -> None:
+        operation = _operation(
+            {
+                "workflowId": "wf-1",
+                "workflowStatus": "pending",
+                "pendingReason": "outsideWorkingHours",
+            }
+        )
+
+        result = operation.status("wf-1")
+
+        assert isinstance(result, WorkflowInProgressResponse)
+        assert result.pending_reason == "outsideWorkingHours"
+
+    def test_carries_the_queued_reason(self) -> None:
+        operation = _operation(
+            {"workflowId": "wf-1", "workflowStatus": "pending", "pendingReason": "queued"}
+        )
+
+        result = operation.status("wf-1")
+
+        assert isinstance(result, WorkflowInProgressResponse)
+        assert result.pending_reason == "queued"
+
+    def test_keeps_none_when_the_api_sends_nothing(self) -> None:
+        operation = _operation({"workflowId": "wf-1", "workflowStatus": "running"})
+
+        result = operation.status("wf-1")
+
+        assert isinstance(result, WorkflowInProgressResponse)
+        assert result.pending_reason is None
+
+
+class TestWorkingHoursErrorTypes:
+    @pytest.mark.parametrize("error_type", ["outsideWorkingHours", "workingHoursWaitExpired"])
+    def test_error_type_is_known(self, error_type: str) -> None:
+        assert error_type in LINKED_API_ERROR_TYPES

linkedapi-1.3.5/linkedapi/operations/nv_sync_conversation.py

@@ -1,12 +0,0 @@
-from __future__ import annotations
-
-from linkedapi.core import Operation
-from linkedapi.mappers import VoidWorkflowMapper
-from linkedapi.types import NvSyncConversationParams
-
-
-class NvSyncConversation(Operation[NvSyncConversationParams, None]):
-    """Sync a Sales Navigator conversation."""
-
-    operation_name = "nvSyncConversation"
-    mapper = VoidWorkflowMapper[NvSyncConversationParams]("nv.syncConversation")

linkedapi-1.3.5/linkedapi/operations/sync_conversation.py

@@ -1,12 +0,0 @@
-from __future__ import annotations
-
-from linkedapi.core import Operation
-from linkedapi.mappers import VoidWorkflowMapper
-from linkedapi.types import SyncConversationParams
-
-
-class SyncConversation(Operation[SyncConversationParams, None]):
-    """Sync a standard LinkedIn conversation."""
-
-    operation_name = "syncConversation"
-    mapper = VoidWorkflowMapper[SyncConversationParams]("st.syncConversation")