@volter/twin-hubspot 0.1.37 → 1.0.0

package/dist/client/hubspot-mirror.css

@@ -1,43 +0,0 @@
-:root {
-  --bg: #f5f8fa;
-  --panel: #ffffff;
-  --line: #dfe3eb;
-  --text: #33475b;
-  --muted: #7c98b6;
-  --accent: #eaf0f6;
-  --brand: #ff7a59;
-  --ok: #00bda5;
-  --warn: #f5c26b;
-  --bad: #f2545b;
-}
-* { box-sizing: border-box; }
-body { margin: 0; font-family: -apple-system, system-ui, "Helvetica Neue", sans-serif; background: var(--bg); color: var(--text); }
-.app { display: grid; grid-template-columns: 220px 1fr; grid-template-rows: 56px 1fr; min-height: 100vh; }
-.topbar { grid-column: 1 / 3; display: flex; align-items: center; justify-content: space-between; padding: 0 20px; border-bottom: 1px solid var(--line); background: var(--panel); }
-.brand { font-weight: 700; color: var(--brand); letter-spacing: 0.2px; }
-.view-toggle { border: 1px solid var(--line); background: var(--panel); color: var(--text); border-radius: 4px; padding: 6px 14px; cursor: pointer; font-size: 13px; }
-.view-toggle:hover { background: var(--accent); }
-.sidebar { border-right: 1px solid var(--line); padding: 14px 10px; background: var(--panel); }
-.nav-item { display: block; width: 100%; text-align: left; background: none; border: none; color: var(--muted); padding: 9px 12px; border-radius: 4px; cursor: pointer; font-size: 14px; }
-.nav-item.active, .nav-item:hover { background: var(--accent); color: var(--text); }
-.content { padding: 24px; overflow: auto; }
-table { width: 100%; border-collapse: collapse; background: var(--panel); border: 1px solid var(--line); border-radius: 6px; }
-th { text-align: left; color: var(--muted); font-size: 11px; text-transform: uppercase; letter-spacing: 0.4px; padding: 10px 12px; border-bottom: 1px solid var(--line); }
-td { padding: 12px; border-bottom: 1px solid var(--line); font-size: 14px; }
-tr:last-child td { border-bottom: none; }
-.cell-title { font-weight: 600; }
-.cell-id { color: var(--muted); font-variant-numeric: tabular-nums; }
-.cell-prop-name { color: var(--muted); font-size: 12px; width: 40%; }
-.pill { display: inline-block; padding: 3px 10px; border-radius: 999px; font-size: 12px; background: var(--accent); }
-.pill-ok { background: rgba(0, 189, 165, 0.16); color: var(--ok); }
-.pill-warn { background: rgba(245, 194, 107, 0.22); color: #b07d1a; }
-.pill-bad { background: rgba(242, 84, 91, 0.16); color: var(--bad); }
-.empty { color: var(--muted); padding: 28px; background: var(--panel); border: 1px dashed var(--line); border-radius: 6px; }
-.deal-board { display: flex; gap: 14px; align-items: flex-start; overflow-x: auto; padding-bottom: 8px; }
-.board-column { min-width: 220px; background: var(--panel); border: 1px solid var(--line); border-radius: 6px; padding: 12px; }
-.board-column-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 10px; }
-.board-count { color: var(--muted); font-size: 12px; }
-.deal-card { border: 1px solid var(--line); border-radius: 4px; padding: 10px; margin-bottom: 8px; }
-.deal-amount { color: var(--muted); font-size: 13px; margin-top: 4px; }
-.record-detail { background: var(--panel); border: 1px solid var(--line); border-radius: 6px; padding: 20px; }
-.detail-title { margin: 0 0 14px; font-size: 20px; }

package/dist/client/hubspot-mirror.d.ts

@@ -1,15 +0,0 @@
-import { type HubspotRow, type MirrorSectionKey } from '../src/hubspot-mirror-ui.js';
-/** A CRM record list — one `list-row` landmark per record, carrying its HubSpot record id. */
-export declare function RecordsTable({ section, rows }: {
-    section: MirrorSectionKey;
-    rows: HubspotRow[];
-}): import("react").JSX.Element;
-/** The deal pipeline board — the screen a sales rep actually works in, one column per stage. */
-export declare function DealBoard({ rows }: {
-    rows: HubspotRow[];
-}): import("react").JSX.Element;
-/** Record detail — the property sheet HubSpot shows on the right of a record. */
-export declare function RecordDetail({ section, rows }: {
-    section: MirrorSectionKey;
-    rows: HubspotRow[];
-}): import("react").JSX.Element;

package/dist/client/hubspot-mirror.js

