@graph8/sdk 0.293.0 → 0.294.1

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.1";
 /** 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.1";

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/appointments.md

@@ -598,7 +598,7 @@ Body fields (`CreateEventTypeRequest`):
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `body.length` | `integer` | yes |  |
+| `body.length` | `integer` | yes | min 5, max 525600 |
 | `body.slug` | `string` | yes |  |
 | `body.title` | `string` | yes |  |
 | `body.after_event_buffer` | `integer` | no | default `0` |
@@ -636,7 +636,7 @@ Body fields (`CreateEventTypeRequest`):
 **Example**
 
 ```ts
-const result = await g8.api.appointments.createEventType({ body: { length: 1, slug: "example", title: "Example" } });
+const result = await g8.api.appointments.createEventType({ body: { length: 5, slug: "example", title: "Example" } });
 ```
 
 ---
@@ -3335,7 +3335,7 @@ Body fields (`UpdateEventTypeRequest`):
 | `body.event_name` | `string \| null` | no |  |
 | `body.hidden` | `boolean \| null` | no |  |
 | `body.layouts` | `Array<string> \| null` | no |  |
-| `body.length` | `integer \| null` | no |  |
+| `body.length` | `integer \| null` | no | min 5, max 525600 |
 | `body.locations` | `Array<Record<string, unknown>> \| null` | no |  |
 | `body.metadata` | `Record<string, unknown> \| null` | no |  |
 | `body.minimum_booking_notice` | `integer \| null` | no |  |

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/api/quotes.d.ts

@@ -379,7 +379,6 @@ export interface QuotesOperations {
   get_company_revenue_summary_stripe_companies__company_id__revenue_summary_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     headers?: {
@@ -396,7 +395,6 @@ export interface QuotesOperations {
   get_company_stripe_invoices_stripe_companies__company_id__invoices_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     query?: {
@@ -418,7 +416,6 @@ export interface QuotesOperations {
   get_company_stripe_subscriptions_stripe_companies__company_id__subscriptions_get: {
     input: {
     path: {
-      /** graph8 company id. */
       company_id: number;
     };
     headers?: {

package/docs/api/quotes.md

@@ -898,7 +898,7 @@ Total paid, MRR, invoice count and customer-since date for one company.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 
 **Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 
@@ -929,7 +929,7 @@ A company's Stripe invoice history, newest first.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 | `query.page` | `integer` | no | 1-based page. default `1` |
 | `query.limit` | `integer` | no | default `50` |
 
@@ -968,7 +968,7 @@ A company's current Stripe subscriptions, through its customer mapping.
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `path.company_id` | `integer` | yes | graph8 company id. |
+| `path.company_id` | `integer` | yes |  |
 
 **Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 

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.1",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",