* @hanzo/crm 0.1.0: the CRM, one for every app that has one Hanzo Cloud console's CRM (crm.hanzo.ai, console.hanzo.ai/crm), moved out of hanzoai/console unchanged so Hanzo Team draws the same screens over the same records. The moved files differ from console's only in their imports, which point at lib/host: the request signing, org, session, router, brand and crm face an app supplies once through configureCrm. Adds baseClient (also at @hanzo/crm/base), a Base client over any JSON transport for an app with none of its own, and CRM_PAGES for a host's navigation. 89 tests. Co-Authored-By: Claude Opus 5.5 <[email protected]> * @hanzo/crm: the suppression test's account carries only what the CRM reads Co-Authored-By: Claude Opus 5.5 <[email protected]> --------- Co-authored-by: Claude Opus 5.5 <[email protected]>
@hanzo/crm
Hanzo CRM: the org's people, companies, sales pipeline, fundraising, tasks, lists,
candidates and sequences, kept in the org's own Base (hanzoai/base module crm).
It is one CRM drawn by every app that has one:
- Hanzo Cloud's console, at
console.<brand>/crm, and as Hanzo CRM oncrm.<brand> - Hanzo Team, at
hanzo.team/crm
Every app reads and writes the same records, because the records are the org's
Base and nothing else. What differs between apps is only what each one knows about
itself, and the app supplies that through configureCrm.
Use
import { configureCrm, CrmModule } from '@hanzo/crm'
configureCrm({
// Plain-JSON REST over the signed-in account's credential, in the org.
// A refusal rejects with an Error carrying the HTTP `status` (and `body`).
v1Url: (path) => `https://api.hanzo.ai/v1/${path}`,
get: (url) => rest('GET', url),
post: (url, body) => rest('POST', url, body),
del: (url) => rest('DELETE', url),
// The org's Base (/v1/base), signed the same way.
base: () => myBaseClient,
org: () => currentOrg,
leaveOrg: () => switchToOwnOrg(),
brand: () => ({ brandName: 'Hanzo', websiteUrl: 'https://hanzo.ai' }),
// True on the crm face: the org's `crm` enablement is read first, and an org
// without it is shown how to join the beta.
gated: false,
// React hooks over the app's own session, router and address.
useSession: () => ({ account, signOut }),
useRouter: () => ({ push, replace }),
useSearchParams: () => searchParams,
})
// Where the CRM goes: /crm/:tab and /crm/:tab/:id.
<CrmModule params={{ tab, id }} />
OBJECTS and TABS list the objects in order, for an app's own navigation, and
objectOf / movedView say where an older address lands.
The CRM writes console-style addresses (/crm, /crm/companies,
/crm/deals/<id>, ?view=). An app whose CRM lives somewhere else maps them in its
useRouter.
Requests
| What | Route |
|---|---|
| Records, schemas | GET/POST/PATCH/DELETE /v1/base/collections/:name[/records[/:id]] (through base) |
| Grow the org's CRM | POST /v1/base/modules/crm |
| The beta | GET /v1/entitlement/orgs/:org |
POST /v1/email, POST /v1/email/verify, POST /v1/marketing/mail |
|
| Sequences | /v1/marketing/sequences[/:id[/steps,/status,/enroll,/enrollments]] |
| Audiences, suppressions | /v1/marketing/audiences, /v1/marketing/suppressions[/check] |
Develop
pnpm --filter @hanzo/crm typecheck
pnpm --filter @hanzo/crm test
pnpm --filter @hanzo/crm build
The suites are the CRM's logic in plain Node (Base field and value mapping, view queries, CSV and import plans, the objects and their views, mail and suppression reads over a host's REST).