@aglyn/plugins-crm 1.0.0-beta.199 → 1.0.0-beta.201

package/src/lib/hooks/use-org-leads.js

@@ -1,104 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ 'use client';
-import { _ as _extends } from "@swc/helpers/_/_extends";
-import { useFirestore } from "@aglyn/tenant-feature-instance";
-import { collection, limit, onSnapshot, orderBy, query, where } from "firebase/firestore";
-import { useEffect, useMemo, useState } from "react";
-/**
- * THE ORGANIZATION'S LEADS, in one listener (AGL-3275).
- *
- * This opened one listener PER SITE and merged the answers, because a lead
- * lived at `hosts/{hostId}/leads` — host-scoped by path, with no org-level
- * collection to listen to, no `orgId` on the document to group by, and no
- * rule admitting a collection-group read. All three of those are now false:
- * the collection is `orgs/{orgId}/leads` and a lead says who may see it.
- *
- * So the fan-out is gone, and with it the merge that had to cut each site's
- * window at `windowSize + 1` and the whole list again, so that a site with a
- * thousand leads could not crowd out a site with ten. One ordered query needs
- * neither: `truncated` is simply "the window came back full".
- *
- * `visibleTo` is the caller's, and `null` means "ask for everything" — which
- * is what an org-wide member's listeners do, since the rules short-circuit on
- * `isOrgWideMember()` and a clause would only narrow what they may already
- * read. A scoped member passes their tokens. See `crmVisibleToClause`, which
- * builds the same clause for every other CRM listener.
- */ export function useOrgLeads(options) {
-    const { orgId, visibleTo, windowSize } = options;
-    const firestore = useFirestore();
-    const scopeKey = visibleTo ? visibleTo.join('\n') : null;
-    const [answer, setAnswer] = useState(null);
-    useEffect(()=>{
-        setAnswer(null);
-        if (!orgId) return undefined;
-        // An `array-contains-any` over nothing is a query Firestore refuses, so a
-        // scoped member with no tokens lists nothing rather than asking.
-        const tokens = scopeKey === null ? null : scopeKey ? scopeKey.split('\n') : [];
-        if (tokens && !tokens.length) {
-            setAnswer({
-                rows: [],
-                truncated: false
-            });
-            return undefined;
-        }
-        const clauses = tokens ? [
-            where('visibleTo', 'array-contains-any', tokens)
-        ] : [];
-        return onSnapshot(query(collection(firestore, 'orgs', orgId, 'leads'), ...clauses, orderBy('lastSeenAtMs', 'desc'), limit(windowSize + 1)), (snapshot)=>{
-            const rows = snapshot.docs.map((entry)=>_extends({}, entry.data(), {
-                    $id: entry.id,
-                    leadId: entry.id
-                }));
-            setAnswer({
-                rows: rows.slice(0, windowSize),
-                truncated: rows.length > windowSize
-            });
-        }, (error)=>{
-            console.error(error);
-            setAnswer('error');
-        });
-    }, [
-        firestore,
-        orgId,
-        scopeKey,
-        windowSize
-    ]);
-    return useMemo(()=>{
-        if (answer === 'error') {
-            return {
-                data: [],
-                status: 'error',
-                truncated: false
-            };
-        }
-        if (!answer) return {
-            data: [],
-            status: 'loading',
-            truncated: false
-        };
-        return {
-            data: answer.rows,
-            status: 'success',
-            truncated: answer.truncated
-        };
-    }, [
-        answer
-    ]);
-}
-export default useOrgLeads;
-
-//# sourceMappingURL=use-org-leads.js.map

