scrapebadger 0.1.4 → 0.1.6

package/dist/{index-BMStDLm1.d.cts → index-qYk-iloT.d.cts}

@@ -192,7 +192,9 @@ interface Url {
  */
 interface Hashtag {
     /** The hashtag text (without #) */
-    tag: string;
+    text: string;
+    /** Character positions of the hashtag in the tweet text */
+    indices?: number[] | null;
 }
 /**
  * A user mention entity in tweet text.
@@ -853,6 +855,56 @@ declare class TweetsClient {
      * ```
      */
     getSimilar(tweetId: string): Promise<PaginatedResponse<Tweet>>;
+    /**
+     * Get tweets that quote a specific tweet.
+     *
+     * @param tweetId - The tweet ID to get quote tweets for.
+     * @param options - Pagination options.
+     * @returns Paginated response containing tweets that quote this tweet.
+     *
+     * @example
+     * ```typescript
+     * const quotes = await client.twitter.tweets.getQuotes("1234567890");
+     * for (const quote of quotes.data) {
+     *   console.log(`@${quote.username} quoted: ${quote.text.slice(0, 100)}...`);
+     * }
+     *
+     * // Get next page
+     * if (quotes.hasMore) {
+     *   const more = await client.twitter.tweets.getQuotes("1234567890", {
+     *     cursor: quotes.nextCursor
+     *   });
+     * }
+     * ```
+     */
+    getQuotes(tweetId: string, options?: PaginationOptions): Promise<PaginatedResponse<Tweet>>;
+    /**
+     * Iterate through all quote tweets with automatic pagination.
+     *
+     * This is a convenience method that automatically handles pagination,
+     * yielding quote tweets one at a time.
+     *
+     * @param tweetId - The tweet ID to get quote tweets for.
+     * @param options - Iteration options.
+     * @yields Tweet objects that quote the specified tweet.
+     *
+     * @example
+     * ```typescript
+     * // Get all quote tweets (up to 500)
+     * for await (const quote of client.twitter.tweets.getQuotesAll("1234567890", {
+     *   maxItems: 500
+     * })) {
+     *   console.log(`@${quote.username}: ${quote.text}`);
+     * }
+     *
+     * // Collect into an array
+     * import { collectAll } from "scrapebadger";
+     * const quotes = await collectAll(
+     *   client.twitter.tweets.getQuotesAll("1234567890", { maxItems: 100 })
+     * );
+     * ```
+     */
+    getQuotesAll(tweetId: string, options?: IteratorOptions): AsyncGenerator<Tweet, void, undefined>;
     /**
      * Search for tweets.
      *

package/dist/{index-BMStDLm1.d.ts → index-qYk-iloT.d.ts}

@@ -192,7 +192,9 @@ interface Url {
  */
 interface Hashtag {
     /** The hashtag text (without #) */
-    tag: string;
+    text: string;
+    /** Character positions of the hashtag in the tweet text */
+    indices?: number[] | null;
 }
 /**
  * A user mention entity in tweet text.
@@ -853,6 +855,56 @@ declare class TweetsClient {
      * ```
      */
     getSimilar(tweetId: string): Promise<PaginatedResponse<Tweet>>;
+    /**
+     * Get tweets that quote a specific tweet.
+     *
+     * @param tweetId - The tweet ID to get quote tweets for.
+     * @param options - Pagination options.
+     * @returns Paginated response containing tweets that quote this tweet.
+     *
+     * @example
+     * ```typescript
+     * const quotes = await client.twitter.tweets.getQuotes("1234567890");
+     * for (const quote of quotes.data) {
+     *   console.log(`@${quote.username} quoted: ${quote.text.slice(0, 100)}...`);
+     * }
+     *
+     * // Get next page
+     * if (quotes.hasMore) {
+     *   const more = await client.twitter.tweets.getQuotes("1234567890", {
+     *     cursor: quotes.nextCursor
+     *   });
+     * }
+     * ```
+     */
+    getQuotes(tweetId: string, options?: PaginationOptions): Promise<PaginatedResponse<Tweet>>;
+    /**
+     * Iterate through all quote tweets with automatic pagination.
+     *
+     * This is a convenience method that automatically handles pagination,
+     * yielding quote tweets one at a time.
+     *
+     * @param tweetId - The tweet ID to get quote tweets for.
+     * @param options - Iteration options.
+     * @yields Tweet objects that quote the specified tweet.
+     *
+     * @example
+     * ```typescript
+     * // Get all quote tweets (up to 500)
+     * for await (const quote of client.twitter.tweets.getQuotesAll("1234567890", {
+     *   maxItems: 500
+     * })) {
+     *   console.log(`@${quote.username}: ${quote.text}`);
+     * }
+     *
+     * // Collect into an array
+     * import { collectAll } from "scrapebadger";
+     * const quotes = await collectAll(
+     *   client.twitter.tweets.getQuotesAll("1234567890", { maxItems: 100 })
+     * );
+     * ```
+     */
+    getQuotesAll(tweetId: string, options?: IteratorOptions): AsyncGenerator<Tweet, void, undefined>;
     /**
      * Search for tweets.
      *

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { T as TwitterClient, S as ScrapeBadgerConfig } from './index-BMStDLm1.cjs';
-export { A as ApiResponse, C as CommunitiesClient, t as Community, r as CommunityBanner, u as CommunityMember, s as CommunityRule, g as CommunityTweetType, G as GeoClient, e as GeoSearchOptions, H as Hashtag, I as IteratorOptions, q as List, z as ListResponse, L as ListsClient, w as Location, M as Media, P as PaginatedResponse, a as PaginationOptions, y as Place, x as PlaceTrends, i as Poll, h as PollOption, Q as QueryType, R as ResolvedConfig, v as Trend, f as TrendCategory, d as TrendsClient, m as Tweet, l as TweetPlace, b as TweetsClient, j as Url, n as User, o as UserAbout, p as UserIds, k as UserMention, U as UsersClient, c as collectAll } from './index-BMStDLm1.cjs';
+import { T as TwitterClient, S as ScrapeBadgerConfig } from './index-qYk-iloT.cjs';
+export { A as ApiResponse, C as CommunitiesClient, t as Community, r as CommunityBanner, u as CommunityMember, s as CommunityRule, g as CommunityTweetType, G as GeoClient, e as GeoSearchOptions, H as Hashtag, I as IteratorOptions, q as List, z as ListResponse, L as ListsClient, w as Location, M as Media, P as PaginatedResponse, a as PaginationOptions, y as Place, x as PlaceTrends, i as Poll, h as PollOption, Q as QueryType, R as ResolvedConfig, v as Trend, f as TrendCategory, d as TrendsClient, m as Tweet, l as TweetPlace, b as TweetsClient, j as Url, n as User, o as UserAbout, p as UserIds, k as UserMention, U as UsersClient, c as collectAll } from './index-qYk-iloT.cjs';
 
 /**
  * Main ScrapeBadger client.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as TwitterClient, S as ScrapeBadgerConfig } from './index-BMStDLm1.js';
-export { A as ApiResponse, C as CommunitiesClient, t as Community, r as CommunityBanner, u as CommunityMember, s as CommunityRule, g as CommunityTweetType, G as GeoClient, e as GeoSearchOptions, H as Hashtag, I as IteratorOptions, q as List, z as ListResponse, L as ListsClient, w as Location, M as Media, P as PaginatedResponse, a as PaginationOptions, y as Place, x as PlaceTrends, i as Poll, h as PollOption, Q as QueryType, R as ResolvedConfig, v as Trend, f as TrendCategory, d as TrendsClient, m as Tweet, l as TweetPlace, b as TweetsClient, j as Url, n as User, o as UserAbout, p as UserIds, k as UserMention, U as UsersClient, c as collectAll } from './index-BMStDLm1.js';
+import { T as TwitterClient, S as ScrapeBadgerConfig } from './index-qYk-iloT.js';
+export { A as ApiResponse, C as CommunitiesClient, t as Community, r as CommunityBanner, u as CommunityMember, s as CommunityRule, g as CommunityTweetType, G as GeoClient, e as GeoSearchOptions, H as Hashtag, I as IteratorOptions, q as List, z as ListResponse, L as ListsClient, w as Location, M as Media, P as PaginatedResponse, a as PaginationOptions, y as Place, x as PlaceTrends, i as Poll, h as PollOption, Q as QueryType, R as ResolvedConfig, v as Trend, f as TrendCategory, d as TrendsClient, m as Tweet, l as TweetPlace, b as TweetsClient, j as Url, n as User, o as UserAbout, p as UserIds, k as UserMention, U as UsersClient, c as collectAll } from './index-qYk-iloT.js';
 
 /**
  * Main ScrapeBadger client.

package/dist/index.js

@@ -430,6 +430,67 @@ var TweetsClient = class {
     );
     return createPaginatedResponse(response.data ?? [], response.next_cursor);
   }
+  /**
+   * Get tweets that quote a specific tweet.
+   *
+   * @param tweetId - The tweet ID to get quote tweets for.
+   * @param options - Pagination options.
+   * @returns Paginated response containing tweets that quote this tweet.
+   *
+   * @example
+   * ```typescript
+   * const quotes = await client.twitter.tweets.getQuotes("1234567890");
+   * for (const quote of quotes.data) {
+   *   console.log(`@${quote.username} quoted: ${quote.text.slice(0, 100)}...`);
+   * }
+   *
+   * // Get next page
+   * if (quotes.hasMore) {
+   *   const more = await client.twitter.tweets.getQuotes("1234567890", {
+   *     cursor: quotes.nextCursor
+   *   });
+   * }
+   * ```
+   */
+  async getQuotes(tweetId, options = {}) {
+    const response = await this.client.request(
+      `/v1/twitter/tweets/tweet/${tweetId}/quotes`,
+      { params: { cursor: options.cursor } }
+    );
+    return createPaginatedResponse(response.data ?? [], response.next_cursor);
+  }
+  /**
+   * Iterate through all quote tweets with automatic pagination.
+   *
+   * This is a convenience method that automatically handles pagination,
+   * yielding quote tweets one at a time.
+   *
+   * @param tweetId - The tweet ID to get quote tweets for.
+   * @param options - Iteration options.
+   * @yields Tweet objects that quote the specified tweet.
+   *
+   * @example
+   * ```typescript
+   * // Get all quote tweets (up to 500)
+   * for await (const quote of client.twitter.tweets.getQuotesAll("1234567890", {
+   *   maxItems: 500
+   * })) {
+   *   console.log(`@${quote.username}: ${quote.text}`);
+   * }
+   *
+   * // Collect into an array
+   * import { collectAll } from "scrapebadger";
+   * const quotes = await collectAll(
+   *   client.twitter.tweets.getQuotesAll("1234567890", { maxItems: 100 })
+   * );
+   * ```
+   */
+  async *getQuotesAll(tweetId, options = {}) {
+    const fetchPage = async (cursor) => {
+      return this.getQuotes(tweetId, { ...options, cursor });
+    };
+    yield* paginate(fetchPage, options);
+  }
   /**
    * Search for tweets.
    *