@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/hooks/use-crm-email-templates.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { CRM_COLLECTIONS, CRM_EMAIL_TEMPLATES_LIMIT, crmEmailTemplateIsListed, normalizeCrmEmailTemplate, ORG_SCOPE_TOKEN } from "@aglyn/aglyn";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+import { collection, limit, orderBy, query } from "firebase/firestore";
+import { useMemo } from "react";
+import { crmScopeListable, crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
+const ORG_TOKENS = Object.freeze([
+    ORG_SCOPE_TOKEN
+]);
+const NO_ROWS = [];
+/**
+ * Where an email template lives, for the surface writing or listing it
+ * (AGL-2658).
+ *
+ * Under a site it is the site's, as a task is: stamped with the site's
+ * tokens and `hostId`. From the ORGANIZATION's own hub it is the
+ * organization's — `hostId: null`, the org token alone — the way an
+ * organization task is (AGL-2637): a letter the whole workspace keeps is
+ * not one brand's, and the org-level reader is an org-wide member who may
+ * stamp it so. Every site's hub lists it beside its own, because a site's
+ * read tokens carry the org token.
+ */ export function useCrmEmailTemplateScope(props) {
+    const crmScope = useCrmScope(props);
+    return useMemo(()=>{
+        var _ref, _ref1;
+        var _crmScope_createGroup, _crmScope_consentGroup;
+        return crmScope.level === 'org' ? {
+            scope: crmScope.scope,
+            orgId: crmScope.orgId,
+            ready: crmScope.ready,
+            visibleTo: null,
+            createHostId: null,
+            createTokens: ORG_TOKENS,
+            groupId: (_ref = (_crmScope_createGroup = crmScope.createGroup) == null ? void 0 : _crmScope_createGroup.groupId) != null ? _ref : null
+        } : {
+            scope: crmScope.scope,
+            orgId: crmScope.orgId,
+            ready: crmScope.ready,
+            visibleTo: crmScope.visibleTo,
+            createHostId: crmScope.createHostId,
+            createTokens: crmScope.createTokens,
+            groupId: (_ref1 = (_crmScope_consentGroup = crmScope.consentGroup) == null ? void 0 : _crmScope_consentGroup.groupId) != null ? _ref1 : null
+        };
+    }, [
+        crmScope
+    ]);
+}
+/**
+ * The templates and snippets this member may pick from (AGL-2658): every
+ * shared one the reader's scope reaches, and the personal ones they own.
+ *
+ * ONE bounded listener, filtered on the reader's tokens like every CRM read
+ * and ordered by name — the `(visibleTo, name)` index under a site, the
+ * automatic single-field one at the organization level. A colleague's
+ * personal template is readable under the rules and hidden here by
+ * `crmEmailTemplateIsListed`, for the reason a private saved view is
+ * (AGL-2617). Rows past the window are not listed; the console's create
+ * stops at the window, so a workspace cannot write what its menu cannot
+ * show.
+ */ export function useCrmEmailTemplates(options) {
+    const { scope, visibleTo, uid } = options;
+    const firestore = useFirestore();
+    const { data, status, fromCache } = useFirestoreCollection(()=>scope && crmScopeListable(visibleTo) ? query(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates), ...crmVisibleToClause(visibleTo), orderBy('name'), limit(CRM_EMAIL_TEMPLATES_LIMIT)) : null, [
+        firestore,
+        scope,
+        visibleTo
+    ], {
+        idField: '$id'
+    });
+    const templates = useMemo(()=>{
+        if (!(data == null ? void 0 : data.length)) return NO_ROWS;
+        return data.map((row)=>_extends({
+                $id: String(row['$id'])
+            }, normalizeCrmEmailTemplate(row))).filter((template)=>template.name && crmEmailTemplateIsListed(template, uid));
+    }, [
+        data,
+        uid
+    ]);
+    return {
+        templates,
+        ready: Boolean(scope) && status !== 'loading',
+        fromCache
+    };
+}
+export default useCrmEmailTemplates;
+
+//# sourceMappingURL=use-crm-email-templates.js.map

