@getanyapi/sdk 0.9.2 → 0.9.6

package/dist/index.js

@@ -4,13 +4,18 @@ var AnyAPIError = class extends Error {
   status;
   /** The x-request-id response header when present, else undefined. */
   requestId;
-  constructor(message, status, requestId) {
+  /** Stable gateway error code when the JSON body includes one, else undefined. */
+  code;
+  constructor(message, status, requestId, code) {
     super(message);
     this.name = new.target.name;
     this.status = status;
     if (requestId !== void 0) {
       this.requestId = requestId;
     }
+    if (code !== void 0) {
+      this.code = code;
+    }
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
@@ -32,25 +37,72 @@ var ConnectionError = class extends AnyAPIError {
 };
 var TimeoutError = class extends AnyAPIError {
 };
-function errorFromStatus(status, message, requestId) {
+function errorFromStatus(status, message, requestId, code) {
   switch (status) {
     case 400:
-      return new BadRequestError(message, status, requestId);
+      return new BadRequestError(message, status, requestId, code);
     case 401:
-      return new AuthenticationError(message, status, requestId);
+      return new AuthenticationError(message, status, requestId, code);
     case 402:
-      return new InsufficientBalanceError(message, status, requestId);
+      return new InsufficientBalanceError(message, status, requestId, code);
     case 404:
-      return new NotFoundError(message, status, requestId);
+      return new NotFoundError(message, status, requestId, code);
     case 429:
-      return new RateLimitedError(message, status, requestId);
+      return new RateLimitedError(message, status, requestId, code);
     case 502:
-      return new UpstreamError(message, status, requestId);
+      return new UpstreamError(message, status, requestId, code);
     default:
-      return new AnyAPIError(message, status, requestId);
+      return new AnyAPIError(message, status, requestId, code);
   }
 }
 
+// src/core/idempotency.ts
+var MAX_IDEMPOTENCY_KEY_BYTES = 255;
+function generateIdempotencyKey() {
+  let runtimeCrypto;
+  try {
+    runtimeCrypto = globalThis.crypto;
+  } catch {
+    runtimeCrypto = void 0;
+  }
+  if (typeof runtimeCrypto?.randomUUID === "function") {
+    try {
+      return runtimeCrypto.randomUUID();
+    } catch {
+    }
+  }
+  if (typeof runtimeCrypto?.getRandomValues === "function") {
+    try {
+      const bytes = runtimeCrypto.getRandomValues(new Uint8Array(16));
+      return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+    } catch {
+    }
+  }
+  return Array.from(
+    { length: 4 },
+    () => Math.floor(Math.random() * 4294967296).toString(16).padStart(8, "0")
+  ).join("");
+}
+function validateIdempotencyKey(key) {
+  if (key.length === 0 || key.length > MAX_IDEMPOTENCY_KEY_BYTES || [...key].some((char) => {
+    const code = char.charCodeAt(0);
+    return code < 33 || code > 126;
+  })) {
+    throw new TypeError(
+      "idempotencyKey must be 1-255 bytes of visible ASCII (0x21-0x7e)"
+    );
+  }
+}
+function pageIdempotencyKey(key, pageNumber) {
+  validateIdempotencyKey(key);
+  const suffix = `-p${pageNumber}`;
+  const prefixLength = MAX_IDEMPOTENCY_KEY_BYTES - suffix.length;
+  if (prefixLength < 1) {
+    throw new TypeError("pagination page number is too large for an idempotency key");
+  }
+  return `${key.slice(0, prefixLength)}${suffix}`;
+}
+
 // src/core/account.ts
 var DEFAULT_BASE_URL = "https://api.getanyapi.com";
 function malformed(path) {
@@ -359,14 +411,18 @@ async function agentSignup(options = {}) {
   const text = await response.text().catch(() => "");
   if (response.status !== 200) {
     let message = `request failed with status ${response.status}`;
+    let code;
     try {
       const parsed2 = JSON.parse(text);
       if (typeof parsed2.error === "string" && parsed2.error !== "") {
         message = parsed2.error;
       }
+      if (typeof parsed2.code === "string" && parsed2.code !== "") {
+        code = parsed2.code;
+      }
     } catch {
     }
-    throw errorFromStatus(response.status, message, requestId);
+    throw errorFromStatus(response.status, message, requestId, code);
   }
   const parsed = JSON.parse(text);
   return {
@@ -383,6 +439,18 @@ var DEFAULT_TIMEOUT_MS = 6e4;
 var DEFAULT_MAX_RETRIES = 2;
 var RETRY_BASE_DELAY_MS = 500;
 var RETRY_MAX_DELAY_MS = 8e3;
+var PRE_SEND_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  "EADDRNOTAVAIL",
+  "EAI_AGAIN",
+  "EAI_NODATA",
+  "EAI_NONAME",
+  "ECONNREFUSED",
+  "EHOSTUNREACH",
+  "ENETUNREACH",
+  "ENOTFOUND",
+  "UND_ERR_CONNECT_TIMEOUT",
+  "ConnectionRefused"
+]);
 function envApiKey() {
   try {
     if (typeof process !== "undefined" && process?.env) {
@@ -467,6 +535,33 @@ function isTimeoutSignal(timeoutSignal, callerSignal) {
   }
   return callerSignal?.aborted !== true || timeoutSignal.aborted;
 }
+function isDefinitelyPreSendConnectionError(error) {
+  const seen = /* @__PURE__ */ new Set();
+  const visit = (value) => {
+    if (typeof value !== "object" && typeof value !== "function" || value === null) {
+      return false;
+    }
+    if (seen.has(value)) {
+      return false;
+    }
+    seen.add(value);
+    const candidate = value;
+    if (typeof candidate.code === "string" && PRE_SEND_NETWORK_ERROR_CODES.has(candidate.code)) {
+      return true;
+    }
+    if (candidate.code === "ETIMEDOUT" && candidate.syscall === "connect") {
+      return true;
+    }
+    if (candidate.code === "UND_ERR_SOCKET" && candidate.socket?.bytesWritten === 0) {
+      return true;
+    }
+    if (Array.isArray(candidate.errors) && candidate.errors.length > 0) {
+      return candidate.errors.some((item) => visit(item)) || visit(candidate.cause);
+    }
+    return visit(candidate.cause);
+  };
+  return visit(error);
+}
 function buildUrl(baseUrl, slug, options) {
   const base = baseUrl.replace(/\/+$/, "");
   const url = new URL(`${base}/v1/run/${slug}`);
@@ -485,13 +580,21 @@ function messageFromBody(body, status) {
   if (body) {
     try {
       const parsed = JSON.parse(body);
+      const code = typeof parsed.code === "string" && parsed.code !== "" ? parsed.code : void 0;
       if (typeof parsed.error === "string" && parsed.error !== "") {
-        return parsed.error;
+        return {
+          message: parsed.error,
+          ...code !== void 0 ? { code } : {}
+        };
       }
+      return {
+        message: `request failed with status ${status}`,
+        ...code !== void 0 ? { code } : {}
+      };
     } catch {
     }
   }
-  return `request failed with status ${status}`;
+  return { message: `request failed with status ${status}` };
 }
 var AnyAPI = class {
   apiKey;
@@ -499,6 +602,7 @@ var AnyAPI = class {
   fetchImpl;
   maxRetries;
   timeoutMs;
+  idempotency;
   /**
    * The network seam the generated per-platform namespaces target. The base client IS a
    * ClientCore (it implements `run`), so the generated subclass hands `this._core` to each
@@ -521,6 +625,11 @@ var AnyAPI = class {
     this.fetchImpl = resolvedFetch;
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const idempotency = options.idempotency ?? "auto";
+    if (idempotency !== "auto" && idempotency !== "off") {
+      throw new TypeError('idempotency must be "auto" or "off"');
+    }
+    this.idempotency = idempotency;
   }
   /**
    * Generic run for any SKU by slug (the untyped network seam + the string fallback). The
@@ -528,13 +637,15 @@ var AnyAPI = class {
    * base signature is the fallback that returns RunResult<unknown> for an unknown slug.
    */
   run(slug, input, options) {
+    const body = JSON.stringify(input ?? {});
     return this.request(
       "POST",
       buildUrl(this.baseUrl, slug, options),
       {
-        body: JSON.stringify(input ?? {}),
+        body,
         timeoutMs: options?.timeoutMs ?? this.timeoutMs,
         maxRetries: options?.maxRetries ?? this.maxRetries,
+        ...options?.idempotencyKey !== void 0 ? { idempotencyKey: options.idempotencyKey } : {},
         ...options?.signal ? { signal: options.signal } : {}
       }
     );
@@ -599,6 +710,12 @@ var AnyAPI = class {
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
     }
+    const billedPost = method === "POST" && opts.body !== void 0;
+    if (billedPost && this.idempotency === "auto") {
+      const key = opts.idempotencyKey ?? generateIdempotencyKey();
+      validateIdempotencyKey(key);
+      headers["Idempotency-Key"] = key;
+    }
     let attempt = 0;
     for (; ; ) {
       const { signal, timeoutSignal } = composeSignal(
@@ -624,7 +741,9 @@ var AnyAPI = class {
           err instanceof Error ? err.message : "connection failed",
           0
         );
-        if (attempt < opts.maxRetries) {
+        const requestMayBeBilled = method === "POST" && opts.body !== void 0;
+        const safeToRetry = !requestMayBeBilled || isDefinitelyPreSendConnectionError(err);
+        if (safeToRetry && attempt < opts.maxRetries) {
           await sleep(backoffDelay(attempt), opts.signal);
           attempt += 1;
           continue;
@@ -645,7 +764,7 @@ var AnyAPI = class {
         }
       }
       const body = await response.text().catch(() => "");
-      const message = messageFromBody(body, response.status);
+      const { message, code } = messageFromBody(body, response.status);
       if (response.status === 429 && attempt < opts.maxRetries) {
         const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
         const delay = retryAfter ?? backoffDelay(attempt);
@@ -653,7 +772,7 @@ var AnyAPI = class {
         attempt += 1;
         continue;
       }
-      throw errorFromStatus(response.status, message, requestId);
+      throw errorFromStatus(response.status, message, requestId, code);
     }
   }
   /** Internal accessor for GET helpers in account.ts (same base URL / machinery). */
@@ -698,12 +817,14 @@ function paginate(core, slug, input, itemsField, bare, options) {
   const maxItems = options?.maxItems;
   async function* walkPages() {
     let cursor;
+    let pageNumber = 1;
     for (; ; ) {
       const pageInput = { ...input };
       if (cursor !== void 0) {
         pageInput["cursor"] = cursor;
       }
-      const result = await core.run(slug, pageInput, wireOptions);
+      const pageOptions = optionsForPage(wireOptions, pageNumber);
+      const result = await core.run(slug, pageInput, pageOptions);
       yield result;
       const data = pageData(result, bare);
       if (data === null) {
@@ -714,6 +835,7 @@ function paginate(core, slug, input, itemsField, bare, options) {
         return;
       }
       cursor = next;
+      pageNumber += 1;
     }
   }
   async function* walkItems() {
@@ -745,6 +867,15 @@ function paginate(core, slug, input, itemsField, bare, options) {
   };
   return paginator;
 }
+function optionsForPage(options, pageNumber) {
+  if (options?.idempotencyKey === void 0) {
+    return options;
+  }
+  return {
+    ...options,
+    idempotencyKey: pageIdempotencyKey(options.idempotencyKey, pageNumber)
+  };
+}
 function stripMaxItems(options) {
   if (!options) {
     return void 0;
@@ -1097,7 +1228,7 @@ var BlueskyNamespace = class {
   /**
    * Bluesky User Posts
    *
-   * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON, normalized across providers.
+   * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1322,7 +1453,7 @@ var EmailNamespace = class {
   /**
    * Email Verifier
    *
-   * Verify any email address for deliverability: syntax, domain, and mailbox checks in one normalized response.
+   * Verify an email address for deliverability: a status verdict (valid, risky, or invalid) with domain, mailbox, catch-all, disposable, and role signals plus a confidence score. Malformed addresses are rejected by the input schema with no charge; every syntactically valid address returns a billed verdict, including undeliverable ones.
    *
    * Price: $0 per request plus $0.0008 per result (maximum $0.0008).
    *
@@ -1369,7 +1500,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Ad Search
    *
-   * Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination and transparent failover.
+   * Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination.
    *
    * Price: $0.002 per request.
    *
@@ -1398,7 +1529,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Comment Replies
    *
-   * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON at a.
+   * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1456,7 +1587,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Event Details
    *
-   * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON at a.
+   * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1469,7 +1600,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Events
    *
-   * List public Facebook events for a city or place by its events-page URL (event name, date, venue, and attendance) as normalized JSON at a.
+   * List public Facebook events for a city or place by its events-page URL (event name, date, venue, and attendance) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1498,7 +1629,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Events Search
    *
-   * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON at a.
+   * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1598,7 +1729,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Marketplace Item
    *
-   * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON at a.
+   * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1611,7 +1742,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Marketplace Location Search
    *
-   * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON at a.
+   * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1641,7 +1772,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Page Photos
    *
-   * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON at a.
+   * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1670,7 +1801,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Post
    *
-   * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views), normalized across providers.
+   * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views).
    *
    * Price: $0.002 per request.
    *
@@ -1683,7 +1814,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Post Comments
    *
-   * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count), normalized across providers.
+   * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count).
    *
    * Price: $0.002 per request.
    *
@@ -1712,7 +1843,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Post Transcript
    *
-   * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON at a.
+   * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1725,7 +1856,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Profile
    *
-   * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle, normalized across providers.
+   * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle.
    *
    * Price: $0.002 per request.
    *
@@ -1738,7 +1869,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Page Events
    *
-   * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON at a.
+   * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -1767,7 +1898,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Profile Posts
    *
-   * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink), normalized across providers.
+   * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink).
    *
    * Price: $0.002 per request.
    *
@@ -1780,7 +1911,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Profile Reels
    *
-   * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail), normalized across providers.
+   * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail).
    *
    * Price: $0.002 per request.
    *
@@ -1806,7 +1937,7 @@ var FacebookNamespace = class {
   /**
    * Facebook Page Search
    *
-   * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details) at a.
+   * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details).
    *
    * Price: $0.001 per request plus $0.011 per result (maximum $0.111).
    *
@@ -1861,7 +1992,7 @@ var GithubNamespace = class {
   /**
    * GitHub Repository
    *
-   * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps), normalized across providers with transparent failover.
+   * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps).
    *
    * Price: $0.002 per request.
    *
@@ -1887,7 +2018,7 @@ var GithubNamespace = class {
   /**
    * GitHub Trending Repositories
    *
-   * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window, normalized across providers.
+   * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window.
    *
    * Price: $0.002 per request.
    *
@@ -1900,7 +2031,7 @@ var GithubNamespace = class {
   /**
    * GitHub User
    *
-   * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts), normalized across providers with transparent failover.
+   * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts).
    *
    * Price: $0.002 per request.
    *
@@ -1942,7 +2073,7 @@ var GithubNamespace = class {
   /**
    * GitHub User Contributions
    *
-   * Fetch a GitHub user's contribution graph for a year (total contributions plus per-day counts and heatmap intensity), normalized across providers with transparent failover.
+   * Fetch a GitHub user's contribution graph for a year (total contributions plus per-day counts and heatmap intensity).
    *
    * Price: $0.002 per request.
    *
@@ -2042,7 +2173,7 @@ var GithubNamespace = class {
   /**
    * GitHub User Repositories
    *
-   * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination, normalized across providers.
+   * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination.
    *
    * Price: $0.002 per request.
    *
@@ -2395,7 +2526,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Reels by Audio
    *
-   * List Instagram reels that use a given audio track by audio id, normalized across providers with transparent failover.
+   * List Instagram reels that use a given audio track by audio id.
    *
    * Price: $0.002 per request.
    *
@@ -2424,7 +2555,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Basic Profile
    *
-   * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id, normalized across providers with transparent failover.
+   * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id.
    *
    * Price: $0.002 per request.
    *
@@ -2437,7 +2568,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Profile Embed
    *
-   * Fetch the public embed HTML for an Instagram profile by handle, normalized across providers with transparent failover.
+   * Fetch the public embed HTML for an Instagram profile by handle.
    *
    * Price: $0.002 per request.
    *
@@ -2508,7 +2639,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Hashtag Analytics
    *
-   * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals), normalized.
+   * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals).
    *
    * Price: $0.001 per request plus $0.0017 per result (maximum $0.035).
    *
@@ -2521,7 +2652,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Highlight Detail
    *
-   * Fetch the details and media items of a single Instagram story highlight by id, normalized across providers with transparent failover.
+   * Fetch the details and media items of a single Instagram story highlight by id.
    *
    * Price: $0.002 per request.
    *
@@ -2534,7 +2665,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Media Transcript
    *
-   * Get the spoken-audio transcript text for an Instagram post or reel by URL, normalized across providers with transparent failover.
+   * Get the spoken-audio transcript text for an Instagram post or reel by URL.
    *
    * Price: $0.002 per request.
    *
@@ -2547,7 +2678,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Post
    *
-   * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON, across providers with transparent failover.
+   * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -2560,7 +2691,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Post Comments
    *
-   * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes), normalized across providers.
+   * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes).
    *
    * Price: $0.002 per request.
    *
@@ -2573,7 +2704,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Profile
    *
-   * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle, normalized across providers with transparent failover.
+   * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle.
    *
    * Price: $0.002 per request.
    *
@@ -2599,7 +2730,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Reels Search
    *
-   * Search Instagram Reels by keyword and get matching reels (caption, views, likes, creator, and duration), normalized across providers with transparent failover.
+   * Search Instagram Reels by keyword and get matching reels (caption, views, likes, creator, and duration). Paging tops out around 110 reels per query (11 pages of 10).
    *
    * Price: $0.002 per request.
    *
@@ -2625,7 +2756,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Hashtag Search
    *
-   * List recent Instagram posts under a hashtag (caption, type, media URL), normalized across providers with transparent failover.
+   * Search Instagram posts under a hashtag (caption, type, media URL). Results are relevance-ranked by Instagram, not date-ordered, so a page can mix recent and older posts.
    *
    * Price: $0.002 per request.
    *
@@ -2638,7 +2769,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Profile Search
    *
-   * Search public Instagram profiles by a bio or caption keyword, normalized across providers with transparent failover.
+   * Search public Instagram profiles by a bio or caption keyword.
    *
    * Price: $0.002 per request.
    *
@@ -2693,7 +2824,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Trending Reels
    *
-   * List currently trending Instagram reels, normalized across providers with transparent failover.
+   * List currently trending Instagram reels.
    *
    * Price: $0.002 per request.
    *
@@ -2706,7 +2837,7 @@ var InstagramNamespace = class {
   /**
    * Instagram User Highlights
    *
-   * List an Instagram account's story highlight reels by handle, normalized across providers with transparent failover.
+   * List an Instagram account's story highlight reels by handle.
    *
    * Price: $0.002 per request.
    *
@@ -2719,7 +2850,7 @@ var InstagramNamespace = class {
   /**
    * Instagram User Posts
    *
-   * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination, normalized across providers.
+   * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination.
    *
    * Price: $0.002 per request.
    *
@@ -2748,7 +2879,7 @@ var InstagramNamespace = class {
   /**
    * Instagram User Reels
    *
-   * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments), normalized across providers.
+   * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments).
    *
    * Price: $0.002 per request.
    *
@@ -2928,7 +3059,7 @@ var LinkedinNamespace = class {
   /**
    * LinkedIn Post
    *
-   * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date), normalized across providers.
+   * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date).
    *
    * Price: $0.001 per request.
    *
@@ -3019,7 +3150,7 @@ var LinkedinNamespace = class {
   /**
    * LinkedIn Post Search
    *
-   * Search public LinkedIn posts by keyword (text, link, publish date), normalized across providers with transparent failover.
+   * Search public LinkedIn posts by keyword (text, link, publish date).
    *
    * Price: $0.002 per request.
    *
@@ -3291,7 +3422,7 @@ var RedditNamespace = class {
   /**
    * Reddit Post Comments
    *
-   * List the top-level comments on a Reddit post by URL (author, body, score, timestamp), normalized across providers with transparent failover.
+   * List the top-level comments on a Reddit post by URL (author, body, score, timestamp).
    *
    * Price: $0.002 per request.
    *
@@ -3304,7 +3435,7 @@ var RedditNamespace = class {
   /**
    * Reddit Post Transcript
    *
-   * Extract the spoken transcript from a Reddit video post by URL, normalized across providers with transparent failover.
+   * Extract the spoken transcript from a Reddit video post by URL.
    *
    * Price: $0.002 per request.
    *
@@ -3317,7 +3448,7 @@ var RedditNamespace = class {
   /**
    * Reddit Search
    *
-   * Search Reddit posts across all subreddits by query, normalized across providers with transparent failover.
+   * Search Reddit posts across all subreddits by query.
    *
    * Price: $0.001 per request.
    *
@@ -3346,7 +3477,7 @@ var RedditNamespace = class {
   /**
    * Reddit Subreddit Details
    *
-   * Fetch a subreddit's metadata (weekly active users, description, and category), normalized across providers with transparent failover.
+   * Fetch a subreddit's metadata (weekly active users, description, and category).
    *
    * Price: $0.001 per request.
    *
@@ -3359,7 +3490,7 @@ var RedditNamespace = class {
   /**
    * Reddit Subreddit Posts
    *
-   * Fetch posts from a subreddit listing (hot, new, or top), normalized across providers with transparent failover.
+   * Fetch posts from a subreddit listing (hot, new, or top).
    *
    * Price: $0.002 per request.
    *
@@ -3372,7 +3503,7 @@ var RedditNamespace = class {
   /**
    * Reddit Subreddit Search
    *
-   * Search posts within a single subreddit by query, sort, and timeframe, normalized across providers with transparent failover.
+   * Search posts within a single subreddit by query, sort, and timeframe.
    *
    * Price: $0.002 per request.
    *
@@ -4050,7 +4181,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Ad Library Ad
    *
-   * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info), normalized across providers with transparent failover.
+   * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info).
    *
    * Price: $0.002 per request.
    *
@@ -4063,7 +4194,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Ad Library Search
    *
-   * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info), normalized across providers with transparent failover.
+   * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info).
    *
    * Price: $0.002 per request.
    *
@@ -4092,7 +4223,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Audience Demographics
    *
-   * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle, normalized across providers.
+   * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle.
    *
    * Price: $0.01625 per request.
    *
@@ -4105,7 +4236,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Comment Replies
    *
-   * List the replies to a TikTok comment with cursor pagination (text, author, likes), normalized across providers.
+   * List the replies to a TikTok comment with cursor pagination (text, author, likes).
    *
    * Price: $0.002 per request.
    *
@@ -4163,7 +4294,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Following
    *
-   * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username, normalized across providers.
+   * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username.
    *
    * Price: $0.002 per request.
    *
@@ -4176,7 +4307,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Hashtag Videos
    *
-   * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares), normalized output.
+   * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares).
    *
    * Price: $0.00325 per request.
    *
@@ -4189,7 +4320,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Live
    *
-   * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle, normalized across providers.
+   * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle.
    *
    * Price: $0.002 per request.
    *
@@ -4202,7 +4333,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Profile
    *
-   * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle, normalized across providers with transparent failover.
+   * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle.
    *
    * Price: $0.001 per request.
    *
@@ -4215,7 +4346,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Profile Region
    *
-   * Resolve the home region (country) of a TikTok creator by handle, normalized across providers with transparent failover.
+   * Resolve the home region (country) of a TikTok creator by handle.
    *
    * Price: $0.002 per request.
    *
@@ -4228,7 +4359,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Profile Videos
    *
-   * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination, normalized across providers.
+   * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination.
    *
    * Price: $0.001 per request.
    *
@@ -4257,7 +4388,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Hashtag Search
    *
-   * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
+   * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -4270,7 +4401,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Keyword Search
    *
-   * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
+   * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
    *
    * Price: $0.001 per request.
    *
@@ -4283,7 +4414,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Top Search
    *
-   * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination, normalized across providers.
+   * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination.
    *
    * Price: $0.002 per request.
    *
@@ -4312,7 +4443,7 @@ var TiktokNamespace = class {
   /**
    * TikTok User Search
    *
-   * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination, normalized across providers.
+   * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination.
    *
    * Price: $0.001 per request.
    *
@@ -4341,7 +4472,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Song
    *
-   * Fetch details for a TikTok song or sound (title, author, duration, cover art, and how many videos use it), normalized across providers with transparent failover.
+   * Fetch details for a TikTok song or sound (title, author, duration, cover art, and how many videos use it).
    *
    * Price: $0.002 per request.
    *
@@ -4354,7 +4485,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Song Videos
    *
-   * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats), normalized across providers with transparent failover.
+   * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats).
    *
    * Price: $0.002 per request.
    *
@@ -4383,7 +4514,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Trending Feed
    *
-   * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON, across providers with transparent failover.
+   * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -4396,7 +4527,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Video
    *
-   * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves), normalized across providers with transparent failover.
+   * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves).
    *
    * Price: $0.001 per request.
    *
@@ -4409,7 +4540,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Video Comments
    *
-   * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
+   * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count).
    *
    * Price: $0.002 per request.
    *
@@ -4438,7 +4569,7 @@ var TiktokNamespace = class {
   /**
    * TikTok Video Transcript
    *
-   * Fetch the spoken-word transcript of a TikTok video by URL, normalized across providers with transparent failover.
+   * Fetch the spoken-word transcript of a TikTok video by URL.
    *
    * Price: $0.002 per request.
    *
@@ -4472,7 +4603,7 @@ var TiktokShopNamespace = class {
   /**
    * TikTok Shop Product Reviews
    *
-   * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag), normalized across providers with transparent failover.
+   * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag).
    *
    * Price: $0.002 per request.
    *
@@ -4498,7 +4629,7 @@ var TiktokShopNamespace = class {
   /**
    * TikTok Shop Store Products
    *
-   * List every product of a TikTok Shop store by URL (title, price, sales, and rating per product plus shop-level stats) with cursor pagination and transparent failover.
+   * List every product of a TikTok Shop store by URL (title, price, sales, and rating per product plus shop-level stats) with cursor pagination.
    *
    * Price: $0.002 per request.
    *
@@ -4527,7 +4658,7 @@ var TiktokShopNamespace = class {
   /**
    * TikTok Shop User Showcase
    *
-   * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product), normalized across providers with transparent failover.
+   * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product).
    *
    * Price: $0.002 per request.
    *
@@ -4679,7 +4810,7 @@ var TwitterNamespace = class {
   /**
    * Twitter Community
    *
-   * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL, normalized across providers with transparent failover.
+   * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL.
    *
    * Price: $0.002 per request.
    *
@@ -4692,7 +4823,7 @@ var TwitterNamespace = class {
   /**
    * Twitter Community Tweets
    *
-   * List recent tweets posted in a Twitter/X community by URL, normalized across providers with transparent failover.
+   * List recent tweets posted in a Twitter/X community by URL.
    *
    * Price: $0.002 per request.
    *
@@ -4763,7 +4894,7 @@ var TwitterNamespace = class {
   /**
    * Twitter Profile
    *
-   * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle, normalized across providers with transparent failover.
+   * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle.
    *
    * Price: $0.00075 per request.
    *
@@ -4831,7 +4962,7 @@ var TwitterNamespace = class {
   /**
    * Twitter Tweet
    *
-   * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views), normalized across providers.
+   * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
    *
    * Price: $0.00075 per request.
    *
@@ -4844,7 +4975,7 @@ var TwitterNamespace = class {
   /**
    * Twitter Tweet Transcript
    *
-   * Extract the spoken transcript from a Twitter/X video tweet by URL, normalized across providers with transparent failover.
+   * Extract the spoken transcript from a Twitter/X video tweet by URL.
    *
    * Price: $0.002 per request.
    *
@@ -5206,7 +5337,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel
    *
-   * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID, normalized across providers.
+   * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID.
    *
    * Price: $0.002 per request.
    *
@@ -5219,7 +5350,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel Community Posts
    *
-   * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time), normalized across providers.
+   * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5248,7 +5379,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel Live Streams
    *
-   * List a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time), normalized across providers.
+   * List a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5277,7 +5408,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel Playlists
    *
-   * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail), normalized across providers.
+   * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail).
    *
    * Price: $0.002 per request.
    *
@@ -5306,7 +5437,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel Shorts
    *
-   * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration), normalized across providers.
+   * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration).
    *
    * Price: $0.002 per request.
    *
@@ -5335,7 +5466,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Channel Videos
    *
-   * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time), normalized across providers.
+   * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5364,7 +5495,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Comment Replies
    *
-   * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time), normalized across providers.
+   * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5377,7 +5508,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Community Post
    *
-   * Fetch a single YouTube community post by URL (text, images, channel, publish time), normalized across providers.
+   * Fetch a single YouTube community post by URL (text, images, channel, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5390,7 +5521,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Playlist
    *
-   * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals), normalized across providers with transparent failover.
+   * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals).
    *
    * Price: $0.002 per request.
    *
@@ -5403,7 +5534,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Search
    *
-   * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON, across providers with transparent failover.
+   * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON.
    *
    * Price: $0.002 per request.
    *
@@ -5416,7 +5547,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Hashtag Search
    *
-   * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time), normalized across providers.
+   * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time).
    *
    * Price: $0.002 per request.
    *
@@ -5445,7 +5576,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Trending Shorts
    *
-   * List currently trending YouTube Shorts (title, channel, views, likes, duration), normalized across providers.
+   * List currently trending YouTube Shorts (title, channel, views, likes, duration).
    *
    * Price: $0.002 per request.
    *
@@ -5458,7 +5589,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video
    *
-   * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID, normalized across providers.
+   * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
    *
    * Price: $0.002 per request.
    *
@@ -5471,7 +5602,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Comments
    *
-   * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
+   * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count).
    *
    * Price: $0.002 per request.
    *
@@ -5500,7 +5631,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Sponsors
    *
-   * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence), normalized across providers.
+   * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence).
    *
    * Price: $0.002 per request.
    *
@@ -5513,7 +5644,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Transcript
    *
-   * Fetch the transcript/captions of a YouTube video by URL or ID, normalized across providers with transparent failover.
+   * Fetch the transcript/captions of a YouTube video by URL or ID.
    *
    * Price: $0.002 per request.
    *