@aglyn/plugins-crm 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-scope.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  type ConsentGroup,\n  type ConsolePluginPageProps,\n  consentGroupForHost,\n  crmReadTokens,\n  crmScopeTokens,\n  type ScopeToken,\n} from '@aglyn/aglyn'\nimport { useOrgDataScope } from '@aglyn/tenant-feature-instance'\nimport { type QueryConstraint, where } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport { useCrmOrgMount } from './use-crm-org-mount'\n\n/**\n * The org document as a CRM surface receives it: the shell's typed billing\n * projection on a page, or the plain record a card was handed. Read as a\n * record at the one seam below, so no component casts it itself.\n */\nexport type CrmOrgDoc =\n  | ConsolePluginPageProps['org']\n  | Record<string, unknown>\n  | null\n  | undefined\n\n/** Where a CRM surface is mounted: under one site, or over the whole org. */\nexport type CrmScopeLevel = 'site' | 'org'\n\nexport interface CrmScope {\n  /** The org data root, or `null` until the org lookup settles or when there is none. */\n  scope: readonly ['orgs', string] | null\n  /** The owning org, or null while the lookup runs or when there is none. */\n  orgId: string | null\n  /** Whether the org lookup has settled — `orgId` null after this means no org. */\n  ready: boolean\n  /** Under a site, or at the organization level (AGL-2630). */\n  level: CrmScopeLevel\n  /** The mounted site, or `null` at the organization level. */\n  hostId: string | null\n  /**\n   * The controller this surface is being viewed as, or `null` at the org\n   * level, where there is no one viewing site: a cross-holder reader\n   * resolves each contact's own facet instead (`contactPrimaryGroup`).\n   */\n  consentGroup: ConsentGroup | null\n  /**\n   * What this viewer may LIST — every listener's `array-contains-any`\n   * predicate, capped at what the operator accepts — or `null` at the org\n   * level, where an org-wide member's listeners carry NO scope clause: the\n   * rules' `canReadScoped()` short-circuits on `isOrgWideMember()`, so the\n   * clause would only ever narrow what the reader is already allowed. Hand\n   * it to {@link crmVisibleToClause}, which spells both cases. Stable across\n   * renders for the same org and site, so it can sit in a query's\n   * dependency list.\n   */\n  visibleTo: readonly ScopeToken[] | null\n  /**\n   * The site a record this viewer CREATES is captured by: the mounted site,\n   * or at the org level the site the reader picked (`null` until they\n   * have). A create must hold until this is known — the tokens below are\n   * empty without it, and a record stamped with none is visible to nobody.\n   */\n  createHostId: string | null\n  /** The consent group of {@link createHostId} — what a create records consent for. */\n  createGroup: ConsentGroup | null\n  /** What a record this viewer CREATES is stamped with; empty until {@link createHostId} is known. */\n  createTokens: readonly ScopeToken[]\n}\n\nconst NO_TOKENS: readonly ScopeToken[] = Object.freeze([])\n\n/**\n * The scope facts every CRM surface needs, resolved once (AGL-2597, one\n * hook since AGL-2614, two levels since AGL-2630).\n *\n * A CRM surface — a list, a record page, a drawer, a card on somebody\n * else's page — resolves its consent group, builds the token list its\n * listener filters on, builds the tokens a create stamps, and looks up the\n * org root. Every section needs the same answers, and for a while the deals\n * had a hook of their own that answered them under different names\n * (`readTokens` for `visibleTo`), which is two chances to filter by one set\n * of tokens and stamp with another. This is the one place the expression\n * lives: a surface that spelled its own could omit the `'org'` token and\n * stop listing the org-wide records the rules would have let it read.\n *\n * ## Two levels, one call\n *\n * Under a site, `hostId` names it and everything follows from the org\n * document and that id, as it always has. At the ORGANIZATION level the\n * hub hands every surface `hostId: null`, and the org comes from the mount\n * the hub published (`useCrmOrgMount`): the org root is known at once,\n * reads are unscoped, and the site a create stamps from is the one the\n * reader picked. A surface written against `{ scope, visibleTo,\n * createTokens }` serves both levels without knowing which it is on — the\n * two differences it cannot ignore are that `visibleTo` and `consentGroup`\n * are `null` at the org level, and both are typed to say so.\n *\n * `visibleTo` and `createTokens` are different questions with different\n * answers. The first is the union of everything this viewer may see; the\n * second is where a new record lands, which `crmScopeTokens` decides from\n * the org's default and is narrower — a group of one site creates for that\n * site, and reads the org-wide rows beside its own.\n *\n * Pure over the org document the shell already passed, so it costs no read;\n * only the org lookup behind `useOrgDataScope` is asynchronous, and `ready`\n * is how a surface tells \"not yet\" from \"no org\".\n */\nexport function useCrmScope(props: {\n  hostId: string | null | undefined\n  org?: CrmOrgDoc\n}): CrmScope {\n  const hostId = props.hostId || null\n  const org = (props.org ?? null) as Record<string, unknown> | null\n  const mount = useCrmOrgMount()\n  // Under a site the org is looked up from the host index; at the org level\n  // it is the mount's, known at once. A `null` host with no mount is a\n  // surface mounted nowhere, and resolves to no org rather than guessing.\n  const { scope, orgId, ready } = useOrgDataScope(\n    hostId ? { hostId } : { orgId: mount?.orgId },\n  )\n  const level: CrmScopeLevel = hostId ? 'site' : 'org'\n  const consentGroup = useMemo(\n    () => (hostId ? consentGroupForHost(org, hostId) : null),\n    [org, hostId],\n  )\n  const visibleTo = useMemo(\n    () => (consentGroup ? crmReadTokens(consentGroup) : null),\n    [consentGroup],\n  )\n  const createHostId = hostId ?? mount?.createHostId ?? null\n  const createGroup = useMemo(\n    () => (createHostId ? consentGroupForHost(org, createHostId) : null),\n    [org, createHostId],\n  )\n  const createTokens = useMemo(\n    () => (createGroup ? crmScopeTokens(org, createGroup) : NO_TOKENS),\n    [org, createGroup],\n  )\n  return useMemo(\n    () => ({\n      scope,\n      orgId,\n      ready,\n      level,\n      hostId,\n      consentGroup,\n      visibleTo,\n      createHostId,\n      createGroup,\n      createTokens,\n    }),\n    [\n      scope,\n      orgId,\n      ready,\n      level,\n      hostId,\n      consentGroup,\n      visibleTo,\n      createHostId,\n      createGroup,\n      createTokens,\n    ],\n  )\n}\n\n/**\n * The scope clause a CRM listener carries, spelled once for both levels\n * (AGL-2630).\n *\n * Under a site: `where('visibleTo', 'array-contains-any', tokens)`, the\n * predicate the rules evaluate with `hasAny`, which is what makes a\n * filtered query provable per document. At the org level: NOTHING — the\n * reader is an org-wide member, the rules admit them to every row, and a\n * query that kept the clause would need the org's whole site list on it\n * and still miss a site the list did not carry. Spread into the query, so\n * the two cases are one line at every listener: `...crmVisibleToClause(\n * scope.visibleTo)`.\n *\n * A query that drops an `array-contains-any` may need a composite index\n * the scoped form did not: the equality and range clauses beside it stay,\n * and Firestore composes them on their own. The org-level entries live in\n * `cloud/firebase-firestore.indexes.json` beside their scoped twins.\n */\nexport function crmVisibleToClause(\n  visibleTo: readonly ScopeToken[] | readonly string[] | null | undefined,\n): QueryConstraint[] {\n  if (!visibleTo) return []\n  return [where('visibleTo', 'array-contains-any', [...visibleTo])]\n}\n\n/**\n * Whether a listener that filters on `visibleTo` has anything to ask for:\n * `true` at the org level (no clause is a complete question), and under a\n * site only when the token list is non-empty — an `array-contains-any`\n * over nothing is a query Firestore refuses.\n */\nexport function crmScopeListable(\n  visibleTo: readonly ScopeToken[] | readonly string[] | null | undefined,\n): boolean {\n  return visibleTo === null || visibleTo === undefined || visibleTo.length > 0\n}\n\nexport default useCrmScope\n"],"names":["consentGroupForHost","crmReadTokens","crmScopeTokens","useOrgDataScope","where","useMemo","useCrmOrgMount","NO_TOKENS","Object","freeze","useCrmScope","props","hostId","org","mount","scope","orgId","ready","level","consentGroup","visibleTo","createHostId","createGroup","createTokens","crmVisibleToClause","crmScopeListable","undefined","length"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAGEA,mBAAmB,EACnBC,aAAa,EACbC,cAAc,QAET,eAAc;AACrB,SAASC,eAAe,QAAQ,iCAAgC;AAChE,SAA+BC,KAAK,QAAQ,qBAAoB;AAChE,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAASC,cAAc,QAAQ,yBAAqB;AAyDpD,MAAMC,YAAmCC,OAAOC,MAAM,CAAC,EAAE;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,SAASC,YAAYC,KAG3B;QAEcA,YAiBQC;IAlBrB,MAAMA,SAASD,MAAMC,MAAM,IAAI;IAC/B,MAAMC,OAAOF,aAAAA,MAAME,GAAG,YAATF,aAAa;IAC1B,MAAMG,QAAQR;IACd,0EAA0E;IAC1E,qEAAqE;IACrE,wEAAwE;IACxE,MAAM,EAAES,KAAK,EAAEC,KAAK,EAAEC,KAAK,EAAE,GAAGd,gBAC9BS,SAAS;QAAEA;IAAO,IAAI;QAAEI,KAAK,EAAEF,yBAAAA,MAAOE,KAAK;IAAC;IAE9C,MAAME,QAAuBN,SAAS,SAAS;IAC/C,MAAMO,eAAed,QACnB,IAAOO,SAASZ,oBAAoBa,KAAKD,UAAU,MACnD;QAACC;QAAKD;KAAO;IAEf,MAAMQ,YAAYf,QAChB,IAAOc,eAAelB,cAAckB,gBAAgB,MACpD;QAACA;KAAa;IAEhB,MAAME,gBAAeT,OAAAA,iBAAAA,SAAUE,yBAAAA,MAAOO,YAAY,YAA7BT,OAAiC;IACtD,MAAMU,cAAcjB,QAClB,IAAOgB,eAAerB,oBAAoBa,KAAKQ,gBAAgB,MAC/D;QAACR;QAAKQ;KAAa;IAErB,MAAME,eAAelB,QACnB,IAAOiB,cAAcpB,eAAeW,KAAKS,eAAef,WACxD;QAACM;QAAKS;KAAY;IAEpB,OAAOjB,QACL,IAAO,CAAA;YACLU;YACAC;YACAC;YACAC;YACAN;YACAO;YACAC;YACAC;YACAC;YACAC;QACF,CAAA,GACA;QACER;QACAC;QACAC;QACAC;QACAN;QACAO;QACAC;QACAC;QACAC;QACAC;KACD;AAEL;AAEA;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASC,mBACdJ,SAAuE;IAEvE,IAAI,CAACA,WAAW,OAAO,EAAE;IACzB,OAAO;QAAChB,MAAM,aAAa,sBAAsB;eAAIgB;SAAU;KAAE;AACnE;AAEA;;;;;CAKC,GACD,OAAO,SAASK,iBACdL,SAAuE;IAEvE,OAAOA,cAAc,QAAQA,cAAcM,aAAaN,UAAUO,MAAM,GAAG;AAC7E;AAEA,eAAejB,YAAW"}

package/src/lib/hooks/use-crm-tasks.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @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 CrmTask } from '@aglyn/aglyn';
+import { type CrmTaskView } from '../model/task-views';
+/** A task as the console lists it: the document plus its id. */
+export type CrmTaskRow = CrmTask & {
+    $id: string;
+};
+/**
+ * The reader's clock, refreshed once a minute (AGL-2599).
+ *
+ * "Overdue" and "today" are computed at read time against this value, so a
+ * tab left open across midnight repaints yesterday's work red without a
+ * reload. A minute is coarse enough that the re-render is invisible and fine
+ * enough that a task due at 9:00 does not read as upcoming at 9:05.
+ */
+export declare function useNowMs(): number;
+export interface CrmTaskListResult {
+    tasks: CrmTaskRow[];
+    status: 'loading' | 'success' | 'error';
+    /** The rows are unconfirmed by the server — what a guarded write reads. */
+    fromCache: boolean;
+    /** The window filled up; there are tasks this view is not showing. */
+    truncated: boolean;
+    scope: readonly [string, string] | null;
+    orgId: string | null | undefined;
+    /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */
+    readTokens: readonly string[] | null;
+}
+/**
+ * One view of the tasks section as a live, bounded listener.
+ *
+ * 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.
+ */
+export declare function useCrmTaskList(options: {
+    /** The site the list is read under, or `null` at the organization level. */
+    hostId: string | null;
+    org?: Record<string, unknown> | null;
+    view: CrmTaskView;
+    uid: string | null | undefined;
+    nowMs: number;
+}): CrmTaskListResult;
+/**
+ * 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.
+ */
+export declare const CRM_RECORD_TASK_LIMIT = 50;
+/** Which record a task list is FOR — exactly one of the three. */
+export interface CrmRecordRef {
+    contactId?: string;
+    companyId?: string;
+    dealId?: string;
+}
+/**
+ * The tasks that hang off one contact, company or deal, open and done
+ * together, soonest due first.
+ *
+ * Rides the per-record indexes — `(visibleTo, contactId, dueAtMs)` and its
+ * two siblings — with no status clause, because the card shows the open ones
+ * and counts the rest, and two listeners for one short list is one too many.
+ */
+export declare function useCrmRecordTasks(options: {
+    /** The site the record is read under, or `null` at the organization level. */
+    hostId: string | null;
+    org?: Record<string, unknown> | null;
+    record: CrmRecordRef;
+}): CrmTaskListResult;

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

