@postpeer/node 0.8.4 → 0.8.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.8.6
+
+- Added retrying failed platform targets for a post.
+- Added Instagram follower statistics, account insights, and audience demographics.
+- Added Trial Reels, Reel audio names, and idempotency keys for post creation.
+- Added integration insight-permission status and profile names.
+
+## 0.8.5
+
+- Added listing, creating, replying to, hiding, unhiding, and deleting comments on supported Meta platforms.
+- Added listing Instagram conversations, fetching their messages, and sending DM replies.
+
 ## 0.8.4
 
 - Added moving connected integrations between profiles.

package/dist/index.cjs

@@ -1142,6 +1142,8 @@ var Notifications = class extends HeyApiClient {
   }
   /**
    * Create a notification subscription
+   *
+   * Create an email or webhook subscription. See the [webhook guide](/docs/webhooks) for request headers, payload fields, and signature verification.
    */
   create(options) {
     return (options.client ?? this.client).post({
@@ -1291,6 +1293,22 @@ var Posts = class extends HeyApiClient {
       }
     });
   }
+  /**
+   * Retry the failed platforms of a post
+   *
+   * Re-publish only the platform targets that failed on a post. Omit scheduledFor to retry immediately, or pass scheduledFor (ISO 8601) to schedule the retry. Retried platforms are charged credits (they were refunded when they failed) and refunded again if they fail. Already-published platforms are never re-posted.
+   */
+  retry(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/posts/{postId}/retry",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
   /**
    * Delete a post by ID
    */
@@ -1335,6 +1353,47 @@ var Media = class extends HeyApiClient {
     });
   }
 };
+var Instagram = class extends HeyApiClient {
+  static {
+    __name(this, "Instagram");
+  }
+  /**
+   * Get Instagram follower count
+   *
+   * Returns the connected Instagram professional account's live follower count. Historical growth requires daily snapshots and is not included. Each successful call costs 1 credit.
+   */
+  getFollowerStats(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/analytics/instagram/follower-stats",
+      ...options
+    });
+  }
+  /**
+   * Get Instagram account insights
+   *
+   * Returns account-wide Instagram insights across feed, stories, explore, and profile activity. The date range defaults to the last 30 days and cannot exceed 90 days. Only reach supports daily time-series output. Missing Meta metrics are omitted rather than reported as zero. Each successful call costs 1 credit.
+   */
+  getAccountInsights(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/analytics/instagram/account-insights",
+      ...options
+    });
+  }
+  /**
+   * Get Instagram demographics
+   *
+   * Returns Instagram follower, engaged-audience, or reached-audience demographics by age, city, country, and/or gender. Meta returns at most 45 entries per dimension, requires a sufficient audience, and may delay data by up to 48 hours. Each call costs 1 credit.
+   */
+  getDemographics(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/analytics/instagram/demographics",
+      ...options
+    });
+  }
+};
 var Analytics = class extends HeyApiClient {
   static {
     __name(this, "Analytics");
@@ -1351,6 +1410,10 @@ var Analytics = class extends HeyApiClient {
       ...options
     });
   }
+  _instagram;
+  get instagram() {
+    return this._instagram ??= new Instagram({ client: this.client });
+  }
 };
 var Usage = class extends HeyApiClient {
   static {
@@ -1463,6 +1526,100 @@ var PostPeer = class _PostPeer extends HeyApiClient {
       }
     });
   }
+  /**
+   * List comments on a post
+   *
+   * Fetch comments (and first-level replies) on a post from a connected Facebook Page, Instagram Business account, or Threads account. Requires the account to have the relevant Meta permissions approved (pages_read_user_content for Facebook, instagram_business_manage_comments for Instagram, threads_manage_replies for Threads).
+   */
+  listComments(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comments/",
+      ...options
+    });
+  }
+  /**
+   * Create a comment or reply
+   *
+   * Post a top-level comment on an Instagram or Facebook post, or a top-level post on Threads (provide `postId`), or reply to an existing comment on Facebook, Instagram, or Threads (provide `commentId`).
+   */
+  createComment(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comments/",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Delete a comment
+   *
+   * Delete a comment on a Facebook Page post or Instagram Business post. Not supported on Threads (the API does not allow deleting others' replies).
+   */
+  deleteComment(options) {
+    return (options.client ?? this.client).delete({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comments/{commentId}",
+      ...options
+    });
+  }
+  /**
+   * Hide or unhide a comment
+   *
+   * Hide or unhide a comment on an Instagram Business post. Pass `hidden: true` to hide, `hidden: false` to unhide. Instagram only.
+   */
+  hideComment(options) {
+    return (options.client ?? this.client).patch({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comments/{commentId}",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * List conversations
+   *
+   * List DM conversations for a connected Instagram Business account. Requires instagram_business_manage_messages.
+   */
+  listConversations(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/messages/",
+      ...options
+    });
+  }
+  /**
+   * Send a message
+   *
+   * Send a DM reply on Instagram.
+   */
+  sendMessage(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/messages/",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Get messages in a conversation
+   */
+  getConversationMessages(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/messages/{conversationId}",
+      ...options
+    });
+  }
   _health;
   get health() {
     return this._health ??= new Health({ client: this.client });
@@ -1656,7 +1813,7 @@ var createAPIError = /* @__PURE__ */ __name((response, body) => {
 }, "createAPIError");
 
 // src/version.ts
-var VERSION = "0.8.4";
+var VERSION = "0.8.6";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.postpeer.dev";