@getanyapi/sdk 0.16.0 → 0.17.1

package/dist/index.js

@@ -40,6 +40,13 @@ var ConnectionError = class extends AnyAPIError {
 };
 var TimeoutError = class extends AnyAPIError {
 };
+var RequestPendingError = class extends TimeoutError {
+  durableRequestId;
+  constructor(requestId) {
+    super(`request is still running; resume with requests.get or requests.wait: ${requestId}`, 0, requestId);
+    this.durableRequestId = requestId;
+  }
+};
 var REQUEST_ID_HEADERS = ["x-anyapi-request-id", "x-request-id"];
 function requestIdOf(headers) {
   for (const name of REQUEST_ID_HEADERS) {
@@ -597,9 +604,10 @@ var AnyAPI = class {
    * generated `AnyAPI` subclass adds typed literal-slug overloads on top (SPEC 2.1); this
    * base signature is the fallback that returns RunResult<unknown> for an unknown slug.
    */
-  run(slug, input, options) {
+  async run(slug, input, options) {
     const body = JSON.stringify(input ?? {});
-    return this.request(
+    const startedAt = Date.now();
+    const response = await this.request(
       "POST",
       buildUrl(this.baseUrl, slug, options),
       {
@@ -608,8 +616,88 @@ var AnyAPI = class {
         maxRetries: options?.maxRetries ?? this.maxRetries,
         maxInProgressWaitMs: options?.maxInProgressWaitMs ?? this.maxInProgressWaitMs,
         ...options?.idempotencyKey !== void 0 ? { idempotencyKey: options.idempotencyKey } : {},
-        ...options?.signal ? { signal: options.signal } : {}
+        ...options?.signal ? { signal: options.signal } : {},
+        accept202: true
+      }
+    );
+    if (!isRequestSnapshot(response)) return response;
+    return this.waitRequest(response.requestId, {
+      initial: response,
+      timeoutMs: Math.max(
+        0,
+        (options?.timeoutMs ?? this.timeoutMs) - (Date.now() - startedAt)
+      ),
+      ...options?.signal ? { signal: options.signal } : {}
+    });
+  }
+  /** Start durable work. A same-key completed replay returns its terminal result immediately. */
+  async start(slug, input, options) {
+    const body = JSON.stringify(input ?? {});
+    const response = await this.request(
+      "POST",
+      buildUrl(this.baseUrl, slug, options),
+      {
+        body,
+        timeoutMs: options?.timeoutMs ?? this.timeoutMs,
+        maxRetries: options?.maxRetries ?? this.maxRetries,
+        maxInProgressWaitMs: options?.maxInProgressWaitMs ?? this.maxInProgressWaitMs,
+        ...options?.idempotencyKey !== void 0 ? { idempotencyKey: options.idempotencyKey } : {},
+        ...options?.signal ? { signal: options.signal } : {},
+        headers: { Prefer: "respond-async" },
+        accept202: true
+      }
+    );
+    return response;
+  }
+  requests = {
+    get: (requestId) => this.getRequest(requestId),
+    wait: (requestId, options) => this.waitRequest(requestId, options)
+  };
+  getRequest(requestId, options) {
+    return this.httpGet(
+      `/v1/requests/${encodeURIComponent(requestId)}`,
+      options
+    );
+  }
+  async waitRequest(requestId, options) {
+    const timeoutMs = options?.timeoutMs ?? this.timeoutMs;
+    const deadline = Date.now() + timeoutMs;
+    const inspect = async () => {
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) throw new RequestPendingError(requestId);
+      try {
+        return await this.getRequest(requestId, {
+          timeoutMs: remaining,
+          ...options?.signal ? { signal: options.signal } : {}
+        });
+      } catch (error) {
+        if (error instanceof TimeoutError)
+          throw new RequestPendingError(requestId);
+        throw error;
       }
+    };
+    let snapshot = options?.initial ?? await inspect();
+    while (snapshot.status === "queued" || snapshot.status === "running") {
+      const waitMs = Math.max(1, snapshot.retryAfterSeconds ?? 2) * 1e3;
+      if (Date.now() + waitMs > deadline)
+        throw new RequestPendingError(requestId);
+      await sleep(waitMs, options?.signal);
+      snapshot = await inspect();
+    }
+    if (snapshot.status === "succeeded" && snapshot.result)
+      return snapshot.result;
+    if (snapshot.resultExpired)
+      throw new AnyAPIError(
+        "request result expired",
+        410,
+        requestId,
+        "result_expired"
+      );
+    throw new AnyAPIError(
+      `request ended with ${snapshot.error?.code ?? snapshot.status}`,
+      502,
+      requestId,
+      snapshot.error?.code
     );
   }
   /** Current wallet balance in USD. GET /v1/balance. See SPEC 2.7. */
@@ -652,10 +740,11 @@ var AnyAPI = class {
     return mapCatalogDetail(raw);
   }
   /** Internal GET against the gateway with the same auth/retry/error machinery. */
-  httpGet(path) {
+  httpGet(path, options) {
     return this.request("GET", `${this.gatewayBaseUrl}${path}`, {
-      timeoutMs: this.timeoutMs,
-      maxRetries: this.maxRetries
+      timeoutMs: options?.timeoutMs ?? this.timeoutMs,
+      maxRetries: this.maxRetries,
+      ...options?.signal ? { signal: options.signal } : {}
     });
   }
   /**
@@ -672,6 +761,7 @@ var AnyAPI = class {
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
     }
+    Object.assign(headers, opts.headers);
     const billedPost = method === "POST" && opts.body !== void 0;
     if (billedPost && this.idempotency === "auto") {
       const key = opts.idempotencyKey ?? generateIdempotencyKey();
@@ -718,7 +808,7 @@ var AnyAPI = class {
         throw connErr;
       }
       const requestId = requestIdOf(response.headers);
-      if (response.status === 200) {
+      if (response.status === 200 || opts.accept202 && response.status === 202) {
         const text = await response.text();
         try {
           return JSON.parse(text);
@@ -732,7 +822,9 @@ var AnyAPI = class {
       }
       const body = await response.text().catch(() => "");
       const { message, code } = messageFromBody(body, response.status);
-      const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
+      const retryAfterMs = parseRetryAfterMs(
+        response.headers.get("retry-after")
+      );
       if (response.status === 429 && attempt < opts.maxRetries) {
         const delay = retryAfterMs !== void 0 ? Math.min(retryAfterMs, RETRY_MAX_DELAY_MS) : backoffDelay(attempt);
         await sleep(delay, opts.signal);
@@ -762,6 +854,9 @@ var AnyAPI = class {
     return this.timeoutMs;
   }
 };
+function isRequestSnapshot(value) {
+  return "requestId" in value && "status" in value;
+}
 
 // src/core/types.ts
 var OUTPUT_NOT_RETAINED = "the run output was not retained: this response is an idempotent replay whose stored payload has expired or was too large to store, so only the run metadata came back. Re-run the request without the idempotency key (or with a fresh one) to fetch the data again.";
@@ -991,7 +1086,7 @@ var AmazonNamespace = class {
    *
    * List the top-ranked products of any Amazon Best Sellers category (rank, title, price, and rating) in one normalized request.
    *
-   * Price: $0 per request plus $0.00431 per result (maximum $0.0861).
+   * Price: $0.0009 per request.
    *
    * @example
    * const res = await client.amazon.bestsellers({ url: "https://www.amazon.com/gp/bestsellers/electronics", limit: 3 });
@@ -1017,7 +1112,7 @@ var AmazonNamespace = class {
    *
    * Pull up to 50 customer reviews for any Amazon product by ASIN or URL: rating, title, text, date, and verified-purchase badge.
    *
-   * Price: $0.018 per request.
+   * Price: $0.0018 per request.
    *
    * @example
    * const res = await client.amazon.reviews({ product: "B07PXGQC1Q", limit: 3 });
@@ -1030,7 +1125,7 @@ var AmazonNamespace = class {
    *
    * Search Amazon from any search or category URL and get up to 20 matching products (title, price, rating, and thumbnail) in one normalized response.
    *
-   * Price: $0 per request plus $0.00368 per result (maximum $0.0735).
+   * Price: $0.0009 per request.
    *
    * @example
    * const res = await client.amazon.search({ url: "https://www.amazon.com/s?k=laptop", limit: 3 });
@@ -1262,6 +1357,71 @@ var CoinmarketcapNamespace = class {
   }
 };
 
+// src/generated/platforms/company_enrichment.ts
+var CompanyEnrichmentNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Company Enrichment - Crustdata v3
+   *
+   * Enrich a company by domain, name, LinkedIn URL, or Crustdata identifier.
+   *
+   * Price: $0.0972 per request.
+   */
+  crustdataV3(input, options) {
+    return this._core.run("company_enrichment.crustdata_v3", input, options);
+  }
+};
+
+// src/generated/platforms/company_search.ts
+var CompanySearchNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Company Search - AI Ark
+   *
+   * Search companies by name, lookalike domains, account filters, and saved-list filters.
+   *
+   * Price: $0 per request plus $0.0024 per result (maximum $0.24).
+   *
+   * @example
+   * const res = await client.companySearch.aiArk({ name: "OpenAI", page: 0, size: 1 });
+   */
+  aiArk(input, options) {
+    return this._core.run("company_search.ai_ark", input, options);
+  }
+  /**
+   * Company Search - Crustdata v3
+   *
+   * Search companies by structured filters with cursor pagination.
+   *
+   * Price: $0 per request plus $0.048 per result (maximum $48).
+   */
+  crustdataV3(input, options) {
+    return this._core.run("company_search.crustdata_v3", input, options);
+  }
+  /**
+   * Iterate every result of Company Search - Crustdata v3 across pages.
+   *
+   * Yields items directly; call `.pages()` on the return value to walk whole
+   * result pages instead (each carries its own costUsd).
+   */
+  iterCrustdataV3(input, options) {
+    return paginate(
+      this._core,
+      "company_search.crustdata_v3",
+      input,
+      "companies",
+      false,
+      options
+    );
+  }
+};
+
 // src/generated/platforms/congress.ts
 var CongressNamespace = class {
   constructor(_core) {
@@ -1445,6 +1605,78 @@ var EmailNamespace = class {
   }
 };
 
+// src/generated/platforms/email_finding.ts
+var EmailFindingNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Email Finding - DropLeads
+   *
+   * Find a professional email from a person's name and company domain or company name.
+   *
+   * Price: $0.0312 per request.
+   *
+   * @example
+   * const res = await client.emailFinding.dropleads({ firstName: "Tim", lastName: "Zheng", companyDomain: "apollo.io" });
+   */
+  dropleads(input, options) {
+    return this._core.run("email_finding.dropleads", input, options);
+  }
+  /**
+   * Email Finding - Icypeas
+   *
+   * Find a professional email from a person and company through the durable Request lifecycle.
+   *
+   * Price: $0.0168 per request.
+   */
+  icypeas(input, options) {
+    return this._core.run("email_finding.icypeas", input, options);
+  }
+};
+
+// src/generated/platforms/email_verification.ts
+var EmailVerificationNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Email Verification - Allegrow
+   *
+   * Validate an email address and return its deliverability verdict and mailbox signals.
+   *
+   * Price: $0.0144 per request.
+   *
+   * @example
+   * const res = await client.emailVerification.allegrow({ email: "tim@apollo.io" });
+   */
+  allegrow(input, options) {
+    return this._core.run("email_verification.allegrow", input, options);
+  }
+  /**
+   * Email Verification - BounceBan
+   *
+   * Verify an email address, including catch-all handling. Completion uses the durable Request lifecycle; a negative verdict is a successful result.
+   *
+   * Price: $0.0072 per request.
+   */
+  bounceban(input, options) {
+    return this._core.run("email_verification.bounceban", input, options);
+  }
+  /**
+   * Email Verification - Icypeas
+   *
+   * Verify an email address. A valid negative verdict is a successful, billable result.
+   *
+   * Price: $0.0024 per request.
+   */
+  icypeas(input, options) {
+    return this._core.run("email_verification.icypeas", input, options);
+  }
+};
+
 // src/generated/platforms/facebook.ts
 var FacebookNamespace = class {
   constructor(_core) {
@@ -3357,6 +3589,37 @@ var MapsNamespace = class {
   }
 };
 
+// src/generated/platforms/mobile_phone.ts
+var MobilePhoneNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Mobile Phone - AI Ark
+   *
+   * Find a person's mobile phone from a LinkedIn URL or from a domain and full name.
+   *
+   * Price: $0.084 per request.
+   *
+   * @example
+   * const res = await client.mobilePhone.aiArk({ linkedinUrl: "https://www.linkedin.com/in/tim-zheng" });
+   */
+  aiArk(input, options) {
+    return this._core.run("mobile_phone.ai_ark", input, options);
+  }
+  /**
+   * Mobile Phone - LeadMagic
+   *
+   * Find a person's mobile phone from a profile URL or email. No-match responses are not billed.
+   *
+   * Price: $0.2016 per request.
+   */
+  leadmagic(input, options) {
+    return this._core.run("mobile_phone.leadmagic", input, options);
+  }
+};
+
 // src/generated/platforms/pandaexpress.ts
 var PandaexpressNamespace = class {
   constructor(_core) {
@@ -3404,6 +3667,37 @@ var PandaexpressNamespace = class {
   }
 };
 
+// src/generated/platforms/people_search.ts
+var PeopleSearchNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * People Search - AI Ark
+   *
+   * Search professional profiles with account, contact, and saved-list filters.
+   *
+   * Price: $0 per request plus $0.0084 per result (maximum $0.84).
+   *
+   * @example
+   * const res = await client.peopleSearch.aiArk({ page: 0, size: 1 });
+   */
+  aiArk(input, options) {
+    return this._core.run("people_search.ai_ark", input, options);
+  }
+  /**
+   * People Search - Crustdata v3
+   *
+   * Find up to 100 professional profiles by company domain and title keywords.
+   *
+   * Price: $0.144 per request.
+   */
+  crustdataV3(input, options) {
+    return this._core.run("people_search.crustdata_v3", input, options);
+  }
+};
+
 // src/generated/platforms/person.ts
 var PersonNamespace = class {
   constructor(_core) {
@@ -3425,6 +3719,24 @@ var PersonNamespace = class {
   }
 };
 
+// src/generated/platforms/person_enrichment.ts
+var PersonEnrichmentNamespace = class {
+  constructor(_core) {
+    this._core = _core;
+  }
+  _core;
+  /**
+   * Person Enrichment - Aviato
+   *
+   * Enrich a person from an Aviato or LinkedIn identifier, LinkedIn URL, or email.
+   *
+   * Price: $0.084 per request.
+   */
+  aviato(input, options) {
+    return this._core.run("person_enrichment.aviato", input, options);
+  }
+};
+
 // src/generated/platforms/pinterest.ts
 var PinterestNamespace = class {
   constructor(_core) {
@@ -5037,7 +5349,7 @@ var TwitterNamespace = class {
    *
    * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL.
    *
-   * Price: $0.002 per request.
+   * Price: $0.00018 per request.
    *
    * @example
    * const res = await client.twitter.community({ url: "https://x.com/i/communities/1926186499399139650" });
@@ -5121,7 +5433,7 @@ var TwitterNamespace = class {
    *
    * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle.
    *
-   * Price: $0.00075 per request.
+   * Price: $0.00018 per request.
    *
    * @example
    * const res = await client.twitter.profile({ handle: "nasa" });
@@ -5134,7 +5446,7 @@ var TwitterNamespace = class {
    *
    * Fetch the replies to any X (Twitter) post URL as structured records: author, text, and engagement.
    *
-   * Price: $0.00263 per request plus $0.00027 per result (maximum $0.0132).
+   * Price: $0.00018 per request plus $0.00018 per result (maximum $0.00666).
    *
    * @example
    * const res = await client.twitter.replies({ url: "https://x.com/jack/status/20", limit: 3 });
@@ -5176,7 +5488,7 @@ var TwitterNamespace = class {
    *
    * Get current X (Twitter) trends for worldwide, a country, or a city in X ranking order, including the resolved location.
    *
-   * Price: $0.00075 per request.
+   * Price: $0.00018 per request.
    *
    * @example
    * const res = await client.twitter.trends({ limit: 10, location: "US" });
@@ -5189,7 +5501,7 @@ var TwitterNamespace = class {
    *
    * 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.
+   * Price: $0.00018 per request.
    *
    * @example
    * const res = await client.twitter.tweet({ url: "https://x.com/SpaceX/status/1732824684683784516" });
@@ -5242,9 +5554,9 @@ var TwitterNamespace = class {
   /**
    * X / Twitter User Tweets and Replies
    *
-   * Get up to the requested limit of tweets and replies authored by an X (Twitter) account in one bulk call, with engagement, views, and language. The current lane returns nextCursor as null; cursor is reserved for future cursor-capable lanes.
+   * Get up to the requested limit of tweets and replies authored by an X (Twitter) account, with engagement, views, language, and cursor pagination where available.
    *
-   * Price: $0 per request plus $0.00021 per result (maximum $0.21).
+   * Price: $0.00018 per request plus $0.00018 per result (maximum $0.01818).
    *
    * @example
    * const res = await client.twitter.userTweets({ handle: "levelsio", limit: 20 });
@@ -5957,7 +6269,7 @@ var ZillowNamespace = class {
    *
    * Search Zillow for-sale, rental, or sold listings by region-level location (city, ZIP, county, or neighborhood) with optional price, bedroom, living-area, home-type, recency, and sort filters and get matching properties (price, address, beds, baths, living area, status, Zestimate) as normalized JSON.
    *
-   * Price: $0.00053 per request plus $0.00315 per result (maximum $0.0793).
+   * Price: $0.0009 per request.
    *
    * @example
    * const res = await client.zillow.search({ location: "Austin, TX", limit: 3, maxPrice: 900000, minBedrooms: 3, operation: "buy" });
@@ -6045,6 +6357,20 @@ var AnyAPI2 = class extends AnyAPI {
       this._core
     );
   }
+  /**
+   * Typed methods for the company_enrichment platform.
+   */
+  get companyEnrichment() {
+    return this._namespaces["companyEnrichment"] ??= new CompanyEnrichmentNamespace(this._core);
+  }
+  /**
+   * Typed methods for the company_search platform.
+   */
+  get companySearch() {
+    return this._namespaces["companySearch"] ??= new CompanySearchNamespace(
+      this._core
+    );
+  }
   /**
    * Typed methods for the congress platform.
    */
@@ -6085,6 +6411,20 @@ var AnyAPI2 = class extends AnyAPI {
       this._core
     );
   }
+  /**
+   * Typed methods for the email_finding platform.
+   */
+  get emailFinding() {
+    return this._namespaces["emailFinding"] ??= new EmailFindingNamespace(
+      this._core
+    );
+  }
+  /**
+   * Typed methods for the email_verification platform.
+   */
+  get emailVerification() {
+    return this._namespaces["emailVerification"] ??= new EmailVerificationNamespace(this._core);
+  }
   /**
    * Typed methods for the facebook platform.
    */
@@ -6189,6 +6529,14 @@ var AnyAPI2 = class extends AnyAPI {
       this._core
     );
   }
+  /**
+   * Typed methods for the mobile_phone platform.
+   */
+  get mobilePhone() {
+    return this._namespaces["mobilePhone"] ??= new MobilePhoneNamespace(
+      this._core
+    );
+  }
   /**
    * Typed methods for the pandaexpress platform.
    */
@@ -6197,6 +6545,14 @@ var AnyAPI2 = class extends AnyAPI {
       this._core
     );
   }
+  /**
+   * Typed methods for the people_search platform.
+   */
+  get peopleSearch() {
+    return this._namespaces["peopleSearch"] ??= new PeopleSearchNamespace(
+      this._core
+    );
+  }
   /**
    * Typed methods for the person platform.
    */
@@ -6205,6 +6561,12 @@ var AnyAPI2 = class extends AnyAPI {
       this._core
     );
   }
+  /**
+   * Typed methods for the person_enrichment platform.
+   */
+  get personEnrichment() {
+    return this._namespaces["personEnrichment"] ??= new PersonEnrichmentNamespace(this._core);
+  }
   /**
    * Typed methods for the pinterest platform.
    */
@@ -6460,12 +6822,16 @@ export {
   BlueskyNamespace,
   BookingNamespace,
   CoinmarketcapNamespace,
+  CompanyEnrichmentNamespace,
+  CompanySearchNamespace,
   CongressNamespace,
   ConnectionError,
   DexscreenerNamespace,
   DouyinNamespace,
   EbayNamespace,
+  EmailFindingNamespace,
   EmailNamespace,
+  EmailVerificationNamespace,
   FacebookNamespace,
   FiverrNamespace,
   GithubNamespace,
@@ -6480,8 +6846,11 @@ export {
   InsufficientBalanceError,
   LinkedinNamespace,
   MapsNamespace,
+  MobilePhoneNamespace,
   NotFoundError,
   PandaexpressNamespace,
+  PeopleSearchNamespace,
+  PersonEnrichmentNamespace,
   PersonNamespace,
   PinterestNamespace,
   PlaystoreNamespace,
@@ -6491,6 +6860,7 @@ export {
   RedditNamespace,
   RedfinNamespace,
   RednoteNamespace,
+  RequestPendingError,
   ResultNotFoundError,
   SecNamespace,
   SemrushNamespace,