@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/hooks/use-org-member-directory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 CrmMemberOption } from '@aglyn/aglyn';
+/** One person a task can be assigned to. */
+export interface OrgMemberOption extends CrmMemberOption {
+    role: string;
+}
+/** Test seam. */
+export declare function resetOrgMemberDirectoryCache(): void;
+export interface OrgMemberDirectory {
+    members: OrgMemberOption[];
+    /** The read has not settled — the picker disables rather than offers nobody. */
+    loading: boolean;
+    /** Why the roster could not be read, when it could not. */
+    error: string | null;
+    /**
+     * A stored reference — a uid, or an address the roster has — as a person,
+     * or the reference itself for someone no longer on the roster.
+     */
+    nameOf: (ref: string | null | undefined) => string;
+}
+export declare function useOrgMemberDirectory(orgId: string | null | undefined): OrgMemberDirectory;

package/src/lib/hooks/use-org-member-directory.js

@@ -0,0 +1,116 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { crmMemberOption, findOrgMember } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useState } from "react";
+/**
+ * The org's roster, read once per org per page and shared by every mount.
+ *
+ * The roster is what the assignee picker offers and what the assignee
+ * column prints — a uid is not a name anybody recognizes. It comes from
+ * `GET /api/orgs/members`, which re-derives membership with the Admin SDK
+ * (the client-side rules cannot evaluate a list query against the member's
+ * own-document clause, so a direct read is refused for the very people who
+ * may assign tasks). A roster changes on the order of days; the promise is
+ * kept so a second card on the same page shares the request rather than
+ * repeating it.
+ */ const rosterCache = new Map();
+/** Test seam. */ export function resetOrgMemberDirectoryCache() {
+    rosterCache.clear();
+}
+function memberOption(member) {
+    var _member_role;
+    const option = crmMemberOption(member);
+    return option ? _extends({}, option, {
+        role: String((_member_role = member['role']) != null ? _member_role : '')
+    }) : null;
+}
+export function useOrgMemberDirectory(orgId) {
+    const { data: user } = useUser();
+    const [state, setState] = useState({
+        orgId: null,
+        members: [],
+        loading: false,
+        error: null
+    });
+    useEffect(()=>{
+        if (!orgId || !user) return;
+        let active = true;
+        let roster = rosterCache.get(orgId);
+        if (!roster) {
+            roster = authorizedFetch(user, `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`).then(async (response)=>{
+                var _payload_members;
+                const payload = await response.json().catch(()=>({}));
+                if (!response.ok) {
+                    throw new Error(payload.error || 'The team could not be loaded.');
+                }
+                return ((_payload_members = payload.members) != null ? _payload_members : []).map(memberOption).filter((member)=>member !== null).sort((a, b)=>a.label.localeCompare(b.label));
+            });
+            rosterCache.set(orgId, roster);
+            // A failed read is not kept: the next mount asks again rather than
+            // remembering an outage for the life of the page.
+            roster.catch(()=>rosterCache.delete(orgId));
+        }
+        setState({
+            orgId,
+            members: [],
+            loading: true,
+            error: null
+        });
+        roster.then((members)=>{
+            if (active) setState({
+                orgId,
+                members,
+                loading: false,
+                error: null
+            });
+        }, (error)=>{
+            if (active) {
+                setState({
+                    orgId,
+                    members: [],
+                    loading: false,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        user
+    ]);
+    const members = state.orgId === orgId ? state.members : [];
+    const nameOf = useCallback((ref)=>{
+        var _ref;
+        var _findOrgMember;
+        if (!ref) return '';
+        return (_ref = (_findOrgMember = findOrgMember(members, ref)) == null ? void 0 : _findOrgMember.label) != null ? _ref : ref;
+    }, [
+        members
+    ]);
+    return {
+        members,
+        loading: Boolean(orgId) && (state.orgId !== orgId || state.loading),
+        error: state.orgId === orgId ? state.error : null,
+        nameOf
+    };
+}
+
+//# sourceMappingURL=use-org-member-directory.js.map

package/src/lib/hooks/use-org-member-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-org-member-directory.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 CrmMemberOption, crmMemberOption, findOrgMember } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useState } from 'react'\n\n/** One person a task can be assigned to. */\nexport interface OrgMemberOption extends CrmMemberOption {\n  role: string\n}\n\n/**\n * The org's roster, read once per org per page and shared by every mount.\n *\n * The roster is what the assignee picker offers and what the assignee\n * column prints — a uid is not a name anybody recognizes. It comes from\n * `GET /api/orgs/members`, which re-derives membership with the Admin SDK\n * (the client-side rules cannot evaluate a list query against the member's\n * own-document clause, so a direct read is refused for the very people who\n * may assign tasks). A roster changes on the order of days; the promise is\n * kept so a second card on the same page shares the request rather than\n * repeating it.\n */\nconst rosterCache = new Map<string, Promise<OrgMemberOption[]>>()\n\n/** Test seam. */\nexport function resetOrgMemberDirectoryCache(): void {\n  rosterCache.clear()\n}\n\nfunction memberOption(member: Record<string, unknown>): OrgMemberOption | null {\n  const option = crmMemberOption(member)\n  return option ? { ...option, role: String(member['role'] ?? '') } : null\n}\n\nexport interface OrgMemberDirectory {\n  members: OrgMemberOption[]\n  /** The read has not settled — the picker disables rather than offers nobody. */\n  loading: boolean\n  /** Why the roster could not be read, when it could not. */\n  error: string | null\n  /**\n   * A stored reference — a uid, or an address the roster has — as a person,\n   * or the reference itself for someone no longer on the roster.\n   */\n  nameOf: (ref: string | null | undefined) => string\n}\n\nexport function useOrgMemberDirectory(\n  orgId: string | null | undefined,\n): OrgMemberDirectory {\n  const { data: user } = useUser()\n  const [state, setState] = useState<{\n    orgId: string | null\n    members: OrgMemberOption[]\n    loading: boolean\n    error: string | null\n  }>({ orgId: null, members: [], loading: false, error: null })\n\n  useEffect(() => {\n    if (!orgId || !user) return\n    let active = true\n    let roster = rosterCache.get(orgId)\n    if (!roster) {\n      roster = authorizedFetch(\n        user,\n        `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`,\n      ).then(async (response) => {\n        const payload = (await response.json().catch(() => ({}))) as {\n          members?: Array<Record<string, unknown>>\n          error?: string\n        }\n        if (!response.ok) {\n          throw new Error(payload.error || 'The team could not be loaded.')\n        }\n        return (payload.members ?? [])\n          .map(memberOption)\n          .filter((member): member is OrgMemberOption => member !== null)\n          .sort((a, b) => a.label.localeCompare(b.label))\n      })\n      rosterCache.set(orgId, roster)\n      // A failed read is not kept: the next mount asks again rather than\n      // remembering an outage for the life of the page.\n      roster.catch(() => rosterCache.delete(orgId))\n    }\n    setState({ orgId, members: [], loading: true, error: null })\n    roster.then(\n      (members) => {\n        if (active) setState({ orgId, members, loading: false, error: null })\n      },\n      (error: unknown) => {\n        if (active) {\n          setState({\n            orgId,\n            members: [],\n            loading: false,\n            error: error instanceof Error ? error.message : String(error),\n          })\n        }\n      },\n    )\n    return () => {\n      active = false\n    }\n  }, [orgId, user])\n\n  const members = state.orgId === orgId ? state.members : []\n  const nameOf = useCallback(\n    (ref: string | null | undefined) => {\n      if (!ref) return ''\n      return findOrgMember(members, ref)?.label ?? ref\n    },\n    [members],\n  )\n  return {\n    members,\n    loading: Boolean(orgId) && (state.orgId !== orgId || state.loading),\n    error: state.orgId === orgId ? state.error : null,\n    nameOf,\n  }\n}\n"],"names":["crmMemberOption","findOrgMember","authorizedFetch","useUser","useCallback","useEffect","useState","rosterCache","Map","resetOrgMemberDirectoryCache","clear","memberOption","member","option","role","String","useOrgMemberDirectory","orgId","data","user","state","setState","members","loading","error","active","roster","get","encodeURIComponent","then","response","payload","json","catch","ok","Error","map","filter","sort","a","b","label","localeCompare","set","delete","message","nameOf","ref","Boolean"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAA+BA,eAAe,EAAEC,aAAa,QAAQ,eAAc;AACnF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAOxD;;;;;;;;;;;CAWC,GACD,MAAMC,cAAc,IAAIC;AAExB,eAAe,GACf,OAAO,SAASC;IACdF,YAAYG,KAAK;AACnB;AAEA,SAASC,aAAaC,MAA+B;QAETA;IAD1C,MAAMC,SAASb,gBAAgBY;IAC/B,OAAOC,SAAS,aAAKA;QAAQC,MAAMC,QAAOH,eAAAA,MAAM,CAAC,OAAO,YAAdA,eAAkB;SAAQ;AACtE;AAeA,OAAO,SAASI,sBACdC,KAAgC;IAEhC,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGhB;IACvB,MAAM,CAACiB,OAAOC,SAAS,GAAGf,SAKvB;QAAEW,OAAO;QAAMK,SAAS,EAAE;QAAEC,SAAS;QAAOC,OAAO;IAAK;IAE3DnB,UAAU;QACR,IAAI,CAACY,SAAS,CAACE,MAAM;QACrB,IAAIM,SAAS;QACb,IAAIC,SAASnB,YAAYoB,GAAG,CAACV;QAC7B,IAAI,CAACS,QAAQ;YACXA,SAASxB,gBACPiB,MACA,CAAC,wBAAwB,EAAES,mBAAmBX,QAAQ,EACtDY,IAAI,CAAC,OAAOC;oBAQJC;gBAPR,MAAMA,UAAW,MAAMD,SAASE,IAAI,GAAGC,KAAK,CAAC,IAAO,CAAA,CAAC,CAAA;gBAIrD,IAAI,CAACH,SAASI,EAAE,EAAE;oBAChB,MAAM,IAAIC,MAAMJ,QAAQP,KAAK,IAAI;gBACnC;gBACA,OAAO,EAACO,mBAAAA,QAAQT,OAAO,YAAfS,mBAAmB,EAAE,EAC1BK,GAAG,CAACzB,cACJ0B,MAAM,CAAC,CAACzB,SAAsCA,WAAW,MACzD0B,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAEE,KAAK,CAACC,aAAa,CAACF,EAAEC,KAAK;YACjD;YACAlC,YAAYoC,GAAG,CAAC1B,OAAOS;YACvB,mEAAmE;YACnE,kDAAkD;YAClDA,OAAOO,KAAK,CAAC,IAAM1B,YAAYqC,MAAM,CAAC3B;QACxC;QACAI,SAAS;YAAEJ;YAAOK,SAAS,EAAE;YAAEC,SAAS;YAAMC,OAAO;QAAK;QAC1DE,OAAOG,IAAI,CACT,CAACP;YACC,IAAIG,QAAQJ,SAAS;gBAAEJ;gBAAOK;gBAASC,SAAS;gBAAOC,OAAO;YAAK;QACrE,GACA,CAACA;YACC,IAAIC,QAAQ;gBACVJ,SAAS;oBACPJ;oBACAK,SAAS,EAAE;oBACXC,SAAS;oBACTC,OAAOA,iBAAiBW,QAAQX,MAAMqB,OAAO,GAAG9B,OAAOS;gBACzD;YACF;QACF;QAEF,OAAO;YACLC,SAAS;QACX;IACF,GAAG;QAACR;QAAOE;KAAK;IAEhB,MAAMG,UAAUF,MAAMH,KAAK,KAAKA,QAAQG,MAAME,OAAO,GAAG,EAAE;IAC1D,MAAMwB,SAAS1C,YACb,CAAC2C;;YAEQ9C;QADP,IAAI,CAAC8C,KAAK,OAAO;QACjB,gBAAO9C,iBAAAA,cAAcqB,SAASyB,yBAAvB9C,eAA6BwC,KAAK,mBAAIM;IAC/C,GACA;QAACzB;KAAQ;IAEX,OAAO;QACLA;QACAC,SAASyB,QAAQ/B,UAAWG,CAAAA,MAAMH,KAAK,KAAKA,SAASG,MAAMG,OAAO,AAAD;QACjEC,OAAOJ,MAAMH,KAAK,KAAKA,QAAQG,MAAMI,KAAK,GAAG;QAC7CsB;IACF;AACF"}

package/src/lib/hooks/use-org-member-options.d.ts

@@ -0,0 +1,38 @@
+import { type CrmMemberOption } from '@aglyn/aglyn';
+/** One teammate, as an owner picker or an owner column needs them. */
+export type OrgMemberOption = CrmMemberOption;
+export interface OrgMemberOptions {
+    options: OrgMemberOption[];
+    /**
+     * Label for a stored reference — a uid, or an address the roster has — or
+     * the reference's own tail when the roster does not know it.
+     */
+    labelFor: (ref: string | null | undefined) => string;
+    /**
+     * The member's ADDRESS for a stored reference — what a CSV export writes
+     * in an owner column, because an import resolves an owner by email —
+     * falling back to the label and then to the reference itself.
+     */
+    emailFor: (ref: string | null | undefined) => string;
+    /** The roster has answered — with people, or with a refusal. */
+    ready: boolean;
+    /** An org is named and the roster has not answered for it yet. */
+    loading: boolean;
+    /** The roster was refused or unreachable; `options` is then empty. */
+    error: string | null;
+}
+/**
+ * The org's team, for choosing and naming a record's OWNER (AGL-2597).
+ *
+ * Read through `GET /api/orgs/members` rather than by listening to
+ * `orgs/{orgId}/members`, because the rules on that collection admit a list
+ * only to an org-wide member: a scoped editor — precisely the person an
+ * agency has running one client's CRM — is refused, and a picker that is
+ * empty for them cannot assign an owner. The route re-derives membership
+ * with the Admin SDK and answers any member of the org.
+ *
+ * Fetched once per org and held; the roster changes on a settings page, not
+ * while somebody is filing a company. A signed-out mount fetches nothing.
+ */
+export declare function useOrgMemberOptions(orgId: string | null | undefined): OrgMemberOptions;
+export default useOrgMemberOptions;

package/src/lib/hooks/use-org-member-options.js

@@ -0,0 +1,131 @@
+/**
+ * @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 { crmMemberOption, findOrgMember } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useEffect, useMemo, useState } from "react";
+/**
+ * The org's team, for choosing and naming a record's OWNER (AGL-2597).
+ *
+ * Read through `GET /api/orgs/members` rather than by listening to
+ * `orgs/{orgId}/members`, because the rules on that collection admit a list
+ * only to an org-wide member: a scoped editor — precisely the person an
+ * agency has running one client's CRM — is refused, and a picker that is
+ * empty for them cannot assign an owner. The route re-derives membership
+ * with the Admin SDK and answers any member of the org.
+ *
+ * Fetched once per org and held; the roster changes on a settings page, not
+ * while somebody is filing a company. A signed-out mount fetches nothing.
+ */ export function useOrgMemberOptions(orgId) {
+    var _ref;
+    const { data: user } = useUser();
+    /*
+   * The effect is keyed on WHO is signed in, not on the object that says so.
+   * `useUser` hands back one `User` per session, but the contract here is
+   * one fetch per org, and that must hold under any provider — a test double
+   * that mints a fresh object per render, or a listener that re-emits on a
+   * token refresh — or the roster is fetched in a loop. The object itself is
+   * only the bearer of the token, read from the closure at fetch time.
+   */ const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const [state, setState] = useState(null);
+    useEffect(()=>{
+        if (!orgId || !user) return undefined;
+        let active = true;
+        void authorizedFetch(user, `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`).then(async (response)=>{
+            const payload = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref;
+                throw new Error(String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'The team could not be loaded'));
+            }
+            const members = Array.isArray(payload == null ? void 0 : payload.members) ? payload.members : [];
+            const options = members.map((member)=>crmMemberOption(member))// A member with no uid cannot own anything. One with no name and
+            // no address is still on the team and is listed by uid — dropping
+            // them made them the one member nobody could assign to.
+            .filter((option)=>option !== null).sort((left, right)=>left.label.localeCompare(right.label, undefined, {
+                    sensitivity: 'base'
+                }));
+            if (active) setState({
+                orgId,
+                options,
+                error: null
+            });
+        }).catch((error)=>{
+            if (active) {
+                setState({
+                    orgId,
+                    options: [],
+                    error: error instanceof Error ? error.message : 'The team could not be loaded'
+                });
+            }
+        });
+        return ()=>{
+            active = false;
+        };
+    // `user` is read for its token only; `uid` is the identity that decides
+    // the answer — see the note above the state.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        orgId,
+        uid
+    ]);
+    // An answer for a different org is a stale one: the section that asked for
+    // it has moved on, and naming last org's people as this one's owners is a
+    // disclosure as well as a mistake.
+    const current = state && state.orgId === orgId ? state : null;
+    const options = useMemo(()=>{
+        var _ref;
+        return (_ref = current == null ? void 0 : current.options) != null ? _ref : [];
+    }, [
+        current
+    ]);
+    const labelFor = useMemo(()=>(ref)=>{
+            var _ref;
+            var _findOrgMember;
+            return ref ? (_ref = (_findOrgMember = findOrgMember(options, ref)) == null ? void 0 : _findOrgMember.label) != null ? _ref : `Member ${ref.slice(-6)}` : '';
+        }, [
+        options
+    ]);
+    const emailFor = useMemo(()=>(ref)=>{
+            if (!ref) return '';
+            const member = findOrgMember(options, ref);
+            return (member == null ? void 0 : member.email) || (member == null ? void 0 : member.label) || ref;
+        }, [
+        options
+    ]);
+    // One object per answer, so a column list or a drawer that lists this in
+    // its dependencies recomputes when the roster changes and not per render.
+    return useMemo(()=>{
+        var _ref;
+        return {
+            options,
+            labelFor,
+            emailFor,
+            ready: current !== null,
+            loading: Boolean(orgId) && current === null,
+            error: (_ref = current == null ? void 0 : current.error) != null ? _ref : null
+        };
+    }, [
+        options,
+        labelFor,
+        emailFor,
+        current,
+        orgId
+    ]);
+}
+export default useOrgMemberOptions;
+
+//# sourceMappingURL=use-org-member-options.js.map

package/src/lib/hooks/use-org-member-options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-org-member-options.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 { type CrmMemberOption, crmMemberOption, findOrgMember } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useEffect, useMemo, useState } from 'react'\n\n/** One teammate, as an owner picker or an owner column needs them. */\nexport type OrgMemberOption = CrmMemberOption\n\nexport interface OrgMemberOptions {\n  options: OrgMemberOption[]\n  /**\n   * Label for a stored reference — a uid, or an address the roster has — or\n   * the reference's own tail when the roster does not know it.\n   */\n  labelFor: (ref: string | null | undefined) => string\n  /**\n   * The member's ADDRESS for a stored reference — what a CSV export writes\n   * in an owner column, because an import resolves an owner by email —\n   * falling back to the label and then to the reference itself.\n   */\n  emailFor: (ref: string | null | undefined) => string\n  /** The roster has answered — with people, or with a refusal. */\n  ready: boolean\n  /** An org is named and the roster has not answered for it yet. */\n  loading: boolean\n  /** The roster was refused or unreachable; `options` is then empty. */\n  error: string | null\n}\n\n/**\n * The org's team, for choosing and naming a record's OWNER (AGL-2597).\n *\n * Read through `GET /api/orgs/members` rather than by listening to\n * `orgs/{orgId}/members`, because the rules on that collection admit a list\n * only to an org-wide member: a scoped editor — precisely the person an\n * agency has running one client's CRM — is refused, and a picker that is\n * empty for them cannot assign an owner. The route re-derives membership\n * with the Admin SDK and answers any member of the org.\n *\n * Fetched once per org and held; the roster changes on a settings page, not\n * while somebody is filing a company. A signed-out mount fetches nothing.\n */\nexport function useOrgMemberOptions(\n  orgId: string | null | undefined,\n): OrgMemberOptions {\n  const { data: user } = useUser()\n  /*\n   * The effect is keyed on WHO is signed in, not on the object that says so.\n   * `useUser` hands back one `User` per session, but the contract here is\n   * one fetch per org, and that must hold under any provider — a test double\n   * that mints a fresh object per render, or a listener that re-emits on a\n   * token refresh — or the roster is fetched in a loop. The object itself is\n   * only the bearer of the token, read from the closure at fetch time.\n   */\n  const uid = user?.uid ?? null\n  const [state, setState] = useState<{\n    orgId: string\n    options: OrgMemberOption[]\n    error: string | null\n  } | null>(null)\n\n  useEffect(() => {\n    if (!orgId || !user) return undefined\n    let active = true\n    void authorizedFetch(\n      user,\n      `/api/orgs/members?orgId=${encodeURIComponent(orgId)}`,\n    )\n      .then(async (response) => {\n        const payload = await response.json().catch(() => ({}))\n        if (!response.ok) {\n          throw new Error(\n            String(payload?.error ?? 'The team could not be loaded'),\n          )\n        }\n        const members: Array<Record<string, unknown>> = Array.isArray(\n          payload?.members,\n        )\n          ? payload.members\n          : []\n        const options = members\n          .map((member) => crmMemberOption(member))\n          // A member with no uid cannot own anything. One with no name and\n          // no address is still on the team and is listed by uid — dropping\n          // them made them the one member nobody could assign to.\n          .filter((option): option is OrgMemberOption => option !== null)\n          .sort((left, right) =>\n            left.label.localeCompare(right.label, undefined, {\n              sensitivity: 'base',\n            }),\n          )\n        if (active) setState({ orgId, options, error: null })\n      })\n      .catch((error: unknown) => {\n        if (active) {\n          setState({\n            orgId,\n            options: [],\n            error:\n              error instanceof Error\n                ? error.message\n                : 'The team could not be loaded',\n          })\n        }\n      })\n    return () => {\n      active = false\n    }\n    // `user` is read for its token only; `uid` is the identity that decides\n    // the answer — see the note above the state.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [orgId, uid])\n\n  // An answer for a different org is a stale one: the section that asked for\n  // it has moved on, and naming last org's people as this one's owners is a\n  // disclosure as well as a mistake.\n  const current = state && state.orgId === orgId ? state : null\n  const options = useMemo(() => current?.options ?? [], [current])\n  const labelFor = useMemo(\n    () => (ref: string | null | undefined) =>\n      ref ? (findOrgMember(options, ref)?.label ?? `Member ${ref.slice(-6)}`) : '',\n    [options],\n  )\n  const emailFor = useMemo(\n    () => (ref: string | null | undefined) => {\n      if (!ref) return ''\n      const member = findOrgMember(options, ref)\n      return member?.email || member?.label || ref\n    },\n    [options],\n  )\n\n  // One object per answer, so a column list or a drawer that lists this in\n  // its dependencies recomputes when the roster changes and not per render.\n  return useMemo(\n    () => ({\n      options,\n      labelFor,\n      emailFor,\n      ready: current !== null,\n      loading: Boolean(orgId) && current === null,\n      error: current?.error ?? null,\n    }),\n    [options, labelFor, emailFor, current, orgId],\n  )\n}\n\nexport default useOrgMemberOptions\n"],"names":["crmMemberOption","findOrgMember","authorizedFetch","useUser","useEffect","useMemo","useState","useOrgMemberOptions","orgId","data","user","uid","state","setState","undefined","active","encodeURIComponent","then","response","payload","json","catch","ok","Error","String","error","members","Array","isArray","options","map","member","filter","option","sort","left","right","label","localeCompare","sensitivity","message","current","labelFor","ref","slice","emailFor","email","ready","loading","Boolean"],"mappings":"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"}

package/src/lib/hooks/use-pipeline.d.ts

@@ -0,0 +1,71 @@
+import { type PipelineDoc } from '../model/deal-board-model';
+/** The most pipelines one org is read with. */
+export declare const PIPELINE_READ_LIMIT = 20;
+export interface UsePipelineOptions {
+    /**
+     * The site whose console is reading — provenance on the seeded pipeline —
+     * or `null` at the organization level (AGL-2630).
+     */
+    hostId: string | null;
+    /** The org document the shell passed, for the scope the seed is stamped with. */
+    org: Record<string, unknown> | null | undefined;
+}
+export interface UsePipelineResult {
+    /** Every pipeline the viewer may read, archived ones included, in document-id order. */
+    pipelines: PipelineDoc[];
+    /** The pipelines a picker offers — see `activePipelines`. */
+    activePipelines: PipelineDoc[];
+    /** The default ACTIVE pipeline — `isDefault`, else the first — or null before one exists. */
+    pipeline: PipelineDoc | null;
+    status: 'loading' | 'success' | 'error';
+    fromCache: boolean;
+    /** A seed write is in flight because the org had no pipeline. */
+    seeding: boolean;
+    /**
+     * The scope tokens this viewer reads with — what a new deal is filtered
+     * by — or `null` at the organization level, where nothing filters.
+     */
+    visibleToTokens: readonly string[] | null;
+    pipelineById: (id: string | undefined) => PipelineDoc | null;
+}
+/**
+ * The org's pipelines, and the default one seeded the first time nobody has
+ * made any (AGL-2598).
+ *
+ * ## Bounded, scoped, ordered
+ *
+ * `orgs/{orgId}/pipelines` is read with the same `visibleTo` predicate every
+ * CRM listener uses, ordered by document id and capped at twenty. A pipeline
+ * is a handful of documents per org — the cap is there so the query has one,
+ * not because anybody is expected to reach it. Archived pipelines are read
+ * too (AGL-2620): a closed deal still names the pipeline it closed in, and
+ * `pipelineById` has to resolve its stage on the deal's page and in the
+ * reports. Only `activePipelines` and the default exclude them.
+ *
+ * ## The seed
+ *
+ * A merchant opening Deals for the first time should see a board, not a
+ * setup step. When the SERVER has confirmed the org has no pipeline at all,
+ * the hook writes one — `Sales`, with the default stages, `isDefault` — under
+ * a fixed document id inside a transaction that first re-reads it. The
+ * transaction is what makes two tabs opening the section together produce
+ * one pipeline rather than two: whichever commits second sees the document
+ * and writes nothing.
+ *
+ * A cached empty answer does not seed. The listener reports `fromCache`
+ * while the local cache is serving it, and an empty cache is what a first
+ * load looks like in every org that already has a pipeline — seeding on it
+ * would race the real answer and, on an offline tab, write a second default
+ * once the tab reconnected.
+ *
+ * The seed carries what every CRM creator stamps: the scope a contact
+ * captured on this site would carry, the site as provenance, and the
+ * creating account. At the ORGANIZATION level (AGL-2630) the seed is the
+ * org's: stamped `['org']`, so every site's board opens on the same default
+ * pipeline rather than each site seeding one of its own the others cannot
+ * see — a pipeline's stages describe how the business sells, and at this
+ * level the business is the org. Its provenance is the site the reader has
+ * picked, when they have; a default made before any pick names none.
+ */
+export declare function usePipeline(orgId: string | null | undefined, options: UsePipelineOptions): UsePipelineResult;
+export default usePipeline;

package/src/lib/hooks/use-pipeline.js

@@ -0,0 +1,159 @@
+/**
+ * @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 { CRM_COLLECTIONS, DEFAULT_DEAL_STAGES, ORG_SCOPE_TOKEN } from "@aglyn/aglyn";
+import { useFirestore, useFirestoreCollection, useUser } from "@aglyn/tenant-feature-instance";
+import { collection, doc, documentId, limit, orderBy, query, runTransaction } from "firebase/firestore";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { activePipelines, DEFAULT_PIPELINE_ID, DEFAULT_PIPELINE_NAME, defaultPipelineOf } from "../model/deal-board-model.js";
+import { crmScopeListable, crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
+/** The most pipelines one org is read with. */ export const PIPELINE_READ_LIMIT = 20;
+/**
+ * The org's pipelines, and the default one seeded the first time nobody has
+ * made any (AGL-2598).
+ *
+ * ## Bounded, scoped, ordered
+ *
+ * `orgs/{orgId}/pipelines` is read with the same `visibleTo` predicate every
+ * CRM listener uses, ordered by document id and capped at twenty. A pipeline
+ * is a handful of documents per org — the cap is there so the query has one,
+ * not because anybody is expected to reach it. Archived pipelines are read
+ * too (AGL-2620): a closed deal still names the pipeline it closed in, and
+ * `pipelineById` has to resolve its stage on the deal's page and in the
+ * reports. Only `activePipelines` and the default exclude them.
+ *
+ * ## The seed
+ *
+ * A merchant opening Deals for the first time should see a board, not a
+ * setup step. When the SERVER has confirmed the org has no pipeline at all,
+ * the hook writes one — `Sales`, with the default stages, `isDefault` — under
+ * a fixed document id inside a transaction that first re-reads it. The
+ * transaction is what makes two tabs opening the section together produce
+ * one pipeline rather than two: whichever commits second sees the document
+ * and writes nothing.
+ *
+ * A cached empty answer does not seed. The listener reports `fromCache`
+ * while the local cache is serving it, and an empty cache is what a first
+ * load looks like in every org that already has a pipeline — seeding on it
+ * would race the real answer and, on an offline tab, write a second default
+ * once the tab reconnected.
+ *
+ * The seed carries what every CRM creator stamps: the scope a contact
+ * captured on this site would carry, the site as provenance, and the
+ * creating account. At the ORGANIZATION level (AGL-2630) the seed is the
+ * org's: stamped `['org']`, so every site's board opens on the same default
+ * pipeline rather than each site seeding one of its own the others cannot
+ * see — a pipeline's stages describe how the business sells, and at this
+ * level the business is the org. Its provenance is the site the reader has
+ * picked, when they have; a default made before any pick names none.
+ */ export function usePipeline(orgId, options) {
+    const { hostId, org } = options;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const uid = user == null ? void 0 : user.uid;
+    // The reader's tokens and the seed's stamp, from the one scope hook
+    // (AGL-2614): under a site the group's tokens both ways; at the org level
+    // no read clause, and a create stamp from the picked site.
+    const { level, visibleTo: visibleToTokens, createHostId, createTokens } = useCrmScope({
+        hostId,
+        org: org
+    });
+    const { data, status, fromCache } = useFirestoreCollection(()=>orgId && crmScopeListable(visibleToTokens) ? query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.pipelines), ...crmVisibleToClause(visibleToTokens), orderBy(documentId()), limit(PIPELINE_READ_LIMIT)) : null, [
+        firestore,
+        orgId,
+        visibleToTokens
+    ], {
+        idField: '$id'
+    });
+    const [seeding, setSeeding] = useState(false);
+    // One seed attempt per org per mount, whatever the listener does after.
+    const seededFor = useRef(null);
+    useEffect(()=>{
+        if (!orgId || !uid) return;
+        // Under a site the seed needs the site's own stamp; without one it
+        // would be a pipeline nobody may read.
+        if (level === 'site' && !createTokens.length) return;
+        if (status !== 'success' || fromCache || data.length > 0) return;
+        if (seededFor.current === orgId) return;
+        seededFor.current = orgId;
+        let active = true;
+        setSeeding(true);
+        const ref = doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.pipelines, DEFAULT_PIPELINE_ID);
+        void runTransaction(firestore, async (transaction)=>{
+            const existing = await transaction.get(ref);
+            if (existing.exists()) return;
+            transaction.set(ref, {
+                name: DEFAULT_PIPELINE_NAME,
+                stages: [
+                    ...DEFAULT_DEAL_STAGES
+                ],
+                isDefault: true,
+                archivedAt: null,
+                visibleTo: level === 'site' ? [
+                    ...createTokens
+                ] : [
+                    ORG_SCOPE_TOKEN
+                ],
+                hostId: createHostId,
+                createdByUid: uid,
+                createdAt: new Date(),
+                updatedAt: new Date()
+            });
+        }).catch((error)=>{
+            console.error(error);
+        }).finally(()=>{
+            if (active) setSeeding(false);
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        firestore,
+        orgId,
+        uid,
+        level,
+        createTokens,
+        createHostId,
+        status,
+        fromCache,
+        data
+    ]);
+    return useMemo(()=>{
+        const pipelines = data != null ? data : [];
+        return {
+            pipelines,
+            activePipelines: activePipelines(pipelines),
+            pipeline: defaultPipelineOf(pipelines),
+            status,
+            fromCache,
+            seeding,
+            visibleToTokens,
+            pipelineById: (id)=>{
+                var _pipelines_find;
+                return id ? (_pipelines_find = pipelines.find((entry)=>entry.$id === id)) != null ? _pipelines_find : null : null;
+            }
+        };
+    }, [
+        data,
+        status,
+        fromCache,
+        seeding,
+        visibleToTokens
+    ]);
+}
+export default usePipeline;
+
+//# sourceMappingURL=use-pipeline.js.map

package/src/lib/hooks/use-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-pipeline.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  DEFAULT_DEAL_STAGES,\n  ORG_SCOPE_TOKEN,\n} from '@aglyn/aglyn'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  doc,\n  documentId,\n  limit,\n  orderBy,\n  query,\n  runTransaction,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  activePipelines,\n  DEFAULT_PIPELINE_ID,\n  DEFAULT_PIPELINE_NAME,\n  defaultPipelineOf,\n  type PipelineDoc,\n} from '../model/deal-board-model'\nimport {\n  crmScopeListable,\n  crmVisibleToClause,\n  useCrmScope,\n} from './use-crm-scope'\n\n/** The most pipelines one org is read with. */\nexport const PIPELINE_READ_LIMIT = 20\n\nexport interface UsePipelineOptions {\n  /**\n   * The site whose console is reading — provenance on the seeded pipeline —\n   * or `null` at the organization level (AGL-2630).\n   */\n  hostId: string | null\n  /** The org document the shell passed, for the scope the seed is stamped with. */\n  org: Record<string, unknown> | null | undefined\n}\n\nexport interface UsePipelineResult {\n  /** Every pipeline the viewer may read, archived ones included, in document-id order. */\n  pipelines: PipelineDoc[]\n  /** The pipelines a picker offers — see `activePipelines`. */\n  activePipelines: PipelineDoc[]\n  /** The default ACTIVE pipeline — `isDefault`, else the first — or null before one exists. */\n  pipeline: PipelineDoc | null\n  status: 'loading' | 'success' | 'error'\n  fromCache: boolean\n  /** A seed write is in flight because the org had no pipeline. */\n  seeding: boolean\n  /**\n   * The scope tokens this viewer reads with — what a new deal is filtered\n   * by — or `null` at the organization level, where nothing filters.\n   */\n  visibleToTokens: readonly string[] | null\n  pipelineById: (id: string | undefined) => PipelineDoc | null\n}\n\n/**\n * The org's pipelines, and the default one seeded the first time nobody has\n * made any (AGL-2598).\n *\n * ## Bounded, scoped, ordered\n *\n * `orgs/{orgId}/pipelines` is read with the same `visibleTo` predicate every\n * CRM listener uses, ordered by document id and capped at twenty. A pipeline\n * is a handful of documents per org — the cap is there so the query has one,\n * not because anybody is expected to reach it. Archived pipelines are read\n * too (AGL-2620): a closed deal still names the pipeline it closed in, and\n * `pipelineById` has to resolve its stage on the deal's page and in the\n * reports. Only `activePipelines` and the default exclude them.\n *\n * ## The seed\n *\n * A merchant opening Deals for the first time should see a board, not a\n * setup step. When the SERVER has confirmed the org has no pipeline at all,\n * the hook writes one — `Sales`, with the default stages, `isDefault` — under\n * a fixed document id inside a transaction that first re-reads it. The\n * transaction is what makes two tabs opening the section together produce\n * one pipeline rather than two: whichever commits second sees the document\n * and writes nothing.\n *\n * A cached empty answer does not seed. The listener reports `fromCache`\n * while the local cache is serving it, and an empty cache is what a first\n * load looks like in every org that already has a pipeline — seeding on it\n * would race the real answer and, on an offline tab, write a second default\n * once the tab reconnected.\n *\n * The seed carries what every CRM creator stamps: the scope a contact\n * captured on this site would carry, the site as provenance, and the\n * creating account. At the ORGANIZATION level (AGL-2630) the seed is the\n * org's: stamped `['org']`, so every site's board opens on the same default\n * pipeline rather than each site seeding one of its own the others cannot\n * see — a pipeline's stages describe how the business sells, and at this\n * level the business is the org. Its provenance is the site the reader has\n * picked, when they have; a default made before any pick names none.\n */\nexport function usePipeline(\n  orgId: string | null | undefined,\n  options: UsePipelineOptions,\n): UsePipelineResult {\n  const { hostId, org } = options\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const uid = user?.uid\n\n  // The reader's tokens and the seed's stamp, from the one scope hook\n  // (AGL-2614): under a site the group's tokens both ways; at the org level\n  // no read clause, and a create stamp from the picked site.\n  const {\n    level,\n    visibleTo: visibleToTokens,\n    createHostId,\n    createTokens,\n  } = useCrmScope({ hostId, org: org as Record<string, unknown> | null })\n\n  const { data, status, fromCache } = useFirestoreCollection<PipelineDoc>(\n    () =>\n      orgId && crmScopeListable(visibleToTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.pipelines),\n            ...crmVisibleToClause(visibleToTokens),\n            orderBy(documentId()),\n            limit(PIPELINE_READ_LIMIT),\n          )\n        : null,\n    [firestore, orgId, visibleToTokens],\n    { idField: '$id' },\n  )\n\n  const [seeding, setSeeding] = useState(false)\n  // One seed attempt per org per mount, whatever the listener does after.\n  const seededFor = useRef<string | null>(null)\n  useEffect(() => {\n    if (!orgId || !uid) return\n    // Under a site the seed needs the site's own stamp; without one it\n    // would be a pipeline nobody may read.\n    if (level === 'site' && !createTokens.length) return\n    if (status !== 'success' || fromCache || data.length > 0) return\n    if (seededFor.current === orgId) return\n    seededFor.current = orgId\n    let active = true\n    setSeeding(true)\n    const ref = doc(\n      firestore,\n      'orgs',\n      orgId,\n      CRM_COLLECTIONS.pipelines,\n      DEFAULT_PIPELINE_ID,\n    )\n    void runTransaction(firestore, async (transaction) => {\n      const existing = await transaction.get(ref)\n      if (existing.exists()) return\n      transaction.set(ref, {\n        name: DEFAULT_PIPELINE_NAME,\n        stages: [...DEFAULT_DEAL_STAGES],\n        isDefault: true,\n        archivedAt: null,\n        visibleTo: level === 'site' ? [...createTokens] : [ORG_SCOPE_TOKEN],\n        hostId: createHostId,\n        createdByUid: uid,\n        createdAt: new Date(),\n        updatedAt: new Date(),\n      })\n    })\n      .catch((error) => {\n        console.error(error)\n      })\n      .finally(() => {\n        if (active) setSeeding(false)\n      })\n    return () => {\n      active = false\n    }\n  }, [\n    firestore,\n    orgId,\n    uid,\n    level,\n    createTokens,\n    createHostId,\n    status,\n    fromCache,\n    data,\n  ])\n\n  return useMemo(() => {\n    const pipelines = data ?? []\n    return {\n      pipelines,\n      activePipelines: activePipelines(pipelines),\n      pipeline: defaultPipelineOf(pipelines),\n      status,\n      fromCache,\n      seeding,\n      visibleToTokens,\n      pipelineById: (id) =>\n        id ? (pipelines.find((entry) => entry.$id === id) ?? null) : null,\n    }\n  }, [data, status, fromCache, seeding, visibleToTokens])\n}\n\nexport default usePipeline\n"],"names":["CRM_COLLECTIONS","DEFAULT_DEAL_STAGES","ORG_SCOPE_TOKEN","useFirestore","useFirestoreCollection","useUser","collection","doc","documentId","limit","orderBy","query","runTransaction","useEffect","useMemo","useRef","useState","activePipelines","DEFAULT_PIPELINE_ID","DEFAULT_PIPELINE_NAME","defaultPipelineOf","crmScopeListable","crmVisibleToClause","useCrmScope","PIPELINE_READ_LIMIT","usePipeline","orgId","options","hostId","org","firestore","data","user","uid","level","visibleTo","visibleToTokens","createHostId","createTokens","status","fromCache","pipelines","idField","seeding","setSeeding","seededFor","length","current","active","ref","transaction","existing","get","exists","set","name","stages","isDefault","archivedAt","createdByUid","createdAt","Date","updatedAt","catch","error","console","finally","pipeline","pipelineById","id","find","entry","$id"],"mappings":"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"}