@aglyn/plugins-crm 1.0.0-beta.220 → 1.0.0-beta.222

package/src/lib/hooks/use-crm-picklist.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-picklist.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  type CrmPicklist,\n  type CrmPicklistDefinition,\n  type CrmPicklistId,\n  crmPicklistDefinition,\n  effectiveCrmPicklist,\n  normalizeCrmPicklist,\n} from '@aglyn/aglyn'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { doc } from 'firebase/firestore'\nimport { useMemo } from 'react'\n\nexport interface CrmPicklistResult {\n  /** The field the list belongs to — its standard values, groups and targets. */\n  definition: CrmPicklistDefinition\n  /** The list every picker offers — the org's own values with every standard value. */\n  picklist: CrmPicklist\n  /** The org has written its own list; false while it reads the standard values alone. */\n  stored: boolean\n  /** The server has answered, so the list is the org's and not a placeholder. */\n  ready: boolean\n  /** The document has not been confirmed by the server — `writeGuardedBySeed`'s input. */\n  fromCache: boolean\n}\n\n/**\n * An org's values for one of the CRM's standard picklists (AGL-3510), for\n * every surface that offers or manages them: a record's select, a create\n * drawer, a list's filter and the Fields page.\n *\n * One document listen, shared by the Firestore SDK across every mount that\n * asks for the same org and picklist, so a page with the list and a drawer\n * open pays for it once. `orgId` null issues no read and answers the\n * standard values, unready.\n */\nexport function useCrmPicklist(\n  id: CrmPicklistId,\n  orgId: string | null | undefined,\n): CrmPicklistResult {\n  const firestore = useFirestore()\n  const { data, status, fromCache } = useFirestoreDoc<Record<string, unknown>>(\n    () => (orgId ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, id) : null),\n    [firestore, orgId, id],\n  )\n  return useMemo(\n    () => ({\n      definition: crmPicklistDefinition(id) as CrmPicklistDefinition,\n      picklist: effectiveCrmPicklist(id, data),\n      stored: normalizeCrmPicklist(data) !== null,\n      ready: Boolean(orgId) && status !== 'loading',\n      fromCache,\n    }),\n    [id, data, orgId, status, fromCache],\n  )\n}\n\nexport default useCrmPicklist\n"],"names":["CRM_COLLECTIONS","crmPicklistDefinition","effectiveCrmPicklist","normalizeCrmPicklist","useFirestore","useFirestoreDoc","doc","useMemo","useCrmPicklist","id","orgId","firestore","data","status","fromCache","picklists","definition","picklist","stored","ready","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SACEA,eAAe,EAIfC,qBAAqB,EACrBC,oBAAoB,EACpBC,oBAAoB,QACf,eAAc;AACrB,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAC9E,SAASC,GAAG,QAAQ,qBAAoB;AACxC,SAASC,OAAO,QAAQ,QAAO;AAe/B;;;;;;;;;CASC,GACD,OAAO,SAASC,eACdC,EAAiB,EACjBC,KAAgC;IAEhC,MAAMC,YAAYP;IAClB,MAAM,EAAEQ,IAAI,EAAEC,MAAM,EAAEC,SAAS,EAAE,GAAGT,gBAClC,IAAOK,QAAQJ,IAAIK,WAAW,QAAQD,OAAOV,gBAAgBe,SAAS,EAAEN,MAAM,MAC9E;QAACE;QAAWD;QAAOD;KAAG;IAExB,OAAOF,QACL,IAAO,CAAA;YACLS,YAAYf,sBAAsBQ;YAClCQ,UAAUf,qBAAqBO,IAAIG;YACnCM,QAAQf,qBAAqBS,UAAU;YACvCO,OAAOC,QAAQV,UAAUG,WAAW;YACpCC;QACF,CAAA,GACA;QAACL;QAAIG;QAAMF;QAAOG;QAAQC;KAAU;AAExC;AAEA,eAAeN,eAAc"}

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

@@ -14,6 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { type Firestore } from 'firebase/firestore';
 export type CrmRecordKind = 'contact' | 'company' | 'deal';
 /** The collection each kind of record lives in, under `orgs/{orgId}/`. */
 export declare const CRM_RECORD_COLLECTIONS: Record<CrmRecordKind, string>;
@@ -28,6 +29,21 @@ export declare const CRM_RECORD_COLLECTIONS: Record<CrmRecordKind, string>;
 export declare function crmRecordName(kind: CrmRecordKind, data: Record<string, unknown> | undefined, groupId: string): string;
 /** Test seam: forget everything, so a spec's fixtures are what get read. */
 export declare function resetCrmRecordNameCache(): void;
