scrapebadger 0.40.0 → 0.41.0

package/dist/index.d.cts

@@ -99,6 +99,27 @@ interface ScrapeResult {
     ai_extraction: Record<string, unknown> | string | unknown[] | null;
     ai_model: string | null;
     ai_error: string | null;
+    /**
+     * Whether the `wait_for` selector appeared within `wait_timeout`. Null when
+     * no `wait_for` was requested. A miss never arrives as a success — the API
+     * answers `422 wait_for_timeout` and nothing is charged.
+     */
+    wait_for_found?: boolean | null;
+    /**
+     * One entry per executed `js_scenario` step, in order: `step`, `action`,
+     * `selector`, `ok`, `error`, `url` (the page URL right after the step).
+     * Execution stops at the first failed step; a failed step is a free
+     * `422 js_scenario_failed`. Null when no scenario ran.
+     */
+    js_scenario_report?: JsScenarioStepReport[] | null;
+}
+interface JsScenarioStepReport {
+    step: number;
+    action: string;
+    selector: string | null;
+    ok: boolean;
+    error: string | null;
+    url: string | null;
 }
 interface DetectOptions {
     /** Request timeout in ms (1000-60000) */
@@ -4143,7 +4164,10 @@ declare class UsersClient$1 {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     about(username: string): Promise<UserAbout>;
-    /** Get accounts related/suggested for a user. */
+    /**
+     * Get accounts related/suggested for a user.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     related(username: string): Promise<Paginated<UserShort>>;
     /** Get a user's timeline posts. */
     posts(username: string, options?: {
@@ -4255,7 +4279,10 @@ declare class MediaClient$3 {
      * @param code - The media shortcode (from the `/p/<code>/` URL).
      */
     get(code: string): Promise<Media>;
-    /** Get oEmbed metadata for a media permalink. */
+    /**
+     * Get oEmbed metadata for a media permalink.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     oembed(code: string): Promise<Oembed>;
     /** Get top-level comments on a media. */
     comments(code: string, options?: {
@@ -4275,7 +4302,10 @@ declare class MediaClient$3 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Comment$1>>;
-    /** Get the users who liked a comment. */
+    /**
+     * Get the users who liked a comment.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     commentLikers(code: string, commentId: string): Promise<Paginated<UserShort>>;
 }
 
@@ -4309,7 +4339,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     users(query: string): Promise<Paginated<UserShort>>;
-    /** Search hashtags. */
+    /**
+     * Search hashtags.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     hashtags(query: string): Promise<Paginated<Hashtag>>;
     /**
      * Search places/locations.
@@ -4326,7 +4359,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     music(query: string): Promise<Paginated<Audio>>;
-    /** Get blended "top" results (users, hashtags, and places). */
+    /**
+     * Get blended "top" results (users, hashtags, and places).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     top(query: string): Promise<SearchTopResponse>;
     /**
      * Get typeahead/autocomplete suggestions (mixed entity types).
@@ -4346,7 +4382,10 @@ declare class SearchClient$e {
 declare class HashtagsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
-    /** Get a hashtag's info (media count, cover). */
+    /**
+     * Get a hashtag's info (media count, cover).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     get(tag: string): Promise<Hashtag>;
     /**
      * Get the top/popular media for a hashtag.
@@ -4356,7 +4395,10 @@ declare class HashtagsClient$1 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Media>>;
-    /** Get the most recent media for a hashtag. */
+    /**
+     * Get the most recent media for a hashtag.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     recent(tag: string, options?: {
         amount?: number;
         cursor?: string;

package/dist/index.d.ts

@@ -99,6 +99,27 @@ interface ScrapeResult {
     ai_extraction: Record<string, unknown> | string | unknown[] | null;
     ai_model: string | null;
     ai_error: string | null;
+    /**
+     * Whether the `wait_for` selector appeared within `wait_timeout`. Null when
+     * no `wait_for` was requested. A miss never arrives as a success — the API
+     * answers `422 wait_for_timeout` and nothing is charged.
+     */
+    wait_for_found?: boolean | null;
+    /**
+     * One entry per executed `js_scenario` step, in order: `step`, `action`,
+     * `selector`, `ok`, `error`, `url` (the page URL right after the step).
+     * Execution stops at the first failed step; a failed step is a free
+     * `422 js_scenario_failed`. Null when no scenario ran.
+     */
+    js_scenario_report?: JsScenarioStepReport[] | null;
+}
+interface JsScenarioStepReport {
+    step: number;
+    action: string;
+    selector: string | null;
+    ok: boolean;
+    error: string | null;
+    url: string | null;
 }
 interface DetectOptions {
     /** Request timeout in ms (1000-60000) */
@@ -4143,7 +4164,10 @@ declare class UsersClient$1 {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     about(username: string): Promise<UserAbout>;
-    /** Get accounts related/suggested for a user. */
+    /**
+     * Get accounts related/suggested for a user.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     related(username: string): Promise<Paginated<UserShort>>;
     /** Get a user's timeline posts. */
     posts(username: string, options?: {
@@ -4255,7 +4279,10 @@ declare class MediaClient$3 {
      * @param code - The media shortcode (from the `/p/<code>/` URL).
      */
     get(code: string): Promise<Media>;
-    /** Get oEmbed metadata for a media permalink. */
+    /**
+     * Get oEmbed metadata for a media permalink.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     oembed(code: string): Promise<Oembed>;
     /** Get top-level comments on a media. */
     comments(code: string, options?: {
@@ -4275,7 +4302,10 @@ declare class MediaClient$3 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Comment$1>>;
-    /** Get the users who liked a comment. */
+    /**
+     * Get the users who liked a comment.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     commentLikers(code: string, commentId: string): Promise<Paginated<UserShort>>;
 }
 
@@ -4309,7 +4339,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     users(query: string): Promise<Paginated<UserShort>>;
-    /** Search hashtags. */
+    /**
+     * Search hashtags.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     hashtags(query: string): Promise<Paginated<Hashtag>>;
     /**
      * Search places/locations.
@@ -4326,7 +4359,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     music(query: string): Promise<Paginated<Audio>>;
-    /** Get blended "top" results (users, hashtags, and places). */
+    /**
+     * Get blended "top" results (users, hashtags, and places).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     top(query: string): Promise<SearchTopResponse>;
     /**
      * Get typeahead/autocomplete suggestions (mixed entity types).
@@ -4346,7 +4382,10 @@ declare class SearchClient$e {
 declare class HashtagsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
-    /** Get a hashtag's info (media count, cover). */
+    /**
+     * Get a hashtag's info (media count, cover).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     get(tag: string): Promise<Hashtag>;
     /**
      * Get the top/popular media for a hashtag.
@@ -4356,7 +4395,10 @@ declare class HashtagsClient$1 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Media>>;
-    /** Get the most recent media for a hashtag. */
+    /**
+     * Get the most recent media for a hashtag.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     recent(tag: string, options?: {
         amount?: number;
         cursor?: string;

package/dist/index.js

@@ -9,7 +9,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var WebSocket__default = /*#__PURE__*/_interopDefault(WebSocket);
 
 // src/internal/version.ts
-var SDK_VERSION = "0.40.0";
+var SDK_VERSION = "0.41.0";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -4302,7 +4302,10 @@ var UsersClient4 = class {
   async about(username) {
     return this.client.request(`/v1/instagram/users/${username}/about`);
   }
-  /** Get accounts related/suggested for a user. */
+  /**
+   * Get accounts related/suggested for a user.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async related(username) {
     return this.client.request(`/v1/instagram/users/${username}/related`);
   }
@@ -4413,7 +4416,10 @@ var MediaClient = class {
   async get(code) {
     return this.client.request(`/v1/instagram/media/${code}`);
   }
-  /** Get oEmbed metadata for a media permalink. */
+  /**
+   * Get oEmbed metadata for a media permalink.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async oembed(code) {
     return this.client.request(`/v1/instagram/media/${code}/oembed`);
   }
@@ -4440,7 +4446,10 @@ var MediaClient = class {
       { params: { amount: options.amount, cursor: options.cursor } }
     );
   }
-  /** Get the users who liked a comment. */
+  /**
+   * Get the users who liked a comment.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async commentLikers(code, commentId) {
     return this.client.request(
       `/v1/instagram/media/${code}/comments/${commentId}/likers`
@@ -4463,7 +4472,10 @@ var SearchClient4 = class {
       params: { query }
     });
   }
-  /** Search hashtags. */
+  /**
+   * Search hashtags.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async hashtags(query) {
     return this.client.request("/v1/instagram/search/hashtags", {
       params: { query }
@@ -4496,7 +4508,10 @@ var SearchClient4 = class {
       params: { query }
     });
   }
-  /** Get blended "top" results (users, hashtags, and places). */
+  /**
+   * Get blended "top" results (users, hashtags, and places).
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async top(query) {
     return this.client.request("/v1/instagram/search/top", {
       params: { query }
@@ -4524,7 +4539,10 @@ var HashtagsClient = class {
   constructor(client) {
     this.client = client;
   }
-  /** Get a hashtag's info (media count, cover). */
+  /**
+   * Get a hashtag's info (media count, cover).
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async get(tag) {
     return this.client.request(`/v1/instagram/hashtags/${tag}`);
   }
@@ -4535,7 +4553,10 @@ var HashtagsClient = class {
   async top(tag, options = {}) {
     return mediaFeed(this.client, `/v1/instagram/hashtags/${tag}/top`, options);
   }
-  /** Get the most recent media for a hashtag. */
+  /**
+   * Get the most recent media for a hashtag.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async recent(tag, options = {}) {
     return mediaFeed(this.client, `/v1/instagram/hashtags/${tag}/recent`, options);
   }