@graph8/sdk 0.293.0 → 0.294.0

package/dist/types/enrich.d.ts

@@ -34,7 +34,7 @@ export interface SearchResults {
 export declare const createEnrichClient: (apiKey: string, apiUrl?: string) => {
     /**
      * Look up a person by email, LinkedIn, or name + company. Costs 2 credits per
-     * lookup, charged even when no match is found (`found: false`).
+     * lookup, charged only when a match is found (`found: false` costs nothing).
      */
     person(params: {
         email?: string;
@@ -45,7 +45,7 @@ export declare const createEnrichClient: (apiKey: string, apiUrl?: string) => {
     }): Promise<PersonEnrichment>;
     /**
      * Look up a company by domain or name. Costs 2 credits per lookup, charged
-     * even when no match is found (`found: false`).
+     * only when a match is found (`found: false` costs nothing).
      */
     company(params: {
         domain?: string;

package/dist/types/react.d.ts

@@ -128,9 +128,7 @@ export declare const useG8: () => {
                 company_domain?: string;
             }): Promise<import("./enrich").PersonEnrichment>;
             company(params: {
-                domain
-                /** Progressive form helpers (read lazily, so useG8() never throws on its own) */
-                ? /** Progressive form helpers (read lazily, so useG8() never throws on its own) */: string;
+                domain?: string;
                 name?: string;
             }): Promise<import("./enrich").CompanyEnrichment>;
             verifyEmail(email: string): Promise<import("./enrich").EmailVerification>;

package/dist/types/version.d.ts

@@ -5,6 +5,6 @@
  * both together (the version-parity gate already pins package.json, the
  * lockfile and the CHANGELOG to each other).
  */
-export declare const SDK_VERSION = "0.293.0";
+export declare const SDK_VERSION = "0.294.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.293.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.294.0";

package/docs/agents.md

@@ -220,7 +220,7 @@ What you must do:
 - Get a human's confirmation before calling an `external`, `billable` or `destructive` operation, and say
   what it will do ("this sends the email to 240 contacts").
 - Keep bulk billable jobs small until the user confirms the cost (a person or company lookup is 2 credits,
-  charged even when no match is found).
+  charged only when a match is found).
 
 ## 8. Errors
 
@@ -376,7 +376,7 @@ for (const person of results.contacts) {
 
 ### Enrich one person or company
 
-You have an email, LinkedIn URL, name + company, or a domain and need the full profile. Each lookup costs 2 credits, charged even when no match is found, and an email verify costs 1 (tier `billable`), so the SDK will not blindly retry them on a 5xx.
+You have an email, LinkedIn URL, name + company, or a domain and need the full profile. Each lookup costs 2 credits, charged only when a match is found, and an email verify costs 1 (tier `billable`), so the SDK will not blindly retry them on a 5xx.
 
 ```ts
 import { g8 } from "@graph8/sdk";

package/docs/api/contacts.d.ts

@@ -852,7 +852,7 @@ export interface ContactsOperations {
       name?: string | null;
       /** Filter by job title (partial match) */
       job_title?: string | null;
-      /** Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. Pass several levels comma-separated to match any of them, e.g. `VP,SVP/EVP`. */
+      /** Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. `VP` (or `Vice President`) means VP and above, so it also returns the SVP/EVP band; `SVP/EVP` alone returns only that band. Pass several levels comma-separated to match any of them, e.g. `Director,VP`. */
       seniority_level?: string | null;
       /** Filter by company name (partial match) */
       company_name?: string | null;

package/docs/api/contacts.md

@@ -1887,7 +1887,7 @@ List contacts with optional filtering and pagination.
 | `query.list_id` | `integer \| null` | no | Filter by list ID |
 | `query.name` | `string \| null` | no | Filter by first or last name (partial match) |
 | `query.job_title` | `string \| null` | no | Filter by job title (partial match) |
-| `query.seniority_level` | `string \| null` | no | Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. Pass several levels comma-separated to match any of them, e.g. `VP,SVP/EVP`. |
+| `query.seniority_level` | `string \| null` | no | Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. `VP` (or `Vice President`) means VP and above, so it also returns the SVP/EVP band; `SVP/EVP` alone returns only that band. Pass several levels comma-separated to match any of them, e.g. `Direc… |
 | `query.company_name` | `string \| null` | no | Filter by company name (partial match) |
 | `query.company_id` | `integer \| null` | no | Filter by company ID |
 | `query.country` | `string \| null` | no | Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. |

package/docs/sdk-clients.md

@@ -1320,7 +1320,7 @@ Types: `dist/types/enrich.d.ts`
 g8.enrich.company: (params: { domain?: string; name?: string; }) => Promise<CompanyEnrichment>
 ```
 
-Look up a company by domain or name. Costs 2 credits per lookup, charged even when no match is found (`found: false`).
+Look up a company by domain or name. Costs 2 credits per lookup, charged only when a match is found (`found: false` costs nothing).
 
 - Calls `POST /api/v1/enrichment/lookup/company` ([`g8.api.enrichment.lookupCompany`](api/enrichment.md#op-lookupcompany), tier `billable`, scope `enrichment:run`)
 
@@ -1334,7 +1334,7 @@ Look up a company by domain or name. Costs 2 credits per lookup, charged even wh
 g8.enrich.person: (params: { email?: string; linkedin_url?: string; first_name?: string; last_name?: string; company_domain?: string; }) => Promise<PersonEnrichment>
 ```
 
-Look up a person by email, LinkedIn, or name + company. Costs 2 credits per lookup, charged even when no match is found (`found: false`).
+Look up a person by email, LinkedIn, or name + company. Costs 2 credits per lookup, charged only when a match is found (`found: false` costs nothing).
 
 - Calls `POST /api/v1/enrichment/lookup/person` ([`g8.api.enrichment.lookupPerson`](api/enrichment.md#op-lookupperson), tier `billable`, scope `enrichment:run`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.293.0",
+  "version": "0.294.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",