@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/use-emails-hub-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-emails-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'use client'\n\nimport { buildRoute, Route } from '@aglyn/aglyn'\nimport { useParams } from 'next/navigation'\nimport { useCrmOrgMount } from '../hooks/use-crm-org-mount'\n\n/**\n * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`\n * — or `null` when the page is not under a site.\n *\n * The sibling-hub pattern the Emails console uses to reach Marketing, in the\n * other direction: a CRM record page links a campaign entry to the email's\n * own report, which lives on the Emails surface, and the shell's `basePath`\n * names only this surface. Read off the URL rather than derived from\n * `basePath`, because the `[host]` segment is the site's subdomain and\n * nothing a CRM component holds says what that is.\n *\n * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot\n * address a sibling site's Emails console without that site's subdomain,\n * which a contact document does not carry.\n *\n * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount\n * holds the org's site list instead: handed a `hostId`, this answers that\n * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site\n * whose subdomain the list could not answer, which is named and not linked.\n * Handed none, `null`: an org-level page has no hub of its own to fall\n * back to.\n */\nexport function useEmailsHubPath(hostId?: string | null): string | null {\n  const params = useParams<{ orgSlug: string; host: string }>()\n  const mount = useCrmOrgMount()\n  const orgSlug = params?.orgSlug\n  const host = params?.host\n  if (orgSlug && host) {\n    return buildRoute(Route.HOST_PLUGIN, { orgSlug, host, pluginSlug: 'emails' })\n  }\n  if (!mount || !hostId) return null\n  const subdomain = mount.siteSubdomain(hostId)\n  return subdomain ? `${mount.hostsPath}/${encodeURIComponent(subdomain)}/emails` : null\n}\n\nexport default useEmailsHubPath\n"],"names":["buildRoute","Route","useParams","useCrmOrgMount","useEmailsHubPath","hostId","params","mount","orgSlug","host","HOST_PLUGIN","pluginSlug","subdomain","siteSubdomain","hostsPath","encodeURIComponent"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,UAAU,EAAEC,KAAK,QAAQ,eAAc;AAChD,SAASC,SAAS,QAAQ,kBAAiB;AAC3C,SAASC,cAAc,QAAQ,gCAA4B;AAE3D;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,OAAO,SAASC,iBAAiBC,MAAsB;IACrD,MAAMC,SAASJ;IACf,MAAMK,QAAQJ;IACd,MAAMK,UAAUF,0BAAAA,OAAQE,OAAO;IAC/B,MAAMC,OAAOH,0BAAAA,OAAQG,IAAI;IACzB,IAAID,WAAWC,MAAM;QACnB,OAAOT,WAAWC,MAAMS,WAAW,EAAE;YAAEF;YAASC;YAAME,YAAY;QAAS;IAC7E;IACA,IAAI,CAACJ,SAAS,CAACF,QAAQ,OAAO;IAC9B,MAAMO,YAAYL,MAAMM,aAAa,CAACR;IACtC,OAAOO,YAAY,GAAGL,MAAMO,SAAS,CAAC,CAAC,EAAEC,mBAAmBH,WAAW,OAAO,CAAC,GAAG;AACpF;AAEA,eAAeR,iBAAgB"}

package/src/lib/components/use-member-email-aliases.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @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 { type MemberEmailAliasRow } from '@aglyn/aglyn/app-utils/member-email-aliases';
+/** What one change answered: done, with what the route said, or refused and why. */
+export type MemberEmailAliasChange = {
+    ok: true;
+    payload: Record<string, any>;
+} | {
+    ok: false;
+    error: string;
+};
+export interface MemberEmailAliases {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    aliases: MemberEmailAliasRow[];
+    /** The address the member signs in with, which already counts as theirs. */
+    signInEmail: string | null;
+    error: string | null;
+    /** True while a change is in flight. */
+    busy: boolean;
+    add: (address: string) => Promise<MemberEmailAliasChange>;
+    resend: (address: string) => Promise<MemberEmailAliasChange>;
+    remove: (address: string) => Promise<MemberEmailAliasChange>;
+    /** Confirms the address a link was sent for; the token names the workspace. */
+    confirm: (token: string) => Promise<MemberEmailAliasChange>;
+}
+/**
+ * The signed-in member's own addresses in one workspace (AGL-2975), from
+ * the core route every surface shares. A list the member keeps for
+ * themselves, so it is read through the route rather than a listener: the
+ * rules close the collection to every client.
+ *
+ * Every change re-reads the list, so a row's state is always the stored
+ * one — an add that could not send its email still shows the address,
+ * waiting, with a way to send again. The page the member is on rides along
+ * as the path the confirmation link should land on.
+ */
+export declare function useMemberEmailAliases(orgId: string | null, options: {
+    enabled: boolean;
+}): MemberEmailAliases;
+export default useMemberEmailAliases;

package/src/lib/components/use-member-email-aliases.js