+/**
+ * The names of `records`, read now — for a one-off like a file export,
+ * which needs every name at once rather than a listener's re-render
+ * (AGL-3521). Shares {@link useCrmRecordNames}' cache, and answers the same
+ * lookup: `undefined` for a record that could not be named.
+ */
+export declare function readCrmRecordNames(firestore: Firestore, options: {
+    orgId: string;
+    groupId: string | null;
+    org?: Record<string, unknown> | null;
+    records: ReadonlyArray<{
+        kind: CrmRecordKind;
+        id: string;
+    }>;
+}): Promise<(kind: CrmRecordKind, id: string) => string | undefined>;
 /**
  * The names of the records a list of tasks points at, resolved once each.
  *

package/src/lib/hooks/use-crm-record-names.js

@@ -62,6 +62,45 @@ const cacheKey = (orgId, kind, id)=>`${orgId}/${CRM_RECORD_COLLECTIONS[kind]}/${
     nameCache.clear();
     pending.clear();
 }
+/**
+ * The reads that fill the cache for `records` not already in it — each
+ * record read once however many callers ask at the same time.
+ */ function startNameReads(firestore, orgId, groupId, org, records) {
+    const reads = [];
+    for (const { kind, id } of records){
+        if (!id) continue;
+        const key = cacheKey(orgId, kind, id);
+        if (nameCache.has(key)) continue;
+        let read = pending.get(key);
+        if (!read) {
+            read = getDoc(doc(firestore, 'orgs', orgId, CRM_RECORD_COLLECTIONS[kind], id)).then((snapshot)=>{
+                const data = snapshot.exists() ? snapshot.data() : undefined;
+                nameCache.set(key, data ? crmRecordName(kind, data, groupId != null ? groupId : contactPrimaryGroup(data, org).groupId) : null);
+            }).catch(()=>{
+            // A refused or failed read is not cached: the cell keeps showing
+            // the id, and the next mount tries again.
+            }).finally(()=>{
+                pending.delete(key);
+            });
+            pending.set(key, read);
+        }
+        reads.push(read);
+    }
+    return reads;
+}
+/**
+ * The names of `records`, read now — for a one-off like a file export,
+ * which needs every name at once rather than a listener's re-render
+ * (AGL-3521). Shares {@link useCrmRecordNames}' cache, and answers the same
+ * lookup: `undefined` for a record that could not be named.
+ */ export async function readCrmRecordNames(firestore, options) {
+    const { orgId, groupId, org, records } = options;
+    await Promise.all(startNameReads(firestore, orgId, groupId, org, records));
+    return (kind, id)=>{
+        var _nameCache_get;
+        return (_nameCache_get = nameCache.get(cacheKey(orgId, kind, id))) != null ? _nameCache_get : undefined;
+    };
+}
 /**
  * The names of the records a list of tasks points at, resolved once each.
  *
@@ -81,26 +120,13 @@ const cacheKey = (orgId, kind, id)=>`${orgId}/${CRM_RECORD_COLLECTIONS[kind]}/${
     useEffect(()=>{
         if (!orgId || !wanted) return;
         let active = true;
-        const reads = [];
-        for (const entry of wanted.split('\n')){
+        const reads = startNameReads(firestore, orgId, groupId, org, wanted.split('\n').map((entry)=>{
             const [kind, id] = entry.split(':');
-            const key = cacheKey(orgId, kind, id);
-            if (nameCache.has(key)) continue;
-            let read = pending.get(key);
-            if (!read) {
-                read = getDoc(doc(firestore, 'orgs', orgId, CRM_RECORD_COLLECTIONS[kind], id)).then((snapshot)=>{
-                    const data = snapshot.exists() ? snapshot.data() : undefined;
-                    nameCache.set(key, data ? crmRecordName(kind, data, groupId != null ? groupId : contactPrimaryGroup(data, org).groupId) : null);
-                }).catch(()=>{
-                // A refused or failed read is not cached: the cell keeps showing
-                // the id, and the next mount tries again.
-                }).finally(()=>{
-                    pending.delete(key);
-                });
-                pending.set(key, read);
-            }
-            reads.push(read);
-        }
+            return {
+                kind,
+                id
+            };
+        }));
         if (!reads.length) return;
         void Promise.all(reads).then(()=>{
             if (active) setResolved((count)=>count + 1);

package/src/lib/hooks/use-crm-record-names.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-record-names.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 { contactDisplayName, CRM_COLLECTIONS } from '@aglyn/aglyn'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport { doc, getDoc } from 'firebase/firestore'\nimport { useCallback, useEffect, useState } from 'react'\nimport { contactPrimaryGroup } from '../model/contact-record'\n\nexport type CrmRecordKind = 'contact' | 'company' | 'deal'\n\n/** The collection each kind of record lives in, under `orgs/{orgId}/`. */\nexport const CRM_RECORD_COLLECTIONS: Record<CrmRecordKind, string> = {\n  contact: 'contacts',\n  company: CRM_COLLECTIONS.companies,\n  deal: CRM_COLLECTIONS.deals,\n}\n\n/**\n * What a record is CALLED, from its document.\n *\n * A contact's name is read through the viewing group's facet, the way the\n * people list reads it, so one business renaming a person does not change\n * what an unrelated business's task list shows; the email stands in for a\n * contact nobody has named. A company has a name and a deal a title.\n */\nexport function crmRecordName(\n  kind: CrmRecordKind,\n  data: Record<string, unknown> | undefined,\n  groupId: string,\n): string {\n  if (!data) return ''\n  switch (kind) {\n    case 'contact':\n      return contactDisplayName(data, groupId) || String(data['email'] ?? '')\n    case 'company':\n      return String(data['name'] ?? '')\n    case 'deal':\n      return String(data['title'] ?? '')\n  }\n}\n\n/**\n * Names already read, keyed by `orgId/collection/id`, shared by every\n * mount for the life of the page.\n *\n * A task list names the same handful of records over and over — five tasks\n * about one deal are five rows and one name — and a person moves between the\n * tasks section, a contact's page and the dashboard without the records\n * changing underneath them. `null` records a document that does not exist,\n * so a task pointing at a deleted record costs one read rather than one per\n * render. A rename is picked up on the next page load, which is the right\n * staleness for a label beside a link to the record itself.\n */\nconst nameCache = new Map<string, string | null>()\nconst pending = new Map<string, Promise<void>>()\n\nconst cacheKey = (orgId: string, kind: CrmRecordKind, id: string) =>\n  `${orgId}/${CRM_RECORD_COLLECTIONS[kind]}/${id}`\n\n/** Test seam: forget everything, so a spec's fixtures are what get read. */\nexport function resetCrmRecordNameCache(): void {\n  nameCache.clear()\n  pending.clear()\n}\n\n/**\n * The names of the records a list of tasks points at, resolved once each.\n *\n * Returns a lookup rather than a map so the caller does not have to know the\n * cache's key shape. An unresolved record answers `undefined` — the cell\n * renders the link with the id until the name lands, which is one render\n * later on a warm cache and one round trip on a cold one.\n */\nexport function useCrmRecordNames(options: {\n  orgId: string | null | undefined\n  /**\n   * The viewing group a contact is named through, or `null` at the\n   * organization level (AGL-2630), where each contact is named through its\n   * own primary holder, resolved from {@link org}.\n   */\n  groupId: string | null\n  org?: Record<string, unknown> | null\n  records: ReadonlyArray<{ kind: CrmRecordKind; id: string }>\n}): (kind: CrmRecordKind, id: string) => string | undefined {\n  const { orgId, groupId, org, records } = options\n  const firestore = useFirestore()\n  // A counter rather than a copy of the cache: the cache is the source of\n  // truth and this only exists to re-render when it grows.\n  const [, setResolved] = useState(0)\n\n  // The pairs as one string, so the effect runs when the SET changes and not\n  // when the caller builds a new array of the same pairs on every render.\n  const wanted = records\n    .map((record) => `${record.kind}:${record.id}`)\n    .filter((entry, index, all) => all.indexOf(entry) === index)\n    .sort()\n    .join('\\n')\n\n  useEffect(() => {\n    if (!orgId || !wanted) return\n    let active = true\n    const reads: Promise<void>[] = []\n    for (const entry of wanted.split('\\n')) {\n      const [kind, id] = entry.split(':') as [CrmRecordKind, string]\n      const key = cacheKey(orgId, kind, id)\n      if (nameCache.has(key)) continue\n      let read = pending.get(key)\n      if (!read) {\n        read = getDoc(\n          doc(firestore, 'orgs', orgId, CRM_RECORD_COLLECTIONS[kind], id),\n        )\n          .then((snapshot) => {\n            const data = snapshot.exists()\n              ? (snapshot.data() as Record<string, unknown>)\n              : undefined\n            nameCache.set(\n              key,\n              data\n                ? crmRecordName(\n                    kind,\n                    data,\n                    groupId ?? contactPrimaryGroup(data, org).groupId,\n                  )\n                : null,\n            )\n          })\n          .catch(() => {\n            // A refused or failed read is not cached: the cell keeps showing\n            // the id, and the next mount tries again.\n          })\n          .finally(() => {\n            pending.delete(key)\n          })\n        pending.set(key, read)\n      }\n      reads.push(read)\n    }\n    if (!reads.length) return\n    void Promise.all(reads).then(() => {\n      if (active) setResolved((count) => count + 1)\n    })\n    return () => {\n      active = false\n    }\n  }, [firestore, orgId, groupId, wanted])\n\n  return useCallback(\n    (kind: CrmRecordKind, id: string) => {\n      if (!orgId) return undefined\n      const hit = nameCache.get(cacheKey(orgId, kind, id))\n      return hit === null ? undefined : hit\n    },\n    [orgId],\n  )\n}\n"],"names":["contactDisplayName","CRM_COLLECTIONS","useFirestore","doc","getDoc","useCallback","useEffect","useState","contactPrimaryGroup","CRM_RECORD_COLLECTIONS","contact","company","companies","deal","deals","crmRecordName","kind","data","groupId","String","nameCache","Map","pending","cacheKey","orgId","id","resetCrmRecordNameCache","clear","useCrmRecordNames","options","org","records","firestore","setResolved","wanted","map","record","filter","entry","index","all","indexOf","sort","join","active","reads","split","key","has","read","get","then","snapshot","exists","undefined","set","catch","finally","delete","push","length","Promise","count","hit"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-record-names.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 { contactDisplayName, CRM_COLLECTIONS } from '@aglyn/aglyn'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport { doc, type Firestore, getDoc } from 'firebase/firestore'\nimport { useCallback, useEffect, useState } from 'react'\nimport { contactPrimaryGroup } from '../model/contact-record'\n\nexport type CrmRecordKind = 'contact' | 'company' | 'deal'\n\n/** The collection each kind of record lives in, under `orgs/{orgId}/`. */\nexport const CRM_RECORD_COLLECTIONS: Record<CrmRecordKind, string> = {\n  contact: 'contacts',\n  company: CRM_COLLECTIONS.companies,\n  deal: CRM_COLLECTIONS.deals,\n}\n\n/**\n * What a record is CALLED, from its document.\n *\n * A contact's name is read through the viewing group's facet, the way the\n * people list reads it, so one business renaming a person does not change\n * what an unrelated business's task list shows; the email stands in for a\n * contact nobody has named. A company has a name and a deal a title.\n */\nexport function crmRecordName(\n  kind: CrmRecordKind,\n  data: Record<string, unknown> | undefined,\n  groupId: string,\n): string {\n  if (!data) return ''\n  switch (kind) {\n    case 'contact':\n      return contactDisplayName(data, groupId) || String(data['email'] ?? '')\n    case 'company':\n      return String(data['name'] ?? '')\n    case 'deal':\n      return String(data['title'] ?? '')\n  }\n}\n\n/**\n * Names already read, keyed by `orgId/collection/id`, shared by every\n * mount for the life of the page.\n *\n * A task list names the same handful of records over and over — five tasks\n * about one deal are five rows and one name — and a person moves between the\n * tasks section, a contact's page and the dashboard without the records\n * changing underneath them. `null` records a document that does not exist,\n * so a task pointing at a deleted record costs one read rather than one per\n * render. A rename is picked up on the next page load, which is the right\n * staleness for a label beside a link to the record itself.\n */\nconst nameCache = new Map<string, string | null>()\nconst pending = new Map<string, Promise<void>>()\n\nconst cacheKey = (orgId: string, kind: CrmRecordKind, id: string) =>\n  `${orgId}/${CRM_RECORD_COLLECTIONS[kind]}/${id}`\n\n/** Test seam: forget everything, so a spec's fixtures are what get read. */\nexport function resetCrmRecordNameCache(): void {\n  nameCache.clear()\n  pending.clear()\n}\n\n/**\n * The reads that fill the cache for `records` not already in it — each\n * record read once however many callers ask at the same time.\n */\nfunction startNameReads(\n  firestore: Firestore,\n  orgId: string,\n  groupId: string | null,\n  org: Record<string, unknown> | null | undefined,\n  records: ReadonlyArray<{ kind: CrmRecordKind; id: string }>,\n): Promise<void>[] {\n  const reads: Promise<void>[] = []\n  for (const { kind, id } of records) {\n    if (!id) continue\n    const key = cacheKey(orgId, kind, id)\n    if (nameCache.has(key)) continue\n    let read = pending.get(key)\n    if (!read) {\n      read = getDoc(doc(firestore, 'orgs', orgId, CRM_RECORD_COLLECTIONS[kind], id))\n        .then((snapshot) => {\n          const data = snapshot.exists() ? (snapshot.data() as Record<string, unknown>) : undefined\n          nameCache.set(\n            key,\n            data ? crmRecordName(kind, data, groupId ?? contactPrimaryGroup(data, org).groupId) : null,\n          )\n        })\n        .catch(() => {\n          // A refused or failed read is not cached: the cell keeps showing\n          // the id, and the next mount tries again.\n        })\n        .finally(() => {\n          pending.delete(key)\n        })\n      pending.set(key, read)\n    }\n    reads.push(read)\n  }\n  return reads\n}\n\n/**\n * The names of `records`, read now — for a one-off like a file export,\n * which needs every name at once rather than a listener's re-render\n * (AGL-3521). Shares {@link useCrmRecordNames}' cache, and answers the same\n * lookup: `undefined` for a record that could not be named.\n */\nexport async function readCrmRecordNames(\n  firestore: Firestore,\n  options: {\n    orgId: string\n    groupId: string | null\n    org?: Record<string, unknown> | null\n    records: ReadonlyArray<{ kind: CrmRecordKind; id: string }>\n  },\n): Promise<(kind: CrmRecordKind, id: string) => string | undefined> {\n  const { orgId, groupId, org, records } = options\n  await Promise.all(startNameReads(firestore, orgId, groupId, org, records))\n  return (kind, id) => nameCache.get(cacheKey(orgId, kind, id)) ?? undefined\n}\n\n/**\n * The names of the records a list of tasks points at, resolved once each.\n *\n * Returns a lookup rather than a map so the caller does not have to know the\n * cache's key shape. An unresolved record answers `undefined` — the cell\n * renders the link with the id until the name lands, which is one render\n * later on a warm cache and one round trip on a cold one.\n */\nexport function useCrmRecordNames(options: {\n  orgId: string | null | undefined\n  /**\n   * The viewing group a contact is named through, or `null` at the\n   * organization level (AGL-2630), where each contact is named through its\n   * own primary holder, resolved from {@link org}.\n   */\n  groupId: string | null\n  org?: Record<string, unknown> | null\n  records: ReadonlyArray<{ kind: CrmRecordKind; id: string }>\n}): (kind: CrmRecordKind, id: string) => string | undefined {\n  const { orgId, groupId, org, records } = options\n  const firestore = useFirestore()\n  // A counter rather than a copy of the cache: the cache is the source of\n  // truth and this only exists to re-render when it grows.\n  const [, setResolved] = useState(0)\n\n  // The pairs as one string, so the effect runs when the SET changes and not\n  // when the caller builds a new array of the same pairs on every render.\n  const wanted = records\n    .map((record) => `${record.kind}:${record.id}`)\n    .filter((entry, index, all) => all.indexOf(entry) === index)\n    .sort()\n    .join('\\n')\n\n  useEffect(() => {\n    if (!orgId || !wanted) return\n    let active = true\n    const reads = startNameReads(\n      firestore,\n      orgId,\n      groupId,\n      org,\n      wanted.split('\\n').map((entry) => {\n        const [kind, id] = entry.split(':') as [CrmRecordKind, string]\n        return { kind, id }\n      }),\n    )\n    if (!reads.length) return\n    void Promise.all(reads).then(() => {\n      if (active) setResolved((count) => count + 1)\n    })\n    return () => {\n      active = false\n    }\n  }, [firestore, orgId, groupId, wanted])\n\n  return useCallback(\n    (kind: CrmRecordKind, id: string) => {\n      if (!orgId) return undefined\n      const hit = nameCache.get(cacheKey(orgId, kind, id))\n      return hit === null ? undefined : hit\n    },\n    [orgId],\n  )\n}\n"],"names":["contactDisplayName","CRM_COLLECTIONS","useFirestore","doc","getDoc","useCallback","useEffect","useState","contactPrimaryGroup","CRM_RECORD_COLLECTIONS","contact","company","companies","deal","deals","crmRecordName","kind","data","groupId","String","nameCache","Map","pending","cacheKey","orgId","id","resetCrmRecordNameCache","clear","startNameReads","firestore","org","records","reads","key","has","read","get","then","snapshot","exists","undefined","set","catch","finally","delete","push","readCrmRecordNames","options","Promise","all","useCrmRecordNames","setResolved","wanted","map","record","filter","entry","index","indexOf","sort","join","active","split","length","count","hit"],"mappings":"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"}

package/src/lib/hooks/use-crm-task-picklists.d.ts

@@ -0,0 +1,11 @@
+import { type CrmTaskPicklists } from '@aglyn/aglyn';
+/**
+ * An org's Status, Priority and Type lists for tasks (AGL-3517), for every
+ * surface that shows or writes a task's labels. Three document listens,
+ * shared by the Firestore SDK with every other mount asking for the same
+ * lists; `orgId` null reads nothing and answers the standard values.
+ */
+export declare function useCrmTaskPicklists(orgId: string | null | undefined): CrmTaskPicklists & {
+    ready: boolean;
+};
+export default useCrmTaskPicklists;

package/src/lib/hooks/use-crm-task-picklists.js

@@ -0,0 +1,45 @@
+/**
+ * @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_TASK_PICKLIST_IDS } from "@aglyn/aglyn";
+import { useMemo } from "react";
+import { useCrmPicklist } from "./use-crm-picklist.js";
+/**
+ * An org's Status, Priority and Type lists for tasks (AGL-3517), for every
+ * surface that shows or writes a task's labels. Three document listens,
+ * shared by the Firestore SDK with every other mount asking for the same
+ * lists; `orgId` null reads nothing and answers the standard values.
+ */ export function useCrmTaskPicklists(orgId) {
+    const status = useCrmPicklist(CRM_TASK_PICKLIST_IDS.status, orgId);
+    const priority = useCrmPicklist(CRM_TASK_PICKLIST_IDS.priority, orgId);
+    const type = useCrmPicklist(CRM_TASK_PICKLIST_IDS.type, orgId);
+    return useMemo(()=>({
+            status: status.picklist,
+            priority: priority.picklist,
+            type: type.picklist,
+            ready: status.ready && priority.ready && type.ready
+        }), [
+        status.picklist,
+        status.ready,
+        priority.picklist,
+        priority.ready,
+        type.picklist,
+        type.ready
+    ]);
+}
+export default useCrmTaskPicklists;
+
+//# sourceMappingURL=use-crm-task-picklists.js.map

package/src/lib/hooks/use-crm-task-picklists.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-task-picklists.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 { CRM_TASK_PICKLIST_IDS, type CrmTaskPicklists } from '@aglyn/aglyn'\nimport { useMemo } from 'react'\nimport { useCrmPicklist } from './use-crm-picklist'\n\n/**\n * An org's Status, Priority and Type lists for tasks (AGL-3517), for every\n * surface that shows or writes a task's labels. Three document listens,\n * shared by the Firestore SDK with every other mount asking for the same\n * lists; `orgId` null reads nothing and answers the standard values.\n */\nexport function useCrmTaskPicklists(orgId: string | null | undefined): CrmTaskPicklists & {\n  ready: boolean\n} {\n  const status = useCrmPicklist(CRM_TASK_PICKLIST_IDS.status, orgId)\n  const priority = useCrmPicklist(CRM_TASK_PICKLIST_IDS.priority, orgId)\n  const type = useCrmPicklist(CRM_TASK_PICKLIST_IDS.type, orgId)\n  return useMemo(\n    () => ({\n      status: status.picklist,\n      priority: priority.picklist,\n      type: type.picklist,\n      ready: status.ready && priority.ready && type.ready,\n    }),\n    [status.picklist, status.ready, priority.picklist, priority.ready, type.picklist, type.ready],\n  )\n}\n\nexport default useCrmTaskPicklists\n"],"names":["CRM_TASK_PICKLIST_IDS","useMemo","useCrmPicklist","useCrmTaskPicklists","orgId","status","priority","type","picklist","ready"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,qBAAqB,QAA+B,eAAc;AAC3E,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAASC,cAAc,QAAQ,wBAAoB;AAEnD;;;;;CAKC,GACD,OAAO,SAASC,oBAAoBC,KAAgC;IAGlE,MAAMC,SAASH,eAAeF,sBAAsBK,MAAM,EAAED;IAC5D,MAAME,WAAWJ,eAAeF,sBAAsBM,QAAQ,EAAEF;IAChE,MAAMG,OAAOL,eAAeF,sBAAsBO,IAAI,EAAEH;IACxD,OAAOH,QACL,IAAO,CAAA;YACLI,QAAQA,OAAOG,QAAQ;YACvBF,UAAUA,SAASE,QAAQ;YAC3BD,MAAMA,KAAKC,QAAQ;YACnBC,OAAOJ,OAAOI,KAAK,IAAIH,SAASG,KAAK,IAAIF,KAAKE,KAAK;QACrD,CAAA,GACA;QAACJ,OAAOG,QAAQ;QAAEH,OAAOI,KAAK;QAAEH,SAASE,QAAQ;QAAEF,SAASG,KAAK;QAAEF,KAAKC,QAAQ;QAAED,KAAKE,KAAK;KAAC;AAEjG;AAEA,eAAeN,oBAAmB"}

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

