@graph8/sdk 0.362.0 → 0.373.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.362.0",
+  "version": "0.373.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",
@@ -49,6 +49,11 @@
       "import": "./dist/react.mjs",
       "require": "./dist/react.js"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.mjs",
+      "require": "./dist/errors.js"
+    },
     "./ui": {
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.mjs",
@@ -63,6 +68,11 @@
     "./ui/theme.css": "./styles/theme.css",
     "./ui/styles.css": "./styles/styles.css"
   },
+  "sideEffects": [
+    "*.css",
+    "./dist/*.js",
+    "./dist/*.mjs"
+  ],
   "files": [
     "dist",
     "blocks",
@@ -73,8 +83,9 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup && npm run build:ui && npm run build:types && npm run docs:agents",
+    "build": "node scripts/clean-dist.mjs && tsup && npm run build:ui && npm run build:types && npm run docs:agents",
     "test": "vitest run",
+    "validate:blocks": "vite-node --script scripts/blocks/validate.ts",
     "dev": "tsup --watch",
     "prepublishOnly": "npm run build",
     "generate": "node scripts/generate-from-contract.mjs",
@@ -83,6 +94,9 @@
     "build:types": "node scripts/emit-module-types.mjs",
     "docs:agents": "vite-node scripts/agent-docs/cli.ts",
     "e2e:create": "node scripts/e2e-create.mjs",
+    "e2e:flows": "node scripts/e2e-flows.mjs",
+    "mock:graph8": "node scripts/mock-graph8/server.mjs",
+    "mock:graph8:coverage": "node scripts/mock-graph8/coverage.mjs",
     "generate:ui": "node scripts/sync-ui.mjs",
     "generate:ui:check": "node scripts/sync-ui.mjs --check",
     "build:ui": "tsup --config tsup.ui.config.ts && node scripts/postbuild-ui.mjs && node scripts/build-ui-css.mjs"

package/stacks/6sense/pages/companies.tsx.tmpl

@@ -0,0 +1,21 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
+import { CompanyIntelligenceTab } from "@/components/g8/company-intelligence/company-intelligence-tab";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CompaniesScreen
+      onOpenContact={(contact) => router.push(`/contacts?id=${contact.id}`)}
+      extraDetailTabs={[
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
+        { id: "intelligence", label: "Intelligence", render: (c) => <CompanyIntelligenceTab company={c} onOpenIntelligence={() => router.push("/company-intelligence")} /> },
+      ]}
+    />
+  );
+}

package/stacks/6sense/pages/contacts.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <ContactsScreen
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      extraDetailTabs={[
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/6sense/pages/tasks.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}

package/stacks/6sense.json

@@ -2,45 +2,83 @@
   "$schema": "./stack.schema.json",
   "id": "6sense",
   "title": "6sense-style account intelligence",
-  "summary": "Buyer intent, website visitor identification and competitor tracking on top of the CRM.",
+  "summary": "Intent, website visitors and competitor tracking on top of your accounts and contacts.",
   "status": "available",
   "blocks": [
     "foundation",
     "crm",
     "intent",
     "visitors",
-    "radar"
+    "radar",
+    "company-intelligence"
   ],
+  "home": "/intent",
   "nav": [
-    {
-      "label": "Contacts",
-      "path": "/contacts",
-      "block": "crm",
-      "component": "ContactTable"
-    },
-    {
-      "label": "Companies",
-      "path": "/companies",
-      "block": "crm",
-      "component": "CompanyTable"
-    },
     {
       "label": "Intent",
       "path": "/intent",
       "block": "intent",
-      "component": "IntentFeed"
+      "component": "IntentScreen",
+      "icon": "Radar",
+      "group": "Signals",
+      "description": "Accounts showing buying intent"
     },
     {
       "label": "Visitors",
       "path": "/visitors",
       "block": "visitors",
-      "component": "VisitorFeed"
+      "component": "VisitorsScreen",
+      "icon": "Eye",
+      "group": "Signals",
+      "description": "Who is on your website right now"
     },
     {
       "label": "Competitors",
       "path": "/competitors",
       "block": "radar",
-      "component": "CompetitorTracker"
+      "component": "RadarScreen",
+      "icon": "Crosshair",
+      "group": "Signals",
+      "description": "Track competitors and market moves"
+    },
+    {
+      "label": "Companies",
+      "path": "/companies",
+      "block": "crm",
+      "component": "CompaniesScreen",
+      "icon": "Building2",
+      "group": "Prospect",
+      "description": "Accounts and the people at them",
+      "page": "pages/companies.tsx.tmpl"
+    },
+    {
+      "label": "Company intelligence",
+      "path": "/company-intelligence",
+      "block": "company-intelligence",
+      "component": "CompanyIntelligenceScreen",
+      "icon": "Telescope",
+      "group": "Signals",
+      "description": "Research your website: profile, competitors, news, documents and reports"
+    },
+    {
+      "label": "Contacts",
+      "path": "/contacts",
+      "block": "crm",
+      "component": "ContactsScreen",
+      "icon": "Users",
+      "group": "Prospect",
+      "description": "People you sell to, with notes, tasks and activity",
+      "page": "pages/contacts.tsx.tmpl"
+    },
+    {
+      "label": "Tasks",
+      "path": "/tasks",
+      "block": "crm",
+      "component": "TasksScreen",
+      "icon": "CheckSquare",
+      "group": "Work",
+      "description": "Follow-ups due across your records",
+      "page": "pages/tasks.tsx.tmpl"
     }
   ]
 }

