@aglyn/plugins-email 1.0.0-beta.196 → 1.0.0-beta.197

package/src/lib/components/consent-group-editing.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @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 ConsentGroupDeclarationEntry } from './consent-groups-api';
+/** A declared group the org honors today, with its id. */
+export interface ListedConsentGroup {
+    id: string;
+    name: string;
+    /** Sorted, as `readConsentGroups` returns them. */
+    hostIds: string[];
+}
+/**
+ * The org's usable groups, sorted by name.
+ *
+ * Only what `readConsentGroups` honors: a stored entry it drops pools nobody
+ * today, so it is not offered for editing, and the route removes it with the
+ * next change (the review lists it). Sorted because a map's key order is not
+ * something two readers agree on, and a table that reshuffled between loads
+ * would read as a change.
+ */
+export declare function listConsentGroups(org: Record<string, unknown> | null | undefined): ListedConsentGroup[];
+/**
+ * How many stored entries nothing honors — no name, too few or too many
+ * sites, or a site another group also claims.
+ */
+export declare function unusableConsentGroupCount(org: Record<string, unknown> | null | undefined): number;
+/**
+ * The raw declaration a change is made against — what the route compares
+ * with what it holds, so a change somebody else made in the meantime is
+ * refused instead of silently overwritten.
+ */
+export declare function expectedConsentGroups(org: Record<string, unknown> | null | undefined): Record<string, unknown> | null;
+/**
+ * The sentence a group's signup forms show, for a group that may not exist
+ * yet. The same function the forms call, so what the editor promises is
+ * character for character what a visitor reads.
+ */
+export declare function draftDisclosure(name: string, hostIds: readonly string[], groupId?: string): string | null;
+/** What the dialog is editing. */
+export interface ConsentGroupDraft {
+    mode: 'create' | 'edit' | 'dissolve';
+    /** The group being edited or dissolved; `null` for a new one. */
+    groupId: string | null;
+    name: string;
+    hostIds: readonly string[];
+}
+/** Another group that gives up sites to the one being edited. */
+export interface ConsentGroupDraftDonor {
+    groupId: string;
+    name: string;
+    /** Its sites that move into the edited group. */
+    losing: string[];
+    /** Its sites that stay. */
+    remaining: string[];
+    /** One site stays, and a group of one is no group: it dissolves. */
+    dissolves: boolean;
+    /** Every site moves: it is merged into the edited group. */
+    absorbed: boolean;
+}
+/** A draft, read as the change it makes. */
+export interface ConsentGroupDraftChange {
+    kind: 'create' | 'edit' | 'dissolve';
+    groupId: string | null;
+    /** The name after the change, or the dissolved group's name. */
+    name: string;
+    previousName: string | null;
+    /** The group's sites after the change; empty for a dissolve. */
+    hostIds: string[];
+    previousHostIds: string[];
+    renamed: boolean;
+    /** Sites joining the group that were on their own before. */
+    added: string[];
+    /** Sites joining the group from another group. */
+    movedIn: Array<{
+        hostId: string;
+        fromGroupId: string;
+        fromName: string;
+    }>;
+    /** Sites leaving the group to send on their own; all of them on a dissolve. */
+    removed: string[];
+    /** The group's sites the draft no longer selects. */
+    unselected: string[];
+    donors: ConsentGroupDraftDonor[];
+    /** An edit left with fewer than two sites, so it dissolves the group. */
+    tooFewSites: boolean;
+    /** Nothing would change. */
+    empty: boolean;
+}
+/** Reads a draft against the groups the org holds now. */
+export declare function describeConsentGroupDraft(current: readonly ListedConsentGroup[], draft: ConsentGroupDraft): ConsentGroupDraftChange;
+/**
+ * The org's complete next declaration, and where the edited group sits in it.
+ *
+ * Every other group is carried over as it stands, less any site the edited
+ * group takes from it — and a group left with fewer than two sites is left
+ * out, which is how the route reads "dissolved". The edited group goes last,
+ * so a refusal that names a group by its index names it predictably.
+ */
+export declare function buildConsentGroupDeclaration(current: readonly ListedConsentGroup[], draft: ConsentGroupDraft): {
+    groups: ConsentGroupDeclarationEntry[];
+    editedIndex: number | null;
+};
+/** What the edit step says is wrong, by field. */
+export interface ConsentGroupDraftErrors {
+    name?: string;
+    sites?: string;
+}
+/**
+ * The checks the editor can make without asking, which is deliberately few:
+ * the route validates everything again and its answer is the one that
+ * counts. These exist so the obvious mistakes are said beside the field that
+ * has them, before anybody waits on a preview.
+ */
+export declare function validateConsentGroupDraft(current: readonly ListedConsentGroup[], draft: ConsentGroupDraft): ConsentGroupDraftErrors;

