x-twitter-scraper 0.1.0 → 0.2.1

package/resources/x/tweets/like.d.mts

@@ -7,12 +7,26 @@ import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Like extends APIResource {
     /**
      * Like tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID: string, body: LikeCreateParams, options?: RequestOptions): APIPromise<LikeCreateResponse>;
+    create(id: string, body: LikeCreateParams, options?: RequestOptions): APIPromise<LikeCreateResponse>;
     /**
      * Unlike tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID: string, body: LikeDeleteParams, options?: RequestOptions): APIPromise<LikeDeleteResponse>;
+    delete(id: string, body: LikeDeleteParams, options?: RequestOptions): APIPromise<LikeDeleteResponse>;
 }
 export interface LikeCreateResponse {
     success: true;
@@ -22,13 +36,13 @@ export interface LikeDeleteResponse {
 }
 export interface LikeCreateParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }
 export interface LikeDeleteParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }

package/resources/x/tweets/like.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"like.d.mts","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIzG;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAG1G;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}
+{"version":3,"file":"like.d.mts","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIpG;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAGrG;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}

package/resources/x/tweets/like.d.ts

@@ -7,12 +7,26 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Like extends APIResource {
     /**
      * Like tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID: string, body: LikeCreateParams, options?: RequestOptions): APIPromise<LikeCreateResponse>;
+    create(id: string, body: LikeCreateParams, options?: RequestOptions): APIPromise<LikeCreateResponse>;
     /**
      * Unlike tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID: string, body: LikeDeleteParams, options?: RequestOptions): APIPromise<LikeDeleteResponse>;
+    delete(id: string, body: LikeDeleteParams, options?: RequestOptions): APIPromise<LikeDeleteResponse>;
 }
 export interface LikeCreateResponse {
     success: true;
@@ -22,13 +36,13 @@ export interface LikeDeleteResponse {
 }
 export interface LikeCreateParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }
 export interface LikeDeleteParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }

package/resources/x/tweets/like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIzG;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAG1G;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}
+{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIpG;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAGrG;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}

package/resources/x/tweets/like.js

@@ -10,15 +10,29 @@ const path_1 = require("../../../internal/utils/path.js");
 class Like extends resource_1.APIResource {
     /**
      * Like tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID, body, options) {
-        return this._client.post((0, path_1.path) `/x/tweets/${tweetID}/like`, { body, ...options });
+    create(id, body, options) {
+        return this._client.post((0, path_1.path) `/x/tweets/${id}/like`, { body, ...options });
     }
     /**
      * Unlike tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID, body, options) {
-        return this._client.delete((0, path_1.path) `/x/tweets/${tweetID}/like`, { body, ...options });
+    delete(id, body, options) {
+        return this._client.delete((0, path_1.path) `/x/tweets/${id}/like`, { body, ...options });
     }
 }
 exports.Like = Like;

package/resources/x/tweets/like.js.map

@@ -1 +1 @@
-{"version":3,"file":"like.js","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IACnC;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,IAAsB,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,IAAsB,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AAdD,oBAcC"}
+{"version":3,"file":"like.js","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AA5BD,oBA4BC"}

package/resources/x/tweets/like.mjs

@@ -7,15 +7,29 @@ import { path } from "../../../internal/utils/path.mjs";
 export class Like extends APIResource {
     /**
      * Like tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID, body, options) {
-        return this._client.post(path `/x/tweets/${tweetID}/like`, { body, ...options });
+    create(id, body, options) {
+        return this._client.post(path `/x/tweets/${id}/like`, { body, ...options });
     }
     /**
      * Unlike tweet
+     *
+     * @example
+     * ```ts
+     * const like = await client.x.tweets.like.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID, body, options) {
-        return this._client.delete(path `/x/tweets/${tweetID}/like`, { body, ...options });
+    delete(id, body, options) {
+        return this._client.delete(path `/x/tweets/${id}/like`, { body, ...options });
     }
 }
 //# sourceMappingURL=like.mjs.map

package/resources/x/tweets/like.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"like.mjs","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,IAAsB,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,IAAsB,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}
+{"version":3,"file":"like.mjs","sourceRoot":"","sources":["../../../src/resources/x/tweets/like.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/resources/x/tweets/retweet.d.mts

@@ -7,12 +7,26 @@ import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Retweet extends APIResource {
     /**
      * Retweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID: string, body: RetweetCreateParams, options?: RequestOptions): APIPromise<RetweetCreateResponse>;
+    create(id: string, body: RetweetCreateParams, options?: RequestOptions): APIPromise<RetweetCreateResponse>;
     /**
      * Unretweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID: string, body: RetweetDeleteParams, options?: RequestOptions): APIPromise<RetweetDeleteResponse>;
+    delete(id: string, body: RetweetDeleteParams, options?: RequestOptions): APIPromise<RetweetDeleteResponse>;
 }
 export interface RetweetCreateResponse {
     success: true;
@@ -22,13 +36,13 @@ export interface RetweetDeleteResponse {
 }
 export interface RetweetCreateParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }
 export interface RetweetDeleteParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }

package/resources/x/tweets/retweet.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"retweet.d.mts","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;CAGrC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
+{"version":3,"file":"retweet.d.mts","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAI1G;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG3G;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/x/tweets/retweet.d.ts

@@ -7,12 +7,26 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Retweet extends APIResource {
     /**
      * Retweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID: string, body: RetweetCreateParams, options?: RequestOptions): APIPromise<RetweetCreateResponse>;
+    create(id: string, body: RetweetCreateParams, options?: RequestOptions): APIPromise<RetweetCreateResponse>;
     /**
      * Unretweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID: string, body: RetweetDeleteParams, options?: RequestOptions): APIPromise<RetweetDeleteResponse>;
+    delete(id: string, body: RetweetDeleteParams, options?: RequestOptions): APIPromise<RetweetDeleteResponse>;
 }
 export interface RetweetCreateResponse {
     success: true;
@@ -22,13 +36,13 @@ export interface RetweetDeleteResponse {
 }
 export interface RetweetCreateParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }
 export interface RetweetDeleteParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }

package/resources/x/tweets/retweet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retweet.d.ts","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;CAGrC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
+{"version":3,"file":"retweet.d.ts","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAI1G;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG3G;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/x/tweets/retweet.js

@@ -10,15 +10,29 @@ const path_1 = require("../../../internal/utils/path.js");
 class Retweet extends resource_1.APIResource {
     /**
      * Retweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID, body, options) {
-        return this._client.post((0, path_1.path) `/x/tweets/${tweetID}/retweet`, { body, ...options });
+    create(id, body, options) {
+        return this._client.post((0, path_1.path) `/x/tweets/${id}/retweet`, { body, ...options });
     }
     /**
      * Unretweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID, body, options) {
-        return this._client.delete((0, path_1.path) `/x/tweets/${tweetID}/retweet`, { body, ...options });
+    delete(id, body, options) {
+        return this._client.delete((0, path_1.path) `/x/tweets/${id}/retweet`, { body, ...options });
     }
 }
 exports.Retweet = Retweet;

package/resources/x/tweets/retweet.js.map

@@ -1 +1 @@
-{"version":3,"file":"retweet.js","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,MAAM,CACJ,OAAe,EACf,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,OAAe,EACf,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;CACF;AAtBD,0BAsBC"}
+{"version":3,"file":"retweet.js","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;CACF;AA5BD,0BA4BC"}

package/resources/x/tweets/retweet.mjs

@@ -7,15 +7,29 @@ import { path } from "../../../internal/utils/path.mjs";
 export class Retweet extends APIResource {
     /**
      * Retweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.create('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    create(tweetID, body, options) {
-        return this._client.post(path `/x/tweets/${tweetID}/retweet`, { body, ...options });
+    create(id, body, options) {
+        return this._client.post(path `/x/tweets/${id}/retweet`, { body, ...options });
     }
     /**
      * Unretweet
+     *
+     * @example
+     * ```ts
+     * const retweet = await client.x.tweets.retweet.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID, body, options) {
-        return this._client.delete(path `/x/tweets/${tweetID}/retweet`, { body, ...options });
+    delete(id, body, options) {
+        return this._client.delete(path `/x/tweets/${id}/retweet`, { body, ...options });
     }
 }
 //# sourceMappingURL=retweet.mjs.map

package/resources/x/tweets/retweet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retweet.mjs","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,MAAM,CACJ,OAAe,EACf,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,OAAe,EACf,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;CACF"}
+{"version":3,"file":"retweet.mjs","sourceRoot":"","sources":["../../../src/resources/x/tweets/retweet.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}

package/resources/x/tweets/tweets.d.mts

@@ -11,51 +11,127 @@ export declare class Tweets extends APIResource {
     retweet: RetweetAPI.Retweet;
     /**
      * Create tweet
+     *
+     * @example
+     * ```ts
+     * const tweet = await client.x.tweets.create({
+     *   account: '@elonmusk',
+     *   text: 'Just launched our new feature!',
+     * });
+     * ```
      */
     create(body: TweetCreateParams, options?: RequestOptions): APIPromise<TweetCreateResponse>;
     /**
      * Look up tweet
+     *
+     * @example
+     * ```ts
+     * const tweet = await client.x.tweets.retrieve('id');
+     * ```
      */
-    retrieve(tweetID: string, options?: RequestOptions): APIPromise<TweetRetrieveResponse>;
+    retrieve(id: string, options?: RequestOptions): APIPromise<TweetRetrieveResponse>;
     /**
      * Get multiple tweets by IDs
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets = await client.x.tweets.list({
+     *   ids: 'ids',
+     * });
+     * ```
      */
-    list(query: TweetListParams, options?: RequestOptions): APIPromise<void>;
+    list(query: TweetListParams, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
      * Delete tweet
+     *
+     * @example
+     * ```ts
+     * const tweet = await client.x.tweets.delete('id', {
+     *   account: '@elonmusk',
+     * });
+     * ```
      */
-    delete(tweetID: string, body: TweetDeleteParams, options?: RequestOptions): APIPromise<TweetDeleteResponse>;
+    delete(id: string, body: TweetDeleteParams, options?: RequestOptions): APIPromise<TweetDeleteResponse>;
     /**
      * Get users who liked a tweet
+     *
+     * @example
+     * ```ts
+     * const paginatedUsers = await client.x.tweets.getFavoriters(
+     *   'id',
+     * );
+     * ```
      */
     getFavoriters(id: string, query?: TweetGetFavoritersParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
     /**
      * Get quote tweets of a tweet
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets = await client.x.tweets.getQuotes(
+     *   'id',
+     * );
+     * ```
      */
     getQuotes(id: string, query?: TweetGetQuotesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
      * Get replies to a tweet
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets = await client.x.tweets.getReplies(
+     *   'id',
+     * );
+     * ```
      */
     getReplies(id: string, query?: TweetGetRepliesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
      * Get users who retweeted a tweet
+     *
+     * @example
+     * ```ts
+     * const paginatedUsers = await client.x.tweets.getRetweeters(
+     *   'id',
+     * );
+     * ```
      */
     getRetweeters(id: string, query?: TweetGetRetweetersParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
     /**
      * Get thread context for a tweet
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets = await client.x.tweets.getThread(
+     *   'id',
+     * );
+     * ```
      */
     getThread(id: string, query?: TweetGetThreadParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
      * Search tweets
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets = await client.x.tweets.search({
+     *   q: 'q',
+     * });
+     * ```
      */
     search(query: TweetSearchParams, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
 }
+/**
+ * Tweet returned from search results with inline author info.
+ */
 export interface SearchTweet {
     id: string;
     text: string;
     author?: SearchTweet.Author;
     bookmarkCount?: number;
     createdAt?: string;
+    /**
+     * True for Note Tweets (long-form content, up to 25,000 characters)
+     */
+    isNoteTweet?: boolean;
     likeCount?: number;
     quoteCount?: number;
     replyCount?: number;
@@ -70,6 +146,9 @@ export declare namespace SearchTweet {
         verified?: boolean;
     }
 }
+/**
+ * Author of a tweet with follower count and verification status.
+ */
 export interface TweetAuthor {
     id: string;
     followers: number;
@@ -77,6 +156,9 @@ export interface TweetAuthor {
     verified: boolean;
     profilePicture?: string;
 }
+/**
+ * Full tweet with text, engagement metrics, media, and metadata.
+ */
 export interface TweetDetail {
     id: string;
     bookmarkCount: number;
@@ -86,14 +168,63 @@ export interface TweetDetail {
     retweetCount: number;
     text: string;
     viewCount: number;
+    /**
+     * ID of the root tweet in the conversation thread
+     */
+    conversationId?: string;
     createdAt?: string;
+    /**
+     * Parsed entities from the tweet text (URLs, mentions, hashtags, media)
+     */
+    entities?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Whether this is a Note Tweet (long-form post, up to 25,000 characters)
+     */
+    isNoteTweet?: boolean;
+    /**
+     * Whether this tweet quotes another tweet
+     */
+    isQuoteStatus?: boolean;
+    /**
+     * Whether this tweet is a reply to another tweet
+     */
+    isReply?: boolean;
+    /**
+     * Attached media items, omitted when the tweet has no media
+     */
+    media?: Array<TweetDetail.Media>;
+    /**
+     * The quoted tweet object, present when isQuoteStatus is true
+     */
+    quoted_tweet?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Client application used to post this tweet
+     */
+    source?: string;
+}
+export declare namespace TweetDetail {
+    interface Media {
+        mediaUrl?: string;
+        type?: 'photo' | 'video' | 'animated_gif';
+        url?: string;
+    }
 }
 export interface TweetCreateResponse {
     success: true;
     tweetId: string;
 }
 export interface TweetRetrieveResponse {
+    /**
+     * Full tweet with text, engagement metrics, media, and metadata.
+     */
     tweet: TweetDetail;
+    /**
+     * Author of a tweet with follower count and verification status.
+     */
     author?: TweetAuthor;
 }
 export interface TweetDeleteResponse {
@@ -119,57 +250,57 @@ export interface TweetListParams {
 }
 export interface TweetDeleteParams {
     /**
-     * X account (@username or account ID)
+     * X account identifier (@username or account ID)
      */
     account: string;
 }
 export interface TweetGetFavoritersParams {
     /**
-     * Pagination cursor from previous response
+     * Pagination cursor for favoriters
      */
     cursor?: string;
 }
 export interface TweetGetQuotesParams {
     /**
-     * Pagination cursor
+     * Pagination cursor for quote tweets
      */
     cursor?: string;
     /**
-     * Include replies (default false)
+     * Include reply quotes (default false)
      */
     includeReplies?: boolean;
     /**
-     * Unix timestamp - filter after
+     * Unix timestamp - return quotes posted after this time
      */
     sinceTime?: string;
     /**
-     * Unix timestamp - filter before
+     * Unix timestamp - return quotes posted before this time
      */
     untilTime?: string;
 }
 export interface TweetGetRepliesParams {
     /**
-     * Pagination cursor
+     * Pagination cursor for tweet replies
      */
     cursor?: string;
     /**
-     * Unix timestamp - filter after
+     * Unix timestamp - return replies posted after this time
      */
     sinceTime?: string;
     /**
-     * Unix timestamp - filter before
+     * Unix timestamp - return replies posted before this time
      */
     untilTime?: string;
 }
 export interface TweetGetRetweetersParams {
     /**
-     * Pagination cursor
+     * Pagination cursor for retweeters
      */
     cursor?: string;
 }
 export interface TweetGetThreadParams {
     /**
-     * Pagination cursor
+     * Pagination cursor for thread tweets
      */
     cursor?: string;
 }
@@ -183,7 +314,7 @@ export interface TweetSearchParams {
      */
     cursor?: string;
     /**
-     * Deprecated — use cursor-based pagination instead
+     * Max tweets to return (server paginates internally). Omit for single page (~20).
      */
     limit?: number;
     /**