@@ -0,0 +1,153 @@
+/**
+ * @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_COLLECTIONS } from "@aglyn/aglyn";
+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 { crmVisibleToClause, useCrmScope } from "./use-crm-scope.js";
+/**
+ * The reader's clock, refreshed once a minute (AGL-2599).
+ *
+ * "Overdue" and "today" are computed at read time against this value, so a
+ * tab left open across midnight repaints yesterday's work red without a
+ * reload. A minute is coarse enough that the re-render is invisible and fine
+ * enough that a task due at 9:00 does not read as upcoming at 9:05.
+ */ export function useNowMs() {
+    const [nowMs, setNowMs] = useState(()=>Date.now());
+    useEffect(()=>{
+        const timer = setInterval(()=>setNowMs(Date.now()), 60000);
+        return ()=>clearInterval(timer);
+    }, []);
+    return nowMs;
+}
+/**
+ * One view of the tasks section as a live, bounded listener.
+ *
+ * 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.
+ */ export function useCrmTaskList(options) {
+    var _ref;
+    const { hostId, org, view, uid, nowMs } = options;
+    const firestore = useFirestore();
+    // 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.
+    const { scope, orgId, visibleTo: readTokens } = useCrmScope({
+        hostId,
+        org
+    });
+    const plan = useMemo(()=>crmTaskViewPlan(view, {
+            nowMs,
+            uid
+        }), [
+        view,
+        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,
+        plan.direction
+    ], {
+        idField: '$id'
+    });
+    const tasks = useMemo(()=>orderTaskRows(data != null ? data : []), [
+        data
+    ]);
+    return {
+        tasks,
+        status,
+        fromCache,
+        truncated: ((_ref = data == null ? void 0 : data.length) != null ? _ref : 0) >= CRM_TASK_VIEW_LIMIT,
+        scope,
+        orgId,
+        readTokens
+    };
+}
+/**
+ * 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.
+ */ export const CRM_RECORD_TASK_LIMIT = 50;
+/**
+ * The tasks that hang off one contact, company or deal, open and done
+ * together, soonest due first.
+ *
+ * Rides the per-record indexes — `(visibleTo, contactId, dueAtMs)` and its
+ * two siblings — with no status clause, because the card shows the open ones
+ * and counts the rest, and two listeners for one short list is one too many.
+ */ export function useCrmRecordTasks(options) {
+    var _ref;
+    const { hostId, org, record } = options;
+    const firestore = useFirestore();
+    const { scope, orgId, visibleTo: readTokens } = useCrmScope({
+        hostId,
+        org
+    });
+    const field = record.contactId ? 'contactId' : record.companyId ? 'companyId' : record.dealId ? 'dealId' : null;
+    const id = field ? record[field] : undefined;
+    const { data, status, fromCache } = useFirestoreCollection(()=>{
+        if (!scope || !field || !id) return null;
+        return query(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks), ...crmVisibleToClause(readTokens), where(field, '==', id), orderBy('dueAtMs', 'asc'), limit(CRM_RECORD_TASK_LIMIT));
+    }, [
+        firestore,
+        scope,
+        readTokens,
+        field,
+        id
+    ], {
+        idField: '$id'
+    });
+    const tasks = useMemo(()=>orderTaskRows(data != null ? data : []), [
+        data
+    ]);
+    return {
+        tasks,
+        status,
+        fromCache,
+        truncated: ((_ref = data == null ? void 0 : data.length) != null ? _ref : 0) >= CRM_RECORD_TASK_LIMIT,
+        scope,
+        orgId,
+        readTokens
+    };
+}
+
+//# sourceMappingURL=use-crm-tasks.js.map

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