package/src/lib/components/consent-group-editing.js

@@ -0,0 +1,225 @@
+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.
+ */ /**
+ * The consent group editor's arithmetic, kept pure so every rule it applies
+ * can be asserted without rendering a dialog.
+ *
+ * The dialog edits ONE group — a new one, or an existing one renamed, grown,
+ * shrunk or dissolved — but the route takes the org's WHOLE next declaration.
+ * Everything here turns the first into the second, and says in plain terms
+ * what that second one changes, so the review step can be written from it.
+ */ import { consentGroupDisclosure, CONSENT_GROUPS_FIELD, readConsentGroups } from "@aglyn/aglyn/app-utils/consent-groups";
+import { CONSENT_GROUP_MIN_HOSTS, CONSENT_GROUP_NAME_MAX, MAX_CONSENT_GROUP_HOSTS } from "./consent-groups-api.js";
+/**
+ * The org's usable groups, sorted by name.
+ *
+ * Only what `readConsentGroups` honors: a stored entry it drops pools nobody
+ * today, so it is not offered for editing, and the route removes it with the
+ * next change (the review lists it). Sorted because a map's key order is not
+ * something two readers agree on, and a table that reshuffled between loads
+ * would read as a change.
+ */ export function listConsentGroups(org) {
+    return Object.entries(readConsentGroups(org)).map(([id, group])=>({
+            id,
+            name: group.name,
+            hostIds: [
+                ...group.hostIds
+            ]
+        })).sort((a, b)=>a.name.localeCompare(b.name, 'en', {
+            sensitivity: 'base'
+        }) || a.id.localeCompare(b.id));
+}
+/**
+ * How many stored entries nothing honors — no name, too few or too many
+ * sites, or a site another group also claims.
+ */ export function unusableConsentGroupCount(org) {
+    const raw = (org != null ? org : {})[CONSENT_GROUPS_FIELD];
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return 0;
+    const usable = readConsentGroups(org);
+    return Object.keys(raw).filter((id)=>!(id in usable)).length;
+}
+/**
+ * The raw declaration a change is made against — what the route compares
+ * with what it holds, so a change somebody else made in the meantime is
+ * refused instead of silently overwritten.
+ */ export function expectedConsentGroups(org) {
+    const raw = (org != null ? org : {})[CONSENT_GROUPS_FIELD];
+    return raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : null;
+}
+/**
+ * The sentence a group's signup forms show, for a group that may not exist
+ * yet. The same function the forms call, so what the editor promises is
+ * character for character what a visitor reads.
+ */ export function draftDisclosure(name, hostIds, groupId = 'draft') {
+    const trimmed = name.trim();
+    if (!trimmed || hostIds.length < CONSENT_GROUP_MIN_HOSTS) return null;
+    return consentGroupDisclosure({
+        hostId: hostIds[0],
+        groupId,
+        name: trimmed,
+        hostIds: [
+            ...hostIds
+        ],
+        declared: true,
+        awaitsConfirmation: false
+    });
+}
+const sortedUnique = (ids)=>[
+        ...new Set(ids.filter(Boolean))
+    ].sort();
+/** Reads a draft against the groups the org holds now. */ export function describeConsentGroupDraft(current, draft) {
+    var _current_find, _ref;
+    const original = draft.groupId != null ? (_current_find = current.find((group)=>group.id === draft.groupId)) != null ? _current_find : null : null;
+    const previousHostIds = original ? [
+        ...original.hostIds
+    ] : [];
+    const selected = sortedUnique(draft.hostIds);
+    const unselected = previousHostIds.filter((id)=>!selected.includes(id));
+    const tooFewSites = draft.mode === 'edit' && selected.length < CONSENT_GROUP_MIN_HOSTS;
+    const dissolving = draft.mode === 'dissolve' || tooFewSites;
+    if (dissolving) {
+        var _ref1, _ref2;
+        return {
+            kind: 'dissolve',
+            groupId: draft.groupId,
+            name: (_ref1 = original == null ? void 0 : original.name) != null ? _ref1 : draft.name.trim(),
+            previousName: (_ref2 = original == null ? void 0 : original.name) != null ? _ref2 : null,
+            hostIds: [],
+            previousHostIds,
+            renamed: false,
+            added: [],
+            movedIn: [],
+            removed: previousHostIds,
+            unselected: draft.mode === 'dissolve' ? previousHostIds : unselected,
+            donors: [],
+            tooFewSites,
+            empty: !original
+        };
+    }
+    const name = draft.name.trim();
+    const chosen = new Set(selected);
+    const before = new Set(previousHostIds);
+    const donors = [];
+    const movedIn = [];
+    for (const group of current){
+        if (group.id === draft.groupId) continue;
+        const losing = group.hostIds.filter((hostId)=>chosen.has(hostId));
+        if (!losing.length) continue;
+        const remaining = group.hostIds.filter((hostId)=>!chosen.has(hostId));
+        donors.push({
+            groupId: group.id,
+            name: group.name,
+            losing,
+            remaining,
+            dissolves: remaining.length > 0 && remaining.length < CONSENT_GROUP_MIN_HOSTS,
+            absorbed: remaining.length === 0
+        });
+        for (const hostId of losing){
+            movedIn.push({
+                hostId,
+                fromGroupId: group.id,
+                fromName: group.name
+            });
+        }
+    }
+    const moving = new Set(movedIn.map((move)=>move.hostId));
+    const added = selected.filter((id)=>!before.has(id) && !moving.has(id));
+    const removed = unselected;
+    const renamed = original != null && name !== original.name;
+    return {
+        kind: original ? 'edit' : 'create',
+        groupId: draft.groupId,
+        name,
+        previousName: (_ref = original == null ? void 0 : original.name) != null ? _ref : null,
+        hostIds: selected,
+        previousHostIds,
+        renamed,
+        added,
+        movedIn,
+        removed,
+        unselected,
+        donors,
+        tooFewSites: false,
+        empty: original != null && !renamed && !added.length && !movedIn.length && !removed.length
+    };
+}
+/**
+ * The org's complete next declaration, and where the edited group sits in it.
+ *
+ * Every other group is carried over as it stands, less any site the edited
+ * group takes from it — and a group left with fewer than two sites is left
+ * out, which is how the route reads "dissolved". The edited group goes last,
+ * so a refusal that names a group by its index names it predictably.
+ */ export function buildConsentGroupDeclaration(current, draft) {
+    const change = describeConsentGroupDraft(current, draft);
+    const taken = new Set(change.kind === 'dissolve' ? [] : change.hostIds);
+    const groups = [];
+    for (const group of current){
+        if (group.id === draft.groupId) continue;
+        const hostIds = group.hostIds.filter((hostId)=>!taken.has(hostId));
+        if (hostIds.length < CONSENT_GROUP_MIN_HOSTS) continue;
+        groups.push({
+            id: group.id,
+            name: group.name,
+            hostIds
+        });
+    }
+    if (change.kind === 'dissolve') return {
+        groups,
+        editedIndex: null
+    };
+    groups.push(_extends({}, draft.groupId != null ? {
+        id: draft.groupId
+    } : {}, {
+        name: change.name,
+        hostIds: change.hostIds
+    }));
+    return {
+        groups,
+        editedIndex: groups.length - 1
+    };
+}
+/**
+ * The checks the editor can make without asking, which is deliberately few:
+ * the route validates everything again and its answer is the one that
+ * counts. These exist so the obvious mistakes are said beside the field that
+ * has them, before anybody waits on a preview.
+ */ export function validateConsentGroupDraft(current, draft) {
+    const change = describeConsentGroupDraft(current, draft);
+    if (change.kind === 'dissolve') return {};
+    const errors = {};
+    if (!change.name) {
+        errors.name = 'Give the group a name. Signup forms show it.';
+    } else if (change.name.length > CONSENT_GROUP_NAME_MAX) {
+        errors.name = `Keep the name to ${CONSENT_GROUP_NAME_MAX} characters or fewer.`;
+    } else {
+        const lower = change.name.toLocaleLowerCase();
+        const { groups } = buildConsentGroupDeclaration(current, draft);
+        const clash = groups.some((group)=>group.id !== draft.groupId && group.id != null && group.name.toLocaleLowerCase() === lower);
+        if (clash) errors.name = 'Another consent group already has this name.';
+    }
+    if (change.hostIds.length < CONSENT_GROUP_MIN_HOSTS) {
+        errors.sites = 'Choose at least two sites.';
+    } else if (change.hostIds.length > MAX_CONSENT_GROUP_HOSTS) {
+        errors.sites = `A consent group can include at most ${MAX_CONSENT_GROUP_HOSTS} sites.`;
+    } else if (change.kind === 'edit' && !change.previousHostIds.some((hostId)=>change.hostIds.includes(hostId))) {
+        errors.sites = 'Keep at least one of this group’s sites, or create a new group for these sites instead.';
+    }
+    return errors;
+}
+
+//# sourceMappingURL=consent-group-editing.js.map

