Merge pull request #8 from Upload-Post/staging

Release Staging to Production

Author: victorcavero14

README.md

@@ -238,7 +238,8 @@ const boards = await client.getPinterestBoards('my-profile');
 ### Facebook
 - `facebookPageId` - Facebook Page ID (required)
 - `facebookVideoState` - PUBLISHED, DRAFT
-- `facebookMediaType` - REELS, STORIES
+- `facebookMediaType` - REELS, STORIES, VIDEO (VIDEO for normal page videos with no 9:16 restriction)
+- `thumbnailUrl` - URL for custom video thumbnail (only when facebookMediaType is VIDEO)
 - `facebookLinkUrl` - URL for text posts
 
 ### Pinterest
@@ -261,9 +262,11 @@ const boards = await client.getPinterestBoards('my-profile');
 - `xShareWithFollowers` - Share community post with followers
 - `xCardUri` - Card URI for Twitter Cards
 - `xLongTextAsPost` - Post long text as single post
+- `xThreadImageLayout` - Comma-separated image layout for thread (e.g. "4,4" or "2,3,1")
 
 ### Threads
 - `threadsLongTextAsPost` - Post long text as single post (vs thread)
+- `threadsThreadMediaLayout` - Comma-separated list of how many media items to include in each Threads post. Each value must be 1-10, and the total must equal the number of files. Example: '5,5' splits 10 items into 2 posts with 5 each. If omitted and more than 10 items are provided, auto-chunks into groups of 10.
 
 ### Reddit
 - `redditSubreddit` - Subreddit name (without r/)

index.d.ts

@@ -35,7 +35,7 @@ declare module 'upload-post' {
   export type FacebookVideoState = 'PUBLISHED' | 'DRAFT';
 
   /** Facebook media type */
-  export type FacebookMediaType = 'REELS' | 'STORIES';
+  export type FacebookMediaType = 'REELS' | 'STORIES' | 'VIDEO';
 
   /** X (Twitter) reply settings */
   export type XReplySettings = 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
@@ -210,6 +210,8 @@ declare module 'upload-post' {
     facebookVideoState?: FacebookVideoState;
     /** Media type */
     facebookMediaType?: FacebookMediaType;
+    /** Thumbnail URL for normal page videos (only when facebookMediaType is 'VIDEO') */
+    thumbnailUrl?: string;
   }
 
   export interface FacebookPhotoOptions {
@@ -276,6 +278,8 @@ declare module 'upload-post' {
     xTaggedUserIds?: string | string[];
     /** Location place ID */
     xPlaceId?: string;
+    /** Comma-separated image layout for thread (e.g. "4,4" or "2,3,1"). Each value 1-4, total must equal image count. */
+    xThreadImageLayout?: string;
   }
 
   export interface XTextOptions extends XBaseOptions {
@@ -298,6 +302,8 @@ declare module 'upload-post' {
   export interface ThreadsOptions {
     /** Post long text as single post (vs thread) */
     threadsLongTextAsPost?: boolean;
+    /** Comma-separated list of how many media items per Threads post (e.g. "5,5"). Each value 1-10, total must equal file count. */
+    threadsThreadMediaLayout?: string;
   }
 
   // ==================== Reddit Options ====================

index.js

@@ -190,6 +190,7 @@ export class UploadPost {
     if (isVideo) {
       if (options.facebookVideoState) form.append('video_state', options.facebookVideoState);
       if (options.facebookMediaType) form.append('facebook_media_type', options.facebookMediaType);
+      if (options.thumbnailUrl) form.append('thumbnail_url', options.thumbnailUrl);
     }
 
     if (isText && options.facebookLinkUrl) {
@@ -235,6 +236,7 @@ export class UploadPost {
         ids.forEach(id => form.append('tagged_user_ids[]', id));
       }
       if (options.xPlaceId) form.append('place_id', options.xPlaceId);
+      if (options.xThreadImageLayout) form.append('x_thread_image_layout', options.xThreadImageLayout);
     } else {
       if (options.xPostUrl) form.append('post_url', options.xPostUrl);
       if (options.xCardUri) form.append('card_uri', options.xCardUri);
@@ -255,6 +257,7 @@ export class UploadPost {
    */
   _addThreadsParams(form, options) {
     if (options.threadsLongTextAsPost !== undefined) form.append('threads_long_text_as_post', String(options.threadsLongTextAsPost));
+    if (options.threadsThreadMediaLayout) form.append('threads_thread_media_layout', options.threadsThreadMediaLayout);
   }
 
   /**
@@ -326,8 +329,9 @@ export class UploadPost {
    * Facebook options:
    * @param {string} [options.facebookPageId] - Facebook Page ID
    * @param {string} [options.facebookVideoState] - PUBLISHED or DRAFT
-   * @param {string} [options.facebookMediaType] - REELS or STORIES
-   * 
+   * @param {string} [options.facebookMediaType] - REELS, STORIES, or VIDEO
+   * @param {string} [options.thumbnailUrl] - Thumbnail URL for normal page videos (VIDEO type only)
+   *
    * Pinterest options:
    * @param {string} [options.pinterestBoardId] - Board ID
    * @param {string} [options.pinterestLink] - Destination link
@@ -347,7 +351,8 @@ export class UploadPost {
    * 
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post (vs thread)
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   *
    * @returns {Promise<Object>} API response with request_id for async uploads
    */
   async upload(videoPathOrUrl, options) {
@@ -424,14 +429,15 @@ export class UploadPost {
    * @param {boolean} [options.xNullcast] - Promoted-only post
    * @param {string|string[]} [options.xTaggedUserIds] - User IDs to tag
    * @param {boolean} [options.xLongTextAsPost] - Post long text as single post
-   * 
+   *
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   *
    * Reddit options:
    * @param {string} [options.redditSubreddit] - Subreddit name (without r/)
    * @param {string} [options.redditFlairId] - Flair template ID
-   * 
+   *
    * @returns {Promise<Object>} API response
    */
   async uploadPhotos(photosPathsOrUrls, options) {
@@ -493,14 +499,15 @@ export class UploadPost {
    * @param {string} [options.xPollReplySettings] - Who can reply to poll
    * @param {string} [options.xCardUri] - Card URI for Twitter Cards
    * @param {boolean} [options.xLongTextAsPost] - Post long text as single post
-   * 
+   *
    * Threads options:
    * @param {boolean} [options.threadsLongTextAsPost] - Post long text as single post
-   * 
+   * @param {string} [options.threadsThreadMediaLayout] - Comma-separated list of how many media items per Threads post (e.g. "5,5")
+   *
    * Reddit options:
    * @param {string} [options.redditSubreddit] - Subreddit name (without r/)
    * @param {string} [options.redditFlairId] - Flair template ID
-   * 
+   *
    * @returns {Promise<Object>} API response
    */
   async uploadText(options) {

package.json

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