@@ -0,0 +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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"}

package/src/lib/hooks/use-crm-view-grid.d.ts

@@ -0,0 +1,55 @@
+import type { GridColDef, GridColumnVisibilityModel, GridSortModel } from '@mui/x-data-grid';
+import type { CrmSavedViewController } from './use-crm-saved-view';
+/**
+ * The visible columns as the view orders them, and the one way to move one.
+ *
+ * What the column menu's Move left / Move right read and call — see
+ * `crm-column-menu.tsx`. The grid itself cannot reorder a column (the MIT
+ * grid forces `disableColumnReorder`), so the order is the view's to keep
+ * and the hook's to apply.
+ */
+export interface CrmColumnOrder {
+    /** The visible, hideable columns by field, first to last as the grid shows them. */
+    order: readonly string[];
+    /** Swap a column with its visible neighbor: `-1` toward the front, `1` toward the end. */
+    move: (field: string, delta: -1 | 1) => void;
+}
+/**
+ * The grid's columns, column and sort models, as a saved view holds them
+ * (AGL-2617).
+ *
+ * A view stores the VISIBLE columns by field, in order, and one sort; the
+ * grid speaks a column array, a visibility map and a sort array. This is
+ * the one translation, so all five lists hand the grid the same controlled
+ * models and read the same changes back. An empty column list means the
+ * list's own default — every hideable column shown, in the list's order —
+ * and a change that arrives back at that default is stored as the empty
+ * list rather than as a copy of today's columns, so a view saved before a
+ * column existed shows the new column too.
+ *
+ * ## The order is the view's
+ *
+ * `columns` is the caller's list re-arranged: the hideable columns take
+ * the view's order, and a column the list pins (`hideable: false`, an
+ * actions column) keeps the slot it was given. The grid rebuilds its own
+ * order from the array whenever it changes, so handing it the arranged
+ * array IS the reorder — and a change to the visible set keeps the order
+ * the reader had, rather than falling back to the list's.
+ *
+ * `hidden` is what the list keeps out of sight by default — the
+ * filter-only columns the contacts grammar declares, and an optional column
+ * a reader turns on when they want it — and is folded into the default
+ * model, so the empty list means the columns the list opens with rather than
+ * every column it has, and a view that shows an optional column stores it
+ * by name.
+ */
+export declare function useCrmViewGrid(controller: Pick<CrmSavedViewController, 'state' | 'setColumns' | 'setSort'>, columns: readonly GridColDef[], hidden?: Readonly<Record<string, boolean>>): {
+    /** The caller's columns, in the view's order. */
+    columns: GridColDef[];
+    columnVisibilityModel: GridColumnVisibilityModel;
+    onColumnVisibilityModelChange: (model: GridColumnVisibilityModel) => void;
+    columnOrder: CrmColumnOrder;
+    sortModel: GridSortModel;
+    onSortModelChange: (model: GridSortModel) => void;
+};
+export default useCrmViewGrid;