@@ -32,5 +32,19 @@ export declare function useLinkedDeals(orgId: string | null, readTokens: readonl
 } | {
     companyId: string;
 }): import("@aglyn/tenant-feature-instance").UseFirestoreCollectionResult<DealDoc>;
+/**
+ * The deals a contact is on in ANY role (AGL-3521), for the contact's page
+ * beside the deals that name them as `contactId`.
+ *
+ * At the organization level, `contactRoleContactIds array-contains`. Under
+ * a site the scope and the contact are one clause —
+ * `scopedContactRoleContactIds array-contains-any` over `token~contactId`
+ * — because a query holds one array clause and the scope clause is one;
+ * that is a query the rules prove only for an org-wide member
+ * (`foldsScope`). A member whose reach is some sites asks nothing here, and
+ * reads the deals that name the contact as their Primary.
+ * `(contactRoleContactIds | scopedContactRoleContactIds, updatedAt DESC)`.
+ */
+export declare function useContactRoleDeals(orgId: string | null, readTokens: readonly string[] | null, foldsScope: boolean, contactId: string | null): import("@aglyn/tenant-feature-instance").UseFirestoreCollectionResult<DealDoc>;
 /** One deal, live. `undefined` while loading, and after a delete. */
 export declare function useDeal(orgId: string | null, dealId: string): import("@aglyn/tenant-feature-instance").UseFirestoreDocResult<DealDoc>;

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

