@aglyn/plugins-marketing 1.0.0-beta.198 → 1.0.0-beta.200

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

@@ -0,0 +1,373 @@
+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 { nameSearchKey, nameSearchTokens } from "@aglyn/aglyn/app-utils/name-search";
+import { scopeTokensForHost } from "@aglyn/aglyn/app-utils/scope-tokens";
+/*
+ * WHAT THE MARKETING LISTS ASK FIRESTORE (AGL-3321).
+ *
+ * Three tables read the org's campaign collections — the Campaigns list, a
+ * campaign's own emails, and the Emails list — and every clause their
+ * Filters panels offer, and their search boxes, is a predicate on ONE query,
+ * newest first, paged by that query. Nothing is matched over the rows a read
+ * happened to hold. Each field is here because a query can serve it.
+ *
+ * ## The fields the writers stamp
+ *
+ * A SEND (`orgs/{orgId}/campaigns`) carries:
+ *
+ *   `createdAtMs`      when the record was minted — the one date on every
+ *                      send (a sent one has `sentAt`, a scheduled one
+ *                      `sendAtMs`, a draft neither), so the order;
+ *   `subjectTokens`    the subject's word prefixes, for search and
+ *                      "Subject contains";
+ *   `emailCampaignId`  the container it is filed under, or `null` for a
+ *                      single send — stored null rather than left out,
+ *                      because a query can ask for `== null` and can never
+ *                      ask for a field that is missing.
+ *
+ * A CONTAINER (`orgs/{orgId}/emailCampaigns`) carries `createdAtMs`,
+ * `nameTokens` (the org hub's search) and `nameLower` (a site hub's search,
+ * as a prefix range — below).
+ *
+ * Every writer stamps them through the two helpers below, and
+ * `tools/scripts/backfill-campaign-list-fields.mjs` stamps the records
+ * written before them.
+ *
+ * ## What a site hub asks
+ *
+ * A send is sent AS one site, so a site hub's sends are `hostId == {site}` —
+ * an equality, which merges with every other clause on single-field
+ * indexes and leaves the query's one array clause for search. The security
+ * rules admit that read for the site's collaborators (a send's `hostId` is
+ * the site its `visibleTo` names). A container is placed on SEVERAL sites,
+ * so its scope stays `visibleTo array-contains-any [org, host:{site}]` —
+ * the query's one array clause, and the only one the rules can prove for a
+ * site collaborator. So a site hub's campaign search is not a token lookup:
+ * it is a PREFIX RANGE on `nameLower` beside the scope
+ * (`campaignSiteSearchClause`), which orders the page by name while it
+ * applies, and the list says search matches the start of a name. Folding
+ * the word into the scope clause through scoped tokens would be refused by
+ * the rules for such a reader: that query proves nothing about `visibleTo`.
+ *
+ * ## What is not offered
+ *
+ * - A send's STATE (Sending, Stopped, …) is derived from its counters at
+ *   read time (`campaignSendDisplay`); no query can ask it. Its stored
+ *   `status` is offered instead.
+ * - A campaign's WINDOW (Upcoming, Running, Ended) is derived from its dates
+ *   against the clock; "running" is a range on two fields. Not offered.
+ * - The site NAME a row shows is not stored on the record; the Site filter
+ *   asks by the site's id, and search reads the subject or the name only.
+ * - Ranges: ONE, on `createdAtMs`, the field every list is ordered by — so
+ *   it needs no order of its own and no index beyond the ones above.
+ */ /** The send's subject, as word prefixes. */ export const CAMPAIGN_SEND_SUBJECT_TOKENS = 'subjectTokens';
+/** The container's name, as word prefixes. */ export const CAMPAIGN_NAME_TOKENS = 'nameTokens';
+/** The container's name, lower-cased whole, for a site hub's prefix search. */ export const CAMPAIGN_NAME_LOWER = 'nameLower';
+/** The one date on every send and container, and every list's order. */ export const CAMPAIGN_LIST_ORDER_FIELD = 'createdAtMs';
+/**
+ * The Campaign filter's value for an email filed under no campaign. An
+ * empty value reads as "no value" to the panel, so the choice needs one of
+ * its own; the query asks `emailCampaignId == null` for it.
+ */ export const SINGLE_SEND_FILTER_VALUE = '__single__';
+/**
+ * The search field a send carries beside its `subject`, stamped by every
+ * write that sets the subject.
+ */ export function campaignSendSearchFields(subject) {
+    return {
+        subjectTokens: nameSearchTokens(typeof subject === 'string' ? subject : '')
+    };
+}
+/**
+ * The search fields a container carries beside its `name`, stamped by every
+ * write that sets the name.
+ */ export function campaignContainerSearchFields(name) {
+    const text = typeof name === 'string' ? name : '';
+    return {
+        nameLower: nameSearchKey(text),
+        nameTokens: nameSearchTokens(text)
+    };
+}
+const ORDER = [
+    {
+        path: CAMPAIGN_LIST_ORDER_FIELD,
+        direction: 'desc'
+    }
+];
+const CREATED = {
+    column: CAMPAIGN_LIST_ORDER_FIELD,
+    kind: 'date',
+    path: CAMPAIGN_LIST_ORDER_FIELD,
+    storedAs: 'millis',
+    operators: [
+        'is',
+        'after',
+        'onOrAfter',
+        'before',
+        'onOrBefore'
+    ]
+};
+const SUBJECT = {
+    column: 'subject',
+    kind: 'text',
+    path: 'subject',
+    tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS,
+    operators: [
+        'contains'
+    ]
+};
+const STATUS = {
+    column: 'status',
+    kind: 'exact',
+    path: 'status',
+    operators: [
+        'equals',
+        'isAnyOf'
+    ]
+};
+/**
+ * The stored statuses a send can hold, for the Status filter. Stored
+ * strings, not the State column's display states: an email between batches
+ * is stored `scheduled` and SHOWN as Sending, which is why the filter is
+ * headed Status and not State.
+ */ export const CAMPAIGN_SEND_STATUS_OPTIONS = [
+    {
+        value: 'draft',
+        label: 'Draft'
+    },
+    {
+        value: 'scheduled',
+        label: 'Scheduled'
+    },
+    {
+        value: 'sending',
+        label: 'Sending'
+    },
+    {
+        value: 'sent',
+        label: 'Sent'
+    },
+    {
+        value: 'canceled',
+        label: 'Canceled'
+    },
+    {
+        value: 'failed',
+        label: 'Failed'
+    }
+];
+/**
+ * The Emails list: every send, under a site or across the org.
+ *
+ * `site` is the org hub's only — under a site every row is that site's.
+ */ export function campaignEmailsListQuery(orgHub) {
+    return orgHub ? EMAILS_ORG : EMAILS_SITE;
+}
+const EMAIL_CAMPAIGN = {
+    column: 'emailCampaignId',
+    kind: 'exact',
+    path: 'emailCampaignId',
+    presence: 'nullable',
+    // `is` only: "Single send" is `== null`, which cannot sit in an `in`
+    // beside campaign ids.
+    operators: [
+        'equals',
+        'isEmpty'
+    ]
+};
+const EMAILS_SITE = {
+    fields: [
+        SUBJECT,
+        STATUS,
+        EMAIL_CAMPAIGN,
+        CREATED
+    ],
+    sorts: ORDER,
+    search: {
+        tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS
+    }
+};
+const EMAILS_ORG = _extends({}, EMAILS_SITE, {
+    fields: [
+        ...EMAILS_SITE.fields,
+        {
+            column: 'site',
+            kind: 'exact',
+            path: 'hostId',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        }
+    ]
+});
+/** A campaign's own emails: the container is the query's base. */ export const CAMPAIGN_EMAILS_QUERY = {
+    fields: [
+        SUBJECT,
+        STATUS,
+        CREATED
+    ],
+    sorts: ORDER,
+    search: {
+        tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS
+    }
+};
+/**
+ * The Campaigns list's CAMPAIGNS: the containers. The columns are the
+ * table's (`name`, `listIds`, `sitesLabel`); Lists and Sites are the org
+ * hub's only — under a site the scope clause is the query's one array
+ * clause, so an any-of on another array could never be served beside it.
+ */ export function campaignContainersListQuery(orgHub) {
+    return orgHub ? CONTAINERS_ORG : CONTAINERS_SITE;
+}
+const CONTAINER_NAME = {
+    column: 'name',
+    kind: 'text',
+    path: 'name',
+    tokensPath: CAMPAIGN_NAME_TOKENS,
+    operators: [
+        'contains'
+    ]
+};
+/** A site hub's Campaign field: the name's start, a range beside the scope. */ const CONTAINER_NAME_PREFIX = {
+    column: 'name',
+    kind: 'text',
+    path: 'name',
+    lowerPath: CAMPAIGN_NAME_LOWER,
+    operators: [
+        'startsWith'
+    ]
+};
+const CONTAINERS_SITE = {
+    fields: [
+        CONTAINER_NAME_PREFIX,
+        CREATED
+    ],
+    sorts: ORDER
+};
+const CONTAINERS_ORG = {
+    sorts: ORDER,
+    search: {
+        tokensPath: CAMPAIGN_NAME_TOKENS
+    },
+    fields: [
+        CONTAINER_NAME,
+        {
+            column: 'listIds',
+            kind: 'exact',
+            path: 'listIds',
+            tokensPath: 'listIds',
+            operators: [
+                'isAnyOf'
+            ]
+        },
+        // Asked by scope token — `org` is "every site", `host:{id}` one site.
+        {
+            column: 'sitesLabel',
+            kind: 'exact',
+            path: 'visibleTo',
+            tokensPath: 'visibleTo',
+            operators: [
+                'isAnyOf'
+            ]
+        },
+        CREATED
+    ]
+};
+/**
+ * The Campaigns list's SINGLE SENDS: sends filed under no campaign, drawn
+ * in the same table. The `name` column is the send's subject; `sitesLabel`
+ * is the site it was sent as, on the org hub.
+ */ export function campaignSingleSendsListQuery(orgHub) {
+    return orgHub ? SINGLE_ORG : SINGLE_SITE;
+}
+const SINGLE_NAME = _extends({}, SUBJECT, {
+    column: 'name'
+});
+const SINGLE_SITE = {
+    fields: [
+        SINGLE_NAME,
+        CREATED
+    ],
+    sorts: ORDER,
+    search: {
+        tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS
+    }
+};
+const SINGLE_ORG = _extends({}, SINGLE_SITE, {
+    fields: [
+        SINGLE_NAME,
+        {
+            column: 'sitesLabel',
+            kind: 'exact',
+            path: 'hostId',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        },
+        CREATED
+    ]
+});
+/** A site hub's sends: the ones sent as it. Nothing on the org hub. */ export function campaignSendsScope(hostId) {
+    return hostId ? [
+        {
+            path: 'hostId',
+            op: '==',
+            value: hostId
+        }
+    ] : [];
+}
+/** Said above a site hub's campaigns while its search is applied. */ export const CAMPAIGN_SITE_SEARCH_NOTICE = 'Search on a site’s campaigns matches the start of a campaign’s name.';
+/**
+ * A site hub's campaign search, as the clause its query can serve: the typed
+ * words as "Campaign starts with", or null when nothing was typed. The list
+ * passes it among its clauses and no search words — see the file header for
+ * why a site's search is a prefix range and not a token lookup.
+ */ export function campaignSiteSearchClause(words) {
+    const typed = words.map((word)=>word.trim()).filter(Boolean).join(' ');
+    return typed ? {
+        field: 'name',
+        op: 'startsWith',
+        value: typed
+    } : null;
+}
+/** A site hub's containers: the ones placed on every site or on it. */ export function campaignContainersScope(hostId) {
+    return hostId ? [
+        {
+            path: 'visibleTo',
+            op: 'array-contains-any',
+            value: scopeTokensForHost(hostId)
+        }
+    ] : [];
+}
+/** The sends filed under no campaign. */ export const SINGLE_SENDS_BASE = {
+    path: 'emailCampaignId',
+    op: '==',
+    value: null
+};
+/**
+ * The Campaign filter's clauses as the query asks them: "Single send" is
+ * `emailCampaignId == null`, which the grammar spells `isEmpty`. The chips
+ * keep reading the clause as the reader set it.
+ */ export function emailCampaignQueryClauses(clauses) {
+    return clauses.map((clause)=>clause.field === 'emailCampaignId' && clause.op === 'equals' && clause.value === SINGLE_SEND_FILTER_VALUE ? _extends({}, clause, {
+            op: 'isEmpty',
+            value: ''
+        }) : clause);
+}
+
+//# sourceMappingURL=campaign-list-query.js.map

