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

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-form-flags.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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.
+ */
+/**
+ * `inCampaign` restamped from what each form's `campaignIds` now holds
+ * (AGL-3330) — for the one writer of `campaignIds` that cannot say what it
+ * is leaving behind.
+ *
+ * Every other writer sets the ids through `formCampaignFields`, which
+ * returns the boolean beside them. A campaign's deletion takes its one id out
+ * of every form holding it with `arrayRemove`, which is what keeps it from
+ * clobbering a campaign added to the same form in the meantime — and which
+ * means the write does not know whether the array came out empty. So each
+ * form is read back inside a transaction and its flag set from the array as
+ * it stands, which is exactly what a concurrent picker save would also
+ * leave.
+ *
+ * Idempotent: a form whose flag already agrees is not written.
+ *
+ * @returns how many forms were restamped.
+ */
+export declare function restampFormsInCampaign(firestore: FirebaseFirestore.Firestore, refs: readonly FirebaseFirestore.DocumentReference[]): Promise<number>;

package/src/lib/server/campaign-form-flags.js

@@ -0,0 +1,52 @@
+/**
+ * @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 { formCampaignFields } from "@aglyn/aglyn/app-utils/forms";
+/**
+ * `inCampaign` restamped from what each form's `campaignIds` now holds
+ * (AGL-3330) — for the one writer of `campaignIds` that cannot say what it
+ * is leaving behind.
+ *
+ * Every other writer sets the ids through `formCampaignFields`, which
+ * returns the boolean beside them. A campaign's deletion takes its one id out
+ * of every form holding it with `arrayRemove`, which is what keeps it from
+ * clobbering a campaign added to the same form in the meantime — and which
+ * means the write does not know whether the array came out empty. So each
+ * form is read back inside a transaction and its flag set from the array as
+ * it stands, which is exactly what a concurrent picker save would also
+ * leave.
+ *
+ * Idempotent: a form whose flag already agrees is not written.
+ *
+ * @returns how many forms were restamped.
+ */ export async function restampFormsInCampaign(firestore, refs) {
+    let restamped = 0;
+    for (const formRef of refs){
+        const wrote = await firestore.runTransaction(async (tx)=>{
+            const form = await tx.get(formRef);
+            if (!form.exists) return false;
+            const { inCampaign } = formCampaignFields(form.get('campaignIds'));
+            if (form.get('inCampaign') === inCampaign) return false;
+            tx.update(formRef, {
+                inCampaign
+            });
+            return true;
+        });
+        if (wrote) restamped += 1;
+    }
+    return restamped;
+}
+
+//# sourceMappingURL=campaign-form-flags.js.map

package/src/lib/server/campaign-form-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/campaign-form-flags.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 { formCampaignFields } from '@aglyn/aglyn/app-utils/forms'\n\n/**\n * `inCampaign` restamped from what each form's `campaignIds` now holds\n * (AGL-3330) — for the one writer of `campaignIds` that cannot say what it\n * is leaving behind.\n *\n * Every other writer sets the ids through `formCampaignFields`, which\n * returns the boolean beside them. A campaign's deletion takes its one id out\n * of every form holding it with `arrayRemove`, which is what keeps it from\n * clobbering a campaign added to the same form in the meantime — and which\n * means the write does not know whether the array came out empty. So each\n * form is read back inside a transaction and its flag set from the array as\n * it stands, which is exactly what a concurrent picker save would also\n * leave.\n *\n * Idempotent: a form whose flag already agrees is not written.\n *\n * @returns how many forms were restamped.\n */\nexport async function restampFormsInCampaign(\n  firestore: FirebaseFirestore.Firestore,\n  refs: readonly FirebaseFirestore.DocumentReference[],\n): Promise<number> {\n  let restamped = 0\n  for (const formRef of refs) {\n    const wrote = await firestore.runTransaction(async (tx) => {\n      const form = await tx.get(formRef)\n      if (!form.exists) return false\n      const { inCampaign } = formCampaignFields(form.get('campaignIds'))\n      if (form.get('inCampaign') === inCampaign) return false\n      tx.update(formRef, { inCampaign })\n      return true\n    })\n    if (wrote) restamped += 1\n  }\n  return restamped\n}\n"],"names":["formCampaignFields","restampFormsInCampaign","firestore","refs","restamped","formRef","wrote","runTransaction","tx","form","get","exists","inCampaign","update"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,QAAQ,+BAA8B;AAEjE;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,eAAeC,uBACpBC,SAAsC,EACtCC,IAAoD;IAEpD,IAAIC,YAAY;IAChB,KAAK,MAAMC,WAAWF,KAAM;QAC1B,MAAMG,QAAQ,MAAMJ,UAAUK,cAAc,CAAC,OAAOC;YAClD,MAAMC,OAAO,MAAMD,GAAGE,GAAG,CAACL;YAC1B,IAAI,CAACI,KAAKE,MAAM,EAAE,OAAO;YACzB,MAAM,EAAEC,UAAU,EAAE,GAAGZ,mBAAmBS,KAAKC,GAAG,CAAC;YACnD,IAAID,KAAKC,GAAG,CAAC,kBAAkBE,YAAY,OAAO;YAClDJ,GAAGK,MAAM,CAACR,SAAS;gBAAEO;YAAW;YAChC,OAAO;QACT;QACA,IAAIN,OAAOF,aAAa;IAC1B;IACA,OAAOA;AACT"}

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,8 @@ 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 { restampFormsInCampaign } from "./campaign-form-flags.js";
 import { DUPLICATE_BUSY_MESSAGE, duplicateDisplayName, uniqueDuplicateName } from "@aglyn/aglyn/app-utils/duplicate-resource";
 import { claimAttempt, createResourceUid } from "@aglyn/aglyn/server";
 /*
@@ -100,6 +102,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 +135,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 +155,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();
@@ -198,12 +201,26 @@ import { isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
             remaining: false
         };
         const batch = firestore.batch();
+        const isForms = collectionRef.id === 'forms';
         for (const member of page.docs){
-            batch.update(member.ref, {
+            batch.update(member.ref, _extends({
                 [fieldPath]: firebaseAdmin.firestore.FieldValue.arrayRemove(campaignId)
-            });
+            }, isForms ? {
+                updatedAt: firebaseAdmin.firestore.FieldValue.serverTimestamp()
+            } : {}));
         }
         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');
+        }
+        // A form's `inCampaign` is what the Forms list's "In a campaign" filter
+        // asks (AGL-3330), and `arrayRemove` cannot say whether it emptied the
+        // array: restamped from each form as it now stands.
+        if (isForms) {
+            await restampFormsInCampaign(firestore, page.docs.map((member)=>member.ref));
+        }
         detached += page.size;
         if (page.size < DETACH_BATCH) return {
             detached,
@@ -549,7 +566,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 +590,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 +681,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 +877,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