@aglyn/plugins-marketing 1.0.0-beta.229 → 1.0.0-beta.230

package/src/lib/server/marketing-drafts.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @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 PluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
+import { type HostExperiment } from '../model/experiments';
+/**
+ * The overlay and A/B test draft writers this plugin registers on the core's
+ * resource-drafts seam (AGL-3616), for another plugin — an AI build turning a
+ * request into a plan — to make one without importing this plugin.
+ *
+ * ## What a draft is here
+ *
+ * - **An overlay is written SWITCHED OFF** (`enabled: false`) at
+ *   `hosts/{hostId}/overlays/{id}`: no visitor sees it until a member turns
+ *   it on in the Overlays section. Its copy is held to the editor's limits
+ *   and its trigger to the catalog the runtime opens a popup on; a link,
+ *   pages, a schedule and an order are never written.
+ * - **An A/B test is written STOPPED** (`status: 'draft'`) at
+ *   `hosts/{hostId}/experiments/{id}`: assignment serves nothing for a test
+ *   that is not running. Its variants are drafts of copy — an email's subject
+ *   and body, a page's or section's name — and pin only versions that exist
+ *   on the page under test; the published page stays every variant's default.
+ *
+ * Neither write changes what a published page serves, so neither drops the
+ * site's cache the way an edit to a live overlay does.
+ *
+ * ## The owner's rules
+ *
+ * `refusal` holds the member's role on the site (one that writes its content)
+ * and the plan's entitlement (`marketingOverlays`, `abTesting`), and for an
+ * overlay the room in a site's list, which reads and reorders at most
+ * {@link OVERLAY_LIST_CEILING}. `check` is pure. `write` replays a draft
+ * already written under its id, asks `refusal` again before it writes, and
+ * CREATES the document, so two writes racing for one id cannot both land.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** The resource names the writers are registered under. */
+export declare const OVERLAY_DRAFT_RESOURCE = "overlay";
+export declare const EXPERIMENT_DRAFT_RESOURCE = "experiment";
+export declare const OVERLAY_DRAFT_ROLE_REFUSAL = "Editing this site requires the editor role";
+export declare const OVERLAY_DRAFT_PLAN_REFUSAL = "Announcement bars and popups are not included on this workspace\u2019s plan \u2014 see Billing to upgrade.";
+export declare const OVERLAY_DRAFT_ROOM_REFUSAL = "This site already has 50 overlays \u2014 delete the ones you have finished with first.";
+export declare const EXPERIMENT_DRAFT_PLAN_REFUSAL = "A/B testing is not included on this workspace\u2019s plan \u2014 see Billing to upgrade.";
+export interface MarketingDraftWriterDeps {
+    /** The Admin SDK handle; specs hand in a double. */
+    firestore?: () => Firestore;
+}
+/**
+ * The `overlay` writer. Content: `{ kind: 'bar' | 'popup', text?, headline?,
+ * body?, ctaLabel?, trigger?, triggerValue? }` — a bar's text, a popup's
+ * body, each within the overlay copy limits (`OVERLAY_COPY_LIMITS`).
+ */
+export declare function createOverlayDraftWriter(deps?: MarketingDraftWriterDeps): PluginResourceDraftWriter;
+/** The experiment content, read and checked; problems instead when it is not one. */
+export declare function readExperimentDraftContent(content: Readonly<Record<string, unknown>>, name: string): {
+    ok: true;
+    value: HostExperiment;
+} | {
+    ok: false;
+    problems: string[];
+};
+/**
+ * The `experiment` writer. Content: `{ target: 'screen' | 'section' | 'email',
+ * screenId?, nodeId?, goal?, variants: [{ name, subject?, body?, versionId? }] }`,
+ * two to four variants, the first the control.
+ */
+export declare function createExperimentDraftWriter(deps?: MarketingDraftWriterDeps): PluginResourceDraftWriter;
+/**
+ * Registers both writers; the console surface calls it, since only the
+ * console runs the AI builds that write through them. Idempotent.
+ */
+export declare function registerMarketingDraftWriters(deps?: MarketingDraftWriterDeps): void;
+export {};

package/src/lib/server/marketing-drafts.js

