add mentions & st.createRepost action

Author: LordOfTheVillage

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/node",
-  "version": "2.3.12",
+  "version": "2.3.13",
   "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",
@@ -59,4 +59,4 @@
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0"
   }
-}
+}

src/core/operation.ts

@@ -43,6 +43,7 @@ export const OPERATION_NAME = {
   reactToComment: 'reactToComment',
   replyToComment: 'replyToComment',
   createPost: 'createPost',
+  createRepost: 'createRepost',
   retrieveFeed: 'retrieveFeed',
   retrieveSSI: 'retrieveSSI',
   retrievePerformance: 'retrievePerformance',

src/index.ts

@@ -6,6 +6,7 @@ import {
   CheckConnectionStatus,
   CommentOnPost,
   CreatePost,
+  CreateRepost,
   CustomWorkflow,
   FetchCompany,
   FetchJob,
@@ -135,6 +136,7 @@ class LinkedApi {
     this.reactToComment = new ReactToComment(this.httpClient);
     this.replyToComment = new ReplyToComment(this.httpClient);
     this.createPost = new CreatePost(this.httpClient);
+    this.createRepost = new CreateRepost(this.httpClient);
     this.retrieveFeed = new RetrieveFeed(this.httpClient);
     this.retrieveSSI = new RetrieveSSI(this.httpClient);
     this.retrievePerformance = new RetrievePerformance(this.httpClient);
@@ -177,6 +179,7 @@ class LinkedApi {
       this.reactToComment,
       this.replyToComment,
       this.createPost,
+      this.createRepost,
       this.retrieveFeed,
       this.retrieveSSI,
       this.retrievePerformance,
@@ -1465,12 +1468,16 @@ class LinkedApi {
   /**
    * Create a LinkedIn post on your personal profile or a company page.
    *
-   * This method creates a new post on LinkedIn. Posts can include text (up to 3,000 characters)
-   * and optional media attachments (images, videos, or documents). For company posts, you must
-   * have admin access to the company page.
+   * This method creates a new post on LinkedIn. Posts can include text (up to 3,000 characters),
+   * mentions of people and companies, and optional media attachments (images, videos, or
+   * documents). For company posts, you must have admin access to the company page.
    *
-   * @param params - Parameters including post text, optional attachments, and optional company URL
-   * @returns Promise resolving to an object containing the created post URL
+   * Each mention binds a `@[key]` placeholder in the text to one entity. `name` is required even
+   * when an identifier is given, because LinkedIn resolves a mention through its own name
+   * suggestions; the identifier only decides which of the offered namesakes is taken.
+   *
+   * @param params - Parameters including post text, optional mentions, attachments, and company URL
+   * @returns Promise resolving to the created post's URL and URN
    *
    * @see {@link https://linkedapi.io/docs/action-st-create-post/ st.createPost Action Documentation}
    *
@@ -1519,6 +1526,50 @@ class LinkedApi {
    */
   public createPost: CreatePost;
 
+  /**
+   * Repost a LinkedIn post, either as is or with your own commentary.
+   *
+   * Without `text` the post is reposted as is. With `text` your commentary (up to 3,000 characters,
+   * with optional mentions) is published above it. The post is addressed by `postUrl` or `postUrn`;
+   * provide one of the two.
+   *
+   * The returned identifiers belong to the repost itself, which is a post of your own account, not
+   * to the post that was reshared. Reposting the same post twice from the same account fails with
+   * `alreadyReposted`.
+   *
+   * @param params - Parameters including the post target and optional commentary with mentions
+   * @returns Promise resolving to the repost's own URL and URN
+   *
+   * @see {@link https://linkedapi.io/docs/action-st-create-repost/ st.createRepost Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * // Repost as is
+   * const workflow = await linkedapi.createRepost.execute({
+   *   postUrl: "https://www.linkedin.com/posts/username_activity-id"
+   * });
+   *
+   * const result = await linkedapi.createRepost.result(workflow.workflowId);
+   * console.log("Repost created:", result.data?.postUrl);
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Repost with commentary, addressing the post by URN
+   * const workflow = await linkedapi.createRepost.execute({
+   *   postUrn: "urn:li:activity:1234567890123456789",
+   *   text: "Worth reading, especially the part on onboarding by @[author]!",
+   *   mentions: [
+   *     { key: "author", name: "Example Person", urn: "urn:li:member:123456789" }
+   *   ]
+   * });
+   *
+   * const result = await linkedapi.createRepost.result(workflow.workflowId);
+   * console.log("Repost created:", result.data?.postUrn);
+   * ```
+   */
+  public createRepost: CreateRepost;
+
   /**
    * Retrieve your LinkedIn Social Selling Index (SSI) score.
    *

src/operations/create-repost.ts

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

src/operations/index.ts

@@ -35,6 +35,7 @@ export * from './comment-on-post';
 export * from './react-to-comment';
 export * from './reply-to-comment';
 export * from './create-post';
+export * from './create-repost';
 export * from './retrieve-feed';
 export * from './retrieve-ssi';
 export * from './retrieve-performance';

src/types/actions/post.ts

@@ -94,14 +94,21 @@ export interface TComment {
   reactionsCount: number;
 }
 
-export interface TReactToPostParams extends TBaseActionParams {
-  postUrl: string;
+/**
+ * A post is addressed by its URL or by its URN. Provide one of the two; when both are given, they
+ * must refer to the same post.
+ */
+export interface TPostTargetParams {
+  postUrl?: string;
+  postUrn?: string;
+}
+
+export interface TReactToPostParams extends TBaseActionParams, TPostTargetParams {
   type: TReactionType;
   companyUrl?: string;
 }
 
-export interface TCommentOnPostParams extends TBaseActionParams {
-  postUrl: string;
+export interface TCommentOnPostParams extends TBaseActionParams, TPostTargetParams {
   text: string;
   companyUrl?: string;
 }
@@ -174,8 +181,7 @@ export interface TPostCommentsRetrievalConfig extends TLimitParams {
 
 export type TPostReactionsRetrievalConfig = TLimitParams;
 
-export interface TBaseFetchPostParams extends TBaseActionParams {
-  postUrl: string;
+export interface TBaseFetchPostParams extends TBaseActionParams, TPostTargetParams {
   retrieveComments?: boolean;
   retrieveReactions?: boolean;
 }
@@ -209,12 +215,41 @@ export interface TCreatePostAttachment {
   name?: string;
 }
 
+/**
+ * One person or company to mention in a post, bound to a `@[key]` placeholder in the text.
+ *
+ * `name` is what gets typed into LinkedIn's composer, which accepts no other input; the optional
+ * identifier only decides which of the offered namesakes is taken. Provide at most one of `urn`,
+ * `personHashedUrl` and `companyHashedUrl`.
+ */
+export interface TPostMention {
+  key: string;
+  name: string;
+  urn?: string;
+  personHashedUrl?: string;
+  companyHashedUrl?: string;
+}
+
+/** Identifiers of a post this account has just published. */
+export interface TPublishedPostResult {
+  postUrl: string | null;
+  postUrn: string | null;
+}
+
 export interface TCreatePostParams extends TBaseActionParams {
   text: string;
+  mentions?: ReadonlyArray<TPostMention>;
   attachments?: ReadonlyArray<TCreatePostAttachment>;
   companyUrl?: string;
 }
 
-export interface TCreatePostResult {
-  postUrl: string;
+export type TCreatePostResult = TPublishedPostResult;
+
+/** Without `text` the post is reposted as is; with `text` the commentary is published above it. */
+export interface TCreateRepostParams extends TBaseActionParams, TPostTargetParams {
+  text?: string;
+  mentions?: ReadonlyArray<TPostMention>;
 }
+
+/** The repost is a post of this account's own, so these identify it rather than the post reshared. */
+export type TCreateRepostResult = TPublishedPostResult;

src/types/errors.ts

@@ -21,12 +21,15 @@ import { TOperationName } from '../core';
  * - searchInterfaceMismatch (searchJobs)
  * - filterIdentityMismatch (searchPosts)
  * - companyNotFound (fetchCompany, nvFetchCompany)
- * - postNotFound (fetchPost, reactToPost, commentOnPost)
+ * - postNotFound (fetchPost, reactToPost, commentOnPost, createRepost)
  * - jobNotFound (fetchJob)
  * - commentingNotAllowed (commentOnPost)
  * - commentNotFound (openComment, reactToComment, replyToComment)
  * - replyingNotAllowed (replyToComment)
  * - noPostingPermission (createPost, reactToPost, commentOnPost)
+ * - mentionNotResolved (createPost, createRepost)
+ * - repostNotAllowed (createRepost)
+ * - alreadyReposted (createRepost)
  * - noSalesNavigator (nvSendMessage, nvSyncConversation, nvSyncInbox, nvSearchCompanies, nvSearchPeople, nvFetchCompany, nvFetchPerson, nvManageConversation)
  * - conversationsNotSynced (pollConversations)
  * - threadNotFound (manageConversation, nvManageConversation)
@@ -54,6 +57,9 @@ export const LINKED_API_ACTION_ERROR = {
   commentNotFound: 'commentNotFound',
   replyingNotAllowed: 'replyingNotAllowed',
   noPostingPermission: 'noPostingPermission',
+  mentionNotResolved: 'mentionNotResolved',
+  repostNotAllowed: 'repostNotAllowed',
+  alreadyReposted: 'alreadyReposted',
   noSalesNavigator: 'noSalesNavigator',
   conversationsNotSynced: 'conversationsNotSynced',
   threadNotFound: 'threadNotFound',