upload-post 2.1.0 → 2.1.2

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/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 */
@@ -648,6 +648,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);
     }
@@ -326,7 +335,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 +719,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
    *
@@ -826,6 +851,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.1.2",
   "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",