@@ -0,0 +1,354 @@
+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 { hostRoleCanWrite } from "@aglyn/aglyn/app-utils/organizations";
+import { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { registerPluginResourceDraftWriter } from "@aglyn/aglyn/plugin-manager/plugin-resource-drafts";
+import firebaseAdmin from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { isDocumentId } from "@aglyn/tenant-data-admin/server/document-id";
+import { EXPERIMENT_MAX_VARIANTS, validateExperiment } from "../model/experiments.js";
+import { OVERLAY_LIST_CEILING, overlayDraftContentProblems, overlayDraftFromProposal } from "../model/overlay-drafts.js";
+/** The resource names the writers are registered under. */ export const OVERLAY_DRAFT_RESOURCE = 'overlay';
+export const EXPERIMENT_DRAFT_RESOURCE = 'experiment';
+const MARKETING_PLUGIN_ID = 'marketing';
+export const OVERLAY_DRAFT_ROLE_REFUSAL = 'Editing this site requires the editor role';
+export const OVERLAY_DRAFT_PLAN_REFUSAL = 'Announcement bars and popups are not included on this workspace’s plan — see Billing to upgrade.';
+export const OVERLAY_DRAFT_ROOM_REFUSAL = `This site already has ${OVERLAY_LIST_CEILING} overlays — delete the ones you have finished with first.`;
+export const EXPERIMENT_DRAFT_PLAN_REFUSAL = 'A/B testing is not included on this workspace’s plan — see Billing to upgrade.';
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** The site, and the member's role on it, or the refusal that stands in for them. */ async function siteFor(firestore, context) {
+    var _host_get;
+    const host = await firestore.collection('hosts').doc(context.hostId).get();
+    if (!host.exists || context.orgId && host.get('orgId') && host.get('orgId') !== context.orgId) {
+        return {
+            status: 404,
+            error: 'Unknown site'
+        };
+    }
+    const role = ((_host_get = host.get('memberRoles')) != null ? _host_get : {})[context.uid];
+    if (!hostRoleCanWrite(role)) return {
+        status: 403,
+        error: OVERLAY_DRAFT_ROLE_REFUSAL
+    };
+    return {
+        host
+    };
+}
+const isRefusal = (value)=>'status' in value;
+function overlayRecord(snapshot) {
+    var _snapshot_get;
+    return {
+        id: snapshot.id,
+        name: str(snapshot.get('name')),
+        versionId: null,
+        facts: {
+            kind: (_snapshot_get = snapshot.get('kind')) != null ? _snapshot_get : null,
+            enabled: snapshot.get('enabled') !== false
+        }
+    };
+}
+/** The overlay content as the writer documents it: a proposal's fields and its kind. */ function overlayProposal(content) {
+    const proposal = {};
+    for (const field of [
+        'name',
+        'text',
+        'headline',
+        'body',
+        'ctaLabel',
+        'trigger'
+    ]){
+        if (typeof content[field] === 'string') proposal[field] = content[field];
+    }
+    if (typeof content['triggerValue'] === 'number') proposal.triggerValue = content['triggerValue'];
+    return proposal;
+}
+/**
+ * The `overlay` writer. Content: `{ kind: 'bar' | 'popup', text?, headline?,
+ * body?, ctaLabel?, trigger?, triggerValue? }` — a bar's text, a popup's
+ * body, each within the overlay copy limits (`OVERLAY_COPY_LIMITS`).
+ */ export function createOverlayDraftWriter(deps = {}) {
+    var _deps_firestore;
+    const firestore = (_deps_firestore = deps.firestore) != null ? _deps_firestore : ()=>firebaseAdmin.app().firestore();
+    const refusal = async (context)=>{
+        const site = await siteFor(firestore(), context);
+        if (isRefusal(site)) return site;
+        if (!checkEntitlement(context.org, 'marketingOverlays')) {
+            return {
+                status: 403,
+                error: OVERLAY_DRAFT_PLAN_REFUSAL
+            };
+        }
+        const count = await site.host.ref.collection('overlays').count().get();
+        if (Number(count.data().count) >= OVERLAY_LIST_CEILING) {
+            return {
+                status: 409,
+                error: OVERLAY_DRAFT_ROOM_REFUSAL
+            };
+        }
+        return null;
+    };
+    return {
+        refusal,
+        check: (content)=>{
+            const problems = overlayDraftContentProblems(content);
+            return problems.length ? {
+                ok: false,
+                problems
+            } : {
+                ok: true,
+                facts: {
+                    kind: content['kind'],
+                    enabled: false
+                }
+            };
+        },
+        read: async ({ hostId, id })=>{
+            if (!isDocumentId(id)) return null;
+            const snapshot = await firestore().collection('hosts').doc(hostId).collection('overlays').doc(id).get();
+            return snapshot.exists ? overlayRecord(snapshot) : null;
+        },
+        write: async (request)=>{
+            var _draft_name;
+            if (!isDocumentId(request.id)) return {
+                ok: false,
+                status: 400,
+                error: 'Invalid overlay id'
+            };
+            const problems = overlayDraftContentProblems(request.content);
+            if (problems.length) return {
+                ok: false,
+                status: 400,
+                error: problems[0]
+            };
+            const kind = request.content['kind'];
+            const draft = overlayDraftFromProposal(kind, _extends({}, overlayProposal(request.content), str(request.name) ? {
+                name: str(request.name)
+            } : {}));
+            if (!draft) return {
+                ok: false,
+                status: 400,
+                error: 'There was no copy to save'
+            };
+            const ref = firestore().collection('hosts').doc(request.hostId).collection('overlays').doc(request.id);
+            const earlier = await ref.get();
+            if (earlier.exists) return _extends({
+                ok: true,
+                replayed: true
+            }, overlayRecord(earlier));
+            const refused = await refusal(request);
+            if (refused) return _extends({
+                ok: false
+            }, refused);
+            const name = (_draft_name = draft.name) != null ? _draft_name : null;
+            await ref.create(_extends({}, draft, {
+                // The list orders on `name`, which every overlay carries, null or not.
+                name,
+                createdAt: request.now,
+                updatedAt: request.now,
+                createdBy: request.uid
+            }));
+            return {
+                ok: true,
+                replayed: false,
+                id: request.id,
+                name: name != null ? name : '',
+                versionId: null,
+                facts: {
+                    kind,
+                    enabled: false
+                }
+            };
+        }
+    };
+}
+/** The experiment content, read and checked; problems instead when it is not one. */ export function readExperimentDraftContent(content, name) {
+    const target = content['target'];
+    const rawVariants = Array.isArray(content['variants']) ? content['variants'] : [];
+    const problems = [];
+    if (rawVariants.length > EXPERIMENT_MAX_VARIANTS) {
+        problems.push(`Experiments are capped at ${EXPERIMENT_MAX_VARIANTS} variants`);
+    }
+    const variants = rawVariants.slice(0, EXPERIMENT_MAX_VARIANTS).map((raw, index)=>{
+        const variant = raw != null ? raw : {};
+        const id = String.fromCharCode(97 + index);
+        return _extends({
+            id,
+            name: str(variant.name).slice(0, 80) || (index === 0 ? 'A (control)' : id.toUpperCase()),
+            weight: 1
+        }, target === 'email' && str(variant.subject) ? {
+            subject: str(variant.subject).slice(0, 200)
+        } : {}, target === 'email' && str(variant.body) ? {
+            body: str(variant.body).slice(0, 4000)
+        } : {}, target !== 'email' && str(variant.versionId) ? {
+            versionId: str(variant.versionId)
+        } : {});
+    });
+    const goal = str(content['goal']);
+    const value = _extends({
+        name: str(name || content['name']).slice(0, 120),
+        // STOPPED: assignment serves nothing for a test that is not running.
+        status: 'draft',
+        target
+    }, str(content['screenId']) ? {
+        screenId: str(content['screenId'])
+    } : {}, target === 'section' && str(content['nodeId']) ? {
+        nodeId: str(content['nodeId'])
+    } : {}, {
+        variants,
+        goal: {
+            event: goal || 'formSubmission'
+        }
+    });
+    const invalid = validateExperiment(value);
+    if (invalid) problems.push(invalid);
+    if (variants.some((variant)=>'versionId' in variant && !isDocumentId(String(variant.versionId)))) {
+        problems.push('A variant names a version that is not one');
+    }
+    return problems.length ? {
+        ok: false,
+        problems
+    } : {
+        ok: true,
+        value
+    };
+}
+function experimentRecord(snapshot) {
+    var _snapshot_get, _snapshot_get1;
+    return {
+        id: snapshot.id,
+        name: str(snapshot.get('name')),
+        versionId: null,
+        facts: {
+            status: (_snapshot_get = snapshot.get('status')) != null ? _snapshot_get : null,
+            target: (_snapshot_get1 = snapshot.get('target')) != null ? _snapshot_get1 : null
+        }
+    };
+}
+/**
+ * The `experiment` writer. Content: `{ target: 'screen' | 'section' | 'email',
+ * screenId?, nodeId?, goal?, variants: [{ name, subject?, body?, versionId? }] }`,
+ * two to four variants, the first the control.
+ */ export function createExperimentDraftWriter(deps = {}) {
+    var _deps_firestore;
+    const firestore = (_deps_firestore = deps.firestore) != null ? _deps_firestore : ()=>firebaseAdmin.app().firestore();
+    const refusal = async (context)=>{
+        const site = await siteFor(firestore(), context);
+        if (isRefusal(site)) return site;
+        if (!checkEntitlement(context.org, 'abTesting')) {
+            return {
+                status: 403,
+                error: EXPERIMENT_DRAFT_PLAN_REFUSAL
+            };
+        }
+        return null;
+    };
+    return {
+        refusal,
+        check: (content)=>{
+            const read = readExperimentDraftContent(content, str(content['name']) || 'A/B test');
+            return read.ok === false ? read : {
+                ok: true,
+                facts: {
+                    status: 'draft',
+                    target: read.value.target,
+                    variants: read.value.variants.length
+                }
+            };
+        },
+        read: async ({ hostId, id })=>{
+            if (!isDocumentId(id)) return null;
+            const snapshot = await firestore().collection('hosts').doc(hostId).collection('experiments').doc(id).get();
+            return snapshot.exists ? experimentRecord(snapshot) : null;
+        },
+        write: async (request)=>{
+            if (!isDocumentId(request.id)) return {
+                ok: false,
+                status: 400,
+                error: 'Invalid experiment id'
+            };
+            const read = readExperimentDraftContent(request.content, request.name || 'A/B test');
+            if (read.ok === false) return {
+                ok: false,
+                status: 400,
+                error: read.problems[0]
+            };
+            const hostRef = firestore().collection('hosts').doc(request.hostId);
+            const ref = hostRef.collection('experiments').doc(request.id);
+            const earlier = await ref.get();
+            if (earlier.exists) return _extends({
+                ok: true,
+                replayed: true
+            }, experimentRecord(earlier));
+            const refused = await refusal(request);
+            if (refused) return _extends({
+                ok: false
+            }, refused);
+            const { value } = read;
+            // A page under test, and every version a variant pins, exist on this site.
+            if (value.screenId) {
+                const screenRef = hostRef.collection('screens').doc(value.screenId);
+                const screen = await screenRef.get();
+                if (!screen.exists || screen.get('deletedAt')) {
+                    return {
+                        ok: false,
+                        status: 400,
+                        error: 'The page under test does not exist'
+                    };
+                }
+                for (const variant of value.variants){
+                    if (!variant.versionId) continue;
+                    const version = await screenRef.collection('versions').doc(variant.versionId).get();
+                    if (!version.exists || version.get('deletedAt')) {
+                        return {
+                            ok: false,
+                            status: 400,
+                            error: 'A variant pins a version the page does not have'
+                        };
+                    }
+                }
+            }
+            await ref.create(_extends({}, value, {
+                createdAt: request.now,
+                updatedAt: request.now,
+                createdBy: request.uid
+            }));
+            return {
+                ok: true,
+                replayed: false,
+                id: request.id,
+                name: value.name,
+                versionId: null,
+                facts: {
+                    status: 'draft',
+                    target: value.target
+                }
+            };
+        }
+    };
+}
+/**
+ * Registers both writers; the console surface calls it, since only the
+ * console runs the AI builds that write through them. Idempotent.
+ */ export function registerMarketingDraftWriters(deps = {}) {
+    registerPluginResourceDraftWriter(OVERLAY_DRAFT_RESOURCE, createOverlayDraftWriter(deps), {
+        pluginId: MARKETING_PLUGIN_ID
+    });
+    registerPluginResourceDraftWriter(EXPERIMENT_DRAFT_RESOURCE, createExperimentDraftWriter(deps), {
+        pluginId: MARKETING_PLUGIN_ID
+    });
+}
+
+//# sourceMappingURL=marketing-drafts.js.map

