@aglyn/tenant-feature-instance 1.0.0-beta.172 → 1.0.0-beta.174

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/tenant-feature-instance",
-  "version": "1.0.0-beta.172",
+  "version": "1.0.0-beta.174",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,11 +25,11 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.172",
-    "@aglyn/shared-data-enums": "1.0.0-beta.172",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.172",
-    "@aglyn/shared-util-http": "1.0.0-beta.172",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.172",
+    "@aglyn/aglyn": "1.0.0-beta.174",
+    "@aglyn/shared-data-enums": "1.0.0-beta.174",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.174",
+    "@aglyn/shared-util-http": "1.0.0-beta.174",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.174",
     "@swc/helpers": "0.5.23",
     "lodash-es": "^4.18.1"
   },

package/src/lib/hooks/use-host-campaigns.d.ts

@@ -14,14 +14,26 @@ export interface HostCampaignOption {
     /** The campaign window, for a caller that wants to say when it ran. */
     startAtMs?: number | null;
     endAtMs?: number | null;
+    /**
+     * The sites the campaign is placed on, `null` when it is on every site.
+     * Read from its `visibleTo`; an unscoped campaign is on no site (`[]`).
+     */
+    siteIds?: string[] | null;
 }
 export interface HostCampaigns {
     options: HostCampaignOption[];
-    /** The site holds more campaigns than the ceiling offers. */
+    /** The org holds more matching campaigns than the ceiling offers. */
     truncated: boolean;
     /** The read has answered — false while it is still settling or disabled. */
     ready: boolean;
 }
+/**
+ * The picker's shape, from a ceilinged read of campaign containers.
+ *
+ * One mapping for both hooks below, so a campaign reads the same on a site's
+ * picker and on the organization's.
+ */
+export declare function hostCampaignOptions(data: ReadonlyArray<Record<string, unknown>> | null | undefined, ready: boolean): HostCampaigns;
 /**
  * THE SITE'S CAMPAIGNS, for a picker on some other record's page.
  *
@@ -30,6 +42,19 @@ export interface HostCampaigns {
  * the form and contact surfaces that need the same list are two other
  * libraries again. One read, one shape, three callers.
  *
+ * ## The org's campaigns, as this site sees them
+ *
+ * Campaign containers belong to the organization
+ * (`orgs/{orgId}/emailCampaigns`), and each is placed on some of its sites
+ * by its `visibleTo`. A site's picker offers the ones placed on it: `'org'`
+ * (every site) or `host:{hostId}`, which is `scopeTokensForHost`. The clause
+ * is also what makes the read provable for a collaborator scoped to this
+ * site — the rules evaluate `visibleTo` per document on a list, and an
+ * unfiltered query is refused whole rather than narrowed.
+ *
+ * The org comes from the `hostIndex` lookup. Nothing is read until it
+ * answers, and a host with no org settles as ready with no campaigns.
+ *
  * ## It is OFF unless a caller asks
  *
  * `enabled` defaults to false. The picker this feeds sits on a record's own
@@ -45,9 +70,29 @@ export interface HostCampaigns {
  * ordering on a date would not mis-sort the picker, it would DROP the
  * campaigns that have no dates. The labels are sorted by name here, over the
  * whole ceiling rather than a slice of it, which is the one case sorting a
- * window is honest.
+ * window is honest. It is also the one ordering the automatic single-field
+ * index on `visibleTo` serves beside `array-contains-any`, so the query
+ * needs no composite index.
  */
 export declare function useHostCampaigns(hostId: string | undefined, options?: {
     enabled?: boolean;
 }): HostCampaigns;