package/src/lib/hooks/use-crm-email-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-email-templates.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  CRM_COLLECTIONS,\n  CRM_EMAIL_TEMPLATES_LIMIT,\n  type CrmEmailTemplateRow,\n  crmEmailTemplateIsListed,\n  normalizeCrmEmailTemplate,\n  ORG_SCOPE_TOKEN,\n  type ScopeToken,\n} from '@aglyn/aglyn'\nimport { useFirestore, useFirestoreCollection } from '@aglyn/tenant-feature-instance'\nimport { collection, limit, orderBy, query } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport {\n  type CrmOrgDoc,\n  crmScopeListable,\n  crmVisibleToClause,\n  useCrmScope,\n} from './use-crm-scope'\n\nconst ORG_TOKENS: readonly ScopeToken[] = Object.freeze([ORG_SCOPE_TOKEN])\nconst NO_ROWS: CrmEmailTemplateRow[] = []\n\nexport interface CrmEmailTemplateScope {\n  /** The org data root, or `null` until the org lookup settles or when there is none. */\n  scope: readonly ['orgs', string] | null\n  orgId: string | null\n  ready: boolean\n  /** The listener's clause under a site; `null` at the organization level. */\n  visibleTo: readonly ScopeToken[] | null\n  /**\n   * The site a template written here is filed under, or `null` for the\n   * organization's own — see {@link useCrmEmailTemplateScope}.\n   */\n  createHostId: string | null\n  /** What a template written here is stamped with; empty while no site is known. */\n  createTokens: readonly ScopeToken[]\n  /** The holder group whose facet the merge fields read a contact by. */\n  groupId: string | null\n}\n\n/**\n * Where an email template lives, for the surface writing or listing it\n * (AGL-2658).\n *\n * Under a site it is the site's, as a task is: stamped with the site's\n * tokens and `hostId`. From the ORGANIZATION's own hub it is the\n * organization's — `hostId: null`, the org token alone — the way an\n * organization task is (AGL-2637): a letter the whole workspace keeps is\n * not one brand's, and the org-level reader is an org-wide member who may\n * stamp it so. Every site's hub lists it beside its own, because a site's\n * read tokens carry the org token.\n */\nexport function useCrmEmailTemplateScope(props: {\n  hostId: string | null | undefined\n  org?: CrmOrgDoc\n}): CrmEmailTemplateScope {\n  const crmScope = useCrmScope(props)\n  return useMemo(\n    () =>\n      crmScope.level === 'org'\n        ? {\n            scope: crmScope.scope,\n            orgId: crmScope.orgId,\n            ready: crmScope.ready,\n            visibleTo: null,\n            createHostId: null,\n            createTokens: ORG_TOKENS,\n            groupId: crmScope.createGroup?.groupId ?? null,\n          }\n        : {\n            scope: crmScope.scope,\n            orgId: crmScope.orgId,\n            ready: crmScope.ready,\n            visibleTo: crmScope.visibleTo,\n            createHostId: crmScope.createHostId,\n            createTokens: crmScope.createTokens,\n            groupId: crmScope.consentGroup?.groupId ?? null,\n          },\n    [crmScope],\n  )\n}\n\n/**\n * The templates and snippets this member may pick from (AGL-2658): every\n * shared one the reader's scope reaches, and the personal ones they own.\n *\n * ONE bounded listener, filtered on the reader's tokens like every CRM read\n * and ordered by name — the `(visibleTo, name)` index under a site, the\n * automatic single-field one at the organization level. A colleague's\n * personal template is readable under the rules and hidden here by\n * `crmEmailTemplateIsListed`, for the reason a private saved view is\n * (AGL-2617). Rows past the window are not listed; the console's create\n * stops at the window, so a workspace cannot write what its menu cannot\n * show.\n */\nexport function useCrmEmailTemplates(options: {\n  scope: readonly ['orgs', string] | null\n  /** The reader's tokens, or `null` at the organization level — no clause. */\n  visibleTo: readonly string[] | null\n  uid: string | null | undefined\n}): { templates: CrmEmailTemplateRow[]; ready: boolean; fromCache: boolean } {\n  const { scope, visibleTo, uid } = options\n  const firestore = useFirestore()\n  const { data, status, fromCache } = useFirestoreCollection<Record<string, unknown>>(\n    () =>\n      scope && crmScopeListable(visibleTo)\n        ? query(\n            collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates),\n            ...crmVisibleToClause(visibleTo),\n            orderBy('name'),\n            limit(CRM_EMAIL_TEMPLATES_LIMIT),\n          )\n        : null,\n    [firestore, scope, visibleTo],\n    { idField: '$id' },\n  )\n  const templates = useMemo<CrmEmailTemplateRow[]>(() => {\n    if (!data?.length) return NO_ROWS\n    return data\n      .map((row) => ({ $id: String(row['$id']), ...normalizeCrmEmailTemplate(row) }))\n      .filter((template) => template.name && crmEmailTemplateIsListed(template, uid))\n  }, [data, uid])\n  return { templates, ready: Boolean(scope) && status !== 'loading', fromCache }\n}\n\nexport default useCrmEmailTemplates\n"],"names":["CRM_COLLECTIONS","CRM_EMAIL_TEMPLATES_LIMIT","crmEmailTemplateIsListed","normalizeCrmEmailTemplate","ORG_SCOPE_TOKEN","useFirestore","useFirestoreCollection","collection","limit","orderBy","query","useMemo","crmScopeListable","crmVisibleToClause","useCrmScope","ORG_TOKENS","Object","freeze","NO_ROWS","useCrmEmailTemplateScope","props","crmScope","level","scope","orgId","ready","visibleTo","createHostId","createTokens","groupId","createGroup","consentGroup","useCrmEmailTemplates","options","uid","firestore","data","status","fromCache","emailTemplates","idField","templates","length","map","row","$id","String","filter","template","name","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SACEA,eAAe,EACfC,yBAAyB,EAEzBC,wBAAwB,EACxBC,yBAAyB,EACzBC,eAAe,QAEV,eAAc;AACrB,SAASC,YAAY,EAAEC,sBAAsB,QAAQ,iCAAgC;AACrF,SAASC,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,QAAQ,qBAAoB;AACtE,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAEEC,gBAAgB,EAChBC,kBAAkB,EAClBC,WAAW,QACN,qBAAiB;AAExB,MAAMC,aAAoCC,OAAOC,MAAM,CAAC;IAACb;CAAgB;AACzE,MAAMc,UAAiC,EAAE;AAoBzC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,yBAAyBC,KAGxC;IACC,MAAMC,WAAWP,YAAYM;IAC7B,OAAOT,QACL;;YASiBU,uBASAA;eAjBfA,SAASC,KAAK,KAAK,QACf;YACEC,OAAOF,SAASE,KAAK;YACrBC,OAAOH,SAASG,KAAK;YACrBC,OAAOJ,SAASI,KAAK;YACrBC,WAAW;YACXC,cAAc;YACdC,cAAcb;YACdc,OAAO,WAAER,wBAAAA,SAASS,WAAW,qBAApBT,sBAAsBQ,OAAO,mBAAI;QAC5C,IACA;YACEN,OAAOF,SAASE,KAAK;YACrBC,OAAOH,SAASG,KAAK;YACrBC,OAAOJ,SAASI,KAAK;YACrBC,WAAWL,SAASK,SAAS;YAC7BC,cAAcN,SAASM,YAAY;YACnCC,cAAcP,SAASO,YAAY;YACnCC,OAAO,YAAER,yBAAAA,SAASU,YAAY,qBAArBV,uBAAuBQ,OAAO,oBAAI;QAC7C;OACN;QAACR;KAAS;AAEd;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASW,qBAAqBC,OAKpC;IACC,MAAM,EAAEV,KAAK,EAAEG,SAAS,EAAEQ,GAAG,EAAE,GAAGD;IAClC,MAAME,YAAY9B;IAClB,MAAM,EAAE+B,IAAI,EAAEC,MAAM,EAAEC,SAAS,EAAE,GAAGhC,uBAClC,IACEiB,SAASX,iBAAiBc,aACtBhB,MACEH,WAAW4B,WAAWZ,KAAK,CAAC,EAAE,EAAEA,KAAK,CAAC,EAAE,EAAEvB,gBAAgBuC,cAAc,MACrE1B,mBAAmBa,YACtBjB,QAAQ,SACRD,MAAMP,8BAER,MACN;QAACkC;QAAWZ;QAAOG;KAAU,EAC7B;QAAEc,SAAS;IAAM;IAEnB,MAAMC,YAAY9B,QAA+B;QAC/C,IAAI,EAACyB,wBAAAA,KAAMM,MAAM,GAAE,OAAOxB;QAC1B,OAAOkB,KACJO,GAAG,CAAC,CAACC,MAAS;gBAAEC,KAAKC,OAAOF,GAAG,CAAC,MAAM;eAAMzC,0BAA0ByC,OACtEG,MAAM,CAAC,CAACC,WAAaA,SAASC,IAAI,IAAI/C,yBAAyB8C,UAAUd;IAC9E,GAAG;QAACE;QAAMF;KAAI;IACd,OAAO;QAAEO;QAAWhB,OAAOyB,QAAQ3B,UAAUc,WAAW;QAAWC;IAAU;AAC/E;AAEA,eAAeN,qBAAoB"}

