@graph8/sdk 0.245.0 → 0.251.0

package/dist/index.mjs

@@ -430,6 +430,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",
@@ -938,6 +939,10 @@ var EXTERNAL_ROUTES = {
   ]
 };
 
+// src/version.ts
+var SDK_VERSION = "0.251.0";
+var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
+
 // src/http.ts
 var G8Error = class _G8Error extends Error {
   constructor(args) {
@@ -1120,6 +1125,7 @@ async function request(baseUrl, path, apiKey, opts = {}) {
   const finalHeaders = {
     "Content-Type": "application/json",
     Authorization: `Bearer ${apiKey}`,
+    ...clientIdentityHeaders(headers),
     ...headers
   };
   warnIfTargetOrgIgnored(apiKey, headers);
@@ -1165,6 +1171,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 (; ; ) {
@@ -1791,6 +1814,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, {
@@ -1800,6 +1827,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, {
@@ -2055,7 +2096,7 @@ var createMailboxesClient = (apiKey, apiUrl) => {
 };
 
 // src/generated/operations.ts
-var API_OPERATION_COUNT = 3247;
+var API_OPERATION_COUNT = 3251;
 var API_OPERATIONS = {
   accept_audience_pipeline_filters_campaigns__campaign_id__audience_pipeline_accept_filters_post: ["POST", "/campaigns/{campaign_id}/audience-pipeline/accept-filters", "campaigns", "acceptAudiencePipelineFilters", "billable", "campaigns:run"],
   accept_my_offer_marketplace_me_offers__hiring_id__accept_post: ["POST", "/marketplace/me/offers/{hiring_id}/accept", "marketplace", "acceptMyOffer", "billable", "marketplace:run"],
@@ -2114,6 +2155,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"],
@@ -2194,6 +2236,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"],
@@ -4268,6 +4311,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"],
@@ -5113,6 +5157,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"],