@postpeer/node 0.8.6 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.9.0
+
+- Grouped integration moves, comments, messages, comment automations, post editing and syncing, and LinkedIn lookup into resource-based SDK namespaces.
+- Added creating and editing draft posts, editing scheduled posts through the unified posts API, and Facebook Page Stories.
+- Added syncing posts published outside PostPeer and filtering posts by their source.
+- Added creating, listing, updating, deleting, and inspecting comment automations.
+- Added LinkedIn organization lookup and connected-integration sorting and sync-capability fields.
+
 ## 0.8.6
 
 - Added retrying failed platform targets for a post.

package/README.md

@@ -62,7 +62,10 @@ client.health.verifyAccessKey();
 client.posts.create({ body });
 client.posts.list({ query });
 client.posts.get({ path: { postId } });
+client.posts.edit({ path: { postId }, body });
 client.posts.delete({ path: { postId } });
+client.posts.retry({ path: { postId }, body });
+client.posts.syncExternal({ body });
 client.posts.scheduled.list();
 client.posts.scheduled.edit({ path: { postId }, body });
 client.posts.scheduled.cancel({ path: { postId } });
@@ -73,8 +76,27 @@ client.connect.facebook.getSelection({ path: { token } });
 client.connect.facebook.submitSelection({ path: { token }, body });
 client.connect.integrations.list();
 client.connect.integrations.get({ path: { id } });
+client.connect.integrations.move({ path: { id }, body });
 client.connect.integrations.disconnect({ path: { id } });
 
+client.comments.list({ query });
+client.comments.create({ body });
+client.comments.hide({ path: { commentId }, body });
+client.comments.delete({ path: { commentId }, query });
+
+client.messages.listConversations({ query });
+client.messages.getConversation({ path: { conversationId }, query });
+client.messages.send({ body });
+
+client.commentAutomations.list();
+client.commentAutomations.create({ body });
+client.commentAutomations.update({ path: { id }, body });
+client.commentAutomations.delete({ path: { id } });
+client.commentAutomations.posts.list({ query });
+client.commentAutomations.logs.list({ path: { id }, query });
+
+client.linkedin.lookupOrganization({ query });
+
 client.profiles.list();
 client.apps.list();
 client.notifications.list();
@@ -145,8 +167,8 @@ Generated files under `src/generated` must not be edited by hand.
 PostPeer uses conservative pre-1.0 versioning:
 
 - `0.8.0` is the first Hey API release.
-- Compatible fixes and additions remain in `0.8.x`.
-- A breaking SDK change moves to `0.9.0`.
+- Compatible fixes and additions remain within the current minor release.
+- Breaking SDK changes move to the next minor release until `1.0.0`.
 - `1.0.0` will be published only when the SDK contract is considered mature.
 
 OpenAPI changes may accumulate before a package release.

package/dist/index.cjs

