@aglyn/plugins-marketing 1.0.0-beta.143

package/src/lib/components/campaign-email-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/campaign-email-zones.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { useConsoleWidgetSlot } from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport type { SendingIdentityView } from '@aglyn/tenant-feature-instance/hooks/use-sending-identity-api'\nimport { Suspense, type ReactElement } from 'react'\n\n/**\n * WHAT A CAMPAIGN EMAIL ASKS OF WHICHEVER PLUGIN KEEPS THE MAIL ITSELF.\n *\n * A campaign is this plugin's: who it goes to, when, under which container,\n * and what came of it. The mail it rides on is not. The catalog of streams a\n * recipient can leave, the identities a site may send as, the design document\n * a message is built from and the renderer that turns one into what an inbox\n * receives all belong to the plugin that keeps email, and a composer that\n * imported them would make this package uninstallable without that one.\n *\n * So each is a zone this plugin hosts. It hands over what it holds — the\n * site, the value, a callback — and draws whatever a widget there draws. A\n * widget never writes a campaign: it reports a choice through the callback\n * and the composer does the write, because the record is this plugin's.\n *\n * Outside a console shell, and in a workspace with no plugin filling a zone,\n * each of these draws nothing.\n */\n\n/** The stream this email belongs to, chosen before it is sent. */\nexport interface CampaignTopicSelectZoneProps {\n  hostId: string\n  /** The chosen topic id; empty until the widget settles it on a real one. */\n  value: string\n  onChange: (topicId: string) => void\n  disabled?: boolean\n}\n\nexport const CAMPAIGN_TOPIC_SELECT_ZONE =\n  definePluginZone<CampaignTopicSelectZoneProps>('campaignTopicSelect')\n\n/** One stream a campaign can open on. */\nexport interface CampaignTopicOption {\n  id: string\n  name: string\n}\n\n/**\n * The streams a campaign can open on, REPORTED rather than drawn.\n *\n * The two drawers that collect a campaign's topic are generic forms whose\n * select takes a list of options, so what they need from the catalog's owner\n * is the list. A widget here draws nothing: it reads the catalog while\n * `enabled` and answers through `onTopics`. `enabled` is the read gate —\n * the catalog is the section's largest read and only an open drawer needs it.\n */\nexport interface CampaignTopicOptionsZoneProps {\n  hostId: string\n  enabled: boolean\n  onTopics: (topics: readonly CampaignTopicOption[]) => void\n}\n\nexport const CAMPAIGN_TOPIC_OPTIONS_ZONE =\n  definePluginZone<CampaignTopicOptionsZoneProps>('campaignTopicOptions')\n\n/**\n * Adding a sender without leaving the email being written. The widget is the\n * editor, opened in its ADD mode; `onSaved` names the sender it created so\n * the composer can select it once its own read shows the row.\n */\nexport interface CampaignSenderEditorZoneProps {\n  hostId: string\n  view: SendingIdentityView | null\n  onClose: () => void\n  onSaved: (senderId?: string) => void\n}\n\nexport const CAMPAIGN_SENDER_EDITOR_ZONE =\n  definePluginZone<CampaignSenderEditorZoneProps>('campaignSenderEditor')\n\n/**\n * A design document of this email's own. The widget is the control that mints\n * one; `onCreated` names it, and the composer records the choice on the\n * campaign and opens the editor.\n */\nexport interface CampaignDesignCreateZoneProps {\n  hostId: string\n  /** What to call the design, so the picker does not list \"Untitled email\". */\n  name?: string\n  onCreated: (design: { screenId: string; versionId: string }) => void\n  onError: (error: unknown) => void\n}\n\nexport const CAMPAIGN_DESIGN_CREATE_ZONE =\n  definePluginZone<CampaignDesignCreateZoneProps>('campaignDesignCreate')\n\n/** The message as an inbox receives it, on the message's own page. */\nexport interface CampaignDesignPreviewZoneProps {\n  hostId: string\n  /** The version document's raw `nodes` field, in any of its stored forms. */\n  nodes: unknown\n  /** The plain-text body, for a message composed without a design. */\n  text?: string\n  loading?: boolean\n  subject?: string\n  preheader?: string\n  emptyMessage: string\n  note?: string\n}\n\nexport const CAMPAIGN_DESIGN_PREVIEW_ZONE =\n  definePluginZone<CampaignDesignPreviewZoneProps>('campaignDesignPreview')\n\n/**\n * Draws one of the zones above where the shell provides a renderer.\n *\n * Under its own \\`Suspense\\`, with nothing as the fallback. A widget is a lazy\n * chunk, and several of these mount in answer to a click — the sender editor,\n * the topics behind an opening drawer. Without a boundary here the suspension\n * would climb to the page's, and the form being filled in would be swapped\n * for a loading state while one drawer's code arrives.\n */\nfunction zoneHost<Props extends object>(zone: { id: string }, name: string) {\n  function Host(props: Props): ReactElement | null {\n    const Zone = useConsoleWidgetSlot()\n    return Zone ? (\n      <Suspense fallback={null}>\n        <Zone slot={zone.id} {...props} />\n      </Suspense>\n    ) : null\n  }\n  Host.displayName = name\n  return Host\n}\n\nexport const CampaignTopicSelect = zoneHost<CampaignTopicSelectZoneProps>(\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n  'CampaignTopicSelect',\n)\nexport const CampaignTopicOptions = zoneHost<CampaignTopicOptionsZoneProps>(\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  'CampaignTopicOptions',\n)\nexport const CampaignSenderEditor = zoneHost<CampaignSenderEditorZoneProps>(\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  'CampaignSenderEditor',\n)\nexport const CampaignDesignCreate = zoneHost<CampaignDesignCreateZoneProps>(\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  'CampaignDesignCreate',\n)\nexport const CampaignDesignPreview = zoneHost<CampaignDesignPreviewZoneProps>(\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  'CampaignDesignPreview',\n)\n"],"names":["useConsoleWidgetSlot","definePluginZone","Suspense","CAMPAIGN_TOPIC_SELECT_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","zoneHost","zone","name","Host","props","Zone","fallback","slot","id","displayName","CampaignTopicSelect","CampaignTopicOptions","CampaignSenderEditor","CampaignDesignCreate","CampaignDesignPreview"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,oBAAoB,QAAQ,qDAAoD;AACzF,SAASC,gBAAgB,QAAQ,2CAA0C;AAE3E,SAASC,QAAQ,QAA2B,QAAO;AA8BnD,OAAO,MAAMC,6BACXF,iBAA+C,uBAAsB;AAuBvE,OAAO,MAAMG,8BACXH,iBAAgD,wBAAuB;AAczE,OAAO,MAAMI,8BACXJ,iBAAgD,wBAAuB;AAezE,OAAO,MAAMK,8BACXL,iBAAgD,wBAAuB;AAgBzE,OAAO,MAAMM,+BACXN,iBAAiD,yBAAwB;AAE3E;;;;;;;;CAQC,GACD,SAASO,SAA+BC,IAAoB,EAAEC,IAAY;IACxE,SAASC,KAAKC,KAAY;QACxB,MAAMC,OAAOb;QACb,OAAOa,qBACL,KAACX;YAASY,UAAU;sBAClB,cAAA,KAACD;gBAAKE,MAAMN,KAAKO,EAAE;eAAMJ;aAEzB;IACN;IACAD,KAAKM,WAAW,GAAGP;IACnB,OAAOC;AACT;AAEA,OAAO,MAAMO,sBAAsBV,SACjCL,4BACA,uBACD;AACD,OAAO,MAAMgB,uBAAuBX,SAClCJ,6BACA,wBACD;AACD,OAAO,MAAMgB,uBAAuBZ,SAClCH,6BACA,wBACD;AACD,OAAO,MAAMgB,uBAAuBb,SAClCF,6BACA,wBACD;AACD,OAAO,MAAMgB,wBAAwBd,SACnCD,8BACA,yBACD"}

