linkedapi 1.3.3__tar.gz → 1.3.5__tar.gz

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

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

@@ -54,9 +54,12 @@ from linkedapi.operations import (
     NvSendMessage,
     NvSyncConversation,
     NvSyncInbox,
+    ReactToComment,
     ReactToPost,
     RemoveConnection,
+    ReplyToComment,
     RetrieveConnections,
+    RetrieveFeed,
     RetrieveInvitations,
     RetrievePendingRequests,
     RetrievePerformance,
@@ -75,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.2"
+__version__ = "1.3.5"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -127,11 +130,14 @@ __all__ = [
     "NvSyncInbox",
     "Operation",
     "PredefinedOperation",
+    "ReactToComment",
     "ReactToPost",
     "RemoveConnection",
+    "ReplyToComment",
     "ResponseMapping",
     "RetrieveInvitations",
     "RetrieveConnections",
+    "RetrieveFeed",
     "RetrievePendingRequests",
     "RetrievePerformance",
     "RetrieveSSI",

{linkedapi-1.3.3 → linkedapi-1.3.5}/linkedapi/client.py

@@ -27,9 +27,12 @@ from linkedapi.operations import (
     NvSendMessage,
     NvSyncConversation,
     NvSyncInbox,
+    ReactToComment,
     ReactToPost,
     RemoveConnection,
+    ReplyToComment,
     RetrieveConnections,
+    RetrieveFeed,
     RetrieveInvitations,
     RetrievePendingRequests,
     RetrievePerformance,
@@ -89,7 +92,10 @@ class LinkedApi:
         self.fetch_job = FetchJob(self.http_client)
         self.react_to_post = ReactToPost(self.http_client)
         self.comment_on_post = CommentOnPost(self.http_client)
+        self.react_to_comment = ReactToComment(self.http_client)
+        self.reply_to_comment = ReplyToComment(self.http_client)
         self.create_post = CreatePost(self.http_client)
+        self.retrieve_feed = RetrieveFeed(self.http_client)
         self.retrieve_ssi = RetrieveSSI(self.http_client)
         self.retrieve_performance = RetrievePerformance(self.http_client)
         self.nv_send_message = NvSendMessage(self.http_client)
@@ -126,7 +132,10 @@ class LinkedApi:
             self.fetch_job,
             self.react_to_post,
             self.comment_on_post,
+            self.react_to_comment,
+            self.reply_to_comment,
             self.create_post,
+            self.retrieve_feed,
             self.retrieve_ssi,
             self.retrieve_performance,
             self.nv_send_message,

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

@@ -20,6 +20,8 @@ LinkedApiActionErrorType = Literal[
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",
+    "commentNotFound",
+    "replyingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
     "conversationsNotSynced",
@@ -43,6 +45,8 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",
+    "commentNotFound",
+    "replyingNotAllowed",
     "noPostingPermission",
     "noSalesNavigator",
     "conversationsNotSynced",

{linkedapi-1.3.3 → linkedapi-1.3.5}/linkedapi/operations/__init__.py

@@ -17,9 +17,12 @@ from linkedapi.operations.nv_search_people import NvSearchPeople
 from linkedapi.operations.nv_send_message import NvSendMessage
 from linkedapi.operations.nv_sync_conversation import NvSyncConversation
 from linkedapi.operations.nv_sync_inbox import NvSyncInbox
+from linkedapi.operations.react_to_comment import ReactToComment
 from linkedapi.operations.react_to_post import ReactToPost
 from linkedapi.operations.remove_connection import RemoveConnection
+from linkedapi.operations.reply_to_comment import ReplyToComment
 from linkedapi.operations.retrieve_connections import RetrieveConnections
+from linkedapi.operations.retrieve_feed import RetrieveFeed
 from linkedapi.operations.retrieve_invitations import RetrieveInvitations
 from linkedapi.operations.retrieve_pending_requests import RetrievePendingRequests
 from linkedapi.operations.retrieve_performance import RetrievePerformance
@@ -60,9 +63,12 @@ __all__ = [
     "NvSendMessage",
     "NvSyncConversation",
     "NvSyncInbox",
+    "ReactToComment",
     "ReactToPost",
     "RemoveConnection",
+    "ReplyToComment",
     "RetrieveConnections",
+    "RetrieveFeed",
     "RetrieveInvitations",
     "RetrievePendingRequests",
     "RetrievePerformance",

linkedapi-1.3.5/linkedapi/operations/comment_on_post.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import CommentOnPostParams, CommentResult
+
+
+class CommentOnPost(Operation[CommentOnPostParams, CommentResult]):
+    """Comment on a LinkedIn post."""
+
+    operation_name = "commentOnPost"
+    mapper = SimpleWorkflowMapper[CommentOnPostParams, CommentResult](
+        "st.commentOnPost",
+        result_model=CommentResult,
+    )

linkedapi-1.3.5/linkedapi/operations/react_to_comment.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.types import ReactToCommentParams
+
+
+class ReactToComment(Operation[ReactToCommentParams, None]):
+    """React to a LinkedIn comment."""
+
+    operation_name = "reactToComment"
+    mapper = VoidWorkflowMapper[ReactToCommentParams]("st.reactToComment")

linkedapi-1.3.5/linkedapi/operations/reply_to_comment.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import SimpleWorkflowMapper
+from linkedapi.types import CommentResult, ReplyToCommentParams
+
+
+class ReplyToComment(Operation[ReplyToCommentParams, CommentResult]):
+    """Reply to a LinkedIn comment."""
+
+    operation_name = "replyToComment"
+    mapper = SimpleWorkflowMapper[ReplyToCommentParams, CommentResult](
+        "st.replyToComment",
+        result_model=CommentResult,
+    )

linkedapi-1.3.5/linkedapi/operations/retrieve_feed.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import ArrayWorkflowMapper
+from linkedapi.types import FeedPost, RetrieveFeedParams
+
+
+class RetrieveFeed(Operation[RetrieveFeedParams, list[FeedPost]]):
+    """Retrieve posts from the current account's LinkedIn home feed."""
+
+    operation_name = "retrieveFeed"
+    mapper = ArrayWorkflowMapper[RetrieveFeedParams, FeedPost](
+        "st.retrieveFeed",
+        FeedPost,
+    )

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

@@ -87,6 +87,7 @@ from linkedapi.types.connection import (
     SendConnectionRequestParams,
     WithdrawConnectionRequestParams,
 )
+from linkedapi.types.feed import FeedPost, RetrieveFeedParams
 from linkedapi.types.jobs import (
     FetchJobParams,
     FetchJobResult,
@@ -148,6 +149,8 @@ from linkedapi.types.post import (
     BaseFetchPostParamsWide,
     Comment,
     CommentOnPostParams,
+    CommentOnPostResult,
+    CommentResult,
     CreatePostAttachment,
     CreatePostParams,
     CreatePostResult,
@@ -167,7 +170,10 @@ from linkedapi.types.post import (
     PostType,
     Reaction,
     ReactionType,
+    ReactToCommentParams,
     ReactToPostParams,
+    ReplyToCommentParams,
+    ReplyToCommentResult,
 )
 from linkedapi.types.responses import LinkedApiRequestError, LinkedApiResponse
 from linkedapi.types.search_companies import (
@@ -261,6 +267,8 @@ __all__ = [
     "CheckConnectionStatusResult",
     "Comment",
     "CommentOnPostParams",
+    "CommentOnPostResult",
+    "CommentResult",
     "Company",
     "ConnectionPerson",
     "ConnectionSession",
@@ -281,6 +289,7 @@ __all__ = [
     "DeleteWebhookParams",
     "DisconnectParams",
     "EmploymentType",
+    "FeedPost",
     "FetchCompanyParams",
     "FetchCompanyResult",
     "FetchJobParams",
@@ -370,6 +379,7 @@ __all__ = [
     "PostReactionsRetrievalConfig",
     "PostReposter",
     "PostType",
+    "ReactToCommentParams",
     "ReactToPostParams",
     "Reaction",
     "ReactionType",
@@ -379,10 +389,13 @@ __all__ = [
     "ReparseAccountInfoParams",
     "ReparseAccountInfoResult",
     "ReplayWebhookDeliveryParams",
+    "ReplyToCommentParams",
+    "ReplyToCommentResult",
     "ResetLimitsParams",
     "RetrieveConnectionsFilter",
     "RetrieveConnectionsParams",
     "RetrieveConnectionsResult",
+    "RetrieveFeedParams",
     "RetrievePendingRequestsResult",
     "RetrievePerformanceResult",
     "RetrieveSSIResult",

linkedapi-1.3.5/linkedapi/types/feed.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from pydantic import Field
+
+from linkedapi.types.params import LimitParams
+from linkedapi.types.post import Post
+
+
+class FeedPost(Post):
+    feed_context: str | None = None
+
+
+class RetrieveFeedParams(LimitParams):
+    limit: int | None = Field(default=None, ge=1, le=100)

{linkedapi-1.3.3 → linkedapi-1.3.5}/linkedapi/types/post.py

@@ -40,7 +40,30 @@ class CommentOnPostParams(BaseActionParams):
     company_url: str | None = None
 
 
+class CommentResult(LinkedApiModel):
+    comment_urn: str | None = None
+    comment_url: str | None = None
+
+
+CommentOnPostResult: TypeAlias = CommentResult
+
+
+class ReactToCommentParams(BaseActionParams):
+    comment_url: str
+    type: ReactionType = "like"
+
+
+class ReplyToCommentParams(BaseActionParams):
+    comment_url: str
+    text: str
+
+
+ReplyToCommentResult: TypeAlias = CommentResult
+
+
 class PostComment(LinkedApiModel):
+    comment_urn: str | None = None
+    comment_url: str | None = None
     commenter_url: str | None = None
     commenter_name: str | None = None
     commenter_headline: str | None = None

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

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

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

@@ -47,6 +47,8 @@ def test_error_type_sets_match_node_contract() -> None:
         "postNotFound",
         "jobNotFound",
         "commentingNotAllowed",
+        "commentNotFound",
+        "replyingNotAllowed",
         "noPostingPermission",
         "noSalesNavigator",
         "conversationsNotSynced",

{linkedapi-1.3.3 → linkedapi-1.3.5}/tests/test_operations.py

@@ -7,10 +7,13 @@ from pydantic import ValidationError
 from linkedapi import (
     AcceptInvitationParams,
     ArrayWorkflowMapper,
+    FeedPost,
     FetchPersonParams,
     Invitation,
     LinkedApi,
     LinkedApiConfig,
+    RetrieveFeedParams,
+    SimpleWorkflowMapper,
     VoidWorkflowMapper,
 )
 
@@ -38,6 +41,7 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "retrieve_pending_requests",
         "retrieve_invitations",
         "retrieve_connections",
+        "retrieve_feed",
         "remove_connection",
         "send_message",
         "sync_conversation",
@@ -50,6 +54,8 @@ def test_linked_api_exposes_all_predefined_operations() -> None:
         "nv_manage_conversation",
         "react_to_post",
         "comment_on_post",
+        "react_to_comment",
+        "reply_to_comment",
         "create_post",
         "retrieve_ssi",
         "retrieve_performance",
@@ -60,7 +66,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) == 35
+    assert len(linkedapi.operations) == 38
 
 
 def test_operation_mappers_match_node_contract() -> None:
@@ -82,6 +88,8 @@ def test_operation_mappers_match_node_contract() -> None:
     assert linkedapi.ignore_invitation.mapper.action_type == "st.ignoreInvitation"
     assert isinstance(linkedapi.retrieve_invitations.mapper, ArrayWorkflowMapper)
     assert linkedapi.retrieve_invitations.mapper.base_action_type == "st.retrieveInvitations"
+    assert isinstance(linkedapi.retrieve_feed.mapper, ArrayWorkflowMapper)
+    assert linkedapi.retrieve_feed.mapper.base_action_type == "st.retrieveFeed"
     assert isinstance(linkedapi.sync_inbox.mapper, VoidWorkflowMapper)
     assert linkedapi.sync_inbox.mapper.action_type == "st.syncInbox"
     assert isinstance(linkedapi.nv_sync_inbox.mapper, VoidWorkflowMapper)
@@ -90,6 +98,39 @@ def test_operation_mappers_match_node_contract() -> None:
     assert linkedapi.manage_conversation.mapper.action_type == "st.manageConversation"
     assert isinstance(linkedapi.nv_manage_conversation.mapper, VoidWorkflowMapper)
     assert linkedapi.nv_manage_conversation.mapper.action_type == "nv.manageConversation"
+    assert isinstance(linkedapi.react_to_comment.mapper, VoidWorkflowMapper)
+    assert linkedapi.react_to_comment.mapper.action_type == "st.reactToComment"
+    assert isinstance(linkedapi.comment_on_post.mapper, SimpleWorkflowMapper)
+    assert linkedapi.comment_on_post.mapper.action_type == "st.commentOnPost"
+    assert isinstance(linkedapi.reply_to_comment.mapper, SimpleWorkflowMapper)
+    assert linkedapi.reply_to_comment.mapper.action_type == "st.replyToComment"
+
+
+def test_retrieve_feed_maps_params_and_feed_context() -> None:
+    linkedapi = LinkedApi(LinkedApiConfig(linked_api_token="x", identification_token="y"))
+
+    request = linkedapi.retrieve_feed.mapper.map_request(RetrieveFeedParams(limit=25))
+    response = linkedapi.retrieve_feed.mapper.map_response(
+        {
+            "actionType": "st.retrieveFeed",
+            "success": True,
+            "data": [
+                {
+                    "url": "https://www.linkedin.com/feed/update/urn:li:activity:1",
+                    "feedContext": "Example Person reacted to this",
+                }
+            ],
+        }
+    )
+
+    assert request == {"actionType": "st.retrieveFeed", "limit": 25}
+    assert response.data is not None
+    assert isinstance(response.data[0], FeedPost)
+    assert response.data[0].feed_context == "Example Person reacted to this"
+
+    for invalid_limit in (0, 101):
+        with pytest.raises(ValidationError):
+            RetrieveFeedParams(limit=invalid_limit)
 
 
 def test_invitation_params_require_the_matching_target_url() -> None:

linkedapi-1.3.3/linkedapi/operations/comment_on_post.py

@@ -1,12 +0,0 @@
-from __future__ import annotations
-
-from linkedapi.core import Operation
-from linkedapi.mappers import VoidWorkflowMapper
-from linkedapi.types import CommentOnPostParams
-
-
-class CommentOnPost(Operation[CommentOnPostParams, None]):
-    """Comment on a LinkedIn post."""
-
-    operation_name = "commentOnPost"
-    mapper = VoidWorkflowMapper[CommentOnPostParams]("st.commentOnPost")