package/src/lib/hooks/use-crm-hub-path.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The CRM hub's own path — `/{orgSlug}/hosts/{host}/crm` — for a surface
+ * that was not handed one (AGL-2599).
+ *
+ * A section rendered by the hub receives `basePath` from the shell and
+ * passes it down, and that value wins whenever it is present: it is the
+ * address the shell actually resolved, legacy `/contacts` included. The
+ * dashboard widget and a record card dropped onto somebody else's page get
+ * a host id and nothing else, so for them the path is rebuilt from the URL
+ * the way the other dashboard glances build theirs. `useParams` is called
+ * unconditionally because a hook cannot be skipped on a prop.
+ */
+export declare function useCrmHubPath(basePath?: string | null): string;

package/src/lib/hooks/use-crm-hub-path.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { buildRoute, Route } from "@aglyn/aglyn";
+import { useParams } from "next/navigation";
+/**
+ * The CRM hub's own path — `/{orgSlug}/hosts/{host}/crm` — for a surface
+ * that was not handed one (AGL-2599).
+ *
+ * A section rendered by the hub receives `basePath` from the shell and
+ * passes it down, and that value wins whenever it is present: it is the
+ * address the shell actually resolved, legacy `/contacts` included. The
+ * dashboard widget and a record card dropped onto somebody else's page get
+ * a host id and nothing else, so for them the path is rebuilt from the URL
+ * the way the other dashboard glances build theirs. `useParams` is called
+ * unconditionally because a hook cannot be skipped on a prop.
+ */ export function useCrmHubPath(basePath) {
+    var _ref, _ref1;
+    const params = useParams();
+    if (basePath) return basePath;
+    const orgSlug = String((_ref = params == null ? void 0 : params.orgSlug) != null ? _ref : '');
+    const host = String((_ref1 = params == null ? void 0 : params.host) != null ? _ref1 : '');
+    return `${buildRoute(Route.HOST_DASHBOARD, {
+        orgSlug,
+        host
+    })}/crm`;
+}
+
+//# sourceMappingURL=use-crm-hub-path.js.map

