@getanyapi/sdk 0.16.1 → 0.18.0

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,36 @@ 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 ?? {});
+    const startedAt = Date.now();
+    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 } : {},
+        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 ?? {});
-    return this.request(
+    const response = await this.request(
       "POST",
       buildUrl(this.baseUrl, slug, options),
       {
@@ -608,9 +642,63 @@ 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 } : {},
+        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. */
   balance() {
@@ -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.";
@@ -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,84 @@ 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.
+   *
+   * @example
+   * const res = await client.emailFinding.icypeas({ domainOrCompany: "apollo.io", firstname: "Tim", lastname: "Zheng" });
+   */
+  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.
+   *
+   * @example
+   * const res = await client.emailVerification.bounceban({ email: "tim@apollo.io", mode: "regular" });
+   */
+  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 +3595,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 +3673,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 +3725,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) {
@@ -5132,12 +5450,12 @@ var TwitterNamespace = class {
   /**
    * X / Twitter Post Replies
    *
-   * Fetch the replies to any X (Twitter) post URL as structured records: author, text, and engagement.
+   * Fetch the replies to any X (Twitter) post URL as structured records: author, text, and engagement. An empty result is valid and does not assert whether the target post exists.
    *
-   * Price: $0.00018 per request plus $0.00018 per result (maximum $0.00666).
+   * Price: $0.00075 per request.
    *
    * @example
-   * const res = await client.twitter.replies({ url: "https://x.com/jack/status/20", limit: 3 });
+   * const res = await client.twitter.replies({ url: "https://x.com/jack/status/20" });
    */
   replies(input, options) {
     return this._core.run("twitter.replies", input, options);
@@ -5171,6 +5489,19 @@ var TwitterNamespace = class {
       options
     );
   }
+  /**
+   * X / Twitter Tweet Thread
+   *
+   * Resolve the linear self-thread containing an X (Twitter) post, from its root through the author's linked continuations. This excludes replies from other users.
+   *
+   * Price: $0.005 per request.
+   *
+   * @example
+   * const res = await client.twitter.thread({ url: "https://x.com/SpaceX/status/1732824684683784516" });
+   */
+  thread(input, options) {
+    return this._core.run("twitter.thread", input, options);
+  }
   /**
    * X / Twitter Trends
    *
@@ -6045,6 +6376,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 +6430,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 +6548,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 +6564,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 +6580,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 +6841,16 @@ export {
   BlueskyNamespace,
   BookingNamespace,
   CoinmarketcapNamespace,
+  CompanyEnrichmentNamespace,
+  CompanySearchNamespace,
   CongressNamespace,
   ConnectionError,
   DexscreenerNamespace,
   DouyinNamespace,
   EbayNamespace,
+  EmailFindingNamespace,
   EmailNamespace,
+  EmailVerificationNamespace,
   FacebookNamespace,
   FiverrNamespace,
   GithubNamespace,
@@ -6480,8 +6865,11 @@ export {
   InsufficientBalanceError,
   LinkedinNamespace,
   MapsNamespace,
+  MobilePhoneNamespace,
   NotFoundError,
   PandaexpressNamespace,
+  PeopleSearchNamespace,
+  PersonEnrichmentNamespace,
   PersonNamespace,
   PinterestNamespace,
   PlaystoreNamespace,
@@ -6491,6 +6879,7 @@ export {
   RedditNamespace,
   RedfinNamespace,
   RednoteNamespace,
+  RequestPendingError,
   ResultNotFoundError,
   SecNamespace,
   SemrushNamespace,