package/src/lib/server/marketing-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/server/marketing-drafts.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 { hostRoleCanWrite } from '@aglyn/aglyn/app-utils/organizations'\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  registerPluginResourceDraftWriter,\n  type PluginDraftContext,\n  type PluginDraftRecord,\n  type PluginDraftRefusal,\n  type PluginDraftWrite,\n  type PluginResourceDraftWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts'\nimport firebaseAdmin from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { isDocumentId } from '@aglyn/tenant-data-admin/server/document-id'\nimport {\n  EXPERIMENT_MAX_VARIANTS,\n  validateExperiment,\n  type ExperimentTarget,\n  type HostExperiment,\n} from '../model/experiments'\nimport {\n  OVERLAY_LIST_CEILING,\n  overlayDraftContentProblems,\n  overlayDraftFromProposal,\n  type OverlayCopyProposal,\n} from '../model/overlay-drafts'\n\n/**\n * The overlay and A/B test draft writers this plugin registers on the core's\n * resource-drafts seam (AGL-3616), for another plugin — an AI build turning a\n * request into a plan — to make one without importing this plugin.\n *\n * ## What a draft is here\n *\n * - **An overlay is written SWITCHED OFF** (`enabled: false`) at\n *   `hosts/{hostId}/overlays/{id}`: no visitor sees it until a member turns\n *   it on in the Overlays section. Its copy is held to the editor's limits\n *   and its trigger to the catalog the runtime opens a popup on; a link,\n *   pages, a schedule and an order are never written.\n * - **An A/B test is written STOPPED** (`status: 'draft'`) at\n *   `hosts/{hostId}/experiments/{id}`: assignment serves nothing for a test\n *   that is not running. Its variants are drafts of copy — an email's subject\n *   and body, a page's or section's name — and pin only versions that exist\n *   on the page under test; the published page stays every variant's default.\n *\n * Neither write changes what a published page serves, so neither drops the\n * site's cache the way an edit to a live overlay does.\n *\n * ## The owner's rules\n *\n * `refusal` holds the member's role on the site (one that writes its content)\n * and the plan's entitlement (`marketingOverlays`, `abTesting`), and for an\n * overlay the room in a site's list, which reads and reorders at most\n * {@link OVERLAY_LIST_CEILING}. `check` is pure. `write` replays a draft\n * already written under its id, asks `refusal` again before it writes, and\n * CREATES the document, so two writes racing for one id cannot both land.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** The resource names the writers are registered under. */\nexport const OVERLAY_DRAFT_RESOURCE = 'overlay'\nexport const EXPERIMENT_DRAFT_RESOURCE = 'experiment'\n\nconst MARKETING_PLUGIN_ID = 'marketing'\n\nexport const OVERLAY_DRAFT_ROLE_REFUSAL = 'Editing this site requires the editor role'\nexport const OVERLAY_DRAFT_PLAN_REFUSAL =\n  'Announcement bars and popups are not included on this workspace’s plan — see Billing to upgrade.'\nexport const OVERLAY_DRAFT_ROOM_REFUSAL =\n  `This site already has ${OVERLAY_LIST_CEILING} overlays — delete the ones you have finished with first.`\nexport const EXPERIMENT_DRAFT_PLAN_REFUSAL =\n  'A/B testing is not included on this workspace’s plan — see Billing to upgrade.'\n\nexport interface MarketingDraftWriterDeps {\n  /** The Admin SDK handle; specs hand in a double. */\n  firestore?: () => Firestore\n}\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** The site, and the member's role on it, or the refusal that stands in for them. */\nasync function siteFor(\n  firestore: Firestore,\n  context: Pick<PluginDraftContext, 'hostId' | 'uid' | 'orgId'>,\n): Promise<{ host: FirebaseFirestore.DocumentSnapshot } | PluginDraftRefusal> {\n  const host = await firestore.collection('hosts').doc(context.hostId).get()\n  if (!host.exists || (context.orgId && host.get('orgId') && host.get('orgId') !== context.orgId)) {\n    return { status: 404, error: 'Unknown site' }\n  }\n  const role = ((host.get('memberRoles') ?? {}) as Record<string, unknown>)[context.uid]\n  if (!hostRoleCanWrite(role)) return { status: 403, error: OVERLAY_DRAFT_ROLE_REFUSAL }\n  return { host }\n}\n\nconst isRefusal = (value: object): value is PluginDraftRefusal => 'status' in value\n\nfunction overlayRecord(snapshot: FirebaseFirestore.DocumentSnapshot): PluginDraftRecord {\n  return {\n    id: snapshot.id,\n    name: str(snapshot.get('name')),\n    versionId: null,\n    facts: { kind: snapshot.get('kind') ?? null, enabled: snapshot.get('enabled') !== false },\n  }\n}\n\n/** The overlay content as the writer documents it: a proposal's fields and its kind. */\nfunction overlayProposal(content: Readonly<Record<string, unknown>>): OverlayCopyProposal {\n  const proposal: OverlayCopyProposal = {}\n  for (const field of ['name', 'text', 'headline', 'body', 'ctaLabel', 'trigger'] as const) {\n    if (typeof content[field] === 'string') proposal[field] = content[field] as string\n  }\n  if (typeof content['triggerValue'] === 'number') proposal.triggerValue = content['triggerValue']\n  return proposal\n}\n\n/**\n * The `overlay` writer. Content: `{ kind: 'bar' | 'popup', text?, headline?,\n * body?, ctaLabel?, trigger?, triggerValue? }` — a bar's text, a popup's\n * body, each within the overlay copy limits (`OVERLAY_COPY_LIMITS`).\n */\nexport function createOverlayDraftWriter(deps: MarketingDraftWriterDeps = {}): PluginResourceDraftWriter {\n  const firestore = deps.firestore ?? (() => firebaseAdmin.app().firestore() as unknown as Firestore)\n  const refusal = async (context: PluginDraftContext): Promise<PluginDraftRefusal | null> => {\n    const site = await siteFor(firestore(), context)\n    if (isRefusal(site)) return site\n    if (!checkEntitlement(context.org as never, 'marketingOverlays')) {\n      return { status: 403, error: OVERLAY_DRAFT_PLAN_REFUSAL }\n    }\n    const count = await site.host.ref.collection('overlays').count().get()\n    if (Number(count.data().count) >= OVERLAY_LIST_CEILING) {\n      return { status: 409, error: OVERLAY_DRAFT_ROOM_REFUSAL }\n    }\n    return null\n  }\n  return {\n    refusal,\n    check: (content) => {\n      const problems = overlayDraftContentProblems(content)\n      return problems.length\n        ? { ok: false, problems }\n        : { ok: true, facts: { kind: content['kind'], enabled: false } }\n    },\n    read: async ({ hostId, id }) => {\n      if (!isDocumentId(id)) return null\n      const snapshot = await firestore().collection('hosts').doc(hostId).collection('overlays').doc(id).get()\n      return snapshot.exists ? overlayRecord(snapshot) : null\n    },\n    write: async (request): Promise<PluginDraftWrite> => {\n      if (!isDocumentId(request.id)) return { ok: false, status: 400, error: 'Invalid overlay id' }\n      const problems = overlayDraftContentProblems(request.content)\n      if (problems.length) return { ok: false, status: 400, error: problems[0] }\n      const kind = request.content['kind'] as 'bar' | 'popup'\n      const draft = overlayDraftFromProposal(kind, {\n        ...overlayProposal(request.content),\n        ...(str(request.name) ? { name: str(request.name) } : {}),\n      })\n      if (!draft) return { ok: false, status: 400, error: 'There was no copy to save' }\n      const ref = firestore().collection('hosts').doc(request.hostId).collection('overlays').doc(request.id)\n      const earlier = await ref.get()\n      if (earlier.exists) return { ok: true, replayed: true, ...overlayRecord(earlier) }\n      const refused = await refusal(request)\n      if (refused) return { ok: false, ...refused }\n      const name = draft.name ?? null\n      await ref.create({\n        ...draft,\n        // The list orders on `name`, which every overlay carries, null or not.\n        name,\n        createdAt: request.now,\n        updatedAt: request.now,\n        createdBy: request.uid,\n      })\n      return {\n        ok: true,\n        replayed: false,\n        id: request.id,\n        name: name ?? '',\n        versionId: null,\n        facts: { kind, enabled: false },\n      }\n    },\n  }\n}\n\n/** One variant as the writer documents it. */\ninterface ExperimentDraftVariant {\n  name: string\n  subject?: string\n  body?: string\n  versionId?: string\n}\n\n/** The experiment content, read and checked; problems instead when it is not one. */\nexport function readExperimentDraftContent(\n  content: Readonly<Record<string, unknown>>,\n  name: string,\n): { ok: true; value: HostExperiment } | { ok: false; problems: string[] } {\n  const target = content['target'] as ExperimentTarget\n  const rawVariants = Array.isArray(content['variants']) ? content['variants'] : []\n  const problems: string[] = []\n  if (rawVariants.length > EXPERIMENT_MAX_VARIANTS) {\n    problems.push(`Experiments are capped at ${EXPERIMENT_MAX_VARIANTS} variants`)\n  }\n  const variants = rawVariants.slice(0, EXPERIMENT_MAX_VARIANTS).map((raw, index) => {\n    const variant = (raw ?? {}) as ExperimentDraftVariant\n    const id = String.fromCharCode(97 + index)\n    return {\n      id,\n      name: str(variant.name).slice(0, 80) || (index === 0 ? 'A (control)' : id.toUpperCase()),\n      weight: 1,\n      ...(target === 'email' && str(variant.subject) ? { subject: str(variant.subject).slice(0, 200) } : {}),\n      ...(target === 'email' && str(variant.body) ? { body: str(variant.body).slice(0, 4_000) } : {}),\n      ...(target !== 'email' && str(variant.versionId) ? { versionId: str(variant.versionId) } : {}),\n    }\n  })\n  const goal = str(content['goal'])\n  const value: HostExperiment = {\n    name: str(name || content['name']).slice(0, 120),\n    // STOPPED: assignment serves nothing for a test that is not running.\n    status: 'draft',\n    target,\n    ...(str(content['screenId']) ? { screenId: str(content['screenId']) } : {}),\n    ...(target === 'section' && str(content['nodeId']) ? { nodeId: str(content['nodeId']) } : {}),\n    variants,\n    goal: { event: goal || 'formSubmission' },\n  }\n  const invalid = validateExperiment(value)\n  if (invalid) problems.push(invalid)\n  if (variants.some((variant) => 'versionId' in variant && !isDocumentId(String(variant.versionId)))) {\n    problems.push('A variant names a version that is not one')\n  }\n  return problems.length ? { ok: false, problems } : { ok: true, value }\n}\n\nfunction experimentRecord(snapshot: FirebaseFirestore.DocumentSnapshot): PluginDraftRecord {\n  return {\n    id: snapshot.id,\n    name: str(snapshot.get('name')),\n    versionId: null,\n    facts: { status: snapshot.get('status') ?? null, target: snapshot.get('target') ?? null },\n  }\n}\n\n/**\n * The `experiment` writer. Content: `{ target: 'screen' | 'section' | 'email',\n * screenId?, nodeId?, goal?, variants: [{ name, subject?, body?, versionId? }] }`,\n * two to four variants, the first the control.\n */\nexport function createExperimentDraftWriter(deps: MarketingDraftWriterDeps = {}): PluginResourceDraftWriter {\n  const firestore = deps.firestore ?? (() => firebaseAdmin.app().firestore() as unknown as Firestore)\n  const refusal = async (context: PluginDraftContext): Promise<PluginDraftRefusal | null> => {\n    const site = await siteFor(firestore(), context)\n    if (isRefusal(site)) return site\n    if (!checkEntitlement(context.org as never, 'abTesting')) {\n      return { status: 403, error: EXPERIMENT_DRAFT_PLAN_REFUSAL }\n    }\n    return null\n  }\n  return {\n    refusal,\n    check: (content) => {\n      const read = readExperimentDraftContent(content, str(content['name']) || 'A/B test')\n      return read.ok === false\n        ? read\n        : { ok: true, facts: { status: 'draft', target: read.value.target, variants: read.value.variants.length } }\n    },\n    read: async ({ hostId, id }) => {\n      if (!isDocumentId(id)) return null\n      const snapshot = await firestore().collection('hosts').doc(hostId).collection('experiments').doc(id).get()\n      return snapshot.exists ? experimentRecord(snapshot) : null\n    },\n    write: async (request): Promise<PluginDraftWrite> => {\n      if (!isDocumentId(request.id)) return { ok: false, status: 400, error: 'Invalid experiment id' }\n      const read = readExperimentDraftContent(request.content, request.name || 'A/B test')\n      if (read.ok === false) return { ok: false, status: 400, error: read.problems[0] }\n      const hostRef = firestore().collection('hosts').doc(request.hostId)\n      const ref = hostRef.collection('experiments').doc(request.id)\n      const earlier = await ref.get()\n      if (earlier.exists) return { ok: true, replayed: true, ...experimentRecord(earlier) }\n      const refused = await refusal(request)\n      if (refused) return { ok: false, ...refused }\n      const { value } = read\n      // A page under test, and every version a variant pins, exist on this site.\n      if (value.screenId) {\n        const screenRef = hostRef.collection('screens').doc(value.screenId)\n        const screen = await screenRef.get()\n        if (!screen.exists || screen.get('deletedAt')) {\n          return { ok: false, status: 400, error: 'The page under test does not exist' }\n        }\n        for (const variant of value.variants) {\n          if (!variant.versionId) continue\n          const version = await screenRef.collection('versions').doc(variant.versionId).get()\n          if (!version.exists || version.get('deletedAt')) {\n            return { ok: false, status: 400, error: 'A variant pins a version the page does not have' }\n          }\n        }\n      }\n      await ref.create({\n        ...value,\n        createdAt: request.now,\n        updatedAt: request.now,\n        createdBy: request.uid,\n      })\n      return {\n        ok: true,\n        replayed: false,\n        id: request.id,\n        name: value.name,\n        versionId: null,\n        facts: { status: 'draft', target: value.target },\n      }\n    },\n  }\n}\n\n/**\n * Registers both writers; the console surface calls it, since only the\n * console runs the AI builds that write through them. Idempotent.\n */\nexport function registerMarketingDraftWriters(deps: MarketingDraftWriterDeps = {}): void {\n  registerPluginResourceDraftWriter(OVERLAY_DRAFT_RESOURCE, createOverlayDraftWriter(deps), {\n    pluginId: MARKETING_PLUGIN_ID,\n  })\n  registerPluginResourceDraftWriter(EXPERIMENT_DRAFT_RESOURCE, createExperimentDraftWriter(deps), {\n    pluginId: MARKETING_PLUGIN_ID,\n  })\n}\n"],"names":["hostRoleCanWrite","checkEntitlement","registerPluginResourceDraftWriter","firebaseAdmin","isDocumentId","EXPERIMENT_MAX_VARIANTS","validateExperiment","OVERLAY_LIST_CEILING","overlayDraftContentProblems","overlayDraftFromProposal","OVERLAY_DRAFT_RESOURCE","EXPERIMENT_DRAFT_RESOURCE","MARKETING_PLUGIN_ID","OVERLAY_DRAFT_ROLE_REFUSAL","OVERLAY_DRAFT_PLAN_REFUSAL","OVERLAY_DRAFT_ROOM_REFUSAL","EXPERIMENT_DRAFT_PLAN_REFUSAL","str","value","trim","siteFor","firestore","context","host","collection","doc","hostId","get","exists","orgId","status","error","role","uid","isRefusal","overlayRecord","snapshot","id","name","versionId","facts","kind","enabled","overlayProposal","content","proposal","field","triggerValue","createOverlayDraftWriter","deps","app","refusal","site","org","count","ref","Number","data","check","problems","length","ok","read","write","request","draft","earlier","replayed","refused","create","createdAt","now","updatedAt","createdBy","readExperimentDraftContent","target","rawVariants","Array","isArray","push","variants","slice","map","raw","index","variant","String","fromCharCode","toUpperCase","weight","subject","body","goal","screenId","nodeId","event","invalid","some","experimentRecord","createExperimentDraftWriter","hostRef","screenRef","screen","version","registerMarketingDraftWriters","pluginId"],"mappings":"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"}

