@aglyn/plugins-email 1.0.0-beta.143

package/src/lib/hooks/use-org-contact-fields.js

@@ -0,0 +1,91 @@
+/**
+ * @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";
+/**
+ * The org's custom contact field DEFINITIONS, for the rule editor to offer
+ * (AGL-2603).
+ *
+ * A twin of `use-org-lists.ts`: a LOOKUP that fills one control's options,
+ * bounded so an org cannot turn the dropdown into an unbounded read. The
+ * definitions live in `orgs/{orgId}/contactFields` and the values a rule
+ * compares against live under each contact facet's `custom`, keyed by the
+ * definition's `key` — so the picker offers keys, and the clause it authors
+ * names one.
+ *
+ * ## Scoped like the contacts themselves
+ *
+ * The rules gate the collection on the contacts predicate, per document, so
+ * a collaborator scoped to one site reading it unfiltered is refused rather
+ * than shown less. The viewer's scope tokens narrow the query the way every
+ * CRM read is narrowed; an org-wide member reads without a filter, which is
+ * what keeps a definition the backfill never stamped from vanishing for them.
+ *
+ * ## A retired field is offered nowhere new
+ *
+ * `retiredAt` is a retirement, not a deletion: values written under the key
+ * survive and an export still reads them back. A rule written before the
+ * retirement keeps its clause — the editor shows the key it names — but the
+ * picker stops offering the field, because a merchant building a new
+ * audience on a field their team has retired is building it on a value
+ * nobody is maintaining.
+ */ import { CRM_COLLECTIONS } from "@aglyn/aglyn";
+import { collection, limit, query, where } from "firebase/firestore";
+import { useMemo } from "react";
+import { useFirestore, useFirestoreCollection, useScopeTokens } from "@aglyn/tenant-feature-instance";
+/** The picker's window. Matches the list and segment pickers beside it. */ export const CONTACT_FIELD_PICKER_LIMIT = 50;
+export function useOrgContactFields(scope) {
+    const firestore = useFirestore();
+    const { tokens, orgWide, loaded } = useScopeTokens(scope[1]);
+    const { data, status } = useFirestoreCollection(()=>// Not until the viewer's reach is known: `useScopeTokens` reports
+        // org-wide while loading, and a scoped member's first render would
+        // send an unfiltered query the rules deny per document.
+        loaded ? query(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.contactFields), ...orgWide ? [] : [
+            where('visibleTo', 'array-contains-any', tokens)
+        ], limit(CONTACT_FIELD_PICKER_LIMIT)) : null, [
+        firestore,
+        scope[0],
+        scope[1],
+        loaded,
+        orgWide,
+        tokens
+    ], {
+        idField: '$id'
+    });
+    return useMemo(()=>({
+            fields: (data != null ? data : []).filter((field)=>!field.retiredAt && typeof field.key === 'string').sort((a, b)=>{
+                var _a_order, _b_order;
+                return ((_a_order = a.order) != null ? _a_order : 0) - ((_b_order = b.order) != null ? _b_order : 0);
+            }).map(({ $id, key, label, type, options, order })=>_extends({
+                    $id,
+                    key,
+                    label: label || key,
+                    type
+                }, options ? {
+                    options
+                } : {}, {
+                    order: order != null ? order : 0
+                })),
+            ready: loaded && status !== 'loading'
+        }), [
+        data,
+        loaded,
+        status
+    ]);
+}
+export default useOrgContactFields;
+
+//# sourceMappingURL=use-org-contact-fields.js.map