@@ -1,59 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-// HubSpot mirror — React/TSX CRM client. Renders the twin's contacts, companies, deals and
-// tickets by fetching the twin's OWN CRM REST API on the same origin
-// (`/crm/v3/objects/contacts`, …) — HubSpot's real paths, the same ones the SDK calls.
-// API↔UI parity: the screen shows real twin state, not a hardcoded shell.
-import { createRoot } from 'react-dom/client';
-import { useEffect, useState } from 'react';
-import { MIRROR_SECTIONS, SECTION_COLUMNS, formatAmount, groupByStage, recordTitle, stageTone, } from "../src/hubspot-mirror-ui.js";
-// WHERE THIS MIRROR LIVES. Served at a vendor root the base is '' (fetches are root-relative, as
-// before); served under a path prefix with a <base> tag every read and write resolves inside that
-// prefix instead of escaping it.
-const WIRE_BASE = typeof document === 'undefined' || document.querySelector('base[href]') === null ? '' : new URL('.', document.baseURI).pathname.replace(/\/$/, '');
-// Map a tone to a STATIC literal class name (a template-literal class is erased by the
-// minifier, so `pill-${tone}` would vanish from the bundle — assert these instead).
-const PILL_CLASS = { ok: 'pill pill-ok', warn: 'pill pill-warn', bad: 'pill pill-bad', '': 'pill' };
-/** Unwrap HubSpot's collection envelope (`{ results, paging }`) to its results array. */
-async function fetchRows(path) {
-    const res = await fetch(`${WIRE_BASE}${path}`);
-    const body = (await res.json());
-    return Array.isArray(body.results) ? body.results : [];
-}
-/** A CRM record list — one `list-row` landmark per record, carrying its HubSpot record id. */
-export function RecordsTable({ section, rows }) {
-    if (rows.length === 0)
-        return _jsxs("div", { className: "empty", children: ["No ", section, " yet."] });
-    const columns = SECTION_COLUMNS[section];
-    return (_jsxs("table", { className: "records-table", children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { children: "Name" }), columns.map((c) => _jsx("th", { children: c.label }, c.prop)), _jsx("th", { children: "Record ID" })] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "list-row", "data-record-id": r.id, children: [_jsx("td", { className: "cell-title", children: recordTitle(section, r.properties) }), columns.map((c) => (_jsx("td", { className: "cell-prop", children: c.prop === 'amount' ? formatAmount(r.properties?.amount)
-                                : c.prop === 'dealstage'
-                                    ? _jsx("span", { className: PILL_CLASS[stageTone(r.properties?.dealstage)], children: r.properties?.dealstage ?? '—' })
-                                    : (r.properties?.[c.prop] ?? '—') }, c.prop))), _jsx("td", { className: "cell-id", children: r.id })] }, r.id))) })] }));
-}
-/** The deal pipeline board — the screen a sales rep actually works in, one column per stage. */
-export function DealBoard({ rows }) {
-    const groups = groupByStage(rows);
-    if (groups.length === 0)
-        return _jsx("div", { className: "empty", children: "No deals yet." });
-    return (_jsx("div", { className: "deal-board", children: groups.map((g) => (_jsxs("section", { className: "board-column", "data-stage": g.stage, children: [_jsxs("header", { className: "board-column-head", children: [_jsx("span", { className: PILL_CLASS[stageTone(g.stage)], children: g.stage }), _jsx("span", { className: "board-count", children: g.rows.length })] }), g.rows.map((r) => (_jsxs("article", { className: "deal-card list-row", "data-record-id": r.id, children: [_jsx("div", { className: "cell-title", children: recordTitle('deals', r.properties) }), _jsx("div", { className: "deal-amount", children: formatAmount(r.properties?.amount) })] }, r.id)))] }, g.stage))) }));
-}
-/** Record detail — the property sheet HubSpot shows on the right of a record. */
-export function RecordDetail({ section, rows }) {
-    const r = rows[0];
-    if (!r)
-        return _jsx("div", { className: "empty", children: "No record." });
-    const entries = Object.entries(r.properties ?? {});
-    return (_jsxs("section", { className: "record-detail", "data-record-id": r.id, children: [_jsx("h2", { className: "detail-title", children: recordTitle(section, r.properties) }), _jsx("table", { className: "property-table", children: _jsx("tbody", { children: entries.map(([k, v]) => (_jsxs("tr", { className: "list-row", "data-prop": k, children: [_jsx("td", { className: "cell-prop-name", children: k }), _jsx("td", { className: "cell-prop-value", children: v ?? '—' })] }, k))) }) })] }));
-}
-function App() {
-    const [section, setSection] = useState('contacts');
-    const [board, setBoard] = useState(false);
-    const [rows, setRows] = useState([]);
-    useEffect(() => {
-        const sec = MIRROR_SECTIONS.find((s) => s.key === section);
-        fetchRows(sec.path).then(setRows).catch(() => setRows([]));
-    }, [section]);
-    return (_jsxs("div", { className: "app", children: [_jsxs("header", { className: "topbar", children: [_jsx("span", { className: "brand", children: "HubSpot twin" }), section === 'deals' ? (_jsx("button", { className: "view-toggle", onClick: () => setBoard((b) => !b), children: board ? 'Table' : 'Board' })) : null] }), _jsx("nav", { className: "sidebar", children: MIRROR_SECTIONS.map((s) => (_jsx("button", { className: `nav-item${s.key === section ? ' active' : ''}`, onClick: () => { setSection(s.key); setBoard(false); }, children: s.label }, s.key))) }), _jsx("main", { className: "content", children: section === 'deals' && board ? _jsx(DealBoard, { rows: rows }) : _jsx(RecordsTable, { section: section, rows: rows }) })] }));
-}
-const el = typeof document !== 'undefined' ? document.getElementById('root') : null;
-if (el)
-    createRoot(el).render(_jsx(App, {}));