package/src/lib/model/campaign-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/campaign-list-query.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 { nameSearchKey, nameSearchTokens } from '@aglyn/aglyn/app-utils/name-search'\nimport { scopeTokensForHost } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport type { ListFilterField } from '@aglyn/shared-ui-jsx/const/list-filter'\nimport type { ListFilterClause } from '@aglyn/shared-ui-jsx/const/list-grid-filter'\nimport type {\n  ListQueryDeclaration,\n  ListQueryFilter,\n} from '@aglyn/shared-ui-jsx/const/list-query-plan'\n\n/*\n * WHAT THE MARKETING LISTS ASK FIRESTORE (AGL-3321).\n *\n * Three tables read the org's campaign collections — the Campaigns list, a\n * campaign's own emails, and the Emails list — and every clause their\n * Filters panels offer, and their search boxes, is a predicate on ONE query,\n * newest first, paged by that query. Nothing is matched over the rows a read\n * happened to hold. Each field is here because a query can serve it.\n *\n * ## The fields the writers stamp\n *\n * A SEND (`orgs/{orgId}/campaigns`) carries:\n *\n *   `createdAtMs`      when the record was minted — the one date on every\n *                      send (a sent one has `sentAt`, a scheduled one\n *                      `sendAtMs`, a draft neither), so the order;\n *   `subjectTokens`    the subject's word prefixes, for search and\n *                      \"Subject contains\";\n *   `emailCampaignId`  the container it is filed under, or `null` for a\n *                      single send — stored null rather than left out,\n *                      because a query can ask for `== null` and can never\n *                      ask for a field that is missing.\n *\n * A CONTAINER (`orgs/{orgId}/emailCampaigns`) carries `createdAtMs`,\n * `nameTokens` (the org hub's search) and `nameLower` (a site hub's search,\n * as a prefix range — below).\n *\n * Every writer stamps them through the two helpers below, and\n * `tools/scripts/backfill-campaign-list-fields.mjs` stamps the records\n * written before them.\n *\n * ## What a site hub asks\n *\n * A send is sent AS one site, so a site hub's sends are `hostId == {site}` —\n * an equality, which merges with every other clause on single-field\n * indexes and leaves the query's one array clause for search. The security\n * rules admit that read for the site's collaborators (a send's `hostId` is\n * the site its `visibleTo` names). A container is placed on SEVERAL sites,\n * so its scope stays `visibleTo array-contains-any [org, host:{site}]` —\n * the query's one array clause, and the only one the rules can prove for a\n * site collaborator. So a site hub's campaign search is not a token lookup:\n * it is a PREFIX RANGE on `nameLower` beside the scope\n * (`campaignSiteSearchClause`), which orders the page by name while it\n * applies, and the list says search matches the start of a name. Folding\n * the word into the scope clause through scoped tokens would be refused by\n * the rules for such a reader: that query proves nothing about `visibleTo`.\n *\n * ## What is not offered\n *\n * - A send's STATE (Sending, Stopped, …) is derived from its counters at\n *   read time (`campaignSendDisplay`); no query can ask it. Its stored\n *   `status` is offered instead.\n * - A campaign's WINDOW (Upcoming, Running, Ended) is derived from its dates\n *   against the clock; \"running\" is a range on two fields. Not offered.\n * - The site NAME a row shows is not stored on the record; the Site filter\n *   asks by the site's id, and search reads the subject or the name only.\n * - Ranges: ONE, on `createdAtMs`, the field every list is ordered by — so\n *   it needs no order of its own and no index beyond the ones above.\n */\n\n/** The send's subject, as word prefixes. */\nexport const CAMPAIGN_SEND_SUBJECT_TOKENS = 'subjectTokens'\n/** The container's name, as word prefixes. */\nexport const CAMPAIGN_NAME_TOKENS = 'nameTokens'\n/** The container's name, lower-cased whole, for a site hub's prefix search. */\nexport const CAMPAIGN_NAME_LOWER = 'nameLower'\n/** The one date on every send and container, and every list's order. */\nexport const CAMPAIGN_LIST_ORDER_FIELD = 'createdAtMs'\n\n/**\n * The Campaign filter's value for an email filed under no campaign. An\n * empty value reads as \"no value\" to the panel, so the choice needs one of\n * its own; the query asks `emailCampaignId == null` for it.\n */\nexport const SINGLE_SEND_FILTER_VALUE = '__single__'\n\n/**\n * The search field a send carries beside its `subject`, stamped by every\n * write that sets the subject.\n */\nexport function campaignSendSearchFields(subject: unknown): {\n  subjectTokens: string[]\n} {\n  return {\n    subjectTokens: nameSearchTokens(typeof subject === 'string' ? subject : ''),\n  }\n}\n\n/**\n * The search fields a container carries beside its `name`, stamped by every\n * write that sets the name.\n */\nexport function campaignContainerSearchFields(name: unknown): {\n  nameLower: string\n  nameTokens: string[]\n} {\n  const text = typeof name === 'string' ? name : ''\n  return { nameLower: nameSearchKey(text), nameTokens: nameSearchTokens(text) }\n}\n\nconst ORDER = [{ path: CAMPAIGN_LIST_ORDER_FIELD, direction: 'desc' as const }]\n\nconst CREATED: ListFilterField = {\n  column: CAMPAIGN_LIST_ORDER_FIELD,\n  kind: 'date',\n  path: CAMPAIGN_LIST_ORDER_FIELD,\n  storedAs: 'millis',\n  operators: ['is', 'after', 'onOrAfter', 'before', 'onOrBefore'],\n}\n\nconst SUBJECT: ListFilterField = {\n  column: 'subject',\n  kind: 'text',\n  path: 'subject',\n  tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS,\n  operators: ['contains'],\n}\n\nconst STATUS: ListFilterField = {\n  column: 'status',\n  kind: 'exact',\n  path: 'status',\n  operators: ['equals', 'isAnyOf'],\n}\n\n/**\n * The stored statuses a send can hold, for the Status filter. Stored\n * strings, not the State column's display states: an email between batches\n * is stored `scheduled` and SHOWN as Sending, which is why the filter is\n * headed Status and not State.\n */\nexport const CAMPAIGN_SEND_STATUS_OPTIONS: ReadonlyArray<{ value: string; label: string }> = [\n  { value: 'draft', label: 'Draft' },\n  { value: 'scheduled', label: 'Scheduled' },\n  { value: 'sending', label: 'Sending' },\n  { value: 'sent', label: 'Sent' },\n  { value: 'canceled', label: 'Canceled' },\n  { value: 'failed', label: 'Failed' },\n]\n\n/**\n * The Emails list: every send, under a site or across the org.\n *\n * `site` is the org hub's only — under a site every row is that site's.\n */\nexport function campaignEmailsListQuery(orgHub: boolean): ListQueryDeclaration {\n  return orgHub ? EMAILS_ORG : EMAILS_SITE\n}\n\nconst EMAIL_CAMPAIGN: ListFilterField = {\n  column: 'emailCampaignId',\n  kind: 'exact',\n  path: 'emailCampaignId',\n  presence: 'nullable',\n  // `is` only: \"Single send\" is `== null`, which cannot sit in an `in`\n  // beside campaign ids.\n  operators: ['equals', 'isEmpty'],\n}\n\nconst EMAILS_SITE: ListQueryDeclaration = {\n  fields: [SUBJECT, STATUS, EMAIL_CAMPAIGN, CREATED],\n  sorts: ORDER,\n  search: { tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS },\n}\nconst EMAILS_ORG: ListQueryDeclaration = {\n  ...EMAILS_SITE,\n  fields: [\n    ...EMAILS_SITE.fields,\n    { column: 'site', kind: 'exact', path: 'hostId', operators: ['equals', 'isAnyOf'] },\n  ],\n}\n\n/** A campaign's own emails: the container is the query's base. */\nexport const CAMPAIGN_EMAILS_QUERY: ListQueryDeclaration = {\n  fields: [SUBJECT, STATUS, CREATED],\n  sorts: ORDER,\n  search: { tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS },\n}\n\n/**\n * The Campaigns list's CAMPAIGNS: the containers. The columns are the\n * table's (`name`, `listIds`, `sitesLabel`); Lists and Sites are the org\n * hub's only — under a site the scope clause is the query's one array\n * clause, so an any-of on another array could never be served beside it.\n */\nexport function campaignContainersListQuery(orgHub: boolean): ListQueryDeclaration {\n  return orgHub ? CONTAINERS_ORG : CONTAINERS_SITE\n}\n\nconst CONTAINER_NAME: ListFilterField = {\n  column: 'name',\n  kind: 'text',\n  path: 'name',\n  tokensPath: CAMPAIGN_NAME_TOKENS,\n  operators: ['contains'],\n}\n/** A site hub's Campaign field: the name's start, a range beside the scope. */\nconst CONTAINER_NAME_PREFIX: ListFilterField = {\n  column: 'name',\n  kind: 'text',\n  path: 'name',\n  lowerPath: CAMPAIGN_NAME_LOWER,\n  operators: ['startsWith'],\n}\nconst CONTAINERS_SITE: ListQueryDeclaration = {\n  fields: [CONTAINER_NAME_PREFIX, CREATED],\n  sorts: ORDER,\n}\nconst CONTAINERS_ORG: ListQueryDeclaration = {\n  sorts: ORDER,\n  search: { tokensPath: CAMPAIGN_NAME_TOKENS },\n  fields: [\n    CONTAINER_NAME,\n    { column: 'listIds', kind: 'exact', path: 'listIds', tokensPath: 'listIds', operators: ['isAnyOf'] },\n    // Asked by scope token — `org` is \"every site\", `host:{id}` one site.\n    { column: 'sitesLabel', kind: 'exact', path: 'visibleTo', tokensPath: 'visibleTo', operators: ['isAnyOf'] },\n    CREATED,\n  ],\n}\n\n/**\n * The Campaigns list's SINGLE SENDS: sends filed under no campaign, drawn\n * in the same table. The `name` column is the send's subject; `sitesLabel`\n * is the site it was sent as, on the org hub.\n */\nexport function campaignSingleSendsListQuery(orgHub: boolean): ListQueryDeclaration {\n  return orgHub ? SINGLE_ORG : SINGLE_SITE\n}\n\nconst SINGLE_NAME: ListFilterField = { ...SUBJECT, column: 'name' }\nconst SINGLE_SITE: ListQueryDeclaration = {\n  fields: [SINGLE_NAME, CREATED],\n  sorts: ORDER,\n  search: { tokensPath: CAMPAIGN_SEND_SUBJECT_TOKENS },\n}\nconst SINGLE_ORG: ListQueryDeclaration = {\n  ...SINGLE_SITE,\n  fields: [\n    SINGLE_NAME,\n    { column: 'sitesLabel', kind: 'exact', path: 'hostId', operators: ['equals', 'isAnyOf'] },\n    CREATED,\n  ],\n}\n\n/** A site hub's sends: the ones sent as it. Nothing on the org hub. */\nexport function campaignSendsScope(hostId: string | null): ListQueryFilter[] {\n  return hostId ? [{ path: 'hostId', op: '==', value: hostId }] : []\n}\n\n/** Said above a site hub's campaigns while its search is applied. */\nexport const CAMPAIGN_SITE_SEARCH_NOTICE =\n  'Search on a site’s campaigns matches the start of a campaign’s name.'\n\n/**\n * A site hub's campaign search, as the clause its query can serve: the typed\n * words as \"Campaign starts with\", or null when nothing was typed. The list\n * passes it among its clauses and no search words — see the file header for\n * why a site's search is a prefix range and not a token lookup.\n */\nexport function campaignSiteSearchClause(\n  words: readonly string[],\n): ListFilterClause | null {\n  const typed = words.map((word) => word.trim()).filter(Boolean).join(' ')\n  return typed ? { field: 'name', op: 'startsWith', value: typed } : null\n}\n\n/** A site hub's containers: the ones placed on every site or on it. */\nexport function campaignContainersScope(hostId: string | null): ListQueryFilter[] {\n  return hostId\n    ? [{ path: 'visibleTo', op: 'array-contains-any', value: scopeTokensForHost(hostId) }]\n    : []\n}\n\n/** The sends filed under no campaign. */\nexport const SINGLE_SENDS_BASE: ListQueryFilter = {\n  path: 'emailCampaignId',\n  op: '==',\n  value: null,\n}\n\n/**\n * The Campaign filter's clauses as the query asks them: \"Single send\" is\n * `emailCampaignId == null`, which the grammar spells `isEmpty`. The chips\n * keep reading the clause as the reader set it.\n */\nexport function emailCampaignQueryClauses(\n  clauses: readonly ListFilterClause[],\n): ListFilterClause[] {\n  return clauses.map((clause) =>\n    clause.field === 'emailCampaignId' &&\n    clause.op === 'equals' &&\n    clause.value === SINGLE_SEND_FILTER_VALUE\n      ? { ...clause, op: 'isEmpty', value: '' }\n      : clause,\n  )\n}\n"],"names":["nameSearchKey","nameSearchTokens","scopeTokensForHost","CAMPAIGN_SEND_SUBJECT_TOKENS","CAMPAIGN_NAME_TOKENS","CAMPAIGN_NAME_LOWER","CAMPAIGN_LIST_ORDER_FIELD","SINGLE_SEND_FILTER_VALUE","campaignSendSearchFields","subject","subjectTokens","campaignContainerSearchFields","name","text","nameLower","nameTokens","ORDER","path","direction","CREATED","column","kind","storedAs","operators","SUBJECT","tokensPath","STATUS","CAMPAIGN_SEND_STATUS_OPTIONS","value","label","campaignEmailsListQuery","orgHub","EMAILS_ORG","EMAILS_SITE","EMAIL_CAMPAIGN","presence","fields","sorts","search","CAMPAIGN_EMAILS_QUERY","campaignContainersListQuery","CONTAINERS_ORG","CONTAINERS_SITE","CONTAINER_NAME","CONTAINER_NAME_PREFIX","lowerPath","campaignSingleSendsListQuery","SINGLE_ORG","SINGLE_SITE","SINGLE_NAME","campaignSendsScope","hostId","op","CAMPAIGN_SITE_SEARCH_NOTICE","campaignSiteSearchClause","words","typed","map","word","trim","filter","Boolean","join","field","campaignContainersScope","SINGLE_SENDS_BASE","emailCampaignQueryClauses","clauses","clause"],"mappings":"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"}

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

@@ -0,0 +1,22 @@
+/**
+ * @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 { ListQueryDeclaration } from '@aglyn/shared-ui-jsx/const/list-query-plan';
+/** The array `contains` and the search box read: every word's prefixes. */
+export declare const EXPERIMENT_NAME_TOKENS = "nameTokens";
+/** The lower-cased whole name `equals` reads. */
+export declare const EXPERIMENT_NAME_LOWER = "nameLower";
+export declare const EXPERIMENT_LIST_QUERY: ListQueryDeclaration;

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

@@ -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.
+ */ /*
+ * WHAT A SITE'S A/B TESTING LIST ASKS FIRESTORE (AGL-3321).
+ *
+ * Every clause the list's Filters panel offers, and its search box, is a
+ * predicate on ONE query over `hosts/{hostId}/experiments`, ordered by name,
+ * paged by that query — never a match over the experiments a read happened
+ * to hold. Each field is here because a query can serve it:
+ *
+ *   name    `contains` a word (the `nameTokens` array) or `equals` the whole
+ *           name (`nameLower`). Every writer of an experiment stamps both
+ *           through `nameSearchFields` — the console's editor, the besigner's
+ *           "test this section" shortcut and the seeds — and
+ *           `tools/scripts/backfill-experiments-name-search.mjs` stamps the
+ *           ones saved before;
+ *   target  what the test splits (screen, section, email), which every
+ *           writer sets;
+ *   status  draft, running, paused or done, which every writer sets.
+ *
+ * The one order is `name` ascending, as the list has always read. No range
+ * is offered: a range orders the list by the field it ranges over, and would
+ * cost one composite per field above under that order (four), for a list a
+ * site keeps a handful of tests in.
+ */ /** The array `contains` and the search box read: every word's prefixes. */ export const EXPERIMENT_NAME_TOKENS = 'nameTokens';
+/** The lower-cased whole name `equals` reads. */ export const EXPERIMENT_NAME_LOWER = 'nameLower';
+export const EXPERIMENT_LIST_QUERY = {
+    fields: [
+        {
+            column: 'name',
+            kind: 'text',
+            path: 'name',
+            lowerPath: EXPERIMENT_NAME_LOWER,
+            tokensPath: EXPERIMENT_NAME_TOKENS,
+            operators: [
+                'contains',
+                'equals'
+            ]
+        },
+        {
+            column: 'target',
+            kind: 'exact',
+            path: 'target',
+            presence: 'always',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        },
+        {
+            column: 'status',
+            kind: 'exact',
+            path: 'status',
+            presence: 'always',
+            operators: [
+                'equals',
+                'isAnyOf'
+            ]
+        }
+    ],
+    sorts: [
+        {
+            path: 'name',
+            direction: 'asc'
+        }
+    ],
+    search: {
+        tokensPath: EXPERIMENT_NAME_TOKENS
+    }
+};
+
+//# sourceMappingURL=experiment-list-query.js.map

package/src/lib/model/experiment-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/experiment-list-query.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 type { ListQueryDeclaration } from '@aglyn/shared-ui-jsx/const/list-query-plan'\n\n/*\n * WHAT A SITE'S A/B TESTING LIST ASKS FIRESTORE (AGL-3321).\n *\n * Every clause the list's Filters panel offers, and its search box, is a\n * predicate on ONE query over `hosts/{hostId}/experiments`, ordered by name,\n * paged by that query — never a match over the experiments a read happened\n * to hold. Each field is here because a query can serve it:\n *\n *   name    `contains` a word (the `nameTokens` array) or `equals` the whole\n *           name (`nameLower`). Every writer of an experiment stamps both\n *           through `nameSearchFields` — the console's editor, the besigner's\n *           \"test this section\" shortcut and the seeds — and\n *           `tools/scripts/backfill-experiments-name-search.mjs` stamps the\n *           ones saved before;\n *   target  what the test splits (screen, section, email), which every\n *           writer sets;\n *   status  draft, running, paused or done, which every writer sets.\n *\n * The one order is `name` ascending, as the list has always read. No range\n * is offered: a range orders the list by the field it ranges over, and would\n * cost one composite per field above under that order (four), for a list a\n * site keeps a handful of tests in.\n */\n\n/** The array `contains` and the search box read: every word's prefixes. */\nexport const EXPERIMENT_NAME_TOKENS = 'nameTokens'\n/** The lower-cased whole name `equals` reads. */\nexport const EXPERIMENT_NAME_LOWER = 'nameLower'\n\nexport const EXPERIMENT_LIST_QUERY: ListQueryDeclaration = {\n  fields: [\n    {\n      column: 'name',\n      kind: 'text',\n      path: 'name',\n      lowerPath: EXPERIMENT_NAME_LOWER,\n      tokensPath: EXPERIMENT_NAME_TOKENS,\n      operators: ['contains', 'equals'],\n    },\n    { column: 'target', kind: 'exact', path: 'target', presence: 'always', operators: ['equals', 'isAnyOf'] },\n    { column: 'status', kind: 'exact', path: 'status', presence: 'always', operators: ['equals', 'isAnyOf'] },\n  ],\n  sorts: [{ path: 'name', direction: 'asc' }],\n  search: { tokensPath: EXPERIMENT_NAME_TOKENS },\n}\n"],"names":["EXPERIMENT_NAME_TOKENS","EXPERIMENT_NAME_LOWER","EXPERIMENT_LIST_QUERY","fields","column","kind","path","lowerPath","tokensPath","operators","presence","sorts","direction","search"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;;;;;;;;;CAsBC,GAED,yEAAyE,GACzE,OAAO,MAAMA,yBAAyB,aAAY;AAClD,+CAA+C,GAC/C,OAAO,MAAMC,wBAAwB,YAAW;AAEhD,OAAO,MAAMC,wBAA8C;IACzDC,QAAQ;QACN;YACEC,QAAQ;YACRC,MAAM;YACNC,MAAM;YACNC,WAAWN;YACXO,YAAYR;YACZS,WAAW;gBAAC;gBAAY;aAAS;QACnC;QACA;YAAEL,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUI,UAAU;YAAUD,WAAW;gBAAC;gBAAU;aAAU;QAAC;QACxG;YAAEL,QAAQ;YAAUC,MAAM;YAASC,MAAM;YAAUI,UAAU;YAAUD,WAAW;gBAAC;gBAAU;aAAU;QAAC;KACzG;IACDE,OAAO;QAAC;YAAEL,MAAM;YAAQM,WAAW;QAAM;KAAE;IAC3CC,QAAQ;QAAEL,YAAYR;IAAuB;AAC/C,EAAC"}

