@aglyn/aglyn 1.0.0-beta.143

package/src/lib/app-utils/consent-preferences-dialog.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @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.
+ */ // No 'use client' directive, for the reason `consent-banner-ui.tsx` gives:
+// inside @aglyn/aglyn it would split the bundler into a duplicate module graph.
+// The only importer is that module, which is already inside the client graph.
+import { Box, Button, Dialog, DialogActions, DialogContent, DialogTitle, FormControlLabel, Stack, Switch, Typography } from "@mui/material";
+/** One control per category, label and detail on two lines. */ function CategorySwitch(props) {
+    const { label, detail, checked, onChange } = props;
+    return /*#__PURE__*/ _jsx(FormControlLabel, {
+        control: /*#__PURE__*/ _jsx(Switch, {
+            checked: checked,
+            onChange: (event)=>onChange(event.target.checked),
+            slotProps: {
+                input: {
+                    'aria-label': label
+                }
+            }
+        }),
+        label: /*#__PURE__*/ _jsxs(Box, {
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    children: label
+                }),
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: detail
+                })
+            ]
+        })
+    });
+}
+export function ConsentPreferencesDialog(props) {
+    const { title, zIndex, words, advertising, policyLinks, analyticsChecked, onAnalyticsChange, adsChecked, onAdsChange, onClose, onDeclineAll, onSave } = props;
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: true,
+        onClose: onClose,
+        maxWidth: "sm",
+        fullWidth: true,
+        "aria-label": title,
+        "data-aglyn-consent-preferences": "",
+        sx: {
+            zIndex
+        },
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                children: title
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            children: `${words.panelIntro} ${words.strictlyNecessary}`
+                        }),
+                        /*#__PURE__*/ _jsx(CategorySwitch, {
+                            label: words.analyticsLabel,
+                            detail: words.analyticsDetail,
+                            checked: analyticsChecked,
+                            onChange: onAnalyticsChange
+                        }),
+                        advertising ? /*#__PURE__*/ _jsx(CategorySwitch, {
+                            label: words.advertisingLabel,
+                            detail: words.advertisingDetail,
+                            checked: adsChecked,
+                            onChange: onAdsChange
+                        }) : null,
+                        policyLinks
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsxs(DialogActions, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        onClick: onDeclineAll,
+                        children: 'Decline all'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        onClick: onSave,
+                        children: 'Save choices'
+                    })
+                ]
+            })
+        ]
+    });
+}
+export default ConsentPreferencesDialog;
+
+//# sourceMappingURL=consent-preferences-dialog.js.map

