add comment interaction API

Author: LordOfTheVillage

examples/post-actions.ts

@@ -13,6 +13,8 @@ async function postActionsExample(): Promise<void> {
     await createCompanyPost(linkedapi);
     await reactToPost(linkedapi);
     await commentOnPost(linkedapi);
+    await reactToComment(linkedapi);
+    await replyToComment(linkedapi);
   } catch (error) {
     if (error instanceof LinkedApiError) {
       console.error('🚨 Linked API Error:', error.message);
@@ -127,6 +129,46 @@ async function commentOnPost(linkedapi: LinkedApi): Promise<void> {
     console.error('🚨 Errors:', JSON.stringify(commentResult.errors, null, 2));
   } else {
     console.log('✅ Comment added successfully');
+    console.log('🔗 Comment URN:', commentResult.data?.commentUrn);
+    console.log('🔗 Comment URL:', commentResult.data?.commentUrl);
+  }
+}
+
+async function reactToComment(linkedapi: LinkedApi): Promise<void> {
+  console.log('\n👍 Reacting to a comment...');
+
+  const workflow = await linkedapi.reactToComment.execute({
+    commentUrl:
+      'https://www.linkedin.com/feed/update/urn:li:activity:123/?dashCommentUrn=urn:li:fsd_comment:(456,urn:li:activity:123)',
+    type: 'like',
+  });
+  console.log('👍 React to comment workflow started:', workflow.workflowId);
+
+  const reactionResult = await linkedapi.reactToComment.result(workflow.workflowId);
+  if (reactionResult.errors.length > 0) {
+    console.error('🚨 Errors:', JSON.stringify(reactionResult.errors, null, 2));
+  } else {
+    console.log('✅ Comment reaction added successfully');
+  }
+}
+
+async function replyToComment(linkedapi: LinkedApi): Promise<void> {
+  console.log('\n💬 Replying to a comment...');
+
+  const workflow = await linkedapi.replyToComment.execute({
+    commentUrl:
+      'https://www.linkedin.com/feed/update/urn:li:activity:123/?dashCommentUrn=urn:li:fsd_comment:(456,urn:li:activity:123)',
+    text: 'Totally agree — thanks for adding this!',
+  });
+  console.log('💬 Reply to comment workflow started:', workflow.workflowId);
+
+  const replyResult = await linkedapi.replyToComment.result(workflow.workflowId);
+  if (replyResult.errors.length > 0) {
+    console.error('🚨 Errors:', JSON.stringify(replyResult.errors, null, 2));
+  } else {
+    console.log('✅ Reply posted successfully');
+    console.log('🔗 Reply URN:', replyResult.data?.commentUrn);
+    console.log('🔗 Reply URL:', replyResult.data?.commentUrl);
   }
 }
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/node",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Control your LinkedIn accounts and retrieve real-time data, all through this Node.js SDK.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/core/operation.ts

@@ -38,6 +38,8 @@ export const OPERATION_NAME = {
   fetchJob: 'fetchJob',
   reactToPost: 'reactToPost',
   commentOnPost: 'commentOnPost',
+  reactToComment: 'reactToComment',
+  replyToComment: 'replyToComment',
   createPost: 'createPost',
   retrieveSSI: 'retrieveSSI',
   retrievePerformance: 'retrievePerformance',

src/index.ts

@@ -21,8 +21,10 @@ import {
   NvSendMessage,
   NvSyncConversation,
   NvSyncInbox,
+  ReactToComment,
   ReactToPost,
   RemoveConnection,
+  ReplyToComment,
   RetrieveConnectionRequests,
   RetrieveConnections,
   RetrievePendingRequests,
@@ -125,6 +127,8 @@ class LinkedApi {
     this.fetchJob = new FetchJob(this.httpClient);
     this.reactToPost = new ReactToPost(this.httpClient);
     this.commentOnPost = new CommentOnPost(this.httpClient);
+    this.reactToComment = new ReactToComment(this.httpClient);
+    this.replyToComment = new ReplyToComment(this.httpClient);
     this.createPost = new CreatePost(this.httpClient);
     this.retrieveSSI = new RetrieveSSI(this.httpClient);
     this.retrievePerformance = new RetrievePerformance(this.httpClient);
@@ -162,6 +166,8 @@ class LinkedApi {
       this.fetchJob,
       this.reactToPost,
       this.commentOnPost,
+      this.reactToComment,
+      this.replyToComment,
       this.createPost,
       this.retrieveSSI,
       this.retrievePerformance,
@@ -1299,12 +1305,63 @@ class LinkedApi {
    *   text: "Great insights! Thanks for sharing this valuable information."
    * });
    *
-   * await linkedapi.commentOnPost.result(workflow.workflowId);
-   * console.log("Comment posted successfully");
+   * const { data } = await linkedapi.commentOnPost.result(workflow.workflowId);
+   * console.log("Comment posted:", data?.commentUrn, data?.commentUrl);
    * ```
    */
   public commentOnPost: CommentOnPost;
 
+  /**
+   * React to a LinkedIn comment with an emoji reaction.
+   *
+   * This method adds a reaction (like, love, celebrate, support, funny, insightful) to a specific
+   * comment, identified by its comment URL (as returned by `commentOnPost` / `fetchPost` comments).
+   * The reaction type defaults to `like` when omitted.
+   *
+   * @param params - Parameters including the comment URL and optional reaction type
+   * @returns Promise resolving to the reaction action
+   *
+   * @see {@link https://linkedapi.io/docs/reacting-and-commenting/ Reacting and Commenting Documentation}
+   * @see {@link https://linkedapi.io/docs/action-st-react-to-comment/ st.reactToComment Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * const workflow = await linkedapi.reactToComment.execute({
+   *   commentUrl: "https://www.linkedin.com/feed/update/urn:li:activity:123/?dashCommentUrn=urn:li:fsd_comment:(456,urn:li:activity:123)",
+   *   type: "like"
+   * });
+   *
+   * await linkedapi.reactToComment.result(workflow.workflowId);
+   * console.log("Comment reaction added successfully");
+   * ```
+   */
+  public reactToComment: ReactToComment;
+
+  /**
+   * Reply to a LinkedIn comment.
+   *
+   * This method posts a text reply to a specific comment, identified by its comment URL. It returns
+   * the created reply's `commentUrn` and `commentUrl` so it can be tracked or acted on afterwards.
+   *
+   * @param params - Parameters including the comment URL and reply text
+   * @returns Promise resolving to the created reply's URN and URL
+   *
+   * @see {@link https://linkedapi.io/docs/reacting-and-commenting/ Reacting and Commenting Documentation}
+   * @see {@link https://linkedapi.io/docs/action-st-reply-to-comment/ st.replyToComment Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * const workflow = await linkedapi.replyToComment.execute({
+   *   commentUrl: "https://www.linkedin.com/feed/update/urn:li:activity:123/?dashCommentUrn=urn:li:fsd_comment:(456,urn:li:activity:123)",
+   *   text: "Totally agree — thanks for adding this!"
+   * });
+   *
+   * const { data } = await linkedapi.replyToComment.result(workflow.workflowId);
+   * console.log("Reply posted:", data?.commentUrn, data?.commentUrl);
+   * ```
+   */
+  public replyToComment: ReplyToComment;
+
   /**
    * Create a LinkedIn post on your personal profile or a company page.
    *

src/operations/comment-on-post.ts

@@ -1,10 +1,13 @@
 import { Operation, TOperationName } from '../core';
-import { VoidWorkflowMapper } from '../mappers';
-import { TCommentOnPostParams } from '../types';
+import { SimpleWorkflowMapper } from '../mappers';
+import { TCommentOnPostParams, TCommentOnPostResult } from '../types';
 
-export class CommentOnPost extends Operation<TCommentOnPostParams, void> {
+export class CommentOnPost extends Operation<TCommentOnPostParams, TCommentOnPostResult> {
   public override readonly operationName: TOperationName = 'commentOnPost';
-  protected override readonly mapper = new VoidWorkflowMapper<TCommentOnPostParams>(
-    'st.commentOnPost',
-  );
+  protected override readonly mapper = new SimpleWorkflowMapper<
+    TCommentOnPostParams,
+    TCommentOnPostResult
+  >({
+    actionType: 'st.commentOnPost',
+  });
 }

src/operations/index.ts

@@ -30,6 +30,8 @@ export * from './retrieve-connections';
 export * from './remove-connection';
 export * from './react-to-post';
 export * from './comment-on-post';
+export * from './react-to-comment';
+export * from './reply-to-comment';
 export * from './create-post';
 export * from './retrieve-ssi';
 export * from './retrieve-performance';

src/operations/react-to-comment.ts

@@ -0,0 +1,10 @@
+import { Operation, TOperationName } from '../core';
+import { VoidWorkflowMapper } from '../mappers';
+import { TReactToCommentParams } from '../types';
+
+export class ReactToComment extends Operation<TReactToCommentParams, void> {
+  public override readonly operationName: TOperationName = 'reactToComment';
+  protected override readonly mapper = new VoidWorkflowMapper<TReactToCommentParams>(
+    'st.reactToComment',
+  );
+}

src/operations/reply-to-comment.ts

@@ -0,0 +1,13 @@
+import { Operation, TOperationName } from '../core';
+import { SimpleWorkflowMapper } from '../mappers';
+import { TReplyToCommentParams, TReplyToCommentResult } from '../types';
+
+export class ReplyToComment extends Operation<TReplyToCommentParams, TReplyToCommentResult> {
+  public override readonly operationName: TOperationName = 'replyToComment';
+  protected override readonly mapper = new SimpleWorkflowMapper<
+    TReplyToCommentParams,
+    TReplyToCommentResult
+  >({
+    actionType: 'st.replyToComment',
+  });
+}

src/types/actions/post.ts

@@ -102,13 +102,34 @@ export interface TCommentOnPostParams extends TBaseActionParams {
   companyUrl?: string;
 }
 
+export interface TCommentResult {
+  commentUrn: string | null;
+  commentUrl: string | null;
+}
+
+export type TCommentOnPostResult = TCommentResult;
+
+export interface TReactToCommentParams extends TBaseActionParams {
+  commentUrl: string;
+  type?: TReactionType;
+}
+
+export interface TReplyToCommentParams extends TBaseActionParams {
+  commentUrl: string;
+  text: string;
+}
+
+export type TReplyToCommentResult = TCommentResult;
+
 export const POST_COMMENTER_TYPE = {
   person: 'person',
   company: 'company',
 } as const;
 export type TPostCommenterType = (typeof POST_COMMENTER_TYPE)[keyof typeof POST_COMMENTER_TYPE];
 
 export interface TPostComment {
+  commentUrn: string | null;
+  commentUrl: string | null;
   commenterUrl: string;
   commenterName: string;
   commenterHeadline: string;

src/types/errors.ts

@@ -22,6 +22,8 @@ import { TOperationName } from '../core';
  * - postNotFound (fetchPost, reactToPost, commentOnPost)
  * - jobNotFound (fetchJob)
  * - commentingNotAllowed (commentOnPost)
+ * - commentNotFound (openComment, reactToComment, replyToComment)
+ * - replyingNotAllowed (replyToComment)
  * - noPostingPermission (createPost, reactToPost, commentOnPost)
  * - noSalesNavigator (nvSendMessage, nvSyncConversation, nvSyncInbox, nvSearchCompanies, nvSearchPeople, nvFetchCompany, nvFetchPerson, nvManageConversation)
  * - conversationsNotSynced (pollConversations)
@@ -45,6 +47,8 @@ export const LINKED_API_ACTION_ERROR = {
   postNotFound: 'postNotFound',
   jobNotFound: 'jobNotFound',
   commentingNotAllowed: 'commentingNotAllowed',
+  commentNotFound: 'commentNotFound',
+  replyingNotAllowed: 'replyingNotAllowed',
   noPostingPermission: 'noPostingPermission',
   noSalesNavigator: 'noSalesNavigator',
   conversationsNotSynced: 'conversationsNotSynced',