package/src/lib/server/campaign-manage.d.ts

@@ -31,7 +31,7 @@ export declare const CAMPAIGN_DRAFT_ROLE_REFUSAL = "Not a site admin or editor";
 /** The id of the one email inside a drafted campaign. */
 export declare function campaignDraftEmailId(campaignId: string): string;
 /** Every field a drafted email is written with, and so every field it can hold. */
-export declare const CAMPAIGN_DRAFT_EMAIL_FIELDS: readonly ["subject", "preheader", "templateScreenId", "subjectVariants", "preheaderVariants", "emailCampaignId", "hostId", "visibleTo", "status", "createdAtMs", "draftedAt", "draftedBy"];
+export declare const CAMPAIGN_DRAFT_EMAIL_FIELDS: readonly ["subject", "subjectTokens", "preheader", "templateScreenId", "subjectVariants", "preheaderVariants", "emailCampaignId", "hostId", "visibleTo", "status", "createdAtMs", "draftedAt", "draftedBy"];
 /** What a caller sends as `content`. */
 export interface CampaignDraftContent {
     /** The email design the email sends: a `kind: 'email'` screen on the site. */

package/src/lib/server/campaign-manage.js

@@ -88,6 +88,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ import firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
 import { isDocumentId } from "@aglyn/tenant-data-admin/server/document-id";
 import { logResourceDuplicated } from "@aglyn/tenant-data-admin/server/duplicate-activity";
+import { restampCrmListFieldsOf } from "@aglyn/tenant-data-admin/server/crm-records";
 import { DUPLICATE_BUSY_MESSAGE, duplicateDisplayName, uniqueDuplicateName } from "@aglyn/aglyn/app-utils/duplicate-resource";
 import { claimAttempt, createResourceUid } from "@aglyn/aglyn/server";
 /*
@@ -100,6 +101,7 @@ import { CAMPAIGN_MEMBER_HOST_COLLECTIONS, CAMPAIGN_MEMBERSHIP_FIELD, contactCam
 import { CAMPAIGN_SEND_CONTAINER_FIELD, CAMPAIGN_SEND_HOST_FIELD, campaignPlacedOnHost, campaignSiteIds, campaignVisibleTo } from "@aglyn/shared-ui-email-campaigns/model";
 import { campaignSendSiteStamp, orgCampaignSends, orgEmailCampaigns, sendHostId, sendIsOnHost } from "./campaign-org-refs.js";
 import { SCREEN_KIND_EMAIL } from "@aglyn/aglyn/app-utils/screen-route";
+import { campaignContainerSearchFields, campaignSendSearchFields } from "../model/campaign-list-query.js";
 import { registerPluginResourceDraftWriter } from "@aglyn/aglyn/plugin-manager/plugin-resource-drafts";
 import { runPluginMembershipDetachers } from "@aglyn/aglyn/plugin-manager/plugin-membership-detach";
 import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
@@ -132,7 +134,8 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
  * removing a container some sites' records would still name.
  */ const ORG_SITES_MAX = 200;
 /**
- * Clears {@link CAMPAIGN_SEND_CONTAINER_FIELD} from every send in a campaign.
+ * Files every send in a campaign under NO campaign: {@link
+ * CAMPAIGN_SEND_CONTAINER_FIELD} set to `null`.
  *
  * Equality on one field with a `limit` — no `orderBy` — which Firestore's
  * automatic single-field index serves. Ordering would need a composite index
@@ -151,15 +154,14 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
         const batch = firestore.batch();
         for (const send of page.docs){
             /*
-       * The FIELD is removed, not set to an empty string. `campaignListRows`
-       * adopts a send whose container id is falsy, so an empty string would
-       * work by accident today — but the field is also what the campaign
-       * detail page's `where` clause matches, and an equality query on `''`
-       * is a different query from the absence the pre-container sends have.
-       * One shape for "belongs to no campaign" is what keeps those two
-       * readers agreeing.
+       * `null`, not an empty string and not a removed field. "Belongs to no
+       * campaign" has ONE stored shape, because it is a query: the lists ask
+       * `emailCampaignId == null` for single sends (AGL-3321), which an
+       * empty string would not answer and a missing field cannot — a query
+       * never finds a field that is not there. `campaignListRows` adopts any
+       * falsy container id, so every reader agrees.
        */ batch.update(send.ref, {
-                [CAMPAIGN_SEND_CONTAINER_FIELD]: firebaseAdmin.firestore.FieldValue.delete()
+                [CAMPAIGN_SEND_CONTAINER_FIELD]: null
             });
         }
         await batch.commit();
