upload-post 2.4.0 → 2.6.0

package/README.md

@@ -321,6 +321,38 @@ These options work across all upload methods:
 | `autogenerateLanguage` | Force the AI output language (ISO code); omit to auto-detect from the media |
 | `idempotencyKey` | Collapses duplicate uploads within 24h. Reuse the same value when retrying. Alias: `requestId` |
 
+## Google Business Profile
+
+Pass the target location on the upload itself. There is no separate "select a location" call — the API resolves the location per post.
+
+```javascript
+const { locations } = await client.getGoogleBusinessLocations('myprofile');
+
+await client.upload('video.mp4', {
+  user: 'myprofile',
+  platforms: ['google_business'],
+  title: 'Now open on Sundays',
+  gbpLocationId: locations[0].name,   // "accounts/123/locations/456"
+});
+```
+
+`gbpLocationId` is **required when the account has more than one location** — the API only auto-selects when exactly one exists. Beyond a standard post you can publish an event or an offer:
+
+```javascript
+await client.uploadText({
+  user: 'myprofile',
+  platforms: ['google_business'],
+  title: 'Summer sale',
+  gbpLocationId: locations[0].name,
+  gbpTopicType: 'OFFER',
+  gbpOfferCoupon: 'SUMMER25',
+  gbpOfferRedeemUrl: 'https://example.com/redeem',
+  gbpOfferTerms: 'One per customer',
+});
+```
+
+Also available: `gbpTopicType: 'EVENT'` with `gbpEventTitle` / `gbpEventStartDate` / `gbpEventStartTime` / `gbpEventEndDate` / `gbpEventEndTime`, a call-to-action via `gbpCtaType` + `gbpCtaUrl`, and `gbpMediaUrl` / `gbpMediaFormat`.
+
 ## Retrying an upload safely
 
 An upload that times out may still have been accepted by the API. Retrying it without an idempotency key publishes the post a second time.

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;
@@ -349,6 +358,37 @@ declare module 'upload-post' {
 
   // ==================== Combined Upload Options ====================
 
+  export interface GoogleBusinessOptions {
+    /** Google Business location id, e.g. "accounts/123/locations/456". Required when the account has more than one location; the API auto-selects only for single-location accounts. List them with getGoogleBusinessLocations(). */
+    gbpLocationId?: string;
+    /** Post type. Defaults to STANDARD. */
+    gbpTopicType?: 'STANDARD' | 'EVENT' | 'OFFER';
+    /** Media URL attached to the post */
+    gbpMediaUrl?: string;
+    /** Media format */
+    gbpMediaFormat?: 'PHOTO' | 'VIDEO';
+    /** Call-to-action button */
+    gbpCtaType?: 'BOOK' | 'ORDER' | 'SHOP' | 'LEARN_MORE' | 'SIGN_UP' | 'CALL';
+    /** URL the call-to-action button opens */
+    gbpCtaUrl?: string;
+    /** Event title. Used when gbpTopicType is EVENT. */
+    gbpEventTitle?: string;
+    /** Event start date, YYYY-MM-DD */
+    gbpEventStartDate?: string;
+    /** Event start time, HH:MM */
+    gbpEventStartTime?: string;
+    /** Event end date, YYYY-MM-DD */
+    gbpEventEndDate?: string;
+    /** Event end time, HH:MM */
+    gbpEventEndTime?: string;
+    /** Offer coupon code. Used when gbpTopicType is OFFER. */
+    gbpOfferCoupon?: string;
+    /** URL to redeem the offer */
+    gbpOfferRedeemUrl?: string;
+    /** Offer terms and conditions */
+    gbpOfferTerms?: string;
+  }
+
   export interface UploadVideoOptions extends CommonUploadOptions,
     TikTokVideoOptions,
     InstagramVideoOptions,
@@ -357,7 +397,9 @@ declare module 'upload-post' {
     FacebookVideoOptions,
     PinterestVideoOptions,
     XMediaOptions,
-    ThreadsOptions {
+    ThreadsOptions,
+    RedditOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: VideoPlatform[];
   }
@@ -370,7 +412,8 @@ declare module 'upload-post' {
     PinterestPhotoOptions,
     XMediaOptions,
     ThreadsOptions,
-    RedditOptions {
+    RedditOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: PhotoPlatform[];
   }
@@ -390,7 +433,8 @@ declare module 'upload-post' {
     XTextOptions,
     ThreadsOptions,
     RedditOptions,
-    LinkPreviewOptions {
+    LinkPreviewOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: TextPlatform[];
   }
@@ -721,7 +765,19 @@ declare module 'upload-post' {
      * 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 } }>;
+    updateNotificationConfig(options?: {
+      webhookEvents?: string[];
+      webhookUrl?: string;
+      channels?: string[];
+      telegramChatId?: string;
+      slackWebhookUrl?: string;
+      whatsappToPhone?: string;
+    }): Promise<{ success: boolean; config?: { webhook_events?: string[]; webhook_url?: string; [key: string]: any } }>;
+
+    /**
+     * Send a test notification through the configured channels
+     */
+    testNotifications(): Promise<{ success: boolean; [key: string]: any }>;
 
     // Instagram Comments
 

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);
@@ -333,6 +343,30 @@ export class UploadPost {
     if (options.threadsTopicTag) form.append('threads_topic_tag', options.threadsTopicTag);
   }
 
+  /**
+   * Add Google Business Profile parameters
+   *
+   * gbpLocationId is required for accounts with more than one location; the API
+   * only auto-selects when exactly one location exists.
+   * @private
+   */
+  _addGoogleBusinessParams(form, options) {
+    if (options.gbpLocationId) form.append('gbp_location_id', options.gbpLocationId);
+    if (options.gbpTopicType) form.append('gbp_topic_type', String(options.gbpTopicType).toUpperCase());
+    if (options.gbpMediaUrl) form.append('gbp_media_url', options.gbpMediaUrl);
+    if (options.gbpMediaFormat) form.append('gbp_media_format', String(options.gbpMediaFormat).toUpperCase());
+    if (options.gbpCtaType) form.append('gbp_cta_type', String(options.gbpCtaType).toUpperCase());
+    if (options.gbpCtaUrl) form.append('gbp_cta_url', options.gbpCtaUrl);
+    if (options.gbpEventTitle) form.append('gbp_event_title', options.gbpEventTitle);
+    if (options.gbpEventStartDate) form.append('gbp_event_start_date', options.gbpEventStartDate);
+    if (options.gbpEventStartTime) form.append('gbp_event_start_time', options.gbpEventStartTime);
+    if (options.gbpEventEndDate) form.append('gbp_event_end_date', options.gbpEventEndDate);
+    if (options.gbpEventEndTime) form.append('gbp_event_end_time', options.gbpEventEndTime);
+    if (options.gbpOfferCoupon) form.append('gbp_offer_coupon', options.gbpOfferCoupon);
+    if (options.gbpOfferRedeemUrl) form.append('gbp_offer_redeem_url', options.gbpOfferRedeemUrl);
+    if (options.gbpOfferTerms) form.append('gbp_offer_terms', options.gbpOfferTerms);
+  }
+
   /**
    * Add Reddit-specific parameters
    * @private
@@ -457,6 +491,7 @@ export class UploadPost {
     if (platforms.includes('x')) this._addXParams(form, options, false);
     if (platforms.includes('threads')) this._addThreadsParams(form, options);
     if (platforms.includes('reddit')) this._addRedditParams(form, options);
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -545,6 +580,7 @@ export class UploadPost {
     if (platforms.includes('x')) this._addXParams(form, options, false);
     if (platforms.includes('threads')) this._addThreadsParams(form, options);
     if (platforms.includes('reddit')) this._addRedditParams(form, options);
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload_photos', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -612,6 +648,7 @@ export class UploadPost {
     if (platforms.includes('bluesky') && (options.blueskyLinkUrl || options.linkUrl)) {
       form.append('bluesky_link_url', options.blueskyLinkUrl || options.linkUrl);
     }
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload_text', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -967,9 +1004,22 @@ export class UploadPost {
     const body = {};
     if (options.webhookEvents) body.webhook_events = options.webhookEvents;
     if (options.webhookUrl) body.webhook_url = options.webhookUrl;
+    if (options.channels) body.channels = options.channels;
+    if (options.telegramChatId) body.telegram_chat_id = options.telegramChatId;
+    if (options.slackWebhookUrl) body.slack_webhook_url = options.slackWebhookUrl;
+    if (options.whatsappToPhone) body.whatsapp_to_phone = options.whatsappToPhone;
     return this._request('/uploadposts/users/notifications', 'POST', body);
   }
 
+  /**
+   * Send a test notification through the configured channels
+   *
+   * @returns {Promise<Object>} Test result
+   */
+  async testNotifications() {
+    return this._request('/uploadposts/users/notifications/test', 'POST', {});
+  }
+
   // ==================== Instagram Comments ====================
 
   /**
@@ -1077,10 +1127,11 @@ export class UploadPost {
    * @param {string} [profile] - Profile username
    * @returns {Promise<Object>} Selection result with google_business_id and display_name
    */
-  async selectGoogleBusinessLocation(locationId, profile) {
-    const data = { location_id: locationId };
-    if (profile) data.profile = profile;
-    return this._request('/uploadposts/google-business/locations/select', 'POST', data);
+  async selectGoogleBusinessLocation() {
+    throw new Error(
+      'selectGoogleBusinessLocation is not supported: the API has no persistent location selection. ' +
+      'Pass gbpLocationId on the upload instead (list ids with getGoogleBusinessLocations).'
+    );
   }
 }
 

package/package.json

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