package/src/lib/app-utils/consent-preferences-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/consent-preferences-dialog.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// No 'use client' directive, for the reason `consent-banner-ui.tsx` gives:\n// inside @aglyn/aglyn it would split the bundler into a duplicate module graph.\n// The only importer is that module, which is already inside the client graph.\n\nimport {\n  Box,\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  FormControlLabel,\n  Stack,\n  Switch,\n  Typography,\n} from '@mui/material'\nimport type { ReactElement, ReactNode } from 'react'\n\n/**\n * The visitor consent preferences panel: one switch per category, and refuse\n * and save as the same control at the same level.\n *\n * Its own module because it is the one consent surface a visit has to ASK\n * for. The banner and the pill are drawn without a click; this panel opens\n * only from Preferences, the pill or a `#aglyn-consent` link, and MUI's\n * `Dialog`, `Modal`, focus trap, transitions and `Switch` are the larger half\n * of what the consent surfaces weigh. `consent-banner-ui.tsx` loads this file\n * when the panel is asked for (or looks about to be) and draws it from there;\n * it holds the state, and this file only draws it.\n */\n\n/** The words the panel shows — the `ConsentCopy` fields it reads, resolved. */\nexport interface ConsentPreferencesWords {\n  panelIntro: string\n  strictlyNecessary: string\n  analyticsLabel: string\n  analyticsDetail: string\n  advertisingLabel: string\n  advertisingDetail: string\n}\n\nexport interface ConsentPreferencesDialogProps {\n  /** The panel's title, fixed by regulation (`CONSENT_OPT_OUT_TITLE`). */\n  title: string\n  /** Stacking order; it has to outrank any popup backdrop on the page. */\n  zIndex: number\n  words: ConsentPreferencesWords\n  /** Whether the surface asks about advertising storage at all. */\n  advertising?: boolean\n  /** Links to the policies behind the choice, under the copy. */\n  policyLinks?: ReactNode\n  analyticsChecked: boolean\n  onAnalyticsChange: (checked: boolean) => void\n  adsChecked: boolean\n  onAdsChange: (checked: boolean) => void\n  onClose: () => void\n  onDeclineAll: () => void\n  onSave: () => void\n}\n\n/** One control per category, label and detail on two lines. */\nfunction CategorySwitch(props: {\n  label: string\n  detail: string\n  checked: boolean\n  onChange: (checked: boolean) => void\n}): ReactElement {\n  const { label, detail, checked, onChange } = props\n  return (\n    <FormControlLabel\n      control={\n        <Switch\n          checked={checked}\n          onChange={(event) => onChange(event.target.checked)}\n          slotProps={{ input: { 'aria-label': label } }}\n        />\n      }\n      label={\n        <Box>\n          <Typography variant=\"body2\">{label}</Typography>\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {detail}\n          </Typography>\n        </Box>\n      }\n    />\n  )\n}\n\nexport function ConsentPreferencesDialog(\n  props: ConsentPreferencesDialogProps,\n): ReactElement {\n  const {\n    title,\n    zIndex,\n    words,\n    advertising,\n    policyLinks,\n    analyticsChecked,\n    onAnalyticsChange,\n    adsChecked,\n    onAdsChange,\n    onClose,\n    onDeclineAll,\n    onSave,\n  } = props\n  return (\n    <Dialog\n      open\n      onClose={onClose}\n      maxWidth=\"sm\"\n      fullWidth\n      aria-label={title}\n      data-aglyn-consent-preferences=\"\"\n      sx={{ zIndex }}\n    >\n      {/* The exact words are fixed by CCPA regs §7015 for a combined\n          opt-out control — see `CONSENT_OPT_OUT_TITLE`. */}\n      <DialogTitle>{title}</DialogTitle>\n      <DialogContent>\n        <Stack spacing={2}>\n          <Typography variant=\"body2\">\n            {`${words.panelIntro} ${words.strictlyNecessary}`}\n          </Typography>\n          <CategorySwitch\n            label={words.analyticsLabel}\n            detail={words.analyticsDetail}\n            checked={analyticsChecked}\n            onChange={onAnalyticsChange}\n          />\n          {advertising ? (\n            <CategorySwitch\n              label={words.advertisingLabel}\n              detail={words.advertisingDetail}\n              checked={adsChecked}\n              onChange={onAdsChange}\n            />\n          ) : null}\n          {policyLinks}\n        </Stack>\n      </DialogContent>\n      <DialogActions>\n        {/* Refuse and accept are the SAME control at the same level — no\n            dark patterns, no click-deep refusal. */}\n        <Button onClick={onDeclineAll}>{'Decline all'}</Button>\n        <Button variant=\"contained\" onClick={onSave}>\n          {'Save choices'}\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\n\nexport default ConsentPreferencesDialog\n"],"names":["Box","Button","Dialog","DialogActions","DialogContent","DialogTitle","FormControlLabel","Stack","Switch","Typography","CategorySwitch","props","label","detail","checked","onChange","control","event","target","slotProps","input","variant","color","ConsentPreferencesDialog","title","zIndex","words","advertising","policyLinks","analyticsChecked","onAnalyticsChange","adsChecked","onAdsChange","onClose","onDeclineAll","onSave","open","maxWidth","fullWidth","aria-label","data-aglyn-consent-preferences","sx","spacing","panelIntro","strictlyNecessary","analyticsLabel","analyticsDetail","advertisingLabel","advertisingDetail","onClick"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GACD,2EAA2E;AAC3E,gFAAgF;AAChF,8EAA8E;AAE9E,SACEA,GAAG,EACHC,MAAM,EACNC,MAAM,EACNC,aAAa,EACbC,aAAa,EACbC,WAAW,EACXC,gBAAgB,EAChBC,KAAK,EACLC,MAAM,EACNC,UAAU,QACL,gBAAe;AA6CtB,6DAA6D,GAC7D,SAASC,eAAeC,KAKvB;IACC,MAAM,EAAEC,KAAK,EAAEC,MAAM,EAAEC,OAAO,EAAEC,QAAQ,EAAE,GAAGJ;IAC7C,qBACE,KAACL;QACCU,uBACE,KAACR;YACCM,SAASA;YACTC,UAAU,CAACE,QAAUF,SAASE,MAAMC,MAAM,CAACJ,OAAO;YAClDK,WAAW;gBAAEC,OAAO;oBAAE,cAAcR;gBAAM;YAAE;;QAGhDA,qBACE,MAACZ;;8BACC,KAACS;oBAAWY,SAAQ;8BAAST;;8BAC7B,KAACH;oBAAWY,SAAQ;oBAAUC,OAAM;8BACjCT;;;;;AAMb;AAEA,OAAO,SAASU,yBACdZ,KAAoC;IAEpC,MAAM,EACJa,KAAK,EACLC,MAAM,EACNC,KAAK,EACLC,WAAW,EACXC,WAAW,EACXC,gBAAgB,EAChBC,iBAAiB,EACjBC,UAAU,EACVC,WAAW,EACXC,OAAO,EACPC,YAAY,EACZC,MAAM,EACP,GAAGxB;IACJ,qBACE,MAACT;QACCkC,IAAI;QACJH,SAASA;QACTI,UAAS;QACTC,SAAS;QACTC,cAAYf;QACZgB,kCAA+B;QAC/BC,IAAI;YAAEhB;QAAO;;0BAIb,KAACpB;0BAAamB;;0BACd,KAACpB;0BACC,cAAA,MAACG;oBAAMmC,SAAS;;sCACd,KAACjC;4BAAWY,SAAQ;sCACjB,GAAGK,MAAMiB,UAAU,CAAC,CAAC,EAAEjB,MAAMkB,iBAAiB,EAAE;;sCAEnD,KAAClC;4BACCE,OAAOc,MAAMmB,cAAc;4BAC3BhC,QAAQa,MAAMoB,eAAe;4BAC7BhC,SAASe;4BACTd,UAAUe;;wBAEXH,4BACC,KAACjB;4BACCE,OAAOc,MAAMqB,gBAAgB;4BAC7BlC,QAAQa,MAAMsB,iBAAiB;4BAC/BlC,SAASiB;4BACThB,UAAUiB;6BAEV;wBACHJ;;;;0BAGL,MAACzB;;kCAGC,KAACF;wBAAOgD,SAASf;kCAAe;;kCAChC,KAACjC;wBAAOoB,SAAQ;wBAAY4B,SAASd;kCAClC;;;;;;AAKX;AAEA,eAAeZ,yBAAwB"}