@@ -15,6 +15,7 @@
  * limitations under the License.
  */ 'use client';
 import { CRM_COLLECTIONS } from "@aglyn/aglyn";
+import { SCOPED_SEARCH_JOIN } from "@aglyn/aglyn/app-utils/name-search";
 import { useFirestore, useFirestoreCollection, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
 import { collection, doc, limit, orderBy, query, where } from "firebase/firestore";
 import { crmScopeListable, crmVisibleToClause } from "./use-crm-scope.js";
@@ -66,6 +67,34 @@ import { crmScopeListable, crmVisibleToClause } from "./use-crm-scope.js";
         idField: '$id'
     });
 }
+/**
+ * The deals a contact is on in ANY role (AGL-3521), for the contact's page
+ * beside the deals that name them as `contactId`.
+ *
+ * At the organization level, `contactRoleContactIds array-contains`. Under
+ * a site the scope and the contact are one clause —
+ * `scopedContactRoleContactIds array-contains-any` over `token~contactId`
+ * — because a query holds one array clause and the scope clause is one;
+ * that is a query the rules prove only for an org-wide member
+ * (`foldsScope`). A member whose reach is some sites asks nothing here, and
+ * reads the deals that name the contact as their Primary.
+ * `(contactRoleContactIds | scopedContactRoleContactIds, updatedAt DESC)`.
+ */ export function useContactRoleDeals(orgId, readTokens, foldsScope, contactId) {
+    const firestore = useFirestore();
+    const scoped = readTokens ? readTokens.slice(0, 30).map((token)=>`${token}${SCOPED_SEARCH_JOIN}${contactId}`) : null;
+    const key = scoped ? scoped.join('\n') : '';
+    return useFirestoreCollection(()=>orgId && contactId && (readTokens === null || foldsScope && (scoped == null ? void 0 : scoped.length)) ? query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals), scoped ? where('scopedContactRoleContactIds', 'array-contains-any', scoped) : where('contactRoleContactIds', 'array-contains', contactId), orderBy('updatedAt', 'desc'), limit(LINKED_DEALS_LIMIT)) : null, // `key` stands for `scoped`, whose array is rebuilt on every render.
+    [
+        firestore,
+        orgId,
+        key,
+        foldsScope,
+        contactId,
+        readTokens === null
+    ], {
+        idField: '$id'
+    });
+}
 /** One deal, live. `undefined` while loading, and after a delete. */ export function useDeal(orgId, dealId) {
     const firestore = useFirestore();
     return useFirestoreDoc(()=>orgId && dealId ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals, dealId) : null, [

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-deals.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 { CRM_COLLECTIONS, type CrmDealStatus } from '@aglyn/aglyn'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useFirestoreDoc,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  doc,\n  limit,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport type { DealDoc } from '../model/deal-board-model'\nimport { crmScopeListable, crmVisibleToClause } from './use-crm-scope'\n\n/**\n * The most open cards one pipeline draws. A board past this is a board\n * nobody reads column by column; the table is paged by its query\n * (`DEAL_LIST_DECLARATION`) and reaches the rest.\n */\nexport const BOARD_OPEN_LIMIT = 500\n\n/** Closed deals shown per closed column when it is expanded. */\nexport const BOARD_CLOSED_LIMIT = 50\n\n/** Deals listed on a contact's or a company's page. */\nexport const LINKED_DEALS_LIMIT = 25\n\n/**\n * The deals of one status in one pipeline, newest activity first (AGL-2598).\n *\n * Every query here carries the viewer's scope tokens and an `orderBy`, and\n * each shape sits on an index the foundation declared:\n * `(visibleTo, pipelineId, status, updatedAt DESC)`. Passing `null` for the\n * pipeline or an EMPTY token list issues nothing, which is how a column\n * stays quiet until the pipeline has loaded and a collapsed Won column\n * costs no read. A `null` token list is the ORGANIZATION level (AGL-2630):\n * the clause is dropped and the query rides the `(pipelineId, status,\n * updatedAt DESC)` twin of that index.\n */\nexport function useDealsByStatus(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  pipelineId: string | null,\n  status: CrmDealStatus,\n  max: number,\n) {\n  const firestore = useFirestore()\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && pipelineId && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            where('pipelineId', '==', pipelineId),\n            where('status', '==', status),\n            orderBy('updatedAt', 'desc'),\n            limit(max),\n          )\n        : null,\n    [firestore, orgId, readTokens, pipelineId, status, max],\n    { idField: '$id' },\n  )\n}\n\n/**\n * The deals that name one contact or one company, for the card on that\n * record's page. `(visibleTo, contactId|companyId, updatedAt DESC)`.\n */\nexport function useLinkedDeals(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  link: { contactId: string } | { companyId: string },\n) {\n  const firestore = useFirestore()\n  const field = 'contactId' in link ? 'contactId' : 'companyId'\n  const id = 'contactId' in link ? link.contactId : link.companyId\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && id && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            where(field, '==', id),\n            orderBy('updatedAt', 'desc'),\n            limit(LINKED_DEALS_LIMIT),\n          )\n        : null,\n    [firestore, orgId, readTokens, field, id],\n    { idField: '$id' },\n  )\n}\n\n/** One deal, live. `undefined` while loading, and after a delete. */\nexport function useDeal(orgId: string | null, dealId: string) {\n  const firestore = useFirestore()\n  return useFirestoreDoc<DealDoc>(\n    () =>\n      orgId && dealId\n        ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals, dealId)\n        : null,\n    [firestore, orgId, dealId],\n    { idField: '$id' },\n  )\n}\n"],"names":["CRM_COLLECTIONS","useFirestore","useFirestoreCollection","useFirestoreDoc","collection","doc","limit","orderBy","query","where","crmScopeListable","crmVisibleToClause","BOARD_OPEN_LIMIT","BOARD_CLOSED_LIMIT","LINKED_DEALS_LIMIT","useDealsByStatus","orgId","readTokens","pipelineId","status","max","firestore","deals","idField","useLinkedDeals","link","field","id","contactId","companyId","useDeal","dealId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,eAAe,QAA4B,eAAc;AAClE,SACEC,YAAY,EACZC,sBAAsB,EACtBC,eAAe,QACV,iCAAgC;AACvC,SACEC,UAAU,EACVC,GAAG,EACHC,KAAK,EACLC,OAAO,EACPC,KAAK,EACLC,KAAK,QACA,qBAAoB;AAE3B,SAASC,gBAAgB,EAAEC,kBAAkB,QAAQ,qBAAiB;AAEtE;;;;CAIC,GACD,OAAO,MAAMC,mBAAmB,IAAG;AAEnC,8DAA8D,GAC9D,OAAO,MAAMC,qBAAqB,GAAE;AAEpC,qDAAqD,GACrD,OAAO,MAAMC,qBAAqB,GAAE;AAEpC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,iBACdC,KAAoB,EACpBC,UAAoC,EACpCC,UAAyB,EACzBC,MAAqB,EACrBC,GAAW;IAEX,MAAMC,YAAYpB;IAClB,OAAOC,uBACL,IACEc,SAASE,cAAcR,iBAAiBO,cACpCT,MACEJ,WAAWiB,WAAW,QAAQL,OAAOhB,gBAAgBsB,KAAK,MACvDX,mBAAmBM,aACtBR,MAAM,cAAc,MAAMS,aAC1BT,MAAM,UAAU,MAAMU,SACtBZ,QAAQ,aAAa,SACrBD,MAAMc,QAER,MACN;QAACC;QAAWL;QAAOC;QAAYC;QAAYC;QAAQC;KAAI,EACvD;QAAEG,SAAS;IAAM;AAErB;AAEA;;;CAGC,GACD,OAAO,SAASC,eACdR,KAAoB,EACpBC,UAAoC,EACpCQ,IAAmD;IAEnD,MAAMJ,YAAYpB;IAClB,MAAMyB,QAAQ,eAAeD,OAAO,cAAc;IAClD,MAAME,KAAK,eAAeF,OAAOA,KAAKG,SAAS,GAAGH,KAAKI,SAAS;IAChE,OAAO3B,uBACL,IACEc,SAASW,MAAMjB,iBAAiBO,cAC5BT,MACEJ,WAAWiB,WAAW,QAAQL,OAAOhB,gBAAgBsB,KAAK,MACvDX,mBAAmBM,aACtBR,MAAMiB,OAAO,MAAMC,KACnBpB,QAAQ,aAAa,SACrBD,MAAMQ,uBAER,MACN;QAACO;QAAWL;QAAOC;QAAYS;QAAOC;KAAG,EACzC;QAAEJ,SAAS;IAAM;AAErB;AAEA,mEAAmE,GACnE,OAAO,SAASO,QAAQd,KAAoB,EAAEe,MAAc;IAC1D,MAAMV,YAAYpB;IAClB,OAAOE,gBACL,IACEa,SAASe,SACL1B,IAAIgB,WAAW,QAAQL,OAAOhB,gBAAgBsB,KAAK,EAAES,UACrD,MACN;QAACV;QAAWL;QAAOe;KAAO,EAC1B;QAAER,SAAS;IAAM;AAErB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-deals.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 { CRM_COLLECTIONS, type CrmDealStatus } from '@aglyn/aglyn'\nimport { SCOPED_SEARCH_JOIN } from '@aglyn/aglyn/app-utils/name-search'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useFirestoreDoc,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  doc,\n  limit,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport type { DealDoc } from '../model/deal-board-model'\nimport { crmScopeListable, crmVisibleToClause } from './use-crm-scope'\n\n/**\n * The most open cards one pipeline draws. A board past this is a board\n * nobody reads column by column; the table is paged by its query\n * (`DEAL_LIST_DECLARATION`) and reaches the rest.\n */\nexport const BOARD_OPEN_LIMIT = 500\n\n/** Closed deals shown per closed column when it is expanded. */\nexport const BOARD_CLOSED_LIMIT = 50\n\n/** Deals listed on a contact's or a company's page. */\nexport const LINKED_DEALS_LIMIT = 25\n\n/**\n * The deals of one status in one pipeline, newest activity first (AGL-2598).\n *\n * Every query here carries the viewer's scope tokens and an `orderBy`, and\n * each shape sits on an index the foundation declared:\n * `(visibleTo, pipelineId, status, updatedAt DESC)`. Passing `null` for the\n * pipeline or an EMPTY token list issues nothing, which is how a column\n * stays quiet until the pipeline has loaded and a collapsed Won column\n * costs no read. A `null` token list is the ORGANIZATION level (AGL-2630):\n * the clause is dropped and the query rides the `(pipelineId, status,\n * updatedAt DESC)` twin of that index.\n */\nexport function useDealsByStatus(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  pipelineId: string | null,\n  status: CrmDealStatus,\n  max: number,\n) {\n  const firestore = useFirestore()\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && pipelineId && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            where('pipelineId', '==', pipelineId),\n            where('status', '==', status),\n            orderBy('updatedAt', 'desc'),\n            limit(max),\n          )\n        : null,\n    [firestore, orgId, readTokens, pipelineId, status, max],\n    { idField: '$id' },\n  )\n}\n\n/**\n * The deals that name one contact or one company, for the card on that\n * record's page. `(visibleTo, contactId|companyId, updatedAt DESC)`.\n */\nexport function useLinkedDeals(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  link: { contactId: string } | { companyId: string },\n) {\n  const firestore = useFirestore()\n  const field = 'contactId' in link ? 'contactId' : 'companyId'\n  const id = 'contactId' in link ? link.contactId : link.companyId\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && id && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            where(field, '==', id),\n            orderBy('updatedAt', 'desc'),\n            limit(LINKED_DEALS_LIMIT),\n          )\n        : null,\n    [firestore, orgId, readTokens, field, id],\n    { idField: '$id' },\n  )\n}\n\n/**\n * The deals a contact is on in ANY role (AGL-3521), for the contact's page\n * beside the deals that name them as `contactId`.\n *\n * At the organization level, `contactRoleContactIds array-contains`. Under\n * a site the scope and the contact are one clause —\n * `scopedContactRoleContactIds array-contains-any` over `token~contactId`\n * — because a query holds one array clause and the scope clause is one;\n * that is a query the rules prove only for an org-wide member\n * (`foldsScope`). A member whose reach is some sites asks nothing here, and\n * reads the deals that name the contact as their Primary.\n * `(contactRoleContactIds | scopedContactRoleContactIds, updatedAt DESC)`.\n */\nexport function useContactRoleDeals(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  foldsScope: boolean,\n  contactId: string | null,\n) {\n  const firestore = useFirestore()\n  const scoped = readTokens\n    ? readTokens.slice(0, 30).map((token) => `${token}${SCOPED_SEARCH_JOIN}${contactId}`)\n    : null\n  const key = scoped ? scoped.join('\\n') : ''\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && contactId && (readTokens === null || (foldsScope && scoped?.length))\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            scoped\n              ? where('scopedContactRoleContactIds', 'array-contains-any', scoped)\n              : where('contactRoleContactIds', 'array-contains', contactId),\n            orderBy('updatedAt', 'desc'),\n            limit(LINKED_DEALS_LIMIT),\n          )\n        : null,\n    // `key` stands for `scoped`, whose array is rebuilt on every render.\n    [firestore, orgId, key, foldsScope, contactId, readTokens === null],\n    { idField: '$id' },\n  )\n}\n\n/** One deal, live. `undefined` while loading, and after a delete. */\nexport function useDeal(orgId: string | null, dealId: string) {\n  const firestore = useFirestore()\n  return useFirestoreDoc<DealDoc>(\n    () =>\n      orgId && dealId\n        ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals, dealId)\n        : null,\n    [firestore, orgId, dealId],\n    { idField: '$id' },\n  )\n}\n"],"names":["CRM_COLLECTIONS","SCOPED_SEARCH_JOIN","useFirestore","useFirestoreCollection","useFirestoreDoc","collection","doc","limit","orderBy","query","where","crmScopeListable","crmVisibleToClause","BOARD_OPEN_LIMIT","BOARD_CLOSED_LIMIT","LINKED_DEALS_LIMIT","useDealsByStatus","orgId","readTokens","pipelineId","status","max","firestore","deals","idField","useLinkedDeals","link","field","id","contactId","companyId","useContactRoleDeals","foldsScope","scoped","slice","map","token","key","join","length","useDeal","dealId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,eAAe,QAA4B,eAAc;AAClE,SAASC,kBAAkB,QAAQ,qCAAoC;AACvE,SACEC,YAAY,EACZC,sBAAsB,EACtBC,eAAe,QACV,iCAAgC;AACvC,SACEC,UAAU,EACVC,GAAG,EACHC,KAAK,EACLC,OAAO,EACPC,KAAK,EACLC,KAAK,QACA,qBAAoB;AAE3B,SAASC,gBAAgB,EAAEC,kBAAkB,QAAQ,qBAAiB;AAEtE;;;;CAIC,GACD,OAAO,MAAMC,mBAAmB,IAAG;AAEnC,8DAA8D,GAC9D,OAAO,MAAMC,qBAAqB,GAAE;AAEpC,qDAAqD,GACrD,OAAO,MAAMC,qBAAqB,GAAE;AAEpC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,iBACdC,KAAoB,EACpBC,UAAoC,EACpCC,UAAyB,EACzBC,MAAqB,EACrBC,GAAW;IAEX,MAAMC,YAAYpB;IAClB,OAAOC,uBACL,IACEc,SAASE,cAAcR,iBAAiBO,cACpCT,MACEJ,WAAWiB,WAAW,QAAQL,OAAOjB,gBAAgBuB,KAAK,MACvDX,mBAAmBM,aACtBR,MAAM,cAAc,MAAMS,aAC1BT,MAAM,UAAU,MAAMU,SACtBZ,QAAQ,aAAa,SACrBD,MAAMc,QAER,MACN;QAACC;QAAWL;QAAOC;QAAYC;QAAYC;QAAQC;KAAI,EACvD;QAAEG,SAAS;IAAM;AAErB;AAEA;;;CAGC,GACD,OAAO,SAASC,eACdR,KAAoB,EACpBC,UAAoC,EACpCQ,IAAmD;IAEnD,MAAMJ,YAAYpB;IAClB,MAAMyB,QAAQ,eAAeD,OAAO,cAAc;IAClD,MAAME,KAAK,eAAeF,OAAOA,KAAKG,SAAS,GAAGH,KAAKI,SAAS;IAChE,OAAO3B,uBACL,IACEc,SAASW,MAAMjB,iBAAiBO,cAC5BT,MACEJ,WAAWiB,WAAW,QAAQL,OAAOjB,gBAAgBuB,KAAK,MACvDX,mBAAmBM,aACtBR,MAAMiB,OAAO,MAAMC,KACnBpB,QAAQ,aAAa,SACrBD,MAAMQ,uBAER,MACN;QAACO;QAAWL;QAAOC;QAAYS;QAAOC;KAAG,EACzC;QAAEJ,SAAS;IAAM;AAErB;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASO,oBACdd,KAAoB,EACpBC,UAAoC,EACpCc,UAAmB,EACnBH,SAAwB;IAExB,MAAMP,YAAYpB;IAClB,MAAM+B,SAASf,aACXA,WAAWgB,KAAK,CAAC,GAAG,IAAIC,GAAG,CAAC,CAACC,QAAU,GAAGA,QAAQnC,qBAAqB4B,WAAW,IAClF;IACJ,MAAMQ,MAAMJ,SAASA,OAAOK,IAAI,CAAC,QAAQ;IACzC,OAAOnC,uBACL,IACEc,SAASY,aAAcX,CAAAA,eAAe,QAASc,eAAcC,0BAAAA,OAAQM,MAAM,CAAA,IACvE9B,MACEJ,WAAWiB,WAAW,QAAQL,OAAOjB,gBAAgBuB,KAAK,GAC1DU,SACIvB,MAAM,+BAA+B,sBAAsBuB,UAC3DvB,MAAM,yBAAyB,kBAAkBmB,YACrDrB,QAAQ,aAAa,SACrBD,MAAMQ,uBAER,MACN,qEAAqE;IACrE;QAACO;QAAWL;QAAOoB;QAAKL;QAAYH;QAAWX,eAAe;KAAK,EACnE;QAAEM,SAAS;IAAM;AAErB;AAEA,mEAAmE,GACnE,OAAO,SAASgB,QAAQvB,KAAoB,EAAEwB,MAAc;IAC1D,MAAMnB,YAAYpB;IAClB,OAAOE,gBACL,IACEa,SAASwB,SACLnC,IAAIgB,WAAW,QAAQL,OAAOjB,gBAAgBuB,KAAK,EAAEkB,UACrD,MACN;QAACnB;QAAWL;QAAOwB;KAAO,EAC1B;QAAEjB,SAAS;IAAM;AAErB"}