package/stacks/apollo/pages/calls.tsx.tmpl

@@ -0,0 +1,23 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { Button } from "@graph8/sdk/ui";
+import { UserRound } from "lucide-react";
+import { CallLogScreen } from "@/components/g8/dialer/call-log-screen";
+
+/** A call opens the person it was made to. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CallLogScreen
+      renderDetailActions={(call) => call.contact_id ? (
+        <Button size="sm" variant="outline" onClick={() => router.push(`/contacts?id=${encodeURIComponent(call.contact_id as string)}`)}>
+          <UserRound className="mr-1 size-4" aria-hidden />
+          Open contact
+        </Button>
+      ) : null}
+    />
+  );
+}

package/stacks/apollo/pages/companies.tsx.tmpl

@@ -0,0 +1,33 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
+import { EnrichButton } from "@/components/g8/enrichment/enrich-button";
+import { AddCompanyPeopleToListButton } from "@/components/g8/lists/add-company-people-to-list-button";
+import { CompanyIntelligenceTab } from "@/components/g8/company-intelligence/company-intelligence-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CompaniesScreen
+      onOpenContact={(contact) => router.push(`/contacts?id=${contact.id}`)}
+      renderRowActions={(c, { reload }) => <EnrichButton kind="company" lookup={{ domain: c.domain ?? undefined, name: c.name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" size="sm" variant="ghost" />}
+      renderBulkActions={({ ids, clear }) => <AddCompanyPeopleToListButton companyIds={ids} onAdded={clear} />}
+      renderDetailActions={(c, { reload }) => (
+        <>
+          <EnrichButton kind="company" lookup={{ domain: c.domain ?? undefined, name: c.name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" />
+          <AddCompanyPeopleToListButton companyIds={[c.id]} />
+        </>
+      )}
+      extraDetailTabs={[
+        { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="companies" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
+        { id: "intelligence", label: "Intelligence", render: (c) => <CompanyIntelligenceTab company={c} onOpenIntelligence={() => router.push("/company-intelligence")} /> },
+      ]}
+    />
+  );
+}

package/stacks/apollo/pages/contacts.tsx.tmpl

@@ -0,0 +1,51 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { RecordMeetingsTab } from "@/components/g8/appointments/record-meetings-tab";
+import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
+import { CallContactButton } from "@/components/g8/dialer/call-contact-button";
+import { RecordCallsTab } from "@/components/g8/dialer/record-calls-tab";
+import { EnrichButton } from "@/components/g8/enrichment/enrich-button";
+import { RecordConversationsTab } from "@/components/g8/inbox/record-conversations-tab";
+import { AddToListButton } from "@/components/g8/lists/add-to-list-button";
+import { RecordListsTab } from "@/components/g8/lists/record-lists-tab";
+import { AddToSequenceButton } from "@/components/g8/sequencer/add-to-sequence-button";
+import { RecordSequencesTab } from "@/components/g8/sequencer/record-sequences-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <ContactsScreen
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      renderRowActions={(c, { reload }) => <EnrichButton kind="person" lookup={{ email: c.work_email ?? undefined, linkedin_url: c.linkedin_url ?? undefined, first_name: c.first_name ?? undefined, last_name: c.last_name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" size="sm" variant="ghost" />}
+      renderBulkActions={({ ids, clear }) => (
+        <>
+          <AddToSequenceButton contactIds={ids} onEnrolled={clear} />
+          <AddToListButton contactIds={ids} onAdded={clear} />
+        </>
+      )}
+      renderDetailActions={(c, { reload }) => (
+        <>
+          <EnrichButton kind="person" lookup={{ email: c.work_email ?? undefined, linkedin_url: c.linkedin_url ?? undefined, first_name: c.first_name ?? undefined, last_name: c.last_name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" />
+          <AddToSequenceButton contactIds={[c.id]} />
+          <AddToListButton contactIds={[c.id]} />
+          {/* One call to this contact through the dialer; confirmed, and your softphone joins it. */}
+          <CallContactButton contact={{ id: c.id, first_name: c.first_name, last_name: c.last_name, full_name: c.full_name, email: c.work_email, company: c.company_name, mobile_phone: c.mobile_phone, direct_phone: c.direct_phone }} />
+        </>
+      )}
+      extraDetailTabs={[
+        { id: "lists", label: "Lists", render: (c) => <RecordListsTab contactId={c.id} onOpenList={(id) => router.push(`/lists?id=${id}`)} /> },
+        { id: "sequences", label: "Sequences", render: (c) => <RecordSequencesTab contactId={c.id} onOpenSequence={(id) => router.push(`/sequences?id=${encodeURIComponent(id)}`)} /> },
+        { id: "meetings", label: "Meetings", render: (c) => <RecordMeetingsTab contactId={c.id} onOpenMeeting={(sel) => router.push(`/meetings?sel=${encodeURIComponent(sel)}`)} /> },
+        { id: "calls", label: "Calls", render: (c) => <RecordCallsTab contact={{ id: c.id, first_name: c.first_name, last_name: c.last_name, full_name: c.full_name, email: c.work_email, company: c.company_name, mobile_phone: c.mobile_phone, direct_phone: c.direct_phone }} onOpenCall={(room) => router.push(`/calls?id=${encodeURIComponent(room)}`)} /> },
+        { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="contacts" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
+        { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} alsoEmails={[c.personal_emails]} onOpenThread={(sel) => router.push(`/inbox?id=${encodeURIComponent(sel)}`)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/apollo/pages/deals.tsx.tmpl

@@ -0,0 +1,17 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { DealsScreen } from "@/components/g8/deals/deals-screen";
+
+/** A deal opens its quotes, its contacts and (from a contact) their company. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <DealsScreen
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+    />
+  );
+}

package/stacks/apollo/pages/inbox-contact.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ContactLookupLink } from "@/components/g8/crm/contact-lookup-link";
+import { InboxScreen } from "@/components/g8/inbox/inbox-screen";
+
+/** A conversation opens the sender when they are a contact in your CRM. */
+export default function Page() {
+  const router = useRouter();
+  return <InboxScreen renderDetailActions={(thread) => <ContactLookupLink email={thread.contact?.email} onOpen={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/apollo/pages/lists.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ListsScreen } from "@/components/g8/lists/lists-screen";
+
+/** A list member opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/apollo/pages/meetings.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { MeetingContactLinks } from "@/components/g8/appointments/meeting-contact-links";
+import { MeetingsScreen } from "@/components/g8/appointments/meetings-screen";
+
+/** A meeting opens the attendees who are contacts in your CRM. */
+export default function Page() {
+  const router = useRouter();
+  return <MeetingsScreen renderDetailActions={(selection) => <MeetingContactLinks selection={selection} onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/apollo/pages/sequences.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { SequencesScreen } from "@/components/g8/sequencer/sequences-screen";
+
+/** An enrolled person opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <SequencesScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/apollo/pages/tasks.tsx.tmpl

@@ -0,0 +1,20 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+    if (record.entity_type === "deal") router.push(`/deals?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}