@@ -204,6 +206,11 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
             });
         }
         await batch.commit();
+        // A lead's campaigns are what the Leads list's Campaign filter reads
+        // under a site (AGL-3321): restamped from each lead as it now stands.
+        if (collectionRef.id === 'leads') {
+            await restampCrmListFieldsOf(page.docs.map((member)=>member.ref), 'leads');
+        }
         detached += page.size;
         if (page.size < DETACH_BATCH) return {
             detached,
@@ -549,7 +556,7 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
         };
     }
     const outcome = await firestore.runTransaction(async (transaction)=>{
-        var _source_data, _ref, _data_displayName;
+        var _source_data, _ref, _data_displayName, _copy_CAMPAIGN_SEND_CONTAINER_FIELD;
         const [source, siblings] = await Promise.all([
             transaction.get(messages.doc(emailId)),
             transaction.get(messages.select('displayName', 'subject').where(CAMPAIGN_SEND_HOST_FIELD, '==', siteId))
@@ -573,7 +580,9 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
             if (data[field] !== undefined && data[field] !== null) copy[field] = data[field];
         }
         const nowMs = Date.now();
-        transaction.create(messages.doc(id), _extends({}, copy, campaignSendSiteStamp(siteId), {
+        transaction.create(messages.doc(id), _extends({}, copy, campaignSendSearchFields(copy['subject']), {
+            [CAMPAIGN_SEND_CONTAINER_FIELD]: (_copy_CAMPAIGN_SEND_CONTAINER_FIELD = copy[CAMPAIGN_SEND_CONTAINER_FIELD]) != null ? _copy_CAMPAIGN_SEND_CONTAINER_FIELD : null
+        }, campaignSendSiteStamp(siteId), {
             displayName: name,
             status: 'draft',
             createdAtMs: nowMs,
@@ -662,6 +671,7 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
 }
 /** Every field a drafted email is written with, and so every field it can hold. */ export const CAMPAIGN_DRAFT_EMAIL_FIELDS = [
     'subject',
+    'subjectTokens',
     'preheader',
     'templateScreenId',
     'subjectVariants',
@@ -857,19 +867,21 @@ export function createCampaignDraftWriter(deps = {}) {
                 const nowMs = request.now.getTime();
                 // A site hub's create drawer's own document: a name, no dates, no
                 // lists, placed on the site it was drafted for.
-                transaction.create(campaignRef, {
-                    name,
+                const visibleTo = campaignVisibleTo([
+                    request.hostId
+                ]);
+                transaction.create(campaignRef, _extends({
+                    name
+                }, campaignContainerSearchFields(name), {
                     listIds: [],
-                    visibleTo: campaignVisibleTo([
-                        request.hostId
-                    ]),
+                    visibleTo,
                     createdAtMs: nowMs,
                     createdBy: request.uid
-                });
+                }));
                 const { value } = read;
                 transaction.create(emailRef, _extends({
                     subject: value.subject
-                }, value.preheader ? {
+                }, campaignSendSearchFields(value.subject), value.preheader ? {
                     preheader: value.preheader
                 } : {}, {
                     templateScreenId: value.templateScreenId