package/src/lib/hooks/use-crm-hub-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-hub-path.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { buildRoute, Route } from '@aglyn/aglyn'\nimport { useParams } from 'next/navigation'\n\n/**\n * The CRM hub's own path — `/{orgSlug}/hosts/{host}/crm` — for a surface\n * that was not handed one (AGL-2599).\n *\n * A section rendered by the hub receives `basePath` from the shell and\n * passes it down, and that value wins whenever it is present: it is the\n * address the shell actually resolved, legacy `/contacts` included. The\n * dashboard widget and a record card dropped onto somebody else's page get\n * a host id and nothing else, so for them the path is rebuilt from the URL\n * the way the other dashboard glances build theirs. `useParams` is called\n * unconditionally because a hook cannot be skipped on a prop.\n */\nexport function useCrmHubPath(basePath?: string | null): string {\n  const params = useParams<{ orgSlug?: string; host?: string }>()\n  if (basePath) return basePath\n  const orgSlug = String(params?.orgSlug ?? '')\n  const host = String(params?.host ?? '')\n  return `${buildRoute(Route.HOST_DASHBOARD, { orgSlug, host })}/crm`\n}\n"],"names":["buildRoute","Route","useParams","useCrmHubPath","basePath","params","orgSlug","String","host","HOST_DASHBOARD"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,KAAK,QAAQ,eAAc;AAChD,SAASC,SAAS,QAAQ,kBAAiB;AAE3C;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,cAAcC,QAAwB;;IACpD,MAAMC,SAASH;IACf,IAAIE,UAAU,OAAOA;IACrB,MAAME,UAAUC,eAAOF,0BAAAA,OAAQC,OAAO,mBAAI;IAC1C,MAAME,OAAOD,gBAAOF,0BAAAA,OAAQG,IAAI,oBAAI;IACpC,OAAO,GAAGR,WAAWC,MAAMQ,cAAc,EAAE;QAAEH;QAASE;IAAK,GAAG,IAAI,CAAC;AACrE"}

package/src/lib/hooks/use-crm-org-mount.d.ts