+/**
+ * THE ORGANIZATION'S CAMPAIGNS, for a picker on an org-level record — a
+ * lead on the org's Leads page, an outbound sequence.
+ *
+ * Every live container, whichever sites it is placed on: the records these
+ * pickers file belong to the organization, and so does the campaign. The
+ * read is unfiltered because the surfaces that call it are the org-level
+ * hubs, whose readers are org-wide members — the rules admit them to every
+ * container, and a `visibleTo` clause would only need the org's whole site
+ * list and still miss a site it did not carry. Each option carries its
+ * `siteIds`, for a caller that wants to say where a campaign runs.
+ *
+ * Off unless a caller asks, and ceilinged and ordered, for the reasons
+ * {@link useHostCampaigns} gives.
+ */
+export declare function useOrgCampaigns(orgId: string | null | undefined, options?: {
+    enabled?: boolean;
+}): HostCampaigns;
 export default useHostCampaigns;

package/src/lib/hooks/use-host-campaigns.js

@@ -14,11 +14,13 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 'use client';
-import { collection } from "firebase/firestore";
+import { hostIdsFromScope, isOrgWideScope, scopeTokensForHost } from "@aglyn/aglyn";
+import { collection, query, where } from "firebase/firestore";
 import { useMemo } from "react";
 import { collectionCeiling } from "./host-collection-queries.js";
 import { useFirestore } from "./firebase/firebase-services.js";
 import { useFirestoreCollection } from "./use-firestore-collection.js";
+import { useHostOrgIdState } from "./use-host-org-id.js";
 /**
  * How many campaigns a picker offers.
  *
@@ -27,6 +29,35 @@ import { useFirestoreCollection } from "./use-firestore-collection.js";
  * larger window would offer campaigns the list they came from does not show;
  * a smaller one would hide campaigns that are plainly there.
  */ export const HOST_CAMPAIGN_CEILING = 50;
