@graph8/sdk 0.251.0 → 0.260.0

package/dist/index.mjs

@@ -940,7 +940,7 @@ var EXTERNAL_ROUTES = {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.251.0";
+var SDK_VERSION = "0.260.0";
 var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
 
 // src/http.ts
@@ -1797,8 +1797,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 = {}) {
@@ -1806,6 +1819,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);
@@ -2096,7 +2134,7 @@ var createMailboxesClient = (apiKey, apiUrl) => {
 };
 
 // src/generated/operations.ts
-var API_OPERATION_COUNT = 3251;
+var API_OPERATION_COUNT = 3252;
 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"],
@@ -2257,6 +2295,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"],
@@ -7392,7 +7431,9 @@ 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/appTokens.ts
 var DEFAULT_APP_API = "https://be.graph8.com";