package/src/lib/hooks/use-lead-picklists.d.ts

@@ -0,0 +1,14 @@
+import type { CrmPicklist, CrmPicklistId } from '@aglyn/aglyn';
+export interface LeadPicklistsResult {
+    /** Each list a lead field beside the lead source holds a value of, by picklist id. */
+    lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>;
+    /** Every list has answered from the server. */
+    ready: boolean;
+}
+/**
+ * The org's lists behind a lead's Salutation, Industry and Rating
+ * (AGL-3513) — the contact's and the company's own lists, one document
+ * listen each, shared with every other mount asking for the same list.
+ */
+export declare function useLeadPicklists(orgId: string | null | undefined): LeadPicklistsResult;
+export default useLeadPicklists;

package/src/lib/hooks/use-lead-picklists.js

@@ -0,0 +1,46 @@
+/**
+ * @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 { useMemo } from "react";
+import { useCrmPicklist } from "./use-crm-picklist.js";
+/**
+ * The org's lists behind a lead's Salutation, Industry and Rating
+ * (AGL-3513) — the contact's and the company's own lists, one document
+ * listen each, shared with every other mount asking for the same list.
+ */ export function useLeadPicklists(orgId) {
+    const salutation = useCrmPicklist('salutation', orgId);
+    const industry = useCrmPicklist('industry', orgId);
+    const rating = useCrmPicklist('rating', orgId);
+    return useMemo(()=>({
+            lists: {
+                salutation: salutation.picklist,
+                industry: industry.picklist,
+                rating: rating.picklist
+            },
+            ready: [
+                salutation,
+                industry,
+                rating
+            ].every((list)=>list.ready)
+        }), [
+        salutation,
+        industry,
+        rating
+    ]);
+}
+export default useLeadPicklists;
+
+//# sourceMappingURL=use-lead-picklists.js.map

