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

package/src/lib/components/consent-group-site-picker.js

@@ -0,0 +1,190 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Checkbox, Chip, FormControl, FormControlLabel, FormHelperText, FormLabel, Stack, TextField, Typography } from "@mui/material";
+import { useMemo, useState } from "react";
+import { MAX_CONSENT_GROUP_HOSTS } from "./consent-groups-api.js";
+/** Past this many sites the list gets a filter, so a long one stays usable. */ const FILTER_FROM = 10;
+/**
+ * The sites a consent group names.
+ *
+ * A site can be one sender with only one set of siblings, so a site already
+ * in another group says which — "In Acme" — and, once ticked, what ticking it
+ * does: "Moves from Acme". The move is legitimate, and the review spells out
+ * what it costs the group it leaves; the badge is there so nobody makes it
+ * without seeing it.
+ *
+ * A site the group names that the org no longer lists is still shown, ticked
+ * and marked, so it can be unticked rather than silently carried into the
+ * next declaration.
+ */ export function ConsentGroupSitePicker(props) {
+    const { sites, groups, groupId, selected, onChange, error, refusedHostIds, disabled } = props;
+    const [filter, setFilter] = useState('');
+    /** The group each site belongs to now, other than the one being edited. */ const memberOf = useMemo(()=>{
+        const found = new Map();
+        for (const group of groups){
+            if (group.id === groupId) continue;
+            for (const hostId of group.hostIds)found.set(hostId, group);
+        }
+        return found;
+    }, [
+        groups,
+        groupId
+    ]);
+    const rows = useMemo(()=>{
+        var _ref;
+        var _groups_find;
+        const listed = sites.map((site)=>({
+                id: site.id,
+                name: site.name || site.subdomain || site.id,
+                missing: false
+            }));
+        const known = new Set(listed.map((site)=>site.id));
+        const own = (_ref = (_groups_find = groups.find((group)=>group.id === groupId)) == null ? void 0 : _groups_find.hostIds) != null ? _ref : [];
+        const orphans = own.filter((hostId)=>!known.has(hostId)).map((hostId)=>({
+                id: hostId,
+                name: hostId,
+                missing: true
+            }));
+        return [
+            ...listed,
+            ...orphans
+        ].sort((a, b)=>a.name.localeCompare(b.name));
+    }, [
+        sites,
+        groups,
+        groupId
+    ]);
+    const chosen = useMemo(()=>new Set(selected), [
+        selected
+    ]);
+    const full = chosen.size >= MAX_CONSENT_GROUP_HOSTS;
+    const needle = filter.trim().toLocaleLowerCase();
+    const visible = needle ? rows.filter((row)=>chosen.has(row.id) || row.name.toLocaleLowerCase().includes(needle)) : rows;
+    const toggle = (hostId, on)=>{
+        const next = new Set(chosen);
+        if (on) next.add(hostId);
+        else next.delete(hostId);
+        onChange([
+            ...next
+        ].sort());
+    };
+    return /*#__PURE__*/ _jsxs(FormControl, {
+        component: "fieldset",
+        error: Boolean(error),
+        disabled: disabled,
+        fullWidth: true,
+        children: [
+            /*#__PURE__*/ _jsx(FormLabel, {
+                component: "legend",
+                children: 'Sites'
+            }),
+            /*#__PURE__*/ _jsx(FormHelperText, {
+                sx: {
+                    mx: 0
+                },
+                children: `Choose at least two sites and at most ${MAX_CONSENT_GROUP_HOSTS}. ` + 'A site can be in only one consent group.'
+            }),
+            rows.length > FILTER_FROM ? /*#__PURE__*/ _jsx(TextField, {
+                size: "small",
+                label: "Find a site",
+                value: filter,
+                onChange: (event)=>setFilter(event.target.value),
+                sx: {
+                    mt: 1,
+                    maxWidth: 320
+                }
+            }) : null,
+            /*#__PURE__*/ _jsxs(Box, {
+                sx: {
+                    mt: 1,
+                    maxHeight: 320,
+                    overflowY: 'auto',
+                    border: 1,
+                    borderColor: 'divider',
+                    borderRadius: 1,
+                    px: 1.5,
+                    py: 0.5
+                },
+                children: [
+                    visible.map((row)=>{
+                        const checked = chosen.has(row.id);
+                        const other = memberOf.get(row.id);
+                        return /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center',
+                                flexWrap: 'wrap'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(FormControlLabel, {
+                                    control: /*#__PURE__*/ _jsx(Checkbox, {
+                                        size: "small",
+                                        checked: checked,
+                                        disabled: disabled || !checked && full,
+                                        onChange: (event)=>toggle(row.id, event.target.checked)
+                                    }),
+                                    label: row.name,
+                                    sx: {
+                                        mr: 0
+                                    }
+                                }),
+                                other ? /*#__PURE__*/ _jsx(Chip, {
+                                    size: "small",
+                                    variant: "outlined",
+                                    color: checked ? 'warning' : 'default',
+                                    label: checked ? `Moves from ${other.name}` : `In ${other.name}`
+                                }) : null,
+                                row.missing ? /*#__PURE__*/ _jsx(Chip, {
+                                    size: "small",
+                                    variant: "outlined",
+                                    color: "warning",
+                                    label: "Not in your organization"
+                                }) : null,
+                                (refusedHostIds == null ? void 0 : refusedHostIds.has(row.id)) ? /*#__PURE__*/ _jsx(Chip, {
+                                    size: "small",
+                                    color: "error",
+                                    variant: "outlined",
+                                    label: "Can’t be added"
+                                }) : null
+                            ]
+                        }, row.id);
+                    }),
+                    !visible.length ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        sx: {
+                            py: 1
+                        },
+                        children: rows.length ? 'No site matches.' : 'Your organization has no sites yet.'
+                    }) : null
+                ]
+            }),
+            /*#__PURE__*/ _jsx(FormHelperText, {
+                sx: {
+                    mx: 0
+                },
+                children: error != null ? error : full ? `That’s the most one group can include (${MAX_CONSENT_GROUP_HOSTS}).` : `${chosen.size} selected`
+            })
+        ]
+    });
+}
+ConsentGroupSitePicker.displayName = 'ConsentGroupSitePicker';
+export default ConsentGroupSitePicker;
+
+//# sourceMappingURL=consent-group-site-picker.js.map

