@absolutejs/engagement-apollo 0.0.14 → 0.0.16

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { EngagementProviderError } from "@absolutejs/engagement";
 import type { EngagementSource } from "@absolutejs/engagement";
 export type ApolloOptions = {
     apiKey: string;
@@ -6,4 +7,9 @@ export type ApolloOptions = {
     /** Inject a fetch (tests, instrumentation). Defaults to global fetch. */
     fetchImpl?: typeof fetch;
 };
+/** Safe provider classification; response bodies and billing context stay private. */
+export declare class ApolloProviderError extends EngagementProviderError {
+    readonly code: string | null;
+    constructor(status: number, operation: string, code: string | null);
+}
 export declare const apolloSource: (options: ApolloOptions) => EngagementSource;

package/dist/index.js

@@ -8,6 +8,18 @@ var APOLLO_BASE_URL = "https://api.apollo.io";
 var DEFAULT_ACTIVITY_LIMIT = 50;
 var DEFAULT_SEARCH_LIMIT = 6;
 var LOCKED_EMAIL = /email_not_unlocked/iu;
+
+class ApolloProviderError extends EngagementProviderError {
+  code;
+  constructor(status, operation, code) {
+    super("apollo", status, operation);
+    this.code = code;
+    this.name = "ApolloProviderError";
+    if (code === "BILLING.LIMIT.CREDITS_EXHAUSTED") {
+      this.message = "Apollo lead credits are exhausted. An administrator must replenish the connected Apollo account; application credits do not fund Apollo.";
+    }
+  }
+}
 var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var str = (value) => typeof value === "string" && value.length > 0 ? value : null;
 var num = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
@@ -49,6 +61,12 @@ var reference = (value) => isRecord(value) ? {
   employeeCount: count(value.estimated_num_employees),
   industries: strings(value.industries)
 } : null;
+var providerFailure = async (res, operation) => {
+  const value = await res.json().catch(() => null);
+  const details = isRecord(value) && isRecord(value.error_details) ? value.error_details : null;
+  const code = details && typeof details.code === "string" && /^[A-Z0-9_.]{1,120}$/u.test(details.code) ? details.code : null;
+  return new ApolloProviderError(res.status, operation, code);
+};
 var apolloSource = (options) => {
   const baseUrl = options.baseUrl ?? APOLLO_BASE_URL;
   const doFetch = options.fetchImpl ?? fetch;
@@ -60,14 +78,17 @@ var apolloSource = (options) => {
     const res = await doFetch(`${baseUrl}${path}`, {
       body: JSON.stringify(body),
       headers,
-      method: "POST"
+      method: "POST",
+      signal: AbortSignal.timeout(30000)
     });
     if (res.status === 429)
       throw new RateLimitError("apollo");
     if (!res.ok)
-      return null;
-    const json = await res.json();
-    return isRecord(json) ? json : null;
+      throw await providerFailure(res, path);
+    const json = await res.json().catch(() => null);
+    if (!isRecord(json))
+      throw new EngagementProviderError("apollo", 502, `invalid ${path} response`);
+    return json;
   };
   const normalizePerson = (person) => {
     const org = isRecord(person.organization) ? person.organization : null;
@@ -100,33 +121,42 @@ var apolloSource = (options) => {
     };
   };
   const matchById = async (id) => {
-    const json = await post("/v1/people/match", { id });
-    const person = json && isRecord(json.person) ? json.person : null;
+    const json = await post("/api/v1/people/match", { id });
+    if (json.person !== null && !isRecord(json.person))
+      throw new EngagementProviderError("apollo", 502, "invalid person enrichment response");
+    const person = isRecord(json.person) ? json.person : null;
     return person ? normalizePerson(person) : null;
   };
   const enrichPerson = async (query) => {
-    const json = await post("/v1/people/match", {
+    const json = await post("/api/v1/people/match", {
       domain: query.domain,
       email: query.email,
       linkedin_url: query.linkedinUrl,
       name: query.name,
       organization_name: query.company
     });
-    const person = json && isRecord(json.person) ? json.person : null;
+    if (json.person !== null && !isRecord(json.person))
+      throw new EngagementProviderError("apollo", 502, "invalid person enrichment response");
+    const person = isRecord(json.person) ? json.person : null;
     return person ? normalizePerson(person) : null;
   };
   const searchPeople = async (query) => {
     const limit = query.limit ?? DEFAULT_SEARCH_LIMIT;
-    const search = await post("/v1/mixed_people/api_search", {
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+      throw new RangeError("Apollo people limit must be an integer from 1 to 100");
+    const search = await post("/api/v1/mixed_people/api_search", {
       page: 1,
       per_page: limit,
       ...query.titles && query.titles.length > 0 ? { person_titles: query.titles } : {},
       ...query.domain ? { q_organization_domains_list: [query.domain] } : {},
       ...!query.domain && query.company ? { q_keywords: query.company } : {}
     });
-    const searchRequests = search ? 1 : 0;
-    const previews = search && Array.isArray(search.people) ? search.people : [];
-    const ids = previews.map((person) => isRecord(person) ? str(person.id) : null).filter((id) => id !== null);
+    const searchRequests = 1;
+    if (!Array.isArray(search.people))
+      throw new EngagementProviderError("apollo", 502, "invalid people search response");
+    const ids = [
+      ...new Set(search.people.map((person) => isRecord(person) ? str(person.id) : null).filter((id) => id !== null))
+    ].slice(0, limit);
     if (ids.length === 0) {
       return { people: [], revealsAttempted: 0, searchRequests };
     }
@@ -203,7 +233,7 @@ var apolloSource = (options) => {
     if (res.status === 404 && !body)
       return null;
     if (!res.ok)
-      throw new EngagementProviderError("apollo", res.status, body ? "company search" : "company enrichment");
+      throw await providerFailure(res, body ? "company search" : "company enrichment");
     const value = await res.json();
     if (!isRecord(value))
       throw new EngagementProviderError("apollo", 502, "invalid company response");
@@ -289,5 +319,6 @@ var apolloSource = (options) => {
   };
 };
 export {
+  ApolloProviderError,
   apolloSource
 };

package/package.json

@@ -44,7 +44,7 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",