upload-post 2.5.0 → 2.7.0

package/index.d.ts

@@ -2,13 +2,13 @@ declare module 'upload-post' {
   // ==================== Common Types ====================
 
   /** Supported platforms for video upload */
-  export type VideoPlatform = 'tiktok' | 'instagram' | 'youtube' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x' | 'google_business' | 'discord' | 'telegram';
+  export type VideoPlatform = 'tiktok' | 'instagram' | 'youtube' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x' | 'google_business' | 'discord' | 'telegram' | 'mastodon' | 'wordpress';
 
   /** Supported platforms for photo upload */
-  export type PhotoPlatform = 'tiktok' | 'instagram' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x' | 'google_business' | 'discord' | 'telegram';
+  export type PhotoPlatform = 'tiktok' | 'instagram' | 'linkedin' | 'facebook' | 'pinterest' | 'threads' | 'reddit' | 'bluesky' | 'x' | 'google_business' | 'discord' | 'telegram' | 'mastodon' | 'lemmy' | 'wordpress';
 
   /** Supported platforms for text upload */
-  export type TextPlatform = 'x' | 'linkedin' | 'facebook' | 'threads' | 'reddit' | 'bluesky' | 'google_business' | 'discord' | 'telegram';
+  export type TextPlatform = 'x' | 'linkedin' | 'facebook' | 'threads' | 'reddit' | 'bluesky' | 'google_business' | 'discord' | 'telegram' | 'slack' | 'mastodon' | 'nostr' | 'lemmy' | 'devto' | 'hashnode' | 'wordpress' | 'whop' | 'listmonk';
 
   /** TikTok privacy levels */
   export type TikTokPrivacyLevel = 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
@@ -87,6 +87,15 @@ declare module 'upload-post' {
     youtubeTitle?: string;
     pinterestTitle?: string;
     threadsTitle?: string;
+    slackTitle?: string;
+    mastodonTitle?: string;
+    nostrTitle?: string;
+    lemmyTitle?: string;
+    devtoTitle?: string;
+    hashnodeTitle?: string;
+    wordpressTitle?: string;
+    whopTitle?: string;
+    listmonkTitle?: string;
 
     // Platform-specific description overrides
     description?: string;
@@ -773,7 +782,27 @@ declare module 'upload-post' {
     // Instagram Comments
 
     /**
-     * Get comments on an Instagram post
+     * Get comments on a post
+     * @param options - Query options
+     */
+    getPostComments(options: {
+      user: string;
+      platform?: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      postId?: string;
+      postUrl?: string;
+      limit?: number;
+      after?: string;
+    }): Promise<{
+      success: boolean;
+      comments?: Array<{
+        id: string;
+        text: string;
+        timestamp: string;
+        user: { id: string; username: string };
+      }>;
+    }>;
+    /**
+     * Get comments on an Instagram post (legacy positional signature)
      * @param user - Profile username
      * @param options - Query options
      */
@@ -791,7 +820,7 @@ declare module 'upload-post' {
      * Send a private reply (DM) to the author of an Instagram comment
      * @param options - Reply options
      */
-    replyToComment(options: { user: string; commentId: string; message: string }): Promise<{
+    replyToComment(options: { user: string; commentId: string; message: string; buttons?: Array<{ title: string; url: string }> }): Promise<{
       success: boolean;
       recipient_id?: string;
       message_id?: string;
@@ -810,6 +839,68 @@ declare module 'upload-post' {
       error?: string;
     }>;
 
+    /**
+     * Create a comment on a post, or reply to an existing comment.
+     * One of postId, postUrl, or commentId is required.
+     * @param options - Comment options
+     */
+    createComment(options: {
+      user: string;
+      platform: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      message: string;
+      postId?: string;
+      postUrl?: string;
+      commentId?: string;
+    }): Promise<{
+      success: boolean;
+      id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
+    /**
+     * Delete a comment on a post
+     * @param options - Delete options
+     */
+    deleteComment(options: {
+      user: string;
+      platform: 'instagram' | 'facebook' | 'youtube' | 'linkedin';
+      commentId: string;
+      /** Post identifier (the post URN for LinkedIn) */
+      postId?: string;
+    }): Promise<{
+      success: boolean;
+      message?: string;
+      error?: string;
+    }>;
+
+    // Post Management
+    /**
+     * Retry a failed post. Provide requestId or jobId.
+     * @param options - Retry options
+     */
+    retryPost(options: { requestId?: string; jobId?: string }): Promise<{
+      success: boolean;
+      request_id?: string;
+      job_id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
+    /**
+     * Unpublish (delete) a post from the platform
+     * @param options - Unpublish options
+     */
+    unpublishPost(options: {
+      user: string;
+      platform: 'facebook' | 'youtube' | 'x' | 'linkedin' | 'threads';
+      postId: string;
+    }): Promise<{
+      success: boolean;
+      message?: string;
+      error?: string;
+    }>;
+
     // Helper Endpoints
     /**
      * Get Facebook pages for a profile

package/index.js

@@ -104,6 +104,16 @@ export class UploadPost {
     if (options.youtubeTitle) form.append('youtube_title', options.youtubeTitle);
     if (options.pinterestTitle) form.append('pinterest_title', options.pinterestTitle);
     if (options.threadsTitle) form.append('threads_title', options.threadsTitle);
+    // New credential-based platforms
+    if (options.slackTitle) form.append('slack_title', options.slackTitle);
+    if (options.mastodonTitle) form.append('mastodon_title', options.mastodonTitle);
+    if (options.nostrTitle) form.append('nostr_title', options.nostrTitle);
+    if (options.lemmyTitle) form.append('lemmy_title', options.lemmyTitle);
+    if (options.devtoTitle) form.append('devto_title', options.devtoTitle);
+    if (options.hashnodeTitle) form.append('hashnode_title', options.hashnodeTitle);
+    if (options.wordpressTitle) form.append('wordpress_title', options.wordpressTitle);
+    if (options.whopTitle) form.append('whop_title', options.whopTitle);
+    if (options.listmonkTitle) form.append('listmonk_title', options.listmonkTitle);
 
     // Platform-specific description overrides
     if (options.description) form.append('description', options.description);
@@ -739,7 +749,7 @@ export class UploadPost {
    * @param {Object} [options] - Query options
    * @param {string[]} [options.platforms] - Filter by platforms (instagram, linkedin, facebook, x, youtube, tiktok, threads, pinterest, reddit)
    * @param {string} [options.pageId] - Facebook Page ID (required for Facebook analytics)
-   * @param {string} [options.pageUrn] - LinkedIn page URN (defaults to "me" for personal profile)
+   * @param {string} [options.pageUrn] - LinkedIn organization/company page URN or numeric ID. LinkedIn analytics are only available for pages you administer; personal profiles are not supported (LinkedIn exposes no member-level analytics). Defaults to the first administered organization page.
    * @returns {Promise<Object>} Analytics data per platform
    */
   async getAnalytics(profileUsername, options = {}) {
@@ -1013,18 +1023,27 @@ export class UploadPost {
   // ==================== Instagram Comments ====================
 
   /**
-   * Get comments on an Instagram post
+   * Get comments on a post
    *
-   * @param {string} user - Profile username
    * @param {Object} options - Query options
-   * @param {string} [options.postId] - Numeric media ID (provide postId or postUrl)
-   * @param {string} [options.postUrl] - Full Instagram post URL (provide postId or postUrl)
+   * @param {string} options.user - Profile username
+   * @param {string} [options.platform='instagram'] - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} [options.postId] - Native post/media ID (provide postId or postUrl)
+   * @param {string} [options.postUrl] - Full post URL (provide postId or postUrl)
+   * @param {number} [options.limit] - Max number of comments to return
+   * @param {string} [options.after] - Pagination cursor for the next page
    * @returns {Promise<Object>} Comments data
    */
-  async getPostComments(user, options = {}) {
-    const params = { platform: 'instagram', user };
+  async getPostComments(options = {}) {
+    // Backwards compatibility: getPostComments(user, { postId, postUrl })
+    if (typeof options === 'string') {
+      options = { user: options, ...(arguments[1] || {}) };
+    }
+    const params = { platform: options.platform || 'instagram', user: options.user };
     if (options.postId) params.post_id = options.postId;
     if (options.postUrl) params.post_url = options.postUrl;
+    if (options.limit !== undefined) params.limit = options.limit;
+    if (options.after) params.after = options.after;
     return this._request('/uploadposts/comments', 'GET', params);
   }
 
@@ -1035,15 +1054,19 @@ export class UploadPost {
    * @param {string} options.user - Profile username
    * @param {string} options.commentId - Comment ID from getPostComments
    * @param {string} options.message - Reply message text
+   * @param {Array<{title: string, url: string}>} [options.buttons] - Optional web_url
+   *   buttons (max 3) rendered in the Instagram DM. Each item is `{ title, url }`.
    * @returns {Promise<Object>} Reply result
    */
   async replyToComment(options) {
-    return this._request('/uploadposts/comments/reply', 'POST', {
+    const body = {
       platform: 'instagram',
       user: options.user,
       comment_id: options.commentId,
       message: options.message
-    });
+    };
+    if (options.buttons) body.buttons = options.buttons;
+    return this._request('/uploadposts/comments/reply', 'POST', body);
   }
 
   /**
@@ -1064,6 +1087,90 @@ export class UploadPost {
     });
   }
 
+  /**
+   * Create a comment on a post, or reply to an existing comment
+   *
+   * One of postId, postUrl, or commentId is required. Pass commentId to reply
+   * to an existing comment; pass postId/postUrl to comment on the post itself.
+   *
+   * @param {Object} options - Comment options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} options.message - Comment text
+   * @param {string} [options.postId] - Native post/media ID to comment on
+   * @param {string} [options.postUrl] - Full post URL to comment on
+   * @param {string} [options.commentId] - Existing comment ID to reply to
+   * @returns {Promise<Object>} Created comment result
+   */
+  async createComment(options) {
+    const body = {
+      platform: options.platform,
+      user: options.user,
+      message: options.message
+    };
+    if (options.commentId) body.comment_id = options.commentId;
+    if (options.postId) body.post_id = options.postId;
+    if (options.postUrl) body.post_url = options.postUrl;
+    return this._request('/uploadposts/comments/create', 'POST', body);
+  }
+
+  /**
+   * Delete a comment on a post
+   *
+   * @param {Object} options - Delete options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (instagram, facebook, youtube, linkedin)
+   * @param {string} options.commentId - Comment ID to delete
+   * @param {string} [options.postId] - Post identifier (the post URN for LinkedIn)
+   * @returns {Promise<Object>} Deletion result
+   */
+  async deleteComment(options) {
+    const body = {
+      platform: options.platform,
+      user: options.user,
+      comment_id: options.commentId
+    };
+    if (options.postId) body.post_id = options.postId;
+    return this._request('/uploadposts/comments/delete', 'DELETE', body);
+  }
+
+  // ==================== Post Management ====================
+
+  /**
+   * Retry a failed post
+   *
+   * Provide the request_id (from an async upload) or the job_id (from a
+   * scheduled/queued upload).
+   *
+   * @param {Object} options - Retry options
+   * @param {string} [options.requestId] - The request_id of the post to retry
+   * @param {string} [options.jobId] - The job_id of the post to retry
+   * @returns {Promise<Object>} Retry result
+   */
+  async retryPost(options = {}) {
+    const body = {};
+    if (options.requestId) body.request_id = options.requestId;
+    if (options.jobId) body.job_id = options.jobId;
+    return this._request('/uploadposts/posts/retry', 'POST', body);
+  }
+
+  /**
+   * Unpublish (delete) a post from the platform
+   *
+   * @param {Object} options - Unpublish options
+   * @param {string} options.user - Profile username
+   * @param {string} options.platform - Platform (facebook, youtube, x, linkedin, threads)
+   * @param {string} options.postId - Native post ID to unpublish
+   * @returns {Promise<Object>} Unpublish result
+   */
+  async unpublishPost(options) {
+    return this._request('/uploadposts/posts/unpublish', 'POST', {
+      platform: options.platform,
+      user: options.user,
+      post_id: options.postId
+    });
+  }
+
   // ==================== Helper Endpoints ====================
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Official client library for Upload-Post API - Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)",
   "main": "index.js",
   "types": "index.d.ts",