package/dist/client/hubspot-mirror.tsx

@@ -1,132 +0,0 @@
-// HubSpot mirror — React/TSX CRM client. Renders the twin's contacts, companies, deals and
-// tickets by fetching the twin's OWN CRM REST API on the same origin
-// (`/crm/v3/objects/contacts`, …) — HubSpot's real paths, the same ones the SDK calls.
-// API↔UI parity: the screen shows real twin state, not a hardcoded shell.
-import { createRoot } from 'react-dom/client';
-import { useEffect, useState } from 'react';
-import {
-  MIRROR_SECTIONS, SECTION_COLUMNS, formatAmount, groupByStage, recordTitle, stageTone,
-  type HubspotRow, type MirrorSectionKey, type PillTone,
-} from '../src/hubspot-mirror-ui.ts';
-
-// WHERE THIS MIRROR LIVES. Served at a vendor root the base is '' (fetches are root-relative, as
-// before); served under a path prefix with a <base> tag every read and write resolves inside that
-// prefix instead of escaping it.
-const WIRE_BASE = typeof document === 'undefined' || document.querySelector('base[href]') === null ? '' : new URL('.', document.baseURI).pathname.replace(/\/$/, '');
-
-// Map a tone to a STATIC literal class name (a template-literal class is erased by the
-// minifier, so `pill-${tone}` would vanish from the bundle — assert these instead).
-const PILL_CLASS: Record<PillTone, string> = { ok: 'pill pill-ok', warn: 'pill pill-warn', bad: 'pill pill-bad', '': 'pill' };
-
-/** Unwrap HubSpot's collection envelope (`{ results, paging }`) to its results array. */
-async function fetchRows(path: string): Promise<HubspotRow[]> {
-  const res = await fetch(`${WIRE_BASE}${path}`);
-  const body = (await res.json()) as { results?: unknown };
-  return Array.isArray(body.results) ? (body.results as HubspotRow[]) : [];
-}
-
-/** A CRM record list — one `list-row` landmark per record, carrying its HubSpot record id. */
-export function RecordsTable({ section, rows }: { section: MirrorSectionKey; rows: HubspotRow[] }) {
-  if (rows.length === 0) return <div className="empty">No {section} yet.</div>;
-  const columns = SECTION_COLUMNS[section];
-  return (
-    <table className="records-table">
-      <thead>
-        <tr><th>Name</th>{columns.map((c) => <th key={c.prop}>{c.label}</th>)}<th>Record ID</th></tr>
-      </thead>
-      <tbody>
-        {rows.map((r) => (
-          <tr className="list-row" data-record-id={r.id} key={r.id}>
-            <td className="cell-title">{recordTitle(section, r.properties)}</td>
-            {columns.map((c) => (
-              <td className="cell-prop" key={c.prop}>
-                {c.prop === 'amount' ? formatAmount(r.properties?.amount)
-                  : c.prop === 'dealstage'
-                    ? <span className={PILL_CLASS[stageTone(r.properties?.dealstage)]}>{r.properties?.dealstage ?? '—'}</span>
-                    : (r.properties?.[c.prop] ?? '—')}
-              </td>
-            ))}
-            <td className="cell-id">{r.id}</td>
-          </tr>
-        ))}
-      </tbody>
-    </table>
-  );
-}
-
-/** The deal pipeline board — the screen a sales rep actually works in, one column per stage. */
-export function DealBoard({ rows }: { rows: HubspotRow[] }) {
-  const groups = groupByStage(rows);
-  if (groups.length === 0) return <div className="empty">No deals yet.</div>;
-  return (
-    <div className="deal-board">
-      {groups.map((g) => (
-        <section className="board-column" data-stage={g.stage} key={g.stage}>
-          <header className="board-column-head">
-            <span className={PILL_CLASS[stageTone(g.stage)]}>{g.stage}</span>
-            <span className="board-count">{g.rows.length}</span>
-          </header>
-          {g.rows.map((r) => (
-            <article className="deal-card list-row" data-record-id={r.id} key={r.id}>
-              <div className="cell-title">{recordTitle('deals', r.properties)}</div>
-              <div className="deal-amount">{formatAmount(r.properties?.amount)}</div>
-            </article>
-          ))}
-        </section>
-      ))}
-    </div>
-  );
-}
-
-/** Record detail — the property sheet HubSpot shows on the right of a record. */
-export function RecordDetail({ section, rows }: { section: MirrorSectionKey; rows: HubspotRow[] }) {
-  const r = rows[0];
-  if (!r) return <div className="empty">No record.</div>;
-  const entries = Object.entries(r.properties ?? {});
-  return (
-    <section className="record-detail" data-record-id={r.id}>
-      <h2 className="detail-title">{recordTitle(section, r.properties)}</h2>
-      <table className="property-table">
-        <tbody>
-          {entries.map(([k, v]) => (
-            <tr className="list-row" data-prop={k} key={k}>
-              <td className="cell-prop-name">{k}</td>
-              <td className="cell-prop-value">{v ?? '—'}</td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-    </section>
-  );
-}
-
-function App() {
-  const [section, setSection] = useState<MirrorSectionKey>('contacts');
-  const [board, setBoard] = useState(false);
-  const [rows, setRows] = useState<HubspotRow[]>([]);
-  useEffect(() => {
-    const sec = MIRROR_SECTIONS.find((s) => s.key === section)!;
-    fetchRows(sec.path).then(setRows).catch(() => setRows([]));
-  }, [section]);
-  return (
-    <div className="app">
-      <header className="topbar">
-        <span className="brand">HubSpot twin</span>
-        {section === 'deals' ? (
-          <button className="view-toggle" onClick={() => setBoard((b) => !b)}>{board ? 'Table' : 'Board'}</button>
-        ) : null}
-      </header>
-      <nav className="sidebar">
-        {MIRROR_SECTIONS.map((s) => (
-          <button key={s.key} className={`nav-item${s.key === section ? ' active' : ''}`} onClick={() => { setSection(s.key); setBoard(false); }}>{s.label}</button>
-        ))}
-      </nav>
-      <main className="content">
-        {section === 'deals' && board ? <DealBoard rows={rows} /> : <RecordsTable section={section} rows={rows} />}
-      </main>
-    </div>
-  );
-}
-
-const el = typeof document !== 'undefined' ? document.getElementById('root') : null;
-if (el) createRoot(el).render(<App />);

package/dist/src/accounts.d.ts

@@ -1,30 +0,0 @@
-export type Row = Record<string, unknown>;
-export declare const hex: (s: string) => string;
-/** Every live stored subject of a bookkeeping type (these are not scoped to an account: each names its own). */
-export declare function stored(type: string, root?: string): Row[];
-/** Write a bookkeeping subject. */
-export declare function keep(type: string, id: string, fields: Row, root: string | undefined, at: string, actor?: string): Promise<void>;
-export declare const passwordHash: (email: string, password: string) => string;
-export declare function accountOf(hubId: number, root?: string): Row | undefined;
-export declare function personOf(email: string, root?: string): Row | undefined;
-export declare function usersOf(hubId: number, root?: string): Row[];
-/** An account's owners, as GET /crm/v3/owners answers them (the spec's PublicOwner): one per user. */
-export declare function ownersOf(hubId: number, root?: string): Row[];
-/** POST /_twin/users/:email/password {password, firstName, lastName, account?, subscription?, renewsOn?, hubId?} — stands in for two pages the
- *  twin does not build: HubSpot's sign-up (a new account, named `account`, whose first user is its super admin) and a
- *  user's acceptance of an invitation from an account's Users & Teams settings (`hubId`: the user joins that account).
- *  The World keeps the password's hash, never the password; 201 with the account's Hub ID and the user's ids. */
-export declare function signUpDoor(email: string, request: Request, root: string | undefined, at: string): Promise<Response>;
-/** The subscription an account has at `at`: a paid one whose auto-renewal was cancelled ends on its renewal date, when
- *  "your account will be downgraded to HubSpot's free tools"
- *  (https://knowledge.hubspot.com/account/how-do-i-cancel-my-hubspot-account); one that renews carries on. */
-export declare function subscriptionAt(account: Row, at: string): string;
-export declare const SESSION_COOKIE = "hs_session";
-/** The person the request's session cookie names, or undefined. */
-export declare function signedIn(request: Request, root?: string): Row | undefined;
-export declare function appByClientId(clientId: string, root?: string): Row | undefined;
-export declare function appById(appId: number, root?: string): Row | undefined;
-export declare function appsOf(hubId: number, root?: string): Row[];
-/** The live installs in an account. */
-export declare function installsIn(hubId: number, root?: string): Row[];
-export declare function installOf(appId: number, hubId: number, root?: string): Row | undefined;

package/dist/src/accounts.js

@@ -1,122 +0,0 @@
-// HUBSPOT ACCOUNTS, THEIR USERS, AND WHAT THEY HOLD OUTSIDE THE CRM — the state HubSpot's pages and its OAuth install
-// keep, which no CRM operation reads or writes: an account (its Hub ID, name and subscription, closed or not), the
-// people who sign in to it (each a user, and so an owner of its records), their browser sessions, the apps an account
-// builds as developer projects (each with its client ID and secret, redirect URLs, scopes and webhook subscriptions),
-// and each app's installs in accounts (who installed it, when, which scopes, uninstalled or not). Kept in the kernel's
-// log under `_`-prefixed types that never reach the wire.
-//
-// Where HubSpot's documentation stops and the twin decides: an account the World makes has a Hub ID from 146000001 up,
-// a user id from 80000001 and an owner id from 90000001 (HubSpot documents their existence, not their ranges); every
-// user of an account the story names is its super admin or one of its users with the seats the story gives them, and
-// the twin keeps no finer permission than super admin or not.
-import { createHash } from 'node:crypto';
-import { applyTwinWrite, projectResources } from '@volter/world-core';
-const SERVICE = 'hubspot';
-export const hex = (s) => createHash('sha256').update(s).digest('hex');
-/** Every live stored subject of a bookkeeping type (these are not scoped to an account: each names its own). */
-export function stored(type, root) {
-    return projectResources(SERVICE, root).filter((r) => r.type === type && r.deleted !== true);
-}
-/** Write a bookkeeping subject. */
-export async function keep(type, id, fields, root, at, actor = 'hubspot') {
-    await applyTwinWrite(SERVICE, { operation: `hubspot.${type}`, subjectType: type, subjectId: id, fields, occurredAt: at, actor: { kind: 'human', id: actor } }, root);
-}
-// ── accounts and users ─────────────────────────────────────────────────────────────────────
-export const passwordHash = (email, password) => hex(`hubspot-password:${email.toLowerCase()}:${password}`);
-export function accountOf(hubId, root) {
-    return stored('_account', root).find((a) => a.hubId === hubId);
-}
-export function personOf(email, root) {
-    return stored('_person', root).find((p) => p.email === email.toLowerCase());
-}
-export function usersOf(hubId, root) {
-    return stored('_person', root).filter((p) => p.hubId === hubId).sort((a, b) => Number(a.userId) - Number(b.userId));
-}
-/** An account's owners, as GET /crm/v3/owners answers them (the spec's PublicOwner): one per user. */
-export function ownersOf(hubId, root) {
-    return usersOf(hubId, root).map((p) => ({
-        id: String(p.ownerId), email: p.email, firstName: p.firstName, lastName: p.lastName, userId: p.userId,
-        userIdIncludingInactive: p.userId, type: 'PERSON', archived: false, teams: [],
-        createdAt: p.created_at, updatedAt: p.created_at,
-    }));
-}
-/** POST /_twin/users/:email/password {password, firstName, lastName, account?, subscription?, renewsOn?, hubId?} — stands in for two pages the
- *  twin does not build: HubSpot's sign-up (a new account, named `account`, whose first user is its super admin) and a
- *  user's acceptance of an invitation from an account's Users & Teams settings (`hubId`: the user joins that account).
- *  The World keeps the password's hash, never the password; 201 with the account's Hub ID and the user's ids. */
-export async function signUpDoor(email, request, root, at) {
-    let body = {};
-    try {
-        body = JSON.parse(await request.text());
-    }
-    catch { /* refused below */ }
-    const password = typeof body.password === 'string' ? body.password : '';
-    const firstName = typeof body.firstName === 'string' ? body.firstName : '';
-    const lastName = typeof body.lastName === 'string' ? body.lastName : '';
-    const refuse = (message) => Response.json({ status: 'error', message, category: 'VALIDATION_ERROR' }, { status: 400 });
-    if (!/^[^@\s]+@[^@\s]+$/.test(email) || password.length < 8 || !firstName || !lastName)
-        return refuse('an email, a password of at least 8 characters, a firstName and a lastName are required');
-    if (personOf(email, root))
-        return refuse(`${email} already has a HubSpot login`);
-    let hubId;
-    let superAdmin;
-    if (body.hubId !== undefined) {
-        hubId = Number(body.hubId);
-        const account = accountOf(hubId, root);
-        if (!account || account.closed_at)
-            return refuse(`no open account ${String(body.hubId)}`);
-        superAdmin = body.superAdmin === true;
-    }
-    else {
-        const name = typeof body.account === 'string' ? body.account.trim() : '';
-        if (!name)
-            return refuse('an account name (a new account) or a hubId (an account to join) is required');
-        hubId = 146000000 + stored('_account', root).length + 1;
-        const subscription = typeof body.subscription === 'string' ? body.subscription : 'free';
-        // a paid subscription's commitment term ends on `renewsOn` (a date), when it renews unless its auto-renewal was cancelled
-        const renewsOn = typeof body.renewsOn === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(body.renewsOn) ? body.renewsOn : null;
-        if (subscription !== 'free' && !renewsOn)
-            return refuse('a paid subscription needs the date its commitment term ends (renewsOn)');
-        await keep('_account', `account:${hubId}`, { hubId, name, subscription, renews_on: renewsOn, auto_renew: subscription !== 'free', created_at: at, closed_at: null }, root, at, email);
-        superAdmin = true;
-    }
-    const n = stored('_person', root).length + 1;
-    const person = { email: email.toLowerCase(), hash: passwordHash(email, password), hubId, userId: 80000000 + n, ownerId: String(90000000 + n), firstName, lastName, superAdmin, created_at: at };
-    await keep('_person', `person:${email.toLowerCase()}`, person, root, at, email);
-    return Response.json({ hubId, userId: person.userId, ownerId: person.ownerId }, { status: 201 });
-}
-/** The subscription an account has at `at`: a paid one whose auto-renewal was cancelled ends on its renewal date, when
- *  "your account will be downgraded to HubSpot's free tools"
- *  (https://knowledge.hubspot.com/account/how-do-i-cancel-my-hubspot-account); one that renews carries on. */
-export function subscriptionAt(account, at) {
-    const paid = String(account.subscription ?? 'free');
-    if (paid === 'free' || account.auto_renew !== false || !account.renews_on)
-        return paid;
-    return Date.parse(at) >= Date.parse(`${String(account.renews_on)}T00:00:00Z`) ? 'free' : paid;
-}
-// ── sessions ───────────────────────────────────────────────────────────────────────────────
-export const SESSION_COOKIE = 'hs_session';
-/** The person the request's session cookie names, or undefined. */
-export function signedIn(request, root) {
-    const cookie = request.headers.get('cookie') ?? '';
-    const token = new RegExp(`(?:^|;\\s*)${SESSION_COOKIE}=([^;]+)`).exec(cookie)?.[1];
-    const session = token ? stored('_web_session', root).find((s) => s.token === token) : undefined;
-    return session ? personOf(String(session.email), root) : undefined;
-}
-// ── apps and installs ──────────────────────────────────────────────────────────────────────
-export function appByClientId(clientId, root) {
-    return stored('_app', root).find((a) => a.client_id === clientId && !a.deleted_at);
-}
-export function appById(appId, root) {
-    return stored('_app', root).find((a) => a.appId === appId && !a.deleted_at);
-}
-export function appsOf(hubId, root) {
-    return stored('_app', root).filter((a) => a.hubId === hubId && !a.deleted_at);
-}
-/** The live installs in an account. */
-export function installsIn(hubId, root) {
-    return stored('_install', root).filter((i) => i.hubId === hubId && !i.uninstalled_at);
-}
-export function installOf(appId, hubId, root) {
-    return installsIn(hubId, root).find((i) => i.appId === appId);
-}

package/dist/src/hubspot-areas.d.ts

@@ -1,10 +0,0 @@
-export type HubspotArea = {
-    id: string;
-    title: string;
-    /** Present ⇒ the area is DEFERRED: a separate HubSpot product, not built here, and this is why. */
-    reason?: string;
-};
-export declare const HUBSPOT_AREAS: readonly HubspotArea[];
-export declare function areaById(id: string): HubspotArea;
-/** The area ids `assertAreaCensus` is given. */
-export declare const HUBSPOT_AREA_IDS: readonly string[];

package/dist/src/hubspot-areas.js

@@ -1,114 +0,0 @@
-export const HUBSPOT_AREAS = [
-    // ── modeled: the CRM ──────────────────────────────────────────────────────────────────────
-    { id: 'objects', title: 'CRM objects — contacts, companies, deals, tickets (basic + batch CRUD)' },
-    { id: 'search', title: 'CRM Search API — filterGroups, free-text query, sorting, paging' },
-    { id: 'properties', title: 'CRM properties and property groups' },
-    { id: 'associations', title: 'CRM associations v4 — labeled, default, batch' },
-    { id: 'pipelines', title: 'CRM pipelines and pipeline stages (deals, tickets)' },
-    { id: 'owners', title: 'CRM owners' },
-    { id: 'protocol', title: 'Protocol fidelity — error envelope, paging, rate-limit headers, read-only' },
-    { id: 'connector', title: 'Connector lifecycle — pull from / push to a real portal' },
-    { id: 'ui', title: 'The CRM mirror — record lists, the deal pipeline board, record detail' },
-    // ── deferred: the other HubSpot products behind api.hubapi.com ────────────────────────────
-    {
-        id: 'crm-engagements',
-        title: 'CRM engagements — calls, emails, meetings, notes, tasks, communications, postal mail, leads, feedback submissions, goals',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'crm-commerce',
-        title: 'CRM commerce — products, line items, quotes, invoices, taxes, deal splits, subscriptions, payments',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'crm-schemas',
-        title: 'CRM custom object schemas — object type definitions, custom object records (objectTypeId 2-N / fullyQualifiedName p{portalId}_name)',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'crm-lists',
-        title: 'CRM lists — static and dynamic list membership, list filters (58 generated operations)',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'crm-imports-exports',
-        title: 'CRM imports and exports — bulk file-based record import/export jobs',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'crm-extensions',
-        title: 'CRM extensions — calling, CRM cards, video conferencing, timeline events (57 generated operations)',
-        // IN SCOPE, not built: a plain todo family. See the scope ruling above.
-    },
-    {
-        id: 'cms',
-        title: 'CMS — pages, blogs, HubDB, domains, URL redirects, source code, site search, audit logs (306 generated operations)',
-        reason: 'The CMS is HubSpot\'s website product: a page builder, a blog engine, a hosted database '
-            + '(HubDB), a source-code filesystem and a rendered-site search index. It is by far the '
-            + 'largest family in the SDK and shares nothing with the CRM object model beyond the host. A '
-            + 'separate build; nothing answers for it today.',
-    },
-    {
-        id: 'marketing',
-        title: 'Marketing — marketing emails, forms, marketing events, transactional email (109 generated operations)',
-        reason: 'The marketing family sends real email and hosts real forms. Its core act — DELIVERING a '
-            + 'marketing or transactional message to a real inbox — is out of a local twin\'s reach in the '
-            + 'same way every other vendor\'s send path is, and the surrounding CRUD is a separate build. '
-            + 'Not started.',
-    },
-    {
-        id: 'automation',
-        title: 'Automation — custom workflow actions',
-        reason: 'Custom workflow actions register an app\'s own callback into HubSpot\'s workflow engine; '
-            + 'twinning them faithfully means twinning the ENGINE that invokes them. Not started.',
-    },
-    {
-        id: 'conversations',
-        title: 'Conversations — inbox threads, messages, visitor identification',
-        reason: 'The conversations inbox is a real-time messaging product with its own thread/actor model and '
-            + 'a websocket-backed live inbox. Not started.',
-    },
-    {
-        id: 'files',
-        title: 'Files — the file manager, folders, signed URLs (21 generated operations)',
-        reason: 'The file manager stores and serves real binary assets from HubSpot\'s CDN. Not started.',
-    },
-    {
-        id: 'analytics-events',
-        title: 'Events — custom behavioral events, event definitions, the events API',
-        reason: 'Behavioral events are an analytics ingest-and-aggregate product; the read side is a '
-            + 'query engine over ingested events. Not started.',
-    },
-    {
-        id: 'communication-preferences',
-        title: 'Communication preferences — subscription definitions, subscribe/unsubscribe status',
-        reason: 'Subscription preferences govern real marketing-email delivery consent, and are meaningful '
-            + 'only alongside the marketing family above. Not started.',
-    },
-    {
-        id: 'settings',
-        title: 'Settings — portal users, business units',
-        reason: 'Account settings model the PORTAL rather than its CRM data (seat management, business-unit '
-            + 'partitioning). Not started.',
-    },
-    {
-        id: 'webhooks',
-        title: 'Webhooks — app-level event subscriptions and delivery',
-        reason: 'Webhook subscriptions are configured per developer APP, not per portal, and their point is '
-            + 'DELIVERY of signed events to a subscriber URL. Not started — and note the twin ships no '
-            + 'emitter, so no HubSpot event is synthesized either.',
-    },
-    {
-        id: 'oauth',
-        title: 'OAuth — authorization code exchange, refresh tokens, access-token metadata',
-    },
-];
-const BY_ID = new Map(HUBSPOT_AREAS.map((a) => [a.id, a]));
-export function areaById(id) {
-    const found = BY_ID.get(id);
-    if (!found)
-        throw new Error(`hubspot: unknown area '${id}' — add it to HUBSPOT_AREAS`);
-    return found;
-}
-/** The area ids `assertAreaCensus` is given. */
-export const HUBSPOT_AREA_IDS = HUBSPOT_AREAS.map((a) => a.id);

package/dist/src/hubspot-budget.d.ts

@@ -1,58 +0,0 @@
-import { RateBudget, type RateBudgetDeclaration, type RateBudgetOptions, type RateBudgetReservation, type RateBudgetSnapshot } from '@volter/world-core';
-/** Rolling window, in ms. Spend older than this is pruned. */
-export declare const HUBSPOT_BUDGET_WINDOW_MS = 60000;
-/**
- * Weighted units allowed inside one window. 180/60s = 180 ordinary calls a minute — under a THIRD
- * of HubSpot's tightest published tier converted to a minute (Free/Starter: 100 requests per 10
- * seconds for a privately distributed app = 600/minute).
- */
-export declare const HUBSPOT_BUDGET_CEILING = 180;
-/** Seconds. A `Retry-After` above this means the token is throttled hard — fail loudly, don't sleep. */
-export declare const HUBSPOT_BUDGET_MAX_RETRY_AFTER_S = 300;
-/** Per-call cost, keyed by `"<METHOD> <path>"`. See the header for documented vs. judged. */
-export declare const HUBSPOT_CALL_WEIGHTS: {
-    /** CRM Search — HubSpot's own five-requests-per-second burst limit, ~1/3 the general rate. */
-    readonly search: 3;
-    /** Batch object calls — one WRITE mutates up to 100 real CRM records (a human blast radius),
-     *  and the anchored rule prices the whole `/batch/` family, READS included, deliberately: a
-     *  100-record read is the heaviest single request this API serves and pricing it as a write is
-     *  the conservative direction. Named `batchWrite` for the case that motivated the number. */
-    readonly batchWrite: 5;
-    /** Batch association writes — the same shape at a smaller scale. */
-    readonly batchAssociation: 3;
-    /** Everything else: single-record CRUD, properties, pipelines, owners, association reads. */
-    readonly other: 1;
-};
-/** THE PACK'S DECLARATION — pure data, the only HubSpot-specific thing in the whole budget. */
-export declare const HUBSPOT_RATE_BUDGET: RateBudgetDeclaration;
-/**
- * Price one call. The key is `"<METHOD> <path>"` (the absolute API path the connector states,
- * without a host) with the query string split off, so a rule can price by method without the
- * kernel knowing anything about HubSpot. An unclassified endpoint still costs `defaultWeight` —
- * nothing is ever free.
- */
-export declare function hubspotCallWeight(method: string, path: string): number;
-/** Where HubSpot's ledger lives. Token-keyed and cwd-independent by default (the limit is per app
- *  / per private-app token, so a cwd-scoped ledger would hand the same token a fresh allowance in
- *  every checkout, worktree and CI matrix leg); pass `root` to opt into world-scoped accounting. */
-export declare function hubspotBudgetPath(opts?: {
-    root?: string;
-    token?: string;
-} | string): string;
-/** Construction options for HubSpot's budget. The vendor is fixed; everything else may only TIGHTEN. */
-export type HubspotBudgetOptions = Omit<RateBudgetOptions, 'vendor'>;
-/**
- * HubSpot's budget — the shared kernel guard bound to this vendor's declaration. A real subclass,
- * not an alias, so `budget instanceof HubspotBudget` in `liveHubspotExecute` means "a budget that
- * accounts against HUBSPOT's ledger under HUBSPOT's ceiling": another vendor's `RateBudget` (with
- * its own, possibly larger, ceiling) is NOT assignable there.
- */
-export declare class HubspotBudget extends RateBudget {
-    constructor(opts?: HubspotBudgetOptions);
-}
-/** The typed refusal. One error class shared with every other vendor's budget; `err.vendor` says
- *  which one refused, and `err.kind` says why. */
-export { RateBudgetError as HubspotBudgetError } from '@volter/world-core';
-export type { RateBudgetErrorKind as HubspotBudgetErrorKind } from '@volter/world-core';
-export type HubspotBudgetReservation = RateBudgetReservation;
-export type HubspotBudgetSnapshot = RateBudgetSnapshot;