package/src/lib/app-utils/console-record-links.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @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 { ContactInteraction, ContactSource } from './contacts';
+/**
+ * Where the console's records live, for a surface that is not the one the
+ * record belongs to (AGL-2622).
+ *
+ * ## Why these addresses are built here and not where they are used
+ *
+ * A CRM record is reached from six surfaces that are not the CRM — the
+ * top-bar search, an Inbox row, a form's page, an order, a booking, a site
+ * user — and a CRM timeline points back at four of them. Two of those
+ * readers are the console APP, which the module boundaries forbid from
+ * importing a feature plugin at all: a plugin reaches the app only through
+ * the generated loader manifests, so the app cannot ask the CRM for its own
+ * route builder. The CRM plugin's `crmRoutes(basePath)` stays the builder
+ * inside the plugin family; this module is the same address spelled once
+ * for the console side, in the shared library both may import, and the
+ * plugin's builder is pinned against it by a spec so the two cannot drift.
+ *
+ * ## Why the arguments are the two route params and not a host document
+ *
+ * Every site console page is addressed by `/{orgSlug}/hosts/{host}/…`, and
+ * both segments are already in the URL a surface is rendered on. Building
+ * from them costs nothing; resolving them from a host id costs two document
+ * reads (`hostIndex`, then the org) on every open of a card, to render a
+ * link. `useConsoleHubPath` in the marketing plugin makes the same choice
+ * for the same reason.
+ */
+export interface SiteConsoleContext {
+    orgSlug: string;
+    host: string;
+}
+/** The CRM's nav slug — the `[pluginSlug]` segment the shell resolves. */
+export declare const CRM_CONSOLE_SLUG = "crm";
+/** The four record kinds a surface outside the CRM may name. */
+export type CrmRecordKind = 'contact' | 'lead' | 'company' | 'deal';
+/**
+ * The hub section each kind's record lives under, which is also the list a
+ * kind-only link lands on. Named here rather than in the plugin's section
+ * registry so the console app can address a record without the plugin.
+ */
+export declare const CRM_RECORD_SECTIONS: Record<CrmRecordKind, string>;
+/** `/{orgSlug}/hosts/{host}/crm` — the CRM hub on the site being read. */
+export declare function crmHubHref(context: SiteConsoleContext): string;
+/** One section of the hub — the Leads list, the Deals board. */
+export declare function crmSectionHref(context: SiteConsoleContext, section: string): string;
+/**
+ * One record's own page. The id is URL-encoded because a Firestore id is
+ * opaque — the console mints its own, but an import or an API caller may
+ * not, and a slash in an id would otherwise read as a further segment.
+ */
+export declare function crmRecordHref(context: SiteConsoleContext, kind: CrmRecordKind, id: string): string;
+/**
+ * The query key the Contacts list reads to OPEN the one person with an
+ * address (AGL-2612). A surface that holds only an email — an order, a
+ * booking, a site user — links to the list with this key, the list filters
+ * on the address and moves on to the record when exactly one matches. The
+ * plugin re-exports this constant as `CONTACTS_LIST_EMAIL_PARAM` so its
+ * parser and the console's builders read one string.
+ */
+export declare const CRM_CONTACTS_EMAIL_PARAM = "email";
+/** The Contacts list asked to open the person with this address. */
+export declare function crmContactByEmailHref(context: SiteConsoleContext, email: string): string;
+/**
+ * `/{orgSlug}/crm` — the ORGANIZATION-level CRM hub (AGL-2630), the same
+ * sections mounted with no site.
+ *
+ * The org-level twin of {@link crmHubHref}, and separate from it because the
+ * two take different arguments: a site address needs the subdomain, and a
+ * surface standing at the org hub has none to give. A caller that faked one
+ * would put a site's name on a page about all of them.
+ */
+export declare function crmOrgHubHref(orgSlug: string): string;
+/** One section of the org-level hub — the cross-site Deals board. */
+export declare function crmOrgSectionHref(orgSlug: string, section: string): string;
+/**
+ * One record's page at the org level.
+ *
+ * A lead is excluded by the type rather than by a runtime check: a lead's id
+ * is a PERSON KEY, the same on every site that met the person, and
+ * `hosts/{hostId}/leads` is host-scoped by path — so an org-level address
+ * has to name the site as well, which is {@link crmOrgLeadHref}.
+ */
+export declare function crmOrgRecordHref(orgSlug: string, kind: Exclude<CrmRecordKind, 'lead'>, id: string): string;
+/** One site's lead, addressed from the org hub: the site, then the lead. */
+export declare function crmOrgLeadHref(orgSlug: string, hostId: string, leadId: string): string;
+/**
+ * The query keys a site record page reads on arrival, so a CRM timeline can
+ * open the submission or the order it names rather than the list it sits
+ * in. Each page parses its own key from `useSearchParams`; the CRM writes
+ * them through `siteRecordLinks`, and the constant is shared so neither
+ * side can misspell the other.
+ */
+export declare const INBOX_SUBMISSION_PARAM = "submission";
+export declare const ORDERS_ORDER_PARAM = "order";
+/**
+ * The orders list narrowed to one buyer. The same word as the CRM's own
+ * email key, deliberately: a reader who edits one URL into the other is
+ * not surprised.
+ */
+export declare const ORDERS_CUSTOMER_PARAM = "email";
+/**
+ * The Bookings page narrowed to one booker (AGL-2660) — the same key as the
+ * orders list and the CRM, for the same reason: one address, one word.
+ */
+export declare const BOOKINGS_BOOKER_PARAM = "email";
+/**
+ * Where the site records a contact's captured history names are read
+ * (AGL-2622): the Inbox for a submission, the Orders section of the
+ * Products hub for an order, the Bookings page and the Users page for the
+ * rest. Built from the route table so a section that moves is found here
+ * by its route name rather than by searching for a string.
+ */
+export declare function siteRecordLinks(context: SiteConsoleContext): {
+    /** The Inbox's Submissions tab, with the reader open on one submission. */
+    submission: (submissionId: string) => string;
+    /** The Orders list. */
+    orders: () => string;
+    /** The Orders list with one order's dialog open. */
+    order: (orderId: string) => string;
+    /** The Orders list narrowed to one buyer's address. */
+    ordersByCustomer: (email: string) => string;
+    /** The Bookings page; a booking has no page of its own. */
+    bookings: () => string;
+    /** The Bookings page narrowed to one booker's address (AGL-2660). */
+    bookingsByBooker: (email: string) => string;
+    /** The Users page, where a site account's row and drawer are. */
+    members: () => string;
+};
+export type SiteRecordLinks = ReturnType<typeof siteRecordLinks>;
+/**
+ * What the link on a captured timeline entry says. Only the doors that
+ * leave a record the console can open are named; a newsletter opt-in, an
+ * API create, an import or a by-hand add leave nothing to open, so they
+ * carry no link and no label.
+ */
+export declare const INTERACTION_LINK_LABELS: Partial<Record<ContactSource, string>>;
+/**
+ * The console page a captured interaction points back at, or `null` when
+ * the door left nothing to open.
+ *
+ * A submission and an order are addressed by the `refId` the capture door
+ * stamped — `formSubmissions/{id}`, `orders/{id}` — and an interaction that
+ * predates the stamp lands on nothing rather than on a list that would read
+ * as "the record is gone". A booking and a member sign-up land on their
+ * pages, which list them; neither page addresses one row.
+ */
+export declare function contactInteractionHref(interaction: Pick<ContactInteraction, 'type' | 'refId'>, context: SiteConsoleContext): string | null;

