upload-post 2.1.0 → 2.2.0

package/.github/workflows/publish.yml

@@ -46,10 +46,6 @@ jobs:
             echo "🚀 New version detected: $REMOTE → $LOCAL"
           fi
 
-      - name: Update npm to latest
-        if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
-        run: npm install -g npm@latest && npm --version
-
       - name: Install dependencies
         if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
         run: npm ci
@@ -61,7 +57,11 @@ jobs:
       - name: Publish to npm (dry-run)
         if: ${{ inputs.dry_run == true }}
         run: npm publish --access public --dry-run
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Publish to npm
         if: (steps.version_check.outputs.new == 'true' && inputs.dry_run != true) || github.event_name == 'release'
-        run: npm publish --access public --provenance
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -181,6 +181,22 @@ const analytics = await client.getAnalytics('my-profile', {
 console.log(analytics);
 ```
 
+### Get Media
+
+Retrieve recent posts from a connected social account. Supported platforms:
+`instagram`, `tiktok`, `youtube`, `linkedin`, `facebook`, `x`, `threads`,
+`pinterest`, `bluesky`, `reddit`.
+
+```javascript
+const { media } = await client.getMedia('linkedin', 'my-profile');
+
+// Force the personal LinkedIn profile of an account connected as an org admin:
+await client.getMedia('linkedin', 'my-profile', { pageUrn: 'me' });
+
+// Target a specific LinkedIn organization page:
+await client.getMedia('linkedin', 'my-profile', { pageUrn: '12345' });
+```
+
 ### Helper Methods
 
 ```javascript

package/index.d.ts

@@ -136,8 +136,8 @@ declare module 'upload-post' {
     instagramShareToFeed?: boolean;
     /** Comma-separated collaborator usernames */
     instagramCollaborators?: string;
-    /** Custom cover URL */
-    instagramCoverUrl?: string;
+    /** Custom cover: URL string, file path, Buffer, or ReadableStream */
+    instagramCoverUrl?: string | Buffer | NodeJS.ReadableStream;
     /** Audio track name */
     instagramAudioName?: string;
     /** Comma-separated user tags */
@@ -192,6 +192,17 @@ declare module 'upload-post' {
     youtubeHasPaidProductPlacement?: boolean;
     /** Recording date (ISO 8601) */
     youtubeRecordingDate?: string;
+    /** Subtitle/caption files to upload. Each entry needs a language code and either a file path or URL. */
+    youtubeSubtitles?: Array<{
+      /** BCP-47 language code (e.g. "en", "es") */
+      language: string;
+      /** Display name for the subtitle track (e.g. "English", "Español") */
+      name?: string;
+      /** Path to the subtitle file (SRT, VTT, SBV, SUB, ASS, SSA, TTML) */
+      file?: string;
+      /** URL to the subtitle file */
+      url?: string;
+    }>;
   }
 
   // ==================== LinkedIn Options ====================
@@ -589,6 +600,28 @@ declare module 'upload-post' {
       metric_labels: Record<string, string>;
     }>>;
 
+    /**
+     * Get recent media from a connected social account.
+     *
+     * @param options.pageUrn - LinkedIn only. Numeric org ID, full org URN, or "me" to force the personal profile.
+     */
+    getMedia(
+      platform: 'instagram' | 'tiktok' | 'youtube' | 'linkedin' | 'facebook' | 'x' | 'threads' | 'pinterest' | 'bluesky' | 'reddit' | string,
+      user: string,
+      options?: { pageUrn?: string }
+    ): Promise<{
+      success: boolean;
+      media: Array<{
+        id: string;
+        caption: string | null;
+        media_type: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'TEXT' | string;
+        media_url: string | null;
+        permalink: string | null;
+        timestamp: string | null;
+        thumbnail_url: string | null;
+      }>;
+    }>;
+
     // Scheduled Posts
     /**
      * List scheduled posts
@@ -648,6 +681,68 @@ declare module 'upload-post' {
      */
     validateJwt(jwt: string): Promise<{ success: boolean; valid?: boolean }>;
 
+    /**
+     * Get user preferences (including calendar settings)
+     */
+    getUserPreferences(): Promise<{ success: boolean; preferences?: { week_start_day?: number; [key: string]: any } }>;
+
+    /**
+     * Update user preferences (including calendar settings)
+     * @param options - Preferences options
+     */
+    updateUserPreferences(options?: { weekStartDay?: number }): Promise<{ success: boolean; preferences?: { week_start_day?: number; [key: string]: any } }>;
+
+    /**
+     * Get notification configuration (including webhook settings)
+     */
+    getNotificationConfig(): Promise<{ success: boolean; config?: { webhook_events?: string[]; webhook_url?: string; [key: string]: any } }>;
+
+    /**
+     * Update notification configuration (including webhook settings)
+     * @param options - Notification config options
+     */
+    updateNotificationConfig(options?: { webhookEvents?: string[]; webhookUrl?: string }): Promise<{ success: boolean; config?: { webhook_events?: string[]; webhook_url?: string; [key: string]: any } }>;
+
+    // Instagram Comments
+
+    /**
+     * Get comments on an Instagram post
+     * @param user - Profile username
+     * @param options - Query options
+     */
+    getPostComments(user: string, options?: { postId?: string; postUrl?: string }): Promise<{
+      success: boolean;
+      comments?: Array<{
+        id: string;
+        text: string;
+        timestamp: string;
+        user: { id: string; username: string };
+      }>;
+    }>;
+
+    /**
+     * 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<{
+      success: boolean;
+      recipient_id?: string;
+      message_id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
+    /**
+     * Post a public reply to an Instagram comment (visible under the original comment)
+     * @param options - Reply options
+     */
+    publicReplyToComment(options: { user: string; commentId: string; message: string }): Promise<{
+      success: boolean;
+      id?: string;
+      message?: string;
+      error?: string;
+    }>;
+
     // Helper Endpoints
     /**
      * Get Facebook pages for a profile

package/index.js

@@ -160,7 +160,16 @@ export class UploadPost {
 
     if (isVideo) {
       if (options.instagramShareToFeed !== undefined) form.append('share_to_feed', String(options.instagramShareToFeed));
-      if (options.instagramCoverUrl) form.append('cover_url', options.instagramCoverUrl);
+      if (options.instagramCoverUrl) {
+        const coverVal = options.instagramCoverUrl;
+        if (typeof coverVal === 'string' && (coverVal.toLowerCase().startsWith('http://') || coverVal.toLowerCase().startsWith('https://'))) {
+          form.append('cover_url', coverVal);
+        } else if (typeof coverVal === 'string') {
+          form.append('cover_image', createReadStream(coverVal));
+        } else {
+          form.append('cover_image', coverVal);
+        }
+      }
       if (options.instagramAudioName) form.append('audio_name', options.instagramAudioName);
       if (options.instagramThumbOffset) form.append('thumb_offset', options.instagramThumbOffset);
     }
@@ -189,6 +198,24 @@ export class UploadPost {
     if (options.youtubeBlockedCountries) form.append('blockedCountries', options.youtubeBlockedCountries);
     if (options.youtubeHasPaidProductPlacement !== undefined) form.append('hasPaidProductPlacement', String(options.youtubeHasPaidProductPlacement));
     if (options.youtubeRecordingDate) form.append('recordingDate', options.youtubeRecordingDate);
+    if (options.youtubeSubtitles && Array.isArray(options.youtubeSubtitles)) {
+      options.youtubeSubtitles.forEach((sub, idx) => {
+        if (sub.language) {
+          form.append(`youtube_subtitle_language_${idx}`, sub.language);
+          if (sub.name) form.append(`youtube_subtitle_name_${idx}`, sub.name);
+          if (sub.file) {
+            // file can be a string path or a ReadableStream
+            if (typeof sub.file === 'string') {
+              form.append(`youtube_subtitle_file_${idx}`, createReadStream(sub.file));
+            } else {
+              form.append(`youtube_subtitle_file_${idx}`, sub.file);
+            }
+          } else if (sub.url) {
+            form.append(`youtube_subtitle_file_${idx}`, sub.url);
+          }
+        }
+      });
+    }
   }
 
   /**
@@ -326,7 +353,7 @@ export class UploadPost {
    * @param {string} [options.instagramMediaType] - REELS or STORIES
    * @param {boolean} [options.instagramShareToFeed] - Share to feed
    * @param {string} [options.instagramCollaborators] - Comma-separated collaborator usernames
-   * @param {string} [options.instagramCoverUrl] - Custom cover URL
+   * @param {string|Buffer|ReadableStream} [options.instagramCoverUrl] - Custom cover: URL string, file path, Buffer, or ReadableStream
    * @param {string} [options.instagramAudioName] - Audio track name
    * @param {string} [options.instagramUserTags] - Comma-separated user tags
    * @param {string} [options.instagramLocationId] - Location ID
@@ -710,6 +737,22 @@ export class UploadPost {
     return this._request(`/uploadposts/post-analytics/${encodeURIComponent(requestId)}`, 'GET');
   }
 
+  /**
+   * Get analytics for any post (including organic posts) using its native platform ID
+   *
+   * @param {string} platformPostId - The native post ID on the platform (e.g., Instagram media ID)
+   * @param {string} platform - The platform to query (instagram, youtube, tiktok, facebook, linkedin, x, threads, pinterest, reddit)
+   * @param {string} user - The profile_username that owns the social account
+   * @returns {Promise<Object>} Post analytics with live per-post metrics from the platform API
+   */
+  async getPostAnalyticsByPlatformId(platformPostId, platform, user) {
+    return this._request('/uploadposts/post-analytics', 'GET', {
+      platform_post_id: platformPostId,
+      platform,
+      user,
+    });
+  }
+
   /**
    * Get available metrics configuration for all supported platforms
    *
@@ -719,6 +762,21 @@ export class UploadPost {
     return this._request('/uploadposts/platform-metrics', 'GET');
   }
 
+  /**
+   * Get recent media from a connected social account.
+   *
+   * @param {string} platform - instagram, tiktok, youtube, linkedin, facebook, x, threads, pinterest, bluesky, reddit
+   * @param {string} user - Profile username
+   * @param {Object} [options]
+   * @param {string} [options.pageUrn] - LinkedIn only. Numeric org ID, full URN, or "me" to force the personal profile.
+   * @returns {Promise<Object>}
+   */
+  async getMedia(platform, user, options = {}) {
+    const params = { platform, user };
+    if (options.pageUrn) params.page_urn = options.pageUrn;
+    return this._request('/uploadposts/media', 'GET', params);
+  }
+
   // ==================== Scheduled Posts ====================
 
   /**
@@ -826,6 +884,106 @@ export class UploadPost {
     return this._request('/uploadposts/users/validate-jwt', 'POST', { jwt });
   }
 
+  /**
+   * Get user preferences (including calendar settings)
+   *
+   * @returns {Promise<Object>} User preferences
+   */
+  async getUserPreferences() {
+    return this._request('/uploadposts/users/preferences', 'GET');
+  }
+
+  /**
+   * Update user preferences (including calendar settings)
+   *
+   * @param {Object} options - Preferences options
+   * @param {number} [options.weekStartDay] - Week start day (0=Sunday, 1=Monday)
+   * @returns {Promise<Object>} Updated preferences
+   */
+  async updateUserPreferences(options = {}) {
+    const body = {};
+    if (options.weekStartDay !== undefined) body.week_start_day = options.weekStartDay;
+    return this._request('/uploadposts/users/preferences', 'POST', body);
+  }
+
+  /**
+   * Get notification configuration (including webhook settings)
+   *
+   * @returns {Promise<Object>} Notification config
+   */
+  async getNotificationConfig() {
+    return this._request('/uploadposts/notification-config', 'GET');
+  }
+
+  /**
+   * Update notification configuration (including webhook settings)
+   *
+   * @param {Object} options - Notification config options
+   * @param {string[]} [options.webhookEvents] - Webhook event types to subscribe to (upload_completed, social_account_connected, social_account_disconnected, social_account_reauth_required)
+   * @param {string} [options.webhookUrl] - Webhook URL for notifications
+   * @returns {Promise<Object>} Updated notification config
+   */
+  async updateNotificationConfig(options = {}) {
+    const body = {};
+    if (options.webhookEvents) body.webhook_events = options.webhookEvents;
+    if (options.webhookUrl) body.webhook_url = options.webhookUrl;
+    return this._request('/uploadposts/notification-config', 'POST', body);
+  }
+
+  // ==================== Instagram Comments ====================
+
+  /**
+   * Get comments on an Instagram 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)
+   * @returns {Promise<Object>} Comments data
+   */
+  async getPostComments(user, options = {}) {
+    const params = { platform: 'instagram', user };
+    if (options.postId) params.post_id = options.postId;
+    if (options.postUrl) params.post_url = options.postUrl;
+    return this._request('/uploadposts/comments', 'GET', params);
+  }
+
+  /**
+   * Send a private reply (DM) to the author of an Instagram comment
+   *
+   * @param {Object} options - Reply options
+   * @param {string} options.user - Profile username
+   * @param {string} options.commentId - Comment ID from getPostComments
+   * @param {string} options.message - Reply message text
+   * @returns {Promise<Object>} Reply result
+   */
+  async replyToComment(options) {
+    return this._request('/uploadposts/comments/reply', 'POST', {
+      platform: 'instagram',
+      user: options.user,
+      comment_id: options.commentId,
+      message: options.message
+    });
+  }
+
+  /**
+   * Post a public reply to an Instagram comment (visible under the original comment)
+   *
+   * @param {Object} options - Reply options
+   * @param {string} options.user - Profile username
+   * @param {string} options.commentId - Comment ID from getPostComments
+   * @param {string} options.message - Reply message text
+   * @returns {Promise<Object>} Reply result with the new comment ID
+   */
+  async publicReplyToComment(options) {
+    return this._request('/uploadposts/comments/public-reply', 'POST', {
+      platform: 'instagram',
+      user: options.user,
+      comment_id: options.commentId,
+      message: options.message
+    });
+  }
+
   // ==================== Helper Endpoints ====================
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.1.0",
+  "version": "2.2.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",