package/src/lib/hooks/use-crm-view-grid.js

@@ -0,0 +1,170 @@
+/**
+ * @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 { useCallback, useMemo } from "react";
+/**
+ * Every hideable field in the view's order: the ones the view names, as it
+ * names them, then the rest in the list's own order.
+ *
+ * A column the view does not name is a hidden one (or one that did not
+ * exist when the view was saved), so its place is invisible until it is
+ * shown — and then it joins after the named ones, which is where the
+ * Manage columns panel listed it. A name the list no longer has is dropped
+ * rather than kept as a phantom slot.
+ */ function orderFields(listFields, named) {
+    const known = new Set(listFields);
+    const placed = named.filter((field)=>known.has(field));
+    if (!placed.length) return [
+        ...listFields
+    ];
+    const taken = new Set(placed);
+    return [
+        ...placed,
+        ...listFields.filter((field)=>!taken.has(field))
+    ];
+}
+const sameOrder = (a, b)=>a.length === b.length && a.every((field, index)=>field === b[index]);
+/**
+ * The grid's columns, column and sort models, as a saved view holds them
+ * (AGL-2617).
+ *
+ * A view stores the VISIBLE columns by field, in order, and one sort; the
+ * grid speaks a column array, a visibility map and a sort array. This is
+ * the one translation, so all five lists hand the grid the same controlled
+ * models and read the same changes back. An empty column list means the
+ * list's own default — every hideable column shown, in the list's order —
+ * and a change that arrives back at that default is stored as the empty
+ * list rather than as a copy of today's columns, so a view saved before a
+ * column existed shows the new column too.
+ *
+ * ## The order is the view's
+ *
+ * `columns` is the caller's list re-arranged: the hideable columns take
+ * the view's order, and a column the list pins (`hideable: false`, an
+ * actions column) keeps the slot it was given. The grid rebuilds its own
+ * order from the array whenever it changes, so handing it the arranged
+ * array IS the reorder — and a change to the visible set keeps the order
+ * the reader had, rather than falling back to the list's.
+ *
+ * `hidden` is what the list keeps out of sight by default — the
+ * filter-only columns the contacts grammar declares, and an optional column
+ * a reader turns on when they want it — and is folded into the default
+ * model, so the empty list means the columns the list opens with rather than
+ * every column it has, and a view that shows an optional column stores it
+ * by name.
+ */ export function useCrmViewGrid(controller, columns, hidden = {}) {
+    const { state, setColumns, setSort } = controller;
+    const hideable = useMemo(()=>columns.filter((column)=>column.hideable !== false).map((column)=>column.field), [
+        columns
+    ]);
+    /** Every hideable field, in the view's order. */ const ordered = useMemo(()=>orderFields(hideable, state.columns), [
+        hideable,
+        state.columns
+    ]);
+    const orderedColumns = useMemo(()=>{
+        const byField = new Map(columns.map((column)=>[
+                column.field,
+                column
+            ]));
+        let next = 0;
+        // A pinned column keeps its slot; each hideable slot is refilled in order.
+        return columns.map((column)=>{
+            var _byField_get;
+            return column.hideable === false ? column : (_byField_get = byField.get(ordered[next++])) != null ? _byField_get : column;
+        });
+    }, [
+        columns,
+        ordered
+    ]);
+    const columnVisibilityModel = useMemo(()=>{
+        const model = _extends({}, hidden);
+        if (!state.columns.length) return model;
+        for (const field of hideable)model[field] = state.columns.includes(field);
+        return model;
+    }, [
+        hidden,
+        state.columns,
+        hideable
+    ]);
+    /** The columns the list opens with: every hideable one not hidden by default, in list order. */ const defaultVisible = useMemo(()=>hideable.filter((field)=>hidden[field] !== false), [
+        hideable,
+        hidden
+    ]);
+    /** The visible columns in the view's order — what a store writes back. */ const visibleInOrder = useMemo(()=>ordered.filter((field)=>columnVisibilityModel[field] !== false), [
+        ordered,
+        columnVisibilityModel
+    ]);
+    const store = useCallback((visible)=>setColumns(sameOrder(visible, defaultVisible) ? [] : visible), [
+        setColumns,
+        defaultVisible
+    ]);
+    const onColumnVisibilityModelChange = useCallback((model)=>{
+        store(ordered.filter((field)=>model[field] !== false));
+    }, [
+        ordered,
+        store
+    ]);
+    const move = useCallback((field, delta)=>{
+        const from = visibleInOrder.indexOf(field);
+        const to = from + delta;
+        if (from === -1 || to < 0 || to >= visibleInOrder.length) return;
+        const next = [
+            ...visibleInOrder
+        ];
+        next[from] = visibleInOrder[to];
+        next[to] = field;
+        store(next);
+    }, [
+        visibleInOrder,
+        store
+    ]);
+    const columnOrder = useMemo(()=>({
+            order: visibleInOrder,
+            move
+        }), [
+        visibleInOrder,
+        move
+    ]);
+    const sortModel = useMemo(()=>state.sort ? [
+            {
+                field: state.sort.field,
+                sort: state.sort.direction
+            }
+        ] : [], [
+        state.sort
+    ]);
+    const onSortModelChange = useCallback((model)=>{
+        const first = model[0];
+        setSort(first && first.sort ? {
+            field: first.field,
+            direction: first.sort === 'desc' ? 'desc' : 'asc'
+        } : null);
+    }, [
+        setSort
+    ]);
+    return {
+        columns: orderedColumns,
+        columnVisibilityModel,
+        onColumnVisibilityModelChange,
+        columnOrder,
+        sortModel,
+        onSortModelChange
+    };
+}
+export default useCrmViewGrid;
+
+//# sourceMappingURL=use-crm-view-grid.js.map