package/src/lib/app-utils/console-record-links.js

@@ -0,0 +1,178 @@
+/**
+ * @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 { buildRoute, Route } from "./console-routes.js";
+/** The CRM's nav slug — the `[pluginSlug]` segment the shell resolves. */ export const CRM_CONSOLE_SLUG = 'crm';
+/**
+ * The hub section each kind's record lives under, which is also the list a
+ * kind-only link lands on. Named here rather than in the plugin's section
+ * registry so the console app can address a record without the plugin.
+ */ export const CRM_RECORD_SECTIONS = {
+    contact: 'contacts',
+    lead: 'leads',
+    company: 'companies',
+    deal: 'deals'
+};
+/** `/{orgSlug}/hosts/{host}/crm` — the CRM hub on the site being read. */ export function crmHubHref(context) {
+    return buildRoute(Route.HOST_PLUGIN, {
+        orgSlug: context.orgSlug,
+        host: context.host,
+        pluginSlug: CRM_CONSOLE_SLUG
+    });
+}
+/** One section of the hub — the Leads list, the Deals board. */ export function crmSectionHref(context, section) {
+    return `${crmHubHref(context)}/${section}`;
+}
+/**
+ * One record's own page. The id is URL-encoded because a Firestore id is
+ * opaque — the console mints its own, but an import or an API caller may
+ * not, and a slash in an id would otherwise read as a further segment.
+ */ export function crmRecordHref(context, kind, id) {
+    return `${crmSectionHref(context, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`;
+}
+/**
+ * The query key the Contacts list reads to OPEN the one person with an
+ * address (AGL-2612). A surface that holds only an email — an order, a
+ * booking, a site user — links to the list with this key, the list filters
+ * on the address and moves on to the record when exactly one matches. The
+ * plugin re-exports this constant as `CONTACTS_LIST_EMAIL_PARAM` so its
+ * parser and the console's builders read one string.
+ */ export const CRM_CONTACTS_EMAIL_PARAM = 'email';
+/** The Contacts list asked to open the person with this address. */ export function crmContactByEmailHref(context, email) {
+    return `${crmSectionHref(context, CRM_RECORD_SECTIONS.contact)}?${new URLSearchParams({
+        [CRM_CONTACTS_EMAIL_PARAM]: email
+    }).toString()}`;
+}
+/**
+ * `/{orgSlug}/crm` — the ORGANIZATION-level CRM hub (AGL-2630), the same
+ * sections mounted with no site.
+ *
+ * The org-level twin of {@link crmHubHref}, and separate from it because the
+ * two take different arguments: a site address needs the subdomain, and a
+ * surface standing at the org hub has none to give. A caller that faked one
+ * would put a site's name on a page about all of them.
+ */ export function crmOrgHubHref(orgSlug) {
+    return buildRoute(Route.ORG_CRM, {
+        orgSlug
+    });
+}
+/** One section of the org-level hub — the cross-site Deals board. */ export function crmOrgSectionHref(orgSlug, section) {
+    return `${crmOrgHubHref(orgSlug)}/${section}`;
+}
+/**
+ * One record's page at the org level.
+ *
+ * A lead is excluded by the type rather than by a runtime check: a lead's id
+ * is a PERSON KEY, the same on every site that met the person, and
+ * `hosts/{hostId}/leads` is host-scoped by path — so an org-level address
+ * has to name the site as well, which is {@link crmOrgLeadHref}.
+ */ export function crmOrgRecordHref(orgSlug, kind, id) {
+    return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`;
+}
+/** One site's lead, addressed from the org hub: the site, then the lead. */ export function crmOrgLeadHref(orgSlug, hostId, leadId) {
+    return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS.lead)}/${encodeURIComponent(hostId)}/${encodeURIComponent(leadId)}`;
+}
+/**
+ * The query keys a site record page reads on arrival, so a CRM timeline can
+ * open the submission or the order it names rather than the list it sits
+ * in. Each page parses its own key from `useSearchParams`; the CRM writes
+ * them through `siteRecordLinks`, and the constant is shared so neither
+ * side can misspell the other.
+ */ export const INBOX_SUBMISSION_PARAM = 'submission';
+export const ORDERS_ORDER_PARAM = 'order';
+/**
+ * The orders list narrowed to one buyer. The same word as the CRM's own
+ * email key, deliberately: a reader who edits one URL into the other is
+ * not surprised.
+ */ export const ORDERS_CUSTOMER_PARAM = 'email';
+/**
+ * The Bookings page narrowed to one booker (AGL-2660) — the same key as the
+ * orders list and the CRM, for the same reason: one address, one word.
+ */ export const BOOKINGS_BOOKER_PARAM = 'email';
+/**
+ * Where the site records a contact's captured history names are read
+ * (AGL-2622): the Inbox for a submission, the Orders section of the
+ * Products hub for an order, the Bookings page and the Users page for the
+ * rest. Built from the route table so a section that moves is found here
+ * by its route name rather than by searching for a string.
+ */ export function siteRecordLinks(context) {
+    const { orgSlug, host } = context;
+    const inbox = `${buildRoute(Route.HOST_INBOX, {
+        orgSlug,
+        host
+    })}/submissions`;
+    const orders = `${buildRoute(Route.HOST_PRODUCTS, {
+        orgSlug,
+        host
+    })}/orders`;
+    const withQuery = (base, key, value)=>`${base}?${new URLSearchParams({
+            [key]: value
+        }).toString()}`;
+    return {
+        /** The Inbox's Submissions tab, with the reader open on one submission. */ submission: (submissionId)=>withQuery(inbox, INBOX_SUBMISSION_PARAM, submissionId),
+        /** The Orders list. */ orders: ()=>orders,
+        /** The Orders list with one order's dialog open. */ order: (orderId)=>withQuery(orders, ORDERS_ORDER_PARAM, orderId),
+        /** The Orders list narrowed to one buyer's address. */ ordersByCustomer: (email)=>withQuery(orders, ORDERS_CUSTOMER_PARAM, email),
+        /** The Bookings page; a booking has no page of its own. */ bookings: ()=>buildRoute(Route.HOST_BOOKINGS, {
+                orgSlug,
+                host
+            }),
+        /** The Bookings page narrowed to one booker's address (AGL-2660). */ bookingsByBooker: (email)=>withQuery(buildRoute(Route.HOST_BOOKINGS, {
+                orgSlug,
+                host
+            }), BOOKINGS_BOOKER_PARAM, email),
+        /** The Users page, where a site account's row and drawer are. */ members: ()=>buildRoute(Route.HOST_USERS, {
+                orgSlug,
+                host
+            })
+    };
+}
+/**
+ * What the link on a captured timeline entry says. Only the doors that
+ * leave a record the console can open are named; a newsletter opt-in, an
+ * API create, an import or a by-hand add leave nothing to open, so they
+ * carry no link and no label.
+ */ export const INTERACTION_LINK_LABELS = {
+    form: 'Open submission',
+    order: 'Open order',
+    booking: 'Open bookings',
+    member: 'Open site users'
+};
+/**
+ * The console page a captured interaction points back at, or `null` when
+ * the door left nothing to open.
+ *
+ * A submission and an order are addressed by the `refId` the capture door
+ * stamped — `formSubmissions/{id}`, `orders/{id}` — and an interaction that
+ * predates the stamp lands on nothing rather than on a list that would read
+ * as "the record is gone". A booking and a member sign-up land on their
+ * pages, which list them; neither page addresses one row.
+ */ export function contactInteractionHref(interaction, context) {
+    const links = siteRecordLinks(context);
+    switch(interaction.type){
+        case 'form':
+            return interaction.refId ? links.submission(interaction.refId) : null;
+        case 'order':
+            return interaction.refId ? links.order(interaction.refId) : null;
+        case 'booking':
+            return links.bookings();
+        case 'member':
+            return links.members();
+        default:
+            return null;
+    }
+}
+
+//# sourceMappingURL=console-record-links.js.map

