@graph8/sdk 0.251.0 → 0.262.0

package/dist/react.js

@@ -1,8 +1,10 @@
 "use strict";
 "use client";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,6 +18,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/react.tsx
@@ -25,6 +35,7 @@ __export(react_exports, {
   useG8: () => useG8
 });
 module.exports = __toCommonJS(react_exports);
+var React = __toESM(require("react"));
 var import_react = require("react");
 
 // src/core.ts
@@ -969,7 +980,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
@@ -1826,8 +1837,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 = {}) {
@@ -1835,6 +1859,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);
@@ -2285,6 +2334,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"],
@@ -7418,10 +7468,11 @@ var G8 = class {
     if (!this.config.apiKey) throw new Error(`g8.${module2} 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
-var import_jsx_runtime = require("react/jsx-runtime");
 var G8Context = (0, import_react.createContext)(g8);
 var G8Provider = ({
   writeKey,
@@ -7429,12 +7480,10 @@ var G8Provider = ({
   config,
   children
 }) => {
-  (0, import_react.useEffect)(() => {
-    if (!g8.initialized) {
-      g8.init({ writeKey, host, ...config });
-    }
-  }, [writeKey, host, config]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.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 = (0, import_react.useContext)(G8Context);
@@ -7447,8 +7496,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
   };