package/src/lib/components/campaign-glance-card.component.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Last campaign at a glance (AGL-353): sent, opens and clicks for the most
+ * recent send.
+ *
+ * Registered by the marketing plugin rather than imported by the dashboard.
+ * Campaigns are managed from the Marketing page, so a workspace with the
+ * marketing plugin switched off has no campaigns page to open and the card
+ * could only ever be blank there. The header links to the surface that owns
+ * the history for the same reason: it is the one this widget's own plugin
+ * guarantees exists.
+ */
+export declare function CampaignGlanceCard(props: {
+    hostId: string;
+}): import("react").JSX.Element;
+export declare namespace CampaignGlanceCard {
+    var displayName: string;
+}
+export default CampaignGlanceCard;

package/src/lib/components/campaign-glance-card.component.js

@@ -0,0 +1,151 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { buildRoute, pluginDocsHelp, Route } from "@aglyn/aglyn";
+import { AppLink, CardDisplay } from "@aglyn/shared-ui-jsx";
+import { Button, Stack, Typography } from "@mui/material";
+import { collection, limit, query } from "firebase/firestore";
+import { useParams } from "next/navigation";
+import { useMemo } from "react";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+/**
+ * How many campaigns the card reads to find the last SENT one.
+ *
+ * A ceiling on a search, not a page: the newest send is what the card is
+ * about, and a site whose thirty most recent campaigns are all drafts simply
+ * has nothing to show — the card renders nothing at all in that case, which
+ * is the same answer it gives a site that has never sent.
+ */ const SEARCH_CEILING = 30;
+/**
+ * Last campaign at a glance (AGL-353): sent, opens and clicks for the most
+ * recent send.
+ *
+ * Registered by the marketing plugin rather than imported by the dashboard.
+ * Campaigns are managed from the Marketing page, so a workspace with the
+ * marketing plugin switched off has no campaigns page to open and the card
+ * could only ever be blank there. The header links to the surface that owns
+ * the history for the same reason: it is the one this widget's own plugin
+ * guarantees exists.
+ */ export function CampaignGlanceCard(props) {
+    var _ref, _ref1, _ref2;
+    var _lastSent_stats, _lastSent_stats1, _lastSent_stats2;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { orgSlug, host } = useParams();
+    const { data: campaignDocs } = useFirestoreCollection(()=>query(collection(firestore, 'hosts', hostId, 'campaigns'), limit(SEARCH_CEILING)), [
+        firestore,
+        hostId
+    ], {
+        idField: '$id'
+    });
+    const lastSent = useMemo(()=>[
+            ...campaignDocs != null ? campaignDocs : []
+        ].filter((campaign)=>campaign.status === 'sent').sort((a, b)=>{
+            var _ref, _ref1;
+            var _b_sentAt, _a_sentAt;
+            return ((_ref = (_b_sentAt = b.sentAt) == null ? void 0 : _b_sentAt.seconds) != null ? _ref : 0) - ((_ref1 = (_a_sentAt = a.sentAt) == null ? void 0 : _a_sentAt.seconds) != null ? _ref1 : 0);
+        })[0], [
+        campaignDocs
+    ]);
+    if (!lastSent) return null;
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Last campaign',
+        help: pluginDocsHelp('emailCampaigns', {
+            anchor: '#opens--clicks',
+            excerpt: 'Sent, opens, and clicks for your most recent campaign — open ' + 'Campaigns for the full history.'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        HeaderProps: {
+            action: /*#__PURE__*/ _jsx(Button, _extends({
+                component: AppLink
+            }, {
+                componentVariant: 'naked',
+                nativeButton: false
+            }, {
+                href: `${buildRoute(Route.HOST_PLUGIN, {
+                    orgSlug,
+                    host,
+                    pluginSlug: 'marketing'
+                })}/campaigns`,
+                size: "small",
+                color: "primary",
+                children: 'Campaigns'
+            }))
+        },
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1,
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    noWrap: true,
+                    children: lastSent.subject
+                }),
+                /*#__PURE__*/ _jsxs(Stack, {
+                    direction: "row",
+                    spacing: 3,
+                    children: [
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "h6",
+                                    children: (_ref = (_lastSent_stats = lastSent.stats) == null ? void 0 : _lastSent_stats.sent) != null ? _ref : 0
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: 'Sent'
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "h6",
+                                    children: (_ref1 = (_lastSent_stats1 = lastSent.stats) == null ? void 0 : _lastSent_stats1.opens) != null ? _ref1 : 0
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: 'Opens'
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "h6",
+                                    children: (_ref2 = (_lastSent_stats2 = lastSent.stats) == null ? void 0 : _lastSent_stats2.clicks) != null ? _ref2 : 0
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: 'Clicks'
+                                })
+                            ]
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+CampaignGlanceCard.displayName = 'CampaignGlanceCard';
+export default CampaignGlanceCard;
+
+//# sourceMappingURL=campaign-glance-card.component.js.map

package/src/lib/components/campaign-glance-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/components/campaign-glance-card.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { buildRoute, pluginDocsHelp, Route } from '@aglyn/aglyn'\nimport { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { Button, Stack, Typography } from '@mui/material'\nimport { collection, limit, query } from 'firebase/firestore'\nimport { useParams } from 'next/navigation'\nimport { useMemo } from 'react'\nimport { useFirestore, useFirestoreCollection } from '@aglyn/tenant-feature-instance'\n\n/**\n * How many campaigns the card reads to find the last SENT one.\n *\n * A ceiling on a search, not a page: the newest send is what the card is\n * about, and a site whose thirty most recent campaigns are all drafts simply\n * has nothing to show — the card renders nothing at all in that case, which\n * is the same answer it gives a site that has never sent.\n */\nconst SEARCH_CEILING = 30\n\n/**\n * Last campaign at a glance (AGL-353): sent, opens and clicks for the most\n * recent send.\n *\n * Registered by the marketing plugin rather than imported by the dashboard.\n * Campaigns are managed from the Marketing page, so a workspace with the\n * marketing plugin switched off has no campaigns page to open and the card\n * could only ever be blank there. The header links to the surface that owns\n * the history for the same reason: it is the one this widget's own plugin\n * guarantees exists.\n */\nexport function CampaignGlanceCard(props: { hostId: string }) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { orgSlug, host } = useParams<{ orgSlug: string; host: string }>()\n  const { data: campaignDocs } = useFirestoreCollection<any>(\n    () =>\n      query(\n        collection(firestore, 'hosts', hostId, 'campaigns'),\n        limit(SEARCH_CEILING),\n      ),\n    [firestore, hostId],\n    { idField: '$id' },\n  )\n  const lastSent = useMemo(\n    () =>\n      [...(campaignDocs ?? [])]\n        .filter((campaign: any) => campaign.status === 'sent')\n        .sort(\n          (a: any, b: any) =>\n            (b.sentAt?.seconds ?? 0) - (a.sentAt?.seconds ?? 0),\n        )[0],\n    [campaignDocs],\n  )\n\n  if (!lastSent) return null\n\n  return (\n    <CardDisplay\n      header={'Last campaign'}\n      help={pluginDocsHelp('emailCampaigns', {\n        anchor: '#opens--clicks',\n        excerpt:\n          'Sent, opens, and clicks for your most recent campaign — open ' +\n          'Campaigns for the full history.',\n      })}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{\n        action: (\n          <Button\n            component={AppLink as any}\n            {...({ componentVariant: 'naked', nativeButton: false } as any)}\n            href={`${buildRoute(Route.HOST_PLUGIN, {\n              orgSlug,\n              host,\n              pluginSlug: 'marketing',\n            })}/campaigns`}\n            size=\"small\"\n            color=\"primary\"\n          >\n            {'Campaigns'}\n          </Button>\n        ),\n      }}\n    >\n      <Stack spacing={1}>\n        <Typography variant=\"body2\" noWrap>\n          {lastSent.subject}\n        </Typography>\n        <Stack direction=\"row\" spacing={3}>\n          <Stack>\n            <Typography variant=\"h6\">{lastSent.stats?.sent ?? 0}</Typography>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'Sent'}\n            </Typography>\n          </Stack>\n          <Stack>\n            <Typography variant=\"h6\">{lastSent.stats?.opens ?? 0}</Typography>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'Opens'}\n            </Typography>\n          </Stack>\n          <Stack>\n            <Typography variant=\"h6\">{lastSent.stats?.clicks ?? 0}</Typography>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {'Clicks'}\n            </Typography>\n          </Stack>\n        </Stack>\n      </Stack>\n    </CardDisplay>\n  )\n}\nCampaignGlanceCard.displayName = 'CampaignGlanceCard'\n\nexport default CampaignGlanceCard\n"],"names":["buildRoute","pluginDocsHelp","Route","AppLink","CardDisplay","Button","Stack","Typography","collection","limit","query","useParams","useMemo","useFirestore","useFirestoreCollection","SEARCH_CEILING","CampaignGlanceCard","props","lastSent","hostId","firestore","orgSlug","host","data","campaignDocs","idField","filter","campaign","status","sort","a","b","sentAt","seconds","header","help","anchor","excerpt","contentGutterX","contentGutterY","HeaderProps","action","component","componentVariant","nativeButton","href","HOST_PLUGIN","pluginSlug","size","color","spacing","variant","noWrap","subject","direction","stats","sent","opens","clicks","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SAASA,UAAU,EAAEC,cAAc,EAAEC,KAAK,QAAQ,eAAc;AAChE,SAASC,OAAO,EAAEC,WAAW,QAAQ,uBAAsB;AAC3D,SAASC,MAAM,EAAEC,KAAK,EAAEC,UAAU,QAAQ,gBAAe;AACzD,SAASC,UAAU,EAAEC,KAAK,EAAEC,KAAK,QAAQ,qBAAoB;AAC7D,SAASC,SAAS,QAAQ,kBAAiB;AAC3C,SAASC,OAAO,QAAQ,QAAO;AAC/B,SAASC,YAAY,EAAEC,sBAAsB,QAAQ,iCAAgC;AAErF;;;;;;;CAOC,GACD,MAAMC,iBAAiB;AAEvB;;;;;;;;;;CAUC,GACD,OAAO,SAASC,mBAAmBC,KAAyB;;QA6DtBC,iBAMAA,kBAMAA;IAxEpC,MAAM,EAAEC,MAAM,EAAE,GAAGF;IACnB,MAAMG,YAAYP;IAClB,MAAM,EAAEQ,OAAO,EAAEC,IAAI,EAAE,GAAGX;IAC1B,MAAM,EAAEY,MAAMC,YAAY,EAAE,GAAGV,uBAC7B,IACEJ,MACEF,WAAWY,WAAW,SAASD,QAAQ,cACvCV,MAAMM,kBAEV;QAACK;QAAWD;KAAO,EACnB;QAAEM,SAAS;IAAM;IAEnB,MAAMP,WAAWN,QACf,IACE;eAAKY,uBAAAA,eAAgB,EAAE;SAAE,CACtBE,MAAM,CAAC,CAACC,WAAkBA,SAASC,MAAM,KAAK,QAC9CC,IAAI,CACH,CAACC,GAAQC;;gBACNA,WAA2BD;mBAA5B,UAACC,YAAAA,EAAEC,MAAM,qBAARD,UAAUE,OAAO,mBAAI,gBAAMH,YAAAA,EAAEE,MAAM,qBAARF,UAAUG,OAAO,oBAAI;UACpD,CAAC,EAAE,EACR;QAACT;KAAa;IAGhB,IAAI,CAACN,UAAU,OAAO;IAEtB,qBACE,KAACd;QACC8B,QAAQ;QACRC,MAAMlC,eAAe,kBAAkB;YACrCmC,QAAQ;YACRC,SACE,kEACA;QACJ;QACAC,cAAc;QACdC,cAAc;QACdC,aAAa;YACXC,sBACE,KAACpC;gBACCqC,WAAWvC;eACN;gBAAEwC,kBAAkB;gBAASC,cAAc;YAAM;gBACtDC,MAAM,GAAG7C,WAAWE,MAAM4C,WAAW,EAAE;oBACrCzB;oBACAC;oBACAyB,YAAY;gBACd,GAAG,UAAU,CAAC;gBACdC,MAAK;gBACLC,OAAM;0BAEL;;QAGP;kBAEA,cAAA,MAAC3C;YAAM4C,SAAS;;8BACd,KAAC3C;oBAAW4C,SAAQ;oBAAQC,MAAM;8BAC/BlC,SAASmC,OAAO;;8BAEnB,MAAC/C;oBAAMgD,WAAU;oBAAMJ,SAAS;;sCAC9B,MAAC5C;;8CACC,KAACC;oCAAW4C,SAAQ;uDAAMjC,kBAAAA,SAASqC,KAAK,qBAAdrC,gBAAgBsC,IAAI,mBAAI;;8CAClD,KAACjD;oCAAW4C,SAAQ;oCAAUF,OAAM;8CACjC;;;;sCAGL,MAAC3C;;8CACC,KAACC;oCAAW4C,SAAQ;wDAAMjC,mBAAAA,SAASqC,KAAK,qBAAdrC,iBAAgBuC,KAAK,oBAAI;;8CACnD,KAAClD;oCAAW4C,SAAQ;oCAAUF,OAAM;8CACjC;;;;sCAGL,MAAC3C;;8CACC,KAACC;oCAAW4C,SAAQ;wDAAMjC,mBAAAA,SAASqC,KAAK,qBAAdrC,iBAAgBwC,MAAM,oBAAI;;8CACpD,KAACnD;oCAAW4C,SAAQ;oCAAUF,OAAM;8CACjC;;;;;;;;;AAOf;AACAjC,mBAAmB2C,WAAW,GAAG;AAEjC,eAAe3C,mBAAkB"}

package/src/lib/components/campaign-members-section.d.ts

@@ -0,0 +1,87 @@
+export interface CampaignMembersSectionProps {
+    hostId: string;
+    campaignId: string;
+    /** The campaign's first day, when it has one. */
+    startAtMs?: number | null;
+    /** The campaign's last day, when it has one. */
+    endAtMs?: number | null;
+}
+/**
+ * WHAT ELSE IS IN THIS CAMPAIGN — the landing pages and forms assigned to it,
+ * and what those forms have collected.
+ *
+ * ## Declared, and therefore different from every section above it
+ *
+ * The conversions, revenue and destinations sections are EVIDENCE: they join
+ * on the campaign's send ids and report what visitors did BECAUSE of this
+ * campaign's mail. This one is a statement the merchant made — a screen or a
+ * form carries this campaign's id in {@link CAMPAIGN_MEMBERSHIP_FIELD} — plus
+ * the counters those records carry on their own documents.
+ *
+ * The distinction survives into the wording, because the arithmetic will not
+ * enforce it. A form's submissions are the form's; filing the form under a
+ * campaign does not make them the campaign's, and a heading that said
+ * "this campaign produced 40 leads" over a number meaning "the forms filed
+ * here have 40 leads" would be a worse page than one showing nothing. So the
+ * figures are labeled as what the forms HOLD, they sit in their own block
+ * under their own disclaimer, and no total on this page adds them to an
+ * attributed one.
+ *
+ * ## Three ways the forms' counters could mislead, each answered
+ *
+ *  1. **They are lifetime.** `stats.submissions` has counted since the form
+ *     existed, including every submission from before anybody filed it here.
+ *     Where the campaign carries dates, the figures are summed from the
+ *     monthly `stats.periods` series over those months instead, and the
+ *     caption says which of the two a reader is looking at. Months are whole,
+ *     so a campaign starting mid-month includes that month entire — stated,
+ *     not rounded away.
+ *  2. **A form can be in twenty campaigns.** `campaignIds` is an array, so
+ *     the same submissions count toward every campaign the form is filed
+ *     under. Rows say so and the total refuses to present itself as
+ *     exclusive.
+ *  3. **A counter nobody wrote is not a zero.** `stats.leads` is incremented
+ *     only for a form whose `routing.lead` is set, and `stats.views` only by
+ *     the analytics beacon. Both reach the shared `Figure`, which draws an em
+ *     dash and the words "not recorded" rather than a confident 0.
+ *
+ * ## Screens carry no counter, and this section will not invent one
+ *
+ * A form's counters ride on the form document, so the query this section
+ * already makes pays for them. A screen's traffic does not: it is one
+ * document per screen per day in `hosts/{hostId}/screenAnalytics`, with no
+ * lifetime total anywhere, so a views column here would cost a range read
+ * across screens times days on every open of this page — and the display of
+ * those figures is a paid entitlement this section does not resolve. The
+ * screens block names the absence and links to the surface that does measure
+ * it, which is a smaller lie than a number nobody can stand behind.
+ *
+ * ## The join is `array-contains`, on the member's own document
+ *
+ * A campaign holds no member list. Each record names the campaigns it is in,
+ * which is what makes deleting one record leave nothing behind and what lets
+ * a record's own page draw its campaigns without a query. The query here is
+ * the other direction of the same field, served by Firestore's automatic
+ * single-field index.
+ *
+ * `orderBy(documentId())`, like every other bounded list in this console: a
+ * form carries `updatedAt` only if some writer stamped one, and ordering on a
+ * field a writer may omit does not mis-sort the list, it drops rows from it.
+ *
+ * ## Contacts are named here and NOT listed, and the reason is a query limit
+ *
+ * A contact is org-scoped and shared between the sites that captured it, so
+ * every client read of the collection has to carry
+ * `visibleTo array-contains-any` — that is what makes the read provable
+ * per-document under the rules. Firestore permits ONE array clause per query,
+ * and that is it: there is no client query that filters contacts by campaign
+ * as well, so there is no pre-filtered address to link to either. The link
+ * offered goes to the Contacts page and says it arrives unfiltered; the
+ * assignment is real, is set from the contact's own drawer, and a count of it
+ * would cost a scan of the collection the customer is billed on.
+ */
+export declare function CampaignMembersSection(props: CampaignMembersSectionProps): import("react").JSX.Element;
+export declare namespace CampaignMembersSection {
+    var displayName: string;
+}
+export default CampaignMembersSection;