@graph8/sdk 0.251.0 → 0.262.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";
@@ -945,7 +946,7 @@ var EXTERNAL_ROUTES = {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.251.0";
+var SDK_VERSION = "0.262.0";
 var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
 
 // src/http.ts
@@ -1802,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 = {}) {
@@ -1811,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);
@@ -2261,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"],
@@ -7394,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,
@@ -7405,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);
@@ -7423,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
   };