@graph8/sdk 0.245.0 → 0.260.0

package/dist/react.mjs

@@ -1,7 +1,8 @@
 "use client";
 
 // src/react.tsx
-import { createContext, useContext, useEffect } from "react";
+import * as React from "react";
+import { createContext, useContext } from "react";
 
 // src/core.ts
 import { jitsuAnalytics } from "@jitsu/js";
@@ -435,6 +436,7 @@ var BILLABLE_ROUTES = {
     "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs",
     "/enrichment/lookup/company",
     "/enrichment/lookup/person",
+    "/enrichment/person",
     "/enrichment/record-sync/{entity_type}/run",
     "/enrichment/verify-email",
     "/enrichment/waterfall/configs",
@@ -943,6 +945,10 @@ var EXTERNAL_ROUTES = {
   ]
 };
 
+// src/version.ts
+var SDK_VERSION = "0.260.0";
+var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
+
 // src/http.ts
 var G8Error = class _G8Error extends Error {
   constructor(args) {
@@ -1125,6 +1131,7 @@ async function request(baseUrl, path, apiKey, opts = {}) {
   const finalHeaders = {
     "Content-Type": "application/json",
     Authorization: `Bearer ${apiKey}`,
+    ...clientIdentityHeaders(headers),
     ...headers
   };
   warnIfTargetOrgIgnored(apiKey, headers);
@@ -1170,6 +1177,23 @@ async function request(baseUrl, path, apiKey, opts = {}) {
     throw await toG8Error(resp, billable ? statusRetryable : isRetryableStatus(resp.status));
   }
 }
+function isServerRuntime() {
+  const g = globalThis;
+  if (typeof g.window !== "undefined") return false;
+  return typeof g.process?.versions?.node === "string";
+}
+function runtimeUserAgent() {
+  const g = globalThis;
+  const node = typeof g.process?.version === "string" ? ` node/${g.process.version.replace(/^v/, "")}` : "";
+  return `graph8-sdk-js/${SDK_VERSION}${node}`;
+}
+function clientIdentityHeaders(callerHeaders = {}) {
+  const taken = new Set(Object.keys(callerHeaders).map((h) => h.toLowerCase()));
+  const out = {};
+  if (!taken.has("x-g8-client")) out["X-G8-Client"] = SDK_CLIENT_ID;
+  if (!taken.has("user-agent") && isServerRuntime()) out["User-Agent"] = runtimeUserAgent();
+  return out;
+}
 async function* paginate(fetchPage) {
   let cursor = void 0;
   for (; ; ) {
@@ -1779,8 +1803,21 @@ var createWebhooksClient = (_apiKey, apiUrl) => {
 
 // src/contacts.ts
 var DEFAULT_API12 = "https://be.graph8.com";
+var CONTACT_BULK_GET_MAX = 100;
 var createContactsClient = (apiKey, apiUrl) => {
   const baseUrl = apiUrl || DEFAULT_API12;
+  async function getMany(contactIds, options = {}) {
+    const ids = [...new Set(contactIds)];
+    const out = [];
+    for (let i = 0; i < ids.length; i += CONTACT_BULK_GET_MAX) {
+      const resp = await request(baseUrl, "/api/v1/contacts/bulk-get", apiKey, {
+        method: "POST",
+        body: { contact_ids: ids.slice(i, i + CONTACT_BULK_GET_MAX), include_custom_fields: options.includeCustomFields ?? false }
+      });
+      out.push(...resp.data.items);
+    }
+    return out;
+  }
   return {
     /** List contacts with optional filters. */
     async list(params = {}) {
@@ -1788,6 +1825,31 @@ var createContactsClient = (apiKey, apiUrl) => {
         query: params
       });
     },
+    /**
+     * Full records for many contacts (`POST /api/v1/contacts/bulk-get`), in input
+     * order. Any number of ids: they are sent 100 per request, so 1,000 ids cost
+     * 10 requests instead of 1,000 `get()` calls. Missing or out-of-scope ids come
+     * back `found: false` rather than throwing. Duplicate ids are read once.
+     */
+    getMany: (contactIds, options = {}) => getMany(contactIds, options),
+    /**
+     * One page of `list()`, with every contact's FULL record (`created_at`,
+     * `updated_at`, `full_name`, `personal_emails`, `company`, ...). `list()`
+     * returns a leaner shape. Costs one `list()` request plus one `getMany()`
+     * request per 100 contacts on the page. `missing` holds ids that were listed
+     * but could not be read (for example deleted in between).
+     */
+    async listDetailed(params = {}, options = {}) {
+      const page = await request(baseUrl, "/api/v1/contacts", apiKey, {
+        query: params
+      });
+      const items = await getMany(page.data.map((c) => c.id), options);
+      return {
+        data: items.filter((it) => it.found && it.contact).map((it) => it.contact),
+        total: page.total,
+        missing: items.filter((it) => !it.found).map((it) => it.contact_id)
+      };
+    },
     /** Get a single contact by ID. */
     async get(contactId) {
       const resp = await request(baseUrl, `/api/v1/contacts/${contactId}`, apiKey);
@@ -1796,6 +1858,10 @@ var createContactsClient = (apiKey, apiUrl) => {
     /**
      * Create a new contact. Pass `idempotencyKey` to make a retry safe — the
      * same key returns the first result instead of creating a duplicate (A6).
+     *
+     * Create-only: if a contact with the same work_email / linkedin_url exists,
+     * this throws a 409 `G8Error` whose `detail.hint` / `detail.upsert` name the
+     * create-or-update route. When the contact may already exist, use `upsert()`.
      */
     async create(contact, idempotencyKey) {
       const resp = await request(baseUrl, "/api/v1/contacts", apiKey, {
@@ -1805,6 +1871,20 @@ var createContactsClient = (apiKey, apiUrl) => {
       });
       return resp.data ?? resp;
     },
+    /**
+     * Create or update a contact in one idempotent call (`PUT /contacts/assert`).
+     * Matches by `work_email`, then `linkedin_url`. Prefer this over `create()`
+     * when the contact may already exist: `create()` returns a 409 for a
+     * duplicate, while `upsert()` updates it. Safe to retry. The server answers
+     * 400 (a `G8Error`) when neither `work_email` nor `linkedin_url` is given.
+     */
+    async upsert(contact) {
+      const resp = await request(baseUrl, "/api/v1/contacts/assert", apiKey, {
+        method: "PUT",
+        body: contact
+      });
+      return resp.data ?? resp;
+    },
     /** Update a contact (partial). */
     async update(contactId, fields) {
       return request(baseUrl, `/api/v1/contacts/${contactId}`, apiKey, {
@@ -2118,6 +2198,7 @@ var API_OPERATIONS = {
   analyze_website_intelligence_analyze_post: ["POST", "/intelligence/analyze", "companyIntelligence", "analyzeWebsite", "billable", "knowledge:run"],
   annotate_my_invoice_marketplace_me_invoices__invoice_id__put: ["PUT", "/marketplace/me/invoices/{invoice_id}", "marketplace", "annotateMyInvoice", "billable", "marketplace:run"],
   answer_agent_discovery_agent_onboarding_discovery_answer_post: ["POST", "/agent/onboarding/discovery/answer", "agents", "answerAgentDiscovery", "write", "workflows:write"],
+  api_health_health_get: ["GET", "/health", "health", "apiHealth", "read", null],
   app_token_jwks_app_platform__well_known_jwks_json_get: ["GET", "/app-platform/.well-known/jwks.json", "appPlatformTokens", "appTokenJwks", "read", null],
   append_copilot_memory_document_copilot_memory_documents_append_post: ["POST", "/copilot/memory/documents/append", "copilot", "appendCopilotMemoryDocument", "write", "knowledge:write"],
   apply_account_plan_desk_accounts__account_id__plan_apply_post: ["POST", "/desk/accounts/{account_id}/plan/apply", "desk", "applyAccountPlan", "write", "deals:write"],
@@ -2198,6 +2279,7 @@ var API_OPERATIONS = {
   backfill_content_pages_content_pages_backfill_post: ["POST", "/content/pages/backfill", "content", "backfillContentPages", "write", "campaigns:write"],
   backfill_grading_dialer_parallel_calls_grading_backfill_post: ["POST", "/dialer/parallel-calls/grading/backfill", "dialer", "backfillGrading", "billable", "voice:run"],
   backfill_library_case_studies_library_case_studies_backfill_post: ["POST", "/library/case-studies/backfill", "library", "backfillLibraryCaseStudies", "billable", "knowledge:run"],
+  batch_contact_related_contacts_related_post: ["POST", "/contacts/related", "contacts", "batchContactRelated", "read", "contacts:read"],
   batch_create_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_post: ["POST", "/integrations/crm/connections/{connection_id}/batch/contacts", "integrations", "batchCreateCrmContacts", "external", "integrations:run"],
   batch_email_agent_voice_email_agent_batch_post: ["POST", "/voice/email-agent/batch", "voice", "batchEmailAgent", "billable", "voice:run"],
   batch_quote_action_quotes_batch_post: ["POST", "/quotes/batch", "quotes", "batchQuoteAction", "external", "quotes:run"],
@@ -2218,6 +2300,7 @@ var API_OPERATIONS = {
   bulk_enrich_company_people_companies_enrich_people_bulk_post: ["POST", "/companies/enrich/people/bulk", "companies", "bulkEnrichCompanyPeople", "billable", "enrichment:run"],
   bulk_enrich_company_stakeholders_companies_enrich_stakeholders_bulk_post: ["POST", "/companies/enrich/stakeholders/bulk", "companies", "bulkEnrichCompanyStakeholders", "billable", "enrichment:run"],
   bulk_extract_workbench_columns_workbench_tables__table_id__columns_bulk_extract_post: ["POST", "/workbench/tables/{table_id}/columns/bulk-extract", "workbench", "bulkExtractWorkbenchColumns", "write", "lists:write"],
+  bulk_get_contacts_contacts_bulk_get_post: ["POST", "/contacts/bulk-get", "contacts", "bulkGetContacts", "read", "contacts:read"],
   bulk_import_mailboxes_mailboxes_bulk_import_post: ["POST", "/mailboxes/bulk-import", "mailboxes", "bulkImportMailboxes", "write", "campaigns:write"],
   bulk_restart_executions_workflows_executions_bulk_restart_post: ["POST", "/workflows/executions/bulk-restart", "workflows", "bulkRestartExecutions", "external", "workflows:run"],
   bulk_update_contacts_contacts_bulk_update_post: ["POST", "/contacts/bulk-update", "contacts", "bulkUpdateContacts", "write", "contacts:write"],
@@ -4272,6 +4355,7 @@ var API_OPERATIONS = {
   load_copilot_intent_context_copilot_context_load_post: ["POST", "/copilot/context/load", "agents", "loadCopilotIntentContext", "write", "workflows:write"],
   lookup_company_enrichment_lookup_company_post: ["POST", "/enrichment/lookup/company", "enrichment", "lookupCompany", "billable", "enrichment:run"],
   lookup_crm_contacts_by_email_integrations_crm_connections__connection_id__batch_contacts_lookup_by_email_post: ["POST", "/integrations/crm/connections/{connection_id}/batch/contacts/lookup-by-email", "integrations", "lookupCrmContactsByEmail", "read", "integrations:read"],
+  lookup_person_alias_enrichment_person_post: ["POST", "/enrichment/person", "enrichment", "lookupPersonAlias", "billable", "enrichment:run"],
   lookup_person_enrichment_lookup_person_post: ["POST", "/enrichment/lookup/person", "enrichment", "lookupPerson", "billable", "enrichment:run"],
   lookup_session_calls_dialer_parallel_calls_sessions__session_id__calls_post: ["POST", "/dialer/parallel-calls/sessions/{session_id}/calls", "voice", "lookupSessionCalls", "read", "voice:read"],
   manual_dial_dialer_parallel_calls_manual_dial_post: ["POST", "/dialer/parallel-calls/manual-dial", "dialer", "manualDial", "external", "voice:run"],
@@ -5117,6 +5201,7 @@ var API_OPERATIONS = {
   update_inbox_mailbox_settings_inbox_mailboxes__mailbox__settings_patch: ["PATCH", "/inbox/mailboxes/{mailbox}/settings", "aiInbox", "updateInboxMailboxSettings", "external", "inbox:run"],
   update_inbox_tag_inbox_tags__tag_id__put: ["PUT", "/inbox/tags/{tag_id}", "aiInbox", "updateInboxTag", "write", "inbox:write"],
   update_infrastructure_profile_org_infrastructure_put: ["PUT", "/org/infrastructure", "orgGovernance", "updateInfrastructureProfile", "write", "account:write"],
+  update_ip_allowlist_api_keys__api_key_id__ip_allowlist_put: ["PUT", "/api-keys/{api_key_id}/ip-allowlist", "apiKeys", "updateIpAllowlist", "write", "account:write"],
   update_issue_newsletters__newsletter_id__issues__issue_id__put: ["PUT", "/newsletters/{newsletter_id}/issues/{issue_id}", "newsletter", "updateIssue", "external", "newsletter:run"],
   update_landing_page_html_landing_pages__landing_page_id__update_html_post: ["POST", "/landing-pages/{landing_page_id}/update-html", "landingPages", "updateLandingPageHtml", "write", "campaigns:write"],
   update_landing_page_landing_pages__landing_page_id__patch: ["PATCH", "/landing-pages/{landing_page_id}", "landingPages", "updateLandingPage", "write", "campaigns:write"],
@@ -7349,10 +7434,11 @@ var G8 = class {
     if (!this.config.apiKey) throw new Error(`g8.${module} requires an API key. Use g8.init({ apiKey: '...' })`);
   }
 };
-var g8 = new G8();
+var G8_SINGLETON = /* @__PURE__ */ Symbol.for("@graph8/sdk/singleton");
+var _global = globalThis;
+var g8 = _global[G8_SINGLETON] ?? (_global[G8_SINGLETON] = new G8());
 
 // src/react.tsx
-import { jsx } from "react/jsx-runtime";
 var G8Context = createContext(g8);
 var G8Provider = ({
   writeKey,
@@ -7360,12 +7446,10 @@ var G8Provider = ({
   config,
   children
 }) => {
-  useEffect(() => {
-    if (!g8.initialized) {
-      g8.init({ writeKey, host, ...config });
-    }
-  }, [writeKey, host, config]);
-  return /* @__PURE__ */ jsx(G8Context.Provider, { value: g8, children });
+  if (!g8.initialized) {
+    g8.init({ writeKey, host, ...config });
+  }
+  return /* @__PURE__ */ React.createElement(G8Context.Provider, { value: g8 }, children);
 };
 var useG8 = () => {
   const client = useContext(G8Context);
@@ -7378,8 +7462,10 @@ var useG8 = () => {
     page: client.page.bind(client),
     /** Clear user identity */
     reset: client.reset.bind(client),
-    /** Progressive form helpers */
-    forms: client.forms,
+    /** Progressive form helpers (read lazily, so useG8() never throws on its own) */
+    get forms() {
+      return client.forms;
+    },
     /** Raw g8 client instance */
     g8: client
   };