package/src/lib/app-utils/console-record-links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/console-record-links.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 { buildRoute, Route } from './console-routes'\nimport type { ContactInteraction, ContactSource } from './contacts'\n\n/**\n * Where the console's records live, for a surface that is not the one the\n * record belongs to (AGL-2622).\n *\n * ## Why these addresses are built here and not where they are used\n *\n * A CRM record is reached from six surfaces that are not the CRM — the\n * top-bar search, an Inbox row, a form's page, an order, a booking, a site\n * user — and a CRM timeline points back at four of them. Two of those\n * readers are the console APP, which the module boundaries forbid from\n * importing a feature plugin at all: a plugin reaches the app only through\n * the generated loader manifests, so the app cannot ask the CRM for its own\n * route builder. The CRM plugin's `crmRoutes(basePath)` stays the builder\n * inside the plugin family; this module is the same address spelled once\n * for the console side, in the shared library both may import, and the\n * plugin's builder is pinned against it by a spec so the two cannot drift.\n *\n * ## Why the arguments are the two route params and not a host document\n *\n * Every site console page is addressed by `/{orgSlug}/hosts/{host}/…`, and\n * both segments are already in the URL a surface is rendered on. Building\n * from them costs nothing; resolving them from a host id costs two document\n * reads (`hostIndex`, then the org) on every open of a card, to render a\n * link. `useConsoleHubPath` in the marketing plugin makes the same choice\n * for the same reason.\n */\nexport interface SiteConsoleContext {\n  orgSlug: string\n  host: string\n}\n\n/** The CRM's nav slug — the `[pluginSlug]` segment the shell resolves. */\nexport const CRM_CONSOLE_SLUG = 'crm'\n\n/** The four record kinds a surface outside the CRM may name. */\nexport type CrmRecordKind = 'contact' | 'lead' | 'company' | 'deal'\n\n/**\n * The hub section each kind's record lives under, which is also the list a\n * kind-only link lands on. Named here rather than in the plugin's section\n * registry so the console app can address a record without the plugin.\n */\nexport const CRM_RECORD_SECTIONS: Record<CrmRecordKind, string> = {\n  contact: 'contacts',\n  lead: 'leads',\n  company: 'companies',\n  deal: 'deals',\n}\n\n/** `/{orgSlug}/hosts/{host}/crm` — the CRM hub on the site being read. */\nexport function crmHubHref(context: SiteConsoleContext): string {\n  return buildRoute(Route.HOST_PLUGIN, {\n    orgSlug: context.orgSlug,\n    host: context.host,\n    pluginSlug: CRM_CONSOLE_SLUG,\n  })\n}\n\n/** One section of the hub — the Leads list, the Deals board. */\nexport function crmSectionHref(\n  context: SiteConsoleContext,\n  section: string,\n): string {\n  return `${crmHubHref(context)}/${section}`\n}\n\n/**\n * One record's own page. The id is URL-encoded because a Firestore id is\n * opaque — the console mints its own, but an import or an API caller may\n * not, and a slash in an id would otherwise read as a further segment.\n */\nexport function crmRecordHref(\n  context: SiteConsoleContext,\n  kind: CrmRecordKind,\n  id: string,\n): string {\n  return `${crmSectionHref(context, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`\n}\n\n/**\n * The query key the Contacts list reads to OPEN the one person with an\n * address (AGL-2612). A surface that holds only an email — an order, a\n * booking, a site user — links to the list with this key, the list filters\n * on the address and moves on to the record when exactly one matches. The\n * plugin re-exports this constant as `CONTACTS_LIST_EMAIL_PARAM` so its\n * parser and the console's builders read one string.\n */\nexport const CRM_CONTACTS_EMAIL_PARAM = 'email'\n\n/** The Contacts list asked to open the person with this address. */\nexport function crmContactByEmailHref(\n  context: SiteConsoleContext,\n  email: string,\n): string {\n  return `${crmSectionHref(context, CRM_RECORD_SECTIONS.contact)}?${new URLSearchParams(\n    { [CRM_CONTACTS_EMAIL_PARAM]: email },\n  ).toString()}`\n}\n\n/**\n * `/{orgSlug}/crm` — the ORGANIZATION-level CRM hub (AGL-2630), the same\n * sections mounted with no site.\n *\n * The org-level twin of {@link crmHubHref}, and separate from it because the\n * two take different arguments: a site address needs the subdomain, and a\n * surface standing at the org hub has none to give. A caller that faked one\n * would put a site's name on a page about all of them.\n */\nexport function crmOrgHubHref(orgSlug: string): string {\n  return buildRoute(Route.ORG_CRM, { orgSlug })\n}\n\n/** One section of the org-level hub — the cross-site Deals board. */\nexport function crmOrgSectionHref(orgSlug: string, section: string): string {\n  return `${crmOrgHubHref(orgSlug)}/${section}`\n}\n\n/**\n * One record's page at the org level.\n *\n * A lead is excluded by the type rather than by a runtime check: a lead's id\n * is a PERSON KEY, the same on every site that met the person, and\n * `hosts/{hostId}/leads` is host-scoped by path — so an org-level address\n * has to name the site as well, which is {@link crmOrgLeadHref}.\n */\nexport function crmOrgRecordHref(\n  orgSlug: string,\n  kind: Exclude<CrmRecordKind, 'lead'>,\n  id: string,\n): string {\n  return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`\n}\n\n/** One site's lead, addressed from the org hub: the site, then the lead. */\nexport function crmOrgLeadHref(\n  orgSlug: string,\n  hostId: string,\n  leadId: string,\n): string {\n  return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS.lead)}/${encodeURIComponent(\n    hostId,\n  )}/${encodeURIComponent(leadId)}`\n}\n\n/**\n * The query keys a site record page reads on arrival, so a CRM timeline can\n * open the submission or the order it names rather than the list it sits\n * in. Each page parses its own key from `useSearchParams`; the CRM writes\n * them through `siteRecordLinks`, and the constant is shared so neither\n * side can misspell the other.\n */\nexport const INBOX_SUBMISSION_PARAM = 'submission'\nexport const ORDERS_ORDER_PARAM = 'order'\n/**\n * The orders list narrowed to one buyer. The same word as the CRM's own\n * email key, deliberately: a reader who edits one URL into the other is\n * not surprised.\n */\nexport const ORDERS_CUSTOMER_PARAM = 'email'\n/**\n * The Bookings page narrowed to one booker (AGL-2660) — the same key as the\n * orders list and the CRM, for the same reason: one address, one word.\n */\nexport const BOOKINGS_BOOKER_PARAM = 'email'\n\n/**\n * Where the site records a contact's captured history names are read\n * (AGL-2622): the Inbox for a submission, the Orders section of the\n * Products hub for an order, the Bookings page and the Users page for the\n * rest. Built from the route table so a section that moves is found here\n * by its route name rather than by searching for a string.\n */\nexport function siteRecordLinks(context: SiteConsoleContext) {\n  const { orgSlug, host } = context\n  const inbox = `${buildRoute(Route.HOST_INBOX, { orgSlug, host })}/submissions`\n  const orders = `${buildRoute(Route.HOST_PRODUCTS, { orgSlug, host })}/orders`\n  const withQuery = (base: string, key: string, value: string) =>\n    `${base}?${new URLSearchParams({ [key]: value }).toString()}`\n  return {\n    /** The Inbox's Submissions tab, with the reader open on one submission. */\n    submission: (submissionId: string) =>\n      withQuery(inbox, INBOX_SUBMISSION_PARAM, submissionId),\n    /** The Orders list. */\n    orders: () => orders,\n    /** The Orders list with one order's dialog open. */\n    order: (orderId: string) => withQuery(orders, ORDERS_ORDER_PARAM, orderId),\n    /** The Orders list narrowed to one buyer's address. */\n    ordersByCustomer: (email: string) =>\n      withQuery(orders, ORDERS_CUSTOMER_PARAM, email),\n    /** The Bookings page; a booking has no page of its own. */\n    bookings: () => buildRoute(Route.HOST_BOOKINGS, { orgSlug, host }),\n    /** The Bookings page narrowed to one booker's address (AGL-2660). */\n    bookingsByBooker: (email: string) =>\n      withQuery(\n        buildRoute(Route.HOST_BOOKINGS, { orgSlug, host }),\n        BOOKINGS_BOOKER_PARAM,\n        email,\n      ),\n    /** The Users page, where a site account's row and drawer are. */\n    members: () => buildRoute(Route.HOST_USERS, { orgSlug, host }),\n  }\n}\n\nexport type SiteRecordLinks = ReturnType<typeof siteRecordLinks>\n\n/**\n * What the link on a captured timeline entry says. Only the doors that\n * leave a record the console can open are named; a newsletter opt-in, an\n * API create, an import or a by-hand add leave nothing to open, so they\n * carry no link and no label.\n */\nexport const INTERACTION_LINK_LABELS: Partial<Record<ContactSource, string>> = {\n  form: 'Open submission',\n  order: 'Open order',\n  booking: 'Open bookings',\n  member: 'Open site users',\n}\n\n/**\n * The console page a captured interaction points back at, or `null` when\n * the door left nothing to open.\n *\n * A submission and an order are addressed by the `refId` the capture door\n * stamped — `formSubmissions/{id}`, `orders/{id}` — and an interaction that\n * predates the stamp lands on nothing rather than on a list that would read\n * as \"the record is gone\". A booking and a member sign-up land on their\n * pages, which list them; neither page addresses one row.\n */\nexport function contactInteractionHref(\n  interaction: Pick<ContactInteraction, 'type' | 'refId'>,\n  context: SiteConsoleContext,\n): string | null {\n  const links = siteRecordLinks(context)\n  switch (interaction.type) {\n    case 'form':\n      return interaction.refId ? links.submission(interaction.refId) : null\n    case 'order':\n      return interaction.refId ? links.order(interaction.refId) : null\n    case 'booking':\n      return links.bookings()\n    case 'member':\n      return links.members()\n    default:\n      return null\n  }\n}\n"],"names":["buildRoute","Route","CRM_CONSOLE_SLUG","CRM_RECORD_SECTIONS","contact","lead","company","deal","crmHubHref","context","HOST_PLUGIN","orgSlug","host","pluginSlug","crmSectionHref","section","crmRecordHref","kind","id","encodeURIComponent","CRM_CONTACTS_EMAIL_PARAM","crmContactByEmailHref","email","URLSearchParams","toString","crmOrgHubHref","ORG_CRM","crmOrgSectionHref","crmOrgRecordHref","crmOrgLeadHref","hostId","leadId","INBOX_SUBMISSION_PARAM","ORDERS_ORDER_PARAM","ORDERS_CUSTOMER_PARAM","BOOKINGS_BOOKER_PARAM","siteRecordLinks","inbox","HOST_INBOX","orders","HOST_PRODUCTS","withQuery","base","key","value","submission","submissionId","order","orderId","ordersByCustomer","bookings","HOST_BOOKINGS","bookingsByBooker","members","HOST_USERS","INTERACTION_LINK_LABELS","form","booking","member","contactInteractionHref","interaction","links","type","refId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,EAAEC,KAAK,QAAQ,sBAAkB;AAkCpD,wEAAwE,GACxE,OAAO,MAAMC,mBAAmB,MAAK;AAKrC;;;;CAIC,GACD,OAAO,MAAMC,sBAAqD;IAChEC,SAAS;IACTC,MAAM;IACNC,SAAS;IACTC,MAAM;AACR,EAAC;AAED,wEAAwE,GACxE,OAAO,SAASC,WAAWC,OAA2B;IACpD,OAAOT,WAAWC,MAAMS,WAAW,EAAE;QACnCC,SAASF,QAAQE,OAAO;QACxBC,MAAMH,QAAQG,IAAI;QAClBC,YAAYX;IACd;AACF;AAEA,8DAA8D,GAC9D,OAAO,SAASY,eACdL,OAA2B,EAC3BM,OAAe;IAEf,OAAO,GAAGP,WAAWC,SAAS,CAAC,EAAEM,SAAS;AAC5C;AAEA;;;;CAIC,GACD,OAAO,SAASC,cACdP,OAA2B,EAC3BQ,IAAmB,EACnBC,EAAU;IAEV,OAAO,GAAGJ,eAAeL,SAASN,mBAAmB,CAACc,KAAK,EAAE,CAAC,EAAEE,mBAAmBD,KAAK;AAC1F;AAEA;;;;;;;CAOC,GACD,OAAO,MAAME,2BAA2B,QAAO;AAE/C,kEAAkE,GAClE,OAAO,SAASC,sBACdZ,OAA2B,EAC3Ba,KAAa;IAEb,OAAO,GAAGR,eAAeL,SAASN,oBAAoBC,OAAO,EAAE,CAAC,EAAE,IAAImB,gBACpE;QAAE,CAACH,yBAAyB,EAAEE;IAAM,GACpCE,QAAQ,IAAI;AAChB;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASC,cAAcd,OAAe;IAC3C,OAAOX,WAAWC,MAAMyB,OAAO,EAAE;QAAEf;IAAQ;AAC7C;AAEA,mEAAmE,GACnE,OAAO,SAASgB,kBAAkBhB,OAAe,EAAEI,OAAe;IAChE,OAAO,GAAGU,cAAcd,SAAS,CAAC,EAAEI,SAAS;AAC/C;AAEA;;;;;;;CAOC,GACD,OAAO,SAASa,iBACdjB,OAAe,EACfM,IAAoC,EACpCC,EAAU;IAEV,OAAO,GAAGS,kBAAkBhB,SAASR,mBAAmB,CAACc,KAAK,EAAE,CAAC,EAAEE,mBAAmBD,KAAK;AAC7F;AAEA,0EAA0E,GAC1E,OAAO,SAASW,eACdlB,OAAe,EACfmB,MAAc,EACdC,MAAc;IAEd,OAAO,GAAGJ,kBAAkBhB,SAASR,oBAAoBE,IAAI,EAAE,CAAC,EAAEc,mBAChEW,QACA,CAAC,EAAEX,mBAAmBY,SAAS;AACnC;AAEA;;;;;;CAMC,GACD,OAAO,MAAMC,yBAAyB,aAAY;AAClD,OAAO,MAAMC,qBAAqB,QAAO;AACzC;;;;CAIC,GACD,OAAO,MAAMC,wBAAwB,QAAO;AAC5C;;;CAGC,GACD,OAAO,MAAMC,wBAAwB,QAAO;AAE5C;;;;;;CAMC,GACD,OAAO,SAASC,gBAAgB3B,OAA2B;IACzD,MAAM,EAAEE,OAAO,EAAEC,IAAI,EAAE,GAAGH;IAC1B,MAAM4B,QAAQ,GAAGrC,WAAWC,MAAMqC,UAAU,EAAE;QAAE3B;QAASC;IAAK,GAAG,YAAY,CAAC;IAC9E,MAAM2B,SAAS,GAAGvC,WAAWC,MAAMuC,aAAa,EAAE;QAAE7B;QAASC;IAAK,GAAG,OAAO,CAAC;IAC7E,MAAM6B,YAAY,CAACC,MAAcC,KAAaC,QAC5C,GAAGF,KAAK,CAAC,EAAE,IAAInB,gBAAgB;YAAE,CAACoB,IAAI,EAAEC;QAAM,GAAGpB,QAAQ,IAAI;IAC/D,OAAO;QACL,yEAAyE,GACzEqB,YAAY,CAACC,eACXL,UAAUJ,OAAOL,wBAAwBc;QAC3C,qBAAqB,GACrBP,QAAQ,IAAMA;QACd,kDAAkD,GAClDQ,OAAO,CAACC,UAAoBP,UAAUF,QAAQN,oBAAoBe;QAClE,qDAAqD,GACrDC,kBAAkB,CAAC3B,QACjBmB,UAAUF,QAAQL,uBAAuBZ;QAC3C,yDAAyD,GACzD4B,UAAU,IAAMlD,WAAWC,MAAMkD,aAAa,EAAE;gBAAExC;gBAASC;YAAK;QAChE,mEAAmE,GACnEwC,kBAAkB,CAAC9B,QACjBmB,UACEzC,WAAWC,MAAMkD,aAAa,EAAE;gBAAExC;gBAASC;YAAK,IAChDuB,uBACAb;QAEJ,+DAA+D,GAC/D+B,SAAS,IAAMrD,WAAWC,MAAMqD,UAAU,EAAE;gBAAE3C;gBAASC;YAAK;IAC9D;AACF;AAIA;;;;;CAKC,GACD,OAAO,MAAM2C,0BAAkE;IAC7EC,MAAM;IACNT,OAAO;IACPU,SAAS;IACTC,QAAQ;AACV,EAAC;AAED;;;;;;;;;CASC,GACD,OAAO,SAASC,uBACdC,WAAuD,EACvDnD,OAA2B;IAE3B,MAAMoD,QAAQzB,gBAAgB3B;IAC9B,OAAQmD,YAAYE,IAAI;QACtB,KAAK;YACH,OAAOF,YAAYG,KAAK,GAAGF,MAAMhB,UAAU,CAACe,YAAYG,KAAK,IAAI;QACnE,KAAK;YACH,OAAOH,YAAYG,KAAK,GAAGF,MAAMd,KAAK,CAACa,YAAYG,KAAK,IAAI;QAC9D,KAAK;YACH,OAAOF,MAAMX,QAAQ;QACvB,KAAK;YACH,OAAOW,MAAMR,OAAO;QACtB;YACE,OAAO;IACX;AACF"}