@chirpie/sdk 1.0.12 → 1.0.14

package/dist/index.d.mts

@@ -31,9 +31,42 @@ interface ApiAccount {
     display_name: string | null;
     avatar_url: string | null;
     max_post_length: number;
+    /**
+     * X accounts only. True when the account was connected through your own X
+     * developer app, so its posts use your X API credits.
+     */
+    byo_keys?: boolean;
     is_active: boolean;
     created_at: string;
 }
+/** Status of your own X developer app. Never includes the client secret. */
+interface XKeysStatus {
+    configured: boolean;
+    label: string | null;
+    /** Last 4 characters of the stored client ID, to confirm which app is saved. */
+    client_id_last4: string | null;
+    /** The exact callback URI to register on your X app. */
+    redirect_uri: string;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface SetXKeysInput {
+    /** OAuth 2.0 Client ID from developer.x.com. */
+    client_id: string;
+    /** OAuth 2.0 Client Secret from developer.x.com. Stored encrypted. */
+    client_secret: string;
+    /** Optional human-readable name for the app. */
+    label?: string;
+}
+interface SetXKeysResult extends XKeysStatus {
+    required_scopes: string[];
+    message: string;
+}
+interface RemoveXKeysResult {
+    configured: false;
+    removed: true;
+    message: string;
+}
 interface ApiAnalytics {
     post_id: string;
     platform: Platform;
@@ -103,7 +136,9 @@ interface CreatePostInput {
     text: string;
     media_urls?: string[];
     /**
-     * ISO 8601 datetime to schedule the post (UTC). Must be in the future.
+     * ISO 8601 datetime to schedule the post. Must be in the future and carry a
+     * timezone — "2026-04-01T14:00:00Z" or "2026-04-01T16:00:00+02:00" both work
+     * and are normalized to UTC.
      * Scheduled posts publish within ~5 minutes of this time.
      */
     schedule_at?: string;
@@ -115,7 +150,9 @@ interface CreateThreadInput {
         media_urls?: string[];
     }[];
     /**
-     * ISO 8601 datetime to schedule the entire thread (UTC). Must be in the future.
+     * ISO 8601 datetime to schedule the entire thread. Must be in the future and
+     * carry a timezone — "2026-04-01T14:00:00Z" or "2026-04-01T16:00:00+02:00"
+     * both work and are normalized to UTC.
      * Scheduled threads publish within ~5 minutes of this time.
      */
     schedule_at?: string;
@@ -218,6 +255,26 @@ declare class ChirpieClient {
     connectAccount(): Promise<{
         authorization_url: string;
     }>;
+    /**
+     * Register your own X developer app so X accounts connect through it and
+     * post against your X API credits instead of Chirpie's. Link posts from
+     * accounts connected this way are not surcharged.
+     *
+     * Add the returned `redirect_uri` as a callback URI on your X app, then
+     * reconnect each X account you want to move onto your app — accounts that
+     * are already connected keep using whichever app connected them.
+     */
+    setXKeys(input: SetXKeysInput): Promise<SetXKeysResult>;
+    /**
+     * Remove your own X developer app. X accounts connected through it stop
+     * refreshing until you re-add the keys or reconnect them through Chirpie.
+     */
+    removeXKeys(): Promise<RemoveXKeysResult>;
+    /**
+     * Check whether your own X developer app is configured. Never returns the
+     * client secret.
+     */
+    getXKeysStatus(): Promise<XKeysStatus>;
     createKey(name?: string): Promise<{
         key: string;
         prefix: string;
@@ -263,4 +320,4 @@ declare function deleteConfig(): boolean;
  */
 declare function requireConfig(): ChirpieConfig;
 
-export { type ApiAccount, type ApiAnalytics, type ApiKeyInfo, type ApiPost, type ApiThread, ChirpieApiError, ChirpieClient, type ChirpieClientOptions, type ChirpieConfig, ChirpieError, type ConnectBlueskyInput, type ConnectFacebookInput, type ConnectGBPInput, type ConnectInstagramInput, type ConnectLinkedInInput, type ConnectMastodonInput, type ConnectPinterestInput, type ConnectRedditInput, type ConnectSnapchatInput, type ConnectTelegramInput, type ConnectThreadsInput, type ConnectTikTokInput, type ConnectYouTubeInput, type CreatePostInput, type CreateThreadInput, type ListPostsOptions, deleteConfig, getConfig, requireConfig, saveConfig };
+export { type ApiAccount, type ApiAnalytics, type ApiKeyInfo, type ApiPost, type ApiThread, ChirpieApiError, ChirpieClient, type ChirpieClientOptions, type ChirpieConfig, ChirpieError, type ConnectBlueskyInput, type ConnectFacebookInput, type ConnectGBPInput, type ConnectInstagramInput, type ConnectLinkedInInput, type ConnectMastodonInput, type ConnectPinterestInput, type ConnectRedditInput, type ConnectSnapchatInput, type ConnectTelegramInput, type ConnectThreadsInput, type ConnectTikTokInput, type ConnectYouTubeInput, type CreatePostInput, type CreateThreadInput, type ListPostsOptions, type RemoveXKeysResult, type SetXKeysInput, type SetXKeysResult, type XKeysStatus, deleteConfig, getConfig, requireConfig, saveConfig };

package/dist/index.d.ts

@@ -31,9 +31,42 @@ interface ApiAccount {
     display_name: string | null;
     avatar_url: string | null;
     max_post_length: number;
+    /**
+     * X accounts only. True when the account was connected through your own X
+     * developer app, so its posts use your X API credits.
+     */
+    byo_keys?: boolean;
     is_active: boolean;
     created_at: string;
 }
+/** Status of your own X developer app. Never includes the client secret. */
+interface XKeysStatus {
+    configured: boolean;
+    label: string | null;
+    /** Last 4 characters of the stored client ID, to confirm which app is saved. */
+    client_id_last4: string | null;
+    /** The exact callback URI to register on your X app. */
+    redirect_uri: string;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface SetXKeysInput {
+    /** OAuth 2.0 Client ID from developer.x.com. */
+    client_id: string;
+    /** OAuth 2.0 Client Secret from developer.x.com. Stored encrypted. */
+    client_secret: string;
+    /** Optional human-readable name for the app. */
+    label?: string;
+}
+interface SetXKeysResult extends XKeysStatus {
+    required_scopes: string[];
+    message: string;
+}
+interface RemoveXKeysResult {
+    configured: false;
+    removed: true;
+    message: string;
+}
 interface ApiAnalytics {
     post_id: string;
     platform: Platform;
@@ -103,7 +136,9 @@ interface CreatePostInput {
     text: string;
     media_urls?: string[];
     /**
-     * ISO 8601 datetime to schedule the post (UTC). Must be in the future.
+     * ISO 8601 datetime to schedule the post. Must be in the future and carry a
+     * timezone — "2026-04-01T14:00:00Z" or "2026-04-01T16:00:00+02:00" both work
+     * and are normalized to UTC.
      * Scheduled posts publish within ~5 minutes of this time.
      */
     schedule_at?: string;
@@ -115,7 +150,9 @@ interface CreateThreadInput {
         media_urls?: string[];
     }[];
     /**
-     * ISO 8601 datetime to schedule the entire thread (UTC). Must be in the future.
+     * ISO 8601 datetime to schedule the entire thread. Must be in the future and
+     * carry a timezone — "2026-04-01T14:00:00Z" or "2026-04-01T16:00:00+02:00"
+     * both work and are normalized to UTC.
      * Scheduled threads publish within ~5 minutes of this time.
      */
     schedule_at?: string;
@@ -218,6 +255,26 @@ declare class ChirpieClient {
     connectAccount(): Promise<{
         authorization_url: string;
     }>;
+    /**
+     * Register your own X developer app so X accounts connect through it and
+     * post against your X API credits instead of Chirpie's. Link posts from
+     * accounts connected this way are not surcharged.
+     *
+     * Add the returned `redirect_uri` as a callback URI on your X app, then
+     * reconnect each X account you want to move onto your app — accounts that
+     * are already connected keep using whichever app connected them.
+     */
+    setXKeys(input: SetXKeysInput): Promise<SetXKeysResult>;
+    /**
+     * Remove your own X developer app. X accounts connected through it stop
+     * refreshing until you re-add the keys or reconnect them through Chirpie.
+     */
+    removeXKeys(): Promise<RemoveXKeysResult>;
+    /**
+     * Check whether your own X developer app is configured. Never returns the
+     * client secret.
+     */
+    getXKeysStatus(): Promise<XKeysStatus>;
     createKey(name?: string): Promise<{
         key: string;
         prefix: string;
@@ -263,4 +320,4 @@ declare function deleteConfig(): boolean;
  */
 declare function requireConfig(): ChirpieConfig;
 
-export { type ApiAccount, type ApiAnalytics, type ApiKeyInfo, type ApiPost, type ApiThread, ChirpieApiError, ChirpieClient, type ChirpieClientOptions, type ChirpieConfig, ChirpieError, type ConnectBlueskyInput, type ConnectFacebookInput, type ConnectGBPInput, type ConnectInstagramInput, type ConnectLinkedInInput, type ConnectMastodonInput, type ConnectPinterestInput, type ConnectRedditInput, type ConnectSnapchatInput, type ConnectTelegramInput, type ConnectThreadsInput, type ConnectTikTokInput, type ConnectYouTubeInput, type CreatePostInput, type CreateThreadInput, type ListPostsOptions, deleteConfig, getConfig, requireConfig, saveConfig };
+export { type ApiAccount, type ApiAnalytics, type ApiKeyInfo, type ApiPost, type ApiThread, ChirpieApiError, ChirpieClient, type ChirpieClientOptions, type ChirpieConfig, ChirpieError, type ConnectBlueskyInput, type ConnectFacebookInput, type ConnectGBPInput, type ConnectInstagramInput, type ConnectLinkedInInput, type ConnectMastodonInput, type ConnectPinterestInput, type ConnectRedditInput, type ConnectSnapchatInput, type ConnectTelegramInput, type ConnectThreadsInput, type ConnectTikTokInput, type ConnectYouTubeInput, type CreatePostInput, type CreateThreadInput, type ListPostsOptions, type RemoveXKeysResult, type SetXKeysInput, type SetXKeysResult, type XKeysStatus, deleteConfig, getConfig, requireConfig, saveConfig };

package/dist/index.js

@@ -213,6 +213,33 @@ var ChirpieClient = class {
   async connectAccount() {
     return this.connectXAccount();
   }
+  // Your own X developer app ("bring your own keys")
+  /**
+   * Register your own X developer app so X accounts connect through it and
+   * post against your X API credits instead of Chirpie's. Link posts from
+   * accounts connected this way are not surcharged.
+   *
+   * Add the returned `redirect_uri` as a callback URI on your X app, then
+   * reconnect each X account you want to move onto your app — accounts that
+   * are already connected keep using whichever app connected them.
+   */
+  async setXKeys(input) {
+    return this.request("PUT", "/accounts/x/keys", input);
+  }
+  /**
+   * Remove your own X developer app. X accounts connected through it stop
+   * refreshing until you re-add the keys or reconnect them through Chirpie.
+   */
+  async removeXKeys() {
+    return this.request("DELETE", "/accounts/x/keys");
+  }
+  /**
+   * Check whether your own X developer app is configured. Never returns the
+   * client secret.
+   */
+  async getXKeysStatus() {
+    return this.request("GET", "/accounts/x/keys");
+  }
   // Keys
   async createKey(name) {
     return this.request(

package/dist/index.mjs

@@ -181,6 +181,33 @@ var ChirpieClient = class {
   async connectAccount() {
     return this.connectXAccount();
   }
+  // Your own X developer app ("bring your own keys")
+  /**
+   * Register your own X developer app so X accounts connect through it and
+   * post against your X API credits instead of Chirpie's. Link posts from
+   * accounts connected this way are not surcharged.
+   *
+   * Add the returned `redirect_uri` as a callback URI on your X app, then
+   * reconnect each X account you want to move onto your app — accounts that
+   * are already connected keep using whichever app connected them.
+   */
+  async setXKeys(input) {
+    return this.request("PUT", "/accounts/x/keys", input);
+  }
+  /**
+   * Remove your own X developer app. X accounts connected through it stop
+   * refreshing until you re-add the keys or reconnect them through Chirpie.
+   */
+  async removeXKeys() {
+    return this.request("DELETE", "/accounts/x/keys");
+  }
+  /**
+   * Check whether your own X developer app is configured. Never returns the
+   * client secret.
+   */
+  async getXKeysStatus() {
+    return this.request("GET", "/accounts/x/keys");
+  }
   // Keys
   async createKey(name) {
     return this.request(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chirpie/sdk",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Chirpie SDK — TypeScript client for the Chirpie social media API",
   "repository": {
     "type": "git",