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

package/src/lib/hooks/use-crm-tasks.js

@@ -17,7 +17,8 @@
 import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
 import { collection, limit, orderBy, query, where } from "firebase/firestore";
 import { useEffect, useMemo, useState } from "react";
-import { CRM_TASK_VIEW_LIMIT, crmTaskViewPlan, orderTaskRows } from "../model/task-views.js";
+import { crmTaskViewBase, crmTaskViewPlan, orderTaskRows, TASK_LIST_DECLARATION } from "../model/task-views.js";
+import { useCrmFoldsScope, useCrmListQuery } from "./use-crm-list-query.js";
 import { crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
 /**
  * The reader's clock, refreshed once a minute (AGL-2599).
@@ -35,17 +36,17 @@ import { crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
     return nowMs;
 }
 /**
- * One view of the tasks section as a live, bounded listener.
+ * One view of the tasks section, PAGED BY ITS QUERY (AGL-3321).
  *
  * The plan comes from `crmTaskViewPlan`, so the hook holds no opinion about
- * what "today" means; it translates a plan into constraints in the order the
- * `crmTasks` indexes are declared and caps the window. "My tasks" opens no
- * listener at all until the reader's uid is known — a query for
- * `assigneeUid == ''` would be a real read that could only answer nothing.
+ * what "today" means; the view's predicates are the query's base beside the
+ * scope clause, and Kind, Priority, Assignee and the search word are planned
+ * onto the same query — every page a page of matches, none narrowed in
+ * memory. "My tasks" opens no listener until the reader's uid is known — a
+ * query for `assigneeUid == ''` would be a real read that could only answer
+ * nothing.
  */ export function useCrmTaskList(options) {
-    var _ref;
-    const { hostId, org, view, uid, nowMs } = options;
-    const firestore = useFirestore();
+    const { hostId, org, view, uid, nowMs, clauses = NO_CLAUSES, search = NO_WORDS } = options;
     // The org root and the reader's tokens from the one scope hook (AGL-2614)
     // — the same expression the contacts list runs, so a task listed beside a
     // contact is scoped by exactly the predicate that admitted the contact.
@@ -61,48 +62,49 @@ import { crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
         nowMs,
         uid
     ]);
-    const { data, status, fromCache } = useFirestoreCollection(()=>{
-        if (!scope) return null;
-        if (plan.assigneeUid !== undefined && !plan.assigneeUid) return null;
-        const constraints = [
-            ...crmVisibleToClause(readTokens),
-            where('status', '==', plan.status)
-        ];
-        if (plan.assigneeUid) {
-            constraints.push(where('assigneeUid', '==', plan.assigneeUid));
-        }
-        if (plan.dueFrom !== undefined) {
-            constraints.push(where('dueAtMs', '>=', plan.dueFrom));
-        }
-        if (plan.dueBefore !== undefined) {
-            constraints.push(where('dueAtMs', '<', plan.dueBefore));
-        }
-        return query(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks), ...constraints, orderBy('dueAtMs', plan.direction), limit(CRM_TASK_VIEW_LIMIT));
-    }, [
-        firestore,
-        scope,
-        readTokens,
-        plan.status,
-        plan.assigneeUid,
-        plan.dueFrom,
-        plan.dueBefore,
+    const base = useMemo(()=>crmTaskViewBase(plan), [
+        plan
+    ]);
+    const sort = useMemo(()=>({
+            path: 'dueAtMs',
+            direction: plan.direction
+        }), [
         plan.direction
-    ], {
-        idField: '$id'
+    ]);
+    const foldsScope = useCrmFoldsScope(orgId, readTokens);
+    const paged = useCrmListQuery({
+        scope,
+        collection: CRM_COLLECTIONS.tasks,
+        visibleTo: readTokens,
+        foldsScope,
+        declaration: TASK_LIST_DECLARATION,
+        clauses,
+        search,
+        sort,
+        base,
+        enabled: plan.assigneeUid === undefined || Boolean(plan.assigneeUid)
     });
-    const tasks = useMemo(()=>orderTaskRows(data != null ? data : []), [
-        data
+    const tasks = useMemo(()=>orderTaskRows(paged.rows), [
+        paged.rows
     ]);
     return {
         tasks,
-        status,
-        fromCache,
-        truncated: ((_ref = data == null ? void 0 : data.length) != null ? _ref : 0) >= CRM_TASK_VIEW_LIMIT,
+        status: paged.status,
+        fromCache: paged.fromCache,
+        truncated: paged.hasMore,
         scope,
         orgId,
-        readTokens
+        readTokens,
+        plan: paged.plan,
+        hasMore: paged.hasMore,
+        page: paged.page,
+        setPage: paged.setPage,
+        pageSize: paged.pageSize,
+        setPageSize: paged.setPageSize
     };
 }
+const NO_CLAUSES = [];
+const NO_WORDS = [];
 /**
  * How many of one record's tasks a card reads. A person with more than fifty
  * open tasks about one contact has a different problem than a short list.

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-tasks.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 { CRM_COLLECTIONS, type CrmTask } from '@aglyn/aglyn'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  limit,\n  orderBy,\n  query,\n  type QueryConstraint,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport {\n  CRM_TASK_VIEW_LIMIT,\n  type CrmTaskView,\n  crmTaskViewPlan,\n  orderTaskRows,\n} from '../model/task-views'\nimport { crmVisibleToClause, useCrmScope } from './use-crm-scope'\n\n/** A task as the console lists it: the document plus its id. */\nexport type CrmTaskRow = CrmTask & { $id: string }\n\n/**\n * The reader's clock, refreshed once a minute (AGL-2599).\n *\n * \"Overdue\" and \"today\" are computed at read time against this value, so a\n * tab left open across midnight repaints yesterday's work red without a\n * reload. A minute is coarse enough that the re-render is invisible and fine\n * enough that a task due at 9:00 does not read as upcoming at 9:05.\n */\nexport function useNowMs(): number {\n  const [nowMs, setNowMs] = useState(() => Date.now())\n  useEffect(() => {\n    const timer = setInterval(() => setNowMs(Date.now()), 60_000)\n    return () => clearInterval(timer)\n  }, [])\n  return nowMs\n}\n\nexport interface CrmTaskListResult {\n  tasks: CrmTaskRow[]\n  status: 'loading' | 'success' | 'error'\n  /** The rows are unconfirmed by the server — what a guarded write reads. */\n  fromCache: boolean\n  /** The window filled up; there are tasks this view is not showing. */\n  truncated: boolean\n  scope: readonly [string, string] | null\n  orgId: string | null | undefined\n  /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */\n  readTokens: readonly string[] | null\n}\n\n/**\n * One view of the tasks section as a live, bounded listener.\n *\n * The plan comes from `crmTaskViewPlan`, so the hook holds no opinion about\n * what \"today\" means; it translates a plan into constraints in the order the\n * `crmTasks` indexes are declared and caps the window. \"My tasks\" opens no\n * listener at all until the reader's uid is known — a query for\n * `assigneeUid == ''` would be a real read that could only answer nothing.\n */\nexport function useCrmTaskList(options: {\n  /** The site the list is read under, or `null` at the organization level. */\n  hostId: string | null\n  org?: Record<string, unknown> | null\n  view: CrmTaskView\n  uid: string | null | undefined\n  nowMs: number\n}): CrmTaskListResult {\n  const { hostId, org, view, uid, nowMs } = options\n  const firestore = useFirestore()\n  // The org root and the reader's tokens from the one scope hook (AGL-2614)\n  // — the same expression the contacts list runs, so a task listed beside a\n  // contact is scoped by exactly the predicate that admitted the contact.\n  const { scope, orgId, visibleTo: readTokens } = useCrmScope({ hostId, org })\n  const plan = useMemo(\n    () => crmTaskViewPlan(view, { nowMs, uid }),\n    [view, nowMs, uid],\n  )\n  const { data, status, fromCache } = useFirestoreCollection<CrmTaskRow>(\n    () => {\n      if (!scope) return null\n      if (plan.assigneeUid !== undefined && !plan.assigneeUid) return null\n      const constraints: QueryConstraint[] = [\n        ...crmVisibleToClause(readTokens),\n        where('status', '==', plan.status),\n      ]\n      if (plan.assigneeUid) {\n        constraints.push(where('assigneeUid', '==', plan.assigneeUid))\n      }\n      if (plan.dueFrom !== undefined) {\n        constraints.push(where('dueAtMs', '>=', plan.dueFrom))\n      }\n      if (plan.dueBefore !== undefined) {\n        constraints.push(where('dueAtMs', '<', plan.dueBefore))\n      }\n      return query(\n        collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks),\n        ...constraints,\n        orderBy('dueAtMs', plan.direction),\n        limit(CRM_TASK_VIEW_LIMIT),\n      )\n    },\n    [\n      firestore,\n      scope,\n      readTokens,\n      plan.status,\n      plan.assigneeUid,\n      plan.dueFrom,\n      plan.dueBefore,\n      plan.direction,\n    ],\n    { idField: '$id' },\n  )\n  const tasks = useMemo(() => orderTaskRows(data ?? []), [data])\n  return {\n    tasks,\n    status,\n    fromCache,\n    truncated: (data?.length ?? 0) >= CRM_TASK_VIEW_LIMIT,\n    scope,\n    orgId,\n    readTokens,\n  }\n}\n\n/**\n * How many of one record's tasks a card reads. A person with more than fifty\n * open tasks about one contact has a different problem than a short list.\n */\nexport const CRM_RECORD_TASK_LIMIT = 50\n\n/** Which record a task list is FOR — exactly one of the three. */\nexport interface CrmRecordRef {\n  contactId?: string\n  companyId?: string\n  dealId?: string\n}\n\n/**\n * The tasks that hang off one contact, company or deal, open and done\n * together, soonest due first.\n *\n * Rides the per-record indexes — `(visibleTo, contactId, dueAtMs)` and its\n * two siblings — with no status clause, because the card shows the open ones\n * and counts the rest, and two listeners for one short list is one too many.\n */\nexport function useCrmRecordTasks(options: {\n  /** The site the record is read under, or `null` at the organization level. */\n  hostId: string | null\n  org?: Record<string, unknown> | null\n  record: CrmRecordRef\n}): CrmTaskListResult {\n  const { hostId, org, record } = options\n  const firestore = useFirestore()\n  const { scope, orgId, visibleTo: readTokens } = useCrmScope({ hostId, org })\n  const field = record.contactId\n    ? 'contactId'\n    : record.companyId\n      ? 'companyId'\n      : record.dealId\n        ? 'dealId'\n        : null\n  const id = field ? record[field] : undefined\n  const { data, status, fromCache } = useFirestoreCollection<CrmTaskRow>(\n    () => {\n      if (!scope || !field || !id) return null\n      return query(\n        collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks),\n        ...crmVisibleToClause(readTokens),\n        where(field, '==', id),\n        orderBy('dueAtMs', 'asc'),\n        limit(CRM_RECORD_TASK_LIMIT),\n      )\n    },\n    [firestore, scope, readTokens, field, id],\n    { idField: '$id' },\n  )\n  const tasks = useMemo(() => orderTaskRows(data ?? []), [data])\n  return {\n    tasks,\n    status,\n    fromCache,\n    truncated: (data?.length ?? 0) >= CRM_RECORD_TASK_LIMIT,\n    scope,\n    orgId,\n    readTokens,\n  }\n}\n"],"names":["CRM_COLLECTIONS","useFirestore","useFirestoreCollection","collection","limit","orderBy","query","where","useEffect","useMemo","useState","CRM_TASK_VIEW_LIMIT","crmTaskViewPlan","orderTaskRows","crmVisibleToClause","useCrmScope","useNowMs","nowMs","setNowMs","Date","now","timer","setInterval","clearInterval","useCrmTaskList","options","hostId","org","view","uid","firestore","scope","orgId","visibleTo","readTokens","plan","data","status","fromCache","assigneeUid","undefined","constraints","push","dueFrom","dueBefore","tasks","direction","idField","truncated","length","CRM_RECORD_TASK_LIMIT","useCrmRecordTasks","record","field","contactId","companyId","dealId","id"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-tasks.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 { CRM_COLLECTIONS, type CrmTask } from '@aglyn/aglyn'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n} from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  limit,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport type { ListFilterRequest } from '@aglyn/shared-ui-jsx/const/list-filter'\nimport type { ListQueryPlan } from '@aglyn/shared-ui-jsx/const/list-query-plan'\nimport {\n  type CrmTaskView,\n  crmTaskViewBase,\n  crmTaskViewPlan,\n  orderTaskRows,\n  TASK_LIST_DECLARATION,\n} from '../model/task-views'\nimport { useCrmFoldsScope, useCrmListQuery } from './use-crm-list-query'\nimport { crmVisibleToClause, useCrmScope } from './use-crm-scope'\n\n/** A task as the console lists it: the document plus its id. */\nexport type CrmTaskRow = CrmTask & { $id: string }\n\n/**\n * The reader's clock, refreshed once a minute (AGL-2599).\n *\n * \"Overdue\" and \"today\" are computed at read time against this value, so a\n * tab left open across midnight repaints yesterday's work red without a\n * reload. A minute is coarse enough that the re-render is invisible and fine\n * enough that a task due at 9:00 does not read as upcoming at 9:05.\n */\nexport function useNowMs(): number {\n  const [nowMs, setNowMs] = useState(() => Date.now())\n  useEffect(() => {\n    const timer = setInterval(() => setNowMs(Date.now()), 60_000)\n    return () => clearInterval(timer)\n  }, [])\n  return nowMs\n}\n\nexport interface CrmTaskListResult {\n  tasks: CrmTaskRow[]\n  status: 'loading' | 'success' | 'error'\n  /** The rows are unconfirmed by the server — what a guarded write reads. */\n  fromCache: boolean\n  /** The window filled up; there are tasks this view is not showing. */\n  truncated: boolean\n  scope: readonly [string, string] | null\n  orgId: string | null | undefined\n  /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */\n  readTokens: readonly string[] | null\n}\n\n/** One page of the tasks list, and what its query held. */\nexport interface CrmTaskPageResult extends CrmTaskListResult {\n  /** What the query holds, what it refused and why (AGL-3321). */\n  plan: ListQueryPlan\n  hasMore: boolean\n  page: number\n  setPage: (page: number) => void\n  pageSize: number\n  setPageSize: (pageSize: number) => void\n}\n\n/**\n * One view of the tasks section, PAGED BY ITS QUERY (AGL-3321).\n *\n * The plan comes from `crmTaskViewPlan`, so the hook holds no opinion about\n * what \"today\" means; the view's predicates are the query's base beside the\n * scope clause, and Kind, Priority, Assignee and the search word are planned\n * onto the same query — every page a page of matches, none narrowed in\n * memory. \"My tasks\" opens no listener until the reader's uid is known — a\n * query for `assigneeUid == ''` would be a real read that could only answer\n * nothing.\n */\nexport function useCrmTaskList(options: {\n  /** The site the list is read under, or `null` at the organization level. */\n  hostId: string | null\n  org?: Record<string, unknown> | null\n  view: CrmTaskView\n  uid: string | null | undefined\n  nowMs: number\n  /** The Filters panel's clauses, the view's own excluded. */\n  clauses?: readonly ListFilterRequest[]\n  search?: readonly string[]\n}): CrmTaskPageResult {\n  const { hostId, org, view, uid, nowMs, clauses = NO_CLAUSES, search = NO_WORDS } = options\n  // The org root and the reader's tokens from the one scope hook (AGL-2614)\n  // — the same expression the contacts list runs, so a task listed beside a\n  // contact is scoped by exactly the predicate that admitted the contact.\n  const { scope, orgId, visibleTo: readTokens } = useCrmScope({ hostId, org })\n  const plan = useMemo(\n    () => crmTaskViewPlan(view, { nowMs, uid }),\n    [view, nowMs, uid],\n  )\n  const base = useMemo(() => crmTaskViewBase(plan), [plan])\n  const sort = useMemo(\n    () => ({ path: 'dueAtMs', direction: plan.direction }),\n    [plan.direction],\n  )\n  const foldsScope = useCrmFoldsScope(orgId, readTokens)\n  const paged = useCrmListQuery<CrmTaskRow>({\n    scope,\n    collection: CRM_COLLECTIONS.tasks,\n    visibleTo: readTokens,\n    foldsScope,\n    declaration: TASK_LIST_DECLARATION,\n    clauses,\n    search,\n    sort,\n    base,\n    enabled: plan.assigneeUid === undefined || Boolean(plan.assigneeUid),\n  })\n  const tasks = useMemo(() => orderTaskRows(paged.rows), [paged.rows])\n  return {\n    tasks,\n    status: paged.status,\n    fromCache: paged.fromCache,\n    truncated: paged.hasMore,\n    scope,\n    orgId,\n    readTokens,\n    plan: paged.plan,\n    hasMore: paged.hasMore,\n    page: paged.page,\n    setPage: paged.setPage,\n    pageSize: paged.pageSize,\n    setPageSize: paged.setPageSize,\n  }\n}\n\nconst NO_CLAUSES: readonly ListFilterRequest[] = []\nconst NO_WORDS: readonly string[] = []\n\n/**\n * How many of one record's tasks a card reads. A person with more than fifty\n * open tasks about one contact has a different problem than a short list.\n */\nexport const CRM_RECORD_TASK_LIMIT = 50\n\n/** Which record a task list is FOR — exactly one of the three. */\nexport interface CrmRecordRef {\n  contactId?: string\n  companyId?: string\n  dealId?: string\n}\n\n/**\n * The tasks that hang off one contact, company or deal, open and done\n * together, soonest due first.\n *\n * Rides the per-record indexes — `(visibleTo, contactId, dueAtMs)` and its\n * two siblings — with no status clause, because the card shows the open ones\n * and counts the rest, and two listeners for one short list is one too many.\n */\nexport function useCrmRecordTasks(options: {\n  /** The site the record is read under, or `null` at the organization level. */\n  hostId: string | null\n  org?: Record<string, unknown> | null\n  record: CrmRecordRef\n}): CrmTaskListResult {\n  const { hostId, org, record } = options\n  const firestore = useFirestore()\n  const { scope, orgId, visibleTo: readTokens } = useCrmScope({ hostId, org })\n  const field = record.contactId\n    ? 'contactId'\n    : record.companyId\n      ? 'companyId'\n      : record.dealId\n        ? 'dealId'\n        : null\n  const id = field ? record[field] : undefined\n  const { data, status, fromCache } = useFirestoreCollection<CrmTaskRow>(\n    () => {\n      if (!scope || !field || !id) return null\n      return query(\n        collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks),\n        ...crmVisibleToClause(readTokens),\n        where(field, '==', id),\n        orderBy('dueAtMs', 'asc'),\n        limit(CRM_RECORD_TASK_LIMIT),\n      )\n    },\n    [firestore, scope, readTokens, field, id],\n    { idField: '$id' },\n  )\n  const tasks = useMemo(() => orderTaskRows(data ?? []), [data])\n  return {\n    tasks,\n    status,\n    fromCache,\n    truncated: (data?.length ?? 0) >= CRM_RECORD_TASK_LIMIT,\n    scope,\n    orgId,\n    readTokens,\n  }\n}\n"],"names":["CRM_COLLECTIONS","useFirestore","useFirestoreCollection","collection","limit","orderBy","query","where","useEffect","useMemo","useState","crmTaskViewBase","crmTaskViewPlan","orderTaskRows","TASK_LIST_DECLARATION","useCrmFoldsScope","useCrmListQuery","crmVisibleToClause","useCrmScope","useNowMs","nowMs","setNowMs","Date","now","timer","setInterval","clearInterval","useCrmTaskList","options","hostId","org","view","uid","clauses","NO_CLAUSES","search","NO_WORDS","scope","orgId","visibleTo","readTokens","plan","base","sort","path","direction","foldsScope","paged","tasks","declaration","enabled","assigneeUid","undefined","Boolean","rows","status","fromCache","truncated","hasMore","page","setPage","pageSize","setPageSize","CRM_RECORD_TASK_LIMIT","useCrmRecordTasks","record","firestore","field","contactId","companyId","dealId","id","data","idField","length"],"mappings":"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"}

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

@@ -2,7 +2,8 @@ import { type CrmDealStatus } from '@aglyn/aglyn';
 import type { DealDoc } from '../model/deal-board-model';
 /**
  * The most open cards one pipeline draws. A board past this is a board
- * nobody reads column by column; the table is paged and reaches the rest.
+ * nobody reads column by column; the table is paged by its query
+ * (`DEAL_LIST_DECLARATION`) and reaches the rest.
  */
 export declare const BOARD_OPEN_LIMIT = 500;
 /** Closed deals shown per closed column when it is expanded. */
@@ -22,39 +23,6 @@ export declare const LINKED_DEALS_LIMIT = 25;
  * updatedAt DESC)` twin of that index.
  */
 export declare function useDealsByStatus(orgId: string | null, readTokens: readonly string[] | null, pipelineId: string | null, status: CrmDealStatus, max: number): import("@aglyn/tenant-feature-instance").UseFirestoreCollectionResult<DealDoc>;
-/**
- * Every deal the viewer may see, paged, optionally narrowed to one status
- * and to one pipeline — the table's read. Four shapes, four indexes:
- * `(visibleTo, updatedAt DESC)`, `(visibleTo, status, updatedAt DESC)`,
- * `(visibleTo, pipelineId, updatedAt DESC)` and
- * `(visibleTo, pipelineId, status, updatedAt DESC)`. At the organization
- * level (AGL-2630) the scope clause is dropped and the same shapes ride
- * their twins without `visibleTo` — `(status, updatedAt DESC)`,
- * `(pipelineId, updatedAt DESC)`, `(pipelineId, status, updatedAt DESC)`;
- * the first shape orders on one field and needs none.
- */
-export declare function usePagedDeals(orgId: string | null, readTokens: readonly string[] | null, status: CrmDealStatus | 'all', pipelineId?: string | null): import("@aglyn/tenant-feature-instance").UsePagedCollectionResult<DealDoc>;
-/**
- * How many deals a table search reads (AGL-3315): the newest by last
- * change, in the table's own scope, status and pipeline, plus one probe row
- * so "there are more" is a fact rather than a guess at the boundary.
- */
-export declare const DEAL_SEARCH_WINDOW = 1000;
-/**
- * The deals a table SEARCH runs over (AGL-3315) — a window, read only while
- * the search box holds something.
- *
- * A search has to find a deal on any page, and it has to find it by a word
- * from the middle of its title: "Acme renewal" is looked for as "renewal".
- * An indexed prefix, the way the companies list searches names, answers
- * only the first word, and word tokens would need every writer and a
- * backfill to agree on them. An organization's deals are counted in the
- * tens or hundreds — the board already reads every open one — so the
- * window is the whole collection for all but the largest, and the table
- * says so when it is not. The query is the table's own, one of the four
- * shapes `usePagedDeals` states, so it rides indexes that already exist.
- */
-export declare function useDealSearchWindow(orgId: string | null, readTokens: readonly string[] | null, status: CrmDealStatus | 'all', pipelineId?: string | null): import("@aglyn/tenant-feature-instance").UseFirestoreCollectionResult<DealDoc>;
 /**
  * The deals that name one contact or one company, for the card on that
  * record's page. `(visibleTo, contactId|companyId, updatedAt DESC)`.

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

@@ -15,12 +15,13 @@
  * limitations under the License.
  */ 'use client';
 import { CRM_COLLECTIONS } from "@aglyn/aglyn";
-import { useFirestore, useFirestoreCollection, useFirestoreDoc, usePagedCollection } from "@aglyn/tenant-feature-instance";
+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";
 /**
  * The most open cards one pipeline draws. A board past this is a board
- * nobody reads column by column; the table is paged and reaches the rest.
+ * nobody reads column by column; the table is paged by its query
+ * (`DEAL_LIST_DECLARATION`) and reaches the rest.
  */ export const BOARD_OPEN_LIMIT = 500;
 /** Closed deals shown per closed column when it is expanded. */ export const BOARD_CLOSED_LIMIT = 50;
 /** Deals listed on a contact's or a company's page. */ export const LINKED_DEALS_LIMIT = 25;
@@ -48,66 +49,6 @@ import { crmScopeListable, crmVisibleToClause } from "./use-crm-scope.js";
         idField: '$id'
     });
 }
-/**
- * Every deal the viewer may see, paged, optionally narrowed to one status
- * and to one pipeline — the table's read. Four shapes, four indexes:
- * `(visibleTo, updatedAt DESC)`, `(visibleTo, status, updatedAt DESC)`,
- * `(visibleTo, pipelineId, updatedAt DESC)` and
- * `(visibleTo, pipelineId, status, updatedAt DESC)`. At the organization
- * level (AGL-2630) the scope clause is dropped and the same shapes ride
- * their twins without `visibleTo` — `(status, updatedAt DESC)`,
- * `(pipelineId, updatedAt DESC)`, `(pipelineId, status, updatedAt DESC)`;
- * the first shape orders on one field and needs none.
- */ export function usePagedDeals(orgId, readTokens, status, pipelineId = null) {
-    const firestore = useFirestore();
-    return usePagedCollection((pageLimit)=>orgId && crmScopeListable(readTokens) ? query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals), ...crmVisibleToClause(readTokens), ...pipelineId ? [
-            where('pipelineId', '==', pipelineId)
-        ] : [], ...status === 'all' ? [] : [
-            where('status', '==', status)
-        ], orderBy('updatedAt', 'desc'), limit(pageLimit)) : null, [
-        firestore,
-        orgId,
-        readTokens,
-        status,
-        pipelineId
-    ], {
-        idField: '$id'
-    });
-}
-/**
- * How many deals a table search reads (AGL-3315): the newest by last
- * change, in the table's own scope, status and pipeline, plus one probe row
- * so "there are more" is a fact rather than a guess at the boundary.
- */ export const DEAL_SEARCH_WINDOW = 1000;
-/**
- * The deals a table SEARCH runs over (AGL-3315) — a window, read only while
- * the search box holds something.
- *
- * A search has to find a deal on any page, and it has to find it by a word
- * from the middle of its title: "Acme renewal" is looked for as "renewal".
- * An indexed prefix, the way the companies list searches names, answers
- * only the first word, and word tokens would need every writer and a
- * backfill to agree on them. An organization's deals are counted in the
- * tens or hundreds — the board already reads every open one — so the
- * window is the whole collection for all but the largest, and the table
- * says so when it is not. The query is the table's own, one of the four
- * shapes `usePagedDeals` states, so it rides indexes that already exist.
- */ export function useDealSearchWindow(orgId, readTokens, status, pipelineId = null) {
-    const firestore = useFirestore();
-    return useFirestoreCollection(()=>orgId && crmScopeListable(readTokens) ? query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals), ...crmVisibleToClause(readTokens), ...pipelineId ? [
-            where('pipelineId', '==', pipelineId)
-        ] : [], ...status === 'all' ? [] : [
-            where('status', '==', status)
-        ], orderBy('updatedAt', 'desc'), limit(DEAL_SEARCH_WINDOW + 1)) : null, [
-        firestore,
-        orgId,
-        readTokens,
-        status,
-        pipelineId
-    ], {
-        idField: '$id'
-    });
-}
 /**
  * The deals that name one contact or one company, for the card on that
  * record's page. `(visibleTo, contactId|companyId, updatedAt DESC)`.

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  usePagedCollection,\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 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 * Every deal the viewer may see, paged, optionally narrowed to one status\n * and to one pipeline — the table's read. Four shapes, four indexes:\n * `(visibleTo, updatedAt DESC)`, `(visibleTo, status, updatedAt DESC)`,\n * `(visibleTo, pipelineId, updatedAt DESC)` and\n * `(visibleTo, pipelineId, status, updatedAt DESC)`. At the organization\n * level (AGL-2630) the scope clause is dropped and the same shapes ride\n * their twins without `visibleTo` — `(status, updatedAt DESC)`,\n * `(pipelineId, updatedAt DESC)`, `(pipelineId, status, updatedAt DESC)`;\n * the first shape orders on one field and needs none.\n */\nexport function usePagedDeals(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  status: CrmDealStatus | 'all',\n  pipelineId: string | null = null,\n) {\n  const firestore = useFirestore()\n  return usePagedCollection<DealDoc>(\n    (pageLimit) =>\n      orgId && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            ...(pipelineId ? [where('pipelineId', '==', pipelineId)] : []),\n            ...(status === 'all' ? [] : [where('status', '==', status)]),\n            orderBy('updatedAt', 'desc'),\n            limit(pageLimit),\n          )\n        : null,\n    [firestore, orgId, readTokens, status, pipelineId],\n    { idField: '$id' },\n  )\n}\n\n/**\n * How many deals a table search reads (AGL-3315): the newest by last\n * change, in the table's own scope, status and pipeline, plus one probe row\n * so \"there are more\" is a fact rather than a guess at the boundary.\n */\nexport const DEAL_SEARCH_WINDOW = 1000\n\n/**\n * The deals a table SEARCH runs over (AGL-3315) — a window, read only while\n * the search box holds something.\n *\n * A search has to find a deal on any page, and it has to find it by a word\n * from the middle of its title: \"Acme renewal\" is looked for as \"renewal\".\n * An indexed prefix, the way the companies list searches names, answers\n * only the first word, and word tokens would need every writer and a\n * backfill to agree on them. An organization's deals are counted in the\n * tens or hundreds — the board already reads every open one — so the\n * window is the whole collection for all but the largest, and the table\n * says so when it is not. The query is the table's own, one of the four\n * shapes `usePagedDeals` states, so it rides indexes that already exist.\n */\nexport function useDealSearchWindow(\n  orgId: string | null,\n  readTokens: readonly string[] | null,\n  status: CrmDealStatus | 'all',\n  pipelineId: string | null = null,\n) {\n  const firestore = useFirestore()\n  return useFirestoreCollection<DealDoc>(\n    () =>\n      orgId && crmScopeListable(readTokens)\n        ? query(\n            collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.deals),\n            ...crmVisibleToClause(readTokens),\n            ...(pipelineId ? [where('pipelineId', '==', pipelineId)] : []),\n            ...(status === 'all' ? [] : [where('status', '==', status)]),\n            orderBy('updatedAt', 'desc'),\n            limit(DEAL_SEARCH_WINDOW + 1),\n          )\n        : null,\n    [firestore, orgId, readTokens, status, pipelineId],\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","usePagedCollection","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","usePagedDeals","pageLimit","DEAL_SEARCH_WINDOW","useDealSearchWindow","useLinkedDeals","link","field","id","contactId","companyId","useDeal","dealId"],"mappings":"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"}
+{"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"}

package/src/lib/model/crm-list-query.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @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 CrmListCollection } from '@aglyn/aglyn';
+import type { ListFilterField, ListFilterRequest } from '@aglyn/shared-ui-jsx/const/list-filter';
+import type { ListFilterOption } from '@aglyn/shared-ui-jsx/const/list-grid-filter';
+import type { ListQueryDeclaration, ListQueryFilter, ListQueryPlan } from '@aglyn/shared-ui-jsx/const/list-query-plan';
+/** Every CRM list's quick search: the tokens every writer stamps. */
+export declare const CRM_LIST_SEARCH: NonNullable<ListQueryDeclaration['search']>;
+/**
+ * The scope clause as the plan's base: `visibleTo array-contains-any` over
+ * the reader's tokens under a site, nothing at the organization level
+ * (`null` tokens), where an org-wide member's listeners carry none.
+ */
+export declare function crmListBase(visibleTo: readonly string[] | null): ListQueryFilter[];
+/** The base's shape, for `listQueryIndexes`: the scope clause is an array clause. */
+export declare const CRM_LIST_BASE_INDEX: readonly [{
+    readonly path: "visibleTo";
+    readonly array: true;
+}];
+/**
+ * The declaration a reader may run.
+ *
+ * Under a site the search folds into the scope clause (`search.scoped`),
+ * and a query without `visibleTo` is one the rules can prove only for an
+ * ORG-WIDE member — `canReadScoped()` short-circuits on it, and for anybody
+ * else inspects `visibleTo`, which the folded query no longer constrains.
+ * A member whose reach is some sites keeps the scope clause, and the plan
+ * refuses their search by name rather than sending a query the rules deny.
+ */
+export declare function crmListDeclarationFor(declaration: ListQueryDeclaration, foldsScope: boolean): ListQueryDeclaration;
+/** How one stored clause is asked: a query clause, or why it cannot be. */
+export type CrmClauseAsked = ListFilterRequest | {
+    refused: string;
+};
+export interface CrmAskedClauses {
+    /** What the plan is asked, in the order the reader set them. */
+    clauses: ListFilterRequest[];
+    /** The stored clause each asked one stands for, index for index. */
+    origins: ListFilterRequest[];
+    /** Stored clauses refused before the plan saw them, with why. */
+    refused: Array<{
+        clause: ListFilterRequest;
+        reason: string;
+    }>;
+}
+/** Every stored clause through `ask`, keeping where each came from. */
+export declare function crmAskClauses(stored: readonly ListFilterRequest[], ask: (clause: ListFilterRequest) => CrmClauseAsked): CrmAskedClauses;
+/**
+ * The plan's refusals and the translation's, each named by the clause the
+ * reader SET, as `ListQueryNotices` takes them — through the platform's one
+ * wording (`listQueryRefusals`), so a notice and its chip read alike.
+ */
+export declare function crmQueryRefusals(plan: Pick<ListQueryPlan, 'refused'>, asked: CrmAskedClauses, context: {
+    fields: readonly ListFilterField[];
+    headers?: Readonly<Record<string, string>>;
+    options?: Readonly<Record<string, readonly ListFilterOption[]>>;
+}): Array<{
+    label: string;
+    reason: string;
+}>;
+/** The comma-separated values of an `isAnyOf`, or the one value of anything else. */
+export declare function crmClauseValues(clause: Pick<ListFilterRequest, 'op' | 'value'>): string[];
+/** One value as `equals`, several as `isAnyOf` — the shape the plan takes a list in. */
+export declare function crmAnyOf(field: string, values: readonly string[]): CrmClauseAsked;
+/** A `select` field: equality and "any of" over stored values, nothing else. */
+export declare function crmSelectField(column: string, path?: string): ListFilterField;
+/**
+ * The list fields a CLIENT edit writes beside its patch (AGL-3321): the
+ * record as the listener holds it with the patch laid over — a `null` or a
+ * sentinel in the patch reads as the field removed — through
+ * `crmListFields`, narrowed to `fields`. A client never writes a field the
+ * rules keep for the server (a lead's `emailStatus`), which is why the
+ * caller names the ones it may.
+ */
+export declare function crmClientListFields(collection: CrmListCollection, record: Readonly<Record<string, unknown>>, patch: Readonly<Record<string, unknown>>, fields: readonly string[]): Record<string, unknown>;
+/** The search fields every CRM record carries — what a client edit of searched text rewrites. */
+export declare const CRM_CLIENT_SEARCH_FIELDS: readonly ["searchTokens", "scopedSearchTokens"];

package/src/lib/model/crm-list-query.js

@@ -0,0 +1,182 @@
+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 { CRM_SCOPED_SEARCH_TOKENS_FIELD, CRM_SEARCH_TOKENS_FIELD, crmListFields } from "@aglyn/aglyn";
+import { scopedSearch } from "@aglyn/aglyn/app-utils/name-search";
+import { listQueryRefusals } from "@aglyn/shared-ui-jsx/components/list-query-notices.component";
+/*
+ * THE CRM LISTS ON THEIR QUERIES (AGL-3321).
+ *
+ * Every CRM list — Leads, Contacts, Companies, Deals, Tasks — declares its
+ * filterable fields, its one order and its search as a
+ * `ListQueryDeclaration`, and `planListQuery` puts every clause and the
+ * search word on ONE Firestore query paged by `useListQuery`. What a query
+ * cannot hold is refused by name (`ListQueryNotices`), never matched over
+ * the rows a page happened to load.
+ *
+ * This module is what the five share: the search every CRM record carries
+ * (`searchTokens`, and `scopedSearchTokens` under a site — see
+ * `crmListFields` in `@aglyn/aglyn`), the scope clause as the plan's base,
+ * a stored clause translated to the one its query asks, and the refusals
+ * read back through the clause the reader set.
+ */ /** Every CRM list's quick search: the tokens every writer stamps. */ export const CRM_LIST_SEARCH = {
+    tokensPath: CRM_SEARCH_TOKENS_FIELD,
+    scoped: scopedSearch(CRM_SCOPED_SEARCH_TOKENS_FIELD)
+};
+/**
+ * The scope clause as the plan's base: `visibleTo array-contains-any` over
+ * the reader's tokens under a site, nothing at the organization level
+ * (`null` tokens), where an org-wide member's listeners carry none.
+ */ export function crmListBase(visibleTo) {
+    return visibleTo ? [
+        {
+            path: 'visibleTo',
+            op: 'array-contains-any',
+            value: [
+                ...visibleTo
+            ]
+        }
+    ] : [];
+}
+/** The base's shape, for `listQueryIndexes`: the scope clause is an array clause. */ export const CRM_LIST_BASE_INDEX = [
+    {
+        path: 'visibleTo',
+        array: true
+    }
+];
+/**
+ * The declaration a reader may run.
+ *
+ * Under a site the search folds into the scope clause (`search.scoped`),
+ * and a query without `visibleTo` is one the rules can prove only for an
+ * ORG-WIDE member — `canReadScoped()` short-circuits on it, and for anybody
+ * else inspects `visibleTo`, which the folded query no longer constrains.
+ * A member whose reach is some sites keeps the scope clause, and the plan
+ * refuses their search by name rather than sending a query the rules deny.
+ */ export function crmListDeclarationFor(declaration, foldsScope) {
+    var _declaration_search;
+    if (foldsScope || !((_declaration_search = declaration.search) == null ? void 0 : _declaration_search.scoped)) return declaration;
+    return _extends({}, declaration, {
+        search: {
+            tokensPath: declaration.search.tokensPath
+        }
+    });
+}
+/** Every stored clause through `ask`, keeping where each came from. */ export function crmAskClauses(stored, ask) {
+    const clauses = [];
+    const origins = [];
+    const refused = [];
+    for (const clause of stored){
+        const asked = ask(clause);
+        if ('refused' in asked) {
+            refused.push({
+                clause,
+                reason: asked.refused
+            });
+        } else {
+            clauses.push(asked);
+            origins.push(clause);
+        }
+    }
+    return {
+        clauses,
+        origins,
+        refused
+    };
+}
+const sameClause = (a, b)=>a.field === b.field && a.op === b.op && a.value === b.value;
+/**
+ * The plan's refusals and the translation's, each named by the clause the
+ * reader SET, as `ListQueryNotices` takes them — through the platform's one
+ * wording (`listQueryRefusals`), so a notice and its chip read alike.
+ */ export function crmQueryRefusals(plan, asked, context) {
+    const planned = plan.refused.map((entry)=>{
+        if (entry.clause === 'search') return entry;
+        const clause = entry.clause;
+        const at = asked.clauses.findIndex((candidate)=>sameClause(candidate, clause));
+        return {
+            clause: at >= 0 ? asked.origins[at] : clause,
+            reason: entry.reason
+        };
+    });
+    return listQueryRefusals([
+        ...asked.refused,
+        ...planned
+    ], context);
+}
+/** The comma-separated values of an `isAnyOf`, or the one value of anything else. */ export function crmClauseValues(clause) {
+    const raw = clause.op === 'isAnyOf' ? clause.value.split(',') : [
+        clause.value
+    ];
+    return [
+        ...new Set(raw.map((value)=>value.trim()).filter(Boolean))
+    ];
+}
+/** One value as `equals`, several as `isAnyOf` — the shape the plan takes a list in. */ export function crmAnyOf(field, values) {
+    const unique = [
+        ...new Set(values)
+    ];
+    if (!unique.length) return {
+        refused: 'no value yet'
+    };
+    return unique.length === 1 ? {
+        field,
+        op: 'equals',
+        value: unique[0]
+    } : {
+        field,
+        op: 'isAnyOf',
+        value: unique.join(',')
+    };
+}
+/** A `select` field: equality and "any of" over stored values, nothing else. */ export function crmSelectField(column, path = column) {
+    return {
+        column,
+        kind: 'exact',
+        path,
+        operators: [
+            'equals',
+            'isAnyOf'
+        ]
+    };
+}
+/**
+ * The list fields a CLIENT edit writes beside its patch (AGL-3321): the
+ * record as the listener holds it with the patch laid over — a `null` or a
+ * sentinel in the patch reads as the field removed — through
+ * `crmListFields`, narrowed to `fields`. A client never writes a field the
+ * rules keep for the server (a lead's `emailStatus`), which is why the
+ * caller names the ones it may.
+ */ export function crmClientListFields(collection, record, patch, fields) {
+    const merged = _extends({}, record);
+    for (const [key, value] of Object.entries(patch)){
+        // A dotted path is a map entry (`custom.tier`), never a searched field.
+        if (key.includes('.')) continue;
+        merged[key] = value === null || isSentinel(value) ? undefined : value;
+    }
+    const computed = crmListFields(collection, merged);
+    return Object.fromEntries(fields.filter((field)=>field in computed).map((field)=>[
+            field,
+            computed[field]
+        ]));
+}
+/** A web-SDK `FieldValue` — `deleteField()`, the one a client edit of these fields sends. */ const isSentinel = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof Date) && typeof value.isEqual === 'function';
+/** The search fields every CRM record carries — what a client edit of searched text rewrites. */ export const CRM_CLIENT_SEARCH_FIELDS = [
+    'searchTokens',
+    'scopedSearchTokens'
+];
+
+//# sourceMappingURL=crm-list-query.js.map