package/src/lib/hooks/use-org-contact-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/hooks/use-org-contact-fields.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\n/**\n * The org's custom contact field DEFINITIONS, for the rule editor to offer\n * (AGL-2603).\n *\n * A twin of `use-org-lists.ts`: a LOOKUP that fills one control's options,\n * bounded so an org cannot turn the dropdown into an unbounded read. The\n * definitions live in `orgs/{orgId}/contactFields` and the values a rule\n * compares against live under each contact facet's `custom`, keyed by the\n * definition's `key` — so the picker offers keys, and the clause it authors\n * names one.\n *\n * ## Scoped like the contacts themselves\n *\n * The rules gate the collection on the contacts predicate, per document, so\n * a collaborator scoped to one site reading it unfiltered is refused rather\n * than shown less. The viewer's scope tokens narrow the query the way every\n * CRM read is narrowed; an org-wide member reads without a filter, which is\n * what keeps a definition the backfill never stamped from vanishing for them.\n *\n * ## A retired field is offered nowhere new\n *\n * `retiredAt` is a retirement, not a deletion: values written under the key\n * survive and an export still reads them back. A rule written before the\n * retirement keeps its clause — the editor shows the key it names — but the\n * picker stops offering the field, because a merchant building a new\n * audience on a field their team has retired is building it on a value\n * nobody is maintaining.\n */\n\nimport { CRM_COLLECTIONS, type ContactFieldDefinition } from '@aglyn/aglyn'\nimport { collection, limit, query, where } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useScopeTokens,\n} from '@aglyn/tenant-feature-instance'\n\n/** One definition, as the picker and the value control need it. */\nexport type OrgContactFieldOption = Pick<\n  ContactFieldDefinition,\n  'key' | 'label' | 'type' | 'options' | 'order'\n> & { $id: string }\n\n/** The picker's window. Matches the list and segment pickers beside it. */\nexport const CONTACT_FIELD_PICKER_LIMIT = 50\n\nexport function useOrgContactFields(\n  scope: readonly [string, string],\n): { fields: OrgContactFieldOption[]; ready: boolean } {\n  const firestore = useFirestore()\n  const { tokens, orgWide, loaded } = useScopeTokens(scope[1])\n  const { data, status } = useFirestoreCollection<\n    OrgContactFieldOption & { retiredAt?: number | null }\n  >(\n    () =>\n      // Not until the viewer's reach is known: `useScopeTokens` reports\n      // org-wide while loading, and a scoped member's first render would\n      // send an unfiltered query the rules deny per document.\n      loaded\n        ? query(\n            collection(\n              firestore,\n              scope[0],\n              scope[1],\n              CRM_COLLECTIONS.contactFields,\n            ),\n            ...(orgWide ? [] : [where('visibleTo', 'array-contains-any', tokens)]),\n            limit(CONTACT_FIELD_PICKER_LIMIT),\n          )\n        : null,\n    [firestore, scope[0], scope[1], loaded, orgWide, tokens],\n    { idField: '$id' },\n  )\n  return useMemo(\n    () => ({\n      fields: (data ?? [])\n        .filter((field) => !field.retiredAt && typeof field.key === 'string')\n        .sort((a, b) => (a.order ?? 0) - (b.order ?? 0))\n        .map(({ $id, key, label, type, options, order }) => ({\n          $id,\n          key,\n          label: label || key,\n          type,\n          ...(options ? { options } : {}),\n          order: order ?? 0,\n        })),\n      ready: loaded && status !== 'loading',\n    }),\n    [data, loaded, status],\n  )\n}\n\nexport default useOrgContactFields\n"],"names":["CRM_COLLECTIONS","collection","limit","query","where","useMemo","useFirestore","useFirestoreCollection","useScopeTokens","CONTACT_FIELD_PICKER_LIMIT","useOrgContactFields","scope","firestore","tokens","orgWide","loaded","data","status","contactFields","idField","fields","filter","field","retiredAt","key","sort","a","b","order","map","$id","label","type","options","ready"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GAED,SAASA,eAAe,QAAqC,eAAc;AAC3E,SAASC,UAAU,EAAEC,KAAK,EAAEC,KAAK,EAAEC,KAAK,QAAQ,qBAAoB;AACpE,SAASC,OAAO,QAAQ,QAAO;AAC/B,SACEC,YAAY,EACZC,sBAAsB,EACtBC,cAAc,QACT,iCAAgC;AAQvC,yEAAyE,GACzE,OAAO,MAAMC,6BAA6B,GAAE;AAE5C,OAAO,SAASC,oBACdC,KAAgC;IAEhC,MAAMC,YAAYN;IAClB,MAAM,EAAEO,MAAM,EAAEC,OAAO,EAAEC,MAAM,EAAE,GAAGP,eAAeG,KAAK,CAAC,EAAE;IAC3D,MAAM,EAAEK,IAAI,EAAEC,MAAM,EAAE,GAAGV,uBAGvB,IACE,kEAAkE;QAClE,mEAAmE;QACnE,wDAAwD;QACxDQ,SACIZ,MACEF,WACEW,WACAD,KAAK,CAAC,EAAE,EACRA,KAAK,CAAC,EAAE,EACRX,gBAAgBkB,aAAa,MAE3BJ,UAAU,EAAE,GAAG;YAACV,MAAM,aAAa,sBAAsBS;SAAQ,EACrEX,MAAMO,+BAER,MACN;QAACG;QAAWD,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;QAAEI;QAAQD;QAASD;KAAO,EACxD;QAAEM,SAAS;IAAM;IAEnB,OAAOd,QACL,IAAO,CAAA;YACLe,QAAQ,CAACJ,eAAAA,OAAQ,EAAE,EAChBK,MAAM,CAAC,CAACC,QAAU,CAACA,MAAMC,SAAS,IAAI,OAAOD,MAAME,GAAG,KAAK,UAC3DC,IAAI,CAAC,CAACC,GAAGC;oBAAOD,UAAiBC;uBAAlB,EAACD,WAAAA,EAAEE,KAAK,YAAPF,WAAW,OAAMC,WAAAA,EAAEC,KAAK,YAAPD,WAAW;eAC5CE,GAAG,CAAC,CAAC,EAAEC,GAAG,EAAEN,GAAG,EAAEO,KAAK,EAAEC,IAAI,EAAEC,OAAO,EAAEL,KAAK,EAAE,GAAM;oBACnDE;oBACAN;oBACAO,OAAOA,SAASP;oBAChBQ;mBACIC,UAAU;oBAAEA;gBAAQ,IAAI,CAAC;oBAC7BL,KAAK,EAAEA,gBAAAA,QAAS;;YAEpBM,OAAOnB,UAAUE,WAAW;QAC9B,CAAA,GACA;QAACD;QAAMD;QAAQE;KAAO;AAE1B;AAEA,eAAeP,oBAAmB"}

package/src/lib/hooks/use-org-contact-segments.d.ts

@@ -0,0 +1,16 @@
+/** One saved segment, as the picker needs it. */
+export interface OrgContactSegment {
+    $id: string;
+    name?: string;
+}
+/**
+ * The picker's window.
+ *
+ * Bounded rather than paged — see the module note. A rule that names a segment
+ * beyond this window still shows its own reference: the picker adds the stored
+ * id as an option of its own, because a `Select` whose value is absent from
+ * its options renders empty, and saving from that screen would erase the
+ * reference the merchant could not see.
+ */
+export declare const SEGMENT_PICKER_LIMIT = 50;
+export declare function useOrgContactSegments(scope: readonly [string, string]): OrgContactSegment[];

package/src/lib/hooks/use-org-contact-segments.js

@@ -0,0 +1,55 @@
+/**
+ * @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';
+/**
+ * The org's saved contact segments, for a picker to offer.
+ *
+ * A LOOKUP, not a list. Nothing pages this: it fills the options of one
+ * `Select`, a reader opens it rather than walking it, and the window is
+ * bounded so an org with a thousand segments cannot turn one dropdown into an
+ * unbounded read. That is a different question from the one a paged table
+ * answers, and keeping the read in its own module is what stops the form that
+ * renders the dropdown reading like a list surface that forgot its footer.
+ *
+ * `orderBy('name')` is safe here, which is a claim about the writer rather
+ * than a preference: `handleSaveSegment` in the contacts console is the only
+ * thing that creates a segment and it refuses an empty name. `orderBy` filters
+ * as well as sorts, so a segment written without one would be missing from its
+ * own picker rather than merely out of order.
+ */ import { collection, limit, orderBy, query } from "firebase/firestore";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+/**
+ * The picker's window.
+ *
+ * Bounded rather than paged — see the module note. A rule that names a segment
+ * beyond this window still shows its own reference: the picker adds the stored
+ * id as an option of its own, because a `Select` whose value is absent from
+ * its options renders empty, and saving from that screen would erase the
+ * reference the merchant could not see.
+ */ export const SEGMENT_PICKER_LIMIT = 50;
+export function useOrgContactSegments(scope) {
+    const firestore = useFirestore();
+    const { data } = useFirestoreCollection(()=>query(collection(firestore, scope[0], scope[1], 'contactSegments'), orderBy('name'), limit(SEGMENT_PICKER_LIMIT)), [
+        firestore,
+        scope[0],
+        scope[1]
+    ], {
+        idField: '$id'
+    });
+    return data != null ? data : [];
+}
+
+//# sourceMappingURL=use-org-contact-segments.js.map

package/src/lib/hooks/use-org-contact-segments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/hooks/use-org-contact-segments.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\n/**\n * The org's saved contact segments, for a picker to offer.\n *\n * A LOOKUP, not a list. Nothing pages this: it fills the options of one\n * `Select`, a reader opens it rather than walking it, and the window is\n * bounded so an org with a thousand segments cannot turn one dropdown into an\n * unbounded read. That is a different question from the one a paged table\n * answers, and keeping the read in its own module is what stops the form that\n * renders the dropdown reading like a list surface that forgot its footer.\n *\n * `orderBy('name')` is safe here, which is a claim about the writer rather\n * than a preference: `handleSaveSegment` in the contacts console is the only\n * thing that creates a segment and it refuses an empty name. `orderBy` filters\n * as well as sorts, so a segment written without one would be missing from its\n * own picker rather than merely out of order.\n */\n\nimport { collection, limit, orderBy, query } from 'firebase/firestore'\nimport { useFirestore, useFirestoreCollection } from '@aglyn/tenant-feature-instance'\n\n/** One saved segment, as the picker needs it. */\nexport interface OrgContactSegment {\n  $id: string\n  name?: string\n}\n\n/**\n * The picker's window.\n *\n * Bounded rather than paged — see the module note. A rule that names a segment\n * beyond this window still shows its own reference: the picker adds the stored\n * id as an option of its own, because a `Select` whose value is absent from\n * its options renders empty, and saving from that screen would erase the\n * reference the merchant could not see.\n */\nexport const SEGMENT_PICKER_LIMIT = 50\n\nexport function useOrgContactSegments(\n  scope: readonly [string, string],\n): OrgContactSegment[] {\n  const firestore = useFirestore()\n  const { data } = useFirestoreCollection<OrgContactSegment>(\n    () =>\n      query(\n        collection(firestore, scope[0], scope[1], 'contactSegments'),\n        orderBy('name'),\n        limit(SEGMENT_PICKER_LIMIT),\n      ),\n    [firestore, scope[0], scope[1]],\n    { idField: '$id' },\n  )\n  return data ?? []\n}\n"],"names":["collection","limit","orderBy","query","useFirestore","useFirestoreCollection","SEGMENT_PICKER_LIMIT","useOrgContactSegments","scope","firestore","data","idField"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,QAAQ,qBAAoB;AACtE,SAASC,YAAY,EAAEC,sBAAsB,QAAQ,iCAAgC;AAQrF;;;;;;;;CAQC,GACD,OAAO,MAAMC,uBAAuB,GAAE;AAEtC,OAAO,SAASC,sBACdC,KAAgC;IAEhC,MAAMC,YAAYL;IAClB,MAAM,EAAEM,IAAI,EAAE,GAAGL,uBACf,IACEF,MACEH,WAAWS,WAAWD,KAAK,CAAC,EAAE,EAAEA,KAAK,CAAC,EAAE,EAAE,oBAC1CN,QAAQ,SACRD,MAAMK,wBAEV;QAACG;QAAWD,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;KAAC,EAC/B;QAAEG,SAAS;IAAM;IAEnB,OAAOD,eAAAA,OAAQ,EAAE;AACnB"}

package/src/lib/hooks/use-org-crm-views.d.ts

@@ -0,0 +1,8 @@
+/** One saved view, as the picker needs it. */
+export interface OrgCrmViewOption {
+    $id: string;
+    name: string;
+}
+export declare const CRM_VIEW_PICKER_LIMIT = 50;
+export declare function useOrgCrmViews(scope: readonly [string, string]): OrgCrmViewOption[];
+export default useOrgCrmViews;

package/src/lib/hooks/use-org-crm-views.js

@@ -0,0 +1,74 @@
+/**
+ * @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';
+/**
+ * The org's saved Contacts views that can be an audience, for the rule
+ * editor's picker (AGL-2617).
+ *
+ * A LOOKUP like the segment picker's, and bounded for the same reason. Two
+ * things narrow it past the segments'. It lists only the views this reader
+ * would see on the Contacts list — their own and the shared ones — because
+ * a private view is one person's working arrangement and offering it as a
+ * colleague's audience would put it to a use its owner never saw. And it
+ * lists only views that TRANSLATE WHOLE into the rule language: a view
+ * carrying a name prefix or an `updatedAt` window has no audience meaning,
+ * and the sweep would refuse it by narrowing to nobody — so the picker
+ * does not offer what the sweep cannot honor.
+ *
+ * Scoped like the field picker: the reader's own tokens filter the query
+ * for a scoped member, and an org-wide member reads the section unfiltered
+ * on the `(section, name)` index.
+ */ import { CRM_COLLECTIONS, crmViewIsListed, dynamicListDimensionsForCrmView, normalizeCrmViewFilters } from "@aglyn/aglyn";
+import { collection, limit, orderBy, query, where } from "firebase/firestore";
+import { useMemo } from "react";
+import { useFirestore, useFirestoreCollection, useScopeTokens, useUser } from "@aglyn/tenant-feature-instance";
+export const CRM_VIEW_PICKER_LIMIT = 50;
+export function useOrgCrmViews(scope) {
+    var _ref;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const { tokens, orgWide, loaded } = useScopeTokens(scope[1]);
+    const { data } = useFirestoreCollection(()=>// Not until the viewer's reach is known — see the field picker.
+        loaded ? query(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.views), ...orgWide ? [] : [
+            where('visibleTo', 'array-contains-any', tokens)
+        ], where('section', '==', 'contacts'), orderBy('name'), limit(CRM_VIEW_PICKER_LIMIT)) : null, [
+        firestore,
+        scope[0],
+        scope[1],
+        loaded,
+        orgWide,
+        tokens
+    ], {
+        idField: '$id'
+    });
+    return useMemo(()=>(data != null ? data : []).filter((row)=>{
+            var _row_ownerUid;
+            return typeof row['name'] === 'string' && row['name'] && crmViewIsListed({
+                shared: row['shared'] === true,
+                ownerUid: String((_row_ownerUid = row['ownerUid']) != null ? _row_ownerUid : '')
+            }, uid) && dynamicListDimensionsForCrmView(normalizeCrmViewFilters(row['filters'])).unsupported.length === 0;
+        }).map((row)=>({
+                $id: String(row['$id']),
+                name: String(row['name'])
+            })), [
+        data,
+        uid
+    ]);
+}
+export default useOrgCrmViews;
+
+//# sourceMappingURL=use-org-crm-views.js.map