package/src/lib/hooks/use-lead-picklists.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-lead-picklists.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 { CrmPicklist, CrmPicklistId } from '@aglyn/aglyn'\nimport { useMemo } from 'react'\nimport { useCrmPicklist } from './use-crm-picklist'\n\nexport interface LeadPicklistsResult {\n  /** Each list a lead field beside the lead source holds a value of, by picklist id. */\n  lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>\n  /** Every list has answered from the server. */\n  ready: boolean\n}\n\n/**\n * The org's lists behind a lead's Salutation, Industry and Rating\n * (AGL-3513) — the contact's and the company's own lists, one document\n * listen each, shared with every other mount asking for the same list.\n */\nexport function useLeadPicklists(orgId: string | null | undefined): LeadPicklistsResult {\n  const salutation = useCrmPicklist('salutation', orgId)\n  const industry = useCrmPicklist('industry', orgId)\n  const rating = useCrmPicklist('rating', orgId)\n  return useMemo(\n    () => ({\n      lists: {\n        salutation: salutation.picklist,\n        industry: industry.picklist,\n        rating: rating.picklist,\n      },\n      ready: [salutation, industry, rating].every((list) => list.ready),\n    }),\n    [salutation, industry, rating],\n  )\n}\n\nexport default useLeadPicklists\n"],"names":["useMemo","useCrmPicklist","useLeadPicklists","orgId","salutation","industry","rating","lists","picklist","ready","every","list"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAGA,SAASA,OAAO,QAAQ,QAAO;AAC/B,SAASC,cAAc,QAAQ,wBAAoB;AASnD;;;;CAIC,GACD,OAAO,SAASC,iBAAiBC,KAAgC;IAC/D,MAAMC,aAAaH,eAAe,cAAcE;IAChD,MAAME,WAAWJ,eAAe,YAAYE;IAC5C,MAAMG,SAASL,eAAe,UAAUE;IACxC,OAAOH,QACL,IAAO,CAAA;YACLO,OAAO;gBACLH,YAAYA,WAAWI,QAAQ;gBAC/BH,UAAUA,SAASG,QAAQ;gBAC3BF,QAAQA,OAAOE,QAAQ;YACzB;YACAC,OAAO;gBAACL;gBAAYC;gBAAUC;aAAO,CAACI,KAAK,CAAC,CAACC,OAASA,KAAKF,KAAK;QAClE,CAAA,GACA;QAACL;QAAYC;QAAUC;KAAO;AAElC;AAEA,eAAeJ,iBAAgB"}

