@absolutejs/engagement-apollo 0.0.15 → 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;
@@ -66,7 +84,7 @@ var apolloSource = (options) => {
     if (res.status === 429)
       throw new RateLimitError("apollo");
     if (!res.ok)
-      throw new EngagementProviderError("apollo", res.status, path);
+      throw await providerFailure(res, path);
     const json = await res.json().catch(() => null);
     if (!isRecord(json))
       throw new EngagementProviderError("apollo", 502, `invalid ${path} response`);
@@ -215,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");
@@ -301,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.15",
+  "version": "0.0.16",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",