x-twitter-scraper 0.4.0 → 0.5.0

package/resources/x/write-actions.d.mts

@@ -17,32 +17,175 @@ export declare class WriteActions extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<WriteActionRetrieveResponse>;
 }
+/**
+ * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
+ * the original Idempotency-Key returns this same record. Submit a new write only
+ * when safeToRetry is true, using a new key.
+ */
 export interface WriteActionRetrieveResponse {
-    action: string;
+    id: string;
+    /**
+     * Connected account selected for the write.
+     */
+    account: WriteActionRetrieveResponse.Account | null;
+    action: 'create_tweet' | 'delete_tweet' | 'like' | 'unlike' | 'retweet' | 'unretweet' | 'follow' | 'unfollow' | 'remove_follower' | 'send_dm' | 'upload_media' | 'update_profile' | 'update_avatar' | 'update_banner' | 'create_community' | 'delete_community' | 'join_community' | 'leave_community';
+    /**
+     * plannedCredits is the approved maximum. chargedCredits comes from the settled
+     * credit ledger. Pending or failed writes are not charged.
+     */
+    billing: WriteActionRetrieveResponse.Billing;
     charged: boolean;
     chargedCredits: string;
-    createdAt: string;
-    media: WriteActionRetrieveResponse.Media;
-    retryable: false;
+    /**
+     * Exact follow-up an API client or agent should perform.
+     */
+    nextAction: WriteActionRetrieveResponse.NextAction | null;
+    object: 'x_write_action';
+    pollAfterMs: number | null;
+    /**
+     * Stable fingerprint and sanitized payload for replay checks.
+     */
+    request: WriteActionRetrieveResponse.Request;
+    /**
+     * Confirmed result produced by the write, when available.
+     */
+    result: WriteActionRetrieveResponse.Result | null;
+    /**
+     * True only when a new attempt can reasonably succeed.
+     */
+    retryable: boolean;
+    /**
+     * True only when no write was dispatched and a new idempotency key may be used.
+     */
+    safeToRetry: boolean;
     sendDispatched: boolean;
-    status: 'success' | 'failed' | 'pending_confirmation';
+    status: 'accepted' | 'dispatching' | 'pending_confirmation' | 'success' | 'failed' | 'expired';
+    statusUrl: string;
+    success: boolean;
+    /**
+     * Existing X resource targeted by the write, when applicable.
+     */
+    target: WriteActionRetrieveResponse.Target | null;
+    targetId: string | null;
+    terminal: boolean;
     writeActionId: string;
+    /**
+     * Compatibility field for a confirmed community ID.
+     */
+    communityId?: string;
+    /**
+     * Confirmed community name when available.
+     */
+    communityName?: string;
+    completedAt?: string;
     confirmationAttempts?: number;
     confirmationCheckedAt?: string;
-    confirmationSource?: string | null;
     confirmedAt?: string;
+    createdAt?: string;
+    /**
+     * Structured recovery context for a failed write.
+     */
+    details?: {
+        [key: string]: unknown;
+    };
+    error?: string;
+    /**
+     * Deadline for resolving a non-terminal write. This is not the Idempotency-Key
+     * retention deadline.
+     */
+    expiresAt?: string;
+    idempotent?: boolean;
+    /**
+     * Media count, kind, size, and billing details when used.
+     */
+    media?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Compatibility field for a confirmed media upload ID.
+     */
+    mediaId?: string;
+    /**
+     * Public media URL when the upload creates one.
+     */
+    mediaUrl?: string;
     message?: string;
+    /**
+     * Compatibility field for a confirmed direct message ID.
+     */
     messageId?: string;
+    requestHash?: string;
+    requestId?: string;
+    /**
+     * Compatibility result ID for other write actions.
+     */
+    resultId?: string;
+    /**
+     * Dispatch timestamp when the write reached execution.
+     */
     sendDispatchedAt?: string;
-    targetId?: string | null;
+    /**
+     * Compatibility field for a confirmed tweet result ID.
+     */
     tweetId?: string;
+    updatedAt?: string;
 }
 export declare namespace WriteActionRetrieveResponse {
-    interface Media {
-        count: number;
-        credits: string;
-        kind: 'none' | 'image' | 'video';
-        totalBytes: string;
+    /**
+     * Connected account selected for the write.
+     */
+    interface Account {
+        id: string;
+        username: string;
+    }
+    /**
+     * plannedCredits is the approved maximum. chargedCredits comes from the settled
+     * credit ledger. Pending or failed writes are not charged.
+     */
+    interface Billing {
+        charged: boolean;
+        chargedCredits: string;
+        plannedCredits: string;
+        status: 'not_charged' | 'pending' | 'charged' | 'charge_failed' | 'refunded';
+    }
+    /**
+     * Exact follow-up an API client or agent should perform.
+     */
+    interface NextAction {
+        type: 'poll' | 'retry' | 'verify_result' | 'fix_request';
+        afterMs?: number;
+        requiresNewIdempotencyKey?: boolean;
+        url?: string;
+    }
+    /**
+     * Stable fingerprint and sanitized payload for replay checks.
+     */
+    interface Request {
+        /**
+         * Stable hash of account, action, target, and payload.
+         */
+        hash: string | null;
+        /**
+         * Exact sanitized payload dispatched for this action.
+         */
+        payload: {
+            [key: string]: unknown;
+        } | null;
+    }
+    /**
+     * Confirmed result produced by the write, when available.
+     */
+    interface Result {
+        id?: string;
+        state?: string;
+        type?: 'tweet' | 'direct_message' | 'media' | 'community' | 'state_change';
+    }
+    /**
+     * Existing X resource targeted by the write, when applicable.
+     */
+    interface Target {
+        id: string;
+        type: 'tweet' | 'user' | 'community';
     }
 }
 export declare namespace WriteActions {

package/resources/x/write-actions.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"write-actions.d.mts","sourceRoot":"","sources":["../../src/resources/x/write-actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,2BAA2B,CAAC;CAGxF;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,EAAE,OAAO,CAAC;IAEjB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC;IAEzC,SAAS,EAAE,KAAK,CAAC;IAEjB,cAAc,EAAE,OAAO,CAAC;IAExB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,sBAAsB,CAAC;IAEtD,aAAa,EAAE,MAAM,CAAC;IAEtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yBAAiB,2BAA2B,CAAC;IAC3C,UAAiB,KAAK;QACpB,KAAK,EAAE,MAAM,CAAC;QAEd,OAAO,EAAE,MAAM,CAAC;QAEhB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QAEjC,UAAU,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;CAC5E"}
+{"version":3,"file":"write-actions.d.mts","sourceRoot":"","sources":["../../src/resources/x/write-actions.ts"],"names":[],"mappings":"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"}

package/resources/x/write-actions.d.ts

@@ -17,32 +17,175 @@ export declare class WriteActions extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<WriteActionRetrieveResponse>;
 }
+/**
+ * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
+ * the original Idempotency-Key returns this same record. Submit a new write only
+ * when safeToRetry is true, using a new key.
+ */
 export interface WriteActionRetrieveResponse {
-    action: string;
+    id: string;
+    /**
+     * Connected account selected for the write.
+     */
+    account: WriteActionRetrieveResponse.Account | null;
+    action: 'create_tweet' | 'delete_tweet' | 'like' | 'unlike' | 'retweet' | 'unretweet' | 'follow' | 'unfollow' | 'remove_follower' | 'send_dm' | 'upload_media' | 'update_profile' | 'update_avatar' | 'update_banner' | 'create_community' | 'delete_community' | 'join_community' | 'leave_community';
+    /**
+     * plannedCredits is the approved maximum. chargedCredits comes from the settled
+     * credit ledger. Pending or failed writes are not charged.
+     */
+    billing: WriteActionRetrieveResponse.Billing;
     charged: boolean;
     chargedCredits: string;
-    createdAt: string;
-    media: WriteActionRetrieveResponse.Media;
-    retryable: false;
+    /**
+     * Exact follow-up an API client or agent should perform.
+     */
+    nextAction: WriteActionRetrieveResponse.NextAction | null;
+    object: 'x_write_action';
+    pollAfterMs: number | null;
+    /**
+     * Stable fingerprint and sanitized payload for replay checks.
+     */
+    request: WriteActionRetrieveResponse.Request;
+    /**
+     * Confirmed result produced by the write, when available.
+     */
+    result: WriteActionRetrieveResponse.Result | null;
+    /**
+     * True only when a new attempt can reasonably succeed.
+     */
+    retryable: boolean;
+    /**
+     * True only when no write was dispatched and a new idempotency key may be used.
+     */
+    safeToRetry: boolean;
     sendDispatched: boolean;
-    status: 'success' | 'failed' | 'pending_confirmation';
+    status: 'accepted' | 'dispatching' | 'pending_confirmation' | 'success' | 'failed' | 'expired';
+    statusUrl: string;
+    success: boolean;
+    /**
+     * Existing X resource targeted by the write, when applicable.
+     */
+    target: WriteActionRetrieveResponse.Target | null;
+    targetId: string | null;
+    terminal: boolean;
     writeActionId: string;
+    /**
+     * Compatibility field for a confirmed community ID.
+     */
+    communityId?: string;
+    /**
+     * Confirmed community name when available.
+     */
+    communityName?: string;
+    completedAt?: string;
     confirmationAttempts?: number;
     confirmationCheckedAt?: string;
-    confirmationSource?: string | null;
     confirmedAt?: string;
+    createdAt?: string;
+    /**
+     * Structured recovery context for a failed write.
+     */
+    details?: {
+        [key: string]: unknown;
+    };
+    error?: string;
+    /**
+     * Deadline for resolving a non-terminal write. This is not the Idempotency-Key
+     * retention deadline.
+     */
+    expiresAt?: string;
+    idempotent?: boolean;
+    /**
+     * Media count, kind, size, and billing details when used.
+     */
+    media?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Compatibility field for a confirmed media upload ID.
+     */
+    mediaId?: string;
+    /**
+     * Public media URL when the upload creates one.
+     */
+    mediaUrl?: string;
     message?: string;
+    /**
+     * Compatibility field for a confirmed direct message ID.
+     */
     messageId?: string;
+    requestHash?: string;
+    requestId?: string;
+    /**
+     * Compatibility result ID for other write actions.
+     */
+    resultId?: string;
+    /**
+     * Dispatch timestamp when the write reached execution.
+     */
     sendDispatchedAt?: string;
-    targetId?: string | null;
+    /**
+     * Compatibility field for a confirmed tweet result ID.
+     */
     tweetId?: string;
+    updatedAt?: string;
 }
 export declare namespace WriteActionRetrieveResponse {
-    interface Media {
-        count: number;
-        credits: string;
-        kind: 'none' | 'image' | 'video';
-        totalBytes: string;
+    /**
+     * Connected account selected for the write.
+     */
+    interface Account {
+        id: string;
+        username: string;
+    }
+    /**
+     * plannedCredits is the approved maximum. chargedCredits comes from the settled
+     * credit ledger. Pending or failed writes are not charged.
+     */
+    interface Billing {
+        charged: boolean;
+        chargedCredits: string;
+        plannedCredits: string;
+        status: 'not_charged' | 'pending' | 'charged' | 'charge_failed' | 'refunded';
+    }
+    /**
+     * Exact follow-up an API client or agent should perform.
+     */
+    interface NextAction {
+        type: 'poll' | 'retry' | 'verify_result' | 'fix_request';
+        afterMs?: number;
+        requiresNewIdempotencyKey?: boolean;
+        url?: string;
+    }
+    /**
+     * Stable fingerprint and sanitized payload for replay checks.
+     */
+    interface Request {
+        /**
+         * Stable hash of account, action, target, and payload.
+         */
+        hash: string | null;
+        /**
+         * Exact sanitized payload dispatched for this action.
+         */
+        payload: {
+            [key: string]: unknown;
+        } | null;
+    }
+    /**
+     * Confirmed result produced by the write, when available.
+     */
+    interface Result {
+        id?: string;
+        state?: string;
+        type?: 'tweet' | 'direct_message' | 'media' | 'community' | 'state_change';
+    }
+    /**
+     * Existing X resource targeted by the write, when applicable.
+     */
+    interface Target {
+        id: string;
+        type: 'tweet' | 'user' | 'community';
     }
 }
 export declare namespace WriteActions {

package/resources/x/write-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-actions.d.ts","sourceRoot":"","sources":["../../src/resources/x/write-actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,2BAA2B,CAAC;CAGxF;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,EAAE,OAAO,CAAC;IAEjB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC;IAEzC,SAAS,EAAE,KAAK,CAAC;IAEjB,cAAc,EAAE,OAAO,CAAC;IAExB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,sBAAsB,CAAC;IAEtD,aAAa,EAAE,MAAM,CAAC;IAEtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yBAAiB,2BAA2B,CAAC;IAC3C,UAAiB,KAAK;QACpB,KAAK,EAAE,MAAM,CAAC;QAEd,OAAO,EAAE,MAAM,CAAC;QAEhB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QAEjC,UAAU,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;CAC5E"}
+{"version":3,"file":"write-actions.d.ts","sourceRoot":"","sources":["../../src/resources/x/write-actions.ts"],"names":[],"mappings":"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"}

package/src/resources/credits.ts

@@ -146,7 +146,7 @@ export interface CreditRedirectTopupCheckoutParams {
 
 export interface CreditRetrieveTopupStatusParams {
   /**
-   * Billing session ID returned by the top-up billing flow.
+   * Top-up session ID to inspect.
    */
   session_id: string;
 }

package/src/resources/extractions.ts

@@ -453,7 +453,7 @@ export interface ExtractionEstimateCostParams {
   retweetsOfTweetId?: string;
 
   /**
-   * Required for tweet_search_extractor & community_search.
+   * Query used to price tweet_search_extractor or community_search.
    */
   searchQuery?: string;
 
@@ -463,18 +463,18 @@ export interface ExtractionEstimateCostParams {
   sinceDate?: string;
 
   /**
-   * Required for community_post_extractor & community_search.
+   * Community ID used to price community_post_extractor or community_search.
    */
   targetCommunityId?: string;
 
   /**
-   * Required for list_follower_explorer, list_member_extractor &
+   * List ID used to price list_follower_explorer, list_member_extractor, or
    * list_post_extractor.
    */
   targetListId?: string;
 
   /**
-   * Required for space_explorer.
+   * Space ID used to price space_explorer.
    */
   targetSpaceId?: string;
 

package/src/resources/guest-wallets.ts

@@ -289,7 +289,7 @@ export namespace GuestWalletTopupResponse {
 
 export interface GuestWalletCreateParams {
   /**
-   * Body param: Confirmed USD amount in cents.
+   * Body param: USD cents accepted for this checkout.
    */
   amount_minor: number;
 
@@ -308,7 +308,7 @@ export interface GuestWalletCreateParams {
 
 export interface GuestWalletTopupParams {
   /**
-   * Body param: Confirmed USD amount in cents.
+   * Body param: USD cents accepted for this checkout.
    */
   amount_minor: number;
 

package/src/resources/shared.ts

@@ -149,6 +149,39 @@ export interface Error {
     | 'unauthenticated'
     | 'unsupported_field'
     | 'user_not_found'
+    | 'body_too_large'
+    | 'checkout_unavailable'
+    | 'connection_challenge_expired'
+    | 'connection_challenge_inactive'
+    | 'draft_not_found'
+    | 'favoriters_unavailable'
+    | 'forbidden'
+    | 'guest_wallet_unavailable'
+    | 'guest_wallets_disabled'
+    | 'guest_wallets_unavailable'
+    | 'idempotency_conflict'
+    | 'idempotency_key_conflict'
+    | 'invalid_community_id'
+    | 'invalid_idempotency_key'
+    | 'invalid_list_id'
+    | 'invalid_payment_amount'
+    | 'invalid_range'
+    | 'login_rate_limited'
+    | 'missing_idempotency_key'
+    | 'missing_ids'
+    | 'no_cached_style'
+    | 'passkey_required'
+    | 'rate_limited'
+    | 'read_request_timeout'
+    | 'replies_incomplete'
+    | 'support_media_rate_limit'
+    | 'support_request_rate_limit'
+    | 'too_many_ids'
+    | 'unknown_field'
+    | 'unsupported_media_type'
+    | 'webhook_inactive'
+    | 'write_tracking_unavailable'
+    | 'x_write_unconfirmed'
     | 'x_account_feature_required'
     | 'x_account_protected'
     | 'x_account_suspended'
@@ -175,8 +208,27 @@ export interface Error {
     | 'x_user_lookup_failed'
     | 'x_write_ambiguous'
     | 'x_write_failed'
-    | 'x_write_unconfirmed'
     | Error.StructuredError;
+
+  /**
+   * Human-readable error guidance.
+   */
+  message?: string;
+
+  /**
+   * Machine-readable reason for a login cooldown.
+   */
+  reason?: string;
+
+  /**
+   * Seconds until the next permitted request.
+   */
+  retryAfter?: number;
+
+  /**
+   * Required wait in milliseconds.
+   */
+  retryAfterMs?: number;
 }
 
 export namespace Error {
@@ -222,6 +274,39 @@ export namespace Error {
       | 'unauthenticated'
       | 'unsupported_field'
       | 'user_not_found'
+      | 'body_too_large'
+      | 'checkout_unavailable'
+      | 'connection_challenge_expired'
+      | 'connection_challenge_inactive'
+      | 'draft_not_found'
+      | 'favoriters_unavailable'
+      | 'forbidden'
+      | 'guest_wallet_unavailable'
+      | 'guest_wallets_disabled'
+      | 'guest_wallets_unavailable'
+      | 'idempotency_conflict'
+      | 'idempotency_key_conflict'
+      | 'invalid_community_id'
+      | 'invalid_idempotency_key'
+      | 'invalid_list_id'
+      | 'invalid_payment_amount'
+      | 'invalid_range'
+      | 'login_rate_limited'
+      | 'missing_idempotency_key'
+      | 'missing_ids'
+      | 'no_cached_style'
+      | 'passkey_required'
+      | 'rate_limited'
+      | 'read_request_timeout'
+      | 'replies_incomplete'
+      | 'support_media_rate_limit'
+      | 'support_request_rate_limit'
+      | 'too_many_ids'
+      | 'unknown_field'
+      | 'unsupported_media_type'
+      | 'webhook_inactive'
+      | 'write_tracking_unavailable'
+      | 'x_write_unconfirmed'
       | 'x_account_feature_required'
       | 'x_account_protected'
       | 'x_account_suspended'
@@ -247,8 +332,7 @@ export namespace Error {
       | 'x_transient_error'
       | 'x_user_lookup_failed'
       | 'x_write_ambiguous'
-      | 'x_write_failed'
-      | 'x_write_unconfirmed';
+      | 'x_write_failed';
 
     message: string;
 
@@ -359,7 +443,7 @@ export interface SearchTweet {
   createdAt?: string;
 
   /**
-   * Start and end offsets for rendered tweet text
+   * Rendered text's start and end offsets.
    */
   displayTextRange?: Array<number>;
 
@@ -370,17 +454,17 @@ export interface SearchTweet {
   entities?: { [key: string]: unknown };
 
   /**
-   * Tweet ID being replied to
+   * ID of the tweet this result replies to.
    */
   inReplyToId?: string;
 
   /**
-   * User ID being replied to
+   * ID of the user this result replies to.
    */
   inReplyToUserId?: string;
 
   /**
-   * Username being replied to
+   * Username this result replies to.
    */
   inReplyToUsername?: string;
 
@@ -405,7 +489,7 @@ export interface SearchTweet {
   isReply?: boolean;
 
   /**
-   * Tweet language code
+   * Search result language code.
    */
   lang?: string;
 
@@ -436,7 +520,7 @@ export interface SearchTweet {
   type?: string;
 
   /**
-   * Tweet permalink URL
+   * Search result permalink.
    */
   url?: string;
 }