@@ -0,0 +1,97 @@
+import type { ConsolePluginOrgMount } from '@aglyn/aglyn';
+import { type ComponentType, type ReactNode } from 'react';
+/**
+ * The organization-level mount, as every CRM surface beneath the hub reads
+ * it (AGL-2630).
+ *
+ * The shell hands the hub page an org and its sites; the hub publishes them
+ * through this context so a drawer four components down — the one that has
+ * to ask which site a new record is captured by — reaches them without four
+ * components threading a prop they never read. `useCrmScope` reads it too:
+ * a surface handed `hostId: null` learns from here which org it is under,
+ * which is what lets every existing `useCrmScope({ hostId, org })` call
+ * serve the org level unchanged.
+ */
+export interface CrmOrgMount extends ConsolePluginOrgMount {
+    /**
+     * The site the next create stamps from: the reader's last pick this
+     * session, or the org's only site when it has exactly one, else `null`
+     * until somebody picks. A record is always captured BY a site — its
+     * `hostId`, its `visibleTo`, the consent group its profile lives on all
+     * come from one — and at the org level nothing else can say which.
+     */
+    createHostId: string | null;
+    setCreateHostId: (hostId: string) => void;
+    /** How a site reads on screen — its name, or its id when the list cannot name it. */
+    siteName: (hostId: string) => string;
+    /**
+     * The subdomain a console URL under `/hosts/[host]` takes, or `null` for
+     * a site the list did not answer for — named, never linked.
+     */
+    siteSubdomain: (hostId: string) => string | null;
+    /**
+     * The site's own CRM hub — `${hostsPath}/${subdomain}/crm` — or `null`
+     * for a site whose subdomain the list could not answer, which is named
+     * and not linked.
+     */
+    siteHubHref: (hostId: string) => string | null;
+}
+/**
+ * Publishes the org-level mount to every surface beneath it.
+ *
+ * Mounted by the hub page ONLY when the shell handed it an `orgMount`; under
+ * a site there is no provider and `useCrmOrgMount` answers `null`, which is
+ * how a surface tells the two levels apart without a second prop.
+ */
+export declare function CrmOrgMountProvider(props: {
+    mount: ConsolePluginOrgMount;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare namespace CrmOrgMountProvider {
+    var displayName: string;
+}
+/** The org-level mount, or `null` under a site. */
+export declare function useCrmOrgMount(): CrmOrgMount | null;
+/**
+ * `Card` beneath the org-level mount the SHELL hands it as a prop (AGL-2636).
+ *
+ * The hub page mounts the provider itself, because the shell hands the hub
+ * page an `orgMount` and the page owns everything under it. A widget on the
+ * org's `orgDashboard` slot is dropped into a console page the CRM does not
+ * own — the org's sites list — and the console never imports a plugin, so
+ * the page cannot mount this plugin's provider around the slot. The slot
+ * hands each widget the same `orgMount` instead, and this puts the provider
+ * where the hub page puts it: around the surface, one level down. `Card`
+ * then reads `useCrmOrgMount()` and `useCrmScope({ hostId: null })` exactly
+ * as it does under the hub, and stays one component for both mounts.
+ *
+ * Handed no mount — a slot that names a site, or a shell older than the org
+ * zone — the card renders as it is, and `useCrmOrgMount` answers `null` the
+ * way it does under a site.
+ */
+export declare function withCrmOrgMount<P extends object>(Card: ComponentType<P>): ComponentType<P & {
+    orgMount?: ConsolePluginOrgMount;
+}>;
+/**
+ * THE SITE A CREATE OPENED FROM A RECORD DEFAULTS TO (AGL-2630).
+ *
+ * A task, an activity or a deal filed from a contact's page belongs, nine
+ * times in ten, with the site that captured the contact — not with the
+ * site the reader last picked in a list's drawer. So a record page wraps
+ * its cards in this, naming its record's own capturing site, and every
+ * create under it defaults its Site picker there. A pick the reader makes
+ * INSIDE such a create is held for that page alone; the session's pick,
+ * which a create opened from a list keeps defaulting to, is untouched.
+ *
+ * Nothing under a site, nothing for a record no site has captured, and
+ * nothing for a site the mount's list does not carry — the reader may not
+ * have it: the children render as they are and the session's pick stands.
+ */
+export declare function CrmCreateSiteDefault(props: {
+    hostId: string | null | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare namespace CrmCreateSiteDefault {
+    var displayName: string;
+}
+export default useCrmOrgMount;

package/src/lib/hooks/use-crm-org-mount.js

@@ -0,0 +1,215 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+const CrmOrgMountContext = /*#__PURE__*/ createContext(null);
+/**
+ * The session's memory of the picked site, per org. Session storage rather
+ * than local: the pick is a working convenience for one sitting, and a
+ * site remembered across weeks would stamp a record onto a site the reader
+ * had forgotten choosing.
+ */ const pickStorageKey = (orgId)=>`aglyn.crm.createSite.${orgId}`;
+function readRememberedPick(orgId) {
+    try {
+        return window.sessionStorage.getItem(pickStorageKey(orgId));
+    } catch (unused) {
+        return null;
+    }
+}
+function writeRememberedPick(orgId, hostId) {
+    try {
+        window.sessionStorage.setItem(pickStorageKey(orgId), hostId);
+    } catch (unused) {
+    // A browser that refuses storage still gets the pick for this page.
+    }
+}
+/**
+ * Publishes the org-level mount to every surface beneath it.
+ *
+ * Mounted by the hub page ONLY when the shell handed it an `orgMount`; under
+ * a site there is no provider and `useCrmOrgMount` answers `null`, which is
+ * how a surface tells the two levels apart without a second prop.
+ */ export function CrmOrgMountProvider(props) {
+    const { mount, children } = props;
+    const { orgId, hosts, hostsReady, hostsPath } = mount;
+    const [picked, setPicked] = useState(null);
+    // Read after mount rather than in the initializer, so the server and the
+    // first client paint agree: the pick only ever affects a drawer somebody
+    // has since opened.
+    useEffect(()=>{
+        setPicked(readRememberedPick(orgId));
+    }, [
+        orgId
+    ]);
+    const byId = useMemo(()=>{
+        const index = new Map();
+        for (const host of hosts)index.set(host.id, host);
+        return index;
+    }, [
+        hosts
+    ]);
+    /*
+   * A remembered site the list no longer carries is forgotten rather than
+   * stamped — the reader may have lost the site, or the site may be gone.
+   * An org with exactly one site needs no picker at all; nothing else is
+   * picked silently, because a wrong guess files a person under a brand
+   * that never met them.
+   */ const createHostId = useMemo(()=>{
+        if (picked && byId.has(picked)) return picked;
+        if (hostsReady && hosts.length === 1) return hosts[0].id;
+        return null;
+    }, [
+        picked,
+        byId,
+        hostsReady,
+        hosts
+    ]);
+    const setCreateHostId = useCallback((hostId)=>{
+        setPicked(hostId);
+        writeRememberedPick(orgId, hostId);
+    }, [
+        orgId
+    ]);
+    const siteName = useCallback((hostId)=>{
+        var _byId_get;
+        return ((_byId_get = byId.get(hostId)) == null ? void 0 : _byId_get.name) || hostId;
+    }, [
+        byId
+    ]);
+    const siteSubdomain = useCallback((hostId)=>{
+        var _ref;
+        var _byId_get;
+        return (_ref = (_byId_get = byId.get(hostId)) == null ? void 0 : _byId_get.subdomain) != null ? _ref : null;
+    }, [
+        byId
+    ]);
+    const siteHubHref = useCallback((hostId)=>{
+        var _byId_get;
+        const subdomain = (_byId_get = byId.get(hostId)) == null ? void 0 : _byId_get.subdomain;
+        return subdomain ? `${hostsPath}/${encodeURIComponent(subdomain)}/crm` : null;
+    }, [
+        byId,
+        hostsPath
+    ]);
+    const value = useMemo(()=>({
+            orgId,
+            hosts,
+            hostsReady,
+            hostsPath,
+            createHostId,
+            setCreateHostId,
+            siteName,
+            siteSubdomain,
+            siteHubHref
+        }), [
+        orgId,
+        hosts,
+        hostsReady,
+        hostsPath,
+        createHostId,
+        setCreateHostId,
+        siteName,
+        siteSubdomain,
+        siteHubHref
+    ]);
+    return /*#__PURE__*/ _jsx(CrmOrgMountContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+CrmOrgMountProvider.displayName = 'CrmOrgMountProvider';
+/** The org-level mount, or `null` under a site. */ export function useCrmOrgMount() {
+    return useContext(CrmOrgMountContext);
+}
+/**
+ * `Card` beneath the org-level mount the SHELL hands it as a prop (AGL-2636).
+ *
+ * The hub page mounts the provider itself, because the shell hands the hub
+ * page an `orgMount` and the page owns everything under it. A widget on the
+ * org's `orgDashboard` slot is dropped into a console page the CRM does not
+ * own — the org's sites list — and the console never imports a plugin, so
+ * the page cannot mount this plugin's provider around the slot. The slot
+ * hands each widget the same `orgMount` instead, and this puts the provider
+ * where the hub page puts it: around the surface, one level down. `Card`
+ * then reads `useCrmOrgMount()` and `useCrmScope({ hostId: null })` exactly
+ * as it does under the hub, and stays one component for both mounts.
+ *
+ * Handed no mount — a slot that names a site, or a shell older than the org
+ * zone — the card renders as it is, and `useCrmOrgMount` answers `null` the
+ * way it does under a site.
+ */ export function withCrmOrgMount(Card) {
+    var _ref, _Card_displayName;
+    function CrmOrgMounted(props) {
+        const { orgMount } = props, rest = _object_without_properties_loose(props, [
+            "orgMount"
+        ]);
+        const card = /*#__PURE__*/ _jsx(Card, _extends({}, rest));
+        return orgMount ? /*#__PURE__*/ _jsx(CrmOrgMountProvider, {
+            mount: orgMount,
+            children: card
+        }) : card;
+    }
+    CrmOrgMounted.displayName = `CrmOrgMounted(${(_ref = (_Card_displayName = Card.displayName) != null ? _Card_displayName : Card.name) != null ? _ref : 'Card'})`;
+    return CrmOrgMounted;
+}
+/**
+ * THE SITE A CREATE OPENED FROM A RECORD DEFAULTS TO (AGL-2630).
+ *
+ * A task, an activity or a deal filed from a contact's page belongs, nine
+ * times in ten, with the site that captured the contact — not with the
+ * site the reader last picked in a list's drawer. So a record page wraps
+ * its cards in this, naming its record's own capturing site, and every
+ * create under it defaults its Site picker there. A pick the reader makes
+ * INSIDE such a create is held for that page alone; the session's pick,
+ * which a create opened from a list keeps defaulting to, is untouched.
+ *
+ * Nothing under a site, nothing for a record no site has captured, and
+ * nothing for a site the mount's list does not carry — the reader may not
+ * have it: the children render as they are and the session's pick stands.
+ */ export function CrmCreateSiteDefault(props) {
+    const { hostId, children } = props;
+    const mount = useContext(CrmOrgMountContext);
+    const [picked, setPicked] = useState(null);
+    // Another record on the same page starts from its own site again.
+    useEffect(()=>{
+        setPicked(null);
+    }, [
+        hostId
+    ]);
+    const value = useMemo(()=>{
+        if (!mount || !hostId) return mount;
+        if (!mount.hosts.some((host)=>host.id === hostId)) return mount;
+        return _extends({}, mount, {
+            createHostId: picked != null ? picked : hostId,
+            setCreateHostId: setPicked
+        });
+    }, [
+        mount,
+        hostId,
+        picked
+    ]);
+    return /*#__PURE__*/ _jsx(CrmOrgMountContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+CrmCreateSiteDefault.displayName = 'CrmCreateSiteDefault';
+export default useCrmOrgMount;
+
+//# sourceMappingURL=use-crm-org-mount.js.map

package/src/lib/hooks/use-crm-org-mount.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-org-mount.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport type { ConsolePluginOrgHost, ConsolePluginOrgMount } from '@aglyn/aglyn'\nimport {\n  type ComponentType,\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react'\n\n/**\n * The organization-level mount, as every CRM surface beneath the hub reads\n * it (AGL-2630).\n *\n * The shell hands the hub page an org and its sites; the hub publishes them\n * through this context so a drawer four components down — the one that has\n * to ask which site a new record is captured by — reaches them without four\n * components threading a prop they never read. `useCrmScope` reads it too:\n * a surface handed `hostId: null` learns from here which org it is under,\n * which is what lets every existing `useCrmScope({ hostId, org })` call\n * serve the org level unchanged.\n */\nexport interface CrmOrgMount extends ConsolePluginOrgMount {\n  /**\n   * The site the next create stamps from: the reader's last pick this\n   * session, or the org's only site when it has exactly one, else `null`\n   * until somebody picks. A record is always captured BY a site — its\n   * `hostId`, its `visibleTo`, the consent group its profile lives on all\n   * come from one — and at the org level nothing else can say which.\n   */\n  createHostId: string | null\n  setCreateHostId: (hostId: string) => void\n  /** How a site reads on screen — its name, or its id when the list cannot name it. */\n  siteName: (hostId: string) => string\n  /**\n   * The subdomain a console URL under `/hosts/[host]` takes, or `null` for\n   * a site the list did not answer for — named, never linked.\n   */\n  siteSubdomain: (hostId: string) => string | null\n  /**\n   * The site's own CRM hub — `${hostsPath}/${subdomain}/crm` — or `null`\n   * for a site whose subdomain the list could not answer, which is named\n   * and not linked.\n   */\n  siteHubHref: (hostId: string) => string | null\n}\n\nconst CrmOrgMountContext = createContext<CrmOrgMount | null>(null)\n\n/**\n * The session's memory of the picked site, per org. Session storage rather\n * than local: the pick is a working convenience for one sitting, and a\n * site remembered across weeks would stamp a record onto a site the reader\n * had forgotten choosing.\n */\nconst pickStorageKey = (orgId: string) => `aglyn.crm.createSite.${orgId}`\n\nfunction readRememberedPick(orgId: string): string | null {\n  try {\n    return window.sessionStorage.getItem(pickStorageKey(orgId))\n  } catch {\n    return null\n  }\n}\n\nfunction writeRememberedPick(orgId: string, hostId: string): void {\n  try {\n    window.sessionStorage.setItem(pickStorageKey(orgId), hostId)\n  } catch {\n    // A browser that refuses storage still gets the pick for this page.\n  }\n}\n\n/**\n * Publishes the org-level mount to every surface beneath it.\n *\n * Mounted by the hub page ONLY when the shell handed it an `orgMount`; under\n * a site there is no provider and `useCrmOrgMount` answers `null`, which is\n * how a surface tells the two levels apart without a second prop.\n */\nexport function CrmOrgMountProvider(props: {\n  mount: ConsolePluginOrgMount\n  children: ReactNode\n}) {\n  const { mount, children } = props\n  const { orgId, hosts, hostsReady, hostsPath } = mount\n  const [picked, setPicked] = useState<string | null>(null)\n  // Read after mount rather than in the initializer, so the server and the\n  // first client paint agree: the pick only ever affects a drawer somebody\n  // has since opened.\n  useEffect(() => {\n    setPicked(readRememberedPick(orgId))\n  }, [orgId])\n\n  const byId = useMemo(() => {\n    const index = new Map<string, ConsolePluginOrgHost>()\n    for (const host of hosts) index.set(host.id, host)\n    return index\n  }, [hosts])\n\n  /*\n   * A remembered site the list no longer carries is forgotten rather than\n   * stamped — the reader may have lost the site, or the site may be gone.\n   * An org with exactly one site needs no picker at all; nothing else is\n   * picked silently, because a wrong guess files a person under a brand\n   * that never met them.\n   */\n  const createHostId = useMemo(() => {\n    if (picked && byId.has(picked)) return picked\n    if (hostsReady && hosts.length === 1) return hosts[0].id\n    return null\n  }, [picked, byId, hostsReady, hosts])\n\n  const setCreateHostId = useCallback(\n    (hostId: string) => {\n      setPicked(hostId)\n      writeRememberedPick(orgId, hostId)\n    },\n    [orgId],\n  )\n  const siteName = useCallback(\n    (hostId: string) => byId.get(hostId)?.name || hostId,\n    [byId],\n  )\n  const siteSubdomain = useCallback(\n    (hostId: string) => byId.get(hostId)?.subdomain ?? null,\n    [byId],\n  )\n  const siteHubHref = useCallback(\n    (hostId: string) => {\n      const subdomain = byId.get(hostId)?.subdomain\n      return subdomain ? `${hostsPath}/${encodeURIComponent(subdomain)}/crm` : null\n    },\n    [byId, hostsPath],\n  )\n\n  const value = useMemo<CrmOrgMount>(\n    () => ({\n      orgId,\n      hosts,\n      hostsReady,\n      hostsPath,\n      createHostId,\n      setCreateHostId,\n      siteName,\n      siteSubdomain,\n      siteHubHref,\n    }),\n    [\n      orgId,\n      hosts,\n      hostsReady,\n      hostsPath,\n      createHostId,\n      setCreateHostId,\n      siteName,\n      siteSubdomain,\n      siteHubHref,\n    ],\n  )\n  return (\n    <CrmOrgMountContext.Provider value={value}>\n      {children}\n    </CrmOrgMountContext.Provider>\n  )\n}\nCrmOrgMountProvider.displayName = 'CrmOrgMountProvider'\n\n/** The org-level mount, or `null` under a site. */\nexport function useCrmOrgMount(): CrmOrgMount | null {\n  return useContext(CrmOrgMountContext)\n}\n\n/**\n * `Card` beneath the org-level mount the SHELL hands it as a prop (AGL-2636).\n *\n * The hub page mounts the provider itself, because the shell hands the hub\n * page an `orgMount` and the page owns everything under it. A widget on the\n * org's `orgDashboard` slot is dropped into a console page the CRM does not\n * own — the org's sites list — and the console never imports a plugin, so\n * the page cannot mount this plugin's provider around the slot. The slot\n * hands each widget the same `orgMount` instead, and this puts the provider\n * where the hub page puts it: around the surface, one level down. `Card`\n * then reads `useCrmOrgMount()` and `useCrmScope({ hostId: null })` exactly\n * as it does under the hub, and stays one component for both mounts.\n *\n * Handed no mount — a slot that names a site, or a shell older than the org\n * zone — the card renders as it is, and `useCrmOrgMount` answers `null` the\n * way it does under a site.\n */\nexport function withCrmOrgMount<P extends object>(\n  Card: ComponentType<P>,\n): ComponentType<P & { orgMount?: ConsolePluginOrgMount }> {\n  function CrmOrgMounted(props: P & { orgMount?: ConsolePluginOrgMount }) {\n    const { orgMount, ...rest } = props\n    const card = <Card {...(rest as P)} />\n    return orgMount ? (\n      <CrmOrgMountProvider mount={orgMount}>{card}</CrmOrgMountProvider>\n    ) : (\n      card\n    )\n  }\n  CrmOrgMounted.displayName = `CrmOrgMounted(${\n    Card.displayName ?? (Card as { name?: string }).name ?? 'Card'\n  })`\n  return CrmOrgMounted\n}\n\n/**\n * THE SITE A CREATE OPENED FROM A RECORD DEFAULTS TO (AGL-2630).\n *\n * A task, an activity or a deal filed from a contact's page belongs, nine\n * times in ten, with the site that captured the contact — not with the\n * site the reader last picked in a list's drawer. So a record page wraps\n * its cards in this, naming its record's own capturing site, and every\n * create under it defaults its Site picker there. A pick the reader makes\n * INSIDE such a create is held for that page alone; the session's pick,\n * which a create opened from a list keeps defaulting to, is untouched.\n *\n * Nothing under a site, nothing for a record no site has captured, and\n * nothing for a site the mount's list does not carry — the reader may not\n * have it: the children render as they are and the session's pick stands.\n */\nexport function CrmCreateSiteDefault(props: {\n  hostId: string | null | undefined\n  children: ReactNode\n}) {\n  const { hostId, children } = props\n  const mount = useContext(CrmOrgMountContext)\n  const [picked, setPicked] = useState<string | null>(null)\n  // Another record on the same page starts from its own site again.\n  useEffect(() => {\n    setPicked(null)\n  }, [hostId])\n  const value = useMemo<CrmOrgMount | null>(() => {\n    if (!mount || !hostId) return mount\n    if (!mount.hosts.some((host) => host.id === hostId)) return mount\n    return {\n      ...mount,\n      createHostId: picked ?? hostId,\n      setCreateHostId: setPicked,\n    }\n  }, [mount, hostId, picked])\n  return (\n    <CrmOrgMountContext.Provider value={value}>\n      {children}\n    </CrmOrgMountContext.Provider>\n  )\n}\nCrmCreateSiteDefault.displayName = 'CrmCreateSiteDefault'\n\nexport default useCrmOrgMount\n"],"names":["createContext","useCallback","useContext","useEffect","useMemo","useState","CrmOrgMountContext","pickStorageKey","orgId","readRememberedPick","window","sessionStorage","getItem","writeRememberedPick","hostId","setItem","CrmOrgMountProvider","props","mount","children","hosts","hostsReady","hostsPath","picked","setPicked","byId","index","Map","host","set","id","createHostId","has","length","setCreateHostId","siteName","get","name","siteSubdomain","subdomain","siteHubHref","encodeURIComponent","value","Provider","displayName","useCrmOrgMount","withCrmOrgMount","Card","CrmOrgMounted","orgMount","rest","card","CrmCreateSiteDefault","some"],"mappings":"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"}

package/src/lib/hooks/use-crm-record-names.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type CrmRecordKind = 'contact' | 'company' | 'deal';
+/** The collection each kind of record lives in, under `orgs/{orgId}/`. */
+export declare const CRM_RECORD_COLLECTIONS: Record<CrmRecordKind, string>;
+/**
+ * What a record is CALLED, from its document.
+ *
+ * A contact's name is read through the viewing group's facet, the way the
+ * people list reads it, so one business renaming a person does not change
+ * what an unrelated business's task list shows; the email stands in for a
+ * contact nobody has named. A company has a name and a deal a title.
+ */
+export declare function crmRecordName(kind: CrmRecordKind, data: Record<string, unknown> | undefined, groupId: string): string;
+/** Test seam: forget everything, so a spec's fixtures are what get read. */
+export declare function resetCrmRecordNameCache(): void;
+/**
+ * The names of the records a list of tasks points at, resolved once each.
+ *
+ * Returns a lookup rather than a map so the caller does not have to know the
+ * cache's key shape. An unresolved record answers `undefined` — the cell
+ * renders the link with the id until the name lands, which is one render
+ * later on a warm cache and one round trip on a cold one.
+ */
+export declare function useCrmRecordNames(options: {
+    orgId: string | null | undefined;
+    /**
+     * The viewing group a contact is named through, or `null` at the
+     * organization level (AGL-2630), where each contact is named through its
+     * own primary holder, resolved from {@link org}.
+     */
+    groupId: string | null;
+    org?: Record<string, unknown> | null;
+    records: ReadonlyArray<{
+        kind: CrmRecordKind;
+        id: string;
+    }>;
+}): (kind: CrmRecordKind, id: string) => string | undefined;