package/src/lib/hooks/use-org-crm-views.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/hooks/use-org-crm-views.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\n/**\n * The org's saved Contacts views that can be an audience, for the rule\n * editor's picker (AGL-2617).\n *\n * A LOOKUP like the segment picker's, and bounded for the same reason. Two\n * things narrow it past the segments'. It lists only the views this reader\n * would see on the Contacts list — their own and the shared ones — because\n * a private view is one person's working arrangement and offering it as a\n * colleague's audience would put it to a use its owner never saw. And it\n * lists only views that TRANSLATE WHOLE into the rule language: a view\n * carrying a name prefix or an `updatedAt` window has no audience meaning,\n * and the sweep would refuse it by narrowing to nobody — so the picker\n * does not offer what the sweep cannot honor.\n *\n * Scoped like the field picker: the reader's own tokens filter the query\n * for a scoped member, and an org-wide member reads the section unfiltered\n * on the `(section, name)` index.\n */\n\nimport {\n  CRM_COLLECTIONS,\n  crmViewIsListed,\n  dynamicListDimensionsForCrmView,\n  normalizeCrmViewFilters,\n} from '@aglyn/aglyn'\nimport { collection, limit, orderBy, query, where } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useScopeTokens,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\n\n/** One saved view, as the picker needs it. */\nexport interface OrgCrmViewOption {\n  $id: string\n  name: string\n}\n\nexport const CRM_VIEW_PICKER_LIMIT = 50\n\nexport function useOrgCrmViews(\n  scope: readonly [string, string],\n): OrgCrmViewOption[] {\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const uid = (user as { uid?: string } | null | undefined)?.uid ?? null\n  const { tokens, orgWide, loaded } = useScopeTokens(scope[1])\n  const { data } = useFirestoreCollection<Record<string, unknown>>(\n    () =>\n      // Not until the viewer's reach is known — see the field picker.\n      loaded\n        ? query(\n            collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.views),\n            ...(orgWide ? [] : [where('visibleTo', 'array-contains-any', tokens)]),\n            where('section', '==', 'contacts'),\n            orderBy('name'),\n            limit(CRM_VIEW_PICKER_LIMIT),\n          )\n        : null,\n    [firestore, scope[0], scope[1], loaded, orgWide, tokens],\n    { idField: '$id' },\n  )\n  return useMemo(\n    () =>\n      (data ?? [])\n        .filter(\n          (row) =>\n            typeof row['name'] === 'string' &&\n            row['name'] &&\n            crmViewIsListed(\n              {\n                shared: row['shared'] === true,\n                ownerUid: String(row['ownerUid'] ?? ''),\n              },\n              uid,\n            ) &&\n            dynamicListDimensionsForCrmView(normalizeCrmViewFilters(row['filters']))\n              .unsupported.length === 0,\n        )\n        .map((row) => ({ $id: String(row['$id']), name: String(row['name']) })),\n    [data, uid],\n  )\n}\n\nexport default useOrgCrmViews\n"],"names":["CRM_COLLECTIONS","crmViewIsListed","dynamicListDimensionsForCrmView","normalizeCrmViewFilters","collection","limit","orderBy","query","where","useMemo","useFirestore","useFirestoreCollection","useScopeTokens","useUser","CRM_VIEW_PICKER_LIMIT","useOrgCrmViews","scope","firestore","data","user","uid","tokens","orgWide","loaded","views","idField","filter","row","shared","ownerUid","String","unsupported","length","map","$id","name"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA;;;;;;;;;;;;;;;;;CAiBC,GAED,SACEA,eAAe,EACfC,eAAe,EACfC,+BAA+B,EAC/BC,uBAAuB,QAClB,eAAc;AACrB,SAASC,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,QAAQ,qBAAoB;AAC7E,SAASC,OAAO,QAAQ,QAAO;AAC/B,SACEC,YAAY,EACZC,sBAAsB,EACtBC,cAAc,EACdC,OAAO,QACF,iCAAgC;AAQvC,OAAO,MAAMC,wBAAwB,GAAE;AAEvC,OAAO,SAASC,eACdC,KAAgC;;IAEhC,MAAMC,YAAYP;IAClB,MAAM,EAAEQ,MAAMC,IAAI,EAAE,GAAGN;IACvB,MAAMO,cAAOD,wBAAD,AAACA,KAA8CC,GAAG,mBAAI;IAClE,MAAM,EAAEC,MAAM,EAAEC,OAAO,EAAEC,MAAM,EAAE,GAAGX,eAAeI,KAAK,CAAC,EAAE;IAC3D,MAAM,EAAEE,IAAI,EAAE,GAAGP,uBACf,IACE,gEAAgE;QAChEY,SACIhB,MACEH,WAAWa,WAAWD,KAAK,CAAC,EAAE,EAAEA,KAAK,CAAC,EAAE,EAAEhB,gBAAgBwB,KAAK,MAC3DF,UAAU,EAAE,GAAG;YAACd,MAAM,aAAa,sBAAsBa;SAAQ,EACrEb,MAAM,WAAW,MAAM,aACvBF,QAAQ,SACRD,MAAMS,0BAER,MACN;QAACG;QAAWD,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;QAAEO;QAAQD;QAASD;KAAO,EACxD;QAAEI,SAAS;IAAM;IAEnB,OAAOhB,QACL,IACE,CAACS,eAAAA,OAAQ,EAAE,EACRQ,MAAM,CACL,CAACC;gBAMsBA;mBALrB,OAAOA,GAAG,CAAC,OAAO,KAAK,YACvBA,GAAG,CAAC,OAAO,IACX1B,gBACE;gBACE2B,QAAQD,GAAG,CAAC,SAAS,KAAK;gBAC1BE,UAAUC,QAAOH,gBAAAA,GAAG,CAAC,WAAW,YAAfA,gBAAmB;YACtC,GACAP,QAEFlB,gCAAgCC,wBAAwBwB,GAAG,CAAC,UAAU,GACnEI,WAAW,CAACC,MAAM,KAAK;WAE7BC,GAAG,CAAC,CAACN,MAAS,CAAA;gBAAEO,KAAKJ,OAAOH,GAAG,CAAC,MAAM;gBAAGQ,MAAML,OAAOH,GAAG,CAAC,OAAO;YAAE,CAAA,IACxE;QAACT;QAAME;KAAI;AAEf;AAEA,eAAeL,eAAc"}

package/src/lib/hooks/use-org-lists.d.ts

@@ -0,0 +1,8 @@
+/** One audience, as the picker needs it. */
+export interface OrgListOption {
+    $id: string;
+    name?: string;
+}
+/** The picker's window. Matches the segment picker beside it. */
+export declare const LIST_PICKER_LIMIT = 50;
+export declare function useOrgLists(scope: readonly [string, string]): OrgListOption[];

package/src/lib/hooks/use-org-lists.js

@@ -0,0 +1,47 @@
+/**
+ * @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';
+/**
+ * The org's audiences, as the options of a picker.
+ *
+ * The sibling of `use-org-contact-segments.ts` and deliberately its twin: a
+ * LOOKUP rather than a list. Nothing pages this — it fills the options of one
+ * `Select` that a reader opens rather than walks, and the window is bounded so
+ * an org with a thousand audiences cannot turn a dropdown into an unbounded
+ * read. The paged surface that answers the other question already exists in
+ * `lists-card.tsx`.
+ *
+ * `orderBy('name')` is safe here, and that is a claim about the writer rather
+ * than a preference: the create drawer in `lists-card.tsx` is the only thing
+ * that creates a list and it refuses an empty name. `orderBy` filters as well
+ * as sorts, so a list written without one would be missing from its own picker
+ * rather than merely out of order.
+ */ import { collection, limit, orderBy, query } from "firebase/firestore";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+/** The picker's window. Matches the segment picker beside it. */ export const LIST_PICKER_LIMIT = 50;
+export function useOrgLists(scope) {
+    const firestore = useFirestore();
+    const { data } = useFirestoreCollection(()=>query(collection(firestore, scope[0], scope[1], 'lists'), orderBy('name'), limit(LIST_PICKER_LIMIT)), [
+        firestore,
+        scope[0],
+        scope[1]
+    ], {
+        idField: '$id'
+    });
+    return data != null ? data : [];
+}
+
+//# sourceMappingURL=use-org-lists.js.map

package/src/lib/hooks/use-org-lists.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/hooks/use-org-lists.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\n/**\n * The org's audiences, as the options of a picker.\n *\n * The sibling of `use-org-contact-segments.ts` and deliberately its twin: a\n * LOOKUP rather than a list. Nothing pages this — it fills the options of one\n * `Select` that a reader opens rather than walks, and the window is bounded so\n * an org with a thousand audiences cannot turn a dropdown into an unbounded\n * read. The paged surface that answers the other question already exists in\n * `lists-card.tsx`.\n *\n * `orderBy('name')` is safe here, and that is a claim about the writer rather\n * than a preference: the create drawer in `lists-card.tsx` is the only thing\n * that creates a list and it refuses an empty name. `orderBy` filters as well\n * as sorts, so a list written without one would be missing from its own picker\n * rather than merely out of order.\n */\n\nimport { collection, limit, orderBy, query } from 'firebase/firestore'\nimport { useFirestore, useFirestoreCollection } from '@aglyn/tenant-feature-instance'\n\n/** One audience, as the picker needs it. */\nexport interface OrgListOption {\n  $id: string\n  name?: string\n}\n\n/** The picker's window. Matches the segment picker beside it. */\nexport const LIST_PICKER_LIMIT = 50\n\nexport function useOrgLists(\n  scope: readonly [string, string],\n): OrgListOption[] {\n  const firestore = useFirestore()\n  const { data } = useFirestoreCollection<OrgListOption>(\n    () =>\n      query(\n        collection(firestore, scope[0], scope[1], 'lists'),\n        orderBy('name'),\n        limit(LIST_PICKER_LIMIT),\n      ),\n    [firestore, scope[0], scope[1]],\n    { idField: '$id' },\n  )\n  return data ?? []\n}\n"],"names":["collection","limit","orderBy","query","useFirestore","useFirestoreCollection","LIST_PICKER_LIMIT","useOrgLists","scope","firestore","data","idField"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,QAAQ,qBAAoB;AACtE,SAASC,YAAY,EAAEC,sBAAsB,QAAQ,iCAAgC;AAQrF,+DAA+D,GAC/D,OAAO,MAAMC,oBAAoB,GAAE;AAEnC,OAAO,SAASC,YACdC,KAAgC;IAEhC,MAAMC,YAAYL;IAClB,MAAM,EAAEM,IAAI,EAAE,GAAGL,uBACf,IACEF,MACEH,WAAWS,WAAWD,KAAK,CAAC,EAAE,EAAEA,KAAK,CAAC,EAAE,EAAE,UAC1CN,QAAQ,SACRD,MAAMK,qBAEV;QAACG;QAAWD,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;KAAC,EAC/B;QAAEG,SAAS;IAAM;IAEnB,OAAOD,eAAAA,OAAQ,EAAE;AACnB"}

package/src/lib/model/email-design-document.d.ts

@@ -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 { SCREEN_KIND_EMAIL } from '@aglyn/aglyn/app-utils/screen-route';
+/**
+ * THE TWO DOCUMENTS AN EMAIL DESIGN IS: a screen with `kind: 'email'`, and its
+ * first version holding the node map.
+ *
+ * Leaf modules only, so the console's create (a client component) and the
+ * server's draft writer build the same pair from one function: a design made
+ * on either side opens in the same besigner, lists on the same Templates tab,
+ * and is picked up by the same campaign composer.
+ */
+/** The screen document of a new email design. */
+export interface EmailDesignScreenDocument {
+    displayName: string;
+    kind: typeof SCREEN_KIND_EMAIL;
+    versionId: string;
+}
+/** The first version of a new email design. */
+export interface EmailDesignVersionDocument {
+    screenId: string;
+    nodes: Record<string, unknown>;
+}
+/** A new design's first canvas: one email section holding a greeting. */
+export declare function emailDesignStarterNodes(ids: {
+    sectionId: string;
+    textId: string;
+}): Record<string, unknown>;
+/** The screen and first version a design with these ids and this canvas is stored as. */
+export declare function emailDesignDocuments(input: {
+    screenId: string;
+    versionId: string;
+    displayName: string;
+    nodes: Record<string, unknown>;
+}): {
+    screen: EmailDesignScreenDocument;
+    version: EmailDesignVersionDocument;
+};

package/src/lib/model/email-design-document.js

@@ -0,0 +1,62 @@
+/**
+ * @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 { SCREEN_KIND_EMAIL } from "@aglyn/aglyn/app-utils/screen-route";
+import { CANVAS_ROOT_ELEMENT_ID } from "@aglyn/aglyn/foundation/constants/canvas";
+/** A new design's first canvas: one email section holding a greeting. */ export function emailDesignStarterNodes(ids) {
+    return {
+        [CANVAS_ROOT_ELEMENT_ID]: {
+            $id: CANVAS_ROOT_ELEMENT_ID,
+            componentId: 'div',
+            nodes: [
+                ids.sectionId
+            ]
+        },
+        [ids.sectionId]: {
+            $id: ids.sectionId,
+            componentId: 'emailSection',
+            pluginId: 'email',
+            parentId: CANVAS_ROOT_ELEMENT_ID,
+            nodes: [
+                ids.textId
+            ]
+        },
+        [ids.textId]: {
+            $id: ids.textId,
+            componentId: 'emailText',
+            pluginId: 'email',
+            parentId: ids.sectionId,
+            props: {
+                children: 'Hello {{contact.firstName}},',
+                variant: 'body'
+            }
+        }
+    };
+}
+/** The screen and first version a design with these ids and this canvas is stored as. */ export function emailDesignDocuments(input) {
+    return {
+        screen: {
+            displayName: input.displayName,
+            kind: SCREEN_KIND_EMAIL,
+            versionId: input.versionId
+        },
+        version: {
+            screenId: input.screenId,
+            nodes: input.nodes
+        }
+    };
+}
+
+//# sourceMappingURL=email-design-document.js.map

package/src/lib/model/email-design-document.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/model/email-design-document.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 { SCREEN_KIND_EMAIL } from '@aglyn/aglyn/app-utils/screen-route'\nimport { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\n\n/**\n * THE TWO DOCUMENTS AN EMAIL DESIGN IS: a screen with `kind: 'email'`, and its\n * first version holding the node map.\n *\n * Leaf modules only, so the console's create (a client component) and the\n * server's draft writer build the same pair from one function: a design made\n * on either side opens in the same besigner, lists on the same Templates tab,\n * and is picked up by the same campaign composer.\n */\n\n/** The screen document of a new email design. */\nexport interface EmailDesignScreenDocument {\n  displayName: string\n  kind: typeof SCREEN_KIND_EMAIL\n  versionId: string\n}\n\n/** The first version of a new email design. */\nexport interface EmailDesignVersionDocument {\n  screenId: string\n  nodes: Record<string, unknown>\n}\n\n/** A new design's first canvas: one email section holding a greeting. */\nexport function emailDesignStarterNodes(ids: {\n  sectionId: string\n  textId: string\n}): Record<string, unknown> {\n  return {\n    [CANVAS_ROOT_ELEMENT_ID]: {\n      $id: CANVAS_ROOT_ELEMENT_ID,\n      componentId: 'div',\n      nodes: [ids.sectionId],\n    },\n    [ids.sectionId]: {\n      $id: ids.sectionId,\n      componentId: 'emailSection',\n      pluginId: 'email',\n      parentId: CANVAS_ROOT_ELEMENT_ID,\n      nodes: [ids.textId],\n    },\n    [ids.textId]: {\n      $id: ids.textId,\n      componentId: 'emailText',\n      pluginId: 'email',\n      parentId: ids.sectionId,\n      props: {\n        children: 'Hello {{contact.firstName}},',\n        variant: 'body',\n      },\n    },\n  }\n}\n\n/** The screen and first version a design with these ids and this canvas is stored as. */\nexport function emailDesignDocuments(input: {\n  screenId: string\n  versionId: string\n  displayName: string\n  nodes: Record<string, unknown>\n}): { screen: EmailDesignScreenDocument; version: EmailDesignVersionDocument } {\n  return {\n    screen: {\n      displayName: input.displayName,\n      kind: SCREEN_KIND_EMAIL,\n      versionId: input.versionId,\n    },\n    version: { screenId: input.screenId, nodes: input.nodes },\n  }\n}\n"],"names":["SCREEN_KIND_EMAIL","CANVAS_ROOT_ELEMENT_ID","emailDesignStarterNodes","ids","$id","componentId","nodes","sectionId","pluginId","parentId","textId","props","children","variant","emailDesignDocuments","input","screen","displayName","kind","versionId","version","screenId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,iBAAiB,QAAQ,sCAAqC;AACvE,SAASC,sBAAsB,QAAQ,2CAA0C;AAyBjF,uEAAuE,GACvE,OAAO,SAASC,wBAAwBC,GAGvC;IACC,OAAO;QACL,CAACF,uBAAuB,EAAE;YACxBG,KAAKH;YACLI,aAAa;YACbC,OAAO;gBAACH,IAAII,SAAS;aAAC;QACxB;QACA,CAACJ,IAAII,SAAS,CAAC,EAAE;YACfH,KAAKD,IAAII,SAAS;YAClBF,aAAa;YACbG,UAAU;YACVC,UAAUR;YACVK,OAAO;gBAACH,IAAIO,MAAM;aAAC;QACrB;QACA,CAACP,IAAIO,MAAM,CAAC,EAAE;YACZN,KAAKD,IAAIO,MAAM;YACfL,aAAa;YACbG,UAAU;YACVC,UAAUN,IAAII,SAAS;YACvBI,OAAO;gBACLC,UAAU;gBACVC,SAAS;YACX;QACF;IACF;AACF;AAEA,uFAAuF,GACvF,OAAO,SAASC,qBAAqBC,KAKpC;IACC,OAAO;QACLC,QAAQ;YACNC,aAAaF,MAAME,WAAW;YAC9BC,MAAMlB;YACNmB,WAAWJ,MAAMI,SAAS;QAC5B;QACAC,SAAS;YAAEC,UAAUN,MAAMM,QAAQ;YAAEf,OAAOS,MAAMT,KAAK;QAAC;IAC1D;AACF"}

package/src/lib/model/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @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.
+ */
+/**
+ * Email rendering model (AGL-412): besigner-built email HTML rendering + merge tags, relocated from core app-utils.
+ * Context-free — importable by client components, /server handlers, and
+ * other plugins/apps via `@aglyn/plugins-email/model`.
+ */
+export { renderEmailHtml, substituteMergeTokens, resolveMergeTags, type EmailRenderOptions, type EmailRenderProduct, type RenderedEmail, } from '@aglyn/shared-util-email';
+/**
+ * Campaign reporting: the rate math, the populations the send recorded, and
+ * the link rollup — pure, so every denominator is named once and provable
+ * rather than chosen in JSX.
+ */
+export * from '@aglyn/shared-ui-email-campaigns/model/campaign-report';
+/**
+ * What a campaign EARNED: the last-click window, the gross/refunded pair and
+ * the per-currency buckets that are never added together. Separate from the
+ * rate math because it reads a different document and answers the merchant's
+ * second question rather than their first.
+ */
+export * from '@aglyn/shared-ui-email-campaigns/model/campaign-revenue';
+/**
+ * The same math taken across every message sent from one TEMPLATE. Separate
+ * from `campaign-report` because a sum has a membership: which messages went
+ * into it, and therefore which population the rate describes.
+ */
+export * from './template-report';
+/** Reading one message record — its state, and when it went out. */
+export * from '@aglyn/shared-ui-email-campaigns/model/email-record';
+/**
+ * Whose template this is: authored here, or installed from a marketplace
+ * listing and versioned by somebody else.
+ */
+export * from './template-provenance';
+/**
+ * One campaign message, rendered. Shared by the send loop, the composer's
+ * pre-send preview and any other surface that has to show what will be
+ * mailed — a preview that renders the message a second way previews
+ * something else.
+ */
+/**
+ * The campaign CONTAINER — its window, its lists, and the arithmetic that
+ * rolls its sends into one set of figures.
+ */
+export * from '@aglyn/shared-ui-email-campaigns/model/campaign-container';
+/**
+ * How each sending-domain state reads, said once for the list and the
+ * domain's own page — including why `inconclusive` is neither of them.
+ */
+export * from './sending-domain-status';

package/src/lib/model/index.js

@@ -0,0 +1,71 @@
+/**
+ * @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.
+ */ /**
+ * Email rendering model (AGL-412): besigner-built email HTML rendering + merge tags, relocated from core app-utils.
+ * Context-free — importable by client components, /server handlers, and
+ * other plugins/apps via `@aglyn/plugins-email/model`.
+ */ // The renderer and merge-tag helpers moved to `@aglyn/shared-util-email`
+// (AGL-750): they are pure functions over a node map with no imports at all,
+// and the console's own API routes need them to render system email
+// templates. Apps are forbidden to import feature plugins (the `scope:app`
+// → `aglyn:addons` boundary), so leaving them here made them unreachable
+// from exactly the code that has to send the mail.
+//
+// Re-exported so `@aglyn/plugins-email/model` keeps working unchanged.
+export { renderEmailHtml, substituteMergeTokens, resolveMergeTags } from "@aglyn/shared-util-email";
+// The campaign document model and its arithmetic live in
+// `@aglyn/shared-ui-email-campaigns`. Marketing owns the campaign console
+// section and Email owns the message surfaces; both are independently
+// toggleable plugins, so a shape either one reads has to sit in a lib they
+// depend on as peers rather than inside one of them. Re-exported here so
+// `@aglyn/plugins-email/model` remains one barrel for this plugin's own
+// callers.
+/**
+ * Campaign reporting: the rate math, the populations the send recorded, and
+ * the link rollup — pure, so every denominator is named once and provable
+ * rather than chosen in JSX.
+ */ export * from "@aglyn/shared-ui-email-campaigns/model/campaign-report";
+/**
+ * What a campaign EARNED: the last-click window, the gross/refunded pair and
+ * the per-currency buckets that are never added together. Separate from the
+ * rate math because it reads a different document and answers the merchant's
+ * second question rather than their first.
+ */ export * from "@aglyn/shared-ui-email-campaigns/model/campaign-revenue";
+/**
+ * The same math taken across every message sent from one TEMPLATE. Separate
+ * from `campaign-report` because a sum has a membership: which messages went
+ * into it, and therefore which population the rate describes.
+ */ export * from "./template-report.js";
+/** Reading one message record — its state, and when it went out. */ export * from "@aglyn/shared-ui-email-campaigns/model/email-record";
+/**
+ * Whose template this is: authored here, or installed from a marketplace
+ * listing and versioned by somebody else.
+ */ export * from "./template-provenance.js";
+/**
+ * One campaign message, rendered. Shared by the send loop, the composer's
+ * pre-send preview and any other surface that has to show what will be
+ * mailed — a preview that renders the message a second way previews
+ * something else.
+ */ /**
+ * The campaign CONTAINER — its window, its lists, and the arithmetic that
+ * rolls its sends into one set of figures.
+ */ export * from "@aglyn/shared-ui-email-campaigns/model/campaign-container";
+/**
+ * How each sending-domain state reads, said once for the list and the
+ * domain's own page — including why `inconclusive` is neither of them.
+ */ export * from "./sending-domain-status.js";
+
+//# sourceMappingURL=index.js.map

package/src/lib/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/model/index.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\n/**\n * Email rendering model (AGL-412): besigner-built email HTML rendering + merge tags, relocated from core app-utils.\n * Context-free — importable by client components, /server handlers, and\n * other plugins/apps via `@aglyn/plugins-email/model`.\n */\n// The renderer and merge-tag helpers moved to `@aglyn/shared-util-email`\n// (AGL-750): they are pure functions over a node map with no imports at all,\n// and the console's own API routes need them to render system email\n// templates. Apps are forbidden to import feature plugins (the `scope:app`\n// → `aglyn:addons` boundary), so leaving them here made them unreachable\n// from exactly the code that has to send the mail.\n//\n// Re-exported so `@aglyn/plugins-email/model` keeps working unchanged.\nexport {\n  renderEmailHtml,\n  substituteMergeTokens,\n  resolveMergeTags,\n  type EmailRenderOptions,\n  type EmailRenderProduct,\n  type RenderedEmail,\n} from '@aglyn/shared-util-email'\n\n// The campaign document model and its arithmetic live in\n// `@aglyn/shared-ui-email-campaigns`. Marketing owns the campaign console\n// section and Email owns the message surfaces; both are independently\n// toggleable plugins, so a shape either one reads has to sit in a lib they\n// depend on as peers rather than inside one of them. Re-exported here so\n// `@aglyn/plugins-email/model` remains one barrel for this plugin's own\n// callers.\n\n/**\n * Campaign reporting: the rate math, the populations the send recorded, and\n * the link rollup — pure, so every denominator is named once and provable\n * rather than chosen in JSX.\n */\nexport * from '@aglyn/shared-ui-email-campaigns/model/campaign-report'\n\n/**\n * What a campaign EARNED: the last-click window, the gross/refunded pair and\n * the per-currency buckets that are never added together. Separate from the\n * rate math because it reads a different document and answers the merchant's\n * second question rather than their first.\n */\nexport * from '@aglyn/shared-ui-email-campaigns/model/campaign-revenue'\n\n/**\n * The same math taken across every message sent from one TEMPLATE. Separate\n * from `campaign-report` because a sum has a membership: which messages went\n * into it, and therefore which population the rate describes.\n */\nexport * from './template-report'\n\n/** Reading one message record — its state, and when it went out. */\nexport * from '@aglyn/shared-ui-email-campaigns/model/email-record'\n\n/**\n * Whose template this is: authored here, or installed from a marketplace\n * listing and versioned by somebody else.\n */\nexport * from './template-provenance'\n\n/**\n * One campaign message, rendered. Shared by the send loop, the composer's\n * pre-send preview and any other surface that has to show what will be\n * mailed — a preview that renders the message a second way previews\n * something else.\n */\n\n/**\n * The campaign CONTAINER — its window, its lists, and the arithmetic that\n * rolls its sends into one set of figures.\n */\nexport * from '@aglyn/shared-ui-email-campaigns/model/campaign-container'\n\n/**\n * How each sending-domain state reads, said once for the list and the\n * domain's own page — including why `inconclusive` is neither of them.\n */\nexport * from './sending-domain-status'\n"],"names":["renderEmailHtml","substituteMergeTokens","resolveMergeTags"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GACD,yEAAyE;AACzE,6EAA6E;AAC7E,oEAAoE;AACpE,2EAA2E;AAC3E,yEAAyE;AACzE,mDAAmD;AACnD,EAAE;AACF,uEAAuE;AACvE,SACEA,eAAe,EACfC,qBAAqB,EACrBC,gBAAgB,QAIX,2BAA0B;AAEjC,yDAAyD;AACzD,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,yEAAyE;AACzE,wEAAwE;AACxE,WAAW;AAEX;;;;CAIC,GACD,cAAc,yDAAwD;AAEtE;;;;;CAKC,GACD,cAAc,0DAAyD;AAEvE;;;;CAIC,GACD,cAAc,uBAAmB;AAEjC,kEAAkE,GAClE,cAAc,sDAAqD;AAEnE;;;CAGC,GACD,cAAc,2BAAuB;AAErC;;;;;CAKC,GAED;;;CAGC,GACD,cAAc,4DAA2D;AAEzE;;;CAGC,GACD,cAAc,6BAAyB"}