@@ -0,0 +1,186 @@
+/**
+ * @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 { MEMBER_EMAIL_ALIASES_ROUTE } from "@aglyn/aglyn/app-utils/member-email-aliases";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useRef, useState } from "react";
+const LOAD_FAILED = 'Your addresses could not be loaded.';
+const CHANGE_FAILED = 'That change could not be made.';
+/**
+ * The signed-in member's own addresses in one workspace (AGL-2975), from
+ * the core route every surface shares. A list the member keeps for
+ * themselves, so it is read through the route rather than a listener: the
+ * rules close the collection to every client.
+ *
+ * Every change re-reads the list, so a row's state is always the stored
+ * one — an add that could not send its email still shows the address,
+ * waiting, with a way to send again. The page the member is on rides along
+ * as the path the confirmation link should land on.
+ */ export function useMemberEmailAliases(orgId, options) {
+    const { enabled } = options;
+    const { data: user } = useUser();
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [state, setState] = useState({
+        status: 'idle',
+        aliases: [],
+        signInEmail: null,
+        error: null
+    });
+    const [busy, setBusy] = useState(false);
+    const request = useCallback(async (method, body)=>{
+        const url = method === 'GET' ? `${MEMBER_EMAIL_ALIASES_ROUTE}?orgId=${encodeURIComponent(orgId != null ? orgId : '')}` : MEMBER_EMAIL_ALIASES_ROUTE;
+        const response = await authorizedFetch(userRef.current, url, _extends({
+            method
+        }, body ? {
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(body)
+        } : {}));
+        const payload = await response.json().catch(()=>({}));
+        return {
+            response,
+            payload
+        };
+    }, [
+        orgId
+    ]);
+    const load = useCallback(async ()=>{
+        if (!orgId) return;
+        try {
+            const { response, payload } = await request('GET');
+            if (!response.ok) {
+                setState((prior)=>{
+                    var _payload_error;
+                    return _extends({}, prior, {
+                        status: 'error',
+                        error: String((_payload_error = payload['error']) != null ? _payload_error : LOAD_FAILED)
+                    });
+                });
+                return;
+            }
+            setState({
+                status: 'ready',
+                aliases: Array.isArray(payload['aliases']) ? payload['aliases'] : [],
+                signInEmail: typeof payload['signInEmail'] === 'string' ? payload['signInEmail'] : null,
+                error: null
+            });
+        } catch (cause) {
+            console.error(cause);
+            setState((prior)=>_extends({}, prior, {
+                    status: 'error',
+                    error: LOAD_FAILED
+                }));
+        }
+    }, [
+        orgId,
+        request
+    ]);
+    useEffect(()=>{
+        if (!enabled || !orgId) return;
+        setState((prior)=>_extends({}, prior, {
+                status: prior.status === 'ready' ? 'ready' : 'loading'
+            }));
+        void load();
+    }, [
+        enabled,
+        orgId,
+        load
+    ]);
+    const change = useCallback(async (method, body)=>{
+        setBusy(true);
+        try {
+            const { response, payload } = await request(method, body);
+            // A refused change and an accepted one both move the stored list —
+            // an add whose email could not leave is still on it.
+            await load();
+            if (!response.ok && payload['ok'] !== true) {
+                var _payload_error;
+                return {
+                    ok: false,
+                    error: String((_payload_error = payload['error']) != null ? _payload_error : CHANGE_FAILED)
+                };
+            }
+            if (payload['sent'] === false) {
+                var _payload_error1;
+                return {
+                    ok: false,
+                    error: String((_payload_error1 = payload['error']) != null ? _payload_error1 : CHANGE_FAILED)
+                };
+            }
+            return {
+                ok: true,
+                payload
+            };
+        } catch (cause) {
+            console.error(cause);
+            return {
+                ok: false,
+                error: CHANGE_FAILED
+            };
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        request,
+        load
+    ]);
+    const returnPath = ()=>typeof window === 'undefined' ? '/' : window.location.pathname;
+    const add = useCallback((address)=>change('POST', {
+            orgId,
+            action: 'add',
+            address,
+            returnPath: returnPath()
+        }), [
+        change,
+        orgId
+    ]);
+    const resend = useCallback((address)=>change('POST', {
+            orgId,
+            action: 'resend',
+            address,
+            returnPath: returnPath()
+        }), [
+        change,
+        orgId
+    ]);
+    const remove = useCallback((address)=>change('DELETE', {
+            orgId,
+            address
+        }), [
+        change,
+        orgId
+    ]);
+    const confirm = useCallback((token)=>change('POST', {
+            action: 'confirm',
+            token
+        }), [
+        change
+    ]);
+    return _extends({}, state, {
+        busy,
+        add,
+        resend,
+        remove,
+        confirm
+    });
+}
+export default useMemberEmailAliases;
+
+//# sourceMappingURL=use-member-email-aliases.js.map

package/src/lib/components/use-member-email-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-member-email-aliases.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\n'use client'\n\nimport {\n  MEMBER_EMAIL_ALIASES_ROUTE,\n  type MemberEmailAliasRow,\n} from '@aglyn/aglyn/app-utils/member-email-aliases'\nimport {\n  authorizedFetch,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\n/** What one change answered: done, with what the route said, or refused and why. */\nexport type MemberEmailAliasChange =\n  | { ok: true; payload: Record<string, any> }\n  | { ok: false; error: string }\n\nexport interface MemberEmailAliases {\n  status: 'idle' | 'loading' | 'ready' | 'error'\n  aliases: MemberEmailAliasRow[]\n  /** The address the member signs in with, which already counts as theirs. */\n  signInEmail: string | null\n  error: string | null\n  /** True while a change is in flight. */\n  busy: boolean\n  add: (address: string) => Promise<MemberEmailAliasChange>\n  resend: (address: string) => Promise<MemberEmailAliasChange>\n  remove: (address: string) => Promise<MemberEmailAliasChange>\n  /** Confirms the address a link was sent for; the token names the workspace. */\n  confirm: (token: string) => Promise<MemberEmailAliasChange>\n}\n\nconst LOAD_FAILED = 'Your addresses could not be loaded.'\nconst CHANGE_FAILED = 'That change could not be made.'\n\n/**\n * The signed-in member's own addresses in one workspace (AGL-2975), from\n * the core route every surface shares. A list the member keeps for\n * themselves, so it is read through the route rather than a listener: the\n * rules close the collection to every client.\n *\n * Every change re-reads the list, so a row's state is always the stored\n * one — an add that could not send its email still shows the address,\n * waiting, with a way to send again. The page the member is on rides along\n * as the path the confirmation link should land on.\n */\nexport function useMemberEmailAliases(\n  orgId: string | null,\n  options: { enabled: boolean },\n): MemberEmailAliases {\n  const { enabled } = options\n  const { data: user } = useUser()\n  const userRef = useRef(user)\n  userRef.current = user\n  const [state, setState] = useState<\n    Pick<MemberEmailAliases, 'status' | 'aliases' | 'signInEmail' | 'error'>\n  >({ status: 'idle', aliases: [], signInEmail: null, error: null })\n  const [busy, setBusy] = useState(false)\n\n  const request = useCallback(\n    async (method: 'GET' | 'POST' | 'DELETE', body?: Record<string, unknown>) => {\n      const url =\n        method === 'GET'\n          ? `${MEMBER_EMAIL_ALIASES_ROUTE}?orgId=${encodeURIComponent(orgId ?? '')}`\n          : MEMBER_EMAIL_ALIASES_ROUTE\n      const response = await authorizedFetch(\n        userRef.current as TokenSource | null | undefined,\n        url,\n        {\n          method,\n          ...(body\n            ? { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }\n            : {}),\n        },\n      )\n      const payload = (await response.json().catch(() => ({}))) as Record<string, any>\n      return { response, payload }\n    },\n    [orgId],\n  )\n\n  const load = useCallback(async () => {\n    if (!orgId) return\n    try {\n      const { response, payload } = await request('GET')\n      if (!response.ok) {\n        setState((prior) => ({ ...prior, status: 'error', error: String(payload['error'] ?? LOAD_FAILED) }))\n        return\n      }\n      setState({\n        status: 'ready',\n        aliases: Array.isArray(payload['aliases']) ? (payload['aliases'] as MemberEmailAliasRow[]) : [],\n        signInEmail: typeof payload['signInEmail'] === 'string' ? payload['signInEmail'] : null,\n        error: null,\n      })\n    } catch (cause) {\n      console.error(cause)\n      setState((prior) => ({ ...prior, status: 'error', error: LOAD_FAILED }))\n    }\n  }, [orgId, request])\n\n  useEffect(() => {\n    if (!enabled || !orgId) return\n    setState((prior) => ({ ...prior, status: prior.status === 'ready' ? 'ready' : 'loading' }))\n    void load()\n  }, [enabled, orgId, load])\n\n  const change = useCallback(\n    async (\n      method: 'POST' | 'DELETE',\n      body: Record<string, unknown>,\n    ): Promise<MemberEmailAliasChange> => {\n      setBusy(true)\n      try {\n        const { response, payload } = await request(method, body)\n        // A refused change and an accepted one both move the stored list —\n        // an add whose email could not leave is still on it.\n        await load()\n        if (!response.ok && payload['ok'] !== true) {\n          return { ok: false, error: String(payload['error'] ?? CHANGE_FAILED) }\n        }\n        if (payload['sent'] === false) {\n          return { ok: false, error: String(payload['error'] ?? CHANGE_FAILED) }\n        }\n        return { ok: true, payload }\n      } catch (cause) {\n        console.error(cause)\n        return { ok: false, error: CHANGE_FAILED }\n      } finally {\n        setBusy(false)\n      }\n    },\n    [request, load],\n  )\n\n  const returnPath = () => (typeof window === 'undefined' ? '/' : window.location.pathname)\n\n  const add = useCallback(\n    (address: string) => change('POST', { orgId, action: 'add', address, returnPath: returnPath() }),\n    [change, orgId],\n  )\n  const resend = useCallback(\n    (address: string) => change('POST', { orgId, action: 'resend', address, returnPath: returnPath() }),\n    [change, orgId],\n  )\n  const remove = useCallback(\n    (address: string) => change('DELETE', { orgId, address }),\n    [change, orgId],\n  )\n  const confirm = useCallback(\n    (token: string) => change('POST', { action: 'confirm', token }),\n    [change],\n  )\n\n  return { ...state, busy, add, resend, remove, confirm }\n}\n\nexport default useMemberEmailAliases\n"],"names":["MEMBER_EMAIL_ALIASES_ROUTE","authorizedFetch","useUser","useCallback","useEffect","useRef","useState","LOAD_FAILED","CHANGE_FAILED","useMemberEmailAliases","orgId","options","enabled","data","user","userRef","current","state","setState","status","aliases","signInEmail","error","busy","setBusy","request","method","body","url","encodeURIComponent","response","headers","JSON","stringify","payload","json","catch","load","ok","prior","String","Array","isArray","cause","console","change","returnPath","window","location","pathname","add","address","action","resend","remove","confirm","token"],"mappings":"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"}

package/src/lib/components/use-org-members.d.ts

@@ -0,0 +1,40 @@
+import { type CrmMemberOption } from '@aglyn/aglyn';
+/** One team member, as an owner picker lists them. */
+export type OrgMemberOption = CrmMemberOption;
+export interface OrgMembers {
+    /** Every member of the workspace, by name. */
+    options: OrgMemberOption[];
+    /** The roster has answered — an empty list is then a real answer. */
+    ready: boolean;
+    /**
+     * The name to show for a stored reference — a uid, or an address the
+     * roster has — or the reference itself when the roster does not know it.
+     */
+    memberName: (ref: string) => string;
+    /**
+     * The member's ADDRESS for a stored reference — what a CSV export writes
+     * in the owner column, because the import resolves an owner by email —
+     * falling back to the name and then to the reference itself.
+     */
+    memberEmail: (ref: string) => string;
+}
+/**
+ * THE WORKSPACE'S ROSTER, for picking and naming a contact's owner
+ * (AGL-2596).
+ *
+ * Read through `/api/orgs/members`, not from Firestore: the roster is
+ * evaluated against the QUERY by the rules, and a scoped member's read of
+ * `orgs/{orgId}/members` is refused for exactly the shape the owner picker
+ * needs — every row. The route re-derives membership with the Admin SDK and
+ * answers any member of the org, which is who may see who else is on the
+ * team.
+ *
+ * Read only when ASKED — `enabled` — and once per workspace for the life of
+ * the mount. The list of contacts does not need the roster until a row
+ * carries an owner or the create drawer opens, and a request per mount of a
+ * page that may never show a name is a read paid for nothing.
+ */
+export declare function useOrgMembers(orgId: string | null | undefined, options?: {
+    enabled?: boolean;
+}): OrgMembers;
+export default useOrgMembers;

package/src/lib/components/use-org-members.js

@@ -0,0 +1,100 @@
+/**
+ * @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 { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { crmMemberOption, findOrgMember } from "@aglyn/aglyn";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+/**
+ * THE WORKSPACE'S ROSTER, for picking and naming a contact's owner
+ * (AGL-2596).
+ *
+ * Read through `/api/orgs/members`, not from Firestore: the roster is
+ * evaluated against the QUERY by the rules, and a scoped member's read of
+ * `orgs/{orgId}/members` is refused for exactly the shape the owner picker
+ * needs — every row. The route re-derives membership with the Admin SDK and
+ * answers any member of the org, which is who may see who else is on the
+ * team.
+ *
+ * Read only when ASKED — `enabled` — and once per workspace for the life of
+ * the mount. The list of contacts does not need the roster until a row
+ * carries an owner or the create drawer opens, and a request per mount of a
+ * page that may never show a name is a read paid for nothing.
+ */ export function useOrgMembers(orgId, options = {}) {
+    var _options_enabled, _ref;
+    const enabled = (_options_enabled = options.enabled) != null ? _options_enabled : false;
+    const { data: user } = useUser();
+    const userRef = useRef(user);
+    userRef.current = user;
+    const [loaded, setLoaded] = useState(null);
+    const loadedOrgId = (_ref = loaded == null ? void 0 : loaded.orgId) != null ? _ref : null;
+    useEffect(()=>{
+        if (!enabled || !orgId || loadedOrgId === orgId) return undefined;
+        let active = true;
+        void authorizedFetch(userRef.current, `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`).then(async (response)=>response.ok ? await response.json() : {}).then((json)=>{
+            if (!active) return;
+            const members = Array.isArray(json == null ? void 0 : json.members) ? json.members : [];
+            setLoaded({
+                orgId,
+                options: members.map((member)=>crmMemberOption(member != null ? member : {})).filter((option)=>option !== null).sort((a, b)=>a.label.localeCompare(b.label))
+            });
+        }).catch(()=>{
+            // An unanswered roster is an EMPTY picker, not a broken page: the
+            // owner column falls back to the uid, and the picker says it has
+            // nobody to offer.
+            if (active) setLoaded({
+                orgId,
+                options: []
+            });
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        enabled,
+        orgId,
+        loadedOrgId
+    ]);
+    const current = loaded && loaded.orgId === orgId ? loaded : null;
+    const roster = useMemo(()=>{
+        var _ref;
+        return (_ref = current == null ? void 0 : current.options) != null ? _ref : [];
+    }, [
+        current
+    ]);
+    const memberName = useCallback((ref)=>{
+        var _ref;
+        var _findOrgMember;
+        return (_ref = (_findOrgMember = findOrgMember(roster, ref)) == null ? void 0 : _findOrgMember.label) != null ? _ref : ref;
+    }, [
+        roster
+    ]);
+    const memberEmail = useCallback((ref)=>{
+        const member = findOrgMember(roster, ref);
+        return (member == null ? void 0 : member.email) || (member == null ? void 0 : member.label) || ref;
+    }, [
+        roster
+    ]);
+    return {
+        options: roster,
+        ready: current !== null,
+        memberName,
+        memberEmail
+    };
+}
+export default useOrgMembers;
+
+//# sourceMappingURL=use-org-members.js.map

package/src/lib/components/use-org-members.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-org-members.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  authorizedFetch,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { type CrmMemberOption, crmMemberOption, findOrgMember } from '@aglyn/aglyn'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\n\n/** One team member, as an owner picker lists them. */\nexport type OrgMemberOption = CrmMemberOption\n\nexport interface OrgMembers {\n  /** Every member of the workspace, by name. */\n  options: OrgMemberOption[]\n  /** The roster has answered — an empty list is then a real answer. */\n  ready: boolean\n  /**\n   * The name to show for a stored reference — a uid, or an address the\n   * roster has — or the reference itself when the roster does not know it.\n   */\n  memberName: (ref: string) => string\n  /**\n   * The member's ADDRESS for a stored reference — what a CSV export writes\n   * in the owner column, because the import resolves an owner by email —\n   * falling back to the name and then to the reference itself.\n   */\n  memberEmail: (ref: string) => string\n}\n\n/**\n * THE WORKSPACE'S ROSTER, for picking and naming a contact's owner\n * (AGL-2596).\n *\n * Read through `/api/orgs/members`, not from Firestore: the roster is\n * evaluated against the QUERY by the rules, and a scoped member's read of\n * `orgs/{orgId}/members` is refused for exactly the shape the owner picker\n * needs — every row. The route re-derives membership with the Admin SDK and\n * answers any member of the org, which is who may see who else is on the\n * team.\n *\n * Read only when ASKED — `enabled` — and once per workspace for the life of\n * the mount. The list of contacts does not need the roster until a row\n * carries an owner or the create drawer opens, and a request per mount of a\n * page that may never show a name is a read paid for nothing.\n */\nexport function useOrgMembers(\n  orgId: string | null | undefined,\n  options: { enabled?: boolean } = {},\n): OrgMembers {\n  const enabled = options.enabled ?? false\n  const { data: user } = useUser()\n  const userRef = useRef(user)\n  userRef.current = user\n  const [loaded, setLoaded] = useState<{\n    orgId: string\n    options: OrgMemberOption[]\n  } | null>(null)\n  const loadedOrgId = loaded?.orgId ?? null\n\n  useEffect(() => {\n    if (!enabled || !orgId || loadedOrgId === orgId) return undefined\n    let active = true\n    void authorizedFetch(\n      userRef.current as TokenSource | null | undefined,\n      `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`,\n    )\n      .then(async (response) =>\n        response.ok ? ((await response.json()) as { members?: unknown[] }) : {},\n      )\n      .then((json) => {\n        if (!active) return\n        const members = Array.isArray(json?.members) ? json.members : []\n        setLoaded({\n          orgId,\n          options: members\n            .map((member) => crmMemberOption((member ?? {}) as Record<string, unknown>))\n            .filter((option): option is OrgMemberOption => option !== null)\n            .sort((a, b) => a.label.localeCompare(b.label)),\n        })\n      })\n      .catch(() => {\n        // An unanswered roster is an EMPTY picker, not a broken page: the\n        // owner column falls back to the uid, and the picker says it has\n        // nobody to offer.\n        if (active) setLoaded({ orgId, options: [] })\n      })\n    return () => {\n      active = false\n    }\n  }, [enabled, orgId, loadedOrgId])\n\n  const current = loaded && loaded.orgId === orgId ? loaded : null\n  const roster = useMemo(() => current?.options ?? [], [current])\n  const memberName = useCallback(\n    (ref: string) => findOrgMember(roster, ref)?.label ?? ref,\n    [roster],\n  )\n  const memberEmail = useCallback(\n    (ref: string) => {\n      const member = findOrgMember(roster, ref)\n      return member?.email || member?.label || ref\n    },\n    [roster],\n  )\n  return {\n    options: roster,\n    ready: current !== null,\n    memberName,\n    memberEmail,\n  }\n}\n\nexport default useOrgMembers\n"],"names":["authorizedFetch","crmMemberOption","findOrgMember","useUser","useCallback","useEffect","useMemo","useRef","useState","useOrgMembers","orgId","options","enabled","data","user","userRef","current","loaded","setLoaded","loadedOrgId","undefined","active","encodeURIComponent","then","response","ok","json","members","Array","isArray","map","member","filter","option","sort","a","b","label","localeCompare","catch","roster","memberName","ref","memberEmail","email","ready"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SACEA,eAAe,QAEV,2CAA0C;AACjD,SAA+BC,eAAe,EAAEC,aAAa,QAAQ,eAAc;AACnF,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAuBzE;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASC,cACdC,KAAgC,EAChCC,UAAiC,CAAC,CAAC;QAEnBA;IAAhB,MAAMC,WAAUD,mBAAAA,QAAQC,OAAO,YAAfD,mBAAmB;IACnC,MAAM,EAAEE,MAAMC,IAAI,EAAE,GAAGX;IACvB,MAAMY,UAAUR,OAAOO;IACvBC,QAAQC,OAAO,GAAGF;IAClB,MAAM,CAACG,QAAQC,UAAU,GAAGV,SAGlB;IACV,MAAMW,sBAAcF,0BAAAA,OAAQP,KAAK,mBAAI;IAErCL,UAAU;QACR,IAAI,CAACO,WAAW,CAACF,SAASS,gBAAgBT,OAAO,OAAOU;QACxD,IAAIC,SAAS;QACb,KAAKrB,gBACHe,QAAQC,OAAO,EACf,CAAC,wBAAwB,EAAEM,mBAAmBZ,QAAQ,EAErDa,IAAI,CAAC,OAAOC,WACXA,SAASC,EAAE,GAAK,MAAMD,SAASE,IAAI,KAAkC,CAAC,GAEvEH,IAAI,CAAC,CAACG;YACL,IAAI,CAACL,QAAQ;YACb,MAAMM,UAAUC,MAAMC,OAAO,CAACH,wBAAAA,KAAMC,OAAO,IAAID,KAAKC,OAAO,GAAG,EAAE;YAChET,UAAU;gBACRR;gBACAC,SAASgB,QACNG,GAAG,CAAC,CAACC,SAAW9B,gBAAiB8B,iBAAAA,SAAU,CAAC,IAC5CC,MAAM,CAAC,CAACC,SAAsCA,WAAW,MACzDC,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAEE,KAAK,CAACC,aAAa,CAACF,EAAEC,KAAK;YACjD;QACF,GACCE,KAAK,CAAC;YACL,kEAAkE;YAClE,iEAAiE;YACjE,mBAAmB;YACnB,IAAIlB,QAAQH,UAAU;gBAAER;gBAAOC,SAAS,EAAE;YAAC;QAC7C;QACF,OAAO;YACLU,SAAS;QACX;IACF,GAAG;QAACT;QAASF;QAAOS;KAAY;IAEhC,MAAMH,UAAUC,UAAUA,OAAOP,KAAK,KAAKA,QAAQO,SAAS;IAC5D,MAAMuB,SAASlC,QAAQ;;uBAAMU,2BAAAA,QAASL,OAAO,mBAAI,EAAE;OAAE;QAACK;KAAQ;IAC9D,MAAMyB,aAAarC,YACjB,CAACsC;;YAAgBxC;wBAAAA,iBAAAA,cAAcsC,QAAQE,yBAAtBxC,eAA4BmC,KAAK,mBAAIK;OACtD;QAACF;KAAO;IAEV,MAAMG,cAAcvC,YAClB,CAACsC;QACC,MAAMX,SAAS7B,cAAcsC,QAAQE;QACrC,OAAOX,CAAAA,0BAAAA,OAAQa,KAAK,MAAIb,0BAAAA,OAAQM,KAAK,KAAIK;IAC3C,GACA;QAACF;KAAO;IAEV,OAAO;QACL7B,SAAS6B;QACTK,OAAO7B,YAAY;QACnByB;QACAE;IACF;AACF;AAEA,eAAelC,cAAa"}

package/src/lib/constants/api-routes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @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 type { CrmActionRecipeId } from '@aglyn/aglyn';
+/**
+ * The CRM plugin's console API routes, as the dispatcher keys them.
+ *
+ * One file both halves import, because the server registers the path and
+ * the client fetches it, and a route spelled twice is a route that 404s
+ * the day one spelling changes. Client-safe: constants only.
+ */
+export declare const CRM_API_ROUTES: {
+    readonly ping: "crm/ping";
+    /**
+     * `POST` — moves one contact to a lifecycle stage, or clears it; see
+     * `server.ts`.
+     */
+    readonly contactStage: "crm/contact-stage";
+    /**
+     * `POST` — one holder's profile fields on one or more contacts (AGL-2804):
+     * every facet write the console makes; see `server/contact-update.ts`.
+     */
+    readonly contactUpdate: "crm/contact-update";
+    /**
+     * `POST` — unlinks the contacts that name a company, then deletes it
+     * (AGL-2804); see `server/company-delete.ts`.
+     */
+    readonly companyDelete: "crm/company-delete";
+    /** `POST` — one email to one person from a record; see `server/email-send.ts`. */
+    readonly emailSend: "crm/email-send";
+    /**
+     * `POST` — one line in the ORGANIZATION's activity feed for an act the
+     * org-level hub performed client-direct (AGL-2634); see
+     * `server/org-activity.ts`.
+     */
+    readonly orgActivity: "crm/org-activity";
+    /**
+     * `POST` — installs one recipe's action on one site (AGL-2639): the
+     * server builds it, stamps it and writes it into the site's actions;
+     * see `server/recipe-routes.ts`.
+     */
+    readonly recipeInstall: "crm/recipe-install";
+    /**
+     * `POST` — which recipes each of the organization's sites carries
+     * (AGL-2639), read off the stamps; see `server/recipe-routes.ts`.
+     */
+    readonly recipeStatus: "crm/recipe-status";
+    /**
+     * `POST` — the workspace's email capture address (AGL-2657), minted on
+     * the first ask and replaced with `rotate: true`; see
+     * `server/inbound-address.ts`.
+     */
+    readonly inboundAddress: "crm/inbound-address";
+};
+/**
+ * One site's answer to `crm/recipe-status` (AGL-2639).
+ *
+ * `installed` names the recipes a live action on the site is stamped with.
+ * `unstamped` counts the live actions that carry NO stamp — every action
+ * saved before the stamp existed — and a site with any is one the reader
+ * cannot call free of a recipe: the card names it as "may already have
+ * it" rather than offering the install as if to a blank site.
+ */
+export interface CrmRecipeSiteStatus {
+    hostId: string;
+    installed: CrmActionRecipeId[];
+    unstamped: number;
+}
+/** The body `crm/recipe-install` reads, beside the route scope. */
+export interface CrmRecipeInstallRequest {
+    hostId: string;
+    orgId?: string;
+    recipeId: CrmActionRecipeId;
+    /** The site's form a recipe that `needs: 'form'` is keyed on. */
+    formId?: string;
+}
+/** What a successful `crm/recipe-install` answers with. */
+export interface CrmRecipeInstallResult {
+    ok: true;
+    actionId: string;
+    /** The installed action's name, as the site's Actions list will show it. */
+    name: string;
+    recipeId: CrmActionRecipeId;
+}
+/**
+ * What an organization-level activity line may point at: the CRM's record
+ * kinds, and nothing the org feed holds for its own reasons (a member, a
+ * subscription). The route refuses any other type, so a bulk bar cannot
+ * write a line the feed's presenter would render as a workspace event.
+ */
+export declare const CRM_ORG_ACTIVITY_KINDS: readonly ["contact", "company", "deal", "lead", "task"];
+export type CrmOrgActivityKind = (typeof CRM_ORG_ACTIVITY_KINDS)[number];
+/** The most an activity line may say — a sentence, not a report. */
+export declare const CRM_ORG_ACTIVITY_ACTION_MAX = 160;
+/** The browser-side URL for a route key. */
+export declare function crmApiUrl(route: keyof typeof CRM_API_ROUTES): string;

package/src/lib/constants/api-routes.js

@@ -0,0 +1,74 @@
+/**
+ * @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 plugin's console API routes, as the dispatcher keys them.
+ *
+ * One file both halves import, because the server registers the path and
+ * the client fetches it, and a route spelled twice is a route that 404s
+ * the day one spelling changes. Client-safe: constants only.
+ */ export const CRM_API_ROUTES = {
+    ping: 'crm/ping',
+    /**
+   * `POST` — moves one contact to a lifecycle stage, or clears it; see
+   * `server.ts`.
+   */ contactStage: 'crm/contact-stage',
+    /**
+   * `POST` — one holder's profile fields on one or more contacts (AGL-2804):
+   * every facet write the console makes; see `server/contact-update.ts`.
+   */ contactUpdate: 'crm/contact-update',
+    /**
+   * `POST` — unlinks the contacts that name a company, then deletes it
+   * (AGL-2804); see `server/company-delete.ts`.
+   */ companyDelete: 'crm/company-delete',
+    /** `POST` — one email to one person from a record; see `server/email-send.ts`. */ emailSend: 'crm/email-send',
+    /**
+   * `POST` — one line in the ORGANIZATION's activity feed for an act the
+   * org-level hub performed client-direct (AGL-2634); see
+   * `server/org-activity.ts`.
+   */ orgActivity: 'crm/org-activity',
+    /**
+   * `POST` — installs one recipe's action on one site (AGL-2639): the
+   * server builds it, stamps it and writes it into the site's actions;
+   * see `server/recipe-routes.ts`.
+   */ recipeInstall: 'crm/recipe-install',
+    /**
+   * `POST` — which recipes each of the organization's sites carries
+   * (AGL-2639), read off the stamps; see `server/recipe-routes.ts`.
+   */ recipeStatus: 'crm/recipe-status',
+    /**
+   * `POST` — the workspace's email capture address (AGL-2657), minted on
+   * the first ask and replaced with `rotate: true`; see
+   * `server/inbound-address.ts`.
+   */ inboundAddress: 'crm/inbound-address'
+};
+/**
+ * What an organization-level activity line may point at: the CRM's record
+ * kinds, and nothing the org feed holds for its own reasons (a member, a
+ * subscription). The route refuses any other type, so a bulk bar cannot
+ * write a line the feed's presenter would render as a workspace event.
+ */ export const CRM_ORG_ACTIVITY_KINDS = [
+    'contact',
+    'company',
+    'deal',
+    'lead',
+    'task'
+];
+/** The most an activity line may say — a sentence, not a report. */ export const CRM_ORG_ACTIVITY_ACTION_MAX = 160;
+/** The browser-side URL for a route key. */ export function crmApiUrl(route) {
+    return `/api/${CRM_API_ROUTES[route]}`;
+}
+
+//# sourceMappingURL=api-routes.js.map

package/src/lib/constants/api-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/constants/api-routes.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 type { CrmActionRecipeId } from '@aglyn/aglyn'\n\n/**\n * The CRM plugin's console API routes, as the dispatcher keys them.\n *\n * One file both halves import, because the server registers the path and\n * the client fetches it, and a route spelled twice is a route that 404s\n * the day one spelling changes. Client-safe: constants only.\n */\nexport const CRM_API_ROUTES = {\n  ping: 'crm/ping',\n  /**\n   * `POST` — moves one contact to a lifecycle stage, or clears it; see\n   * `server.ts`.\n   */\n  contactStage: 'crm/contact-stage',\n  /**\n   * `POST` — one holder's profile fields on one or more contacts (AGL-2804):\n   * every facet write the console makes; see `server/contact-update.ts`.\n   */\n  contactUpdate: 'crm/contact-update',\n  /**\n   * `POST` — unlinks the contacts that name a company, then deletes it\n   * (AGL-2804); see `server/company-delete.ts`.\n   */\n  companyDelete: 'crm/company-delete',\n  /** `POST` — one email to one person from a record; see `server/email-send.ts`. */\n  emailSend: 'crm/email-send',\n  /**\n   * `POST` — one line in the ORGANIZATION's activity feed for an act the\n   * org-level hub performed client-direct (AGL-2634); see\n   * `server/org-activity.ts`.\n   */\n  orgActivity: 'crm/org-activity',\n  /**\n   * `POST` — installs one recipe's action on one site (AGL-2639): the\n   * server builds it, stamps it and writes it into the site's actions;\n   * see `server/recipe-routes.ts`.\n   */\n  recipeInstall: 'crm/recipe-install',\n  /**\n   * `POST` — which recipes each of the organization's sites carries\n   * (AGL-2639), read off the stamps; see `server/recipe-routes.ts`.\n   */\n  recipeStatus: 'crm/recipe-status',\n  /**\n   * `POST` — the workspace's email capture address (AGL-2657), minted on\n   * the first ask and replaced with `rotate: true`; see\n   * `server/inbound-address.ts`.\n   */\n  inboundAddress: 'crm/inbound-address',\n} as const\n\n/**\n * One site's answer to `crm/recipe-status` (AGL-2639).\n *\n * `installed` names the recipes a live action on the site is stamped with.\n * `unstamped` counts the live actions that carry NO stamp — every action\n * saved before the stamp existed — and a site with any is one the reader\n * cannot call free of a recipe: the card names it as \"may already have\n * it\" rather than offering the install as if to a blank site.\n */\nexport interface CrmRecipeSiteStatus {\n  hostId: string\n  installed: CrmActionRecipeId[]\n  unstamped: number\n}\n\n/** The body `crm/recipe-install` reads, beside the route scope. */\nexport interface CrmRecipeInstallRequest {\n  hostId: string\n  orgId?: string\n  recipeId: CrmActionRecipeId\n  /** The site's form a recipe that `needs: 'form'` is keyed on. */\n  formId?: string\n}\n\n/** What a successful `crm/recipe-install` answers with. */\nexport interface CrmRecipeInstallResult {\n  ok: true\n  actionId: string\n  /** The installed action's name, as the site's Actions list will show it. */\n  name: string\n  recipeId: CrmActionRecipeId\n}\n\n/**\n * What an organization-level activity line may point at: the CRM's record\n * kinds, and nothing the org feed holds for its own reasons (a member, a\n * subscription). The route refuses any other type, so a bulk bar cannot\n * write a line the feed's presenter would render as a workspace event.\n */\nexport const CRM_ORG_ACTIVITY_KINDS = [\n  'contact',\n  'company',\n  'deal',\n  'lead',\n  'task',\n] as const\n\nexport type CrmOrgActivityKind = (typeof CRM_ORG_ACTIVITY_KINDS)[number]\n\n/** The most an activity line may say — a sentence, not a report. */\nexport const CRM_ORG_ACTIVITY_ACTION_MAX = 160\n\n/** The browser-side URL for a route key. */\nexport function crmApiUrl(route: keyof typeof CRM_API_ROUTES): string {\n  return `/api/${CRM_API_ROUTES[route]}`\n}\n"],"names":["CRM_API_ROUTES","ping","contactStage","contactUpdate","companyDelete","emailSend","orgActivity","recipeInstall","recipeStatus","inboundAddress","CRM_ORG_ACTIVITY_KINDS","CRM_ORG_ACTIVITY_ACTION_MAX","crmApiUrl","route"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;CAMC,GACD,OAAO,MAAMA,iBAAiB;IAC5BC,MAAM;IACN;;;GAGC,GACDC,cAAc;IACd;;;GAGC,GACDC,eAAe;IACf;;;GAGC,GACDC,eAAe;IACf,gFAAgF,GAChFC,WAAW;IACX;;;;GAIC,GACDC,aAAa;IACb;;;;GAIC,GACDC,eAAe;IACf;;;GAGC,GACDC,cAAc;IACd;;;;GAIC,GACDC,gBAAgB;AAClB,EAAU;AAmCV;;;;;CAKC,GACD,OAAO,MAAMC,yBAAyB;IACpC;IACA;IACA;IACA;IACA;CACD,CAAS;AAIV,kEAAkE,GAClE,OAAO,MAAMC,8BAA8B,IAAG;AAE9C,0CAA0C,GAC1C,OAAO,SAASC,UAAUC,KAAkC;IAC1D,OAAO,CAAC,KAAK,EAAEb,cAAc,CAACa,MAAM,EAAE;AACxC"}

package/src/lib/constants/bundle-common.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @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.
+ */
+/**
+ * The persisted plugin id (AGL-2595). It was `contacts` while the surface was
+ * one list; the stored lists were rewritten and the plugin manager's alias for
+ * the old value was retired once that backfill reported nothing left
+ * (AGL-2614), so `contacts` now reads as an unknown id like any other.
+ */
+export declare const BUNDLE_ID = "crm";