+const NO_ROWS = Object.freeze([]);
+/**
+ * The picker's shape, from a ceilinged read of campaign containers.
+ *
+ * One mapping for both hooks below, so a campaign reads the same on a site's
+ * picker and on the organization's.
+ */ export function hostCampaignOptions(data, ready) {
+    const rows = data != null ? data : [];
+    const truncated = rows.length > HOST_CAMPAIGN_CEILING;
+    const live = rows.slice(0, HOST_CAMPAIGN_CEILING)// A campaign the console soft-deleted is not a campaign a record may be
+    // filed under. The campaigns table filters the same field for the same
+    // reason.
+    .filter((row)=>!row['deletedAt']);
+    return {
+        options: live.map((row)=>{
+            var _row_name, _row_startAtMs, _row_endAtMs;
+            const visibleTo = Array.isArray(row['visibleTo']) ? row['visibleTo'] : [];
+            return {
+                value: String(row['$id']),
+                label: String((_row_name = row['name']) != null ? _row_name : row['$id']),
+                startAtMs: (_row_startAtMs = row['startAtMs']) != null ? _row_startAtMs : null,
+                endAtMs: (_row_endAtMs = row['endAtMs']) != null ? _row_endAtMs : null,
+                siteIds: isOrgWideScope(visibleTo) ? null : hostIdsFromScope(visibleTo)
+            };
+        }).sort((a, b)=>a.label.localeCompare(b.label)),
+        truncated,
+        ready
+    };
+}
 /**
  * THE SITE'S CAMPAIGNS, for a picker on some other record's page.
  *
@@ -35,6 +66,19 @@ import { useFirestoreCollection } from "./use-firestore-collection.js";
  * the form and contact surfaces that need the same list are two other
  * libraries again. One read, one shape, three callers.
  *
+ * ## The org's campaigns, as this site sees them
+ *
+ * Campaign containers belong to the organization
+ * (`orgs/{orgId}/emailCampaigns`), and each is placed on some of its sites
+ * by its `visibleTo`. A site's picker offers the ones placed on it: `'org'`
+ * (every site) or `host:{hostId}`, which is `scopeTokensForHost`. The clause
+ * is also what makes the read provable for a collaborator scoped to this
+ * site — the rules evaluate `visibleTo` per document on a list, and an
+ * unfiltered query is refused whole rather than narrowed.
+ *
+ * The org comes from the `hostIndex` lookup. Nothing is read until it
+ * answers, and a host with no org settles as ready with no campaigns.
+ *
  * ## It is OFF unless a caller asks
  *
  * `enabled` defaults to false. The picker this feeds sits on a record's own
@@ -50,42 +94,65 @@ import { useFirestoreCollection } from "./use-firestore-collection.js";
  * ordering on a date would not mis-sort the picker, it would DROP the
  * campaigns that have no dates. The labels are sorted by name here, over the
  * whole ceiling rather than a slice of it, which is the one case sorting a
- * window is honest.
+ * window is honest. It is also the one ordering the automatic single-field
+ * index on `visibleTo` serves beside `array-contains-any`, so the query
+ * needs no composite index.
  */ export function useHostCampaigns(hostId, options) {
     var _ref;
     const enabled = (_ref = options == null ? void 0 : options.enabled) != null ? _ref : false;
     const firestore = useFirestore();
-    const { data, status } = useFirestoreCollection(()=>enabled && hostId ? collectionCeiling(collection(firestore, 'hosts', hostId, 'emailCampaigns'), HOST_CAMPAIGN_CEILING) : null, [
+    const org = useHostOrgIdState(enabled ? hostId : undefined);
+    const orgId = org.orgId;
+    // Memoised: a listener dependency, and a fresh array each render would
+    // reopen the subscription every time.
+    const tokens = useMemo(()=>hostId ? scopeTokensForHost(hostId) : null, [
+        hostId
+    ]);
+    const { data, status } = useFirestoreCollection(()=>enabled && hostId && orgId && tokens ? collectionCeiling(query(collection(firestore, 'orgs', orgId, 'emailCampaigns'), where('visibleTo', 'array-contains-any', tokens)), HOST_CAMPAIGN_CEILING) : null, [
         firestore,
         hostId,
+        orgId,
+        tokens,
+        enabled
+    ], {
+        idField: '$id'
+    });
+    const ready = enabled && Boolean(hostId) && org.loaded && (orgId ? status !== 'loading' : true);
+    return useMemo(()=>hostCampaignOptions(orgId ? data : NO_ROWS, ready), [
+        data,
+        orgId,
+        ready
+    ]);
+}
+/**
+ * THE ORGANIZATION'S CAMPAIGNS, for a picker on an org-level record — a
+ * lead on the org's Leads page, an outbound sequence.
+ *
+ * Every live container, whichever sites it is placed on: the records these
+ * pickers file belong to the organization, and so does the campaign. The
+ * read is unfiltered because the surfaces that call it are the org-level
+ * hubs, whose readers are org-wide members — the rules admit them to every
+ * container, and a `visibleTo` clause would only need the org's whole site
+ * list and still miss a site it did not carry. Each option carries its
+ * `siteIds`, for a caller that wants to say where a campaign runs.
+ *
+ * Off unless a caller asks, and ceilinged and ordered, for the reasons
+ * {@link useHostCampaigns} gives.
+ */ export function useOrgCampaigns(orgId, options) {
+    var _ref;
+    const enabled = (_ref = options == null ? void 0 : options.enabled) != null ? _ref : false;
+    const firestore = useFirestore();
+    const { data, status } = useFirestoreCollection(()=>enabled && orgId ? collectionCeiling(collection(firestore, 'orgs', orgId, 'emailCampaigns'), HOST_CAMPAIGN_CEILING) : null, [
+        firestore,
+        orgId,
         enabled
     ], {
         idField: '$id'
     });
-    return useMemo(()=>{
-        const rows = data != null ? data : [];
-        const truncated = rows.length > HOST_CAMPAIGN_CEILING;
-        const live = rows.slice(0, HOST_CAMPAIGN_CEILING)// A campaign the console soft-deleted is not a campaign a record may be
-        // filed under. The campaigns table filters the same field for the same
-        // reason.
-        .filter((row)=>!row['deletedAt']);
-        return {
-            options: live.map((row)=>{
-                var _row_name, _row_startAtMs, _row_endAtMs;
-                return {
-                    value: String(row['$id']),
-                    label: String((_row_name = row['name']) != null ? _row_name : row['$id']),
-                    startAtMs: (_row_startAtMs = row['startAtMs']) != null ? _row_startAtMs : null,
-                    endAtMs: (_row_endAtMs = row['endAtMs']) != null ? _row_endAtMs : null
-                };
-            }).sort((a, b)=>a.label.localeCompare(b.label)),
-            truncated,
-            ready: enabled && status !== 'loading'
-        };
-    }, [
+    const ready = enabled && Boolean(orgId) && status !== 'loading';
+    return useMemo(()=>hostCampaignOptions(data, ready), [
         data,
-        enabled,
-        status
+        ready
     ]);
 }
 export default useHostCampaigns;

package/src/lib/hooks/use-host-campaigns.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-host-campaigns.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 { collection } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport { collectionCeiling } from './host-collection-queries'\nimport { useFirestore } from './firebase/firebase-services'\nimport { useFirestoreCollection } from './use-firestore-collection'\n\n/**\n * How many campaigns a picker offers.\n *\n * The same fifty the campaigns table draws, so a campaign a merchant can see\n * in the list is a campaign they can file a record under. A picker with a\n * larger window would offer campaigns the list they came from does not show;\n * a smaller one would hide campaigns that are plainly there.\n */\nexport const HOST_CAMPAIGN_CEILING = 50\n\n/** One campaign, as much of it as a picker needs. */\nexport interface HostCampaignOption {\n  value: string\n  label: string\n  /** The campaign window, for a caller that wants to say when it ran. */\n  startAtMs?: number | null\n  endAtMs?: number | null\n}\n\nexport interface HostCampaigns {\n  options: HostCampaignOption[]\n  /** The site holds more campaigns than the ceiling offers. */\n  truncated: boolean\n  /** The read has answered — false while it is still settling or disabled. */\n  ready: boolean\n}\n\n/**\n * THE SITE'S CAMPAIGNS, for a picker on some other record's page.\n *\n * Lives here rather than in the marketing plugin because the console app may\n * not import a feature plugin — a screen's detail page is an app route — and\n * the form and contact surfaces that need the same list are two other\n * libraries again. One read, one shape, three callers.\n *\n * ## It is OFF unless a caller asks\n *\n * `enabled` defaults to false. The picker this feeds sits on a record's own\n * page beside fields a reader came for; charging every open of a form, a\n * screen or a contact for a hundred campaign documents they may not touch is\n * the read-on-mount this console refuses. The callers turn it on when their\n * editing surface opens.\n *\n * ## Ordered on the document name\n *\n * `collectionCeiling`, for the reason it exists: `startAtMs` and `endAtMs`\n * are both optional on a campaign — an open-ended one carries neither — so\n * ordering on a date would not mis-sort the picker, it would DROP the\n * campaigns that have no dates. The labels are sorted by name here, over the\n * whole ceiling rather than a slice of it, which is the one case sorting a\n * window is honest.\n */\nexport function useHostCampaigns(\n  hostId: string | undefined,\n  options?: { enabled?: boolean },\n): HostCampaigns {\n  const enabled = options?.enabled ?? false\n  const firestore = useFirestore()\n  const { data, status } = useFirestoreCollection<Record<string, unknown>>(\n    () =>\n      enabled && hostId\n        ? collectionCeiling(\n            collection(firestore, 'hosts', hostId, 'emailCampaigns'),\n            HOST_CAMPAIGN_CEILING,\n          )\n        : null,\n    [firestore, hostId, enabled],\n    { idField: '$id' },\n  )\n\n  return useMemo(() => {\n    const rows = data ?? []\n    const truncated = rows.length > HOST_CAMPAIGN_CEILING\n    const live = rows\n      .slice(0, HOST_CAMPAIGN_CEILING)\n      // A campaign the console soft-deleted is not a campaign a record may be\n      // filed under. The campaigns table filters the same field for the same\n      // reason.\n      .filter((row) => !row['deletedAt'])\n    return {\n      options: live\n        .map((row) => ({\n          value: String(row['$id']),\n          label: String(row['name'] ?? row['$id']),\n          startAtMs: (row['startAtMs'] as number | null | undefined) ?? null,\n          endAtMs: (row['endAtMs'] as number | null | undefined) ?? null,\n        }))\n        .sort((a, b) => a.label.localeCompare(b.label)),\n      truncated,\n      ready: enabled && status !== 'loading',\n    }\n  }, [data, enabled, status])\n}\n\nexport default useHostCampaigns\n"],"names":["collection","useMemo","collectionCeiling","useFirestore","useFirestoreCollection","HOST_CAMPAIGN_CEILING","useHostCampaigns","hostId","options","enabled","firestore","data","status","idField","rows","truncated","length","live","slice","filter","row","map","value","String","label","startAtMs","endAtMs","sort","a","b","localeCompare","ready"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,UAAU,QAAQ,qBAAoB;AAC/C,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAASC,iBAAiB,QAAQ,+BAA2B;AAC7D,SAASC,YAAY,QAAQ,kCAA8B;AAC3D,SAASC,sBAAsB,QAAQ,gCAA4B;AAEnE;;;;;;;CAOC,GACD,OAAO,MAAMC,wBAAwB,GAAE;AAmBvC;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,iBACdC,MAA0B,EAC1BC,OAA+B;;IAE/B,MAAMC,kBAAUD,2BAAAA,QAASC,OAAO,mBAAI;IACpC,MAAMC,YAAYP;IAClB,MAAM,EAAEQ,IAAI,EAAEC,MAAM,EAAE,GAAGR,uBACvB,IACEK,WAAWF,SACPL,kBACEF,WAAWU,WAAW,SAASH,QAAQ,mBACvCF,yBAEF,MACN;QAACK;QAAWH;QAAQE;KAAQ,EAC5B;QAAEI,SAAS;IAAM;IAGnB,OAAOZ,QAAQ;QACb,MAAMa,OAAOH,eAAAA,OAAQ,EAAE;QACvB,MAAMI,YAAYD,KAAKE,MAAM,GAAGX;QAChC,MAAMY,OAAOH,KACVI,KAAK,CAAC,GAAGb,sBACV,wEAAwE;QACxE,uEAAuE;QACvE,UAAU;SACTc,MAAM,CAAC,CAACC,MAAQ,CAACA,GAAG,CAAC,YAAY;QACpC,OAAO;YACLZ,SAASS,KACNI,GAAG,CAAC,CAACD;oBAEUA,WACFA,gBACFA;uBAJG;oBACbE,OAAOC,OAAOH,GAAG,CAAC,MAAM;oBACxBI,OAAOD,QAAOH,YAAAA,GAAG,CAAC,OAAO,YAAXA,YAAeA,GAAG,CAAC,MAAM;oBACvCK,SAAS,GAAGL,iBAAAA,GAAG,CAAC,YAAY,YAAhBA,iBAAkD;oBAC9DM,OAAO,GAAGN,eAAAA,GAAG,CAAC,UAAU,YAAdA,eAAgD;gBAC5D;eACCO,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAEJ,KAAK,CAACM,aAAa,CAACD,EAAEL,KAAK;YAC/CT;YACAgB,OAAOtB,WAAWG,WAAW;QAC/B;IACF,GAAG;QAACD;QAAMF;QAASG;KAAO;AAC5B;AAEA,eAAeN,iBAAgB"}
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-host-campaigns.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  hostIdsFromScope,\n  isOrgWideScope,\n  scopeTokensForHost,\n} from '@aglyn/aglyn'\nimport { collection, query, where } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport { collectionCeiling } from './host-collection-queries'\nimport { useFirestore } from './firebase/firebase-services'\nimport { useFirestoreCollection } from './use-firestore-collection'\nimport { useHostOrgIdState } from './use-host-org-id'\n\n/**\n * How many campaigns a picker offers.\n *\n * The same fifty the campaigns table draws, so a campaign a merchant can see\n * in the list is a campaign they can file a record under. A picker with a\n * larger window would offer campaigns the list they came from does not show;\n * a smaller one would hide campaigns that are plainly there.\n */\nexport const HOST_CAMPAIGN_CEILING = 50\n\nconst NO_ROWS: ReadonlyArray<Record<string, unknown>> = Object.freeze([])\n\n/** One campaign, as much of it as a picker needs. */\nexport interface HostCampaignOption {\n  value: string\n  label: string\n  /** The campaign window, for a caller that wants to say when it ran. */\n  startAtMs?: number | null\n  endAtMs?: number | null\n  /**\n   * The sites the campaign is placed on, `null` when it is on every site.\n   * Read from its `visibleTo`; an unscoped campaign is on no site (`[]`).\n   */\n  siteIds?: string[] | null\n}\n\nexport interface HostCampaigns {\n  options: HostCampaignOption[]\n  /** The org holds more matching campaigns than the ceiling offers. */\n  truncated: boolean\n  /** The read has answered — false while it is still settling or disabled. */\n  ready: boolean\n}\n\n/**\n * The picker's shape, from a ceilinged read of campaign containers.\n *\n * One mapping for both hooks below, so a campaign reads the same on a site's\n * picker and on the organization's.\n */\nexport function hostCampaignOptions(\n  data: ReadonlyArray<Record<string, unknown>> | null | undefined,\n  ready: boolean,\n): HostCampaigns {\n  const rows = data ?? []\n  const truncated = rows.length > HOST_CAMPAIGN_CEILING\n  const live = rows\n    .slice(0, HOST_CAMPAIGN_CEILING)\n    // A campaign the console soft-deleted is not a campaign a record may be\n    // filed under. The campaigns table filters the same field for the same\n    // reason.\n    .filter((row) => !row['deletedAt'])\n  return {\n    options: live\n      .map((row) => {\n        const visibleTo = Array.isArray(row['visibleTo'])\n          ? (row['visibleTo'] as string[])\n          : []\n        return {\n          value: String(row['$id']),\n          label: String(row['name'] ?? row['$id']),\n          startAtMs: (row['startAtMs'] as number | null | undefined) ?? null,\n          endAtMs: (row['endAtMs'] as number | null | undefined) ?? null,\n          siteIds: isOrgWideScope(visibleTo)\n            ? null\n            : hostIdsFromScope(visibleTo),\n        }\n      })\n      .sort((a, b) => a.label.localeCompare(b.label)),\n    truncated,\n    ready,\n  }\n}\n\n/**\n * THE SITE'S CAMPAIGNS, for a picker on some other record's page.\n *\n * Lives here rather than in the marketing plugin because the console app may\n * not import a feature plugin — a screen's detail page is an app route — and\n * the form and contact surfaces that need the same list are two other\n * libraries again. One read, one shape, three callers.\n *\n * ## The org's campaigns, as this site sees them\n *\n * Campaign containers belong to the organization\n * (`orgs/{orgId}/emailCampaigns`), and each is placed on some of its sites\n * by its `visibleTo`. A site's picker offers the ones placed on it: `'org'`\n * (every site) or `host:{hostId}`, which is `scopeTokensForHost`. The clause\n * is also what makes the read provable for a collaborator scoped to this\n * site — the rules evaluate `visibleTo` per document on a list, and an\n * unfiltered query is refused whole rather than narrowed.\n *\n * The org comes from the `hostIndex` lookup. Nothing is read until it\n * answers, and a host with no org settles as ready with no campaigns.\n *\n * ## It is OFF unless a caller asks\n *\n * `enabled` defaults to false. The picker this feeds sits on a record's own\n * page beside fields a reader came for; charging every open of a form, a\n * screen or a contact for a hundred campaign documents they may not touch is\n * the read-on-mount this console refuses. The callers turn it on when their\n * editing surface opens.\n *\n * ## Ordered on the document name\n *\n * `collectionCeiling`, for the reason it exists: `startAtMs` and `endAtMs`\n * are both optional on a campaign — an open-ended one carries neither — so\n * ordering on a date would not mis-sort the picker, it would DROP the\n * campaigns that have no dates. The labels are sorted by name here, over the\n * whole ceiling rather than a slice of it, which is the one case sorting a\n * window is honest. It is also the one ordering the automatic single-field\n * index on `visibleTo` serves beside `array-contains-any`, so the query\n * needs no composite index.\n */\nexport function useHostCampaigns(\n  hostId: string | undefined,\n  options?: { enabled?: boolean },\n): HostCampaigns {\n  const enabled = options?.enabled ?? false\n  const firestore = useFirestore()\n  const org = useHostOrgIdState(enabled ? hostId : undefined)\n  const orgId = org.orgId\n  // Memoised: a listener dependency, and a fresh array each render would\n  // reopen the subscription every time.\n  const tokens = useMemo(\n    () => (hostId ? scopeTokensForHost(hostId) : null),\n    [hostId],\n  )\n  const { data, status } = useFirestoreCollection<Record<string, unknown>>(\n    () =>\n      enabled && hostId && orgId && tokens\n        ? collectionCeiling(\n            query(\n              collection(firestore, 'orgs', orgId, 'emailCampaigns'),\n              where('visibleTo', 'array-contains-any', tokens),\n            ),\n            HOST_CAMPAIGN_CEILING,\n          )\n        : null,\n    [firestore, hostId, orgId, tokens, enabled],\n    { idField: '$id' },\n  )\n\n  const ready =\n    enabled &&\n    Boolean(hostId) &&\n    org.loaded &&\n    (orgId ? status !== 'loading' : true)\n  return useMemo(\n    () => hostCampaignOptions(orgId ? data : NO_ROWS, ready),\n    [data, orgId, ready],\n  )\n}\n\n/**\n * THE ORGANIZATION'S CAMPAIGNS, for a picker on an org-level record — a\n * lead on the org's Leads page, an outbound sequence.\n *\n * Every live container, whichever sites it is placed on: the records these\n * pickers file belong to the organization, and so does the campaign. The\n * read is unfiltered because the surfaces that call it are the org-level\n * hubs, whose readers are org-wide members — the rules admit them to every\n * container, and a `visibleTo` clause would only need the org's whole site\n * list and still miss a site it did not carry. Each option carries its\n * `siteIds`, for a caller that wants to say where a campaign runs.\n *\n * Off unless a caller asks, and ceilinged and ordered, for the reasons\n * {@link useHostCampaigns} gives.\n */\nexport function useOrgCampaigns(\n  orgId: string | null | undefined,\n  options?: { enabled?: boolean },\n): HostCampaigns {\n  const enabled = options?.enabled ?? false\n  const firestore = useFirestore()\n  const { data, status } = useFirestoreCollection<Record<string, unknown>>(\n    () =>\n      enabled && orgId\n        ? collectionCeiling(\n            collection(firestore, 'orgs', orgId, 'emailCampaigns'),\n            HOST_CAMPAIGN_CEILING,\n          )\n        : null,\n    [firestore, orgId, enabled],\n    { idField: '$id' },\n  )\n\n  const ready = enabled && Boolean(orgId) && status !== 'loading'\n  return useMemo(() => hostCampaignOptions(data, ready), [data, ready])\n}\n\nexport default useHostCampaigns\n"],"names":["hostIdsFromScope","isOrgWideScope","scopeTokensForHost","collection","query","where","useMemo","collectionCeiling","useFirestore","useFirestoreCollection","useHostOrgIdState","HOST_CAMPAIGN_CEILING","NO_ROWS","Object","freeze","hostCampaignOptions","data","ready","rows","truncated","length","live","slice","filter","row","options","map","visibleTo","Array","isArray","value","String","label","startAtMs","endAtMs","siteIds","sort","a","b","localeCompare","useHostCampaigns","hostId","enabled","firestore","org","undefined","orgId","tokens","status","idField","Boolean","loaded","useOrgCampaigns"],"mappings":"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"}