upload-post 2.0.3 → 2.0.4

package/.github/workflows/publish.yml

@@ -3,6 +3,9 @@ name: Publish to npm
 on:
   release:
     types: [published]
+  push:
+    branches: [main]
+    paths: ['package.json']
   workflow_dispatch:
     inputs:
       dry_run:
@@ -16,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: read
-      id-token: write  # Required for OIDC trusted publishing
+      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -27,13 +30,32 @@ jobs:
           node-version: '22'
           registry-url: 'https://registry.npmjs.org'
 
+      - name: Check if version is new
+        id: version_check
+        run: |
+          LOCAL=$(node -p "require('./package.json').version")
+          PKG_NAME=$(node -p "require('./package.json').name")
+          REMOTE=$(npm view "$PKG_NAME" version 2>/dev/null || echo "0.0.0")
+          echo "local=$LOCAL" >> $GITHUB_OUTPUT
+          echo "remote=$REMOTE" >> $GITHUB_OUTPUT
+          if [ "$LOCAL" = "$REMOTE" ]; then
+            echo "new=false" >> $GITHUB_OUTPUT
+            echo "⏭️ Version $LOCAL already published, skipping."
+          else
+            echo "new=true" >> $GITHUB_OUTPUT
+            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
 
       - name: Build (if needed)
+        if: steps.version_check.outputs.new == 'true' || github.event_name == 'workflow_dispatch'
         run: npm run build --if-present
 
       - name: Publish to npm (dry-run)
@@ -41,5 +63,5 @@ jobs:
         run: npm publish --access public --dry-run
 
       - name: Publish to npm
-        if: ${{ inputs.dry_run != true }}
+        if: (steps.version_check.outputs.new == 'true' && inputs.dry_run != true) || github.event_name == 'release'
         run: npm publish --access public --provenance

package/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/)

package/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 ====================
@@ -555,6 +561,10 @@ declare module 'upload-post' {
       logoImage?: string;
       redirectButtonText?: string;
       platforms?: string[];
+      showCalendar?: boolean;
+      readonlyCalendar?: boolean;
+      connectTitle?: string;
+      connectDescription?: string;
     }): Promise<JwtResponse>;
 
     /**

package/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) {
@@ -685,6 +692,10 @@ export class UploadPost {
    * @param {string} [options.logoImage] - Logo image URL for the linking page
    * @param {string} [options.redirectButtonText] - Text for redirect button
    * @param {string[]} [options.platforms] - Platforms to show for connection
+   * @param {boolean} [options.showCalendar] - Whether to show the calendar view
+   * @param {boolean} [options.readonlyCalendar] - Show only a read-only calendar (no editing, no account connection)
+   * @param {string} [options.connectTitle] - Custom title for the connection page
+   * @param {string} [options.connectDescription] - Custom description for the connection page
    * @returns {Promise<Object>} JWT and connection URL
    */
   async generateJwt(username, options = {}) {
@@ -693,6 +704,10 @@ export class UploadPost {
     if (options.logoImage) body.logo_image = options.logoImage;
     if (options.redirectButtonText) body.redirect_button_text = options.redirectButtonText;
     if (options.platforms && options.platforms.length > 0) body.platforms = options.platforms;
+    if (options.showCalendar !== undefined) body.show_calendar = options.showCalendar;
+    if (options.readonlyCalendar !== undefined) body.readonly_calendar = options.readonlyCalendar;
+    if (options.connectTitle) body.connect_title = options.connectTitle;
+    if (options.connectDescription) body.connect_description = options.connectDescription;
     return this._request('/uploadposts/users/generate-jwt', 'POST', body);
   }
 

package/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",