package/src/lib/components/consent-group-editing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/consent-group-editing.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 * The consent group editor's arithmetic, kept pure so every rule it applies\n * can be asserted without rendering a dialog.\n *\n * The dialog edits ONE group — a new one, or an existing one renamed, grown,\n * shrunk or dissolved — but the route takes the org's WHOLE next declaration.\n * Everything here turns the first into the second, and says in plain terms\n * what that second one changes, so the review step can be written from it.\n */\n\nimport {\n  consentGroupDisclosure,\n  CONSENT_GROUPS_FIELD,\n  readConsentGroups,\n} from '@aglyn/aglyn/app-utils/consent-groups'\nimport {\n  CONSENT_GROUP_MIN_HOSTS,\n  CONSENT_GROUP_NAME_MAX,\n  MAX_CONSENT_GROUP_HOSTS,\n  type ConsentGroupDeclarationEntry,\n} from './consent-groups-api'\n\n/** A declared group the org honors today, with its id. */\nexport interface ListedConsentGroup {\n  id: string\n  name: string\n  /** Sorted, as `readConsentGroups` returns them. */\n  hostIds: string[]\n}\n\n/**\n * The org's usable groups, sorted by name.\n *\n * Only what `readConsentGroups` honors: a stored entry it drops pools nobody\n * today, so it is not offered for editing, and the route removes it with the\n * next change (the review lists it). Sorted because a map's key order is not\n * something two readers agree on, and a table that reshuffled between loads\n * would read as a change.\n */\nexport function listConsentGroups(\n  org: Record<string, unknown> | null | undefined,\n): ListedConsentGroup[] {\n  return Object.entries(readConsentGroups(org))\n    .map(([id, group]) => ({ id, name: group.name, hostIds: [...group.hostIds] }))\n    .sort(\n      (a, b) =>\n        a.name.localeCompare(b.name, 'en', { sensitivity: 'base' }) ||\n        a.id.localeCompare(b.id),\n    )\n}\n\n/**\n * How many stored entries nothing honors — no name, too few or too many\n * sites, or a site another group also claims.\n */\nexport function unusableConsentGroupCount(\n  org: Record<string, unknown> | null | undefined,\n): number {\n  const raw = (org ?? {})[CONSENT_GROUPS_FIELD]\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return 0\n  const usable = readConsentGroups(org)\n  return Object.keys(raw as Record<string, unknown>).filter(\n    (id) => !(id in usable),\n  ).length\n}\n\n/**\n * The raw declaration a change is made against — what the route compares\n * with what it holds, so a change somebody else made in the meantime is\n * refused instead of silently overwritten.\n */\nexport function expectedConsentGroups(\n  org: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null {\n  const raw = (org ?? {})[CONSENT_GROUPS_FIELD]\n  return raw && typeof raw === 'object' && !Array.isArray(raw)\n    ? (raw as Record<string, unknown>)\n    : null\n}\n\n/**\n * The sentence a group's signup forms show, for a group that may not exist\n * yet. The same function the forms call, so what the editor promises is\n * character for character what a visitor reads.\n */\nexport function draftDisclosure(\n  name: string,\n  hostIds: readonly string[],\n  groupId = 'draft',\n): string | null {\n  const trimmed = name.trim()\n  if (!trimmed || hostIds.length < CONSENT_GROUP_MIN_HOSTS) return null\n  return consentGroupDisclosure({\n    hostId: hostIds[0],\n    groupId,\n    name: trimmed,\n    hostIds: [...hostIds],\n    declared: true,\n    awaitsConfirmation: false,\n  })\n}\n\n/** What the dialog is editing. */\nexport interface ConsentGroupDraft {\n  mode: 'create' | 'edit' | 'dissolve'\n  /** The group being edited or dissolved; `null` for a new one. */\n  groupId: string | null\n  name: string\n  hostIds: readonly string[]\n}\n\n/** Another group that gives up sites to the one being edited. */\nexport interface ConsentGroupDraftDonor {\n  groupId: string\n  name: string\n  /** Its sites that move into the edited group. */\n  losing: string[]\n  /** Its sites that stay. */\n  remaining: string[]\n  /** One site stays, and a group of one is no group: it dissolves. */\n  dissolves: boolean\n  /** Every site moves: it is merged into the edited group. */\n  absorbed: boolean\n}\n\n/** A draft, read as the change it makes. */\nexport interface ConsentGroupDraftChange {\n  kind: 'create' | 'edit' | 'dissolve'\n  groupId: string | null\n  /** The name after the change, or the dissolved group's name. */\n  name: string\n  previousName: string | null\n  /** The group's sites after the change; empty for a dissolve. */\n  hostIds: string[]\n  previousHostIds: string[]\n  renamed: boolean\n  /** Sites joining the group that were on their own before. */\n  added: string[]\n  /** Sites joining the group from another group. */\n  movedIn: Array<{ hostId: string; fromGroupId: string; fromName: string }>\n  /** Sites leaving the group to send on their own; all of them on a dissolve. */\n  removed: string[]\n  /** The group's sites the draft no longer selects. */\n  unselected: string[]\n  donors: ConsentGroupDraftDonor[]\n  /** An edit left with fewer than two sites, so it dissolves the group. */\n  tooFewSites: boolean\n  /** Nothing would change. */\n  empty: boolean\n}\n\nconst sortedUnique = (ids: readonly string[]) =>\n  [...new Set(ids.filter(Boolean))].sort()\n\n/** Reads a draft against the groups the org holds now. */\nexport function describeConsentGroupDraft(\n  current: readonly ListedConsentGroup[],\n  draft: ConsentGroupDraft,\n): ConsentGroupDraftChange {\n  const original =\n    draft.groupId != null\n      ? (current.find((group) => group.id === draft.groupId) ?? null)\n      : null\n  const previousHostIds = original ? [...original.hostIds] : []\n  const selected = sortedUnique(draft.hostIds)\n  const unselected = previousHostIds.filter((id) => !selected.includes(id))\n  const tooFewSites =\n    draft.mode === 'edit' && selected.length < CONSENT_GROUP_MIN_HOSTS\n  const dissolving = draft.mode === 'dissolve' || tooFewSites\n\n  if (dissolving) {\n    return {\n      kind: 'dissolve',\n      groupId: draft.groupId,\n      name: original?.name ?? draft.name.trim(),\n      previousName: original?.name ?? null,\n      hostIds: [],\n      previousHostIds,\n      renamed: false,\n      added: [],\n      movedIn: [],\n      removed: previousHostIds,\n      unselected: draft.mode === 'dissolve' ? previousHostIds : unselected,\n      donors: [],\n      tooFewSites,\n      empty: !original,\n    }\n  }\n\n  const name = draft.name.trim()\n  const chosen = new Set(selected)\n  const before = new Set(previousHostIds)\n  const donors: ConsentGroupDraftDonor[] = []\n  const movedIn: ConsentGroupDraftChange['movedIn'] = []\n  for (const group of current) {\n    if (group.id === draft.groupId) continue\n    const losing = group.hostIds.filter((hostId) => chosen.has(hostId))\n    if (!losing.length) continue\n    const remaining = group.hostIds.filter((hostId) => !chosen.has(hostId))\n    donors.push({\n      groupId: group.id,\n      name: group.name,\n      losing,\n      remaining,\n      dissolves: remaining.length > 0 && remaining.length < CONSENT_GROUP_MIN_HOSTS,\n      absorbed: remaining.length === 0,\n    })\n    for (const hostId of losing) {\n      movedIn.push({ hostId, fromGroupId: group.id, fromName: group.name })\n    }\n  }\n  const moving = new Set(movedIn.map((move) => move.hostId))\n  const added = selected.filter((id) => !before.has(id) && !moving.has(id))\n  const removed = unselected\n  const renamed = original != null && name !== original.name\n  return {\n    kind: original ? 'edit' : 'create',\n    groupId: draft.groupId,\n    name,\n    previousName: original?.name ?? null,\n    hostIds: selected,\n    previousHostIds,\n    renamed,\n    added,\n    movedIn,\n    removed,\n    unselected,\n    donors,\n    tooFewSites: false,\n    empty:\n      original != null &&\n      !renamed &&\n      !added.length &&\n      !movedIn.length &&\n      !removed.length,\n  }\n}\n\n/**\n * The org's complete next declaration, and where the edited group sits in it.\n *\n * Every other group is carried over as it stands, less any site the edited\n * group takes from it — and a group left with fewer than two sites is left\n * out, which is how the route reads \"dissolved\". The edited group goes last,\n * so a refusal that names a group by its index names it predictably.\n */\nexport function buildConsentGroupDeclaration(\n  current: readonly ListedConsentGroup[],\n  draft: ConsentGroupDraft,\n): { groups: ConsentGroupDeclarationEntry[]; editedIndex: number | null } {\n  const change = describeConsentGroupDraft(current, draft)\n  const taken = new Set(change.kind === 'dissolve' ? [] : change.hostIds)\n  const groups: ConsentGroupDeclarationEntry[] = []\n  for (const group of current) {\n    if (group.id === draft.groupId) continue\n    const hostIds = group.hostIds.filter((hostId) => !taken.has(hostId))\n    if (hostIds.length < CONSENT_GROUP_MIN_HOSTS) continue\n    groups.push({ id: group.id, name: group.name, hostIds })\n  }\n  if (change.kind === 'dissolve') return { groups, editedIndex: null }\n  groups.push({\n    ...(draft.groupId != null ? { id: draft.groupId } : {}),\n    name: change.name,\n    hostIds: change.hostIds,\n  })\n  return { groups, editedIndex: groups.length - 1 }\n}\n\n/** What the edit step says is wrong, by field. */\nexport interface ConsentGroupDraftErrors {\n  name?: string\n  sites?: string\n}\n\n/**\n * The checks the editor can make without asking, which is deliberately few:\n * the route validates everything again and its answer is the one that\n * counts. These exist so the obvious mistakes are said beside the field that\n * has them, before anybody waits on a preview.\n */\nexport function validateConsentGroupDraft(\n  current: readonly ListedConsentGroup[],\n  draft: ConsentGroupDraft,\n): ConsentGroupDraftErrors {\n  const change = describeConsentGroupDraft(current, draft)\n  if (change.kind === 'dissolve') return {}\n  const errors: ConsentGroupDraftErrors = {}\n  if (!change.name) {\n    errors.name = 'Give the group a name. Signup forms show it.'\n  } else if (change.name.length > CONSENT_GROUP_NAME_MAX) {\n    errors.name = `Keep the name to ${CONSENT_GROUP_NAME_MAX} characters or fewer.`\n  } else {\n    const lower = change.name.toLocaleLowerCase()\n    const { groups } = buildConsentGroupDeclaration(current, draft)\n    const clash = groups.some(\n      (group) =>\n        group.id !== draft.groupId &&\n        group.id != null &&\n        group.name.toLocaleLowerCase() === lower,\n    )\n    if (clash) errors.name = 'Another consent group already has this name.'\n  }\n  if (change.hostIds.length < CONSENT_GROUP_MIN_HOSTS) {\n    errors.sites = 'Choose at least two sites.'\n  } else if (change.hostIds.length > MAX_CONSENT_GROUP_HOSTS) {\n    errors.sites = `A consent group can include at most ${MAX_CONSENT_GROUP_HOSTS} sites.`\n  } else if (\n    change.kind === 'edit' &&\n    !change.previousHostIds.some((hostId) => change.hostIds.includes(hostId))\n  ) {\n    errors.sites =\n      'Keep at least one of this group’s sites, or create a new group for these sites instead.'\n  }\n  return errors\n}\n"],"names":["consentGroupDisclosure","CONSENT_GROUPS_FIELD","readConsentGroups","CONSENT_GROUP_MIN_HOSTS","CONSENT_GROUP_NAME_MAX","MAX_CONSENT_GROUP_HOSTS","listConsentGroups","org","Object","entries","map","id","group","name","hostIds","sort","a","b","localeCompare","sensitivity","unusableConsentGroupCount","raw","Array","isArray","usable","keys","filter","length","expectedConsentGroups","draftDisclosure","groupId","trimmed","trim","hostId","declared","awaitsConfirmation","sortedUnique","ids","Set","Boolean","describeConsentGroupDraft","current","draft","original","find","previousHostIds","selected","unselected","includes","tooFewSites","mode","dissolving","kind","previousName","renamed","added","movedIn","removed","donors","empty","chosen","before","losing","has","remaining","push","dissolves","absorbed","fromGroupId","fromName","moving","move","buildConsentGroupDeclaration","change","taken","groups","editedIndex","validateConsentGroupDraft","errors","lower","toLocaleLowerCase","clash","some","sites"],"mappings":"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"}

package/src/lib/components/consent-group-review.d.ts

@@ -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.
+ */
+/**
+ * What the admin is told before a consent group change is applied.
+ *
+ * A change here decides who may email whom, so the review says it in the
+ * terms the admin will be held to rather than in the terms the code uses:
+ * what signup forms will say, who stops getting mail, who can still be
+ * mailed, and what happens to the CRM's records. Every number comes from the
+ * route's preview, which counted it without writing anything; a sentence
+ * whose number the preview did not supply is said without one rather than
+ * with a guess.
+ *
+ * Pure, so each wording can be asserted against a preview without rendering.
+ */
+import type { ConsentGroupChangeEstimate, ConsentGroupChangePreview } from './consent-groups-api';
+import { type ConsentGroupDraftChange } from './consent-group-editing';
+/** One sentence of the review. `warning` is the tone of an irreversible loss. */
+export interface ConsentGroupReviewItem {
+    id: string;
+    text: string;
+    tone: 'info' | 'warning';
+}
+export interface ConsentGroupReviewSection {
+    id: string;
+    heading: string | null;
+    items: ConsentGroupReviewItem[];
+}
+export interface ConsentGroupReview {
+    title: string;
+    /** The primary button, named for what it does. */
+    confirmLabel: string;
+    sections: ConsentGroupReviewSection[];
+}
+export interface ConsentGroupReviewInput {
+    change: ConsentGroupDraftChange;
+    /** `null` while the preview is still being counted. */
+    preview: ConsentGroupChangePreview | null;
+    siteName: (hostId: string) => string;
+    /** The org's switch: a confirmation one site waits on holds its siblings. */
+    awaitsConfirmation: boolean;
+}
+/** `A`, `A and B`, `A, B, and C`. */
+export declare function joinNames(names: readonly string[]): string;
+/** What an estimate means for the person about to wait on it. */
+export declare const CONSENT_GROUP_ESTIMATE_TEXT: Readonly<Record<ConsentGroupChangeEstimate, string>>;
+/** Builds every section of the review, in the order it is read. */
+export declare function describeConsentGroupReview(input: ConsentGroupReviewInput): ConsentGroupReview;