@chirpie/sdk 1.0.9 → 1.0.11

package/dist/index.d.mts

@@ -102,6 +102,10 @@ interface CreatePostInput {
     account_id: string;
     text: string;
     media_urls?: string[];
+    /**
+     * ISO 8601 datetime to schedule the post (UTC). Must be in the future.
+     * Scheduled posts publish within ~5 minutes of this time.
+     */
     schedule_at?: string;
 }
 interface CreateThreadInput {
@@ -110,6 +114,10 @@ interface CreateThreadInput {
         text: string;
         media_urls?: string[];
     }[];
+    /**
+     * ISO 8601 datetime to schedule the entire thread (UTC). Must be in the future.
+     * Scheduled threads publish within ~5 minutes of this time.
+     */
     schedule_at?: string;
 }
 interface ListPostsOptions {
@@ -128,6 +136,16 @@ declare class ChirpieClient {
     private baseUrl;
     constructor(options: ChirpieClientOptions);
     private request;
+    /**
+     * Create a post (immediate or scheduled).
+     * If `schedule_at` is set, the post is queued and publishes within ~5 minutes
+     * of the scheduled time.
+     *
+     * @param input - Post payload including `account_id`, `text`, optional `media_urls`, and optional `schedule_at`.
+     * @returns The created post.
+     * @throws {ChirpieError} On network/transport failure.
+     * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+     */
     createPost(input: CreatePostInput): Promise<ApiPost>;
     listPosts(options?: ListPostsOptions): Promise<ApiPost[]>;
     getPost(id: string): Promise<ApiPost>;
@@ -135,6 +153,17 @@ declare class ChirpieClient {
         id: string;
         deleted: boolean;
     }>;
+    /**
+     * Create a thread (immediate or scheduled).
+     * If `schedule_at` is set, the thread is queued and publishes within ~5 minutes
+     * of the scheduled time. Threads publish atomically — if any post fails, the
+     * entire thread is retried.
+     *
+     * @param input - Thread payload including `account_id`, an array of `posts` (text + optional `media_urls`), and optional `schedule_at`.
+     * @returns The created thread, including each post's id and status.
+     * @throws {ChirpieError} On network/transport failure.
+     * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+     */
     createThread(input: CreateThreadInput): Promise<ApiThread>;
     listAccounts(): Promise<ApiAccount[]>;
     connectXAccount(): Promise<{
@@ -157,21 +186,27 @@ declare class ChirpieClient {
         authorization_url: string;
     }>;
     connectTelegramAccount(input: ConnectTelegramInput): Promise<ApiAccount>;
+    /** Coming Soon. */
     connectRedditAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectPinterestAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectTikTokAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectYouTubeAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectGBPAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectSnapchatAccount(): Promise<{
         authorization_url: string;
     }>;

package/dist/index.d.ts

@@ -102,6 +102,10 @@ interface CreatePostInput {
     account_id: string;
     text: string;
     media_urls?: string[];
+    /**
+     * ISO 8601 datetime to schedule the post (UTC). Must be in the future.
+     * Scheduled posts publish within ~5 minutes of this time.
+     */
     schedule_at?: string;
 }
 interface CreateThreadInput {
@@ -110,6 +114,10 @@ interface CreateThreadInput {
         text: string;
         media_urls?: string[];
     }[];
+    /**
+     * ISO 8601 datetime to schedule the entire thread (UTC). Must be in the future.
+     * Scheduled threads publish within ~5 minutes of this time.
+     */
     schedule_at?: string;
 }
 interface ListPostsOptions {
@@ -128,6 +136,16 @@ declare class ChirpieClient {
     private baseUrl;
     constructor(options: ChirpieClientOptions);
     private request;
+    /**
+     * Create a post (immediate or scheduled).
+     * If `schedule_at` is set, the post is queued and publishes within ~5 minutes
+     * of the scheduled time.
+     *
+     * @param input - Post payload including `account_id`, `text`, optional `media_urls`, and optional `schedule_at`.
+     * @returns The created post.
+     * @throws {ChirpieError} On network/transport failure.
+     * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+     */
     createPost(input: CreatePostInput): Promise<ApiPost>;
     listPosts(options?: ListPostsOptions): Promise<ApiPost[]>;
     getPost(id: string): Promise<ApiPost>;
@@ -135,6 +153,17 @@ declare class ChirpieClient {
         id: string;
         deleted: boolean;
     }>;
+    /**
+     * Create a thread (immediate or scheduled).
+     * If `schedule_at` is set, the thread is queued and publishes within ~5 minutes
+     * of the scheduled time. Threads publish atomically — if any post fails, the
+     * entire thread is retried.
+     *
+     * @param input - Thread payload including `account_id`, an array of `posts` (text + optional `media_urls`), and optional `schedule_at`.
+     * @returns The created thread, including each post's id and status.
+     * @throws {ChirpieError} On network/transport failure.
+     * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+     */
     createThread(input: CreateThreadInput): Promise<ApiThread>;
     listAccounts(): Promise<ApiAccount[]>;
     connectXAccount(): Promise<{
@@ -157,21 +186,27 @@ declare class ChirpieClient {
         authorization_url: string;
     }>;
     connectTelegramAccount(input: ConnectTelegramInput): Promise<ApiAccount>;
+    /** Coming Soon. */
     connectRedditAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectPinterestAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectTikTokAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectYouTubeAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectGBPAccount(): Promise<{
         authorization_url: string;
     }>;
+    /** Coming Soon. */
     connectSnapchatAccount(): Promise<{
         authorization_url: string;
     }>;

package/dist/index.js

@@ -90,6 +90,16 @@ var ChirpieClient = class {
     return json.data;
   }
   // Posts
+  /**
+   * Create a post (immediate or scheduled).
+   * If `schedule_at` is set, the post is queued and publishes within ~5 minutes
+   * of the scheduled time.
+   *
+   * @param input - Post payload including `account_id`, `text`, optional `media_urls`, and optional `schedule_at`.
+   * @returns The created post.
+   * @throws {ChirpieError} On network/transport failure.
+   * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+   */
   async createPost(input) {
     return this.request("POST", "/posts", input);
   }
@@ -109,6 +119,17 @@ var ChirpieClient = class {
     return this.request("DELETE", `/posts/${id}`);
   }
   // Threads
+  /**
+   * Create a thread (immediate or scheduled).
+   * If `schedule_at` is set, the thread is queued and publishes within ~5 minutes
+   * of the scheduled time. Threads publish atomically — if any post fails, the
+   * entire thread is retried.
+   *
+   * @param input - Thread payload including `account_id`, an array of `posts` (text + optional `media_urls`), and optional `schedule_at`.
+   * @returns The created thread, including each post's id and status.
+   * @throws {ChirpieError} On network/transport failure.
+   * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+   */
   async createThread(input) {
     return this.request("POST", "/threads", input);
   }
@@ -148,31 +169,37 @@ var ChirpieClient = class {
   async connectTelegramAccount(input) {
     return this.request("POST", "/accounts", input);
   }
+  /** Coming Soon. */
   async connectRedditAccount() {
     return this.request("POST", "/accounts", {
       platform: "reddit"
     });
   }
+  /** Coming Soon. */
   async connectPinterestAccount() {
     return this.request("POST", "/accounts", {
       platform: "pinterest"
     });
   }
+  /** Coming Soon. */
   async connectTikTokAccount() {
     return this.request("POST", "/accounts", {
       platform: "tiktok"
     });
   }
+  /** Coming Soon. */
   async connectYouTubeAccount() {
     return this.request("POST", "/accounts", {
       platform: "youtube"
     });
   }
+  /** Coming Soon. */
   async connectGBPAccount() {
     return this.request("POST", "/accounts", {
       platform: "google_business"
     });
   }
+  /** Coming Soon. */
   async connectSnapchatAccount() {
     return this.request("POST", "/accounts", {
       platform: "snapchat"

package/dist/index.mjs

@@ -58,6 +58,16 @@ var ChirpieClient = class {
     return json.data;
   }
   // Posts
+  /**
+   * Create a post (immediate or scheduled).
+   * If `schedule_at` is set, the post is queued and publishes within ~5 minutes
+   * of the scheduled time.
+   *
+   * @param input - Post payload including `account_id`, `text`, optional `media_urls`, and optional `schedule_at`.
+   * @returns The created post.
+   * @throws {ChirpieError} On network/transport failure.
+   * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+   */
   async createPost(input) {
     return this.request("POST", "/posts", input);
   }
@@ -77,6 +87,17 @@ var ChirpieClient = class {
     return this.request("DELETE", `/posts/${id}`);
   }
   // Threads
+  /**
+   * Create a thread (immediate or scheduled).
+   * If `schedule_at` is set, the thread is queued and publishes within ~5 minutes
+   * of the scheduled time. Threads publish atomically — if any post fails, the
+   * entire thread is retried.
+   *
+   * @param input - Thread payload including `account_id`, an array of `posts` (text + optional `media_urls`), and optional `schedule_at`.
+   * @returns The created thread, including each post's id and status.
+   * @throws {ChirpieError} On network/transport failure.
+   * @throws {ChirpieApiError} On non-2xx responses (auth, validation, plan limit, platform error) or invalid JSON.
+   */
   async createThread(input) {
     return this.request("POST", "/threads", input);
   }
@@ -116,31 +137,37 @@ var ChirpieClient = class {
   async connectTelegramAccount(input) {
     return this.request("POST", "/accounts", input);
   }
+  /** Coming Soon. */
   async connectRedditAccount() {
     return this.request("POST", "/accounts", {
       platform: "reddit"
     });
   }
+  /** Coming Soon. */
   async connectPinterestAccount() {
     return this.request("POST", "/accounts", {
       platform: "pinterest"
     });
   }
+  /** Coming Soon. */
   async connectTikTokAccount() {
     return this.request("POST", "/accounts", {
       platform: "tiktok"
     });
   }
+  /** Coming Soon. */
   async connectYouTubeAccount() {
     return this.request("POST", "/accounts", {
       platform: "youtube"
     });
   }
+  /** Coming Soon. */
   async connectGBPAccount() {
     return this.request("POST", "/accounts", {
       platform: "google_business"
     });
   }
+  /** Coming Soon. */
   async connectSnapchatAccount() {
     return this.request("POST", "/accounts", {
       platform: "snapchat"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chirpie/sdk",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Chirpie SDK — TypeScript client for the Chirpie social media API",
   "repository": {
     "type": "git",
@@ -33,8 +33,25 @@
     "social-media",
     "api",
     "sdk",
+    "x",
     "twitter",
-    "x"
+    "bluesky",
+    "linkedin",
+    "threads",
+    "mastodon",
+    "instagram",
+    "facebook",
+    "telegram",
+    "reddit",
+    "pinterest",
+    "tiktok",
+    "youtube",
+    "google-business",
+    "snapchat",
+    "fediverse",
+    "scheduling",
+    "agent",
+    "llm"
   ],
   "license": "MIT",
   "devDependencies": {