package/src/lib/server/marketing-figures.d.ts

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import { type PluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import { type CampaignTouchChannel } from '../model/campaign-conversions';
 /**
  * A site's campaign and A/B testing results as figure tables another plugin
  * reads by id (AGL-2915).
@@ -31,7 +32,24 @@ type Firestore = FirebaseFirestore.Firestore;
 export declare const CAMPAIGN_FIGURES_READ_LIMIT = 100;
 /** Experiments an experiments table reads. */
 export declare const EXPERIMENT_FIGURES_READ_LIMIT = 20;
+/**
+ * The channels a conversion is counted by, in reading order. Each is an
+ * aggregation count over the attribution records — `kind`, `channel` and the
+ * window on `convertedAtMs` — so the table costs a read per thousand index
+ * entries rather than a read per record, and never loads one.
+ */
+export declare const CONVERSION_FIGURE_CHANNELS: readonly CampaignTouchChannel[];
 export declare function marketingFigureReaders(firestore: () => Firestore): PluginFigureReader[];
+/**
+ * What the site's campaigns CAUSED and EARNED, as two more tables (AGL-3603):
+ * the conversions credited to a campaign touch in the window, and the revenue
+ * credited to the campaign emails sent in it. Same rules the Conversions
+ * section and a campaign's report print — the kinds are never added together,
+ * currencies are never added together, net is gross less refunded — and the
+ * same honesty about what is NOT here: a conversion credited to nothing has no
+ * record, so it is not counted, and the notes say so.
+ */
+export declare function marketingOutcomeFigureReaders(firestore: () => Firestore): PluginFigureReader[];
 /** Registers the campaign and A/B testing readers from the console surface, where insight jobs run. */
 export declare function registerMarketingFigureReaders(firestore: () => Firestore): void;
 export {};