@postpeer/node 0.8.5 → 0.9.0

package/dist/index.js

@@ -926,6 +926,22 @@ var Integrations = class extends HeyApiClient {
       ...options
     });
   }
+  /**
+   * Move an integration to another profile
+   *
+   * Reassigns an existing integration to another profile in the same project. Pass profileId=null to leave the integration unassigned. OAuth credentials and existing posts are unchanged.
+   */
+  move(options) {
+    return (options.client ?? this.client).patch({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/connect/integrations/{id}",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
 };
 var Connect = class extends HeyApiClient {
   static {
@@ -1005,7 +1021,7 @@ var Profiles = class extends HeyApiClient {
   /**
    * Delete a profile
    *
-   * Soft-deletes the profile. Existing integrations bound to it keep their profileId — they are not orphaned, but listing /v1/profiles will no longer surface this row.
+   * Soft-deletes an empty profile. Move or disconnect active integrations before deleting their profile.
    */
   delete(options) {
     return (options.client ?? this.client).delete({
@@ -1138,6 +1154,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({
@@ -1243,7 +1261,9 @@ var Scheduled = class extends HeyApiClient {
   /**
    * Edit a scheduled post (content, media, platforms, time)
    *
-   * Replaces the editable fields of a scheduled post: text content, media attachments, target platforms + platform-specific data, and optionally the scheduled time/timezone. Re-validates each platform and reconciles the credit difference. Only works while the post is still scheduled.
+   * Deprecated: use PUT /v1/posts/:postId. Replaces the editable fields of a scheduled post and reconciles credits.
+   *
+   * @deprecated
    */
   edit(options) {
     return (options.client ?? this.client).put({
@@ -1274,7 +1294,9 @@ var Posts = class extends HeyApiClient {
     });
   }
   /**
-   * Publish a post to one or more social media platforms
+   * Create, publish, or schedule a post
+   *
+   * Set saveAsDraft=true to save without accounts or credits, publishNow=true to publish immediately, or provide scheduledFor to schedule it.
    */
   create(options) {
     return (options.client ?? this.client).post({
@@ -1287,6 +1309,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
    */
@@ -1307,6 +1345,38 @@ var Posts = class extends HeyApiClient {
       ...options
     });
   }
+  /**
+   * Edit a draft or scheduled post
+   *
+   * Replaces an editable post. Drafts remain drafts with saveAsDraft=true, publish immediately with publishNow=true, or become scheduled with scheduledFor. Scheduled posts keep their schedule.
+   */
+  edit(options) {
+    return (options.client ?? this.client).put({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/posts/{postId}",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Sync recent posts published outside PostPeer
+   *
+   * Fetches at most the 50 most recent posts from one connected account and stores posts published outside PostPeer. Existing PostPeer posts are updated instead of duplicated. Provide url or postId to verify one post. Requests are debounced per account for 15 seconds. Supported accounts: Twitter, YouTube, Pinterest, LinkedIn organization pages, TikTok, Facebook, Instagram, Threads, and Google Business.
+   */
+  syncExternal(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/posts/sync-external",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
   _scheduled;
   get scheduled() {
     return this._scheduled ??= new Scheduled({ client: this.client });
@@ -1331,85 +1401,93 @@ var Media = class extends HeyApiClient {
     });
   }
 };
-var Analytics = class extends HeyApiClient {
+var Instagram = class extends HeyApiClient {
   static {
-    __name(this, "Analytics");
+    __name(this, "Instagram");
   }
   /**
-   * Get post analytics
+   * Get Instagram follower count
    *
-   * With postId, returns analytics for a single post. Without postId, returns a paginated list of published posts with analytics. Accepts both PostPeer post IDs and external platform post IDs (auto-resolved). fromDate defaults to 90 days ago if omitted, max range 366 days. Each call costs 1 credit.
+   * 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.
    */
-  get(options) {
-    return (options?.client ?? this.client).get({
+  getFollowerStats(options) {
+    return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/analytics/",
+      url: "/v1/analytics/instagram/follower-stats",
       ...options
     });
   }
-};
-var Usage = class extends HeyApiClient {
-  static {
-    __name(this, "Usage");
+  /**
+   * 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 credit usage
+   * Get Instagram demographics
    *
-   * Returns credit usage history for the project. Without filters, returns project-level totals. Add `profileId` to scope to a specific profile, or `integrationId` to scope to a specific connected account. Use `from`/`to` (YYYY-MM) to slice the history. Each entry contains the monthly credit count and a per-platform breakdown.
+   * 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.
    */
-  get(options) {
-    return (options?.client ?? this.client).get({
+  getDemographics(options) {
+    return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/usage/",
+      url: "/v1/analytics/instagram/demographics",
       ...options
     });
   }
 };
-var Pinterest = class extends HeyApiClient {
+var Analytics = class extends HeyApiClient {
   static {
-    __name(this, "Pinterest");
+    __name(this, "Analytics");
   }
   /**
-   * List Pinterest boards for a connected account
+   * Get post analytics
+   *
+   * With postId, returns analytics for a single post. Without postId, returns a paginated list of published posts with analytics. Accepts both PostPeer post IDs and external platform post IDs (auto-resolved). fromDate defaults to 90 days ago if omitted, max range 366 days. Each call costs 1 credit.
    */
-  getBoards(options) {
+  get(options) {
     return (options?.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/pinterest/boards",
+      url: "/v1/analytics/",
       ...options
     });
   }
+  _instagram;
+  get instagram() {
+    return this._instagram ??= new Instagram({ client: this.client });
+  }
 };
-var Tiktok = class extends HeyApiClient {
+var Comments = class extends HeyApiClient {
   static {
-    __name(this, "Tiktok");
+    __name(this, "Comments");
   }
   /**
-   * Fetch TikTok creator info for a connected account
+   * List comments on a post
    *
-   * Proxies TikTok's /v2/post/publish/creator_info/query/ endpoint. Use the returned `privacyLevelOptions`, `commentDisabled`, `duetDisabled`, `stitchDisabled`, and `maxVideoPostDurationSec` to build a compliant "Post to TikTok" UX.
+   * Fetch comments (and first-level replies) on a post from a connected Facebook Page, Instagram Business account, Threads account, or LinkedIn account. Requires the account to have the relevant permissions approved (pages_read_user_content for Facebook, instagram_business_manage_comments for Instagram, threads_manage_replies for Threads, Community Management social-feed scopes for LinkedIn).
    */
-  getCreatorInfo(options) {
-    return (options?.client ?? this.client).get({
+  list(options) {
+    return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/tiktok/creator-info",
+      url: "/v1/comments/",
       ...options
     });
   }
-};
-var Ai = class extends HeyApiClient {
-  static {
-    __name(this, "Ai");
-  }
   /**
-   * Generate a social media caption from a description
+   * Create a comment or reply
    *
-   * Generates a caption tailored to the platforms you'll post to. Costs 2 credits per successful generation. Failed calls do not deduct credits.
+   * Post a top-level comment on an Instagram, Facebook, or LinkedIn post, or a top-level post on Threads (provide `postId`), or reply to an existing comment on Facebook, Instagram, Threads, or LinkedIn (provide `commentId`).
    */
-  write(options) {
+  create(options) {
     return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/ai/write",
+      url: "/v1/comments/",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1418,14 +1496,26 @@ var Ai = class extends HeyApiClient {
     });
   }
   /**
-   * Generate a social media image from a description
+   * Delete a comment
    *
-   * Generates a square or vertical image suitable for social media. Costs 10 credits per successful generation. Failed calls do not deduct credits.
+   * Delete a comment on a Facebook Page post, Instagram Business post, or LinkedIn post. Not supported on Threads (the API does not allow deleting others' replies).
    */
-  generateImage(options) {
-    return (options.client ?? this.client).post({
+  delete(options) {
+    return (options.client ?? this.client).delete({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/ai/image",
+      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.
+   */
+  hide(options) {
+    return (options.client ?? this.client).patch({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comments/{commentId}",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1434,24 +1524,31 @@ var Ai = class extends HeyApiClient {
     });
   }
 };
-var PostPeer = class _PostPeer extends HeyApiClient {
+var Messages = class extends HeyApiClient {
   static {
-    __name(this, "PostPeer");
+    __name(this, "Messages");
   }
-  static __registry = new HeyApiRegistry();
-  constructor(args) {
-    super(args);
-    _PostPeer.__registry.set(this, args?.key);
+  /**
+   * 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
+    });
   }
   /**
-   * Move an integration to another profile
+   * Send a message
    *
-   * Reassigns an existing integration to another profile in the same project. Pass profileId=null to leave the integration unassigned. OAuth credentials and existing posts are unchanged.
+   * Send a DM reply on Instagram.
    */
-  moveIntegration(options) {
-    return (options.client ?? this.client).patch({
+  send(options) {
+    return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/connect/integrations/{id}",
+      url: "/v1/messages/",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1460,26 +1557,55 @@ 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).
+   * Get messages in a conversation
    */
-  listComments(options) {
+  getConversation(options) {
     return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/",
+      url: "/v1/messages/{conversationId}",
       ...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) {
+};
+var Posts2 = class extends HeyApiClient {
+  static {
+    __name(this, "Posts2");
+  }
+  list(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comment-automations/posts",
+      ...options
+    });
+  }
+};
+var Logs = class extends HeyApiClient {
+  static {
+    __name(this, "Logs");
+  }
+  list(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comment-automations/{id}/logs",
+      ...options
+    });
+  }
+};
+var CommentAutomations = class extends HeyApiClient {
+  static {
+    __name(this, "CommentAutomations");
+  }
+  list(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comment-automations/",
+      ...options
+    });
+  }
+  create(options) {
     return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/",
+      url: "/v1/comment-automations/",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1487,27 +1613,17 @@ var PostPeer = class _PostPeer extends HeyApiClient {
       }
     });
   }
-  /**
-   * 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) {
+  delete(options) {
     return (options.client ?? this.client).delete({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/{commentId}",
+      url: "/v1/comment-automations/{id}",
       ...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) {
+  update(options) {
     return (options.client ?? this.client).patch({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/{commentId}",
+      url: "/v1/comment-automations/{id}",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1515,27 +1631,92 @@ var PostPeer = class _PostPeer extends HeyApiClient {
       }
     });
   }
+  _posts;
+  get posts() {
+    return this._posts ??= new Posts2({ client: this.client });
+  }
+  _logs;
+  get logs() {
+    return this._logs ??= new Logs({ client: this.client });
+  }
+};
+var Usage = class extends HeyApiClient {
+  static {
+    __name(this, "Usage");
+  }
   /**
-   * List conversations
+   * Get credit usage
    *
-   * List DM conversations for a connected Instagram Business account. Requires instagram_business_manage_messages.
+   * Returns credit usage history for the project. Without filters, returns project-level totals. Add `profileId` to scope to a specific profile, or `integrationId` to scope to a specific connected account. Use `from`/`to` (YYYY-MM) to slice the history. Each entry contains the monthly credit count and a per-platform breakdown.
    */
-  listConversations(options) {
+  get(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/usage/",
+      ...options
+    });
+  }
+};
+var Pinterest = class extends HeyApiClient {
+  static {
+    __name(this, "Pinterest");
+  }
+  /**
+   * List Pinterest boards for a connected account
+   */
+  getBoards(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/pinterest/boards",
+      ...options
+    });
+  }
+};
+var Tiktok = class extends HeyApiClient {
+  static {
+    __name(this, "Tiktok");
+  }
+  /**
+   * Fetch TikTok creator info for a connected account
+   *
+   * Proxies TikTok's /v2/post/publish/creator_info/query/ endpoint. Use the returned `privacyLevelOptions`, `commentDisabled`, `duetDisabled`, `stitchDisabled`, and `maxVideoPostDurationSec` to build a compliant "Post to TikTok" UX.
+   */
+  getCreatorInfo(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/tiktok/creator-info",
+      ...options
+    });
+  }
+};
+var Linkedin2 = class extends HeyApiClient {
+  static {
+    __name(this, "Linkedin2");
+  }
+  /**
+   * Find a LinkedIn organization ID and URN by company URL or slug
+   */
+  lookupOrganization(options) {
     return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/messages/",
+      url: "/v1/linkedin/organization-lookup",
       ...options
     });
   }
+};
+var Ai = class extends HeyApiClient {
+  static {
+    __name(this, "Ai");
+  }
   /**
-   * Send a message
+   * Generate a social media caption from a description
    *
-   * Send a DM reply on Instagram.
+   * Generates a caption tailored to the platforms you'll post to. Costs 2 credits per successful generation. Failed calls do not deduct credits.
    */
-  sendMessage(options) {
+  write(options) {
     return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/messages/",
+      url: "/v1/ai/write",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1544,15 +1725,31 @@ var PostPeer = class _PostPeer extends HeyApiClient {
     });
   }
   /**
-   * Get messages in a conversation
+   * Generate a social media image from a description
+   *
+   * Generates a square or vertical image suitable for social media. Costs 10 credits per successful generation. Failed calls do not deduct credits.
    */
-  getConversationMessages(options) {
-    return (options.client ?? this.client).get({
+  generateImage(options) {
+    return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/messages/{conversationId}",
-      ...options
+      url: "/v1/ai/image",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
     });
   }
+};
+var PostPeer = class _PostPeer extends HeyApiClient {
+  static {
+    __name(this, "PostPeer");
+  }
+  static __registry = new HeyApiRegistry();
+  constructor(args) {
+    super(args);
+    _PostPeer.__registry.set(this, args?.key);
+  }
   _health;
   get health() {
     return this._health ??= new Health({ client: this.client });
@@ -1589,6 +1786,18 @@ var PostPeer = class _PostPeer extends HeyApiClient {
   get analytics() {
     return this._analytics ??= new Analytics({ client: this.client });
   }
+  _comments;
+  get comments() {
+    return this._comments ??= new Comments({ client: this.client });
+  }
+  _messages;
+  get messages() {
+    return this._messages ??= new Messages({ client: this.client });
+  }
+  _commentAutomations;
+  get commentAutomations() {
+    return this._commentAutomations ??= new CommentAutomations({ client: this.client });
+  }
   _usage;
   get usage() {
     return this._usage ??= new Usage({ client: this.client });
@@ -1601,6 +1810,10 @@ var PostPeer = class _PostPeer extends HeyApiClient {
   get tiktok() {
     return this._tiktok ??= new Tiktok({ client: this.client });
   }
+  _linkedin;
+  get linkedin() {
+    return this._linkedin ??= new Linkedin2({ client: this.client });
+  }
   _ai;
   get ai() {
     return this._ai ??= new Ai({ client: this.client });
@@ -1746,7 +1959,7 @@ var createAPIError = /* @__PURE__ */ __name((response, body) => {
 }, "createAPIError");
 
 // src/version.ts
-var VERSION = "0.8.5";
+var VERSION = "0.9.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.postpeer.dev";