@getanyapi/sdk 0.9.2 → 0.9.6

package/dist/index.cjs

@@ -103,13 +103,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);
   }
 };
@@ -131,25 +136,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) {
@@ -458,14 +510,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 {
@@ -482,6 +538,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) {
@@ -566,6 +634,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}`);
@@ -584,13 +679,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;
@@ -598,6 +701,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
@@ -620,6 +724,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
@@ -627,13 +736,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 } : {}
       }
     );
@@ -698,6 +809,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(
@@ -723,7 +840,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;
@@ -744,7 +863,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);
@@ -752,7 +871,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). */
@@ -797,12 +916,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) {
@@ -813,6 +934,7 @@ function paginate(core, slug, input, itemsField, bare, options) {
         return;
       }
       cursor = next;
+      pageNumber += 1;
     }
   }
   async function* walkItems() {
@@ -844,6 +966,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;
@@ -1196,7 +1327,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.
    *
@@ -1421,7 +1552,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).
    *
@@ -1468,7 +1599,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.
    *
@@ -1497,7 +1628,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.
    *
@@ -1555,7 +1686,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.
    *
@@ -1568,7 +1699,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.
    *
@@ -1597,7 +1728,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.
    *
@@ -1697,7 +1828,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.
    *
@@ -1710,7 +1841,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.
    *
@@ -1740,7 +1871,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.
    *
@@ -1769,7 +1900,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.
    *
@@ -1782,7 +1913,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.
    *
@@ -1811,7 +1942,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.
    *
@@ -1824,7 +1955,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.
    *
@@ -1837,7 +1968,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.
    *
@@ -1866,7 +1997,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.
    *
@@ -1879,7 +2010,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.
    *
@@ -1905,7 +2036,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).
    *
@@ -1960,7 +2091,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.
    *
@@ -1986,7 +2117,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.
    *
@@ -1999,7 +2130,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.
    *
@@ -2041,7 +2172,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.
    *
@@ -2141,7 +2272,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.
    *
@@ -2494,7 +2625,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.
    *
@@ -2523,7 +2654,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.
    *
@@ -2536,7 +2667,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.
    *
@@ -2607,7 +2738,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).
    *
@@ -2620,7 +2751,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.
    *
@@ -2633,7 +2764,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.
    *
@@ -2646,7 +2777,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.
    *
@@ -2659,7 +2790,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.
    *
@@ -2672,7 +2803,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.
    *
@@ -2698,7 +2829,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.
    *
@@ -2724,7 +2855,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.
    *
@@ -2737,7 +2868,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.
    *
@@ -2792,7 +2923,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.
    *
@@ -2805,7 +2936,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.
    *
@@ -2818,7 +2949,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.
    *
@@ -2847,7 +2978,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.
    *
@@ -3027,7 +3158,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.
    *
@@ -3118,7 +3249,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.
    *
@@ -3390,7 +3521,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.
    *
@@ -3403,7 +3534,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.
    *
@@ -3416,7 +3547,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.
    *
@@ -3445,7 +3576,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.
    *
@@ -3458,7 +3589,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.
    *
@@ -3471,7 +3602,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.
    *
@@ -4149,7 +4280,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.
    *
@@ -4162,7 +4293,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.
    *
@@ -4191,7 +4322,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.
    *
@@ -4204,7 +4335,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.
    *
@@ -4262,7 +4393,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.
    *
@@ -4275,7 +4406,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.
    *
@@ -4288,7 +4419,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.
    *
@@ -4301,7 +4432,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.
    *
@@ -4314,7 +4445,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.
    *
@@ -4327,7 +4458,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.
    *
@@ -4356,7 +4487,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.
    *
@@ -4369,7 +4500,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.
    *
@@ -4382,7 +4513,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.
    *
@@ -4411,7 +4542,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.
    *
@@ -4440,7 +4571,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.
    *
@@ -4453,7 +4584,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.
    *
@@ -4482,7 +4613,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.
    *
@@ -4495,7 +4626,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.
    *
@@ -4508,7 +4639,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.
    *
@@ -4537,7 +4668,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.
    *
@@ -4571,7 +4702,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.
    *
@@ -4597,7 +4728,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.
    *
@@ -4626,7 +4757,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.
    *
@@ -4778,7 +4909,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.
    *
@@ -4791,7 +4922,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.
    *
@@ -4862,7 +4993,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.
    *
@@ -4930,7 +5061,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.
    *
@@ -4943,7 +5074,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.
    *
@@ -5305,7 +5436,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.
    *
@@ -5318,7 +5449,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.
    *
@@ -5347,7 +5478,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.
    *
@@ -5376,7 +5507,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.
    *
@@ -5405,7 +5536,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.
    *
@@ -5434,7 +5565,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.
    *
@@ -5463,7 +5594,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.
    *
@@ -5476,7 +5607,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.
    *
@@ -5489,7 +5620,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.
    *
@@ -5502,7 +5633,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.
    *
@@ -5515,7 +5646,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.
    *
@@ -5544,7 +5675,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.
    *
@@ -5557,7 +5688,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.
    *
@@ -5570,7 +5701,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.
    *
@@ -5599,7 +5730,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.
    *
@@ -5612,7 +5743,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.
    *