package/src/lib/hooks/use-lead-source-picklist.d.ts

@@ -1,23 +1,9 @@
-import { type CrmPicklist } from '@aglyn/aglyn';
-export interface LeadSourcePicklistResult {
-    /** The list every picker offers — the org's own, or the starter set. */
-    picklist: CrmPicklist;
-    /** The org has written its own list; false while it reads the starter set. */
-    stored: boolean;
-    /** The server has answered, so the list is the org's and not a placeholder. */
-    ready: boolean;
-    /** The document has not been confirmed by the server — `writeGuardedBySeed`'s input. */
-    fromCache: boolean;
-}
+import { type CrmPicklistResult } from './use-crm-picklist';
+export type LeadSourcePicklistResult = Omit<CrmPicklistResult, 'definition'>;
 /**
- * The org's lead source values (AGL-3298), for every surface that offers
- * or manages them: the lead page's select, the New lead drawer, the
- * contact's card, the leads list's filter and the Fields page.
- *
- * One document listen, shared by the Firestore SDK across every mount that
- * asks for the same org, so a page with the list and a drawer open pays
- * for it once. `orgId` null issues no read and answers the starter set,
- * unready.
+ * The org's lead source values (AGL-3298) — {@link useCrmPicklist} for the
+ * lead source: the lead page's select, the New lead drawer, the contact's
+ * card, the leads list's filter and the import drawer.
  */
 export declare function useLeadSourcePicklist(orgId: string | null | undefined): LeadSourcePicklistResult;
 export default useLeadSourcePicklist;

package/src/lib/hooks/use-lead-source-picklist.js

@@ -14,34 +14,24 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 'use client';
-import { CRM_COLLECTIONS, CRM_LEAD_SOURCE_PICKLIST, effectiveCrmLeadSourcePicklist, normalizeCrmPicklist } from "@aglyn/aglyn";
-import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
-import { doc } from "firebase/firestore";
+import { CRM_LEAD_SOURCE_PICKLIST } from "@aglyn/aglyn";
 import { useMemo } from "react";
+import { useCrmPicklist } from "./use-crm-picklist.js";
 /**
- * The org's lead source values (AGL-3298), for every surface that offers
- * or manages them: the lead page's select, the New lead drawer, the
- * contact's card, the leads list's filter and the Fields page.
- *
- * One document listen, shared by the Firestore SDK across every mount that
- * asks for the same org, so a page with the list and a drawer open pays
- * for it once. `orgId` null issues no read and answers the starter set,
- * unready.
+ * The org's lead source values (AGL-3298) — {@link useCrmPicklist} for the
+ * lead source: the lead page's select, the New lead drawer, the contact's
+ * card, the leads list's filter and the import drawer.
  */ export function useLeadSourcePicklist(orgId) {
-    const firestore = useFirestore();
-    const { data, status, fromCache } = useFirestoreDoc(()=>orgId ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, CRM_LEAD_SOURCE_PICKLIST) : null, [
-        firestore,
-        orgId
-    ]);
+    const { picklist, stored, ready, fromCache } = useCrmPicklist(CRM_LEAD_SOURCE_PICKLIST, orgId);
     return useMemo(()=>({
-            picklist: effectiveCrmLeadSourcePicklist(data),
-            stored: normalizeCrmPicklist(data) !== null,
-            ready: Boolean(orgId) && status !== 'loading',
+            picklist,
+            stored,
+            ready,
             fromCache
         }), [
-        data,
-        orgId,
-        status,
+        picklist,
+        stored,
+        ready,
         fromCache
     ]);
 }