package/src/lib/hooks/use-crm-view-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-crm-view-grid.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 {\n  GridColDef,\n  GridColumnVisibilityModel,\n  GridSortModel,\n} from '@mui/x-data-grid'\nimport { useCallback, useMemo } from 'react'\nimport type { CrmSavedViewController } from './use-crm-saved-view'\n\n/**\n * The visible columns as the view orders them, and the one way to move one.\n *\n * What the column menu's Move left / Move right read and call — see\n * `crm-column-menu.tsx`. The grid itself cannot reorder a column (the MIT\n * grid forces `disableColumnReorder`), so the order is the view's to keep\n * and the hook's to apply.\n */\nexport interface CrmColumnOrder {\n  /** The visible, hideable columns by field, first to last as the grid shows them. */\n  order: readonly string[]\n  /** Swap a column with its visible neighbor: `-1` toward the front, `1` toward the end. */\n  move: (field: string, delta: -1 | 1) => void\n}\n\n/**\n * Every hideable field in the view's order: the ones the view names, as it\n * names them, then the rest in the list's own order.\n *\n * A column the view does not name is a hidden one (or one that did not\n * exist when the view was saved), so its place is invisible until it is\n * shown — and then it joins after the named ones, which is where the\n * Manage columns panel listed it. A name the list no longer has is dropped\n * rather than kept as a phantom slot.\n */\nfunction orderFields(listFields: readonly string[], named: readonly string[]): string[] {\n  const known = new Set(listFields)\n  const placed = named.filter((field) => known.has(field))\n  if (!placed.length) return [...listFields]\n  const taken = new Set(placed)\n  return [...placed, ...listFields.filter((field) => !taken.has(field))]\n}\n\nconst sameOrder = (a: readonly string[], b: readonly string[]): boolean =>\n  a.length === b.length && a.every((field, index) => field === b[index])\n\n/**\n * The grid's columns, column and sort models, as a saved view holds them\n * (AGL-2617).\n *\n * A view stores the VISIBLE columns by field, in order, and one sort; the\n * grid speaks a column array, a visibility map and a sort array. This is\n * the one translation, so all five lists hand the grid the same controlled\n * models and read the same changes back. An empty column list means the\n * list's own default — every hideable column shown, in the list's order —\n * and a change that arrives back at that default is stored as the empty\n * list rather than as a copy of today's columns, so a view saved before a\n * column existed shows the new column too.\n *\n * ## The order is the view's\n *\n * `columns` is the caller's list re-arranged: the hideable columns take\n * the view's order, and a column the list pins (`hideable: false`, an\n * actions column) keeps the slot it was given. The grid rebuilds its own\n * order from the array whenever it changes, so handing it the arranged\n * array IS the reorder — and a change to the visible set keeps the order\n * the reader had, rather than falling back to the list's.\n *\n * `hidden` is what the list keeps out of sight by default — the\n * filter-only columns the contacts grammar declares, and an optional column\n * a reader turns on when they want it — and is folded into the default\n * model, so the empty list means the columns the list opens with rather than\n * every column it has, and a view that shows an optional column stores it\n * by name.\n */\nexport function useCrmViewGrid(\n  controller: Pick<CrmSavedViewController, 'state' | 'setColumns' | 'setSort'>,\n  columns: readonly GridColDef[],\n  hidden: Readonly<Record<string, boolean>> = {},\n): {\n  /** The caller's columns, in the view's order. */\n  columns: GridColDef[]\n  columnVisibilityModel: GridColumnVisibilityModel\n  onColumnVisibilityModelChange: (model: GridColumnVisibilityModel) => void\n  columnOrder: CrmColumnOrder\n  sortModel: GridSortModel\n  onSortModelChange: (model: GridSortModel) => void\n} {\n  const { state, setColumns, setSort } = controller\n  const hideable = useMemo(\n    () => columns.filter((column) => column.hideable !== false).map((column) => column.field),\n    [columns],\n  )\n\n  /** Every hideable field, in the view's order. */\n  const ordered = useMemo(() => orderFields(hideable, state.columns), [hideable, state.columns])\n\n  const orderedColumns = useMemo(() => {\n    const byField = new Map(columns.map((column) => [column.field, column]))\n    let next = 0\n    // A pinned column keeps its slot; each hideable slot is refilled in order.\n    return columns.map((column) =>\n      column.hideable === false ? column : (byField.get(ordered[next++]) ?? column),\n    )\n  }, [columns, ordered])\n\n  const columnVisibilityModel = useMemo<GridColumnVisibilityModel>(() => {\n    const model: GridColumnVisibilityModel = { ...hidden }\n    if (!state.columns.length) return model\n    for (const field of hideable) model[field] = state.columns.includes(field)\n    return model\n  }, [hidden, state.columns, hideable])\n\n  /** The columns the list opens with: every hideable one not hidden by default, in list order. */\n  const defaultVisible = useMemo(\n    () => hideable.filter((field) => hidden[field] !== false),\n    [hideable, hidden],\n  )\n\n  /** The visible columns in the view's order — what a store writes back. */\n  const visibleInOrder = useMemo(\n    () => ordered.filter((field) => columnVisibilityModel[field] !== false),\n    [ordered, columnVisibilityModel],\n  )\n\n  const store = useCallback(\n    (visible: string[]) => setColumns(sameOrder(visible, defaultVisible) ? [] : visible),\n    [setColumns, defaultVisible],\n  )\n\n  const onColumnVisibilityModelChange = useCallback(\n    (model: GridColumnVisibilityModel) => {\n      store(ordered.filter((field) => model[field] !== false))\n    },\n    [ordered, store],\n  )\n\n  const move = useCallback(\n    (field: string, delta: -1 | 1) => {\n      const from = visibleInOrder.indexOf(field)\n      const to = from + delta\n      if (from === -1 || to < 0 || to >= visibleInOrder.length) return\n      const next = [...visibleInOrder]\n      next[from] = visibleInOrder[to]\n      next[to] = field\n      store(next)\n    },\n    [visibleInOrder, store],\n  )\n\n  const columnOrder = useMemo<CrmColumnOrder>(\n    () => ({ order: visibleInOrder, move }),\n    [visibleInOrder, move],\n  )\n\n  const sortModel = useMemo<GridSortModel>(\n    () => (state.sort ? [{ field: state.sort.field, sort: state.sort.direction }] : []),\n    [state.sort],\n  )\n\n  const onSortModelChange = useCallback(\n    (model: GridSortModel) => {\n      const first = model[0]\n      setSort(\n        first && first.sort\n          ? { field: first.field, direction: first.sort === 'desc' ? 'desc' : 'asc' }\n          : null,\n      )\n    },\n    [setSort],\n  )\n\n  return {\n    columns: orderedColumns,\n    columnVisibilityModel,\n    onColumnVisibilityModelChange,\n    columnOrder,\n    sortModel,\n    onSortModelChange,\n  }\n}\n\nexport default useCrmViewGrid\n"],"names":["useCallback","useMemo","orderFields","listFields","named","known","Set","placed","filter","field","has","length","taken","sameOrder","a","b","every","index","useCrmViewGrid","controller","columns","hidden","state","setColumns","setSort","hideable","column","map","ordered","orderedColumns","byField","Map","next","get","columnVisibilityModel","model","includes","defaultVisible","visibleInOrder","store","visible","onColumnVisibilityModelChange","move","delta","from","indexOf","to","columnOrder","order","sortModel","sort","direction","onSortModelChange","first"],"mappings":"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"}

package/src/lib/hooks/use-crm-views.d.ts

@@ -0,0 +1,42 @@
+import { type CrmSavedView, type CrmViewSection } from '@aglyn/aglyn';
+/** One saved view as the menu lists it: the document, held to shape, with its id. */
+export interface CrmSavedViewRow extends CrmSavedView {
+    $id: string;
+}
+/**
+ * The menu's window.
+ *
+ * A LOOKUP, not a list: nothing pages this, a reader opens a menu rather
+ * than walking it, and a hundred named views for one section of one org is
+ * past what anybody scrolls. Bounded so the listen cannot grow with the
+ * org; a view past the window is still reachable by its address, which
+ * resolves through the same rows and so reads as "not listed" rather than
+ * as missing — see the controller.
+ */
+export declare const CRM_VIEWS_LIMIT = 100;
+/**
+ * The saved views of one section, mine and shared (AGL-2617).
+ *
+ * ONE listener, filtered on the reader's own tokens like every CRM read,
+ * narrowed to the section and ordered by name — the `(visibleTo, section,
+ * name)` index. What the rules admit is wider than what the menu shows: a
+ * colleague's private view is readable under the contacts predicate and
+ * hidden here by `crmViewIsListed`, because the privacy of a working
+ * arrangement is a courtesy between colleagues rather than a disclosure
+ * boundary, and a rule per reader would need a query per reader.
+ *
+ * `orderBy('name')` also FILTERS: a view written without a name would be
+ * missing from its own menu. The controller refuses an empty name, which is
+ * the only writer.
+ */
+export declare function useCrmViews(options: {
+    scope: readonly ['orgs', string] | null;
+    /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */
+    visibleTo: readonly string[] | null;
+    section: CrmViewSection;
+    uid: string | null | undefined;
+}): {
+    views: CrmSavedViewRow[];
+    ready: boolean;
+};
+export default useCrmViews;