@graph8/sdk 0.7.2 → 0.12.0

package/dist/react.d.mts

@@ -436,11 +436,11 @@ interface ResearchReport {
  * Requires API key (server-side).
  *
  * Backed by:
- *   GET /api/v1/global-context/documents
- *   GET /api/v1/icps
- *   GET /api/v1/personas
- *   GET /api/v1/intelligence-data
- *   GET /api/v1/research-reports
+ *   GET   /api/v1/global-context/documents
+ *   GET   /api/v1/icps           POST /api/v1/icps           PATCH /api/v1/icps/{id}           POST /api/v1/icps/{id}/archive
+ *   GET   /api/v1/personas       POST /api/v1/personas       PATCH /api/v1/personas/{id}       POST /api/v1/personas/{id}/archive
+ *   GET   /api/v1/intelligence-data
+ *   GET   /api/v1/research-reports
  */
 declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
     /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
@@ -481,6 +481,66 @@ declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
     }): Promise<{
         data: ResearchReport[];
     }>;
+    /** Create an ICP manually (no AI scoring). Requires name + website_url. */
+    createIcp(body: {
+        name: string;
+        website_url: string;
+        description?: string;
+        firmographics?: Record<string, unknown>;
+        tech_stack?: Record<string, unknown>;
+        buying_signals?: unknown[];
+        estimated_market_size?: number;
+    }): Promise<{
+        data: ICP;
+    }>;
+    /** Update an ICP (partial - send only fields to change). */
+    updateIcp(icpId: string, body: {
+        name?: string;
+        description?: string;
+        firmographics?: Record<string, unknown>;
+        tech_stack?: Record<string, unknown>;
+        buying_signals?: unknown[];
+        estimated_market_size?: number;
+    }): Promise<{
+        data: ICP;
+    }>;
+    /** Archive an ICP (soft delete - sets status to "archived"). */
+    archiveIcp(icpId: string): Promise<{
+        data: ICP;
+    }>;
+    /** Create a buyer persona manually (no AI generation). Requires title + website_url. */
+    createPersona(body: {
+        title: string;
+        website_url: string;
+        priority?: number;
+        confidence?: string;
+        why_target?: string;
+        key_signals?: unknown[];
+        expected_receptivity?: string;
+        campaign_approach?: string;
+        recommended_goal?: string;
+        source?: string;
+    }): Promise<{
+        data: Persona;
+    }>;
+    /** Update a persona (partial). Passing status "archived" is equivalent to archivePersona. */
+    updatePersona(personaId: string, body: {
+        title?: string;
+        priority?: number;
+        confidence?: string;
+        why_target?: string;
+        key_signals?: unknown[];
+        expected_receptivity?: string;
+        campaign_approach?: string;
+        recommended_goal?: string;
+        status?: string;
+    }): Promise<{
+        data: Persona;
+    }>;
+    /** Archive a persona (soft delete - sets status to "archived"). */
+    archivePersona(personaId: string): Promise<{
+        data: Persona;
+    }>;
 };
 
 interface IntentKeyword {
@@ -1479,7 +1539,20 @@ interface Deal {
 }
 interface DealCreateParams {
     name: string;
-    /** Linked company ID. */
+    /**
+     * Deal owner (user id or email). Required.
+     */
+    owner_id: string;
+    /**
+     * mashup_contact_ids to attach. Required, at least one. Every contact must
+     * belong to the same company, and that company becomes the deal's company.
+     * Same id space as the contacts API. Attach is idempotent.
+     */
+    contact_ids: number[];
+    /**
+     * Deprecated: the company is derived from `contact_ids`. If supplied it must
+     * match the contacts' company, otherwise omit it.
+     */
     company_id?: number;
     description?: string;
     amount?: number;
@@ -1491,6 +1564,11 @@ interface DealCreateParams {
     pipeline_id?: string;
     /** ISO 8601 close date. */
     close_date?: string;
+    /**
+     * Set true to create a deal even if one already exists for the company.
+     * By default the API rejects a duplicate with HTTP 409.
+     */
+    allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
     name?: string;
@@ -1500,6 +1578,16 @@ interface DealUpdateParams {
     stage_id?: string;
     /** ISO 8601 close date. */
     close_date?: string;
+    /** Reassign the deal owner (user id or email). Pass null to clear. */
+    owner_id?: string | null;
+    /**
+     * mashup_contact_ids to link. Must belong to the deal's company (if the deal
+     * has none yet, the added contacts' company is adopted); a cross-company add
+     * is rejected. Idempotent.
+     */
+    add_contact_ids?: number[];
+    /** mashup_contact_ids to unlink. Idempotent. */
+    remove_contact_ids?: number[];
 }
 interface DealListParams {
     page?: number;
@@ -2061,7 +2149,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2088,56 +2176,11 @@ declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) => {
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };
 
-interface LandingPage {
-    id: string;
-    title: string;
-    slug: string;
-    status: string;
-    published_url: string | null;
-}
-/**
- * Landing pages - clone, create, publish. Requires API key (server-side). On the
- * hardened HTTP core: throws a typed `G8Error` on failure and retries transient
- * errors.
- */
-declare const createPagesClient: (apiKey: string, apiUrl?: string) => {
-    /** Clone a landing page from any URL. */
-    clone(url: string): Promise<LandingPage>;
-    /** Create a landing page from a template. */
-    create(config: {
-        template?: string;
-        title?: string;
-        content?: Record<string, unknown>;
-    }): Promise<LandingPage>;
-    /** Publish a landing page to CDN. */
-    publish(pageId: string): Promise<{
-        url: string;
-    }>;
-};
-
-interface VoiceSession {
-    id: string;
-    status: string;
-    agent: string;
-    started_at: string;
-}
-interface CallAnalysis {
-    duration_seconds: number;
-    sentiment: "positive" | "neutral" | "negative";
-    summary: string;
-    next_steps: string[];
-    objections: string[];
-    transcript: Array<{
-        speaker: string;
-        text: string;
-        timestamp: number;
-    }>;
-}
 type VoiceEvent = "connected" | "transcription" | "ended" | "error";
 type VoiceCallback = (data: Record<string, unknown>) => void;
 interface VoicePagination {
@@ -2369,20 +2412,6 @@ interface DialerSessionResumeResult extends DialerSessionStatusUpdateResult {
  *   GET    /api/v1/voice/dialer/agents
  */
 declare const createVoiceClient: (apiKey: string, apiUrl?: string) => {
-    /**
-     * Start an AI voice session.
-     * @deprecated Preview surface — for parallel-dialer flows use `voice.dialer.createSession()`.
-     */
-    start(config: {
-        agent?: string;
-        contactId?: number;
-        context?: Record<string, unknown>;
-    }): Promise<VoiceSession>;
-    /**
-     * Get call analysis for a completed session.
-     * @deprecated Preview surface — for dialer-call grading use `voice.dialer.callGrading(roomName)`.
-     */
-    analysis(sessionId: string): Promise<CallAnalysis>;
     /** Listen for voice events. */
     on(event: VoiceEvent, callback: VoiceCallback): void;
     /** Parallel-dialer session control + analytics. */
@@ -2450,31 +2479,6 @@ declare const createVoiceClient: (apiKey: string, apiUrl?: string) => {
     };
 };
 
-interface AnalyticsOverview {
-    visitors: number;
-    contacts_created: number;
-    emails_sent: number;
-    emails_opened: number;
-    replies: number;
-    meetings_booked: number;
-    period: string;
-}
-/**
- * Analytics - dashboard data and metrics. Requires API key (server-side).
- *
- * On the hardened HTTP core: throws a typed `G8Error` on failure and retries
- * transient errors. Note the deliberate behavior change vs the preview client —
- * a non-2xx response now **throws** instead of silently returning an all-zeros
- * overview, so callers can distinguish genuinely-zero activity from an auth/5xx
- * failure.
- */
-declare const createAnalyticsClient: (apiKey: string, apiUrl?: string) => {
-    overview(config?: {
-        period?: string;
-        metrics?: string[];
-    }): Promise<AnalyticsOverview>;
-};
-
 interface IntentSignals {
     domain: string;
     score: number;
@@ -2492,25 +2496,6 @@ declare const createSignalsClient: (key: string, isApiKey: boolean, apiUrl?: str
     stream(domains: string[], callback: (signals: IntentSignals[]) => void): () => void;
 };
 
-interface Integration {
-    id: string;
-    provider: string;
-    status: string;
-    connected_at: string | null;
-}
-/**
- * Integrations - connect CRM platforms, trigger syncs. Requires API key
- * (server-side). On the hardened HTTP core: throws a typed `G8Error` on failure
- * and retries transient errors.
- */
-declare const createIntegrationsClient: (apiKey: string, apiUrl?: string) => {
-    list(): Promise<Integration[]>;
-    connect(provider: string, config?: Record<string, unknown>): Promise<void>;
-    sync(provider: string, config?: {
-        direction?: "inbound" | "outbound" | "bidirectional";
-    }): Promise<void>;
-};
-
 interface Campaign {
     id: string;
     name: string;
@@ -2529,11 +2514,37 @@ interface CampaignCreateConfig {
     target_persona?: string;
     goal?: string;
 }
-interface CampaignStats {
-    sent: number;
-    opened: number;
-    replied: number;
-    meetings: number;
+interface CampaignLaunchExecution {
+    status: string;
+    contacts_total?: number;
+    contacts_scheduled?: number;
+    contacts_queued?: number;
+    job_id?: string;
+    polling_url?: string;
+    orchestrator_version?: string;
+}
+interface CampaignLaunchResult {
+    status: string;
+    campaign_id: string;
+    sequence_id: string;
+    sequence_name: string;
+    steps_created: number;
+    link_id: string;
+    warnings: string[];
+    channels_attached: Array<{
+        mailbox_id: number;
+        email: string;
+        channel_type: string;
+        auto_picked: boolean;
+    }>;
+    agent_assigned: {
+        textual_agent_name: string | null;
+        voice_agent_name: string | null;
+    };
+    schedule_id: string | null;
+    appointment_id: number | null;
+    execution: CampaignLaunchExecution;
+    message: string;
 }
 /**
  * Campaigns - create, manage, launch campaigns. Requires API key (server-side).
@@ -2544,8 +2555,7 @@ declare const createCampaignsClient: (apiKey: string, apiUrl?: string) => {
     list(page?: number, limit?: number): Promise<Campaign[]>;
     get(campaignId: string): Promise<Campaign>;
     create(config: CampaignCreateConfig): Promise<Campaign>;
-    launch(campaignId: string): Promise<void>;
-    stats(campaignId: string): Promise<CampaignStats>;
+    launch(campaignId: string): Promise<CampaignLaunchResult>;
 };
 
 interface AddToSequenceConfig {
@@ -2845,7 +2855,7 @@ declare const createEnrichClient: (apiKey: string, apiUrl?: string) => {
     }): Promise<CompanyEnrichment>;
     /** Verify an email address. Costs 1 credit. */
     verifyEmail(email: string): Promise<EmailVerification>;
-    /** Search 300M+ contacts with filters. Credits charged per result. */
+    /** Search 700M+ contacts with filters. Credits charged per result. */
     search(filters: SearchFilter[], page?: number, limit?: number): Promise<SearchResults>;
 };
 
@@ -3074,7 +3084,7 @@ interface G8ProviderProps {
  * graph8 React provider. Initializes the SDK once and provides it to all children.
  *
  * Usage:
- *   import { G8Provider } from '@graph8/js/react';
+ *   import { G8Provider } from '@graph8/sdk/react';
  *
  *   <G8Provider writeKey="your_write_key">
  *     <App />
@@ -3113,11 +3123,8 @@ declare const useG8: () => {
         _enrich: ReturnType<typeof createEnrichClient> | null;
         _sequences: ReturnType<typeof createSequencesClient> | null;
         _campaigns: ReturnType<typeof createCampaignsClient> | null;
-        _integrations: ReturnType<typeof createIntegrationsClient> | null;
         _signals: ReturnType<typeof createSignalsClient> | null;
-        _analytics: ReturnType<typeof createAnalyticsClient> | null;
         _voice: ReturnType<typeof createVoiceClient> | null;
-        _pages: ReturnType<typeof createPagesClient> | null;
         _webhooks: ReturnType<typeof createWebhooksClient> | null;
         _contacts: ReturnType<typeof createContactsClient> | null;
         _companies: ReturnType<typeof createCompaniesClient> | null;
@@ -3217,33 +3224,13 @@ declare const useG8: () => {
             list(page?: number, limit?: number): Promise<Campaign[]>;
             get(campaignId: string): Promise<Campaign>;
             create(config: CampaignCreateConfig): Promise<Campaign>;
-            launch(campaignId: string): Promise<void>;
-            stats(campaignId: string): Promise<CampaignStats>;
-        };
-        get integrations(): {
-            list(): Promise<Integration[]>;
-            connect(provider: string, config?: Record<string, unknown>): Promise<void>;
-            sync(provider: string, config?: {
-                direction?: "inbound" | "outbound" | "bidirectional";
-            }): Promise<void>;
+            launch(campaignId: string): Promise<CampaignLaunchResult>;
         };
         get signals(): {
             company(domain: string): Promise<IntentSignals>;
             stream(domains: string[], callback: (signals: IntentSignals[]) => void): () => void;
         };
-        get analytics(): {
-            overview(config?: {
-                period?: string;
-                metrics?: string[];
-            }): Promise<AnalyticsOverview>;
-        };
         get voice(): {
-            start(config: {
-                agent?: string;
-                contactId?: number;
-                context?: Record<string, unknown>;
-            }): Promise<VoiceSession>;
-            analysis(sessionId: string): Promise<CallAnalysis>;
             on(event: "error" | "ended" | "connected" | "transcription", callback: (data: Record<string, unknown>) => void): void;
             dialer: {
                 listSessions(params?: DialerSessionsListParams): Promise<DialerSessionsListResult>;
@@ -3291,20 +3278,9 @@ declare const useG8: () => {
                 }>;
             };
         };
-        get pages(): {
-            clone(url: string): Promise<LandingPage>;
-            create(config: {
-                template?: string;
-                title?: string;
-                content?: Record<string, unknown>;
-            }): Promise<LandingPage>;
-            publish(pageId: string): Promise<{
-                url: string;
-            }>;
-        };
         get webhooks(): {
             baseUrl: string;
-            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.deployed", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
             constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
         };
         get contacts(): {
@@ -3781,6 +3757,60 @@ declare const useG8: () => {
             }): Promise<{
                 data: ResearchReport[];
             }>;
+            createIcp(body: {
+                name: string;
+                website_url: string;
+                description?: string;
+                firmographics?: Record<string, unknown>;
+                tech_stack?: Record<string, unknown>;
+                buying_signals?: unknown[];
+                estimated_market_size?: number;
+            }): Promise<{
+                data: ICP;
+            }>;
+            updateIcp(icpId: string, body: {
+                name?: string;
+                description?: string;
+                firmographics?: Record<string, unknown>;
+                tech_stack?: Record<string, unknown>;
+                buying_signals?: unknown[];
+                estimated_market_size?: number;
+            }): Promise<{
+                data: ICP;
+            }>;
+            archiveIcp(icpId: string): Promise<{
+                data: ICP;
+            }>;
+            createPersona(body: {
+                title: string;
+                website_url: string;
+                priority?: number;
+                confidence?: string;
+                why_target?: string;
+                key_signals?: unknown[];
+                expected_receptivity?: string;
+                campaign_approach?: string;
+                recommended_goal?: string;
+                source?: string;
+            }): Promise<{
+                data: Persona;
+            }>;
+            updatePersona(personaId: string, body: {
+                title?: string;
+                priority?: number;
+                confidence?: string;
+                why_target?: string;
+                key_signals?: unknown[];
+                expected_receptivity?: string;
+                campaign_approach?: string;
+                recommended_goal?: string;
+                status?: string;
+            }): Promise<{
+                data: Persona;
+            }>;
+            archivePersona(personaId: string): Promise<{
+                data: Persona;
+            }>;
         };
         get meetings(): {
             list(params?: MeetingListParams): Promise<{