package/src/lib/components/consent-group-site-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/consent-group-site-picker.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 type { ConsolePluginOrgHost } from '@aglyn/aglyn'\nimport {\n  Box,\n  Checkbox,\n  Chip,\n  FormControl,\n  FormControlLabel,\n  FormHelperText,\n  FormLabel,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { useMemo, useState } from 'react'\nimport type { ListedConsentGroup } from './consent-group-editing'\nimport { MAX_CONSENT_GROUP_HOSTS } from './consent-groups-api'\n\n/** Past this many sites the list gets a filter, so a long one stays usable. */\nconst FILTER_FROM = 10\n\nexport interface ConsentGroupSitePickerProps {\n  /** Every site the organization has. */\n  sites: readonly ConsolePluginOrgHost[]\n  /** The groups the org declares now. */\n  groups: readonly ListedConsentGroup[]\n  /** The group being edited, whose own sites carry no badge; `null` for a new one. */\n  groupId: string | null\n  selected: readonly string[]\n  onChange: (hostIds: string[]) => void\n  /** What is wrong with the selection, said under the list. */\n  error?: string\n  /** Sites the route refused by id, marked where they are listed. */\n  refusedHostIds?: ReadonlySet<string>\n  disabled?: boolean\n}\n\n/**\n * The sites a consent group names.\n *\n * A site can be one sender with only one set of siblings, so a site already\n * in another group says which — \"In Acme\" — and, once ticked, what ticking it\n * does: \"Moves from Acme\". The move is legitimate, and the review spells out\n * what it costs the group it leaves; the badge is there so nobody makes it\n * without seeing it.\n *\n * A site the group names that the org no longer lists is still shown, ticked\n * and marked, so it can be unticked rather than silently carried into the\n * next declaration.\n */\nexport function ConsentGroupSitePicker(props: ConsentGroupSitePickerProps) {\n  const {\n    sites,\n    groups,\n    groupId,\n    selected,\n    onChange,\n    error,\n    refusedHostIds,\n    disabled,\n  } = props\n  const [filter, setFilter] = useState('')\n\n  /** The group each site belongs to now, other than the one being edited. */\n  const memberOf = useMemo(() => {\n    const found = new Map<string, ListedConsentGroup>()\n    for (const group of groups) {\n      if (group.id === groupId) continue\n      for (const hostId of group.hostIds) found.set(hostId, group)\n    }\n    return found\n  }, [groups, groupId])\n\n  const rows = useMemo(() => {\n    const listed = sites.map((site) => ({\n      id: site.id,\n      name: site.name || site.subdomain || site.id,\n      missing: false,\n    }))\n    const known = new Set(listed.map((site) => site.id))\n    const own = groups.find((group) => group.id === groupId)?.hostIds ?? []\n    const orphans = own\n      .filter((hostId) => !known.has(hostId))\n      .map((hostId) => ({ id: hostId, name: hostId, missing: true }))\n    return [...listed, ...orphans].sort((a, b) => a.name.localeCompare(b.name))\n  }, [sites, groups, groupId])\n\n  const chosen = useMemo(() => new Set(selected), [selected])\n  const full = chosen.size >= MAX_CONSENT_GROUP_HOSTS\n  const needle = filter.trim().toLocaleLowerCase()\n  const visible = needle\n    ? rows.filter(\n        (row) => chosen.has(row.id) || row.name.toLocaleLowerCase().includes(needle),\n      )\n    : rows\n\n  const toggle = (hostId: string, on: boolean) => {\n    const next = new Set(chosen)\n    if (on) next.add(hostId)\n    else next.delete(hostId)\n    onChange([...next].sort())\n  }\n\n  return (\n    <FormControl component=\"fieldset\" error={Boolean(error)} disabled={disabled} fullWidth>\n      <FormLabel component=\"legend\">{'Sites'}</FormLabel>\n      <FormHelperText sx={{ mx: 0 }}>\n        {`Choose at least two sites and at most ${MAX_CONSENT_GROUP_HOSTS}. ` +\n          'A site can be in only one consent group.'}\n      </FormHelperText>\n      {rows.length > FILTER_FROM ? (\n        <TextField\n          size=\"small\"\n          label=\"Find a site\"\n          value={filter}\n          onChange={(event) => setFilter(event.target.value)}\n          sx={{ mt: 1, maxWidth: 320 }}\n        />\n      ) : null}\n      <Box\n        sx={{\n          mt: 1,\n          maxHeight: 320,\n          overflowY: 'auto',\n          border: 1,\n          borderColor: 'divider',\n          borderRadius: 1,\n          px: 1.5,\n          py: 0.5,\n        }}\n      >\n        {visible.map((row) => {\n          const checked = chosen.has(row.id)\n          const other = memberOf.get(row.id)\n          return (\n            <Stack\n              key={row.id}\n              direction=\"row\"\n              spacing={1}\n              sx={{ alignItems: 'center', flexWrap: 'wrap' }}\n            >\n              <FormControlLabel\n                control={\n                  <Checkbox\n                    size=\"small\"\n                    checked={checked}\n                    disabled={disabled || (!checked && full)}\n                    onChange={(event) => toggle(row.id, event.target.checked)}\n                  />\n                }\n                label={row.name}\n                sx={{ mr: 0 }}\n              />\n              {other ? (\n                <Chip\n                  size=\"small\"\n                  variant=\"outlined\"\n                  color={checked ? 'warning' : 'default'}\n                  label={checked ? `Moves from ${other.name}` : `In ${other.name}`}\n                />\n              ) : null}\n              {row.missing ? (\n                <Chip\n                  size=\"small\"\n                  variant=\"outlined\"\n                  color=\"warning\"\n                  label=\"Not in your organization\"\n                />\n              ) : null}\n              {refusedHostIds?.has(row.id) ? (\n                <Chip size=\"small\" color=\"error\" variant=\"outlined\" label=\"Can’t be added\" />\n              ) : null}\n            </Stack>\n          )\n        })}\n        {!visible.length ? (\n          <Typography variant=\"body2\" color=\"text.secondary\" sx={{ py: 1 }}>\n            {rows.length ? 'No site matches.' : 'Your organization has no sites yet.'}\n          </Typography>\n        ) : null}\n      </Box>\n      <FormHelperText sx={{ mx: 0 }}>\n        {error ??\n          (full\n            ? `That’s the most one group can include (${MAX_CONSENT_GROUP_HOSTS}).`\n            : `${chosen.size} selected`)}\n      </FormHelperText>\n    </FormControl>\n  )\n}\nConsentGroupSitePicker.displayName = 'ConsentGroupSitePicker'\n\nexport default ConsentGroupSitePicker\n"],"names":["Box","Checkbox","Chip","FormControl","FormControlLabel","FormHelperText","FormLabel","Stack","TextField","Typography","useMemo","useState","MAX_CONSENT_GROUP_HOSTS","FILTER_FROM","ConsentGroupSitePicker","props","sites","groups","groupId","selected","onChange","error","refusedHostIds","disabled","filter","setFilter","memberOf","found","Map","group","id","hostId","hostIds","set","rows","listed","map","site","name","subdomain","missing","known","Set","own","find","orphans","has","sort","a","b","localeCompare","chosen","full","size","needle","trim","toLocaleLowerCase","visible","row","includes","toggle","on","next","add","delete","component","Boolean","fullWidth","sx","mx","length","label","value","event","target","mt","maxWidth","maxHeight","overflowY","border","borderColor","borderRadius","px","py","checked","other","get","direction","spacing","alignItems","flexWrap","control","mr","variant","color","displayName"],"mappings":"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"}

package/src/lib/components/consent-groups-api.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @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 { CONSENT_GROUP_CHANGES_COLLECTION, CONSENT_GROUP_NAME_MAX, CONSENT_GROUP_SWEEP_DELAY_MS, CONSENT_GROUPS_CHANGE_FIELD, type ConsentGroupChangeEstimate, type ConsentGroupChangePreview, type ConsentGroupChangePreviewLine, type ConsentGroupDraft, type ConsentGroupsApiChangeRequest, type ConsentGroupsApiChangeResponse, type ConsentGroupsApiDeclarationRequest, type ConsentGroupsApiPreviewResponse, type ConsentGroupsApiRequest, type ConsentGroupsChangeMarker, type ConsentGroupsChangePhase, type ConsentGroupValidationCode } from '@aglyn/aglyn/app-utils/consent-group-change';
+import { MAX_CONSENT_GROUP_HOSTS } from '@aglyn/aglyn/app-utils/consent-groups';
+import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+/** The route every call below posts to. */
+export declare const CONSENT_GROUPS_ROUTE = "/api/orgs/consent-groups";
+export { CONSENT_GROUP_CHANGES_COLLECTION, CONSENT_GROUP_NAME_MAX, CONSENT_GROUP_SWEEP_DELAY_MS, CONSENT_GROUPS_CHANGE_FIELD, MAX_CONSENT_GROUP_HOSTS, };
+/** The fewest sites a group may name; one site is already its own sender. */
+export declare const CONSENT_GROUP_MIN_HOSTS = 2;
+export type { ConsentGroupChangeEstimate, ConsentGroupChangePreview };
+/** One group of the complete next declaration; a new group has no id. */
+export type ConsentGroupDeclarationEntry = ConsentGroupDraft;
+/**
+ * `preview` or `apply` a declaration.
+ *
+ * `groups` is the WHOLE next declaration, not a patch: a group left out is a
+ * group dissolved. `expected` is the raw `org.consentGroups` the editor was
+ * opened against, or `null` when the org had none, so a change made by
+ * somebody else in the meantime is refused rather than overwritten.
+ */
+export type ConsentGroupsDeclareRequest = ConsentGroupsApiDeclarationRequest;
+/** Drive, stop or read one change that is already running. */
+export type ConsentGroupsChangeRequest = ConsentGroupsApiChangeRequest;
+export type ConsentGroupsRequest = ConsentGroupsApiRequest;
+/**
+ * Where a running change is.
+ *
+ * - `carry` — refusals are being copied; the old declaration still holds.
+ * - `rehome` — the new declaration is in force; CRM records are moving.
+ * - `sweep` — a last pass for anything written while it changed.
+ */
+export type ConsentGroupChangePhase = ConsentGroupsChangePhase;
+/** `org.consentGroupsChange`, present exactly while a change runs. */
+export type ConsentGroupChangeMarker = ConsentGroupsChangeMarker;
+/**
+ * A plugin's own account of what the change does to its data, in its words.
+ * The editor prints these as given; `count` is `null` when it was not
+ * counted.
+ */
+export type ConsentGroupParticipantLine = ConsentGroupChangePreviewLine;
+export type ConsentGroupsPreviewResponse = ConsentGroupsApiPreviewResponse;
+/** `apply`, `continue`, `cancel` and `status` all answer the change's state. */
+export type ConsentGroupsProgressResponse = ConsentGroupsApiChangeResponse;
+/** One refusal from the route's validation, pointing at what it refused. */
+export interface ConsentGroupValidationIssue {
+    code: string;
+    /** Index into the `groups` that were posted. */
+    groupIndex?: number;
+    hostId?: string;
+}
+/** Why a call did not succeed, sorted into what the editor does about it. */
+export type ConsentGroupsFailure = {
+    /** 400: the declaration itself; `errors` point at what to fix. */
+    kind: 'invalid';
+    message: string;
+    errors: ConsentGroupValidationIssue[];
+} | {
+    /** 409: somebody else changed the declaration first. */
+    kind: 'stale';
+    message: string;
+    /** The raw declaration as it now stands. */
+    current: Record<string, unknown> | null;
+} | {
+    /** 409: another change is still running, sweep included. */
+    kind: 'in-flight';
+    message: string;
+    changeId: string | null;
+} | {
+    /** 409 on `cancel`: the declaration already flipped. */
+    kind: 'took-effect';
+    message: string;
+} | {
+    kind: 'locked';
+    message: string;
+} | {
+    kind: 'refused';
+    status: number;
+    message: string;
+};
+/**
+ * A call's outcome. Each branch names the other's field as absent, so a
+ * caller can read `failure` after testing `ok` — this workspace compiles
+ * without `strictNullChecks`, under which a boolean discriminant alone does
+ * not narrow.
+ */
+export type ConsentGroupsCallResult<T> = {
+    ok: true;
+    body: T;
+    failure?: undefined;
+} | {
+    ok: false;
+    body?: undefined;
+    failure: ConsentGroupsFailure;
+};
+/**
+ * Every refusal the route's validation can name, and what to tell the admin.
+ *
+ * The route is authoritative — the editor checks only what it can check
+ * without asking (a name, a site count) and shows the rest when the route
+ * answers. The table is keyed by the route's own codes, so a code added there
+ * without a sentence here fails the type check; one it still does not know —
+ * a server newer than this bundle — gets a general sentence rather than none.
+ */
+export declare const CONSENT_GROUP_ISSUE_MESSAGES: Readonly<Record<ConsentGroupValidationCode, string>>;
+/** The sentence for one validation refusal, naming the site when it can. */
+export declare function consentGroupIssueMessage(issue: ConsentGroupValidationIssue, siteName?: (hostId: string) => string): string;
+/** A token source `authorizedFetch` accepts: the signed-in user. */
+type ConsentGroupsCaller = Parameters<typeof authorizedFetch>[0];
+/**
+ * Sorts a refused answer into what the editor does next.
+ *
+ * Exported for the specs, which assert that each status the route documents
+ * lands in the branch the dialog handles.
+ */
+export declare function classifyConsentGroupsFailure(status: number, payload: unknown, action: ConsentGroupsRequest['action']): ConsentGroupsFailure;
+/**
+ * Posts one action and sorts the answer. Never throws: a network failure is
+ * a refusal with a sentence, so every caller has exactly two branches.
+ */
+export declare function postConsentGroups<T>(user: ConsentGroupsCaller, request: ConsentGroupsRequest): Promise<ConsentGroupsCallResult<T>>;
+/**
+ * The org's in-flight change, or `null` when none runs.
+ *
+ * A marker without a change id is not a change anybody can drive or stop,
+ * so it reads as absent; an unknown phase reads as `carry`, the phase in
+ * which nothing has taken effect, because that is the claim a banner can
+ * make without being wrong.
+ */
+export declare function readConsentGroupChangeMarker(org: Record<string, unknown> | null | undefined): ConsentGroupChangeMarker | null;
+/** What the progress banner needs from a change's job document. */
+export interface ConsentGroupChangeJobView {
+    /** The job's own phase, when it records one. */
+    phase: string | null;
+    /** When another runner's claim on the job lapses; `null` when unclaimed. */
+    leaseUntilMs: number | null;
+    stalled: boolean;
+    lastError: string | null;
+    failures: number;
+    /** The change finished, or was stopped before it took effect. */
+    finished: boolean;
+}
+/** Reads a job document defensively. `undefined` reads as a fresh job. */
+export declare function readConsentGroupChangeJob(data: Record<string, unknown> | null | undefined): ConsentGroupChangeJobView;

package/src/lib/components/consent-groups-api.js

@@ -0,0 +1,250 @@
+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 console's client of `POST /api/orgs/consent-groups` — the one door
+ * through which a consent group is declared, edited or dissolved (AGL-3320).
+ *
+ * ## Why the editor never writes Firestore
+ *
+ * `consentGroups` decides whose opt-outs hold a send and who a grant covers,
+ * so the rules deny it to every client. A change is also not one write: the
+ * route carries every refusal the change would otherwise lose onto the sites
+ * that stop reading each other, flips the declaration, and then re-homes the
+ * CRM records keyed by the old group — a job of several invocations with its
+ * own lock. The console only asks: `preview` what a change would do, `apply`
+ * it, and drive it with `continue` while somebody is watching. Everything
+ * else is the server's.
+ *
+ * ## The wire shapes are the route's own
+ *
+ * Every request and response type below is the planner module's
+ * (`@aglyn/aglyn/app-utils/consent-group-change`), imported as a type and
+ * erased from the bundle, so a field the route renames fails this plugin's
+ * type check instead of rendering a sentence with a hole in it. The constants
+ * come from the same module; it is pure, with no read and no server import.
+ *
+ * Nothing the server says is trusted to be well formed all the same: every
+ * reader below accepts a missing or mistyped field and answers the narrow
+ * value, because a progress banner that throws on a field it did not expect
+ * would hide the one change an org cannot afford to lose track of.
+ */ import { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn";
+import { CONSENT_GROUP_CHANGES_COLLECTION, CONSENT_GROUP_NAME_MAX, CONSENT_GROUP_SWEEP_DELAY_MS, CONSENT_GROUPS_CHANGE_FIELD } from "@aglyn/aglyn/app-utils/consent-group-change";
+import { MAX_CONSENT_GROUP_HOSTS } from "@aglyn/aglyn/app-utils/consent-groups";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+/** The route every call below posts to. */ export const CONSENT_GROUPS_ROUTE = '/api/orgs/consent-groups';
+export { CONSENT_GROUP_CHANGES_COLLECTION, CONSENT_GROUP_NAME_MAX, CONSENT_GROUP_SWEEP_DELAY_MS, CONSENT_GROUPS_CHANGE_FIELD, MAX_CONSENT_GROUP_HOSTS,  };
+/** The fewest sites a group may name; one site is already its own sender. */ export const CONSENT_GROUP_MIN_HOSTS = 2;
+/*==========================================
+ * VALIDATION CODES
+ *=========================================*/ /**
+ * Every refusal the route's validation can name, and what to tell the admin.
+ *
+ * The route is authoritative — the editor checks only what it can check
+ * without asking (a name, a site count) and shows the rest when the route
+ * answers. The table is keyed by the route's own codes, so a code added there
+ * without a sentence here fails the type check; one it still does not know —
+ * a server newer than this bundle — gets a general sentence rather than none.
+ */ export const CONSENT_GROUP_ISSUE_MESSAGES = {
+    malformed: 'This change couldn’t be read. Reload the page and try again.',
+    'name-empty': 'Give the group a name. Signup forms show it, so it can’t be blank.',
+    'name-too-long': `Keep the name to ${CONSENT_GROUP_NAME_MAX} characters or fewer.`,
+    'name-duplicate': 'Another consent group already has this name.',
+    'too-few-sites': 'A consent group needs at least two sites.',
+    'too-many-sites': `A consent group can include at most ${MAX_CONSENT_GROUP_HOSTS} sites.`,
+    'unknown-site': 'One of these sites is no longer part of your organization.',
+    'site-in-two-groups': 'A site can be in only one consent group.',
+    'unknown-group': 'This consent group no longer exists. Close this and start again.',
+    'group-replaced': 'Every site in this group would be replaced. Create a new group for these sites instead.',
+    'duplicate-group': 'The same consent group appears twice. Reload the page and try again.',
+    'no-change': 'Nothing has changed yet.'
+};
+/** The sentence for one validation refusal, naming the site when it can. */ export function consentGroupIssueMessage(issue, siteName) {
+    var _CONSENT_GROUP_ISSUE_MESSAGES_code;
+    const code = issue.code;
+    const site = issue.hostId && siteName ? siteName(issue.hostId) : '';
+    if (site && code === 'unknown-site') {
+        return `${site} is no longer part of your organization.`;
+    }
+    if (site && code === 'site-in-two-groups') {
+        return `${site} can be in only one consent group.`;
+    }
+    return (_CONSENT_GROUP_ISSUE_MESSAGES_code = CONSENT_GROUP_ISSUE_MESSAGES[code]) != null ? _CONSENT_GROUP_ISSUE_MESSAGES_code : 'This change can’t be made as it stands. Check the name and sites and try again.';
+}
+const STALE_MESSAGE = 'Someone else changed consent groups while you were editing.';
+const IN_FLIGHT_MESSAGE = 'Finishing the last change. You can make another once it’s done.';
+const TOOK_EFFECT_MESSAGE = 'This change already took effect, so it can’t be stopped now. It will finish on its own.';
+const asRecord = (value)=>value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+/**
+ * Sorts a refused answer into what the editor does next.
+ *
+ * Exported for the specs, which assert that each status the route documents
+ * lands in the branch the dialog handles.
+ */ export function classifyConsentGroupsFailure(status, payload, action) {
+    const body = asRecord(payload);
+    const said = typeof body['error'] === 'string' ? body['error'] : '';
+    if (status === 400) {
+        const errors = Array.isArray(body['errors']) ? body['errors'].map(asRecord).filter((issue)=>typeof issue['code'] === 'string').map((issue)=>_extends({
+                code: String(issue['code'])
+            }, typeof issue['groupIndex'] === 'number' ? {
+                groupIndex: issue['groupIndex']
+            } : {}, typeof issue['hostId'] === 'string' ? {
+                hostId: issue['hostId']
+            } : {})) : [];
+        return {
+            kind: 'invalid',
+            message: errors.length ? consentGroupIssueMessage(errors[0]) : said || 'This change can’t be made as it stands.',
+            errors
+        };
+    }
+    if (status === 409) {
+        if (action === 'cancel') {
+            return {
+                kind: 'took-effect',
+                message: TOOK_EFFECT_MESSAGE
+            };
+        }
+        if ('current' in body) {
+            const current = body['current'];
+            return {
+                kind: 'stale',
+                message: STALE_MESSAGE,
+                current: current && typeof current === 'object' && !Array.isArray(current) ? current : null
+            };
+        }
+        return {
+            kind: 'in-flight',
+            message: IN_FLIGHT_MESSAGE,
+            changeId: typeof body['changeId'] === 'string' ? body['changeId'] : null
+        };
+    }
+    if (status === 423) {
+        const locked = parseLockdownRefusal(status, payload);
+        return {
+            kind: 'locked',
+            message: locked ? lockdownRefusalText(locked) : 'Changes are paused right now. Try again later.'
+        };
+    }
+    if (status === 401) {
+        return {
+            kind: 'refused',
+            status,
+            message: 'Your session has ended. Sign in again to change consent groups.'
+        };
+    }
+    if (status === 403) {
+        return {
+            kind: 'refused',
+            status,
+            message: body['reason'] === 'email-unverified' ? 'Verify your email address to change consent groups.' : said || 'You don’t have permission to change consent groups.'
+        };
+    }
+    if (status === 404) {
+        return {
+            kind: 'refused',
+            status,
+            message: said || 'This organization could not be found.'
+        };
+    }
+    return {
+        kind: 'refused',
+        status,
+        message: said || 'Something went wrong. Try again in a moment.'
+    };
+}
+/**
+ * Posts one action and sorts the answer. Never throws: a network failure is
+ * a refusal with a sentence, so every caller has exactly two branches.
+ */ export async function postConsentGroups(user, request) {
+    let response;
+    try {
+        response = await authorizedFetch(user, CONSENT_GROUPS_ROUTE, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(request)
+        });
+    } catch (unused) {
+        return {
+            ok: false,
+            failure: {
+                kind: 'refused',
+                status: 0,
+                message: 'The server couldn’t be reached. Check your connection and try again.'
+            }
+        };
+    }
+    const payload = await response.json().catch(()=>null);
+    if (response.ok && asRecord(payload)['ok'] === true) {
+        return {
+            ok: true,
+            body: payload
+        };
+    }
+    return {
+        ok: false,
+        failure: classifyConsentGroupsFailure(response.ok ? 500 : response.status, payload, request.action)
+    };
+}
+/*==========================================
+ * READING WHAT THE ORG DOCUMENT AND THE JOB SAY
+ *=========================================*/ const PHASES = [
+    'carry',
+    'rehome',
+    'sweep'
+];
+const finiteNumber = (value)=>typeof value === 'number' && Number.isFinite(value) ? value : null;
+/**
+ * The org's in-flight change, or `null` when none runs.
+ *
+ * A marker without a change id is not a change anybody can drive or stop,
+ * so it reads as absent; an unknown phase reads as `carry`, the phase in
+ * which nothing has taken effect, because that is the claim a banner can
+ * make without being wrong.
+ */ export function readConsentGroupChangeMarker(org) {
+    var _finiteNumber;
+    const raw = asRecord(asRecord(org)[CONSENT_GROUPS_CHANGE_FIELD]);
+    const changeId = typeof raw['changeId'] === 'string' ? raw['changeId'] : '';
+    if (!changeId) return null;
+    const phase = PHASES.includes(raw['phase']) ? raw['phase'] : 'carry';
+    const declaredAtMs = finiteNumber(raw['declaredAtMs']);
+    return _extends({
+        changeId,
+        phase,
+        hostIds: Array.isArray(raw['hostIds']) ? raw['hostIds'].filter((id)=>typeof id === 'string' && !!id) : [],
+        startedAtMs: (_finiteNumber = finiteNumber(raw['startedAtMs'])) != null ? _finiteNumber : 0
+    }, declaredAtMs != null ? {
+        declaredAtMs
+    } : {});
+}
+/** Reads a job document defensively. `undefined` reads as a fresh job. */ export function readConsentGroupChangeJob(data) {
+    var _finiteNumber;
+    const job = asRecord(data);
+    const lease = asRecord(job['lease']);
+    const lastError = job['lastError'];
+    const phase = typeof job['phase'] === 'string' ? job['phase'] : null;
+    return {
+        phase,
+        leaseUntilMs: finiteNumber(lease['untilMs']),
+        stalled: job['stalled'] === true,
+        lastError: typeof lastError === 'string' ? lastError : typeof asRecord(lastError)['message'] === 'string' ? String(asRecord(lastError)['message']) : null,
+        failures: (_finiteNumber = finiteNumber(job['failures'])) != null ? _finiteNumber : 0,
+        finished: job['done'] === true || finiteNumber(job['finishedAtMs']) != null || finiteNumber(job['canceledAtMs']) != null || phase === 'done' || phase === 'canceled'
+    };
+}
+
+//# sourceMappingURL=consent-groups-api.js.map