package/src/lib/hooks/use-lead-source-picklist.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-lead-source-picklist.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  CRM_COLLECTIONS,\n  CRM_LEAD_SOURCE_PICKLIST,\n  type CrmPicklist,\n  effectiveCrmLeadSourcePicklist,\n  normalizeCrmPicklist,\n} from '@aglyn/aglyn'\nimport { useFirestore, useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { doc } from 'firebase/firestore'\nimport { useMemo } from 'react'\n\nexport interface LeadSourcePicklistResult {\n  /** The list every picker offers — the org's own, or the starter set. */\n  picklist: CrmPicklist\n  /** The org has written its own list; false while it reads the starter set. */\n  stored: boolean\n  /** The server has answered, so the list is the org's and not a placeholder. */\n  ready: boolean\n  /** The document has not been confirmed by the server — `writeGuardedBySeed`'s input. */\n  fromCache: boolean\n}\n\n/**\n * The org's lead source values (AGL-3298), for every surface that offers\n * or manages them: the lead page's select, the New lead drawer, the\n * contact's card, the leads list's filter and the Fields page.\n *\n * One document listen, shared by the Firestore SDK across every mount that\n * asks for the same org, so a page with the list and a drawer open pays\n * for it once. `orgId` null issues no read and answers the starter set,\n * unready.\n */\nexport function useLeadSourcePicklist(orgId: string | null | undefined): LeadSourcePicklistResult {\n  const firestore = useFirestore()\n  const { data, status, fromCache } = useFirestoreDoc<Record<string, unknown>>(\n    () =>\n      orgId\n        ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, CRM_LEAD_SOURCE_PICKLIST)\n        : null,\n    [firestore, orgId],\n  )\n  return useMemo(\n    () => ({\n      picklist: effectiveCrmLeadSourcePicklist(data),\n      stored: normalizeCrmPicklist(data) !== null,\n      ready: Boolean(orgId) && status !== 'loading',\n      fromCache,\n    }),\n    [data, orgId, status, fromCache],\n  )\n}\n\nexport default useLeadSourcePicklist\n"],"names":["CRM_COLLECTIONS","CRM_LEAD_SOURCE_PICKLIST","effectiveCrmLeadSourcePicklist","normalizeCrmPicklist","useFirestore","useFirestoreDoc","doc","useMemo","useLeadSourcePicklist","orgId","firestore","data","status","fromCache","picklists","picklist","stored","ready","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SACEA,eAAe,EACfC,wBAAwB,EAExBC,8BAA8B,EAC9BC,oBAAoB,QACf,eAAc;AACrB,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAC9E,SAASC,GAAG,QAAQ,qBAAoB;AACxC,SAASC,OAAO,QAAQ,QAAO;AAa/B;;;;;;;;;CASC,GACD,OAAO,SAASC,sBAAsBC,KAAgC;IACpE,MAAMC,YAAYN;IAClB,MAAM,EAAEO,IAAI,EAAEC,MAAM,EAAEC,SAAS,EAAE,GAAGR,gBAClC,IACEI,QACIH,IAAII,WAAW,QAAQD,OAAOT,gBAAgBc,SAAS,EAAEb,4BACzD,MACN;QAACS;QAAWD;KAAM;IAEpB,OAAOF,QACL,IAAO,CAAA;YACLQ,UAAUb,+BAA+BS;YACzCK,QAAQb,qBAAqBQ,UAAU;YACvCM,OAAOC,QAAQT,UAAUG,WAAW;YACpCC;QACF,CAAA,GACA;QAACF;QAAMF;QAAOG;QAAQC;KAAU;AAEpC;AAEA,eAAeL,sBAAqB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-lead-source-picklist.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 { CRM_LEAD_SOURCE_PICKLIST } from '@aglyn/aglyn'\nimport { useMemo } from 'react'\nimport { type CrmPicklistResult, useCrmPicklist } from './use-crm-picklist'\n\nexport type LeadSourcePicklistResult = Omit<CrmPicklistResult, 'definition'>\n\n/**\n * The org's lead source values (AGL-3298) — {@link useCrmPicklist} for the\n * lead source: the lead page's select, the New lead drawer, the contact's\n * card, the leads list's filter and the import drawer.\n */\nexport function useLeadSourcePicklist(orgId: string | null | undefined): LeadSourcePicklistResult {\n  const { picklist, stored, ready, fromCache } = useCrmPicklist(CRM_LEAD_SOURCE_PICKLIST, orgId)\n  return useMemo(() => ({ picklist, stored, ready, fromCache }), [picklist, stored, ready, fromCache])\n}\n\nexport default useLeadSourcePicklist\n"],"names":["CRM_LEAD_SOURCE_PICKLIST","useMemo","useCrmPicklist","useLeadSourcePicklist","orgId","picklist","stored","ready","fromCache"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,wBAAwB,QAAQ,eAAc;AACvD,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAAiCC,cAAc,QAAQ,wBAAoB;AAI3E;;;;CAIC,GACD,OAAO,SAASC,sBAAsBC,KAAgC;IACpE,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAE,GAAGN,eAAeF,0BAA0BI;IACxF,OAAOH,QAAQ,IAAO,CAAA;YAAEI;YAAUC;YAAQC;YAAOC;QAAU,CAAA,GAAI;QAACH;QAAUC;QAAQC;QAAOC;KAAU;AACrG;AAEA,eAAeL,sBAAqB"}

package/src/lib/hooks/use-lead-status-picklist.d.ts

@@ -0,0 +1,9 @@
+import { type CrmPicklistResult } from './use-crm-picklist';
+export type LeadStatusPicklistResult = Omit<CrmPicklistResult, 'definition'>;
+/**
+ * The org's lead status values (AGL-3512) — {@link useCrmPicklist} for the
+ * lead status: every chip, select and filter that shows a lead's status by
+ * the label the org gave its meaning. One shared document listen.
+ */
+export declare function useLeadStatusPicklist(orgId: string | null | undefined): LeadStatusPicklistResult;
+export default useLeadStatusPicklist;

package/src/lib/hooks/use-lead-status-picklist.js

@@ -0,0 +1,40 @@
+/**
+ * @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_LEAD_STATUS_PICKLIST } from "@aglyn/aglyn";
+import { useMemo } from "react";
+import { useCrmPicklist } from "./use-crm-picklist.js";
+/**
+ * The org's lead status values (AGL-3512) — {@link useCrmPicklist} for the
+ * lead status: every chip, select and filter that shows a lead's status by
+ * the label the org gave its meaning. One shared document listen.
+ */ export function useLeadStatusPicklist(orgId) {
+    const { picklist, stored, ready, fromCache } = useCrmPicklist(CRM_LEAD_STATUS_PICKLIST, orgId);
+    return useMemo(()=>({
+            picklist,
+            stored,
+            ready,
+            fromCache
+        }), [
+        picklist,
+        stored,
+        ready,
+        fromCache
+    ]);
+}
+export default useLeadStatusPicklist;
+
+//# sourceMappingURL=use-lead-status-picklist.js.map

package/src/lib/hooks/use-lead-status-picklist.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-lead-status-picklist.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 { CRM_LEAD_STATUS_PICKLIST } from '@aglyn/aglyn'\nimport { useMemo } from 'react'\nimport { type CrmPicklistResult, useCrmPicklist } from './use-crm-picklist'\n\nexport type LeadStatusPicklistResult = Omit<CrmPicklistResult, 'definition'>\n\n/**\n * The org's lead status values (AGL-3512) — {@link useCrmPicklist} for the\n * lead status: every chip, select and filter that shows a lead's status by\n * the label the org gave its meaning. One shared document listen.\n */\nexport function useLeadStatusPicklist(orgId: string | null | undefined): LeadStatusPicklistResult {\n  const { picklist, stored, ready, fromCache } = useCrmPicklist(CRM_LEAD_STATUS_PICKLIST, orgId)\n  return useMemo(() => ({ picklist, stored, ready, fromCache }), [picklist, stored, ready, fromCache])\n}\n\nexport default useLeadStatusPicklist\n"],"names":["CRM_LEAD_STATUS_PICKLIST","useMemo","useCrmPicklist","useLeadStatusPicklist","orgId","picklist","stored","ready","fromCache"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,wBAAwB,QAAQ,eAAc;AACvD,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAAiCC,cAAc,QAAQ,wBAAoB;AAI3E;;;;CAIC,GACD,OAAO,SAASC,sBAAsBC,KAAgC;IACpE,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAE,GAAGN,eAAeF,0BAA0BI;IACxF,OAAOH,QAAQ,IAAO,CAAA;YAAEI;YAAUC;YAAQC;YAAOC;QAAU,CAAA,GAAI;QAACH;QAAUC;QAAQC;QAAOC;KAAU;AACrG;AAEA,eAAeL,sBAAqB"}