package/src/lib/hooks/use-org-leads.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-org-leads.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 { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  limit,\n  onSnapshot,\n  orderBy,\n  query,\n  where,\n  type DocumentData,\n  type QueryConstraint,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\n\n/** A lead, as the organization-level list carries it. */\nexport interface OrgLeadRow extends DocumentData {\n  /**\n   * The grid's row id, which is the lead's own document id.\n   *\n   * It used to be `{hostId}/{leadId}`, because a lead lived under its site\n   * and the same person on two sites was two documents with the SAME id —\n   * so the id alone could not key a list spanning sites. AGL-3275 made that\n   * one document, and the compound key went with it.\n   */\n  $id: string\n  /** `orgs/{orgId}/leads/{leadId}` — the document id, a person key. */\n  leadId: string\n}\n\nexport interface OrgLeadsResult {\n  /** The window, ordered newest-seen first. */\n  data: OrgLeadRow[]\n  /** `loading` until the listener has answered once; `error` when it refused. */\n  status: 'loading' | 'success' | 'error'\n  /** There are leads beyond the window this list is showing. */\n  truncated: boolean\n}\n\n/**\n * THE ORGANIZATION'S LEADS, in one listener (AGL-3275).\n *\n * This opened one listener PER SITE and merged the answers, because a lead\n * lived at `hosts/{hostId}/leads` — host-scoped by path, with no org-level\n * collection to listen to, no `orgId` on the document to group by, and no\n * rule admitting a collection-group read. All three of those are now false:\n * the collection is `orgs/{orgId}/leads` and a lead says who may see it.\n *\n * So the fan-out is gone, and with it the merge that had to cut each site's\n * window at `windowSize + 1` and the whole list again, so that a site with a\n * thousand leads could not crowd out a site with ten. One ordered query needs\n * neither: `truncated` is simply \"the window came back full\".\n *\n * `visibleTo` is the caller's, and `null` means \"ask for everything\" — which\n * is what an org-wide member's listeners do, since the rules short-circuit on\n * `isOrgWideMember()` and a clause would only narrow what they may already\n * read. A scoped member passes their tokens. See `crmVisibleToClause`, which\n * builds the same clause for every other CRM listener.\n */\nexport function useOrgLeads(options: {\n  orgId: string | null | undefined\n  /** The scope clause, or `null` for an unscoped org-wide read. */\n  visibleTo: readonly string[] | null\n  windowSize: number\n}): OrgLeadsResult {\n  const { orgId, visibleTo, windowSize } = options\n  const firestore = useFirestore()\n  const scopeKey = visibleTo ? visibleTo.join('\\n') : null\n  const [answer, setAnswer] = useState<\n    { rows: OrgLeadRow[]; truncated: boolean } | 'error' | null\n  >(null)\n\n  useEffect(() => {\n    setAnswer(null)\n    if (!orgId) return undefined\n    // An `array-contains-any` over nothing is a query Firestore refuses, so a\n    // scoped member with no tokens lists nothing rather than asking.\n    const tokens = scopeKey === null ? null : scopeKey ? scopeKey.split('\\n') : []\n    if (tokens && !tokens.length) {\n      setAnswer({ rows: [], truncated: false })\n      return undefined\n    }\n    const clauses: QueryConstraint[] = tokens\n      ? [where('visibleTo', 'array-contains-any', tokens)]\n      : []\n    return onSnapshot(\n      query(\n        collection(firestore, 'orgs', orgId, 'leads'),\n        ...clauses,\n        orderBy('lastSeenAtMs', 'desc'),\n        limit(windowSize + 1),\n      ),\n      (snapshot) => {\n        const rows = snapshot.docs.map((entry) => ({\n          ...(entry.data() as DocumentData),\n          $id: entry.id,\n          leadId: entry.id,\n        }))\n        setAnswer({\n          rows: rows.slice(0, windowSize),\n          truncated: rows.length > windowSize,\n        })\n      },\n      (error) => {\n        console.error(error)\n        setAnswer('error')\n      },\n    )\n  }, [firestore, orgId, scopeKey, windowSize])\n\n  return useMemo(() => {\n    if (answer === 'error') {\n      return { data: [], status: 'error' as const, truncated: false }\n    }\n    if (!answer) return { data: [], status: 'loading' as const, truncated: false }\n    return {\n      data: answer.rows,\n      status: 'success' as const,\n      truncated: answer.truncated,\n    }\n  }, [answer])\n}\n\nexport default useOrgLeads\n"],"names":["useFirestore","collection","limit","onSnapshot","orderBy","query","where","useEffect","useMemo","useState","useOrgLeads","options","orgId","visibleTo","windowSize","firestore","scopeKey","join","answer","setAnswer","undefined","tokens","split","length","rows","truncated","clauses","snapshot","docs","map","entry","data","$id","id","leadId","slice","error","console","status"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,YAAY,QAAQ,iCAAgC;AAC7D,SACEC,UAAU,EACVC,KAAK,EACLC,UAAU,EACVC,OAAO,EACPC,KAAK,EACLC,KAAK,QAGA,qBAAoB;AAC3B,SAASC,SAAS,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,QAAO;AA0BpD;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,SAASC,YAAYC,OAK3B;IACC,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAEC,UAAU,EAAE,GAAGH;IACzC,MAAMI,YAAYf;IAClB,MAAMgB,WAAWH,YAAYA,UAAUI,IAAI,CAAC,QAAQ;IACpD,MAAM,CAACC,QAAQC,UAAU,GAAGV,SAE1B;IAEFF,UAAU;QACRY,UAAU;QACV,IAAI,CAACP,OAAO,OAAOQ;QACnB,0EAA0E;QAC1E,iEAAiE;QACjE,MAAMC,SAASL,aAAa,OAAO,OAAOA,WAAWA,SAASM,KAAK,CAAC,QAAQ,EAAE;QAC9E,IAAID,UAAU,CAACA,OAAOE,MAAM,EAAE;YAC5BJ,UAAU;gBAAEK,MAAM,EAAE;gBAAEC,WAAW;YAAM;YACvC,OAAOL;QACT;QACA,MAAMM,UAA6BL,SAC/B;YAACf,MAAM,aAAa,sBAAsBe;SAAQ,GAClD,EAAE;QACN,OAAOlB,WACLE,MACEJ,WAAWc,WAAW,QAAQH,OAAO,aAClCc,SACHtB,QAAQ,gBAAgB,SACxBF,MAAMY,aAAa,KAErB,CAACa;YACC,MAAMH,OAAOG,SAASC,IAAI,CAACC,GAAG,CAAC,CAACC,QAAW,aACrCA,MAAMC,IAAI;oBACdC,KAAKF,MAAMG,EAAE;oBACbC,QAAQJ,MAAMG,EAAE;;YAElBd,UAAU;gBACRK,MAAMA,KAAKW,KAAK,CAAC,GAAGrB;gBACpBW,WAAWD,KAAKD,MAAM,GAAGT;YAC3B;QACF,GACA,CAACsB;YACCC,QAAQD,KAAK,CAACA;YACdjB,UAAU;QACZ;IAEJ,GAAG;QAACJ;QAAWH;QAAOI;QAAUF;KAAW;IAE3C,OAAON,QAAQ;QACb,IAAIU,WAAW,SAAS;YACtB,OAAO;gBAAEa,MAAM,EAAE;gBAAEO,QAAQ;gBAAkBb,WAAW;YAAM;QAChE;QACA,IAAI,CAACP,QAAQ,OAAO;YAAEa,MAAM,EAAE;YAAEO,QAAQ;YAAoBb,WAAW;QAAM;QAC7E,OAAO;YACLM,MAAMb,OAAOM,IAAI;YACjBc,QAAQ;YACRb,WAAWP,OAAOO,SAAS;QAC7B;IACF,GAAG;QAACP;KAAO;AACb;AAEA,eAAeR,YAAW"}