@absolutejs/engagement-apollo 0.0.8 → 0.0.9

package/README.md

@@ -25,8 +25,9 @@ const activity = await apollo.listActivities?.({
 | `enrichCompany`  | `GET /v1/organizations/enrich`     | Domain required.                                                                                                                                             |
 | `listActivities` | `POST /v1/emailer_messages/search` | **Plan-gated** — engagement API access varies by Apollo plan. Returns `[]` if unsupported; verify field mapping against a live account before relying on it. |
 
-All calls fail soft: a non-2xx response or an unexpected shape returns `null` / `[]`
-rather than throwing, so a consumer can treat the source as best-effort.
+Company enrichment preserves provider identity and annual revenue with observation time and provider-estimate attribution. Currency remains unknown when the provider does not specify it.
+
+Company enrichment returns `null` for no match (404), throws `RateLimitError` for 429, and throws `EngagementProviderError` for authentication, permission, server, or malformed-response failures. Errors exclude raw response bodies and credentials. Person/activity endpoints retain their existing behavior.
 
 ## License
 

package/dist/index.js

@@ -1,6 +1,9 @@
 // @bun
 // src/index.ts
-import { RateLimitError } from "@absolutejs/engagement";
+import {
+  EngagementProviderError,
+  RateLimitError
+} from "@absolutejs/engagement";
 var APOLLO_BASE_URL = "https://api.apollo.io";
 var DEFAULT_ACTIVITY_LIMIT = 50;
 var DEFAULT_SEARCH_LIMIT = 6;
@@ -36,10 +39,14 @@ var apolloSource = (options) => {
     const res = await doFetch(`${baseUrl}${path}`, { headers, method: "GET" });
     if (res.status === 429)
       throw new RateLimitError("apollo");
-    if (!res.ok)
+    if (res.status === 404)
       return null;
+    if (!res.ok)
+      throw new EngagementProviderError("apollo", res.status, "company enrichment");
     const json = await res.json();
-    return isRecord(json) ? json : null;
+    if (!isRecord(json))
+      throw new EngagementProviderError("apollo", 502, "invalid company response");
+    return json;
   };
   const normalizePerson = (person) => {
     const org = isRecord(person.organization) ? person.organization : null;
@@ -116,7 +123,18 @@ var apolloSource = (options) => {
     const org = json && isRecord(json.organization) ? json.organization : null;
     if (!org)
       return null;
+    const revenue = num(org.annual_revenue);
+    const revenueDisplay = str(org.annual_revenue_printed);
     return {
+      providerId: str(org.id),
+      annualRevenue: revenue !== null && revenue > 0 || revenueDisplay ? {
+        amount: revenue !== null && revenue > 0 ? revenue : null,
+        display: revenueDisplay,
+        currency: null,
+        basis: "provider_estimate",
+        provider: "apollo",
+        observedAt: new Date().toISOString()
+      } : null,
       description: str(org.short_description),
       domain: str(org.primary_domain),
       employeeCount: num(org.estimated_num_employees),

package/package.json

@@ -2,7 +2,7 @@
   "author": "Alex Kahn",
   "description": "Apollo.io EngagementSource adapter for @absolutejs/engagement — person/company enrichment and outreach activity (emails sent/opened/replied) from the Apollo API.",
   "devDependencies": {
-    "@absolutejs/engagement": "0.0.8",
+    "@absolutejs/engagement": "0.0.9",
     "@types/bun": "1.3.14",
     "prettier": "3.8.1",
     "typescript": "5.9.3"
@@ -23,7 +23,7 @@
   "main": "./dist/index.js",
   "name": "@absolutejs/engagement-apollo",
   "peerDependencies": {
-    "@absolutejs/engagement": ">=0.0.8 <0.1"
+    "@absolutejs/engagement": ">=0.0.9 <0.1"
   },
   "publishConfig": {
     "access": "public"
@@ -40,11 +40,11 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "verify-package": "absolute-manifest verify-package",
-    "check:package": "bun run format && bun run typecheck && bun run test && bun run verify-package && bun run build && bun run verify-package --artifacts"
+    "check:package": "bun run format && bun run typecheck && bun run test && bun run verify-package && bun run build"
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -59,24 +59,10 @@
     "./manifest.json": "./dist/manifest.json"
   },
   "absolutejs": {
-    "manifestContract": 2,
-    "runtimePeers": {
-      "@absolutejs/engagement": {
-        "artifactImports": [
-          "@absolutejs/engagement"
-        ],
-        "buildExternals": [
-          "@absolutejs/engagement",
-          "@absolutejs/engagement/*"
-        ],
-        "optional": false,
-        "range": ">=0.0.8 <0.1",
-        "tested": "0.0.8"
-      }
-    }
+    "manifestContract": 2
   },
   "dependencies": {
-    "@absolutejs/manifest": "0.7.2",
+    "@absolutejs/manifest": "0.9.0",
     "@sinclair/typebox": "0.34.52"
   }
 }