@@ -930,6 +930,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 {
@@ -1009,7 +1025,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({
@@ -1249,7 +1265,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({
@@ -1280,7 +1298,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({
@@ -1329,6 +1349,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 });
@@ -1415,68 +1467,59 @@ var Analytics = class extends HeyApiClient {
     return this._instagram ??= new Instagram({ client: this.client });
   }
 };
-var Usage = class extends HeyApiClient {
+var Comments = class extends HeyApiClient {
   static {
-    __name(this, "Usage");
+    __name(this, "Comments");
   }
   /**
-   * Get credit usage
+   * List comments on a post
    *
-   * 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.
+   * 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).
    */
-  get(options) {
-    return (options?.client ?? this.client).get({
+  list(options) {
+    return (options.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/usage/",
+      url: "/v1/comments/",
       ...options
     });
   }
-};
-var Pinterest = class extends HeyApiClient {
-  static {
-    __name(this, "Pinterest");
-  }
   /**
-   * List Pinterest boards for a connected account
+   * Create a comment or reply
+   *
+   * 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`).
    */
-  getBoards(options) {
-    return (options?.client ?? this.client).get({
+  create(options) {
+    return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/pinterest/boards",
-      ...options
+      url: "/v1/comments/",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
     });
   }
-};
-var Tiktok = class extends HeyApiClient {
-  static {
-    __name(this, "Tiktok");
-  }
   /**
-   * Fetch TikTok creator info for a connected account
+   * Delete a comment
    *
-   * 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.
+   * 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).
    */
-  getCreatorInfo(options) {
-    return (options?.client ?? this.client).get({
+  delete(options) {
+    return (options.client ?? this.client).delete({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/tiktok/creator-info",
+      url: "/v1/comments/{commentId}",
       ...options
     });
   }
-};
-var Ai = class extends HeyApiClient {
-  static {
-    __name(this, "Ai");
-  }
   /**
-   * Generate a social media caption from a description
+   * Hide or unhide a comment
    *
-   * Generates a caption tailored to the platforms you'll post to. Costs 2 credits per successful generation. Failed calls do not deduct credits.
+   * Hide or unhide a comment on an Instagram Business post. Pass `hidden: true` to hide, `hidden: false` to unhide. Instagram only.
    */
-  write(options) {
-    return (options.client ?? this.client).post({
+  hide(options) {
+    return (options.client ?? this.client).patch({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/ai/write",
+      url: "/v1/comments/{commentId}",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1484,15 +1527,32 @@ var Ai = class extends HeyApiClient {
       }
     });
   }
+};
+var Messages = class extends HeyApiClient {
+  static {
+    __name(this, "Messages");
+  }
   /**
-   * Generate a social media image from a description
+   * List conversations
    *
-   * Generates a square or vertical image suitable for social media. Costs 10 credits per successful generation. Failed calls do not deduct credits.
+   * List DM conversations for a connected Instagram Business account. Requires instagram_business_manage_messages.
    */
-  generateImage(options) {
+  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.
+   */
+  send(options) {
     return (options.client ?? this.client).post({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/ai/image",
+      url: "/v1/messages/",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1500,25 +1560,56 @@ var Ai = class extends HeyApiClient {
       }
     });
   }
+  /**
+   * Get messages in a conversation
+   */
+  getConversation(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/messages/{conversationId}",
+      ...options
+    });
+  }
 };
-var PostPeer = class _PostPeer extends HeyApiClient {
+var Posts2 = class extends HeyApiClient {
   static {
-    __name(this, "PostPeer");
+    __name(this, "Posts2");
   }
-  static __registry = new HeyApiRegistry();
-  constructor(args) {
-    super(args);
-    _PostPeer.__registry.set(this, args?.key);
+  list(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "x-access-key", type: "apiKey" }],
+      url: "/v1/comment-automations/posts",
+      ...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.
-   */
-  moveIntegration(options) {
-    return (options.client ?? this.client).patch({
+};
+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/connect/integrations/{id}",
+      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/comment-automations/",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1526,27 +1617,17 @@ 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({
+  delete(options) {
+    return (options.client ?? this.client).delete({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/",
+      url: "/v1/comment-automations/{id}",
       ...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({
+  update(options) {
+    return (options.client ?? this.client).patch({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/",
+      url: "/v1/comment-automations/{id}",
       ...options,
       headers: {
         "Content-Type": "application/json",
@@ -1554,55 +1635,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");
+  }
   /**
-   * Delete a comment
+   * Get credit usage
    *
-   * Delete a comment on a Facebook Page post or Instagram Business post. Not supported on Threads (the API does not allow deleting others' replies).
+   * 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.
    */
-  deleteComment(options) {
-    return (options.client ?? this.client).delete({
+  get(options) {
+    return (options?.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/{commentId}",
+      url: "/v1/usage/",
       ...options
     });
   }
+};
+var Pinterest = class extends HeyApiClient {
+  static {
+    __name(this, "Pinterest");
+  }
   /**
-   * 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.
+   * List Pinterest boards for a connected account
    */
-  hideComment(options) {
-    return (options.client ?? this.client).patch({
+  getBoards(options) {
+    return (options?.client ?? this.client).get({
       security: [{ name: "x-access-key", type: "apiKey" }],
-      url: "/v1/comments/{commentId}",
-      ...options,
-      headers: {
-        "Content-Type": "application/json",
-        ...options.headers
-      }
+      url: "/v1/pinterest/boards",
+      ...options
     });
   }
+};
+var Tiktok = class extends HeyApiClient {
+  static {
+    __name(this, "Tiktok");
+  }
   /**
-   * List conversations
+   * Fetch TikTok creator info for a connected account
    *
-   * List DM conversations for a connected Instagram Business account. Requires instagram_business_manage_messages.
+   * 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.
    */
-  listConversations(options) {
+  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",
@@ -1611,15 +1729,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 });
@@ -1656,6 +1790,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 });
@@ -1668,6 +1814,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 });
@@ -1813,7 +1963,7 @@ var createAPIError = /* @__PURE__ */ __name((response, body) => {
 }, "createAPIError");
 
 // src/version.ts
-var VERSION = "0.8.6";
+var VERSION = "0.9.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.postpeer.dev";